@playwright-repl/runner 0.21.2

package/dist/execute.js

@@ -0,0 +1,281 @@
+/**
+ * Execute a test file via two paths:
+ *
+ * 1. Browser path (default): compile → send to bridge → runs in service worker
+ *    where page/expect are real Playwright objects. Zero bridge round-trips.
+ *
+ * 2. Node.js path: compile → run locally → page calls go through Proxy → bridge.
+ *    Used when test imports Node.js APIs (fs, path, http, etc.)
+ */
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { expect as pwExpect } from '@playwright/test';
+const __filename = fileURLToPath(import.meta.url);
+// ─── Alias path (resolved once) ────────────────────────────────────────────
+let _aliasPath = null;
+function getAliasPath() {
+    if (_aliasPath)
+        return _aliasPath;
+    _aliasPath = path.resolve(path.dirname(__filename), 'shim/alias.ts');
+    if (!fs.existsSync(_aliasPath))
+        _aliasPath = _aliasPath.replace('.ts', '.js');
+    return _aliasPath;
+}
+// Browser framework is pre-loaded in the extension's service worker
+// (packages/extension/src/test-framework.ts). No setup needed here.
+// ─── Execute (auto-detect path) ────────────────────────────────────────────
+export async function executeTestFile(testFilePath, bridge, opts, nodePage, cdpPage) {
+    const needsNode = opts.forceNode || await detectNodeAPIs(testFilePath);
+    console.log(`  [path] ${path.basename(testFilePath)} → ${needsNode ? 'NODE' : 'BROWSER'}`);
+    if (needsNode) {
+        return executeNode(testFilePath, bridge, opts.grep, nodePage, cdpPage);
+    }
+    return executeBrowser(testFilePath, bridge, opts.grep);
+}
+// ─── Browser Path ──────────────────────────────────────────────────────────
+async function executeBrowser(testFilePath, bridge, grep) {
+    // Set grep in browser framework
+    if (grep)
+        await bridge.run(`globalThis.__setGrep(${JSON.stringify(grep)})`);
+    else
+        await bridge.run(`globalThis.__setGrep(null)`);
+    const compiled = await compileBrowser(testFilePath);
+    // Send compiled test to bridge — runs in SW with real page/expect
+    const r = await bridge.run(compiled);
+    if (r.isError)
+        throw new Error(r.text || 'Bridge error');
+    return parseResults(r.text || '', testFilePath);
+}
+async function compileBrowser(testFilePath) {
+    const esbuild = await import('esbuild');
+    const testDir = path.dirname(testFilePath);
+    const testFileName = path.basename(testFilePath);
+    const plugin = {
+        name: 'pw-browser',
+        setup(build) {
+            build.onResolve({ filter: /^__entry__$/ }, () => ({ path: '__entry__', namespace: 'entry' }));
+            build.onLoad({ filter: /.*/, namespace: 'entry' }, () => ({
+                contents: `
+          import './${testFileName}';
+        `,
+                resolveDir: testDir,
+                loader: 'ts',
+            }));
+        },
+    };
+    const result = await esbuild.build({
+        entryPoints: ['__entry__'],
+        bundle: true, write: false, format: 'iife', platform: 'neutral',
+        plugins: [plugin],
+        alias: { '@playwright/test': getAliasPath() },
+    });
+    // Wrap: reset state → run test registration → run tests → return result
+    const testCode = result.outputFiles[0].text;
+    return `
+    globalThis.__resetTestState();
+    ${testCode}
+    await globalThis.__runTests();
+  `;
+}
+// ─── Node.js Path ──────────────────────────────────────────────────────────
+async function executeNode(testFilePath, bridge, grep, nodePage, cdpPage) {
+    console.log(`  [node] DIRECT mode`);
+    const page = cdpPage || nodePage;
+    const expect = pwExpect;
+    // Collect registered tests
+    const tests = [];
+    const hooks = {
+        beforeEach: [], afterEach: [], beforeAll: [], afterAll: [],
+    };
+    // Provide test/expect on globalThis for the compiled test file
+    const grepRe = grep ? new RegExp(grep, 'i') : null;
+    const testFn = (name, fn) => { tests.push({ name, fn, skip: false }); };
+    testFn.only = testFn;
+    testFn.skip = (nameOrCond, fn) => {
+        if (typeof nameOrCond === 'string')
+            tests.push({ name: nameOrCond, fn, skip: true });
+    };
+    testFn.describe = (name, fn) => {
+        const prefix = name;
+        const origTest = globalThis.__test;
+        const wrappedTest = (n, f) => { tests.push({ name: `${prefix} > ${n}`, fn: f, skip: false }); };
+        wrappedTest.skip = (nOrC, f) => {
+            if (typeof nOrC === 'string')
+                tests.push({ name: `${prefix} > ${nOrC}`, fn: f, skip: true });
+        };
+        wrappedTest.only = wrappedTest;
+        globalThis.__test = wrappedTest;
+        fn();
+        globalThis.__test = origTest;
+    };
+    testFn.describe.configure = () => { };
+    testFn.beforeEach = (fn) => { hooks.beforeEach.push(fn); };
+    testFn.afterEach = (fn) => { hooks.afterEach.push(fn); };
+    testFn.beforeAll = (fn) => { hooks.beforeAll.push(fn); };
+    testFn.afterAll = (fn) => { hooks.afterAll.push(fn); };
+    testFn.fixme = (condOrName, fn) => {
+        if (typeof condOrName === 'string')
+            tests.push({ name: condOrName, fn, skip: true });
+    };
+    testFn.slow = () => { };
+    testFn.info = () => ({ annotations: [] });
+    testFn.extend = (fixtures) => {
+        // Return a test function that applies extended fixtures
+        const extended = (name, fn) => {
+            testFn(name, async (baseFixtures) => {
+                const ext = { ...baseFixtures };
+                for (const [key, fixtureFn] of Object.entries(fixtures)) {
+                    if (typeof fixtureFn === 'function') {
+                        await new Promise((resolve, reject) => {
+                            Promise.resolve(fixtureFn({ ...ext }, async (value) => { ext[key] = value; resolve(); })).catch(reject);
+                        });
+                    }
+                }
+                await fn(ext);
+            });
+        };
+        // Copy methods
+        for (const k of Object.keys(testFn))
+            extended[k] = testFn[k];
+        return extended;
+    };
+    globalThis.__test = testFn;
+    globalThis.__expect = expect;
+    // Compile and import (registers tests, doesn't run them)
+    const compiled = await compileNode(testFilePath);
+    const tmpFile = path.join(os.tmpdir(), `pw-test-${Date.now()}.mjs`);
+    try {
+        fs.writeFileSync(tmpFile, compiled);
+        await import(`file://${tmpFile.replace(/\\/g, '/')}`);
+    }
+    finally {
+        try {
+            fs.unlinkSync(tmpFile);
+        }
+        catch { /* ignore */ }
+    }
+    // Run tests from Node side with real page
+    let bridgeCallCount = 0;
+    const origRun = bridge.run.bind(bridge);
+    bridge.run = async (cmd, opts) => { bridgeCallCount++; return origRun(cmd, opts); };
+    const results = [];
+    const fixtures = { page, context: page.context(), expect };
+    for (const hook of hooks.beforeAll)
+        await hook(fixtures);
+    for (const t of tests) {
+        if (t.skip || (grepRe && !grepRe.test(t.name))) {
+            results.push({ name: t.name, file: testFilePath, passed: true, skipped: true, duration: 0 });
+            continue;
+        }
+        const start = Date.now();
+        try {
+            for (const fn of hooks.beforeEach)
+                await fn(fixtures);
+            await t.fn(fixtures);
+            for (const fn of hooks.afterEach)
+                await fn(fixtures);
+            results.push({ name: t.name, file: testFilePath, passed: true, skipped: false, duration: Date.now() - start });
+        }
+        catch (err) {
+            const msg = err.message || String(err);
+            console.error(`    [FAIL] ${t.name}\n      ${msg.split('\n').slice(0, 3).join('\n      ')}`);
+            results.push({ name: t.name, file: testFilePath, passed: false, skipped: false, error: msg, duration: Date.now() - start });
+        }
+    }
+    for (const hook of hooks.afterAll)
+        await hook(fixtures);
+    console.log(`  [node] bridge calls: ${bridgeCallCount}`);
+    return results;
+}
+async function compileNode(testFilePath) {
+    const esbuild = await import('esbuild');
+    const testDir = path.dirname(testFilePath);
+    const testFileName = path.basename(testFilePath);
+    // Node path: no compiler, no bridge. Just bundle TS → JS.
+    const plugin = {
+        name: 'pw-node',
+        setup(build) {
+            build.onResolve({ filter: /^__entry__$/ }, () => ({ path: '__entry__', namespace: 'entry' }));
+            build.onLoad({ filter: /.*/, namespace: 'entry' }, () => ({
+                contents: `import './${testFileName}';`,
+                resolveDir: testDir,
+                loader: 'ts',
+            }));
+        },
+    };
+    const result = await esbuild.build({
+        entryPoints: ['__entry__'],
+        bundle: true, write: false, format: 'esm', platform: 'node',
+        plugins: [plugin],
+        alias: { '@playwright/test': getAliasPath() },
+        external: [
+            'fs', 'path', 'child_process', 'os', 'crypto', 'util',
+            'stream', 'events', 'net', 'http', 'https', 'url',
+            'worker_threads', 'node:*',
+        ],
+    });
+    return result.outputFiles[0].text;
+}
+// ─── Detection ─────────────────────────────────────────────────────────────
+const NODE_MODULES = new Set([
+    'fs', 'path', 'child_process', 'os', 'crypto', 'util',
+    'stream', 'events', 'net', 'http', 'https', 'url',
+    'worker_threads',
+]);
+// Patterns that need Node.js path (context-level routing)
+const NODE_PATTERNS = [
+    /\.route\s*\(/, // page.route() with callbacks
+    /\.routeFromHAR\s*\(/, // file path access
+    /\.waitForEvent\s*\(/, // non-serializable return objects
+    /\bserver\b/, // server fixture (http.createServer in Node.js)
+];
+async function detectNodeAPIs(testFilePath) {
+    const esbuild = await import('esbuild');
+    const result = await esbuild.build({
+        entryPoints: [testFilePath],
+        bundle: true, write: false, metafile: true, format: 'esm', platform: 'node',
+        alias: { '@playwright/test': getAliasPath() },
+        external: [...NODE_MODULES, 'node:*'],
+    });
+    // Check if any Node.js modules were imported
+    for (const input of Object.values(result.metafile.inputs)) {
+        for (const imp of input.imports) {
+            const mod = imp.path.replace(/^node:/, '');
+            if (NODE_MODULES.has(mod))
+                return true;
+        }
+    }
+    // Check if test source uses patterns that need Node.js path
+    const src = fs.readFileSync(testFilePath, 'utf-8');
+    for (const pattern of NODE_PATTERNS) {
+        if (pattern.test(src))
+            return true;
+    }
+    return false;
+}
+// ─── Parse Results ─────────────────────────────────────────────────────────
+function parseResults(output, file) {
+    const results = [];
+    const lines = output.split('\n');
+    for (let i = 0; i < lines.length; i++) {
+        const passMatch = lines[i].match(/^\s*[✓✔]\s+(.+?)\s+\((\d+)ms\)/);
+        if (passMatch) {
+            results.push({ name: passMatch[1], file, passed: true, skipped: false, duration: parseInt(passMatch[2]) });
+            continue;
+        }
+        const failMatch = lines[i].match(/^\s*[✗✘]\s+(.+?)\s+\((\d+)ms\)/);
+        if (failMatch) {
+            const error = lines[i + 1]?.trim() || 'Test failed';
+            results.push({ name: failMatch[1], file, passed: false, skipped: false, error, duration: parseInt(failMatch[2]) });
+            continue;
+        }
+        const skipMatch = lines[i].match(/^\s*-\s+(.+?)\s+\(skipped\)/);
+        if (skipMatch) {
+            results.push({ name: skipMatch[1], file, passed: true, skipped: true, duration: 0 });
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=execute.js.map

package/dist/execute.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { needsNode, compile, parseAllResults } from './bridge-utils.cjs';
+export type { TestResultEntry } from './bridge-utils.cjs';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACzE,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { needsNode, compile, parseAllResults } from './bridge-utils.cjs';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/mode-detect.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Mode Detection
+ *
+ * Determines test execution mode by analyzing the full dependency tree via esbuild:
+ * - 'browser': pure browser test → run in browser via shim (fastest, 0ms overhead)
+ * - 'compiler': uses Node.js APIs → run in Node.js, page/expect → bridge (~2ms per call)
+ *
+ * Uses esbuild's metafile to check ALL resolved imports (not just the test file),
+ * so Node.js usage in helpers/utilities is detected correctly.
+ *
+ * Detection is per-file. If any dependency uses Node.js APIs, the entire file
+ * uses compiler mode.
+ */
+export type TestMode = 'browser' | 'compiler';
+/**
+ * Detect test mode by attempting an esbuild bundle with platform: 'browser'.
+ * If esbuild encounters Node.js built-in imports, they'll appear as externals
+ * in the metafile — indicating the test needs Node.js.
+ */
+export declare function detectTestMode(testFilePath: string): Promise<TestMode>;
+//# sourceMappingURL=mode-detect.d.ts.map

package/dist/mode-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-detect.d.ts","sourceRoot":"","sources":["../src/mode-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAC;AAE9C;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuC5E"}

package/dist/mode-detect.js

@@ -0,0 +1,67 @@
+/**
+ * Mode Detection
+ *
+ * Determines test execution mode by analyzing the full dependency tree via esbuild:
+ * - 'browser': pure browser test → run in browser via shim (fastest, 0ms overhead)
+ * - 'compiler': uses Node.js APIs → run in Node.js, page/expect → bridge (~2ms per call)
+ *
+ * Uses esbuild's metafile to check ALL resolved imports (not just the test file),
+ * so Node.js usage in helpers/utilities is detected correctly.
+ *
+ * Detection is per-file. If any dependency uses Node.js APIs, the entire file
+ * uses compiler mode.
+ */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __filename = fileURLToPath(import.meta.url);
+const NODE_BUILTINS = new Set([
+    'fs', 'path', 'child_process', 'os', 'crypto', 'util',
+    'stream', 'events', 'net', 'http', 'https', 'url',
+    'worker_threads', 'cluster', 'dgram', 'dns', 'tls',
+    'readline', 'zlib', 'buffer', 'assert', 'vm', 'perf_hooks',
+    'async_hooks', 'string_decoder', 'querystring', 'punycode',
+]);
+/**
+ * Detect test mode by attempting an esbuild bundle with platform: 'browser'.
+ * If esbuild encounters Node.js built-in imports, they'll appear as externals
+ * in the metafile — indicating the test needs Node.js.
+ */
+export async function detectTestMode(testFilePath) {
+    const esbuild = await import('esbuild');
+    const shimPath = path.resolve(path.dirname(__filename), '../src/shim/test-runner.ts');
+    try {
+        const result = await esbuild.build({
+            entryPoints: [testFilePath],
+            bundle: true,
+            write: false,
+            format: 'iife',
+            platform: 'browser',
+            metafile: true,
+            alias: { '@playwright/test': shimPath },
+            // Mark Node.js built-ins as external — if they appear in metafile, test needs Node.js
+            external: [...NODE_BUILTINS].flatMap(m => [m, `node:${m}`]),
+            logLevel: 'silent',
+        });
+        // Check if any resolved import is a Node.js built-in
+        for (const inputPath of Object.keys(result.metafile.inputs)) {
+            // esbuild marks externals with a prefix like <define:fs> or the bare module name
+            for (const imp of result.metafile.inputs[inputPath].imports) {
+                const modName = imp.path.replace(/^node:/, '');
+                if (NODE_BUILTINS.has(modName))
+                    return 'compiler';
+            }
+        }
+        // Also check the source for process.env / __dirname (not import-based)
+        const fs = await import('fs');
+        const source = fs.default.readFileSync(testFilePath, 'utf-8');
+        if (/process\.env\b|process\.cwd\b|process\.argv\b|__dirname\b|__filename\b/.test(source)) {
+            return 'compiler';
+        }
+        return 'browser';
+    }
+    catch {
+        // If esbuild fails, fall back to compiler mode (safer)
+        return 'compiler';
+    }
+}
+//# sourceMappingURL=mode-detect.js.map

package/dist/mode-detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mode-detect.js","sourceRoot":"","sources":["../src/mode-detect.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAElD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC;IAC5B,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM;IACrD,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK;IACjD,gBAAgB,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;IAClD,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY;IAC1D,aAAa,EAAE,gBAAgB,EAAE,aAAa,EAAE,UAAU;CAC3D,CAAC,CAAC;AAIH;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,YAAoB;IACvD,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,4BAA4B,CAAC,CAAC;IAEtF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC;YACjC,WAAW,EAAE,CAAC,YAAY,CAAC;YAC3B,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,KAAK;YACZ,MAAM,EAAE,MAAM;YACd,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,IAAI;YACd,KAAK,EAAE,EAAE,kBAAkB,EAAE,QAAQ,EAAE;YACvC,sFAAsF;YACtF,QAAQ,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC3D,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;QAEH,qDAAqD;QACrD,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,QAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7D,iFAAiF;YACjF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;gBAC/C,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,OAAO,UAAU,CAAC;YACpD,CAAC;QACH,CAAC;QAED,uEAAuE;QACvE,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC9D,IAAI,wEAAwE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1F,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,uDAAuD;QACvD,OAAO,UAAU,CAAC;IACpB,CAAC;AACH,CAAC"}

package/dist/proxy-page.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Proxy Page
+ *
+ * Creates a Proxy that looks like Playwright's Page object.
+ * Records method calls as a string chain. Nothing executes until `await`.
+ * `await` triggers `then()` which sends the chain to the bridge.
+ *
+ * Rules:
+ *   page.* → Proxy (builds chain string)
+ *   await page.* → bridge.run(chain) → executes in browser
+ *   expect(proxy) → builds expect chain → bridge.run on await
+ *   expect(value) → native assertion in Node.js
+ */
+type BridgeRun = (command: string) => Promise<{
+    text?: string;
+    isError?: boolean;
+}>;
+declare const PROXY_FLAG: unique symbol;
+declare const CHAIN_KEY: unique symbol;
+/**
+ * Create a proxy page that routes most calls through the bridge.
+ * Methods in NODE_PAGE_METHODS delegate to the real Node page (CDP) instead.
+ */
+export declare function createPageProxy(bridge: BridgeRun, nodePage?: any, cdpPage?: any): any;
+/**
+ * Create a smart expect function.
+ * - expect(proxy) → bridge (async Playwright assertions)
+ * - expect(value) → native Node.js assertion
+ */
+export declare function createExpect(bridge: BridgeRun): (target: any) => any;
+export { PROXY_FLAG, CHAIN_KEY };
+//# sourceMappingURL=proxy-page.d.ts.map

package/dist/proxy-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-page.d.ts","sourceRoot":"","sources":["../src/proxy-page.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,KAAK,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAYpF,QAAA,MAAM,UAAU,eAAoB,CAAC;AACrC,QAAA,MAAM,SAAS,eAAkB,CAAC;AA0HlC;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,GAAG,CAErF;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,IAepC,QAAQ,GAAG,SAQpB;AAED,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC"}

package/dist/proxy-page.js

@@ -0,0 +1,192 @@
+/**
+ * Proxy Page
+ *
+ * Creates a Proxy that looks like Playwright's Page object.
+ * Records method calls as a string chain. Nothing executes until `await`.
+ * `await` triggers `then()` which sends the chain to the bridge.
+ *
+ * Rules:
+ *   page.* → Proxy (builds chain string)
+ *   await page.* → bridge.run(chain) → executes in browser
+ *   expect(proxy) → builds expect chain → bridge.run on await
+ *   expect(value) → native assertion in Node.js
+ */
+const BRIDGE_TIMEOUT = 30000;
+const BRIDGE_DEBUG = !!process.env.PW_DEBUG;
+function withTimeout(promise, ms, label) {
+    let timer;
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => { timer = setTimeout(() => reject(new Error(`Timeout ${ms}ms: ${label}`)), ms); }),
+    ]).finally(() => clearTimeout(timer));
+}
+const PROXY_FLAG = Symbol('isProxy');
+const CHAIN_KEY = Symbol('chain');
+// Methods delegated to Node.js context (context-level routing).
+const CONTEXT_METHODS = new Set([
+    'route', 'unroute', 'routeFromHAR', 'unrouteAll',
+]);
+// Methods delegated to Node page (same tab, returns non-serializable objects or needs concurrency).
+const CDP_PAGE_METHODS = new Set([
+    'waitForEvent',
+    '$', '$$', '$eval', '$$eval',
+    'frames', 'mainFrame',
+    'evaluate', // needs concurrency with pending bridge actions
+    'evaluateHandle', // returns JSHandle — non-serializable
+    'on', 'off', 'once', // event listeners need real page
+]);
+function makeProxy(chain, bridge, nodePage, cdpPage) {
+    const handler = {
+        get(_target, prop) {
+            // Internal: check if this is a proxy
+            if (prop === PROXY_FLAG)
+                return true;
+            if (prop === CHAIN_KEY)
+                return chain;
+            // await triggers execution
+            if (prop === 'then') {
+                return (resolve, reject) => {
+                    const cmd = `await ${chain}`;
+                    if (BRIDGE_DEBUG)
+                        console.log(`    [bridge →] ${cmd.substring(0, 120)}`);
+                    withTimeout(bridge(cmd), BRIDGE_TIMEOUT, chain).then(r => {
+                        if (BRIDGE_DEBUG)
+                            console.log(`    [bridge ←] ${r.isError ? 'ERR' : 'OK'} ${(r.text || '').substring(0, 80)}`);
+                        if (r.isError)
+                            reject(new Error(r.text || 'Bridge error'));
+                        else {
+                            const text = r.text;
+                            if (text === undefined || text === '')
+                                resolve(undefined);
+                            else {
+                                try {
+                                    resolve(JSON.parse(text));
+                                }
+                                catch {
+                                    resolve(text);
+                                }
+                            }
+                        }
+                    }).catch(reject);
+                };
+            }
+            // Symbol.toPrimitive — for string concatenation etc.
+            if (prop === Symbol.toPrimitive) {
+                return () => chain;
+            }
+            // Context methods — delegate to Node.js context (route/unroute).
+            if (nodePage && chain === 'page' && CONTEXT_METHODS.has(String(prop))) {
+                return (...args) => nodePage[String(prop)](...args);
+            }
+            // CDP page methods — delegate to real page via CDP (waitForEvent).
+            if (cdpPage && chain === 'page' && CDP_PAGE_METHODS.has(String(prop))) {
+                return (...args) => cdpPage[String(prop)](...args);
+            }
+            // Property access → extend chain (returns callable proxy)
+            return makeCallableProxy(`${chain}.${String(prop)}`, bridge, nodePage, cdpPage);
+        },
+    };
+    return new Proxy({}, handler);
+}
+function makeCallableProxy(chain, bridge, nodePage, cdpPage) {
+    // A proxy that can be both called as a function AND have properties accessed
+    const fn = function () { };
+    return new Proxy(fn, {
+        get(_target, prop) {
+            if (prop === PROXY_FLAG)
+                return true;
+            if (prop === CHAIN_KEY)
+                return chain;
+            if (prop === 'then') {
+                return (resolve, reject) => {
+                    withTimeout(bridge(`await ${chain}`), BRIDGE_TIMEOUT, chain).then(r => {
+                        if (r.isError)
+                            reject(new Error(r.text || 'Bridge error'));
+                        else {
+                            const text = r.text;
+                            if (text === undefined || text === '')
+                                resolve(undefined);
+                            else {
+                                try {
+                                    resolve(JSON.parse(text));
+                                }
+                                catch {
+                                    resolve(text);
+                                }
+                            }
+                        }
+                    }).catch(reject);
+                };
+            }
+            if (prop === Symbol.toPrimitive) {
+                return () => chain;
+            }
+            return makeCallableProxy(`${chain}.${String(prop)}`, bridge, nodePage, cdpPage);
+        },
+        apply(_target, _thisArg, args) {
+            const argsStr = args.map(serializeArg).join(', ');
+            return makeProxy(`${chain}(${argsStr})`, bridge, nodePage, cdpPage);
+        },
+    });
+}
+function serializeArg(arg) {
+    // Proxy argument → use its chain
+    if (arg && typeof arg === 'object' && arg[PROXY_FLAG]) {
+        return arg[CHAIN_KEY];
+    }
+    // RegExp → serialize as regex literal
+    if (arg instanceof RegExp) {
+        return arg.toString();
+    }
+    // Function → serialize as string
+    if (typeof arg === 'function') {
+        return arg.toString();
+    }
+    // Everything else → JSON
+    return JSON.stringify(arg);
+}
+/**
+ * Create a proxy page that routes most calls through the bridge.
+ * Methods in NODE_PAGE_METHODS delegate to the real Node page (CDP) instead.
+ */
+export function createPageProxy(bridge, nodePage, cdpPage) {
+    return makeProxy('page', bridge, nodePage, cdpPage);
+}
+/**
+ * Create a smart expect function.
+ * - expect(proxy) → bridge (async Playwright assertions)
+ * - expect(value) → native Node.js assertion
+ */
+export function createExpect(bridge) {
+    // Simple native expect for non-proxy values
+    const nativeExpect = (actual) => ({
+        toBe: (expected) => { if (actual !== expected)
+            throw new Error(`Expected ${JSON.stringify(expected)} but got ${JSON.stringify(actual)}`); },
+        toEqual: (expected) => { if (JSON.stringify(actual) !== JSON.stringify(expected))
+            throw new Error(`Expected ${JSON.stringify(expected)} but got ${JSON.stringify(actual)}`); },
+        toBeTruthy: () => { if (!actual)
+            throw new Error(`Expected truthy but got ${JSON.stringify(actual)}`); },
+        toBeFalsy: () => { if (actual)
+            throw new Error(`Expected falsy but got ${JSON.stringify(actual)}`); },
+        toContain: (expected) => { if (!String(actual).includes(expected))
+            throw new Error(`Expected to contain ${JSON.stringify(expected)}`); },
+        toMatch: (pattern) => { if (!pattern.test(String(actual)))
+            throw new Error(`Expected to match ${pattern}`); },
+        not: {
+            toBe: (expected) => { if (actual === expected)
+                throw new Error(`Expected not ${JSON.stringify(expected)}`); },
+            toContain: (expected) => { if (String(actual).includes(expected))
+                throw new Error(`Expected not to contain ${JSON.stringify(expected)}`); },
+        },
+    });
+    return (target) => {
+        if (target && target[PROXY_FLAG]) {
+            // Proxy → route to bridge
+            return makeCallableProxy(`expect(${target[CHAIN_KEY]})`, bridge);
+        }
+        // Regular value → native assertion
+        return nativeExpect(target);
+    };
+}
+export { PROXY_FLAG, CHAIN_KEY };
+//# sourceMappingURL=proxy-page.js.map