@tracelane/wdio 0.1.0-alpha.1

package/dist/service.d.ts

@@ -0,0 +1,44 @@
+import type { Frameworks, Services } from '@wdio/types';
+import type { TraceLaneOptions } from './options.js';
+/**
+ * The tracelane WebdriverIO Service. Implements the worker + launcher hooks from
+ * `Services.ServiceInstance`; extra Cucumber hooks (`beforeScenario` /
+ * `afterScenario`) are declared as plain methods since `@wdio/types` doesn't put
+ * them on `ServiceInstance` (they only exist at runtime under the Cucumber
+ * framework).
+ */
+export default class TraceLaneService implements Services.ServiceInstance {
+    private readonly session;
+    /**
+     * WDIO instantiates the Service with `(options, capabilities, config)`. We
+     * read `config.framework` so the result-shape switch (P1 PRD §A.2) picks the
+     * right normalization, and `config.outputDir`-adjacent options come from the
+     * `options` arg.
+     */
+    constructor(options?: TraceLaneOptions, _capabilities?: unknown, config?: {
+        framework?: string;
+    });
+    /** Refine the framework + worker id once the session is initializing. */
+    beforeSession(_config: unknown, _capabilities: unknown, _specs: string[], cid?: string): void;
+    /** Worker hook: stash the live browser + build the recorder. */
+    before(_capabilities: unknown, _specs: string[], browser: WebdriverIO.Browser): Promise<void>;
+    /** No-op in v1; present for the documented hook surface (ADR-0004). */
+    beforeSuite(_suite: Frameworks.Suite): void;
+    /** Mocha/Jasmine: start capture and remember the test identity. */
+    beforeTest(test: Frameworks.Test, _context: unknown): Promise<void>;
+    /** Mocha/Jasmine: decide + write the report from the per-test result. */
+    afterTest(_test: Frameworks.Test, _context: unknown, result: Frameworks.TestResult): Promise<void>;
+    /** Cucumber: scenario start (runtime-only hook; mirrors `beforeTest`). */
+    beforeScenario(world: unknown, _context?: unknown): Promise<void>;
+    /** Cucumber: scenario end (runtime-only hook; mirrors `afterTest`). */
+    afterScenario(world: unknown, result?: unknown): Promise<void>;
+    /** Re-inject the recorder after a `url(...)` navigation (ADR-0006). */
+    beforeCommand(commandName: string, args: unknown[]): Promise<void>;
+    /** No-op in v1; present for the documented hook surface (ADR-0004). */
+    afterSuite(_suite: Frameworks.Suite): void;
+    /** Worker teardown: stop the drain poll so no timer leaks. */
+    after(_result: number, _capabilities: unknown, _specs: string[]): Promise<void>;
+    /** Launcher hook: nothing to aggregate in v1 (reports are per-test files). */
+    onComplete(_exitCode: number, _config: unknown, _capabilities: unknown, _results: unknown): void;
+}
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAKrD;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,YAAW,QAAQ,CAAC,eAAe;IACvE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAE3C;;;;;OAKG;gBAED,OAAO,GAAE,gBAAqB,EAC9B,aAAa,CAAC,EAAE,OAAO,EACvB,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;IAKjC,yEAAyE;IACzE,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7F,gEAAgE;IAC1D,MAAM,CACV,aAAa,EAAE,OAAO,EACtB,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,EAAE,WAAW,CAAC,OAAO,GAC3B,OAAO,CAAC,IAAI,CAAC;IAIhB,uEAAuE;IACvE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,GAAG,IAAI;IAE3C,mEAAmE;IAC7D,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzE,yEAAyE;IACnE,SAAS,CACb,KAAK,EAAE,UAAU,CAAC,IAAI,EACtB,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,UAAU,CAAC,UAAU,GAC5B,OAAO,CAAC,IAAI,CAAC;IAIhB,0EAA0E;IACpE,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvE,uEAAuE;IACjE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,uEAAuE;IACjE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMxE,uEAAuE;IACvE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,KAAK,GAAG,IAAI;IAE1C,8DAA8D;IACxD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrF,8EAA8E;IAC9E,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,OAAO,EACtB,QAAQ,EAAE,OAAO,GAChB,IAAI;CACR"}

package/dist/service.js

@@ -0,0 +1,73 @@
+// TraceLaneService — the WebdriverIO Service (Task 2.14 / ADR-0004).
+//
+// Registered in `wdio.conf.ts` as `services: [[TraceLaneService, options]]`
+// (P1 PRD §M.1). A Service — not a Reporter — because only the Service hook
+// surface gives a live `browser` in worker hooks, which tracelane needs to
+// inject rrweb, drain the in-page buffer, and attach CDP (ADR-0004).
+//
+// All real work is delegated to a single TraceLaneSession so the Service and the
+// `traceLaneHooks` factory (hooks.ts) share one implementation.
+import { scenarioIdentity, testIdentity } from './test-identity.js';
+import { TraceLaneSession } from './tracelane-session.js';
+/**
+ * The tracelane WebdriverIO Service. Implements the worker + launcher hooks from
+ * `Services.ServiceInstance`; extra Cucumber hooks (`beforeScenario` /
+ * `afterScenario`) are declared as plain methods since `@wdio/types` doesn't put
+ * them on `ServiceInstance` (they only exist at runtime under the Cucumber
+ * framework).
+ */
+export default class TraceLaneService {
+    session;
+    /**
+     * WDIO instantiates the Service with `(options, capabilities, config)`. We
+     * read `config.framework` so the result-shape switch (P1 PRD §A.2) picks the
+     * right normalization, and `config.outputDir`-adjacent options come from the
+     * `options` arg.
+     */
+    constructor(options = {}, _capabilities, config) {
+        this.session = new TraceLaneSession(options, config?.framework);
+    }
+    /** Refine the framework + worker id once the session is initializing. */
+    beforeSession(_config, _capabilities, _specs, cid) {
+        this.session.setCid(cid);
+    }
+    /** Worker hook: stash the live browser + build the recorder. */
+    async before(_capabilities, _specs, browser) {
+        await this.session.onBefore(browser);
+    }
+    /** No-op in v1; present for the documented hook surface (ADR-0004). */
+    beforeSuite(_suite) { }
+    /** Mocha/Jasmine: start capture and remember the test identity. */
+    async beforeTest(test, _context) {
+        const { title, spec } = testIdentity(test);
+        await this.session.onBeforeTest(title, spec);
+    }
+    /** Mocha/Jasmine: decide + write the report from the per-test result. */
+    async afterTest(_test, _context, result) {
+        await this.session.onAfterTest(result);
+    }
+    /** Cucumber: scenario start (runtime-only hook; mirrors `beforeTest`). */
+    async beforeScenario(world, _context) {
+        const { title, spec } = scenarioIdentity(world);
+        await this.session.onBeforeTest(title, spec);
+    }
+    /** Cucumber: scenario end (runtime-only hook; mirrors `afterTest`). */
+    async afterScenario(world, result) {
+        await this.session.onAfterTest(world, result);
+    }
+    /** Re-inject the recorder after a `url(...)` navigation (ADR-0006). */
+    async beforeCommand(commandName, args) {
+        if (commandName === 'url' && typeof args[0] === 'string') {
+            await this.session.onUrl(args[0]);
+        }
+    }
+    /** No-op in v1; present for the documented hook surface (ADR-0004). */
+    afterSuite(_suite) { }
+    /** Worker teardown: stop the drain poll so no timer leaks. */
+    async after(_result, _capabilities, _specs) {
+        await this.session.onAfter();
+    }
+    /** Launcher hook: nothing to aggregate in v1 (reports are per-test files). */
+    onComplete(_exitCode, _config, _capabilities, _results) { }
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,4EAA4E;AAC5E,2EAA2E;AAC3E,qEAAqE;AACrE,EAAE;AACF,iFAAiF;AACjF,gEAAgE;AAIhE,OAAO,EAAiB,gBAAgB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG1D;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IAClB,OAAO,CAAmB;IAE3C;;;;;OAKG;IACH,YACE,UAA4B,EAAE,EAC9B,aAAuB,EACvB,MAA+B;QAE/B,IAAI,CAAC,OAAO,GAAG,IAAI,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IAED,yEAAyE;IACzE,aAAa,CAAC,OAAgB,EAAE,aAAsB,EAAE,MAAgB,EAAE,GAAY;QACpF,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,MAAM,CACV,aAAsB,EACtB,MAAgB,EAChB,OAA4B;QAE5B,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAiC,CAAC,CAAC;IACjE,CAAC;IAED,uEAAuE;IACvE,WAAW,CAAC,MAAwB,IAAS,CAAC;IAE9C,mEAAmE;IACnE,KAAK,CAAC,UAAU,CAAC,IAAqB,EAAE,QAAiB;QACvD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,CAAC,IAAgB,CAAC,CAAC;QACvD,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,SAAS,CACb,KAAsB,EACtB,QAAiB,EACjB,MAA6B;QAE7B,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,cAAc,CAAC,KAAc,EAAE,QAAkB;QACrD,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,aAAa,CAAC,KAAc,EAAE,MAAgB;QAClD,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,uEAAuE;IACvE,KAAK,CAAC,aAAa,CAAC,WAAmB,EAAE,IAAe;QACtD,IAAI,WAAW,KAAK,KAAK,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YACzD,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,uEAAuE;IACvE,UAAU,CAAC,MAAwB,IAAS,CAAC;IAE7C,8DAA8D;IAC9D,KAAK,CAAC,KAAK,CAAC,OAAe,EAAE,aAAsB,EAAE,MAAgB;QACnE,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAC/B,CAAC;IAED,8EAA8E;IAC9E,UAAU,CACR,SAAiB,EACjB,OAAgB,EAChB,aAAsB,EACtB,QAAiB,IACV,CAAC;CACX"}

package/dist/test-identity.d.ts

@@ -0,0 +1,23 @@
+/** A WDIO `Test`/`Suite`-shaped object — we only read `title` / `fullTitle` / `file`. */
+export interface TestLike {
+    title?: string;
+    fullTitle?: string;
+    file?: string;
+}
+/** The identity the session needs: a display title and (when known) a spec path. */
+export interface TestIdentity {
+    title: string;
+    spec?: string;
+}
+/** Prefer the fully-qualified title; fall back to the leaf title, then a placeholder. */
+export declare function testIdentity(test: TestLike): TestIdentity;
+/** A Cucumber `World`-shaped object — we read its pickle's `name` / `uri`. */
+export interface WorldLike {
+    pickle?: {
+        name?: string;
+        uri?: string;
+    };
+}
+/** Pull the scenario title + feature path out of a Cucumber `World` pickle. */
+export declare function scenarioIdentity(world: unknown): TestIdentity;
+//# sourceMappingURL=test-identity.d.ts.map

package/dist/test-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-identity.d.ts","sourceRoot":"","sources":["../src/test-identity.ts"],"names":[],"mappings":"AAIA,yFAAyF;AACzF,MAAM,WAAW,QAAQ;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,YAAY,CAGzD;AAED,8EAA8E;AAC9E,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAED,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAI7D"}

package/dist/test-identity.js

@@ -0,0 +1,15 @@
+// Shared helper for pulling a test's human title + spec path out of a WDIO
+// `Test`/`Suite` object. Used by both the Service (service.ts) and the hook
+// factory (hooks.ts) so the extraction lives in exactly one place.
+/** Prefer the fully-qualified title; fall back to the leaf title, then a placeholder. */
+export function testIdentity(test) {
+    const title = test.fullTitle ?? test.title ?? 'unknown test';
+    return test.file ? { title, spec: test.file } : { title };
+}
+/** Pull the scenario title + feature path out of a Cucumber `World` pickle. */
+export function scenarioIdentity(world) {
+    const pickle = world.pickle;
+    const title = pickle?.name ?? 'unknown scenario';
+    return pickle?.uri ? { title, spec: pickle.uri } : { title };
+}
+//# sourceMappingURL=test-identity.js.map

package/dist/test-identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-identity.js","sourceRoot":"","sources":["../src/test-identity.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,mEAAmE;AAenE,yFAAyF;AACzF,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC;AAOD,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,MAAM,MAAM,GAAI,KAAmB,CAAC,MAAM,CAAC;IAC3C,MAAM,KAAK,GAAG,MAAM,EAAE,IAAI,IAAI,kBAAkB,CAAC;IACjD,OAAO,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;AAC/D,CAAC"}

package/dist/tracelane-session.d.ts

@@ -0,0 +1,79 @@
+import { type TraceLaneOptions } from './options.js';
+import { type WdioBrowser } from './wdio-executor.js';
+/** Minimal capability shape we read for the report header (browser name/version). */
+interface BrowserCapabilities {
+    browserName?: string;
+    browserVersion?: string;
+    version?: string;
+}
+/** The browser fields the session reads beyond the BrowserExecutor surface. */
+type SessionBrowser = WdioBrowser & {
+    capabilities?: BrowserCapabilities;
+    sessionId?: string;
+};
+export declare class TraceLaneSession {
+    private readonly options;
+    private readonly outDir;
+    private readonly captureRrweb;
+    private readonly captureNetwork;
+    private readonly captureConsole;
+    private framework;
+    private cid;
+    private browser;
+    private recorder;
+    private current;
+    private networkAttached;
+    /** Set once CDP attach has failed, to stop the per-test retry storm (#2). */
+    private networkUnavailable;
+    constructor(options?: TraceLaneOptions, framework?: string, cid?: string);
+    /** Tell the session which framework is running (from `beforeSession`/config). */
+    setFramework(framework: string | undefined): void;
+    /** Tell the session its worker capability id (for parallel-safe filenames). */
+    setCid(cid: string | undefined): void;
+    /**
+     * `before` hook: stash the live browser. The recorder is created lazily
+     * per-test in `onBeforeTest` (not here), so no recorder lingers between tests
+     * and worker teardown never drains an unstarted recorder (#5).
+     */
+    onBefore(browser: SessionBrowser): Promise<void>;
+    /**
+     * Resolve the console-plugin options: when `capture.console === false`, pass
+     * `{ level: [] }` so the rrweb console plugin patches no `console.*` methods
+     * and installs no error/rejection listeners — i.e. console capture is off
+     * (#1). Otherwise forward any user-supplied `consolePluginOptions` (the core
+     * recorder applies its defaults when none are given).
+     */
+    private resolveConsolePluginOptions;
+    /** Build a fresh recorder for the live browser (one per test; #5). */
+    private createRecorderForCurrentTest;
+    /** `beforeTest`/`beforeScenario`: record the test identity and start capture. */
+    onBeforeTest(title: string, spec?: string): Promise<void>;
+    /**
+     * Attach CDP network capture once per session. After the first failure (no
+     * devtools-service / non-Chrome / Selenium Grid), set a sentinel so every
+     * subsequent test skips the attempt instead of retrying forever, and warn
+     * exactly once (#2).
+     */
+    private maybeAttachNetworkCapture;
+    /** WDIO `beforeCommand('url', ...)`: re-inject the recorder after navigation. */
+    onUrl(url: string): Promise<void>;
+    /**
+     * `afterTest`/`afterScenario`: normalize the framework result, ask the
+     * recorder for the report decision (ADR-0005), and write the HTML on a build.
+     * Returns the path written, or undefined when no report was produced. Drops
+     * the recorder afterward so the next test starts fresh and teardown has
+     * nothing to drain (#5).
+     */
+    onAfterTest(resultA: unknown, resultB?: unknown): Promise<string | undefined>;
+    /**
+     * `afterSuite`/`after`: stop the active recorder so no poll timer leaks past
+     * the worker. In the normal flow `onAfterTest` already finalized + dropped the
+     * recorder, so this is a no-op; it only fires if a test started but never
+     * reached `afterTest` (#5 — never drains an unstarted recorder).
+     */
+    onAfter(): Promise<void>;
+    /** Compose the report metadata from the current test + browser capabilities. */
+    private buildMeta;
+}
+export {};
+//# sourceMappingURL=tracelane-session.d.ts.map

package/dist/tracelane-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracelane-session.d.ts","sourceRoot":"","sources":["../src/tracelane-session.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEtE,OAAO,EAAE,KAAK,WAAW,EAAsB,MAAM,oBAAoB,CAAC;AAQ1E,qFAAqF;AACrF,UAAU,mBAAmB;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,+EAA+E;AAC/E,KAAK,cAAc,GAAG,WAAW,GAAG;IAClC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;IACzC,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,GAAG,CAAqB;IAEhC,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,eAAe,CAAS;IAChC,6EAA6E;IAC7E,OAAO,CAAC,kBAAkB,CAAS;gBAEvB,OAAO,GAAE,gBAAqB,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAW5E,iFAAiF;IACjF,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIjD,+EAA+E;IAC/E,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAIrC;;;;OAIG;IACG,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD;;;;;;OAMG;IACH,OAAO,CAAC,2BAA2B;IAKnC,sEAAsE;IACtE,OAAO,CAAC,4BAA4B;IAqBpC,iFAAiF;IAC3E,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAW/D;;;;;OAKG;YACW,yBAAyB;IAevC,iFAAiF;IAC3E,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvC;;;;;;OAMG;IACG,WAAW,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuBnF;;;;;OAKG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,gFAAgF;IAChF,OAAO,CAAC,SAAS;CAclB"}

package/dist/tracelane-session.js

@@ -0,0 +1,189 @@
+// The shared per-worker capture session.
+//
+// Both surfaces — the `TraceLaneService` class (Task 2.14) and the
+// `traceLaneHooks` factory (Task 2.15) — delegate to one `TraceLaneSession` so
+// the capture/inject/drain/report logic lives in exactly one place (ADR-0004:
+// "the same logic exported as plain hook functions"). The session owns the
+// recorder, the current-test metadata, and the report-write decision.
+import { createRecorder, } from '@tracelane/core';
+import { normalizeResult } from './framework-result.js';
+import { loadRrwebBundle } from './inpage-bundle.js';
+import { attachNetworkCapture } from './network-capture.js';
+import { DEFAULT_OUT_DIR } from './options.js';
+import { writeReport } from './report-writer.js';
+import { createWdioExecutor } from './wdio-executor.js';
+export class TraceLaneSession {
+    options;
+    outDir;
+    captureRrweb;
+    captureNetwork;
+    captureConsole;
+    framework;
+    cid;
+    browser;
+    recorder;
+    current;
+    networkAttached = false;
+    /** Set once CDP attach has failed, to stop the per-test retry storm (#2). */
+    networkUnavailable = false;
+    constructor(options = {}, framework, cid) {
+        this.options = options;
+        this.outDir = options.outDir ?? DEFAULT_OUT_DIR;
+        // Capture channels default on (P1 PRD §M.1).
+        this.captureRrweb = options.capture?.rrweb !== false;
+        this.captureNetwork = options.capture?.network !== false;
+        this.captureConsole = options.capture?.console !== false;
+        this.framework = framework;
+        this.cid = cid;
+    }
+    /** Tell the session which framework is running (from `beforeSession`/config). */
+    setFramework(framework) {
+        if (framework)
+            this.framework = framework;
+    }
+    /** Tell the session its worker capability id (for parallel-safe filenames). */
+    setCid(cid) {
+        if (cid)
+            this.cid = cid;
+    }
+    /**
+     * `before` hook: stash the live browser. The recorder is created lazily
+     * per-test in `onBeforeTest` (not here), so no recorder lingers between tests
+     * and worker teardown never drains an unstarted recorder (#5).
+     */
+    async onBefore(browser) {
+        this.browser = browser;
+    }
+    /**
+     * Resolve the console-plugin options: when `capture.console === false`, pass
+     * `{ level: [] }` so the rrweb console plugin patches no `console.*` methods
+     * and installs no error/rejection listeners — i.e. console capture is off
+     * (#1). Otherwise forward any user-supplied `consolePluginOptions` (the core
+     * recorder applies its defaults when none are given).
+     */
+    resolveConsolePluginOptions() {
+        if (!this.captureConsole)
+            return { level: [] };
+        return this.options.consolePluginOptions;
+    }
+    /** Build a fresh recorder for the live browser (one per test; #5). */
+    createRecorderForCurrentTest(browser) {
+        const recorderOptions = {
+            executor: createWdioExecutor(browser),
+            rrwebBundle: loadRrwebBundle(),
+        };
+        if (this.options.drainIntervalMs !== undefined) {
+            recorderOptions.drainIntervalMs = this.options.drainIntervalMs;
+        }
+        if (this.options.cooldownMs !== undefined) {
+            recorderOptions.cooldownMs = this.options.cooldownMs;
+        }
+        const consolePluginOptions = this.resolveConsolePluginOptions();
+        if (consolePluginOptions !== undefined) {
+            recorderOptions.consolePluginOptions = consolePluginOptions;
+        }
+        if (this.options.mode !== undefined) {
+            recorderOptions.mode = this.options.mode;
+        }
+        return createRecorder(recorderOptions);
+    }
+    /** `beforeTest`/`beforeScenario`: record the test identity and start capture. */
+    async onBeforeTest(title, spec) {
+        this.current = spec ? { title, spec } : { title };
+        if (!this.captureRrweb || !this.browser)
+            return;
+        // Create + start a fresh recorder for this test (#5). A passing test in
+        // `failed` mode discards its buffer at finalize; no recorder survives the
+        // test, so teardown never re-drains.
+        this.recorder = this.createRecorderForCurrentTest(this.browser);
+        await this.recorder.start();
+        await this.maybeAttachNetworkCapture();
+    }
+    /**
+     * Attach CDP network capture once per session. After the first failure (no
+     * devtools-service / non-Chrome / Selenium Grid), set a sentinel so every
+     * subsequent test skips the attempt instead of retrying forever, and warn
+     * exactly once (#2).
+     */
+    async maybeAttachNetworkCapture() {
+        if (!this.captureNetwork || this.networkAttached || this.networkUnavailable)
+            return;
+        if (!this.browser)
+            return;
+        try {
+            await attachNetworkCapture(createWdioExecutor(this.browser));
+            this.networkAttached = true;
+        }
+        catch {
+            // Give up for the rest of the session and say so once.
+            this.networkUnavailable = true;
+            console.warn('[tracelane/wdio] network capture unavailable (CDP not attached); degrading to rrweb+console only.');
+        }
+    }
+    /** WDIO `beforeCommand('url', ...)`: re-inject the recorder after navigation. */
+    async onUrl(url) {
+        if (!this.recorder)
+            return;
+        await this.recorder.reinject(url);
+    }
+    /**
+     * `afterTest`/`afterScenario`: normalize the framework result, ask the
+     * recorder for the report decision (ADR-0005), and write the HTML on a build.
+     * Returns the path written, or undefined when no report was produced. Drops
+     * the recorder afterward so the next test starts fresh and teardown has
+     * nothing to drain (#5).
+     */
+    async onAfterTest(resultA, resultB) {
+        const normalized = normalizeResult(this.framework, resultA, resultB);
+        const recorder = this.recorder;
+        this.recorder = undefined;
+        if (!recorder) {
+            this.current = undefined;
+            return undefined;
+        }
+        const { shouldBuildReport, events } = await recorder.finalize({
+            passed: normalized.passed,
+        });
+        if (!shouldBuildReport) {
+            this.current = undefined;
+            return undefined;
+        }
+        const meta = this.buildMeta(normalized);
+        const path = writeReport({ outDir: this.outDir, cid: this.cid, events, meta });
+        this.current = undefined;
+        return path;
+    }
+    /**
+     * `afterSuite`/`after`: stop the active recorder so no poll timer leaks past
+     * the worker. In the normal flow `onAfterTest` already finalized + dropped the
+     * recorder, so this is a no-op; it only fires if a test started but never
+     * reached `afterTest` (#5 — never drains an unstarted recorder).
+     */
+    async onAfter() {
+        if (this.recorder) {
+            await this.recorder.stop();
+            this.recorder = undefined;
+        }
+    }
+    /** Compose the report metadata from the current test + browser capabilities. */
+    buildMeta(normalized) {
+        const caps = this.browser?.capabilities;
+        const meta = {
+            title: this.current?.title ?? 'unknown test',
+            status: normalized.status,
+        };
+        if (this.current?.spec)
+            meta.spec = this.current.spec;
+        if (normalized.error !== undefined)
+            meta.error = normalized.error;
+        if (normalized.durationMs !== undefined)
+            meta.durationMs = normalized.durationMs;
+        if (caps?.browserName)
+            meta.browserName = caps.browserName;
+        const browserVersion = caps?.browserVersion ?? caps?.version;
+        if (browserVersion)
+            meta.browserVersion = browserVersion;
+        return meta;
+    }
+}
+//# sourceMappingURL=tracelane-session.js.map

package/dist/tracelane-session.js.map

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

package/dist/wdio-executor.d.ts

@@ -0,0 +1,27 @@
+import type { BrowserExecutor } from '@tracelane/core';
+/**
+ * The structural subset of a WebdriverIO `browser` the adapter needs.
+ *
+ * `execute` / `executeAsync` are core commands; `cdp` and CDP-event `on(...)`
+ * are contributed by `@wdio/devtools-service` and are therefore typed loosely
+ * here (the base `WebdriverIO.Browser` type doesn't declare `cdp`, and its `on`
+ * is constrained to the Bidi event map). We accept this minimal shape so the
+ * adapter stays decoupled from the devtools-service type augmentation, which the
+ * user installs separately (P1 PRD §A.5).
+ */
+export interface WdioBrowser {
+    execute<T>(fn: (...args: unknown[]) => T, ...args: unknown[]): Promise<T>;
+    executeAsync<T>(fn: (...args: unknown[]) => void, ...args: unknown[]): Promise<T>;
+    cdp?(domain: string, command: string, params?: Record<string, unknown>): Promise<unknown>;
+    on(event: string, handler: (param: never) => void): unknown;
+}
+/**
+ * Wrap a WDIO `browser` as a {@link BrowserExecutor}.
+ *
+ * The mapping is 1:1 for `execute` / `executeAsync` / `on`. For `cdp` we throw a
+ * clear error if the running session has no `cdp` command — that means
+ * `@wdio/devtools-service` wasn't registered (or the driver/vendor doesn't
+ * expose CDP), which is the most common network-capture misconfiguration.
+ */
+export declare function createWdioExecutor(browser: WdioBrowser): BrowserExecutor;
+//# sourceMappingURL=wdio-executor.d.ts.map

package/dist/wdio-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wdio-executor.d.ts","sourceRoot":"","sources":["../src/wdio-executor.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD;;;;;;;;;GASG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1E,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAClF,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1F,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;CAC7D;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,eAAe,CA6BxE"}

package/dist/wdio-executor.js

@@ -0,0 +1,39 @@
+// Adapts a WebdriverIO `browser` object to @tracelane/core's BrowserExecutor
+// (ADR-0004). @tracelane/core only ever talks to a BrowserExecutor — never to a
+// concrete framework driver — so this is the single seam between WDIO and the
+// recorder engine.
+/**
+ * Wrap a WDIO `browser` as a {@link BrowserExecutor}.
+ *
+ * The mapping is 1:1 for `execute` / `executeAsync` / `on`. For `cdp` we throw a
+ * clear error if the running session has no `cdp` command — that means
+ * `@wdio/devtools-service` wasn't registered (or the driver/vendor doesn't
+ * expose CDP), which is the most common network-capture misconfiguration.
+ */
+export function createWdioExecutor(browser) {
+    return {
+        execute(fn, ...args) {
+            return browser.execute(fn, ...args);
+        },
+        executeAsync(fn, ...args) {
+            return browser.executeAsync(fn, ...args);
+        },
+        cdp(domain, command, params) {
+            if (typeof browser.cdp !== 'function') {
+                return Promise.reject(new Error("@tracelane/wdio: browser.cdp is unavailable. Register '@wdio/devtools-service' " +
+                    'in your wdio.conf services to enable CDP network capture (P1 PRD §A.5), ' +
+                    'or disable it via capture.network = false.'));
+            }
+            // `params` is optional on BrowserExecutor; only forward it when provided so
+            // we match `browser.cdp(domain, command)` arity when there are no params.
+            return params === undefined
+                ? browser.cdp(domain, command)
+                : browser.cdp(domain, command, params);
+        },
+        on(event, handler) {
+            // WDIO's `on` returns the browser for chaining; BrowserExecutor.on is void.
+            browser.on(event, handler);
+        },
+    };
+}
+//# sourceMappingURL=wdio-executor.js.map

package/dist/wdio-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wdio-executor.js","sourceRoot":"","sources":["../src/wdio-executor.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,gFAAgF;AAChF,8EAA8E;AAC9E,mBAAmB;AAqBnB;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACrD,OAAO;QACL,OAAO,CAAI,EAA6B,EAAE,GAAG,IAAe;YAC1D,OAAO,OAAO,CAAC,OAAO,CAAI,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QACzC,CAAC;QACD,YAAY,CAAI,EAAgC,EAAE,GAAG,IAAe;YAClE,OAAO,OAAO,CAAC,YAAY,CAAI,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,GAAG,CAAC,MAAc,EAAE,OAAe,EAAE,MAAgC;YACnE,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,UAAU,EAAE,CAAC;gBACtC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CACP,iFAAiF;oBAC/E,0EAA0E;oBAC1E,4CAA4C,CAC/C,CACF,CAAC;YACJ,CAAC;YACD,4EAA4E;YAC5E,0EAA0E;YAC1E,OAAO,MAAM,KAAK,SAAS;gBACzB,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC;gBAC9B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,EAAE,CAAC,KAAa,EAAE,OAAkC;YAClD,4EAA4E;YAC5E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAiC,CAAC,CAAC;QACvD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@tracelane/wdio",
+  "version": "0.1.0-alpha.1",
+  "description": "WebdriverIO Service that records rrweb sessions and writes a self-contained HTML report on failed tests. The user-facing tracelane integration for WDIO.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks.d.ts",
+      "import": "./dist/hooks.js"
+    }
+  },
+  "files": ["dist", "NOTICE", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/build-rrweb-bundle.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:e2e": "node scripts/build-rrweb-bundle.mjs && node ./e2e/run.mjs"
+  },
+  "dependencies": {
+    "@tracelane/core": "workspace:*",
+    "@tracelane/report": "workspace:*"
+  },
+  "peerDependencies": {
+    "@wdio/types": "^9.0.0",
+    "webdriverio": "^9.0.0"
+  },
+  "devDependencies": {
+    "@cubenest/rrweb-core": "workspace:*",
+    "@wdio/cli": "^9.0.0",
+    "@wdio/globals": "^9.0.0",
+    "@wdio/local-runner": "^9.0.0",
+    "@wdio/mocha-framework": "^9.0.0",
+    "@wdio/spec-reporter": "^9.0.0",
+    "@wdio/types": "^9.0.0",
+    "esbuild": "^0.28.0",
+    "tsx": "^4.19.0",
+    "webdriverio": "^9.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Cubenest/rrweb-stack.git",
+    "directory": "packages/tracelane-wdio"
+  },
+  "homepage": "https://github.com/Cubenest/rrweb-stack/tree/main/packages/tracelane-wdio#readme"
+}