tabwright 1.0.0

package/dist/test-utils.js

@@ -0,0 +1,448 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import http from 'node:http';
+import { chromium } from '@xmorse/playwright-core';
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { startTabwrightCDPRelayServer } from './cdp-relay.js';
+import { createFileLogger } from './create-logger.js';
+import { killPortProcess } from './kill-port.js';
+const execAsync = promisify(exec);
+const extensionBuildQueues = new Map();
+const EXTENSION_SERVICE_WORKER_TIMEOUT_MS = 15_000;
+export function getLocalChromeExecutable() {
+    const candidates = [
+        process.env.PLAYWRIGHT_CHROME_EXECUTABLE,
+        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+        '/Applications/Chromium.app/Contents/MacOS/Chromium',
+        '/usr/bin/google-chrome',
+        '/usr/bin/google-chrome-stable',
+        '/usr/bin/chromium',
+        '/usr/bin/chromium-browser',
+        'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+        'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+    ].filter((candidate) => {
+        return Boolean(candidate);
+    });
+    return candidates.find((candidate) => {
+        return fs.existsSync(candidate);
+    });
+}
+export function getLegacyExtensionLaunchArgs({ extensionPaths }) {
+    const resolvedExtensionPaths = extensionPaths.map((extensionPath) => {
+        return path.resolve(extensionPath);
+    });
+    const legacyExtensionPaths = resolvedExtensionPaths.join(',');
+    return [
+        `--disable-extensions-except=${legacyExtensionPaths}`,
+        `--load-extension=${legacyExtensionPaths}`,
+    ];
+}
+export function isExtensionLoadUnavailableError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return (message.includes('Method not found') ||
+        message.includes("'Extensions.loadUnpacked' wasn't found") ||
+        message.includes('-32601'));
+}
+async function loadUnpackedExtensionsThroughCdp({ browserContext, extensionPaths, }) {
+    const browser = browserContext.browser();
+    if (!browser) {
+        throw new Error('Persistent browser context has no browser connection');
+    }
+    const session = await browser.newBrowserCDPSession();
+    try {
+        await Promise.all(extensionPaths.map(async (extensionPath) => {
+            await session.send('Extensions.loadUnpacked', { path: path.resolve(extensionPath) });
+        }));
+    }
+    finally {
+        await session.detach().catch((error) => {
+            console.error('Failed to detach test extension CDP session:', error);
+        });
+    }
+}
+async function launchTestBrowser({ userDataDir, args, }) {
+    const chromeExecutable = getLocalChromeExecutable();
+    return await chromium.launchPersistentContext(userDataDir, {
+        ...(chromeExecutable ? { executablePath: chromeExecutable } : { channel: 'chromium' }),
+        headless: !process.env.HEADFUL,
+        colorScheme: 'dark',
+        ignoreDefaultArgs: ['--disable-extensions'],
+        args,
+    });
+}
+export async function launchPersistentContextWithExtensions({ userDataDir, extensionPaths, }) {
+    const browserContext = await launchTestBrowser({
+        userDataDir,
+        // Chrome 137+ ignores --load-extension for branded builds. Its supported
+        // Extensions.loadUnpacked replacement requires this opt-in switch.
+        args: ['--enable-unsafe-extension-debugging'],
+    });
+    try {
+        await loadUnpackedExtensionsThroughCdp({ browserContext, extensionPaths });
+        return browserContext;
+    }
+    catch (error) {
+        await browserContext.close();
+        if (!isExtensionLoadUnavailableError(error)) {
+            throw new Error(`Failed to load unpacked test extensions: ${extensionPaths.join(', ')}`, { cause: error });
+        }
+        // Older Chrome/Chromium does not expose Extensions.loadUnpacked. Relaunch
+        // the same isolated profile with the legacy flags it still supports.
+        return await launchTestBrowser({
+            userDataDir,
+            args: getLegacyExtensionLaunchArgs({ extensionPaths }),
+        });
+    }
+}
+async function buildExtension({ port, distDir }) {
+    const previous = extensionBuildQueues.get(distDir) || Promise.resolve();
+    const buildPromise = previous
+        .catch((error) => {
+        console.error('Previous extension build failed:', error);
+    })
+        .then(async () => {
+        // Build into a per-port dist to avoid parallel test runs overwriting each other.
+        await execAsync(`TESTING=1 TABWRIGHT_PORT=${port} TABWRIGHT_EXTENSION_DIST=${distDir} pnpm build`, {
+            cwd: '../extension',
+        });
+    });
+    extensionBuildQueues.set(distDir, buildPromise.finally(() => { }));
+    await buildPromise;
+}
+export async function getExtensionServiceWorker(context) {
+    const serviceWorkers = context.serviceWorkers().filter((sw) => sw.url().startsWith('chrome-extension://'));
+    if (serviceWorkers.length === 0) {
+        await context
+            .waitForEvent('serviceworker', {
+            predicate: (sw) => sw.url().startsWith('chrome-extension://'),
+            timeout: EXTENSION_SERVICE_WORKER_TIMEOUT_MS,
+        })
+            .catch((error) => {
+            throw new Error(`No extension service worker appeared within ${EXTENSION_SERVICE_WORKER_TIMEOUT_MS}ms`, { cause: error });
+        });
+    }
+    // Check all chrome-extension service workers for the Tabwright one (the one
+    // that exposes toggleExtensionForActiveTab). This handles cases where
+    // additional test fixture extensions are loaded alongside Tabwright.
+    for (let i = 0; i < 50; i++) {
+        const allSws = context.serviceWorkers().filter((sw) => sw.url().startsWith('chrome-extension://'));
+        for (const sw of allSws) {
+            try {
+                const isReady = await sw.evaluate(() => {
+                    // @ts-ignore
+                    return typeof globalThis.toggleExtensionForActiveTab === 'function';
+                });
+                if (isReady) {
+                    return sw;
+                }
+            }
+            catch {
+                // Service worker might not be ready yet
+            }
+        }
+        await new Promise((r) => setTimeout(r, 100));
+    }
+    const extensionWorkerUrls = context
+        .serviceWorkers()
+        .filter((sw) => {
+        return sw.url().startsWith('chrome-extension://');
+    })
+        .map((sw) => {
+        return sw.url();
+    });
+    throw new Error(`Tabwright extension service worker did not become ready within ${EXTENSION_SERVICE_WORKER_TIMEOUT_MS}ms. Visible extension workers: ${extensionWorkerUrls.join(', ') || 'none'}`);
+}
+export async function setupTestContext({ port, tempDirPrefix, toggleExtension = false, additionalExtensions = [], }) {
+    await killPortProcess({ port }).catch(() => { });
+    // Use a port-scoped dist folder so parallel tests don't replace each other's extension builds.
+    const distDir = `dist-${port}`;
+    console.log('Building extension...');
+    await buildExtension({ port, distDir });
+    console.log('Extension built');
+    const localLogPath = path.join(process.cwd(), 'relay-server.log');
+    const logger = createFileLogger({ logFilePath: localLogPath });
+    const relayServer = await startTabwrightCDPRelayServer({ port, logger });
+    const userDataDir = fs.mkdtempSync(path.join(os.tmpdir(), tempDirPrefix));
+    const extensionPath = path.resolve('../extension', distDir);
+    try {
+        const browserContext = await launchPersistentContextWithExtensions({
+            userDataDir,
+            extensionPaths: [extensionPath, ...additionalExtensions],
+        });
+        try {
+            if (toggleExtension) {
+                const serviceWorker = await getExtensionServiceWorker(browserContext);
+                const page = await browserContext.newPage();
+                await page.goto('about:blank');
+                await serviceWorker.evaluate(async () => {
+                    await globalThis.toggleExtensionForActiveTab();
+                });
+            }
+            return { browserContext, userDataDir, relayServer };
+        }
+        catch (error) {
+            await browserContext.close().catch((closeError) => {
+                console.error('Failed to close browser after test setup error:', closeError);
+            });
+            throw error;
+        }
+    }
+    catch (error) {
+        relayServer.close();
+        try {
+            fs.rmSync(userDataDir, { recursive: true, force: true });
+        }
+        catch (cleanupError) {
+            console.error('Failed to clean test profile after setup error:', cleanupError);
+        }
+        throw error;
+    }
+}
+export async function cleanupTestContext(ctx, cleanup) {
+    if (ctx?.browserContext) {
+        await ctx.browserContext.close();
+    }
+    if (ctx?.relayServer) {
+        ctx.relayServer.close();
+    }
+    if (ctx?.userDataDir) {
+        try {
+            fs.rmSync(ctx.userDataDir, { recursive: true, force: true });
+        }
+        catch (e) {
+            console.error('Failed to cleanup user data dir:', e);
+        }
+    }
+    if (cleanup) {
+        await cleanup();
+    }
+}
+export async function createSseServer() {
+    let sseResponse = null;
+    let sseFinished = false;
+    let sseClosed = false;
+    let sseWriteCount = 0;
+    let sseInterval = null;
+    const openResponses = new Set();
+    const openSockets = new Set();
+    const server = http.createServer((req, res) => {
+        if (req.url === '/') {
+            res.writeHead(200, { 'Content-Type': 'text/html' });
+            res.end(`<!doctype html>
+<html>
+  <head>
+    <meta charset="utf-8" />
+    <title>SSE Test</title>
+  </head>
+  <body>
+    <script>
+      window.__sseMessages = [];
+      window.__sseOpen = false;
+      window.__sseError = null;
+      window.startSse = function () {
+        const source = new EventSource('/sse');
+        window.__sseSource = source;
+        source.onopen = function () {
+          window.__sseOpen = true;
+        };
+        source.onmessage = function (event) {
+          window.__sseMessages.push(event.data);
+        };
+        source.onerror = function () {
+          window.__sseError = 'SSE error';
+        };
+        return true;
+      };
+      window.stopSse = function () {
+        if (window.__sseSource) {
+          window.__sseSource.close();
+        }
+      };
+    </script>
+  </body>
+</html>`);
+            return;
+        }
+        if (req.url === '/sse') {
+            res.writeHead(200, {
+                'Content-Type': 'text/event-stream',
+                'Cache-Control': 'no-cache, no-transform',
+                Connection: 'keep-alive',
+            });
+            res.write('retry: 1000\n\n');
+            res.write('data: hello\n\n');
+            sseResponse = res;
+            sseWriteCount += 1;
+            openResponses.add(res);
+            res.on('finish', () => {
+                sseFinished = true;
+            });
+            res.on('close', () => {
+                sseClosed = true;
+                openResponses.delete(res);
+                if (sseInterval) {
+                    clearInterval(sseInterval);
+                    sseInterval = null;
+                }
+            });
+            sseInterval = setInterval(() => {
+                res.write('data: ping\n\n');
+                sseWriteCount += 1;
+            }, 200);
+            return;
+        }
+        res.writeHead(404);
+        res.end('Not found');
+    });
+    server.on('connection', (socket) => {
+        openSockets.add(socket);
+        socket.on('close', () => {
+            openSockets.delete(socket);
+        });
+    });
+    await new Promise((resolve) => {
+        server.listen(0, '127.0.0.1', () => {
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === 'string') {
+        throw new Error('Failed to bind SSE server');
+    }
+    return {
+        baseUrl: `http://127.0.0.1:${address.port}`,
+        getState: () => ({
+            connected: sseResponse !== null,
+            finished: sseFinished,
+            closed: sseClosed,
+            writeCount: sseWriteCount,
+        }),
+        close: async () => {
+            for (const response of openResponses) {
+                response.destroy();
+            }
+            for (const socket of openSockets) {
+                socket.destroy();
+            }
+            if (sseInterval) {
+                clearInterval(sseInterval);
+                sseInterval = null;
+            }
+            await new Promise((resolve, reject) => {
+                server.close((error) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    resolve();
+                });
+            });
+        },
+    };
+}
+export async function withTimeout({ promise, timeoutMs, errorMessage, }) {
+    return await new Promise((resolve, reject) => {
+        const timeoutId = setTimeout(() => {
+            reject(new Error(errorMessage));
+        }, timeoutMs);
+        promise
+            .then((value) => {
+            clearTimeout(timeoutId);
+            resolve(value);
+        })
+            .catch((error) => {
+            clearTimeout(timeoutId);
+            reject(error);
+        });
+    });
+}
+/** Tagged template for inline JS code strings used in MCP execute calls */
+export function js(strings, ...values) {
+    return strings.reduce((result, str, i) => result + str + (values[i] || ''), '');
+}
+export function tryJsonParse(str) {
+    try {
+        return JSON.parse(str);
+    }
+    catch {
+        return str;
+    }
+}
+/**
+ * Safely close a browser connected via connectOverCDP.
+ *
+ * Playwright's CRConnection uses async message handling (messageWrap) that can cause
+ * a race condition where _onClose() runs before all pending _onMessage() handlers complete.
+ * This results in "Assertion error" from crConnection.js when a CDP response arrives
+ * after callbacks were cleared by dispose().
+ *
+ * This helper waits for the message queue to drain before closing, avoiding the race.
+ *
+ * @param browser - Browser instance from chromium.connectOverCDP()
+ * @param drainDelayMs - Time to wait for pending messages to be processed (default: 50ms)
+ */
+export async function safeCloseCDPBrowser(browser, drainDelayMs = 50) {
+    // Wait for any queued message handlers to run
+    // This gives Playwright's messageWrap time to process pending CDP responses
+    await new Promise((r) => setTimeout(r, drainDelayMs));
+    await browser.close();
+}
+/** Minimal local HTTP server for tests that need cross-origin iframes or custom routes */
+export async function createSimpleServer({ routes }) {
+    const openSockets = new Set();
+    const server = http.createServer((req, res) => {
+        const url = req.url || '/';
+        const body = routes[url];
+        if (!body) {
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('not found');
+            return;
+        }
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(body);
+    });
+    server.on('connection', (socket) => {
+        openSockets.add(socket);
+        socket.on('close', () => {
+            openSockets.delete(socket);
+        });
+    });
+    await new Promise((resolve) => {
+        server.listen(0, '127.0.0.1', () => {
+            resolve();
+        });
+    });
+    const address = server.address();
+    if (!address || typeof address === 'string') {
+        await new Promise((resolve, reject) => {
+            server.close((error) => {
+                if (error) {
+                    reject(error);
+                    return;
+                }
+                resolve();
+            });
+        });
+        throw new Error('Failed to start test server');
+    }
+    return {
+        baseUrl: `http://127.0.0.1:${address.port}`,
+        close: async () => {
+            for (const socket of openSockets) {
+                socket.destroy();
+            }
+            await new Promise((resolve, reject) => {
+                server.close((error) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/test-utils.js.map

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

package/dist/test-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-utils.test.d.ts.map

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

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

package/dist/test-utils.test.js

@@ -0,0 +1,55 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { describe, expect, test } from 'vitest';
+import { startTabwrightCDPRelayServer } from './cdp-relay.js';
+import { getExtensionServiceWorker, getLegacyExtensionLaunchArgs, isExtensionLoadUnavailableError, launchPersistentContextWithExtensions, } from './test-utils.js';
+describe('extension test browser launch', () => {
+    test('builds the legacy extension launch fallback flags', () => {
+        const extensionPaths = ['./extension-one', './extension-two'];
+        const args = getLegacyExtensionLaunchArgs({ extensionPaths });
+        const resolvedPaths = extensionPaths.map((extensionPath) => {
+            return path.resolve(extensionPath);
+        });
+        expect(args).toContain(`--disable-extensions-except=${resolvedPaths.join(',')}`);
+        expect(args).toContain(`--load-extension=${resolvedPaths.join(',')}`);
+    });
+    test('recognizes older browsers without Extensions.loadUnpacked', () => {
+        expect(isExtensionLoadUnavailableError(new Error("Protocol error (Extensions.loadUnpacked): 'Extensions.loadUnpacked' wasn't found"))).toBe(true);
+        expect(isExtensionLoadUnavailableError(new Error('Method not found'))).toBe(true);
+        expect(isExtensionLoadUnavailableError(new Error('Manifest is invalid'))).toBe(false);
+    });
+    test.runIf(Boolean(process.env.PLAYWRITER_TEST_EXTENSION_PATH))('loads an unpacked extension in the installed Chrome build', async () => {
+        const extensionPath = process.env.PLAYWRITER_TEST_EXTENSION_PATH;
+        if (!extensionPath) {
+            throw new Error('PLAYWRITER_TEST_EXTENSION_PATH is required');
+        }
+        const tempRoot = path.join(process.cwd(), 'tmp');
+        fs.mkdirSync(tempRoot, { recursive: true });
+        const userDataDir = fs.mkdtempSync(path.join(tempRoot, 'pw-extension-load-test-'));
+        const relayServer = await startTabwrightCDPRelayServer({
+            port: Number(process.env.PLAYWRITER_TEST_RELAY_PORT) || 19_997,
+        });
+        try {
+            const browserContext = await launchPersistentContextWithExtensions({
+                userDataDir,
+                extensionPaths: [extensionPath],
+            });
+            try {
+                const serviceWorker = await getExtensionServiceWorker(browserContext).catch(async (error) => {
+                    const session = await browserContext.browser()?.newBrowserCDPSession();
+                    const targets = session ? await session.send('Target.getTargets') : null;
+                    throw new Error(`No extension service worker target was visible: ${JSON.stringify(targets)}`, { cause: error });
+                });
+                expect(serviceWorker.url()).toMatch(/^chrome-extension:\/\//);
+            }
+            finally {
+                await browserContext.close();
+            }
+        }
+        finally {
+            relayServer.close();
+            fs.rmSync(userDataDir, { recursive: true, force: true });
+        }
+    }, 60_000);
+});
+//# sourceMappingURL=test-utils.test.js.map

package/dist/test-utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.test.js","sourceRoot":"","sources":["../src/test-utils.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC/C,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAA;AAC7D,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,+BAA+B,EAC/B,qCAAqC,GACtC,MAAM,iBAAiB,CAAA;AAExB,QAAQ,CAAC,+BAA+B,EAAE,GAAG,EAAE;IAC7C,IAAI,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC7D,MAAM,cAAc,GAAG,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,CAAA;QAC7D,MAAM,IAAI,GAAG,4BAA4B,CAAC,EAAE,cAAc,EAAE,CAAC,CAAA;QAC7D,MAAM,aAAa,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE;YACzD,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAA;QACpC,CAAC,CAAC,CAAA;QAEF,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,+BAA+B,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAChF,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,oBAAoB,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACvE,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACrE,MAAM,CACJ,+BAA+B,CAC7B,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAC9F,CACF,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACZ,MAAM,CAAC,+BAA+B,CAAC,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACjF,MAAM,CAAC,+BAA+B,CAAC,IAAI,KAAK,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACvF,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC,CAC7D,2DAA2D,EAC3D,KAAK,IAAI,EAAE;QACT,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAA;QAChE,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;QAC/D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,KAAK,CAAC,CAAA;QAChD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QAC3C,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC,CAAA;QAClF,MAAM,WAAW,GAAG,MAAM,4BAA4B,CAAC;YACrD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,MAAM;SAC/D,CAAC,CAAA;QACF,IAAI,CAAC;YACH,MAAM,cAAc,GAAG,MAAM,qCAAqC,CAAC;gBACjE,WAAW;gBACX,cAAc,EAAE,CAAC,aAAa,CAAC;aAChC,CAAC,CAAA;YACF,IAAI,CAAC;gBACH,MAAM,aAAa,GAAG,MAAM,yBAAyB,CAAC,cAAc,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;oBACnG,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,OAAO,EAAE,EAAE,oBAAoB,EAAE,CAAA;oBACtE,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;oBACxE,MAAM,IAAI,KAAK,CAAC,mDAAmD,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;gBACjH,CAAC,CAAC,CAAA;gBACF,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;YAC/D,CAAC;oBAAS,CAAC;gBACT,MAAM,cAAc,CAAC,KAAK,EAAE,CAAA;YAC9B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,WAAW,CAAC,KAAK,EAAE,CAAA;YACnB,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;QAC1D,CAAC;IACH,CAAC,EACD,MAAM,CACP,CAAA;AACH,CAAC,CAAC,CAAA"}

package/dist/utils.d.ts

@@ -0,0 +1,26 @@
+import './env-compat.js';
+export declare const EXTENSION_IDS: string[];
+/**
+ * Parse a relay host string into HTTP and WebSocket base URLs.
+ * Supports both plain hostnames (appends port) and full URLs (uses as-is).
+ *
+ * Examples:
+ *   "192.168.1.10"                        → http://192.168.1.10:19988, ws://192.168.1.10:19988
+ *   "https://my-machine-tunnel.traforo.dev" → https://my-machine-tunnel.traforo.dev, wss://my-machine-tunnel.traforo.dev
+ */
+export declare function parseRelayHost(host: string, port?: number): {
+    httpBaseUrl: string;
+    wsBaseUrl: string;
+};
+export declare function getCdpUrl({ port, host, token, extensionId, }?: {
+    port?: number;
+    host?: string;
+    token?: string;
+    extensionId?: string | null;
+}): string;
+export declare function shouldAutoEnableTabwright(): boolean;
+export declare const LOG_FILE_PATH: string;
+export declare const LOG_CDP_FILE_PATH: string;
+export declare const VERSION: string;
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAGA,OAAO,iBAAiB,CAAA;AAIxB,eAAO,MAAM,aAAa,UAGzB,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAc,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAY7G;AAED,wBAAgB,SAAS,CAAC,EACxB,IAAY,EACZ,IAAkB,EAClB,KAAK,EACL,WAAW,GACZ,GAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB,UAaL;AAED,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAID,eAAO,MAAM,aAAa,QACkG,CAAA;AAC5H,eAAO,MAAM,iBAAiB,QAGuB,CAAA;AAGrD,eAAO,MAAM,OAAO,EAAoE,MAAM,CAAA;AAE9F,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/dist/utils.js

@@ -0,0 +1,60 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import './env-compat.js';
+import { getTabwrightUserDataDir } from './product-paths.js';
+// Tabwright extension IDs - used for validation and Chrome flag commands
+export const EXTENSION_IDS = [
+    'jfeammnjpkecdekppnclgkkffahnhfhe', // Production (Chrome Web Store)
+    'pebbngnfojnignonigcnkdilknapkgid', // Dev extension (stable ID from manifest key)
+];
+/**
+ * Parse a relay host string into HTTP and WebSocket base URLs.
+ * Supports both plain hostnames (appends port) and full URLs (uses as-is).
+ *
+ * Examples:
+ *   "192.168.1.10"                        → http://192.168.1.10:19988, ws://192.168.1.10:19988
+ *   "https://my-machine-tunnel.traforo.dev" → https://my-machine-tunnel.traforo.dev, wss://my-machine-tunnel.traforo.dev
+ */
+export function parseRelayHost(host, port = 19988) {
+    if (host.startsWith('https://') || host.startsWith('http://')) {
+        const url = new URL(host);
+        const httpBaseUrl = url.origin;
+        const wsProtocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+        const wsBaseUrl = `${wsProtocol}//${url.host}`;
+        return { httpBaseUrl, wsBaseUrl };
+    }
+    return {
+        httpBaseUrl: `http://${host}:${port}`,
+        wsBaseUrl: `ws://${host}:${port}`,
+    };
+}
+export function getCdpUrl({ port = 19988, host = '127.0.0.1', token, extensionId, } = {}) {
+    const id = `${Math.random().toString(36).substring(2, 15)}_${Date.now()}`;
+    const params = new URLSearchParams();
+    if (token) {
+        params.set('token', token);
+    }
+    if (extensionId) {
+        params.set('extensionId', extensionId);
+    }
+    const queryString = params.toString();
+    const suffix = queryString ? `?${queryString}` : '';
+    const { wsBaseUrl } = parseRelayHost(host, port);
+    return `${wsBaseUrl}/cdp/${id}${suffix}`;
+}
+export function shouldAutoEnableTabwright() {
+    return (process.env.TABWRIGHT_AUTO_ENABLE || process.env.PLAYWRITER_AUTO_ENABLE)?.toLowerCase() !== 'false';
+}
+// Existing installations continue using their legacy data directory until users migrate it.
+const LOG_BASE_DIR = getTabwrightUserDataDir();
+export const LOG_FILE_PATH = process.env.TABWRIGHT_LOG_FILE_PATH || process.env.PLAYWRITER_LOG_FILE_PATH || path.join(LOG_BASE_DIR, 'relay-server.log');
+export const LOG_CDP_FILE_PATH = process.env.TABWRIGHT_CDP_LOG_FILE_PATH ||
+    process.env.PLAYWRITER_CDP_LOG_FILE_PATH ||
+    path.join(path.dirname(LOG_FILE_PATH), 'cdp.jsonl');
+const packageJsonPath = path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'package.json');
+export const VERSION = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8')).version;
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/wait-for-page-load.d.ts

@@ -0,0 +1,16 @@
+import type { Page } from '@xmorse/playwright-core';
+export interface WaitForPageLoadOptions {
+    page: Page;
+    timeout?: number;
+    pollInterval?: number;
+    minWait?: number;
+}
+export interface WaitForPageLoadResult {
+    success: boolean;
+    readyState: string;
+    pendingRequests: string[];
+    waitTimeMs: number;
+    timedOut: boolean;
+}
+export declare function waitForPageLoad(options: WaitForPageLoadOptions): Promise<WaitForPageLoadResult>;
+//# sourceMappingURL=wait-for-page-load.d.ts.map

package/dist/wait-for-page-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wait-for-page-load.d.ts","sourceRoot":"","sources":["../src/wait-for-page-load.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAA;AA2CnD,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,EAAE,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,OAAO,CAAA;CAClB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA2IrG"}