@tracelane/wdio 0.1.0-alpha.1

package/NOTICE

@@ -0,0 +1,19 @@
+rrweb-stack
+Copyright 2026 Cubenest
+
+This product includes software developed by:
+- PostHog (https://posthog.com) — vendored rrweb fork, bundled (via esbuild) into
+  the in-page recorder injected by this Service:
+    @posthog/rrweb 0.0.34 (MIT License)
+    @posthog/rrweb-types 0.0.24 (MIT License)
+  Forked from upstream rrweb-io/rrweb 2.0.0-alpha.17. Re-exported through
+  @cubenest/rrweb-core.
+- rrweb contributors (https://github.com/rrweb-io/rrweb) — console-record plugin:
+    @rrweb/rrweb-plugin-console-record 2.0.0-alpha.20 (MIT License) — bundled into
+    the in-page recorder.
+
+The rrweb player + report assets are inlined by @tracelane/report; see that
+package's NOTICE.
+
+This product is licensed under the Apache License, Version 2.0.
+See the LICENSE file for details.

package/README.md

@@ -0,0 +1,138 @@
+# @tracelane/wdio
+
+A [WebdriverIO](https://webdriver.io) **Service** that records an [rrweb](https://www.rrweb.io)-grade session of your test run and, on a failed test, writes a **single self-contained `.html` report** to `./tracelane-reports/` — replay, console panel, and failed-network panel, all offline in one file.
+
+```ts
+// wdio.conf.ts
+import type { Options } from '@wdio/types';
+import TraceLaneService from '@tracelane/wdio';
+
+export const config: Options.Testrunner = {
+  runner: 'local',
+  framework: 'mocha',
+  specs: ['./test/specs/**/*.ts'],
+  capabilities: [
+    {
+      browserName: 'chrome',
+      'goog:chromeOptions': { args: ['--remote-debugging-port=9222', '--no-sandbox'] },
+    },
+  ],
+  services: [
+    ['devtools', {}], // enables browser.cdp(...) for network capture — see "Network capture" below
+    [
+      TraceLaneService,
+      {
+        mode: process.env.TRACELANE_MODE ?? 'failed', // 'failed' | 'all'
+        outDir: './tracelane-reports',
+        capture: { rrweb: true, network: true, console: true },
+      },
+    ],
+  ],
+  reporters: ['spec'],
+};
+```
+
+Run your suite. On a failing Chrome+Mocha test you get `./tracelane-reports/<spec>--<title>--<cid>-<ts>.html` — open it in any browser, fully offline.
+
+## Install
+
+```sh
+pnpm add -D @tracelane/wdio webdriverio @wdio/cli @wdio/local-runner @wdio/mocha-framework
+```
+
+`webdriverio` and `@wdio/types` are **peer dependencies** (`^9.0.0`); you already have them in a WDIO project.
+
+## How it works
+
+- On the first test, the Service injects an rrweb recorder bundle into the page and installs an in-page event buffer (`window.__tracelane__events`).
+- The Node side drains that buffer on a poll (default every 5 s) and on every `afterTest`, re-injecting on navigation ([ADR-0006](https://github.com/Cubenest/rrweb-stack/blob/main/prds/adrs/0006-p1-in-page-buffer-node-polled.md)).
+- In `failed` mode (default) a passing test discards its buffer; a failing test's buffer is handed to [`@tracelane/report`](https://github.com/Cubenest/rrweb-stack/tree/main/packages/tracelane-report), which builds the single offline HTML (≤ 25 MB, [ADR-0005](https://github.com/Cubenest/rrweb-stack/blob/main/prds/adrs/0005-p1-failed-only-self-contained-html.md)).
+
+## Options
+
+| Option | Type | Default | Notes |
+|---|---|---|---|
+| `mode` | `'failed' \| 'all'` | `'failed'` | `failed` writes a report only on failure; `all` on every test. `TRACELANE_MODE` env var overrides this. |
+| `outDir` | `string` | `'./tracelane-reports'` | Report output directory (created if missing). |
+| `capture.rrweb` | `boolean` | `true` | Record the rrweb session. |
+| `capture.network` | `boolean` | `true` | Route failed responses (`status >= 400`) into the console timeline via CDP. |
+| `capture.console` | `boolean` | `true` | Capture `console.*` via the rrweb console plugin. Setting this `false` also drops the `[tracelane.net]` network-error lines, since `capture.network` surfaces them through `console.error`. |
+| `drainIntervalMs` | `number` | `5000` | Node-side drain poll interval. |
+| `cooldownMs` | `number` | `250` | Re-injection cooldown guard (suppresses double-init on hash/HMR navigation). |
+| `allure` | `boolean` | `false` | Reserved for the v1.1 Allure shim. No-op in v1. |
+| `visualDiff` | `boolean` | `false` | Reserved for the post-MVP visual-diff add-on. No-op in v1. |
+
+The options type is published — `import type { TraceLaneOptions } from '@tracelane/wdio'`.
+
+## Hook-factory alternative (no Service)
+
+For setups that can't register a Service, the **same logic** is available as plain `wdio.conf.ts` hook functions ([ADR-0004](https://github.com/Cubenest/rrweb-stack/blob/main/prds/adrs/0004-p1-wdio-service-not-reporter.md)):
+
+```ts
+import { traceLaneHooks } from '@tracelane/wdio/hooks';
+
+const tracelane = traceLaneHooks({ mode: 'failed', outDir: './tracelane-reports' });
+
+export const config: Options.Testrunner = {
+  // ...
+  beforeSession: tracelane.beforeSession,
+  before: tracelane.before,
+  beforeSuite: tracelane.beforeSuite,
+  beforeTest: tracelane.beforeTest,
+  beforeCommand: tracelane.beforeCommand, // re-injection on navigation
+  afterTest: tracelane.afterTest,
+  afterSuite: tracelane.afterSuite,
+  after: tracelane.after,
+  onComplete: tracelane.onComplete,
+};
+```
+
+## FAQ — Why is this a Service and not a Reporter?
+
+Because only a **Service** can do what `tracelane` needs ([ADR-0004](https://github.com/Cubenest/rrweb-stack/blob/main/prds/adrs/0004-p1-wdio-service-not-reporter.md)):
+
+| | Service (`Services.ServiceInstance`) | Reporter (`@wdio/reporter`) |
+|---|---|---|
+| Access to live `browser` in worker hooks | **Yes** | No — reporters run in the launcher process |
+| `browser.execute(...)` to inject rrweb / drain the buffer | **Yes** | No |
+| `browser.cdp(...)` for network capture | **Yes** | No |
+
+A Reporter receives only serialized lifecycle events (`testFail`, `testEnd`, …) in the launcher process — it has no page handle, so it can't inject rrweb, drain the in-page buffer, or attach CDP. (`wdio-allure-reporter` hit exactly this wall and had to add a runtime-side `addAttachment` helper to bridge browser access.) A paired Allure **Reporter** shim is planned for v1.1 to push `tracelane` artifacts into Allure's `addAttachment` API — that's a Reporter-shaped problem; capture is not.
+
+## Network capture
+
+Failed responses (`status >= 400`) are routed into the report's console timeline (prefixed `[tracelane.net]`, [P1 PRD §E.2](https://github.com/Cubenest/rrweb-stack/blob/main/prds/compass_artifact_wf-d53d32da-17e9-41b5-bb70-21dd1bf648c6_text_markdown.md)). This needs `browser.cdp(...)`, which a separate WDIO service provides:
+
+- **WDIO 8:** add `['devtools', {}]` via `@wdio/devtools-service@8`.
+- **WDIO 9:** `@wdio/devtools-service` has no stable v9 line (it stabilized at v10); use the v10 service or a CDP-capable session. **If `browser.cdp` is unavailable, `tracelane` degrades gracefully to rrweb + console capture** — the report is still produced, just without the network panel.
+
+Cloud Selenium vendors typically don't expose CDP; rrweb + console capture still work there.
+
+## Supported runners / browsers
+
+| Runner | Status |
+|---|---|
+| Mocha | **Supported** (primary) |
+| Jasmine | Supported (same `afterTest` result shape) |
+| Cucumber | Supported via `beforeScenario`/`afterScenario` |
+
+| Browser | rrweb + console | Network (CDP) |
+|---|---|---|
+| Chrome / Chromium ≥ 116 | **Yes** | Yes (with a CDP-capable session) |
+| Edge (Chromium) | Yes | Yes |
+| Firefox | Yes | No (CDP is Chromium-only) |
+| Safari | Yes | No |
+
+## Versioning
+
+Semantic Versioning. Currently `0.1.0-alpha.0` (pre-release; the API may shift before `1.0.0`).
+
+## Telemetry
+
+None. `tracelane` collects and sends nothing; reports are written to your local `outDir` only.
+
+## License
+
+Apache 2.0. The bundled rrweb engine + console plugin remain MIT-licensed; see `NOTICE`.
+
+Contributions are accepted under the [Developer Certificate of Origin (DCO)](https://developercertificate.org/) — sign your commits with `git commit -s`.

package/dist/framework-result.d.ts

@@ -0,0 +1,21 @@
+import type { ReportStatus } from '@tracelane/report';
+/** The WDIO test frameworks tracelane recognizes (P1 PRD §A.2). */
+export type Framework = 'mocha' | 'jasmine' | 'cucumber';
+/** Framework-neutral outcome derived from a per-framework result object. */
+export interface NormalizedResult {
+    /** Whether the test/scenario passed. */
+    passed: boolean;
+    /** Report status string for the metadata header. */
+    status: ReportStatus;
+    /** Failure message, when failed/broken. */
+    error?: string;
+    /** Duration in milliseconds, when the framework reported one. */
+    durationMs?: number;
+}
+/**
+ * Normalize a test outcome across frameworks (P1 PRD §A.2). Switch on the
+ * `framework` from `wdio.conf`. The two positional args map to the hook
+ * signatures: Mocha/Jasmine call with `(result)`; Cucumber with `(world, result)`.
+ */
+export declare function normalizeResult(framework: Framework | string | undefined, a: unknown, b?: unknown): NormalizedResult;
+//# sourceMappingURL=framework-result.d.ts.map

package/dist/framework-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-result.d.ts","sourceRoot":"","sources":["../src/framework-result.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,4EAA4E;AAC5E,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,MAAM,EAAE,YAAY,CAAC;IACrB,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA+FD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,EACzC,CAAC,EAAE,OAAO,EACV,CAAC,CAAC,EAAE,OAAO,GACV,gBAAgB,CAMlB"}

package/dist/framework-result.js

@@ -0,0 +1,87 @@
+// Normalize the per-framework test-result shape (P1 PRD §A.2).
+//
+// Mocha & Jasmine deliver `afterTest(test, context, result)` where
+// `result = { error?, result?, duration, passed, retries }`. Cucumber has no
+// `afterTest`; it delivers `afterScenario(world, result)` where the outcome
+// lives on a `World` object (`world.result.status` / `.message`) and/or a
+// `PickleResult` (`{ passed, error, duration }`). We switch on the configured
+// framework and collapse all of them to one neutral shape the report builder
+// consumes (ReportStatus + error string + duration).
+/** Coerce an unknown error-ish value into a single-line message string. */
+function errorMessage(error) {
+    if (error === undefined || error === null)
+        return undefined;
+    if (typeof error === 'string')
+        return error;
+    if (error instanceof Error)
+        return error.stack ?? error.message;
+    const message = error.message;
+    if (typeof message === 'string')
+        return message;
+    const stack = error.stack;
+    if (typeof stack === 'string')
+        return stack;
+    return String(error);
+}
+/** Build a NormalizedResult, mapping `passed`/`skipped` to a ReportStatus. */
+function fromPassed(passed, opts) {
+    const status = opts.skipped
+        ? 'skipped'
+        : passed
+            ? 'passed'
+            : // A failure with an assertion message is 'failed'; one without (e.g. a
+                // thrown non-assertion error) is 'broken' in the Allure-style taxonomy.
+                opts.error
+                    ? 'failed'
+                    : 'broken';
+    const result = { passed, status };
+    if (opts.error !== undefined)
+        result.error = opts.error;
+    if (opts.durationMs !== undefined)
+        result.durationMs = opts.durationMs;
+    return result;
+}
+/** Normalize a Mocha/Jasmine `afterTest` result. */
+function normalizeMochaJasmine(result) {
+    const passed = result.passed === true;
+    return fromPassed(passed, {
+        error: errorMessage(result.error),
+        durationMs: typeof result.duration === 'number' ? result.duration : undefined,
+        skipped: result.skipped === true,
+    });
+}
+/**
+ * Normalize a Cucumber outcome. Cucumber's `afterScenario(world, result)` passes
+ * both a `World` (rich `result.status`/`message`) and a `PickleResult`
+ * (`{ passed, error }`); we read whichever is populated, preferring the explicit
+ * `PickleResult.passed` and falling back to `World.result.status`.
+ */
+function normalizeCucumber(world, result) {
+    const cukeStatus = world.result?.status?.toUpperCase();
+    const skipped = cukeStatus === 'SKIPPED' || cukeStatus === 'PENDING';
+    // Prefer the PickleResult.passed flag; otherwise derive from the World status.
+    const passed = result?.passed !== undefined ? result.passed === true : cukeStatus === 'PASSED';
+    const durationMs = world.result?.duration
+        ? world.result.duration.seconds * 1000 + world.result.duration.nanos / 1e6
+        : typeof result?.duration === 'number'
+            ? result.duration
+            : undefined;
+    return fromPassed(passed, {
+        error: result?.error ?? world.result?.message,
+        durationMs,
+        skipped,
+    });
+}
+/**
+ * Normalize a test outcome across frameworks (P1 PRD §A.2). Switch on the
+ * `framework` from `wdio.conf`. The two positional args map to the hook
+ * signatures: Mocha/Jasmine call with `(result)`; Cucumber with `(world, result)`.
+ */
+export function normalizeResult(framework, a, b) {
+    if (framework === 'cucumber') {
+        return normalizeCucumber((a ?? {}), b);
+    }
+    // mocha, jasmine, and any unknown framework all use the afterTest result shape.
+    return normalizeMochaJasmine((a ?? {}));
+}
+//# sourceMappingURL=framework-result.js.map

package/dist/framework-result.js.map

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

package/dist/hooks.d.ts

@@ -0,0 +1,34 @@
+import type { Frameworks } from '@wdio/types';
+import type { TraceLaneOptions } from './options.js';
+/** Options for {@link traceLaneHooks}. Same shape as the Service options. */
+export interface TraceLaneHookOptions extends TraceLaneOptions {
+    /**
+     * Test framework, so the result-shape switch (P1 PRD §A.2) is correct. The
+     * Service reads this from `config.framework`; the hook factory has no config
+     * arg, so pass it here (default `'mocha'`).
+     */
+    framework?: string;
+}
+/** The bound hook functions returned by {@link traceLaneHooks}. */
+export interface TraceLaneHooks {
+    beforeSession(config: unknown, capabilities: unknown, specs: string[], cid?: string): void;
+    before(capabilities: unknown, specs: string[], browser: WebdriverIO.Browser): Promise<void>;
+    beforeSuite(suite: Frameworks.Suite): void;
+    beforeTest(test: Frameworks.Test, context?: unknown): Promise<void>;
+    beforeCommand(commandName: string, args: unknown[]): Promise<void>;
+    afterTest(test: Frameworks.Test, context: unknown, result: Frameworks.TestResult): Promise<void>;
+    afterSuite(suite: Frameworks.Suite): void;
+    after(result: number, capabilities: unknown, specs: string[]): Promise<void>;
+    onComplete(exitCode: number, config: unknown, capabilities: unknown, results: unknown): void;
+    /** Cucumber scenario start (mirrors the Service; #3). */
+    beforeScenario(world: unknown, context?: unknown): Promise<void>;
+    /** Cucumber scenario end (mirrors the Service; #3). */
+    afterScenario(world: unknown, result?: unknown): Promise<void>;
+}
+/**
+ * Build a set of WDIO hook functions wired to one TraceLaneSession (P1 PRD §M.2).
+ * Returns the same logic the Service runs — just as standalone hooks, including
+ * the Cucumber `beforeScenario`/`afterScenario` pair (#3).
+ */
+export declare function traceLaneHooks(options?: TraceLaneHookOptions): TraceLaneHooks;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrD,6EAA6E;AAC7E,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mEAAmE;AACnE,MAAM,WAAW,cAAc;IAC7B,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3F,MAAM,CAAC,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,WAAW,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5F,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC;IAC3C,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,SAAS,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,GAAG,IAAI,CAAC;IAC1C,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7E,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7F,yDAAyD;IACzD,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,uDAAuD;IACvD,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,oBAAyB,GAAG,cAAc,CAoCjF"}

package/dist/hooks.js

@@ -0,0 +1,56 @@
+// traceLaneHooks — the hook-factory alternative to the Service (Task 2.15 /
+// ADR-0004 / P1 PRD §M.2).
+//
+// For users who can't (or don't want to) register a Service, this returns the
+// same capture logic as plain `wdio.conf.ts` hook functions wired to one shared
+// TraceLaneSession:
+//
+//   const tracelane = traceLaneHooks({ mode: 'failed', outDir: './tracelane-reports' })
+//   export const config = { before: tracelane.before, afterTest: tracelane.afterTest, ... }
+//
+// It is published at the `@tracelane/wdio/hooks` subpath so the Service stays the
+// default, discoverable surface.
+import { scenarioIdentity, testIdentity } from './test-identity.js';
+import { TraceLaneSession } from './tracelane-session.js';
+/**
+ * Build a set of WDIO hook functions wired to one TraceLaneSession (P1 PRD §M.2).
+ * Returns the same logic the Service runs — just as standalone hooks, including
+ * the Cucumber `beforeScenario`/`afterScenario` pair (#3).
+ */
+export function traceLaneHooks(options = {}) {
+    const session = new TraceLaneSession(options, options.framework ?? 'mocha');
+    return {
+        beforeSession(_config, _capabilities, _specs, cid) {
+            session.setCid(cid);
+        },
+        async before(_capabilities, _specs, browser) {
+            await session.onBefore(browser);
+        },
+        beforeSuite(_suite) { },
+        async beforeTest(test, _context) {
+            const { title, spec } = testIdentity(test);
+            await session.onBeforeTest(title, spec);
+        },
+        async beforeCommand(commandName, args) {
+            if (commandName === 'url' && typeof args[0] === 'string') {
+                await session.onUrl(args[0]);
+            }
+        },
+        async afterTest(_test, _context, result) {
+            await session.onAfterTest(result);
+        },
+        afterSuite(_suite) { },
+        async after(_result, _capabilities, _specs) {
+            await session.onAfter();
+        },
+        onComplete(_exitCode, _config, _capabilities, _results) { },
+        async beforeScenario(world, _context) {
+            const { title, spec } = scenarioIdentity(world);
+            await session.onBeforeTest(title, spec);
+        },
+        async afterScenario(world, result) {
+            await session.onAfterTest(world, result);
+        },
+    };
+}
+//# sourceMappingURL=hooks.js.map

package/dist/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,2BAA2B;AAC3B,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,oBAAoB;AACpB,EAAE;AACF,wFAAwF;AACxF,4FAA4F;AAC5F,EAAE;AACF,kFAAkF;AAClF,iCAAiC;AAIjC,OAAO,EAAiB,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AA8B1D;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,UAAgC,EAAE;IAC/D,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,CAAC;IAE5E,OAAO;QACL,aAAa,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG;YAC/C,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,OAAO;YACzC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAiC,CAAC,CAAC;QAC5D,CAAC;QACD,WAAW,CAAC,MAAM,IAAG,CAAC;QACtB,KAAK,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ;YAC7B,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,IAAgB,CAAC,CAAC;YACvD,MAAM,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,IAAI;YACnC,IAAI,WAAW,KAAK,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACzD,MAAM,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;QACD,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM;YACrC,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;QACD,UAAU,CAAC,MAAM,IAAG,CAAC;QACrB,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM;YACxC,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;QACD,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,IAAG,CAAC;QAC1D,KAAK,CAAC,cAAc,CAAC,KAAK,EAAE,QAAQ;YAClC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;YAChD,MAAM,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM;YAC/B,MAAM,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { default, default as TraceLaneService } from './service.js';
+export { traceLaneHooks } from './hooks.js';
+export type { TraceLaneHookOptions, TraceLaneHooks } from './hooks.js';
+export type { CaptureOptions, TraceLaneOptions } from './options.js';
+export { DEFAULT_OUT_DIR } from './options.js';
+export { createWdioExecutor } from './wdio-executor.js';
+export type { WdioBrowser } from './wdio-executor.js';
+export { normalizeResult } from './framework-result.js';
+export type { Framework, NormalizedResult } from './framework-result.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGpE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGvE,YAAY,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+// Public API surface for @tracelane/wdio.
+// The WebdriverIO Service — the default, recommended surface (ADR-0004, P1 PRD §M.1).
+export { default, default as TraceLaneService } from './service.js';
+// Hook-factory alternative (also published at `@tracelane/wdio/hooks`).
+export { traceLaneHooks } from './hooks.js';
+export { DEFAULT_OUT_DIR } from './options.js';
+// The BrowserExecutor adapter (advanced use / custom integrations).
+export { createWdioExecutor } from './wdio-executor.js';
+// Re-export the framework result-shape switch + the recognized framework union.
+export { normalizeResult } from './framework-result.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAE1C,sFAAsF;AACtF,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEpE,wEAAwE;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,oEAAoE;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/inpage-bundle.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The rrweb in-page bundle source (defines `window.rrweb`). Read from
+ * `dist/rrweb-bundle.js`, cached after first read.
+ *
+ * @throws if the bundle is missing — that means the package was used without its
+ *   build step (`pnpm --filter @tracelane/wdio build`) having run.
+ */
+export declare function loadRrwebBundle(): string;
+//# sourceMappingURL=inpage-bundle.d.ts.map

package/dist/inpage-bundle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inpage-bundle.d.ts","sourceRoot":"","sources":["../src/inpage-bundle.ts"],"names":[],"mappings":"AAgCA;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAWxC"}

package/dist/inpage-bundle.js

@@ -0,0 +1,47 @@
+// Loads the in-page rrweb bundle source string.
+//
+// The bundle (`dist/rrweb-bundle.js`) is produced at build time by
+// `scripts/build-rrweb-bundle.mjs` (esbuild → IIFE that defines `window.rrweb`
+// with `record` + `getRecordConsolePlugin`). @tracelane/core's 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.
+//
+// We read it once and cache it. In the published package this module compiles
+// to `dist/inpage-bundle.js`, sitting next to `dist/rrweb-bundle.js`; under
+// vitest the source lives in `src/`, so we also probe a sibling `../dist/`. We
+// derive the module directory from `fileURLToPath(import.meta.url)` directly
+// (not via `new URL(rel, import.meta.url)`) 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';
+let cached;
+/** Candidate locations for the built bundle, in priority order. */
+function candidatePaths() {
+    const moduleDir = dirname(fileURLToPath(import.meta.url));
+    return [
+        // Published layout: dist/inpage-bundle.js → dist/rrweb-bundle.js.
+        join(moduleDir, 'rrweb-bundle.js'),
+        // Source/test layout: src/inpage-bundle.ts → ../dist/rrweb-bundle.js.
+        join(moduleDir, '..', 'dist', 'rrweb-bundle.js'),
+    ];
+}
+/**
+ * The rrweb in-page bundle source (defines `window.rrweb`). Read from
+ * `dist/rrweb-bundle.js`, cached after first read.
+ *
+ * @throws if the bundle is missing — that means the package was used without its
+ *   build step (`pnpm --filter @tracelane/wdio build`) having run.
+ */
+export function loadRrwebBundle() {
+    if (cached !== undefined)
+        return cached;
+    const candidates = candidatePaths();
+    const found = candidates.find((p) => existsSync(p));
+    if (found === undefined) {
+        throw new Error(`@tracelane/wdio: in-page rrweb bundle not found (looked in ${candidates.join(', ')}). Run the package build (\`pnpm --filter @tracelane/wdio build\`) to generate it.`);
+    }
+    cached = readFileSync(found, 'utf8');
+    return cached;
+}
+//# sourceMappingURL=inpage-bundle.js.map

package/dist/inpage-bundle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inpage-bundle.js","sourceRoot":"","sources":["../src/inpage-bundle.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,mEAAmE;AACnE,+EAA+E;AAC/E,2EAA2E;AAC3E,+EAA+E;AAC/E,+DAA+D;AAC/D,EAAE;AACF,8EAA8E;AAC9E,4EAA4E;AAC5E,+EAA+E;AAC/E,6EAA6E;AAC7E,iFAAiF;AACjF,+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,IAAI,MAA0B,CAAC;AAE/B,mEAAmE;AACnE,SAAS,cAAc;IACrB,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,OAAO;QACL,kEAAkE;QAClE,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC;QAClC,sEAAsE;QACtE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,CAAC;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IACpC,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,8DAA8D,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,oFAAoF,CACxK,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/network-capture.d.ts

@@ -0,0 +1,25 @@
+import type { BrowserExecutor } from '@tracelane/core';
+/**
+ * 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).
+ */
+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 a `Network.responseReceived`
+ * subscriber that forwards 4xx/5xx responses into `console.error`. Resolves once
+ * `Network.enable` has been sent. The subscriber's own `execute` calls are
+ * fire-and-forget (their failures must not break the test).
+ */
+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":"AAWA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAWvD;;;;;GAKG;AACH,iBAAS,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAEhF;AAED,6EAA6E;AAC7E,iBAAS,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,GAAG,MAAM,CAKrE;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnF;AAGD,eAAO,MAAM,UAAU;;;CAAsC,CAAC"}

package/dist/network-capture.js

@@ -0,0 +1,56 @@
+// CDP network capture wiring (Task 2.16 / P1 PRD §E.2).
+//
+// Enable the CDP Network domain, subscribe to `Network.responseReceived`, and
+// route any response with `status >= 400` into the page's `console.error` via
+// `executor.execute`. The rrweb console plugin (installed by @tracelane/core's
+// recorder) then captures that console line, so failed responses show up in the
+// report's console panel "for free" — no dedicated network transport in v1.
+//
+// The console line is prefixed `[tracelane.net]` so @tracelane/report's network
+// panel can scrape it back out (NETWORK_CONSOLE_PREFIX in panels.ts).
+/**
+ * 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).
+ */
+function logNetworkErrorInPage(url, status, method) {
+    console.error(`[tracelane.net] ${method} ${status} ${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 a `Network.responseReceived`
+ * subscriber that forwards 4xx/5xx responses into `console.error`. Resolves once
+ * `Network.enable` has been sent. The subscriber's own `execute` calls are
+ * fire-and-forget (their failures must not break the test).
+ */
+export async function attachNetworkCapture(executor) {
+    await executor.cdp('Network', 'enable');
+    executor.on('Network.responseReceived', (params) => {
+        const response = params?.response;
+        const status = response?.status;
+        if (typeof status !== 'number' || status < 400)
+            return;
+        const url = response?.url ?? '';
+        const method = methodOf(response?.requestHeaders);
+        // 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 */
+        });
+    });
+}
+// 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":"AAAA,wDAAwD;AACxD,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,4EAA4E;AAC5E,EAAE;AACF,gFAAgF;AAChF,sEAAsE;AAatE;;;;;GAKG;AACH,SAAS,qBAAqB,CAAC,GAAW,EAAE,MAAc,EAAE,MAAc;IACxE,OAAO,CAAC,KAAK,CAAC,mBAAmB,MAAM,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,6EAA6E;AAC7E,SAAS,QAAQ,CAAC,OAA2C;IAC3D,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC3B,6EAA6E;IAC7E,6BAA6B;IAC7B,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;AACvD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAyB;IAClE,MAAM,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,CAAC,0BAA0B,EAAE,CAAC,MAAe,EAAE,EAAE;QAC1D,MAAM,QAAQ,GAAI,MAAgC,EAAE,QAAQ,CAAC;QAC7D,MAAM,MAAM,GAAG,QAAQ,EAAE,MAAM,CAAC;QAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,GAAG,GAAG;YAAE,OAAO;QACvD,MAAM,GAAG,GAAG,QAAQ,EAAE,GAAG,IAAI,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAClD,yEAAyE;QACzE,2BAA2B;QAC3B,KAAK,QAAQ;aACV,OAAO,CAAC,qBAAqD,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC;aACnF,KAAK,CAAC,GAAG,EAAE;YACV,gDAAgD;QAClD,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,UAAU,GAAG,EAAE,qBAAqB,EAAE,QAAQ,EAAE,CAAC"}

package/dist/options.d.ts

@@ -0,0 +1,36 @@
+import type { ConsolePluginOptions, Mode } from '@tracelane/core';
+/** Which capture channels are enabled (P1 PRD §M.1). */
+export interface CaptureOptions {
+    /** Record the rrweb session. Default true. */
+    rrweb?: boolean;
+    /** Attach CDP and route failed responses into the console timeline. Default true. */
+    network?: boolean;
+    /** Capture `console.*` via the rrweb console plugin. Default true. */
+    console?: boolean;
+}
+/** Options for {@link TraceLaneService} and {@link traceLaneHooks} (P1 PRD §M.1). */
+export interface TraceLaneOptions {
+    /**
+     * Capture mode (ADR-0005). `'failed'` (default) writes a report only on test
+     * failure; `'all'` writes one for every test. The `TRACELANE_MODE` env var
+     * overrides this at report-decision time.
+     */
+    mode?: Mode;
+    /** Directory to write reports into. Default `'./tracelane-reports'`. */
+    outDir?: string;
+    /** Reserved for the v1.1 Allure shim (ADR-0004). No-op in v1. Default false. */
+    allure?: boolean;
+    /** Per-channel capture toggles. */
+    capture?: CaptureOptions;
+    /** Reserved for the post-MVP visual-diff add-on (P1 PRD §H). No-op in v1. */
+    visualDiff?: boolean;
+    /** Node-side drain poll interval in ms (ADR-0006). Default 5000. */
+    drainIntervalMs?: number;
+    /** Re-injection cooldown guard in ms (ADR-0006). Default 250. */
+    cooldownMs?: number;
+    /** Options forwarded to the in-page rrweb console plugin. */
+    consolePluginOptions?: ConsolePluginOptions;
+}
+/** The default output directory for reports. */
+export declare const DEFAULT_OUT_DIR = "./tracelane-reports";
+//# sourceMappingURL=options.d.ts.map

package/dist/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAElE,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sEAAsE;IACtE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,wEAAwE;IACxE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mCAAmC;IACnC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oEAAoE;IACpE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;CAC7C;AAED,gDAAgD;AAChD,eAAO,MAAM,eAAe,wBAAwB,CAAC"}

package/dist/options.js

@@ -0,0 +1,4 @@
+// User-facing options for the WDIO Service / hook factory (P1 PRD §M.1).
+/** The default output directory for reports. */
+export const DEFAULT_OUT_DIR = './tracelane-reports';
+//# sourceMappingURL=options.js.map

package/dist/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/options.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAsCzE,gDAAgD;AAChD,MAAM,CAAC,MAAM,eAAe,GAAG,qBAAqB,CAAC"}