linkedin-secret-sauce 0.12.3 → 0.12.5

package/README.md

@@ -4,7 +4,7 @@ A complete LinkedIn Sales Navigator client + Email Enrichment library for Node.j
 
 **Two main modules:**
 1. **LinkedIn API** - Sales Navigator search, profiles, companies with automatic cookie/account rotation
-2. **Email Enrichment** - Find business emails via multiple providers (11 providers including Hunter, Bouncer, TryKitt.ai, BounceBan, Snov.io, etc.)
+2. **Email Enrichment** - Find business emails via multiple providers (Hunter, TryKitt.ai, BounceBan, Snov.io, etc.)
 
 ## Documentation
 
@@ -250,9 +250,7 @@ Find and verify business emails using multiple providers with waterfall/parallel
 | **TryKitt.ai** | AI Finder | FREE** | AI-powered email finding with catch-all verification |
 | **Construct** | Pattern + MX | FREE | Pattern guessing with MX verification |
 | **BounceBan** | Verification | FREE/$0.003 | Catch-all specialist (85-95% accuracy) |
-| **Bouncer** | SMTP Verify | $0.006/email | Catch-all detection, 99%+ accuracy |
-| **Hunter** | Email Finder | $0.005/email | Domain search, email finder |
-| **Dropcontact** | Email Finder | $0.01/email | Email finding API |
+| **Hunter** | Email Finder | $0.015/email | Domain search, email finder |
 | **Snov.io** | Email Finder | $0.02/email | Finding emails by name+domain |
 
 *SmartProspect is FREE if you have a SmartLead subscription  
@@ -274,7 +272,7 @@ PHASE 2 - Pattern + Verification (if Phase 1 < 80% confidence):
 └── BounceBan    → Catch-all verification (FREE single)
 
 PHASE 3 - Paid Finders (only if Phase 2 inconclusive):
-├── Hunter       → $0.005/email
+├── Hunter       → $0.015/email
 └── Snov.io      → $0.02/email
 ```
 
@@ -335,12 +333,11 @@ const enrichment = createEnrichmentClient({
     },
     
     // PAID providers - only used if FREE providers don't find email
-    bouncer: { apiKey: process.env.BOUNCER_API_KEY },
+    hunter: { apiKey: process.env.HUNTER_API_KEY },
     snovio: { 
       clientId: process.env.SNOVIO_CLIENT_ID,
       clientSecret: process.env.SNOVIO_CLIENT_SECRET 
     },
-    hunter: { apiKey: process.env.HUNTER_API_KEY },
   },
   
   // Optional: cost tracking callback
@@ -495,40 +492,6 @@ batchResults.forEach((result, email) => {
 });
 ```
 
-### Email Verification with Bouncer
-
-```typescript
-import { 
-  verifyEmailWithBouncer,
-  checkCatchAllDomain,
-  verifyEmailsBatch 
-} from 'linkedin-secret-sauce';
-
-// Verify a single email
-const verification = await verifyEmailWithBouncer(
-  'john@example.com',
-  { apiKey: process.env.BOUNCER_API_KEY }
-);
-
-console.log(verification.status);    // 'deliverable' | 'undeliverable' | 'risky'
-console.log(verification.reason);    // 'accepted_email' | 'rejected_email' | etc
-console.log(verification.acceptAll); // true = catch-all domain (can't verify)
-console.log(verification.disposable); // Is this a temp email?
-console.log(verification.role);      // Is this info@, support@, etc?
-
-// Check if domain is catch-all (accepts any email)
-const isCatchAll = await checkCatchAllDomain('example.com', config);
-if (isCatchAll) {
-  console.log('Cannot verify emails - domain accepts everything');
-}
-
-// Batch verify (with concurrency control)
-const results = await verifyEmailsBatch(
-  ['john@example.com', 'jane@example.com'],
-  { apiKey: process.env.BOUNCER_API_KEY }
-);
-```
-
 ### Email Finding with Snov.io
 
 ```typescript
@@ -598,8 +561,7 @@ const enrichment = createEnrichmentClient({
       'trykitt',      // FREE - AI finder
       'construct',    // FREE - pattern matching
       'bounceban',    // FREE single / $0.003 bulk
-      'hunter',       // $0.005
-      'bouncer',      // $0.006 (verification only)
+      'hunter',       // $0.015
       'snovio',       // $0.02
     ],
     
@@ -671,8 +633,6 @@ const result = await getEmailsForLinkedInContact(
       apiKey: process.env.BOUNCEBAN_API_KEY,
       useDeepVerify: true,
     },
-    // Bouncer for final verification
-    bouncer: { apiKey: process.env.BOUNCER_API_KEY },
   }
 );
 
@@ -716,7 +676,6 @@ const enrichment = createEnrichmentClient({
     trykitt: { apiKey: process.env.TRYKITT_API_KEY },
     bounceban: { apiKey: process.env.BOUNCEBAN_API_KEY, useDeepVerify: true },
     hunter: { apiKey: process.env.HUNTER_API_KEY },
-    bouncer: { apiKey: process.env.BOUNCER_API_KEY },
   },
 });
 
@@ -786,9 +745,7 @@ TRYKITT_API_KEY=...          # FREE for individuals
 BOUNCEBAN_API_KEY=...        # FREE single, $0.003 bulk
 
 # Email Enrichment - PAID providers
-HUNTER_API_KEY=...           # $0.005/email
-BOUNCER_API_KEY=...          # $0.006/email
-DROPCONTACT_API_KEY=...      # $0.01/email
+HUNTER_API_KEY=...           # $0.015/email
 SNOVIO_CLIENT_ID=...         # $0.02/email
 SNOVIO_CLIENT_SECRET=...
 ```

package/dist/enrichment/index.d.ts

@@ -12,7 +12,7 @@
  *   providers: {
  *     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 },
+ *     bounceban: { apiKey: process.env.BOUNCEBAN_API_KEY },
  *   },
  *   options: {
  *     maxCostPerEmail: 0.05,
@@ -44,10 +44,8 @@ import { type EnrichmentClientConfig, type EnrichmentClient } from "./types";
  *   - bounceban: BounceBan catch-all verification (FREE single / $0.003 bulk)
  *
  * PHASE 3 - Paid finders (only if Phase 2 inconclusive):
- *   - hunter: Hunter.io ($0.005/email)
+ *   - hunter: Hunter.io ($0.015/email)
  *   - snovio: Snov.io ($0.02/email)
- *
- * Note: bouncer ($0.006) and dropcontact ($0.01) available but not in default order
  */
 /**
  * Create an enrichment client with the given configuration
@@ -62,7 +60,7 @@ export { isPersonalEmail, isBusinessEmail, isPersonalDomain, PERSONAL_DOMAINS, }
 export { isDisposableEmail, isDisposableDomain, DISPOSABLE_DOMAINS, } from "./utils/disposable-domains";
 export { isValidEmailSyntax, isRoleAccount, asciiFold, cleanNamePart, hostnameFromUrl, extractLinkedInUsername, } from "./utils/validation";
 export { verifyEmailMx, checkDomainCatchAll, verifyEmailsExist, } from "./verification/mx";
-export { createConstructProvider, createLddProvider, createSmartProspectProvider, createCosiallProvider, createTryKittProvider, createHunterProvider, createDropcontactProvider, createBouncerProvider, createBounceBanProvider, createSnovioProvider, findEmailWithTryKitt, verifyEmailWithTryKitt, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, verifyEmailWithBounceBan, verifyEmailsBatchWithBounceBan, checkCatchAllWithBounceBan, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache, } from "./providers";
+export { createConstructProvider, createLddProvider, createSmartProspectProvider, createCosiallProvider, createTryKittProvider, createHunterProvider, createBounceBanProvider, createSnovioProvider, findEmailWithTryKitt, verifyEmailWithTryKitt, verifyEmailWithBounceBan, verifyEmailsBatchWithBounceBan, checkCatchAllWithBounceBan, 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

@@ -13,7 +13,7 @@
  *   providers: {
  *     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 },
+ *     bounceban: { apiKey: process.env.BOUNCEBAN_API_KEY },
  *   },
  *   options: {
  *     maxCostPerEmail: 0.05,
@@ -43,8 +43,8 @@ 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.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.checkCatchAllWithBounceBan = exports.verifyEmailsBatchWithBounceBan = exports.verifyEmailWithBounceBan = exports.verifyEmailsBatch = exports.checkCatchAllDomain = exports.verifyEmailWithBouncer = exports.verifyEmailWithTryKitt = exports.findEmailWithTryKitt = exports.createSnovioProvider = exports.createBounceBanProvider = exports.createBouncerProvider = exports.createDropcontactProvider = exports.createHunterProvider = exports.createTryKittProvider = exports.createCosiallProvider = 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 = exports.matchContacts = exports.findBestMatch = exports.classifyMatchQuality = exports.calculateMatchConfidence = exports.clearFileCache = exports.isFileCacheEnabled = exports.disableFileCache = exports.enableFileCache = void 0;
+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.checkCatchAllWithBounceBan = exports.verifyEmailsBatchWithBounceBan = exports.verifyEmailWithBounceBan = exports.verifyEmailWithTryKitt = exports.findEmailWithTryKitt = exports.createSnovioProvider = exports.createBounceBanProvider = exports.createHunterProvider = exports.createTryKittProvider = exports.createCosiallProvider = 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 = exports.matchContacts = exports.findBestMatch = exports.classifyMatchQuality = void 0;
 exports.createEnrichmentClient = createEnrichmentClient;
 const types_1 = require("./types");
 const orchestrator_1 = require("./orchestrator");
@@ -54,8 +54,6 @@ const smartprospect_1 = require("./providers/smartprospect");
 const cosiall_1 = require("./providers/cosiall");
 const trykitt_1 = require("./providers/trykitt");
 const hunter_1 = require("./providers/hunter");
-const dropcontact_1 = require("./providers/dropcontact");
-const bouncer_1 = require("./providers/bouncer");
 const bounceban_1 = require("./providers/bounceban");
 const snovio_1 = require("./providers/snovio");
 /**
@@ -74,10 +72,8 @@ const snovio_1 = require("./providers/snovio");
  *   - bounceban: BounceBan catch-all verification (FREE single / $0.003 bulk)
  *
  * PHASE 3 - Paid finders (only if Phase 2 inconclusive):
- *   - hunter: Hunter.io ($0.005/email)
+ *   - hunter: Hunter.io ($0.015/email)
  *   - snovio: Snov.io ($0.02/email)
- *
- * Note: bouncer ($0.006) and dropcontact ($0.01) available but not in default order
  */
 /**
  * Create an enrichment client with the given configuration
@@ -109,12 +105,6 @@ function createEnrichmentClient(config) {
     if (providerConfigs.hunter) {
         providerFuncs.set("hunter", (0, hunter_1.createHunterProvider)(providerConfigs.hunter));
     }
-    if (providerConfigs.dropcontact) {
-        providerFuncs.set("dropcontact", (0, dropcontact_1.createDropcontactProvider)(providerConfigs.dropcontact));
-    }
-    if (providerConfigs.bouncer) {
-        providerFuncs.set("bouncer", (0, bouncer_1.createBouncerProvider)(providerConfigs.bouncer));
-    }
     if (providerConfigs.snovio) {
         providerFuncs.set("snovio", (0, snovio_1.createSnovioProvider)(providerConfigs.snovio));
     }
@@ -287,17 +277,11 @@ Object.defineProperty(exports, "createSmartProspectProvider", { enumerable: true
 Object.defineProperty(exports, "createCosiallProvider", { enumerable: true, get: function () { return providers_1.createCosiallProvider; } });
 Object.defineProperty(exports, "createTryKittProvider", { enumerable: true, get: function () { return providers_1.createTryKittProvider; } });
 Object.defineProperty(exports, "createHunterProvider", { enumerable: true, get: function () { return providers_1.createHunterProvider; } });
-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, "createBounceBanProvider", { enumerable: true, get: function () { return providers_1.createBounceBanProvider; } });
 Object.defineProperty(exports, "createSnovioProvider", { enumerable: true, get: function () { return providers_1.createSnovioProvider; } });
 // TryKitt utilities
 Object.defineProperty(exports, "findEmailWithTryKitt", { enumerable: true, get: function () { return providers_1.findEmailWithTryKitt; } });
 Object.defineProperty(exports, "verifyEmailWithTryKitt", { enumerable: true, get: function () { return providers_1.verifyEmailWithTryKitt; } });
-// Bouncer utilities
-Object.defineProperty(exports, "verifyEmailWithBouncer", { enumerable: true, get: function () { return providers_1.verifyEmailWithBouncer; } });
-Object.defineProperty(exports, "checkCatchAllDomain", { enumerable: true, get: function () { return providers_1.checkCatchAllDomain; } });
-Object.defineProperty(exports, "verifyEmailsBatch", { enumerable: true, get: function () { return providers_1.verifyEmailsBatch; } });
 // BounceBan utilities
 Object.defineProperty(exports, "verifyEmailWithBounceBan", { enumerable: true, get: function () { return providers_1.verifyEmailWithBounceBan; } });
 Object.defineProperty(exports, "verifyEmailsBatchWithBounceBan", { enumerable: true, get: function () { return providers_1.verifyEmailsBatchWithBounceBan; } });

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" | "cosiall" | "trykitt" | "linkedin" | "pattern" | "hunter" | "bouncer" | "bounceban" | "snovio";
+export type EmailSource = "ldd" | "smartprospect" | "cosiall" | "trykitt" | "linkedin" | "pattern" | "hunter" | "bounceban" | "snovio";
 /**
  * Email result from unified lookup
  */
@@ -327,10 +327,6 @@ export interface GetEmailsConfig {
     hunter?: {
         apiKey: string;
     };
-    /** Bouncer configuration (PAID - SMTP verification) */
-    bouncer?: {
-        apiKey: string;
-    };
     /** BounceBan configuration (FREE single / catch-all specialist) */
     bounceban?: {
         apiKey: string;
@@ -339,8 +335,8 @@ export interface GetEmailsConfig {
     };
     /** Snov.io configuration (PAID - email finder) */
     snovio?: {
-        userId: string;
-        apiSecret: string;
+        clientId: string;
+        clientSecret: string;
     };
 }
 /**
@@ -376,7 +372,7 @@ export interface GetEmailsOptions {
  * Strategy (optimized for FlexIQ):
  * 1. Query LDD + SmartProspect in PARALLEL (both FREE for you)
  * 2. Try email pattern guessing with MX verification (FREE)
- * 3. Only use Hunter/Apollo if confidence is below threshold (PAID - last resort)
+ * 3. Only use Hunter/Snov.io if confidence is below threshold (PAID - last resort)
  *
  * @example
  * ```ts

package/dist/enrichment/matching.js

@@ -738,7 +738,7 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
  * Strategy (optimized for FlexIQ):
  * 1. Query LDD + SmartProspect in PARALLEL (both FREE for you)
  * 2. Try email pattern guessing with MX verification (FREE)
- * 3. Only use Hunter/Apollo if confidence is below threshold (PAID - last resort)
+ * 3. Only use Hunter/Snov.io if confidence is below threshold (PAID - last resort)
  *
  * @example
  * ```ts
@@ -813,12 +813,41 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
      * Merge emails and boost confidence when found from multiple sources
      * - 2 sources: boost to at least 95% confidence
      * - 3+ sources: boost to 100% confidence
+     *
+     * IMPORTANT: When multiple sources find the same email, we pick the
+     * most authoritative source (not just highest confidence), then boost.
+     * Source priority: ldd > smartprospect > cosiall > trykitt > bounceban > hunter > snovio > pattern
      */
     const mergeAndBoostEmails = () => {
         const mergedEmails = [];
+        // Source priority for merging (lower = higher priority)
+        const mergePriority = {
+            ldd: 0, // Highest priority - your own data
+            smartprospect: 1, // Very reliable - verified database
+            cosiall: 2, // LinkedIn profile data
+            trykitt: 3, // AI-powered finder
+            bounceban: 4, // Verification provider
+            hunter: 5, // Paid finder
+            snovio: 6, // Paid finder
+            linkedin: 7, // Company lookup only
+            pattern: 8, // Pattern guessing - lowest priority
+        };
         for (const [_email, { results, sources }] of emailsByAddress) {
-            // Find the best result (highest confidence)
-            const bestResult = results.reduce((best, current) => current.confidence > best.confidence ? current : best);
+            // Find the best result by SOURCE PRIORITY first, then confidence
+            // This ensures SmartProspect/LDD are preferred over pattern guessing
+            const bestResult = results.reduce((best, current) => {
+                const bestPriority = mergePriority[best.source] ?? 99;
+                const currentPriority = mergePriority[current.source] ?? 99;
+                // Pick by source priority first
+                if (currentPriority < bestPriority) {
+                    return current;
+                }
+                if (currentPriority > bestPriority) {
+                    return best;
+                }
+                // Same source priority - pick higher confidence
+                return current.confidence > best.confidence ? current : best;
+            });
             // Boost confidence based on number of sources
             let boostedConfidence = bestResult.confidence;
             if (sources.size >= 3) {
@@ -874,90 +903,110 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
         result.providersQueried.push("cosiall");
         freeProviderPromises.push(queryCosiall(contact, addEmail, result));
     }
-    // TryKitt.ai lookup (FREE for individuals - unlimited)
-    // AI-powered email finder with enterprise identity server catch-all verification
-    if (!skipTryKitt && config.trykitt?.apiKey) {
-        result.providersQueried.push("trykitt");
-        freeProviderPromises.push(queryTryKitt(contact, config.trykitt, linkedInCompanyDomain || discoveredCompanyDomain, addEmail, result));
-    }
+    // TryKitt.ai is moved to Phase 2 (after domain discovery)
+    // It needs name + domain to find emails
     // Wait for all Phase 1 free providers
     await Promise.all(freeProviderPromises);
-    // Merge emails and calculate best confidence after Phase 1
+    // Merge emails after Phase 1
     result.emails = mergeAndBoostEmails();
-    const phase1BestConfidence = result.emails.length > 0
-        ? Math.max(...result.emails.map((e) => e.confidence))
-        : 0;
     // ==========================================================================
-    // Phase 2: Domain Discovery + Pattern Guessing
-    // ONLY if Phase 1 confidence < threshold (to minimize LinkedIn API calls)
+    // Phase 2: Domain Discovery + FREE Email Finding (TryKitt, Pattern Guessing)
+    // FREE providers ALWAYS run - no reason to skip them
     // ==========================================================================
     let companyDomain = linkedInCompanyDomain || discoveredCompanyDomain;
-    // Skip Phase 2 entirely if we already have high confidence emails
-    if (phase1BestConfidence < paidProviderThreshold) {
-        // Try LinkedIn Company Lookup for domain discovery (EXPENSIVE - uses LinkedIn API)
-        // Only if we don't have a domain yet
-        if (!companyDomain &&
-            !skipPatternGuessing &&
-            !options.skipLinkedInCompanyLookup &&
-            config.linkedInCompanyLookup) {
-            const companyUrn = contact.currentPositions?.[0]?.companyUrn;
-            if (companyUrn) {
-                const companyId = extractCompanyIdFromUrn(companyUrn);
-                if (companyId) {
-                    result.providersQueried.push("linkedin");
-                    try {
-                        const company = await config.linkedInCompanyLookup(companyId);
-                        if (company?.websiteUrl) {
-                            companyDomain = extractDomainFromUrl(company.websiteUrl);
-                            if (companyDomain) {
-                                discoveredCompanyDomain = companyDomain;
-                            }
+    // Try LinkedIn Company Lookup for domain discovery
+    // Only if we don't have a domain yet
+    if (!companyDomain &&
+        !skipPatternGuessing &&
+        !options.skipLinkedInCompanyLookup &&
+        config.linkedInCompanyLookup) {
+        const companyUrn = contact.currentPositions?.[0]?.companyUrn;
+        if (companyUrn) {
+            const companyId = extractCompanyIdFromUrn(companyUrn);
+            if (companyId) {
+                result.providersQueried.push("linkedin");
+                try {
+                    const company = await config.linkedInCompanyLookup(companyId);
+                    if (company?.websiteUrl) {
+                        companyDomain = extractDomainFromUrl(company.websiteUrl);
+                        if (companyDomain) {
+                            discoveredCompanyDomain = companyDomain;
                         }
                     }
-                    catch (err) {
-                        result.errors?.push(`LinkedIn: ${err instanceof Error ? err.message : "Company lookup failed"}`);
-                    }
+                }
+                catch (err) {
+                    result.errors?.push(`LinkedIn: ${err instanceof Error ? err.message : "Company lookup failed"}`);
                 }
             }
         }
-        // Store discovered domain in result for visibility
-        if (discoveredCompanyDomain && !linkedInCompanyDomain) {
-            result.discoveredCompanyDomain = discoveredCompanyDomain;
-        }
-        // Run pattern guessing if we have a domain (from LinkedIn contact, SmartProspect, or LinkedIn API)
-        if (!skipPatternGuessing && companyDomain) {
-            result.providersQueried.push("pattern");
-            await queryPatternGuessing(contact, companyDomain, addEmail, result);
-            // Re-merge after pattern guessing
+    }
+    // Store discovered domain in result for visibility
+    if (discoveredCompanyDomain && !linkedInCompanyDomain) {
+        result.discoveredCompanyDomain = discoveredCompanyDomain;
+    }
+    // TryKitt.ai lookup (FREE for individuals - unlimited)
+    // AI-powered email finder - runs after domain discovery
+    if (!skipTryKitt && config.trykitt?.apiKey && companyDomain) {
+        result.providersQueried.push("trykitt");
+        await queryTryKitt(contact, config.trykitt, companyDomain, addEmail, result);
+        // Re-merge after TryKitt
+        result.emails = mergeAndBoostEmails();
+    }
+    // Run pattern guessing if we have a domain (from LinkedIn contact, SmartProspect, or LinkedIn API)
+    if (!skipPatternGuessing && companyDomain) {
+        result.providersQueried.push("pattern");
+        await queryPatternGuessing(contact, companyDomain, addEmail, result);
+        // Re-merge after pattern guessing
+        result.emails = mergeAndBoostEmails();
+    }
+    // ==========================================================================
+    // Check if we already have a verified BUSINESS email from a trusted source
+    // If so, skip BounceBan and paid providers entirely
+    //
+    // NOTE: LDD and Cosiall can return personal emails (Gmail, Yahoo, etc.)
+    // Don't stop searching if we only have personal emails - keep looking for business.
+    // ==========================================================================
+    const hasVerifiedBusinessEmail = result.emails.some((e) => e.verified &&
+        e.type === "business" &&
+        (e.source === "smartprospect" ||
+            e.source === "ldd" ||
+            e.source === "cosiall" ||
+            e.source === "trykitt"));
+    const phase2BestConfidence = result.emails.length > 0
+        ? Math.max(...result.emails.map((e) => e.confidence))
+        : 0;
+    // BounceBan catch-all verification (costs $0.008/lookup)
+    // SKIP if we already have a verified BUSINESS email from SmartProspect/Cosiall/TryKitt
+    // Only run to verify pattern-guessed emails when no trusted source found a business email
+    // NOTE: LDD personal emails don't count - we still want to find the business email
+    if (!skipBounceBan &&
+        config.bounceban?.apiKey &&
+        result.emails.length > 0 &&
+        !hasVerifiedBusinessEmail && // Skip if we have a verified BUSINESS email
+        phase2BestConfidence < paidProviderThreshold) {
+        // Only verify pattern-guessed emails (the ones we're uncertain about)
+        const emailsToVerify = result.emails.filter((e) => e.source === "pattern" && !e.verified);
+        if (emailsToVerify.length > 0) {
+            result.providersQueried.push("bounceban");
+            await queryBounceBan(emailsToVerify, config.bounceban, addEmail, result);
+            // Re-merge after BounceBan verification
             result.emails = mergeAndBoostEmails();
         }
-        // BounceBan catch-all verification (FREE single emails)
-        // Use BounceBan to verify pattern-guessed emails, especially on catch-all domains
-        if (!skipBounceBan &&
-            config.bounceban?.apiKey &&
-            result.emails.length > 0) {
-            // Only verify emails that are from pattern guessing or have low confidence
-            const emailsToVerify = result.emails
-                .filter((e) => e.source === "pattern" || (e.confidence < 80 && !e.verified))
-                .slice(0, 3); // Verify top 3 to save credits
-            if (emailsToVerify.length > 0) {
-                result.providersQueried.push("bounceban");
-                await queryBounceBan(emailsToVerify, config.bounceban, addEmail, result);
-                // Re-merge after BounceBan verification
-                result.emails = mergeAndBoostEmails();
-            }
-        }
     }
     // Calculate final best confidence
     const finalBestConfidence = result.emails.length > 0
         ? Math.max(...result.emails.map((e) => e.confidence))
         : 0;
     // ==========================================================================
-    // Phase 3: PAID providers as last resort (Hunter/Bouncer/Snovio)
+    // Phase 3: PAID providers as LAST RESORT (Hunter then Snovio)
+    // SKIP if we already have a verified BUSINESS email
+    // NOTE: LDD personal emails don't count - we still want to find the business email
     // ==========================================================================
-    if (!skipPaidProviders && finalBestConfidence < paidProviderThreshold) {
-        // Only use paid providers if we have low confidence or no results
-        // Hunter.io - Email Finder ($0.005/lookup)
+    const hasAnyVerifiedBusinessEmail = result.emails.some((e) => e.verified && e.type === "business");
+    if (!skipPaidProviders &&
+        !hasAnyVerifiedBusinessEmail && // Skip if we have a verified BUSINESS email
+        finalBestConfidence < paidProviderThreshold) {
+        // Hunter.io - Email Finder ($0.005/lookup) - try first
         if (config.hunter?.apiKey) {
             result.providersQueried.push("hunter");
             // Extract linkedin handle from contact if available
@@ -980,8 +1029,15 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
             // Re-merge after Hunter
             result.emails = mergeAndBoostEmails();
         }
-        // Snovio - Email Finder ($0.02/lookup) - best for catch-all domains
-        if (config.snovio?.userId && config.snovio?.apiSecret && companyDomain) {
+        // Check if Hunter found a verified email - if so, skip Snovio
+        const hunterFoundVerified = result.emails.some((e) => e.source === "hunter" && e.verified);
+        // Snovio - Email Finder ($0.02/lookup) - ONLY if Hunter didn't find anything
+        // This is the absolute last resort since it's the most expensive
+        if (config.snovio?.clientId &&
+            config.snovio?.clientSecret &&
+            companyDomain &&
+            !hunterFoundVerified // Skip if Hunter already found a verified email
+        ) {
             result.providersQueried.push("snovio");
             await querySnovio(contact, config.snovio, companyDomain, addEmail, result);
             // Re-merge after Snovio
@@ -1004,8 +1060,7 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
         pattern: 5,
         bounceban: 6, // BounceBan catch-all verification (FREE single)
         hunter: 7,
-        bouncer: 8,
-        snovio: 9,
+        snovio: 8,
     };
     result.emails.sort((a, b) => {
         if (b.confidence !== a.confidence) {
@@ -1216,20 +1271,26 @@ async function queryBounceBan(emailsToVerify, bouncebanConfig, addEmail, result)
                 useWaterfall: bouncebanConfig.useWaterfall ?? true,
             });
             if (verification && verification.status === "success") {
-                // Map BounceBan result to confidence
-                let confidence = verification.score;
+                // BounceBan specializes in catch-all verification with 97%+ accuracy
+                // Trust the score they return - don't artificially cap it
+                const confidence = verification.score;
                 const verified = verification.result === "deliverable";
-                // Reduce confidence for catch-all domains even if deliverable
-                if (verification.is_accept_all && verified) {
-                    confidence = Math.min(confidence, 75);
-                }
+                // For catch-all domains:
+                // - "deliverable" = BounceBan's algorithm determined this specific email exists (97%+ accuracy)
+                // - "risky" = Could not determine with high confidence
+                // - "undeliverable" = Email definitely doesn't exist
                 // Only add if it's potentially deliverable
                 if (verification.result === "deliverable" ||
                     verification.result === "risky") {
+                    // For "deliverable" on catch-all, BounceBan has verified this is the REAL email
+                    // For "risky", we keep lower confidence as BounceBan couldn't determine
+                    const finalConfidence = verification.result === "deliverable"
+                        ? Math.max(confidence, 85) // Deliverable = high confidence (BounceBan verified it)
+                        : Math.min(confidence, 60); // Risky = lower confidence
                     addEmail({
                         email: verification.email,
                         source: "bounceban",
-                        confidence,
+                        confidence: finalConfidence,
                         type: "business",
                         verified,
                         isCatchAll: verification.is_accept_all,
@@ -1308,20 +1369,39 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
                 .split("/")[0]
                 .toLowerCase();
         }
-        // Fetch email for matched contact
-        const fetchResponse = await client.fetch([
-            matchResult.smartProspectContact.id,
-        ]);
+        // Fetch email for matched contact (pass filter_id from search for polling)
+        const searchFilterId = searchResponse.data.filter_id;
+        const fetchResponse = await client.fetch([matchResult.smartProspectContact.id], searchFilterId);
         if (fetchResponse.success && fetchResponse.data.list.length > 0) {
             const enrichedContact = fetchResponse.data.list[0];
             if (enrichedContact.email) {
+                // Calculate email confidence based on verification status AND match quality
+                // SmartProspect verification status: "valid", "catch_all", "invalid", etc.
+                const isVerified = enrichedContact.verificationStatus === "valid" ||
+                    enrichedContact.verificationStatus === "verified";
+                const isCatchAll = enrichedContact.verificationStatus === "catch_all";
+                // Base confidence from match quality (60-100%)
+                let emailConfidence = matchResult.confidence;
+                // Boost confidence for verified emails from SmartProspect
+                // A verified email from SmartProspect is more reliable than pattern guessing
+                if (isVerified) {
+                    emailConfidence = Math.max(emailConfidence, 90); // Verified = at least 90%
+                }
+                else if (isCatchAll) {
+                    emailConfidence = Math.max(emailConfidence, 80); // Catch-all = at least 80%
+                }
+                else if (enrichedContact.emailDeliverability > 0) {
+                    // Use deliverability score if available
+                    emailConfidence = Math.max(emailConfidence, enrichedContact.emailDeliverability * 100);
+                }
                 addEmail({
                     email: enrichedContact.email,
                     source: "smartprospect",
-                    confidence: matchResult.confidence,
+                    confidence: emailConfidence,
                     type: "business",
-                    verified: enrichedContact.verificationStatus === "verified",
+                    verified: isVerified || isCatchAll,
                     deliverability: enrichedContact.emailDeliverability,
+                    isCatchAll,
                     metadata: {
                         matchQuality: matchResult.quality,
                         matchedFields: matchResult.matchedFields,
@@ -1329,6 +1409,7 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
                         company: enrichedContact.company?.name,
                         companyWebsite: companyWebsite,
                         title: enrichedContact.title,
+                        verificationStatus: enrichedContact.verificationStatus,
                     },
                 });
             }

package/dist/enrichment/orchestrator.d.ts

@@ -4,7 +4,7 @@
  * Runs providers in sequence until a verified email is found that meets
  * the confidence threshold. Supports budget tracking and cost callbacks.
  */
-import type { CanonicalEmail, EnrichmentCandidate, ProviderFunc, BatchEnrichmentOptions, CostCallback, EnrichmentLogger, MultiEmailResult } from './types';
+import type { CanonicalEmail, EnrichmentCandidate, ProviderFunc, BatchEnrichmentOptions, CostCallback, EnrichmentLogger, MultiEmailResult } from "./types";
 export interface OrchestratorOptions {
     /** Provider functions in order */
     providers: ProviderFunc[];