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

package/dist/index.mjs

@@ -3005,7 +3005,9 @@ const DEFAULT_MEMBER_CAPABILITIES = {
 	position: false,
 	meta: false,
 	remove: false,
-	audioFlags: false
+	audioFlags: false,
+	denoise: false,
+	lowbitrate: false
 };
 /**
 * Default call capabilities with no permissions
@@ -3078,7 +3080,9 @@ function computeMemberCapabilities(flags, memberType) {
 		position: hasBooleanCapability(flags, memberType, null, "position"),
 		meta: hasBooleanCapability(flags, memberType, null, "meta"),
 		remove: hasBooleanCapability(flags, memberType, null, "remove"),
-		audioFlags: hasBooleanCapability(flags, memberType, null, "audioflags")
+		audioFlags: hasBooleanCapability(flags, memberType, null, "audioflags"),
+		denoise: hasBooleanCapability(flags, memberType, null, "denoise"),
+		lowbitrate: hasBooleanCapability(flags, memberType, null, "lowbitrate")
 	};
 }
 /**
@@ -3459,6 +3463,10 @@ var Participant = class extends Destroyable {
 	get nodeId() {
 		return this._state$.value.node_id;
 	}
+	/** Call ID for this participant's leg, or `undefined` if not available. */
+	get callId() {
+		return this._state$.value.call_id;
+	}
 	/** @internal */
 	get value() {
 		return this._state$.value;
@@ -3520,8 +3528,9 @@ var Participant = class extends Destroyable {
 			noise_suppression: !this.noiseSuppression
 		});
 	}
+	/** Toggles low-bitrate mode for this participant's media. */
 	async toggleLowbitrate() {
-		throw new UnimplementedError();
+		await this.executeMethod(this.id, "call.lowbitrate.set", { lowbitrate: !this.lowbitrate });
 	}
 	/**
 	* Adjusts the **conference-only** microphone energy gate / sensitivity level
@@ -3568,10 +3577,27 @@ var Participant = class extends Destroyable {
 	}
 	/**
 	* Sets the participant's position in the video layout.
+	*
+	* Requires the `member.position` capability. The gateway keys positions by the
+	* **target member's own** `call_id`/`node_id` (see issue #19400 and the legacy
+	* `setPositions` implementation), so this sends the participant's own call
+	* context — matching {@link Participant.remove}. A resolved promise does not
+	* guarantee a visible change: the backend silently returns `200` (no-op) for
+	* non-conference targets.
+	*
 	* @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 });
+		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.position.set", { targets: [{
+			target,
+			position: value
+		}] });
 	}
 	/** Removes this participant from the call. */
 	async remove() {
@@ -5979,7 +6005,11 @@ function isVertoInviteMessage(value) {
 	const msg = value;
 	return msg.method === "verto.invite" && isObject(msg.params) && hasProperty(msg.params, "sdp") && hasProperty(msg.params, "callID");
 }
-function isVertoByeMessage(value) {
+/**
+* Guards inbound `verto.bye` frames (server → client). Outbound bye messages are
+* built locally and never type-guarded, so only the inbound shape is asserted.
+*/
+function isVertoByeInboundMessage(value) {
 	if (!isVertoMethodMessage(value)) return false;
 	return value.method === "verto.bye";
 }
@@ -5999,6 +6029,14 @@ function isVertoMediaParamsInnerParams(value) {
 function isVertoPingInnerParams(value) {
 	return isObject(value) && hasProperty(value, "jsonrpc") && value.jsonrpc === "2.0" && hasProperty(value, "method") && value.method === "verto.ping";
 }
+/**
+* Guards the params of an inbound `verto.bye` frame (top-level `callID`). Use
+* this to recognise the bye payload extracted by `vertoBye$`, e.g. when racing
+* it against a boolean answer/reject signal.
+*/
+function isVertoByeInboundParamsGuard(value) {
+	return isObject(value) && hasProperty(value, "callID") && typeof value.callID === "string";
+}
 
 //#endregion
 //#region src/managers/VertoManager.ts
@@ -6336,7 +6374,7 @@ var WebRTCVertoManager = class extends VertoManager {
 		return this.cachedObservable("vertoMediaParams$", () => this.webRtcCallSession.webrtcMessages$.pipe(filterAs(isVertoMediaParamsInnerParams, "params"), takeUntil(this.destroyed$)));
 	}
 	get vertoBye$() {
-		return this.cachedObservable("vertoBye$", () => this.webRtcCallSession.webrtcMessages$.pipe(filterAs(isVertoByeMessage, "params"), takeUntil(this.destroyed$)));
+		return this.cachedObservable("vertoBye$", () => this.webRtcCallSession.webrtcMessages$.pipe(filterAs(isVertoByeInboundMessage, "params"), takeUntil(this.destroyed$)));
 	}
 	get vertoAttach$() {
 		return this.cachedObservable("vertoAttach$", () => this.webRtcCallSession.webrtcMessages$.pipe(filterAs(isVertoAttachMessage, "params"), takeUntil(this.destroyed$)));
@@ -6489,7 +6527,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			logger$16.debug("[WebRTCManager] Inbound answer handler aborted (destroyed).");
 			return;
 		}
-		if (isVertoByeMessage(vertoByeOrAccepted)) {
+		if (isVertoByeInboundParamsGuard(vertoByeOrAccepted)) {
 			logger$16.info("[WebRTCManager] Inbound call ended by remote before answer.");
 			this.callSession?.destroy();
 		} else if (!vertoByeOrAccepted) {
@@ -6591,7 +6629,7 @@ var WebRTCVertoManager = class extends VertoManager {
 			logger$16.debug("[WebRTCManager] Destroyed while waiting for call acceptance");
 			return;
 		}
-		if (isVertoByeMessage(vertoByeOrAccepted)) {
+		if (isVertoByeInboundParamsGuard(vertoByeOrAccepted)) {
 			logger$16.info("[WebRTCManager] Call ended before answer was sent.");
 			this.callSession?.destroy();
 		} else if (!vertoByeOrAccepted) {
@@ -7646,6 +7684,12 @@ function mosToQualityLevel(mos) {
 //#region src/core/entities/Call.ts
 const logger$12 = getLogger();
 /**
+* Verto method for setting member layout positions. Its gateway DTO requires a
+* `targets` array whose entries are `{ target, position }` (NOT bare targets),
+* so {@link WebRTCCall.buildMethodParams} special-cases it. See issue #19400.
+*/
+const POSITION_SET_METHOD = "call.member.position.set";
+/**
 * Ratio between the critical and warning RTT spike multipliers.
 * Warning threshold = baseline * warningMultiplier (default 3x)
 * Critical threshold = baseline * warningMultiplier * RTT_CRITICAL_TO_WARNING_RATIO
@@ -7852,7 +7896,7 @@ var WebRTCCall = class extends Destroyable {
 	* @throws {JSONRPCError} If the RPC call returns an error.
 	*/
 	async executeMethod(target, method, args) {
-		const params = this.buildMethodParams(target, args);
+		const params = this.buildMethodParams(target, args, method);
 		const request = buildRPCRequest({
 			method,
 			params
@@ -7866,12 +7910,16 @@ var WebRTCCall = class extends Destroyable {
 			throw error;
 		}
 	}
-	buildMethodParams(target, args) {
+	buildMethodParams(target, args, method) {
 		const self = {
 			node_id: this.nodeId ?? "",
 			call_id: this.id,
 			member_id: this.vertoManager.selfId ?? ""
 		};
+		if (method === POSITION_SET_METHOD) return {
+			...args,
+			self
+		};
 		if (typeof target === "object") return {
 			...args,
 			self,
@@ -8437,10 +8485,21 @@ var WebRTCCall = class extends Destroyable {
 		return this.deferEmission(this._answered$.asObservable());
 	}
 	/**
-	* Sets the call layout and participant positions.
+	* Sets the call layout and, optionally, individual participant positions.
+	*
+	* The gateway `call.layout.set` DTO has **no** `positions` member, so when
+	* `positions` is provided this method issues a `call.member.position.set`
+	* request per member (via {@link Participant.setPosition}, which keys each
+	* position by that member's own call context) alongside `call.layout.set`
+	* (issue #19400, Flag #6).
+	*
+	* **These operations are NOT atomic.** The layout is applied first, then each
+	* member position sequentially, so members may briefly flash into their
+	* default slots before being moved to the requested positions.
 	*
 	* @param layout - Layout name (must be one of {@link layouts}).
-	* @param positions - Map of member IDs to {@link VideoPosition} values.
+	* @param positions - Optional map of member IDs to {@link VideoPosition} values.
+	*   When omitted or empty, only the layout is changed.
 	* @throws {InvalidParams} If the layout is not in the available {@link layouts}.
 	*
 	* @example
@@ -8453,10 +8512,17 @@ var WebRTCCall = class extends Destroyable {
 	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(", ")}`);
 		const selfId = await firstValueFrom(this.selfId$.pipe(filter((id) => id !== null)));
-		await this.executeMethod(selfId, "call.layout.set", {
-			layout,
-			positions
-		});
+		await this.executeMethod(selfId, "call.layout.set", { layout });
+		const positionEntries = Object.entries(positions ?? {});
+		if (positionEntries.length === 0) return;
+		for (const [memberId, position] of positionEntries) {
+			const participant = this.participants.find((p) => p.id === memberId);
+			if (!participant) {
+				logger$12.warn(`[Call] setLayout: member ${memberId} not found in participants; skipping position ${position}`);
+				continue;
+			}
+			await participant.setPosition(position);
+		}
 	}
 	/**
 	* Transfers the call to another destination.
@@ -9371,11 +9437,41 @@ var ClientSessionManager = class extends Destroyable {
 			}
 		} else this._errors$.next(error);
 	}
+	/**
+	* Clear the resume state (authorization_state + protocol) only.
+	*
+	* This is the stale-auth-state recovery helper used by handleAuthError:
+	* the server rejected a reconnect, so the resume state is discarded and a
+	* fresh connect follows. Attach records are deliberately preserved — the
+	* session lives on through the reconnect and reattachCalls() needs the
+	* stored call references afterwards. Do NOT add detachAll() here.
+	*
+	* For public teardown (disconnect/destroy), use {@link teardownSessionState}
+	* instead, which clears the attach records as well.
+	*/
 	async cleanupStoredConnectionParams() {
 		await this.transport.setProtocol(void 0);
 		await this.updateAuthorizationStateInStorage(void 0);
 		this._authorization$.next(void 0);
 	}
+	/**
+	* Public-teardown helper for disconnect()/destroy(). Clears the resume
+	* state (authorization_state + protocol) AND the attach records as one
+	* atomic unit.
+	*
+	* The two stores are coupled: the backend only honors attach records
+	* within the session identified by the resume state, so ending the
+	* session must clear both. Clearing one without the other strands records
+	* no future session can honor (disconnect) or revives a session the
+	* developer explicitly ended (destroy).
+	*
+	* Distinct from {@link cleanupStoredConnectionParams}, which keeps the
+	* attach records for the stale-auth-state recovery path.
+	*/
+	async teardownSessionState() {
+		await this.cleanupStoredConnectionParams();
+		await this.attachManager.detachAll();
+	}
 	async updateAuthState(authorization_state) {
 		try {
 			await this.storage.setItem(this.authorizationStateKey, authorization_state);
@@ -9470,7 +9566,7 @@ var ClientSessionManager = class extends Destroyable {
 	async disconnect() {
 		this.transport.disconnect();
 		this._authState$.next({ kind: "unauthenticated" });
-		await this.cleanupStoredConnectionParams();
+		await this.teardownSessionState();
 	}
 	async createInboundCall(invite) {
 		const callSession = await this.createCall({
@@ -10632,6 +10728,10 @@ var TransportManager = class extends Destroyable {
 				if (!isSignalwireRequest(message)) return true;
 				const eventChannel = message.params.event_channel;
 				if (!eventChannel) return true;
+				if (message.params.event_type.startsWith("conversation.")) {
+					logger$2.debug(`[Transport] Received conversation event: ${message.params.event_type} (event_channel: ${eventChannel})`);
+					return true;
+				}
 				const currentProtocol = this._currentProtocol;
 				if (!currentProtocol) return true;
 				if (!eventChannel.includes(currentProtocol)) {
@@ -11231,7 +11331,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.0" });
+			this._diagnosticsCollector = new DiagnosticsCollector({ sdkVersion: "4.0.0-rc.1" });
 		} catch (error) {
 			logger$1.warn("[SignalWire] Failed to initialize DiagnosticsCollector:", error);
 		}
@@ -11239,6 +11339,14 @@ var SignalWire = class extends Destroyable {
 	/**
 	* Disconnects the WebSocket and tears down the current session.
 	*
+	* Ends the session identified by the protocol and clears its persisted
+	* resume state (`authorization_state` + protocol) and attach records
+	* together — a later {@link connect} with the same credentials starts a
+	* fresh session and cannot reattach to the ended session's calls.
+	* Credentials and device preferences are preserved. To temporarily stop
+	* receiving inbound calls while keeping the session alive, use
+	* `unregister()` instead.
+	*
 	* The client can be reconnected by calling {@link connect} again,
 	* which creates a fresh transport and session.
 	*/
@@ -11630,12 +11738,20 @@ var SignalWire = class extends Destroyable {
 		prefs.preferredVideoInput = null;
 		await this._deviceController.clearDeviceState();
 	}
-	/** Destroys the client, clearing timers and releasing all resources. */
+	/**
+	* Destroys the client, clearing timers and releasing all resources.
+	*
+	* Intentionally destroying the client ends its session: the resume state
+	* (`authorization_state` + protocol) and the attach records are both
+	* cleared. Credentials and device preferences are preserved — use
+	* {@link resetToDefaults} for a full wipe. To temporarily stop receiving
+	* inbound calls while keeping the session alive, use `unregister()`.
+	*/
 	destroy() {
 		this._refreshCoordinator?.destroy();
 		this._refreshCoordinator = void 0;
 		this._dpopManager?.destroy();
-		if (this._attachManager) this._attachManager.detachAll();
+		this._clientSession.teardownSessionState();
 		this._transport.destroy();
 		this._clientSession.destroy();
 		try {
@@ -11749,7 +11865,7 @@ var StaticCredentialProvider = class {
 /**
 * Library version from package.json, injected at build time.
 */
-const version = "4.0.0-rc.0";
+const version = "4.0.0-rc.1";
 /**
 * Flag indicating the library has been loaded and is ready to use.
 * For UMD builds: `window.SignalWire.ready`
@@ -11771,7 +11887,7 @@ const ready = true;
 */
 const emitReadyEvent = () => {
 	if (typeof window !== "undefined") {
-		const event = new CustomEvent("signalwire:js:ready", { detail: { version: "4.0.0-rc.0" } });
+		const event = new CustomEvent("signalwire:js:ready", { detail: { version: "4.0.0-rc.1" } });
 		window.dispatchEvent(event);
 	}
 };