Pricing

from $0.35 / 1,000 email validateds

Superclean Emails

Validate and clean email addresses from lead lists. Fix domain typos (gmial.com → gmail.com), detect disposable addresses, flag free providers (Gmail, Yahoo), verify MX records. No external API needed. Bulk or instant Standby API. For CRM cleanup, cold email, and bounce prevention.

Pricing

from $0.35 / 1,000 email validateds

Rating

0.0

(0)

Developer

Superlative

Actor stats

Bookmarked

Total users

Monthly active users

5 days ago

Last modified

Email Validation API - Bulk Verify

alizarin_refrigerator-owner/email-validation-api

Validate email addresses at scale. Check deliverability, detect disposable emails, verify MX records & identify role-based addresses. Reduce bounce rates.

The Howlers

Email Verification API — Bulk Deliverability, SMTP & MX Checks

nexgendata/email-verification-tool

Verify email addresses in bulk. Check deliverability, detect disposable emails, validate MX records, and clean your email lists. Reduce bounce rates and improve sender reputation for marketing campaigns.

NexGenData

Email Verifier

muscular_quadruplet/email-verifier

Verify email addresses in bulk. Check if emails exist, detect disposable emails, validate MX records. Perfect for lead validation, list cleaning, and reducing bounce rates. Supports CSV input and exports clean/invalid email lists.

Do It

Gmail Username Availability Checker

parsebird/gmail-username-checker

Check Gmail username availability in bulk. Validate @gmail.com usernames, detect available or taken names, schedule runs, use the API, and export JSON, CSV, or Excel.

ParseBird

Bulk Email Verifier – Validate & Clean Email Lists

logiover/bulk-email-verifier

Bulk email validation tool. Verify email lists without SMTP, check deliverability, flag disposable/role addresses, export clean CSV/JSON.

Logiover

B2B Lead List Cleaner — Dedupe, Normalize & MX-Verify API

nexgendata/b2b-lead-list-cleaner

Clean messy B2B lead lists: normalize emails, flag role/disposable addresses, verify MX, dedupe by email or domain. Lower bounce rates before CRM import or outreach.

NexGenData

Bulk Email MX Verifier — Cold Email List Cleaner

automation-lab/email-mx-verifier

Clean scraped or purchased B2B lead lists before outreach. Bulk-check email syntax, MX records, disposable domains, providers, role/risk signals, and optional SMTP probe with no external API. Export CSV/JSON for Instantly, CRM, and campaign tools.

Stas Persiianenko

Simple Email Validator

seemuapps/simple-email-validator

Validate email addresses in bulk by checking syntax, MX records, disposable domains, role accounts, and free providers.

Andrew

Email Verifier & Validation API - Bulk Email Checker

pink_comic/email-validation-checker

Bulk email verifier, validation API, and email checker for lead lists. Check syntax, MX records, disposable domains, free providers, role accounts, catch-all domains, and optional SMTP reachability. Clean CRM/cold email lists, reduce bounces, and verify leads. No API key required.

Ava Torres

Gmail Username Checker

maximedupre/gmail-username-checker

Check Gmail username availability in bulk. Paste usernames or @gmail.com addresses and get clean available, taken, or invalid rows without creating accounts.

Maxime Dupré

129

5.0

{ "name": "superclean-emails", "version": "1.0.0", "type": "module", "description": "Validate and clean email addresses from lead data", "main": "src/main.js", "scripts": { "start": "node src/main.js", "test": "node --test tests/*.test.js" }, "author": "Superlative <hello@superlative.tech>", "license": "ISC", "dependencies": { "apify": "^3.3.2", "disposable-email-domains": "^1.0.62" } }

{ "actorSpecification": 1, "name": "superclean-emails", "title": "Superclean Emails", "description": "Validate email addresses and detect typos, disposable domains, and missing MX records. Input: string array of emails. Output: isValid, domain, hasMx, isDisposable, isFreeProvider, suggestedFix, confidence. Batch or instant API.", "version": "0.1", "dockerfile": "../Dockerfile", "usesStandbyMode": true, "buildTag": "latest", "webServerSchema": "./web_server_openapi.json", "input": "./input_schema.json", "output": "./output_schema.json", "storages": { "dataset": { "actorSpecification": 1, "title": "Validated emails", "views": { "results": { "title": "Results", "transformation": { "fields": ["id", "input", "output", "isValid", "domain", "hasMx", "isDisposable", "isFreeProvider", "suggestedFix", "confidence"] }, "display": { "component": "table", "properties": { "id": { "label": "ID", "format": "number" }, "input": { "label": "Input", "format": "text" }, "output": { "label": "Output", "format": "text" }, "isValid": { "label": "Valid", "format": "text" }, "domain": { "label": "Domain", "format": "text" }, "hasMx": { "label": "Has MX", "format": "text" }, "isDisposable": { "label": "Disposable", "format": "text" }, "isFreeProvider": { "label": "Free", "format": "text" }, "suggestedFix": { "label": "Suggested Fix", "format": "text" }, "confidence": { "label": "Confidence", "format": "number" } } } } } } }, "defaultRunOptions": { "build": "latest", "memoryMbytes": 128, "timeoutSecs": 360 }, "minMemoryMbytes": 128, "maxMemoryMbytes": 512 }

{ "title": "Superclean Emails", "description": "Paste your email addresses below and click Start. Results will appear in the Output tab.", "type": "object", "schemaVersion": 1, "properties": { "items": { "title": "Email addresses", "description": "Array of email addresses to validate (e.g., \"user@gmail.com\", \"jane@company.co\")", "type": "array", "minItems": 1, "editor": "stringList", "prefill": ["test@gmail.com"] }, "item": { "title": "Item (single)", "type": "string", "description": "Single email to validate — shorthand for API/integration callers. If both 'item' and 'items' are provided, 'item' is prepended to the list.", "editor": "textfield", "sectionCaption": "API shorthand", "sectionDescription": "For API and integration callers (Clay, Make, n8n) who want to pass a single item without wrapping it in an array." } }, "required": [] }

{ "actorOutputSchemaVersion": 1, "title": "Superclean Emails Output", "description": "Email validation results with original values, cleaned values, domain info, and confidence scores.", "properties": { "allResults": { "type": "string", "title": "All Results", "description": "All validated emails with before/after values, domain analysis, and confidence scores", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }

{ "openapi": "3.0.3", "info": { "title": "Superclean Emails — Standby API", "description": "Instant email validation via HTTP GET. Check syntax, detect typos, verify MX records, flag disposable and free providers. Returns the same fields as batch mode.", "version": "0.1.0" }, "paths": { "/": { "get": { "summary": "Validate an email address", "description": "Validate a single email address. Checks RFC 5322 syntax, detects common domain typos, verifies MX records, and flags disposable and free email providers.", "operationId": "cleanEmail", "parameters": [ { "name": "input", "in": "query", "description": "Email address to validate (e.g. `user@gmail.com`).", "required": true, "schema": { "type": "string", "example": "user@gmail.com" } } ], "responses": { "200": { "description": "Email validation result with domain analysis and confidence score.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CleanedEmail" }, "examples": { "valid": { "summary": "Valid email", "value": { "id": 1, "input": "user@gmail.com", "output": "user@gmail.com", "isValid": true, "domain": "gmail.com", "hasMx": true, "isDisposable": false, "isFreeProvider": true, "suggestedFix": null, "confidence": 0.95 } }, "typo": { "summary": "Typo corrected", "value": { "id": 1, "input": "USER@GMIAL.COM", "output": "user@gmail.com", "isValid": true, "domain": "gmail.com", "hasMx": true, "isDisposable": false, "isFreeProvider": true, "suggestedFix": "gmial.com \u2192 gmail.com", "confidence": 0.85 } } } } } }, "400": { "description": "Invalid request — missing input parameter.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Provide an 'input' query parameter with the email address to validate." } } } }, "405": { "description": "Method not allowed — only GET is supported.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" }, "example": { "error": "Method not allowed. Use GET." } } } } } } } }, "components": { "schemas": { "CleanedEmail": { "type": "object", "required": ["id", "input", "output", "isValid", "confidence"], "properties": { "id": { "type": "integer", "description": "Row number (always 1 for single-item Standby requests)." }, "input": { "type": "string", "description": "Original email address before cleaning." }, "output": { "type": "string", "description": "Cleaned and corrected email address." }, "isValid": { "type": "boolean", "description": "Whether the email has valid syntax." }, "domain": { "type": "string", "nullable": true, "description": "Extracted domain part of the email." }, "hasMx": { "type": "boolean", "nullable": true, "description": "Whether the domain has MX records configured." }, "isDisposable": { "type": "boolean", "description": "Whether the domain is a known disposable/temporary email provider." }, "isFreeProvider": { "type": "boolean", "description": "Whether the domain is a free email provider (Gmail, Yahoo, etc.)." }, "suggestedFix": { "type": "string", "nullable": true, "description": "Suggested domain correction if a typo was detected." }, "confidence": { "type": "number", "description": "Confidence score from 0 to 1." } } }, "Error": { "type": "object", "required": ["error"], "properties": { "error": { "type": "string", "description": "Human-readable error message." } } } } } }

1/** 2 * Superclean Emails - Email validation and cleaning 3 * 4 * Validates email addresses: syntax check, typo detection, disposable domain 5 * detection, free provider flagging, and MX record verification. 6 * Rule-based validation without external API dependencies. 7 */ 8 9import http from 'node:http'; 10import { Actor, log } from 'apify'; 11import { validateEmail } from './validator.js'; 12 13const PPE_EVENT = 'email-clean'; 14 15/** 16 * Normalize flexible input formats for Clay/API compatibility. 17 * Accepts: ["string"] or [{input: "string"}] 18 * Returns: ["string"] 19 */ 20function normalizeItems(items) { 21 return items.map((item) => { 22 if (typeof item === 'string') { 23 return item; 24 } 25 if (item && typeof item === 'object' && 'input' in item) { 26 return String(item.input ?? ''); 27 } 28 return String(item ?? ''); 29 }); 30} 31 32await Actor.init(); 33 34if (Actor.config.get('metaOrigin') === 'STANDBY') { 35 startStandbyServer(); 36} else { 37 await runBatchMode(); 38 await Actor.exit(); 39} 40 41// --------------------------------------------------------------------------- 42// Standby mode — HTTP server for instant single-email validation 43// --------------------------------------------------------------------------- 44 45function startStandbyServer() { 46 const port = Actor.config.get('containerPort'); 47 const mxCache = new Map(); 48 49 const server = http.createServer(async (req, res) => { 50 // Readiness probe 51 if (req.headers['x-apify-container-server-readiness-probe']) { 52 res.writeHead(200, { 'Content-Type': 'application/json' }); 53 res.end(JSON.stringify({ status: 'ready' })); 54 return; 55 } 56 57 // GET only 58 if (req.method !== 'GET') { 59 res.writeHead(405, { 'Content-Type': 'application/json' }); 60 res.end(JSON.stringify({ error: 'Method not allowed. Use GET.' })); 61 return; 62 } 63 64 // No input param → serve landing page 65 const reqUrl = new URL(req.url, `http://${req.headers.host}`); 66 if (!reqUrl.searchParams.get('input')) { 67 res.writeHead(200, { 'Content-Type': 'text/html' }); 68 res.end(getLandingPageHtml()); 69 return; 70 } 71 72 try { 73 const result = await handleStandbyRequest(reqUrl, mxCache); 74 await Actor.pushData(result); 75 76 // Charge PPE 77 try { 78 await Actor.charge({ eventName: PPE_EVENT, count: 1 }); 79 } catch (chargeErr) { 80 console.warn(`PPE charge failed: ${chargeErr.message}`); 81 } 82 83 res.writeHead(200, { 'Content-Type': 'application/json' }); 84 res.end(JSON.stringify(result)); 85 } catch (err) { 86 const statusCode = err.statusCode || 500; 87 res.writeHead(statusCode, { 'Content-Type': 'application/json' }); 88 res.end(JSON.stringify({ error: err.message })); 89 } 90 }); 91 92 server.listen(port, () => { 93 console.log(`Superclean Emails Standby server listening on port ${port}`); 94 }); 95} 96 97async function handleStandbyRequest(reqUrl, mxCache) { 98 const input = reqUrl.searchParams.get('input'); 99 100 if (!input) { 101 const err = new Error("Provide an 'input' query parameter with the email address to validate."); 102 err.statusCode = 400; 103 throw err; 104 } 105 106 const result = await validateEmail(input, mxCache); 107 108 return { 109 id: 1, 110 input, 111 output: result.output, 112 isValid: result.isValid, 113 domain: result.domain, 114 hasMx: result.hasMx, 115 isDisposable: result.isDisposable, 116 isFreeProvider: result.isFreeProvider, 117 suggestedFix: result.suggestedFix, 118 confidence: Math.round(result.confidence * 100) / 100, 119 }; 120} 121 122// --------------------------------------------------------------------------- 123// Batch mode — standard Actor run for bulk email validation 124// --------------------------------------------------------------------------- 125 126async function runBatchMode() { 127 const input = await Actor.getInput(); 128 129 if (!input) { 130 await Actor.fail('No input provided. Example: {"items": ["user@example.com"]}'); 131 return; 132 } 133 134 let { items: rawItems = [], item } = input; 135 136 // Support single "item" string field for API/integration callers 137 if (typeof item === 'string' && item.trim()) { 138 if (!Array.isArray(rawItems)) rawItems = []; 139 rawItems = [item.trim(), ...rawItems]; 140 } 141 142 // Coerce bare string to array 143 if (typeof rawItems === 'string') rawItems = [rawItems]; 144 145 if (!Array.isArray(rawItems) || rawItems.length === 0) { 146 await Actor.fail('Input required: provide "items" (array) or "item" (single string). Example: {"items": ["user@example.com"]}'); 147 return; 148 } 149 150 // Normalize input format (supports both ["string"] and [{input: "string"}]) 151 const items = normalizeItems(rawItems); 152 153 log.info(`Validating ${items.length} email(s)`); 154 155 const mxCache = new Map(); 156 const results = []; 157 let processed = 0; 158 159 for (let i = 0; i < items.length; i++) { 160 const original = items[i]; 161 const id = i + 1; 162 163 try { 164 const result = await validateEmail(original, mxCache); 165 166 results.push({ 167 id, 168 input: original, 169 output: result.output, 170 isValid: result.isValid, 171 domain: result.domain, 172 hasMx: result.hasMx, 173 isDisposable: result.isDisposable, 174 isFreeProvider: result.isFreeProvider, 175 suggestedFix: result.suggestedFix, 176 confidence: Math.round(result.confidence * 100) / 100, 177 }); 178 179 processed++; 180 181 if (processed % 100 === 0) { 182 log.info(`Validated ${processed}/${items.length} emails`); 183 } 184 } catch (err) { 185 log.warning(`Failed to validate item ${id}: ${err.message}`); 186 results.push({ 187 id, 188 input: original, 189 output: original, 190 isValid: false, 191 domain: null, 192 hasMx: null, 193 isDisposable: false, 194 isFreeProvider: false, 195 suggestedFix: null, 196 confidence: 0, 197 error: err.message, 198 }); 199 } 200 } 201 202 // Charge PPE per item, then push to dataset 203 let chargedCount = 0; 204 let chargeLimitReached = false; 205 for (const result of results) { 206 if (!chargeLimitReached) { 207 try { 208 const chargeResult = await Actor.charge({ eventName: PPE_EVENT, count: 1 }); 209 chargedCount++; 210 if (chargeResult?.eventChargeLimitReached) { 211 chargeLimitReached = true; 212 console.log(`User spending limit reached after charging ${chargedCount}/${results.length} items`); 213 } 214 } catch (chargeErr) { 215 console.warn(`PPE charge failed: ${chargeErr.message}`); 216 } 217 } 218 } 219 220 await Actor.pushData(results); 221 222 log.info(`Completed validating ${results.length} email(s)`, { charged: chargedCount }); 223 224 // Store summary in key-value store 225 const kvStore = await Actor.openKeyValueStore(); 226 await kvStore.setValue('summary', { 227 totalItems: results.length, 228 processedAt: new Date().toISOString(), 229 sampleResults: results.slice(0, 5), 230 }); 231} 232 233// --------------------------------------------------------------------------- 234// Landing page HTML for Standby mode 235// --------------------------------------------------------------------------- 236 237function getLandingPageHtml() { 238 return `<!DOCTYPE html> 239<html lang="en"> 240<head> 241<meta charset="utf-8"> 242<meta name="viewport" content="width=device-width, initial-scale=1"> 243<title>Superclean Emails — Superlative</title> 244<link rel="preconnect" href="https://fonts.googleapis.com"> 245<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin> 246<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&family=Space+Mono:wght@400;700&display=swap" rel="stylesheet"> 247<style> 248:root{--color-bg:#0a0e14;--color-surface:#12171f;--color-border:#1e2632;--color-text:#e8eaed;--color-text-muted:#8b95a5;--color-accent:#4ade80;--color-accent-dim:rgba(74,222,128,0.15);--font-display:'Space Mono',monospace;--font-body:'DM Sans',sans-serif} 249*{margin:0;padding:0;box-sizing:border-box} 250body{font-family:var(--font-body);background:var(--color-bg);color:var(--color-text);line-height:1.6;min-height:100vh;overflow-x:hidden} 251a{color:var(--color-accent);text-decoration:none;transition:color .2s ease} 252a:hover{color:#6ee7a0} 253.grid-bg{position:fixed;top:0;left:0;width:100%;height:100%;background-image:linear-gradient(var(--color-border) 1px,transparent 1px),linear-gradient(90deg,var(--color-border) 1px,transparent 1px);background-size:60px 60px;opacity:.3;pointer-events:none;z-index:0} 254.accent-line{position:fixed;top:0;left:0;width:100%;height:2px;background:linear-gradient(90deg,transparent 0%,var(--color-accent) 50%,transparent 100%);animation:shimmer 3s ease-in-out infinite;z-index:10} 255@keyframes shimmer{0%,100%{transform:translateX(-100%)}50%{transform:translateX(100%)}} 256@keyframes fadeUp{from{opacity:0;transform:translateY(20px)}to{opacity:1;transform:translateY(0)}} 257.container{position:relative;z-index:1;max-width:900px;margin:0 auto;padding:0 24px} 258header{padding:32px 0} 259.logo{font-family:var(--font-display);font-size:14px;font-weight:700;letter-spacing:.1em;text-transform:uppercase;color:var(--color-text);display:flex;align-items:center;gap:10px;text-decoration:none} 260.logo:hover{color:var(--color-text)} 261.logo-mark{width:28px;height:28px;background:var(--color-accent);display:flex;align-items:center;justify-content:center} 262.logo-mark svg{width:16px;height:16px} 263.hero{padding:80px 0 60px;animation:fadeUp .8s ease-out} 264.hero-label{font-family:var(--font-display);font-size:12px;font-weight:400;letter-spacing:.15em;text-transform:uppercase;color:var(--color-accent);margin-bottom:24px;display:flex;align-items:center;gap:12px} 265.hero-label::before{content:'';width:24px;height:1px;background:var(--color-accent)} 266h1{font-family:var(--font-display);font-size:clamp(28px,5vw,44px);font-weight:700;line-height:1.15;margin-bottom:20px;letter-spacing:-.02em} 267h1 .highlight{color:var(--color-accent)} 268.hero-desc{font-size:18px;color:var(--color-text-muted);max-width:540px;margin-bottom:28px;line-height:1.7} 269.hero-link{font-family:var(--font-display);font-size:13px;letter-spacing:.05em;color:var(--color-accent);display:inline-flex;align-items:center;gap:6px} 270.section{padding:60px 0;border-top:1px solid var(--color-border);animation:fadeUp .8s ease-out .2s backwards} 271.section-label{font-family:var(--font-display);font-size:11px;font-weight:400;letter-spacing:.2em;text-transform:uppercase;color:var(--color-text-muted);margin-bottom:24px} 272h2{font-family:var(--font-display);font-size:20px;font-weight:700;margin-bottom:16px;letter-spacing:-.01em} 273p,li{font-size:15px;color:var(--color-text-muted);line-height:1.7} 274li{margin-bottom:6px} 275ul{margin:.5rem 0 1rem 1.25rem} 276strong{color:var(--color-text);font-weight:600} 277pre{background:var(--color-surface);color:var(--color-text);padding:16px 20px;overflow-x:auto;margin:12px 0 16px;font-family:var(--font-display);font-size:13px;line-height:1.6;border:1px solid var(--color-border)} 278code{font-family:var(--font-display);font-size:13px} 279p code,li code,td code{background:var(--color-accent-dim);color:var(--color-accent);padding:2px 6px} 280table{width:100%;border-collapse:collapse;margin:12px 0 16px;font-size:14px} 281th,td{border:1px solid var(--color-border);padding:10px 14px;text-align:left} 282th{background:var(--color-surface);color:var(--color-text-muted);font-family:var(--font-display);font-size:12px;font-weight:400;letter-spacing:.05em;text-transform:uppercase} 283td{color:var(--color-text-muted)} 284.badge{display:inline-block;background:var(--color-accent-dim);color:var(--color-accent);padding:3px 8px;font-family:var(--font-display);font-size:11px;font-weight:400;letter-spacing:.05em} 285.note{font-size:13px;color:var(--color-text-muted);margin-top:8px} 286.product-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:16px;margin-top:24px} 287.product-card{background:var(--color-surface);border:1px solid var(--color-border);padding:24px;transition:all .3s ease;text-decoration:none;color:inherit;display:block} 288.product-card:hover{border-color:var(--color-accent);transform:translateY(-2px)} 289.product-name{font-family:var(--font-display);font-size:14px;font-weight:700;margin-bottom:8px;color:var(--color-text);display:flex;align-items:center;gap:8px} 290.product-name .status{font-size:9px;font-weight:400;padding:3px 6px;background:var(--color-accent-dim);color:var(--color-accent);letter-spacing:.1em} 291.product-desc{font-size:14px;color:var(--color-text-muted);line-height:1.5} 292footer{padding:48px 0;border-top:1px solid var(--color-border)} 293.footer-content{display:flex;justify-content:space-between;align-items:center;flex-wrap:wrap;gap:24px} 294.footer-text{font-size:13px;color:var(--color-text-muted)} 295.footer-links{display:flex;gap:24px} 296.footer-links a{font-family:var(--font-display);font-size:12px;color:var(--color-text-muted);letter-spacing:.05em} 297.footer-links a:hover{color:var(--color-accent)} 298@media(max-width:600px){.hero{padding:60px 0 40px}.section{padding:40px 0}.footer-content{flex-direction:column;align-items:flex-start}pre{font-size:12px;padding:12px 14px}} 299</style> 300</head> 301<body> 302<div class="grid-bg"></div> 303<div class="accent-line"></div> 304 305<div class="container"> 306 <header> 307 <a href="https://apify.com/superlativetech?fpr=8e9l1" class="logo"> 308 <div class="logo-mark"> 309 <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2.5"> 310 <polyline points="4 17 10 11 4 5"></polyline> 311 <line x1="12" y1="19" x2="20" y2="19"></line> 312 </svg> 313 </div> 314 Superlative 315 </a> 316 </header> 317 318 <section class="hero"> 319 <div class="hero-label">Superclean</div> 320 <h1>Superclean <span class="highlight">Emails</span></h1> 321 <p class="hero-desc">Instant email validation and cleaning. Detect typos, disposable domains, missing MX records, and free providers. Sub-second responses via Standby API.</p> 322 <a href="https://apify.com/superlativetech/superclean-emails?fpr=8e9l1" class="hero-link">View on Apify Store →</a> 323 </section> 324 325 <section class="section"> 326 <div class="section-label">Features</div> 327 <h2>What this does</h2> 328 <ul> 329 <li><strong>Validates syntax</strong> — RFC 5322 compliant email format checking</li> 330 <li><strong>Fixes typos</strong> — Corrects common domain misspellings (gmial.com → gmail.com)</li> 331 <li><strong>Detects disposable emails</strong> — Flags temporary/throwaway email providers</li> 332 <li><strong>Flags free providers</strong> — Identifies Gmail, Yahoo, Hotmail, etc.</li> 333 <li><strong>Verifies MX records</strong> — Confirms the domain can actually receive email</li> 334 <li><strong>Batch mode</strong> — Validate hundreds of emails via the standard Actor run</li> 335 </ul> 336 </section> 337 338 <section class="section"> 339 <div class="section-label">Getting Started</div> 340 <h2>Quick start</h2> 341 <p>Replace <code>YOUR_TOKEN</code> with your Apify API token.</p> 342 343 <p style="margin-top:16px"><strong>Validate an email:</strong></p> 344 <pre>curl "https://superlativetech--superclean-emails.apify.actor?token=YOUR_TOKEN&input=user@gmail.com"</pre> 345 346 <p><strong>Detect a typo:</strong></p> 347 <pre>curl "https://superlativetech--superclean-emails.apify.actor?token=YOUR_TOKEN&input=user@gmial.com"</pre> 348 349 <p><strong>Check a disposable email:</strong></p> 350 <pre>curl "https://superlativetech--superclean-emails.apify.actor?token=YOUR_TOKEN&input=test@mailinator.com"</pre> 351 </section> 352 353 <section class="section"> 354 <div class="section-label">Reference</div> 355 <h2>Query parameters</h2> 356 <table> 357 <tr><th>Parameter</th><th>Required</th><th>Description</th></tr> 358 <tr><td><code>input</code></td><td>Yes</td><td>Email address to validate</td></tr> 359 <tr><td><code>token</code></td><td>Yes</td><td>Your Apify API token</td></tr> 360 </table> 361 </section> 362 363 <section class="section"> 364 <div class="section-label">Response</div> 365 <h2>Response format</h2> 366 <pre>{ 367 "id": 1, 368 "input": "USER@GMIAL.COM", 369 "output": "user@gmail.com", 370 "isValid": true, 371 "domain": "gmail.com", 372 "hasMx": true, 373 "isDisposable": false, 374 "isFreeProvider": true, 375 "suggestedFix": "gmial.com \\u2192 gmail.com", 376 "confidence": 0.85 377}</pre> 378 </section> 379 380 <section class="section"> 381 <div class="section-label">Cost</div> 382 <h2>Pricing</h2> 383 <p>Pay-per-event pricing on the Apify platform:</p> 384 <table> 385 <tr><th>Tier</th><th>Emails</th><th>Per 1,000</th></tr> 386 <tr><td>Base</td><td>Any</td><td>$0.50</td></tr> 387 <tr><td><span class="badge">Bronze</span></td><td>100+</td><td>$0.45</td></tr> 388 <tr><td><span class="badge">Silver</span></td><td>1,000+</td><td>$0.40</td></tr> 389 <tr><td><span class="badge">Gold</span></td><td>10,000+</td><td>$0.35</td></tr> 390 </table> 391 </section> 392 393 <section class="section"> 394 <div class="section-label">Auth</div> 395 <h2>Authentication</h2> 396 <p>Authenticate using either method:</p> 397 <ul> 398 <li>Query parameter: <code>?token=YOUR_APIFY_TOKEN</code></li> 399 <li>Header: <code>Authorization: Bearer YOUR_APIFY_TOKEN</code></li> 400 </ul> 401 <p style="margin-top:8px">Get your token from <a href="https://console.apify.com/settings/integrations">Apify Console → Settings → Integrations</a>.</p> 402 </section> 403 404 <section class="section"> 405 <div class="section-label">Superlative</div> 406 <h2>More from Superlative</h2> 407 <div class="product-grid"> 408 <a href="https://apify.com/superlativetech/superclean-company-names?fpr=8e9l1" class="product-card"> 409 <div class="product-name">Company Names <span class="status">Live</span></div> 410 <p class="product-desc">Normalize company names for CRM and cold email outreach.</p> 411 </a> 412 <a href="https://apify.com/superlativetech/superclean-job-titles?fpr=8e9l1" class="product-card"> 413 <div class="product-name">Job Titles <span class="status">Live</span></div> 414 <p class="product-desc">Standardize job titles for outreach sequences.</p> 415 </a> 416 <a href="https://apify.com/superlativetech/superclean-person-names?fpr=8e9l1" class="product-card"> 417 <div class="product-name">Person Names <span class="status">Live</span></div> 418 <p class="product-desc">Clean and format person names for personalization.</p> 419 </a> 420 <a href="https://apify.com/superlativetech/superclean-product-names?fpr=8e9l1" class="product-card"> 421 <div class="product-name">Product Names <span class="status">Live</span></div> 422 <p class="product-desc">Normalize product and brand names from exports.</p> 423 </a> 424 <a href="https://apify.com/superlativetech/superclean-places?fpr=8e9l1" class="product-card"> 425 <div class="product-name">Places <span class="status">Live</span></div> 426 <p class="product-desc">Parse and normalize location data from lead exports.</p> 427 </a> 428 <a href="https://apify.com/superlativetech/superclean-urls?fpr=8e9l1" class="product-card"> 429 <div class="product-name">URLs <span class="status">Live</span></div> 430 <p class="product-desc">Clean and normalize URLs from lead data.</p> 431 </a> 432 <a href="https://apify.com/superlativetech/superclean-phone-numbers?fpr=8e9l1" class="product-card"> 433 <div class="product-name">Phone Numbers <span class="status">Live</span></div> 434 <p class="product-desc">Format and validate phone numbers.</p> 435 </a> 436 <a href="https://apify.com/superlativetech/dns-lookup?fpr=8e9l1" class="product-card"> 437 <div class="product-name">Supernet DNS Lookup <span class="status">Live</span></div> 438 <p class="product-desc">Look up DNS records for any domain.</p> 439 </a> 440 </div> 441 </section> 442 443 <footer> 444 <div class="footer-content"> 445 <p class="footer-text">© 2026 Superlative</p> 446 <div class="footer-links"> 447 <a href="https://apify.com/superlativetech?fpr=8e9l1">Apify Store</a> 448 </div> 449 </div> 450 </footer> 451</div> 452 453</body> 454</html>`; 455}

1/** 2 * Static set of common free email providers. 3 * Used to flag emails that are personal rather than business addresses. 4 */ 5export const FREE_PROVIDERS = new Set([ 6 // Google 7 'gmail.com', 8 'googlemail.com', 9 // Yahoo 10 'yahoo.com', 11 'yahoo.co.uk', 12 'yahoo.co.in', 13 'yahoo.ca', 14 'yahoo.com.au', 15 'yahoo.co.jp', 16 'yahoo.com.br', 17 'yahoo.fr', 18 'yahoo.de', 19 'yahoo.it', 20 'yahoo.es', 21 // Microsoft 22 'hotmail.com', 23 'hotmail.co.uk', 24 'hotmail.fr', 25 'hotmail.de', 26 'hotmail.it', 27 'hotmail.es', 28 'outlook.com', 29 'outlook.co.uk', 30 'outlook.fr', 31 'outlook.de', 32 'outlook.it', 33 'outlook.es', 34 'live.com', 35 'live.co.uk', 36 'live.fr', 37 'live.de', 38 'live.it', 39 'msn.com', 40 // Apple 41 'icloud.com', 42 'me.com', 43 'mac.com', 44 // Privacy-focused 45 'protonmail.com', 46 'protonmail.ch', 47 'proton.me', 48 'tutanota.com', 49 'tuta.com', 50 'hey.com', 51 // Other global 52 'aol.com', 53 'zoho.com', 54 'mail.com', 55 'fastmail.com', 56 // Italy 57 'libero.it', 58 'virgilio.it', 59 'alice.it', 60 'tin.it', 61 'tiscali.it', 62 'pec.it', 63 // Germany 64 'web.de', 65 'gmx.de', 66 'gmx.net', 67 'gmx.com', 68 'gmx.at', 69 't-online.de', 70 'freenet.de', 71 // France 72 'orange.fr', 73 'wanadoo.fr', 74 'laposte.net', 75 'free.fr', 76 'sfr.fr', 77 // Spain 78 'telefonica.net', 79 // Russia / CIS 80 'yandex.com', 81 'yandex.ru', 82 'mail.ru', 83 'rambler.ru', 84 'inbox.ru', 85 'list.ru', 86 'bk.ru', 87 // Poland 88 'wp.pl', 89 'onet.pl', 90 'interia.pl', 91 'o2.pl', 92 // Czech Republic 93 'seznam.cz', 94 'email.cz', 95 'centrum.cz', 96 // Brazil 97 'bol.com.br', 98 'uol.com.br', 99 'terra.com.br', 100 // India 101 'rediffmail.com', 102 // Japan 103 'nifty.com', 104 // Netherlands 105 'ziggo.nl', 106 'kpnmail.nl', 107 // Scandinavia 108 'telia.com', 109]);

1/** 2 * Email validation pipeline. 3 * 4 * Checks: RFC 5322 syntax, domain typo detection, disposable domain, 5 * free provider, and MX record verification. 6 */ 7 8import dns from 'node:dns/promises'; 9import { createRequire } from 'node:module'; 10import { FREE_PROVIDERS } from './free-providers.js'; 11 12const require = createRequire(import.meta.url); 13const disposableDomains = require('disposable-email-domains'); 14const DISPOSABLE_SET = new Set(disposableDomains); 15 16// --------------------------------------------------------------------------- 17// RFC 5322 simplified regex — covers >99.9% of real-world addresses 18// --------------------------------------------------------------------------- 19const EMAIL_RE = /^[a-zA-Z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*\.[a-zA-Z]{2,}$/; 20 21// --------------------------------------------------------------------------- 22// Common domain typo corrections 23// --------------------------------------------------------------------------- 24const TYPO_MAP = new Map([ 25 // Gmail 26 ['gmial.com', 'gmail.com'], 27 ['gmai.com', 'gmail.com'], 28 ['gamil.com', 'gmail.com'], 29 ['gnail.com', 'gmail.com'], 30 ['gmaill.com', 'gmail.com'], 31 ['gmal.com', 'gmail.com'], 32 ['gmali.com', 'gmail.com'], 33 ['gmaul.com', 'gmail.com'], 34 ['gmail.co', 'gmail.com'], 35 ['gmail.cm', 'gmail.com'], 36 ['gmail.om', 'gmail.com'], 37 ['gmsil.com', 'gmail.com'], 38 ['gmil.com', 'gmail.com'], 39 // Yahoo 40 ['yahooo.com', 'yahoo.com'], 41 ['yaho.com', 'yahoo.com'], 42 ['yhoo.com', 'yahoo.com'], 43 ['yahoo.co', 'yahoo.com'], 44 ['yahoo.cm', 'yahoo.com'], 45 ['yhaoo.com', 'yahoo.com'], 46 // Hotmail 47 ['hotmial.com', 'hotmail.com'], 48 ['hotmal.com', 'hotmail.com'], 49 ['hotamil.com', 'hotmail.com'], 50 ['hotmil.com', 'hotmail.com'], 51 ['hotmaill.com', 'hotmail.com'], 52 ['hotmail.co', 'hotmail.com'], 53 // Outlook 54 ['outlok.com', 'outlook.com'], 55 ['outllook.com', 'outlook.com'], 56 ['outlool.com', 'outlook.com'], 57 ['outloo.com', 'outlook.com'], 58 ['outlook.co', 'outlook.com'], 59 // Protonmail 60 ['protonmal.com', 'protonmail.com'], 61 ['protonmial.com', 'protonmail.com'], 62 ['protonmaill.com', 'protonmail.com'], 63 // iCloud 64 ['icloud.co', 'icloud.com'], 65 ['icoud.com', 'icloud.com'], 66 ['iclould.com', 'icloud.com'], 67]); 68 69// --------------------------------------------------------------------------- 70// MX lookup with timeout 71// --------------------------------------------------------------------------- 72const MX_TIMEOUT_MS = 3000; 73 74async function lookupMx(domain, mxCache) { 75 if (mxCache.has(domain)) { 76 return mxCache.get(domain); 77 } 78 79 try { 80 const result = await Promise.race([ 81 dns.resolveMx(domain), 82 new Promise((_, reject) => setTimeout(() => reject(new Error('MX timeout')), MX_TIMEOUT_MS)), 83 ]); 84 const hasMx = Array.isArray(result) && result.length > 0; 85 mxCache.set(domain, hasMx); 86 return hasMx; 87 } catch { 88 mxCache.set(domain, false); 89 return false; 90 } 91} 92 93// --------------------------------------------------------------------------- 94// Main validation function 95// --------------------------------------------------------------------------- 96 97/** 98 * Validate and clean a single email address. 99 * @param {string} email - Raw email string 100 * @param {Map} mxCache - Shared MX lookup cache (domain → boolean) 101 * @returns {Promise<object>} Validation result 102 */ 103export async function validateEmail(email, mxCache) { 104 let raw = String(email ?? '').trim(); 105 106 // Strip URL-encoded artifacts (common scraping residue like %20, %0A) 107 if (raw.includes('%')) { 108 try { raw = decodeURIComponent(raw).trim(); } catch { /* keep as-is */ } 109 } 110 111 // Empty input 112 if (!raw) { 113 return { 114 output: '', 115 isValid: false, 116 domain: null, 117 hasMx: null, 118 isDisposable: false, 119 isFreeProvider: false, 120 suggestedFix: null, 121 confidence: 0, 122 }; 123 } 124 125 // Step 1: Normalize — lowercase, trim 126 const normalized = raw.toLowerCase().trim(); 127 128 // Step 2: RFC 5322 syntax check 129 if (!EMAIL_RE.test(normalized)) { 130 return { 131 output: normalized, 132 isValid: false, 133 domain: null, 134 hasMx: null, 135 isDisposable: false, 136 isFreeProvider: false, 137 suggestedFix: null, 138 confidence: 0.3, 139 }; 140 } 141 142 // Step 3: Extract local and domain parts 143 const atIndex = normalized.lastIndexOf('@'); 144 const localPart = normalized.substring(0, atIndex); 145 let domain = normalized.substring(atIndex + 1); 146 147 // Step 4: Typo detection 148 let suggestedFix = null; 149 const correctedDomain = TYPO_MAP.get(domain); 150 if (correctedDomain) { 151 suggestedFix = `${domain} \u2192 ${correctedDomain}`; 152 domain = correctedDomain; 153 } 154 155 const output = `${localPart}@${domain}`; 156 157 // Step 5: Disposable domain check (exact match + parent domain) 158 const isDisposable = DISPOSABLE_SET.has(domain) 159 || DISPOSABLE_SET.has(domain.split('.').slice(-2).join('.')); 160 161 // Step 6: Free provider check 162 const isFreeProvider = FREE_PROVIDERS.has(domain); 163 164 // Step 7: MX record check 165 const hasMx = await lookupMx(domain, mxCache); 166 167 // Step 8: Confidence scoring 168 let confidence; 169 if (suggestedFix) { 170 confidence = 0.85; 171 } else if (!hasMx) { 172 confidence = 0.7; 173 } else { 174 confidence = 0.95; 175 } 176 177 return { 178 output, 179 isValid: true, 180 domain, 181 hasMx, 182 isDisposable, 183 isFreeProvider, 184 suggestedFix, 185 confidence, 186 }; 187}

1import { describe, it, beforeEach } from 'node:test'; 2import assert from 'node:assert'; 3import { validateEmail } from '../src/validator.js'; 4 5describe('validateEmail', () => { 6 let mxCache; 7 8 beforeEach(() => { 9 mxCache = new Map(); 10 }); 11 12 describe('valid emails', () => { 13 it('validates a standard email', async () => { 14 const result = await validateEmail('user@gmail.com', mxCache); 15 assert.strictEqual(result.isValid, true); 16 assert.strictEqual(result.output, 'user@gmail.com'); 17 assert.strictEqual(result.domain, 'gmail.com'); 18 }); 19 20 it('lowercases the email', async () => { 21 const result = await validateEmail('USER@GMAIL.COM', mxCache); 22 assert.strictEqual(result.output, 'user@gmail.com'); 23 assert.strictEqual(result.isValid, true); 24 }); 25 26 it('trims whitespace', async () => { 27 const result = await validateEmail(' user@gmail.com ', mxCache); 28 assert.strictEqual(result.output, 'user@gmail.com'); 29 assert.strictEqual(result.isValid, true); 30 }); 31 32 it('handles plus addressing', async () => { 33 const result = await validateEmail('user+tag@gmail.com', mxCache); 34 assert.strictEqual(result.isValid, true); 35 assert.strictEqual(result.output, 'user+tag@gmail.com'); 36 }); 37 38 it('handles dots in local part', async () => { 39 const result = await validateEmail('first.last@example.com', mxCache); 40 assert.strictEqual(result.isValid, true); 41 }); 42 43 it('handles subdomain emails', async () => { 44 const result = await validateEmail('user@mail.example.com', mxCache); 45 assert.strictEqual(result.isValid, true); 46 assert.strictEqual(result.domain, 'mail.example.com'); 47 }); 48 49 it('handles hyphenated domains', async () => { 50 const result = await validateEmail('user@my-company.com', mxCache); 51 assert.strictEqual(result.isValid, true); 52 }); 53 }); 54 55 describe('invalid syntax', () => { 56 it('rejects missing @', async () => { 57 const result = await validateEmail('userexample.com', mxCache); 58 assert.strictEqual(result.isValid, false); 59 assert.strictEqual(result.confidence, 0.3); 60 }); 61 62 it('rejects double @', async () => { 63 const result = await validateEmail('user@@example.com', mxCache); 64 assert.strictEqual(result.isValid, false); 65 }); 66 67 it('rejects spaces in email', async () => { 68 const result = await validateEmail('user @example.com', mxCache); 69 assert.strictEqual(result.isValid, false); 70 }); 71 72 it('rejects missing domain', async () => { 73 const result = await validateEmail('user@', mxCache); 74 assert.strictEqual(result.isValid, false); 75 }); 76 77 it('rejects missing local part', async () => { 78 const result = await validateEmail('@example.com', mxCache); 79 assert.strictEqual(result.isValid, false); 80 }); 81 82 it('rejects missing TLD', async () => { 83 const result = await validateEmail('user@example', mxCache); 84 assert.strictEqual(result.isValid, false); 85 }); 86 87 it('rejects domain starting with dot', async () => { 88 const result = await validateEmail('user@.example.com', mxCache); 89 assert.strictEqual(result.isValid, false); 90 }); 91 }); 92 93 describe('typo corrections', () => { 94 it('corrects gmial.com to gmail.com', async () => { 95 const result = await validateEmail('user@gmial.com', mxCache); 96 assert.strictEqual(result.output, 'user@gmail.com'); 97 assert.strictEqual(result.suggestedFix, 'gmial.com \u2192 gmail.com'); 98 assert.strictEqual(result.confidence, 0.85); 99 }); 100 101 it('corrects gmai.com to gmail.com', async () => { 102 const result = await validateEmail('user@gmai.com', mxCache); 103 assert.strictEqual(result.output, 'user@gmail.com'); 104 assert.strictEqual(result.suggestedFix, 'gmai.com \u2192 gmail.com'); 105 }); 106 107 it('corrects yahooo.com to yahoo.com', async () => { 108 const result = await validateEmail('user@yahooo.com', mxCache); 109 assert.strictEqual(result.output, 'user@yahoo.com'); 110 assert.strictEqual(result.suggestedFix, 'yahooo.com \u2192 yahoo.com'); 111 }); 112 113 it('corrects hotmial.com to hotmail.com', async () => { 114 const result = await validateEmail('user@hotmial.com', mxCache); 115 assert.strictEqual(result.output, 'user@hotmail.com'); 116 }); 117 118 it('corrects outlok.com to outlook.com', async () => { 119 const result = await validateEmail('user@outlok.com', mxCache); 120 assert.strictEqual(result.output, 'user@outlook.com'); 121 }); 122 123 it('corrects protonmal.com to protonmail.com', async () => { 124 const result = await validateEmail('user@protonmal.com', mxCache); 125 assert.strictEqual(result.output, 'user@protonmail.com'); 126 }); 127 128 it('returns null suggestedFix when no typo', async () => { 129 const result = await validateEmail('user@gmail.com', mxCache); 130 assert.strictEqual(result.suggestedFix, null); 131 }); 132 }); 133 134 describe('disposable domains', () => { 135 it('flags mailinator.com as disposable', async () => { 136 const result = await validateEmail('test@mailinator.com', mxCache); 137 assert.strictEqual(result.isDisposable, true); 138 }); 139 140 it('flags guerrillamail.com as disposable', async () => { 141 const result = await validateEmail('test@guerrillamail.com', mxCache); 142 assert.strictEqual(result.isDisposable, true); 143 }); 144 145 it('flags subdomain of disposable as disposable', async () => { 146 const result = await validateEmail('test@sub.mailinator.com', mxCache); 147 assert.strictEqual(result.isDisposable, true); 148 }); 149 150 it('does not flag gmail as disposable', async () => { 151 const result = await validateEmail('user@gmail.com', mxCache); 152 assert.strictEqual(result.isDisposable, false); 153 }); 154 }); 155 156 describe('free providers', () => { 157 it('flags gmail.com as free provider', async () => { 158 const result = await validateEmail('user@gmail.com', mxCache); 159 assert.strictEqual(result.isFreeProvider, true); 160 }); 161 162 it('flags yahoo.com as free provider', async () => { 163 const result = await validateEmail('user@yahoo.com', mxCache); 164 assert.strictEqual(result.isFreeProvider, true); 165 }); 166 167 it('flags hotmail.com as free provider', async () => { 168 const result = await validateEmail('user@hotmail.com', mxCache); 169 assert.strictEqual(result.isFreeProvider, true); 170 }); 171 172 it('flags outlook.com as free provider', async () => { 173 const result = await validateEmail('user@outlook.com', mxCache); 174 assert.strictEqual(result.isFreeProvider, true); 175 }); 176 177 it('flags protonmail.com as free provider', async () => { 178 const result = await validateEmail('user@protonmail.com', mxCache); 179 assert.strictEqual(result.isFreeProvider, true); 180 }); 181 182 it('flags libero.it as free provider', async () => { 183 const result = await validateEmail('user@libero.it', mxCache); 184 assert.strictEqual(result.isFreeProvider, true); 185 }); 186 187 it('flags web.de as free provider', async () => { 188 const result = await validateEmail('user@web.de', mxCache); 189 assert.strictEqual(result.isFreeProvider, true); 190 }); 191 192 it('flags orange.fr as free provider', async () => { 193 const result = await validateEmail('user@orange.fr', mxCache); 194 assert.strictEqual(result.isFreeProvider, true); 195 }); 196 197 it('flags wp.pl as free provider', async () => { 198 const result = await validateEmail('user@wp.pl', mxCache); 199 assert.strictEqual(result.isFreeProvider, true); 200 }); 201 202 it('does not flag business domain as free', async () => { 203 const result = await validateEmail('user@acme-corp.com', mxCache); 204 assert.strictEqual(result.isFreeProvider, false); 205 }); 206 }); 207 208 describe('MX record checks', () => { 209 it('returns hasMx true for gmail.com', async () => { 210 const result = await validateEmail('user@gmail.com', mxCache); 211 assert.strictEqual(result.hasMx, true); 212 }); 213 214 it('caches MX results across calls', async () => { 215 await validateEmail('user1@gmail.com', mxCache); 216 assert.ok(mxCache.has('gmail.com')); 217 await validateEmail('user2@gmail.com', mxCache); 218 // Should use cached value — same cache entry 219 assert.strictEqual(mxCache.size, 1); 220 }); 221 222 it('returns hasMx false for non-existent domain', async () => { 223 const result = await validateEmail('user@thisdomain-definitely-does-not-exist-abc123xyz.com', mxCache); 224 assert.strictEqual(result.hasMx, false); 225 assert.strictEqual(result.confidence, 0.7); 226 }); 227 }); 228 229 describe('URL-encoded input', () => { 230 it('strips trailing %20 and validates', async () => { 231 const result = await validateEmail('user@example.com%20', mxCache); 232 assert.strictEqual(result.isValid, true); 233 assert.strictEqual(result.output, 'user@example.com'); 234 }); 235 236 it('strips trailing %0A newline and validates', async () => { 237 const result = await validateEmail('user@example.com%0A', mxCache); 238 assert.strictEqual(result.isValid, true); 239 assert.strictEqual(result.output, 'user@example.com'); 240 }); 241 242 it('handles fully encoded @ sign', async () => { 243 const result = await validateEmail('user%40example.com', mxCache); 244 assert.strictEqual(result.isValid, true); 245 assert.strictEqual(result.output, 'user@example.com'); 246 }); 247 248 it('leaves valid email with percent in local part unchanged', async () => { 249 const result = await validateEmail('user%tag@example.com', mxCache); 250 assert.strictEqual(typeof result.isValid, 'boolean'); 251 }); 252 }); 253 254 describe('edge cases', () => { 255 it('handles empty string', async () => { 256 const result = await validateEmail('', mxCache); 257 assert.strictEqual(result.isValid, false); 258 assert.strictEqual(result.output, ''); 259 assert.strictEqual(result.confidence, 0); 260 }); 261 262 it('handles null', async () => { 263 const result = await validateEmail(null, mxCache); 264 assert.strictEqual(result.isValid, false); 265 assert.strictEqual(result.confidence, 0); 266 }); 267 268 it('handles undefined', async () => { 269 const result = await validateEmail(undefined, mxCache); 270 assert.strictEqual(result.isValid, false); 271 assert.strictEqual(result.confidence, 0); 272 }); 273 274 it('handles number input', async () => { 275 const result = await validateEmail(12345, mxCache); 276 assert.strictEqual(result.isValid, false); 277 }); 278 279 it('handles very long local part', async () => { 280 const long = 'a'.repeat(65) + '@example.com'; 281 const result = await validateEmail(long, mxCache); 282 // The regex will still match — RFC allows up to 64, but we're lenient 283 assert.strictEqual(typeof result.isValid, 'boolean'); 284 }); 285 286 it('handles email with only whitespace', async () => { 287 const result = await validateEmail(' ', mxCache); 288 assert.strictEqual(result.isValid, false); 289 assert.strictEqual(result.confidence, 0); 290 }); 291 }); 292 293 describe('confidence scoring', () => { 294 it('returns 0.95 for valid email with MX', async () => { 295 const result = await validateEmail('user@gmail.com', mxCache); 296 assert.strictEqual(result.confidence, 0.95); 297 }); 298 299 it('returns 0.85 for typo-corrected email', async () => { 300 const result = await validateEmail('user@gmial.com', mxCache); 301 assert.strictEqual(result.confidence, 0.85); 302 }); 303 304 it('returns 0.3 for invalid syntax', async () => { 305 const result = await validateEmail('not-an-email', mxCache); 306 assert.strictEqual(result.confidence, 0.3); 307 }); 308 309 it('returns 0 for empty input', async () => { 310 const result = await validateEmail('', mxCache); 311 assert.strictEqual(result.confidence, 0); 312 }); 313 }); 314});