@warlock.js/core 5.32.0 → 5.34.0

package/esm/connectors/socket-connector.mjs

@@ -68,7 +68,14 @@ var SocketConnector = class extends BaseConnector {
 			server.on("error", (error) => {
 				log.error("socket", "connection", error, { port: socketConfig.port });
 			});
-			server.listen(socketConfig.port);
+			await new Promise((resolve, reject) => {
+				const onBindError = (error) => reject(error);
+				server.once("error", onBindError);
+				server.listen(socketConfig.port, () => {
+					server.removeListener("error", onBindError);
+					resolve();
+				});
+			});
 			this.ownsRawServer = true;
 		}
 		container.set("socket.rawServer", server);

package/esm/connectors/socket-connector.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"socket-connector.mjs","names":["config","createHttpsServer","createHttpServer"],"sources":["../../../../../../../../packages/core/src/connectors/socket-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { createServer as createHttpServer } from \"http\";\nimport { createServer as createHttpsServer } from \"https\";\nimport type { Server } from \"socket.io\";\nimport { container } from \"../container\";\nimport { environment } from \"../utils/environment\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, type ConnectorName, ConnectorPriority } from \"./types\";\n\n/**\n * Shown when a project enables sockets (a `socket` config is present) but the\n * optional `socket.io` peer is not installed.\n */\nconst SOCKET_INSTALL_INSTRUCTIONS = `\nRealtime socket server requires the socket.io package.\nInstall it with:\n\n  warlock add socket\n\nOr manually:\n\n  npm install socket.io\n  pnpm add socket.io\n  yarn add socket.io\n`.trim();\n\nconst SINGLE_SERVER_WARNING =\n  \"socket: no adapter configured — broadcasts only reach clients connected to this server. Use @socket.io/redis-adapter (socket.adapter) behind a load balancer, with sticky sessions for the polling transport.\";\n\n/**\n * Socket Connector\n * Manages Socket server (Socket.IO) lifecycle\n */\nexport class SocketConnector extends BaseConnector {\n  public readonly name: ConnectorName = \"socket\";\n  public readonly priority = ConnectorPriority.SOCKET;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\n\n  /**\n   * Files that trigger Socket server restart\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\n   */\n  protected readonly watchedFiles = [\"src/config/socket.ts\"];\n\n  protected socket?: Server;\n\n  /**\n   * Whether this connector created the underlying node HTTP(S) server.\n   *\n   * When `http` is present, socket binds onto the HTTP connector's shared\n   * `fastify.server` and must NOT close it on shutdown — the HTTP connector\n   * owns the graceful drain. Socket only closes the node server when it\n   * created one itself (http absent). See {@link shutdown}.\n   */\n  protected ownsRawServer = false;\n\n  /**\n   * The shared server socket.io attached to, kept for the detach.\n   */\n  protected sharedServer?: any;\n\n  /**\n   * Listener changes socket.io/engine.io made on the shared server at attach:\n   * the listeners they added, and the ones they removed (engine.io lifts the\n   * existing `request` listeners into its own wrapper). Undone on detach so\n   * repeated dev restarts don't stack engines on Fastify's server.\n   */\n  protected attachedListeners: {\n    added: Array<[string, (...args: any[]) => void]>;\n    removed: Array<[string, (...args: any[]) => void]>;\n  } = { added: [], removed: [] };\n\n  /**\n   * Boot the connector\n   */\n  public async boot() {\n    const socketConfig = config.get(\"socket\");\n\n    if (!socketConfig) return;\n\n    // socket.io is an optional peer — load it lazily so projects that don't use\n    // realtime sockets never need it installed (mirrors the mail/storage drivers).\n    let SocketServer: typeof import(\"socket.io\").Server;\n    try {\n      ({ Server: SocketServer } = await import(\"socket.io\"));\n    } catch {\n      throw new Error(SOCKET_INSTALL_INSTRUCTIONS);\n    }\n\n    log.info(\"socket\", \"connection\", \"Starting Socket.IO server\");\n\n    // now we have two cases\n    // 1. http is used, then use it (shared — the HTTP connector owns it)\n    // 2. http is not used, then create a new server (we own it)\n    let server;\n    const fastify = container.tryGet(\"http.server\");\n    if (fastify) {\n      server = fastify.server;\n      this.ownsRawServer = false;\n    } else {\n      server = socketConfig.ssl\n        ? createHttpsServer({ key: socketConfig.ssl.key, cert: socketConfig.ssl.cert })\n        : createHttpServer();\n      // Without a handler, EADDRINUSE is an unhandled 'error' event that crashes\n      // the process with no context.\n      server.on(\"error\", (error: Error) => {\n        log.error(\"socket\", \"connection\", error, { port: socketConfig.port });\n      });\n      server.listen(socketConfig.port);\n      this.ownsRawServer = true;\n    }\n\n    container.set(\"socket.rawServer\", server);\n\n    const before = this.snapshotListeners(server);\n\n    this.socket = new SocketServer(server, {\n      // The shared raw server may carry OTHER `upgrade` consumers — Vite's HMR\n      // websocket does exactly that when `WebConnector` is registered\n      // (`web/src/server/web-connector.ts`, `server.hmr.server = fastify.server`).\n      // engine.io's default `destroyUpgrade: true` schedules a destroy for every\n      // upgrade whose path is not `/socket.io`\n      // (`engine.io/build/server.js:676-695`: `setTimeout(… socket.end(), 1000)`),\n      // and the only thing saving a foreign websocket today is that it wrote its\n      // handshake bytes synchronously and so trips the `bytesWritten <= 0` guard\n      // before the 1s timer fires. That is an undocumented race, not a contract.\n      // Turning the destroy off removes the coupling outright and makes the\n      // shared server safe for any app-owned websocket route.\n      // A project can still override it via `socket.options`.\n      destroyUpgrade: false,\n      ...socketConfig.options,\n    });\n\n    if (!this.ownsRawServer) {\n      this.sharedServer = server;\n      this.attachedListeners = this.diffListeners(before, this.snapshotListeners(server));\n    }\n\n    if (socketConfig.adapter) {\n      this.socket.adapter((await socketConfig.adapter(this.socket)) as never);\n    } else if (environment() === \"production\" && !socketConfig.silenceSingleServerWarning) {\n      log.warn(\"socket\", \"adapter\", SINGLE_SERVER_WARNING);\n    }\n\n    container.set(\"socket\", this.socket);\n  }\n\n  /**\n   * Initialize Socket server\n   */\n  public async start(): Promise<void> {\n    const socketConfig = config.get(\"socket\");\n\n    // `this.socket` is only set by boot() once a socket config is present —\n    // use it (not a never-assigned field) to detect a successful boot.\n    if (!socketConfig || !this.socket) return;\n\n    log.success(\"socket\", \"connection\", \"Established Socket.IO server\");\n\n    this.active = true;\n  }\n\n  /**\n   * Restart re-boots too: the closed `io` must be replaced and the new\n   * `socket` config read, otherwise a config edit in dev restarts nothing.\n   */\n  public async restart(): Promise<void> {\n    await this.shutdown();\n    await this.boot();\n    await this.start();\n  }\n\n  /**\n   * Shutdown Socket server\n   *\n   * Always closes the Socket.IO layer (and awaits the drain). The underlying\n   * node HTTP(S) server is only closed here when this connector created it\n   * ({@link ownsRawServer}); when `http` owns the shared server, we leave it\n   * for the HTTP connector to drain and close, so the two connectors don't\n   * race to `close()` the same socket.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const socket = container.tryGet(\"socket\");\n    if (socket) {\n      if (this.ownsRawServer) {\n        // We own the raw server: `io.close()` closes it too, so it is the only\n        // close needed (a second `rawServer.close()` always rejects with\n        // ERR_SERVER_NOT_RUNNING).\n        await new Promise<void>((resolve) => {\n          socket.close(() => resolve());\n        });\n      } else {\n        // Shared mode: `io.close()` calls `httpServer.close()`, which would close\n        // Fastify's server from here and bypass its graceful drain. Detach\n        // instead: disconnect the clients and close the engine only.\n        socket.of(\"/\").disconnectSockets(true);\n        socket.engine.close();\n        this.restoreListeners();\n      }\n    }\n\n    this.active = false;\n  }\n\n  /**\n   * Current listeners of the events socket.io touches on a node server.\n   */\n  private snapshotListeners(server: any): Map<string, Array<(...args: any[]) => void>> {\n    const snapshot = new Map<string, Array<(...args: any[]) => void>>();\n\n    for (const event of [\"request\", \"upgrade\", \"close\", \"listening\"]) {\n      snapshot.set(event, server?.listeners?.(event)?.slice() ?? []);\n    }\n\n    return snapshot;\n  }\n\n  private diffListeners(\n    before: Map<string, Array<(...args: any[]) => void>>,\n    after: Map<string, Array<(...args: any[]) => void>>,\n  ) {\n    const added: Array<[string, (...args: any[]) => void]> = [];\n    const removed: Array<[string, (...args: any[]) => void]> = [];\n\n    for (const [event, listeners] of before) {\n      const now = after.get(event) ?? [];\n\n      for (const listener of now) if (!listeners.includes(listener)) added.push([event, listener]);\n      for (const listener of listeners)\n        if (!now.includes(listener)) removed.push([event, listener]);\n    }\n\n    return { added, removed };\n  }\n\n  /**\n   * Undo what attaching did to the shared server, leaving listeners other\n   * consumers added since (e.g. Vite's HMR upgrade handler) untouched.\n   */\n  private restoreListeners(): void {\n    const server = this.sharedServer;\n\n    if (!server) return;\n\n    const { added, removed } = this.attachedListeners;\n\n    for (const [event, listener] of added) server.removeListener(event, listener);\n    for (const [event, listener] of removed) server.on(event, listener);\n\n    this.attachedListeners = { added: [], removed: [] };\n    this.sharedServer = undefined;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"socket-connector.mjs","names":["config","createHttpsServer","createHttpServer"],"sources":["../../../../../../../../packages/core/src/connectors/socket-connector.ts"],"sourcesContent":["import config from \"@mongez/config\";\nimport { log } from \"@warlock.js/logger\";\nimport { createServer as createHttpServer, type Server as HttpServer } from \"http\";\nimport { createServer as createHttpsServer } from \"https\";\nimport type { Server } from \"socket.io\";\nimport { container } from \"../container\";\nimport { environment } from \"../utils/environment\";\nimport { BaseConnector } from \"./base-connector\";\nimport { ConnectorLifecyclePhase, type ConnectorName, ConnectorPriority } from \"./types\";\n\n/**\n * Shown when a project enables sockets (a `socket` config is present) but the\n * optional `socket.io` peer is not installed.\n */\nconst SOCKET_INSTALL_INSTRUCTIONS = `\nRealtime socket server requires the socket.io package.\nInstall it with:\n\n  warlock add socket\n\nOr manually:\n\n  npm install socket.io\n  pnpm add socket.io\n  yarn add socket.io\n`.trim();\n\nconst SINGLE_SERVER_WARNING =\n  \"socket: no adapter configured — broadcasts only reach clients connected to this server. Use @socket.io/redis-adapter (socket.adapter) behind a load balancer, with sticky sessions for the polling transport.\";\n\n/**\n * Socket Connector\n * Manages Socket server (Socket.IO) lifecycle\n */\nexport class SocketConnector extends BaseConnector {\n  public readonly name: ConnectorName = \"socket\";\n  public readonly priority = ConnectorPriority.SOCKET;\n  public readonly lifecyclePhase = ConnectorLifecyclePhase.Late;\n\n  /**\n   * Files that trigger Socket server restart\n   * Note: routes.ts changes will be handled by HMR with wildcard routing\n   * Connectors receive config file paths directly (not .env) thanks to layer-executor\n   */\n  protected readonly watchedFiles = [\"src/config/socket.ts\"];\n\n  protected socket?: Server;\n\n  /**\n   * Whether this connector created the underlying node HTTP(S) server.\n   *\n   * When `http` is present, socket binds onto the HTTP connector's shared\n   * `fastify.server` and must NOT close it on shutdown — the HTTP connector\n   * owns the graceful drain. Socket only closes the node server when it\n   * created one itself (http absent). See {@link shutdown}.\n   */\n  protected ownsRawServer = false;\n\n  /**\n   * The shared server socket.io attached to, kept for the detach.\n   */\n  protected sharedServer?: any;\n\n  /**\n   * Listener changes socket.io/engine.io made on the shared server at attach:\n   * the listeners they added, and the ones they removed (engine.io lifts the\n   * existing `request` listeners into its own wrapper). Undone on detach so\n   * repeated dev restarts don't stack engines on Fastify's server.\n   */\n  protected attachedListeners: {\n    added: Array<[string, (...args: any[]) => void]>;\n    removed: Array<[string, (...args: any[]) => void]>;\n  } = { added: [], removed: [] };\n\n  /**\n   * Boot the connector\n   */\n  public async boot() {\n    const socketConfig = config.get(\"socket\");\n\n    if (!socketConfig) return;\n\n    // socket.io is an optional peer — load it lazily so projects that don't use\n    // realtime sockets never need it installed (mirrors the mail/storage drivers).\n    let SocketServer: typeof import(\"socket.io\").Server;\n    try {\n      ({ Server: SocketServer } = await import(\"socket.io\"));\n    } catch {\n      throw new Error(SOCKET_INSTALL_INSTRUCTIONS);\n    }\n\n    log.info(\"socket\", \"connection\", \"Starting Socket.IO server\");\n\n    // now we have two cases\n    // 1. http is used, then use it (shared — the HTTP connector owns it)\n    // 2. http is not used, then create a new server (we own it)\n    let server: HttpServer;\n    const fastify = container.tryGet(\"http.server\");\n    if (fastify) {\n      server = fastify.server;\n      this.ownsRawServer = false;\n    } else {\n      server = socketConfig.ssl\n        ? createHttpsServer({ key: socketConfig.ssl.key, cert: socketConfig.ssl.cert })\n        : createHttpServer();\n      // Without a handler, EADDRINUSE is an unhandled 'error' event that crashes\n      // the process with no context.\n      server.on(\"error\", (error: Error) => {\n        log.error(\"socket\", \"connection\", error, { port: socketConfig.port });\n      });\n      // Boot must await the socket-only listener too: Application.markBooted\n      // reports readiness to PM2 after the late phase resolves. Logging a bind\n      // error alone would otherwise still let the app announce readiness.\n      await new Promise<void>((resolve, reject) => {\n        const onBindError = (error: Error) => reject(error);\n        server.once(\"error\", onBindError);\n        server.listen(socketConfig.port, () => {\n          server.removeListener(\"error\", onBindError);\n          resolve();\n        });\n      });\n      this.ownsRawServer = true;\n    }\n\n    container.set(\"socket.rawServer\", server);\n\n    const before = this.snapshotListeners(server);\n\n    this.socket = new SocketServer(server, {\n      // The shared raw server may carry OTHER `upgrade` consumers — Vite's HMR\n      // websocket does exactly that when `WebConnector` is registered\n      // (`web/src/server/web-connector.ts`, `server.hmr.server = fastify.server`).\n      // engine.io's default `destroyUpgrade: true` schedules a destroy for every\n      // upgrade whose path is not `/socket.io`\n      // (`engine.io/build/server.js:676-695`: `setTimeout(… socket.end(), 1000)`),\n      // and the only thing saving a foreign websocket today is that it wrote its\n      // handshake bytes synchronously and so trips the `bytesWritten <= 0` guard\n      // before the 1s timer fires. That is an undocumented race, not a contract.\n      // Turning the destroy off removes the coupling outright and makes the\n      // shared server safe for any app-owned websocket route.\n      // A project can still override it via `socket.options`.\n      destroyUpgrade: false,\n      ...socketConfig.options,\n    });\n\n    if (!this.ownsRawServer) {\n      this.sharedServer = server;\n      this.attachedListeners = this.diffListeners(before, this.snapshotListeners(server));\n    }\n\n    if (socketConfig.adapter) {\n      this.socket.adapter((await socketConfig.adapter(this.socket)) as never);\n    } else if (environment() === \"production\" && !socketConfig.silenceSingleServerWarning) {\n      log.warn(\"socket\", \"adapter\", SINGLE_SERVER_WARNING);\n    }\n\n    container.set(\"socket\", this.socket);\n  }\n\n  /**\n   * Initialize Socket server\n   */\n  public async start(): Promise<void> {\n    const socketConfig = config.get(\"socket\");\n\n    // `this.socket` is only set by boot() once a socket config is present —\n    // use it (not a never-assigned field) to detect a successful boot.\n    if (!socketConfig || !this.socket) return;\n\n    log.success(\"socket\", \"connection\", \"Established Socket.IO server\");\n\n    this.active = true;\n  }\n\n  /**\n   * Restart re-boots too: the closed `io` must be replaced and the new\n   * `socket` config read, otherwise a config edit in dev restarts nothing.\n   */\n  public async restart(): Promise<void> {\n    await this.shutdown();\n    await this.boot();\n    await this.start();\n  }\n\n  /**\n   * Shutdown Socket server\n   *\n   * Always closes the Socket.IO layer (and awaits the drain). The underlying\n   * node HTTP(S) server is only closed here when this connector created it\n   * ({@link ownsRawServer}); when `http` owns the shared server, we leave it\n   * for the HTTP connector to drain and close, so the two connectors don't\n   * race to `close()` the same socket.\n   */\n  public async shutdown(): Promise<void> {\n    if (!this.active) {\n      return;\n    }\n\n    const socket = container.tryGet(\"socket\");\n    if (socket) {\n      if (this.ownsRawServer) {\n        // We own the raw server: `io.close()` closes it too, so it is the only\n        // close needed (a second `rawServer.close()` always rejects with\n        // ERR_SERVER_NOT_RUNNING).\n        await new Promise<void>((resolve) => {\n          socket.close(() => resolve());\n        });\n      } else {\n        // Shared mode: `io.close()` calls `httpServer.close()`, which would close\n        // Fastify's server from here and bypass its graceful drain. Detach\n        // instead: disconnect the clients and close the engine only.\n        socket.of(\"/\").disconnectSockets(true);\n        socket.engine.close();\n        this.restoreListeners();\n      }\n    }\n\n    this.active = false;\n  }\n\n  /**\n   * Current listeners of the events socket.io touches on a node server.\n   */\n  private snapshotListeners(server: any): Map<string, Array<(...args: any[]) => void>> {\n    const snapshot = new Map<string, Array<(...args: any[]) => void>>();\n\n    for (const event of [\"request\", \"upgrade\", \"close\", \"listening\"]) {\n      snapshot.set(event, server?.listeners?.(event)?.slice() ?? []);\n    }\n\n    return snapshot;\n  }\n\n  private diffListeners(\n    before: Map<string, Array<(...args: any[]) => void>>,\n    after: Map<string, Array<(...args: any[]) => void>>,\n  ) {\n    const added: Array<[string, (...args: any[]) => void]> = [];\n    const removed: Array<[string, (...args: any[]) => void]> = [];\n\n    for (const [event, listeners] of before) {\n      const now = after.get(event) ?? [];\n\n      for (const listener of now) if (!listeners.includes(listener)) added.push([event, listener]);\n      for (const listener of listeners)\n        if (!now.includes(listener)) removed.push([event, listener]);\n    }\n\n    return { added, removed };\n  }\n\n  /**\n   * Undo what attaching did to the shared server, leaving listeners other\n   * consumers added since (e.g. Vite's HMR upgrade handler) untouched.\n   */\n  private restoreListeners(): void {\n    const server = this.sharedServer;\n\n    if (!server) return;\n\n    const { added, removed } = this.attachedListeners;\n\n    for (const [event, listener] of added) server.removeListener(event, listener);\n    for (const [event, listener] of removed) server.on(event, listener);\n\n    this.attachedListeners = { added: [], removed: [] };\n    this.sharedServer = undefined;\n  }\n}\n"],"mappings":"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"}

package/esm/dev-server/health-checker/checkers/oxlint-health-checker.mjs

@@ -1,5 +1,5 @@
-import { BaseHealthChecker } from "./base-health-checker.mjs";
 import { OxlintRunner } from "../oxlint-runner.mjs";
+import { BaseHealthChecker } from "./base-health-checker.mjs";
 
 //#region ../../packages/core/src/dev-server/health-checker/checkers/oxlint-health-checker.ts
 var OxlintHealthChecker = class extends BaseHealthChecker {

package/esm/dev-server/health-checker/default-health-checkers.mjs

@@ -1,31 +1,17 @@
-import { EslintHealthChecker } from "./checkers/eslint-health-checker.mjs";
 import { findOxlint } from "./oxlint-runner.mjs";
 import { OxlintHealthChecker } from "./checkers/oxlint-health-checker.mjs";
 import { TypescriptHealthChecker } from "./checkers/typescript-health-checker.mjs";
-import path from "node:path";
-import { existsSync } from "node:fs";
 
 //#region ../../packages/core/src/dev-server/health-checker/default-health-checkers.ts
-/** Whether the app has an ESLint flat config at its root. */
-function hasEslint(cwd) {
-	return [
-		"js",
-		"mjs",
-		"cjs",
-		"ts",
-		"mts",
-		"cts"
-	].some((extension) => existsSync(path.join(cwd, `eslint.config.${extension}`)));
-}
 /** Explicit arrays remain custom-only; built-in booleans select among available checkers. */
 function defaultHealthCheckers(options = {}, cwd = process.cwd()) {
+	if ("eslint" in options) throw new Error("ESLint support was removed in 5.34.0. Remove healthCheckers.eslint and use Oxlint/Oxfmt; run npx warlock upgrade --from 5.33 --to 5.34.0.");
 	const checkers = [];
 	if (options.typescript !== false) checkers.push(new TypescriptHealthChecker());
-	if (options.eslint !== false && hasEslint(cwd)) checkers.push(new EslintHealthChecker());
 	if (options.oxlint !== false && findOxlint(cwd)) checkers.push(new OxlintHealthChecker());
 	return checkers;
 }
 
 //#endregion
-export { defaultHealthCheckers, hasEslint };
+export { defaultHealthCheckers };
 //# sourceMappingURL=default-health-checkers.mjs.map

package/esm/dev-server/health-checker/default-health-checkers.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"default-health-checkers.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/health-checker/default-health-checkers.ts"],"sourcesContent":["import { existsSync } from \"node:fs\";\nimport path from \"node:path\";\nimport { EslintHealthChecker } from \"./checkers/eslint-health-checker\";\nimport { OxlintHealthChecker } from \"./checkers/oxlint-health-checker\";\nimport { TypescriptHealthChecker } from \"./checkers/typescript-health-checker\";\nimport type {\n  BuiltInHealthCheckerOptions,\n  FileHealthCheckerContract,\n} from \"./file-health-checker.contract\";\nimport { findOxlint } from \"./oxlint-runner\";\n\n/** Whether the app has an ESLint flat config at its root. */\nexport function hasEslint(cwd: string): boolean {\n  // ESLint is a core dependency, so an app needs only its configuration.\n  return [\"js\", \"mjs\", \"cjs\", \"ts\", \"mts\", \"cts\"].some((extension) =>\n    existsSync(path.join(cwd, `eslint.config.${extension}`)),\n  );\n}\n\n/** Explicit arrays remain custom-only; built-in booleans select among available checkers. */\nexport function defaultHealthCheckers(\n  options: BuiltInHealthCheckerOptions = {},\n  cwd = process.cwd(),\n): FileHealthCheckerContract[] {\n  const checkers: FileHealthCheckerContract[] = [];\n  if (options.typescript !== false) checkers.push(new TypescriptHealthChecker());\n  if (options.eslint !== false && hasEslint(cwd)) checkers.push(new EslintHealthChecker());\n  if (options.oxlint !== false && findOxlint(cwd)) checkers.push(new OxlintHealthChecker());\n  return checkers;\n}\n"],"mappings":";;;;;;;;;AAYA,SAAgB,UAAU,KAAsB;CAE9C,OAAO;EAAC;EAAM;EAAO;EAAO;EAAM;EAAO;CAAK,CAAC,CAAC,MAAM,cACpD,WAAW,KAAK,KAAK,KAAK,iBAAiB,WAAW,CAAC,CACzD;AACF;;AAGA,SAAgB,sBACd,UAAuC,CAAC,GACxC,MAAM,QAAQ,IAAI,GACW;CAC7B,MAAM,WAAwC,CAAC;CAC/C,IAAI,QAAQ,eAAe,OAAO,SAAS,KAAK,IAAI,wBAAwB,CAAC;CAC7E,IAAI,QAAQ,WAAW,SAAS,UAAU,GAAG,GAAG,SAAS,KAAK,IAAI,oBAAoB,CAAC;CACvF,IAAI,QAAQ,WAAW,SAAS,WAAW,GAAG,GAAG,SAAS,KAAK,IAAI,oBAAoB,CAAC;CACxF,OAAO;AACT"}
+{"version":3,"file":"default-health-checkers.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/health-checker/default-health-checkers.ts"],"sourcesContent":["import { OxlintHealthChecker } from \"./checkers/oxlint-health-checker\";\nimport { TypescriptHealthChecker } from \"./checkers/typescript-health-checker\";\nimport type {\n  BuiltInHealthCheckerOptions,\n  FileHealthCheckerContract,\n} from \"./file-health-checker.contract\";\nimport { findOxlint } from \"./oxlint-runner\";\n\n/** Explicit arrays remain custom-only; built-in booleans select among available checkers. */\nexport function defaultHealthCheckers(\n  options: BuiltInHealthCheckerOptions = {},\n  cwd = process.cwd(),\n): FileHealthCheckerContract[] {\n  if (\"eslint\" in options)\n    throw new Error(\n      \"ESLint support was removed in 5.34.0. Remove healthCheckers.eslint and use Oxlint/Oxfmt; run npx warlock upgrade --from 5.33 --to 5.34.0.\",\n    );\n  const checkers: FileHealthCheckerContract[] = [];\n  if (options.typescript !== false) checkers.push(new TypescriptHealthChecker());\n  if (options.oxlint !== false && findOxlint(cwd)) checkers.push(new OxlintHealthChecker());\n  return checkers;\n}\n"],"mappings":";;;;;;AASA,SAAgB,sBACd,UAAuC,CAAC,GACxC,MAAM,QAAQ,IAAI,GACW;CAC7B,IAAI,YAAY,SACd,MAAM,IAAI,MACR,2IACF;CACF,MAAM,WAAwC,CAAC;CAC/C,IAAI,QAAQ,eAAe,OAAO,SAAS,KAAK,IAAI,wBAAwB,CAAC;CAC7E,IAAI,QAAQ,WAAW,SAAS,WAAW,GAAG,GAAG,SAAS,KAAK,IAAI,oBAAoB,CAAC;CACxF,OAAO;AACT"}

package/esm/dev-server/health-checker/file-health-checker.contract.d.mts

@@ -59,10 +59,9 @@ export interface FileHealthCheckerContract {
    */
   stats(): Promise<HealthCheckerFilesStats>;
 }
-/** Select built-in background checks; installed/configured linters run by default. */
+/** Select background checks; TypeScript and configured Oxlint run by default. */
 export type BuiltInHealthCheckerOptions = {
   typescript?: boolean;
-  eslint?: boolean;
   oxlint?: boolean;
 };
 //#endregion

package/esm/dev-server/health-checker/file-health-checker.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"file-health-checker.contract.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/health-checker/file-health-checker.contract.ts"],"mappings":";;;YAGY;EACV;EACA;IACE;IACA;;EAEF;IACE;IACA;;EAEF;IACE;IACA;;;iBAIa;;;;EAIf;;;;;;;;;;;;;;EAeA;;;;;EAMA;;EAGA,oBAAoB;;;;EAKpB,cAAc,OAAO,gBAAgB;;;;EAKrC,WAAW,MAAM;;;;EAKjB,MAAM,MAAM,cAAc,QAAQ;;;;EAKlC,SAAS,QAAQ;;;YAIP;EACV;EACA;EACA"}
+{"version":3,"file":"file-health-checker.contract.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/health-checker/file-health-checker.contract.ts"],"mappings":";;;YAGY;EACV;EACA;IACE;IACA;;EAEF;IACE;IACA;;EAEF;IACE;IACA;;;iBAIa;;;;EAIf;;;;;;;;;;;;;;EAeA;;;;;EAMA;;EAGA,oBAAoB;;;;EAKpB,cAAc,OAAO,gBAAgB;;;;EAKrC,WAAW,MAAM;;;;EAKjB,MAAM,MAAM,cAAc,QAAQ;;;;EAKlC,SAAS,QAAQ;;;YAIP;EACV;EACA"}

package/esm/dev-server/health-checker/file-health-result.d.mts

@@ -35,7 +35,7 @@ type FileHealthMessage = {
    */
   length?: number;
   /**
-   * Rule ID (for ESLint)
+   * Linter rule ID
    */
   ruleId?: string;
 };

package/esm/dev-server/health-checker/file-health-result.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"file-health-result.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/health-checker/file-health-result.ts"],"sourcesContent":["type FileHealthStats = {\n  /**\n   * File Health State\n   */\n  state: \"healthy\" | \"defective\";\n  /**\n   * Number of errors\n   */\n  errors: number;\n  /**\n   * Number of warnings\n   */\n  warnings: number;\n};\n\ntype FileHealthMessage = {\n  /**\n   * Message\n   */\n  message: string;\n  /**\n   * Type of the message\n   */\n  type: \"error\" | \"warning\";\n  /**\n   * Line number\n   */\n  lineNumber: number;\n  /**\n   * Column number\n   */\n  columnNumber: number;\n  /**\n   * Length of the error/warning span\n   */\n  length?: number;\n  /**\n   * Rule ID (for ESLint)\n   */\n  ruleId?: string;\n};\n\nexport class FileHealthResult {\n  /**\n   * Result of the health check\n   */\n  public result: \"healthy\" | \"defective\" = \"healthy\";\n\n  /**\n   * Messages list (either for errors or warnings)\n   */\n  public messages: FileHealthMessage[] = [];\n\n  /**\n   * Mark as healthy\n   */\n  public markAsHealthy(): void {\n    this.result = \"healthy\";\n  }\n\n  /**\n   * Add errors\n   */\n  public addErrors(messages: FileHealthMessage[]): void {\n    this.result = \"defective\";\n    this.messages.push(...messages);\n  }\n\n  /**\n   * Add warnings\n   */\n  public addWarnings(messages: FileHealthMessage[]): void {\n    this.result = \"defective\";\n    this.messages.push(...messages);\n  }\n\n  /**\n   * Get file health stats\n   */\n  public getStats(): FileHealthStats {\n    return {\n      state: this.result,\n      errors: this.messages.filter((message) => message.type === \"error\").length,\n      warnings: this.messages.filter((message) => message.type === \"warning\").length,\n    };\n  }\n}\n"],"mappings":";AA0CA,IAAa,mBAAb,MAA8B;;gBAIa;kBAKF,CAAC;;;;;CAKxC,AAAO,gBAAsB;EAC3B,KAAK,SAAS;CAChB;;;;CAKA,AAAO,UAAU,UAAqC;EACpD,KAAK,SAAS;EACd,KAAK,SAAS,KAAK,GAAG,QAAQ;CAChC;;;;CAKA,AAAO,YAAY,UAAqC;EACtD,KAAK,SAAS;EACd,KAAK,SAAS,KAAK,GAAG,QAAQ;CAChC;;;;CAKA,AAAO,WAA4B;EACjC,OAAO;GACL,OAAO,KAAK;GACZ,QAAQ,KAAK,SAAS,QAAQ,YAAY,QAAQ,SAAS,OAAO,CAAC,CAAC;GACpE,UAAU,KAAK,SAAS,QAAQ,YAAY,QAAQ,SAAS,SAAS,CAAC,CAAC;EAC1E;CACF;AACF"}
+{"version":3,"file":"file-health-result.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/dev-server/health-checker/file-health-result.ts"],"sourcesContent":["type FileHealthStats = {\n  /**\n   * File Health State\n   */\n  state: \"healthy\" | \"defective\";\n  /**\n   * Number of errors\n   */\n  errors: number;\n  /**\n   * Number of warnings\n   */\n  warnings: number;\n};\n\ntype FileHealthMessage = {\n  /**\n   * Message\n   */\n  message: string;\n  /**\n   * Type of the message\n   */\n  type: \"error\" | \"warning\";\n  /**\n   * Line number\n   */\n  lineNumber: number;\n  /**\n   * Column number\n   */\n  columnNumber: number;\n  /**\n   * Length of the error/warning span\n   */\n  length?: number;\n  /**\n   * Linter rule ID\n   */\n  ruleId?: string;\n};\n\nexport class FileHealthResult {\n  /**\n   * Result of the health check\n   */\n  public result: \"healthy\" | \"defective\" = \"healthy\";\n\n  /**\n   * Messages list (either for errors or warnings)\n   */\n  public messages: FileHealthMessage[] = [];\n\n  /**\n   * Mark as healthy\n   */\n  public markAsHealthy(): void {\n    this.result = \"healthy\";\n  }\n\n  /**\n   * Add errors\n   */\n  public addErrors(messages: FileHealthMessage[]): void {\n    this.result = \"defective\";\n    this.messages.push(...messages);\n  }\n\n  /**\n   * Add warnings\n   */\n  public addWarnings(messages: FileHealthMessage[]): void {\n    this.result = \"defective\";\n    this.messages.push(...messages);\n  }\n\n  /**\n   * Get file health stats\n   */\n  public getStats(): FileHealthStats {\n    return {\n      state: this.result,\n      errors: this.messages.filter((message) => message.type === \"error\").length,\n      warnings: this.messages.filter((message) => message.type === \"warning\").length,\n    };\n  }\n}\n"],"mappings":";AA0CA,IAAa,mBAAb,MAA8B;;gBAIa;kBAKF,CAAC;;;;;CAKxC,AAAO,gBAAsB;EAC3B,KAAK,SAAS;CAChB;;;;CAKA,AAAO,UAAU,UAAqC;EACpD,KAAK,SAAS;EACd,KAAK,SAAS,KAAK,GAAG,QAAQ;CAChC;;;;CAKA,AAAO,YAAY,UAAqC;EACtD,KAAK,SAAS;EACd,KAAK,SAAS,KAAK,GAAG,QAAQ;CAChC;;;;CAKA,AAAO,WAA4B;EACjC,OAAO;GACL,OAAO,KAAK;GACZ,QAAQ,KAAK,SAAS,QAAQ,YAAY,QAAQ,SAAS,OAAO,CAAC,CAAC;GACpE,UAAU,KAAK,SAAS,QAAQ,YAAY,QAAQ,SAAS,SAAS,CAAC,CAAC;EAC1E;CACF;AACF"}

package/esm/e2e/browser.d.mts

@@ -0,0 +1,4 @@
+//#region ../../packages/core/src/e2e/browser.d.ts
+export declare function findBrowserBinary(override?: string | undefined): Promise<string | undefined>;
+//#endregion
+//# sourceMappingURL=browser.d.mts.map

package/esm/e2e/browser.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/e2e/browser.ts"],"mappings":";wBA2CsB,kBACpB,gCACC"}

package/esm/e2e/browser.mjs

@@ -0,0 +1,88 @@
+import { CdpConnection } from "./cdp.mjs";
+import { OwnedProcess } from "./owned-process.mjs";
+import { isolatedEnvironment } from "./fixture.mjs";
+import { delimiter, join, resolve } from "node:path";
+import { constants } from "node:fs";
+import { access, mkdir, readFile } from "node:fs/promises";
+import { setTimeout } from "node:timers/promises";
+
+//#region ../../packages/core/src/e2e/browser.ts
+function browserCandidates(platform, env) {
+	const names = platform === "win32" ? ["chrome.exe", "msedge.exe"] : [
+		"google-chrome",
+		"google-chrome-stable",
+		"chromium",
+		"chromium-browser",
+		"microsoft-edge",
+		"microsoft-edge-stable"
+	];
+	const paths = (env.PATH ?? "").split(platform === "win32" ? ";" : delimiter).filter(Boolean).flatMap((path) => names.map((name) => join(path, name)));
+	if (platform === "darwin") paths.push("/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge", join(env.HOME ?? "", "Applications/Google Chrome.app/Contents/MacOS/Google Chrome"), join(env.HOME ?? "", "Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge"));
+	if (platform === "win32") for (const root of [
+		env.PROGRAMFILES,
+		env["PROGRAMFILES(X86)"],
+		env.LOCALAPPDATA
+	].filter((path) => Boolean(path))) paths.push(join(root, "Google", "Chrome", "Application", "chrome.exe"), join(root, "Microsoft", "Edge", "Application", "msedge.exe"));
+	return paths;
+}
+async function findBrowserBinary(override = process.env.WARLOCK_E2E_BROWSER) {
+	const candidates = override ? [resolve(override)] : browserCandidates(process.platform, process.env);
+	for (const candidate of candidates) try {
+		await access(candidate, process.platform === "win32" ? constants.F_OK : constants.X_OK);
+		return candidate;
+	} catch {}
+	if (override) throw new Error(`Browser override is not executable: ${override}`);
+}
+var OwnedBrowser = class {
+	constructor(root, evidence) {
+		this.root = root;
+		this.evidence = evidence;
+	}
+	async start(options = {}, signal) {
+		const binary = await findBrowserBinary(options.binary);
+		if (!binary) throw new Error("No Chrome or Edge binary found. Install one or set --browser / WARLOCK_E2E_BROWSER to its executable path.");
+		if (options.args?.some((arg) => !arg.startsWith("--") || /^--(?:user-data-dir|remote-debugging|headless)/.test(arg))) throw new Error("Browser args must be flags and cannot replace the owned profile, debugging endpoint, or headless mode");
+		const profile = join(this.root, "browser-profile");
+		await mkdir(profile, { recursive: true });
+		this.process = await OwnedProcess.start("browser", [
+			binary,
+			"--headless",
+			"--remote-debugging-port=0",
+			`--user-data-dir=${profile}`,
+			...options.args ?? [],
+			"about:blank"
+		], this.root, isolatedEnvironment(this.root, {}), this.root, this.evidence.processes, (owned) => {
+			this.process = owned;
+		});
+		const deadline = Date.now() + 15e3;
+		let reason = "DevToolsActivePort is not ready";
+		while (Date.now() < deadline) {
+			signal?.throwIfAborted();
+			this.process.assertRunning();
+			try {
+				const port = Number((await readFile(join(profile, "DevToolsActivePort"), "utf8")).split("\n")[0]);
+				if (!Number.isInteger(port) || port <= 0 || port > 65535) throw new Error("Invalid owned browser debugging port");
+				const response = await fetch(`http://127.0.0.1:${port}/json/list`, { signal: AbortSignal.timeout(1e3) });
+				if (!response.ok) throw new Error(`CDP discovery returned HTTP ${response.status}`);
+				const target = (await response.json()).find((candidate) => candidate.type === "page" && candidate.url === "about:blank");
+				if (!target?.webSocketDebuggerUrl) throw new Error("Owned browser has no about:blank page target");
+				const endpoint = new URL(target.webSocketDebuggerUrl);
+				if (endpoint.protocol !== "ws:" || endpoint.hostname !== "127.0.0.1" || Number(endpoint.port) !== port) throw new Error("CDP discovery returned a non-owned endpoint");
+				this.connection = await CdpConnection.connect(endpoint.href);
+				return this.connection;
+			} catch (error) {
+				reason = String(error);
+				await setTimeout(50);
+			}
+		}
+		throw new Error(`Browser startup timed out: ${reason}\n${this.process.logs().slice(-8e3)}`);
+	}
+	async stop() {
+		this.connection?.close();
+		await this.process?.stop();
+	}
+};
+
+//#endregion
+export { OwnedBrowser, browserCandidates, findBrowserBinary };
+//# sourceMappingURL=browser.mjs.map

package/esm/e2e/browser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.mjs","names":["delay"],"sources":["../../../../../../../../packages/core/src/e2e/browser.ts"],"sourcesContent":["import { constants } from \"node:fs\";\nimport { access, mkdir, readFile } from \"node:fs/promises\";\nimport { delimiter, join, resolve } from \"node:path\";\nimport { setTimeout as delay } from \"node:timers/promises\";\nimport { CdpConnection } from \"./cdp\";\nimport { isolatedEnvironment } from \"./fixture\";\nimport { OwnedProcess } from \"./owned-process\";\nimport type { BrowserOptions, E2EEvidence } from \"./types\";\n\nexport function browserCandidates(platform: NodeJS.Platform, env: NodeJS.ProcessEnv): string[] {\n  const names =\n    platform === \"win32\"\n      ? [\"chrome.exe\", \"msedge.exe\"]\n      : [\n          \"google-chrome\",\n          \"google-chrome-stable\",\n          \"chromium\",\n          \"chromium-browser\",\n          \"microsoft-edge\",\n          \"microsoft-edge-stable\",\n        ];\n  const paths = (env.PATH ?? \"\")\n    .split(platform === \"win32\" ? \";\" : delimiter)\n    .filter(Boolean)\n    .flatMap((path) => names.map((name) => join(path, name)));\n  if (platform === \"darwin\")\n    paths.push(\n      \"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome\",\n      \"/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge\",\n      join(env.HOME ?? \"\", \"Applications/Google Chrome.app/Contents/MacOS/Google Chrome\"),\n      join(env.HOME ?? \"\", \"Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge\"),\n    );\n  if (platform === \"win32\")\n    for (const root of [env.PROGRAMFILES, env[\"PROGRAMFILES(X86)\"], env.LOCALAPPDATA].filter(\n      (path): path is string => Boolean(path),\n    ))\n      paths.push(\n        join(root, \"Google\", \"Chrome\", \"Application\", \"chrome.exe\"),\n        join(root, \"Microsoft\", \"Edge\", \"Application\", \"msedge.exe\"),\n      );\n  return paths;\n}\n\nexport async function findBrowserBinary(\n  override = process.env.WARLOCK_E2E_BROWSER,\n): Promise<string | undefined> {\n  const candidates = override\n    ? [resolve(override)]\n    : browserCandidates(process.platform, process.env);\n  for (const candidate of candidates) {\n    try {\n      await access(candidate, process.platform === \"win32\" ? constants.F_OK : constants.X_OK);\n      return candidate;\n    } catch {\n      /* Try the next known installation. */\n    }\n  }\n  if (override) throw new Error(`Browser override is not executable: ${override}`);\n  return undefined;\n}\n\nexport class OwnedBrowser {\n  connection?: CdpConnection;\n  process?: OwnedProcess;\n  constructor(\n    private root: string,\n    private evidence: E2EEvidence,\n  ) {}\n\n  async start(options: BrowserOptions = {}, signal?: AbortSignal): Promise<CdpConnection> {\n    const binary = await findBrowserBinary(options.binary);\n    if (!binary)\n      throw new Error(\n        \"No Chrome or Edge binary found. Install one or set --browser / WARLOCK_E2E_BROWSER to its executable path.\",\n      );\n    if (\n      options.args?.some(\n        (arg) =>\n          !arg.startsWith(\"--\") || /^--(?:user-data-dir|remote-debugging|headless)/.test(arg),\n      )\n    )\n      throw new Error(\n        \"Browser args must be flags and cannot replace the owned profile, debugging endpoint, or headless mode\",\n      );\n    const profile = join(this.root, \"browser-profile\");\n    await mkdir(profile, { recursive: true });\n    // Headless flag: https://developer.chrome.com/docs/chromium/headless\n    // Port 0 and discovery: https://chromedevtools.github.io/devtools-protocol/#how-do-i-access-the-browser-target\n    // Profile required by Chrome 136+: https://developer.chrome.com/blog/remote-debugging-port\n    this.process = await OwnedProcess.start(\n      \"browser\",\n      [\n        binary,\n        \"--headless\",\n        \"--remote-debugging-port=0\",\n        `--user-data-dir=${profile}`,\n        ...(options.args ?? []),\n        \"about:blank\",\n      ],\n      this.root,\n      isolatedEnvironment(this.root, {}),\n      this.root,\n      this.evidence.processes,\n      (owned) => {\n        this.process = owned;\n      },\n    );\n    const deadline = Date.now() + 15_000;\n    let reason = \"DevToolsActivePort is not ready\";\n    while (Date.now() < deadline) {\n      signal?.throwIfAborted();\n      this.process.assertRunning();\n      try {\n        const port = Number(\n          (await readFile(join(profile, \"DevToolsActivePort\"), \"utf8\")).split(\"\\n\")[0],\n        );\n        if (!Number.isInteger(port) || port <= 0 || port > 65535)\n          throw new Error(\"Invalid owned browser debugging port\");\n        // HTTP discovery endpoints: https://chromedevtools.github.io/devtools-protocol/#http-endpoints\n        const response = await fetch(`http://127.0.0.1:${port}/json/list`, {\n          signal: AbortSignal.timeout(1000),\n        });\n        if (!response.ok) throw new Error(`CDP discovery returned HTTP ${response.status}`);\n        const targets = (await response.json()) as {\n          type: string;\n          url: string;\n          webSocketDebuggerUrl?: string;\n        }[];\n        const target = targets.find(\n          (candidate) => candidate.type === \"page\" && candidate.url === \"about:blank\",\n        );\n        if (!target?.webSocketDebuggerUrl)\n          throw new Error(\"Owned browser has no about:blank page target\");\n        const endpoint = new URL(target.webSocketDebuggerUrl);\n        if (\n          endpoint.protocol !== \"ws:\" ||\n          endpoint.hostname !== \"127.0.0.1\" ||\n          Number(endpoint.port) !== port\n        )\n          throw new Error(\"CDP discovery returned a non-owned endpoint\");\n        this.connection = await CdpConnection.connect(endpoint.href);\n        return this.connection;\n      } catch (error) {\n        reason = String(error);\n        await delay(50);\n      }\n    }\n    throw new Error(`Browser startup timed out: ${reason}\\n${this.process.logs().slice(-8000)}`);\n  }\n\n  async stop(): Promise<void> {\n    this.connection?.close();\n    await this.process?.stop();\n  }\n}\n"],"mappings":"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"}

package/esm/e2e/cdp.d.mts

@@ -0,0 +1,152 @@
+//#region ../../packages/core/src/e2e/cdp.d.ts
+/** Wire shapes verified against the official protocol viewer and its source JSON:
+ * https://chromedevtools.github.io/devtools-protocol/
+ * https://github.com/ChromeDevTools/devtools-protocol/tree/master/json
+ * Only the fields consumed by this harness are modeled here.
+ */
+type RemoteObject = {
+  value?: unknown;
+  description?: string;
+};
+type ExceptionDetails = {
+  text: string;
+  exception?: RemoteObject;
+};
+export type CdpMethods = {
+  "Runtime.enable": {
+    params: Record<string, never>;
+    result: Record<string, never>;
+  };
+  "Runtime.evaluate": {
+    params: {
+      expression: string;
+      returnByValue: boolean;
+      awaitPromise: boolean;
+      silent: boolean;
+    };
+    result: {
+      result: RemoteObject;
+      exceptionDetails?: ExceptionDetails;
+    };
+  };
+  "Page.enable": {
+    params: Record<string, never>;
+    result: Record<string, never>;
+  };
+  "Page.navigate": {
+    params: {
+      url: string;
+    };
+    result: {
+      frameId: string;
+      loaderId?: string;
+      errorText?: string;
+    };
+  };
+  "Page.captureScreenshot": {
+    params: {
+      format: "png";
+    };
+    result: {
+      data: string;
+    };
+  };
+  "Emulation.setDeviceMetricsOverride": {
+    params: {
+      width: number;
+      height: number;
+      deviceScaleFactor: number;
+      mobile: boolean;
+    };
+    result: Record<string, never>;
+  };
+  "Input.dispatchMouseEvent": {
+    params: {
+      type: "mouseMoved" | "mousePressed" | "mouseReleased";
+      x: number;
+      y: number;
+      button?: "left";
+      buttons?: number;
+      clickCount?: number;
+    };
+    result: Record<string, never>;
+  };
+  "Input.insertText": {
+    params: {
+      text: string;
+    };
+    result: Record<string, never>;
+  };
+  "Input.dispatchKeyEvent": {
+    params: {
+      type: "keyDown" | "keyUp";
+      key: string;
+      code: string;
+      windowsVirtualKeyCode: number;
+    };
+    result: Record<string, never>;
+  };
+  "Network.enable": {
+    params: Record<string, never>;
+    result: Record<string, never>;
+  };
+  "Log.enable": {
+    params: Record<string, never>;
+    result: Record<string, never>;
+  };
+};
+export type CdpEvents = {
+  "Page.loadEventFired": {
+    timestamp: number;
+  };
+  "Runtime.consoleAPICalled": {
+    type: string;
+    args: RemoteObject[];
+  };
+  "Runtime.exceptionThrown": {
+    exceptionDetails: ExceptionDetails;
+  };
+  "Log.entryAdded": {
+    entry: {
+      level: string;
+      text: string;
+    };
+  };
+  "Network.requestWillBeSent": {
+    requestId: string;
+    request: {
+      url: string;
+    };
+  };
+  "Network.responseReceived": {
+    requestId: string;
+    response: {
+      url: string;
+      status: number;
+    };
+  };
+  "Network.loadingFailed": {
+    requestId: string;
+    errorText: string;
+    canceled?: boolean;
+  };
+  "Network.loadingFinished": {
+    requestId: string;
+  };
+};
+export declare class CdpConnection {
+  private socket;
+  private sequence;
+  private pending;
+  private listeners;
+  private closed;
+  private constructor();
+  static connect(url: string, timeoutMs?: number): Promise<CdpConnection>;
+  command<K extends keyof CdpMethods>(method: K, params: CdpMethods[K]["params"], timeoutMs?: number): Promise<CdpMethods[K]["result"]>;
+  on<K extends keyof CdpEvents>(method: K, listener: (params: CdpEvents[K]) => void): () => void;
+  private fail;
+  close(): void;
+}
+//#endregion
+export {};
+//# sourceMappingURL=cdp.d.mts.map

package/esm/e2e/cdp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.d.mts","names":[],"sources":["../../../../../../../../packages/core/src/e2e/cdp.ts"],"mappings":";;;;;;KAKK;EAAiB;EAAiB;;KAClC;EAAqB;EAAc,YAAY;;YACxC;EAEV;IAAoB,QAAQ;IAAuB,QAAQ;;EAE3D;IACE;MAAU;MAAoB;MAAwB;MAAuB;;IAC7E;MAAU,QAAQ;MAAc,mBAAmB;;;EAGrD;IAAiB,QAAQ;IAAuB,QAAQ;;EAExD;IACE;MAAU;;IACV;MAAU;MAAiB;MAAmB;;;EAGhD;IAA4B;MAAU;;IAAiB;MAAU;;;EAEjE;IACE;MAAU;MAAe;MAAgB;MAA2B;;IACpE,QAAQ;;EAGV;IACE;MACE;MACA;MACA;MACA;MACA;MACA;;IAEF,QAAQ;;EAGV;IAAsB;MAAU;;IAAgB,QAAQ;;EAExD;IACE;MAAU;MAA2B;MAAa;MAAc;;IAChE,QAAQ;;EAGV;IAAoB,QAAQ;IAAuB,QAAQ;;EAE3D;IAAgB,QAAQ;IAAuB,QAAQ;;;YAE7C;EAEV;IAAyB;;EAEzB;IAA8B;IAAc,MAAM;;EAElD;IAA6B,kBAAkB;;EAE/C;IAAoB;MAAS;MAAe;;;EAE5C;IAA+B;IAAmB;MAAW;;;EAE7D;IAA8B;IAAmB;MAAY;MAAa;;;EAE1E;IAA2B;IAAmB;IAAmB;;EAEjE;IAA6B;;;qBAQlB;UAMiB;UALpB;UACA;UACA;UACA;UAED;SA4BM,QAAQ,aAAa,qBAAqB,QAAQ;EAiC/D,QAAQ,gBAAgB,YACtB,QAAQ,GACR,QAAQ,WAAW,cACnB,qBACC,QAAQ,WAAW;EA0BtB,GAAG,gBAAgB,WAAW,QAAQ,GAAG,WAAW,QAAQ,UAAU;UAU9D;EASR"}

package/esm/e2e/cdp.mjs

@@ -0,0 +1,106 @@
+//#region ../../packages/core/src/e2e/cdp.ts
+var CdpConnection = class CdpConnection {
+	constructor(socket) {
+		this.socket = socket;
+		this.sequence = 0;
+		this.pending = /* @__PURE__ */ new Map();
+		this.listeners = /* @__PURE__ */ new Map();
+		this.closed = false;
+		socket.addEventListener("message", ({ data }) => {
+			try {
+				const message = JSON.parse(String(data));
+				if (typeof message.id === "number") {
+					const pending = this.pending.get(message.id);
+					if (!pending) return;
+					clearTimeout(pending.timer);
+					this.pending.delete(message.id);
+					if (message.error) pending.reject(/* @__PURE__ */ new Error(`CDP: ${message.error.message}`));
+					else pending.resolve(message.result);
+				} else if (message.method) for (const listener of this.listeners.get(message.method) ?? []) listener(message.params);
+			} catch (error) {
+				this.fail(/* @__PURE__ */ new Error(`Invalid CDP message: ${String(error)}`));
+			}
+		});
+		socket.addEventListener("close", () => this.fail(/* @__PURE__ */ new Error("CDP connection closed")));
+		socket.addEventListener("error", () => this.fail(/* @__PURE__ */ new Error("CDP WebSocket error")));
+	}
+	static async connect(url, timeoutMs = 1e4) {
+		if (typeof WebSocket !== "function") throw new Error("Browser e2e requires Node's global WebSocket (Node >=22.15, without --no-experimental-websocket)");
+		const socket = new WebSocket(url);
+		const connection = new CdpConnection(socket);
+		await new Promise((resolve, reject) => {
+			const cleanup = () => {
+				clearTimeout(timer);
+				socket.removeEventListener("open", opened);
+				socket.removeEventListener("error", failed);
+				socket.removeEventListener("close", failed);
+			};
+			const opened = () => {
+				cleanup();
+				resolve();
+			};
+			const failed = () => {
+				cleanup();
+				socket.close();
+				reject(/* @__PURE__ */ new Error(`Cannot connect to owned browser CDP endpoint ${url}`));
+			};
+			const timer = setTimeout(failed, timeoutMs);
+			socket.addEventListener("open", opened, { once: true });
+			socket.addEventListener("error", failed, { once: true });
+			socket.addEventListener("close", failed, { once: true });
+		});
+		return connection;
+	}
+	command(method, params, timeoutMs = 1e4) {
+		if (this.closed) return Promise.reject(/* @__PURE__ */ new Error(`CDP closed before ${method}`));
+		return new Promise((resolve, reject) => {
+			const id = ++this.sequence;
+			const timer = setTimeout(() => {
+				this.pending.delete(id);
+				reject(/* @__PURE__ */ new Error(`CDP timeout after ${timeoutMs}ms: ${method}`));
+			}, Math.max(1, timeoutMs));
+			this.pending.set(id, {
+				resolve: (value) => resolve(value),
+				reject,
+				timer
+			});
+			try {
+				this.socket.send(JSON.stringify({
+					id,
+					method,
+					params
+				}));
+			} catch (error) {
+				clearTimeout(timer);
+				this.pending.delete(id);
+				reject(error);
+			}
+		});
+	}
+	on(method, listener) {
+		const wrapped = (params) => listener(params);
+		const listeners = this.listeners.get(method) ?? /* @__PURE__ */ new Set();
+		listeners.add(wrapped);
+		this.listeners.set(method, listeners);
+		return () => {
+			listeners.delete(wrapped);
+		};
+	}
+	fail(error) {
+		this.closed = true;
+		for (const pending of this.pending.values()) {
+			clearTimeout(pending.timer);
+			pending.reject(error);
+		}
+		this.pending.clear();
+	}
+	close() {
+		this.fail(/* @__PURE__ */ new Error("CDP connection closed by harness"));
+		this.listeners.clear();
+		this.socket.close();
+	}
+};
+
+//#endregion
+export { CdpConnection };
+//# sourceMappingURL=cdp.mjs.map

package/esm/e2e/cdp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp.mjs","names":[],"sources":["../../../../../../../../packages/core/src/e2e/cdp.ts"],"sourcesContent":["/** Wire shapes verified against the official protocol viewer and its source JSON:\n * https://chromedevtools.github.io/devtools-protocol/\n * https://github.com/ChromeDevTools/devtools-protocol/tree/master/json\n * Only the fields consumed by this harness are modeled here.\n */\ntype RemoteObject = { value?: unknown; description?: string };\ntype ExceptionDetails = { text: string; exception?: RemoteObject };\nexport type CdpMethods = {\n  // https://chromedevtools.github.io/devtools-protocol/tot/Runtime/#method-enable\n  \"Runtime.enable\": { params: Record<string, never>; result: Record<string, never> };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Runtime/#method-evaluate\n  \"Runtime.evaluate\": {\n    params: { expression: string; returnByValue: boolean; awaitPromise: boolean; silent: boolean };\n    result: { result: RemoteObject; exceptionDetails?: ExceptionDetails };\n  };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-enable\n  \"Page.enable\": { params: Record<string, never>; result: Record<string, never> };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-navigate\n  \"Page.navigate\": {\n    params: { url: string };\n    result: { frameId: string; loaderId?: string; errorText?: string };\n  };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Page/#method-captureScreenshot\n  \"Page.captureScreenshot\": { params: { format: \"png\" }; result: { data: string } };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Emulation/#method-setDeviceMetricsOverride\n  \"Emulation.setDeviceMetricsOverride\": {\n    params: { width: number; height: number; deviceScaleFactor: number; mobile: boolean };\n    result: Record<string, never>;\n  };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Input/#method-dispatchMouseEvent\n  \"Input.dispatchMouseEvent\": {\n    params: {\n      type: \"mouseMoved\" | \"mousePressed\" | \"mouseReleased\";\n      x: number;\n      y: number;\n      button?: \"left\";\n      buttons?: number;\n      clickCount?: number;\n    };\n    result: Record<string, never>;\n  };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Input/#method-insertText\n  \"Input.insertText\": { params: { text: string }; result: Record<string, never> };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Input/#method-dispatchKeyEvent\n  \"Input.dispatchKeyEvent\": {\n    params: { type: \"keyDown\" | \"keyUp\"; key: string; code: string; windowsVirtualKeyCode: number };\n    result: Record<string, never>;\n  };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Network/#method-enable\n  \"Network.enable\": { params: Record<string, never>; result: Record<string, never> };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Log/#method-enable\n  \"Log.enable\": { params: Record<string, never>; result: Record<string, never> };\n};\nexport type CdpEvents = {\n  // https://chromedevtools.github.io/devtools-protocol/tot/Page/#event-loadEventFired\n  \"Page.loadEventFired\": { timestamp: number };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Runtime/#event-consoleAPICalled\n  \"Runtime.consoleAPICalled\": { type: string; args: RemoteObject[] };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Runtime/#event-exceptionThrown\n  \"Runtime.exceptionThrown\": { exceptionDetails: ExceptionDetails };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Log/#event-entryAdded\n  \"Log.entryAdded\": { entry: { level: string; text: string } };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Network/#event-requestWillBeSent\n  \"Network.requestWillBeSent\": { requestId: string; request: { url: string } };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Network/#event-responseReceived\n  \"Network.responseReceived\": { requestId: string; response: { url: string; status: number } };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Network/#event-loadingFailed\n  \"Network.loadingFailed\": { requestId: string; errorText: string; canceled?: boolean };\n  // https://chromedevtools.github.io/devtools-protocol/tot/Network/#event-loadingFinished\n  \"Network.loadingFinished\": { requestId: string };\n};\ntype Pending = {\n  resolve: (value: unknown) => void;\n  reject: (error: Error) => void;\n  timer: ReturnType<typeof setTimeout>;\n};\n\nexport class CdpConnection {\n  private sequence = 0;\n  private pending = new Map<number, Pending>();\n  private listeners = new Map<string, Set<(params: unknown) => void>>();\n  private closed = false;\n\n  private constructor(private socket: WebSocket) {\n    socket.addEventListener(\"message\", ({ data }) => {\n      try {\n        const message = JSON.parse(String(data)) as {\n          id?: number;\n          method?: string;\n          params?: unknown;\n          result?: unknown;\n          error?: { message: string };\n        };\n        if (typeof message.id === \"number\") {\n          const pending = this.pending.get(message.id);\n          if (!pending) return;\n          clearTimeout(pending.timer);\n          this.pending.delete(message.id);\n          if (message.error) pending.reject(new Error(`CDP: ${message.error.message}`));\n          else pending.resolve(message.result);\n        } else if (message.method) {\n          for (const listener of this.listeners.get(message.method) ?? []) listener(message.params);\n        }\n      } catch (error) {\n        this.fail(new Error(`Invalid CDP message: ${String(error)}`));\n      }\n    });\n    socket.addEventListener(\"close\", () => this.fail(new Error(\"CDP connection closed\")));\n    socket.addEventListener(\"error\", () => this.fail(new Error(\"CDP WebSocket error\")));\n  }\n\n  static async connect(url: string, timeoutMs = 10_000): Promise<CdpConnection> {\n    // Stable since Node 22.4, present in the minimum supported Node 22.15.\n    // https://nodejs.org/download/release/v22.15.0/docs/api/globals.html#websocket\n    if (typeof WebSocket !== \"function\")\n      throw new Error(\n        \"Browser e2e requires Node's global WebSocket (Node >=22.15, without --no-experimental-websocket)\",\n      );\n    const socket = new WebSocket(url);\n    const connection = new CdpConnection(socket);\n    await new Promise<void>((resolve, reject) => {\n      const cleanup = () => {\n        clearTimeout(timer);\n        socket.removeEventListener(\"open\", opened);\n        socket.removeEventListener(\"error\", failed);\n        socket.removeEventListener(\"close\", failed);\n      };\n      const opened = () => {\n        cleanup();\n        resolve();\n      };\n      const failed = () => {\n        cleanup();\n        socket.close();\n        reject(new Error(`Cannot connect to owned browser CDP endpoint ${url}`));\n      };\n      const timer = setTimeout(failed, timeoutMs);\n      socket.addEventListener(\"open\", opened, { once: true });\n      socket.addEventListener(\"error\", failed, { once: true });\n      socket.addEventListener(\"close\", failed, { once: true });\n    });\n    return connection;\n  }\n\n  command<K extends keyof CdpMethods>(\n    method: K,\n    params: CdpMethods[K][\"params\"],\n    timeoutMs = 10_000,\n  ): Promise<CdpMethods[K][\"result\"]> {\n    if (this.closed) return Promise.reject(new Error(`CDP closed before ${method}`));\n    return new Promise<CdpMethods[K][\"result\"]>((resolve, reject) => {\n      const id = ++this.sequence;\n      const timer = setTimeout(\n        () => {\n          this.pending.delete(id);\n          reject(new Error(`CDP timeout after ${timeoutMs}ms: ${method}`));\n        },\n        Math.max(1, timeoutMs),\n      );\n      this.pending.set(id, {\n        resolve: (value) => resolve(value as CdpMethods[K][\"result\"]),\n        reject,\n        timer,\n      });\n      try {\n        this.socket.send(JSON.stringify({ id, method, params }));\n      } catch (error) {\n        clearTimeout(timer);\n        this.pending.delete(id);\n        reject(error);\n      }\n    });\n  }\n\n  on<K extends keyof CdpEvents>(method: K, listener: (params: CdpEvents[K]) => void): () => void {\n    const wrapped = (params: unknown) => listener(params as CdpEvents[K]);\n    const listeners = this.listeners.get(method) ?? new Set();\n    listeners.add(wrapped);\n    this.listeners.set(method, listeners);\n    return () => {\n      listeners.delete(wrapped);\n    };\n  }\n\n  private fail(error: Error): void {\n    this.closed = true;\n    for (const pending of this.pending.values()) {\n      clearTimeout(pending.timer);\n      pending.reject(error);\n    }\n    this.pending.clear();\n  }\n\n  close(): void {\n    this.fail(new Error(\"CDP connection closed by harness\"));\n    this.listeners.clear();\n    this.socket.close();\n  }\n}\n"],"mappings":"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"}