video-saas-client 0.1.3 → 0.1.4

package/README.md

@@ -1,6 +1,6 @@
 # video-saas-client
 
-Video calling SDK for Video SaaS. Connect to video rooms with API key authentication.
+Video calling SDK for Video SaaS. Connect to video rooms with token-based authentication.
 
 ## Install
 
@@ -34,19 +34,46 @@ function MyVideoCall({ roomId, token }) {
 }
 ```
 
+### With a custom video track (e.g. virtual background)
+
+Pass a pre-processed `MediaStreamTrack` via `videoTrack`. The SDK will use it instead of calling `getUserMedia` for video.
+
+```jsx
+import { useVideoCall } from "video-saas-client";
+
+function MyVideoCall({ roomId, token }) {
+  const [videoTrack, setVideoTrack] = useState(null);
+
+  useEffect(() => {
+    // Apply your virtual background and get a processed track
+    applyVirtualBackground().then(track => setVideoTrack(track));
+  }, []);
+
+  const { localStream, remoteStreams, leaveRoom } = useVideoCall(roomId, { token, videoTrack });
+
+  // ...
+}
+```
+
 ## API
 
 ### `useVideoCall(roomId, options)`
 
-- **roomId** (string): Room ID to join
-- **options** (object):
-  - **token** (string, required): Short-lived room token from `video-saas-admin`
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `token` | string | Yes | Short-lived room token from `video-saas-admin` |
+| `videoTrack` | MediaStreamTrack | No | Custom video track — use this to pass a pre-processed track (e.g. with virtual background applied). Falls back to `getUserMedia` if not provided. |
 
 ### Returns
 
-- **localStream**: MediaStream | null
-- **remoteStreams**: Map<peerId, MediaStream>
-- **isConnected**: boolean
-- **error**: string | null
-- **leaveRoom**: () => void
-- **startRecording**, **stopRecording**, **isRecording**, **recordingIds**: Recording APIs (if supported by server)
+| Value | Type | Description |
+|-------|------|-------------|
+| `localStream` | MediaStream \| null | The local camera/mic stream |
+| `remoteStreams` | Map\<peerId, MediaStream\> | Streams from other participants |
+| `isConnected` | boolean | Whether the socket is connected |
+| `error` | string \| null | Error message if something went wrong |
+| `leaveRoom` | () => void | Disconnect and stop all tracks |
+| `startRecording` | (patientPeerId) => Promise | Start recording (if supported by server) |
+| `stopRecording` | () => Promise | Stop recording |
+| `isRecording` | boolean | Whether recording is active |
+| `recordingIds` | \{ doctor, patient \} | Active recording IDs |

package/dist/index.js

@@ -14956,7 +14956,7 @@ Object.assign(lookup2, {
 var import_mediasoup_client = __toESM(require_lib5());
 var SERVER_URL = "https://video-saas.breakbyte.com/";
 function useVideoCall(roomId, options = {}) {
-  const { token } = options;
+  const { token, videoTrack } = options;
   const [localStream, setLocalStream] = (0, import_react.useState)(null);
   const [remoteStreams, setRemoteStreams] = (0, import_react.useState)(/* @__PURE__ */ new Map());
   const [isConnected, setIsConnected] = (0, import_react.useState)(false);
@@ -15034,7 +15034,9 @@ function useVideoCall(roomId, options = {}) {
       return { sendTransport, recvTransport };
     }
     async function getLocalMedia(sendTransport) {
-      const stream = await navigator.mediaDevices.getUserMedia({ video: true, audio: true });
+      const audioStream = await navigator.mediaDevices.getUserMedia({ audio: true });
+      const resolvedVideoTrack = videoTrack ?? (await navigator.mediaDevices.getUserMedia({ video: true })).getVideoTracks()[0];
+      const stream = new MediaStream([resolvedVideoTrack, ...audioStream.getAudioTracks()]);
       localStreamRef.current = stream;
       if (cancelled) {
         stream.getTracks().forEach((t) => t.stop());
@@ -15116,7 +15118,7 @@ function useVideoCall(roomId, options = {}) {
       cancelled = true;
       cleanup();
     };
-  }, [roomId, token]);
+  }, [roomId, token, videoTrack]);
   function cleanup() {
     localStreamRef.current?.getTracks().forEach((t) => t.stop());
     sendTransportRef.current?.close();

package/dist/index.mjs

@@ -14948,7 +14948,7 @@ Object.assign(lookup2, {
 var import_mediasoup_client = __toESM(require_lib5());
 var SERVER_URL = "https://video-saas.breakbyte.com/";
 function useVideoCall(roomId, options = {}) {
-  const { token } = options;
+  const { token, videoTrack } = options;
   const [localStream, setLocalStream] = useState(null);
   const [remoteStreams, setRemoteStreams] = useState(/* @__PURE__ */ new Map());
   const [isConnected, setIsConnected] = useState(false);
@@ -15026,7 +15026,9 @@ function useVideoCall(roomId, options = {}) {
       return { sendTransport, recvTransport };
     }
     async function getLocalMedia(sendTransport) {
-      const stream = await navigator.mediaDevices.getUserMedia({ video: true, audio: true });
+      const audioStream = await navigator.mediaDevices.getUserMedia({ audio: true });
+      const resolvedVideoTrack = videoTrack ?? (await navigator.mediaDevices.getUserMedia({ video: true })).getVideoTracks()[0];
+      const stream = new MediaStream([resolvedVideoTrack, ...audioStream.getAudioTracks()]);
       localStreamRef.current = stream;
       if (cancelled) {
         stream.getTracks().forEach((t) => t.stop());
@@ -15108,7 +15110,7 @@ function useVideoCall(roomId, options = {}) {
       cancelled = true;
       cleanup();
     };
-  }, [roomId, token]);
+  }, [roomId, token, videoTrack]);
   function cleanup() {
     localStreamRef.current?.getTracks().forEach((t) => t.stop());
     sendTransportRef.current?.close();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "video-saas-client",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Video calling SDK for Video SaaS",
   "main": "dist/index.js",
   "module": "dist/index.mjs",