@emailverifier/sdk 0.1.1

package/dist/cjs/data/domains.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.disposableDomains = exports.disposableDomainList = exports.freeEmailDomains = exports.freeEmailDomainList = exports.customDisposableDomainList = exports.disposableDataUpdatedAt = void 0;
+const disposable_domains_generated_js_1 = require("./disposable-domains.generated.js");
+Object.defineProperty(exports, "disposableDataUpdatedAt", { enumerable: true, get: function () { return disposable_domains_generated_js_1.disposableDataUpdatedAt; } });
+exports.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'
+];
+exports.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'
+];
+exports.freeEmailDomains = new Set(exports.freeEmailDomainList);
+exports.disposableDomainList = [...new Set([
+        ...disposable_domains_generated_js_1.upstreamDisposableDomainList,
+        ...exports.customDisposableDomainList
+    ])].filter(domain => !exports.freeEmailDomains.has(domain)).sort();
+exports.disposableDomains = new Set(exports.disposableDomainList);

package/dist/cjs/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailVerifierError = exports.EmailVerifier = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "EmailVerifier", { enumerable: true, get: function () { return client_js_1.EmailVerifier; } });
+Object.defineProperty(exports, "EmailVerifierError", { enumerable: true, get: function () { return client_js_1.EmailVerifierError; } });

package/dist/cjs/offline.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.freeEmailDomainList = exports.disposableDomainList = exports.disposableDataUpdatedAt = exports.customDisposableDomainList = exports.maxEmailLength = void 0;
+exports.getDisposableDomainMatch = getDisposableDomainMatch;
+exports.getFreeEmailDomainMatch = getFreeEmailDomainMatch;
+exports.isDisposableDomain = isDisposableDomain;
+exports.isFreeEmailProvider = isFreeEmailProvider;
+exports.isRoleAddress = isRoleAddress;
+exports.analyzeEmail = analyzeEmail;
+const domains_js_1 = require("./data/domains.js");
+const role_addresses_js_1 = require("./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;
+exports.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 domains_js_1.freeEmailDomainList) {
+        if (!isSingleEditAway(domain, providerDomain))
+            continue;
+        // Multiple possible corrections are more confusing than no suggestion.
+        if (suggestion)
+            return null;
+        suggestion = providerDomain;
+    }
+    return suggestion;
+}
+function getDisposableDomainMatch(domain) {
+    const normalizedDomain = domain.trim().toLowerCase();
+    if (domains_js_1.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 (domains_js_1.disposableDomains.has(parentDomain))
+            return parentDomain;
+    }
+    return null;
+}
+function getFreeEmailDomainMatch(domain) {
+    const normalizedDomain = domain.trim().toLowerCase();
+    return domains_js_1.freeEmailDomains.has(normalizedDomain) ? normalizedDomain : null;
+}
+function isDisposableDomain(domain) {
+    return getDisposableDomainMatch(domain) !== null;
+}
+function isFreeEmailProvider(domain) {
+    return getFreeEmailDomainMatch(domain) !== null;
+}
+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 => role_addresses_js_1.roleLocalParts.has(alias));
+}
+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 <= exports.maxEmailLength
+        && normalizedEmail.length <= exports.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
+    };
+}
+var domains_js_2 = require("./data/domains.js");
+Object.defineProperty(exports, "customDisposableDomainList", { enumerable: true, get: function () { return domains_js_2.customDisposableDomainList; } });
+Object.defineProperty(exports, "disposableDataUpdatedAt", { enumerable: true, get: function () { return domains_js_2.disposableDataUpdatedAt; } });
+Object.defineProperty(exports, "disposableDomainList", { enumerable: true, get: function () { return domains_js_2.disposableDomainList; } });
+Object.defineProperty(exports, "freeEmailDomainList", { enumerable: true, get: function () { return domains_js_2.freeEmailDomainList; } });

package/dist/cjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}