@poolse/react-native 2.15.2 → 2.16.1

package/CHANGELOG.md

@@ -4,6 +4,40 @@ 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.16.1] — 2026-08-24
+
+### Fixed
+
+- `RingToneModule` declared its tone argument optional, which made the
+  real `react-native-incall-manager` unassignable to it — function
+  parameters are contravariant, so a signature that demands an argument
+  cannot stand in for one that does not.
+
+## [2.16.0] — 2026-08-24
+
+### Added
+
+- **Ring tones.** `CallScreen` takes an optional `inCallManager` module
+  and plays ringback while an outbound call rings, and a ringtone for an
+  inbound one — but only when it is actually showing the incoming UI,
+  since CallKit already rings and a second tone underneath is noise.
+  A silent outbound call is indistinguishable from one that failed to
+  place at all.
+
+### Changed
+
+- **Media opens while the call rings, not after it is answered.** The
+  caller used to stare at a blank screen for the whole ring and then
+  watch their own preview pop in a second late — and the microphone was
+  not open either, so the first word of every call was clipped. The room
+  is now joined on `ringing-out`, so it is warm the moment the far side
+  picks up. Safe for the alone-detection: a caller in an empty room has
+  never seen a peer, which is the guard that already exists.
+- **Tapping the call screen toggles the controls.** It only ever showed
+  them before, and a timer took them away — so there was no way to
+  deliberately clear the chrome and look at the video. The idle timer
+  remains, on top rather than as the only way they disappear.
+
 ## [2.15.2] — 2026-08-23
 
 ### Fixed

package/dist/index.cjs

@@ -5846,6 +5846,7 @@ function CallScreen({
   onStatusChange,
   onTransportChange,
   onVideoChange,
+  inCallManager,
   nativeIncomingUi
 }) {
   const insets = reactNativeSafeAreaContext.useSafeAreaInsets();
@@ -5856,7 +5857,7 @@ function CallScreen({
     () => meshAvailable && webrtc ? { webrtc: createNativeWebRtcAdapter(webrtc) } : {},
     [meshAvailable, webrtc]
   );
-  const conversationId = calls.phase === "active" ? calls.activeConversationId : null;
+  const conversationId = calls.phase === "active" ? calls.activeConversationId : calls.phase === "ringing-out" ? calls.outgoing?.conversationId ?? null : null;
   const isVideoCall = calls.media === "video";
   const sfu = react$1.useCallRoom(livekit ? conversationId : null, {
     livekit,
@@ -5867,7 +5868,8 @@ function CallScreen({
   const status = usingSfu ? toVoiceStatus(sfu.status) : mesh.status;
   const connected = calls.phase === "active" && status === "connected";
   react.useEffect(() => {
-    if (calls.phase !== "active" || !conversationId) return;
+    const wants = calls.phase === "active" || calls.phase === "ringing-out";
+    if (!wants || !conversationId) return;
     let cancelled = false;
     void (async () => {
       const joined = livekit ? await sfu.join() : false;
@@ -5895,6 +5897,23 @@ function CallScreen({
     livekitReactNative
   });
   const [routesOpen, setRoutesOpen] = react.useState(false);
+  const showingIncoming = calls.phase === "ringing-in" && !nativeIncomingUi;
+  react.useEffect(() => {
+    const ringing = calls.phase === "ringing-out";
+    if (!ringing && !showingIncoming) return;
+    try {
+      if (ringing) inCallManager?.startRingback?.("_DEFAULT_");
+      else inCallManager?.startRingtone?.("_DEFAULT_");
+    } catch {
+    }
+    return () => {
+      try {
+        inCallManager?.stopRingback?.();
+        inCallManager?.stopRingtone?.();
+      } catch {
+      }
+    };
+  }, [calls.phase, showingIncoming, inCallManager]);
   const [chromeVisible, setChromeVisible] = react.useState(true);
   const [lastWake, setLastWake] = react.useState(0);
   const chromeHides = connected && isVideoCall;
@@ -5905,6 +5924,13 @@ function CallScreen({
     return () => clearTimeout(timer);
   }, [chromeHides, lastWake]);
   const wakeChrome = react.useCallback(() => setLastWake(Date.now()), []);
+  const toggleChrome = react.useCallback(() => {
+    setChromeVisible((visible2) => {
+      if (visible2) return false;
+      setLastWake(Date.now());
+      return true;
+    });
+  }, []);
   const withWake = react.useCallback(
     (fn) => () => {
       wakeChrome();
@@ -5963,7 +5989,7 @@ function CallScreen({
       onRequestClose: hangUp,
       children: [
         /* @__PURE__ */ jsxRuntime.jsx(reactNative.StatusBar, { barStyle: "light-content" }),
-        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.Pressable, { style: styles30.screen, onPress: wakeChrome, accessible: false, children: [
+        /* @__PURE__ */ jsxRuntime.jsxs(reactNative.Pressable, { style: styles30.screen, onPress: toggleChrome, accessible: false, children: [
           showStage ? /* @__PURE__ */ jsxRuntime.jsx(
             CallVideoGrid,
             {