@vkontakte/videoplayer-core 2.0.174-dev.a50406f6b.0 → 2.0.174

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.174-dev.a50406f6b.0",
+  "version": "2.0.174",
   "author": "vk.ru",
   "description": "Videoplayer core library based on the vk.ru platform",
   "homepage": "https://vk.ru",
@@ -42,6 +42,6 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/videoplayer-shared": "1.0.103-dev.a50406f6b.0"
+    "@vkontakte/videoplayer-shared": "1.0.103"
   }
 }

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

@@ -84,6 +84,7 @@ export declare class BufferManager {
 	switchTo: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
 	switchToOld: ReturnType<typeof abortable<[Representation["id"], boolean | undefined], void>>;
 	warmUpMediaSource(): void;
+	private releaseStrandedSegment;
 	abort(): Promise<boolean>;
 	maintain(currentPosition?: Milliseconds | undefined): void;
 	get lastDataObtainedTimestamp(): number;

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

@@ -27,6 +27,7 @@ export interface IParams {
 	useUrlCacheMechanism?: boolean;
 	measureNonSegmentRequests?: boolean;
 	measureFastSamples?: boolean;
+	cacheHitTtfbMaxMs?: Milliseconds;
 	preloadFirstSegment?: boolean;
 	maxQualityForFirstSegmentPreload?: ExactVideoQuality;
 }
@@ -76,13 +77,14 @@ export declare class Fetcher {
 	private useUrlCacheMechanism;
 	private measureNonSegmentRequests;
 	private measureFastSamples;
+	private cacheHitTtfbMaxMs;
 	private preloadFirstSegment;
 	private maxQualityForFirstSegmentPreload;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, cacheHitTtfbMaxMs, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processPerformanceResourceTiming;

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

@@ -1,4 +1,5 @@
 import type { Byte, IError, ISubject, Milliseconds } from "@vkontakte/videoplayer-shared";
+import type { ITuningConfig } from "../../../utils/tuningConfig";
 declare class SourceBufferTaskQueue {
 	bufferFull$: ISubject<Byte>;
 	error$: ISubject<IError>;
@@ -7,7 +8,8 @@ declare class SourceBufferTaskQueue {
 	private currentTask;
 	private destroyed;
 	private abortRequested;
-	constructor(buffer: SourceBuffer);
+	private readonly tuning;
+	constructor(buffer: SourceBuffer, tuning: ITuningConfig);
 	append(data: BufferSource, signal?: AbortSignal): Promise<boolean>;
 	remove(from: Milliseconds, to: Milliseconds, signal?: AbortSignal): Promise<boolean>;
 	abort(init?: BufferSource): Promise<boolean>;

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

@@ -27,6 +27,7 @@ export interface IParams {
 	useUrlCacheMechanism?: boolean;
 	measureNonSegmentRequests?: boolean;
 	measureFastSamples?: boolean;
+	cacheHitTtfbMaxMs?: Milliseconds;
 	preloadFirstSegment?: boolean;
 	maxQualityForFirstSegmentPreload?: ExactVideoQuality;
 }
@@ -75,13 +76,14 @@ export declare class Fetcher {
 	private useUrlCacheMechanism;
 	private measureNonSegmentRequests;
 	private measureFastSamples;
+	private cacheHitTtfbMaxMs;
 	private preloadFirstSegment;
 	private maxQualityForFirstSegmentPreload;
 	private startupPhase;
 	private performanceObserver;
 	private pendingConnectionMetrics;
 	private handleExtendedNetworkErrorsSet;
-	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
+	constructor({ throughputEstimator, requestQuic, tracer, compatibilityMode, useEnableSubtitlesParam, handleExtendedNetworkErrorsSet, useUrlCacheMechanism, measureNonSegmentRequests, measureFastSamples, cacheHitTtfbMaxMs, preloadFirstSegment, maxQualityForFirstSegmentPreload }: IParams);
 	private onHeadersReceived;
 	private setupPerformanceObserver;
 	private processResourceTiming;

package/types/utils/tuningConfig.d.ts

@@ -43,6 +43,13 @@ export type ITuningConfig = {
 		smallSampleMinDuration: Milliseconds;
 		cacheThresholdSize: Milliseconds;
 		/**
+		* UVP-11541: верхняя граница порога, ниже которого ответ считается кэш-хитом по TTFB.
+		* Без неё порог растёт вместе с rtt и после деградации сети объявляет кэшем любой быстрый
+		* сетевой ответ — оценка застывает навсегда. Замер на CDN: кэш отвечает за 0.5–1.2 мс,
+		* сеть не быстрее 45 мс, так что коридор широкий.
+		*/
+		cacheHitTtfbMaxMs: Milliseconds;
+		/**
 		* Фичафлаг UVP-10855: лечит залипание throughput на быстрых соединениях.
 		*
 		* Проблема: на быстром соединении крупный сегмент реально скачивается за ≤ cacheThresholdSize
@@ -270,6 +277,23 @@ export type ITuningConfig = {
 		* Включать поэтапно, начиная с процента трафика, для A/B по метрикам утечек и восстановления.
 		*/
 		resolveQueueOnDestroy: boolean;
+		/**
+		* Освобождает застрявшую загрузку сегментов в `DashProvider`: запись из `activeSegments`,
+		* когда её загрузчик закончил работу или когда `warmUpMediaSource()` переоткрыл
+		* `mediaSource`, и колбэки задач `sourceBufferTaskQueue`, когда очередь разрушается
+		* посреди `append` (UVP-11642, UVP-11519).
+		*
+		* Без первого ранний выход `onSegmentFullyAppended` по протухшему `sourceBuffer` оставляет
+		* запись навсегда, а `maintain()` планирует загрузки только при пустом `activeSegments` —
+		* видеодорожка перестаёт докачиваться до конца жизни `BufferManager`. Без второго
+		* `destroy()` зануляет `currentTask`, не вызвав callback, `loadTemplateSegment` навсегда
+		* стоит на `await`, а `initRepresentations` не доходит до `REPRESENTATIOS_READY`.
+		*
+		* Освобождённый сегмент возвращается в `NONE` через `abortSegment()`, то есть будет скачан
+		* заново: пережили ли байты переоткрытие буфера, достоверно неизвестно, и лишняя докачка
+		* дешевле замершего воспроизведения.
+		*/
+		recoverStuckSegmentLoading: boolean;
 	};
 	dashCmafLive: {
 		externalStopControl: boolean;