@vkontakte/calls-sdk 2.8.11-dev.5500645b.0 → 2.8.11-dev.69b107ee.0

package/static/Debug.d.ts

@@ -7,14 +7,33 @@ export declare enum DebugMessageType {
     WARN = "WARN",
     ERROR = "ERROR"
 }
+export type DebugMessageContext = {
+    readonly sessionId: string | null;
+    readonly conversationId: string | null;
+};
+export type DebugLogger = {
+    debug(...args: any[]): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+};
+export type DebugSessionLogger = DebugLogger & {
+    readonly sessionId: string | null;
+    readonly conversationId: string | null;
+    setConversationId(conversationId: string | null): void;
+};
 declare namespace Debug {
-    let debug: Function;
-    let log: Function;
-    let warn: Function;
-    let error: Function;
-    function enabled(): boolean;
-    function toggle(enable: boolean): void;
-    function send(type: DebugMessageType, ...args: any[]): void;
-    function test(tag: string, ...args: any[]): void;
+    type ContextProvider = () => DebugMessageContext;
+    export function debug(...args: any[]): void;
+    export function log(...args: any[]): void;
+    export function warn(...args: any[]): void;
+    export function error(...args: any[]): void;
+    export function enabled(): boolean;
+    export function toggle(enable: boolean): void;
+    export function send(type: DebugMessageType, ...args: any[]): void;
+    export function createLogger(getContext: ContextProvider): DebugLogger;
+    export function createSessionLogger(initialConversationId?: string | null): DebugSessionLogger;
+    export function test(tag: string, ...args: any[]): void;
+    export {};
 }
 export default Debug;

package/static/External.d.ts

@@ -446,6 +446,9 @@ declare namespace External {
      * @param args
      */
     function onDebugMessage(type: DebugMessageType, ...args: any[]): void;
+    function onDebugMessageWithContext(type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]): void;
     /**
      * Статистика звонка
      *
@@ -563,9 +566,5 @@ declare namespace External {
      * Собеседник подключился к сигналлингу
      */
     function onPeerRegistered(): void;
-    /**
-     * Дебаг информация по видеопотоку, отформатированная SDK для отображения в клиенте.
-     */
-    function onVideoStreamDebug(externalParticipantId: ExternalParticipantId, debug: string): void;
 }
 export default External;

package/static/Params.d.ts

@@ -104,13 +104,6 @@ export type ParamsObject = {
     debugLog: boolean;
     /** @hidden */
     debug: boolean;
-    /**
-     * Вкчлючает отправку на клиент статы по входящим/исходящим видео-потокам
-     * @hidden
-     *
-     * _По умолчанию: `false`_
-     */
-    debugVideoStreams: boolean;
     /**
      * Выставляет таймаут в ms для fetch запросов от sdk
      * По умолчанию 5000 ms
@@ -313,6 +306,12 @@ export type ParamsObject = {
      * _По умолчанию: `30`_
      */
     videoTracksCount: number;
+    /**
+     * Минимальный интервал отправки diff для requestDisplayLayout в миллисекундах.
+     *
+     * _По умолчанию: `250`_
+     */
+    requestDisplayLayoutThrottleMs: number;
     /** @hidden */
     movieShare: boolean;
     /** @hidden */
@@ -737,6 +736,12 @@ export type ParamsObject = {
      * Получено отладочное сообщение. Работает только при выключенном режиме отладки
      */
     onDebugMessage?: (type: DebugMessageType, ...args: any[]) => void;
+    /**
+     * Получено отладочное сообщение с контекстом звонка. Работает только при выключенном режиме отладки
+     */
+    onDebugMessageWithContext?: (type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]) => void;
     /**
      * Статистика звонка
      */
@@ -870,15 +875,6 @@ export type ParamsObject = {
      * Собеседник подключился к сигналлингу
      */
     onPeerRegistered?: () => void;
-    /**
-     * Дебаг информация по видеопотоку, отформатированная SDK для отображения в клиенте.
-     *
-     * Работает только если включен `debugVideoStreams`.
-     *
-     * @param externalParticipantId Id участника, к которому относится видеопоток
-     * @param debug Отформатированный текст для отображения
-     */
-    onVideoStreamDebug?: (externalParticipantId: ExternalParticipantId, debug: string) => void;
 };
 export default abstract class Params {
     private static _params;
@@ -930,7 +926,6 @@ export default abstract class Params {
     static get waitMessageDelay(): number;
     static get waitAnotherTabDelay(): number;
     static get debugLog(): boolean;
-    static get debugVideoStreams(): false | ((externalParticipantId: ExternalParticipantId, debug: string) => void) | undefined;
     static get forceRelayPolicy(): boolean;
     static set forceRelayPolicy(value: boolean);
     static get videoMinWidth(): number;
@@ -980,6 +975,7 @@ export default abstract class Params {
     static get audioNack(): boolean;
     static get movieShare(): boolean;
     static get videoTracksCount(): number;
+    static get requestDisplayLayoutThrottleMs(): number;
     static get breakVideoPayloadTypes(): boolean;
     static get useCallsToContacts(): boolean;
     static get useParticipantListChunk(): boolean;
@@ -1027,6 +1023,7 @@ export default abstract class Params {
         screenShareCongestionControl: boolean;
         screenShareCongestionControlThreshold: number;
         videoTracksCount: number;
+        requestDisplayLayoutThrottleMs: number;
         asrDataChannel: boolean;
         videoMaxHeight: number;
         videoMaxWidth: number;

package/static/Utils.d.ts

@@ -3,6 +3,7 @@ import { ExternalParticipant, ExternalParticipantListMarker } from '../types/Ext
 import { CompositeUserId, OkUserId, Participant, ParticipantId, ParticipantStateMapped } from '../types/Participant';
 import SignalingMessage from '../types/SignalingMessage';
 import VideoSettings from '../types/VideoSettings';
+import { type DebugLogger } from './Debug';
 export declare const PARAMETERS_SEPARATOR = ":";
 export declare const DEVICE_IDX_PARAMETER = "d";
 /** @hidden */
@@ -36,8 +37,8 @@ declare namespace Utils {
     function delay(time: number, { signal }?: {
         signal?: AbortSignal;
     }): Promise<void>;
-    function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any): any;
-    function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any): void;
+    function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any, debug?: DebugLogger): any;
+    function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any, debug?: DebugLogger): void;
     /**
      * Проверяет, есть ли в первом массиве хотя бы один элемент из второго массива
      * @param arr Где ищем

package/static/WebRTCUtils.d.ts

@@ -2,6 +2,8 @@
  * Вспомогательный плагин для работы с WebRTC
  */
 import { IVideoDimentions } from '../types/MediaSettings';
+import type StatsLogger from '../classes/StatsLogger';
+import { type DebugLogger } from './Debug';
 /**
  * Тип камеры мобильного устройства
  */
@@ -75,6 +77,7 @@ declare namespace WebRTCUtils {
      * Проверяет получены ли разрешения, необходимые для текущего звонка
      */
     function hasPermissions(needVideo?: boolean): boolean;
+    function releaseFirefoxMicrophonePermissionWarmup(): void;
     /**
      * Запрашивает камеру и микрофон пользователя
      *
@@ -82,24 +85,24 @@ declare namespace WebRTCUtils {
      * @param needAudio Нужно ли аудио
      * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
      */
-    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean): Promise<MediaStream>;
+    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
      */
-    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean): Promise<MediaStream>;
+    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает камеру пользователя
      *
      * @param deviceId ID устройства
      * @param resolution Размеры видео
      */
-    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions): Promise<MediaStream>;
+    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Запрашивает микрофон пользователя
      *
      * @param deviceId ID устройства
      */
-    function getUserAudio(deviceId?: string): Promise<MediaStream>;
+    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
     /**
      * Устанавливает размер видео в стриме
      *

package/types/Conversation.d.ts

@@ -1,4 +1,4 @@
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 import CallDirection from '../enums/CallDirection';
 import CallType from '../enums/CallType';
 import ConversationFeature from '../enums/ConversationFeature';

package/types/FastStart.d.ts

@@ -31,6 +31,7 @@ export interface FastStartParams {
     conversationId: string;
     internalParams: string;
     externalIds?: ExternalId[];
+    payload: string;
     opponentType: CallType;
     mediaOptions: MediaOption[];
     joiningAllowed?: boolean;

package/types/ParticipantLayout.d.ts

@@ -54,4 +54,37 @@ export type ParticipantLayout = (Layout | StopStream | RequestKeyFrame) & {
      */
     streamName?: string;
 };
+/**
+ * Запрос стрима, который клиент хочет получать для отображения.
+ */
+export type DisplayLayoutRequest = {
+    /**
+     * Внешний ID пользователя
+     */
+    uid: ExternalParticipantId | string;
+    /**
+     * Тип медиа (видео с камеры, картинка с экрана, лайв или мувик)
+     */
+    mediaType: MediaType;
+    /**
+     * Ширина окошка в котором отображается видео, в пикселях
+     */
+    width: number;
+    /**
+     * Высота окошка в котором отображается видео, в пикселях
+     */
+    height: number;
+    /**
+     * Отображать видео как CSS object-fit: cover. По умолчанию используется contain.
+     */
+    cover?: boolean;
+    /**
+     * Приоритет
+     */
+    priority?: number;
+    /**
+     * ID лайва или мувика. null для камеры или скрин-шары.
+     */
+    streamName?: string;
+};
 export default ParticipantLayout;

package/types/PerfStatReporter.d.ts

@@ -41,10 +41,11 @@ export interface CallStatReport {
     remote_connection_type?: RTCIceCandidateType;
 }
 export interface ICallStatLog extends Pick<CallStatReport, 'call_topology' | 'nack_sent' | 'nack_received' | 'pli_sent' | 'pli_received' | 'fir_sent' | 'fir_received' | 'frames_dropped' | 'stat_time_delta'>, Pick<Partial<CallStatReport>, 'rtt' | 'jitter_video' | 'jitter_audio' | 'interframe_delay_variance' | 'freeze_count' | 'total_freezes_duration' | 'ss_freeze_count' | 'ss_total_freezes_duration' | 'inserted_audio_samples_for_deceleration' | 'removed_audio_samples_for_acceleration' | 'concealed_audio_samples' | 'total_audio_energy' | 'local_address' | 'local_connection_type' | 'network_type' | 'transport' | 'remote_address' | 'remote_connection_type'> {
+    is_simulcast?: boolean;
     concealed_silent_audio_samples?: number;
     concealment_audio_avg_size?: number;
     video_loss?: number;
     audio_loss?: number;
     cpu_hardware_concurrency?: number;
-    [k: string]: string | number | undefined;
+    [k: string]: string | number | boolean | undefined;
 }

package/types/PushData.d.ts

@@ -1,8 +1,11 @@
+import IceServer from './IceServer';
 type PushData = {
     caller_id: string;
     caller_client_type?: string;
     conversation_id: string;
     endpoint: string;
+    wt_endpoint?: string;
+    turn_server?: IceServer;
     is_video: boolean;
     token: string;
     sdp_offer?: string;

package/types/SignalingMessage.d.ts

@@ -1,5 +1,5 @@
 import { AnimojiVersion } from '@vkontakte/calls-vmoji';
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 import ChatRoomEventType from '../enums/ChatRoomEventType';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
@@ -190,6 +190,7 @@ declare namespace SignalingMessage {
         deviceIdx?: number;
         peerId: PeerId;
         reason: HangupType;
+        errorCode?: string;
         markers?: ParticipantListMarkers;
     }
     export interface ClosedConversation extends Notification {
@@ -366,6 +367,9 @@ declare namespace SignalingMessage {
     export interface Connection extends Notification {
         endpoint: string;
         conversation: Conversation;
+        conversationParams: {
+            serverTime: number;
+        };
         isConcurrent: boolean;
         peerId: PeerId;
         mediaModifiers: MediaModifiers;

package/types/Statistics.d.ts

@@ -1,4 +1,4 @@
-import { TransportTopology } from '../classes/transport/Transport';
+import TransportTopology from '../enums/TransportTopology';
 export type StatTransport = {
     timestamp: number;
     availableOutgoingBitrate: number;
@@ -113,10 +113,6 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Идентификатор пользователя, связанный с этим потоком
      */
     userId?: string;
-    /**
-     * Идентификатор media track, связанный с этим RTP потоком
-     */
-    trackId?: string;
     /**
      * Пропускная способность в битах в секунду
      */

package/types/WebTransport.d.ts

@@ -7,6 +7,8 @@ declare class WebTransportEventual {
     private readonly url;
     private readonly options;
     private readonly compression;
+    private closeRequested;
+    private closeEventEmitted;
     private encoder;
     private decoder;
     onopen: ((this: WebTransportEventual, ev: Event) => any) | null;
@@ -20,7 +22,10 @@ declare class WebTransportEventual {
     private readChunks;
     private readLoop;
     send(data: string): Promise<void>;
+    private createErrorEvent;
     close(code?: number, reason?: string): void;
+    private closeConnectedTransport;
+    private emitClose;
     static isBrowserSupported(): boolean;
 }
 export { WebTransportEventual as WebTransport };

package/utils/DebugStorage.d.ts

@@ -1,8 +1,107 @@
+/**
+ * Запись отладочного лога SDK.
+ */
 export type CurrentLogItem = {
     readonly t: number;
     readonly l: string;
     readonly d: any[];
     readonly h: string;
 };
-export declare function add(level: string, args: any[]): void;
+/**
+ * Информация о сохраненной локальной сессии логирования.
+ */
+export type DebugLogSessionInfo = {
+    /**
+     * Внутренний id локальной сессии логирования.
+     */
+    readonly sessionId: string;
+    /**
+     * Id звонка. Может быть null, если звонок не успел стартовать.
+     */
+    readonly conversationId: string | null;
+    /**
+     * Время первой записи в ms.
+     */
+    readonly startTime: number;
+    /**
+     * Время последней записи в ms.
+     */
+    readonly endTime: number;
+    /**
+     * Время последнего обновления в ms.
+     */
+    readonly updatedAt: number;
+    /**
+     * Размер сохраненных данных в байтах.
+     */
+    readonly bytes: number;
+    /**
+     * Количество записей лога.
+     */
+    readonly entriesCount: number;
+};
+/**
+ * Статистика локального хранилища отладочных логов.
+ */
+export type DebugLogStorageStats = {
+    /**
+     * Доступен ли IndexedDB для сохранения логов.
+     */
+    readonly supported: boolean;
+    /**
+     * Количество сохраненных звонков.
+     */
+    readonly callsCount: number;
+    /**
+     * Количество локальных сессий логирования.
+     */
+    readonly sessionsCount: number;
+    /**
+     * Размер сохраненных логов SDK в байтах.
+     */
+    readonly usedBytes: number;
+    /**
+     * Максимальный размер DebugStorage в байтах.
+     */
+    readonly maxBytes: number;
+    /**
+     * Максимальное количество звонков в DebugStorage.
+     */
+    readonly maxCalls: number;
+    /**
+     * Общая квота браузерного хранилища, если доступна.
+     */
+    readonly quotaBytes?: number;
+    /**
+     * Использование браузерного хранилища, если доступно.
+     */
+    readonly usageBytes?: number;
+};
+/**
+ * Параметры чтения или очистки локальных логов.
+ */
+export type DebugLogGetParams = {
+    /**
+     * Id звонка. Вернет все локальные сессии с этим conversationId.
+     */
+    readonly conversationId: string;
+    readonly sessionId?: never;
+} | {
+    /**
+     * Внутренний id локальной сессии из debugLogs.list().
+     */
+    readonly sessionId: string;
+    readonly conversationId?: never;
+};
+export declare function add(level: string, args: any[], sessionId?: string): CurrentLogItem;
 export declare function init(): void;
+export declare function startConversationSession(): string;
+export declare function setConversationId(conversationId: string | null, sessionId?: string): void;
+export declare function list(): Promise<DebugLogSessionInfo[]>;
+export declare function get(params: DebugLogGetParams): Promise<CurrentLogItem[]>;
+export declare function getJson(params: DebugLogGetParams): Promise<string>;
+export declare function download(params: DebugLogGetParams): Promise<string>;
+export declare function clear(params?: DebugLogGetParams): Promise<void>;
+export declare function stats(): Promise<DebugLogStorageStats>;
+export declare function getAllJson(): Promise<string>;
+export declare function downloadAll(): Promise<string>;

package/classes/Logger.d.ts

@@ -1,41 +0,0 @@
-import BaseApi from '../abstract/BaseApi';
-import BaseLogger from '../abstract/BaseLogger';
-import StatLog from '../enums/StatLog';
-/**
- * Класс отвечает за отправку различной информации в сервис статистики (события, статистика и подобное)
- */
-export default class Logger extends BaseLogger {
-    private static _instance;
-    private static _conversationIdProvider;
-    static setConversationIdProvider(provider: () => string | null): void;
-    static create(api: BaseApi, externalLogger: BaseLogger | null): void;
-    static log(name: StatLog, value?: string, immediately?: boolean): void;
-    static logCustom(name: StatLog, params: Record<string, string | number>, immediately?: boolean): void;
-    static logClientStats(params: Record<string, string | number | undefined | null>, immediately?: boolean): void;
-    static logClientEvent(params: Record<string, string | number | undefined | null>, immediately?: boolean): void;
-    static destroy(): void;
-    private readonly _externalLogger;
-    private readonly _api;
-    private readonly _batchInterval;
-    private _batchedLogItems;
-    private _batchedClientStats;
-    private _batchedClientEvents;
-    private _batchTimeout;
-    private _serverTimeDelta;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null);
-    log(name: StatLog, value?: string, immediately?: boolean): void;
-    logCustom(name: string, params: Record<string, string | number>, immediately?: boolean): void;
-    logClientStats(data: Record<string, string | number | undefined | null>, immediately?: boolean): void;
-    logClientEvent(data: Record<string, string | number | undefined | null>, immediately?: boolean): void;
-    destroy(): void;
-    private _logInternal;
-    private _getConversationId;
-    private _sendBatch;
-    private _startTimeout;
-    private _stopTimeout;
-    private _sendLogItems;
-    private _sendClientStats;
-    private _sendClientEvents;
-    private _calculateServerTimeDelta;
-    private _now;
-}

package/classes/stat/EventMetricsService.d.ts

@@ -1,9 +0,0 @@
-import HangupReason from '../HangupReason';
-import { TransportTopology } from '../transport/Transport';
-/**
- * Класс для работы с событийными метриками, обертка для правильной отправки событий
- */
-export declare class EventMetricsService {
-    private static correctHangupReason;
-    static sendHangupEvent(reason: HangupReason, topology?: TransportTopology): void;
-}

package/static/ConversationDebugLogger.d.ts

@@ -1,13 +0,0 @@
-import { CurrentLogItem } from '../utils/DebugStorage';
-export declare class ConversationDebugLogger {
-    private static _list;
-    private static _conversationId;
-    static get startTime(): number;
-    static get endTime(): number;
-    static startSession(): void;
-    static get conversationId(): string | null;
-    static set conversationId(conversationId: string | null);
-    static add(item: CurrentLogItem): void;
-    private static _createContextLogs;
-    static collectLogs(): CurrentLogItem[];
-}

package/static/DebugVideoStats.d.ts

@@ -1,22 +0,0 @@
-import { ExternalParticipantId } from '../types/ExternalId';
-export declare const enum VideoStreamDebugDirection {
-    INBOUND = "inbound",
-    OUTBOUND = "outbound"
-}
-export type VideoStreamDebugData = {
-    direction: VideoStreamDebugDirection;
-    externalParticipantId: ExternalParticipantId;
-    trackId?: string;
-    mimeType?: string;
-    width?: number;
-    height?: number;
-    frameRate?: number;
-    bitrate?: number;
-    packetsLost?: number;
-};
-declare namespace DebugVideoStats {
-    function format(data: VideoStreamDebugData): string;
-    function send(data: VideoStreamDebugData): void;
-    function clear(externalParticipantId: ExternalParticipantId): void;
-}
-export default DebugVideoStats;