@stream-io/video-client 1.41.0 → 1.41.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
 
+## [1.41.2](https://github.com/GetStream/stream-video-js/compare/@stream-io/video-client-1.41.1...@stream-io/video-client-1.41.2) (2026-01-28)
+
+- deduplicate RN compatibility assertions ([#2101](https://github.com/GetStream/stream-video-js/issues/2101)) ([5b9e6bc](https://github.com/GetStream/stream-video-js/commit/5b9e6bc227c55b067eea6345315bca015c8a7ee4))
+
+## [1.41.1](https://github.com/GetStream/stream-video-js/compare/@stream-io/video-client-1.41.0...@stream-io/video-client-1.41.1) (2026-01-26)
+
+### Bug Fixes
+
+- **safari:** Handle interrupted AudioContext and AudioSession states ([#2098](https://github.com/GetStream/stream-video-js/issues/2098)) ([975901f](https://github.com/GetStream/stream-video-js/commit/975901f399b46479928ec1e9f32da7e47bba9ad3))
+- use multiple settings to determine default audio device RN-338 ([#2096](https://github.com/GetStream/stream-video-js/issues/2096)) ([19cf136](https://github.com/GetStream/stream-video-js/commit/19cf13651112b647903587a84a70a555fc68fc9c)), closes [2BSettingsPriority.swift#L19](https://github.com/GetStream/2BSettingsPriority.swift/issues/L19)
+
 ## [1.41.0](https://github.com/GetStream/stream-video-js/compare/@stream-io/video-client-1.40.3...@stream-io/video-client-1.41.0) (2026-01-20)
 
 ### Features

package/dist/index.browser.es.js

@@ -6188,7 +6188,7 @@ const getSdkVersion = (sdk) => {
     return sdk ? `${sdk.major}.${sdk.minor}.${sdk.patch}` : '0.0.0-development';
 };
 
-const version = "1.41.0";
+const version = "1.41.2";
 const [major, minor, patch] = version.split('.');
 let sdkInfo = {
     type: SdkType.PLAIN_JAVASCRIPT,
@@ -9372,12 +9372,13 @@ class DynascaleManager {
     /**
      * Creates a new DynascaleManager instance.
      */
-    constructor(callState, speaker) {
+    constructor(callState, speaker, tracer) {
         /**
          * The viewport tracker instance.
          */
         this.viewportTracker = new ViewportTracker();
         this.logger = videoLoggerSystem.getLogger('DynascaleManager');
+        this.useWebAudio = isSafari();
         this.pendingSubscriptionsUpdate = null;
         this.videoTrackSubscriptionOverridesSubject = new BehaviorSubject({});
         this.videoTrackSubscriptionOverrides$ = this.videoTrackSubscriptionOverridesSubject.asObservable();
@@ -9417,6 +9418,10 @@ class DynascaleManager {
             }
         };
         this.setVideoTrackSubscriptionOverrides = (override, sessionIds) => {
+            this.tracer.trace('setVideoTrackSubscriptionOverrides', [
+                override,
+                sessionIds,
+            ]);
             if (!sessionIds) {
                 return setCurrentValue(this.videoTrackSubscriptionOverridesSubject, override ? { [globalOverrideKey]: override } : {});
             }
@@ -9498,6 +9503,18 @@ class DynascaleManager {
         this.setViewport = (element) => {
             return this.viewportTracker.setViewport(element);
         };
+        /**
+         * Sets whether to use WebAudio API for audio playback.
+         * Must be set before joining the call.
+         *
+         * @internal
+         *
+         * @param useWebAudio whether to use WebAudio API.
+         */
+        this.setUseWebAudio = (useWebAudio) => {
+            this.tracer.trace('setUseWebAudio', useWebAudio);
+            this.useWebAudio = useWebAudio;
+        };
         /**
          * Binds a DOM <video> element to the given session id.
          * This method will make sure that the video element will play
@@ -9713,6 +9730,7 @@ class DynascaleManager {
                         // we will play audio directly through the audio element in other browsers
                         audioElement.muted = false;
                         audioElement.play().catch((e) => {
+                            this.tracer.trace('audioPlaybackError', e.message);
                             this.logger.warn(`Failed to play audio stream`, e);
                         });
                     }
@@ -9747,32 +9765,57 @@ class DynascaleManager {
             };
         };
         this.getOrCreateAudioContext = () => {
-            if (this.audioContext || !isSafari())
+            if (!this.useWebAudio)
+                return;
+            if (this.audioContext)
                 return this.audioContext;
             const context = new AudioContext();
+            this.tracer.trace('audioContext.create', context.state);
             if (context.state === 'suspended') {
                 document.addEventListener('click', this.resumeAudioContext);
             }
-            // @ts-expect-error audioSession is available in Safari only
+            context.addEventListener('statechange', () => {
+                this.tracer.trace('audioContext.state', context.state);
+                if (context.state === 'interrupted') {
+                    this.resumeAudioContext();
+                }
+            });
             const audioSession = navigator.audioSession;
             if (audioSession) {
                 // https://github.com/w3c/audio-session/blob/main/explainer.md
                 audioSession.type = 'play-and-record';
+                let isSessionInterrupted = false;
+                audioSession.addEventListener('statechange', () => {
+                    this.tracer.trace('audioSession.state', audioSession.state);
+                    if (audioSession.state === 'interrupted') {
+                        isSessionInterrupted = true;
+                    }
+                    else if (isSessionInterrupted) {
+                        this.resumeAudioContext();
+                        isSessionInterrupted = false;
+                    }
+                });
             }
             return (this.audioContext = context);
         };
         this.resumeAudioContext = () => {
-            if (this.audioContext?.state === 'suspended') {
-                this.audioContext
-                    .resume()
-                    .catch((err) => this.logger.warn(`Can't resume audio context`, err))
-                    .then(() => {
+            if (!this.audioContext)
+                return;
+            const { state } = this.audioContext;
+            if (state === 'suspended' || state === 'interrupted') {
+                const tag = 'audioContext.resume';
+                this.audioContext.resume().then(() => {
+                    this.tracer.trace(tag, this.audioContext?.state);
                     document.removeEventListener('click', this.resumeAudioContext);
+                }, (err) => {
+                    this.tracer.trace(`${tag}Error`, this.audioContext?.state);
+                    this.logger.warn(`Can't resume audio context`, err);
                 });
             }
         };
         this.callState = callState;
         this.speaker = speaker;
+        this.tracer = tracer;
     }
     setSfuClient(sfuClient) {
         this.sfuClient = sfuClient;
@@ -11992,6 +12035,37 @@ class SpeakerManager {
         this.state = new SpeakerState(call.tracer);
         this.setup();
     }
+    apply(settings) {
+        if (!isReactNative()) {
+            return;
+        }
+        /// Determines if the speaker should be enabled based on a priority hierarchy of
+        /// settings.
+        ///
+        /// The priority order is as follows:
+        /// 1. If video camera is set to be on by default, speaker is enabled
+        /// 2. If audio speaker is set to be on by default, speaker is enabled
+        /// 3. If the default audio device is set to speaker, speaker is enabled
+        ///
+        /// This ensures that the speaker state aligns with the most important user
+        /// preference or system requirement.
+        const speakerOnWithSettingsPriority = settings.video.camera_default_on ||
+            settings.audio.speaker_default_on ||
+            settings.audio.default_device ===
+                AudioSettingsRequestDefaultDeviceEnum.SPEAKER;
+        const defaultDevice = speakerOnWithSettingsPriority
+            ? AudioSettingsRequestDefaultDeviceEnum.SPEAKER
+            : AudioSettingsRequestDefaultDeviceEnum.EARPIECE;
+        if (this.defaultDevice !== defaultDevice) {
+            this.call.logger.debug('SpeakerManager: setting default device', {
+                defaultDevice,
+            });
+            this.defaultDevice = defaultDevice;
+            globalThis.streamRNVideoSDK?.callManager.setup({
+                defaultDevice,
+            });
+        }
+    }
     setup() {
         if (this.areSubscriptionsSetUp) {
             return;
@@ -12018,9 +12092,7 @@ class SpeakerManager {
      * @returns an Observable that will be updated if a device is connected or disconnected
      */
     listDevices() {
-        if (isReactNative()) {
-            throw new Error('This feature is not supported in React Native. Please visit https://getstream.io/video/docs/reactnative/core/camera-and-microphone/#speaker-management for more details');
-        }
+        assertUnsupportedInReactNative();
         return getAudioOutputDevices(this.call.tracer);
     }
     /**
@@ -12031,9 +12103,7 @@ class SpeakerManager {
      * @param deviceId empty string means the system default
      */
     select(deviceId) {
-        if (isReactNative()) {
-            throw new Error('This feature is not supported in React Native. Please visit https://getstream.io/video/docs/reactnative/core/camera-and-microphone/#speaker-management for more details');
-        }
+        assertUnsupportedInReactNative();
         this.state.setDevice(deviceId);
     }
     /**
@@ -12043,9 +12113,7 @@ class SpeakerManager {
      * Note: This method is not supported in React Native
      */
     setVolume(volume) {
-        if (isReactNative()) {
-            throw new Error('This feature is not supported in React Native. Please visit https://getstream.io/video/docs/reactnative/core/camera-and-microphone/#speaker-management for more details');
-        }
+        assertUnsupportedInReactNative();
         if (volume && (volume < 0 || volume > 1)) {
             throw new Error('Volume must be between 0 and 1');
         }
@@ -12072,6 +12140,11 @@ class SpeakerManager {
         });
     }
 }
+const assertUnsupportedInReactNative = () => {
+    if (isReactNative()) {
+        throw new Error('Unsupported in React Native. See: https://getstream.io/video/docs/react-native/guides/camera-and-microphone/#speaker-management');
+    }
+};
 
 /**
  * An object representation of a `Call`.
@@ -13933,9 +14006,7 @@ class Call {
          * @internal
          */
         this.applyDeviceConfig = async (settings, publish) => {
-            globalThis.streamRNVideoSDK?.callManager.setup({
-                default_device: settings.audio.default_device,
-            });
+            this.speaker.apply(settings);
             await this.camera.apply(settings.video, publish).catch((err) => {
                 this.logger.warn('Camera init failed', err);
             });
@@ -14105,7 +14176,7 @@ class Call {
         this.microphone = new MicrophoneManager(this);
         this.speaker = new SpeakerManager(this);
         this.screenShare = new ScreenShareManager(this);
-        this.dynascaleManager = new DynascaleManager(this.state, this.speaker);
+        this.dynascaleManager = new DynascaleManager(this.state, this.speaker, this.tracer);
     }
     /**
      * A flag indicating whether the call is "ringing" type of call.
@@ -15249,7 +15320,7 @@ class StreamClient {
         this.getUserAgent = () => {
             if (!this.cachedUserAgent) {
                 const { clientAppIdentifier = {} } = this.options;
-                const { sdkName = 'js', sdkVersion = "1.41.0", ...extras } = clientAppIdentifier;
+                const { sdkName = 'js', sdkVersion = "1.41.2", ...extras } = clientAppIdentifier;
                 this.cachedUserAgent = [
                     `stream-video-${sdkName}-v${sdkVersion}`,
                     ...Object.entries(extras).map(([key, value]) => `${key}=${value}`),