@poolse/react 2.9.0 → 2.10.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall } from '@poolse/sdk';
+import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia } from '@poolse/sdk';
 export { ApiError, Attachment, AttachmentStatus, AttachmentUploadInput, AttachmentUploadRequest, AttachmentUploadResponse, AuthError, Conversation, ConversationCreateRequest, Me, MemberRole, Membership, Message, MessageCreateRequest, MessageType, NetworkError, PoolseConfig, PoolseError, PoolseUserProfile, RateLimitedError, RealtimeStatus, Uuid } from '@poolse/sdk';
 import { ReactNode } from 'react';
 
@@ -485,6 +485,63 @@ declare function sameDay(a: string, b: string): boolean;
  */
 declare function formatDayLabel(iso: string, now?: Date): string;
 
+interface UseCallRoomOptions {
+    /**
+     * `livekit-client`, imported by your app:
+     *
+     *     import * as livekit from 'livekit-client';
+     *
+     * Passed in rather than imported by the SDK because Metro bundles from
+     * the static import graph and cannot follow the `require` that tsup
+     * emits — a dependency the SDK imports for itself never reaches a
+     * React Native bundle.
+     */
+    livekit: LiveKitModule;
+    /** Publish the camera on join. An audio call starts with it off. */
+    video?: boolean;
+    /** Join muted. */
+    muted?: boolean;
+}
+interface UseCallRoom {
+    status: CallRoomStatus;
+    /** Everyone on the call, the local participant first. */
+    participants: CallParticipant[];
+    cameraEnabled: boolean;
+    micEnabled: boolean;
+    error: Error | null;
+    /**
+     * Whether this deployment has an SFU.
+     *
+     * `null` until a join has been attempted, then `false` if the API
+     * answered 503. A `false` here is not a failure — it means fall back
+     * to `useVoiceRoom`, which is how every call worked before the SFU.
+     */
+    sfuAvailable: boolean | null;
+    /** Connect. Resolves `false` when there is no SFU. */
+    join: () => Promise<boolean>;
+    leave: () => void;
+    setCameraEnabled: (enabled: boolean) => Promise<void>;
+    toggleCamera: () => Promise<void>;
+    setMicrophoneEnabled: (enabled: boolean) => Promise<void>;
+    toggleMic: () => Promise<void>;
+}
+/**
+ * A call's media, carried by the SFU.
+ *
+ * Media only. Ringing, accept/decline/hangup and the poolse roster stay
+ * with `useCalls` and `useVoiceRoom`; this is what people sound and look
+ * like. A call screen normally uses both.
+ *
+ *     const media = useCallRoom(conversationId, { livekit, video: true });
+ *     await media.join();
+ *     await media.toggleCamera();
+ *
+ * Both the camera and the microphone can be turned on and off at any
+ * point during the call — that is the SFU's doing, since renegotiating a
+ * live connection is exactly what the peer-to-peer mesh cannot do.
+ */
+declare function useCallRoom(conversationId: string | null, opts: UseCallRoomOptions): UseCallRoom;
+
 interface UseVoiceRoom {
     status: VoiceStatus;
     /** Everyone currently in the room, oldest join first. */
@@ -550,9 +607,17 @@ interface UseCalls {
      * `active` — the same id for both caller and callee.
      */
     activeConversationId: string | null;
+    /**
+     * What the current call opened as.
+     *
+     * `'audio'` when nothing is in flight. Either side can still turn
+     * their camera on mid-call — this is what was rung, which is what the
+     * incoming UI has to commit to before the user answers.
+     */
+    media: CallMedia;
     error: Error | null;
     /** Ring every other member of a conversation. */
-    call: (conversationId: string) => Promise<void>;
+    call: (conversationId: string, media?: CallMedia) => Promise<void>;
     /**
      * Answer the inbound ring.
      *
@@ -600,4 +665,4 @@ interface UseCalls {
  */
 declare function useCalls(userId: string | null, opts?: UseCallsOptions): UseCalls;
 
-export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCalls, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
+export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall } from '@poolse/sdk';
+import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia } from '@poolse/sdk';
 export { ApiError, Attachment, AttachmentStatus, AttachmentUploadInput, AttachmentUploadRequest, AttachmentUploadResponse, AuthError, Conversation, ConversationCreateRequest, Me, MemberRole, Membership, Message, MessageCreateRequest, MessageType, NetworkError, PoolseConfig, PoolseError, PoolseUserProfile, RateLimitedError, RealtimeStatus, Uuid } from '@poolse/sdk';
 import { ReactNode } from 'react';
 
@@ -485,6 +485,63 @@ declare function sameDay(a: string, b: string): boolean;
  */
 declare function formatDayLabel(iso: string, now?: Date): string;
 
+interface UseCallRoomOptions {
+    /**
+     * `livekit-client`, imported by your app:
+     *
+     *     import * as livekit from 'livekit-client';
+     *
+     * Passed in rather than imported by the SDK because Metro bundles from
+     * the static import graph and cannot follow the `require` that tsup
+     * emits — a dependency the SDK imports for itself never reaches a
+     * React Native bundle.
+     */
+    livekit: LiveKitModule;
+    /** Publish the camera on join. An audio call starts with it off. */
+    video?: boolean;
+    /** Join muted. */
+    muted?: boolean;
+}
+interface UseCallRoom {
+    status: CallRoomStatus;
+    /** Everyone on the call, the local participant first. */
+    participants: CallParticipant[];
+    cameraEnabled: boolean;
+    micEnabled: boolean;
+    error: Error | null;
+    /**
+     * Whether this deployment has an SFU.
+     *
+     * `null` until a join has been attempted, then `false` if the API
+     * answered 503. A `false` here is not a failure — it means fall back
+     * to `useVoiceRoom`, which is how every call worked before the SFU.
+     */
+    sfuAvailable: boolean | null;
+    /** Connect. Resolves `false` when there is no SFU. */
+    join: () => Promise<boolean>;
+    leave: () => void;
+    setCameraEnabled: (enabled: boolean) => Promise<void>;
+    toggleCamera: () => Promise<void>;
+    setMicrophoneEnabled: (enabled: boolean) => Promise<void>;
+    toggleMic: () => Promise<void>;
+}
+/**
+ * A call's media, carried by the SFU.
+ *
+ * Media only. Ringing, accept/decline/hangup and the poolse roster stay
+ * with `useCalls` and `useVoiceRoom`; this is what people sound and look
+ * like. A call screen normally uses both.
+ *
+ *     const media = useCallRoom(conversationId, { livekit, video: true });
+ *     await media.join();
+ *     await media.toggleCamera();
+ *
+ * Both the camera and the microphone can be turned on and off at any
+ * point during the call — that is the SFU's doing, since renegotiating a
+ * live connection is exactly what the peer-to-peer mesh cannot do.
+ */
+declare function useCallRoom(conversationId: string | null, opts: UseCallRoomOptions): UseCallRoom;
+
 interface UseVoiceRoom {
     status: VoiceStatus;
     /** Everyone currently in the room, oldest join first. */
@@ -550,9 +607,17 @@ interface UseCalls {
      * `active` — the same id for both caller and callee.
      */
     activeConversationId: string | null;
+    /**
+     * What the current call opened as.
+     *
+     * `'audio'` when nothing is in flight. Either side can still turn
+     * their camera on mid-call — this is what was rung, which is what the
+     * incoming UI has to commit to before the user answers.
+     */
+    media: CallMedia;
     error: Error | null;
     /** Ring every other member of a conversation. */
-    call: (conversationId: string) => Promise<void>;
+    call: (conversationId: string, media?: CallMedia) => Promise<void>;
     /**
      * Answer the inbound ring.
      *
@@ -600,4 +665,4 @@ interface UseCalls {
  */
 declare function useCalls(userId: string | null, opts?: UseCallsOptions): UseCalls;
 
-export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCalls, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
+export { type CallPhase, type GroupPosition, PoolseProvider, type PoolseProviderProps, type ReactionMap, type UploadItem, type UploadItemStatus, type UseCallRoom, type UseCallRoomOptions, type UseCalls, type UseUserState, type UseVoiceRoom, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };

package/dist/index.js

@@ -1062,6 +1062,112 @@ function formatDayLabel(iso, now = /* @__PURE__ */ new Date()) {
   }
   return d.toLocaleDateString(void 0, { day: "numeric", month: "short", year: "numeric" });
 }
+function useCallRoom(conversationId, opts) {
+  const poolse = usePoolse();
+  const [status, setStatus] = useState("idle");
+  const [participants, setParticipants] = useState([]);
+  const [cameraEnabled, setCamera] = useState(false);
+  const [micEnabled, setMic] = useState(false);
+  const [error, setError] = useState(null);
+  const [sfuAvailable, setSfuAvailable] = useState(null);
+  const optsRef = useRef(opts);
+  const joined = useRef(false);
+  const room = useMemo(() => {
+    if (!conversationId) return null;
+    return poolse.call(conversationId, {
+      livekit: optsRef.current.livekit,
+      ...optsRef.current.video !== void 0 ? { video: optsRef.current.video } : {},
+      ...optsRef.current.muted !== void 0 ? { muted: optsRef.current.muted } : {}
+    });
+  }, [poolse, conversationId]);
+  const sync = useCallback((target) => {
+    if (!target) return;
+    setCamera(target.isCameraEnabled());
+    setMic(target.isMicrophoneEnabled());
+  }, []);
+  useEffect(() => {
+    if (!room) {
+      setStatus("idle");
+      setParticipants([]);
+      return;
+    }
+    setStatus(room.getStatus());
+    setParticipants(room.getParticipants());
+    const offStatus = room.onStatus(setStatus);
+    const offRoster = room.onParticipants((next) => {
+      setParticipants(next);
+      sync(room);
+    });
+    const offError = room.onError(setError);
+    return () => {
+      offStatus();
+      offRoster();
+      offError();
+      if (joined.current) {
+        joined.current = false;
+        room.leave();
+      }
+    };
+  }, [room, sync]);
+  const join = useCallback(async () => {
+    if (!room) return false;
+    setError(null);
+    try {
+      const connected = await room.join();
+      joined.current = connected;
+      setSfuAvailable(connected);
+      sync(room);
+      return connected;
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+      setSfuAvailable(true);
+      return false;
+    }
+  }, [room, sync]);
+  const leave = useCallback(() => {
+    if (!joined.current) return;
+    joined.current = false;
+    room?.leave();
+  }, [room]);
+  const setCameraEnabled = useCallback(
+    async (enabled) => {
+      if (!room) return;
+      await room.setCameraEnabled(enabled);
+      sync(room);
+    },
+    [room, sync]
+  );
+  const setMicrophoneEnabled = useCallback(
+    async (enabled) => {
+      if (!room) return;
+      await room.setMicrophoneEnabled(enabled);
+      sync(room);
+    },
+    [room, sync]
+  );
+  const toggleCamera = useCallback(async () => {
+    if (!room) return;
+    await setCameraEnabled(!room.isCameraEnabled());
+  }, [room, setCameraEnabled]);
+  const toggleMic = useCallback(async () => {
+    if (!room) return;
+    await setMicrophoneEnabled(!room.isMicrophoneEnabled());
+  }, [room, setMicrophoneEnabled]);
+  return {
+    status,
+    participants,
+    cameraEnabled,
+    micEnabled,
+    error,
+    sfuAvailable,
+    join,
+    leave,
+    setCameraEnabled,
+    toggleCamera,
+    setMicrophoneEnabled,
+    toggleMic
+  };
+}
 function useVoiceRoom(conversationId, opts = {}) {
   const poolse = usePoolse();
   const [status, setStatus] = useState("idle");
@@ -1176,11 +1282,11 @@ function useCalls(userId, opts = {}) {
     };
   }, [calls]);
   const call = useCallback(
-    async (conversationId) => {
+    async (conversationId, media2 = "audio") => {
       if (!calls) return;
       setError(null);
       try {
-        const placed = await calls.invite(conversationId);
+        const placed = await calls.invite(conversationId, media2);
         setOutgoing(placed);
         setPhase("ringing-out");
       } catch (err) {
@@ -1271,11 +1377,13 @@ function useCalls(userId, opts = {}) {
     setActiveConversationId(null);
     setError(null);
   }, []);
+  const media = incoming?.media ?? outgoing?.media ?? "audio";
   return {
     phase,
     incoming,
     outgoing,
     activeConversationId,
+    media,
     error,
     call,
     accept,
@@ -1286,6 +1394,6 @@ function useCalls(userId, opts = {}) {
   };
 }
 
-export { PoolseProvider, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
+export { PoolseProvider, computeGroupPosition, formatDayLabel, sameDay, sameGroup, useAttachmentUpload, useAttachmentUrl, useCallRoom, useCalls, useConversation, useConversations, useMe, useMembers, useMessages, usePoolse, usePresence, useReactions, useRealtimeStatus, useThread, useTyping, useUser, useVoiceRoom };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map