linkedin-secret-sauce 0.11.1 → 0.12.1

package/dist/enrichment/providers/cosiall.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Cosiall Profile Emails Provider
+ *
+ * Lookups against the Cosiall FlexIQ Profile Emails API.
+ * This is FREE and returns all known emails for a LinkedIn profile.
+ *
+ * Lookup priority:
+ * 1. objectUrn (most precise - "urn:li:fsd_profile:ACoAABcdEfG")
+ * 2. linkedInUrl (URL like "https://www.linkedin.com/in/john-doe/")
+ * 3. vanity (username extracted from URL or direct field)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCosiallProvider = createCosiallProvider;
+const cosiall_client_1 = require("../../cosiall-client");
+const validation_1 = require("../utils/validation");
+/**
+ * Extract objectUrn from candidate
+ */
+function extractObjectUrn(candidate) {
+    const objectUrn = candidate.objectUrn || candidate.object_urn;
+    if (objectUrn && objectUrn.startsWith("urn:li:")) {
+        return objectUrn;
+    }
+    return null;
+}
+/**
+ * Extract LinkedIn URL from candidate
+ */
+function extractLinkedInUrl(candidate) {
+    const url = candidate.linkedinUrl || candidate.linkedin_url;
+    if (url && url.includes("linkedin.com")) {
+        return url;
+    }
+    return null;
+}
+/**
+ * Extract vanity (username) from candidate
+ */
+function extractVanity(candidate) {
+    // Direct username field
+    const directUsername = candidate.linkedinUsername || candidate.linkedin_username;
+    if (directUsername) {
+        return directUsername;
+    }
+    // Extract from URL
+    const url = candidate.linkedinUrl || candidate.linkedin_url;
+    if (url) {
+        const extracted = (0, validation_1.extractLinkedInUsername)(url);
+        if (extracted) {
+            return extracted;
+        }
+    }
+    return null;
+}
+/**
+ * Create the Cosiall provider function
+ *
+ * Returns all emails found for a LinkedIn profile.
+ * Since this is a free service, it should always be executed.
+ */
+function createCosiallProvider(config) {
+    // Check if explicitly disabled
+    if (config?.enabled === false) {
+        const noopProvider = async () => null;
+        noopProvider.__name = "cosiall";
+        return noopProvider;
+    }
+    async function fetchEmail(candidate) {
+        // Extract lookup parameters in priority order
+        const objectUrn = extractObjectUrn(candidate);
+        const linkedInUrl = extractLinkedInUrl(candidate);
+        const vanity = extractVanity(candidate);
+        // Must have at least one lookup parameter
+        if (!objectUrn && !linkedInUrl && !vanity) {
+            return null;
+        }
+        try {
+            const result = await (0, cosiall_client_1.fetchProfileEmailsFromCosiall)({
+                objectUrn: objectUrn || undefined,
+                linkedInUrl: linkedInUrl || undefined,
+                vanity: vanity || undefined,
+            });
+            // No emails found
+            if (!result.emails || result.emails.length === 0) {
+                return null;
+            }
+            // Build multi-result with all emails
+            const emails = result.emails.map((email) => ({
+                email,
+                verified: true, // Cosiall data is from LinkedIn profiles
+                confidence: 85, // Good confidence - these are profile-associated emails
+                metadata: {
+                    profileId: result.profileId,
+                    objectUrn: result.objectUrn,
+                    linkedInUrl: result.linkedInUrl,
+                    source: "cosiall",
+                },
+            }));
+            return { emails };
+        }
+        catch {
+            // Silently fail - provider failures shouldn't stop the enrichment flow
+            return null;
+        }
+    }
+    // Mark provider name for orchestrator
+    fetchEmail.__name = "cosiall";
+    return fetchEmail;
+}

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

@@ -1,10 +1,11 @@
 /**
  * Email Enrichment Providers
  */
-export { createConstructProvider } from './construct';
-export { createLddProvider } from './ldd';
-export { createSmartProspectProvider } from './smartprospect';
-export { createHunterProvider } from './hunter';
-export { createDropcontactProvider } from './dropcontact';
-export { createBouncerProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch } from './bouncer';
-export { createSnovioProvider, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache } from './snovio';
+export { createConstructProvider } from "./construct";
+export { createLddProvider } from "./ldd";
+export { createSmartProspectProvider } from "./smartprospect";
+export { createCosiallProvider } from "./cosiall";
+export { createHunterProvider } from "./hunter";
+export { createDropcontactProvider } from "./dropcontact";
+export { createBouncerProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, } from "./bouncer";
+export { createSnovioProvider, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache, } from "./snovio";

package/dist/enrichment/providers/index.js

@@ -3,13 +3,15 @@
  * Email Enrichment Providers
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.clearSnovioTokenCache = exports.verifyEmailWithSnovio = exports.findEmailsWithSnovio = exports.createSnovioProvider = exports.verifyEmailsBatch = exports.checkCatchAllDomain = exports.verifyEmailWithBouncer = exports.createBouncerProvider = exports.createDropcontactProvider = exports.createHunterProvider = exports.createSmartProspectProvider = exports.createLddProvider = exports.createConstructProvider = void 0;
+exports.clearSnovioTokenCache = exports.verifyEmailWithSnovio = exports.findEmailsWithSnovio = exports.createSnovioProvider = exports.verifyEmailsBatch = exports.checkCatchAllDomain = exports.verifyEmailWithBouncer = exports.createBouncerProvider = exports.createDropcontactProvider = exports.createHunterProvider = exports.createCosiallProvider = exports.createSmartProspectProvider = exports.createLddProvider = exports.createConstructProvider = void 0;
 var construct_1 = require("./construct");
 Object.defineProperty(exports, "createConstructProvider", { enumerable: true, get: function () { return construct_1.createConstructProvider; } });
 var ldd_1 = require("./ldd");
 Object.defineProperty(exports, "createLddProvider", { enumerable: true, get: function () { return ldd_1.createLddProvider; } });
 var smartprospect_1 = require("./smartprospect");
 Object.defineProperty(exports, "createSmartProspectProvider", { enumerable: true, get: function () { return smartprospect_1.createSmartProspectProvider; } });
+var cosiall_1 = require("./cosiall");
+Object.defineProperty(exports, "createCosiallProvider", { enumerable: true, get: function () { return cosiall_1.createCosiallProvider; } });
 var hunter_1 = require("./hunter");
 Object.defineProperty(exports, "createHunterProvider", { enumerable: true, get: function () { return hunter_1.createHunterProvider; } });
 var dropcontact_1 = require("./dropcontact");

package/dist/enrichment/types.d.ts

@@ -45,7 +45,7 @@ export interface ProviderMultiResult {
 /**
  * Email type classification
  */
-export type EmailType = 'business' | 'personal' | 'disposable' | 'role' | 'unknown';
+export type EmailType = "business" | "personal" | "disposable" | "role" | "unknown";
 /**
  * Individual enriched email with full metadata
  */
@@ -179,11 +179,11 @@ export interface BouncerConfig {
 /**
  * Bouncer verification result status
  */
-export type BouncerStatus = 'deliverable' | 'undeliverable' | 'risky' | 'unknown';
+export type BouncerStatus = "deliverable" | "undeliverable" | "risky" | "unknown";
 /**
  * Bouncer verification result reason
  */
-export type BouncerReason = 'accepted_email' | 'rejected_email' | 'invalid_domain' | 'invalid_email' | 'unavailable_smtp' | 'dns_error' | 'low_deliverability' | 'low_quality' | 'catch_all' | 'full_mailbox' | 'role_account' | 'disposable' | 'timeout' | 'unknown';
+export type BouncerReason = "accepted_email" | "rejected_email" | "invalid_domain" | "invalid_email" | "unavailable_smtp" | "dns_error" | "low_deliverability" | "low_quality" | "catch_all" | "full_mailbox" | "role_account" | "disposable" | "timeout" | "unknown";
 /**
  * Bouncer API response for single email verification
  */
@@ -232,7 +232,7 @@ export interface SnovioConfig {
 /**
  * Snov.io email verification status
  */
-export type SnovioVerificationStatus = 'valid' | 'not_valid' | 'catch_all' | 'unverifiable' | 'unknown';
+export type SnovioVerificationStatus = "valid" | "not_valid" | "catch_all" | "unverifiable" | "unknown";
 /**
  * Snov.io email result
  */
@@ -244,7 +244,7 @@ export interface SnovioEmailResult {
     position?: string;
     sourcePage?: string;
     companyName?: string;
-    type?: 'prospect' | 'personal';
+    type?: "prospect" | "personal";
     status?: string;
 }
 /**
@@ -274,6 +274,16 @@ export interface ConstructConfig {
     /** Delay between SMTP verification checks in ms (default: 2000) */
     smtpVerifyDelayMs?: number;
 }
+/**
+ * Cosiall Profile Emails provider configuration
+ *
+ * Uses Cosiall FlexIQ Profile Emails API to lookup emails for LinkedIn profiles.
+ * This is FREE - no API key needed (uses global Cosiall config).
+ */
+export interface CosiallConfig {
+    /** Whether to enable the provider (default: true) */
+    enabled?: boolean;
+}
 /**
  * All provider configurations
  */
@@ -281,6 +291,8 @@ export interface ProvidersConfig {
     construct?: ConstructConfig;
     ldd?: LddConfig;
     smartprospect?: SmartProspectConfig;
+    /** Cosiall Profile Emails (FREE - uses global Cosiall config) */
+    cosiall?: CosiallConfig;
     hunter?: HunterConfig;
     dropcontact?: DropcontactConfig;
     /** Bouncer.io for SMTP email verification (99%+ accuracy) */
@@ -365,13 +377,14 @@ export interface EnrichmentClient {
 /**
  * Available provider names
  */
-export type ProviderName = "construct" | "ldd" | "smartprospect" | "hunter" | "dropcontact" | "bouncer" | "snovio";
+export type ProviderName = "construct" | "ldd" | "smartprospect" | "cosiall" | "hunter" | "dropcontact" | "bouncer" | "snovio";
 /**
  * Default provider order - 2-Phase Strategy
  *
  * PHASE 1 - Free lookups (run in parallel):
  *   - ldd: LinkedIn Data Dump - real verified emails (FREE with subscription)
  *   - 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 Phase 1 inconclusive):
@@ -388,6 +401,7 @@ export declare const DEFAULT_PROVIDER_ORDER: ProviderName[];
  * Costs based on 2025 pricing:
  * - ldd: FREE (subscription-based)
  * - smartprospect: FREE (included in SmartLead subscription)
+ * - cosiall: FREE (uses global Cosiall config)
  * - construct: FREE (pattern guessing + MX check)
  * - bouncer: $0.006/email (SMTP verification, 99%+ accuracy)
  * - snovio: $0.02/email (email finding + verification)
@@ -492,23 +506,23 @@ export interface SmartProspectSearchFilters {
 /**
  * SmartProspect Department values (exact API values)
  */
-export type SmartProspectDepartment = 'Engineering' | 'Finance & Administration' | 'Human Resources' | 'IT & IS' | 'Marketing' | 'Operations' | 'Other' | 'Support' | 'Sales';
+export type SmartProspectDepartment = "Engineering" | "Finance & Administration" | "Human Resources" | "IT & IS" | "Marketing" | "Operations" | "Other" | "Support" | "Sales";
 /**
  * SmartProspect Level/Seniority values (exact API values)
  */
-export type SmartProspectLevel = 'Staff' | 'Manager-Level' | 'Director-Level' | 'VP-Level' | 'C-Level';
+export type SmartProspectLevel = "Staff" | "Manager-Level" | "Director-Level" | "VP-Level" | "C-Level";
 /**
  * SmartProspect Headcount ranges (exact API values)
  */
-export type SmartProspectHeadcount = '0 - 25' | '25 - 100' | '100 - 250' | '250 - 1000' | '1K - 10K' | '10K - 50K' | '50K - 100K' | '> 100K';
+export type SmartProspectHeadcount = "0 - 25" | "25 - 100" | "100 - 250" | "250 - 1000" | "1K - 10K" | "10K - 50K" | "50K - 100K" | "> 100K";
 /**
  * SmartProspect Revenue ranges (exact API values)
  */
-export type SmartProspectRevenue = '$0 - 1M' | '$1 - 10M' | '$10 - 50M' | '$50 - 100M' | '$100 - 250M' | '$250 - 500M' | '$500M - 1B' | '> $1B';
+export type SmartProspectRevenue = "$0 - 1M" | "$1 - 10M" | "$10 - 50M" | "$50 - 100M" | "$100 - 250M" | "$250 - 500M" | "$500M - 1B" | "> $1B";
 /**
  * SmartProspect Industry values (exact API values)
  */
-export type SmartProspectIndustry = 'Software & Internet' | 'Business Services' | 'Real Estate & Construction' | 'Financial Services' | 'Healthcare, Pharmaceuticals, & Biotech' | 'Retail' | 'Consumer Services' | 'Education' | 'Media & Entertainment' | 'Travel, Recreation, and Leisure' | 'Transportation & Storage' | 'Manufacturing' | 'Wholesale & Distribution' | 'Non-Profit' | 'Energy & Utilities' | 'Government' | 'Agriculture & Mining' | 'Computers & Electronics' | 'Telecommunications' | 'Other';
+export type SmartProspectIndustry = "Software & Internet" | "Business Services" | "Real Estate & Construction" | "Financial Services" | "Healthcare, Pharmaceuticals, & Biotech" | "Retail" | "Consumer Services" | "Education" | "Media & Entertainment" | "Travel, Recreation, and Leisure" | "Transportation & Storage" | "Manufacturing" | "Wholesale & Distribution" | "Non-Profit" | "Energy & Utilities" | "Government" | "Agriculture & Mining" | "Computers & Electronics" | "Telecommunications" | "Other";
 /**
  * SmartProspect Sub-Industry values (exact API values - partial list)
  * Note: This is a subset of available sub-industries. The API accepts many more.

package/dist/enrichment/types.js

@@ -13,6 +13,7 @@ exports.SMARTPROSPECT_SUB_INDUSTRIES = exports.PROVIDER_COSTS = exports.DEFAULT_
  * PHASE 1 - Free lookups (run in parallel):
  *   - ldd: LinkedIn Data Dump - real verified emails (FREE with subscription)
  *   - 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 Phase 1 inconclusive):
@@ -25,6 +26,7 @@ exports.SMARTPROSPECT_SUB_INDUSTRIES = exports.PROVIDER_COSTS = exports.DEFAULT_
 exports.DEFAULT_PROVIDER_ORDER = [
     "ldd",
     "smartprospect",
+    "cosiall",
     "construct",
     "bouncer",
     "snovio",
@@ -36,6 +38,7 @@ exports.DEFAULT_PROVIDER_ORDER = [
  * Costs based on 2025 pricing:
  * - ldd: FREE (subscription-based)
  * - smartprospect: FREE (included in SmartLead subscription)
+ * - cosiall: FREE (uses global Cosiall config)
  * - construct: FREE (pattern guessing + MX check)
  * - bouncer: $0.006/email (SMTP verification, 99%+ accuracy)
  * - snovio: $0.02/email (email finding + verification)
@@ -46,6 +49,7 @@ exports.PROVIDER_COSTS = {
     construct: 0,
     ldd: 0,
     smartprospect: 0,
+    cosiall: 0,
     hunter: 0.005,
     dropcontact: 0.01,
     bouncer: 0.006,
@@ -57,46 +61,46 @@ exports.PROVIDER_COSTS = {
  */
 exports.SMARTPROSPECT_SUB_INDUSTRIES = [
     // Software & Internet
-    'Internet',
-    'Information Technology and Services',
-    'Information Services',
-    'Computer Software',
-    'Computer & Network Security',
-    'Computer Games',
+    "Internet",
+    "Information Technology and Services",
+    "Information Services",
+    "Computer Software",
+    "Computer & Network Security",
+    "Computer Games",
     // Real Estate & Construction
-    'Glass, Ceramics & Concrete',
-    'Construction',
-    'Commercial Real Estate',
-    'Civil Engineering',
-    'Building Materials',
-    'Architecture & Planning',
+    "Glass, Ceramics & Concrete",
+    "Construction",
+    "Commercial Real Estate",
+    "Civil Engineering",
+    "Building Materials",
+    "Architecture & Planning",
     // Business Services
-    'Writing and Editing',
-    'Translation and Localization',
-    'Think Tanks',
-    'Staffing and Recruiting',
-    'Security and Investigations',
-    'Public Safety',
-    'Public Relations and Communications',
-    'Program Development',
-    'Professional Training & Coaching',
-    'Market Research',
-    'Marketing and Advertising',
-    'Management Consulting',
-    'Legal Services',
-    'Law Practice',
-    'Law Enforcement',
-    'International Trade and Development',
-    'Import and Export',
-    'Human Resources',
-    'Graphic Design',
-    'Facilities Services',
-    'Executive Office',
-    'Events Services',
-    'Environmental Services',
-    'Design',
-    'Business Supplies and Equipment',
-    'Animation',
-    'Alternative Dispute Resolution',
-    'Outsourcing/Offshoring',
+    "Writing and Editing",
+    "Translation and Localization",
+    "Think Tanks",
+    "Staffing and Recruiting",
+    "Security and Investigations",
+    "Public Safety",
+    "Public Relations and Communications",
+    "Program Development",
+    "Professional Training & Coaching",
+    "Market Research",
+    "Marketing and Advertising",
+    "Management Consulting",
+    "Legal Services",
+    "Law Practice",
+    "Law Enforcement",
+    "International Trade and Development",
+    "Import and Export",
+    "Human Resources",
+    "Graphic Design",
+    "Facilities Services",
+    "Executive Office",
+    "Events Services",
+    "Environmental Services",
+    "Design",
+    "Business Supplies and Equipment",
+    "Animation",
+    "Alternative Dispute Resolution",
+    "Outsourcing/Offshoring",
 ];

package/dist/index.d.ts

@@ -52,6 +52,7 @@ export type { LinkedInTenure, LinkedInPosition, LinkedInSpotlightBadge, SalesLea
 export { LinkedInClientError } from "./utils/errors";
 export * from "./cosiall-client";
 export * from "./cookie-pool";
+export type { CosiallProfileEmailsResponse, ProfileEmailsLookupOptions, } from "./types";
 export { parseFullProfile } from "./parsers/profile-parser";
 export { parseSalesSearchResults } from "./parsers/search-parser";
 export * from "./utils/metrics";

package/dist/types.d.ts

@@ -1,3 +1,29 @@
+/**
+ * Response from the Cosiall Profile Emails API endpoint.
+ * Returns email addresses associated with a LinkedIn profile.
+ */
+export interface CosiallProfileEmailsResponse {
+    /** Cosiall internal profile ID */
+    profileId: number;
+    /** LinkedIn ObjectURN identifier (e.g., "urn:li:fsd_profile:ACoAABcdEfG") */
+    objectUrn: string;
+    /** LinkedIn profile URL */
+    linkedInUrl: string;
+    /** List of email addresses associated with the profile (may be empty) */
+    emails: string[];
+}
+/**
+ * Options for looking up profile emails from Cosiall.
+ * At least one of objectUrn, linkedInUrl, or vanity must be provided.
+ */
+export interface ProfileEmailsLookupOptions {
+    /** LinkedIn ObjectURN identifier (most precise lookup method) */
+    objectUrn?: string;
+    /** Full LinkedIn profile URL (e.g., "https://www.linkedin.com/in/john-doe/") */
+    linkedInUrl?: string;
+    /** LinkedIn username/vanity name (e.g., "john-doe") */
+    vanity?: string;
+}
 export interface LinkedInCookie {
     name: string;
     value: string;
@@ -6,7 +32,7 @@ export interface LinkedInCookie {
     expires?: number;
     httpOnly?: boolean;
     secure?: boolean;
-    sameSite?: 'Strict' | 'Lax' | 'None';
+    sameSite?: "Strict" | "Lax" | "None";
 }
 export interface AccountCookies {
     accountId: string;
@@ -184,7 +210,7 @@ export interface Company {
     specialties?: string[];
     emailDomains?: string[];
 }
-export type TypeaheadType = 'BING_GEO' | 'TITLE' | 'INDUSTRY' | 'SENIORITY_LEVEL' | 'FUNCTION' | 'COMPANY_SIZE' | 'COMPANY' | 'PROFILE_LANGUAGE';
+export type TypeaheadType = "BING_GEO" | "TITLE" | "INDUSTRY" | "SENIORITY_LEVEL" | "FUNCTION" | "COMPANY_SIZE" | "COMPANY" | "PROFILE_LANGUAGE";
 export interface TypeaheadItem {
     id: string;
     text: string;
@@ -208,7 +234,7 @@ export interface SalesNavigatorProfile {
     flagshipProfileUrl?: string;
 }
 export type Geo = {
-    type: 'region' | 'country' | 'state' | 'city' | 'postal';
+    type: "region" | "country" | "state" | "city" | "postal";
     value: string;
     id?: string;
 };

package/dist/utils/metrics.d.ts

@@ -15,6 +15,9 @@ export interface Metrics {
     cosiallFetches: number;
     cosiallSuccess: number;
     cosiallFailures: number;
+    cosiallProfileEmailsFetches: number;
+    cosiallProfileEmailsSuccess: number;
+    cosiallProfileEmailsFailures: number;
     companyFetches: number;
     typeaheadRequests: number;
 }

package/dist/utils/metrics.js

@@ -20,6 +20,9 @@ const metrics = {
     cosiallFetches: 0,
     cosiallSuccess: 0,
     cosiallFailures: 0,
+    cosiallProfileEmailsFetches: 0,
+    cosiallProfileEmailsSuccess: 0,
+    cosiallProfileEmailsFailures: 0,
     companyFetches: 0,
     typeaheadRequests: 0,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkedin-secret-sauce",
-  "version": "0.11.1",
+  "version": "0.12.1",
   "description": "Private LinkedIn Sales Navigator client with automatic cookie management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",