@vkontakte/calls-sdk 2.8.11-beta.2 → 2.8.11-beta.4

package/classes/stat/StatFirstMediaReceived.d.ts

@@ -1,21 +1,25 @@
-import { TransportTopology } from '../transport/Transport';
+import TransportTopology from '../../enums/TransportTopology';
+import { StatAggregator } from './StatAggregator';
 /** связанный с операцией `first_media_received` тип логируемого звонка */
 declare enum ECallType {
     DirectOutgoing = "direct_outgoing",
     DirectIncoming = "direct_incoming",
+    DirectJoin = "direct_join",
     ServerIncoming = "server_incoming",
     ServerJoinServer = "server_join_server",
     ServerChangeTopology = "server_change_topology"
 }
 export declare class StatFirstMediaReceived {
+    private readonly _statAggregator;
     /** уже поставили засечку на приём звонка */
     protected _isCallMarked: boolean;
     protected _isFinished: boolean;
     protected _callType: ECallType | null;
+    constructor(statAggregator: StatAggregator);
     markAcceptCall(topology: TransportTopology): void;
     markAcceptedCall(topology?: TransportTopology): void;
-    markParticipantJoined(topology: TransportTopology): void;
     markOnJoin(topology: TransportTopology): void;
+    markTopologyChanged(topology: TransportTopology): void;
     private mark;
     measure(): void;
 }

package/classes/stat/StatPings.d.ts

@@ -1,17 +1,17 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import { TransportTopology } from '../transport/Transport';
+import StatsLogger from '../StatsLogger';
+import TransportTopology from '../../enums/TransportTopology';
 export declare class StatPings {
-    private static _instance?;
-    static create(): void;
+    private readonly _logger;
+    private trackerByTransport;
+    private lastSeen;
+    constructor(logger: StatsLogger);
     /**
      * Вызывать при входящем ping в сигналингу.
      * Будет произведен расчет времени между пингами.
      */
-    static mark(transport: SignalingTransportType): void;
+    mark(transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
-    static logMetrics(topology?: TransportTopology): void;
-    static destroy(): void;
-    private trackerByTransport;
-    private lastSeen;
-    private _destroy;
+    logMetrics(topology?: TransportTopology): void;
+    destroy(): void;
 }

package/classes/stat/StatScreenShareFirstFrame.d.ts

@@ -1,7 +1,9 @@
 import { ParticipantId } from '../../types/Participant';
+import { StatAggregator } from './StatAggregator';
 export declare class StatScreenShareFirstFrame {
     protected readonly _participantId: ParticipantId;
+    private readonly _statAggregator;
     protected _firstFrameReceived: boolean;
-    constructor(participantId: ParticipantId);
+    constructor(participantId: ParticipantId, statAggregator: StatAggregator | null);
     measure(width: number, height: number): void;
 }

package/classes/stat/StatSignalingCommands.d.ts

@@ -1,12 +1,12 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import { TransportTopology } from '../transport/Transport';
+import StatsLogger from '../StatsLogger';
+import TransportTopology from '../../enums/TransportTopology';
 export declare class StatSignalingCommands {
-    private static _instance?;
-    static create(): void;
-    static mark(command: string, time: number, transport: SignalingTransportType): void;
-    /** Отправляем данные в стату */
-    static logMetrics(topology?: TransportTopology): void;
-    static destroy(): void;
+    private readonly _logger;
     private trackerByCommand;
-    private _destroy;
+    constructor(logger: StatsLogger);
+    mark(command: string, time: number, transport: SignalingTransportType): void;
+    /** Отправляем данные в стату */
+    logMetrics(topology?: TransportTopology): void;
+    destroy(): void;
 }

package/classes/transport/BaseTransport.d.ts

@@ -1,7 +1,7 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import TransportState from '../../enums/TransportState';
 import EventEmitter from '../EventEmitter';
 import { MediaSource } from '../MediaSource';
-import { TransportState } from './Transport';
 export default abstract class BaseTransport extends EventEmitter {
     protected readonly _signaling: BaseSignaling;
     protected readonly _mediaSource: MediaSource;

package/classes/transport/DirectStatReporter.d.ts

@@ -1,4 +1,5 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import { StatResult } from '../../types/Statistics';
 import EventEmitter from '../EventEmitter';
 import { WeightedAverage } from '../stat/WeightedAverage';
@@ -30,7 +31,8 @@ export default class DirectStatReporter extends EventEmitter {
     private readonly _networkLimits;
     private _lastStatSentTimestamp;
     private _currentState;
-    constructor(signaling: BaseSignaling);
+    private readonly _debug;
+    constructor(signaling: BaseSignaling, debug?: DebugLogger);
     private _calcRttRating;
     private _calcLossRating;
     private _calcBitrateRating;

package/classes/transport/DirectTransport.d.ts

@@ -1,8 +1,12 @@
 import type { AnimojiReceiver, AnimojiSender } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
+import StatsLogger from '../StatsLogger';
 import { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 import BaseTransport from './BaseTransport';
 export default class DirectTransport extends BaseTransport {
     private readonly _participantId;
@@ -34,7 +38,11 @@ export default class DirectTransport extends BaseTransport {
     private _lastBadConnection;
     private _perfStatReporter;
     private _directStatReporter;
-    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     get participantId(): ParticipantId;
     updateStatisticsInterval(): void;
     private _isDeadConnection;

package/classes/transport/PerfStatReporter.d.ts

@@ -1,5 +1,7 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import EventEmitter from '../EventEmitter';
+import { StatAggregator } from '../stat/StatAggregator';
 import DirectTransport from './DirectTransport';
 import ServerTransport from './ServerTransport';
 export default class PerfStatReporter extends EventEmitter {
@@ -10,7 +12,9 @@ export default class PerfStatReporter extends EventEmitter {
     private _screenShareStats;
     private _signaling;
     private readonly _directTopology;
-    constructor(transport: ServerTransport | DirectTransport, signaling: BaseSignaling, directTopology?: boolean);
+    private readonly _debug;
+    private readonly _statAggregator;
+    constructor(transport: ServerTransport | DirectTransport, signaling: BaseSignaling, statAggregator?: StatAggregator | null, directTopology?: boolean, debug?: DebugLogger);
     destroy(): void;
     static getEstimatedPerformanceIndex(): number;
     private _handleStats;

package/classes/transport/ServerTransport.d.ts

@@ -1,8 +1,12 @@
 import type { AnimojiReceiver, AnimojiSender } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
+import StatsLogger from '../StatsLogger';
 import { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 import BaseTransport from './BaseTransport';
 export default class ServerTransport extends BaseTransport {
     private _producerNotification;
@@ -39,7 +43,11 @@ export default class ServerTransport extends BaseTransport {
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
     close(error?: Error): void;
@@ -88,7 +96,7 @@ export default class ServerTransport extends BaseTransport {
     private _onAsrTranscription;
     private _onProducerUpdated;
     private _onAddTrack;
-    static _onSignalingStateChange(pc: RTCPeerConnection, event: any): void;
+    private _onSignalingStateChange;
     private _onConnectionStateChange;
     private _onReplacedTrack;
     private _onSourcesChanged;

package/classes/transport/Transport.d.ts

@@ -1,9 +1,15 @@
 import type { AnimojiSvgData, RGBTuple } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import TransportState from '../../enums/TransportState';
+import TransportTopology from '../../enums/TransportTopology';
+import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
 import EventEmitter from '../EventEmitter';
+import StatsLogger from '../StatsLogger';
 import { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 export declare const enum TransportEvent {
     REMOTE_TRACK_ADDED = "REMOTE_TRACK_ADDED",
     REMOTE_TRACK_REMOVED = "REMOTE_TRACK_REMOVED",
@@ -23,19 +29,6 @@ export declare const enum TransportEvent {
     ANIMOJI_ERROR = "ANIMOJI_ERROR",
     SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT"
 }
-export declare const enum TransportState {
-    IDLE = "IDLE",
-    OPENED = "OPENED",
-    CONNECTING = "CONNECTING",
-    RECONNECTING = "RECONNECTING",
-    CONNECTED = "CONNECTED",
-    CLOSED = "CLOSED",
-    FAILED = "FAILED"
-}
-export declare const enum TransportTopology {
-    DIRECT = "DIRECT",
-    SERVER = "SERVER"
-}
 export declare class Transport extends EventEmitter {
     private readonly _signaling;
     private readonly _mediaSource;
@@ -51,7 +44,11 @@ export declare class Transport extends EventEmitter {
     private _localState;
     private _animojiReceiver;
     private _animojiSender;
-    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
     allocate(participantId: ParticipantId, isMaster?: boolean): void;

package/default/Api.d.ts

@@ -8,9 +8,7 @@ import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
 export default class Api extends BaseApi {
     private _userId;
     private _uuid;
-    private _externalUidsCache;
-    private _decorativeIdToInitialId;
-    private _initialIdToDecorativeId;
+    private _idCache;
     private _callUnsafe;
     protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
     userId(participantId: ParticipantId): Promise<ExternalParticipantId>;
@@ -25,7 +23,7 @@ export default class Api extends BaseApi {
         audioOnly?: boolean;
         waitForAdmin?: boolean;
         closedConversation?: boolean;
-    }, speakerIds?: OkUserId[]): Promise<ConversationResponse>;
+    }, externalIds?: ExternalId[]): Promise<ConversationResponse>;
     startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, waitForAdmin }?: {
         onlyAdminCanShareMovie?: boolean;
         waitForAdmin?: boolean;
@@ -42,19 +40,13 @@ export default class Api extends BaseApi {
     }>;
     getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
     joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
-    /**
-     * NB: Не сохраняет порядок возвращаемых ID
-     * Этот метод принимает именно ExternalId, т.к. для OkUserId не принципиально наличие deviceIdx
-     * @hidden
-     */
-    getOkIdsByExternalIds(externalIds: ExternalId[]): Promise<OkUserId[]>;
-    getParticipantIdsByExternalIds(externalIds: ExternalId[]): Promise<Map<ExternalId, ParticipantId>>;
     /**
      * NB: Не сохраняет порядок возвращаемых ID
      * @hidden
      */
     getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;
     getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
     cacheExternalId(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
     mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
     unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;

package/default/Signaling.d.ts

@@ -1,13 +1,17 @@
 import BaseSignaling, { AddParticipantParams } from '../abstract/BaseSignaling';
+import StatsLogger from '../classes/StatsLogger';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
 import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
-import { TransportTopology } from '../classes/transport/Transport';
+import { StatAggregator } from '../classes/stat/StatAggregator';
+import { StatPings } from '../classes/stat/StatPings';
+import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
+import TransportTopology from '../enums/TransportTopology';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
-import SignalingCommandType from '../enums/SignalingCommandType';
 import SignalingConnectionType from '../enums/SignalingConnectionType';
 import UserRole from '../enums/UserRole';
+import { type DebugLogger } from '../static/Debug';
 import { JSONObject } from '../static/Json';
 import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
 import { ChangeSimulcast } from '../types/ChangeSimulcast';
@@ -21,41 +25,39 @@ import ParticipantLayout, { RequestKeyFrame, StopStream } from '../types/Partici
 import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import { StreamDescriptionString } from '../types/ParticipantStreamDescription';
 import { PerfStatReport } from '../types/PerfStatReporter';
-import SignalingMessage, { GetParticipantsSignalingResponse, GetRoomsSignalingResponse, SignalingSuccessResponse } from '../types/SignalingMessage';
-import { IPublishStreamData, IRecordConfData, IStartStreamData, IStopStreamData } from '../types/Streams';
+import SignalingMessage, { GetParticipantsSignalingResponse, GetRoomsSignalingResponse } from '../types/SignalingMessage';
+import { IPublishStreamData, IStartStreamData, IStopStreamData } from '../types/Streams';
 export default class Signaling extends BaseSignaling {
-    private socket;
-    protected sequence: number;
+    private transport;
+    private sequence;
     private lastStamp;
     private websocketCommandsQueue;
     private datachannelCommandsQueue;
     private incomingCache;
     private responseHandlers;
     private connectionType;
-    private reconnectCount;
-    private endpoint;
-    private wtEndpoint;
-    protected conversationResolve: Function | null;
-    protected conversationReject: Function | null;
+    private conversationResolve;
+    private conversationReject;
     private connected;
     private listenersReady;
-    protected peerId: number | null;
-    protected conversationId: string | null;
-    private reconnectTimer;
+    private peerId;
+    private conversationId;
     private connectionMessageWaitTimer;
-    private doctorTimer;
     private participantIdRegistry;
     private producerNotificationDataChannel;
     private producerCommandDataChannel;
     private producerCommandDataChannelEnabled;
     private producerCommandSerializationService;
-    private static get RECONNECT_DELAY();
-    private static get RECONNECT_MAX_DELAY();
-    private static get RECONNECT_MAX_COUNT();
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _statPings;
+    private readonly _statSignalingCommands;
     private static get WAIT_CONNECTION_DELAY();
     private static get WAIT_RESPONSE_DELAY();
-    private static get WAIT_MESSAGE_DELAY();
     get ready(): boolean;
+    constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
+    setAbortSignal(signal: AbortSignal | undefined): void;
     setEndpoint(endpoint: string): void;
     setWebTransportEndpoint(endpoint: string | null): void;
     setConversationId(conversationId: string): void;
@@ -71,15 +73,6 @@ export default class Signaling extends BaseSignaling {
      * Open a connection with a signaling server
      */
     connect(connectionType: SignalingConnectionType): Promise<SignalingMessage.Connection>;
-    /**
-     * Send a command to a signaling server
-     */
-    protected _send<T extends SignalingSuccessResponse>(command: SignalingCommandType, params?: any, needResponse?: boolean, retryCount?: number): Promise<T>;
-    /**
-     * Send a raw command to a signaling server
-     */
-    protected _sendRaw<T extends SignalingSuccessResponse>(command: SignalingCommandType, params?: any, needResponse?: boolean, retryCount?: number): Promise<T>;
-    private _isDataChannelCommand;
     getNextCommandSequenceNumber(): number;
     hangup(reason: string): Promise<SignalingMessage | void>;
     sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
@@ -119,7 +112,6 @@ export default class Signaling extends BaseSignaling {
     startStream(data: IStartStreamData): Promise<SignalingMessage>;
     stopStream(data?: IStopStreamData): Promise<SignalingMessage>;
     publishStream(data?: IPublishStreamData): Promise<SignalingMessage>;
-    recordSetConf(conf?: IRecordConfData): Promise<SignalingMessage>;
     getRecordStatus(): Promise<SignalingMessage>;
     switchTopology(topology: TransportTopology, force?: boolean): Promise<SignalingMessage>;
     requestRealloc(): Promise<SignalingMessage>;
@@ -163,34 +155,36 @@ export default class Signaling extends BaseSignaling {
     startAsr(params: IAsrStartParams): Promise<SignalingMessage>;
     stopAsr(params?: IAsrStopParams): Promise<SignalingMessage>;
     requestAsr(request: boolean): Promise<SignalingMessage>;
-    private _buildUrl;
-    protected _connect(connectionType: SignalingConnectionType, useWebTransport: boolean): void;
-    protected _disconnect(code?: number): void;
+    /**
+     * Send a command to a signaling server
+     */
+    private _send;
+    /**
+     * Send a raw command to a signaling server
+     */
+    private _sendRaw;
+    private _isDataChannelCommand;
     private _onOpen;
     private _onMessage;
-    protected _handleMessage(message: SignalingMessage): void;
+    private _handleMessage;
     private _handleErrorMessage;
-    protected _handleCachedMessages(): void;
+    private _handleCachedMessages;
     private _throwError;
     private _onError;
     private _serializeErrorEvent;
-    protected _onClose(event: CloseEvent): void;
-    protected _closeSocket(error?: Error | null): void;
-    protected _reconnect(): void;
+    private _onClose;
+    private _closeSocket;
     private _handleCommandResponse;
     private _handleCommandsQueue;
     private _startResponseTimer;
     private _serializeBinary;
     private _serializeJson;
     private _convertDisplayLayout;
-    protected _waitConnectionMessage(): void;
-    protected _stopWaitConnectionMessage(): void;
-    /**
-     * Отвечает за timeout логику в WebSocket, если неполучаем никаких сообщений в течении WAIT_MESSAGE_DELAY, то запускаем реконнект
-     */
-    private _startDoctor;
-    private _stopDoctor;
-    private isWebTransportAvailable;
+    private _waitConnectionMessage;
+    private _stopWaitConnectionMessage;
+    private _onTransportFailed;
+    private _onTransportReconnectScheduled;
+    private _onTransportConnectionDead;
     private _getSocketType;
     private _markTransportStat;
     private _logTransportStat;

package/default/SignalingTransport.d.ts

@@ -0,0 +1,68 @@
+import SignalingConnectionType from '../enums/SignalingConnectionType';
+import { SignalingTransportType } from '../enums/SignalingTransportStat';
+export declare enum SignalingTransportFailure {
+    EMPTY_ENDPOINT = "EMPTY_ENDPOINT",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    ABORTED = "ABORTED"
+}
+export type SignalingTransportFailedEvent = {
+    failure: SignalingTransportFailure;
+    message: string;
+    remote?: boolean;
+};
+export type SignalingTransportReconnectEvent = {
+    count: number;
+    delay: number;
+};
+export type SignalingTransportHandlers = {
+    onOpen: () => void;
+    onMessage: (event: MessageEvent) => void;
+    onError: (event: Event) => void;
+    onClose: (event: CloseEvent) => void;
+    onFailed: (event: SignalingTransportFailedEvent) => void;
+    onReconnectScheduled: (event: SignalingTransportReconnectEvent) => void;
+    onConnectionDead: () => void;
+};
+export default class SignalingTransport {
+    private readonly handlers;
+    private socket;
+    private endpoint;
+    private wtEndpoint;
+    private peerId;
+    private lastStamp;
+    private connectionType;
+    private reconnectCount;
+    private reconnectTimer;
+    private doctorTimer;
+    private forceWebSocket;
+    private abortSignal;
+    private manualClose;
+    private currentType;
+    constructor(handlers: SignalingTransportHandlers);
+    get readyState(): number | null;
+    get type(): SignalingTransportType;
+    setEndpoint(endpoint: string): void;
+    setWebTransportEndpoint(endpoint: string | null): void;
+    setPeerId(peerId: number | null): void;
+    setLastStamp(lastStamp: number): void;
+    setAbortSignal(signal?: AbortSignal): void;
+    resetReconnectCount(): void;
+    connect(connectionType: SignalingConnectionType): void;
+    close(code?: number): void;
+    send(data: string | ArrayBuffer): void;
+    private _connect;
+    private _connectWebTransport;
+    private _connectWebSocket;
+    private _setSocketHandlers;
+    private _buildUrl;
+    private _canUseWebTransport;
+    private _onOpen;
+    private _onMessage;
+    private _onError;
+    private _onClose;
+    private _disconnect;
+    private _scheduleReconnect;
+    private _getReconnectDelay;
+    private _startDoctor;
+    private _stopDoctor;
+}

package/enums/TransportState.d.ts

@@ -0,0 +1,10 @@
+declare const enum TransportState {
+    IDLE = "IDLE",
+    OPENED = "OPENED",
+    CONNECTING = "CONNECTING",
+    RECONNECTING = "RECONNECTING",
+    CONNECTED = "CONNECTED",
+    CLOSED = "CLOSED",
+    FAILED = "FAILED"
+}
+export default TransportState;

package/enums/TransportTopology.d.ts

@@ -0,0 +1,5 @@
+declare const enum TransportTopology {
+    DIRECT = "DIRECT",
+    SERVER = "SERVER"
+}
+export default TransportTopology;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.11-beta.2",
+  "version": "2.8.11-beta.4",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

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 {
-    function debug(...args: any[]): void;
-    function log(...args: any[]): void;
-    function warn(...args: any[]): void;
-    function error(...args: any[]): void;
-    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;
     /**
      * Статистика звонка
      *

package/static/Params.d.ts

@@ -306,6 +306,12 @@ export type ParamsObject = {
      * _По умолчанию: `30`_
      */
     videoTracksCount: number;
+    /**
+     * Минимальный интервал отправки diff для requestDisplayLayout в миллисекундах.
+     *
+     * _По умолчанию: `250`_
+     */
+    requestDisplayLayoutThrottleMs: number;
     /** @hidden */
     movieShare: boolean;
     /** @hidden */
@@ -730,6 +736,12 @@ export type ParamsObject = {
      * Получено отладочное сообщение. Работает только при выключенном режиме отладки
      */
     onDebugMessage?: (type: DebugMessageType, ...args: any[]) => void;
+    /**
+     * Получено отладочное сообщение с контекстом звонка. Работает только при выключенном режиме отладки
+     */
+    onDebugMessageWithContext?: (type: DebugMessageType, context: {
+        conversationId: string | null;
+    }, ...args: any[]) => void;
     /**
      * Статистика звонка
      */
@@ -963,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;
@@ -1010,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 Где ищем