react-peer-chat 0.10.0 → 0.11.1

package/README.md

@@ -11,6 +11,7 @@ A simple-to-use React component for implementing peer-to-peer chatting, powered
 - Option to clear chat on command
 - Supports audio/voice chat with automatic mixing for multiple peers
 - Multiple peer connections. See [multi-peer usage](#multi-peer-usage)
+- Automatic reconnection handling for network interruptions
 - Fully customizable. See [usage with FaC](#full-customization)
 
 ## Installation
@@ -100,8 +101,9 @@ export default function App() {
         style: { padding: "4px" },
       }}
       props={{ title: "React Peer Chat Component" }}
-      onError={() => console.error("Browser not supported!")}
-      onMicError={() => console.error("Microphone not accessible!")}
+      onError={(error) => console.error("Fatal error:", error)}
+      onPeerError={(error) => console.error("Peer error:", error.type, error)}
+      onNetworkError={(error) => console.log("Reconnecting...")}
     />
   );
 }
@@ -120,8 +122,8 @@ export default function App() {
         name='John Doe'
         peerId='my-unique-id'
         remotePeerId='remote-unique-id'
-        onError={() => console.error('Browser not supported!')}
-        onMicError={() => console.error('Microphone not accessible!')}
+        onError={(error) => console.error('Fatal error:', error)}
+        onPeerError={(error) => console.error('Peer error:', error.type, error)}
     >
         {({ remotePeers, messages, sendMessage, audio, setAudio }) => (
             <YourCustomComponent>
@@ -293,19 +295,20 @@ export default function App() {
 
 Here is the full API for the `useChat` hook, these options can be passed as parameters to the hook:
 
-| Parameter           | Type                                          | Required | Default                                                         | Description                                                                                                                                     |
-| ------------------- | --------------------------------------------- | -------- | --------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
-| `name`              | `string`                                      | No       | Anonymous User                                                  | Name of the peer which will be shown to the remote peer.                                                                                        |
-| `peerId`            | `string`                                      | Yes      | -                                                               | It is the unique id that is alloted to a peer. It uniquely identifies a peer from other peers.                                                  |
-| `remotePeerId`      | `string \| string[]`                          | No       | -                                                               | Unique id(s) of remote peer(s) to connect to. Read at mount and when `peerId` changes; changes to this prop alone won't create new connections. |
-| `text`              | `boolean`                                     | No       | `true`                                                          | Text chat will be enabled if this property is set to true.                                                                                      |
-| `recoverChat`       | `boolean`                                     | No       | `false`                                                         | Old chats will be recovered upon reconnecting with the same peer(s).                                                                            |
-| `audio`             | `boolean`                                     | No       | `true`                                                          | Voice chat will be enabled if this property is set to true. Audio from multiple peers is automatically mixed.                                   |
-| `peerOptions`       | [`PeerOptions`](#peeroptions)                 | No       | -                                                               | Options to customize peerjs Peer instance.                                                                                                      |
-| `onError`           | [`ErrorHandler`](#errorhandler)               | No       | `() => alert('Browser not supported! Try some other browser.')` | Function to be executed if browser doesn't support `WebRTC`                                                                                     |
-| `onMicError`        | [`ErrorHandler`](#errorhandler)               | No       | `() => alert('Microphone not accessible!')`                     | Function to be executed when microphone is not accessible.                                                                                      |
-| `onMessageSent`     | [`MessageEventHandler`](#messageeventhandler) | No       | -                                                               | Function to be executed when a text message is sent to other peers.                                                                             |
-| `onMessageReceived` | [`MessageEventHandler`](#messageeventhandler) | No       | -                                                               | Function to be executed when a text message is received from other peers.                                                                       |
+| Parameter           | Type                                          | Required | Default         | Description                                                                                                                                     |
+| ------------------- | --------------------------------------------- | -------- | --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
+| `name`              | `string`                                      | No       | Anonymous User  | Name of the peer which will be shown to the remote peer.                                                                                        |
+| `peerId`            | `string`                                      | Yes      | -               | It is the unique id that is alloted to a peer. It uniquely identifies a peer from other peers.                                                  |
+| `remotePeerId`      | `string \| string[]`                          | No       | -               | Unique id(s) of remote peer(s) to connect to. Read at mount and when `peerId` changes; changes to this prop alone won't create new connections. |
+| `text`              | `boolean`                                     | No       | `true`          | Text chat will be enabled if this property is set to true.                                                                                      |
+| `recoverChat`       | `boolean`                                     | No       | `false`         | Old chats will be recovered upon reconnecting with the same peer(s).                                                                            |
+| `audio`             | `boolean`                                     | No       | `true`          | Voice chat will be enabled if this property is set to true. Audio from multiple peers is automatically mixed.                                   |
+| `peerOptions`       | [`PeerOptions`](#peeroptions)                 | No       | -               | Options to customize peerjs Peer instance.                                                                                                      |
+| `onError`           | [`ErrorHandler`](#errorhandler)               | No       | `console.error` | Function to be executed for fatal errors (browser not supported, microphone not accessible).                                                    |
+| `onPeerError`       | [`PeerErrorHandler`](#peererrorhandler)       | No       | `console.error` | Function to be executed for all peer runtime errors. The library automatically handles reconnection for network errors.                         |
+| `onNetworkError`    | [`PeerErrorHandler`](#peererrorhandler)       | No       | -               | Function to be executed for network/server errors (which trigger automatic reconnection). Useful for showing "reconnecting..." UI.              |
+| `onMessageSent`     | [`MessageEventHandler`](#messageeventhandler) | No       | -               | Function to be executed when a text message is sent to other peers.                                                                             |
+| `onMessageReceived` | [`MessageEventHandler`](#messageeventhandler) | No       | -               | Function to be executed when a text message is received from other peers.                                                                       |
 
 ### Chat Component
 
@@ -363,7 +366,15 @@ type DivProps = DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement
 ### ErrorHandler
 
 ```typescript
-type ErrorHandler = () => void;
+type ErrorHandler = (error: Error) => void;
+```
+
+### PeerErrorHandler
+
+```typescript
+import type { PeerError, PeerErrorType } from "peerjs";
+
+export type PeerErrorHandler = ErrorHandler<PeerError<`${PeerErrorType}`>>;
 ```
 
 ### MessageEventHandler
@@ -384,4 +395,4 @@ import type { PeerOptions } from "peerjs";
 
 ## License
 
-This project is licensed under the [MIT License](LICENSE).
+This project is licensed under the [MIT License](LICENSE)

package/dist/chunks/{chunk-L3CFU5IB.js → chunk-B2B7BBRE.js}

@@ -1,5 +1,5 @@
 import { getStorage, setStorage } from './chunk-ZYFPSCFE.js';
-import { __spreadValues, __spreadProps } from './chunk-LNEKYYG7.js';
+import { __spreadValues, __async, __spreadProps } from './chunk-FZ4QVG4I.js';
 import { useState, useRef, useMemo, useEffect } from 'react';
 
 // src/constants.ts
@@ -56,8 +56,9 @@ function useChat({
   text = true,
   recoverChat = false,
   audio: allowed = true,
-  onError = () => alert("Browser not supported! Try some other browser."),
-  onMicError = () => alert("Microphone not accessible!"),
+  onError = console.error,
+  onPeerError = console.error,
+  onNetworkError,
   onMessageSent,
   onMessageReceived
 }) {
@@ -74,8 +75,49 @@ function useChat({
     const remotePeerIds = Array.isArray(remotePeerId) ? remotePeerId : [remotePeerId];
     return { completePeerId: addPrefix(peerId), completeRemotePeerIds: remotePeerIds.map(addPrefix) };
   }, [peerId]);
+  function resetConnections(type = "all") {
+    switch (type) {
+      case "all":
+        resetConnections("data");
+        resetConnections("call");
+        break;
+      case "data":
+        Object.values(connRef.current).forEach(closeConnection);
+        connRef.current = {};
+        break;
+      case "call":
+        Object.values(callsRef.current).forEach(closeConnection);
+        Object.keys(sourceNodesRef.current).forEach(removePeerAudio);
+        callsRef.current = {};
+        break;
+    }
+  }
+  function handleConnection(conn) {
+    const peerId2 = conn.peer;
+    if (connRef.current[peerId2]) return conn.close();
+    connRef.current[peerId2] = conn;
+    conn.on("open", () => {
+      conn.on("data", ({ type, message, messages: messages2, remotePeerName }) => {
+        switch (type) {
+          case "init":
+            setRemotePeers((prev) => __spreadProps(__spreadValues({}, prev), { [peerId2]: remotePeerName }));
+            if (recoverChat) setMessages((old) => messages2.length > old.length ? messages2 : old);
+            break;
+          case "message":
+            receiveMessage(message);
+            break;
+        }
+      });
+      conn.send({ type: "init", remotePeerName: name, messages });
+    });
+    conn.on("close", () => {
+      conn.removeAllListeners();
+      delete connRef.current[peerId2];
+    });
+  }
   function handleCall(call) {
     const peerId2 = call.peer;
+    if (callsRef.current[peerId2]) return call.close();
     call.on("stream", () => {
       callsRef.current[peerId2] = call;
       if (!audioContextRef.current) audioContextRef.current = new AudioContext();
@@ -99,31 +141,14 @@ function useChat({
       delete callsRef.current[peerId2];
     });
   }
-  function handleConnection(conn) {
-    connRef.current[conn.peer] = conn;
-    conn.on("open", () => {
-      conn.on("data", ({ message, messages: messages2, remotePeerName, type }) => {
-        if (type === "message") receiveMessage(message);
-        else if (type === "init") {
-          setRemotePeers((prev) => __spreadProps(__spreadValues({}, prev), { [conn.peer]: remotePeerName }));
-          if (recoverChat) setMessages((old) => messages2.length > old.length ? messages2 : old);
-        }
-      });
-      conn.send({ type: "init", remotePeerName: name, messages });
-    });
-    conn.on("close", conn.removeAllListeners);
-  }
-  function handleError() {
-    setAudio(false);
-    onMicError();
-  }
   function receiveMessage(message) {
     addMessage(message);
     onMessageReceived == null ? void 0 : onMessageReceived(message);
   }
   function removePeerAudio(peerId2) {
-    if (!sourceNodesRef.current[peerId2]) return;
-    sourceNodesRef.current[peerId2].disconnect();
+    const source = sourceNodesRef.current[peerId2];
+    if (!source) return;
+    source.disconnect();
     delete sourceNodesRef.current[peerId2];
   }
   function sendMessage(message) {
@@ -134,6 +159,7 @@ function useChat({
   }
   useEffect(() => {
     if (!text && !audio) return;
+    let destroyed = false;
     import('peerjs').then(
       ({
         Peer,
@@ -141,15 +167,29 @@ function useChat({
           supports: { audioVideo, data }
         }
       }) => {
-        if (!data || !audioVideo) return onError();
+        if (!data || !audioVideo) return onError(new Error("Browser not supported! Try some other browser."));
         const peer2 = new Peer(completePeerId, __spreadValues({ config: defaultConfig }, peerOptions));
         peer2.on("connection", handleConnection);
-        setPeer(peer2);
+        peer2.on("call", handleCall);
+        peer2.on("disconnected", () => {
+          resetConnections();
+          peer2.reconnect();
+        });
+        peer2.on("error", (error) => {
+          if (error.type === "network" || error.type === "server-error") {
+            resetConnections();
+            setTimeout(() => peer2.reconnect(), 1e3);
+            onNetworkError == null ? void 0 : onNetworkError(error);
+          }
+          onPeerError(error);
+        });
+        if (destroyed) peer2.destroy();
+        else setPeer(peer2);
       }
     );
     return () => {
+      destroyed = true;
       setPeer((prev) => {
-        prev == null ? void 0 : prev.removeAllListeners();
         prev == null ? void 0 : prev.destroy();
         return void 0;
       });
@@ -157,45 +197,35 @@ function useChat({
   }, [completePeerId]);
   useEffect(() => {
     if (!text || !peer) return;
-    const handleOpen = () => completeRemotePeerIds.forEach((id) => handleConnection(peer.connect(id)));
-    if (peer.open) handleOpen();
-    else peer.once("open", handleOpen);
+    const connectData = () => completeRemotePeerIds.forEach((id) => handleConnection(peer.connect(id)));
+    if (peer.open) connectData();
+    peer.on("open", connectData);
     return () => {
-      Object.values(connRef.current).forEach(closeConnection);
-      connRef.current = {};
+      peer.off("open", connectData);
+      resetConnections("data");
     };
   }, [text, peer]);
   useEffect(() => {
     if (!audio || !peer) return;
     let localStream;
-    const setupAudio = () => navigator.mediaDevices.getUserMedia({
-      video: false,
-      audio: {
-        autoGainControl: true,
-        noiseSuppression: true,
-        echoCancellation: true
+    const setupAudio = () => __async(null, null, function* () {
+      try {
+        localStream = yield navigator.mediaDevices.getUserMedia({ video: false, audio: { autoGainControl: true, noiseSuppression: true, echoCancellation: true } });
+        completeRemotePeerIds.forEach((id) => {
+          if (!callsRef.current[id]) handleCall(peer.call(id, localStream));
+        });
+      } catch (e) {
+        setAudio(false);
+        onError(new Error("Microphone not accessible"));
       }
-    }).then((stream) => {
-      localStream = stream;
-      completeRemotePeerIds.forEach((id) => {
-        if (callsRef.current[id]) return;
-        const call = peer.call(id, stream);
-        handleCall(call);
-      });
-      peer.on("call", (call) => {
-        if (callsRef.current[call.peer]) return call.close();
-        call.answer(stream);
-        handleCall(call);
-      });
-    }).catch(handleError);
+    });
     if (peer.open) setupAudio();
-    else peer.once("open", setupAudio);
+    peer.on("open", setupAudio);
     return () => {
       var _a;
+      peer.off("open", setupAudio);
       localStream == null ? void 0 : localStream.getTracks().forEach((track) => track.stop());
-      Object.values(callsRef.current).forEach(closeConnection);
-      callsRef.current = {};
-      Object.keys(sourceNodesRef.current).forEach(removePeerAudio);
+      resetConnections("call");
       (_a = audioContextRef.current) == null ? void 0 : _a.close();
       audioContextRef.current = null;
       mixerRef.current = null;
@@ -209,10 +239,7 @@ function useMessages() {
   return [messages, setMessages, addMessage];
 }
 function useStorage(key, initialValue, local = false) {
-  const [storedValue, setStoredValue] = useState(() => {
-    if (typeof window === "undefined") return initialValue;
-    return getStorage(key, initialValue, local);
-  });
+  const [storedValue, setStoredValue] = useState(() => typeof window === "undefined" ? initialValue : getStorage(key, initialValue, local));
   const setValue = (value) => {
     setStoredValue((prev) => {
       const next = isSetStateFunction(value) ? value(prev) : value;

package/dist/chunks/{chunk-LNEKYYG7.js → chunk-FZ4QVG4I.js}

@@ -29,5 +29,25 @@ var __objRest = (source, exclude) => {
     }
   return target;
 };
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
 
-export { __objRest, __spreadProps, __spreadValues };
+export { __async, __objRest, __spreadProps, __spreadValues };

package/dist/chunks/{chunk-JJPIWKLG.js → chunk-QIPTWGEX.js}

@@ -1,4 +1,4 @@
-import { __spreadValues } from './chunk-LNEKYYG7.js';
+import { __spreadValues } from './chunk-FZ4QVG4I.js';
 import React from 'react';
 
 function BiSolidMessageDetail(props) {

package/dist/chunks/{chunk-OB5LLPQI.js → chunk-YQPRV5JQ.js}

@@ -1,6 +1,6 @@
-import { useChat } from './chunk-L3CFU5IB.js';
-import { BiSolidMessageX, BiSolidMessageDetail, GrSend, BsFillMicFill, BsFillMicMuteFill } from './chunk-JJPIWKLG.js';
-import { __objRest, __spreadValues } from './chunk-LNEKYYG7.js';
+import { useChat } from './chunk-B2B7BBRE.js';
+import { BiSolidMessageX, BiSolidMessageDetail, GrSend, BsFillMicFill, BsFillMicMuteFill } from './chunk-QIPTWGEX.js';
+import { __objRest, __spreadValues } from './chunk-FZ4QVG4I.js';
 import React, { useRef, useState, useEffect } from 'react';
 
 // src/styles.css

package/dist/components.js

@@ -1,5 +1,5 @@
-export { Chat as default } from './chunks/chunk-OB5LLPQI.js';
-import './chunks/chunk-L3CFU5IB.js';
-import './chunks/chunk-JJPIWKLG.js';
+export { Chat as default } from './chunks/chunk-YQPRV5JQ.js';
+import './chunks/chunk-B2B7BBRE.js';
+import './chunks/chunk-QIPTWGEX.js';
 import './chunks/chunk-ZYFPSCFE.js';
-import './chunks/chunk-LNEKYYG7.js';
+import './chunks/chunk-FZ4QVG4I.js';

package/dist/hooks.d.ts

@@ -2,7 +2,7 @@ import { SetStateAction } from 'react';
 import { UseChatProps, UseChatReturn, Message } from './types.js';
 import 'peerjs';
 
-declare function useChat({ peerId, name, remotePeerId, peerOptions, text, recoverChat, audio: allowed, onError, onMicError, onMessageSent, onMessageReceived, }: UseChatProps): UseChatReturn;
+declare function useChat({ peerId, name, remotePeerId, peerOptions, text, recoverChat, audio: allowed, onError, onPeerError, onNetworkError, onMessageSent, onMessageReceived, }: UseChatProps): UseChatReturn;
 declare function useMessages(): readonly [Message[], (value: SetStateAction<Message[]>) => void, (message: Message) => void];
 declare function useStorage<T>(key: string, initialValue: T, local?: boolean): readonly [T, (value: SetStateAction<T>) => void];
 declare function useStorage<T>(key: string, initialValue?: T, local?: boolean): readonly [T | undefined, (value: SetStateAction<T | undefined>) => void];

package/dist/hooks.js

@@ -1,3 +1,3 @@
-export { useAudio, useChat, useMessages, useStorage } from './chunks/chunk-L3CFU5IB.js';
+export { useAudio, useChat, useMessages, useStorage } from './chunks/chunk-B2B7BBRE.js';
 import './chunks/chunk-ZYFPSCFE.js';
-import './chunks/chunk-LNEKYYG7.js';
+import './chunks/chunk-FZ4QVG4I.js';

package/dist/icons.js

@@ -1,2 +1,2 @@
-export { BiSolidMessageDetail, BiSolidMessageX, BsFillMicFill, BsFillMicMuteFill, GrSend } from './chunks/chunk-JJPIWKLG.js';
-import './chunks/chunk-LNEKYYG7.js';
+export { BiSolidMessageDetail, BiSolidMessageX, BsFillMicFill, BsFillMicMuteFill, GrSend } from './chunks/chunk-QIPTWGEX.js';
+import './chunks/chunk-FZ4QVG4I.js';

package/dist/index.js

@@ -1,5 +1,5 @@
-export { Chat as default } from './chunks/chunk-OB5LLPQI.js';
-export { useChat } from './chunks/chunk-L3CFU5IB.js';
-import './chunks/chunk-JJPIWKLG.js';
+export { Chat as default } from './chunks/chunk-YQPRV5JQ.js';
+export { useChat } from './chunks/chunk-B2B7BBRE.js';
+import './chunks/chunk-QIPTWGEX.js';
 export { clearChat } from './chunks/chunk-ZYFPSCFE.js';
-import './chunks/chunk-LNEKYYG7.js';
+import './chunks/chunk-FZ4QVG4I.js';

package/dist/lib/storage.js

@@ -1,2 +1,2 @@
 export { clearChat, getStorage, removeStorage, setStorage } from '../chunks/chunk-ZYFPSCFE.js';
-import '../chunks/chunk-LNEKYYG7.js';
+import '../chunks/chunk-FZ4QVG4I.js';

package/dist/types.d.ts

@@ -1,9 +1,9 @@
-import { PeerOptions, DataConnection, MediaConnection } from 'peerjs';
+import { PeerOptions, PeerError, PeerErrorType, DataConnection, MediaConnection } from 'peerjs';
 export { PeerOptions } from 'peerjs';
 import { CSSProperties, DetailedHTMLProps, HTMLAttributes, SetStateAction, ReactNode } from 'react';
 
 type Connection = DataConnection | MediaConnection;
-type ErrorHandler = () => void;
+type ErrorHandler<E = Error> = (error: E) => void;
 type InputMessage = {
     id: string;
     text: string;
@@ -12,8 +12,10 @@ type Message = InputMessage & {
     name: string;
 };
 type MessageEventHandler = (message: Message) => void;
+type PeerErrorHandler = ErrorHandler<PeerError<`${PeerErrorType}`>>;
 
 type RemotePeerId = string | string[];
+type ResetConnectionType = "all" | "data" | "call";
 type UseChatProps = {
     peerId: string;
     name?: string;
@@ -23,7 +25,8 @@ type UseChatProps = {
     audio?: boolean;
     peerOptions?: PeerOptions;
     onError?: ErrorHandler;
-    onMicError?: ErrorHandler;
+    onPeerError?: PeerErrorHandler;
+    onNetworkError?: PeerErrorHandler;
     onMessageSent?: MessageEventHandler;
     onMessageReceived?: MessageEventHandler;
 };
@@ -52,4 +55,4 @@ type DialogPosition = "left" | "center" | "right";
 type DivProps = DetailedHTMLProps<HTMLAttributes<HTMLDivElement>, HTMLDivElement>;
 type RemotePeers = Record<string, string>;
 
-export type { ChatProps, Children, ChildrenOptions, Connection, DialogOptions, DialogPosition, DivProps, ErrorHandler, IconProps, InputMessage, Message, MessageEventHandler, RemotePeerId, RemotePeers, UseChatProps, UseChatReturn };
+export type { ChatProps, Children, ChildrenOptions, Connection, DialogOptions, DialogPosition, DivProps, ErrorHandler, IconProps, InputMessage, Message, MessageEventHandler, PeerErrorHandler, RemotePeerId, RemotePeers, ResetConnectionType, UseChatProps, UseChatReturn };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-peer-chat",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "description": "An easy to use react component for impleting peer-to-peer chatting.",
   "license": "MIT",
   "author": "Sahil Aggarwal <aggarwalsahil2004@gmail.com>",
@@ -36,9 +36,9 @@
   },
   "devDependencies": {
     "@release-it/conventional-changelog": "^10.0.4",
-    "@types/react": "^19.2.7",
+    "@types/react": "^19.2.8",
     "prettier-package-json": "^2.8.0",
-    "release-it": "^19.2.2",
+    "release-it": "^19.2.3",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },