@signalwire/js 4.0.0-dev-20260318131609 → 4.0.0-dev-20260318132643

package/dist/browser.mjs

@@ -3107,7 +3107,7 @@ var require_throwError = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.throwError = void 0;
 	var Observable_1$18 = require_Observable();
 	var isFunction_1$14 = require_isFunction();
-	function throwError(errorOrErrorFactory, scheduler) {
+	function throwError$1(errorOrErrorFactory, scheduler) {
 		var errorFactory = isFunction_1$14.isFunction(errorOrErrorFactory) ? errorOrErrorFactory : function() {
 			return errorOrErrorFactory;
 		};
@@ -3118,7 +3118,7 @@ var require_throwError = /* @__PURE__ */ __commonJSMin(((exports) => {
 			return scheduler.schedule(init, 0, subscriber);
 		} : init);
 	}
-	exports.throwError = throwError;
+	exports.throwError = throwError$1;
 }));
 
 //#endregion
@@ -4327,13 +4327,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$3() {
+	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$3;
+	exports.race = race$4;
 	function raceInit(sources) {
 		return function(subscriber) {
 			var subscriptions = [];
@@ -5470,7 +5470,7 @@ var require_distinctUntilChanged = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var identity_1$10 = require_identity();
 	var lift_1$42 = require_lift();
 	var OperatorSubscriber_1$31 = require_OperatorSubscriber();
-	function distinctUntilChanged$5(comparator, keySelector) {
+	function distinctUntilChanged$6(comparator, keySelector) {
 		if (keySelector === void 0) keySelector = identity_1$10.identity;
 		comparator = comparator !== null && comparator !== void 0 ? comparator : defaultCompare;
 		return lift_1$42.operate(function(source, subscriber) {
@@ -5486,7 +5486,7 @@ var require_distinctUntilChanged = /* @__PURE__ */ __commonJSMin(((exports) => {
 			}));
 		});
 	}
-	exports.distinctUntilChanged = distinctUntilChanged$5;
+	exports.distinctUntilChanged = distinctUntilChanged$6;
 	function defaultCompare(a, b) {
 		return a === b;
 	}
@@ -6934,7 +6934,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$3(project, resultSelector) {
+	function switchMap$4(project, resultSelector) {
 		return lift_1$13.operate(function(source, subscriber) {
 			var innerSubscriber = null;
 			var index = 0;
@@ -6958,7 +6958,7 @@ var require_switchMap = /* @__PURE__ */ __commonJSMin(((exports) => {
 			}));
 		});
 	}
-	exports.switchMap = switchMap$3;
+	exports.switchMap = switchMap$4;
 }));
 
 //#endregion
@@ -9104,13 +9104,14 @@ var DependencyError = class extends Error {
 	}
 };
 var CallCreateError = class extends Error {
-	constructor(message, error = null, options) {
+	constructor(message, error = null, direction = "outbound", options) {
 		super(message, {
 			...options,
 			cause: options?.cause ?? (error instanceof Error ? error : void 0)
 		});
 		this.message = message;
 		this.error = error;
+		this.direction = direction;
 		this.name = "CallCreateError";
 	}
 };
@@ -9982,7 +9983,7 @@ var NavigatorDeviceController = class extends Destroyable {
 		};
 		this._devicesState$ = this.createBehaviorSubject(initialDevicesState);
 		this._selectedDevicesState$ = this.createBehaviorSubject(initialSelectedDevicesState);
-		this._errors$ = this.createSubject();
+		this._errors$ = this.createReplaySubject(1);
 		this.init();
 	}
 	get selectedAudioInputDeviceConstraints() {
@@ -10724,12 +10725,12 @@ var require_race = /* @__PURE__ */ __commonJSMin(((exports) => {
 	exports.race = void 0;
 	var argsOrArgArray_1 = require_argsOrArgArray();
 	var raceWith_1$1 = require_raceWith();
-	function race$2() {
+	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$2;
+	exports.race = race$3;
 }));
 
 //#endregion
@@ -12428,7 +12429,6 @@ var CallEventsManager = class extends Destroyable {
 		this.options = options;
 		this.callIds = /* @__PURE__ */ new Set();
 		this.roomSessionIds = /* @__PURE__ */ new Set();
-		this._status$ = this.createBehaviorSubject("trying");
 		this._participants$ = this.createBehaviorSubject({});
 		this._self$ = this.createBehaviorSubject(null);
 		this._sessionState$ = this.createBehaviorSubject(initialSessionState);
@@ -12443,12 +12443,6 @@ var CallEventsManager = class extends Destroyable {
 	get self$() {
 		return this.cachedObservable("self$", () => this._self$.asObservable().pipe(filterNull()));
 	}
-	get status$() {
-		return this._status$.asObservable();
-	}
-	get status() {
-		return this._status$.value;
-	}
 	isRoomSessionIdValid(roomSessionId) {
 		return this.roomSessionIds.has(roomSessionId);
 	}
@@ -12533,7 +12527,6 @@ var CallEventsManager = class extends Destroyable {
 				callId: callJoinedEvent.call_id,
 				roomSessionId: callJoinedEvent.room_session_id
 			});
-			this._status$.next("connected");
 			const sessionState = callJoinedEvent.room_session;
 			const { capabilities } = callJoinedEvent;
 			this.selfId = this.selfId ?? callJoinedEvent.member_id;
@@ -13356,7 +13349,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 		this._connectionState$ = this.createReplaySubject(1);
 		this._signalingState$ = this.createReplaySubject(1);
 		this._iceGatheringState$ = this.createReplaySubject(1);
-		this._errors$ = this.createSubject();
+		this._errors$ = this.createReplaySubject(1);
 		this._iceCandidates$ = this.createReplaySubject(1);
 		this._initialized$ = this.createReplaySubject(1);
 		this._remoteDescription$ = this.createReplaySubject(1);
@@ -13797,37 +13790,29 @@ var RTCPeerConnectionController = class extends Destroyable {
 	}
 	async setupLocalTracks() {
 		logger$11.debug("[RTCPeerConnectionController] Setting up local tracks/transceivers.");
-		let { localStream } = this;
-		if (!localStream) try {
-			localStream = await this.localStreamController.buildLocalStream();
-		} catch (error) {
-			logger$11.error("[RTCPeerConnectionController] Error building local stream:", error);
-			this._errors$.next(error);
-		}
-		if (localStream) {
-			if (this.transceiverController?.useAddStream ?? false) {
-				logger$11.warn("[RTCPeerConnectionController] Using deprecated addStream API to add local stream.");
-				this.peerConnection?.addStream(localStream);
-				if (!this.isNegotiating) {
-					logger$11.debug("[RTCPeerConnectionController] Forcing negotiationneeded after local tracks setup.");
-					this.negotiationNeeded$.next();
-				}
-				return;
+		const localStream = this.localStream ?? await this.localStreamController.buildLocalStream();
+		if (this.transceiverController?.useAddStream ?? false) {
+			logger$11.warn("[RTCPeerConnectionController] Using deprecated addStream API to add local stream.");
+			this.peerConnection?.addStream(localStream);
+			if (!this.isNegotiating) {
+				logger$11.debug("[RTCPeerConnectionController] Forcing negotiationneeded after local tracks setup.");
+				this.negotiationNeeded$.next();
 			}
-			for (const kind of ["audio", "video"]) {
-				const tracks = (kind === "audio" ? localStream.getAudioTracks() : localStream.getVideoTracks()).map((track, index) => ({
-					index,
-					track
-				}));
-				for (const { index, track } of tracks) {
-					this.localStreamController.addTrackEndedListener(track);
-					if (this.transceiverController?.useAddTransceivers ?? false) {
-						const transceivers = (kind === "audio" ? this.transceiverController?.audioTransceivers : this.transceiverController?.videoTransceivers) ?? [];
-						await this.transceiverController?.setupTransceiverSender(track, localStream, transceivers[index]);
-					} else {
-						logger$11.debug(`[RTCPeerConnectionController] Using addTrack for local ${kind} track:`, track.id);
-						this.peerConnection?.addTrack(track, localStream);
-					}
+			return;
+		}
+		for (const kind of ["audio", "video"]) {
+			const tracks = (kind === "audio" ? localStream.getAudioTracks() : localStream.getVideoTracks()).map((track, index) => ({
+				index,
+				track
+			}));
+			for (const { index, track } of tracks) {
+				this.localStreamController.addTrackEndedListener(track);
+				if (this.transceiverController?.useAddTransceivers ?? false) {
+					const transceivers = (kind === "audio" ? this.transceiverController?.audioTransceivers : this.transceiverController?.videoTransceivers) ?? [];
+					await this.transceiverController?.setupTransceiverSender(track, localStream, transceivers[index]);
+				} else {
+					logger$11.debug(`[RTCPeerConnectionController] Using addTrack for local ${kind} track:`, track.id);
+					this.peerConnection?.addTrack(track, localStream);
 				}
 			}
 		}
@@ -14103,6 +14088,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		});
 		this.subscribeTo(this.vertoAnswer$, (event) => {
 			logger$10.debug("[WebRTCManager] Received Verto answer event:", event);
+			this._signalingStatus$.next("connecting");
 			const { sdp, callID } = event;
 			this._rtcPeerConnectionsMap.get(callID)?.updateAnswerStatus({
 				status: "received",
@@ -14174,13 +14160,13 @@ var WebRTCVertoManager = class extends VertoManager {
 		if (response.error) {
 			const error = new JSONRPCError(response.error.code, response.error.message, response.error.data);
 			this.onError?.(error);
-			throw error;
+			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);
-			throw error;
+			return response;
 		}
 		return response;
 	}
@@ -14200,7 +14186,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			}
 		} catch (error) {
 			logger$10.error(`[WebRTCManager] Error sending Verto ${vertoMethod}:`, error);
-			throw error;
+			this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
 		}
 	}
 	async processModifyResponse(response, rtcPeerConnController) {
@@ -14214,12 +14200,14 @@ var WebRTCVertoManager = class extends VertoManager {
 				});
 			} catch (error) {
 				logger$10.warn("[WebRTCManager] Error processing modify response:", error);
-				this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
+				const modifyError = error instanceof Error ? error : new Error(String(error), { cause: error });
+				this.onError?.(modifyError);
 			}
 		}
 	}
 	processInviteResponse(response, rtcPeerConnController) {
 		if (!response.error && getValueFrom(response, "result.result.result.message") === "CALL CREATED") {
+			this._signalingStatus$.next("trying");
 			this._nodeId$.next(getValueFrom(response, "result.node_id") ?? null);
 			const memberId = getValueFrom(response, "result.result.result.memberID") ?? null;
 			const callId = getValueFrom(response, "result.result.result.callID") ?? null;
@@ -14337,7 +14325,6 @@ var WebRTCVertoManager = class extends VertoManager {
 				});
 				this.sendLocalDescriptionOnceAccepted(vertoMessageRequest, rtcPeerConnController);
 			} else if (initial) {
-				this._signalingStatus$.next("trying");
 				const vertoMessageRequest = VertoInvite({
 					dialogParams,
 					sdp
@@ -14644,7 +14631,8 @@ var WebRTCCall = class extends Destroyable {
 		this.clientSession = clientSession;
 		this.options = options;
 		this.address = address;
-		this._errors$ = this.createSubject();
+		this._errors$ = this.createReplaySubject(1);
+		this._lastMergedStatus = "new";
 		this._answered$ = this.createReplaySubject();
 		this._holdState = false;
 		this._userVariables$ = this.createBehaviorSubject({ ...PreferencesContainer.instance.userVariables });
@@ -14665,8 +14653,10 @@ var WebRTCCall = class extends Destroyable {
 		const managers = initialization.initializeManagers(this);
 		this.vertoManager = managers.vertoManager;
 		this.callEventsManager = managers.callEventsManager;
-		if (options.initOffer) this._status$ = this.createBehaviorSubject("ringing");
-		else this._status$ = this.createBehaviorSubject("new");
+		if (options.initOffer) {
+			this._status$ = this.createBehaviorSubject("ringing");
+			this._lastMergedStatus = "ringing";
+		} else this._status$ = this.createBehaviorSubject("new");
 		const { deviceController } = initialization;
 		this.participantFactory = new ParticipantFactory(this.executeMethod.bind(this), this.vertoManager, deviceController);
 	}
@@ -14674,9 +14664,17 @@ var WebRTCCall = class extends Destroyable {
 	get errors$() {
 		return this._errors$.asObservable();
 	}
-	/** @internal Push an error to the call's error stream. */
-	emitError(error) {
-		this._errors$.next(error);
+	/**
+	* @internal Push an error to the call's error stream.
+	* Fatal errors automatically transition the call to `'failed'` and destroy it.
+	*/
+	emitError(callError) {
+		if (this._status$.value === "destroyed" || this._status$.value === "failed") return;
+		this._errors$.next(callError);
+		if (callError.fatal) {
+			this._status$.next("failed");
+			this.destroy();
+		}
 	}
 	/** Whether this call is `'inbound'` or `'outbound'`. */
 	get direction() {
@@ -14788,7 +14786,9 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of the current call status (e.g. `'ringing'`, `'connected'`). */
 	get status$() {
-		return this.cachedObservable("status$", () => (0, import_cjs$9.merge)(this._status$.asObservable(), this.vertoManager.signalingStatus$));
+		return this.cachedObservable("status$", () => (0, import_cjs$9.merge)(this._status$.asObservable(), this.vertoManager.signalingStatus$).pipe((0, import_cjs$9.distinctUntilChanged)(), (0, import_cjs$9.tap)((status) => {
+			this._lastMergedStatus = status;
+		})));
 	}
 	/** Observable of the participants list, emits on join/leave/update. */
 	get participants$() {
@@ -14828,7 +14828,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Current call status. */
 	get status() {
-		return this._status$.value;
+		return this._lastMergedStatus;
 	}
 	/** Whether the call is currently being recorded. */
 	get recording() {
@@ -15041,6 +15041,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Destroys the call, releasing all resources and subscriptions. */
 	destroy() {
+		if (this._status$.value === "destroyed") return;
 		this._status$.next("destroyed");
 		this.vertoManager.destroy();
 		this.callEventsManager.destroy();
@@ -15051,6 +15052,23 @@ var WebRTCCall = class extends Destroyable {
 //#endregion
 //#region src/managers/CallFactory.ts
 /**
+* Infers the semantic error category from a raw Error thrown by VertoManager
+* or an RTCPeerConnection layer.
+*/
+function inferCallErrorKind(error) {
+	if (error instanceof RPCTimeoutError) return "timeout";
+	if (error instanceof JSONRPCError) return "signaling";
+	if (error instanceof MediaTrackError) return "media";
+	if (error instanceof WebSocketConnectionError || error instanceof TransportConnectionError) return "network";
+	return "internal";
+}
+/** Determines whether an error should be fatal (destroy the call). */
+function isFatalError(error) {
+	if (error instanceof VertoPongError) return false;
+	if (error instanceof MediaTrackError) return false;
+	return true;
+}
+/**
 * Factory for creating WebRTCCall instances with proper manager wiring.
 * Eliminates circular dependencies by centralizing Call and Manager creation.
 */
@@ -15071,7 +15089,13 @@ var CallFactory = class {
 					vertoManager: new WebRTCVertoManager(callInstance, this.attachManager, this.deviceController, this.webRTCApiProvider, {
 						nodeId: options.nodeId,
 						onError: (error) => {
-							callInstance.emitError(error);
+							const callError = {
+								kind: inferCallErrorKind(error),
+								fatal: isFatalError(error),
+								error,
+								callId: callInstance.id
+							};
+							callInstance.emitError(callError);
 						}
 					}),
 					callEventsManager: new CallEventsManager(callInstance)
@@ -15516,7 +15540,7 @@ var ClientSessionManager = class extends Destroyable {
 			revision: 0
 		};
 		this._authorization$ = this.createBehaviorSubject(void 0);
-		this._errors$ = this.createSubject();
+		this._errors$ = this.createReplaySubject(1);
 		this._authenticated$ = this.createBehaviorSubject(false);
 		this._subscriberInfo$ = this.createBehaviorSubject(null);
 		this._calls$ = this.createBehaviorSubject({});
@@ -15786,12 +15810,13 @@ var ClientSessionManager = class extends Destroyable {
 	}
 	async createOutboundCall(destination, options = {}) {
 		const destinationURI = destination instanceof Address ? destination.defaultChannel : destination;
+		let callSession;
 		try {
-			const callSession = await this.createCall({
+			callSession = await this.createCall({
 				to: destinationURI,
 				...options
 			});
-			await (0, import_cjs$5.firstValueFrom)(callSession.selfId$.pipe((0, import_cjs$5.filter)((id) => Boolean(id)), (0, import_cjs$5.take)(1), (0, import_cjs$5.timeout)(this.callCreateTimeout)));
+			await (0, import_cjs$5.firstValueFrom)((0, import_cjs$5.race)(callSession.selfId$.pipe((0, import_cjs$5.filter)((id) => Boolean(id)), (0, import_cjs$5.take)(1), (0, import_cjs$5.timeout)(this.callCreateTimeout)), callSession.errors$.pipe((0, import_cjs$5.take)(1), (0, import_cjs$5.switchMap)((callError) => (0, import_cjs$5.throwError)(() => callError.error)))));
 			this._calls$.next({
 				[`${callSession.id}`]: callSession,
 				...this._calls$.value
@@ -15799,7 +15824,8 @@ var ClientSessionManager = class extends Destroyable {
 			return callSession;
 		} catch (error) {
 			logger$6.error("[Session] Error creating outbound call:", error);
-			const callError = new CallCreateError("Call create timeout", error);
+			callSession?.destroy();
+			const callError = new CallCreateError(error instanceof import_cjs$5.TimeoutError ? "Call create timeout" : "Call creation failed", error, "outbound");
 			this._errors$.next(callError);
 			throw callError;
 		}
@@ -15825,7 +15851,7 @@ var ClientSessionManager = class extends Destroyable {
 			return callSession;
 		} catch (error) {
 			logger$6.error("[Session] Error creating call session:", error);
-			throw new CallCreateError("Call create error", error);
+			throw new CallCreateError("Call create error", error, options.initOffer ? "inbound" : "outbound");
 		}
 	}
 	destroy() {
@@ -16074,7 +16100,7 @@ var WebSocketController = class WebSocketController extends Destroyable {
 		this.shouldReconnect = false;
 		this._status$ = this.createBehaviorSubject("disconnected");
 		this._incomingMessages$ = this.createSubject();
-		this._errors$ = this.createSubject();
+		this._errors$ = this.createReplaySubject(1);
 		this.reconnectDelayMin = options.reconnectDelayMin ?? WebSocketController.DEFAULT_RECONNECT_DELAY_MIN_MS;
 		this.reconnectDelayMax = options.reconnectDelayMax ?? WebSocketController.DEFAULT_RECONNECT_DELAY_MAX_MS;
 		this.connectionTimeout = options.connectionTimeout ?? WebSocketController.DEFAULT_CONNECTION_TIMEOUT_MS;
@@ -16432,7 +16458,7 @@ var SignalWire = class extends Destroyable {
 		this._directory$ = this.createBehaviorSubject(void 0);
 		this._isConnected$ = this.createBehaviorSubject(false);
 		this._isRegistered$ = this.createBehaviorSubject(false);
-		this._errors$ = this.createSubject();
+		this._errors$ = this.createReplaySubject(1);
 		this._options = {};
 		this._deps = new DependencyContainer();
 		this._options = {