@signalwire/js 4.0.0-beta.7 → 4.0.0-beta.8

package/dist/index.cjs

@@ -1,4 +1,4 @@
-const require_operators = require('./operators-DT4UB24-.cjs');
+const require_operators = require('./operators-CJEML6aa.cjs');
 let jwt_decode = require("jwt-decode");
 let rxjs = require("rxjs");
 let uuid = require("uuid");
@@ -295,7 +295,7 @@ var PreferencesContainer = class PreferencesContainer {
 			skipDeviceMonitoring: false,
 			savePreferences: false
 		};
-		this.receiveVideo = true;
+		this.receiveVideo = false;
 		this.receiveAudio = true;
 		this.preferredAudioInput = null;
 		this.preferredAudioOutput = null;
@@ -607,7 +607,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() {
@@ -1087,7 +1087,7 @@ const RPCExecute = ({ method, params }) => {
 
 //#endregion
 //#region src/core/RPCMessages/VertoMessages.ts
-const tmpMap = {
+const SDK_TO_VERTO_FIELD_MAP = {
 	id: "callID",
 	destinationNumber: "destination_number",
 	remoteCallerName: "remote_caller_id_name",
@@ -1096,19 +1096,31 @@ const tmpMap = {
 	callerNumber: "caller_id_number",
 	fromCallAddressId: "from_fabric_address_id"
 };
+const EXCLUDED_DIALOG_PARAMS = new Set([
+	"remoteSdp",
+	"localStream",
+	"remoteStream"
+]);
 /**
-* Translate SDK fields into verto variables
+* Translate SDK fields into verto variables.
+* Returns a new object — the input is never mutated.
 */
+/** @internal Exported for testing only. */
 const filterVertoParams = (params) => {
-	if (Object.prototype.hasOwnProperty.call(params, "dialogParams")) {
-		const { remoteSdp, localStream, remoteStream, ...dialogParams } = params.dialogParams;
-		for (const key in tmpMap) if (key && Object.prototype.hasOwnProperty.call(dialogParams, key)) {
-			dialogParams[tmpMap[key]] = dialogParams[key];
-			delete dialogParams[key];
-		}
-		params.dialogParams = dialogParams;
-	}
-	return params;
+	if (!Object.prototype.hasOwnProperty.call(params, "dialogParams")) return params;
+	const sourceDialogParams = params.dialogParams;
+	const filteredDialogParams = Object.entries(sourceDialogParams).reduce((acc, [key, value]) => {
+		if (EXCLUDED_DIALOG_PARAMS.has(key)) return acc;
+		const mappedKey = SDK_TO_VERTO_FIELD_MAP[key] ?? key;
+		return {
+			...acc,
+			[mappedKey]: value
+		};
+	}, {});
+	return {
+		...params,
+		dialogParams: filteredDialogParams
+	};
 };
 const buildVertoRPCMessage = (method) => {
 	return (params = {}) => {
@@ -1759,7 +1771,13 @@ var Participant = class extends Destroyable {
 	}
 	/** Removes this participant from the call. */
 	async remove() {
-		await this.executeMethod(this.id, "call.member.remove", {});
+		const state = this._state$.value;
+		const target = {
+			member_id: this.id,
+			call_id: state.call_id ?? "",
+			node_id: state.node_id ?? ""
+		};
+		await this.executeMethod(target, "call.member.remove", {});
 	}
 	/** Ends the call for this participant. */
 	async end() {
@@ -2001,7 +2019,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);
@@ -2010,15 +2027,12 @@ var CallEventsManager = class extends Destroyable {
 	get participants$() {
 		return this.cachedObservable("participants$", () => this._participants$.asObservable().pipe((0, rxjs.map)((participantsRecord) => Object.values(participantsRecord))));
 	}
+	get participants() {
+		return Object.values(this._participants$.value);
+	}
 	get self$() {
 		return this.cachedObservable("self$", () => this._self$.asObservable().pipe(require_operators.filterNull()));
 	}
-	get status$() {
-		return this._status$.asObservable();
-	}
-	get status() {
-		return this._status$.value;
-	}
 	isRoomSessionIdValid(roomSessionId) {
 		return this.roomSessionIds.has(roomSessionId);
 	}
@@ -2103,7 +2117,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;
@@ -2230,12 +2243,53 @@ var CallEventsManager = class extends Destroyable {
 
 //#endregion
 //#region src/helpers/SDPHelper.ts
+/** Valid SDP direction attribute values. */
+const SDP_DIRECTIONS = new Set([
+	"sendrecv",
+	"sendonly",
+	"recvonly",
+	"inactive"
+]);
 /**
-* SDPHelper - Utility functions for SDP (Session Description Protocol) parsing and validation.
+* Extracts the media directions (audio/video) from an SDP string.
+*
+* Parses each media section (`m=audio` / `m=video`) and reads the `a=` direction
+* attribute (`sendrecv`, `sendonly`, `recvonly`, `inactive`).
+* If no explicit direction attribute is found for a media section, defaults to `sendrecv`
+* per RFC 4566.
 *
-* This module provides helper functions to analyze and validate SDP content,
-* particularly for ICE candidate validation in WebRTC connections.
+* @param sdp - The SDP string to parse
+* @returns The extracted audio and video directions
+*
+* @example
+* ```typescript
+* const sdp = `v=0\r\nm=audio 9 UDP/TLS/RTP/SAVPF 111\r\na=sendrecv\r\nm=video 9 UDP/TLS/RTP/SAVPF 96\r\na=recvonly`;
+* extractMediaDirectionsFromSDP(sdp);
+* // { audio: 'sendrecv', video: 'recvonly' }
+* ```
 */
+function extractMediaDirectionsFromSDP(sdp) {
+	const result = {
+		audio: "inactive",
+		video: "inactive"
+	};
+	if (!sdp) return result;
+	const lines = sdp.split(/\r?\n/);
+	let currentMediaKind = null;
+	let currentDirection = null;
+	for (const line of lines) if (line.startsWith("m=")) {
+		if (currentMediaKind) result[currentMediaKind] = currentDirection ?? "sendrecv";
+		if (line.startsWith("m=audio")) currentMediaKind = "audio";
+		else if (line.startsWith("m=video")) currentMediaKind = "video";
+		else currentMediaKind = null;
+		currentDirection = null;
+	} else if (currentMediaKind && line.startsWith("a=")) {
+		const attr = line.substring(2).trim();
+		if (SDP_DIRECTIONS.has(attr)) currentDirection = attr;
+	}
+	if (currentMediaKind) result[currentMediaKind] = currentDirection ?? "sendrecv";
+	return result;
+}
 /**
 * Validates that an SDP string has at least one non-host ICE candidate
 * for each media section (m= line).
@@ -2536,6 +2590,15 @@ var LocalStreamController = class extends Destroyable {
 		track.addEventListener("ended", this.mediaTrackEndedHandler);
 	}
 	/**
+	* Update the controller options (e.g., when media overrides are applied).
+	*/
+	updateOptions(options) {
+		this.options = {
+			...this.options,
+			...options
+		};
+	}
+	/**
 	* Stop all local tracks and clean up.
 	*/
 	stopAllTracks() {
@@ -2873,11 +2936,12 @@ 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);
 		this._remoteStream$ = this.createBehaviorSubject(null);
+		this._remoteOfferMediaDirections = null;
 		this.deviceController = deviceController ?? {};
 		this.id = options.callId ?? (0, uuid.v4)();
 		this._type = remoteSessionDescription ? "answer" : "offer";
@@ -2885,10 +2949,19 @@ var RTCPeerConnectionController = class extends Destroyable {
 			type: "offer",
 			sdp: remoteSessionDescription
 		} : void 0;
+		this._remoteOfferMediaDirections = remoteSessionDescription ? extractMediaDirectionsFromSDP(remoteSessionDescription) : null;
+		const offerDefaults = this._remoteOfferMediaDirections ? {
+			audio: this._remoteOfferMediaDirections.audio.includes("recv"),
+			video: this._remoteOfferMediaDirections.video.includes("recv"),
+			receiveAudio: this._remoteOfferMediaDirections.audio.includes("send"),
+			receiveVideo: this._remoteOfferMediaDirections.video.includes("send")
+		} : {};
 		this.options = {
-			receiveAudio: options.receiveAudio ?? PreferencesContainer.instance.receiveAudio,
-			receiveVideo: options.receiveVideo ?? PreferencesContainer.instance.receiveVideo,
-			...options
+			...options,
+			audio: options.audio ?? offerDefaults.audio,
+			video: options.video ?? offerDefaults.video,
+			receiveAudio: options.receiveAudio ?? offerDefaults.receiveAudio ?? PreferencesContainer.instance.receiveAudio,
+			receiveVideo: options.receiveVideo ?? offerDefaults.receiveVideo ?? PreferencesContainer.instance.receiveVideo
 		};
 		this.localStreamController = new LocalStreamController({
 			propose: this.propose,
@@ -3033,7 +3106,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 		};
 	}
 	get inputVideoDeviceConstraints() {
-		if (this.options.video === false && !this.options.inputVideoDeviceConstraints) return false;
+		if (!this.options.video && !this.options.inputVideoDeviceConstraints) return false;
 		return {
 			...this.options.inputVideoDeviceConstraints,
 			...this.deviceController.selectedVideoInputDeviceConstraints
@@ -3055,12 +3128,12 @@ var RTCPeerConnectionController = class extends Destroyable {
 			default: return {
 				...options,
 				offerToReceiveAudio: true,
-				offerToReceiveVideo: Boolean(this.inputVideoDeviceConstraints)
+				offerToReceiveVideo: this.options.receiveVideo ?? Boolean(this.inputVideoDeviceConstraints)
 			};
 		}
 	}
 	get answerOptions() {
-		return {};
+		return { iceRestart: this.firstSDPExchangeCompleted ? true : void 0 };
 	}
 	/**
 	* Initialize the RTCPeerConnection and setup event listeners.
@@ -3095,11 +3168,15 @@ var RTCPeerConnectionController = class extends Destroyable {
 				});
 				await this.updateSelectedInputDevice(kind, deviceInfo);
 			});
-			await this.setupTrackHandling();
-			this._initialized$.next(true);
 			if (this.type === "answer" && this.sdpInit) {
+				await this.setupRemoteTracks();
+				this._initialized$.next(true);
 				this.setupEventListeners();
-				await this.handleOfferReceived();
+				this._isNegotiating$.next(true);
+				await this._setRemoteDescription(this.sdpInit);
+			} else {
+				await this.setupTrackHandling();
+				this._initialized$.next(true);
 			}
 		} catch (error) {
 			logger$11.error("[RTCPeerConnectionController] Initialization error:", error);
@@ -3197,6 +3274,35 @@ var RTCPeerConnectionController = class extends Destroyable {
 			default:
 		}
 	}
+	/**
+	* Accept an inbound call by creating the SDP answer.
+	* Optionally override media options before the answer is generated.
+	* Must be called after initialization for inbound (answer-type) connections.
+	*/
+	async acceptInbound(mediaOverrides) {
+		if (mediaOverrides) {
+			const { audio, video, receiveAudio, receiveVideo } = mediaOverrides;
+			this.options = {
+				...this.options,
+				...audio !== void 0 ? { audio } : {},
+				...video !== void 0 ? { video } : {},
+				...receiveAudio !== void 0 ? { receiveAudio } : {},
+				...receiveVideo !== void 0 ? { receiveVideo } : {}
+			};
+			this.transceiverController?.updateOptions({
+				receiveAudio: this.receiveAudio,
+				receiveVideo: this.receiveVideo
+			});
+			this.localStreamController.updateOptions({
+				inputAudioDeviceConstraints: this.inputAudioDeviceConstraints,
+				inputVideoDeviceConstraints: this.inputVideoDeviceConstraints
+			});
+		}
+		await this.setupLocalTracks();
+		const { answerOptions } = this;
+		logger$11.debug("[RTCPeerConnectionController] Creating inbound answer with options:", answerOptions);
+		await this.createAnswer(answerOptions);
+	}
 	async handleOfferReceived() {
 		if (!this.sdpInit) throw new require_operators.DependencyError("SDP initialization parameters are not set");
 		this._isNegotiating$.next(true);
@@ -3271,37 +3377,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);
 				}
 			}
 		}
@@ -3318,7 +3416,12 @@ var RTCPeerConnectionController = class extends Destroyable {
 		if (!this.peerConnection) throw new require_operators.DependencyError("RTCPeerConnection is not initialized");
 		this.peerConnection.ontrack = (event) => {
 			logger$11.debug("[RTCPeerConnectionController] Remote track received:", event.track.kind);
-			this._remoteStream$.next(event.streams[0]);
+			if (event.streams[0]) this._remoteStream$.next(event.streams[0]);
+			else {
+				const existingTracks = this._remoteStream$.value?.getTracks() ?? [];
+				const newStream = new MediaStream([...existingTracks, event.track]);
+				this._remoteStream$.next(newStream);
+			}
 		};
 		await this.transceiverController?.setupRemoteTransceivers(this.type);
 	}
@@ -3417,7 +3520,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 		});
 	}
 	get mediaDirections() {
-		return this.transceiverController?.getMediaDirections() ?? {
+		return this.transceiverController?.getMediaDirections() ?? this._remoteOfferMediaDirections ?? {
 			audio: "inactive",
 			video: "inactive"
 		};
@@ -3576,6 +3679,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",
@@ -3647,13 +3751,13 @@ var WebRTCVertoManager = class extends VertoManager {
 		if (response.error) {
 			const error = new require_operators.JSONRPCError(response.error.code, response.error.message, response.error.data);
 			this.onError?.(error);
-			throw error;
+			return response;
 		}
 		const innerResult = require_operators.getValueFrom(response, "result.result");
 		if (innerResult?.error) {
 			const error = new require_operators.JSONRPCError(innerResult.error.code, innerResult.error.message, innerResult.error.data);
 			this.onError?.(error);
-			throw error;
+			return response;
 		}
 		return response;
 	}
@@ -3673,7 +3777,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) {
@@ -3687,12 +3791,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 && require_operators.getValueFrom(response, "result.result.result.message") === "CALL CREATED") {
+			this._signalingStatus$.next("trying");
 			this._nodeId$.next(require_operators.getValueFrom(response, "result.node_id") ?? null);
 			const memberId = require_operators.getValueFrom(response, "result.result.result.memberID") ?? null;
 			const callId = require_operators.getValueFrom(response, "result.result.result.callID") ?? null;
@@ -3747,6 +3853,36 @@ var WebRTCVertoManager = class extends VertoManager {
 		this.subscribeTo(rtcPeerConnController.errors$, (error) => {
 			this.onError?.(error);
 		});
+		if (options.initOffer) this.handleInboundAnswer(rtcPeerConnController);
+	}
+	async handleInboundAnswer(rtcPeerConnController) {
+		logger$10.debug("[WebRTCManager] Waiting for inbound call to be accepted or rejected");
+		const vertoByeOrAccepted = await (0, rxjs.firstValueFrom)((0, rxjs.race)(this.vertoBye$, this.webRtcCallSession.answered$).pipe((0, rxjs.takeUntil)(this.destroyed$))).catch(() => null);
+		if (vertoByeOrAccepted === null) {
+			logger$10.debug("[WebRTCManager] Inbound answer handler aborted (destroyed).");
+			return;
+		}
+		if (isVertoByeMessage(vertoByeOrAccepted)) {
+			logger$10.info("[WebRTCManager] Inbound call ended by remote before answer.");
+			this.callSession?.destroy();
+		} else if (!vertoByeOrAccepted) {
+			logger$10.info("[WebRTCManager] Inbound call rejected by user.");
+			try {
+				await this.bye("USER_BUSY");
+			} finally {
+				this._signalingStatus$.next("disconnected");
+				this.callSession?.destroy();
+			}
+		} else {
+			logger$10.debug("[WebRTCManager] Inbound call accepted, creating SDP answer");
+			const answerOptions = this.webRtcCallSession.answerMediaOptions;
+			try {
+				await rtcPeerConnController.acceptInbound(answerOptions);
+			} catch (error) {
+				logger$10.error("[WebRTCManager] Error creating inbound answer:", error);
+				this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
+			}
+		}
 	}
 	setupVertoAttachHandler() {
 		this.subscribeTo(this.vertoAttach$, async (vertoAttach) => {
@@ -3764,7 +3900,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		});
 	}
 	initObservables(rtcPeerConnController) {
-		this.mediaDirections$ = rtcPeerConnController.connectionState$.pipe((0, rxjs.filter)((state) => state === "connected"), (0, rxjs.takeUntil)(this.destroyed$), (0, rxjs.map)(() => rtcPeerConnController.mediaDirections));
+		this.mediaDirections$ = rtcPeerConnController.connectionState$.pipe((0, rxjs.filter)((state) => state === "connected"), (0, rxjs.map)(() => rtcPeerConnController.mediaDirections), (0, rxjs.startWith)(rtcPeerConnController.mediaDirections), (0, rxjs.takeUntil)(this.destroyed$));
 		this.localStream$ = rtcPeerConnController.localStream$.pipe(require_operators.filterNull(), (0, rxjs.takeUntil)(this.destroyed$));
 		this.remoteStream$ = rtcPeerConnController.remoteStream$.pipe(require_operators.filterNull(), (0, rxjs.takeUntil)(this.destroyed$));
 	}
@@ -3780,7 +3916,6 @@ var WebRTCVertoManager = class extends VertoManager {
 				});
 				this.sendLocalDescriptionOnceAccepted(vertoMessageRequest, rtcPeerConnController);
 			} else if (initial) {
-				this._signalingStatus$.next("trying");
 				const vertoMessageRequest = VertoInvite({
 					dialogParams,
 					sdp
@@ -4086,8 +4221,8 @@ var WebRTCCall = class extends Destroyable {
 		this.clientSession = clientSession;
 		this.options = options;
 		this.address = address;
-		this.participantsMap = /* @__PURE__ */ new Map();
-		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 });
@@ -4108,8 +4243,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);
 	}
@@ -4117,9 +4254,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() {
@@ -4159,7 +4304,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Current snapshot of all participants in the call. */
 	get participants() {
-		return Array.from(this.participantsMap.values());
+		return this.callEventsManager.participants;
 	}
 	/** The local participant, or `null` if not yet joined. */
 	get self() {
@@ -4168,7 +4313,6 @@ var WebRTCCall = class extends Destroyable {
 	async toggleLock() {
 		const method = this.locked ? "call.unlock" : "call.lock";
 		await this.executeMethod(this.selfId ?? "", method, {});
-		throw new require_operators.UnimplementedError();
 	}
 	async toggleHold() {
 		if (this._holdState) await this.vertoManager.unhold();
@@ -4210,25 +4354,31 @@ var WebRTCCall = class extends Destroyable {
 		}
 	}
 	buildMethodParams(target, args) {
-		const reference = {
-			node_id: this.nodeId,
-			call_id: this.id
+		const self = {
+			node_id: this.nodeId ?? "",
+			call_id: this.id,
+			member_id: this.vertoManager.selfId ?? ""
+		};
+		if (typeof target === "object") return {
+			...args,
+			self,
+			targets: [target]
 		};
 		return {
 			...args,
-			self: {
-				...reference,
-				member_id: this.vertoManager.selfId
-			},
+			self,
 			target: {
-				...reference,
+				node_id: this.nodeId ?? "",
+				call_id: this.id,
 				member_id: target
 			}
 		};
 	}
 	/** Observable of the current call status (e.g. `'ringing'`, `'connected'`). */
 	get status$() {
-		return this.cachedObservable("status$", () => (0, rxjs.merge)(this._status$.asObservable(), this.vertoManager.signalingStatus$));
+		return this.cachedObservable("status$", () => (0, rxjs.merge)(this._status$.asObservable(), this.vertoManager.signalingStatus$).pipe((0, rxjs.distinctUntilChanged)(), (0, rxjs.tap)((status) => {
+			this._lastMergedStatus = status;
+		})));
 	}
 	/** Observable of the participants list, emits on join/leave/update. */
 	get participants$() {
@@ -4268,7 +4418,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() {
@@ -4445,10 +4595,15 @@ var WebRTCCall = class extends Destroyable {
 	async sendDigits(dtmf) {
 		return this.vertoManager.sendDigits(dtmf);
 	}
-	/** Accepts an inbound call. */
-	answer() {
+	/** Accepts an inbound call, optionally overriding media options for the answer. */
+	answer(options) {
+		this._answerMediaOptions = options;
 		this._answered$.next(true);
 	}
+	/** Media options provided when answering. Used internally by the VertoManager. */
+	get answerMediaOptions() {
+		return this._answerMediaOptions;
+	}
 	/** Rejects an inbound call. */
 	reject() {
 		this._answered$.next(false);
@@ -4476,10 +4631,10 @@ 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();
-		this.participantsMap.clear();
 		super.destroy();
 	}
 };
@@ -4487,6 +4642,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 require_operators.RPCTimeoutError) return "timeout";
+	if (error instanceof require_operators.JSONRPCError) return "signaling";
+	if (error instanceof require_operators.MediaTrackError) return "media";
+	if (error instanceof require_operators.WebSocketConnectionError || error instanceof require_operators.TransportConnectionError) return "network";
+	return "internal";
+}
+/** Determines whether an error should be fatal (destroy the call). */
+function isFatalError(error) {
+	if (error instanceof require_operators.VertoPongError) return false;
+	if (error instanceof require_operators.MediaTrackError) return false;
+	return true;
+}
+/**
 * Factory for creating WebRTCCall instances with proper manager wiring.
 * Eliminates circular dependencies by centralizing Call and Manager creation.
 */
@@ -4507,7 +4679,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)
@@ -4884,9 +5062,15 @@ var PendingRPC = class PendingRPC {
 				return () => signal.removeEventListener("abort", abortHandler);
 			}) : rxjs.NEVER).subscribe({
 				next: (response) => {
-					logger$7.debug(`[PendingRPC(${this.id}) request:${request.id}] Resolving promise with response:`, response);
 					isSettled = true;
-					resolve(response);
+					if (response.error) {
+						const rpcError = new require_operators.RPCError(response.error.code, request.id, response.error.message, response.error.data);
+						logger$7.debug(`[PendingRPC(${this.id}) request:${request.id}] Rejecting promise with RPC error:`, rpcError);
+						reject(rpcError);
+					} else {
+						logger$7.debug(`[PendingRPC(${this.id}) request:${request.id}] Resolving promise with response:`, response);
+						resolve(response);
+					}
 					subscription.unsubscribe();
 				},
 				error: (error) => {
@@ -4942,7 +5126,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({});
@@ -5212,12 +5396,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, rxjs.firstValueFrom)(callSession.selfId$.pipe((0, rxjs.filter)((id) => Boolean(id)), (0, rxjs.take)(1), (0, rxjs.timeout)(this.callCreateTimeout)));
+			await (0, rxjs.firstValueFrom)((0, rxjs.race)(callSession.selfId$.pipe((0, rxjs.filter)((id) => Boolean(id)), (0, rxjs.take)(1), (0, rxjs.timeout)(this.callCreateTimeout)), callSession.errors$.pipe((0, rxjs.take)(1), (0, rxjs.switchMap)((callError) => (0, rxjs.throwError)(() => callError.error)))));
 			this._calls$.next({
 				[`${callSession.id}`]: callSession,
 				...this._calls$.value
@@ -5225,7 +5410,8 @@ var ClientSessionManager = class extends Destroyable {
 			return callSession;
 		} catch (error) {
 			logger$6.error("[Session] Error creating outbound call:", error);
-			const callError = new require_operators.CallCreateError("Call create timeout", error);
+			callSession?.destroy();
+			const callError = new require_operators.CallCreateError(error instanceof rxjs.TimeoutError ? "Call create timeout" : "Call creation failed", error, "outbound");
 			this._errors$.next(callError);
 			throw callError;
 		}
@@ -5251,7 +5437,7 @@ var ClientSessionManager = class extends Destroyable {
 			return callSession;
 		} catch (error) {
 			logger$6.error("[Session] Error creating call session:", error);
-			throw new require_operators.CallCreateError("Call create error", error);
+			throw new require_operators.CallCreateError("Call create error", error, options.initOffer ? "inbound" : "outbound");
 		}
 	}
 	destroy() {
@@ -5497,7 +5683,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;
@@ -5822,7 +6008,8 @@ const buildOptionsFromDestination = (destination) => {
 			const channel = new URLSearchParams(queryString).get("channel");
 			if (channel === "video") return {
 				audio: true,
-				video: true
+				video: true,
+				receiveVideo: true
 			};
 			else if (channel === "audio") return {
 				audio: true,
@@ -5852,7 +6039,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 = {
@@ -5929,7 +6116,12 @@ var SignalWire = class extends Destroyable {
 		this._subscriber$.next(new Subscriber(this._deps.http));
 		if (!this._options.skipConnection) await this.connect();
 		if (!this._options.reconnectAttachedCalls && this._attachManager) await this._attachManager.flush();
-		if (!this._options.skipRegister) this.register();
+		if (!this._options.skipRegister) try {
+			await this.register();
+		} catch (error) {
+			logger$1.error("[SignalWire] Registration failed:", error);
+			this._errors$.next(error instanceof Error ? error : new Error(String(error), { cause: error }));
+		}
 		this.handleAttachments();
 	}
 	async handleAttachments() {
@@ -6092,8 +6284,22 @@ var SignalWire = class extends Destroyable {
 			}));
 			this._isRegistered$.next(true);
 		} catch (error) {
-			logger$1.error("[SignalWire] Failed to register subscriber:", error);
+			logger$1.debug("[SignalWire] Failed to register subscriber, trying reauthentication...");
+			if (this._deps.credential.token) this._clientSession.reauthenticate(this._deps.credential.token).then(async () => {
+				logger$1.debug("[SignalWire] Reauthentication successful, retrying register()");
+				await this._transport.execute(RPCExecute({
+					method: "subscriber.online",
+					params: {}
+				}));
+				this._isRegistered$.next(true);
+			}).catch((reauthError) => {
+				logger$1.error("[SignalWire] Reauthentication failed during register():", reauthError);
+				const registerError = new require_operators.InvalidCredentialsError("Failed to register subscriber, and reauthentication attempt also failed. Please check your credentials.", { cause: reauthError instanceof Error ? reauthError : new Error(String(reauthError), { cause: reauthError }) });
+				this._errors$.next(registerError);
+				throw registerError;
+			});
 			this._errors$.next(error instanceof Error ? error : new Error(String(error), { cause: error }));
+			throw error;
 		}
 	}
 	/** Unregisters the subscriber, going offline for inbound calls. */