@vkontakte/videoplayer-core 2.0.180 → 2.0.181-beta.1

package/types/utils/ThroughputEstimator.d.ts

@@ -1,15 +1,30 @@
-import type { Byte, Kbps, Milliseconds, IValueSubject } from "@vkontakte/videoplayer-shared";
+import type { Byte, Kbps, Milliseconds, IValueSubject, IComponentLogger } from "@vkontakte/videoplayer-shared";
 import type { ITuningConfig } from "./tuningConfig";
 declare class ThroughputEstimator {
 	private throughput;
 	private rtt;
 	private subscription;
+	private wiring;
+	private readonly throughputVarianceProxy$;
+	private currentHost;
+	private hasThroughputSamples;
+	private hasRttSamples;
+	private storageReadDone;
 	private tuningConfig;
+	private readonly logger?;
+	private initialThroughputSource;
+	private initialRttSource;
 	private concurrentDownloads;
 	throughput$: IValueSubject<Kbps>;
 	rtt$: IValueSubject<Milliseconds>;
 	rttAdjustedThroughput$: IValueSubject<Kbps>;
-	constructor(tuning: ITuningConfig["throughputEstimator"]);
+	constructor(tuning: ITuningConfig["throughputEstimator"], hostname$?: IValueSubject<string | undefined>, logger?: IComponentLogger);
+	private static readLegacyNumber;
+	private static resolveInitialThroughput;
+	private static resolveInitialRtt;
+	private tryAdopt;
+	private recreateSmoothed;
+	private wireSmoothed;
 	destroy(): void;
 	trackXHR(xhr: XMLHttpRequest): void;
 	trackStream(stream: ReadableStream, isLowLatency?: boolean): void;
@@ -21,10 +36,11 @@ declare class ThroughputEstimator {
 	*/
 	addRawThroughput(rate: Kbps): void;
 	addRawRtt(time: Milliseconds): void;
+	private markSample;
 	private sanityCheck;
 	get throughputVariance$(): IValueSubject<number>;
-	private static loadStored;
-	private static writeStored;
+	private static readHostRecord;
+	private writeStored;
 	private static validateStored;
 }
 export default ThroughputEstimator;

package/types/utils/UserHappinessController.d.ts

@@ -0,0 +1,8 @@
+import type { ITracer } from "@vkontakte/videoplayer-shared";
+import type { IPlayerEvents, IPlayerExperimental, IPlayerInfo } from "../player/types";
+export declare class UserHappinessController {
+	private readonly subscription;
+	private readonly observer?;
+	constructor(info: IPlayerInfo, events: IPlayerEvents, experimental: IPlayerExperimental, tracer: ITracer, configuredTriggers: unknown);
+	destroy(): void;
+}

package/types/utils/UserHappinessObserver/constants.d.ts

@@ -0,0 +1,12 @@
+/**
+* Пороги метрик довольности пользователя. Источник формул и значений:
+* UVP-11892 и документация метрики:
+* https://confluence.vk.team/pages/viewpage.action?pageId=2056272767
+*/
+export declare const MIN_SESSION_TVT_SECONDS = 30;
+export declare const MAX_STALL_RATIO = 1.5;
+export declare const MAX_MOBILE_STALL_RATIO = 3;
+export declare const MAX_FIRST_FRAME_TIME_MS = 2e3;
+export declare const MAX_MOBILE_FIRST_FRAME_TIME_MS = 1300;
+export declare const MIN_QUALITY_SCORE = .8;
+export declare const ALLOWED_DEFICIT_RANK = .2;

package/types/utils/UserHappinessObserver/index.d.ts

@@ -0,0 +1,15 @@
+import type { IValueSubject } from "@vkontakte/videoplayer-shared";
+import type { IPlayerEvents, IPlayerExperimental, IPlayerInfo } from "../../player/types";
+import type { UserHappinessTrigger } from "../userHappinessTriggers";
+import type { UserHappinessQualityPlatform, UserHappinessThresholds } from "./types";
+export declare class UserHappinessObserver {
+	private readonly subscription;
+	private readonly sessionFinalized$;
+	readonly lowQuality$: IValueSubject<boolean>;
+	readonly highStallRatio$: IValueSubject<boolean>;
+	readonly hasFatalError$: IValueSubject<boolean>;
+	readonly slowFirstFrame$: IValueSubject<boolean>;
+	constructor(info: IPlayerInfo, events: IPlayerEvents, experimental: IPlayerExperimental, triggers: readonly UserHappinessTrigger[], thresholds: UserHappinessThresholds, qualityPlatform: UserHappinessQualityPlatform);
+	destroy(): void;
+	finalizeSession(): void;
+}

package/types/utils/UserHappinessObserver/metrics/hasFatalError.d.ts

@@ -0,0 +1,3 @@
+import type { IValueSubject, Subscription } from "@vkontakte/videoplayer-shared";
+import type { IPlayerEvents } from "../../../player/types";
+export declare const createHasFatalError: (events: IPlayerEvents, subscription: Subscription) => IValueSubject<boolean>;

package/types/utils/UserHappinessObserver/metrics/highStallRatio.d.ts

@@ -0,0 +1,3 @@
+import type { IValueObservable, IValueSubject, Milliseconds, Seconds, Subscription } from "@vkontakte/videoplayer-shared";
+import type { IPlayerEvents, IPlayerInfo } from "../../../player/types";
+export declare const createHighStallRatio: (info: IPlayerInfo, events: IPlayerEvents, watchedTimeSeconds$: IValueObservable<Seconds>, sessionFinalized$: IValueObservable<boolean>, subscription: Subscription, maxStallRatio: number, nowInt: () => Milliseconds) => IValueSubject<boolean>;

package/types/utils/UserHappinessObserver/metrics/lowQuality/constants.d.ts

@@ -0,0 +1,5 @@
+import { VideoQuality } from "@vkontakte/videoplayer-shared";
+export declare const QUALITY_RANKS: Partial<Record<VideoQuality, number>>;
+export declare const DEFAULT_NETWORK_QUALITY_THRESHOLDS: readonly [281, 452, 967, 2300, 2551, 4483, 8965];
+export declare const WEBM_NETWORK_QUALITY_THRESHOLDS: readonly [196.4, 357.7, 595.6, 1108, 2100, 7850, 16770];
+export declare const AV1_NETWORK_QUALITY_THRESHOLDS: readonly [245, 424, 641, 1140, 2048, 3935, 7469];

package/types/utils/UserHappinessObserver/metrics/lowQuality/createLowQuality.d.ts

@@ -0,0 +1,4 @@
+import { type IValueObservable, type IValueSubject, type Seconds, type Subscription } from "@vkontakte/videoplayer-shared";
+import type { IPlayerExperimental, IPlayerInfo } from "../../../../player/types";
+import type { UserHappinessQualityPlatform, UserHappinessThresholds } from "../../types";
+export declare const createLowQuality: (info: IPlayerInfo, experimental: IPlayerExperimental, totalViewTimeSeconds$: IValueObservable<Seconds>, sessionFinalized$: IValueObservable<boolean>, subscription: Subscription, thresholds: Pick<UserHappinessThresholds, "minQualityScore" | "allowedDeficitRank">, qualityPlatform: UserHappinessQualityPlatform) => IValueSubject<boolean>;

package/types/utils/UserHappinessObserver/metrics/lowQuality/index.d.ts

@@ -0,0 +1 @@
+export { createLowQuality } from "./createLowQuality";

package/types/utils/UserHappinessObserver/metrics/lowQuality/types.d.ts

@@ -0,0 +1,13 @@
+export interface QualityScoreFineStats {
+	requiredQualityTotalSeconds: number;
+	qualityScoreFineSeconds: number;
+}
+export interface QualityStats {
+	totalSeconds: number;
+	rankSeconds: number;
+	unknownSeconds: number;
+}
+export interface ModeStats {
+	totalSeconds: number;
+	rankSeconds: number;
+}

package/types/utils/UserHappinessObserver/metrics/lowQuality/utils.d.ts

@@ -0,0 +1,26 @@
+import type { VideoQuality } from "@vkontakte/videoplayer-shared";
+import { Surface, VideoFormat } from "../../../../player/types";
+import type { UserHappinessQualityPlatform } from "../../types";
+import type { ModeStats, QualityScoreFineStats, QualityStats } from "./types";
+export declare const getQualityRank: (quality: VideoQuality | undefined) => number | undefined;
+/** Ранг цели для fallback по mode_stats, без viewport и сетевых ограничений. */
+export declare const getFallbackModeQualityRank: (surface: Surface, isLive: boolean, availableQualities: VideoQuality[]) => number | undefined;
+/**
+* Восстанавливает required_quality для текущего runtime-интервала по правилам SQL:
+* mode/surface → viewport → max_quality → network_quality_rank.
+*/
+export declare const getRequiredQualityRank: (surface: Surface, availableQualities: VideoQuality[], options: {
+	viewportSize?: {
+		width: number;
+		height: number;
+	};
+	throughputKbps?: number;
+	format?: VideoFormat;
+	platform: UserHappinessQualityPlatform;
+}) => number | undefined;
+/** Добавляет одну пару actual|required в потоковые агрегаты quality_score_fine сессии. */
+export declare const addRequiredQualityPair: (stats: QualityScoreFineStats, actualQualityRank: number | undefined, requiredQualityRank: number, watchTimeSeconds: number) => void;
+/** Реализация quality_score_fine для агрегированных пар actual|required одной сессии. */
+export declare const getQualityScoreFine: (stats: QualityScoreFineStats) => number | undefined;
+/** Точная проверка finalize_quality из fallback-ветки PDF/SQL. */
+export declare const finalizeQualityFallback: (qualityStats: QualityStats, modeStats: ModeStats, allowedDeficitRank: number) => boolean | undefined;

package/types/utils/UserHappinessObserver/metrics/slowFirstFrame.d.ts

@@ -0,0 +1,3 @@
+import type { IValueSubject, Milliseconds, Subscription } from "@vkontakte/videoplayer-shared";
+import type { IPlayerEvents } from "../../../player/types";
+export declare const createSlowFirstFrame: (events: IPlayerEvents, subscription: Subscription, maxFirstFrameTimeMs: Milliseconds) => IValueSubject<boolean>;

package/types/utils/UserHappinessObserver/types.d.ts

@@ -0,0 +1,8 @@
+import type { Milliseconds } from "@vkontakte/videoplayer-shared";
+export type UserHappinessQualityPlatform = "web2" | "mvk" | "smart_tv";
+export interface UserHappinessThresholds {
+	maxFirstFrameTimeMs: Milliseconds;
+	maxStallRatio: number;
+	minQualityScore: number;
+	allowedDeficitRank: number;
+}

package/types/utils/UserHappinessObserver/utils/qualityPlatform.d.ts

@@ -0,0 +1,2 @@
+import type { UserHappinessQualityPlatform } from "../types";
+export declare const getUserHappinessQualityPlatform: (isMobile: boolean, isSmartTV: boolean) => UserHappinessQualityPlatform;

package/types/utils/UserHappinessObserver/utils/thresholds.d.ts

@@ -0,0 +1,2 @@
+import type { UserHappinessThresholds } from "../types";
+export declare const getUserHappinessThresholds: (isMobile: boolean) => UserHappinessThresholds;

package/types/utils/UserHappinessObserver/utils/watchedTimeSeconds.d.ts

@@ -0,0 +1,3 @@
+import type { IValueSubject, Milliseconds, Seconds, Subscription } from "@vkontakte/videoplayer-shared";
+import type { IPlayerEvents, IPlayerInfo } from "../../../player/types";
+export declare const createWatchedTimeSeconds: (info: IPlayerInfo, events: IPlayerEvents, subscription: Subscription, nowInt: () => Milliseconds) => IValueSubject<Seconds>;

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

@@ -1,3 +1,4 @@
 import type { Milliseconds } from "@vkontakte/videoplayer-shared";
 declare const _default: (timeRanges: TimeRanges, position: Milliseconds, tolerance?: number) => boolean;
 export default _default;
+export declare const isTimeRangeBuffered: (timeRanges: TimeRanges, from: Milliseconds, to: Milliseconds) => boolean;

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_*.
+		* При включении: ключи vk_uvp_throughput / vk_uvp_rtt хранят JSON
+		* {"hosts":{"<host>":{"value","timestamp","networkType"?}}} — чтение только
+		* записи текущего хоста (TTL + совпадение networkType), промах = холодный старт
+		* (browser estimation, затем initialThroughput). Запись — hosts-only, без общей
+		* записи; набор хостов ограничен LRU по hostsLimit. Чтение отложено до
+		* первого события адаптации: определённая эмиссия hostname$ или первый замер.
 		*/
-		useThroughputTtl: boolean;
-		/**
-		* Срок жизни кешированного throughput (мс). По умолчанию 4 часа.
-		* После истечения TTL значение из localStorage игнорируется —
-		* используется browser estimation или initialThroughput.
-		* Применимо только при useThroughputTtl=true.
-		*/
-		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;
@@ -283,6 +310,9 @@ export type ITuningConfig = {
 		* дешевле замершего воспроизведения.
 		*/
 		recoverStuckSegmentLoading: boolean;
+		skipReloadOfFullyBufferedPartiallyEjectedSegments: boolean;
+		/** В Safari ждёт завершения append init-сегмента после abort перед выполнением remove. */
+		deferRemoveUntilAbortCompletes: boolean;
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -342,6 +372,8 @@ export type ITuningConfig = {
 	};
 	enableWakeLock: boolean;
 	enableTelemetryAtStart: boolean;
+	/** Список user-happiness-триггеров, включённых для отправки в tracer. Пустой список отключает их. */
+	userHappinessTriggers: UserHappinessTrigger[];
 	forceFormat: VideoFormat | undefined;
 	formatsToAvoid: VideoFormat[];
 	disableChromecast: boolean;
@@ -373,10 +405,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;
@@ -385,7 +417,6 @@ export type ITuningConfig = {
 	/** @deprecated HLS.js удалён, флаг ничего не делает */
 	useHlsJs: boolean;
 	disableHlsOnDesktop: boolean;
-	useNativeHLSTextTracks: boolean;
 	useNewSwitchTo: boolean;
 	alwaysAbortPreviousSwitch: boolean;
 	useDashProviderVirtual: 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/providers/utils/HTMLVideoElement/TextTrackManager.d.ts

@@ -1,32 +0,0 @@
-import type { IExternalTextTrack, IInternalTextTrack, ITextTrack } from "../../../player/types";
-import type { IDesiredState, IProviderOutput } from "../../types";
-/**
-* TODO: сейчас externalTextTracks и internalTextTracks записываются в availableTextTracks отсюда
-* нужно будет выпилить этот класс за исключением этой логики,
-* когда перестанет быть необходима поддержка браузерных субтитров
-*/
-declare class TextTrackManager {
-	private available$;
-	private current$;
-	private error$;
-	private video;
-	private cueSettings;
-	private subscription;
-	private externalTracks;
-	private internalTracks;
-	private baseURL?;
-	constructor(baseURL?: string);
-	connect(video: HTMLVideoElement, desiredState: Pick<IDesiredState, "externalTextTracks" | "internalTextTracks" | "currentTextTrack" | "textTrackCuesSettings">, providerOutput: Pick<IProviderOutput, "availableTextTracks$" | "currentTextTrack$" | "error$">): void;
-	private subscribe;
-	private applyCueSettings;
-	private htmlTextTracksAsArray;
-	private htmlTextTrackToITextTrack;
-	private static isHealthyTrack;
-	setExternal(tracks: IExternalTextTrack[]): void;
-	setInternal(tracks: IInternalTextTrack[]): void;
-	select(selectedId: ITextTrack["id"] | undefined): void;
-	destroy(): void;
-	private attach;
-	private detach;
-}
-export default TextTrackManager;

package/types/utils/setStateWithSubscribe.d.ts

@@ -1,6 +0,0 @@
-import type { IValueSubject } from "@vkontakte/videoplayer-shared";
-import type { IStateMachine } from "./StateMachine/types";
-export declare const setStateWithSubscribe: <
-	State,
-	Value
->(nextState: State | undefined, currentState: IStateMachine<State | undefined>, availableValues: IValueSubject<Array<Value>> | undefined, predicate: (value: Value) => boolean) => void;