@poolse/react-native 2.4.1 → 2.6.0

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
-import { Conversation, Uuid, Message, AttachmentUploadInput, Membership, Attachment, WebRtcAdapter } from '@poolse/sdk';
+import { Conversation, Uuid, Message, AttachmentUploadInput, Membership, Attachment, WebRtcAdapter, VoiceStatus } from '@poolse/sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { UseCalls } from '@poolse/react';
 
@@ -1045,6 +1045,15 @@ interface VoiceRoomBarProps {
      * want in Expo Go.
      */
     webrtc?: NativeWebRtcModule | null;
+    /**
+     * Called whenever the room's connection state changes.
+     *
+     * Audio routing is the app's job — speakerphone, the proximity sensor
+     * that blanks the screen at your ear, and holding the audio session
+     * open all need a native module this package deliberately doesn't
+     * depend on. Use this to start and stop it.
+     */
+    onStatusChange?: (status: VoiceStatus) => void;
     /** Resolves a user id to a display label. Defaults to a short id. */
     labelFor?: (userId: string) => string;
     /**
@@ -1061,7 +1070,7 @@ interface VoiceRoomBarProps {
  * always-on voice channel. For ringing a specific person, use
  * `<IncomingCallSheet>` together with `useCalls`.
  */
-declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot, webrtc, }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
+declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot, webrtc, onStatusChange, }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
 
 interface CallScreenProps {
     /** The signed-in user's id — the topic calls are delivered on. */
@@ -1080,6 +1089,12 @@ interface CallScreenProps {
      * that there is no audio. See {@link VoiceRoomBarProps.webrtc}.
      */
     webrtc?: NativeWebRtcModule | null;
+    /**
+     * Called whenever the call's audio connection state changes. Drive
+     * speakerphone and the proximity sensor from here — see
+     * {@link VoiceRoomBarProps.onStatusChange}.
+     */
+    onStatusChange?: (status: VoiceStatus) => void;
 }
 /**
  * WhatsApp-style call UI: a full-screen sheet that covers the app while
@@ -1096,7 +1111,7 @@ interface CallScreenProps {
  * to whatever button your UI wants. Pass the same instance in via
  * `calls` so both halves share one state machine.
  */
-declare function CallScreen({ userId, labelFor, calls: external, webrtc }: CallScreenProps): react_jsx_runtime.JSX.Element;
+declare function CallScreen({ userId, labelFor, calls: external, webrtc, onStatusChange, }: CallScreenProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Bridges iOS PushKit + CallKit to poolse calls, so a call rings a
@@ -1175,6 +1190,19 @@ interface UseVoipCallsOptions {
     onDecline?: (call: VoipIncomingCall) => void;
     /** CallKit display name for your app. Shown on the lock screen. */
     appName?: string;
+    /**
+     * Which APNs environment issued this build's PushKit token — it must
+     * match the app's `aps-environment` entitlement.
+     *
+     * Pass it explicitly. The fallback guesses from `__DEV__`, which
+     * describes the JS bundle and NOT the entitlement: an ad-hoc or
+     * TestFlight build has `__DEV__ === false` while still carrying the
+     * `development` entitlement, so it receives a sandbox token and
+     * reports it as production. The server then pushes to the wrong
+     * environment, Apple answers BadDeviceToken, and the phone never
+     * rings — with nothing in the app to suggest why.
+     */
+    apnsEnvironment?: 'production' | 'sandbox';
 }
 /**
  * Registers this device for VoIP pushes and wires the native call UI.
@@ -1182,6 +1210,6 @@ interface UseVoipCallsOptions {
  * Safe to mount once at the app root. Does nothing on Android, which
  * needs a separate FCM + ConnectionService integration.
  */
-declare function useVoipCalls({ voipPush, callKeep, onAnswer, onDecline, appName, }: UseVoipCallsOptions): void;
+declare function useVoipCalls({ voipPush, callKeep, onAnswer, onDecline, appName, apnsEnvironment, }: UseVoipCallsOptions): void;
 
 export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, type CallKeepModule, CallScreen, type CallScreenProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, DaySeparator, type DaySeparatorProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListItem, type MessageListProps, MessageRow, type MessageRowProps, type NativeWebRtcModule, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, type UseVoipCallsOptions, UserName, type UserNameProps, VoiceRoomBar, type VoiceRoomBarProps, type VoipIncomingCall, type VoipPushModule, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, isNativeWebRtcAvailable, useAppStateLifecycle, useDisplayName, usePoolseTheme, useVoipCalls };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import * as react from 'react';
 import { ReactNode, ReactElement } from 'react';
-import { Conversation, Uuid, Message, AttachmentUploadInput, Membership, Attachment, WebRtcAdapter } from '@poolse/sdk';
+import { Conversation, Uuid, Message, AttachmentUploadInput, Membership, Attachment, WebRtcAdapter, VoiceStatus } from '@poolse/sdk';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { UseCalls } from '@poolse/react';
 
@@ -1045,6 +1045,15 @@ interface VoiceRoomBarProps {
      * want in Expo Go.
      */
     webrtc?: NativeWebRtcModule | null;
+    /**
+     * Called whenever the room's connection state changes.
+     *
+     * Audio routing is the app's job — speakerphone, the proximity sensor
+     * that blanks the screen at your ear, and holding the audio session
+     * open all need a native module this package deliberately doesn't
+     * depend on. Use this to start and stop it.
+     */
+    onStatusChange?: (status: VoiceStatus) => void;
     /** Resolves a user id to a display label. Defaults to a short id. */
     labelFor?: (userId: string) => string;
     /**
@@ -1061,7 +1070,7 @@ interface VoiceRoomBarProps {
  * always-on voice channel. For ringing a specific person, use
  * `<IncomingCallSheet>` together with `useCalls`.
  */
-declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot, webrtc, }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
+declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot, webrtc, onStatusChange, }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
 
 interface CallScreenProps {
     /** The signed-in user's id — the topic calls are delivered on. */
@@ -1080,6 +1089,12 @@ interface CallScreenProps {
      * that there is no audio. See {@link VoiceRoomBarProps.webrtc}.
      */
     webrtc?: NativeWebRtcModule | null;
+    /**
+     * Called whenever the call's audio connection state changes. Drive
+     * speakerphone and the proximity sensor from here — see
+     * {@link VoiceRoomBarProps.onStatusChange}.
+     */
+    onStatusChange?: (status: VoiceStatus) => void;
 }
 /**
  * WhatsApp-style call UI: a full-screen sheet that covers the app while
@@ -1096,7 +1111,7 @@ interface CallScreenProps {
  * to whatever button your UI wants. Pass the same instance in via
  * `calls` so both halves share one state machine.
  */
-declare function CallScreen({ userId, labelFor, calls: external, webrtc }: CallScreenProps): react_jsx_runtime.JSX.Element;
+declare function CallScreen({ userId, labelFor, calls: external, webrtc, onStatusChange, }: CallScreenProps): react_jsx_runtime.JSX.Element;
 
 /**
  * Bridges iOS PushKit + CallKit to poolse calls, so a call rings a
@@ -1175,6 +1190,19 @@ interface UseVoipCallsOptions {
     onDecline?: (call: VoipIncomingCall) => void;
     /** CallKit display name for your app. Shown on the lock screen. */
     appName?: string;
+    /**
+     * Which APNs environment issued this build's PushKit token — it must
+     * match the app's `aps-environment` entitlement.
+     *
+     * Pass it explicitly. The fallback guesses from `__DEV__`, which
+     * describes the JS bundle and NOT the entitlement: an ad-hoc or
+     * TestFlight build has `__DEV__ === false` while still carrying the
+     * `development` entitlement, so it receives a sandbox token and
+     * reports it as production. The server then pushes to the wrong
+     * environment, Apple answers BadDeviceToken, and the phone never
+     * rings — with nothing in the app to suggest why.
+     */
+    apnsEnvironment?: 'production' | 'sandbox';
 }
 /**
  * Registers this device for VoIP pushes and wires the native call UI.
@@ -1182,6 +1210,6 @@ interface UseVoipCallsOptions {
  * Safe to mount once at the app root. Does nothing on Android, which
  * needs a separate FCM + ConnectionService integration.
  */
-declare function useVoipCalls({ voipPush, callKeep, onAnswer, onDecline, appName, }: UseVoipCallsOptions): void;
+declare function useVoipCalls({ voipPush, callKeep, onAnswer, onDecline, appName, apnsEnvironment, }: UseVoipCallsOptions): void;
 
 export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, type CallKeepModule, CallScreen, type CallScreenProps, ChatHeader, type ChatHeaderProps, ConversationList, type ConversationListProps, ConversationView, type ConversationViewProps, DaySeparator, type DaySeparatorProps, GroupDetailsSheet, type GroupDetailsSheetProps, type IconName, ImageMosaic, type ImageMosaicProps, type InboxUser, MemberList, type MemberListProps, MentionInput, type MentionInputProps, MessageActions, type MessageActionsProps, MessageBubble, type MessageBubbleProps, MessageComposer, type MessageComposerProps, MessageList, type MessageListItem, type MessageListProps, MessageRow, type MessageRowProps, type NativeWebRtcModule, PoolseIcon, type PoolseIconProps, PoolseInbox, type PoolseInboxHandle, type PoolseInboxProps, PoolseLogo, type PoolseLogoProps, type PoolseLogoVariant, type PoolseRNTheme, type PoolseRNThemeOverrides, PoolseTheme, type PoolseThemeProps, primitives as Primitives, ReactionPicker, type ReactionPickerProps, ReactionStrip, type ReactionStripProps, type ThemeColors, type ThemeRadii, type ThemeShadows, type ThemeSpacing, type ThemeType, ThreadView, type ThreadViewProps, TypingIndicator, type TypingIndicatorProps, UploadQueueStrip, type UseVoipCallsOptions, UserName, type UserNameProps, VoiceRoomBar, type VoiceRoomBarProps, type VoipIncomingCall, type VoipPushModule, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, isNativeWebRtcAvailable, useAppStateLifecycle, useDisplayName, usePoolseTheme, useVoipCalls };

package/dist/index.js

@@ -4945,7 +4945,8 @@ function VoiceRoomBar({
   conversationId,
   labelFor,
   unavailableSlot,
-  webrtc
+  webrtc,
+  onStatusChange
 }) {
   const theme = usePoolseTheme();
   const available = isNativeWebRtcAvailable(webrtc);
@@ -4957,6 +4958,9 @@ function VoiceRoomBar({
     available ? conversationId : null,
     opts
   );
+  useEffect(() => {
+    onStatusChange?.(status);
+  }, [status, onStatusChange]);
   const label = labelFor ?? ((id) => `User ${id.slice(0, 6)}`);
   const connected = status === "connected";
   if (!available) {
@@ -5079,7 +5083,13 @@ var styles23 = StyleSheet.create({
   hint: { fontSize: 13, flexShrink: 1 },
   error: { fontSize: 12, marginTop: 6 }
 });
-function CallScreen({ userId, labelFor, calls: external, webrtc }) {
+function CallScreen({
+  userId,
+  labelFor,
+  calls: external,
+  webrtc,
+  onStatusChange
+}) {
   const theme = usePoolseTheme();
   const own = useCalls(external ? null : userId);
   const calls = external ?? own;
@@ -5095,6 +5105,9 @@ function CallScreen({ userId, labelFor, calls: external, webrtc }) {
   useEffect(() => {
     if (calls.phase === "active" && voice.status === "idle") void voice.join();
   }, [calls.phase, voice]);
+  useEffect(() => {
+    onStatusChange?.(voice.status);
+  }, [voice.status, onStatusChange]);
   const label = labelFor ?? ((id) => `User ${id.slice(0, 6)}`);
   const visible = calls.phase !== "idle";
   const hangUp = () => {
@@ -5199,7 +5212,8 @@ function useVoipCalls({
   callKeep,
   onAnswer,
   onDecline,
-  appName = "poolse"
+  appName = "poolse",
+  apnsEnvironment
 }) {
   const poolse = usePoolse();
   const pending = useRef(/* @__PURE__ */ new Map());
@@ -5233,7 +5247,11 @@ function useVoipCalls({
     });
     voipPush.addEventListener("register", ((token) => {
       if (cancelled || !token) return;
-      void poolse.devices.register({ token, platform: "ios", environment: apnsEnvironment() }).catch(() => {
+      void poolse.devices.register({
+        token,
+        platform: "ios",
+        environment: apnsEnvironment ?? guessApnsEnvironment()
+      }).catch(() => {
       });
     }));
     voipPush.addEventListener("notification", ((payload) => {
@@ -5264,9 +5282,9 @@ function useVoipCalls({
       callKeep.removeEventListener("answerCall");
       callKeep.removeEventListener("endCall");
     };
-  }, [poolse, voipPush, callKeep, appName]);
+  }, [poolse, voipPush, callKeep, appName, apnsEnvironment]);
 }
-function apnsEnvironment() {
+function guessApnsEnvironment() {
   return __DEV__ ? "sandbox" : "production";
 }