@vkontakte/videoplayer-core 2.0.161-dev.516305f5a.0 → 2.0.161-dev.524dbd943.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.161-dev.516305f5a.0",
+  "version": "2.0.161-dev.524dbd943.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.90-dev.516305f5a.0"
+    "@vkontakte/videoplayer-shared": "1.0.90-dev.524dbd943.0"
   }
 }

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

@@ -32,6 +32,7 @@ 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;

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,6 +68,7 @@ export declare abstract class BaseVirtualBufferManager<T extends Segment> implem
 	abort(): Promise<void>;
 	findSegmentStartTime(position: Milliseconds): Milliseconds | undefined;
 	getRepresentationInitialTime(): Seconds;
+	getMutexInfo(): string;
 	calculateDurationFromSegments(representationId: Representation["id"]): Milliseconds;
 	get lastDataObtainedTimestamp(): Milliseconds;
 	setTarget(time: Milliseconds): void;

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

@@ -18,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/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/ThroughputEstimator.d.ts

@@ -20,6 +20,8 @@ declare class ThroughputEstimator {
 	addRawThroughput(rate: Kbps): void;
 	addRawRtt(time: Milliseconds): void;
 	private sanityCheck;
-	private static load;
+	private static loadStored;
+	private static writeStored;
+	private static validateStored;
 }
 export default ThroughputEstimator;

package/types/utils/tuningConfig.d.ts

@@ -45,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;
@@ -130,6 +148,8 @@ export type ITuningConfig = {
 		useNewRepresentationSwitch: boolean;
 		useDelayedRepresentationSwitch: boolean;
 		useSmartRepresentationSwitch: boolean;
+		seekStallExitPolicy: boolean;
+		mutexStallExitPolicy: boolean;
 		useFetchPriorityHints: boolean;
 		useAbortMSEFix: boolean;
 		enableBaseUrlSupport: boolean;
@@ -160,6 +180,9 @@ export type ITuningConfig = {
 		useNewFailoverLogic: boolean;
 		useFailoverHostsOnAllProviderCrash: boolean;
 		videoTrackBanAfterProviderFail: Milliseconds;
+		saveData3gQualityLimit: ExactVideoQuality;
+		saveData2gQualityLimit: ExactVideoQuality;
+		useConnectionDataUpperLimit: boolean;
 		videoStreamRepresentaionsFilter: [VideoQuality, number, VideoCodec][];
 		filterOnDemandQualityList: boolean;
 	};
@@ -340,6 +363,10 @@ export type ITuningConfig = {
 	* Очищаем кэш урлов при падение провайдера.
 	*/
 	dropUrlCacheWhenProviderCrashed?: boolean;
+	/**
+	* При смене/реините провайдера игнорируем результат того, смогло видео заиграть или нет.
+	*/
+	ignoreForcePlayResultWhenProviderChanged?: boolean;
 	hls: {
 		filterOnDemandQualityList: boolean;
 	};