@mechris3/glassbox 0.1.0

package/dist/src/ai/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Types for diagnostic data exposed to consumers (AI bridge, UI, CLI).
+ */
+export interface ConsoleError {
+    level: 'error' | 'warning';
+    text: string;
+    args: string[];
+    timestamp: number;
+    stackTrace?: StackFrame[];
+}
+export interface ExceptionDetail {
+    text: string;
+    description: string;
+    lineNumber?: number;
+    columnNumber?: number;
+    url?: string;
+    stackTrace: StackFrame[];
+    timestamp: number;
+}
+export interface StackFrame {
+    functionName: string;
+    url: string;
+    lineNumber: number;
+    columnNumber: number;
+}
+export interface NetworkRequest {
+    requestId: string;
+    url: string;
+    method: string;
+    timestamp: number;
+    status?: number;
+    statusText?: string;
+    responseHeaders?: Record<string, string>;
+    failed?: boolean;
+    failureReason?: string;
+    type: string;
+}
+export interface NetworkFailure {
+    requestId: string;
+    url: string;
+    method: string;
+    errorText: string;
+    timestamp: number;
+}
+export interface MetricsSnapshot {
+    label: string;
+    timestamp: number;
+    metrics: Record<string, number>;
+}
+export interface TimelineEntry {
+    type: 'console' | 'exception' | 'network-request' | 'network-response' | 'network-failure' | 'dom-mutation' | 'metrics';
+    timestamp: number;
+    data: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/ai/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/ai/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,UAAU,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,iBAAiB,GAAG,cAAc,GAAG,SAAS,CAAC;IACxH,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf"}

package/dist/src/ai/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Types for diagnostic data exposed to consumers (AI bridge, UI, CLI).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/src/ai/types.js.map

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

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

@@ -0,0 +1,37 @@
+/**
+ * CDP WebSocket connection management.
+ * Handles command/response pattern and event subscriptions.
+ */
+import WebSocket from 'ws';
+export interface CDPResponse {
+    id: number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: string;
+    };
+}
+export interface CDPEvent {
+    method: string;
+    params?: Record<string, unknown>;
+    sessionId?: string;
+}
+type EventHandler = (params: Record<string, unknown>) => void;
+export declare class CDPConnection {
+    private ws;
+    private commandId;
+    private callbacks;
+    private eventHandlers;
+    constructor(ws: WebSocket);
+    static connect(wsUrl: string): Promise<CDPConnection>;
+    send(method: string, params?: Record<string, unknown>, sessionId?: string): Promise<unknown>;
+    on(event: string, handler: EventHandler): void;
+    off(event: string, handler: EventHandler): void;
+    close(): void;
+    /** Reject all pending command callbacks — called when the connection drops unexpectedly. */
+    private rejectPendingCallbacks;
+    private handleMessage;
+}
+export {};
+//# sourceMappingURL=connection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/cdp/connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,KAAK,YAAY,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAE9D,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAA6F;IAC9G,OAAO,CAAC,aAAa,CAAwC;gBAEjD,EAAE,EAAE,SAAS;WAOZ,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IASrD,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAWlG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAM9C,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAI/C,KAAK,IAAI,IAAI;IAIb,4FAA4F;IAC5F,OAAO,CAAC,sBAAsB;IAQ9B,OAAO,CAAC,aAAa;CAyBtB"}

package/dist/src/cdp/connection.js

@@ -0,0 +1,86 @@
+"use strict";
+/**
+ * CDP WebSocket connection management.
+ * Handles command/response pattern and event subscriptions.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CDPConnection = void 0;
+const ws_1 = __importDefault(require("ws"));
+class CDPConnection {
+    ws;
+    commandId = 0;
+    callbacks = new Map();
+    eventHandlers = new Map();
+    constructor(ws) {
+        this.ws = ws;
+        this.ws.on('message', (data) => this.handleMessage(data.toString()));
+        this.ws.on('close', () => this.rejectPendingCallbacks('WebSocket connection closed'));
+        this.ws.on('error', () => this.rejectPendingCallbacks('WebSocket connection error'));
+    }
+    static async connect(wsUrl) {
+        const ws = new ws_1.default(wsUrl);
+        await new Promise((resolve, reject) => {
+            ws.on('open', resolve);
+            ws.on('error', reject);
+        });
+        return new CDPConnection(ws);
+    }
+    async send(method, params, sessionId) {
+        const id = ++this.commandId;
+        const message = { id, method, params };
+        if (sessionId)
+            message.sessionId = sessionId;
+        return new Promise((resolve, reject) => {
+            this.callbacks.set(id, { resolve, reject });
+            this.ws.send(JSON.stringify(message));
+        });
+    }
+    on(event, handler) {
+        const handlers = this.eventHandlers.get(event) ?? new Set();
+        handlers.add(handler);
+        this.eventHandlers.set(event, handlers);
+    }
+    off(event, handler) {
+        this.eventHandlers.get(event)?.delete(handler);
+    }
+    close() {
+        this.ws.close();
+    }
+    /** Reject all pending command callbacks — called when the connection drops unexpectedly. */
+    rejectPendingCallbacks(reason) {
+        const error = new Error(`CDP: ${reason}`);
+        for (const [, callback] of this.callbacks) {
+            callback.reject(error);
+        }
+        this.callbacks.clear();
+    }
+    handleMessage(raw) {
+        const message = JSON.parse(raw);
+        if ('id' in message) {
+            const callback = this.callbacks.get(message.id);
+            if (!callback)
+                return;
+            this.callbacks.delete(message.id);
+            if (message.error) {
+                callback.reject(new Error(`CDP Error: ${message.error.message} (${message.error.code})`));
+            }
+            else {
+                callback.resolve(message.result);
+            }
+            return;
+        }
+        if ('method' in message) {
+            const handlers = this.eventHandlers.get(message.method);
+            if (handlers) {
+                for (const handler of handlers) {
+                    handler(message.params ?? {});
+                }
+            }
+        }
+    }
+}
+exports.CDPConnection = CDPConnection;
+//# sourceMappingURL=connection.js.map

package/dist/src/cdp/connection.js.map

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

package/dist/src/cdp/connection.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Unit tests for CDPConnection.
+ * Tests command/response routing, event handling, and error propagation.
+ */
+export {};
+//# sourceMappingURL=connection.test.d.ts.map

package/dist/src/cdp/connection.test.d.ts.map

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

package/dist/src/cdp/connection.test.js

@@ -0,0 +1,93 @@
+"use strict";
+/**
+ * Unit tests for CDPConnection.
+ * Tests command/response routing, event handling, and error propagation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const events_1 = require("events");
+// Mock WebSocket
+class MockWebSocket extends events_1.EventEmitter {
+    readyState = 1;
+    sent = [];
+    send(data) {
+        this.sent.push(data);
+    }
+    close() {
+        this.readyState = 3;
+        this.emit('close');
+    }
+}
+// We need to import after mocking — use dynamic import
+(0, vitest_1.describe)('CDPConnection', () => {
+    let mockWs;
+    (0, vitest_1.beforeEach)(() => {
+        mockWs = new MockWebSocket();
+    });
+    (0, vitest_1.it)('sends commands with incrementing IDs', async () => {
+        const { CDPConnection } = await import('./connection.js');
+        const conn = new CDPConnection(mockWs);
+        // Don't await — these will hang since no response comes back
+        conn.send('Page.enable');
+        conn.send('Runtime.enable');
+        (0, vitest_1.expect)(mockWs.sent).toHaveLength(2);
+        const msg1 = JSON.parse(mockWs.sent[0]);
+        const msg2 = JSON.parse(mockWs.sent[1]);
+        (0, vitest_1.expect)(msg1.id).toBe(1);
+        (0, vitest_1.expect)(msg1.method).toBe('Page.enable');
+        (0, vitest_1.expect)(msg2.id).toBe(2);
+        (0, vitest_1.expect)(msg2.method).toBe('Runtime.enable');
+    });
+    (0, vitest_1.it)('resolves commands when response arrives', async () => {
+        const { CDPConnection } = await import('./connection.js');
+        const conn = new CDPConnection(mockWs);
+        const promise = conn.send('Page.navigate', { url: 'http://test.com' });
+        // Simulate CDP response
+        mockWs.emit('message', JSON.stringify({ id: 1, result: { frameId: 'abc' } }));
+        const result = await promise;
+        (0, vitest_1.expect)(result).toEqual({ frameId: 'abc' });
+    });
+    (0, vitest_1.it)('rejects commands on CDP error response', async () => {
+        const { CDPConnection } = await import('./connection.js');
+        const conn = new CDPConnection(mockWs);
+        const promise = conn.send('Page.navigate', { url: 'invalid' });
+        mockWs.emit('message', JSON.stringify({
+            id: 1,
+            error: { code: -32601, message: 'Method not found' },
+        }));
+        await (0, vitest_1.expect)(promise).rejects.toThrow('CDP Error: Method not found (-32601)');
+    });
+    (0, vitest_1.it)('dispatches events to registered handlers', async () => {
+        const { CDPConnection } = await import('./connection.js');
+        const conn = new CDPConnection(mockWs);
+        const handler = vitest_1.vi.fn();
+        conn.on('Page.loadEventFired', handler);
+        mockWs.emit('message', JSON.stringify({
+            method: 'Page.loadEventFired',
+            params: { timestamp: 12345 },
+        }));
+        (0, vitest_1.expect)(handler).toHaveBeenCalledWith({ timestamp: 12345 });
+    });
+    (0, vitest_1.it)('removes event handlers with off()', async () => {
+        const { CDPConnection } = await import('./connection.js');
+        const conn = new CDPConnection(mockWs);
+        const handler = vitest_1.vi.fn();
+        conn.on('Runtime.consoleAPICalled', handler);
+        conn.off('Runtime.consoleAPICalled', handler);
+        mockWs.emit('message', JSON.stringify({
+            method: 'Runtime.consoleAPICalled',
+            params: {},
+        }));
+        (0, vitest_1.expect)(handler).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)('rejects all pending callbacks on WebSocket close', async () => {
+        const { CDPConnection } = await import('./connection.js');
+        const conn = new CDPConnection(mockWs);
+        const p1 = conn.send('Page.enable');
+        const p2 = conn.send('Runtime.enable');
+        mockWs.emit('close');
+        await (0, vitest_1.expect)(p1).rejects.toThrow('WebSocket connection closed');
+        await (0, vitest_1.expect)(p2).rejects.toThrow('WebSocket connection closed');
+    });
+});
+//# sourceMappingURL=connection.test.js.map

package/dist/src/cdp/connection.test.js.map

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

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

@@ -0,0 +1,116 @@
+/**
+ * Typed CDP domain helpers.
+ * Thin wrappers around CDPConnection.send() for type safety.
+ */
+import type { CDPConnection } from './connection.js';
+export declare class PageDomain {
+    private connection;
+    private sessionId?;
+    constructor(connection: CDPConnection, sessionId?: string | undefined);
+    enable(): Promise<void>;
+    navigate(url: string): Promise<{
+        frameId: string;
+        loaderId?: string;
+    }>;
+    reload(): Promise<void>;
+    captureScreenshot(options?: {
+        format?: 'jpeg' | 'png' | 'webp';
+        quality?: number;
+        clip?: unknown;
+    }): Promise<{
+        data: string;
+    }>;
+}
+export declare class RuntimeDomain {
+    private connection;
+    private sessionId?;
+    constructor(connection: CDPConnection, sessionId?: string | undefined);
+    enable(): Promise<void>;
+    evaluate(expression: string, options?: {
+        awaitPromise?: boolean;
+        returnByValue?: boolean;
+    }): Promise<{
+        result: {
+            type: string;
+            value?: unknown;
+            description?: string;
+        };
+    }>;
+}
+export declare class NetworkDomain {
+    private connection;
+    private sessionId?;
+    constructor(connection: CDPConnection, sessionId?: string | undefined);
+    enable(): Promise<void>;
+    clearBrowserCookies(): Promise<void>;
+    getCookies(): Promise<{
+        cookies: unknown[];
+    }>;
+}
+export declare class DOMDomain {
+    private connection;
+    private sessionId?;
+    constructor(connection: CDPConnection, sessionId?: string | undefined);
+    enable(): Promise<void>;
+    getDocument(): Promise<{
+        root: {
+            nodeId: number;
+        };
+    }>;
+    querySelector(nodeId: number, selector: string): Promise<{
+        nodeId: number;
+    }>;
+    getOuterHTML(nodeId: number): Promise<{
+        outerHTML: string;
+    }>;
+    setFileInputFiles(files: string[], nodeId: number): Promise<void>;
+}
+export declare class InputDomain {
+    private connection;
+    private sessionId?;
+    constructor(connection: CDPConnection, sessionId?: string | undefined);
+    dispatchKeyEvent(type: 'keyDown' | 'keyUp' | 'char' | 'rawKeyDown', options: {
+        key?: string;
+        text?: string;
+        code?: string;
+    }): Promise<void>;
+    dispatchMouseEvent(type: 'mousePressed' | 'mouseReleased' | 'mouseMoved', x: number, y: number, options?: {
+        button?: 'left' | 'right' | 'middle';
+        clickCount?: number;
+    }): Promise<void>;
+    insertText(text: string): Promise<void>;
+}
+export declare class TargetDomain {
+    private connection;
+    constructor(connection: CDPConnection);
+    createBrowserContext(): Promise<{
+        browserContextId: string;
+    }>;
+    disposeBrowserContext(browserContextId: string): Promise<void>;
+    createTarget(url: string, browserContextId?: string): Promise<{
+        targetId: string;
+    }>;
+    attachToTarget(targetId: string, flatten?: boolean): Promise<{
+        sessionId: string;
+    }>;
+    closeTarget(targetId: string): Promise<void>;
+}
+export declare class PerformanceDomain {
+    private connection;
+    private sessionId?;
+    constructor(connection: CDPConnection, sessionId?: string | undefined);
+    enable(): Promise<void>;
+    getMetrics(): Promise<{
+        metrics: Array<{
+            name: string;
+            value: number;
+        }>;
+    }>;
+}
+export declare class StorageDomain {
+    private connection;
+    private sessionId?;
+    constructor(connection: CDPConnection, sessionId?: string | undefined);
+    clearDataForOrigin(origin: string, storageTypes?: string): Promise<void>;
+}
+//# sourceMappingURL=domains.d.ts.map

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

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

package/dist/src/cdp/domains.js

@@ -0,0 +1,153 @@
+"use strict";
+/**
+ * Typed CDP domain helpers.
+ * Thin wrappers around CDPConnection.send() for type safety.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageDomain = exports.PerformanceDomain = exports.TargetDomain = exports.InputDomain = exports.DOMDomain = exports.NetworkDomain = exports.RuntimeDomain = exports.PageDomain = void 0;
+class PageDomain {
+    connection;
+    sessionId;
+    constructor(connection, sessionId) {
+        this.connection = connection;
+        this.sessionId = sessionId;
+    }
+    async enable() {
+        await this.connection.send('Page.enable', undefined, this.sessionId);
+    }
+    async navigate(url) {
+        return this.connection.send('Page.navigate', { url }, this.sessionId);
+    }
+    async reload() {
+        await this.connection.send('Page.reload', undefined, this.sessionId);
+    }
+    async captureScreenshot(options) {
+        return this.connection.send('Page.captureScreenshot', options, this.sessionId);
+    }
+}
+exports.PageDomain = PageDomain;
+class RuntimeDomain {
+    connection;
+    sessionId;
+    constructor(connection, sessionId) {
+        this.connection = connection;
+        this.sessionId = sessionId;
+    }
+    async enable() {
+        await this.connection.send('Runtime.enable', undefined, this.sessionId);
+    }
+    async evaluate(expression, options) {
+        return this.connection.send('Runtime.evaluate', { expression, ...options }, this.sessionId);
+    }
+}
+exports.RuntimeDomain = RuntimeDomain;
+class NetworkDomain {
+    connection;
+    sessionId;
+    constructor(connection, sessionId) {
+        this.connection = connection;
+        this.sessionId = sessionId;
+    }
+    async enable() {
+        await this.connection.send('Network.enable', undefined, this.sessionId);
+    }
+    async clearBrowserCookies() {
+        await this.connection.send('Network.clearBrowserCookies', undefined, this.sessionId);
+    }
+    async getCookies() {
+        return this.connection.send('Network.getCookies', undefined, this.sessionId);
+    }
+}
+exports.NetworkDomain = NetworkDomain;
+class DOMDomain {
+    connection;
+    sessionId;
+    constructor(connection, sessionId) {
+        this.connection = connection;
+        this.sessionId = sessionId;
+    }
+    async enable() {
+        await this.connection.send('DOM.enable', undefined, this.sessionId);
+    }
+    async getDocument() {
+        return this.connection.send('DOM.getDocument', undefined, this.sessionId);
+    }
+    async querySelector(nodeId, selector) {
+        return this.connection.send('DOM.querySelector', { nodeId, selector }, this.sessionId);
+    }
+    async getOuterHTML(nodeId) {
+        return this.connection.send('DOM.getOuterHTML', { nodeId }, this.sessionId);
+    }
+    async setFileInputFiles(files, nodeId) {
+        await this.connection.send('DOM.setFileInputFiles', { files, nodeId }, this.sessionId);
+    }
+}
+exports.DOMDomain = DOMDomain;
+class InputDomain {
+    connection;
+    sessionId;
+    constructor(connection, sessionId) {
+        this.connection = connection;
+        this.sessionId = sessionId;
+    }
+    async dispatchKeyEvent(type, options) {
+        await this.connection.send('Input.dispatchKeyEvent', { type, ...options }, this.sessionId);
+    }
+    async dispatchMouseEvent(type, x, y, options) {
+        await this.connection.send('Input.dispatchMouseEvent', { type, x, y, ...options }, this.sessionId);
+    }
+    async insertText(text) {
+        await this.connection.send('Input.insertText', { text }, this.sessionId);
+    }
+}
+exports.InputDomain = InputDomain;
+class TargetDomain {
+    connection;
+    constructor(connection) {
+        this.connection = connection;
+    }
+    async createBrowserContext() {
+        return this.connection.send('Target.createBrowserContext');
+    }
+    async disposeBrowserContext(browserContextId) {
+        await this.connection.send('Target.disposeBrowserContext', { browserContextId });
+    }
+    async createTarget(url, browserContextId) {
+        return this.connection.send('Target.createTarget', { url, browserContextId });
+    }
+    async attachToTarget(targetId, flatten = true) {
+        return this.connection.send('Target.attachToTarget', { targetId, flatten });
+    }
+    async closeTarget(targetId) {
+        await this.connection.send('Target.closeTarget', { targetId });
+    }
+}
+exports.TargetDomain = TargetDomain;
+class PerformanceDomain {
+    connection;
+    sessionId;
+    constructor(connection, sessionId) {
+        this.connection = connection;
+        this.sessionId = sessionId;
+    }
+    async enable() {
+        await this.connection.send('Performance.enable', undefined, this.sessionId);
+    }
+    async getMetrics() {
+        return this.connection.send('Performance.getMetrics', undefined, this.sessionId);
+    }
+}
+exports.PerformanceDomain = PerformanceDomain;
+class StorageDomain {
+    connection;
+    sessionId;
+    constructor(connection, sessionId) {
+        this.connection = connection;
+        this.sessionId = sessionId;
+    }
+    async clearDataForOrigin(origin, storageTypes = 'all') {
+        await this.connection.send('Storage.clearDataForOrigin', { origin, storageTypes }, this.sessionId);
+    }
+}
+exports.StorageDomain = StorageDomain;
+//# sourceMappingURL=domains.js.map

package/dist/src/cdp/domains.js.map

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

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

@@ -0,0 +1,26 @@
+/**
+ * Chrome process spawning and DevTools endpoint discovery.
+ */
+import { type ChildProcess } from 'child_process';
+export interface LaunchOptions {
+    browserPath: string;
+    port?: number;
+    /** Parent user data directory (e.g. .../Google/Chrome). */
+    userDataDir?: string;
+    /** Profile subdirectory name within userDataDir (e.g. "Default", "Profile 1"). */
+    profileDirectory?: string;
+    headless?: boolean;
+    devtools?: boolean;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    args?: string[];
+}
+export interface LaunchResult {
+    process: ChildProcess;
+    wsEndpoint: string;
+    port: number;
+}
+export declare function launchBrowser(options: LaunchOptions): Promise<LaunchResult>;
+//# sourceMappingURL=launcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../../src/cdp/launcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAMzD,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAuBD,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAwDjF"}