@vkontakte/calls-sdk 2.8.12-dev.773596bc.0 → 2.8.12-dev.7afbc576.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.12-dev.773596bc.0",
+  "version": "2.8.12-dev.7afbc576.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -14,7 +14,7 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/calls-audio-effects": "1.2.8",
+    "@vkontakte/calls-audio-effects": "1.4.1",
     "@vkontakte/calls-video-effects": "2.2.3-beta.7",
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",
@@ -22,6 +22,6 @@
     "fflate": "^0.8.2",
     "messagepack": "1.1.12",
     "simple-ebml-builder": "0.2.2",
-    "webrtc-adapter": "7.7.0"
+    "webrtc-adapter": "9.0.5"
   }
 }

package/static/ApiTransport.d.ts

@@ -7,4 +7,7 @@ export declare function sendBeakon(method: string, params?: {
 export declare function request(method: string, params?: {
     [key: string]: any;
 }, noSession?: boolean, customEndpoint?: string): Promise<any>;
+export declare function requestKeepalive(method: string, params?: {
+    [key: string]: any;
+}, noSession?: boolean): Promise<any>;
 export declare function sendFormData(url: string, data: FormData): Promise<void>;

package/static/External.d.ts

@@ -637,6 +637,6 @@ declare namespace External {
     /**
      * Собеседник подключился к сигналлингу
      */
-    function onPeerRegistered(conversationId?: string): void;
+    function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
 }
 export default External;

package/static/Params.d.ts

@@ -1,5 +1,5 @@
 import type { VideoEffects } from '@vkontakte/calls-video-effects';
-import type { EffectVoiceChange } from '@vkontakte/calls-audio-effects';
+import type { EffectVoiceChange, VadControllerOptions, VadLib } from '@vkontakte/calls-audio-effects';
 import type * as Vmoji from '@vkontakte/calls-vmoji';
 import { IAsrData } from '../types/Asr';
 import { ConversationData } from '../types/Conversation';
@@ -37,6 +37,18 @@ export type ParamsObject = {
     platform: string;
     /** @hidden */
     clientStatsPlatform: string;
+    /**
+     * Автоматически запускать отправку клиентской статистики при `init()`.
+     *
+     * Если `false`, события звонков продолжают копиться в IndexedDB, но в сеть
+     * не уходят, пока хост не вызовет `startStats()`. Так хост может прогреть
+     * приложение, не нагружая сеть. До старта неактивен и fallback прямой
+     * отправки при недоступном хранилище. Если `startStats()` не вызвать
+     * никогда, очередь дорастёт до лимита и начнёт вытеснять старые звонки.
+     *
+     * _По умолчанию: `true`_
+     */
+    autoStartStats: boolean;
     /** @hidden */
     clientType: string;
     /** @hidden */
@@ -193,6 +205,14 @@ export type ParamsObject = {
      * Можно установить позднее методом `setAudioEffects`
      */
     audioEffects: EffectVoiceChange | null;
+    /**
+     * Namespace библиотеки VAD из `@vkontakte/calls-audio-effects`.
+     *
+     * Можно установить методом `setVad`
+     */
+    vad: VadLib | null;
+    /** Настройки VAD (threshold, hangoverMs, enabled) */
+    vadOptions: VadControllerOptions;
     /**
      * Максимальная ширина видео в пикселях для видео эффекта
      *
@@ -505,6 +525,16 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableSessionStateUpdates: boolean;
+    /**
+     * Использовать `<audio>` вместо `<video>` для воспроизведения звука в desktop Safari
+     * @hidden
+     */
+    safariAudioElement: boolean;
+    /**
+     * Отправлять пустой ICE candidate (end-of-candidates) удалённому пиру
+     * @hidden
+     */
+    forwardEmptyIceCandidate: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -892,7 +922,7 @@ export type ParamsObject = {
     /**
      * Собеседник подключился к сигналлингу
      */
-    onPeerRegistered?: (conversationId?: string) => void;
+    onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
 };
 export default abstract class Params {
     private static _params;
@@ -910,6 +940,7 @@ export default abstract class Params {
     static set platform(value: string);
     static get clientStatsPlatform(): string;
     static set clientStatsPlatform(value: string);
+    static get autoStartStats(): boolean;
     static get clientType(): string;
     static set clientType(value: string);
     static get externalUserType(): string;
@@ -960,6 +991,10 @@ export default abstract class Params {
     static get displaySurface(): DisplayCaptureSurfaceType;
     static get audioEffects(): EffectVoiceChange | null;
     static set audioEffects(value: EffectVoiceChange | null);
+    static get vad(): VadLib | null;
+    static set vad(value: VadLib | null);
+    static get vadOptions(): VadControllerOptions;
+    static set vadOptions(value: VadControllerOptions);
     static get videoEffects(): VideoEffects | null;
     static set videoEffects(value: VideoEffects | null);
     static get videoEffectMaxWidth(): number;
@@ -1027,6 +1062,8 @@ export default abstract class Params {
     static get waitForRecordResponse(): boolean;
     static get transparentAudio(): boolean;
     static get enableSessionStateUpdates(): boolean;
+    static get safariAudioElement(): boolean;
+    static get forwardEmptyIceCandidate(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1056,6 +1093,7 @@ export default abstract class Params {
         movieShare: boolean;
         clientType: string;
         clientStatsPlatform: string;
+        autoStartStats: boolean;
         consumerScreenDataChannelPacketSize: number;
         switchVideoAtBadNetwork: boolean;
         simulcast: boolean;
@@ -1063,5 +1101,7 @@ export default abstract class Params {
         waitForRecordResponse: boolean;
         transparentAudio: boolean;
         enableSessionStateUpdates: boolean;
+        safariAudioElement: boolean;
+        forwardEmptyIceCandidate: boolean;
     };
 }

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -11,6 +11,7 @@ declare namespace ParticipantConnectionStatusUtils {
     function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
     function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState, sessionStateConnectedBySpeaker?: boolean): StatusTransition;
     function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
+    function setStalled(status: ParticipantConnectionStatus, stalled: boolean): StatusTransition;
     function setSessionStateApplicable(status: ParticipantConnectionStatus, applicable: boolean): StatusTransition;
 }
 export default ParticipantConnectionStatusUtils;

package/static/Sdp.d.ts

@@ -0,0 +1,3 @@
+export declare const SDP_LINE_ENDING = "\r\n";
+export declare function splitSdpLines(sdp: string): string[];
+export declare function joinSdpLines(lines: string[]): string;

package/static/SignalingCapabilities.d.ts

@@ -1,5 +1,5 @@
 /**
- * @see https://confluence.vk.team/display/VIDEOOK/Websocket+Capability+Flags
+ * @see https://confluence.vk.team/display/CALLS/Websocket+Capability+Flags
  */
 declare const PREDICATES: {
     readonly producerScreenTrack: () => boolean;

package/static/SimulcastInfo.d.ts

@@ -6,8 +6,10 @@ export declare const SIMULCAST_DEFAULT: {
     BITRATE: number;
 };
 export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
-export declare const MAP_RID_TO_SCALE_RESOLUTION_DOWN_BY: Record<string, number>;
 export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
 export declare function findBitrateAsc(maxDimension: number, bitrates: VideoBitrateSettings[]): number;
-export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[]): ISimulcastInfo;
-export declare function findScaleResolutionDownBy(rid?: string): number;
+export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[], fps?: number): {
+    streams: import("../types/SimulcastInfo").SimulcastStreamInfo[];
+};
+export declare function findScaleResolutionDownBy(rid: string | undefined, simulcastInfo: ISimulcastInfo): number;
+export declare function applySimulcastInfoToEncodings(encodings: RTCRtpEncodingParameters[], simulcastInfo: ISimulcastInfo, maxDimension?: number, maxBitrate?: number): void;

package/static/Utils.d.ts

@@ -9,7 +9,7 @@ export declare const DEVICE_IDX_PARAMETER = "d";
 /** @hidden */
 declare namespace Utils {
     function patchLocalSDP(sdp: string, preferH264: boolean, brokenH264Decoder: boolean, preferVP9: boolean, isAudioNack?: boolean): string;
-    function patchRemoteSDP(sdp: string, oldDataChannelDescription: boolean, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, brokenVP9Encoder: boolean, brokenVP9Decoder: boolean): string;
+    function patchRemoteSDP(sdp: string, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, brokenVP9Encoder: boolean, brokenVP9Decoder: boolean): string;
     function getPeerIdString(peerId: SignalingMessage.PeerId): string;
     function comparePeerId(peerId1: SignalingMessage.PeerId, peerId2: SignalingMessage.PeerId): boolean;
     function getPeerConnectionHostInfo(pc: RTCPeerConnection): Promise<{
@@ -77,6 +77,5 @@ declare namespace Utils {
     function objectReduce<R, T extends object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
     const setImmediate: (fn: VoidFunction) => VoidFunction;
     function isObject(obj: unknown): obj is object;
-    function patchSimulcastAnswerSdp(sdp: string, trans: RTCRtpTransceiver, width: number, height: number): string;
 }
 export default Utils;

package/static/WebRTCUtils.d.ts

@@ -2,7 +2,7 @@
  * Вспомогательный плагин для работы с WebRTC
  */
 import { IVideoDimentions } from '../types/MediaSettings';
-import type StatsLogger from '../classes/StatsLogger';
+import type StatEventCollector from '../classes/stat/StatEventCollector';
 import { type DebugLogger } from './Debug';
 /**
  * Тип камеры мобильного устройства
@@ -20,7 +20,7 @@ export declare enum FacingMode {
 /**
  * Известные браузеры
  */
-export type BrowserName = 'IE' | 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
+export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
 declare namespace WebRTCUtils {
     /**
      * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -85,24 +85,24 @@ declare namespace WebRTCUtils {
      * @param needAudio Нужно ли аудио
      * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
      */
-    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
      */
-    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает камеру пользователя
      *
      * @param deviceId ID устройства
      * @param resolution Размеры видео
      */
-    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает микрофон пользователя
      *
      * @param deviceId ID устройства
      */
-    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Устанавливает размер видео в стриме
      *
@@ -143,17 +143,14 @@ declare namespace WebRTCUtils {
      * В некоторых браузерах VP9 decoder сломан
      */
     function isBrokenVP9Decoder(): boolean;
-    /**
-     * Изменился формат описания датаканала в SDP
-     * @link https://blog.mozilla.org/webrtc/how-to-avoid-data-channel-breaking/
-     */
-    function isOldDataChannelDescription(): boolean;
     /**
      * Может ли браузер делать H264 приоритетным
      */
     function canPreferH264(): boolean;
     /**
-     * Некоторые браузеры (Firefox, Safari) некорректно поддерживают симулкаст
+     * Поддержка simulcast браузером.
+     * Safari корректно поддерживает simulcast начиная с версии 18.
+     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
      */
     function isSimulcastSupportedByBrowser(): boolean;
     /**

package/types/Api.d.ts

@@ -0,0 +1,9 @@
+import HangupType from '../enums/HangupType';
+export interface IHangupParams {
+    conversationId: string;
+    reason: HangupType;
+    anonymToken?: string;
+    peerId?: string;
+    application_key?: string;
+    session_key?: string;
+}

package/types/Capabilities.d.ts

@@ -18,6 +18,7 @@ export type TCapabilities = {
     fastScreenShare: boolean;
     videoSuspend: boolean;
     simulcast: boolean;
+    simulcastNativeOrder: boolean;
     consumerFastScreenShare: boolean;
     consumerFastScreenShareQualityOnDemand: boolean;
     transparentAudio: boolean;

package/types/FastHangup.d.ts

@@ -0,0 +1,66 @@
+import type ClientHangupReason from '../enums/ClientHangupReason';
+import type HangupType from '../enums/HangupType';
+/**
+ * Параметры запроса завершения звонка через внешнего партнёра (fast hangup).
+ *
+ * SDK генерирует объект и передаёт его в {@link FastHangupHandler}.
+ * Хост и backend партнёра пробрасывают `internalParams` как есть, без парсинга.
+ */
+export interface FastHangupParams {
+    /**
+     * ID звонка
+     */
+    conversationId: string;
+    /**
+     * Причина завершения звонка
+     */
+    reason: HangupType;
+    /**
+     * Внутренние параметры звонка (JSON-строка). Генерируется SDK.
+     */
+    internalParams?: string | null;
+}
+/**
+ * Ответ внешнего партнёра на завершение звонка.
+ */
+export interface FastHangupResponse {
+    /**
+     * true — участие в звонке завершено
+     */
+    success: boolean;
+}
+/**
+ * Параметры публичных методов {@link hangup} / {@link declineCall}.
+ *
+ * `reason` и `conversationId` идут в signaling hangup.
+ * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
+ * (явный hangup/decline или delayed hangup во время init).
+ * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
+ * где SDK всегда шлёт beacon, и delayed hangup без handler.
+ */
+export interface HangupParams {
+    /**
+     * ID звонка. Если опущен — завершается текущий активный звонок.
+     */
+    conversationId?: string;
+    /**
+     * Причина завершения для проброса в сигналинг. См. {@link ClientHangupReason}.
+     */
+    reason?: ClientHangupReason;
+    /**
+     * Обработчик fast hangup — завершение звонка через внешнего партнёра.
+     */
+    onFastHangup?: FastHangupHandler;
+}
+/**
+ * Функция-обработчик fast hangup.
+ *
+ * Если передана в {@link HangupParams.onFastHangup} при `hangup` / `declineCall`,
+ * SDK вызывает её вместо API `vchat.hangupConversation`.
+ *
+ * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
+ *
+ * @param params Параметры запроса
+ * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
+ */
+export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;

package/types/Participant.d.ts

@@ -49,6 +49,7 @@ export interface ParticipantSessionState {
 }
 export interface ParticipantConnectionStatus {
     transport: ParticipantStatus;
+    stalled: boolean;
     sessionState?: ParticipantSessionState;
     sessionStateApplicable: boolean;
     sessionStateConnectedBySpeaker: boolean;

package/types/PerfStatReporter.d.ts

@@ -24,10 +24,6 @@ export interface CallStatReport {
     audio_concealment_events: number;
     inbound_video_count: number;
     inbound_audio_count: number;
-    packets_lost_video: number;
-    packets_sent_video: number;
-    packets_lost_audio: number;
-    packets_sent_audio: number;
     freeze_count: number;
     total_freezes_duration: number;
     rtt: number;

package/types/SignalingCommand.d.ts

@@ -1,8 +1,10 @@
 import SignalingCommandType from '../enums/SignalingCommandType';
 import { SignalingResponse, SignalingSuccessResponse } from './SignalingMessage';
+export type SignalingCommandRoute = 'websocket' | 'producer';
 interface SignalingCommand<T extends SignalingResponse = SignalingSuccessResponse> {
     sequence: number;
     name: SignalingCommandType;
+    route: SignalingCommandRoute;
     statMarkName: string;
     params: object;
     responseTimer: number;

package/types/SignalingMessage.d.ts

@@ -188,6 +188,7 @@ declare namespace SignalingMessage {
         peerId: PeerId;
         mediaSettings: Partial<MediaSettings>;
         capabilities?: string;
+        externalId?: ExternalId;
     }
     export interface Hungup extends Notification {
         participantId: OkUserId;

package/utils/IceServers.d.ts

@@ -0,0 +1,2 @@
+import IceServer from '../types/IceServer';
+export declare function createIceServers(stunServer?: IceServer, turnServer?: IceServer): IceServer[];

package/utils/NavigatorPermissions.d.ts

@@ -2,8 +2,8 @@ type Device = 'camera' | 'microphone';
 type PermissionStatusState = typeof PermissionStatus.prototype.state;
 type EventListener = (name: Device, state: PermissionStatusState) => void;
 export declare class NavigatorPermissions {
-    private _cameraPermissionStatus;
-    private _microphonePermissionStatus;
+    private _cameraPermissionStatus?;
+    private _microphonePermissionStatus?;
     private _listener;
     static isSupported(): boolean;
     init(listener: EventListener): Promise<void>;

package/utils/SerializeLatest.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Последовательно выполняет операции, оставляя в очереди только последнее запрошенное значение.
+ * Возвращает ошибку, только если не удалось применить итоговое состояние.
+ */
+export declare function serializeLatest<T>(run: (value: T) => Promise<void> | undefined): (value: T) => Promise<void>;

package/classes/StatsLogger.d.ts

@@ -1,41 +0,0 @@
-import BaseApi from '../abstract/BaseApi';
-import BaseLogger from '../abstract/BaseLogger';
-import StatLog from '../enums/StatLog';
-import TransportTopology from '../enums/TransportTopology';
-type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
-export type LogClientStatsOptions = {
-    immediately?: boolean;
-    occurredAt?: number;
-    conversationId?: string | null;
-    deferUntilServerTime?: boolean;
-};
-/**
- * Класс отвечает за отправку различной информации в сервис статистики (события, статистика и подобное)
- */
-export default class StatsLogger extends BaseLogger {
-    private readonly _externalLogger;
-    private readonly _api;
-    private readonly _conversationIdProvider;
-    private readonly _topologyProvider;
-    private readonly _batchInterval;
-    private _batchedClientStats;
-    private _batchTimeout;
-    private _serverTimeDelta;
-    private _waitingForServerTime;
-    private _deferredClientStats;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
-    log(name: StatLog, value?: string, immediately?: boolean): void;
-    logClientStats(data: ClientStatsPayload, immediatelyOrOptions?: boolean | LogClientStatsOptions): void;
-    destroy(): void;
-    private _logClientStats;
-    private _getConversationId;
-    private _getCallTopology;
-    private _sendBatch;
-    private _startTimeout;
-    private _stopTimeout;
-    private _sendClientStats;
-    private _calculateServerTimeDelta;
-    private _flushDeferredClientStats;
-    private _now;
-}
-export {};