@vkontakte/videoplayer-core 2.0.171 → 2.0.172-beta.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.171",
+  "version": "2.0.172-beta.1",
   "author": "vk.ru",
   "description": "Videoplayer core library based on the vk.ru platform",
   "homepage": "https://vk.ru",
@@ -42,6 +42,6 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "1.0.100"
+    "@vkontakte/videoplayer-shared": "1.0.101-beta.3"
   }
 }

package/types/player/Player.d.ts

@@ -1,5 +1,5 @@
 import type { IOptionalTuningConfig } from "../utils/tuningConfig";
-import type { ILogEntry, ITracer, QualityLimits, Seconds, VideoQuality } from "@vkontakte/videoplayer-shared";
+import type { ILogEntry, ITracer, QualityLimits, Seconds, VideoQuality, DebugData } from "@vkontakte/videoplayer-shared";
 import { type IAudioStream, type IConfig, type ICueSettings, type IExternalTextTrack, type IPlayer, type ITextTrack, type IVideoStream, type PlaybackRate, type PlayerEventsImpl, type PlayerExperimentalImpl, type PlayerInfoImpl, PredefinedQualityLimits } from "./types";
 import type { IPlayerOptions } from "../utils/playerOptions";
 export default class Player implements IPlayer {
@@ -30,6 +30,7 @@ export default class Player implements IPlayer {
 	experimental: PlayerExperimentalImpl;
 	private devNullLog;
 	private collectDecodingInfoDestroyCb;
+	private hasReleasedTimers;
 	constructor(tuning?: IOptionalTuningConfig, tracer?: ITracer, playerOptions?: IPlayerOptions);
 	private readonly doInit;
 	/**
@@ -77,7 +78,10 @@ export default class Player implements IPlayer {
 	getExactTime(): Seconds;
 	getExactLiveTime(): Seconds;
 	getAllLogs(): ILogEntry[];
+	getDebugData(): DebugData;
+	private buildDebugData;
 	private setIntrinsicVideoSize;
+	private initDebugDataSubscriptions;
 	private initDesiredStateSubscriptions;
 	private initProviderContainerSubscription;
 	private initChromecastSubscription;

package/types/player/types.d.ts

@@ -1,4 +1,4 @@
-import type { IError, ILogEntry, IObservable, IRectangle, IValueObservable, IValueSubject, Kbps, Milliseconds, QualityLimits, Seconds, Subject, ValueSubject, VideoQuality } from "@vkontakte/videoplayer-shared";
+import type { DebugData, IError, ILogEntry, IObservable, IRectangle, IValueObservable, IValueSubject, Kbps, Milliseconds, QualityLimits, Seconds, Subject, ValueSubject, VideoQuality } from "@vkontakte/videoplayer-shared";
 import type { dump } from "../utils/playbackTelemetry";
 export interface StartEnd<Unit extends number> {
 	start: Unit;
@@ -311,17 +311,33 @@ export interface PlayerInfoValues {
 	*/
 	currentPlaybackRate$: PlaybackRate;
 	/**
-	* Текущий буффер плеера (тот; который содержит текущую позицию воспроизведения)
+	* Текущий видео буффер-плеера (тот; который содержит текущую позицию воспроизведения)
 	*
 	* default value: `undefined`
 	*/
-	currentBuffer$: StartEnd<Seconds> | undefined;
+	currentVideoBuffer$: StartEnd<Seconds> | undefined;
 	/**
-	* Текущий браузерный буффер (тот; который содержит текущую позицию воспроизведения)
+	* Текущий аудио-буффер плеера (тот; который содержит текущую позицию воспроизведения)
 	*
 	* default value: `undefined`
 	*/
-	currentNativeBuffer$: StartEnd<Seconds> | undefined;
+	currentAudioBuffer$: StartEnd<Seconds> | undefined;
+	/**
+	* Текущий браузерный видео-буффер (тот; который содержит текущую позицию воспроизведения)
+	*
+	* default value: `undefined`
+	*/
+	currentNativeVideoBuffer$: StartEnd<Seconds> | undefined;
+	/**
+	* Текущий браузерный аудио-буффер (тот; который содержит текущую позицию воспроизведения)
+	*
+	* Семантика: для большинства провайдеров источник один — HTMLMediaElement, у которого `buffered` общий на audio- и video-данные
+	* (по спеке HTML audio data = mix всех enabled audio tracks, video data = currently selected video track — https://html.spec.whatwg.org/multipage/media.html#media-resource).
+	* В таких случаях значение совпадает с `currentNativeVideoBuffer$`.
+	*
+	* default value: `undefined`
+	*/
+	currentNativeAudioBuffer$: StartEnd<Seconds> | undefined;
 	/** Суммарная длительность всех буферизованных диапазонов в миллисекундах */
 	totalBufferDuration$: Milliseconds | undefined;
 	/**
@@ -456,6 +472,10 @@ export interface PlayerInfoValues {
 	* Длина аудио сегмента
 	*/
 	currentAudioSegmentLength$: number;
+	/**
+	* Отладочная информация
+	*/
+	debugData$: DebugData;
 }
 export type IPlayerInfo = { [K in keyof PlayerInfoValues]: IValueObservable<PlayerInfoValues[K]> };
 export type PlayerInfoImpl = { [K in keyof PlayerInfoValues]: ValueSubject<PlayerInfoValues[K]> };

package/types/providers/DashLiveProvider/utils/LiveDashPlayer.d.ts

@@ -49,6 +49,9 @@ export default class LiveDashPlayer {
 	private bufferStates;
 	private downloadRate?;
 	private sourceJitter;
+	private srcToken;
+	private videoListeners;
+	private objectUrl;
 	private chunkRateEstimator;
 	private manifestUrl;
 	private urlResolver;

package/types/providers/DashProvider/baseDashProvider.d.ts

@@ -3,8 +3,7 @@ import type { IProviderSubscriptionInfo } from "./lib/types";
 import { ProviderState } from "./lib/types";
 import type { Representation, Stream } from "../utils/parsers/types";
 import type { IProvider, IProviderAllocationResolution, IProviderParams } from "../types";
-import type { IObservableVideo } from "../utils/HTMLVideoElement/observable";
-import { TrackHistory } from "../../utils/autoSelectTrack";
+import type { IObservableMediaElement } from "../utils/HTMLVideoElement/observable";
 import type { IStateMachine } from "../../utils/StateMachine/types";
 import type { ExactVideoQuality, ISubscription, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import { Player } from "./lib/player";
@@ -16,7 +15,6 @@ import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
-	failedVideoTrack?: Nullable<IVideoTrack>;
 	isOnDemand?: boolean;
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
 };
@@ -25,7 +23,7 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected volumeSubscription: ISubscription;
 	protected videoState: IStateMachine<ProviderState>;
 	protected readonly allocation: IProviderAllocationResolution;
-	protected observableVideo: IObservableVideo | null;
+	protected observableVideo: IObservableMediaElement | null;
 	protected player: Player;
 	protected params: IParams;
 	protected tracer: ITracer;
@@ -34,7 +32,6 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected stallsManager: StallsManager;
 	protected elementSizeManager: ElementSizeManager;
 	protected abrManager: AbrManager;
-	protected failedVideoTrack: Nullable<IVideoTrack>;
 	protected videoTracksMap: Map<IVideoTrack, {
 		stream: Stream;
 		representation: Representation;
@@ -49,16 +46,13 @@ export default abstract class BaseDashProvider implements IProvider {
 	}>;
 	protected videoStreamsMap: Map<Stream, IVideoTrack[]>;
 	protected audioStreamsMap: Map<Stream, IAudioTrack[]>;
-	protected videoTrackSwitchHistory: TrackHistory<IVideoTrack>;
-	protected audioTrackSwitchHistory: TrackHistory<IAudioTrack>;
 	constructor(params: IParams);
 	protected abstract seek(position: Milliseconds, forcePrecise: boolean): void;
 	protected getProviderSubscriptionInfo(): IProviderSubscriptionInfo;
 	protected subscribe(): void;
 	private syncBufferTarget;
-	private resolveAudioBufferTargetMs;
 	private resolveBufferTargetMs;
-	private getCurrentVideoBitrateKbps;
+	private resolveAudioBufferTargetMs;
 	protected selectVideoAudioRepresentations(): [Representation, Representation | undefined] | undefined;
 	protected prepare(manifestOffset?: number): void;
 	protected syncPlayback: () => void;

package/types/providers/DashProvider/lib/buffer.d.ts

@@ -1,5 +1,5 @@
 import type { ITuningConfig } from "../../../utils/tuningConfig";
-import type { IError, IRange, ISubject, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { IError, IRange, ISubject, ITracer, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
 import { abortable } from "@vkontakte/videoplayer-shared";
 import type { Fetcher } from "./fetcher";
 import type { CommonInit, Manifest, Representation, Segment, Stream, StreamKind } from "../../utils/parsers/types";
@@ -11,6 +11,7 @@ export interface Dependencies {
 	isActiveLowLatency: () => boolean;
 	compatibilityMode?: boolean;
 	manifest: Manifest | null;
+	tracer: ITracer;
 }
 export interface Gap extends IRange<Milliseconds> {
 	representation: Representation["id"];
@@ -67,6 +68,7 @@ export declare class BufferManager {
 	private baseUrlsIndex;
 	private compatibilityMode;
 	private preloadOnly;
+	private tracer;
 	private isLive;
 	private liveUpdateSegmentIndex;
 	private liveInitialAdditionalOffset;
@@ -75,7 +77,8 @@ export declare class BufferManager {
 	private lastDataObtainedTimestampMs;
 	private loadByteRangeSegmentsTimeoutId;
 	private preDownloadedFirstSegment;
-	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, isActiveLowLatency, compatibilityMode, manifest }: Dependencies);
+	private brokenSegmentAppendDetected;
+	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, isActiveLowLatency, compatibilityMode, manifest, tracer }: Dependencies);
 	startWith: ReturnType<typeof abortable<[Representation["id"]]>>;
 	switchToWithPreviousAbort(newRepresentationId: Representation["id"], dropBuffer?: boolean): Promise<void | undefined>;
 	switchTo: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
@@ -119,6 +122,7 @@ export declare class BufferManager {
 	*/
 	private onSomeByteRangesDataLoaded;
 	private onSegmentFullyAppended;
+	private detectBrokenSegmentAppend;
 	private abortSegment;
 	private loadNextInit;
 	private loadInit;

package/types/providers/DashProvider/lib/player.d.ts

@@ -83,6 +83,7 @@ export declare class Player {
 	private gapWatchdogActive;
 	private gapWatchdogSubscription;
 	private stallWatchdogSubscription;
+	private stallTracer;
 	private livePauseWatchdogSubscription;
 	private liveWasInterrupted;
 	private isOnDemand;

package/types/providers/DashProvider/lib/sourceBufferTaskQueue.d.ts

@@ -7,8 +7,7 @@ declare class SourceBufferTaskQueue {
 	private currentTask;
 	private destroyed;
 	private abortRequested;
-	private isAbortFixEnabled;
-	constructor(buffer: SourceBuffer, isAbortFixEnabled?: boolean);
+	constructor(buffer: SourceBuffer);
 	append(data: BufferSource, signal?: AbortSignal): Promise<boolean>;
 	remove(from: Milliseconds, to: Milliseconds, signal?: AbortSignal): Promise<boolean>;
 	abort(init?: BufferSource): Promise<boolean>;

package/types/providers/DashProvider/lib/types.d.ts

@@ -1,6 +1,6 @@
 import type { IObservable, ISubject, IValueSubject } from "@vkontakte/videoplayer-shared";
 import type { IDesiredState, IProviderOutput, IProviderParams } from "../../types";
-import type { IObservableVideo } from "../../utils/HTMLVideoElement/observable";
+import type { IObservableMediaElement } from "../../utils/HTMLVideoElement/observable";
 import type { IDashURLSource } from "../../../player/types";
 export declare enum LiveStatus {
 	ActiveLowLatency = "active_low_latency",
@@ -16,7 +16,7 @@ export declare enum LiveStreamStatus {
 export interface IProviderSubscriptionInfo {
 	output: IProviderOutput;
 	desiredState: IDesiredState;
-	observableVideo: IObservableVideo;
+	observableVideo: IObservableMediaElement;
 	genericErrorListener: (error: Error | unknown) => void;
 	connect: <Value>(from: IObservable<Value>, to: ISubject<Value> | IValueSubject<Value> | ((v: Value) => void)) => void;
 }

package/types/providers/DashProviderVirtual/baseDashProvider.d.ts

@@ -1,10 +1,9 @@
-import type { IAudioTrack, IBaseTrack, IDashURLSource, IHLSSource, IInternalTextTrack, IVideoTrack, VideoCodec } from "../../player/types";
+import type { IAudioTrack, IDashURLSource, IHLSSource, IInternalTextTrack, IVideoTrack, VideoCodec } from "../../player/types";
 import type { IProviderSubscriptionInfo } from "./lib/types";
 import { ProviderState } from "./lib/types";
 import type { Representation, Stream } from "../utils/parsers/types";
 import type { IProvider, IProviderAllocationResolution, IProviderParams } from "../types";
-import type { IObservableVideo } from "../utils/HTMLVideoElement/observable";
-import { TrackHistory } from "../../utils/autoSelectTrack";
+import type { IObservableMediaElement } from "../utils/HTMLVideoElement/observable";
 import type { IStateMachine } from "../../utils/StateMachine/types";
 import type { ExactVideoQuality, ISubscription, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import DroppedFramesManager from "../utils/HTMLVideoElement/DroppedFramesManager";
@@ -16,7 +15,6 @@ import { AbrManager } from "../utils/Abr/abrManager";
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
-	failedVideoTrack?: Nullable<IVideoTrack>;
 	isOnDemand?: boolean;
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
 };
@@ -25,7 +23,7 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected volumeSubscription: ISubscription;
 	protected videoState: IStateMachine<ProviderState>;
 	protected readonly allocation: IProviderAllocationResolution;
-	protected observableVideo: IObservableVideo | null;
+	protected observableVideo: IObservableMediaElement | null;
 	protected player: BasePlayer;
 	protected params: IParams;
 	protected tracer: ITracer;
@@ -48,17 +46,14 @@ export default abstract class BaseDashProvider implements IProvider {
 	}>;
 	protected videoStreamsMap: Map<Stream, IVideoTrack[]>;
 	protected audioStreamsMap: Map<Stream, IAudioTrack[]>;
-	protected videoTrackSwitchHistory: TrackHistory<IVideoTrack>;
-	protected audioTrackSwitchHistory: TrackHistory<IBaseTrack>;
 	constructor(params: IParams);
 	protected abstract seek(position: Milliseconds, forcePrecise: boolean): void;
 	protected abstract getPlayer(): BasePlayer;
 	protected getProviderSubscriptionInfo(): IProviderSubscriptionInfo;
 	protected subscribe(): void;
 	private syncBufferTarget;
-	private resolveAudioBufferTargetMs;
 	private resolveBufferTargetMs;
-	private getCurrentVideoBitrateKbps;
+	private resolveAudioBufferTargetMs;
 	protected selectVideoAudioRepresentations(): [Representation, Representation | undefined] | undefined;
 	protected prepare(manifestOffset?: number): void;
 	protected syncPlayback: () => void;

package/types/providers/DashProviderVirtual/lib/buffer/nativeBufferManager.d.ts

@@ -1,13 +1,15 @@
 import type { IError, IRange, ISubject, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { ITuningConfig } from "../../../../utils/tuningConfig";
 export declare class NativeBufferManager {
 	error$: ISubject<IError>;
 	updateEnd$: IValueSubject<void>;
 	private mediaSource;
 	private sourceBuffer;
 	private sourceBufferTaskQueue;
+	private readonly tuning;
 	private subscription;
-	constructor(mediaSource: MediaSource);
-	init(mime: string, codecs: string, useAbortMSEFix?: boolean): void;
+	constructor(mediaSource: MediaSource, tuning: ITuningConfig);
+	init(mime: string, codecs: string): void;
 	addInitSegment(initView: BufferSource, signal?: AbortSignal): Promise<boolean>;
 	append(segmentView: BufferSource, signal?: AbortSignal): Promise<boolean>;
 	remove(from: Milliseconds, to: Milliseconds, signal?: AbortSignal): Promise<boolean>;

package/types/providers/DashProviderVirtual/lib/buffer/sourceBufferTaskQueue.d.ts

@@ -1,4 +1,5 @@
 import type { Byte, IError, ISubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { ITuningConfig } from "../../../../utils/tuningConfig";
 declare class SourceBufferTaskQueue {
 	bufferFull$: ISubject<Byte>;
 	error$: ISubject<IError>;
@@ -7,8 +8,8 @@ declare class SourceBufferTaskQueue {
 	private currentTask;
 	private destroyed;
 	private abortRequested;
-	private isAbortFixEnabled;
-	constructor(buffer: SourceBuffer, isAbortFixEnabled?: boolean);
+	private readonly tuning;
+	constructor(buffer: SourceBuffer, tuning: ITuningConfig);
 	append(data: BufferSource, signal?: AbortSignal): Promise<boolean>;
 	remove(from: Milliseconds, to: Milliseconds, signal?: AbortSignal): Promise<boolean>;
 	abort(init?: BufferSource): Promise<boolean>;

package/types/providers/DashProviderVirtual/lib/buffer/virtualBuffer/baseVirtualBufferManager.versionA.d.ts

@@ -52,6 +52,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected subscription: Subscription;
 	protected readonly getCurrentPosition: () => Milliseconds | undefined;
 	protected readonly getCurrentStallDuration: () => Milliseconds | undefined;
+	protected brokenSegmentAppendDetected: boolean;
 	protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tracer, tuning, getCurrentPosition, getCurrentStallDuration, manifest }: Dependencies);
 	protected abstract loadItems(itemsToLoad: IBufferPlaybackQueueItem<T>[], representation: Representation, priority?: Priority): Promise<void>;
 	protected abstract selectItemsToLoad(): IBufferPlaybackQueueItem<T>[];
@@ -96,7 +97,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	*/
 	protected sanitizeBufferPlaybackQueue(): boolean;
 	protected forceSwitchCondition(oldRepresentation: Representation, newRepresentation: Representation): boolean;
-	protected clearBuffer(): Promise<void>;
+	protected clearBuffer(signal?: AbortSignal): Promise<void>;
 	private resetBuffer;
 	protected abortDownload(): void;
 	protected abortDownloadingItems(): void;
@@ -120,6 +121,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected parseFeedableSegmentChunk(chunk: DataView): DataView | null;
 	protected onItemFullyDownloaded(downloadedItem: IBufferPlaybackQueueItem<T>): void;
 	protected onItemFullyAppended(appendedItem: IBufferPlaybackQueueItem<T>): void;
+	private detectBrokenSegmentAppend;
 	protected removeSegment(nextRemoveItem: IBufferPlaybackQueueItem<T>, signal: AbortSignal): Promise<void>;
 	protected onDownloadItem(downloadedItem: IBufferPlaybackQueueItem<T>): void;
 	protected pruneVirtualBuffer(currentPosition: Milliseconds): void;

package/types/providers/DashProviderVirtual/lib/player/basePlayer.d.ts

@@ -63,9 +63,11 @@ export declare abstract class BasePlayer {
 	liveSeekableDuration$: IValueSubject<Milliseconds>;
 	liveAvailabilityStartTime$: IValueSubject<Milliseconds>;
 	liveStreamStatus$: IValueSubject<LiveStreamStatus | undefined>;
-	currentBuffer$: IValueSubject<IRange<Seconds>>;
+	currentVideoBuffer$: IValueSubject<IRange<Seconds>>;
+	currentAudioBuffer$: IValueSubject<IRange<Seconds>>;
 	bufferLength$: IValueSubject<Milliseconds>;
 	nativeBufferLength$: IValueSubject<Milliseconds>;
+	nativeAudioBufferLength$: IValueSubject<IRange<Seconds>>;
 	liveLatency$: IValueSubject<Milliseconds | undefined>;
 	liveLoadBufferLength$: IValueSubject<Milliseconds>;
 	livePositionFromPlayer$: IValueSubject<number>;

package/types/providers/DashProviderVirtual/lib/types.d.ts

@@ -1,6 +1,6 @@
 import type { IObservable, ISubject, IValueSubject } from "@vkontakte/videoplayer-shared";
 import type { IDesiredState, IProviderOutput, IProviderParams } from "../../types";
-import type { IObservableVideo } from "../../utils/HTMLVideoElement/observable";
+import type { IObservableMediaElement } from "../../utils/HTMLVideoElement/observable";
 import type { IDashURLSource } from "../../../player/types";
 export declare enum LiveStatus {
 	ActiveLowLatency = "active_low_latency",
@@ -16,7 +16,7 @@ export declare enum LiveStreamStatus {
 export interface IProviderSubscriptionInfo {
 	output: IProviderOutput;
 	desiredState: IDesiredState;
-	observableVideo: IObservableVideo;
+	observableVideo: IObservableMediaElement;
 	genericErrorListener: (error: Error | unknown) => void;
 	connect: <Value>(from: IObservable<Value>, to: ISubject<Value> | IValueSubject<Value> | ((v: Value) => void)) => void;
 }

package/types/providers/ProviderContainer/Mayday/GraceTimeout.d.ts

@@ -0,0 +1,17 @@
+import type { Milliseconds } from "@vkontakte/videoplayer-shared";
+/**
+* Декрементный grace-таймаут: каждый вызов `decay()` уменьшает оставшееся время.
+*
+* После создания `current` возвращает начальное значение.
+* Каждый вызов `decay()` умножает `remaining` на `decayFactor`, но не меньше `minTimeout`.
+* Когда `remaining` достигает `minTimeout` — следующий `decay()` возвращает 0 (expire).
+*/
+export declare class GraceTimeout {
+	private remaining;
+	private readonly decayFactor;
+	private readonly minTimeout;
+	constructor(initialTimeout: Milliseconds, decayFactor: number, minTimeout: Milliseconds);
+	get current(): Milliseconds;
+	decay(): Milliseconds;
+	reset(initialTimeout: Milliseconds): void;
+}

package/types/providers/ProviderContainer/Mayday/heuristics/SegmentAppendHeuristic.d.ts

@@ -0,0 +1,10 @@
+import type { IError } from "@vkontakte/videoplayer-shared";
+import type { IHeuristicDeps } from "../types";
+import type { ISyncHeuristic, HeuristicResult } from "./IHeuristic";
+export declare class SegmentAppendHeuristic implements ISyncHeuristic {
+	private deps;
+	static readonly heuristicName = "SegmentAppendHeuristic";
+	readonly type = "sync";
+	constructor(deps: IHeuristicDeps);
+	analyze(error: IError): HeuristicResult;
+}

package/types/providers/ProviderContainer/Mayday/heuristics/StartupHangupHeuristic.d.ts

@@ -0,0 +1,46 @@
+import { Subject } from "@vkontakte/videoplayer-shared";
+import type { IError } from "@vkontakte/videoplayer-shared";
+import type { IHeuristicDeps, IMaydayEvent } from "../types";
+import type { IAsyncHeuristic, HeuristicResult } from "./IHeuristic";
+/**
+* Эвристика зависания перехода stopped-*.
+*
+* В зависимости от видимости вкладки и наличия звука выбирает стратегию
+* и эмитит одну из рекомендаций:
+*
+* Visible-вкладка: grace-таймаут с уменьшением таймаута на поступление данных.
+*   — данные поступают → таймер продлевается.
+*   — grace истёк без прогресса → emit switch_codec (или switch_provider).
+*
+* Hidden-вкладка (audible): та же grace-модель с таймаутом (таймеры в воркере не тротлятся).
+*   — данные поступают → таймер продлевается.
+*   — grace истёк без прогресса → emit switch_codec.
+*
+* Hidden-вкладка (muted/deferred): молча ждём возврата на visible, desired state не трогаем.
+*   — вкладка стала visible → emit reinit (полный реинит сам восстановит воспроизведение).
+*   — переход всё-таки завершился в фоне (видео заиграло) → отмена, reinit не нужен.
+*/
+export declare class StartupHangupHeuristic implements IAsyncHeuristic {
+	private deps;
+	static readonly heuristicName = "StartupHangupHeuristic";
+	readonly type = "async";
+	readonly recommendation$: Subject<IMaydayEvent>;
+	private timerId;
+	private subscription;
+	private error;
+	private grace;
+	private hangupStartedAt;
+	private dataArrivals;
+	private hiddenWaitActive;
+	constructor(deps: IHeuristicDeps);
+	analyze(error: IError): HeuristicResult;
+	private startMonitoring;
+	private waitForVisible;
+	private restartTimer;
+	private recommendSwitch;
+	private isTabHidden;
+	private logOutcome;
+	private cancel;
+	reset(): void;
+	destroy(): void;
+}

package/types/providers/ProviderContainer/Mayday/heuristics/TvFetcherErrorHeuristic.d.ts

@@ -0,0 +1,10 @@
+import type { IError } from "@vkontakte/videoplayer-shared";
+import type { IHeuristicDeps } from "../types";
+import type { ISyncHeuristic, HeuristicResult } from "./IHeuristic";
+export declare class TvFetcherErrorHeuristic implements ISyncHeuristic {
+	private _deps;
+	static readonly heuristicName = "TvFetcherErrorHeuristic";
+	readonly type = "sync";
+	constructor(_deps: IHeuristicDeps);
+	analyze(error: IError): HeuristicResult;
+}

package/types/providers/ProviderContainer/Mayday/index.d.ts

@@ -3,5 +3,6 @@ export type { IMaydayDeps, IFallbackContext, IRecommendation, RecoveryAction, IM
 export type { ISyncHeuristic, IAsyncHeuristic, HeuristicResult } from "./heuristics/IHeuristic";
 export { MediaErrorHeuristic } from "./heuristics/MediaErrorHeuristic";
 export { FetcherErrorHeuristic } from "./heuristics/FetcherErrorHeuristic";
-export { HangupHeuristic } from "./heuristics/HangupHeuristic";
+export { TvFetcherErrorHeuristic } from "./heuristics/TvFetcherErrorHeuristic";
+export { StartupHangupHeuristic } from "./heuristics/StartupHangupHeuristic";
 export { MaydayStatistics } from "./MaydayStatistics";

package/types/providers/ProviderContainer/Mayday/types.d.ts

@@ -14,7 +14,7 @@ export interface IMaydayProviderOutput {
 	position$: IValueSubject<number>;
 	currentVideoTrack$: IValueSubject<IVideoTrack | undefined>;
 	totalBufferDuration$: IValueSubject<Milliseconds | undefined>;
-	currentNativeBuffer$: IValueSubject<IRange<Seconds> | undefined>;
+	currentNativeVideoBuffer$: IValueSubject<IRange<Seconds> | undefined>;
 	bufferRangeCount$: IValueSubject<number | undefined>;
 	availableVideoStreams$: IValueSubject<IVideoStream[]>;
 	currentAudioStream$: IValueSubject<IAudioStream | undefined>;
@@ -54,6 +54,7 @@ export interface IHeuristicDeps {
 	getVisibilityState: () => DocumentVisibilityState | undefined;
 	getReadyState: () => number | undefined;
 	getVideoPaused: () => boolean | undefined;
+	getIsMuted: () => boolean;
 	currentNativeBuffer$: IValueSubject<IRange<Seconds> | undefined>;
 	videoLastDataObtainedTimestamp$: IValueSubject<Milliseconds | undefined>;
 	desiredPlaybackState$: IStateMachine<PlaybackState>;

package/types/providers/ProviderContainer/index.d.ts

@@ -35,7 +35,6 @@ export default class ProviderContainer implements IProviderContainer {
 	private tracer;
 	private params;
 	private currentProviderStarted;
-	private currentFailedVideoTrack;
 	private volumeMultiplierManager;
 	private dashMaxTvVideoQuality;
 	private mayday;

package/types/providers/ProviderContainer/utils/formatsSupport.d.ts

@@ -15,7 +15,6 @@ type LiveFormat = VideoFormat.WEB_RTC_LIVE | VideoFormat.HLS_LIVE | VideoFormat.
 type AllLiveFormats = [LiveFormat, LiveFormat, LiveFormat, LiveFormat, LiveFormat];
 export declare const getLiveFormatsPriority: ({ androidPreferredFormat, preferCMAF, preferWebRTC }: Constraints) => AllLiveFormats;
 export declare const getChromeCastFormatsPriority: (live: boolean) => VideoFormat[];
-export declare const selectCodec: (codecs: Set<string>) => string | undefined;
 type CodecStream = {
 	codecs: string;
 	hdr?: boolean;

package/types/providers/ProviderContainer/utils/playbackHangup.d.ts

@@ -1,6 +1,5 @@
 import type { IProviderEntry } from "../types";
 import type { IObservable, Milliseconds } from "@vkontakte/videoplayer-shared";
-import { Observable } from "@vkontakte/videoplayer-shared";
 import type { IStateMachine } from "../../../utils/StateMachine/types";
 import { PlaybackState } from "../../../player/types";
 interface IParams {
@@ -12,5 +11,10 @@ interface IParams {
 	playbackHangupNoDataThreshold: Milliseconds;
 	useDelayedPlaybackHangupWithData: boolean;
 }
-declare const _default: (params: IParams) => Observable<string>;
+export interface IPlaybackHangupInfo {
+	from: PlaybackState;
+	to: PlaybackState;
+	label: string;
+}
+declare const _default: (params: IParams) => IObservable<IPlaybackHangupInfo>;
 export default _default;

package/types/providers/types.d.ts

@@ -81,8 +81,10 @@ export interface IProviderOutput {
 	autoVideoTrackLimits$: IValueSubject<QualityLimits | undefined>;
 	autoVideoTrackLimitingAvailable$: IValueSubject<boolean>;
 	canChangePlaybackSpeed$: IValueSubject<boolean | undefined>;
-	currentBuffer$: IValueSubject<IRange<Seconds> | undefined>;
-	currentNativeBuffer$: IValueSubject<IRange<Seconds> | undefined>;
+	currentVideoBuffer$: IValueSubject<IRange<Seconds> | undefined>;
+	currentAudioBuffer$: IValueSubject<IRange<Seconds> | undefined>;
+	currentNativeVideoBuffer$: IValueSubject<IRange<Seconds> | undefined>;
+	currentNativeAudioBuffer$: IValueSubject<IRange<Seconds> | undefined>;
 	totalBufferDuration$: IValueSubject<Milliseconds | undefined>;
 	bufferRangeCount$: IValueSubject<number | undefined>;
 	videoLastDataObtainedTimestamp$: IValueSubject<Milliseconds | undefined>;

package/types/providers/utils/Abr/abrController.d.ts

@@ -1,5 +1,6 @@
-import type { IAbrController, IAbrRule, IBaseAbrControllerContext, IRuleInitContext } from "./types";
+import type { IAbrController, IAbrRule, IBaseAbrControllerContext, IRuleInitContext, RuleLogData } from "./types";
 import type { IBaseTrack } from "../../../player/types";
+export declare const formatRuleLog: ({ name, ...logData }: RuleLogData) => string;
 export default class AbrController<
 	T extends IBaseTrack,
 	C extends IBaseAbrControllerContext
@@ -12,6 +13,8 @@ export default class AbrController<
 	destroy(): void;
 	updateContext(context: C): void;
 	autoSelectTrack(rules?: IAbrRule<T, C>[]): T;
+	private traceQualitySwitch;
+	private isLowQuality;
 	private selectTrackBasedOnHistory;
 	/** при переключении аудио стрима очищаем историю для предотвращения залипания в `onCooldown` */
 	historyReset(): void;

package/types/providers/utils/Abr/abrManager.d.ts

@@ -7,11 +7,14 @@ export declare class AbrManager {
 	private audioAbrController;
 	private subscription;
 	private lastVideoTrackSelected$;
+	private lastAudioTrackSelected$;
 	private context;
 	private phaseController;
 	private allVideoRules;
+	private tracer;
 	init(context: IInitAbrManagerContext): void;
 	updateContext(updateContext: IUpdatableAbrManagerContext): void;
+	private getAudioReserve;
 	autoSelectTrack<T extends IVideoTrack | IAudioTrack>(kind: Exclude<StreamKind, StreamKind.TEXT>): T;
 	destroy(): void;
 	private initVideoElementAbrContext;

package/types/providers/utils/Abr/controllers/stallsController.d.ts

@@ -1,15 +1,16 @@
-import type { IObservable, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { IObservable, ITracer, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
 import type { ITuningConfig } from "../../../../utils/tuningConfig";
 import type { IVideoTrack } from "../../../../player/types";
-import type { IObservableVideo } from "../../HTMLVideoElement/observable";
+import type { IObservableMediaElement } from "../../HTMLVideoElement/observable";
 interface IConnectData {
 	videoLastDataObtainedTimestamp$: IValueSubject<Milliseconds>;
 	lastVideoTrackSelected$: IValueSubject<IVideoTrack | undefined>;
 	rtt$: IValueSubject<Milliseconds>;
 	isSeeked$: IObservable<boolean>;
-	observableVideo: IObservableVideo;
+	observableVideo: IObservableMediaElement;
 	currentStallDuration$: IValueSubject<Milliseconds>;
 	tuning: ITuningConfig["stallsManager"];
+	tracer: ITracer;
 }
 export declare class StallsController {
 	private currentStallDuration$;
@@ -20,6 +21,9 @@ export declare class StallsController {
 	private lastUniqueVideoTrackSelectedTimestamp;
 	private lastUniqueVideoTrackSelected;
 	private providerStartWatchingTimestamp;
+	private tracer;
+	private severeStallTracer;
+	private severeStallStartedAt;
 	private subscription;
 	severeStallOccurred$: IValueSubject<boolean>;
 	totalStallsCount$: IValueSubject<number>;
@@ -28,6 +32,9 @@ export declare class StallsController {
 	lastStallDuration$: IValueSubject<Milliseconds>;
 	init(data: IConnectData): void;
 	destroy(): void;
+	private startSevereStallTracer;
+	private endSevereStallTracer;
+	private traceUpdateStallData;
 	private updateStallData;
 }
 export {};