@vindral/web-sdk 4.0.0 → 4.1.0-1-g31205a30

package/player.d.ts

@@ -1,3 +1,47 @@
+interface Channel {
+	/**
+	 * Channel ID for the channel
+	 */
+	channelId: string;
+	/**
+	 * Display name
+	 */
+	name: string;
+	/**
+	 * Indicates whether there is an incoming source feed for the channel
+	 */
+	isLive: boolean;
+	/**
+	 * URLs to fetch thumbnail from
+	 */
+	thumbnailUrls: string[];
+}
+interface ClientOverrides {
+	maxVideoBitRate?: number;
+	minBufferTime?: number;
+	maxBufferTime?: number;
+	burstEnabled?: boolean;
+	sizeBasedResolutionCapEnabled?: boolean;
+	separateVideoSocketEnabled?: boolean;
+	videoCodecs?: string[];
+}
+type AudioCodec = "aac" | "opus" | "mp3";
+type VideoCodec = "h264" | "av1";
+interface MinMaxAverage {
+	last: number;
+	/**
+	 * Average value over a given interval.
+	 */
+	average: number;
+	/**
+	 * Maximum value over a given interval.
+	 */
+	max: number;
+	/**
+	 * Minimum value over a given interval.
+	 */
+	min: number;
+}
 type MatchingKeys<TRecord, TMatch, K extends keyof TRecord = keyof TRecord> = K extends (TRecord[K] extends TMatch ? K : never) ? K : never;
 type VoidKeys<Record> = MatchingKeys<Record, void>;
 type EventListenerReturnType = (() => void) | void;
@@ -5,6 +49,9 @@ declare class Emitter<TEvents, TEmits = TEvents, ArgLessEvents extends VoidKeys<
 	private listeners;
 	emit<T extends ArgLessEmits>(eventName: T): void;
 	emit<T extends ArgEmits>(eventName: T, args: TEmits[T]): void;
+	/**
+	 * Remove an event listener from `eventName`
+	 */
 	off<T extends ArgLessEvents>(eventName: T, fn: () => EventListenerReturnType): void;
 	off<T extends ArgEvents>(eventName: T, fn: (args: TEvents[T]) => EventListenerReturnType): void;
 	/**
@@ -23,10 +70,13 @@ declare class Emitter<TEvents, TEmits = TEvents, ArgLessEvents extends VoidKeys<
 	 */
 	once<T extends ArgLessEvents>(eventName: T, fn: () => void): void;
 	once<T extends ArgEvents>(eventName: T, fn: (args: TEvents[T]) => void): void;
+	/**
+	 * Reset the event emitter
+	 */
 	reset(): void;
 	private add;
 }
-declare const Levels: readonly [
+declare const LogLevels: readonly [
 	"off",
 	"error",
 	"warn",
@@ -34,8 +84,8 @@ declare const Levels: readonly [
 	"debug",
 	"trace"
 ];
-type Level = (typeof Levels)[number];
-declare const Level: {
+type LogLevel = (typeof LogLevels)[number];
+declare const LogLevel: {
 	ERROR: "error";
 	WARN: "warn";
 	INFO: "info";
@@ -43,65 +93,81 @@ declare const Level: {
 	TRACE: "trace";
 	OFF: "off";
 };
-interface MinMaxAverage {
-	last: number;
-	/**
-	 * Average value over a given interval.
-	 */
-	average: number;
-	/**
-	 * Maximum value over a given interval.
-	 */
-	max: number;
-	/**
-	 * Minimum value over a given interval.
-	 */
-	min: number;
-}
-type AudioCodec = "aac" | "opus" | "mp3";
-type VideoCodec = "h264" | "av1";
-interface Metadata {
-	/**
-	 * The raw string content as it was ingested (if using JSON, it needs to be parsed on your end)
-	 */
-	content: string;
-	/**
-	 * Timestamp in ms
-	 */
-	timestamp: number;
+declare const tags: unique symbol;
+type Tagged<BaseType, Tag extends PropertyKey> = BaseType & {
+	[tags]: {
+		[K in Tag]: void;
+	};
+};
+type Namespace = Tagged<Array<string>, "Namespace">;
+interface TrackObject {
+	namespace?: Namespace;
+	name: string;
+	format: string;
+	label?: string;
+	renderGroup?: number;
+	altGroup?: number;
+	initData?: string;
+	initTrack?: string;
+	depends?: Array<string>;
+	temporalId?: number;
+	spatialId?: number;
+	codec?: string;
+	mimeType?: string;
+	framerate?: [
+		number,
+		number
+	];
+	bitrate?: number;
+	width?: number;
+	height?: number;
+	samplerate?: number;
+	channelConfig?: string;
+	displayWidth?: number;
+	displayHeight?: number;
+	language?: string;
+	["com.vindral.variant_uid"]?: string;
+	["com.vindral.drm"]?: string;
 }
-interface TimeRange {
-	start: number;
-	end: number;
+interface CatalogRoot {
+	version: number;
+	streamingFormat?: number;
+	streamingFormatVersion?: string;
 }
-interface ReconnectState {
-	/**
-	 * The number or retry attempts so far.
-	 * This gets reset on every successful connect, so it will start from zero every
-	 * time the client instance gets disconnected and will increment until the
-	 * client instance makes a connection attempt is successful.
-	 */
-	reconnectRetries: number;
+interface TracksCatalog extends CatalogRoot {
+	namespace: Namespace;
+	tracks: Array<TrackObject>;
 }
 interface RenditionProps {
 	id: number;
+	/** */
 	bitRate: number;
+	/** */
 	codecString?: string;
+	/** */
 	language?: string;
+	/** */
 	meta?: Record<string, string>;
 }
 interface VideoRenditionProps {
+	/** */
 	codec: VideoCodec;
+	/** */
 	frameRate: [
 		number,
 		number
 	];
+	/** */
 	width: number;
+	/** */
 	height: number;
 }
 interface AudioRenditionProps {
+	/** */
 	codec: AudioCodec;
+	/** */
 	channels: number;
+	/** */
 	sampleRate: number;
 }
 interface TextRenditionProps {
@@ -113,15 +179,90 @@ type VideoRendition = VideoRenditionProps & RenditionProps;
 type AudioRendition = AudioRenditionProps & RenditionProps;
 type TextRendition = TextRenditionProps & RenditionProps;
 type Rendition = VideoRendition | AudioRendition | TextRendition;
+interface Telemetry {
+	url: string;
+	probability?: number;
+	includeErrors?: boolean;
+	includeEvents?: boolean;
+	includeStats?: boolean;
+	maxRetries?: number;
+	maxErrorReports?: number;
+	interval?: number;
+}
+interface ChannelWithCatalog extends Channel {
+	catalog: TracksCatalog;
+	renditions: Rendition[];
+	overrides?: ClientOverrides;
+}
+interface ChannelWithRenditions extends Channel {
+	renditions: Rendition[];
+	overrides?: ClientOverrides;
+}
+interface ServerCertificateHash {
+	algorithm: string;
+	value: string;
+}
+interface Edge {
+	moqUrl?: string;
+	moqWsUrl: string;
+	serverCertificateHashes?: ServerCertificateHash[];
+}
+interface MoQConnectInfo {
+	logsUrl?: string;
+	statsUrl?: string;
+	telemetry?: Telemetry;
+	channels: ChannelWithCatalog[];
+	edges: Edge[];
+}
+interface VindralConnectInfo {
+	logsUrl?: string;
+	statsUrl?: string;
+	telemetry?: Telemetry;
+	channels: ChannelWithRenditions[];
+	edges: string[];
+}
+type ConnectInfo = VindralConnectInfo | MoQConnectInfo;
+interface Metadata {
+	/**
+	 * The raw string content as it was ingested (if using JSON, it needs to be parsed on your end)
+	 */
+	content: string;
+	/**
+	 * Timestamp in ms
+	 */
+	timestamp: number;
+}
+interface TimeRange {
+	/** */
+	start: number;
+	/** */
+	end: number;
+}
+interface ReconnectState {
+	/**
+	 * The number or retry attempts so far.
+	 * This gets reset on every successful connect, so it will start from zero every
+	 * time the client instance gets disconnected and will increment until the
+	 * client instance makes a connection attempt is successful.
+	 */
+	reconnectRetries: number;
+}
 interface Size {
+	/** */
 	width: number;
+	/** */
 	height: number;
 }
 interface VideoConstraint {
+	/** */
 	width: number;
+	/** */
 	height: number;
+	/** */
 	bitRate: number;
+	/** */
 	codec?: VideoCodec;
+	/** */
 	codecString?: string;
 }
 interface AdvancedOptions {
@@ -132,6 +273,16 @@ interface AdvancedOptions {
 	 */
 	wasmDecodingConstraint: Partial<VideoConstraint>;
 }
+interface DrmOptions {
+	/**
+	 * Headers to be added to requests to license servers
+	 */
+	headers?: Record<string, string>;
+	/**
+	 * Query parameters to be added to requests to license servers
+	 */
+	queryParams?: Record<string, string>;
+}
 type Media = "audio" | "video" | "audio+video";
 interface Options {
 	/**
@@ -168,7 +319,7 @@ interface Options {
 	/**
 	 * Sets the log level - defaults to info
 	 */
-	logLevel?: Level;
+	logLevel?: LogLevel;
 	/**
 	 * Sets the minimum and initial buffer time
 	 */
@@ -298,6 +449,7 @@ interface Options {
 	edgeUrl?: string;
 	logShippingEnabled?: boolean;
 	statsShippingEnabled?: boolean;
+	webtransportEnabled?: 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.
@@ -322,113 +474,17 @@ interface Options {
 	advanced?: AdvancedOptions;
 	media?: Media;
 	videoCodecs?: VideoCodec[];
+	/**
+	 * DRM options to provide to the Vindral instance
+	 */
+	drm?: DrmOptions;
 }
 interface RenditionLevel {
+	/** */
 	audio?: AudioRendition;
+	/** */
 	video?: VideoRendition;
 }
-interface Channel {
-	/**
-	 * Channel ID for the channel
-	 */
-	channelId: string;
-	/**
-	 * Display name
-	 */
-	name: string;
-	/**
-	 * Indicates whether there is an incoming source feed for the channel
-	 */
-	isLive: boolean;
-	/**
-	 * URLs to fetch thumbnail from
-	 */
-	thumbnailUrls: string[];
-}
-interface ClientOverrides {
-	maxVideoBitRate?: number;
-	minBufferTime?: number;
-	maxBufferTime?: number;
-	burstEnabled?: boolean;
-	sizeBasedResolutionCapEnabled?: boolean;
-	separateVideoSocketEnabled?: boolean;
-	videoCodecs?: string[];
-}
-interface ChannelWithRenditionsAndOverrides extends Channel {
-	renditions: Rendition[];
-	overrides?: ClientOverrides;
-}
-interface ConnectOptions {
-	channelGroupId?: string;
-	channelId: string;
-}
-interface Telemetry {
-	url: string;
-	probability?: number;
-	includeErrors?: boolean;
-	includeEvents?: boolean;
-	includeStats?: boolean;
-	maxRetries?: number;
-	maxErrorReports?: number;
-	interval?: number;
-}
-interface ConnectResponse {
-	logsUrl?: string;
-	statsUrl?: string;
-	telemetry?: Telemetry;
-	channels: ChannelWithRenditionsAndOverrides[];
-	edges: string[];
-}
-interface ApiClientOptions {
-	/**
-	 * String representing the URL to the public CDN API.
-	 */
-	publicEndpoint: string;
-	/**
-	 * Function that should return a string containing a signed authentication token.
-	 */
-	tokenFactory?: AuthorizationTokenFactory;
-}
-interface AuthorizationContext {
-	/**
-	 * The channelGroupId that might need authorization.
-	 */
-	channelGroupId?: string;
-	/**
-	 * The channelId that might need authorization.
-	 */
-	channelId?: string;
-}
-type AuthorizationTokenFactory = (context: AuthorizationContext) => string | undefined;
-declare class ApiClient {
-	private baseUrl;
-	private tokenFactory?;
-	constructor(options: ApiClientOptions);
-	/**
-	 * Returns everything needed to setup the connection of Vindral instance.
-	 */
-	connect(options: ConnectOptions): Promise<ConnectResponse>;
-	/**
-	 * Fetches information regarding a single channel.
-	 *
-	 * @param channelId the channel to fetch
-	 * @returns a [[Channel]] containing information about the requested channel.
-	 */
-	getChannel(channelId: string): Promise<Channel>;
-	/**
-	 * Fetches channels within a channel group
-	 *
-	 * Note: The returned list includes inactive channels - check isLive to filter out only active channels
-	 *
-	 * @param channelGroup the channel group to fetch channels from
-	 * @returns an array of [[Channel]] that belong to the channel group
-	 */
-	getChannels(channelGroupId: string): Promise<Channel[]>;
-	private getHeaders;
-	private getAuthToken;
-	private toChannels;
-	private toChannel;
-}
 interface VindralErrorProps {
 	isFatal: boolean;
 	type?: ErrorType;
@@ -481,170 +537,61 @@ interface NeedsUserInputContext {
 	 */
 	forVideo: boolean;
 }
-type State = "connected" | "disconnected" | "connecting";
-type ContextSwitchState = "completed" | "started";
-interface ConnectionStatistics {
-	/**
-	 * RTT (round trip time) between client and server(s).
-	 */
-	rtt: MinMaxAverage;
-	/**
-	 * A very rough initial estimation of minimum available bandwidth.
-	 */
-	estimatedBandwidth: number;
-	edgeUrl?: string;
+interface ApiClientOptions {
 	/**
-	 * Total number of connections that have been established since instantiation.
+	 * String representing the URL to the public CDN API.
 	 */
-	connectCount: number;
+	publicEndpoint: string;
 	/**
-	 * Total number of connection attempts since instantiation.
+	 * Function that should return a string containing a signed authentication token.
 	 */
-	connectionAttemptCount: number;
+	tokenFactory?: AuthorizationTokenFactory;
 }
-interface LanguageSwitchContext {
+interface AuthorizationContext {
 	/**
-	 * The new language that was switched to
+	 * The channelGroupId that might need authorization.
 	 */
-	language: string;
-}
-interface ChannelSwitchContext {
+	channelGroupId?: string;
 	/**
-	 * The new channel id that was switched to
+	 * The channelId that might need authorization.
 	 */
-	channelId: string;
+	channelId?: string;
 }
-interface VolumeState {
-	/**
-	 * Wether the audio is muted
-	 */
-	isMuted: boolean;
-	/**
-	 * The volume level
-	 */
-	volume: number;
+interface ConnectOptions {
+	channelGroupId?: string;
+	channelId: string;
 }
-interface PublicVindralEvents {
-	/**
-	 * When an error that requires action has occured
-	 *
-	 * Can be a fatal error that will unload the Vindral instance - this is indicated by `isFatal()` on the error object returning true.
-	 *
-	 * 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>;
-	/**
-	 * When the instance needs user input to activate audio or sometimes video playback.
-	 * Is called with an object
-	 * ```javascript
-	 * {
-	 *   forAudio: boolean // true if user input is needed for audio playback
-	 *   forVideo: boolean // true if user input is needed for video playback
-	 * }
-	 * ```
-	 */
-	["needs user input"]: NeedsUserInputContext;
-	/**
-	 * When a timed metadata event has been triggered
-	 */
-	["metadata"]: Readonly<Metadata>;
-	/**
-	 * When the playback state changes
-	 */
-	["playback state"]: Readonly<PlaybackState>;
-	/**
-	 * When the connection state changes
-	 */
-	["connection state"]: Readonly<State>;
-	/**
-	 * When the available rendition levels is changed
-	 */
-	["rendition levels"]: ReadonlyArray<RenditionLevel>;
-	/**
-	 * When the rendition level is changed
-	 */
-	["rendition level"]: Readonly<RenditionLevel>;
-	/**
-	 * When the available languages is changed
-	 */
-	["languages"]: ReadonlyArray<string>;
-	/**
-	 * When the available text tracks are changed
-	 */
-	["text tracks"]: ReadonlyArray<string>;
-	/**
-	 * When the available channels is changed
-	 */
-	["channels"]: ReadonlyArray<Channel>;
+type AuthorizationTokenFactory = (context: AuthorizationContext) => string | undefined;
+declare class ApiClient {
+	private baseUrl;
+	private tokenFactory?;
+	constructor(options: ApiClientOptions);
 	/**
-	 * When a context switch state change has occured.
-	 * E.g. when a channel change has been requested, or quality is changed.
+	 * @ignore
+	 * Returns everything needed to setup the connection of Vindral instance.
 	 */
-	["context switch"]: Readonly<ContextSwitchState>;
+	connect(options: ConnectOptions): Promise<ConnectInfo>;
 	/**
-	 * Emitted when a wallclock time message has been received from the server.
+	 * Fetches information regarding a single channel.
 	 *
-	 * Note: This is the edge server wallclock time and thus may differ slightly
-	 * between two viewers if they are connected to different edge servers.
+	 * @param channelId the channel to fetch
+	 * @returns a [[Channel]] containing information about the requested channel.
 	 */
-	["server wallclock time"]: Readonly<number>;
+	getChannel(channelId: string): Promise<Channel>;
 	/**
-	 * Is emitted during connection whether the channel is live or not.
-	 *
-	 * If the channel is not live, the Vindral instance will try to reconnect until the `reconnectHandler`
-	 * determines that no more retries should be made.
+	 * Fetches channels within a channel group
 	 *
-	 * 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;
-	/**
-	 * 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>;
-	/**
-	 * Emitted when a language switch has been completed and the new language starts playing.
-	 */
-	["language switch"]: Readonly<LanguageSwitchContext>;
-	/**
-	 * Emitted when the volume state changes.
+	 * Note: The returned list includes inactive channels - check isLive to filter out only active channels
 	 *
-	 * 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.
+	 * @param channelGroupId the channel group to fetch channels from
+	 * @returns an array of [[Channel]] that belong to the channel group
 	 */
-	["volume state"]: Readonly<VolumeState>;
-	["buffer state event"]: Readonly<BufferStateEvent>;
-	["initialized media"]: void;
+	getChannels(channelGroupId: string): Promise<Channel[]>;
+	private getHeaders;
+	private getAuthToken;
+	private toChannels;
+	private toChannel;
 }
-declare const defaultOptions: {
-	sizeBasedResolutionCapEnabled: boolean;
-	pictureInPictureEnabled: boolean;
-	abrEnabled: boolean;
-	burstEnabled: boolean;
-	mseEnabled: boolean;
-	mseOpusEnabled: boolean;
-	muted: boolean;
-	minBufferTime: number;
-	maxBufferTime: number;
-	logLevel: Level;
-	maxSize: Size;
-	maxVideoBitRate: number;
-	maxAudioBitRate: number;
-	tags: string[];
-	media: Media;
-	poster: string | boolean;
-	reconnectHandler: (state: ReconnectState) => Promise<boolean> | boolean;
-	iosWakeLockEnabled: boolean;
-	telemetryEnabled: boolean;
-	iosMediaElementEnabled: boolean;
-	pauseSupportEnabled: boolean;
-	advanced: {
-		wasmDecodingConstraint: Partial<VideoConstraint>;
-	};
-	videoCodecs: VideoCodec[];
-};
 interface AdaptivityStatistics {
 	/**
 	 * True if adaptive bitrate (ABR) is enabled.
@@ -794,16 +741,7 @@ interface SyncModuleStatistics {
 	drift: number | undefined;
 	driftAdjustmentCount: number;
 	timeshiftDriftAdjustmentCount: number;
-	seekTime: number;
-}
-interface TelemetryModuleStatistics {
-	/**
-	 * The total amount of errors being spawned. Note that some media errors can trigger
-	 * thousands of errors for a single client in a few seconds before recovering. Therefore,
-	 * consider the number of viewers with errors, not just the total amount. Also, consider the median
-	 * instead of the mean for average calculation.
-	 */
-	errorCount: number;
+	seekTime: number;
 }
 interface VideoPlayerStatistics {
 	renderedFrameCount: number;
@@ -890,7 +828,6 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	#private;
 	private static MAX_POOL_SIZE;
 	private static INITIAL_MAX_BIT_RATE;
-	private static PING_TIMEOUT;
 	private static DISCONNECT_TIMEOUT;
 	private static REMOVE_CUE_THRESHOLD;
 	/**
@@ -916,6 +853,10 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 		 */
 		isSupported: () => boolean;
 	};
+	readonly drm: {
+		setHeaders: (headers: Record<string, string>) => void;
+		setQueryParams: (queryParams: Record<string, string>) => void;
+	};
 	private browser;
 	private options;
 	private element;
@@ -929,13 +870,11 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private _channels;
 	private createdAt;
 	private hasCalledConnect;
-	private apiClient;
 	private latestEmittedLanguages;
 	private wakeLock;
-	private cachedEdges;
-	private shiftedEdges;
 	private pool;
 	private userAgentInformation;
+	private encryptedMediaExtensions;
 	private sampleProcessingSesssions;
 	private sizes;
 	private isSuspended;
@@ -959,6 +898,9 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 * [Read more about it on Apple docs](https://developer.apple.com/library/archive/documentation/AudioVideo/Conceptual/Using_HTML5_Audio_Video/Device-SpecificConsiderations/Device-SpecificConsiderations.html)
 	 * for iOS-Specific Considerations. The following section is the important part:
 	 * On iOS devices, the audio level is always under the user's physical control. The volume property is not settable in JavaScript. Reading the volume property always returns 1.
+	 *
+	 * @param volume The volume to set. A floating point value between 0-1.
+	 *
 	 */
 	set volume(volume: number);
 	/**
@@ -974,7 +916,7 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 */
 	get muted(): boolean;
 	/**
-	 * Media (audio | video | audio+video)
+	 * Which media type is currently being played
 	 */
 	get media(): Media;
 	/**
@@ -988,7 +930,7 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	/**
 	 * The current connection state
 	 */
-	get connectionState(): Readonly<State>;
+	get connectionState(): Readonly<ConnectionState>;
 	/**
 	 * The current playback state
 	 */
@@ -1097,7 +1039,7 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 */
 	set channelId(channelId: string);
 	/**
-	 * Max size that will be subcribed to
+	 * Max size that will be subscribed to
 	 */
 	get maxSize(): Size;
 	/**
@@ -1166,10 +1108,24 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	get timeSpentBuffering(): number;
 	get timeActive(): number;
 	get mediaElement(): HTMLMediaElement | HTMLCanvasElement;
+	get audioNode(): AudioNode | undefined;
+	get drmStatistics(): {
+		keySystem?: string | undefined;
+		licenseServerUrl?: string | undefined;
+		mediaKeySystemConfiguration?: MediaKeySystemConfiguration | undefined;
+		provider?: string | undefined;
+		clearkeys?: Record<string, string>;
+		playreadyLicenseUrl?: string;
+		widevineLicenseUrl?: string;
+		fairplayLicenseUrl?: string;
+		fairplayCertificate?: ArrayBuffer;
+		videoCodec?: string;
+		audioCodec?: string;
+	} | null;
 	/**
 	 * Get active Vindral Options
 	 */
-	getOptions: () => Options & typeof defaultOptions;
+	getOptions: () => Options;
 	/**
 	 * Get url for fetching thumbnail. Note that fetching thumbnails only works for an active channel.
 	 */
@@ -1188,9 +1144,7 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	 * Get options that can be used for CastSender
 	 */
 	getCastOptions: () => Options;
-	private connectionInfo;
-	private estimateRTT;
-	private connectHandler;
+	private onConnectInfo;
 	private emitLanguagesIfChanged;
 	private updateTextTracks;
 	private cleanupTextTracks;
@@ -1271,6 +1225,158 @@ declare class Vindral extends Emitter<PublicVindralEvents> {
 	private timeToFirstFrame;
 	private willUseMediaSource;
 }
+interface TelemetryModuleStatistics {
+	/**
+	 * The total amount of errors being spawned. Note that some media errors can trigger
+	 * thousands of errors for a single client in a few seconds before recovering. Therefore,
+	 * consider the number of viewers with errors, not just the total amount. Also, consider the median
+	 * instead of the mean for average calculation.
+	 */
+	errorCount: number;
+}
+type ConnectionState = "connected" | "disconnected" | "connecting";
+type ContextSwitchState = "completed" | "started";
+interface ConnectionStatistics {
+	/**
+	 * RTT (round trip time) between client and server(s).
+	 */
+	rtt: MinMaxAverage;
+	/**
+	 * A very rough initial estimation of minimum available bandwidth.
+	 */
+	estimatedBandwidth: number;
+	edgeUrl?: string;
+	/**
+	 * Total number of connections that have been established since instantiation.
+	 */
+	connectCount: number;
+	/**
+	 * Total number of connection attempts since instantiation.
+	 */
+	connectionAttemptCount: number;
+	connectionProtocol: "vindral_ws" | "moq" | undefined;
+}
+interface LanguageSwitchContext {
+	/**
+	 * The new language that was switched to
+	 */
+	language: string;
+}
+interface ChannelSwitchContext {
+	/**
+	 * The new channel id that was switched to
+	 */
+	channelId: string;
+}
+interface VolumeState {
+	/**
+	 * Wether the audio is muted
+	 */
+	isMuted: boolean;
+	/**
+	 * The volume level
+	 */
+	volume: number;
+}
+interface PublicVindralEvents {
+	/**
+	 * When an error that requires action has occured
+	 *
+	 * Can be a fatal error that will unload the Vindral instance - this is indicated by `isFatal()` on the error object returning true.
+	 *
+	 * 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>;
+	/**
+	 * When the instance needs user input to activate audio or sometimes video playback.
+	 * Is called with an object
+	 * ```javascript
+	 * {
+	 *   forAudio: boolean // true if user input is needed for audio playback
+	 *   forVideo: boolean // true if user input is needed for video playback
+	 * }
+	 * ```
+	 */
+	["needs user input"]: NeedsUserInputContext;
+	/**
+	 * When a timed metadata event has been triggered
+	 */
+	["metadata"]: Readonly<Metadata>;
+	/**
+	 * When the playback state changes
+	 */
+	["playback state"]: Readonly<PlaybackState>;
+	/**
+	 * When the connection state changes
+	 */
+	["connection state"]: Readonly<ConnectionState>;
+	/**
+	 * When the available rendition levels is changed
+	 */
+	["rendition levels"]: ReadonlyArray<RenditionLevel>;
+	/**
+	 * When the rendition level is changed
+	 */
+	["rendition level"]: Readonly<RenditionLevel>;
+	/**
+	 * When the available languages is changed
+	 */
+	["languages"]: ReadonlyArray<string>;
+	/**
+	 * When the available text tracks are changed
+	 */
+	["text tracks"]: ReadonlyArray<string>;
+	/**
+	 * When the available channels is changed
+	 */
+	["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>;
+	/**
+	 * 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>;
+	/**
+	 * Is emitted during connection whether the channel is live or not.
+	 *
+	 * If the channel is not live, the Vindral instance will try to reconnect until the `reconnectHandler`
+	 * determines that no more retries should be made.
+	 *
+	 * 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;
+	/**
+	 * 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>;
+	/**
+	 * 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>;
+	/**
+	 * Emitted when a language switch has been completed and the new language starts playing.
+	 */
+	["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>;
+	["buffer state event"]: Readonly<BufferStateEvent>;
+	["initialized media"]: void;
+}
 declare abstract class VindralButton extends HTMLElement {
 	#private;
 	static observedAttributes: string[];
@@ -1283,7 +1389,7 @@ declare abstract class VindralButton extends HTMLElement {
 	attributeChangedCallback(name: string, _old: string, value: string): void;
 	protected abstract handleClick(e: Event): void;
 }
-declare class AirPlayButton extends VindralButton {
+export declare class AirPlayButton extends VindralButton {
 	#private;
 	static observedAttributes: string[];
 	constructor();
@@ -1294,14 +1400,23 @@ declare class AirPlayButton extends VindralButton {
 	get isAirPlaying(): boolean;
 	protected handleClick(_: Event): void;
 }
-declare class BufferingOverlay extends HTMLElement {
+declare class BufferingIcon extends HTMLElement {
 	#private;
 	static observedAttributes: "buffering"[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
 }
-declare class CastButton extends VindralButton {
+export declare class BufferingOverlay extends HTMLElement {
+	#private;
+	static observedAttributes: readonly [
+		"buffering"
+	];
+	constructor();
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+}
+export declare class CastButton extends VindralButton {
 	#private;
 	static observedAttributes: string[];
 	constructor();
@@ -1313,23 +1428,35 @@ declare class CastButton extends VindralButton {
 	protected handleClick(_: Event): void;
 }
 type CastOverlayAttributes = (typeof CastOverlay.observedAttributes)[number];
-declare class CastOverlay extends HTMLElement {
+export declare class CastOverlay extends HTMLElement {
 	#private;
-	static observedAttributes: ("is-casting" | "cast-receiver-name")[];
+	static observedAttributes: readonly [
+		"is-casting",
+		"cast-receiver-name"
+	];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
 	attributeChangedCallback(name: CastOverlayAttributes, oldValue: string, newValue: string): void;
 }
-declare class ChannelGrid extends HTMLElement {
+export declare class ChannelGrid extends HTMLElement {
 	#private;
-	static observedAttributes: string[];
+	static observedAttributes: readonly [
+		"channels",
+		"channel-id",
+		"authentication-token",
+		"mode",
+		"hidden"
+	];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
-	attributeChangedCallback(name: string, _old: string, value: string): void;
+	attributeChangedCallback(name: string, old: string, value: string): void;
+	get keysUsed(): string[];
+	handleEvent: (event: Event) => void;
+	focus(): void;
 }
-declare class ChannelGridButton extends VindralButton {
+export declare class ChannelGridButton extends VindralButton {
 	#private;
 	static observedAttributes: string[];
 	constructor();
@@ -1338,26 +1465,100 @@ declare class ChannelGridButton extends VindralButton {
 	attributeChangedCallback(name: string, old: string, value: string): void;
 	enable(): void;
 	protected handleClick(_: MouseEvent): void;
+	get isOpen(): boolean;
 }
-declare class ChannelGridItem extends HTMLElement {
+export declare class ChannelGridItem extends HTMLElement {
 	#private;
 	lastThumbnailUpdate?: number;
-	static observedAttributes: string[];
+	static observedAttributes: readonly [
+		"url",
+		"title",
+		"offline",
+		"authentication-token",
+		"visible"
+	];
 	constructor();
 	attributeChangedCallback(name: string, old: string, value: string): void;
 	updateThumbnail(): void;
 }
-declare class ControlBar extends HTMLElement {
+export declare class ControlBar extends HTMLElement {
 	static observedAttributes: never[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
 }
+interface AirPlaySenderEvents {
+	/**
+	 * When airplay targets are available.
+	 */
+	["available"]: void;
+	/**
+	 * When a connection has been established with an airplay target.
+	 */
+	["connected"]: void;
+	/**
+	 * When the airplay target has lost or stopped a connection.
+	 */
+	["disconnected"]: void;
+}
+interface AirPlayConfig {
+	/**
+	 * URL to use when connecting to the stream.
+	 */
+	url: string;
+	/**
+	 * Channel ID to connect to.
+	 */
+	channelId: string;
+	/**
+	 * A container to attach the video element in. This should be the same container that the vindral video element is attached to.
+	 */
+	container: HTMLElement;
+	/**
+	 * An authentication token to provide to the server when connecting - only needed for channels with authentication enabled
+	 * Note: If not supplied when needed, an "Authentication Failed" error will be raised.
+	 */
+	authenticationToken?: string;
+}
+declare class AirPlaySender extends Emitter<AirPlaySenderEvents> {
+	private config;
+	private hlsUrl;
+	private element;
+	private connectingTimeout?;
+	constructor(config: AirPlayConfig);
+	/**
+	 * True if the instance is casting right now.
+	 */
+	get casting(): boolean;
+	/**
+	 * Set the current channelId.
+	 */
+	set channelId(channelId: string);
+	/**
+	 * Update authentication token on an already established and authenticated connection.
+	 */
+	updateAuthenticationToken: (_token: string) => void;
+	/**
+	 * Fully unloads the instance. This disconnects the current listeners.
+	 */
+	unload: () => void;
+	/**
+	 * Show the AirPlay picker.
+	 */
+	showPlaybackTargetPicker(): void;
+	/**
+	 * Returns if AirPlay is supported.
+	 */
+	static isAirPlaySupported(): boolean;
+	private onAirPlayAvailable;
+	private onAirPlayPlaybackChanged;
+	private checkHlsUrl;
+}
 type ControllerAttributes = (typeof Controller.observedAttributes)[number];
-declare class Controller extends HTMLElement {
+export declare class Controller extends HTMLElement {
 	#private;
 	static observedAttributes: readonly [
-		...("language" | "channels" | "buffering" | "paused" | "volume" | "picture-in-picture" | "muted" | "languages" | "media" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "channel-id" | "channel-group-id" | "airplay-available" | "is-airplaying" | "text-tracks" | "text-track" | "needs-user-input" | "authentication-token" | "cast" | "airplay" | "pip" | "fullscreen")[],
+		...("language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "hide-ui-on-pause" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "channel-id" | "channel-group-id" | "pip-available" | "is-pip" | "airplay-available" | "is-airplaying" | "media" | "languages" | "text-tracks" | "text-track" | "needs-user-input-video" | "needs-user-input-audio" | "authentication-token" | "volume-level" | "cast" | "airplay" | "pip" | "fullscreen" | "vu-meter" | "poster-src")[],
 		"url",
 		"edge-url",
 		"target-buffer-time",
@@ -1379,7 +1580,13 @@ declare class Controller extends HTMLElement {
 		"telemetry-enabled",
 		"video-codecs",
 		"poster",
-		"auto-instance-enabled"
+		"advanced",
+		"drm-headers",
+		"drm-queryparams",
+		"webtransport-enabled",
+		"reconnect-retries",
+		"auto-instance-enabled",
+		"language"
 	];
 	constructor();
 	connectedCallback(): Promise<void>;
@@ -1389,9 +1596,10 @@ declare class Controller extends HTMLElement {
 	connectListener(component: HTMLElement): void;
 	disconnectListener(component: HTMLElement): void;
 	get instance(): Vindral | undefined;
+	get airPlay(): AirPlaySender | undefined;
 	connect(): void;
 }
-declare class FullscreenButton extends VindralButton {
+export declare class FullscreenButton extends VindralButton {
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
@@ -1409,27 +1617,32 @@ declare class VindralMenuButton extends VindralButton {
 	set listbox(listbox: HTMLElement);
 	set listboxSlot(listboxSlot: HTMLElement);
 	enable(): void;
+	hide(): void;
 	protected handleClick(e: Event): void;
 }
-declare class LanguageMenu extends VindralMenuButton {
+export declare class LanguageMenu extends VindralMenuButton {
 	#private;
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
 	attributeChangedCallback(name: string, old: string, value: string): void;
 }
-declare class LanguageMenuList extends HTMLElement {
+export declare class LanguageMenuList extends HTMLElement {
 	#private;
 	static observedAttributes: ("language" | "languages" | "text-tracks" | "text-track")[];
 	constructor();
 	connectedCallback(): void;
+	disconnectedCallback(): void;
 	attributeChangedCallback(name: string, old: string, value: string): void;
 	private set languages(value);
 	private set textTracks(value);
 	private set language(value);
 	private set textTrack(value);
+	get keysUsed(): string[];
+	handleEvent: (event: Event) => void;
+	focus(): void;
 }
-declare class MuteButton extends VindralButton {
+export declare class MuteButton extends VindralButton {
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
@@ -1439,7 +1652,7 @@ declare class MuteButton extends VindralButton {
 	get muted(): boolean;
 	protected handleClick(_: Event): void;
 }
-declare class PictureInPictureButton extends VindralButton {
+export declare class PictureInPictureButton extends VindralButton {
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
@@ -1449,7 +1662,7 @@ declare class PictureInPictureButton extends VindralButton {
 	get isPictureInPictureActive(): boolean;
 	protected handleClick(_: Event): void;
 }
-declare class PlayButton extends VindralButton {
+export declare class PlayButton extends VindralButton {
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
@@ -1459,34 +1672,61 @@ declare class PlayButton extends VindralButton {
 	get paused(): boolean;
 	protected handleClick(_: Event): void;
 }
-declare class Player extends HTMLElement {
+export declare class Player extends HTMLElement {
 	#private;
-	static observedAttributes: ("title" | "poster" | "language" | "channels" | "url" | "buffering" | "paused" | "volume" | "picture-in-picture" | "muted" | "languages" | "offline" | "media" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "channel-id" | "channel-group-id" | "airplay-available" | "is-airplaying" | "text-tracks" | "text-track" | "needs-user-input" | "authentication-token" | "cast" | "airplay" | "pip" | "fullscreen" | "edge-url" | "target-buffer-time" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "min-buffer-time" | "max-buffer-time" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "ios-background-play-enabled" | "ios-wake-lock-enabled" | "ios-media-element-enabled" | "abr-enabled" | "size-based-resolution-cap-enabled" | "telemetry-enabled" | "video-codecs" | "auto-instance-enabled")[];
+	static observedAttributes: readonly ("title" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "user-interacting" | "is-casting" | "cast-available" | "cast-receiver-name" | "ui-locked" | "hide-ui-on-pause" | "is-fullscreen" | "is-fullscreen-fallback" | "rendition-levels" | "rendition-level" | "max-video-bit-rate" | "channel-id" | "channel-group-id" | "pip-available" | "is-pip" | "airplay-available" | "is-airplaying" | "media" | "languages" | "text-tracks" | "text-track" | "needs-user-input-video" | "needs-user-input-audio" | "authentication-token" | "volume-level" | "cast" | "airplay" | "pip" | "fullscreen" | "vu-meter" | "poster-src" | "url" | "offline" | "edge-url" | "target-buffer-time" | "cast-receiver-id" | "cast-background" | "log-level" | "max-size" | "min-buffer-time" | "max-buffer-time" | "max-audio-bit-rate" | "burst-enabled" | "mse-enabled" | "mse-opus-enabled" | "ios-background-play-enabled" | "ios-wake-lock-enabled" | "ios-media-element-enabled" | "abr-enabled" | "size-based-resolution-cap-enabled" | "telemetry-enabled" | "video-codecs" | "drm-headers" | "drm-queryparams" | "webtransport-enabled" | "reconnect-retries" | "auto-instance-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
-	attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+	attributeChangedCallback(name: string, oldValue?: string, newValue?: string): void;
 	get instance(): Vindral | undefined;
+	get airPlay(): AirPlaySender | undefined;
+}
+type PosterOverlayAttributes = (typeof PosterOverlay.observedAttributes)[number];
+export declare class PosterOverlay extends HTMLElement {
+	#private;
+	static observedAttributes: readonly [
+		"poster-src",
+		"paused",
+		"disabled",
+		"intersecting"
+	];
+	constructor();
+	connectedCallback(): void;
+	disconnectedCallback(): void;
+	attributeChangedCallback(name: PosterOverlayAttributes, oldValue: string, newValue: string): void;
+	get disabled(): boolean;
+	set disabled(value: boolean);
+	get posterSrc(): string | null;
+	get paused(): boolean;
 }
-declare class RenditionLevelsMenu extends VindralMenuButton {
+export declare class RenditionLevelsMenu extends VindralMenuButton {
 	#private;
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
 	attributeChangedCallback(name: string, old: string, value: string): void;
 }
-declare class RenditionLevelsMenuList extends HTMLElement {
+export declare class RenditionLevelsMenuList extends HTMLElement {
 	#private;
 	static observedAttributes: ("rendition-levels" | "max-video-bit-rate")[];
 	constructor();
 	connectedCallback(): void;
+	disconnectedCallback(): void;
 	attributeChangedCallback(name: string, old: string, value: string): void;
 	private set list(value);
 	private set maxVideoBitrate(value);
+	get keysUsed(): string[];
+	handleEvent: (event: Event) => void;
+	focus(): void;
 }
-declare class ScrollOverlay extends HTMLElement {
+export declare class ScrollOverlay extends HTMLElement {
 	#private;
-	static observedAttributes: string[];
+	static observedAttributes: readonly [
+		"user-interacting",
+		"open",
+		"touch-enabled"
+	];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
@@ -1497,35 +1737,23 @@ declare class ScrollOverlay extends HTMLElement {
 	set visible(value: boolean);
 	get visible(): boolean;
 }
-declare class VindralRange extends HTMLElement {
+declare class VindralUserInputPlayOverlay extends HTMLElement {
 	#private;
 	static observedAttributes: string[];
-	range: HTMLInputElement;
 	constructor();
+	get keysUsed(): string[];
 	connectedCallback(): void;
-	disconnectedCallback(): void;
-	attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
 	enable(): void;
 	disable(): void;
-	handleEvent(event: Event): void;
-	updateBar(): void;
+	disconnectedCallback(): void;
 }
-declare class VolumeRange extends VindralRange {
+declare class VindralMessage extends HTMLElement {
 	#private;
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
 	attributeChangedCallback(name: string, old: string, value: string): void;
-	get volume(): string;
-	get muted(): boolean;
-}
-declare class BufferingIcon extends HTMLElement {
-	#private;
-	static observedAttributes: "buffering"[];
-	constructor();
-	connectedCallback(): void;
-	disconnectedCallback(): void;
 }
 declare class VindralPlayOverlay extends HTMLElement {
 	#private;
@@ -1533,26 +1761,39 @@ declare class VindralPlayOverlay extends HTMLElement {
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
+	attributeChangedCallback(name: string, old: string | null, value: string | null): void;
 }
-declare class VindralUserInputPlayOverlay extends VindralPlayOverlay {
+declare class VindralRange extends HTMLElement {
 	#private;
 	static observedAttributes: string[];
+	range: HTMLInputElement;
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
+	attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+	enable(): void;
+	disable(): void;
+	handleEvent(event: Event): void;
+	updateBar(): void;
+	get keysUsed(): string[];
 }
-declare class VindralMessage extends HTMLElement {
+export declare class VolumeRange extends VindralRange {
 	#private;
 	static observedAttributes: string[];
 	constructor();
 	connectedCallback(): void;
 	disconnectedCallback(): void;
 	attributeChangedCallback(name: string, old: string, value: string): void;
+	get volume(): string;
+	get muted(): boolean;
 }
 /**
- * Register all custom elements for the Vindral player
+ * Register custom elements for the Vindral player
  */
 export declare function registerComponents(): void;
+/**
+ * @ignore
+ */
 export declare interface VindralHTMLElementTagNameMap {
 	"vindral-controller": Controller;
 	"vindral-control-bar": ControlBar;
@@ -1577,6 +1818,7 @@ export declare interface VindralHTMLElementTagNameMap {
 	"vindral-language-menu-list": LanguageMenuList;
 	"vindral-message": VindralMessage;
 	"vindral-volume-range": VolumeRange;
+	"vindral-poster-overlay": PosterOverlay;
 	"vindral-player": Player;
 }