@humanjs/playwright 0.9.0 → 0.10.0

package/dist/{chunk-3TXDODCO.js → chunk-I2PQGZU7.js}

@@ -1,4 +1,4 @@
-import { resolvePersonality, createRng, sleep as sleep$1, planScroll, countWords, computeReadingDwellMs, planReadingScan, planTypeKeystrokes, bezierPath, humanizePath } from '@humanjs/core';
+import { sleep as sleep$1, resolvePersonality, createRng, planScroll, countWords, computeReadingDwellMs, planReadingScan, planTypeKeystrokes, bezierPath, humanizePath } from '@humanjs/core';
 export { applyMicroJitter, applyVelocityProfile, bezierPath, blend, careful, computeReadingDwellMs, countWords, createRng, distracted, fast, humanizePath, planScroll, planTypeKeystrokes, precise, resolvePersonality, sleep } from '@humanjs/core';
 import { spawn } from 'child_process';
 import { rmSync } from 'fs';
@@ -940,8 +940,17 @@ async function detectKindFromTag(locator) {
   return void 0;
 }
 
-// src/recording/codegen.ts
+// src/recording/targets.ts
 var POINT_RE = /^point\((-?\d+(?:\.\d+)?),\s*(-?\d+(?:\.\d+)?)\)$/;
+function parsePointTarget(desc) {
+  const match = String(desc ?? "").match(POINT_RE);
+  return match ? { x: Number(match[1]), y: Number(match[2]) } : null;
+}
+function resolveMouseTarget(desc) {
+  return parsePointTarget(desc) ?? String(desc ?? "");
+}
+
+// src/recording/codegen.ts
 var POINT_COMMENT = " // raw coordinate \u2014 replace with a locator for a stable selector";
 var UNCAPTURED_COMMENT = " // input not captured (masked or captureInputs disabled) \u2014 fill in (e.g. process.env.X)";
 function q(value) {
@@ -1177,6 +1186,150 @@ ${todo}
 });
 `;
 }
+function abortError() {
+  const error = new Error("Replay aborted");
+  error.name = "AbortError";
+  return error;
+}
+async function replayTimeline(page, timeline, options = {}) {
+  const events = Array.isArray(timeline) ? timeline : timeline.events;
+  const { onStep, signal } = options;
+  if (signal?.aborted) throw abortError();
+  const human = await createHuman(page, {
+    personality: options.personality ?? "careful",
+    speed: options.speed ?? "human",
+    ...options.seed !== void 0 ? { seed: options.seed } : {},
+    ...options.cursor !== void 0 ? { cursor: options.cursor } : {}
+  });
+  const startedAt = Date.now();
+  const steps = [];
+  for (const [index, event] of events.entries()) {
+    if (signal?.aborted) throw abortError();
+    onStep?.({ index, type: event.type, status: "running" });
+    try {
+      await runEvent(human, page, event);
+    } catch (cause) {
+      const error = cause instanceof Error ? cause.message : String(cause);
+      steps.push({ index, type: event.type, status: "fail", error });
+      onStep?.({ index, type: event.type, status: "fail", error });
+      return { status: "fail", steps, failedIndex: index, durationMs: Date.now() - startedAt };
+    }
+    steps.push({ index, type: event.type, status: "pass" });
+    onStep?.({ index, type: event.type, status: "pass" });
+  }
+  return { status: "pass", steps, durationMs: Date.now() - startedAt };
+}
+function parseScrollTarget(target) {
+  const value = String(target ?? "natural");
+  const by = value.match(/^by:(-?\d+(?:\.\d+)?)$/);
+  if (by) return { by: Number(by[1]) };
+  const to = value.match(/^to:(-?\d+(?:\.\d+)?)$/);
+  if (to) return { to: Number(to[1]) };
+  return value;
+}
+var normalizeText = (value) => (value ?? "").replace(/\s+/g, " ").trim();
+async function runAssert(page, params) {
+  const kind = String(params.kind ?? "visible");
+  if (kind === "url") {
+    const actual = page.url();
+    const expected = String(params.value ?? "");
+    if (actual !== expected) {
+      throw new Error(`expected URL ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
+    }
+    return;
+  }
+  const locator = page.locator(String(params.target ?? "")).first();
+  await locator.waitFor({ state: "visible" });
+  if (kind === "text") {
+    const actual = normalizeText(await locator.textContent());
+    const expected = normalizeText(String(params.value ?? ""));
+    if (actual !== expected) {
+      throw new Error(`expected text ${JSON.stringify(expected)}, got ${JSON.stringify(actual)}`);
+    }
+  }
+}
+async function runEvent(human, page, event) {
+  const p = event.params;
+  switch (event.type) {
+    case "goto":
+      await human.goto(String(p.url ?? ""));
+      return;
+    case "click":
+      await human.click(resolveMouseTarget(p.target));
+      return;
+    case "rightClick":
+      await human.rightClick(resolveMouseTarget(p.target));
+      return;
+    case "doubleClick":
+      await human.doubleClick(resolveMouseTarget(p.target));
+      return;
+    case "move":
+      await human.move(resolveMouseTarget(p.target));
+      return;
+    case "hover":
+      await human.hover(String(p.target ?? ""));
+      return;
+    case "drag":
+      await human.drag(resolveMouseTarget(p.from), resolveMouseTarget(p.to));
+      return;
+    case "type":
+      await human.type(String(p.target ?? ""), event.inputValue ?? "");
+      return;
+    case "paste":
+      await human.paste(String(p.target ?? ""), event.inputValue ?? "");
+      return;
+    case "clear":
+      await human.clear(String(p.target ?? ""));
+      return;
+    case "check":
+      await human.check(String(p.target ?? ""));
+      return;
+    case "uncheck":
+      await human.uncheck(String(p.target ?? ""));
+      return;
+    case "selectText":
+      await human.selectText(
+        String(p.target ?? ""),
+        typeof p.text === "string" ? { text: p.text } : void 0
+      );
+      return;
+    case "selectOption":
+      await human.selectOption(String(p.target ?? ""), p.values);
+      return;
+    case "upload":
+      await human.upload(String(p.target ?? ""), p.files);
+      return;
+    case "press":
+      await human.press(String(p.key ?? ""));
+      return;
+    case "scroll":
+      await human.scroll(parseScrollTarget(p.target));
+      return;
+    case "read": {
+      const target = String(p.target ?? "");
+      if (/^\d+ words$/.test(target) || /^text:\d+ chars$/.test(target)) return;
+      await human.read(target);
+      return;
+    }
+    case "sleep":
+      await sleep$1(Number(p.ms) || 0);
+      return;
+    case "reload":
+      await human.reload();
+      return;
+    case "goBack":
+      await human.goBack();
+      return;
+    case "goForward":
+      await human.goForward();
+      return;
+    case "assert":
+      await runAssert(page, p);
+      return;
+    default:
+      return;
+  }
+}
 
 // src/recording/index.ts
 var pendingFrameCleanups = /* @__PURE__ */ new Set();
@@ -1992,6 +2145,6 @@ function describeReadTarget(target) {
   return target.toString?.() ?? "locator";
 }
 
-export { Recording, createHuman, generateHumanJS, generatePlaywrightTest, installMouseHelper };
-//# sourceMappingURL=chunk-3TXDODCO.js.map
-//# sourceMappingURL=chunk-3TXDODCO.js.map
+export { Recording, createHuman, generateHumanJS, generatePlaywrightTest, installMouseHelper, replayTimeline };
+//# sourceMappingURL=chunk-I2PQGZU7.js.map
+//# sourceMappingURL=chunk-I2PQGZU7.js.map