@signalwire/js 4.0.0-rc.1 → 4.0.0-rc.2

package/dist/index.mjs

@@ -1,6 +1,6 @@
-import { A as StorageNotAvailableError, B as VertoPongError, C as OverconstrainedFallbackError, D as RequestError, E as RecoveryError, F as UnexpectedError, H as WebSocketTimeoutError, I as UnimplementedError, L as ValidationError, M as StorageWriteError, N as TokenRefreshError, O as RequestTimeoutError, P as TransportConnectionError, R as VertoAttachHandlerError, S as MessageParseError, T as RPCTimeoutError, V as WebSocketConnectionError, _ as DeviceTokenError, a as filterNull, b as JSONRPCError, c as setLogLevel, d as CallCreateError, f as CollectionFetchError, g as DeserializationError, h as DependencyError, i as getValueFrom, j as StorageReadError, k as SerializationError, l as setLogger, m as DPoPInitError, n as filterAs, o as getLogger, p as ConversationError, s as setDebugOptions, t as throwOnRPCError, u as AuthStateHandlerError, v as InvalidCredentialsError, w as PreflightError, x as MediaTrackError, y as InvalidParams, z as VertoInviteHandlerError } from "./operators-CX_lCCJm.mjs";
+import { $ as DEFAULT_DEGRADATION_BITRATE_THRESHOLD_KBPS, $t as VAD_HOLD_MS, A as SerializationError, At as DEFAULT_STATS_POLLING_INTERVAL_MS, B as VertoInviteHandlerError, Bt as DEVICE_TOKEN_ENDPOINT, C as MessageParseError, Ct as DEFAULT_REINVITE_MAX_ATTEMPTS, D as RecoveryError, Dt as DEFAULT_STATS_JITTER_SPIKE_MULTIPLIER, E as RPCTimeoutError, Et as DEFAULT_STATS_HISTORY_SIZE, F as TransportConnectionError, Ft as DEVICE_REFRESH_ENDPOINT, G as CREDENTIAL_ACTIVATE_TIMEOUT_MS, Gt as INVITE_VERSION, H as WebSocketConnectionError, Ht as DEVICE_TOKEN_REFRESH_MAX_RETRIES, I as UnexpectedError, It as DEVICE_STORAGE_KEY_AUDIO_INPUT, J as CREDENTIAL_REFRESH_MAX_RETRIES, Jt as PREFERENCES_STORAGE_KEY, K as CREDENTIAL_REFRESH_BUFFER_MS, Kt as PEER_CONNECTION_RECOVERY_POLL_MS, L as UnimplementedError, Lt as DEVICE_STORAGE_KEY_AUDIO_OUTPUT, M as StorageReadError, Mt as DEFAULT_STEREO_AUDIO, N as StorageWriteError, Nt as DEFAULT_STEREO_MAX_AVERAGE_BITRATE, O as RequestError, Ot as DEFAULT_STATS_NO_PACKET_THRESHOLD_MS, P as TokenRefreshError, Pt as DEFAULT_SYNC_DEVICES_TO_ACTIVE_CALLS, Q as DEFAULT_CONNECTION_TIMEOUT_MS, Qt as SAT_REFRESH_SCOPE, R as ValidationError, Rt as DEVICE_STORAGE_KEY_VIDEO_INPUT, S as MediaTrackError, St as DEFAULT_REINVITE_DEBOUNCE_TIME_MS, T as PreflightError, Tt as DEFAULT_STATS_BASELINE_SAMPLES, U as WebSocketTimeoutError, Ut as DEVICE_TOKEN_REFRESH_RETRY_BASE_MS, V as VertoPongError, Vt as DEVICE_TOKEN_REFRESH_BUFFER_MS, W as AUDIO_LEVEL_POLL_INTERVAL_MS, Wt as ICE_GATHERING_COMPLETE_TIMEOUT_MS, X as DEFAULT_AUTO_MUTE_VIDEO_ON_HIDDEN, Xt as RPC_ERROR_INVALID_PARAMS, Y as CREDENTIAL_REFRESH_RETRY_BASE_MS, Yt as RPC_ERROR_AUTHENTICATION_FAILED, Z as DEFAULT_CHECK_CONNECTION_ON_VISIBLE, Zt as RPC_ERROR_REQUESTER_VALIDATION_FAILED, _ as DeviceTokenError, _t as DEFAULT_RECONNECT_DELAY_MAX_MS, a as filterNull, at as DEFAULT_ENABLE_RELAY_FALLBACK, b as JSONRPCError, bt as DEFAULT_RECOVERY_DEBOUNCE_TIME_MS, c as setLogLevel, ct as DEFAULT_ICE_DISCONNECTED_GRACE_PERIOD_MS, d as CallCreateError, dt as DEFAULT_KEYFRAME_BURST_WINDOW_MS$1, en as VAD_THRESHOLD, et as DEFAULT_DEGRADATION_RECOVERY_THRESHOLD_KBPS, f as CollectionFetchError, ft as DEFAULT_KEYFRAME_COOLDOWN_MS$1, g as DeserializationError, gt as DEFAULT_RECONNECT_CALLS_TIMEOUT_MS, h as DependencyError, ht as DEFAULT_PERSIST_DEVICE_SELECTION, i as getValueFrom, it as DEFAULT_ENABLE_NETWORK_CHANGE_DETECTION, j as StorageNotAvailableError, jt as DEFAULT_STATS_RTT_SPIKE_MULTIPLIER, k as RequestTimeoutError, kt as DEFAULT_STATS_PACKET_LOSS_THRESHOLD, l as setLogger, lt as DEFAULT_ICE_GATHERING_TIMEOUT_MS, m as DPoPInitError, mt as DEFAULT_MAX_RECOVERY_ATTEMPTS, n as filterAs, nt as DEFAULT_DEVICE_POLLING_INTERVAL_MS, o as getLogger, ot as DEFAULT_ENABLE_SERVER_HANGUP_INTERCEPTION, p as ConversationError, pt as DEFAULT_KEYFRAME_MAX_BURST$1, q as CREDENTIAL_REFRESH_MAX_DELAY_MS, qt as PEER_CONNECTION_RECOVERY_WAIT_MS, rt as DEFAULT_ENABLE_AUTO_DEGRADATION, s as setDebugOptions, st as DEFAULT_ICE_CANDIDATE_TIMEOUT_MS, t as throwOnRPCError, tt as DEFAULT_DEVICE_DEBOUNCE_TIME_MS, u as AuthStateHandlerError, ut as DEFAULT_ICE_RESTART_TIMEOUT_MS$1, v as InvalidCredentialsError, vt as DEFAULT_RECONNECT_DELAY_MIN_MS, w as OverconstrainedFallbackError, wt as DEFAULT_REINVITE_TIMEOUT_MS, x as MediaAccessError, xt as DEFAULT_REFRESH_DEVICES_ON_VISIBLE, y as InvalidParams, yt as DEFAULT_RECOVERY_COOLDOWN_MS, z as VertoAttachHandlerError, zt as DEVICE_TOKEN_DEFAULT_EXPIRE_IN } from "./operators-BlUtq-t0.mjs";
 import { jwtDecode } from "jwt-decode";
-import { BehaviorSubject, EMPTY, NEVER, Observable, ReplaySubject, Subject, TimeoutError, animationFrameScheduler, asapScheduler, auditTime, catchError, combineLatest, debounceTime, defer, distinctUntilChanged, exhaustMap, filter, first, firstValueFrom, from, interval, lastValueFrom, map, merge, mergeMap, observeOn, of, pipe, race, scan, share, shareReplay, skip, skipWhile, startWith, switchMap, take, takeUntil, tap, throwError, timeout, timer, toArray, withLatestFrom } from "rxjs";
+import { BehaviorSubject, EMPTY, EmptyError, NEVER, Observable, ReplaySubject, Subject, TimeoutError, animationFrameScheduler, asapScheduler, auditTime, catchError, combineLatest, debounceTime, defer, distinctUntilChanged, exhaustMap, filter, first, firstValueFrom, from, interval, lastValueFrom, map, merge, mergeMap, observeOn, of, pipe, race, scan, share, shareReplay, skip, skipWhile, startWith, switchMap, take, takeUntil, tap, throwError, timeout, timer, toArray, withLatestFrom } from "rxjs";
 import { v4 } from "uuid";
 import { distinctUntilChanged as distinctUntilChanged$1, map as map$1 } from "rxjs/operators";
 
@@ -404,137 +404,6 @@ var DeviceHistoryManager = class {
 	}
 };
 
-//#endregion
-//#region src/core/constants.ts
-const INVITE_VERSION = 1e3;
-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;
-const DEFAULT_RECONNECT_DELAY_MIN_MS = 100;
-const DEFAULT_RECONNECT_DELAY_MAX_MS = 3e3;
-const DEFAULT_DEVICE_DEBOUNCE_TIME_MS = 1500;
-const DEFAULT_DEVICE_POLLING_INTERVAL_MS = 0;
-const PREFERENCES_STORAGE_KEY = "sw:preferences";
-/** Scope value that enables automatic token refresh. */
-const SAT_REFRESH_SCOPE = "sat:refresh";
-/** API endpoints for device token operations. */
-const DEVICE_TOKEN_ENDPOINT = "/api/fabric/subscriber/devices/token";
-const DEVICE_REFRESH_ENDPOINT = "/api/fabric/subscriber/devices/refresh";
-/** Default device token TTL in seconds (15 minutes). */
-const DEVICE_TOKEN_DEFAULT_EXPIRE_IN = 900;
-/** Buffer time in milliseconds before expiry to trigger refresh. */
-const DEVICE_TOKEN_REFRESH_BUFFER_MS = 3e4;
-/** Maximum retry attempts for device token refresh on transient failure. */
-const DEVICE_TOKEN_REFRESH_MAX_RETRIES = 3;
-/** Base delay in milliseconds for exponential backoff on refresh retry. */
-const DEVICE_TOKEN_REFRESH_RETRY_BASE_MS = 1e3;
-/** Maximum retry attempts for developer credential refresh on transient failure. */
-const CREDENTIAL_REFRESH_MAX_RETRIES = 5;
-/** Base delay in milliseconds for exponential backoff on credential refresh retry. */
-const CREDENTIAL_REFRESH_RETRY_BASE_MS = 1e3;
-/** Maximum delay in milliseconds for credential refresh backoff. */
-const CREDENTIAL_REFRESH_MAX_DELAY_MS = 3e4;
-/** Buffer in milliseconds before token expiry to trigger refresh. */
-const CREDENTIAL_REFRESH_BUFFER_MS = 5e3;
-/**
-* Maximum time the coordinator will wait for `DeviceTokenManager.activate()`
-* to resolve before treating the activation as failed and falling back to
-* the developer-provided refresh path. Prevents a wedged HTTP layer from
-* leaving the session with no active refresh mechanism.
-*/
-const CREDENTIAL_ACTIVATE_TIMEOUT_MS = 3e4;
-/** JSON-RPC error code for requester validation failure (corrupted auth state). */
-const RPC_ERROR_REQUESTER_VALIDATION_FAILED = -32003;
-/** JSON-RPC error code for invalid params (e.g., missing authentication block). */
-const RPC_ERROR_INVALID_PARAMS = -32602;
-/** JSON-RPC error code for authentication failure (invalid token, missing DPoP, etc.). */
-const RPC_ERROR_AUTHENTICATION_FAILED = -32002;
-/** 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. */
-const DEFAULT_STATS_BASELINE_SAMPLES = 10;
-/** Duration in ms with no inbound audio packets before emitting a critical issue. */
-const DEFAULT_STATS_NO_PACKET_THRESHOLD_MS = 2e3;
-/** Multiplier applied to baseline RTT to detect a warning-level RTT spike. */
-const DEFAULT_STATS_RTT_SPIKE_MULTIPLIER = 3;
-/** Packet loss fraction (0-1) above which a warning is emitted. */
-const DEFAULT_STATS_PACKET_LOSS_THRESHOLD = .05;
-/** Multiplier applied to baseline jitter to detect a jitter spike. */
-const DEFAULT_STATS_JITTER_SPIKE_MULTIPLIER = 4;
-/** Number of seconds of metrics history to retain. */
-const DEFAULT_STATS_HISTORY_SIZE = 30;
-/** Maximum keyframe requests allowed within a single burst window. */
-const DEFAULT_KEYFRAME_MAX_BURST$1 = 3;
-/** Duration of the keyframe burst window in milliseconds. */
-const DEFAULT_KEYFRAME_BURST_WINDOW_MS$1 = 3e3;
-/** Cooldown period in ms after burst limit is reached before allowing more keyframes. */
-const DEFAULT_KEYFRAME_COOLDOWN_MS$1 = 1e4;
-/** Minimum time between re-INVITE attempts in milliseconds. */
-const DEFAULT_REINVITE_DEBOUNCE_TIME_MS = 1e4;
-/** Maximum number of re-INVITE attempts per call. */
-const DEFAULT_REINVITE_MAX_ATTEMPTS = 3;
-/** Timeout for a single re-INVITE attempt in milliseconds. */
-const DEFAULT_REINVITE_TIMEOUT_MS = 5e3;
-/** Debounce window in ms to collapse multiple detection signals into one trigger. */
-const DEFAULT_RECOVERY_DEBOUNCE_TIME_MS = 2e3;
-/** Cooldown period in ms between recovery attempts. */
-const DEFAULT_RECOVERY_COOLDOWN_MS = 1e4;
-/** Grace period in ms before treating ICE 'disconnected' as a failure. */
-const DEFAULT_ICE_DISCONNECTED_GRACE_PERIOD_MS = 3e3;
-/** Timeout for a single ICE restart attempt in milliseconds. */
-const DEFAULT_ICE_RESTART_TIMEOUT_MS$1 = 5e3;
-/** Maximum recovery attempts before emitting 'max_attempts_reached'. */
-const DEFAULT_MAX_RECOVERY_ATTEMPTS = 3;
-/** Upper bound in ms for waiting on iceGatheringState === 'complete' after an ICE restart. */
-const ICE_GATHERING_COMPLETE_TIMEOUT_MS = 1e4;
-/** Upper bound in ms for waiting on RTCPeerConnection.connectionState === 'connected' after a recovery ICE restart. */
-const PEER_CONNECTION_RECOVERY_WAIT_MS = 5e3;
-/** Polling interval in ms while waiting for RTCPeerConnection.connectionState to transition. */
-const PEER_CONNECTION_RECOVERY_POLL_MS = 100;
-/** Polling interval for LocalAudioPipeline.level$ (ms). ~30fps is smooth for meters. */
-const AUDIO_LEVEL_POLL_INTERVAL_MS = 33;
-/** RMS level threshold (0..1) above which the local participant is considered speaking. */
-const VAD_THRESHOLD = .03;
-/** Hold window in ms below the threshold before speaking$ flips back to false. */
-const VAD_HOLD_MS = 250;
-/** Whether to persist device selections to storage by default. */
-const DEFAULT_PERSIST_DEVICE_SELECTION = true;
-/** Whether to auto-apply device changes to active calls by default. */
-const DEFAULT_SYNC_DEVICES_TO_ACTIVE_CALLS = true;
-/** Storage keys for persisted device selections. */
-const DEVICE_STORAGE_KEY_AUDIO_INPUT = "sw:device:audioinput";
-const DEVICE_STORAGE_KEY_AUDIO_OUTPUT = "sw:device:audiooutput";
-const DEVICE_STORAGE_KEY_VIDEO_INPUT = "sw:device:videoinput";
-/** Whether to auto-mute video when the tab becomes hidden. */
-const DEFAULT_AUTO_MUTE_VIDEO_ON_HIDDEN = false;
-/** Whether to re-enumerate devices when the page becomes visible. */
-const DEFAULT_REFRESH_DEVICES_ON_VISIBLE = true;
-/** Whether to check peer connection health when the page becomes visible. */
-const DEFAULT_CHECK_CONNECTION_ON_VISIBLE = true;
-/** Whether automatic video degradation on low bandwidth is enabled. */
-const DEFAULT_ENABLE_AUTO_DEGRADATION = true;
-/** Bitrate in kbps below which video is automatically disabled. */
-const DEFAULT_DEGRADATION_BITRATE_THRESHOLD_KBPS = 150;
-/** Bitrate in kbps above which video is automatically re-enabled (hysteresis). */
-const DEFAULT_DEGRADATION_RECOVERY_THRESHOLD_KBPS = 300;
-/** Whether relay-only escalation is enabled as a last-resort recovery tier. */
-const DEFAULT_ENABLE_RELAY_FALLBACK = true;
-/** Whether to listen for browser online/offline/connection events. */
-const DEFAULT_ENABLE_NETWORK_CHANGE_DETECTION = true;
-/** Whether to intercept server-sent media-timeout hangups and attempt recovery. */
-const DEFAULT_ENABLE_SERVER_HANGUP_INTERCEPTION = true;
-/** Default video track constraints applied when video is enabled without explicit constraints. */
-const DEFAULT_VIDEO_CONSTRAINTS = {
-	width: { ideal: 1280 },
-	height: { ideal: 720 },
-	aspectRatio: 16 / 9
-};
-/** Whether stereo Opus is enabled by default. */
-const DEFAULT_STEREO_AUDIO = false;
-/** Max average bitrate for stereo Opus in bits per second. */
-const DEFAULT_STEREO_MAX_AVERAGE_BITRATE = 51e4;
-
 //#endregion
 //#region src/utils/time.ts
 function fromSecToMs(seconds) {
@@ -3687,12 +3556,21 @@ var SelfParticipant = class extends Participant {
 			noise_suppression: true
 		});
 	}
-	/** Starts sharing the local screen. */
+	/**
+	* Starts sharing the local screen.
+	*
+	* The call is unaffected when acquisition fails.
+	*
+	* @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.
+	*/
 	async startScreenShare() {
 		try {
 			await this.vertoManager.addScreenMedia();
 		} catch (error) {
 			logger$23.error("[Participant.startScreenShare] Screen share error:", error);
+			throw error;
 		}
 	}
 	/** Observable of the current screen share status. */
@@ -3707,12 +3585,20 @@ var SelfParticipant = class extends Participant {
 	async stopScreenShare() {
 		return this.vertoManager.removeScreenMedia();
 	}
-	/** Adds an additional media input device to the call. */
+	/**
+	* Adds an additional media input device to the call.
+	*
+	* The call is unaffected when acquisition fails.
+	*
+	* @throws The raw `getUserMedia` error (e.g. `NotAllowedError` on
+	* permission denial) — inspect `error.name` to decide how to react.
+	*/
 	async addAdditionalDevice(options) {
 		try {
 			await this.vertoManager.addInputDevice(options);
 		} catch (error) {
-			logger$23.error("[Participant.startScreenShare] Screen share error:", error);
+			logger$23.error("[Participant.addAdditionalDevice] Additional device error:", error);
+			throw error;
 		}
 	}
 	/** Removes an additional media input device by ID. */
@@ -5206,7 +5092,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 				logger$17.debug(`[RTCPeerConnectionController] ${kind} input device selected:`, deviceInfo?.label);
 			} catch (error) {
 				logger$17.error(`[RTCPeerConnectionController] Failed to select ${kind} input device:`, error);
-				this._errors$.next(toError(error));
+				this._errors$.next(new MediaTrackError("updateSelectedInputDevice", kind, error));
 				throw error;
 			}
 		};
@@ -5428,7 +5314,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 			case "main":
 			default: return {
 				...options,
-				offerToReceiveAudio: true,
+				offerToReceiveAudio: this.options.receiveAudio ?? true,
 				offerToReceiveVideo: this.options.receiveVideo ?? Boolean(this.inputVideoDeviceConstraints)
 			};
 		}
@@ -5582,13 +5468,14 @@ var RTCPeerConnectionController = class extends Destroyable {
 	*/
 	async acceptInbound(mediaOverrides) {
 		if (mediaOverrides) {
-			const { audio, video, receiveAudio, receiveVideo } = mediaOverrides;
+			const { audio, video, receiveAudio, receiveVideo, fallbackToReceiveOnly } = mediaOverrides;
 			this.options = {
 				...this.options,
 				...audio !== void 0 ? { audio } : {},
 				...video !== void 0 ? { video } : {},
 				...receiveAudio !== void 0 ? { receiveAudio } : {},
-				...receiveVideo !== void 0 ? { receiveVideo } : {}
+				...receiveVideo !== void 0 ? { receiveVideo } : {},
+				...fallbackToReceiveOnly !== void 0 ? { fallbackToReceiveOnly } : {}
 			};
 			this.transceiverController?.updateOptions({
 				receiveAudio: this.receiveAudio,
@@ -5745,7 +5632,19 @@ var RTCPeerConnectionController = class extends Destroyable {
 	}
 	async setupLocalTracks() {
 		logger$17.debug("[RTCPeerConnectionController] Setting up local tracks/transceivers.");
-		const localStream = this.localStream ?? await this.localStreamController.buildLocalStream();
+		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;
+		}
+		let localStream;
+		try {
+			localStream = this.localStream ?? await this.localStreamController.buildLocalStream();
+		} catch (error) {
+			this.handleLocalMediaFailure(error);
+			return;
+		}
 		if (this.transceiverController?.useAddStream ?? false) {
 			logger$17.warn("[RTCPeerConnectionController] Using deprecated addStream API to add local stream.");
 			this.peerConnection?.addStream(localStream);
@@ -5772,6 +5671,48 @@ var RTCPeerConnectionController = class extends Destroyable {
 			}
 		}
 	}
+	/** True for a main connection with no local media to send. */
+	hasNoLocalMediaToSend() {
+		const hasInputStreams = Boolean(this.options.inputAudioStream ?? this.options.inputVideoStream);
+		return this.propose === "main" && !this.localStream && !hasInputStreams && !this.inputAudioDeviceConstraints && !this.inputVideoDeviceConstraints;
+	}
+	/** The media kinds this connection wants to send: 'audiovideo' | 'video' | 'audio'. */
+	get requestedMediaKinds() {
+		const wantsAudio = Boolean(this.inputAudioDeviceConstraints);
+		const wantsVideo = Boolean(this.inputVideoDeviceConstraints);
+		if (wantsAudio && wantsVideo) return "audiovideo";
+		return wantsVideo ? "video" : "audio";
+	}
+	/**
+	* Handle a local media acquisition failure with a typed, semantically
+	* accurate MediaAccessError created at the acquisition site:
+	* - Auxiliary connections (screenshare / additional-device) throw a
+	*   non-fatal error — VertoManager surfaces it and the call is unaffected.
+	* - The main connection degrades to receive-only when allowed (default),
+	*   otherwise fails with a fatal error.
+	*/
+	handleLocalMediaFailure(error) {
+		if (this.propose === "screenshare") throw new MediaAccessError("startScreenShare", "screen", error, false);
+		if (this.propose === "additional-device") throw new MediaAccessError("addInputDevice", this.requestedMediaKinds, error, false);
+		const canReceive = this.receiveAudio || this.receiveVideo;
+		if (!((this.options.fallbackToReceiveOnly ?? true) && canReceive)) throw new MediaAccessError("acquireLocalMedia", this.requestedMediaKinds, error, true);
+		logger$17.warn("[RTCPeerConnectionController] Local media unavailable; continuing receive-only:", error);
+		this._errors$.next(new MediaAccessError("acquireLocalMedia", this.requestedMediaKinds, error, false));
+		this.setupReceiveOnlyTransceivers();
+	}
+	/**
+	* Negotiate receive-only m-lines when there are no local tracks to send.
+	* Only offer-type connections add transceivers — answer-type connections
+	* reuse the transceivers created from the remote offer.
+	*/
+	setupReceiveOnlyTransceivers() {
+		if (this.type !== "offer") return;
+		if (this.transceiverController?.useAddTransceivers ?? false) {
+			this.peerConnection?.addTransceiver("audio", { direction: this.receiveAudio ? "recvonly" : "inactive" });
+			this.peerConnection?.addTransceiver("video", { direction: this.receiveVideo ? "recvonly" : "inactive" });
+		}
+		if (!this.isNegotiating) this.negotiationNeeded$.next();
+	}
 	async getUserMedia(constraints) {
 		return (this.options.webRTCApiProvider?.mediaDevices ?? navigator.mediaDevices).getUserMedia(constraints);
 	}
@@ -5808,7 +5749,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 			stream = await this.getUserMedia({ audio: constraints });
 		} catch (error) {
 			logger$17.error("[RTCPeerConnectionController] Failed to re-acquire mic for pipeline restore:", error);
-			this._errors$.next(toError(error));
+			this._errors$.next(new MediaTrackError("restoreAudioPipelineInput", "audio", error));
 			return;
 		}
 		const newTrack = stream.getAudioTracks().at(0);
@@ -5870,7 +5811,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 			logger$17.debug(`[RTCPeerConnectionController] ${track.kind} track added:`, track.id);
 		} catch (error) {
 			logger$17.error(`[RTCPeerConnectionController] Failed to add ${track.kind} track:`, error);
-			this._errors$.next(toError(error));
+			this._errors$.next(new MediaTrackError("addLocalTrack", track.kind, error));
 			throw error;
 		}
 	}
@@ -5895,7 +5836,7 @@ var RTCPeerConnectionController = class extends Destroyable {
 			logger$17.debug(`[RTCPeerConnectionController] ${sender.track?.kind} track removed:`, trackId);
 		} catch (error) {
 			logger$17.error(`[RTCPeerConnectionController] Failed to remove ${sender.track?.kind} track:`, error);
-			this._errors$.next(toError(error));
+			this._errors$.next(new MediaTrackError("removeLocalTrack", sender.track?.kind ?? "unknown", error));
 			throw error;
 		}
 	}
@@ -6503,6 +6444,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			inputVideoStream: options.inputVideoStream,
 			receiveAudio: options.receiveAudio,
 			receiveVideo: options.receiveVideo,
+			fallbackToReceiveOnly: options.fallbackToReceiveOnly,
 			webRTCApiProvider: this.webRTCApiProvider,
 			preferredVideoCodecs: options.preferredVideoCodecs,
 			preferredAudioCodecs: options.preferredAudioCodecs,
@@ -6729,9 +6671,11 @@ var WebRTCVertoManager = class extends VertoManager {
 		await this.initAdditionalPeerConnection("screenshare", options);
 	}
 	async initAdditionalPeerConnection(propose, options) {
+		const isScreenShare = propose === "screenshare";
+		let firstPeerConnectionError;
 		let rtcPeerConnController = null;
 		try {
-			this._screenShareStatus$.next("starting");
+			if (isScreenShare) this._screenShareStatus$.next("starting");
 			rtcPeerConnController = new RTCPeerConnectionController({
 				...options,
 				...this.RTCPeerConnectionConfig,
@@ -6739,21 +6683,27 @@ var WebRTCVertoManager = class extends VertoManager {
 				webRTCApiProvider: this.webRTCApiProvider
 			}, void 0, this.deviceController);
 			this.setupLocalDescriptionHandler(rtcPeerConnController);
-			if (propose === "screenshare") this._screenShareId = rtcPeerConnController.id;
+			if (isScreenShare) this._screenShareId = rtcPeerConnController.id;
 			this._rtcPeerConnectionsMap.set(rtcPeerConnController.id, rtcPeerConnController);
 			this._rtcPeerConnections$.next(Array.from(this._rtcPeerConnectionsMap.values()));
 			this.subscribeTo(rtcPeerConnController.errors$, (error) => {
-				this.onError?.(error);
+				firstPeerConnectionError ??= error;
+				this.onError?.(error, { fatal: false });
 			});
 			await firstValueFrom(rtcPeerConnController.connectionState$.pipe(filter((state) => state === "connected"), take(1), timeout(this._screenShareTimeoutMs), takeUntil(this.destroyed$)));
-			this._screenShareStatus$.next("started");
-			logger$16.info("[WebRTCManager] Screen share started successfully.");
+			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);
-			this.onError?.(error instanceof Error ? error : new Error(String(error), { cause: error }));
 			if (rtcPeerConnController) rtcPeerConnController.destroy();
-			this._screenShareStatus$.next("none");
+			if (isScreenShare) this._screenShareStatus$.next("none");
+			if (firstPeerConnectionError) throw firstPeerConnectionError instanceof MediaAccessError && firstPeerConnectionError.originalError instanceof Error ? firstPeerConnectionError.originalError : firstPeerConnectionError;
+			if (error instanceof EmptyError) {
+				logger$16.debug("[WebRTCManager] Additional peer connection aborted before connecting.");
+				return;
+			}
+			throw error instanceof Error ? error : new Error(String(error), { cause: error });
 		}
 	}
 	async removeInputDevices(id) {
@@ -8696,6 +8646,7 @@ function inferCallErrorKind(error) {
 	if (error instanceof RPCTimeoutError) return "timeout";
 	if (error instanceof JSONRPCError) return "signaling";
 	if (error instanceof MediaTrackError) return "media";
+	if (error instanceof MediaAccessError) return "media";
 	if (error instanceof WebSocketConnectionError || error instanceof TransportConnectionError) return "network";
 	return "internal";
 }
@@ -8712,6 +8663,7 @@ const RECOVERABLE_RPC_CODES = new Set([
 function isFatalError(error) {
 	if (error instanceof VertoPongError) return false;
 	if (error instanceof MediaTrackError) return false;
+	if (error instanceof MediaAccessError) return error.fatal;
 	if (error instanceof RPCTimeoutError) return false;
 	if (error instanceof JSONRPCError && RECOVERABLE_RPC_CODES.has(error.code)) return false;
 	return true;
@@ -8737,10 +8689,10 @@ var CallFactory = class {
 				return {
 					vertoManager: new WebRTCVertoManager(callInstance, this.attachManager, this.deviceController, this.webRTCApiProvider, {
 						nodeId: options.nodeId,
-						onError: (error) => {
+						onError: (error, options$1) => {
 							const callError = {
 								kind: inferCallErrorKind(error),
-								fatal: isFatalError(error),
+								fatal: options$1?.fatal ?? isFatalError(error),
 								error,
 								callId: callInstance.id
 							};
@@ -9199,6 +9151,17 @@ var PendingRPC = class PendingRPC {
 //#endregion
 //#region src/managers/ClientSessionManager.ts
 const logger$9 = getLogger();
+/**
+* Decide whether an error emitted on `call.errors$` during dial should
+* abort the dial. A non-fatal MediaAccessError means the call degraded to
+* receive-only and still connects — everything else rejects `dial()` with
+* the real cause.
+*
+* Pure function — exported for unit testing.
+*/
+function shouldAbortDial(callError) {
+	return callError.fatal || !(callError.error instanceof MediaAccessError);
+}
 const getAddressSearchURI = (options) => {
 	const to = options.to?.split("?")[0];
 	const from$1 = options.from?.startsWith("subscriber://") ? options.from.replace("subscriber://", "") : options.from;
@@ -9625,7 +9588,7 @@ var ClientSessionManager = class extends Destroyable {
 				to: destinationURI,
 				...options
 			});
-			await firstValueFrom(race(callSession.selfId$.pipe(filter((id) => Boolean(id)), take(1), timeout(this.callCreateTimeout)), callSession.errors$.pipe(take(1), switchMap((callError) => throwError(() => callError.error)))));
+			await firstValueFrom(race(callSession.selfId$.pipe(filter((id) => Boolean(id)), take(1), timeout(this.callCreateTimeout)), callSession.errors$.pipe(filter(shouldAbortDial), take(1), switchMap((callError) => throwError(() => callError.error)))));
 			this._calls$.next({
 				[`${callSession.id}`]: callSession,
 				...this._calls$.value
@@ -11331,7 +11294,7 @@ var SignalWire = class extends Destroyable {
 			logger$1.warn("[SignalWire] Failed to initialize VisibilityController:", error);
 		}
 		try {
-			this._diagnosticsCollector = new DiagnosticsCollector({ sdkVersion: "4.0.0-rc.1" });
+			this._diagnosticsCollector = new DiagnosticsCollector({ sdkVersion: "4.0.0-rc.2" });
 		} catch (error) {
 			logger$1.warn("[SignalWire] Failed to initialize DiagnosticsCollector:", error);
 		}
@@ -11865,7 +11828,7 @@ var StaticCredentialProvider = class {
 /**
 * Library version from package.json, injected at build time.
 */
-const version = "4.0.0-rc.1";
+const version = "4.0.0-rc.2";
 /**
 * Flag indicating the library has been loaded and is ready to use.
 * For UMD builds: `window.SignalWire.ready`
@@ -11887,12 +11850,12 @@ const ready = true;
 */
 const emitReadyEvent = () => {
 	if (typeof window !== "undefined") {
-		const event = new CustomEvent("signalwire:js:ready", { detail: { version: "4.0.0-rc.1" } });
+		const event = new CustomEvent("signalwire:js:ready", { detail: { version: "4.0.0-rc.2" } });
 		window.dispatchEvent(event);
 	}
 };
 emitReadyEvent();
 
 //#endregion
-export { Address, CallCreateError, ClientPreferences, CollectionFetchError, DPoPInitError, DeviceTokenError, EmbedTokenCredentialProvider, InvalidCredentialsError, MediaTrackError, MessageParseError, OverconstrainedFallbackError, Participant, PreflightError, RecoveryError, SelfCapabilities, SelfParticipant, SignalWire, StaticCredentialProvider, TokenRefreshError, UnexpectedError, User, VertoPongError, WebRTCCall, embeddableCall, getLogger, isSelfParticipant, ready, setDebugOptions, setLogLevel, setLogger, version };
+export { Address, CallCreateError, ClientPreferences, CollectionFetchError, DPoPInitError, DeviceTokenError, EmbedTokenCredentialProvider, InvalidCredentialsError, MediaAccessError, MediaTrackError, MessageParseError, OverconstrainedFallbackError, Participant, PreflightError, RecoveryError, SelfCapabilities, SelfParticipant, SignalWire, StaticCredentialProvider, TokenRefreshError, UnexpectedError, User, VertoPongError, WebRTCCall, embeddableCall, getLogger, isSelfParticipant, ready, setDebugOptions, setLogLevel, setLogger, version };
 //# sourceMappingURL=index.mjs.map