@signalwire/js 4.0.0-dev-20260911172704 → 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 });
@@ -14234,11 +14248,10 @@ var SelfParticipant = class extends Participant {
 	*
 	* The call is unaffected when acquisition fails.
 	*
-	* 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.
-	*
 	* @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.
@@ -14247,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;
 		}
 	}
@@ -14268,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.
@@ -14279,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;
 		}
 	}
@@ -16210,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";
 	}
@@ -17851,13 +17868,15 @@ 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()));
@@ -17866,6 +17885,10 @@ var WebRTCVertoManager = class extends VertoManager {
 				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) {
 				logger$16.debug("[WebRTCManager] Additional peer connection aborted before connecting.");
@@ -17906,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()));
@@ -23591,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, ScreenShareAlreadyActiveError, 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