@poolse/react-native 2.3.0 → 2.4.0

package/dist/index.d.cts

@@ -1098,4 +1098,81 @@ interface CallScreenProps {
  */
 declare function CallScreen({ userId, labelFor, calls: external, webrtc }: CallScreenProps): react_jsx_runtime.JSX.Element;
 
-export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, 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, UserName, type UserNameProps, VoiceRoomBar, type VoiceRoomBarProps, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, isNativeWebRtcAvailable, useAppStateLifecycle, useDisplayName, usePoolseTheme };
+/**
+ * Bridges iOS PushKit + CallKit to poolse calls, so a call rings a
+ * backgrounded or closed app.
+ *
+ * ## Why this is needed at all
+ *
+ * `call:incoming` travels over the WebSocket, which only exists while
+ * the app is foregrounded — iOS suspends sockets on background and
+ * drops them on close. Reaching a sleeping phone requires the OS to wake
+ * the app, which means a VoIP push against a PushKit token.
+ *
+ * ## The rule Apple enforces
+ *
+ * Every delivered VoIP push MUST report an incoming call to CallKit,
+ * essentially immediately. Miss it and iOS terminates the app; do it
+ * repeatedly and the system stops delivering VoIP pushes to you at all.
+ * `reportCall` below is not optional politeness — it is the contract.
+ *
+ * ## Dependencies
+ *
+ * `react-native-voip-push-notification` and `react-native-callkeep`,
+ * both native, both requiring a development build. Like
+ * `react-native-webrtc`, Metro only bundles what it can see statically,
+ * so YOUR APP imports them and passes them in:
+ *
+ *     import VoipPushNotification from 'react-native-voip-push-notification';
+ *     import RNCallKeep from 'react-native-callkeep';
+ *
+ *     useVoipCalls({
+ *       voipPush: VoipPushNotification,
+ *       callKeep: RNCallKeep,
+ *       onAnswer: (call) => { ... },
+ *     });
+ */
+/** The slice of `react-native-voip-push-notification` used here. */
+interface VoipPushModule {
+    addEventListener(event: 'register' | 'notification' | 'didLoadWithEvents', handler: (payload: never) => void): void;
+    removeEventListener(event: string): void;
+    registerVoipToken(): void;
+}
+/** The slice of `react-native-callkeep` used here. */
+interface CallKeepModule {
+    setup(options: unknown): Promise<void>;
+    displayIncomingCall(uuid: string, handle: string, localizedCallerName?: string, handleType?: string, hasVideo?: boolean): void;
+    endCall(uuid: string): void;
+    addEventListener(event: string, handler: (payload: never) => void): void;
+    removeEventListener(event: string): void;
+}
+/** An inbound call, as it arrives inside a VoIP push payload. */
+interface VoipIncomingCall {
+    callId: string;
+    conversationId: string;
+    callerUserId: string;
+    callerName: string;
+}
+interface UseVoipCallsOptions {
+    voipPush: VoipPushModule;
+    callKeep: CallKeepModule;
+    /**
+     * Fired when the user answers from the native call UI. Accept the
+     * call and join the room here — the app may have been launched cold,
+     * so don't assume any prior state.
+     */
+    onAnswer?: (call: VoipIncomingCall) => void;
+    /** Fired when the user declines from the native call UI. */
+    onDecline?: (call: VoipIncomingCall) => void;
+    /** CallKit display name for your app. Shown on the lock screen. */
+    appName?: string;
+}
+/**
+ * Registers this device for VoIP pushes and wires the native call UI.
+ *
+ * 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;
+
+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

@@ -1098,4 +1098,81 @@ interface CallScreenProps {
  */
 declare function CallScreen({ userId, labelFor, calls: external, webrtc }: CallScreenProps): react_jsx_runtime.JSX.Element;
 
-export { AttachmentPicker, type AttachmentPickerProps, AttachmentPreview, type AttachmentPreviewProps, Avatar, type AvatarProps, 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, UserName, type UserNameProps, VoiceRoomBar, type VoiceRoomBarProps, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, isNativeWebRtcAvailable, useAppStateLifecycle, useDisplayName, usePoolseTheme };
+/**
+ * Bridges iOS PushKit + CallKit to poolse calls, so a call rings a
+ * backgrounded or closed app.
+ *
+ * ## Why this is needed at all
+ *
+ * `call:incoming` travels over the WebSocket, which only exists while
+ * the app is foregrounded — iOS suspends sockets on background and
+ * drops them on close. Reaching a sleeping phone requires the OS to wake
+ * the app, which means a VoIP push against a PushKit token.
+ *
+ * ## The rule Apple enforces
+ *
+ * Every delivered VoIP push MUST report an incoming call to CallKit,
+ * essentially immediately. Miss it and iOS terminates the app; do it
+ * repeatedly and the system stops delivering VoIP pushes to you at all.
+ * `reportCall` below is not optional politeness — it is the contract.
+ *
+ * ## Dependencies
+ *
+ * `react-native-voip-push-notification` and `react-native-callkeep`,
+ * both native, both requiring a development build. Like
+ * `react-native-webrtc`, Metro only bundles what it can see statically,
+ * so YOUR APP imports them and passes them in:
+ *
+ *     import VoipPushNotification from 'react-native-voip-push-notification';
+ *     import RNCallKeep from 'react-native-callkeep';
+ *
+ *     useVoipCalls({
+ *       voipPush: VoipPushNotification,
+ *       callKeep: RNCallKeep,
+ *       onAnswer: (call) => { ... },
+ *     });
+ */
+/** The slice of `react-native-voip-push-notification` used here. */
+interface VoipPushModule {
+    addEventListener(event: 'register' | 'notification' | 'didLoadWithEvents', handler: (payload: never) => void): void;
+    removeEventListener(event: string): void;
+    registerVoipToken(): void;
+}
+/** The slice of `react-native-callkeep` used here. */
+interface CallKeepModule {
+    setup(options: unknown): Promise<void>;
+    displayIncomingCall(uuid: string, handle: string, localizedCallerName?: string, handleType?: string, hasVideo?: boolean): void;
+    endCall(uuid: string): void;
+    addEventListener(event: string, handler: (payload: never) => void): void;
+    removeEventListener(event: string): void;
+}
+/** An inbound call, as it arrives inside a VoIP push payload. */
+interface VoipIncomingCall {
+    callId: string;
+    conversationId: string;
+    callerUserId: string;
+    callerName: string;
+}
+interface UseVoipCallsOptions {
+    voipPush: VoipPushModule;
+    callKeep: CallKeepModule;
+    /**
+     * Fired when the user answers from the native call UI. Accept the
+     * call and join the room here — the app may have been launched cold,
+     * so don't assume any prior state.
+     */
+    onAnswer?: (call: VoipIncomingCall) => void;
+    /** Fired when the user declines from the native call UI. */
+    onDecline?: (call: VoipIncomingCall) => void;
+    /** CallKit display name for your app. Shown on the lock screen. */
+    appName?: string;
+}
+/**
+ * Registers this device for VoIP pushes and wires the native call UI.
+ *
+ * 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;
+
+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

@@ -5194,7 +5194,82 @@ var styles24 = StyleSheet.create({
   callBtnText: { color: "#ffffff", fontSize: 16, fontWeight: "600" },
   warn: { fontSize: 12, textAlign: "center", marginTop: 12 }
 });
+function useVoipCalls({
+  voipPush,
+  callKeep,
+  onAnswer,
+  onDecline,
+  appName = "poolse"
+}) {
+  const poolse = usePoolse();
+  const pending = useRef(/* @__PURE__ */ new Map());
+  const handlers = useRef({ onAnswer, onDecline });
+  handlers.current = { onAnswer, onDecline };
+  useEffect(() => {
+    let cancelled = false;
+    const reportCall = (payload) => {
+      const callId = payload.call_id;
+      const conversationId = payload.conversation_id;
+      if (!callId || !conversationId) return;
+      const call = {
+        callId,
+        conversationId,
+        callerUserId: payload.caller_user_id ?? "",
+        callerName: payload.caller_name ?? "Incoming call"
+      };
+      pending.current.set(callId, call);
+      callKeep.displayIncomingCall(callId, call.callerUserId, call.callerName, "generic", false);
+    };
+    void callKeep.setup({
+      ios: { appName },
+      android: {
+        alertTitle: "Permissions required",
+        alertDescription: "Allow calls from this app",
+        cancelButton: "Cancel",
+        okButton: "ok",
+        additionalPermissions: []
+      }
+    }).catch(() => {
+    });
+    voipPush.addEventListener("register", ((token) => {
+      if (cancelled || !token) return;
+      void poolse.devices.register({ token, platform: "ios", environment: apnsEnvironment() }).catch(() => {
+      });
+    }));
+    voipPush.addEventListener("notification", ((payload) => {
+      reportCall(payload);
+    }));
+    voipPush.addEventListener("didLoadWithEvents", ((events) => {
+      for (const event of events ?? []) {
+        if (event.name === "RNVoipPushRemoteNotificationReceivedEvent") {
+          reportCall(event.data);
+        }
+      }
+    }));
+    callKeep.addEventListener("answerCall", (({ callUUID }) => {
+      const call = pending.current.get(callUUID);
+      if (call) handlers.current.onAnswer?.(call);
+    }));
+    callKeep.addEventListener("endCall", (({ callUUID }) => {
+      const call = pending.current.get(callUUID);
+      pending.current.delete(callUUID);
+      if (call) handlers.current.onDecline?.(call);
+    }));
+    voipPush.registerVoipToken();
+    return () => {
+      cancelled = true;
+      voipPush.removeEventListener("register");
+      voipPush.removeEventListener("notification");
+      voipPush.removeEventListener("didLoadWithEvents");
+      callKeep.removeEventListener("answerCall");
+      callKeep.removeEventListener("endCall");
+    };
+  }, [poolse, voipPush, callKeep, appName]);
+}
+function apnsEnvironment() {
+  return __DEV__ ? "sandbox" : "production";
+}
 
-export { AttachmentPicker, AttachmentPreview, Avatar, CallScreen, ChatHeader, ConversationList, ConversationView, DaySeparator, GroupDetailsSheet, ImageMosaic, MemberList, MentionInput, MessageActions, MessageBubble, MessageComposer, MessageList, MessageRow, PoolseIcon, PoolseInbox, PoolseLogo, PoolseTheme, primitives as Primitives, ReactionPicker, ReactionStrip, ThreadView, TypingIndicator, UploadQueueStrip, UserName, VoiceRoomBar, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, isNativeWebRtcAvailable, useAppStateLifecycle, useDisplayName, usePoolseTheme };
+export { AttachmentPicker, AttachmentPreview, Avatar, CallScreen, ChatHeader, ConversationList, ConversationView, DaySeparator, GroupDetailsSheet, ImageMosaic, MemberList, MentionInput, MessageActions, MessageBubble, MessageComposer, MessageList, MessageRow, PoolseIcon, PoolseInbox, PoolseLogo, PoolseTheme, primitives as Primitives, ReactionPicker, ReactionStrip, ThreadView, TypingIndicator, UploadQueueStrip, UserName, VoiceRoomBar, createNativeWebRtcAdapter, defaultDarkTheme, defaultLightTheme, isNativeWebRtcAvailable, useAppStateLifecycle, useDisplayName, usePoolseTheme, useVoipCalls };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map