@vkontakte/videoplayer-core 2.0.171-dev.881304e5f.0 → 2.0.171-dev.a5a2d3fc3.0

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

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality } from "@vkontakte/videoplayer-shared";
@@ -8,6 +8,6 @@ type LowerLimitLogsArgs = [limitsAreInvalid: boolean, lowestAvailableQuality: Nu
 export declare class LowerLimitRule extends LimitBelowRule<IVideoTrack, IVideoAbrContext, LowerLimitLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, limits: QualityLimits): string;
+	protected createLogData(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, limits: QualityLimits): RuleLogData;
 }
 export {};

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

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+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";
@@ -11,9 +11,13 @@ export declare class StallsRule extends LimitAboveRule<IVideoTrack, IVideoAbrCon
 	private lastStallDurationRestriction;
 	private maxQualityLimitOnStall;
 	private predictedThroughputWithoutData;
+	private restrictionTracer;
+	private restrictionStartedAt;
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig): string;
+	protected createLogData(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, tuning: ITuningConfig): RuleLogData;
+	private traceRestrictionSet;
+	private traceRestrictionReset;
 	private updateStallQualityLimits;
 }
 export {};

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

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+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";
@@ -8,6 +8,6 @@ type ThroughputLogsArgs = [forwardBufferHealth: Nullable<number>, playbackRate:
 export declare class ThroughputRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, ThroughputLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, estimatedThroughput: Kbps, phase: AbrPhase | undefined, tuning: ITuningConfig): string;
+	protected createLogData(selectedTrack: IVideoTrack, forwardBufferHealth: Nullable<number>, playbackRate: number, reserve: Kbps, playbackRateFactor: number, bitrateFactor: number, estimatedThroughput: Kbps, phase: AbrPhase | undefined, tuning: ITuningConfig): RuleLogData;
 }
 export {};

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

@@ -1,9 +1,9 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import { LimitAboveRule } from "../limitAboveRule";
 import type { RulePhaseConfig } from "../../controllers/abrPhaseController";
 export declare class TvDisabledVideoTrackRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	protected createLogMessage(selectedTrack: IVideoTrack): string;
+	protected createLogData(selectedTrack: IVideoTrack): RuleLogData;
 }

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

@@ -1,4 +1,4 @@
-import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext } from "../../types";
+import type { IAbrRule, IAbrRuleResolution, IVideoAbrContext, RuleLogData } from "../../types";
 import type { IVideoTrack } from "../../../../../player/types";
 import type { Nullable, QualityLimits, VideoQuality } from "@vkontakte/videoplayer-shared";
 import { type ExactVideoQuality } from "@vkontakte/videoplayer-shared";
@@ -63,7 +63,7 @@ type UpperLimitsLogsArgs = [limitsAreInvalid: boolean, lowestAvailableQuality: N
 export declare class UpperLimitsRule extends LimitAboveRule<IVideoTrack, IVideoAbrContext, UpperLimitsLogsArgs> implements IAbrRule<IVideoTrack, IVideoAbrContext> {
 	constructor(phaseConfig: RulePhaseConfig);
 	execute(context: IVideoAbrContext): IAbrRuleResolution<IVideoTrack>;
-	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;
+	protected createLogData(selectedTrack: IVideoTrack, limitsAreInvalid: boolean, lowestAvailableQuality: Nullable<ExactVideoQuality>, highestAvailableQuality: Nullable<ExactVideoQuality>, visible: boolean, limits: QualityLimits, backgroundVideoQualityLimit: VideoQuality, effectiveType: string | undefined, connectionDataQualityLimit: ExactVideoQuality | undefined): RuleLogData;
 	private getConnection;
 	private resolveConnectionDataQualityLimit;
 }

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

@@ -1,5 +1,5 @@
 import type { IAudioTrack, IBaseTrack, IVideoTrack } from "../../../player/types";
-import type { Byte, IComponentLogger, IObservable, IRectangle, IValueSubject, Kbps, Milliseconds, Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
+import type { Byte, IComponentLogger, IObservable, IRectangle, ITracer, IValueSubject, Kbps, Milliseconds, Nullable, QualityLimits } from "@vkontakte/videoplayer-shared";
 import type { ITuningConfig } from "../../../utils/tuningConfig";
 import type { Representation, Segment } from "../parsers/types";
 import type { ElementSizeManager } from "../HTMLVideoElement/ElementSizeManager";
@@ -57,6 +57,7 @@ export interface IInitAbrManagerContext {
 	throughputVariance$?: IValueSubject<number>;
 	element: HTMLMediaElement;
 	abrLogger: IComponentLogger;
+	tracer: ITracer;
 	panelSize?: IRectangle;
 }
 export interface IVideoElementAbrManagerContext {
@@ -73,12 +74,13 @@ export interface IAudioTracksContext {
 	audioTracksDesc: IAudioTrack[];
 }
 export type IAbrManagerContext = Omit<IUpdatableAbrManagerContext, "videoTracks" | "audioTracks"> & IVideoElementAbrManagerContext & IInitAbrManagerContext & IVideoTracksContext & IAudioTracksContext;
+export type RuleLogData = Record<string, string | number | boolean | undefined>;
 export interface IAbrRuleResolution<T extends IBaseTrack> {
 	track: T;
 	confidence: number;
 	type: RuleType;
 	name: string;
-	logMessage: string;
+	logData: RuleLogData;
 }
 export interface IRuleInitContext extends IInitAbrManagerContext {}
 export interface IAbrRule<
@@ -101,6 +103,7 @@ export interface IBaseAbrControllerContext extends IVideoTracksContext {
 	lastVideoTrackSelected: Nullable<IVideoTrack>;
 	tuning: ITuningConfig;
 	abrLogger: IComponentLogger;
+	tracer: ITracer;
 	estimatedThroughput: Kbps;
 	reserve: Kbps;
 	forwardBufferHealth: Nullable<number>;

package/types/providers/utils/HTMLVideoElement/observable.d.ts

@@ -17,7 +17,7 @@ export interface IObservableVideo {
 	loadedMetadata$: IObservable<undefined>;
 	loadedData$: IObservable<undefined>;
 	isBuffering$: IObservable<boolean>;
-	currentBuffer$: IObservable<IRange<Seconds>>;
+	currentVideoBuffer$: IObservable<IRange<Seconds>>;
 	totalBufferDuration$: IObservable<Milliseconds>;
 	bufferRangeCount$: IObservable<number>;
 	volumeState$: IObservable<IVolumeState>;

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

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

@@ -0,0 +1,40 @@
+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>;
+	storeDownloadedSegments({ url, buffer, segments, networkDataOffset }: {
+		url: string;
+		buffer: ArrayBuffer;
+		segments: CacheMetadataEntry[];
+		networkDataOffset?: number;
+	}): void;
+	private assembleStartBuffer;
+	private buildPartialFromCacheStart;
+	storeMissing({ url, missingRange, networkData, networkDataOffset }: {
+		url: string;
+		missingRange: SubRange;
+		networkData: ArrayBuffer;
+		networkDataOffset?: number;
+	}): 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 { 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

@@ -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,74 @@
+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>;
+	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];

package/types/utils/buffer/isBrokenSegmentAppend.d.ts

@@ -0,0 +1,3 @@
+import type { IRange, Milliseconds } from "@vkontakte/videoplayer-shared";
+declare const _default: (buffered: IRange<Milliseconds>[], segment: IRange<Milliseconds>, tolerance: Milliseconds) => boolean;
+export default _default;

package/types/utils/buffer/timeRangesToIntervals.d.ts

@@ -0,0 +1,3 @@
+import type { IRange, Milliseconds } from "@vkontakte/videoplayer-shared";
+declare const _default: (timeRanges: TimeRanges) => IRange<Milliseconds>[];
+export default _default;

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[];
@@ -13,6 +14,17 @@ export type ITuningConfig = {
 		playingUnstableThresholdMs: Milliseconds;
 		/** Список имён включённых эвристик. Пустой массив = все эвристики выключены */
 		heuristics: string[];
+		/** Множитель уменьшения grace-таймаута при каждом поступлении данных в StartupHangupHeuristic */
+		hangupGraceDecayFactor: number;
+		/** Минимальный grace-таймаут (мс). При достижении — следующий decay возвращает 0 (немедленный expire) */
+		hangupGraceMinTimeoutMs: Milliseconds;
+		/**
+		* Если true — audible (не muted) хэнгап в hidden-вкладке откладывается до возврата на visible (reinit),
+		* desired state при этом не меняется.
+		* Если false — audible хэнгап в hidden-вкладке мониторится: данные перезапускают decay-таймер,
+		* при ≥3 поступлениях данных без завершения перехода — эскалация в switch_codec/switch_provider.
+		*/
+		deferAudibleHangupOnHiddenTab: boolean;
 	};
 	/**
 	* Включает очистку состояния плеера при вызове метода stop()
@@ -107,6 +119,7 @@ export type ITuningConfig = {
 		activeVideoAreaThreshold: number;
 		trafficSavingLimit: ExactVideoQuality;
 		highQualityLimit: ExactVideoQuality;
+		lowQualityTelemetryLimit: ExactVideoQuality;
 	};
 	stallsManager: {
 		enabled: boolean;
@@ -168,6 +181,8 @@ export type ITuningConfig = {
 		useDelayedRepresentationSwitch: boolean;
 		useSmartRepresentationSwitch: boolean;
 		stallForceSeekOncePerStall: boolean;
+		brokenSegmentAppendDetection: boolean;
+		brokenSegmentAppendTolerance: Milliseconds;
 		useFetchPriorityHints: boolean;
 		enableBaseUrlSupport: boolean;
 		maxSegmentRetryCount: number;
@@ -402,15 +417,6 @@ export type ITuningConfig = {
 	*/
 	handleExtendedNetworkErrorsSet?: boolean;
 	/**
-	* Кэшируем ответы от сервера руками, так как из за динамичесокй природы некоторых параметров в урле
-	* браузер это не может сделать.
-	*/
-	useUrlCacheMechanism?: boolean;
-	/**
-	* Очищаем кэш урлов при падение провайдера.
-	*/
-	dropUrlCacheWhenProviderCrashed?: boolean;
-	/**
 	* При смене/реините провайдера игнорируем результат того, смогло видео заиграть или нет.
 	*/
 	ignoreForcePlayResultWhenProviderChanged?: boolean;
@@ -433,6 +439,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/ProviderContainer/Mayday/heuristics/HangupHeuristic.d.ts

@@ -1,22 +0,0 @@
-import type { IError } from "@vkontakte/videoplayer-shared";
-import type { IHeuristicDeps } from "../types";
-import type { IAsyncHeuristic, HeuristicResult } from "./IHeuristic";
-export declare class HangupHeuristic implements IAsyncHeuristic {
-	private deps;
-	static readonly heuristicName = "HangupHeuristic";
-	readonly type = "async";
-	readonly recommendation$;
-	private timerId;
-	private sub;
-	private error;
-	private manifestRequested;
-	private manifestRequestedAt;
-	private manifestReceivedMs;
-	constructor(deps: IHeuristicDeps);
-	analyze(error: IError): HeuristicResult;
-	private restartTimer;
-	private expire;
-	private cancel;
-	reset(): void;
-	destroy(): void;
-}