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

package/types/utils/tuningConfig.d.ts

@@ -5,6 +5,7 @@ import { IOSPreferredFormat } from "../enums/IOSPreferredFormat";
 import type { Byte, Kbps, Milliseconds, RecursivePartial, Seconds, TimerModule } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality, VideoQuality } from "@vkontakte/videoplayer-shared";
 import { AudioRuleName, VideoRuleName } from "../providers/utils/Abr/types";
+import type { UserHappinessTrigger } from "./userHappinessTriggers";
 import type { SegmentCacheConfig } from "../providers/utils/segmentCache/types";
 export type ITuningConfig = {
 	/** @deprecated */
@@ -42,6 +43,15 @@ export type ITuningConfig = {
 		initialThroughput: Kbps;
 		measureNonSegmentRequests: boolean;
 		smallSampleMinDuration: Milliseconds;
+		/**
+		* Верхняя граница скорости одного замера (Кбпс), выше которой sanityCheck его
+		* отбрасывает: такую полосу не даёт пользовательский канал — это кэш CDN/браузера,
+		* отдавший объект практически мгновенно. Дефолт 1 000 000 Кбит/с унаследован из
+		* хардкода sanityCheck до этого поля. Поднимается в e2e (UVP-11954): CI-раннеры
+		* стоят в одном ДЦ с CDN и качают сегменты быстрее гигабита — с дефолтным лимитом
+		* все замеры режутся и хостовая запись кеша не появляется.
+		*/
+		maxSampleRate: Kbps;
 		cacheThresholdSize: Milliseconds;
 		/**
 		* UVP-11541: верхняя граница порога, ниже которого ответ считается кэш-хитом по TTFB.
@@ -71,7 +81,7 @@ export type ITuningConfig = {
 		*    мелкий сегмент качается параллельно с аудио и другого замера не получает.
 		*    Параллельной считается загрузка, отдававшая байты внутри окна замера: открытая,
 		*    но молчащая (подвисла либо уже выкачала своё и ждёт done) полосу не занимает.
-		* Честный кэш (мгновенная отдача → rate > 1 Гбит/с) по-прежнему режется проверкой rate выше.
+		* Честный кэш (мгновенная отдача — скорость замера выше maxSampleRate) по-прежнему режется.
 		*
 		* Пункты 3 и 4 добавлены после эксперимента 37621: без них включённые быстрые сэмплы
 		* систематически занижали оценку, ABR держал низкое качество и сегменты оставались
@@ -90,23 +100,41 @@ export type ITuningConfig = {
 			maxLastEvaluationTimeout: Milliseconds;
 		};
 		/**
-		* TTL + проверка типа сети для кешированного throughput из localStorage.
-		* При включении: если сохранённое значение старше storedThroughputTtlMs
-		* или тип сети изменился (Wi-Fi→3G) — значение отбрасывается.
-		* Предотвращает старт в 4K при переходе с Wi-Fi на мобильную сеть.
+		* UVP-11954: кеш оценки сети с разрезом по хосту раздачи (CDN).
 		*
-		* При OFF (дефолт): читаем/пишем как до фикса — plain number в legacy-ключ
-		* one_video_*. Это даёт безопасный rollback JS-версии без потери данных.
-		* При ON: новый формат (JSON с timestamp+networkType) → новый ключ vk_uvp_*.
-		*/
-		useThroughputTtl: boolean;
-		/**
-		* Срок жизни кешированного throughput (мс). По умолчанию 4 часа.
-		* После истечения TTL значение из localStorage игнорируется —
-		* используется browser estimation или initialThroughput.
-		* Применимо только при useThroughputTtl=true.
+		* При включении: ключи vk_uvp_throughput / vk_uvp_rtt хранят JSON
+		* {"hosts":{"<host>":{"value","timestamp","networkType"?}}} — чтение только
+		* записи текущего хоста (TTL + совпадение networkType), промах = холодный старт
+		* (browser estimation, затем initialThroughput). Запись — hosts-only, без общей
+		* записи; набор хостов ограничен LRU по hostsLimit. Чтение отложено до
+		* первого события адаптации: определённая эмиссия hostname$ или первый замер.
 		*/
-		storedThroughputTtlMs: Milliseconds;
+		cdnCache: {
+			/**
+			* Гейт всех изменений UVP-11954. При false (дефолт): бит-в-бит прежнее
+			* поведение — plain number в legacy-ключах one_video_*; ключи vk_uvp_*
+			* не читаются и не пишутся. Это даёт безопасный rollback JS-версии
+			* без потери свежих данных для старого кода.
+			*/
+			enabled: boolean;
+			/**
+			* Срок жизни каждой хостовой записи кеша (мс). По умолчанию 4 часа.
+			* Запись старше TTL при чтении отбрасывается — холодный старт.
+			* Применимо только при cdnCache.enabled=true.
+			*/
+			ttlMs: Milliseconds;
+			/**
+			* Предел числа хостовых записей в hosts (UVP-11954). При превышении при записи
+			* вытесняется запись с наименьшим timestamp (не считая текущего хоста).
+			* Протухшие по TTL записи уходят первыми — отдельной чистки нет.
+			* 10: ключ кеша — хост раздачи, а балансировщик video.get выдаёт хост
+			* при каждой загрузке видео и не гарантирует повтор предыдущего. За TTL
+			* активный пользователь может собрать записи по нескольким хостам —
+			* 10 покрывает это с запасом при ~100 Б на запись, ~1 КБ на набор из 10.
+			* Применимо только при cdnCache.enabled=true.
+			*/
+			hostsLimit: number;
+		};
 	};
 	autoTrackSelection: {
 		bitrateFactorAtEmptyBuffer: number;
@@ -143,7 +171,6 @@ export type ITuningConfig = {
 		enabled: boolean;
 		ignoreDynamicAbrForShortVideo: boolean;
 		stallDurationNoDataBeforeQualityDecrease: Milliseconds;
-		stallDurationToBeCount: Milliseconds;
 		stallCountBeforeQualityDecrease: Milliseconds;
 		resetQualityRestrictionTimeout: Milliseconds;
 		ignoreStallsOnSeek: boolean;
@@ -256,6 +283,26 @@ export type ITuningConfig = {
 			budgetFactor: number;
 			fallbackSegmentDurationMs: Milliseconds;
 		};
+		/**
+		* ML-правило ABR (UVP-12133). Поведенческие ручки; сессионный провайдер модели
+		* `instance.core.getAbrMLModel` — инстанс-данные initPlayer, не tuning.
+		*/
+		mlAbr: {
+			/** Фича-флаг. Выключен — правило не регистрируется, сеть и бандл не меняются. */
+			enabled: boolean;
+			/** Гостевая модель, когда провайдер не передан или вернул null. */
+			guestModelUrl: string | undefined;
+			/** Артефакт воркера на CDN; версионируемый путь — ручка флагов и экспериментов. */
+			workerJsUrl: string;
+			/** Каталог litert-артефакта на CDN; оттуда префетчатся iife и wasm параллельно модели. */
+			litertWasmUrl: string;
+			/** Прогрев: минимум записей истории чанков до входа в ML-режим. */
+			minHistorySize: number;
+			/** Сила голоса правила в конвейере. */
+			confidence: "high" | "normal";
+			/** Таймаут от создания клиента до готовности инференса в воркере. */
+			runtimeInitTimeoutMs: Milliseconds;
+		};
 		videoStreamRepresentaionsFilter: [VideoQuality, number, VideoCodecName][];
 		filterOnDemandQualityList: boolean;
 		dashMaxTvVideoQuality: boolean;
@@ -284,6 +331,8 @@ export type ITuningConfig = {
 		*/
 		recoverStuckSegmentLoading: boolean;
 		skipReloadOfFullyBufferedPartiallyEjectedSegments: boolean;
+		/** В Safari ждёт завершения append init-сегмента после abort перед выполнением remove. */
+		deferRemoveUntilAbortCompletes: boolean;
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -343,6 +392,8 @@ export type ITuningConfig = {
 	};
 	enableWakeLock: boolean;
 	enableTelemetryAtStart: boolean;
+	/** Список user-happiness-триггеров, включённых для отправки в tracer. Пустой список отключает их. */
+	userHappinessTriggers: UserHappinessTrigger[];
 	forceFormat: VideoFormat | undefined;
 	formatsToAvoid: VideoFormat[];
 	disableChromecast: boolean;
@@ -374,10 +425,10 @@ export type ITuningConfig = {
 	*/
 	stallIgnoreThreshold: Milliseconds;
 	/**
-	* Стратегия записи столлов
+	* Стратегия записи stall
 	* verbose - записываем всё
-	* exclude-threshold - записываем столлы длинее stallIgnoreThreshold, но вычитаем длину stallIgnoreThreshold
-	* include-threshold - записываем столлы длинее stallIgnoreThreshold
+	* exclude-threshold - записываем stall длиннее stallIgnoreThreshold, но вычитаем длину stallIgnoreThreshold
+	* include-threshold - записываем stall длиннее stallIgnoreThreshold
 	*/
 	stallHandlingStrategy: "verbose" | "exclude-threshold" | "include-threshold";
 	stallIgnoreOnPause: boolean;

package/types/utils/userHappinessTriggers.d.ts

@@ -0,0 +1,4 @@
+export declare const USER_HAPPINESS_TRIGGER_NAMES: readonly ["has_fatal_error", "slow_first_frame", "high_stall_ratio", "low_quality"];
+export type UserHappinessTrigger = (typeof USER_HAPPINESS_TRIGGER_NAMES)[number];
+export declare const isUserHappinessTrigger: (value: unknown) => value is UserHappinessTrigger;
+export declare const normalizeUserHappinessTriggers: (value: unknown) => UserHappinessTrigger[];

package/types/utils/buffer/getBackwardBufferDuration.d.ts

@@ -1,3 +0,0 @@
-import type { Milliseconds } from "@vkontakte/videoplayer-shared";
-declare const _default: (timeRanges: TimeRanges, position: Milliseconds) => Milliseconds;
-export default _default;