linkedin-secret-sauce 0.12.0 → 0.12.1

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) */

package/dist/enrichment/matching.js

@@ -70,8 +70,8 @@ const ldd_1 = require("./providers/ldd");
 function salesLeadToContact(lead) {
     // Use firstName/lastName directly from Sales Nav - they're already separate fields
     // This preserves exact names as shown on LinkedIn (important for SmartProspect matching)
-    const firstName = lead.firstName || '';
-    const lastName = lead.lastName || '';
+    const firstName = lead.firstName || "";
+    const lastName = lead.lastName || "";
     return {
         objectUrn: lead.objectUrn,
         entityUrn: lead.salesProfileUrn,
@@ -100,7 +100,7 @@ function salesLeadToContact(lead) {
  */
 function isSalesLeadSearchResult(input) {
     // SalesLeadSearchResult has 'name' but not 'firstName'
-    return 'name' in input && !('firstName' in input);
+    return "name" in input && !("firstName" in input);
 }
 /**
  * Normalize input to LinkedInContact - accepts either format
@@ -119,8 +119,8 @@ function normalizeToContact(input) {
  */
 function normalize(str) {
     if (!str)
-        return '';
-    return str.toLowerCase().trim().replace(/\s+/g, ' ');
+        return "";
+    return str.toLowerCase().trim().replace(/\s+/g, " ");
 }
 /**
  * Extract company name from LinkedIn position
@@ -128,15 +128,15 @@ function normalize(str) {
 function getLinkedInCompany(contact) {
     const pos = contact.currentPositions?.[0];
     if (!pos)
-        return '';
-    return pos.companyUrnResolutionResult?.name || pos.companyName || '';
+        return "";
+    return pos.companyUrnResolutionResult?.name || pos.companyName || "";
 }
 /**
  * Extract job title from LinkedIn position
  */
 function getLinkedInTitle(contact) {
     const pos = contact.currentPositions?.[0];
-    return pos?.title || '';
+    return pos?.title || "";
 }
 /**
  * Extract location parts from LinkedIn geoRegion
@@ -144,8 +144,8 @@ function getLinkedInTitle(contact) {
  */
 function parseLinkedInLocation(geoRegion) {
     if (!geoRegion)
-        return { city: '', state: '', country: '' };
-    const parts = geoRegion.split(',').map((p) => p.trim());
+        return { city: "", state: "", country: "" };
+    const parts = geoRegion.split(",").map((p) => p.trim());
     if (parts.length >= 3) {
         return {
             city: parts[0],
@@ -156,15 +156,15 @@ function parseLinkedInLocation(geoRegion) {
     else if (parts.length === 2) {
         return {
             city: parts[0],
-            state: '',
+            state: "",
             country: parts[1],
         };
     }
     else {
         return {
-            city: '',
-            state: '',
-            country: parts[0] || '',
+            city: "",
+            state: "",
+            country: parts[0] || "",
         };
     }
 }
@@ -209,7 +209,7 @@ function stringSimilarity(a, b) {
  * Check if strings match exactly (normalized)
  */
 function exactMatch(a, b) {
-    return normalize(a) === normalize(b) && normalize(a) !== '';
+    return normalize(a) === normalize(b) && normalize(a) !== "";
 }
 /**
  * Check if strings match with fuzzy tolerance
@@ -245,50 +245,52 @@ function calculateMatchConfidence(linkedin, smartprospect, options = {}) {
     // First name match
     if (exactMatch(linkedin.firstName, smartprospect.firstName)) {
         score += 20;
-        matchedFields.push('firstName:exact');
+        matchedFields.push("firstName:exact");
     }
-    else if (fuzzyNames && fuzzyMatch(linkedin.firstName, smartprospect.firstName)) {
+    else if (fuzzyNames &&
+        fuzzyMatch(linkedin.firstName, smartprospect.firstName)) {
         score += 15;
-        matchedFields.push('firstName:fuzzy');
+        matchedFields.push("firstName:fuzzy");
     }
     // Last name match
     if (exactMatch(linkedin.lastName, smartprospect.lastName)) {
         score += 20;
-        matchedFields.push('lastName:exact');
+        matchedFields.push("lastName:exact");
     }
-    else if (fuzzyNames && fuzzyMatch(linkedin.lastName, smartprospect.lastName)) {
+    else if (fuzzyNames &&
+        fuzzyMatch(linkedin.lastName, smartprospect.lastName)) {
         score += 15;
-        matchedFields.push('lastName:fuzzy');
+        matchedFields.push("lastName:fuzzy");
     }
     // === Company matching (up to 30 points) ===
     const liCompany = getLinkedInCompany(linkedin);
-    const spCompany = smartprospect.company?.name || '';
+    const spCompany = smartprospect.company?.name || "";
     if (exactMatch(liCompany, spCompany)) {
         score += 30;
-        matchedFields.push('company:exact');
+        matchedFields.push("company:exact");
     }
     else if (fuzzyCompany && fuzzyMatch(liCompany, spCompany, 0.8)) {
         score += 25;
-        matchedFields.push('company:fuzzy');
+        matchedFields.push("company:fuzzy");
     }
     else if (containsMatch(liCompany, spCompany)) {
         score += 15;
-        matchedFields.push('company:contains');
+        matchedFields.push("company:contains");
     }
     // === Title matching (up to 15 points) ===
     const liTitle = getLinkedInTitle(linkedin);
-    const spTitle = smartprospect.title || '';
+    const spTitle = smartprospect.title || "";
     if (exactMatch(liTitle, spTitle)) {
         score += 15;
-        matchedFields.push('title:exact');
+        matchedFields.push("title:exact");
     }
     else if (fuzzyMatch(liTitle, spTitle, 0.75)) {
         score += 12;
-        matchedFields.push('title:fuzzy');
+        matchedFields.push("title:fuzzy");
     }
     else if (containsMatch(liTitle, spTitle)) {
         score += 8;
-        matchedFields.push('title:contains');
+        matchedFields.push("title:contains");
     }
     // === Location matching (up to 15 points) ===
     const liLocation = parseLinkedInLocation(linkedin.geoRegion);
@@ -298,17 +300,17 @@ function calculateMatchConfidence(linkedin, smartprospect, options = {}) {
     // Country match
     if (spCountry && exactMatch(liLocation.country, smartprospect.country)) {
         score += 5;
-        matchedFields.push('country:exact');
+        matchedFields.push("country:exact");
     }
     // State match
     if (spState && exactMatch(liLocation.state, smartprospect.state)) {
         score += 5;
-        matchedFields.push('state:exact');
+        matchedFields.push("state:exact");
     }
     // City match
     if (spCity && exactMatch(liLocation.city, smartprospect.city)) {
         score += 5;
-        matchedFields.push('city:exact');
+        matchedFields.push("city:exact");
     }
     return { confidence: Math.min(100, score), matchedFields };
 }
@@ -316,22 +318,22 @@ function calculateMatchConfidence(linkedin, smartprospect, options = {}) {
  * Classify match quality based on confidence and matched fields
  */
 function classifyMatchQuality(confidence, matchedFields) {
-    const hasNameMatch = matchedFields.some((f) => f.startsWith('firstName:exact')) &&
-        matchedFields.some((f) => f.startsWith('lastName:exact'));
-    const hasCompanyMatch = matchedFields.some((f) => f.startsWith('company:'));
+    const hasNameMatch = matchedFields.some((f) => f.startsWith("firstName:exact")) &&
+        matchedFields.some((f) => f.startsWith("lastName:exact"));
+    const hasCompanyMatch = matchedFields.some((f) => f.startsWith("company:"));
     if (confidence >= 85 && hasNameMatch && hasCompanyMatch) {
-        return 'exact';
+        return "exact";
     }
     else if (confidence >= 70 && hasNameMatch) {
-        return 'high';
+        return "high";
     }
     else if (confidence >= 50) {
-        return 'medium';
+        return "medium";
     }
     else if (confidence >= 30) {
-        return 'low';
+        return "low";
     }
-    return 'none';
+    return "none";
 }
 /**
  * Find the best matching SmartProspect contact for a LinkedIn contact
@@ -399,8 +401,8 @@ function parseLinkedInSearchResponse(elements) {
     return elements.map((el) => ({
         objectUrn: el.objectUrn,
         entityUrn: el.entityUrn,
-        firstName: el.firstName || '',
-        lastName: el.lastName || '',
+        firstName: el.firstName || "",
+        lastName: el.lastName || "",
         fullName: el.fullName || undefined,
         geoRegion: el.geoRegion || undefined,
         currentPositions: el.currentPositions,
@@ -457,7 +459,7 @@ async function enrichLinkedInContact(linkedInContact, smartProspectConfig, optio
         numericLinkedInId,
         matchedContact: null,
         matchConfidence: 0,
-        matchQuality: 'none',
+        matchQuality: "none",
         matchedFields: [],
         email: null,
         emailDeliverability: 0,
@@ -468,7 +470,7 @@ async function enrichLinkedInContact(linkedInContact, smartProspectConfig, optio
     // Create SmartProspect client
     const client = (0, smartprospect_1.createSmartProspectClient)(smartProspectConfig);
     if (!client) {
-        result.error = 'Failed to create SmartProspect client - check credentials';
+        result.error = "Failed to create SmartProspect client - check credentials";
         return result;
     }
     try {
@@ -509,12 +511,16 @@ async function enrichLinkedInContact(linkedInContact, smartProspectConfig, optio
                 }
             }
             if (result.allCandidates.length === 0) {
-                result.error = 'No candidates found in SmartProspect';
+                result.error = "No candidates found in SmartProspect";
                 return result;
             }
         }
         // Step 2: Find best match using intelligent matching
-        const matchResult = findBestMatch(linkedInContact, result.allCandidates, { minConfidence, fuzzyNames, fuzzyCompany });
+        const matchResult = findBestMatch(linkedInContact, result.allCandidates, {
+            minConfidence,
+            fuzzyNames,
+            fuzzyCompany,
+        });
         if (!matchResult) {
             result.error = `No match above ${minConfidence}% confidence threshold`;
             return result;
@@ -525,7 +531,9 @@ async function enrichLinkedInContact(linkedInContact, smartProspectConfig, optio
         result.matchedFields = matchResult.matchedFields;
         // Step 3: Fetch email if auto-fetch enabled and good match (COSTS CREDITS)
         if (autoFetch && matchResult.confidence >= minConfidence) {
-            const fetchResponse = await client.fetch([matchResult.smartProspectContact.id]);
+            const fetchResponse = await client.fetch([
+                matchResult.smartProspectContact.id,
+            ]);
             if (fetchResponse.success && fetchResponse.data.list.length > 0) {
                 const enrichedContact = fetchResponse.data.list[0];
                 result.email = enrichedContact.email || null;
@@ -539,7 +547,7 @@ async function enrichLinkedInContact(linkedInContact, smartProspectConfig, optio
         return result;
     }
     catch (err) {
-        result.error = err instanceof Error ? err.message : 'Unknown error';
+        result.error = err instanceof Error ? err.message : "Unknown error";
         return result;
     }
 }
@@ -604,7 +612,7 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
                 numericLinkedInId,
                 matchedContact: null,
                 matchConfidence: 0,
-                matchQuality: 'none',
+                matchQuality: "none",
                 matchedFields: [],
                 email: null,
                 emailDeliverability: 0,
@@ -634,7 +642,9 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
                 result.allCandidates = searchResponse.data.list;
                 result.totalCandidatesFound = searchResponse.data.total_count;
                 // Broader search fallback
-                if (searchResponse.data.list.length === 0 && includeCompany && filters.companyName) {
+                if (searchResponse.data.list.length === 0 &&
+                    includeCompany &&
+                    filters.companyName) {
                     const broaderResponse = await client.search({
                         firstName: filters.firstName,
                         lastName: filters.lastName,
@@ -646,7 +656,7 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
                     }
                 }
                 if (result.allCandidates.length === 0) {
-                    result.error = 'No candidates found in SmartProspect';
+                    result.error = "No candidates found in SmartProspect";
                     return result;
                 }
                 const matchResult = findBestMatch(contact, result.allCandidates, {
@@ -663,12 +673,16 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
                 result.matchQuality = matchResult.quality;
                 result.matchedFields = matchResult.matchedFields;
                 if (autoFetch && matchResult.confidence >= minConfidence) {
-                    const fetchResponse = await client.fetch([matchResult.smartProspectContact.id]);
+                    const fetchResponse = await client.fetch([
+                        matchResult.smartProspectContact.id,
+                    ]);
                     if (fetchResponse.success && fetchResponse.data.list.length > 0) {
                         const enrichedContact = fetchResponse.data.list[0];
                         result.email = enrichedContact.email || null;
-                        result.emailDeliverability = enrichedContact.emailDeliverability || 0;
-                        result.verificationStatus = enrichedContact.verificationStatus || null;
+                        result.emailDeliverability =
+                            enrichedContact.emailDeliverability || 0;
+                        result.verificationStatus =
+                            enrichedContact.verificationStatus || null;
                         result.matchedContact = enrichedContact;
                     }
                 }
@@ -676,7 +690,7 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
                 return result;
             }
             catch (err) {
-                result.error = err instanceof Error ? err.message : 'Unknown error';
+                result.error = err instanceof Error ? err.message : "Unknown error";
                 return result;
             }
         },
@@ -766,7 +780,7 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
 async function getEmailsForLinkedInContact(contactOrLead, config, options = {}) {
     // Normalize input - accept either LinkedInContact or raw SalesLeadSearchResult
     const contact = normalizeToContact(contactOrLead);
-    const { skipLdd = false, skipSmartProspect = false, skipPatternGuessing = false, skipPaidProviders = false, minMatchConfidence = 60, paidProviderThreshold = 80, includeCompany = true, } = options;
+    const { skipLdd = false, skipSmartProspect = false, skipCosiall = false, skipPatternGuessing = false, skipPaidProviders = false, minMatchConfidence = 60, paidProviderThreshold = 80, includeCompany = true, } = options;
     // Extract numeric ID from objectUrn
     const numericLinkedInId = (0, ldd_1.extractNumericLinkedInId)(contact.objectUrn);
     // Extract company domain from contact (LinkedIn data - often missing)
@@ -790,30 +804,34 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
     // Track company domain discovered from SmartProspect (since LinkedIn doesn't provide it)
     let discoveredCompanyDomain = null;
     // ==========================================================================
-    // Phase 1: FREE providers in PARALLEL (LDD + SmartProspect)
+    // Phase 1: FREE providers in PARALLEL (LDD + SmartProspect + Cosiall)
     // ==========================================================================
     const freeProviderPromises = [];
     // LDD lookup (FREE)
     if (!skipLdd && config.ldd?.apiUrl && config.ldd?.apiToken) {
-        result.providersQueried.push('ldd');
+        result.providersQueried.push("ldd");
         freeProviderPromises.push(queryLdd(contact, config.ldd, numericLinkedInId, addEmail, result));
     }
     // SmartProspect lookup (FREE for FlexIQ)
     // This also extracts company domain for pattern guessing
     if (!skipSmartProspect && config.smartprospect) {
-        result.providersQueried.push('smartprospect');
-        freeProviderPromises.push(querySmartProspect(contact, config.smartprospect, minMatchConfidence, includeCompany, addEmail, result)
-            .then((domain) => {
+        result.providersQueried.push("smartprospect");
+        freeProviderPromises.push(querySmartProspect(contact, config.smartprospect, minMatchConfidence, includeCompany, addEmail, result).then((domain) => {
             if (domain) {
                 discoveredCompanyDomain = domain;
             }
         }));
     }
+    // Cosiall Profile Emails lookup (FREE)
+    if (!skipCosiall && config.cosiall?.enabled !== false) {
+        result.providersQueried.push("cosiall");
+        freeProviderPromises.push(queryCosiall(contact, addEmail, result));
+    }
     // Wait for both free providers
     await Promise.all(freeProviderPromises);
     // Check if we have good enough results already
     const bestConfidenceAfterFreeProviders = result.emails.length > 0
-        ? Math.max(...result.emails.map(e => e.confidence))
+        ? Math.max(...result.emails.map((e) => e.confidence))
         : 0;
     // ==========================================================================
     // Phase 2: Domain Discovery (if needed for pattern guessing)
@@ -831,7 +849,7 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
         if (companyUrn) {
             const companyId = extractCompanyIdFromUrn(companyUrn);
             if (companyId) {
-                result.providersQueried.push('linkedin');
+                result.providersQueried.push("linkedin");
                 try {
                     const company = await config.linkedInCompanyLookup(companyId);
                     if (company?.websiteUrl) {
@@ -842,7 +860,7 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
                     }
                 }
                 catch (err) {
-                    result.errors?.push(`LinkedIn: ${err instanceof Error ? err.message : 'Company lookup failed'}`);
+                    result.errors?.push(`LinkedIn: ${err instanceof Error ? err.message : "Company lookup failed"}`);
                 }
             }
         }
@@ -854,13 +872,15 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
     // ==========================================================================
     // Phase 3: Email pattern guessing with MX verification (FREE)
     // ==========================================================================
-    if (!skipPatternGuessing && companyDomain && bestConfidenceAfterFreeProviders < paidProviderThreshold) {
-        result.providersQueried.push('pattern');
+    if (!skipPatternGuessing &&
+        companyDomain &&
+        bestConfidenceAfterFreeProviders < paidProviderThreshold) {
+        result.providersQueried.push("pattern");
         await queryPatternGuessing(contact, companyDomain, addEmail, result);
     }
     // Recalculate best confidence
     const finalBestConfidence = result.emails.length > 0
-        ? Math.max(...result.emails.map(e => e.confidence))
+        ? Math.max(...result.emails.map((e) => e.confidence))
         : 0;
     // ==========================================================================
     // Phase 3: PAID providers as last resort (Hunter/Bouncer/Snovio)
@@ -869,7 +889,9 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
         // Only use paid providers if we have low confidence or no results
         // TODO: Implement Hunter, Bouncer, Snovio providers when needed
         // For now, just mark that we would have queried them
-        if (config.hunter?.apiKey || config.bouncer?.apiKey || config.snovio?.userId) {
+        if (config.hunter?.apiKey ||
+            config.bouncer?.apiKey ||
+            config.snovio?.userId) {
             // result.providersQueried.push('hunter');
             // result.providersQueried.push('bouncer');
             // result.providersQueried.push('snovio');
@@ -880,11 +902,12 @@ async function getEmailsForLinkedInContact(contactOrLead, config, options = {})
     const sourcePriority = {
         ldd: 0, // Highest priority - your own data
         smartprospect: 1,
-        linkedin: 2, // LinkedIn company lookup (for domain discovery, doesn't provide emails)
-        pattern: 3,
-        hunter: 4,
-        bouncer: 5,
-        snovio: 6,
+        cosiall: 2, // Cosiall Profile Emails (FREE)
+        linkedin: 3, // LinkedIn company lookup (for domain discovery, doesn't provide emails)
+        pattern: 4,
+        hunter: 5,
+        bouncer: 6,
+        snovio: 7,
     };
     result.emails.sort((a, b) => {
         if (b.confidence !== a.confidence) {
@@ -920,12 +943,15 @@ function extractDomainFromUrl(url) {
     if (!url)
         return null;
     try {
-        const fullUrl = url.startsWith('http') ? url : `https://${url}`;
-        return new URL(fullUrl).hostname.replace(/^www\./, '').toLowerCase();
+        const fullUrl = url.startsWith("http") ? url : `https://${url}`;
+        return new URL(fullUrl).hostname.replace(/^www\./, "").toLowerCase();
     }
     catch {
         // If URL parsing fails, try simple extraction
-        return url.replace(/^(https?:\/\/)?(www\.)?/, '').split('/')[0].toLowerCase() || null;
+        return (url
+            .replace(/^(https?:\/\/)?(www\.)?/, "")
+            .split("/")[0]
+            .toLowerCase() || null);
     }
 }
 /**
@@ -950,13 +976,13 @@ async function queryLdd(contact, lddConfig, numericLinkedInId, addEmail, result)
             firstName: contact.firstName,
             lastName: contact.lastName,
         });
-        if (lddResult && 'emails' in lddResult && lddResult.emails.length > 0) {
+        if (lddResult && "emails" in lddResult && lddResult.emails.length > 0) {
             for (const emailData of lddResult.emails) {
                 addEmail({
                     email: emailData.email,
-                    source: 'ldd',
+                    source: "ldd",
                     confidence: emailData.confidence ?? 90,
-                    type: emailData.metadata?.emailTypeClassified || 'unknown',
+                    type: emailData.metadata?.emailTypeClassified || "unknown",
                     verified: emailData.verified ?? true,
                     metadata: emailData.metadata,
                 });
@@ -964,7 +990,55 @@ async function queryLdd(contact, lddConfig, numericLinkedInId, addEmail, result)
         }
     }
     catch (err) {
-        result.errors?.push(`LDD: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        result.errors?.push(`LDD: ${err instanceof Error ? err.message : "Unknown error"}`);
+    }
+}
+/**
+ * Query Cosiall Profile Emails provider
+ */
+async function queryCosiall(contact, addEmail, result) {
+    try {
+        // Import dynamically to avoid circular deps
+        const { fetchProfileEmailsFromCosiall } = await Promise.resolve().then(() => __importStar(require("../cosiall-client")));
+        // Build lookup parameters from contact
+        const objectUrn = contact.objectUrn;
+        const linkedInUrl = contact.entityUrn
+            ? undefined // entityUrn is not a URL
+            : undefined;
+        // Extract vanity from contact if available
+        // (LinkedInContact doesn't have direct username field, but could be derived)
+        // Must have at least objectUrn to query Cosiall
+        if (!objectUrn) {
+            return; // Silently skip - no identifier available
+        }
+        const cosiallResult = await fetchProfileEmailsFromCosiall({
+            objectUrn,
+            linkedInUrl,
+        });
+        if (cosiallResult.emails && cosiallResult.emails.length > 0) {
+            for (const email of cosiallResult.emails) {
+                addEmail({
+                    email,
+                    source: "cosiall",
+                    confidence: 85, // Good confidence - profile-associated emails
+                    type: "unknown", // Cosiall doesn't classify email type
+                    verified: true, // These are from LinkedIn profiles
+                    metadata: {
+                        profileId: cosiallResult.profileId,
+                        objectUrn: cosiallResult.objectUrn,
+                        linkedInUrl: cosiallResult.linkedInUrl,
+                    },
+                });
+            }
+        }
+    }
+    catch (err) {
+        // Silently fail for NOT_FOUND - just means profile not in database
+        const errorMessage = err instanceof Error ? err.message : "Unknown error";
+        if (!errorMessage.includes("not found") &&
+            !errorMessage.includes("NOT_FOUND")) {
+            result.errors?.push(`Cosiall: ${errorMessage}`);
+        }
     }
 }
 /**
@@ -975,7 +1049,7 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
     try {
         const client = (0, smartprospect_1.createSmartProspectClient)(smartProspectConfig);
         if (!client) {
-            result.errors?.push('SmartProspect: Failed to create client');
+            result.errors?.push("SmartProspect: Failed to create client");
             return null;
         }
         // Build search filters
@@ -1021,21 +1095,23 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
         if (companyWebsite) {
             // Clean up the domain (remove protocol, www, trailing slashes)
             discoveredDomain = companyWebsite
-                .replace(/^(https?:\/\/)?(www\.)?/, '')
-                .split('/')[0]
+                .replace(/^(https?:\/\/)?(www\.)?/, "")
+                .split("/")[0]
                 .toLowerCase();
         }
         // Fetch email for matched contact
-        const fetchResponse = await client.fetch([matchResult.smartProspectContact.id]);
+        const fetchResponse = await client.fetch([
+            matchResult.smartProspectContact.id,
+        ]);
         if (fetchResponse.success && fetchResponse.data.list.length > 0) {
             const enrichedContact = fetchResponse.data.list[0];
             if (enrichedContact.email) {
                 addEmail({
                     email: enrichedContact.email,
-                    source: 'smartprospect',
+                    source: "smartprospect",
                     confidence: matchResult.confidence,
-                    type: 'business',
-                    verified: enrichedContact.verificationStatus === 'verified',
+                    type: "business",
+                    verified: enrichedContact.verificationStatus === "verified",
                     deliverability: enrichedContact.emailDeliverability,
                     metadata: {
                         matchQuality: matchResult.quality,
@@ -1051,7 +1127,7 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
         return discoveredDomain;
     }
     catch (err) {
-        result.errors?.push(`SmartProspect: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        result.errors?.push(`SmartProspect: ${err instanceof Error ? err.message : "Unknown error"}`);
         return null;
     }
 }
@@ -1061,20 +1137,25 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
 async function queryPatternGuessing(contact, companyDomain, addEmail, result) {
     try {
         // Import construct provider dynamically to avoid circular deps
-        const { createConstructProvider } = await Promise.resolve().then(() => __importStar(require('./providers/construct')));
-        const constructProvider = createConstructProvider({ maxAttempts: 12, timeoutMs: 3000 });
+        const { createConstructProvider } = await Promise.resolve().then(() => __importStar(require("./providers/construct")));
+        const constructProvider = createConstructProvider({
+            maxAttempts: 12,
+            timeoutMs: 3000,
+        });
         const constructResult = await constructProvider({
             firstName: contact.firstName,
             lastName: contact.lastName,
             domain: companyDomain,
         });
-        if (constructResult && 'emails' in constructResult && constructResult.emails.length > 0) {
+        if (constructResult &&
+            "emails" in constructResult &&
+            constructResult.emails.length > 0) {
             for (const emailData of constructResult.emails) {
                 addEmail({
                     email: emailData.email,
-                    source: 'pattern',
+                    source: "pattern",
                     confidence: emailData.confidence ?? 50,
-                    type: 'business',
+                    type: "business",
                     verified: emailData.verified ?? false,
                     isCatchAll: emailData.isCatchAll,
                     metadata: emailData.metadata,
@@ -1083,7 +1164,7 @@ async function queryPatternGuessing(contact, companyDomain, addEmail, result) {
         }
     }
     catch (err) {
-        result.errors?.push(`Pattern: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        result.errors?.push(`Pattern: ${err instanceof Error ? err.message : "Unknown error"}`);
     }
 }
 /**

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

@@ -0,0 +1,27 @@
+/**
+ * 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)
+ */
+import type { EnrichmentCandidate, ProviderMultiResult, ProviderResult } from "../types";
+/**
+ * Cosiall provider configuration
+ * No configuration needed - uses Cosiall API credentials from global config
+ */
+export interface CosiallConfig {
+    /** Whether to enable the provider (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Create the Cosiall provider function
+ *
+ * Returns all emails found for a LinkedIn profile.
+ * Since this is a free service, it should always be executed.
+ */
+export declare function createCosiallProvider(config?: CosiallConfig): (candidate: EnrichmentCandidate) => Promise<ProviderResult | ProviderMultiResult | null>;

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/package.json

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