linkedin-secret-sauce 0.9.0 → 0.10.1

package/dist/enrichment/index.d.ts

@@ -44,4 +44,4 @@ export { extractNumericLinkedInId } from "./providers/ldd";
 export { createSmartProspectClient, type SmartProspectClient, type SmartProspectLocationOptions, } from "./providers/smartprospect";
 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, type LinkedInContact, type MatchResult, type MatchOptions, type LinkedInEnrichmentResult, type LinkedInEnrichmentOptions, type EmailSource, type EmailResult, type GetEmailsResult, type GetEmailsConfig, type GetEmailsOptions, } from "./matching";
+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

@@ -42,7 +42,7 @@ 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.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 = exports.getSmartLeadTokenCacheStats = exports.clearAllSmartLeadTokens = exports.clearSmartLeadToken = exports.getSmartLeadUser = exports.getSmartLeadToken = exports.enrichAllBatch = exports.enrichAllEmails = exports.enrichBatch = exports.enrichBusinessEmail = exports.createSmartProspectClient = exports.extractNumericLinkedInId = exports.createDropcontactProvider = exports.createApolloProvider = exports.createHunterProvider = exports.createSmartProspectProvider = exports.createLddProvider = exports.createConstructProvider = 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 = 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 = exports.getSmartLeadTokenCacheStats = exports.clearAllSmartLeadTokens = exports.clearSmartLeadToken = exports.getSmartLeadUser = exports.getSmartLeadToken = exports.enrichAllBatch = exports.enrichAllEmails = exports.enrichBatch = exports.enrichBusinessEmail = exports.createSmartProspectClient = exports.extractNumericLinkedInId = exports.createDropcontactProvider = exports.createApolloProvider = exports.createHunterProvider = exports.createSmartProspectProvider = exports.createLddProvider = exports.createConstructProvider = 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 = void 0;
 exports.createEnrichmentClient = createEnrichmentClient;
 const orchestrator_1 = require("./orchestrator");
 const construct_1 = require("./providers/construct");
@@ -290,3 +290,5 @@ Object.defineProperty(exports, "createLinkedInEnricher", { enumerable: true, get
 // UNIFIED email lookup (recommended for most use cases)
 Object.defineProperty(exports, "getEmailsForLinkedInContact", { enumerable: true, get: function () { return matching_1.getEmailsForLinkedInContact; } });
 Object.defineProperty(exports, "getEmailsForLinkedInContactsBatch", { enumerable: true, get: function () { return matching_1.getEmailsForLinkedInContactsBatch; } });
+// Conversion utility for Sales Nav entities
+Object.defineProperty(exports, "salesLeadToContact", { enumerable: true, get: function () { return matching_1.salesLeadToContact; } });

package/dist/enrichment/matching.d.ts

@@ -5,6 +5,7 @@
  * 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';
 /**
  * LinkedIn Sales Navigator contact (simplified from API response)
@@ -39,6 +40,21 @@ export interface LinkedInContact {
         }>;
     };
 }
+/**
+ * Convert a Sales Navigator search result to LinkedInContact format.
+ * This allows consumers to pass raw Sales Nav entities directly.
+ *
+ * @param lead - Raw Sales Navigator lead search result
+ * @returns LinkedInContact compatible with email lookup functions
+ *
+ * @example
+ * ```typescript
+ * const searchResults = await searchSalesLeads('CEO', { filters });
+ * const contact = salesLeadToContact(searchResults.items[0]);
+ * const emails = await getEmailsForLinkedInContact(contact, config);
+ * ```
+ */
+export declare function salesLeadToContact(lead: SalesLeadSearchResult): LinkedInContact;
 /**
  * Match result with confidence score
  */
@@ -242,7 +258,7 @@ export declare function createLinkedInEnricher(smartProspectConfig: SmartProspec
 /**
  * Email source - where the email was found
  */
-export type EmailSource = 'ldd' | 'smartprospect' | 'pattern' | 'hunter' | 'apollo';
+export type EmailSource = 'ldd' | 'smartprospect' | 'linkedin' | 'pattern' | 'hunter' | 'apollo';
 /**
  * Email result from unified lookup
  */
@@ -276,6 +292,8 @@ export interface GetEmailsResult {
     numericLinkedInId: string | null;
     /** Which providers were queried */
     providersQueried: EmailSource[];
+    /** Company domain discovered during lookup (from SmartProspect if not in LinkedIn data) */
+    discoveredCompanyDomain?: string;
     /** Error message if any provider failed */
     errors?: string[];
 }
@@ -287,8 +305,16 @@ export interface GetEmailsConfig {
     ldd?: LddConfig;
     /** SmartProspect configuration (FREE for FlexIQ - already paying monthly) */
     smartprospect?: SmartProspectConfig;
-    /** Company domain for email pattern guessing (optional) */
+    /** Company domain for email pattern guessing (optional - if not provided, will try to discover) */
     companyDomain?: string;
+    /**
+     * LinkedIn company lookup function (for fetching company website when not available).
+     * Pass getCompanyById from linkedin-api to enable this.
+     * This is a LAST RESORT since it uses LinkedIn API quota.
+     */
+    linkedInCompanyLookup?: (companyId: string) => Promise<{
+        websiteUrl?: string;
+    } | null>;
     /** Hunter configuration (PAID - last resort) */
     hunter?: {
         apiKey: string;
@@ -308,6 +334,8 @@ export interface GetEmailsOptions {
     skipSmartProspect?: boolean;
     /** Skip email pattern guessing (default: false) */
     skipPatternGuessing?: boolean;
+    /** Skip LinkedIn company lookup for domain discovery (default: false) */
+    skipLinkedInCompanyLookup?: boolean;
     /** Skip paid providers Hunter/Apollo (default: false) */
     skipPaidProviders?: boolean;
     /** Minimum match confidence for SmartProspect (default: 60) */
@@ -362,13 +390,14 @@ export interface GetEmailsOptions {
  * }
  * ```
  */
-export declare function getEmailsForLinkedInContact(contact: LinkedInContact, config: GetEmailsConfig, options?: GetEmailsOptions): Promise<GetEmailsResult>;
+export declare function getEmailsForLinkedInContact(contactOrLead: LinkedInContact | SalesLeadSearchResult, config: GetEmailsConfig, options?: GetEmailsOptions): Promise<GetEmailsResult>;
 /**
  * Get emails for multiple LinkedIn contacts in batch
  *
  * Processes contacts with controlled concurrency to balance speed and rate limits.
+ * Accepts either LinkedInContact[] or SalesLeadSearchResult[] directly from Sales Nav search.
  */
-export declare function getEmailsForLinkedInContactsBatch(contacts: LinkedInContact[], config: GetEmailsConfig, options?: GetEmailsOptions & {
+export declare function getEmailsForLinkedInContactsBatch(contactsOrLeads: (LinkedInContact | SalesLeadSearchResult)[], config: GetEmailsConfig, options?: GetEmailsOptions & {
     /** Delay between requests in ms (default: 100) */
     delayMs?: number;
     /** Max concurrent lookups (default: 3) */

package/dist/enrichment/matching.js

@@ -39,6 +39,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.salesLeadToContact = salesLeadToContact;
 exports.calculateMatchConfidence = calculateMatchConfidence;
 exports.classifyMatchQuality = classifyMatchQuality;
 exports.findBestMatch = findBestMatch;
@@ -52,6 +53,64 @@ exports.getEmailsForLinkedInContact = getEmailsForLinkedInContact;
 exports.getEmailsForLinkedInContactsBatch = getEmailsForLinkedInContactsBatch;
 const smartprospect_1 = require("./providers/smartprospect");
 const ldd_1 = require("./providers/ldd");
+/**
+ * Convert a Sales Navigator search result to LinkedInContact format.
+ * This allows consumers to pass raw Sales Nav entities directly.
+ *
+ * @param lead - Raw Sales Navigator lead search result
+ * @returns LinkedInContact compatible with email lookup functions
+ *
+ * @example
+ * ```typescript
+ * const searchResults = await searchSalesLeads('CEO', { filters });
+ * const contact = salesLeadToContact(searchResults.items[0]);
+ * const emails = await getEmailsForLinkedInContact(contact, config);
+ * ```
+ */
+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 || '';
+    return {
+        objectUrn: lead.objectUrn,
+        entityUrn: lead.salesProfileUrn,
+        firstName,
+        lastName,
+        fullName: lead.fullName || lead.name,
+        geoRegion: lead.geoRegion || lead.locationText,
+        currentPositions: lead.currentPositions?.map((pos) => ({
+            companyName: pos.companyName,
+            title: pos.title,
+            companyUrn: pos.companyUrn,
+            // Note: Sales Nav search does NOT return website in companyUrnResolutionResult
+            // We use LinkedIn Company Lookup to get website from companyUrn
+            companyUrnResolutionResult: pos.companyUrnResolutionResult
+                ? {
+                    name: pos.companyUrnResolutionResult.name,
+                    industry: pos.companyUrnResolutionResult.industry,
+                    location: pos.companyUrnResolutionResult.location,
+                }
+                : undefined,
+        })),
+    };
+}
+/**
+ * Type guard to check if input is a SalesLeadSearchResult
+ */
+function isSalesLeadSearchResult(input) {
+    // SalesLeadSearchResult has 'name' but not 'firstName'
+    return 'name' in input && !('firstName' in input);
+}
+/**
+ * Normalize input to LinkedInContact - accepts either format
+ */
+function normalizeToContact(input) {
+    if (isSalesLeadSearchResult(input)) {
+        return salesLeadToContact(input);
+    }
+    return input;
+}
 // =============================================================================
 // Utility Functions
 // =============================================================================
@@ -704,12 +763,14 @@ function createLinkedInEnricher(smartProspectConfig, defaultOptions = {}) {
  * }
  * ```
  */
-async function getEmailsForLinkedInContact(contact, config, options = {}) {
+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;
     // Extract numeric ID from objectUrn
     const numericLinkedInId = (0, ldd_1.extractNumericLinkedInId)(contact.objectUrn);
-    // Extract company domain from contact
-    const companyDomain = config.companyDomain || extractCompanyDomain(contact);
+    // Extract company domain from contact (LinkedIn data - often missing)
+    const linkedInCompanyDomain = config.companyDomain || extractCompanyDomain(contact);
     const result = {
         success: false,
         emails: [],
@@ -726,6 +787,8 @@ async function getEmailsForLinkedInContact(contact, config, options = {}) {
             result.emails.push(emailResult);
         }
     };
+    // Track company domain discovered from SmartProspect (since LinkedIn doesn't provide it)
+    let discoveredCompanyDomain = null;
     // ==========================================================================
     // Phase 1: FREE providers in PARALLEL (LDD + SmartProspect)
     // ==========================================================================
@@ -736,20 +799,62 @@ async function getEmailsForLinkedInContact(contact, config, options = {}) {
         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));
+        freeProviderPromises.push(querySmartProspect(contact, config.smartprospect, minMatchConfidence, includeCompany, addEmail, result)
+            .then((domain) => {
+            if (domain) {
+                discoveredCompanyDomain = domain;
+            }
+        }));
     }
     // Wait for both free providers
     await Promise.all(freeProviderPromises);
-    // Check if we have good enough results
-    const bestConfidence = result.emails.length > 0
+    // Check if we have good enough results already
+    const bestConfidenceAfterFreeProviders = result.emails.length > 0
         ? Math.max(...result.emails.map(e => e.confidence))
         : 0;
     // ==========================================================================
-    // Phase 2: Email pattern guessing with MX verification (FREE)
+    // Phase 2: Domain Discovery (if needed for pattern guessing)
+    // ==========================================================================
+    // Priority: LinkedIn contact data > SmartProspect > LinkedIn Company API
+    let companyDomain = linkedInCompanyDomain || discoveredCompanyDomain;
+    // If no domain yet and pattern guessing is enabled, try LinkedIn company lookup
+    if (!companyDomain &&
+        !skipPatternGuessing &&
+        !options.skipLinkedInCompanyLookup &&
+        config.linkedInCompanyLookup &&
+        bestConfidenceAfterFreeProviders < paidProviderThreshold) {
+        // Extract company ID from companyUrn
+        const companyUrn = contact.currentPositions?.[0]?.companyUrn;
+        if (companyUrn) {
+            const companyId = extractCompanyIdFromUrn(companyUrn);
+            if (companyId) {
+                result.providersQueried.push('linkedin');
+                try {
+                    const company = await config.linkedInCompanyLookup(companyId);
+                    if (company?.websiteUrl) {
+                        companyDomain = extractDomainFromUrl(company.websiteUrl);
+                        if (companyDomain) {
+                            discoveredCompanyDomain = companyDomain;
+                        }
+                    }
+                }
+                catch (err) {
+                    result.errors?.push(`LinkedIn: ${err instanceof Error ? err.message : 'Company lookup failed'}`);
+                }
+            }
+        }
+    }
+    // Store discovered domain in result for visibility
+    if (discoveredCompanyDomain && !linkedInCompanyDomain) {
+        result.discoveredCompanyDomain = discoveredCompanyDomain;
+    }
+    // ==========================================================================
+    // Phase 3: Email pattern guessing with MX verification (FREE)
     // ==========================================================================
-    if (!skipPatternGuessing && companyDomain && bestConfidence < paidProviderThreshold) {
+    if (!skipPatternGuessing && companyDomain && bestConfidenceAfterFreeProviders < paidProviderThreshold) {
         result.providersQueried.push('pattern');
         await queryPatternGuessing(contact, companyDomain, addEmail, result);
     }
@@ -774,9 +879,10 @@ async function getEmailsForLinkedInContact(contact, config, options = {}) {
     const sourcePriority = {
         ldd: 0, // Highest priority - your own data
         smartprospect: 1,
-        pattern: 2,
-        hunter: 3,
-        apollo: 4,
+        linkedin: 2, // LinkedIn company lookup (for domain discovery, doesn't provide emails)
+        pattern: 3,
+        hunter: 4,
+        apollo: 5,
     };
     result.emails.sort((a, b) => {
         if (b.confidence !== a.confidence) {
@@ -801,18 +907,36 @@ function extractCompanyDomain(contact) {
     // Try to get website from company resolution
     const website = pos.companyUrnResolutionResult?.website;
     if (website) {
-        // Extract domain from URL
-        try {
-            const url = website.startsWith('http') ? website : `https://${website}`;
-            return new URL(url).hostname.replace(/^www\./, '');
-        }
-        catch {
-            // If URL parsing fails, try as-is
-            return website.replace(/^(https?:\/\/)?(www\.)?/, '').split('/')[0];
-        }
+        return extractDomainFromUrl(website);
     }
     return null;
 }
+/**
+ * Extract domain from a URL string
+ */
+function extractDomainFromUrl(url) {
+    if (!url)
+        return null;
+    try {
+        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;
+    }
+}
+/**
+ * Extract company ID from a Sales Navigator company URN
+ * e.g., "urn:li:fs_salesCompany:108063139" → "108063139"
+ */
+function extractCompanyIdFromUrn(companyUrn) {
+    if (!companyUrn)
+        return null;
+    // Handle various URN formats
+    const match = companyUrn.match(/(\d+)$/);
+    return match ? match[1] : null;
+}
 /**
  * Query LDD provider
  */
@@ -843,13 +967,14 @@ async function queryLdd(contact, lddConfig, numericLinkedInId, addEmail, result)
 }
 /**
  * Query SmartProspect provider
+ * Returns the company domain if found (for pattern guessing fallback)
  */
 async function querySmartProspect(contact, smartProspectConfig, minMatchConfidence, includeCompany, addEmail, result) {
     try {
         const client = (0, smartprospect_1.createSmartProspectClient)(smartProspectConfig);
         if (!client) {
             result.errors?.push('SmartProspect: Failed to create client');
-            return;
+            return null;
         }
         // Build search filters
         const filters = buildSmartProspectFiltersFromLinkedIn(contact);
@@ -877,7 +1002,7 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
             }
         }
         if (searchResponse.data.list.length === 0) {
-            return; // No candidates found, but not an error
+            return null; // No candidates found, but not an error
         }
         // Find best match
         const matchResult = findBestMatch(contact, searchResponse.data.list, {
@@ -886,7 +1011,17 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
             fuzzyCompany: true,
         });
         if (!matchResult) {
-            return; // No good match, but not an error
+            return null; // No good match, but not an error
+        }
+        // Extract company domain from matched contact (SmartProspect provides this!)
+        const companyWebsite = matchResult.smartProspectContact.company?.website;
+        let discoveredDomain = null;
+        if (companyWebsite) {
+            // Clean up the domain (remove protocol, www, trailing slashes)
+            discoveredDomain = companyWebsite
+                .replace(/^(https?:\/\/)?(www\.)?/, '')
+                .split('/')[0]
+                .toLowerCase();
         }
         // Fetch email for matched contact
         const fetchResponse = await client.fetch([matchResult.smartProspectContact.id]);
@@ -905,14 +1040,17 @@ async function querySmartProspect(contact, smartProspectConfig, minMatchConfiden
                         matchedFields: matchResult.matchedFields,
                         smartProspectId: enrichedContact.id,
                         company: enrichedContact.company?.name,
+                        companyWebsite: companyWebsite,
                         title: enrichedContact.title,
                     },
                 });
             }
         }
+        return discoveredDomain;
     }
     catch (err) {
         result.errors?.push(`SmartProspect: ${err instanceof Error ? err.message : 'Unknown error'}`);
+        return null;
     }
 }
 /**
@@ -922,7 +1060,7 @@ 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: 6, timeoutMs: 3000 });
+        const constructProvider = createConstructProvider({ maxAttempts: 12, timeoutMs: 3000 });
         const constructResult = await constructProvider({
             firstName: contact.firstName,
             lastName: contact.lastName,
@@ -950,27 +1088,28 @@ async function queryPatternGuessing(contact, companyDomain, addEmail, result) {
  * Get emails for multiple LinkedIn contacts in batch
  *
  * Processes contacts with controlled concurrency to balance speed and rate limits.
+ * Accepts either LinkedInContact[] or SalesLeadSearchResult[] directly from Sales Nav search.
  */
-async function getEmailsForLinkedInContactsBatch(contacts, config, options = {}) {
+async function getEmailsForLinkedInContactsBatch(contactsOrLeads, config, options = {}) {
     const { delayMs = 100, concurrency = 3, onProgress, ...lookupOptions } = options;
-    const results = new Array(contacts.length);
+    const results = new Array(contactsOrLeads.length);
     let completed = 0;
     // Process in batches with concurrency limit
-    for (let i = 0; i < contacts.length; i += concurrency) {
-        const batch = contacts.slice(i, i + concurrency);
-        const batchPromises = batch.map(async (contact, batchIndex) => {
-            const result = await getEmailsForLinkedInContact(contact, config, lookupOptions);
+    for (let i = 0; i < contactsOrLeads.length; i += concurrency) {
+        const batch = contactsOrLeads.slice(i, i + concurrency);
+        const batchPromises = batch.map(async (contactOrLead, batchIndex) => {
+            const result = await getEmailsForLinkedInContact(contactOrLead, config, lookupOptions);
             const globalIndex = i + batchIndex;
             results[globalIndex] = result;
             completed++;
             if (onProgress) {
-                onProgress(completed, contacts.length, result);
+                onProgress(completed, contactsOrLeads.length, result);
             }
             return result;
         });
         await Promise.all(batchPromises);
         // Delay between batches (except for last batch)
-        if (i + concurrency < contacts.length && delayMs > 0) {
+        if (i + concurrency < contactsOrLeads.length && delayMs > 0) {
             await new Promise((r) => setTimeout(r, delayMs));
         }
     }

package/dist/enrichment/providers/construct.js

@@ -12,27 +12,39 @@ const personal_domains_1 = require("../utils/personal-domains");
 const validation_1 = require("../utils/validation");
 /**
  * Build all email pattern candidates for a person
+ *
+ * Patterns are ordered by commonality based on real-world email conventions:
+ * 1. firstname (most common for small companies)
+ * 2. firstname.lastname (most common for larger companies)
+ * 3. f.lastname, flastname, etc.
  */
 function buildCandidates(input) {
     const domain = String(input.domain || '').toLowerCase();
     const first = (0, validation_1.cleanNamePart)(input.first || '');
     const last = (0, validation_1.cleanNamePart)(input.last || '');
     const fl = first ? first[0] : '';
+    const ll = last ? last[0] : '';
     const locals = [];
-    // Patterns with both first and last name
+    // Simple first name pattern (very common, especially for small companies/startups)
+    if (first)
+        locals.push(first); // john
+    // Common combined patterns
     if (first && last) {
-        locals.push(`${first}.${last}`); // john.doe
-        locals.push(`${fl}.${last}`); // j.doe
-        locals.push(`${first}${last[0] ?? ''}`); // johnd
+        locals.push(`${first}.${last}`); // john.doe (most common corporate pattern)
         locals.push(`${fl}${last}`); // jdoe
+        locals.push(`${first}${ll}`); // johnd
+        locals.push(`${fl}.${last}`); // j.doe
+        locals.push(`${first}${last}`); // johndoe
         locals.push(`${first}_${last}`); // john_doe
         locals.push(`${last}.${first}`); // doe.john
+        locals.push(`${last}${first}`); // doejohn
+        locals.push(`${last}`); // doe (last name only)
+        locals.push(`${fl}${ll}`); // jd (initials)
     }
-    // Single name patterns
-    if (first)
-        locals.push(first); // john
-    if (last)
+    else if (last) {
+        // Only last name available
         locals.push(last); // doe
+    }
     // Deduplicate while preserving order
     const seen = new Set();
     const emails = [];

package/dist/parsers/company-parser.js

@@ -42,7 +42,7 @@ function parseCompany(raw) {
             data?.universalName ||
             r?.universalName),
         name: (miniCompany?.name || data?.name || r?.name),
-        websiteUrl: (data?.websiteUrl || r?.websiteUrl),
+        websiteUrl: (data?.websiteUrl || data?.website || r?.websiteUrl || r?.website),
         description: (data?.description || r?.description),
         sizeLabel: (typeof data?.employeeCountRange === "string"
             ? data.employeeCountRange

package/dist/types.d.ts

@@ -119,6 +119,9 @@ export interface LinkedInSpotlightBadge {
     }>;
 }
 export interface SalesLeadSearchResult {
+    firstName?: string;
+    lastName?: string;
+    fullName?: string;
     name?: string;
     headline?: string;
     imageUrl?: string;

package/package.json

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