@descryy/runtime-browser 0.2.0

package/dist/browser-action-collector.d.ts

@@ -0,0 +1,181 @@
+/**
+ * §7's action vocabulary (navigate/click/type/wait) as a `Collector`.
+ *
+ * Actions are commands, not a passive stream -- the opposite shape from
+ * `LogCollector`/console/network collectors, which push evidence as
+ * external events happen. `Collector.emit` is only ever reachable through
+ * `CollectorContext` passed into `start()` (RT-005: "never exposed
+ * outward"), so this stores that `emit` internally at `start()` and
+ * exposes action methods alongside the three Collector methods, rather
+ * than inventing a second, external emit path.
+ *
+ * `waitFor` deliberately emits nothing: the frozen `RuntimeEventType`
+ * vocabulary has no "wait" event, and a wait is a synchronization
+ * primitive for the driver, not an observable page fact the way a click or
+ * a navigation is.
+ *
+ * `start()` also emits exactly one `PAGE_CREATED`, using `session.startedAt`
+ * — the page's real creation time, not this moment. This is the answer to
+ * the non-goal `browser-session.ts` itself declares (RT-053): the page's
+ * existence is real evidence and this is the one collector already
+ * translating this session's facts into Evidence, so a second, near-empty
+ * collector whose only job was one event type would be structure for its
+ * own sake.
+ *
+ * `select`/`submit`/`inspect`/`assertVisible`/`assertText` (RT-058, §5) fill
+ * the rest of the checklist's action gap without needing a single new
+ * `RuntimeEventType`:
+ *  - `select` reuses `INPUT` (`dom-evidence.ts`'s own reasoning: a select's
+ *    new value is a form-input fact, not a distinct kind of fact).
+ *  - `submit` locates the form's own submit control and calls `click()` on
+ *    it, so it is real `CLICK` evidence of the control the user actually
+ *    activates, not a synthesized event with no vocabulary to be.
+ *  - `inspect`/`assertVisible`/`assertText` emit nothing, the same
+ *    reasoning `waitFor` already established: these are synchronization/
+ *    verification primitives for the driver, not an observable page fact
+ *    the way a click or a navigation is. `inspect` and `assertText` both
+ *    run through `captureElementSnapshot` rather than a second DOM-reading
+ *    path, so "what the collector saw" stays one code path.
+ *
+ * `screenshot` (RT-061) captures the viewport and emits `SCREENSHOT`
+ * (`packages/contracts`, added in the same change as this method, per
+ * RT-053's own lesson: a declared-but-unemitted type is the mistake, not a
+ * type existing at all).
+ *
+ * **Capture is preceded by a best-effort settle wait (RT-221), not a raw,
+ * instant `page.screenshot()`.** The original version fired the instant it
+ * was called -- no network-idle wait, no hydration check -- so a capture
+ * mid-transition (a still-loading page, a spinner not yet replaced by real
+ * content) was stored as ordinary evidence with no signal anything was off.
+ * `waitForSettle()` below waits for Playwright's own `networkidle` load
+ * state (capped short, so a page with continuous background traffic --
+ * polling, a websocket -- degrades to "waited as long as reasonable" rather
+ * than hanging), then two animation-frame ticks so a render queued by the
+ * network response's own handler has actually painted before capture.
+ * **This is not the same failure DEC-D234 (descry-desktop) found and fixed
+ * with a double-capture convergence loop** -- that bug was Electron's
+ * `webContents.capturePage()` returning a stale, pre-mutation frame even
+ * after the DOM had already settled, on a `show: false` window; DEC-D234's
+ * own verification confirms a plain, composited `chromium.launch()` page
+ * (what this collector drives) does not share that compositor-level race.
+ * The gap here runs the other direction -- captured too early, before the
+ * page finishes settling -- so the fix is a settle wait, not a frame
+ * comparison. **Disclosed, not a guarantee:** a DOM mutation scheduled via a
+ * bare `setTimeout`/`setInterval` outside a `requestAnimationFrame`-driven
+ * paint, and firing after this wait completes, is not caught.
+ *
+ * Redaction here does NOT follow the pattern every other method in this file
+ * uses:
+ *
+ *  - The mask is applied at CAPTURE time, via Playwright's real
+ *    pixel-level `page.screenshot({ mask, maskColor })` — every
+ *    `input[type="password"]` on the page by default, plus any
+ *    caller-supplied `maskSelectors`. **Coverage is caller-declared, not
+ *    detected** (§20): this collector has no way to recognize a sensitive
+ *    value that isn't in a password field — a token in a URL bar, a name
+ *    in a table, a body panel left open in dev tools all pass through
+ *    unmasked unless the caller names them.
+ *  - The payload key is `imageBase64`, chosen specifically because it does
+ *    NOT match `evidence-store`'s `BODY_BEARING_KEY_PATTERN`
+ *    (`body|post-data|request-body|response-body|raw`). That pattern's
+ *    `GENERIC_TOKEN_PATTERN` text scanner reads base64 as a wall of
+ *    24+-character tokens and would shred a real image into
+ *    `[REDACTED]==` garbage — it corrupts pixels, it does not redact them.
+ *    This is a deliberate, stated EXEMPTION from store-side scanning, not
+ *    an accident of naming: the capture-time mask above is this payload's
+ *    only real protection. Renaming this key to anything
+ *    `BODY_BEARING_KEY_PATTERN` matches (or renaming a body-bearing key TO
+ *    something like it) silently changes which protection applies and
+ *    must be a deliberate re-decision, not a drive-by rename.
+ *  - The evidence this produces will carry `redactionStatus:
+ *    "not-required"` once `EvidenceStore.write()` runs `redact()` on it —
+ *    same string every OTHER "scanned, found nothing sensitive" case
+ *    produces, but it means something different here: this payload was
+ *    never scanned at all, because a text/JSON scanner cannot read
+ *    pixels. Do not read a screenshot's `not-required` as "this image was
+ *    checked."
+ *
+ * `captureVideo` (video evidence, competitive research proposal) emits
+ * `VIDEO` and is structurally different from every method above it in one
+ * way: it is not something this collector *does* to the page, it is a
+ * report of a fact `browser-session.ts` already finished producing.
+ * Playwright's `recordVideo` starts automatically at context creation (the
+ * `BrowserConfiguration.recordVideo` toggle, `browser-session.ts`) and only
+ * *finishes* the file once the browser context closes — so unlike
+ * `screenshot()`, which can be called any time the page is alive,
+ * `captureVideo()` can only be called **after** `session.close()` has
+ * resolved, and it must be called **before** this collector's own `stop()`
+ * (`stop()` clears `emit`, and there would be nothing left to emit into).
+ * That ordering is the opposite of `stop()`-then-`close()`, which is how
+ * every existing caller in this repo already sequences things — genuinely
+ * different for this one method, not a mistake to unify away, because the
+ * video file cannot exist any earlier.
+ *
+ * Redaction follows `screenshot()`'s exemption for the identical reason:
+ * `videoBase64` does not match `BODY_BEARING_KEY_PATTERN` either, so a real
+ * captured video's bytes reach a reader intact rather than shredded by a
+ * text scanner. There is no capture-time pixel mask here, unlike
+ * `screenshot()` — Playwright's `mask` option applies to `page.screenshot()`
+ * only, not to `recordVideo` — so a caller enabling video evidence should
+ * know it is unmasked footage of whatever the page displayed; that gap is
+ * disclosed, not solved, by this change (see this repo's decision record for
+ * this feature).
+ */
+import type { Collector } from "@descryy/runtime-contracts";
+import type { BrowserSession } from "./browser-session.ts";
+import { type DomElementSnapshot } from "./dom-evidence.ts";
+export interface BrowserActionCollectorOptions {
+    readonly session: BrowserSession;
+    /** Which owned system this collector's evidence should be attributed to (plan §16.7). Null when not applicable. */
+    readonly service?: string;
+}
+export interface WaitForOptions {
+    readonly timeoutMs?: number;
+}
+export interface ScreenshotOptions {
+    /**
+     * Extra selectors to mask, beyond the automatic default of every
+     * `input[type="password"]` on the page. See this module's own header:
+     * coverage is caller-declared, not detected.
+     */
+    readonly maskSelectors?: readonly string[];
+}
+export interface BrowserActionCollector extends Collector {
+    navigate(url: string): Promise<void>;
+    click(selector: string): Promise<void>;
+    /**
+     * **Real keystrokes, appended.** `page.locator().pressSequentially()` --
+     * one key event per character, on top of whatever the field already
+     * contains.
+     *
+     * This used to be `page.fill()`, which meant the package shipped one text
+     * verb wearing two names: "type" that silently replaced. The distinction is
+     * not cosmetic. A field that opens an autocomplete on `keydown`, validates
+     * per character, or debounces a search never sees anything at all from
+     * `fill()`, so a caller reaching for "type" to exercise that behaviour got a
+     * page that had not been typed into. Use `fill()` when the goal is to put a
+     * known value in a field, and this when the goal is to type.
+     */
+    type(selector: string, text: string): Promise<void>;
+    /** **Replaces** the field's contents in one operation (`page.fill()`), firing a single `input` event and no key events. The verb for setting a value, as distinct from `type()`'s verb for typing one. */
+    fill(selector: string, text: string): Promise<void>;
+    select(selector: string, value: string): Promise<void>;
+    submit(formSelector: string): Promise<void>;
+    waitFor(selector: string, options?: WaitForOptions): Promise<void>;
+    inspect(selector: string): Promise<DomElementSnapshot>;
+    assertVisible(selector: string): Promise<void>;
+    assertText(selector: string, expected: string): Promise<void>;
+    screenshot(options?: ScreenshotOptions): Promise<void>;
+    /**
+     * Emits `VIDEO` for this session's finished `recordVideo` file, or emits
+     * nothing at all when the session was never launched with
+     * `recordVideo: true` (see this module's own header for why -- there is
+     * no video to report, and that is a real, non-error state, the same shape
+     * `waitFor`'s "emits nothing" already establishes for a different reason).
+     * Must be called after `session.close()` and before this collector's own
+     * `stop()`.
+     */
+    captureVideo(): Promise<void>;
+}
+export declare function createBrowserActionCollector(options: BrowserActionCollectorOptions): BrowserActionCollector;
+//# sourceMappingURL=browser-action-collector.d.ts.map

package/dist/browser-action-collector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-action-collector.d.ts","sourceRoot":"","sources":["../src/browser-action-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0HG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAyE,MAAM,4BAA4B,CAAC;AAEnI,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAA0B,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGpF,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IACjC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,sBAAuB,SAAQ,SAAS;IACvD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,0MAA0M;IAC1M,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACvD,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,UAAU,CAAC,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD;;;;;;;;OAQG;IACH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AAwCD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,sBAAsB,CAgS3G"}

package/dist/browser-action-collector.js

@@ -0,0 +1,427 @@
+/**
+ * §7's action vocabulary (navigate/click/type/wait) as a `Collector`.
+ *
+ * Actions are commands, not a passive stream -- the opposite shape from
+ * `LogCollector`/console/network collectors, which push evidence as
+ * external events happen. `Collector.emit` is only ever reachable through
+ * `CollectorContext` passed into `start()` (RT-005: "never exposed
+ * outward"), so this stores that `emit` internally at `start()` and
+ * exposes action methods alongside the three Collector methods, rather
+ * than inventing a second, external emit path.
+ *
+ * `waitFor` deliberately emits nothing: the frozen `RuntimeEventType`
+ * vocabulary has no "wait" event, and a wait is a synchronization
+ * primitive for the driver, not an observable page fact the way a click or
+ * a navigation is.
+ *
+ * `start()` also emits exactly one `PAGE_CREATED`, using `session.startedAt`
+ * — the page's real creation time, not this moment. This is the answer to
+ * the non-goal `browser-session.ts` itself declares (RT-053): the page's
+ * existence is real evidence and this is the one collector already
+ * translating this session's facts into Evidence, so a second, near-empty
+ * collector whose only job was one event type would be structure for its
+ * own sake.
+ *
+ * `select`/`submit`/`inspect`/`assertVisible`/`assertText` (RT-058, §5) fill
+ * the rest of the checklist's action gap without needing a single new
+ * `RuntimeEventType`:
+ *  - `select` reuses `INPUT` (`dom-evidence.ts`'s own reasoning: a select's
+ *    new value is a form-input fact, not a distinct kind of fact).
+ *  - `submit` locates the form's own submit control and calls `click()` on
+ *    it, so it is real `CLICK` evidence of the control the user actually
+ *    activates, not a synthesized event with no vocabulary to be.
+ *  - `inspect`/`assertVisible`/`assertText` emit nothing, the same
+ *    reasoning `waitFor` already established: these are synchronization/
+ *    verification primitives for the driver, not an observable page fact
+ *    the way a click or a navigation is. `inspect` and `assertText` both
+ *    run through `captureElementSnapshot` rather than a second DOM-reading
+ *    path, so "what the collector saw" stays one code path.
+ *
+ * `screenshot` (RT-061) captures the viewport and emits `SCREENSHOT`
+ * (`packages/contracts`, added in the same change as this method, per
+ * RT-053's own lesson: a declared-but-unemitted type is the mistake, not a
+ * type existing at all).
+ *
+ * **Capture is preceded by a best-effort settle wait (RT-221), not a raw,
+ * instant `page.screenshot()`.** The original version fired the instant it
+ * was called -- no network-idle wait, no hydration check -- so a capture
+ * mid-transition (a still-loading page, a spinner not yet replaced by real
+ * content) was stored as ordinary evidence with no signal anything was off.
+ * `waitForSettle()` below waits for Playwright's own `networkidle` load
+ * state (capped short, so a page with continuous background traffic --
+ * polling, a websocket -- degrades to "waited as long as reasonable" rather
+ * than hanging), then two animation-frame ticks so a render queued by the
+ * network response's own handler has actually painted before capture.
+ * **This is not the same failure DEC-D234 (descry-desktop) found and fixed
+ * with a double-capture convergence loop** -- that bug was Electron's
+ * `webContents.capturePage()` returning a stale, pre-mutation frame even
+ * after the DOM had already settled, on a `show: false` window; DEC-D234's
+ * own verification confirms a plain, composited `chromium.launch()` page
+ * (what this collector drives) does not share that compositor-level race.
+ * The gap here runs the other direction -- captured too early, before the
+ * page finishes settling -- so the fix is a settle wait, not a frame
+ * comparison. **Disclosed, not a guarantee:** a DOM mutation scheduled via a
+ * bare `setTimeout`/`setInterval` outside a `requestAnimationFrame`-driven
+ * paint, and firing after this wait completes, is not caught.
+ *
+ * Redaction here does NOT follow the pattern every other method in this file
+ * uses:
+ *
+ *  - The mask is applied at CAPTURE time, via Playwright's real
+ *    pixel-level `page.screenshot({ mask, maskColor })` — every
+ *    `input[type="password"]` on the page by default, plus any
+ *    caller-supplied `maskSelectors`. **Coverage is caller-declared, not
+ *    detected** (§20): this collector has no way to recognize a sensitive
+ *    value that isn't in a password field — a token in a URL bar, a name
+ *    in a table, a body panel left open in dev tools all pass through
+ *    unmasked unless the caller names them.
+ *  - The payload key is `imageBase64`, chosen specifically because it does
+ *    NOT match `evidence-store`'s `BODY_BEARING_KEY_PATTERN`
+ *    (`body|post-data|request-body|response-body|raw`). That pattern's
+ *    `GENERIC_TOKEN_PATTERN` text scanner reads base64 as a wall of
+ *    24+-character tokens and would shred a real image into
+ *    `[REDACTED]==` garbage — it corrupts pixels, it does not redact them.
+ *    This is a deliberate, stated EXEMPTION from store-side scanning, not
+ *    an accident of naming: the capture-time mask above is this payload's
+ *    only real protection. Renaming this key to anything
+ *    `BODY_BEARING_KEY_PATTERN` matches (or renaming a body-bearing key TO
+ *    something like it) silently changes which protection applies and
+ *    must be a deliberate re-decision, not a drive-by rename.
+ *  - The evidence this produces will carry `redactionStatus:
+ *    "not-required"` once `EvidenceStore.write()` runs `redact()` on it —
+ *    same string every OTHER "scanned, found nothing sensitive" case
+ *    produces, but it means something different here: this payload was
+ *    never scanned at all, because a text/JSON scanner cannot read
+ *    pixels. Do not read a screenshot's `not-required` as "this image was
+ *    checked."
+ *
+ * `captureVideo` (video evidence, competitive research proposal) emits
+ * `VIDEO` and is structurally different from every method above it in one
+ * way: it is not something this collector *does* to the page, it is a
+ * report of a fact `browser-session.ts` already finished producing.
+ * Playwright's `recordVideo` starts automatically at context creation (the
+ * `BrowserConfiguration.recordVideo` toggle, `browser-session.ts`) and only
+ * *finishes* the file once the browser context closes — so unlike
+ * `screenshot()`, which can be called any time the page is alive,
+ * `captureVideo()` can only be called **after** `session.close()` has
+ * resolved, and it must be called **before** this collector's own `stop()`
+ * (`stop()` clears `emit`, and there would be nothing left to emit into).
+ * That ordering is the opposite of `stop()`-then-`close()`, which is how
+ * every existing caller in this repo already sequences things — genuinely
+ * different for this one method, not a mistake to unify away, because the
+ * video file cannot exist any earlier.
+ *
+ * Redaction follows `screenshot()`'s exemption for the identical reason:
+ * `videoBase64` does not match `BODY_BEARING_KEY_PATTERN` either, so a real
+ * captured video's bytes reach a reader intact rather than shredded by a
+ * text scanner. There is no capture-time pixel mask here, unlike
+ * `screenshot()` — Playwright's `mask` option applies to `page.screenshot()`
+ * only, not to `recordVideo` — so a caller enabling video evidence should
+ * know it is unmasked footage of whatever the page displayed; that gap is
+ * disclosed, not solved, by this change (see this repo's decision record for
+ * this feature).
+ */
+import { captureElementSnapshot } from "./dom-evidence.js";
+import { COLLECTOR_VERSION } from "./collector-version.js";
+function notThisCollectorsJob(what) {
+    return { availability: "unavailable", reason: `BrowserActionCollector handles DOM actions only, not ${what} -- see the dedicated collector.` };
+}
+const CAPABILITIES = {
+    domObservation: { availability: "available", reason: null },
+    consoleObservation: notThisCollectorsJob("console/page-error observation"),
+    networkObservation: notThisCollectorsJob("network observation"),
+    backendLogAccess: { availability: "unavailable", reason: "this collector observes a browser page, not a backend process." },
+    distributedTrace: { availability: "unavailable", reason: "DOM actions carry no trace/request identifiers of their own." },
+    sourceMapping: { availability: "unavailable", reason: "not applicable -- DOM actions produce no stack traces." },
+    stackCapture: { availability: "unavailable", reason: "not applicable -- DOM actions produce no stack traces." },
+    processLifecycle: notThisCollectorsJob("process lifecycle observation"),
+    databaseObservation: notThisCollectorsJob("database query observation"),
+    externalServiceObservation: notThisCollectorsJob("external service observation"),
+};
+async function isPasswordField(page, selector) {
+    const type = await page.getAttribute(selector, "type").catch(() => null);
+    return type === "password";
+}
+/** Capped so a page with continuous background traffic (polling, a websocket) degrades to "waited as long as reasonable" rather than hanging `screenshot()`. See this module's header for the full rationale (RT-221). */
+const SETTLE_NETWORK_IDLE_TIMEOUT_MS = 2000;
+async function waitForSettle(page) {
+    await page.waitForLoadState("networkidle", { timeout: SETTLE_NETWORK_IDLE_TIMEOUT_MS }).catch(() => { });
+    // `requestAnimationFrame` isn't declared under this project's Node-only
+    // `lib` (ES2023, no `dom` -- see tsconfig.base.json's own comment on why),
+    // so it's reached off `globalThis` rather than pulling `dom` into every
+    // file's ambient scope for one in-page callback. Real at runtime: this
+    // callback executes inside the page, where it's Chromium's own global.
+    await page.evaluate(() => {
+        const raf = globalThis.requestAnimationFrame;
+        return new Promise((resolve) => raf(() => raf(() => resolve())));
+    });
+}
+export function createBrowserActionCollector(options) {
+    const { session } = options;
+    const { page } = session;
+    let emit;
+    function emitEvidence(partial) {
+        // A collector not yet start()-ed (or already stop()-ed) has nowhere to
+        // push evidence -- silently doing nothing here would look identical to
+        // "nothing happened," so the action itself still runs; only its
+        // evidence is dropped, same as any other stopped collector.
+        emit?.({ ...partial, collectorVersion: COLLECTOR_VERSION });
+    }
+    async function navigate(url) {
+        const response = await page.goto(url);
+        emitEvidence({
+            timestamp: new Date().toISOString(),
+            source: "browser-dom",
+            service: options.service ?? null,
+            process: null,
+            eventType: "NAVIGATION",
+            payload: { url, statusCode: response?.status() ?? null, browserSessionId: session.sessionId },
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            confidence: 1,
+            redactionStatus: "pending-redaction",
+        });
+    }
+    async function click(selector) {
+        const element = await captureElementSnapshot(page, selector);
+        await page.click(selector);
+        emitEvidence({
+            timestamp: new Date().toISOString(),
+            source: "browser-dom",
+            service: options.service ?? null,
+            process: null,
+            eventType: "CLICK",
+            payload: { selector, element, browserSessionId: session.sessionId },
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            confidence: 1,
+            redactionStatus: "pending-redaction",
+        });
+    }
+    /**
+     * The two text verbs share everything except the one line that actually
+     * touches the page, so they share one implementation. Written this way on
+     * purpose: the password-withholding rule below belongs to text entry as a
+     * class, and a second verb with its own copy of this body is exactly how a
+     * later edit ends up redacting in one of them and not the other.
+     */
+    async function enterText(selector, text, mode) {
+        const isPassword = await isPasswordField(page, selector);
+        const element = await captureElementSnapshot(page, selector);
+        if (mode === "replace") {
+            await page.fill(selector, text);
+        }
+        else {
+            // Real key events, one per character, on top of the existing value --
+            // `page.type()` is deprecated in favour of this, and `fill()` is not a
+            // substitute for it (see the interface comment).
+            await page.locator(selector).pressSequentially(text);
+        }
+        emitEvidence({
+            timestamp: new Date().toISOString(),
+            source: "browser-dom",
+            service: options.service ?? null,
+            process: null,
+            eventType: "INPUT",
+            // The typed text itself is withheld for a password field -- "when
+            // safe" (plan §8) is a content-sensitivity judgment this collector
+            // has to make itself; generic key-name redaction at write time
+            // wouldn't catch a password's actual characters sitting under a
+            // "text" key.
+            //
+            // `mode` is recorded because the payload otherwise reads identically
+            // for the two verbs, and "the field now contains X" and "X was added to
+            // whatever the field contained" are different facts about the run.
+            payload: { selector, text: isPassword ? null : text, mode, element, browserSessionId: session.sessionId },
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            confidence: 1,
+            redactionStatus: "pending-redaction",
+        });
+    }
+    function type(selector, text) {
+        return enterText(selector, text, "append");
+    }
+    function fill(selector, text) {
+        return enterText(selector, text, "replace");
+    }
+    async function select(selector, value) {
+        const element = await captureElementSnapshot(page, selector);
+        await page.selectOption(selector, value);
+        emitEvidence({
+            timestamp: new Date().toISOString(),
+            source: "browser-dom",
+            service: options.service ?? null,
+            process: null,
+            eventType: "INPUT",
+            payload: { selector, value, element, browserSessionId: session.sessionId },
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            confidence: 1,
+            redactionStatus: "pending-redaction",
+        });
+    }
+    async function submit(formSelector) {
+        // The form itself has nothing to click -- what actually happens when a
+        // user "submits" is activating its submit control. Finding that control
+        // and routing through the existing `click()` makes this real CLICK
+        // evidence of a real element, not a synthesized "SUBMIT" fact the
+        // frozen vocabulary has no type for.
+        const submitControlSelector = `${formSelector} button[type="submit"], ${formSelector} input[type="submit"]`;
+        const matched = (await page.locator(submitControlSelector).count().catch(() => 0)) > 0;
+        if (!matched) {
+            throw new Error(`submit(${JSON.stringify(formSelector)}): no submit control (button[type="submit"] or input[type="submit"]) found inside this form.`);
+        }
+        await click(submitControlSelector);
+    }
+    async function waitFor(selector, waitOptions = {}) {
+        await page.waitForSelector(selector, { timeout: waitOptions.timeoutMs ?? 30000 });
+    }
+    async function inspect(selector) {
+        return captureElementSnapshot(page, selector);
+    }
+    async function assertVisible(selector) {
+        const visible = await page
+            .locator(selector)
+            .first()
+            .isVisible()
+            .catch(() => false);
+        if (!visible) {
+            throw new Error(`assertVisible(${JSON.stringify(selector)}): element is not visible (or not present).`);
+        }
+    }
+    async function assertText(selector, expected) {
+        const element = await captureElementSnapshot(page, selector);
+        if (element.text === null || !element.text.includes(expected)) {
+            throw new Error(`assertText(${JSON.stringify(selector)}): expected text to include ${JSON.stringify(expected)}, got ${JSON.stringify(element.text)}.`);
+        }
+    }
+    async function screenshot(screenshotOptions = {}) {
+        const maskSelectors = ['input[type="password"]', ...(screenshotOptions.maskSelectors ?? [])];
+        await waitForSettle(page);
+        const buffer = await page.screenshot({
+            mask: maskSelectors.map((selector) => page.locator(selector)),
+            maskColor: "#FF00FF",
+        });
+        emitEvidence({
+            timestamp: new Date().toISOString(),
+            source: "browser-dom",
+            service: options.service ?? null,
+            process: null,
+            eventType: "SCREENSHOT",
+            payload: {
+                // See this module's own header for why `imageBase64` -- not
+                // `raw`/`body`/anything BODY_BEARING_KEY_PATTERN matches -- is
+                // deliberate, and why the store-side redaction this key exempts
+                // itself from is not this payload's real protection.
+                imageBase64: buffer.toString("base64"),
+                maskedSelectors: maskSelectors,
+                browserSessionId: session.sessionId,
+            },
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            confidence: 1,
+            // Same literal every other method here sets, and EvidenceStore.write()
+            // recomputes it regardless -- see this module's header for what the
+            // resulting "not-required" will actually mean for THIS payload.
+            redactionStatus: "pending-redaction",
+        });
+    }
+    async function captureVideo() {
+        const bytes = await session.finishedVideo();
+        if (bytes === null)
+            return; // recordVideo was never enabled for this session -- nothing to report, not an error.
+        emitEvidence({
+            timestamp: new Date().toISOString(),
+            source: "browser-dom",
+            service: options.service ?? null,
+            process: null,
+            eventType: "VIDEO",
+            payload: {
+                // Mirrors screenshot()'s `imageBase64` choice, for the identical
+                // reason -- see this module's header -- `videoBase64` does not
+                // match evidence-store's BODY_BEARING_KEY_PATTERN either.
+                videoBase64: Buffer.from(bytes).toString("base64"),
+                browserSessionId: session.sessionId,
+            },
+            traceId: null,
+            requestId: null,
+            correlationId: null,
+            graphNodeId: null,
+            sourceLocation: null,
+            stackTrace: null,
+            confidence: 1,
+            // Same literal every other method here sets; EvidenceStore.write()
+            // recomputes it via redact() -- see this module's header for what the
+            // resulting "not-required" will mean for THIS payload (never scanned,
+            // not "checked and clean").
+            redactionStatus: "pending-redaction",
+        });
+    }
+    return {
+        collectorId: `browser-action:${session.sessionId}`,
+        start(context) {
+            if (!session.isUsable()) {
+                return Promise.resolve({ available: false, reason: "the browser session's page has already crashed or closed." });
+            }
+            emit = context.emit;
+            emitEvidence({
+                timestamp: session.startedAt,
+                source: "browser-dom",
+                service: options.service ?? null,
+                process: null,
+                eventType: "PAGE_CREATED",
+                payload: { browserSessionId: session.sessionId, initialUrl: page.url() },
+                traceId: null,
+                requestId: null,
+                correlationId: null,
+                graphNodeId: null,
+                sourceLocation: null,
+                stackTrace: null,
+                confidence: 1,
+                redactionStatus: "pending-redaction",
+            });
+            return Promise.resolve({ available: true });
+        },
+        stop() {
+            emit = undefined;
+            return Promise.resolve();
+        },
+        capabilities() {
+            return CAPABILITIES;
+        },
+        navigate,
+        click,
+        type,
+        fill,
+        select,
+        submit,
+        waitFor,
+        inspect,
+        assertVisible,
+        assertText,
+        screenshot,
+        captureVideo,
+    };
+}
+//# sourceMappingURL=browser-action-collector.js.map

package/dist/browser-action-collector.js.map

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