verifymailjs v1.0.5

📧 verifmailjs - Email Verifier 🚀

A lightweight and fast JavaScript library for validating and categorizing email addresses. 🛠️

Features 🎯

• ✅ Validate email format and domain
• 🗂️ Categorize emails (personal, business, educational, disposable)
• 🔒 Check against blacklisted domains
• 💨 No external dependencies
• ⚡ Fast and synchronous operation

Installation 🛠️

Install the package using npm:

npm install verifymailjs

Or using yarn:

yarn add verifymailjs

Usage 🖥️

Basic Usage

import { verifyEmail } from "verifymailjs";

const result = verifyEmail("user@example.com");
console.log(result);

TypeScript Usage

import { verifyEmail, VerificationResult } from "verifymailjs";

const result: VerificationResult = verifyEmail("user@example.com");
console.log(result);

API 🤖

verifyEmail(email: string): VerificationResult

Verifies an email address and returns a VerificationResult object.

Parameters

• email (string): The email address to verify.

Returns

A VerificationResult object with the following properties:

• isValid (boolean): Indicates whether the email is valid.
• category (string): The category of the email. Can be one of:
  • 'personal'
  • 'business'
  • 'educational'
  • 'disposable'
  • 'unknown'
• reason (string, optional): If the email is invalid, this provides a reason.

Examples 📝

Verifying a valid email

import { verifyEmail } from "verifymailjs";

const result = verifyEmail("user@gmail.com");
console.log(result);
// Output: { isValid: true, category: 'personal' }

Verifying an invalid email

import { verifyEmail } from "verifymailjs";

const result = verifyEmail("invalid-email");
console.log(result);
// Output: { isValid: false, category: 'unknown', reason: 'Invalid email format' }

Limitations 🚧

This library performs basic email validation and categorization based on predefined lists and patterns. It does not perform SMTP verification or check for the actual existence of the email address. For most use cases, this level of verification is sufficient and much faster than performing network-based checks.

Contributing 🤝

Contributions are welcome! Please feel free to submit a Pull Request.

License 📜

This project is licensed under the MIT License - see the LICENSE file for details.

Support 🛠️

If you encounter any problems or have any questions, please open an issue on the GitHub repository.

Made with ❤️ by Anish Biswas