chrome-e2e-sdk 0.0.0-stage → 1.0.0

package/dist/assertion/recorder.js

@@ -0,0 +1,37 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+const storage = new AsyncLocalStorage();
+/**
+ * Records a passing assertion, if a test is currently collecting.
+ *
+ * A no-op outside a collected run, so `expect()` stays usable on its own -
+ * from a script, or from a test written against a different runner.
+ */
+export function recordCheck(check) {
+    storage.getStore()?.push(check);
+}
+/**
+ * Runs `fn` with a fresh list and returns what it recorded, plus whatever it
+ * threw.
+ *
+ * The error is returned rather than propagated because a test that fails on its
+ * tenth assertion still made nine passes worth showing, and losing them would
+ * hide exactly the context the report exists to give. A caller that only wants
+ * the checks can ignore it.
+ *
+ * AsyncLocalStorage rather than a module-level variable: the list has to
+ * survive every `await` inside the test body while staying invisible to a
+ * second test running concurrently, and nothing about the public assertion API
+ * should have to change to carry it.
+ */
+export async function collectChecks(fn) {
+    const checks = [];
+    let error;
+    try {
+        await storage.run(checks, fn);
+    }
+    catch (caught) {
+        error = caught;
+    }
+    return { error, checks };
+}
+//# sourceMappingURL=recorder.js.map

package/dist/assertion/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../src/assertion/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AAkBpD,MAAM,OAAO,GAAG,IAAI,iBAAiB,EAAmB,CAAA;AAExD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAoB;IAC9C,OAAO,CAAC,QAAQ,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;AACjC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAuB;IAEvB,MAAM,MAAM,GAAoB,EAAE,CAAA;IAClC,IAAI,KAAc,CAAA;IAElB,IAAI,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAC/B,CAAC;IAAC,OAAO,MAAM,EAAE,CAAC;QAChB,KAAK,GAAG,MAAM,CAAA;IAChB,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAA;AAC1B,CAAC"}

package/dist/browser/Browser.d.ts

@@ -0,0 +1,44 @@
+import { MCPClient, type MCPClientOptions } from '../client/MCPClient.js';
+import { Page } from './Page.js';
+export interface PageInfo {
+    id: number;
+    url: string;
+    title: string;
+    isActive: boolean;
+}
+export interface BrowserOptions extends MCPClientOptions {
+    timeout?: number;
+    defaultTimeout?: number;
+}
+export declare class Browser {
+    private mcpClient;
+    private pagesMap;
+    private defaultTimeout;
+    private closed;
+    private readonly logger;
+    private constructor();
+    private createLogger;
+    static connect(options?: BrowserOptions): Promise<Browser>;
+    pages(): Promise<Page[]>;
+    currentPage(): Promise<Page>;
+    newPage(url?: string): Promise<Page>;
+    selectPage(pageId: number): Promise<Page>;
+    close(): Promise<void>;
+    getDefaultTimeout(): number;
+    /**
+     * Updates the default timeout for this browser and every page already handed
+     * out, so locators and network waits created earlier pick up the new value.
+     */
+    setDefaultTimeout(timeout: number): void;
+    isClosed(): boolean;
+    getMCPClient(): MCPClient;
+    /**
+     * Reloads the page list, reusing existing `Page` instances so previously
+     * obtained locators keep pointing at a live page object.
+     */
+    private refreshPages;
+    private parsePages;
+    private ensureNotClosed;
+}
+export declare function connect(options?: BrowserOptions): Promise<Browser>;
+//# sourceMappingURL=Browser.d.ts.map

package/dist/browser/Browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Browser.d.ts","sourceRoot":"","sources":["../../src/browser/Browser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,MAAM,WAAW,cAAe,SAAQ,gBAAgB;IACtD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IAEjE,OAAO;IAMP,OAAO,CAAC,YAAY;WAQP,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB9D,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;IAMxB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAW5B,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BpC,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB5B,iBAAiB,IAAI,MAAM;IAI3B;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAWxC,QAAQ,IAAI,OAAO;IAInB,YAAY,IAAI,SAAS;IAIzB;;;OAGG;YACW,YAAY;IAmB1B,OAAO,CAAC,UAAU;IAgClB,OAAO,CAAC,eAAe;CAKxB;AAcD,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAE5E"}

package/dist/browser/Browser.js

@@ -0,0 +1,167 @@
+import { MCPClient } from '../client/MCPClient.js';
+import { DEFAULT_TIMEOUT_MS } from '../client/MCPCommand.js';
+import { Page } from './Page.js';
+import { E2EError, E2EErrorCode } from '../errors/E2EError.js';
+export class Browser {
+    mcpClient;
+    pagesMap = new Map();
+    defaultTimeout;
+    closed = false;
+    logger;
+    constructor(mcpClient, defaultTimeout) {
+        this.mcpClient = mcpClient;
+        this.defaultTimeout = defaultTimeout;
+        this.logger = this.createLogger();
+    }
+    createLogger() {
+        return (level, message) => {
+            if (process.env['DEBUG']?.includes('chrome-e2e')) {
+                console.error(`[ChromeE2E:Browser] ${level.toUpperCase()}: ${message}`);
+            }
+        };
+    }
+    static async connect(options = {}) {
+        const defaultTimeout = options.defaultTimeout ?? options.timeout ?? DEFAULT_TIMEOUT_MS;
+        // Extract MCPClient options (exclude SDK timeout aliases)
+        const { defaultTimeout: _, timeout: __, ...mcpOptions } = options;
+        const mcpClient = new MCPClient(mcpOptions);
+        await mcpClient.connect();
+        const browser = new Browser(mcpClient, defaultTimeout);
+        // Initialize pages list
+        await browser.refreshPages();
+        return browser;
+    }
+    async pages() {
+        this.ensureNotClosed();
+        await this.refreshPages();
+        return Array.from(this.pagesMap.values());
+    }
+    async currentPage() {
+        this.ensureNotClosed();
+        await this.refreshPages();
+        const activePage = Array.from(this.pagesMap.values()).find((p) => p.isActive());
+        if (!activePage) {
+            throw new E2EError(E2EErrorCode.PAGE_NOT_FOUND, 'No active page found');
+        }
+        return activePage;
+    }
+    async newPage(url) {
+        this.ensureNotClosed();
+        this.logger('debug', `Creating new page${url ? `: ${url}` : ''}`);
+        const result = await this.mcpClient.call('new_page', {
+            url: url ?? 'about:blank'
+        });
+        // `new_page` returns the full page list; the newly created tab is the selected one.
+        const selectedPage = this.parsePages(result).find((pageInfo) => pageInfo.active);
+        if (!selectedPage) {
+            throw new E2EError(E2EErrorCode.PAGE_NOT_FOUND, 'new_page did not report a selected page in its response');
+        }
+        const page = this.pagesMap.get(selectedPage.id) ?? new Page(this.mcpClient, selectedPage.id, this.defaultTimeout);
+        page.updatePageInfo(selectedPage.url, selectedPage.title, true);
+        this.pagesMap.set(selectedPage.id, page);
+        this.logger('debug', `New page created: ${selectedPage.id}`);
+        return page;
+    }
+    async selectPage(pageId) {
+        this.ensureNotClosed();
+        this.logger('debug', `Selecting page: ${pageId}`);
+        await this.mcpClient.call('select_page', { pageId, bringToFront: true });
+        const page = this.pagesMap.get(pageId) ?? new Page(this.mcpClient, pageId, this.defaultTimeout);
+        page.updatePageInfo(undefined, undefined, true);
+        this.pagesMap.set(pageId, page);
+        return page;
+    }
+    async close() {
+        if (this.closed) {
+            this.logger('debug', 'Browser already closed');
+            return;
+        }
+        this.logger('debug', 'Closing browser...');
+        this.pagesMap.clear();
+        // Close the MCP client connection. This intentionally does not close Chrome tabs.
+        await this.mcpClient.close();
+        this.closed = true;
+        this.logger('debug', 'Browser closed');
+    }
+    getDefaultTimeout() {
+        return this.defaultTimeout;
+    }
+    /**
+     * Updates the default timeout for this browser and every page already handed
+     * out, so locators and network waits created earlier pick up the new value.
+     */
+    setDefaultTimeout(timeout) {
+        if (!Number.isFinite(timeout) || timeout < 0) {
+            throw E2EError.invalidArgument('timeout', 'non-negative number', timeout);
+        }
+        this.defaultTimeout = timeout;
+        for (const page of this.pagesMap.values()) {
+            page.setDefaultTimeout(timeout);
+        }
+    }
+    isClosed() {
+        return this.closed;
+    }
+    getMCPClient() {
+        return this.mcpClient;
+    }
+    /**
+     * Reloads the page list, reusing existing `Page` instances so previously
+     * obtained locators keep pointing at a live page object.
+     */
+    async refreshPages() {
+        const result = await this.mcpClient.call('list_pages', {});
+        const pageInfos = this.parsePages(result);
+        const seen = new Set();
+        for (const pageInfo of pageInfos) {
+            seen.add(pageInfo.id);
+            const page = this.pagesMap.get(pageInfo.id) ?? new Page(this.mcpClient, pageInfo.id, this.defaultTimeout);
+            page.updatePageInfo(pageInfo.url, pageInfo.title, pageInfo.active);
+            this.pagesMap.set(pageInfo.id, page);
+        }
+        for (const pageId of [...this.pagesMap.keys()]) {
+            if (!seen.has(pageId)) {
+                this.pagesMap.delete(pageId);
+            }
+        }
+    }
+    parsePages(result) {
+        if (typeof result === 'object' && result !== null && Array.isArray(result.pages)) {
+            return result.pages.map((page) => ({
+                id: page.id,
+                url: page.url,
+                title: page.title || page.url,
+                active: page.selected
+            }));
+        }
+        const text = String(result);
+        return text
+            .split(/\r?\n/)
+            .map((line) => {
+            const match = line.match(/^(\d+):\s+(?:(.*?)\s+\(([^)]*)\)|(.*?))(\s+\[selected\])?(?:\s+isolatedContext=.*)?$/);
+            if (!match)
+                return null;
+            const id = Number(match[1]);
+            const title = (match[2] ?? '').trim();
+            const bareUrl = (match[4] ?? '').trim();
+            const url = match[3] ?? bareUrl;
+            return {
+                id,
+                url,
+                title: title || url,
+                active: Boolean(match[5])
+            };
+        })
+            .filter((pageInfo) => pageInfo !== null);
+    }
+    ensureNotClosed() {
+        if (this.closed) {
+            throw E2EError.browserClosed();
+        }
+    }
+}
+// Convenience function
+export async function connect(options = {}) {
+    return Browser.connect(options);
+}
+//# sourceMappingURL=Browser.js.map

package/dist/browser/Browser.js.map

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

package/dist/browser/Locator.d.ts

@@ -0,0 +1,94 @@
+import { Page } from './Page.js';
+import { type Selector } from '../errors/E2EError.js';
+export interface LocatorOptions {
+    timeout?: number;
+}
+export declare class Locator {
+    private page;
+    private selector;
+    private readonly logger;
+    constructor(page: Page, selector: Selector);
+    /**
+     * The selector this locator was built from. Read-only copy for diagnostics.
+     */
+    getSelector(): Selector;
+    private get spec();
+    /**
+     * Human readable selector description, used in error messages.
+     */
+    describe(): string;
+    /**
+     * Timeout is read from the owning page on every call so that
+     * `browser.setDefaultTimeout()` reaches locators that were created earlier.
+     */
+    private get defaultTimeout();
+    private createLogger;
+    click(options?: LocatorOptions): Promise<void>;
+    fill(value: string, options?: LocatorOptions): Promise<void>;
+    type(text: string, options?: LocatorOptions & {
+        delay?: number;
+    }): Promise<void>;
+    press(key: string, options?: LocatorOptions): Promise<void>;
+    hover(options?: LocatorOptions): Promise<void>;
+    dragTo(target: Locator, options?: LocatorOptions): Promise<void>;
+    setInputFiles(files: string | string[], options?: LocatorOptions): Promise<void>;
+    handleDialog(action: 'accept' | 'dismiss', promptText?: string, options?: LocatorOptions): Promise<void>;
+    textContent(options?: LocatorOptions): Promise<string>;
+    /**
+     * `value` is read as a DOM property, every other name as an attribute.
+     *
+     * The attribute only ever holds what the markup shipped with. Typing into a
+     * field changes the property, so `getAttribute('value')` returns null for
+     * anything the user entered, and `toHaveValue()` then fails on a field that
+     * visibly contains the right text. The label path already special-cased this;
+     * the css and role/text paths did not, so the same locator behaved
+     * differently depending on how it was written.
+     */
+    private static readAttributeScript;
+    getAttribute(name: string, options?: LocatorOptions): Promise<string | null>;
+    isVisible(options?: LocatorOptions): Promise<boolean>;
+    isEnabled(options?: LocatorOptions): Promise<boolean>;
+    isChecked(options?: LocatorOptions): Promise<boolean>;
+    waitForVisible(options?: LocatorOptions): Promise<void>;
+    waitForHidden(options?: LocatorOptions): Promise<void>;
+    boundingBox(options?: LocatorOptions): Promise<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    } | null>;
+    screenshot(options?: LocatorOptions): Promise<Buffer>;
+    /**
+     * Resolve this locator to a Chrome node uid.
+     *
+     * @internal
+     */
+    resolve(): Promise<{
+        uid: string;
+    }>;
+    getByText(text: string, options?: {
+        exact?: boolean;
+    }): Locator;
+    getByRole(role: string, options?: {
+        name?: string;
+        exact?: boolean;
+    }): Locator;
+    getByLabel(label: string, options?: {
+        exact?: boolean;
+    }): Locator;
+    locator(selector: string): Locator;
+    first(): Locator;
+    nth(index: number): Locator;
+    count(options?: LocatorOptions): Promise<number>;
+    private runCssAction;
+    private runLabelAction;
+    private countSnapshotMatches;
+    private matchesText;
+    /**
+     * State checks such as `isVisible()` return `false` when the element cannot be
+     * reached, but genuine failures (MCP errors, closed pages) must not be masked.
+     */
+    private rethrowIfFatal;
+    private withTimeout;
+}
+//# sourceMappingURL=Locator.d.ts.map

package/dist/browser/Locator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Locator.d.ts","sourceRoot":"","sources":["../../src/browser/Locator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAIrD,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;gBAErD,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ;IAM1C;;OAEG;IACH,WAAW,IAAI,QAAQ;IAIvB,OAAO,KAAK,IAAI,GAEf;IAED;;OAEG;IACH,QAAQ,IAAI,MAAM;IASlB;;;OAGG;IACH,OAAO,KAAK,cAAc,GAEzB;IAED,OAAO,CAAC,YAAY;IASd,KAAK,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyClD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoDhE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAc,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsDpF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD/D,KAAK,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2ClD,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBpE,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBpF,YAAY,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB5G,WAAW,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BhE;;;;;;;;;OASG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAS5B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAoChF,SAAS,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAwCzD,SAAS,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BzD,SAAS,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IA+BzD,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB3D,aAAa,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB1D,WAAW,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAuClH,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;IAa/D;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAKzC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAI/D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAI9E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAIjE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKlC,KAAK,IAAI,OAAO;IAIhB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAQrB,KAAK,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,MAAM,CAAC;YAuB5C,YAAY;YAaZ,cAAc;IAa5B,OAAO,CAAC,oBAAoB;IAgB5B,OAAO,CAAC,WAAW;IAKnB;;;OAGG;IACH,OAAO,CAAC,cAAc;YAYR,WAAW;CAY1B"}