linkedin-secret-sauce 0.5.1 → 0.7.1

package/dist/enrichment/types.d.ts

@@ -30,10 +30,62 @@ export interface ProviderResult {
     score?: number;
     confidence?: number;
 }
+/**
+ * Extended provider result that can return multiple emails
+ */
+export interface ProviderMultiResult {
+    emails: Array<{
+        email: string;
+        verified?: boolean;
+        confidence?: number;
+        isCatchAll?: boolean;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Email type classification
+ */
+export type EmailType = 'business' | 'personal' | 'disposable' | 'role' | 'unknown';
+/**
+ * Individual enriched email with full metadata
+ */
+export interface EnrichedEmail {
+    /** The email address */
+    email: string;
+    /** Which provider found this email */
+    source: ProviderName;
+    /** Confidence score (0-100) */
+    confidence: number;
+    /** Whether the email was verified */
+    verified: boolean;
+    /** Email type classification */
+    type: EmailType;
+    /** Whether this is a catch-all domain */
+    isCatchAll?: boolean;
+    /** ISO timestamp of when this was found */
+    foundAt: string;
+    /** Additional provider-specific metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Result containing all found emails from all providers
+ */
+export interface MultiEmailResult {
+    /** All found emails, sorted by confidence (highest first) */
+    emails: EnrichedEmail[];
+    /** The original candidate */
+    candidate: EnrichmentCandidate;
+    /** Total cost incurred across all providers */
+    totalCost: number;
+    /** List of providers that were queried */
+    providersQueried: ProviderName[];
+    /** ISO timestamp of when enrichment completed */
+    completedAt: string;
+}
 /**
  * Provider function signature
  */
-export type ProviderFunc = (candidate: EnrichmentCandidate) => Promise<ProviderResult | null>;
+export type ProviderFunc = (candidate: EnrichmentCandidate) => Promise<ProviderResult | ProviderMultiResult | null>;
 /**
  * Input candidate for enrichment - flexible to accept various naming conventions
  */
@@ -60,6 +112,10 @@ export interface EnrichmentCandidate {
     linkedin_url?: string;
     linkedinId?: string;
     linkedin_id?: string;
+    numericLinkedInId?: string;
+    numeric_linkedin_id?: string;
+    objectUrn?: string;
+    object_urn?: string;
     title?: string;
     currentRole?: string;
     current_role?: string;
@@ -193,12 +249,16 @@ export interface EnrichmentClientConfig {
  * Enrichment client interface
  */
 export interface EnrichmentClient {
-    /** Enrich a single candidate */
+    /** Enrich a single candidate - returns first valid business email (original behavior) */
     enrich: (candidate: EnrichmentCandidate) => Promise<CanonicalEmail>;
-    /** Enrich multiple candidates in batches */
+    /** Enrich multiple candidates in batches - returns first valid business email per candidate */
     enrichBatch: (candidates: EnrichmentCandidate[], options?: BatchEnrichmentOptions) => Promise<Array<{
         candidate: EnrichmentCandidate;
     } & CanonicalEmail>>;
+    /** Enrich a single candidate - returns ALL found emails from ALL providers */
+    enrichAll: (candidate: EnrichmentCandidate) => Promise<MultiEmailResult>;
+    /** Enrich multiple candidates - returns ALL found emails for each candidate */
+    enrichAllBatch: (candidates: EnrichmentCandidate[], options?: BatchEnrichmentOptions) => Promise<MultiEmailResult[]>;
 }
 /**
  * Available provider names
@@ -260,26 +320,77 @@ export interface SmartProspectContact {
     verificationStatus?: string;
     catchAllStatus?: string;
 }
+/**
+ * SmartProspect Search Filters
+ *
+ * Comprehensive filter interface matching SmartProspect/Smartlead's actual API.
+ * Field names and values match their exact API structure.
+ */
 export interface SmartProspectSearchFilters {
+    /** Full name (searches across first + last) */
     name?: string[];
+    /** First name only */
     firstName?: string[];
+    /** Last name only */
     lastName?: string[];
+    /** Job titles to search (free text, e.g., "CEO", "Software Engineer") */
     title?: string[];
-    company?: string[];
-    domain?: string[];
-    department?: string[];
-    level?: string[];
-    industry?: string[];
+    /** Whether to match titles exactly (default: false) */
+    titleExactMatch?: boolean;
+    /** Departments - must use exact API values */
+    department?: SmartProspectDepartment[];
+    /** Seniority levels - must use exact API values */
+    level?: SmartProspectLevel[];
+    /** Company names (e.g., "Google", "Microsoft") */
+    companyName?: string[];
+    /** Company domains (e.g., "google.com", "microsoft.com") */
+    companyDomain?: string[];
+    /** Industries - must use exact API values */
+    companyIndustry?: SmartProspectIndustry[];
+    /** Sub-industries - must use exact API values */
+    companySubIndustry?: string[];
+    /** Headcount ranges - must use exact API values */
+    companyHeadCount?: SmartProspectHeadcount[];
+    /** Revenue ranges - must use exact API values */
+    companyRevenue?: SmartProspectRevenue[];
+    /** Countries (e.g., "United States", "United Kingdom", "Germany") */
     country?: string[];
+    /** States with country (e.g., "California, United States", "Bavaria, Germany") */
     state?: string[];
+    /** Cities with state and country (e.g., "San Francisco, California, United States") */
     city?: string[];
-    companyHeadCount?: string[];
-    companyRevenue?: string[];
+    /** Don't include contacts already owned/in campaigns (default: true) */
     dontDisplayOwnedContact?: boolean;
+    /** Number of results to return (default: 25, max: 100) */
     limit?: number;
-    titleExactMatch?: boolean;
+    /** Scroll ID for cursor-based pagination (from previous response) */
     scroll_id?: string;
 }
+/**
+ * SmartProspect Department values (exact API values)
+ */
+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';
+/**
+ * SmartProspect Headcount ranges (exact API values)
+ */
+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';
+/**
+ * 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';
+/**
+ * SmartProspect Sub-Industry values (exact API values - partial list)
+ * Note: This is a subset of available sub-industries. The API accepts many more.
+ */
+export declare const SMARTPROSPECT_SUB_INDUSTRIES: readonly ["Internet", "Information Technology and Services", "Information Services", "Computer Software", "Computer & Network Security", "Computer Games", "Glass, Ceramics & Concrete", "Construction", "Commercial Real Estate", "Civil Engineering", "Building Materials", "Architecture & Planning", "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"];
 export interface SmartProspectSearchResponse {
     success: boolean;
     message: string;
@@ -290,6 +401,27 @@ export interface SmartProspectSearchResponse {
         total_count: number;
     };
 }
+/**
+ * SmartProspect Location lookup response (countries, states, cities)
+ */
+export interface SmartProspectLocationItem {
+    id: number;
+    country_name?: string;
+    state_name?: string;
+    city_name?: string;
+}
+export interface SmartProspectLocationResponse {
+    success: boolean;
+    message: string;
+    data: SmartProspectLocationItem[];
+    pagination: {
+        limit: number;
+        offset: number;
+        page: number;
+        count: number;
+    };
+    search: string | null;
+}
 export interface SmartProspectFetchResponse {
     success: boolean;
     message: string;
@@ -308,6 +440,30 @@ export interface SmartProspectFetchResponse {
         leads_found: number;
         email_fetched: number;
         verification_status_list: string[];
+        /** Filter ID returned by fetch-contacts for polling */
+        filter_id?: string;
+        /** Status of the fetch operation: "pending" means still processing */
+        status?: string;
+    };
+}
+/**
+ * Response from get-contacts polling endpoint
+ */
+export interface SmartProspectGetContactsResponse {
+    success: boolean;
+    message: string;
+    data: {
+        list: SmartProspectContact[];
+        total_count: number;
+        metrics: {
+            totalContacts: number;
+            totalEmails: number;
+            noEmailFound: number;
+            invalidEmails: number;
+            catchAllEmails: number;
+            verifiedEmails: number;
+            completed: number;
+        };
     };
 }
 export interface LddProfileEmail {

package/dist/enrichment/types.js

@@ -6,7 +6,7 @@
  * stateless - consumers pass their own API keys and configuration.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PROVIDER_COSTS = exports.DEFAULT_PROVIDER_ORDER = void 0;
+exports.SMARTPROSPECT_SUB_INDUSTRIES = exports.PROVIDER_COSTS = exports.DEFAULT_PROVIDER_ORDER = void 0;
 /**
  * Default provider order
  */
@@ -29,3 +29,52 @@ exports.PROVIDER_COSTS = {
     apollo: 0,
     dropcontact: 0.01,
 };
+/**
+ * SmartProspect Sub-Industry values (exact API values - partial list)
+ * Note: This is a subset of available sub-industries. The API accepts many more.
+ */
+exports.SMARTPROSPECT_SUB_INDUSTRIES = [
+    // Software & Internet
+    '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',
+    // 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',
+];

package/dist/http-client.js

@@ -44,7 +44,7 @@ const linkedin_config_1 = require("./utils/linkedin-config");
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-function isRetryableStatus(status) {
+function _isRetryableStatus(status) {
     return (status === 429 ||
         status === 500 ||
         status === 502 ||

package/dist/linkedin-api.d.ts

@@ -1,5 +1,4 @@
-import type { SalesSearchFilters } from "./types";
-import type { LinkedInProfile, SearchSalesResult, TypeaheadResult, SalesNavigatorProfile, Company } from "./types";
+import type { SalesSearchFilters, LinkedInProfile, SearchSalesResult, TypeaheadResult, SalesNavigatorProfile, Company } from "./types";
 /**
  * Fetches a LinkedIn profile by vanity URL (public identifier).
  * Results are cached for the configured TTL (default: 15 minutes).

package/dist/parsers/profile-parser.js

@@ -102,15 +102,17 @@ function parseFullProfile(rawResponse, vanity) {
     function deepFindCompanyUrn(obj, depth = 0) {
         if (!obj || depth > 3)
             return undefined;
-        if (typeof obj === "string" && /urn:li:(?:fsd_)?company:/i.test(obj))
+        if (typeof obj === "string" && /urn:li:(?:fsd_)?company:/i.test(obj)) {
             return obj;
+        }
         if (typeof obj !== "object")
             return undefined;
         const rec = obj;
         for (const k of Object.keys(rec)) {
             const v = rec[k];
-            if (typeof v === "string" && /urn:li:(?:fsd_)?company:/i.test(v))
+            if (typeof v === "string" && /urn:li:(?:fsd_)?company:/i.test(v)) {
                 return v;
+            }
             if (v && typeof v === "object") {
                 const hit = deepFindCompanyUrn(v, depth + 1);
                 if (hit)

package/dist/utils/linkedin-config.js

@@ -52,7 +52,7 @@ function buildVoyagerHeaders(opts) {
         "x-li-track": JSON.stringify(trackPayload),
         "sec-fetch-site": "same-origin",
         "sec-fetch-mode": "cors",
-        referer: referer ?? exports.defaultOrigin + "/",
+        referer: referer ?? `${exports.defaultOrigin}/`,
         origin: exports.defaultOrigin,
     };
 }

package/dist/utils/search-encoder.js

@@ -13,22 +13,21 @@ exports.buildLeadSearchQuery = buildLeadSearchQuery;
 function stableStringify(obj) {
     if (obj === null || typeof obj !== "object")
         return JSON.stringify(obj);
-    if (Array.isArray(obj))
-        return "[" + obj.map((v) => stableStringify(v)).join(",") + "]";
+    if (Array.isArray(obj)) {
+        return `[${obj.map((v) => stableStringify(v)).join(",")}]`;
+    }
     const rec = obj;
     const keys = Object.keys(rec).sort();
-    return ("{" +
-        keys
-            .map((k) => JSON.stringify(k) + ":" + stableStringify(rec[k]))
-            .join(",") +
-        "}");
+    return (`{${keys
+        .map((k) => `${JSON.stringify(k)}:${stableStringify(rec[k])}`)
+        .join(",")}}`);
 }
 function buildFilterSignature(filters, rawQuery) {
     if (rawQuery)
-        return "rq:" + String(rawQuery).trim();
+        return `rq:${String(rawQuery).trim()}`;
     if (!filters)
         return undefined;
-    return "f:" + stableStringify(filters);
+    return `f:${stableStringify(filters)}`;
 }
 // Temporary minimal encoder: today we include only keywords in the query structure to
 // preserve existing behavior. Once facet ids are confirmed, extend this to encode filters

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linkedin-secret-sauce",
-  "version": "0.5.1",
+  "version": "0.7.1",
   "description": "Private LinkedIn Sales Navigator client with automatic cookie management",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -10,6 +10,26 @@
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
   },
+  "scripts": {
+    "dev:playground": "pnpm -C apps/playground dev",
+    "search": "node scripts/rg-fast.mjs",
+    "rg:fast": "node scripts/rg-fast.mjs",
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "typecheck:playground": "pnpm -C apps/playground typecheck",
+    "typecheck:all": "pnpm typecheck && pnpm typecheck:playground",
+    "lint": "eslint \"src/**/*.ts\" --max-warnings=0",
+    "lint:playground": "eslint \"apps/playground/src/**/*.{ts,tsx}\" \"apps/playground/server/**/*.ts\" --max-warnings=0",
+    "lint:all": "eslint \"src/**/*.ts\" \"apps/playground/src/**/*.{ts,tsx}\" \"apps/playground/server/**/*.ts\" --max-warnings=0",
+    "lint:fix": "eslint \"src/**/*.ts\" \"apps/playground/src/**/*.{ts,tsx}\" \"apps/playground/server/**/*.ts\" --fix",
+    "check": "pnpm typecheck:all && pnpm lint:all",
+    "dev": "tsc -w -p tsconfig.json",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build",
+    "release:patch": "npm version patch && git push --follow-tags",
+    "release:minor": "npm version minor && git push --follow-tags",
+    "release:major": "npm version major && git push --follow-tags"
+  },
   "keywords": [
     "linkedin",
     "sales-navigator",
@@ -39,18 +59,5 @@
     "husky": "^9.0.11",
     "typescript": "^5.9.3",
     "vitest": "^1.6.0"
-  },
-  "scripts": {
-    "dev:playground": "pnpm -C apps/playground dev",
-    "search": "node scripts/rg-fast.mjs",
-    "rg:fast": "node scripts/rg-fast.mjs",
-    "build": "tsc -p tsconfig.json",
-    "lint": "eslint \"src/**/*.ts\" --max-warnings=0",
-    "lint:fix": "eslint \"src/**/*.ts\" --fix",
-    "dev": "tsc -w -p tsconfig.json",
-    "test": "vitest run",
-    "release:patch": "npm version patch && git push --follow-tags",
-    "release:minor": "npm version minor && git push --follow-tags",
-    "release:major": "npm version major && git push --follow-tags"
   }
-}
+}