@lhremote/core 0.6.0 → 0.8.0

package/dist/services/sn-url-builder.js

@@ -0,0 +1,132 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { buildBooleanExpression } from "./boolean-expression.js";
+const BASE_URL = "https://www.linkedin.com/sales/search/people";
+/**
+ * Valid Sales Navigator filter types.
+ */
+const VALID_SN_FILTER_TYPES = new Set([
+    "CURRENT_COMPANY",
+    "PAST_COMPANY",
+    "REGION",
+    "SENIORITY_LEVEL",
+    "FUNCTION",
+    "INDUSTRY",
+    "COMPANY_HEADCOUNT",
+    "COMPANY_TYPE",
+    "CURRENT_TITLE",
+    "PAST_TITLE",
+    "YEARS_AT_CURRENT_COMPANY",
+    "YEARS_AT_CURRENT_POSITION",
+    "YEARS_OF_EXPERIENCE",
+    "SCHOOL",
+    "PROFILE_LANGUAGE",
+    "GROUP",
+    "CONNECTION",
+]);
+/**
+ * Filter types only valid for basic search, not Sales Navigator.
+ */
+const BASIC_SEARCH_ONLY_FILTER_TYPES = new Set([
+    "serviceCategory",
+]);
+/**
+ * Resolve keywords to a string.
+ */
+function resolveKeywords(keywords) {
+    if (typeof keywords === "string")
+        return keywords;
+    return buildBooleanExpression(keywords);
+}
+/**
+ * Encode a single filter value in Rest.li format.
+ *
+ * Output: `(id:value,text:value,selectionType:INCLUDED)`
+ */
+function encodeFilterValue(value) {
+    const parts = [
+        `id:${encodeRestLiValue(value.id)}`,
+    ];
+    if (value.text !== undefined) {
+        parts.push(`text:${encodeRestLiValue(value.text)}`);
+    }
+    parts.push(`selectionType:${value.selectionType}`);
+    return `(${parts.join(",")})`;
+}
+/**
+ * Encode a filter in Rest.li format.
+ *
+ * Output: `(type:CURRENT_COMPANY,values:List((id:...,selectionType:INCLUDED)))`
+ */
+function encodeFilter(filter) {
+    const values = filter.values.map(encodeFilterValue).join(",");
+    return `(type:${filter.type},values:List(${values}))`;
+}
+/**
+ * Percent-encode a value for Rest.li URI format.
+ *
+ * Rest.li uses standard percent-encoding. Structural characters like
+ * parentheses and commas are added by the surrounding syntax, not as part
+ * of the encoded value, so we keep the `encodeURIComponent` output as-is.
+ */
+function encodeRestLiValue(value) {
+    return encodeURIComponent(value);
+}
+/**
+ * Build a Sales Navigator search (`/sales/search/people`) URL
+ * with Rest.li protocol encoding.
+ *
+ * @param params - SN search parameters
+ * @returns URL and any warnings
+ *
+ * @example
+ * ```ts
+ * buildSNSearchUrl({
+ *   keywords: "software engineer",
+ *   filters: [{
+ *     type: "CURRENT_COMPANY",
+ *     values: [{ id: "urn:li:organization:1441", text: "Google", selectionType: "INCLUDED" }],
+ *   }],
+ * });
+ * ```
+ */
+export function buildSNSearchUrl(params) {
+    const warnings = [];
+    const queryParts = [];
+    queryParts.push("spellCorrectionEnabled:true");
+    queryParts.push("recentSearchParam:(doLogHistory:true)");
+    // Filters
+    if (params.filters !== undefined && params.filters.length > 0) {
+        const validFilters = [];
+        for (const filter of params.filters) {
+            if (BASIC_SEARCH_ONLY_FILTER_TYPES.has(filter.type)) {
+                warnings.push(`"${filter.type}" is a basic search filter — not applicable to Sales Navigator`);
+                continue;
+            }
+            if (!VALID_SN_FILTER_TYPES.has(filter.type)) {
+                warnings.push(`Unknown Sales Navigator filter type: "${filter.type}"`);
+                continue;
+            }
+            if (filter.values.length === 0) {
+                warnings.push(`Empty values for filter "${filter.type}" — ignored`);
+                continue;
+            }
+            validFilters.push(filter);
+        }
+        if (validFilters.length > 0) {
+            const filtersList = validFilters.map(encodeFilter).join(",");
+            queryParts.push(`filters:List(${filtersList})`);
+        }
+    }
+    // Keywords
+    if (params.keywords !== undefined) {
+        const keywordsStr = resolveKeywords(params.keywords);
+        if (keywordsStr.length > 0) {
+            queryParts.push(`keywords:${encodeRestLiValue(keywordsStr)}`);
+        }
+    }
+    const query = `(${queryParts.join(",")})`;
+    const url = `${BASE_URL}?query=${query}`;
+    return { url, sourceType: "SNSearchPage", warnings };
+}
+//# sourceMappingURL=sn-url-builder.js.map

package/dist/services/sn-url-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sn-url-builder.js","sourceRoot":"","sources":["../../src/services/sn-url-builder.ts"],"names":[],"mappings":"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"}

package/dist/services/sn-url-builder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sn-url-builder.test.d.ts.map

package/dist/services/sn-url-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sn-url-builder.test.d.ts","sourceRoot":"","sources":["../../src/services/sn-url-builder.test.ts"],"names":[],"mappings":""}

package/dist/services/sn-url-builder.test.js

@@ -0,0 +1,130 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+import { detectSourceType } from "./source-type-registry.js";
+import { buildSNSearchUrl } from "./sn-url-builder.js";
+describe("buildSNSearchUrl", () => {
+    it("builds base URL with default query structure", () => {
+        const result = buildSNSearchUrl({});
+        expect(result.url).toContain("https://www.linkedin.com/sales/search/people?query=(");
+        expect(result.url).toContain("spellCorrectionEnabled:true");
+        expect(result.url).toContain("recentSearchParam:(doLogHistory:true)");
+        expect(result.sourceType).toBe("SNSearchPage");
+        expect(result.warnings).toHaveLength(0);
+    });
+    it("includes keywords in query", () => {
+        const result = buildSNSearchUrl({
+            keywords: "software engineer",
+        });
+        expect(result.url).toContain("keywords:software%20engineer");
+    });
+    it("accepts boolean expression as keywords", () => {
+        const result = buildSNSearchUrl({
+            keywords: { and: ["SaaS", "B2B"] },
+        });
+        expect(result.url).toContain("keywords:SaaS%20AND%20B2B");
+    });
+    it("encodes CURRENT_COMPANY filter in Rest.li format", () => {
+        const result = buildSNSearchUrl({
+            filters: [
+                {
+                    type: "CURRENT_COMPANY",
+                    values: [
+                        {
+                            id: "urn:li:organization:1441",
+                            text: "Google",
+                            selectionType: "INCLUDED",
+                        },
+                    ],
+                },
+            ],
+        });
+        expect(result.url).toContain("filters:List(");
+        expect(result.url).toContain("type:CURRENT_COMPANY");
+        expect(result.url).toContain("selectionType:INCLUDED");
+        expect(result.url).toContain("text:Google");
+    });
+    it("encodes multiple filters", () => {
+        const result = buildSNSearchUrl({
+            filters: [
+                {
+                    type: "CURRENT_COMPANY",
+                    values: [
+                        {
+                            id: "urn:li:organization:1441",
+                            text: "Google",
+                            selectionType: "INCLUDED",
+                        },
+                    ],
+                },
+                {
+                    type: "REGION",
+                    values: [
+                        {
+                            id: "102277331",
+                            text: "San Francisco",
+                            selectionType: "INCLUDED",
+                        },
+                    ],
+                },
+            ],
+        });
+        expect(result.url).toContain("type:CURRENT_COMPANY");
+        expect(result.url).toContain("type:REGION");
+    });
+    it("encodes EXCLUDED selectionType", () => {
+        const result = buildSNSearchUrl({
+            filters: [
+                {
+                    type: "CURRENT_TITLE",
+                    values: [
+                        {
+                            id: "intern",
+                            text: "Intern",
+                            selectionType: "EXCLUDED",
+                        },
+                    ],
+                },
+            ],
+        });
+        expect(result.url).toContain("selectionType:EXCLUDED");
+    });
+    it("warns on basic-search-only filter types", () => {
+        const result = buildSNSearchUrl({
+            filters: [
+                {
+                    type: "serviceCategory",
+                    values: [{ id: "1", selectionType: "INCLUDED" }],
+                },
+            ],
+        });
+        expect(result.warnings).toHaveLength(1);
+        expect(result.warnings[0]).toContain("basic search filter");
+    });
+    it("warns on unknown filter types", () => {
+        const result = buildSNSearchUrl({
+            filters: [
+                {
+                    type: "UNKNOWN_FILTER",
+                    values: [{ id: "1", selectionType: "INCLUDED" }],
+                },
+            ],
+        });
+        expect(result.warnings).toHaveLength(1);
+        expect(result.warnings[0]).toContain("Unknown Sales Navigator filter");
+    });
+    it("warns on empty filter values", () => {
+        const result = buildSNSearchUrl({
+            filters: [{ type: "CURRENT_COMPANY", values: [] }],
+        });
+        expect(result.warnings).toHaveLength(1);
+        expect(result.warnings[0]).toContain("Empty values");
+    });
+    it("output URL is detected as SNSearchPage", () => {
+        const result = buildSNSearchUrl({
+            keywords: "test",
+        });
+        expect(detectSourceType(result.url)).toBe("SNSearchPage");
+    });
+});
+//# sourceMappingURL=sn-url-builder.test.js.map

package/dist/services/sn-url-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sn-url-builder.test.js","sourceRoot":"","sources":["../../src/services/sn-url-builder.test.ts"],"names":[],"mappings":"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"}

package/dist/services/url-builder.d.ts

@@ -0,0 +1,12 @@
+import type { BasicSearchParams, UrlBuilderResult } from "../types/linkedin-url.js";
+/**
+ * Build a LinkedIn basic search (`/search/results/people/`) URL.
+ *
+ * Handles JSON-array encoding for faceted filters and boolean
+ * keyword composition.
+ *
+ * @param params - Search parameters
+ * @returns URL and any warnings
+ */
+export declare function buildBasicSearchUrl(params: BasicSearchParams): UrlBuilderResult;
+//# sourceMappingURL=url-builder.d.ts.map

package/dist/services/url-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.d.ts","sourceRoot":"","sources":["../../src/services/url-builder.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,iBAAiB,EAEjB,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAwClC;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,iBAAiB,GACxB,gBAAgB,CAkElB"}

package/dist/services/url-builder.js

@@ -0,0 +1,100 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { buildBooleanExpression } from "./boolean-expression.js";
+const BASE_URL = "https://www.linkedin.com/search/results/people/";
+/**
+ * Parameter names that are only valid for Sales Navigator searches.
+ * If passed to the basic search builder, a warning is emitted.
+ */
+const SN_ONLY_PARAMS = new Set([
+    "seniorityLevel",
+    "function",
+    "companyHeadcount",
+    "companyType",
+    "yearsAtCurrentCompany",
+    "yearsAtCurrentPosition",
+    "yearsOfExperience",
+]);
+/**
+ * Resolve keywords to a string.
+ *
+ * Accepts either a plain string or a structured/raw boolean expression.
+ */
+function resolveKeywords(keywords) {
+    if (typeof keywords === "string")
+        return keywords;
+    return buildBooleanExpression(keywords);
+}
+/**
+ * Encode a string array as a JSON array string for LinkedIn URL params.
+ *
+ * LinkedIn uses `["value1","value2"]` encoding for faceted filters.
+ */
+function encodeJsonArray(values) {
+    return JSON.stringify(values);
+}
+/**
+ * Build a LinkedIn basic search (`/search/results/people/`) URL.
+ *
+ * Handles JSON-array encoding for faceted filters and boolean
+ * keyword composition.
+ *
+ * @param params - Search parameters
+ * @returns URL and any warnings
+ */
+export function buildBasicSearchUrl(params) {
+    const warnings = [];
+    const searchParams = new URLSearchParams();
+    // Keywords
+    if (params.keywords !== undefined) {
+        const keywordsStr = resolveKeywords(params.keywords);
+        if (keywordsStr.length > 0) {
+            searchParams.set("keywords", keywordsStr);
+        }
+    }
+    // Faceted array filters
+    const arrayFilters = [
+        {
+            key: "currentCompany",
+            urlKey: "currentCompany",
+            values: params.currentCompany,
+        },
+        { key: "pastCompany", urlKey: "pastCompany", values: params.pastCompany },
+        { key: "geoUrn", urlKey: "geoUrn", values: params.geoUrn },
+        { key: "industry", urlKey: "industry", values: params.industry },
+        { key: "school", urlKey: "schoolFilter", values: params.school },
+        { key: "network", urlKey: "network", values: params.network },
+        {
+            key: "profileLanguage",
+            urlKey: "profileLanguage",
+            values: params.profileLanguage,
+        },
+        {
+            key: "serviceCategory",
+            urlKey: "serviceCategory",
+            values: params.serviceCategory,
+        },
+    ];
+    for (const filter of arrayFilters) {
+        if (filter.values !== undefined) {
+            if (filter.values.length === 0) {
+                warnings.push(`Empty filter array for "${filter.key}" — ignored`);
+                continue;
+            }
+            searchParams.set(filter.urlKey, encodeJsonArray(filter.values));
+        }
+    }
+    // Check for SN-only params passed via extra keys
+    // (This is a type-level guard — the BasicSearchParams interface
+    // doesn't include SN-only params, but callers may pass them via
+    // a wider type.)
+    for (const key of Object.keys(params)) {
+        if (SN_ONLY_PARAMS.has(key)) {
+            warnings.push(`"${key}" is a Sales Navigator filter — not applicable to basic search`);
+        }
+    }
+    const qs = searchParams.toString();
+    const url = qs.length > 0 ? `${BASE_URL}?${qs}` : BASE_URL;
+    return { url, sourceType: "SearchPage", warnings };
+}
+//# sourceMappingURL=url-builder.js.map

package/dist/services/url-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.js","sourceRoot":"","sources":["../../src/services/url-builder.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAOpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,MAAM,QAAQ,GAAG,iDAAiD,CAAC;AAEnE;;;GAGG;AACH,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IAClD,gBAAgB;IAChB,UAAU;IACV,kBAAkB;IAClB,aAAa;IACb,uBAAuB;IACvB,wBAAwB;IACxB,mBAAmB;CACpB,CAAC,CAAC;AAEH;;;;GAIG;AACH,SAAS,eAAe,CACtB,QAAyC;IAEzC,IAAI,OAAO,QAAQ,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,sBAAsB,CAAC,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,SAAS,eAAe,CAAC,MAAgB;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,MAAyB;IAEzB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,YAAY,GAAG,IAAI,eAAe,EAAE,CAAC;IAE3C,WAAW;IACX,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,MAAM,YAAY,GAIb;QACH;YACE,GAAG,EAAE,gBAAgB;YACrB,MAAM,EAAE,gBAAgB;YACxB,MAAM,EAAE,MAAM,CAAC,cAAc;SAC9B;QACD,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE;QACzE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAC1D,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;QAChE,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAChE,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE;QAC7D;YACE,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,MAAM,CAAC,eAAe;SAC/B;QACD;YACE,GAAG,EAAE,iBAAiB;YACtB,MAAM,EAAE,iBAAiB;YACzB,MAAM,EAAE,MAAM,CAAC,eAAe;SAC/B;KACF,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,QAAQ,CAAC,IAAI,CAAC,2BAA2B,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC;gBAClE,SAAS;YACX,CAAC;YACD,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;IAED,iDAAiD;IACjD,gEAAgE;IAChE,gEAAgE;IAChE,iBAAiB;IACjB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CACX,IAAI,GAAG,gEAAgE,CACxE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,EAAE,GAAG,YAAY,CAAC,QAAQ,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;IAE3D,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC;AACrD,CAAC"}

package/dist/services/url-builder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=url-builder.test.d.ts.map

package/dist/services/url-builder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.test.d.ts","sourceRoot":"","sources":["../../src/services/url-builder.test.ts"],"names":[],"mappings":""}

package/dist/services/url-builder.test.js

@@ -0,0 +1,79 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+import { detectSourceType } from "./source-type-registry.js";
+import { buildBasicSearchUrl } from "./url-builder.js";
+describe("buildBasicSearchUrl", () => {
+    it("builds base URL with no params", () => {
+        const result = buildBasicSearchUrl({});
+        expect(result.url).toBe("https://www.linkedin.com/search/results/people/");
+        expect(result.sourceType).toBe("SearchPage");
+        expect(result.warnings).toHaveLength(0);
+    });
+    it("includes keywords as query param", () => {
+        const result = buildBasicSearchUrl({ keywords: "software engineer" });
+        expect(result.url).toContain("keywords=software+engineer");
+    });
+    it("accepts boolean expression as keywords", () => {
+        const result = buildBasicSearchUrl({
+            keywords: { and: ["SaaS", "B2B"] },
+        });
+        expect(result.url).toContain("keywords=SaaS+AND+B2B");
+    });
+    it("accepts raw boolean expression as keywords", () => {
+        const result = buildBasicSearchUrl({
+            keywords: { raw: 'SaaS AND "VP"' },
+        });
+        expect(result.url).toContain("keywords=SaaS+AND+");
+    });
+    it("encodes currentCompany as JSON array", () => {
+        const result = buildBasicSearchUrl({ currentCompany: ["1441"] });
+        const url = new URL(result.url);
+        expect(url.searchParams.get("currentCompany")).toBe('["1441"]');
+    });
+    it("encodes multiple geoUrn values", () => {
+        const result = buildBasicSearchUrl({
+            geoUrn: ["103644278", "102277331"],
+        });
+        const url = new URL(result.url);
+        expect(url.searchParams.get("geoUrn")).toBe('["103644278","102277331"]');
+    });
+    it("encodes network filter", () => {
+        const result = buildBasicSearchUrl({ network: ["F", "S"] });
+        const url = new URL(result.url);
+        expect(url.searchParams.get("network")).toBe('["F","S"]');
+    });
+    it("encodes profileLanguage filter", () => {
+        const result = buildBasicSearchUrl({ profileLanguage: ["en"] });
+        const url = new URL(result.url);
+        expect(url.searchParams.get("profileLanguage")).toBe('["en"]');
+    });
+    it("encodes school as schoolFilter", () => {
+        const result = buildBasicSearchUrl({ school: ["13596"] });
+        const url = new URL(result.url);
+        expect(url.searchParams.get("schoolFilter")).toBe('["13596"]');
+    });
+    it("warns on empty filter arrays", () => {
+        const result = buildBasicSearchUrl({ currentCompany: [] });
+        expect(result.warnings).toHaveLength(1);
+        expect(result.warnings[0]).toContain("Empty filter array");
+    });
+    it("combines multiple filters", () => {
+        const result = buildBasicSearchUrl({
+            keywords: "software engineer",
+            currentCompany: ["1441"],
+            geoUrn: ["103644278"],
+        });
+        const url = new URL(result.url);
+        expect(url.searchParams.get("keywords")).toBe("software engineer");
+        expect(url.searchParams.get("currentCompany")).toBe('["1441"]');
+        expect(url.searchParams.get("geoUrn")).toBe('["103644278"]');
+    });
+    it("output URL is detected as SearchPage", () => {
+        const result = buildBasicSearchUrl({
+            keywords: "test",
+        });
+        expect(detectSourceType(result.url)).toBe("SearchPage");
+    });
+});
+//# sourceMappingURL=url-builder.test.js.map

package/dist/services/url-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-builder.test.js","sourceRoot":"","sources":["../../src/services/url-builder.test.ts"],"names":[],"mappings":"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"}

package/dist/services/url-templates.d.ts

@@ -0,0 +1,41 @@
+import type { SourceType } from "../types/collection.js";
+/**
+ * Check whether a source type uses a fixed URL (no parameters needed).
+ */
+export declare function isFixedUrlType(sourceType: SourceType): boolean;
+/**
+ * Check whether a source type uses a parameterised template.
+ */
+export declare function isParameterisedType(sourceType: SourceType): boolean;
+/**
+ * Check whether a source type uses the basic search URL builder.
+ */
+export declare function isSearchBuilderType(sourceType: SourceType): boolean;
+/**
+ * Check whether a source type uses the Sales Navigator URL builder.
+ */
+export declare function isSNSearchBuilderType(sourceType: SourceType): boolean;
+/**
+ * Get the fixed URL for a source type.
+ *
+ * @returns The URL, or `undefined` if the source type is not a fixed URL type.
+ */
+export declare function getFixedUrl(sourceType: SourceType): string | undefined;
+/**
+ * Build a parameterised URL for a source type.
+ *
+ * @param sourceType - The source type to build a URL for.
+ * @param params - The slug or ID to substitute.
+ * @returns The built URL, or `undefined` if the source type is not parameterised.
+ */
+export declare function buildParameterisedUrl(sourceType: SourceType, params: {
+    slug?: string;
+    id?: string;
+}): string | undefined;
+/**
+ * Get the required parameter type for a parameterised source type.
+ *
+ * @returns `"slug"`, `"id"`, or `undefined` if not a parameterised type.
+ */
+export declare function getParameterType(sourceType: SourceType): "slug" | "id" | undefined;
+//# sourceMappingURL=url-templates.d.ts.map

package/dist/services/url-templates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-templates.d.ts","sourceRoot":"","sources":["../../src/services/url-templates.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAqEzD;;GAEG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEnE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAErE;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAEtE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACrC,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,GACrB,MAAM,GAAG,IAAI,GAAG,SAAS,CAE3B"}