@vkontakte/videoplayer-core 2.0.181-dev.111b83b80.0 → 2.0.181-dev.132333d53.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.181-dev.111b83b80.0",
+  "version": "2.0.181-dev.132333d53.0",
   "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.110-dev.111b83b80.0"
+    "@vkontakte/videoplayer-shared": "1.0.110-dev.132333d53.0"
   }
 }

package/types/index.d.ts

@@ -1,11 +1,13 @@
 import { VERSION } from "./env";
 import type { IMpegSource, IDashSource, IHLSSource, IDashURLSource, IHLSLiveSource, ISeekRequest, URLSource, RawSource, URLSourceWithSeek } from "./player/types";
 import type { VideoCodec } from "./player/types";
+import type { ICoreInstanceData, MlModelResolver } from "./player/types";
 import { VideoFormat, Surface, PredefinedQualityLimits, VideoCodecName } from "./player/types";
 import Player from "./player/Player";
 import type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, ISources, IExternalTextTrack, ITextTrack, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics } from "./player/types";
 import { PlaybackState, ChromecastState, HttpConnectionType } from "./player/types";
 import type { IOptionalTuningConfig } from "./utils/tuningConfig";
+import type { UserHappinessTrigger } from "./utils/userHappinessTriggers";
 export { clientChecker, isMobile } from "./utils/ClientChecker";
 export { areValidLiveRecordSources } from "./utils/videoFormat";
 export { WebmCodecStrategy } from "./enums/WebmCodecStrategy";
@@ -15,5 +17,5 @@ import { Subscription, Observable, Subject, ValueSubject, VideoQuality } from "@
 * @deprecated
 */
 declare const SDK_VERSION: string;
-export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics };
+export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, UserHappinessTrigger, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics, ICoreInstanceData, MlModelResolver };
 export { Player, PlaybackState, ChromecastState, HttpConnectionType, Surface, Subscription, VideoFormat, VideoQuality, Observable, Subject, ValueSubject, VERSION, SDK_VERSION, PredefinedQualityLimits, VideoCodec, VideoCodecName };

package/types/player/Player.d.ts

@@ -26,6 +26,7 @@ export default class Player implements IPlayer {
 	private wasSetStartedQuality;
 	private desiredState;
 	info: PlayerInfoImpl;
+	private userHappinessController;
 	events: PlayerEventsImpl;
 	experimental: PlayerExperimentalImpl;
 	private devNullLog;
@@ -37,6 +38,7 @@ export default class Player implements IPlayer {
 	* Очищает необходимые поля при переключении на другое видео
 	*/
 	private resetDesiredState;
+	private createUserHappinessController;
 	/**
 	* Возвращает плеер в начальное состояние
 	* Позвонялет переиспользовать для другого видео

package/types/player/types.d.ts

@@ -227,7 +227,7 @@ export interface IPlayerEvents {
 	*/
 	fetcherRecoverableError$: IObservable<IError>;
 	/**
-	* Произошел серьезный/долгий стол.
+	* Произошел серьёзный/долгий stall.
 	*/
 	severeStallOccured$: IObservable<boolean>;
 }
@@ -350,7 +350,7 @@ export interface PlayerInfoValues {
 	*/
 	isBuffering$: boolean;
 	/**
-	* Состояние столла. Возникает по истечении stallIgnoreThreshold после старта нежелательной буферизации
+	* Состояние stall. Возникает по истечении stallIgnoreThreshold после старта нежелательной буферизации
 	* Статус только нежелательной буферизации возникает при опустошении буфера в процессе воспроизведения
 	* и не возникает при начальном наполнении буфера или после перемотки
 	*/
@@ -519,7 +519,7 @@ export interface PlayerEventsImpl {
 	fetcherError$: Subject<IError>;
 	severeStallOccured$: Subject<boolean>;
 }
-interface IPlayerExperimental {
+export interface IPlayerExperimental {
 	/**
 	* Элемент, который сейчас вставлен в container.
 	* Может быть видеоэлементом, iframe и вообще чем угодно в общем случае.
@@ -562,6 +562,8 @@ export interface IConfig {
 	* Нужно ли recoverableError обрабатывать как ошибку провайдера или будет снаружи обрабатываться.
 	*/
 	handleNetworkRecoverableErrorAsProviderError?: boolean;
+	/** Инстанс-данные слоёв: сессионный контекст приложения (UVP-12133). */
+	instance?: ICoreInstanceData;
 }
 export interface ISources {
 	[VideoFormat.MPEG]?: IMpegSource;
@@ -661,6 +663,21 @@ export interface IVideoTrack extends IBaseTrack {
 	streamId?: IVideoStream["id"];
 	tvDisabled?: boolean;
 }
+/**
+* Провайдер байтов ML-артефакта. Возвращает расшифрованный бандл или null —
+* null означает «юзер-специфичной модели нет», и фича идёт в гостевом режиме
+* либо деградирует. Общий контракт для будущих ML-фич плеера (UVP-12133).
+*/
+export type MlModelResolver = () => Promise<ArrayBuffer | null>;
+/**
+* Инстанс-данные слоя core: сессионный контекст приложения, передаётся первым
+* параметром initPlayer в адресованной секции `instance.core` — в один ряд с
+* statAuthToken/refreshStatAuthToken, а не в поведенческий sdkConfig.
+*/
+export interface ICoreInstanceData {
+	/** Модель ABR: расшифрованный бандл из account.getModels (приложение) | null → гостевая (UVP-12133). */
+	getAbrMLModel?: MlModelResolver;
+}
 export interface IAudioStream {
 	id: string;
 	language?: string;

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

@@ -11,6 +11,7 @@ import DroppedFramesManager from "../utils/HTMLVideoElement/DroppedFramesManager
 import TextTrackManager from "../utils/TextTrackManager";
 import StallsManager from "../utils/StallsManager";
 import { AbrManager } from "../utils/Abr/abrManager";
+import type { IChunkDownloadHistory } from "../utils/Abr/mlAbr/chunkDownloadHistory";
 import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager";
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
@@ -32,6 +33,8 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected stallsManager: StallsManager;
 	protected elementSizeManager: ElementSizeManager;
 	protected abrManager: AbrManager;
+	/** Один на плеер: оба DASH-провайдера пишут, правило MlAbr читает (UVP-12133). */
+	protected chunkDownloadHistory: IChunkDownloadHistory;
 	protected videoTracksMap: Map<IVideoTrack, {
 		stream: Stream;
 		representation: Representation;

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

@@ -2,8 +2,10 @@ import type { ITuningConfig } from "../../../utils/tuningConfig";
 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";
+import type { CommonInit, Manifest, Representation, Segment, Stream } from "../../utils/parsers/types";
+import { StreamKind } from "../../utils/parsers/types";
 import type { VideoSegmentLoadProgress } from "../../utils/Abr/types";
+import type { IChunkDownloadHistory } from "../../utils/Abr/mlAbr/chunkDownloadHistory";
 export interface Dependencies {
 	fetcher: Fetcher;
 	tuning: ITuningConfig;
@@ -12,6 +14,8 @@ export interface Dependencies {
 	compatibilityMode?: boolean;
 	manifest: Manifest | null;
 	tracer: ITracer;
+	getSeekTargetPosition?: () => Milliseconds | undefined;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 }
 export interface Gap extends IRange<Milliseconds> {
 	representation: Representation["id"];
@@ -38,6 +42,7 @@ export declare class BufferManager {
 	updateEnd$: IValueSubject<void>;
 	private subscription;
 	private kind;
+	private chunkDownloadHistory;
 	private initData;
 	private parsedInitData;
 	private representations;
@@ -56,6 +61,7 @@ export declare class BufferManager {
 	private destroyAbortController;
 	private useSmartRepresentationSwitch;
 	private readonly getCurrentPosition;
+	private readonly getSeekTargetPosition;
 	private readonly isActiveLowLatency;
 	private tuning;
 	private forwardBufferTarget;
@@ -74,13 +80,11 @@ export declare class BufferManager {
 	private liveUpdateSegmentIndex;
 	private liveInitialAdditionalOffset;
 	private isSeekingLive;
-	private isBackwardPruneInFlight;
 	private index;
 	private lastDataObtainedTimestampMs;
 	private loadByteRangeSegmentsTimeoutId;
-	private preDownloadedFirstSegment;
 	private brokenSegmentAppendDetected;
-	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, isActiveLowLatency, compatibilityMode, manifest, tracer }: Dependencies);
+	constructor(kind: StreamKind, mediaSource: MediaSource, representations: Representation[], { fetcher, tuning, getCurrentPosition, getSeekTargetPosition, isActiveLowLatency, compatibilityMode, manifest, tracer, chunkDownloadHistory }: 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>>;
@@ -109,7 +113,6 @@ export declare class BufferManager {
 	private loadSegments;
 	private loadTemplateSegment;
 	private updateRepresentationsBaseUrlIfNeeded;
-	private feedPreDownloadedFirstSegment;
 	private loadByteRangeSegments;
 	private prepareByteRangeFetchSegmentParams;
 	private buildCacheMetadata;
@@ -125,11 +128,52 @@ export declare class BufferManager {
 	* @private
 	*/
 	private onSomeByteRangesDataLoaded;
+	/**
+	* Запись в историю чанков для MlAbr. Байты приходят параметром: у каждого пути
+	* аппенда свой источник истины о размере (результат fetch'а, диапазон батча,
+	* накопленные подкармливания), на SegmentProgress его нет. Пропуск без
+	* startedAtMs — у батчей byte-range время общее на группу сегментов, а без
+	* известного старта fetch'а время загрузки не выводится.
+	*/
+	private recordChunkDownload;
 	private onSegmentFullyAppended;
 	private detectBrokenSegmentAppend;
 	private abortSegment;
+	/**
+	* Прогрев sidx всех репрезентаций для MlAbr: модели нужны размеры будущих
+	* сегментов каждого качества к первому решению, а без прогрева индексы
+	* приезжают лениво — только при первом переключении на качество. Idle-очередь
+	* качает по одному индексу между делом; здесь грузим все недостающие параллельно.
+	* loadInit регистрирует промис в initData синхронно и ошибок наружу не бросает.
+	*/
+	private warmUpRepresentations;
 	private loadNextInit;
+	private isFirstSegmentPreloadEnabled;
+	private isStartPositionWithinFirstSegment;
+	/**
+	* Работа с прелоадом первого сегмента.
+	*
+	* Загружает init+index репрезентации и применяет их через onInitFetched (результаты сетятся в initData /
+	* parsedInitData / segments). Резолвится после применения инита.
+	*
+	* Режимы вызова:
+	* - critical=true — только startWith (стартовая загрузка);
+	* - critical=false — switchTo и ленивые idle-догрузки остальных репрезентаций.
+	*
+	* С прелоадом первого сегмента (critical && isFirstSegmentPreloadEnabled):
+	* - фетчер делает один combined-запрос init+index+первый сегмент;
+	* - инит применяется досрочно из onInitFetched, до скачанных байтов сегмента, и сразу ставится
+	*   init-аппенд в SourceBufferTaskQueue — раньше кормления чанков сегмента (кормление синхронно
+	*   внутри onProgress, поэтому без этого сегмент аппендился бы раньше инита);
+	* - резолв loadInit ждёт завершения init-аппенда;
+	* - чанки сегмента кормятся через handleFirstSegmentChunk, хвост добивается в finalizeCombinedStreaming
+	*/
 	private loadInit;
+	/**
+	* Здесь мы только финалим хвостовую часть — сегментную — комбинированного запроса.
+	* Если сегмент не докачался не беда, loadSegments подхватит.
+	*/
+	private finalizeCombinedStreaming;
 	private dropBuffer;
 	private pruneBuffer;
 	private abortBuffer;

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

@@ -1,8 +1,7 @@
 import type { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } from "../../../player/types";
 import type ThroughputEstimator from "../../../utils/ThroughputEstimator";
-import type { Byte, IValueSubject, ISubject, Milliseconds, IRange, ITracer, IError } from "@vkontakte/videoplayer-shared";
+import type { Byte, ExactVideoQuality, IValueSubject, ISubject, Milliseconds, IRange, ITracer, IError } from "@vkontakte/videoplayer-shared";
 import { abortable } from "@vkontakte/videoplayer-shared";
-import type { ExactVideoQuality } from "@vkontakte/videoplayer-shared";
 import type { CommonInit, GenericContainerParser, Segment, SegmentReference } from "../../utils/parsers/types";
 import type { ISegmentCacheStorage, CacheMetadata, SegmentCacheMode } from "../../utils/segmentCache";
 declare global {
@@ -50,13 +49,19 @@ export interface FetchParams {
 	ignoreNetworkErrors?: boolean;
 	representationHeight?: number;
 	cacheMetadata?: CacheMetadata;
+	firstSegmentPreload?: boolean;
+	onInitFetched?: (data: IRepresentationInitReady) => void;
+	onSegmentsDone?: (result: ICombinedBodyResult | null) => void;
 }
-export type RepresentationFetchResult = {
+export interface IRepresentationInitReady {
 	init: CommonInit | null;
 	segments: Segment[];
+	initData: ArrayBuffer;
+	globalFrom: Byte;
+}
+export interface ICombinedBodyResult {
 	dataView: DataView;
-	firstSegmentData?: ArrayBuffer;
-};
+}
 export declare class Fetcher {
 	private throughputEstimator;
 	private requestQuic;
@@ -97,11 +102,31 @@ export declare class Fetcher {
 	private trackRequestStart;
 	fetchManifest: ReturnType<typeof abortable<[string], string | null>>;
 	fetch: ReturnType<typeof abortable<[string, FetchParams], ArrayBuffer | null>>;
-	fetchRepresentation(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, fetchParams: FetchParams): Promise<RepresentationFetchResult | null>;
+	/**
+	* Резолвится, когда получили init данные.
+	*/
+	fetchRepresentation(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, fetchParams: FetchParams): Promise<IRepresentationInitReady | null>;
 	/** Скипнутые сегменты не записаны в кэш — при следующем запросе региона докачаются как miss. */
 	private traceSkippedCacheSegments;
 	destroy(): void;
+	/**
+	* Тут проверяем расположение данных, нам из манифеста приходит только длина сегмента, ничто не известно про оффсет от начала,
+	* заявлено, что первый сегмент идет сразу после индекса. Проверяем контракт: true — нарушен, первый сегмент лежит не сразу за индексом.
+	*/
+	private isFirstSegmentLayoutViolated;
+	private logFirstSegmentLayoutViolation;
+	/**
+	* Адаптируем onProgress комбинированного запроса: отдельно информируем о данных инита
+	* и о данных сегмента на основании одного combined-стрима.
+	*/
+	private createInitAndFirstSegmentStreamingOnProgress;
 	private fetchByteRangeRepresentation;
+	private fetchByteRangeRepresentationWithFirstSegment;
+	/**
+	* Если происходит downloadSignal то мы не хотим абортить загрузку инит части запроса,
+	* скачиваем нужную часть запроса, как только инит+индекс готов, сегмент хвост можно абортить.
+	*/
+	private createSegmentTailAbort;
 	private fetchTemplateRepresentation;
 	private isLikelyCacheHitByTtfb;
 	private doFetch;

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

@@ -8,6 +8,7 @@ import type { ITuningConfig } from "../../../utils/tuningConfig";
 import type { ExactVideoQuality, IError, ISubject, ITracer, IValueSubject, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
 import { abortable, Subject } from "@vkontakte/videoplayer-shared";
 import type { VideoSegmentLoadProgress } from "../../utils/Abr/types";
+import type { IChunkDownloadHistory } from "../../utils/Abr/mlAbr/chunkDownloadHistory";
 export declare enum State {
 	NONE = "none",
 	MANIFEST_READY = "manifest_ready",
@@ -22,6 +23,8 @@ export interface Params {
 	tracer: ITracer;
 	isOnDemand: boolean;
 	dashMaxTvVideoQuality: Nullable<ExactVideoQuality>;
+	getSeekTargetPosition?: () => Milliseconds | undefined;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 }
 export declare class Player {
 	private element;
@@ -89,6 +92,8 @@ export declare class Player {
 	private liveWasInterrupted;
 	private isOnDemand;
 	private dashMaxTvVideoQuality;
+	private getSeekTargetPosition;
+	private chunkDownloadHistory;
 	private destroyController;
 	constructor(params: Params);
 	initManifest: ReturnType<typeof abortable<[HTMLMediaElement, string, number]>>;

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

@@ -12,6 +12,7 @@ import StallsManager from "../utils/StallsManager";
 import { ElementSizeManager } from "../utils/HTMLVideoElement/ElementSizeManager";
 import type { BasePlayer } from "./lib/player/basePlayer";
 import { AbrManager } from "../utils/Abr/abrManager";
+import type { IChunkDownloadHistory } from "../utils/Abr/mlAbr/chunkDownloadHistory";
 type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
@@ -32,6 +33,8 @@ export default abstract class BaseDashProvider implements IProvider {
 	protected stallsManager: StallsManager;
 	protected elementSizeManager: ElementSizeManager;
 	protected abrManager: AbrManager;
+	/** Один на плеер: оба DASH-провайдера пишут, правило MlAbr читает (UVP-12133). */
+	protected chunkDownloadHistory: IChunkDownloadHistory;
 	protected videoTracksMap: Map<IVideoTrack, {
 		stream: Stream;
 		representation: Representation;

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

@@ -4,6 +4,7 @@ import type { Fetcher } from "../fetcher";
 import type { ITuningConfig } from "../../../../utils/tuningConfig";
 import type { VideoSegmentLoadProgress } from "../../../utils/Abr/types";
 import type { ISegmentCacheStorage } from "../../../utils/segmentCache";
+import type { IChunkDownloadHistory } from "../../../utils/Abr/mlAbr/chunkDownloadHistory";
 export type TRepresentationSwitchMode = "lazy" | "force";
 export declare enum SwithRepresentationMode {
 	Lazy = "lazy",
@@ -17,9 +18,11 @@ export interface Dependencies {
 	compatibilityMode?: boolean;
 	manifest: Manifest | null;
 	segmentCacheService?: ISegmentCacheStorage;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 	getCurrentPosition(): Milliseconds | undefined;
 	getCurrentStallDuration(): Milliseconds;
 	isActiveLowLatency(): boolean;
+	getSeekTargetPosition?(): Milliseconds | undefined;
 }
 export interface IVirtualBufferManager<T extends Segment = Segment> {
 	error$: ISubject<IError>;

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

@@ -1,4 +1,4 @@
-import type { Fetcher, FetchParamsWithUrl, Priority, RepresentationFetchResult } from "../../fetcher";
+import type { Fetcher, FetchParamsWithUrl, Priority } from "../../fetcher";
 import type { CommonInit, ContainerParser, Representation, Segment } from "../../../../utils/parsers/types";
 import { StreamKind } from "../../../../utils/parsers/types";
 import type { ITuningConfig } from "../../../../../utils/tuningConfig";
@@ -22,11 +22,12 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected readonly tuning: ITuningConfig;
 	protected readonly segmentCacheService: ISegmentCacheStorage | undefined;
 	protected representations: Map<Representation["id"], Representation>;
+	private chunkDownloadHistory;
 	protected playingRepresentationId: Representation["id"] | undefined;
 	protected downloadingRepresentationId: Representation["id"] | undefined;
 	protected switchingRepresentationId: Representation["id"] | null;
 	protected initData: Map<Representation["id"], ArrayBuffer>;
-	protected initDataPromises: Map<Representation["id"], Promise<RepresentationFetchResult<T> | null | undefined>>;
+	protected initDataPromises: Map<Representation["id"], Promise<unknown>>;
 	protected idleCallbacks: Map<Representation["id"], number>;
 	protected parsedInitData: Map<Representation["id"], CommonInit>;
 	protected forwardBufferRepresentations: Map<Representation["id"], T[]>;
@@ -55,8 +56,9 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected subscription: Subscription;
 	protected readonly getCurrentPosition: () => Milliseconds | undefined;
 	protected readonly getCurrentStallDuration: () => Milliseconds | undefined;
+	protected readonly getSeekTargetPosition: (() => Milliseconds | undefined) | undefined;
 	protected brokenSegmentAppendDetected: boolean;
-	protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tracer, tuning, getCurrentPosition, getCurrentStallDuration, manifest, segmentCacheService }: Dependencies);
+	protected constructor(kind: StreamKind, nativeBufferManager: NativeBufferManager, representations: Representation[], { fetcher, tracer, tuning, getCurrentPosition, getCurrentStallDuration, getSeekTargetPosition, manifest, segmentCacheService, chunkDownloadHistory }: Dependencies);
 	protected abstract loadItems(itemsToLoad: IBufferPlaybackQueueItem<T>[], representation: Representation, priority?: Priority): Promise<void>;
 	protected abstract selectItemsToLoad(): IBufferPlaybackQueueItem<T>[];
 	protected abstract prepareFetchParams(items: IBufferPlaybackQueueItem<T>[], representation: Representation): FetchParamsWithUrl;
@@ -107,9 +109,18 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected abortDownload(): void;
 	protected abortDownloadingItems(): void;
 	protected abortNativeBuffer(): Promise<boolean>;
-	protected loadInits(): Promise<void>;
+	/**
+	* Прогрев индексов остальных репрезентаций. За mlAbr.enabled — параллельно и
+	* сразу: MlAbr нужны размеры сегментов всех качеств к первому решению модели,
+	* idle-отсрочка опоздала бы. loadInitIfNeeded дедупится initDataPromises, ошибок
+	* наружу не бросает.
+	*/
+	protected loadInits(): void;
 	protected loadInitIfNeeded(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
 	protected loadInit(representation: Representation, requestedPriority?: Priority, critical?: boolean): Promise<void>;
+	private isStartPositionWithinFirstSegment;
+	private finalizeCombinedStreaming;
+	private resetStreamingItem;
 	protected maintainNativeBuffer(signal: AbortSignal): Promise<void>;
 	protected maintainPlaybackBuffer(position: Milliseconds): Promise<void>;
 	protected actualizeLastSegmentInfo(currentPosition: Milliseconds): void;
@@ -127,6 +138,12 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	protected onItemFullyAppended(appendedItem: IBufferPlaybackQueueItem<T>): void;
 	private detectBrokenSegmentAppend;
 	protected removeSegment(nextRemoveItem: IBufferPlaybackQueueItem<T>, signal: AbortSignal): Promise<void>;
+	/**
+	* Запись в историю чанков для MlAbr. Без size или startedAtMs запись не
+	* выводится корректно (размер неизвестен до sidx, старт — до перевода в
+	* DOWNLOADING): молча пропускаем, история просто копится медленнее.
+	*/
+	private recordChunkDownload;
 	protected onDownloadItem(downloadedItem: IBufferPlaybackQueueItem<T>): void;
 	protected pruneVirtualBuffer(currentPosition: Milliseconds): void;
 	protected updateRepresentationsBaseUrlIfNeeded(): void;

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

@@ -1,8 +1,7 @@
 import type { HttpConnectionType, HttpConnectionMetrics, HttpDownloadMetrics } from "../../../player/types";
 import type ThroughputEstimator from "../../../utils/ThroughputEstimator";
-import type { Byte, IError, IRange, ISubject, ITracer, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { Byte, ExactVideoQuality, IError, IRange, ISubject, ITracer, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
 import { abortable } from "@vkontakte/videoplayer-shared";
-import type { ExactVideoQuality } from "@vkontakte/videoplayer-shared";
 import type { CommonInit, GenericContainerParser, Segment, SegmentReference, StreamKind } from "../../utils/parsers/types";
 import type { ISegmentCacheStorage, CacheMetadata, SegmentCacheMode } from "../../utils/segmentCache";
 declare global {
@@ -44,17 +43,30 @@ export interface FetchParams {
 	onProgressTasks?: Promise<void>[];
 	signal?: AbortSignal;
 	priority?: Priority;
+	representationHeight?: number;
 	measureThroughput?: boolean;
 	isLowLatency?: boolean;
 	bufferOptimisation?: boolean;
 	kind: StreamKind;
 	cacheMetadata?: CacheMetadata;
+	firstSegmentPreload?: boolean;
+	onInitFetched?: (data: IRepresentationInitReady) => void;
+	onSegmentsDone?: (result: ICombinedBodyResult | null) => void;
+}
+export interface IRepresentationInitReady {
+	init: CommonInit | null;
+	segments: Segment[];
+	initData: ArrayBuffer;
+	globalFrom: Byte;
+}
+export interface ICombinedBodyResult {
+	dataView: DataView;
 }
 export type RepresentationFetchResult<T extends Segment> = {
-	initMetadata: CommonInit | null;
-	initDataView: DataView;
+	init: CommonInit | null;
 	segments: T[];
-	firstSegmentData?: ArrayBuffer;
+	initData: ArrayBuffer;
+	globalFrom: Byte;
 };
 export declare class Fetcher {
 	private throughputEstimator;
@@ -96,11 +108,23 @@ export declare class Fetcher {
 	private trackRequestStart;
 	fetchManifest: ReturnType<typeof abortable<[string], string | null>>;
 	fetch: ReturnType<typeof abortable<[string, FetchParams], ArrayBuffer | null>>;
-	fetchRepresentation<T extends Segment>(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, dowbloadAbortSignal: AbortSignal, priority?: Priority, representationHeight?: number, kind?: StreamKind): Promise<RepresentationFetchResult<T> | null | undefined>;
+	fetchRepresentation<T extends Segment>(segmentReference: SegmentReference, parser: GenericContainerParser<unknown>, fetchParams?: FetchParams): Promise<RepresentationFetchResult<T> | null | undefined>;
 	/** Скипнутые сегменты не записаны в кэш — при следующем запросе региона докачаются как miss. */
 	private traceSkippedCacheSegments;
 	destroy(): void;
+	/**
+	* Так как качем инит+сегмент, то нам нужно раньше сообщить, что мы получили инит+индекс часть,
+	* а сегментная пусть качается дальше.
+	*/
+	private createInitAndFirstSegmentStreamingOnProgress;
+	/**
+	* Проверяем, что данные сегмента идут сразу после индекса.
+	*/
+	private isFirstSegmentLayoutViolated;
+	private logFirstSegmentLayoutViolation;
 	private fetchByteRangeRepresentation;
+	private fetchByteRangeRepresentationWithFirstSegment;
+	private createSegmentTailAbort;
 	private fetchTemplateRepresentation;
 	private isLikelyCacheHitByTtfb;
 	private doFetch;

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

@@ -80,6 +80,8 @@ export declare abstract class BasePlayer {
 	updateDurationError$: Subject<IError>;
 	private isOnDemand;
 	private dashMaxTvVideoQuality;
+	private getSeekTargetPosition;
+	private chunkDownloadHistory;
 	protected constructor(params: Params);
 	protected abstract prepareManifestUrlString(manifestBaseUrlString: string, offset: number): string;
 	protected abstract setSourceInitDuration(): void;

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

@@ -1,7 +1,8 @@
 import type ThroughputEstimator from "../../../../utils/ThroughputEstimator";
 import type { ITuningConfig } from "../../../../utils/tuningConfig";
 import type { VideoCodec } from "../../../../player/types";
-import type { ExactVideoQuality, ITracer, Nullable } from "@vkontakte/videoplayer-shared";
+import type { ExactVideoQuality, ITracer, Milliseconds, Nullable } from "@vkontakte/videoplayer-shared";
+import type { IChunkDownloadHistory } from "../../../utils/Abr/mlAbr/chunkDownloadHistory";
 export declare enum State {
 	NONE = "none",
 	MANIFEST_READY = "manifest_ready",
@@ -16,4 +17,6 @@ export interface Params {
 	tracer: ITracer;
 	isOnDemand?: boolean;
 	dashMaxTvVideoQuality?: Nullable<ExactVideoQuality>;
+	getSeekTargetPosition?: () => Milliseconds | undefined;
+	chunkDownloadHistory?: IChunkDownloadHistory;
 }

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

@@ -1,5 +1,6 @@
 import type { IMetadata, ISources } from "../../player/types";
 import { VideoFormat } from "../../player/types";
+import type { ICoreInstanceData } from "../../player/types";
 import type { ITuningConfig } from "../../utils/tuningConfig";
 import type { IError, ISubject, IValueSubject, IRectangle } from "@vkontakte/videoplayer-shared";
 import { ValueSubject } from "@vkontakte/videoplayer-shared";
@@ -16,6 +17,7 @@ interface IParams extends IProviderDependencies {
 	panelSize?: IRectangle;
 	skipVideoElVolumeSync$: ValueSubject<boolean>;
 	handleNetworkRecoverableErrorAsProviderError?: boolean;
+	instanceData?: ICoreInstanceData;
 }
 export default class ProviderContainer implements IProviderContainer {
 	current$: IValueSubject<IProviderEntry>;

package/types/providers/types.d.ts

@@ -2,7 +2,7 @@ import type { ITuningConfig } from "../utils/tuningConfig";
 import type { IComponentLogger, IError, ILogger, IRange, IRectangle, ISubject, ITracer, IValueSubject, IWarning, Milliseconds, QualityLimits, Seconds } from "@vkontakte/videoplayer-shared";
 import type { IChromecastInitializer } from "./ChromecastProvider/ChromecastInitializer/types";
 import type { IExternalTextTrack, IInternalTextTrack, ITextTrack, IVideoTrack, IVolumeState, PlaybackRate, PlaybackState } from "../player/types";
-import type { AudioCodec, HttpConnectionMetrics, HttpConnectionType, HttpDownloadMetrics, IAudioStream, IAudioTrack, ISources, IVideoStream, SeekState, VideoCodec } from "../player/types";
+import type { AudioCodec, HttpConnectionMetrics, HttpConnectionType, HttpDownloadMetrics, IAudioStream, IAudioTrack, ICoreInstanceData, ISources, IVideoStream, SeekState, VideoCodec } from "../player/types";
 import type { IStateMachine } from "../utils/StateMachine/types";
 import type ThroughputEstimator from "../utils/ThroughputEstimator";
 export interface IProvider {
@@ -25,6 +25,7 @@ export interface IProviderParams<TSourceType> extends IProviderDependencies {
 	tuning: ITuningConfig;
 	panelSize?: IRectangle;
 	skipVideoElVolumeSync$: IValueSubject<boolean>;
+	instanceData?: ICoreInstanceData;
 }
 export interface DesiredStateValues {
 	audioStream: IAudioStream | undefined;

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

@@ -11,11 +11,13 @@ export declare class AbrManager {
 	private context;
 	private phaseController;
 	private allVideoRules;
+	private mlAbrRule;
 	private tracer;
 	init(context: IInitAbrManagerContext): void;
 	updateContext(updateContext: IUpdatableAbrManagerContext): void;
 	private getAudioReserve;
 	autoSelectTrack<T extends IVideoTrack | IAudioTrack>(kind: Exclude<StreamKind, StreamKind.TEXT>): T;
+	private withoutClassicDecisionOwners;
 	destroy(): void;
 	private initVideoElementAbrContext;
 	private updateTracksIfneeded;

package/types/providers/utils/Abr/mlAbr/chunkDownloadHistory.d.ts

@@ -0,0 +1,34 @@
+import type { Byte, IObservable, Milliseconds, VideoQuality } from "@vkontakte/videoplayer-shared";
+import { Subject } from "@vkontakte/videoplayer-shared";
+import type { Representation } from "../../parsers/types";
+export interface IChunkDownloadRecord {
+	bytes: Byte;
+	loadTimeMs: Milliseconds;
+	representationId: Representation["id"];
+	/**
+	* Неопределён, когда качество репрезентации не выводится ни из строки
+	* манифеста, ни из размеров: запись всё равно полезна истории полосы
+	* (bytes/loadTime), а построитель входов модели оставит её без one-hot.
+	*/
+	quality: VideoQuality | undefined;
+}
+export interface IChunkDownloadHistory {
+	/** Пушится на каждую запись; подписка правила пересчитывает кэш решения. */
+	readonly segmentDownloaded$: IObservable<IChunkDownloadRecord>;
+	add(record: IChunkDownloadRecord): void;
+	/** Записи от старых к новым; паддинг нулями делает построитель входов модели. */
+	snapshot(): readonly IChunkDownloadRecord[];
+	clear(): void;
+}
+/** Глубина истории модели PPO: H=24 зашита в артефакт (UVP-12133). */
+export declare const CHUNK_HISTORY_CAPACITY = 24;
+export declare class ChunkDownloadHistoryCollector implements IChunkDownloadHistory {
+	private readonly capacity;
+	readonly segmentDownloaded$: Subject<IChunkDownloadRecord>;
+	private readonly records;
+	constructor(capacity?: number);
+	add(record: IChunkDownloadRecord): void;
+	snapshot(): readonly IChunkDownloadRecord[];
+	clear(): void;
+}
+export declare const representationToQuality: (representation: Representation) => VideoQuality | undefined;