@signalwire/js 4.0.0-dev-20260911195739 → 4.0.0-dev-20260914173015

package/dist/browser.mjs

@@ -9094,6 +9094,8 @@ const MEDIA_ACCESS_DENIAL_NAMES = [
 	"SecurityError",
 	"PermissionDeniedError"
 ];
+/** Error names browsers use when the capture hardware is already held exclusively. */
+const MEDIA_DEVICE_IN_USE_NAMES = ["NotReadableError", "TrackStartError"];
 /** Default polling interval for RTCPeerConnection.getStats() in milliseconds. */
 const DEFAULT_STATS_POLLING_INTERVAL_MS = 1e3;
 /** Number of initial samples used to build a baseline for spike detection. */
@@ -9432,6 +9434,10 @@ var MediaTrackError = class extends Error {
 function isMediaAccessDenial(originalError) {
 	return originalError instanceof Error && MEDIA_ACCESS_DENIAL_NAMES.includes(originalError.name);
 }
+/** True when a `getUserMedia` rejection means the hardware is already held exclusively. */
+function isMediaDeviceInUse(originalError) {
+	return originalError instanceof Error && MEDIA_DEVICE_IN_USE_NAMES.includes(originalError.name);
+}
 /**
 * Failure to acquire local media (camera, microphone, or screen capture)
 * via `getUserMedia`/`getDisplayMedia`.
@@ -16050,38 +16056,32 @@ var RTCPeerConnectionController = class extends Destroyable {
 			this.negotiationNeeded$.next();
 		};
 		this.updateSelectedInputDevice = async (kind, deviceInfo) => {
+			const { localStream } = this;
+			if (!localStream) {
+				logger$17.warn("[RTCPeerConnectionController] No local stream available to update input device.");
+				return;
+			}
+			const currentTrack = localStream.getTracks().find((track) => track.kind === kind);
+			if (!currentTrack) {
+				logger$17.debug(`[RTCPeerConnectionController] No ${kind} track to switch.`);
+				return;
+			}
+			if (!deviceInfo) {
+				logger$17.debug(`[RTCPeerConnectionController] ${kind} input device selected: none`);
+				this.stopTrackSender(kind);
+				return;
+			}
+			const constraints = {
+				...currentTrack.getConstraints(),
+				...this.deviceController.deviceInfoToConstraints(deviceInfo)
+			};
 			try {
-				const { localStream } = this;
-				if (!localStream) {
-					logger$17.warn("[RTCPeerConnectionController] No local stream available to update input device.");
-					return;
-				}
-				logger$17.debug(`[RTCPeerConnectionController] Updating selected ${kind} input device:`, localStream.getTracks());
-				const track = localStream.getTracks().find((track$1) => track$1.kind === kind);
-				if (track) {
-					this.transceiverController?.stopTrackSender(kind);
-					this.localStreamController.removeTrack(track.id);
-					logger$17.debug(`[RTCPeerConnectionController] Stopped existing ${kind} track: ${track.id}`, localStream.getTracks());
-					if (!deviceInfo) {
-						logger$17.debug(`[RTCPeerConnectionController] ${kind} input device selected: none`);
-						return;
-					}
-					const streamTrack = (await this.getUserMedia({ [kind]: {
-						...track.getConstraints(),
-						...this.deviceController.deviceInfoToConstraints(deviceInfo)
-					} })).getTracks().find((t) => t.kind === kind);
-					if (streamTrack) {
-						logger$17.debug(`[RTCPeerConnectionController] Adding new ${kind} track: ${streamTrack.id}`);
-						this.localStreamController.addTrack(streamTrack);
-						await this.transceiverController?.replaceSenderTrack(kind, streamTrack);
-						logger$17.debug(`[RTCPeerConnectionController] Added new ${kind} track: ${streamTrack.id}`, this.localStream?.getTracks());
-					}
-				}
-				logger$17.debug(`[RTCPeerConnectionController] ${kind} input device selected:`, deviceInfo?.label);
+				const newTrack = await this.acquireInputTrack(kind, constraints, deviceInfo, currentTrack);
+				await this.attachInputTrack(kind, newTrack, currentTrack);
+				logger$17.debug(`[RTCPeerConnectionController] ${kind} input device selected:`, deviceInfo.label, newTrack.id);
 			} catch (error) {
 				logger$17.error(`[RTCPeerConnectionController] Failed to select ${kind} input device:`, error);
 				this._errors$.next(new MediaTrackError("updateSelectedInputDevice", kind, error));
-				throw error;
 			}
 		};
 		this._isNegotiating$ = this.createBehaviorSubject(false);
@@ -16784,6 +16784,61 @@ var RTCPeerConnectionController = class extends Destroyable {
 		this._localAudioPipeline.setInputTrack(newTrack);
 	}
 	/**
+	* Capture the newly selected device, leaving the current capture running.
+	*
+	* A rejection must leave the current track sending, so nothing is released
+	* until the replacement is in hand. The one exception is hardware that admits
+	* a single opener — a phone's front and back cameras, typically — which
+	* rejects the second capture until the first is closed.
+	*/
+	async acquireInputTrack(kind, constraints, deviceInfo, currentTrack) {
+		try {
+			return await this.captureTrack(kind, constraints, deviceInfo.deviceId);
+		} catch (error) {
+			if (!isMediaDeviceInUse(error)) throw error;
+			logger$17.warn(`[RTCPeerConnectionController] ${kind} device is held exclusively; releasing the current capture to retry:`, error);
+			const previousDeviceId = currentTrack.getSettings().deviceId;
+			this.stopTrackSender(kind);
+			try {
+				return await this.captureTrack(kind, constraints, deviceInfo.deviceId);
+			} catch (retryError) {
+				await this.restorePreviousInputTrack(kind, constraints, previousDeviceId, currentTrack);
+				throw retryError;
+			}
+		}
+	}
+	async captureTrack(kind, constraints, deviceId) {
+		const { stream, fallbackLevel } = await getUserMediaWithFallback({ getUserMedia: async (c) => this.getUserMedia(c) }, { [kind]: constraints }, kind, deviceId);
+		const track = stream.getTracks().find((t) => t.kind === kind);
+		if (!track) {
+			stream.getTracks().forEach((t) => t.stop());
+			throw new MediaTrackError("updateSelectedInputDevice", kind, /* @__PURE__ */ new Error("getUserMedia returned no track of the requested kind"));
+		}
+		if (fallbackLevel !== "exact") logger$17.warn(`[RTCPeerConnectionController] ${kind} device acquired at fallback level '${fallbackLevel}'; the capture may not be the requested device.`);
+		return track;
+	}
+	/** Best-effort return to the device that was released for an exclusive retry. */
+	async restorePreviousInputTrack(kind, constraints, previousDeviceId, releasedTrack) {
+		try {
+			const restored = await this.captureTrack(kind, constraints, previousDeviceId);
+			await this.attachInputTrack(kind, restored, releasedTrack);
+		} catch (error) {
+			logger$17.error(`[RTCPeerConnectionController] Failed to restore the previous ${kind} device:`, error);
+		}
+	}
+	async attachInputTrack(kind, newTrack, oldTrack) {
+		const pipelineOwnsAudio = kind === "audio" && this._localAudioPipeline;
+		if (!pipelineOwnsAudio) try {
+			await this.transceiverController?.replaceSenderTrack(kind, newTrack);
+		} catch (error) {
+			newTrack.stop();
+			throw error;
+		}
+		this.localStreamController.removeTrack(oldTrack.id);
+		this.localStreamController.addTrack(newTrack);
+		if (pipelineOwnsAudio) this._localAudioPipeline?.setInputTrack(newTrack);
+	}
+	/**
 	* Return the lazily-created {@link LocalAudioPipeline}, constructing it on
 	* first access. On creation the current audio sender's track is routed
 	* through the pipeline (input → gain → analyser → destination) and the
@@ -17519,16 +17574,12 @@ var WebRTCVertoManager = class extends VertoManager {
 		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.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);
+		const failure = response.error ?? innerResult?.error;
+		if (failure) {
+			const error = new JSONRPCError(failure.code, failure.message, failure.data);
+			if (message.method === "verto.invite") throw error;
 			this.reportLegError(error, this._rtcPeerConnectionsMap.get(params.callID), nonFatal);
-			return response;
 		}
 		return response;
 	}
@@ -17583,7 +17634,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		if (rtcPeerConnController.isMainDevice) this._signalingStatus$.next(status);
 	}
 	processInviteResponse(response, rtcPeerConnController) {
-		if (!response.error && getValueFrom(response, "result.result.result.message") === "CALL CREATED") {
+		if (getValueFrom(response, "result.result.result.message") === "CALL CREATED") {
 			this.emitMainSignalingStatus(rtcPeerConnController.id, "trying");
 			const nodeId = getValueFrom(response, "result.node_id") ?? null;
 			const memberId = getValueFrom(response, "result.result.result.memberID") ?? null;
@@ -17610,8 +17661,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			logger$16.debug(`[WebRTCManager] nodeid: ${this._nodeId$.value}, selfId: ${this._selfId$.value}`);
 		} 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.reportLegError(inviteError, rtcPeerConnController);
+			this.reportLegError(/* @__PURE__ */ new Error("Verto invite failed: unexpected response"), rtcPeerConnController);
 		}
 	}
 	get RTCPeerConnectionConfig() {