@stream-io/video-client 1.24.0 → 1.25.0

package/dist/index.cjs.js

@@ -422,7 +422,7 @@ class ErrorFromResponse extends Error {
     }
 }
 
-// @generated by protobuf-ts 2.9.6 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
+// @generated by protobuf-ts 2.10.0 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
 // @generated from protobuf file "google/protobuf/struct.proto" (package "google.protobuf", syntax proto3)
 // tslint:disable
 //
@@ -655,7 +655,7 @@ class ListValue$Type extends runtime.MessageType {
                 no: 1,
                 name: 'values',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => Value,
             },
         ]);
@@ -687,7 +687,7 @@ class ListValue$Type extends runtime.MessageType {
  */
 const ListValue = new ListValue$Type();
 
-// @generated by protobuf-ts 2.9.6 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
+// @generated by protobuf-ts 2.10.0 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
 // @generated from protobuf file "google/protobuf/timestamp.proto" (package "google.protobuf", syntax proto3)
 // tslint:disable
 //
@@ -823,7 +823,7 @@ class Timestamp$Type extends runtime.MessageType {
  */
 const Timestamp = new Timestamp$Type();
 
-// @generated by protobuf-ts 2.9.6 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
+// @generated by protobuf-ts 2.10.0 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
 // @generated from protobuf file "video/sfu/models/models.proto" (package "stream.video.sfu.models", syntax proto3)
 // tslint:disable
 /**
@@ -965,6 +965,10 @@ var ErrorCode;
      * @generated from protobuf enum value: ERROR_CODE_PARTICIPANT_MEDIA_TRANSPORT_FAILURE = 205;
      */
     ErrorCode[ErrorCode["PARTICIPANT_MEDIA_TRANSPORT_FAILURE"] = 205] = "PARTICIPANT_MEDIA_TRANSPORT_FAILURE";
+    /**
+     * @generated from protobuf enum value: ERROR_CODE_PARTICIPANT_SIGNAL_LOST = 206;
+     */
+    ErrorCode[ErrorCode["PARTICIPANT_SIGNAL_LOST"] = 206] = "PARTICIPANT_SIGNAL_LOST";
     /**
      * @generated from protobuf enum value: ERROR_CODE_CALL_NOT_FOUND = 300;
      */
@@ -1245,7 +1249,7 @@ class CallState$Type extends runtime.MessageType {
                 no: 1,
                 name: 'participants',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => Participant,
             },
             { no: 2, name: 'started_at', kind: 'message', T: () => Timestamp },
@@ -1259,7 +1263,7 @@ class CallState$Type extends runtime.MessageType {
                 no: 4,
                 name: 'pins',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => Pin,
             },
         ]);
@@ -1437,7 +1441,7 @@ class SubscribeOption$Type extends runtime.MessageType {
                 no: 2,
                 name: 'codecs',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => Codec,
             },
         ]);
@@ -1570,7 +1574,7 @@ class TrackInfo$Type extends runtime.MessageType {
                 no: 5,
                 name: 'layers',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => VideoLayer,
             },
             { no: 6, name: 'mid', kind: 'scalar', T: 9 /*ScalarType.STRING*/ },
@@ -1937,7 +1941,7 @@ var models = /*#__PURE__*/Object.freeze({
     get WebsocketReconnectStrategy () { return WebsocketReconnectStrategy; }
 });
 
-// @generated by protobuf-ts 2.9.6 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
+// @generated by protobuf-ts 2.10.0 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
 // @generated from protobuf file "video/sfu/signal_rpc/signal.proto" (package "stream.video.sfu.signal", syntax proto3)
 // tslint:disable
 // @generated message type with reflection information, may provide speed optimized methods
@@ -2105,14 +2109,14 @@ class SendStatsRequest$Type extends runtime.MessageType {
                 no: 16,
                 name: 'encode_stats',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => PerformanceStats,
             },
             {
                 no: 17,
                 name: 'decode_stats',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => PerformanceStats,
             },
             {
@@ -2179,7 +2183,7 @@ class UpdateMuteStatesRequest$Type extends runtime.MessageType {
                 no: 3,
                 name: 'mute_states',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => TrackMuteState,
             },
         ]);
@@ -2256,7 +2260,7 @@ class UpdateSubscriptionsRequest$Type extends runtime.MessageType {
                 no: 3,
                 name: 'tracks',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => TrackSubscriptionDetails,
             },
         ]);
@@ -2355,7 +2359,7 @@ class SetPublisherRequest$Type extends runtime.MessageType {
                 no: 3,
                 name: 'tracks',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => TrackInfo,
             },
         ]);
@@ -2435,7 +2439,7 @@ const SignalServer = new runtimeRpc.ServiceType('stream.video.sfu.signal.SignalS
     },
 ]);
 
-// @generated by protobuf-ts 2.9.6 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
+// @generated by protobuf-ts 2.10.0 with parameter long_type_string,client_generic,server_none,eslint_disable,optimize_code_size
 // @generated from protobuf file "video/sfu/event/events.proto" (package "stream.video.sfu.event", syntax proto3)
 // tslint:disable
 // @generated message type with reflection information, may provide speed optimized methods
@@ -2611,7 +2615,7 @@ class ChangePublishOptions$Type extends runtime.MessageType {
                 no: 1,
                 name: 'publish_options',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => PublishOption,
             },
             { no: 2, name: 'reason', kind: 'scalar', T: 9 /*ScalarType.STRING*/ },
@@ -2650,7 +2654,7 @@ class PinsChanged$Type extends runtime.MessageType {
                 no: 1,
                 name: 'pins',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => Pin,
             },
         ]);
@@ -2893,14 +2897,14 @@ class JoinRequest$Type extends runtime.MessageType {
                 no: 9,
                 name: 'preferred_publish_options',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => PublishOption,
             },
             {
                 no: 10,
                 name: 'preferred_subscribe_options',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => SubscribeOption,
             },
         ]);
@@ -2928,14 +2932,14 @@ class ReconnectDetails$Type extends runtime.MessageType {
                 no: 3,
                 name: 'announced_tracks',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => TrackInfo,
             },
             {
                 no: 4,
                 name: 'subscriptions',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => TrackSubscriptionDetails,
             },
             {
@@ -2978,14 +2982,14 @@ class Migration$Type extends runtime.MessageType {
                 no: 2,
                 name: 'announced_tracks',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => TrackInfo,
             },
             {
                 no: 3,
                 name: 'subscriptions',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => TrackSubscriptionDetails,
             },
         ]);
@@ -3011,7 +3015,7 @@ class JoinResponse$Type extends runtime.MessageType {
                 no: 4,
                 name: 'publish_options',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => PublishOption,
             },
         ]);
@@ -3093,7 +3097,7 @@ class ConnectionQualityChanged$Type extends runtime.MessageType {
                 no: 1,
                 name: 'connection_quality_updates',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => ConnectionQualityInfo,
             },
         ]);
@@ -3162,7 +3166,7 @@ class AudioLevelChanged$Type extends runtime.MessageType {
                 no: 1,
                 name: 'audio_levels',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => AudioLevel,
             },
         ]);
@@ -3242,7 +3246,7 @@ class VideoSender$Type extends runtime.MessageType {
                 no: 3,
                 name: 'layers',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => VideoLayerSetting,
             },
             {
@@ -3276,14 +3280,14 @@ class ChangePublishQuality$Type extends runtime.MessageType {
                 no: 1,
                 name: 'audio_senders',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => AudioSender,
             },
             {
                 no: 2,
                 name: 'video_senders',
                 kind: 'message',
-                repeat: 1 /*RepeatType.PACKED*/,
+                repeat: 2 /*RepeatType.UNPACKED*/,
                 T: () => VideoSender,
             },
         ]);
@@ -5475,6 +5479,21 @@ class CallState {
     }
 }
 
+/**
+ * NegotiationError is thrown when there is an error during the negotiation process.
+ * It extends the built-in Error class and includes an SfuError object for more details.
+ */
+class NegotiationError extends Error {
+    /**
+     * Creates an instance of NegotiationError.
+     */
+    constructor(error) {
+        super(error.message);
+        this.name = 'NegotiationError';
+        this.error = error;
+    }
+}
+
 /**
  * Flatten the stats report into an array of stats objects.
  *
@@ -5793,7 +5812,7 @@ const aggregate = (stats) => {
     return report;
 };
 
-const version = "1.24.0";
+const version = "1.25.0";
 const [major, minor, patch] = version.split('.');
 let sdkInfo = {
     type: SdkType.PLAIN_JAVASCRIPT,
@@ -6402,12 +6421,38 @@ class BasePeerConnection {
     /**
      * Constructs a new `BasePeerConnection` instance.
      */
-    constructor(peerType, { sfuClient, connectionConfig, state, dispatcher, onUnrecoverableError, logTag, enableTracing, }) {
+    constructor(peerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, logTag, enableTracing, iceRestartDelay = 2500, }) {
         this.isIceRestarting = false;
         this.isDisposed = false;
         this.trackIdToTrackType = new Map();
         this.subscriptions = [];
         this.lock = Math.random().toString(36).slice(2);
+        this.createPeerConnection = (connectionConfig) => {
+            const pc = new RTCPeerConnection(connectionConfig);
+            pc.addEventListener('icecandidate', this.onIceCandidate);
+            pc.addEventListener('icecandidateerror', this.onIceCandidateError);
+            pc.addEventListener('iceconnectionstatechange', this.onIceConnectionStateChange);
+            pc.addEventListener('icegatheringstatechange', this.onIceGatherChange);
+            pc.addEventListener('signalingstatechange', this.onSignalingChange);
+            pc.addEventListener('connectionstatechange', this.onConnectionStateChange);
+            return pc;
+        };
+        /**
+         * Attempts to restart ICE on the `RTCPeerConnection`.
+         * This method intentionally doesn't await the `restartIce()` method,
+         * allowing it to run in the background and handle any errors that may occur.
+         */
+        this.tryRestartIce = () => {
+            this.restartIce().catch((e) => {
+                const reason = 'restartICE() failed, initiating reconnect';
+                this.logger('error', reason, e);
+                const strategy = e instanceof NegotiationError &&
+                    e.error.code === ErrorCode.PARTICIPANT_SIGNAL_LOST
+                    ? WebsocketReconnectStrategy.FAST
+                    : WebsocketReconnectStrategy.REJOIN;
+                this.onReconnectionNeeded?.(strategy, reason);
+            });
+        };
         /**
          * Handles events synchronously.
          * Consecutive events are queued and executed one after the other.
@@ -6460,6 +6505,18 @@ class BasePeerConnection {
         this.getTrackType = (trackId) => {
             return this.trackIdToTrackType.get(trackId);
         };
+        /**
+         * Checks if the `RTCPeerConnection` is healthy.
+         * It checks the ICE connection state and the peer connection state.
+         * If either state is `failed`, `disconnected`, or `closed`,
+         * it returns `false`, otherwise it returns `true`.
+         */
+        this.isHealthy = () => {
+            const failedStates = new Set(['failed', 'closed']);
+            const iceState = this.pc.iceConnectionState;
+            const connectionState = this.pc.connectionState;
+            return !failedStates.has(iceState) && !failedStates.has(connectionState);
+        };
         /**
          * Handles the ICECandidate event and
          * Initiates an ICE Trickle process with the SFU.
@@ -6498,9 +6555,7 @@ class BasePeerConnection {
         this.onConnectionStateChange = async () => {
             const state = this.pc.connectionState;
             this.logger('debug', `Connection state changed`, state);
-            if (!this.tracer)
-                return;
-            if (state === 'connected' || state === 'failed') {
+            if (this.tracer && (state === 'connected' || state === 'failed')) {
                 try {
                     const stats = await this.stats.get();
                     this.tracer.trace('getstats', stats.delta);
@@ -6509,6 +6564,12 @@ class BasePeerConnection {
                     this.tracer.trace('getstatsOnFailure', err.toString());
                 }
             }
+            // we can't recover from a failed connection state (contrary to ICE)
+            if (state === 'failed') {
+                this.onReconnectionNeeded?.(WebsocketReconnectStrategy.REJOIN, 'Connection failed');
+                return;
+            }
+            this.handleConnectionStateUpdate(state);
         };
         /**
          * Handles the ICE connection state change event.
@@ -6516,34 +6577,53 @@ class BasePeerConnection {
         this.onIceConnectionStateChange = () => {
             const state = this.pc.iceConnectionState;
             this.logger('debug', `ICE connection state changed`, state);
-            if (this.state.callingState === exports.CallingState.OFFLINE)
+            this.handleConnectionStateUpdate(state);
+        };
+        this.handleConnectionStateUpdate = (state) => {
+            const { callingState } = this.state;
+            if (callingState === exports.CallingState.OFFLINE)
                 return;
-            if (this.state.callingState === exports.CallingState.RECONNECTING)
+            if (callingState === exports.CallingState.RECONNECTING)
                 return;
             // do nothing when ICE is restarting
             if (this.isIceRestarting)
                 return;
-            if (state === 'failed') {
-                this.onUnrecoverableError?.('ICE connection failed');
-            }
-            else if (state === 'disconnected') {
-                this.logger('debug', `Attempting to restart ICE`);
-                this.restartIce().catch((e) => {
-                    const reason = `ICE restart failed`;
-                    this.logger('error', reason, e);
-                    this.onUnrecoverableError?.(`${reason}: ${e}`);
-                });
+            switch (state) {
+                case 'failed':
+                    // in the `failed` state, we try to restart ICE immediately
+                    this.logger('info', 'restartICE due to failed connection');
+                    this.tryRestartIce();
+                    break;
+                case 'disconnected':
+                    // in the `disconnected` state, we schedule a restartICE() after a delay
+                    // as the browser might recover the connection in the meantime
+                    this.logger('info', 'disconnected connection, scheduling restartICE');
+                    clearTimeout(this.iceRestartTimeout);
+                    this.iceRestartTimeout = setTimeout(() => {
+                        const currentState = this.pc.iceConnectionState;
+                        if (currentState === 'disconnected' || currentState === 'failed') {
+                            this.tryRestartIce();
+                        }
+                    }, this.iceRestartDelay);
+                    break;
+                case 'connected':
+                    // in the `connected` state, we clear the ice restart timeout if it exists
+                    if (this.iceRestartTimeout) {
+                        this.logger('info', 'connected connection, canceling restartICE');
+                        clearTimeout(this.iceRestartTimeout);
+                        this.iceRestartTimeout = undefined;
+                    }
+                    break;
             }
         };
         /**
          * Handles the ICE candidate error event.
          */
         this.onIceCandidateError = (e) => {
-            const errorMessage = e instanceof RTCPeerConnectionIceErrorEvent &&
-                `${e.errorCode}: ${e.errorText}`;
-            const iceState = this.pc.iceConnectionState;
-            const logLevel = iceState === 'connected' || iceState === 'checking' ? 'debug' : 'warn';
-            this.logger(logLevel, `ICE Candidate error`, errorMessage);
+            const errorMessage = e instanceof RTCPeerConnectionIceErrorEvent
+                ? `${e.errorCode}: ${e.errorText}`
+                : e;
+            this.logger('debug', 'ICE Candidate error', errorMessage);
         };
         /**
          * Handles the ICE gathering state change event.
@@ -6561,18 +6641,13 @@ class BasePeerConnection {
         this.sfuClient = sfuClient;
         this.state = state;
         this.dispatcher = dispatcher;
-        this.onUnrecoverableError = onUnrecoverableError;
+        this.iceRestartDelay = iceRestartDelay;
+        this.onReconnectionNeeded = onReconnectionNeeded;
         this.logger = getLogger([
             peerType === PeerType.SUBSCRIBER ? 'Subscriber' : 'Publisher',
             logTag,
         ]);
-        this.pc = new RTCPeerConnection(connectionConfig);
-        this.pc.addEventListener('icecandidate', this.onIceCandidate);
-        this.pc.addEventListener('icecandidateerror', this.onIceCandidateError);
-        this.pc.addEventListener('iceconnectionstatechange', this.onIceConnectionStateChange);
-        this.pc.addEventListener('icegatheringstatechange', this.onIceGatherChange);
-        this.pc.addEventListener('signalingstatechange', this.onSignalingChange);
-        this.pc.addEventListener('connectionstatechange', this.onConnectionStateChange);
+        this.pc = this.createPeerConnection(connectionConfig);
         this.stats = new StatsTracer(this.pc, peerType, this.trackIdToTrackType);
         if (enableTracing) {
             const tag = `${logTag}-${peerType === PeerType.SUBSCRIBER ? 'sub' : 'pub'}`;
@@ -6588,7 +6663,9 @@ class BasePeerConnection {
      * Disposes the `RTCPeerConnection` instance.
      */
     dispose() {
-        this.onUnrecoverableError = undefined;
+        clearTimeout(this.iceRestartTimeout);
+        this.iceRestartTimeout = undefined;
+        this.onReconnectionNeeded = undefined;
         this.isDisposed = true;
         this.detachEventHandlers();
         this.pc.close();
@@ -6598,11 +6675,12 @@ class BasePeerConnection {
      * Detaches the event handlers from the `RTCPeerConnection`.
      */
     detachEventHandlers() {
-        this.pc.removeEventListener('icecandidate', this.onIceCandidate);
-        this.pc.removeEventListener('icecandidateerror', this.onIceCandidateError);
-        this.pc.removeEventListener('signalingstatechange', this.onSignalingChange);
-        this.pc.removeEventListener('iceconnectionstatechange', this.onIceConnectionStateChange);
-        this.pc.removeEventListener('icegatheringstatechange', this.onIceGatherChange);
+        const pc = this.pc;
+        pc.removeEventListener('icecandidate', this.onIceCandidate);
+        pc.removeEventListener('icecandidateerror', this.onIceCandidateError);
+        pc.removeEventListener('signalingstatechange', this.onSignalingChange);
+        pc.removeEventListener('iceconnectionstatechange', this.onIceConnectionStateChange);
+        pc.removeEventListener('icegatheringstatechange', this.onIceGatherChange);
         this.unsubscribeIceTrickle?.();
         this.subscriptions.forEach((unsubscribe) => unsubscribe());
     }
@@ -6912,6 +6990,45 @@ const extractMid = (transceiver, transceiverInitIndex, sdp) => {
         return '';
     return String(transceiverInitIndex);
 };
+/**
+ * Enables stereo in the answer SDP based on the offered stereo in the offer SDP.
+ *
+ * @param offerSdp the offer SDP containing the stereo configuration.
+ * @param answerSdp the answer SDP to be modified.
+ */
+const enableStereo = (offerSdp, answerSdp) => {
+    const offeredStereoMids = new Set();
+    const parsedOfferSdp = sdpTransform.parse(offerSdp);
+    for (const media of parsedOfferSdp.media) {
+        if (media.type !== 'audio')
+            continue;
+        const opus = media.rtp.find((r) => r.codec === 'opus');
+        if (!opus)
+            continue;
+        for (const fmtp of media.fmtp) {
+            if (fmtp.payload === opus.payload && fmtp.config.includes('stereo=1')) {
+                offeredStereoMids.add(media.mid);
+            }
+        }
+    }
+    // No stereo offered, return the original answerSdp
+    if (offeredStereoMids.size === 0)
+        return answerSdp;
+    const parsedAnswerSdp = sdpTransform.parse(answerSdp);
+    for (const media of parsedAnswerSdp.media) {
+        if (media.type !== 'audio' || !offeredStereoMids.has(media.mid))
+            continue;
+        const opus = media.rtp.find((r) => r.codec === 'opus');
+        if (!opus)
+            continue;
+        for (const fmtp of media.fmtp) {
+            if (fmtp.payload === opus.payload && !fmtp.config.includes('stereo=1')) {
+                fmtp.config += ';stereo=1';
+            }
+        }
+    }
+    return sdpTransform.write(parsedAnswerSdp);
+};
 
 /**
  * The `Publisher` is responsible for publishing/unpublishing media streams to/from the SFU
@@ -7025,11 +7142,11 @@ class Publisher extends BasePeerConnection {
         /**
          * Returns true if the given track type is currently being published to the SFU.
          *
-         * @param trackType the track type to check.
+         * @param trackType the track type to check. If omitted, checks if any track is being published.
          */
         this.isPublishing = (trackType) => {
             for (const item of this.transceiverCache.items()) {
-                if (item.publishOption.trackType !== trackType)
+                if (trackType && item.publishOption.trackType !== trackType)
                     continue;
                 const track = item.transceiver.sender.track;
                 if (!track)
@@ -7152,10 +7269,17 @@ class Publisher extends BasePeerConnection {
                     const { sdp = '' } = offer;
                     const { response } = await this.sfuClient.setPublisher({ sdp, tracks });
                     if (response.error)
-                        throw new Error(response.error.message);
+                        throw new NegotiationError(response.error);
                     const { sdp: answerSdp } = response;
                     await this.pc.setRemoteDescription({ type: 'answer', sdp: answerSdp });
                 }
+                catch (err) {
+                    // negotiation failed, rollback to the previous state
+                    if (this.pc.signalingState === 'have-local-offer') {
+                        await this.pc.setLocalDescription({ type: 'rollback' });
+                    }
+                    throw err;
+                }
                 finally {
                     this.isIceRestarting = false;
                 }
@@ -7247,11 +7371,7 @@ class Publisher extends BasePeerConnection {
         this.on('iceRestart', (iceRestart) => {
             if (iceRestart.peerType !== PeerType.PUBLISHER_UNSPECIFIED)
                 return;
-            this.restartIce().catch((err) => {
-                const reason = `ICE restart failed`;
-                this.logger('warn', reason, err);
-                this.onUnrecoverableError?.(`${reason}: ${err}`);
-            });
+            this.tryRestartIce();
         });
         this.on('changePublishQuality', async (event) => {
             for (const videoSender of event.videoSenders) {
@@ -7299,11 +7419,13 @@ class Subscriber extends BasePeerConnection {
                 return;
             }
             const previousIsIceRestarting = this.isIceRestarting;
+            this.isIceRestarting = true;
             try {
-                this.isIceRestarting = true;
-                await this.sfuClient.iceRestart({
+                const { response } = await this.sfuClient.iceRestart({
                     peerType: PeerType.SUBSCRIBER,
                 });
+                if (response.error)
+                    throw new NegotiationError(response.error);
             }
             catch (e) {
                 // restore the previous state, as our intent for restarting ICE failed
@@ -7372,6 +7494,9 @@ class Subscriber extends BasePeerConnection {
             });
             this.addTrickledIceCandidates();
             const answer = await this.pc.createAnswer();
+            if (answer.sdp) {
+                answer.sdp = enableStereo(subscriberOffer.sdp, answer.sdp);
+            }
             await this.pc.setLocalDescription(answer);
             await this.sfuClient.sendAnswer({
                 peerType: PeerType.SUBSCRIBER,
@@ -7661,11 +7786,15 @@ class StreamSfuClient {
          */
         this.isLeaving = false;
         /**
-         * Flag to indicate if the client is in the process of closing the connection.
+         * Flag to indicate if the client is in the process of clean closing the connection.
+         * When set to `true`, the client will not attempt to reconnect
+         * and will close the WebSocket connection gracefully.
+         * Otherwise, it will close the connection with an error code and
+         * trigger a reconnection attempt.
          */
-        this.isClosing = false;
-        this.pingIntervalInMs = 10 * 1000;
-        this.unhealthyTimeoutInMs = this.pingIntervalInMs + 5 * 1000;
+        this.isClosingClean = false;
+        this.pingIntervalInMs = 5 * 1000;
+        this.unhealthyTimeoutInMs = 15 * 1000;
         /**
          * Promise that resolves when the JoinResponse is received.
          * Rejects after a certain threshold if the response is not received.
@@ -7709,7 +7838,7 @@ class StreamSfuClient {
                         // Normally, this shouldn't have any effect, because WS should never emit 'close'
                         // before emitting 'open'. However, strager things have happened, and we don't
                         // want to leave signalReady in pending state.
-                        reject(new Error('SFU WS closed unexpectedly'));
+                        reject(new Error(`SFU WS closed or connection can't be established`));
                     });
                 }),
                 new Promise((resolve, reject) => {
@@ -7727,7 +7856,7 @@ class StreamSfuClient {
             this.onSignalClose?.(`${e.code} ${e.reason}`);
         };
         this.close = (code = StreamSfuClient.NORMAL_CLOSURE, reason) => {
-            this.isClosing = true;
+            this.isClosingClean = code !== StreamSfuClient.ERROR_CONNECTION_UNHEALTHY;
             if (this.signalWs.readyState === WebSocket.OPEN) {
                 this.logger('debug', `Closing SFU WS connection: ${code} - ${reason}`);
                 this.signalWs.close(code, `js-client: ${reason}`);
@@ -7967,7 +8096,11 @@ StreamSfuClient.ERROR_CONNECTION_UNHEALTHY = 4001;
  * Here, we don't use 1000 (normal closure) because we don't want the
  * SFU to clean up the resources associated with the current participant.
  */
-StreamSfuClient.DISPOSE_OLD_SOCKET = 4002;
+StreamSfuClient.DISPOSE_OLD_SOCKET = 4100;
+/**
+ * The close code used when the client fails to join the call (on the SFU).
+ */
+StreamSfuClient.JOIN_FAILED = 4101;
 
 /**
  * Event handler that watched the delivery of `call.accepted`.
@@ -9481,21 +9614,30 @@ let getDisplayMediaExecId = 0;
 const getScreenShareStream = async (options, tracer) => {
     const tag = `navigator.mediaDevices.getDisplayMedia.${getDisplayMediaExecId++}.`;
     try {
-        tracer?.trace(tag, options);
-        const stream = await navigator.mediaDevices.getDisplayMedia({
-            video: true,
-            audio: {
-                channelCount: {
-                    ideal: 2,
-                },
-                echoCancellation: false,
-                autoGainControl: false,
-                noiseSuppression: false,
-            },
+        const constraints = {
             // @ts-expect-error - not present in types yet
             systemAudio: 'include',
             ...options,
-        });
+            video: typeof options?.video === 'boolean'
+                ? options.video // must be 'true'
+                : {
+                    width: { max: 2560 },
+                    height: { max: 1440 },
+                    frameRate: { ideal: 30 },
+                    ...options?.video,
+                },
+            audio: typeof options?.audio === 'boolean'
+                ? options.audio
+                : {
+                    channelCount: { ideal: 2 },
+                    echoCancellation: false,
+                    autoGainControl: false,
+                    noiseSuppression: false,
+                    ...options?.audio,
+                },
+        };
+        tracer?.trace(tag, constraints);
+        const stream = await navigator.mediaDevices.getDisplayMedia(constraints);
         tracer?.trace(`${tag}OnSuccess`, dumpStream(stream));
         return stream;
     }
@@ -10843,11 +10985,18 @@ class ScreenShareManager extends InputMediaDeviceManager {
     getDevices() {
         return rxjs.of([]); // there are no devices to be listed for Screen Share
     }
-    getStream(constraints) {
+    async getStream(constraints) {
         if (!this.state.audioEnabled) {
             constraints.audio = false;
         }
-        return getScreenShareStream(constraints, this.call.tracer);
+        const stream = await getScreenShareStream(constraints, this.call.tracer);
+        const [track] = stream.getVideoTracks();
+        const { contentHint } = this.state.settings || {};
+        if (typeof contentHint !== 'undefined' && track && 'contentHint' in track) {
+            this.call.tracer.trace('navigator.mediaDevices.getDisplayMedia.contentHint', contentHint);
+            track.contentHint = contentHint;
+        }
+        return stream;
     }
     async stopPublishStream() {
         return this.call.stopPublish(TrackType.SCREEN_SHARE, TrackType.SCREEN_SHARE_AUDIO);
@@ -11242,10 +11391,13 @@ class Call {
          * Leave the call and stop the media streams that were published by the call.
          */
         this.leave = async ({ reject, reason, message } = {}) => {
+            if (this.state.callingState === exports.CallingState.LEFT) {
+                throw new Error('Cannot leave call that has already been left.');
+            }
             await withoutConcurrency(this.joinLeaveConcurrencyTag, async () => {
                 const callingState = this.state.callingState;
                 if (callingState === exports.CallingState.LEFT) {
-                    throw new Error('Cannot leave call that has already been left.');
+                    return;
                 }
                 if (callingState === exports.CallingState.JOINING) {
                     const waitUntilCallJoined = () => {
@@ -11352,7 +11504,6 @@ class Call {
             this.state.setMembers(response.members);
             this.state.setOwnCapabilities(response.own_capabilities);
             if (params?.ring) {
-                // the call response can indicate where the call is still ringing or not
                 this.ringingSubject.next(true);
             }
             if (this.streamClient._hasConnectionID()) {
@@ -11374,7 +11525,6 @@ class Call {
             this.state.setMembers(response.members);
             this.state.setOwnCapabilities(response.own_capabilities);
             if (data?.ring) {
-                // the call response can indicate where the call is still ringing or not
                 this.ringingSubject.next(true);
             }
             if (this.streamClient._hasConnectionID()) {
@@ -11554,7 +11704,7 @@ class Call {
                 }
                 catch (error) {
                     this.logger('warn', 'Join SFU request failed', error);
-                    sfuClient.close(StreamSfuClient.ERROR_CONNECTION_UNHEALTHY, 'Join request failed, connection considered unhealthy');
+                    sfuClient.close(StreamSfuClient.JOIN_FAILED, 'Join request failed, connection considered unhealthy');
                     // restore the previous call state if the join-flow fails
                     this.state.setCallingState(callingState);
                     throw error;
@@ -11697,7 +11847,7 @@ class Call {
             }
             if (this.publisher) {
                 this.publisher.setSfuClient(nextSfuClient);
-                if (includePublisher) {
+                if (includePublisher && this.publisher.isPublishing()) {
                     await this.publisher.restartIce();
                 }
             }
@@ -11719,9 +11869,10 @@ class Call {
                 connectionConfig,
                 logTag: String(this.sfuClientTag),
                 enableTracing,
-                onUnrecoverableError: (reason) => {
-                    this.reconnect(WebsocketReconnectStrategy.REJOIN, reason).catch((err) => {
-                        this.logger('warn', `[Reconnect] Error reconnecting after a subscriber error: ${reason}`, err);
+                onReconnectionNeeded: (kind, reason) => {
+                    this.reconnect(kind, reason).catch((err) => {
+                        const message = `[Reconnect] Error reconnecting after a subscriber error: ${reason}`;
+                        this.logger('warn', message, err);
                     });
                 },
             });
@@ -11740,9 +11891,10 @@ class Call {
                     publishOptions,
                     logTag: String(this.sfuClientTag),
                     enableTracing,
-                    onUnrecoverableError: (reason) => {
-                        this.reconnect(WebsocketReconnectStrategy.REJOIN, reason).catch((err) => {
-                            this.logger('warn', `[Reconnect] Error reconnecting after a publisher error: ${reason}`, err);
+                    onReconnectionNeeded: (kind, reason) => {
+                        this.reconnect(kind, reason).catch((err) => {
+                            const message = `[Reconnect] Error reconnecting after a publisher error: ${reason}`;
+                            this.logger('warn', message, err);
                         });
                     },
                 });
@@ -11826,9 +11978,12 @@ class Call {
                 callingState === exports.CallingState.LEFT)
                 return;
             // normal close, no need to reconnect
-            if (sfuClient.isLeaving || sfuClient.isClosing)
+            if (sfuClient.isLeaving || sfuClient.isClosingClean)
                 return;
-            this.reconnect(WebsocketReconnectStrategy.REJOIN, reason).catch((err) => {
+            const strategy = this.publisher?.isHealthy() && this.subscriber?.isHealthy()
+                ? WebsocketReconnectStrategy.FAST
+                : WebsocketReconnectStrategy.REJOIN;
+            this.reconnect(strategy, reason).catch((err) => {
                 this.logger('warn', '[Reconnect] Error reconnecting', err);
             });
         };
@@ -11849,10 +12004,12 @@ class Call {
                 const reconnectStartTime = Date.now();
                 this.reconnectStrategy = strategy;
                 this.reconnectReason = reason;
+                let attempt = 0;
                 do {
-                    if (this.disconnectionTimeoutSeconds > 0 &&
-                        (Date.now() - reconnectStartTime) / 1000 >
-                            this.disconnectionTimeoutSeconds) {
+                    const reconnectingTime = Date.now() - reconnectStartTime;
+                    const shouldGiveUpReconnecting = this.disconnectionTimeoutSeconds > 0 &&
+                        reconnectingTime / 1000 > this.disconnectionTimeoutSeconds;
+                    if (shouldGiveUpReconnecting) {
                         this.logger('warn', '[Reconnect] Stopping reconnection attempts after reaching disconnection timeout');
                         this.state.setCallingState(exports.CallingState.RECONNECTING_FAILED);
                         return;
@@ -11861,7 +12018,7 @@ class Call {
                     if (this.reconnectStrategy !== WebsocketReconnectStrategy.FAST) {
                         this.reconnectAttempts++;
                     }
-                    const current = WebsocketReconnectStrategy[this.reconnectStrategy];
+                    const currentStrategy = WebsocketReconnectStrategy[this.reconnectStrategy];
                     try {
                         // wait until the network is available
                         await this.networkAvailableTask?.promise;
@@ -11869,7 +12026,7 @@ class Call {
                         switch (this.reconnectStrategy) {
                             case WebsocketReconnectStrategy.UNSPECIFIED:
                             case WebsocketReconnectStrategy.DISCONNECT:
-                                this.logger('debug', `[Reconnect] No-op strategy ${current}`);
+                                this.logger('debug', `[Reconnect] No-op strategy ${currentStrategy}`);
                                 break;
                             case WebsocketReconnectStrategy.FAST:
                                 await this.reconnectFast();
@@ -11888,7 +12045,7 @@ class Call {
                     }
                     catch (error) {
                         if (this.state.callingState === exports.CallingState.OFFLINE) {
-                            this.logger('trace', `[Reconnect] Can't reconnect while offline, stopping reconnection attempts`);
+                            this.logger('debug', `[Reconnect] Can't reconnect while offline, stopping reconnection attempts`);
                             break;
                             // we don't need to handle the error if the call is offline
                             // network change event will trigger the reconnection
@@ -11898,9 +12055,24 @@ class Call {
                             this.state.setCallingState(exports.CallingState.RECONNECTING_FAILED);
                             return;
                         }
-                        this.logger('warn', `[Reconnect] ${current} (${this.reconnectAttempts}) failed. Attempting with REJOIN`, error);
                         await sleep(500);
-                        this.reconnectStrategy = WebsocketReconnectStrategy.REJOIN;
+                        const wasMigrating = this.reconnectStrategy === WebsocketReconnectStrategy.MIGRATE;
+                        const mustPerformRejoin = (Date.now() - reconnectStartTime) / 1000 >
+                            this.fastReconnectDeadlineSeconds;
+                        // don't immediately switch to the REJOIN strategy, but instead attempt
+                        // to reconnect with the FAST strategy for a few times before switching.
+                        // in some cases, we immediately switch to the REJOIN strategy.
+                        const shouldRejoin = mustPerformRejoin || // if we are past the fast reconnect deadline
+                            wasMigrating || // if we were migrating, but the migration failed
+                            attempt >= 3 || // after 3 failed attempts
+                            !(this.publisher?.isHealthy() ?? true) || // if the publisher is not healthy
+                            !(this.subscriber?.isHealthy() ?? true); // if the subscriber is not healthy
+                        attempt++;
+                        const nextStrategy = shouldRejoin
+                            ? WebsocketReconnectStrategy.REJOIN
+                            : WebsocketReconnectStrategy.FAST;
+                        this.reconnectStrategy = nextStrategy;
+                        this.logger('info', `[Reconnect] ${currentStrategy} (${this.reconnectAttempts}) failed. Attempting with ${WebsocketReconnectStrategy[nextStrategy]}`, error);
                     }
                 } while (this.state.callingState !== exports.CallingState.JOINED &&
                     this.state.callingState !== exports.CallingState.RECONNECTING_FAILED &&
@@ -12913,6 +13085,38 @@ class Call {
     }
 }
 
+const APIErrorCodes = {
+    [-1]: 'InternalSystemError',
+    2: 'AccessKeyError',
+    3: 'AuthenticationFailedError',
+    4: 'InputError',
+    5: 'AuthenticationError',
+    6: 'DuplicateUsernameError',
+    9: 'RateLimitError',
+    16: 'DoesNotExistError',
+    17: 'NotAllowedError',
+    18: 'EventNotSupportedError',
+    19: 'ChannelFeatureNotSupportedError',
+    20: 'MessageTooLongError',
+    21: 'MultipleNestingLevelError',
+    22: 'PayloadTooBigError',
+    23: 'RequestTimeoutError',
+    24: 'MaxHeaderSizeExceededError',
+    40: 'AuthErrorTokenExpired',
+    41: 'AuthErrorTokenNotValidYet',
+    42: 'AuthErrorTokenUsedBeforeIssuedAt',
+    43: 'AuthErrorTokenSignatureInvalid',
+    44: 'CustomCommandEndpointMissingError',
+    45: 'CustomCommandEndpointCallError',
+    46: 'ConnectionIDNotFoundError',
+    60: 'CoolDownError',
+    69: 'ErrWrongRegion',
+    70: 'ErrQueryChannelPermissions',
+    71: 'ErrTooManyConnections',
+    73: 'MessageModerationFailedError',
+    99: 'AppSuspendedError',
+};
+
 /**
  * StableWSConnection - A WS connection that reconnects upon failure.
  * - the browser will sometimes report that you're online or offline
@@ -13139,7 +13343,7 @@ class StableWSConnection {
                 message = error.message;
                 statusCode = error.StatusCode;
             }
-            const msg = `WS failed with code: ${code} and reason: ${message}`;
+            const msg = `WS failed with code: ${code}: ${APIErrorCodes[code] || code} and reason: ${message}`;
             this._log(msg, { event }, 'warn');
             const error = new Error(msg);
             error.code = code;
@@ -14017,7 +14221,7 @@ class StreamClient {
         this.getUserAgent = () => {
             if (!this.cachedUserAgent) {
                 const { clientAppIdentifier = {} } = this.options;
-                const { sdkName = 'js', sdkVersion = "1.24.0", ...extras } = clientAppIdentifier;
+                const { sdkName = 'js', sdkVersion = "1.25.0", ...extras } = clientAppIdentifier;
                 this.cachedUserAgent = [
                     `stream-video-${sdkName}-v${sdkVersion}`,
                     ...Object.entries(extras).map(([key, value]) => `${key}=${value}`),
@@ -14367,13 +14571,17 @@ class StreamVideoClient {
          * @param type the type of the call.
          * @param id the id of the call.
          */
-        this.call = (type, id) => {
-            return new Call({
-                streamClient: this.streamClient,
-                id: id,
-                type: type,
-                clientStore: this.writeableStateStore,
-            });
+        this.call = (type, id, options = {}) => {
+            const call = options.reuseInstance
+                ? this.writeableStateStore.findCall(type, id)
+                : undefined;
+            return (call ??
+                new Call({
+                    streamClient: this.streamClient,
+                    id: id,
+                    type: type,
+                    clientStore: this.writeableStateStore,
+                }));
         };
         /**
          * Creates a new guest user with the given data.