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

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

@@ -0,0 +1,47 @@
+import type { Byte } from "@vkontakte/videoplayer-shared";
+import { VideoQuality } from "@vkontakte/videoplayer-shared";
+import type { IChunkDownloadRecord } from "./chunkDownloadHistory";
+/**
+* Контракт модели PPO ABR, версия артефакта 22.10 (карточка модели — Confluence
+* pageId=2177405140). Константы зашиты в .tflite и конфигурироваться не могут.
+*/
+export declare const ML_ABR_ACTIONS = 8;
+export declare const ML_ABR_HISTORY = 24;
+/** Горизонт размеров будущих чанков (v22.10): 4 чанка вперёд на качество. */
+export declare const ML_ABR_FOREHORON = 4;
+/** Лестница модели: индекс массива — индекс действия артефакта. */
+export declare const ML_ABR_LADDER: readonly VideoQuality[];
+export declare const ladderIndexOfQuality: (quality: VideoQuality) => number;
+export interface IMlAbrInputSource {
+	/** История загрузок, от старых к новым; длиннее H — берутся последние H. */
+	history: readonly IChunkDownloadRecord[];
+	/** Размеры будущих чанков по качествам лестницы (F=4, от следующего); оценка в байтах уже подставлена правилом. */
+	nextChunkSizes: ReadonlyMap<VideoQuality, readonly Byte[]>;
+	/** Доступные качества: лестница ∩ внешние лимиты. Вход маски модели. */
+	availableQualities: ReadonlySet<VideoQuality>;
+	/** Заполненность буфера в секундах, до преобразования speed. */
+	bufferSeconds: number;
+	/** Флаг размера буфера: 0 → 70 с, 1 → 120 с. */
+	bufferFlag: 0 | 1;
+	/** Доля оставшегося видео: remaining / total. */
+	remainingRatio: number;
+	/** playbackRate: v22.10 поддерживает ≠1 двумя преобразованиями (buffer/speed, download×speed). */
+	playbackRate: number;
+}
+export interface IMlAbrModelInput {
+	/** [H] измеренная полоса чанка, Mbps/10. */
+	readonly throughput: Float32Array;
+	/** [H] время загрузки чанка, с/10 (уже ×speed). */
+	readonly download: Float32Array;
+	/** [A×H] one-hot история выборов. */
+	readonly actionHistory: Float32Array;
+	/** [A×F] размеры будущих чанков, байт/1e6. */
+	readonly chunkSizes: Float32Array;
+	/** [A×H] размеры скачанных чанков, байт/1e6. */
+	readonly prevChunkSizes: Float32Array;
+	/** [A] маска доступности, строго 0/1. */
+	readonly actionMask: Float32Array;
+	/** [3] buffer_s (÷speed), buffer_flag, remaining/total. */
+	readonly actorScalars: Float32Array;
+}
+export declare const buildMlAbrModelInput: (source: IMlAbrInputSource) => IMlAbrModelInput;

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

@@ -0,0 +1,57 @@
+import type { IMlAbrModelInput } from "./modelInput";
+import type { TMlAbrWorkerResponse } from "./workerProtocol";
+export declare enum MlAbrRuntimeStatus {
+	NotStarted = "not_started",
+	InProgress = "in_progress",
+	Completed = "completed",
+	Failed = "failed"
+}
+export interface IMlAbrDecision {
+	/** Индекс качества в лестнице модели. */
+	qualityIndex: number;
+	/** Вероятности по действиям; для телеметрии (top-3). */
+	probs: Float32Array;
+}
+interface IMinimalWorker {
+	onmessage: ((event: MessageEvent<TMlAbrWorkerResponse>) => void) | null;
+	postMessage(message: unknown, transfer?: Transferable[]): void;
+	terminate(): void;
+}
+export interface IMlAbrWorkerClientDeps {
+	/** Точка подмены в тестах; в проде — глобальный fetch. */
+	fetch?: typeof fetch;
+	/** Точка подмены в тестах; в проде — глобальный Worker. */
+	Worker?: new (workerUrl: string) => IMinimalWorker;
+}
+export interface IMlAbrWorkerClientOptions {
+	/** URL артефакта worker.js на CDN (версионируемый путь — ручка экспериментов). */
+	workerJsUrl: string;
+	/** Байты модели: instance-провайдер или fetch гостевого URL; null — источника нет. */
+	model: Promise<ArrayBuffer | null>;
+	/** Каталог litert-артефакта; оттуда параллельно префетчатся iife и wasm. */
+	litertWasmUrl?: string;
+	/** Таймаут от создания до init-result; превышение гасит воркер. */
+	initTimeoutMs?: number;
+	deps?: IMlAbrWorkerClientDeps;
+}
+export interface IMlAbrWorkerClient {
+	readonly status: MlAbrRuntimeStatus;
+	readonly failureReason: string | undefined;
+	/** Резолвится после init-result; отказ — исключением с причиной. */
+	readonly ready: Promise<void>;
+	predict(input: IMlAbrModelInput): Promise<IMlAbrDecision>;
+	destroy(): void;
+}
+/**
+* Клиент воркера: все сетевые заходы стартуют ПАРАЛЛЕЛЬНО с момента
+* создания — код воркера, litert iife, wasm-бинарь (10+ МБ — главный
+* полюс, вариант выбирается той же пробой relaxedSimd, что у loadLiteRt)
+* и модель. Воркер собирается из уже скачанного кода через blob, получает
+* всё предзагруженное первым сообщением и не ходит в сеть сам.
+*
+* Статусная машина вместо исключений: конвейер ABR синхронен, любую
+* неготовность превращает в воздержание правила; причина отказа — строкой
+* в debug-лог. Артефакты кросс-доменные — fetch требует CORS на CDN-ресурсе.
+*/
+export declare const createMlAbrWorkerClient: (options: IMlAbrWorkerClientOptions) => IMlAbrWorkerClient;
+export {};

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

@@ -0,0 +1,67 @@
+import type { IMlAbrModelInput } from "./modelInput";
+/**
+* Протокол воркера ML ABR (артефакт uvp-deps на CDN, репозиторий
+* uvp-deps — источник правды схемы). Контракт зеркалируется типами сюда:
+* SDK не зависит от пакета воркера, расхождение ловится интеграционным
+* прогоном, а не типами.
+*
+* Один init (модель transferable), затем поток predict. Ответы несут id
+* запроса: порядок predict'ов не гарантирован, потребитель сверяется по id.
+* Массивы входа передаются transferable — после отправки буферы
+* отсоединены, пересозданием занимается отправитель (построитель входов
+* собирает свежие массивы на каждый цикл).
+*/
+export declare const ML_ABR_WORKER_PROTOCOL_VERSION = 1;
+export interface IMlAbrInitMessage {
+	type: "init";
+	id: number;
+	/** Байты .tflite-артефакта; воркер забирает буфер transferable. */
+	model: ArrayBuffer;
+	/** Код iife-сборки litert, предзагруженный клиентом параллельно; без него — litertJsUrl. */
+	litertJsCode?: string;
+	/** Байты wasm-бинаря; воркер резолвит их через blob и locateFile. */
+	litertWasmBytes?: ArrayBuffer;
+	/** Fallback: URL iife-сборки LiteRT, если код не предзагружен. */
+	litertJsUrl?: string;
+	/** Каталог wasm-бинарёй: оттуда loadLiteRt берёт .js-лоадер (кэш прогрет префетчем клиента). */
+	litertWasmUrl?: string;
+}
+export interface IMlAbrPredictMessage {
+	type: "predict";
+	id: number;
+	input: IMlAbrModelInput;
+}
+export interface IMlAbrDestroyMessage {
+	type: "destroy";
+}
+export type TMlAbrWorkerRequest = IMlAbrInitMessage | IMlAbrPredictMessage | IMlAbrDestroyMessage;
+export interface IMlAbrInitOk {
+	type: "init-result";
+	id: number;
+	ok: true;
+	protocolVersion: typeof ML_ABR_WORKER_PROTOCOL_VERSION;
+	/** Фактические имена входов артефакта (args_N или семантические). */
+	inputNames: string[];
+}
+export interface IMlAbrInitFail {
+	type: "init-result";
+	id: number;
+	ok: false;
+	reason: string;
+}
+export interface IMlAbrPredictOk {
+	type: "predict-result";
+	id: number;
+	ok: true;
+	/** Индекс качества в лестнице модели. */
+	qualityIndex: number;
+	/** Вероятности по действиям; transferable обратно. */
+	probs: Float32Array;
+}
+export interface IMlAbrPredictFail {
+	type: "predict-result";
+	id: number;
+	ok: false;
+	reason: string;
+}
+export type TMlAbrWorkerResponse = IMlAbrInitOk | IMlAbrInitFail | IMlAbrPredictOk | IMlAbrPredictFail;

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

@@ -12,7 +12,8 @@ export declare abstract class BaseRule<
 	readonly activePhases: ReadonlySet<AbrPhase>;
 	protected subscription: Subscription;
 	protected type: RuleType;
-	protected name: string;
+	/** Имя правила: публично — AbrManager фильтрует набор по именам в ML-режиме. */
+	name: string;
 	protected confidence: RuleConfidence;
 	constructor(phaseConfig: RulePhaseConfig);
 	init(_initContext: IRuleInitContext): void;

package/types/providers/utils/Abr/rules/video/mlAbrRule.d.ts

@@ -0,0 +1,52 @@
+import type { IAbrRule, IAbrRuleResolution, IRuleInitContext, IVideoAbrContext, RuleLogData } from "../../types";
+import type { IVideoTrack } from "../../../../../player/types";
+import { LimitAboveRule } from "../limitAboveRule";
+import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
+import { type IMlAbrDecision } from "../../mlAbr/workerClient";
+export type MlAbrModelSource = "getModels" | "guest";
+/**
+* Голос модели в конвейере. Синхронный контракт execute сохранён: инференс
+* асинхронный, результат живёт в кэше с dirty-флагом, пересчёт запускается
+* мимо execute. До готовности и при любом отказе правило голосует воздержанием —
+* конвейер работает на классическом наборе.
+*/
+export declare class MlAbrRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
+	private initContext;
+	private history;
+	private modelResolver;
+	private modelSource;
+	private runtime;
+	private decision;
+	private decisionDirty;
+	private predictInFlight;
+	private lastLoggedStatus;
+	private decisionOwner;
+	constructor(phaseConfig: RulePhaseConfig);
+	/** Владелец решения: конвейер гасит Throughput/Bola, пока модель реально голосует. */
+	isDecisionOwner(): boolean;
+	init(initContext: IRuleInitContext): void;
+	destroy(): void;
+	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
+	protected createLogData(selectedTrack: IVideoTrack, decision: IMlAbrDecision | undefined, sizesEstimated: boolean | undefined, warmup: number, abstainReason: string | undefined): RuleLogData;
+	private lastSizesEstimated;
+	private modelSourceOf;
+	private warmupOf;
+	private warmupFallback;
+	/** Гейты входа в ML-режим (PRD «Steady модели»); undefined — можно голосовать. */
+	private abstainReason;
+	/**
+	* «Сначала байты, потом чанк»: рантайм (и его dynamic import) не трогается,
+	* пока байты модели не в руках. Провайдер → null и нет guestUrl → вообще
+	* ничего не грузим, правило навсегда воздерживается.
+	*/
+	private ensureModelLoaded;
+	private maybePredict;
+	private buildInputSource;
+	private nextSizesOf;
+	private isWithinLimits;
+	private trackOfQuality;
+	/** remaining/total требует позиции плейхеда; ближайшая оценка — левый край окна сегментов. */
+	private approxPlayedMs;
+	/** Наблюдаемость (требование тикета): переходы состояний — в debug-лог, дубли не пишем. */
+	private logState;
+}

package/types/providers/utils/Abr/rules/video/stallsRule.d.ts

@@ -1,23 +1,21 @@
 import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
-import type { Kbps, Nullable } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
-import type { ITuningConfig } from "../../../../../utils/tuningConfig";
 import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
-type StallLogsArgs = [forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig];
-export declare class StallsRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, StallLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
-	private severeStallOccurred;
-	private qualityRestrictionTimer;
-	private lastStallDurationRestriction;
+export declare class StallsRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, []> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
+	private wasSevereStall;
+	private restrictedInCurrentStall;
+	private stalledQuality;
+	private stallsByQuality;
+	private recoveryStartedAt;
 	private maxQualityLimitOnStall;
-	private predictedThroughputWithoutData;
 	private restrictionTracer;
 	private restrictionStartedAt;
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogData(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig): RuleLogData;
+	protected createLogData(selectedTrack: IVideoTrack): RuleLogData;
+	private trackStallEpisode;
+	private resolveQualityLimit;
 	private traceRestrictionSet;
 	private traceRestrictionReset;
-	private updateStallQualityLimits;
 }
-export {};

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/providers/utils/StallsManager.d.ts

@@ -1,9 +1,8 @@
-import type { ExactVideoQuality, IObservable, IValueSubject, Milliseconds, Kbps, Seconds } from "@vkontakte/videoplayer-shared";
+import type { IObservable, IValueSubject, Milliseconds, Seconds } from "@vkontakte/videoplayer-shared";
 import type { IVideoTrack } from "../../player/types";
 import type { ITuningConfig } from "../../utils/tuningConfig";
 interface IConnectData {
 	videoLastDataObtainedTimestamp$: IValueSubject<Milliseconds>;
-	throughput$: IValueSubject<number>;
 	rtt$: IValueSubject<Milliseconds>;
 	isBuffering$: IObservable<boolean>;
 	isSeeked$: IObservable<boolean>;
@@ -18,7 +17,6 @@ interface IConnectData {
 declare class StallsManager {
 	private currentStallDuration$;
 	private videoLastDataObtainedTimestamp$;
-	private throughput$;
 	private rtt$;
 	private tuning;
 	private abrParams;
@@ -26,20 +24,15 @@ declare class StallsManager {
 	private isSeeked$;
 	private isBuffering$;
 	private isPaused;
-	private maxQualityLimit;
 	private lastUniqueVideoTrackSelected;
 	private currentStallsCount;
 	private sumStallsDuration;
 	private lastStallDuration;
 	private providerStartWatchingTimestamp;
 	private lastUniqueVideoTrackSelectedTimestamp;
-	private predictedThroughputWithoutData;
-	private qualityRestrictionTimer;
 	private subscription;
 	severeStallOccurred$: IValueSubject<boolean>;
 	init(data: IConnectData): void;
-	get videoMaxQualityLimit(): ExactVideoQuality | undefined;
-	get predictedThroughput(): Kbps;
 	get abrTuningParams(): ITuningConfig["autoTrackSelection"];
 	set lastVideoTrackSelected(lastUniqueVideoTrackSelected: IVideoTrack);
 	destroy(): void;

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/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>;