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

package/legacy.d.ts

@@ -867,18 +867,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;
@@ -972,6 +1014,22 @@ export type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["get
 	 * 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;
 };
 /**
  * Represents a Vindral client instance
@@ -1454,7 +1512,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;
 }
 /**
  * Contextual information about the language switch