zinai / check-email-exists

Check if an email address exists before sending the email. Neon-binding Rust crates "check-if-email-exists".

check-email-exists

Check if an email address exists before sending the email. Neon-binding Rust crates "check-if-email-exists".

Features

From the check-if-email-exists repo README.md get more details.

✅ Email deliverability: Is an email for this address deliverable?

However, it goes more into details, and checks all the following properties of an email address:

✔️ Syntax validation. Is the address syntactically valid?

✔️ DNS records validation. Does the domain of the email address have valid MX DNS records?

✔️ Disposable email address (DEA) validation. Is the address provided by a known disposable email address provider?

✔️ SMTP server validation. Can the mail exchanger of the email address domain be contacted successfully?

✔️ Mailbox disabled. Has this email address been disabled by the email provider?

✔️ Full inbox. Is the inbox of this mailbox full?

✔️ Catch-all address. Is this email address a catch-all address?

Output Example

{
	"input": "[email protected]",
	"misc": {
		"is_disposable": false
	},
	"mx": {
		"records": [
			"alt3.gmail-smtp-in.l.google.com.",
			"gmail-smtp-in.l.google.com.",
			"alt1.gmail-smtp-in.l.google.com.",
			"alt4.gmail-smtp-in.l.google.com.",
			"alt2.gmail-smtp-in.l.google.com."
		]
	},
	"smtp": {
		"has_full_inbox": false,
		"is_catch_all": false,
		"is_deliverable": false,
		"is_disabled": true
	},
	"syntax": {
		"address": "[email protected]",
		"domain": "gmail.com",
		"username": "someone",
		"valid_format": true
	}
}

Installation

npm install check-email-exists

Usage

import { checkEmailExists ,checkEmailExistsSync} from 'check-email-exists';

// async check the email
await checkEmailExists("[email protected]");

// sync check the email
checkEmailExistsSync("[email protected]","[email protected]");

Local Setup

git clone https://github.com/ZiNai/check-email-exists
cd check-email-exists
npm i
npm test

check-email-exists's Issues

Node version mismatch

Error: The module '/Users/hamachan/test-nslookup/node_modules/check-email-exists/native/index.node' was compiled against a different Node.js version using NODE_MODULE_VERSION 72. This version of Node.js requires NODE_MODULE_VERSION 79. Please try re-compiling or re-installing

Hope you guys officially support node 13 soon.

Support for Examples

Hi,

Can you please add one example to show how to use this? I have tried following the steps mentioned in Usage section in README but unable to get it working.

Thanks,
Vaibhav

node version mismatch

Error: The module '/Users/hamachan/test-nslookup/node_modules/check-email-exists/native/index.node' was compiled against a different Node.js version using NODE_MODULE_VERSION 72. This version of Node.js requires NODE_MODULE_VERSION 79. Please try re-compiling or re-installing

Hope you guys officially support node 13 soon.

Invalid ELF Header

just ran the npm install and it fails with invalid elf header while running the example.

Error: /home/playing/mails/node_modules/check-email-exists/native/index.node: invalid ELF header
    at Object.Module._extensions..node (internal/modules/cjs/loader.js:1183:18)
    at Module.load (internal/modules/cjs/loader.js:977:32)
    at Function.Module._load (internal/modules/cjs/loader.js:877:14)
    at Module.require (internal/modules/cjs/loader.js:1019:19)
    at require (internal/modules/cjs/helpers.js:77:18)
    at Object.<anonymous> (/home/ahmed/playing/mails/node_modules/check-email-exists/lib/index.js:1:13)
    at Module._compile (internal/modules/cjs/loader.js:1133:30)
    at Object.Module._extensions..js (internal/modules/cjs/loader.js:1153:10)
    at Module.load (internal/modules/cjs/loader.js:977:32)
    at Function.Module._load (internal/modules/cjs/loader.js:877:14)

jest resolve cannot find path in the test

Test suite failed to run

Cannot find module '../native' from 'index.js'