@mechris3/glassbox 0.1.0

package/dist/src/server/test-executor.d.ts

@@ -0,0 +1,64 @@
+/**
+ * TestExecutor — orchestrates journey execution.
+ *
+ * Manages the browser lifecycle (launch, reuse, kill), spawns one child process
+ * per journey, streams output to connected dashboard clients via WebSocket.
+ */
+import type { GlassboxConfig } from '../config.js';
+import type { WebSocketManager } from './websocket.js';
+import type { DiagnosticService } from './diagnostic-service.js';
+export declare class TestExecutor {
+    private config;
+    private wsManager;
+    private diagnostics;
+    private currentProcess;
+    private browserInstance;
+    private browserLaunchConfig;
+    private breakpoints;
+    private running;
+    private aborted;
+    /** Whether a test run is currently in progress. */
+    get isRunning(): boolean;
+    constructor(config: GlassboxConfig, wsManager: WebSocketManager, diagnostics: DiagnosticService);
+    /**
+     * Run a set of journeys sequentially.
+     * Launches a browser if not already running, then spawns a child process per journey.
+     */
+    run(journeys: string[], runConfig?: Record<string, unknown>): Promise<void>;
+    /** Stop the current run. Kills the running child process and aborts remaining journeys. */
+    stop(): void;
+    /** Pause execution via signal + stdin command to the child process. */
+    pause(): void;
+    /** Resume execution via signal + stdin command to the child process. */
+    resume(): void;
+    /** Step forward N actions, then re-pause. */
+    step(count?: number): void;
+    setBreakpoints(journey: string, breakpoints: number[]): void;
+    getBreakpoints(journey: string): number[];
+    clearBreakpoints(journey: string): void;
+    updateConfig(config: Record<string, unknown>): void;
+    /** Kill the browser process and clean up. */
+    shutdown(): Promise<void>;
+    /**
+     * Ensure a browser is launched and reachable.
+     * Reuses an existing instance if still running. If runtime settings differ
+     * from the current browser (e.g. headed vs headless), kills and relaunches.
+     */
+    private ensureBrowser;
+    /** Extract the parent user data dir (without the profile subdirectory). */
+    private resolveUserDataDir;
+    /** Extract the profile directory name from a full profile path. */
+    private resolveProfileDirectory;
+    /** Auto-detect the first available Chromium browser. */
+    private autoDetectBrowser;
+    /** Check if the current browser instance is still reachable via its WebSocket endpoint. */
+    private isBrowserAlive;
+    /**
+     * Run a single journey in a child process.
+     * The runner connects to the shared browser via the WS endpoint.
+     */
+    private runSingleJourney;
+    /** Send an IPC command to the running child process via stdin JSON. */
+    private sendCommand;
+}
+//# sourceMappingURL=test-executor.d.ts.map

package/dist/src/server/test-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-executor.d.ts","sourceRoot":"","sources":["../../../src/server/test-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,qBAAa,YAAY;IAcrB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS;IACjB,OAAO,CAAC,WAAW;IAfrB,OAAO,CAAC,cAAc,CAA6B;IACnD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,mBAAmB,CAAuB;IAClD,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IAExB,mDAAmD;IACnD,IAAI,SAAS,IAAI,OAAO,CAEvB;gBAGS,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,gBAAgB,EAC3B,WAAW,EAAE,iBAAiB;IAGxC;;;OAGG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAuCjF,2FAA2F;IAC3F,IAAI,IAAI,IAAI;IAQZ,uEAAuE;IACvE,KAAK,IAAI,IAAI;IAOb,wEAAwE;IACxE,MAAM,IAAI,IAAI;IAOd,6CAA6C;IAC7C,IAAI,CAAC,KAAK,SAAI,GAAG,IAAI;IAIrB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,IAAI;IAK5D,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;IAIzC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKvC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAInD,6CAA6C;IACvC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B;;;;OAIG;YACW,aAAa;IAsD3B,2EAA2E;IAC3E,OAAO,CAAC,kBAAkB;IAY1B,mEAAmE;IACnE,OAAO,CAAC,uBAAuB;IAW/B,wDAAwD;IACxD,OAAO,CAAC,iBAAiB;IAKzB,2FAA2F;YAC7E,cAAc;IAW5B;;;OAGG;YACW,gBAAgB;IAuD9B,uEAAuE;IACvE,OAAO,CAAC,WAAW;CAKpB"}

package/dist/src/server/test-executor.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * TestExecutor — orchestrates journey execution.
+ *
+ * Manages the browser lifecycle (launch, reuse, kill), spawns one child process
+ * per journey, streams output to connected dashboard clients via WebSocket.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestExecutor = void 0;
+const path_1 = require("path");
+const launcher_js_1 = require("../cdp/launcher.js");
+const browser_discovery_js_1 = require("../utils/browser-discovery.js");
+const spawn_journey_js_1 = require("../runner/spawn-journey.js");
+class TestExecutor {
+    config;
+    wsManager;
+    diagnostics;
+    currentProcess = null;
+    browserInstance = null;
+    browserLaunchConfig = null;
+    breakpoints = new Map();
+    running = false;
+    aborted = false;
+    /** Whether a test run is currently in progress. */
+    get isRunning() {
+        return this.running;
+    }
+    constructor(config, wsManager, diagnostics) {
+        this.config = config;
+        this.wsManager = wsManager;
+        this.diagnostics = diagnostics;
+    }
+    /**
+     * Run a set of journeys sequentially.
+     * Launches a browser if not already running, then spawns a child process per journey.
+     */
+    async run(journeys, runConfig) {
+        if (this.running)
+            return;
+        this.running = true;
+        this.aborted = false;
+        const results = [];
+        try {
+            // Ensure browser is available
+            await this.ensureBrowser(runConfig);
+            this.wsManager.broadcast({ type: 'run-start', journeys });
+            this.diagnostics.reset();
+            for (const journey of journeys) {
+                if (this.aborted) {
+                    results.push({ journey, status: 'skipped' });
+                    continue;
+                }
+                const status = await this.runSingleJourney(journey, runConfig);
+                results.push({ journey, status });
+            }
+            this.wsManager.broadcast({ type: 'run-end', results });
+        }
+        finally {
+            this.running = false;
+            const keepOpen = runConfig?.keepBrowserOpen ?? false;
+            const hasFailed = results.some((r) => r.status === 'failed');
+            if (hasFailed && this.browserInstance) {
+                // Keep browser alive on failure for post-mortem inspection via MCP
+                await this.diagnostics.setLiveSession(this.browserInstance.wsEndpoint);
+            }
+            else if (!keepOpen && this.browserInstance) {
+                this.diagnostics.closeLiveSession();
+                this.browserInstance.process.kill();
+                this.browserInstance = null;
+            }
+        }
+    }
+    /** Stop the current run. Kills the running child process and aborts remaining journeys. */
+    stop() {
+        this.aborted = true;
+        if (this.currentProcess) {
+            this.currentProcess.kill('SIGTERM');
+            this.currentProcess = null;
+        }
+    }
+    /** Pause execution via signal + stdin command to the child process. */
+    pause() {
+        if (this.currentProcess?.pid) {
+            this.currentProcess.kill('SIGUSR1');
+        }
+        this.sendCommand({ command: 'pause' });
+    }
+    /** Resume execution via signal + stdin command to the child process. */
+    resume() {
+        if (this.currentProcess?.pid) {
+            this.currentProcess.kill('SIGUSR2');
+        }
+        this.sendCommand({ command: 'resume' });
+    }
+    /** Step forward N actions, then re-pause. */
+    step(count = 1) {
+        this.sendCommand({ command: 'step', stepsRemaining: count });
+    }
+    setBreakpoints(journey, breakpoints) {
+        this.breakpoints.set(journey, breakpoints);
+        this.sendCommand({ command: 'config', breakpoints });
+    }
+    getBreakpoints(journey) {
+        return this.breakpoints.get(journey) ?? [];
+    }
+    clearBreakpoints(journey) {
+        this.breakpoints.delete(journey);
+        this.sendCommand({ command: 'config', breakpoints: [] });
+    }
+    updateConfig(config) {
+        this.sendCommand({ command: 'config', ...config });
+    }
+    /** Kill the browser process and clean up. */
+    async shutdown() {
+        this.stop();
+        if (this.browserInstance) {
+            this.browserInstance.process.kill();
+            this.browserInstance = null;
+        }
+    }
+    /**
+     * Ensure a browser is launched and reachable.
+     * Reuses an existing instance if still running. If runtime settings differ
+     * from the current browser (e.g. headed vs headless), kills and relaunches.
+     */
+    async ensureBrowser(runConfig) {
+        const headless = runConfig?.headless ?? this.config.browser.headless;
+        const devtools = runConfig?.devtools ?? false;
+        const browserPath = runConfig?.browserPath
+            ?? this.config.browser.executablePath
+            ?? this.autoDetectBrowser();
+        const userDataDir = this.resolveUserDataDir(runConfig);
+        const profileDirectory = this.resolveProfileDirectory(runConfig);
+        // Create a fingerprint of the launch config to detect when we need to relaunch
+        const launchFingerprint = JSON.stringify({ browserPath, headless, devtools, userDataDir, profileDirectory });
+        // If browser is alive and config hasn't changed, reuse it
+        if (this.browserInstance && this.browserLaunchConfig === launchFingerprint) {
+            // Verify the endpoint is still reachable
+            const isAlive = await this.isBrowserAlive();
+            if (isAlive)
+                return;
+            // Browser died — clear and relaunch
+            this.browserInstance = null;
+        }
+        // Config changed or no browser — kill existing and relaunch
+        if (this.browserInstance && !this.browserInstance.process.killed) {
+            const proc = this.browserInstance.process;
+            this.browserInstance = null;
+            // If this is a real process we spawned, wait for it to exit
+            if (proc.pid) {
+                proc.kill();
+                await new Promise((resolve) => {
+                    proc.on('exit', () => resolve());
+                    proc.on('error', () => resolve());
+                    // Safety: if exit never fires (fake process), resolve after a flush
+                    setTimeout(() => resolve(), 0);
+                });
+            }
+        }
+        if (!browserPath) {
+            throw new Error('No browser found. Set browserPath in config or install Chrome/Brave/Edge.');
+        }
+        this.browserInstance = await (0, launcher_js_1.launchBrowser)({
+            browserPath,
+            headless,
+            devtools,
+            viewport: this.config.browser.defaultViewport,
+            userDataDir,
+            profileDirectory,
+        });
+        this.browserLaunchConfig = launchFingerprint;
+    }
+    /** Extract the parent user data dir (without the profile subdirectory). */
+    resolveUserDataDir(runConfig) {
+        const raw = runConfig?.userDataDir ?? this.config.browser.userDataDir;
+        if (!raw)
+            return undefined;
+        // If the path ends with a profile directory name (Default, Profile N), return the parent
+        const dirName = (0, path_1.basename)(raw);
+        if (dirName === 'Default' || dirName.startsWith('Profile ')) {
+            return (0, path_1.dirname)(raw);
+        }
+        return raw;
+    }
+    /** Extract the profile directory name from a full profile path. */
+    resolveProfileDirectory(runConfig) {
+        const raw = runConfig?.userDataDir ?? this.config.browser.userDataDir;
+        if (!raw)
+            return undefined;
+        const dirName = (0, path_1.basename)(raw);
+        if (dirName === 'Default' || dirName.startsWith('Profile ')) {
+            return dirName;
+        }
+        return undefined;
+    }
+    /** Auto-detect the first available Chromium browser. */
+    autoDetectBrowser() {
+        const browsers = (0, browser_discovery_js_1.discoverBrowsers)();
+        return browsers[0]?.executablePath;
+    }
+    /** Check if the current browser instance is still reachable via its WebSocket endpoint. */
+    async isBrowserAlive() {
+        if (!this.browserInstance)
+            return false;
+        try {
+            const port = new URL(this.browserInstance.wsEndpoint).port;
+            const response = await fetch(`http://127.0.0.1:${port}/json/version`, { signal: AbortSignal.timeout(1000) });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Run a single journey in a child process.
+     * The runner connects to the shared browser via the WS endpoint.
+     */
+    async runSingleJourney(journeyPath, runConfig) {
+        this.wsManager.broadcast({ type: 'test-start', journey: journeyPath });
+        const start = Date.now();
+        const spawned = (0, spawn_journey_js_1.spawnJourney)({
+            journeyPath: (0, path_1.resolve)(process.cwd(), journeyPath),
+            wsEndpoint: this.browserInstance.wsEndpoint,
+            targetUrl: runConfig?.targetUrl ?? '',
+            viewportWidth: runConfig?.viewportWidth ?? this.config.browser.defaultViewport.width,
+            viewportHeight: runConfig?.viewportHeight ?? this.config.browser.defaultViewport.height,
+            actionDelay: runConfig?.actionDelay ?? 0,
+            breakpoints: this.breakpoints.get(journeyPath) ?? [],
+        });
+        this.currentProcess = spawned.process;
+        spawned.process.stdout?.on('data', (chunk) => {
+            const lines = chunk.toString().split('\n');
+            for (const line of lines) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const parsed = JSON.parse(line);
+                    if (parsed.type === 'diagnostics' && parsed.data) {
+                        this.diagnostics.ingestRunnerData(parsed.data);
+                        continue;
+                    }
+                }
+                catch { /* not JSON, treat as log */ }
+                this.wsManager.broadcast({ type: 'log', message: line, journey: journeyPath });
+            }
+        });
+        spawned.process.stderr?.on('data', (chunk) => {
+            const lines = chunk.toString().split('\n');
+            for (const line of lines) {
+                if (line.startsWith('[JSON]')) {
+                    try {
+                        const json = JSON.parse(line.slice(6));
+                        this.wsManager.broadcast(json);
+                    }
+                    catch {
+                        this.wsManager.broadcast({ type: 'error', message: line, journey: journeyPath });
+                    }
+                }
+                else if (line.trim()) {
+                    this.wsManager.broadcast({ type: 'error', message: line, journey: journeyPath });
+                }
+            }
+        });
+        const code = await spawned.exitCode;
+        const duration = `${((Date.now() - start) / 1000).toFixed(2)}s`;
+        const status = code === 0 ? 'passed' : 'failed';
+        this.wsManager.broadcast({ type: 'test-end', journey: journeyPath, status, duration });
+        this.currentProcess = null;
+        return status;
+    }
+    /** Send an IPC command to the running child process via stdin JSON. */
+    sendCommand(cmd) {
+        if (this.currentProcess?.stdin?.writable) {
+            this.currentProcess.stdin.write(JSON.stringify(cmd) + '\n');
+        }
+    }
+}
+exports.TestExecutor = TestExecutor;
+//# sourceMappingURL=test-executor.js.map

package/dist/src/server/test-executor.js.map

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

package/dist/src/server/websocket.d.ts

@@ -0,0 +1,51 @@
+/**
+ * WebSocket manager — broadcasts typed messages to all connected dashboard clients.
+ */
+import type { Server } from 'http';
+export type WSMessage = {
+    type: 'run-start';
+    journeys: string[];
+} | {
+    type: 'run-end';
+    results: Array<{
+        journey: string;
+        status: 'passed' | 'failed' | 'skipped';
+    }>;
+} | {
+    type: 'test-start';
+    journey: string;
+} | {
+    type: 'test-end';
+    journey: string;
+    status: 'passed' | 'failed';
+    duration: string;
+} | {
+    type: 'log';
+    message: string;
+    journey?: string;
+} | {
+    type: 'error';
+    message: string;
+    journey?: string;
+} | {
+    type: 'journeys';
+    journeys: Array<{
+        id: string;
+        name: string;
+    }>;
+} | {
+    type: 'action';
+    index: number;
+    status: 'start' | 'complete' | 'breakpoint';
+    description?: string;
+} | {
+    type: 'ui-control';
+    action: 'pause' | 'resume';
+};
+export declare class WebSocketManager {
+    private wss;
+    private clients;
+    constructor(server: Server);
+    broadcast(message: WSMessage): void;
+}
+//# sourceMappingURL=websocket.d.ts.map

package/dist/src/server/websocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.d.ts","sourceRoot":"","sources":["../../../src/server/websocket.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAEnC,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;KAAE,CAAC,CAAA;CAAE,GACjG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GACnE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,UAAU,GAAG,YAAY,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACpG;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAA;CAAE,CAAC;AAEvD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAkB;IAC7B,OAAO,CAAC,OAAO,CAAwB;gBAE3B,MAAM,EAAE,MAAM;IAS1B,SAAS,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI;CAQpC"}

package/dist/src/server/websocket.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * WebSocket manager — broadcasts typed messages to all connected dashboard clients.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebSocketManager = void 0;
+const ws_1 = require("ws");
+class WebSocketManager {
+    wss;
+    clients = new Set();
+    constructor(server) {
+        this.wss = new ws_1.WebSocketServer({ server });
+        this.wss.on('connection', (ws) => {
+            this.clients.add(ws);
+            ws.on('close', () => this.clients.delete(ws));
+        });
+    }
+    broadcast(message) {
+        const data = JSON.stringify(message);
+        for (const client of this.clients) {
+            if (client.readyState === 1) {
+                client.send(data);
+            }
+        }
+    }
+}
+exports.WebSocketManager = WebSocketManager;
+//# sourceMappingURL=websocket.js.map

package/dist/src/server/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/server/websocket.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2BAAqD;AAcrD,MAAa,gBAAgB;IACnB,GAAG,CAAkB;IACrB,OAAO,GAAG,IAAI,GAAG,EAAa,CAAC;IAEvC,YAAY,MAAc;QACxB,IAAI,CAAC,GAAG,GAAG,IAAI,oBAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,EAAE,EAAE,EAAE;YAC/B,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrB,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,SAAS,CAAC,OAAkB;QAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QACrC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AArBD,4CAqBC"}

package/dist/src/utils/browser-discovery.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Cross-platform browser auto-discovery.
+ * Detects Chromium-based browsers on macOS, Windows, and Linux.
+ */
+export interface DiscoveredBrowser {
+    name: string;
+    executablePath: string;
+    userDataDir: string;
+}
+export declare function discoverBrowsers(): DiscoveredBrowser[];
+//# sourceMappingURL=browser-discovery.d.ts.map

package/dist/src/utils/browser-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-discovery.d.ts","sourceRoot":"","sources":["../../../src/utils/browser-discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,gBAAgB,IAAI,iBAAiB,EAAE,CAatD"}

package/dist/src/utils/browser-discovery.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * Cross-platform browser auto-discovery.
+ * Detects Chromium-based browsers on macOS, Windows, and Linux.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.discoverBrowsers = discoverBrowsers;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+function discoverBrowsers() {
+    const os = (0, os_1.platform)();
+    const browsers = [];
+    if (os === 'darwin') {
+        browsers.push(...discoverMacOS());
+    }
+    else if (os === 'win32') {
+        browsers.push(...discoverWindows());
+    }
+    else {
+        browsers.push(...discoverLinux());
+    }
+    return browsers.filter((b) => (0, fs_1.existsSync)(b.executablePath));
+}
+function discoverMacOS() {
+    const home = process.env.HOME ?? '';
+    return [
+        {
+            name: 'Google Chrome',
+            executablePath: '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+            userDataDir: (0, path_1.join)(home, 'Library/Application Support/Google/Chrome'),
+        },
+        {
+            name: 'Brave Browser',
+            executablePath: '/Applications/Brave Browser.app/Contents/MacOS/Brave Browser',
+            userDataDir: (0, path_1.join)(home, 'Library/Application Support/BraveSoftware/Brave-Browser'),
+        },
+        {
+            name: 'Microsoft Edge',
+            executablePath: '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+            userDataDir: (0, path_1.join)(home, 'Library/Application Support/Microsoft Edge'),
+        },
+        {
+            name: 'Chromium',
+            executablePath: '/Applications/Chromium.app/Contents/MacOS/Chromium',
+            userDataDir: (0, path_1.join)(home, 'Library/Application Support/Chromium'),
+        },
+    ];
+}
+function discoverWindows() {
+    const programFiles = process.env['ProgramFiles'] ?? 'C:\\Program Files';
+    const programFilesX86 = process.env['ProgramFiles(x86)'] ?? 'C:\\Program Files (x86)';
+    const localAppData = process.env.LOCALAPPDATA ?? '';
+    return [
+        {
+            name: 'Google Chrome',
+            executablePath: (0, path_1.join)(programFiles, 'Google/Chrome/Application/chrome.exe'),
+            userDataDir: (0, path_1.join)(localAppData, 'Google/Chrome/User Data'),
+        },
+        {
+            name: 'Google Chrome (x86)',
+            executablePath: (0, path_1.join)(programFilesX86, 'Google/Chrome/Application/chrome.exe'),
+            userDataDir: (0, path_1.join)(localAppData, 'Google/Chrome/User Data'),
+        },
+        {
+            name: 'Brave Browser',
+            executablePath: (0, path_1.join)(programFiles, 'BraveSoftware/Brave-Browser/Application/brave.exe'),
+            userDataDir: (0, path_1.join)(localAppData, 'BraveSoftware/Brave-Browser/User Data'),
+        },
+        {
+            name: 'Microsoft Edge',
+            executablePath: (0, path_1.join)(programFiles, 'Microsoft/Edge/Application/msedge.exe'),
+            userDataDir: (0, path_1.join)(localAppData, 'Microsoft/Edge/User Data'),
+        },
+    ];
+}
+function discoverLinux() {
+    const home = process.env.HOME ?? '';
+    return [
+        {
+            name: 'Google Chrome',
+            executablePath: '/usr/bin/google-chrome',
+            userDataDir: (0, path_1.join)(home, '.config/google-chrome'),
+        },
+        {
+            name: 'Brave Browser',
+            executablePath: '/usr/bin/brave-browser',
+            userDataDir: (0, path_1.join)(home, '.config/BraveSoftware/Brave-Browser'),
+        },
+        {
+            name: 'Chromium',
+            executablePath: '/usr/bin/chromium-browser',
+            userDataDir: (0, path_1.join)(home, '.config/chromium'),
+        },
+        {
+            name: 'Microsoft Edge',
+            executablePath: '/usr/bin/microsoft-edge',
+            userDataDir: (0, path_1.join)(home, '.config/microsoft-edge'),
+        },
+    ];
+}
+//# sourceMappingURL=browser-discovery.js.map

package/dist/src/utils/browser-discovery.js.map

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

package/dist/src/utils/error-formatter.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Structured error formatting for test failures.
+ */
+export interface FormattedError {
+    header: string;
+    applicationStack: string[];
+    pageObject?: string;
+    journeyStep?: string;
+    summary: string;
+}
+export declare function formatTestError(error: Error, journeyName: string, duration?: string): FormattedError;
+export declare function getErrorSummary(error: Error, journeyName: string): string;
+//# sourceMappingURL=error-formatter.d.ts.map

package/dist/src/utils/error-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.d.ts","sourceRoot":"","sources":["../../../src/utils/error-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAsBpG;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/dist/src/utils/error-formatter.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Structured error formatting for test failures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatTestError = formatTestError;
+exports.getErrorSummary = getErrorSummary;
+function formatTestError(error, journeyName, duration) {
+    const timestamp = new Date().toISOString();
+    const stack = error.stack ?? '';
+    const applicationStack = stack
+        .split('\n')
+        .filter((line) => !line.includes('node_modules'))
+        .filter((line) => line.trim().startsWith('at '));
+    const pageObject = applicationStack.find((line) => line.includes('.page.'))?.trim();
+    const journeyStep = applicationStack.find((line) => line.includes('.journey.'))?.trim();
+    const header = [
+        `Journey: ${journeyName}`,
+        `Time: ${timestamp}`,
+        duration ? `Duration: ${duration}` : '',
+        `Error: ${error.message}`,
+    ].filter(Boolean).join('\n');
+    const summary = getErrorSummary(error, journeyName);
+    return { header, applicationStack, pageObject, journeyStep, summary };
+}
+function getErrorSummary(error, journeyName) {
+    return `${journeyName}: ${error.message.split('\n')[0]}`;
+}
+//# sourceMappingURL=error-formatter.js.map

package/dist/src/utils/error-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-formatter.js","sourceRoot":"","sources":["../../../src/utils/error-formatter.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAUH,0CAsBC;AAED,0CAEC;AA1BD,SAAgB,eAAe,CAAC,KAAY,EAAE,WAAmB,EAAE,QAAiB;IAClF,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAEhC,MAAM,gBAAgB,GAAG,KAAK;SAC3B,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;SAChD,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAEnD,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IACpF,MAAM,WAAW,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;IAExF,MAAM,MAAM,GAAG;QACb,YAAY,WAAW,EAAE;QACzB,SAAS,SAAS,EAAE;QACpB,QAAQ,CAAC,CAAC,CAAC,aAAa,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;QACvC,UAAU,KAAK,CAAC,OAAO,EAAE;KAC1B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7B,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC;IAEpD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AACxE,CAAC;AAED,SAAgB,eAAe,CAAC,KAAY,EAAE,WAAmB;IAC/D,OAAO,GAAG,WAAW,KAAK,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC3D,CAAC"}

package/dist/src/utils/escape.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Escape utilities for safely interpolating values into JavaScript strings
+ * evaluated via CDP's Runtime.evaluate.
+ */
+/**
+ * Escape a string for safe interpolation into a single-quoted JS string.
+ * Handles quotes, backslashes, newlines, null bytes, and Unicode line/paragraph separators.
+ */
+export declare function escapeJS(str: string): string;
+//# sourceMappingURL=escape.d.ts.map

package/dist/src/utils/escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape.d.ts","sourceRoot":"","sources":["../../../src/utils/escape.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS5C"}