email-setup

email-setup

Collection of utilities for checking email configuration settings.

Installation

npm install email-setup

Usage

SPF

SPF records exist as TXT records on a sending domain itself. spfSetup allows us to determine if a domain has a valid SPF record, and hasSPFSender allows us to detemine if a specific sender is allowed to send for the given domain. Note that hasSPFSender currently only support top level include detection, it does not currently resolve the SPF record to determine inclusion at a deeper level than the top level nor does it support IP based domain resolution querying at the moment.

spfSetup

spfSetup will return one of NOT_SETUP, INVALID or SETUP.

const { spfSetup } = require('email-setup');

let isSetup = await spfSetup('foo.com');

hasSPFSender

hasSPFSender returns either true or false depending on whether the sender explicitly exists at the top level of the SPF record.

const { hasSPFSender } = require('email-setup');

let isSetup = await hasSPFSender('foo.com', '_spf.google.com');

DKIM

DKIM records do not exist at any predetermined location, as such to check if a DKIM record is setup for a given system, we need to know the selector to look for the record under. Once we know that, we can determine whether a DKIM key has been setup for the given domain at the given selector.

hasDKIMRecordForSelector

hasDKIMRecordForSelector will return one of NOT_SETUP, INVALID or SETUP.

const { hasDKIMRecordForSelector } = require('email-setup');

let isSetup = await hasDKIMRecordForSelector('foo.com', 'google');

DMARC

dmarcSetup

hasDKIMRecordForSelector will return one of NOT_SETUP, INVALID or SETUP.

const { hasDKIMRecordForSelector } = require('email-setup');

let isSetup = await hasDKIMRecordForSelector('foo.com', 'google');

Changelog

1.1.0 (2022-07-19)

Features

• additional spf validation features (#14) (636fede)

Changelog

• 1.0.3 Accept dns.SERVFAIL as non-existent record response.
• 1.0.2 Add eslint and don't publish dist/.
• 1.0.1 dist/ cleanup and README updates.
• 1.0.0 Initial release.