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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/core.d.ts CHANGED
@@ -852,18 +852,60 @@ interface QualityOfServiceModuleStatistics {
852
852
  timeSpentRatio: {
853
853
  [qualityIndex: string]: number;
854
854
  };
855
+ /**
856
+ * Ratio of time spent buffering to total active time (0-1).
857
+ * Provides a normalized buffering quality metric regardless of session length.
858
+ * A value of 0.05 means 5% of the active session was spent buffering.
859
+ */
860
+ bufferingRatio: number;
861
+ /**
862
+ * Number of buffering events per minute of active playback.
863
+ * Normalizes buffering event count for comparison across sessions of different durations.
864
+ */
865
+ bufferingEventsPerMinute: number;
866
+ /**
867
+ * Weighted average rendition index based on time spent at each level.
868
+ * Lower values indicate higher quality (index 0 is the highest quality).
869
+ * Example: 0.3 means mostly on the best quality with some time on lower qualities.
870
+ */
871
+ averageRenditionIndex: number;
872
+ /**
873
+ * Buffering ratio for the last minute of playback (0-1).
874
+ * Useful for detecting recent degradation vs overall session quality.
875
+ */
876
+ bufferingRatioPerMinute: number;
877
+ /**
878
+ * Number of rendition level changes (upgrades + downgrades) per minute.
879
+ * Measures ABR stability - lower values indicate a more stable experience.
880
+ */
881
+ renditionChangesPerMinute: number;
882
+ /**
883
+ * Average time in milliseconds spent buffering per buffering event.
884
+ * Helps distinguish many short buffering events from fewer long ones.
885
+ */
886
+ timePerBufferingEvent: number;
855
887
  }
856
888
  interface SyncModuleStatistics {
857
889
  drift: number | undefined;
858
890
  seekAdjustmentCount: number;
859
891
  timeshiftAdjustmentCount: number;
860
892
  seekTime: number;
893
+ /**
894
+ * Total time spent seeking in milliseconds for the entire session.
895
+ * High values indicate frequent or slow seeks, which may impact user experience.
896
+ */
897
+ totalSeekTime: number;
861
898
  seekToleranceMultiplier: number;
862
899
  currentSeekToleranceMs: number;
863
900
  currentAheadToleranceMs: number;
864
901
  isPlaybackRateAdjustmentEnabled: boolean;
865
902
  playbackRate: number;
866
903
  playbackRateAdjustmentCount: number;
904
+ /**
905
+ * Average absolute drift in milliseconds over a rolling window.
906
+ * Measures how far off sync the playback typically is, regardless of direction.
907
+ */
908
+ averageDrift: number;
867
909
  }
868
910
  interface VideoPlayerStatistics {
869
911
  renderedFrameCount: number;
@@ -957,6 +999,22 @@ export type Statistics = ModuleStatistics & ReturnType<UserAgentInformation["get
957
999
  * Average bitrate for the entire session in bits/second.
958
1000
  */
959
1001
  averageBitRate?: number;
1002
+ /**
1003
+ * Number of reconnections per hour of uptime.
1004
+ * Measures connection stability over time. Lower is better.
1005
+ * Excludes the initial connection, so a stable session will have a value of 0.
1006
+ */
1007
+ reconnectsPerHour: number;
1008
+ /**
1009
+ * Number of seek adjustments (seeks to catch up) per minute of active playback.
1010
+ * High values indicate sync issues or network instability.
1011
+ */
1012
+ seekAdjustmentsPerMinute: number;
1013
+ /**
1014
+ * Number of timeshift adjustments per minute of active playback.
1015
+ * Relevant for timeshift-enabled streams.
1016
+ */
1017
+ timeshiftAdjustmentsPerMinute: number;
960
1018
  };
961
1019
  /**
962
1020
  * Represents a Vindral client instance
@@ -1439,7 +1497,12 @@ interface ConnectionStatistics {
1439
1497
  * Total number of connection attempts since instantiation.
1440
1498
  */
1441
1499
  connectionAttemptCount: number;
1442
- connectionProtocol: "vindral_ws" | "moq" | undefined;
1500
+ /**
1501
+ * Ratio of successful connections to total connection attempts (0-1).
1502
+ * A value of 1.0 means every connection attempt succeeded.
1503
+ */
1504
+ connectionSuccessRatio: number;
1505
+ connectionProtocol: "vindral_ws" | "moq" | "moq_ws" | undefined;
1443
1506
  }
1444
1507
  /**
1445
1508
  * Contextual information about the language switch
package/core.js CHANGED
@@ -1,4 +1,4 @@
1
- import { c as C, e as I, f as _, a as O, C as D, D as T, I as a, N as A, V as s, g as r } from "./CQiPSKHx.js";
1
+ import { c as C, e as I, f as _, a as O, C as D, D as T, I as a, N as A, V as s, g as r } from "./_9pZeC_n.js";
2
2
  export {
3
3
  C as AUTHENTICATION_EXPIRED_CODE,
4
4
  I as AUTHENTICATION_FAILED_CODE,