salesprompter-cli 0.1.17 → 0.1.18

package/dist/sales-navigator.js

@@ -0,0 +1,475 @@
+export class SalesNavigatorSliceTooBroadError extends Error {
+    totalResults;
+    details;
+    constructor(message, options) {
+        super(message);
+        this.name = "SalesNavigatorSliceTooBroadError";
+        this.totalResults = options?.totalResults ?? null;
+        this.details = options?.details;
+    }
+}
+export const DEFAULT_SALES_NAVIGATOR_PEOPLE_SLICE_FILTERS = [
+    {
+        type: "FUNCTION",
+        values: [
+            {
+                id: "12",
+                text: "Human Resources",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+    {
+        type: "SENIORITY_LEVEL",
+        values: [
+            {
+                id: "220",
+                text: "Director",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+    {
+        type: "YEARS_AT_CURRENT_COMPANY",
+        values: [
+            {
+                id: "3",
+                text: "3 to 5 years",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+    {
+        type: "YEARS_IN_CURRENT_POSITION",
+        values: [
+            {
+                id: "3",
+                text: "3 to 5 years",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+    {
+        type: "COMPANY_HEADCOUNT",
+        values: [
+            {
+                id: "D",
+                text: "51-200",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+    {
+        type: "COMPANY_TYPE",
+        values: [
+            {
+                id: "P",
+                text: "Privately Held",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+    {
+        type: "YEARS_OF_EXPERIENCE",
+        values: [
+            {
+                id: "5",
+                text: "More than 10 years",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+];
+export const DEFAULT_SALES_NAVIGATOR_CRAWL_BASELINE_FILTERS = [
+    {
+        type: "FUNCTION",
+        values: [
+            {
+                id: "12",
+                text: "Human Resources",
+                selectionType: "INCLUDED",
+            },
+        ],
+    },
+];
+export const DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS = [
+    {
+        key: "company-headcount",
+        filterType: "COMPANY_HEADCOUNT",
+        values: [
+            { text: "1-10", selectionType: "INCLUDED" },
+            { text: "11-50", selectionType: "INCLUDED" },
+            { text: "51-200", selectionType: "INCLUDED" },
+            { text: "201-500", selectionType: "INCLUDED" },
+            { text: "501-1000", selectionType: "INCLUDED" },
+            { text: "1001-5000", selectionType: "INCLUDED" },
+            { text: "5001-10,000", selectionType: "INCLUDED" },
+            { text: "10,001+", selectionType: "INCLUDED" },
+        ],
+    },
+    {
+        key: "company-type",
+        filterType: "COMPANY_TYPE",
+        values: [
+            { text: "Privately Held", selectionType: "INCLUDED" },
+            { text: "Public Company", selectionType: "INCLUDED" },
+            { text: "Partnership", selectionType: "INCLUDED" },
+            { text: "Self Owned", selectionType: "INCLUDED" },
+            { text: "Non Profit", selectionType: "INCLUDED" },
+            { text: "Educational Institution", selectionType: "INCLUDED" },
+            { text: "Government Agency", selectionType: "INCLUDED" },
+        ],
+    },
+    {
+        key: "seniority-level",
+        filterType: "SENIORITY_LEVEL",
+        values: [
+            { text: "Owner", selectionType: "INCLUDED" },
+            { text: "Partner", selectionType: "INCLUDED" },
+            { text: "CXO", selectionType: "INCLUDED" },
+            { text: "VP", selectionType: "INCLUDED" },
+            { text: "Director", selectionType: "INCLUDED" },
+            { text: "Manager", selectionType: "INCLUDED" },
+            { text: "Senior", selectionType: "INCLUDED" },
+            { text: "Entry", selectionType: "INCLUDED" },
+        ],
+    },
+    {
+        key: "years-at-company",
+        filterType: "YEARS_AT_CURRENT_COMPANY",
+        values: [
+            { text: "Less than 1 year", selectionType: "INCLUDED" },
+            { text: "1 to 2 years", selectionType: "INCLUDED" },
+            { text: "3 to 5 years", selectionType: "INCLUDED" },
+            { text: "6 to 10 years", selectionType: "INCLUDED" },
+            { text: "More than 10 years", selectionType: "INCLUDED" },
+        ],
+    },
+    {
+        key: "years-in-position",
+        filterType: "YEARS_IN_CURRENT_POSITION",
+        values: [
+            { text: "Less than 1 year", selectionType: "INCLUDED" },
+            { text: "1 to 2 years", selectionType: "INCLUDED" },
+            { text: "3 to 5 years", selectionType: "INCLUDED" },
+            { text: "6 to 10 years", selectionType: "INCLUDED" },
+            { text: "More than 10 years", selectionType: "INCLUDED" },
+        ],
+    },
+    {
+        key: "years-of-experience",
+        filterType: "YEARS_OF_EXPERIENCE",
+        values: [
+            { text: "Less than 1 year", selectionType: "INCLUDED" },
+            { text: "1 to 2 years", selectionType: "INCLUDED" },
+            { text: "3 to 5 years", selectionType: "INCLUDED" },
+            { text: "6 to 10 years", selectionType: "INCLUDED" },
+            { text: "More than 10 years", selectionType: "INCLUDED" },
+        ],
+    },
+];
+function ensureLinkedInSalesPeopleSearchUrl(url) {
+    if (!/(^|\.)linkedin\.com$/i.test(url.hostname)) {
+        throw new Error("Expected a linkedin.com Sales Navigator URL.");
+    }
+    if (!/^\/sales\/search\/people/i.test(url.pathname)) {
+        throw new Error("Expected a LinkedIn Sales Navigator people search URL.");
+    }
+    if (!url.searchParams.has("query")) {
+        throw new Error("Sales Navigator URL is missing the query parameter.");
+    }
+}
+function splitTopLevelCommaSeparated(value) {
+    const parts = [];
+    let depth = 0;
+    let start = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const char = value[index];
+        if (char === "(") {
+            depth += 1;
+            continue;
+        }
+        if (char === ")") {
+            depth = Math.max(0, depth - 1);
+            continue;
+        }
+        if (char === "," && depth === 0) {
+            const part = value.slice(start, index).trim();
+            if (part.length > 0) {
+                parts.push(part);
+            }
+            start = index + 1;
+        }
+    }
+    const tail = value.slice(start).trim();
+    if (tail.length > 0) {
+        parts.push(tail);
+    }
+    return parts;
+}
+function findFiltersListBounds(queryValue) {
+    const marker = "filters:List(";
+    const markerIndex = queryValue.indexOf(marker);
+    if (markerIndex === -1) {
+        throw new Error("Sales Navigator query is missing filters:List(...).");
+    }
+    let depth = 1;
+    let endIndex = -1;
+    for (let index = markerIndex + marker.length; index < queryValue.length; index += 1) {
+        const char = queryValue[index];
+        if (char === "(") {
+            depth += 1;
+        }
+        else if (char === ")") {
+            depth -= 1;
+            if (depth === 0) {
+                endIndex = index;
+                break;
+            }
+        }
+    }
+    if (endIndex === -1) {
+        throw new Error("Could not parse filters list from Sales Navigator query.");
+    }
+    return {
+        before: queryValue.slice(0, markerIndex),
+        filtersContent: queryValue.slice(markerIndex + marker.length, endIndex),
+        after: queryValue.slice(endIndex + 1),
+    };
+}
+function extractFilterType(block) {
+    const match = block.match(/^\(type:([A-Z_]+)/);
+    return match?.[1] ?? null;
+}
+function buildFilterBlock(filter) {
+    const encodedValues = filter.values
+        .map((value) => {
+        const selectionType = value.selectionType ?? "INCLUDED";
+        const segments = [];
+        if (typeof value.id === "string" && value.id.trim().length > 0) {
+            segments.push(`id:${value.id}`);
+        }
+        segments.push(`text:${encodeURIComponent(value.text)}`);
+        segments.push(`selectionType:${selectionType}`);
+        return `(${segments.join(",")})`;
+    })
+        .join(",");
+    return `(type:${filter.type},values:List(${encodedValues}))`;
+}
+function dedupeSalesNavigatorFilters(filters) {
+    const seen = new Set();
+    const deduped = [];
+    for (const filter of filters) {
+        const values = filter.values.filter((value) => {
+            const key = [
+                filter.type,
+                value.selectionType ?? "INCLUDED",
+                value.text.trim().toLowerCase(),
+                value.id?.trim().toLowerCase() ?? "",
+            ].join("|");
+            if (seen.has(key)) {
+                return false;
+            }
+            seen.add(key);
+            return true;
+        });
+        if (values.length > 0) {
+            deduped.push({
+                type: filter.type,
+                values,
+            });
+        }
+    }
+    return deduped;
+}
+export function applySalesNavigatorFiltersToQueryValue(queryValue, filters) {
+    const { before, filtersContent, after } = findFiltersListBounds(queryValue);
+    const existingBlocks = splitTopLevelCommaSeparated(filtersContent);
+    const replacements = new Map(filters.map((filter) => [filter.type, filter]));
+    const consumedTypes = new Set();
+    const nextBlocks = existingBlocks.map((block) => {
+        const type = extractFilterType(block);
+        if (!type) {
+            return block;
+        }
+        const replacement = replacements.get(type);
+        if (!replacement) {
+            return block;
+        }
+        consumedTypes.add(type);
+        return buildFilterBlock(replacement);
+    });
+    for (const filter of filters) {
+        if (!consumedTypes.has(filter.type)) {
+            nextBlocks.push(buildFilterBlock(filter));
+        }
+    }
+    return `${before}filters:List(${nextBlocks.join(",")})${after}`;
+}
+export function buildSalesNavigatorPeopleQuery(sourceQueryUrl, filters) {
+    const url = new URL(sourceQueryUrl);
+    ensureLinkedInSalesPeopleSearchUrl(url);
+    const queryValue = url.searchParams.get("query");
+    if (!queryValue) {
+        throw new Error("Sales Navigator URL is missing the query parameter.");
+    }
+    const appliedFilters = dedupeSalesNavigatorFilters(filters);
+    const slicedQueryValue = applySalesNavigatorFiltersToQueryValue(queryValue, appliedFilters);
+    url.searchParams.set("query", slicedQueryValue);
+    return {
+        sourceQueryUrl,
+        slicedQueryUrl: url.toString(),
+        appliedFilters,
+    };
+}
+export function buildSalesNavigatorPeopleSlice(sourceQueryUrl, filters = DEFAULT_SALES_NAVIGATOR_PEOPLE_SLICE_FILTERS) {
+    return buildSalesNavigatorPeopleQuery(sourceQueryUrl, filters);
+}
+export function createSalesNavigatorCrawlSeed(options) {
+    const sliced = buildSalesNavigatorPeopleQuery(options.sourceQueryUrl, options.baselineFilters ?? DEFAULT_SALES_NAVIGATOR_CRAWL_BASELINE_FILTERS);
+    return {
+        ...sliced,
+        depth: 0,
+        retryCount: 0,
+        maxResultsPerSearch: options.maxResultsPerSearch,
+        numberOfProfiles: options.numberOfProfiles,
+        slicePreset: options.slicePreset,
+        splitTrail: [],
+    };
+}
+export function expandSalesNavigatorCrawlAttempt(attempt, dimension) {
+    return dimension.values.map((value) => {
+        const filters = dedupeSalesNavigatorFilters([
+            ...attempt.appliedFilters.filter((filter) => filter.type !== dimension.filterType),
+            {
+                type: dimension.filterType,
+                values: [
+                    {
+                        ...value,
+                        selectionType: value.selectionType ?? "INCLUDED",
+                    },
+                ],
+            },
+        ]);
+        const sliced = buildSalesNavigatorPeopleQuery(attempt.sourceQueryUrl, filters);
+        return {
+            ...sliced,
+            depth: attempt.depth + 1,
+            retryCount: 0,
+            maxResultsPerSearch: attempt.maxResultsPerSearch,
+            numberOfProfiles: attempt.numberOfProfiles,
+            slicePreset: attempt.slicePreset,
+            splitTrail: [
+                ...attempt.splitTrail,
+                {
+                    key: dimension.key,
+                    filterType: dimension.filterType,
+                    value: {
+                        ...value,
+                        selectionType: value.selectionType ?? "INCLUDED",
+                    },
+                },
+            ],
+        };
+    });
+}
+export function buildSalesNavigatorCrawlPreview(options) {
+    const root = createSalesNavigatorCrawlSeed(options);
+    const dimensions = options.dimensions ?? DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS;
+    const firstSplit = dimensions[0] ? expandSalesNavigatorCrawlAttempt(root, dimensions[0]) : [];
+    return { root, firstSplit, dimensions };
+}
+export async function executeSalesNavigatorAdaptiveCrawl(options) {
+    const dimensions = options.dimensions ?? DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS;
+    const maxSplitDepth = Math.min(options.maxSplitDepth ?? dimensions.length, dimensions.length);
+    const maxSlices = options.maxSlices ?? 1000;
+    const maxRetries = options.maxRetries ?? 1;
+    const exported = [];
+    const splitEvents = [];
+    const failed = [];
+    const unresolved = [];
+    const queue = [
+        createSalesNavigatorCrawlSeed({
+            sourceQueryUrl: options.sourceQueryUrl,
+            baselineFilters: options.baselineFilters,
+            maxResultsPerSearch: options.maxResultsPerSearch,
+            numberOfProfiles: options.numberOfProfiles,
+            slicePreset: options.slicePreset,
+        }),
+    ];
+    const seenQueryUrls = new Set(queue.map((attempt) => attempt.slicedQueryUrl));
+    let attempted = 0;
+    let truncated = false;
+    while (queue.length > 0) {
+        if (attempted >= maxSlices) {
+            truncated = true;
+            break;
+        }
+        const attempt = queue.shift();
+        if (!attempt) {
+            break;
+        }
+        attempted += 1;
+        try {
+            const result = await options.exportSlice(attempt);
+            exported.push({ attempt, result });
+        }
+        catch (error) {
+            if (error instanceof SalesNavigatorSliceTooBroadError) {
+                const nextDimension = dimensions[attempt.depth];
+                if (!nextDimension || attempt.depth >= maxSplitDepth) {
+                    unresolved.push({
+                        attempt,
+                        error: error.message,
+                        totalResults: error.totalResults,
+                    });
+                    continue;
+                }
+                const children = expandSalesNavigatorCrawlAttempt(attempt, nextDimension).filter((child) => {
+                    if (seenQueryUrls.has(child.slicedQueryUrl)) {
+                        return false;
+                    }
+                    seenQueryUrls.add(child.slicedQueryUrl);
+                    return true;
+                });
+                if (children.length === 0) {
+                    unresolved.push({
+                        attempt,
+                        error: error.message,
+                        totalResults: error.totalResults,
+                    });
+                    continue;
+                }
+                splitEvents.push({
+                    attempt,
+                    totalResults: error.totalResults,
+                    nextDimension: nextDimension.key,
+                    childCount: children.length,
+                });
+                queue.push(...children);
+                continue;
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            if (attempt.retryCount < maxRetries) {
+                queue.push({
+                    ...attempt,
+                    retryCount: attempt.retryCount + 1,
+                });
+                continue;
+            }
+            failed.push({
+                attempt,
+                error: message,
+            });
+        }
+    }
+    return {
+        exported,
+        splitEvents,
+        failed,
+        unresolved,
+        attempted,
+        truncated,
+        remainingQueue: queue.length,
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "salesprompter-cli",
-  "version": "0.1.17",
+  "version": "0.1.18",
   "description": "JSON-first sales prospecting CLI for ICP definition, lead generation, enrichment, scoring, and CRM/outreach sync.",
   "type": "module",
   "bin": {
@@ -50,6 +50,7 @@
   },
   "license": "MIT",
   "dependencies": {
+    "cheerio": "^1.2.0",
     "commander": "^14.0.1",
     "zod": "^4.1.5"
   },