@signalwire/js 4.0.0-dev-20260428212324 → 4.0.0-dev-20260430003639

package/dist/browser.mjs

@@ -457,9 +457,9 @@ var require_Subscriber = /* @__PURE__ */ __commonJSMin(((exports) => {
 	var NotificationFactories_1 = require_NotificationFactories();
 	var timeoutProvider_1 = require_timeoutProvider();
 	var errorContext_1$2 = require_errorContext();
-	var Subscriber$1 = function(_super) {
-		__extends$16(Subscriber$2, _super);
-		function Subscriber$2(destination) {
+	var Subscriber = function(_super) {
+		__extends$16(Subscriber$1, _super);
+		function Subscriber$1(destination) {
 			var _this = _super.call(this) || this;
 			_this.isStopped = false;
 			if (destination) {
@@ -468,54 +468,54 @@ var require_Subscriber = /* @__PURE__ */ __commonJSMin(((exports) => {
 			} else _this.destination = exports.EMPTY_OBSERVER;
 			return _this;
 		}
-		Subscriber$2.create = function(next, error, complete) {
+		Subscriber$1.create = function(next, error, complete) {
 			return new SafeSubscriber(next, error, complete);
 		};
-		Subscriber$2.prototype.next = function(value) {
+		Subscriber$1.prototype.next = function(value) {
 			if (this.isStopped) handleStoppedNotification(NotificationFactories_1.nextNotification(value), this);
 			else this._next(value);
 		};
-		Subscriber$2.prototype.error = function(err) {
+		Subscriber$1.prototype.error = function(err) {
 			if (this.isStopped) handleStoppedNotification(NotificationFactories_1.errorNotification(err), this);
 			else {
 				this.isStopped = true;
 				this._error(err);
 			}
 		};
-		Subscriber$2.prototype.complete = function() {
+		Subscriber$1.prototype.complete = function() {
 			if (this.isStopped) handleStoppedNotification(NotificationFactories_1.COMPLETE_NOTIFICATION, this);
 			else {
 				this.isStopped = true;
 				this._complete();
 			}
 		};
-		Subscriber$2.prototype.unsubscribe = function() {
+		Subscriber$1.prototype.unsubscribe = function() {
 			if (!this.closed) {
 				this.isStopped = true;
 				_super.prototype.unsubscribe.call(this);
 				this.destination = null;
 			}
 		};
-		Subscriber$2.prototype._next = function(value) {
+		Subscriber$1.prototype._next = function(value) {
 			this.destination.next(value);
 		};
-		Subscriber$2.prototype._error = function(err) {
+		Subscriber$1.prototype._error = function(err) {
 			try {
 				this.destination.error(err);
 			} finally {
 				this.unsubscribe();
 			}
 		};
-		Subscriber$2.prototype._complete = function() {
+		Subscriber$1.prototype._complete = function() {
 			try {
 				this.destination.complete();
 			} finally {
 				this.unsubscribe();
 			}
 		};
-		return Subscriber$2;
+		return Subscriber$1;
 	}(Subscription_1$10.Subscription);
-	exports.Subscriber = Subscriber$1;
+	exports.Subscriber = Subscriber;
 	var _bind = Function.prototype.bind;
 	function bind(fn, thisArg) {
 		return _bind.call(fn, thisArg);
@@ -579,7 +579,7 @@ var require_Subscriber = /* @__PURE__ */ __commonJSMin(((exports) => {
 			return _this;
 		}
 		return SafeSubscriber$1;
-	}(Subscriber$1);
+	}(Subscriber);
 	exports.SafeSubscriber = SafeSubscriber;
 	function handleUnhandledError(error) {
 		if (config_1$2.config.useDeprecatedSynchronousErrorHandling) errorContext_1$2.captureError(error);
@@ -11215,15 +11215,15 @@ var DependencyContainer = class {
 		this._baseURL = this.apiHost;
 		this._credential = {};
 	}
-	get subscriberId() {
-		return this.subscriber.id;
+	get userId() {
+		return this.user.id;
 	}
-	get subscriber() {
-		if (!this._subscriber) throw new DependencyError("Subscriber");
-		return this._subscriber;
+	get user() {
+		if (!this._user) throw new DependencyError("User");
+		return this._user;
 	}
-	set subscriber(subscriber) {
-		this._subscriber = subscriber;
+	set user(user) {
+		this._user = user;
 	}
 	get storage() {
 		if (!this._storageManager) {
@@ -11269,16 +11269,16 @@ var DependencyContainer = class {
 		this._deviceController = void 0;
 	}
 	get authorizationStateKey() {
-		return `sw:${this.subscriberId}:as`;
+		return `sw:${this.userId}:as`;
 	}
 	get protocolKey() {
-		return `sw:${this.subscriberId}:pt`;
+		return `sw:${this.userId}:pt`;
 	}
 	get attachedCallsKey() {
-		return `sw:${this.subscriberId}:att`;
+		return `sw:${this.userId}:att`;
 	}
-	getSubscriberFromAddressId() {
-		return this.subscriber.addresses[0]?.id ?? "";
+	getUserFromAddressId() {
+		return this.user.addresses[0]?.id ?? "";
 	}
 	set baseURL(baseURL) {
 		this._baseURL = baseURL;
@@ -12108,14 +12108,14 @@ var Fetchable = class extends Destroyable {
 };
 
 //#endregion
-//#region src/core/entities/Subscriber.ts
+//#region src/core/entities/User.ts
 /**
-* Authenticated subscriber profile.
+* Authenticated user profile.
 *
 * Fetched automatically when a {@link SignalWire} connects.
 * Contains identity, contact, and organization details.
 */
-var Subscriber = class extends Fetchable {
+var User = class extends Fetchable {
 	constructor(http) {
 		super("/api/fabric/subscriber/info", http);
 	}
@@ -13709,9 +13709,9 @@ var Participant = class extends Destroyable {
 	get meta$() {
 		return this.cachedObservable("meta$", () => this._state$.pipe((0, import_operators$1.map)((state) => state.meta), (0, import_operators$1.distinctUntilChanged)()));
 	}
-	/** Observable of the participant's subscriber ID. */
-	get subscriberId$() {
-		return this.cachedObservable("subscriberId$", () => this._state$.pipe((0, import_operators$1.map)((state) => state.subscriber_id), (0, import_operators$1.distinctUntilChanged)()));
+	/** Observable of the participant's user ID. */
+	get userId$() {
+		return this.cachedObservable("userId$", () => this._state$.pipe((0, import_operators$1.map)((state) => state.subscriber_id), (0, import_operators$1.distinctUntilChanged)()));
 	}
 	/** Observable of the participant's address ID. */
 	get addressId$() {
@@ -13815,8 +13815,8 @@ var Participant = class extends Destroyable {
 	get meta() {
 		return this._state$.value.meta;
 	}
-	/** Subscriber ID of this participant, or `undefined` if not available. */
-	get subscriberId() {
+	/** User ID of this participant, or `undefined` if not available. */
+	get userId() {
 		return this._state$.value.subscriber_id;
 	}
 	/** Address ID of this participant, or `undefined` if not available. */
@@ -15423,6 +15423,12 @@ var TransceiverController = class extends Destroyable {
 			scaleResolutionDownBy: Number(rid) * 6 || 1
 		}));
 	}
+	/**
+	* Resolve the current MediaTrackConstraints for an input kind, normalising
+	* boolean shorthand to an empty object. Public so the surrounding
+	* RTCPeerConnectionController can drive its own pipeline-aware getUserMedia
+	* call with the same effective constraints the transceiver would have used.
+	*/
 	getConstraintsFor(kind) {
 		const constraints = kind === "audio" ? this.inputAudioDeviceConstraints : this.inputVideoDeviceConstraints;
 		return typeof constraints === "boolean" ? {} : constraints;
@@ -15749,7 +15755,19 @@ var RTCPeerConnectionController = class extends Destroyable {
 		return this._memberId;
 	}
 	stopTrackSender(kind, options = { updateTransceiverDirection: false }) {
-		this.transceiverController?.stopTrackSender(kind, options);
+		const audioCovered = kind === "audio" || kind === "both";
+		if (audioCovered && this._localAudioPipeline) this.stopRawAudioInputForPipeline();
+		if (!audioCovered) this.transceiverController?.stopTrackSender(kind, options);
+		else if (kind === "both") this.transceiverController?.stopTrackSender("video", options);
+		else if (!this._localAudioPipeline) this.transceiverController?.stopTrackSender(kind, options);
+	}
+	stopRawAudioInputForPipeline() {
+		const rawTracks = this.localStreamController.localAudioTracks;
+		for (const track of rawTracks) if (track.readyState === "live") {
+			track.stop();
+			this.localStreamController.removeTrack(track.id);
+		}
+		this._localAudioPipeline?.setInputTrack(null);
 	}
 	get isNegotiating$() {
 		return this._isNegotiating$.asObservable();
@@ -16254,8 +16272,27 @@ var RTCPeerConnectionController = class extends Destroyable {
 		await this.transceiverController?.setupRemoteTransceivers(this.type);
 	}
 	async restoreTrackSender(kind) {
-		await this.transceiverController?.restoreTrackSender(kind);
-		if (kind !== "video" && this._localAudioPipeline) await this.applyLocalAudioPipelineToSender();
+		const audioCovered = kind === "audio" || kind === "both";
+		if (audioCovered && this._localAudioPipeline) await this.restoreRawAudioInputForPipeline();
+		if (!audioCovered) await this.transceiverController?.restoreTrackSender(kind);
+		else if (kind === "both") await this.transceiverController?.restoreTrackSender("video");
+		else if (!this._localAudioPipeline) await this.transceiverController?.restoreTrackSender(kind);
+	}
+	async restoreRawAudioInputForPipeline() {
+		if (!this._localAudioPipeline) return;
+		const constraints = this.transceiverController?.getConstraintsFor("audio") ?? {};
+		let stream;
+		try {
+			stream = await this.getUserMedia({ audio: constraints });
+		} catch (error) {
+			logger$16.error("[RTCPeerConnectionController] Failed to re-acquire mic for pipeline restore:", error);
+			this._errors$.next(toError(error));
+			return;
+		}
+		const newTrack = stream.getAudioTracks().at(0);
+		if (!newTrack) return;
+		this.localStreamController.addTrack(newTrack);
+		this._localAudioPipeline.setInputTrack(newTrack);
 	}
 	/**
 	* Return the lazily-created {@link LocalAudioPipeline}, constructing it on
@@ -19618,7 +19655,7 @@ var ClientSessionManager = class extends Destroyable {
 		this._errors$ = this.createReplaySubject(1);
 		this._authState$ = this.createBehaviorSubject({ kind: "unauthenticated" });
 		this._wasClientBound = false;
-		this._subscriberInfo$ = this.createBehaviorSubject(null);
+		this._userInfo$ = this.createBehaviorSubject(null);
 		this._calls$ = this.createBehaviorSubject({});
 		this._iceServers$ = this.createBehaviorSubject([]);
 		attachManager.setSession(this);
@@ -19631,11 +19668,11 @@ var ClientSessionManager = class extends Destroyable {
 	get incomingCalls() {
 		return Object.values(this._calls$.value).filter((call) => call.direction === "inbound");
 	}
-	get subscriberInfo$() {
-		return this._subscriberInfo$.asObservable();
+	get userInfo$() {
+		return this._userInfo$.asObservable();
 	}
-	get subscriberInfo() {
-		return this._subscriberInfo$.value;
+	get userInfo() {
+		return this._userInfo$.value;
 	}
 	get calls$() {
 		return this.cachedObservable("calls$", () => this._calls$.pipe((0, import_cjs$7.map)((calls) => Object.values(calls))));
@@ -20081,22 +20118,22 @@ var ConversationMessageCollection = class extends EntityCollection {
 	}
 };
 var ConversationsManager = class {
-	constructor(clientSession, http, getSubscriberAddressId, onError) {
+	constructor(clientSession, http, getUserAddressId, onError) {
 		this.clientSession = clientSession;
 		this.http = http;
-		this.getSubscriberAddressId = getSubscriberAddressId;
+		this.getUserAddressId = getUserAddressId;
 		this.onError = onError;
 		this.groupIds = /* @__PURE__ */ new Map();
 	}
 	async join(addressId) {
-		const subscriberFromAddressId = this.getSubscriberAddressId();
+		const userFromAddressId = this.getUserAddressId();
 		try {
 			const response = await this.http.request({
 				...POST_PARAMS,
 				url: `/api/fabric/conversations/join`,
 				body: JSON.stringify({
-					from_fabric_address_id: subscriberFromAddressId,
-					fabric_address_ids: [addressId, subscriberFromAddressId]
+					from_fabric_address_id: userFromAddressId,
+					fabric_address_ids: [addressId, userFromAddressId]
 				})
 			});
 			if (response.ok && !!response.body) {
@@ -20118,14 +20155,14 @@ var ConversationsManager = class {
 	}
 	async sendText(text, destinationAddressId) {
 		const groupId = this.groupIds.get(destinationAddressId) ?? await this.join(destinationAddressId);
-		const subscriberFromAddressId = this.getSubscriberAddressId();
+		const userFromAddressId = this.getUserAddressId();
 		try {
 			if ((await this.http.request({
 				...POST_PARAMS,
 				url: "/api/fabric/messages",
 				body: JSON.stringify({
 					group_id: groupId,
-					from_fabric_address_id: subscriberFromAddressId,
+					from_fabric_address_id: userFromAddressId,
 					text
 				})
 			})).ok) return;
@@ -20198,17 +20235,17 @@ var DeviceTokenManager = class extends Destroyable {
 		return this._effectiveExpireIn;
 	}
 	/**
-	* Activates the Client Bound SAT flow when the subscriber's token has
+	* Activates the Client Bound SAT flow when the user's token has
 	* `sat:refresh` scope.
 	*
 	* Steps:
-	* 1. Check subscriber's `sat_claims` for `sat:refresh` scope
+	* 1. Check user's `sat_claims` for `sat:refresh` scope
 	* 2. Call `/api/fabric/subscriber/devices/token` with a DPoP proof
 	* 3. Reauthenticate the session with the Client Bound SAT + DPoP proof
 	* 4. Emit token to trigger the reactive refresh pipeline
 	*/
-	async activate(subscriber, session, updateCredential) {
-		const { satClaims } = subscriber;
+	async activate(user, session, updateCredential) {
+		const { satClaims } = user;
 		if (!satClaims?.scope?.includes(SAT_REFRESH_SCOPE)) {
 			logger$6.debug("[DeviceToken] No sat:refresh scope, skipping Client Bound SAT activation");
 			return;
@@ -21055,7 +21092,7 @@ var SignalWire = class extends Destroyable {
 	constructor(credentialProvider, options = {}) {
 		super();
 		this.preferences = new ClientPreferences();
-		this._subscriber$ = this.createBehaviorSubject(void 0);
+		this._user$ = this.createBehaviorSubject(void 0);
 		this._directory$ = this.createBehaviorSubject(void 0);
 		this._isConnected$ = this.createBehaviorSubject(false);
 		this._isRegistered$ = this.createBehaviorSubject(false);
@@ -21195,7 +21232,7 @@ var SignalWire = class extends Destroyable {
 		if (this._deps.persistSession) this._deps.storage.setItem("sw:cached_credential", credential, "local");
 	}
 	async init() {
-		this._subscriber$.next(new Subscriber(this._deps.http));
+		this._user$.next(new User(this._deps.http));
 		if (!this._options.skipConnection) await this.connect();
 		if (!this._options.reconnectAttachedCalls && this._attachManager) await this._attachManager.flush();
 		if (!this._options.skipRegister) try {
@@ -21259,13 +21296,13 @@ var SignalWire = class extends Destroyable {
 	async connect() {
 		await this.teardownTransportAndSession();
 		try {
-			const subscriber = this._subscriber$.value;
-			if (!subscriber) throw new UnexpectedError("Subscriber not initialized before connect");
-			if (!await (0, import_cjs$1.firstValueFrom)(subscriber.fetched$)) throw new UnexpectedError("Failed to fetch subscriber information - fetched$ emitted false");
-			this._deps.subscriber = subscriber;
+			const user = this._user$.value;
+			if (!user) throw new UnexpectedError("User not initialized before connect");
+			if (!await (0, import_cjs$1.firstValueFrom)(user.fetched$)) throw new UnexpectedError("Failed to fetch user information - fetched$ emitted false");
+			this._deps.user = user;
 		} catch (error) {
-			logger$1.error(`[SignalWire] Failed to fetch subscriber information: ${error instanceof Error ? error.message : "Unknown error"}. This usually means the subscriber token is invalid or expired.`);
-			throw new UnexpectedError("Error fetching subscriber information", { cause: error });
+			logger$1.error(`[SignalWire] Failed to fetch user information: ${error instanceof Error ? error.message : "Unknown error"}. This usually means the user token is invalid or expired.`);
+			throw new UnexpectedError("Error fetching user information", { cause: error });
 		}
 		const errorHandler = (error) => {
 			this._errors$.next(error);
@@ -21299,7 +21336,7 @@ var SignalWire = class extends Destroyable {
 				logger$1.debug("[SignalWire] Developer refresh disabled — Client Bound SAT activation starting");
 			}
 			this._deviceTokenManager = new DeviceTokenManager(this._dpopManager, this._deps.http, (error) => this._errors$.next(error), () => this._deps.credential);
-			await this._deviceTokenManager.activate(this._deps.subscriber, this._clientSession, (cred) => {
+			await this._deviceTokenManager.activate(this._deps.user, this._clientSession, (cred) => {
 				this._deps.credential = {
 					...this._deps.credential,
 					...cred
@@ -21309,7 +21346,7 @@ var SignalWire = class extends Destroyable {
 		this.subscribeTo(this._clientSession.authenticated$.pipe((0, import_cjs$1.skip)(1), (0, import_cjs$1.filter)(Boolean)), async () => {
 			try {
 				if (this._deviceTokenManager) {
-					await this._deviceTokenManager.activate(this._deps.subscriber, this._clientSession, (cred) => {
+					await this._deviceTokenManager.activate(this._deps.user, this._clientSession, (cred) => {
 						this._deps.credential = {
 							...this._deps.credential,
 							...cred
@@ -21322,15 +21359,15 @@ var SignalWire = class extends Destroyable {
 				this._errors$.next(error instanceof Error ? error : new Error(String(error), { cause: error }));
 			}
 			try {
-				logger$1.debug("[SignalWire] Re-registering subscriber after reconnect");
+				logger$1.debug("[SignalWire] Re-registering user after reconnect");
 				await this.register();
-				logger$1.debug("[SignalWire] Subscriber re-registered successfully after reconnect");
+				logger$1.debug("[SignalWire] User re-registered successfully after reconnect");
 			} catch (error) {
 				logger$1.error("[SignalWire] Re-registration failed after reconnect:", error);
 				this._errors$.next(error instanceof Error ? error : new Error(String(error), { cause: error }));
 			}
 		});
-		const conversationManager = new ConversationsManager(this._clientSession, this._deps.http, () => this._deps.getSubscriberFromAddressId(), errorHandler);
+		const conversationManager = new ConversationsManager(this._clientSession, this._deps.http, () => this._deps.getUserFromAddressId(), errorHandler);
 		const directory = new DirectoryManager(this._deps.http, this._clientSession, conversationManager, errorHandler);
 		this._directory$.next(directory);
 		this._clientSession.setDirectory(directory);
@@ -21341,22 +21378,22 @@ var SignalWire = class extends Destroyable {
 		});
 	}
 	/**
-	* Observable that emits the {@link Subscriber} profile once fetched,
+	* Observable that emits the {@link User} profile once fetched,
 	* or `undefined` before authentication completes.
 	*
 	* @example
 	* ```ts
-	* client.subscriber$.subscribe(sub => {
-	*   if (sub) console.log('Logged in as', sub.email);
+	* client.user$.subscribe(u => {
+	*   if (u) console.log('Logged in as', u.email);
 	* });
 	* ```
 	*/
-	get subscriber$() {
-		return this.deferEmission(this._subscriber$.asObservable());
+	get user$() {
+		return this.deferEmission(this._user$.asObservable());
 	}
-	/** Current subscriber snapshot, or `undefined` if not yet authenticated. */
-	get subscriber() {
-		return this._subscriber$.value;
+	/** Current user snapshot, or `undefined` if not yet authenticated. */
+	get user() {
+		return this._user$.value;
 	}
 	/**
 	* Observable that emits the {@link Directory} instance once the client is connected,
@@ -21380,11 +21417,11 @@ var SignalWire = class extends Destroyable {
 	get directory() {
 		return this._directory$.value;
 	}
-	/** Observable that emits when the subscriber registration state changes. */
+	/** Observable that emits when the user registration state changes. */
 	get isRegistered$() {
 		return this.deferEmission(this._isRegistered$.asObservable());
 	}
-	/** Whether the subscriber is currently registered. */
+	/** Whether the user is currently registered. */
 	get isRegistered() {
 		return this._isRegistered$.value;
 	}
@@ -21517,7 +21554,7 @@ var SignalWire = class extends Destroyable {
 		await (0, import_cjs$1.firstValueFrom)(this.ready$.pipe((0, import_cjs$1.filter)((ready$1) => ready$1 === true)));
 	}
 	/**
-	* Registers the subscriber as online to receive inbound calls and events.
+	* Registers the user 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.
@@ -21538,7 +21575,7 @@ var SignalWire = class extends Destroyable {
 				this._errors$.next(error instanceof Error ? error : new Error(String(error), { cause: error }));
 				throw error;
 			}
-			logger$1.debug("[SignalWire] Failed to register subscriber, trying reauthentication...");
+			logger$1.debug("[SignalWire] Failed to register user, trying reauthentication...");
 			try {
 				await this._clientSession.reauthenticate(this._deps.credential.token);
 				logger$1.debug("[SignalWire] Reauthentication successful, retrying register()");
@@ -21549,14 +21586,14 @@ var SignalWire = class extends Destroyable {
 				this._isRegistered$.next(true);
 			} catch (reauthError) {
 				logger$1.error("[SignalWire] Reauthentication failed during register():", reauthError);
-				const registerError = new InvalidCredentialsError("Failed to register subscriber, and reauthentication attempt also failed. Please check your credentials.", { cause: reauthError instanceof Error ? reauthError : new Error(String(reauthError), { cause: reauthError }) });
+				const registerError = new InvalidCredentialsError("Failed to register user, and reauthentication attempt also failed. Please check your credentials.", { cause: reauthError instanceof Error ? reauthError : new Error(String(reauthError), { cause: reauthError }) });
 				this._errors$.next(registerError);
 				throw registerError;
 			}
 		}
 	}
 	/**
-	* Unregisters the subscriber, going offline for inbound calls.
+	* Unregisters the user, going offline for inbound calls.
 	*
 	* The WebSocket connection remains open; use {@link disconnect} to fully close it.
 	*/
@@ -21568,7 +21605,7 @@ var SignalWire = class extends Destroyable {
 			}));
 			this._isRegistered$.next(false);
 		} catch (error) {
-			logger$1.error("[SignalWire] Failed to unregister subscriber:", error);
+			logger$1.error("[SignalWire] Failed to unregister user:", error);
 			this._errors$.next(error instanceof Error ? error : new Error(String(error), { cause: error }));
 			throw error;
 		}
@@ -22043,5 +22080,5 @@ emitReadyEvent();
 if (typeof process === "undefined") globalThis.process = { env: { NODE_ENV: "production" } };
 
 //#endregion
-export { Address, CallCreateError, ClientPreferences, CollectionFetchError, DPoPInitError, DeviceTokenError, EmbedTokenCredentialProvider, InvalidCredentialsError, MediaTrackError, MessageParseError, OverconstrainedFallbackError, Participant, PreflightError, RecoveryError, SelfCapabilities, SelfParticipant, SignalWire, StaticCredentialProvider, Subscriber, TokenRefreshError, UnexpectedError, VertoPongError, WebRTCCall, embeddableCall, getLogger, isSelfParticipant, ready, setDebugOptions, setLogLevel, setLogger, version };
+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 };
 //# sourceMappingURL=browser.mjs.map