linkedin-secret-sauce 0.12.1 → 0.12.2

package/dist/enrichment/utils/validation.js

@@ -1,8 +1,9 @@
 "use strict";
 /**
- * Email Validation Utilities
+ * Email and Candidate Validation Utilities
  *
- * Provides email syntax validation and name parsing utilities.
+ * Provides email syntax validation, name parsing utilities,
+ * and EnrichmentCandidate validation.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidEmailSyntax = isValidEmailSyntax;
@@ -11,6 +12,15 @@ exports.asciiFold = asciiFold;
 exports.cleanNamePart = cleanNamePart;
 exports.hostnameFromUrl = hostnameFromUrl;
 exports.extractLinkedInUsername = extractLinkedInUsername;
+exports.isValidDomain = isValidDomain;
+exports.isValidLinkedInUrl = isValidLinkedInUrl;
+exports.validateCandidate = validateCandidate;
+exports.validateCandidates = validateCandidates;
+exports.filterValidCandidates = filterValidCandidates;
+const candidate_parser_1 = require("./candidate-parser");
+// =============================================================================
+// Email Syntax Validation
+// =============================================================================
 /**
  * Validate email syntax
  *
@@ -18,17 +28,17 @@ exports.extractLinkedInUsername = extractLinkedInUsername;
  * @returns true if the email has valid syntax
  */
 function isValidEmailSyntax(email) {
-    if (!email || typeof email !== 'string')
+    if (!email || typeof email !== "string")
         return false;
-    if (email.includes(' '))
+    if (email.includes(" "))
         return false;
-    const parts = email.split('@');
+    const parts = email.split("@");
     if (parts.length !== 2)
         return false;
     const [local, domain] = parts;
     if (!local || !domain)
         return false;
-    if (!domain.includes('.'))
+    if (!domain.includes("."))
         return false;
     if (local.length > 64)
         return false;
@@ -79,13 +89,16 @@ function isRoleAccount(email) {
     const emailLower = email.toLowerCase();
     return ROLE_PATTERNS.some((pattern) => pattern.test(emailLower));
 }
+// =============================================================================
+// Name Utilities
+// =============================================================================
 /**
  * ASCII fold diacritics for name normalization
- * e.g., "Jos" -> "Jose", "Mller" -> "Muller"
+ * e.g., "José" -> "Jose", "Müller" -> "Muller"
  */
 function asciiFold(s) {
     try {
-        return s.normalize('NFD').replace(/\p{Diacritic}+/gu, '');
+        return s.normalize("NFD").replace(/\p{Diacritic}+/gu, "");
     }
     catch {
         return s;
@@ -95,9 +108,12 @@ function asciiFold(s) {
  * Clean name part: lowercase, remove diacritics, keep only a-z0-9
  */
 function cleanNamePart(s) {
-    const lower = asciiFold(String(s || '').toLowerCase());
-    return lower.replace(/[^a-z0-9]/g, '');
+    const lower = asciiFold(String(s || "").toLowerCase());
+    return lower.replace(/[^a-z0-9]/g, "");
 }
+// =============================================================================
+// URL Utilities
+// =============================================================================
 /**
  * Extract hostname from URL
  *
@@ -110,7 +126,7 @@ function hostnameFromUrl(url) {
     try {
         const u = new URL(url);
         const h = u.hostname.toLowerCase();
-        return h.startsWith('www.') ? h.slice(4) : h;
+        return h.startsWith("www.") ? h.slice(4) : h;
     }
     catch {
         return null;
@@ -128,3 +144,140 @@ function extractLinkedInUsername(url) {
     const match = url.match(/linkedin\.com\/in\/([^/?]+)/);
     return match ? match[1] : null;
 }
+/**
+ * Domain regex pattern
+ */
+const DOMAIN_REGEX = /^[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(\.[a-zA-Z0-9]([a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*\.[a-zA-Z]{2,}$/;
+/**
+ * LinkedIn URL pattern
+ */
+const LINKEDIN_URL_REGEX = /linkedin\.com\/in\/[a-zA-Z0-9_-]+/i;
+/**
+ * Validate a domain format
+ */
+function isValidDomain(domain) {
+    if (!domain || typeof domain !== "string") {
+        return false;
+    }
+    return DOMAIN_REGEX.test(domain.trim().toLowerCase());
+}
+/**
+ * Validate a LinkedIn URL format
+ */
+function isValidLinkedInUrl(url) {
+    if (!url || typeof url !== "string") {
+        return false;
+    }
+    return LINKEDIN_URL_REGEX.test(url);
+}
+/**
+ * Validate an EnrichmentCandidate object
+ *
+ * Checks for:
+ * - At least one name field present
+ * - Valid domain format (if provided)
+ * - Valid LinkedIn URL format (if provided)
+ * - No completely empty candidate
+ *
+ * @param candidate - The candidate to validate
+ * @returns Validation result with errors and warnings
+ *
+ * @example
+ * ```typescript
+ * const result = validateCandidate({
+ *   firstName: "John",
+ *   lastName: "Doe",
+ *   domain: "example.com"
+ * });
+ *
+ * if (!result.valid) {
+ *   console.error("Invalid candidate:", result.errors);
+ * }
+ * ```
+ */
+function validateCandidate(candidate) {
+    const errors = [];
+    const warnings = [];
+    // Check if candidate is an object
+    if (!candidate || typeof candidate !== "object") {
+        return {
+            valid: false,
+            errors: ["Candidate must be a non-null object"],
+            warnings: [],
+        };
+    }
+    // Parse the candidate to get normalized fields
+    const parsed = (0, candidate_parser_1.parseCandidate)(candidate);
+    // Check for at least some identifying information
+    const hasName = !!parsed.name.firstName || !!parsed.name.lastName || !!parsed.name.fullName;
+    const hasLinkedIn = !!parsed.linkedin.username ||
+        !!parsed.linkedin.url ||
+        !!parsed.linkedin.numericId;
+    const hasDomain = !!parsed.company.domain;
+    const hasCompany = !!parsed.company.company;
+    if (!hasName && !hasLinkedIn) {
+        errors.push("Candidate must have at least a name or LinkedIn identifier");
+    }
+    // Validate domain format if provided
+    if (parsed.company.domain) {
+        // Remove common protocol prefixes that users might accidentally include
+        const cleanDomain = parsed.company.domain
+            .toLowerCase()
+            .replace(/^(https?:\/\/)?(www\.)?/, "");
+        if (!isValidDomain(cleanDomain)) {
+            errors.push(`Invalid domain format: "${parsed.company.domain}"`);
+        }
+    }
+    // Validate LinkedIn URL if provided
+    if (parsed.linkedin.url) {
+        if (!isValidLinkedInUrl(parsed.linkedin.url)) {
+            warnings.push(`LinkedIn URL may be invalid: "${parsed.linkedin.url}"`);
+        }
+    }
+    // Warn if name is very short (might be initial only)
+    if (parsed.name.firstName && parsed.name.firstName.length === 1) {
+        warnings.push("First name appears to be an initial - results may be less accurate");
+    }
+    // Warn if no domain/company for providers that need it
+    if (!hasDomain && !hasCompany && hasName && !hasLinkedIn) {
+        warnings.push("No domain or company provided - only LinkedIn-based providers will work");
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/**
+ * Validate a batch of candidates
+ *
+ * @param candidates - Array of candidates to validate
+ * @returns Array of validation results with index
+ */
+function validateCandidates(candidates) {
+    return candidates.map((candidate, index) => ({
+        index,
+        candidate,
+        result: validateCandidate(candidate),
+    }));
+}
+/**
+ * Filter valid candidates from a batch
+ *
+ * @param candidates - Array of candidates to filter
+ * @returns Object with valid candidates and rejected ones with reasons
+ */
+function filterValidCandidates(candidates) {
+    const valid = [];
+    const invalid = [];
+    candidates.forEach((candidate, index) => {
+        const result = validateCandidate(candidate);
+        if (result.valid) {
+            valid.push(candidate);
+        }
+        else {
+            invalid.push({ index, candidate, errors: result.errors });
+        }
+    });
+    return { valid, invalid };
+}

package/dist/linkedin-api.d.ts

@@ -1,4 +1,4 @@
-import type { SalesSearchFilters, LinkedInProfile, SearchSalesResult, TypeaheadResult, SalesNavigatorProfile, Company } from "./types";
+import type { SalesSearchFilters, LinkedInProfile, SearchSalesResult, TypeaheadResult, SalesNavigatorProfile, SalesNavigatorProfileFull, Company } from "./types";
 /**
  * Fetches a LinkedIn profile by vanity URL (public identifier).
  * Results are cached for the configured TTL (default: 15 minutes).
@@ -128,3 +128,42 @@ export declare function getYearsInPositionOptions(): Promise<TypeaheadResult>;
  */
 export declare function getYearsOfExperienceOptions(): Promise<TypeaheadResult>;
 export declare function getSalesNavigatorProfileDetails(profileUrnOrId: string): Promise<SalesNavigatorProfile>;
+/**
+ * Fetches full Sales Navigator profile data including flagshipProfileUrl (LinkedIn handle).
+ * This is a more complete version that returns all available profile data.
+ *
+ * The key use case is extracting the LinkedIn handle from flagshipProfileUrl
+ * for use with email finder services like Hunter.io.
+ *
+ * @param profileUrnOrId - Profile identifier in any of these formats:
+ *   - Sales profile URN: "urn:li:fs_salesProfile:(ABC123xyz,NAME_SEARCH,abc)"
+ *   - FSD profile URN: "urn:li:fsd_profile:ABC123xyz"
+ *   - Bare key: "ABC123xyz"
+ * @returns Full Sales Navigator profile with flagshipProfileUrl, contactInfo, positions, etc.
+ * @throws LinkedInClientError with code NOT_FOUND if profile doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const profile = await getSalesNavigatorProfileFull('urn:li:fs_salesProfile:(ABC123,NAME_SEARCH,xyz)');
+ * console.log(profile.flagshipProfileUrl); // "https://www.linkedin.com/in/john-doe"
+ *
+ * // Extract LinkedIn handle for Hunter.io
+ * const handle = extractLinkedInHandle(profile.flagshipProfileUrl);
+ * console.log(handle); // "john-doe"
+ * ```
+ */
+export declare function getSalesNavigatorProfileFull(profileUrnOrId: string): Promise<SalesNavigatorProfileFull>;
+/**
+ * Extracts LinkedIn handle/vanity from a flagship profile URL.
+ *
+ * @param flagshipProfileUrl - Full LinkedIn profile URL (e.g., "https://www.linkedin.com/in/john-doe")
+ * @returns LinkedIn handle/vanity (e.g., "john-doe") or null if not found
+ *
+ * @example
+ * ```typescript
+ * extractLinkedInHandle("https://www.linkedin.com/in/john-doe"); // "john-doe"
+ * extractLinkedInHandle("https://www.linkedin.com/in/georgi-metodiev-tech2rec"); // "georgi-metodiev-tech2rec"
+ * extractLinkedInHandle(null); // null
+ * ```
+ */
+export declare function extractLinkedInHandle(flagshipProfileUrl: string | null | undefined): string | null;

package/dist/linkedin-api.js

@@ -47,6 +47,8 @@ exports.getYearsAtCompanyOptions = getYearsAtCompanyOptions;
 exports.getYearsInPositionOptions = getYearsInPositionOptions;
 exports.getYearsOfExperienceOptions = getYearsOfExperienceOptions;
 exports.getSalesNavigatorProfileDetails = getSalesNavigatorProfileDetails;
+exports.getSalesNavigatorProfileFull = getSalesNavigatorProfileFull;
+exports.extractLinkedInHandle = extractLinkedInHandle;
 const config_1 = require("./config");
 const http_client_1 = require("./http-client");
 const profile_parser_1 = require("./parsers/profile-parser");
@@ -57,27 +59,23 @@ const metrics_1 = require("./utils/metrics");
 const logger_1 = require("./utils/logger");
 const errors_1 = require("./utils/errors");
 const constants_1 = require("./constants");
+const lru_cache_1 = require("./utils/lru-cache");
 const LINKEDIN_API_BASE = "https://www.linkedin.com/voyager/api";
 const SALES_NAV_BASE = "https://www.linkedin.com/sales-api";
-// In-memory caches (per-process)
-const profileCacheByVanity = new Map();
-const profileCacheByUrn = new Map();
-const searchCache = new Map();
-// New caches for Phase 2
-const companyCache = new Map();
-const typeaheadCache = new Map();
+// Cache size limits to prevent unbounded memory growth
+const PROFILE_CACHE_MAX_SIZE = 1000;
+const SEARCH_CACHE_MAX_SIZE = 500;
+const COMPANY_CACHE_MAX_SIZE = 500;
+const TYPEAHEAD_CACHE_MAX_SIZE = 200;
+// In-memory LRU caches (per-process) with size limits
+const profileCacheByVanity = new lru_cache_1.LRUCache(PROFILE_CACHE_MAX_SIZE);
+const profileCacheByUrn = new lru_cache_1.LRUCache(PROFILE_CACHE_MAX_SIZE);
+const searchCache = new lru_cache_1.LRUCache(SEARCH_CACHE_MAX_SIZE);
+// Caches for Phase 2
+const companyCache = new lru_cache_1.LRUCache(COMPANY_CACHE_MAX_SIZE);
+const typeaheadCache = new lru_cache_1.LRUCache(TYPEAHEAD_CACHE_MAX_SIZE);
 // In-flight dedupe for profiles by vanity
 const inflightByVanity = new Map();
-function getCached(map, key, ttl) {
-    const entry = map.get(key);
-    if (!entry)
-        return null;
-    if (ttl && ttl > 0 && Date.now() - entry.ts > ttl) {
-        map.delete(key);
-        return null;
-    }
-    return entry.data;
-}
 /**
  * Fetches a LinkedIn profile by vanity URL (public identifier).
  * Results are cached for the configured TTL (default: 15 minutes).
@@ -104,7 +102,7 @@ async function getProfileByVanity(vanity) {
     }
     catch { }
     // Cache
-    const cached = getCached(profileCacheByVanity, key, cfg.profileCacheTtl);
+    const cached = profileCacheByVanity.get(key, cfg.profileCacheTtl);
     if (cached) {
         (0, metrics_1.incrementMetric)("profileCacheHits");
         return cached;
@@ -151,7 +149,7 @@ async function getProfileByVanity(vanity) {
                 catch { }
                 throw new errors_1.LinkedInClientError("Failed to parse profile", errors_1.ERROR_CODES.PARSE_ERROR, 500);
             }
-            profileCacheByVanity.set(key, { data: prof, ts: Date.now() });
+            profileCacheByVanity.set(key, prof);
             (0, metrics_1.incrementMetric)("profileFetches");
             try {
                 (0, logger_1.log)("info", "api.ok", {
@@ -210,7 +208,7 @@ async function getProfileByUrn(fsdKey) {
         });
     }
     catch { }
-    const cachedUrn = getCached(profileCacheByUrn, cacheKey, cfg.profileCacheTtl);
+    const cachedUrn = profileCacheByUrn.get(cacheKey, cfg.profileCacheTtl);
     if (cachedUrn) {
         (0, metrics_1.incrementMetric)("profileCacheHits");
         return cachedUrn;
@@ -322,7 +320,7 @@ async function getProfileByUrn(fsdKey) {
         catch { }
         throw new errors_1.LinkedInClientError("Failed to parse profile", errors_1.ERROR_CODES.PARSE_ERROR, 500);
     }
-    profileCacheByUrn.set(cacheKey, { data: prof, ts: Date.now() });
+    profileCacheByUrn.set(cacheKey, prof);
     (0, metrics_1.incrementMetric)("profileFetches");
     try {
         (0, logger_1.log)("info", "api.ok", { operation: "getProfileByUrn", selector: cacheKey });
@@ -390,7 +388,7 @@ async function searchSalesLeads(keywords, options) {
         cacheKeyObj.sessionId = options.sessionId;
     }
     const cacheKey = JSON.stringify(cacheKeyObj);
-    const cached = getCached(searchCache, cacheKey, cfg.searchCacheTtl);
+    const cached = searchCache.get(cacheKey, cfg.searchCacheTtl);
     if (cached) {
         (0, metrics_1.incrementMetric)("searchCacheHits");
         return cached;
@@ -466,7 +464,7 @@ async function searchSalesLeads(keywords, options) {
             : undefined,
         _meta: { sessionId }, // Return sessionId to consumer
     };
-    searchCache.set(cacheKey, { data: result, ts: Date.now() });
+    searchCache.set(cacheKey, result);
     (0, metrics_1.incrementMetric)("searchCacheMisses");
     return result;
 }
@@ -564,7 +562,7 @@ async function resolveCompanyUniversalName(universalName) {
 async function getCompanyById(companyId) {
     const cfg = (0, config_1.getConfig)();
     const key = String(companyId || "").trim();
-    const cached = getCached(companyCache, key, cfg.companyCacheTtl);
+    const cached = companyCache.get(key, cfg.companyCacheTtl);
     if (cached) {
         (0, metrics_1.incrementMetric)("companyCacheHits");
         return cached;
@@ -578,7 +576,7 @@ async function getCompanyById(companyId) {
         const raw = await (0, http_client_1.executeLinkedInRequest)({ url }, "getCompanyById");
         const parsed = (0, company_parser_1.parseCompany)(raw);
         (0, metrics_1.incrementMetric)("companyFetches");
-        companyCache.set(key, { data: parsed, ts: Date.now() });
+        companyCache.set(key, parsed);
         try {
             (0, logger_1.log)("info", "api.ok", { operation: "getCompanyById", selector: key });
         }
@@ -717,7 +715,7 @@ async function typeahead(options) {
     }
     // Make API call to LinkedIn for search queries or unsupported types
     const cacheKey = JSON.stringify({ type, query, start, count });
-    const cached = getCached(typeaheadCache, cacheKey, cfg.typeaheadCacheTtl);
+    const cached = typeaheadCache.get(cacheKey, cfg.typeaheadCacheTtl);
     if (cached) {
         (0, metrics_1.incrementMetric)("typeaheadCacheHits");
         return cached;
@@ -764,7 +762,7 @@ async function typeahead(options) {
             total: paging2?.total,
         },
     };
-    typeaheadCache.set(cacheKey, { data: result, ts: Date.now() });
+    typeaheadCache.set(cacheKey, result);
     try {
         (0, logger_1.log)("info", "api.ok", {
             operation: "typeahead",
@@ -920,3 +918,138 @@ async function getSalesNavigatorProfileDetails(profileUrnOrId) {
         throw e;
     }
 }
+/**
+ * Fetches full Sales Navigator profile data including flagshipProfileUrl (LinkedIn handle).
+ * This is a more complete version that returns all available profile data.
+ *
+ * The key use case is extracting the LinkedIn handle from flagshipProfileUrl
+ * for use with email finder services like Hunter.io.
+ *
+ * @param profileUrnOrId - Profile identifier in any of these formats:
+ *   - Sales profile URN: "urn:li:fs_salesProfile:(ABC123xyz,NAME_SEARCH,abc)"
+ *   - FSD profile URN: "urn:li:fsd_profile:ABC123xyz"
+ *   - Bare key: "ABC123xyz"
+ * @returns Full Sales Navigator profile with flagshipProfileUrl, contactInfo, positions, etc.
+ * @throws LinkedInClientError with code NOT_FOUND if profile doesn't exist
+ *
+ * @example
+ * ```typescript
+ * const profile = await getSalesNavigatorProfileFull('urn:li:fs_salesProfile:(ABC123,NAME_SEARCH,xyz)');
+ * console.log(profile.flagshipProfileUrl); // "https://www.linkedin.com/in/john-doe"
+ *
+ * // Extract LinkedIn handle for Hunter.io
+ * const handle = extractLinkedInHandle(profile.flagshipProfileUrl);
+ * console.log(handle); // "john-doe"
+ * ```
+ */
+async function getSalesNavigatorProfileFull(profileUrnOrId) {
+    const idOrUrn = String(profileUrnOrId || "").trim();
+    // Build Sales API path supporting URN triple or explicit profileId/authType/authToken
+    let pathSeg = "";
+    let pidFromTriple = null;
+    // URN with triple
+    const mUrn = idOrUrn.match(/^urn:li:(?:fs_salesProfile|fsd_profile):\(([^,\s)]+),([^,\s)]+),([^,\s)]+)\)/i);
+    if (mUrn) {
+        const [_, pid, authType, authToken] = mUrn;
+        pathSeg = `(profileId:${pid},authType:${authType},authToken:${authToken})`;
+        pidFromTriple = pid;
+    }
+    else if (/profileId:/.test(idOrUrn) &&
+        /authType:/.test(idOrUrn) &&
+        /authToken:/.test(idOrUrn)) {
+        // Already the triple form without urn prefix
+        pathSeg = `(${idOrUrn.replace(/^\(|\)$/g, "")})`;
+        const m = idOrUrn.match(/profileId:([^,\s)]+)/);
+        pidFromTriple = m ? m[1] : null;
+    }
+    else {
+        // Fallback to simple id/urn
+        pathSeg = idOrUrn.startsWith("urn:")
+            ? idOrUrn
+            : encodeURIComponent(idOrUrn);
+    }
+    // Decoration 2: Returns flagshipProfileUrl, contactInfo, summary, positions
+    // This is the key decoration for email enrichment - flagshipProfileUrl contains the LinkedIn handle
+    const decoration = encodeURIComponent("(entityUrn,objectUrn,firstName,lastName,fullName,headline,pronoun,degree,profileUnlockInfo,location,listCount,summary,savedLead,defaultPosition,contactInfo,crmStatus,pendingInvitation,unlocked,flagshipProfileUrl,positions*(companyName,current,new,description,endedOn,posId,startedOn,title,location,companyUrn~fs_salesCompany(entityUrn,name,companyPictureDisplayImage)))");
+    const base = `${SALES_NAV_BASE}/salesApiProfiles/`;
+    async function requestWith(seg) {
+        const url = `${base}${seg}?decoration=${decoration}`;
+        return (0, http_client_1.executeLinkedInRequest)({
+            url,
+            headers: { Referer: "https://www.linkedin.com/sales/search/people" },
+        }, "getSalesNavigatorProfileFull");
+    }
+    try {
+        try {
+            (0, logger_1.log)("info", "api.start", {
+                operation: "getSalesNavigatorProfileFull",
+                selector: idOrUrn,
+            });
+        }
+        catch { }
+        let raw;
+        try {
+            raw = await requestWith(pathSeg);
+        }
+        catch (e) {
+            const status = e?.status ?? 0;
+            if (status === 400 && pidFromTriple) {
+                // Fallback: some environments reject the triple form; retry with bare id
+                const fallbackSeg = encodeURIComponent(pidFromTriple);
+                try {
+                    (0, logger_1.log)("warn", "api.salesProfileFullFallback", {
+                        from: pathSeg,
+                        to: fallbackSeg,
+                    });
+                }
+                catch { }
+                raw = await requestWith(fallbackSeg);
+            }
+            else if (status === 404) {
+                try {
+                    (0, logger_1.log)("warn", "api.notFound", {
+                        operation: "getSalesNavigatorProfileFull",
+                        selector: idOrUrn,
+                        status,
+                    });
+                }
+                catch { }
+                throw new errors_1.LinkedInClientError("Sales profile not found", errors_1.ERROR_CODES.NOT_FOUND, 404);
+            }
+            else {
+                throw e;
+            }
+        }
+        try {
+            (0, logger_1.log)("info", "api.ok", {
+                operation: "getSalesNavigatorProfileFull",
+                selector: idOrUrn,
+                hasHandle: !!raw.flagshipProfileUrl,
+            });
+        }
+        catch { }
+        return raw;
+    }
+    catch (e) {
+        throw e;
+    }
+}
+/**
+ * Extracts LinkedIn handle/vanity from a flagship profile URL.
+ *
+ * @param flagshipProfileUrl - Full LinkedIn profile URL (e.g., "https://www.linkedin.com/in/john-doe")
+ * @returns LinkedIn handle/vanity (e.g., "john-doe") or null if not found
+ *
+ * @example
+ * ```typescript
+ * extractLinkedInHandle("https://www.linkedin.com/in/john-doe"); // "john-doe"
+ * extractLinkedInHandle("https://www.linkedin.com/in/georgi-metodiev-tech2rec"); // "georgi-metodiev-tech2rec"
+ * extractLinkedInHandle(null); // null
+ * ```
+ */
+function extractLinkedInHandle(flagshipProfileUrl) {
+    if (!flagshipProfileUrl)
+        return null;
+    const match = flagshipProfileUrl.match(/linkedin\.com\/in\/([^\/\?]+)/i);
+    return match ? match[1] : null;
+}

package/dist/types.d.ts

@@ -5,7 +5,7 @@
 export interface CosiallProfileEmailsResponse {
     /** Cosiall internal profile ID */
     profileId: number;
-    /** LinkedIn ObjectURN identifier (e.g., "urn:li:fsd_profile:ACoAABcdEfG") */
+    /** LinkedIn ObjectURN identifier (e.g., "urn:li:member:129147375") */
     objectUrn: string;
     /** LinkedIn profile URL */
     linkedInUrl: string;
@@ -233,6 +233,55 @@ export interface SalesNavigatorProfile {
     imageUrl?: string;
     flagshipProfileUrl?: string;
 }
+export interface SalesNavigatorPosition {
+    companyName?: string;
+    companyUrn?: string;
+    title?: string;
+    description?: string;
+    current?: boolean;
+    new?: boolean;
+    location?: string;
+    posId?: number;
+    startedOn?: {
+        year?: number;
+        month?: number;
+    };
+    endedOn?: {
+        year?: number;
+        month?: number;
+    };
+}
+export interface SalesNavigatorContactInfo {
+    emailAddresses?: string[];
+    phoneNumbers?: string[];
+    twitterHandles?: string[];
+    websites?: string[];
+}
+export interface SalesNavigatorProfileFull {
+    entityUrn?: string;
+    objectUrn?: string;
+    firstName?: string;
+    lastName?: string;
+    fullName?: string;
+    headline?: string;
+    summary?: string;
+    location?: string;
+    degree?: number;
+    pronoun?: string;
+    /** LinkedIn public profile URL - contains the vanity/handle (e.g., "https://www.linkedin.com/in/john-doe") */
+    flagshipProfileUrl?: string;
+    /** Contact info (emails, phones) - only available if connected */
+    contactInfo?: SalesNavigatorContactInfo;
+    /** Current and past positions */
+    positions?: SalesNavigatorPosition[];
+    defaultPosition?: SalesNavigatorPosition;
+    profileUnlockInfo?: unknown;
+    listCount?: number;
+    savedLead?: boolean;
+    crmStatus?: unknown;
+    pendingInvitation?: boolean;
+    unlocked?: boolean;
+}
 export type Geo = {
     type: "region" | "country" | "state" | "city" | "postal";
     value: string;