@stream-io/video-client 1.61.1 → 1.62.0

package/dist/index.browser.es.js

@@ -2665,18 +2665,6 @@ class SendStatsRequest$Type extends MessageType {
     constructor() {
         super('stream.video.sfu.signal.SendStatsRequest', [
             { no: 1, name: 'session_id', kind: 'scalar', T: 9 /*ScalarType.STRING*/ },
-            {
-                no: 2,
-                name: 'subscriber_stats',
-                kind: 'scalar',
-                T: 9 /*ScalarType.STRING*/,
-            },
-            {
-                no: 3,
-                name: 'publisher_stats',
-                kind: 'scalar',
-                T: 9 /*ScalarType.STRING*/,
-            },
             {
                 no: 4,
                 name: 'webrtc_version',
@@ -2690,8 +2678,6 @@ class SendStatsRequest$Type extends MessageType {
                 kind: 'scalar',
                 T: 9 /*ScalarType.STRING*/,
             },
-            { no: 7, name: 'audio_devices', kind: 'message', T: () => InputDevices },
-            { no: 8, name: 'video_devices', kind: 'message', T: () => InputDevices },
             {
                 no: 9,
                 name: 'android',
@@ -2708,18 +2694,6 @@ class SendStatsRequest$Type extends MessageType {
             },
             { no: 11, name: 'telemetry', kind: 'message', T: () => Telemetry },
             { no: 12, name: 'rtmp', kind: 'message', T: () => RTMPIngress },
-            {
-                no: 13,
-                name: 'subscriber_rtc_stats',
-                kind: 'scalar',
-                T: 9 /*ScalarType.STRING*/,
-            },
-            {
-                no: 14,
-                name: 'publisher_rtc_stats',
-                kind: 'scalar',
-                T: 9 /*ScalarType.STRING*/,
-            },
             { no: 15, name: 'rtc_stats', kind: 'scalar', T: 9 /*ScalarType.STRING*/ },
             {
                 no: 16,
@@ -5081,7 +5055,7 @@ const toIceCandidate = (iceTrickle) => {
     }
 };
 
-const version = "1.61.1";
+const version = "1.62.0";
 const [major, minor, patch] = version.split('.');
 let sdkInfo = {
     type: SdkType.PLAIN_JAVASCRIPT,
@@ -7809,30 +7783,21 @@ class SfuStatsReporter {
     sfuClient;
     subscriber;
     publisher;
-    microphone;
-    camera;
-    state;
     tracer;
     unifiedSessionId;
     intervalId;
     timeoutId;
     reportCount = 0;
-    unsubscribeDevicePermissionsSubscription;
-    unsubscribeListDevicesSubscription;
     sdkName;
     sdkVersion;
     webRTCVersion;
-    inputDevices = new Map();
     statsConcurrencyTag = Symbol('sfuStatsReporter');
     isStopped = false;
-    constructor(sfuClient, { options, clientDetails, subscriber, publisher, microphone, camera, state, tracer, unifiedSessionId, }) {
+    constructor(sfuClient, { options, clientDetails, subscriber, publisher, tracer, unifiedSessionId, }) {
         this.sfuClient = sfuClient;
         this.options = options;
         this.subscriber = subscriber;
         this.publisher = publisher;
-        this.microphone = microphone;
-        this.camera = camera;
-        this.state = state;
         this.tracer = tracer;
         this.unifiedSessionId = unifiedSessionId;
         const { sdk, browser } = clientDetails;
@@ -7846,35 +7811,6 @@ class SfuStatsReporter {
                 `${browser?.name || ''}-${browser?.version || ''}` ||
                 'N/A';
     }
-    observeDevice = (device, kind) => {
-        const { browserPermissionState$ } = device.state;
-        this.unsubscribeDevicePermissionsSubscription?.();
-        this.unsubscribeDevicePermissionsSubscription = createSubscription(combineLatest([browserPermissionState$, this.state.ownCapabilities$]), ([browserPermissionState, ownCapabilities]) => {
-            // cleanup the previous listDevices() subscription in case
-            // permissions or capabilities have changed.
-            // we will subscribe again if everything is in order.
-            this.unsubscribeListDevicesSubscription?.();
-            const hasCapability = kind === 'mic'
-                ? ownCapabilities.includes(OwnCapability.SEND_AUDIO)
-                : ownCapabilities.includes(OwnCapability.SEND_VIDEO);
-            if (browserPermissionState !== 'granted' || !hasCapability) {
-                this.inputDevices.set(kind, {
-                    currentDevice: '',
-                    availableDevices: [],
-                    isPermitted: false,
-                });
-                return;
-            }
-            this.unsubscribeListDevicesSubscription = createSubscription(combineLatest([device.listDevices(), device.state.selectedDevice$]), ([devices, deviceId]) => {
-                const selected = devices.find((d) => d.deviceId === deviceId);
-                this.inputDevices.set(kind, {
-                    currentDevice: selected?.label || deviceId || '',
-                    availableDevices: devices.map((d) => d.label),
-                    isPermitted: true,
-                });
-            });
-        });
-    };
     sendConnectionTime = (connectionTimeSeconds) => {
         this.sendTelemetryData({
             data: {
@@ -7909,7 +7845,7 @@ class SfuStatsReporter {
         this.subscriber.stats.takeSample(),
         this.publisher?.stats.takeSample(),
     ]);
-    send = (subscriberStats, publisherStats, telemetry) => {
+    send = (subscriberPerfStats, publisherPerfStats, telemetry) => {
         // serialize sends so overlapping ones can't race on the trace buffers or
         // deliver an older delta after a newer one already succeeded. Not gated by
         // `isStopped`: an explicit final flush must still deliver after stop().
@@ -7927,8 +7863,8 @@ class SfuStatsReporter {
                 this.subscriber.stats.clearPendingDeltas();
             }
             let pubPending = [];
-            if (pubTracer && publisherStats) {
-                pubPending = this.publisher?.stats.getPendingDeltas() ?? [];
+            if (pubTracer && this.publisher) {
+                pubPending = this.publisher.stats.getPendingDeltas();
             }
             else {
                 this.publisher?.stats.clearPendingDeltas();
@@ -7950,17 +7886,9 @@ class SfuStatsReporter {
                     sdk: this.sdkName,
                     sdkVersion: this.sdkVersion,
                     webrtcVersion: this.webRTCVersion,
-                    subscriberStats: JSON.stringify(flatten(subscriberStats.stats)),
-                    publisherStats: publisherStats
-                        ? JSON.stringify(flatten(publisherStats.stats))
-                        : '[]',
-                    subscriberRtcStats: '',
-                    publisherRtcStats: '',
                     rtcStats: JSON.stringify(traces),
-                    encodeStats: publisherStats?.performanceStats ?? [],
-                    decodeStats: subscriberStats.performanceStats,
-                    audioDevices: this.inputDevices.get('mic'),
-                    videoDevices: this.inputDevices.get('camera'),
+                    encodeStats: publisherPerfStats ?? [],
+                    decodeStats: subscriberPerfStats,
                     unifiedSessionId: this.unifiedSessionId,
                     deviceState: getDeviceState(),
                     telemetry,
@@ -7974,8 +7902,8 @@ class SfuStatsReporter {
                 // delivery confirmed: advance the delivery baseline for each chain.
                 if (subTracer)
                     this.subscriber.stats.commitDeltas(subPending);
-                if (pubTracer && publisherStats) {
-                    this.publisher?.stats.commitDeltas(pubPending);
+                if (pubTracer && this.publisher) {
+                    this.publisher.stats.commitDeltas(pubPending);
                 }
             }
             catch (err) {
@@ -7997,8 +7925,8 @@ class SfuStatsReporter {
     run = async (telemetry) => {
         if (this.isStopped)
             return;
-        const [subscriberStats, publisherStats] = await this.sample();
-        await this.send(subscriberStats, publisherStats, telemetry);
+        const [subscriberPerfStats, publisherPerfStats] = await this.sample();
+        await this.send(subscriberPerfStats, publisherPerfStats, telemetry);
     };
     scheduleNextReport = () => {
         const intervals = [1500, 3000, 3000, 5000];
@@ -8019,8 +7947,6 @@ class SfuStatsReporter {
     start = () => {
         if (this.options.reporting_interval_ms <= 0)
             return;
-        this.observeDevice(this.microphone, 'mic');
-        this.observeDevice(this.camera, 'camera');
         this.isStopped = false;
         this.reportCount = 0;
         clearInterval(this.intervalId);
@@ -8029,11 +7955,6 @@ class SfuStatsReporter {
     };
     stop = () => {
         this.isStopped = true;
-        this.unsubscribeDevicePermissionsSubscription?.();
-        this.unsubscribeDevicePermissionsSubscription = undefined;
-        this.unsubscribeListDevicesSubscription?.();
-        this.unsubscribeListDevicesSubscription = undefined;
-        this.inputDevices.clear();
         clearInterval(this.intervalId);
         this.intervalId = undefined;
         clearTimeout(this.timeoutId);
@@ -8054,8 +7975,8 @@ class SfuStatsReporter {
             return;
         try {
             const [sample] = await timeboxed([this.sample()], 2000);
-            const [subscriberStats, publisherStats] = sample;
-            this.send(subscriberStats, publisherStats).catch((err) => {
+            const [subscriberPerfStats, publisherPerfStats] = sample;
+            this.send(subscriberPerfStats, publisherPerfStats).catch((err) => {
                 this.logger.warn('Failed to flush report stats', err);
             });
         }
@@ -8182,9 +8103,9 @@ class StatsTracer {
         this.maxPendingDeltas = maxPendingDeltas;
     }
     /**
-     * Samples the RTCPeerConnection: returns the current stats report and the
-     * derived performance stats, and appends the delta-compressed sample to the
-     * un-acked delivery chain (retrieved via `getPendingDeltas`).
+     * Samples the RTCPeerConnection: returns the derived performance stats and
+     * appends the delta-compressed sample to the un-acked delivery chain
+     * (retrieved via `getPendingDeltas`).
      *
      * @internal
      */
@@ -8209,7 +8130,7 @@ class StatsTracer {
             this.pendingDeltas.push({ delta, ts: now });
             this.frameTimeHistory = this.frameTimeHistory.slice(-2);
             this.fpsHistory = this.fpsHistory.slice(-2);
-            return { performanceStats, stats };
+            return performanceStats;
         });
     };
     /**
@@ -8529,10 +8450,12 @@ class BasePeerConnection {
     sfuClient;
     onReconnectionNeeded;
     onIceConnected;
+    onNoLocalCandidates;
     onPeerConnectionStateChange;
     onRemoteTrackUnmute;
     iceRestartDelay;
     iceHasEverConnected = false;
+    localCandidatesGathered = 0;
     iceRestartTimeout;
     preConnectStuckTimeout;
     isIceRestarting = false;
@@ -8546,7 +8469,7 @@ class BasePeerConnection {
     /**
      * Constructs a new `BasePeerConnection` instance.
      */
-    constructor(peerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, onIceConnected, onPeerConnectionStateChange, onRemoteTrackUnmute, tag, enableTracing, clientPublishOptions, e2ee, iceRestartDelay = 2500, statsTimestampDriftThresholdMs = 0, }) {
+    constructor(peerType, { sfuClient, connectionConfig, state, dispatcher, onReconnectionNeeded, onIceConnected, onNoLocalCandidates, onPeerConnectionStateChange, onRemoteTrackUnmute, tag, enableTracing, clientPublishOptions, e2ee, iceRestartDelay = 2500, statsTimestampDriftThresholdMs = 0, }) {
         this.peerType = peerType;
         this.sfuClient = sfuClient;
         this.state = state;
@@ -8557,6 +8480,7 @@ class BasePeerConnection {
         this.tag = tag;
         this.onReconnectionNeeded = onReconnectionNeeded;
         this.onIceConnected = onIceConnected;
+        this.onNoLocalCandidates = onNoLocalCandidates;
         this.onPeerConnectionStateChange = onPeerConnectionStateChange;
         this.onRemoteTrackUnmute = onRemoteTrackUnmute;
         this.logger = videoLoggerSystem.getLogger(peerType === PeerType.SUBSCRIBER ? 'Subscriber' : 'Publisher', { tags: [tag] });
@@ -8597,6 +8521,7 @@ class BasePeerConnection {
         this.preConnectStuckTimeout = undefined;
         this.onReconnectionNeeded = undefined;
         this.onIceConnected = undefined;
+        this.onNoLocalCandidates = undefined;
         this.onPeerConnectionStateChange = undefined;
         this.onRemoteTrackUnmute = undefined;
         this.isDisposed = true;
@@ -8700,6 +8625,17 @@ class BasePeerConnection {
     getTrackType = (trackId) => {
         return this.trackIdToTrackType.get(trackId);
     };
+    /**
+     * Returns `true` once ICE has reached `connected`/`completed` at least
+     * once during the lifetime of this peer connection.
+     */
+    hasIceEverConnected = () => this.iceHasEverConnected;
+    /**
+     * Returns `true` when the latest ICE gathering round completed without
+     * producing a single local candidate.
+     */
+    hasNoLocalCandidates = () => this.pc.iceGatheringState === 'complete' &&
+        this.localCandidatesGathered === 0;
     /**
      * Checks if the `RTCPeerConnection` is healthy.
      * It checks the ICE connection state and the peer connection state.
@@ -8722,6 +8658,8 @@ class BasePeerConnection {
             this.logger.debug('null ice candidate');
             return;
         }
+        if (candidate.candidate)
+            this.localCandidatesGathered++;
         const iceCandidate = toJSON(candidate);
         this.sfuClient
             .iceTrickle({ peerType: this.peerType, iceCandidate })
@@ -8786,6 +8724,17 @@ class BasePeerConnection {
         }
     };
     handleConnectionStateUpdate = (state) => {
+        // Fire `onIceConnected` exactly once per peer-connection lifetime, the
+        // first time ICE reaches `connected`/`completed` end-to-end. Recorded
+        // ahead of the guards below so a connection established while offline,
+        // reconnecting or restarting ICE is not missed. Used by `Call` to reset
+        // the unsupported-network failure counter only after WebRTC has actually
+        // recovered, not merely on SFU join.
+        if ((state === 'connected' || state === 'completed') &&
+            !this.iceHasEverConnected) {
+            this.iceHasEverConnected = true;
+            this.onIceConnected?.(this.peerType);
+        }
         const { callingState } = this.state;
         if (callingState === CallingState.OFFLINE)
             return;
@@ -8849,14 +8798,6 @@ class BasePeerConnection {
                 break;
             case 'connected':
             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');
@@ -8882,7 +8823,17 @@ class BasePeerConnection {
      * Handles the ICE gathering state change event.
      */
     onIceGatherChange = () => {
-        this.logger.debug(`ICE Gathering State`, this.pc.iceGatheringState);
+        const state = this.pc.iceGatheringState;
+        this.logger.debug(`ICE Gathering State`, state);
+        if (state === 'gathering') {
+            this.localCandidatesGathered = 0;
+        }
+        else if (state === 'complete' &&
+            this.localCandidatesGathered === 0 &&
+            !this.iceHasEverConnected) {
+            this.logger.info('ICE gathering completed without local candidates');
+            this.onNoLocalCandidates?.(this.peerType);
+        }
     };
     /**
      * Handles the signaling state change event.
@@ -10758,15 +10709,16 @@ class StreamSfuClient {
 /**
  * Decides what a ringing call should do next, based on the current call state.
  *
- * The `call.accepted`, `call.rejected` and `call.missed` handlers and the ring
- * state poller both run this. They differ only in how the state got there: the
- * handlers rely on `CallState.updateFromEvent`, which runs before them, and the
- * poller applies the polled ring state itself.
+ * The `call.accepted` and `call.rejected` handlers, the ring state poller and
+ * the rewatch after a WS reconnect all run this. They differ only in how the
+ * state got there: the handlers rely on `CallState.updateFromEvent`, which runs
+ * before them, while the poller applies the polled ring state itself and the
+ * rewatch applies the queried call state.
  *
  * @param call the call to reconcile.
- * @param joinSource which of the two triggered this run, reported on the
- * caller's join: `ring-ws` for the event handlers, `ring-poll-api` for the
- * poller.
+ * @param joinSource what triggered this run, reported on the caller's join:
+ * `ring-ws` for the event handlers, `ring-poll-api` for the poller and the
+ * rewatch (both come from an API response).
  * @returns whether the ring reached a terminal state. A failed join is not
  * terminal: the caller should keep trying while the ring is open.
  */
@@ -10821,10 +10773,16 @@ const reconcileAsCaller = async (call, joinSource) => {
     return false;
 };
 // the current user's own accept or reject, on this or another device, is
-// handled by `resolveOwnRingOutcome`, and `call.ended` by `watchCallEnded`.
+// handled by `resolveOwnRingOutcome`, and a live `call.ended` by
+// `watchCallEnded`. An end missed while offline is handled here.
 const reconcileAsCallee = async (call) => {
-    const createdById = call.state.createdBy?.id;
-    const rejectedBy = call.state.session?.rejected_by ?? {};
+    const { session, endedAt, createdBy } = call.state;
+    if (endedAt || session?.ended_at) {
+        call.logger.info('ring: the call has ended, leaving');
+        return leave(call, { reason: 'ended', message: 'ring: call ended' });
+    }
+    const createdById = createdBy?.id;
+    const rejectedBy = session?.rejected_by ?? {};
     if (createdById && rejectedBy[createdById]) {
         call.logger.info('ring: the caller cancelled, leaving');
         return leave(call, {
@@ -10873,7 +10831,7 @@ class RingStatePoller {
     unsubscribe = [];
     constructor(call, options = {}) {
         this.call = call;
-        this.startAfterMs = options.startAfterMs ?? 15_000;
+        this.startAfterMs = options.startAfterMs ?? 9_000;
         this.intervalMs = options.intervalMs ?? 5_000;
     }
     /**
@@ -11538,12 +11496,33 @@ const registerRingingCallEventHandlers = (call) => {
 };
 
 const toBindingKey = (sessionId, trackType = 'audioTrack') => `${sessionId}/${trackType}`;
+const toElementState = (element) => {
+    const stream = element.srcObject;
+    const [track] = stream?.getAudioTracks?.() ?? [];
+    return {
+        paused: element.paused,
+        muted: element.muted,
+        volume: Math.round(element.volume * 100) / 100,
+        readyState: element.readyState,
+        sinkId: element.sinkId,
+        track: track
+            ? {
+                enabled: track.enabled,
+                muted: track.muted,
+                readyState: track.readyState,
+            }
+            : null,
+    };
+};
 /**
  * Tracks audio element bindings and periodically warns about
  * remote participants whose audio streams have no bound element.
+ * On the same tick, it traces the playback state of the bound elements,
+ * limited to the bindings whose state changed since the previous trace.
  */
 class AudioBindingsWatchdog {
     bindings = new Map();
+    tracedStates = new Map();
     enabled = true;
     watchdogInterval;
     unsubscribeCallingState;
@@ -11554,8 +11533,6 @@ class AudioBindingsWatchdog {
         this.tracer = tracer;
         this.state = state;
         this.unsubscribeCallingState = createSubscription(state.callingState$, (callingState) => {
-            if (!this.enabled)
-                return;
             if (callingState !== CallingState.JOINED) {
                 this.stop();
             }
@@ -11584,15 +11561,15 @@ class AudioBindingsWatchdog {
         this.bindings.delete(toBindingKey(sessionId, trackType));
     };
     /**
-     * Enables or disables the watchdog.
-     * When disabled, the periodic check stops but bindings are still tracked.
+     * Enables or disables the dangling binding warnings.
+     * Bindings are still tracked and their playback state is still traced.
      */
     setEnabled = (enabled) => {
         this.enabled = enabled;
         if (enabled) {
             this.start();
         }
-        else {
+        else if (this.state.callingState !== CallingState.JOINED) {
             this.stop();
         }
     };
@@ -11602,33 +11579,61 @@ class AudioBindingsWatchdog {
     dispose = () => {
         this.stop();
         this.bindings.clear();
+        this.tracedStates.clear();
         this.unsubscribeCallingState();
     };
     start = () => {
         clearInterval(this.watchdogInterval);
         this.watchdogInterval = setInterval(() => {
-            const danglingUserIds = [];
-            for (const p of this.state.participants) {
-                if (p.isLocalParticipant)
-                    continue;
-                const { audioStream, screenShareAudioStream, sessionId, userId, publishedTracks, } = p;
-                if (audioStream &&
-                    publishedTracks.includes(TrackType.AUDIO) &&
-                    !this.bindings.has(toBindingKey(sessionId))) {
-                    danglingUserIds.push(userId);
-                }
-                if (screenShareAudioStream &&
-                    publishedTracks.includes(TrackType.SCREEN_SHARE_AUDIO) &&
-                    !this.bindings.has(toBindingKey(sessionId, 'screenShareAudioTrack'))) {
-                    danglingUserIds.push(userId);
-                }
+            if (this.enabled)
+                this.warnAboutDanglingBindings();
+            this.traceBindingStates();
+        }, 3000);
+    };
+    warnAboutDanglingBindings = () => {
+        const danglingUserIds = [];
+        for (const p of this.state.participants) {
+            if (p.isLocalParticipant)
+                continue;
+            const { audioStream, screenShareAudioStream, sessionId, userId, publishedTracks, } = p;
+            if (audioStream &&
+                publishedTracks.includes(TrackType.AUDIO) &&
+                !this.bindings.has(toBindingKey(sessionId))) {
+                danglingUserIds.push(userId);
             }
-            if (danglingUserIds.length > 0) {
-                const key = 'audioBinding.danglingWarning';
-                this.tracer.traceOnce(key, key, danglingUserIds);
-                this.logger.warn(`Dangling audio bindings detected. Did you forget to bind the audio element? user_ids: ${danglingUserIds}.`);
+            if (screenShareAudioStream &&
+                publishedTracks.includes(TrackType.SCREEN_SHARE_AUDIO) &&
+                !this.bindings.has(toBindingKey(sessionId, 'screenShareAudioTrack'))) {
+                danglingUserIds.push(userId);
             }
-        }, 3000);
+        }
+        if (danglingUserIds.length > 0) {
+            const key = 'audioBinding.danglingWarning';
+            this.tracer.traceOnce(key, key, danglingUserIds);
+            this.logger.warn(`Dangling audio bindings detected. Did you forget to bind the audio element? user_ids: ${danglingUserIds}.`);
+        }
+    };
+    traceBindingStates = () => {
+        const changes = {};
+        let hasChanges = false;
+        for (const [key, element] of this.bindings) {
+            const state = toElementState(element);
+            const serialized = JSON.stringify(state);
+            if (this.tracedStates.get(key) === serialized)
+                continue;
+            this.tracedStates.set(key, serialized);
+            changes[key] = state;
+            hasChanges = true;
+        }
+        for (const key of this.tracedStates.keys()) {
+            if (this.bindings.has(key))
+                continue;
+            this.tracedStates.delete(key);
+            changes[key] = null;
+            hasChanges = true;
+        }
+        if (hasChanges)
+            this.tracer.trace('audioBinding.state', changes);
     };
     stop = () => {
         clearInterval(this.watchdogInterval);
@@ -11907,7 +11912,9 @@ class TrackSubscriptionManager {
 class MediaPlaybackWatchdog {
     logger = videoLoggerSystem.getLogger('MediaPlaybackWatchdog');
     kind;
+    traceInfo;
     isBlocked;
+    onGiveUp;
     element;
     tracer;
     controller = new AbortController();
@@ -11919,8 +11926,14 @@ class MediaPlaybackWatchdog {
     constructor(opts) {
         this.element = opts.element;
         this.kind = opts.kind;
+        this.traceInfo = {
+            kind: opts.kind,
+            sessionId: opts.sessionId,
+            trackType: opts.trackType,
+        };
         this.tracer = opts.tracer;
         this.isBlocked = opts.isBlocked ?? (() => false);
+        this.onGiveUp = opts.onGiveUp ?? (() => { });
         this.attach();
     }
     attach = () => {
@@ -11938,6 +11951,23 @@ class MediaPlaybackWatchdog {
         this.controller.abort();
         this.clearTimers();
     };
+    /**
+     * Starts a fresh recovery cycle, e.g. after a media interruption ended.
+     * Unlike a regular pause-triggered recovery, it also tries elements that
+     * were skipped as blocked or not ready, since those conditions may have
+     * cleared together with the interruption.
+     */
+    rearm = () => {
+        if (this.disposed)
+            return;
+        this.clearTimers();
+        this.attempt = 0;
+        this.stopped = false;
+        const { paused, srcObject, ended } = this.element;
+        if (!paused || !srcObject || ended)
+            return;
+        this.pendingTimer = setTimeout(this.attemptPlay, 0);
+    };
     clearTimers = () => {
         if (this.pendingTimer)
             clearTimeout(this.pendingTimer);
@@ -11959,17 +11989,34 @@ class MediaPlaybackWatchdog {
         if (this.element.paused)
             return;
         this.tracer.trace('mediaPlayback.recover.success', {
-            kind: this.kind,
+            ...this.traceInfo,
             attempts: this.attempt,
         });
         this.attempt = 0;
         this.stopped = false;
     };
+    /**
+     * Media elements backed by a MediaStream fire `suspend` routinely (after
+     * the initial load, on source swaps, on layer switches), so a `suspend`
+     * that needs no recovery is ignored without a trace. An explicit `pause`
+     * is rare and always traced, along with the reason recovery was skipped.
+     */
     onPauseOrSuspend = (event) => {
-        if (this.disposed || this.stopped)
+        if (this.disposed || this.stopped || this.pendingTimer)
+            return;
+        const skipReason = this.computeSkipReason();
+        if (skipReason) {
+            if (event.type === 'pause') {
+                this.tracer.trace('mediaPlayback.paused', {
+                    ...this.traceInfo,
+                    reason: event.type,
+                    skipped: skipReason,
+                });
+            }
             return;
+        }
         this.tracer.trace('mediaPlayback.paused', {
-            kind: this.kind,
+            ...this.traceInfo,
             reason: event.type,
         });
         if (this.settleTimer)
@@ -11983,7 +12030,7 @@ class MediaPlaybackWatchdog {
         const skipReason = this.computeSkipReason();
         if (skipReason) {
             this.tracer.trace('mediaPlayback.recover.skipped', {
-                kind: this.kind,
+                ...this.traceInfo,
                 reason: skipReason,
             });
             return;
@@ -11992,9 +12039,10 @@ class MediaPlaybackWatchdog {
             this.stopped = true;
             this.clearTimers();
             this.tracer.trace('mediaPlayback.recover.giveUp', {
-                kind: this.kind,
+                ...this.traceInfo,
                 attempts: this.attempt,
             });
+            this.onGiveUp();
             return;
         }
         const delay = this.attempt === 0 ? 0 : retryInterval(this.attempt);
@@ -12022,7 +12070,7 @@ class MediaPlaybackWatchdog {
             return;
         this.attempt += 1;
         this.tracer.trace('mediaPlayback.recover.attempt', {
-            kind: this.kind,
+            ...this.traceInfo,
             attempt: this.attempt,
         });
         try {
@@ -12037,6 +12085,41 @@ class MediaPlaybackWatchdog {
     };
 }
 
+/**
+ * Checks whether media playback and capture are likely interrupted: the page
+ * is hidden, or WebKit reports the audio session as interrupted (a phone
+ * call, Siri, or another app taking over audio).
+ */
+const isMediaInterrupted = () => {
+    if (typeof document === 'undefined')
+        return false;
+    return (document.visibilityState === 'hidden' ||
+        navigator.audioSession?.state === 'interrupted');
+};
+/**
+ * Invokes `onResumed` every time the page leaves a media interruption,
+ * as defined by {@link isMediaInterrupted}.
+ *
+ * @param onResumed the callback to invoke.
+ * @returns a function that stops watching.
+ */
+const watchMediaInterruptions = (onResumed) => {
+    if (typeof document === 'undefined')
+        return () => { };
+    let interrupted = isMediaInterrupted();
+    const check = () => {
+        const wasInterrupted = interrupted;
+        interrupted = isMediaInterrupted();
+        if (wasInterrupted && !interrupted)
+            onResumed();
+    };
+    const controller = new AbortController();
+    const { signal } = controller;
+    document.addEventListener('visibilitychange', check, { signal });
+    navigator.audioSession?.addEventListener('statechange', check, { signal });
+    return () => controller.abort();
+};
+
 /**
  * A manager class that handles dynascale related tasks like:
  *
@@ -12050,6 +12133,9 @@ class DynascaleManager {
     tracer;
     useWebAudio = false;
     audioContext;
+    playbackWatchdogs = new Set();
+    stopWatchingInterruptions;
+    stopTracingAudioSession;
     trackSubscriptionManager;
     blockedAudioTracker;
     /**
@@ -12066,6 +12152,10 @@ class DynascaleManager {
      * Closes the audio context if it was created.
      */
     dispose = async () => {
+        this.stopWatchingInterruptions?.();
+        this.stopWatchingInterruptions = undefined;
+        this.stopTracingAudioSession?.();
+        this.stopTracingAudioSession = undefined;
         const context = this.audioContext;
         if (context && context.state !== 'closed') {
             document.removeEventListener('click', this.resumeAudioContext);
@@ -12205,10 +12295,12 @@ class DynascaleManager {
         // without prior user interaction:
         // https://developer.mozilla.org/en-US/docs/Web/Media/Autoplay_guide
         videoElement.muted = true;
-        const playbackWatchdog = new MediaPlaybackWatchdog({
+        const playbackWatchdog = this.createPlaybackWatchdog({
             element: videoElement,
             kind: 'video',
             tracer: this.tracer,
+            sessionId,
+            trackType,
         });
         const trackKey = isVideoTrack ? 'videoStream' : 'screenShareStream';
         const streamSubscription = participant$
@@ -12236,7 +12328,7 @@ class DynascaleManager {
             publishedTracksSubscription?.unsubscribe();
             streamSubscription.unsubscribe();
             resizeObserver?.disconnect();
-            playbackWatchdog.dispose();
+            this.disposePlaybackWatchdog(playbackWatchdog);
         };
     };
     /**
@@ -12254,9 +12346,10 @@ class DynascaleManager {
         const participant = this.callState.findParticipantBySessionId(sessionId);
         if (!participant || participant.isLocalParticipant)
             return;
+        this.traceAudioSessionState();
         const participant$ = this.callState.participants$.pipe(map((ps) => ps.find((p) => p.sessionId === sessionId)), takeWhile((p) => !!p), distinctUntilChanged(), shareReplay({ bufferSize: 1, refCount: true }));
         const updateSinkId = (deviceId, audioContext) => {
-            if (!deviceId)
+            if (!deviceId || !this.speaker.state.isDeviceSelectionSupported)
                 return;
             if ('setSinkId' in audioElement) {
                 audioElement.setSinkId(deviceId).catch((e) => {
@@ -12273,7 +12366,9 @@ class DynascaleManager {
         let sourceNode = undefined;
         let gainNode = undefined;
         let audioWatchdog = undefined;
+        let blockedByGiveUp = false;
         const clearBlockedAudio = () => {
+            blockedByGiveUp = false;
             if (!this.blockedAudioTracker.isBlocked(audioElement))
                 return;
             this.blockedAudioTracker.markBlocked(audioElement, false);
@@ -12281,15 +12376,18 @@ class DynascaleManager {
         audioElement.addEventListener('playing', clearBlockedAudio);
         const isAudioTrack = trackType === 'audioTrack';
         const trackKey = isAudioTrack ? 'audioStream' : 'screenShareAudioStream';
+        let sourceChangeTimer;
         const updateMediaStreamSubscription = participant$
             .pipe(distinctUntilKeyChanged(trackKey))
             .subscribe((p) => {
             const source = isAudioTrack ? p.audioStream : p.screenShareAudioStream;
             if (audioElement.srcObject === source)
                 return;
-            setTimeout(() => {
+            clearTimeout(sourceChangeTimer);
+            sourceChangeTimer = setTimeout(() => {
+                sourceChangeTimer = undefined;
                 audioElement.srcObject = source ?? null;
-                audioWatchdog?.dispose();
+                this.disposePlaybackWatchdog(audioWatchdog);
                 audioWatchdog = undefined;
                 if (!source) {
                     clearBlockedAudio();
@@ -12320,15 +12418,25 @@ class DynascaleManager {
                         this.tracer.trace('audioPlaybackError', e.message);
                         if (e.name === 'NotAllowedError') {
                             this.tracer.trace('audioPlaybackBlocked', null);
+                            blockedByGiveUp = false;
                             this.blockedAudioTracker.markBlocked(audioElement, true, sessionId);
                         }
                         this.logger.warn(`Failed to play audio stream`, e);
                     });
-                    audioWatchdog = new MediaPlaybackWatchdog({
+                    audioWatchdog = this.createPlaybackWatchdog({
                         element: audioElement,
                         kind: 'audio',
                         tracer: this.tracer,
-                        isBlocked: () => this.blockedAudioTracker.isBlocked(audioElement),
+                        sessionId,
+                        trackType,
+                        // only an autoplay-policy block needs a user gesture; a give-up
+                        // block is for the UI and must not stop a re-armed cycle
+                        isBlocked: () => !blockedByGiveUp &&
+                            this.blockedAudioTracker.isBlocked(audioElement),
+                        onGiveUp: () => {
+                            blockedByGiveUp = true;
+                            this.blockedAudioTracker.markBlocked(audioElement, true, sessionId);
+                        },
                     });
                 }
                 const { selectedDevice } = this.speaker.state;
@@ -12336,7 +12444,7 @@ class DynascaleManager {
                     updateSinkId(selectedDevice, audioContext);
             });
         });
-        const sinkIdSubscription = !('setSinkId' in audioElement)
+        const sinkIdSubscription = !this.speaker.state.isDeviceSelectionSupported
             ? null
             : this.speaker.state.selectedDevice$.subscribe((deviceId) => {
                 const audioContext = this.getOrCreateAudioContext();
@@ -12358,13 +12466,51 @@ class DynascaleManager {
             sinkIdSubscription?.unsubscribe();
             volumeSubscription.unsubscribe();
             updateMediaStreamSubscription.unsubscribe();
+            clearTimeout(sourceChangeTimer);
             audioElement.srcObject = null;
             sourceNode?.disconnect();
             gainNode?.disconnect();
-            audioWatchdog?.dispose();
+            this.disposePlaybackWatchdog(audioWatchdog);
             audioWatchdog = undefined;
         };
     };
+    /**
+     * Creates a playback watchdog that is re-armed whenever a media
+     * interruption (backgrounding, phone call, Siri) ends.
+     */
+    createPlaybackWatchdog = (opts) => {
+        const watchdog = new MediaPlaybackWatchdog(opts);
+        this.playbackWatchdogs.add(watchdog);
+        this.stopWatchingInterruptions ??= watchMediaInterruptions(this.rearmPlayback);
+        return watchdog;
+    };
+    disposePlaybackWatchdog = (watchdog) => {
+        if (!watchdog)
+            return;
+        watchdog.dispose();
+        this.playbackWatchdogs.delete(watchdog);
+    };
+    rearmPlayback = () => {
+        this.tracer.trace('mediaPlayback.rearm', this.playbackWatchdogs.size);
+        this.playbackWatchdogs.forEach((watchdog) => watchdog.rearm());
+    };
+    /**
+     * Traces the WebKit audio session state (initial value and changes) in
+     * both playback modes, as it explains most iOS playback interruptions.
+     */
+    traceAudioSessionState = () => {
+        const audioSession = navigator.audioSession;
+        if (!audioSession || this.stopTracingAudioSession)
+            return;
+        const trace = () => {
+            this.tracer.trace('audioSession.state', audioSession.state);
+        };
+        trace();
+        audioSession.addEventListener('statechange', trace);
+        this.stopTracingAudioSession = () => {
+            audioSession.removeEventListener('statechange', trace);
+        };
+    };
     getOrCreateAudioContext = () => {
         if (!this.useWebAudio)
             return;
@@ -12387,7 +12533,6 @@ class DynascaleManager {
             audioSession.type = 'play-and-record';
             let isSessionInterrupted = false;
             audioSession.addEventListener('statechange', () => {
-                this.tracer.trace('audioSession.state', audioSession.state);
                 if (audioSession.state === 'interrupted') {
                     isSessionInterrupted = true;
                 }
@@ -12962,10 +13107,17 @@ const getDevices = (permission, kind, tracer) => {
 /**
  * Tells if the browser supports audio output change on 'audio' elements,
  * see https://developer.mozilla.org/en-US/docs/Web/API/HTMLMediaElement/setSinkId.
+ *
+ * WebKit (Safari, iOS browsers, WKWebView) is reported as unsupported:
+ * setSinkId requires a user gesture, a per-device output can run at a
+ * different sample rate than the remote audio mixer (pitched/slowed audio),
+ * and audio goes silent when the selected device disconnects.
  */
 const checkIfAudioOutputChangeSupported = () => {
     if (typeof document === 'undefined')
         return false;
+    if (isWebKit())
+        return false;
     const element = document.createElement('audio');
     return 'setSinkId' in element;
 };
@@ -13471,6 +13623,7 @@ class DeviceManager {
             ? forceStopOrOptions
             : (forceStopOrOptions?.forceStop ?? false);
         this.state.prevStatus = this.state.optimisticStatus;
+        this.state.setError(undefined);
         if (!forceStop && this.state.optimisticStatus === 'disabled') {
             return;
         }
@@ -13480,6 +13633,7 @@ class DeviceManager {
                 const stopTracks = forceStop || this.state.disableMode === 'stop-tracks';
                 await this.muteStream(stopTracks);
                 this.state.setStatus('disabled');
+                this.state.setError(undefined);
             }
             finally {
                 if (!signal.aborted) {
@@ -13775,7 +13929,11 @@ class DeviceManager {
             };
             // the rootStream represents the stream coming from the actual device
             // e.g. camera or microphone stream
+            this.state.setError(undefined);
             rootStreamPromise = this.getSelectedStream(constraints);
+            rootStreamPromise.catch((error) => {
+                this.state.setError(error);
+            });
             // we publish the last MediaStream of the chain
             stream = await this.filters.reduce((parent, entry) => parent
                 .then((inputStream) => {
@@ -13946,9 +14104,22 @@ class DeviceManager {
         }
         const devices = getCurrentValue(this.listDevices()) || [];
         const currentDevice = this.findDevice(devices, selectedDevice) ??
-            createSyntheticDevice(selectedDevice, deviceKind);
+            createSyntheticDevice(selectedDevice, deviceKind, this.getActiveTrackLabel(selectedDevice));
         writePreferences(currentDevice, deviceKey, muted, storageKey);
     }
+    /**
+     * Returns the label of the active track if it was captured from the given
+     * device. Used as a fallback when the device list hasn't been enumerated yet,
+     * so the persisted preference still carries the device label.
+     */
+    getActiveTrackLabel = (deviceId) => {
+        const stream = this.state.rootMediaStream;
+        const tracks = this.trackType === TrackType.AUDIO
+            ? stream?.getAudioTracks()
+            : stream?.getVideoTracks();
+        const track = tracks?.find((t) => t.getSettings().deviceId === deviceId);
+        return track?.label;
+    };
     async applyPersistedPreferences(enabledInCallType, forceDisabled = false) {
         const deviceKey = this.trackType === TrackType.AUDIO ? 'microphone' : 'camera';
         const preferences = readPreferences(this.devicePersistence.storageKey);
@@ -14000,6 +14171,7 @@ class DeviceManagerState {
     rootMediaStreamSubject = new BehaviorSubject(undefined);
     selectedDeviceSubject = new BehaviorSubject(undefined);
     defaultConstraintsSubject = new BehaviorSubject(undefined);
+    errorSubject = new BehaviorSubject(undefined);
     /**
      * @internal
      */
@@ -14034,6 +14206,13 @@ class DeviceManagerState {
      * The default constraints for the device.
      */
     defaultConstraints$ = this.defaultConstraintsSubject.asObservable();
+    /**
+     * An Observable that emits the error of the last failed attempt to start
+     * the device (e.g. the device is in use by another app), or `undefined`.
+     * For screen share, this includes the user dismissing the picker.
+     * Cleared when the device is started again or disabled.
+     */
+    error$ = this.errorSubject.asObservable().pipe(distinctUntilChanged());
     /**
      * An observable that will emit `true` if browser/system permission
      * is granted (or at least hasn't been denied), `false` otherwise.
@@ -14101,6 +14280,19 @@ class DeviceManagerState {
     get rootMediaStream() {
         return getCurrentValue(this.rootMediaStream$);
     }
+    /**
+     * The error of the last failed attempt to start the device, or `undefined`.
+     */
+    get error() {
+        return getCurrentValue(this.error$);
+    }
+    /**
+     * @internal
+     * @param error the error to set.
+     */
+    setError(error) {
+        setCurrentValue(this.errorSubject, error);
+    }
     /**
      * @internal
      * @param status
@@ -14682,9 +14874,11 @@ class MicrophoneManager extends AudioDeviceManager {
             this.call.state.callingState$,
             this.call.state.ownCapabilities$,
             this.state.selectedDevice$,
-            this.state.status$,
             this.state.browserPermissionState$,
-        ]), async ([callingState, ownCapabilities, deviceId, status, permissionState,]) => {
+            // only a trigger: queued handlers can run after the status changed
+            // again, so the live status is read below
+            this.state.status$,
+        ]), async ([callingState, ownCapabilities, deviceId, permissionState]) => {
             try {
                 if (callingState === CallingState.LEFT) {
                     // The muted-recording-prepared mode is reset in `callManager.stop()`
@@ -14699,7 +14893,7 @@ class MicrophoneManager extends AudioDeviceManager {
                     return;
                 if (ownCapabilities.includes(OwnCapability.SEND_AUDIO)) {
                     const hasPermission = await this.hasPermission(permissionState);
-                    if (hasPermission && status !== 'enabled') {
+                    if (hasPermission && this.state.status !== 'enabled') {
                         this.setMutedRecordingPrepared(true);
                         await this.startSpeakingWhileMutedDetection(deviceId);
                     }
@@ -14999,6 +15193,52 @@ class MicrophoneManager extends AudioDeviceManager {
         await this.call.ensureMediaFactory();
         return getAudioStream(constraints, this.call.tracer);
     }
+    /**
+     * On mute, hands a clone of the live mic track to the speaking while muted
+     * detection, so the device stays captured after the mic tracks are stopped.
+     * Releasing and re-acquiring the mic flips Bluetooth headsets between audio
+     * profiles.
+     */
+    async muteStream(stopTracks = true) {
+        const [track] = this.state.rootMediaStream?.getAudioTracks() ?? [];
+        const clone = track?.readyState === 'live' &&
+            this.state.optimisticStatus === 'disabled' &&
+            this.canHandOffMic()
+            ? track.clone()
+            : undefined;
+        try {
+            await super.muteStream(stopTracks);
+        }
+        catch (err) {
+            clone?.stop();
+            throw err;
+        }
+        if (!clone)
+            return;
+        // the mic, the call, or the selected device may have changed while
+        // unpublishing
+        const deviceId = resolveDeviceId(clone.getSettings().deviceId, 'audioinput');
+        if (clone.readyState !== 'live' ||
+            !this.canHandOffMic() ||
+            deviceId !== this.state.selectedDevice) {
+            clone.stop();
+            return;
+        }
+        this.startSpeakingWhileMutedDetection(deviceId, clone).catch((err) => {
+            clone.stop();
+            this.logger.warn('Could not hand off mic to speaking while muted', err);
+        });
+    }
+    /**
+     * Whether a mute can hand the mic over to the speaking while muted detection.
+     */
+    canHandOffMic = () => {
+        const { callingState, ownCapabilities } = this.call.state;
+        return (!isReactNative() &&
+            this.speakingWhileMutedNotificationEnabled &&
+            callingState === CallingState.JOINED &&
+            ownCapabilities.includes(OwnCapability.SEND_AUDIO));
+    };
     doSetAudioBitrateProfile(profile) {
         this.setDefaultConstraints({
             ...this.state.defaultConstraints,
@@ -15018,10 +15258,13 @@ class MicrophoneManager extends AudioDeviceManager {
             }
         }
     }
-    async startSpeakingWhileMutedDetection(deviceId) {
+    async startSpeakingWhileMutedDetection(deviceId, track) {
         await withoutConcurrency(this.soundDetectorConcurrencyTag, async () => {
-            if (this.soundDetectorCleanup && this.soundDetectorDeviceId === deviceId)
+            if (this.soundDetectorCleanup &&
+                this.soundDetectorDeviceId === deviceId) {
+                track?.stop();
                 return;
+            }
             await this.teardownSpeakingWhileMutedDetection();
             if (isReactNative()) {
                 const speechActivity = globalThis.streamRNVideoSDK?.nativeEvents?.speechActivity;
@@ -15037,11 +15280,14 @@ class MicrophoneManager extends AudioDeviceManager {
                 };
             }
             else {
-                // Need to start a new stream that's not connected to publisher
-                const stream = await this.getStream({
-                    ...this.state.defaultConstraints,
-                    deviceId: { exact: deviceId },
-                });
+                // Use the handed-off mic track, or start a new stream that's not
+                // connected to publisher
+                const stream = track
+                    ? new MediaStream([track])
+                    : await this.getStream({
+                        ...this.state.defaultConstraints,
+                        deviceId: { exact: deviceId },
+                    });
                 this.soundDetectorCleanup = createSoundDetector(stream, (event) => {
                     this.state.setSpeakingWhileMuted(event.isSoundDetected);
                 });
@@ -15321,7 +15567,7 @@ class SpeakerManager {
     }
     async applyWeb() {
         const { enabled, storageKey } = this.devicePersistence;
-        if (!enabled)
+        if (!enabled || !this.state.isDeviceSelectionSupported)
             return;
         const preferences = readPreferences(storageKey);
         const preferenceList = toPreferenceList(preferences.speaker);
@@ -15597,6 +15843,14 @@ class Call {
     networkAvailableTask;
     // (10 attempts per rolling 120 s window).
     rejoinRateLimiter = new SlidingWindowRateLimiter(10, 120000);
+    // Backstop for slow REJOIN loops that stay under the short window
+    // (20 attempts per rolling 30 min window). Dropped once the integrator
+    // takes over the budget through `setRejoinAttemptLimit`.
+    rejoinLongWindowRateLimiter = new SlidingWindowRateLimiter(20, 30 * 60 * 1000);
+    // In-flight `doJoin` runs, awaited before acting on peer connections that
+    // gathered no local ICE candidates.
+    joinTasks = new Set();
+    noLocalCandidatesCheckScheduled = false;
     // "Network doesn't support WebRTC" detector: counts peer-connection
     // failures where ICE never reached `connected`/`completed`.
     maxIceFailuresWithoutConnect = 2;
@@ -15990,6 +16244,7 @@ class Call {
             // `joinFlow` never runs, leaving stale values that would make the next
             // fresh `join()` send a stale `ReconnectDetails` to the SFU.
             this.rejoinRateLimiter.reset();
+            this.rejoinLongWindowRateLimiter?.reset();
             this.iceFailuresWithoutConnect = 0;
             this.consecutiveNegotiationFailures = 0;
             this.reconnectStrategy = WebsocketReconnectStrategy.UNSPECIFIED;
@@ -16385,6 +16640,16 @@ class Call {
      * @returns a promise which resolves once the call join-flow has finished.
      */
     doJoin = async (data) => {
+        const task = this.performJoin(data);
+        this.joinTasks.add(task);
+        try {
+            await task;
+        }
+        finally {
+            this.joinTasks.delete(task);
+        }
+    };
+    performJoin = async (data) => {
         const connectStartTime = Date.now();
         const callingState = this.state.callingState;
         const joinLeaveGeneration = this.leaveGeneration;
@@ -16742,6 +17007,9 @@ class Call {
                 // "ICE never connected" failure budget can be cleared.
                 this.iceFailuresWithoutConnect = 0;
             },
+            onNoLocalCandidates: () => {
+                this.checkNoLocalCandidates();
+            },
             onPeerConnectionStateChange: (event) => {
                 this.clientEventReporter.onPeerConnectionStateChange(this.cid, event);
             },
@@ -16784,15 +17052,65 @@ class Call {
                 options: statsOptions,
                 subscriber: this.subscriber,
                 publisher: this.publisher,
-                microphone: this.microphone,
-                camera: this.camera,
-                state: this.state,
                 tracer: this.tracer,
                 unifiedSessionId,
             });
             this.sfuStatsReporter.start();
         }
     };
+    /**
+     * Escalates to REJOIN with `ICE_NEVER_CONNECTED` when the current peer
+     * connections never connected and one of them completed ICE gathering
+     * without a single local candidate, which means WebRTC networking is
+     * blocked on this device.
+     *
+     * `reconnect` ignores requests while a join or another reconnect is in
+     * flight, so the check is postponed until those settle and then re-run
+     * against the peer connections current at that time.
+     */
+    checkNoLocalCandidates = () => {
+        if (this.noLocalCandidatesCheckScheduled)
+            return;
+        if (this.joinTasks.size > 0 || hasPending(this.reconnectConcurrencyTag)) {
+            this.noLocalCandidatesCheckScheduled = true;
+            const leaveGeneration = this.leaveGeneration;
+            this.waitForJoinsAndReconnects()
+                .then(() => {
+                this.noLocalCandidatesCheckScheduled = false;
+                if (this.leaveGeneration !== leaveGeneration)
+                    return;
+                this.checkNoLocalCandidates();
+            })
+                .catch((err) => {
+                this.noLocalCandidatesCheckScheduled = false;
+                this.logger.warn('[Reconnect] No-candidates check failed', err);
+            });
+            return;
+        }
+        if (this.state.callingState !== CallingState.JOINED)
+            return;
+        // without network, gathering legitimately yields no candidates
+        if (typeof navigator !== 'undefined' && navigator.onLine === false)
+            return;
+        const peerConnections = [this.publisher, this.subscriber];
+        if (peerConnections.some((pc) => pc?.hasIceEverConnected()))
+            return;
+        if (!peerConnections.some((pc) => pc?.hasNoLocalCandidates()))
+            return;
+        this.reconnect(WebsocketReconnectStrategy.REJOIN, ReconnectReason.ICE_NEVER_CONNECTED).catch((err) => {
+            this.logger.warn('[Reconnect] Error reconnecting', err);
+        });
+    };
+    /**
+     * Resolves once no `doJoin` run and no reconnect is in flight.
+     */
+    waitForJoinsAndReconnects = async () => {
+        while (this.joinTasks.size > 0 ||
+            hasPending(this.reconnectConcurrencyTag)) {
+            await Promise.allSettled(this.joinTasks);
+            await settled(this.reconnectConcurrencyTag);
+        }
+    };
     /**
      * Retrieves credentials for joining the call.
      *
@@ -16991,6 +17309,14 @@ class Call {
                         return;
                     }
                 }
+                // MIGRATE is server-driven (e.g. SFU drains), so it doesn't count
+                // toward the long-window backstop.
+                if (this.reconnectStrategy === WebsocketReconnectStrategy.REJOIN &&
+                    this.rejoinLongWindowRateLimiter &&
+                    !this.rejoinLongWindowRateLimiter.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++;
@@ -17209,7 +17535,13 @@ class Call {
             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) => {
+        // Only the active SFU client may drive a reconnect: a superseded one can
+        // still report errors about its own (replaced) session, and none may
+        // while `leave()` tears the call down.
+        const activeSfuTag = () => this.sfuClient?.tag ?? '*';
+        const unregisterOnError = this.dispatcher.on('error', activeSfuTag, (e) => {
+            if (!this.sfuClient)
+                return;
             const { reconnectStrategy: strategy, error } = e;
             if (!SfuJoinError.isJoinErrorCode(e)) {
                 const code = error?.code ? ErrorCode[error.code] : undefined;
@@ -17232,7 +17564,16 @@ class Call {
                 });
             }
             else {
-                this.reconnect(strategy, error?.message || ReconnectReason.SFU_ERROR).catch((err) => {
+                // A media transport failure on a session whose peer connections
+                // never connected is an "ICE never connected" failure, and must
+                // count toward the unsupported-network budget.
+                const neverConnected = error?.code === ErrorCode.PARTICIPANT_MEDIA_TRANSPORT_FAILURE &&
+                    !this.publisher?.hasIceEverConnected() &&
+                    !this.subscriber?.hasIceEverConnected();
+                const reason = neverConnected
+                    ? ReconnectReason.ICE_NEVER_CONNECTED
+                    : error?.message || ReconnectReason.SFU_ERROR;
+                this.reconnect(strategy, reason).catch((err) => {
                     this.logger.warn('[Reconnect] Error reconnecting', err);
                 });
             }
@@ -18296,9 +18637,11 @@ class Call {
      * `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.
+     * Both arguments are clamped to a minimum of 1. Unless this method is
+     * called, an additional cap of 20 REJOIN attempts per 30 minutes applies.
      */
     setRejoinAttemptLimit = (maxAttempts, windowSeconds) => {
+        this.rejoinLongWindowRateLimiter = undefined;
         this.rejoinRateLimiter.setLimits(Math.max(1, maxAttempts), Math.max(1, windowSeconds) * 1000);
     };
     /**
@@ -19638,11 +19981,11 @@ class StreamClient {
         return await this.wsConnection.connect(this.defaultWSTimeout);
     };
     getSdkVersion = () => this.options.clientAppIdentifier?.sdkVersion ||
-        "1.61.1";
+        "1.62.0";
     getUserAgent = () => {
         if (!this.cachedUserAgent) {
             const { clientAppIdentifier = {} } = this.options;
-            const { sdkName = 'js', sdkVersion = "1.61.1", ...extras } = clientAppIdentifier;
+            const { sdkName = 'js', sdkVersion = "1.62.0", ...extras } = clientAppIdentifier;
             this.cachedUserAgent = [
                 `stream-video-${sdkName}-v${sdkVersion}`,
                 ...Object.entries(extras).map(([key, value]) => `${key}=${value}`),
@@ -20582,6 +20925,10 @@ class StreamVideoClient {
                     const call = this.writeableStateStore.findCall(c.call.type, c.call.id);
                     if (call) {
                         call.updateFromCallStateResponse(c);
+                        // ring events missed while the WS was down aren't replayed
+                        reconcileRingState(call, 'ring-poll-api').catch((err) => {
+                            call.logger.error('Failed to reconcile the ring state after rewatch', err);
+                        });
                     }
                 }
                 return;