@stream-io/video-client 1.40.0 → 1.40.1

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [1.40.1](https://github.com/GetStream/stream-video-js/compare/@stream-io/video-client-1.40.0...@stream-io/video-client-1.40.1) (2026-01-14)
+
+### Bug Fixes
+
+- ensure proper set up of server-side preferences for mic and camera ([#2080](https://github.com/GetStream/stream-video-js/issues/2080)) ([3529c8f](https://github.com/GetStream/stream-video-js/commit/3529c8fc0233d3f9f8f21c80cffc4ec27334954f))
+
 ## [1.40.0](https://github.com/GetStream/stream-video-js/compare/@stream-io/video-client-1.39.3...@stream-io/video-client-1.40.0) (2026-01-09)
 
 ### Features

package/dist/index.browser.es.js

@@ -6060,7 +6060,7 @@ const getSdkVersion = (sdk) => {
     return sdk ? `${sdk.major}.${sdk.minor}.${sdk.patch}` : '0.0.0-development';
 };
 
-const version = "1.40.0";
+const version = "1.40.1";
 const [major, minor, patch] = version.split('.');
 let sdkInfo = {
     type: SdkType.PLAIN_JAVASCRIPT,
@@ -10298,6 +10298,19 @@ class DeviceManager {
          * if true, stops the media stream when call is left
          */
         this.stopOnLeave = true;
+        /**
+         * When `true`, the `apply()` method will skip automatically enabling/disabling
+         * the device based on server defaults (`mic_default_on`, `camera_default_on`).
+         *
+         * This is useful when application code wants to handle device preferences
+         * (e.g., persisted user preferences) and prevent server defaults from
+         * overriding them.
+         *
+         * @default false
+         *
+         * @internal
+         */
+        this.deferServerDefaults = false;
         this.subscriptions = [];
         this.areSubscriptionsSetUp = false;
         this.isTrackStoppedDueToTrackEnd = false;
@@ -10976,8 +10989,15 @@ class CameraManager extends DeviceManager {
      * @internal
      */
     async selectTargetResolution(resolution) {
-        this.targetResolution.height = resolution.height;
-        this.targetResolution.width = resolution.width;
+        // normalize target resolution to landscape format.
+        // on mobile devices, the device itself adjusts the resolution to portrait or landscape
+        // depending on the orientation of the device. using portrait resolution
+        // will result in falling back to the default resolution (640x480).
+        let { width, height } = resolution;
+        if (width < height)
+            [width, height] = [height, width];
+        this.targetResolution.height = height;
+        this.targetResolution.width = width;
         if (this.state.optimisticStatus === 'enabled') {
             try {
                 await this.statusChangeSettled();
@@ -10991,9 +11011,8 @@ class CameraManager extends DeviceManager {
             const [videoTrack] = this.state.mediaStream.getVideoTracks();
             if (!videoTrack)
                 return;
-            const { width, height } = videoTrack.getSettings();
-            if (width !== this.targetResolution.width ||
-                height !== this.targetResolution.height) {
+            const { width: w, height: h } = videoTrack.getSettings();
+            if (w !== width || h !== height) {
                 await this.applySettingsToStream();
                 this.logger.debug(`${width}x${height} target resolution applied to media stream`);
             }
@@ -11006,38 +11025,25 @@ class CameraManager extends DeviceManager {
      * @param publish whether to publish the stream after applying the settings.
      */
     async apply(settings, publish) {
-        const hasPublishedVideo = !!this.call.state.localParticipant?.videoStream;
-        const hasPermission = this.call.permissionsContext.hasPermission(OwnCapability.SEND_AUDIO);
-        if (hasPublishedVideo || !hasPermission)
-            return;
         // Wait for any in progress camera operation
         await this.statusChangeSettled();
-        const { target_resolution, camera_facing, camera_default_on, enabled } = settings;
-        // normalize target resolution to landscape format.
-        // on mobile devices, the device itself adjusts the resolution to portrait or landscape
-        // depending on the orientation of the device. using portrait resolution
-        // will result in falling back to the default resolution (640x480).
-        let { width, height } = target_resolution;
-        if (width < height)
-            [width, height] = [height, width];
-        await this.selectTargetResolution({ width, height });
-        // Set camera direction if it's not yet set
-        if (!this.state.direction && !this.state.selectedDevice) {
-            this.state.setDirection(camera_facing === 'front' ? 'front' : 'back');
+        await this.selectTargetResolution(settings.target_resolution);
+        // apply a direction and enable the camera only if in "pristine" state
+        // and server defaults are not deferred to application code
+        const canPublish = this.call.permissionsContext.canPublish(this.trackType);
+        if (this.state.status === undefined && !this.deferServerDefaults) {
+            if (!this.state.direction && !this.state.selectedDevice) {
+                const direction = settings.camera_facing === 'front' ? 'front' : 'back';
+                await this.selectDirection(direction);
+            }
+            if (canPublish && settings.camera_default_on && settings.enabled) {
+                await this.enable();
+            }
         }
-        if (!publish)
-            return;
         const { mediaStream } = this.state;
-        if (this.enabled && mediaStream) {
-            // The camera is already enabled (e.g. lobby screen). Publish the stream
+        if (canPublish && publish && this.enabled && mediaStream) {
             await this.publishStream(mediaStream);
         }
-        else if (this.state.status === undefined &&
-            camera_default_on &&
-            enabled) {
-            // Start camera if backend config specifies, and there is no local setting
-            await this.enable();
-        }
     }
     getDevices() {
         return getVideoDevices(this.call.tracer);
@@ -11545,24 +11551,20 @@ class MicrophoneManager extends AudioDeviceManager {
      * @param publish whether to publish the stream after applying the settings.
      */
     async apply(settings, publish) {
-        if (!publish)
-            return;
-        const hasPublishedAudio = !!this.call.state.localParticipant?.audioStream;
-        const hasPermission = this.call.permissionsContext.hasPermission(OwnCapability.SEND_AUDIO);
-        if (hasPublishedAudio || !hasPermission)
-            return;
         // Wait for any in progress mic operation
         await this.statusChangeSettled();
-        // Publish media stream that was set before we joined
+        const canPublish = this.call.permissionsContext.canPublish(this.trackType);
+        // apply server-side settings only when the device state is pristine
+        // and server defaults are not deferred to application code
+        if (this.state.status === undefined && !this.deferServerDefaults) {
+            if (canPublish && settings.mic_default_on) {
+                await this.enable();
+            }
+        }
         const { mediaStream } = this.state;
-        if (this.enabled && mediaStream) {
-            // The mic is already enabled (e.g. lobby screen). Publish the stream
+        if (canPublish && publish && this.enabled && mediaStream) {
             await this.publishStream(mediaStream);
         }
-        else if (this.state.status === undefined && settings.mic_default_on) {
-            // Start mic if backend config specifies, and there is no local setting
-            await this.enable();
-        }
     }
     getDevices() {
         return getAudioDevices(this.call.tracer);
@@ -15090,7 +15092,7 @@ class StreamClient {
         this.getUserAgent = () => {
             if (!this.cachedUserAgent) {
                 const { clientAppIdentifier = {} } = this.options;
-                const { sdkName = 'js', sdkVersion = "1.40.0", ...extras } = clientAppIdentifier;
+                const { sdkName = 'js', sdkVersion = "1.40.1", ...extras } = clientAppIdentifier;
                 this.cachedUserAgent = [
                     `stream-video-${sdkName}-v${sdkVersion}`,
                     ...Object.entries(extras).map(([key, value]) => `${key}=${value}`),