@lhremote/core 0.7.0 → 0.8.0

package/dist/voyager/interceptor.d.ts

@@ -0,0 +1,100 @@
+import type { CDPClient } from "../cdp/client.js";
+/** URL pattern matching LinkedIn Voyager API endpoints. */
+export declare const VOYAGER_URL_PATTERN: RegExp;
+/**
+ * A captured Voyager API response.
+ */
+export interface VoyagerResponse {
+    /** The full request URL. */
+    readonly url: string;
+    /** HTTP status code. */
+    readonly status: number;
+    /** Parsed JSON response body, or raw string if JSON parsing failed. */
+    readonly body: unknown;
+}
+/**
+ * Callback for intercepted Voyager API responses.
+ */
+export type VoyagerResponseHandler = (response: VoyagerResponse) => void;
+/**
+ * Options for active Voyager API fetching.
+ */
+export interface VoyagerFetchOptions {
+    /** Additional HTTP headers to include in the request. */
+    readonly headers?: Readonly<Record<string, string>>;
+}
+/**
+ * CDP Network domain listener for LinkedIn Voyager API responses.
+ *
+ * Intercepts HTTP responses matching the Voyager API URL pattern
+ * (`/voyager/api/`) via the Chrome DevTools Protocol Network domain.
+ *
+ * Two modes of operation:
+ * - **Passive**: Enable the interceptor and register handlers to capture
+ *   Voyager responses triggered by page navigation, scrolling, or user
+ *   interaction within the LinkedIn WebView.
+ * - **Active**: Use {@link fetch} to execute Voyager API requests directly
+ *   in the page context (which has the LinkedIn session cookies).
+ *
+ * The interceptor is read-only — it does not modify requests or responses,
+ * so it coexists safely with LinkedHelper's mockttp proxy.
+ */
+export declare class VoyagerInterceptor {
+    private readonly client;
+    private readonly handlers;
+    private readonly pendingRequests;
+    private interceptEnabled;
+    constructor(client: CDPClient);
+    /** Whether passive interception is currently enabled. */
+    get isEnabled(): boolean;
+    /**
+     * Enable the CDP Network domain and start intercepting Voyager responses.
+     *
+     * Subscribes to `Network.responseReceived`, `Network.loadingFinished`,
+     * and `Network.loadingFailed` events.  Responses matching the Voyager
+     * URL pattern are captured and emitted to registered handlers.
+     */
+    enable(): Promise<void>;
+    /**
+     * Disable the CDP Network domain and stop intercepting.
+     *
+     * Cleans up event listeners and pending request state.
+     */
+    disable(): Promise<void>;
+    /**
+     * Register a handler for passively intercepted Voyager responses.
+     */
+    onResponse(handler: VoyagerResponseHandler): void;
+    /**
+     * Remove a previously registered response handler.
+     */
+    offResponse(handler: VoyagerResponseHandler): void;
+    /**
+     * Wait for the next Voyager response matching an optional URL filter.
+     *
+     * Requires the interceptor to be {@link enable}d.
+     *
+     * @param filter  - Optional predicate applied to the response URL.
+     * @param timeout - Maximum wait time in ms (default: 30 000).
+     */
+    waitForResponse(filter?: (url: string) => boolean, timeout?: number): Promise<VoyagerResponse>;
+    /**
+     * Execute a Voyager API request in the LinkedIn page context.
+     *
+     * Runs `fetch()` inside the WebView where LinkedIn session cookies are
+     * available, automatically extracting the CSRF token from cookies.
+     *
+     * Does not require the interceptor to be {@link enable}d — works
+     * independently of the Network domain.
+     *
+     * @param path    - Voyager API path (e.g. `/voyager/api/feed/dash/feedUpdates`).
+     *                  Full URLs starting with `https://` are also accepted.
+     * @param options - Optional fetch configuration.
+     */
+    fetch(path: string, options?: VoyagerFetchOptions): Promise<VoyagerResponse>;
+    private handleResponseReceived;
+    private handleLoadingFinished;
+    private handleLoadingFailed;
+    private fetchAndEmitBody;
+}
+//# sourceMappingURL=interceptor.d.ts.map

package/dist/voyager/interceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interceptor.d.ts","sourceRoot":"","sources":["../../src/voyager/interceptor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGlD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,QAAqB,CAAC;AAKtD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,QAAQ,EAAE,eAAe,KAAK,IAAI,CAAC;AAEzE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACrD;AAUD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;IAC9D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAG5B;IACJ,OAAO,CAAC,gBAAgB,CAAS;gBAErB,MAAM,EAAE,SAAS;IAI7B,yDAAyD;IACzD,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED;;;;;;OAMG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAS7B;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAU9B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAIjD;;OAEG;IACH,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI;IAIlD;;;;;;;OAOG;IACG,eAAe,CACnB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,EACjC,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC;IA2B3B;;;;;;;;;;;;OAYG;IACG,KAAK,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,eAAe,CAAC;IAyE3B,OAAO,CAAC,sBAAsB,CAY5B;IAEF,OAAO,CAAC,qBAAqB,CAO3B;IAEF,OAAO,CAAC,mBAAmB,CAGzB;YAEY,gBAAgB;CAqC/B"}

package/dist/voyager/interceptor.integration.test.d.ts

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

package/dist/voyager/interceptor.integration.test.d.ts.map

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

package/dist/voyager/interceptor.integration.test.js

@@ -0,0 +1,89 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { createServer } from "node:http";
+import { afterAll, afterEach, beforeAll, describe, expect, it } from "vitest";
+import { CDPClient } from "../cdp/client.js";
+import { launchChromium, } from "../cdp/testing/launch-chromium.js";
+import { VoyagerInterceptor } from "./interceptor.js";
+describe("VoyagerInterceptor (integration)", () => {
+    let chromium;
+    let server;
+    let serverPort;
+    let client;
+    let interceptor;
+    beforeAll(async () => {
+        chromium = await launchChromium();
+        // Start a minimal local HTTP server to avoid external network dependency
+        // (http://example.com caused Windows CI timeouts)
+        server = createServer((_req, res) => {
+            res.writeHead(200, { "Content-Type": "text/html" });
+            res.end("<html></html>");
+        });
+        await new Promise((resolve) => server.listen(0, resolve));
+        serverPort = server.address().port;
+    }, 30_000);
+    afterAll(async () => {
+        await chromium.close();
+        server.close();
+    });
+    afterEach(async () => {
+        if (interceptor?.isEnabled) {
+            await interceptor.disable();
+        }
+        client?.disconnect();
+    });
+    describe("enable / disable", () => {
+        it("should enable and disable without error on a real browser", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            interceptor = new VoyagerInterceptor(client);
+            await interceptor.enable();
+            expect(interceptor.isEnabled).toBe(true);
+            await interceptor.disable();
+            expect(interceptor.isEnabled).toBe(false);
+        });
+    });
+    describe("passive interception", () => {
+        it("should capture responses matching Voyager URL pattern", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            interceptor = new VoyagerInterceptor(client);
+            // Navigate to the local HTTP server so we have an origin for fetch
+            await client.send("Page.enable");
+            const loadPromise = client.waitForEvent("Page.loadEventFired");
+            await client.navigate(`http://localhost:${serverPort.toString()}`);
+            await loadPromise;
+            await client.send("Page.disable").catch(() => { });
+            await interceptor.enable();
+            // Use waitForResponse for deterministic waiting instead of setTimeout
+            const responsePromise = interceptor.waitForResponse(undefined, 5000);
+            // Trigger a fetch from within the page to a URL containing /voyager/api/
+            // The local server responds with 200 to any path
+            await client.evaluate(`fetch("/voyager/api/test-endpoint").catch(() => {})`, true);
+            const captured = await responsePromise;
+            expect(captured.url).toContain("/voyager/api/");
+        });
+    });
+    describe("waitForResponse", () => {
+        it("should resolve when a matching response arrives", async () => {
+            client = new CDPClient(chromium.port);
+            await client.connect();
+            interceptor = new VoyagerInterceptor(client);
+            // Navigate to the local HTTP server so we have an origin for fetch
+            await client.send("Page.enable");
+            const loadPromise = client.waitForEvent("Page.loadEventFired");
+            await client.navigate(`http://localhost:${serverPort.toString()}`);
+            await loadPromise;
+            await client.send("Page.disable").catch(() => { });
+            await interceptor.enable();
+            // Start waiting before triggering the fetch
+            const responsePromise = interceptor.waitForResponse(undefined, 5000);
+            // Trigger a fetch matching the voyager pattern
+            await client.evaluate(`fetch("/voyager/api/integration-test").catch(() => {})`, true);
+            const response = await responsePromise;
+            expect(response.url).toContain("/voyager/api/");
+            expect(response.status).toEqual(expect.any(Number));
+        });
+    });
+});
+//# sourceMappingURL=interceptor.integration.test.js.map

package/dist/voyager/interceptor.integration.test.js.map

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

package/dist/voyager/interceptor.js

@@ -0,0 +1,235 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+import { CDPEvaluationError, CDPTimeoutError } from "../cdp/errors.js";
+/** URL pattern matching LinkedIn Voyager API endpoints. */
+export const VOYAGER_URL_PATTERN = /\/voyager\/api\//;
+/** Default timeout for response wait operations (ms). */
+const DEFAULT_TIMEOUT = 30_000;
+/**
+ * CDP Network domain listener for LinkedIn Voyager API responses.
+ *
+ * Intercepts HTTP responses matching the Voyager API URL pattern
+ * (`/voyager/api/`) via the Chrome DevTools Protocol Network domain.
+ *
+ * Two modes of operation:
+ * - **Passive**: Enable the interceptor and register handlers to capture
+ *   Voyager responses triggered by page navigation, scrolling, or user
+ *   interaction within the LinkedIn WebView.
+ * - **Active**: Use {@link fetch} to execute Voyager API requests directly
+ *   in the page context (which has the LinkedIn session cookies).
+ *
+ * The interceptor is read-only — it does not modify requests or responses,
+ * so it coexists safely with LinkedHelper's mockttp proxy.
+ */
+export class VoyagerInterceptor {
+    client;
+    handlers = new Set();
+    pendingRequests = new Map();
+    interceptEnabled = false;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Whether passive interception is currently enabled. */
+    get isEnabled() {
+        return this.interceptEnabled;
+    }
+    /**
+     * Enable the CDP Network domain and start intercepting Voyager responses.
+     *
+     * Subscribes to `Network.responseReceived`, `Network.loadingFinished`,
+     * and `Network.loadingFailed` events.  Responses matching the Voyager
+     * URL pattern are captured and emitted to registered handlers.
+     */
+    async enable() {
+        if (this.interceptEnabled)
+            return;
+        await this.client.send("Network.enable");
+        this.client.on("Network.responseReceived", this.handleResponseReceived);
+        this.client.on("Network.loadingFinished", this.handleLoadingFinished);
+        this.client.on("Network.loadingFailed", this.handleLoadingFailed);
+        this.interceptEnabled = true;
+    }
+    /**
+     * Disable the CDP Network domain and stop intercepting.
+     *
+     * Cleans up event listeners and pending request state.
+     */
+    async disable() {
+        if (!this.interceptEnabled)
+            return;
+        this.interceptEnabled = false;
+        this.client.off("Network.responseReceived", this.handleResponseReceived);
+        this.client.off("Network.loadingFinished", this.handleLoadingFinished);
+        this.client.off("Network.loadingFailed", this.handleLoadingFailed);
+        this.pendingRequests.clear();
+        await this.client.send("Network.disable").catch(() => { });
+    }
+    /**
+     * Register a handler for passively intercepted Voyager responses.
+     */
+    onResponse(handler) {
+        this.handlers.add(handler);
+    }
+    /**
+     * Remove a previously registered response handler.
+     */
+    offResponse(handler) {
+        this.handlers.delete(handler);
+    }
+    /**
+     * Wait for the next Voyager response matching an optional URL filter.
+     *
+     * Requires the interceptor to be {@link enable}d.
+     *
+     * @param filter  - Optional predicate applied to the response URL.
+     * @param timeout - Maximum wait time in ms (default: 30 000).
+     */
+    async waitForResponse(filter, timeout) {
+        if (!this.interceptEnabled) {
+            throw new Error("VoyagerInterceptor is not enabled — call enable() before waitForResponse()");
+        }
+        const ms = timeout ?? DEFAULT_TIMEOUT;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.offResponse(handler);
+                reject(new CDPTimeoutError("Timed out waiting for Voyager response"));
+            }, ms);
+            const handler = (response) => {
+                if (!filter || filter(response.url)) {
+                    clearTimeout(timer);
+                    this.offResponse(handler);
+                    resolve(response);
+                }
+            };
+            this.onResponse(handler);
+        });
+    }
+    /**
+     * Execute a Voyager API request in the LinkedIn page context.
+     *
+     * Runs `fetch()` inside the WebView where LinkedIn session cookies are
+     * available, automatically extracting the CSRF token from cookies.
+     *
+     * Does not require the interceptor to be {@link enable}d — works
+     * independently of the Network domain.
+     *
+     * @param path    - Voyager API path (e.g. `/voyager/api/feed/dash/feedUpdates`).
+     *                  Full URLs starting with `https://` are also accepted.
+     * @param options - Optional fetch configuration.
+     */
+    async fetch(path, options) {
+        const fullUrl = path.startsWith("https://")
+            ? path
+            : `https://www.linkedin.com${path.startsWith("/") ? "" : "/"}${path}`;
+        // Guard: only send credentials to LinkedIn origins
+        const parsed = new URL(fullUrl);
+        if (parsed.hostname !== "www.linkedin.com" &&
+            parsed.hostname !== "linkedin.com" &&
+            !parsed.hostname.endsWith(".linkedin.com")) {
+            throw new Error(`Voyager fetch restricted to linkedin.com origins, got: ${parsed.hostname}`);
+        }
+        const extraHeaders = JSON.stringify(options?.headers ?? {});
+        const result = await this.client.evaluate(`(async () => {
+        try {
+          const jsessionid = document.cookie
+            .split(";")
+            .map(c => c.trim())
+            .find(c => c.startsWith("JSESSIONID="));
+          let csrfToken = jsessionid
+            ? jsessionid.substring(jsessionid.indexOf("=") + 1).replace(/"/g, "")
+            : "";
+          if (!csrfToken.startsWith("ajax:")) {
+            csrfToken = "ajax:" + csrfToken;
+          }
+
+          const response = await fetch(${JSON.stringify(fullUrl)}, {
+            headers: {
+              "Csrf-Token": csrfToken,
+              "X-RestLi-Protocol-Version": "2.0.0",
+              ...${extraHeaders},
+            },
+            credentials: "include",
+          });
+
+          const text = await response.text();
+          let body;
+          try {
+            body = JSON.parse(text);
+          } catch {
+            body = text;
+          }
+
+          return { url: response.url, status: response.status, body };
+        } catch (e) {
+          return { url: ${JSON.stringify(fullUrl)}, status: 0, body: null, error: String(e) };
+        }
+      })()`, true);
+        if (result.error) {
+            throw new CDPEvaluationError(`Voyager fetch failed: ${result.error}`);
+        }
+        return {
+            url: result.url,
+            status: result.status,
+            body: result.body,
+        };
+    }
+    // ---------------------------------------------------------------------------
+    // Private — CDP event handlers
+    // ---------------------------------------------------------------------------
+    handleResponseReceived = (params) => {
+        const { requestId, response } = params;
+        if (VOYAGER_URL_PATTERN.test(response.url)) {
+            this.pendingRequests.set(requestId, {
+                url: response.url,
+                status: response.status,
+            });
+        }
+    };
+    handleLoadingFinished = (params) => {
+        const { requestId } = params;
+        const pending = this.pendingRequests.get(requestId);
+        if (!pending)
+            return;
+        this.pendingRequests.delete(requestId);
+        void this.fetchAndEmitBody(requestId, pending);
+    };
+    handleLoadingFailed = (params) => {
+        const { requestId } = params;
+        this.pendingRequests.delete(requestId);
+    };
+    async fetchAndEmitBody(requestId, meta) {
+        let body;
+        try {
+            const result = (await this.client.send("Network.getResponseBody", {
+                requestId,
+            }));
+            const raw = result.base64Encoded
+                ? Buffer.from(result.body, "base64").toString("utf8")
+                : result.body;
+            try {
+                body = JSON.parse(raw);
+            }
+            catch {
+                body = raw;
+            }
+        }
+        catch {
+            // Body retrieval can fail for cached or evicted responses — skip silently
+            return;
+        }
+        const response = {
+            url: meta.url,
+            status: meta.status,
+            body,
+        };
+        for (const handler of this.handlers) {
+            try {
+                handler(response);
+            }
+            catch {
+                // Isolate handler errors so one failing handler doesn't block others
+            }
+        }
+    }
+}
+//# sourceMappingURL=interceptor.js.map

package/dist/voyager/interceptor.js.map

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

package/dist/voyager/interceptor.test.d.ts

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

package/dist/voyager/interceptor.test.d.ts.map

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