fast-replay 0.1.0

package/dist/replayer/waits.js

@@ -0,0 +1,90 @@
+import { matchesUrlPattern } from '../compiler/normalize.js';
+const NETWORK_POLL_MS = 25;
+/**
+ * Poll the network buffer instead of attaching a fresh `waitForResponse`.
+ *
+ * A request can settle before we get around to waiting on it — the classic
+ * lost-wakeup race. Reading a buffer that was already recording covers the
+ * window between the action firing and this wait starting.
+ */
+function waitForNetwork(ctx, method, urlPattern, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    const satisfied = () => ctx.network.some((n) => n.settledAt !== null &&
+        n.settledAt >= ctx.since &&
+        n.method.toUpperCase() === method.toUpperCase() &&
+        matchesUrlPattern(n.url, urlPattern, ctx.baseUrl));
+    return new Promise((resolve, reject) => {
+        if (satisfied())
+            return resolve();
+        const timer = setInterval(() => {
+            if (satisfied()) {
+                clearInterval(timer);
+                resolve();
+            }
+            else if (Date.now() > deadline) {
+                clearInterval(timer);
+                reject(new Error(`no settled ${method} matching ${urlPattern}`));
+            }
+        }, NETWORK_POLL_MS);
+    });
+}
+/**
+ * Wait for every recorded signal at once, with the step's timeoutMs as a single
+ * ceiling over all of them. Never a fixed sleep — replay proceeds the moment
+ * the environment actually reacts, which is where the speed comes from.
+ */
+export async function waitForReaction(ctx, waitAfter) {
+    const started = Date.now();
+    const timeout = waitAfter.timeoutMs;
+    const jobs = [];
+    for (const n of waitAfter.network ?? []) {
+        jobs.push({
+            label: `network ${n.method} ${n.urlPattern}`,
+            run: waitForNetwork(ctx, n.method, n.urlPattern, timeout),
+        });
+    }
+    for (const selector of waitAfter.domAppeared ?? []) {
+        jobs.push({
+            label: `appeared ${selector}`,
+            run: ctx.page
+                .locator(selector)
+                .first()
+                .waitFor({ state: 'visible', timeout })
+                .then(() => undefined),
+        });
+    }
+    for (const selector of waitAfter.domGone ?? []) {
+        jobs.push({
+            label: `gone ${selector}`,
+            // `hidden` covers both ways an element goes away — unmounted, or still
+            // attached but no longer rendered. `detached` would hang forever on the
+            // second case. `first()` keeps this out of strict mode and resolves
+            // immediately when nothing matches, which is exactly "already gone".
+            run: ctx.page
+                .locator(selector)
+                .first()
+                .waitFor({ state: 'hidden', timeout })
+                .then(() => undefined),
+        });
+    }
+    if (waitAfter.networkIdle) {
+        jobs.push({
+            label: 'network idle',
+            run: ctx.page.waitForLoadState('networkidle', { timeout }).then(() => undefined),
+        });
+    }
+    if (!jobs.length)
+        return { ok: true, unmet: [], met: [], durationMs: 0 };
+    const results = await Promise.allSettled(jobs.map((j) => j.run));
+    const unmet = [];
+    const met = [];
+    results.forEach((r, i) => {
+        const label = jobs[i]?.label ?? 'signal';
+        if (r.status === 'fulfilled')
+            met.push(label);
+        else
+            unmet.push(label);
+    });
+    return { ok: unmet.length === 0, unmet, met, durationMs: Date.now() - started };
+}
+//# sourceMappingURL=waits.js.map

package/dist/replayer/waits.js.map

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

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION: string;

package/dist/version.js

@@ -0,0 +1,10 @@
+import { createRequire } from 'node:module';
+/**
+ * Single source of truth for the version, read from the manifest.
+ *
+ * Two builds both reporting 0.1.0 made them indistinguishable in the field —
+ * the only way to tell them apart was grepping dist/ for a feature string.
+ */
+const require = createRequire(import.meta.url);
+export const VERSION = require('../package.json').version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,CAAC,MAAM,OAAO,GAAY,OAAO,CAAC,iBAAiB,CAAyB,CAAC,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "fast-replay",
+  "version": "0.1.0",
+  "description": "Record a browser bug once, verify the fix in seconds. A deterministic eye for coding agents.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "bin": {
+    "repro": "./dist/cli/index.js",
+    "repro-mcp": "./dist/mcp/index.js"
+  },
+  "main": "./dist/api.js",
+  "types": "./dist/api.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "dev": "tsc -p tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "stress": "tsx scripts/stress.ts",
+    "demo": "npm --prefix examples/demo-app run dev",
+    "build:agent": "tsx scripts/build-agent.ts",
+    "prebuild": "npm run build:agent",
+    "pretest": "npm run build:agent",
+    "prestress": "npm run build:agent",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "commander": "^14.0.3",
+    "playwright": "^1.61.1",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "esbuild": "^0.28.1",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "vitest": "^4.1.10"
+  },
+  "author": "Mukhriddin Shakhriyorov",
+  "keywords": [
+    "bug",
+    "repro",
+    "reproduction",
+    "playwright",
+    "mcp",
+    "testing",
+    "debugging",
+    "browser",
+    "automation",
+    "claude",
+    "agent",
+    "ai"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mukhrr/replay.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mukhrr/replay/issues"
+  },
+  "homepage": "https://github.com/mukhrr/replay#readme"
+}