@poolse/react 2.13.0 → 2.14.0

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to `@poolse/react` are documented here. Format follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versions follow
 [semver](https://semver.org).
 
+## [2.14.0] — 2026-08-23
+
+### Added
+
+- **`useCallRoom().devices` / `.activeDevices` / `.selectDevice`** —
+  camera, microphone and audio-output selection, refreshed as devices
+  come and go. Enumeration is deferred until the call connects, because
+  a browser withholds device labels from a page that does not yet hold
+  the matching permission.
+
+## [2.13.1] — 2026-08-23
+
+Republished in lockstep with `@poolse/react-native@2.13.1`. No changes
+to this package.
+
 ## [2.13.0] — 2026-08-23
 
 ### Fixed

package/dist/index.cjs

@@ -1071,6 +1071,12 @@ function useCallRoom(conversationId, opts) {
   const [micEnabled, setMic] = react.useState(false);
   const [facingMode, setFacing] = react.useState(opts.facing ?? "user");
   const [alone, setAlone] = react.useState(false);
+  const [devices, setDevices] = react.useState({
+    videoinput: [],
+    audioinput: [],
+    audiooutput: []
+  });
+  const [activeDevices, setActiveDevices] = react.useState({});
   const [error, setError] = react.useState(null);
   const [sfuAvailable, setSfuAvailable] = react.useState(null);
   const optsRef = react.useRef(opts);
@@ -1086,6 +1092,21 @@ function useCallRoom(conversationId, opts) {
       ...optsRef.current.aloneGraceMs !== void 0 ? { aloneGraceMs: optsRef.current.aloneGraceMs } : {}
     });
   }, [poolse, conversationId]);
+  const refreshDevices = react.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 = react.useCallback((target) => {
     if (!target) return;
     setCamera(target.isCameraEnabled());
@@ -1107,18 +1128,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 = react.useCallback(async () => {
     if (!room) return false;
     setError(null);
@@ -1127,13 +1150,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 = react.useCallback(() => {
     if (!joined.current) return;
     joined.current = false;
@@ -1168,6 +1192,17 @@ function useCallRoom(conversationId, opts) {
     await room.switchCamera();
     setFacing(room.getFacingMode());
   }, [room]);
+  const selectDevice = react.useCallback(
+    async (kind, deviceId) => {
+      if (!room) return;
+      await room.setActiveDevice(kind, deviceId);
+      setActiveDevices((current) => ({
+        ...current,
+        [kind]: room.getActiveDevice(kind) ?? deviceId
+      }));
+    },
+    [room]
+  );
   return {
     status,
     participants,
@@ -1175,6 +1210,8 @@ function useCallRoom(conversationId, opts) {
     micEnabled,
     facingMode,
     alone,
+    devices,
+    activeDevices,
     error,
     sfuAvailable,
     join,
@@ -1182,6 +1219,7 @@ function useCallRoom(conversationId, opts) {
     setCameraEnabled,
     toggleCamera,
     switchCamera,
+    selectDevice,
     setMicrophoneEnabled,
     toggleMic
   };