@vkontakte/calls-sdk 2.8.11-dev.4fa379f4.0 → 2.8.11-dev.553e9358.0

package/static/External.d.ts

@@ -284,15 +284,14 @@ declare namespace External {
     /**
      * Разрешения на доступы были запрошены в браузере
      */
-    function onPermissionsRequested(conversationId?: string): void;
+    function onPermissionsRequested(): void;
     /**
      * Ошибка получения трека с камеры или микрофона
      *
      * @param error
      * @param original
-     * @param conversationId
      */
-    function onPermissionsError(error: FatalError, original: Error, conversationId?: string): void;
+    function onPermissionsError(error: FatalError, original: Error): void;
     /**
      * Пользователь отключился от звонка
      *
@@ -419,9 +418,8 @@ declare namespace External {
      *
      * @param volume
      * @param isMicEnabled
-     * @param conversationId
      */
-    function onLocalVolume(volume: number, isMicEnabled: boolean, conversationId?: string): void;
+    function onLocalVolume(volume: number, isMicEnabled: boolean): void;
     function onJoinStatus(available: boolean, chatId: string, conversationId?: string): void;
     /**
      * Звонок был завершен
@@ -430,19 +428,19 @@ declare namespace External {
      * @param conversationId ID звонка
      */
     function onHangup(data: HangupReason, conversationId: string | null): void;
-    function onMultipartyChatCreated(conversation: ConversationData, conversationId?: string): void;
+    function onMultipartyChatCreated(conversation: ConversationData): void;
     /**
      * Список устройств изменился
      */
-    function onDeviceChange(conversationId?: string): void;
+    function onDeviceChange(): void;
     /**
      * Изменилась подпись звонка 1:1
      */
-    function onFingerprintChange(fingerprint: string, conversationId?: string): void;
+    function onFingerprintChange(fingerprint: string): void;
     /**
      * Требуется обновление токена
      */
-    function onTokenExpired(conversationId?: string): void;
+    function onTokenExpired(): void;
     /**
      * Получено сообщение чата
      *
@@ -505,18 +503,20 @@ declare namespace External {
      * @param args
      */
     function onDebugMessage(type: DebugMessageType, ...args: any[]): void;
+    function onDebugMessageWithContext(type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]): void;
     /**
      * Статистика звонка
      *
      * @param connection Статистика соединения
      * @param memory Статистика памяти
-     * @param conversationId
      */
-    function onStatistics(connection: StatResult, memory: Record<string, number>, conversationId?: string): void;
+    function onStatistics(connection: StatResult, memory: Record<string, number>): void;
     /**
      * Ошибка воспроизведения звука
      */
-    function onAutoplayError(conversationId?: string): void;
+    function onAutoplayError(): void;
     /**
      * Изменилось состояние зала ожидания/зала в режиме Audience
      *

package/static/Params.d.ts

@@ -306,6 +306,12 @@ export type ParamsObject = {
      * _По умолчанию: `30`_
      */
     videoTracksCount: number;
+    /**
+     * Минимальный интервал отправки diff для requestDisplayLayout в миллисекундах.
+     *
+     * _По умолчанию: `250`_
+     */
+    requestDisplayLayoutThrottleMs: number;
     /** @hidden */
     movieShare: boolean;
     /** @hidden */
@@ -618,11 +624,11 @@ export type ParamsObject = {
     /**
      * Разрешения на доступы были запрошены в браузере
      */
-    onPermissionsRequested?: (conversationId?: string) => void;
+    onPermissionsRequested?: () => void;
     /**
      * Ошибка получения трека с камеры или микрофона
      */
-    onPermissionsError?: (error: FatalError, original: Error, conversationId?: string) => void;
+    onPermissionsError?: (error: FatalError, original: Error) => void;
     /**
      * Пользователь отключился от звонка
      */
@@ -674,8 +680,8 @@ export type ParamsObject = {
     /**
      * Громкость своего микрофона
      */
-    onLocalVolume?: (volume: number, isMicEnabled: boolean, conversationId?: string) => void;
-    onJoinStatus?: (conversationId?: string) => void;
+    onLocalVolume?: (volume: number, isMicEnabled: boolean) => void;
+    onJoinStatus?: (available: boolean, chatId: string, conversationId?: string) => void;
     /**
      * Звонок был завершен
      */
@@ -692,16 +698,16 @@ export type ParamsObject = {
     /**
      * Список устройств изменился
      */
-    onDeviceChange?: (conversationId?: string) => void;
+    onDeviceChange?: () => void;
     onMultipartyChatCreated?: (conversation: ConversationData) => void;
     /**
      * Изменилась подпись звонка 1:1
      */
-    onFingerprintChange?: (fingerprint: string, conversationId?: string) => void;
+    onFingerprintChange?: (fingerprint: string) => void;
     /**
      * Требуется обновление токена
      */
-    onTokenExpired?: (conversationId?: string) => void;
+    onTokenExpired?: () => void;
     /**
      * Получено сообщение чата
      */
@@ -737,14 +743,20 @@ export type ParamsObject = {
      * Получено отладочное сообщение. Работает только при выключенном режиме отладки
      */
     onDebugMessage?: (type: DebugMessageType, ...args: any[]) => void;
+    /**
+     * Получено отладочное сообщение с контекстом звонка. Работает только при выключенном режиме отладки
+     */
+    onDebugMessageWithContext?: (type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]) => void;
     /**
      * Статистика звонка
      */
-    onStatistics?: (stats: {}, conversationId?: string) => void;
+    onStatistics?: (stats: {}) => void;
     /**
      * Ошибка воспроизведения звука
      */
-    onAutoplayError?: (conversationId?: string) => void;
+    onAutoplayError?: () => void;
     /**
      * Изменилось состояние зала ожидания/зала в режиме Audience
      *
@@ -976,6 +988,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;
@@ -1024,6 +1037,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';
 /**
  * Тип камеры мобильного устройства
  */
@@ -83,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/Participant.d.ts

@@ -72,6 +72,7 @@ export interface Participant {
     clientType: string;
     roles: UserRole[];
     participantState: ParticipantStateMapped;
+    isOnHold?: boolean;
     networkRating: number;
     lastRequestedLayouts: {
         [key: StreamDescriptionString]: ParticipantLayout;

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/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 {

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;

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;
@@ -22,6 +24,8 @@ declare class WebTransportEventual {
     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/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[];
-}