linkedin-secret-sauce 0.11.0 → 0.12.0

package/dist/cosiall-client.d.ts

@@ -1,4 +1,4 @@
-import type { AccountCookies } from "./types";
+import type { AccountCookies, CosiallProfileEmailsResponse, ProfileEmailsLookupOptions } from "./types";
 /**
  * Fetches LinkedIn cookies for all available accounts from the Cosiall API.
  * These cookies are used for authenticating requests to LinkedIn's API.
@@ -19,3 +19,42 @@ import type { AccountCookies } from "./types";
  * ```
  */
 export declare function fetchCookiesFromCosiall(): Promise<AccountCookies[]>;
+/**
+ * Fetches email addresses associated with a LinkedIn profile from the Cosiall API.
+ *
+ * This endpoint provides flexible lookup by ObjectURN, LinkedIn URL, or vanity name.
+ * At least one lookup parameter must be provided.
+ *
+ * @param options - Lookup options (objectUrn, linkedInUrl, or vanity)
+ * @returns Profile emails response with profileId, objectUrn, linkedInUrl, and emails array
+ * @throws LinkedInClientError with code INVALID_REQUEST if no lookup parameters provided
+ * @throws LinkedInClientError with code NOT_FOUND if profile not found
+ * @throws LinkedInClientError with code AUTH_ERROR if API key is invalid
+ * @throws LinkedInClientError with code REQUEST_FAILED for other API errors
+ *
+ * @remarks
+ * - Lookup priority: objectUrn > linkedInUrl > vanity
+ * - Returns empty emails array if profile exists but has no emails
+ * - URL normalization is handled server-side (trailing slashes, https prefix)
+ *
+ * @example
+ * ```typescript
+ * // Lookup by ObjectURN (most precise)
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ * });
+ *
+ * // Lookup by LinkedIn URL
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   linkedInUrl: 'https://www.linkedin.com/in/john-doe/'
+ * });
+ *
+ * // Lookup by vanity name
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   vanity: 'john-doe'
+ * });
+ *
+ * console.log(`Found ${result.emails.length} emails:`, result.emails);
+ * ```
+ */
+export declare function fetchProfileEmailsFromCosiall(options: ProfileEmailsLookupOptions): Promise<CosiallProfileEmailsResponse>;

package/dist/cosiall-client.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.fetchCookiesFromCosiall = fetchCookiesFromCosiall;
+exports.fetchProfileEmailsFromCosiall = fetchProfileEmailsFromCosiall;
 const config_1 = require("./config");
 const errors_1 = require("./utils/errors");
 const logger_1 = require("./utils/logger");
@@ -120,11 +121,149 @@ async function fetchCookiesFromCosiall() {
         }
         return true;
     }
-    return data
-        .filter(isItem)
-        .map((item) => ({
+    return data.filter(isItem).map((item) => ({
         accountId: item.accountId,
         cookies: item.cookies,
         expiresAt: item.expiresAt,
     }));
 }
+/**
+ * Fetches email addresses associated with a LinkedIn profile from the Cosiall API.
+ *
+ * This endpoint provides flexible lookup by ObjectURN, LinkedIn URL, or vanity name.
+ * At least one lookup parameter must be provided.
+ *
+ * @param options - Lookup options (objectUrn, linkedInUrl, or vanity)
+ * @returns Profile emails response with profileId, objectUrn, linkedInUrl, and emails array
+ * @throws LinkedInClientError with code INVALID_REQUEST if no lookup parameters provided
+ * @throws LinkedInClientError with code NOT_FOUND if profile not found
+ * @throws LinkedInClientError with code AUTH_ERROR if API key is invalid
+ * @throws LinkedInClientError with code REQUEST_FAILED for other API errors
+ *
+ * @remarks
+ * - Lookup priority: objectUrn > linkedInUrl > vanity
+ * - Returns empty emails array if profile exists but has no emails
+ * - URL normalization is handled server-side (trailing slashes, https prefix)
+ *
+ * @example
+ * ```typescript
+ * // Lookup by ObjectURN (most precise)
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ * });
+ *
+ * // Lookup by LinkedIn URL
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   linkedInUrl: 'https://www.linkedin.com/in/john-doe/'
+ * });
+ *
+ * // Lookup by vanity name
+ * const result = await fetchProfileEmailsFromCosiall({
+ *   vanity: 'john-doe'
+ * });
+ *
+ * console.log(`Found ${result.emails.length} emails:`, result.emails);
+ * ```
+ */
+async function fetchProfileEmailsFromCosiall(options) {
+    const { objectUrn, linkedInUrl, vanity } = options;
+    // Validate at least one parameter is provided
+    if (!objectUrn && !linkedInUrl && !vanity) {
+        throw new errors_1.LinkedInClientError("At least one of 'objectUrn', 'linkedInUrl', or 'vanity' must be provided", "INVALID_REQUEST", 400);
+    }
+    const { cosiallApiUrl, cosiallApiKey } = (0, config_1.getConfig)();
+    const base = cosiallApiUrl.replace(/\/+$/, "");
+    // Build query string
+    const params = new URLSearchParams();
+    if (objectUrn)
+        params.set("objectUrn", objectUrn);
+    if (linkedInUrl)
+        params.set("linkedInUrl", linkedInUrl);
+    if (vanity)
+        params.set("vanity", vanity);
+    const url = `${base}/api/flexiq/profile-emails?${params.toString()}`;
+    (0, logger_1.log)("info", "cosiall.profileEmails.start", {
+        objectUrn,
+        linkedInUrl,
+        vanity,
+    });
+    (0, metrics_1.incrementMetric)("cosiallProfileEmailsFetches");
+    const response = await fetch(url, {
+        method: "GET",
+        headers: {
+            "X-API-Key": cosiallApiKey,
+            Accept: "application/json",
+        },
+    });
+    // Handle error responses
+    if (!response.ok) {
+        const status = response.status;
+        let errorMessage = "Profile emails fetch failed";
+        let errorCode = "REQUEST_FAILED";
+        try {
+            const errorData = (await response.json());
+            errorMessage = errorData.error || errorMessage;
+        }
+        catch {
+            // Ignore JSON parse errors
+        }
+        if (status === 400) {
+            errorCode = "INVALID_REQUEST";
+            (0, logger_1.log)("warn", "cosiall.profileEmails.invalidRequest", {
+                status,
+                errorMessage,
+            });
+        }
+        else if (status === 401) {
+            errorCode = "AUTH_ERROR";
+            (0, logger_1.log)("warn", "cosiall.profileEmails.authError", { status });
+        }
+        else if (status === 404) {
+            errorCode = "NOT_FOUND";
+            (0, logger_1.log)("info", "cosiall.profileEmails.notFound", {
+                objectUrn,
+                linkedInUrl,
+                vanity,
+            });
+        }
+        else {
+            (0, logger_1.log)("warn", "cosiall.profileEmails.error", { status, errorMessage });
+            (0, metrics_1.incrementMetric)("cosiallProfileEmailsFailures");
+            // Report unexpected errors to Sentry
+            try {
+                const { reportCriticalError } = await Promise.resolve().then(() => __importStar(require("./utils/sentry")));
+                reportCriticalError("Cosiall Profile Emails API failure", {
+                    status,
+                    errorMessage,
+                    objectUrn,
+                    linkedInUrl,
+                    vanity,
+                    tags: { component: "cosiall-client", endpoint: "profile-emails" },
+                });
+            }
+            catch { }
+        }
+        throw new errors_1.LinkedInClientError(errorMessage, errorCode, status);
+    }
+    const data = await response.json();
+    // Validate response structure
+    if (!data ||
+        typeof data !== "object" ||
+        !("profileId" in data) ||
+        !("objectUrn" in data) ||
+        !("linkedInUrl" in data) ||
+        !("emails" in data)) {
+        (0, logger_1.log)("error", "cosiall.profileEmails.invalidFormat", {
+            dataType: typeof data,
+        });
+        (0, metrics_1.incrementMetric)("cosiallProfileEmailsFailures");
+        throw new errors_1.LinkedInClientError("Invalid profile emails response format", "REQUEST_FAILED", 500);
+    }
+    const result = data;
+    (0, logger_1.log)("info", "cosiall.profileEmails.success", {
+        profileId: result.profileId,
+        emailCount: result.emails.length,
+    });
+    (0, metrics_1.incrementMetric)("cosiallProfileEmailsSuccess");
+    return result;
+}

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

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

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

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

package/dist/enrichment/index.d.ts

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

package/dist/enrichment/index.js

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

package/dist/enrichment/matching.d.ts

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

package/dist/enrichment/matching.js

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

package/dist/enrichment/orchestrator.js

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