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

package/dist/index.esm.js

@@ -2,7 +2,7 @@ import { isValid, parse } from 'psl';
 import { lru } from 'tiny-lru';
 import { promises } from 'node:dns';
 import { stringSimilarity } from 'string-similarity-js';
-import net from 'node:net';
+import * as net from 'node:net';
 
 class LRUAdapter {
   constructor(maxSize = 1e3, ttlMs = 36e5) {
@@ -40,67 +40,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 = lru(500, 36e5);
-const disposableCache = lru(1e3, 864e5);
-const freeCache = lru(1e3, 864e5);
-const domainValidCache = lru(1e3, 864e5);
-const smtpCache = lru(500, 18e5);
-const domainSuggestionCache = lru(1e3, 864e5);
-const whoisCache = 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`);
@@ -264,24 +268,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)) {
@@ -292,7 +296,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;
     }
   }
@@ -320,7 +324,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 = {
@@ -328,10 +332,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) {
@@ -348,7 +352,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;
   }
@@ -356,7 +360,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,
@@ -1236,7 +1240,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;
@@ -1774,14 +1778,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;
@@ -1803,19 +1807,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) {
@@ -1823,7 +1827,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 {
@@ -1837,7 +1841,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;
@@ -1861,7 +1865,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 {
@@ -1875,7 +1879,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 {
@@ -2121,7 +2125,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);
@@ -2154,7 +2158,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);
@@ -2265,7 +2269,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);
@@ -2277,7 +2281,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);
@@ -2297,7 +2301,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;
@@ -2355,5 +2359,5 @@ async function verifyEmail(params) {
   return result;
 }
 
-export { COMMON_EMAIL_DOMAINS, DEFAULT_CACHE_SIZE, DEFAULT_CACHE_TTL, LRUAdapter, RedisAdapter, VerificationErrorCode, clearAllCaches, defaultDomainSuggestionMethod, defaultNameDetectionMethod, detectName, detectNameFromEmail, domainPorts, getDomainAge, getDomainRegistrationStatus, getDomainSimilarity, isCommonDomain, isDisposableEmail, isFreeEmail, isValidEmail, isValidEmailDomain, suggestDomain, suggestEmailDomain, verifyEmail, verifyEmailBatch };
+export { COMMON_EMAIL_DOMAINS, DEFAULT_CACHE_OPTIONS, LRUAdapter, RedisAdapter, VerificationErrorCode, clearDefaultCache, defaultDomainSuggestionMethod, defaultNameDetectionMethod, detectName, detectNameFromEmail, domainPorts, getCacheStore, getDefaultCache, getDomainAge, getDomainRegistrationStatus, getDomainSimilarity, isCommonDomain, isDisposableEmail, isFreeEmail, isValidEmail, isValidEmailDomain, resetDefaultCache, suggestDomain, suggestEmailDomain, verifyEmail, verifyEmailBatch };
 //# sourceMappingURL=index.esm.js.map