linkedin-secret-sauce 0.12.1 → 0.12.3

package/README.md

@@ -4,14 +4,21 @@ 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 (11 providers including Hunter, Bouncer, TryKitt.ai, BounceBan, Snov.io, etc.)
 
 ## Documentation
 
-- [Full API Documentation](https://enerage.github.io/LinkedInSecretSauce/) - Auto-generated TypeDoc
 - [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
+
+**Generate API docs locally:**
+```bash
+pnpm docs
+# Opens TypeDoc documentation in your browser
+```
 
 ## Installation
 
@@ -73,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
@@ -189,17 +240,68 @@ 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 |
 |----------|------|------|----------|
-| **Construct** | Pattern + MX | FREE | Quick pattern matching |
-| **LDD** | Database | FREE | LinkedIn profile emails |
+| **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 |
+| **BounceBan** | Verification | FREE/$0.003 | Catch-all specialist (85-95% accuracy) |
 | **Bouncer** | SMTP Verify | $0.006/email | Catch-all detection, 99%+ accuracy |
-| **Snov.io** | Email Finder | $0.02/email | Finding emails by name+domain |
 | **Hunter** | Email Finder | $0.005/email | Domain search, email finder |
-| **Apollo** | Database | FREE | B2B contact database |
-| **SmartProspect** | Database | $0.01/email | Lead database search |
+| **Dropcontact** | Email Finder | $0.01/email | Email finding API |
+| **Snov.io** | Email Finder | $0.02/email | Finding emails by name+domain |
+
+*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.005/email
+└── Snov.io      → $0.02/email
+```
+
+### Cosiall Profile Emails (Standalone)
+
+Lookup emails directly from LinkedIn profiles without the full enrichment pipeline:
+
+```typescript
+import { fetchProfileEmailsFromCosiall } from 'linkedin-secret-sauce';
+
+// Lookup by ObjectURN (most precise)
+const result = await fetchProfileEmailsFromCosiall({
+  objectUrn: 'urn:li:member:129147375'
+});
+
+// Or by LinkedIn URL
+const result = await fetchProfileEmailsFromCosiall({
+  linkedInUrl: 'https://www.linkedin.com/in/john-doe/'
+});
+
+// Or by vanity name
+const result = await fetchProfileEmailsFromCosiall({
+  vanity: 'john-doe'
+});
+
+console.log(result.emails); // ['john@company.com', 'john.doe@gmail.com']
+```
 
 ### Quick Start
 
@@ -208,29 +310,37 @@ import { createEnrichmentClient } from 'linkedin-secret-sauce';
 
 const enrichment = createEnrichmentClient({
   providers: {
-    // FREE providers (no API key needed)
-    construct: {},
-    
-    // Paid providers (add your API keys)
-    hunter: { apiKey: process.env.HUNTER_API_KEY },
-    apollo: { apiKey: process.env.APOLLO_API_KEY },
-    bouncer: { apiKey: process.env.BOUNCER_API_KEY },
-    snovio: { 
-      clientId: process.env.SNOVIO_CLIENT_ID,
-      clientSecret: process.env.SNOVIO_CLIENT_SECRET 
-    },
-    
-    // Your private LinkedIn data dump
+    // FREE providers - all run automatically in parallel
     ldd: { 
       apiUrl: process.env.LDD_API_URL,
       apiToken: process.env.LDD_API_TOKEN 
     },
-    
-    // SmartLead (supports credentials or direct token)
     smartprospect: {
       email: process.env.SMARTLEAD_EMAIL,
       password: process.env.SMARTLEAD_PASSWORD,
     },
+    // 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 },
+    snovio: { 
+      clientId: process.env.SNOVIO_CLIENT_ID,
+      clientSecret: process.env.SNOVIO_CLIENT_SECRET 
+    },
+    hunter: { apiKey: process.env.HUNTER_API_KEY },
   },
   
   // Optional: cost tracking callback
@@ -290,11 +400,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,
+});
+```
+
+### TryKitt.ai Email Finder
+
+AI-powered email finding with enterprise identity server catch-all verification:
+
+```typescript
+import { 
+  findEmailWithTryKitt, 
+  verifyEmailWithTryKitt 
+} from 'linkedin-secret-sauce';
+
+// 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
+);
+
+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
+}
+
+// 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.BOUNCEBAN_API_KEY }
+);
+
+batchResults.forEach((result, email) => {
+  console.log(`${email}: ${result?.result}`);
+});
 ```
 
 ### Email Verification with Bouncer
@@ -394,12 +592,14 @@ const enrichment = createEnrichmentClient({
   options: {
     // Custom order - cheaper/faster providers first
     providerOrder: [
-      'construct',    // FREE - pattern matching
       'ldd',          // FREE - your database
-      'apollo',       // FREE - limited quota
+      'smartprospect', // FREE - SmartLead
+      'cosiall',      // FREE - LinkedIn profiles
+      'trykitt',      // FREE - AI finder
+      'construct',    // FREE - pattern matching
+      'bounceban',    // FREE single / $0.003 bulk
       'hunter',       // $0.005
       'bouncer',      // $0.006 (verification only)
-      'smartprospect', // $0.01
       'snovio',       // $0.02
     ],
     
@@ -408,6 +608,9 @@ const enrichment = createEnrichmentClient({
     
     // Minimum confidence to accept
     minConfidence: 70,
+    
+    // Maximum cost per email
+    maxCostPerEmail: 0.05,
   },
 });
 ```
@@ -432,6 +635,62 @@ 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,
+    },
+    // Bouncer for final verification
+    bouncer: { apiKey: process.env.BOUNCER_API_KEY },
+  }
+);
+
+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:
@@ -450,10 +709,12 @@ 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 },
   },
@@ -500,6 +761,40 @@ 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.005/email
+BOUNCER_API_KEY=...          # $0.006/email
+DROPCONTACT_API_KEY=...      # $0.01/email
+SNOVIO_CLIENT_ID=...         # $0.02/email
+SNOVIO_CLIENT_SECRET=...
+```
+
+---
+
 ## Development
 
 ```bash
@@ -526,10 +821,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
@@ -554,4 +862,4 @@ UNLICENSED - Private package
 ## Support
 
 - Issues: [GitHub Issues](https://github.com/enerage/LinkedInSecretSauce/issues)
-- Docs: [API Documentation](https://enerage.github.io/LinkedInSecretSauce/)
+- Docs: Run `pnpm docs` to generate TypeDoc locally

package/dist/cosiall-client.d.ts

@@ -41,7 +41,7 @@ export declare function fetchCookiesFromCosiall(): Promise<AccountCookies[]>;
  * ```typescript
  * // Lookup by ObjectURN (most precise)
  * const result = await fetchProfileEmailsFromCosiall({
- *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ *   objectUrn: 'urn:li:member:129147375'
  * });
  *
  * // Lookup by LinkedIn URL

package/dist/cosiall-client.js

@@ -149,7 +149,7 @@ async function fetchCookiesFromCosiall() {
  * ```typescript
  * // Lookup by ObjectURN (most precise)
  * const result = await fetchProfileEmailsFromCosiall({
- *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ *   objectUrn: 'urn:li:member:129147375'
  * });
  *
  * // Lookup by LinkedIn URL

package/dist/enrichment/index.d.ts

@@ -27,7 +27,28 @@
  * });
  * ```
  */
-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.005/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
  *
@@ -41,7 +62,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, createHunterProvider, createDropcontactProvider, createBouncerProvider, createSnovioProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache, } from "./providers";
+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 { 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

@@ -43,43 +43,42 @@ 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.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.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 = void 0;
+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.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)
+ *   - 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 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 3 - Paid finders (only if Phase 2 inconclusive):
+ *   - hunter: Hunter.io ($0.005/email)
+ *   - snovio: Snov.io ($0.02/email)
  *
- * Note: dropcontact available but not in default order
+ * Note: bouncer ($0.006) and dropcontact ($0.01) available but not in default order
  */
-const DEFAULT_ORDER = [
-    "ldd",
-    "smartprospect",
-    "cosiall",
-    "construct",
-    "bouncer",
-    "snovio",
-    "hunter",
-];
 /**
  * Create an enrichment client with the given configuration
  *
@@ -103,6 +102,10 @@ 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));
     }
@@ -115,8 +118,12 @@ function createEnrichmentClient(config) {
     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 +254,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; } });
@@ -278,14 +285,23 @@ Object.defineProperty(exports, "createConstructProvider", { enumerable: true, ge
 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, "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; } });
+Object.defineProperty(exports, "checkCatchAllWithBounceBan", { enumerable: true, get: function () { return providers_1.checkCatchAllWithBounceBan; } });
 // Snov.io utilities
 Object.defineProperty(exports, "findEmailsWithSnovio", { enumerable: true, get: function () { return providers_1.findEmailsWithSnovio; } });
 Object.defineProperty(exports, "verifyEmailWithSnovio", { enumerable: true, get: function () { return providers_1.verifyEmailWithSnovio; } });