@vindral/web-sdk 4.4.0 → 4.5.0-7-gbf689372

package/legacy.d.ts

@@ -1007,6 +1007,24 @@ interface SyncModuleStatistics {
 	 * Measures how far off sync the playback typically is, regardless of direction.
 	 */
 	averageDrift: number;
+	/**
+	 * Whether the video stream **currently arriving** presents frames out of decode order. Reported
+	 * from SyncModule rather than the playback modules because it sits upstream of both on every ingest
+	 * route, so one detector covers MSE and WebCodecs alike and the readout comes from the same
+	 * observation that gates timeshift.
+	 *
+	 * Not the same as *whether timeshift is currently suppressed* — stated as a rule rather than a list
+	 * of cases, because an earlier version of this comment enumerated them and was incomplete. This is
+	 * {@link BFrameTracker}'s state, which clears whenever the stream identity changes (rendition or
+	 * channel) or {@link reset} runs; the gate above it is a session-sticky latch that never clears. Any
+	 * of those therefore leaves this false — until the detector re-latches a fragment or two later —
+	 * while timeshift stays suppressed.
+	 *
+	 * Both scopes are deliberate: this answers "does the stream in front of us reorder", which is what
+	 * is useful when watching a ladder, and the gate needs the opposite bias. Do not read either as the
+	 * other.
+	 */
+	videoHasBFrames: boolean;
 }
 interface VideoPlayerStatistics {
 	renderedFrameCount: number;
@@ -1146,6 +1164,12 @@ export declare class Vindral extends Emitter<PublicVindralEvents> {
 	private userAgentInformation;
 	private encryptedMediaExtensions;
 	private sampleProcessingSesssions;
+	/**
+	 * Dedupe the per-fragment diagnostics to once per rendition stretch — one gate per warning, so a
+	 * rendition tripping both reports both. See the warn sites in the moq-data handler.
+	 */
+	private readonly unbackedSamplesWarned;
+	private readonly unextractableSamplesWarned;
 	private sizes;
 	private isSuspended;
 	private disconnectTimeout;