linkedin-secret-sauce 0.5.0 → 0.6.0

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
  */
@@ -78,10 +130,24 @@ export interface ApolloConfig {
 }
 /**
  * SmartProspect/Smartlead provider configuration
+ *
+ * Supports two auth methods:
+ * 1. Direct token: Pass `apiToken` directly
+ * 2. Credentials: Pass `email` and `password` for auto-login with token caching
  */
 export interface SmartProspectConfig {
-    apiToken: string;
+    /** Direct API/JWT token (if you already have one) */
+    apiToken?: string;
+    /** SmartLead account email (for credentials-based auth) */
+    email?: string;
+    /** SmartLead account password (for credentials-based auth) */
+    password?: string;
+    /** API URL override (default: https://prospect-api.smartlead.ai/api/search-email-leads) */
     apiUrl?: string;
+    /** Login URL override (default: https://server.smartlead.ai/api/auth/login) */
+    loginUrl?: string;
+    /** Pre-fetch token on client creation (default: true) - ensures token is ready for first request */
+    eagerInit?: boolean;
 }
 /**
  * LinkedIn Data Dump provider configuration
@@ -179,17 +245,21 @@ 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
  */
-export type ProviderName = 'construct' | 'ldd' | 'smartprospect' | 'hunter' | 'apollo' | 'dropcontact';
+export type ProviderName = "construct" | "ldd" | "smartprospect" | "hunter" | "apollo" | "dropcontact";
 /**
  * Default provider order
  */
@@ -207,7 +277,7 @@ export interface VerificationResult {
     /** Confidence score 0-100 */
     confidence: number;
     /** Reason for the result */
-    reason?: 'valid' | 'invalid' | 'syntax' | 'mx_missing' | 'disposable' | 'role_account' | 'catch_all' | 'timeout' | 'error';
+    reason?: "valid" | "invalid" | "syntax" | "mx_missing" | "disposable" | "role_account" | "catch_all" | "timeout" | "error";
     /** Whether this is a catch-all domain */
     isCatchAll: boolean;
     /** Whether this is a role account (info@, support@, etc.) */
@@ -246,26 +316,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;
@@ -276,6 +397,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;

package/dist/enrichment/types.js

@@ -6,17 +6,17 @@
  * 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
  */
 exports.DEFAULT_PROVIDER_ORDER = [
-    'construct',
-    'ldd',
-    'smartprospect',
-    'hunter',
-    'apollo',
-    'dropcontact',
+    "construct",
+    "ldd",
+    "smartprospect",
+    "hunter",
+    "apollo",
+    "dropcontact",
 ];
 /**
  * Provider costs in USD per lookup
@@ -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/index.d.ts

@@ -14,4 +14,5 @@ export type { RequestHistoryEntry } from "./utils/request-history";
 export * from "./constants";
 export { createEnrichmentClient } from "./enrichment";
 export type { CanonicalEmail, EnrichmentCandidate, ProviderResult, ProviderFunc, ProviderName, EnrichmentClientConfig, EnrichmentClient, ProvidersConfig, EnrichmentOptions, BatchEnrichmentOptions, HunterConfig, ApolloConfig, SmartProspectConfig, LddConfig, DropcontactConfig, ConstructConfig, CacheAdapter, CostCallback, EnrichmentLogger, VerificationResult, SmartProspectContact, SmartProspectSearchFilters, LddProfileData, LddApiResponse, } from "./enrichment";
-export { isPersonalEmail, isBusinessEmail, isPersonalDomain, isDisposableEmail, isDisposableDomain, isValidEmailSyntax, isRoleAccount, verifyEmailMx, PERSONAL_DOMAINS, DISPOSABLE_DOMAINS, DEFAULT_PROVIDER_ORDER, PROVIDER_COSTS, } from "./enrichment";
+export { isPersonalEmail, isBusinessEmail, isPersonalDomain, isDisposableEmail, isDisposableDomain, isValidEmailSyntax, isRoleAccount, verifyEmailMx, PERSONAL_DOMAINS, DISPOSABLE_DOMAINS, DEFAULT_PROVIDER_ORDER, PROVIDER_COSTS, getSmartLeadToken, getSmartLeadUser, clearSmartLeadToken, clearAllSmartLeadTokens, getSmartLeadTokenCacheStats, } from "./enrichment";
+export type { SmartLeadCredentials, SmartLeadAuthConfig, SmartLeadUser, SmartLeadLoginResponse, } from "./enrichment";

package/dist/index.js

@@ -14,7 +14,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.PROVIDER_COSTS = exports.DEFAULT_PROVIDER_ORDER = exports.DISPOSABLE_DOMAINS = exports.PERSONAL_DOMAINS = exports.verifyEmailMx = exports.isRoleAccount = exports.isValidEmailSyntax = exports.isDisposableDomain = exports.isDisposableEmail = exports.isPersonalDomain = exports.isBusinessEmail = exports.isPersonalEmail = exports.createEnrichmentClient = exports.clearRequestHistory = exports.getRequestHistory = exports.parseSalesSearchResults = exports.parseFullProfile = exports.LinkedInClientError = exports.getConfig = exports.initializeLinkedInClient = void 0;
+exports.getSmartLeadTokenCacheStats = exports.clearAllSmartLeadTokens = exports.clearSmartLeadToken = exports.getSmartLeadUser = exports.getSmartLeadToken = exports.PROVIDER_COSTS = exports.DEFAULT_PROVIDER_ORDER = exports.DISPOSABLE_DOMAINS = exports.PERSONAL_DOMAINS = exports.verifyEmailMx = exports.isRoleAccount = exports.isValidEmailSyntax = exports.isDisposableDomain = exports.isDisposableEmail = exports.isPersonalDomain = exports.isBusinessEmail = exports.isPersonalEmail = exports.createEnrichmentClient = exports.clearRequestHistory = exports.getRequestHistory = exports.parseSalesSearchResults = exports.parseFullProfile = exports.LinkedInClientError = exports.getConfig = exports.initializeLinkedInClient = void 0;
 var config_1 = require("./config");
 Object.defineProperty(exports, "initializeLinkedInClient", { enumerable: true, get: function () { return config_1.initializeLinkedInClient; } });
 Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return config_1.getConfig; } });
@@ -52,3 +52,9 @@ Object.defineProperty(exports, "PERSONAL_DOMAINS", { enumerable: true, get: func
 Object.defineProperty(exports, "DISPOSABLE_DOMAINS", { enumerable: true, get: function () { return enrichment_2.DISPOSABLE_DOMAINS; } });
 Object.defineProperty(exports, "DEFAULT_PROVIDER_ORDER", { enumerable: true, get: function () { return enrichment_2.DEFAULT_PROVIDER_ORDER; } });
 Object.defineProperty(exports, "PROVIDER_COSTS", { enumerable: true, get: function () { return enrichment_2.PROVIDER_COSTS; } });
+// SmartLead Auth
+Object.defineProperty(exports, "getSmartLeadToken", { enumerable: true, get: function () { return enrichment_2.getSmartLeadToken; } });
+Object.defineProperty(exports, "getSmartLeadUser", { enumerable: true, get: function () { return enrichment_2.getSmartLeadUser; } });
+Object.defineProperty(exports, "clearSmartLeadToken", { enumerable: true, get: function () { return enrichment_2.clearSmartLeadToken; } });
+Object.defineProperty(exports, "clearAllSmartLeadTokens", { enumerable: true, get: function () { return enrichment_2.clearAllSmartLeadTokens; } });
+Object.defineProperty(exports, "getSmartLeadTokenCacheStats", { enumerable: true, get: function () { return enrichment_2.getSmartLeadTokenCacheStats; } });

package/package.json

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