@monoes/monobrowse 1.0.13 → 1.0.14

package/dist/src/__tests__/cdp-transport.test.js.map

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

package/dist/src/browser/bridge.d.ts

@@ -0,0 +1,119 @@
+import { CdpClient } from './cdp.js';
+import type { CdpTransport, CdpTransportHandlers } from './transport.js';
+/**
+ * CDP over the MonoAgent extension bridge.
+ *
+ * The extension already holds Chrome's `debugger` permission and attaches to
+ * tabs with `chrome.debugger.attach`; mono-agent's Go server already owns the
+ * WebSocket to it. This transport puts CDP frames on that path — out through
+ * the relay's `/monoagent/cdp` socket, into `chrome.debugger.sendCommand`,
+ * and back — so a CdpClient can drive the browser the user is actually
+ * signed into rather than a headless Chrome we launched. Every instrument
+ * built on CdpClient (console, network, HAR, vitals, trace, CPU profiler,
+ * snapshot, screenshot, emulation) comes along unchanged.
+ *
+ * Two mismatches have to be reconciled here, and they are the whole job:
+ *
+ * **Sessions.** Against a raw socket, monobrowse attaches to a target and
+ * carries the resulting `sessionId` on every command and every event.
+ * `chrome.debugger` has no such id for the tab: the debuggee *is* the page
+ * session, and a `sessionId` on the wire means a *child* session (an
+ * out-of-process iframe). So this transport mints a stable synthetic id for
+ * the tab, strips it on the way out, stamps it onto relayed events on the
+ * way in, and passes any other id through untouched for real child sessions.
+ *
+ * **Attachment.** A socket is opened; a debuggee is attached. open() does the
+ * attach and fails if it cannot, rather than handing back a transport whose
+ * first command would fail. close() detaches, which is what takes Chrome's
+ * "…started debugging this browser" banner off the user's tab.
+ *
+ * Known gaps, which are Chrome's and not this file's: `chrome.debugger`
+ * exposes a fixed set of domains, and `HeapProfiler` and `Browser` are not
+ * among them, so heap snapshots and `Browser.close` fail over the bridge.
+ */
+/** Header the Go relay authenticates with; mirrors internal/extension/token.go. */
+export declare const BRIDGE_TOKEN_HEADER = "X-Monoagent-Extension-Token";
+/** Default relay endpoint; mirrors the extension server's default port. */
+export declare const DEFAULT_BRIDGE_URL = "ws://127.0.0.1:9222/monoagent/cdp";
+/** The synthetic target id standing in for a Chrome tab. */
+export declare function bridgeTargetId(tabId: number): string;
+/** The synthetic session id standing in for a tab's page session. */
+export declare function bridgeSessionId(tabId: number): string;
+/** True for ids this transport minted, as opposed to real CDP child sessions. */
+export declare function isBridgeSessionId(sessionId: string | undefined): boolean;
+export interface BridgeTransportOptions {
+    /**
+     * The Chrome tab to drive. Omit it to drive whichever tab the user is
+     * looking at: the extension resolves the active tab and reports the id
+     * back on attach, which is the normal way in — the caller has no tab ids
+     * to hand, only a browser with the user's session in it.
+     */
+    tabId?: number;
+    /** Relay endpoint. Defaults to DEFAULT_BRIDGE_URL. */
+    url?: string;
+    /** Relay token, from ~/.monoagent (the Go side writes it). */
+    token?: string;
+    /** Attach-handshake budget in ms. */
+    attachTimeoutMs?: number;
+    /**
+     * The byte pipe underneath. Defaults to a WebSocket to `url`; tests inject
+     * a scripted one so they can be the relay.
+     */
+    socket?: CdpTransport;
+}
+export declare class BridgeTransport implements CdpTransport {
+    /** 0 until the extension resolves the active tab (see open()). */
+    private tabId;
+    private readonly socket;
+    private readonly attachTimeoutMs;
+    private handlers;
+    private nextEnvelopeId;
+    private readonly pending;
+    private closed;
+    constructor(opts: BridgeTransportOptions);
+    open(handlers: CdpTransportHandlers): Promise<void>;
+    /** The tab this transport is driving; valid once open() has resolved. */
+    get attachedTabId(): number;
+    /** The session id every instrument should use against this transport. */
+    get sessionId(): string;
+    send(frame: string): Promise<void>;
+    close(): void;
+    /**
+     * Commands this transport answers itself. `Target.attachToTarget` against
+     * the tab is the one that matters: monobrowse's connect path asks for a
+     * session, and over the bridge there is nothing to ask — the debuggee is
+     * already the session. Any *other* target id is a genuine child target and
+     * goes to Chrome.
+     */
+    private answerLocally;
+    private command;
+    private onBridgeMessage;
+    private relayEvent;
+    private deliver;
+    private onGone;
+    private failPending;
+}
+/** What a bridge connection hands back: the same shape connectToTarget gives. */
+export interface BridgeConnection {
+    client: CdpClient;
+    sessionId: string;
+    tabId: number;
+    transport: BridgeTransport;
+}
+/**
+ * Connect a CdpClient to the user's real Chrome through the extension
+ * bridge, with the same domains enabled that a local session gets. This is
+ * the whole of the "point the instruments at the logged-in browser" story
+ * at the call site:
+ *
+ *     const { client, sessionId } = await connectBridge({ token });
+ *     const vitals = await collectVitals(client, sessionId);
+ *
+ * `enableDomains` is on by default for parity with connectToTarget. Turn it
+ * off for a caller that wants to choose its own domains (a bridge attach is
+ * visible to the user, so a lighter footprint is sometimes the point).
+ */
+export declare function connectBridge(opts?: BridgeTransportOptions & {
+    enableDomains?: boolean;
+}): Promise<BridgeConnection>;
+//# sourceMappingURL=bridge.d.ts.map

package/dist/src/browser/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../../../src/browser/bridge.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,gCAAgC,CAAC;AAEjE,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,sCAAsC,CAAC;AAKtE,4DAA4D;AAC5D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAExE;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAiCD,qBAAa,eAAgB,YAAW,YAAY;IAClD,kEAAkE;IAClE,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmD;IAC3E,OAAO,CAAC,MAAM,CAAS;IAEvB,YAAY,IAAI,EAAE,sBAAsB,EASvC;IAEK,IAAI,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBxD;IAED,yEAAyE;IACzE,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,yEAAyE;IACzE,IAAI,SAAS,IAAI,MAAM,CAEtB;IAEK,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BvC;IAED,KAAK,IAAI,IAAI,CASZ;IAID;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,OAAO;IA6Bf,OAAO,CAAC,eAAe;IAqBvB,OAAO,CAAC,UAAU;IAwBlB,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,WAAW;CAMpB;AAED,iFAAiF;AACjF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,eAAe,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CACjC,IAAI,GAAE,sBAAsB,GAAG;IAAE,aAAa,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9D,OAAO,CAAC,gBAAgB,CAAC,CAS3B"}

package/dist/src/browser/bridge.js

@@ -0,0 +1,264 @@
+import { enableSessionDomains } from './browser.js';
+import { CdpClient } from './cdp.js';
+import { WebSocketTransport } from './transport.js';
+/**
+ * CDP over the MonoAgent extension bridge.
+ *
+ * The extension already holds Chrome's `debugger` permission and attaches to
+ * tabs with `chrome.debugger.attach`; mono-agent's Go server already owns the
+ * WebSocket to it. This transport puts CDP frames on that path — out through
+ * the relay's `/monoagent/cdp` socket, into `chrome.debugger.sendCommand`,
+ * and back — so a CdpClient can drive the browser the user is actually
+ * signed into rather than a headless Chrome we launched. Every instrument
+ * built on CdpClient (console, network, HAR, vitals, trace, CPU profiler,
+ * snapshot, screenshot, emulation) comes along unchanged.
+ *
+ * Two mismatches have to be reconciled here, and they are the whole job:
+ *
+ * **Sessions.** Against a raw socket, monobrowse attaches to a target and
+ * carries the resulting `sessionId` on every command and every event.
+ * `chrome.debugger` has no such id for the tab: the debuggee *is* the page
+ * session, and a `sessionId` on the wire means a *child* session (an
+ * out-of-process iframe). So this transport mints a stable synthetic id for
+ * the tab, strips it on the way out, stamps it onto relayed events on the
+ * way in, and passes any other id through untouched for real child sessions.
+ *
+ * **Attachment.** A socket is opened; a debuggee is attached. open() does the
+ * attach and fails if it cannot, rather than handing back a transport whose
+ * first command would fail. close() detaches, which is what takes Chrome's
+ * "…started debugging this browser" banner off the user's tab.
+ *
+ * Known gaps, which are Chrome's and not this file's: `chrome.debugger`
+ * exposes a fixed set of domains, and `HeapProfiler` and `Browser` are not
+ * among them, so heap snapshots and `Browser.close` fail over the bridge.
+ */
+/** Header the Go relay authenticates with; mirrors internal/extension/token.go. */
+export const BRIDGE_TOKEN_HEADER = 'X-Monoagent-Extension-Token';
+/** Default relay endpoint; mirrors the extension server's default port. */
+export const DEFAULT_BRIDGE_URL = 'ws://127.0.0.1:9222/monoagent/cdp';
+/** How long the attach handshake may take before open() gives up. */
+const DEFAULT_ATTACH_TIMEOUT_MS = 15_000;
+/** The synthetic target id standing in for a Chrome tab. */
+export function bridgeTargetId(tabId) {
+    return `bridge-tab-${tabId}`;
+}
+/** The synthetic session id standing in for a tab's page session. */
+export function bridgeSessionId(tabId) {
+    return `bridge-session-${tabId}`;
+}
+/** True for ids this transport minted, as opposed to real CDP child sessions. */
+export function isBridgeSessionId(sessionId) {
+    return typeof sessionId === 'string' && sessionId.startsWith('bridge-session-');
+}
+export class BridgeTransport {
+    /** 0 until the extension resolves the active tab (see open()). */
+    tabId;
+    socket;
+    attachTimeoutMs;
+    handlers = null;
+    nextEnvelopeId = 1;
+    pending = new Map();
+    closed = false;
+    constructor(opts) {
+        this.tabId = opts.tabId ?? 0;
+        this.attachTimeoutMs = opts.attachTimeoutMs ?? DEFAULT_ATTACH_TIMEOUT_MS;
+        this.socket =
+            opts.socket ??
+                new WebSocketTransport(opts.url ?? DEFAULT_BRIDGE_URL, opts.token ? { [BRIDGE_TOKEN_HEADER]: opts.token } : undefined);
+    }
+    async open(handlers) {
+        this.handlers = handlers;
+        await this.socket.open({
+            message: (data) => this.onBridgeMessage(data),
+            close: (err) => this.onGone(err ?? new Error('extension bridge closed')),
+            error: (err) => this.onGone(err),
+        });
+        const reply = await this.command('cdp_attach', undefined, this.attachTimeoutMs);
+        if (reply.success === false) {
+            this.socket.close();
+            const where = this.tabId ? `tab ${this.tabId}` : 'the active tab';
+            throw new Error(`bridge attach to ${where} failed: ${reply.error ?? 'unknown'}`);
+        }
+        // The extension answers with the tab it actually attached to, which is
+        // the only way to learn the id when we asked for "whatever is active".
+        if (typeof reply.data?.tabId === 'number')
+            this.tabId = reply.data.tabId;
+        if (!this.tabId) {
+            this.socket.close();
+            throw new Error('bridge attach did not report a tab id');
+        }
+    }
+    /** The tab this transport is driving; valid once open() has resolved. */
+    get attachedTabId() {
+        return this.tabId;
+    }
+    /** The session id every instrument should use against this transport. */
+    get sessionId() {
+        return bridgeSessionId(this.tabId);
+    }
+    async send(frame) {
+        const cdp = JSON.parse(frame);
+        if (this.answerLocally(cdp))
+            return;
+        const params = {
+            method: cdp.method,
+            params: cdp.params ?? {},
+        };
+        // A synthetic id means "the tab itself", which chrome.debugger addresses
+        // by its debuggee alone. Anything else is a real child session id and
+        // has to travel, or the command lands in the wrong frame.
+        if (cdp.sessionId !== undefined && !isBridgeSessionId(cdp.sessionId)) {
+            params.sessionId = cdp.sessionId;
+        }
+        const reply = await this.command('cdp', params);
+        if (reply.success === false) {
+            this.deliver({
+                id: cdp.id,
+                // -32000 is CDP's own "server error" code; the bridge has no richer
+                // one to offer, and the message is what a caller actually reads.
+                error: { code: -32000, message: reply.error ?? 'bridge command failed' },
+            });
+            return;
+        }
+        this.deliver({ id: cdp.id, result: reply.data?.result ?? {} });
+    }
+    close() {
+        if (this.closed)
+            return;
+        this.closed = true;
+        // Best effort, and deliberately not awaited: leaving the debugger
+        // attached leaves Chrome's debugging banner on the user's tab. The
+        // extension's idle sweep would eventually detach anyway.
+        void this.command('cdp_detach').catch(() => { });
+        this.socket.close();
+        this.failPending(new Error('extension bridge closed'));
+    }
+    // --- internals -----------------------------------------------------------
+    /**
+     * Commands this transport answers itself. `Target.attachToTarget` against
+     * the tab is the one that matters: monobrowse's connect path asks for a
+     * session, and over the bridge there is nothing to ask — the debuggee is
+     * already the session. Any *other* target id is a genuine child target and
+     * goes to Chrome.
+     */
+    answerLocally(cdp) {
+        const targetId = cdp.params?.targetId;
+        if (cdp.method === 'Target.attachToTarget' && targetId === bridgeTargetId(this.tabId)) {
+            this.deliver({ id: cdp.id, result: { sessionId: bridgeSessionId(this.tabId) } });
+            return true;
+        }
+        if (cdp.method === 'Target.detachFromTarget' &&
+            isBridgeSessionId(cdp.params?.sessionId)) {
+            this.deliver({ id: cdp.id, result: {} });
+            return true;
+        }
+        return false;
+    }
+    command(type, params, timeoutMs = 0) {
+        const id = `cdp-${this.nextEnvelopeId++}`;
+        const envelope = { id, type, params };
+        if (this.tabId)
+            envelope.tabId = this.tabId;
+        return new Promise((resolve, reject) => {
+            let timer;
+            if (timeoutMs > 0) {
+                timer = setTimeout(() => {
+                    this.pending.delete(id);
+                    reject(new Error(`bridge ${type} timed out after ${timeoutMs}ms`));
+                }, timeoutMs);
+                timer.unref?.();
+            }
+            this.pending.set(id, (reply) => {
+                if (timer)
+                    clearTimeout(timer);
+                resolve(reply);
+            });
+            this.socket.send(JSON.stringify(envelope)).catch((err) => {
+                if (timer)
+                    clearTimeout(timer);
+                this.pending.delete(id);
+                reject(err);
+            });
+        });
+    }
+    onBridgeMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data);
+        }
+        catch {
+            return; // malformed frames are ignored, as on a raw CDP socket
+        }
+        if (msg.type === 'cdp_event') {
+            this.relayEvent(msg);
+            return;
+        }
+        if (msg.id !== undefined) {
+            const settle = this.pending.get(msg.id);
+            if (settle) {
+                this.pending.delete(msg.id);
+                settle(msg);
+            }
+        }
+    }
+    relayEvent(msg) {
+        const ev = msg.data;
+        if (!ev?.method)
+            return;
+        // One relay socket can carry several tabs; take only our own.
+        if (ev.tabId !== undefined && ev.tabId !== this.tabId)
+            return;
+        // The debugger went away — the user hit Cancel on the banner, DevTools
+        // opened on the tab, or the tab closed. Nothing else will arrive, and a
+        // caller waiting on a command should hear that now rather than time out.
+        if (ev.method === 'Inspector.detached') {
+            const reason = ev.params?.reason ?? 'unknown';
+            this.onGone(new Error(`extension bridge detached from tab ${this.tabId}: ${reason}`));
+            return;
+        }
+        this.deliver({
+            method: ev.method,
+            params: ev.params ?? {},
+            // A real child session id wins; otherwise this is the tab's own
+            // session, which every instrument filters its events by.
+            sessionId: ev.sessionId ?? bridgeSessionId(this.tabId),
+        });
+    }
+    deliver(frame) {
+        this.handlers?.message(JSON.stringify(frame));
+    }
+    onGone(err) {
+        this.failPending(err);
+        this.handlers?.close(err);
+    }
+    failPending(err) {
+        for (const settle of this.pending.values()) {
+            settle({ success: false, error: err.message });
+        }
+        this.pending.clear();
+    }
+}
+/**
+ * Connect a CdpClient to the user's real Chrome through the extension
+ * bridge, with the same domains enabled that a local session gets. This is
+ * the whole of the "point the instruments at the logged-in browser" story
+ * at the call site:
+ *
+ *     const { client, sessionId } = await connectBridge({ token });
+ *     const vitals = await collectVitals(client, sessionId);
+ *
+ * `enableDomains` is on by default for parity with connectToTarget. Turn it
+ * off for a caller that wants to choose its own domains (a bridge attach is
+ * visible to the user, so a lighter footprint is sometimes the point).
+ */
+export async function connectBridge(opts = {}) {
+    const transport = new BridgeTransport(opts);
+    const client = new CdpClient();
+    await client.connectTransport(transport);
+    const sessionId = transport.sessionId;
+    if (opts.enableDomains !== false) {
+        await enableSessionDomains(client, sessionId);
+    }
+    return { client, sessionId, tabId: transport.attachedTabId, transport };
+}
+//# sourceMappingURL=bridge.js.map

package/dist/src/browser/bridge.js.map

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

package/dist/src/browser/cdp.d.ts

@@ -1,14 +1,24 @@
+import type { CdpTransport } from './transport.js';
 import type { CdpTarget } from './types.js';
 export declare const DEFAULT_CDP_SEND_TIMEOUT_MS = 30000;
 export declare class CdpClient {
-    private ws;
+    private transport;
     private pendingCommands;
     private eventListeners;
     private nextId;
     private connected;
     constructor();
     private flushPending;
+    /** Connect to a Chrome DevTools WebSocket endpoint (the original path). */
     connect(wsUrl: string): Promise<void>;
+    /**
+     * Connect over any transport — a local DevTools socket, or the extension
+     * bridge to the user's own logged-in Chrome (see bridge.ts). Everything
+     * downstream of here (sessions, events, timeouts) is identical either way,
+     * which is the point: the instruments never learn which one they are on.
+     */
+    connectTransport(transport: CdpTransport): Promise<void>;
+    private handleMessage;
     send<T = Record<string, unknown>>(method: string, params?: Record<string, unknown>, sessionId?: string, timeoutMs?: number): Promise<T>;
     on(event: string, fn: (params: Record<string, unknown>, sessionId?: string) => void): () => void;
     once(event: string, sessionId?: string): Promise<Record<string, unknown>>;

package/dist/src/browser/cdp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../../src/browser/cdp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA2B,SAAS,EAAE,MAAM,YAAY,CAAC;AAUrE,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,qBAAa,SAAS;IACpB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,eAAe,CAOnB;IACJ,OAAO,CAAC,cAAc,CAGlB;IACJ,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAE1B,cAOC;IAED,OAAO,CAAC,YAAY;IASd,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkD1C;IAED,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,CAAC,CAAC,CA2CZ;IAED,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAW/F;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAGxE;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAU7F;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,WAAW,IAAI,OAAO,CAErB;CACF;AAYD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAIrE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAOlF;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAoEtF"}
+{"version":3,"file":"cdp.d.ts","sourceRoot":"","sources":["../../../src/browser/cdp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,KAAK,EAA2B,SAAS,EAAE,MAAM,YAAY,CAAC;AAUrE,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAMlD,qBAAa,SAAS;IACpB,OAAO,CAAC,SAAS,CAA6B;IAC9C,OAAO,CAAC,eAAe,CAOnB;IACJ,OAAO,CAAC,cAAc,CAGlB;IACJ,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,SAAS,CAAS;IAE1B,cAOC;IAED,OAAO,CAAC,YAAY;IASpB,2EAA2E;IACrE,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE1C;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAavD;IAED,OAAO,CAAC,aAAa;IA4BrB,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,GAAE,MAAoC,GAC9C,OAAO,CAAC,CAAC,CAAC,CAyCZ;IAED,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAW/F;IAED,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAGxE;IAED,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAU7F;IAED,KAAK,IAAI,IAAI,CAKZ;IAED,WAAW,IAAI,OAAO,CAErB;CACF;AAYD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAIrE;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAOlF;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,OAAO,CAAC,WAAW,CAAC,CAoEtF"}

package/dist/src/browser/cdp.js

@@ -1,4 +1,4 @@
-import { WebSocket } from 'ws';
+import { WebSocketTransport } from './transport.js';
 // send() had no timeout of its own — a command whose response never arrives
 // (wedged/crashed renderer, dropped socket that never fires 'close') left a
 // pendingCommands entry forever, hanging whatever awaited it (and, since
@@ -8,8 +8,11 @@ import { WebSocket } from 'ws';
 // protection at all. This is the default for every send() unless a caller
 // passes 0 (no timeout) or a different value.
 export const DEFAULT_CDP_SEND_TIMEOUT_MS = 30_000;
+// The message every path uses to say the connection went away. Shared so a
+// caller matching on it does not have to care which transport was under it.
+const CDP_CLOSED_MESSAGE = 'CDP connection closed';
 export class CdpClient {
-    ws = null;
+    transport = null;
     pendingCommands = new Map();
     eventListeners = new Map();
     nextId = 1;
@@ -31,61 +34,64 @@ export class CdpClient {
         }
         this.pendingCommands.clear();
     }
+    /** Connect to a Chrome DevTools WebSocket endpoint (the original path). */
     async connect(wsUrl) {
-        return new Promise((resolve, reject) => {
-            this.ws = new WebSocket(wsUrl);
-            this.ws.on('open', () => {
-                this.connected = true;
-                resolve();
-            });
-            this.ws.on('error', (err) => {
-                if (!this.connected) {
-                    reject(err);
+        return this.connectTransport(new WebSocketTransport(wsUrl));
+    }
+    /**
+     * Connect over any transport — a local DevTools socket, or the extension
+     * bridge to the user's own logged-in Chrome (see bridge.ts). Everything
+     * downstream of here (sessions, events, timeouts) is identical either way,
+     * which is the point: the instruments never learn which one they are on.
+     */
+    connectTransport(transport) {
+        this.transport = transport;
+        return transport
+            .open({
+            message: (data) => this.handleMessage(data),
+            // Post-connect failure of either kind strands every in-flight
+            // command, so both flush: 'close' may not fire on all platforms.
+            close: (err) => this.flushPending(err ?? new Error(CDP_CLOSED_MESSAGE)),
+            error: (err) => this.flushPending(err),
+        })
+            .then(() => {
+            this.connected = true;
+        });
+    }
+    handleMessage(data) {
+        try {
+            const msg = JSON.parse(data);
+            if (msg.id !== undefined && this.pendingCommands.has(msg.id)) {
+                const handler = this.pendingCommands.get(msg.id);
+                this.pendingCommands.delete(msg.id);
+                if (msg.error) {
+                    handler.reject(new Error(`CDP error ${msg.error.code}: ${msg.error.message}`));
                 }
                 else {
-                    // Post-connect: flush all pending commands — 'close' may not fire on all platforms
-                    this.flushPending(err instanceof Error ? err : new Error(String(err)));
+                    handler.resolve(msg);
                 }
-            });
-            this.ws.on('close', () => {
-                this.flushPending(new Error('CDP connection closed'));
-            });
-            this.ws.on('message', (data) => {
-                try {
-                    const msg = JSON.parse(data.toString());
-                    if (msg.id !== undefined && this.pendingCommands.has(msg.id)) {
-                        const handler = this.pendingCommands.get(msg.id);
-                        this.pendingCommands.delete(msg.id);
-                        if (msg.error) {
-                            handler.reject(new Error(`CDP error ${msg.error.code}: ${msg.error.message}`));
-                        }
-                        else {
-                            handler.resolve(msg);
+            }
+            else if (msg.method) {
+                const listeners = this.eventListeners.get(msg.method);
+                if (listeners) {
+                    for (const fn of listeners) {
+                        try {
+                            fn(msg.params ?? {}, msg.sessionId);
                         }
-                    }
-                    else if (msg.method) {
-                        const listeners = this.eventListeners.get(msg.method);
-                        if (listeners) {
-                            for (const fn of listeners) {
-                                try {
-                                    fn(msg.params ?? {}, msg.sessionId);
-                                }
-                                catch {
-                                    /* isolate per-listener errors */
-                                }
-                            }
+                        catch {
+                            /* isolate per-listener errors */
                         }
                     }
                 }
-                catch {
-                    // ignore malformed messages
-                }
-            });
-        });
+            }
+        }
+        catch {
+            // ignore malformed messages
+        }
     }
     send(method, params, sessionId, timeoutMs = DEFAULT_CDP_SEND_TIMEOUT_MS) {
         return new Promise((resolve, reject) => {
-            if (!this.ws || !this.connected) {
+            if (!this.transport || !this.connected) {
                 reject(new Error('CDP not connected'));
                 return;
             }
@@ -119,13 +125,11 @@ export class CdpClient {
                 },
                 timer,
             });
-            this.ws.send(JSON.stringify(cmd), (err) => {
-                if (err) {
-                    if (timer)
-                        clearTimeout(timer);
-                    this.pendingCommands.delete(id);
-                    reject(err);
-                }
+            this.transport.send(JSON.stringify(cmd)).catch((err) => {
+                if (timer)
+                    clearTimeout(timer);
+                this.pendingCommands.delete(id);
+                reject(err);
             });
         });
     }
@@ -158,9 +162,9 @@ export class CdpClient {
         return [promise, () => off()];
     }
     close() {
-        this.flushPending(new Error('CDP connection closed'));
-        this.ws?.close();
-        this.ws = null;
+        this.flushPending(new Error(CDP_CLOSED_MESSAGE));
+        this.transport?.close();
+        this.transport = null;
         this.eventListeners.clear();
     }
     isConnected() {