@signalwire/js 4.0.0-dev-20260318145605 → 4.0.0-dev-20260326210326

package/dist/browser.mjs

@@ -2879,7 +2879,7 @@ var require_observeOn = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var executeSchedule_1$7 = require_executeSchedule();
 	var lift_1$67 = require_lift();
 	var OperatorSubscriber_1$56 = require_OperatorSubscriber();
-	function observeOn(scheduler, delay$1) {
+	function observeOn$1(scheduler, delay$1) {
 		if (delay$1 === void 0) delay$1 = 0;
 		return lift_1$67.operate(function(source, subscriber) {
 			source.subscribe(OperatorSubscriber_1$56.createOperatorSubscriber(subscriber, function(value) {
@@ -2897,7 +2897,7 @@ var require_observeOn = /* @__PURE__ */ __commonJSMin(((exports) => {
 			}));
 		});
 	}
-	exports.observeOn = observeOn;
+	exports.observeOn = observeOn$1;
 }));
 
 //#endregion
@@ -8956,6 +8956,40 @@ var Destroyable = class {
 		}
 		return cached;
 	}
+	/**
+	* Like `cachedObservable`, but defers emissions to the microtask queue
+	* via `observeOn(asapScheduler)`.
+	*
+	* Use ONLY for public-facing observable getters that external consumers
+	* subscribe to. Prevents a class of bugs where `BehaviorSubject` or
+	* `ReplaySubject` replays synchronously during `subscribe()`, before
+	* the subscription variable is assigned in the caller's scope.
+	*
+	* Do NOT use for observables consumed internally by the SDK — internal
+	* code using `subscribeTo()`, `firstValueFrom()`, or `withLatestFrom()`
+	* depends on synchronous emission delivery.
+	*/
+	publicCachedObservable(key, factory) {
+		const publicKey = `public:${key}`;
+		this._observableCache ??= /* @__PURE__ */ new Map();
+		let cached = this._observableCache.get(publicKey);
+		if (!cached) {
+			cached = factory().pipe((0, import_cjs$22.observeOn)(import_cjs$22.asapScheduler));
+			this._observableCache.set(publicKey, cached);
+		}
+		return cached;
+	}
+	/**
+	* Wraps an observable so emissions are deferred to the microtask queue.
+	*
+	* Use ONLY for public-facing getters that expose a subject via
+	* `.asObservable()` without going through `cachedObservable`.
+	*
+	* Do NOT use for observables consumed internally by the SDK.
+	*/
+	deferEmission(observable) {
+		return observable.pipe((0, import_cjs$22.observeOn)(import_cjs$22.asapScheduler));
+	}
 	subscribeTo(observable, observerOrNext) {
 		const subscription = observable.subscribe(observerOrNext);
 		this.subscriptions.push(subscription);
@@ -9116,20 +9150,12 @@ var CallCreateError = class extends Error {
 	}
 };
 var JSONRPCError = class extends Error {
-	constructor(code, message, data, options) {
+	constructor(code, message, data, options, requestId) {
 		super(message, options);
 		this.code = code;
 		this.data = data;
-		this.name = "JSONRPCError";
-	}
-};
-var RPCError = class extends Error {
-	constructor(code, requestId, message, data, options) {
-		super(message, options);
-		this.code = code;
 		this.requestId = requestId;
-		this.data = data;
-		this.name = "RPCError";
+		this.name = "JSONRPCError";
 	}
 };
 var InvalidParams = class extends Error {
@@ -10141,6 +10167,7 @@ var NavigatorDeviceController = class extends Destroyable {
 
 //#endregion
 //#region src/dependencies/DefaultLocalStorage.ts
+/** Default storage implementation backed by browser `localStorage` and `sessionStorage`. */
 var DefaultLocalStorage = class {
 	constructor() {
 		if (typeof localStorage === "undefined") throw new StorageNotAvailableError("localStorage");
@@ -10654,17 +10681,21 @@ var AttachManager = class {
 	buildCallOptions(attachment) {
 		const { audio: audioDirection, video: videoDirection } = attachment.mediaDirections;
 		const { audioInputDevice, videoInputDevice } = attachment;
+		const receiveAudio = audioDirection.includes("recv");
+		const receiveVideo = videoDirection.includes("recv");
+		const sendAudio = audioDirection.includes("send");
+		const sendVideo = videoDirection.includes("send");
 		return {
-			receiveAudio: audioDirection.includes("recv"),
-			receiveVideo: videoDirection.includes("recv"),
-			inputAudioDeviceConstraints: {
-				audio: audioDirection.includes("send"),
+			receiveAudio,
+			receiveVideo,
+			inputAudioDeviceConstraints: sendAudio ? {
+				audio: true,
 				...this.deviceController.deviceInfoToConstraints(audioInputDevice)
-			},
-			inputVideoDeviceConstraints: {
-				video: videoDirection.includes("send"),
+			} : void 0,
+			inputVideoDeviceConstraints: sendVideo ? {
+				video: true,
 				...this.deviceController.deviceInfoToConstraints(videoInputDevice)
-			},
+			} : void 0,
 			reattach: true
 		};
 	}
@@ -11931,54 +11962,71 @@ var Participant = class extends Destroyable {
 	get type() {
 		return this._state$.value.type;
 	}
+	/** Whether the participant has raised their hand. */
 	get handraised() {
 		return this._state$.value.handraised ?? false;
 	}
+	/** Whether the participant is visible in the layout. */
 	get visible() {
 		return this._state$.value.visible ?? false;
 	}
+	/** Whether the participant's audio is muted. */
 	get audioMuted() {
 		return this._state$.value.audio_muted ?? false;
 	}
+	/** Whether the participant's video is muted. */
 	get videoMuted() {
 		return this._state$.value.video_muted ?? false;
 	}
+	/** Whether the participant is deafened (incoming audio muted). */
 	get deaf() {
 		return this._state$.value.deaf ?? false;
 	}
+	/** Current microphone input volume level, or `undefined` if not set. */
 	get inputVolume() {
 		return this._state$.value.input_volume;
 	}
+	/** Current speaker output volume level, or `undefined` if not set. */
 	get outputVolume() {
 		return this._state$.value.output_volume;
 	}
+	/** Current microphone input sensitivity level, or `undefined` if not set. */
 	get inputSensitivity() {
 		return this._state$.value.input_sensitivity;
 	}
+	/** Whether echo cancellation is enabled. */
 	get echoCancellation() {
 		return this._state$.value.echo_cancellation ?? false;
 	}
+	/** Whether automatic gain control is enabled. */
 	get autoGain() {
 		return this._state$.value.auto_gain ?? false;
 	}
+	/** Whether noise suppression is enabled. */
 	get noiseSuppression() {
 		return this._state$.value.noise_suppression ?? false;
 	}
+	/** Whether low-bitrate mode is active. */
 	get lowbitrate() {
 		return this._state$.value.lowbitrate ?? false;
 	}
+	/** Whether noise reduction (denoise) is active. */
 	get denoise() {
 		return this._state$.value.denoise ?? false;
 	}
+	/** Custom metadata for this participant, or `undefined` if not set. */
 	get meta() {
 		return this._state$.value.meta;
 	}
+	/** Subscriber ID of this participant, or `undefined` if not available. */
 	get subscriberId() {
 		return this._state$.value.subscriber_id;
 	}
+	/** Address ID of this participant, or `undefined` if not available. */
 	get addressId() {
 		return this._state$.value.address_id;
 	}
+	/** Server node ID for this participant, or `undefined` if not available. */
 	get nodeId() {
 		return this._state$.value.node_id;
 	}
@@ -12050,15 +12098,24 @@ var Participant = class extends Destroyable {
 	async setAudioInputSensitivity(value) {
 		await this.executeMethod(this.id, "call.microphone.sensitivity.set", { sensitivity: value });
 	}
-	/** Sets the microphone input volume level. */
+	/**
+	* Sets the microphone input volume level.
+	* @param value - Volume level (0-100).
+	*/
 	async setAudioInputVolume(value) {
 		await this.executeMethod(this.id, "call.microphone.volume.set", { volume: value });
 	}
-	/** Sets the speaker output volume level. */
+	/**
+	* Sets the speaker output volume level.
+	* @param value - Volume level (0-100).
+	*/
 	async setAudioOutputVolume(value) {
 		await this.executeMethod(this.id, "call.speaker.volume.set", { volume: value });
 	}
-	/** Sets the participant's position in the video layout. */
+	/**
+	* Sets the participant's position in the video layout.
+	* @param value - The {@link VideoPosition} to assign (e.g. `'auto'`, `'reserved-0'`).
+	*/
 	async setPosition(value) {
 		await this.executeMethod(this.id, "call.member.position.set", { position: value });
 	}
@@ -12076,12 +12133,23 @@ var Participant = class extends Destroyable {
 	async end() {
 		await this.executeMethod(this.id, "call.end", {});
 	}
+	/**
+	* Replaces custom metadata for this participant.
+	* @param _meta - Metadata object to set.
+	* @throws {UnimplementedError} Not yet implemented.
+	*/
 	async setMeta(_meta) {
 		throw new UnimplementedError();
 	}
+	/**
+	* Merges values into custom metadata (unlike {@link setMeta} which replaces).
+	* @param _meta - Metadata to merge.
+	* @throws {UnimplementedError} Not yet implemented.
+	*/
 	async updateMeta(_meta) {
 		throw new UnimplementedError();
 	}
+	/** Destroys the participant, releasing all subscriptions and references. */
 	destroy() {
 		this.executeMethod = void 0;
 		super.destroy();
@@ -12094,6 +12162,7 @@ var Participant = class extends Destroyable {
 * and local media stream management.
 */
 var SelfParticipant = class extends Participant {
+	/** @internal */
 	constructor(id, executeMethod, vertoManager, deviceController) {
 		super(id, executeMethod, deviceController);
 		this.vertoManager = vertoManager;
@@ -12184,6 +12253,7 @@ var SelfParticipant = class extends Participant {
 		this.deviceController.selectAudioOutputDevice(device);
 		if (options.savePreference) PreferencesContainer.instance.preferredAudioOutput = device;
 	}
+	/** Mutes local audio. Falls back to local device mute if the server RPC fails. */
 	async mute() {
 		try {
 			await super.mute();
@@ -12193,6 +12263,7 @@ var SelfParticipant = class extends Participant {
 			this.vertoManager.muteMainAudioInputDevice();
 		}
 	}
+	/** Unmutes local audio. Falls back to local device unmute if the server RPC fails. */
 	async unmute() {
 		try {
 			await super.unmute();
@@ -12202,6 +12273,7 @@ var SelfParticipant = class extends Participant {
 			await this.vertoManager.unmuteMainAudioInputDevice();
 		}
 	}
+	/** Mutes local video. Falls back to local device mute if the server RPC fails. */
 	async muteVideo() {
 		try {
 			await super.muteVideo();
@@ -12211,6 +12283,7 @@ var SelfParticipant = class extends Participant {
 			this.vertoManager.muteMainVideoInputDevice();
 		}
 	}
+	/** Unmutes local video. Falls back to local device unmute if the server RPC fails. */
 	async unmuteVideo() {
 		try {
 			await super.unmuteVideo();
@@ -12240,6 +12313,9 @@ function isJSONRPCRequest(value) {
 function isJSONRPCResponse(value) {
 	return isObject(value) && hasProperty(value, "jsonrpc") && value.jsonrpc === "2.0" && hasProperty(value, "id") && typeof value.id === "string" && (hasProperty(value, "result") || hasProperty(value, "error"));
 }
+function isJSONRPCErrorResponse(value) {
+	return isObject(value) && hasProperty(value, "jsonrpc") && value.jsonrpc === "2.0" && hasProperty(value, "id") && typeof value.id === "string" && (hasProperty(value, "error") && isObject(value.error) && hasProperty(value.error, "code") && hasProperty(value.error, "message") || hasProperty(value, "result") && isObject(value.result) && hasProperty(value.result, "code") && value.result.code !== "200" && hasProperty(value.result, "message"));
+}
 
 //#endregion
 //#region src/core/RPCMessages/guards/events.guards.ts
@@ -14082,6 +14158,11 @@ var WebRTCVertoManager = class extends VertoManager {
 		].includes(connectionState)))));
 	}
 	initSubscriptions() {
+		this.subscribeTo(this.callJoinedEvent$, (event) => {
+			const memberNodeId = event.room_session.members.find((m) => m.call_id === event.call_id)?.node_id;
+			if (memberNodeId) this.setNodeIdIfNull(memberNodeId);
+			if (event.member_id) this.setSelfIdIfNull(event.member_id);
+		});
 		this.subscribeTo(this.vertoMedia$, (event) => {
 			logger$10.debug("[WebRTCManager] Received Verto media event (early media SDP):", event);
 			this._signalingStatus$.next("ringing");
@@ -14113,6 +14194,28 @@ var WebRTCVertoManager = class extends VertoManager {
 			this.sendVertoPong(vertoPing);
 		});
 	}
+	/**
+	* Set node_id/selfId only when the current value is null.
+	*
+	* During reattach, `call.joined` and `verto.answer` events can deliver
+	* these identifiers before the `verto.invite` RPC response (`CALL CREATED`)
+	* arrives. These methods let early events populate them eagerly so that
+	* downstream RPC calls (e.g. `call.layout.list`) don't fail with empty
+	* identifiers. `processInviteResponse()` remains the authoritative source
+	* and always overwrites unconditionally.
+	*/
+	setNodeIdIfNull(nodeId) {
+		if (!this._nodeId$.value && nodeId) {
+			logger$10.debug(`[WebRTCManager] Early node_id set: ${nodeId}`);
+			this._nodeId$.next(nodeId);
+		}
+	}
+	setSelfIdIfNull(selfId) {
+		if (!this._selfId$.value && selfId) {
+			logger$10.debug(`[WebRTCManager] Early selfId set: ${selfId}`);
+			this._selfId$.next(selfId);
+		}
+	}
 	async sendVertoPong(vertoPing) {
 		try {
 			const vertoPongMessage = VertoPong({ ...vertoPing });
@@ -14136,6 +14239,9 @@ var WebRTCVertoManager = class extends VertoManager {
 	get selfId() {
 		return this._selfId$.value;
 	}
+	get callJoinedEvent$() {
+		return this.webRtcCallSession.callEvent$.pipe((0, import_cjs$10.filter)(isCallJoinedPayload), (0, import_cjs$10.takeUntil)(this.destroyed$));
+	}
 	get vertoMedia$() {
 		return this.webRtcCallSession.webrtcMessages$.pipe(filterAs(isVertoMediaInnerParams, "params"), (0, import_cjs$10.takeUntil)(this.destroyed$));
 	}
@@ -14442,7 +14548,7 @@ var WebRTCVertoManager = class extends VertoManager {
 	*
 	* @see selectAudioInputDevice
 	* @see selectVideoInputDevice
-	* @param options
+	* @param options - Media options specifying which input devices to add (defaults to audio only).
 	*/
 	async addMainInputDevices(options = { audio: true }) {
 		let deviceKind = void 0;
@@ -14526,7 +14632,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		try {
 			const causeParams = cause ? {
 				cause,
-				cause_code: VertoByeCauseCodes[cause]
+				causeCode: VertoByeCauseCodes[cause]
 			} : {};
 			await this.executeVerto(VertoBye({
 				...causeParams,
@@ -14667,7 +14773,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable stream of errors from media, signaling, and peer connection layers. */
 	get errors$() {
-		return this._errors$.asObservable();
+		return this.deferEmission(this._errors$.asObservable());
 	}
 	/**
 	* @internal Push an error to the call's error stream.
@@ -14687,7 +14793,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of the address associated with this call. */
 	get address$() {
-		return (0, import_cjs$9.from)([this.address]);
+		return this.deferEmission((0, import_cjs$9.from)([this.address])).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Display name of the caller. */
 	get fromName() {
@@ -14725,36 +14831,64 @@ var WebRTCCall = class extends Destroyable {
 	get self() {
 		return this.callEventsManager.self;
 	}
+	/** Toggles the call lock state, preventing or allowing new participants from joining. */
 	async toggleLock() {
 		const method = this.locked ? "call.unlock" : "call.lock";
 		await this.executeMethod(this.selfId ?? "", method, {});
 	}
+	/**
+	* Toggles the hold state of the call (pauses/resumes local media transmission).
+	*
+	* Distinct from {@link Participant.toggleMute} which mutes individual tracks.
+	*/
 	async toggleHold() {
 		if (this._holdState) await this.vertoManager.unhold();
 		else await this.vertoManager.hold();
 		this._holdState = !this._holdState;
 	}
+	/** @throws {UnimplementedError} Not yet implemented. Status tracked via {@link recording$}. */
 	async startRecording() {
 		throw new UnimplementedError();
 	}
+	/** @throws {UnimplementedError} Not yet implemented. Status tracked via {@link streaming$}. */
 	async startStreaming() {
 		throw new UnimplementedError();
 	}
+	/**
+	* Replaces the call's custom metadata.
+	* @param _meta - Metadata object to set.
+	* @throws {UnimplementedError} Not yet implemented.
+	*/
 	async setMeta(_meta) {
 		throw new UnimplementedError();
 	}
+	/**
+	* Merges values into the call's custom metadata (unlike {@link setMeta} which replaces).
+	* @param _meta - Metadata to merge.
+	* @throws {UnimplementedError} Not yet implemented.
+	*/
 	async updateMeta(_meta) {
 		throw new UnimplementedError();
 	}
 	/** Observable of layout layer positions for all participants. */
 	get layoutLayers$() {
-		return this.callEventsManager.layoutLayers$;
+		return this.deferEmission(this.callEventsManager.layoutLayers$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Current snapshot of layout layers. */
 	get layoutLayers() {
 		return this.callEventsManager.layoutLayers;
 	}
-	/** Executes a Verto RPC method targeting a specific participant. */
+	/**
+	* Executes a Verto RPC method targeting a specific participant.
+	*
+	* Constructs call context (node_id, call_id, member_id) and sends the RPC request.
+	*
+	* @param target - Target member ID string, or a {@link MemberTarget} object.
+	* @param method - Verto method name (e.g. `'call.mute'`, `'call.member.remove'`).
+	* @param args - Parameters for the RPC method.
+	* @returns The RPC response.
+	* @throws {JSONRPCError} If the RPC call returns an error.
+	*/
 	async executeMethod(target, method, args) {
 		const params = this.buildMethodParams(target, args);
 		const request = buildRPCRequest({
@@ -14762,7 +14896,9 @@ var WebRTCCall = class extends Destroyable {
 			params
 		});
 		try {
-			return await this.clientSession.execute(request);
+			const response = await this.clientSession.execute(request);
+			if (isJSONRPCErrorResponse(response)) throw new JSONRPCError(parseInt(response.result?.code ?? "0"), `Error response from method ${method}: ${response.result?.code} ${response.result?.message}`, void 0, void 0, request.id);
+			return response;
 		} catch (error) {
 			logger$9.error(`[Call] Error executing method ${method} with params`, params, error);
 			throw error;
@@ -14791,45 +14927,45 @@ 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$).pipe((0, import_cjs$9.distinctUntilChanged)(), (0, import_cjs$9.tap)((status) => {
+		return this.publicCachedObservable("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$() {
-		return this.callEventsManager.participants$;
+		return this.deferEmission(this.callEventsManager.participants$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable of the local (self) participant. */
 	get self$() {
-		return this.callEventsManager.self$;
+		return this.deferEmission(this.callEventsManager.self$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable indicating whether the call is being recorded. */
 	get recording$() {
-		return this.callEventsManager.recording$;
+		return this.deferEmission(this.callEventsManager.recording$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable indicating whether the call is being streamed. */
 	get streaming$() {
-		return this.callEventsManager.streaming$;
+		return this.deferEmission(this.callEventsManager.streaming$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable indicating whether raise-hand priority is active. */
 	get raiseHandPriority$() {
-		return this.callEventsManager.raiseHandPriority$;
+		return this.deferEmission(this.callEventsManager.raiseHandPriority$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable indicating whether the call room is locked. */
 	get locked$() {
-		return this.callEventsManager.locked$;
+		return this.deferEmission(this.callEventsManager.locked$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable of custom metadata associated with the call. */
 	get meta$() {
-		return this.callEventsManager.meta$;
+		return this.deferEmission(this.callEventsManager.meta$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable of the call's capability flags. */
 	get capabilities$() {
-		return this.callEventsManager.capabilities$;
+		return this.deferEmission(this.callEventsManager.capabilities$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Observable of the current layout name. */
 	get layout$() {
-		return this.callEventsManager.layout$;
+		return this.deferEmission(this.callEventsManager.layout$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Current call status. */
 	get status() {
@@ -14861,7 +14997,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of available layout names. */
 	get layouts$() {
-		return this.callEventsManager.layouts$;
+		return this.deferEmission(this.callEventsManager.layouts$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Current snapshot of available layout names. */
 	get layouts() {
@@ -14869,7 +15005,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of the local media stream (camera/microphone). */
 	get localStream$() {
-		return this.vertoManager.localStream$;
+		return this.deferEmission(this.vertoManager.localStream$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Current local media stream, or `null` if not available. */
 	get localStream() {
@@ -14877,7 +15013,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of the remote media stream from the far end. */
 	get remoteStream$() {
-		return this.vertoManager.remoteStream$;
+		return this.deferEmission(this.vertoManager.remoteStream$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Current remote media stream, or `null` if not available. */
 	get remoteStream() {
@@ -14885,7 +15021,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of custom user variables associated with the call. */
 	get userVariables$() {
-		return this._userVariables$.asObservable();
+		return this.deferEmission(this._userVariables$.asObservable());
 	}
 	/** a copy of the current custom user variables of the call. */
 	get userVariables() {
@@ -14905,7 +15041,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of the current audio/video send/receive directions. */
 	get mediaDirections$() {
-		return this.vertoManager.mediaDirections$;
+		return this.deferEmission(this.vertoManager.mediaDirections$).pipe((0, import_cjs$9.takeUntil)(this._destroyed$));
 	}
 	/** Current audio/video send/receive directions. */
 	get mediaDirections() {
@@ -14914,7 +15050,16 @@ var WebRTCCall = class extends Destroyable {
 	get participantsId$() {
 		return this.cachedObservable("participantsId$", () => this.participants$.pipe((0, import_cjs$9.map)((participants) => participants.map((participant) => participant.id))));
 	}
-	/** Executes a raw JSON-RPC request on the client session. */
+	/**
+	* Executes a raw JSON-RPC request on the client session.
+	*
+	* Lower-level than {@link executeMethod} — allows full control over the RPC request structure.
+	*
+	* @param request - Complete JSON-RPC request object.
+	* @param options - Optional RPC execution options (timeout, etc.).
+	* @returns The RPC response.
+	* @throws {JSONRPCError} If the RPC call returns an error response.
+	*/
 	async execute(request, options) {
 		return this.clientSession.execute(request, options);
 	}
@@ -14951,31 +15096,31 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of call-updated events. */
 	get callUpdated$() {
-		return this.cachedObservable("callUpdated$", () => this.callSessionEvents$.pipe(filterAs(isCallUpdatedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
+		return this.publicCachedObservable("callUpdated$", () => this.callSessionEvents$.pipe(filterAs(isCallUpdatedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
 	}
-	/** Observable of member-joined events. */
+	/** Observable of member-joined events, emitted when a remote participant joins the call. */
 	get memberJoined$() {
-		return this.cachedObservable("memberJoined$", () => this.callSessionEvents$.pipe(filterAs(isMemberJoinedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
+		return this.publicCachedObservable("memberJoined$", () => this.callSessionEvents$.pipe(filterAs(isMemberJoinedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
 	}
-	/** Observable of member-left events. */
+	/** Observable of member-left events, emitted when a participant leaves the call. */
 	get memberLeft$() {
-		return this.cachedObservable("memberLeft$", () => this.callSessionEvents$.pipe(filterAs(isMemberLeftMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
+		return this.publicCachedObservable("memberLeft$", () => this.callSessionEvents$.pipe(filterAs(isMemberLeftMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
 	}
 	/** Observable of member-updated events (mute, volume, etc.). */
 	get memberUpdated$() {
-		return this.cachedObservable("memberUpdated$", () => this.callSessionEvents$.pipe(filterAs(isMemberUpdatedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
+		return this.publicCachedObservable("memberUpdated$", () => this.callSessionEvents$.pipe(filterAs(isMemberUpdatedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
 	}
 	/** Observable of member-talking events (speech start/stop). */
 	get memberTalking$() {
-		return this.cachedObservable("memberTalking$", () => this.callSessionEvents$.pipe(filterAs(isMemberTalkingMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
+		return this.publicCachedObservable("memberTalking$", () => this.callSessionEvents$.pipe(filterAs(isMemberTalkingMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
 	}
 	/** Observable of call state-change events. */
 	get callStates$() {
-		return this.cachedObservable("callStates$", () => this.callSessionEvents$.pipe(filterAs(isCallStateMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
+		return this.publicCachedObservable("callStates$", () => this.callSessionEvents$.pipe(filterAs(isCallStateMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
 	}
 	/** Observable of layout-changed events. */
 	get layoutUpdates$() {
-		return this.cachedObservable("layoutUpdates$", () => this.callSessionEvents$.pipe(filterAs(isLayoutChangedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
+		return this.publicCachedObservable("layoutUpdates$", () => this.callSessionEvents$.pipe(filterAs(isLayoutChangedMetadata, "params"), (0, import_cjs$9.takeUntil)(this.destroyed$)));
 	}
 	/** Underlying `RTCPeerConnection`, for advanced use cases. */
 	get rtcPeerConnection() {
@@ -14983,7 +15128,7 @@ var WebRTCCall = class extends Destroyable {
 	}
 	/** Observable of raw signaling events as plain objects. */
 	get signalingEvent$() {
-		return this.cachedObservable("signalingEvent$", () => this.callEvent$.pipe((0, import_cjs$9.map)((event) => JSON.parse(JSON.stringify(event)))));
+		return this.publicCachedObservable("signalingEvent$", () => this.callEvent$.pipe((0, import_cjs$9.map)((event) => JSON.parse(JSON.stringify(event)))));
 	}
 	/** Observable of WebRTC-specific signaling messages. */
 	get webrtcMessages$() {
@@ -14997,7 +15142,17 @@ var WebRTCCall = class extends Destroyable {
 	get layoutEvent$() {
 		return this.cachedObservable("layoutEvent$", () => this.callEvent$.pipe(filterAs(isLayoutChangedMetadata, "params")));
 	}
-	/** Hangs up the call and releases all resources. */
+	/**
+	* Hangs up the call and releases all resources.
+	*
+	* Sends a Verto `bye` to the server, transitions status to `'disconnecting'`,
+	* then destroys the call. After this, the call instance is no longer usable.
+	*
+	* @example
+	* ```ts
+	* await call.hangup();
+	* ```
+	*/
 	async hangup() {
 		this._status$.next("disconnecting");
 		try {
@@ -15006,11 +15161,35 @@ var WebRTCCall = class extends Destroyable {
 			this.destroy();
 		}
 	}
-	/** Sends DTMF digits (e.g. `'1234#'`) on the call. */
+	/**
+	* Sends DTMF digits on the call.
+	*
+	* @param dtmf - The digit string to send (e.g. `'1234#'`).
+	*
+	* @example
+	* ```ts
+	* await call.sendDigits('1234#');
+	* ```
+	*/
 	async sendDigits(dtmf) {
 		return this.vertoManager.sendDigits(dtmf);
 	}
-	/** Accepts an inbound call, optionally overriding media options for the answer. */
+	/**
+	* Accepts an inbound call, optionally overriding media options for the answer.
+	*
+	* @param options - Optional media constraints for the answer (audio/video).
+	*
+	* @example
+	* ```ts
+	* // Accept with defaults
+	* call.answer();
+	*
+	* // Accept audio-only
+	* call.answer({ audio: true, video: false });
+	* ```
+	* @see {@link reject} to decline the call instead.
+	* @see {@link answered$} to observe the acceptance state.
+	*/
 	answer(options) {
 		this._answerMediaOptions = options;
 		this._answered$.next(true);
@@ -15019,18 +15198,32 @@ var WebRTCCall = class extends Destroyable {
 	get answerMediaOptions() {
 		return this._answerMediaOptions;
 	}
-	/** Rejects an inbound call. */
+	/**
+	* Rejects an inbound call, preventing media negotiation.
+	*
+	* @see {@link answer} to accept the call instead.
+	* @see {@link answered$} to observe the rejection state.
+	*/
 	reject() {
 		this._answered$.next(false);
 	}
 	/** Observable that emits `true` when answered, `false` when rejected. */
 	get answered$() {
-		return this._answered$.asObservable();
+		return this.deferEmission(this._answered$.asObservable());
 	}
 	/**
 	* Sets the call layout and participant positions.
+	*
 	* @param layout - Layout name (must be one of {@link layouts}).
-	* @param positions - Map of member IDs to video positions.
+	* @param positions - Map of member IDs to {@link VideoPosition} values.
+	* @throws {InvalidParams} If the layout is not in the available {@link layouts}.
+	*
+	* @example
+	* ```ts
+	* await call.setLayout('grid-responsive', {
+	*   [participantId]: 'reserved-0',
+	* });
+	* ```
 	*/
 	async setLayout(layout, positions) {
 		if (!this.layouts.includes(layout)) throw new InvalidParams(`Layout ${layout} is not available in the current call layouts: ${this.layouts.join(", ")}`);
@@ -15040,7 +15233,12 @@ var WebRTCCall = class extends Destroyable {
 			positions
 		});
 	}
-	/** Transfers the call to other participants. */
+	/**
+	* Transfers the call to another destination.
+	*
+	* @param options - Transfer configuration including the target destination.
+	* @see {@link status$} to observe the transfer progress.
+	*/
 	async transfer(options) {
 		return this.vertoManager.transfer(options);
 	}
@@ -15401,11 +15599,28 @@ var Address = class extends Destroyable {
 	get locked$() {
 		return this.cachedObservable("locked$", () => this._state$.pipe(filterNull(), (0, import_cjs$7.shareReplay)(1), (0, import_cjs$7.map)((state) => state.locked), (0, import_cjs$7.takeUntil)(this.destroyed$)));
 	}
-	/** Sends a text message to this address. */
+	/**
+	* Sends a text message to this address.
+	*
+	* @param text - The message text to send.
+	*
+	* @example
+	* ```ts
+	* await address.sendText('Hello!');
+	* ```
+	*/
 	async sendText(text) {
 		return this.conversationManager.sendText(text, this.id);
 	}
-	/** Collection of text messages for this address, with pagination support. */
+	/**
+	* Collection of text messages for this address, with pagination support.
+	*
+	* Returns `undefined` until {@link textMessages$} has been subscribed to (lazy-loaded).
+	* Filters to `'chat'` subtype messages from the conversation.
+	*
+	* @see {@link textMessages$} to trigger lazy loading.
+	* @see {@link sendText} to send a new message.
+	*/
 	get textMessage() {
 		if (!this._conversationMessages) return;
 		this._textMessages$ = this._textMessages$ ?? new EntityCollectionTransformed(this._conversationMessages, (item) => item.subtype === "chat", (item) => ({
@@ -15416,7 +15631,14 @@ var Address = class extends Destroyable {
 		}));
 		return this._textMessages$;
 	}
-	/** Collection of call history entries for this address, with pagination support. */
+	/**
+	* Collection of call history entries for this address, with pagination support.
+	*
+	* Returns `undefined` until {@link history$} has been subscribed to (lazy-loaded).
+	* Filters to `'log'` subtype messages including kind, status, start/end times.
+	*
+	* @see {@link history$} to trigger lazy loading.
+	*/
 	get history() {
 		if (!this._conversationMessages) return;
 		this._history$ = this._history$ ?? new EntityCollectionTransformed(this._conversationMessages, (item) => item.subtype === "log", (item) => ({
@@ -15482,7 +15704,7 @@ var PendingRPC = class PendingRPC {
 				next: (response) => {
 					isSettled = true;
 					if (response.error) {
-						const rpcError = new RPCError(response.error.code, request.id, response.error.message, response.error.data);
+						const rpcError = new JSONRPCError(response.error.code, response.error.message, response.error.data, void 0, request.id);
 						logger$7.debug(`[PendingRPC(${this.id}) request:${request.id}] Rejecting promise with RPC error:`, rpcError);
 						reject(rpcError);
 					} else {
@@ -15773,6 +15995,7 @@ var ClientSessionManager = class extends Destroyable {
 			...params,
 			...persistedParams
 		});
+		this.transport.resetSessionEpoch();
 		const response = await (0, import_cjs$5.lastValueFrom)((0, import_cjs$5.from)(this.transport.execute(rpcConnectRequest)).pipe(throwOnRPCError(), (0, import_cjs$5.map)((res) => res.result), (0, import_cjs$5.filter)(isRPCConnectResult), (0, import_cjs$5.tap)(() => {
 			logger$6.debug("[Session] Response passed filter, processing authentication result");
 		}), (0, import_cjs$5.take)(1), (0, import_cjs$5.catchError)((err) => {
@@ -16005,11 +16228,18 @@ var AddressFetcher = class extends Fetcher {
 		logger$4.error("Failed to fetch addresses");
 	}
 };
+/** Collection of address states with reactive updates and pagination. */
 var AddressStateCollection = class extends EntityCollection {
 	constructor(update$, http, onError) {
 		super(new AddressFetcher(http), update$, onError);
 	}
 };
+/**
+* Manages the directory of {@link Address} entries with paginated loading.
+*
+* Implements the {@link Directory} interface and provides reactive access to
+* addresses via observables, along with pagination and lookup methods.
+*/
 var DirectoryManager = class extends Destroyable {
 	constructor(http, clientSession, conversationManager, onError) {
 		super();
@@ -16034,6 +16264,7 @@ var DirectoryManager = class extends Destroyable {
 		this._statesCollection = new AddressStateCollection(clientSession.signalingEvent$.pipe(filterAs(isConversationMessageUpdatedMetadata, "params"), (0, import_cjs$2.map)((_) => ({}))), this.http, this.onError);
 		this.initSubscriptions();
 	}
+	/** Whether addresses are currently being loaded from the server. */
 	get loading() {
 		return this._statesCollection.loading;
 	}
@@ -16047,28 +16278,57 @@ var DirectoryManager = class extends Destroyable {
 			}
 		});
 	}
+	/** Observable stream of all addresses in the directory. */
 	get addresses$() {
 		return this._addresses$.asObservable();
 	}
+	/** Current snapshot of all loaded addresses. */
 	get addresses() {
 		return this._addresses$.value;
 	}
+	/** Observable indicating whether more addresses can be loaded. */
 	get hasMore$() {
 		return this._statesCollection.hasMore$;
 	}
+	/** Observable of the current loading state. */
 	get loading$() {
 		return this._statesCollection.loading$;
 	}
+	/**
+	* Loads the next page of addresses from the server.
+	*
+	* No-op if {@link hasMore$} is `false`. Loading state is observable via {@link loading$}.
+	* New addresses are appended to {@link addresses$} when the page loads.
+	*/
 	loadMore() {
 		if (this._statesCollection.hasMore) this._statesCollection.loadMore();
 	}
+	/**
+	* Returns a reactive observable for a specific address by ID.
+	* @param id - The address ID to observe.
+	* @returns An observable of the address, or `undefined` if not found.
+	*/
 	get$(id) {
 		if (!this._observableRegistry.has(id)) this.addNewAddress(id);
 		return this._observableRegistry.get(id);
 	}
+	/**
+	* Returns an address by ID from the local cache.
+	* @param addressId - The address ID to look up.
+	* @returns The address, or `undefined` if not found.
+	*/
 	get(addressId) {
 		return this._addressesInstances.get(addressId);
 	}
+	/**
+	* Finds an address ID by its resource name (URI).
+	*
+	* Searches locally loaded addresses first, then queries the server if not found.
+	* The resource name is the {@link Address.name} identifier, distinct from display name.
+	*
+	* @param name - The resource name to search for (exact match, e.g. `'/public/conference'`).
+	* @returns The address ID, or `undefined` if no match is found locally or on server.
+	*/
 	async findAddressIdByURI(name) {
 		let addressId = this._addressesInstances.values().find((addr) => addr.name === name)?.id;
 		if (!addressId) {
@@ -16256,7 +16516,30 @@ function isSignalwirePingRequest(value) {
 //#region src/managers/TransportManager.ts
 var import_cjs$1 = require_cjs();
 const logger$2 = getLogger();
-var TransportManager = class extends Destroyable {
+var TransportManager = class TransportManager extends Destroyable {
+	/**
+	* Normalise a server event timestamp to epoch seconds.
+	*
+	* The server uses two formats:
+	*   - `webrtc.message`: float epoch seconds  (e.g. 1774372099.022817)
+	*   - all other events: int epoch microseconds (e.g. 1774372099925857)
+	*
+	* Values above 1e12 are treated as microseconds and divided by 1e6.
+	*/
+	static toEpochSeconds(ts) {
+		const n = typeof ts === "string" ? Number(ts) : ts;
+		return n > 0xe8d4a51000 ? n / 1e6 : n;
+	}
+	/**
+	* Extract the event timestamp from a signalwire.event message.
+	* Returns `null` for messages that have no timestamp
+	* (e.g. signalwire.authorization.state, RPC responses).
+	*/
+	static extractEventTimestamp(message) {
+		if (!isSignalwireRequest(message)) return null;
+		if (message.params.event_type === "signalwire.authorization.state") return null;
+		return TransportManager.toEpochSeconds(message.params.timestamp);
+	}
 	constructor(storage, protocolKey, webSocketConstructor, relayHost, onError) {
 		super();
 		this.storage = storage;
@@ -16289,6 +16572,23 @@ var TransportManager = class extends Destroyable {
 				return true;
 			});
 		};
+		this.discardStaleEvents = () => {
+			return (0, import_cjs$1.filter)((message) => {
+				const ts = TransportManager.extractEventTimestamp(message);
+				if (ts === null) return true;
+				if (this._sessionEpoch === null) {
+					this._sessionEpoch = ts;
+					return true;
+				}
+				if (ts < this._sessionEpoch) {
+					const eventType = isSignalwireRequest(message) ? message.params.event_type : "unknown";
+					logger$2.warn(`[Transport] Discarding stale event: ${eventType} (timestamp=${ts.toFixed(3)}, sessionEpoch=${this._sessionEpoch.toFixed(3)}, delta=${(this._sessionEpoch - ts).toFixed(3)}s)`);
+					return false;
+				}
+				return true;
+			});
+		};
+		this._sessionEpoch = null;
 		this._outgoingMessages$ = this.createSubject();
 		this._webSocketConnections = new WebSocketController(webSocketConstructor, relayHost, this._outgoingMessages$.asObservable(), {
 			connectionTimeout: PreferencesContainer.instance.connectionTimeout,
@@ -16313,7 +16613,14 @@ var TransportManager = class extends Destroyable {
 			return import_cjs$1.EMPTY;
 		}), (0, import_cjs$1.share)(), (0, import_cjs$1.takeUntil)(this.destroyed$));
 		this._jsonRPCResponse$ = this._jsonRPCMessage$.pipe((0, import_cjs$1.filter)(isJSONRPCResponse));
-		this._incomingEvent$ = this._jsonRPCMessage$.pipe(this.ackEvent(), this.replySignalwirePing(), (0, import_cjs$1.filter)((message) => !isJSONRPCResponse(message)), (0, import_cjs$1.share)(), (0, import_cjs$1.takeUntil)(this.destroyed$));
+		this._incomingEvent$ = this._jsonRPCMessage$.pipe(this.ackEvent(), this.replySignalwirePing(), (0, import_cjs$1.filter)((message) => !isJSONRPCResponse(message)), this.discardStaleEvents(), (0, import_cjs$1.share)(), (0, import_cjs$1.takeUntil)(this.destroyed$));
+	}
+	/**
+	* Reset the session epoch. Call this before each signalwire.connect
+	* so that the first event after authentication establishes the new baseline.
+	*/
+	resetSessionEpoch() {
+		this._sessionEpoch = null;
 	}
 	async setProtocol(protocol) {
 		this.protocol$.next(protocol);
@@ -16456,6 +16763,12 @@ const buildOptionsFromDestination = (destination) => {
 * ```
 */
 var SignalWire = class extends Destroyable {
+	/**
+	* Creates a new SignalWire client and begins connecting.
+	*
+	* @param credentialProvider - Provider that supplies authentication credentials.
+	* @param options - Configuration options (connection, device monitoring, preferences).
+	*/
 	constructor(credentialProvider, options = {}) {
 		super();
 		this.preferences = new ClientPreferences();
@@ -16637,7 +16950,7 @@ var SignalWire = class extends Destroyable {
 	* ```
 	*/
 	get subscriber$() {
-		return this._subscriber$.asObservable();
+		return this.deferEmission(this._subscriber$.asObservable());
 	}
 	/** Current subscriber snapshot, or `undefined` if not yet authenticated. */
 	get subscriber() {
@@ -16656,7 +16969,7 @@ var SignalWire = class extends Destroyable {
 	* ```
 	*/
 	get directory$() {
-		return this._directory$.asObservable();
+		return this.deferEmission(this._directory$.asObservable());
 	}
 	/**
 	* Current directory snapshot, or `undefined` if the client is not yet connected.
@@ -16667,7 +16980,7 @@ var SignalWire = class extends Destroyable {
 	}
 	/** Observable that emits when the subscriber registration state changes. */
 	get isRegistered$() {
-		return this._isRegistered$.asObservable();
+		return this.deferEmission(this._isRegistered$.asObservable());
 	}
 	/** Whether the subscriber is currently registered. */
 	get isRegistered() {
@@ -16679,17 +16992,22 @@ var SignalWire = class extends Destroyable {
 	}
 	/** Observable that emits when the connection state changes. */
 	get isConnected$() {
-		return this._isConnected$.asObservable();
+		return this.deferEmission(this._isConnected$.asObservable());
 	}
 	/** Observable that emits `true` when the client is both connected and authenticated. */
 	get ready$() {
-		return this.cachedObservable("ready$", () => this._isConnected$.pipe((0, import_cjs.switchMap)((connected) => connected ? this._clientSession.authenticated$ : (0, import_cjs.of)(false))));
+		return this.publicCachedObservable("ready$", () => this._isConnected$.pipe((0, import_cjs.switchMap)((connected) => connected ? this._clientSession.authenticated$ : (0, import_cjs.of)(false))));
 	}
 	/** Observable stream of errors from transport, authentication, and devices. */
 	get errors$() {
-		return this._errors$.asObservable();
+		return this.deferEmission(this._errors$.asObservable());
 	}
-	/** Disconnects the WebSocket and tears down the session. */
+	/**
+	* Disconnects the WebSocket and tears down the current session.
+	*
+	* The client can be reconnected by calling {@link connect} again,
+	* which creates a fresh transport and session.
+	*/
 	async disconnect() {
 		await this._clientSession.disconnect();
 		this._clientSession.destroy();
@@ -16698,7 +17016,14 @@ var SignalWire = class extends Destroyable {
 	async waitAuthentication() {
 		await (0, import_cjs.firstValueFrom)(this.ready$.pipe((0, import_cjs.filter)((ready$1) => ready$1 === true)));
 	}
-	/** Registers the subscriber as online to receive inbound calls and events. */
+	/**
+	* Registers the subscriber as online to receive inbound calls and events.
+	*
+	* Waits for authentication to complete before sending the registration.
+	* If the initial attempt fails, reauthentication is attempted automatically.
+	*
+	* @throws {InvalidCredentialsError} If registration and reauthentication both fail.
+	*/
 	async register() {
 		try {
 			await this.waitAuthentication();
@@ -16726,7 +17051,11 @@ var SignalWire = class extends Destroyable {
 			throw error;
 		}
 	}
-	/** Unregisters the subscriber, going offline for inbound calls. */
+	/**
+	* Unregisters the subscriber, going offline for inbound calls.
+	*
+	* The WebSocket connection remains open; use {@link disconnect} to fully close it.
+	*/
 	async unregister() {
 		try {
 			await this._transport.execute(RPCExecute({
@@ -16742,9 +17071,27 @@ var SignalWire = class extends Destroyable {
 	}
 	/**
 	* Places an outbound call to the given destination.
-	* @param destination - Address URI string or {@link Address} instance to call.
-	* @param options - Media and dial options (audio/video, constraints).
+	*
+	* Waits for authentication before dialing. Media options are merged from
+	* saved preferences, destination query parameters (e.g. `?channel=video`),
+	* and the provided `options` (highest priority).
+	*
+	* Returns a {@link Call} in `'ringing'` state. Subscribe to {@link Call.status$}
+	* to track progression through `'connected'` → `'disconnected'`.
+	*
+	* @param destination - Address URI string (e.g. `'/public/my-room'`) or {@link Address} instance.
+	* @param options - Media and dial options (audio/video, device constraints). Overrides defaults.
 	* @returns The created {@link Call} instance.
+	* @throws {Error} If authentication is not complete or call creation fails.
+	*
+	* @example
+	* ```ts
+	* const call = await client.dial('/public/conference', {
+	*   audio: true,
+	*   video: true,
+	* });
+	* call.status$.subscribe(status => console.log('Call:', status));
+	* ```
 	*/
 	async dial(destination, options = {}) {
 		const computed_options = {
@@ -16762,7 +17109,7 @@ var SignalWire = class extends Destroyable {
 	}
 	/** Observable list of available audio input (microphone) devices. */
 	get audioInputDevices$() {
-		return this._deviceController.audioInputDevices$;
+		return this.deferEmission(this._deviceController.audioInputDevices$);
 	}
 	/** Current snapshot of available audio input devices. */
 	get audioInputDevices() {
@@ -16770,7 +17117,7 @@ var SignalWire = class extends Destroyable {
 	}
 	/** Observable list of available audio output (speaker) devices. */
 	get audioOutputDevices$() {
-		return this._deviceController.audioOutputDevices$;
+		return this.deferEmission(this._deviceController.audioOutputDevices$);
 	}
 	/** Current snapshot of available audio output devices. */
 	get audioOutputDevices() {
@@ -16778,7 +17125,7 @@ var SignalWire = class extends Destroyable {
 	}
 	/** Observable list of available video input (camera) devices. */
 	get videoInputDevices$() {
-		return this._deviceController.videoInputDevices$;
+		return this.deferEmission(this._deviceController.videoInputDevices$);
 	}
 	/** Current snapshot of available video input devices. */
 	get videoInputDevices() {
@@ -16786,15 +17133,15 @@ var SignalWire = class extends Destroyable {
 	}
 	/** Observable of the currently selected audio input device. */
 	get selectedAudioInputDevice$() {
-		return this._deviceController.selectedAudioInputDevice$;
+		return this.deferEmission(this._deviceController.selectedAudioInputDevice$);
 	}
 	/** Observable of the currently selected audio output device. */
 	get selectedAudioOutputDevice$() {
-		return this._deviceController.selectedAudioOutputDevice$;
+		return this.deferEmission(this._deviceController.selectedAudioOutputDevice$);
 	}
 	/** Observable of the currently selected video input device. */
 	get selectedVideoInputDevice$() {
-		return this._deviceController.selectedVideoInputDevice$;
+		return this.deferEmission(this._deviceController.selectedVideoInputDevice$);
 	}
 	/** Currently selected audio input device, or `null` if none. */
 	get selectedAudioInputDevice() {
@@ -16840,12 +17187,23 @@ var SignalWire = class extends Destroyable {
 	disableDeviceMonitoring() {
 		this._deviceController.disableDeviceMonitoring();
 	}
+	/**
+	* Returns the capabilities of a media device.
+	* @param deviceInfo - The device to query.
+	* @returns The device capabilities, or `null` if unavailable.
+	*/
 	async getDeviceCapabilities(deviceInfo) {
 		return this._deviceController.getDeviceCapabilities(deviceInfo);
 	}
+	/**
+	* Checks whether a device is still available and usable.
+	* @param deviceInfo - The device to validate, or `null`.
+	* @returns `true` if the device is valid and available. Returns `false` for `null`, audio output devices, or unavailable devices.
+	*/
 	async isValidDevice(deviceInfo) {
 		return this._deviceController.isValidDevice(deviceInfo);
 	}
+	/** Destroys the client, clearing timers and releasing all resources. */
 	destroy() {
 		if (this._refreshTimerId) {
 			clearTimeout(this._refreshTimerId);
@@ -16858,6 +17216,7 @@ var SignalWire = class extends Destroyable {
 //#endregion
 //#region src/dependencies/EmbedTokenCredentialProvider.ts
 const logger = getLogger();
+/** Credential provider that exchanges an embed token for a SAT via the host's token endpoint. */
 var EmbedTokenCredentialProvider = class {
 	constructor(host, embedToken) {
 		this.host = host;