@vxil/realtime 0.1.0 → 0.2.0

package/dist/index.d.ts

@@ -62,8 +62,13 @@ export interface PresenceEvent {
 type FrameListener = (frame: RealtimeFrame) => void;
 type StateListener = (state: ChannelState, detail?: {
     attempt?: number;
-    error?: unknown;
+    error?: unknown; /** the server close code on a terminal close */
+    code?: number;
 }) => void;
+/** Server close code: the end-user's auth session was revoked — terminal, the
+ *  client never reconnects on it (a fresh subscribe() after sign-in does). The
+ *  24 h socket-lifetime close (4001) reconnects like any other close. */
+export declare const CLOSE_SESSION_REVOKED = 4002;
 type PresenceListener = (d: PresenceEvent) => void;
 export declare class Channel {
     readonly name: string;

package/dist/index.js

@@ -28,6 +28,10 @@
 // pass a constructor — `import WebSocket from 'ws'; new RealtimeClient({
 // ..., WebSocket })` — instead of failing with a silent `WebSocket is not
 // defined`. (The `ws` package is NOT a dependency of this package.)
+/** Server close code: the end-user's auth session was revoked — terminal, the
+ *  client never reconnects on it (a fresh subscribe() after sign-in does). The
+ *  24 h socket-lifetime close (4001) reconnects like any other close. */
+export const CLOSE_SESSION_REVOKED = 4002;
 const DEFAULT_BASE = 'https://api.vxil.com';
 function resolveCtor(injected) {
     const WS = injected ?? globalThis.WebSocket;
@@ -293,7 +297,17 @@ export class Channel {
                 clearTimeout(this.flushFallback);
                 this.flushFallback = undefined;
             }
-            this.scheduleReconnect(new Error(`websocket closed (code ${ev.code ?? 'unknown'})`));
+            const error = new Error(`websocket closed (code ${ev.code ?? 'unknown'})`);
+            if (ev.code === CLOSE_SESSION_REVOKED) {
+                // The end-user's auth session was revoked server-side (sign-out,
+                // revoke-all, erase). Reconnecting would loop forever against a mint
+                // that now 401s — terminal instead; subscribe() again after sign-in.
+                this.userClosed = true;
+                this.settleOpen(error);
+                this.setState('closed', { code: ev.code, error });
+                return;
+            }
+            this.scheduleReconnect(error);
         });
         // In browsers every 'error' is followed by 'close' — counting both would
         // double-step the backoff, so only 'close' drives the state machine.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vxil/realtime",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "private": false,
   "type": "module",
   "sideEffects": false,