@glubean/browser 0.8.1 → 0.8.4

package/dist/evidence.d.ts

@@ -0,0 +1,274 @@
+/**
+ * Shared evidence CDP session — the foundation for browser evidence capture.
+ *
+ * A single self-opened `createCDPSession` hosts **all** CDP-backed capabilities
+ * at once, instead of opening one session per capability:
+ *
+ * - **Network trace** (`Network` domain) — every in-page request as a Glubean
+ *   trace event (see {@link ./network.ts}).
+ * - **Request mock** (`Fetch` domain) — fulfill matching requests with a canned
+ *   response; non-matching requests are continued untouched.
+ * - **Emulation** (`Emulation` domain) — timezone / geolocation / viewport.
+ *
+ * The keystone spike disproved the "Fetch is near-exclusive" hypothesis: a
+ * self-opened session running `Fetch.enable`/`fulfillRequest` is stable **as
+ * long as the user has not enabled Puppeteer's own request interception**.
+ * Two coexistence hazards remain, each handled by a guardrail below:
+ *
+ * **Guardrail ① — viewport ownership.** Our `Emulation.setDeviceMetricsOverride`
+ * and Puppeteer's `page.setViewport()` both drive device metrics and clobber
+ * each other last-wins. When `emulate.viewport` is configured, Glubean is the
+ * sole owner: it applies the viewport last and blocks `page.setViewport()` with
+ * a clear error so the two never race.
+ *
+ * **Guardrail ② — Fetch double-open.** If the user turns on Puppeteer request
+ * interception (`page.setRequestInterception(true)`) while our `Fetch` mock is
+ * active, both stacks try to handle the same paused request and fulfillment
+ * conflicts. When mocks are enabled, Glubean owns `Fetch` and blocks
+ * `page.setRequestInterception(true)` with a clear error. When no mocks are
+ * configured we never enable `Fetch`, so the user's own interception is free.
+ *
+ * @module evidence
+ */
+import type { CDPSession, Page } from "puppeteer-core";
+import { type NetworkTracerOptions, type TraceFn } from "./network.js";
+/**
+ * When screenshots are automatically captured into the evidence stream.
+ *
+ * - `"off"` — no automatic screenshots
+ * - `"on-failure"` — capture when a step or test fails (default)
+ * - `"every-step"` — capture after every action AND on failure
+ */
+export type ScreenshotMode = "off" | "on-failure" | "every-step";
+/**
+ * What triggered a screenshot capture.
+ *
+ * - `"step"` — post-action capture in every-step mode
+ * - `"failure"` — automatic capture on action or assertion failure
+ * - `"manual"` — explicit call to `page.captureScreenshot()`
+ */
+export type ScreenshotTrigger = "step" | "failure" | "manual";
+/** A screenshot captured into the evidence stream. */
+export interface ScreenshotEntry {
+    /** Sequential number within this evidence session (1-based). */
+    seq: number;
+    /** Wall-clock ISO timestamp at capture time. */
+    ts: string;
+    /** Human-readable label (the action or assertion that triggered the capture). */
+    label: string;
+    /** What triggered this capture. */
+    trigger: ScreenshotTrigger;
+    /** Artifact ID when `ctx.saveArtifact` is available (SDK ≥ 0.13). */
+    artifactId?: string;
+    /** File path when falling back to direct file write. */
+    path?: string;
+}
+/**
+ * Screenshot capture options for the shared evidence session.
+ *
+ * The `shoot` delegate performs the actual I/O (screenshot + artifact save +
+ * `ctx.event()` emission); {@link EvidenceSession.captureShot} handles the
+ * mode / trigger policy, sequencing, and accumulation of entries.
+ */
+export interface EvidenceScreenshotOptions {
+    /** Policy: which triggers result in a capture. */
+    mode: ScreenshotMode;
+    /**
+     * I/O delegate — takes the screenshot, saves the artifact, and emits
+     * the `browser:screenshot` evidence event. Returns an artifact reference
+     * for {@link ScreenshotEntry}. Called only when the mode/trigger policy allows.
+     *
+     * @param filename — suggested filename: `[FAIL-]NNN-label-ts.png`
+     * @param label — human label for the action/assertion
+     * @param trigger — what triggered this capture
+     */
+    shoot: (filename: string, label: string, trigger: ScreenshotTrigger) => Promise<{
+        artifactId?: string;
+        path?: string;
+    }>;
+}
+/** A single header as CDP's `Fetch.fulfillRequest` expects it. */
+interface HeaderEntry {
+    name: string;
+    value: string;
+}
+/**
+ * A request-mock rule. Matching requests are fulfilled with a canned response;
+ * everything else is continued untouched.
+ */
+export interface MockRule {
+    /**
+     * Match the request URL. A string matches by substring (`url.includes(...)`);
+     * a `RegExp` matches by `test(url)`.
+     */
+    url: string | RegExp;
+    /** Restrict to a single HTTP method (case-insensitive). Omit to match any. */
+    method?: string;
+    /** Response status code. @default 200 */
+    status?: number;
+    /** Extra response headers. */
+    headers?: Record<string, string>;
+    /**
+     * Response body. A string is sent verbatim; any other value is
+     * `JSON.stringify`-ed. The `content-type` is inferred (JSON vs plain text)
+     * unless `contentType` is set.
+     */
+    body?: unknown;
+    /** Explicit `content-type` header. Overrides the inferred value. */
+    contentType?: string;
+}
+/** Geolocation override. */
+export interface GeolocationOverride {
+    latitude: number;
+    longitude: number;
+    /** Accuracy in meters. @default 0 (mirrors Puppeteer's `setGeolocation`). */
+    accuracy?: number;
+}
+/** Viewport / device-metrics override (owned solely by Glubean — see guardrail ①). */
+export interface ViewportOverride {
+    width: number;
+    height: number;
+    /** @default 1 */
+    deviceScaleFactor?: number;
+    /** @default false */
+    mobile?: boolean;
+}
+/**
+ * Environment emulation applied on the shared evidence session.
+ *
+ * Timezone and geolocation are pure overrides with no Puppeteer conflict.
+ * Viewport is special: see guardrail ① — do **not** also call
+ * `page.setViewport()`, it will race with this override.
+ */
+export interface EmulationOptions {
+    /** IANA timezone id, e.g. `"America/New_York"`. */
+    timezone?: string;
+    /** Geolocation override. */
+    geolocation?: GeolocationOverride;
+    /** Viewport / device metrics. Glubean becomes the sole viewport owner. */
+    viewport?: ViewportOverride;
+}
+/** Options for {@link EvidenceSession.attach}. */
+export interface EvidenceSessionOptions {
+    /**
+     * Network-trace callback (`ctx.trace`). When omitted, the `Network` domain
+     * tracer is not attached.
+     */
+    trace?: TraceFn;
+    /** Network-trace filter configuration. Ignored when `trace` is omitted. */
+    network?: Pick<NetworkTracerOptions, "include" | "excludePaths" | "filter">;
+    /** Request-mock rules. When non-empty, the `Fetch` domain is enabled (guardrail ②). */
+    mocks?: MockRule[];
+    /** Environment emulation (timezone / geolocation / viewport). */
+    emulate?: EmulationOptions;
+    /**
+     * Screenshot capture policy and I/O delegate.
+     *
+     * When provided, {@link EvidenceSession.captureShot} becomes active and will
+     * call `screenshots.shoot` based on the configured mode and trigger.
+     * Omit (or set `mode: "off"`) to disable all automatic screenshot capture.
+     */
+    screenshots?: EvidenceScreenshotOptions;
+}
+/** A single CDP call: `{ method, params }`. Kept pure for testing. */
+export interface CdpCall {
+    method: string;
+    params?: Record<string, unknown>;
+}
+/** @internal Does `rule` match the given request? */
+export declare function matchMock(rule: MockRule, req: {
+    url: string;
+    method: string;
+}): boolean;
+/** @internal Find the first matching mock rule, or `undefined`. */
+export declare function findMock(mocks: readonly MockRule[], req: {
+    url: string;
+    method: string;
+}): MockRule | undefined;
+/**
+ * @internal Build `Fetch.fulfillRequest` params from a rule.
+ *
+ * The body is always base64-encoded (as CDP requires). Content-type is inferred
+ * from the body kind unless `rule.contentType` is set. User headers win over the
+ * inferred content-type.
+ */
+export declare function buildFulfillParams(rule: MockRule, requestId: string): {
+    requestId: string;
+    responseCode: number;
+    responseHeaders: HeaderEntry[];
+    body: string;
+};
+/**
+ * @internal Build the ordered list of `Emulation.*` CDP calls.
+ *
+ * Timezone and geolocation come first; the viewport override is applied **last**
+ * (guardrail ①) so it is the final word on device metrics at setup time.
+ */
+export declare function buildEmulationCalls(emulate: EmulationOptions): CdpCall[];
+/**
+ * @internal Replace `page[method]` with a guard, returning a restore function.
+ *
+ * `shouldBlock` decides, per call arguments, whether to throw the guard error.
+ * Blocked calls throw synchronously; allowed calls fall through to the original
+ * method (or resolve to `undefined` if there was none). Used to enforce
+ * guardrails ① (viewport) and ② (Fetch interception).
+ */
+export declare function guardPageMethod(page: any, method: string, message: string, shouldBlock: (args: unknown[]) => boolean): () => void;
+/**
+ * A single self-opened CDP session that hosts every CDP-backed evidence
+ * capability for one page. Create with {@link EvidenceSession.attach}; release
+ * with {@link EvidenceSession.detach}.
+ */
+export declare class EvidenceSession {
+    private readonly _cdp;
+    private readonly _cleanups;
+    private _detached;
+    private _screenshotOpts;
+    private _screenshotSeq;
+    private _screenshotLog;
+    private constructor();
+    /** The underlying CDP session, for advanced/raw use. */
+    get cdp(): CDPSession;
+    /**
+     * All screenshots captured into this evidence session, in order.
+     *
+     * Each entry carries `seq`, `ts`, `label`, `trigger`, and an artifact
+     * reference (`artifactId` or `path`). The list is empty when no screenshot
+     * has been captured yet or when `screenshots.mode` is `"off"`.
+     */
+    get screenshots(): readonly ScreenshotEntry[];
+    /**
+     * Capture a screenshot into the evidence stream, subject to the configured
+     * {@link ScreenshotMode} and the `trigger` argument.
+     *
+     * | mode          | "step" trigger | "failure" trigger | "manual" trigger |
+     * |---------------|----------------|-------------------|------------------|
+     * | "off"         | skip           | skip              | skip             |
+     * | "on-failure"  | skip           | capture           | capture          |
+     * | "every-step"  | capture        | capture           | capture          |
+     *
+     * Always best-effort: errors from the I/O delegate are silently swallowed
+     * so a broken page state never masks the real test error.
+     *
+     * Does nothing when no `screenshots` option was passed to {@link attach}.
+     */
+    captureShot(label: string, trigger: ScreenshotTrigger): Promise<void>;
+    /**
+     * Open one CDP session on `page` and wire up the requested capabilities:
+     * Network trace, Fetch mock (guardrail ②), and Emulation (guardrail ① for
+     * viewport). Capabilities are only enabled when their config is present, so a
+     * page with no mocks never enables `Fetch` and leaves the user's own request
+     * interception untouched.
+     */
+    static attach(page: Page, options: EvidenceSessionOptions): Promise<EvidenceSession>;
+    private _installMocks;
+    private _guardViewport;
+    /**
+     * Remove all listeners/overrides, restore guarded page methods, and detach
+     * the CDP session. Idempotent and best-effort — safe to call after the page
+     * has closed.
+     */
+    detach(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=evidence.d.ts.map

package/dist/evidence.d.ts.map

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

package/dist/evidence.js

@@ -0,0 +1,343 @@
+/**
+ * Shared evidence CDP session — the foundation for browser evidence capture.
+ *
+ * A single self-opened `createCDPSession` hosts **all** CDP-backed capabilities
+ * at once, instead of opening one session per capability:
+ *
+ * - **Network trace** (`Network` domain) — every in-page request as a Glubean
+ *   trace event (see {@link ./network.ts}).
+ * - **Request mock** (`Fetch` domain) — fulfill matching requests with a canned
+ *   response; non-matching requests are continued untouched.
+ * - **Emulation** (`Emulation` domain) — timezone / geolocation / viewport.
+ *
+ * The keystone spike disproved the "Fetch is near-exclusive" hypothesis: a
+ * self-opened session running `Fetch.enable`/`fulfillRequest` is stable **as
+ * long as the user has not enabled Puppeteer's own request interception**.
+ * Two coexistence hazards remain, each handled by a guardrail below:
+ *
+ * **Guardrail ① — viewport ownership.** Our `Emulation.setDeviceMetricsOverride`
+ * and Puppeteer's `page.setViewport()` both drive device metrics and clobber
+ * each other last-wins. When `emulate.viewport` is configured, Glubean is the
+ * sole owner: it applies the viewport last and blocks `page.setViewport()` with
+ * a clear error so the two never race.
+ *
+ * **Guardrail ② — Fetch double-open.** If the user turns on Puppeteer request
+ * interception (`page.setRequestInterception(true)`) while our `Fetch` mock is
+ * active, both stacks try to handle the same paused request and fulfillment
+ * conflicts. When mocks are enabled, Glubean owns `Fetch` and blocks
+ * `page.setRequestInterception(true)` with a clear error. When no mocks are
+ * configured we never enable `Fetch`, so the user's own interception is free.
+ *
+ * @module evidence
+ */
+import { attachNetworkTracer, } from "./network.js";
+// ── Pure helpers (exported for testing) ───────────────────────────────
+/** @internal Does `rule` match the given request? */
+export function matchMock(rule, req) {
+    if (rule.method && rule.method.toUpperCase() !== req.method.toUpperCase()) {
+        return false;
+    }
+    if (typeof rule.url === "string")
+        return req.url.includes(rule.url);
+    // Test against a stateless clone: a user-supplied global/sticky regex
+    // (`/g`, `/y`) carries `lastIndex` state, so `.test()` on the original would
+    // flip-flop matches for the same URL across repeated requests (and would also
+    // mutate the caller's regex). Strip `g`/`y` on a copy to keep matching pure.
+    const stateless = new RegExp(rule.url.source, rule.url.flags.replace(/[gy]/g, ""));
+    return stateless.test(req.url);
+}
+/** @internal Find the first matching mock rule, or `undefined`. */
+export function findMock(mocks, req) {
+    return mocks.find((m) => matchMock(m, req));
+}
+/**
+ * @internal Build `Fetch.fulfillRequest` params from a rule.
+ *
+ * The body is always base64-encoded (as CDP requires). Content-type is inferred
+ * from the body kind unless `rule.contentType` is set. User headers win over the
+ * inferred content-type.
+ */
+export function buildFulfillParams(rule, requestId) {
+    let bodyStr = "";
+    let inferredType;
+    if (rule.body !== undefined) {
+        if (typeof rule.body === "string") {
+            bodyStr = rule.body;
+            inferredType = "text/plain; charset=utf-8";
+        }
+        else {
+            bodyStr = JSON.stringify(rule.body);
+            inferredType = "application/json; charset=utf-8";
+        }
+    }
+    const headerMap = new Map();
+    const contentType = rule.contentType ?? inferredType;
+    if (contentType !== undefined)
+        headerMap.set("content-type", contentType);
+    // User headers win over the inferred content-type (case-insensitive keys).
+    for (const [name, value] of Object.entries(rule.headers ?? {})) {
+        headerMap.set(name.toLowerCase(), value);
+    }
+    return {
+        requestId,
+        responseCode: rule.status ?? 200,
+        responseHeaders: [...headerMap].map(([name, value]) => ({ name, value })),
+        body: Buffer.from(bodyStr, "utf8").toString("base64"),
+    };
+}
+/**
+ * @internal Build the ordered list of `Emulation.*` CDP calls.
+ *
+ * Timezone and geolocation come first; the viewport override is applied **last**
+ * (guardrail ①) so it is the final word on device metrics at setup time.
+ */
+export function buildEmulationCalls(emulate) {
+    const calls = [];
+    if (emulate.timezone !== undefined) {
+        calls.push({
+            method: "Emulation.setTimezoneOverride",
+            params: { timezoneId: emulate.timezone },
+        });
+    }
+    if (emulate.geolocation) {
+        const { latitude, longitude, accuracy } = emulate.geolocation;
+        calls.push({
+            method: "Emulation.setGeolocationOverride",
+            params: { latitude, longitude, accuracy: accuracy ?? 0 },
+        });
+    }
+    if (emulate.viewport) {
+        const { width, height, deviceScaleFactor, mobile } = emulate.viewport;
+        calls.push({
+            method: "Emulation.setDeviceMetricsOverride",
+            params: {
+                width,
+                height,
+                deviceScaleFactor: deviceScaleFactor ?? 1,
+                mobile: mobile ?? false,
+            },
+        });
+    }
+    return calls;
+}
+/**
+ * @internal Replace `page[method]` with a guard, returning a restore function.
+ *
+ * `shouldBlock` decides, per call arguments, whether to throw the guard error.
+ * Blocked calls throw synchronously; allowed calls fall through to the original
+ * method (or resolve to `undefined` if there was none). Used to enforce
+ * guardrails ① (viewport) and ② (Fetch interception).
+ */
+export function guardPageMethod(
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+page, method, message, shouldBlock) {
+    const hadOwn = Object.prototype.hasOwnProperty.call(page, method);
+    const previous = page[method];
+    const original = typeof previous === "function"
+        ? previous.bind(page)
+        : undefined;
+    page[method] = (...args) => {
+        if (shouldBlock(args))
+            throw new Error(message);
+        return original ? original(...args) : Promise.resolve(undefined);
+    };
+    return () => {
+        if (hadOwn)
+            page[method] = previous;
+        else
+            delete page[method];
+    };
+}
+// ── EvidenceSession ───────────────────────────────────────────────────
+/**
+ * A single self-opened CDP session that hosts every CDP-backed evidence
+ * capability for one page. Create with {@link EvidenceSession.attach}; release
+ * with {@link EvidenceSession.detach}.
+ */
+export class EvidenceSession {
+    _cdp;
+    _cleanups = [];
+    _detached = false;
+    // ── Screenshot state ──────────────────────────────────────────────
+    _screenshotOpts;
+    _screenshotSeq = 0;
+    _screenshotLog = [];
+    constructor(cdp) {
+        this._cdp = cdp;
+    }
+    /** The underlying CDP session, for advanced/raw use. */
+    get cdp() {
+        return this._cdp;
+    }
+    /**
+     * All screenshots captured into this evidence session, in order.
+     *
+     * Each entry carries `seq`, `ts`, `label`, `trigger`, and an artifact
+     * reference (`artifactId` or `path`). The list is empty when no screenshot
+     * has been captured yet or when `screenshots.mode` is `"off"`.
+     */
+    get screenshots() {
+        return this._screenshotLog;
+    }
+    /**
+     * Capture a screenshot into the evidence stream, subject to the configured
+     * {@link ScreenshotMode} and the `trigger` argument.
+     *
+     * | mode          | "step" trigger | "failure" trigger | "manual" trigger |
+     * |---------------|----------------|-------------------|------------------|
+     * | "off"         | skip           | skip              | skip             |
+     * | "on-failure"  | skip           | capture           | capture          |
+     * | "every-step"  | capture        | capture           | capture          |
+     *
+     * Always best-effort: errors from the I/O delegate are silently swallowed
+     * so a broken page state never masks the real test error.
+     *
+     * Does nothing when no `screenshots` option was passed to {@link attach}.
+     */
+    async captureShot(label, trigger) {
+        const opts = this._screenshotOpts;
+        if (!opts)
+            return;
+        // "off" blocks automatic triggers but manual checkpoints always fire.
+        if (opts.mode === "off" && trigger !== "manual")
+            return;
+        if (opts.mode === "on-failure" && trigger === "step")
+            return;
+        this._screenshotSeq++;
+        const seq = this._screenshotSeq;
+        const ts = new Date().toISOString();
+        const sanitized = label.replace(/[^a-z0-9_-]/gi, "_").slice(0, 60);
+        const tsCompact = ts.replace(/[:.]/g, "").slice(0, 15);
+        const prefix = trigger === "failure" ? "FAIL-" : "";
+        const filename = `${prefix}${String(seq).padStart(3, "0")}-${sanitized}-${tsCompact}.png`;
+        try {
+            const ref = await opts.shoot(filename, label, trigger);
+            this._screenshotLog.push({ seq, ts, label, trigger, ...ref });
+        }
+        catch {
+            // best-effort: page may be in a broken state
+        }
+    }
+    /**
+     * Open one CDP session on `page` and wire up the requested capabilities:
+     * Network trace, Fetch mock (guardrail ②), and Emulation (guardrail ① for
+     * viewport). Capabilities are only enabled when their config is present, so a
+     * page with no mocks never enables `Fetch` and leaves the user's own request
+     * interception untouched.
+     */
+    static async attach(page, options) {
+        const cdp = await page.createCDPSession();
+        const session = new EvidenceSession(cdp);
+        // Wire screenshot options (no CDP domain — just stores the delegate).
+        // Store opts even when mode is "off" so that captureShot can still
+        // honour explicit manual checkpoints (captureShot itself gates auto
+        // triggers via `if (mode === "off" && trigger !== "manual") return`).
+        if (options.screenshots) {
+            session._screenshotOpts = options.screenshots;
+        }
+        try {
+            // 1. Network trace.
+            if (options.trace) {
+                const removeNetwork = await attachNetworkTracer(cdp, {
+                    trace: options.trace,
+                    include: options.network?.include,
+                    excludePaths: options.network?.excludePaths,
+                    filter: options.network?.filter,
+                });
+                session._cleanups.push(removeNetwork);
+            }
+            // 2. Fetch mock — guardrail ②: Glubean owns Fetch, block user interception.
+            const mocks = options.mocks;
+            if (mocks && mocks.length > 0) {
+                await session._installMocks(page, mocks);
+            }
+            // 3. Emulation (timezone / geolocation) + viewport last (guardrail ①).
+            if (options.emulate) {
+                for (const call of buildEmulationCalls(options.emulate)) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    await cdp.send(call.method, call.params);
+                }
+                if (options.emulate.viewport) {
+                    session._guardViewport(page);
+                }
+            }
+        }
+        catch (err) {
+            // Roll back any partial wiring so we never leak a half-open session.
+            await session.detach();
+            throw err;
+        }
+        return session;
+    }
+    async _installMocks(page, mocks) {
+        // Guardrail ②: block the user from enabling Puppeteer request interception
+        // while our Fetch mock is active (double-fulfill conflict). Disabling
+        // (`false`) is allowed through to the original.
+        const restoreInterception = guardPageMethod(page, "setRequestInterception", "Glubean request mocking is active on this page: do not call " +
+            "page.setRequestInterception(true) — it conflicts with the mock's " +
+            "Fetch handler. Remove the `mock` option to manage interception yourself.", (args) => args[0] === true);
+        this._cleanups.push(restoreInterception);
+        // Intercept every request at the Request stage; match in JS. Mocked
+        // requests are fulfilled, everything else is continued untouched — so the
+        // Network tracer still observes real responses.
+        await this._cdp.send("Fetch.enable", {
+            patterns: [{ urlPattern: "*", requestStage: "Request" }],
+        });
+        const onPaused = (event) => {
+            const rule = findMock(mocks, {
+                url: event.request.url,
+                method: event.request.method,
+            });
+            const done = rule
+                ? this._cdp.send("Fetch.fulfillRequest", 
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                buildFulfillParams(rule, event.requestId))
+                : this._cdp.send("Fetch.continueRequest", {
+                    requestId: event.requestId,
+                });
+            // The request is gone if the page navigated away mid-flight — ignore.
+            done.catch(() => { });
+        };
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        this._cdp.on("Fetch.requestPaused", onPaused);
+        this._cleanups.push(() => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this._cdp.off("Fetch.requestPaused", onPaused);
+        });
+    }
+    _guardViewport(page) {
+        // Guardrail ①: Glubean owns the viewport via Emulation on this session.
+        // Block page.setViewport() so it can't clobber the override last-wins.
+        const restore = guardPageMethod(page, "setViewport", "Glubean owns the viewport on this page (via the `emulate.viewport` " +
+            "option): do not call page.setViewport() — the two overrides race " +
+            "last-wins. Configure the viewport through browser({ emulate }) instead.", () => true);
+        this._cleanups.push(restore);
+    }
+    /**
+     * Remove all listeners/overrides, restore guarded page methods, and detach
+     * the CDP session. Idempotent and best-effort — safe to call after the page
+     * has closed.
+     */
+    async detach() {
+        if (this._detached)
+            return;
+        this._detached = true;
+        // Run cleanups in reverse (LIFO) so guards/overrides unwind in order.
+        for (const cleanup of this._cleanups.reverse()) {
+            try {
+                await cleanup();
+            }
+            catch {
+                // best-effort — page/session may already be gone
+            }
+        }
+        this._cleanups.length = 0;
+        try {
+            await this._cdp.detach();
+        }
+        catch {
+            // session may already be closed
+        }
+    }
+}
+//# sourceMappingURL=evidence.js.map

package/dist/evidence.js.map

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

package/dist/index.d.ts

@@ -38,6 +38,7 @@
  */
 export { browser } from "./plugin.js";
 export { GlubeanBrowser, GlubeanPage } from "./page.js";
-export type { ActionOptions, BrowserAction, BrowserEvent, BrowserOptions, BrowserTestContext, InstrumentedPage, PuppeteerLike, NetworkTraceOptions, ResponseChecks, ScreenshotMode, } from "./page.js";
+export type { ActionOptions, BrowserAction, BrowserEvent, BrowserOptions, BrowserTestContext, InstrumentedPage, PuppeteerLike, NetworkTraceOptions, ResponseChecks, } from "./page.js";
+export type { EmulationOptions, EvidenceScreenshotOptions, GeolocationOverride, MockRule, ScreenshotEntry, ScreenshotMode, ScreenshotTrigger, ViewportOverride, } from "./evidence.js";
 export type { WrappedLocator } from "./locator.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxD,YAAY,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,gBAAgB,EAChB,yBAAyB,EACzB,mBAAmB,EACnB,QAAQ,EACR,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC"}