@signalwire/js 4.0.0-dev-20260911135809 → 4.0.0-dev-20260911173516

package/dist/browser.mjs

@@ -9405,6 +9405,20 @@ var AuxiliaryLegTimeoutError = class extends Error {
 		this.name = "AuxiliaryLegTimeoutError";
 	}
 };
+/**
+* An auxiliary leg was removed before it finished connecting.
+*
+* Typed rather than a bare resolve so a caller awaiting the start can tell a
+* cancel apart from a share that actually came up — the public methods return
+* `void`, so the promise is the only signal they have.
+*/
+var AuxiliaryLegCancelledError = class extends Error {
+	constructor(leg) {
+		super(`The ${leg} leg was removed before it finished connecting`);
+		this.leg = leg;
+		this.name = "AuxiliaryLegCancelledError";
+	}
+};
 var MediaTrackError = class extends Error {
 	constructor(operation, kind, originalError) {
 		super(`Media track ${operation} failed for ${kind}`, { cause: originalError instanceof Error ? originalError : void 0 });
@@ -9441,6 +9455,22 @@ var MediaAccessError = class extends Error {
 		return isMediaAccessDenial(this.originalError);
 	}
 };
+/**
+* Thrown by `startScreenShare()` when the call is already sharing a screen.
+*
+* A call carries at most one screen share. Accepting a second one would
+* overwrite the only reference the SDK holds to the first, leaving it
+* capturing and sending with no way to stop it — so the second request is
+* rejected and the live share is left untouched. Call `stopScreenShare()`
+* first to replace it.
+*/
+var ScreenShareAlreadyActiveError = class extends Error {
+	constructor(screenShareId, options) {
+		super(`A screen share is already active on this call (${screenShareId}). Call stopScreenShare() before starting another one.`, options);
+		this.screenShareId = screenShareId;
+		this.name = "ScreenShareAlreadyActiveError";
+	}
+};
 var DPoPInitError = class extends Error {
 	constructor(originalError, message = "Failed to initialize DPoP key pair") {
 		super(message, { cause: originalError instanceof Error ? originalError : void 0 });
@@ -14213,11 +14243,15 @@ var SelfParticipant = class extends Participant {
 	/**
 	* Starts sharing the local screen.
 	*
-	* The call is unaffected when acquisition fails.
+	* A call carries at most one screen share. Read `screenShareStatus` before
+	* calling and treat `'starting'`/`'stopping'` as busy.
 	*
-	* Known issue: stopping the share before its leg connects can leave this
-	* promise pending until the call ends, so do not gate UI on it.
+	* The call is unaffected when acquisition fails.
 	*
+	* @throws {ScreenShareAlreadyActiveError} When this call is already
+	* sharing a screen. Call {@link stopScreenShare} before starting another.
+	* @throws {AuxiliaryLegCancelledError} When {@link stopScreenShare} removes
+	* the share before its leg finishes connecting.
 	* @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.
@@ -14226,7 +14260,8 @@ var SelfParticipant = class extends Participant {
 		try {
 			await this.vertoManager.addScreenMedia();
 		} catch (error) {
-			logger$25.error("[Participant.startScreenShare] Screen share error:", error);
+			if (error instanceof AuxiliaryLegCancelledError) logger$25.debug("[Participant.startScreenShare] Screen share cancelled before connecting.");
+			else logger$25.error("[Participant.startScreenShare] Screen share error:", error);
 			throw error;
 		}
 	}
@@ -14247,9 +14282,8 @@ var SelfParticipant = class extends Participant {
 	*
 	* The call is unaffected when acquisition fails.
 	*
-	* Known issue: removing the device before its leg connects can leave this
-	* promise pending until the call ends, so do not gate UI on it.
-	*
+	* @throws {AuxiliaryLegCancelledError} When {@link removeAdditionalDevice}
+	* removes the device before its leg finishes connecting.
 	* @throws The raw `getUserMedia` error (e.g. `NotAllowedError` on
 	* permission denial) — inspect `error.name` to decide how to react — or
 	* `AuxiliaryLegTimeoutError` if the leg does not connect in time.
@@ -14258,7 +14292,8 @@ var SelfParticipant = class extends Participant {
 		try {
 			await this.vertoManager.addInputDevice(options);
 		} catch (error) {
-			logger$25.error("[Participant.addAdditionalDevice] Additional device error:", error);
+			if (error instanceof AuxiliaryLegCancelledError) logger$25.debug("[Participant.addAdditionalDevice] Device removed before connecting.");
+			else logger$25.error("[Participant.addAdditionalDevice] Additional device error:", error);
 			throw error;
 		}
 	}
@@ -16189,6 +16224,9 @@ var RTCPeerConnectionController = class extends Destroyable {
 	get propose() {
 		return this.options.propose ?? "main";
 	}
+	get connectionState() {
+		return this.peerConnection?.connectionState;
+	}
 	get isAdditionalDevice() {
 		return this.propose === "additional-device";
 	}
@@ -17810,6 +17848,7 @@ var WebRTCVertoManager = class extends VertoManager {
 	}
 	async initAdditionalPeerConnection(propose, options) {
 		const isScreenShare = propose === "screenshare";
+		if (isScreenShare && this._screenShareId && this._rtcPeerConnectionsMap.has(this._screenShareId)) throw new ScreenShareAlreadyActiveError(this._screenShareId);
 		let firstPeerConnectionError;
 		let rtcPeerConnController = null;
 		try {
@@ -17829,20 +17868,26 @@ var WebRTCVertoManager = class extends VertoManager {
 				this.reportLegError(error, rtcPeerConnController);
 			});
 			const pc = rtcPeerConnController;
-			await (0, import_cjs$15.firstValueFrom)((0, import_cjs$15.merge)(pc.localMediaSettled$.pipe((0, import_cjs$15.take)(1), (0, import_cjs$15.switchMap)(() => pc.connectionState$.pipe((0, import_cjs$15.filter)((state) => state === "connected"), (0, import_cjs$15.take)(1), (0, import_cjs$15.timeout)(DEFAULT_AUX_LEG_CONNECT_TIMEOUT_MS)))), this.legError$(pc.id)).pipe((0, import_cjs$15.takeUntil)(this.destroyed$)));
+			await (0, import_cjs$15.firstValueFrom)((0, import_cjs$15.merge)(pc.localMediaSettled$.pipe((0, import_cjs$15.take)(1), (0, import_cjs$15.switchMap)(() => pc.connectionState$.pipe((0, import_cjs$15.filter)((state) => state === "connected"), (0, import_cjs$15.take)(1), (0, import_cjs$15.timeout)(DEFAULT_AUX_LEG_CONNECT_TIMEOUT_MS)))), this.legError$(pc.id)).pipe((0, import_cjs$15.takeUntil)((0, import_cjs$15.merge)(this.destroyed$, pc.destroyed$))));
 			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);
-			if (rtcPeerConnController) {
+			const cancelled = error instanceof AuxiliaryLegCancelledError;
+			const aborted = error instanceof import_cjs$15.EmptyError && !firstPeerConnectionError;
+			if (!cancelled && !aborted) logger$16.warn("[WebRTCManager] Error initializing additional peer connection:", error);
+			if (rtcPeerConnController && this._rtcPeerConnectionsMap.has(rtcPeerConnController.id)) {
 				rtcPeerConnController.destroy();
 				this._rtcPeerConnectionsMap.delete(rtcPeerConnController.id);
 				this._rtcPeerConnections$.next(Array.from(this._rtcPeerConnectionsMap.values()));
 			}
 			if (isScreenShare) {
-				this._screenShareStatus$.next("none");
 				this._screenShareId = void 0;
+				this._screenShareStatus$.next("none");
+			}
+			if (cancelled) {
+				logger$16.debug("[WebRTCManager] Additional peer connection removed before connecting.");
+				throw error;
 			}
 			if (firstPeerConnectionError) throw firstPeerConnectionError instanceof MediaAccessError && firstPeerConnectionError.originalError instanceof Error ? firstPeerConnectionError.originalError : firstPeerConnectionError;
 			if (error instanceof import_cjs$15.EmptyError) {
@@ -17866,7 +17911,10 @@ var WebRTCVertoManager = class extends VertoManager {
 		if (removeTrack) return this.mainPeerConnection.stopTrackSender(removeTrack, { updateTransceiverDirection: true });
 	}
 	async removeScreenMedia() {
-		if (!["starting", "started"].includes(this._screenShareStatus$.value)) logger$16.warn("[WebRTCManager] No active screen share to stop.");
+		if (!["starting", "started"].includes(this._screenShareStatus$.value)) {
+			logger$16.warn("[WebRTCManager] No active screen share to stop.");
+			return;
+		}
 		if (!this._screenShareId) {
 			logger$16.debug("[WebRTCManager] No screen share peer connection found.");
 			return;
@@ -17881,6 +17929,10 @@ var WebRTCVertoManager = class extends VertoManager {
 		try {
 			if (rtcPeerConnController) await this.executeVertoBye(rtcPeerConnController);
 		} finally {
+			if (rtcPeerConnController && rtcPeerConnController.connectionState !== "connected") this._legErrors$.next({
+				legId: id,
+				error: new AuxiliaryLegCancelledError(rtcPeerConnController.propose)
+			});
 			rtcPeerConnController?.destroy();
 			this._rtcPeerConnectionsMap.delete(id);
 			this._rtcPeerConnections$.next(Array.from(this._rtcPeerConnectionsMap.values()));
@@ -23566,5 +23618,5 @@ emitReadyEvent();
 if (typeof process === "undefined") globalThis.process = { env: { NODE_ENV: "production" } };
 
 //#endregion
-export { Address, AuxiliaryLegTimeoutError, CallCreateError, CallNotReadyError, ClientPreferences, CollectionFetchError, DPoPInitError, DeviceTokenError, EmbedTokenCredentialProvider, InvalidCredentialsError, MediaAccessError, MediaTrackError, MessageParseError, OverconstrainedFallbackError, Participant, ParticipantNotReadyError, PreflightError, RecoveryError, SelfCapabilities, SelfParticipant, SignalWire, StaticCredentialProvider, TokenRefreshError, UnexpectedError, User, VertoPongError, WebRTCCall, embeddableCall, getLogger, isSelfParticipant, ready, setDebugOptions, setLogLevel, setLogger, version };
+export { Address, AuxiliaryLegCancelledError, AuxiliaryLegTimeoutError, CallCreateError, CallNotReadyError, ClientPreferences, CollectionFetchError, DPoPInitError, DeviceTokenError, EmbedTokenCredentialProvider, InvalidCredentialsError, MediaAccessError, MediaTrackError, MessageParseError, OverconstrainedFallbackError, Participant, ParticipantNotReadyError, PreflightError, RecoveryError, ScreenShareAlreadyActiveError, SelfCapabilities, SelfParticipant, SignalWire, StaticCredentialProvider, TokenRefreshError, UnexpectedError, User, VertoPongError, WebRTCCall, embeddableCall, getLogger, isSelfParticipant, ready, setDebugOptions, setLogLevel, setLogger, version };
 //# sourceMappingURL=browser.mjs.map