linkedin-secret-sauce 0.1.1 → 0.2.0

package/dist/linkedin-api.js

@@ -4,17 +4,29 @@ exports.getProfileByVanity = getProfileByVanity;
 exports.getProfileByUrn = getProfileByUrn;
 exports.searchSalesLeads = searchSalesLeads;
 exports.getProfilesBatch = getProfilesBatch;
+exports.resolveCompanyUniversalName = resolveCompanyUniversalName;
+exports.getCompanyById = getCompanyById;
+exports.getCompanyByUrl = getCompanyByUrl;
+exports.typeahead = typeahead;
+exports.getSalesNavigatorProfileDetails = getSalesNavigatorProfileDetails;
 const config_1 = require("./config");
 const http_client_1 = require("./http-client");
 const profile_parser_1 = require("./parsers/profile-parser");
 const search_parser_1 = require("./parsers/search-parser");
+const search_encoder_1 = require("./utils/search-encoder");
+const company_parser_1 = require("./parsers/company-parser");
 const metrics_1 = require("./utils/metrics");
+const logger_1 = require("./utils/logger");
+const errors_1 = require("./utils/errors");
 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();
 // In-flight dedupe for profiles by vanity
 const inflightByVanity = new Map();
 function getCached(map, key, ttl) {
@@ -30,6 +42,10 @@ function getCached(map, key, ttl) {
 async function getProfileByVanity(vanity) {
     const cfg = (0, config_1.getConfig)();
     const key = String(vanity || '').toLowerCase();
+    try {
+        (0, logger_1.log)('info', 'api.start', { operation: 'getProfileByVanity', selector: key });
+    }
+    catch { }
     // Cache
     const cached = getCached(profileCacheByVanity, key, cfg.profileCacheTtl);
     if (cached) {
@@ -45,10 +61,38 @@ async function getProfileByVanity(vanity) {
     const url = `${LINKEDIN_API_BASE}/identity/dash/profiles?q=memberIdentity&memberIdentity=${encodeURIComponent(vanity)}&decorationId=com.linkedin.voyager.dash.deco.identity.profile.FullProfileWithEntities-35`;
     const p = (async () => {
         try {
-            const raw = await (0, http_client_1.executeLinkedInRequest)({ url }, 'getProfileByVanity');
-            const prof = (0, profile_parser_1.parseFullProfile)(raw, vanity);
+            let raw;
+            try {
+                raw = await (0, http_client_1.executeLinkedInRequest)({ url }, 'getProfileByVanity');
+            }
+            catch (e) {
+                const status = e?.status ?? 0;
+                if (status === 404) {
+                    try {
+                        (0, logger_1.log)('warn', 'api.notFound', { operation: 'getProfileByVanity', selector: key, status });
+                    }
+                    catch { }
+                    throw new errors_1.LinkedInClientError('Profile not found', errors_1.ERROR_CODES.NOT_FOUND, 404);
+                }
+                throw e;
+            }
+            let prof;
+            try {
+                prof = (0, profile_parser_1.parseFullProfile)(raw, vanity);
+            }
+            catch {
+                try {
+                    (0, logger_1.log)('error', 'api.parseError', { operation: 'getProfileByVanity', selector: key });
+                }
+                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() });
             (0, metrics_1.incrementMetric)('profileFetches');
+            try {
+                (0, logger_1.log)('info', 'api.ok', { operation: 'getProfileByVanity', selector: key });
+            }
+            catch { }
             return prof;
         }
         finally {
@@ -60,57 +104,137 @@ async function getProfileByVanity(vanity) {
 }
 async function getProfileByUrn(fsdKey) {
     const cfg = (0, config_1.getConfig)();
-    const key = String(fsdKey || '').toLowerCase();
-    const cachedUrn = getCached(profileCacheByUrn, key, cfg.profileCacheTtl);
+    // Normalize input: accept bare KEY or URN variants and extract KEY
+    const input = String(fsdKey || '').trim();
+    const keyMatch = input.match(/^urn:li:fsd_profile:([^\s/]+)$/i)?.[1] ||
+        input.match(/^urn:li:fs_salesProfile:\(([^,\s)]+)/i)?.[1] ||
+        (input.match(/^[A-Za-z0-9_-]+$/) ? input : null);
+    if (!keyMatch) {
+        throw new errors_1.LinkedInClientError('Invalid URN or key', errors_1.ERROR_CODES.INVALID_INPUT, 400);
+    }
+    const cacheKey = keyMatch.toLowerCase();
+    try {
+        (0, logger_1.log)('info', 'api.start', { operation: 'getProfileByUrn', selector: cacheKey });
+    }
+    catch { }
+    const cachedUrn = getCached(profileCacheByUrn, cacheKey, cfg.profileCacheTtl);
     if (cachedUrn) {
         (0, metrics_1.incrementMetric)('profileCacheHits');
         return cachedUrn;
     }
-    const url = `${LINKEDIN_API_BASE}/identity/dash/profiles?q=memberIdentity&memberIdentity=${encodeURIComponent(fsdKey)}&decorationId=com.linkedin.voyager.dash.deco.identity.profile.FullProfileWithEntities-35`;
-    const raw = await (0, http_client_1.executeLinkedInRequest)({ url }, 'getProfileByUrn');
-    const prof = (0, profile_parser_1.parseFullProfile)(raw, '');
-    profileCacheByUrn.set(key, { data: prof, ts: Date.now() });
+    const url = `${LINKEDIN_API_BASE}/identity/dash/profiles?q=memberIdentity&memberIdentity=${encodeURIComponent(keyMatch)}&decorationId=com.linkedin.voyager.dash.deco.identity.profile.FullProfileWithEntities-35`;
+    let raw;
+    try {
+        raw = await (0, http_client_1.executeLinkedInRequest)({ url }, 'getProfileByUrn');
+    }
+    catch (e) {
+        const status = e?.status ?? 0;
+        if (status === 404) {
+            try {
+                (0, logger_1.log)('warn', 'api.notFound', { operation: 'getProfileByUrn', selector: cacheKey, status });
+            }
+            catch { }
+            throw new errors_1.LinkedInClientError('Profile not found', errors_1.ERROR_CODES.NOT_FOUND, 404);
+        }
+        throw e;
+    }
+    let prof;
+    try {
+        prof = (0, profile_parser_1.parseFullProfile)(raw, '');
+    }
+    catch {
+        try {
+            (0, logger_1.log)('error', 'api.parseError', { operation: 'getProfileByUrn', selector: cacheKey });
+        }
+        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() });
     (0, metrics_1.incrementMetric)('profileFetches');
+    try {
+        (0, logger_1.log)('info', 'api.ok', { operation: 'getProfileByUrn', selector: cacheKey });
+    }
+    catch { }
     return prof;
 }
-async function searchSalesLeads(keywords) {
+async function searchSalesLeads(keywords, options) {
     const cfg = (0, config_1.getConfig)();
-    const key = String(keywords || '').toLowerCase();
-    const cachedSearch = getCached(searchCache, key, cfg.searchCacheTtl);
-    if (cachedSearch) {
+    const start = Number.isFinite(options?.start) ? Number(options.start) : 0;
+    const count = Number.isFinite(options?.count) ? Number(options.count) : 25;
+    const deco = options?.decorationId || 'com.linkedin.sales.deco.desktop.searchv2.LeadSearchResult-14';
+    const sig = (0, search_encoder_1.buildFilterSignature)(options?.filters, options?.rawQuery);
+    const cacheKey = JSON.stringify({ k: String(keywords || '').toLowerCase(), start, count, deco, sig });
+    const cached = getCached(searchCache, cacheKey, cfg.searchCacheTtl);
+    if (cached) {
         (0, metrics_1.incrementMetric)('searchCacheHits');
-        return cachedSearch;
-    }
-    const encodedKeywords = String(keywords || '').replace(/\s+/g, '%20');
-    const queryStruct = `(spellCorrectionEnabled:true,keywords:${encodedKeywords})`;
-    const url = `${SALES_NAV_BASE}/salesApiLeadSearch?q=searchQuery&start=0&count=25&decorationId=com.linkedin.sales.deco.desktop.searchv2.LeadSearchResult-14&query=${queryStruct}`;
-    const raw = await (0, http_client_1.executeLinkedInRequest)({
-        url,
-        headers: { Referer: 'https://www.linkedin.com/sales/search/people' },
-    }, 'searchSalesLeads');
-    const results = (0, search_parser_1.parseSalesSearchResults)(raw);
-    searchCache.set(key, { data: results, ts: Date.now() });
+        return cached;
+    }
+    let queryStruct;
+    if (options?.rawQuery) {
+        queryStruct = String(options.rawQuery);
+    }
+    else {
+        queryStruct = (0, search_encoder_1.buildLeadSearchQuery)(keywords, options?.filters);
+    }
+    async function doRequest(decorationId) {
+        const url = `${SALES_NAV_BASE}/salesApiLeadSearch?q=searchQuery&start=${start}&count=${count}&decorationId=${encodeURIComponent(decorationId)}&query=${queryStruct}`;
+        try {
+            (0, logger_1.log)('info', 'api.start', { operation: 'searchSalesLeads', selector: { keywords, start, count, deco: decorationId } });
+        }
+        catch { }
+        const out = await (0, http_client_1.executeLinkedInRequest)({
+            url,
+            headers: { Referer: 'https://www.linkedin.com/sales/search/people' },
+        }, 'searchSalesLeads');
+        try {
+            (0, logger_1.log)('info', 'api.ok', { operation: 'searchSalesLeads', selector: { keywords, start, count, deco: decorationId } });
+        }
+        catch { }
+        return out;
+    }
+    let raw;
+    try {
+        raw = await doRequest(deco);
+    }
+    catch (e) {
+        if ((e?.status ?? 0) === 400) {
+            const fallback = deco.replace(/LeadSearchResult-\d+/, 'LeadSearchResult-17');
+            try {
+                (0, logger_1.log)('warn', 'api.decoFallback', { from: deco, to: fallback });
+            }
+            catch { }
+            raw = await doRequest(fallback);
+        }
+        else {
+            throw e;
+        }
+    }
+    const items = (0, search_parser_1.parseSalesSearchResults)(raw);
+    const rrec = (raw && typeof raw === 'object') ? raw : undefined;
+    const pagingVal = rrec && 'paging' in rrec ? rrec.paging : undefined;
+    const p = (pagingVal && typeof pagingVal === 'object') ? pagingVal : undefined;
+    const paging = p ?? { start, count };
+    const result = options
+        ? { items, page: { start: Number(paging.start ?? start), count: Number(paging.count ?? count), total: paging?.total } }
+        : items; // backward-compat: old tests expect an array when no options passed
+    searchCache.set(cacheKey, { data: result, ts: Date.now() });
     (0, metrics_1.incrementMetric)('searchCacheMisses');
-    return results;
+    return result;
 }
 async function getProfilesBatch(vanities, concurrency = 4) {
     const limit = Math.max(1, Math.min(concurrency || 1, 16));
-    const results = [];
+    const results = Array.from({ length: vanities.length }, () => null);
     let idx = 0;
     async function worker() {
-        // eslint-disable-next-line no-constant-condition
-        while (true) {
+        while (idx < vanities.length) {
             const myIdx = idx++;
-            if (myIdx >= vanities.length)
-                break;
             const vanity = vanities[myIdx];
             try {
                 const prof = await getProfileByVanity(vanity);
-                if (prof)
-                    results.push(prof);
+                results[myIdx] = prof ?? null;
             }
             catch {
-                // Skip failures
+                results[myIdx] = null;
             }
         }
     }
@@ -118,3 +242,227 @@ async function getProfilesBatch(vanities, concurrency = 4) {
     await Promise.all(workers);
     return results;
 }
+// ---------------------------------------------------------------------------
+// Companies (Voyager organizations)
+// ---------------------------------------------------------------------------
+async function resolveCompanyUniversalName(universalName) {
+    const url = `${LINKEDIN_API_BASE}/organization/companies?q=universalName&universalName=${encodeURIComponent(String(universalName || '').trim())}`;
+    try {
+        try {
+            (0, logger_1.log)('info', 'api.start', { operation: 'resolveCompanyUniversalName', selector: universalName });
+        }
+        catch { }
+        const raw = await (0, http_client_1.executeLinkedInRequest)({ url }, 'resolveCompanyUniversalName');
+        const rec = (raw && typeof raw === 'object') ? raw : undefined;
+        const elementsVal = rec && 'elements' in rec ? rec.elements : undefined;
+        const first = Array.isArray(elementsVal) ? elementsVal[0] : undefined;
+        const id = first?.id ?? first?.entityUrn ?? undefined;
+        try {
+            (0, logger_1.log)('info', 'api.ok', { operation: 'resolveCompanyUniversalName', selector: universalName, id });
+        }
+        catch { }
+        return { companyId: id ? String(id).replace(/^urn:li:fsd_company:/, '') : undefined };
+    }
+    catch (e) {
+        const status = e?.status ?? 0;
+        if (status === 404) {
+            try {
+                (0, logger_1.log)('warn', 'api.notFound', { operation: 'resolveCompanyUniversalName', selector: universalName, status });
+            }
+            catch { }
+            throw new errors_1.LinkedInClientError('Company not found', errors_1.ERROR_CODES.NOT_FOUND, 404);
+        }
+        throw e;
+    }
+}
+async function getCompanyById(companyId) {
+    const cfg = (0, config_1.getConfig)();
+    const key = String(companyId || '').trim();
+    const cached = getCached(companyCache, key, cfg.companyCacheTtl);
+    if (cached) {
+        (0, metrics_1.incrementMetric)('companyCacheHits');
+        return cached;
+    }
+    const url = `${LINKEDIN_API_BASE}/entities/companies/${encodeURIComponent(key)}`;
+    try {
+        try {
+            (0, logger_1.log)('info', 'api.start', { operation: 'getCompanyById', selector: key });
+        }
+        catch { }
+        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() });
+        try {
+            (0, logger_1.log)('info', 'api.ok', { operation: 'getCompanyById', selector: key });
+        }
+        catch { }
+        return parsed;
+    }
+    catch (e) {
+        const status = e?.status ?? 0;
+        if (status === 404) {
+            try {
+                (0, logger_1.log)('warn', 'api.notFound', { operation: 'getCompanyById', selector: key, status });
+            }
+            catch { }
+            throw new errors_1.LinkedInClientError('Company not found', errors_1.ERROR_CODES.NOT_FOUND, 404);
+        }
+        throw e;
+    }
+}
+async function getCompanyByUrl(companyUrl) {
+    const input = String(companyUrl || '').trim();
+    let url;
+    try {
+        // Require explicit http/https scheme; do not auto-prepend
+        if (!/^https?:\/\//i.test(input)) {
+            throw new errors_1.LinkedInClientError('Invalid company URL scheme', errors_1.ERROR_CODES.INVALID_INPUT, 400);
+        }
+        url = new URL(input);
+    }
+    catch {
+        throw new errors_1.LinkedInClientError('Invalid company URL', errors_1.ERROR_CODES.INVALID_INPUT, 400);
+    }
+    const m = url.pathname.match(/\/company\/([^\/]+)/i);
+    if (!m) {
+        try {
+            (0, logger_1.log)('error', 'api.invalidInput', { operation: 'getCompanyByUrl', selector: companyUrl });
+        }
+        catch { }
+        ;
+        throw new errors_1.LinkedInClientError('Invalid company URL path', errors_1.ERROR_CODES.INVALID_INPUT, 400);
+    }
+    const ident = decodeURIComponent(m[1]);
+    if (/^\d+$/.test(ident)) {
+        return getCompanyById(ident);
+    }
+    const resolved = await resolveCompanyUniversalName(ident);
+    if (!resolved.companyId) {
+        try {
+            (0, logger_1.log)('warn', 'api.notFound', { operation: 'getCompanyByUrl', selector: companyUrl });
+        }
+        catch { }
+        ;
+        throw new errors_1.LinkedInClientError('Company not found', errors_1.ERROR_CODES.NOT_FOUND, 404);
+    }
+    return getCompanyById(resolved.companyId);
+}
+// ---------------------------------------------------------------------------
+// Typeahead (Sales Navigator facets)
+// ---------------------------------------------------------------------------
+async function typeahead(options) {
+    const cfg = (0, config_1.getConfig)();
+    const type = String(options?.type || '').trim();
+    const start = Number.isFinite(options?.start) ? Number(options.start) : 0;
+    const count = Number.isFinite(options?.count) ? Number(options.count) : 10;
+    const query = (options?.query ?? '').toString();
+    const cacheKey = JSON.stringify({ type, query, start, count });
+    const cached = getCached(typeaheadCache, cacheKey, cfg.typeaheadCacheTtl);
+    if (cached) {
+        (0, metrics_1.incrementMetric)('typeaheadCacheHits');
+        return cached;
+    }
+    let url = `${SALES_NAV_BASE}/salesApiFacetTypeahead?q=query&type=${encodeURIComponent(type)}&start=${start}&count=${count}`;
+    if (query)
+        url += `&query=${encodeURIComponent(query)}`;
+    (0, metrics_1.incrementMetric)('typeaheadRequests');
+    try {
+        (0, logger_1.log)('info', 'api.start', { operation: 'typeahead', selector: { type, query, start, count } });
+    }
+    catch { }
+    const raw = await (0, http_client_1.executeLinkedInRequest)({ url }, 'typeahead');
+    const items = Array.isArray(raw?.elements)
+        ? raw.elements.map((it) => ({
+            id: String(it?.id ?? it?.backendId ?? ''),
+            text: it.displayValue ??
+                it.headline?.text ??
+                it.text ??
+                it.name ??
+                it.label ??
+                ''
+        }))
+        : [];
+    const rtype = (raw && typeof raw === 'object') ? raw : undefined;
+    const pagingVal2 = rtype && 'paging' in rtype ? rtype.paging : undefined;
+    const paging2 = (pagingVal2 && typeof pagingVal2 === 'object') ? pagingVal2 : undefined;
+    const result = { items, page: { start: Number(paging2?.start ?? start), count: Number(paging2?.count ?? count), total: paging2?.total } };
+    typeaheadCache.set(cacheKey, { data: result, ts: Date.now() });
+    try {
+        (0, logger_1.log)('info', 'api.ok', { operation: 'typeahead', selector: { type, query }, count: items.length });
+    }
+    catch { }
+    return result;
+}
+// ---------------------------------------------------------------------------
+// Sales Navigator profile details
+// ---------------------------------------------------------------------------
+async function getSalesNavigatorProfileDetails(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);
+    }
+    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' } }, 'getSalesNavigatorProfileDetails');
+    }
+    try {
+        try {
+            (0, logger_1.log)('info', 'api.start', { operation: 'getSalesNavigatorProfileDetails', 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.salesProfileFallback', { from: pathSeg, to: fallbackSeg });
+                }
+                catch { }
+                raw = await requestWith(fallbackSeg);
+            }
+            else if (status === 404) {
+                try {
+                    (0, logger_1.log)('warn', 'api.notFound', { operation: 'getSalesNavigatorProfileDetails', 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: 'getSalesNavigatorProfileDetails', selector: idOrUrn });
+        }
+        catch { }
+        return raw;
+    }
+    catch (e) {
+        throw e;
+    }
+}

package/dist/parsers/company-parser.d.ts

@@ -0,0 +1,2 @@
+import type { Company } from '../types';
+export declare function parseCompany(raw: unknown): Company;

package/dist/parsers/company-parser.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCompany = parseCompany;
+const image_parser_1 = require("./image-parser");
+function parseCompany(raw) {
+    const r = raw;
+    const company = {
+        companyId: String(r?.id ?? '')
+            .replace(/^urn:li:(?:fsd_)?company:/i, '') ||
+            String(r?.entityUrn ?? '')
+                .replace(/^urn:li:(?:fsd_)?company:/i, ''),
+        universalName: r?.universalName,
+        name: r?.name,
+        websiteUrl: r?.websiteUrl,
+        sizeLabel: r?.employeeCountRange?.localizedName,
+        headquarters: r?.headquarterLocation?.defaultLocalizedName ||
+            r?.headquarter?.defaultLocalizedName,
+        logoUrl: undefined,
+        coverUrl: undefined,
+    };
+    const logoVector = r?.logo?.vectorImage || r?.logoV2?.vectorImage;
+    const coverVector = r?.coverPhoto?.vectorImage || r?.backgroundImage?.vectorImage;
+    const logoUrl = (0, image_parser_1.selectBestImageUrl)(logoVector);
+    const coverUrl = (0, image_parser_1.selectBestImageUrl)(coverVector);
+    if (logoUrl)
+        company.logoUrl = logoUrl;
+    if (coverUrl)
+        company.coverUrl = coverUrl;
+    return company;
+}

package/dist/parsers/image-parser.d.ts

@@ -0,0 +1,10 @@
+export type VectorArtifact = {
+    width?: number;
+    fileIdentifyingUrlPathSegment?: string;
+    url?: string;
+};
+export type VectorImage = {
+    rootUrl?: string;
+    artifacts?: VectorArtifact[];
+};
+export declare function selectBestImageUrl(vector: unknown): string | undefined;

package/dist/parsers/image-parser.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectBestImageUrl = selectBestImageUrl;
+function selectBestImageUrl(vector) {
+    const v = vector;
+    if (!v || !Array.isArray(v.artifacts) || v.artifacts.length === 0)
+        return undefined;
+    const best = v.artifacts.reduce((prev, curr) => ((curr?.width || 0) > (prev?.width || 0) ? curr : prev), {});
+    const seg = best?.fileIdentifyingUrlPathSegment || best?.url;
+    if (!seg)
+        return undefined;
+    if (/^https?:\/\//i.test(seg))
+        return seg;
+    const root = String(v.rootUrl || '');
+    return root + seg;
+}

package/dist/parsers/profile-parser.d.ts

@@ -1,2 +1,2 @@
 import type { LinkedInProfile } from '../types';
-export declare function parseFullProfile(rawResponse: any, vanity: string): LinkedInProfile;
+export declare function parseFullProfile(rawResponse: unknown, vanity: string): LinkedInProfile;

package/dist/parsers/profile-parser.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseFullProfile = parseFullProfile;
+const image_parser_1 = require("./image-parser");
 function parseFullProfile(rawResponse, vanity) {
-    const included = Array.isArray(rawResponse?.included) ? rawResponse.included : [];
+    const rr = rawResponse;
+    const included = Array.isArray(rr?.included) ? rr.included : [];
     const identity = included.find((it) => String(it?.$type || '').includes('identity.profile.Profile')) || {};
     const profile = {
         vanity,
@@ -15,46 +17,89 @@ function parseFullProfile(rawResponse, vanity) {
         educations: [],
     };
     // Positions
+    function extractCompanyIdFromUrn(urn) {
+        if (!urn)
+            return undefined;
+        const s = String(urn);
+        const mParen = s.match(/company:\(([^,)]+)/i);
+        if (mParen)
+            return mParen[1];
+        const mSimple = s.match(/company:([^,\s)]+)/i);
+        return mSimple ? mSimple[1] : undefined;
+    }
+    function deepFindCompanyUrn(obj, depth = 0) {
+        if (!obj || depth > 3)
+            return undefined;
+        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))
+                return v;
+            if (v && typeof v === 'object') {
+                const hit = deepFindCompanyUrn(v, depth + 1);
+                if (hit)
+                    return hit;
+            }
+        }
+        return undefined;
+    }
     for (const item of included) {
-        const urn = item?.entityUrn || '';
+        const rec = item;
+        const urn = rec?.entityUrn || '';
         if (!urn.includes('fsd_profilePosition'))
             continue;
         const pos = {
-            title: item?.title,
-            companyName: item?.companyName,
-            description: item?.description,
-            isCurrent: !item?.timePeriod?.endDate,
-            startYear: item?.timePeriod?.startDate?.year,
-            startMonth: item?.timePeriod?.startDate?.month,
-            endYear: item?.timePeriod?.endDate?.year,
-            endMonth: item?.timePeriod?.endDate?.month,
+            title: rec?.title,
+            companyName: rec?.companyName,
+            description: rec?.description,
+            isCurrent: !rec?.timePeriod?.endDate,
+            startYear: rec?.timePeriod?.startDate?.year,
+            startMonth: rec?.timePeriod?.startDate?.month,
+            endYear: rec?.timePeriod?.endDate?.year,
+            endMonth: rec?.timePeriod?.endDate?.month,
         };
+        // Try to extract company URN and numeric id robustly
+        const candUrns = [
+            rec?.companyUrn,
+            rec?.company?.entityUrn,
+            rec?.company?.companyUrn,
+            rec?.companyUrnV2,
+        ].filter(Boolean);
+        const foundUrn = candUrns.find(u => /urn:li:(?:fsd_)?company:/i.test(u)) || deepFindCompanyUrn(item);
+        if (foundUrn) {
+            pos.companyUrn = foundUrn;
+            const cid = extractCompanyIdFromUrn(foundUrn);
+            if (cid)
+                pos.companyId = cid;
+        }
         profile.positions.push(pos);
     }
     // Educations
     for (const item of included) {
-        const urn = item?.entityUrn || '';
+        const rec = item;
+        const urn = rec?.entityUrn || '';
         if (!urn.includes('fsd_profileEducation'))
             continue;
         const edu = {
-            schoolName: item?.schoolName,
-            degree: item?.degreeName,
-            fieldOfStudy: item?.fieldOfStudy,
-            startYear: item?.timePeriod?.startDate?.year,
-            startMonth: item?.timePeriod?.startDate?.month,
-            endYear: item?.timePeriod?.endDate?.year,
-            endMonth: item?.timePeriod?.endDate?.month,
+            schoolName: rec?.schoolName,
+            degree: rec?.degreeName,
+            fieldOfStudy: rec?.fieldOfStudy,
+            startYear: rec?.timePeriod?.startDate?.year,
+            startMonth: rec?.timePeriod?.startDate?.month,
+            endYear: rec?.timePeriod?.endDate?.year,
+            endMonth: rec?.timePeriod?.endDate?.month,
         };
         profile.educations.push(edu);
     }
-    // Avatar
+    // Avatar (via helper)
     const avatarItem = included.find((it) => it?.vectorImage && JSON.stringify(it).includes('vectorImage'));
     const vector = avatarItem?.vectorImage;
-    if (vector?.artifacts?.length) {
-        const best = vector.artifacts.reduce((prev, curr) => ((curr?.width || 0) > (prev?.width || 0) ? curr : prev), {});
-        const seg = best?.fileIdentifyingUrlPathSegment || best?.url;
-        if (seg)
-            profile.avatarUrl = seg.startsWith('http') ? seg : (vector.rootUrl || '') + seg;
-    }
+    const bestUrl = (0, image_parser_1.selectBestImageUrl)(vector);
+    if (bestUrl)
+        profile.avatarUrl = bestUrl;
     return profile;
 }