@vkontakte/videoplayer-core 2.0.160-dev.ff8ccb48.0 → 2.0.161-beta.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.160-dev.ff8ccb48.0",
+  "version": "2.0.161-beta.0",
   "author": "vk.com",
   "description": "Videoplayer core library based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -42,6 +42,6 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "1.0.89-dev.ff8ccb48.0"
+    "@vkontakte/videoplayer-shared": "1.0.90-beta.0"
   }
 }

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

@@ -18,6 +18,7 @@ type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
 	failedVideoTrack?: Nullable<IVideoTrack>;
+	isOnDemand?: boolean;
 };
 export default abstract class BaseDashProvider implements IProvider {
 	scene3D: Scene3D | undefined;

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

@@ -33,6 +33,7 @@ export declare class BufferManager {
 	playingRepresentationInit$: IValueSubject<CommonInit | undefined>;
 	error$: ISubject<IError>;
 	gaps: Gap[];
+	updateEnd$: IValueSubject<void>;
 	private subscription;
 	private kind;
 	private initData;

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

@@ -22,6 +22,9 @@ export interface IParams {
 	compatibilityMode?: boolean;
 	tracer: ITracer;
 	useEnableSubtitlesParam?: boolean;
+	handleExtendedNetworkErrorsSet?: boolean;
+	useUrlCacheMechanism?: boolean;
+	measureNonSegmentRequests?: boolean;
 }
 export type Priority = "high" | "low" | "auto";
 export interface FetchParamsWithUrl extends FetchParams {
@@ -38,6 +41,7 @@ export interface FetchParams {
 	isLowLatency?: boolean;
 	bufferOptimisation?: boolean;
 	ignoreNetworkErrors?: boolean;
+	urlCacheMechanismEnabled?: boolean;
 }
 export type RepresentationFetchResult = {
 	init: CommonInit | null;
@@ -63,9 +67,13 @@ export declare class Fetcher {
 	private readonly subscription;
 	private compatibilityMode;
 	private useEnableSubtitlesParam;
+	private useUrlCacheMechanism;
+	private measureNonSegmentRequests;
+	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam }: IParams);
+	private handleExtendedNetworkErrorsSet;
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processPerformanceResourceTiming;

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

@@ -19,6 +19,7 @@ export interface Params {
 	compatibilityMode?: boolean;
 	forceVideoCodec?: VideoCodec;
 	tracer: ITracer;
+	isOnDemand: boolean;
 }
 export declare class Player {
 	private element;
@@ -81,6 +82,7 @@ export declare class Player {
 	private stallWatchdogSubscription;
 	private livePauseWatchdogSubscription;
 	private liveWasInterrupted;
+	private isOnDemand;
 	private destroyController;
 	constructor(params: Params);
 	initManifest: ReturnType<typeof abortable<[HTMLVideoElement, string, number]>>;
@@ -113,4 +115,6 @@ export declare class Player {
 	* Возвращает duration в милисекундах.
 	*/
 	calculateDurationFromSegments(): number;
+	private isAnyBufferUpdating;
+	updateSourceDurationFromSegments(): void;
 }

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

@@ -0,0 +1,9 @@
+import type { IError, ISubject } from "@vkontakte/videoplayer-shared";
+type Params = {
+	txtCode: string;
+	error$: ISubject<IError>;
+	recoverableError$: ISubject<IError>;
+	httpCode?: number | undefined;
+};
+export declare const processNetworkErrors: ({ txtCode, error$, recoverableError$, httpCode }: Params) => void;
+export {};

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

@@ -0,0 +1,23 @@
+export type CacheManager = {
+	get: () => Promise<Response | null>;
+	set: (response: Response) => void;
+};
+/**
+* Пытаемся добиться кэширования вызовов.
+* Сейчас есть проблема, что expires и sig меняются, хотя контент не меняется, поэтому ходим мимо кэша.
+* Из за этого обрабатываем кэш вручную.
+*/
+export declare const createCacheManager: (url: string) => Promise<CacheManager>;
+export declare function canUseCacheApi(): boolean;
+export declare function normalizeUrl(url: string): string;
+/**
+* Проверяет, не просрочен ли кэшированный ответ
+*/
+export declare function isResponseExpired(response: Response): boolean;
+export declare function cloneResponse(response: Response, url: string): Response;
+/**
+* Извлекает expires из оригинального URL (параметр expires1)
+* Предполагается, что expires1 — timestamp в секундах
+*/
+export declare function getExpiresFromUrl(url: string): number;
+export declare const dropUrlsCache: () => Promise<void>;

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

@@ -18,6 +18,7 @@ type IParams = IProviderParams<IDashURLSource> & {
 	sourceHls?: IHLSSource;
 	forceVideoCodec?: VideoCodec;
 	failedVideoTrack?: Nullable<IVideoTrack>;
+	isOnDemand?: boolean;
 };
 export default abstract class BaseDashProvider implements IProvider {
 	scene3D: Scene3D | undefined;

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

@@ -1,6 +1,7 @@
-import type { IError, IRange, ISubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { IError, IRange, ISubject, IValueSubject, Milliseconds } from "@vkontakte/videoplayer-shared";
 export declare class NativeBufferManager {
 	error$: ISubject<IError>;
+	updateEnd$: IValueSubject<void>;
 	private mediaSource;
 	private sourceBuffer;
 	private sourceBufferTaskQueue;

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

@@ -32,10 +32,11 @@ export interface IVirtualBufferManager<T extends Segment = Segment> {
 	getForwardBufferRepresentations(currentPosition?: Milliseconds): Map<Representation["id"], T[]>;
 	getForwardPlaybackBufferDuration(currentPosition?: Milliseconds): Milliseconds;
 	getPlaybackBufferState(): IRange<Milliseconds> | null;
+	getMutexInfo(): string;
 	setTarget(time: Milliseconds): void;
 	setPreloadOnly(preloadOnly: boolean): void;
 	findSegmentStartTime(position: Milliseconds): Milliseconds | undefined;
-	calculateDurationFromSegments(representationId: Representation["id"]): Milliseconds;
+	calculateDurationFromSegments(): Milliseconds;
 	destroy(): void;
 	get lastDataObtainedTimestamp(): Milliseconds;
 }

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

@@ -59,7 +59,6 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	startWith: ReturnType<typeof abortable<[Representation["id"]]>>;
 	switchTo(newRepresentationId: Representation["id"], mode?: SwithRepresentationMode): Promise<void>;
 	protected getSwitchWithAbort(): ReturnType<typeof abortable<[Representation["id"], SwithRepresentationMode], void>>;
-	switchToOld: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
 	prepareSeek(): Promise<void>;
 	seek(position: Milliseconds | undefined): Promise<void>;
 	maintain(currentPosition?: Milliseconds | undefined): Promise<void>;
@@ -69,7 +68,8 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	abort(): Promise<void>;
 	findSegmentStartTime(position: Milliseconds): Milliseconds | undefined;
 	getRepresentationInitialTime(): Seconds;
-	calculateDurationFromSegments(representationId: Representation["id"]): Milliseconds;
+	getMutexInfo(): string;
+	calculateDurationFromSegments(): Milliseconds;
 	get lastDataObtainedTimestamp(): Milliseconds;
 	setTarget(time: Milliseconds): void;
 	setPreloadOnly(preloadOnly: boolean): void;

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

@@ -22,6 +22,9 @@ export interface IParams {
 	compatibilityMode?: boolean;
 	tracer: ITracer;
 	useEnableSubtitlesParam?: boolean;
+	handleExtendedNetworkErrorsSet?: boolean;
+	useUrlCacheMechanism?: boolean;
+	measureNonSegmentRequests?: boolean;
 }
 export type Priority = "high" | "low" | "auto";
 export interface FetchParamsWithUrl extends FetchParams {
@@ -37,6 +40,7 @@ export interface FetchParams {
 	measureThroughput?: boolean;
 	isLowLatency?: boolean;
 	bufferOptimisation?: boolean;
+	urlCacheMechanismEnabled?: boolean;
 }
 export type RepresentationFetchResult<T extends Segment> = {
 	initMetadata: CommonInit | null;
@@ -62,9 +66,13 @@ export declare class Fetcher {
 	private subscription;
 	private compatibilityMode;
 	private useEnableSubtitlesParam;
+	private useUrlCacheMechanism;
+	private measureNonSegmentRequests;
+	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam }: IParams);
+	private handleExtendedNetworkErrorsSet;
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processResourceTiming;

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

@@ -70,9 +70,10 @@ export declare abstract class BasePlayer {
 	videoLastDataObtainedTimestamp$: IValueSubject<Milliseconds>;
 	fetcherRecoverableError$: Subject<IError>;
 	fetcherError$: Subject<IError>;
+	private isOnDemand;
 	protected constructor(params: Params);
 	protected abstract prepareManifestUrlString(manifestBaseUrlString: string, offset: number): string;
-	protected abstract setSourceDuration(): void;
+	protected abstract setSourceInitDuration(): void;
 	protected abstract restoreAfterDeepStall(stallTraceAttributes: Record<string, number>): Promise<void>;
 	initRepresentations: ReturnType<typeof abortable<[Representation["id"], Representation["id"] | undefined, IHLSSource | undefined]>>;
 	initManifest(element: HTMLVideoElement, manifestBaseUrlString: string, offset: number): Promise<void>;
@@ -81,7 +82,6 @@ export declare abstract class BasePlayer {
 	seek(requestedPosition: Milliseconds, forcePrecise?: boolean): Promise<void>;
 	warmUpMediaSourceIfNeeded(position?: Milliseconds | undefined): void;
 	getForwardBufferRepresentations(kind: Exclude<StreamKind, StreamKind.TEXT>): Map<Representation["id"], Segment[]> | undefined;
-	calculateDurationFromSegments(representationId: Representation["id"]): Milliseconds;
 	get isStreamEnded(): boolean;
 	getStreams(): Manifest["streams"] | undefined;
 	getCodecs(): Manifest["codecs"] | undefined;
@@ -89,6 +89,9 @@ export declare abstract class BasePlayer {
 	setPreloadOnly(preloadOnly: boolean): void;
 	stop(): void;
 	destroy(): void;
+	updateSourceDurationFromSegments(): void;
+	calculateDurationFromBuffersSegments(): Milliseconds;
+	private isAnyBufferUpdating;
 	protected get isStreamNotOpen(): boolean;
 	protected reinitDecoderIfNeeded(force?: boolean): Promise<void>;
 	protected stallWatchdogIntervalCallback(): Promise<void>;

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

@@ -18,7 +18,7 @@ export declare class LivePlayer extends BasePlayer {
 	initBuffer(): void;
 	protected forcePositionToRepresentationInitialTime(): Promise<void>;
 	protected tick(): Promise<void>;
-	protected setSourceDuration(): void;
+	protected setSourceInitDuration(): void;
 	protected isStallExceeded(timeInWaiting: Milliseconds): boolean;
 	protected restoreAfterDeepStall(stallTraceAttributes: Record<string, number>): Promise<void>;
 	protected updateManifest(): Promise<Manifest | null>;

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

@@ -4,7 +4,7 @@ export declare class Player extends BasePlayer {
 	constructor(params: Params);
 	protected prepareManifestUrlString(manifestBaseUrlString: string, _offset: number): string;
 	protected initRepresentationSubscriptions(): void;
-	protected setSourceDuration(): void;
+	protected setSourceInitDuration(): void;
 	protected restoreAfterDeepStall(stallTraceAttributes: Record<string, number>): Promise<void>;
 	protected initDisableStallWatchdogSubscription(): void;
 	protected initEndOfVideoSubscription(): void;

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

@@ -14,4 +14,5 @@ export interface Params {
 	compatibilityMode?: boolean;
 	forceVideoCodec?: VideoCodec;
 	tracer: ITracer;
+	isOnDemand?: boolean;
 }

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

@@ -0,0 +1,9 @@
+import type { IError, ISubject } from "@vkontakte/videoplayer-shared";
+type Params = {
+	txtCode: string;
+	error$: ISubject<IError>;
+	recoverableError$: ISubject<IError>;
+	httpCode?: number | undefined;
+};
+export declare const processNetworkErrors: ({ txtCode, error$, recoverableError$, httpCode }: Params) => void;
+export {};

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

@@ -0,0 +1,22 @@
+export type CacheManager = {
+	get: () => Promise<Response | null>;
+	set: (response: Response) => Promise<void>;
+};
+/**
+* Пытаемся добиться кэширования вызовов.
+* Сейчас есть проблема, что expires и sig меняются, хотя контент не меняется, поэтому ходим мимо кэша.
+* Из за этого обрабатываем кэш вручную.
+*/
+export declare const createCacheManager: (url: string) => Promise<CacheManager>;
+export declare function canUseCacheApi(): boolean;
+export declare function normalizeUrl(url: string): string;
+/**
+* Проверяет, не просрочен ли кэшированный ответ
+*/
+export declare function isResponseExpired(response: Response): boolean;
+export declare function cloneResponse(response: Response, url: string): Response;
+/**
+* Извлекает expires из оригинального URL (параметр expires1)
+* Предполагается, что expires1 — timestamp в секундах
+*/
+export declare function getExpiresFromUrl(url: string): number;

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

@@ -1,6 +1,8 @@
 import type { IHLSSource } from "../../player/types";
 import type { IProvider, IProviderParams } from "../types";
-type Params = IProviderParams<IHLSSource>;
+type Params = IProviderParams<IHLSSource> & {
+	isOnDemand: boolean;
+};
 export default class HlsProvider implements IProvider {
 	private subscription;
 	private volumeSubscription;
@@ -16,7 +18,7 @@ export default class HlsProvider implements IProvider {
 	private subscribe;
 	destroy(): void;
 	private prepare;
-	private playIfAllowed;
+	protected playIfAllowed(): void;
 	private seek;
 	private syncPlayback;
 }

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

@@ -13,7 +13,7 @@ export default class MpegProvider implements IProvider {
 	private subscribe;
 	destroy(): void;
 	private prepare;
-	private playIfAllowed;
+	protected playIfAllowed(): void;
 	private seek;
 	private syncPlayback;
 	private handleQualityLimitTransition;

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

@@ -19,7 +19,11 @@ interface IParams extends IProviderDependencies {
 export default class ProviderContainer implements IProviderContainer {
 	current$: IValueSubject<IProviderEntry>;
 	providerError$: ISubject<IError>;
-	noAvailableProvidersError$: ISubject<VideoFormat | undefined>;
+	noAvailableProvidersError$: ISubject<{
+		forced?: VideoFormat;
+		input: VideoFormat[];
+		supported: VideoFormat[];
+	}>;
 	volumeMultiplierError$: ISubject<IError>;
 	providerOutput: IProviderOutput;
 	private subscription;

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

@@ -4,7 +4,11 @@ import type { IProvider, IProviderOutput } from "../types";
 export interface IProviderContainer {
 	current$: IValueObservable<IProviderEntry>;
 	providerError$: ISubject<IError>;
-	noAvailableProvidersError$: ISubject<VideoFormat | undefined>;
+	noAvailableProvidersError$: ISubject<{
+		forced?: VideoFormat;
+		input: VideoFormat[];
+		supported: VideoFormat[];
+	}>;
 	volumeMultiplierError$: ISubject<IError>;
 	providerOutput: IProviderOutput;
 	init(): void;

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

@@ -3,10 +3,67 @@ import type { IVideoTrack } from "../../../../../player/types";
 import type { Nullable, QualityLimits, VideoQuality } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality } from "@vkontakte/videoplayer-shared";
 import { LimitAboveRule } from "../limitAboveRule";
-type UpperLimitsLogsArgs = [limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, visible: boolean, limits: QualityLimits, backgroundVideoQualityLimit: VideoQuality];
+type UpperLimitsLogsArgs = [limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, visible: boolean, limits: QualityLimits, backgroundVideoQualityLimit: VideoQuality, effectiveType: string | undefined, connectionDataQualityLimit: ExactVideoQuality | undefined];
+/**
+* Правило верхнего ограничения качества в авто-ABR. Из списка `videoTracksDesc`
+* (отсортирован от высшего к низшему) выбирает самый высокий трек, который
+* одновременно удовлетворяет ВСЕМ активным лимитам сверху. Если подходящего
+* нет — возвращает минимально доступный трек (graceful fallback).
+*
+* Источники лимитов сверху (действуют совместно, победитель — самый строгий):
+*
+* 1. `context.limits.max` — явный пользовательский/интеграционный лимит.
+*    Приходит из публичного API `Player.setAutoQualityLimits({ max, min })`
+*    (см. `packages/core/src/player/Player.ts`). Слой UI/интеграция пробрасывает
+*    его в `desiredState.autoVideoTrackLimits` → `AbrManager.updateContext({ limits })`
+*    → `IVideoAbrContext.limits`. `undefined` в `limits` или `limits.max` снимает
+*    лимит. Значение типа `ExactVideoQuality` (например, '720p'), трактуется
+*    включительно (`<=`). Если лимиты невалидны (min > max, либо min выше
+*    highestAvailable, либо max ниже lowestAvailable) — см. `areLimitsInvalid` —
+*    лимит игнорируется целиком, чтобы не заблокировать воспроизведение.
+*
+*    Реальные кейсы:
+*    - Пользователь в настройках плеера выбрал пресет «Экономия трафика»
+*      (`PredefinedQualityLimits.TRAFFIC_SAVING`) — хост передаёт
+*      `{ max: tuning.autoTrackSelection.trafficSavingLimit }` (Q_480P).
+*    - Хост-приложение (мини-апп ВК, лента) ограничивает качество для
+*      превью/фонового воспроизведения.
+*    - A/B-эксперимент или бизнес-правило режет качество для конкретной
+*      категории видео / региона / тарифа.
+*
+* 2. `tuning.autoTrackSelection.backgroundVideoQualityLimit` — применяется
+*    только когда `context.visible === false` (плеер вне viewport, по данным
+*    `elementVisible$` из `observeElementVisibility`, порог — `activeVideoAreaThreshold`).
+*
+*    Реальные кейсы: автовоспроизведение в ленте при прокрутке мимо плеера,
+*    PiP/мини-плеер в фоне, неактивная вкладка.
+*
+* 3. `effectiveType` из Network Information API (`navigator.connection`).
+*    Активируется `tuning.dash.useConnectionDataUpperLimit`.
+*    Приоритет разрешения в `connectionDataQualityLimit`:
+*      a. `effectiveType ∈ {'2g', 'slow-2g'}` → `tuning.dash.saveData2gQualityLimit`
+*         (Q_360P) — жёсткий лимит на очень слабой сети.
+*      b. `effectiveType === '3g'` → `tuning.dash.saveData3gQualityLimit` (Q_480P).
+*      c. Иначе — без ограничения.
+*
+*    Network Information API доступен только в Chromium (Android, десктоп Chrome/Edge/
+*    Opera/Samsung Internet, Android WebView). В Firefox, Safari и Chrome iOS
+*    (WebKit) `navigator.connection === undefined` — этот источник лимита
+*    неактивен, правило работает только по п.1 и п.2.
+*
+*    Реальные кейсы: пользователь в метро / зоне слабого сигнала, пользователь
+*    на edge/3G-тарифе.
+*
+* Все три источника комбинируются операцией AND: трек проходит, если
+* `fitsLimits && fitsBackgroundVideoQualityLimit && fitsSaveDataLimit`. Поэтому
+* итоговый потолок = минимум из активных. Нижнюю границу закрывает
+* `LowerLimitRule` (поле `limits.min` здесь не используется).
+*/
 export declare class UpperLimitsRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, UpperLimitsLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(confidence: RuleConfidence);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, visible: boolean, limits: QualityLimits, backgroundVideoQualityLimit: VideoQuality): string;
+	protected createLogMessage(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, visible: boolean, limits: QualityLimits, backgroundVideoQualityLimit: VideoQuality, effectiveType: string | undefined, connectionDataQualityLimit: ExactVideoQuality | undefined): string;
+	private getConnection;
+	private resolveConnectionDataQualityLimit;
 }
 export {};

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

@@ -3,9 +3,11 @@ export interface IStatefulIterator<T> {
 	getValue(): T;
 	isCompleted(): boolean;
 	isLast(): boolean;
+	all(): T[];
 }
 export declare class StatefulIterator<T> implements IStatefulIterator<T> {
 	private readonly length;
+	private array;
 	private index;
 	private iterator;
 	private current;
@@ -14,4 +16,5 @@ export declare class StatefulIterator<T> implements IStatefulIterator<T> {
 	getValue(): T;
 	isCompleted(): boolean;
 	isLast(): boolean;
+	all(): T[];
 }

package/types/utils/ThroughputEstimator.d.ts

@@ -19,7 +19,9 @@ declare class ThroughputEstimator {
 	*/
 	addRawThroughput(rate: Kbps): void;
 	addRawRtt(time: Milliseconds): void;
-	private static sanityCheck;
-	private static load;
+	private sanityCheck;
+	private static loadStored;
+	private static writeStored;
+	private static validateStored;
 }
 export default ThroughputEstimator;

package/types/utils/tuningConfig.d.ts

@@ -2,7 +2,7 @@ import type { VideoCodec, VideoFormat } from "../player/types";
 import { WebmCodecStrategy } from "../enums/WebmCodecStrategy";
 import { AndroidPreferredFormat } from "../enums/AndroidPreferredFormat";
 import { IOSPreferredFormat } from "../enums/IOSPreferredFormat";
-import type { Byte, Milliseconds, RecursivePartial, Seconds } from "@vkontakte/videoplayer-shared";
+import type { Byte, Kbps, Milliseconds, RecursivePartial, Seconds } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality, VideoQuality } from "@vkontakte/videoplayer-shared";
 import { AudioRuleName, VideoRuleName } from "../providers/utils/Abr/types";
 export type ITuningConfig = {
@@ -33,6 +33,9 @@ export type ITuningConfig = {
 		basisTrendChangeCount: number;
 		changeThreshold: number;
 		useBrowserEstimation: boolean;
+		initialThroughput: Kbps;
+		measureNonSegmentRequests: boolean;
+		smallSampleMinDuration: Milliseconds;
 		rttPenaltyRequestSize: Byte;
 		streamMinSampleSize: Byte;
 		streamMinSampleTime: Milliseconds;
@@ -42,6 +45,24 @@ export type ITuningConfig = {
 			continuesByteSequenceInterval: Milliseconds;
 			maxLastEvaluationTimeout: Milliseconds;
 		};
+		/**
+		* TTL + проверка типа сети для кешированного throughput из localStorage.
+		* При включении: если сохранённое значение старше storedThroughputTtlMs
+		* или тип сети изменился (Wi-Fi→3G) — значение отбрасывается.
+		* Предотвращает старт в 4K при переходе с Wi-Fi на мобильную сеть.
+		*
+		* При 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.
+		*/
+		storedThroughputTtlMs: Milliseconds;
 	};
 	autoTrackSelection: {
 		bitrateFactorAtEmptyBuffer: number;
@@ -127,6 +148,8 @@ export type ITuningConfig = {
 		useNewRepresentationSwitch: boolean;
 		useDelayedRepresentationSwitch: boolean;
 		useSmartRepresentationSwitch: boolean;
+		seekStallExitPolicy: boolean;
+		mutexStallExitPolicy: boolean;
 		useFetchPriorityHints: boolean;
 		useAbortMSEFix: boolean;
 		enableBaseUrlSupport: boolean;
@@ -157,7 +180,11 @@ export type ITuningConfig = {
 		useNewFailoverLogic: boolean;
 		useFailoverHostsOnAllProviderCrash: boolean;
 		videoTrackBanAfterProviderFail: Milliseconds;
+		saveData3gQualityLimit: ExactVideoQuality;
+		saveData2gQualityLimit: ExactVideoQuality;
+		useConnectionDataUpperLimit: boolean;
 		videoStreamRepresentaionsFilter: [VideoQuality, number, VideoCodec][];
+		filterOnDemandQualityList: boolean;
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;
@@ -238,8 +265,10 @@ export type ITuningConfig = {
 	requestQuick: boolean;
 	/** @deprecated HLS.js удалён, флаг ничего не делает */
 	useHlsJs: boolean;
+	disableHlsOnDesktop: boolean;
 	useNativeHLSTextTracks: boolean;
 	useNewSwitchTo: boolean;
+	alwaysAbortPreviousSwitch: boolean;
 	useDashProviderVirtual: boolean;
 	useDashProviderVirtualMobile: boolean;
 	useNewAutoSelectVideoTrack: boolean;
@@ -320,6 +349,31 @@ export type ITuningConfig = {
 	* (Скорее всего имеет смысл включить такой же флаг в настройках ui)
 	*/
 	reuseOwnVideoElement?: boolean;
+	/**
+	* Обрабатываем все сетевые ошибки, которые приходят с бэка.
+	* на http 500 не падаем в краш.
+	*/
+	handleExtendedNetworkErrorsSet?: boolean;
+	/**
+	* Кэшируем ответы от сервера руками, так как из за динамичесокй природы некоторых параметров в урле
+	* браузер это не может сделать.
+	*/
+	useUrlCacheMechanism?: boolean;
+	/**
+	* Очищаем кэш урлов при падение провайдера.
+	*/
+	dropUrlCacheWhenProviderCrashed?: boolean;
+	/**
+	* При смене/реините провайдера игнорируем результат того, смогло видео заиграть или нет.
+	*/
+	ignoreForcePlayResultWhenProviderChanged?: boolean;
+	hls: {
+		filterOnDemandQualityList: boolean;
+	};
+	/**
+	* Устанавливаем длительность видео на основе последнего сегмента.
+	*/
+	useDurationFromSegments: boolean;
 };
 export type IOptionalTuningConfig = RecursivePartial<ITuningConfig>;
 export declare const fillDefault: (partial: IOptionalTuningConfig) => ITuningConfig;

package/types/utils/videoFormat.d.ts

@@ -1,4 +1,4 @@
 import { type ISources, VideoFormat } from "../player/types";
-export declare const filterAvailableFormats: (formats: VideoFormat[]) => VideoFormat[];
+export declare const filterAvailableFormats: (formats: VideoFormat[], disableHlsOnDesktop?: boolean) => VideoFormat[];
 export declare const isLiveFormat: (format: VideoFormat) => boolean;
-export declare const areValidLiveRecordSources: (sources: ISources) => boolean;
+export declare const areValidLiveRecordSources: (sources: ISources, disableHlsOnDesktop?: boolean) => boolean;