@stream-io/video-client 1.47.0 → 1.49.0

package/dist/index.es.js

@@ -4007,8 +4007,6 @@ const retryable = async (rpc, signal, maxRetries = Number.POSITIVE_INFINITY) =>
     do {
         if (attempt > 0)
             await sleep(retryInterval(attempt));
-        if (signal?.aborted)
-            throw new Error(signal.reason);
         try {
             result = await rpc({ attempt });
         }
@@ -4406,6 +4404,21 @@ class Dispatcher {
     }
 }
 
+/**
+ * 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;
+    }
+}
+
 /**
  * A buffer for ICE Candidates. Used for ICE Trickle:
  * - https://bloggeek.me/webrtcglossary/trickle-ice/
@@ -6223,21 +6236,6 @@ 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.
  *
@@ -6285,7 +6283,7 @@ const getSdkVersion = (sdk) => {
     return sdk ? `${sdk.major}.${sdk.minor}.${sdk.patch}` : '0.0.0-development';
 };
 
-const version = "1.47.0";
+const version = "1.49.0";
 const [major, minor, patch] = version.split('.');
 let sdkInfo = {
     type: SdkType.PLAIN_JAVASCRIPT,
@@ -7307,6 +7305,30 @@ class Tracer {
     }
 }
 
+/**
+ * Canonical reasons the SDK uses to trigger a reconnection. Free-form strings
+ * are still accepted at the callback boundary (e.g. when forwarding an SFU
+ * error message), but only the members below influence reconnect-loop
+ * behavior. In particular, `Call.reconnect` programmatically inspects
+ * `ICE_NEVER_CONNECTED` to drive the unsupported-network detector — pass a
+ * canonical member when you want the SDK to react to the reason; pass a
+ * free-form string when the value is purely diagnostic.
+ */
+const ReconnectReason = {
+    /** ICE never reached `connected`/`completed`, escalate to REJOIN. */
+    ICE_NEVER_CONNECTED: 'ice_never_connected',
+    /** RTCPeerConnection.connectionState became `failed`. */
+    CONNECTION_FAILED: 'connection_failed',
+    /** `restartIce()` rejected. */
+    RESTART_ICE_FAILED: 'restart_ice_failed',
+    /** SFU `goAway` event, migrate to a new SFU. */
+    GO_AWAY: 'go_away',
+    /** Network came back online after going offline. */
+    NETWORK_BACK_ONLINE: 'network_back_online',
+    /** SFU error event with no descriptive message. */
+    SFU_ERROR: 'sfu_error',
+};
+
 /**
  * A base class for the `Publisher` and `Subscriber` classes.
  * @internal
@@ -7315,7 +7337,8 @@ class BasePeerConnection {
     /**
      * Constructs a new `BasePeerConnection` instance.
      */
-    constructor(peerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, tag, enableTracing, clientPublishOptions, iceRestartDelay = 2500, }) {
+    constructor(peerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, onIceConnected, tag, enableTracing, clientPublishOptions, iceRestartDelay = 2500, }) {
+        this.iceHasEverConnected = false;
         this.isIceRestarting = false;
         this.isDisposed = false;
         this.trackIdToTrackType = new Map();
@@ -7338,13 +7361,12 @@ class BasePeerConnection {
          */
         this.tryRestartIce = () => {
             this.restartIce().catch((e) => {
-                const reason = 'restartICE() failed, initiating reconnect';
-                this.logger.error(reason, e);
+                this.logger.error('restartICE() failed, initiating reconnect', e);
                 const strategy = e instanceof NegotiationError &&
                     e.error.code === ErrorCode.PARTICIPANT_SIGNAL_LOST
                     ? WebsocketReconnectStrategy.FAST
                     : WebsocketReconnectStrategy.REJOIN;
-                this.onReconnectionNeeded?.(strategy, reason, this.peerType);
+                this.onReconnectionNeeded?.(strategy, ReconnectReason.RESTART_ICE_FAILED, this.peerType);
             });
         };
         /**
@@ -7413,6 +7435,17 @@ class BasePeerConnection {
             const connectionState = this.pc.connectionState;
             return !failedStates.has(iceState) && !failedStates.has(connectionState);
         };
+        /**
+         * Returns true only when the peer connection is currently fully established
+         * (ICE `connected`/`completed` AND connection state `connected`).
+         * Transient states like `disconnected`, `checking`, or `new` return false.
+         */
+        this.isStable = () => {
+            const iceState = this.pc.iceConnectionState;
+            const connectionState = this.pc.connectionState;
+            return ((iceState === 'connected' || iceState === 'completed') &&
+                connectionState === 'connected');
+        };
         /**
          * Handles the ICECandidate event and
          * Initiates an ICE Trickle process with the SFU.
@@ -7462,7 +7495,7 @@ class BasePeerConnection {
             }
             // we can't recover from a failed connection state (contrary to ICE)
             if (state === 'failed') {
-                this.onReconnectionNeeded?.(WebsocketReconnectStrategy.REJOIN, 'Connection failed', this.peerType);
+                this.onReconnectionNeeded?.(WebsocketReconnectStrategy.REJOIN, ReconnectReason.CONNECTION_FAILED, this.peerType);
                 return;
             }
             this.handleConnectionStateUpdate(state);
@@ -7484,6 +7517,41 @@ class BasePeerConnection {
             // do nothing when ICE is restarting
             if (this.isIceRestarting)
                 return;
+            // Pre-connect handling: ICE has never reached `connected`/`completed`.
+            // Restart is futile here (the data plane was never established), but
+            // these two terminal-ish states need different treatment:
+            // - `failed` is terminal, escalate to REJOIN so a new SFU/credentials
+            //   /PC configuration gets a chance, and let `Call.reconnect` count
+            //   this toward the unsupported-network budget.
+            // - `disconnected` is transient, the browser may yet move back to
+            //   `checking`/`connected`. Don't restart, don't escalate; wait it
+            //   out. If it ultimately fails, ICE will transition to `failed` and
+            //   the branch above will take over.
+            if (!this.iceHasEverConnected) {
+                if (state === 'failed') {
+                    this.logger.info('ICE failed before connected, escalating to REJOIN');
+                    clearTimeout(this.preConnectStuckTimeout);
+                    this.preConnectStuckTimeout = undefined;
+                    this.onReconnectionNeeded?.(WebsocketReconnectStrategy.REJOIN, ReconnectReason.ICE_NEVER_CONNECTED, this.peerType);
+                    return;
+                }
+                if (state === 'disconnected') {
+                    this.logger.info('ICE disconnected before connected, wait to recover');
+                    // Watchdog: if the browser stays in `disconnected` without ever
+                    // reaching `connected` or transitioning to `failed`, escalate to
+                    // REJOIN ourselves so we don't wait silently forever. Rare but
+                    // observed on flaky mobile networks.
+                    clearTimeout(this.preConnectStuckTimeout);
+                    this.preConnectStuckTimeout = setTimeout(() => {
+                        if (!this.iceHasEverConnected &&
+                            this.pc.iceConnectionState === 'disconnected') {
+                            this.logger.info('ICE stuck in pre-connect disconnected, escalating to REJOIN');
+                            this.onReconnectionNeeded?.(WebsocketReconnectStrategy.REJOIN, ReconnectReason.ICE_NEVER_CONNECTED, this.peerType);
+                        }
+                    }, this.iceRestartDelay * 2);
+                    return;
+                }
+            }
             switch (state) {
                 case 'failed':
                     // in the `failed` state, we try to restart ICE immediately
@@ -7503,12 +7571,24 @@ class BasePeerConnection {
                     }, this.iceRestartDelay);
                     break;
                 case 'connected':
-                    // in the `connected` state, we clear the ice restart timeout if it exists
+                case 'completed':
+                    // Fire `onIceConnected` exactly once per peer-connection lifetime —
+                    // the first time ICE reaches `connected`/`completed` end-to-end.
+                    // Used by `Call` to reset the unsupported-network failure counter
+                    // only after WebRTC has actually recovered, not merely on SFU join.
+                    if (!this.iceHasEverConnected) {
+                        this.iceHasEverConnected = true;
+                        this.onIceConnected?.(this.peerType);
+                    }
+                    // clear any scheduled restartICE since the connection is healthy
                     if (this.iceRestartTimeout) {
                         this.logger.info('connected connection, canceling restartICE');
                         clearTimeout(this.iceRestartTimeout);
                         this.iceRestartTimeout = undefined;
                     }
+                    // clear the pre-connect watchdog if it was armed
+                    clearTimeout(this.preConnectStuckTimeout);
+                    this.preConnectStuckTimeout = undefined;
                     break;
             }
         };
@@ -7541,6 +7621,7 @@ class BasePeerConnection {
         this.clientPublishOptions = clientPublishOptions;
         this.tag = tag;
         this.onReconnectionNeeded = onReconnectionNeeded;
+        this.onIceConnected = onIceConnected;
         this.logger = videoLoggerSystem.getLogger(peerType === PeerType.SUBSCRIBER ? 'Subscriber' : 'Publisher', { tags: [tag] });
         this.pc = this.createPeerConnection(connectionConfig);
         this.stats = new StatsTracer(this.pc, peerType, this.trackIdToTrackType);
@@ -7559,7 +7640,10 @@ class BasePeerConnection {
     dispose() {
         clearTimeout(this.iceRestartTimeout);
         this.iceRestartTimeout = undefined;
+        clearTimeout(this.preConnectStuckTimeout);
+        this.preConnectStuckTimeout = undefined;
         this.onReconnectionNeeded = undefined;
+        this.onIceConnected = undefined;
         this.isDisposed = true;
         this.detachEventHandlers();
         this.pc.close();
@@ -8213,7 +8297,8 @@ class Publisher extends BasePeerConnection {
             const trackInfos = [];
             for (const publishOption of this.publishOptions) {
                 const bundle = this.transceiverCache.get(publishOption);
-                if (!bundle || !bundle.transceiver.sender.track)
+                const track = bundle?.transceiver.sender.track;
+                if (!bundle || !track || track.readyState !== 'live')
                     continue;
                 trackInfos.push(this.toTrackInfo(bundle, sdp));
             }
@@ -8558,6 +8643,20 @@ class SfuJoinError extends Error {
     }
 }
 
+/**
+ * Creates a fresh `joinResponseTask` with a no-op rejection handler attached
+ * to the underlying promise. The handler marks the rejection path as handled
+ * so a teardown-time reject (e.g., from `close()` during disposal) does not
+ * surface as an `UnhandledPromiseRejection`. Explicit awaiters of
+ * `StreamSfuClient.joinTask` still observe the rejection through their own
+ * `then`/`catch` chain. `.catch()` returns a new promise; the original is
+ * unchanged.
+ */
+const makeJoinResponseTask = () => {
+    const task = promiseWithResolvers();
+    task.promise.catch(() => { }); // see the comment above
+    return task;
+};
 /**
  * The client used for exchanging information with the SFU.
  */
@@ -8589,9 +8688,10 @@ class StreamSfuClient {
         this.subscriptionsConcurrencyTag = Symbol('subscriptionsConcurrencyTag');
         /**
          * Promise that resolves when the JoinResponse is received.
-         * Rejects after a certain threshold if the response is not received.
+         * Rejects after a certain threshold if the response is not received,
+         * or when the SFU client is disposed before a join completes.
          */
-        this.joinResponseTask = promiseWithResolvers();
+        this.joinResponseTask = makeJoinResponseTask();
         /**
          * A controller to abort the current requests.
          */
@@ -8661,14 +8761,21 @@ class StreamSfuClient {
         };
         this.close = (code = StreamSfuClient.NORMAL_CLOSURE, reason) => {
             this.isClosingClean = code !== StreamSfuClient.ERROR_CONNECTION_UNHEALTHY;
-            if (this.signalWs.readyState === WebSocket.OPEN) {
+            // Close the WebSocket whether it has fully opened (`OPEN`) or is still
+            // mid-handshake (`CONNECTING`). The WebSocket spec aborts the handshake
+            // when `close()` is called on a CONNECTING socket. Without this, an
+            // SFU socket that opens just after teardown would dispatch events into
+            // a Call instance that has already moved on.
+            const ws = this.signalWs;
+            if (ws.readyState === WebSocket.OPEN ||
+                ws.readyState === WebSocket.CONNECTING) {
                 this.logger.debug(`Closing SFU WS connection: ${code} - ${reason}`);
-                this.signalWs.close(code, `js-client: ${reason}`);
-                this.signalWs.removeEventListener('close', this.handleWebSocketClose);
+                ws.close(code, `js-client: ${reason}`);
+                ws.removeEventListener('close', this.handleWebSocketClose);
             }
-            this.dispose();
+            this.dispose(reason);
         };
-        this.dispose = () => {
+        this.dispose = (reason) => {
             this.logger.debug('Disposing SFU client');
             this.unsubscribeIceTrickle();
             this.unsubscribeNetworkChanged();
@@ -8677,6 +8784,13 @@ class StreamSfuClient {
             clearTimeout(this.migrateAwayTimeout);
             this.abortController.abort();
             this.migrationTask?.resolve();
+            // Settle a pending `joinResponseTask` so `leaveAndClose`, `join()`, and
+            // any other awaiters (`await this.joinTask`) don't hang indefinitely
+            // when the SFU client is torn down before the SFU sent a JoinResponse.
+            if (!this.joinResponseTask.isResolved() &&
+                !this.joinResponseTask.isRejected()) {
+                this.joinResponseTask.reject(new Error(`SFU client disposed before join completed${reason ? `: ${reason}` : ''}`));
+            }
             this.iceTrickleBuffer.dispose();
         };
         this.getTrace = () => {
@@ -8685,8 +8799,24 @@ class StreamSfuClient {
         this.leaveAndClose = async (reason) => {
             try {
                 this.isLeaving = true;
-                await this.joinTask;
-                await this.notifyLeave(reason);
+                // Best-effort: give an in-flight join a short grace period to complete
+                // so we can send a graceful `leaveCallRequest`. Bounded so we never hang
+                // here if the SFU is unresponsive. If the task settles either way during
+                // the wait, the re-check below decides whether to notify.
+                if (!this.joinResponseTask.isResolved() &&
+                    !this.joinResponseTask.isRejected()) {
+                    await Promise.race([
+                        // swallow rejection — we re-check `isResolved()` below to decide
+                        this.joinResponseTask.promise.catch(() => { }),
+                        sleep(StreamSfuClient.LEAVE_NOTIFY_GRACE_MS),
+                    ]);
+                }
+                if (this.joinResponseTask.isResolved()) {
+                    await this.notifyLeave(reason);
+                }
+                else {
+                    this.logger.debug('[leaveAndClose] join not completed within grace period, skipping notifyLeave');
+                }
             }
             catch (err) {
                 this.logger.debug('Error notifying SFU about leaving call', err);
@@ -8755,9 +8885,9 @@ class StreamSfuClient {
                 this.joinResponseTask.isRejected()) {
                 // we need to lock the RPC requests until we receive a JoinResponse.
                 // that's why we have this primitive lock mechanism.
-                // the client starts with already initialized joinResponseTask,
+                // the client starts with an already initialized joinResponseTask,
                 // and this code creates a new one for the next join request.
-                this.joinResponseTask = promiseWithResolvers();
+                this.joinResponseTask = makeJoinResponseTask();
             }
             // capture a reference to the current joinResponseTask as it might
             // be replaced with a new one in case a second join request is made
@@ -8930,6 +9060,12 @@ StreamSfuClient.DISPOSE_OLD_SOCKET = 4100;
  * The close code used when the client fails to join the call (on the SFU).
  */
 StreamSfuClient.JOIN_FAILED = 4101;
+/**
+ * Best-effort grace period in `leaveAndClose` for an in-flight join to
+ * complete before we give up and close without sending `leaveCallRequest`.
+ * Bounded so a stuck join can never hang the leave path.
+ */
+StreamSfuClient.LEAVE_NOTIFY_GRACE_MS = 1000;
 
 /**
  * Event handler that watched the delivery of `call.accepted`.
@@ -10325,6 +10461,50 @@ const CallTypes = new CallTypesRegistry([
     }),
 ]);
 
+/**
+ * A generic sliding-window rate limiter.
+ *
+ * Allows at most `maxAttempts` registrations inside a rolling `windowMs`.
+ * Attempts spaced further apart than `windowMs` are always allowed.
+ */
+class SlidingWindowRateLimiter {
+    constructor(maxAttempts, windowMs) {
+        this.timestamps = [];
+        /**
+         * Attempts to register a new event at `now`. Returns `true` if the attempt
+         * fits inside the budget (and records it), or `false` if the budget is
+         * exhausted (in which case no timestamp is recorded).
+         */
+        this.tryRegister = (now = Date.now()) => {
+            this.prune(now);
+            if (this.timestamps.length >= this.maxAttempts)
+                return false;
+            this.timestamps.push(now);
+            return true;
+        };
+        /**
+         * Clears the attempt history.
+         */
+        this.reset = () => {
+            this.timestamps = [];
+        };
+        /**
+         * Updates the budget and window size. Existing timestamps are kept; they
+         * will be pruned by the next `tryRegister` call.
+         */
+        this.setLimits = (maxAttempts, windowMs) => {
+            this.maxAttempts = maxAttempts;
+            this.windowMs = windowMs;
+        };
+        this.prune = (now) => {
+            const cutoff = now - this.windowMs;
+            this.timestamps = this.timestamps.filter((t) => t >= cutoff);
+        };
+        this.maxAttempts = maxAttempts;
+        this.windowMs = windowMs;
+    }
+}
+
 /**
  * Deactivates MediaStream (stops and removes tracks) to be later garbage collected
  *
@@ -10706,7 +10886,6 @@ const getScreenShareStream = async (options, tracer) => {
     const tag = `navigator.mediaDevices.getDisplayMedia.${getDisplayMediaExecId++}.`;
     try {
         const constraints = {
-            // @ts-expect-error - not present in types yet
             systemAudio: 'include',
             ...options,
             video: typeof options?.video === 'boolean'
@@ -10721,6 +10900,8 @@ const getScreenShareStream = async (options, tracer) => {
                 ? options.audio
                 : {
                     channelCount: { ideal: 2 },
+                    // @ts-expect-error not yet present in the types
+                    restrictOwnAudio: true,
                     echoCancellation: false,
                     autoGainControl: false,
                     noiseSuppression: false,
@@ -11365,6 +11546,7 @@ class DeviceManagerState {
         this.statusSubject = new BehaviorSubject(undefined);
         this.optimisticStatusSubject = new BehaviorSubject(undefined);
         this.mediaStreamSubject = new BehaviorSubject(undefined);
+        this.rootMediaStreamSubject = new BehaviorSubject(undefined);
         this.selectedDeviceSubject = new BehaviorSubject(undefined);
         this.defaultConstraintsSubject = new BehaviorSubject(undefined);
         /**
@@ -11372,6 +11554,12 @@ class DeviceManagerState {
          *
          */
         this.mediaStream$ = this.mediaStreamSubject.asObservable();
+        /**
+         * An Observable that emits the raw device media stream (before any filters are applied),
+         * or `undefined` if the device is currently disabled. When no filters are active, this
+         * emits the same stream as `mediaStream$`.
+         */
+        this.rootMediaStream$ = this.rootMediaStreamSubject.asObservable();
         /**
          * An Observable that emits the currently selected device
          */
@@ -11427,6 +11615,14 @@ class DeviceManagerState {
     get mediaStream() {
         return getCurrentValue(this.mediaStream$);
     }
+    /**
+     * The raw device media stream (before any filters are applied), or `undefined`
+     * if the device is currently disabled. When no filters are active, this is the
+     * same as `mediaStream`.
+     */
+    get rootMediaStream() {
+        return getCurrentValue(this.rootMediaStream$);
+    }
     /**
      * @internal
      * @param status
@@ -11451,6 +11647,7 @@ class DeviceManagerState {
      */
     setMediaStream(stream, rootStream) {
         setCurrentValue(this.mediaStreamSubject, stream);
+        setCurrentValue(this.rootMediaStreamSubject, rootStream);
         if (rootStream) {
             this.setDevice(this.getDeviceIdFromStream(rootStream));
         }
@@ -11933,192 +12130,6 @@ const createNoAudioDetector = (audioStream, options) => {
     return stop;
 };
 
-class RNSpeechDetector {
-    constructor(externalAudioStream) {
-        this.pc1 = new RTCPeerConnection({});
-        this.pc2 = new RTCPeerConnection({});
-        this.isStopped = false;
-        this.externalAudioStream = externalAudioStream;
-    }
-    /**
-     * Starts the speech detection.
-     */
-    async start(onSoundDetectedStateChanged) {
-        let detachListeners;
-        let unsubscribe;
-        try {
-            this.isStopped = false;
-            const audioStream = this.externalAudioStream != null
-                ? this.externalAudioStream
-                : await navigator.mediaDevices.getUserMedia({ audio: true });
-            this.audioStream = audioStream;
-            const onPc1IceCandidate = (e) => {
-                this.forwardIceCandidate(this.pc2, e.candidate);
-            };
-            const onPc2IceCandidate = (e) => {
-                this.forwardIceCandidate(this.pc1, e.candidate);
-            };
-            const onTrackPc2 = (e) => {
-                e.streams[0].getTracks().forEach((track) => {
-                    // In RN, the remote track is automatically added to the audio output device
-                    // so we need to mute it to avoid hearing the audio back
-                    // @ts-expect-error _setVolume is a private method in react-native-webrtc
-                    track._setVolume(0);
-                });
-            };
-            this.pc1.addEventListener('icecandidate', onPc1IceCandidate);
-            this.pc2.addEventListener('icecandidate', onPc2IceCandidate);
-            this.pc2.addEventListener('track', onTrackPc2);
-            detachListeners = () => {
-                this.pc1.removeEventListener('icecandidate', onPc1IceCandidate);
-                this.pc2.removeEventListener('icecandidate', onPc2IceCandidate);
-                this.pc2.removeEventListener('track', onTrackPc2);
-            };
-            audioStream
-                .getTracks()
-                .forEach((track) => this.pc1.addTrack(track, audioStream));
-            const offer = await this.pc1.createOffer({});
-            await this.pc2.setRemoteDescription(offer);
-            await this.pc1.setLocalDescription(offer);
-            const answer = await this.pc2.createAnswer();
-            await this.pc1.setRemoteDescription(answer);
-            await this.pc2.setLocalDescription(answer);
-            unsubscribe = this.onSpeakingDetectedStateChange(onSoundDetectedStateChanged);
-            return () => {
-                detachListeners?.();
-                unsubscribe?.();
-                this.stop();
-            };
-        }
-        catch (error) {
-            detachListeners?.();
-            unsubscribe?.();
-            this.stop();
-            const logger = videoLoggerSystem.getLogger('RNSpeechDetector');
-            logger.error('error handling permissions: ', error);
-            return () => { };
-        }
-    }
-    /**
-     * Stops the speech detection and releases all allocated resources.
-     */
-    stop() {
-        if (this.isStopped)
-            return;
-        this.isStopped = true;
-        this.pc1.close();
-        this.pc2.close();
-        if (this.externalAudioStream != null) {
-            this.externalAudioStream = undefined;
-        }
-        else {
-            this.cleanupAudioStream();
-        }
-    }
-    /**
-     * Public method that detects the audio levels and returns the status.
-     */
-    onSpeakingDetectedStateChange(onSoundDetectedStateChanged) {
-        const initialBaselineNoiseLevel = 0.13;
-        let baselineNoiseLevel = initialBaselineNoiseLevel;
-        let speechDetected = false;
-        let speechTimer;
-        let silenceTimer;
-        const audioLevelHistory = []; // Store recent audio levels for smoother detection
-        const historyLength = 10;
-        const silenceThreshold = 1.1;
-        const resetThreshold = 0.9;
-        const speechTimeout = 500; // Speech is set to true after 500ms of audio detection
-        const silenceTimeout = 5000; // Reset baseline after 5 seconds of silence
-        const checkAudioLevel = async () => {
-            try {
-                const stats = await this.pc1.getStats();
-                const report = flatten(stats);
-                // Audio levels are present inside stats of type `media-source` and of kind `audio`
-                const audioMediaSourceStats = report.find((stat) => stat.type === 'media-source' &&
-                    stat.kind === 'audio');
-                if (audioMediaSourceStats) {
-                    const { audioLevel } = audioMediaSourceStats;
-                    if (audioLevel) {
-                        // Update audio level history (with max historyLength sized array)
-                        audioLevelHistory.push(audioLevel);
-                        if (audioLevelHistory.length > historyLength) {
-                            audioLevelHistory.shift();
-                        }
-                        // Calculate average audio level
-                        const avgAudioLevel = audioLevelHistory.reduce((a, b) => a + b, 0) /
-                            audioLevelHistory.length;
-                        // Update baseline (if necessary) based on silence detection
-                        if (avgAudioLevel < baselineNoiseLevel * silenceThreshold) {
-                            if (!silenceTimer) {
-                                silenceTimer = setTimeout(() => {
-                                    baselineNoiseLevel = Math.min(avgAudioLevel * resetThreshold, initialBaselineNoiseLevel);
-                                }, silenceTimeout);
-                            }
-                        }
-                        else {
-                            clearTimeout(silenceTimer);
-                            silenceTimer = undefined;
-                        }
-                        // Speech detection with hysteresis
-                        if (avgAudioLevel > baselineNoiseLevel * 1.5) {
-                            if (!speechDetected) {
-                                speechDetected = true;
-                                onSoundDetectedStateChanged({
-                                    isSoundDetected: true,
-                                    audioLevel,
-                                });
-                            }
-                            clearTimeout(speechTimer);
-                            speechTimer = setTimeout(() => {
-                                speechDetected = false;
-                                onSoundDetectedStateChanged({
-                                    isSoundDetected: false,
-                                    audioLevel: 0,
-                                });
-                            }, speechTimeout);
-                        }
-                    }
-                }
-            }
-            catch (error) {
-                const logger = videoLoggerSystem.getLogger('RNSpeechDetector');
-                logger.error('error checking audio level from stats', error);
-            }
-        };
-        const intervalId = setInterval(checkAudioLevel, 250);
-        return () => {
-            clearInterval(intervalId);
-            clearTimeout(speechTimer);
-            clearTimeout(silenceTimer);
-        };
-    }
-    cleanupAudioStream() {
-        if (!this.audioStream) {
-            return;
-        }
-        this.audioStream.getTracks().forEach((track) => track.stop());
-        if (
-        // @ts-expect-error release() is present in react-native-webrtc
-        typeof this.audioStream.release === 'function') {
-            // @ts-expect-error called to dispose the stream in RN
-            this.audioStream.release();
-        }
-    }
-    forwardIceCandidate(destination, candidate) {
-        if (this.isStopped ||
-            !candidate ||
-            destination.signalingState === 'closed') {
-            return;
-        }
-        destination.addIceCandidate(candidate).catch(() => {
-            // silently ignore the error
-            const logger = videoLoggerSystem.getLogger('RNSpeechDetector');
-            logger.info('cannot add ice candidate - ignoring');
-        });
-    }
-}
-
 class MicrophoneManager extends AudioDeviceManager {
     constructor(call, devicePersistence, disableMode = 'stop-tracks') {
         super(call, new MicrophoneManagerState(disableMode, call.tracer), TrackType.AUDIO, devicePersistence);
@@ -12431,13 +12442,16 @@ class MicrophoneManager extends AudioDeviceManager {
                 return;
             await this.teardownSpeakingWhileMutedDetection();
             if (isReactNative()) {
-                this.rnSpeechDetector = new RNSpeechDetector();
-                const unsubscribe = await this.rnSpeechDetector.start((event) => {
+                const speechActivity = globalThis.streamRNVideoSDK?.nativeEvents?.speechActivity;
+                if (!speechActivity) {
+                    this.logger.warn('Native speech activity not available, make sure the "@stream-io/react-native-webrtc" peer dependency version is satisfied');
+                    return;
+                }
+                const unsubscribe = speechActivity.subscribe((event) => {
                     this.state.setSpeakingWhileMuted(event.isSoundDetected);
                 });
                 this.soundDetectorCleanup = async () => {
                     unsubscribe();
-                    this.rnSpeechDetector = undefined;
                 };
             }
             else {
@@ -12885,6 +12899,16 @@ class Call {
         this.fastReconnectDeadlineSeconds = 0;
         this.disconnectionTimeoutSeconds = 0;
         this.lastOfflineTimestamp = 0;
+        // (10 attempts per rolling 120 s window).
+        this.rejoinRateLimiter = new SlidingWindowRateLimiter(10, 120000);
+        // "Network doesn't support WebRTC" detector: counts peer-connection
+        // failures where ICE never reached `connected`/`completed`.
+        this.maxIceFailuresWithoutConnect = 2;
+        this.iceFailuresWithoutConnect = 0;
+        // Consecutive-negotiation-failure detector: stops the reconnect loop when
+        // the SFU keeps failing to negotiate SDP for us.
+        this.maxConsecutiveNegotiationFailures = 3;
+        this.consecutiveNegotiationFailures = 0;
         // maintain the order of publishing tracks to restore them after a reconnection
         // it shouldn't contain duplicates
         this.trackPublishOrder = [];
@@ -13187,6 +13211,19 @@ class Call {
                 this.state.setCallingState(CallingState.LEFT);
                 this.state.setParticipants([]);
                 this.state.dispose();
+                // Reset reconnect-related accumulators so a future `call.join()` on the
+                // same instance starts with a fresh budget. The `Call` may be reused
+                // (see `Call.test.ts` "can reuse call instance") so this is required.
+                // Strategy/reason/attempts must also be cleared: when `leave()` is
+                // reached via `giveUpAndLeave()` the success-path reset at the end of
+                // `joinFlow` never runs, leaving stale values that would make the next
+                // fresh `join()` send a stale `ReconnectDetails` to the SFU.
+                this.rejoinRateLimiter.reset();
+                this.iceFailuresWithoutConnect = 0;
+                this.consecutiveNegotiationFailures = 0;
+                this.reconnectStrategy = WebsocketReconnectStrategy.UNSPECIFIED;
+                this.reconnectReason = '';
+                this.reconnectAttempts = 0;
                 // Call all leave call hooks, e.g. to clean up global event handlers
                 this.leaveCallHooks.forEach((hook) => hook());
                 this.initialized = false;
@@ -13537,9 +13574,20 @@ class Call {
             // when performing fast reconnect, or when we reuse the same SFU client,
             // (ws remained healthy), we just need to restore the ICE connection
             if (performingFastReconnect) {
-                // the SFU automatically issues an ICE restart on the subscriber
-                // we don't have to do it ourselves
-                await this.restoreICE(sfuClient, { includeSubscriber: false });
+                // The SFU automatically issues an ICE restart on the subscriber,
+                // so we only need to decide about the publisher. If the publisher's
+                // peer connection is still stable (ICE still connected end-to-end),
+                // the signal WebSocket drop was the only problem — the new WS alone
+                // is enough, and restarting ICE would add unnecessary SDP/ICE churn.
+                const publisherIsStable = this.publisher?.isStable() ?? true;
+                const includePublisher = !!this.publisher?.isPublishing() && !publisherIsStable;
+                if (!includePublisher && this.publisher?.isPublishing()) {
+                    this.logger.info('[Reconnect] FAST: skipping publisher ICE restart, publisher PC is stable');
+                }
+                await this.restoreICE(sfuClient, {
+                    includeSubscriber: false,
+                    includePublisher,
+                });
             }
             else {
                 const connectionConfig = toRtcConfiguration(this.credentials.ice_servers);
@@ -13582,6 +13630,15 @@ class Call {
             // reset the reconnect strategy to unspecified after a successful reconnection
             this.reconnectStrategy = WebsocketReconnectStrategy.UNSPECIFIED;
             this.reconnectReason = '';
+            // A successful SFU join handshake resets the consecutive-negotiation
+            // counter (negotiation just succeeded). It does NOT reset
+            // `iceFailuresWithoutConnect` or the rolling `rejoinRateLimiter`;
+            // those track WebRTC-level health and rejoin frequency, which are not
+            // proven by the SFU handshake alone. ICE-failures-without-connect is
+            // cleared via the `onIceConnected` callback when the peer connection
+            // actually reaches `connected`/`completed` end-to-end. The rejoin
+            // rolling window decays naturally as old timestamps age out.
+            this.consecutiveNegotiationFailures = 0;
             this.logger.info(`Joined call ${this.cid}`);
         };
         /**
@@ -13699,6 +13756,12 @@ class Call {
                         this.logger.warn(message, err);
                     });
                 },
+                onIceConnected: () => {
+                    // ICE has reached `connected`/`completed` end-to-end on at least
+                    // one peer connection, WebRTC is actually working, so the
+                    // "ICE never connected" failure budget can be cleared.
+                    this.iceFailuresWithoutConnect = 0;
+                },
             };
             this.subscriber = new Subscriber(basePeerConnectionOptions);
             // anonymous users can't publish anything hence, there is no need
@@ -13804,7 +13867,9 @@ class Call {
          * @internal
          *
          * @param strategy the reconnection strategy to use.
-         * @param reason the reason for the reconnection.
+         * @param reason the reason for the reconnection. Pass a `ReconnectReason.*`
+         *   constant when the SDK should react to it (e.g.
+         *   `ICE_NEVER_CONNECTED` increments the unsupported-network counter).
          */
         this.reconnect = async (strategy, reason) => {
             if (this.state.callingState === CallingState.RECONNECTING ||
@@ -13825,6 +13890,30 @@ class Call {
                         this.state.setCallingState(CallingState.RECONNECTING_FAILED);
                     }
                 };
+                const giveUpAndLeave = async (message) => {
+                    this.logger.warn(`[Reconnect] Giving up: ${message}. Leaving the call.`);
+                    // If we're mid-iteration, the state can be JOINING; `Call.leave` would
+                    // then wait for JOINED before proceeding, but no more attempts will run
+                    // so JOINED never comes. Transition to RECONNECTING so `leave()` proceeds.
+                    if (this.state.callingState === CallingState.JOINING) {
+                        this.state.setCallingState(CallingState.RECONNECTING);
+                    }
+                    try {
+                        await this.leave({ message });
+                    }
+                    catch (err) {
+                        this.logger.warn(`[Reconnect] leave() failed after ${message}`, err);
+                    }
+                };
+                // Count this entry into reconnect if it was triggered by a peer
+                // connection that never reached `connected`/`completed`.
+                if (reason === ReconnectReason.ICE_NEVER_CONNECTED) {
+                    this.iceFailuresWithoutConnect++;
+                    if (this.iceFailuresWithoutConnect >= this.maxIceFailuresWithoutConnect) {
+                        await giveUpAndLeave('webrtc_unsupported_network');
+                        return;
+                    }
+                }
                 let attempt = 0;
                 do {
                     const reconnectingTime = Date.now() - reconnectStartTime;
@@ -13835,6 +13924,16 @@ class Call {
                         await markAsReconnectingFailed();
                         return;
                     }
+                    // Rejoin rate limit: bound the number of REJOIN (and MIGRATE)
+                    // transitions inside a rolling window. FAST is not counted because
+                    // it does not issue a new backend `joinCall`.
+                    if (this.reconnectStrategy === WebsocketReconnectStrategy.REJOIN ||
+                        this.reconnectStrategy === WebsocketReconnectStrategy.MIGRATE) {
+                        if (!this.rejoinRateLimiter.tryRegister()) {
+                            await giveUpAndLeave('rejoin_attempt_limit_exceeded');
+                            return;
+                        }
+                    }
                     // we don't increment reconnect attempts for the FAST strategy.
                     if (this.reconnectStrategy !== WebsocketReconnectStrategy.FAST) {
                         this.reconnectAttempts++;
@@ -13862,6 +13961,8 @@ class Call {
                                 ensureExhausted(this.reconnectStrategy, 'Unknown reconnection strategy');
                                 break;
                         }
+                        // reconnection worked — reset the negotiation-failure streak.
+                        this.consecutiveNegotiationFailures = 0;
                         break; // do-while loop, reconnection worked, exit the loop
                     }
                     catch (error) {
@@ -13876,7 +13977,16 @@ class Call {
                             await markAsReconnectingFailed();
                             return;
                         }
-                        await sleep(500);
+                        if (error instanceof NegotiationError) {
+                            this.consecutiveNegotiationFailures++;
+                            if (this.consecutiveNegotiationFailures >=
+                                this.maxConsecutiveNegotiationFailures) {
+                                await giveUpAndLeave('repeated_negotiation_failures');
+                                return;
+                            }
+                        }
+                        // exponential backoff with jitter, capped at 5 s
+                        await sleep(retryInterval(attempt));
                         const wasMigrating = this.reconnectStrategy === WebsocketReconnectStrategy.MIGRATE;
                         const mustPerformRejoin = (Date.now() - reconnectStartTime) / 1000 >
                             this.fastReconnectDeadlineSeconds;
@@ -13985,7 +14095,7 @@ class Call {
         this.registerReconnectHandlers = () => {
             // handles the legacy "goAway" event
             const unregisterGoAway = this.on('goAway', () => {
-                this.reconnect(WebsocketReconnectStrategy.MIGRATE, 'goAway').catch((err) => this.logger.warn('[Reconnect] Error reconnecting', err));
+                this.reconnect(WebsocketReconnectStrategy.MIGRATE, ReconnectReason.GO_AWAY).catch((err) => this.logger.warn('[Reconnect] Error reconnecting', err));
             });
             // handles the "error" event, through which the SFU can request a reconnect
             const unregisterOnError = this.on('error', (e) => {
@@ -14004,7 +14114,7 @@ class Call {
                     });
                 }
                 else {
-                    this.reconnect(strategy, error?.message || 'SFU Error').catch((err) => {
+                    this.reconnect(strategy, error?.message || ReconnectReason.SFU_ERROR).catch((err) => {
                         this.logger.warn('[Reconnect] Error reconnecting', err);
                     });
                 }
@@ -14028,7 +14138,7 @@ class Call {
                                 strategy = WebsocketReconnectStrategy.REJOIN;
                             }
                         }
-                        this.reconnect(strategy, 'Going online').catch((err) => {
+                        this.reconnect(strategy, ReconnectReason.NETWORK_BACK_ONLINE).catch((err) => {
                             this.logger.warn('[Reconnect] Error reconnecting after going online', err);
                         });
                     });
@@ -14171,10 +14281,12 @@ class Call {
          * @param trackTypes the track types to update the call state with.
          */
         this.updateLocalStreamState = async (mediaStream, ...trackTypes) => {
-            if (!this.sfuClient || !this.sfuClient.sessionId)
+            const sessionId = this.sfuClient?.sessionId;
+            if (!sessionId)
                 return;
             await this.notifyTrackMuteState(!mediaStream, ...trackTypes);
-            const { sessionId } = this.sfuClient;
+            if (this.sfuClient?.sessionId !== sessionId)
+                return;
             for (const trackType of trackTypes) {
                 const streamStateProp = trackTypeToParticipantStreamKey(trackType);
                 if (!streamStateProp)
@@ -14970,6 +15082,39 @@ class Call {
         this.setDisconnectionTimeout = (timeoutSeconds) => {
             this.disconnectionTimeoutSeconds = timeoutSeconds;
         };
+        /**
+         * Configures the rolling-window limit for REJOIN/MIGRATE attempts. Once
+         * `maxAttempts` rejoins have been registered inside `windowSeconds`, the
+         * SDK stops retrying and transitions the call to `LEFT` with the
+         * `rejoin_attempt_limit_exceeded` leave message.
+         *
+         * Defaults: 10 attempts per 120 seconds (aligned with the Swift SDK).
+         * Both arguments are clamped to a minimum of 1.
+         */
+        this.setRejoinAttemptLimit = (maxAttempts, windowSeconds) => {
+            this.rejoinRateLimiter.setLimits(Math.max(1, maxAttempts), Math.max(1, windowSeconds) * 1000);
+        };
+        /**
+         * Configures how many peer-connection failures where ICE never reached
+         * `connected`/`completed` are tolerated before the SDK concludes that the
+         * current network cannot support WebRTC and transitions the call to
+         * `LEFT` with the `webrtc_unsupported_network` leave message.
+         *
+         * Default: 2. Clamped to a minimum of 1.
+         */
+        this.setMaxIceFailuresWithoutConnect = (n) => {
+            this.maxIceFailuresWithoutConnect = Math.max(1, n);
+        };
+        /**
+         * Configures how many consecutive SDP `NegotiationError`s are tolerated
+         * before the SDK stops retrying and transitions the call to `LEFT` with
+         * the `repeated_negotiation_failures` leave message.
+         *
+         * Default: 3. Clamped to a minimum of 1.
+         */
+        this.setMaxConsecutiveNegotiationFailures = (n) => {
+            this.maxConsecutiveNegotiationFailures = Math.max(1, n);
+        };
         /**
          * Enables the provided client capabilities.
          */
@@ -16150,7 +16295,7 @@ class StreamClient {
         this.getUserAgent = () => {
             if (!this.cachedUserAgent) {
                 const { clientAppIdentifier = {} } = this.options;
-                const { sdkName = 'js', sdkVersion = "1.47.0", ...extras } = clientAppIdentifier;
+                const { sdkName = 'js', sdkVersion = "1.49.0", ...extras } = clientAppIdentifier;
                 this.cachedUserAgent = [
                     `stream-video-${sdkName}-v${sdkVersion}`,
                     ...Object.entries(extras).map(([key, value]) => `${key}=${value}`),
@@ -16786,5 +16931,5 @@ const humanize = (n) => {
     return String(n);
 };
 
-export { AudioSettingsRequestDefaultDeviceEnum, AudioSettingsResponseDefaultDeviceEnum, browsers as Browsers, Call, CallRecordingFailedEventRecordingTypeEnum, CallRecordingReadyEventRecordingTypeEnum, CallRecordingStartedEventRecordingTypeEnum, CallRecordingStoppedEventRecordingTypeEnum, CallState, CallType, CallTypes, CallingState, CameraManager, CameraManagerState, CreateDeviceRequestPushProviderEnum, DebounceType, DeviceManager, DeviceManagerState, DynascaleManager, ErrorFromResponse, FrameRecordingSettingsRequestModeEnum, FrameRecordingSettingsRequestQualityEnum, FrameRecordingSettingsResponseModeEnum, IndividualRecordingSettingsRequestModeEnum, IndividualRecordingSettingsResponseModeEnum, IngressAudioEncodingOptionsRequestChannelsEnum, IngressSourceRequestFpsEnum, IngressVideoLayerRequestCodecEnum, LayoutSettingsRequestNameEnum, MicrophoneManager, MicrophoneManagerState, NoiseCancellationSettingsModeEnum, OwnCapability, RNSpeechDetector, RTMPBroadcastRequestQualityEnum, RTMPSettingsRequestQualityEnum, RawRecordingSettingsRequestModeEnum, RawRecordingSettingsResponseModeEnum, RecordSettingsRequestModeEnum, RecordSettingsRequestQualityEnum, rxUtils as RxUtils, ScreenShareManager, ScreenShareState, events as SfuEvents, SfuJoinError, models as SfuModels, SpeakerManager, SpeakerState, StartClosedCaptionsRequestLanguageEnum, StartTranscriptionRequestLanguageEnum, StreamSfuClient, StreamVideoClient, StreamVideoReadOnlyStateStore, StreamVideoWriteableStateStore, TranscriptionSettingsRequestClosedCaptionModeEnum, TranscriptionSettingsRequestLanguageEnum, TranscriptionSettingsRequestModeEnum, TranscriptionSettingsResponseClosedCaptionModeEnum, TranscriptionSettingsResponseLanguageEnum, TranscriptionSettingsResponseModeEnum, VideoSettingsRequestCameraFacingEnum, VideoSettingsResponseCameraFacingEnum, ViewportTracker, VisibilityState, checkIfAudioOutputChangeSupported, combineComparators, conditional, createSoundDetector, defaultSortPreset, descending, deviceIds$, disposeOfMediaStream, dominantSpeaker, getAudioBrowserPermission, getAudioDevices, getAudioOutputDevices, getAudioStream, getClientDetails, getDeviceState, getScreenShareStream, getSdkInfo, getVideoBrowserPermission, getVideoDevices, getVideoStream, getWebRTCInfo, hasAudio$1 as hasAudio, hasPausedTrack, hasScreenShare, hasScreenShareAudio, hasVideo, humanize, isPinned, livestreamOrAudioRoomSortPreset, logToConsole, name, noopComparator, paginatedLayoutSortPreset, pinned, publishingAudio, publishingVideo, reactionType, resolveDeviceId, role, screenSharing, setDeviceInfo, setOSInfo, setPowerState, setSdkInfo, setThermalState, setWebRTCInfo, speakerLayoutSortPreset, speaking, videoLoggerSystem, withParticipantSource };
+export { AudioSettingsRequestDefaultDeviceEnum, AudioSettingsResponseDefaultDeviceEnum, browsers as Browsers, Call, CallRecordingFailedEventRecordingTypeEnum, CallRecordingReadyEventRecordingTypeEnum, CallRecordingStartedEventRecordingTypeEnum, CallRecordingStoppedEventRecordingTypeEnum, CallState, CallType, CallTypes, CallingState, CameraManager, CameraManagerState, CreateDeviceRequestPushProviderEnum, DebounceType, DeviceManager, DeviceManagerState, DynascaleManager, ErrorFromResponse, FrameRecordingSettingsRequestModeEnum, FrameRecordingSettingsRequestQualityEnum, FrameRecordingSettingsResponseModeEnum, IndividualRecordingSettingsRequestModeEnum, IndividualRecordingSettingsResponseModeEnum, IngressAudioEncodingOptionsRequestChannelsEnum, IngressSourceRequestFpsEnum, IngressVideoLayerRequestCodecEnum, LayoutSettingsRequestNameEnum, MicrophoneManager, MicrophoneManagerState, NoiseCancellationSettingsModeEnum, OwnCapability, RTMPBroadcastRequestQualityEnum, RTMPSettingsRequestQualityEnum, RawRecordingSettingsRequestModeEnum, RawRecordingSettingsResponseModeEnum, RecordSettingsRequestModeEnum, RecordSettingsRequestQualityEnum, rxUtils as RxUtils, ScreenShareManager, ScreenShareState, events as SfuEvents, SfuJoinError, models as SfuModels, SpeakerManager, SpeakerState, StartClosedCaptionsRequestLanguageEnum, StartTranscriptionRequestLanguageEnum, StreamSfuClient, StreamVideoClient, StreamVideoReadOnlyStateStore, StreamVideoWriteableStateStore, TranscriptionSettingsRequestClosedCaptionModeEnum, TranscriptionSettingsRequestLanguageEnum, TranscriptionSettingsRequestModeEnum, TranscriptionSettingsResponseClosedCaptionModeEnum, TranscriptionSettingsResponseLanguageEnum, TranscriptionSettingsResponseModeEnum, VideoSettingsRequestCameraFacingEnum, VideoSettingsResponseCameraFacingEnum, ViewportTracker, VisibilityState, checkIfAudioOutputChangeSupported, combineComparators, conditional, createSoundDetector, defaultSortPreset, descending, deviceIds$, disposeOfMediaStream, dominantSpeaker, getAudioBrowserPermission, getAudioDevices, getAudioOutputDevices, getAudioStream, getClientDetails, getDeviceState, getScreenShareStream, getSdkInfo, getVideoBrowserPermission, getVideoDevices, getVideoStream, getWebRTCInfo, hasAudio$1 as hasAudio, hasPausedTrack, hasScreenShare, hasScreenShareAudio, hasVideo, humanize, isPinned, livestreamOrAudioRoomSortPreset, logToConsole, name, noopComparator, paginatedLayoutSortPreset, pinned, publishingAudio, publishingVideo, reactionType, resolveDeviceId, role, screenSharing, setDeviceInfo, setOSInfo, setPowerState, setSdkInfo, setThermalState, setWebRTCInfo, speakerLayoutSortPreset, speaking, videoLoggerSystem, withParticipantSource };
 //# sourceMappingURL=index.es.js.map