react-realtime-hooks 1.0.1 → 1.0.2

package/README.md

@@ -507,7 +507,7 @@ export function NetworkIndicator() {
 
 - `useEventSource` is receive-only by design. SSE is not a bidirectional transport.
 - `useWebSocket` heartbeat support is client-side. You still define your own server ping/pong protocol.
-- If `parseMessage` throws, the hook moves into `error` and stores `lastError`.
+- If `parseMessage` throws, the hook closes the current transport, moves into `error`, stores `lastError`, and stops auto-reconnect until manual `open()` or `reconnect()`.
 - `connect: false` keeps the hook in `idle` until `open()` is called.
 - Manual `close()` is sticky. The hook stays closed until `open()` or `reconnect()` is called.
 - No transport polyfills are bundled. Provide your own runtime support where needed.

package/dist/index.cjs

@@ -618,6 +618,7 @@ var useWebSocket = (options) => {
   const manualOpenRef = react.useRef(false);
   const skipCloseReconnectRef = react.useRef(false);
   const suppressReconnectRef = react.useRef(false);
+  const terminalErrorRef = react.useRef(null);
   const [openNonce, setOpenNonce] = react.useState(0);
   const [state, setState] = react.useState(
     () => createInitialState3(connect ? "connecting" : "idle")
@@ -701,7 +702,9 @@ var useWebSocket = (options) => {
   });
   const handleOpen = react.useEffectEvent((event, socket2) => {
     manualCloseRef.current = false;
+    manualOpenRef.current = false;
     suppressReconnectRef.current = false;
+    terminalErrorRef.current = null;
     reconnect.markConnected();
     heartbeat.start();
     commitState((current) => ({
@@ -725,11 +728,19 @@ var useWebSocket = (options) => {
       options.onMessage?.(message, event);
     } catch {
       const parseError = new Event("error");
+      terminalErrorRef.current = parseError;
+      manualOpenRef.current = false;
+      skipCloseReconnectRef.current = true;
+      suppressReconnectRef.current = true;
+      reconnect.cancel();
+      heartbeat.stop();
       commitState((current) => ({
         ...current,
+        lastChangedAt: Date.now(),
         lastError: parseError,
         status: "error"
       }));
+      closeSocket(1003, "parse-error");
     }
   });
   const handleError = react.useEffectEvent((event) => {
@@ -746,8 +757,21 @@ var useWebSocket = (options) => {
     socketKeyRef.current = null;
     heartbeat.stop();
     updateBufferedAmount();
+    const terminalError = terminalErrorRef.current;
     const skipCloseReconnect = skipCloseReconnectRef.current;
     skipCloseReconnectRef.current = false;
+    if (terminalError !== null) {
+      suppressReconnectRef.current = false;
+      commitState((current) => ({
+        ...current,
+        lastChangedAt: Date.now(),
+        lastCloseEvent: event,
+        lastError: terminalError,
+        status: "error"
+      }));
+      options.onClose?.(event);
+      return;
+    }
     const shouldReconnect = !suppressReconnectRef.current && !skipCloseReconnect && reconnectEnabled && (options.shouldReconnect?.(event) ?? true);
     commitState((current) => ({
       ...current,
@@ -766,6 +790,7 @@ var useWebSocket = (options) => {
     manualCloseRef.current = false;
     manualOpenRef.current = true;
     suppressReconnectRef.current = false;
+    terminalErrorRef.current = null;
     reconnect.cancel();
     setOpenNonce((current) => current + 1);
   };
@@ -774,6 +799,7 @@ var useWebSocket = (options) => {
     manualOpenRef.current = true;
     skipCloseReconnectRef.current = true;
     suppressReconnectRef.current = true;
+    terminalErrorRef.current = null;
     heartbeat.stop();
     closeSocket();
     suppressReconnectRef.current = false;
@@ -783,6 +809,7 @@ var useWebSocket = (options) => {
     manualCloseRef.current = true;
     manualOpenRef.current = false;
     suppressReconnectRef.current = true;
+    terminalErrorRef.current = null;
     reconnect.cancel();
     heartbeat.stop();
     commitState((current) => ({
@@ -820,7 +847,7 @@ var useWebSocket = (options) => {
       }));
       return;
     }
-    const shouldConnect = connect && !manualCloseRef.current || manualOpenRef.current || reconnect.status === "running";
+    const shouldConnect = terminalErrorRef.current === null && (connect && !manualCloseRef.current || manualOpenRef.current || reconnect.status === "running");
     const nextSocketKey = `${resolvedUrl}::${protocolsDependency}::${options.binaryType ?? "blob"}`;
     if (!shouldConnect) {
       if (socketRef.current !== null) {
@@ -830,7 +857,7 @@ var useWebSocket = (options) => {
       socketKeyRef.current = null;
       commitState((current) => ({
         ...current,
-        status: manualCloseRef.current ? "closed" : "idle"
+        status: terminalErrorRef.current !== null ? "error" : manualCloseRef.current ? "closed" : "idle"
       }));
       return;
     }
@@ -885,6 +912,7 @@ var useWebSocket = (options) => {
   react.useEffect(() => () => {
     suppressReconnectRef.current = true;
     socketKeyRef.current = null;
+    terminalErrorRef.current = null;
     const socket2 = socketRef.current;
     socketRef.current = null;
     if (socket2 === null) {
@@ -981,6 +1009,7 @@ var useEventSource = (options) => {
   const manualOpenRef = react.useRef(false);
   const skipErrorReconnectRef = react.useRef(false);
   const suppressReconnectRef = react.useRef(false);
+  const terminalErrorRef = react.useRef(null);
   const [openNonce, setOpenNonce] = react.useState(0);
   const [state, setState] = react.useState(
     () => createInitialState4(connect ? "connecting" : "idle")
@@ -1014,7 +1043,9 @@ var useEventSource = (options) => {
   });
   const handleOpen = react.useEffectEvent((event, source) => {
     manualCloseRef.current = false;
+    manualOpenRef.current = false;
     suppressReconnectRef.current = false;
+    terminalErrorRef.current = null;
     reconnect.markConnected();
     commitState((current) => ({
       ...current,
@@ -1040,8 +1071,14 @@ var useEventSource = (options) => {
         options.onMessage?.(message, event);
       } catch {
         const parseError = new Event("error");
+        terminalErrorRef.current = parseError;
+        manualOpenRef.current = false;
+        suppressReconnectRef.current = true;
+        reconnect.cancel();
+        closeEventSource();
         commitState((current) => ({
           ...current,
+          lastChangedAt: Date.now(),
           lastError: parseError,
           status: "error"
         }));
@@ -1049,6 +1086,17 @@ var useEventSource = (options) => {
     }
   );
   const handleError = react.useEffectEvent((event, source) => {
+    const terminalError = terminalErrorRef.current;
+    if (terminalError !== null) {
+      suppressReconnectRef.current = false;
+      commitState((current) => ({
+        ...current,
+        lastChangedAt: Date.now(),
+        lastError: terminalError,
+        status: "error"
+      }));
+      return;
+    }
     const skipErrorReconnect = skipErrorReconnectRef.current;
     skipErrorReconnectRef.current = false;
     const shouldReconnect = !suppressReconnectRef.current && !skipErrorReconnect && reconnectEnabled && (options.shouldReconnect?.(event) ?? true);
@@ -1075,6 +1123,7 @@ var useEventSource = (options) => {
     manualCloseRef.current = false;
     manualOpenRef.current = true;
     suppressReconnectRef.current = false;
+    terminalErrorRef.current = null;
     reconnect.cancel();
     setOpenNonce((current) => current + 1);
   };
@@ -1083,6 +1132,7 @@ var useEventSource = (options) => {
     manualOpenRef.current = true;
     skipErrorReconnectRef.current = true;
     suppressReconnectRef.current = true;
+    terminalErrorRef.current = null;
     closeEventSource();
     suppressReconnectRef.current = false;
     reconnect.schedule("manual");
@@ -1091,6 +1141,7 @@ var useEventSource = (options) => {
     manualCloseRef.current = true;
     manualOpenRef.current = false;
     suppressReconnectRef.current = true;
+    terminalErrorRef.current = null;
     reconnect.cancel();
     closeEventSource();
     commitState((current) => ({
@@ -1117,7 +1168,7 @@ var useEventSource = (options) => {
       }));
       return;
     }
-    const shouldConnect = connect && !manualCloseRef.current || manualOpenRef.current || reconnect.status === "running";
+    const shouldConnect = terminalErrorRef.current === null && (connect && !manualCloseRef.current || manualOpenRef.current || reconnect.status === "running");
     const nextEventSourceKey = [
       resolvedUrl,
       options.withCredentials ? "credentials" : "anonymous",
@@ -1131,7 +1182,7 @@ var useEventSource = (options) => {
       eventSourceKeyRef.current = null;
       commitState((current) => ({
         ...current,
-        status: manualCloseRef.current ? "closed" : "idle"
+        status: terminalErrorRef.current !== null ? "error" : manualCloseRef.current ? "closed" : "idle"
       }));
       return;
     }
@@ -1193,6 +1244,7 @@ var useEventSource = (options) => {
   react.useEffect(() => () => {
     suppressReconnectRef.current = true;
     eventSourceKeyRef.current = null;
+    terminalErrorRef.current = null;
     const source = eventSourceRef.current;
     eventSourceRef.current = null;
     if (source !== null) {