@vindral/web-sdk 4.1.7 → 4.1.8-1-g16a70656

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.1.7",
+  "version": "4.1.8-1-g16a70656",
   "name": "@vindral/web-sdk",
   "main": "./legacy.umd.js",
   "module": "./legacy.es.js",

package/player.d.ts

@@ -788,18 +788,60 @@ interface QualityOfServiceModuleStatistics {
 	timeSpentRatio: {
 		[qualityIndex: string]: number;
 	};
+	/**
+	 * Ratio of time spent buffering to total active time (0-1).
+	 * Provides a normalized buffering quality metric regardless of session length.
+	 * A value of 0.05 means 5% of the active session was spent buffering.
+	 */
+	bufferingRatio: number;
+	/**
+	 * Number of buffering events per minute of active playback.
+	 * Normalizes buffering event count for comparison across sessions of different durations.
+	 */
+	bufferingEventsPerMinute: number;
+	/**
+	 * Weighted average rendition index based on time spent at each level.
+	 * Lower values indicate higher quality (index 0 is the highest quality).
+	 * Example: 0.3 means mostly on the best quality with some time on lower qualities.
+	 */
+	averageRenditionIndex: number;
+	/**
+	 * Buffering ratio for the last minute of playback (0-1).
+	 * Useful for detecting recent degradation vs overall session quality.
+	 */
+	bufferingRatioPerMinute: number;
+	/**
+	 * Number of rendition level changes (upgrades + downgrades) per minute.
+	 * Measures ABR stability - lower values indicate a more stable experience.
+	 */
+	renditionChangesPerMinute: number;
+	/**
+	 * Average time in milliseconds spent buffering per buffering event.
+	 * Helps distinguish many short buffering events from fewer long ones.
+	 */
+	timePerBufferingEvent: number;
 }
 interface SyncModuleStatistics {
 	drift: number | undefined;
 	seekAdjustmentCount: number;
 	timeshiftAdjustmentCount: number;
 	seekTime: number;
+	/**
+	 * Total time spent seeking in milliseconds for the entire session.
+	 * High values indicate frequent or slow seeks, which may impact user experience.
+	 */
+	totalSeekTime: number;
 	seekToleranceMultiplier: number;
 	currentSeekToleranceMs: number;
 	currentAheadToleranceMs: number;
 	isPlaybackRateAdjustmentEnabled: boolean;
 	playbackRate: number;
 	playbackRateAdjustmentCount: number;
+	/**
+	 * Average absolute drift in milliseconds over a rolling window.
+	 * Measures how far off sync the playback typically is, regardless of direction.
+	 */
+	averageDrift: number;
 }
 interface VideoPlayerStatistics {
 	renderedFrameCount: number;
@@ -885,6 +927,22 @@ type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAge
 	 * Average bitrate for the entire session in bits/second.
 	 */
 	averageBitRate?: number;
+	/**
+	 * Number of reconnections per hour of uptime.
+	 * Measures connection stability over time. Lower is better.
+	 * Excludes the initial connection, so a stable session will have a value of 0.
+	 */
+	reconnectsPerHour: number;
+	/**
+	 * Number of seek adjustments (seeks to catch up) per minute of active playback.
+	 * High values indicate sync issues or network instability.
+	 */
+	seekAdjustmentsPerMinute: number;
+	/**
+	 * Number of timeshift adjustments per minute of active playback.
+	 * Relevant for timeshift-enabled streams.
+	 */
+	timeshiftAdjustmentsPerMinute: number;
 };
 declare class Vindral extends Emitter<PublicVindralEvents> {
 	#private;
@@ -1324,7 +1382,12 @@ interface ConnectionStatistics {
 	 * Total number of connection attempts since instantiation.
 	 */
 	connectionAttemptCount: number;
-	connectionProtocol: "vindral_ws" | "moq" | undefined;
+	/**
+	 * Ratio of successful connections to total connection attempts (0-1).
+	 * A value of 1.0 means every connection attempt succeeded.
+	 */
+	connectionSuccessRatio: number;
+	connectionProtocol: "vindral_ws" | "moq" | "moq_ws" | undefined;
 }
 interface LanguageSwitchContext {
 	/**
@@ -1778,6 +1841,12 @@ export declare class PlayButton extends VindralButton {
 	get paused(): boolean;
 	protected handleClick(_: Event): void;
 }
+/**
+ * Full-featured Vindral player web component with built-in controls.
+ *
+ * {@include ../../docs/player.md}
+ *
+ */
 export declare class Player extends HTMLElement {
 	#private;
 	static observedAttributes: readonly ("title" | "advanced" | "poster" | "language" | "channels" | "buffering" | "paused" | "volume" | "muted" | "duration" | "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" | "max-initial-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" | "timeshift" | "timeshift-position" | "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" | "drm-widevine-video-robustness" | "drm-widevine-audio-robustness" | "drm-playready-video-robustness" | "drm-playready-audio-robustness" | "webtransport-enabled" | "reconnect-retries" | "auto-instance-enabled" | "refresh-poster-enabled" | "stream-poll-enabled")[];

package/player.js

@@ -31,7 +31,7 @@ var B = (c, a, t) => new Promise((i, s) => {
   }, p = (v) => v.done ? i(v.value) : Promise.resolve(v.value).then(o, u);
   p((t = t.apply(c, a)).next());
 });
-import { L as Tr, V as $o, i as Go, C as Ko, A as qo, a as Vo, b as Xo } from "./CQiPSKHx.js";
+import { L as Tr, V as $o, i as Go, C as Ko, A as qo, a as Vo, b as Xo } from "./_9pZeC_n.js";
 import { E as ds } from "./Bx7s5QdT.js";
 import { CastSender as jo } from "./cast-sender.js";
 import { A as Yo, d as Jo } from "./CPEMXA01.js";
@@ -812,11 +812,7 @@ class Br extends HTMLElement {
     l(this, di);
     l(this, ci);
     m(this, "handleEvent", (t) => {
-      switch (t.type) {
-        case "keydown":
-          n(this, S, Jr).call(this, t);
-          break;
-      }
+      t.type === "keydown" && n(this, S, Jr).call(this, t);
     });
     this.attachShadow({ mode: "open" }).appendChild(zr.content.cloneNode(!0));
   }
@@ -1480,7 +1476,7 @@ class ol {
 }
 f = new WeakMap(), M = new WeakMap(), w = new WeakMap(), Ce = new WeakMap(), bt = new WeakMap(), mt = new WeakMap(), Pt = new WeakMap(), ne = new WeakMap(), _t = new WeakMap(), et = new WeakMap(), pi = new WeakMap(), xe = new WeakMap(), C = new WeakMap(), T = new WeakSet(), ia = function() {
   return B(this, null, function* () {
-    const { default: a } = yield import("./CZNJPKf5.js");
+    const { default: a } = yield import("./h5LA1Y1W.js");
     if (d(this, Ce, a), !a.isSupported()) {
       e(this, C).warn("HLS not supported");
       return;
@@ -2717,7 +2713,9 @@ zs = new WeakMap(), vt = new WeakMap(), mi = new WeakMap(), Mt = new WeakMap(),
       const i = yield e(this, b).getApiClient().getChannels(e(this, ft));
       n(this, h, E).call(this, r.CHANNELS, JSON.stringify(i));
     }
-    d(this, Ot, window.setTimeout(() => void n(this, h, Sn).call(this), 1e4));
+    d(this, Ot, window.setTimeout(() => {
+      n(this, h, Sn).call(this);
+    }, 1e4));
   });
 }, Cn = function() {
   !this.hasAttribute(r.USER_INTERACTING) || this.hasAttribute(r.UI_LOCKED) || (this.dispatchEvent(
@@ -3044,11 +3042,7 @@ class Ua extends HTMLElement {
     l(this, At, null);
     l(this, ht, null);
     m(this, "handleEvent", (t) => {
-      switch (t.type) {
-        case "keydown":
-          n(this, I, Da).call(this, t);
-          break;
-      }
+      t.type === "keydown" && n(this, I, Da).call(this, t);
     });
     this.attachShadow({ mode: "open" }).appendChild(Ra.content.cloneNode(!0));
   }
@@ -4011,11 +4005,7 @@ class Za extends HTMLElement {
     l(this, ue, null);
     l(this, Wi, null);
     m(this, "handleEvent", (t) => {
-      switch (t.type) {
-        case "keydown":
-          n(this, U, so).call(this, t);
-          break;
-      }
+      t.type === "keydown" && n(this, U, so).call(this, t);
     });
     this.attachShadow({ mode: "open" }).appendChild(Qa.content.cloneNode(!0));
   }

package/react.d.ts

@@ -790,18 +790,60 @@ interface QualityOfServiceModuleStatistics {
 	timeSpentRatio: {
 		[qualityIndex: string]: number;
 	};
+	/**
+	 * Ratio of time spent buffering to total active time (0-1).
+	 * Provides a normalized buffering quality metric regardless of session length.
+	 * A value of 0.05 means 5% of the active session was spent buffering.
+	 */
+	bufferingRatio: number;
+	/**
+	 * Number of buffering events per minute of active playback.
+	 * Normalizes buffering event count for comparison across sessions of different durations.
+	 */
+	bufferingEventsPerMinute: number;
+	/**
+	 * Weighted average rendition index based on time spent at each level.
+	 * Lower values indicate higher quality (index 0 is the highest quality).
+	 * Example: 0.3 means mostly on the best quality with some time on lower qualities.
+	 */
+	averageRenditionIndex: number;
+	/**
+	 * Buffering ratio for the last minute of playback (0-1).
+	 * Useful for detecting recent degradation vs overall session quality.
+	 */
+	bufferingRatioPerMinute: number;
+	/**
+	 * Number of rendition level changes (upgrades + downgrades) per minute.
+	 * Measures ABR stability - lower values indicate a more stable experience.
+	 */
+	renditionChangesPerMinute: number;
+	/**
+	 * Average time in milliseconds spent buffering per buffering event.
+	 * Helps distinguish many short buffering events from fewer long ones.
+	 */
+	timePerBufferingEvent: number;
 }
 interface SyncModuleStatistics {
 	drift: number | undefined;
 	seekAdjustmentCount: number;
 	timeshiftAdjustmentCount: number;
 	seekTime: number;
+	/**
+	 * Total time spent seeking in milliseconds for the entire session.
+	 * High values indicate frequent or slow seeks, which may impact user experience.
+	 */
+	totalSeekTime: number;
 	seekToleranceMultiplier: number;
 	currentSeekToleranceMs: number;
 	currentAheadToleranceMs: number;
 	isPlaybackRateAdjustmentEnabled: boolean;
 	playbackRate: number;
 	playbackRateAdjustmentCount: number;
+	/**
+	 * Average absolute drift in milliseconds over a rolling window.
+	 * Measures how far off sync the playback typically is, regardless of direction.
+	 */
+	averageDrift: number;
 }
 interface VideoPlayerStatistics {
 	renderedFrameCount: number;
@@ -887,6 +929,22 @@ type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["getUserAge
 	 * Average bitrate for the entire session in bits/second.
 	 */
 	averageBitRate?: number;
+	/**
+	 * Number of reconnections per hour of uptime.
+	 * Measures connection stability over time. Lower is better.
+	 * Excludes the initial connection, so a stable session will have a value of 0.
+	 */
+	reconnectsPerHour: number;
+	/**
+	 * Number of seek adjustments (seeks to catch up) per minute of active playback.
+	 * High values indicate sync issues or network instability.
+	 */
+	seekAdjustmentsPerMinute: number;
+	/**
+	 * Number of timeshift adjustments per minute of active playback.
+	 * Relevant for timeshift-enabled streams.
+	 */
+	timeshiftAdjustmentsPerMinute: number;
 };
 declare class Vindral extends Emitter<PublicVindralEvents> {
 	#private;
@@ -1326,7 +1384,12 @@ interface ConnectionStatistics {
 	 * Total number of connection attempts since instantiation.
 	 */
 	connectionAttemptCount: number;
-	connectionProtocol: "vindral_ws" | "moq" | undefined;
+	/**
+	 * Ratio of successful connections to total connection attempts (0-1).
+	 * A value of 1.0 means every connection attempt succeeded.
+	 */
+	connectionSuccessRatio: number;
+	connectionProtocol: "vindral_ws" | "moq" | "moq_ws" | undefined;
 }
 interface LanguageSwitchContext {
 	/**