@lhremote/core 0.6.0 → 0.8.0

package/dist/types/post-analytics.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Engagement statistics for a LinkedIn post.
+ */
+export interface PostStats {
+    /** The resolved post URN (e.g. `urn:li:activity:1234567890`). */
+    readonly postUrn: string;
+    /** Total number of reactions. */
+    readonly reactionCount: number;
+    /** Reactions broken down by type. */
+    readonly reactionsByType: readonly ReactionCount[];
+    /** Total number of comments. */
+    readonly commentCount: number;
+    /** Total number of shares/reposts. */
+    readonly shareCount: number;
+}
+/**
+ * Reaction count for a specific reaction type.
+ */
+export interface ReactionCount {
+    /** LinkedIn reaction type (e.g. `LIKE`, `PRAISE`, `EMPATHY`, `ENTERTAINMENT`, `INTEREST`, `APPRECIATION`). */
+    readonly type: string;
+    /** Number of reactions of this type. */
+    readonly count: number;
+}
+/**
+ * A person who engaged with a post (reacted, commented, etc.).
+ */
+export interface PostEngager {
+    /** First name of the engager. */
+    readonly firstName: string;
+    /** Last name of the engager. */
+    readonly lastName: string;
+    /** LinkedIn public profile ID (vanity URL slug), if available. */
+    readonly publicId: string | null;
+    /** Professional headline. */
+    readonly headline: string | null;
+    /** Engagement type (e.g. `LIKE`, `PRAISE`, `EMPATHY`). */
+    readonly engagementType: string;
+}
+//# sourceMappingURL=post-analytics.d.ts.map

package/dist/types/post-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-analytics.d.ts","sourceRoot":"","sources":["../../src/types/post-analytics.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iCAAiC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,qCAAqC;IACrC,QAAQ,CAAC,eAAe,EAAE,SAAS,aAAa,EAAE,CAAC;IACnD,gCAAgC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,8GAA8G;IAC9G,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC"}

package/dist/types/post-analytics.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=post-analytics.js.map

package/dist/types/post-analytics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post-analytics.js","sourceRoot":"","sources":["../../src/types/post-analytics.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/post.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Detailed data for a single LinkedIn post.
+ */
+export interface PostDetail {
+    /** The resolved post URN (e.g. `urn:li:activity:1234567890`). */
+    readonly postUrn: string;
+    /** Author display name. */
+    readonly authorName: string;
+    /** Author professional headline. */
+    readonly authorHeadline: string | null;
+    /** Author LinkedIn public profile ID (vanity URL slug), if available. */
+    readonly authorPublicId: string | null;
+    /** Post text content. */
+    readonly text: string;
+    /** Epoch milliseconds when the post was published, if available. */
+    readonly publishedAt: number | null;
+    /** Total number of reactions. */
+    readonly reactionCount: number;
+    /** Total number of comments. */
+    readonly commentCount: number;
+    /** Total number of shares/reposts. */
+    readonly shareCount: number;
+}
+/**
+ * A comment on a LinkedIn post.
+ */
+export interface PostComment {
+    /** Comment URN identifier. */
+    readonly commentUrn: string | null;
+    /** Author display name. */
+    readonly authorName: string;
+    /** Author professional headline. */
+    readonly authorHeadline: string | null;
+    /** Author LinkedIn public profile ID (vanity URL slug), if available. */
+    readonly authorPublicId: string | null;
+    /** Comment text content. */
+    readonly text: string;
+    /** Epoch milliseconds when the comment was created, if available. */
+    readonly createdAt: number | null;
+    /** Number of reactions on this comment. */
+    readonly reactionCount: number;
+}
+//# sourceMappingURL=post.d.ts.map

package/dist/types/post.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.d.ts","sourceRoot":"","sources":["../../src/types/post.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,yBAAyB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,iCAAiC;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,gCAAgC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,8BAA8B;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,2CAA2C;IAC3C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC"}

package/dist/types/post.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=post.js.map

package/dist/types/post.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"post.js","sourceRoot":"","sources":["../../src/types/post.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/search-posts.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A LinkedIn post returned from a content search.
+ */
+export interface SearchPostResult {
+    /** Post URN (e.g. `urn:li:activity:1234567890`). */
+    readonly postUrn: string;
+    /** Post text content (may be truncated by API). */
+    readonly text: string | null;
+    /** Author first name. */
+    readonly authorFirstName: string | null;
+    /** Author last name. */
+    readonly authorLastName: string | null;
+    /** Author LinkedIn public ID (vanity URL slug). */
+    readonly authorPublicId: string | null;
+    /** Author professional headline. */
+    readonly authorHeadline: string | null;
+    /** Total number of reactions on the post. */
+    readonly reactionCount: number;
+    /** Total number of comments on the post. */
+    readonly commentCount: number;
+}
+//# sourceMappingURL=search-posts.d.ts.map

package/dist/types/search-posts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-posts.d.ts","sourceRoot":"","sources":["../../src/types/search-posts.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yBAAyB;IACzB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,wBAAwB;IACxB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,mDAAmD;IACnD,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,oCAAoC;IACpC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B"}

package/dist/types/search-posts.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export {};
+//# sourceMappingURL=search-posts.js.map

package/dist/types/search-posts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-posts.js","sourceRoot":"","sources":["../../src/types/search-posts.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC"}

package/dist/types/ui-health.d.ts

@@ -46,6 +46,20 @@ export interface PopupState {
     /** Whether the popup can be closed by the user. */
     readonly closable?: boolean;
 }
+/**
+ * A popup detected in the LinkedHelper instance UI DOM.
+ *
+ * Instance popups render behind the LinkedIn webview and are invisible
+ * to the user. They can block operations without any visible indication.
+ */
+export interface InstancePopup {
+    /** The popup title text (e.g., "Failed to initialize UI"). */
+    readonly title: string;
+    /** The popup body/description text, if available. */
+    readonly description?: string;
+    /** Whether the popup is dismissable (has actionable controls to close or dismiss it). */
+    readonly closable: boolean;
+}
 /**
  * Aggregated UI health status for a LinkedHelper instance.
  */
@@ -56,5 +70,7 @@ export interface UIHealthStatus {
     readonly issues: readonly InstanceIssue[];
     /** Current popup overlay state, or `null` if no popup is present. */
     readonly popup: PopupState | null;
+    /** Popups detected in the instance UI DOM. */
+    readonly instancePopups: readonly InstancePopup[];
 }
 //# sourceMappingURL=ui-health.d.ts.map

package/dist/types/ui-health.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ui-health.d.ts","sourceRoot":"","sources":["../../src/types/ui-health.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;YAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;SACvB,CAAC,CAAC;KACJ,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEpG;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CACnC"}
+{"version":3,"file":"ui-health.d.ts","sourceRoot":"","sources":["../../src/types/ui-health.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;YAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;YACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;SACvB,CAAC,CAAC;KACJ,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAChF;IAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAEpG;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qDAAqD;IACrD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAClC,8CAA8C;IAC9C,QAAQ,CAAC,cAAc,EAAE,SAAS,aAAa,EAAE,CAAC;CACnD"}

package/dist/voyager/index.d.ts

@@ -0,0 +1,2 @@
+export { VoyagerInterceptor, VOYAGER_URL_PATTERN, type VoyagerFetchOptions, type VoyagerResponse, type VoyagerResponseHandler, } from "./interceptor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/voyager/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,kBAAkB,CAAC"}

package/dist/voyager/index.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (C) 2026 Oleksii PELYKH
+export { VoyagerInterceptor, VOYAGER_URL_PATTERN, } from "./interceptor.js";
+//# sourceMappingURL=index.js.map

package/dist/voyager/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/voyager/index.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,oCAAoC;AAEpC,OAAO,EACL,kBAAkB,EAClB,mBAAmB,GAIpB,MAAM,kBAAkB,CAAC"}

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