craftdriver 1.7.0 → 1.9.0

package/dist/lib/secureFile.js

@@ -0,0 +1,67 @@
+/**
+ * Secure writer for credential-bearing state files.
+ *
+ * A saved `SessionState` holds live session cookies, so it is written the way a
+ * credential file should be: the parent directory is created, an existing
+ * symlink at the destination is refused, the content is written to a
+ * same-directory temporary file with owner-only permissions, and that temp file
+ * is atomically renamed into place. A crash therefore never leaves a
+ * half-written file, and the bytes never pass through a symlink that could
+ * redirect them elsewhere.
+ *
+ * POSIX permissions are best-effort — Windows ignores the mode, so callers must
+ * not assume `0600` there. This module is intentionally free of any CLI
+ * dependency so the public library owns its own persistence discipline.
+ */
+import fs from 'fs/promises';
+import { basename, dirname, join, resolve } from 'path';
+import { randomBytes } from 'crypto';
+import { CraftdriverError, ErrorCode } from './errors.js';
+/**
+ * Atomically write `contents` to `destPath` with owner-only permissions.
+ *
+ * @throws {CraftdriverError} `INVALID_ARGUMENT` if the destination already
+ *   exists as a symlink.
+ */
+export async function writeSecureFile(destPath, contents) {
+    const abs = resolve(destPath);
+    const dir = dirname(abs);
+    await fs.mkdir(dir, { recursive: true });
+    // Refuse an existing symlink at the destination: writing "through" it could
+    // land the credentials outside `dir`. (The atomic rename below already
+    // replaces a link rather than following it, so this is a clear error rather
+    // than the load-bearing defense.)
+    try {
+        const st = await fs.lstat(abs);
+        if (st.isSymbolicLink()) {
+            throw new CraftdriverError(ErrorCode.INVALID_ARGUMENT, `refusing to write state through a symlink: ${abs}`);
+        }
+    }
+    catch (err) {
+        if (err instanceof CraftdriverError)
+            throw err;
+        // ENOENT is the normal case — the destination does not exist yet. Any other
+        // lstat failure (EACCES, ELOOP, a broken path component, …) is a real
+        // problem; propagate it rather than blindly proceeding to write.
+        if (err.code !== 'ENOENT')
+            throw err;
+    }
+    const tmp = join(dir, `.${basename(abs)}.${randomBytes(6).toString('hex')}.tmp`);
+    try {
+        // `wx` fails if the temp name somehow exists; `mode` requests owner-only at
+        // creation. chmod after is belt-and-suspenders for platforms/umasks that do
+        // not honor the create mode.
+        await fs.writeFile(tmp, contents, { encoding: 'utf-8', mode: 0o600, flag: 'wx' });
+        await fs.chmod(tmp, 0o600).catch(() => {
+            /* Windows / unsupported fs — mode is best-effort */
+        });
+        await fs.rename(tmp, abs);
+    }
+    catch (err) {
+        await fs.rm(tmp, { force: true }).catch(() => {
+            /* nothing to clean up */
+        });
+        throw err;
+    }
+}
+//# sourceMappingURL=secureFile.js.map

package/dist/lib/secureFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secureFile.js","sourceRoot":"","sources":["../../src/lib/secureFile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,QAAgB;IACtE,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;IAEzB,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEzC,4EAA4E;IAC5E,uEAAuE;IACvE,4EAA4E;IAC5E,kCAAkC;IAClC,IAAI,CAAC;QACH,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,gBAAgB,CACxB,SAAS,CAAC,gBAAgB,EAC1B,8CAA8C,GAAG,EAAE,CACpD,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,gBAAgB;YAAE,MAAM,GAAG,CAAC;QAC/C,4EAA4E;QAC5E,sEAAsE;QACtE,iEAAiE;QACjE,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC;IAClE,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACjF,IAAI,CAAC;QACH,4EAA4E;QAC5E,4EAA4E;QAC5E,6BAA6B;QAC7B,MAAM,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClF,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACpC,oDAAoD;QACtD,CAAC,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YAC3C,yBAAyB;QAC3B,CAAC,CAAC,CAAC;QACH,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/lib/sessionStateValidation.d.ts

@@ -0,0 +1,35 @@
+import { CraftdriverError } from './errors.js';
+import type { CookieInput, SessionState } from './bidi/types.js';
+export interface StorageStateErrorContext {
+    operation?: string;
+    browserName?: string;
+    protocol?: 'bidi' | 'classic' | string;
+}
+export declare function storageStateDetail(context: StorageStateErrorContext | undefined, phase: string, extra?: Record<string, unknown>): Record<string, unknown>;
+/** True for an error already carrying this feature's structured contract. */
+export declare function isStorageStateError(error: unknown): error is CraftdriverError;
+/** A canonical http(s) origin: `scheme://host[:port]`, no path or trailing slash. */
+export declare function isHttpOrigin(origin: string): boolean;
+/**
+ * Parse `source` (a path or an in-memory object) into a validated
+ * {@link SessionState}. Malformed shapes throw `INVALID_ARGUMENT`; unknown or
+ * legacy sections throw `UNSUPPORTED`.
+ */
+export declare function parseSessionState(source: SessionState | string, context?: StorageStateErrorContext): Promise<SessionState>;
+/** Origins in `map` that actually carry at least one entry. */
+export declare function nonEmptyOrigins(map?: Record<string, Record<string, string>>): string[];
+/** True when the state carries at least one origin with ≥1 sessionStorage entry. */
+export declare function hasNonEmptySessionStorage(state: SessionState): boolean;
+/** True when a valid state has no cookie or storage mutations to apply. */
+export declare function isSessionStateEmpty(state: SessionState): boolean;
+/**
+ * Convert a captured cookie into the one canonical restore shape used by every
+ * protocol path. Browser read APIs may report `sameSite: 'default'`, and some
+ * engines report insecure `sameSite: 'none'`; neither can be replayed literally
+ * through all WebDriver cookie commands, so omit sameSite and let the engine
+ * apply its default consistently. `size` is capture-only and is never written.
+ */
+export declare function normalizeCookieForRestore(cookie: CookieInput & {
+    size?: number;
+}): CookieInput;
+//# sourceMappingURL=sessionStateValidation.d.ts.map

package/dist/lib/sessionStateValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStateValidation.d.ts","sourceRoot":"","sources":["../../src/lib/sessionStateValidation.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,gBAAgB,EAAa,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAQjE,MAAM,WAAW,wBAAwB;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;CACxC;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,wBAAwB,GAAG,SAAS,EAC7C,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB;AAED,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE7E;AAkBD,qFAAqF;AACrF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOpD;AAwGD;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,YAAY,GAAG,MAAM,EAC7B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,CAGtF;AAED,oFAAoF;AACpF,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAEtE;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAMhE;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAkB9F"}

package/dist/lib/sessionStateValidation.js

@@ -0,0 +1,223 @@
+/**
+ * Parsing and validation for saved session state, shared by every restore entry
+ * point. The whole state is validated *before* any browser mutation, so a
+ * malformed or unsupported file fails loudly and leaves the browser untouched.
+ *
+ * Unknown or unsupported sections (including the legacy Playwright `origins`
+ * field) are rejected rather than silently ignored — a saved snapshot must mean
+ * exactly what it says.
+ */
+import fs from 'fs/promises';
+import { CraftdriverError, ErrorCode } from './errors.js';
+const KNOWN_SECTIONS = new Set(['cookies', 'localStorage', 'sessionStorage']);
+const COOKIE_FIELDS = new Set([
+    'name', 'value', 'domain', 'path', 'httpOnly', 'secure', 'sameSite', 'expiry', 'size',
+]);
+const SAME_SITE_VALUES = new Set(['strict', 'lax', 'none', 'default']);
+export function storageStateDetail(context, phase, extra) {
+    return {
+        feature: 'storageState',
+        operation: context?.operation ?? 'restore',
+        browserName: context?.browserName ?? 'unknown',
+        protocol: context?.protocol ?? 'unknown',
+        phase,
+        ...extra,
+    };
+}
+/** True for an error already carrying this feature's structured contract. */
+export function isStorageStateError(error) {
+    return CraftdriverError.is(error) && error.detail?.feature === 'storageState';
+}
+function invalid(message, context, extra) {
+    throw new CraftdriverError(ErrorCode.INVALID_ARGUMENT, message, {
+        detail: storageStateDetail(context, 'validation', extra),
+    });
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+/** A canonical http(s) origin: `scheme://host[:port]`, no path or trailing slash. */
+export function isHttpOrigin(origin) {
+    try {
+        const u = new URL(origin);
+        return (u.protocol === 'http:' || u.protocol === 'https:') && u.origin === origin;
+    }
+    catch {
+        return false;
+    }
+}
+function validateOriginMap(section, map, context) {
+    if (map === undefined)
+        return;
+    if (!isPlainObject(map)) {
+        invalid(`state.${section} must be an object keyed by origin`, context, { section });
+    }
+    for (const [origin, entries] of Object.entries(map)) {
+        if (!isHttpOrigin(origin)) {
+            invalid(`state.${section} contains a non-canonical HTTP(S) origin`, context, {
+                section,
+                origin,
+            });
+        }
+        if (!isPlainObject(entries)) {
+            invalid(`state.${section} entries must be maps of string keys to string values`, context, {
+                section,
+                origin,
+            });
+        }
+        for (const value of Object.values(entries)) {
+            if (typeof value !== 'string') {
+                invalid(`state.${section} values must be strings`, context, { section, origin });
+            }
+        }
+    }
+}
+function validateCookies(cookies, context) {
+    if (cookies === undefined)
+        return;
+    if (!Array.isArray(cookies))
+        invalid('state.cookies must be an array', context, { section: 'cookies' });
+    for (const entry of cookies) {
+        if (!isPlainObject(entry)) {
+            invalid('state.cookies entries must be plain objects', context, { section: 'cookies' });
+        }
+        const cookie = entry;
+        // BiDi implementations may attach namespaced, capture-only metadata
+        // (`goog:priority`, etc.). Preserve compatibility with files CraftDriver
+        // previously emitted; normalization drops these fields before mutation.
+        const unknown = Object.keys(cookie).find((key) => !COOKIE_FIELDS.has(key) && !key.includes(':'));
+        if (unknown) {
+            invalid('state.cookies contains an unsupported cookie field', context, {
+                section: 'cookies',
+                field: unknown,
+            });
+        }
+        if (typeof cookie.name !== 'string' || cookie.name.length === 0) {
+            invalid('each cookie needs a non-empty string name', context, { section: 'cookies' });
+        }
+        if (/[^\u0021-\u007E]|[()<>@,;:\\"/\[\]?={}]/.test(cookie.name)) {
+            invalid('cookie name contains characters WebDriver cannot set', context, { section: 'cookies' });
+        }
+        if (typeof cookie.value !== 'string') {
+            invalid('each cookie value must be a string', context, { section: 'cookies' });
+        }
+        if (typeof cookie.domain !== 'string' || cookie.domain.trim().length === 0) {
+            invalid('each cookie needs a non-empty string domain', context, { section: 'cookies' });
+        }
+        if (typeof cookie.domain === 'string' &&
+            (/\s/.test(cookie.domain) || cookie.domain.includes('/') || cookie.domain.endsWith('.'))) {
+            invalid('cookie domain is not a valid host or domain suffix', context, { section: 'cookies' });
+        }
+        if (cookie.path !== undefined &&
+            (typeof cookie.path !== 'string' || !cookie.path.startsWith('/'))) {
+            invalid('cookie path must be a string beginning with "/"', context, { section: 'cookies' });
+        }
+        for (const field of ['httpOnly', 'secure']) {
+            if (cookie[field] !== undefined && typeof cookie[field] !== 'boolean') {
+                invalid(`cookie ${field} must be a boolean`, context, { section: 'cookies', field });
+            }
+        }
+        if (cookie.sameSite !== undefined &&
+            (typeof cookie.sameSite !== 'string' || !SAME_SITE_VALUES.has(cookie.sameSite))) {
+            invalid('cookie sameSite must be strict, lax, none, or default', context, {
+                section: 'cookies',
+            });
+        }
+        if (cookie.expiry !== undefined &&
+            (typeof cookie.expiry !== 'number' || !Number.isFinite(cookie.expiry))) {
+            invalid('cookie expiry must be a finite number', context, { section: 'cookies' });
+        }
+        if (cookie.size !== undefined &&
+            (typeof cookie.size !== 'number' || !Number.isInteger(cookie.size) || cookie.size < 0)) {
+            invalid('cookie size must be a non-negative integer', context, { section: 'cookies' });
+        }
+    }
+}
+/**
+ * Parse `source` (a path or an in-memory object) into a validated
+ * {@link SessionState}. Malformed shapes throw `INVALID_ARGUMENT`; unknown or
+ * legacy sections throw `UNSUPPORTED`.
+ */
+export async function parseSessionState(source, context) {
+    let raw;
+    if (typeof source === 'string') {
+        let text;
+        try {
+            text = await fs.readFile(source, 'utf-8');
+        }
+        catch (err) {
+            invalid(`could not read state file ${source}: ${err.message}`, context);
+        }
+        try {
+            raw = JSON.parse(text);
+        }
+        catch {
+            invalid(`state file ${source} is not valid JSON`, context);
+        }
+    }
+    else {
+        raw = source;
+    }
+    if (!isPlainObject(raw)) {
+        invalid('session state must be a plain JSON object', context);
+    }
+    const obj = raw;
+    for (const key of Object.keys(obj)) {
+        if (!KNOWN_SECTIONS.has(key)) {
+            throw new CraftdriverError(ErrorCode.UNSUPPORTED, `unsupported state section ${JSON.stringify(key)} — craftdriver restores ` +
+                `cookies, localStorage, and sessionStorage only`, { detail: storageStateDetail(context, 'validation', { section: key }) });
+        }
+    }
+    validateCookies(obj.cookies, context);
+    validateOriginMap('localStorage', obj.localStorage, context);
+    validateOriginMap('sessionStorage', obj.sessionStorage, context);
+    return obj;
+}
+/** Origins in `map` that actually carry at least one entry. */
+export function nonEmptyOrigins(map) {
+    if (!map)
+        return [];
+    return Object.keys(map).filter((origin) => map[origin] && Object.keys(map[origin]).length > 0);
+}
+/** True when the state carries at least one origin with ≥1 sessionStorage entry. */
+export function hasNonEmptySessionStorage(state) {
+    return nonEmptyOrigins(state.sessionStorage).length > 0;
+}
+/** True when a valid state has no cookie or storage mutations to apply. */
+export function isSessionStateEmpty(state) {
+    return ((state.cookies?.length ?? 0) === 0 &&
+        nonEmptyOrigins(state.localStorage).length === 0 &&
+        nonEmptyOrigins(state.sessionStorage).length === 0);
+}
+/**
+ * Convert a captured cookie into the one canonical restore shape used by every
+ * protocol path. Browser read APIs may report `sameSite: 'default'`, and some
+ * engines report insecure `sameSite: 'none'`; neither can be replayed literally
+ * through all WebDriver cookie commands, so omit sameSite and let the engine
+ * apply its default consistently. `size` is capture-only and is never written.
+ */
+export function normalizeCookieForRestore(cookie) {
+    const normalized = {
+        name: cookie.name,
+        value: cookie.value,
+        domain: cookie.domain,
+    };
+    if (cookie.path !== undefined)
+        normalized.path = cookie.path;
+    if (cookie.httpOnly !== undefined)
+        normalized.httpOnly = cookie.httpOnly;
+    if (cookie.secure !== undefined)
+        normalized.secure = cookie.secure;
+    if (cookie.expiry !== undefined)
+        normalized.expiry = cookie.expiry;
+    if (cookie.sameSite !== undefined &&
+        cookie.sameSite !== 'default' &&
+        !(cookie.sameSite === 'none' && !cookie.secure)) {
+        normalized.sameSite = cookie.sameSite;
+    }
+    return normalized;
+}
+//# sourceMappingURL=sessionStateValidation.js.map

package/dist/lib/sessionStateValidation.js.map

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

package/dist/lib/shadowRoot.d.ts

@@ -0,0 +1,21 @@
+import type { By } from './by.js';
+import type { Driver } from './driver.js';
+import type { WebElement } from './webelement.js';
+/** W3C WebDriver shadow-root reference key. */
+export declare const W3C_SHADOW_ROOT_KEY = "shadow-6066-11e4-a52e-4f735466cecf";
+/**
+ * A WebDriver Classic shadow-root search context.
+ *
+ * This is intentionally internal. The public API exposes the lazy
+ * `ShadowRootLocator`, not a cacheable wire reference that can detach.
+ */
+export declare class ClassicShadowRoot {
+    private driver;
+    private shadowRootId;
+    constructor(driver: Driver, shadowRootId: string);
+    getId(): string;
+    findElement(locator: By): Promise<WebElement>;
+    findElements(locator: By): Promise<WebElement[]>;
+    toJSON(): Record<string, string>;
+}
+//# sourceMappingURL=shadowRoot.d.ts.map

package/dist/lib/shadowRoot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowRoot.d.ts","sourceRoot":"","sources":["../../src/lib/shadowRoot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,+CAA+C;AAC/C,eAAO,MAAM,mBAAmB,uCAAuC,CAAC;AAExE;;;;;GAKG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,YAAY;gBADZ,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM;IAG9B,KAAK,IAAI,MAAM;IAIf,WAAW,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC;IAI7C,YAAY,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAIhD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGjC"}

package/dist/lib/shadowRoot.js

@@ -0,0 +1,29 @@
+/** W3C WebDriver shadow-root reference key. */
+export const W3C_SHADOW_ROOT_KEY = 'shadow-6066-11e4-a52e-4f735466cecf';
+/**
+ * A WebDriver Classic shadow-root search context.
+ *
+ * This is intentionally internal. The public API exposes the lazy
+ * `ShadowRootLocator`, not a cacheable wire reference that can detach.
+ */
+export class ClassicShadowRoot {
+    driver;
+    shadowRootId;
+    constructor(driver, shadowRootId) {
+        this.driver = driver;
+        this.shadowRootId = shadowRootId;
+    }
+    getId() {
+        return this.shadowRootId;
+    }
+    findElement(locator) {
+        return this.driver.findElementFromShadowRoot(this.shadowRootId, locator);
+    }
+    findElements(locator) {
+        return this.driver.findElementsFromShadowRoot(this.shadowRootId, locator);
+    }
+    toJSON() {
+        return { [W3C_SHADOW_ROOT_KEY]: this.shadowRootId };
+    }
+}
+//# sourceMappingURL=shadowRoot.js.map

package/dist/lib/shadowRoot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowRoot.js","sourceRoot":"","sources":["../../src/lib/shadowRoot.ts"],"names":[],"mappings":"AAIA,+CAA+C;AAC/C,MAAM,CAAC,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AAExE;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IAElB;IACA;IAFV,YACU,MAAc,EACd,YAAoB;QADpB,WAAM,GAAN,MAAM,CAAQ;QACd,iBAAY,GAAZ,YAAY,CAAQ;IAC3B,CAAC;IAEJ,KAAK;QACH,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,WAAW,CAAC,OAAW;QACrB,OAAO,IAAI,CAAC,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC3E,CAAC;IAED,YAAY,CAAC,OAAW;QACtB,OAAO,IAAI,CAAC,MAAM,CAAC,0BAA0B,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM;QACJ,OAAO,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;IACtD,CAAC;CACF"}

package/dist/lib/shadowRootLocator.d.ts

@@ -0,0 +1,31 @@
+import { By, type ExactLocatorOptions, type RoleLocatorOptions } from './by.js';
+import type { Driver } from './driver.js';
+import { ElementHandle } from './elementHandle.js';
+import { Locator } from './locator.js';
+import { QueryEnvironment, type SearchRootPlan } from './query.js';
+/**
+ * Lazy, explicit search context for one open ShadowRoot.
+ *
+ * It deliberately exposes lookup methods only: a ShadowRoot is a document
+ * fragment, not an actionable element.
+ */
+export declare class ShadowRootLocator {
+    private driver;
+    private root;
+    private getDefaultTimeout;
+    private environment;
+    constructor(driver: Driver, root: SearchRootPlan, getDefaultTimeout: () => number, environment: QueryEnvironment);
+    locator(selector: string | By): Locator;
+    find(selector: string | By): ElementHandle;
+    findAll(selector: string | By): Promise<ElementHandle[]>;
+    getByRole(role: string, options?: RoleLocatorOptions): Locator;
+    getByText(text: string, options?: {
+        exact?: boolean;
+    }): Locator;
+    getByLabel(text: string, options?: ExactLocatorOptions): Locator;
+    getByPlaceholder(text: string, options?: ExactLocatorOptions): Locator;
+    getByAltText(text: string, options?: ExactLocatorOptions): Locator;
+    getByTitle(text: string, options?: ExactLocatorOptions): Locator;
+    getByTestId(id: string): Locator;
+}
+//# sourceMappingURL=shadowRootLocator.d.ts.map

package/dist/lib/shadowRootLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowRootLocator.d.ts","sourceRoot":"","sources":["../../src/lib/shadowRootLocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EACL,gBAAgB,EAEhB,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,iBAAiB;IACzB,OAAO,CAAC,WAAW;gBAHX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,cAAc,EACpB,iBAAiB,EAAE,MAAM,MAAM,EAC/B,WAAW,EAAE,gBAAgB;IAGvC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO;IAUvC,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,GAAG,aAAa;IAUpC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAI9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO;IAI9D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAI/D,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO;IAIhE,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO;IAItE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO;IAIlE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO;IAIhE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;CAGjC"}

package/dist/lib/shadowRootLocator.js

@@ -0,0 +1,55 @@
+import { By } from './by.js';
+import { ElementHandle } from './elementHandle.js';
+import { Locator } from './locator.js';
+import { createLocatorPlan, } from './query.js';
+/**
+ * Lazy, explicit search context for one open ShadowRoot.
+ *
+ * It deliberately exposes lookup methods only: a ShadowRoot is a document
+ * fragment, not an actionable element.
+ */
+export class ShadowRootLocator {
+    driver;
+    root;
+    getDefaultTimeout;
+    environment;
+    constructor(driver, root, getDefaultTimeout, environment) {
+        this.driver = driver;
+        this.root = root;
+        this.getDefaultTimeout = getDefaultTimeout;
+        this.environment = environment;
+    }
+    locator(selector) {
+        const by = typeof selector === 'string' ? By.css(selector) : selector;
+        return Locator.fromPlan(this.driver, createLocatorPlan(by, this.root), this.getDefaultTimeout, this.environment);
+    }
+    find(selector) {
+        const locator = this.locator(selector);
+        return ElementHandle.fromTarget(this.driver, { kind: 'locator', plan: locator._queryPlan() }, this.getDefaultTimeout, this.environment);
+    }
+    async findAll(selector) {
+        return this.locator(selector).all();
+    }
+    getByRole(role, options) {
+        return this.locator(By.role(role, options));
+    }
+    getByText(text, options) {
+        return this.locator(By.text(text, options));
+    }
+    getByLabel(text, options) {
+        return this.locator(By.labelText(text, options));
+    }
+    getByPlaceholder(text, options) {
+        return this.locator(By.placeholder(text, options));
+    }
+    getByAltText(text, options) {
+        return this.locator(By.altText(text, options));
+    }
+    getByTitle(text, options) {
+        return this.locator(By.title(text, options));
+    }
+    getByTestId(id) {
+        return this.locator(By.testId(id));
+    }
+}
+//# sourceMappingURL=shadowRootLocator.js.map

package/dist/lib/shadowRootLocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadowRootLocator.js","sourceRoot":"","sources":["../../src/lib/shadowRootLocator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAqD,MAAM,SAAS,CAAC;AAEhF,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAEL,iBAAiB,GAElB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IAElB;IACA;IACA;IACA;IAJV,YACU,MAAc,EACd,IAAoB,EACpB,iBAA+B,EAC/B,WAA6B;QAH7B,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAgB;QACpB,sBAAiB,GAAjB,iBAAiB,CAAc;QAC/B,gBAAW,GAAX,WAAW,CAAkB;IACpC,CAAC;IAEJ,OAAO,CAAC,QAAqB;QAC3B,MAAM,EAAE,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACtE,OAAO,OAAO,CAAC,QAAQ,CACrB,IAAI,CAAC,MAAM,EACX,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,EAChC,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,WAAW,CACjB,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,QAAqB;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACvC,OAAO,aAAa,CAAC,UAAU,CAC7B,IAAI,CAAC,MAAM,EACX,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE,EAAE,EAC/C,IAAI,CAAC,iBAAiB,EACtB,IAAI,CAAC,WAAW,CACjB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,QAAqB;QACjC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,CAAC;IACtC,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,OAA4B;QAClD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,SAAS,CAAC,IAAY,EAAE,OAA6B;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,OAA6B;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,OAA6B;QAC1D,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,CAAC;IAED,YAAY,CAAC,IAAY,EAAE,OAA6B;QACtD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IACjD,CAAC;IAED,UAAU,CAAC,IAAY,EAAE,OAA6B;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAC/C,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/lib/timing.d.ts

@@ -117,8 +117,8 @@ export declare const SESSION_CREATE_BACKOFF_STEP_MS = 500;
  * a barrier the BiDi side respects — an immediately following `{ context }`
  * script call can land while BiDi is still swapping the old realm for the new
  * one. The error is pre-execution (the script never ran, no side effects), so a
- * short retry that re-resolves the context is safe. See
- * plans/TODO-bidi-first-navigation.md (Option A).
+ * short retry that re-resolves the context is safe. The injected-error
+ * regression case lives in `tests/evaluate.test.ts`.
  */
 export declare const EVAL_REALM_RETRY_ATTEMPTS = 3;
 export declare const EVAL_REALM_RETRY_DELAY_MS = 25;

package/dist/lib/timing.js

@@ -121,8 +121,8 @@ export const SESSION_CREATE_BACKOFF_STEP_MS = 500;
  * a barrier the BiDi side respects — an immediately following `{ context }`
  * script call can land while BiDi is still swapping the old realm for the new
  * one. The error is pre-execution (the script never ran, no side effects), so a
- * short retry that re-resolves the context is safe. See
- * plans/TODO-bidi-first-navigation.md (Option A).
+ * short retry that re-resolves the context is safe. The injected-error
+ * regression case lives in `tests/evaluate.test.ts`.
  */
 export const EVAL_REALM_RETRY_ATTEMPTS = 3;
 export const EVAL_REALM_RETRY_DELAY_MS = 25;

package/dist/lib/tracing.d.ts

@@ -97,6 +97,7 @@ export type TraceEvent = {
 };
 export declare class Tracer {
     private browserName;
+    private isInternalContext;
     private browser;
     private conn;
     private startedAtMs;
@@ -113,7 +114,7 @@ export declare class Tracer {
     private actionIndex;
     /** Tracks in-flight screenshot captures so `stop()` can drain them. */
     private pendingCaptures;
-    constructor(browser: Browser, conn: BiDiConnection, browserName: string);
+    constructor(browser: Browser, conn: BiDiConnection, browserName: string, isInternalContext?: (context: string | null | undefined) => boolean);
     get isRunning(): boolean;
     start(opts: TraceStartOptions): Promise<void>;
     /**

package/dist/lib/tracing.d.ts.map

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

package/dist/lib/tracing.js

@@ -16,6 +16,7 @@ import { join } from 'node:path';
 import { writeVibiumTraceZip } from './vibiumTrace.js';
 export class Tracer {
     browserName;
+    isInternalContext;
     browser;
     conn;
     startedAtMs = 0;
@@ -32,8 +33,9 @@ export class Tracer {
     actionIndex = 0;
     /** Tracks in-flight screenshot captures so `stop()` can drain them. */
     pendingCaptures = [];
-    constructor(browser, conn, browserName) {
+    constructor(browser, conn, browserName, isInternalContext = () => false) {
         this.browserName = browserName;
+        this.isInternalContext = isInternalContext;
         this.browser = browser;
         this.conn = conn;
     }
@@ -86,6 +88,9 @@ export class Tracer {
         if (consoleOn) {
             this.unsubs.push(this.conn.on('log.entryAdded', (params) => {
                 const p = params;
+                const source = (p.source ?? {});
+                if (this.isInternalContext(source.context))
+                    return;
                 const text = String(p.text ?? '');
                 if (p.type === 'console') {
                     this.push({ type: 'console', level: String(p.level ?? 'info'), text });
@@ -100,6 +105,8 @@ export class Tracer {
         if (networkOn) {
             this.unsubs.push(this.conn.on('network.beforeRequestSent', (params) => {
                 const p = params;
+                if (this.isInternalContext(p.context))
+                    return;
                 const req = (p.request ?? {});
                 this.push({
                     type: 'request',
@@ -110,6 +117,8 @@ export class Tracer {
             }));
             this.unsubs.push(this.conn.on('network.responseCompleted', (params) => {
                 const p = params;
+                if (this.isInternalContext(p.context))
+                    return;
                 const req = (p.request ?? {});
                 const res = (p.response ?? {});
                 const ev = {
@@ -128,6 +137,8 @@ export class Tracer {
         }
         this.unsubs.push(this.conn.on('browsingContext.navigationStarted', (params) => {
             const p = params;
+            if (this.isInternalContext(p.context))
+                return;
             this.push({
                 type: 'navigation',
                 url: String(p.url ?? ''),