@mechris3/glassbox 0.1.0

package/dist/src/cdp/launcher.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Chrome process spawning and DevTools endpoint discovery.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchBrowser = launchBrowser;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+const os_2 = require("os");
+const DEFAULT_FLAGS = [
+    '--no-first-run',
+    '--no-default-browser-check',
+    '--disable-session-crashed-bubble',
+    '--disable-infobars',
+    '--hide-crash-restore-bubble',
+    '--disable-popup-blocking',
+    '--disable-prompt-on-repost',
+    '--noerrdialogs',
+    '--no-restore-state',
+    '--disable-background-timer-throttling',
+    '--password-store=basic',
+    '--use-mock-keychain',
+];
+/** Sandbox flags only needed on Linux where setuid sandbox exists. */
+const LINUX_SANDBOX_FLAGS = [
+    '--no-sandbox',
+    '--disable-setuid-sandbox',
+];
+async function launchBrowser(options) {
+    const port = options.port ?? 0;
+    const userDataDir = options.userDataDir ?? (0, fs_1.mkdtempSync)((0, path_1.join)((0, os_1.tmpdir)(), 'glassbox-'));
+    // Clean crash state to prevent "didn't shut down correctly" dialogs
+    cleanCrashState(userDataDir);
+    const args = [
+        `--remote-debugging-port=${port}`,
+        `--user-data-dir=${userDataDir}`,
+        ...DEFAULT_FLAGS,
+        ...((0, os_2.platform)() === 'linux' ? LINUX_SANDBOX_FLAGS : []),
+        ...(options.profileDirectory ? [`--profile-directory=${options.profileDirectory}`] : []),
+        ...(options.headless ? ['--headless=new'] : []),
+        ...(options.devtools ? ['--auto-open-devtools-for-tabs'] : []),
+        ...(options.viewport ? [`--window-size=${options.viewport.width},${options.viewport.height}`] : []),
+        ...(options.args ?? []),
+    ];
+    const browserProcess = (0, child_process_1.spawn)(options.browserPath, args, {
+        stdio: ['pipe', 'pipe', 'pipe'],
+    });
+    try {
+        const wsEndpoint = await waitForWSEndpoint(browserProcess);
+        const actualPort = parseInt(new URL(wsEndpoint).port, 10);
+        return {
+            process: browserProcess,
+            wsEndpoint,
+            port: actualPort,
+        };
+    }
+    catch (error) {
+        // Browser exited immediately — likely already running with this profile.
+        // Try to find an existing DevTools endpoint.
+        const existing = await tryConnectExisting(options.browserPath);
+        if (existing)
+            return existing;
+        // Can't connect to existing instance — kill all instances and retry
+        await killBrowserProcesses(options.browserPath);
+        // Wait a moment for OS to release the profile lock
+        await new Promise((r) => setTimeout(r, 0));
+        const retryProcess = (0, child_process_1.spawn)(options.browserPath, args, {
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        const wsEndpoint = await waitForWSEndpoint(retryProcess);
+        const actualPort = parseInt(new URL(wsEndpoint).port, 10);
+        return {
+            process: retryProcess,
+            wsEndpoint,
+            port: actualPort,
+        };
+    }
+}
+/**
+ * Try to connect to an already-running browser instance.
+ * Scans common debug ports (9222, 9229) and any port the OS reports for the browser.
+ */
+async function tryConnectExisting(_browserPath) {
+    // Try common remote debugging ports
+    const portsToTry = [9222, 9229, 9333];
+    for (const port of portsToTry) {
+        try {
+            const response = await fetch(`http://127.0.0.1:${port}/json/version`, { signal: AbortSignal.timeout(1000) });
+            if (response.ok) {
+                const data = await response.json();
+                if (data.webSocketDebuggerUrl) {
+                    // Return a "fake" process that we don't own — won't be killed on cleanup
+                    const noopProcess = { killed: false, kill: () => { } };
+                    return {
+                        process: noopProcess,
+                        wsEndpoint: data.webSocketDebuggerUrl,
+                        port,
+                    };
+                }
+            }
+        }
+        catch {
+            // Port not listening, try next
+        }
+    }
+    return null;
+}
+/**
+ * Kill running instances of a specific browser executable.
+ * Uses exact process name match to avoid killing unrelated processes.
+ */
+async function killBrowserProcesses(browserPath) {
+    const { execSync } = await import('child_process');
+    const processName = (0, path_1.basename)(browserPath);
+    try {
+        if ((0, os_2.platform)() === 'win32') {
+            execSync(`taskkill /F /IM "${processName}" 2>nul`, { stdio: 'ignore' });
+        }
+        else {
+            // Use -x for exact name match (not substring), avoiding collateral kills
+            execSync(`pkill -x "${processName}" 2>/dev/null || true`, { stdio: 'ignore' });
+        }
+    }
+    catch {
+        // Best effort — process might not exist
+    }
+}
+/**
+ * Clean Chrome's crash state to prevent "didn't shut down correctly" dialogs.
+ * Modifies the Preferences file and removes the Sessions directory.
+ */
+function cleanCrashState(userDataDir) {
+    try {
+        // Fix Preferences file — set exit_type to "Normal"
+        const prefsPath = (0, path_1.join)(userDataDir, 'Default', 'Preferences');
+        if ((0, fs_1.existsSync)(prefsPath)) {
+            const content = (0, fs_1.readFileSync)(prefsPath, 'utf-8');
+            const fixed = content
+                .replace(/"exit_type"\s*:\s*"[^"]*"/, '"exit_type":"Normal"')
+                .replace(/"exited_cleanly"\s*:\s*false/, '"exited_cleanly":true');
+            (0, fs_1.writeFileSync)(prefsPath, fixed);
+        }
+        // Remove Sessions directory
+        const sessionsPath = (0, path_1.join)(userDataDir, 'Default', 'Sessions');
+        if ((0, fs_1.existsSync)(sessionsPath)) {
+            (0, fs_1.rmSync)(sessionsPath, { recursive: true, force: true });
+        }
+    }
+    catch {
+        // Best effort — don't fail the launch if cleanup fails
+    }
+}
+function waitForWSEndpoint(process) {
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+            reject(new Error('Timed out waiting for browser WebSocket endpoint'));
+        }, 30_000);
+        let stderr = '';
+        process.stderr?.on('data', (chunk) => {
+            stderr += chunk.toString();
+            const match = stderr.match(/DevTools listening on (ws:\/\/.+)/);
+            if (match) {
+                clearTimeout(timeout);
+                resolve(match[1]);
+            }
+        });
+        process.on('close', (code) => {
+            clearTimeout(timeout);
+            reject(new Error(`Browser process exited with code ${code} before DevTools endpoint was available`));
+        });
+    });
+}
+//# sourceMappingURL=launcher.js.map

package/dist/src/cdp/launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.js","sourceRoot":"","sources":["../../../src/cdp/launcher.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAgDH,sCAwDC;AAtGD,iDAAyD;AACzD,2BAAkF;AAClF,2BAA4B;AAC5B,+BAAsC;AACtC,2BAA8B;AAqB9B,MAAM,aAAa,GAAG;IACpB,gBAAgB;IAChB,4BAA4B;IAC5B,kCAAkC;IAClC,oBAAoB;IACpB,6BAA6B;IAC7B,0BAA0B;IAC1B,4BAA4B;IAC5B,gBAAgB;IAChB,oBAAoB;IACpB,uCAAuC;IACvC,wBAAwB;IACxB,qBAAqB;CACtB,CAAC;AAEF,sEAAsE;AACtE,MAAM,mBAAmB,GAAG;IAC1B,cAAc;IACd,0BAA0B;CAC3B,CAAC;AAEK,KAAK,UAAU,aAAa,CAAC,OAAsB;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAC/B,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAA,gBAAW,EAAC,IAAA,WAAI,EAAC,IAAA,WAAM,GAAE,EAAE,WAAW,CAAC,CAAC,CAAC;IAEpF,oEAAoE;IACpE,eAAe,CAAC,WAAW,CAAC,CAAC;IAE7B,MAAM,IAAI,GAAG;QACX,2BAA2B,IAAI,EAAE;QACjC,mBAAmB,WAAW,EAAE;QAChC,GAAG,aAAa;QAChB,GAAG,CAAC,IAAA,aAAQ,GAAE,KAAK,OAAO,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,uBAAuB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACxF,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,iBAAiB,OAAO,CAAC,QAAQ,CAAC,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnG,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;KACxB,CAAC;IAEF,MAAM,cAAc,GAAG,IAAA,qBAAK,EAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE;QACtD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;KAChC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAE1D,OAAO;YACL,OAAO,EAAE,cAAc;YACvB,UAAU;YACV,IAAI,EAAE,UAAU;SACjB,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC/D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAC;QAE9B,oEAAoE;QACpE,MAAM,oBAAoB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAChD,mDAAmD;QACnD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3C,MAAM,YAAY,GAAG,IAAA,qBAAK,EAAC,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE;YACpD,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;SAChC,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,MAAM,iBAAiB,CAAC,YAAY,CAAC,CAAC;QACzD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAE1D,OAAO;YACL,OAAO,EAAE,YAAY;YACrB,UAAU;YACV,IAAI,EAAE,UAAU;SACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,kBAAkB,CAAC,YAAoB;IACpD,oCAAoC;IACpC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAEtC,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,eAAe,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAC7G,IAAI,QAAQ,CAAC,EAAE,EAAE,CAAC;gBAChB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAuC,CAAC;gBACxE,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;oBAC9B,yEAAyE;oBACzE,MAAM,WAAW,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAA6B,CAAC;oBACjF,OAAO;wBACL,OAAO,EAAE,WAAW;wBACpB,UAAU,EAAE,IAAI,CAAC,oBAAoB;wBACrC,IAAI;qBACL,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,oBAAoB,CAAC,WAAmB;IACrD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;IACnD,MAAM,WAAW,GAAG,IAAA,eAAQ,EAAC,WAAW,CAAC,CAAC;IAE1C,IAAI,CAAC;QACH,IAAI,IAAA,aAAQ,GAAE,KAAK,OAAO,EAAE,CAAC;YAC3B,QAAQ,CAAC,oBAAoB,WAAW,SAAS,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC1E,CAAC;aAAM,CAAC;YACN,yEAAyE;YACzE,QAAQ,CAAC,aAAa,WAAW,uBAAuB,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,WAAmB;IAC1C,IAAI,CAAC;QACH,mDAAmD;QACnD,MAAM,SAAS,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;QAC9D,IAAI,IAAA,eAAU,EAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,IAAA,iBAAY,EAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,OAAO;iBAClB,OAAO,CAAC,2BAA2B,EAAE,sBAAsB,CAAC;iBAC5D,OAAO,CAAC,8BAA8B,EAAE,uBAAuB,CAAC,CAAC;YACpE,IAAA,kBAAa,EAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QAED,4BAA4B;QAC5B,MAAM,YAAY,GAAG,IAAA,WAAI,EAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;QAC9D,IAAI,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;YAC7B,IAAA,WAAM,EAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;IACzD,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAqB;IAC9C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,MAAM,CAAC,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC,CAAC;QACxE,CAAC,EAAE,MAAM,CAAC,CAAC;QAEX,IAAI,MAAM,GAAG,EAAE,CAAC;QAEhB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAC3C,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;YAChE,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YAC3B,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,KAAK,CAAC,oCAAoC,IAAI,yCAAyC,CAAC,CAAC,CAAC;QACvG,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/config.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Configuration loading and validation.
+ */
+export interface GlassboxConfig {
+    journeys: string;
+    browser: {
+        executablePath?: string;
+        userDataDir?: string;
+        profileDir?: string;
+        defaultViewport: {
+            width: number;
+            height: number;
+        };
+        headless: boolean;
+    };
+    server: {
+        port: number;
+    };
+    testData: {
+        globalSetup?: string;
+        beforeEach?: string;
+        afterEach?: string;
+        globalTeardown?: string;
+    };
+}
+export declare function defineConfig(config: Partial<GlassboxConfig>): Partial<GlassboxConfig>;
+export declare function loadConfig(configPath?: string): Promise<GlassboxConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/src/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE;QACP,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,eAAe,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QACnD,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;IACF,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QACR,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAcD,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,CAErF;AAED,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAmB7E"}

package/dist/src/config.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Configuration loading and validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineConfig = defineConfig;
+exports.loadConfig = loadConfig;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const DEFAULTS = {
+    journeys: './journeys/**/*.journey.ts',
+    browser: {
+        defaultViewport: { width: 1280, height: 720 },
+        headless: false,
+    },
+    server: {
+        port: 3001,
+    },
+    testData: {},
+};
+function defineConfig(config) {
+    return config;
+}
+async function loadConfig(configPath) {
+    const resolvedPath = configPath
+        ? (0, path_1.resolve)(process.cwd(), configPath)
+        : (0, path_1.resolve)(process.cwd(), 'glassbox.config.ts');
+    if (configPath && !(0, fs_1.existsSync)(resolvedPath)) {
+        throw new Error(`Config file not found: ${resolvedPath}`);
+    }
+    if (!(0, fs_1.existsSync)(resolvedPath)) {
+        return { ...DEFAULTS };
+    }
+    const { createJiti } = await import('jiti');
+    const jiti = createJiti(resolvedPath);
+    const userConfig = await jiti.import(resolvedPath);
+    const config = userConfig.default ?? userConfig;
+    return mergeConfig(config, (0, path_1.dirname)(resolvedPath));
+}
+function mergeConfig(user, configDir) {
+    const merged = {
+        journeys: user.journeys ?? DEFAULTS.journeys,
+        browser: {
+            ...DEFAULTS.browser,
+            ...user.browser,
+            defaultViewport: {
+                ...DEFAULTS.browser.defaultViewport,
+                ...user.browser?.defaultViewport,
+            },
+        },
+        server: {
+            ...DEFAULTS.server,
+            ...user.server,
+        },
+        testData: { ...user.testData },
+    };
+    // Resolve relative paths against config directory
+    if (merged.testData.globalSetup) {
+        merged.testData.globalSetup = (0, path_1.resolve)(configDir, merged.testData.globalSetup);
+    }
+    if (merged.testData.beforeEach) {
+        merged.testData.beforeEach = (0, path_1.resolve)(configDir, merged.testData.beforeEach);
+    }
+    if (merged.testData.afterEach) {
+        merged.testData.afterEach = (0, path_1.resolve)(configDir, merged.testData.afterEach);
+    }
+    if (merged.testData.globalTeardown) {
+        merged.testData.globalTeardown = (0, path_1.resolve)(configDir, merged.testData.globalTeardown);
+    }
+    return merged;
+}
+//# sourceMappingURL=config.js.map

package/dist/src/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAqCH,oCAEC;AAED,gCAmBC;AA1DD,2BAAgC;AAChC,+BAAwC;AAsBxC,MAAM,QAAQ,GAAmB;IAC/B,QAAQ,EAAE,4BAA4B;IACtC,OAAO,EAAE;QACP,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE;QAC7C,QAAQ,EAAE,KAAK;KAChB;IACD,MAAM,EAAE;QACN,IAAI,EAAE,IAAI;KACX;IACD,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF,SAAgB,YAAY,CAAC,MAA+B;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAEM,KAAK,UAAU,UAAU,CAAC,UAAmB;IAClD,MAAM,YAAY,GAAG,UAAU;QAC7B,CAAC,CAAC,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,UAAU,CAAC;QACpC,CAAC,CAAC,IAAA,cAAO,EAAC,OAAO,CAAC,GAAG,EAAE,EAAE,oBAAoB,CAAC,CAAC;IAEjD,IAAI,UAAU,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,0BAA0B,YAAY,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,CAAC,IAAA,eAAU,EAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAC;IACzB,CAAC;IAED,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IACtC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAA0C,CAAC;IAC5F,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,IAAI,UAAqC,CAAC;IAE3E,OAAO,WAAW,CAAC,MAAM,EAAE,IAAA,cAAO,EAAC,YAAY,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,WAAW,CAAC,IAA6B,EAAE,SAAiB;IACnE,MAAM,MAAM,GAAmB;QAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;QAC5C,OAAO,EAAE;YACP,GAAG,QAAQ,CAAC,OAAO;YACnB,GAAG,IAAI,CAAC,OAAO;YACf,eAAe,EAAE;gBACf,GAAG,QAAQ,CAAC,OAAO,CAAC,eAAe;gBACnC,GAAG,IAAI,CAAC,OAAO,EAAE,eAAe;aACjC;SACF;QACD,MAAM,EAAE;YACN,GAAG,QAAQ,CAAC,MAAM;YAClB,GAAG,IAAI,CAAC,MAAM;SACf;QACD,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE;KAC/B,CAAC;IAEF,kDAAkD;IAClD,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,WAAW,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC/B,MAAM,CAAC,QAAQ,CAAC,UAAU,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC9E,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC9B,MAAM,CAAC,QAAQ,CAAC,SAAS,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,CAAC,QAAQ,CAAC,cAAc,GAAG,IAAA,cAAO,EAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IACtF,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/config.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Unit tests for config loading and validation.
+ */
+export {};
+//# sourceMappingURL=config.test.d.ts.map

package/dist/src/config.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.d.ts","sourceRoot":"","sources":["../../src/config.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/src/config.test.js

@@ -0,0 +1,46 @@
+"use strict";
+/**
+ * Unit tests for config loading and validation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const config_js_1 = require("./config.js");
+(0, vitest_1.describe)('defineConfig', () => {
+    (0, vitest_1.it)('returns the config object unchanged', () => {
+        const config = (0, config_js_1.defineConfig)({
+            journeys: './tests/**/*.journey.ts',
+            server: { port: 4000 },
+        });
+        (0, vitest_1.expect)(config.journeys).toBe('./tests/**/*.journey.ts');
+        (0, vitest_1.expect)(config.server?.port).toBe(4000);
+    });
+    (0, vitest_1.it)('allows partial config', () => {
+        const config = (0, config_js_1.defineConfig)({});
+        (0, vitest_1.expect)(config).toEqual({});
+    });
+    (0, vitest_1.it)('accepts browser config', () => {
+        const config = (0, config_js_1.defineConfig)({
+            browser: {
+                executablePath: '/usr/bin/chrome',
+                defaultViewport: { width: 1920, height: 1080 },
+                headless: true,
+            },
+        });
+        (0, vitest_1.expect)(config.browser?.executablePath).toBe('/usr/bin/chrome');
+        (0, vitest_1.expect)(config.browser?.defaultViewport?.width).toBe(1920);
+        (0, vitest_1.expect)(config.browser?.headless).toBe(true);
+    });
+    (0, vitest_1.it)('accepts testData hooks', () => {
+        const config = (0, config_js_1.defineConfig)({
+            testData: {
+                globalSetup: './setup.ts',
+                beforeEach: './before.ts',
+                afterEach: './after.ts',
+                globalTeardown: './teardown.ts',
+            },
+        });
+        (0, vitest_1.expect)(config.testData?.globalSetup).toBe('./setup.ts');
+        (0, vitest_1.expect)(config.testData?.beforeEach).toBe('./before.ts');
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/src/config.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.test.js","sourceRoot":"","sources":["../../src/config.test.ts"],"names":[],"mappings":";AAAA;;GAEG;;AAEH,mCAA8C;AAC9C,2CAA2C;AAE3C,IAAA,iBAAQ,EAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,IAAA,WAAE,EAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC;YAC1B,QAAQ,EAAE,yBAAyB;YACnC,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;SACvB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACxD,IAAA,eAAM,EAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC,EAAE,CAAC,CAAC;QAChC,IAAA,eAAM,EAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC;YAC1B,OAAO,EAAE;gBACP,cAAc,EAAE,iBAAiB;gBACjC,eAAe,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;gBAC9C,QAAQ,EAAE,IAAI;aACf;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC/D,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAA,eAAM,EAAC,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,wBAAwB,EAAE,GAAG,EAAE;QAChC,MAAM,MAAM,GAAG,IAAA,wBAAY,EAAC;YAC1B,QAAQ,EAAE;gBACR,WAAW,EAAE,YAAY;gBACzB,UAAU,EAAE,aAAa;gBACzB,SAAS,EAAE,YAAY;gBACvB,cAAc,EAAE,eAAe;aAChC;SACF,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxD,IAAA,eAAM,EAAC,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/src/errors.d.ts

@@ -0,0 +1,26 @@
+/**
+ * DiagnosticError — thrown when a journey step fails.
+ * Includes diagnostic data from the collector at the point of failure.
+ */
+import type { ConsoleError, ExceptionDetail, NetworkFailure } from './ai/types.js';
+export declare class DiagnosticError extends Error {
+    selector?: string;
+    timeout?: number;
+    step?: string;
+    diagnostics: {
+        consoleErrors: ConsoleError[];
+        exceptions: ExceptionDetail[];
+        networkFailures: NetworkFailure[];
+    };
+    constructor(message: string, options?: {
+        selector?: string;
+        timeout?: number;
+        step?: string;
+        diagnostics?: {
+            consoleErrors?: ConsoleError[];
+            exceptions?: ExceptionDetail[];
+            networkFailures?: NetworkFailure[];
+        };
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEnF,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE;QACX,aAAa,EAAE,YAAY,EAAE,CAAC;QAC9B,UAAU,EAAE,eAAe,EAAE,CAAC;QAC9B,eAAe,EAAE,cAAc,EAAE,CAAC;KACnC,CAAC;gBAGA,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;QACP,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE;YACZ,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;YAC/B,UAAU,CAAC,EAAE,eAAe,EAAE,CAAC;YAC/B,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;SACpC,CAAC;KACE;CAaT"}

package/dist/src/errors.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * DiagnosticError — thrown when a journey step fails.
+ * Includes diagnostic data from the collector at the point of failure.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiagnosticError = void 0;
+class DiagnosticError extends Error {
+    selector;
+    timeout;
+    step;
+    diagnostics;
+    constructor(message, options = {}) {
+        super(message);
+        this.name = 'DiagnosticError';
+        this.selector = options.selector;
+        this.timeout = options.timeout;
+        this.step = options.step;
+        this.diagnostics = {
+            consoleErrors: options.diagnostics?.consoleErrors ?? [],
+            exceptions: options.diagnostics?.exceptions ?? [],
+            networkFailures: options.diagnostics?.networkFailures ?? [],
+        };
+    }
+}
+exports.DiagnosticError = DiagnosticError;
+//# sourceMappingURL=errors.js.map

package/dist/src/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,MAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAU;IAClB,OAAO,CAAU;IACjB,IAAI,CAAU;IACd,WAAW,CAIT;IAEF,YACE,OAAe,EACf,UASI,EAAE;QAEN,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,WAAW,GAAG;YACjB,aAAa,EAAE,OAAO,CAAC,WAAW,EAAE,aAAa,IAAI,EAAE;YACvD,UAAU,EAAE,OAAO,CAAC,WAAW,EAAE,UAAU,IAAI,EAAE;YACjD,eAAe,EAAE,OAAO,CAAC,WAAW,EAAE,eAAe,IAAI,EAAE;SAC5D,CAAC;IACJ,CAAC;CACF;AAlCD,0CAkCC"}

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Glassbox — public API surface.
+ * This is what consumers `import from 'glassbox'`.
+ */
+export { BasePage } from './page-objects/base.page.js';
+export { BrowserContextPage } from './page-objects/browser-context.page.js';
+export { Journey } from './journey.js';
+export type { BrowserAdapter, DownloadResult } from './adapters/browser-adapter.interface.js';
+export { defineConfig, loadConfig } from './config.js';
+export type { GlassboxConfig } from './config.js';
+export { waitForCondition } from './utils/wait-utils.js';
+export type { WaitOptions } from './utils/wait-utils.js';
+export { withErrorContext } from './utils/page-object-error.js';
+export { formatTestError, getErrorSummary } from './utils/error-formatter.js';
+export type { FormattedError } from './utils/error-formatter.js';
+export type { HookContext, LifecycleHooks } from './runner/lifecycle-hooks.js';
+export type { ConsoleError, ExceptionDetail, NetworkRequest, NetworkFailure, MetricsSnapshot, TimelineEntry, } from './ai/types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAG5E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAG9F,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAGjE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAG/E,YAAY,EACV,YAAY,EACZ,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,aAAa,GACd,MAAM,eAAe,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Glassbox — public API surface.
+ * This is what consumers `import from 'glassbox'`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getErrorSummary = exports.formatTestError = exports.withErrorContext = exports.waitForCondition = exports.loadConfig = exports.defineConfig = exports.Journey = exports.BrowserContextPage = exports.BasePage = void 0;
+// Page objects
+var base_page_js_1 = require("./page-objects/base.page.js");
+Object.defineProperty(exports, "BasePage", { enumerable: true, get: function () { return base_page_js_1.BasePage; } });
+var browser_context_page_js_1 = require("./page-objects/browser-context.page.js");
+Object.defineProperty(exports, "BrowserContextPage", { enumerable: true, get: function () { return browser_context_page_js_1.BrowserContextPage; } });
+// Journey base class
+var journey_js_1 = require("./journey.js");
+Object.defineProperty(exports, "Journey", { enumerable: true, get: function () { return journey_js_1.Journey; } });
+// Config
+var config_js_1 = require("./config.js");
+Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return config_js_1.defineConfig; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_js_1.loadConfig; } });
+// Utilities
+var wait_utils_js_1 = require("./utils/wait-utils.js");
+Object.defineProperty(exports, "waitForCondition", { enumerable: true, get: function () { return wait_utils_js_1.waitForCondition; } });
+var page_object_error_js_1 = require("./utils/page-object-error.js");
+Object.defineProperty(exports, "withErrorContext", { enumerable: true, get: function () { return page_object_error_js_1.withErrorContext; } });
+var error_formatter_js_1 = require("./utils/error-formatter.js");
+Object.defineProperty(exports, "formatTestError", { enumerable: true, get: function () { return error_formatter_js_1.formatTestError; } });
+Object.defineProperty(exports, "getErrorSummary", { enumerable: true, get: function () { return error_formatter_js_1.getErrorSummary; } });
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,eAAe;AACf,4DAAuD;AAA9C,wGAAA,QAAQ,OAAA;AACjB,kFAA4E;AAAnE,6HAAA,kBAAkB,OAAA;AAE3B,qBAAqB;AACrB,2CAAuC;AAA9B,qGAAA,OAAO,OAAA;AAKhB,SAAS;AACT,yCAAuD;AAA9C,yGAAA,YAAY,OAAA;AAAE,uGAAA,UAAU,OAAA;AAGjC,YAAY;AACZ,uDAAyD;AAAhD,iHAAA,gBAAgB,OAAA;AAEzB,qEAAgE;AAAvD,wHAAA,gBAAgB,OAAA;AACzB,iEAA8E;AAArE,qHAAA,eAAe,OAAA;AAAE,qHAAA,eAAe,OAAA"}

package/dist/src/journey.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Journey base class — provides page object creation with zero boilerplate.
+ *
+ * Consumers extend this and use `this.page(PageClass)` to create page objects.
+ * The adapter is passed via the inherited constructor — no need to define one.
+ *
+ * @example
+ * ```typescript
+ * import { Journey } from 'glassbox';
+ * import { LoginPage } from '../page-objects/login.page';
+ *
+ * export class LoginJourney extends Journey {
+ *   loginPage = this.page(LoginPage);
+ *
+ *   async execute() {
+ *     await this.loginPage.navigateToApp();
+ *     await this.loginPage.login('user', 'pass');
+ *   }
+ * }
+ * ```
+ */
+import type { BrowserAdapter } from './adapters/browser-adapter.interface.js';
+import type { BasePage } from './page-objects/base.page.js';
+export declare abstract class Journey {
+    protected adapter: BrowserAdapter;
+    /**
+     * Create a page object instance with the adapter pre-wired.
+     * Use as a property initializer: `loginPage = this.page(LoginPage);`
+     */
+    protected page<T extends BasePage>(PageClass: new (adapter: BrowserAdapter) => T): T;
+    /** Override this to define the journey's test flow. */
+    abstract execute(): Promise<void>;
+    constructor(adapter: BrowserAdapter);
+}
+//# sourceMappingURL=journey.d.ts.map

package/dist/src/journey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.d.ts","sourceRoot":"","sources":["../../src/journey.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,8BAAsB,OAAO;IAYf,SAAS,CAAC,OAAO,EAAE,cAAc;IAX7C;;;OAGG;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,QAAQ,EAAE,SAAS,EAAE,KAAK,OAAO,EAAE,cAAc,KAAK,CAAC,GAAG,CAAC;IAIpF,uDAAuD;IACvD,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;gBAEX,OAAO,EAAE,cAAc;CAC9C"}

package/dist/src/journey.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * Journey base class — provides page object creation with zero boilerplate.
+ *
+ * Consumers extend this and use `this.page(PageClass)` to create page objects.
+ * The adapter is passed via the inherited constructor — no need to define one.
+ *
+ * @example
+ * ```typescript
+ * import { Journey } from 'glassbox';
+ * import { LoginPage } from '../page-objects/login.page';
+ *
+ * export class LoginJourney extends Journey {
+ *   loginPage = this.page(LoginPage);
+ *
+ *   async execute() {
+ *     await this.loginPage.navigateToApp();
+ *     await this.loginPage.login('user', 'pass');
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Journey = void 0;
+class Journey {
+    adapter;
+    /**
+     * Create a page object instance with the adapter pre-wired.
+     * Use as a property initializer: `loginPage = this.page(LoginPage);`
+     */
+    page(PageClass) {
+        return new PageClass(this.adapter);
+    }
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+}
+exports.Journey = Journey;
+//# sourceMappingURL=journey.js.map

package/dist/src/journey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"journey.js","sourceRoot":"","sources":["../../src/journey.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;;;AAKH,MAAsB,OAAO;IAYL;IAXtB;;;OAGG;IACO,IAAI,CAAqB,SAA6C;QAC9E,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAKD,YAAsB,OAAuB;QAAvB,YAAO,GAAP,OAAO,CAAgB;IAAG,CAAC;CAClD;AAbD,0BAaC"}

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

@@ -0,0 +1,22 @@
+/**
+ * Glassbox MCP Server — exposes diagnostic tools for AI agents.
+ *
+ * Runs as a stdio-based MCP server that translates tool calls into
+ * REST API requests against the running Glassbox server.
+ *
+ * Usage in mcp.json:
+ * ```json
+ * {
+ *   "mcpServers": {
+ *     "glassbox": {
+ *       "command": "npx",
+ *       "args": ["glassbox", "mcp"],
+ *       "env": { "GLASSBOX_URL": "http://localhost:3001" }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+/** Start the MCP server. */
+export declare function startMCPServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAoMH,4BAA4B;AAC5B,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA6BpD"}