linkedin-secret-sauce 0.10.1 → 0.11.1

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

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

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

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

package/dist/enrichment/index.d.ts

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

package/dist/enrichment/index.js

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

package/dist/enrichment/matching.d.ts

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

package/dist/enrichment/matching.js

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

package/dist/enrichment/orchestrator.js

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

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

@@ -0,0 +1,67 @@
+/**
+ * Bouncer.io Email Verification Provider
+ *
+ * Provides SMTP-level email verification with 99%+ accuracy.
+ * Best for verifying pattern-guessed emails on non-catch-all domains.
+ *
+ * Features:
+ * - SMTP verification (checks if mailbox exists)
+ * - Catch-all domain detection
+ * - Disposable email detection
+ * - Role account detection
+ * - Toxicity scoring (0-5)
+ *
+ * @see https://docs.usebouncer.com
+ */
+import type { EnrichmentCandidate, ProviderResult, ProviderMultiResult, BouncerConfig, BouncerVerifyResponse } from '../types';
+/**
+ * Create the Bouncer verification provider
+ *
+ * NOTE: This provider is a VERIFIER, not a FINDER. It verifies emails
+ * that were generated by the construct provider or passed in the candidate.
+ *
+ * Usage in the enrichment flow:
+ * 1. construct provider generates email patterns
+ * 2. bouncer provider verifies which patterns are deliverable
+ * 3. Only verified emails are returned
+ */
+export declare function createBouncerProvider(config: BouncerConfig): (candidate: EnrichmentCandidate) => Promise<ProviderResult | ProviderMultiResult | null>;
+/**
+ * Standalone function to verify a single email via Bouncer
+ *
+ * Useful for ad-hoc verification outside the enrichment flow.
+ *
+ * @example
+ * ```typescript
+ * const result = await verifyEmailWithBouncer('test@example.com', {
+ *   apiKey: process.env.BOUNCER_API_KEY,
+ * });
+ * console.log(result.status); // 'deliverable' | 'undeliverable' | 'risky' | 'unknown'
+ * ```
+ */
+export declare function verifyEmailWithBouncer(email: string, config: BouncerConfig): Promise<BouncerVerifyResponse | null>;
+/**
+ * Check if a domain is catch-all via Bouncer
+ *
+ * Sends a verification request for a random email and checks acceptAll flag.
+ *
+ * @example
+ * ```typescript
+ * const isCatchAll = await checkCatchAllDomain('example.com', {
+ *   apiKey: process.env.BOUNCER_API_KEY,
+ * });
+ * ```
+ */
+export declare function checkCatchAllDomain(domain: string, config: BouncerConfig): Promise<boolean | null>;
+/**
+ * Verify multiple emails in batch via Bouncer
+ *
+ * @example
+ * ```typescript
+ * const results = await verifyEmailsBatch(
+ *   ['john@example.com', 'jane@example.com'],
+ *   { apiKey: process.env.BOUNCER_API_KEY }
+ * );
+ * ```
+ */
+export declare function verifyEmailsBatch(emails: string[], config: BouncerConfig): Promise<Map<string, BouncerVerifyResponse | null>>;