Package Exports

verifymailjs
verifymailjs/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (verifymailjs) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

📧 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