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

package/package.json

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

package/types/index.d.ts

@@ -4,7 +4,7 @@ import type { VideoCodec } from "./player/types";
 import { VideoFormat, Surface, PredefinedQualityLimits, VideoCodecName } from "./player/types";
 import Player from "./player/Player";
 import warmUpSources from "./utils/warmUpSources";
-import type { IWarmUp, IWarmUpTargets } 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";
@@ -18,5 +18,5 @@ import { Subscription, Observable, Subject, ValueSubject, VideoQuality } from "@
 */
 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, StartEnd, HttpConnectionMetrics, HttpDownloadMetrics };
-export type { IWarmUp, IWarmUpTargets };
+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/warmUpSources.d.ts

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