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

package/dist/browser.mjs

@@ -4186,7 +4186,7 @@ var require_merge$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var empty_1$7 = require_empty();
 	var args_1$8 = require_args();
 	var from_1$4 = require_from();
-	function merge$6() {
+	function merge$7() {
 		var args = [];
 		for (var _i = 0; _i < arguments.length; _i++) args[_i] = arguments[_i];
 		var scheduler = args_1$8.popScheduler(args);
@@ -4194,7 +4194,7 @@ var require_merge$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 		var sources = args;
 		return !sources.length ? empty_1$7.EMPTY : sources.length === 1 ? innerFrom_1$31.innerFrom(sources[0]) : mergeAll_1$3.mergeAll(concurrent)(from_1$4.from(sources, scheduler));
 	}
-	exports.merge = merge$6;
+	exports.merge = merge$7;
 }));
 
 //#endregion
@@ -4325,13 +4325,13 @@ var require_race$1 = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var innerFrom_1$28 = require_innerFrom();
 	var argsOrArgArray_1$4 = require_argsOrArgArray();
 	var OperatorSubscriber_1$48 = require_OperatorSubscriber();
-	function race$5() {
+	function race$4() {
 		var sources = [];
 		for (var _i = 0; _i < arguments.length; _i++) sources[_i] = arguments[_i];
 		sources = argsOrArgArray_1$4.argsOrArgArray(sources);
 		return sources.length === 1 ? innerFrom_1$28.innerFrom(sources[0]) : new Observable_1$6.Observable(raceInit(sources));
 	}
-	exports.race = race$5;
+	exports.race = race$4;
 	function raceInit(sources) {
 		return function(subscriber) {
 			var subscriptions = [];
@@ -6076,7 +6076,7 @@ var require_merge = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var mergeAll_1$2 = require_mergeAll();
 	var args_1$3 = require_args();
 	var from_1$1 = require_from();
-	function merge$5() {
+	function merge$6() {
 		var args = [];
 		for (var _i = 0; _i < arguments.length; _i++) args[_i] = arguments[_i];
 		var scheduler = args_1$3.popScheduler(args);
@@ -6085,7 +6085,7 @@ var require_merge = /* @__PURE__ */ __commonJSMin(((exports) => {
 			mergeAll_1$2.mergeAll(concurrent)(from_1$1.from(__spreadArray$8([source], __read$8(args)), scheduler)).subscribe(subscriber);
 		});
 	}
-	exports.merge = merge$5;
+	exports.merge = merge$6;
 }));
 
 //#endregion
@@ -6932,7 +6932,7 @@ var require_switchMap = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var innerFrom_1$6 = require_innerFrom();
 	var lift_1$13 = require_lift();
 	var OperatorSubscriber_1$11 = require_OperatorSubscriber();
-	function switchMap$7(project, resultSelector) {
+	function switchMap$8(project, resultSelector) {
 		return lift_1$13.operate(function(source, subscriber) {
 			var innerSubscriber = null;
 			var index = 0;
@@ -6956,7 +6956,7 @@ var require_switchMap = /* @__PURE__ */ __commonJSMin(((exports) => {
 			}));
 		});
 	}
-	exports.switchMap = switchMap$7;
+	exports.switchMap = switchMap$8;
 }));
 
 //#endregion
@@ -9022,6 +9022,25 @@ const DEFAULT_ICE_CANDIDATE_TIMEOUT_MS = 600;
 const DEFAULT_ICE_GATHERING_TIMEOUT_MS = 6e3;
 const DEFAULT_RECONNECT_CALLS_TIMEOUT_MS = 300 * 1e3;
 const DEFAULT_CONNECTION_TIMEOUT_MS = 1e4;
+/**
+* How long call setup may wait for the network, measured from local media
+* settling until the member id arrives.
+*
+* Local media acquisition is deliberately NOT inside this: a permission prompt
+* or a device picker is human time, and a human may take as long as they like
+* without spending the server's budget. The clock starts when acquisition ends.
+*
+* Must exceed `iceGatheringTimeout + the RPC timeout`, which both run inside it.
+*/
+const DEFAULT_CALL_SIGNALING_TIMEOUT_MS = 12e3;
+/**
+* How long an auxiliary leg (screen share, additional device) may take to
+* connect once its media is in hand.
+*
+* One bound for both: the picker is human time and sits outside it. What remains
+* — offer, ICE, invite, answer, DTLS — is the same work for either leg kind.
+*/
+const DEFAULT_AUX_LEG_CONNECT_TIMEOUT_MS = 15e3;
 const DEFAULT_RECONNECT_DELAY_MIN_MS = 100;
 const DEFAULT_RECONNECT_DELAY_MAX_MS = 3e3;
 const DEFAULT_DEVICE_DEBOUNCE_TIME_MS = 1500;
@@ -9374,6 +9393,18 @@ var CollectionFetchError = class extends Error {
 		this.name = "CollectionFetchError";
 	}
 };
+/**
+* An auxiliary leg did not connect within its budget. Typed rather than a bare
+* RxJS `TimeoutError` so the leg and cause survive.
+*/
+var AuxiliaryLegTimeoutError = class extends Error {
+	constructor(leg, originalError) {
+		super(`Timed out waiting for the ${leg} connection to be established`, { cause: originalError });
+		this.leg = leg;
+		this.originalError = originalError;
+		this.name = "AuxiliaryLegTimeoutError";
+	}
+};
 var MediaTrackError = class extends Error {
 	constructor(operation, kind, originalError) {
 		super(`Media track ${operation} failed for ${kind}`, { cause: originalError instanceof Error ? originalError : void 0 });
@@ -9410,6 +9441,22 @@ var MediaAccessError = class extends Error {
 		return isMediaAccessDenial(this.originalError);
 	}
 };
+/**
+* Thrown by `startScreenShare()` when the call is already sharing a screen.
+*
+* A call carries at most one screen share. Accepting a second one would
+* overwrite the only reference the SDK holds to the first, leaving it
+* capturing and sending with no way to stop it — so the second request is
+* rejected and the live share is left untouched. Call `stopScreenShare()`
+* first to replace it.
+*/
+var ScreenShareAlreadyActiveError = class extends Error {
+	constructor(screenShareId, options) {
+		super(`A screen share is already active on this call (${screenShareId}). Call stopScreenShare() before starting another one.`, options);
+		this.screenShareId = screenShareId;
+		this.name = "ScreenShareAlreadyActiveError";
+	}
+};
 var DPoPInitError = class extends Error {
 	constructor(originalError, message = "Failed to initialize DPoP key pair") {
 		super(message, { cause: originalError instanceof Error ? originalError : void 0 });
@@ -9650,9 +9697,9 @@ var require_loglevel = /* @__PURE__ */ __commonJSMin(((exports, module) => {
 		defaultLogger$1 = new Logger();
 		defaultLogger$1.getLogger = function getLogger$1(name) {
 			if (typeof name !== "symbol" && typeof name !== "string" || name === "") throw new TypeError("You must supply a name when creating a logger.");
-			var logger$33 = _loggersByName[name];
-			if (!logger$33) logger$33 = _loggersByName[name] = new Logger(name, defaultLogger$1.methodFactory);
-			return logger$33;
+			var logger$34 = _loggersByName[name];
+			if (!logger$34) logger$34 = _loggersByName[name] = new Logger(name, defaultLogger$1.methodFactory);
+			return logger$34;
 		};
 		var _log = typeof window !== undefinedType ? window.log : void 0;
 		defaultLogger$1.noConflict = function() {
@@ -9688,8 +9735,8 @@ const defaultLoggerLevel = defaultLogger.levels.WARN;
 defaultLogger.setLevel(defaultLoggerLevel);
 let userLogger = null;
 /** Replace the built-in logger with a custom implementation. Pass `null` to restore defaults. */
-const setLogger = (logger$33) => {
-	userLogger = logger$33;
+const setLogger = (logger$34) => {
+	userLogger = logger$34;
 };
 let debugOptions = {};
 /** Configure debug options (e.g., `{ logWsTraffic: true }`). */
@@ -9733,8 +9780,8 @@ const wsTraffic = (options) => {
 	loggerInstance.debug(`${options.type.toUpperCase()}: \n`, msg, "\n");
 };
 const getLogger = () => {
-	const logger$33 = getLoggerInstance();
-	return new Proxy(logger$33, { get(_target, prop, _receiver) {
+	const logger$34 = getLoggerInstance();
+	return new Proxy(logger$34, { get(_target, prop, _receiver) {
 		if (prop === "wsTraffic") return wsTraffic;
 		const instance = getLoggerInstance();
 		const value = Reflect.get(instance, prop);
@@ -9786,7 +9833,7 @@ const asyncRetry = async ({ asyncCallable, maxRetries: retries = DEFAULT_MAX_RET
 
 //#endregion
 //#region src/controllers/HTTPRequestController.ts
-const logger$32 = getLogger();
+const logger$33 = getLogger();
 const GET_PARAMS = {
 	method: "GET",
 	headers: { Accept: "application/json" }
@@ -9850,7 +9897,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 			this._responses$.next(response);
 			return response;
 		} catch (error) {
-			logger$32.error("[HTTPRequestController] Request error:", error);
+			logger$33.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);
@@ -9877,7 +9924,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 		const url = this.buildURL(request.url);
 		const headers = this.buildHeaders(request.headers);
 		const timeout$5 = request.timeout ?? this.requestTimeout;
-		logger$32.debug("[HTTPRequestController] Executing request:", {
+		logger$33.debug("[HTTPRequestController] Executing request:", {
 			method: request.method,
 			url,
 			headers: Object.keys(headers).reduce((acc, key) => {
@@ -9897,7 +9944,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 			});
 			clearTimeout(timeoutId);
 			const httpResponse = await this.convertResponse(response);
-			logger$32.debug("[HTTPRequestController] Response received:", {
+			logger$33.debug("[HTTPRequestController] Response received:", {
 				status: response.status,
 				statusText: response.statusText,
 				headers: [...response.headers.entries()],
@@ -9907,7 +9954,7 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 		} catch (error) {
 			clearTimeout(timeoutId);
 			if (error instanceof Error && error.name === "AbortError") throw new RequestTimeoutError(`Request timeout after ${timeout$5}ms`, { cause: error });
-			logger$32.error("[HTTPRequestController] Request failed:", error);
+			logger$33.error("[HTTPRequestController] Request failed:", error);
 			throw error;
 		}
 	}
@@ -9921,8 +9968,8 @@ var HTTPRequestController = class HTTPRequestController extends Destroyable {
 		const credential = this.getCredential();
 		if (credential.token) {
 			headers.Authorization = `Bearer ${credential.token}`;
-			logger$32.debug("[HTTPRequestController] Using Bearer token auth, token length:", credential.token.length);
-		} else logger$32.warn("[HTTPRequestController] No credentials available for authentication");
+			logger$33.debug("[HTTPRequestController] Using Bearer token auth, token length:", credential.token.length);
+		} else logger$33.warn("[HTTPRequestController] No credentials available for authentication");
 		return headers;
 	}
 	/**
@@ -10070,7 +10117,7 @@ function fromMsToSec(milliseconds) {
 
 //#endregion
 //#region src/containers/PreferencesContainer.ts
-const logger$31 = getLogger();
+const logger$32 = getLogger();
 var PreferencesContainer = class PreferencesContainer {
 	static get instance() {
 		this._instance ??= new PreferencesContainer();
@@ -10732,7 +10779,7 @@ var ClientPreferences = class {
 		if (!this._storage) return;
 		const data = collectStoredPreferences();
 		this._storage.setItem(PREFERENCES_STORAGE_KEY, data, "local").catch((error) => {
-			logger$31.error(`[ClientPreferences] Failed to save preferences: ${String(error)}`);
+			logger$32.error(`[ClientPreferences] Failed to save preferences: ${String(error)}`);
 		});
 	}
 	/** Loads preferences from storage and applies them to the container. */
@@ -10741,7 +10788,7 @@ var ClientPreferences = class {
 		this._storage.getItem(PREFERENCES_STORAGE_KEY, "local").then((stored) => {
 			if (stored) applyStoredPreferences(stored);
 		}).catch((error) => {
-			logger$31.error(`[ClientPreferences] Failed to load preferences: ${String(error)}`);
+			logger$32.error(`[ClientPreferences] Failed to load preferences: ${String(error)}`);
 		});
 	}
 };
@@ -10763,7 +10810,7 @@ function toError(value) {
 //#endregion
 //#region src/controllers/NavigatorDeviceController.ts
 var import_cjs$29 = require_cjs();
-const logger$30 = getLogger();
+const logger$31 = getLogger();
 /** Maps a device kind to its storage key. */
 const DEVICE_STORAGE_KEYS = {
 	audioinput: DEVICE_STORAGE_KEY_AUDIO_INPUT,
@@ -10785,7 +10832,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		super();
 		this.webRTCApiProvider = webRTCApiProvider;
 		this.deviceChangeHandler = () => {
-			logger$30.debug("[DeviceController] Device change detected");
+			logger$31.debug("[DeviceController] Device change detected");
 			this.enumerateDevices();
 		};
 		this._devicesState$ = this.createBehaviorSubject(initialDevicesState);
@@ -10850,13 +10897,13 @@ var NavigatorDeviceController = class extends Destroyable {
 		return this.cachedObservable("videoInputDevices$", () => this._devicesState$.pipe((0, import_cjs$29.map)((state) => state.videoinput), (0, import_cjs$29.distinctUntilChanged)(), (0, import_cjs$29.takeUntil)(this.destroyed$)));
 	}
 	get selectedAudioInputDevice$() {
-		return this.cachedObservable("selectedAudioInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, import_cjs$29.map)((state) => state.audioinput), (0, import_cjs$29.distinctUntilChanged)(), (0, import_cjs$29.takeUntil)(this.destroyed$), (0, import_cjs$29.tap)((info) => logger$30.debug("[DeviceController] Selected audio input device changed:", info))));
+		return this.cachedObservable("selectedAudioInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, import_cjs$29.map)((state) => state.audioinput), (0, import_cjs$29.distinctUntilChanged)(), (0, import_cjs$29.takeUntil)(this.destroyed$), (0, import_cjs$29.tap)((info) => logger$31.debug("[DeviceController] Selected audio input device changed:", info))));
 	}
 	get selectedAudioOutputDevice$() {
-		return this.cachedObservable("selectedAudioOutputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, import_cjs$29.map)((state) => state.audiooutput), (0, import_cjs$29.distinctUntilChanged)(), (0, import_cjs$29.takeUntil)(this.destroyed$), (0, import_cjs$29.tap)((info) => logger$30.debug("[DeviceController] Selected audio output device changed:", info))));
+		return this.cachedObservable("selectedAudioOutputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, import_cjs$29.map)((state) => state.audiooutput), (0, import_cjs$29.distinctUntilChanged)(), (0, import_cjs$29.takeUntil)(this.destroyed$), (0, import_cjs$29.tap)((info) => logger$31.debug("[DeviceController] Selected audio output device changed:", info))));
 	}
 	get selectedVideoInputDevice$() {
-		return this.cachedObservable("selectedVideoInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, import_cjs$29.map)((state) => state.videoinput), (0, import_cjs$29.distinctUntilChanged)(), (0, import_cjs$29.takeUntil)(this.destroyed$), (0, import_cjs$29.tap)((info) => logger$30.debug("[DeviceController] Selected video input device changed:", info))));
+		return this.cachedObservable("selectedVideoInputDevice$", () => this._selectedDevicesState$.asObservable().pipe((0, import_cjs$29.map)((state) => state.videoinput), (0, import_cjs$29.distinctUntilChanged)(), (0, import_cjs$29.takeUntil)(this.destroyed$), (0, import_cjs$29.tap)((info) => logger$31.debug("[DeviceController] Selected video input device changed:", info))));
 	}
 	get selectedAudioInputDevice() {
 		if (this._audioInputDisabled$.value) return null;
@@ -10931,7 +10978,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		if (device) this.persistDeviceSelection("audioinput", device);
 	}
 	selectVideoInputDevice(device) {
-		logger$30.debug("[DeviceController] Setting selected video input device:", device);
+		logger$31.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);
@@ -10988,7 +11035,7 @@ var NavigatorDeviceController = class extends Destroyable {
 			}
 			const fromHistory = this._deviceHistory.findInHistory(kind, devices);
 			if (fromHistory) {
-				logger$30.debug(`[DeviceController] Device disappeared, falling back to history: ${fromHistory.label}`);
+				logger$31.debug(`[DeviceController] Device disappeared, falling back to history: ${fromHistory.label}`);
 				this.emitDeviceRecovered(kind, selected, fromHistory, "device_disconnected");
 				return fromHistory;
 			}
@@ -11041,7 +11088,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		try {
 			await this._storageManager.setItem(DEVICE_STORAGE_KEYS[kind], stored, "local");
 		} catch (error) {
-			logger$30.error(`[DeviceController] Failed to persist device selection for ${kind}:`, error);
+			logger$31.error(`[DeviceController] Failed to persist device selection for ${kind}:`, error);
 		}
 	}
 	async loadPersistedDevices() {
@@ -11057,7 +11104,7 @@ var NavigatorDeviceController = class extends Destroyable {
 				[kind]: stored
 			};
 		} catch (error) {
-			logger$30.error(`[DeviceController] Failed to load persisted device for ${kind}:`, error);
+			logger$31.error(`[DeviceController] Failed to load persisted device for ${kind}:`, error);
 		}
 	}
 	/** Clears device history, persisted selections, and re-enumerates devices. */
@@ -11075,7 +11122,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		this.disableDeviceMonitoring();
 		this.webRTCApiProvider.mediaDevices.addEventListener("devicechange", this.deviceChangeHandler);
 		if (PreferencesContainer.instance.devicePollingInterval > 0) this._devicesPoolingSubscription = (0, import_cjs$29.interval)(PreferencesContainer.instance.devicePollingInterval).subscribe(() => {
-			logger$30.debug("[DeviceController] Polling devices due to interval");
+			logger$31.debug("[DeviceController] Polling devices due to interval");
 			this.enumerateDevices();
 		});
 		this.enumerateDevices();
@@ -11101,13 +11148,13 @@ var NavigatorDeviceController = class extends Destroyable {
 				videoinput: []
 			});
 			this._devicesState$.next(devicesByKind);
-			logger$30.debug("[DeviceController] Devices enumerated:", {
+			logger$31.debug("[DeviceController] Devices enumerated:", {
 				audioInputs: devicesByKind.audioinput.length,
 				audioOutputs: devicesByKind.audiooutput.length,
 				videoInputs: devicesByKind.videoinput.length
 			});
 		} catch (error) {
-			logger$30.error("[DeviceController] Failed to enumerate devices:", error);
+			logger$31.error("[DeviceController] Failed to enumerate devices:", error);
 			this._errors$.next(toError(error));
 		}
 	}
@@ -11123,7 +11170,7 @@ var NavigatorDeviceController = class extends Destroyable {
 			stream.getTracks().forEach((t) => t.stop());
 			return capabilities;
 		} catch (error) {
-			logger$30.error("[DeviceController] Failed to get device capabilities:", error);
+			logger$31.error("[DeviceController] Failed to get device capabilities:", error);
 			this._errors$.next(toError(error));
 			throw error;
 		}
@@ -11374,7 +11421,7 @@ var DependencyContainer = class {
 
 //#endregion
 //#region src/controllers/CryptoController.ts
-const logger$29 = getLogger();
+const logger$30 = getLogger();
 const DPOP_DB_NAME = "sw-dpop";
 const DPOP_DB_VERSION = 1;
 const DPOP_STORE_NAME = "keys";
@@ -11433,7 +11480,7 @@ async function loadKeyPairFromDB() {
 			tx.oncomplete = () => db.close();
 		});
 	} catch (error) {
-		logger$29.warn("[DPoP] Failed to load key pair from IndexedDB:", error);
+		logger$30.warn("[DPoP] Failed to load key pair from IndexedDB:", error);
 		return null;
 	}
 }
@@ -11453,7 +11500,7 @@ async function saveKeyPairToDB(keyPair) {
 			};
 		});
 	} catch (error) {
-		logger$29.warn("[DPoP] Failed to save key pair to IndexedDB:", error);
+		logger$30.warn("[DPoP] Failed to save key pair to IndexedDB:", error);
 	}
 }
 async function deleteKeyPairFromDB() {
@@ -11472,7 +11519,7 @@ async function deleteKeyPairFromDB() {
 			};
 		});
 	} catch (error) {
-		logger$29.warn("[DPoP] Failed to delete key pair from IndexedDB:", error);
+		logger$30.warn("[DPoP] Failed to delete key pair from IndexedDB:", error);
 	}
 }
 /**
@@ -11532,13 +11579,13 @@ var CryptoController = class {
 			this._publicJwk = await crypto.subtle.exportKey("jwk", stored.publicKey);
 			this._fingerprint = await computeJwkThumbprint(this._publicJwk);
 			this._initialized = true;
-			logger$29.debug("[DPoP] Key pair restored from IndexedDB, fingerprint:", this._fingerprint);
+			logger$30.debug("[DPoP] Key pair restored from IndexedDB, fingerprint:", this._fingerprint);
 			return this._fingerprint;
 		} catch (error) {
-			logger$29.warn("[DPoP] Stored key pair unusable, generating new one:", error);
+			logger$30.warn("[DPoP] Stored key pair unusable, generating new one:", error);
 			await deleteKeyPairFromDB();
 		}
-		logger$29.debug("[DPoP] Generating RSA key pair");
+		logger$30.debug("[DPoP] Generating RSA key pair");
 		this._keyPair = await crypto.subtle.generateKey({
 			name: "RSASSA-PKCS1-v1_5",
 			modulusLength: 2048,
@@ -11553,7 +11600,7 @@ var CryptoController = class {
 		this._fingerprint = await computeJwkThumbprint(this._publicJwk);
 		this._initialized = true;
 		await saveKeyPairToDB(this._keyPair);
-		logger$29.debug("[DPoP] Key pair generated and persisted, fingerprint:", this._fingerprint);
+		logger$30.debug("[DPoP] Key pair generated and persisted, fingerprint:", this._fingerprint);
 		return this._fingerprint;
 	}
 	/**
@@ -11619,7 +11666,7 @@ var CryptoController = class {
 		this._fingerprint = null;
 		this._initialized = false;
 		deleteKeyPairFromDB();
-		logger$29.debug("[DPoP] Controller destroyed");
+		logger$30.debug("[DPoP] Controller destroyed");
 	}
 	get publicJwk() {
 		if (!this._publicJwk) throw new DPoPInitError("CryptoController not initialized. Call init() first.");
@@ -11643,7 +11690,7 @@ var CryptoController = class {
 //#endregion
 //#region src/controllers/NetworkMonitor.ts
 var import_cjs$28 = require_cjs();
-const logger$28 = getLogger();
+const logger$29 = getLogger();
 /**
 * Safely check whether we are running in a browser environment
 * with `window` and the relevant event targets.
@@ -11700,7 +11747,7 @@ var NetworkMonitor = class extends Destroyable {
 	}
 	attachListeners() {
 		if (!hasBrowserNetworkEvents()) {
-			logger$28.debug("NetworkMonitor: no browser environment detected, skipping event listeners");
+			logger$29.debug("NetworkMonitor: no browser environment detected, skipping event listeners");
 			return;
 		}
 		window.addEventListener("online", this._onOnline);
@@ -11708,7 +11755,7 @@ var NetworkMonitor = class extends Destroyable {
 		const connection = getNetworkConnection();
 		if (connection) connection.addEventListener("change", this._onConnectionChange);
 		this._listenersAttached = true;
-		logger$28.debug("NetworkMonitor: event listeners attached");
+		logger$29.debug("NetworkMonitor: event listeners attached");
 	}
 	removeListeners() {
 		if (!this._listenersAttached) return;
@@ -11719,10 +11766,10 @@ var NetworkMonitor = class extends Destroyable {
 			if (connection) connection.removeEventListener("change", this._onConnectionChange);
 		}
 		this._listenersAttached = false;
-		logger$28.debug("NetworkMonitor: event listeners removed");
+		logger$29.debug("NetworkMonitor: event listeners removed");
 	}
 	handleOnline() {
-		logger$28.info("NetworkMonitor: browser went online");
+		logger$29.info("NetworkMonitor: browser went online");
 		this._isOnline$.next(true);
 		this._networkChange$.next({
 			type: "online",
@@ -11731,7 +11778,7 @@ var NetworkMonitor = class extends Destroyable {
 		});
 	}
 	handleOffline() {
-		logger$28.info("NetworkMonitor: browser went offline");
+		logger$29.info("NetworkMonitor: browser went offline");
 		this._isOnline$.next(false);
 		this._networkChange$.next({
 			type: "offline",
@@ -11740,7 +11787,7 @@ var NetworkMonitor = class extends Destroyable {
 	}
 	handleConnectionChange() {
 		const networkType = getNetworkType();
-		logger$28.info(`NetworkMonitor: connection changed — effectiveType=${networkType ?? "unknown"}`);
+		logger$29.info(`NetworkMonitor: connection changed — effectiveType=${networkType ?? "unknown"}`);
 		this._networkChange$.next({
 			type: "connection_change",
 			timestamp: Date.now(),
@@ -11856,7 +11903,7 @@ function getNavigatorMediaDevices() {
 //#endregion
 //#region src/controllers/PreflightRunner.ts
 var import_cjs$27 = require_cjs();
-const logger$27 = getLogger();
+const logger$28 = getLogger();
 const DEFAULT_MEDIA_TEST_DURATION_S = 10;
 const ICE_GATHERING_TIMEOUT_MS = 1e4;
 const SIGNALING_RTT_TIMEOUT_MS = 5e3;
@@ -11905,7 +11952,7 @@ var PreflightRunner = class extends Destroyable {
 			if (!this._options.skipMediaTest) try {
 				bandwidth = await this.testMediaBandwidth(destination);
 			} catch (error) {
-				logger$27.warn("[PreflightRunner] Media bandwidth test failed:", error);
+				logger$28.warn("[PreflightRunner] Media bandwidth test failed:", error);
 				warnings.push("Media bandwidth test failed");
 			}
 			return {
@@ -11917,7 +11964,7 @@ var PreflightRunner = class extends Destroyable {
 				warnings
 			};
 		} catch (error) {
-			logger$27.error("[PreflightRunner] Preflight test failed:", error);
+			logger$28.error("[PreflightRunner] Preflight test failed:", error);
 			throw new PreflightError("preflight", error instanceof Error ? error : new Error(String(error)));
 		} finally {
 			this.destroy();
@@ -11948,7 +11995,7 @@ var PreflightRunner = class extends Destroyable {
 				if (track.kind === "video" && track.readyState === "live") videoWorking = true;
 			}
 		} catch (error) {
-			logger$27.warn("[PreflightRunner] Device test failed:", error);
+			logger$28.warn("[PreflightRunner] Device test failed:", error);
 		} finally {
 			if (audioStream) audioStream.getTracks().forEach((t) => t.stop());
 		}
@@ -12006,7 +12053,7 @@ var PreflightRunner = class extends Destroyable {
 				rttMs
 			};
 		} catch (error) {
-			logger$27.warn("[PreflightRunner] ICE connectivity test failed:", error);
+			logger$28.warn("[PreflightRunner] ICE connectivity test failed:", error);
 			return {
 				type: "failed",
 				turnReachable: false,
@@ -12054,7 +12101,7 @@ var PreflightRunner = class extends Destroyable {
 //#endregion
 //#region src/controllers/VisibilityController.ts
 var import_cjs$26 = require_cjs();
-const logger$26 = getLogger();
+const logger$27 = getLogger();
 /**
 * Checks whether the document visibility API is available.
 */
@@ -12091,8 +12138,8 @@ var VisibilityController = class extends Destroyable {
 		this._boundHandler = this._handleVisibilityChange.bind(this);
 		if (this._hasVisibilityApi) {
 			document.addEventListener("visibilitychange", this._boundHandler);
-			logger$26.debug("VisibilityController: listening for visibilitychange events");
-		} else logger$26.debug("VisibilityController: document visibility API not available, defaulting to visible");
+			logger$27.debug("VisibilityController: listening for visibilitychange events");
+		} else logger$27.debug("VisibilityController: document visibility API not available, defaulting to visible");
 	}
 	/**
 	* Observable of the current visibility state.
@@ -12117,7 +12164,7 @@ var VisibilityController = class extends Destroyable {
 	destroy() {
 		if (this._hasVisibilityApi) {
 			document.removeEventListener("visibilitychange", this._boundHandler);
-			logger$26.debug("VisibilityController: removed visibilitychange listener");
+			logger$27.debug("VisibilityController: removed visibilitychange listener");
 		}
 		super.destroy();
 	}
@@ -12135,7 +12182,7 @@ var VisibilityController = class extends Destroyable {
 			timestamp: Date.now()
 		};
 		this._visibilityChange$.next(changeEvent);
-		logger$26.debug("VisibilityController: visibility changed", {
+		logger$27.debug("VisibilityController: visibility changed", {
 			from: previousState,
 			to: newState
 		});
@@ -12417,7 +12464,7 @@ function isRequesterValidationError(error) {
 
 //#endregion
 //#region src/managers/AttachManager.ts
-const logger$25 = getLogger();
+const logger$26 = getLogger();
 var AttachManager = class {
 	constructor(storage, deviceController, reconnectCallsTimeout, attachKey, credentialRecovered) {
 		this.storage = storage;
@@ -12439,7 +12486,7 @@ var AttachManager = class {
 		try {
 			return await this.storage.getItem(this.attachKey) ?? {};
 		} catch (error) {
-			logger$25.warn("[AttachManager] Failed to retrieve attached calls from storage", error);
+			logger$26.warn("[AttachManager] Failed to retrieve attached calls from storage", error);
 			return {};
 		}
 	}
@@ -12447,7 +12494,7 @@ var AttachManager = class {
 		try {
 			await this.storage.setItem(this.attachKey, attached);
 		} catch (error) {
-			logger$25.warn("[AttachManager] Failed to write attached calls to storage", error);
+			logger$26.warn("[AttachManager] Failed to write attached calls to storage", error);
 		}
 	}
 	/**
@@ -12466,7 +12513,7 @@ var AttachManager = class {
 	}
 	async attach(call) {
 		if (!call.to) {
-			logger$25.warn("[AttachManager] Skip attach for calls with no destination");
+			logger$26.warn("[AttachManager] Skip attach for calls with no destination");
 			return;
 		}
 		const destination = call.to;
@@ -12526,25 +12573,25 @@ var AttachManager = class {
 					callId,
 					...options
 				});
-				logger$25.info(`[AttachManager] Reattached call ${callId} (attempt ${attempt})`);
+				logger$26.info(`[AttachManager] Reattached call ${callId} (attempt ${attempt})`);
 				succeeded = true;
 				break;
 			} catch (error) {
-				logger$25.warn(`[AttachManager] Reattach attempt ${attempt}/3 failed for call ${callId}:`, error);
+				logger$26.warn(`[AttachManager] Reattach attempt ${attempt}/3 failed for call ${callId}:`, error);
 				if (isRequesterValidationError(error)) {
 					refusedOnCredentials = true;
-					logger$25.warn(`[AttachManager] Reattach of ${callId} was refused on credentials; not retrying.`);
+					logger$26.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$25.warn(`[AttachManager] Reattach of ${callId} was denied after a verified reauthentication, removing reference`);
+				logger$26.warn(`[AttachManager] Reattach of ${callId} was denied after a verified reauthentication, removing reference`);
 				await this.detach({
 					id: callId,
 					mediaDirections: attachment.mediaDirections
 				});
-			} else logger$25.warn(`[AttachManager] Reattach failed for call ${callId}; keeping the reference (credential refused or never proven good)`);
+			} else logger$26.warn(`[AttachManager] Reattach failed for call ${callId}; keeping the reference (credential refused or never proven good)`);
 		}
 	}
 	/**
@@ -12645,12 +12692,12 @@ var require_race = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.race = void 0;
 	var argsOrArgArray_1 = require_argsOrArgArray();
 	var raceWith_1$1 = require_raceWith();
-	function race$4() {
+	function race$3() {
 		var args = [];
 		for (var _i = 0; _i < arguments.length; _i++) args[_i] = arguments[_i];
 		return raceWith_1$1.raceWith.apply(void 0, __spreadArray([], __read(argsOrArgArray_1.argsOrArgArray(args))));
 	}
-	exports.race = race$4;
+	exports.race = race$3;
 }));
 
 //#endregion
@@ -13710,7 +13757,7 @@ function toggleHandraiseMethod(is) {
 
 //#endregion
 //#region src/core/entities/Participant.ts
-const logger$24 = getLogger();
+const logger$25 = getLogger();
 const initialState = {};
 /**
 * Represents a participant in a call.
@@ -14182,8 +14229,16 @@ var SelfParticipant = class extends Participant {
 	/**
 	* Starts sharing the local screen.
 	*
+	* A call carries at most one screen share. Read `screenShareStatus` before
+	* calling and treat `'starting'`/`'stopping'` as busy.
+	*
 	* 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 {ScreenShareAlreadyActiveError} When this call is already
+	* sharing a screen. Call {@link stopScreenShare} before starting another.
 	* @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.
@@ -14192,7 +14247,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await this.vertoManager.addScreenMedia();
 		} catch (error) {
-			logger$24.error("[Participant.startScreenShare] Screen share error:", error);
+			logger$25.error("[Participant.startScreenShare] Screen share error:", error);
 			throw error;
 		}
 	}
@@ -14213,14 +14268,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$24.error("[Participant.addAdditionalDevice] Additional device error:", error);
+			logger$25.error("[Participant.addAdditionalDevice] Additional device error:", error);
 			throw error;
 		}
 	}
@@ -14283,7 +14342,7 @@ var SelfParticipant = class extends Participant {
 	*/
 	exitStudioModeIfActive() {
 		if (this._studioAudio$.value) {
-			logger$24.debug("[SelfParticipant] Exiting studio audio mode due to individual flag toggle");
+			logger$25.debug("[SelfParticipant] Exiting studio audio mode due to individual flag toggle");
 			this._studioAudio$.next(false);
 		}
 	}
@@ -14307,7 +14366,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.mute();
 		} catch (error) {
-			logger$24.warn("[Participant.toggleAudioInput] Server Error while muting audio input, proceeding with local toggle anyway", error);
+			logger$25.warn("[Participant.toggleAudioInput] Server Error while muting audio input, proceeding with local toggle anyway", error);
 		} finally {
 			this.vertoManager.muteMainAudioInputDevice();
 		}
@@ -14317,7 +14376,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.unmute();
 		} catch (error) {
-			logger$24.warn("[Participant.toggleAudioInput] Server Error while unmuting audio input, proceeding with local toggle anyway", error);
+			logger$25.warn("[Participant.toggleAudioInput] Server Error while unmuting audio input, proceeding with local toggle anyway", error);
 		} finally {
 			await this.vertoManager.unmuteMainAudioInputDevice();
 		}
@@ -14327,7 +14386,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.muteVideo();
 		} catch (error) {
-			logger$24.warn("[Participant.toggleVideoInput] Server Error while muting video input, proceeding with local toggle anyway", error);
+			logger$25.warn("[Participant.toggleVideoInput] Server Error while muting video input, proceeding with local toggle anyway", error);
 		} finally {
 			this.vertoManager.muteMainVideoInputDevice();
 		}
@@ -14337,7 +14396,7 @@ var SelfParticipant = class extends Participant {
 		try {
 			await super.unmuteVideo();
 		} catch (error) {
-			logger$24.warn("[Participant.toggleVideoInput] Server Error while unmuting video input, proceeding with local toggle anyway", error);
+			logger$25.warn("[Participant.toggleVideoInput] Server Error while unmuting video input, proceeding with local toggle anyway", error);
 		} finally {
 			await this.vertoManager.unmuteMainVideoInputDevice();
 		}
@@ -14542,7 +14601,7 @@ function filterAs(predicate, resultPath) {
 //#endregion
 //#region src/operators/throwOnRPCError.ts
 var import_cjs$21 = require_cjs();
-const logger$23 = getLogger();
+const logger$24 = getLogger();
 /**
 * RxJS operator that throws a {@link JSONRPCError} when the RPC response contains an error.
 * Passes successful responses through unchanged.
@@ -14550,14 +14609,14 @@ const logger$23 = getLogger();
 function throwOnRPCError() {
 	return (0, import_cjs$21.map)((response) => {
 		if (response.error) {
-			logger$23.error("[throwOnRPCError] RPC error response:", {
+			logger$24.error("[throwOnRPCError] RPC error response:", {
 				code: response.error.code,
 				message: response.error.message,
 				data: response.error.data
 			});
 			throw new JSONRPCError(response.error.code, response.error.message, response.error.data);
 		}
-		logger$23.debug("[throwOnRPCError] RPC successful response:", response);
+		logger$24.debug("[throwOnRPCError] RPC successful response:", response);
 		return response;
 	});
 }
@@ -14565,7 +14624,7 @@ function throwOnRPCError() {
 //#endregion
 //#region src/managers/CallEventsManager.ts
 var import_cjs$20 = require_cjs();
-const logger$22 = getLogger();
+const logger$23 = getLogger();
 const initialSessionState = {};
 /** @internal */
 var CallEventsManager = class extends Destroyable {
@@ -14669,7 +14728,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
 			});
@@ -14696,19 +14755,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,
@@ -14723,7 +14782,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,
@@ -14733,10 +14792,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;
@@ -14756,7 +14815,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({
@@ -14764,7 +14823,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) {
@@ -14780,7 +14839,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
 		});
@@ -14793,17 +14852,17 @@ var CallEventsManager = class extends Destroyable {
 	}
 	get callJoinedEvent$() {
 		return this.cachedObservable("callJoinedEvent$", () => this.webRtcCallSession.callEvent$.pipe((0, import_cjs$20.filter)(isCallJoinedPayload), (0, import_cjs$20.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(filterAs(isLayoutChangedPayload, "layout"), (0, import_cjs$20.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, import_cjs$20.merge)(this.webRtcCallSession.memberJoined$, this.webRtcCallSession.memberUpdated$, this.webRtcCallSession.memberTalking$).pipe((0, import_cjs$20.map)((event) => event.member), (0, import_cjs$20.tap)((event) => {
-			logger$22.debug("[CallEventsManager] Member update event:", event);
+			logger$23.debug("[CallEventsManager] Member update event:", event);
 		})));
 	}
 	destroy() {
@@ -14822,6 +14881,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 = 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
 /**
@@ -15380,6 +15544,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, import_cjs$17.takeUntil)(this.destroyed$));
@@ -15402,6 +15567,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.
 	*/
@@ -15411,6 +15592,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({
@@ -15418,6 +15600,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,
@@ -15426,6 +15609,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());
@@ -15435,10 +15619,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);
@@ -15708,15 +15895,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
@@ -15732,33 +15931,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 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 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 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) => {
@@ -15870,6 +16075,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);
@@ -15973,6 +16179,10 @@ var RTCPeerConnectionController = class extends Destroyable {
 	get remoteDescription$() {
 		return this.cachedObservable("remoteDescription$", () => this._remoteDescription$.asObservable().pipe((0, import_cjs$16.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, import_cjs$16.takeUntil)(this.destroyed$)));
+	}
 	get localStream$() {
 		return this.cachedObservable("localStream$", () => this.localStreamController.localStream$.pipe((0, import_cjs$16.takeUntil)(this.destroyed$)));
 	}
@@ -16128,7 +16338,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) {
@@ -16252,7 +16462,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);
@@ -16390,35 +16603,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 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 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) => ({
@@ -16432,10 +16662,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() {
@@ -16556,6 +16787,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);
@@ -16616,37 +16848,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 MediaTrackError("updateSendersConstraints", "audio", error));
+			return false;
 		}
 	}
 	/**
@@ -16830,7 +17087,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;
@@ -16878,6 +17135,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;
 	}
@@ -16934,20 +17195,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());
@@ -16955,6 +17207,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, import_cjs$15.filter)((report) => report.legId === legId), (0, import_cjs$15.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
@@ -16992,7 +17313,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;
 		}
 	}
@@ -17160,23 +17481,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 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 = getValueFrom(response, "result.result");
 		if (innerResult?.error) {
 			const error = new 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;
@@ -17197,7 +17519,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?.();
 		}
 	}
@@ -17213,7 +17535,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);
 			}
 		}
 	}
@@ -17226,7 +17548,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);
@@ -17256,7 +17578,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		} else {
 			logger$16.error("[WebRTCManager] Verto invite failed:", response);
 			const inviteError = response.error ? new 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() {
@@ -17295,7 +17617,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);
 	}
@@ -17324,7 +17646,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);
 			}
 		}
 	}
@@ -17428,7 +17750,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" });
 			}
 		}
@@ -17500,7 +17822,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			await this.mainPeerConnection.restoreTrackSender(deviceKind);
 		} else {
 			const error = new InvalidParams("No valid device to be added");
-			this.onError?.(error);
+			this.reportLegError(error, this.mainPeerConnection);
 			throw error;
 		}
 	}
@@ -17509,6 +17831,7 @@ var WebRTCVertoManager = class extends VertoManager {
 	}
 	async initAdditionalPeerConnection(propose, options) {
 		const isScreenShare = propose === "screenshare";
+		if (isScreenShare && this._screenShareId && this._rtcPeerConnectionsMap.has(this._screenShareId)) throw new ScreenShareAlreadyActiveError(this._screenShareId);
 		let firstPeerConnectionError;
 		let rtcPeerConnController = null;
 		try {
@@ -17525,21 +17848,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, import_cjs$15.firstValueFrom)(rtcPeerConnController.connectionState$.pipe((0, import_cjs$15.filter)((state) => state === "connected"), (0, import_cjs$15.take)(1), (0, import_cjs$15.timeout)(this._screenShareTimeoutMs), (0, import_cjs$15.takeUntil)(this.destroyed$)));
+			const pc = rtcPeerConnController;
+			await (0, import_cjs$15.firstValueFrom)((0, import_cjs$15.merge)(pc.localMediaSettled$.pipe((0, import_cjs$15.take)(1), (0, import_cjs$15.switchMap)(() => pc.connectionState$.pipe((0, import_cjs$15.filter)((state) => state === "connected"), (0, import_cjs$15.take)(1), (0, import_cjs$15.timeout)(DEFAULT_AUX_LEG_CONNECT_TIMEOUT_MS)))), this.legError$(pc.id)).pipe((0, import_cjs$15.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._screenShareId = void 0;
+				this._screenShareStatus$.next("none");
+			}
 			if (firstPeerConnectionError) throw firstPeerConnectionError instanceof MediaAccessError && firstPeerConnectionError.originalError instanceof Error ? firstPeerConnectionError.originalError : firstPeerConnectionError;
 			if (error instanceof import_cjs$15.EmptyError) {
 				logger$16.debug("[WebRTCManager] Additional peer connection aborted before connecting.");
 				return;
 			}
+			if (error instanceof import_cjs$15.TimeoutError) throw new AuxiliaryLegTimeoutError(propose, error);
 			throw error instanceof Error ? error : new Error(String(error), { cause: error });
 		}
 	}
@@ -17556,7 +17888,10 @@ var WebRTCVertoManager = class extends VertoManager {
 		if (removeTrack) return this.mainPeerConnection.stopTrackSender(removeTrack, { updateTransceiverDirection: true });
 	}
 	async removeScreenMedia() {
-		if (!["starting", "started"].includes(this._screenShareStatus$.value)) logger$16.warn("[WebRTCManager] No active screen share to stop.");
+		if (!["starting", "started"].includes(this._screenShareStatus$.value)) {
+			logger$16.warn("[WebRTCManager] No active screen share to stop.");
+			return;
+		}
 		if (!this._screenShareId) {
 			logger$16.debug("[WebRTCManager] No screen share peer connection found.");
 			return;
@@ -17585,7 +17920,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;
@@ -18977,13 +19312,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);
@@ -19191,6 +19526,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;
@@ -19586,6 +19925,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 RPCTimeoutError) return "timeout";
@@ -19604,7 +19946,14 @@ const RECOVERABLE_RPC_CODES = new Set([
 	RPC_ERROR_AUTHENTICATION_FAILED,
 	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 VertoPongError) return false;
 	if (error instanceof MediaTrackError) return false;
@@ -19639,7 +19988,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);
 						},
@@ -20111,6 +20462,30 @@ const logger$9 = getLogger();
 function shouldAbortDial(callError) {
 	return callError.fatal || !(callError.error instanceof 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, import_cjs$7.firstValueFrom)((0, import_cjs$7.merge)(session.localMediaSettled$.pipe((0, import_cjs$7.take)(1), (0, import_cjs$7.switchMap)(() => session.selfId$.pipe((0, import_cjs$7.filter)((id) => Boolean(id)), (0, import_cjs$7.take)(1), (0, import_cjs$7.timeout)(signalingTimeoutMs)))), session.errors$.pipe((0, import_cjs$7.filter)(shouldAbortDial), (0, import_cjs$7.take)(1), (0, import_cjs$7.switchMap)((callError) => (0, import_cjs$7.throwError)(() => callError.error)))));
+}
 const getAddressSearchURI = (options) => {
 	const to = options.to?.split("?")[0];
 	const from$9 = options.from?.startsWith("subscriber://") ? options.from.replace("subscriber://", "") : options.from;
@@ -20127,7 +20502,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);
@@ -20555,7 +20929,7 @@ var ClientSessionManager = class extends Destroyable {
 				to: destinationURI,
 				...options
 			});
-			await (0, import_cjs$7.firstValueFrom)((0, import_cjs$7.race)(callSession.selfId$.pipe((0, import_cjs$7.filter)((id) => Boolean(id)), (0, import_cjs$7.take)(1), (0, import_cjs$7.timeout)(this.callCreateTimeout)), callSession.errors$.pipe((0, import_cjs$7.filter)(shouldAbortDial), (0, import_cjs$7.take)(1), (0, import_cjs$7.switchMap)((callError) => (0, import_cjs$7.throwError)(() => callError.error)))));
+			await awaitDialReady(callSession, DEFAULT_CALL_SIGNALING_TIMEOUT_MS);
 			this._calls$.next({
 				[`${callSession.id}`]: callSession,
 				...this._calls$.value
@@ -22733,6 +23107,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.
@@ -23212,5 +23591,5 @@ emitReadyEvent();
 if (typeof process === "undefined") globalThis.process = { env: { NODE_ENV: "production" } };
 
 //#endregion
-export { Address, CallCreateError, CallNotReadyError, ClientPreferences, CollectionFetchError, DPoPInitError, DeviceTokenError, EmbedTokenCredentialProvider, InvalidCredentialsError, MediaAccessError, MediaTrackError, MessageParseError, OverconstrainedFallbackError, Participant, ParticipantNotReadyError, PreflightError, RecoveryError, SelfCapabilities, SelfParticipant, SignalWire, StaticCredentialProvider, TokenRefreshError, UnexpectedError, User, VertoPongError, WebRTCCall, embeddableCall, getLogger, isSelfParticipant, ready, setDebugOptions, setLogLevel, setLogger, version };
+export { Address, AuxiliaryLegTimeoutError, CallCreateError, CallNotReadyError, ClientPreferences, CollectionFetchError, DPoPInitError, DeviceTokenError, EmbedTokenCredentialProvider, InvalidCredentialsError, MediaAccessError, MediaTrackError, MessageParseError, OverconstrainedFallbackError, Participant, ParticipantNotReadyError, PreflightError, RecoveryError, ScreenShareAlreadyActiveError, SelfCapabilities, SelfParticipant, SignalWire, StaticCredentialProvider, TokenRefreshError, UnexpectedError, User, VertoPongError, WebRTCCall, embeddableCall, getLogger, isSelfParticipant, ready, setDebugOptions, setLogLevel, setLogger, version };
 //# sourceMappingURL=browser.mjs.map