linkedin-secret-sauce 0.12.0 → 0.12.2

package/README.md

@@ -8,10 +8,16 @@ A complete LinkedIn Sales Navigator client + Email Enrichment library for Node.j
 
 ## Documentation
 
-- [Full API Documentation](https://enerage.github.io/LinkedInSecretSauce/) - Auto-generated TypeDoc
 - [Integration Guide](docs/INTEGRATION.md) - Step-by-step setup
 - [Sales Search Guide](docs/SALES_SEARCH.md) - Advanced search filters
 - [Playground Guide](docs/PLAYGROUND.md) - Local dev UI
+- [Cosiall Profile Emails](docs/COSIALL_PROFILE_EMAILS.md) - Profile email lookups
+
+**Generate API docs locally:**
+```bash
+pnpm docs
+# Opens TypeDoc documentation in your browser
+```
 
 ## Installation
 
@@ -193,13 +199,40 @@ Find and verify business emails using multiple providers with waterfall/parallel
 
 | Provider | Type | Cost | Best For |
 |----------|------|------|----------|
-| **Construct** | Pattern + MX | FREE | Quick pattern matching |
-| **LDD** | Database | FREE | LinkedIn profile emails |
+| **LDD** | Database | FREE | LinkedIn profile emails (~500M profiles) |
+| **SmartProspect** | Database | FREE* | SmartLead's prospect database |
+| **Cosiall** | Profile Lookup | FREE | Emails from LinkedIn profiles |
+| **Construct** | Pattern + MX | FREE | Pattern guessing with MX verification |
 | **Bouncer** | SMTP Verify | $0.006/email | Catch-all detection, 99%+ accuracy |
 | **Snov.io** | Email Finder | $0.02/email | Finding emails by name+domain |
 | **Hunter** | Email Finder | $0.005/email | Domain search, email finder |
-| **Apollo** | Database | FREE | B2B contact database |
-| **SmartProspect** | Database | $0.01/email | Lead database search |
+
+*SmartProspect is FREE if you have a SmartLead subscription
+
+### Cosiall Profile Emails (Standalone)
+
+Lookup emails directly from LinkedIn profiles without the full enrichment pipeline:
+
+```typescript
+import { fetchProfileEmailsFromCosiall } from 'linkedin-secret-sauce';
+
+// Lookup by ObjectURN (most precise)
+const result = await fetchProfileEmailsFromCosiall({
+  objectUrn: 'urn:li:member:129147375'
+});
+
+// Or by LinkedIn URL
+const result = await fetchProfileEmailsFromCosiall({
+  linkedInUrl: 'https://www.linkedin.com/in/john-doe/'
+});
+
+// Or by vanity name
+const result = await fetchProfileEmailsFromCosiall({
+  vanity: 'john-doe'
+});
+
+console.log(result.emails); // ['john@company.com', 'john.doe@gmail.com']
+```
 
 ### Quick Start
 
@@ -208,29 +241,25 @@ import { createEnrichmentClient } from 'linkedin-secret-sauce';
 
 const enrichment = createEnrichmentClient({
   providers: {
-    // FREE providers (no API key needed)
-    construct: {},
-    
-    // Paid providers (add your API keys)
-    hunter: { apiKey: process.env.HUNTER_API_KEY },
-    apollo: { apiKey: process.env.APOLLO_API_KEY },
-    bouncer: { apiKey: process.env.BOUNCER_API_KEY },
-    snovio: { 
-      clientId: process.env.SNOVIO_CLIENT_ID,
-      clientSecret: process.env.SNOVIO_CLIENT_SECRET 
-    },
-    
-    // Your private LinkedIn data dump
+    // FREE providers - all run automatically in parallel
     ldd: { 
       apiUrl: process.env.LDD_API_URL,
       apiToken: process.env.LDD_API_TOKEN 
     },
-    
-    // SmartLead (supports credentials or direct token)
     smartprospect: {
       email: process.env.SMARTLEAD_EMAIL,
       password: process.env.SMARTLEAD_PASSWORD,
     },
+    // cosiall: enabled by default (uses global Cosiall config)
+    // construct: enabled by default (pattern guessing)
+    
+    // PAID providers - only used if FREE providers don't find email
+    bouncer: { apiKey: process.env.BOUNCER_API_KEY },
+    snovio: { 
+      userId: process.env.SNOVIO_USER_ID,
+      apiSecret: process.env.SNOVIO_API_SECRET 
+    },
+    hunter: { apiKey: process.env.HUNTER_API_KEY },
   },
   
   // Optional: cost tracking callback
@@ -554,4 +583,4 @@ UNLICENSED - Private package
 ## Support
 
 - Issues: [GitHub Issues](https://github.com/enerage/LinkedInSecretSauce/issues)
-- Docs: [API Documentation](https://enerage.github.io/LinkedInSecretSauce/)
+- Docs: Run `pnpm docs` to generate TypeDoc locally

package/dist/cosiall-client.d.ts

@@ -41,7 +41,7 @@ export declare function fetchCookiesFromCosiall(): Promise<AccountCookies[]>;
  * ```typescript
  * // Lookup by ObjectURN (most precise)
  * const result = await fetchProfileEmailsFromCosiall({
- *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ *   objectUrn: 'urn:li:member:129147375'
  * });
  *
  * // Lookup by LinkedIn URL

package/dist/cosiall-client.js

@@ -149,7 +149,7 @@ async function fetchCookiesFromCosiall() {
  * ```typescript
  * // Lookup by ObjectURN (most precise)
  * const result = await fetchProfileEmailsFromCosiall({
- *   objectUrn: 'urn:li:fsd_profile:ACoAABcdEfG'
+ *   objectUrn: 'urn:li:member:129147375'
  * });
  *
  * // Lookup by LinkedIn URL

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, createTryKittProvider, createHunterProvider, createDropcontactProvider, createBouncerProvider, createBounceBanProvider, createSnovioProvider, findEmailWithTryKitt, verifyEmailWithTryKitt, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, verifyEmailWithBounceBan, verifyEmailsBatchWithBounceBan, checkCatchAllWithBounceBan, 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.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.checkCatchAllWithBounceBan = exports.verifyEmailsBatchWithBounceBan = exports.verifyEmailWithBounceBan = exports.verifyEmailsBatch = exports.checkCatchAllDomain = exports.verifyEmailWithBouncer = exports.verifyEmailWithTryKitt = exports.findEmailWithTryKitt = exports.createSnovioProvider = exports.createBounceBanProvider = exports.createBouncerProvider = exports.createDropcontactProvider = exports.createHunterProvider = exports.createTryKittProvider = 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 = exports.findBestMatch = exports.classifyMatchQuality = exports.calculateMatchConfidence = exports.clearFileCache = exports.isFileCacheEnabled = exports.disableFileCache = exports.enableFileCache = 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,14 +277,24 @@ 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, "createTryKittProvider", { enumerable: true, get: function () { return providers_1.createTryKittProvider; } });
 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; } });
+Object.defineProperty(exports, "createBounceBanProvider", { enumerable: true, get: function () { return providers_1.createBounceBanProvider; } });
 Object.defineProperty(exports, "createSnovioProvider", { enumerable: true, get: function () { return providers_1.createSnovioProvider; } });
+// TryKitt utilities
+Object.defineProperty(exports, "findEmailWithTryKitt", { enumerable: true, get: function () { return providers_1.findEmailWithTryKitt; } });
+Object.defineProperty(exports, "verifyEmailWithTryKitt", { enumerable: true, get: function () { return providers_1.verifyEmailWithTryKitt; } });
 // Bouncer utilities
 Object.defineProperty(exports, "verifyEmailWithBouncer", { enumerable: true, get: function () { return providers_1.verifyEmailWithBouncer; } });
 Object.defineProperty(exports, "checkCatchAllDomain", { enumerable: true, get: function () { return providers_1.checkCatchAllDomain; } });
 Object.defineProperty(exports, "verifyEmailsBatch", { enumerable: true, get: function () { return providers_1.verifyEmailsBatch; } });
+// BounceBan utilities
+Object.defineProperty(exports, "verifyEmailWithBounceBan", { enumerable: true, get: function () { return providers_1.verifyEmailWithBounceBan; } });
+Object.defineProperty(exports, "verifyEmailsBatchWithBounceBan", { enumerable: true, get: function () { return providers_1.verifyEmailsBatchWithBounceBan; } });
+Object.defineProperty(exports, "checkCatchAllWithBounceBan", { enumerable: true, get: function () { return providers_1.checkCatchAllWithBounceBan; } });
 // Snov.io utilities
 Object.defineProperty(exports, "findEmailsWithSnovio", { enumerable: true, get: function () { return providers_1.findEmailsWithSnovio; } });
 Object.defineProperty(exports, "verifyEmailWithSnovio", { enumerable: true, get: function () { return providers_1.verifyEmailWithSnovio; } });

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" | "trykitt" | "linkedin" | "pattern" | "hunter" | "bouncer" | "bounceban" | "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,14 @@ 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;
+    };
+    /** TryKitt.ai configuration (FREE for individuals - unlimited) */
+    trykitt?: {
+        apiKey: string;
+    };
     /** Company domain for email pattern guessing (optional - if not provided, will try to discover) */
     companyDomain?: string;
     /**
@@ -323,6 +331,12 @@ export interface GetEmailsConfig {
     bouncer?: {
         apiKey: string;
     };
+    /** BounceBan configuration (FREE single / catch-all specialist) */
+    bounceban?: {
+        apiKey: string;
+        useDeepVerify?: boolean;
+        useWaterfall?: boolean;
+    };
     /** Snov.io configuration (PAID - email finder) */
     snovio?: {
         userId: string;
@@ -337,11 +351,17 @@ export interface GetEmailsOptions {
     skipLdd?: boolean;
     /** Skip SmartProspect lookup (default: false) */
     skipSmartProspect?: boolean;
+    /** Skip Cosiall Profile Emails lookup (default: false) */
+    skipCosiall?: boolean;
+    /** Skip TryKitt.ai lookup (default: false) */
+    skipTryKitt?: boolean;
     /** Skip email pattern guessing (default: false) */
     skipPatternGuessing?: boolean;
+    /** Skip BounceBan catch-all verification (default: false) */
+    skipBounceBan?: boolean;
     /** Skip LinkedIn company lookup for domain discovery (default: false) */
     skipLinkedInCompanyLookup?: boolean;
-    /** Skip paid providers Hunter/Apollo (default: false) */
+    /** Skip paid providers Hunter/Snovio (default: false) */
     skipPaidProviders?: boolean;
     /** Minimum match confidence for SmartProspect (default: 60) */
     minMatchConfidence?: number;