salesprompter-cli 0.1.19 → 0.1.22

package/dist/sales-navigator.js

@@ -80,6 +80,7 @@ export const DEFAULT_SALES_NAVIGATOR_PEOPLE_SLICE_FILTERS = [
         ],
     },
 ];
+const LINKEDIN_SALES_NAVIGATOR_PEOPLE_SEARCH_URL = "https://www.linkedin.com/sales/search/people";
 export const DEFAULT_SALES_NAVIGATOR_CRAWL_BASELINE_FILTERS = [
     {
         type: "FUNCTION",
@@ -92,27 +93,74 @@ export const DEFAULT_SALES_NAVIGATOR_CRAWL_BASELINE_FILTERS = [
         ],
     },
 ];
+const SALES_NAVIGATOR_FUNCTION_HINTS = [
+    {
+        name: "Human Resources",
+        filterValue: { id: "12", text: "Human Resources", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(human resources|hr\b|people\b|recruit|talent acquisition|talent management)/i],
+    },
+    {
+        name: "Finance",
+        filterValue: { text: "Finance", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(finance|accounting|accounts payable|accounts receivable|controller|payroll)/i],
+    },
+    {
+        name: "Information Technology",
+        filterValue: { text: "Information Technology", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(information technology|it\b|devops|infrastructure|security|help desk|service desk)/i],
+    },
+    {
+        name: "Engineering",
+        filterValue: { text: "Engineering", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(engineering|developer|software|platform engineer|technical lead|cto\b)/i],
+    },
+    {
+        name: "Sales",
+        filterValue: { text: "Sales", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(sales|revenue|account executive|business development|sales enablement)/i],
+    },
+    {
+        name: "Marketing",
+        filterValue: { text: "Marketing", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(marketing|demand generation|growth|brand|campaign)/i],
+    },
+    {
+        name: "Operations",
+        filterValue: { text: "Operations", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(operations|ops\b|supply chain|procurement|vendor management)/i],
+    },
+    {
+        name: "Legal",
+        filterValue: { text: "Legal", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(legal|compliance|general counsel|privacy)/i],
+    },
+    {
+        name: "Support",
+        filterValue: { text: "Support", selectionType: "INCLUDED" },
+        patterns: [/(^|[^a-z])(support|customer service|customer success|help center)/i],
+    },
+];
 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" },
+            { id: "D", text: "51-200", selectionType: "INCLUDED" },
+            { id: "C", text: "11-50", selectionType: "INCLUDED" },
+            { id: "E", text: "201-500", selectionType: "INCLUDED" },
+            { id: "B", text: "1-10", selectionType: "INCLUDED" },
+            { id: "F", text: "501-1000", selectionType: "INCLUDED" },
+            { id: "G", text: "1001-5000", selectionType: "INCLUDED" },
+            { id: "H", text: "5001-10,000", selectionType: "INCLUDED" },
+            { id: "I", text: "10,000+", selectionType: "INCLUDED" },
         ],
     },
     {
         key: "company-type",
         filterType: "COMPANY_TYPE",
         values: [
-            { text: "Privately Held", selectionType: "INCLUDED" },
-            { text: "Public Company", selectionType: "INCLUDED" },
+            { id: "P", text: "Privately Held", selectionType: "INCLUDED" },
+            { id: "C", text: "Public Company", selectionType: "INCLUDED" },
             { text: "Partnership", selectionType: "INCLUDED" },
             { text: "Self Owned", selectionType: "INCLUDED" },
             { text: "Non Profit", selectionType: "INCLUDED" },
@@ -124,47 +172,46 @@ export const DEFAULT_SALES_NAVIGATOR_CRAWL_DIMENSIONS = [
         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" },
+            { id: "320", text: "Owner / Partner", selectionType: "INCLUDED" },
+            { id: "310", text: "CXO", selectionType: "INCLUDED" },
+            { id: "300", text: "Vice President", selectionType: "INCLUDED" },
+            { id: "220", text: "Director", selectionType: "INCLUDED" },
+            { id: "210", text: "Experienced Manager", selectionType: "INCLUDED" },
+            { id: "120", text: "Senior", selectionType: "INCLUDED" },
+            { id: "110", text: "Entry Level", 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" },
+            { id: "1", text: "Less than 1 year", selectionType: "INCLUDED" },
+            { id: "2", text: "1 to 2 years", selectionType: "INCLUDED" },
+            { id: "3", text: "3 to 5 years", selectionType: "INCLUDED" },
+            { id: "4", text: "6 to 10 years", selectionType: "INCLUDED" },
+            { id: "5", 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" },
+            { id: "1", text: "Less than 1 year", selectionType: "INCLUDED" },
+            { id: "2", text: "1 to 2 years", selectionType: "INCLUDED" },
+            { id: "3", text: "3 to 5 years", selectionType: "INCLUDED" },
+            { id: "4", text: "6 to 10 years", selectionType: "INCLUDED" },
+            { id: "5", 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" },
+            { id: "1", text: "Less than 1 year", selectionType: "INCLUDED" },
+            { id: "2", text: "1 to 2 years", selectionType: "INCLUDED" },
+            { id: "3", text: "3 to 5 years", selectionType: "INCLUDED" },
+            { id: "4", text: "6 to 10 years", selectionType: "INCLUDED" },
+            { id: "5", text: "More than 10 years", selectionType: "INCLUDED" },
         ],
     },
 ];
@@ -306,27 +353,151 @@ export function applySalesNavigatorFiltersToQueryValue(queryValue, filters) {
     }
     return `${before}filters:List(${nextBlocks.join(",")})${after}`;
 }
-export function buildSalesNavigatorPeopleQuery(sourceQueryUrl, filters) {
+function canonicalizeSalesNavigatorQueryValue(queryValue) {
+    const { filtersContent } = findFiltersListBounds(queryValue);
+    return `(filters:List(${filtersContent}))`;
+}
+function canonicalizeSalesNavigatorPeopleSearchUrl(sourceQueryUrl) {
     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 canonicalUrl = new URL(LINKEDIN_SALES_NAVIGATOR_PEOPLE_SEARCH_URL);
+    canonicalUrl.searchParams.set("query", canonicalizeSalesNavigatorQueryValue(queryValue));
+    return canonicalUrl;
+}
+export function buildSalesNavigatorPeopleQuery(sourceQueryUrl, filters) {
+    const url = canonicalizeSalesNavigatorPeopleSearchUrl(sourceQueryUrl);
+    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,
+        sourceQueryUrl: canonicalizeSalesNavigatorPeopleSearchUrl(sourceQueryUrl).toString(),
         slicedQueryUrl: url.toString(),
         appliedFilters,
     };
 }
+export function buildSalesNavigatorPeopleSearchUrl(filters) {
+    const appliedFilters = dedupeSalesNavigatorFilters(filters);
+    if (appliedFilters.length === 0) {
+        throw new Error("Sales Navigator people search requires at least one filter.");
+    }
+    const url = new URL(LINKEDIN_SALES_NAVIGATOR_PEOPLE_SEARCH_URL);
+    url.searchParams.set("query", `(filters:List(${appliedFilters.map((filter) => buildFilterBlock(filter)).join(",")}))`);
+    return url.toString();
+}
+function inferSalesNavigatorFunctionFilters(options) {
+    const haystack = [options.title, options.categoryName, options.categorySlug]
+        .filter((value) => typeof value === "string" && value.trim().length > 0)
+        .join(" ");
+    for (const hint of SALES_NAVIGATOR_FUNCTION_HINTS) {
+        if (hint.patterns.some((pattern) => pattern.test(haystack))) {
+            return [
+                {
+                    type: "FUNCTION",
+                    values: [hint.filterValue]
+                }
+            ];
+        }
+    }
+    return [];
+}
+function normalizeSalesNavigatorTitle(title) {
+    return title
+        .replace(/[“”"']+/g, "")
+        .replace(/\s*[|/]+\s*/g, " / ")
+        .replace(/\s*&\s*/g, " & ")
+        .replace(/[–—]+/g, "-")
+        .replace(/\s+/g, " ")
+        .replace(/^[\s\-:;,]+|[\s\-:;,]+$/g, "")
+        .trim();
+}
+function canonicalizeSalesNavigatorTitleKey(title) {
+    return normalizeSalesNavigatorTitle(title)
+        .toLowerCase()
+        .replace(/&/g, " and ")
+        .replace(/[^a-z0-9]+/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+}
+export function deriveSalesNavigatorTitleQuerySeeds(options) {
+    const rankedTitles = new Map();
+    let firstSeenIndex = 0;
+    for (const item of options.items) {
+        const sourceProduct = options.sourceProductUrl === item.productUrl;
+        for (const intendedRole of item.intendedRoles) {
+            const title = normalizeSalesNavigatorTitle(intendedRole);
+            if (title.length === 0) {
+                continue;
+            }
+            const normalizedTitle = canonicalizeSalesNavigatorTitleKey(title);
+            const existing = rankedTitles.get(normalizedTitle);
+            if (existing) {
+                existing.matchedProductCount += 1;
+                existing.sourceProduct = existing.sourceProduct || sourceProduct;
+                continue;
+            }
+            rankedTitles.set(normalizedTitle, {
+                title,
+                matchedProductCount: 1,
+                sourceProduct,
+                firstSeenIndex,
+                categoryName: item.category?.name,
+                categorySlug: item.category?.slug
+            });
+            firstSeenIndex += 1;
+        }
+    }
+    const orderedTitles = [...rankedTitles.values()].sort((left, right) => {
+        if (left.sourceProduct !== right.sourceProduct) {
+            return left.sourceProduct ? -1 : 1;
+        }
+        if (left.sourceProduct && right.sourceProduct && left.firstSeenIndex !== right.firstSeenIndex) {
+            return left.firstSeenIndex - right.firstSeenIndex;
+        }
+        if (left.matchedProductCount !== right.matchedProductCount) {
+            return right.matchedProductCount - left.matchedProductCount;
+        }
+        if (left.firstSeenIndex !== right.firstSeenIndex) {
+            return left.firstSeenIndex - right.firstSeenIndex;
+        }
+        return left.title.localeCompare(right.title);
+    });
+    const limitedTitles = options.titleLimit && options.titleLimit > 0
+        ? orderedTitles.slice(0, options.titleLimit)
+        : orderedTitles;
+    return limitedTitles.map((entry) => {
+        const appliedFilters = dedupeSalesNavigatorFilters([
+            {
+                type: "CURRENT_TITLE",
+                values: [{ text: entry.title, selectionType: "INCLUDED" }]
+            },
+            ...inferSalesNavigatorFunctionFilters({
+                title: entry.title,
+                categoryName: entry.categoryName,
+                categorySlug: entry.categorySlug
+            })
+        ]);
+        return {
+            title: entry.title,
+            queryUrl: buildSalesNavigatorPeopleSearchUrl(appliedFilters),
+            appliedFilters,
+            matchedProductCount: entry.matchedProductCount,
+            sourceProduct: entry.sourceProduct
+        };
+    });
+}
 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);
+    const sliced = buildSalesNavigatorPeopleQuery(options.sourceQueryUrl, options.baselineFilters ?? []);
     return {
         ...sliced,
         depth: 0,