@poolse/react-native 2.18.0 → 2.19.0

package/CHANGELOG.md

@@ -4,6 +4,33 @@ All notable changes to `@poolse/react-native` are documented here.
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/);
 versions follow [semver](https://semver.org).
 
+## [2.19.0] — 2026-08-25
+
+### Added
+
+- **The end of a call now travels by push, like its start.** A device
+  woken by a VoIP push is ringing on a lock screen with a socket that
+  may not be connected, so the broadcast that ends a call reaches
+  nothing there. `useVoipCalls` now understands a teardown push
+  (`event: "ended"`) and tears the ring down instead of starting one.
+  Needs a server that sends them, and an AppDelegate that reports the
+  call before ending it — see the sample's `plugins/withVoipPush.js`.
+
+- `readPush()` — exported and pure, so what a push MEANS can be tested
+  apart from what CallKit does about it. A missing `event` reads as a
+  ring, which is what servers predating the field send.
+
+### Fixed
+
+- **A ring that arrived by push is now registered with `useCalls`**, so
+  every signal that ends a call can match it. Previously only CallKit
+  knew about it. See `@poolse/react` 2.19.0.
+
+### Changed
+
+- A finished call — declined, busy, no answer — closes itself after a
+  short pause instead of waiting behind a Close button.
+
 ## [2.18.0] — 2026-08-24
 
 ### Fixed

package/dist/index.cjs

@@ -5836,6 +5836,10 @@ function format(total) {
   return `${hours > 0 ? `${hours}:` : ""}${mm}:${String(seconds).padStart(2, "0")}`;
 }
 var CHROME_IDLE_MS = 4500;
+var ENDED_LINGER_MS = 2500;
+function isOver(phase) {
+  return phase === "declined" || phase === "busy" || phase === "timed-out";
+}
 function CallScreen({
   userId,
   labelFor,
@@ -5951,6 +5955,11 @@ function CallScreen({
     endedOnEmpty.current = true;
     hangUp();
   }, [alone, calls.phase, hangUp]);
+  react.useEffect(() => {
+    if (!isOver(calls.phase)) return;
+    const timer = setTimeout(calls.reset, ENDED_LINGER_MS);
+    return () => clearTimeout(timer);
+  }, [calls.phase, calls.reset]);
   const micOn = usingSfu ? sfu.micEnabled : !mesh.muted;
   const toggleMic = react.useCallback(() => {
     if (usingSfu) void sfu.toggleMic();
@@ -5964,7 +5973,7 @@ function CallScreen({
   const label = react.useMemo(() => labelFor ?? ((id) => `User ${id.slice(0, 6)}`), [labelFor]);
   const ringingIn = calls.phase === "ringing-in";
   const ringingOut = calls.phase === "ringing-out";
-  const ended = calls.phase === "declined" || calls.phase === "busy" || calls.phase === "timed-out";
+  const ended = isOver(calls.phase);
   const visible = calls.phase !== "idle" && !(nativeIncomingUi && ringingIn);
   const duration = useCallDuration(connected);
   const participants = usingSfu ? sfu.participants : [];
@@ -6206,6 +6215,26 @@ function isStalePush(sentAt, now, staleAfterMs) {
   if (age < 0) return false;
   return age > staleAfterMs;
 }
+function readPush(payload) {
+  const callId = payload.call_id;
+  if (!callId) return { kind: "ignore" };
+  if (payload.event === "ended") return { kind: "teardown", callId };
+  const conversationId = payload.conversation_id;
+  if (!conversationId) return { kind: "ignore" };
+  return {
+    kind: "ring",
+    sentAt: payload.sent_at,
+    call: {
+      callId,
+      conversationId,
+      callerUserId: payload.caller_user_id ?? "",
+      callerName: payload.caller_name ?? "Incoming call",
+      // `has_video` is what older servers sent; `media` supersedes it.
+      // Either saying video means the system UI offers video.
+      media: payload.media === "video" || payload.has_video ? "video" : "audio"
+    }
+  };
+}
 function useVoipCalls({
   voipPush,
   callKeep,
@@ -6277,21 +6306,20 @@ function useVoipCalls({
   react.useEffect(() => {
     let cancelled = false;
     const fromPush = (payload) => {
-      const callId = payload.call_id;
-      const conversationId = payload.conversation_id;
-      if (!callId || !conversationId) return;
-      present.current(
-        {
-          callId,
-          conversationId,
-          callerUserId: payload.caller_user_id ?? "",
-          callerName: payload.caller_name ?? "Incoming call",
-          // `has_video` is what older servers sent; `media` supersedes
-          // it. Either says video, and the system UI offers video.
-          media: payload.media === "video" || payload.has_video ? "video" : "audio"
-        },
-        payload.sent_at
-      );
+      const intent = readPush(payload);
+      if (intent.kind === "ignore") return;
+      if (intent.kind === "teardown") {
+        dismiss.current(intent.callId);
+        handlers.current.calls?.dropped(intent.callId);
+        return;
+      }
+      present.current(intent.call, intent.sentAt);
+      handlers.current.calls?.ring({
+        callId: intent.call.callId,
+        conversationId: intent.call.conversationId,
+        callerUserId: intent.call.callerUserId,
+        media: intent.call.media
+      });
     };
     ready.current = callKeep.setup({
       ios: { appName },