@poolse/react 2.7.0 → 2.8.1

package/dist/index.d.cts

@@ -566,6 +566,16 @@ interface UseCalls {
     decline: (call?: IncomingCall) => Promise<void>;
     /** Hang up an outbound ring before it's answered. */
     cancel: () => Promise<void>;
+    /**
+     * End the call, whatever state it is in.
+     *
+     * The one action a UI's hang-up button should call: it sends the right
+     * signal for the current phase — cancel while ringing out, decline
+     * while ringing in, hangup once connected — and always returns to
+     * idle, even if the signal fails. `reset` alone clears local state
+     * only, which leaves the other side in the call.
+     */
+    hangUp: () => Promise<void>;
     /** Drop back to idle — call after leaving the room, or to clear a
      *  `declined` / `busy` / `timed-out` state the UI has finished
      *  showing. */

package/dist/index.d.ts

@@ -566,6 +566,16 @@ interface UseCalls {
     decline: (call?: IncomingCall) => Promise<void>;
     /** Hang up an outbound ring before it's answered. */
     cancel: () => Promise<void>;
+    /**
+     * End the call, whatever state it is in.
+     *
+     * The one action a UI's hang-up button should call: it sends the right
+     * signal for the current phase — cancel while ringing out, decline
+     * while ringing in, hangup once connected — and always returns to
+     * idle, even if the signal fails. `reset` alone clears local state
+     * only, which leaves the other side in the call.
+     */
+    hangUp: () => Promise<void>;
     /** Drop back to idle — call after leaving the room, or to clear a
      *  `declined` / `busy` / `timed-out` state the UI has finished
      *  showing. */

package/dist/index.js

@@ -1069,6 +1069,7 @@ function useVoiceRoom(conversationId, opts = {}) {
   const [muted, setMuted] = useState(false);
   const [error, setError] = useState(null);
   const optsRef = useRef(opts);
+  const joined = useRef(false);
   const room = useMemo(
     () => conversationId ? poolse.realtime.voice(conversationId, optsRef.current) : null,
     [poolse, conversationId]
@@ -1085,7 +1086,10 @@ function useVoiceRoom(conversationId, opts = {}) {
       offStatus();
       offRoster();
       offError();
-      room.leave();
+      if (joined.current) {
+        joined.current = false;
+        room.leave();
+      }
     };
   }, [room]);
   const join = useCallback(async () => {
@@ -1093,11 +1097,14 @@ function useVoiceRoom(conversationId, opts = {}) {
     setError(null);
     try {
       await room.join();
+      joined.current = true;
     } catch (err) {
       setError(err instanceof Error ? err : new Error(String(err)));
     }
   }, [room]);
   const leave = useCallback(() => {
+    if (!joined.current) return;
+    joined.current = false;
     room?.leave();
   }, [room]);
   const toggleMute = useCallback(() => {
@@ -1146,6 +1153,12 @@ function useCalls(userId, opts = {}) {
       setPhase("busy");
       setOutgoing(null);
     });
+    const offEnded = calls.onEnded(() => {
+      setPhase("idle");
+      setIncoming(null);
+      setOutgoing(null);
+      setActiveConversationId(null);
+    });
     const offCancelled = calls.onCancelled((call2) => {
       setIncoming((current) => {
         if (current && current.callId !== call2.callId) return current;
@@ -1158,6 +1171,7 @@ function useCalls(userId, opts = {}) {
       offAccepted();
       offDeclined();
       offBusy();
+      offEnded();
       offCancelled();
     };
   }, [calls]);
@@ -1229,6 +1243,27 @@ function useCalls(userId, opts = {}) {
     }, ringTimeoutMs);
     return () => clearTimeout(timer);
   }, [phase, ringTimeoutMs]);
+  const hangUp = useCallback(async () => {
+    const conversationId = activeConversationId ?? incoming?.conversationId ?? outgoing?.conversationId;
+    const callId = incoming?.callId ?? outgoing?.callId;
+    try {
+      if (!calls || !callId || !conversationId) return;
+      if (phase === "ringing-out" && outgoing) {
+        await calls.cancel(outgoing);
+      } else if (phase === "ringing-in" && incoming) {
+        await calls.decline(incoming);
+      } else if (phase === "active") {
+        await calls.hangUp({ callId, conversationId });
+      }
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setPhase("idle");
+      setIncoming(null);
+      setOutgoing(null);
+      setActiveConversationId(null);
+    }
+  }, [calls, phase, incoming, outgoing, activeConversationId]);
   const reset = useCallback(() => {
     setPhase("idle");
     setIncoming(null);
@@ -1246,6 +1281,7 @@ function useCalls(userId, opts = {}) {
     accept,
     decline,
     cancel,
+    hangUp,
     reset
   };
 }