@emailverifier/sdk 0.1.1

package/dist/esm/data/domains.js

@@ -0,0 +1,253 @@
+import { disposableDataUpdatedAt, upstreamDisposableDomainList } from './disposable-domains.generated.js';
+export { disposableDataUpdatedAt };
+export const customDisposableDomainList = [
+    '10minutemail.com',
+    '10minutemail.net',
+    '10minutemail.org',
+    '1secmail.com',
+    '1secmail.net',
+    '1secmail.org',
+    '20minutemail.com',
+    '33mail.com',
+    'anonbox.net',
+    'burner.kiwi',
+    'byom.de',
+    'cool.fr.nf',
+    'correo-temp.com',
+    'courriel.fr.nf',
+    'dispostable.com',
+    'dropmail.me',
+    'emailfake.com',
+    'emailondeck.com',
+    'fakeinbox.com',
+    'fakemail.net',
+    'getairmail.com',
+    'getnada.com',
+    'grr.la',
+    'guerrillamail.biz',
+    'guerrillamail.com',
+    'guerrillamail.de',
+    'guerrillamail.info',
+    'guerrillamail.net',
+    'guerrillamail.org',
+    'guerrillamailblock.com',
+    'harakirimail.com',
+    'inboxkitten.com',
+    'jetable.fr.nf',
+    'mail-temporaire.fr',
+    'mail.tm',
+    'mail7.io',
+    'mailcatch.com',
+    'maildrop.cc',
+    'mailforspam.com',
+    'mailgen.biz',
+    'mailinator.com',
+    'mailinator.net',
+    'mailinator.org',
+    'mailinator2.com',
+    'mailnesia.com',
+    'mailnull.com',
+    'mailpoof.com',
+    'mega.zik.dj',
+    'mintemail.com',
+    'minuteinbox.com',
+    'moakt.com',
+    'mohmal.com',
+    'moncourrier.fr.nf',
+    'monemail.fr.nf',
+    'monmail.fr.nf',
+    'mytemp.email',
+    'nomail.xl.cx',
+    'nospam.ze.tc',
+    'pokemail.net',
+    'sharklasers.com',
+    'spam.la',
+    'spam4.me',
+    'spamgourmet.com',
+    'spamhereplease.com',
+    'speed.1s.fr',
+    'temp-mail.io',
+    'temp-mail.org',
+    'tempinbox.com',
+    'tempmail.com',
+    'tempmail.io',
+    'tempmail.net',
+    'tempmail.plus',
+    'tempmail.us',
+    'tempmailo.com',
+    'tempmailo.org',
+    'tempr.email',
+    'throwam.com',
+    'throwawaymail.com',
+    'tmpmail.org',
+    'trashmail.com',
+    'trashmail.de',
+    'trashmail.net',
+    'wegwerfmail.de',
+    'yopmail.com',
+    'yopmail.fr',
+    'yopmail.net'
+];
+export const freeEmailDomainList = [
+    '126.com',
+    '139.com',
+    '163.com',
+    '21cn.com',
+    'abv.bg',
+    'aim.com',
+    'alice.it',
+    'aol.com',
+    'arcor.de',
+    'atlas.cz',
+    'att.net',
+    'azet.sk',
+    'bellsouth.net',
+    'bigpond.com',
+    'bk.ru',
+    'blueyonder.co.uk',
+    'bol.com.br',
+    'btinternet.com',
+    'btopenworld.com',
+    'centrum.cz',
+    'centrum.sk',
+    'centurylink.net',
+    'charter.net',
+    'citromail.hu',
+    'comcast.net',
+    'cox.net',
+    'daum.net',
+    'disroot.org',
+    'duck.com',
+    'earthlink.net',
+    'eclipso.de',
+    'email.cz',
+    'email.it',
+    'fastmail.com',
+    'fastmail.fm',
+    'free.fr',
+    'freemail.gr',
+    'freemail.hu',
+    'freenet.de',
+    'frontier.com',
+    'gazeta.pl',
+    'gmail.com',
+    'gmx.at',
+    'gmx.ch',
+    'gmx.co.uk',
+    'gmx.com',
+    'gmx.de',
+    'gmx.net',
+    'gmx.us',
+    'googlemail.com',
+    'hanmail.net',
+    'hey.com',
+    'hotmail.co.uk',
+    'hotmail.com',
+    'hotmail.com.br',
+    'hotmail.de',
+    'hotmail.es',
+    'hotmail.fr',
+    'hotmail.it',
+    'hushmail.com',
+    'i.ua',
+    'icloud.com',
+    'inbox.lv',
+    'inbox.ru',
+    'indiatimes.com',
+    'interia.pl',
+    'laposte.net',
+    'libero.it',
+    'list.ru',
+    'live.co.uk',
+    'live.com',
+    'live.com.au',
+    'live.fr',
+    'mac.com',
+    'mail.bg',
+    'mail.com',
+    'mail.ee',
+    'mail.ru',
+    'mailbox.org',
+    'mailfence.com',
+    'mailo.com',
+    'mailo.fr',
+    'me.com',
+    'mozmail.com',
+    'msn.com',
+    'naver.com',
+    'o2.pl',
+    'onet.pl',
+    'optonline.net',
+    'optusnet.com.au',
+    'orange.fr',
+    'outlook.co.uk',
+    'outlook.com',
+    'outlook.com.au',
+    'outlook.de',
+    'outlook.es',
+    'outlook.fr',
+    'outlook.in',
+    'pm.me',
+    'poczta.fm',
+    'post.cz',
+    'posteo.de',
+    'privaterelay.appleid.com',
+    'proton.me',
+    'protonmail.ch',
+    'protonmail.com',
+    'qq.com',
+    'rambler.ru',
+    'rediffmail.com',
+    'riseup.net',
+    'rocketmail.com',
+    'rogers.com',
+    'runbox.com',
+    'sapo.pt',
+    'sbcglobal.net',
+    'seznam.cz',
+    'shaw.ca',
+    'simplelogin.com',
+    'sina.com',
+    'sympatico.ca',
+    't-online.de',
+    'talktalk.net',
+    'terra.com.br',
+    'tiscali.co.uk',
+    'tiscali.it',
+    'tlen.pl',
+    'tuta.com',
+    'tuta.io',
+    'tutamail.com',
+    'tutanota.com',
+    'tutanota.de',
+    'tutanota.io',
+    'ukr.net',
+    'uol.com.br',
+    'verizon.net',
+    'virgilio.it',
+    'virginmedia.com',
+    'volny.cz',
+    'wanadoo.fr',
+    'web.de',
+    'windstream.net',
+    'wp.pl',
+    'ya.ru',
+    'yahoo.co.in',
+    'yahoo.co.jp',
+    'yahoo.co.uk',
+    'yahoo.com',
+    'yahoo.com.br',
+    'yahoo.fr',
+    'yandex.com',
+    'yandex.ru',
+    'yeah.net',
+    'ymail.com',
+    'zoho.com',
+    'zohomail.com'
+];
+export const freeEmailDomains = new Set(freeEmailDomainList);
+export const disposableDomainList = [...new Set([
+        ...upstreamDisposableDomainList,
+        ...customDisposableDomainList
+    ])].filter(domain => !freeEmailDomains.has(domain)).sort();
+export const disposableDomains = new Set(disposableDomainList);

package/dist/esm/index.js

@@ -0,0 +1 @@
+export { EmailVerifier, EmailVerifierError } from './client.js';

package/dist/esm/offline.js

@@ -0,0 +1,162 @@
+import { disposableDomains, freeEmailDomainList, freeEmailDomains } from './data/domains.js';
+import { roleLocalParts } from './role-addresses.js';
+const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
+const domainPattern = /^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$/i;
+const localPartPattern = /^[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*$/i;
+export const maxEmailLength = 254;
+const maxLocalPartLength = 64;
+function getRoleLocalPartAliases(localPart) {
+    const canonicalLocalPart = localPart.split('+')[0] ?? '';
+    const compactLocalPart = canonicalLocalPart.replace(/[._-]+/g, '');
+    return canonicalLocalPart === compactLocalPart
+        ? [canonicalLocalPart]
+        : [canonicalLocalPart, compactLocalPart];
+}
+function hasValidLocalPartDots(localPart) {
+    return Boolean(localPart) && !localPart.startsWith('.') && !localPart.endsWith('.') && !localPart.includes('..');
+}
+function normalizeEmailDomain(domain) {
+    if (!domain || /[/?:#[\]@]/.test(domain))
+        return '';
+    try {
+        const url = new URL(`http://${domain}`);
+        return url.username || url.password || url.port || url.pathname !== '/' || url.search || url.hash
+            ? ''
+            : url.hostname.toLowerCase();
+    }
+    catch {
+        return '';
+    }
+}
+function isSingleEditAway(value, target) {
+    if (value === target || Math.abs(value.length - target.length) > 1)
+        return false;
+    if (value.length === target.length) {
+        const differences = [];
+        for (let index = 0; index < value.length; index += 1) {
+            if (value[index] !== target[index])
+                differences.push(index);
+            if (differences.length > 2)
+                return false;
+        }
+        return differences.length === 1 || (differences.length === 2
+            && differences[1] === differences[0] + 1
+            && value[differences[0]] === target[differences[1]]
+            && value[differences[1]] === target[differences[0]]);
+    }
+    const [shorter, longer] = value.length < target.length ? [value, target] : [target, value];
+    let shorterIndex = 0;
+    let longerIndex = 0;
+    let skipped = false;
+    while (shorterIndex < shorter.length && longerIndex < longer.length) {
+        if (shorter[shorterIndex] === longer[longerIndex]) {
+            shorterIndex += 1;
+            longerIndex += 1;
+        }
+        else {
+            if (skipped)
+                return false;
+            skipped = true;
+            longerIndex += 1;
+        }
+    }
+    return true;
+}
+function getSuggestedDomain(domain) {
+    let suggestion = null;
+    for (const providerDomain of freeEmailDomainList) {
+        if (!isSingleEditAway(domain, providerDomain))
+            continue;
+        // Multiple possible corrections are more confusing than no suggestion.
+        if (suggestion)
+            return null;
+        suggestion = providerDomain;
+    }
+    return suggestion;
+}
+export function getDisposableDomainMatch(domain) {
+    const normalizedDomain = domain.trim().toLowerCase();
+    if (disposableDomains.has(normalizedDomain))
+        return normalizedDomain;
+    const labels = normalizedDomain.split('.');
+    for (let index = 1; index < labels.length - 1; index += 1) {
+        const parentDomain = labels.slice(index).join('.');
+        if (disposableDomains.has(parentDomain))
+            return parentDomain;
+    }
+    return null;
+}
+export function getFreeEmailDomainMatch(domain) {
+    const normalizedDomain = domain.trim().toLowerCase();
+    return freeEmailDomains.has(normalizedDomain) ? normalizedDomain : null;
+}
+export function isDisposableDomain(domain) {
+    return getDisposableDomainMatch(domain) !== null;
+}
+export function isFreeEmailProvider(domain) {
+    return getFreeEmailDomainMatch(domain) !== null;
+}
+export function isRoleAddress(email) {
+    const atIndex = email.lastIndexOf('@');
+    if (atIndex <= 0 || email.indexOf('@') !== atIndex)
+        return false;
+    const localPart = email.slice(0, atIndex).toLowerCase();
+    return getRoleLocalPartAliases(localPart).some(alias => roleLocalParts.has(alias));
+}
+export function analyzeEmail(input) {
+    const email = typeof input === 'string' ? input.trim() : '';
+    const atIndex = email.lastIndexOf('@');
+    const localPart = atIndex > 0 ? email.slice(0, atIndex) : '';
+    const rawDomain = atIndex > 0 && email.indexOf('@') === atIndex ? email.slice(atIndex + 1) : '';
+    const domain = normalizeEmailDomain(rawDomain);
+    const normalizedEmail = email ? `${localPart}@${domain || rawDomain.toLowerCase()}` : null;
+    const localPartLength = Boolean(localPart && localPart.length <= maxLocalPartLength);
+    const syntax = emailPattern.test(email)
+        && hasValidLocalPartDots(localPart)
+        && localPartLength
+        && localPartPattern.test(localPart);
+    const emailLength = Boolean(email
+        && normalizedEmail
+        && email.length <= maxEmailLength
+        && normalizedEmail.length <= maxEmailLength);
+    const domainFormat = Boolean(domain && domainPattern.test(domain));
+    const disposable = domain ? isDisposableDomain(domain) : false;
+    const freeProvider = domain ? isFreeEmailProvider(domain) : false;
+    const roleBased = syntax && isRoleAddress(email);
+    const suggestedDomain = freeProvider ? null : getSuggestedDomain(domain);
+    const suggestion = syntax && suggestedDomain ? `${localPart}@${suggestedDomain}` : null;
+    const reasons = [];
+    if (!syntax)
+        reasons.push('Email syntax is invalid.');
+    if (emailPattern.test(email) && !localPartLength)
+        reasons.push('Email local part exceeds the maximum length of 64 characters.');
+    if (email && !emailLength)
+        reasons.push('Email exceeds the maximum length of 254 characters.');
+    if (syntax && emailLength && !domainFormat)
+        reasons.push('Email domain format is invalid.');
+    if (disposable)
+        reasons.push('Domain is a known disposable email provider.');
+    if (freeProvider)
+        reasons.push('Domain is a mainstream free mailbox provider.');
+    if (roleBased)
+        reasons.push('Address is role-based and may not identify one person.');
+    if (suggestion)
+        reasons.push(`Did you mean ${suggestion}?`);
+    return {
+        email,
+        normalizedEmail: syntax && emailLength ? normalizedEmail : null,
+        domain: emailLength && domainFormat ? domain : null,
+        suggestion,
+        checks: {
+            syntax,
+            emailLength,
+            localPartLength,
+            domainFormat,
+            disposable,
+            freeProvider,
+            roleBased
+        },
+        reasons
+    };
+}
+export { customDisposableDomainList, disposableDataUpdatedAt, disposableDomainList, freeEmailDomainList } from './data/domains.js';

package/dist/esm/role-addresses.js

@@ -0,0 +1,289 @@
+export const roleLocalParts = new Set([
+    'abuse',
+    'access',
+    'account',
+    'accounting',
+    'accounts',
+    'ap',
+    'accountspayable',
+    'accountsreceivable',
+    'ar',
+    'affiliate',
+    'affiliates',
+    'ambassador',
+    'ambassadors',
+    'admin',
+    'adminteam',
+    'administration',
+    'ads',
+    'advertising',
+    'academy',
+    'alerts',
+    'all',
+    'api',
+    'appointments',
+    'autoreply',
+    'autoresponder',
+    'automated',
+    'automation',
+    'audit',
+    'benefits',
+    'beta',
+    'betatest',
+    'betatesters',
+    'billing',
+    'bursar',
+    'bizdev',
+    'bookings',
+    'businessdevelopment',
+    'campaigns',
+    'bounce',
+    'bounces',
+    'brand',
+    'branding',
+    'careers',
+    'channel',
+    'clients',
+    'clientcare',
+    'clientrelations',
+    'clientservice',
+    'clientservices',
+    'clientsuccess',
+    'chargebacks',
+    'claims',
+    'collections',
+    'compliance',
+    'complianceteam',
+    'contact',
+    'contactus',
+    'contract',
+    'contracting',
+    'contracts',
+    'community',
+    'communications',
+    'comms',
+    'content',
+    'concierge',
+    'controller',
+    'counsel',
+    'ceo',
+    'cfo',
+    'coo',
+    'creator',
+    'creators',
+    'cto',
+    'customercare',
+    'customerengagement',
+    'customerhelp',
+    'customersupport',
+    'customerservice',
+    'customersuccess',
+    'customerexperience',
+    'customerrelations',
+    'cx',
+    'data',
+    'dataprotection',
+    'deliverability',
+    'delivery',
+    'dispatch',
+    'disputes',
+    'admissions',
+    'alumni',
+    'developers',
+    'devops',
+    'dns',
+    'donations',
+    'donotreply',
+    'donotrespond',
+    'dpo',
+    'editor',
+    'editorial',
+    'email',
+    'enablement',
+    'engineering',
+    'enquiries',
+    'enquiry',
+    'ecommerce',
+    'escalation',
+    'escalations',
+    'events',
+    'everyone',
+    'facilities',
+    'financialaid',
+    'fulfillment',
+    'finance',
+    'founder',
+    'founders',
+    'feedback',
+    'fundraising',
+    'giving',
+    'grant',
+    'grants',
+    'fraud',
+    'frontdesk',
+    'gdpr',
+    'growth',
+    'hello',
+    'help',
+    'helpcenter',
+    'helpdesk',
+    'hostmaster',
+    'hr',
+    'identity',
+    'info',
+    'invoices',
+    'insurance',
+    'infosec',
+    'incident',
+    'incidentresponse',
+    'incidents',
+    'inventory',
+    'investorrelations',
+    'investors',
+    'it',
+    'jobs',
+    'legal',
+    'legalteam',
+    'leasing',
+    'leadership',
+    'learning',
+    'leads',
+    'licensing',
+    'list',
+    'mailinglist',
+    'login',
+    'logistics',
+    'mail',
+    'mailerdaemon',
+    'management',
+    'marketing',
+    'media',
+    'medicalrecords',
+    'memberservices',
+    'messages',
+    'network',
+    'newsletter',
+    'noc',
+    'noreply',
+    'no-reply',
+    'noresponse',
+    'notifications',
+    'office',
+    'officeadmin',
+    'onboarding',
+    'onboardingteam',
+    'operations',
+    'ops',
+    'orders',
+    'owner',
+    'partners',
+    'partnerships',
+    'payments',
+    'payables',
+    'patients',
+    'people',
+    'peopleops',
+    'payroll',
+    'paralegal',
+    'preferencecenter',
+    'preferences',
+    'podcast',
+    'postmaster',
+    'press',
+    'product',
+    'productfeedback',
+    'privacy',
+    'privacyteam',
+    'procurement',
+    'promotions',
+    'purchasing',
+    'propertymanagement',
+    'pr',
+    'quotes',
+    'qa',
+    'quality',
+    'qualityassurance',
+    'r&d',
+    'recruiting',
+    'registrar',
+    'research',
+    'researchteam',
+    'reply',
+    'replyto',
+    'referrals',
+    'repairs',
+    'reservations',
+    'receipts',
+    'records',
+    'reception',
+    'receptiondesk',
+    'receivables',
+    'refunds',
+    'resellers',
+    'reliability',
+    'renewal',
+    'renewals',
+    'retail',
+    'risk',
+    'returns',
+    'rentals',
+    'sales',
+    'salesteam',
+    'salesops',
+    'scheduling',
+    'scholarship',
+    'scholarships',
+    'security',
+    'securityalerts',
+    'securityteam',
+    'service',
+    'servicedesk',
+    'shipping',
+    'social',
+    'socialmedia',
+    'sponsorship',
+    'sponsorships',
+    'staff',
+    'status',
+    'store',
+    'subscriptions',
+    'success',
+    'support',
+    'supportdesk',
+    'supportteam',
+    'supplychain',
+    'sysadmin',
+    'system',
+    'soc2',
+    'talent',
+    'team',
+    'test',
+    'testing',
+    'technicalsupport',
+    'techsupport',
+    'trust',
+    'trustandsafety',
+    'trustsafety',
+    'transactional',
+    'training',
+    'trials',
+    'updates',
+    'uptime',
+    'unsubscribe',
+    'userresearch',
+    'vendor',
+    'vendors',
+    'vip',
+    'vipsupport',
+    'warehouse',
+    'uxresearch',
+    'verification',
+    'verify',
+    'volunteer',
+    'volunteers',
+    'webinar',
+    'webinars',
+    'workshops',
+    'webmaster',
+    'workplace'
+]);

package/dist/types/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/types/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":""}