linkedin-secret-sauce 0.12.2 → 0.12.4

package/README.md

@@ -4,11 +4,12 @@ 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 (Hunter, Apollo, Bouncer, Snov.io, etc.)
+2. **Email Enrichment** - Find business emails via multiple providers (Hunter, TryKitt.ai, BounceBan, Snov.io, etc.)
 
 ## Documentation
 
 - [Integration Guide](docs/INTEGRATION.md) - Step-by-step setup
+- [Email Enrichment Guide](docs/ENRICHMENT.md) - All 11 providers, API keys, costs
 - [Sales Search Guide](docs/SALES_SEARCH.md) - Advanced search filters
 - [Playground Guide](docs/PLAYGROUND.md) - Local dev UI
 - [Cosiall Profile Emails](docs/COSIALL_PROFILE_EMAILS.md) - Profile email lookups
@@ -79,6 +80,50 @@ console.log(company.name, company.industry, company.employeeCount);
 | `LINKEDIN_PROXY_STRING` | No | Proxy in format `host:port` or `host:port:user:pass` |
 | `LOG_LEVEL` | No | `debug`, `info`, `warn`, `error` (default: `info`) |
 
+### Advanced Configuration
+
+```typescript
+initializeLinkedInClient({
+  // Required
+  cosiallApiUrl: process.env.COSIALL_API_URL!,
+  cosiallApiKey: process.env.COSIALL_API_KEY!,
+
+  // Optional networking
+  proxyString: process.env.LINKEDIN_PROXY_STRING,
+  logLevel: 'info',
+
+  // Cache TTLs (milliseconds)
+  profileCacheTtl: 15 * 60 * 1000,    // 15 minutes (default)
+  searchCacheTtl: 15 * 60 * 1000,     // 15 minutes (default)
+  companyCacheTtl: 10 * 60 * 1000,    // 10 minutes (default)
+  typeaheadCacheTtl: 60 * 60 * 1000,  // 1 hour (default)
+
+  // Cookie pool & rotation
+  cookieRefreshInterval: 15 * 60 * 1000,  // 15 minutes (default)
+  accountCooldownMs: 5000,                 // 5 seconds (default)
+  maxFailuresBeforeCooldown: 3,            // default
+
+  // Retry behavior
+  maxRetries: 2,           // default
+  retryDelayMs: 700,       // default
+
+  // Request tracking
+  maxRequestHistory: 500,  // default
+
+  // Initialization options
+  eagerInitialization: true,  // Load cookies immediately (default)
+  fallbackWithoutProxyOnError: false,  // Retry without proxy on 502/503/504
+
+  // Error handling
+  onInitializationError: (error) => {
+    console.error('Failed to initialize:', error);
+  },
+
+  // Sentry integration (optional)
+  sentryClient: Sentry,
+});
+```
+
 ### API Reference
 
 #### Profiles
@@ -195,19 +240,41 @@ accounts.forEach(acc => {
 
 Find and verify business emails using multiple providers with waterfall/parallel strategies.
 
-### Supported Providers
+### Supported Providers (11 Total)
 
 | Provider | Type | Cost | Best For |
 |----------|------|------|----------|
 | **LDD** | Database | FREE | LinkedIn profile emails (~500M profiles) |
 | **SmartProspect** | Database | FREE* | SmartLead's prospect database |
 | **Cosiall** | Profile Lookup | FREE | Emails from LinkedIn profiles |
+| **TryKitt.ai** | AI Finder | FREE** | AI-powered email finding with catch-all verification |
 | **Construct** | Pattern + MX | FREE | Pattern guessing with MX verification |
-| **Bouncer** | SMTP Verify | $0.006/email | Catch-all detection, 99%+ accuracy |
+| **BounceBan** | Verification | FREE/$0.003 | Catch-all specialist (85-95% accuracy) |
+| **Hunter** | Email Finder | $0.015/email | Domain search, email finder |
 | **Snov.io** | Email Finder | $0.02/email | Finding emails by name+domain |
-| **Hunter** | Email Finder | $0.005/email | Domain search, email finder |
 
-*SmartProspect is FREE if you have a SmartLead subscription
+*SmartProspect is FREE if you have a SmartLead subscription  
+**TryKitt.ai is FREE for individuals with unlimited searches
+
+### Default Provider Order (3-Phase Strategy)
+
+The enrichment client uses an optimized 3-phase strategy:
+
+```
+PHASE 1 - Free Lookups (Parallel):
+├── LDD          → Real verified emails from LinkedIn Data Dump
+├── SmartProspect → Real verified emails from SmartLead
+├── Cosiall      → Emails from LinkedIn profiles
+└── TryKitt.ai   → AI-powered email finding
+
+PHASE 2 - Pattern + Verification (if Phase 1 < 80% confidence):
+├── Construct    → Pattern guessing + MX check
+└── BounceBan    → Catch-all verification (FREE single)
+
+PHASE 3 - Paid Finders (only if Phase 2 inconclusive):
+├── Hunter       → $0.015/email
+└── Snov.io      → $0.02/email
+```
 
 ### Cosiall Profile Emails (Standalone)
 
@@ -253,13 +320,24 @@ const enrichment = createEnrichmentClient({
     // cosiall: enabled by default (uses global Cosiall config)
     // construct: enabled by default (pattern guessing)
     
+    // TryKitt.ai - FREE for individuals (AI email finder)
+    trykitt: {
+      apiKey: process.env.TRYKITT_API_KEY,
+    },
+    
+    // BounceBan - FREE single verification, catch-all specialist
+    bounceban: {
+      apiKey: process.env.BOUNCEBAN_API_KEY,
+      useDeepVerify: true,    // +15-25% accuracy for pattern-guessed emails
+      useWaterfall: true,     // Recommended - includes free retries
+    },
+    
     // 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: { 
-      userId: process.env.SNOVIO_USER_ID,
-      apiSecret: process.env.SNOVIO_API_SECRET 
+      clientId: process.env.SNOVIO_CLIENT_ID,
+      clientSecret: process.env.SNOVIO_CLIENT_SECRET 
     },
-    hunter: { apiKey: process.env.HUNTER_API_KEY },
   },
   
   // Optional: cost tracking callback
@@ -319,45 +397,99 @@ result.emails.forEach(email => {
   console.log(email.source);      // 'hunter'
   console.log(email.confidence);  // 95
   console.log(email.verified);    // true
-  console.log(email.type);        // 'business'
+  console.log(email.type);        // 'business' | 'personal' | 'role' | 'disposable'
+  console.log(email.isCatchAll);  // false
 });
 
-console.log(result.totalCost);    // Total $ spent across providers
-console.log(result.providersQueried); // ['construct', 'hunter', 'apollo']
+console.log(result.totalCost);        // Total $ spent across providers
+console.log(result.providersQueried); // ['ldd', 'smartprospect', 'construct', 'hunter']
+
+// Batch version
+const allResults = await enrichment.enrichAllBatch(candidates, {
+  batchSize: 50,
+  delayMs: 200,
+});
 ```
 
-### Email Verification with Bouncer
+### TryKitt.ai Email Finder
+
+AI-powered email finding with enterprise identity server catch-all verification:
 
 ```typescript
 import { 
-  verifyEmailWithBouncer,
-  checkCatchAllDomain,
-  verifyEmailsBatch 
+  findEmailWithTryKitt, 
+  verifyEmailWithTryKitt 
 } from 'linkedin-secret-sauce';
 
-// Verify a single email
-const verification = await verifyEmailWithBouncer(
-  'john@example.com',
-  { apiKey: process.env.BOUNCER_API_KEY }
+// Find email by name + domain
+const result = await findEmailWithTryKitt(
+  'John Doe',
+  'acme.com',
+  { apiKey: process.env.TRYKITT_API_KEY },
+  'https://linkedin.com/in/johndoe' // Optional - improves accuracy
 );
 
-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');
+if (result?.status === 'completed') {
+  console.log(result.result.email);           // john.doe@acme.com
+  console.log(result.result.confidence_score); // 0.95
+  console.log(result.result.is_catchall);      // false
 }
 
-// Batch verify (with concurrency control)
-const results = await verifyEmailsBatch(
+// Verify an existing email
+const verification = await verifyEmailWithTryKitt(
+  'john@acme.com',
+  { apiKey: process.env.TRYKITT_API_KEY }
+);
+
+console.log(verification?.valid);        // true
+console.log(verification?.deliverable);  // true
+console.log(verification?.isCatchAll);   // false
+console.log(verification?.isDisposable); // false
+```
+
+### BounceBan Catch-All Verification
+
+Specializes in catch-all email verification with 85-95% accuracy without sending emails:
+
+```typescript
+import { 
+  verifyEmailWithBounceBan,
+  verifyEmailsBatchWithBounceBan,
+  checkCatchAllWithBounceBan 
+} from 'linkedin-secret-sauce';
+
+// Verify a single email (FREE)
+const result = await verifyEmailWithBounceBan(
+  'john@catchall-domain.com',
+  { 
+    apiKey: process.env.BOUNCEBAN_API_KEY,
+    useDeepVerify: true,   // Better for pattern-guessed emails
+    useWaterfall: true,    // Recommended - includes 30-min free retry window
+  }
+);
+
+console.log(result.result);        // 'deliverable' | 'risky' | 'undeliverable' | 'unknown'
+console.log(result.score);         // 0-100
+console.log(result.is_accept_all); // true (catch-all domain)
+console.log(result.is_disposable); // false
+console.log(result.is_role);       // false (not info@, support@, etc.)
+console.log(result.smtp_provider); // 'google' | 'microsoft' | etc.
+
+// Check if domain is catch-all
+const isCatchAll = await checkCatchAllWithBounceBan(
+  'example.com',
+  { apiKey: process.env.BOUNCEBAN_API_KEY }
+);
+
+// Batch verification (for >5 emails, uses bulk API at $0.003/email)
+const batchResults = await verifyEmailsBatchWithBounceBan(
   ['john@example.com', 'jane@example.com'],
-  { apiKey: process.env.BOUNCER_API_KEY }
+  { apiKey: process.env.BOUNCEBAN_API_KEY }
 );
+
+batchResults.forEach((result, email) => {
+  console.log(`${email}: ${result?.result}`);
+});
 ```
 
 ### Email Finding with Snov.io
@@ -423,12 +555,13 @@ const enrichment = createEnrichmentClient({
   options: {
     // Custom order - cheaper/faster providers first
     providerOrder: [
-      'construct',    // FREE - pattern matching
       'ldd',          // FREE - your database
-      'apollo',       // FREE - limited quota
-      'hunter',       // $0.005
-      'bouncer',      // $0.006 (verification only)
-      'smartprospect', // $0.01
+      'smartprospect', // FREE - SmartLead
+      'cosiall',      // FREE - LinkedIn profiles
+      'trykitt',      // FREE - AI finder
+      'construct',    // FREE - pattern matching
+      'bounceban',    // FREE single / $0.003 bulk
+      'hunter',       // $0.015
       'snovio',       // $0.02
     ],
     
@@ -437,6 +570,9 @@ const enrichment = createEnrichmentClient({
     
     // Minimum confidence to accept
     minConfidence: 70,
+    
+    // Maximum cost per email
+    maxCostPerEmail: 0.05,
   },
 });
 ```
@@ -461,6 +597,60 @@ const enrichment = createEnrichmentClient({
 
 ---
 
+## Contact Matching (LinkedIn <-> SmartProspect)
+
+Match LinkedIn profiles to SmartProspect contacts for unified email lookup:
+
+```typescript
+import {
+  getEmailsForLinkedInContact,
+  getEmailsForLinkedInContactsBatch,
+  salesLeadToContact,
+  createLinkedInEnricher,
+} from 'linkedin-secret-sauce';
+
+// Convert a Sales Navigator lead to contact format
+const contact = salesLeadToContact(lead);
+
+// Get emails for a LinkedIn contact (recommended unified approach)
+const result = await getEmailsForLinkedInContact(
+  {
+    firstName: 'John',
+    lastName: 'Doe',
+    company: 'Acme Corp',
+    linkedinUrl: 'https://linkedin.com/in/johndoe',
+  },
+  {
+    // SmartProspect config
+    smartprospect: {
+      email: process.env.SMARTLEAD_EMAIL,
+      password: process.env.SMARTLEAD_PASSWORD,
+    },
+    // TryKitt.ai (FREE)
+    trykitt: { apiKey: process.env.TRYKITT_API_KEY },
+    // BounceBan (FREE single)
+    bounceban: { 
+      apiKey: process.env.BOUNCEBAN_API_KEY,
+      useDeepVerify: true,
+    },
+  }
+);
+
+console.log(result.emails);           // Array of found emails with metadata
+console.log(result.bestEmail);        // Highest confidence business email
+console.log(result.providersQueried); // Which providers were called
+console.log(result.matchedContact);   // SmartProspect match if found
+
+// Batch version
+const results = await getEmailsForLinkedInContactsBatch(
+  contacts,
+  config,
+  { concurrency: 5 }
+);
+```
+
+---
+
 ## Combined Workflow Example
 
 Here's a complete example: Search LinkedIn -> Enrich with emails:
@@ -479,12 +669,13 @@ initializeLinkedInClient({
   cosiallApiKey: process.env.COSIALL_API_KEY!,
 });
 
-// Initialize enrichment client
+// Initialize enrichment client with new providers
 const enrichment = createEnrichmentClient({
   providers: {
     construct: {},
+    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 },
   },
 });
 
@@ -529,6 +720,38 @@ console.table(leads);
 
 ---
 
+## Environment Variables
+
+Complete reference of all environment variables:
+
+```bash
+# Required - LinkedIn API
+COSIALL_API_URL=https://...
+COSIALL_API_KEY=...
+
+# Optional - LinkedIn networking
+LINKEDIN_PROXY_STRING=host:port:user:pass
+LOG_LEVEL=debug|info|warn|error
+
+# Email Enrichment - FREE providers
+LDD_API_URL=https://...
+LDD_API_TOKEN=...
+
+SMARTLEAD_EMAIL=...
+SMARTLEAD_PASSWORD=...
+
+TRYKITT_API_KEY=...          # FREE for individuals
+
+BOUNCEBAN_API_KEY=...        # FREE single, $0.003 bulk
+
+# Email Enrichment - PAID providers
+HUNTER_API_KEY=...           # $0.015/email
+SNOVIO_CLIENT_ID=...         # $0.02/email
+SNOVIO_CLIENT_SECRET=...
+```
+
+---
+
 ## Development
 
 ```bash
@@ -555,10 +778,23 @@ pnpm docs
 
 ```bash
 pnpm dev:playground
+# or simply
+pnpm dev
 ```
 
 Opens a React UI at http://localhost:5173 to test the API interactively.
 
+**Playground Features:**
+
+| Tab | Features |
+|-----|----------|
+| **LinkedIn** | Sales Navigator search, profile lookup, company tools, typeahead |
+| **SmartLead** | Contact search, email lookup, bulk operations |
+| **LDD** | Profile lookup by username/ID |
+| **Cosiall** | Profile email lookup (objectUrn, URL, vanity) |
+| **Email Tools** | Validation, provider testing (side-by-side), contact matching debugger |
+| **System** | Account management, real-time logs (SSE), metrics, cost analytics |
+
 ---
 
 ## Publishing

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,
@@ -27,7 +27,26 @@
  * });
  * ```
  */
-import type { EnrichmentClientConfig, EnrichmentClient } from "./types";
+import { type EnrichmentClientConfig, type EnrichmentClient } from "./types";
+/**
+ * Provider order is imported from types.ts as DEFAULT_PROVIDER_ORDER
+ *
+ * 3-Phase Strategy:
+ *
+ * PHASE 1 - Free lookups (parallel):
+ *   - ldd: LinkedIn Data Dump - real verified emails (FREE)
+ *   - smartprospect: SmartLead API - real verified emails (FREE with subscription)
+ *   - cosiall: Cosiall Profile Emails - emails from LinkedIn profiles (FREE)
+ *   - trykitt: TryKitt.ai - AI-powered email finder (FREE for individuals)
+ *
+ * PHASE 2 - Pattern + Verification (if Phase 1 < 80% confidence):
+ *   - construct: Pattern guessing + MX check (FREE)
+ *   - bounceban: BounceBan catch-all verification (FREE single / $0.003 bulk)
+ *
+ * PHASE 3 - Paid finders (only if Phase 2 inconclusive):
+ *   - hunter: Hunter.io ($0.015/email)
+ *   - snovio: Snov.io ($0.02/email)
+ */
 /**
  * Create an enrichment client with the given configuration
  *
@@ -41,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,43 +43,38 @@ 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");
 const construct_1 = require("./providers/construct");
 const ldd_1 = require("./providers/ldd");
 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");
 /**
- * Default provider order - 2-Phase Strategy
+ * Provider order is imported from types.ts as DEFAULT_PROVIDER_ORDER
  *
- * PHASE 1 - Free lookups (real data):
+ * 3-Phase Strategy:
+ *
+ * PHASE 1 - Free lookups (parallel):
  *   - ldd: LinkedIn Data Dump - real verified emails (FREE)
  *   - smartprospect: SmartLead API - real verified emails (FREE with subscription)
  *   - cosiall: Cosiall Profile Emails - emails from LinkedIn profiles (FREE)
- *   - construct: Pattern guessing + MX check (FREE)
+ *   - trykitt: TryKitt.ai - AI-powered email finder (FREE for individuals)
  *
- * 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)
+ * PHASE 2 - Pattern + Verification (if Phase 1 < 80% confidence):
+ *   - construct: Pattern guessing + MX check (FREE)
+ *   - bounceban: BounceBan catch-all verification (FREE single / $0.003 bulk)
  *
- * Note: dropcontact available but not in default order
+ * PHASE 3 - Paid finders (only if Phase 2 inconclusive):
+ *   - hunter: Hunter.io ($0.015/email)
+ *   - snovio: Snov.io ($0.02/email)
  */
-const DEFAULT_ORDER = [
-    "ldd",
-    "smartprospect",
-    "cosiall",
-    "construct",
-    "bouncer",
-    "snovio",
-    "hunter",
-];
 /**
  * Create an enrichment client with the given configuration
  *
@@ -103,20 +98,22 @@ function createEnrichmentClient(config) {
     if (providerConfigs.cosiall?.enabled !== false) {
         providerFuncs.set("cosiall", (0, cosiall_1.createCosiallProvider)(providerConfigs.cosiall));
     }
+    // TryKitt.ai - FREE for individuals with unlimited searches
+    if (providerConfigs.trykitt) {
+        providerFuncs.set("trykitt", (0, trykitt_1.createTryKittProvider)(providerConfigs.trykitt));
+    }
     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));
     }
+    // BounceBan - FREE single verification, catch-all specialist
+    if (providerConfigs.bounceban) {
+        providerFuncs.set("bounceban", (0, bounceban_1.createBounceBanProvider)(providerConfigs.bounceban));
+    }
     // Build ordered provider list
-    const providerOrder = options.providerOrder ?? DEFAULT_ORDER;
+    const providerOrder = options.providerOrder ?? types_1.DEFAULT_PROVIDER_ORDER;
     const orderedProviders = [];
     for (const name of providerOrder) {
         const provider = providerFuncs.get(name);
@@ -247,9 +244,9 @@ function buildCacheKey(candidate) {
 }
 // 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; } });
+var types_2 = require("./types");
+Object.defineProperty(exports, "PROVIDER_COSTS", { enumerable: true, get: function () { return types_2.PROVIDER_COSTS; } });
+Object.defineProperty(exports, "DEFAULT_PROVIDER_ORDER", { enumerable: true, get: function () { return types_2.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; } });
@@ -280,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