@lhremote/core 0.5.0 → 0.7.0

package/dist/services/source-type-registry.js

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Ordered list of URL patterns for source type detection.
+ *
+ * Patterns are tested in order; the first match wins.
+ */
+const SOURCE_TYPE_PATTERNS = [
+    { pattern: /\/search\/results\/people\//, sourceType: "SearchPage" },
+    { pattern: /\/mynetwork\/invite-connect\/connections\//, sourceType: "MyConnections" },
+    { pattern: /\/school\/[^/]+\/people\//, sourceType: "Alumni" },
+    { pattern: /\/company\/[^/]+\/people\//, sourceType: "OrganizationPeople" },
+    { pattern: /\/groups\/[^/]+\/members\//, sourceType: "Group" },
+    { pattern: /\/events\/[^/]+\/attendees\//, sourceType: "Event" },
+    { pattern: /\/me\/profile-views\//, sourceType: "LWVYPP" },
+    { pattern: /\/mynetwork\/invitation-manager\/sent\//, sourceType: "SentInvitationPage" },
+    { pattern: /\/me\/my-network\/followers\//, sourceType: "FollowersPage" },
+    { pattern: /\/me\/my-network\/following\//, sourceType: "FollowingPage" },
+    { pattern: /\/sales\/search\/people/, sourceType: "SNSearchPage" },
+    { pattern: /\/sales\/lists\/people\//, sourceType: "SNListPage" },
+    { pattern: /\/sales\/search\/company/, sourceType: "SNOrgsPage" },
+    { pattern: /\/sales\/lists\/company\//, sourceType: "SNOrgsListsPage" },
+    { pattern: /\/talent\/search\//, sourceType: "TSearchPage" },
+    { pattern: /\/talent\/projects\//, sourceType: "TProjectPage" },
+    { pattern: /\/recruiter\/search\//, sourceType: "RSearchPage" },
+    { pattern: /\/recruiter\/projects\//, sourceType: "RProjectPage" },
+];
+/**
+ * Set of all valid source type strings for fast validation.
+ */
+const VALID_SOURCE_TYPES = new Set(SOURCE_TYPE_PATTERNS.map((entry) => entry.sourceType));
+/**
+ * Detect the LinkedIn source type from a URL.
+ *
+ * Tests the URL pathname against known LinkedIn page patterns and
+ * returns the matching source type, or `undefined` if no pattern matches.
+ *
+ * @param url - Full LinkedIn URL or pathname
+ * @returns The detected source type, or `undefined` for unknown URLs
+ */
+export function detectSourceType(url) {
+    let pathname;
+    try {
+        pathname = new URL(url).pathname;
+    }
+    catch {
+        // Treat non-URL strings as raw pathnames
+        pathname = url;
+    }
+    for (const { pattern, sourceType } of SOURCE_TYPE_PATTERNS) {
+        if (pattern.test(pathname)) {
+            return sourceType;
+        }
+    }
+    return undefined;
+}
+/**
+ * Validate whether a string is a known source type.
+ *
+ * @param type - String to validate
+ * @returns `true` if `type` is a valid {@link SourceType}
+ */
+export function validateSourceType(type) {
+    return VALID_SOURCE_TYPES.has(type);
+}
+//# sourceMappingURL=source-type-registry.js.map

package/dist/services/source-type-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-type-registry.js","sourceRoot":"","sources":["../../src/services/source-type-registry.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAYpC;;;;GAIG;AACH,MAAM,oBAAoB,GAAwB;IAChD,EAAE,OAAO,EAAE,6BAA6B,EAAE,UAAU,EAAE,YAAY,EAAE;IACpE,EAAE,OAAO,EAAE,4CAA4C,EAAE,UAAU,EAAE,eAAe,EAAE;IACtF,EAAE,OAAO,EAAE,2BAA2B,EAAE,UAAU,EAAE,QAAQ,EAAE;IAC9D,EAAE,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,oBAAoB,EAAE;IAC3E,EAAE,OAAO,EAAE,4BAA4B,EAAE,UAAU,EAAE,OAAO,EAAE;IAC9D,EAAE,OAAO,EAAE,8BAA8B,EAAE,UAAU,EAAE,OAAO,EAAE;IAChE,EAAE,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,QAAQ,EAAE;IAC1D,EAAE,OAAO,EAAE,yCAAyC,EAAE,UAAU,EAAE,oBAAoB,EAAE;IACxF,EAAE,OAAO,EAAE,+BAA+B,EAAE,UAAU,EAAE,eAAe,EAAE;IACzE,EAAE,OAAO,EAAE,+BAA+B,EAAE,UAAU,EAAE,eAAe,EAAE;IACzE,EAAE,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,cAAc,EAAE;IAClE,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,YAAY,EAAE;IACjE,EAAE,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,YAAY,EAAE;IACjE,EAAE,OAAO,EAAE,2BAA2B,EAAE,UAAU,EAAE,iBAAiB,EAAE;IACvE,EAAE,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,aAAa,EAAE;IAC5D,EAAE,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,cAAc,EAAE;IAC/D,EAAE,OAAO,EAAE,uBAAuB,EAAE,UAAU,EAAE,aAAa,EAAE;IAC/D,EAAE,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,cAAc,EAAE;CACnE,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CACrD,oBAAoB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CACtD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,yCAAyC;QACzC,QAAQ,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,KAAK,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,oBAAoB,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,OAAO,UAAU,CAAC;QACpB,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/services/source-type-registry.test.d.ts

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

package/dist/services/source-type-registry.test.d.ts.map

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

package/dist/services/source-type-registry.test.js

@@ -0,0 +1,124 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { describe, expect, it } from "vitest";
+import { detectSourceType, validateSourceType } from "./source-type-registry.js";
+describe("detectSourceType", () => {
+    describe("Free tier", () => {
+        it("should detect SearchPage from people search URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/search/results/people/?keywords=engineer")).toBe("SearchPage");
+        });
+        it("should detect MyConnections from connections URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/mynetwork/invite-connect/connections/")).toBe("MyConnections");
+        });
+        it("should detect Alumni from school people URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/school/stanford-university/people/")).toBe("Alumni");
+        });
+        it("should detect OrganizationPeople from company people URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/company/google/people/")).toBe("OrganizationPeople");
+        });
+        it("should detect Group from group members URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/groups/12345/members/")).toBe("Group");
+        });
+        it("should detect Event from event attendees URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/events/67890/attendees/")).toBe("Event");
+        });
+        it("should detect LWVYPP from profile views URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/me/profile-views/")).toBe("LWVYPP");
+        });
+        it("should detect SentInvitationPage from sent invitations URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/mynetwork/invitation-manager/sent/")).toBe("SentInvitationPage");
+        });
+        it("should detect FollowersPage from followers URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/me/my-network/followers/")).toBe("FollowersPage");
+        });
+        it("should detect FollowingPage from following URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/me/my-network/following/")).toBe("FollowingPage");
+        });
+    });
+    describe("Sales Navigator tier", () => {
+        it("should detect SNSearchPage from Sales Navigator people search URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/sales/search/people?query=test")).toBe("SNSearchPage");
+        });
+        it("should detect SNListPage from Sales Navigator people list URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/sales/lists/people/12345")).toBe("SNListPage");
+        });
+        it("should detect SNOrgsPage from Sales Navigator company search URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/sales/search/company?query=test")).toBe("SNOrgsPage");
+        });
+        it("should detect SNOrgsListsPage from Sales Navigator company list URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/sales/lists/company/12345")).toBe("SNOrgsListsPage");
+        });
+    });
+    describe("Recruiter tier", () => {
+        it("should detect TSearchPage from Talent search URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/talent/search/?query=test")).toBe("TSearchPage");
+        });
+        it("should detect TProjectPage from Talent projects URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/talent/projects/12345")).toBe("TProjectPage");
+        });
+        it("should detect RSearchPage from Recruiter search URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/recruiter/search/?query=test")).toBe("RSearchPage");
+        });
+        it("should detect RProjectPage from Recruiter projects URL", () => {
+            expect(detectSourceType("https://www.linkedin.com/recruiter/projects/12345")).toBe("RProjectPage");
+        });
+    });
+    describe("edge cases", () => {
+        it("should return undefined for unknown URLs", () => {
+            expect(detectSourceType("https://www.linkedin.com/in/some-user")).toBeUndefined();
+        });
+        it("should return undefined for non-LinkedIn URLs", () => {
+            expect(detectSourceType("https://www.google.com/search?q=test")).toBeUndefined();
+        });
+        it("should return undefined for empty string", () => {
+            expect(detectSourceType("")).toBeUndefined();
+        });
+        it("should handle URLs with query parameters", () => {
+            expect(detectSourceType("https://www.linkedin.com/search/results/people/?keywords=test&origin=GLOBAL")).toBe("SearchPage");
+        });
+        it("should handle URLs with hash fragments", () => {
+            expect(detectSourceType("https://www.linkedin.com/search/results/people/#section")).toBe("SearchPage");
+        });
+        it("should handle raw pathnames without hostname", () => {
+            expect(detectSourceType("/search/results/people/")).toBe("SearchPage");
+        });
+    });
+});
+describe("validateSourceType", () => {
+    it("should return true for all valid source types", () => {
+        const validTypes = [
+            "SearchPage",
+            "MyConnections",
+            "Alumni",
+            "OrganizationPeople",
+            "Group",
+            "Event",
+            "LWVYPP",
+            "SentInvitationPage",
+            "FollowersPage",
+            "FollowingPage",
+            "SNSearchPage",
+            "SNListPage",
+            "SNOrgsPage",
+            "SNOrgsListsPage",
+            "TSearchPage",
+            "TProjectPage",
+            "RSearchPage",
+            "RProjectPage",
+        ];
+        for (const type of validTypes) {
+            expect(validateSourceType(type)).toBe(true);
+        }
+    });
+    it("should return false for unknown type strings", () => {
+        expect(validateSourceType("InvalidType")).toBe(false);
+    });
+    it("should return false for empty string", () => {
+        expect(validateSourceType("")).toBe(false);
+    });
+    it("should be case-sensitive", () => {
+        expect(validateSourceType("searchpage")).toBe(false);
+        expect(validateSourceType("SEARCHPAGE")).toBe(false);
+    });
+});
+//# sourceMappingURL=source-type-registry.test.js.map

package/dist/services/source-type-registry.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-type-registry.test.js","sourceRoot":"","sources":["../../src/services/source-type-registry.test.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAEjF,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QACzB,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;YACzD,MAAM,CACJ,gBAAgB,CAAC,mEAAmE,CAAC,CACtF,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CACJ,gBAAgB,CAAC,gEAAgE,CAAC,CACnF,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CACJ,gBAAgB,CAAC,6DAA6D,CAAC,CAChF,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;YAClE,MAAM,CACJ,gBAAgB,CAAC,iDAAiD,CAAC,CACpE,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,CACJ,gBAAgB,CAAC,gDAAgD,CAAC,CACnE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,CACJ,gBAAgB,CAAC,kDAAkD,CAAC,CACrE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAClB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACrD,MAAM,CACJ,gBAAgB,CAAC,4CAA4C,CAAC,CAC/D,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;YACpE,MAAM,CACJ,gBAAgB,CAAC,6DAA6D,CAAC,CAChF,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,CACJ,gBAAgB,CAAC,mDAAmD,CAAC,CACtE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACxD,MAAM,CACJ,gBAAgB,CAAC,mDAAmD,CAAC,CACtE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACpC,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;YAC3E,MAAM,CACJ,gBAAgB,CAAC,yDAAyD,CAAC,CAC5E,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;YACvE,MAAM,CACJ,gBAAgB,CAAC,mDAAmD,CAAC,CACtE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;YAC1E,MAAM,CACJ,gBAAgB,CAAC,0DAA0D,CAAC,CAC7E,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;YAC7E,MAAM,CACJ,gBAAgB,CAAC,oDAAoD,CAAC,CACvE,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC1D,MAAM,CACJ,gBAAgB,CAAC,oDAAoD,CAAC,CACvE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,CACJ,gBAAgB,CAAC,gDAAgD,CAAC,CACnE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAC7D,MAAM,CACJ,gBAAgB,CAAC,uDAAuD,CAAC,CAC1E,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;YAChE,MAAM,CACJ,gBAAgB,CAAC,mDAAmD,CAAC,CACtE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzB,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;QAC1B,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CAAC,gBAAgB,CAAC,uCAAuC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACvD,MAAM,CAAC,gBAAgB,CAAC,sCAAsC,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACnF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YAClD,MAAM,CACJ,gBAAgB,CACd,6EAA6E,CAC9E,CACF,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;YAChD,MAAM,CACJ,gBAAgB,CAAC,yDAAyD,CAAC,CAC5E,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACvB,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;YACtD,MAAM,CAAC,gBAAgB,CAAC,yBAAyB,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,UAAU,GAAG;YACjB,YAAY;YACZ,eAAe;YACf,QAAQ;YACR,oBAAoB;YACpB,OAAO;YACP,OAAO;YACP,QAAQ;YACR,oBAAoB;YACpB,eAAe;YACf,eAAe;YACf,cAAc;YACd,YAAY;YACZ,YAAY;YACZ,iBAAiB;YACjB,aAAa;YACb,cAAc;YACd,aAAa;YACb,cAAc;SACf,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;YAC9B,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,kBAAkB,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrD,MAAM,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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":"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"}

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"}

package/dist/services/url-templates.js

@@ -0,0 +1,118 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+/**
+ * Fixed LinkedIn URLs that require no parameters.
+ */
+const FIXED_URLS = {
+    MyConnections: "https://www.linkedin.com/mynetwork/invite-connect/connections/",
+    LWVYPP: "https://www.linkedin.com/me/profile-views/",
+    SentInvitationPage: "https://www.linkedin.com/mynetwork/invitation-manager/sent/",
+    FollowersPage: "https://www.linkedin.com/me/my-network/followers/",
+    FollowingPage: "https://www.linkedin.com/me/my-network/following/",
+    SNOrgsPage: "https://www.linkedin.com/sales/search/company",
+    TSearchPage: "https://www.linkedin.com/talent/search/",
+    RSearchPage: "https://www.linkedin.com/recruiter/search/",
+};
+/**
+ * Parameterised URL templates.
+ *
+ * - `{slug}` is replaced with the provided slug string.
+ * - `{id}` is replaced with the provided ID string.
+ */
+const PARAMETERISED_TEMPLATES = {
+    OrganizationPeople: {
+        template: "https://www.linkedin.com/company/{slug}/people/",
+        param: "slug",
+    },
+    Alumni: {
+        template: "https://www.linkedin.com/school/{slug}/people/",
+        param: "slug",
+    },
+    Group: {
+        template: "https://www.linkedin.com/groups/{id}/members/",
+        param: "id",
+    },
+    Event: {
+        template: "https://www.linkedin.com/events/{id}/attendees/",
+        param: "id",
+    },
+    SNListPage: {
+        template: "https://www.linkedin.com/sales/lists/people/{id}/",
+        param: "id",
+    },
+    SNOrgsListsPage: {
+        template: "https://www.linkedin.com/sales/lists/company/{id}/",
+        param: "id",
+    },
+    TProjectPage: {
+        template: "https://www.linkedin.com/talent/projects/{id}/",
+        param: "id",
+    },
+    RProjectPage: {
+        template: "https://www.linkedin.com/recruiter/projects/{id}/",
+        param: "id",
+    },
+};
+/** Source types that use the basic search URL builder. */
+const SEARCH_BUILDER_TYPES = new Set(["SearchPage"]);
+/** Source types that use the SN search URL builder. */
+const SN_SEARCH_BUILDER_TYPES = new Set([
+    "SNSearchPage",
+]);
+/**
+ * Check whether a source type uses a fixed URL (no parameters needed).
+ */
+export function isFixedUrlType(sourceType) {
+    return sourceType in FIXED_URLS;
+}
+/**
+ * Check whether a source type uses a parameterised template.
+ */
+export function isParameterisedType(sourceType) {
+    return sourceType in PARAMETERISED_TEMPLATES;
+}
+/**
+ * Check whether a source type uses the basic search URL builder.
+ */
+export function isSearchBuilderType(sourceType) {
+    return SEARCH_BUILDER_TYPES.has(sourceType);
+}
+/**
+ * Check whether a source type uses the Sales Navigator URL builder.
+ */
+export function isSNSearchBuilderType(sourceType) {
+    return SN_SEARCH_BUILDER_TYPES.has(sourceType);
+}
+/**
+ * Get the fixed URL for a source type.
+ *
+ * @returns The URL, or `undefined` if the source type is not a fixed URL type.
+ */
+export function getFixedUrl(sourceType) {
+    return FIXED_URLS[sourceType];
+}
+/**
+ * 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 function buildParameterisedUrl(sourceType, params) {
+    const entry = PARAMETERISED_TEMPLATES[sourceType];
+    if (entry === undefined)
+        return undefined;
+    const value = entry.param === "slug" ? params.slug : params.id;
+    if (value === undefined)
+        return undefined;
+    return entry.template.replace(`{${entry.param}}`, encodeURIComponent(value));
+}
+/**
+ * Get the required parameter type for a parameterised source type.
+ *
+ * @returns `"slug"`, `"id"`, or `undefined` if not a parameterised type.
+ */
+export function getParameterType(sourceType) {
+    return PARAMETERISED_TEMPLATES[sourceType]?.param;
+}
+//# sourceMappingURL=url-templates.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"url-templates.js","sourceRoot":"","sources":["../../src/services/url-templates.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAIpC;;GAEG;AACH,MAAM,UAAU,GAAwC;IACtD,aAAa,EACX,gEAAgE;IAClE,MAAM,EAAE,4CAA4C;IACpD,kBAAkB,EAChB,6DAA6D;IAC/D,aAAa,EAAE,mDAAmD;IAClE,aAAa,EAAE,mDAAmD;IAClE,UAAU,EAAE,+CAA+C;IAC3D,WAAW,EAAE,yCAAyC;IACtD,WAAW,EAAE,4CAA4C;CAC1D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,uBAAuB,GAEzB;IACF,kBAAkB,EAAE;QAClB,QAAQ,EAAE,iDAAiD;QAC3D,KAAK,EAAE,MAAM;KACd;IACD,MAAM,EAAE;QACN,QAAQ,EAAE,gDAAgD;QAC1D,KAAK,EAAE,MAAM;KACd;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,+CAA+C;QACzD,KAAK,EAAE,IAAI;KACZ;IACD,KAAK,EAAE;QACL,QAAQ,EAAE,iDAAiD;QAC3D,KAAK,EAAE,IAAI;KACZ;IACD,UAAU,EAAE;QACV,QAAQ,EAAE,mDAAmD;QAC7D,KAAK,EAAE,IAAI;KACZ;IACD,eAAe,EAAE;QACf,QAAQ,EAAE,oDAAoD;QAC9D,KAAK,EAAE,IAAI;KACZ;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,gDAAgD;QAC1D,KAAK,EAAE,IAAI;KACZ;IACD,YAAY,EAAE;QACZ,QAAQ,EAAE,mDAAmD;QAC7D,KAAK,EAAE,IAAI;KACZ;CACF,CAAC;AAEF,0DAA0D;AAC1D,MAAM,oBAAoB,GAA4B,IAAI,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AAE9E,uDAAuD;AACvD,MAAM,uBAAuB,GAA4B,IAAI,GAAG,CAAC;IAC/D,cAAc;CACf,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,UAAsB;IACnD,OAAO,UAAU,IAAI,UAAU,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsB;IACxD,OAAO,UAAU,IAAI,uBAAuB,CAAC;AAC/C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAsB;IACxD,OAAO,oBAAoB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAsB;IAC1D,OAAO,uBAAuB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,UAAsB;IAChD,OAAO,UAAU,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAsB,EACtB,MAAsC;IAEtC,MAAM,KAAK,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,KAAK,GACT,KAAK,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAsB;IAEtB,OAAO,uBAAuB,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC;AACpD,CAAC"}

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

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

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

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