@visulima/email-verifier

@visulima/email-verifier validates and enriches an email address without pulling in a mail-sending stack. It mirrors the surface of commercial APIs like emailable: syntax + domain + SMTP verification, catch-all / mailbox-full / greylist handling, disposable / free / role / no-reply detection, sub-address (tag) parsing, character & Unicode-symbol analysis, provider & Secure-Email-Gateway classification, misspelled-domain suggestions, name parsing, and a transparent 0–100 quality score — all aggregated into one EmailVerificationReport.

It is mailer-free: it does not depend on @visulima/email, so a validation-only consumer never installs the 25 provider adapters.

Quick Start

import { verifyEmail } from "@visulima/email-verifier";

const report = await verifyEmail("john.doe@gmail.com");

report.state; // "deliverable" | "risky" | "undeliverable" | "unknown"
report.reason; // e.g. "accepted_email"
report.score; // 0–100
report.free; // true
report.provider?.display; // "Google Workspace"
report.name; // { firstName: "John", lastName: "Doe", fullName: "John Doe", confidence: "high" }

Use Cases

• Signup Validation - Block undeliverable, disposable, or role addresses at registration
• List Hygiene - Score and segment an existing list before a send
• Lead Scoring - Combine free/role/provider signals into a quality score
• Fraud Signals - Surface catch-all, mixed-script, and typo-domain risks