@poolse/react-native 2.17.1 → 2.19.0

package/CHANGELOG.md

@@ -4,6 +4,50 @@ 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
+
+- **The device was often never registered for VoIP push, so no call
+  ever rang a backgrounded or closed app.** `useVoipCalls` registered
+  the PushKit token the instant iOS issued it — which is moments after
+  launch, and routinely before the host app has a session. Registering
+  is an authenticated call, so it 401'd, and the error was swallowed as
+  "offline at launch". No device row meant poolse had nothing to push
+  to.
+
+  The token is now held until a signed-in user exists, and registered
+  when both are present — in whichever order they arrive. A failure no
+  longer marks the pair as done, so it retries rather than giving up
+  until the next launch.
+
 ## [2.17.1] — 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,
@@ -6218,6 +6247,9 @@ function useVoipCalls({
 }) {
   const poolse = react$1.usePoolse();
   const shown = react.useRef(/* @__PURE__ */ new Map());
+  const [voipToken, setVoipToken] = react.useState(null);
+  const { me } = react$1.useMe();
+  const registered = react.useRef(null);
   const handlers = react.useRef({ onAnswer, onDecline, calls });
   handlers.current = { onAnswer, onDecline, calls };
   const staleRef = react.useRef(staleAfterMs);
@@ -6257,24 +6289,37 @@ function useVoipCalls({
     void ready.current.then(done, done);
     if (isStalePush(sentAt, Date.now(), staleRef.current)) dismiss.current(call.callId);
   });
+  react.useEffect(() => {
+    const userId = me?.id;
+    if (!voipToken || !userId) return;
+    const pair = `${userId}:${voipToken}`;
+    if (registered.current === pair) return;
+    void poolse.devices.register({
+      token: voipToken,
+      platform: "ios",
+      environment: apnsEnvironment ?? guessApnsEnvironment()
+    }).then(() => {
+      registered.current = pair;
+    }).catch(() => {
+    });
+  }, [poolse, voipToken, me?.id, apnsEnvironment]);
   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 },
@@ -6289,12 +6334,7 @@ function useVoipCalls({
     });
     voipPush.addEventListener("register", ((token) => {
       if (cancelled || !token) return;
-      void poolse.devices.register({
-        token,
-        platform: "ios",
-        environment: apnsEnvironment ?? guessApnsEnvironment()
-      }).catch(() => {
-      });
+      setVoipToken(token);
     }));
     voipPush.addEventListener("notification", ((payload) => {
       fromPush(payload);