@vindral/web-sdk 4.7.1 → 4.7.2

package/cast-sender.d.ts

@@ -317,6 +317,17 @@ interface Options {
 	logShippingEnabled?: boolean;
 	statsShippingEnabled?: boolean;
 	webtransportEnabled?: boolean;
+	/**
+	 * Use WebTransport for MoQ on browsers where it is unstable. When false, these connect MoQ over
+	 * WebSocket directly. Unstable browsers:
+	 * - Safari and every iOS/iPadOS browser (all WebKit): far more buffering than over WebSocket.
+	 * - Samsung Internet on Tizen Smart TVs: WebTransport connects fail and fall back to WebSocket.
+	 *
+	 * Has no effect when webtransportEnabled is false.
+	 *
+	 * Default is false.
+	 */
+	unstableWebtransportEnabled?: boolean;
 	/**
 	 * Enable wake lock for iOS devices.
 	 * The wake lock requires that the audio has been activated at least once for the instance, othwerwise it will not work.

package/core.d.ts

@@ -422,6 +422,17 @@ export interface Options {
 	logShippingEnabled?: boolean;
 	statsShippingEnabled?: boolean;
 	webtransportEnabled?: boolean;
+	/**
+	 * Use WebTransport for MoQ on browsers where it is unstable. When false, these connect MoQ over
+	 * WebSocket directly. Unstable browsers:
+	 * - Safari and every iOS/iPadOS browser (all WebKit): far more buffering than over WebSocket.
+	 * - Samsung Internet on Tizen Smart TVs: WebTransport connects fail and fall back to WebSocket.
+	 *
+	 * Has no effect when webtransportEnabled is false.
+	 *
+	 * Default is false.
+	 */
+	unstableWebtransportEnabled?: boolean;
 	/**
 	 * Enable wake lock for iOS devices.
 	 * The wake lock requires that the audio has been activated at least once for the instance, othwerwise it will not work.
@@ -819,7 +830,7 @@ declare class ApiClient {
 	private toChannels;
 	private toChannel;
 }
-type TransportSelectionReason = "unsupported" | "disabled" | "unavailable" | "fallback";
+type TransportSelectionReason = "unsupported" | "disabled" | "disabled_unstable_browser" | "unavailable" | "fallback";
 interface AdaptivityStatistics {
 	/**
 	 * True if adaptive bitrate (ABR) is enabled.
@@ -1752,6 +1763,7 @@ interface ConnectionStatistics {
 	 * When connectionProtocol is "moq_ws", indicates why WebSocket was used instead of WebTransport.
 	 * - "unsupported": browser doesn't support WebTransport
 	 * - "disabled": webtransportEnabled option is false
+	 * - "disabled_unstable_browser": browser with unstable WebTransport, and unstableWebtransportEnabled option is false
 	 * - "unavailable": edge did not offer a WebTransport endpoint
 	 * - "fallback": WebTransport was attempted but failed or timed out
 	 * Unset while reconnecting; once disconnected, the last connection's.

package/core.js

@@ -1,2 +1,2 @@
-import { a as e, c as t, d as n, f as r, i, l as a, o, r as s, s as c, t as l, u } from "./BZbYOX-0.js";
+import { a as e, c as t, d as n, f as r, i, l as a, o, r as s, s as c, t as l, u } from "./BqvCHW1b.js";
 export { s as AUTHENTICATION_EXPIRED_CODE, i as AUTHENTICATION_FAILED_CODE, e as CHANNEL_NOT_FOUND_CODE, o as CHANNEL_NOT_LIVE_CODE, c as CONNECTION_FAILED_AFTER_RETRIES_CODE, t as CONNECTION_FAILED_CODE, a as DISCONNECTED_BY_EDGE, u as INACTIVITY_CODE, n as NO_INCOMING_DATA, l as Vindral, r as VindralError };

package/legacy.d.ts

@@ -425,6 +425,17 @@ export interface Options {
 	logShippingEnabled?: boolean;
 	statsShippingEnabled?: boolean;
 	webtransportEnabled?: boolean;
+	/**
+	 * Use WebTransport for MoQ on browsers where it is unstable. When false, these connect MoQ over
+	 * WebSocket directly. Unstable browsers:
+	 * - Safari and every iOS/iPadOS browser (all WebKit): far more buffering than over WebSocket.
+	 * - Samsung Internet on Tizen Smart TVs: WebTransport connects fail and fall back to WebSocket.
+	 *
+	 * Has no effect when webtransportEnabled is false.
+	 *
+	 * Default is false.
+	 */
+	unstableWebtransportEnabled?: boolean;
 	/**
 	 * Enable wake lock for iOS devices.
 	 * The wake lock requires that the audio has been activated at least once for the instance, othwerwise it will not work.
@@ -834,7 +845,7 @@ export declare class ApiClient {
 	private toChannels;
 	private toChannel;
 }
-type TransportSelectionReason = "unsupported" | "disabled" | "unavailable" | "fallback";
+type TransportSelectionReason = "unsupported" | "disabled" | "disabled_unstable_browser" | "unavailable" | "fallback";
 interface AdaptivityStatistics {
 	/**
 	 * True if adaptive bitrate (ABR) is enabled.
@@ -1767,6 +1778,7 @@ interface ConnectionStatistics {
 	 * When connectionProtocol is "moq_ws", indicates why WebSocket was used instead of WebTransport.
 	 * - "unsupported": browser doesn't support WebTransport
 	 * - "disabled": webtransportEnabled option is false
+	 * - "disabled_unstable_browser": browser with unstable WebTransport, and unstableWebtransportEnabled option is false
 	 * - "unavailable": edge did not offer a WebTransport endpoint
 	 * - "fallback": WebTransport was attempted but failed or timed out
 	 * Unset while reconnecting; once disconnected, the last connection's.