@emailcheck/email-validator-js 2.13.1-beta.7 → 2.13.1-beta.9

package/dist/index.js

@@ -6,6 +6,25 @@ var node_dns = require('node:dns');
 var stringSimilarityJs = require('string-similarity-js');
 var net = require('node:net');
 
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var net__namespace = /*#__PURE__*/_interopNamespaceDefault(net);
+
 class LRUAdapter {
   constructor(maxSize = 1e3, ttlMs = 36e5) {
     this.lru = tinyLru.lru(maxSize, ttlMs);
@@ -42,67 +61,71 @@ class LRUAdapter {
   }
 }
 
-const DEFAULT_CACHE_TTL = {
-  mx: 36e5,
-  // 1 hour
-  disposable: 864e5,
-  // 24 hours
-  free: 864e5,
-  // 24 hours
-  domainValid: 864e5,
-  // 24 hours
-  smtp: 18e5,
-  // 30 minutes
-  domainSuggestion: 864e5,
-  // 24 hours
-  whois: 36e5
-  // 1 hour
-};
-const DEFAULT_CACHE_SIZE = {
-  mx: 500,
-  disposable: 1e3,
-  free: 1e3,
-  domainValid: 1e3,
-  smtp: 500,
-  domainSuggestion: 1e3,
-  whois: 200
+const DEFAULT_CACHE_OPTIONS = {
+  ttl: {
+    mx: 36e5,
+    // 1 hour
+    disposable: 864e5,
+    // 24 hours
+    free: 864e5,
+    // 24 hours
+    domainValid: 864e5,
+    // 24 hours
+    smtp: 18e5,
+    // 30 minutes
+    domainSuggestion: 864e5,
+    // 24 hours
+    whois: 36e5
+    // 1 hour
+  },
+  maxSize: {
+    mx: 500,
+    disposable: 1e3,
+    free: 1e3,
+    domainValid: 1e3,
+    smtp: 500,
+    domainSuggestion: 1e3,
+    whois: 200
+  }
 };
-
-const mxCache = tinyLru.lru(500, 36e5);
-const disposableCache = tinyLru.lru(1e3, 864e5);
-const freeCache = tinyLru.lru(1e3, 864e5);
-const domainValidCache = tinyLru.lru(1e3, 864e5);
-const smtpCache = tinyLru.lru(500, 18e5);
-const domainSuggestionCache = tinyLru.lru(1e3, 864e5);
-const whoisCache = tinyLru.lru(200, 36e5);
-function getCacheStore(defaultLru, cacheType, passedCache) {
-  if (passedCache && passedCache[cacheType]) {
-    return passedCache[cacheType];
-  }
-  return new LRUAdapter(DEFAULT_CACHE_SIZE[cacheType], DEFAULT_CACHE_TTL[cacheType]);
+let defaultCacheInstance = null;
+function getDefaultCache() {
+  if (!defaultCacheInstance) {
+    defaultCacheInstance = {
+      mx: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.mx, DEFAULT_CACHE_OPTIONS.ttl.mx),
+      disposable: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.disposable, DEFAULT_CACHE_OPTIONS.ttl.disposable),
+      free: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.free, DEFAULT_CACHE_OPTIONS.ttl.free),
+      domainValid: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.domainValid, DEFAULT_CACHE_OPTIONS.ttl.domainValid),
+      smtp: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.smtp, DEFAULT_CACHE_OPTIONS.ttl.smtp),
+      domainSuggestion: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.domainSuggestion, DEFAULT_CACHE_OPTIONS.ttl.domainSuggestion),
+      whois: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.whois, DEFAULT_CACHE_OPTIONS.ttl.whois)
+    };
+  }
+  return defaultCacheInstance;
+}
+function getCacheStore(cache, key) {
+  return (cache === null || cache === void 0 ? void 0 : cache[key]) || getDefaultCache()[key];
+}
+function clearDefaultCache() {
+  if (defaultCacheInstance) {
+    defaultCacheInstance.mx.clear();
+    defaultCacheInstance.disposable.clear();
+    defaultCacheInstance.free.clear();
+    defaultCacheInstance.domainValid.clear();
+    defaultCacheInstance.smtp.clear();
+    defaultCacheInstance.domainSuggestion.clear();
+    defaultCacheInstance.whois.clear();
+  }
 }
-const mxCacheStore = (passedCache) => getCacheStore(mxCache, "mx", passedCache);
-const disposableCacheStore = (passedCache) => getCacheStore(disposableCache, "disposable", passedCache);
-const freeCacheStore = (passedCache) => getCacheStore(freeCache, "free", passedCache);
-const domainValidCacheStore = (passedCache) => getCacheStore(domainValidCache, "domainValid", passedCache);
-const smtpCacheStore = (passedCache) => getCacheStore(smtpCache, "smtp", passedCache);
-const domainSuggestionCacheStore = (passedCache) => getCacheStore(domainSuggestionCache, "domainSuggestion", passedCache);
-const whoisCacheStore = (passedCache) => getCacheStore(whoisCache, "whois", passedCache);
-function clearAllCaches() {
-  mxCache.clear();
-  disposableCache.clear();
-  freeCache.clear();
-  domainValidCache.clear();
-  smtpCache.clear();
-  domainSuggestionCache.clear();
-  whoisCache.clear();
+function resetDefaultCache() {
+  defaultCacheInstance = null;
 }
 
 async function resolveMxRecords(params) {
   const { domain, cache, logger } = params;
   const log = logger || (() => {
   });
-  const cacheStore = mxCacheStore(cache);
+  const cacheStore = getCacheStore(cache, "mx");
   const cached = await cacheStore.get(domain);
   if (cached !== null && cached !== void 0) {
     log(`[resolveMxRecords] Cache hit for ${domain}: ${cached.length} MX records`);
@@ -266,24 +289,24 @@ function defaultDomainSuggestionMethod(domain, commonDomains) {
   }
   return null;
 }
-async function defaultDomainSuggestionMethodAsync(domain, commonDomains) {
-  return defaultDomainSuggestionMethodImpl(domain, commonDomains);
+async function defaultDomainSuggestionMethodAsync(domain, commonDomains, cache) {
+  return defaultDomainSuggestionMethodImpl(domain, commonDomains, cache);
 }
-async function defaultDomainSuggestionMethodImpl(domain, commonDomains) {
+async function defaultDomainSuggestionMethodImpl(domain, commonDomains, cache) {
   if (!domain || domain.length < 3) {
     return null;
   }
   const domainsToCheck = commonDomains || COMMON_EMAIL_DOMAINS;
   const lowerDomain = domain.toLowerCase();
   const cacheKey = `${lowerDomain}:${domainsToCheck.length}`;
-  const cache = domainSuggestionCacheStore();
-  const cached = cache.get(cacheKey);
+  const cacheStore = getCacheStore(cache, "domainSuggestion");
+  const cached = await cacheStore.get(cacheKey);
   const resolved = cached && typeof cached === "object" && "then" in cached ? await cached : cached;
   if (resolved !== null && resolved !== void 0) {
-    return resolved ? { original: domain, suggested: resolved.suggested, confidence: resolved.confidence } : null;
+    return resolved;
   }
   if (domainsToCheck.includes(lowerDomain)) {
-    await cache.set(cacheKey, null);
+    await cacheStore.set(cacheKey, null);
     return null;
   }
   for (const [correctDomain, typos] of Object.entries(TYPO_PATTERNS)) {
@@ -294,7 +317,7 @@ async function defaultDomainSuggestionMethodImpl(domain, commonDomains) {
         confidence: 0.95
         // High confidence for known typo patterns
       };
-      await cache.set(cacheKey, { suggested: result.suggested, confidence: result.confidence });
+      await cacheStore.set(cacheKey, result);
       return result;
     }
   }
@@ -322,7 +345,7 @@ async function defaultDomainSuggestionMethodImpl(domain, commonDomains) {
   }
   if (bestMatch) {
     if (bestMatch.domain.charAt(0) !== lowerDomain.charAt(0) && bestMatch.similarity < 0.9) {
-      await cache.set(cacheKey, null);
+      await cacheStore.set(cacheKey, null);
       return null;
     }
     const result = {
@@ -330,10 +353,10 @@ async function defaultDomainSuggestionMethodImpl(domain, commonDomains) {
       suggested: bestMatch.domain,
       confidence: bestMatch.similarity
     };
-    await cache.set(cacheKey, { suggested: result.suggested, confidence: result.confidence });
+    await cacheStore.set(cacheKey, result);
     return result;
   }
-  await cache.set(cacheKey, null);
+  await cacheStore.set(cacheKey, null);
   return null;
 }
 function suggestDomain(params) {
@@ -350,7 +373,7 @@ function suggestDomain(params) {
   }
   return defaultDomainSuggestionMethod(domain, commonDomains);
 }
-async function suggestEmailDomain(email, commonDomains) {
+async function suggestEmailDomain(email, commonDomains, cache) {
   if (!email || !email.includes("@")) {
     return null;
   }
@@ -358,7 +381,7 @@ async function suggestEmailDomain(email, commonDomains) {
   if (!domain || !localPart) {
     return null;
   }
-  const suggestion = await defaultDomainSuggestionMethodAsync(domain, commonDomains);
+  const suggestion = await defaultDomainSuggestionMethodAsync(domain, commonDomains, cache);
   if (suggestion) {
     return {
       original: email,
@@ -1139,7 +1162,7 @@ async function attemptVerification(params) {
   const { mxRecord, local, domain, port, timeout, log, attempt } = params;
   return new Promise((resolve) => {
     log(`[verifyMailboxSMTP] connecting to ${mxRecord}:${port} (attempt ${attempt + 1})`);
-    const socket = net.connect({
+    const socket = net__namespace.connect({
       host: mxRecord,
       port
     });
@@ -1238,7 +1261,7 @@ async function isValidEmailDomain(emailOrDomain, cache) {
   if (!emailDomain) {
     return false;
   }
-  const cacheStore = domainValidCacheStore(cache);
+  const cacheStore = getCacheStore(cache, "domainValid");
   const cached = await cacheStore.get(emailDomain);
   if (cached !== null && cached !== void 0) {
     return cached;
@@ -1746,7 +1769,7 @@ function queryWhoisServer(domain, server, timeout = 5e3, debug = false) {
   const log = debug ? console.debug : (..._args) => {
   };
   return new Promise((resolve, reject) => {
-    const client = new net.Socket();
+    const client = new net__namespace.Socket();
     let data = "";
     log(`[whois] querying ${server} for domain ${domain}`);
     const timer = setTimeout(() => {
@@ -1776,14 +1799,14 @@ function queryWhoisServer(domain, server, timeout = 5e3, debug = false) {
     });
   });
 }
-async function getWhoisData(domain, timeout = 5e3, debug = false) {
+async function getWhoisData(domain, timeout = 5e3, debug = false, cache) {
   var _a;
   const log = debug ? console.debug : (..._args) => {
   };
   const cacheKey = `whois:${domain}`;
-  const cache = whoisCacheStore();
+  const cacheStore = getCacheStore(cache, "whois");
   log(`[whois] getting WHOIS data for ${domain}`);
-  const cached = await cache.get(cacheKey);
+  const cached = await cacheStore.get(cacheKey);
   if (cached !== null && cached !== void 0) {
     log(`[whois] using cached data for ${domain}`);
     return cached;
@@ -1805,19 +1828,19 @@ async function getWhoisData(domain, timeout = 5e3, debug = false) {
         log(`[whois] IANA referred to ${referredServer} for ${domain}`);
         const whoisResponse2 = await queryWhoisServer(domain, referredServer, timeout, debug);
         const whoisData3 = parseWhoisData({ rawData: whoisResponse2, domain });
-        await cache.set(cacheKey, whoisData3);
+        await cacheStore.set(cacheKey, whoisData3);
         log(`[whois] successfully retrieved and cached WHOIS data from referred server for ${domain}`);
         return whoisData3;
       }
       const whoisData2 = parseWhoisData({ rawData: ianaResponse, domain });
-      await cache.set(cacheKey, whoisData2);
+      await cacheStore.set(cacheKey, whoisData2);
       log(`[whois] successfully retrieved and cached WHOIS data from IANA for ${domain}`);
       return whoisData2;
     }
     log(`[whois] using WHOIS server ${whoisServer} for TLD ${tld}`);
     const whoisResponse = await queryWhoisServer(domain, whoisServer, timeout, debug);
     const whoisData = parseWhoisData({ rawData: whoisResponse, domain });
-    await cache.set(cacheKey, whoisData);
+    await cacheStore.set(cacheKey, whoisData);
     log(`[whois] successfully retrieved and cached WHOIS data for ${domain}`);
     return whoisData;
   } catch (_error) {
@@ -1825,7 +1848,7 @@ async function getWhoisData(domain, timeout = 5e3, debug = false) {
     return null;
   }
 }
-async function getDomainAge(domain, timeout = 5e3, debug = false) {
+async function getDomainAge(domain, timeout = 5e3, debug = false, cache) {
   const log = debug ? console.debug : (..._args) => {
   };
   try {
@@ -1839,7 +1862,7 @@ async function getDomainAge(domain, timeout = 5e3, debug = false) {
       log(`[whois] domain validation failed: ${cleanDomain}`);
       return null;
     }
-    const whoisData = await getWhoisData(cleanDomain, timeout, debug);
+    const whoisData = await getWhoisData(cleanDomain, timeout, debug, cache);
     if (!whoisData || !whoisData.creationDate) {
       log(`[whois] no creation date found for ${cleanDomain}`);
       return null;
@@ -1863,7 +1886,7 @@ async function getDomainAge(domain, timeout = 5e3, debug = false) {
     return null;
   }
 }
-async function getDomainRegistrationStatus(domain, timeout = 5e3, debug = false) {
+async function getDomainRegistrationStatus(domain, timeout = 5e3, debug = false, cache) {
   const log = debug ? console.debug : (..._args) => {
   };
   try {
@@ -1877,7 +1900,7 @@ async function getDomainRegistrationStatus(domain, timeout = 5e3, debug = false)
       log(`[whois] domain validation failed: ${cleanDomain}`);
       return null;
     }
-    const whoisData = await getWhoisData(cleanDomain, timeout, debug);
+    const whoisData = await getWhoisData(cleanDomain, timeout, debug, cache);
     if (!whoisData || whoisData.isAvailable) {
       log(`[whois] domain ${cleanDomain} is available or not registered`);
       return {
@@ -2123,7 +2146,7 @@ async function isDisposableEmail(params) {
   if (!emailDomain) {
     return false;
   }
-  const cacheStore = disposableCacheStore(cache);
+  const cacheStore = getCacheStore(cache, "disposable");
   let cached;
   try {
     cached = await cacheStore.get(emailDomain);
@@ -2156,7 +2179,7 @@ async function isFreeEmail(params) {
   if (!emailDomain) {
     return false;
   }
-  const cacheStore = freeCacheStore(cache);
+  const cacheStore = getCacheStore(cache, "free");
   let cached;
   try {
     cached = await cacheStore.get(emailDomain);
@@ -2267,7 +2290,7 @@ async function verifyEmail(params) {
   if (checkDomainAge && !shouldSkipDomainWhois) {
     log(`[verifyEmail] Checking domain age for ${domain}`);
     try {
-      result.domainAge = await getDomainAge(domain, whoisTimeout, debug);
+      result.domainAge = await getDomainAge(domain, whoisTimeout, debug, params.cache);
       log(`[verifyEmail] Domain age result:`, result.domainAge ? `${result.domainAge.ageInDays} days` : "null");
     } catch (err) {
       log("[verifyEmail] Failed to get domain age", err);
@@ -2279,7 +2302,7 @@ async function verifyEmail(params) {
   if (checkDomainRegistration && !shouldSkipDomainWhois) {
     log(`[verifyEmail] Checking domain registration status for ${domain}`);
     try {
-      result.domainRegistration = await getDomainRegistrationStatus(domain, whoisTimeout, debug);
+      result.domainRegistration = await getDomainRegistrationStatus(domain, whoisTimeout, debug, params.cache);
       log(`[verifyEmail] Domain registration result:`, ((_a = result.domainRegistration) === null || _a === void 0 ? void 0 : _a.isRegistered) ? "registered" : "not registered");
     } catch (err) {
       log("[verifyEmail] Failed to get domain registration status", err);
@@ -2299,7 +2322,7 @@ async function verifyEmail(params) {
       }
       if (verifySmtp && mxRecords.length > 0) {
         const cacheKey = `${emailAddress}:smtp`;
-        const smtpCacheInstance = smtpCacheStore(params.cache);
+        const smtpCacheInstance = getCacheStore(params.cache, "smtp");
         const cachedSmtp = await smtpCacheInstance.get(cacheKey);
         if (cachedSmtp !== null && cachedSmtp !== void 0) {
           result.validSmtp = cachedSmtp;
@@ -2358,16 +2381,17 @@ async function verifyEmail(params) {
 }
 
 exports.COMMON_EMAIL_DOMAINS = COMMON_EMAIL_DOMAINS;
-exports.DEFAULT_CACHE_SIZE = DEFAULT_CACHE_SIZE;
-exports.DEFAULT_CACHE_TTL = DEFAULT_CACHE_TTL;
+exports.DEFAULT_CACHE_OPTIONS = DEFAULT_CACHE_OPTIONS;
 exports.LRUAdapter = LRUAdapter;
 exports.RedisAdapter = RedisAdapter;
-exports.clearAllCaches = clearAllCaches;
+exports.clearDefaultCache = clearDefaultCache;
 exports.defaultDomainSuggestionMethod = defaultDomainSuggestionMethod;
 exports.defaultNameDetectionMethod = defaultNameDetectionMethod;
 exports.detectName = detectName;
 exports.detectNameFromEmail = detectNameFromEmail;
 exports.domainPorts = domainPorts;
+exports.getCacheStore = getCacheStore;
+exports.getDefaultCache = getDefaultCache;
 exports.getDomainAge = getDomainAge;
 exports.getDomainRegistrationStatus = getDomainRegistrationStatus;
 exports.getDomainSimilarity = getDomainSimilarity;
@@ -2376,6 +2400,7 @@ exports.isDisposableEmail = isDisposableEmail;
 exports.isFreeEmail = isFreeEmail;
 exports.isValidEmail = isValidEmail;
 exports.isValidEmailDomain = isValidEmailDomain;
+exports.resetDefaultCache = resetDefaultCache;
 exports.suggestDomain = suggestDomain;
 exports.suggestEmailDomain = suggestEmailDomain;
 exports.verifyEmail = verifyEmail;