@vkontakte/videoplayer-core 2.0.179-dev.4cee6bcff.0 → 2.0.179-dev.62f578567.0

package/types/providers/utils/segmentCache/IndexedDbSegmentCacheStorage.d.ts

@@ -0,0 +1,54 @@
+import type { InitSegmentParams, ISegmentCacheStorage, SegmentCacheConfig, SetSegmentParams } from "./types";
+export declare class IndexedDbSegmentCacheStorage implements ISegmentCacheStorage {
+	private config;
+	private dbPromise;
+	private destroyed;
+	private evictionTimerId;
+	private globalTotalBytes;
+	private maxTotalStoredBytes;
+	private quotaExceeded;
+	private cacheEventsChannel;
+	constructor(config: SegmentCacheConfig);
+	private getDb;
+	private isFresh;
+	/**
+	* Читает записи по массиву ключей в одной транзакции.
+	* Свежие по TTL — возвращает данные и обновляет lastAccessAt (не чаще чем раз в TOUCH_INTERVAL_MS,
+	* чтобы избежать write amplification: каждый cache hit не должен делать store.put с полным ArrayBuffer).
+	* Протухшие — удаляет, декрементирует globalTotalBytes.
+	*/
+	private readFreshRecord;
+	/**
+	* При открытии БД пересчитывает globalTotalBytes: проходит по всем записям,
+	* суммирует размер живых (не протухших по TTL) и удаляет протухшие.
+	* TTL различается: media — ttlMs, init/index — initTtlMs.
+	*/
+	private handleDbOpened;
+	/** Возвращает TTL в зависимости от типа записи по первичному ключу. */
+	private ttlForEntry;
+	getSegments(normalizedUrl: string, indices: number[]): Promise<Map<number, ArrayBuffer>>;
+	/** Удаляет записи по индексам сегментов в одной транзакции, декрементируя globalTotalBytes. */
+	deleteSegments(normalizedUrl: string, indices: number[]): Promise<void>;
+	setSegment(params: SetSegmentParams): Promise<void>;
+	getInitSegment({ normalizedUrl, rangeType, range }: InitSegmentParams): Promise<ArrayBuffer | null>;
+	/** Универсальная запись с подсчётом delta, QuotaExceededError-обработкой и eviction. */
+	private putRecord;
+	private handleQuotaExceededError;
+	/** Полная очистка кэша с рассылкой события остальным инстансам (вкладки, другие плееры). */
+	clear(): Promise<void>;
+	destroy(): void;
+	private scheduleEviction;
+	/**
+	* LRU-eviction: запускается по дебаунсу после каждой записи.
+	* Без квоты — триггерит при достижении maxTotalStoredBytes.
+	* После QuotaExceededError — раньше, на maxTotalStoredBytes * evictionThreshold,
+	* чтобы не упереться в квоту повторно.
+	* Очищает с запасом — до maxTotalStoredBytes * evictionTargetPercent.
+	*/
+	private runEviction;
+	/**
+	* Удаляет самые старые по lastAccessAt записи, пока не освободит хотя бы bytesToFree.
+	* maxBytesPerBatch ограничивает длительность одной транзакции; без лимита — при QuotaExceededError.
+	*/
+	private evictOldest;
+}

package/types/providers/utils/segmentCache/MediaSegmentBatchCache.d.ts

@@ -0,0 +1,59 @@
+import type { ISegmentCacheStorage, CacheMetadata, CacheMetadataEntry } from "./types";
+import type { SubRange } from "./segmentCacheUtils";
+export declare enum CacheCheckResultType {
+	FullHit = "full_hit",
+	FullMiss = "full_miss",
+	Partial = "partial"
+}
+export type CacheCheckResult = {
+	type: CacheCheckResultType.FullHit;
+	data: ArrayBuffer;
+} | {
+	type: CacheCheckResultType.FullMiss;
+} | {
+	type: CacheCheckResultType.Partial;
+	cached: Map<number, ArrayBuffer>;
+	missingRange: SubRange;
+	startBuffer: {
+		buffer: ArrayBuffer;
+		loaded: number;
+	} | null;
+};
+export declare class MediaSegmentBatchCache {
+	private cacheService;
+	constructor(cacheService: ISegmentCacheStorage);
+	getCached(url: string, metadata: CacheMetadata): Promise<CacheCheckResult>;
+	/**
+	* Длина записи обязана совпадать с byteRange сегмента: и сборка (assembleFromCached склеивает
+	* конкатенацией, assembleStartBuffer — по абсолютным смещениям), и кормление буфера адресуют
+	* сегменты по этим смещениям. Битая запись сдвигает/зануляет весь батч после себя.
+	* Расхождение = отрава: считаем miss и удаляем ключ — сегмент перекачается и перезапишется.
+	*/
+	private dropCorruptedEntries;
+	storeDownloadedSegments({ url, buffer, segments, networkDataOffset, validBytes, onSkipped }: {
+		url: string;
+		buffer: ArrayBuffer;
+		segments: CacheMetadataEntry[];
+		networkDataOffset?: number;
+		/**
+		* Сколько байт в начале buffer содержат реальные данные.
+		* Может быть меньше buffer.byteLength — при пре-аллокации (bufferOptimisation) хвост буфера остаётся нулями.
+		*/
+		validBytes?: number;
+		/**
+		* Вызывается, если часть сегментов не влезла в validBytes: они не записаны в кэш
+		* и докачаются как miss при следующем запросе региона.
+		*/
+		onSkipped?: (segments: CacheMetadataEntry[]) => void;
+	}): void;
+	private assembleStartBuffer;
+	private buildPartialFromCacheStart;
+	storeMissing({ url, missingRange, networkData, networkDataOffset, validBytes, onSkipped }: {
+		url: string;
+		missingRange: SubRange;
+		networkData: ArrayBuffer;
+		networkDataOffset?: number;
+		validBytes?: number;
+		onSkipped?: (segments: CacheMetadataEntry[]) => void;
+	}): void;
+}

package/types/providers/utils/segmentCache/constants.d.ts

@@ -0,0 +1,20 @@
+export declare const DB_NAME = "vk_player_segment_cache";
+export declare const DB_VERSION = 1;
+export declare const STORE = "cache";
+export declare const EVICTION_DEBOUNCE_MS = 5e3;
+/** Канал синхронизации инстансов storage (вкладки, несколько плееров на странице) */
+export declare const CACHE_EVENTS_CHANNEL = "vk_player_segment_cache_events";
+/** Событие полной очистки кэша: получатель сбрасывает in-memory счётчик байт, база уже пуста */
+export declare const CACHE_CLEARED_EVENT = "cleared";
+/**
+* Минимальный интервал между обновлениями lastAccessAt при чтении.
+* Без него каждый cache hit делал бы store.put с полным ArrayBuffer ради одного поля.
+* При TTL в часы точность LRU до минут не нужна — 5 минут достаточно.
+*/
+export declare const TOUCH_INTERVAL_MS: number;
+/** Тип записи: media-сегмент, init-сегмент, index-сегмент */
+export declare enum CacheEntryType {
+	Media = 0,
+	Init = 1,
+	Index = 2
+}

package/types/providers/utils/segmentCache/index.d.ts

@@ -0,0 +1,8 @@
+export { IndexedDbSegmentCacheStorage } from "./IndexedDbSegmentCacheStorage";
+export { MediaSegmentBatchCache, CacheCheckResultType } from "./MediaSegmentBatchCache";
+export type { CacheCheckResult } from "./MediaSegmentBatchCache";
+export { normalizeSegmentCacheUrl, assemblePartialBuffer, toEntryType, createMediaKey, createInitKey, isQuotaExceededError } from "./segmentCacheUtils";
+export type { SubRange } from "./segmentCacheUtils";
+export { clearSegmentCacheDb } from "./segmentCacheDb";
+export { DB_NAME, DB_VERSION, STORE, EVICTION_DEBOUNCE_MS, CacheEntryType } from "./constants";
+export type { ISegmentCacheStorage, CacheMetadata, CacheMetadataEntry, SegmentCacheConfig, SegmentCacheMode, SegmentCacheEntry, InitSegmentParams, InitSegmentRangeType, SetMediaSegmentParams, SetInitSegmentParams, SetSegmentParams, CacheRecord, CachePrimaryKey } from "./types";

package/types/providers/utils/segmentCache/segmentCacheDb.d.ts

@@ -0,0 +1,25 @@
+export declare const INDEX_BY_LAST_ACCESS = "byLastAccess";
+export declare const INDEX_BY_SIZE_AND_AGE = "bySizeAndAge";
+export declare const INDEX_BY_LAST_ACCESS_AND_SIZE = "byLastAccessAndSize";
+/**
+* Открывает базу кэша, при первом создании поднимает store и индексы.
+* onOpened (если передан) await-ится до resolve — используется только в clearSegmentCacheDb.
+* Инстанс storage не использует onOpened: rehydrate запускается параллельно, чтобы не блокировать чтения.
+*/
+export declare const openSegmentCacheDb: (onOpened?: (db: IDBDatabase) => Promise<void>) => Promise<IDBDatabase>;
+/** Выполняет операции в одной readwrite-транзакции, резолвится по её завершении. */
+export declare const execStoreTx: (db: IDBDatabase, body: (store: IDBObjectStore) => void) => Promise<void>;
+/**
+* Гоняет курсор по индексу, вызывая visit на каждой записи.
+* visit возвращает false — итерация останавливается, транзакция завершается.
+* Работает только внутри execStoreTx: завершение итерации отслеживается транзакцией.
+*/
+export declare const iterateCursor: <T extends IDBCursor>(request: IDBRequest<T | null>, visit: (cursor: T) => boolean) => void;
+/** Рассылает событие полной очистки кэша всем инстансам storage (вкладки, другие плееры на странице). */
+export declare const broadcastCacheCleared: () => void;
+/**
+* Полностью очищает кэш без привязки к инстансу storage: можно звать из мест,
+* где экземпляр IndexedDbSegmentCacheStorage недоступен (например, из ProviderContainer при ошибках).
+* Живые инстансы узнают об очистке через broadcastCacheCleared и сбросят in-memory счётчики.
+*/
+export declare const clearSegmentCacheDb: () => Promise<void>;

package/types/providers/utils/segmentCache/segmentCacheUtils.d.ts

@@ -0,0 +1,25 @@
+import type { Byte, IRange } from "@vkontakte/videoplayer-shared";
+import type { CacheMetadata, CacheMetadataEntry, InitSegmentRangeType, CachePrimaryKey } from "./types";
+import { CacheEntryType } from "./constants";
+/** Приводит URL к каноническому виду: заменяет hostname на cache.local и удаляет CDN-параметры (sig, expires, bytes, fromCache). */
+export declare function normalizeSegmentCacheUrl(url: string): string;
+export declare function toEntryType(rangeType: InitSegmentRangeType): CacheEntryType;
+export declare function createMediaKey(normalizedUrl: string, segmentIndex: number): CachePrimaryKey;
+export declare function createInitKey(normalizedUrl: string, entryType: CacheEntryType, rangeFrom: number, rangeTo: number): CachePrimaryKey;
+export declare function isQuotaExceededError(error: unknown): boolean;
+export type SubRange = {
+	range: IRange<Byte>;
+	segments: CacheMetadataEntry[];
+};
+/** Проверяет, что сегменты идут подряд по индексам — без разрывов между ними. Ожидает отсортированный массив. */
+export declare function isContiguous(segments: CacheMetadataEntry[]): boolean;
+/** Склеивает буферы закэшированных сегментов в один ArrayBuffer. Используется при full hit. */
+export declare function assembleFromCached(metadata: CacheMetadata, cached: Map<number, ArrayBuffer>): ArrayBuffer;
+/** Склеивает закэшированные и сетевые данные в один ArrayBuffer для partial hit. */
+export declare function assemblePartialBuffer({ metadata, cached, missingRange, networkData, networkDataOffset }: {
+	metadata: CacheMetadata;
+	cached: Map<number, ArrayBuffer>;
+	missingRange: SubRange;
+	networkData: ArrayBuffer;
+	networkDataOffset?: number;
+}): ArrayBuffer;

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

@@ -0,0 +1,85 @@
+import type { Byte, IRange } from "@vkontakte/videoplayer-shared";
+import type { CacheEntryType } from "./constants";
+export type InitSegmentRangeType = "init" | "index";
+export interface SegmentCacheEntry {
+	data: ArrayBuffer;
+	segmentIndex: number;
+}
+export interface InitSegmentParams {
+	normalizedUrl: string;
+	rangeType: InitSegmentRangeType;
+	range: IRange<Byte>;
+}
+export interface SetMediaSegmentParams {
+	type: "media";
+	normalizedUrl: string;
+	segmentIndex: number;
+	data: ArrayBuffer;
+}
+export interface SetInitSegmentParams {
+	type: "init";
+	normalizedUrl: string;
+	rangeType: InitSegmentRangeType;
+	range: IRange<Byte>;
+	data: ArrayBuffer;
+}
+export type SetSegmentParams = SetMediaSegmentParams | SetInitSegmentParams;
+export interface ISegmentCacheStorage {
+	getSegments(normalizedUrl: string, indices: number[]): Promise<Map<number, ArrayBuffer>>;
+	setSegment(params: SetSegmentParams): Promise<void>;
+	/** Удаляет media-записи по индексам сегментов. Используется для самолечения: запись с несовпадающей длиной удаляется и сегмент перекачивается */
+	deleteSegments(normalizedUrl: string, indices: number[]): Promise<void>;
+	getInitSegment(params: InitSegmentParams): Promise<ArrayBuffer | null>;
+	/** Полная очистка кэша (все записи, без привязки к url) с рассылкой события другим инстансам */
+	clear(): Promise<void>;
+	destroy(): void;
+}
+export interface CacheMetadataEntry {
+	index: number;
+	byteRange: IRange<Byte>;
+}
+export interface CacheMetadata {
+	segments: CacheMetadataEntry[];
+}
+/**
+* Режим кэширования в IndexedDB:
+* - 'none' — кэш выключен, сервис не создаётся;
+* - 'all' — кэшируются media-сегменты и init/index;
+* - 'init' — кэшируются только init/index: фетчер не создаёт media-обёртку MediaSegmentBatchCache,
+*   сервис используется напрямую для init/index. Media-записи, оставшиеся в базе от режима
+*   'all', не читаются и не перезаписываются — эксперимент по init-кэшу должен быть чистым.
+*/
+export type SegmentCacheMode = "none" | "all" | "init";
+export interface SegmentCacheConfig {
+	/** Режим кэширования: 'all' — сегменты и init/index, 'init' — только init/index, 'none' — выключен */
+	mode: SegmentCacheMode;
+	/** Лимит суммарного размера кэша (media + init/index сегменты) в байтах. При QuotaExceededError автоматически опускается до текущего размера */
+	maxTotalSizeBytes: number;
+	/** Доля от эффективного лимита, при превышении которой запускается LRU-эвикт (0.9 = 90%) */
+	evictionThreshold: number;
+	/** Доля от максимального хранимого кэша, до которой LRU-эвикт очищает кэш (0.7 = 70%).
+	*  Должна быть ниже evictionThreshold: запас между ними не даёт эвикту срабатывать на каждую запись у границы лимита
+	* */
+	evictionTargetPercent: number;
+	/** Максимальный объём данных в байтах, который LRU-эвикт удаляет за один проход (ограничивает длительность одной транзакции) */
+	evictionBatchMaxBytes: number;
+	/** Доля от maxTotalStoredBytes, которую нужно освободить при QuotaExceededError (0.5 = 50%) */
+	quotaExceededEvictPercent: number;
+	/** TTL для media-сегментов в миллисекундах. Протухшие записи удаляются при чтении и при rehydrate */
+	ttlMs: number;
+	/** TTL для init/index-сегментов в миллисекундах (обычно длиннее, т.к. они стабильнее) */
+	initTtlMs: number;
+	/** Стратегия очистки кэша при ошибках декодера/фетчера: 'once' — один раз за жизнь контейнера, 'always' — на каждую ошибку */
+	clearOnErrorStrategy: "once" | "always";
+}
+/**
+* Единая запись кэша. Ключ передаётся явно (out-of-line) через createMediaKey / createInitKey.
+*/
+export interface CacheRecord {
+	normalizedUrl: string;
+	data: ArrayBuffer;
+	byteLength: number;
+	createdAt: number;
+	lastAccessAt: number;
+}
+export type CachePrimaryKey = [string, CacheEntryType, number, number];

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 { SegmentCacheConfig } from "../providers/utils/segmentCache/types";
 export type ITuningConfig = {
 	/** @deprecated */
 	configName?: string[];
@@ -132,6 +133,12 @@ export type ITuningConfig = {
 		considerPlaybackRate: boolean;
 		trackCooldownIncreaseQuality: Milliseconds;
 		trackCooldownDecreaseQuality: Milliseconds;
+		oscillationCooldownEnabled: boolean;
+		trackOutcomeEnabled: boolean;
+		trackProbationMs: Milliseconds;
+		trackBanAfterFails: number;
+		trackBanMs: Milliseconds;
+		trackBanWindowMs: Milliseconds;
 		backgroundVideoQualityLimit: VideoQuality;
 		activeVideoAreaThreshold: number;
 		trafficSavingLimit: ExactVideoQuality;
@@ -472,15 +479,6 @@ export type ITuningConfig = {
 	*/
 	handleExtendedNetworkErrorsSet?: boolean;
 	/**
-	* Кэшируем ответы от сервера руками, так как из за динамичесокй природы некоторых параметров в урле
-	* браузер это не может сделать.
-	*/
-	useUrlCacheMechanism?: boolean;
-	/**
-	* Очищаем кэш урлов при падение провайдера.
-	*/
-	dropUrlCacheWhenProviderCrashed?: boolean;
-	/**
 	* При смене/реините провайдера игнорируем результат того, смогло видео заиграть или нет.
 	*/
 	ignoreForcePlayResultWhenProviderChanged?: boolean;
@@ -508,6 +506,7 @@ export type ITuningConfig = {
 	* провайдер по-прежнему ждёт canplay, чтобы play() не вызывался до появления данных.
 	*/
 	readyOnLoadedMetadata: boolean;
+	segmentCache: SegmentCacheConfig;
 };
 export type IOptionalTuningConfig = RecursivePartial<ITuningConfig>;
 export declare const fillDefault: (partial: IOptionalTuningConfig) => ITuningConfig;

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

@@ -1,23 +0,0 @@
-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/lib/urlsCache.d.ts

@@ -1,22 +0,0 @@
-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/utils/Abr/trackHistory.d.ts

@@ -1,9 +0,0 @@
-import type { IBaseTrack } from "../../../player/types";
-import type { Milliseconds } from "@vkontakte/videoplayer-shared";
-export declare class TrackHistory<T extends IBaseTrack> {
-	last: T | undefined;
-	history: Record<IBaseTrack["id"], Milliseconds>;
-	recordSelection(track: T): void;
-	recordSwitch(track: T | undefined): void;
-	clear(): void;
-}