@rushstack/playwright-browser-tunnel 0.2.3 → 0.3.0

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/lib-esm/index.js

@@ -0,0 +1,22 @@
+// 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.
+ *
+ * @remarks
+ * This package is intended for remote development and CI scenarios (for example: Codespaces,
+ * devcontainers, or a separate "browser host" machine) where you want tests to run in one
+ * environment but the actual browser process to run in another.
+ *
+ * The package provides two main APIs:
+ * - {@link PlaywrightTunnel} - Run on the browser host to launch the real browser server and forward messages
+ * - {@link tunneledBrowserConnection} - Run on the test runner to create a local endpoint that your Playwright client can connect to
+ *
+ * @packageDocumentation
+ */
+export { PlaywrightTunnel } from './PlaywrightBrowserTunnel';
+export { createTunneledBrowserAsync, tunneledBrowserConnection } from './tunneledBrowserConnection';
+export { isExtensionInstalledAsync, EXTENSION_INSTALLED_FILENAME, getNormalizedErrorString } from './utilities';
+export { LaunchOptionsValidator, LAUNCH_OPTIONS_ALLOWLIST_FILENAME } 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/lib-esm/tunneledBrowserConnection/ITunneledBrowser.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=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"]}

package/lib-esm/tunneledBrowserConnection/TunneledBrowser.js

@@ -0,0 +1,36 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import playwright from 'playwright-core';
+import { ConsoleTerminalProvider, Terminal } from '@rushstack/terminal';
+import { DEFAULT_LISTEN_PORT } from './constants';
+import { tunneledBrowserConnection } from './TunneledBrowserConnection';
+/**
+ * Creates a Playwright Browser instance connected via a tunneled WebSocket connection.
+ * @beta
+ */
+export async function createTunneledBrowserAsync(browserName, launchOptions, logger, port = DEFAULT_LISTEN_PORT) {
+    // Establish the tunnel first (remoteEndpoint here refers to local proxy endpoint for connect())
+    if (!logger) {
+        const terminalProvider = new ConsoleTerminalProvider();
+        logger = new Terminal(terminalProvider);
+    }
+    const connection = await tunneledBrowserConnection(logger, port);
+    const { remoteEndpoint } = connection;
+    // Append query params for browser and launchOptions
+    const urlObj = new URL(remoteEndpoint);
+    urlObj.searchParams.set('browser', browserName);
+    urlObj.searchParams.set('launchOptions', JSON.stringify(launchOptions || {}));
+    const connectEndpoint = urlObj.toString();
+    const browser = await playwright[browserName].connect(connectEndpoint);
+    logger.writeLine(`Connected to remote browser at ${connectEndpoint}`);
+    return {
+        browser,
+        async [Symbol.asyncDispose]() {
+            logger.writeLine('Disposing browser');
+            await browser.close();
+            // Dispose the tunnel connection after browser is closed
+            connection[Symbol.dispose]();
+        }
+    };
+}
+//# sourceMappingURL=TunneledBrowser.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TunneledBrowser.js","sourceRoot":"","sources":["../../src/tunneledBrowserConnection/TunneledBrowser.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAG3D,OAAO,UAAU,MAAM,iBAAiB,CAAC;AAGzC,OAAO,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAExE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,WAAwB,EACxB,aAA4B,EAC5B,MAAkB,EAClB,OAAe,mBAAmB;IAElC,gGAAgG;IAEhG,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,gBAAgB,GAA4B,IAAI,uBAAuB,EAAE,CAAC;QAChF,MAAM,GAAG,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,UAAU,GAAyC,MAAM,yBAAyB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvG,MAAM,EAAE,cAAc,EAAE,GAAG,UAAU,CAAC;IACtC,oDAAoD;IACpD,MAAM,MAAM,GAAQ,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5C,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAChD,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,SAAS,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9E,MAAM,eAAe,GAAW,MAAM,CAAC,QAAQ,EAAE,CAAC;IAClD,MAAM,OAAO,GAAY,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAChF,MAAM,CAAC,SAAS,CAAC,kCAAkC,eAAe,EAAE,CAAC,CAAC;IAEtE,OAAO;QACL,OAAO;QACP,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;YACzB,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;YACtC,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,wDAAwD;YACxD,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,CAAC;KACF,CAAC;AACJ,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\nimport type { Browser, LaunchOptions } from 'playwright-core';\nimport playwright from 'playwright-core';\n\nimport type { ITerminal } from '@rushstack/terminal';\nimport { ConsoleTerminalProvider, Terminal } from '@rushstack/terminal';\n\nimport type { BrowserName } from '../PlaywrightBrowserTunnel';\nimport { DEFAULT_LISTEN_PORT } from './constants';\nimport type { IDisposableTunneledBrowser } from './ITunneledBrowser';\nimport type { IDisposableTunneledBrowserConnection } from './ITunneledBrowserConnection';\nimport { tunneledBrowserConnection } from './TunneledBrowserConnection';\n\n/**\n * Creates a Playwright Browser instance connected via a tunneled WebSocket connection.\n * @beta\n */\nexport async function createTunneledBrowserAsync(\n  browserName: BrowserName,\n  launchOptions: LaunchOptions,\n  logger?: ITerminal,\n  port: number = DEFAULT_LISTEN_PORT\n): Promise<IDisposableTunneledBrowser> {\n  // Establish the tunnel first (remoteEndpoint here refers to local proxy endpoint for connect())\n\n  if (!logger) {\n    const terminalProvider: ConsoleTerminalProvider = new ConsoleTerminalProvider();\n    logger = new Terminal(terminalProvider);\n  }\n\n  const connection: IDisposableTunneledBrowserConnection = await tunneledBrowserConnection(logger, port);\n  const { remoteEndpoint } = connection;\n  // Append query params for browser and launchOptions\n  const urlObj: URL = new URL(remoteEndpoint);\n  urlObj.searchParams.set('browser', browserName);\n  urlObj.searchParams.set('launchOptions', JSON.stringify(launchOptions || {}));\n  const connectEndpoint: string = urlObj.toString();\n  const browser: Browser = await playwright[browserName].connect(connectEndpoint);\n  logger.writeLine(`Connected to remote browser at ${connectEndpoint}`);\n\n  return {\n    browser,\n    async [Symbol.asyncDispose]() {\n      logger.writeLine('Disposing browser');\n      await browser.close();\n      // Dispose the tunnel connection after browser is closed\n      connection[Symbol.dispose]();\n    }\n  };\n}\n"]}

package/lib-esm/tunneledBrowserConnection/TunneledBrowserConnection.js

@@ -0,0 +1,195 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import playwrightPackageJson from 'playwright-core/package.json';
+import { WebSocket, WebSocketServer } from 'ws';
+import { HttpServer } from '../HttpServer';
+import { getNormalizedErrorString, getWebSocketCloseReason, getWebSocketReadyStateString, WebSocketCloseCode } from '../utilities';
+import { DEFAULT_LISTEN_PORT, SUPPORTED_BROWSER_NAMES } from './constants';
+const { version: playwrightVersion } = playwrightPackageJson;
+/**
+ * Creates a tunneled WebSocket endpoint that a local Playwright client can connect to.
+ * @beta
+ */
+export async function tunneledBrowserConnection(logger, port = DEFAULT_LISTEN_PORT) {
+    // Server that remote peer (actual browser host) connects to
+    const remoteWsServer = new WebSocketServer({ port });
+    // Local HTTP + WebSocket server where the playwright client will connect providing params
+    const httpServer = new HttpServer(logger);
+    await httpServer.listenAsync();
+    logger.writeLine(`Remote WebSocket server listening on ws://localhost:${port}`);
+    const localProxyWs = httpServer.wsServer;
+    const localProxyWsEndpoint = httpServer.endpoint;
+    let browserName;
+    let launchOptions;
+    let remoteSocket;
+    let handshakeAck = false;
+    let handshakeSent = false;
+    function maybeSendHandshake() {
+        if (!handshakeSent && remoteSocket && browserName && launchOptions) {
+            const handshake = {
+                action: 'handshake',
+                browserName,
+                launchOptions,
+                playwrightVersion
+            };
+            // Log handshake without 'headless' to avoid confusion (tunnel enforces headless: false)
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            const { headless, ...logOptions } = launchOptions;
+            const logHandshake = {
+                ...handshake,
+                launchOptions: logOptions
+            };
+            logger.writeLine(`Sending handshake to remote: ${JSON.stringify(logHandshake)}`);
+            handshakeSent = true;
+            remoteSocket.send(JSON.stringify(handshake));
+        }
+    }
+    return await new Promise((resolve) => {
+        remoteWsServer.on('error', (error) => {
+            logger.writeErrorLine(`Remote WebSocket server error: ${error}`);
+        });
+        remoteWsServer.on('close', () => {
+            logger.writeLine('Remote WebSocket server closed');
+        });
+        const bufferedLocalMessages = [];
+        remoteWsServer.on('connection', (ws) => {
+            logger.writeLine('Remote websocket connected');
+            remoteSocket = ws;
+            handshakeAck = false;
+            maybeSendHandshake();
+            ws.on('message', (message) => {
+                if (!handshakeAck) {
+                    try {
+                        const receivedHandshake = JSON.parse(message.toString());
+                        if (receivedHandshake.action === 'handshakeAck') {
+                            handshakeAck = true;
+                            logger.writeLine('Received handshakeAck from remote');
+                        }
+                        else {
+                            logger.writeErrorLine('Invalid handshake ack message');
+                            ws.close(WebSocketCloseCode.PROTOCOL_ERROR, 'Invalid handshake ack');
+                            return;
+                        }
+                    }
+                    catch (e) {
+                        logger.writeErrorLine(`Failed parsing handshake ack: ${e}`);
+                        ws.close(WebSocketCloseCode.PROTOCOL_ERROR, 'Failed parsing handshake');
+                        return;
+                    }
+                    // Resolve only once local proxy available and handshake acknowledged
+                    if (handshakeAck) {
+                        // Flush any buffered local messages now that tunnel is active
+                        const activeRemote = remoteSocket;
+                        if (activeRemote && activeRemote.readyState === WebSocket.OPEN) {
+                            while (bufferedLocalMessages.length > 0) {
+                                const m = bufferedLocalMessages.shift();
+                                if (m !== undefined) {
+                                    logger.writeLine(`Flushing buffered local message to remote: ${m}`);
+                                    activeRemote.send(m);
+                                }
+                            }
+                        }
+                    }
+                }
+                else {
+                    // Forward from remote to all local clients
+                    localProxyWs.clients.forEach((client) => {
+                        if (client.readyState === WebSocket.OPEN) {
+                            client.send(message);
+                        }
+                    });
+                }
+            });
+            ws.on('close', (code, reason) => {
+                const reasonStr = reason.toString() || 'no reason provided';
+                const codeDescription = getWebSocketCloseReason(code);
+                logger.writeDebugLine(`Remote websocket closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`);
+                logger.writeDebugLine(`  Connection state at close: handshakeSent=${handshakeSent}, handshakeAck=${handshakeAck}`);
+                logger.writeDebugLine(`  Buffered messages pending: ${bufferedLocalMessages.length}`);
+            });
+            ws.on('error', (err) => {
+                logger.writeErrorLine(`Remote websocket error: ${getNormalizedErrorString(err)}`);
+                logger.writeErrorLine(`  Socket readyState: ${getWebSocketReadyStateString(ws.readyState)}`);
+            });
+        });
+        localProxyWs.on('connection', (localWs, request) => {
+            try {
+                const urlString = request === null || request === void 0 ? void 0 : request.url;
+                if (urlString) {
+                    const parsed = new URL(urlString, 'http://localhost');
+                    logger.writeLine(`Local client connected with query params: ${parsed.searchParams.toString()}`);
+                    const bName = parsed.searchParams.get('browser');
+                    if (bName && SUPPORTED_BROWSER_NAMES.has(bName)) {
+                        browserName = bName;
+                    }
+                    const launchOptionsParam = parsed.searchParams.get('launchOptions');
+                    if (launchOptionsParam) {
+                        try {
+                            launchOptions = JSON.parse(launchOptionsParam);
+                        }
+                        catch (e) {
+                            logger.writeErrorLine('Invalid launchOptions JSON provided');
+                        }
+                    }
+                }
+            }
+            catch (e) {
+                logger.writeErrorLine(`Error parsing local connection query params: ${e}`);
+            }
+            if (!browserName) {
+                const supportedBrowsersString = Array.from(SUPPORTED_BROWSER_NAMES).join('|');
+                logger.writeErrorLine(`browser query param required (${supportedBrowsersString})`);
+                localWs.close(WebSocketCloseCode.PROTOCOL_ERROR, 'Missing browser param');
+                return;
+            }
+            if (!launchOptions) {
+                launchOptions = {}; // default empty if not provided
+            }
+            maybeSendHandshake();
+            localWs.on('message', (message) => {
+                if (handshakeAck && (remoteSocket === null || remoteSocket === void 0 ? void 0 : remoteSocket.readyState) === WebSocket.OPEN) {
+                    remoteSocket.send(message);
+                }
+                else {
+                    // Buffer until handshakeAck to avoid losing early protocol messages from Playwright
+                    bufferedLocalMessages.push(message);
+                }
+            });
+            localWs.on('close', (code, reason) => {
+                const reasonStr = reason.toString() || 'no reason provided';
+                const codeDescription = getWebSocketCloseReason(code);
+                logger.writeDebugLine(`Local client websocket closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`);
+                logger.writeDebugLine(`  Remote socket state: ${remoteSocket ? getWebSocketReadyStateString(remoteSocket.readyState) : 'undefined'}`);
+                logger.writeDebugLine(`  handshakeAck: ${handshakeAck}`);
+            });
+            localWs.on('error', (err) => {
+                logger.writeErrorLine(`Local client websocket error: ${getNormalizedErrorString(err)}`);
+            });
+        });
+        // Resolve immediately so caller can initiate local connection with query params (handshake completes later)
+        resolve({
+            remoteEndpoint: localProxyWsEndpoint,
+            [Symbol.dispose]() {
+                try {
+                    remoteWsServer.close();
+                }
+                catch (_a) {
+                    // ignore errors during remote WebSocket server shutdown
+                }
+                try {
+                    httpServer[Symbol.dispose]();
+                }
+                catch (_b) {
+                    // ignore errors during HTTP/WebSocket server shutdown
+                }
+            },
+            // eslint-disable-next-line promise/param-names
+            closePromise: new Promise((resolve2) => {
+                remoteWsServer.once('close', () => {
+                    resolve2();
+                });
+            })
+        });
+    });
+}
+//# sourceMappingURL=TunneledBrowserConnection.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TunneledBrowserConnection.js","sourceRoot":"","sources":["../../src/tunneledBrowserConnection/TunneledBrowserConnection.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 { LaunchOptions } from 'playwright-core';\nimport playwrightPackageJson from 'playwright-core/package.json';\nimport type { RawData } from 'ws';\nimport { WebSocket, WebSocketServer } from 'ws';\n\nimport type { ITerminal } from '@rushstack/terminal';\n\nimport { HttpServer } from '../HttpServer';\nimport type { BrowserName } from '../PlaywrightBrowserTunnel';\nimport {\n  getNormalizedErrorString,\n  getWebSocketCloseReason,\n  getWebSocketReadyStateString,\n  WebSocketCloseCode\n} from '../utilities';\nimport type {\n  IDisposableTunneledBrowserConnection,\n  IHandshake,\n  IHandshakeAck\n} from './ITunneledBrowserConnection';\nimport { DEFAULT_LISTEN_PORT, SUPPORTED_BROWSER_NAMES } from './constants';\n\nconst { version: playwrightVersion } = playwrightPackageJson;\n\n/**\n * Creates a tunneled WebSocket endpoint that a local Playwright client can connect to.\n * @beta\n */\nexport async function tunneledBrowserConnection(\n  logger: ITerminal,\n  port: number = DEFAULT_LISTEN_PORT\n): Promise<IDisposableTunneledBrowserConnection> {\n  // Server that remote peer (actual browser host) connects to\n  const remoteWsServer: WebSocketServer = new WebSocketServer({ port });\n  // Local HTTP + WebSocket server where the playwright client will connect providing params\n  const httpServer: HttpServer = new HttpServer(logger);\n  await httpServer.listenAsync();\n  logger.writeLine(`Remote WebSocket server listening on ws://localhost:${port}`);\n\n  const localProxyWs: WebSocketServer = httpServer.wsServer;\n  const localProxyWsEndpoint: string = httpServer.endpoint;\n\n  let browserName: BrowserName | undefined;\n  let launchOptions: LaunchOptions | undefined;\n  let remoteSocket: WebSocket | undefined;\n  let handshakeAck: boolean = false;\n  let handshakeSent: boolean = false;\n\n  function maybeSendHandshake(): void {\n    if (!handshakeSent && remoteSocket && browserName && launchOptions) {\n      const handshake: IHandshake = {\n        action: 'handshake',\n        browserName,\n        launchOptions,\n        playwrightVersion\n      };\n      // Log handshake without 'headless' to avoid confusion (tunnel enforces headless: false)\n      // eslint-disable-next-line @typescript-eslint/no-unused-vars\n      const { headless, ...logOptions } = launchOptions;\n      const logHandshake: Omit<IHandshake, 'launchOptions'> & {\n        launchOptions: Omit<LaunchOptions, 'headless'>;\n      } = {\n        ...handshake,\n        launchOptions: logOptions\n      };\n      logger.writeLine(`Sending handshake to remote: ${JSON.stringify(logHandshake)}`);\n      handshakeSent = true;\n      remoteSocket.send(JSON.stringify(handshake));\n    }\n  }\n\n  return await new Promise((resolve) => {\n    remoteWsServer.on('error', (error) => {\n      logger.writeErrorLine(`Remote WebSocket server error: ${error}`);\n    });\n\n    remoteWsServer.on('close', () => {\n      logger.writeLine('Remote WebSocket server closed');\n    });\n\n    const bufferedLocalMessages: Array<RawData> = [];\n\n    remoteWsServer.on('connection', (ws) => {\n      logger.writeLine('Remote websocket connected');\n      remoteSocket = ws;\n      handshakeAck = false;\n      maybeSendHandshake();\n\n      ws.on('message', (message) => {\n        if (!handshakeAck) {\n          try {\n            const receivedHandshake: IHandshakeAck = JSON.parse(message.toString());\n            if (receivedHandshake.action === 'handshakeAck') {\n              handshakeAck = true;\n              logger.writeLine('Received handshakeAck from remote');\n            } else {\n              logger.writeErrorLine('Invalid handshake ack message');\n              ws.close(WebSocketCloseCode.PROTOCOL_ERROR, 'Invalid handshake ack');\n              return;\n            }\n          } catch (e) {\n            logger.writeErrorLine(`Failed parsing handshake ack: ${e}`);\n            ws.close(WebSocketCloseCode.PROTOCOL_ERROR, 'Failed parsing handshake');\n            return;\n          }\n          // Resolve only once local proxy available and handshake acknowledged\n          if (handshakeAck) {\n            // Flush any buffered local messages now that tunnel is active\n            const activeRemote: WebSocket | undefined = remoteSocket;\n            if (activeRemote && activeRemote.readyState === WebSocket.OPEN) {\n              while (bufferedLocalMessages.length > 0) {\n                const m: Buffer | ArrayBuffer | Buffer[] | string | undefined = bufferedLocalMessages.shift();\n                if (m !== undefined) {\n                  logger.writeLine(`Flushing buffered local message to remote: ${m}`);\n                  activeRemote.send(m);\n                }\n              }\n            }\n          }\n        } else {\n          // Forward from remote to all local clients\n          localProxyWs.clients.forEach((client) => {\n            if (client.readyState === WebSocket.OPEN) {\n              client.send(message);\n            }\n          });\n        }\n      });\n\n      ws.on('close', (code: number, reason: Buffer) => {\n        const reasonStr: string = reason.toString() || 'no reason provided';\n        const codeDescription: string = getWebSocketCloseReason(code);\n        logger.writeDebugLine(\n          `Remote websocket closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`\n        );\n        logger.writeDebugLine(\n          `  Connection state at close: handshakeSent=${handshakeSent}, handshakeAck=${handshakeAck}`\n        );\n        logger.writeDebugLine(`  Buffered messages pending: ${bufferedLocalMessages.length}`);\n      });\n      ws.on('error', (err: Error) => {\n        logger.writeErrorLine(`Remote websocket error: ${getNormalizedErrorString(err)}`);\n        logger.writeErrorLine(`  Socket readyState: ${getWebSocketReadyStateString(ws.readyState)}`);\n      });\n    });\n\n    localProxyWs.on('connection', (localWs, request) => {\n      try {\n        const urlString: string | undefined = request?.url;\n        if (urlString) {\n          const parsed: URL = new URL(urlString, 'http://localhost');\n          logger.writeLine(`Local client connected with query params: ${parsed.searchParams.toString()}`);\n          const bName: string | null = parsed.searchParams.get('browser');\n          if (bName && SUPPORTED_BROWSER_NAMES.has(bName)) {\n            browserName = bName as BrowserName;\n          }\n          const launchOptionsParam: string | null = parsed.searchParams.get('launchOptions');\n          if (launchOptionsParam) {\n            try {\n              launchOptions = JSON.parse(launchOptionsParam);\n            } catch (e) {\n              logger.writeErrorLine('Invalid launchOptions JSON provided');\n            }\n          }\n        }\n      } catch (e) {\n        logger.writeErrorLine(`Error parsing local connection query params: ${e}`);\n      }\n\n      if (!browserName) {\n        const supportedBrowsersString: string = Array.from(SUPPORTED_BROWSER_NAMES).join('|');\n        logger.writeErrorLine(`browser query param required (${supportedBrowsersString})`);\n        localWs.close(WebSocketCloseCode.PROTOCOL_ERROR, 'Missing browser param');\n        return;\n      }\n      if (!launchOptions) {\n        launchOptions = {} as LaunchOptions; // default empty if not provided\n      }\n\n      maybeSendHandshake();\n\n      localWs.on('message', (message) => {\n        if (handshakeAck && remoteSocket?.readyState === WebSocket.OPEN) {\n          remoteSocket.send(message);\n        } else {\n          // Buffer until handshakeAck to avoid losing early protocol messages from Playwright\n          bufferedLocalMessages.push(message);\n        }\n      });\n      localWs.on('close', (code: number, reason: Buffer) => {\n        const reasonStr: string = reason.toString() || 'no reason provided';\n        const codeDescription: string = getWebSocketCloseReason(code);\n        logger.writeDebugLine(\n          `Local client websocket closed - code: ${code} (${codeDescription}), reason: ${reasonStr}`\n        );\n        logger.writeDebugLine(\n          `  Remote socket state: ${remoteSocket ? getWebSocketReadyStateString(remoteSocket.readyState) : 'undefined'}`\n        );\n        logger.writeDebugLine(`  handshakeAck: ${handshakeAck}`);\n      });\n      localWs.on('error', (err: Error) => {\n        logger.writeErrorLine(`Local client websocket error: ${getNormalizedErrorString(err)}`);\n      });\n    });\n\n    // Resolve immediately so caller can initiate local connection with query params (handshake completes later)\n    resolve({\n      remoteEndpoint: localProxyWsEndpoint,\n      [Symbol.dispose]() {\n        try {\n          remoteWsServer.close();\n        } catch {\n          // ignore errors during remote WebSocket server shutdown\n        }\n        try {\n          httpServer[Symbol.dispose]();\n        } catch {\n          // ignore errors during HTTP/WebSocket server shutdown\n        }\n      },\n      // eslint-disable-next-line promise/param-names\n      closePromise: new Promise<void>((resolve2) => {\n        remoteWsServer.once('close', () => {\n          resolve2();\n        });\n      })\n    });\n  });\n}\n"]}

package/lib-esm/tunneledBrowserConnection/constants.js

@@ -0,0 +1,5 @@
+// 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 = new Set(['chromium', 'firefox', 'webkit']);
+export const DEFAULT_LISTEN_PORT = 56767;
+//# sourceMappingURL=constants.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/tunneledBrowserConnection/constants.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,MAAM,CAAC,MAAM,uBAAuB,GAAgB,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;AAC/F,MAAM,CAAC,MAAM,mBAAmB,GAAW,KAAK,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\nexport const SUPPORTED_BROWSER_NAMES: Set<string> = new Set(['chromium', 'firefox', 'webkit']);\nexport const DEFAULT_LISTEN_PORT: number = 56767;\n"]}

package/lib-esm/tunneledBrowserConnection/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+export { createTunneledBrowserAsync } from './TunneledBrowser';
+export { tunneledBrowserConnection } from './TunneledBrowserConnection';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tunneledBrowserConnection/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,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\nexport { createTunneledBrowserAsync } from './TunneledBrowser';\nexport { tunneledBrowserConnection } from './TunneledBrowserConnection';\n\nexport type { IDisposableTunneledBrowser } from './ITunneledBrowser';\nexport type { IDisposableTunneledBrowserConnection } from './ITunneledBrowserConnection';\n"]}

package/lib-esm/utilities.js

@@ -0,0 +1,96 @@
+// Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
+// See LICENSE in the project root for license information.
+import { tmpdir } from 'node:os';
+import { FileSystem } from '@rushstack/node-core-library';
+/**
+ * The filename used to indicate that the Playwright Local Browser Server extension is installed.
+ * @beta
+ */
+export const EXTENSION_INSTALLED_FILENAME = '.playwright-local-browser-server-extension-installed.txt';
+/**
+ * Helper to determine if the Playwright Local Browser Server extension is installed. This checks for the
+ * existence of a well-known file in the OS temp directory.
+ * @beta
+ */
+export async function isExtensionInstalledAsync() {
+    // Read file from os.tempdir() + '/.playwright-local-browser-server-extension-installed'
+    const tempDir = tmpdir();
+    const extensionInstalledFilePath = `${tempDir}/${EXTENSION_INSTALLED_FILENAME}`;
+    const doesExist = FileSystem.exists(extensionInstalledFilePath);
+    // check if file exists
+    return doesExist;
+}
+/**
+ * Normalizes an error to a string for logging purposes.
+ * @beta
+ */
+export function getNormalizedErrorString(error) {
+    if (error instanceof Error) {
+        if (error.stack) {
+            return error.stack;
+        }
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * WebSocket close codes as defined by RFC 6455.
+ * @see {@link https://datatracker.ietf.org/doc/html/rfc6455#section-11.7}
+ * @beta
+ */
+export const WebSocketCloseCode = {
+    NORMAL_CLOSURE: 1000,
+    GOING_AWAY: 1001,
+    PROTOCOL_ERROR: 1002,
+    UNSUPPORTED_DATA: 1003,
+    NO_STATUS_RECEIVED: 1005,
+    ABNORMAL_CLOSURE: 1006,
+    INVALID_PAYLOAD: 1007,
+    POLICY_VIOLATION: 1008,
+    MESSAGE_TOO_BIG: 1009,
+    INTERNAL_ERROR: 1011,
+    TLS_HANDSHAKE_FAILED: 1015
+};
+/**
+ * Human-readable descriptions for WebSocket close codes.
+ * @beta
+ */
+export const WebSocketCloseCodeDescriptions = {
+    [WebSocketCloseCode.NORMAL_CLOSURE]: 'Normal Closure',
+    [WebSocketCloseCode.GOING_AWAY]: 'Going Away',
+    [WebSocketCloseCode.PROTOCOL_ERROR]: 'Protocol Error',
+    [WebSocketCloseCode.UNSUPPORTED_DATA]: 'Unsupported Data',
+    [WebSocketCloseCode.NO_STATUS_RECEIVED]: 'No Status Received',
+    [WebSocketCloseCode.ABNORMAL_CLOSURE]: 'Abnormal Closure (connection lost)',
+    [WebSocketCloseCode.INVALID_PAYLOAD]: 'Invalid Payload',
+    [WebSocketCloseCode.POLICY_VIOLATION]: 'Policy Violation',
+    [WebSocketCloseCode.MESSAGE_TOO_BIG]: 'Message Too Big',
+    [WebSocketCloseCode.INTERNAL_ERROR]: 'Internal Error',
+    [WebSocketCloseCode.TLS_HANDSHAKE_FAILED]: 'TLS Handshake Failed'
+};
+/**
+ * Returns a human-readable description for a WebSocket close code.
+ * @beta
+ */
+export function getWebSocketCloseReason(code) {
+    return WebSocketCloseCodeDescriptions[code] || 'Unknown';
+}
+/**
+ * Returns a human-readable string for a WebSocket ready state.
+ * @beta
+ */
+export function getWebSocketReadyStateString(readyState) {
+    switch (readyState) {
+        case 0:
+            return 'CONNECTING';
+        case 1:
+            return 'OPEN';
+        case 2:
+            return 'CLOSING';
+        case 3:
+            return 'CLOSED';
+        default:
+            return `UNKNOWN(${readyState})`;
+    }
+}
+//# sourceMappingURL=utilities.js.map

package/lib-esm/utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utilities.js","sourceRoot":"","sources":["../src/utilities.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,2DAA2D;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE1D;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GACvC,0DAA0D,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,wFAAwF;IACxF,MAAM,OAAO,GAAW,MAAM,EAAE,CAAC;IAEjC,MAAM,0BAA0B,GAAW,GAAG,OAAO,IAAI,4BAA4B,EAAE,CAAC;IACxF,MAAM,SAAS,GAAY,UAAU,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;IAEzE,uBAAuB;IACvB,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAuB3B;IACF,cAAc,EAAE,IAAI;IACpB,UAAU,EAAE,IAAI;IAChB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,kBAAkB,EAAE,IAAI;IACxB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,gBAAgB,EAAE,IAAI;IACtB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE,IAAI;IACpB,oBAAoB,EAAE,IAAI;CAC3B,CAAC;AAQF;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAA4C;IACrF,CAAC,kBAAkB,CAAC,cAAc,CAAC,EAAE,gBAAgB;IACrD,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,YAAY;IAC7C,CAAC,kBAAkB,CAAC,cAAc,CAAC,EAAE,gBAAgB;IACrD,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,kBAAkB;IACzD,CAAC,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,oBAAoB;IAC7D,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,oCAAoC;IAC3E,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,iBAAiB;IACvD,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,kBAAkB;IACzD,CAAC,kBAAkB,CAAC,eAAe,CAAC,EAAE,iBAAiB;IACvD,CAAC,kBAAkB,CAAC,cAAc,CAAC,EAAE,gBAAgB;IACrD,CAAC,kBAAkB,CAAC,oBAAoB,CAAC,EAAE,sBAAsB;CAClE,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,8BAA8B,CAAC,IAA+B,CAAC,IAAI,SAAS,CAAC;AACtF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,UAAkB;IAC7D,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,CAAC;YACJ,OAAO,YAAY,CAAC;QACtB,KAAK,CAAC;YACJ,OAAO,MAAM,CAAC;QAChB,KAAK,CAAC;YACJ,OAAO,SAAS,CAAC;QACnB,KAAK,CAAC;YACJ,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,WAAW,UAAU,GAAG,CAAC;IACpC,CAAC;AACH,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\nimport { tmpdir } from 'node:os';\n\nimport { FileSystem } from '@rushstack/node-core-library';\n\n/**\n * The filename used to indicate that the Playwright Local Browser Server extension is installed.\n * @beta\n */\nexport const EXTENSION_INSTALLED_FILENAME: string =\n  '.playwright-local-browser-server-extension-installed.txt';\n\n/**\n * Helper to determine if the Playwright Local Browser Server extension is installed. This checks for the\n * existence of a well-known file in the OS temp directory.\n * @beta\n */\nexport async function isExtensionInstalledAsync(): Promise<boolean> {\n  // Read file from os.tempdir() + '/.playwright-local-browser-server-extension-installed'\n  const tempDir: string = tmpdir();\n\n  const extensionInstalledFilePath: string = `${tempDir}/${EXTENSION_INSTALLED_FILENAME}`;\n  const doesExist: boolean = FileSystem.exists(extensionInstalledFilePath);\n\n  // check if file exists\n  return doesExist;\n}\n\n/**\n * Normalizes an error to a string for logging purposes.\n * @beta\n */\nexport function getNormalizedErrorString(error: unknown): string {\n  if (error instanceof Error) {\n    if (error.stack) {\n      return error.stack;\n    }\n    return error.message;\n  }\n  return String(error);\n}\n\n/**\n * WebSocket close codes as defined by RFC 6455.\n * @see {@link https://datatracker.ietf.org/doc/html/rfc6455#section-11.7}\n * @beta\n */\nexport const WebSocketCloseCode: {\n  /** Normal closure; the connection successfully completed. */\n  readonly NORMAL_CLOSURE: 1000;\n  /** Endpoint is going away (e.g., server shutting down, browser navigating away). */\n  readonly GOING_AWAY: 1001;\n  /** Protocol error encountered. */\n  readonly PROTOCOL_ERROR: 1002;\n  /** Received data type that cannot be accepted (e.g., text-only endpoint received binary). */\n  readonly UNSUPPORTED_DATA: 1003;\n  /** No status code was provided even though one was expected. */\n  readonly NO_STATUS_RECEIVED: 1005;\n  /** Connection was closed abnormally (e.g., without sending a close frame). */\n  readonly ABNORMAL_CLOSURE: 1006;\n  /** Received message data inconsistent with the message type. */\n  readonly INVALID_PAYLOAD: 1007;\n  /** Received a message that violates policy. */\n  readonly POLICY_VIOLATION: 1008;\n  /** Received a message that is too big to process. */\n  readonly MESSAGE_TOO_BIG: 1009;\n  /** Server encountered an unexpected condition that prevented it from fulfilling the request. */\n  readonly INTERNAL_ERROR: 1011;\n  /** Connection was closed due to TLS handshake failure. */\n  readonly TLS_HANDSHAKE_FAILED: 1015;\n} = {\n  NORMAL_CLOSURE: 1000,\n  GOING_AWAY: 1001,\n  PROTOCOL_ERROR: 1002,\n  UNSUPPORTED_DATA: 1003,\n  NO_STATUS_RECEIVED: 1005,\n  ABNORMAL_CLOSURE: 1006,\n  INVALID_PAYLOAD: 1007,\n  POLICY_VIOLATION: 1008,\n  MESSAGE_TOO_BIG: 1009,\n  INTERNAL_ERROR: 1011,\n  TLS_HANDSHAKE_FAILED: 1015\n};\n\n/**\n * Type for WebSocket close code values.\n * @beta\n */\nexport type WebSocketCloseCodeValue = (typeof WebSocketCloseCode)[keyof typeof WebSocketCloseCode];\n\n/**\n * Human-readable descriptions for WebSocket close codes.\n * @beta\n */\nexport const WebSocketCloseCodeDescriptions: Record<WebSocketCloseCodeValue, string> = {\n  [WebSocketCloseCode.NORMAL_CLOSURE]: 'Normal Closure',\n  [WebSocketCloseCode.GOING_AWAY]: 'Going Away',\n  [WebSocketCloseCode.PROTOCOL_ERROR]: 'Protocol Error',\n  [WebSocketCloseCode.UNSUPPORTED_DATA]: 'Unsupported Data',\n  [WebSocketCloseCode.NO_STATUS_RECEIVED]: 'No Status Received',\n  [WebSocketCloseCode.ABNORMAL_CLOSURE]: 'Abnormal Closure (connection lost)',\n  [WebSocketCloseCode.INVALID_PAYLOAD]: 'Invalid Payload',\n  [WebSocketCloseCode.POLICY_VIOLATION]: 'Policy Violation',\n  [WebSocketCloseCode.MESSAGE_TOO_BIG]: 'Message Too Big',\n  [WebSocketCloseCode.INTERNAL_ERROR]: 'Internal Error',\n  [WebSocketCloseCode.TLS_HANDSHAKE_FAILED]: 'TLS Handshake Failed'\n};\n\n/**\n * Returns a human-readable description for a WebSocket close code.\n * @beta\n */\nexport function getWebSocketCloseReason(code: number): string {\n  return WebSocketCloseCodeDescriptions[code as WebSocketCloseCodeValue] || 'Unknown';\n}\n\n/**\n * Returns a human-readable string for a WebSocket ready state.\n * @beta\n */\nexport function getWebSocketReadyStateString(readyState: number): string {\n  switch (readyState) {\n    case 0:\n      return 'CONNECTING';\n    case 1:\n      return 'OPEN';\n    case 2:\n      return 'CLOSING';\n    case 3:\n      return 'CLOSED';\n    default:\n      return `UNKNOWN(${readyState})`;\n  }\n}\n"]}