@maintainer-pro/ai-bridge 0.1.30 → 0.1.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maintainer-pro/ai-bridge",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "description": "Local bridge daemon that pairs a machine to Maintainer Pro and configures multiple client sandboxes.",
   "keywords": [
     "maintainer-pro",
@@ -29,6 +29,7 @@
   },
   "dependencies": {
     "@maintainer-pro/ai-cli": "^0.1.16",
-    "@maintainer-pro/ai-server": "^0.1.8"
+    "@maintainer-pro/ai-server": "^0.1.8",
+    "ws": "^8.21.3"
   }
 }

package/src/daemon.mjs

@@ -43,9 +43,21 @@ import {
   mergeCookieHeader,
   storeCorsCookies,
 } from "./cors-cookies.mjs";
+import { WebSocket as WsWebSocket } from "ws";
 
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const requireFromHere = createRequire(import.meta.url);
+
+/**
+ * Node 22+ has a global WHATWG WebSocket. Node 20 (still common on partner
+ * machines) does not — `new WebSocket()` throws "WebSocket is not defined".
+ * Fall back to the `ws` package, which exposes the same addEventListener API.
+ */
+const WebSocketImpl =
+  typeof globalThis.WebSocket === "function"
+    ? globalThis.WebSocket
+    : WsWebSocket;
+const usingWsFallback = WebSocketImpl === WsWebSocket;
 const PACKAGE_VERSION = readPackageVersion();
 const PACKAGE_VERSIONS = readPackageVersions();
 const HEARTBEAT_MS = 15_000;
@@ -3060,7 +3072,7 @@ function attachProxyLocalWs(id, socket) {
   try {
     socket.binaryType = "arraybuffer";
   } catch {
-    /* WHATWG WebSocket in Node 22 */
+    /* WHATWG WebSocket in Node 22; `ws` fallback on Node 20 */
   }
   proxyLocalSockets.set(id, socket);
   const announceOpen = () => {
@@ -3134,7 +3146,9 @@ function openProxyLocalWs(id, port, path, protocols) {
     let socket;
     try {
       // Vite HMR only accepts upgrades with subprotocol `vite-hmr` / `vite-ping`.
-      socket = proto.length ? new WebSocket(url, proto) : new WebSocket(url);
+      socket = proto.length
+        ? new WebSocketImpl(url, proto)
+        : new WebSocketImpl(url);
     } catch (err) {
       if (index + 1 < hosts.length) {
         tryHost(index + 1);
@@ -5475,6 +5489,11 @@ async function main() {
     { versions: PACKAGE_VERSIONS },
     `bridge v${PACKAGE_VERSION} starting (${formatPackageVersions()})`
   );
+  if (usingWsFallback) {
+    log(
+      `Node ${process.versions.node} has no global WebSocket; using the ws package`
+    );
+  }
   void warnIfBridgeOutdated();
 
   let cfg = loadConfig() || {};
@@ -5827,7 +5846,7 @@ async function main() {
     /** @type {WebSocket} */
     let ws;
     try {
-      ws = new WebSocket(url);
+      ws = new WebSocketImpl(url);
     } catch (err) {
       warn(
         `websocket connect failed: ${