linkedin-secret-sauce 0.11.0 → 0.11.1

package/dist/enrichment/auth/smartlead-auth.d.ts

@@ -64,10 +64,10 @@ export declare function getSmartLeadTokenCacheStats(): {
  * // In your test setup
  * import { enableFileCache } from 'linkedin-secret-sauce/enrichment';
  *
- * enableFileCache(); // Now tokens persist between test runs
+ * await enableFileCache(); // Now tokens persist between test runs
  * ```
  */
-export declare function enableFileCache(): void;
+export declare function enableFileCache(): Promise<void>;
 /**
  * Disable file-based token caching
  */
@@ -79,4 +79,4 @@ export declare function isFileCacheEnabled(): boolean;
 /**
  * Clear the file cache
  */
-export declare function clearFileCache(): void;
+export declare function clearFileCache(): Promise<void>;

package/dist/enrichment/auth/smartlead-auth.js

@@ -51,9 +51,10 @@ exports.enableFileCache = enableFileCache;
 exports.disableFileCache = disableFileCache;
 exports.isFileCacheEnabled = isFileCacheEnabled;
 exports.clearFileCache = clearFileCache;
-const fs = __importStar(require("fs"));
+const fs = __importStar(require("fs/promises"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
+const http_retry_1 = require("../utils/http-retry");
 const DEFAULT_LOGIN_URL = 'https://server.smartlead.ai/api/auth/login';
 const DEFAULT_REFRESH_BUFFER_MS = 5 * 60 * 1000; // 5 minutes
 const TOKEN_LIFETIME_MS = 24 * 60 * 60 * 1000; // Assume 24h JWT lifetime (conservative)
@@ -213,34 +214,32 @@ function getFileCachePath() {
     return path.join(homeDir, FILE_CACHE_NAME);
 }
 /**
- * Load tokens from file cache
+ * Load tokens from file cache (async)
  */
-function loadFileCache() {
+async function loadFileCache() {
     const cache = new Map();
     if (!fileCacheEnabled)
         return cache;
     try {
         const filePath = getFileCachePath();
-        if (fs.existsSync(filePath)) {
-            const content = fs.readFileSync(filePath, 'utf8');
-            const data = JSON.parse(content);
-            for (const [key, value] of Object.entries(data)) {
-                // Validate structure
-                if (value && value.token && value.expiresAt && value.obtainedAt) {
-                    cache.set(key, value);
-                }
+        const content = await fs.readFile(filePath, 'utf8');
+        const data = (0, http_retry_1.safeJsonParse)(content, {});
+        for (const [key, value] of Object.entries(data)) {
+            // Validate structure
+            if (value && value.token && value.expiresAt && value.obtainedAt) {
+                cache.set(key, value);
             }
         }
     }
     catch {
-        // Ignore file read errors
+        // Ignore file read errors (file may not exist)
     }
     return cache;
 }
 /**
- * Save tokens to file cache
+ * Save tokens to file cache (async, fire-and-forget)
  */
-function saveFileCache() {
+async function saveFileCache() {
     if (!fileCacheEnabled)
         return;
     try {
@@ -249,7 +248,7 @@ function saveFileCache() {
         for (const [key, value] of tokenCache.entries()) {
             data[key] = value;
         }
-        fs.writeFileSync(filePath, JSON.stringify(data, null, 2), 'utf8');
+        await fs.writeFile(filePath, JSON.stringify(data, null, 2), 'utf8');
     }
     catch {
         // Ignore file write errors
@@ -266,13 +265,13 @@ function saveFileCache() {
  * // In your test setup
  * import { enableFileCache } from 'linkedin-secret-sauce/enrichment';
  *
- * enableFileCache(); // Now tokens persist between test runs
+ * await enableFileCache(); // Now tokens persist between test runs
  * ```
  */
-function enableFileCache() {
+async function enableFileCache() {
     fileCacheEnabled = true;
     // Load existing tokens from file into memory cache
-    const fileTokens = loadFileCache();
+    const fileTokens = await loadFileCache();
     for (const [key, value] of fileTokens.entries()) {
         // Only load if not already in memory and still valid
         if (!tokenCache.has(key) && isTokenValid(value, DEFAULT_REFRESH_BUFFER_MS)) {
@@ -295,25 +294,26 @@ function isFileCacheEnabled() {
 /**
  * Clear the file cache
  */
-function clearFileCache() {
+async function clearFileCache() {
     try {
         const filePath = getFileCachePath();
-        if (fs.existsSync(filePath)) {
-            fs.unlinkSync(filePath);
-        }
+        await fs.unlink(filePath);
     }
     catch {
-        // Ignore errors
+        // Ignore errors (file may not exist)
     }
 }
 // We need to modify the token caching behavior to persist to file
 // This is done by wrapping the cache set operation
-// Override tokenCache.set to also persist to file
+// Override tokenCache.set to also persist to file (fire-and-forget async)
 const originalSet = tokenCache.set.bind(tokenCache);
 tokenCache.set = function (key, value) {
     const result = originalSet(key, value);
     if (fileCacheEnabled) {
-        saveFileCache();
+        // Fire-and-forget: don't await, just let it run in background
+        saveFileCache().catch(() => {
+            // Ignore save errors silently
+        });
     }
     return result;
 };

package/dist/enrichment/index.d.ts

@@ -10,8 +10,9 @@
  *
  * const enricher = createEnrichmentClient({
  *   providers: {
- *     hunter: { apiKey: process.env.HUNTER_API_KEY },
- *     apollo: { apiKey: process.env.APOLLO_API_KEY },
+ *     ldd: { apiUrl: process.env.LDD_API_URL, apiToken: process.env.LDD_API_TOKEN },
+ *     smartprospect: { email: process.env.SMARTLEAD_EMAIL, password: process.env.SMARTLEAD_PASSWORD },
+ *     bouncer: { apiKey: process.env.BOUNCER_API_KEY },
  *   },
  *   options: {
  *     maxCostPerEmail: 0.05,
@@ -35,11 +36,12 @@ import type { EnrichmentClientConfig, EnrichmentClient } from "./types";
  */
 export declare function createEnrichmentClient(config: EnrichmentClientConfig): EnrichmentClient;
 export * from "./types";
+export { PROVIDER_COSTS, DEFAULT_PROVIDER_ORDER } from "./types";
 export { isPersonalEmail, isBusinessEmail, isPersonalDomain, PERSONAL_DOMAINS, } from "./utils/personal-domains";
 export { isDisposableEmail, isDisposableDomain, DISPOSABLE_DOMAINS, } from "./utils/disposable-domains";
 export { isValidEmailSyntax, isRoleAccount, asciiFold, cleanNamePart, hostnameFromUrl, extractLinkedInUsername, } from "./utils/validation";
-export { verifyEmailMx } from "./verification/mx";
-export { createConstructProvider, createLddProvider, createSmartProspectProvider, createHunterProvider, createApolloProvider, createDropcontactProvider, createBouncerProvider, createSnovioProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache, } from "./providers";
+export { verifyEmailMx, checkDomainCatchAll, verifyEmailsExist } from "./verification/mx";
+export { createConstructProvider, createLddProvider, createSmartProspectProvider, createHunterProvider, createDropcontactProvider, createBouncerProvider, createSnovioProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache, } from "./providers";
 export { extractNumericLinkedInId } from "./providers/ldd";
 export { createSmartProspectClient, type SmartProspectClient, type SmartProspectLocationOptions, } from "./providers/smartprospect";
 export { enrichBusinessEmail, enrichBatch, enrichAllEmails, enrichAllBatch } from "./orchestrator";

package/dist/enrichment/index.js

@@ -11,8 +11,9 @@
  *
  * const enricher = createEnrichmentClient({
  *   providers: {
- *     hunter: { apiKey: process.env.HUNTER_API_KEY },
- *     apollo: { apiKey: process.env.APOLLO_API_KEY },
+ *     ldd: { apiUrl: process.env.LDD_API_URL, apiToken: process.env.LDD_API_TOKEN },
+ *     smartprospect: { email: process.env.SMARTLEAD_EMAIL, password: process.env.SMARTLEAD_PASSWORD },
+ *     bouncer: { apiKey: process.env.BOUNCER_API_KEY },
  *   },
  *   options: {
  *     maxCostPerEmail: 0.05,
@@ -42,40 +43,39 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.enrichLinkedInContact = exports.parseLinkedInSearchResponse = exports.buildSmartProspectFiltersFromLinkedIn = exports.matchContacts = exports.findBestMatch = exports.classifyMatchQuality = exports.calculateMatchConfidence = exports.clearFileCache = exports.isFileCacheEnabled = exports.disableFileCache = exports.enableFileCache = exports.getSmartLeadTokenCacheStats = exports.clearAllSmartLeadTokens = exports.clearSmartLeadToken = exports.getSmartLeadUser = exports.getSmartLeadToken = exports.enrichAllBatch = exports.enrichAllEmails = exports.enrichBatch = exports.enrichBusinessEmail = exports.createSmartProspectClient = exports.extractNumericLinkedInId = exports.clearSnovioTokenCache = exports.verifyEmailWithSnovio = exports.findEmailsWithSnovio = exports.verifyEmailsBatch = exports.checkCatchAllDomain = exports.verifyEmailWithBouncer = exports.createSnovioProvider = exports.createBouncerProvider = exports.createDropcontactProvider = exports.createApolloProvider = exports.createHunterProvider = exports.createSmartProspectProvider = exports.createLddProvider = exports.createConstructProvider = exports.verifyEmailMx = exports.extractLinkedInUsername = exports.hostnameFromUrl = exports.cleanNamePart = exports.asciiFold = exports.isRoleAccount = exports.isValidEmailSyntax = exports.DISPOSABLE_DOMAINS = exports.isDisposableDomain = exports.isDisposableEmail = exports.PERSONAL_DOMAINS = exports.isPersonalDomain = exports.isBusinessEmail = exports.isPersonalEmail = void 0;
-exports.salesLeadToContact = exports.getEmailsForLinkedInContactsBatch = exports.getEmailsForLinkedInContact = exports.createLinkedInEnricher = exports.enrichLinkedInContactsBatch = void 0;
+exports.matchContacts = exports.findBestMatch = exports.classifyMatchQuality = exports.calculateMatchConfidence = exports.clearFileCache = exports.isFileCacheEnabled = exports.disableFileCache = exports.enableFileCache = exports.getSmartLeadTokenCacheStats = exports.clearAllSmartLeadTokens = exports.clearSmartLeadToken = exports.getSmartLeadUser = exports.getSmartLeadToken = exports.enrichAllBatch = exports.enrichAllEmails = exports.enrichBatch = exports.enrichBusinessEmail = exports.createSmartProspectClient = exports.extractNumericLinkedInId = exports.clearSnovioTokenCache = exports.verifyEmailWithSnovio = exports.findEmailsWithSnovio = exports.verifyEmailsBatch = exports.checkCatchAllDomain = exports.verifyEmailWithBouncer = exports.createSnovioProvider = exports.createBouncerProvider = exports.createDropcontactProvider = exports.createHunterProvider = exports.createSmartProspectProvider = exports.createLddProvider = exports.createConstructProvider = exports.verifyEmailsExist = exports.checkDomainCatchAll = exports.verifyEmailMx = exports.extractLinkedInUsername = exports.hostnameFromUrl = exports.cleanNamePart = exports.asciiFold = exports.isRoleAccount = exports.isValidEmailSyntax = exports.DISPOSABLE_DOMAINS = exports.isDisposableDomain = exports.isDisposableEmail = exports.PERSONAL_DOMAINS = exports.isPersonalDomain = exports.isBusinessEmail = exports.isPersonalEmail = exports.DEFAULT_PROVIDER_ORDER = exports.PROVIDER_COSTS = void 0;
+exports.salesLeadToContact = exports.getEmailsForLinkedInContactsBatch = exports.getEmailsForLinkedInContact = exports.createLinkedInEnricher = exports.enrichLinkedInContactsBatch = exports.enrichLinkedInContact = exports.parseLinkedInSearchResponse = exports.buildSmartProspectFiltersFromLinkedIn = void 0;
 exports.createEnrichmentClient = createEnrichmentClient;
 const orchestrator_1 = require("./orchestrator");
 const construct_1 = require("./providers/construct");
 const ldd_1 = require("./providers/ldd");
 const smartprospect_1 = require("./providers/smartprospect");
 const hunter_1 = require("./providers/hunter");
-const apollo_1 = require("./providers/apollo");
 const dropcontact_1 = require("./providers/dropcontact");
 const bouncer_1 = require("./providers/bouncer");
 const snovio_1 = require("./providers/snovio");
 /**
- * Default provider order
+ * Default provider order - 2-Phase Strategy
  *
- * Strategy:
- * 1. construct - FREE pattern guessing with MX check
- * 2. bouncer - SMTP verification of construct results ($0.006/email)
- * 3. ldd - FREE LinkedIn data dump lookup
- * 4. smartprospect - Paid SmartLead lookup ($0.01/email)
- * 5. snovio - Email finder for catch-all domains ($0.02/email)
- * 6. hunter - Hunter.io API ($0.005/email)
- * 7. apollo - FREE Apollo.io lookup
- * 8. dropcontact - Dropcontact API ($0.01/email)
+ * PHASE 1 - Free lookups (real data):
+ *   - ldd: LinkedIn Data Dump - real verified emails (FREE)
+ *   - smartprospect: SmartLead API - real verified emails (FREE with subscription)
+ *   - construct: Pattern guessing + MX check (FREE)
+ *
+ * PHASE 2 - Paid verification/finding (only if needed):
+ *   - bouncer: SMTP verify constructed emails ($0.006/email)
+ *   - snovio: Email finder for catch-all domains ($0.02/email)
+ *   - hunter: Hunter.io fallback ($0.005/email)
+ *
+ * Note: dropcontact available but not in default order
  */
 const DEFAULT_ORDER = [
-    "construct",
-    "bouncer",
     "ldd",
     "smartprospect",
+    "construct",
+    "bouncer",
     "snovio",
     "hunter",
-    "apollo",
-    "dropcontact",
 ];
 /**
  * Create an enrichment client with the given configuration
@@ -99,9 +99,6 @@ function createEnrichmentClient(config) {
     if (providerConfigs.hunter) {
         providerFuncs.set("hunter", (0, hunter_1.createHunterProvider)(providerConfigs.hunter));
     }
-    if (providerConfigs.apollo) {
-        providerFuncs.set("apollo", (0, apollo_1.createApolloProvider)(providerConfigs.apollo));
-    }
     if (providerConfigs.dropcontact) {
         providerFuncs.set("dropcontact", (0, dropcontact_1.createDropcontactProvider)(providerConfigs.dropcontact));
     }
@@ -241,8 +238,11 @@ function buildCacheKey(candidate) {
     }
     return parts.join("|");
 }
-// Re-export types
+// Re-export types and constants
 __exportStar(require("./types"), exports);
+var types_1 = require("./types");
+Object.defineProperty(exports, "PROVIDER_COSTS", { enumerable: true, get: function () { return types_1.PROVIDER_COSTS; } });
+Object.defineProperty(exports, "DEFAULT_PROVIDER_ORDER", { enumerable: true, get: function () { return types_1.DEFAULT_PROVIDER_ORDER; } });
 // Re-export utilities
 var personal_domains_1 = require("./utils/personal-domains");
 Object.defineProperty(exports, "isPersonalEmail", { enumerable: true, get: function () { return personal_domains_1.isPersonalEmail; } });
@@ -263,13 +263,14 @@ Object.defineProperty(exports, "extractLinkedInUsername", { enumerable: true, ge
 // Re-export verification
 var mx_1 = require("./verification/mx");
 Object.defineProperty(exports, "verifyEmailMx", { enumerable: true, get: function () { return mx_1.verifyEmailMx; } });
+Object.defineProperty(exports, "checkDomainCatchAll", { enumerable: true, get: function () { return mx_1.checkDomainCatchAll; } });
+Object.defineProperty(exports, "verifyEmailsExist", { enumerable: true, get: function () { return mx_1.verifyEmailsExist; } });
 // Re-export providers (for advanced usage)
 var providers_1 = require("./providers");
 Object.defineProperty(exports, "createConstructProvider", { enumerable: true, get: function () { return providers_1.createConstructProvider; } });
 Object.defineProperty(exports, "createLddProvider", { enumerable: true, get: function () { return providers_1.createLddProvider; } });
 Object.defineProperty(exports, "createSmartProspectProvider", { enumerable: true, get: function () { return providers_1.createSmartProspectProvider; } });
 Object.defineProperty(exports, "createHunterProvider", { enumerable: true, get: function () { return providers_1.createHunterProvider; } });
-Object.defineProperty(exports, "createApolloProvider", { enumerable: true, get: function () { return providers_1.createApolloProvider; } });
 Object.defineProperty(exports, "createDropcontactProvider", { enumerable: true, get: function () { return providers_1.createDropcontactProvider; } });
 Object.defineProperty(exports, "createBouncerProvider", { enumerable: true, get: function () { return providers_1.createBouncerProvider; } });
 Object.defineProperty(exports, "createSnovioProvider", { enumerable: true, get: function () { return providers_1.createSnovioProvider; } });

package/dist/enrichment/matching.d.ts

@@ -258,7 +258,7 @@ export declare function createLinkedInEnricher(smartProspectConfig: SmartProspec
 /**
  * Email source - where the email was found
  */
-export type EmailSource = 'ldd' | 'smartprospect' | 'linkedin' | 'pattern' | 'hunter' | 'apollo';
+export type EmailSource = 'ldd' | 'smartprospect' | 'linkedin' | 'pattern' | 'hunter' | 'bouncer' | 'snovio';
 /**
  * Email result from unified lookup
  */
@@ -319,10 +319,15 @@ export interface GetEmailsConfig {
     hunter?: {
         apiKey: string;
     };
-    /** Apollo configuration (PAID - last resort) */
-    apollo?: {
+    /** Bouncer configuration (PAID - SMTP verification) */
+    bouncer?: {
         apiKey: string;
     };
+    /** Snov.io configuration (PAID - email finder) */
+    snovio?: {
+        userId: string;
+        apiSecret: string;
+    };
 }
 /**
  * Options for unified email lookup

package/dist/enrichment/matching.js

@@ -863,15 +863,16 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
         ? Math.max(...result.emails.map(e => e.confidence))
         : 0;
     // ==========================================================================
-    // Phase 3: PAID providers as last resort (Hunter/Apollo)
+    // Phase 3: PAID providers as last resort (Hunter/Bouncer/Snovio)
     // ==========================================================================
     if (!skipPaidProviders && finalBestConfidence < paidProviderThreshold) {
         // Only use paid providers if we have low confidence or no results
-        // TODO: Implement Hunter and Apollo providers when needed
+        // TODO: Implement Hunter, Bouncer, Snovio providers when needed
         // For now, just mark that we would have queried them
-        if (config.hunter?.apiKey || config.apollo?.apiKey) {
+        if (config.hunter?.apiKey || config.bouncer?.apiKey || config.snovio?.userId) {
             // result.providersQueried.push('hunter');
-            // result.providersQueried.push('apollo');
+            // result.providersQueried.push('bouncer');
+            // result.providersQueried.push('snovio');
             // await queryPaidProviders(contact, config, addEmail, result);
         }
     }
@@ -882,7 +883,8 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
         linkedin: 2, // LinkedIn company lookup (for domain discovery, doesn't provide emails)
         pattern: 3,
         hunter: 4,
-        apollo: 5,
+        bouncer: 5,
+        snovio: 6,
     };
     result.emails.sort((a, b) => {
         if (b.confidence !== a.confidence) {

package/dist/enrichment/orchestrator.js

@@ -17,18 +17,19 @@ const validation_1 = require("./utils/validation");
  * Default provider costs in USD per lookup
  *
  * Costs based on 2025 pricing:
- * - Bouncer: $0.006/email at scale (best accuracy 99%+)
- * - Snov.io: $0.02/email (email finding + verification)
- * - Hunter: $0.005/email
- * - SmartProspect: $0.01/email
- * - Dropcontact: $0.01/email
+ * - ldd: FREE (subscription-based)
+ * - smartprospect: FREE (included in SmartLead subscription)
+ * - construct: FREE (pattern guessing + MX check)
+ * - bouncer: $0.006/email (SMTP verification, 99%+ accuracy)
+ * - snovio: $0.02/email (email finding + verification)
+ * - hunter: $0.005/email
+ * - dropcontact: $0.01/email (not in default order)
  */
 const _PROVIDER_COSTS = {
     construct: 0,
     ldd: 0,
-    smartprospect: 0.01,
+    smartprospect: 0,
     hunter: 0.005,
-    apollo: 0,
     dropcontact: 0.01,
     bouncer: 0.006,
     snovio: 0.02,
@@ -235,11 +236,25 @@ async function enrichBatch(candidates, options) {
     const delayMs = options.delayMs ?? 200;
     for (let i = 0; i < candidates.length; i += batchSize) {
         const chunk = candidates.slice(i, i + batchSize);
-        // Process batch in parallel
-        const batchResults = await Promise.all(chunk.map((candidate) => enrichBusinessEmail(candidate, options)));
-        // Combine results with candidates
+        // Process batch in parallel (use allSettled for resilience)
+        const batchResults = await Promise.allSettled(chunk.map((candidate) => enrichBusinessEmail(candidate, options)));
+        // Combine results with candidates (handle both fulfilled and rejected)
         batchResults.forEach((result, idx) => {
-            results.push({ candidate: chunk[idx], ...result });
+            const candidate = chunk[idx];
+            if (result.status === 'fulfilled') {
+                results.push({ candidate, ...result.value });
+            }
+            else {
+                // On error, return empty result for this candidate
+                results.push({
+                    candidate,
+                    business_email: null,
+                    business_email_source: null,
+                    business_email_verified: false,
+                    last_checked_at: new Date().toISOString(),
+                    status: `error: ${result.reason instanceof Error ? result.reason.message : 'unknown'}`,
+                });
+            }
         });
         // Delay between batches to avoid rate limiting
         if (i + batchSize < candidates.length && delayMs > 0) {
@@ -432,9 +447,24 @@ async function enrichAllBatch(candidates, options) {
     const delayMs = options.delayMs ?? 200;
     for (let i = 0; i < candidates.length; i += batchSize) {
         const chunk = candidates.slice(i, i + batchSize);
-        // Process batch in parallel
-        const batchResults = await Promise.all(chunk.map((candidate) => enrichAllEmails(candidate, options)));
-        results.push(...batchResults);
+        // Process batch in parallel (use allSettled for resilience)
+        const batchResults = await Promise.allSettled(chunk.map((candidate) => enrichAllEmails(candidate, options)));
+        // Handle both fulfilled and rejected results
+        batchResults.forEach((result, idx) => {
+            if (result.status === 'fulfilled') {
+                results.push(result.value);
+            }
+            else {
+                // On error, return empty result for this candidate
+                results.push({
+                    emails: [],
+                    candidate: chunk[idx],
+                    totalCost: 0,
+                    providersQueried: [],
+                    completedAt: new Date().toISOString(),
+                });
+            }
+        });
         // Delay between batches to avoid rate limiting
         if (i + batchSize < candidates.length && delayMs > 0) {
             await new Promise((r) => setTimeout(r, delayMs));

package/dist/enrichment/providers/construct.js

@@ -87,6 +87,7 @@ function extractDomain(candidate) {
 function createConstructProvider(config) {
     const maxAttempts = config?.maxAttempts ?? 8;
     const timeoutMs = config?.timeoutMs ?? 5000;
+    const smtpVerifyDelayMs = config?.smtpVerifyDelayMs ?? 2000; // Delay between SMTP checks
     async function fetchEmail(candidate) {
         const { first, last } = extractNames(candidate);
         const domain = extractDomain(candidate);
@@ -100,22 +101,79 @@ function createConstructProvider(config) {
         }
         const candidates = buildCandidates({ first, last, domain });
         const max = Math.min(candidates.length, maxAttempts);
+        // First, check if domain is catch-all
+        const catchAllResult = await (0, mx_1.checkDomainCatchAll)(domain, { timeoutMs: 10000 });
+        const isCatchAll = catchAllResult.isCatchAll;
         // Collect ALL valid email patterns (not just first match)
         const validEmails = [];
-        for (let i = 0; i < max; i++) {
-            const email = candidates[i];
-            const verification = await (0, mx_1.verifyEmailMx)(email, { timeoutMs });
-            if (verification.valid === true && verification.confidence >= 50) {
-                validEmails.push({
-                    email,
-                    verified: true,
-                    confidence: verification.confidence,
-                    isCatchAll: verification.isCatchAll,
-                    metadata: {
-                        pattern: email.split('@')[0], // The local part pattern used
-                        mxRecords: verification.mxRecords,
-                    },
-                });
+        // Track all attempted patterns for debugging
+        const attemptedPatterns = [];
+        // If NOT catch-all, we can verify each email via SMTP
+        if (isCatchAll === false) {
+            // Verify emails one by one, stop when we find a valid one
+            const emailsToVerify = candidates.slice(0, max);
+            for (let i = 0; i < emailsToVerify.length; i++) {
+                const email = emailsToVerify[i];
+                // If we already found a valid email, skip the rest
+                if (validEmails.length > 0) {
+                    attemptedPatterns.push({ email, status: 'skipped' });
+                    continue;
+                }
+                // Add delay between checks (except first one)
+                if (i > 0) {
+                    await new Promise((resolve) => setTimeout(resolve, smtpVerifyDelayMs));
+                }
+                // Verify single email
+                const results = await (0, mx_1.verifyEmailsExist)([email], { delayMs: 0, timeoutMs });
+                const result = results[0];
+                if (result.exists === true) {
+                    // Email confirmed to exist!
+                    attemptedPatterns.push({ email, status: 'exists' });
+                    validEmails.push({
+                        email: result.email,
+                        verified: true,
+                        confidence: 95, // High confidence - SMTP verified
+                        isCatchAll: false,
+                        metadata: {
+                            pattern: result.email.split('@')[0],
+                            mxRecords: catchAllResult.mxRecords,
+                            smtpVerified: true,
+                            attemptedPatterns, // Include what was tried
+                        },
+                    });
+                    // Found one! Stop checking more
+                    break;
+                }
+                else if (result.exists === false) {
+                    attemptedPatterns.push({ email, status: 'not_found' });
+                }
+                else {
+                    attemptedPatterns.push({ email, status: 'unknown' });
+                }
+            }
+            // If no valid email found, include attempted patterns in metadata
+            if (validEmails.length === 0 && attemptedPatterns.length > 0) {
+                // Return null but could add metadata about attempts
+            }
+        }
+        else {
+            // Catch-all or unknown - fall back to MX verification only
+            for (let i = 0; i < max; i++) {
+                const email = candidates[i];
+                const verification = await (0, mx_1.verifyEmailMx)(email, { timeoutMs });
+                if (verification.valid === true && verification.confidence >= 50) {
+                    validEmails.push({
+                        email,
+                        verified: true,
+                        confidence: verification.confidence,
+                        isCatchAll: isCatchAll ?? undefined,
+                        metadata: {
+                            pattern: email.split('@')[0],
+                            mxRecords: verification.mxRecords,
+                            smtpVerified: false,
+                        },
+                    });
+                }
             }
         }
         if (validEmails.length === 0) {

package/dist/enrichment/providers/hunter.js

@@ -7,62 +7,8 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createHunterProvider = createHunterProvider;
+const http_retry_1 = require("../utils/http-retry");
 const API_BASE = "https://api.hunter.io/v2";
-/**
- * Delay helper for retry logic
- */
-async function delay(ms) {
-    return new Promise((r) => setTimeout(r, ms));
-}
-/**
- * Check if value is truthy
- */
-function truthy(v) {
-    return v !== undefined && v !== null && String(v).length > 0;
-}
-/**
- * Map Hunter verification status to boolean
- */
-function mapVerified(status) {
-    if (!status)
-        return undefined;
-    const s = String(status).toLowerCase();
-    if (s === "valid" || s === "deliverable")
-        return true;
-    if (s === "invalid" || s === "undeliverable")
-        return false;
-    return undefined; // catch-all/unknown/webmail -> leave undefined
-}
-/**
- * HTTP request with retry on 429 rate limit
- */
-async function requestWithRetry(url, retries = 1, backoffMs = 200) {
-    let lastErr;
-    for (let i = 0; i <= retries; i++) {
-        try {
-            const res = await fetch(url);
-            // Retry on rate limit
-            if (res?.status === 429 && i < retries) {
-                await delay(backoffMs * Math.pow(2, i));
-                continue;
-            }
-            if (!res || res.status >= 400) {
-                lastErr = new Error(`hunter_http_${res?.status ?? "error"}`);
-                break;
-            }
-            const json = (await res.json());
-            return json;
-        }
-        catch (err) {
-            lastErr = err;
-            if (i < retries) {
-                await delay(backoffMs * Math.pow(2, i));
-                continue;
-            }
-        }
-    }
-    throw lastErr ?? new Error("hunter_http_error");
-}
 /**
  * Extract name and domain from candidate
  */
@@ -99,7 +45,7 @@ function createHunterProvider(config) {
         let url = null;
         let isEmailFinder = false;
         // Use email-finder if we have name components
-        if (truthy(first) && truthy(last) && truthy(domain)) {
+        if ((0, http_retry_1.truthy)(first) && (0, http_retry_1.truthy)(last) && (0, http_retry_1.truthy)(domain)) {
             const qs = new URLSearchParams({
                 api_key: String(apiKey),
                 domain: String(domain),
@@ -110,7 +56,7 @@ function createHunterProvider(config) {
             isEmailFinder = true;
         }
         // Fall back to domain-search if only domain available (can return multiple)
-        else if (truthy(domain)) {
+        else if ((0, http_retry_1.truthy)(domain)) {
             const qs = new URLSearchParams({
                 api_key: String(apiKey),
                 domain: String(domain),
@@ -122,7 +68,7 @@ function createHunterProvider(config) {
             return null; // Can't search without domain
         }
         try {
-            const json = await requestWithRetry(url, 1, 100);
+            const json = await (0, http_retry_1.getWithRetry)(url, undefined, { retries: 1, backoffMs: 100 });
             // Parse email-finder response shape (single result)
             if (isEmailFinder) {
                 const ef = (json && (json.data || json.result));
@@ -131,7 +77,7 @@ function createHunterProvider(config) {
                     const score = typeof ef.score === "number"
                         ? ef.score
                         : Number(ef.score ?? 0) || undefined;
-                    const verified = mapVerified(ef?.verification?.status ?? ef?.status);
+                    const verified = (0, http_retry_1.mapVerifiedStatus)(ef?.verification?.status ?? ef?.status);
                     if (!email)
                         return null;
                     return { email, verified, score };
@@ -158,7 +104,7 @@ function createHunterProvider(config) {
                     const score = typeof hit?.confidence === "number"
                         ? hit.confidence
                         : Number(hit?.confidence ?? 0) || 50;
-                    const verified = mapVerified(hit?.verification?.status ?? hit?.status);
+                    const verified = (0, http_retry_1.mapVerifiedStatus)(hit?.verification?.status ?? hit?.status);
                     emails.push({
                         email,
                         verified,

package/dist/enrichment/providers/index.d.ts

@@ -5,7 +5,6 @@ export { createConstructProvider } from './construct';
 export { createLddProvider } from './ldd';
 export { createSmartProspectProvider } from './smartprospect';
 export { createHunterProvider } from './hunter';
-export { createApolloProvider } from './apollo';
 export { createDropcontactProvider } from './dropcontact';
 export { createBouncerProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch } from './bouncer';
 export { createSnovioProvider, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache } from './snovio';