linkedin-secret-sauce 0.11.1 → 0.12.1

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/index.d.ts

@@ -40,10 +40,10 @@ 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, checkDomainCatchAll, verifyEmailsExist } from "./verification/mx";
-export { createConstructProvider, createLddProvider, createSmartProspectProvider, createHunterProvider, createDropcontactProvider, createBouncerProvider, createSnovioProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache, } from "./providers";
+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 { extractNumericLinkedInId } from "./providers/ldd";
 export { createSmartProspectClient, type SmartProspectClient, type SmartProspectLocationOptions, } from "./providers/smartprospect";
-export { enrichBusinessEmail, enrichBatch, enrichAllEmails, enrichAllBatch } from "./orchestrator";
+export { enrichBusinessEmail, enrichBatch, enrichAllEmails, enrichAllBatch, } from "./orchestrator";
 export { getSmartLeadToken, getSmartLeadUser, clearSmartLeadToken, clearAllSmartLeadTokens, getSmartLeadTokenCacheStats, enableFileCache, disableFileCache, isFileCacheEnabled, clearFileCache, type SmartLeadCredentials, type SmartLeadAuthConfig, type SmartLeadUser, type SmartLeadLoginResponse, } from "./auth";
 export { calculateMatchConfidence, classifyMatchQuality, findBestMatch, matchContacts, buildSmartProspectFiltersFromLinkedIn, parseLinkedInSearchResponse, enrichLinkedInContact, enrichLinkedInContactsBatch, createLinkedInEnricher, getEmailsForLinkedInContact, getEmailsForLinkedInContactsBatch, salesLeadToContact, type LinkedInContact, type MatchResult, type MatchOptions, type LinkedInEnrichmentResult, type LinkedInEnrichmentOptions, type EmailSource, type EmailResult, type GetEmailsResult, type GetEmailsConfig, type GetEmailsOptions, } from "./matching";

package/dist/enrichment/index.js

@@ -43,13 +43,14 @@ 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.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.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.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 cosiall_1 = require("./providers/cosiall");
 const hunter_1 = require("./providers/hunter");
 const dropcontact_1 = require("./providers/dropcontact");
 const bouncer_1 = require("./providers/bouncer");
@@ -60,6 +61,7 @@ const snovio_1 = require("./providers/snovio");
  * PHASE 1 - Free lookups (real data):
  *   - 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)
  *
  * PHASE 2 - Paid verification/finding (only if needed):
@@ -72,6 +74,7 @@ const snovio_1 = require("./providers/snovio");
 const DEFAULT_ORDER = [
     "ldd",
     "smartprospect",
+    "cosiall",
     "construct",
     "bouncer",
     "snovio",
@@ -96,6 +99,10 @@ function createEnrichmentClient(config) {
     if (providerConfigs.smartprospect) {
         providerFuncs.set("smartprospect", (0, smartprospect_1.createSmartProspectProvider)(providerConfigs.smartprospect));
     }
+    // Cosiall is FREE - always create if not explicitly disabled
+    if (providerConfigs.cosiall?.enabled !== false) {
+        providerFuncs.set("cosiall", (0, cosiall_1.createCosiallProvider)(providerConfigs.cosiall));
+    }
     if (providerConfigs.hunter) {
         providerFuncs.set("hunter", (0, hunter_1.createHunterProvider)(providerConfigs.hunter));
     }
@@ -270,6 +277,7 @@ 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, "createCosiallProvider", { enumerable: true, get: function () { return providers_1.createCosiallProvider; } });
 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; } });

package/dist/enrichment/matching.d.ts

@@ -4,9 +4,9 @@
  * Matches contacts between LinkedIn Sales Navigator and SmartProspect
  * to find the same person across both platforms.
  */
-import type { SmartProspectContact, SmartProspectConfig, SmartProspectFetchResponse, LddConfig } from './types';
-import type { SalesLeadSearchResult } from '../types';
-import { type SmartProspectClient } from './providers/smartprospect';
+import type { SmartProspectContact, SmartProspectConfig, SmartProspectFetchResponse, LddConfig } from "./types";
+import type { SalesLeadSearchResult } from "../types";
+import { type SmartProspectClient } from "./providers/smartprospect";
 /**
  * LinkedIn Sales Navigator contact (simplified from API response)
  */
@@ -68,7 +68,7 @@ export interface MatchResult {
     /** Which fields matched */
     matchedFields: string[];
     /** Match quality classification */
-    quality: 'exact' | 'high' | 'medium' | 'low' | 'none';
+    quality: "exact" | "high" | "medium" | "low" | "none";
 }
 /**
  * Options for matching
@@ -91,7 +91,7 @@ export declare function calculateMatchConfidence(linkedin: LinkedInContact, smar
 /**
  * Classify match quality based on confidence and matched fields
  */
-export declare function classifyMatchQuality(confidence: number, matchedFields: string[]): 'exact' | 'high' | 'medium' | 'low' | 'none';
+export declare function classifyMatchQuality(confidence: number, matchedFields: string[]): "exact" | "high" | "medium" | "low" | "none";
 /**
  * Find the best matching SmartProspect contact for a LinkedIn contact
  */
@@ -130,7 +130,7 @@ export interface LinkedInEnrichmentResult {
     /** Match confidence score (0-100) */
     matchConfidence: number;
     /** Match quality classification */
-    matchQuality: 'exact' | 'high' | 'medium' | 'low' | 'none';
+    matchQuality: "exact" | "high" | "medium" | "low" | "none";
     /** Which fields matched */
     matchedFields: string[];
     /** Enriched email (if fetched) */
@@ -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' | 'bouncer' | 'snovio';
+export type EmailSource = "ldd" | "smartprospect" | "cosiall" | "linkedin" | "pattern" | "hunter" | "bouncer" | "snovio";
 /**
  * Email result from unified lookup
  */
@@ -270,7 +270,7 @@ export interface EmailResult {
     /** Confidence score (0-100) */
     confidence: number;
     /** Email type classification */
-    type: 'business' | 'personal' | 'unknown';
+    type: "business" | "personal" | "unknown";
     /** Whether the email was verified */
     verified: boolean;
     /** Email deliverability score (0-1) for SmartProspect emails */
@@ -305,6 +305,10 @@ export interface GetEmailsConfig {
     ldd?: LddConfig;
     /** SmartProspect configuration (FREE for FlexIQ - already paying monthly) */
     smartprospect?: SmartProspectConfig;
+    /** Cosiall Profile Emails (FREE - uses global Cosiall config, no config needed here) */
+    cosiall?: {
+        enabled?: boolean;
+    };
     /** Company domain for email pattern guessing (optional - if not provided, will try to discover) */
     companyDomain?: string;
     /**
@@ -337,6 +341,8 @@ export interface GetEmailsOptions {
     skipLdd?: boolean;
     /** Skip SmartProspect lookup (default: false) */
     skipSmartProspect?: boolean;
+    /** Skip Cosiall Profile Emails lookup (default: false) */
+    skipCosiall?: boolean;
     /** Skip email pattern guessing (default: false) */
     skipPatternGuessing?: boolean;
     /** Skip LinkedIn company lookup for domain discovery (default: false) */