@tracelane/core 0.1.0-alpha.10 → 0.1.0-alpha.12

package/dist/index.d.ts

@@ -1,4 +1,6 @@
 export type { BrowserExecutor } from './browser-executor.js';
+export { __internal, attachNetworkCapture } from './network-capture.js';
+export { loadRrwebBundle } from './load-rrweb-bundle.js';
 export { createRecorder, DEFAULT_COOLDOWN_MS, DEFAULT_DRAIN_INTERVAL_MS } from './recorder.js';
 export type { FinalizeResult, Recorder, RecorderOptions, TestOutcome } from './recorder.js';
 export type { ConsolePluginOptions, NetworkPluginOptions } from './page-script.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/F,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGnF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAO7D,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAIxE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC/F,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5F,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAGnF,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACtD,YAAY,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGtC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -1,4 +1,13 @@
 // Public API surface for @tracelane/core.
+// CDP network capture (Task 2.16 / P1 PRD §E.2) — framework-agnostic, shared by
+// the WDIO and Playwright adapters via the BrowserExecutor surface. `__internal`
+// exposes the pure page-side logger + method resolver so @tracelane/report's
+// cross-package contract test can exercise core's real output (the test must
+// live in report — which depends on core — to keep the dep edge one-directional).
+export { __internal, attachNetworkCapture } from './network-capture.js';
+// In-page rrweb bundle loader — reads the adapter's built dist/rrweb-bundle.js
+// off disk (pass the adapter's import.meta.url). Shared across adapters.
+export { loadRrwebBundle } from './load-rrweb-bundle.js';
 // Recorder controller — in-page buffer install + Node-polled drain (ADR-0006).
 export { createRecorder, DEFAULT_COOLDOWN_MS, DEFAULT_DRAIN_INTERVAL_MS } from './recorder.js';
 // Capture mode switch (ADR-0005).

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAK1C,+EAA+E;AAC/E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAI/F,kCAAkC;AAClC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGtD,yEAAyE;AACzE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAK1C,gFAAgF;AAChF,iFAAiF;AACjF,6EAA6E;AAC7E,6EAA6E;AAC7E,kFAAkF;AAClF,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAExE,+EAA+E;AAC/E,yEAAyE;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,+EAA+E;AAC/E,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAI/F,kCAAkC;AAClC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGtD,yEAAyE;AACzE,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC"}

package/dist/load-rrweb-bundle.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Read the rrweb in-page bundle source (defines `window.rrweb`) off disk.
+ *
+ * @param moduleUrl       the calling adapter's `import.meta.url`; candidate
+ *                        paths resolve relative to this module.
+ * @param candidatePaths  optional explicit candidate paths (overrides the
+ *                        defaults). The first that exists is read.
+ * @returns the bundle source string.
+ * @throws if no candidate exists — that means the package was used without its
+ *   build step having run.
+ */
+export declare function loadRrwebBundle(moduleUrl: string, candidatePaths?: string[]): string;
+//# sourceMappingURL=load-rrweb-bundle.d.ts.map

package/dist/load-rrweb-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-rrweb-bundle.d.ts","sourceRoot":"","sources":["../src/load-rrweb-bundle.ts"],"names":[],"mappings":"AA8BA;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAUpF"}

package/dist/load-rrweb-bundle.js

@@ -0,0 +1,47 @@
+// Loads the in-page rrweb bundle source string (framework-agnostic).
+//
+// Each adapter (WDIO, Playwright) ships its own `dist/rrweb-bundle.js` — an
+// esbuild IIFE that defines `window.rrweb` with `record` +
+// `getRecordConsolePlugin` (+ `getRecordNetworkPlugin`). The recorder is
+// bundle-source-agnostic (ADR-0006) and expects this source as a plain string,
+// which it `window.eval`s in the page on every (re-)injection.
+//
+// This loader lives in @tracelane/core so every adapter shares one
+// implementation. The adapter passes its own `import.meta.url` so the candidate
+// paths resolve relative to the ADAPTER's module (where its bundle sits), not to
+// core. We derive the module directory from `fileURLToPath(moduleUrl)` directly
+// (not via `new URL(rel, moduleUrl)`) because under the jsdom test env the
+// global `URL` resolves relative inputs against the page origin, not the file.
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Default candidate locations for the built bundle relative to `moduleUrl`, in
+ * priority order. Mirrors the historical wdio layout:
+ *   - Published: `dist/<loader>.js` sits next to `dist/rrweb-bundle.js`.
+ *   - Source/test: `src/<loader>.ts` → `../dist/rrweb-bundle.js`.
+ */
+function defaultCandidatePaths(moduleUrl) {
+    const moduleDir = dirname(fileURLToPath(moduleUrl));
+    return [join(moduleDir, 'rrweb-bundle.js'), join(moduleDir, '..', 'dist', 'rrweb-bundle.js')];
+}
+/**
+ * Read the rrweb in-page bundle source (defines `window.rrweb`) off disk.
+ *
+ * @param moduleUrl       the calling adapter's `import.meta.url`; candidate
+ *                        paths resolve relative to this module.
+ * @param candidatePaths  optional explicit candidate paths (overrides the
+ *                        defaults). The first that exists is read.
+ * @returns the bundle source string.
+ * @throws if no candidate exists — that means the package was used without its
+ *   build step having run.
+ */
+export function loadRrwebBundle(moduleUrl, candidatePaths) {
+    const candidates = candidatePaths && candidatePaths.length > 0 ? candidatePaths : defaultCandidatePaths(moduleUrl);
+    const found = candidates.find((p) => existsSync(p));
+    if (found === undefined) {
+        throw new Error(`tracelane: in-page rrweb bundle not found (looked in ${candidates.join(', ')}). Run the package build to generate dist/rrweb-bundle.js.`);
+    }
+    return readFileSync(found, 'utf8');
+}
+//# sourceMappingURL=load-rrweb-bundle.js.map

package/dist/load-rrweb-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-rrweb-bundle.js","sourceRoot":"","sources":["../src/load-rrweb-bundle.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,2DAA2D;AAC3D,yEAAyE;AACzE,+EAA+E;AAC/E,+DAA+D;AAC/D,EAAE;AACF,mEAAmE;AACnE,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,2EAA2E;AAC3E,+EAA+E;AAE/E,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,SAAiB;IAC9C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAChG,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,cAAyB;IAC1E,MAAM,UAAU,GACd,cAAc,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAClG,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACpD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACb,wDAAwD,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,4DAA4D,CAC1I,CAAC;IACJ,CAAC;IACD,OAAO,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACrC,CAAC"}

package/dist/network-capture.d.ts

@@ -0,0 +1,38 @@
+import type { BrowserExecutor } from './browser-executor.js';
+/**
+ * Page-side logger. Self-contained (no Node closures) so it can be
+ * `.toString()`-serialized by `execute` (PRD §A.4). The console plugin captures
+ * this `console.error`; the `[tracelane.net]` prefix lets the report's network
+ * panel scrape it back out (PRD §E.2).
+ *
+ * The status is zero-padded to 3 digits so it satisfies panels.ts's
+ * `parseNetConsoleLine` regex (`(\d{3})`); `Number('000')` parses back to a
+ * genuine `0`, which — paired with the always-present method — panels.ts treats
+ * as a true network failure.
+ */
+declare function logNetworkErrorInPage(url: string, status: number, method: string): void;
+/** Pull the request method out of CDP request headers, defaulting to GET. */
+declare function methodOf(headers: Record<string, string> | undefined): string;
+/**
+ * Attach CDP network capture to a BrowserExecutor (P1 PRD §E.2).
+ *
+ * Enables the Network domain and registers subscribers that forward both HTTP
+ * error responses (`Network.responseReceived`, `status >= 400`) and no-response
+ * failures (`Network.loadingFailed` — CORS/DNS/offline/abort, audit A-6) into
+ * `console.error`. Resolves once `Network.enable` has been sent. The
+ * subscribers' own `execute` calls are fire-and-forget (their failures must not
+ * break the test).
+ *
+ * To give the methodless `loadingFailed` events a method (required by panels.ts
+ * to classify the row as failed), we keep a small `requestId → { method, url }`
+ * map populated from `Network.requestWillBeSent`, and evict an entry once it has
+ * either succeeded (`responseReceived`) or failed (`loadingFailed`) so the map
+ * can't grow unbounded over a long session.
+ */
+export declare function attachNetworkCapture(executor: BrowserExecutor): Promise<void>;
+export declare const __internal: {
+    logNetworkErrorInPage: typeof logNetworkErrorInPage;
+    methodOf: typeof methodOf;
+};
+export {};
+//# sourceMappingURL=network-capture.d.ts.map

package/dist/network-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-capture.d.ts","sourceRoot":"","sources":["../src/network-capture.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAoC7D;;;;;;;;;;GAUG;AACH,iBAAS,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMhF;AAED,6EAA6E;AAC7E,iBAAS,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAKrE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDnF;AAGD,eAAO,MAAM,UAAU;;;CAAsC,CAAC"}

package/dist/network-capture.js

@@ -0,0 +1,125 @@
+// CDP network capture wiring (Task 2.16 / P1 PRD §E.2).
+//
+// Enable the CDP Network domain and route failures into the page's
+// `console.error` via `executor.execute`. Two failure classes are surfaced:
+//
+//   1. `Network.responseReceived` with `status >= 400` — a response arrived
+//      but the server reported an HTTP error (4xx/5xx).
+//   2. `Network.loadingFailed` — the request produced NO response at all
+//      (CORS failure, DNS/connection failure, offline, abort). CDP's
+//      `responseReceived` never fires for these, and the in-page status-0
+//      wrapper is off by default, so without this branch a genuine failed
+//      request would be invisible (audit A-6). We surface it with an explicit
+//      status `000` (= a real 0 once parsed) so it reads as a true failure.
+//
+// The rrweb console plugin (installed by the recorder) then captures the
+// console line, so failures show up in the report's network panel "for free" —
+// no dedicated network transport in v1. Framework-agnostic: it talks only to a
+// BrowserExecutor, so the WDIO and Playwright adapters share this one path.
+//
+// The console line is prefixed `[tracelane.net]` so @tracelane/report's network
+// panel can scrape it back out (NETWORK_CONSOLE_PREFIX in panels.ts). The line
+// ALWAYS carries a METHOD: panels.ts classifies a `status === 0` scrape row as
+// a true failure only when a method is present (its "true error path" rule —
+// see `isTrueErrorPath`), so a methodless `loadingFailed` line would be
+// silently dropped from the panel.
+/** Status sentinel for a request that produced no response (a true 0 once parsed). */
+const NO_RESPONSE_STATUS = 0;
+/**
+ * Page-side logger. Self-contained (no Node closures) so it can be
+ * `.toString()`-serialized by `execute` (PRD §A.4). The console plugin captures
+ * this `console.error`; the `[tracelane.net]` prefix lets the report's network
+ * panel scrape it back out (PRD §E.2).
+ *
+ * The status is zero-padded to 3 digits so it satisfies panels.ts's
+ * `parseNetConsoleLine` regex (`(\d{3})`); `Number('000')` parses back to a
+ * genuine `0`, which — paired with the always-present method — panels.ts treats
+ * as a true network failure.
+ */
+function logNetworkErrorInPage(url, status, method) {
+    // Zero-pad to 3 digits without String.padStart so the .toString()-serialized
+    // form runs on older in-page engines too.
+    let code = String(status);
+    while (code.length < 3)
+        code = `0${code}`;
+    console.error(`[tracelane.net] ${method} ${code} ${url}`);
+}
+/** Pull the request method out of CDP request headers, defaulting to GET. */
+function methodOf(headers) {
+    if (!headers)
+        return 'GET';
+    // CDP exposes the pseudo-header `:method` for HTTP/2/3; fall back to a plain
+    // `method` header, then GET.
+    return headers[':method'] ?? headers.method ?? 'GET';
+}
+/**
+ * Attach CDP network capture to a BrowserExecutor (P1 PRD §E.2).
+ *
+ * Enables the Network domain and registers subscribers that forward both HTTP
+ * error responses (`Network.responseReceived`, `status >= 400`) and no-response
+ * failures (`Network.loadingFailed` — CORS/DNS/offline/abort, audit A-6) into
+ * `console.error`. Resolves once `Network.enable` has been sent. The
+ * subscribers' own `execute` calls are fire-and-forget (their failures must not
+ * break the test).
+ *
+ * To give the methodless `loadingFailed` events a method (required by panels.ts
+ * to classify the row as failed), we keep a small `requestId → { method, url }`
+ * map populated from `Network.requestWillBeSent`, and evict an entry once it has
+ * either succeeded (`responseReceived`) or failed (`loadingFailed`) so the map
+ * can't grow unbounded over a long session.
+ */
+export async function attachNetworkCapture(executor) {
+    await executor.cdp('Network', 'enable');
+    // Correlation map: a `loadingFailed` carries only a requestId, so remember the
+    // method + url from `requestWillBeSent` to reconstruct a method-bearing line.
+    const inflight = new Map();
+    const emit = (url, status, method) => {
+        // Fire-and-forget: a logging failure (e.g. page mid-navigation) must not
+        // surface as a test error.
+        void executor
+            .execute(logNetworkErrorInPage, url, status, method)
+            .catch(() => {
+            /* page may be navigating; drop this one line */
+        });
+    };
+    executor.on('Network.requestWillBeSent', (params) => {
+        const e = params;
+        const id = e?.requestId;
+        const url = e?.request?.url;
+        if (typeof id !== 'string' || typeof url !== 'string')
+            return;
+        const method = typeof e.request?.method === 'string' ? e.request.method : 'GET';
+        inflight.set(id, { method, url });
+    });
+    executor.on('Network.responseReceived', (params) => {
+        const e = params;
+        const response = e?.response;
+        // A response arrived — this request will not surface via loadingFailed, so
+        // drop it from the inflight map regardless of status.
+        if (typeof e?.requestId === 'string')
+            inflight.delete(e.requestId);
+        const status = response?.status;
+        if (typeof status !== 'number' || status < 400)
+            return;
+        const url = response?.url ?? '';
+        const method = methodOf(response?.requestHeaders);
+        emit(url, status, method);
+    });
+    executor.on('Network.loadingFailed', (params) => {
+        const e = params;
+        const id = e?.requestId;
+        // Correlate back to the request's method + url; CORS/DNS/offline/abort
+        // failures produce NO response, so this is the only place they surface.
+        const tracked = typeof id === 'string' ? inflight.get(id) : undefined;
+        if (typeof id === 'string')
+            inflight.delete(id);
+        const url = tracked?.url ?? '';
+        // Method is required for panels.ts to treat the status-0 row as a failure;
+        // default to GET if the requestWillBeSent was missed (e.g. attach mid-flight).
+        const method = tracked?.method ?? 'GET';
+        emit(url, NO_RESPONSE_STATUS, method);
+    });
+}
+// Exposed for unit tests: the page-side logger + method resolver are pure.
+export const __internal = { logNetworkErrorInPage, methodOf };
+//# sourceMappingURL=network-capture.js.map

package/dist/network-capture.js.map

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

package/dist/page-script.d.ts

@@ -30,14 +30,15 @@ export declare const DEFAULT_CONSOLE_PLUGIN_OPTIONS: ConsolePluginOptions;
  */
 export type NetworkPluginOptions = Record<string, unknown>;
 /**
- * The in-page init routine (PRD §D.3 + ADR-0006). Idempotent across calls via a
- * monotonic `__tracelane__sessionId` stamp and a cooldown guard so hash-only /
- * HMR navigations don't double-init the recorder (the cooldown / re-injection
- * semantics are exercised in Task 2.4).
+ * The in-page init routine (PRD §D.3 + ADR-0006). A cooldown guard suppresses
+ * double-init on hash-only / HMR navigations within the SAME document. Note the
+ * `__tracelane__sessionId` stamp is page-local: it resets to 1 in every fresh
+ * document (a hard navigation), so it is NOT a cross-document monotonic counter.
  *
  * Assumes `window.rrweb` is already defined (the recorder injects the rrweb
- * bundle string first). Returns the active session id so the Node side can
- * confirm whether a (re-)init actually took effect.
+ * bundle string first). Returns a sentinel the Node side uses to decide whether
+ * a fresh recording actually started: `0` when this call was cooldown-suppressed
+ * (no new recording), or the active (≥1) session id when recording (re-)started.
  *
  * `networkOptions === undefined` keeps the network plugin OFF (the legacy
  * CDP-based path still applies). `networkOptions === {}` opts in with the

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

@@ -1 +1 @@
-{"version":3,"file":"page-script.d.ts","sourceRoot":"","sources":["../src/page-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,6CAA6C;AAC7C,eAAO,MAAM,8BAA8B,EAAE,oBAI5C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,oBAAoB,EACpC,cAAc,CAAC,EAAE,oBAAoB,GACpC,MAAM,CAsDR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,EAAE,CAKhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAKhE"}
+{"version":3,"file":"page-script.d.ts","sourceRoot":"","sources":["../src/page-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE;QACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;QAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,6CAA6C;AAC7C,eAAO,MAAM,8BAA8B,EAAE,oBAI5C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE3D;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE,oBAAoB,EACpC,cAAc,CAAC,EAAE,oBAAoB,GACpC,MAAM,CAuGR;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,EAAE,CAKhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAKhE"}

package/dist/page-script.js

@@ -14,14 +14,15 @@ export const DEFAULT_CONSOLE_PLUGIN_OPTIONS = {
     stringifyOptions: { stringLengthLimit: 1000, numOfKeysLimit: 100, depthOfLimit: 1 },
 };
 /**
- * The in-page init routine (PRD §D.3 + ADR-0006). Idempotent across calls via a
- * monotonic `__tracelane__sessionId` stamp and a cooldown guard so hash-only /
- * HMR navigations don't double-init the recorder (the cooldown / re-injection
- * semantics are exercised in Task 2.4).
+ * The in-page init routine (PRD §D.3 + ADR-0006). A cooldown guard suppresses
+ * double-init on hash-only / HMR navigations within the SAME document. Note the
+ * `__tracelane__sessionId` stamp is page-local: it resets to 1 in every fresh
+ * document (a hard navigation), so it is NOT a cross-document monotonic counter.
  *
  * Assumes `window.rrweb` is already defined (the recorder injects the rrweb
- * bundle string first). Returns the active session id so the Node side can
- * confirm whether a (re-)init actually took effect.
+ * bundle string first). Returns a sentinel the Node side uses to decide whether
+ * a fresh recording actually started: `0` when this call was cooldown-suppressed
+ * (no new recording), or the active (≥1) session id when recording (re-)started.
  *
  * `networkOptions === undefined` keeps the network plugin OFF (the legacy
  * CDP-based path still applies). `networkOptions === {}` opts in with the
@@ -33,13 +34,57 @@ export function tracelaneInitScript(cooldownMs, consoleOptions, networkOptions)
     const w = window;
     const now = Date.now();
     // Cooldown: a very recent init means this is a hash/HMR re-render, not a real
-    // navigation — skip to avoid double-recording (ADR-0006).
+    // navigation — skip to avoid double-recording (ADR-0006). Return the `0`
+    // sentinel so the Node side can tell "suppressed" apart from a fresh recording
+    // (the in-page session id resets to 1 on every new document, so it can't be
+    // used as a monotonic signal across hard navigations).
     if (w.__tracelane__inited !== undefined && now - w.__tracelane__inited < cooldownMs) {
-        return w.__tracelane__sessionId ?? 0;
+        return 0;
     }
     w.__tracelane__inited = now;
     w.__tracelane__sessionId = (w.__tracelane__sessionId ?? 0) + 1;
     w.__tracelane__events = w.__tracelane__events ?? [];
+    // Pre-navigation rescue (Fix #2): the in-page event buffer dies on a hard
+    // navigation before the Node poll drains it. The OLD document stashes its
+    // unflushed tail into sessionStorage on `pagehide`; this fresh document merges
+    // it back in on init, then clears the key so it's consumed exactly once.
+    // Best-effort: sessionStorage may be unavailable (private mode) or the value
+    // may be malformed — never let that break recording.
+    try {
+        const pending = w.sessionStorage?.getItem('__tracelane__pending');
+        if (pending) {
+            const parsed = JSON.parse(pending);
+            if (Array.isArray(parsed) && parsed.length > 0) {
+                w.__tracelane__events.push(...parsed);
+            }
+            w.sessionStorage?.removeItem('__tracelane__pending');
+        }
+    }
+    catch {
+        // sessionStorage unavailable / parse failure — best-effort, ignore.
+    }
+    // Register the `pagehide` flush once per document. On teardown it stashes the
+    // live buffer (only post-last-drain events remain, since drain read-and-clears)
+    // into sessionStorage so the next document can merge it.
+    if (w.__tracelane__pagehideBound !== true && typeof w.addEventListener === 'function') {
+        w.__tracelane__pagehideBound = true;
+        w.addEventListener('pagehide', () => {
+            try {
+                const events = w.__tracelane__events ?? [];
+                if (events.length === 0)
+                    return;
+                const json = JSON.stringify(events);
+                // Size guard: sessionStorage quota is ~5 MB; bail well under it rather
+                // than throw a QuotaExceededError mid-teardown.
+                if (json.length > 4_000_000)
+                    return;
+                w.sessionStorage?.setItem('__tracelane__pending', json);
+            }
+            catch {
+                // private mode / quota / serialization failure — best-effort, ignore.
+            }
+        });
+    }
     if (w.rrweb !== undefined) {
         // Tear down any prior recorder before starting a fresh one (re-injection).
         if (typeof w.__tracelane__stop === 'function') {

package/dist/page-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"page-script.js","sourceRoot":"","sources":["../src/page-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAaH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,8BAA8B,GAAyB;IAClE,KAAK,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC;IACvC,eAAe,EAAE,KAAK;IACtB,gBAAgB,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE;CACpF,CAAC;AAaF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkB,EAClB,cAAoC,EACpC,cAAqC;IAErC,MAAM,CAAC,GAAG,MAYT,CAAC;IAEF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,8EAA8E;IAC9E,0DAA0D;IAC1D,IAAI,CAAC,CAAC,mBAAmB,KAAK,SAAS,IAAI,GAAG,GAAG,CAAC,CAAC,mBAAmB,GAAG,UAAU,EAAE,CAAC;QACpF,OAAO,CAAC,CAAC,sBAAsB,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,CAAC,CAAC,mBAAmB,GAAG,GAAG,CAAC;IAC5B,CAAC,CAAC,sBAAsB,GAAG,CAAC,CAAC,CAAC,sBAAsB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/D,CAAC,CAAC,mBAAmB,GAAG,CAAC,CAAC,mBAAmB,IAAI,EAAE,CAAC;IAEpD,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1B,2EAA2E;QAC3E,IAAI,OAAO,CAAC,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC9C,IAAI,CAAC;gBACH,CAAC,CAAC,iBAAiB,EAAE,CAAC;YACxB,CAAC;YAAC,MAAM,CAAC;gBACP,uDAAuD;YACzD,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAc,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC;QAC5E,IAAI,cAAc,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,KAAK,CAAC,sBAAsB,KAAK,UAAU,EAAE,CAAC;YACzF,yEAAyE;YACzE,4DAA4D;YAC5D,uCAAuC;YACvC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1B,IAAI,CAAC,KAAc;gBACjB,qEAAqE;gBACrE,+BAA+B;gBAC9B,CAAC,CAAC,mBAAiC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnD,CAAC;YACD,OAAO;SACR,CAAC,CAAC;QACH,CAAC,CAAC,iBAAiB,GAAG,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAE,IAAmB,CAAC,CAAC,CAAC,SAAS,CAAC;IACtF,CAAC;IAED,OAAO,CAAC,CAAC,sBAAsB,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,CAAC,GAAG,MAAwD,CAAC;IACnE,MAAM,GAAG,GAAG,CAAC,CAAC,mBAAmB,IAAI,EAAE,CAAC;IACxC,CAAC,CAAC,mBAAmB,GAAG,EAAE,CAAC;IAC3B,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,EAAU;IACxD,MAAM,CAAC,GAAG,MAET,CAAC;IACF,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,eAAe,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC;AAClE,CAAC"}
+{"version":3,"file":"page-script.js","sourceRoot":"","sources":["../src/page-script.ts"],"names":[],"mappings":"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"}

package/dist/recorder.d.ts

@@ -4,8 +4,14 @@ import { type Mode } from './mode.js';
 import { type ConsolePluginOptions, type NetworkPluginOptions } from './page-script.js';
 /** Default re-injection cooldown in ms (ADR-0006). */
 export declare const DEFAULT_COOLDOWN_MS = 250;
-/** Default Node-side poll interval in ms (ADR-0006). */
-export declare const DEFAULT_DRAIN_INTERVAL_MS = 5000;
+/**
+ * Default Node-side poll interval in ms (ADR-0006). Kept short so events
+ * buffered on a document right before a hard navigation are drained before the
+ * navigation tears the page (and the in-page buffer) down. The `pagehide` flush
+ * in the init script is the belt-and-suspenders rescue for whatever the poll
+ * misses in the final window.
+ */
+export declare const DEFAULT_DRAIN_INTERVAL_MS = 500;
 export interface RecorderOptions {
     /** The framework-agnostic driver (ADR-0004). */
     executor: BrowserExecutor;
@@ -15,7 +21,7 @@ export interface RecorderOptions {
      * is bundle-source-agnostic and never imports rrweb for in-page injection.
      */
     rrwebBundle: string;
-    /** Node-side drain poll interval (default 5000). */
+    /** Node-side drain poll interval (default 500). */
     drainIntervalMs?: number;
     /** Re-injection cooldown guard (default 250). */
     cooldownMs?: number;
@@ -54,9 +60,10 @@ export interface Recorder {
     start(): Promise<void>;
     /**
      * Re-inject after a navigation (ADR-0006). The in-page cooldown guard
-     * suppresses double-init on hash-only / HMR navigations; when a real re-init
-     * takes effect (the monotonic session id advances) a `tracelane.nav` boundary
-     * event is appended. Returns `true` if a re-init actually happened.
+     * suppresses double-init on hash-only / HMR navigations (init returns the `0`
+     * sentinel); when a real re-init takes effect (init returns a session id
+     * `>= 1`) a `tracelane.nav` boundary event is appended. Returns `true` if a
+     * re-init actually happened.
      */
     reinject(url: string): Promise<boolean>;
     /** Read+clear the page buffer, merge into the Node buffer, return the batch. */

package/dist/recorder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,IAAI,EAAe,MAAM,WAAW,CAAC;AACnD,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAI1B,MAAM,kBAAkB,CAAC;AAE1B,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC,wDAAwD;AACxD,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,gFAAgF;IAChF,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAClC,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxD,0DAA0D;IAC1D,SAAS,IAAI,aAAa,EAAE,CAAC;CAC9B;AASD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAiGjE"}
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../src/recorder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,IAAI,EAAe,MAAM,WAAW,CAAC;AACnD,OAAO,EACL,KAAK,oBAAoB,EAEzB,KAAK,oBAAoB,EAI1B,MAAM,kBAAkB,CAAC;AAE1B,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,MAAM,CAAC;AACvC;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,MAAM,WAAW,eAAe;IAC9B,gDAAgD;IAChD,QAAQ,EAAE,eAAe,CAAC;IAC1B;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C;;;OAGG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B,iEAAiE;IACjE,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kEAAkE;IAClE,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,8EAA8E;IAC9E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,gFAAgF;IAChF,KAAK,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;IAClC,8CAA8C;IAC9C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB;;;;;;OAMG;IACH,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACxD,0DAA0D;IAC1D,SAAS,IAAI,aAAa,EAAE,CAAC;CAC9B;AASD,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAkGjE"}

package/dist/recorder.js

@@ -2,8 +2,14 @@ import { resolveMode } from './mode.js';
 import { DEFAULT_CONSOLE_PLUGIN_OPTIONS, tracelaneDrainScript, tracelaneInitScript, tracelaneNavScript, } from './page-script.js';
 /** Default re-injection cooldown in ms (ADR-0006). */
 export const DEFAULT_COOLDOWN_MS = 250;
-/** Default Node-side poll interval in ms (ADR-0006). */
-export const DEFAULT_DRAIN_INTERVAL_MS = 5000;
+/**
+ * Default Node-side poll interval in ms (ADR-0006). Kept short so events
+ * buffered on a document right before a hard navigation are drained before the
+ * navigation tears the page (and the in-page buffer) down. The `pagehide` flush
+ * in the init script is the belt-and-suspenders rescue for whatever the poll
+ * misses in the final window.
+ */
+export const DEFAULT_DRAIN_INTERVAL_MS = 500;
 /** Inject + eval the rrweb bundle string in the page (defines `window.rrweb`). */
 function injectBundleScript(bundle) {
     // window.eval runs the bundle in global page scope (so `window.rrweb` becomes
@@ -15,28 +21,30 @@ export function createRecorder(options) {
     const buffer = [];
     let pollTimer;
     let started = false;
-    // Last session id we've observed from the page; advances only when an init
-    // actually takes effect (i.e. wasn't suppressed by the cooldown guard).
-    let lastSessionId = 0;
-    /** Run the init script in-page and return the active session id. */
+    /**
+     * Run the init script in-page. Returns the active session id: `0` means the
+     * in-page cooldown suppressed this init (a same-document hash/HMR re-render,
+     * no fresh recording started); `>= 1` means a recording actually (re)started.
+     * The in-page init is the authority — Node never tracks session ids itself,
+     * because the in-page id resets to 1 on every fresh document (a hard nav) and
+     * a Node-side monotonic counter would mis-classify post-first-nav loads as
+     * cooldown-suppressed.
+     */
     async function runInit() {
         return executor.execute(tracelaneInitScript, cooldownMs, consolePluginOptions, networkPluginOptions);
     }
     async function inject() {
         await executor.execute(injectBundleScript, rrwebBundle);
-        lastSessionId = await runInit();
+        await runInit();
     }
     async function reinject(url) {
         // Re-eval the bundle (the page may have been torn down by navigation), then
-        // re-run init. The cooldown guard inside the init script decides whether a
-        // fresh recorder actually starts.
+        // re-run init. The init script's return value is the authority on whether a
+        // fresh recording started.
         await executor.execute(injectBundleScript, rrwebBundle);
-        const sessionId = await runInit();
-        if (sessionId <= lastSessionId) {
-            // Suppressed by cooldown — no navigation boundary to record.
-            return false;
-        }
-        lastSessionId = sessionId;
+        const sid = await runInit();
+        if (sid === 0)
+            return false; // cooldown-suppressed (same-doc hash/HMR); no nav boundary
         await executor.execute(tracelaneNavScript, url, Date.now());
         return true;
     }

package/dist/recorder.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tracelane/core",
-  "version": "0.1.0-alpha.10",
+  "version": "0.1.0-alpha.12",
   "description": "Framework-agnostic rrweb recording engine for tracelane. Wraps a per-framework browser object behind a common BrowserExecutor interface.",
   "keywords": [
     "tracelane",