Email-validate-domain NPM

Email Validator with Temporary Domain Check

A robust Node.js package to validate email addresses and identify if they belong to a list of temporary (disposable) domains fetched dynamically from a reliable source.

Features

✔️ Validate email format.
✔️ Check if the email belongs to a temporary domain.
✔️ Fetch domain list dynamically from GitHub.
✔️ Handles edge cases (e.g., null, empty input).
✔️ Designed for performance and scalability.

Installation

Install the package using npm:

npm install email-validate-domain

Usage

Basic Example

const { validateEmail } = require('email-validate-domain');

(async () => {
  const result = await validateEmail("user@example.com");
  console.log(result);
})();

Output

For a valid email:

{
  "isValid": true,
  "problems": []
}

For an email from a temporary domain:

{
  "isValid": false,
  "problems": ["Email domain is a temporary domain."]
}

Advanced Usage

Validate Multiple Emails

const { validateEmail } = require('email-validate-domain');

const emails = [
  "user@example.com",
  "user@mailinator.com",
  "invalid-email"
];

(async () => {
  for (const email of emails) {
    const result = await validateEmail(email);
    console.log(`Validation result for ${email}:`, result);
  }
})();

Output Example

Validation result for user@example.com: { isValid: true, problems: [] }
Validation result for user@mailinator.com: { isValid: false, problems: [ 'Email domain is a temporary domain.' ] }
Validation result for invalid-email: { isValid: false, problems: [ 'Invalid email format.' ] }

API Reference

`validateEmail(email)`

Validates an email address and checks if it belongs to a temporary domain.

Parameters:

email (string): The email address to validate.

Returns:

Promise<Object>: An object containing:
- isValid (boolean): Indicates if the email is valid.
- problems (array): A list of validation issues (e.g., invalid format, temporary domain).

Examples:

const result = await validateEmail("user@mailinator.com");
/*
{
  isValid: false,
  problems: ["Email domain is a temporary domain."]
}
*/

Error Handling

If the domain list API is unavailable or the request fails, the package gracefully falls back to allowing all domains. You can log errors for debugging.