@moku-labs/web 2.2.1 → 2.2.2

package/dist/browser.d.mts

@@ -1763,6 +1763,20 @@ interface ChannelOptions<T> {
    * order) on seed, closing the connect→load race. Defaults to `false` (deliver live).
    */
   bufferUntilSeed?: boolean;
+  /**
+   * Guard called on every socket close before the reconnect backoff is scheduled. Return `false`
+   * to suppress reconnection (e.g. stop on a terminal close code like `4401` for 401 Unauthorized
+   * / channel-not-found). The default — when omitted — always reconnects. The guard receives the
+   * `CloseEvent`, so callers can inspect `event.code` / `event.reason` / `event.wasClean`.
+   *
+   * @param event - The `CloseEvent` from the closed socket.
+   * @returns `true` (or `undefined`) to reconnect; `false` to stop permanently.
+   * @example
+   * ```ts
+   * shouldReconnect: (event) => event.code !== 4401
+   * ```
+   */
+  shouldReconnect?: (event: CloseEvent) => boolean;
 }
 /** A live realtime channel (the surface returned by {@link createChannel}). */
 interface Channel<T> {

package/dist/browser.mjs

@@ -4500,10 +4500,12 @@ function createChannel(options) {
 		ws.addEventListener("open", () => {
 			reconnectAttempts = 0;
 		});
-		ws.addEventListener("close", () => {
+		ws.addEventListener("close", (event) => {
 			if (socket !== ws || desiredId === void 0) return;
 			socket = void 0;
-			if (reconnectCfg) scheduleReconnect();
+			if (!reconnectCfg) return;
+			if (options.shouldReconnect?.(event) === false) return;
+			scheduleReconnect();
 		});
 	}
 	/**

package/dist/index.cjs

@@ -11206,10 +11206,12 @@ function createChannel(options) {
 		ws.addEventListener("open", () => {
 			reconnectAttempts = 0;
 		});
-		ws.addEventListener("close", () => {
+		ws.addEventListener("close", (event) => {
 			if (socket !== ws || desiredId === void 0) return;
 			socket = void 0;
-			if (reconnectCfg) scheduleReconnect();
+			if (!reconnectCfg) return;
+			if (options.shouldReconnect?.(event) === false) return;
+			scheduleReconnect();
 		});
 	}
 	/**

package/dist/index.d.cts

@@ -3683,6 +3683,20 @@ interface ChannelOptions<T> {
    * order) on seed, closing the connect→load race. Defaults to `false` (deliver live).
    */
   bufferUntilSeed?: boolean;
+  /**
+   * Guard called on every socket close before the reconnect backoff is scheduled. Return `false`
+   * to suppress reconnection (e.g. stop on a terminal close code like `4401` for 401 Unauthorized
+   * / channel-not-found). The default — when omitted — always reconnects. The guard receives the
+   * `CloseEvent`, so callers can inspect `event.code` / `event.reason` / `event.wasClean`.
+   *
+   * @param event - The `CloseEvent` from the closed socket.
+   * @returns `true` (or `undefined`) to reconnect; `false` to stop permanently.
+   * @example
+   * ```ts
+   * shouldReconnect: (event) => event.code !== 4401
+   * ```
+   */
+  shouldReconnect?: (event: CloseEvent) => boolean;
 }
 /** A live realtime channel (the surface returned by {@link createChannel}). */
 interface Channel<T> {

package/dist/index.d.mts

@@ -3681,6 +3681,20 @@ interface ChannelOptions<T> {
    * order) on seed, closing the connect→load race. Defaults to `false` (deliver live).
    */
   bufferUntilSeed?: boolean;
+  /**
+   * Guard called on every socket close before the reconnect backoff is scheduled. Return `false`
+   * to suppress reconnection (e.g. stop on a terminal close code like `4401` for 401 Unauthorized
+   * / channel-not-found). The default — when omitted — always reconnects. The guard receives the
+   * `CloseEvent`, so callers can inspect `event.code` / `event.reason` / `event.wasClean`.
+   *
+   * @param event - The `CloseEvent` from the closed socket.
+   * @returns `true` (or `undefined`) to reconnect; `false` to stop permanently.
+   * @example
+   * ```ts
+   * shouldReconnect: (event) => event.code !== 4401
+   * ```
+   */
+  shouldReconnect?: (event: CloseEvent) => boolean;
 }
 /** A live realtime channel (the surface returned by {@link createChannel}). */
 interface Channel<T> {

package/dist/index.mjs

@@ -11193,10 +11193,12 @@ function createChannel(options) {
 		ws.addEventListener("open", () => {
 			reconnectAttempts = 0;
 		});
-		ws.addEventListener("close", () => {
+		ws.addEventListener("close", (event) => {
 			if (socket !== ws || desiredId === void 0) return;
 			socket = void 0;
-			if (reconnectCfg) scheduleReconnect();
+			if (!reconnectCfg) return;
+			if (options.shouldReconnect?.(event) === false) return;
+			scheduleReconnect();
 		});
 	}
 	/**

package/package.json

@@ -132,5 +132,5 @@
     "test:build-e2e": "bun test src/plugins/build/__tests__/e2e/",
     "test:coverage": "vitest run --project unit --project integration --coverage"
   },
-  "version": "2.2.1"
+  "version": "2.2.2"
 }