Skip to content

Fast, lightweight Node.js email validation library — RFC 5322, typo detection, disposable email blocking, MX & SMTP verification. TypeScript-first. 25KB.

License

Notifications You must be signed in to change notification settings

kazmiali/mailtester

Repository files navigation

mailtester

Modern, high-performance email validation for Node.js

npm version npm downloads Build Status TypeScript License: MIT

A comprehensive email validation library with RFC 5322 compliance, typo detection, disposable email blocking, MX record verification, and SMTP validation.


Packages

Package Description Version
@mailtester/core Core email validation library npm

Quick Start

npm install @mailtester/core
import { validate } from '@mailtester/core';

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

console.log(result.valid);  // true
console.log(result.score);  // 85

See the core package documentation for detailed usage instructions.

Features

  • RFC 5322 Compliant — Full regex validation with strict and loose modes
  • Typo Detection — Suggests corrections for common domain typos
  • Disposable Email Blocking — Detects 40,000+ temporary email services
  • MX Record Validation — Verifies domain has valid mail servers
  • SMTP Verification — Checks if mailbox actually exists
  • Bulk Validation — Process thousands of emails concurrently
  • Rate Limiting — Built-in protection against API abuse
  • TypeScript First — Full type safety with strict mode
  • Lightweight — ~25KB gzipped, minimal dependencies

Requirements

  • Node.js 16.0.0 or higher
  • TypeScript 5.3+ (for TypeScript users)

Development

# Clone the repository
git clone https://github.com/kazmiali/mailtester.git
cd mailtester

# Install dependencies
yarn install

# Build all packages
yarn build

# Run tests
yarn test

# Lint code
yarn lint

Project Structure

mailtester/
├── packages/
│   └── core/           # Core validation library
│       ├── src/
│       │   ├── validators/   # Individual validators
│       │   ├── bulk/         # Bulk processing
│       │   ├── config/       # Configuration management
│       │   └── ...
│       └── tests/
├── docs/               # Documentation
└── README.md

Author

Muhammad Ali Kazmi

Full-stack developer passionate about building fast, developer-friendly open-source tools.

Portfolio LinkedIn GitHub

License

MIT © Muhammad Ali Kazmi


About

Fast, lightweight Node.js email validation library — RFC 5322, typo detection, disposable email blocking, MX & SMTP verification. TypeScript-first. 25KB.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors