hypha-rpc 0.21.43 → 0.21.44

package/coverage/html/index.html

@@ -86,7 +86,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2026-06-17T12:55:08.176Z
+                at 2026-07-06T10:50:07.482Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/dist/hypha-rpc-websocket.js

@@ -10424,6 +10424,14 @@ __webpack_require__.r(__webpack_exports__);
 
 const MAX_RETRY = 1000000;
 
+// When the socket errors/closes during the handshake, wait briefly before
+// rejecting with the generic reason: the server usually sends a descriptive
+// {type:"error"} message (e.g. token/workspace mismatch) just before closing,
+// and on some runtimes (undici's native WebSocket on Node) the close is
+// surfaced BEFORE that message reaches onmessage. This grace lets the real
+// server reason win the race instead of a generic "error during handshake".
+const HANDSHAKE_ERROR_GRACE_MS = 100;
+
 class WebsocketRPCConnection {
   constructor(
     server_url,
@@ -10581,30 +10589,38 @@ class WebsocketRPCConnection {
 
       // Handle WebSocket closing before connection_info is received.
       // Without this, the promise hangs until the outer waitFor timeout (60s).
+      // Defer the generic error/close rejection so a pending server
+      // {type:"error"} message (handled in onmessage below) can settle first
+      // with the actual reason. Without this, an undici close-as-error would
+      // reject with "error during handshake" and hide the server's reason
+      // (e.g. "workspace does not match"). If no descriptive message arrives
+      // within the grace window, the generic rejection fires as a fallback.
+      const rejectAfterGrace = (err) => {
+        if (settled) return;
+        setTimeout(() => {
+          if (!settled) {
+            settled = true;
+            reject(err);
+          }
+        }, HANDSHAKE_ERROR_GRACE_MS);
+      };
+
       const prevOnClose = this._websocket.onclose;
       this._websocket.onclose = (event) => {
-        if (!settled) {
-          settled = true;
-          reject(
-            new Error(
-              `ConnectionAbortedError: WebSocket closed during handshake (code=${event.code}, reason=${event.reason || "unknown"})`,
-            ),
-          );
-        }
+        rejectAfterGrace(
+          new Error(
+            `ConnectionAbortedError: WebSocket closed during handshake (code=${event.code}, reason=${event.reason || "unknown"})`,
+          ),
+        );
         // Delegate to any previously-set onclose handler
         if (prevOnClose) prevOnClose.call(this._websocket, event);
       };
 
       const prevOnError = this._websocket.onerror;
       this._websocket.onerror = (event) => {
-        if (!settled) {
-          settled = true;
-          reject(
-            new Error(
-              `ConnectionAbortedError: WebSocket error during handshake`,
-            ),
-          );
-        }
+        rejectAfterGrace(
+          new Error(`ConnectionAbortedError: WebSocket error during handshake`),
+        );
         if (prevOnError) prevOnError.call(this._websocket, event);
       };