@vkontakte/videoplayer-core 2.0.173-dev.ebda080eb.0 → 2.0.174-beta.0

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

@@ -1,54 +0,0 @@
-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/SegmentCache.d.ts

@@ -1,59 +0,0 @@
-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 SegmentCache {
-	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

@@ -1,20 +0,0 @@
-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

@@ -1,8 +0,0 @@
-export { IndexedDbSegmentCacheStorage } from "./IndexedDbSegmentCacheStorage";
-export { SegmentCache, CacheCheckResultType } from "./SegmentCache";
-export type { CacheCheckResult } from "./SegmentCache";
-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, SegmentCacheEntry, InitSegmentParams, InitSegmentRangeType, SetMediaSegmentParams, SetInitSegmentParams, SetSegmentParams, CacheRecord, CachePrimaryKey } from "./types";

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

@@ -1,25 +0,0 @@
-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

@@ -1,25 +0,0 @@
-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

@@ -1,76 +0,0 @@
-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[];
-}
-export interface SegmentCacheConfig {
-	/** Включает кэширование media-сегментов в IndexedDB */
-	enabled: boolean;
-	/** Лимит суммарного размера кэша (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];