@monoes/monobrowse 1.0.12 → 1.0.14

package/dist/src/__tests__/bridge-instruments.test.d.ts

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

package/dist/src/__tests__/bridge-instruments.test.d.ts.map

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

package/dist/src/__tests__/bridge-instruments.test.js

@@ -0,0 +1,132 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { WebSocketServer } from 'ws';
+import { BridgeTransport, bridgeSessionId } from '../browser/bridge.js';
+import { CdpClient } from '../browser/cdp.js';
+import { clearConsoleMessages, getConsoleMessages, getPageErrors, setupConsoleCapture, teardownConsoleCapture, } from '../browser/console-log.js';
+import { getCapturedRequests, startRequestCapture, stopRequestCapture, } from '../browser/network.js';
+import { collectVitals } from '../browser/vitals.js';
+/** The Go relay plus the extension behind it, as far as CDP is concerned. */
+class FakeChrome {
+    server;
+    socket = null;
+    /** Canned Runtime.evaluate return values, by the order they are asked for. */
+    evalResults = [];
+    methods = [];
+    constructor() {
+        this.server = new WebSocketServer({ host: '127.0.0.1', port: 0 });
+        this.server.on('connection', (ws) => {
+            this.socket = ws;
+            ws.on('message', (raw) => {
+                const env = JSON.parse(raw.toString());
+                if (env.type !== 'cdp') {
+                    ws.send(JSON.stringify({ id: env.id, success: true, data: { tabId: env.tabId ?? 5 } }));
+                    return;
+                }
+                const { method } = env.params;
+                this.methods.push(method);
+                const result = method === 'Runtime.evaluate'
+                    ? { result: { type: 'object', value: this.evalResults.shift() ?? {} } }
+                    : {};
+                ws.send(JSON.stringify({ id: env.id, success: true, data: { result } }));
+            });
+        });
+    }
+    get url() {
+        return `ws://127.0.0.1:${this.server.address().port}/monoagent/cdp`;
+    }
+    ready() {
+        return new Promise((resolve) => this.server.once('listening', resolve));
+    }
+    /** What chrome.debugger.onEvent delivers, relayed up the bridge. */
+    emit(tabId, method, params) {
+        this.socket.send(JSON.stringify({ type: 'cdp_event', data: { tabId, method, params } }));
+    }
+    close() {
+        return new Promise((resolve) => this.server.close(() => resolve()));
+    }
+}
+const TAB = 5;
+const SESSION = bridgeSessionId(TAB);
+describe('RIG-07: monobrowse instruments over the extension bridge', () => {
+    let chrome;
+    let client;
+    beforeEach(async () => {
+        chrome = new FakeChrome();
+        if (chrome.server.address() === null)
+            await chrome.ready();
+        client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: TAB, url: chrome.url, token: 'tok' }));
+    });
+    afterEach(async () => {
+        client.close();
+        await chrome.close();
+    });
+    // browser_console: setupConsoleCapture at connect, read the buffers later.
+    it('browser_console reads the real tab console', async () => {
+        setupConsoleCapture(client, SESSION);
+        clearConsoleMessages(SESSION);
+        await client.send('Runtime.enable', {}, SESSION);
+        await client.send('Log.enable', {}, SESSION);
+        chrome.emit(TAB, 'Runtime.consoleAPICalled', {
+            type: 'warning',
+            args: [{ value: 'cart total mismatch' }],
+        });
+        chrome.emit(TAB, 'Log.entryAdded', {
+            entry: { level: 'error', text: 'Failed to load resource: 402', url: 'https://shop.test/pay' },
+        });
+        chrome.emit(TAB, 'Runtime.exceptionThrown', {
+            exceptionDetails: { exception: { description: 'ReferenceError: checkout is not defined' } },
+        });
+        await tick();
+        expect(getConsoleMessages(SESSION)).toMatchObject([
+            { type: 'warn', text: 'cart total mismatch' },
+            { type: 'error', text: 'Failed to load resource: 402', url: 'https://shop.test/pay' },
+        ]);
+        expect(getPageErrors(SESSION)).toMatchObject([
+            { text: 'ReferenceError: checkout is not defined' },
+        ]);
+        teardownConsoleCapture(SESSION);
+    });
+    // browser_network action:"start" then action:"list".
+    it('browser_network records the real tab requests', async () => {
+        startRequestCapture(client, SESSION);
+        chrome.emit(TAB, 'Network.requestWillBeSent', {
+            requestId: 'R1',
+            request: { url: 'https://shop.test/api/cart', method: 'GET', headers: {} },
+            timestamp: 1,
+        });
+        chrome.emit(TAB, 'Network.responseReceived', {
+            requestId: 'R1',
+            response: { status: 402, mimeType: 'application/json', headers: {} },
+            timestamp: 2,
+        });
+        chrome.emit(TAB, 'Network.loadingFinished', {
+            requestId: 'R1',
+            timestamp: 2,
+            encodedDataLength: 1234,
+        });
+        await tick();
+        expect(getCapturedRequests(SESSION)).toMatchObject([
+            { url: 'https://shop.test/api/cart', method: 'GET', status: 402 },
+        ]);
+        stopRequestCapture(SESSION);
+    });
+    // browser_vitals: one Runtime.evaluate, straight through the bridge.
+    it('browser_vitals measures the real tab', async () => {
+        chrome.evalResults = [{ lcp: 2400, fcp: 900, cls: 0.03, ttfb: 180 }];
+        const vitals = await collectVitals(client, SESSION, 0);
+        expect(vitals).toMatchObject({ lcp: 2400, fcp: 900, cls: 0.03, ttfb: 180 });
+        expect(chrome.methods).toContain('Runtime.evaluate');
+    });
+    it('every command reached the tab session, with no CDP sessionId on the wire', async () => {
+        await client.send('Page.enable', {}, SESSION);
+        // The synthetic session id is monobrowse's bookkeeping; chrome.debugger
+        // addresses the page by its debuggee, so it must never travel.
+        expect(chrome.methods).toEqual(['Page.enable']);
+    });
+});
+/** Let the relayed events drain through the socket and the listeners. */
+function tick() {
+    return new Promise((r) => setTimeout(r, 50));
+}
+//# sourceMappingURL=bridge-instruments.test.js.map

package/dist/src/__tests__/bridge-instruments.test.js.map

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

package/dist/src/__tests__/bridge-transport.test.d.ts

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

package/dist/src/__tests__/bridge-transport.test.d.ts.map

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

package/dist/src/__tests__/bridge-transport.test.js

@@ -0,0 +1,287 @@
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+import { WebSocketServer } from 'ws';
+import { BRIDGE_TOKEN_HEADER, BridgeTransport, bridgeSessionId, bridgeTargetId, } from '../browser/bridge.js';
+import { CdpClient } from '../browser/cdp.js';
+import { getConsoleMessages, getPageErrors, setupConsoleCapture, teardownConsoleCapture, } from '../browser/console-log.js';
+// --- a scripted inner pipe, for the translation unit tests -----------------
+class ScriptedSocket {
+    sent = [];
+    closed = false;
+    handlers = null;
+    /** Answers each outbound envelope as the relay would. */
+    autoReply = null;
+    async open(handlers) {
+        this.handlers = handlers;
+    }
+    async send(frame) {
+        const env = JSON.parse(frame);
+        this.sent.push(env);
+        const reply = this.autoReply?.(env);
+        if (reply !== undefined)
+            this.push(reply);
+    }
+    close() {
+        this.closed = true;
+    }
+    push(msg) {
+        this.handlers.message(JSON.stringify(msg));
+    }
+    drop(err) {
+        this.handlers.close(err);
+    }
+    /** The last envelope of a given type. */
+    lastOf(type) {
+        return [...this.sent]
+            .reverse()
+            .find((e) => e.type === type);
+    }
+}
+/** A socket whose attach and plain cdp commands always succeed. */
+function okSocket() {
+    const s = new ScriptedSocket();
+    s.autoReply = (env) => {
+        if (env.type === 'cdp_attach' || env.type === 'cdp_detach') {
+            return { id: env.id, success: true, data: {} };
+        }
+        if (env.type === 'cdp') {
+            const params = env.params;
+            return { id: env.id, success: true, data: { result: { echoed: params.method } } };
+        }
+        return undefined;
+    };
+    return s;
+}
+describe('BridgeTransport framing', () => {
+    it('attaches the debugger to the tab before reporting itself open', async () => {
+        const socket = okSocket();
+        const t = new BridgeTransport({ tabId: 42, socket });
+        await t.open({ message: () => { }, close: () => { }, error: () => { } });
+        const attach = socket.lastOf('cdp_attach');
+        expect(attach.tabId).toBe(42);
+    });
+    it('fails open() when the tab cannot be attached, instead of half-connecting', async () => {
+        const socket = new ScriptedSocket();
+        socket.autoReply = (env) => ({
+            id: env.id,
+            success: false,
+            error: 'debugger attach: Cannot access a chrome:// URL',
+        });
+        const t = new BridgeTransport({ tabId: 7, socket });
+        await expect(t.open({ message: () => { }, close: () => { }, error: () => { } })).rejects.toThrow(/Cannot access a chrome:\/\/ URL/);
+    });
+    it('wraps a CDP frame as a bridge command and unwraps the result', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        const result = await client.send('Page.navigate', { url: 'https://x.test' });
+        const cmd = socket.lastOf('cdp');
+        expect(cmd.tabId).toBe(42);
+        expect(cmd.params).toEqual({ method: 'Page.navigate', params: { url: 'https://x.test' } });
+        expect(result).toEqual({ echoed: 'Page.navigate' });
+    });
+    it('turns a bridge error into a CDP error the caller can read', async () => {
+        const socket = new ScriptedSocket();
+        socket.autoReply = (env) => env.type === 'cdp_attach'
+            ? { id: env.id, success: true, data: {} }
+            : { id: env.id, success: false, error: 'Not allowed' };
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        await expect(client.send('HeapProfiler.enable')).rejects.toThrow(/Not allowed/);
+    });
+    it('strips the synthetic session id from commands on the tab session', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        await client.send('Runtime.enable', {}, bridgeSessionId(42));
+        const cmd = socket.lastOf('cdp');
+        // chrome.debugger's tab debuggee IS the page session; a sessionId here
+        // would make it look for a child session that does not exist.
+        expect(cmd.params).toEqual({ method: 'Runtime.enable', params: {} });
+    });
+    it('passes a real child session id through for out-of-process frames', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        await client.send('Runtime.enable', {}, 'OOPIF-SESSION-1');
+        const cmd = socket.lastOf('cdp');
+        expect(cmd.params).toEqual({
+            method: 'Runtime.enable',
+            params: {},
+            sessionId: 'OOPIF-SESSION-1',
+        });
+    });
+    it('answers Target.attachToTarget for the tab itself without touching the bridge', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        const before = socket.sent.length;
+        const attached = await client.send('Target.attachToTarget', {
+            targetId: bridgeTargetId(42),
+            flatten: true,
+        });
+        expect(attached.sessionId).toBe(bridgeSessionId(42));
+        expect(socket.sent.length).toBe(before);
+    });
+    it('forwards Target.attachToTarget for any other target', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        await client.send('Target.attachToTarget', { targetId: 'SOME-IFRAME', flatten: true });
+        expect(socket.lastOf('cdp').params.params).toEqual({
+            targetId: 'SOME-IFRAME',
+            flatten: true,
+        });
+    });
+    it('labels relayed events with the tab session so per-session listeners match', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        const seen = [];
+        client.on('Network.responseReceived', (_p, sid) => void seen.push(sid));
+        socket.push({
+            type: 'cdp_event',
+            data: { tabId: 42, method: 'Network.responseReceived', params: { requestId: 'R1' } },
+        });
+        expect(seen).toEqual([bridgeSessionId(42)]);
+    });
+    it('keeps a child session id on events that carry one', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        const seen = [];
+        client.on('Network.responseReceived', (_p, sid) => void seen.push(sid));
+        socket.push({
+            type: 'cdp_event',
+            data: {
+                tabId: 42,
+                sessionId: 'OOPIF-SESSION-1',
+                method: 'Network.responseReceived',
+                params: {},
+            },
+        });
+        expect(seen).toEqual(['OOPIF-SESSION-1']);
+    });
+    it('ignores events for a tab this transport is not driving', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        const seen = [];
+        client.on('Network.responseReceived', (p) => void seen.push(p));
+        socket.push({
+            type: 'cdp_event',
+            data: { tabId: 99, method: 'Network.responseReceived', params: {} },
+        });
+        expect(seen).toEqual([]);
+    });
+    it('fails in-flight commands when the debugger is detached out from under it', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        socket.autoReply = null; // this one never gets answered
+        const pending = client.send('Page.enable', {}, undefined, 0);
+        socket.push({
+            type: 'cdp_event',
+            data: { tabId: 42, method: 'Inspector.detached', params: { reason: 'canceled_by_user' } },
+        });
+        await expect(pending).rejects.toThrow(/canceled_by_user/);
+        expect(client.isConnected()).toBe(false);
+    });
+    it('detaches the debugger when the client closes, so the banner goes away', async () => {
+        const socket = okSocket();
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 42, socket }));
+        client.close();
+        expect(socket.lastOf('cdp_detach')).toMatchObject({ tabId: 42 });
+        expect(socket.closed).toBe(true);
+    });
+});
+// --- end to end over a real socket -----------------------------------------
+/**
+ * Stands in for `/monoagent/cdp` plus the extension behind it: answers the
+ * bridge envelopes and can push unsolicited events, exactly as the Go relay
+ * fans out `chrome.debugger.onEvent`.
+ */
+class FakeBridge {
+    server;
+    socket = null;
+    tokens = [];
+    commands = [];
+    constructor() {
+        this.server = new WebSocketServer({ host: '127.0.0.1', port: 0 });
+        this.server.on('connection', (ws, req) => {
+            this.socket = ws;
+            this.tokens.push(req.headers[BRIDGE_TOKEN_HEADER.toLowerCase()]);
+            ws.on('message', (raw) => {
+                const env = JSON.parse(raw.toString());
+                if (env.type === 'cdp_attach' || env.type === 'cdp_detach') {
+                    ws.send(JSON.stringify({ id: env.id, success: true, data: {} }));
+                    return;
+                }
+                if (env.type === 'cdp') {
+                    this.commands.push(env.params);
+                    ws.send(JSON.stringify({ id: env.id, success: true, data: { result: {} } }));
+                }
+            });
+        });
+    }
+    get url() {
+        const { port } = this.server.address();
+        return `ws://127.0.0.1:${port}/monoagent/cdp`;
+    }
+    ready() {
+        return new Promise((resolve) => this.server.once('listening', resolve));
+    }
+    /** Push an event up as the extension's chrome.debugger.onEvent would. */
+    emit(tabId, method, params) {
+        this.socket.send(JSON.stringify({ type: 'cdp_event', data: { tabId, method, params } }));
+    }
+    close() {
+        return new Promise((resolve) => this.server.close(() => resolve()));
+    }
+}
+describe('BridgeTransport end to end over a real socket', () => {
+    let bridge;
+    beforeEach(async () => {
+        bridge = new FakeBridge();
+        if (bridge.server.address() === null)
+            await bridge.ready();
+    });
+    afterEach(async () => {
+        await bridge.close();
+    });
+    it('carries console capture — an unmodified instrument — over the bridge', async () => {
+        const client = new CdpClient();
+        const transport = new BridgeTransport({ tabId: 5, url: bridge.url, token: 'tok-123' });
+        await client.connectTransport(transport);
+        const sessionId = bridgeSessionId(5);
+        setupConsoleCapture(client, sessionId);
+        // console-log.ts, untouched: it enables the domains it needs...
+        await client.send('Runtime.enable', {}, sessionId);
+        await client.send('Log.enable', {}, sessionId);
+        // ...and the page's console output arrives as a relayed debugger event.
+        bridge.emit(5, 'Runtime.consoleAPICalled', {
+            type: 'error',
+            args: [{ value: 'checkout failed' }],
+        });
+        bridge.emit(5, 'Runtime.exceptionThrown', {
+            exceptionDetails: { exception: { description: 'TypeError: x is not a function' } },
+        });
+        await new Promise((r) => setTimeout(r, 50));
+        expect(getConsoleMessages(sessionId)).toMatchObject([
+            { type: 'error', text: 'checkout failed' },
+        ]);
+        expect(getPageErrors(sessionId)).toMatchObject([{ text: 'TypeError: x is not a function' }]);
+        expect(bridge.commands.map((c) => c.method)).toEqual(['Runtime.enable', 'Log.enable']);
+        expect(bridge.tokens).toEqual(['tok-123']);
+        teardownConsoleCapture(sessionId);
+        client.close();
+    });
+    it('reports a dropped bridge to in-flight callers', async () => {
+        const client = new CdpClient();
+        await client.connectTransport(new BridgeTransport({ tabId: 5, url: bridge.url, token: 'tok-123' }));
+        const pending = client.send('Page.captureScreenshot', {}, undefined, 0);
+        bridge.socket.close();
+        await expect(pending).rejects.toThrow(/closed|bridge/i);
+    });
+});
+//# sourceMappingURL=bridge-transport.test.js.map

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

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

package/dist/src/__tests__/cdp-transport.test.d.ts

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

package/dist/src/__tests__/cdp-transport.test.d.ts.map

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

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

@@ -0,0 +1,167 @@
+/**
+ * The transport seam under CdpClient.
+ *
+ * Two halves: WebSocketTransport must behave exactly as the inlined `ws`
+ * handling it replaced (that is what keeps the 474 existing tests honest),
+ * and CdpClient must drive *any* transport — the whole point of the seam,
+ * since the bridge-backed one is not a socket to a local Chrome at all.
+ */
+import { describe, expect, it, vi } from 'vitest';
+// --- fake `ws` -------------------------------------------------------------
+let lastSocket = null;
+class FakeWs {
+    url;
+    handlers = new Map();
+    sent = [];
+    closed = false;
+    sendError = null;
+    constructor(url) {
+        this.url = url;
+        lastSocket = this;
+    }
+    on(event, fn) {
+        if (!this.handlers.has(event))
+            this.handlers.set(event, []);
+        this.handlers.get(event).push(fn);
+    }
+    emit(event, ...args) {
+        for (const fn of [...(this.handlers.get(event) ?? [])])
+            fn(...args);
+    }
+    send(data, cb) {
+        this.sent.push(data);
+        cb?.(this.sendError ?? undefined);
+    }
+    close() {
+        this.closed = true;
+    }
+}
+vi.mock('ws', () => ({ WebSocket: FakeWs }));
+const { WebSocketTransport } = await import('../browser/transport.js');
+const { CdpClient } = await import('../browser/cdp.js');
+/** Collects what a transport hands back up to its owner. */
+function recorder() {
+    const messages = [];
+    const closes = [];
+    const errors = [];
+    return {
+        messages,
+        closes,
+        message: (d) => void messages.push(d),
+        close: (e) => void closes.push(e),
+        error: (e) => void errors.push(e),
+    };
+}
+describe('WebSocketTransport', () => {
+    it('opens on the socket "open" event and reports the url it dialed', async () => {
+        const t = new WebSocketTransport('ws://127.0.0.1:9222/devtools/page/ABC');
+        const p = t.open(recorder());
+        lastSocket.emit('open');
+        await p;
+        expect(lastSocket.url).toBe('ws://127.0.0.1:9222/devtools/page/ABC');
+    });
+    it('rejects open() when the socket errors before it ever opened', async () => {
+        const t = new WebSocketTransport('ws://127.0.0.1:1/devtools');
+        const p = t.open(recorder());
+        lastSocket.emit('error', new Error('ECONNREFUSED'));
+        await expect(p).rejects.toThrow('ECONNREFUSED');
+    });
+    it('routes a post-open error to error(), not to a rejected open()', async () => {
+        const h = recorder();
+        const errors = [];
+        h.error = (e) => void errors.push(e);
+        const t = new WebSocketTransport('ws://x');
+        const p = t.open(h);
+        lastSocket.emit('open');
+        await p;
+        lastSocket.emit('error', new Error('EPIPE'));
+        expect(errors.map((e) => e.message)).toEqual(['EPIPE']);
+    });
+    it('delivers messages as strings and reports close', async () => {
+        const h = recorder();
+        const t = new WebSocketTransport('ws://x');
+        const p = t.open(h);
+        lastSocket.emit('open');
+        await p;
+        lastSocket.emit('message', Buffer.from('{"id":1}'));
+        expect(h.messages).toEqual(['{"id":1}']);
+        lastSocket.emit('close');
+        expect(h.closes).toHaveLength(1);
+    });
+    it('rejects send() with the socket error and closes the socket on close()', async () => {
+        const t = new WebSocketTransport('ws://x');
+        const p = t.open(recorder());
+        lastSocket.emit('open');
+        await p;
+        await expect(t.send('{"id":1}')).resolves.toBeUndefined();
+        expect(lastSocket.sent).toEqual(['{"id":1}']);
+        lastSocket.sendError = new Error('socket gone');
+        await expect(t.send('{"id":2}')).rejects.toThrow('socket gone');
+        t.close();
+        expect(lastSocket.closed).toBe(true);
+    });
+});
+// --- CdpClient over an arbitrary transport ---------------------------------
+/** A transport with no socket at all: the test *is* the other end. */
+class ScriptedTransport {
+    sent = [];
+    closed = false;
+    handlers = null;
+    async open(handlers) {
+        this.handlers = handlers;
+    }
+    async send(frame) {
+        this.sent.push(frame);
+    }
+    close() {
+        this.closed = true;
+    }
+    /** Push a frame up as if it had arrived from the other side. */
+    deliver(msg) {
+        this.handlers.message(JSON.stringify(msg));
+    }
+    drop(err) {
+        this.handlers.close(err);
+    }
+}
+describe('CdpClient.connectTransport', () => {
+    it('round-trips a command through a transport that is not a socket', async () => {
+        const t = new ScriptedTransport();
+        const client = new CdpClient();
+        await client.connectTransport(t);
+        expect(client.isConnected()).toBe(true);
+        const pending = client.send('Page.navigate', { url: 'https://x.test' });
+        const sent = JSON.parse(t.sent[0]);
+        expect(sent.method).toBe('Page.navigate');
+        expect(sent.params).toEqual({ url: 'https://x.test' });
+        t.deliver({ id: sent.id, result: { frameId: 'F1' } });
+        expect(await pending).toEqual({ frameId: 'F1' });
+    });
+    it('dispatches events with their sessionId to listeners', async () => {
+        const t = new ScriptedTransport();
+        const client = new CdpClient();
+        await client.connectTransport(t);
+        const seen = [];
+        client.on('Network.responseReceived', (params, sid) => void seen.push([params, sid]));
+        t.deliver({ method: 'Network.responseReceived', params: { requestId: 'R1' }, sessionId: 'S1' });
+        expect(seen).toEqual([[{ requestId: 'R1' }, 'S1']]);
+    });
+    it('flushes in-flight commands when the transport drops', async () => {
+        const t = new ScriptedTransport();
+        const client = new CdpClient();
+        await client.connectTransport(t);
+        const pending = client.send('Page.enable');
+        t.drop(new Error('bridge disconnected'));
+        await expect(pending).rejects.toThrow('bridge disconnected');
+        expect(client.isConnected()).toBe(false);
+    });
+    it('closes the transport when the client closes', async () => {
+        const t = new ScriptedTransport();
+        const client = new CdpClient();
+        await client.connectTransport(t);
+        client.close();
+        expect(t.closed).toBe(true);
+        await expect(client.send('Page.enable')).rejects.toThrow('CDP not connected');
+    });
+});
+//# sourceMappingURL=cdp-transport.test.js.map