linkedin-secret-sauce 0.12.1 → 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

@@ -41,7 +41,7 @@ export { isPersonalEmail, isBusinessEmail, isPersonalDomain, 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, createCosiallProvider, createHunterProvider, createDropcontactProvider, createBouncerProvider, createSnovioProvider, verifyEmailWithBouncer, checkCatchAllDomain, verifyEmailsBatch, findEmailsWithSnovio, verifyEmailWithSnovio, clearSnovioTokenCache, } from "./providers";
+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";

package/dist/enrichment/index.js

@@ -43,8 +43,8 @@ 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.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.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");
@@ -278,14 +278,23 @@ Object.defineProperty(exports, "createConstructProvider", { enumerable: true, ge
 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

@@ -258,7 +258,7 @@ export declare function createLinkedInEnricher(smartProspectConfig: SmartProspec
 /**
  * Email source - where the email was found
  */
-export type EmailSource = "ldd" | "smartprospect" | "cosiall" | "linkedin" | "pattern" | "hunter" | "bouncer" | "snovio";
+export type EmailSource = "ldd" | "smartprospect" | "cosiall" | "trykitt" | "linkedin" | "pattern" | "hunter" | "bouncer" | "bounceban" | "snovio";
 /**
  * Email result from unified lookup
  */
@@ -309,6 +309,10 @@ export interface GetEmailsConfig {
     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;
     /**
@@ -327,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;
@@ -343,11 +353,15 @@ export interface GetEmailsOptions {
     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;