prose-qa 0.1.0

package/dist/recorder/in-page-helpers.js

@@ -0,0 +1,238 @@
+/**
+ * Browser-side helpers embedded in the page recorder and Chrome extension.
+ * Keep this file free of Node imports — it is inlined into injected scripts.
+ */
+export function buildInPageRecorderHelpers() {
+    return `
+  const INTERACTIVE_ROLES = new Set([
+    "button", "link", "menuitem", "menuitemcheckbox", "menuitemradio",
+    "option", "tab", "combobox", "listbox", "checkbox", "radio", "switch",
+    "slider", "textbox", "searchbox", "spinbutton", "gridcell", "row",
+    "treeitem", "cell",
+  ]);
+  const INTERACTIVE_TAGS = new Set([
+    "button", "a", "input", "select", "textarea", "summary", "label",
+  ]);
+  const NON_INTERACTIVE_TAGS = new Set(["html", "body", "head"]);
+
+  function asElement(node) {
+    if (!node) return null;
+    if (node.nodeType === 1) return node;
+    if (node.nodeType === 3 && node.parentElement) return node.parentElement;
+    return null;
+  }
+
+  function isHidden(el) {
+    if (!el || el.nodeType !== 1) return true;
+    if (el.getAttribute && el.getAttribute("aria-hidden") === "true") return true;
+    try {
+      const style = getComputedStyle(el);
+      if (
+        style.display === "none" ||
+        style.visibility === "hidden" ||
+        style.pointerEvents === "none"
+      ) {
+        return true;
+      }
+    } catch (_) {}
+    return false;
+  }
+
+  function implicitRole(el) {
+    const tag = el.tagName ? el.tagName.toLowerCase() : "";
+    if (tag === "a" && el.hasAttribute && el.hasAttribute("href")) return "link";
+    if (tag === "button") return "button";
+    if (tag === "select") return "combobox";
+    if (tag === "textarea") return "textbox";
+    if (tag === "input" && el.type) {
+      const type = String(el.type).toLowerCase();
+      if (type === "checkbox") return "checkbox";
+      if (type === "radio") return "radio";
+      if (type === "submit" || type === "button" || type === "reset") return "button";
+      if (type === "hidden") return null;
+      return "textbox";
+    }
+    return null;
+  }
+
+  function isSnapshotInteractive(el) {
+    if (!el || el.nodeType !== 1 || isHidden(el)) return false;
+    const tag = el.tagName ? el.tagName.toLowerCase() : "";
+    if (NON_INTERACTIVE_TAGS.has(tag)) return false;
+    if (INTERACTIVE_TAGS.has(tag)) return true;
+    const role =
+      (el.getAttribute && el.getAttribute("role")?.toLowerCase()) ||
+      implicitRole(el);
+    if (role && INTERACTIVE_ROLES.has(role)) return true;
+    const hasPopup = el.getAttribute && el.getAttribute("aria-haspopup");
+    if (hasPopup && hasPopup !== "false") return true;
+    const tabindex = el.getAttribute && el.getAttribute("tabindex");
+    if (tabindex != null && String(tabindex) !== "-1") return true;
+    if (el.isContentEditable) return true;
+    return false;
+  }
+
+  function pushCandidate(list, el) {
+    if (el && list.indexOf(el) === -1) list.push(el);
+  }
+
+  function containsPoint(el, x, y) {
+    if (!el || typeof el.getBoundingClientRect !== "function") return false;
+    const rect = el.getBoundingClientRect();
+    return (
+      x >= rect.left && x <= rect.right && y >= rect.top && y <= rect.bottom
+    );
+  }
+
+  function interactiveInSubtreeAtPoint(root, x, y) {
+    if (!root || !root.querySelectorAll) return null;
+    const nodes = root.querySelectorAll(
+      'button, a, input, select, textarea, [role], [tabindex]:not([tabindex="-1"]), [aria-haspopup]'
+    );
+    let best = null;
+    let bestArea = Infinity;
+    for (let i = 0; i < nodes.length; i++) {
+      const node = nodes[i];
+      if (!isSnapshotInteractive(node) || !containsPoint(node, x, y)) continue;
+      const rect = node.getBoundingClientRect();
+      const area = rect.width * rect.height;
+      if (area < bestArea) {
+        best = node;
+        bestArea = area;
+      }
+    }
+    return best;
+  }
+
+  function resolveFromAncestorsAtPoint(start, x, y) {
+    let root = start;
+    while (root && root.nodeType === 1) {
+      const tag = root.tagName ? root.tagName.toLowerCase() : "";
+      if (tag !== "html" && tag !== "body") {
+        const hit = interactiveInSubtreeAtPoint(root, x, y);
+        if (hit) return hit;
+      }
+      root = root.parentElement;
+    }
+    return null;
+  }
+
+  function findRelatedCombobox(start) {
+    let root = start;
+    while (root && root.nodeType === 1) {
+      const tag = root.tagName ? root.tagName.toLowerCase() : "";
+      if (tag === "html" || tag === "body") break;
+      if (root.querySelector) {
+        const combo = root.querySelector('[role="combobox"]');
+        if (combo && isSnapshotInteractive(combo)) return combo;
+      }
+      root = root.parentElement;
+    }
+    return null;
+  }
+
+  function resolveClickTarget(ev) {
+    const path =
+      typeof ev.composedPath === "function" ? ev.composedPath() : [];
+    const candidates = [];
+    const x = ev.clientX;
+    const y = ev.clientY;
+
+    if (typeof document.elementFromPoint === "function") {
+      pushCandidate(candidates, asElement(document.elementFromPoint(x, y)));
+    }
+
+    let target = asElement(ev.target);
+    if (target) pushCandidate(candidates, target);
+
+    for (let i = 0; i < path.length; i++) {
+      pushCandidate(candidates, asElement(path[i]));
+    }
+
+    for (let c = 0; c < candidates.length; c++) {
+      let el = candidates[c];
+      while (el && el.nodeType === 1) {
+        const tag = el.tagName ? el.tagName.toLowerCase() : "";
+        if (tag === "html" || tag === "body") {
+          el = el.parentElement;
+          continue;
+        }
+        if (isSnapshotInteractive(el)) return el;
+        el = el.parentElement;
+      }
+    }
+
+    for (let c = 0; c < candidates.length; c++) {
+      const hit = resolveFromAncestorsAtPoint(candidates[c], x, y);
+      if (hit) return hit;
+    }
+
+    for (let c = 0; c < candidates.length; c++) {
+      const combo = findRelatedCombobox(candidates[c]);
+      if (combo) return combo;
+    }
+
+    return null;
+  }
+
+  function roleOf(el) {
+    if (!el || el.nodeType !== 1) return undefined;
+    const explicit = el.getAttribute && el.getAttribute("role");
+    if (explicit) return explicit.toLowerCase();
+    const implicit = implicitRole(el);
+    if (implicit) return implicit;
+    const tag = el.tagName ? el.tagName.toLowerCase() : "";
+    const map = {
+      a: "link",
+      button: "button",
+      input: "textbox",
+      select: "combobox",
+      textarea: "textbox",
+      label: "label",
+    };
+    return map[tag];
+  }
+
+  function nameOf(el) {
+    if (!el || el.nodeType !== 1) return undefined;
+    const labelledBy =
+      el.getAttribute && el.getAttribute("aria-labelledby");
+    if (labelledBy) {
+      const parts = labelledBy
+        .split(/\\s+/)
+        .map((id) => document.getElementById(id))
+        .filter(Boolean)
+        .map((n) => (n.textContent || "").trim())
+        .filter(Boolean);
+      if (parts.length) return parts.join(" ").slice(0, 200);
+    }
+    const aria = el.getAttribute && el.getAttribute("aria-label");
+    if (aria) return aria.trim().slice(0, 200);
+    if (el.labels && el.labels[0])
+      return el.labels[0].textContent.trim().slice(0, 200);
+    if (el.id) {
+      const label = document.querySelector('label[for="' + el.id + '"]');
+      if (label) return label.textContent.trim().slice(0, 200);
+    }
+    const text = (el.innerText || el.textContent || "").trim();
+    if (text && text.length < 120) return text;
+    if (el.name) return el.name;
+    if (el.placeholder) return el.placeholder;
+    return undefined;
+  }
+
+  function labelOf(el) {
+    const n = nameOf(el);
+    if (n) return n;
+    const role = roleOf(el);
+    if (role) return role;
+    if (el && el.tagName) return el.tagName.toLowerCase();
+    return undefined;
+  }
+
+  function targetFromEvent(ev) {
+    return resolveClickTarget(ev);
+  }
+`;
+}
+//# sourceMappingURL=in-page-helpers.js.map

package/dist/recorder/in-page-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-page-helpers.js","sourceRoot":"","sources":["../../src/recorder/in-page-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,0BAA0B;IACxC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsOR,CAAC;AACF,CAAC"}

package/dist/recorder/in-page-helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=in-page-helpers.test.d.ts.map

package/dist/recorder/in-page-helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"in-page-helpers.test.d.ts","sourceRoot":"","sources":["../../src/recorder/in-page-helpers.test.ts"],"names":[],"mappings":""}

package/dist/recorder/in-page-helpers.test.js

@@ -0,0 +1,186 @@
+import assert from "node:assert/strict";
+import { createContext, runInContext } from "node:vm";
+import { describe, it } from "node:test";
+import { buildInPageRecorderHelpers } from "./in-page-helpers.js";
+function el(tag, opts = {}) {
+    const node = {
+        nodeType: 1,
+        tagName: tag.toUpperCase(),
+        type: opts.type,
+        parentElement: opts.parent ?? null,
+        textContent: opts.text,
+        innerText: opts.text,
+        id: opts.id,
+        getAttribute(name) {
+            if (name === "role")
+                return opts.role ?? null;
+            if (name === "tabindex")
+                return opts.tabindex ?? null;
+            if (name === "aria-hidden")
+                return opts.ariaHidden ? "true" : null;
+            return null;
+        },
+        hasAttribute(name) {
+            return name === "href" && tag === "a";
+        },
+    };
+    return node;
+}
+function chain(...nodes) {
+    const first = nodes[0];
+    if (!first)
+        throw new Error("chain requires at least one node");
+    for (let i = 0; i < nodes.length - 1; i++) {
+        const current = nodes[i];
+        const parent = nodes[i + 1];
+        if (current && parent)
+            current.parentElement = parent;
+    }
+    return first;
+}
+function loadHelpers(document) {
+    const ctx = createContext({
+        document,
+        getComputedStyle: () => ({
+            display: "block",
+            visibility: "visible",
+            pointerEvents: "auto",
+        }),
+    });
+    runInContext(buildInPageRecorderHelpers(), ctx);
+    return ctx;
+}
+describe("in-page recorder target resolution", () => {
+    it("resolves body target via elementFromPoint to interactive ancestor", () => {
+        const body = el("body");
+        const wrapper = el("div", { parent: body });
+        const button = el("button", { parent: wrapper, text: "Filter" });
+        chain(button, wrapper, body);
+        const helpers = loadHelpers({
+            body,
+            documentElement: el("html"),
+            elementFromPoint: () => button,
+            getElementById: () => null,
+            querySelector: () => null,
+        });
+        const resolved = helpers.resolveClickTarget({
+            target: body,
+            clientX: 10,
+            clientY: 10,
+            composedPath: () => [body, wrapper, button],
+        });
+        assert.equal(resolved, button);
+        assert.equal(helpers.roleOf(button), "button");
+        assert.equal(helpers.nameOf(button), "Filter");
+    });
+    it("walks composedPath to first snapshot-interactive element", () => {
+        const body = el("body");
+        const helpers = loadHelpers({
+            body,
+            documentElement: el("html"),
+            elementFromPoint: () => null,
+            getElementById: () => null,
+            querySelector: () => null,
+        });
+        const span = el("span", { parent: body, text: "Paid" });
+        const option = el("li", { parent: body, role: "option", text: "Paid" });
+        chain(span, option, body);
+        const resolved = helpers.resolveClickTarget({
+            target: span,
+            clientX: 0,
+            clientY: 0,
+            composedPath: () => [span, option, body],
+        });
+        assert.equal(resolved, option);
+        assert.equal(helpers.roleOf(option), "option");
+    });
+    it("finds combobox sibling when click lands on a non-interactive wrapper (MUI Select)", () => {
+        const body = el("body");
+        const formControl = el("div", { parent: body });
+        const inputBase = el("div", { parent: formControl });
+        const outline = el("div", { parent: inputBase });
+        const combobox = el("div", {
+            parent: inputBase,
+            role: "combobox",
+            text: "Status",
+            tabindex: "0",
+        });
+        chain(outline, inputBase, formControl, body);
+        const helpers = loadHelpers({
+            body,
+            documentElement: el("html"),
+            elementFromPoint: () => outline,
+            getElementById: () => null,
+            querySelector: () => null,
+        });
+        combobox.getBoundingClientRect =
+            () => ({ left: 0, top: 0, right: 100, bottom: 30, width: 100, height: 30 });
+        outline.getBoundingClientRect =
+            () => ({ left: 0, top: 0, right: 100, bottom: 30, width: 100, height: 30 });
+        const withQuery = (node) => {
+            node.querySelectorAll =
+                () => [combobox];
+        };
+        withQuery(inputBase);
+        withQuery(formControl);
+        const resolved = helpers.resolveClickTarget({
+            target: outline,
+            clientX: 50,
+            clientY: 15,
+            composedPath: () => [outline, inputBase, formControl, body],
+        });
+        assert.equal(resolved, combobox);
+        assert.equal(helpers.roleOf(combobox), "combobox");
+    });
+    it("finds combobox when click is on a sibling icon (MUI Select chevron)", () => {
+        const body = el("body");
+        const inputBase = el("div", { parent: body });
+        const combobox = el("div", {
+            parent: inputBase,
+            role: "combobox",
+            text: "All",
+            tabindex: "0",
+        });
+        const icon = el("div", { parent: inputBase });
+        chain(icon, inputBase, body);
+        const helpers = loadHelpers({
+            body,
+            documentElement: el("html"),
+            elementFromPoint: () => icon,
+            getElementById: () => null,
+            querySelector: () => null,
+        });
+        combobox.getBoundingClientRect =
+            () => ({ left: 0, top: 0, right: 80, bottom: 30, width: 80, height: 30 });
+        icon.getBoundingClientRect =
+            () => ({ left: 200, top: 0, right: 230, bottom: 30, width: 30, height: 30 });
+        inputBase.querySelector = (sel) => sel.includes("combobox") ? combobox : null;
+        inputBase.querySelectorAll =
+            () => [combobox];
+        const resolved = helpers.resolveClickTarget({
+            target: icon,
+            clientX: 210,
+            clientY: 15,
+            composedPath: () => [icon, inputBase, body],
+        });
+        assert.equal(resolved, combobox);
+    });
+    it("returns null when only body/html is clicked with no interactive target", () => {
+        const body = el("body");
+        const helpers = loadHelpers({
+            body,
+            documentElement: el("html"),
+            elementFromPoint: () => null,
+            getElementById: () => null,
+            querySelector: () => null,
+        });
+        const resolved = helpers.resolveClickTarget({
+            target: body,
+            clientX: 0,
+            clientY: 0,
+            composedPath: () => [body],
+        });
+        assert.equal(resolved, null);
+    });
+});
+//# sourceMappingURL=in-page-helpers.test.js.map

package/dist/recorder/in-page-helpers.test.js.map

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

package/dist/recorder/page-script.d.ts

@@ -0,0 +1,7 @@
+/**
+ * In-page recorder injected via agent-browser --init-script.
+ * Posts accessibility-oriented events to the local PQA bridge.
+ */
+export declare function buildPageRecorderScript(bridgeUrl: string): string;
+export declare function writePageRecorderScript(bridgeUrl: string, destPath: string): string;
+//# sourceMappingURL=page-script.d.ts.map

package/dist/recorder/page-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-script.d.ts","sourceRoot":"","sources":["../../src/recorder/page-script.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAuHjE;AAED,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACf,MAAM,CAIR"}

package/dist/recorder/page-script.js

@@ -0,0 +1,132 @@
+import { writeFileSync } from "node:fs";
+import { buildInPageRecorderHelpers } from "./in-page-helpers.js";
+/**
+ * In-page recorder injected via agent-browser --init-script.
+ * Posts accessibility-oriented events to the local PQA bridge.
+ */
+export function buildPageRecorderScript(bridgeUrl) {
+    const bridge = JSON.stringify(bridgeUrl);
+    const helpers = buildInPageRecorderHelpers();
+    return `(() => {
+  const BRIDGE = ${bridge};
+  const sentNav = new Set();
+  ${helpers}
+
+  function post(payload) {
+    try {
+      fetch(BRIDGE + "/event", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ ...payload, ts: Date.now() }),
+        keepalive: true,
+      }).catch(() => {});
+    } catch (_) {}
+  }
+
+  function recordNavigate() {
+    const url = location.href;
+    if (sentNav.has(url)) return;
+    sentNav.add(url);
+    post({ type: "navigate", url });
+  }
+
+  let lastRecordedClickKey = "";
+  let lastRecordedClickAt = 0;
+
+  function recordClick(ev) {
+    if (typeof ev.button === "number" && ev.button !== 0) return;
+    const el = resolveClickTarget(ev);
+    if (!el) return;
+    const payload = {
+      type: "click",
+      role: roleOf(el),
+      name: nameOf(el),
+      label: labelOf(el),
+      clientX: ev.clientX,
+      clientY: ev.clientY,
+    };
+    const key = [payload.role, payload.name, payload.label].join("|");
+    const now = Date.now();
+    if (key === lastRecordedClickKey && now - lastRecordedClickAt < 500) return;
+    lastRecordedClickKey = key;
+    lastRecordedClickAt = now;
+    post(payload);
+  }
+
+  // MUI Select opens on mousedown + preventDefault(), which suppresses click.
+  document.addEventListener("mousedown", recordClick, true);
+  document.addEventListener("click", recordClick, true);
+
+  document.addEventListener(
+    "change",
+    (ev) => {
+      const el = targetFromEvent(ev) || asElement(ev.target);
+      if (!el) return;
+      const tag = el.tagName ? el.tagName.toLowerCase() : "";
+      if (tag === "select") {
+        const opt = el.selectedOptions && el.selectedOptions[0];
+        post({
+          type: "select",
+          name: nameOf(el),
+          value: opt ? (opt.textContent || opt.value || "").trim().slice(0, 200) : "",
+          clientX: ev.clientX,
+          clientY: ev.clientY,
+        });
+        return;
+      }
+      if (tag === "input" || tag === "textarea") {
+        const type = (el.type || "").toLowerCase();
+        if (type === "password" || type === "file") {
+          post({
+            type: "fill",
+            role: roleOf(el),
+            name: nameOf(el),
+            value: "[REDACTED]",
+            clientX: ev.clientX,
+            clientY: ev.clientY,
+          });
+          return;
+        }
+        post({
+          type: "fill",
+          role: roleOf(el),
+          name: nameOf(el),
+          value: String(el.value ?? "").slice(0, 500),
+          clientX: ev.clientX,
+          clientY: ev.clientY,
+        });
+      }
+    },
+    true
+  );
+
+  document.addEventListener(
+    "submit",
+    () => {
+      post({ type: "submit" });
+    },
+    true
+  );
+
+  const pushState = history.pushState;
+  history.pushState = function () {
+    pushState.apply(this, arguments);
+    recordNavigate();
+  };
+  const replaceState = history.replaceState;
+  history.replaceState = function () {
+    replaceState.apply(this, arguments);
+    recordNavigate();
+  };
+  window.addEventListener("popstate", recordNavigate);
+  window.addEventListener("hashchange", recordNavigate);
+
+  recordNavigate();
+})();`;
+}
+export function writePageRecorderScript(bridgeUrl, destPath) {
+    const content = buildPageRecorderScript(bridgeUrl);
+    writeFileSync(destPath, content, "utf-8");
+    return destPath;
+}
+//# sourceMappingURL=page-script.js.map

package/dist/recorder/page-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-script.js","sourceRoot":"","sources":["../../src/recorder/page-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAElE;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAiB;IACvD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,0BAA0B,EAAE,CAAC;IAC7C,OAAO;mBACU,MAAM;;IAErB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgHL,CAAC;AACP,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,QAAgB;IAEhB,MAAM,OAAO,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACnD,aAAa,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/recorder/redact.d.ts

@@ -0,0 +1,8 @@
+import type { RecordEvent } from "../types/recorder.js";
+export declare function isSensitiveFieldName(name?: string): boolean;
+export declare function redactFillValue(value: string, fieldName?: string, sensitiveEnvVars?: string[]): {
+    value: string;
+    redacted: boolean;
+};
+export declare function sanitizeRecordEvent(event: RecordEvent, sensitiveEnvVars?: string[]): RecordEvent;
+//# sourceMappingURL=redact.d.ts.map

package/dist/recorder/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/recorder/redact.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAa,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKnE,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,EAClB,gBAAgB,GAAE,MAAM,EAAO,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAUtC;AAED,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,WAAW,EAClB,gBAAgB,GAAE,MAAM,EAAO,GAC9B,WAAW,CASb"}

package/dist/recorder/redact.js

@@ -0,0 +1,26 @@
+import { createEnvRedactor } from "../redact/env-secrets.js";
+const PASSWORD_HINT = /password|passwd|secret|token|api[_-]?key|credential/i;
+export function isSensitiveFieldName(name) {
+    if (!name)
+        return false;
+    return PASSWORD_HINT.test(name);
+}
+export function redactFillValue(value, fieldName, sensitiveEnvVars = []) {
+    if (isSensitiveFieldName(fieldName)) {
+        return { value: "[REDACTED]", redacted: true };
+    }
+    const redactor = createEnvRedactor(process.env, sensitiveEnvVars);
+    const redacted = redactor.redact(value);
+    if (redacted !== value) {
+        return { value: redacted, redacted: true };
+    }
+    return { value, redacted: false };
+}
+export function sanitizeRecordEvent(event, sensitiveEnvVars = []) {
+    if (event.type !== "fill")
+        return event;
+    const fill = event;
+    const { value, redacted } = redactFillValue(fill.value, fill.name, sensitiveEnvVars);
+    return { ...fill, value, redacted: redacted || fill.redacted };
+}
+//# sourceMappingURL=redact.js.map

package/dist/recorder/redact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.js","sourceRoot":"","sources":["../../src/recorder/redact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7D,MAAM,aAAa,GACjB,sDAAsD,CAAC;AAEzD,MAAM,UAAU,oBAAoB,CAAC,IAAa;IAChD,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IACxB,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAa,EACb,SAAkB,EAClB,mBAA6B,EAAE;IAE/B,IAAI,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACxC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,KAAkB,EAClB,mBAA6B,EAAE;IAE/B,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,IAAI,GAAG,KAAkB,CAAC;IAChC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,eAAe,CACzC,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,IAAI,EACT,gBAAgB,CACjB,CAAC;IACF,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;AACjE,CAAC"}

package/dist/recorder/redact.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=redact.test.d.ts.map

package/dist/recorder/redact.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.test.d.ts","sourceRoot":"","sources":["../../src/recorder/redact.test.ts"],"names":[],"mappings":""}