linkedin-secret-sauce 0.3.4 → 0.3.6

package/README.md

@@ -1,228 +1,228 @@
-# LinkedIn Secret Sauce Client
-
-Private, server-side LinkedIn Sales Navigator client. It manages cookies/accounts, retries, caching, and parsing so your app calls a small, typed API.
-
-For a step‑by‑step integration guide you can copy/paste into other apps, see `docs/INTEGRATION.md`.
-
-Advanced lead search
-- Strongly‑typed filters: see `docs/SALES_SEARCH.md` (seniority, titles with id or text, functions, industries, languages, regions, company headcount/type, years buckets, current company).
-- Relationship filters are intentionally not used (results are customer‑agnostic).
-- Past company is not emitted — only CURRENT_COMPANY is supported.
-- Power users: pass a full `rawQuery` string to `searchSalesLeads` if you already have the Sales Navigator `query=(...)` payload.
-
-- Node: >= 18 (uses global `fetch`)
-- Build: `pnpm build`
-- Test: `pnpm test`
-
-## Install
-
-```bash
-# pnpm (recommended)
-pnpm add linkedin-secret-sauce
-
-# npm
-npm install linkedin-secret-sauce
-```
-
-## Quick Start
-
-```ts
-import {
-  initializeLinkedInClient,
-  getProfileByVanity,
-  getProfileByUrn,
-  searchSalesLeads,
-  resolveCompanyUniversalName,
-  getCompanyById,
-  getCompanyByUrl,
-  typeahead,
-  getSalesNavigatorProfileDetails,
-  type LinkedInProfile,
-  type SearchSalesResult,
-  type Company,
-  type TypeaheadResult,
-  type SalesNavigatorProfile,
-} from 'linkedin-secret-sauce';
-
-initializeLinkedInClient({
-  cosiallApiUrl: process.env.COSIALL_API_URL!,
-  cosiallApiKey: process.env.COSIALL_API_KEY!,
-  proxyString: process.env.LINKEDIN_PROXY_STRING, // optional
-  logLevel: (process.env.LOG_LEVEL as any) || 'info',
-});
-
-const prof: LinkedInProfile = await getProfileByVanity('john-doe');
-const prof2 = await getProfileByUrn('urn:li:fsd_profile:ACwAAAbCdEf'); // URN or bare key
-
-// Search with paging; on HTTP 400, decoration -14 falls back to -17
-const leads: SearchSalesResult = await searchSalesLeads('cto fintech', { start: 50, count: 10 });
-
-// Companies
-const { companyId } = await resolveCompanyUniversalName('microsoft');
-const company: Company = await getCompanyById(companyId!);
-const sameCompany = await getCompanyByUrl('https://www.linkedin.com/company/microsoft/');
-
-// Typeahead (facet suggestions)
-const ta: TypeaheadResult = await typeahead({ type: 'BING_GEO', query: 'new', start: 0, count: 10 });
-
-// Sales Navigator profile details
-const sales: SalesNavigatorProfile = await getSalesNavigatorProfileDetails('urn:li:fs_salesProfile:ACwAAA...');
-```
-
-## Environment & Config
-
-Required
-- `COSIALL_API_URL` – base URL of your Cosiall service (e.g., https://cosiall.example)
-- `COSIALL_API_KEY` – API key for the Cosiall endpoint
-
-Optional
-- `LINKEDIN_PROXY_STRING` – `host:port` or `host:port:user:pass`
-- `LOG_LEVEL` – `debug` | `info` | `warn` | `error` (default `info`)
-
-Config defaults (override in code as needed)
-- `profileCacheTtl`: 900_000 ms (15m)
-- `searchCacheTtl`: 180_000 ms (3m)
-- `companyCacheTtl`: 600_000 ms (10m)
-- `typeaheadCacheTtl`: 3_600_000 ms (1h)
-- `cookieRefreshInterval`: 900_000 ms (15m)
-- `cookieFreshnessWindow`: 86_400_000 ms (24h)
-- `maxRetries`: 2 (5xx retry on same account)
-- `retryDelayMs`: 700 ms
-- `accountCooldownMs`: 5_000 ms
-- `maxFailuresBeforeCooldown`: 3
-- `maxRequestHistory`: 500
-
-## Public API (overview)
-
-- Profiles
-  - `getProfileByVanity(vanity)` – cached 15m, in‑flight de‑dupe per key.
-  - `getProfileByUrn(keyOrUrn)` – accepts `ACwAA...` or URNs; normalizes to key.
-  - `getProfilesBatch(vanities, concurrency)` – returns array aligned to inputs; `null` for failures.
-
-- Search
-  - `searchSalesLeads(keywords, { start, count, decorationId })` – when options are provided returns `{ items, page }`; on HTTP 400 with `-14` decoration automatically retries with `-17`.
-
-- Companies
-  - `resolveCompanyUniversalName(universalName)` → `{ companyId? }` (404 → NOT_FOUND)
-  - `getCompanyById(companyId)` → `Company` (10m cache)
-  - `getCompanyByUrl(url)` – parses numeric id or slug, then fetches
-
-- Typeahead
-  - `typeahead({ type, query, start, count })` → `TypeaheadResult` (1h cache)
-
-- Sales Navigator profile
-  - `getSalesNavigatorProfileDetails(idOrUrn)` → `SalesNavigatorProfile` (404 → NOT_FOUND)
-
-## Errors
-
-All errors are `LinkedInClientError` with fields `{ code, status?, accountId? }`.
-
-Error codes (non‑exhaustive)
-- `NOT_INITIALIZED`, `NO_ACCOUNTS`, `NO_VALID_ACCOUNTS`
-- `MISSING_CSRF`, `REQUEST_FAILED`, `ALL_ACCOUNTS_FAILED`, `PARSE_ERROR`
-- `INVALID_INPUT`, `NOT_FOUND`, `AUTH_ERROR`, `RATE_LIMITED`
-
-## Caching, Metrics, Proxy
-
-- Per‑process in‑memory caches with TTLs listed above. Expired entries are evicted on access.
-- In‑flight de‑dupe for `getProfileByVanity`.
-- HTTP client rotates accounts on 401/403/429 and retries 5xx on same account (`maxRetries`).
-- Metrics snapshot: `import { getSnapshot }` for counters (requests, retries, cache hits, etc.).
-- Request history: `import { getRequestHistory, clearRequestHistory }` for a bounded in‑memory log.
-- Proxy: set `proxyString` in config (formats `host:port` or `host:port:user:pass`).
-
-### Request History and Metrics (example)
-
-```ts
-import { getRequestHistory, clearRequestHistory, getSnapshot } from 'linkedin-secret-sauce';
-
-clearRequestHistory();
-// ... make some API calls ...
-console.log(getRequestHistory()[0]);
-// {
-//   timestamp: 1730000000000,
-//   operation: 'getProfileByVanity',
-//   selector: 'https://www.linkedin.com/voyager/api/...profiles?q=memberIdentity&memberIdentity=john-doe',
-//   status: 200,
-//   durationMs: 123,
-//   accountId: 'acc1'
-// }
-
-console.log(getSnapshot());
-// {
-//   profileFetches: 12,
-//   profileCacheHits: 34,
-//   inflightDedupeHits: 2,
-//   searchCacheHits: 5,
-//   typeaheadCacheHits: 3,
-//   companyCacheHits: 4,
-//   httpRetries: 3,
-//   httpSuccess: 21,
-//   httpFailures: 2,
-//   companyFetches: 4,
-//   typeaheadRequests: 5,
-//   requestHistorySize: 42,
-//   authErrors: 1,
-//   ...
-// }
-```
-
-### Accounts Summary
-
-```ts
-import { getAccountsSummary } from 'linkedin-secret-sauce';
-
-const accounts = getAccountsSummary();
-// [
-//   {
-//     accountId: 'acc1',
-//     healthy: false,
-//     failures: 1,
-//     cooldownUntil: 1730005000000,
-//     cooldownRemainingMs: 4200,
-//     expiresAt: 1730010000, // epoch seconds (if provided by Cosiall)
-//     lastUsedAt: 1730004000123
-//   },
-//   {
-//     accountId: 'acc2',
-//     healthy: true,
-//     failures: 0,
-//     cooldownUntil: 0,
-//     cooldownRemainingMs: 0,
-//     expiresAt: 1730010000,
-//     lastUsedAt: 1730003999000
-//   }
-// ]
-```
-
-## Testing
-
-```bash
-pnpm test
-pnpm exec tsc -p tsconfig.json --noEmit
-```
-
-## Manual Publish (npm)
-
-- Pre-checks:
-  - Working tree is clean; tests pass; `pnpm build` produced `dist/`.
-  - `publishConfig.registry` points to `https://registry.npmjs.org/` (already set).
-  - No repo `.npmrc` that overrides registry to GitHub Packages.
-
-- Steps (local):
-  1) `npm login` (once per machine; ensure correct org/user)
-  2) `npm whoami` (sanity check)
-  3) Bump version: `npm version patch|minor|major`
-  4) Publish: `npm publish`
-  5) Push tags: `git push --follow-tags`
-
-Notes:
-- If your npm account enforces 2FA for publish, you’ll be prompted for an OTP.
-- 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.
-
-
+# LinkedIn Secret Sauce Client
+
+Private, server-side LinkedIn Sales Navigator client. It manages cookies/accounts, retries, caching, and parsing so your app calls a small, typed API.
+
+For a step‑by‑step integration guide you can copy/paste into other apps, see `docs/INTEGRATION.md`.
+
+Advanced lead search
+- Strongly‑typed filters: see `docs/SALES_SEARCH.md` (seniority, titles with id or text, functions, industries, languages, regions, company headcount/type, years buckets, current company).
+- Relationship filters are intentionally not used (results are customer‑agnostic).
+- Past company is not emitted — only CURRENT_COMPANY is supported.
+- Power users: pass a full `rawQuery` string to `searchSalesLeads` if you already have the Sales Navigator `query=(...)` payload.
+
+- Node: >= 18 (uses global `fetch`)
+- Build: `pnpm build`
+- Test: `pnpm test`
+
+## Install
+
+```bash
+# pnpm (recommended)
+pnpm add linkedin-secret-sauce
+
+# npm
+npm install linkedin-secret-sauce
+```
+
+## Quick Start
+
+```ts
+import {
+  initializeLinkedInClient,
+  getProfileByVanity,
+  getProfileByUrn,
+  searchSalesLeads,
+  resolveCompanyUniversalName,
+  getCompanyById,
+  getCompanyByUrl,
+  typeahead,
+  getSalesNavigatorProfileDetails,
+  type LinkedInProfile,
+  type SearchSalesResult,
+  type Company,
+  type TypeaheadResult,
+  type SalesNavigatorProfile,
+} from 'linkedin-secret-sauce';
+
+initializeLinkedInClient({
+  cosiallApiUrl: process.env.COSIALL_API_URL!,
+  cosiallApiKey: process.env.COSIALL_API_KEY!,
+  proxyString: process.env.LINKEDIN_PROXY_STRING, // optional
+  logLevel: (process.env.LOG_LEVEL as any) || 'info',
+});
+
+const prof: LinkedInProfile = await getProfileByVanity('john-doe');
+const prof2 = await getProfileByUrn('urn:li:fsd_profile:ACwAAAbCdEf'); // URN or bare key
+
+// Search with paging; uses LeadSearchResult-14 for complete profile data (positions, badges, etc.)
+const leads: SearchSalesResult = await searchSalesLeads('cto fintech', { start: 50, count: 10 });
+
+// Companies
+const { companyId } = await resolveCompanyUniversalName('microsoft');
+const company: Company = await getCompanyById(companyId!);
+const sameCompany = await getCompanyByUrl('https://www.linkedin.com/company/microsoft/');
+
+// Typeahead (facet suggestions)
+const ta: TypeaheadResult = await typeahead({ type: 'BING_GEO', query: 'new', start: 0, count: 10 });
+
+// Sales Navigator profile details
+const sales: SalesNavigatorProfile = await getSalesNavigatorProfileDetails('urn:li:fs_salesProfile:ACwAAA...');
+```
+
+## Environment & Config
+
+Required
+- `COSIALL_API_URL` – base URL of your Cosiall service (e.g., https://cosiall.example)
+- `COSIALL_API_KEY` – API key for the Cosiall endpoint
+
+Optional
+- `LINKEDIN_PROXY_STRING` – `host:port` or `host:port:user:pass`
+- `LOG_LEVEL` – `debug` | `info` | `warn` | `error` (default `info`)
+
+Config defaults (override in code as needed)
+- `profileCacheTtl`: 900_000 ms (15m)
+- `searchCacheTtl`: 180_000 ms (3m)
+- `companyCacheTtl`: 600_000 ms (10m)
+- `typeaheadCacheTtl`: 3_600_000 ms (1h)
+- `cookieRefreshInterval`: 900_000 ms (15m)
+- `cookieFreshnessWindow`: 86_400_000 ms (24h)
+- `maxRetries`: 2 (5xx retry on same account)
+- `retryDelayMs`: 700 ms
+- `accountCooldownMs`: 5_000 ms
+- `maxFailuresBeforeCooldown`: 3
+- `maxRequestHistory`: 500
+
+## Public API (overview)
+
+- Profiles
+  - `getProfileByVanity(vanity)` – cached 15m, in‑flight de‑dupe per key.
+  - `getProfileByUrn(keyOrUrn)` – accepts `ACwAA...` or URNs; normalizes to key.
+  - `getProfilesBatch(vanities, concurrency)` – returns array aligned to inputs; `null` for failures.
+
+- Search
+  - `searchSalesLeads(keywords, { start, count, decorationId })` – when options are provided returns `{ items, page }`; uses LeadSearchResult-14 by default for complete profile data.
+
+- Companies
+  - `resolveCompanyUniversalName(universalName)` → `{ companyId? }` (404 → NOT_FOUND)
+  - `getCompanyById(companyId)` → `Company` (10m cache)
+  - `getCompanyByUrl(url)` – parses numeric id or slug, then fetches
+
+- Typeahead
+  - `typeahead({ type, query, start, count })` → `TypeaheadResult` (1h cache)
+
+- Sales Navigator profile
+  - `getSalesNavigatorProfileDetails(idOrUrn)` → `SalesNavigatorProfile` (404 → NOT_FOUND)
+
+## Errors
+
+All errors are `LinkedInClientError` with fields `{ code, status?, accountId? }`.
+
+Error codes (non‑exhaustive)
+- `NOT_INITIALIZED`, `NO_ACCOUNTS`, `NO_VALID_ACCOUNTS`
+- `MISSING_CSRF`, `REQUEST_FAILED`, `ALL_ACCOUNTS_FAILED`, `PARSE_ERROR`
+- `INVALID_INPUT`, `NOT_FOUND`, `AUTH_ERROR`, `RATE_LIMITED`
+
+## Caching, Metrics, Proxy
+
+- Per‑process in‑memory caches with TTLs listed above. Expired entries are evicted on access.
+- In‑flight de‑dupe for `getProfileByVanity`.
+- HTTP client rotates accounts on 401/403/429 and retries 5xx on same account (`maxRetries`).
+- Metrics snapshot: `import { getSnapshot }` for counters (requests, retries, cache hits, etc.).
+- Request history: `import { getRequestHistory, clearRequestHistory }` for a bounded in‑memory log.
+- Proxy: set `proxyString` in config (formats `host:port` or `host:port:user:pass`).
+
+### Request History and Metrics (example)
+
+```ts
+import { getRequestHistory, clearRequestHistory, getSnapshot } from 'linkedin-secret-sauce';
+
+clearRequestHistory();
+// ... make some API calls ...
+console.log(getRequestHistory()[0]);
+// {
+//   timestamp: 1730000000000,
+//   operation: 'getProfileByVanity',
+//   selector: 'https://www.linkedin.com/voyager/api/...profiles?q=memberIdentity&memberIdentity=john-doe',
+//   status: 200,
+//   durationMs: 123,
+//   accountId: 'acc1'
+// }
+
+console.log(getSnapshot());
+// {
+//   profileFetches: 12,
+//   profileCacheHits: 34,
+//   inflightDedupeHits: 2,
+//   searchCacheHits: 5,
+//   typeaheadCacheHits: 3,
+//   companyCacheHits: 4,
+//   httpRetries: 3,
+//   httpSuccess: 21,
+//   httpFailures: 2,
+//   companyFetches: 4,
+//   typeaheadRequests: 5,
+//   requestHistorySize: 42,
+//   authErrors: 1,
+//   ...
+// }
+```
+
+### Accounts Summary
+
+```ts
+import { getAccountsSummary } from 'linkedin-secret-sauce';
+
+const accounts = getAccountsSummary();
+// [
+//   {
+//     accountId: 'acc1',
+//     healthy: false,
+//     failures: 1,
+//     cooldownUntil: 1730005000000,
+//     cooldownRemainingMs: 4200,
+//     expiresAt: 1730010000, // epoch seconds (if provided by Cosiall)
+//     lastUsedAt: 1730004000123
+//   },
+//   {
+//     accountId: 'acc2',
+//     healthy: true,
+//     failures: 0,
+//     cooldownUntil: 0,
+//     cooldownRemainingMs: 0,
+//     expiresAt: 1730010000,
+//     lastUsedAt: 1730003999000
+//   }
+// ]
+```
+
+## Testing
+
+```bash
+pnpm test
+pnpm exec tsc -p tsconfig.json --noEmit
+```
+
+## Manual Publish (npm)
+
+- Pre-checks:
+  - Working tree is clean; tests pass; `pnpm build` produced `dist/`.
+  - `publishConfig.registry` points to `https://registry.npmjs.org/` (already set).
+  - No repo `.npmrc` that overrides registry to GitHub Packages.
+
+- Steps (local):
+  1) `npm login` (once per machine; ensure correct org/user)
+  2) `npm whoami` (sanity check)
+  3) Bump version: `npm version patch|minor|major`
+  4) Publish: `npm publish`
+  5) Push tags: `git push --follow-tags`
+
+Notes:
+- If your npm account enforces 2FA for publish, you’ll be prompted for an OTP.
+- 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.
+
+
 ## 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)
-
-See `docs/PLAYGROUND.md` for usage, ports, and tips.
+## Playground (local UI)
+
+See `docs/PLAYGROUND.md` for usage, ports, and tips.

package/dist/constants.d.ts

@@ -0,0 +1,388 @@
+/**
+ * Static filter constants for LinkedIn Sales Navigator
+ * These provide instant default options without requiring API calls
+ */
+export declare const SENIORITY_OPTIONS: readonly [{
+    readonly id: "1";
+    readonly text: "Unpaid";
+}, {
+    readonly id: "2";
+    readonly text: "Training";
+}, {
+    readonly id: "3";
+    readonly text: "Entry level";
+}, {
+    readonly id: "4";
+    readonly text: "Senior";
+}, {
+    readonly id: "5";
+    readonly text: "Manager";
+}, {
+    readonly id: "6";
+    readonly text: "Director";
+}, {
+    readonly id: "7";
+    readonly text: "VP";
+}, {
+    readonly id: "8";
+    readonly text: "CXO";
+}, {
+    readonly id: "9";
+    readonly text: "Partner";
+}, {
+    readonly id: "10";
+    readonly text: "Owner";
+}];
+export declare const YEARS_OPTIONS: readonly [{
+    readonly id: "1";
+    readonly text: "< 1 year";
+}, {
+    readonly id: "2";
+    readonly text: "1-2 years";
+}, {
+    readonly id: "3";
+    readonly text: "3-5 years";
+}, {
+    readonly id: "4";
+    readonly text: "6-10 years";
+}, {
+    readonly id: "5";
+    readonly text: "10+ years";
+}];
+export declare const FUNCTION_OPTIONS: readonly [{
+    readonly id: "1";
+    readonly text: "Accounting";
+}, {
+    readonly id: "2";
+    readonly text: "Administrative";
+}, {
+    readonly id: "3";
+    readonly text: "Arts and Design";
+}, {
+    readonly id: "4";
+    readonly text: "Business Development";
+}, {
+    readonly id: "5";
+    readonly text: "Community and Social Services";
+}, {
+    readonly id: "6";
+    readonly text: "Consulting";
+}, {
+    readonly id: "7";
+    readonly text: "Education";
+}, {
+    readonly id: "8";
+    readonly text: "Engineering";
+}, {
+    readonly id: "9";
+    readonly text: "Entrepreneurship";
+}, {
+    readonly id: "10";
+    readonly text: "Finance";
+}, {
+    readonly id: "11";
+    readonly text: "Healthcare Services";
+}, {
+    readonly id: "12";
+    readonly text: "Human Resources";
+}, {
+    readonly id: "13";
+    readonly text: "Information Technology";
+}, {
+    readonly id: "14";
+    readonly text: "Legal";
+}, {
+    readonly id: "15";
+    readonly text: "Marketing";
+}, {
+    readonly id: "16";
+    readonly text: "Media and Communication";
+}, {
+    readonly id: "17";
+    readonly text: "Military and Protective Services";
+}, {
+    readonly id: "18";
+    readonly text: "Operations";
+}, {
+    readonly id: "19";
+    readonly text: "Product Management";
+}, {
+    readonly id: "20";
+    readonly text: "Program and Project Management";
+}, {
+    readonly id: "21";
+    readonly text: "Purchasing";
+}, {
+    readonly id: "22";
+    readonly text: "Quality Assurance";
+}, {
+    readonly id: "23";
+    readonly text: "Real Estate";
+}, {
+    readonly id: "24";
+    readonly text: "Research";
+}, {
+    readonly id: "25";
+    readonly text: "Sales";
+}, {
+    readonly id: "26";
+    readonly text: "Support";
+}];
+export declare const REGION_OPTIONS: readonly [{
+    readonly id: "102890883";
+    readonly text: "Oceania";
+}, {
+    readonly id: "100506914";
+    readonly text: "EMEA";
+}, {
+    readonly id: "105015875";
+    readonly text: "DACH";
+}, {
+    readonly id: "102221843";
+    readonly text: "North America";
+}, {
+    readonly id: "104738515";
+    readonly text: "South America";
+}, {
+    readonly id: "90009706";
+    readonly text: "Southeast Asia";
+}, {
+    readonly id: "102393603";
+    readonly text: "Asia-Pacific";
+}, {
+    readonly id: "90000084";
+    readonly text: "Europe";
+}, {
+    readonly id: "106155005";
+    readonly text: "Middle East";
+}, {
+    readonly id: "103883259";
+    readonly text: "Latin America";
+}, {
+    readonly id: "91000002";
+    readonly text: "Africa";
+}, {
+    readonly id: "102095887";
+    readonly text: "Caribbean";
+}, {
+    readonly id: "90009790";
+    readonly text: "Central Asia";
+}];
+export declare const LANGUAGE_OPTIONS: readonly [{
+    readonly id: "ar";
+    readonly text: "Arabic";
+}, {
+    readonly id: "zh";
+    readonly text: "Chinese";
+}, {
+    readonly id: "cs";
+    readonly text: "Czech";
+}, {
+    readonly id: "da";
+    readonly text: "Danish";
+}, {
+    readonly id: "nl";
+    readonly text: "Dutch";
+}, {
+    readonly id: "en";
+    readonly text: "English";
+}, {
+    readonly id: "fr";
+    readonly text: "French";
+}, {
+    readonly id: "de";
+    readonly text: "German";
+}, {
+    readonly id: "in";
+    readonly text: "Indonesian";
+}, {
+    readonly id: "it";
+    readonly text: "Italian";
+}, {
+    readonly id: "ja";
+    readonly text: "Japanese";
+}, {
+    readonly id: "ko";
+    readonly text: "Korean";
+}, {
+    readonly id: "ms";
+    readonly text: "Malay";
+}, {
+    readonly id: "no";
+    readonly text: "Norwegian";
+}, {
+    readonly id: "pl";
+    readonly text: "Polish";
+}, {
+    readonly id: "pt";
+    readonly text: "Portuguese";
+}, {
+    readonly id: "ro";
+    readonly text: "Romanian";
+}, {
+    readonly id: "ru";
+    readonly text: "Russian";
+}, {
+    readonly id: "es";
+    readonly text: "Spanish";
+}, {
+    readonly id: "sv";
+    readonly text: "Swedish";
+}, {
+    readonly id: "tl";
+    readonly text: "Tagalog";
+}, {
+    readonly id: "tr";
+    readonly text: "Turkish";
+}];
+export declare const INDUSTRY_OPTIONS: readonly [{
+    readonly id: "3";
+    readonly text: "Accounting";
+}, {
+    readonly id: "47";
+    readonly text: "Airlines/Aviation";
+}, {
+    readonly id: "94";
+    readonly text: "Alternative Dispute Resolution";
+}, {
+    readonly id: "120";
+    readonly text: "Alternative Medicine";
+}, {
+    readonly id: "125";
+    readonly text: "Animation";
+}, {
+    readonly id: "127";
+    readonly text: "Apparel & Fashion";
+}, {
+    readonly id: "19";
+    readonly text: "Architecture & Planning";
+}, {
+    readonly id: "50";
+    readonly text: "Arts and Crafts";
+}, {
+    readonly id: "111";
+    readonly text: "Automotive";
+}, {
+    readonly id: "12";
+    readonly text: "Aviation & Aerospace";
+}, {
+    readonly id: "36";
+    readonly text: "Banking";
+}, {
+    readonly id: "49";
+    readonly text: "Biotechnology";
+}, {
+    readonly id: "138";
+    readonly text: "Broadcast Media";
+}, {
+    readonly id: "129";
+    readonly text: "Building Materials";
+}, {
+    readonly id: "54";
+    readonly text: "Business Supplies and Equipment";
+}, {
+    readonly id: "59";
+    readonly text: "Chemicals";
+}, {
+    readonly id: "90";
+    readonly text: "Civic & Social Organization";
+}, {
+    readonly id: "51";
+    readonly text: "Civil Engineering";
+}, {
+    readonly id: "128";
+    readonly text: "Commercial Real Estate";
+}, {
+    readonly id: "118";
+    readonly text: "Computer & Network Security";
+}, {
+    readonly id: "109";
+    readonly text: "Computer Games";
+}, {
+    readonly id: "3";
+    readonly text: "Computer Hardware";
+}, {
+    readonly id: "5";
+    readonly text: "Computer Networking";
+}, {
+    readonly id: "4";
+    readonly text: "Computer Software";
+}, {
+    readonly id: "48";
+    readonly text: "Construction";
+}, {
+    readonly id: "24";
+    readonly text: "Consumer Electronics";
+}, {
+    readonly id: "25";
+    readonly text: "Consumer Goods";
+}, {
+    readonly id: "91";
+    readonly text: "Consumer Services";
+}, {
+    readonly id: "18";
+    readonly text: "Cosmetics";
+}, {
+    readonly id: "65";
+    readonly text: "Dairy";
+}, {
+    readonly id: "1";
+    readonly text: "Defense & Space";
+}, {
+    readonly id: "99";
+    readonly text: "Design";
+}, {
+    readonly id: "69";
+    readonly text: "Education Management";
+}, {
+    readonly id: "132";
+    readonly text: "E-Learning";
+}, {
+    readonly id: "112";
+    readonly text: "Electrical/Electronic Manufacturing";
+}, {
+    readonly id: "28";
+    readonly text: "Entertainment";
+}, {
+    readonly id: "86";
+    readonly text: "Environmental Services";
+}, {
+    readonly id: "110";
+    readonly text: "Events Services";
+}, {
+    readonly id: "76";
+    readonly text: "Executive Office";
+}, {
+    readonly id: "122";
+    readonly text: "Facilities Services";
+}, {
+    readonly id: "63";
+    readonly text: "Farming";
+}, {
+    readonly id: "43";
+    readonly text: "Financial Services";
+}, {
+    readonly id: "38";
+    readonly text: "Fine Art";
+}, {
+    readonly id: "66";
+    readonly text: "Fishery";
+}, {
+    readonly id: "34";
+    readonly text: "Food & Beverages";
+}, {
+    readonly id: "23";
+    readonly text: "Food Production";
+}, {
+    readonly id: "101";
+    readonly text: "Fund-Raising";
+}, {
+    readonly id: "26";
+    readonly text: "Furniture";
+}, {
+    readonly id: "29";
+    readonly text: "Gambling & Casinos";
+}, {
+    readonly id: "145";
+    readonly text: "Glass, Ceramics & Concrete";
+}];

package/dist/constants.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Static filter constants for LinkedIn Sales Navigator
+ * These provide instant default options without requiring API calls
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INDUSTRY_OPTIONS = exports.LANGUAGE_OPTIONS = exports.REGION_OPTIONS = exports.FUNCTION_OPTIONS = exports.YEARS_OPTIONS = exports.SENIORITY_OPTIONS = void 0;
+// Seniority Levels - LinkedIn fixed levels
+exports.SENIORITY_OPTIONS = [
+    { id: "1", text: "Unpaid" },
+    { id: "2", text: "Training" },
+    { id: "3", text: "Entry level" },
+    { id: "4", text: "Senior" },
+    { id: "5", text: "Manager" },
+    { id: "6", text: "Director" },
+    { id: "7", text: "VP" },
+    { id: "8", text: "CXO" },
+    { id: "9", text: "Partner" },
+    { id: "10", text: "Owner" },
+];
+// Years filters - LinkedIn fixed ranges
+exports.YEARS_OPTIONS = [
+    { id: "1", text: "< 1 year" },
+    { id: "2", text: "1-2 years" },
+    { id: "3", text: "3-5 years" },
+    { id: "4", text: "6-10 years" },
+    { id: "5", text: "10+ years" },
+];
+// Role Functions - top 26 most common functions
+exports.FUNCTION_OPTIONS = [
+    { id: "1", text: "Accounting" },
+    { id: "2", text: "Administrative" },
+    { id: "3", text: "Arts and Design" },
+    { id: "4", text: "Business Development" },
+    { id: "5", text: "Community and Social Services" },
+    { id: "6", text: "Consulting" },
+    { id: "7", text: "Education" },
+    { id: "8", text: "Engineering" },
+    { id: "9", text: "Entrepreneurship" },
+    { id: "10", text: "Finance" },
+    { id: "11", text: "Healthcare Services" },
+    { id: "12", text: "Human Resources" },
+    { id: "13", text: "Information Technology" },
+    { id: "14", text: "Legal" },
+    { id: "15", text: "Marketing" },
+    { id: "16", text: "Media and Communication" },
+    { id: "17", text: "Military and Protective Services" },
+    { id: "18", text: "Operations" },
+    { id: "19", text: "Product Management" },
+    { id: "20", text: "Program and Project Management" },
+    { id: "21", text: "Purchasing" },
+    { id: "22", text: "Quality Assurance" },
+    { id: "23", text: "Real Estate" },
+    { id: "24", text: "Research" },
+    { id: "25", text: "Sales" },
+    { id: "26", text: "Support" },
+];
+// Geographic Regions - 13 major regions
+exports.REGION_OPTIONS = [
+    { id: "102890883", text: "Oceania" },
+    { id: "100506914", text: "EMEA" },
+    { id: "105015875", text: "DACH" },
+    { id: "102221843", text: "North America" },
+    { id: "104738515", text: "South America" },
+    { id: "90009706", text: "Southeast Asia" },
+    { id: "102393603", text: "Asia-Pacific" },
+    { id: "90000084", text: "Europe" },
+    { id: "106155005", text: "Middle East" },
+    { id: "103883259", text: "Latin America" },
+    { id: "91000002", text: "Africa" },
+    { id: "102095887", text: "Caribbean" },
+    { id: "90009790", text: "Central Asia" },
+];
+// Profile Languages - 22 most common languages
+exports.LANGUAGE_OPTIONS = [
+    { id: "ar", text: "Arabic" },
+    { id: "zh", text: "Chinese" },
+    { id: "cs", text: "Czech" },
+    { id: "da", text: "Danish" },
+    { id: "nl", text: "Dutch" },
+    { id: "en", text: "English" },
+    { id: "fr", text: "French" },
+    { id: "de", text: "German" },
+    { id: "in", text: "Indonesian" },
+    { id: "it", text: "Italian" },
+    { id: "ja", text: "Japanese" },
+    { id: "ko", text: "Korean" },
+    { id: "ms", text: "Malay" },
+    { id: "no", text: "Norwegian" },
+    { id: "pl", text: "Polish" },
+    { id: "pt", text: "Portuguese" },
+    { id: "ro", text: "Romanian" },
+    { id: "ru", text: "Russian" },
+    { id: "es", text: "Spanish" },
+    { id: "sv", text: "Swedish" },
+    { id: "tl", text: "Tagalog" },
+    { id: "tr", text: "Turkish" },
+];
+// Industries - top 50 most common industries from 400+ available
+exports.INDUSTRY_OPTIONS = [
+    { id: "3", text: "Accounting" },
+    { id: "47", text: "Airlines/Aviation" },
+    { id: "94", text: "Alternative Dispute Resolution" },
+    { id: "120", text: "Alternative Medicine" },
+    { id: "125", text: "Animation" },
+    { id: "127", text: "Apparel & Fashion" },
+    { id: "19", text: "Architecture & Planning" },
+    { id: "50", text: "Arts and Crafts" },
+    { id: "111", text: "Automotive" },
+    { id: "12", text: "Aviation & Aerospace" },
+    { id: "36", text: "Banking" },
+    { id: "49", text: "Biotechnology" },
+    { id: "138", text: "Broadcast Media" },
+    { id: "129", text: "Building Materials" },
+    { id: "54", text: "Business Supplies and Equipment" },
+    { id: "59", text: "Chemicals" },
+    { id: "90", text: "Civic & Social Organization" },
+    { id: "51", text: "Civil Engineering" },
+    { id: "128", text: "Commercial Real Estate" },
+    { id: "118", text: "Computer & Network Security" },
+    { id: "109", text: "Computer Games" },
+    { id: "3", text: "Computer Hardware" },
+    { id: "5", text: "Computer Networking" },
+    { id: "4", text: "Computer Software" },
+    { id: "48", text: "Construction" },
+    { id: "24", text: "Consumer Electronics" },
+    { id: "25", text: "Consumer Goods" },
+    { id: "91", text: "Consumer Services" },
+    { id: "18", text: "Cosmetics" },
+    { id: "65", text: "Dairy" },
+    { id: "1", text: "Defense & Space" },
+    { id: "99", text: "Design" },
+    { id: "69", text: "Education Management" },
+    { id: "132", text: "E-Learning" },
+    { id: "112", text: "Electrical/Electronic Manufacturing" },
+    { id: "28", text: "Entertainment" },
+    { id: "86", text: "Environmental Services" },
+    { id: "110", text: "Events Services" },
+    { id: "76", text: "Executive Office" },
+    { id: "122", text: "Facilities Services" },
+    { id: "63", text: "Farming" },
+    { id: "43", text: "Financial Services" },
+    { id: "38", text: "Fine Art" },
+    { id: "66", text: "Fishery" },
+    { id: "34", text: "Food & Beverages" },
+    { id: "23", text: "Food Production" },
+    { id: "101", text: "Fund-Raising" },
+    { id: "26", text: "Furniture" },
+    { id: "29", text: "Gambling & Casinos" },
+    { id: "145", text: "Glass, Ceramics & Concrete" },
+];

package/dist/index.d.ts

@@ -11,3 +11,4 @@ export type { LinkedInTenure, LinkedInPosition, LinkedInSpotlightBadge, SalesLea
 export * from './utils/metrics';
 export { getRequestHistory, clearRequestHistory } from './utils/request-history';
 export type { RequestHistoryEntry } from './utils/request-history';
+export * from './constants';

package/dist/index.js

@@ -32,3 +32,4 @@ __exportStar(require("./utils/metrics"), exports);
 var request_history_1 = require("./utils/request-history");
 Object.defineProperty(exports, "getRequestHistory", { enumerable: true, get: function () { return request_history_1.getRequestHistory; } });
 Object.defineProperty(exports, "clearRequestHistory", { enumerable: true, get: function () { return request_history_1.clearRequestHistory; } });
+__exportStar(require("./constants"), exports);

package/dist/linkedin-api.d.ts

@@ -21,69 +21,7 @@ export declare function typeahead(options: {
     start?: number;
     count?: number;
 }): Promise<TypeaheadResult>;
-export declare const YEARS_AT_COMPANY_OPTIONS: readonly [{
-    readonly id: 1;
-    readonly text: "Less than 1 year";
-    readonly displayValue: "< 1 year";
-}, {
-    readonly id: 2;
-    readonly text: "1 to 2 years";
-    readonly displayValue: "1-2 years";
-}, {
-    readonly id: 3;
-    readonly text: "3 to 5 years";
-    readonly displayValue: "3-5 years";
-}, {
-    readonly id: 4;
-    readonly text: "6 to 10 years";
-    readonly displayValue: "6-10 years";
-}, {
-    readonly id: 5;
-    readonly text: "More than 10 years";
-    readonly displayValue: "10+ years";
-}];
-export declare const YEARS_IN_POSITION_OPTIONS: readonly [{
-    readonly id: 1;
-    readonly text: "Less than 1 year";
-    readonly displayValue: "< 1 year";
-}, {
-    readonly id: 2;
-    readonly text: "1 to 2 years";
-    readonly displayValue: "1-2 years";
-}, {
-    readonly id: 3;
-    readonly text: "3 to 5 years";
-    readonly displayValue: "3-5 years";
-}, {
-    readonly id: 4;
-    readonly text: "6 to 10 years";
-    readonly displayValue: "6-10 years";
-}, {
-    readonly id: 5;
-    readonly text: "More than 10 years";
-    readonly displayValue: "10+ years";
-}];
-export declare const YEARS_OF_EXPERIENCE_OPTIONS: readonly [{
-    readonly id: 1;
-    readonly text: "Less than 1 year";
-    readonly displayValue: "< 1 year";
-}, {
-    readonly id: 2;
-    readonly text: "1 to 2 years";
-    readonly displayValue: "1-2 years";
-}, {
-    readonly id: 3;
-    readonly text: "3 to 5 years";
-    readonly displayValue: "3-5 years";
-}, {
-    readonly id: 4;
-    readonly text: "6 to 10 years";
-    readonly displayValue: "6-10 years";
-}, {
-    readonly id: 5;
-    readonly text: "More than 10 years";
-    readonly displayValue: "10+ years";
-}];
+export { YEARS_OPTIONS as YEARS_AT_COMPANY_OPTIONS, YEARS_OPTIONS as YEARS_IN_POSITION_OPTIONS, YEARS_OPTIONS as YEARS_OF_EXPERIENCE_OPTIONS, SENIORITY_OPTIONS, FUNCTION_OPTIONS, REGION_OPTIONS, LANGUAGE_OPTIONS, INDUSTRY_OPTIONS, } from './constants';
 /**
  * Returns static years at company options (no API call needed)
  */

package/dist/linkedin-api.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.YEARS_OF_EXPERIENCE_OPTIONS = exports.YEARS_IN_POSITION_OPTIONS = exports.YEARS_AT_COMPANY_OPTIONS = void 0;
+exports.INDUSTRY_OPTIONS = exports.LANGUAGE_OPTIONS = exports.REGION_OPTIONS = exports.FUNCTION_OPTIONS = exports.SENIORITY_OPTIONS = exports.YEARS_OF_EXPERIENCE_OPTIONS = exports.YEARS_IN_POSITION_OPTIONS = exports.YEARS_AT_COMPANY_OPTIONS = void 0;
 exports.getProfileByVanity = getProfileByVanity;
 exports.getProfileByUrn = getProfileByUrn;
 exports.searchSalesLeads = searchSalesLeads;
@@ -22,6 +22,7 @@ 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 constants_1 = require("./constants");
 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)
@@ -345,7 +346,35 @@ async function typeahead(options) {
     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 query = (options?.query ?? '').toString().trim();
+    // Return static defaults when no query provided for supported types
+    if (!query) {
+        let staticOptions;
+        switch (type) {
+            case 'FUNCTION':
+                staticOptions = constants_1.FUNCTION_OPTIONS;
+                break;
+            case 'BING_GEO':
+                staticOptions = constants_1.REGION_OPTIONS;
+                break;
+            case 'PROFILE_LANGUAGE':
+                staticOptions = constants_1.LANGUAGE_OPTIONS;
+                break;
+            case 'INDUSTRY':
+                staticOptions = constants_1.INDUSTRY_OPTIONS;
+                break;
+            case 'SENIORITY_LEVEL':
+                staticOptions = constants_1.SENIORITY_OPTIONS;
+                break;
+        }
+        if (staticOptions) {
+            return {
+                items: staticOptions.map(opt => ({ id: String(opt.id), text: opt.text })),
+                page: { start: 0, count: staticOptions.length, total: staticOptions.length }
+            };
+        }
+    }
+    // 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);
     if (cached) {
@@ -386,37 +415,26 @@ async function typeahead(options) {
 // ---------------------------------------------------------------------------
 // Static Filters (Years) - LinkedIn has fixed ranges, no need for API calls
 // ---------------------------------------------------------------------------
-exports.YEARS_AT_COMPANY_OPTIONS = [
-    { id: 1, text: "Less than 1 year", displayValue: "< 1 year" },
-    { id: 2, text: "1 to 2 years", displayValue: "1-2 years" },
-    { id: 3, text: "3 to 5 years", displayValue: "3-5 years" },
-    { id: 4, text: "6 to 10 years", displayValue: "6-10 years" },
-    { id: 5, text: "More than 10 years", displayValue: "10+ years" },
-];
-exports.YEARS_IN_POSITION_OPTIONS = [
-    { id: 1, text: "Less than 1 year", displayValue: "< 1 year" },
-    { id: 2, text: "1 to 2 years", displayValue: "1-2 years" },
-    { id: 3, text: "3 to 5 years", displayValue: "3-5 years" },
-    { id: 4, text: "6 to 10 years", displayValue: "6-10 years" },
-    { id: 5, text: "More than 10 years", displayValue: "10+ years" },
-];
-exports.YEARS_OF_EXPERIENCE_OPTIONS = [
-    { id: 1, text: "Less than 1 year", displayValue: "< 1 year" },
-    { id: 2, text: "1 to 2 years", displayValue: "1-2 years" },
-    { id: 3, text: "3 to 5 years", displayValue: "3-5 years" },
-    { id: 4, text: "6 to 10 years", displayValue: "6-10 years" },
-    { id: 5, text: "More than 10 years", displayValue: "10+ years" },
-];
+// Re-export constants from centralized location
+var constants_2 = require("./constants");
+Object.defineProperty(exports, "YEARS_AT_COMPANY_OPTIONS", { enumerable: true, get: function () { return constants_2.YEARS_OPTIONS; } });
+Object.defineProperty(exports, "YEARS_IN_POSITION_OPTIONS", { enumerable: true, get: function () { return constants_2.YEARS_OPTIONS; } });
+Object.defineProperty(exports, "YEARS_OF_EXPERIENCE_OPTIONS", { enumerable: true, get: function () { return constants_2.YEARS_OPTIONS; } });
+Object.defineProperty(exports, "SENIORITY_OPTIONS", { enumerable: true, get: function () { return constants_2.SENIORITY_OPTIONS; } });
+Object.defineProperty(exports, "FUNCTION_OPTIONS", { enumerable: true, get: function () { return constants_2.FUNCTION_OPTIONS; } });
+Object.defineProperty(exports, "REGION_OPTIONS", { enumerable: true, get: function () { return constants_2.REGION_OPTIONS; } });
+Object.defineProperty(exports, "LANGUAGE_OPTIONS", { enumerable: true, get: function () { return constants_2.LANGUAGE_OPTIONS; } });
+Object.defineProperty(exports, "INDUSTRY_OPTIONS", { enumerable: true, get: function () { return constants_2.INDUSTRY_OPTIONS; } });
 /**
  * Returns static years at company options (no API call needed)
  */
 async function getYearsAtCompanyOptions() {
     return {
-        items: exports.YEARS_AT_COMPANY_OPTIONS.map(opt => ({ id: String(opt.id), text: opt.displayValue })),
+        items: constants_1.YEARS_OPTIONS.map(opt => ({ id: opt.id, text: opt.text })),
         page: {
             start: 0,
-            count: exports.YEARS_AT_COMPANY_OPTIONS.length,
-            total: exports.YEARS_AT_COMPANY_OPTIONS.length
+            count: constants_1.YEARS_OPTIONS.length,
+            total: constants_1.YEARS_OPTIONS.length
         }
     };
 }
@@ -425,11 +443,11 @@ async function getYearsAtCompanyOptions() {
  */
 async function getYearsInPositionOptions() {
     return {
-        items: exports.YEARS_IN_POSITION_OPTIONS.map(opt => ({ id: String(opt.id), text: opt.displayValue })),
+        items: constants_1.YEARS_OPTIONS.map(opt => ({ id: opt.id, text: opt.text })),
         page: {
             start: 0,
-            count: exports.YEARS_IN_POSITION_OPTIONS.length,
-            total: exports.YEARS_IN_POSITION_OPTIONS.length
+            count: constants_1.YEARS_OPTIONS.length,
+            total: constants_1.YEARS_OPTIONS.length
         }
     };
 }
@@ -438,11 +456,11 @@ async function getYearsInPositionOptions() {
  */
 async function getYearsOfExperienceOptions() {
     return {
-        items: exports.YEARS_OF_EXPERIENCE_OPTIONS.map(opt => ({ id: String(opt.id), text: opt.displayValue })),
+        items: constants_1.YEARS_OPTIONS.map(opt => ({ id: opt.id, text: opt.text })),
         page: {
             start: 0,
-            count: exports.YEARS_OF_EXPERIENCE_OPTIONS.length,
-            total: exports.YEARS_OF_EXPERIENCE_OPTIONS.length
+            count: constants_1.YEARS_OPTIONS.length,
+            total: constants_1.YEARS_OPTIONS.length
         }
     };
 }

package/package.json

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