@rushstack/playwright-browser-tunnel 0.2.4 → 0.3.1

package/lib-esm/PlaywrightBrowserTunnel.js

@@ -0,0 +1,467 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { once } from 'node:events';
+import { WebSocket } from 'ws';
+import semver from 'semver';
+import { TerminalProviderSeverity, TerminalStreamWritable } from '@rushstack/terminal';
+import { Executable, FileSystem, Async } from '@rushstack/node-core-library';
+import { getNormalizedErrorString, getWebSocketCloseReason, getWebSocketReadyStateString, WebSocketCloseCode } from './utilities';
+import { LaunchOptionsValidator } from './LaunchOptionsValidator';
+const validBrowserNames = new Set(['chromium', 'firefox', 'webkit']);
+function isValidBrowserName(browserName) {
+    return validBrowserNames.has(browserName);
+}
+/**
+ * Hosts a Playwright browser server and forwards traffic over a WebSocket tunnel.
+ * @beta
+ */
+export class PlaywrightTunnel {
+    constructor(options) {
+        this._playwrightBrowsersInstalled = new Set();
+        this._status = 'stopped';
+        this._keepRunning = false;
+        const { mode, terminal, onStatusChange, playwrightInstallPath, onBeforeLaunch } = options;
+        switch (mode) {
+            case 'poll-connection':
+                if (!options.wsEndpoint) {
+                    throw new Error('wsEndpoint is required for poll-connection mode');
+                }
+                this._wsEndpoint = options.wsEndpoint;
+                this._listenPort = undefined;
+                break;
+            case 'wait-for-incoming-connection':
+                if (options.listenPort === undefined) {
+                    throw new Error('listenPort is required for wait-for-incoming-connection mode');
+                }
+                this._wsEndpoint = undefined;
+                this._listenPort = options.listenPort;
+                break;
+            default:
+                throw new Error(`Invalid mode: ${mode}`);
+        }
+        this._mode = mode;
+        this._terminal = terminal;
+        this._onStatusChange = onStatusChange;
+        this._onBeforeLaunch = onBeforeLaunch;
+        this._playwrightInstallPath = playwrightInstallPath;
+    }
+    get status() {
+        return this._status;
+    }
+    // eslint-disable-next-line @typescript-eslint/naming-convention
+    set status(newStatus) {
+        this._status = newStatus;
+        this._onStatusChange(newStatus);
+    }
+    async waitForCloseAsync() {
+        const terminal = this._terminal;
+        const initWsPromise = this._initWsPromise;
+        if (initWsPromise) {
+            const ws = await initWsPromise;
+            await once(ws, 'close');
+            terminal.writeDebugLine('WebSocket connection closed. resolving init promise.');
+            this._initWsPromise = undefined;
+        }
+    }
+    async startAsync(options = {}) {
+        var _a;
+        this._keepRunning = (_a = options.keepRunning) !== null && _a !== void 0 ? _a : true;
+        const terminal = this._terminal;
+        terminal.writeLine(`keepRunning: ${this._keepRunning}`);
+        while (this._keepRunning) {
+            if (!this._initWsPromise) {
+                this._initWsPromise = this._initPlaywrightBrowserTunnelAsync();
+            }
+            else {
+                terminal.writeLine(`Tunnel is already running with status: ${this.status}`);
+            }
+            await this.waitForCloseAsync();
+        }
+    }
+    async stopAsync() {
+        var _a;
+        this._keepRunning = false;
+        if (this._pollInterval) {
+            clearInterval(this._pollInterval);
+            this._pollInterval = undefined;
+        }
+        await ((_a = this._initWsPromise) === null || _a === void 0 ? void 0 : _a.finally(() => {
+            var _a;
+            (_a = this._ws) === null || _a === void 0 ? void 0 : _a.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Tunnel stopped');
+        }));
+    }
+    async [Symbol.asyncDispose]() {
+        this._terminal.writeLine('Disposing WebSocket connection.');
+        await this.stopAsync();
+    }
+    async cleanTempFilesAsync() {
+        const tmpPath = this._playwrightInstallPath;
+        this._terminal.writeLine(`Cleaning up temporary files in ${tmpPath}`);
+        try {
+            await FileSystem.ensureEmptyFolderAsync(tmpPath);
+            this._terminal.writeLine(`Temporary files cleaned up.`);
+        }
+        catch (error) {
+            this._terminal.writeLine(`Failed to clean up temporary files: ${getNormalizedErrorString(error)}`);
+        }
+    }
+    // TODO: We should implement an uninstall command to remove installed Playwright browsers
+    // public async uninstallPlaywrightBrowsersAsync(): Promise<void> {}
+    async _runCommandAsync(command, args) {
+        var _a, _b;
+        const tmpPath = this._playwrightInstallPath;
+        await FileSystem.ensureFolderAsync(tmpPath);
+        this._terminal.writeLine(`Running command: ${command} ${args.join(' ')} in ${tmpPath}`);
+        const cp = Executable.spawn(command, args, {
+            stdio: [
+                'ignore', // stdin
+                'pipe', // stdout
+                'pipe' // stderr
+            ],
+            currentWorkingDirectory: tmpPath
+        });
+        (_a = cp.stdout) === null || _a === void 0 ? void 0 : _a.pipe(new TerminalStreamWritable({
+            terminal: this._terminal,
+            severity: TerminalProviderSeverity.log
+        }));
+        (_b = cp.stderr) === null || _b === void 0 ? void 0 : _b.pipe(new TerminalStreamWritable({
+            terminal: this._terminal,
+            severity: TerminalProviderSeverity.error
+        }));
+        await Executable.waitForExitAsync(cp, { throwOnNonZeroExitCode: true, throwOnSignal: true });
+    }
+    async _installPlaywrightCoreAsync({ playwrightVersion }) {
+        this._terminal.writeLine(`Installing playwright-core version ${playwrightVersion}`);
+        await this._runCommandAsync('npm', [
+            'install',
+            `playwright-core-${playwrightVersion}@npm:playwright-core@${playwrightVersion}`
+        ]);
+    }
+    async _installPlaywrightBrowsersAsync({ playwrightVersion, browserName }) {
+        await this._installPlaywrightCoreAsync({ playwrightVersion });
+        this._terminal.writeLine(`Executing playwright-core version ${playwrightVersion}`);
+        await this._runCommandAsync('node', [
+            `node_modules/playwright-core-${playwrightVersion}/cli.js`,
+            'install',
+            browserName
+        ]);
+    }
+    async _tryConnectAsync() {
+        const wsEndpoint = this._wsEndpoint;
+        if (!wsEndpoint) {
+            throw new Error('WebSocket endpoint is not defined');
+        }
+        return await new Promise((resolve, reject) => {
+            const ws = new WebSocket(wsEndpoint);
+            ws.on('open', () => {
+                this._terminal.writeLine(`WebSocket connection opened`);
+                resolve(ws);
+            });
+            ws.once('error', (error) => {
+                reject(error);
+            });
+        });
+    }
+    // TODO: Only supporting one test at a time.
+    // Need to support multiple simultaneous connections for parallel tests.
+    async _pollConnectionAsync() {
+        this._terminal.writeLine(`Waiting for WebSocket connection`);
+        return await new Promise((resolve, reject) => {
+            this._pollInterval = setInterval(() => {
+                if (this._pendingConnectionAttempt) {
+                    return; // Skip if a connection attempt is already in progress
+                }
+                const connectionPromise = this._tryConnectAsync();
+                this._pendingConnectionAttempt = connectionPromise;
+                connectionPromise
+                    .then((ws) => {
+                    clearInterval(this._pollInterval);
+                    this._pollInterval = undefined;
+                    ws.removeAllListeners();
+                    this._pendingConnectionAttempt = undefined;
+                    resolve(ws);
+                })
+                    .catch(() => {
+                    // no-op - will retry on next interval
+                    this._pendingConnectionAttempt = undefined;
+                });
+            }, 500);
+        });
+    }
+    async _waitForIncomingConnectionAsync() {
+        this._terminal.writeLine('Waiting for incoming WebSocket connection');
+        return await new Promise((resolve, reject) => {
+            const server = new WebSocket.Server({ port: this._listenPort });
+            const cleanup = () => {
+                server.removeAllListeners();
+            };
+            server.once('connection', (ws) => {
+                this._terminal.writeLine('Incoming WebSocket connection established');
+                // Stop listening immediately so the port is released
+                cleanup();
+                server.close((closeError) => {
+                    if (closeError) {
+                        this._terminal.writeLine(`Failed to close WebSocket server: ${closeError instanceof Error ? closeError.message : closeError}`);
+                    }
+                    resolve(ws);
+                });
+            });
+            server.once('error', (error) => {
+                this._terminal.writeLine(`WebSocket server error: ${getNormalizedErrorString(error)}`);
+                cleanup();
+                // Try to close (best-effort), then reject
+                server.close(() => reject(error));
+            });
+        });
+    }
+    // TODO: If a user runs this for the first time, `this._playwrightBrowsersInstalled` will be empty
+    // and it will try to install the browsers every time. We should persist this information. Maybe a cache file with text per
+    // machine instance?
+    async _setupPlaywrightAsync({ playwrightVersion, browserName }) {
+        const browserKey = `${playwrightVersion}-${browserName}`;
+        this._terminal.writeLine(`Checking for installed playwright browsers. Installed browsers: ${browserKey}`);
+        if (!this._playwrightBrowsersInstalled.has(browserKey)) {
+            this._terminal.writeLine(`Playwright browser not found. Installing playwright-core version ${playwrightVersion}`);
+            await this._installPlaywrightBrowsersAsync({ playwrightVersion, browserName });
+            this._playwrightBrowsersInstalled.add(browserKey);
+        }
+        this._terminal.writeLine(`Using playwright-core version ${playwrightVersion} for browser server`);
+        return await import(`${this._playwrightInstallPath}/node_modules/playwright-core-${playwrightVersion}`);
+    }
+    async _getPlaywrightBrowserServerProxyAsync({ browserName, playwrightVersion, launchOptions }) {
+        const terminal = this._terminal;
+        // Validate launch options against security allowlist
+        terminal.writeLine('Validating launch options against security allowlist...');
+        const validationResult = await LaunchOptionsValidator.validateLaunchOptionsAsync(launchOptions, terminal);
+        if (!validationResult.isValid) {
+            terminal.writeWarningLine(`Some launch options were denied: ${validationResult.deniedOptions.join(', ')}`);
+            terminal.writeWarningLine(`Using filtered launch options. Denied options have been removed.`);
+        }
+        // Use filtered options and ensure headless: false for headed tests in codespaces
+        // This is critical for the extension's purpose - enabling headed Playwright tests remotely
+        const safeOptions = {
+            ...validationResult.filteredOptions,
+            headless: false
+        };
+        // Log the validated options, excluding 'headless' since it's always false for this extension
+        // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        const { headless, ...logOptions } = safeOptions;
+        terminal.writeLine(`Launch options after validation: ${JSON.stringify(logOptions)} (headless: false enforced)`);
+        const playwright = await this._setupPlaywrightAsync({
+            playwrightVersion,
+            browserName
+        });
+        const { chromium, firefox, webkit } = playwright;
+        const browsers = { chromium, firefox, webkit };
+        const browserServer = await browsers[browserName].launchServer(safeOptions);
+        if (!browserServer) {
+            throw new Error(`Failed to launch browser server for ${browserName} with options: ${JSON.stringify(safeOptions)}`);
+        }
+        terminal.writeLine(`Launched ${browserName} browser server`);
+        const client = new WebSocket(browserServer.wsEndpoint());
+        return {
+            browserServer,
+            client
+        };
+    }
+    _validateHandshake(rawHandshake) {
+        if (typeof rawHandshake !== 'object' ||
+            rawHandshake === null ||
+            'action' in rawHandshake === false ||
+            'browserName' in rawHandshake === false ||
+            'playwrightVersion' in rawHandshake === false ||
+            'launchOptions' in rawHandshake === false ||
+            typeof rawHandshake.action !== 'string' ||
+            typeof rawHandshake.browserName !== 'string' ||
+            typeof rawHandshake.playwrightVersion !== 'string' ||
+            typeof rawHandshake.launchOptions !== 'object') {
+            throw new Error(`Invalid handshake: ${JSON.stringify(rawHandshake)}. Must be an object.`);
+        }
+        const { action, browserName, playwrightVersion, launchOptions } = rawHandshake;
+        if (action !== 'handshake') {
+            throw new Error(`Invalid action: ${action}. Expected 'handshake'.`);
+        }
+        const playwrightVersionSemver = semver.coerce(playwrightVersion);
+        if (!playwrightVersionSemver) {
+            throw new Error(`Invalid Playwright version: ${playwrightVersion}. Must be a valid semver version.`);
+        }
+        if (!isValidBrowserName(browserName)) {
+            throw new Error(`Invalid browser name: ${browserName}. Must be one of ${Array.from(validBrowserNames).join(', ')}.`);
+        }
+        return {
+            action,
+            launchOptions: launchOptions,
+            playwrightVersion: playwrightVersionSemver,
+            browserName
+        };
+    }
+    // ws1 is the tunnel websocket, ws2 is the browser server websocket
+    async _setupForwardingAsync(ws1, ws2) {
+        this._terminal.writeLine('Setting up message forwarding between ws1 and ws2');
+        this._terminal.writeLine(`  ws1 (tunnel) readyState: ${getWebSocketReadyStateString(ws1.readyState)}`);
+        this._terminal.writeLine(`  ws2 (browser) readyState: ${getWebSocketReadyStateString(ws2.readyState)}`);
+        const messageCount = { ws1ToWs2: 0, ws2ToWs1: 0 };
+        ws1.on('message', (data) => {
+            messageCount.ws1ToWs2++;
+            if (ws2.readyState === WebSocket.OPEN) {
+                ws2.send(data);
+            }
+            else {
+                this._terminal.writeLine(`ws2 not open (state: ${getWebSocketReadyStateString(ws2.readyState)}). Dropping message #${messageCount.ws1ToWs2}`);
+            }
+        });
+        ws2.on('message', (data) => {
+            messageCount.ws2ToWs1++;
+            if (ws1.readyState === WebSocket.OPEN) {
+                ws1.send(data);
+            }
+            else {
+                this._terminal.writeLine(`ws1 not open (state: ${getWebSocketReadyStateString(ws1.readyState)}). Dropping message #${messageCount.ws2ToWs1}`);
+            }
+        });
+        ws1.once('close', (code, reason) => {
+            const reasonStr = reason.toString() || 'no reason provided';
+            const codeDescription = getWebSocketCloseReason(code);
+            this._terminal.writeLine(`ws1 (tunnel) closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`);
+            this._terminal.writeLine(`  Messages forwarded: ws1->ws2: ${messageCount.ws1ToWs2}, ws2->ws1: ${messageCount.ws2ToWs1}`);
+            if (ws2.readyState === WebSocket.OPEN) {
+                this._terminal.writeLine('  Closing ws2 (browser) in response');
+                ws2.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Tunnel closed');
+            }
+        });
+        ws2.once('close', (code, reason) => {
+            const reasonStr = reason.toString() || 'no reason provided';
+            const codeDescription = getWebSocketCloseReason(code);
+            this._terminal.writeLine(`ws2 (browser) closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`);
+            this._terminal.writeLine(`  Messages forwarded: ws1->ws2: ${messageCount.ws1ToWs2}, ws2->ws1: ${messageCount.ws2ToWs1}`);
+            if (ws1.readyState === WebSocket.OPEN) {
+                this._terminal.writeLine('  Closing ws1 (tunnel) in response');
+                ws1.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Browser closed');
+            }
+        });
+        ws1.once('error', (error) => {
+            this._terminal.writeErrorLine(`ws1 (tunnel) WebSocket error: ${getNormalizedErrorString(error)}`);
+            this._terminal.writeErrorLine(`  ws1 readyState: ${getWebSocketReadyStateString(ws1.readyState)}`);
+        });
+        ws2.once('error', (error) => {
+            this._terminal.writeErrorLine(`ws2 (browser) WebSocket error: ${getNormalizedErrorString(error)}`);
+            this._terminal.writeErrorLine(`  ws2 readyState: ${getWebSocketReadyStateString(ws2.readyState)}`);
+        });
+    }
+    /**
+     * Initializes the Playwright browser tunnel by establishing a WebSocket connection
+     * and setting up the browser server.
+     * Returns when the handshake is complete and the browser server is running.
+     */
+    async _initPlaywrightBrowserTunnelAsync() {
+        let handshake = undefined;
+        let client = undefined;
+        let browserServer = undefined;
+        this.status = 'waiting-for-connection';
+        const ws = this._mode === 'poll-connection'
+            ? await this._pollConnectionAsync()
+            : await this._waitForIncomingConnectionAsync();
+        ws.on('open', () => {
+            this._terminal.writeLine(`WebSocket connection established`);
+            handshake = undefined;
+        });
+        ws.on('error', (error) => {
+            this._terminal.writeLine(`WebSocket error occurred: ${getNormalizedErrorString(error)}`);
+        });
+        ws.on('close', async (code, reason) => {
+            const reasonStr = reason.toString() || 'no reason provided';
+            const codeDescription = getWebSocketCloseReason(code);
+            this._initWsPromise = undefined;
+            this.status = 'stopped';
+            this._terminal.writeLine(`WebSocket connection closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`);
+            this._terminal.writeLine(`  handshake received: ${handshake !== undefined}`);
+            this._terminal.writeLine(`  browserServer active: ${browserServer !== undefined}`);
+            if (browserServer) {
+                this._terminal.writeLine('  Closing browser server...');
+                await browserServer.close();
+                this._terminal.writeLine('  Browser server closed');
+            }
+        });
+        return await new Promise((resolve, reject) => {
+            const onMessageHandler = async (data) => {
+                const terminal = this._terminal;
+                if (!handshake) {
+                    try {
+                        const rawHandshakeString = data.toString();
+                        const rawHandshake = JSON.parse(rawHandshakeString);
+                        terminal.writeLine(`Received handshake: ${rawHandshakeString}`);
+                        handshake = this._validateHandshake(rawHandshake);
+                        // Call the onBeforeLaunch callback if provided
+                        if (this._onBeforeLaunch) {
+                            terminal.writeLine('Requesting user approval before launching browser server...');
+                            const shouldProceed = await this._onBeforeLaunch(handshake);
+                            if (!shouldProceed) {
+                                terminal.writeLine('Browser server launch cancelled by user.');
+                                ws.off('message', onMessageHandler);
+                                ws.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Launch cancelled by user');
+                                reject(new Error('Browser server launch cancelled by user'));
+                                return;
+                            }
+                            terminal.writeLine('User approved browser server launch.');
+                        }
+                        this.status = 'setting-up-browser-server';
+                        const browserServerProxy = await this._getPlaywrightBrowserServerProxyAsync(handshake);
+                        client = browserServerProxy.client;
+                        browserServer = browserServerProxy.browserServer;
+                        // Monitor browser server process for crashes
+                        const browserProcess = browserServer.process();
+                        if (browserProcess) {
+                            browserProcess.on('exit', (code, signal) => {
+                                terminal.writeErrorLine(`Browser server process exited - code: ${code}, signal: ${signal}`);
+                            });
+                            browserProcess.on('error', (err) => {
+                                terminal.writeErrorLine(`Browser server process error: ${getNormalizedErrorString(err)}`);
+                            });
+                            terminal.writeDebugLine(`Browser server process started with PID: ${browserProcess.pid}`);
+                        }
+                        else {
+                            terminal.writeDebugLine('Warning: Browser server process handle not available for monitoring');
+                        }
+                        this.status = 'browser-server-running';
+                        // Send ack so that the counterpart also knows to start forwarding messages.
+                        // NOTE: The 1-second delay is an intentional workaround. In the current
+                        // protocol, the remote tunnel endpoint does not expose an explicit "ready"
+                        // signal for when it has finished initializing its own forwarding logic
+                        // after receiving the initial handshake. This
+                        // delay avoids races where early messages could be dropped or mishandled
+                        // if they arrive before the remote side is fully ready.
+                        //
+                        // TODO: A future improvement would be to replace this delay with a deterministic
+                        // synchronization mechanism (e.g. an explicit "ready" message or event)
+                        // instead of relying on a fixed timeout.
+                        await Async.sleepAsync(2000);
+                        ws.send(JSON.stringify({ action: 'handshakeAck' }));
+                        await this._setupForwardingAsync(ws, client);
+                        // Clean up message handler after successful handshake
+                        ws.off('message', onMessageHandler);
+                        resolve(ws);
+                    }
+                    catch (error) {
+                        terminal.writeLine(`Error processing handshake: ${error}`);
+                        this.status = 'error';
+                        // Cleanup and close connection on error
+                        ws.off('message', onMessageHandler);
+                        ws.close(WebSocketCloseCode.INTERNAL_ERROR, 'Handshake error');
+                        reject(error);
+                        return;
+                    }
+                }
+                else {
+                    if (!client) {
+                        terminal.writeLine('Browser WebSocket client is not initialized.');
+                        ws.off('message', onMessageHandler);
+                        ws.close(WebSocketCloseCode.INTERNAL_ERROR, 'Browser client not initialized');
+                        return;
+                    }
+                }
+            };
+            ws.on('message', onMessageHandler);
+        });
+    }
+}
+//# sourceMappingURL=PlaywrightBrowserTunnel.js.map

package/lib-esm/PlaywrightBrowserTunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PlaywrightBrowserTunnel.js","sourceRoot":"","sources":["../src/PlaywrightBrowserTunnel.ts"],"names":[],"mappings":"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","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { ChildProcess } from 'node:child_process';\nimport { once } from 'node:events';\n\nimport type { BrowserServer, BrowserType, LaunchOptions } from 'playwright-core';\nimport { type RawData, WebSocket, type WebSocketServer } from 'ws';\nimport semver from 'semver';\n\nimport { TerminalProviderSeverity, TerminalStreamWritable, type ITerminal } from '@rushstack/terminal';\nimport { Executable, FileSystem, Async } from '@rushstack/node-core-library';\n\nimport {\n  getNormalizedErrorString,\n  getWebSocketCloseReason,\n  getWebSocketReadyStateString,\n  WebSocketCloseCode\n} from './utilities';\nimport { LaunchOptionsValidator, type ILaunchOptionsValidationResult } from './LaunchOptionsValidator';\n\n/**\n * Allowed Playwright browser names.\n * @beta\n */\nexport type BrowserName = 'chromium' | 'firefox' | 'webkit';\nconst validBrowserNames: Set<string> = new Set(['chromium', 'firefox', 'webkit'] satisfies BrowserName[]);\nfunction isValidBrowserName(browserName: string): browserName is BrowserName {\n  return validBrowserNames.has(browserName);\n}\n\n/**\n * Status values reported by {@link PlaywrightTunnel}.\n * @beta\n */\nexport type TunnelStatus =\n  | 'waiting-for-connection'\n  | 'browser-server-running'\n  | 'stopped'\n  | 'setting-up-browser-server'\n  | 'error';\n\n/**\n * Handshake data exchanged during the initial WebSocket connection.\n * @beta\n */\nexport interface IHandshake {\n  action: 'handshake';\n  browserName: BrowserName;\n  launchOptions: LaunchOptions;\n  playwrightVersion: semver.SemVer;\n}\n\ntype TunnelMode = 'poll-connection' | 'wait-for-incoming-connection';\n\n/**\n * Options for configuring a {@link PlaywrightTunnel} instance.\n * @beta\n */\nexport type IPlaywrightTunnelOptions = {\n  terminal: ITerminal;\n  onStatusChange: (status: TunnelStatus) => void;\n  playwrightInstallPath: string;\n  /**\n   * Optional callback invoked before launching the browser server.\n   * Receives the handshake data including launch options.\n   * If the callback returns false, the browser server launch will be aborted.\n   * This allows the client to prompt the user for approval before starting.\n   */\n  onBeforeLaunch?: (handshake: IHandshake) => Promise<boolean> | boolean;\n} & (\n  | {\n      mode: 'poll-connection';\n      wsEndpoint: string;\n    }\n  | {\n      mode: 'wait-for-incoming-connection';\n      listenPort: number;\n    }\n);\n\ninterface IBrowserServerProxy {\n  browserServer: BrowserServer;\n  client: WebSocket;\n}\n\n/**\n * Hosts a Playwright browser server and forwards traffic over a WebSocket tunnel.\n * @beta\n */\nexport class PlaywrightTunnel {\n  private readonly _terminal: ITerminal;\n  private readonly _onStatusChange: (status: TunnelStatus) => void;\n  private readonly _onBeforeLaunch?: (handshake: IHandshake) => Promise<boolean> | boolean;\n  private readonly _playwrightBrowsersInstalled: Set<string> = new Set();\n  private readonly _wsEndpoint: string | undefined;\n  private readonly _listenPort: number | undefined;\n  private readonly _playwrightInstallPath: string;\n  private _status: TunnelStatus = 'stopped';\n  private _initWsPromise?: Promise<WebSocket>;\n  private _keepRunning: boolean = false;\n  private _ws?: WebSocket;\n  private _mode: TunnelMode;\n  private _pendingConnectionAttempt?: Promise<WebSocket>;\n  private _pollInterval?: NodeJS.Timeout;\n\n  public constructor(options: IPlaywrightTunnelOptions) {\n    const { mode, terminal, onStatusChange, playwrightInstallPath, onBeforeLaunch } = options;\n\n    switch (mode) {\n      case 'poll-connection':\n        if (!options.wsEndpoint) {\n          throw new Error('wsEndpoint is required for poll-connection mode');\n        }\n        this._wsEndpoint = options.wsEndpoint;\n        this._listenPort = undefined;\n        break;\n      case 'wait-for-incoming-connection':\n        if (options.listenPort === undefined) {\n          throw new Error('listenPort is required for wait-for-incoming-connection mode');\n        }\n        this._wsEndpoint = undefined;\n        this._listenPort = options.listenPort;\n        break;\n      default:\n        throw new Error(`Invalid mode: ${mode}`);\n    }\n\n    this._mode = mode;\n    this._terminal = terminal;\n    this._onStatusChange = onStatusChange;\n    this._onBeforeLaunch = onBeforeLaunch;\n    this._playwrightInstallPath = playwrightInstallPath;\n  }\n\n  public get status(): TunnelStatus {\n    return this._status;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/naming-convention\n  private set status(newStatus: TunnelStatus) {\n    this._status = newStatus;\n    this._onStatusChange(newStatus);\n  }\n\n  public async waitForCloseAsync(): Promise<void> {\n    const terminal: ITerminal = this._terminal;\n    const initWsPromise: Promise<WebSocket> | undefined = this._initWsPromise;\n    if (initWsPromise) {\n      const ws: WebSocket = await initWsPromise;\n      await once(ws, 'close');\n      terminal.writeDebugLine('WebSocket connection closed. resolving init promise.');\n      this._initWsPromise = undefined;\n    }\n  }\n\n  public async startAsync(options: { keepRunning?: boolean } = {}): Promise<void> {\n    this._keepRunning = options.keepRunning ?? true;\n    const terminal: ITerminal = this._terminal;\n    terminal.writeLine(`keepRunning: ${this._keepRunning}`);\n    while (this._keepRunning) {\n      if (!this._initWsPromise) {\n        this._initWsPromise = this._initPlaywrightBrowserTunnelAsync();\n      } else {\n        terminal.writeLine(`Tunnel is already running with status: ${this.status}`);\n      }\n      await this.waitForCloseAsync();\n    }\n  }\n\n  public async stopAsync(): Promise<void> {\n    this._keepRunning = false;\n    if (this._pollInterval) {\n      clearInterval(this._pollInterval);\n      this._pollInterval = undefined;\n    }\n    await this._initWsPromise?.finally(() => {\n      this._ws?.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Tunnel stopped');\n    });\n  }\n\n  public async [Symbol.asyncDispose](): Promise<void> {\n    this._terminal.writeLine('Disposing WebSocket connection.');\n    await this.stopAsync();\n  }\n\n  public async cleanTempFilesAsync(): Promise<void> {\n    const tmpPath: string = this._playwrightInstallPath;\n    this._terminal.writeLine(`Cleaning up temporary files in ${tmpPath}`);\n    try {\n      await FileSystem.ensureEmptyFolderAsync(tmpPath);\n      this._terminal.writeLine(`Temporary files cleaned up.`);\n    } catch (error) {\n      this._terminal.writeLine(`Failed to clean up temporary files: ${getNormalizedErrorString(error)}`);\n    }\n  }\n\n  // TODO: We should implement an uninstall command to remove installed Playwright browsers\n  // public async uninstallPlaywrightBrowsersAsync(): Promise<void> {}\n\n  private async _runCommandAsync(command: string, args: string[]): Promise<void> {\n    const tmpPath: string = this._playwrightInstallPath;\n    await FileSystem.ensureFolderAsync(tmpPath);\n    this._terminal.writeLine(`Running command: ${command} ${args.join(' ')} in ${tmpPath}`);\n\n    const cp: ChildProcess = Executable.spawn(command, args, {\n      stdio: [\n        'ignore', // stdin\n        'pipe', // stdout\n        'pipe' // stderr\n      ],\n      currentWorkingDirectory: tmpPath\n    });\n\n    cp.stdout?.pipe(\n      new TerminalStreamWritable({\n        terminal: this._terminal,\n        severity: TerminalProviderSeverity.log\n      })\n    );\n    cp.stderr?.pipe(\n      new TerminalStreamWritable({\n        terminal: this._terminal,\n        severity: TerminalProviderSeverity.error\n      })\n    );\n\n    await Executable.waitForExitAsync(cp, { throwOnNonZeroExitCode: true, throwOnSignal: true });\n  }\n\n  private async _installPlaywrightCoreAsync({\n    playwrightVersion\n  }: Pick<IHandshake, 'playwrightVersion'>): Promise<void> {\n    this._terminal.writeLine(`Installing playwright-core version ${playwrightVersion}`);\n    await this._runCommandAsync('npm', [\n      'install',\n      `playwright-core-${playwrightVersion}@npm:playwright-core@${playwrightVersion}`\n    ]);\n  }\n\n  private async _installPlaywrightBrowsersAsync({\n    playwrightVersion,\n    browserName\n  }: Pick<IHandshake, 'playwrightVersion' | 'browserName'>): Promise<void> {\n    await this._installPlaywrightCoreAsync({ playwrightVersion });\n    this._terminal.writeLine(`Executing playwright-core version ${playwrightVersion}`);\n    await this._runCommandAsync('node', [\n      `node_modules/playwright-core-${playwrightVersion}/cli.js`,\n      'install',\n      browserName\n    ]);\n  }\n\n  private async _tryConnectAsync(): Promise<WebSocket> {\n    const wsEndpoint: string | undefined = this._wsEndpoint;\n    if (!wsEndpoint) {\n      throw new Error('WebSocket endpoint is not defined');\n    }\n    return await new Promise<WebSocket>((resolve, reject) => {\n      const ws: WebSocket = new WebSocket(wsEndpoint);\n      ws.on('open', () => {\n        this._terminal.writeLine(`WebSocket connection opened`);\n        resolve(ws);\n      });\n      ws.once('error', (error) => {\n        reject(error);\n      });\n    });\n  }\n\n  // TODO: Only supporting one test at a time.\n  // Need to support multiple simultaneous connections for parallel tests.\n  private async _pollConnectionAsync(): Promise<WebSocket> {\n    this._terminal.writeLine(`Waiting for WebSocket connection`);\n    return await new Promise((resolve, reject) => {\n      this._pollInterval = setInterval(() => {\n        if (this._pendingConnectionAttempt) {\n          return; // Skip if a connection attempt is already in progress\n        }\n        const connectionPromise: Promise<WebSocket> = this._tryConnectAsync();\n        this._pendingConnectionAttempt = connectionPromise;\n        connectionPromise\n          .then((ws: WebSocket) => {\n            clearInterval(this._pollInterval);\n            this._pollInterval = undefined;\n            ws.removeAllListeners();\n            this._pendingConnectionAttempt = undefined;\n            resolve(ws);\n          })\n          .catch(() => {\n            // no-op - will retry on next interval\n            this._pendingConnectionAttempt = undefined;\n          });\n      }, 500);\n    });\n  }\n\n  private async _waitForIncomingConnectionAsync(): Promise<WebSocket> {\n    this._terminal.writeLine('Waiting for incoming WebSocket connection');\n\n    return await new Promise<WebSocket>((resolve, reject) => {\n      const server: WebSocketServer = new WebSocket.Server({ port: this._listenPort });\n\n      const cleanup = (): void => {\n        server.removeAllListeners();\n      };\n\n      server.once('connection', (ws) => {\n        this._terminal.writeLine('Incoming WebSocket connection established');\n\n        // Stop listening immediately so the port is released\n        cleanup();\n        server.close((closeError?: Error) => {\n          if (closeError) {\n            this._terminal.writeLine(\n              `Failed to close WebSocket server: ${\n                closeError instanceof Error ? closeError.message : closeError\n              }`\n            );\n          }\n          resolve(ws);\n        });\n      });\n\n      server.once('error', (error) => {\n        this._terminal.writeLine(`WebSocket server error: ${getNormalizedErrorString(error)}`);\n\n        cleanup();\n        // Try to close (best-effort), then reject\n        server.close(() => reject(error));\n      });\n    });\n  }\n\n  // TODO: If a user runs this for the first time, `this._playwrightBrowsersInstalled` will be empty\n  // and it will try to install the browsers every time. We should persist this information. Maybe a cache file with text per\n  // machine instance?\n  private async _setupPlaywrightAsync({\n    playwrightVersion,\n    browserName\n  }: Pick<IHandshake, 'playwrightVersion' | 'browserName'>): Promise<typeof import('playwright-core')> {\n    const browserKey: string = `${playwrightVersion}-${browserName}`;\n    this._terminal.writeLine(`Checking for installed playwright browsers. Installed browsers: ${browserKey}`);\n    if (!this._playwrightBrowsersInstalled.has(browserKey)) {\n      this._terminal.writeLine(\n        `Playwright browser not found. Installing playwright-core version ${playwrightVersion}`\n      );\n      await this._installPlaywrightBrowsersAsync({ playwrightVersion, browserName });\n      this._playwrightBrowsersInstalled.add(browserKey);\n    }\n\n    this._terminal.writeLine(`Using playwright-core version ${playwrightVersion} for browser server`);\n    return await import(`${this._playwrightInstallPath}/node_modules/playwright-core-${playwrightVersion}`);\n  }\n\n  private async _getPlaywrightBrowserServerProxyAsync({\n    browserName,\n    playwrightVersion,\n    launchOptions\n  }: Pick<IHandshake, 'playwrightVersion' | 'browserName' | 'launchOptions'>): Promise<IBrowserServerProxy> {\n    const terminal: ITerminal = this._terminal;\n\n    // Validate launch options against security allowlist\n    terminal.writeLine('Validating launch options against security allowlist...');\n    const validationResult: ILaunchOptionsValidationResult =\n      await LaunchOptionsValidator.validateLaunchOptionsAsync(launchOptions, terminal);\n\n    if (!validationResult.isValid) {\n      terminal.writeWarningLine(\n        `Some launch options were denied: ${validationResult.deniedOptions.join(', ')}`\n      );\n      terminal.writeWarningLine(`Using filtered launch options. Denied options have been removed.`);\n    }\n\n    // Use filtered options and ensure headless: false for headed tests in codespaces\n    // This is critical for the extension's purpose - enabling headed Playwright tests remotely\n    const safeOptions: LaunchOptions = {\n      ...validationResult.filteredOptions,\n      headless: false\n    };\n\n    // Log the validated options, excluding 'headless' since it's always false for this extension\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n    const { headless, ...logOptions } = safeOptions;\n    terminal.writeLine(\n      `Launch options after validation: ${JSON.stringify(logOptions)} (headless: false enforced)`\n    );\n\n    const playwright: typeof import('playwright-core') = await this._setupPlaywrightAsync({\n      playwrightVersion,\n      browserName\n    });\n\n    const { chromium, firefox, webkit } = playwright;\n    const browsers: Record<BrowserName, BrowserType> = { chromium, firefox, webkit };\n\n    const browserServer: BrowserServer = await browsers[browserName].launchServer(safeOptions);\n\n    if (!browserServer) {\n      throw new Error(\n        `Failed to launch browser server for ${browserName} with options: ${JSON.stringify(safeOptions)}`\n      );\n    }\n\n    terminal.writeLine(`Launched ${browserName} browser server`);\n    const client: WebSocket = new WebSocket(browserServer.wsEndpoint());\n\n    return {\n      browserServer,\n      client\n    };\n  }\n\n  private _validateHandshake(rawHandshake: unknown): IHandshake {\n    if (\n      typeof rawHandshake !== 'object' ||\n      rawHandshake === null ||\n      'action' in rawHandshake === false ||\n      'browserName' in rawHandshake === false ||\n      'playwrightVersion' in rawHandshake === false ||\n      'launchOptions' in rawHandshake === false ||\n      typeof rawHandshake.action !== 'string' ||\n      typeof rawHandshake.browserName !== 'string' ||\n      typeof rawHandshake.playwrightVersion !== 'string' ||\n      typeof rawHandshake.launchOptions !== 'object'\n    ) {\n      throw new Error(`Invalid handshake: ${JSON.stringify(rawHandshake)}. Must be an object.`);\n    }\n\n    const { action, browserName, playwrightVersion, launchOptions } = rawHandshake;\n\n    if (action !== 'handshake') {\n      throw new Error(`Invalid action: ${action}. Expected 'handshake'.`);\n    }\n    const playwrightVersionSemver: semver.SemVer | null = semver.coerce(playwrightVersion);\n    if (!playwrightVersionSemver) {\n      throw new Error(`Invalid Playwright version: ${playwrightVersion}. Must be a valid semver version.`);\n    }\n    if (!isValidBrowserName(browserName)) {\n      throw new Error(\n        `Invalid browser name: ${browserName}. Must be one of ${Array.from(validBrowserNames).join(', ')}.`\n      );\n    }\n\n    return {\n      action,\n      launchOptions: launchOptions as LaunchOptions,\n      playwrightVersion: playwrightVersionSemver,\n      browserName\n    };\n  }\n\n  // ws1 is the tunnel websocket, ws2 is the browser server websocket\n  private async _setupForwardingAsync(ws1: WebSocket, ws2: WebSocket): Promise<void> {\n    this._terminal.writeLine('Setting up message forwarding between ws1 and ws2');\n    this._terminal.writeLine(`  ws1 (tunnel) readyState: ${getWebSocketReadyStateString(ws1.readyState)}`);\n    this._terminal.writeLine(`  ws2 (browser) readyState: ${getWebSocketReadyStateString(ws2.readyState)}`);\n\n    const messageCount: { ws1ToWs2: number; ws2ToWs1: number } = { ws1ToWs2: 0, ws2ToWs1: 0 };\n\n    ws1.on('message', (data) => {\n      messageCount.ws1ToWs2++;\n      if (ws2.readyState === WebSocket.OPEN) {\n        ws2.send(data);\n      } else {\n        this._terminal.writeLine(\n          `ws2 not open (state: ${getWebSocketReadyStateString(ws2.readyState)}). Dropping message #${messageCount.ws1ToWs2}`\n        );\n      }\n    });\n    ws2.on('message', (data) => {\n      messageCount.ws2ToWs1++;\n      if (ws1.readyState === WebSocket.OPEN) {\n        ws1.send(data);\n      } else {\n        this._terminal.writeLine(\n          `ws1 not open (state: ${getWebSocketReadyStateString(ws1.readyState)}). Dropping message #${messageCount.ws2ToWs1}`\n        );\n      }\n    });\n\n    ws1.once('close', (code: number, reason: Buffer) => {\n      const reasonStr: string = reason.toString() || 'no reason provided';\n      const codeDescription: string = getWebSocketCloseReason(code);\n      this._terminal.writeLine(\n        `ws1 (tunnel) closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`\n      );\n      this._terminal.writeLine(\n        `  Messages forwarded: ws1->ws2: ${messageCount.ws1ToWs2}, ws2->ws1: ${messageCount.ws2ToWs1}`\n      );\n      if (ws2.readyState === WebSocket.OPEN) {\n        this._terminal.writeLine('  Closing ws2 (browser) in response');\n        ws2.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Tunnel closed');\n      }\n    });\n    ws2.once('close', (code: number, reason: Buffer) => {\n      const reasonStr: string = reason.toString() || 'no reason provided';\n      const codeDescription: string = getWebSocketCloseReason(code);\n      this._terminal.writeLine(\n        `ws2 (browser) closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`\n      );\n      this._terminal.writeLine(\n        `  Messages forwarded: ws1->ws2: ${messageCount.ws1ToWs2}, ws2->ws1: ${messageCount.ws2ToWs1}`\n      );\n      if (ws1.readyState === WebSocket.OPEN) {\n        this._terminal.writeLine('  Closing ws1 (tunnel) in response');\n        ws1.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Browser closed');\n      }\n    });\n\n    ws1.once('error', (error) => {\n      this._terminal.writeErrorLine(`ws1 (tunnel) WebSocket error: ${getNormalizedErrorString(error)}`);\n      this._terminal.writeErrorLine(`  ws1 readyState: ${getWebSocketReadyStateString(ws1.readyState)}`);\n    });\n    ws2.once('error', (error) => {\n      this._terminal.writeErrorLine(`ws2 (browser) WebSocket error: ${getNormalizedErrorString(error)}`);\n      this._terminal.writeErrorLine(`  ws2 readyState: ${getWebSocketReadyStateString(ws2.readyState)}`);\n    });\n  }\n\n  /**\n   * Initializes the Playwright browser tunnel by establishing a WebSocket connection\n   * and setting up the browser server.\n   * Returns when the handshake is complete and the browser server is running.\n   */\n  private async _initPlaywrightBrowserTunnelAsync(): Promise<WebSocket> {\n    let handshake: IHandshake | undefined = undefined;\n    let client: WebSocket | undefined = undefined;\n    let browserServer: BrowserServer | undefined = undefined;\n\n    this.status = 'waiting-for-connection';\n    const ws: WebSocket =\n      this._mode === 'poll-connection'\n        ? await this._pollConnectionAsync()\n        : await this._waitForIncomingConnectionAsync();\n\n    ws.on('open', () => {\n      this._terminal.writeLine(`WebSocket connection established`);\n      handshake = undefined;\n    });\n\n    ws.on('error', (error) => {\n      this._terminal.writeLine(`WebSocket error occurred: ${getNormalizedErrorString(error)}`);\n    });\n\n    ws.on('close', async (code: number, reason: Buffer) => {\n      const reasonStr: string = reason.toString() || 'no reason provided';\n      const codeDescription: string = getWebSocketCloseReason(code);\n      this._initWsPromise = undefined;\n      this.status = 'stopped';\n      this._terminal.writeLine(\n        `WebSocket connection closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`\n      );\n      this._terminal.writeLine(`  handshake received: ${handshake !== undefined}`);\n      this._terminal.writeLine(`  browserServer active: ${browserServer !== undefined}`);\n      if (browserServer) {\n        this._terminal.writeLine('  Closing browser server...');\n        await browserServer.close();\n        this._terminal.writeLine('  Browser server closed');\n      }\n    });\n\n    return await new Promise<WebSocket>((resolve, reject) => {\n      const onMessageHandler = async (data: RawData): Promise<void> => {\n        const terminal: ITerminal = this._terminal;\n        if (!handshake) {\n          try {\n            const rawHandshakeString: string = data.toString();\n            const rawHandshake: unknown = JSON.parse(rawHandshakeString);\n            terminal.writeLine(`Received handshake: ${rawHandshakeString}`);\n            handshake = this._validateHandshake(rawHandshake);\n\n            // Call the onBeforeLaunch callback if provided\n            if (this._onBeforeLaunch) {\n              terminal.writeLine('Requesting user approval before launching browser server...');\n              const shouldProceed: boolean = await this._onBeforeLaunch(handshake);\n              if (!shouldProceed) {\n                terminal.writeLine('Browser server launch cancelled by user.');\n                ws.off('message', onMessageHandler);\n                ws.close(WebSocketCloseCode.NORMAL_CLOSURE, 'Launch cancelled by user');\n                reject(new Error('Browser server launch cancelled by user'));\n                return;\n              }\n              terminal.writeLine('User approved browser server launch.');\n            }\n\n            this.status = 'setting-up-browser-server';\n            const browserServerProxy: IBrowserServerProxy =\n              await this._getPlaywrightBrowserServerProxyAsync(handshake);\n            client = browserServerProxy.client;\n            browserServer = browserServerProxy.browserServer;\n\n            // Monitor browser server process for crashes\n            const browserProcess: ChildProcess | null = browserServer.process();\n            if (browserProcess) {\n              browserProcess.on('exit', (code: number | null, signal: string | null) => {\n                terminal.writeErrorLine(`Browser server process exited - code: ${code}, signal: ${signal}`);\n              });\n              browserProcess.on('error', (err: Error) => {\n                terminal.writeErrorLine(`Browser server process error: ${getNormalizedErrorString(err)}`);\n              });\n              terminal.writeDebugLine(`Browser server process started with PID: ${browserProcess.pid}`);\n            } else {\n              terminal.writeDebugLine('Warning: Browser server process handle not available for monitoring');\n            }\n\n            this.status = 'browser-server-running';\n\n            // Send ack so that the counterpart also knows to start forwarding messages.\n            // NOTE: The 1-second delay is an intentional workaround. In the current\n            // protocol, the remote tunnel endpoint does not expose an explicit \"ready\"\n            // signal for when it has finished initializing its own forwarding logic\n            // after receiving the initial handshake. This\n            // delay avoids races where early messages could be dropped or mishandled\n            // if they arrive before the remote side is fully ready.\n            //\n            // TODO: A future improvement would be to replace this delay with a deterministic\n            // synchronization mechanism (e.g. an explicit \"ready\" message or event)\n            // instead of relying on a fixed timeout.\n            await Async.sleepAsync(2000);\n\n            ws.send(JSON.stringify({ action: 'handshakeAck' }));\n            await this._setupForwardingAsync(ws, client);\n\n            // Clean up message handler after successful handshake\n            ws.off('message', onMessageHandler);\n            resolve(ws);\n          } catch (error) {\n            terminal.writeLine(`Error processing handshake: ${error}`);\n            this.status = 'error';\n\n            // Cleanup and close connection on error\n            ws.off('message', onMessageHandler);\n            ws.close(WebSocketCloseCode.INTERNAL_ERROR, 'Handshake error');\n            reject(error);\n            return;\n          }\n        } else {\n          if (!client) {\n            terminal.writeLine('Browser WebSocket client is not initialized.');\n            ws.off('message', onMessageHandler);\n            ws.close(WebSocketCloseCode.INTERNAL_ERROR, 'Browser client not initialized');\n            return;\n          }\n        }\n      };\n      ws.on('message', onMessageHandler);\n    });\n  }\n}\n"]}

package/{src/index.ts → lib-esm/index.js}

@@ -1,6 +1,5 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
-
 /**
  * Run a Playwright browser server in one environment and drive it from another environment by
  * forwarding Playwright's WebSocket traffic through a tunnel.
@@ -16,23 +15,8 @@
  *
  * @packageDocumentation
  */
-
 export { PlaywrightTunnel } from './PlaywrightBrowserTunnel';
-export type {
-  BrowserName,
-  TunnelStatus,
-  IPlaywrightTunnelOptions,
-  IHandshake
-} from './PlaywrightBrowserTunnel';
 export { createTunneledBrowserAsync, tunneledBrowserConnection } from './tunneledBrowserConnection';
-export type {
-  IDisposableTunneledBrowserConnection,
-  IDisposableTunneledBrowser
-} from './tunneledBrowserConnection';
-export {
-  isExtensionInstalledAsync,
-  EXTENSION_INSTALLED_FILENAME,
-  getNormalizedErrorString
-} from './utilities';
+export { isExtensionInstalledAsync, EXTENSION_INSTALLED_FILENAME, getNormalizedErrorString } from './utilities';
 export { LaunchOptionsValidator, LAUNCH_OPTIONS_ALLOWLIST_FILENAME } from './LaunchOptionsValidator';
-export type { ILaunchOptionsAllowlist, ILaunchOptionsValidationResult } from './LaunchOptionsValidator';
+//# sourceMappingURL=index.js.map

package/lib-esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAO7D,OAAO,EAAE,0BAA0B,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAKpG,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,EACzB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,sBAAsB,EAAE,iCAAiC,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\n/**\n * Run a Playwright browser server in one environment and drive it from another environment by\n * forwarding Playwright's WebSocket traffic through a tunnel.\n *\n * @remarks\n * This package is intended for remote development and CI scenarios (for example: Codespaces,\n * devcontainers, or a separate \"browser host\" machine) where you want tests to run in one\n * environment but the actual browser process to run in another.\n *\n * The package provides two main APIs:\n * - {@link PlaywrightTunnel} - Run on the browser host to launch the real browser server and forward messages\n * - {@link tunneledBrowserConnection} - Run on the test runner to create a local endpoint that your Playwright client can connect to\n *\n * @packageDocumentation\n */\n\nexport { PlaywrightTunnel } from './PlaywrightBrowserTunnel';\nexport type {\n  BrowserName,\n  TunnelStatus,\n  IPlaywrightTunnelOptions,\n  IHandshake\n} from './PlaywrightBrowserTunnel';\nexport { createTunneledBrowserAsync, tunneledBrowserConnection } from './tunneledBrowserConnection';\nexport type {\n  IDisposableTunneledBrowserConnection,\n  IDisposableTunneledBrowser\n} from './tunneledBrowserConnection';\nexport {\n  isExtensionInstalledAsync,\n  EXTENSION_INSTALLED_FILENAME,\n  getNormalizedErrorString\n} from './utilities';\nexport { LaunchOptionsValidator, LAUNCH_OPTIONS_ALLOWLIST_FILENAME } from './LaunchOptionsValidator';\nexport type { ILaunchOptionsAllowlist, ILaunchOptionsValidationResult } from './LaunchOptionsValidator';\n"]}

package/{src/tunneledBrowserConnection/constants.ts → lib-esm/tunneledBrowserConnection/ITunneledBrowser.js}

@@ -1,5 +1,4 @@
 // Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
 // See LICENSE in the project root for license information.
-
-export const SUPPORTED_BROWSER_NAMES: Set<string> = new Set(['chromium', 'firefox', 'webkit']);
-export const DEFAULT_LISTEN_PORT: number = 56767;
+export {};
+//# sourceMappingURL=ITunneledBrowser.js.map

package/lib-esm/tunneledBrowserConnection/ITunneledBrowser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITunneledBrowser.js","sourceRoot":"","sources":["../../src/tunneledBrowserConnection/ITunneledBrowser.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { Browser } from 'playwright-core';\n\n/**\n * Disposable handle returned by {@link createTunneledBrowserAsync}.\n * @beta\n */\nexport interface IDisposableTunneledBrowser {\n  /**\n   * The connected Playwright Browser instance.\n   */\n  browser: Browser;\n  /**\n   * Async dispose method that closes the browser connection.\n   * Called automatically when using `await using` syntax.\n   */\n  [Symbol.asyncDispose]: () => Promise<void>;\n}\n"]}

package/lib-esm/tunneledBrowserConnection/ITunneledBrowserConnection.js

@@ -0,0 +1,4 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export {};
+//# sourceMappingURL=ITunneledBrowserConnection.js.map

package/lib-esm/tunneledBrowserConnection/ITunneledBrowserConnection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ITunneledBrowserConnection.js","sourceRoot":"","sources":["../../src/tunneledBrowserConnection/ITunneledBrowserConnection.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D","sourcesContent":["// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.\n// See LICENSE in the project root for license information.\n\nimport type { LaunchOptions } from 'playwright-core';\n\nimport type { BrowserName } from '../PlaywrightBrowserTunnel';\n\nexport interface IHandshake {\n  action: 'handshake';\n  browserName: BrowserName;\n  launchOptions: LaunchOptions;\n  playwrightVersion: string;\n}\n\nexport interface IHandshakeAck {\n  action: 'handshakeAck';\n}\n\n/**\n * Disposable handle returned by {@link tunneledBrowserConnection}.\n * @beta\n */\nexport interface IDisposableTunneledBrowserConnection {\n  /**\n   * The WebSocket endpoint URL that the local Playwright client should connect to.\n   */\n  remoteEndpoint: string;\n  /**\n   * Dispose method that closes the WebSocket servers.\n   * Called automatically when using `using` syntax.\n   */\n  [Symbol.dispose]: () => void;\n  /**\n   * Promise that resolves when the remote WebSocket server closes.\n   */\n  closePromise: Promise<void>;\n}\n"]}