@vkontakte/videoplayer-core 2.0.175 → 2.0.176-dev.b09e84095.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/videoplayer-core",
-  "version": "2.0.175",
+  "version": "2.0.176-dev.b09e84095.0",
   "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.104"
+    "@vkontakte/videoplayer-shared": "1.0.105-dev.b09e84095.0"
   }
 }

package/types/index.d.ts

@@ -3,7 +3,9 @@ import type { IMpegSource, IDashSource, IHLSSource, IDashURLSource, IHLSLiveSour
 import type { VideoCodec } from "./player/types";
 import { VideoFormat, Surface, PredefinedQualityLimits, VideoCodecName } from "./player/types";
 import Player from "./player/Player";
-import type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, ISources, ICueSettings, IExternalTextTrack, ITextTrack, PlaybackRate, IVideoStream, IAudioStream } from "./player/types";
+import warmUpSources from "./utils/warmUpSources";
+import type { IWarmUp } from "./utils/warmUpSources";
+import type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, ISources, ICueSettings, IExternalTextTrack, ITextTrack, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics } from "./player/types";
 import { PlaybackState, ChromecastState, HttpConnectionType } from "./player/types";
 import type { IOptionalTuningConfig } from "./utils/tuningConfig";
 export { clientChecker, isMobile } from "./utils/ClientChecker";
@@ -15,5 +17,6 @@ import { Subscription, Observable, Subject, ValueSubject, VideoQuality } from "@
 * @deprecated
 */
 declare const SDK_VERSION: string;
-export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, ICueSettings, PlaybackRate, IVideoStream, IAudioStream };
-export { Player, PlaybackState, ChromecastState, HttpConnectionType, Surface, Subscription, VideoFormat, VideoQuality, Observable, Subject, ValueSubject, VERSION, SDK_VERSION, PredefinedQualityLimits, VideoCodec, VideoCodecName };
+export type { IPlayer, IPlayerInfo, IPlayerEvents, IConfig, IOptionalTuningConfig, ILogEntry, ISources, IExternalTextTrack, ITextTrack, ISubscription, IUnsubscriber, IObservable, IEmitter, IValueObservable, IValue, IOperator, IListener, IMpegSource, IDashSource, IDashURLSource, IHLSSource, IHLSLiveSource, URLSource, RawSource, URLSourceWithSeek, ExactVideoQuality, IRange, ISeekRequest, ICueSettings, PlaybackRate, IVideoStream, IAudioStream, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics };
+export type { IWarmUp };
+export { Player, warmUpSources, PlaybackState, ChromecastState, HttpConnectionType, Surface, Subscription, VideoFormat, VideoQuality, Observable, Subject, ValueSubject, VERSION, SDK_VERSION, PredefinedQualityLimits, VideoCodec, VideoCodecName };

package/types/utils/ConnectionWarmUp.d.ts

@@ -0,0 +1,21 @@
+export interface IWarmUpTargets {
+	preconnect: string[];
+	dnsPrefetch: string[];
+}
+/**
+* Прогрев соединения к хостам раздачи. Первый запрос плеера иначе оплачивает полный
+* холодный путь DNS → TCP → TLS, и только после него едут байты.
+*
+* `crossOrigin` на preconnect обязателен: медиазапросы уходят с CORS, а прогретое без него
+* соединение лежит в другом пуле браузера — то есть впустую. Для dns-prefetch он не нужен:
+* резолв имени от пула соединений не зависит.
+*
+* Линки снимаются при `destroy`: плеер переинициализируют, и без уборки `<head>` копил бы
+* их до перезагрузки страницы.
+*/
+export declare class ConnectionWarmUp {
+	private links;
+	warmUp(targets: IWarmUpTargets): IWarmUpTargets;
+	destroy(): void;
+	private appendLinks;
+}

package/types/utils/tuningConfig.d.ts

@@ -475,6 +475,13 @@ export type ITuningConfig = {
 	*/
 	useUrlCacheMechanism?: boolean;
 	/**
+	* Прогревать ли соединение к хостам раздачи. **Сам SDK этот флаг не читает** — прогрев живёт
+	* в `warmUpSources`, а зовёт её потребитель: внутри SDK запаса времени до первого запроса нет.
+	* Флаг лежит здесь, чтобы раскаткой управлял тот же ключ конфига плеера, что и остальными
+	* экспериментами, а не отдельная ручка на каждом потребителе.
+	*/
+	usePreconnectSources?: boolean;
+	/**
 	* Очищаем кэш урлов при падение провайдера.
 	*/
 	dropUrlCacheWhenProviderCrashed?: boolean;

package/types/utils/warmUpSources.d.ts

@@ -0,0 +1,19 @@
+import type { ISources } from "../player/types";
+import type { IWarmUpTargets } from "./ConnectionWarmUp";
+export interface IWarmUp {
+	applied: IWarmUpTargets;
+	destroy: () => void;
+}
+interface IOptions {
+	failoverHosts?: string[];
+	limit?: number;
+}
+/**
+* Прогрев соединения к хостам раздачи по готовым `sources` — до того, как создан плеер.
+*
+* Экономия равна запасу времени до первого запроса: плеер успевает пройти путь от `initVideo`
+* до манифеста за считанные миллисекунды, поэтому звать эту функцию имеет смысл там, где
+* `sources` появились сильно раньше плеера, — сразу после ответа API у потребителя.
+*/
+declare const _default: (sources: ISources, { failoverHosts, limit }?: IOptions) => IWarmUp;
+export default _default;

package/types/utils/warmUpTargets.d.ts

@@ -0,0 +1,18 @@
+import type { ISources } from "../player/types";
+/**
+* Хосты, к которым плеер пойдёт за данными. Считаются до того, как выбран формат:
+* прогрев соединения имеет смысл ровно пока выбор ещё не сделан.
+*
+* Лимит намеренно жёсткий. Каждое лишнее соединение — это DNS, TCP и TLS, потраченные
+* на хост, к которому в этой сессии, скорее всего, не пойдут.
+*/
+export declare const collectSourceOrigins: (sources: ISources, limit?: number) => string[];
+/**
+* Запасные хосты, которым достаточно резолва имени. Соединение к ним в большинстве сессий
+* не понадобится — failover это аварийный путь, — но DNS стоит дешевле соединения,
+* поэтому лимит прогрева на них не распространяется.
+*
+* `failoverHosts` — голые хосты: `ProviderContainer.applyFailoverHost` подставляет их
+* в существующий URL, сохраняя протокол. Протокол здесь берётся у прогретого источника.
+*/
+export declare const collectDnsPrefetchHosts: (failoverHosts: string[], preconnectOrigins: string[]) => string[];