@signalwire/js 4.0.0-dev-20260915014810 → 4.0.0-dev-20260915135732

package/dist/browser.mjs

@@ -14336,22 +14336,31 @@ var SelfParticipant = class extends Participant {
 		this.deviceController.selectAudioInputDevice(device);
 		if (options.savePreference) PreferencesContainer.instance.preferredAudioInput = device;
 	}
-	/** Updates the audio input track constraints for the active call. */
+	/**
+	* Updates the audio input track constraints for the active call.
+	* @returns whether the constraints reached the media the call is sending.
+	*/
 	async setAudioInputDeviceConstraints(constraints) {
-		await this.vertoManager.updateMediaConstraints({ audio: constraints });
+		return this.vertoManager.updateMediaConstraints({ audio: constraints });
 	}
-	/** Updates both audio and video input track constraints for the active call. */
+	/**
+	* Updates both audio and video input track constraints for the active call.
+	* @returns whether both kinds took the constraints.
+	*/
 	async setInputDevicesConstraints(constraints) {
-		await this.vertoManager.updateMediaConstraints(constraints);
+		return this.vertoManager.updateMediaConstraints(constraints);
 	}
 	/** Selects the video input device for future calls. Optionally saves as a preference. */
 	selectVideoInputDevice(device, options = {}) {
 		this.deviceController.selectVideoInputDevice(device);
 		if (options.savePreference) PreferencesContainer.instance.preferredVideoInput = device;
 	}
-	/** Updates the video input track constraints for the active call. */
+	/**
+	* Updates the video input track constraints for the active call.
+	* @returns whether the constraints reached the media the call is sending.
+	*/
 	async setVideoInputDeviceConstraints(constraints) {
-		await this.vertoManager.updateMediaConstraints({ video: constraints });
+		return this.vertoManager.updateMediaConstraints({ video: constraints });
 	}
 	/** Selects the audio output device. Optionally saves as a preference. */
 	selectAudioOutputDevice(device, options = {}) {
@@ -17393,16 +17402,25 @@ var WebRTCVertoManager = class extends VertoManager {
 			this.onError?.(new VertoPongError(error));
 		}
 	}
+	/**
+	* @returns whether the constraints reached the media the call is sending.
+	* `false` is an outcome, not a failure: the leg may have no live sender of
+	* the kind, or carry media the SDK did not capture and may not replace.
+	* A failure behind it still reaches the call's `errors$`, so a caller that
+	* ignores this value learns of it there.
+	*/
 	async updateMediaConstraints(options = {}) {
 		const { audio, video } = options;
+		let applied = true;
 		try {
-			if (audio) await this.mainPeerConnection.updateSendersConstraints("audio", audio);
-			if (video) await this.mainPeerConnection.updateSendersConstraints("video", video);
+			if (audio) applied = await this.mainPeerConnection.updateSendersConstraints("audio", audio) && applied;
+			if (video) applied = await this.mainPeerConnection.updateSendersConstraints("video", video) && applied;
 		} catch (error) {
 			logger$16.warn("[WebRTCManager] Error updating media constraints:", error);
 			this.reportLegError(toError(error), this.mainPeerConnection);
 			throw error;
 		}
+		return applied;
 	}
 	get selfId() {
 		return this._selfId$.value;
@@ -19961,17 +19979,28 @@ var WebRTCCall = class extends Destroyable {
 	* (notably iOS Safari) fall back to re-acquiring the track with the new
 	* constraint set and plumbing the replacement through the local audio
 	* pipeline if one is active.
+	*
+	* @returns whether the constraint reached the microphone. `false` is an
+	* outcome rather than an error — a leg sending media the SDK did not capture
+	* is left alone — so a UI that reflects the toggle must read it. Any failure
+	* behind a `false` is also reported on {@link errors$}.
 	*/
 	async setEchoCancellation(enabled) {
-		await this.vertoManager.updateMediaConstraints({ audio: { echoCancellation: enabled } });
+		return this.vertoManager.updateMediaConstraints({ audio: { echoCancellation: enabled } });
 	}
-	/** Toggle browser noise suppression on the local mic at runtime. */
+	/**
+	* Toggle browser noise suppression on the local mic at runtime.
+	* @returns whether the constraint reached the microphone.
+	*/
 	async setNoiseSuppression(enabled) {
-		await this.vertoManager.updateMediaConstraints({ audio: { noiseSuppression: enabled } });
+		return this.vertoManager.updateMediaConstraints({ audio: { noiseSuppression: enabled } });
 	}
-	/** Toggle browser automatic gain control on the local mic at runtime. */
+	/**
+	* Toggle browser automatic gain control on the local mic at runtime.
+	* @returns whether the constraint reached the microphone.
+	*/
 	async setAutoGainControl(enabled) {
-		await this.vertoManager.updateMediaConstraints({ audio: { autoGainControl: enabled } });
+		return this.vertoManager.updateMediaConstraints({ audio: { autoGainControl: enabled } });
 	}
 	/**
 	* Observable of the aggregate remote audio level, 0..1 RMS. The server
@@ -23093,7 +23122,7 @@ var SignalWire = class extends Destroyable {
 			logger$1.warn("[SignalWire] Failed to initialize VisibilityController:", error);
 		}
 		try {
-			this._diagnosticsCollector = new DiagnosticsCollector({ sdkVersion: "4.0.0-dev-20260915014810" });
+			this._diagnosticsCollector = new DiagnosticsCollector({ sdkVersion: "4.0.0-dev-20260915135732" });
 		} catch (error) {
 			logger$1.warn("[SignalWire] Failed to initialize DiagnosticsCollector:", error);
 		}
@@ -23648,7 +23677,7 @@ var StaticCredentialProvider = class {
 /**
 * Library version from package.json, injected at build time.
 */
-const version = "4.0.0-dev-20260915014810";
+const version = "4.0.0-dev-20260915135732";
 /**
 * Flag indicating the library has been loaded and is ready to use.
 * For UMD builds: `window.SignalWire.ready`
@@ -23670,7 +23699,7 @@ const ready = true;
 */
 const emitReadyEvent = () => {
 	if (typeof window !== "undefined") {
-		const event = new CustomEvent("signalwire:js:ready", { detail: { version: "4.0.0-dev-20260915014810" } });
+		const event = new CustomEvent("signalwire:js:ready", { detail: { version: "4.0.0-dev-20260915135732" } });
 		window.dispatchEvent(event);
 	}
 };