@poolse/react-native 2.2.0 → 2.3.0

package/dist/index.d.cts

@@ -977,8 +977,74 @@ declare const defaultDarkTheme: PoolseRNTheme;
  */
 declare function useAppStateLifecycle(): void;
 
+/**
+ * React Native WebRTC binding, backed by `react-native-webrtc`.
+ *
+ * The module is passed IN rather than required here, and that is
+ * deliberate. Metro resolves dependencies statically, and this package
+ * is published through tsup, which rewrites a literal `require(...)`
+ * into a `__require(...)` call it cannot see — so bundling
+ * `react-native-webrtc` from inside this file never worked. It wasn't
+ * merely unavailable in Expo Go; it was absent from every bundle,
+ * development builds included, and surfaced as
+ * "Requiring unknown module react-native-webrtc" at runtime.
+ *
+ * Importing it in the app fixes that: Metro sees a static import in
+ * your source and bundles it. Optionality then lives where it belongs —
+ * an app that doesn't want voice simply never imports it, and never
+ * installs the native dependency.
+ *
+ *     import * as webrtc from 'react-native-webrtc';
+ *     <VoiceRoomBar conversationId={id} webrtc={webrtc} />
+ *
+ * Media streams on native aren't attached to an element the way they
+ * are on the web — audio-only calls route to the device's audio session
+ * once the peer connection is live, so the sink is a no-op. Video would
+ * render the stream through `<RTCView>` via the `toURL()` it exposes.
+ */
+
+/**
+ * The shape this binding needs from `react-native-webrtc`. The module's
+ * own namespace satisfies it, so `import * as webrtc` type-checks
+ * straight through.
+ */
+interface NativeWebRtcModule {
+    RTCPeerConnection: new (...args: never[]) => unknown;
+    mediaDevices: {
+        getUserMedia: (...args: never[]) => Promise<unknown>;
+    };
+}
+/**
+ * True when `mod` looks like a usable `react-native-webrtc`.
+ *
+ * Guards against a half-linked native module: in a bare Expo Go client
+ * the JS may load while the native side is missing, leaving
+ * `RTCPeerConnection` undefined.
+ */
+declare function isNativeWebRtcAvailable(mod: NativeWebRtcModule | null | undefined): boolean;
+/**
+ * Adapter for `useVoiceRoom`'s `webrtc` option.
+ *
+ * @param mod the `react-native-webrtc` module, imported by your app.
+ * @throws when `mod` isn't a usable binding — check
+ *         {@link isNativeWebRtcAvailable} first if that's reachable in
+ *         your UI.
+ */
+declare function createNativeWebRtcAdapter(mod: NativeWebRtcModule): WebRtcAdapter;
+
 interface VoiceRoomBarProps {
     conversationId: string;
+    /**
+     * The `react-native-webrtc` module, imported by your app:
+     *
+     *     import * as webrtc from 'react-native-webrtc';
+     *
+     * Required for audio. Metro only bundles what it can see statically,
+     * so this package cannot import it for you — see `voice/webrtc-native`.
+     * Omit it and the bar renders its unavailable state, which is what you
+     * want in Expo Go.
+     */
+    webrtc?: NativeWebRtcModule | null;
     /** Resolves a user id to a display label. Defaults to a short id. */
     labelFor?: (userId: string) => string;
     /**
@@ -995,7 +1061,7 @@ interface VoiceRoomBarProps {
  * always-on voice channel. For ringing a specific person, use
  * `<IncomingCallSheet>` together with `useCalls`.
  */
-declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
+declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot, webrtc, }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
 
 interface CallScreenProps {
     /** The signed-in user's id — the topic calls are delivered on. */
@@ -1008,6 +1074,12 @@ interface CallScreenProps {
      * component manages its own.
      */
     calls?: UseCalls;
+    /**
+     * The `react-native-webrtc` module, imported by your app. Required for
+     * call audio; without it the screen still rings and connects but warns
+     * that there is no audio. See {@link VoiceRoomBarProps.webrtc}.
+     */
+    webrtc?: NativeWebRtcModule | null;
 }
 /**
  * WhatsApp-style call UI: a full-screen sheet that covers the app while
@@ -1024,36 +1096,6 @@ 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 }: CallScreenProps): react_jsx_runtime.JSX.Element;
-
-/**
- * React Native WebRTC binding, backed by `react-native-webrtc`.
- *
- * That package ships native code, so it can't run in Expo Go and not
- * every app wants it. It's therefore an OPTIONAL peer dependency,
- * resolved with a guarded `require` at call time rather than a static
- * import: an app that never places a call doesn't need it installed,
- * and one that does gets a clear message instead of a redbox at import.
- *
- * Media streams on native aren't attached to an element the way they
- * are on the web — audio-only calls route to the device's audio session
- * automatically once the peer connection is live, so the sink is a
- * no-op. Video would render the stream through `<RTCView>` using the
- * `toURL()` the stream exposes.
- */
-
-/**
- * Whether this app can actually carry call audio. Use it to disable a
- * call button rather than letting the user tap into a failure.
- */
-declare function isNativeWebRtcAvailable(): boolean;
-/**
- * Adapter for {@link useVoiceRoom}'s `webrtc` option.
- *
- * @throws when `react-native-webrtc` isn't installed — check
- *         {@link isNativeWebRtcAvailable} first if that's reachable in
- *         your UI.
- */
-declare function createNativeWebRtcAdapter(): WebRtcAdapter;
+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, 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 };
+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 };

package/dist/index.d.ts

@@ -977,8 +977,74 @@ declare const defaultDarkTheme: PoolseRNTheme;
  */
 declare function useAppStateLifecycle(): void;
 
+/**
+ * React Native WebRTC binding, backed by `react-native-webrtc`.
+ *
+ * The module is passed IN rather than required here, and that is
+ * deliberate. Metro resolves dependencies statically, and this package
+ * is published through tsup, which rewrites a literal `require(...)`
+ * into a `__require(...)` call it cannot see — so bundling
+ * `react-native-webrtc` from inside this file never worked. It wasn't
+ * merely unavailable in Expo Go; it was absent from every bundle,
+ * development builds included, and surfaced as
+ * "Requiring unknown module react-native-webrtc" at runtime.
+ *
+ * Importing it in the app fixes that: Metro sees a static import in
+ * your source and bundles it. Optionality then lives where it belongs —
+ * an app that doesn't want voice simply never imports it, and never
+ * installs the native dependency.
+ *
+ *     import * as webrtc from 'react-native-webrtc';
+ *     <VoiceRoomBar conversationId={id} webrtc={webrtc} />
+ *
+ * Media streams on native aren't attached to an element the way they
+ * are on the web — audio-only calls route to the device's audio session
+ * once the peer connection is live, so the sink is a no-op. Video would
+ * render the stream through `<RTCView>` via the `toURL()` it exposes.
+ */
+
+/**
+ * The shape this binding needs from `react-native-webrtc`. The module's
+ * own namespace satisfies it, so `import * as webrtc` type-checks
+ * straight through.
+ */
+interface NativeWebRtcModule {
+    RTCPeerConnection: new (...args: never[]) => unknown;
+    mediaDevices: {
+        getUserMedia: (...args: never[]) => Promise<unknown>;
+    };
+}
+/**
+ * True when `mod` looks like a usable `react-native-webrtc`.
+ *
+ * Guards against a half-linked native module: in a bare Expo Go client
+ * the JS may load while the native side is missing, leaving
+ * `RTCPeerConnection` undefined.
+ */
+declare function isNativeWebRtcAvailable(mod: NativeWebRtcModule | null | undefined): boolean;
+/**
+ * Adapter for `useVoiceRoom`'s `webrtc` option.
+ *
+ * @param mod the `react-native-webrtc` module, imported by your app.
+ * @throws when `mod` isn't a usable binding — check
+ *         {@link isNativeWebRtcAvailable} first if that's reachable in
+ *         your UI.
+ */
+declare function createNativeWebRtcAdapter(mod: NativeWebRtcModule): WebRtcAdapter;
+
 interface VoiceRoomBarProps {
     conversationId: string;
+    /**
+     * The `react-native-webrtc` module, imported by your app:
+     *
+     *     import * as webrtc from 'react-native-webrtc';
+     *
+     * Required for audio. Metro only bundles what it can see statically,
+     * so this package cannot import it for you — see `voice/webrtc-native`.
+     * Omit it and the bar renders its unavailable state, which is what you
+     * want in Expo Go.
+     */
+    webrtc?: NativeWebRtcModule | null;
     /** Resolves a user id to a display label. Defaults to a short id. */
     labelFor?: (userId: string) => string;
     /**
@@ -995,7 +1061,7 @@ interface VoiceRoomBarProps {
  * always-on voice channel. For ringing a specific person, use
  * `<IncomingCallSheet>` together with `useCalls`.
  */
-declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
+declare function VoiceRoomBar({ conversationId, labelFor, unavailableSlot, webrtc, }: VoiceRoomBarProps): react_jsx_runtime.JSX.Element;
 
 interface CallScreenProps {
     /** The signed-in user's id — the topic calls are delivered on. */
@@ -1008,6 +1074,12 @@ interface CallScreenProps {
      * component manages its own.
      */
     calls?: UseCalls;
+    /**
+     * The `react-native-webrtc` module, imported by your app. Required for
+     * call audio; without it the screen still rings and connects but warns
+     * that there is no audio. See {@link VoiceRoomBarProps.webrtc}.
+     */
+    webrtc?: NativeWebRtcModule | null;
 }
 /**
  * WhatsApp-style call UI: a full-screen sheet that covers the app while
@@ -1024,36 +1096,6 @@ 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 }: CallScreenProps): react_jsx_runtime.JSX.Element;
-
-/**
- * React Native WebRTC binding, backed by `react-native-webrtc`.
- *
- * That package ships native code, so it can't run in Expo Go and not
- * every app wants it. It's therefore an OPTIONAL peer dependency,
- * resolved with a guarded `require` at call time rather than a static
- * import: an app that never places a call doesn't need it installed,
- * and one that does gets a clear message instead of a redbox at import.
- *
- * Media streams on native aren't attached to an element the way they
- * are on the web — audio-only calls route to the device's audio session
- * automatically once the peer connection is live, so the sink is a
- * no-op. Video would render the stream through `<RTCView>` using the
- * `toURL()` the stream exposes.
- */
-
-/**
- * Whether this app can actually carry call audio. Use it to disable a
- * call button rather than letting the user tap into a failure.
- */
-declare function isNativeWebRtcAvailable(): boolean;
-/**
- * Adapter for {@link useVoiceRoom}'s `webrtc` option.
- *
- * @throws when `react-native-webrtc` isn't installed — check
- *         {@link isNativeWebRtcAvailable} first if that's reachable in
- *         your UI.
- */
-declare function createNativeWebRtcAdapter(): WebRtcAdapter;
+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, 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 };
+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 };

package/dist/index.js

@@ -4915,32 +4915,22 @@ function useAppStateLifecycle() {
 }
 
 // src/voice/webrtc-native.ts
-var cached;
-function loadNativeWebRtc() {
-  if (cached !== void 0) return cached;
-  try {
-    cached = __require("react-native-webrtc");
-  } catch {
-    cached = null;
-  }
-  return cached;
-}
-function isNativeWebRtcAvailable() {
-  return loadNativeWebRtc() != null;
+function isNativeWebRtcAvailable(mod) {
+  return typeof mod?.RTCPeerConnection === "function" && mod?.mediaDevices != null;
 }
-function createNativeWebRtcAdapter() {
-  const native = loadNativeWebRtc();
-  if (!native) {
+function createNativeWebRtcAdapter(mod) {
+  if (!isNativeWebRtcAvailable(mod)) {
     throw new Error(
-      "react-native-webrtc is not installed. Add it to enable poolse voice calls:\n  npx expo install react-native-webrtc\nIt contains native code, so it needs a development build \u2014 it will not run in Expo Go."
+      "react-native-webrtc is missing or not linked. Install it and rebuild:\n  npx expo install react-native-webrtc\nIt contains native code, so it needs a development build \u2014 it will not run in Expo Go."
     );
   }
+  const rtc = mod;
   return {
     createPeerConnection(iceServers) {
-      return new native.RTCPeerConnection({ iceServers });
+      return new rtc.RTCPeerConnection({ iceServers });
     },
     getUserMedia() {
-      return native.mediaDevices.getUserMedia({
+      return rtc.mediaDevices.getUserMedia({
         audio: { echoCancellation: true, noiseSuppression: true },
         video: false
       });
@@ -4951,12 +4941,17 @@ function createNativeWebRtcAdapter() {
     }
   };
 }
-function VoiceRoomBar({ conversationId, labelFor, unavailableSlot }) {
+function VoiceRoomBar({
+  conversationId,
+  labelFor,
+  unavailableSlot,
+  webrtc
+}) {
   const theme = usePoolseTheme();
-  const available = isNativeWebRtcAvailable();
+  const available = isNativeWebRtcAvailable(webrtc);
   const opts = useMemo(
-    () => available ? { webrtc: createNativeWebRtcAdapter() } : {},
-    [available]
+    () => available && webrtc ? { webrtc: createNativeWebRtcAdapter(webrtc) } : {},
+    [available, webrtc]
   );
   const { status, participants, muted, join, leave, toggleMute, error } = useVoiceRoom(
     available ? conversationId : null,
@@ -5084,14 +5079,14 @@ var styles23 = StyleSheet.create({
   hint: { fontSize: 13, flexShrink: 1 },
   error: { fontSize: 12, marginTop: 6 }
 });
-function CallScreen({ userId, labelFor, calls: external }) {
+function CallScreen({ userId, labelFor, calls: external, webrtc }) {
   const theme = usePoolseTheme();
   const own = useCalls(external ? null : userId);
   const calls = external ?? own;
-  const available = isNativeWebRtcAvailable();
+  const available = isNativeWebRtcAvailable(webrtc);
   const opts = useMemo(
-    () => available ? { webrtc: createNativeWebRtcAdapter() } : {},
-    [available]
+    () => available && webrtc ? { webrtc: createNativeWebRtcAdapter(webrtc) } : {},
+    [available, webrtc]
   );
   const voice = useVoiceRoom(
     calls.phase === "active" && available ? calls.activeConversationId : null,