linkedin-secret-sauce 0.3.8 → 0.3.10

package/README.md

@@ -221,6 +221,55 @@ Notes:
 - For scoped packages that should be public, add `--access public` (not needed here because the package name is unscoped).
 - The “Publish your first package” button on GitHub targets GitHub Packages (`npm publish --registry=https://npm.pkg.github.com/`), not npmjs.com.
 
+## Changelog
+
+See [CHANGELOG.md](CHANGELOG.md) for release notes and upgrade guides.
+
+**Latest:** v0.3.10 - Fixed `fsdKey` extraction from Sales Navigator URNs
+
+## Known Issues & Solutions
+
+### Sales Navigator Search Results
+
+**Issue:** `fsdKey` field not populated in search results (fixed in v0.3.10)
+
+If you're on an older version, you may need to manually extract `fsdKey`:
+```typescript
+const results = await searchSalesLeads('query');
+// For older versions (<0.3.10), fsdKey might be missing
+// Solution: Update to v0.3.10+
+```
+
+**Upgrade:**
+```bash
+npm update linkedin-secret-sauce
+# or
+pnpm update linkedin-secret-sauce
+```
+
+After upgrading to v0.3.10+, `fsdKey` will be correctly populated from URNs like:
+```
+urn:li:fs_salesProfile:(ACwAAAAM3xgBU8jQ8zPMpR_WswldHDbBxoOu6p8,NAME_SEARCH,g2em)
+```
+
+### Profile Enrichment Pattern
+
+For best results, use this two-step pattern:
+
+```typescript
+// Step 1: Search (lightweight, returns many results quickly)
+const searchResults = await searchSalesLeads('software engineer berlin');
+
+// Step 2: Enrich selected results (slower, returns full data)
+for (const result of searchResults.items) {
+  if (result.fsdKey) {
+    const fullProfile = await getProfileByUrn(result.fsdKey);
+    // Now you have positions[] and educations[] arrays
+    console.log(`${fullProfile.firstName} has ${fullProfile.positions.length} jobs`);
+  }
+}
+```
+
 
 ## Playground (React + Vite)\n\nDev-only UI to exercise the library safely via a local server.\n\n- Start both server and client: \n  - pnpm dev:playground\n- Or separately: \n  - pnpm -C apps/playground run server (http://localhost:5175)\n  - pnpm -C apps/playground run client (http://localhost:5173)\n\nThe server initializes the library and exposes endpoints for profiles, companies, typeahead, sales search, and sales profile.\nMetrics and request history are exposed at /api/metrics and /api/history.\n\nBy default the server uses a dev stub for cookies at /api/flexiq/linkedin-cookies/all.\nTo use your Cosiall backend, set env vars: COSIALL_API_URL and COSIALL_API_KEY and remove the stub in pps/playground/server/index.ts.\n
 ## Playground (local UI)

package/dist/linkedin-api.js

@@ -204,8 +204,15 @@ async function searchSalesLeads(keywords, options) {
     const pagingVal = rrec && 'paging' in rrec ? rrec.paging : undefined;
     const p = (pagingVal && typeof pagingVal === 'object') ? pagingVal : undefined;
     const paging = p ?? { start, count };
+    // Extract metadata.totalDisplayCount (LinkedIn's display string like "500K+")
+    const metadataVal = rrec && 'metadata' in rrec ? rrec.metadata : undefined;
+    const metadata = (metadataVal && typeof metadataVal === 'object') ? metadataVal : undefined;
     const result = options
-        ? { items, page: { start: Number(paging.start ?? start), count: Number(paging.count ?? count), total: paging?.total } }
+        ? {
+            items,
+            page: { start: Number(paging.start ?? start), count: Number(paging.count ?? count), total: paging?.total },
+            metadata: metadata?.totalDisplayCount ? { totalDisplayCount: metadata.totalDisplayCount } : undefined
+        }
         : 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');

package/dist/parsers/search-parser.js

@@ -18,16 +18,16 @@ function parseSalesSearchResults(rawResponse) {
         };
         // fsdKey from URN patterns
         const urn = String(el?.entityUrn || '');
-        const m3 = urn.match(/^urn:li:(?:fs_salesProfile|fsd_profile):\(([^,\s)]+),([^,\s)]+),([^,\s)]+)\)/i);
+        const m3 = urn.match(/^urn:li:(?:fs_salesProfile|fsd_profile):\(([^,)]+),([^,)]+),([^,)]+)\)/i);
         if (m3) {
-            res.fsdKey = m3[1];
-            res.salesAuthType = m3[2];
-            res.salesAuthToken = m3[3];
+            res.fsdKey = m3[1]?.trim();
+            res.salesAuthType = m3[2]?.trim();
+            res.salesAuthToken = m3[3]?.trim();
         }
         else {
-            const m1 = urn.match(/^urn:li:(?:fs_salesProfile|fsd_profile):\(([^,\s)]+)/i);
+            const m1 = urn.match(/^urn:li:(?:fs_salesProfile|fsd_profile):\(([^,)]+)/i);
             if (m1)
-                res.fsdKey = m1[1];
+                res.fsdKey = m1[1]?.trim();
         }
         // Image best artifact
         const img = el?.profilePictureDisplayImage;

package/dist/types.d.ts

@@ -141,6 +141,9 @@ export interface SearchSalesResult {
         count: number;
         total?: number;
     };
+    metadata?: {
+        totalDisplayCount?: string;
+    };
 }
 export interface Company {
     companyId: string;

package/package.json

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