GitHub - yolodex-ai/reachable: Node package and cli for verifying email addresses

npm install email-reachable

# Basic usage
npx email-reachable user@example.com

# JSON output
npx email-reachable user@example.com --json

# Debug mode
npx email-reachable user@example.com --debug

# Custom timeout
npx email-reachable user@example.com --timeout=15000

✓ user@example.com
  Reachable: true
  Reason: valid
  Syntax Valid: true
  Disposable: false
  Catch-All: false
  MX Records: mx1.example.com, mx2.example.com
  SMTP Response: 250 OK
  Duration: 1234ms

import { verifyEmail } from 'email-reachable';

const result = await verifyEmail('user@example.com');

console.log(result);
// {
//   email: 'user@example.com',
//   reachable: true,
//   reason: 'valid',
//   syntax: true,
//   disposable: false,
//   catchAll: false,
//   mxRecords: [{ exchange: 'mx1.example.com', priority: 10 }],
//   smtpResponse: { code: 250, message: 'OK', command: 'RCPT TO' },
//   duration: 1234
// }

import { verifyEmail } from 'email-reachable';

const result = await verifyEmail('user@example.com', {
  timeout: 15000,           // Connection timeout in ms (default: 10000)
  senderDomain: 'mydomain.com',  // HELO domain (default: 'verify.local')
  senderAddress: 'verify@mydomain.com',  // MAIL FROM address
  port: 25,                 // SMTP port (default: 25)
  debug: true,              // Enable debug output
});

import {
  getMxRecords,
  extractDomain,
  extractLocalPart,
  isValidSyntax,
  isDisposableDomain,
} from 'email-reachable';

// Get MX records for a domain
const mxRecords = await getMxRecords('example.com');
// [{ exchange: 'mx1.example.com', priority: 10 }]

// Extract domain from email
const domain = extractDomain('user@example.com');
// 'example.com'

// Extract local part
const localPart = extractLocalPart('user@example.com');
// 'user'

// Validate syntax
const isValid = isValidSyntax('user@example.com');
// true

// Check for disposable domain
const isDisposable = isDisposableDomain('mailinator.com');
// true