@webhands/core 0.4.0 → 0.6.0

package/dist/session-rpc.d.ts

@@ -1,4 +1,4 @@
-import { type Cookie, type WaitCondition } from './seam.js';
+import { type ActionOptions, type Cookie, type MouseInput, type QueryOptions, type ScreenshotOptions, type ScrollTarget, type SelectChoice, type WaitCondition } from './seam.js';
 import type { WebHandsPage } from './seam.js';
 /**
  * The wire protocol for driving the long-lived session over HTTP (ADR-0005).
@@ -59,13 +59,28 @@ export type SessionRpcBuiltInRequest = {
 } | {
     readonly verb: 'click';
     readonly locator: string;
+    /**
+     * Optional {@link ActionOptions}: `{byRef: true}` marks `locator` as a
+     * durable `query` `ref` so the server resolves it with the loud-stale
+     * EXACTLY-ONE contract ({@link StaleRefError}). Omitted == plain locator
+     * click (additive, R1).
+     */
+    readonly options?: ActionOptions;
 } | {
     readonly verb: 'type';
     readonly locator: string;
     readonly text: string;
+    /** Optional {@link ActionOptions} (`{byRef}`); see the `click` request. */
+    readonly options?: ActionOptions;
 } | {
     readonly verb: 'eval';
     readonly expression: string;
+    /**
+     * Optional SAME-ORIGIN child-frame selector to evaluate in (Tier-3 frame
+     * scope). A plain string on the wire; the server passes it as the seam
+     * {@link EvalOptions.frame}. Omitted == top-document `eval`.
+     */
+    readonly frame?: string;
 } | {
     readonly verb: 'wait';
     readonly condition: WaitCondition;
@@ -74,6 +89,53 @@ export type SessionRpcBuiltInRequest = {
 } | {
     readonly verb: 'setCookies';
     readonly cookies: readonly Cookie[];
+} | {
+    readonly verb: 'query';
+    readonly locator: string;
+    readonly options?: QueryOptions;
+} | {
+    readonly verb: 'count';
+    readonly locator: string;
+} | {
+    readonly verb: 'exists';
+    readonly locator: string;
+} | {
+    readonly verb: 'isVisible';
+    readonly locator: string;
+} | {
+    readonly verb: 'getAttribute';
+    readonly locator: string;
+    readonly name: string;
+} | {
+    readonly verb: 'press';
+    readonly key: string;
+    readonly locator?: string;
+} | {
+    readonly verb: 'hover';
+    readonly locator: string;
+} | {
+    readonly verb: 'select';
+    readonly locator: string;
+    readonly choice: SelectChoice;
+} | {
+    readonly verb: 'scroll';
+    readonly target: ScrollTarget;
+} | {
+    readonly verb: 'drag';
+    readonly source: string;
+    readonly target: string;
+} | {
+    readonly verb: 'mouse';
+    readonly input: MouseInput;
+} | {
+    readonly verb: 'screenshot';
+    /**
+     * The {@link ScreenshotOptions}, flattened onto the request. `locator`
+     * (the `element` scope's clip target) is a branded {@link LocatorString}
+     * that JSON flattens to a plain string; the server re-brands it with
+     * {@link locator}. No image bytes ever cross — only the path comes back.
+     */
+    readonly options?: ScreenshotOptions;
 };
 /**
  * The OPEN escape for a dynamically-loaded third-party hand verb (Phase 2,

package/dist/session-rpc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-rpc.d.ts","sourceRoot":"","sources":["../src/session-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,MAAM,EAEX,KAAK,aAAa,EAClB,MAAM,WAAW,CAAC;AACnB,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,WAAW,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,kBAAkB,CAAC;AAEhD,8DAA8D;AAC9D,MAAM,MAAM,iBAAiB,GAC1B,wBAAwB,GACxB,qBAAqB,CAAC;AAEzB;;;;GAIG;AACH,MAAM,MAAM,wBAAwB,GACjC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAC,GACjD;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAC,GACpD;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAC,GAClD;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAC,GACxE;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAC,GACpD;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;CAAC,GAC1D;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAC,GAC1B;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAC,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,qBAAqB;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC3B;IAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAC,GAC7C;IAAC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAC,CAAC;AAEhD;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACpC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAmCD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,GACpD,YAAY,CA8Bd;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CACjC,IAAI,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,OAAO,CAAC,EACtD,IAAI,EAAE,MAAM,EACZ,GAAG,IAAI,EAAE,SAAS,OAAO,EAAE,GACzB,OAAO,CAAC,OAAO,CAAC,CAElB"}
+{"version":3,"file":"session-rpc.d.ts","sourceRoot":"","sources":["../src/session-rpc.ts"],"names":[],"mappings":"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"}

package/dist/session-rpc.js

@@ -1,4 +1,4 @@
-import { locator, } from './seam.js';
+import { locator, validateSnapshotOptions, } from './seam.js';
 /**
  * The wire protocol for driving the long-lived session over HTTP (ADR-0005).
  *
@@ -58,15 +58,25 @@ export async function applySessionRpc(page, request) {
             await page.navigate(request.url);
             return undefined;
         case 'snapshot':
-            return page.snapshot({ full: request.full });
+            // Validate on the SERVER side so a malformed request from ANY client
+            // (not just the typed `makeRpcPage`) is rejected faithfully across the
+            // seam, mirroring how a page/eval throw rejects. A raw client could POST
+            // e.g. `{verb: 'snapshot', view: 'full'}`; we rebuild the snapshot
+            // options from the request's non-`verb` keys and reject unknown ones
+            // rather than silently dropping them and returning the wrong view.
+            return page.snapshot(snapshotOptionsFromRequest(request));
         case 'click':
-            await page.click(locator(request.locator));
+            // Forward the optional ActionOptions only when given, so a plain-locator
+            // click stays `click(target)` (the byRef path is opt-in).
+            await page.click(locator(request.locator), request.options !== undefined ? request.options : undefined);
             return undefined;
         case 'type':
-            await page.type(locator(request.locator), request.text);
+            await page.type(locator(request.locator), request.text, request.options !== undefined ? request.options : undefined);
             return undefined;
         case 'eval':
-            return page.eval(request.expression);
+            // Forward the optional frame selector only when present, so a bare
+            // top-document eval stays `eval(expression)` (no options object).
+            return page.eval(request.expression, request.frame !== undefined ? { frame: request.frame } : undefined);
         case 'wait':
             await page.wait(rebrandWait(request.condition));
             return undefined;
@@ -75,10 +85,64 @@ export async function applySessionRpc(page, request) {
         case 'setCookies':
             await page.setCookies(request.cookies);
             return undefined;
+        case 'query':
+            return page.query(locator(request.locator), request.options);
+        case 'count':
+            return page.count(locator(request.locator));
+        case 'exists':
+            return page.exists(locator(request.locator));
+        case 'isVisible':
+            return page.isVisible(locator(request.locator));
+        case 'getAttribute':
+            return page.getAttribute(locator(request.locator), request.name);
+        case 'press':
+            await page.press(request.key, request.locator !== undefined ? locator(request.locator) : undefined);
+            return undefined;
+        case 'hover':
+            await page.hover(locator(request.locator));
+            return undefined;
+        case 'select':
+            await page.select(locator(request.locator), request.choice);
+            return undefined;
+        case 'scroll':
+            await page.scroll(rebrandScroll(request.target));
+            return undefined;
+        case 'drag':
+            await page.drag(locator(request.source), locator(request.target));
+            return undefined;
+        case 'mouse':
+            await page.mouse(request.input);
+            return undefined;
+        case 'screenshot':
+            // Re-brand the `element`-scope clip locator (plain string over the wire)
+            // before it reaches the page; the rest of the options are plain. Only the
+            // returned {path,width,height} crosses back — never image bytes.
+            return page.screenshot(rebrandScreenshot(request.options));
         case 'hand':
             return applyHandVerb(page, request);
     }
 }
+/**
+ * Rebuild and validate the {@link SnapshotOptions} carried by a wire `snapshot`
+ * request. The wire flattens `{full}` onto the request alongside `verb`; a raw
+ * (untyped) client may also send a misspelled key such as `view`. We collect
+ * every non-`verb` key into an options object and run it through the shared
+ * {@link validateSnapshotOptions} so the server rejects an unknown/misshapen
+ * option exactly as the in-process host does. Returns `undefined` when no
+ * options were sent (the bare `snapshot()` case).
+ */
+function snapshotOptionsFromRequest(request) {
+    const { verb: _verb, ...rest } = request;
+    // Drop an explicitly-absent `full` (the typed client always sends the key,
+    // even as `undefined`) so a bare `snapshot()` stays `undefined`.
+    if ('full' in rest && rest.full === undefined) {
+        delete rest.full;
+    }
+    if (Object.keys(rest).length === 0) {
+        return undefined;
+    }
+    return validateSnapshotOptions(rest);
+}
 /**
  * Invoke a dynamically-loaded hand verb by name against the live composed page.
  *
@@ -118,19 +182,41 @@ export function makeRpcPage(send) {
             await send({ verb: 'navigate', url });
         },
         async snapshot(options) {
+            // Fail fast on the client too, so a typed caller's mistake (e.g.
+            // `{view: 'full'}`) is caught before a round-trip. The server
+            // re-validates as the load-bearing check for untyped clients.
+            validateSnapshotOptions(options);
             return (await send({
                 verb: 'snapshot',
                 full: options?.full,
             }));
         },
-        async click(target) {
-            await send({ verb: 'click', locator: target });
+        async click(target, options) {
+            // Carry the optional ActionOptions only when given, so a plain click sends
+            // no `options` key (mirrors `eval`'s optional frame).
+            await send({
+                verb: 'click',
+                locator: target,
+                ...(options !== undefined ? { options } : {}),
+            });
         },
-        async type(target, text) {
-            await send({ verb: 'type', locator: target, text });
+        async type(target, text, options) {
+            await send({
+                verb: 'type',
+                locator: target,
+                text,
+                ...(options !== undefined ? { options } : {}),
+            });
         },
-        async eval(expression) {
-            return send({ verb: 'eval', expression });
+        async eval(expression, options) {
+            // Carry the optional frame selector only when given, so the focused
+            // top-document form sends no `frame` key (mirrors `press`'s optional
+            // locator).
+            return send({
+                verb: 'eval',
+                expression,
+                ...(options?.frame !== undefined ? { frame: options.frame } : {}),
+            });
         },
         async wait(condition) {
             await send({ verb: 'wait', condition });
@@ -141,6 +227,59 @@ export function makeRpcPage(send) {
         async setCookies(cookies) {
             await send({ verb: 'setCookies', cookies });
         },
+        async query(target, options) {
+            return (await send({
+                verb: 'query',
+                locator: target,
+                options,
+            }));
+        },
+        async count(target) {
+            return (await send({ verb: 'count', locator: target }));
+        },
+        async exists(target) {
+            return (await send({ verb: 'exists', locator: target }));
+        },
+        async isVisible(target) {
+            return (await send({ verb: 'isVisible', locator: target }));
+        },
+        async getAttribute(target, name) {
+            return (await send({
+                verb: 'getAttribute',
+                locator: target,
+                name,
+            }));
+        },
+        async press(key, target) {
+            // Forward the optional locator only when given, so the wire request stays
+            // minimal (the focused-element form carries no locator key).
+            await send({
+                verb: 'press',
+                key,
+                ...(target !== undefined ? { locator: target } : {}),
+            });
+        },
+        async hover(target) {
+            await send({ verb: 'hover', locator: target });
+        },
+        async select(target, choice) {
+            await send({ verb: 'select', locator: target, choice });
+        },
+        async scroll(target) {
+            await send({ verb: 'scroll', target });
+        },
+        async drag(source, target) {
+            await send({ verb: 'drag', source, target });
+        },
+        async mouse(input) {
+            await send({ verb: 'mouse', input });
+        },
+        async screenshot(options) {
+            return (await send({
+                verb: 'screenshot',
+                ...(options !== undefined ? { options } : {}),
+            }));
+        },
     };
 }
 /**
@@ -172,4 +311,28 @@ function rebrandWait(condition) {
     }
     return condition;
 }
+/**
+ * Re-brand a {@link ScrollTarget} that arrived as plain JSON: only the `to` form
+ * carries a branded {@link LocatorString}, flattened to a plain `string` over
+ * the wire, so we re-tag it before it reaches the page (mirrors
+ * {@link rebrandWait}). The `by` form carries only plain numbers.
+ */
+function rebrandScroll(target) {
+    if ('to' in target) {
+        return { to: locator(target.to) };
+    }
+    return target;
+}
+/**
+ * Re-brand a {@link ScreenshotOptions} that arrived as plain JSON: only the
+ * `element`-scope `locator` carries a branded {@link LocatorString}, flattened
+ * to a plain `string` over the wire, so we re-tag it before it reaches the page
+ * (mirrors {@link rebrandWait}/{@link rebrandScroll}). `scope`/`out` are plain.
+ */
+function rebrandScreenshot(options) {
+    if (options?.locator === undefined) {
+        return options;
+    }
+    return { ...options, locator: locator(options.locator) };
+}
 //# sourceMappingURL=session-rpc.js.map

package/dist/session-rpc.js.map

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

package/dist/socks-proxy.d.ts

@@ -0,0 +1,61 @@
+/**
+ * A parsed SOCKS proxy ready to hand to Playwright/Chromium.
+ *
+ * This is the SINGLE place webhands turns a user-facing `--proxy` SOCKS URL into
+ * the concrete launch inputs Chromium needs: the `proxy.server`/credentials
+ * Playwright forwards, plus the extra command-line arg that forces DNS through
+ * the proxy (no DNS leak). Keeping the brittle parsing + Chromium-flag knowledge
+ * in one module mirrors how the launch transport confines its other
+ * Playwright/Chromium details.
+ */
+export interface ParsedSocksProxy {
+    /**
+     * The Playwright `proxy.server` value, always normalized to `socks5://host:port`.
+     *
+     * Chromium's `--proxy-server` understands `socks5://` but NOT the `socks5h://`
+     * convention, so we normalize the scheme here and carry the "resolve DNS at
+     * the proxy / block local DNS" intent separately in {@link noLeak} instead of
+     * in the scheme string.
+     */
+    readonly server: string;
+    /** Optional proxy username (from a `user:pass@` userinfo component). */
+    readonly username?: string;
+    /** Optional proxy password (from a `user:pass@` userinfo component). */
+    readonly password?: string;
+    /** The proxy host, used to build the DNS catch-all EXCLUDE rule. */
+    readonly host: string;
+    /**
+     * Whether to enforce NO local DNS (force every hostname to resolve at the
+     * proxy). When `true`, the transport adds a `--host-resolver-rules` catch-all
+     * so even Chromium components that bypass `--proxy-server` (DNS prefetcher,
+     * etc.) cannot leak a raw DNS query (see {@link hostResolverRulesArg}).
+     */
+    readonly noLeak: boolean;
+}
+/**
+ * Parse a user-facing `--proxy` SOCKS URL into a {@link ParsedSocksProxy}.
+ *
+ * Accepts `socks5h://`, `socks5://`, or `socks://` with a host and port and an
+ * optional `user:pass@` userinfo. Anything else (missing host/port, an http(s)
+ * proxy, a bare host with no scheme) is a typed {@link InvalidProxyError} so the
+ * caller refuses LOUDLY rather than launching unproxied.
+ *
+ * `forceNoLeak`, when set, overrides the scheme's implied DNS behaviour: pass
+ * `true` to enforce no local DNS even for a plain `socks5://` URL, or `false` to
+ * allow local DNS even for `socks5h://`. When omitted, the SCHEME decides
+ * (`socks5h` => no-leak, `socks5`/`socks` => local DNS allowed).
+ */
+export declare function parseSocksProxy(value: string, forceNoLeak?: boolean): ParsedSocksProxy;
+/**
+ * Build the Chromium `--host-resolver-rules` argument that prevents ANY local
+ * DNS resolution, the catch-all the Chromium SOCKS design doc prescribes for a
+ * leak-free SOCKS proxy.
+ *
+ * `MAP * ~NOTFOUND` maps every hostname to an invalid address so Chromium never
+ * issues a real local DNS query; `EXCLUDE <host>` lets Chromium still resolve
+ * the proxy server's own address (otherwise every request fails with
+ * PROXY_CONNECTION_FAILED). URL loads themselves resolve at the proxy via
+ * `--proxy-server`; this arg closes the side channels (DNS prefetcher, etc.).
+ */
+export declare function hostResolverRulesArg(host: string): string;
+//# sourceMappingURL=socks-proxy.d.ts.map

package/dist/socks-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socks-proxy.d.ts","sourceRoot":"","sources":["../src/socks-proxy.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CACzB;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC9B,KAAK,EAAE,MAAM,EACb,WAAW,CAAC,EAAE,OAAO,GACnB,gBAAgB,CAuClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/socks-proxy.js

@@ -0,0 +1,84 @@
+import { InvalidProxyError } from './errors.js';
+/**
+ * The SOCKS schemes we accept on a `--proxy` value.
+ *
+ * - `socks5h://` is the widely-used convention meaning "resolve DNS at the
+ *   proxy" (no local DNS, no leak). We map it to {@link ParsedSocksProxy.noLeak}
+ *   `true`.
+ * - `socks5://` means "SOCKS5, local DNS allowed" by the same convention. NOTE:
+ *   Chromium ALREADY resolves URL hostnames at the proxy under `--proxy-server`,
+ *   but other components (the DNS prefetcher) can still issue raw local DNS, so
+ *   plain `socks5://` does NOT by itself guarantee no leak.
+ *
+ * `socks://` is accepted as an alias for `socks5://` (some tools emit it).
+ */
+const SCHEME_NO_LEAK = {
+    'socks5h:': true,
+    'socks5:': false,
+    'socks:': false,
+};
+/**
+ * Parse a user-facing `--proxy` SOCKS URL into a {@link ParsedSocksProxy}.
+ *
+ * Accepts `socks5h://`, `socks5://`, or `socks://` with a host and port and an
+ * optional `user:pass@` userinfo. Anything else (missing host/port, an http(s)
+ * proxy, a bare host with no scheme) is a typed {@link InvalidProxyError} so the
+ * caller refuses LOUDLY rather than launching unproxied.
+ *
+ * `forceNoLeak`, when set, overrides the scheme's implied DNS behaviour: pass
+ * `true` to enforce no local DNS even for a plain `socks5://` URL, or `false` to
+ * allow local DNS even for `socks5h://`. When omitted, the SCHEME decides
+ * (`socks5h` => no-leak, `socks5`/`socks` => local DNS allowed).
+ */
+export function parseSocksProxy(value, forceNoLeak) {
+    const trimmed = value.trim();
+    if (trimmed === '') {
+        throw new InvalidProxyError(value);
+    }
+    let url;
+    try {
+        url = new URL(trimmed);
+    }
+    catch (cause) {
+        throw new InvalidProxyError(value, undefined, { cause });
+    }
+    const schemeNoLeak = SCHEME_NO_LEAK[url.protocol];
+    if (schemeNoLeak === undefined) {
+        // Not a SOCKS scheme (e.g. http://, https://, socks4://, or no scheme).
+        throw new InvalidProxyError(value);
+    }
+    if (url.hostname === '' || url.port === '') {
+        // A host AND an explicit port are both required: Chromium's --proxy-server
+        // needs the port, and we will not guess a default.
+        throw new InvalidProxyError(value);
+    }
+    const noLeak = forceNoLeak ?? schemeNoLeak;
+    const server = `socks5://${url.hostname}:${url.port}`;
+    const proxy = {
+        server,
+        host: url.hostname,
+        noLeak,
+        ...(url.username !== ''
+            ? { username: decodeURIComponent(url.username) }
+            : {}),
+        ...(url.password !== ''
+            ? { password: decodeURIComponent(url.password) }
+            : {}),
+    };
+    return proxy;
+}
+/**
+ * Build the Chromium `--host-resolver-rules` argument that prevents ANY local
+ * DNS resolution, the catch-all the Chromium SOCKS design doc prescribes for a
+ * leak-free SOCKS proxy.
+ *
+ * `MAP * ~NOTFOUND` maps every hostname to an invalid address so Chromium never
+ * issues a real local DNS query; `EXCLUDE <host>` lets Chromium still resolve
+ * the proxy server's own address (otherwise every request fails with
+ * PROXY_CONNECTION_FAILED). URL loads themselves resolve at the proxy via
+ * `--proxy-server`; this arg closes the side channels (DNS prefetcher, etc.).
+ */
+export function hostResolverRulesArg(host) {
+    return `--host-resolver-rules=MAP * ~NOTFOUND , EXCLUDE ${host}`;
+}
+//# sourceMappingURL=socks-proxy.js.map

package/dist/socks-proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socks-proxy.js","sourceRoot":"","sources":["../src/socks-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,aAAa,CAAC;AAqC9C;;;;;;;;;;;;GAYG;AACH,MAAM,cAAc,GAAsC;IACzD,UAAU,EAAE,IAAI;IAChB,SAAS,EAAE,KAAK;IAChB,QAAQ,EAAE,KAAK;CACf,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC9B,KAAa,EACb,WAAqB;IAErB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,GAAQ,CAAC;IACb,IAAI,CAAC;QACJ,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,EAAC,KAAK,EAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAChC,wEAAwE;QACxE,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,EAAE,IAAI,GAAG,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;QAC5C,2EAA2E;QAC3E,mDAAmD;QACnD,MAAM,IAAI,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,IAAI,YAAY,CAAC;IAC3C,MAAM,MAAM,GAAG,YAAY,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;IAEtD,MAAM,KAAK,GAAqB;QAC/B,MAAM;QACN,IAAI,EAAE,GAAG,CAAC,QAAQ;QAClB,MAAM;QACN,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE;YACtB,CAAC,CAAC,EAAC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAC;YAC9C,CAAC,CAAC,EAAE,CAAC;QACN,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE;YACtB,CAAC,CAAC,EAAC,QAAQ,EAAE,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAC;YAC9C,CAAC,CAAC,EAAE,CAAC;KACN,CAAC;IACF,OAAO,KAAK,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAChD,OAAO,mDAAmD,IAAI,EAAE,CAAC;AAClE,CAAC"}

package/dist/stub-transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stub-transport.d.ts","sourceRoot":"","sources":["../src/stub-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEX,UAAU,EACV,YAAY,EACZ,OAAO,EAGP,SAAS,EAET,MAAM,WAAW,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,YAAY,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAM;IAE1B,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;CA4EhD"}
+{"version":3,"file":"stub-transport.d.ts","sourceRoot":"","sources":["../src/stub-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKX,UAAU,EACV,YAAY,EAOZ,OAAO,EAGP,SAAS,EAET,MAAM,WAAW,CAAC;AAGnB;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,YAAY,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CAClC;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,SAAS;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAM;IAE1B,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;CA+IhD"}

package/dist/stub-transport.js

@@ -1,3 +1,4 @@
+import { validateSnapshotOptions } from './seam.js';
 /**
  * An in-process, no-op {@link Transport} used to exercise the SEAM SHAPE
  * without a real browser. It is NOT the Playwright transport (that lands in a
@@ -35,6 +36,7 @@ export class StubTransport {
             },
             async snapshot(options) {
                 ensureOpen();
+                validateSnapshotOptions(options);
                 calls.push({ verb: 'snapshot', args: [options] });
                 return {
                     url,
@@ -42,17 +44,26 @@ export class StubTransport {
                     content: '',
                 };
             },
-            async click(t) {
+            async click(t, options) {
                 ensureOpen();
-                calls.push({ verb: 'click', args: [t] });
+                // Record the ActionOptions only when given, so a plain-locator click
+                // stays `[t]` (the existing seam assertions) and a `{byRef}` click
+                // records `[t, {byRef: true}]`.
+                calls.push({
+                    verb: 'click',
+                    args: options !== undefined ? [t, options] : [t],
+                });
             },
-            async type(t, text) {
+            async type(t, text, options) {
                 ensureOpen();
-                calls.push({ verb: 'type', args: [t, text] });
+                calls.push({
+                    verb: 'type',
+                    args: options !== undefined ? [t, text, options] : [t, text],
+                });
             },
-            async eval(expression) {
+            async eval(expression, options) {
                 ensureOpen();
-                calls.push({ verb: 'eval', args: [expression] });
+                calls.push({ verb: 'eval', args: [expression, options] });
                 return undefined;
             },
             async wait(condition) {
@@ -68,6 +79,63 @@ export class StubTransport {
                 ensureOpen();
                 calls.push({ verb: 'setCookies', args: [cookies] });
             },
+            async query(t, options) {
+                ensureOpen();
+                calls.push({ verb: 'query', args: [t, options] });
+                return [];
+            },
+            async count(t) {
+                ensureOpen();
+                calls.push({ verb: 'count', args: [t] });
+                return 0;
+            },
+            async exists(t) {
+                ensureOpen();
+                calls.push({ verb: 'exists', args: [t] });
+                return false;
+            },
+            async isVisible(t) {
+                ensureOpen();
+                calls.push({ verb: 'isVisible', args: [t] });
+                return false;
+            },
+            async getAttribute(t, name) {
+                ensureOpen();
+                calls.push({ verb: 'getAttribute', args: [t, name] });
+                return null;
+            },
+            async press(key, t) {
+                ensureOpen();
+                calls.push({ verb: 'press', args: [key, t] });
+            },
+            async hover(t) {
+                ensureOpen();
+                calls.push({ verb: 'hover', args: [t] });
+            },
+            async select(t, choice) {
+                ensureOpen();
+                calls.push({ verb: 'select', args: [t, choice] });
+            },
+            async scroll(t) {
+                ensureOpen();
+                calls.push({ verb: 'scroll', args: [t] });
+            },
+            async drag(source, t) {
+                ensureOpen();
+                calls.push({ verb: 'drag', args: [source, t] });
+            },
+            async mouse(input) {
+                ensureOpen();
+                calls.push({ verb: 'mouse', args: [input] });
+            },
+            async screenshot(options) {
+                ensureOpen();
+                calls.push({ verb: 'screenshot', args: [options] });
+                // A deterministic stand-in path/dimensions so a wiring test can assert
+                // the verb round-trip + the attachment-capable `path` field WITHOUT a
+                // real browser (no PNG is written; the stub implements no behaviour).
+                return { path: 'stub://screenshot.png', width: 0, height: 0 };
+            },
         };
         return {
             page,

package/dist/stub-transport.js.map

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