chrome-e2e-sdk 0.0.0-stage → 1.0.0

package/dist/errors/E2EError.d.ts

@@ -0,0 +1,50 @@
+export declare enum E2EErrorCode {
+    CONNECTION_ERROR = "CONNECTION_ERROR",
+    PAGE_NOT_FOUND = "PAGE_NOT_FOUND",
+    ELEMENT_NOT_FOUND = "ELEMENT_NOT_FOUND",
+    ELEMENT_NOT_INTERACTABLE = "ELEMENT_NOT_INTERACTABLE",
+    TIMEOUT = "TIMEOUT",
+    NETWORK_TIMEOUT = "NETWORK_TIMEOUT",
+    MCP_ERROR = "MCP_ERROR",
+    ASSERTION_ERROR = "ASSERTION_ERROR",
+    INVALID_ARGUMENT = "INVALID_ARGUMENT",
+    BROWSER_CLOSED = "BROWSER_CLOSED",
+    NAVIGATION_ERROR = "NAVIGATION_ERROR",
+    SCRIPT_ERROR = "SCRIPT_ERROR",
+    /** The MCP server rejected the call because its category flag is off. */
+    TOOL_DISABLED = "TOOL_DISABLED"
+}
+export declare class E2EError extends Error {
+    readonly code: E2EErrorCode;
+    readonly details?: Record<string, unknown>;
+    readonly cause?: Error;
+    constructor(code: E2EErrorCode, message: string, options?: {
+        details?: Record<string, unknown>;
+        cause?: Error;
+    });
+    static connectionError(message: string, cause?: Error): E2EError;
+    static pageNotFound(url?: string): E2EError;
+    static elementNotFound(selector: Selector, url?: string): E2EError;
+    static elementNotInteractable(selector: Selector, reason: string, url?: string): E2EError;
+    static timeout(operation: string, timeoutMs: number, details?: Record<string, unknown>): E2EError;
+    static networkTimeout(url: string, timeoutMs: number): E2EError;
+    static mcpError(message: string, cause?: Error, details?: Record<string, unknown>): E2EError;
+    static assertionError(message: string, details?: Record<string, unknown>): E2EError;
+    static invalidArgument(param: string, expected: string, received: unknown): E2EError;
+    static browserClosed(): E2EError;
+    static navigationError(url: string, cause?: Error): E2EError;
+    static scriptError(message: string, cause?: Error): E2EError;
+    static toolDisabled(toolName: string, reason: string, cause?: Error): E2EError;
+    toJSON(): Record<string, unknown>;
+}
+export interface Selector {
+    role?: string;
+    name?: string;
+    text?: string;
+    label?: string;
+    css?: string;
+    xpath?: string;
+    index?: number;
+    exact?: boolean;
+}
+//# sourceMappingURL=E2EError.d.ts.map

package/dist/errors/E2EError.d.ts.map

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

package/dist/errors/E2EError.js

@@ -0,0 +1,90 @@
+export var E2EErrorCode;
+(function (E2EErrorCode) {
+    E2EErrorCode["CONNECTION_ERROR"] = "CONNECTION_ERROR";
+    E2EErrorCode["PAGE_NOT_FOUND"] = "PAGE_NOT_FOUND";
+    E2EErrorCode["ELEMENT_NOT_FOUND"] = "ELEMENT_NOT_FOUND";
+    E2EErrorCode["ELEMENT_NOT_INTERACTABLE"] = "ELEMENT_NOT_INTERACTABLE";
+    E2EErrorCode["TIMEOUT"] = "TIMEOUT";
+    E2EErrorCode["NETWORK_TIMEOUT"] = "NETWORK_TIMEOUT";
+    E2EErrorCode["MCP_ERROR"] = "MCP_ERROR";
+    E2EErrorCode["ASSERTION_ERROR"] = "ASSERTION_ERROR";
+    E2EErrorCode["INVALID_ARGUMENT"] = "INVALID_ARGUMENT";
+    E2EErrorCode["BROWSER_CLOSED"] = "BROWSER_CLOSED";
+    E2EErrorCode["NAVIGATION_ERROR"] = "NAVIGATION_ERROR";
+    E2EErrorCode["SCRIPT_ERROR"] = "SCRIPT_ERROR";
+    /** The MCP server rejected the call because its category flag is off. */
+    E2EErrorCode["TOOL_DISABLED"] = "TOOL_DISABLED";
+})(E2EErrorCode || (E2EErrorCode = {}));
+export class E2EError extends Error {
+    code;
+    details;
+    cause;
+    constructor(code, message, options) {
+        super(message);
+        this.name = 'E2EError';
+        this.code = code;
+        this.details = options?.details;
+        this.cause = options?.cause;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, E2EError);
+        }
+    }
+    static connectionError(message, cause) {
+        return new E2EError(E2EErrorCode.CONNECTION_ERROR, message, { cause });
+    }
+    static pageNotFound(url) {
+        return new E2EError(E2EErrorCode.PAGE_NOT_FOUND, url ? `Page not found: ${url}` : 'Page not found', { details: { url } });
+    }
+    static elementNotFound(selector, url) {
+        const strategy = selector.role
+            ? `role=${selector.role}`
+            : selector.text
+                ? `text="${selector.text}"`
+                : selector.label
+                    ? `label="${selector.label}"`
+                    : selector.css
+                        ? `css="${selector.css}"`
+                        : 'unknown';
+        return new E2EError(E2EErrorCode.ELEMENT_NOT_FOUND, `Unable to find element. Strategy: ${strategy}`, { details: { selector, url, strategy } });
+    }
+    static elementNotInteractable(selector, reason, url) {
+        return new E2EError(E2EErrorCode.ELEMENT_NOT_INTERACTABLE, `Element not interactable: ${reason}`, { details: { selector, reason, url } });
+    }
+    static timeout(operation, timeoutMs, details) {
+        return new E2EError(E2EErrorCode.TIMEOUT, `${operation} timed out after ${timeoutMs}ms`, { details: { operation, timeoutMs, ...details } });
+    }
+    static networkTimeout(url, timeoutMs) {
+        return new E2EError(E2EErrorCode.NETWORK_TIMEOUT, `Network request to ${url} timed out after ${timeoutMs}ms`, { details: { url, timeoutMs } });
+    }
+    static mcpError(message, cause, details) {
+        return new E2EError(E2EErrorCode.MCP_ERROR, message, { cause, details });
+    }
+    static assertionError(message, details) {
+        return new E2EError(E2EErrorCode.ASSERTION_ERROR, message, { details });
+    }
+    static invalidArgument(param, expected, received) {
+        return new E2EError(E2EErrorCode.INVALID_ARGUMENT, `Invalid argument: ${param}. Expected ${expected}, received ${JSON.stringify(received)}`, { details: { param, expected, received } });
+    }
+    static browserClosed() {
+        return new E2EError(E2EErrorCode.BROWSER_CLOSED, 'Browser has been closed');
+    }
+    static navigationError(url, cause) {
+        return new E2EError(E2EErrorCode.NAVIGATION_ERROR, `Navigation to ${url} failed`, { details: { url }, cause });
+    }
+    static scriptError(message, cause) {
+        return new E2EError(E2EErrorCode.SCRIPT_ERROR, message, { cause });
+    }
+    static toolDisabled(toolName, reason, cause) {
+        return new E2EError(E2EErrorCode.TOOL_DISABLED, `Tool ${toolName} is disabled in the MCP server: ${reason}`, { details: { tool: toolName, reason }, cause });
+    }
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code,
+            message: this.message,
+            details: this.details,
+            stack: this.stack
+        };
+    }
+}
+//# sourceMappingURL=E2EError.js.map

package/dist/errors/E2EError.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { E2EError, E2EErrorCode, type Selector } from './errors/E2EError.js';
+import { MCPClient, type MCPClientOptions, type ToolResult, createMCPClient } from './client/MCPClient.js';
+import { type MCPCommandOptions, type ConnectionMode, buildMCPArgs } from './client/MCPCommand.js';
+import { Browser, type BrowserOptions, type PageInfo, connect } from './browser/Browser.js';
+import { Page, PageLocalStorage, type SnapshotResult, type ScreenshotOptions, type ResizeOptions, type StorageOperationOptions, type WaitOptions, type LoadState, type ConsoleMessage, type ConsoleMessageDetail, type EmulateOptions } from './browser/Page.js';
+import { Locator, type LocatorOptions } from './browser/Locator.js';
+import { Network, type NetworkRequest, type NetworkResponse, type WaitForResponseOptions, type ListNetworkOptions, type ResourceType } from './network/Network.js';
+import { expect, Expect, AssertionError, SoftAssertions, type ExpectOptions } from './assertion/Assertion.js';
+import { logger, getLogger, setDebugMode, isDebugMode, type Logger } from './logger.js';
+import { loadEnv, type LoadEnvOptions, type LoadEnvResult } from './env/loadEnv.js';
+export { E2EError, E2EErrorCode, type Selector, MCPClient, type MCPClientOptions, type ToolResult, createMCPClient, type MCPCommandOptions, type ConnectionMode, buildMCPArgs, Browser, type BrowserOptions, type PageInfo, connect, Page, PageLocalStorage, type SnapshotResult, type ScreenshotOptions, type ResizeOptions, type StorageOperationOptions, type WaitOptions, type LoadState, type ConsoleMessage, type ConsoleMessageDetail, type EmulateOptions, Locator, type LocatorOptions, Network, type NetworkRequest, type NetworkResponse, type WaitForResponseOptions, type ListNetworkOptions, type ResourceType, expect, Expect, AssertionError, SoftAssertions, type ExpectOptions, logger, getLogger, setDebugMode, isDebugMode, loadEnv, type LoadEnvOptions, type LoadEnvResult, type Logger };
+export { VERSION } from './version.js';
+declare const _default: {
+    Browser: typeof Browser;
+    Page: typeof Page;
+    Locator: typeof Locator;
+    Network: typeof Network;
+    expect: typeof expect;
+    E2EError: typeof E2EError;
+    E2EErrorCode: typeof E2EErrorCode;
+    MCPClient: typeof MCPClient;
+    connect: typeof connect;
+    createMCPClient: typeof createMCPClient;
+    loadEnv: typeof loadEnv;
+    logger: Logger;
+    getLogger: typeof getLogger;
+    setDebugMode: typeof setDebugMode;
+    isDebugMode: typeof isDebugMode;
+    VERSION: string;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAC5E,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,KAAK,UAAU,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC1G,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAClG,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,QAAQ,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC3F,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,KAAK,uBAAuB,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAChQ,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EAAE,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAClK,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAC7G,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,KAAK,MAAM,EAAE,MAAM,aAAa,CAAA;AACvF,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAGnF,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,KAAK,QAAQ,EACb,SAAS,EACT,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,YAAY,EACZ,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,QAAQ,EACb,OAAO,EACP,IAAI,EACJ,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,WAAW,EAChB,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,OAAO,EACP,KAAK,cAAc,EACnB,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,YAAY,EACjB,MAAM,EACN,MAAM,EACN,cAAc,EACd,cAAc,EACd,KAAK,aAAa,EAClB,MAAM,EACN,SAAS,EACT,YAAY,EACZ,WAAW,EACX,OAAO,EACP,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,MAAM,EACZ,CAAA;AAGD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;;;;;;;;;;;;;;;;;;;AAItC,wBAiBC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+// Chrome E2E SDK - Main Entry Point
+// Browser automation SDK based on chrome-devtools-mcp
+import { E2EError, E2EErrorCode } from './errors/E2EError.js';
+import { MCPClient, createMCPClient } from './client/MCPClient.js';
+import { buildMCPArgs } from './client/MCPCommand.js';
+import { Browser, connect } from './browser/Browser.js';
+import { Page, PageLocalStorage } from './browser/Page.js';
+import { Locator } from './browser/Locator.js';
+import { Network } from './network/Network.js';
+import { expect, Expect, AssertionError, SoftAssertions } from './assertion/Assertion.js';
+import { logger, getLogger, setDebugMode, isDebugMode } from './logger.js';
+import { loadEnv } from './env/loadEnv.js';
+// Re-export all
+export { E2EError, E2EErrorCode, MCPClient, createMCPClient, buildMCPArgs, Browser, connect, Page, PageLocalStorage, Locator, Network, expect, Expect, AssertionError, SoftAssertions, logger, getLogger, setDebugMode, isDebugMode, loadEnv };
+// Version, generated from package.json at build time
+export { VERSION } from './version.js';
+import { VERSION } from './version.js';
+// Default export for convenience
+export default {
+    Browser,
+    Page,
+    Locator,
+    Network,
+    expect,
+    E2EError,
+    E2EErrorCode,
+    MCPClient,
+    connect,
+    createMCPClient,
+    loadEnv,
+    logger,
+    getLogger,
+    setDebugMode,
+    isDebugMode,
+    VERSION
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,sDAAsD;AAEtD,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAiB,MAAM,sBAAsB,CAAA;AAC5E,OAAO,EAAE,SAAS,EAA0C,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC1G,OAAO,EAA+C,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAClG,OAAO,EAAE,OAAO,EAAsC,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC3F,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAwM,MAAM,mBAAmB,CAAA;AAChQ,OAAO,EAAE,OAAO,EAAuB,MAAM,sBAAsB,CAAA;AACnE,OAAO,EAAE,OAAO,EAAsH,MAAM,sBAAsB,CAAA;AAClK,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAAsB,MAAM,0BAA0B,CAAA;AAC7G,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAe,MAAM,aAAa,CAAA;AACvF,OAAO,EAAE,OAAO,EAA2C,MAAM,kBAAkB,CAAA;AAEnF,gBAAgB;AAChB,OAAO,EACL,QAAQ,EACR,YAAY,EAEZ,SAAS,EAGT,eAAe,EAGf,YAAY,EACZ,OAAO,EAGP,OAAO,EACP,IAAI,EACJ,gBAAgB,EAUhB,OAAO,EAEP,OAAO,EAMP,MAAM,EACN,MAAM,EACN,cAAc,EACd,cAAc,EAEd,MAAM,EACN,SAAS,EACT,YAAY,EACZ,WAAW,EACX,OAAO,EAIR,CAAA;AAED,qDAAqD;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,iCAAiC;AACjC,eAAe;IACb,OAAO;IACP,IAAI;IACJ,OAAO;IACP,OAAO;IACP,MAAM;IACN,QAAQ;IACR,YAAY;IACZ,SAAS;IACT,OAAO;IACP,eAAe;IACf,OAAO;IACP,MAAM;IACN,SAAS;IACT,YAAY;IACZ,WAAW;IACX,OAAO;CACR,CAAA"}

package/dist/logger.d.ts

@@ -0,0 +1,12 @@
+interface Logger {
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+export declare const logger: Logger;
+export declare function getLogger(name: string): Logger;
+export declare function setDebugMode(enabled: boolean): void;
+export declare function isDebugMode(): boolean;
+export type { Logger };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAIA,UAAU,MAAM;IACd,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD;AAuCD,eAAO,MAAM,MAAM,QAAsB,CAAA;AAGzC,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9C;AAGD,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAWnD;AAGD,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED,YAAY,EAAE,MAAM,EAAE,CAAA"}

package/dist/logger.js

@@ -0,0 +1,57 @@
+// Logging utility for Chrome E2E SDK
+const RESET_COLOR = '\x1b[0m';
+const LOG_LEVEL_COLORS = {
+    debug: '\x1b[90m',
+    info: '\x1b[32m',
+    warn: '\x1b[33m',
+    error: '\x1b[31m'
+};
+function createLogger(prefix) {
+    const isDebug = process.env['DEBUG']?.includes('chrome-e2e') === true;
+    const formatMessage = (level, message) => {
+        const timestamp = new Date().toISOString();
+        const coloredLevel = `${LOG_LEVEL_COLORS[level]}${level.toUpperCase()}${RESET_COLOR}`;
+        return `[ChromeE2E:${prefix}] ${timestamp} ${coloredLevel}: ${message}`;
+    };
+    return {
+        debug(message, ...args) {
+            if (isDebug) {
+                console.debug(formatMessage('debug', message), ...args);
+            }
+        },
+        info(message, ...args) {
+            console.info(formatMessage('info', message), ...args);
+        },
+        warn(message, ...args) {
+            console.warn(formatMessage('warn', message), ...args);
+        },
+        error(message, ...args) {
+            console.error(formatMessage('error', message), ...args);
+        }
+    };
+}
+// Default logger
+export const logger = createLogger('SDK');
+// Create named logger
+export function getLogger(name) {
+    return createLogger(name);
+}
+// Set debug mode programmatically
+export function setDebugMode(enabled) {
+    if (enabled) {
+        process.env['DEBUG'] = (process.env['DEBUG'] ? process.env['DEBUG'] + ',' : '') + 'chrome-e2e';
+    }
+    else {
+        if (process.env['DEBUG']) {
+            process.env['DEBUG'] = process.env['DEBUG']
+                .split(',')
+                .filter((d) => d !== 'chrome-e2e')
+                .join(',');
+        }
+    }
+}
+// Check if debug mode is enabled
+export function isDebugMode() {
+    return process.env['DEBUG']?.includes('chrome-e2e') === true;
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAWrC,MAAM,WAAW,GAAG,SAAS,CAAA;AAE7B,MAAM,gBAAgB,GAA6B;IACjD,KAAK,EAAE,UAAU;IACjB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;CAClB,CAAA;AAED,SAAS,YAAY,CAAC,MAAc;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,IAAI,CAAA;IAErE,MAAM,aAAa,GAAG,CAAC,KAAe,EAAE,OAAe,EAAU,EAAE;QACjE,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC1C,MAAM,YAAY,GAAG,GAAG,gBAAgB,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,GAAG,WAAW,EAAE,CAAA;QACrF,OAAO,cAAc,MAAM,KAAK,SAAS,IAAI,YAAY,KAAK,OAAO,EAAE,CAAA;IACzE,CAAC,CAAA;IAED,OAAO;QACL,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;YACvC,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;YACzD,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;YACtC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;QACvD,CAAC;QACD,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;YACtC,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;QACvD,CAAC;QACD,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;YACvC,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,CAAA;QACzD,CAAC;KACF,CAAA;AACH,CAAC;AAED,iBAAiB;AACjB,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;AAEzC,sBAAsB;AACtB,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,YAAY,CAAC,IAAI,CAAC,CAAA;AAC3B,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,YAAY,CAAA;IAChG,CAAC;SAAM,CAAC;QACN,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;iBACxC,KAAK,CAAC,GAAG,CAAC;iBACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,YAAY,CAAC;iBACjC,IAAI,CAAC,GAAG,CAAC,CAAA;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,YAAY,CAAC,KAAK,IAAI,CAAA;AAC9D,CAAC"}

package/dist/network/Network.d.ts

@@ -0,0 +1,72 @@
+import { MCPClient } from '../client/MCPClient.js';
+export type ResourceType = 'Document' | 'Stylesheet' | 'Image' | 'Media' | 'Font' | 'Script' | 'TextTrack' | 'XHR' | 'Fetch' | 'EventSource' | 'WebSocket' | 'Manifest' | 'Other';
+export interface NetworkRequest {
+    requestId: string;
+    url: string;
+    method: string;
+    resourceType: ResourceType;
+    requestHeaders: Record<string, string>;
+    requestBody?: string;
+    requestBodyFilePath?: string;
+    responseHeaders?: Record<string, string>;
+    responseBody?: string;
+    responseBodyFilePath?: string;
+    /** Set when the request failed, e.g. `net::ERR_CONNECTION_REFUSED`. */
+    failure?: string;
+    redirectChain?: NetworkRequest[];
+    /** Populated only for requests that are still in flight. */
+    pending?: boolean;
+    timestamp: number;
+    response?: NetworkResponse;
+}
+export interface NetworkResponse {
+    status: number;
+    statusText: string;
+    headers: Record<string, string>;
+    body?: string;
+    mimeType: string;
+    fromCache: boolean;
+    timestamp: number;
+}
+export interface WaitForResponseOptions {
+    url: string | RegExp | ((request: NetworkRequest) => boolean);
+    timeout?: number;
+    resourceTypes?: ResourceType[];
+}
+export interface ListNetworkOptions {
+    resourceTypes?: ResourceType[];
+    since?: number;
+}
+export declare class Network {
+    private mcpClient;
+    private pageId;
+    private defaultTimeout;
+    private readonly logger;
+    constructor(mcpClient: MCPClient, pageId: number, defaultTimeout: number);
+    private createLogger;
+    list(options?: ListNetworkOptions): Promise<NetworkRequest[]>;
+    /**
+     * Fetch a single request with full headers and bodies.
+     * Returns `null` only when the request is unknown; transport failures propagate.
+     */
+    get(requestId: string | number): Promise<NetworkRequest | null>;
+    private isUnknownRequestError;
+    waitForResponse(options: WaitForResponseOptions): Promise<NetworkResponse>;
+    waitForRequest(options: WaitForResponseOptions): Promise<NetworkRequest>;
+    private waitForRequestResponse;
+    private matches;
+    private describeMatcher;
+    getDefaultTimeout(): number;
+    setDefaultTimeout(timeout: number): void;
+    private sleep;
+    private matchesResourceTypes;
+    private fromMCPConciseRequest;
+    private fromMCPDetailedRequest;
+    /**
+     * `chrome-devtools-mcp` reports status as a string that is either a numeric
+     * HTTP status, the literal `pending`, or a network failure error text.
+     */
+    private parseStatus;
+    private buildResponse;
+}
+//# sourceMappingURL=Network.d.ts.map

package/dist/network/Network.d.ts.map

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

package/dist/network/Network.js

@@ -0,0 +1,236 @@
+import { MCPClient } from '../client/MCPClient.js';
+import { E2EError, E2EErrorCode } from '../errors/E2EError.js';
+/**
+ * Since chrome-devtools-mcp 1.9.0 concise network output caps URLs at 255
+ * characters and appends this marker, so a long request URL is only ever a
+ * prefix. Matching has to account for that or long URLs never match.
+ */
+const TRUNCATION = /\.\.\. <truncated>$/;
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export class Network {
+    mcpClient;
+    pageId;
+    defaultTimeout;
+    logger;
+    constructor(mcpClient, pageId, defaultTimeout) {
+        this.mcpClient = mcpClient;
+        this.pageId = pageId;
+        this.defaultTimeout = defaultTimeout;
+        this.logger = this.createLogger();
+    }
+    createLogger() {
+        return (level, message) => {
+            if (process.env['DEBUG']?.includes('chrome-e2e')) {
+                console.error(`[ChromeE2E:Network:${this.pageId}] ${level.toUpperCase()}: ${message}`);
+            }
+        };
+    }
+    async list(options = {}) {
+        this.logger('debug', `Listing network requests${options.resourceTypes ? ` (types: ${options.resourceTypes.join(', ')})` : ''}`);
+        const result = await this.mcpClient.call('list_network_requests', {
+            pageId: this.pageId,
+            resourceTypes: options.resourceTypes?.map((type) => type.toLowerCase())
+        });
+        if (!Array.isArray(result.networkRequests)) {
+            return [];
+        }
+        return result.networkRequests
+            .map((request) => this.fromMCPConciseRequest(request, options.resourceTypes?.[0] ?? 'Other'))
+            .filter((request) => this.matchesResourceTypes(request, options.resourceTypes))
+            .filter((request) => !options.since || request.timestamp >= options.since);
+    }
+    /**
+     * Fetch a single request with full headers and bodies.
+     * Returns `null` only when the request is unknown; transport failures propagate.
+     */
+    async get(requestId) {
+        this.logger('debug', `Getting network request: ${requestId}`);
+        let result;
+        try {
+            result = await this.mcpClient.call('get_network_request', {
+                pageId: this.pageId,
+                reqid: Number(requestId)
+            });
+        }
+        catch (error) {
+            if (this.isUnknownRequestError(error)) {
+                return null;
+            }
+            throw error;
+        }
+        return result.networkRequest ? this.fromMCPDetailedRequest(result.networkRequest) : null;
+    }
+    isUnknownRequestError(error) {
+        if (!(error instanceof Error)) {
+            return false;
+        }
+        return /no network request|not found|invalid reqid/i.test(error.message);
+    }
+    async waitForResponse(options) {
+        const timeout = options.timeout ?? this.defaultTimeout;
+        const startTime = Date.now();
+        const pollInterval = 100;
+        this.logger('debug', `Waiting for response matching: ${this.describeMatcher(options.url)}`);
+        while (Date.now() - startTime < timeout) {
+            const requests = await this.list({ resourceTypes: options.resourceTypes });
+            for (const request of requests) {
+                if (this.matches(request, options.url)) {
+                    if (request.response) {
+                        this.logger('debug', `Found matching response: ${request.url}`);
+                        return request.response;
+                    }
+                    // Request found but no response yet, wait for it
+                    const response = await this.waitForRequestResponse(request.requestId, timeout - (Date.now() - startTime));
+                    if (response) {
+                        return response;
+                    }
+                }
+            }
+            await this.sleep(pollInterval);
+        }
+        throw E2EError.networkTimeout(this.describeMatcher(options.url), timeout);
+    }
+    async waitForRequest(options) {
+        const timeout = options.timeout ?? this.defaultTimeout;
+        const startTime = Date.now();
+        const pollInterval = 100;
+        this.logger('debug', `Waiting for request matching: ${this.describeMatcher(options.url)}`);
+        while (Date.now() - startTime < timeout) {
+            const requests = await this.list({ resourceTypes: options.resourceTypes });
+            for (const request of requests) {
+                if (this.matches(request, options.url)) {
+                    this.logger('debug', `Found matching request: ${request.url}`);
+                    return request;
+                }
+            }
+            await this.sleep(pollInterval);
+        }
+        throw E2EError.networkTimeout(this.describeMatcher(options.url), timeout);
+    }
+    async waitForRequestResponse(requestId, remainingTimeout) {
+        const startTime = Date.now();
+        const pollInterval = 50;
+        while (Date.now() - startTime < remainingTimeout) {
+            const request = await this.get(requestId);
+            if (request?.response) {
+                return request.response;
+            }
+            await this.sleep(pollInterval);
+        }
+        return null;
+    }
+    matches(request, matcher) {
+        if (typeof matcher === 'function') {
+            return matcher(request);
+        }
+        const truncated = TRUNCATION.test(request.url);
+        const url = truncated ? request.url.replace(TRUNCATION, '') : request.url;
+        if (matcher instanceof RegExp) {
+            return matcher.test(url);
+        }
+        if (matcher.includes('*')) {
+            const regex = new RegExp('^' + escapeRegExp(matcher).replace(/\\\*/g, '.*') + '$');
+            // An end-anchored pattern cannot be satisfied by a truncated URL, so
+            // fall back to a prefix match rather than silently missing.
+            return truncated ? regex.test(url) || new RegExp(escapeRegExp(url) + '.*$').test(matcher) : regex.test(url);
+        }
+        if (truncated) {
+            // Only the visible prefix is available: the matcher either appears in it
+            // or the visible prefix is the start of the matcher.
+            return url.includes(matcher) || matcher.startsWith(url);
+        }
+        return url.includes(matcher);
+    }
+    describeMatcher(matcher) {
+        if (typeof matcher === 'function')
+            return 'function';
+        if (matcher instanceof RegExp)
+            return matcher.toString();
+        return matcher;
+    }
+    getDefaultTimeout() {
+        return this.defaultTimeout;
+    }
+    setDefaultTimeout(timeout) {
+        this.defaultTimeout = timeout;
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    matchesResourceTypes(request, resourceTypes) {
+        return !resourceTypes || resourceTypes.length === 0 || resourceTypes.includes(request.resourceType);
+    }
+    fromMCPConciseRequest(request, resourceType) {
+        const timestamp = Date.now();
+        const parsedStatus = this.parseStatus(request.status);
+        const response = parsedStatus.kind === 'http'
+            ? this.buildResponse(parsedStatus.status, {}, undefined, timestamp)
+            : undefined;
+        return {
+            requestId: String(request.requestId),
+            url: request.url,
+            method: request.method,
+            resourceType,
+            requestHeaders: {},
+            ...(parsedStatus.kind === 'failure' ? { failure: parsedStatus.failure } : {}),
+            ...(parsedStatus.kind === 'pending' ? { pending: true } : {}),
+            timestamp,
+            response
+        };
+    }
+    fromMCPDetailedRequest(request) {
+        const timestamp = Date.now();
+        const parsedStatus = this.parseStatus(request.status);
+        const responseHeaders = request.responseHeaders;
+        const response = parsedStatus.kind === 'http'
+            ? this.buildResponse(parsedStatus.status, responseHeaders ?? {}, request.responseBody, timestamp)
+            : undefined;
+        return {
+            requestId: String(request.requestId),
+            url: request.url,
+            method: request.method,
+            resourceType: 'Other',
+            requestHeaders: request.requestHeaders ?? {},
+            requestBody: request.requestBody,
+            requestBodyFilePath: request.requestBodyFilePath,
+            responseHeaders,
+            responseBody: request.responseBody,
+            responseBodyFilePath: request.responseBodyFilePath,
+            ...(request.failure ? { failure: request.failure } : {}),
+            ...(parsedStatus.kind === 'pending' ? { pending: true } : {}),
+            ...(request.redirectChain
+                ? { redirectChain: request.redirectChain.map((hop) => this.fromMCPConciseRequest(hop, 'Other')) }
+                : {}),
+            timestamp,
+            response
+        };
+    }
+    /**
+     * `chrome-devtools-mcp` reports status as a string that is either a numeric
+     * HTTP status, the literal `pending`, or a network failure error text.
+     */
+    parseStatus(status) {
+        if (status === undefined || status === 'pending') {
+            return { kind: 'pending' };
+        }
+        const numericStatus = typeof status === 'number' ? status : Number(status);
+        if (Number.isFinite(numericStatus)) {
+            return { kind: 'http', status: numericStatus };
+        }
+        return { kind: 'failure', failure: String(status) };
+    }
+    buildResponse(status, headers, body, timestamp) {
+        return {
+            status,
+            statusText: '',
+            headers,
+            body,
+            mimeType: headers['content-type'] ?? headers['Content-Type'] ?? '',
+            fromCache: false,
+            timestamp
+        };
+    }
+}
+//# sourceMappingURL=Network.js.map