@poolse/react 2.13.1 → 2.14.1

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, CallRoomStatus, CallParticipant, CameraFacing, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia } from '@poolse/sdk';
+import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, CameraFacing, CallDeviceKind, CallDevice, 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';
 
@@ -518,6 +518,31 @@ interface UseCallRoom {
     micEnabled: boolean;
     /** Which camera is publishing. Meaningless while the camera is off. */
     facingMode: CameraFacing;
+    /**
+     * Selectable devices, refreshed as they are plugged in and removed.
+     *
+     * The web's answer to a phone's speaker button — a laptop has no
+     * earpiece, but it does have several microphones and a pair of
+     * headphones, and choosing between them is the same job. Sparse on
+     * React Native, where routing goes through the platform audio session
+     * instead (see `useCallAudio` in `@poolse/react-native`).
+     */
+    devices: Record<CallDeviceKind, CallDevice[]>;
+    /** Device id in use per kind, where the platform reports one. */
+    activeDevices: Partial<Record<CallDeviceKind, string>>;
+    /** Move the call onto another camera, microphone or output. */
+    selectDevice: (kind: CallDeviceKind, deviceId: string) => Promise<void>;
+    /**
+     * Re-read the device list.
+     *
+     * Called for you on connect and whenever devices change, so this is
+     * for the case neither covers: a browser only reveals device ids and
+     * labels once the page holds a matching permission, and the moment
+     * that permission lands is not an event you can subscribe to. Call it
+     * when opening a picker and the list will be right by the time it is
+     * on screen.
+     */
+    refreshDevices: () => void;
     /**
      * Everyone else has gone and is not coming back.
      *

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, CallRoomStatus, CallParticipant, CameraFacing, LiveKitModule, VoiceStatus, VoiceParticipant, VoiceRoomOptions, IncomingCall, OutgoingCall, CallMedia } from '@poolse/sdk';
+import { PoolseConfig, Poolse, Me, Uuid, Conversation, ConversationCreateRequest, Membership, MemberRole, Message, MessageCreateRequest, RealtimeStatus, Attachment, AttachmentUploadInput, PoolseUserProfile, CallRoomStatus, CallParticipant, CameraFacing, CallDeviceKind, CallDevice, 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';
 
@@ -518,6 +518,31 @@ interface UseCallRoom {
     micEnabled: boolean;
     /** Which camera is publishing. Meaningless while the camera is off. */
     facingMode: CameraFacing;
+    /**
+     * Selectable devices, refreshed as they are plugged in and removed.
+     *
+     * The web's answer to a phone's speaker button — a laptop has no
+     * earpiece, but it does have several microphones and a pair of
+     * headphones, and choosing between them is the same job. Sparse on
+     * React Native, where routing goes through the platform audio session
+     * instead (see `useCallAudio` in `@poolse/react-native`).
+     */
+    devices: Record<CallDeviceKind, CallDevice[]>;
+    /** Device id in use per kind, where the platform reports one. */
+    activeDevices: Partial<Record<CallDeviceKind, string>>;
+    /** Move the call onto another camera, microphone or output. */
+    selectDevice: (kind: CallDeviceKind, deviceId: string) => Promise<void>;
+    /**
+     * Re-read the device list.
+     *
+     * Called for you on connect and whenever devices change, so this is
+     * for the case neither covers: a browser only reveals device ids and
+     * labels once the page holds a matching permission, and the moment
+     * that permission lands is not an event you can subscribe to. Call it
+     * when opening a picker and the list will be right by the time it is
+     * on screen.
+     */
+    refreshDevices: () => void;
     /**
      * Everyone else has gone and is not coming back.
      *

package/dist/index.js

@@ -1070,6 +1070,12 @@ function useCallRoom(conversationId, opts) {
   const [micEnabled, setMic] = useState(false);
   const [facingMode, setFacing] = useState(opts.facing ?? "user");
   const [alone, setAlone] = useState(false);
+  const [devices, setDevices] = useState({
+    videoinput: [],
+    audioinput: [],
+    audiooutput: []
+  });
+  const [activeDevices, setActiveDevices] = useState({});
   const [error, setError] = useState(null);
   const [sfuAvailable, setSfuAvailable] = useState(null);
   const optsRef = useRef(opts);
@@ -1085,6 +1091,21 @@ function useCallRoom(conversationId, opts) {
       ...optsRef.current.aloneGraceMs !== void 0 ? { aloneGraceMs: optsRef.current.aloneGraceMs } : {}
     });
   }, [poolse, conversationId]);
+  const refreshDevices = useCallback((target) => {
+    void Promise.all([
+      target.listDevices("videoinput"),
+      target.listDevices("audioinput"),
+      target.listDevices("audiooutput")
+    ]).then(([videoinput, audioinput, audiooutput]) => {
+      setDevices({ videoinput, audioinput, audiooutput });
+      const active = {};
+      for (const kind of ["videoinput", "audioinput", "audiooutput"]) {
+        const id = target.getActiveDevice(kind);
+        if (id) active[kind] = id;
+      }
+      setActiveDevices(active);
+    });
+  }, []);
   const sync = useCallback((target) => {
     if (!target) return;
     setCamera(target.isCameraEnabled());
@@ -1106,18 +1127,20 @@ function useCallRoom(conversationId, opts) {
       sync(room);
     });
     const offAlone = room.onAlone(() => setAlone(true));
+    const offDevices = room.onDevices(() => refreshDevices(room));
     const offError = room.onError(setError);
     return () => {
       offStatus();
       offRoster();
       offAlone();
+      offDevices();
       offError();
       if (joined.current) {
         joined.current = false;
         room.leave();
       }
     };
-  }, [room, sync]);
+  }, [room, sync, refreshDevices]);
   const join = useCallback(async () => {
     if (!room) return false;
     setError(null);
@@ -1126,13 +1149,14 @@ function useCallRoom(conversationId, opts) {
       joined.current = connected;
       setSfuAvailable(connected);
       sync(room);
+      if (connected) refreshDevices(room);
       return connected;
     } catch (err) {
       setError(err instanceof Error ? err : new Error(String(err)));
       setSfuAvailable(true);
       return false;
     }
-  }, [room, sync]);
+  }, [room, sync, refreshDevices]);
   const leave = useCallback(() => {
     if (!joined.current) return;
     joined.current = false;
@@ -1167,6 +1191,20 @@ function useCallRoom(conversationId, opts) {
     await room.switchCamera();
     setFacing(room.getFacingMode());
   }, [room]);
+  const refresh = useCallback(() => {
+    if (room) refreshDevices(room);
+  }, [room, refreshDevices]);
+  const selectDevice = useCallback(
+    async (kind, deviceId) => {
+      if (!room) return;
+      await room.setActiveDevice(kind, deviceId);
+      setActiveDevices((current) => ({
+        ...current,
+        [kind]: room.getActiveDevice(kind) ?? deviceId
+      }));
+    },
+    [room]
+  );
   return {
     status,
     participants,
@@ -1174,6 +1212,9 @@ function useCallRoom(conversationId, opts) {
     micEnabled,
     facingMode,
     alone,
+    devices,
+    activeDevices,
+    refreshDevices: refresh,
     error,
     sfuAvailable,
     join,
@@ -1181,6 +1222,7 @@ function useCallRoom(conversationId, opts) {
     setCameraEnabled,
     toggleCamera,
     switchCamera,
+    selectDevice,
     setMicrophoneEnabled,
     toggleMic
   };