@wdio/selenium-devtools 1.0.0 → 1.0.1

package/dist/driverPatcher.js

@@ -0,0 +1,256 @@
+import { createRequire } from 'node:module';
+import logger from '@wdio/logger';
+import { INTERNAL_DRIVER_METHODS, PATCHED_SYMBOL, TRACKED_ELEMENT_METHODS } from './constants.js';
+import { getCallSourceFromStack } from './helpers/utils.js';
+const log = logger('@wdio/selenium-devtools:driverPatcher');
+const originals = {};
+const elementOriginals = {};
+export function getDriverOriginals() {
+    return originals;
+}
+export function getElementOriginals() {
+    return elementOriginals;
+}
+// Resolve user's selenium-webdriver first, then fall back to our own.
+function loadSeleniumWebdriver() {
+    try {
+        const userRequire = createRequire(`${process.cwd()}/`);
+        return userRequire('selenium-webdriver');
+    }
+    catch {
+        try {
+            const localRequire = createRequire(import.meta.url);
+            return localRequire('selenium-webdriver');
+        }
+        catch (err) {
+            log.warn(`selenium-webdriver not found — devtools auto-attach disabled. (${err.message})`);
+            return null;
+        }
+    }
+}
+function isWebElementLike(v) {
+    return (v &&
+        typeof v === 'object' &&
+        typeof v.getId === 'function' &&
+        typeof v.click === 'function');
+}
+function safeSerialize(value) {
+    if (value === null || value === undefined) {
+        return value;
+    }
+    if (typeof value === 'function') {
+        return '[Function]';
+    }
+    if (isWebElementLike(value)) {
+        return webElementSummary(value);
+    }
+    if (typeof value === 'object' &&
+        'using' in value &&
+        'value' in value &&
+        Object.keys(value).length === 2) {
+        return `By.${value.using}(${JSON.stringify(value.value)})`;
+    }
+    if (Array.isArray(value)) {
+        if (value.length > 0 && value.every(isWebElementLike)) {
+            return `<WebElement[]> (count: ${value.length})`;
+        }
+        return value.map(safeSerialize);
+    }
+    if (typeof value === 'object') {
+        try {
+            return JSON.parse(JSON.stringify(value));
+        }
+        catch {
+            return String(value);
+        }
+    }
+    return value;
+}
+function webElementSummary(el) {
+    // `id_` is a Promise; some selenium versions stash the resolved value sync.
+    const peek = el?.id_?._value ?? el?.id_?.value ?? null;
+    return peek ? `<WebElement id=${peek}>` : '<WebElement>';
+}
+function wrapPrototype(proto, methodNames, fromElement, hooks) {
+    if (proto[PATCHED_SYMBOL]) {
+        return [];
+    }
+    ;
+    proto[PATCHED_SYMBOL] = true;
+    const wrapped = [];
+    for (const methodName of methodNames) {
+        const original = proto[methodName];
+        if (typeof original !== 'function') {
+            continue;
+        }
+        if (methodName === 'constructor' || methodName.startsWith('__')) {
+            continue;
+        }
+        ;
+        proto[methodName] = function (...args) {
+            const callInfo = getCallSourceFromStack();
+            const startedAt = Date.now();
+            const sanitizedArgs = args.map(safeSerialize);
+            const settle = (result, error) => {
+                try {
+                    hooks.onCommand({
+                        command: methodName,
+                        args: sanitizedArgs,
+                        result: error ? undefined : safeSerialize(result),
+                        rawResult: error ? undefined : result,
+                        error,
+                        callSource: callInfo.callSource,
+                        timestamp: startedAt,
+                        fromElement
+                    });
+                }
+                catch (hookErr) {
+                    log.warn(`onCommand hook threw for ${methodName}: ${hookErr.message}`);
+                }
+            };
+            let result;
+            try {
+                result = original.apply(this, args);
+            }
+            catch (err) {
+                settle(undefined, err);
+                throw err;
+            }
+            // CRITICAL: return the original thenable. findElement returns a
+            // WebElementPromise that carries sendKeys/click for chaining; a plain
+            // Promise from `.then(...)` would break `findElement(...).sendKeys(...)`.
+            if (result && typeof result.then === 'function') {
+                result.then((v) => settle(v, undefined), (err) => settle(undefined, err));
+                return result;
+            }
+            settle(result, undefined);
+            return result;
+        };
+        wrapped.push(methodName);
+    }
+    return wrapped;
+}
+export function patchSelenium(hooks) {
+    const sw = loadSeleniumWebdriver();
+    if (!sw) {
+        return false;
+    }
+    const Builder = sw.Builder;
+    const WebDriver = sw.WebDriver;
+    const WebElement = sw.WebElement;
+    if (!Builder || !WebDriver) {
+        log.warn('selenium-webdriver loaded but Builder/WebDriver missing — version unsupported?');
+        return false;
+    }
+    // Stash unwrapped originals before any patching.
+    const driverProto = WebDriver.prototype;
+    if (typeof driverProto.takeScreenshot === 'function') {
+        const orig = driverProto.takeScreenshot;
+        originals.takeScreenshot = (driver) => orig.call(driver);
+    }
+    if (typeof driverProto.executeScript === 'function') {
+        const orig = driverProto.executeScript;
+        originals.executeScript = (driver, script, ...args) => orig.call(driver, script, ...args);
+    }
+    if (typeof driverProto.manage === 'function') {
+        const orig = driverProto.manage;
+        originals.manage = (driver) => orig.call(driver);
+    }
+    const driverMethods = collectMethodNames(WebDriver.prototype);
+    const tracked = driverMethods.filter((m) => !INTERNAL_DRIVER_METHODS.includes(m));
+    const wrappedDriver = wrapPrototype(WebDriver.prototype, tracked, 
+    /* fromElement */ false, hooks);
+    log.info(`Wrapped ${wrappedDriver.length} WebDriver method(s)`);
+    // Lets onBeforeQuit flush async cleanup before runners that `process.exit()`
+    // tear down (those bypass node's beforeExit).
+    if (typeof driverProto.quit === 'function') {
+        const originalQuit = driverProto.quit;
+        driverProto.quit = async function patchedQuit() {
+            if (hooks.onBeforeQuit) {
+                try {
+                    await hooks.onBeforeQuit(this);
+                }
+                catch (err) {
+                    log.warn(`onBeforeQuit hook threw: ${err.message}`);
+                }
+            }
+            return originalQuit.call(this);
+        };
+        log.info('Wrapped WebDriver.quit (cleanup hook)');
+    }
+    if (WebElement) {
+        const elProto = WebElement.prototype;
+        if (typeof elProto.getText === 'function') {
+            const orig = elProto.getText;
+            elementOriginals.getText = (el) => orig.call(el);
+        }
+        if (typeof elProto.getTagName === 'function') {
+            const orig = elProto.getTagName;
+            elementOriginals.getTagName = (el) => orig.call(el);
+        }
+        const wrappedEl = wrapPrototype(WebElement.prototype, TRACKED_ELEMENT_METHODS, 
+        /* fromElement */ true, hooks);
+        log.info(`Wrapped ${wrappedEl.length} WebElement method(s)`);
+    }
+    if (!Builder.prototype[PATCHED_SYMBOL]) {
+        ;
+        Builder.prototype[PATCHED_SYMBOL] = true;
+        const originalBuild = Builder.prototype.build;
+        Builder.prototype.build = function patchedBuild(...args) {
+            if (hooks.onBeforeBuild) {
+                try {
+                    hooks.onBeforeBuild(this);
+                }
+                catch (err) {
+                    log.warn(`onBeforeBuild hook threw: ${err.message}`);
+                }
+            }
+            const driver = originalBuild.apply(this, args);
+            try {
+                const result = hooks.onDriverCreated(driver);
+                if (result && typeof result.then === 'function') {
+                    ;
+                    result.catch((err) => log.warn(`onDriverCreated hook rejected: ${err.message}`));
+                }
+            }
+            catch (err) {
+                log.warn(`onDriverCreated hook threw: ${err.message}`);
+            }
+            // Selenium 4: WebDriver is thenable. Extend `.then` so `await Builder.build()`
+            // also waits for the dashboard to connect.
+            const isThenable = driver && typeof driver.then === 'function';
+            if (isThenable && hooks.waitForReady) {
+                const originalThen = driver.then.bind(driver);
+                driver.then = function patchedThen(onFulfilled, onRejected) {
+                    return originalThen(async (resolved) => {
+                        try {
+                            await hooks.waitForReady();
+                        }
+                        catch {
+                            /* fall through — don't block forever on UI failures */
+                        }
+                        return onFulfilled ? onFulfilled(resolved) : resolved;
+                    }, onRejected);
+                };
+            }
+            return driver;
+        };
+        log.info('Patched Builder.prototype.build');
+    }
+    return true;
+}
+function collectMethodNames(proto) {
+    const names = new Set();
+    let current = proto;
+    while (current && current !== Object.prototype) {
+        for (const name of Object.getOwnPropertyNames(current)) {
+            const desc = Object.getOwnPropertyDescriptor(current, name);
+            if (desc && typeof desc.value === 'function') {
+                names.add(name);
+            }
+        }
+        current = Object.getPrototypeOf(current);
+    }
+    return [...names];
+}
+//# sourceMappingURL=driverPatcher.js.map

package/dist/driverPatcher.js.map

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

package/dist/helpers/detachedBackend.d.ts

@@ -0,0 +1,7 @@
+export declare function startDetachedBackend(opts: {
+    port: number;
+    hostname: string;
+    readyTimeoutMs?: number;
+}): Promise<{
+    port: number;
+}>;

package/dist/helpers/detachedBackend.js

@@ -0,0 +1,34 @@
+import net from 'node:net';
+import { spawn } from 'node:child_process';
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+export async function startDetachedBackend(opts) {
+    const backendPath = require.resolve('@wdio/devtools-backend');
+    const code = `import(${JSON.stringify(backendPath)}).then(m => m.start({ port: ${opts.port}, hostname: ${JSON.stringify(opts.hostname)} })).catch(err => { console.error(err); process.exit(1) })`;
+    spawn(process.execPath, ['-e', code], {
+        detached: true,
+        stdio: 'ignore'
+    }).unref();
+    const deadline = Date.now() + (opts.readyTimeoutMs ?? 10000);
+    while (Date.now() < deadline) {
+        if (await canConnect(opts.port, opts.hostname)) {
+            return { port: opts.port };
+        }
+        await new Promise((resolve) => setTimeout(resolve, 100));
+    }
+    throw new Error(`Detached backend never came up on ${opts.hostname}:${opts.port}`);
+}
+function canConnect(port, host) {
+    return new Promise((resolve) => {
+        const sock = net.connect(port, host);
+        sock.once('connect', () => {
+            sock.destroy();
+            resolve(true);
+        });
+        sock.once('error', () => {
+            sock.destroy();
+            resolve(false);
+        });
+    });
+}
+//# sourceMappingURL=detachedBackend.js.map

package/dist/helpers/detachedBackend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detachedBackend.js","sourceRoot":"","sources":["../../src/helpers/detachedBackend.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,UAAU,CAAA;AAC1B,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAE9C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAI1C;IACC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;IAC7D,MAAM,IAAI,GAAG,UAAU,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,+BAA+B,IAAI,CAAC,IAAI,eAAe,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,4DAA4D,CAAA;IAClM,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE;QACpC,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC,KAAK,EAAE,CAAA;IAEV,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,cAAc,IAAI,KAAK,CAAC,CAAA;IAC5D,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC7B,IAAI,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAA;QAC5B,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;IAC1D,CAAC;IACD,MAAM,IAAI,KAAK,CACb,qCAAqC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,IAAI,EAAE,CAClE,CAAA;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,IAAY;IAC5C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;YACxB,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,OAAO,CAAC,IAAI,CAAC,CAAA;QACf,CAAC,CAAC,CAAA;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,OAAO,EAAE,CAAA;YACd,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/helpers/runtime.d.ts

@@ -0,0 +1,3 @@
+export declare function detectOwnVersion(): string;
+export declare function detectRunner(): string;
+export declare function detectSeleniumVersion(): string | undefined;

package/dist/helpers/runtime.js

@@ -0,0 +1,47 @@
+import { createRequire } from 'node:module';
+export function detectOwnVersion() {
+    try {
+        return createRequire(import.meta.url)('../../package.json').version;
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function detectRunner() {
+    const argv = (process.argv[1] || '').toLowerCase();
+    if (argv.includes('mocha')) {
+        return 'mocha';
+    }
+    if (argv.includes('jest')) {
+        return 'jest';
+    }
+    if (argv.includes('jasmine')) {
+        return 'jasmine';
+    }
+    if (argv.includes('vitest')) {
+        return 'vitest';
+    }
+    if (argv.includes('cucumber')) {
+        return 'cucumber';
+    }
+    if (argv.endsWith('node') || argv.endsWith('node.exe')) {
+        return 'node';
+    }
+    return 'unknown';
+}
+export function detectSeleniumVersion() {
+    const tryRead = (req) => {
+        try {
+            return req('selenium-webdriver/package.json').version;
+        }
+        catch {
+            return undefined;
+        }
+    };
+    const fromUser = tryRead(createRequire(`${process.cwd()}/`));
+    if (fromUser) {
+        return fromUser;
+    }
+    return tryRead(createRequire(import.meta.url));
+}
+//# sourceMappingURL=runtime.js.map

package/dist/helpers/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../../src/helpers/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAE3C,MAAM,UAAU,gBAAgB;IAC9B,IAAI,CAAC;QACH,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,oBAAoB,CAAC,CAAC,OAAO,CAAA;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IAClD,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO,CAAA;IAChB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAA;IACf,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC9B,OAAO,UAAU,CAAA;IACnB,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACvD,OAAO,MAAM,CAAA;IACf,CAAC;IACD,OAAO,SAAS,CAAA;AAClB,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,OAAO,GAAG,CAAC,GAAgB,EAAsB,EAAE;QACvD,IAAI,CAAC;YACH,OAAO,GAAG,CAAC,iCAAiC,CAAC,CAAC,OAAO,CAAA;QACvD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IACD,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;IAC5D,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAA;IACjB,CAAC;IACD,OAAO,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;AAChD,CAAC"}

package/dist/helpers/suiteManager.d.ts

@@ -0,0 +1,19 @@
+import type { SuiteStats, TestStats } from '../types.js';
+import type { TestReporter } from '../reporter.js';
+export declare class SuiteManager {
+    private testReporter;
+    private rootSuite;
+    private currentParent;
+    constructor(testReporter: TestReporter);
+    getOrCreateRootSuite(file: string, title: string): SuiteStats;
+    getRootSuite(): SuiteStats | null;
+    /** Where new tests are appended — root suite, or the open scenario sub-suite. */
+    getCurrentParent(): SuiteStats | null;
+    /** Open a Cucumber scenario as a sub-suite; steps attach until endScenarioSuite. */
+    startScenarioSuite(name: string, file: string, callSource?: string): SuiteStats | null;
+    endScenarioSuite(state: SuiteStats['state']): void;
+    setRootSuiteTitle(title: string, callSource?: string): void;
+    addTest(test: TestStats): void;
+    finalize(): void;
+    reset(): void;
+}

package/dist/helpers/suiteManager.js

@@ -0,0 +1,131 @@
+import { DEFAULTS, TEST_STATE } from '../constants.js';
+import { generateStableUid } from './utils.js';
+// rootSuite = describe block (Mocha/Jest) or feature (Cucumber).
+// currentParent points at the in-progress scenario sub-suite for Cucumber,
+// or at rootSuite otherwise. Tests append to currentParent.
+export class SuiteManager {
+    testReporter;
+    rootSuite = null;
+    currentParent = null;
+    constructor(testReporter) {
+        this.testReporter = testReporter;
+    }
+    getOrCreateRootSuite(file, title) {
+        if (this.rootSuite) {
+            return this.rootSuite;
+        }
+        const suite = {
+            uid: generateStableUid(file, title),
+            cid: DEFAULTS.CID,
+            title,
+            fullTitle: title,
+            file,
+            type: 'suite',
+            start: new Date(),
+            state: TEST_STATE.RUNNING,
+            end: null,
+            tests: [],
+            suites: [],
+            hooks: [],
+            _duration: DEFAULTS.DURATION
+        };
+        this.rootSuite = suite;
+        this.currentParent = suite;
+        this.testReporter.onSuiteStart(suite);
+        return suite;
+    }
+    getRootSuite() {
+        return this.rootSuite;
+    }
+    /** Where new tests are appended — root suite, or the open scenario sub-suite. */
+    getCurrentParent() {
+        return this.currentParent ?? this.rootSuite;
+    }
+    /** Open a Cucumber scenario as a sub-suite; steps attach until endScenarioSuite. */
+    startScenarioSuite(name, file, callSource) {
+        if (!this.rootSuite) {
+            return null;
+        }
+        const sub = {
+            uid: generateStableUid(file, `${this.rootSuite.uid}::${name}`),
+            cid: DEFAULTS.CID,
+            title: name,
+            fullTitle: name,
+            file,
+            type: 'suite',
+            start: new Date(),
+            state: TEST_STATE.RUNNING,
+            end: null,
+            tests: [],
+            suites: [],
+            hooks: [],
+            _duration: DEFAULTS.DURATION,
+            callSource,
+            // Without `parent`, the dashboard's `!suite.parent` filter renders this
+            // sub-suite at the root too, duplicating it next to the feature.
+            parent: this.rootSuite.uid
+        };
+        this.rootSuite.suites = this.rootSuite.suites ?? [];
+        this.rootSuite.suites.push(sub);
+        this.currentParent = sub;
+        this.testReporter.onSuiteStart(sub);
+        return sub;
+    }
+    endScenarioSuite(state) {
+        const cur = this.currentParent;
+        if (!cur || cur === this.rootSuite || cur.end) {
+            return;
+        }
+        cur.end = new Date();
+        cur._duration =
+            cur.end.getTime() - (cur.start?.getTime() || cur.end.getTime());
+        cur.state = state;
+        this.testReporter.onSuiteEnd(cur);
+        this.currentParent = this.rootSuite;
+    }
+    setRootSuiteTitle(title, callSource) {
+        if (!this.rootSuite) {
+            return;
+        }
+        let changed = false;
+        if (title && this.rootSuite.title !== title) {
+            this.rootSuite.title = title;
+            this.rootSuite.fullTitle = title;
+            changed = true;
+        }
+        if (callSource && this.rootSuite.callSource !== callSource) {
+            this.rootSuite.callSource = callSource;
+            changed = true;
+        }
+        if (changed) {
+            this.testReporter.updateSuites();
+        }
+    }
+    addTest(test) {
+        const parent = this.getCurrentParent();
+        if (!parent) {
+            return;
+        }
+        parent.tests.push(test);
+        this.testReporter.updateSuites();
+    }
+    finalize() {
+        if (!this.rootSuite || this.rootSuite.end) {
+            return;
+        }
+        this.rootSuite.end = new Date();
+        this.rootSuite._duration =
+            this.rootSuite.end.getTime() -
+                (this.rootSuite.start?.getTime() || this.rootSuite.end.getTime());
+        const failedDirect = this.rootSuite.tests.some((t) => typeof t !== 'string' && t.state === TEST_STATE.FAILED);
+        const failedNested = (this.rootSuite.suites ?? []).some((s) => s.state === TEST_STATE.FAILED);
+        this.rootSuite.state =
+            failedDirect || failedNested ? TEST_STATE.FAILED : TEST_STATE.PASSED;
+        this.testReporter.onSuiteEnd(this.rootSuite);
+    }
+    reset() {
+        this.rootSuite = null;
+        this.currentParent = null;
+    }
+}
+//# sourceMappingURL=suiteManager.js.map

package/dist/helpers/suiteManager.js.map

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

package/dist/helpers/testManager.d.ts

@@ -0,0 +1,47 @@
+import type { SuiteStats, TestStats } from '../types.js';
+import type { TestReporter } from '../reporter.js';
+import type { SuiteManager } from './suiteManager.js';
+/**
+ * Tracks the currently-active test inside the session suite. Two modes:
+ *   - `session` (default): one synthetic test wraps the entire driver session.
+ *   - `marked`: user calls startTest(name)/endTest(state); each pair adds a test.
+ *
+ * The proxy reads `getCurrentTest()` to tag each captured command with a uid.
+ */
+export declare class TestManager {
+    #private;
+    private rootSuite;
+    private testReporter;
+    private suiteManager;
+    constructor(rootSuite: SuiteStats, testReporter: TestReporter, suiteManager: SuiteManager);
+    /** Where new tests attach — current scenario sub-suite (Cucumber) or root. */
+    private get suite();
+    /**
+     * Returns the test that captured commands should attach to. Order:
+     *   1. The currently-running marked test, if any.
+     *   2. (only if the user has NOT yet used startMarkedTest) the synthetic
+     *      session-wide test, lazily created on first command.
+     *   3. The most-recently-ended marked test (handles commands that fire
+     *      between the user's it() blocks — chromedriver retries, hooks, etc).
+     */
+    getOrEnsureTest(): TestStats | null;
+    /**
+     * Public alias retained for callers that want to force the synthetic test
+     * to exist. The internal code path uses `getOrEnsureTest()` instead.
+     */
+    ensureSessionTest(): TestStats;
+    /**
+     * Switch into marked mode and start a new test. The first time this is
+     * called, any pre-existing synthetic session test is removed from the suite
+     * (along with any commands that referenced it) — once the user takes over
+     * the test boundaries, the synthetic just adds noise.
+     */
+    startMarkedTest(name: string, opts?: {
+        file?: string;
+        callSource?: string;
+    }): TestStats;
+    endCurrent(state: TestStats['state']): void;
+    getCurrentTest(): TestStats | null;
+    /** Called when the driver session is closing (process exit / quit). */
+    finalizeSession(): void;
+}