@vkontakte/videoplayer-core 2.0.181-dev.05b016920.0 → 2.0.181-dev.132333d53.0

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

@@ -1,7 +1,9 @@
 import type { IAudioTrack, IBaseTrack, IVideoTrack } from "../../../player/types";
 import type { Byte, IComponentLogger, IObservable, IRectangle, ITracer, IValueSubject, Kbps, Milliseconds, Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
 import type { ITuningConfig } from "../../../utils/tuningConfig";
+import type { MlModelResolver } from "../../../player/types";
 import type { Representation, Segment } from "../parsers/types";
+import type { IChunkDownloadHistory } from "./mlAbr/chunkDownloadHistory";
 import type { ElementSizeManager } from "../HTMLVideoElement/ElementSizeManager";
 import type { IObservableMediaElement } from "../HTMLVideoElement/observable";
 import type { AbrPhase } from "./controllers/abrPhaseController";
@@ -25,7 +27,8 @@ export declare enum VideoRuleName {
 	UpperLimit = "upper_limit_rule",
 	Throughput = "throughput_rule",
 	AbandonRequest = "abandon_request_rule",
-	InsufficientBuffer = "insufficient_buffer_rule"
+	InsufficientBuffer = "insufficient_buffer_rule",
+	MlAbr = "ml_abr_rule"
 }
 export declare enum AudioRuleName {
 	MinAudioForVideo = "min_audio_for_video_rule",
@@ -59,6 +62,10 @@ export interface IInitAbrManagerContext {
 	throughput$: IValueSubject<Kbps>;
 	rtt$: IValueSubject<Milliseconds>;
 	throughputVariance$?: IValueSubject<number>;
+	/** История загрузок видеочанков для MlAbr; не передан — фича деградирует в воздержание. */
+	chunkDownloadHistory?: IChunkDownloadHistory;
+	/** Провайдер байтов модели из инстанс-данных приложения; гейт загрузки рантайма. */
+	mlAbrModelResolver?: MlModelResolver;
 	element: HTMLMediaElement;
 	abrLogger: IComponentLogger;
 	tracer: ITracer;
@@ -92,6 +99,8 @@ export interface IAbrRule<
 	C extends IBaseAbrControllerContext
 > {
 	readonly activePhases: ReadonlySet<AbrPhase>;
+	/** Имя правила из VideoRuleName/AudioRuleName; AbrManager фильтрует набор по именам. */
+	readonly name: string;
 	init(initContext: IRuleInitContext): void;
 	destroy(): void;
 	execute(context: C): IAbrRuleResolution<T>;

package/types/utils/ClientChecker/services/DeviceChecker.d.ts

@@ -20,6 +20,7 @@ export interface DeviceHardware {
 export declare class DeviceChecker implements Checker {
 	private _displayChecker;
 	private _isMobile;
+	private _isSmartTV;
 	private _current;
 	private _iosVersion;
 	private _highEntropyValues;
@@ -31,6 +32,7 @@ export declare class DeviceChecker implements Checker {
 	get current(): CurrentClientDevice;
 	get os(): OS;
 	get details(): DeviceDetails;
+	get isSmartTV(): boolean;
 	get hardware(): DeviceHardware;
 	get highEntropyValues(): HighEntropyValues;
 	get isIOS(): boolean;
@@ -42,12 +44,14 @@ export declare class DeviceChecker implements Checker {
 	get isWindows(): boolean;
 	get isLinux(): boolean;
 	get isMobile(): boolean;
+	get isTablet(): boolean;
 	get iOSVersion(): number | undefined;
 	detect(): void;
 	private detectHardware;
 	detectGpu(): Promise<void>;
 	private requestGpuInfo;
 	private detectHighEntropyValues;
+	private detectSmartTv;
 	private detectDevice;
 	private detectOS;
 	private normalizeOSName;

package/types/utils/ClientChecker/types/userAgentData.d.ts

@@ -19,6 +19,7 @@ export declare enum UADataPlatform {
 }
 export interface HighEntropyValues {
 	mobile?: boolean;
+	formFactors?: string[];
 	model?: string;
 	platform?: UADataPlatform;
 	platformVersion?: string;
@@ -27,7 +28,8 @@ export interface HighEntropyValues {
 	brands?: UADataBrandItem[];
 }
 export type NavigatorWithUserAgentData = Navigator & {
-	userAgentData: {
-		getHighEntropyValues: (values: Array<string>) => HighEntropyValues;
+	userAgentData?: {
+		mobile?: boolean;
+		getHighEntropyValues?: (values: Array<string>) => Promise<HighEntropyValues>;
 	};
 };

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/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 */
@@ -282,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;
@@ -310,6 +331,8 @@ export type ITuningConfig = {
 		*/
 		recoverStuckSegmentLoading: boolean;
 		skipReloadOfFullyBufferedPartiallyEjectedSegments: boolean;
+		/** В Safari ждёт завершения append init-сегмента после abort перед выполнением remove. */
+		deferRemoveUntilAbortCompletes: boolean;
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -369,6 +392,8 @@ export type ITuningConfig = {
 	};
 	enableWakeLock: boolean;
 	enableTelemetryAtStart: boolean;
+	/** Список user-happiness-триггеров, включённых для отправки в tracer. Пустой список отключает их. */
+	userHappinessTriggers: UserHappinessTrigger[];
 	forceFormat: VideoFormat | undefined;
 	formatsToAvoid: VideoFormat[];
 	disableChromecast: 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[];