@signalwire/js 4.0.0-dev-20260910191529 → 4.0.0-dev-20260911135809

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_operators = require('./operators-Bn4Ij3VB.cjs');
+const require_operators = require('./operators-B3G5z2B1.cjs');
 let jwt_decode = require("jwt-decode");
 let rxjs = require("rxjs");
 let uuid = require("uuid");
@@ -131,7 +131,7 @@ const asyncRetry = async ({ asyncCallable, maxRetries: retries = DEFAULT_MAX_RET
 
 //#endregion
 //#region src/controllers/HTTPRequestController.ts
-const logger$31 = require_operators.getLogger();
+const logger$32 = require_operators.getLogger();
 const GET_PARAMS = {
 	method: "GET",
 	headers: { Accept: "application/json" }
@@ -195,7 +195,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 			this._responses$.next(response);
 			return response;
 		} catch (error) {
-			logger$31.error("[HTTPRequestController] Request error:", error);
+			logger$32.error("[HTTPRequestController] Request error:", error);
 			this._status$.next("error");
 			const err = error instanceof Error ? error : new Error("HTTP request failed", { cause: error });
 			this._errors$.next(err);
@@ -222,7 +222,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 		const url = this.buildURL(request.url);
 		const headers = this.buildHeaders(request.headers);
 		const timeout$4 = request.timeout ?? this.requestTimeout;
-		logger$31.debug("[HTTPRequestController] Executing request:", {
+		logger$32.debug("[HTTPRequestController] Executing request:", {
 			method: request.method,
 			url,
 			headers: Object.keys(headers).reduce((acc, key) => {
@@ -242,7 +242,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 			});
 			clearTimeout(timeoutId);
 			const httpResponse = await this.convertResponse(response);
-			logger$31.debug("[HTTPRequestController] Response received:", {
+			logger$32.debug("[HTTPRequestController] Response received:", {
 				status: response.status,
 				statusText: response.statusText,
 				headers: [...response.headers.entries()],
@@ -252,7 +252,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 		} catch (error) {
 			clearTimeout(timeoutId);
 			if (error instanceof Error && error.name === "AbortError") throw new require_operators.RequestTimeoutError(`Request timeout after ${timeout$4}ms`, { cause: error });
-			logger$31.error("[HTTPRequestController] Request failed:", error);
+			logger$32.error("[HTTPRequestController] Request failed:", error);
 			throw error;
 		}
 	}
@@ -266,8 +266,8 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 		const credential = this.getCredential();
 		if (credential.token) {
 			headers.Authorization = `Bearer ${credential.token}`;
-			logger$31.debug("[HTTPRequestController] Using Bearer token auth, token length:", credential.token.length);
-		} else logger$31.warn("[HTTPRequestController] No credentials available for authentication");
+			logger$32.debug("[HTTPRequestController] Using Bearer token auth, token length:", credential.token.length);
+		} else logger$32.warn("[HTTPRequestController] No credentials available for authentication");
 		return headers;
 	}
 	/**
@@ -415,7 +415,7 @@ function fromMsToSec(milliseconds) {
 
 //#endregion
 //#region src/containers/PreferencesContainer.ts
-const logger$30 = require_operators.getLogger();
+const logger$31 = require_operators.getLogger();
 var PreferencesContainer = class PreferencesContainer {
 	static get instance() {
 		this._instance ??= new PreferencesContainer();
@@ -1077,7 +1077,7 @@ var ClientPreferences = class {
 		if (!this._storage) return;
 		const data = collectStoredPreferences();
 		this._storage.setItem(require_operators.PREFERENCES_STORAGE_KEY, data, "local").catch((error) => {
-			logger$30.error(`[ClientPreferences] Failed to save preferences: ${String(error)}`);
+			logger$31.error(`[ClientPreferences] Failed to save preferences: ${String(error)}`);
 		});
 	}
 	/** Loads preferences from storage and applies them to the container. */
@@ -1086,7 +1086,7 @@ var ClientPreferences = class {
 		this._storage.getItem(require_operators.PREFERENCES_STORAGE_KEY, "local").then((stored) => {
 			if (stored) applyStoredPreferences(stored);
 		}).catch((error) => {
-			logger$30.error(`[ClientPreferences] Failed to load preferences: ${String(error)}`);
+			logger$31.error(`[ClientPreferences] Failed to load preferences: ${String(error)}`);
 		});
 	}
 };
@@ -1107,7 +1107,7 @@ function toError(value) {
 
 //#endregion
 //#region src/controllers/NavigatorDeviceController.ts
-const logger$29 = require_operators.getLogger();
+const logger$30 = require_operators.getLogger();
 /** Maps a device kind to its storage key. */
 const DEVICE_STORAGE_KEYS = {
 	audioinput: require_operators.DEVICE_STORAGE_KEY_AUDIO_INPUT,
@@ -1129,7 +1129,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		super();
 		this.webRTCApiProvider = webRTCApiProvider;
 		this.deviceChangeHandler = () => {
-			logger$29.debug("[DeviceController] Device change detected");
+			logger$30.debug("[DeviceController] Device change detected");
 			this.enumerateDevices();
 		};
 		this._devicesState$ = this.createBehaviorSubject(initialDevicesState);
@@ -1194,13 +1194,13 @@ var NavigatorDeviceController = class extends Destroyable {
 		return this.cachedObservable("videoInputDevices$", () => this._devicesState$.pipe((0, rxjs.map)((state) => state.videoinput), (0, rxjs.distinctUntilChanged)(), (0, rxjs.takeUntil)(this.destroyed$)));
 	}
 	get selectedAudioInputDevice$() {
-		return this.cachedObservable("selectedAudioInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, rxjs.map)((state) => state.audioinput), (0, rxjs.distinctUntilChanged)(), (0, rxjs.takeUntil)(this.destroyed$), (0, rxjs.tap)((info) => logger$29.debug("[DeviceController] Selected audio input device changed:", info))));
+		return this.cachedObservable("selectedAudioInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, rxjs.map)((state) => state.audioinput), (0, rxjs.distinctUntilChanged)(), (0, rxjs.takeUntil)(this.destroyed$), (0, rxjs.tap)((info) => logger$30.debug("[DeviceController] Selected audio input device changed:", info))));
 	}
 	get selectedAudioOutputDevice$() {
-		return this.cachedObservable("selectedAudioOutputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, rxjs.map)((state) => state.audiooutput), (0, rxjs.distinctUntilChanged)(), (0, rxjs.takeUntil)(this.destroyed$), (0, rxjs.tap)((info) => logger$29.debug("[DeviceController] Selected audio output device changed:", info))));
+		return this.cachedObservable("selectedAudioOutputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, rxjs.map)((state) => state.audiooutput), (0, rxjs.distinctUntilChanged)(), (0, rxjs.takeUntil)(this.destroyed$), (0, rxjs.tap)((info) => logger$30.debug("[DeviceController] Selected audio output device changed:", info))));
 	}
 	get selectedVideoInputDevice$() {
-		return this.cachedObservable("selectedVideoInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, rxjs.map)((state) => state.videoinput), (0, rxjs.distinctUntilChanged)(), (0, rxjs.takeUntil)(this.destroyed$), (0, rxjs.tap)((info) => logger$29.debug("[DeviceController] Selected video input device changed:", info))));
+		return this.cachedObservable("selectedVideoInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, rxjs.map)((state) => state.videoinput), (0, rxjs.distinctUntilChanged)(), (0, rxjs.takeUntil)(this.destroyed$), (0, rxjs.tap)((info) => logger$30.debug("[DeviceController] Selected video input device changed:", info))));
 	}
 	get selectedAudioInputDevice() {
 		if (this._audioInputDisabled$.value) return null;
@@ -1275,7 +1275,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		if (device) this.persistDeviceSelection("audioinput", device);
 	}
 	selectVideoInputDevice(device) {
-		logger$29.debug("[DeviceController] Setting selected video input device:", device);
+		logger$30.debug("[DeviceController] Setting selected video input device:", device);
 		if (this._videoInputDisabled$.value && device) this._videoInputDisabled$.next(false);
 		const previous = this._selectedDevicesState$.value.videoinput;
 		if (previous && previous.deviceId !== device?.deviceId) this._deviceHistory.push("videoinput", previous);
@@ -1332,7 +1332,7 @@ var NavigatorDeviceController = class extends Destroyable {
 			}
 			const fromHistory = this._deviceHistory.findInHistory(kind, devices);
 			if (fromHistory) {
-				logger$29.debug(`[DeviceController] Device disappeared, falling back to history: ${fromHistory.label}`);
+				logger$30.debug(`[DeviceController] Device disappeared, falling back to history: ${fromHistory.label}`);
 				this.emitDeviceRecovered(kind, selected, fromHistory, "device_disconnected");
 				return fromHistory;
 			}
@@ -1385,7 +1385,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		try {
 			await this._storageManager.setItem(DEVICE_STORAGE_KEYS[kind], stored, "local");
 		} catch (error) {
-			logger$29.error(`[DeviceController] Failed to persist device selection for ${kind}:`, error);
+			logger$30.error(`[DeviceController] Failed to persist device selection for ${kind}:`, error);
 		}
 	}
 	async loadPersistedDevices() {
@@ -1401,7 +1401,7 @@ var NavigatorDeviceController = class extends Destroyable {
 				[kind]: stored
 			};
 		} catch (error) {
-			logger$29.error(`[DeviceController] Failed to load persisted device for ${kind}:`, error);
+			logger$30.error(`[DeviceController] Failed to load persisted device for ${kind}:`, error);
 		}
 	}
 	/** Clears device history, persisted selections, and re-enumerates devices. */
@@ -1419,7 +1419,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		this.disableDeviceMonitoring();
 		this.webRTCApiProvider.mediaDevices.addEventListener("devicechange", this.deviceChangeHandler);
 		if (PreferencesContainer.instance.devicePollingInterval > 0) this._devicesPoolingSubscription = (0, rxjs.interval)(PreferencesContainer.instance.devicePollingInterval).subscribe(() => {
-			logger$29.debug("[DeviceController] Polling devices due to interval");
+			logger$30.debug("[DeviceController] Polling devices due to interval");
 			this.enumerateDevices();
 		});
 		this.enumerateDevices();
@@ -1445,13 +1445,13 @@ var NavigatorDeviceController = class extends Destroyable {
 				videoinput: []
 			});
 			this._devicesState$.next(devicesByKind);
-			logger$29.debug("[DeviceController] Devices enumerated:", {
+			logger$30.debug("[DeviceController] Devices enumerated:", {
 				audioInputs: devicesByKind.audioinput.length,
 				audioOutputs: devicesByKind.audiooutput.length,
 				videoInputs: devicesByKind.videoinput.length
 			});
 		} catch (error) {
-			logger$29.error("[DeviceController] Failed to enumerate devices:", error);
+			logger$30.error("[DeviceController] Failed to enumerate devices:", error);
 			this._errors$.next(toError(error));
 		}
 	}
@@ -1467,7 +1467,7 @@ var NavigatorDeviceController = class extends Destroyable {
 			stream.getTracks().forEach((t) => t.stop());
 			return capabilities;
 		} catch (error) {
-			logger$29.error("[DeviceController] Failed to get device capabilities:", error);
+			logger$30.error("[DeviceController] Failed to get device capabilities:", error);
 			this._errors$.next(toError(error));
 			throw error;
 		}
@@ -1718,7 +1718,7 @@ var DependencyContainer = class {
 
 //#endregion
 //#region src/controllers/CryptoController.ts
-const logger$28 = require_operators.getLogger();
+const logger$29 = require_operators.getLogger();
 const DPOP_DB_NAME = "sw-dpop";
 const DPOP_DB_VERSION = 1;
 const DPOP_STORE_NAME = "keys";
@@ -1777,7 +1777,7 @@ async function loadKeyPairFromDB() {
 			tx.oncomplete = () => db.close();
 		});
 	} catch (error) {
-		logger$28.warn("[DPoP] Failed to load key pair from IndexedDB:", error);
+		logger$29.warn("[DPoP] Failed to load key pair from IndexedDB:", error);
 		return null;
 	}
 }
@@ -1797,7 +1797,7 @@ async function saveKeyPairToDB(keyPair) {
 			};
 		});
 	} catch (error) {
-		logger$28.warn("[DPoP] Failed to save key pair to IndexedDB:", error);
+		logger$29.warn("[DPoP] Failed to save key pair to IndexedDB:", error);
 	}
 }
 async function deleteKeyPairFromDB() {
@@ -1816,7 +1816,7 @@ async function deleteKeyPairFromDB() {
 			};
 		});
 	} catch (error) {
-		logger$28.warn("[DPoP] Failed to delete key pair from IndexedDB:", error);
+		logger$29.warn("[DPoP] Failed to delete key pair from IndexedDB:", error);
 	}
 }
 /**
@@ -1876,13 +1876,13 @@ var CryptoController = class {
 			this._publicJwk = await crypto.subtle.exportKey("jwk", stored.publicKey);
 			this._fingerprint = await computeJwkThumbprint(this._publicJwk);
 			this._initialized = true;
-			logger$28.debug("[DPoP] Key pair restored from IndexedDB, fingerprint:", this._fingerprint);
+			logger$29.debug("[DPoP] Key pair restored from IndexedDB, fingerprint:", this._fingerprint);
 			return this._fingerprint;
 		} catch (error) {
-			logger$28.warn("[DPoP] Stored key pair unusable, generating new one:", error);
+			logger$29.warn("[DPoP] Stored key pair unusable, generating new one:", error);
 			await deleteKeyPairFromDB();
 		}
-		logger$28.debug("[DPoP] Generating RSA key pair");
+		logger$29.debug("[DPoP] Generating RSA key pair");
 		this._keyPair = await crypto.subtle.generateKey({
 			name: "RSASSA-PKCS1-v1_5",
 			modulusLength: 2048,
@@ -1897,7 +1897,7 @@ var CryptoController = class {
 		this._fingerprint = await computeJwkThumbprint(this._publicJwk);
 		this._initialized = true;
 		await saveKeyPairToDB(this._keyPair);
-		logger$28.debug("[DPoP] Key pair generated and persisted, fingerprint:", this._fingerprint);
+		logger$29.debug("[DPoP] Key pair generated and persisted, fingerprint:", this._fingerprint);
 		return this._fingerprint;
 	}
 	/**
@@ -1963,7 +1963,7 @@ var CryptoController = class {
 		this._fingerprint = null;
 		this._initialized = false;
 		deleteKeyPairFromDB();
-		logger$28.debug("[DPoP] Controller destroyed");
+		logger$29.debug("[DPoP] Controller destroyed");
 	}
 	get publicJwk() {
 		if (!this._publicJwk) throw new require_operators.DPoPInitError("CryptoController not initialized. Call init() first.");
@@ -1986,7 +1986,7 @@ var CryptoController = class {
 
 //#endregion
 //#region src/controllers/NetworkMonitor.ts
-const logger$27 = require_operators.getLogger();
+const logger$28 = require_operators.getLogger();
 /**
 * Safely check whether we are running in a browser environment
 * with `window` and the relevant event targets.
@@ -2043,7 +2043,7 @@ var NetworkMonitor = class extends Destroyable {
 	}
 	attachListeners() {
 		if (!hasBrowserNetworkEvents()) {
-			logger$27.debug("NetworkMonitor: no browser environment detected, skipping event listeners");
+			logger$28.debug("NetworkMonitor: no browser environment detected, skipping event listeners");
 			return;
 		}
 		window.addEventListener("online", this._onOnline);
@@ -2051,7 +2051,7 @@ var NetworkMonitor = class extends Destroyable {
 		const connection = getNetworkConnection();
 		if (connection) connection.addEventListener("change", this._onConnectionChange);
 		this._listenersAttached = true;
-		logger$27.debug("NetworkMonitor: event listeners attached");
+		logger$28.debug("NetworkMonitor: event listeners attached");
 	}
 	removeListeners() {
 		if (!this._listenersAttached) return;
@@ -2062,10 +2062,10 @@ var NetworkMonitor = class extends Destroyable {
 			if (connection) connection.removeEventListener("change", this._onConnectionChange);
 		}
 		this._listenersAttached = false;
-		logger$27.debug("NetworkMonitor: event listeners removed");
+		logger$28.debug("NetworkMonitor: event listeners removed");
 	}
 	handleOnline() {
-		logger$27.info("NetworkMonitor: browser went online");
+		logger$28.info("NetworkMonitor: browser went online");
 		this._isOnline$.next(true);
 		this._networkChange$.next({
 			type: "online",
@@ -2074,7 +2074,7 @@ var NetworkMonitor = class extends Destroyable {
 		});
 	}
 	handleOffline() {
-		logger$27.info("NetworkMonitor: browser went offline");
+		logger$28.info("NetworkMonitor: browser went offline");
 		this._isOnline$.next(false);
 		this._networkChange$.next({
 			type: "offline",
@@ -2083,7 +2083,7 @@ var NetworkMonitor = class extends Destroyable {
 	}
 	handleConnectionChange() {
 		const networkType = getNetworkType();
-		logger$27.info(`NetworkMonitor: connection changed — effectiveType=${networkType ?? "unknown"}`);
+		logger$28.info(`NetworkMonitor: connection changed — effectiveType=${networkType ?? "unknown"}`);
 		this._networkChange$.next({
 			type: "connection_change",
 			timestamp: Date.now(),
@@ -2198,7 +2198,7 @@ function getNavigatorMediaDevices() {
 
 //#endregion
 //#region src/controllers/PreflightRunner.ts
-const logger$26 = require_operators.getLogger();
+const logger$27 = require_operators.getLogger();
 const DEFAULT_MEDIA_TEST_DURATION_S = 10;
 const ICE_GATHERING_TIMEOUT_MS = 1e4;
 const SIGNALING_RTT_TIMEOUT_MS = 5e3;
@@ -2247,7 +2247,7 @@ var PreflightRunner = class extends Destroyable {
 			if (!this._options.skipMediaTest) try {
 				bandwidth = await this.testMediaBandwidth(destination);
 			} catch (error) {
-				logger$26.warn("[PreflightRunner] Media bandwidth test failed:", error);
+				logger$27.warn("[PreflightRunner] Media bandwidth test failed:", error);
 				warnings.push("Media bandwidth test failed");
 			}
 			return {
@@ -2259,7 +2259,7 @@ var PreflightRunner = class extends Destroyable {
 				warnings
 			};
 		} catch (error) {
-			logger$26.error("[PreflightRunner] Preflight test failed:", error);
+			logger$27.error("[PreflightRunner] Preflight test failed:", error);
 			throw new require_operators.PreflightError("preflight", error instanceof Error ? error : new Error(String(error)));
 		} finally {
 			this.destroy();
@@ -2290,7 +2290,7 @@ var PreflightRunner = class extends Destroyable {
 				if (track.kind === "video" && track.readyState === "live") videoWorking = true;
 			}
 		} catch (error) {
-			logger$26.warn("[PreflightRunner] Device test failed:", error);
+			logger$27.warn("[PreflightRunner] Device test failed:", error);
 		} finally {
 			if (audioStream) audioStream.getTracks().forEach((t) => t.stop());
 		}
@@ -2348,7 +2348,7 @@ var PreflightRunner = class extends Destroyable {
 				rttMs
 			};
 		} catch (error) {
-			logger$26.warn("[PreflightRunner] ICE connectivity test failed:", error);
+			logger$27.warn("[PreflightRunner] ICE connectivity test failed:", error);
 			return {
 				type: "failed",
 				turnReachable: false,
@@ -2395,7 +2395,7 @@ var PreflightRunner = class extends Destroyable {
 
 //#endregion
 //#region src/controllers/VisibilityController.ts
-const logger$25 = require_operators.getLogger();
+const logger$26 = require_operators.getLogger();
 /**
 * Checks whether the document visibility API is available.
 */
@@ -2432,8 +2432,8 @@ var VisibilityController = class extends Destroyable {
 		this._boundHandler = this._handleVisibilityChange.bind(this);
 		if (this._hasVisibilityApi) {
 			document.addEventListener("visibilitychange", this._boundHandler);
-			logger$25.debug("VisibilityController: listening for visibilitychange events");
-		} else logger$25.debug("VisibilityController: document visibility API not available, defaulting to visible");
+			logger$26.debug("VisibilityController: listening for visibilitychange events");
+		} else logger$26.debug("VisibilityController: document visibility API not available, defaulting to visible");
 	}
 	/**
 	* Observable of the current visibility state.
@@ -2458,7 +2458,7 @@ var VisibilityController = class extends Destroyable {
 	destroy() {
 		if (this._hasVisibilityApi) {
 			document.removeEventListener("visibilitychange", this._boundHandler);
-			logger$25.debug("VisibilityController: removed visibilitychange listener");
+			logger$26.debug("VisibilityController: removed visibilitychange listener");
 		}
 		super.destroy();
 	}
@@ -2476,7 +2476,7 @@ var VisibilityController = class extends Destroyable {
 			timestamp: Date.now()
 		};
 		this._visibilityChange$.next(changeEvent);
-		logger$25.debug("VisibilityController: visibility changed", {
+		logger$26.debug("VisibilityController: visibility changed", {
 			from: previousState,
 			to: newState
 		});
@@ -2720,7 +2720,7 @@ function isRequesterValidationError(error) {
 
 //#endregion
 //#region src/managers/AttachManager.ts
-const logger$24 = require_operators.getLogger();
+const logger$25 = require_operators.getLogger();
 var AttachManager = class {
 	constructor(storage, deviceController, reconnectCallsTimeout, attachKey, credentialRecovered) {
 		this.storage = storage;
@@ -2742,7 +2742,7 @@ var AttachManager = class {
 		try {
 			return await this.storage.getItem(this.attachKey) ?? {};
 		} catch (error) {
-			logger$24.warn("[AttachManager] Failed to retrieve attached calls from storage", error);
+			logger$25.warn("[AttachManager] Failed to retrieve attached calls from storage", error);
 			return {};
 		}
 	}
@@ -2750,7 +2750,7 @@ var AttachManager = class {
 		try {
 			await this.storage.setItem(this.attachKey, attached);
 		} catch (error) {
-			logger$24.warn("[AttachManager] Failed to write attached calls to storage", error);
+			logger$25.warn("[AttachManager] Failed to write attached calls to storage", error);
 		}
 	}
 	/**
@@ -2769,7 +2769,7 @@ var AttachManager = class {
 	}
 	async attach(call) {
 		if (!call.to) {
-			logger$24.warn("[AttachManager] Skip attach for calls with no destination");
+			logger$25.warn("[AttachManager] Skip attach for calls with no destination");
 			return;
 		}
 		const destination = call.to;
@@ -2829,25 +2829,25 @@ var AttachManager = class {
 					callId,
 					...options
 				});
-				logger$24.info(`[AttachManager] Reattached call ${callId} (attempt ${attempt})`);
+				logger$25.info(`[AttachManager] Reattached call ${callId} (attempt ${attempt})`);
 				succeeded = true;
 				break;
 			} catch (error) {
-				logger$24.warn(`[AttachManager] Reattach attempt ${attempt}/3 failed for call ${callId}:`, error);
+				logger$25.warn(`[AttachManager] Reattach attempt ${attempt}/3 failed for call ${callId}:`, error);
 				if (isRequesterValidationError(error)) {
 					refusedOnCredentials = true;
-					logger$24.warn(`[AttachManager] Reattach of ${callId} was refused on credentials; not retrying.`);
+					logger$25.warn(`[AttachManager] Reattach of ${callId} was refused on credentials; not retrying.`);
 					break;
 				}
 				if (attempt < 3) await new Promise((r) => setTimeout(r, (attempt + 1) * 1e3));
 			}
 			if (!succeeded) if (this.credentialRecovered() && !refusedOnCredentials) {
-				logger$24.warn(`[AttachManager] Reattach of ${callId} was denied after a verified reauthentication, removing reference`);
+				logger$25.warn(`[AttachManager] Reattach of ${callId} was denied after a verified reauthentication, removing reference`);
 				await this.detach({
 					id: callId,
 					mediaDirections: attachment.mediaDirections
 				});
-			} else logger$24.warn(`[AttachManager] Reattach failed for call ${callId}; keeping the reference (credential refused or never proven good)`);
+			} else logger$25.warn(`[AttachManager] Reattach failed for call ${callId}; keeping the reference (credential refused or never proven good)`);
 		}
 	}
 	/**
@@ -3160,7 +3160,7 @@ function toggleHandraiseMethod(is) {
 
 //#endregion
 //#region src/core/entities/Participant.ts
-const logger$23 = require_operators.getLogger();
+const logger$24 = require_operators.getLogger();
 const initialState = {};
 /**
 * Represents a participant in a call.
@@ -3634,6 +3634,9 @@ var SelfParticipant = class extends Participant {
 	*
 	* The call is unaffected when acquisition fails.
 	*
+	* Known issue: stopping the share before its leg connects can leave this
+	* promise pending until the call ends, so do not gate UI on it.
+	*
 	* @throws The raw `getDisplayMedia` error. A dismissed picker or a
 	* permission denial rejects with a `NotAllowedError` `DOMException` —
 	* inspect `error.name` to tell benign cancels apart from real failures.
@@ -3642,7 +3645,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await this.vertoManager.addScreenMedia();
 		} catch (error) {
-			logger$23.error("[Participant.startScreenShare] Screen share error:", error);
+			logger$24.error("[Participant.startScreenShare] Screen share error:", error);
 			throw error;
 		}
 	}
@@ -3663,14 +3666,18 @@ var SelfParticipant = class extends Participant {
 	*
 	* The call is unaffected when acquisition fails.
 	*
+	* Known issue: removing the device before its leg connects can leave this
+	* promise pending until the call ends, so do not gate UI on it.
+	*
 	* @throws The raw `getUserMedia` error (e.g. `NotAllowedError` on
-	* permission denial) — inspect `error.name` to decide how to react.
+	* permission denial) — inspect `error.name` to decide how to react — or
+	* `AuxiliaryLegTimeoutError` if the leg does not connect in time.
 	*/
 	async addAdditionalDevice(options) {
 		try {
 			await this.vertoManager.addInputDevice(options);
 		} catch (error) {
-			logger$23.error("[Participant.addAdditionalDevice] Additional device error:", error);
+			logger$24.error("[Participant.addAdditionalDevice] Additional device error:", error);
 			throw error;
 		}
 	}
@@ -3733,7 +3740,7 @@ var SelfParticipant = class extends Participant {
 	*/
 	exitStudioModeIfActive() {
 		if (this._studioAudio$.value) {
-			logger$23.debug("[SelfParticipant] Exiting studio audio mode due to individual flag toggle");
+			logger$24.debug("[SelfParticipant] Exiting studio audio mode due to individual flag toggle");
 			this._studioAudio$.next(false);
 		}
 	}
@@ -3757,7 +3764,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.mute();
 		} catch (error) {
-			logger$23.warn("[Participant.toggleAudioInput] Server Error while muting audio input, proceeding with local toggle anyway", error);
+			logger$24.warn("[Participant.toggleAudioInput] Server Error while muting audio input, proceeding with local toggle anyway", error);
 		} finally {
 			this.vertoManager.muteMainAudioInputDevice();
 		}
@@ -3767,7 +3774,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.unmute();
 		} catch (error) {
-			logger$23.warn("[Participant.toggleAudioInput] Server Error while unmuting audio input, proceeding with local toggle anyway", error);
+			logger$24.warn("[Participant.toggleAudioInput] Server Error while unmuting audio input, proceeding with local toggle anyway", error);
 		} finally {
 			await this.vertoManager.unmuteMainAudioInputDevice();
 		}
@@ -3777,7 +3784,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.muteVideo();
 		} catch (error) {
-			logger$23.warn("[Participant.toggleVideoInput] Server Error while muting video input, proceeding with local toggle anyway", error);
+			logger$24.warn("[Participant.toggleVideoInput] Server Error while muting video input, proceeding with local toggle anyway", error);
 		} finally {
 			this.vertoManager.muteMainVideoInputDevice();
 		}
@@ -3787,7 +3794,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.unmuteVideo();
 		} catch (error) {
-			logger$23.warn("[Participant.toggleVideoInput] Server Error while unmuting video input, proceeding with local toggle anyway", error);
+			logger$24.warn("[Participant.toggleVideoInput] Server Error while unmuting video input, proceeding with local toggle anyway", error);
 		} finally {
 			await this.vertoManager.unmuteMainVideoInputDevice();
 		}
@@ -3881,7 +3888,7 @@ function isLayoutChangedPayload(value) {
 
 //#endregion
 //#region src/managers/CallEventsManager.ts
-const logger$22 = require_operators.getLogger();
+const logger$23 = require_operators.getLogger();
 const initialSessionState = {};
 /** @internal */
 var CallEventsManager = class extends Destroyable {
@@ -3985,7 +3992,7 @@ var CallEventsManager = class extends Destroyable {
 	}
 	initSubscriptions() {
 		this.subscribeTo(this.callJoinedEvent$, (callJoinedEvent) => {
-			logger$22.debug("[CallEventsManager] Handling call.joined event for call/session IDs:", {
+			logger$23.debug("[CallEventsManager] Handling call.joined event for call/session IDs:", {
 				callId: callJoinedEvent.call_id,
 				roomSessionId: callJoinedEvent.room_session_id
 			});
@@ -4012,19 +4019,19 @@ var CallEventsManager = class extends Destroyable {
 			if (this._self$.value?.capabilities.setLayout) this.updateLayouts();
 		});
 		this.subscribeTo(this.memberUpdates$, (member) => {
-			logger$22.debug("[CallEventsManager] Handling member update event for member ID:", member);
+			logger$23.debug("[CallEventsManager] Handling member update event for member ID:", member);
 			this.upsertParticipant(member);
 		});
 		this.subscribeTo(this.webRtcCallSession.memberLeft$, (memberLeftEvent) => {
-			logger$22.debug("[CallEventsManager] Handling member.left event for member ID:", memberLeftEvent.member.member_id);
+			logger$23.debug("[CallEventsManager] Handling member.left event for member ID:", memberLeftEvent.member.member_id);
 			const participants = { ...this._participants$.value };
 			if (memberLeftEvent.member.member_id in participants) {
 				delete participants[memberLeftEvent.member.member_id];
 				this._participants$.next(participants);
-			} else logger$22.warn(`[CallEventsManager] Received member.left event for unknown member ID: ${memberLeftEvent.member.member_id}`);
+			} else logger$23.warn(`[CallEventsManager] Received member.left event for unknown member ID: ${memberLeftEvent.member.member_id}`);
 		});
 		this.subscribeTo(this.webRtcCallSession.callUpdated$, (callUpdatedEvent) => {
-			logger$22.debug("[CallEventsManager] Handling call.updated event:", callUpdatedEvent);
+			logger$23.debug("[CallEventsManager] Handling call.updated event:", callUpdatedEvent);
 			const roomSession = callUpdatedEvent.room_session;
 			this._sessionState$.next({
 				...this._sessionState$.value,
@@ -4039,7 +4046,7 @@ var CallEventsManager = class extends Destroyable {
 			});
 		});
 		this.subscribeTo(this.layoutChangedEvent$, (layoutChangedEvent) => {
-			logger$22.debug("[CallEventsManager] Handling layout.changed event:", layoutChangedEvent);
+			logger$23.debug("[CallEventsManager] Handling layout.changed event:", layoutChangedEvent);
 			this._sessionState$.next({
 				...this._sessionState$.value,
 				layout_name: layoutChangedEvent.id,
@@ -4049,10 +4056,10 @@ var CallEventsManager = class extends Destroyable {
 		});
 	}
 	updateParticipantPositions(layoutChangedEvent) {
-		if (Object.keys(this._participants$.value).length > 0 && !layoutChangedEvent.layers.some((layer) => !!layer.member_id)) logger$22.warn("[CallEventsManager] No layers with member_id found in layout.changed event. Nothing to update.");
+		if (Object.keys(this._participants$.value).length > 0 && !layoutChangedEvent.layers.some((layer) => !!layer.member_id)) logger$23.warn("[CallEventsManager] No layers with member_id found in layout.changed event. Nothing to update.");
 		layoutChangedEvent.layers.filter((layer) => !!layer.member_id).filter((layer) => {
 			if (!(layer.member_id in this._participants$.value)) {
-				logger$22.warn(`[CallEventsManager] Skipping layout layer for unknown member_id: ${layer.member_id}`);
+				logger$23.warn(`[CallEventsManager] Skipping layout layer for unknown member_id: ${layer.member_id}`);
 				return false;
 			}
 			return true;
@@ -4072,7 +4079,7 @@ var CallEventsManager = class extends Destroyable {
 		this.webRtcCallSession.executeMethod(this.selfId, "call.layout.list", {}).then((response) => {
 			const layouts = response.result?.layouts;
 			if (!layouts) {
-				logger$22.warn("[CallEventsManager] Layout list response carried no layouts; keeping current layouts");
+				logger$23.warn("[CallEventsManager] Layout list response carried no layouts; keeping current layouts");
 				return;
 			}
 			this._sessionState$.next({
@@ -4080,7 +4087,7 @@ var CallEventsManager = class extends Destroyable {
 				layouts
 			});
 		}).catch((error) => {
-			logger$22.error("[CallEventsManager] Error fetching layouts:", error);
+			logger$23.error("[CallEventsManager] Error fetching layouts:", error);
 		});
 	}
 	updateParticipants(members) {
@@ -4096,7 +4103,7 @@ var CallEventsManager = class extends Destroyable {
 		}
 		const participant = this._participants$.value[member.member_id];
 		const oldValue = participant.value;
-		logger$22.debug("[CallEventsManager] Updating participant:", member.member_id, {
+		logger$23.debug("[CallEventsManager] Updating participant:", member.member_id, {
 			oldValue,
 			newValue: member
 		});
@@ -4109,17 +4116,17 @@ var CallEventsManager = class extends Destroyable {
 	}
 	get callJoinedEvent$() {
 		return this.cachedObservable("callJoinedEvent$", () => this.webRtcCallSession.callEvent$.pipe((0, rxjs.filter)(isCallJoinedPayload), (0, rxjs.tap)((event) => {
-			logger$22.debug("[CallEventsManager] Call joined event:", event);
+			logger$23.debug("[CallEventsManager] Call joined event:", event);
 		})));
 	}
 	get layoutChangedEvent$() {
 		return this.cachedObservable("layoutChangedEvent$", () => this.webRtcCallSession.callEvent$.pipe(require_operators.filterAs(isLayoutChangedPayload, "layout"), (0, rxjs.tap)((event) => {
-			logger$22.debug("[CallEventsManager] Layout changed event:", event);
+			logger$23.debug("[CallEventsManager] Layout changed event:", event);
 		})));
 	}
 	get memberUpdates$() {
 		return this.cachedObservable("memberUpdates$", () => (0, rxjs.merge)(this.webRtcCallSession.memberJoined$, this.webRtcCallSession.memberUpdated$, this.webRtcCallSession.memberTalking$).pipe((0, rxjs.map)((event) => event.member), (0, rxjs.tap)((event) => {
-			logger$22.debug("[CallEventsManager] Member update event:", event);
+			logger$23.debug("[CallEventsManager] Member update event:", event);
 		})));
 	}
 	destroy() {
@@ -4138,6 +4145,111 @@ var CallEventsManager = class extends Destroyable {
 	}
 };
 
+//#endregion
+//#region src/controllers/ConstraintFallbackHelper.ts
+/**
+* ConstraintFallbackHelper - Provides getUserMedia with automatic constraint
+* fallback on OverconstrainedError.
+*
+* When a specific device ID is requested, the helper tries progressively
+* looser constraints:
+*   1. `{ deviceId: { exact: deviceId } }` -- exact match
+*   2. `{ deviceId: deviceId }` -- preferred (browser may pick another)
+*   3. `{}` -- no constraint, browser default
+*
+* This prevents stale device IDs from blocking call setup.
+*
+* @see Section 5.8 and Section 11 of the Implementation Guide
+*/
+const logger$22 = require_operators.getLogger();
+/**
+* Attempts getUserMedia with progressively looser constraints.
+*
+* The function tries three levels of constraint specificity for the given
+* device kind. Each level is only attempted if the previous one fails with
+* an OverconstrainedError. Non-OverconstrainedError failures (e.g.,
+* NotAllowedError) are thrown immediately without fallback.
+*
+* @param mediaDevices - Anything exposing `getUserMedia` (a full
+*   `WebRTCMediaDevices`, or a shim wrapping one)
+* @param constraints - The full MediaStreamConstraints to use as a base
+* @param kind - Which track kind to apply fallback to ('audio' | 'video')
+* @param deviceId - The device ID to try (if undefined, calls getUserMedia as-is)
+* @returns The stream and the fallback level that succeeded
+* @throws When all fallback levels fail, or when a non-OverconstrainedError occurs
+*/
+async function getUserMediaWithFallback(mediaDevices, constraints, kind, deviceId) {
+	if (!deviceId) return {
+		stream: await mediaDevices.getUserMedia(constraints),
+		fallbackLevel: "default"
+	};
+	const baseConstraints = typeof constraints[kind] === "object" ? constraints[kind] : {};
+	try {
+		const exactConstraints = {
+			...constraints,
+			[kind]: {
+				...baseConstraints,
+				deviceId: { exact: deviceId }
+			}
+		};
+		return {
+			stream: await mediaDevices.getUserMedia(exactConstraints),
+			fallbackLevel: "exact"
+		};
+	} catch (error) {
+		if (!isOverconstrainedError(error)) throw error;
+		logger$22.debug(`[ConstraintFallbackHelper] Exact constraint failed for ${kind}, trying preferred`, { deviceId });
+	}
+	try {
+		const preferredConstraints = {
+			...constraints,
+			[kind]: {
+				...baseConstraints,
+				deviceId
+			}
+		};
+		return {
+			stream: await mediaDevices.getUserMedia(preferredConstraints),
+			fallbackLevel: "preferred"
+		};
+	} catch (error) {
+		if (!isOverconstrainedError(error)) throw error;
+		logger$22.debug(`[ConstraintFallbackHelper] Preferred constraint failed for ${kind}, trying default`, { deviceId });
+	}
+	try {
+		const defaultConstraints = {
+			...constraints,
+			[kind]: { ...baseConstraints }
+		};
+		if (typeof defaultConstraints[kind] === "object") {
+			const { deviceId: _removed, ...rest } = defaultConstraints[kind];
+			defaultConstraints[kind] = rest;
+		}
+		const stream = await mediaDevices.getUserMedia(defaultConstraints);
+		logger$22.warn(`[ConstraintFallbackHelper] Fell back to browser default for ${kind}`, { requestedDeviceId: deviceId });
+		return {
+			stream,
+			fallbackLevel: "default"
+		};
+	} catch (error) {
+		logger$22.error(`[ConstraintFallbackHelper] All fallback levels exhausted for ${kind}`, {
+			deviceId,
+			error
+		});
+		throw error;
+	}
+}
+/**
+* Checks whether an error is an OverconstrainedError.
+*
+* Browsers may throw either a native OverconstrainedError or a DOMException
+* with a specific name.
+*/
+function isOverconstrainedError(error) {
+	if (error instanceof Error) return error.name === "OverconstrainedError" || error.name === "ConstraintNotSatisfiedError";
+	return false;
+}
+
 //#endregion
 //#region src/helpers/SDPHelper.ts
 /**
@@ -4693,6 +4805,7 @@ var LocalStreamController = class extends Destroyable {
 		this._localAudioTracks$ = this.createBehaviorSubject([]);
 		this._localVideoTracks$ = this.createBehaviorSubject([]);
 		this._mediaTrackEnded$ = this.createSubject();
+		this._trackOrigins = /* @__PURE__ */ new WeakMap();
 	}
 	get localStream$() {
 		return this._localStream$.asObservable().pipe((0, rxjs.takeUntil)(this.destroyed$));
@@ -4715,6 +4828,22 @@ var LocalStreamController = class extends Destroyable {
 	get localVideoTracks() {
 		return this._localVideoTracks$.value;
 	}
+	tagTracks(tracks, origin) {
+		for (const track of tracks) this._trackOrigins.set(track, origin);
+	}
+	setTrackOrigin(track, origin) {
+		this._trackOrigins.set(track, origin);
+	}
+	getTrackOrigin(track) {
+		return this._trackOrigins.get(track);
+	}
+	/**
+	* Fail-safe: an unrecorded track reads as not-a-device-capture, so a missed
+	* tagging site leaves media alone rather than destroying it.
+	*/
+	isDeviceCapture(track) {
+		return this._trackOrigins.get(track) === "device";
+	}
 	/**
 	* Build the local media stream based on the provided options.
 	*/
@@ -4724,6 +4853,7 @@ var LocalStreamController = class extends Destroyable {
 		if (this.options.inputAudioStream ?? this.options.inputVideoStream) {
 			const tracks = [...this.options.inputAudioStream?.getTracks() ?? [], ...this.options.inputVideoStream?.getTracks() ?? []];
 			stream = new MediaStream(tracks);
+			this.tagTracks(tracks, "application");
 		} else if (this.options.propose === "screenshare") {
 			logger$19.debug("[LocalStreamController] Requesting display media for screen sharing with audio:", Boolean(this.options.inputAudioDeviceConstraints));
 			stream = await this.options.getDisplayMedia({
@@ -4731,6 +4861,7 @@ var LocalStreamController = class extends Destroyable {
 				audio: Boolean(this.options.inputAudioDeviceConstraints)
 			});
 			logger$19.debug("[LocalStreamController] Screen share media obtained:", stream);
+			this.tagTracks(stream.getTracks(), "display");
 		} else {
 			const constraints = {
 				audio: this.options.inputAudioDeviceConstraints,
@@ -4739,6 +4870,7 @@ var LocalStreamController = class extends Destroyable {
 			logger$19.debug("[LocalStreamController] Requesting user media with constraints:", constraints);
 			stream = await this.options.getUserMedia(constraints);
 			logger$19.debug("[LocalStreamController] User media obtained:", stream);
+			this.tagTracks(stream.getTracks(), "device");
 		}
 		this._localStream$.next(stream);
 		this._localAudioTracks$.next(stream.getAudioTracks());
@@ -4748,10 +4880,13 @@ var LocalStreamController = class extends Destroyable {
 	/**
 	* Add a local media track to the local stream.
 	* @param track - The MediaStreamTrack to add
+	* @param origin - Defaults to `'device'`; every internal caller passes a
+	* fresh `getUserMedia` capture.
 	* @returns The MediaStream (either existing or newly created)
 	*/
-	addTrack(track) {
+	addTrack(track, origin = "device") {
 		const localStream = this._localStream$.value ?? new MediaStream();
+		this._trackOrigins.set(track, origin);
 		track.addEventListener("ended", this.mediaTrackEndedHandler);
 		localStream.addTrack(track);
 		this._localStream$.next(localStream);
@@ -5021,15 +5156,27 @@ var TransceiverController = class extends Destroyable {
 			for (let i = 0; i < Number(msStreamsNumber); i++) this.peerConnection.addTransceiver("video", { direction: "recvonly" });
 		}
 	}
+	/**
+	* @returns whether every live sender of the kind took the constraints. A
+	* skipped non-device sender, an exhausted fallback, and having no live sender
+	* at all all report `false` — `mediaParamsUpdated.applied` is built from this,
+	* and an application told `true` cannot tell a working push from a no-op.
+	*/
 	async updateSendersConstraints(kind, constraints) {
 		if (!constraints) {
 			this.stopTrackSender(kind);
-			return Promise.resolve();
+			return false;
 		}
 		const senders = this.peerConnection.getSenders().filter((sender) => sender.track?.kind === kind && sender.track.readyState === "live");
+		let applied = senders.length > 0;
 		for (const sender of senders) {
 			const { track } = sender;
 			if (track) {
+				if (!this.options.localStreamController.isDeviceCapture(track)) {
+					logger$18.debug(`[TransceiverController] Skipping ${kind} constraints for a non-device track (origin: ${this.options.localStreamController.getTrackOrigin(track) ?? "unrecorded"}), track ${track.id}`);
+					applied = false;
+					continue;
+				}
 				const constraintsToApply = {
 					...track.getConstraints(),
 					...constraints
@@ -5045,33 +5192,39 @@ var TransceiverController = class extends Destroyable {
 					} catch (fallbackError) {
 						logger$18.warn(`[TransceiverController] Track replacement fallback also failed for ${kind} track:`, fallbackError);
 						this.options.onError?.(new require_operators.MediaTrackError("updateSendersConstraints", kind, fallbackError));
+						applied = false;
 					}
 				}
 			}
 		}
+		return applied;
 	}
 	/**
-	* Fallback when applyConstraints fails: stop the current track, acquire a new
-	* one via getUserMedia with the merged constraints (preserving the current
-	* deviceId), replace the sender track, and update the localStream.
+	* Fallback when applyConstraints fails, which on iOS Safari it silently does.
 	*
-	* This is critical for iOS Safari where applyConstraints on audio tracks
-	* silently fails or throws.
+	* Order matters: acquiring before stopping means a failed acquisition leaves
+	* the existing media playing. The deviceId goes through the fallback ladder
+	* rather than pinned `{ exact }`, so a stale id degrades instead of failing.
 	*/
 	async replaceTrackFallback(sender, oldTrack, kind, mergedConstraints) {
 		const { deviceId } = oldTrack.getSettings();
-		const constraintsWithDevice = {
-			...mergedConstraints,
-			...deviceId ? { deviceId: { exact: deviceId } } : {}
-		};
-		const trackId = oldTrack.id;
+		const { stream, fallbackLevel } = await getUserMediaWithFallback({ getUserMedia: this.options.getUserMedia }, { [kind]: mergedConstraints }, kind, deviceId);
+		const newTrack = stream.getTracks().find((t) => t.kind === kind);
+		if (!newTrack) {
+			stream.getTracks().forEach((t) => t.stop());
+			throw new require_operators.MediaTrackError("replaceTrackFallback", kind, /* @__PURE__ */ new Error("getUserMedia returned no track of the requested kind"));
+		}
+		try {
+			await sender.replaceTrack(newTrack);
+		} catch (error) {
+			stream.getTracks().forEach((t) => t.stop());
+			throw error;
+		}
+		const oldTrackId = oldTrack.id;
+		this.options.localStreamController.removeTrack(oldTrackId);
 		oldTrack.stop();
-		this.options.localStreamController.removeTrack(trackId);
-		const newTrack = (await this.options.getUserMedia({ [kind]: constraintsWithDevice })).getTracks().find((t) => t.kind === kind);
-		if (!newTrack) throw new require_operators.MediaTrackError("replaceTrackFallback", kind, /* @__PURE__ */ new Error("getUserMedia returned no track of the requested kind"));
-		await sender.replaceTrack(newTrack);
 		this.options.localStreamController.addTrack(newTrack);
-		logger$18.debug(`[TransceiverController] Track replacement fallback succeeded for ${kind}. New track: ${newTrack.id}`);
+		logger$18.debug(`[TransceiverController] Track replacement fallback succeeded for ${kind} (deviceId fallback level: ${fallbackLevel}). New track: ${newTrack.id}`);
 	}
 	getMediaDirections() {
 		if (this.peerConnection.connectionState === "connected") return this.peerConnection.getTransceivers().reduce((acc, transceiver) => {
@@ -5182,6 +5335,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 		this._iceGatheringState$ = this.createReplaySubject(1);
 		this._errors$ = this.createReplaySubject(1);
 		this._iceCandidates$ = this.createReplaySubject(1);
+		this._localMediaSettled$ = this.createReplaySubject(1);
 		this._initialized$ = this.createReplaySubject(1);
 		this._remoteDescription$ = this.createReplaySubject(1);
 		this._remoteStream$ = this.createBehaviorSubject(null);
@@ -5285,6 +5439,10 @@ var RTCPeerConnectionController = class extends Destroyable {
 	get remoteDescription$() {
 		return this.cachedObservable("remoteDescription$", () => this._remoteDescription$.asObservable().pipe((0, rxjs.takeUntil)(this.destroyed$)));
 	}
+	/** Emits once local media is settled — acquired, or knowingly receive-only. */
+	get localMediaSettled$() {
+		return this.cachedObservable("localMediaSettled$", () => this._localMediaSettled$.asObservable().pipe((0, rxjs.takeUntil)(this.destroyed$)));
+	}
 	get localStream$() {
 		return this.cachedObservable("localStream$", () => this.localStreamController.localStream$.pipe((0, rxjs.takeUntil)(this.destroyed$)));
 	}
@@ -5440,7 +5598,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 				this._isNegotiating$.next(true);
 				await this._setRemoteDescription(this.sdpInit);
 			} else {
-				await this.setupTrackHandling();
+				if (!await this.setupTrackHandling()) return;
 				this._initialized$.next(true);
 			}
 		} catch (error) {
@@ -5564,7 +5722,10 @@ var RTCPeerConnectionController = class extends Destroyable {
 				inputVideoDeviceConstraints: this.inputVideoDeviceConstraints
 			});
 		}
-		await this.setupLocalTracks();
+		if (!await this.setupLocalTracks()) {
+			logger$17.debug("[RTCPeerConnectionController] Inbound answer abandoned; the connection went away.");
+			return;
+		}
 		const { answerOptions } = this;
 		logger$17.debug("[RTCPeerConnectionController] Creating inbound answer with options:", answerOptions);
 		await this.createAnswer(answerOptions);
@@ -5702,35 +5863,52 @@ var RTCPeerConnectionController = class extends Destroyable {
 	}
 	/**
 	* Setup track handling for remote tracks.
+	*
+	* @returns `false` when the connection went away while local media was being
+	* acquired — see {@link setupLocalTracks}.
 	*/
 	async setupTrackHandling() {
 		if (!this.peerConnection) throw new require_operators.DependencyError("RTCPeerConnection is not initialized");
-		await this.setupLocalTracks();
+		if (!await this.setupLocalTracks()) return false;
 		await this.setupRemoteTracks();
+		return true;
 	}
+	/**
+	* @returns `false` when the connection was torn down while getUserMedia was
+	* in flight. The acquisition is not cancellable, so the caller must stop
+	* rather than go on to touch a peer connection that is closed or gone.
+	*/
 	async setupLocalTracks() {
 		logger$17.debug("[RTCPeerConnectionController] Setting up local tracks/transceivers.");
 		if (this.hasNoLocalMediaToSend()) {
 			if (!this.receiveAudio && !this.receiveVideo) throw new require_operators.InvalidParams("Call requests no media: enable audio/video or receiveAudio/receiveVideo");
 			logger$17.debug("[RTCPeerConnectionController] No local media requested; negotiating receive-only.");
 			this.setupReceiveOnlyTransceivers();
-			return;
+			this._localMediaSettled$.next();
+			return true;
 		}
 		let localStream;
 		try {
 			localStream = this.localStream ?? await this.localStreamController.buildLocalStream();
 		} catch (error) {
 			this.handleLocalMediaFailure(error);
-			return;
+			this._localMediaSettled$.next();
+			return true;
 		}
+		if (!this.peerConnection || this.peerConnection.signalingState === "closed") {
+			logger$17.debug("[RTCPeerConnectionController] Local media arrived after teardown; releasing it.");
+			localStream.getTracks().forEach((track) => track.stop());
+			return false;
+		}
+		this._localMediaSettled$.next();
 		if (this.transceiverController?.useAddStream ?? false) {
 			logger$17.warn("[RTCPeerConnectionController] Using deprecated addStream API to add local stream.");
-			this.peerConnection?.addStream(localStream);
+			this.peerConnection.addStream(localStream);
 			if (!this.isNegotiating) {
 				logger$17.debug("[RTCPeerConnectionController] Forcing negotiationneeded after local tracks setup.");
 				this.negotiationNeeded$.next();
 			}
-			return;
+			return true;
 		}
 		for (const kind of ["audio", "video"]) {
 			const tracks = (kind === "audio" ? localStream.getAudioTracks() : localStream.getVideoTracks()).map((track, index) => ({
@@ -5744,10 +5922,11 @@ var RTCPeerConnectionController = class extends Destroyable {
 					await this.transceiverController?.setupTransceiverSender(track, localStream, transceivers[index]);
 				} else {
 					logger$17.debug(`[RTCPeerConnectionController] Using addTrack for local ${kind} track:`, track.id);
-					this.peerConnection?.addTrack(track, localStream);
+					this.peerConnection.addTrack(track, localStream);
 				}
 			}
 		}
+		return true;
 	}
 	/** True for a main connection with no local media to send. */
 	hasNoLocalMediaToSend() {
@@ -5868,6 +6047,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 		const sender = (this.transceiverController?.audioTransceivers.at(0))?.sender ?? this.peerConnection.getSenders().find((s) => s.track?.kind === "audio");
 		if (!sender || !raw) return;
 		try {
+			this.localStreamController.setTrackOrigin(this._localAudioPipeline.outputTrack, "processed");
 			await sender.replaceTrack(this._localAudioPipeline.outputTrack);
 		} catch (error) {
 			logger$17.warn("[RTCPeerConnectionController] Failed to route audio sender through pipeline:", error);
@@ -5928,37 +6108,62 @@ var RTCPeerConnectionController = class extends Destroyable {
 		for (const existingTrack of existingTracks) this.removeLocalTrack(existingTrack.id);
 		this.addLocalTrack(track);
 	}
+	/**
+	* @returns whether the constraints reached the media the leg is sending.
+	*
+	* With the pipeline engaged the audio sender carries the processed
+	* destination track, so the sender scan would find nothing it may touch and
+	* every audio constraint API would silently no-op. The constraints belong to
+	* the pipeline's device source, which is the capture that sender ultimately
+	* carries.
+	*/
 	async updateSendersConstraints(kind, constraints) {
-		await this.transceiverController?.updateSendersConstraints(kind, constraints);
+		if (kind === "audio" && constraints && this._localAudioPipeline) return this.applyPipelineSourceConstraints(constraints);
+		return await this.transceiverController?.updateSendersConstraints(kind, constraints) ?? false;
 	}
 	/**
-	* Replace the current audio track with a new one using the given constraints.
-	* Used for server-pushed audio constraint changes where applyConstraints
-	* fails on iOS Safari. Stops the current track, acquires a new one via
-	* getUserMedia, and replaces the sender track.
+	* Mirror of the sender path for a piped audio leg: same merge, same fallback
+	* ladder, same device-capture invariant — but the swap target is the pipeline
+	* input, so the sender keeps emitting the pipeline's output track and its
+	* identity survives the change.
 	*/
-	async replaceAudioTrackWithConstraints(constraints) {
-		const senders = this.peerConnection?.getSenders().filter((s) => s.track?.kind === "audio" && s.track.readyState === "live");
-		if (!senders || senders.length === 0) {
-			logger$17.warn("[RTCPeerConnectionController] No live audio sender to replace");
-			return;
+	async applyPipelineSourceConstraints(constraints) {
+		const pipeline = this._localAudioPipeline;
+		const source = this.localStreamController.localAudioTracks.at(0);
+		if (!pipeline || !source) {
+			logger$17.debug("[RTCPeerConnectionController] No pipeline input to constrain.");
+			return false;
 		}
-		for (const sender of senders) {
-			const oldTrack = sender.track;
-			if (!oldTrack) continue;
-			const { deviceId } = oldTrack.getSettings();
-			const mergedConstraints = {
-				...oldTrack.getConstraints(),
-				...constraints,
-				...deviceId ? { deviceId: { exact: deviceId } } : {}
-			};
-			const trackId = oldTrack.id;
-			oldTrack.stop();
-			this.localStreamController.removeTrack(trackId);
-			const newTrack = (await this.getUserMedia({ audio: mergedConstraints })).getAudioTracks()[0];
-			await sender.replaceTrack(newTrack);
+		if (!this.localStreamController.isDeviceCapture(source)) {
+			logger$17.debug(`[RTCPeerConnectionController] Skipping audio constraints for a non-device pipeline input (origin: ${this.localStreamController.getTrackOrigin(source) ?? "unrecorded"}).`);
+			return false;
+		}
+		const merged = {
+			...source.getConstraints(),
+			...constraints
+		};
+		try {
+			await source.applyConstraints(merged);
+			logger$17.debug("[RTCPeerConnectionController] Pipeline input constraints updated:", merged);
+			return true;
+		} catch (error) {
+			logger$17.warn("[RTCPeerConnectionController] applyConstraints failed on the pipeline input, re-acquiring:", error);
+		}
+		try {
+			const { stream } = await getUserMediaWithFallback({ getUserMedia: async (c) => this.getUserMedia(c) }, { audio: merged }, "audio", source.getSettings().deviceId);
+			const newTrack = stream.getAudioTracks().at(0);
+			if (!newTrack) {
+				stream.getTracks().forEach((track) => track.stop());
+				throw new Error("getUserMedia returned no audio track");
+			}
+			this.localStreamController.removeTrack(source.id);
 			this.localStreamController.addTrack(newTrack);
-			logger$17.debug(`[RTCPeerConnectionController] Audio track replaced for server-pushed params. New track: ${newTrack.id}`);
+			pipeline.setInputTrack(newTrack);
+			return true;
+		} catch (error) {
+			logger$17.warn("[RTCPeerConnectionController] Failed to re-acquire the pipeline input for constraints:", error);
+			this._errors$.next(new require_operators.MediaTrackError("updateSendersConstraints", "audio", error));
+			return false;
 		}
 	}
 	/**
@@ -6141,7 +6346,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		this._signalingStatus$ = this.createReplaySubject(1);
 		this._screenShareStatus$ = this.createBehaviorSubject("none");
 		this._rtcPeerConnectionsMap = /* @__PURE__ */ new Map();
-		this._screenShareTimeoutMs = 5e4;
+		this._legErrors$ = this.createSubject();
 		this._nodeId$ = this.createBehaviorSubject(options.nodeId ?? null);
 		this.onError = options.onError;
 		this.onModifyFailed = options.onModifyFailed;
@@ -6189,6 +6394,10 @@ var WebRTCVertoManager = class extends VertoManager {
 	get selfId$() {
 		return this._selfId$.asObservable();
 	}
+	/** Separates the media phase of call creation from the signalling phase. */
+	get localMediaSettled$() {
+		return this.mainPeerConnection.localMediaSettled$;
+	}
 	get localStream() {
 		return this._rtcPeerConnectionsMap.get(this.webRtcCallSession.id)?.localStream ?? null;
 	}
@@ -6245,20 +6454,11 @@ var WebRTCVertoManager = class extends VertoManager {
 			const { mediaParams, callID } = event;
 			const rtcPeerConnController = this._rtcPeerConnectionsMap.get(callID);
 			const { audio, video } = mediaParams;
-			(async () => {
-				try {
-					if (audio && rtcPeerConnController) await rtcPeerConnController.replaceAudioTrackWithConstraints(audio);
-					if (video) await rtcPeerConnController?.updateSendersConstraints("video", video);
-					this.webRtcCallSession.emitMediaParamsUpdated({
-						audio,
-						video,
-						timestamp: Date.now()
-					});
-				} catch (error) {
-					logger$16.warn("[WebRTCManager] Error applying server-pushed media params:", error);
-					this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
-				}
-			})();
+			if (!rtcPeerConnController) {
+				logger$16.warn(`[WebRTCManager] Ignoring server-pushed media params for unknown leg ${callID}`);
+				return;
+			}
+			this.applyServerMediaParams(rtcPeerConnController, audio, video);
 		});
 		this.subscribeTo(this.vertoPing$, (vertoPing) => {
 			this.attachManager.attach(this.buildAttachableCall());
@@ -6266,6 +6466,75 @@ var WebRTCVertoManager = class extends VertoManager {
 		});
 	}
 	/**
+	* An auxiliary-leg failure must never destroy the call; main-leg and
+	* call-level errors keep `CallFactory.isFatalError`'s classification.
+	*
+	* Every site holding a peer connection reports through here, so the invariant
+	* is structural rather than per-call-site — which is how cloud-product#20523
+	* happened, with only one of fourteen sites passing `{ fatal: false }`.
+	*
+	* `override` composes rather than replaces: a caller may force non-fatal for a
+	* reason of its own (a `verto.info` frame is best-effort whichever leg carries
+	* it), and an auxiliary leg stays non-fatal regardless.
+	*/
+	reportLegError(error, rtcPeerConnController, override) {
+		const leg = rtcPeerConnController?.propose;
+		const legId = rtcPeerConnController?.id;
+		const auxiliary = Boolean(rtcPeerConnController) && !rtcPeerConnController?.isMainDevice;
+		this.onError?.(error, {
+			...override?.fatal === false || auxiliary ? { fatal: false } : {},
+			...leg ? { leg } : {},
+			...legId ? { legId } : {}
+		});
+		if (legId) this._legErrors$.next({
+			legId,
+			error
+		});
+	}
+	/**
+	* Errors reported for one leg, as a stream that fails with them.
+	*
+	* Signaling failures are reported, never thrown — so nothing that waits on a
+	* leg's progress would otherwise learn of a rejected invite. Merging this in
+	* lets the wait end with the reason the server gave.
+	*/
+	legError$(legId) {
+		return this._legErrors$.pipe((0, rxjs.filter)((report) => report.legId === legId), (0, rxjs.map)((report) => {
+			throw report.error;
+		}));
+	}
+	/**
+	* Audio and video are applied independently so a failure in one cannot
+	* suppress the other, and `mediaParamsUpdated` is emitted whatever happens —
+	* an application should not be starved of the params by a constraint failure.
+	*/
+	async applyServerMediaParams(rtcPeerConnController, audio, video) {
+		const failures = [];
+		let applied = true;
+		if (audio) try {
+			applied = await rtcPeerConnController.updateSendersConstraints("audio", audio) && applied;
+		} catch (error) {
+			applied = false;
+			failures.push(toError(error));
+		}
+		if (video) try {
+			applied = await rtcPeerConnController.updateSendersConstraints("video", video) && applied;
+		} catch (error) {
+			applied = false;
+			failures.push(toError(error));
+		}
+		this.webRtcCallSession.emitMediaParamsUpdated({
+			audio,
+			video,
+			timestamp: Date.now(),
+			applied
+		});
+		for (const failure of failures) {
+			logger$16.warn("[WebRTCManager] Error applying server-pushed media params:", failure);
+			this.reportLegError(failure, rtcPeerConnController, { fatal: false });
+		}
+	}
+	/**
 	* Set node_id/selfId only when the current value is null.
 	*
 	* During reattach, `call.joined` and `verto.answer` events can deliver
@@ -6303,7 +6572,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			if (video) await this.mainPeerConnection.updateSendersConstraints("video", video);
 		} catch (error) {
 			logger$16.warn("[WebRTCManager] Error updating media constraints:", error);
-			this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
+			this.reportLegError(toError(error), this.mainPeerConnection);
 			throw error;
 		}
 	}
@@ -6471,23 +6740,24 @@ var WebRTCVertoManager = class extends VertoManager {
 		return response;
 	}
 	async executeVerto(message, optionals = {}) {
-		const webrtcVertoMessage = WebrtcVerto({
+		const params = {
 			callID: optionals.callID ?? this.webRtcCallSession.id,
 			node_id: optionals.node_id ?? this._nodeId$.value ?? "",
 			message,
 			subscribe: optionals.subscribe
-		});
+		};
+		const webrtcVertoMessage = WebrtcVerto(params);
 		const response = await this.webRtcCallSession.execute(webrtcVertoMessage);
 		const nonFatal = message.method === "verto.info" ? { fatal: false } : void 0;
 		if (response.error) {
 			const error = new require_operators.JSONRPCError(response.error.code, response.error.message, response.error.data);
-			this.onError?.(error, nonFatal);
+			this.reportLegError(error, this._rtcPeerConnectionsMap.get(params.callID), nonFatal);
 			return response;
 		}
 		const innerResult = require_operators.getValueFrom(response, "result.result");
 		if (innerResult?.error) {
 			const error = new require_operators.JSONRPCError(innerResult.error.code, innerResult.error.message, innerResult.error.data);
-			this.onError?.(error, nonFatal);
+			this.reportLegError(error, this._rtcPeerConnectionsMap.get(params.callID), nonFatal);
 			return response;
 		}
 		return response;
@@ -6508,7 +6778,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			}
 		} catch (error) {
 			logger$16.error(`[WebRTCManager] Error sending Verto ${vertoMethod}:`, error);
-			this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
+			this.reportLegError(toError(error), rtcPeerConnController);
 			if (vertoMethod === "verto.modify") this.onModifyFailed?.();
 		}
 	}
@@ -6524,7 +6794,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			} catch (error) {
 				logger$16.warn("[WebRTCManager] Error processing modify response:", error);
 				const modifyError = error instanceof Error ? error : new Error(String(error), { cause: error });
-				this.onError?.(modifyError);
+				this.reportLegError(modifyError, rtcPeerConnController);
 			}
 		}
 	}
@@ -6537,7 +6807,7 @@ var WebRTCVertoManager = class extends VertoManager {
 				status,
 				signalingError
 			});
-			this.onError?.(signalingError);
+			this.reportLegError(signalingError, null, { fatal: false });
 			return;
 		}
 		if (rtcPeerConnController.isMainDevice) this._signalingStatus$.next(status);
@@ -6567,7 +6837,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		} else {
 			logger$16.error("[WebRTCManager] Verto invite failed:", response);
 			const inviteError = response.error ? new require_operators.JSONRPCError(response.error.code, response.error.message, response.error.data) : /* @__PURE__ */ new Error("Verto invite failed: unexpected response");
-			this.onError?.(inviteError);
+			this.reportLegError(inviteError, rtcPeerConnController);
 		}
 	}
 	get RTCPeerConnectionConfig() {
@@ -6606,7 +6876,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		this._rtcPeerConnectionsMap.set(rtcPeerConnController.id, rtcPeerConnController);
 		this._rtcPeerConnections$.next(Array.from(this._rtcPeerConnectionsMap.values()));
 		this.subscribeTo(rtcPeerConnController.errors$, (error) => {
-			this.onError?.(error);
+			this.reportLegError(error, rtcPeerConnController);
 		});
 		if (options.initOffer) this.handleInboundAnswer(rtcPeerConnController);
 	}
@@ -6635,7 +6905,7 @@ var WebRTCVertoManager = class extends VertoManager {
 				await rtcPeerConnController.acceptInbound(answerOptions);
 			} catch (error) {
 				logger$16.error("[WebRTCManager] Error creating inbound answer:", error);
-				this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
+				this.reportLegError(toError(error), rtcPeerConnController);
 			}
 		}
 	}
@@ -6739,7 +7009,7 @@ var WebRTCVertoManager = class extends VertoManager {
 				await this.attachManager.attach(this.buildAttachableCall());
 			} catch (error) {
 				logger$16.error("[WebRTCManager] Error sending Verto answer:", error);
-				this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
+				this.reportLegError(toError(error), rtcPeerConnectionController);
 				await rtcPeerConnectionController.updateAnswerStatus({ status: "failed" });
 			}
 		}
@@ -6811,7 +7081,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			await this.mainPeerConnection.restoreTrackSender(deviceKind);
 		} else {
 			const error = new require_operators.InvalidParams("No valid device to be added");
-			this.onError?.(error);
+			this.reportLegError(error, this.mainPeerConnection);
 			throw error;
 		}
 	}
@@ -6836,21 +7106,30 @@ var WebRTCVertoManager = class extends VertoManager {
 			this._rtcPeerConnections$.next(Array.from(this._rtcPeerConnectionsMap.values()));
 			this.subscribeTo(rtcPeerConnController.errors$, (error) => {
 				firstPeerConnectionError ??= error;
-				this.onError?.(error, { fatal: false });
+				this.reportLegError(error, rtcPeerConnController);
 			});
-			await (0, rxjs.firstValueFrom)(rtcPeerConnController.connectionState$.pipe((0, rxjs.filter)((state) => state === "connected"), (0, rxjs.take)(1), (0, rxjs.timeout)(this._screenShareTimeoutMs), (0, rxjs.takeUntil)(this.destroyed$)));
+			const pc = rtcPeerConnController;
+			await (0, rxjs.firstValueFrom)((0, rxjs.merge)(pc.localMediaSettled$.pipe((0, rxjs.take)(1), (0, rxjs.switchMap)(() => pc.connectionState$.pipe((0, rxjs.filter)((state) => state === "connected"), (0, rxjs.take)(1), (0, rxjs.timeout)(require_operators.DEFAULT_AUX_LEG_CONNECT_TIMEOUT_MS)))), this.legError$(pc.id)).pipe((0, rxjs.takeUntil)(this.destroyed$)));
 			if (isScreenShare) this._screenShareStatus$.next("started");
 			logger$16.info(`[WebRTCManager] Additional peer connection connected (${propose}).`);
 			return rtcPeerConnController.id;
 		} catch (error) {
 			logger$16.warn("[WebRTCManager] Error initializing additional peer connection:", error);
-			if (rtcPeerConnController) rtcPeerConnController.destroy();
-			if (isScreenShare) this._screenShareStatus$.next("none");
+			if (rtcPeerConnController) {
+				rtcPeerConnController.destroy();
+				this._rtcPeerConnectionsMap.delete(rtcPeerConnController.id);
+				this._rtcPeerConnections$.next(Array.from(this._rtcPeerConnectionsMap.values()));
+			}
+			if (isScreenShare) {
+				this._screenShareStatus$.next("none");
+				this._screenShareId = void 0;
+			}
 			if (firstPeerConnectionError) throw firstPeerConnectionError instanceof require_operators.MediaAccessError && firstPeerConnectionError.originalError instanceof Error ? firstPeerConnectionError.originalError : firstPeerConnectionError;
 			if (error instanceof rxjs.EmptyError) {
 				logger$16.debug("[WebRTCManager] Additional peer connection aborted before connecting.");
 				return;
 			}
+			if (error instanceof rxjs.TimeoutError) throw new require_operators.AuxiliaryLegTimeoutError(propose, error);
 			throw error instanceof Error ? error : new Error(String(error), { cause: error });
 		}
 	}
@@ -6896,7 +7175,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			await this.executeVerto(VertoBye({
 				...causeParams,
 				dialogParams: this.dialogParams(rtcPeerConnController)
-			}));
+			}), { callID: rtcPeerConnController.id });
 		} catch (error) {
 			logger$16.warn("[WebRTCManager] Call might already be disconnected, error sending Verto bye:", error);
 			throw error;
@@ -8290,13 +8569,13 @@ var WebRTCCall = class extends Destroyable {
 	get bandwidthConstrained$() {
 		return this.deferEmission(this._bandwidthConstrained$.asObservable());
 	}
-	/** Observable that emits when server-pushed media params are applied. */
+	/** Observable that emits when the server pushes media params. */
 	get mediaParamsUpdated$() {
 		return this.deferEmission(this._mediaParamsUpdated$.asObservable());
 	}
 	/**
 	* @internal Emit a media params update event.
-	* Called by the VertoManager when server-pushed media params are applied.
+	* Called by the VertoManager when the server pushes media params.
 	*/
 	emitMediaParamsUpdated(event) {
 		this._mediaParamsUpdated$.next(event);
@@ -8504,6 +8783,10 @@ var WebRTCCall = class extends Destroyable {
 	get selfId$() {
 		return this.vertoManager.selfId$;
 	}
+	/** @internal Lets call creation bound the media and signalling phases apart. */
+	get localMediaSettled$() {
+		return this.vertoManager.localMediaSettled$;
+	}
 	/** Local participant's member ID, or `null` if not joined. */
 	get selfId() {
 		return this.vertoManager.selfId;
@@ -8899,6 +9182,9 @@ var WebRTCCall = class extends Destroyable {
 /**
 * Infers the semantic error category from a raw Error thrown by VertoManager
 * or an RTCPeerConnection layer.
+*
+* Pure function — exported for unit testing.
+* @internal
 */
 function inferCallErrorKind(error) {
 	if (error instanceof require_operators.RPCTimeoutError) return "timeout";
@@ -8917,7 +9203,14 @@ const RECOVERABLE_RPC_CODES = new Set([
 	require_operators.RPC_ERROR_AUTHENTICATION_FAILED,
 	require_operators.RPC_ERROR_INVALID_PARAMS
 ]);
-/** Determines whether an error should be fatal (destroy the call). */
+/**
+* A *fallback*: callers knowing which leg failed pass an explicit `fatal` and
+* never reach here, so the default-fatal branch only sees call- and main-leg
+* errors. Auxiliary legs go through `WebRTCVertoManager.reportLegError`.
+*
+* Pure function — exported for unit testing.
+* @internal
+*/
 function isFatalError(error) {
 	if (error instanceof require_operators.VertoPongError) return false;
 	if (error instanceof require_operators.MediaTrackError) return false;
@@ -8952,7 +9245,9 @@ var CallFactory = class {
 								kind: inferCallErrorKind(error),
 								fatal: options$1?.fatal ?? isFatalError(error),
 								error,
-								callId: callInstance.id
+								callId: callInstance.id,
+								...options$1?.leg ? { leg: options$1.leg } : {},
+								...options$1?.legId ? { legId: options$1.legId } : {}
 							};
 							callInstance.emitError(callError);
 						},
@@ -9420,6 +9715,30 @@ const logger$9 = require_operators.getLogger();
 function shouldAbortDial(callError) {
 	return callError.fatal || !(callError.error instanceof require_operators.MediaAccessError);
 }
+/**
+* Wait for a dialed call to be ready, or for the failure that stops it.
+*
+* Local media acquisition is deliberately unbounded: a permission prompt or a
+* device picker is human time, and `getUserMedia` cannot be cancelled anyway.
+* The clock starts only once acquisition settles, so a slow human never spends
+* the server's budget.
+*
+* `merge` rather than `race`, because the two legs settle asymmetrically. A
+* fatal acquisition failure reports the error and then destroys the call in the
+* same synchronous step; `errors$` defers delivery by a microtask while
+* `localMediaSettled$` completes immediately. Under `race` that bare completion
+* ended the wait first and `dial()` rejected with an RxJS `EmptyError`, burying
+* the `NotAllowedError` applications are told to inspect. Under `merge` the
+* completed leg is simply spent, and the queued error — enqueued before the
+* completion, so delivered before it — arrives to reject the wait. A dial
+* abandoned with no error at all still ends both legs, and the resulting
+* `EmptyError` remains the benign-cancel signal.
+*
+* Exported for unit testing.
+*/
+async function awaitDialReady(session, signalingTimeoutMs) {
+	return (0, rxjs.firstValueFrom)((0, rxjs.merge)(session.localMediaSettled$.pipe((0, rxjs.take)(1), (0, rxjs.switchMap)(() => session.selfId$.pipe((0, rxjs.filter)((id) => Boolean(id)), (0, rxjs.take)(1), (0, rxjs.timeout)(signalingTimeoutMs)))), session.errors$.pipe((0, rxjs.filter)(shouldAbortDial), (0, rxjs.take)(1), (0, rxjs.switchMap)((callError) => (0, rxjs.throwError)(() => callError.error)))));
+}
 const getAddressSearchURI = (options) => {
 	const to = options.to?.split("?")[0];
 	const from$8 = options.from?.startsWith("subscriber://") ? options.from.replace("subscriber://", "") : options.from;
@@ -9436,7 +9755,6 @@ var ClientSessionManager = class extends Destroyable {
 		this.authorizationStateKey = authorizationStateKey;
 		this.attachManager = attachManager;
 		this.dpopManager = dpopManager;
-		this.callCreateTimeout = 6e3;
 		this.agent = `signalwire-js/4.0.0`;
 		this.eventAcks = true;
 		this.authorizationState$ = this.createReplaySubject(1);
@@ -9864,7 +10182,7 @@ var ClientSessionManager = class extends Destroyable {
 				to: destinationURI,
 				...options
 			});
-			await (0, rxjs.firstValueFrom)((0, rxjs.race)(callSession.selfId$.pipe((0, rxjs.filter)((id) => Boolean(id)), (0, rxjs.take)(1), (0, rxjs.timeout)(this.callCreateTimeout)), callSession.errors$.pipe((0, rxjs.filter)(shouldAbortDial), (0, rxjs.take)(1), (0, rxjs.switchMap)((callError) => (0, rxjs.throwError)(() => callError.error)))));
+			await awaitDialReady(callSession, require_operators.DEFAULT_CALL_SIGNALING_TIMEOUT_MS);
 			this._calls$.next({
 				[`${callSession.id}`]: callSession,
 				...this._calls$.value
@@ -12036,6 +12354,11 @@ var SignalWire = class extends Destroyable {
 	* Returns a {@link Call} in `'ringing'` state. Subscribe to {@link Call.status$}
 	* to track progression through `'connected'` → `'disconnected'`.
 	*
+	* Local media acquisition is deliberately unbounded: an unanswered permission
+	* prompt leaves this promise pending indefinitely, so apply your own bound if
+	* your UI needs one. The 12 s signaling budget starts only once acquisition
+	* settles.
+	*
 	* @param destination - Address URI string (e.g. `'/public/my-room'`) or {@link Address} instance.
 	* @param options - Media and dial options (audio/video, device constraints). Overrides defaults.
 	* @returns The created {@link Call} instance.
@@ -12498,6 +12821,7 @@ emitReadyEvent();
 
 //#endregion
 exports.Address = Address;
+exports.AuxiliaryLegTimeoutError = require_operators.AuxiliaryLegTimeoutError;
 exports.CallCreateError = require_operators.CallCreateError;
 exports.CallNotReadyError = require_operators.CallNotReadyError;
 exports.ClientPreferences = ClientPreferences;