@emailcheck/email-validator-js 2.14.1 → 3.0.1-beta.0

package/dist/index.js

@@ -5,6 +5,7 @@ var tinyLru = require('tiny-lru');
 var node_dns = require('node:dns');
 var stringSimilarityJs = require('string-similarity-js');
 var net = require('node:net');
+var tls = require('node:tls');
 
 function _interopNamespaceDefault(e) {
     var n = Object.create(null);
@@ -24,6 +25,7 @@ function _interopNamespaceDefault(e) {
 }
 
 var net__namespace = /*#__PURE__*/_interopNamespaceDefault(net);
+var tls__namespace = /*#__PURE__*/_interopNamespaceDefault(tls);
 
 class LRUAdapter {
   constructor(maxSize = 1e3, ttlMs = 36e5) {
@@ -73,6 +75,8 @@ const DEFAULT_CACHE_OPTIONS = {
     // 24 hours
     smtp: 18e5,
     // 30 minutes
+    smtpPort: 36e5,
+    // 1 hour
     domainSuggestion: 864e5,
     // 24 hours
     whois: 36e5
@@ -84,6 +88,7 @@ const DEFAULT_CACHE_OPTIONS = {
     free: 1e3,
     domainValid: 1e3,
     smtp: 500,
+    smtpPort: 500,
     domainSuggestion: 1e3,
     whois: 200
   }
@@ -97,6 +102,7 @@ function getDefaultCache() {
       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),
+      smtpPort: new LRUAdapter(DEFAULT_CACHE_OPTIONS.maxSize.smtpPort, DEFAULT_CACHE_OPTIONS.ttl.smtpPort),
       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)
     };
@@ -113,6 +119,7 @@ function clearDefaultCache() {
     defaultCacheInstance.free.clear();
     defaultCacheInstance.domainValid.clear();
     defaultCacheInstance.smtp.clear();
+    defaultCacheInstance.smtpPort.clear();
     defaultCacheInstance.domainSuggestion.clear();
     defaultCacheInstance.whois.clear();
   }
@@ -1147,6 +1154,40 @@ function detectName(email) {
   return detectNameFromEmail({ email });
 }
 
+exports.VerificationErrorCode = void 0;
+(function(VerificationErrorCode2) {
+  VerificationErrorCode2["INVALID_FORMAT"] = "INVALID_FORMAT";
+  VerificationErrorCode2["INVALID_DOMAIN"] = "INVALID_DOMAIN";
+  VerificationErrorCode2["NO_MX_RECORDS"] = "NO_MX_RECORDS";
+  VerificationErrorCode2["SMTP_CONNECTION_FAILED"] = "SMTP_CONNECTION_FAILED";
+  VerificationErrorCode2["SMTP_TIMEOUT"] = "SMTP_TIMEOUT";
+  VerificationErrorCode2["MAILBOX_NOT_FOUND"] = "MAILBOX_NOT_FOUND";
+  VerificationErrorCode2["MAILBOX_FULL"] = "MAILBOX_FULL";
+  VerificationErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  VerificationErrorCode2["DISPOSABLE_EMAIL"] = "DISPOSABLE_EMAIL";
+  VerificationErrorCode2["FREE_EMAIL_PROVIDER"] = "FREE_EMAIL_PROVIDER";
+})(exports.VerificationErrorCode || (exports.VerificationErrorCode = {}));
+exports.SMTPStep = void 0;
+(function(SMTPStep2) {
+  SMTPStep2["GREETING"] = "GREETING";
+  SMTPStep2["EHLO"] = "EHLO";
+  SMTPStep2["HELO"] = "HELO";
+  SMTPStep2["STARTTLS"] = "STARTTLS";
+  SMTPStep2["MAIL_FROM"] = "MAIL_FROM";
+  SMTPStep2["RCPT_TO"] = "RCPT_TO";
+  SMTPStep2["VRFY"] = "VRFY";
+  SMTPStep2["QUIT"] = "QUIT";
+})(exports.SMTPStep || (exports.SMTPStep = {}));
+
+function isIPAddress(host) {
+  const ipv4Regex = /^(\d{1,3}\.){3}\d{1,3}$/;
+  if (ipv4Regex.test(host)) {
+    const octets = host.split(".");
+    return octets.every((octet) => parseInt(octet, 10) <= 255);
+  }
+  const ipv6Regex = /^(?:[0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}$|^(?:[0-9a-fA-F]{1,4}:){1,7}:$|^(?:[0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}$|^(?:[0-9a-fA-F]{1,4}:){1,5}(?::[0-9a-fA-F]{1,4}){1,2}$|^(?:[0-9a-fA-F]{1,4}:){1,4}(?::[0-9a-fA-F]{1,4}){1,3}$|^(?:[0-9a-fA-F]{1,4}:){1,3}(?::[0-9a-fA-F]{1,4}){1,4}$|^(?:[0-9a-fA-F]{1,4}:){1,2}(?::[0-9a-fA-F]{1,4}){1,5}$|^[0-9a-fA-F]{1,4}:(?:(?::[0-9a-fA-F]{1,4}){1,6})$|^::1(?::(?::[0-9a-fA-F]{1,4}){1,7})|$|:(?:(?::[0-9a-fA-F]{1,4}){1,7}:)$/;
+  return ipv6Regex.test(host);
+}
 function isOverQuota(smtpReply) {
   return Boolean(smtpReply && /(over quota)/gi.test(smtpReply));
 }
@@ -1156,129 +1197,382 @@ function isInvalidMailboxError(smtpReply) {
 function isMultilineGreet(smtpReply) {
   return Boolean(smtpReply && /^(250|220)-/.test(smtpReply));
 }
+const DEFAULT_PORTS = [25, 587, 465];
+const DEFAULT_TIMEOUT = 3e3;
+const DEFAULT_MAX_RETRIES = 1;
+const PORT_CONFIGS = {
+  25: { tls: false, starttls: true },
+  587: { tls: false, starttls: true },
+  465: { tls: true, starttls: false }
+};
 async function verifyMailboxSMTP(params) {
-  const { local, domain, mxRecords = [], timeout, debug, port = 25, retryAttempts = 1 } = params;
-  const log = debug ? console.debug : (..._args) => {
+  const { local, domain, mxRecords = [], options = {} } = params;
+  const { ports = DEFAULT_PORTS, timeout = DEFAULT_TIMEOUT, maxRetries = DEFAULT_MAX_RETRIES, tls: tlsConfig = true, hostname = "localhost", useVRFY = true, cache, debug = false, sequence } = options;
+  const log = debug ? (...args) => console.log("[SMTP]", ...args) : () => {
   };
   if (!mxRecords || mxRecords.length === 0) {
-    return false;
+    log("No MX records found");
+    return { result: false, cached: false, port: 0, portCached: false };
+  }
+  const mxHost = mxRecords[0];
+  log(`Verifying ${local}@${domain} via ${mxHost}`);
+  const smtpCacheStore = cache ? getCacheStore(cache, "smtp") : null;
+  if (smtpCacheStore) {
+    let cachedResult;
+    try {
+      cachedResult = await smtpCacheStore.get(`${mxHost}:${local}@${domain}`);
+      if (cachedResult !== void 0) {
+        log(`Using cached SMTP result: ${cachedResult}`);
+        return {
+          result: typeof cachedResult === "boolean" ? cachedResult : null,
+          cached: true,
+          port: 0,
+          portCached: false
+        };
+      }
+    } catch (_error) {
+      cachedResult = void 0;
+    }
   }
-  const mxIndex = 0;
-  const mxRecord = mxRecords[mxIndex];
-  for (let attempt = 0; attempt < retryAttempts; attempt++) {
-    const result = await attemptVerification({
-      mxRecord,
-      local,
-      domain,
-      port,
-      timeout,
-      log,
-      attempt
-    });
-    if (result !== null) {
-      return result;
+  const smtpPortCacheStore = cache ? getCacheStore(cache, "smtpPort") : null;
+  if (smtpPortCacheStore) {
+    let cachedPort;
+    try {
+      cachedPort = await smtpPortCacheStore.get(mxHost);
+    } catch (_error) {
+      cachedPort = null;
     }
-    if (attempt < retryAttempts - 1) {
-      await new Promise((resolve) => setTimeout(resolve, Math.min(1e3 * (attempt + 1), 3e3)));
+    if (cachedPort) {
+      log(`Using cached port: ${cachedPort}`);
+      const result = await testSMTPConnection({
+        mxHost,
+        port: cachedPort,
+        local,
+        domain,
+        timeout,
+        tlsConfig,
+        hostname,
+        useVRFY,
+        sequence,
+        log
+      });
+      if (smtpCacheStore && result !== void 0) {
+        try {
+          await smtpCacheStore.set(`${mxHost}:${local}@${domain}`, result);
+          log(`Cached SMTP result ${result} for ${local}@${domain} via ${mxHost}`);
+        } catch (_error) {
+        }
+      }
+      return { result, cached: false, port: cachedPort, portCached: true };
     }
   }
-  return null;
+  for (const port of ports) {
+    log(`Testing port ${port}`);
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+      if (attempt > 0) {
+        const delay = Math.min(1e3 * 2 ** (attempt - 1), 5e3);
+        log(`Retry ${attempt + 1}, waiting ${delay}ms`);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+      const result = await testSMTPConnection({
+        mxHost,
+        port,
+        local,
+        domain,
+        timeout,
+        tlsConfig,
+        hostname,
+        useVRFY,
+        sequence,
+        log
+      });
+      if (smtpCacheStore && result !== void 0) {
+        try {
+          await smtpCacheStore.set(`${mxHost}:${local}@${domain}`, result);
+          log(`Cached SMTP result ${result} for ${local}@${domain} via ${mxHost}`);
+        } catch (_error) {
+        }
+      }
+      if (result !== null) {
+        if (smtpPortCacheStore) {
+          try {
+            await smtpPortCacheStore.set(mxHost, port);
+            log(`Cached port ${port} for ${mxHost}`);
+          } catch (_error) {
+          }
+        }
+        return { result, cached: false, port, portCached: false };
+      }
+    }
+  }
+  log("All ports failed");
+  return { result: null, cached: false, port: 0, portCached: false };
 }
-async function attemptVerification(params) {
-  const { mxRecord, local, domain, port, timeout, log, attempt } = params;
+async function testSMTPConnection(params) {
+  const { mxHost, port, local, domain, timeout, tlsConfig, hostname, useVRFY, sequence, log } = params;
+  const portConfig = PORT_CONFIGS[port] || { tls: false, starttls: false };
+  const useTLS = tlsConfig !== false && (portConfig.tls || portConfig.starttls);
+  const implicitTLS = portConfig.tls;
+  const defaultSequence = {
+    steps: [exports.SMTPStep.GREETING, exports.SMTPStep.EHLO, exports.SMTPStep.MAIL_FROM, exports.SMTPStep.RCPT_TO]
+  };
+  const activeSequence = sequence || defaultSequence;
+  if (port === 25) {
+    activeSequence.steps = activeSequence.steps.map((step) => step === exports.SMTPStep.EHLO ? exports.SMTPStep.HELO : step);
+  }
+  const tlsOptions = {
+    host: mxHost,
+    servername: isIPAddress(mxHost) ? void 0 : mxHost,
+    // Don't set servername for IP addresses
+    rejectUnauthorized: false,
+    minVersion: "TLSv1.2",
+    ...typeof tlsConfig === "object" ? tlsConfig : {}
+  };
   return new Promise((resolve) => {
-    log(`[verifyMailboxSMTP] connecting to ${mxRecord}:${port} (attempt ${attempt + 1})`);
-    const socket = net__namespace.connect({
-      host: mxRecord,
-      port
-    });
-    let resTimeout = null;
+    let socket;
+    let buffer = "";
+    let isTLS = implicitTLS;
+    let currentStepIndex = 0;
     let resolved = false;
-    let cleaned = false;
+    let supportsSTARTTLS = false;
+    let supportsVRFY = false;
     const cleanup = () => {
-      if (cleaned)
-        return;
-      cleaned = true;
-      if (resTimeout) {
-        clearTimeout(resTimeout);
-        resTimeout = null;
-      }
-      if (socket && !socket.destroyed) {
-        socket.removeAllListeners();
-        socket.destroy();
-      }
-    };
-    const ret = (result) => {
       if (resolved)
         return;
       resolved = true;
-      if (!(socket === null || socket === void 0 ? void 0 : socket.destroyed)) {
-        log("[verifyMailboxSMTP] closing socket");
+      try {
         socket === null || socket === void 0 ? void 0 : socket.write("QUIT\r\n");
-        socket === null || socket === void 0 ? void 0 : socket.end();
+      } catch {
       }
+      setTimeout(() => socket === null || socket === void 0 ? void 0 : socket.destroy(), 100);
+    };
+    const finish = (result, reason) => {
+      if (resolved)
+        return;
+      log(`${port}: ${reason || (result ? "valid" : "invalid")}`);
       cleanup();
       resolve(result);
     };
-    const messages = [`HELO ${domain}`, `MAIL FROM: <${local}@${domain}>`, `RCPT TO: <${local}@${domain}>`];
-    log("[verifyMailboxSMTP] writing messages", messages);
-    socket.on("data", (data) => {
-      const dataString = String(data);
-      log("[verifyMailboxSMTP] got data", dataString);
-      if (isInvalidMailboxError(dataString))
-        return ret(false);
-      if (isOverQuota(dataString))
-        return ret(false);
-      if (!dataString.includes("220") && !dataString.includes("250"))
-        return ret(null);
-      if (isMultilineGreet(dataString))
+    const sendCommand = (cmd) => {
+      if (resolved)
         return;
-      if (messages.length > 0) {
-        const message = messages.shift();
-        log("[verifyMailboxSMTP] writing message", message);
-        return socket.write(`${message}\r
+      log(`\u2192 ${cmd}`);
+      socket === null || socket === void 0 ? void 0 : socket.write(`${cmd}\r
 `);
+    };
+    const nextStep = () => {
+      currentStepIndex++;
+      if (currentStepIndex >= activeSequence.steps.length) {
+        finish(true, "sequence_complete");
+        return;
       }
-      ret(true);
-    });
-    socket.on("error", (err) => {
-      log("[verifyMailboxSMTP] error in socket", err);
-      ret(null);
-    });
-    socket.on("close", (err) => {
-      if (!resolved) {
-        log("[verifyMailboxSMTP] close socket", err);
-        ret(null);
+      executeStep(activeSequence.steps[currentStepIndex]);
+    };
+    const executeStep = (step) => {
+      if (resolved)
+        return;
+      switch (step) {
+        case exports.SMTPStep.EHLO:
+          sendCommand(`EHLO ${hostname}`);
+          break;
+        case exports.SMTPStep.HELO:
+          sendCommand(`HELO ${domain}`);
+          break;
+        case exports.SMTPStep.GREETING:
+          break;
+        case exports.SMTPStep.STARTTLS:
+          sendCommand("STARTTLS");
+          break;
+        case exports.SMTPStep.MAIL_FROM: {
+          const from = activeSequence.from || "<>";
+          sendCommand(`MAIL FROM:${from}`);
+          break;
+        }
+        case exports.SMTPStep.RCPT_TO:
+          sendCommand(`RCPT TO:<${local}@${domain}>`);
+          break;
+        case exports.SMTPStep.VRFY: {
+          const vrfyTarget = activeSequence.vrfyTarget || local;
+          sendCommand(`VRFY ${vrfyTarget}`);
+          break;
+        }
+        case exports.SMTPStep.QUIT:
+          sendCommand("QUIT");
+          break;
       }
-    });
-    socket.on("timeout", () => {
-      log("[verifyMailboxSMTP] timeout socket");
-      ret(null);
-    });
-    resTimeout = setTimeout(() => {
-      log(`[verifyMailboxSMTP] timed out (${timeout} ms)`);
-      if (!resolved) {
-        socket.destroy();
-        ret(null);
+    };
+    const processResponse = (response) => {
+      if (resolved)
+        return;
+      const code = response.substring(0, 3);
+      const isMultiline = response.length > 3 && response[3] === "-";
+      log(`\u2190 ${response}`);
+      if (isMultilineGreet(response)) {
+        return;
       }
-    }, timeout);
+      if (isOverQuota(response)) {
+        finish(false, "over_quota");
+        return;
+      }
+      if (isInvalidMailboxError(response)) {
+        finish(false, "not_found");
+        return;
+      }
+      if (isMultiline) {
+        const currentStep2 = activeSequence.steps[currentStepIndex];
+        if (currentStep2 === exports.SMTPStep.EHLO && code === "250") {
+          const upper = response.toUpperCase();
+          if (upper.includes("STARTTLS"))
+            supportsSTARTTLS = true;
+          if (upper.includes("VRFY"))
+            supportsVRFY = true;
+        }
+        if (currentStep2 === exports.SMTPStep.HELO && code === "250") {
+          const upper = response.toUpperCase();
+          if (upper.includes("VRFY"))
+            supportsVRFY = true;
+        }
+        return;
+      }
+      if (!response.includes("220") && !response.includes("250") && !response.includes("550") && !response.includes("552")) {
+        finish(null, "unrecognized_response");
+        return;
+      }
+      const currentStep = activeSequence.steps[currentStepIndex];
+      switch (currentStep) {
+        case exports.SMTPStep.GREETING:
+          if (code.startsWith("220")) {
+            nextStep();
+          } else {
+            finish(null, "no_greeting");
+          }
+          break;
+        case exports.SMTPStep.EHLO:
+          if (code.startsWith("250")) {
+            const hasSTARTTLS = activeSequence.steps.includes(exports.SMTPStep.STARTTLS);
+            if (!isTLS && useTLS && supportsSTARTTLS && !implicitTLS && hasSTARTTLS) {
+              currentStepIndex = activeSequence.steps.indexOf(exports.SMTPStep.STARTTLS);
+              executeStep(exports.SMTPStep.STARTTLS);
+            } else {
+              nextStep();
+            }
+          } else {
+            finish(null, "ehlo_failed");
+          }
+          break;
+        case exports.SMTPStep.HELO:
+          if (code.startsWith("250")) {
+            nextStep();
+          } else {
+            finish(null, "helo_failed");
+          }
+          break;
+        case exports.SMTPStep.STARTTLS:
+          if (code.startsWith("220")) {
+            const plainSocket = socket;
+            socket = tls__namespace.connect({
+              ...tlsOptions,
+              socket: plainSocket,
+              servername: isIPAddress(mxHost) ? void 0 : mxHost
+            }, () => {
+              isTLS = true;
+              log("TLS upgraded");
+              buffer = "";
+              const starttlsIndex = activeSequence.steps.indexOf(exports.SMTPStep.STARTTLS);
+              currentStepIndex = starttlsIndex;
+              nextStep();
+            });
+            socket.on("data", handleData);
+            socket.on("error", () => finish(null, "tls_error"));
+          } else {
+            nextStep();
+          }
+          break;
+        case exports.SMTPStep.MAIL_FROM:
+          if (code.startsWith("250")) {
+            nextStep();
+          } else {
+            finish(null, "mail_from_rejected");
+          }
+          break;
+        case exports.SMTPStep.RCPT_TO:
+          if (code.startsWith("250") || code.startsWith("251")) {
+            finish(true, "valid");
+          } else if (code.startsWith("552") || code.startsWith("452")) {
+            finish(false, "over_quota");
+          } else if (code.startsWith("4")) {
+            finish(null, "temporary_failure");
+          } else if (useVRFY && supportsVRFY && code.startsWith("5") && activeSequence.steps.includes(exports.SMTPStep.VRFY)) {
+            currentStepIndex = activeSequence.steps.indexOf(exports.SMTPStep.VRFY);
+            executeStep(exports.SMTPStep.VRFY);
+          } else {
+            finish(null, "ambiguous");
+          }
+          break;
+        case exports.SMTPStep.VRFY:
+          if (code.startsWith("250") || code.startsWith("252")) {
+            finish(true, "vrfy_valid");
+          } else if (code.startsWith("550")) {
+            finish(false, "vrfy_invalid");
+          } else {
+            finish(null, "vrfy_failed");
+          }
+          break;
+        case exports.SMTPStep.QUIT:
+          if (code.startsWith("221")) {
+            finish(null, "quit_received");
+          }
+          break;
+      }
+    };
+    const handleData = (data) => {
+      if (resolved)
+        return;
+      buffer += data.toString();
+      let pos;
+      while ((pos = buffer.indexOf("\r\n")) !== -1) {
+        const line = buffer.substring(0, pos);
+        buffer = buffer.substring(pos + 2);
+        processResponse(line.trim());
+      }
+    };
+    if (port < 0 || port > 65535 || !Number.isInteger(port)) {
+      finish(null, "invalid_port");
+      return;
+    }
+    if (implicitTLS) {
+      const connectOptions = {
+        ...tlsOptions,
+        port,
+        servername: isIPAddress(mxHost) ? void 0 : mxHost
+      };
+      socket = tls__namespace.connect(connectOptions, () => {
+        log(`Connected to ${mxHost}:${port} with TLS`);
+        socket.on("data", handleData);
+      });
+    } else {
+      socket = net__namespace.connect({ host: mxHost, port }, () => {
+        log(`Connected to ${mxHost}:${port}`);
+        socket.on("data", handleData);
+      });
+    }
+    if (activeSequence.steps.length === 0) {
+      finish(true, "sequence_complete");
+      return;
+    }
+    const firstStep = activeSequence.steps[0];
+    if (firstStep !== exports.SMTPStep.GREETING) {
+      executeStep(firstStep);
+    }
+    socket.setTimeout(timeout, () => finish(null, "timeout"));
+    socket.on("error", () => finish(null, "connection_error"));
+    socket.on("close", () => {
+      if (!resolved)
+        finish(null, "connection_closed");
+    });
   });
 }
 
-exports.VerificationErrorCode = void 0;
-(function(VerificationErrorCode2) {
-  VerificationErrorCode2["INVALID_FORMAT"] = "INVALID_FORMAT";
-  VerificationErrorCode2["INVALID_DOMAIN"] = "INVALID_DOMAIN";
-  VerificationErrorCode2["NO_MX_RECORDS"] = "NO_MX_RECORDS";
-  VerificationErrorCode2["SMTP_CONNECTION_FAILED"] = "SMTP_CONNECTION_FAILED";
-  VerificationErrorCode2["SMTP_TIMEOUT"] = "SMTP_TIMEOUT";
-  VerificationErrorCode2["MAILBOX_NOT_FOUND"] = "MAILBOX_NOT_FOUND";
-  VerificationErrorCode2["MAILBOX_FULL"] = "MAILBOX_FULL";
-  VerificationErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
-  VerificationErrorCode2["DISPOSABLE_EMAIL"] = "DISPOSABLE_EMAIL";
-  VerificationErrorCode2["FREE_EMAIL_PROVIDER"] = "FREE_EMAIL_PROVIDER";
-})(exports.VerificationErrorCode || (exports.VerificationErrorCode = {}));
-
 async function isValidEmailDomain(emailOrDomain, cache) {
   let [_, emailDomain] = (emailOrDomain === null || emailOrDomain === void 0 ? void 0 : emailOrDomain.split("@")) || [];
   if (!emailDomain) {
@@ -2371,17 +2665,22 @@ async function verifyEmail(params) {
               domainPort = domainPorts[mxDomain.domain];
             }
           }
-          const smtpResult = await verifyMailboxSMTP({
+          const { result: smtpResult, cached, portCached, port } = await verifyMailboxSMTP({
             local,
             domain,
             mxRecords,
-            timeout,
-            debug,
-            port: domainPort,
-            retryAttempts: params.retryAttempts
+            options: {
+              cache: params.cache,
+              ports: domainPort ? [domainPort] : void 0,
+              timeout,
+              debug,
+              maxRetries: params.retryAttempts
+            }
           });
           await smtpCacheInstance.set(cacheKey, smtpResult);
           result.validSmtp = smtpResult;
+          if (result.metadata)
+            result.metadata.cached = cached;
           log(`[verifyEmail] SMTP verification result: ${result.validSmtp} for ${emailAddress} (cached for future use)`);
         }
         if (result.validSmtp === false && result.metadata) {