@vindral/web-sdk 4.2.0 → 4.2.1-10-ga7cb21ca

package/legacy.d.ts

@@ -132,7 +132,7 @@ declare class UserAgentInformation {
 	};
 }
 export type AudioCodec = "aac" | "opus" | "mp3";
-export type VideoCodec = "h264" | "av1";
+export type VideoCodec = "h264" | "h265" | "av1";
 /**
  * The current reconnect state to use to decide whether to kep reconnecting or not
  */
@@ -484,8 +484,8 @@ interface TrackObject {
 	displayWidth?: number;
 	displayHeight?: number;
 	language?: string;
-	["com.vindral.variant_uid"]?: string;
-	["com.vindral.drm"]?: string;
+	"com.vindral.variant_uid"?: string;
+	"com.vindral.drm"?: string;
 }
 interface CatalogRoot {
 	version: number;
@@ -782,6 +782,7 @@ export declare class ApiClient {
 	private toChannels;
 	private toChannel;
 }
+type TransportSelectionReason = "unsupported" | "disabled" | "unavailable" | "fallback";
 interface AdaptivityStatistics {
 	/**
 	 * True if adaptive bitrate (ABR) is enabled.
@@ -921,6 +922,7 @@ interface JitterModuleStatistics {
 interface MseModuleStatistics {
 	quotaErrorCount: number;
 	mediaSourceOpenTime: number;
+	playbackStallCount: number;
 	totalVideoFrames?: number;
 	droppedVideoFrames?: number;
 	successfulVideoAppendCalls?: number;
@@ -1296,6 +1298,14 @@ export declare class Vindral extends Emitter<PublicVindralEvents> {
 	 * setting targetBufferTime within that range for consistancy if using both min/max.
 	 */
 	set targetBufferTime(bufferTimeMs: number);
+	/**
+	 * Update the dynamic buffer time configuration at runtime.
+	 * Allows adjusting min and max buffer time without recreating the Vindral instance.
+	 */
+	updateBufferTimeConfig(config: {
+		minBufferTime?: number;
+		maxBufferTime?: number;
+	}): void;
 	/**
 	 * The estimated playback latency based on target buffer time, the connection rtt and local playback drift
 	 */
@@ -1533,6 +1543,8 @@ export declare class Vindral extends Emitter<PublicVindralEvents> {
 	private suspend;
 	private unsuspend;
 	private getRuntimeInfo;
+	private getPlaybackBufferState;
+	private onMediaElementBufferState;
 	private onMediaElementState;
 	private onBufferEvent;
 	/**
@@ -1596,6 +1608,14 @@ interface ConnectionStatistics {
 	 */
 	connectionSuccessRatio: number;
 	connectionProtocol: "vindral_ws" | "moq" | "moq_ws" | undefined;
+	/**
+	 * When connectionProtocol is "moq_ws", indicates why WebSocket was used instead of WebTransport.
+	 * - "unsupported": browser doesn't support WebTransport
+	 * - "disabled": webtransportEnabled option is false
+	 * - "unavailable": edge did not offer a WebTransport endpoint
+	 * - "fallback": WebTransport was attempted but failed or timed out
+	 */
+	transportSelectionReason: TransportSelectionReason | undefined;
 }
 /**
  * Contextual information about the language switch
@@ -1650,7 +1670,7 @@ export interface PublicVindralEvents {
 	 * In case of a fatal error it is appropriate to indicate what the error was to the user, either by displaying the error.message or
 	 * by using the error.code() as a key to look up a localization string. To resume streaming it is required to create a new Vindral instance.
 	 */
-	["error"]: Readonly<VindralError>;
+	error: Readonly<VindralError>;
 	/**
 	 * When the instance needs user input to activate audio or sometimes video playback.
 	 * Is called with an object
@@ -1661,51 +1681,51 @@ export interface PublicVindralEvents {
 	 * }
 	 * ```
 	 */
-	["needs user input"]: NeedsUserInputContext;
+	"needs user input": NeedsUserInputContext;
 	/**
 	 * When a timed metadata event has been triggered
 	 */
-	["metadata"]: Readonly<Metadata>;
+	metadata: Readonly<Metadata>;
 	/**
 	 * When the playback state changes
 	 */
-	["playback state"]: Readonly<PlaybackState>;
+	"playback state": Readonly<PlaybackState>;
 	/**
 	 * When the connection state changes
 	 */
-	["connection state"]: Readonly<ConnectionState>;
+	"connection state": Readonly<ConnectionState>;
 	/**
 	 * When the available rendition levels is changed
 	 */
-	["rendition levels"]: ReadonlyArray<RenditionLevel>;
+	"rendition levels": ReadonlyArray<RenditionLevel>;
 	/**
 	 * When the rendition level is changed
 	 */
-	["rendition level"]: Readonly<RenditionLevel>;
+	"rendition level": Readonly<RenditionLevel>;
 	/**
 	 * When the available languages is changed
 	 */
-	["languages"]: ReadonlyArray<string>;
+	languages: ReadonlyArray<string>;
 	/**
 	 * When the available text tracks are changed
 	 */
-	["text tracks"]: ReadonlyArray<string>;
+	"text tracks": ReadonlyArray<string>;
 	/**
 	 * When the available channels is changed
 	 */
-	["channels"]: ReadonlyArray<Channel>;
+	channels: ReadonlyArray<Channel>;
 	/**
 	 * When a context switch state change has occured.
 	 * E.g. when a channel change has been requested, or quality is changed.
 	 */
-	["context switch"]: Readonly<ContextSwitchState>;
+	"context switch": Readonly<ContextSwitchState>;
 	/**
 	 * Emitted when a wallclock time message has been received from the server.
 	 *
 	 * Note: This is the edge server wallclock time and thus may differ slightly
 	 * between two viewers if they are connected to different edge servers.
 	 */
-	["server wallclock time"]: Readonly<number>;
+	"server wallclock time": Readonly<number>;
 	/**
 	 * Is emitted during connection whether the channel is live or not.
 	 *
@@ -1715,41 +1735,41 @@ export interface PublicVindralEvents {
 	 * Note: If the web-sdk is instantiated at the same time as you are starting the stream it is possible
 	 * that this emits false until the started state has propagated through the system.
 	 */
-	["is live"]: boolean;
+	"is live": boolean;
 	/**
 	 * Emitted when a channel switch has been completed and the first frame of the new channel is rendered.
 	 * A string containing the channel id of the new channel is provided as an argument.
 	 */
-	["channel switch"]: Readonly<ChannelSwitchContext>;
+	"channel switch": Readonly<ChannelSwitchContext>;
 	/**
 	 * Emmitted when a channel switch fails.
 	 * A string containing the channel id of the current channel is provided as an argument.
 	 */
-	["channel switch failed"]: Readonly<ChannelSwitchContext>;
+	"channel switch failed": Readonly<ChannelSwitchContext>;
 	/**
 	 * Emitted when a language switch has been completed and the new language starts playing.
 	 */
-	["language switch"]: Readonly<LanguageSwitchContext>;
+	"language switch": Readonly<LanguageSwitchContext>;
 	/**
 	 * Emitted when the volume state changes.
 	 *
 	 * This is triggered triggered both when the user changes the volume through the Vindral instance, but also
 	 * from external sources such as OS media shortcuts or other native UI outside of the browser.
 	 */
-	["volume state"]: Readonly<VolumeState>;
+	"volume state": Readonly<VolumeState>;
 	/**
 	 * Emitted when the timeshift URLs are updated.
 	 */
-	["timeshift info"]: Readonly<TimeShiftInfo>;
+	"timeshift info": Readonly<TimeShiftInfo>;
 	/**
 	 * Emitted for each CMAF fragment received via the MoQ/VoQ path.
 	 * Contains raw fMP4 bytes suitable for recording.
 	 *
 	 * @internal Not part of the public API — may change without notice.
 	 */
-	["cmaf fragment"]: Readonly<CmafFragmentEvent>;
-	["buffer state event"]: Readonly<BufferStateEvent>;
-	["initialized media"]: void;
+	"cmaf fragment": Readonly<CmafFragmentEvent>;
+	"buffer state event": Readonly<BufferStateEvent>;
+	"initialized media": void;
 }
 /**
  * Available events to listen to
@@ -1758,27 +1778,27 @@ export interface CastSenderEvents {
 	/**
 	 * When a connection has been established with a CastReceiver
 	 */
-	["connected"]: void;
+	connected: void;
 	/**
 	 * When a previous session has been resumed
 	 */
-	["resumed"]: void;
+	resumed: void;
 	/**
 	 * When a CastReceiver has lost or stopped a connection
 	 */
-	["disconnected"]: void;
+	disconnected: void;
 	/**
 	 * When a connection attempt was initiated unsuccessfully
 	 */
-	["failed"]: void;
+	failed: void;
 	/**
 	 * When the remote connection emits a metadata event
 	 */
-	["metadata"]: Metadata;
+	metadata: Metadata;
 	/**
 	 * When the remote connection receives a server wallclock time event
 	 */
-	["server wallclock time"]: number;
+	"server wallclock time": number;
 }
 /**
  * Used for initializing the CastSender
@@ -1874,15 +1894,15 @@ interface AirPlaySenderEvents {
 	/**
 	 * When airplay targets are available.
 	 */
-	["available"]: void;
+	available: void;
 	/**
 	 * When a connection has been established with an airplay target.
 	 */
-	["connected"]: void;
+	connected: void;
 	/**
 	 * When the airplay target has lost or stopped a connection.
 	 */
-	["disconnected"]: void;
+	disconnected: void;
 }
 interface AirPlayConfig {
 	/**