@vkontakte/calls-sdk 2.8.6-dev.77dd3c9d.0 → 2.8.6-dev.785c0ce9.0

package/classes/Conversation.d.ts

@@ -3,7 +3,6 @@ import type { RGBTuple } from '@vkontakte/calls-vmoji';
 import BaseApi from '../abstract/BaseApi';
 import BaseLogger from '../abstract/BaseLogger';
 import { AddParticipantParams } from '../abstract/BaseSignaling';
-import CallType from '../enums/CallType';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
@@ -13,13 +12,13 @@ import UserType from '../enums/UserType';
 import { JSONObject } from '../static/Json';
 import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
 import { AudienceModeHandsResponse } from '../types/AudienceMode';
-import { ConversationData } from '../types/Conversation';
+import { ConversationData, ConversationOnStartParams } from '../types/Conversation';
 import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk, ExternalUserId } from '../types/ExternalId';
 import MediaModifiers from '../types/MediaModifiers';
 import { IVideoDimentions } from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 import MuteStates from '../types/MuteStates';
-import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId } from '../types/Participant';
+import { CompositeUserId, IGetParticipantsParameters, ParticipantId, ParticipantStateData } from '../types/Participant';
 import { ParticipantLayout } from '../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import ParticipantPriority from '../types/ParticipantPriority';
@@ -31,12 +30,14 @@ import EventEmitter from './EventEmitter';
 export default class Conversation extends EventEmitter {
     private readonly _api;
     private readonly _signaling;
+    private readonly _signalingActor;
     private _mediaSource;
     private _conversation;
     private _myLastRequestedLayouts;
     private _state;
     private _participantState;
     private _participants;
+    private _pendingParticipants;
     private _transport;
     private _debugInfo;
     private _volumesDetector;
@@ -66,7 +67,7 @@ export default class Conversation extends EventEmitter {
     static current(): Conversation | null;
     static hangupAfterInit(): void;
     static id(): string | null;
-    onStart(opponentIds: OkUserId[], opponentType: CallType, mediaOptions: MediaOption[], payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, onlyAdminCanShareMovie?: boolean): Promise<ConversationData>;
+    onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart }: ConversationOnStartParams): Promise<ConversationData>;
     onJoin(joinArgs: {
         conversationId?: string;
         mediaOptions: MediaOption[];
@@ -78,24 +79,28 @@ export default class Conversation extends EventEmitter {
     private _onJoinPart2;
     private _extractExternalRooms;
     private _extractExternalRoomsData;
-    onPush(conversationId: string, type?: UserType, peerId?: number): Promise<void>;
+    onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string, wsEndpoint?: string): Promise<void>;
     private _isInWaitingHall;
     private _isRestricted;
     private _isAudienceMode;
     private _isAudienceModeListener;
     private _acceptConcurrent;
     private _getMainRoomParticipants;
+    private _decodeExternalConversationParams;
+    private _logCallStartEvent;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
     decline(): Promise<void>;
     hangup(): Promise<void>;
-    addParticipant(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
+    addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
+    addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
     setVolume(volume: number): void;
     updateStatisticsInterval(): void;
     private _openTransport;
     private _close;
-    destroy(): void;
+    destroy(): Promise<void>;
     private _getConversationParams;
+    private _setConversationParams;
     private _addGeoParamsToEndpoint;
     /**
      * @throws ErrorEvent
@@ -189,7 +194,7 @@ export default class Conversation extends EventEmitter {
      * @deprecated Use updateDisplayLayout instead
      */
     changePriorities(priorities: ParticipantPriority[]): Promise<void>;
-    changeParticipantState(state: Record<string, string>, compositeUserId?: CompositeUserId): Promise<void>;
+    changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<void>;
     putHandsDown(): Promise<void>;
     requestKeyFrame(participantStreamDescription: ParticipantStreamDescription): Promise<void | SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string): Promise<void>;
@@ -216,6 +221,7 @@ export default class Conversation extends EventEmitter {
     private _onUrlSharingInfoUpdated;
     private _onFeaturesPerRoleChanged;
     private _waitForStreamIfNeeded;
+    private _getStreamDescriptionById;
     private _matchStreamDescription;
     private _getWaitingTime;
     private _isCallAdmin;
@@ -225,7 +231,7 @@ export default class Conversation extends EventEmitter {
     startAsr(params: IAsrStartParams): Promise<void>;
     stopAsr(params?: IAsrStopParams): Promise<void>;
     requestAsr(request: boolean): Promise<void>;
-    muteParticipant(participantId: string | null | undefined, muteStates: MuteStates, requestedMedia?: MediaOption[], roomId?: number | null): Promise<void>;
+    muteParticipant(participantId: (ParticipantId | null) | undefined, muteStates: MuteStates, requestedMedia?: MediaOption[], roomId?: number | null): Promise<void>;
     enableFeatureForRoles(feature: ConversationFeature, roles: UserRole[]): Promise<void>;
     pinParticipant(participantId: ParticipantId, unpin: boolean, roomId?: number | null): Promise<void>;
     updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<void>;
@@ -249,7 +255,7 @@ export default class Conversation extends EventEmitter {
     customData(data: JSONObject, participantId?: ParticipantId | null): Promise<void>;
     createJoinLink(): Promise<string>;
     removeJoinLink(): Promise<undefined>;
-    addMovie({ movieId, gain, metadata }: IAddMovieParams): Promise<{
+    addMovie({ movieId, gain, metadata, lang }: IAddMovieParams): Promise<{
         movieId: number;
         streamType: string;
     }>;
@@ -272,7 +278,7 @@ export default class Conversation extends EventEmitter {
     setLocalResolution({ video, effect }: {
         video: IVideoDimentions;
         effect?: IVideoDimentions;
-    }): Promise<void | undefined>;
+    }): Promise<void>;
     videoEffect(effect: IEffect | null): Promise<void | undefined>;
     audioEffect(effects: string[] | null, isPreset?: boolean): Promise<void | undefined>;
     _convertExternalIdsToServerExternalIds(externalIds: ExternalId[]): SignalingMessage.ExternalId[];
@@ -380,6 +386,9 @@ export default class Conversation extends EventEmitter {
     private _getMuteStatesForCurrentRoom;
     private _setMuteStatesForRoomId;
     private _forceOpenTransportForAloneInCall;
+    private _registerParticipant;
+    private _getParticipants;
+    private _getParticipant;
 }
 export declare class UpdateDisplayLayoutError extends Error {
     readonly participantErrors: {

package/classes/Logger.d.ts

@@ -11,7 +11,10 @@ export default class Logger extends BaseLogger {
     private _batchTimeout;
     private _serverTimeDelta;
     private static _instance;
+    private static _conversationIdProvider;
     constructor(api: BaseApi, externalLogger: BaseLogger | null);
+    static setConversationIdProvider(provider: () => string | null): void;
+    private _getConversationId;
     private _sendLogItems;
     private _sendClientStats;
     private _sendClientEvents;

package/classes/MediaSource.d.ts

@@ -5,6 +5,7 @@ import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
 import { ScreenCaptureSettings } from '../types/ScreenCaptureSettings';
 export declare const enum MediaSourceEvent {
     SOURCE_CHANGED = "SOURCE_CHANGED",
+    SOURCE_READY = "SOURCE_READY",
     TRACK_REPLACED = "TRACK_REPLACED",
     SCREEN_STATUS = "SCREEN_STATUS",
     ANIMOJI_STATUS = "ANIMOJI_STATUS"
@@ -22,11 +23,19 @@ interface AudioEffectParams {
     effects: string[];
     isPreset?: boolean;
 }
+/**
+ * тип источника (для сервера)
+ */
+export declare enum MediaSourceType {
+    CAMERA = 1,
+    SCREEN = 2
+}
 export declare class MediaSource extends EventEmitter {
     /** Стрим с камеры и микрофона пользователя */
     protected _stream: MediaStream | null;
     private _screenTrack;
     private _audioShareTrack;
+    private _screenShareTrack;
     /** Трек для отправки в медиа-канал. Может отличаться при скриншаринге в дата-канал */
     private _sendVideoTrack;
     /** Трек с камеры. В стриме будет другой трек при включенных видео эффектах */
@@ -44,6 +53,7 @@ export declare class MediaSource extends EventEmitter {
     private _animojiEnabled;
     /** вычисляем низкую производительность видео эффектов */
     private readonly _videoEffectsFpsLimiter?;
+    private _deviceChangeListener;
     constructor();
     request(mediaOptions?: MediaOption[], needEmptyTracks?: boolean): Promise<void>;
     getStream(): MediaStream | null;
@@ -76,6 +86,7 @@ export declare class MediaSource extends EventEmitter {
     private stopAudioShareTrack;
     private _applyAudioEffect;
     protected getSilentAudioShareTrack(): MediaStreamTrack;
+    protected getBlackScreenShareTrack(): MediaStreamTrack;
     protected _replaceLocalTrack(newTrack: MediaStreamTrack, sendTrack?: MediaStreamTrack): Promise<void>;
     private _setEffect;
     private _stopEffect;
@@ -90,6 +101,7 @@ export declare class MediaSource extends EventEmitter {
         video: IVideoDimentions;
         effect?: IVideoDimentions;
     }): Promise<void>;
+    getCameraVideoTrack(): MediaStreamTrack | null;
     updateNoiseSuppression(): Promise<void>;
     videoEffect(effect: IEffect | null): Promise<void>;
     audioEffect(audioEffectParams: AudioEffectParams | null): Promise<void>;
@@ -97,5 +109,6 @@ export declare class MediaSource extends EventEmitter {
     private handleVideoEffectsLowFps;
     private get _frameRate();
     private _applyVideoConstraints;
+    getScreenShareTrack(): MediaStreamTrack | null;
 }
 export {};

package/classes/ParticipantIdRegistry.d.ts

@@ -6,5 +6,6 @@ export declare class ParticipantIdRegistry {
     getStreamDescription(compactedId: number): ParticipantStreamDescription | undefined;
     getCompactId(streamDescription: string): number | undefined;
     handleMessage(data: ArrayBuffer): SignalingMessage | null;
+    private _decodeMediaType;
     private _createParticipantSourcesUpdateNotification;
 }

package/classes/ProducerCommandSerializationService.d.ts

@@ -5,6 +5,7 @@ import { EnableVideoSuspend } from '../types/EnableVideoSuspend';
 import { EnableVideoSuspendSuggest } from '../types/EnableVideoSuspendSuggest';
 import SignalingMessage from '../types/SignalingMessage';
 import { PerfStatReport } from '../types/PerfStatReporter';
+import { ChangeSimulcast } from '../types/ChangeSimulcast';
 import { SharingStatReport } from './screenshare/SharingStatReport';
 import { ParticipantIdRegistry } from './ParticipantIdRegistry';
 export declare class ProducerCommandSerializationService {
@@ -21,6 +22,7 @@ export declare class ProducerCommandSerializationService {
     serializeNetworkStatReport(sequenceNumber: number, report: NetworkStatReport): ArrayBuffer;
     serializeEnableVideoSuspend(sequenceNumber: number, params: EnableVideoSuspend): ArrayBuffer;
     serializeEnableVideoSuspendSuggest(sequenceNumber: number, params: EnableVideoSuspendSuggest): ArrayBuffer;
+    serializeChangeSimulcast(sequenceNumber: number, params: ChangeSimulcast): ArrayBuffer;
     deserializeCommandResponse(data: BufferSource | Blob): Promise<SignalingMessage | undefined>;
     private deserializeUpdateDisplayLayoutResponse;
     private deserializeReportPerfStatResponse;

package/classes/SignalingActor.d.ts

@@ -0,0 +1,9 @@
+import SignalingMessage from '../types/SignalingMessage';
+export declare class SignalingActor {
+    private processor;
+    private queue;
+    private isProcessing;
+    constructor(processor: (message: SignalingMessage) => Promise<unknown> | unknown);
+    add(message: SignalingMessage): void;
+    private processQueue;
+}

package/classes/codec/IEncoder.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="web" />
 import type { MessageType } from './Types';
 export default interface IEncoder {
     init(): Promise<void>;

package/classes/screenshare/BaseStreamBuilder.d.ts

@@ -15,7 +15,7 @@ export declare abstract class BaseStreamBuilder {
     destroy(): void;
     protected abstract _processFrame(frame: FrameData): void;
     private _processFrameData;
-    static getFrameSize(frameData: Uint8Array): {
+    static getFrameSize(frameData: Uint8Array<ArrayBuffer>): {
         width: number;
         height: number;
     };

package/classes/stat/CodecStatsAggregator.d.ts

@@ -0,0 +1,19 @@
+import { StatItem } from '../../types/Statistics';
+import { TransportTopology } from '../transport/Transport';
+export type CodecKind = 'audio' | 'video';
+/**
+ * Собирает стату по использованию кодеков в webrtc
+ * Каждый раз когда обновляется кодек или завершается звонок,
+ * отправляется репорт об использовании кодеков
+ */
+export declare class CodecStatsAggregator {
+    private static _instance;
+    private readonly _codecUsages;
+    private getCurrentTransportTopology;
+    static create(getCurrentTransportTopology: () => TransportTopology | undefined): void;
+    static reportUsage(stat: StatItem): void;
+    private saveUsage;
+    private report;
+    static destroy(): void;
+    private _destroy;
+}

package/classes/stat/EventMetricsService.d.ts

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

package/classes/transport/ServerTransport.d.ts

@@ -27,6 +27,7 @@ export default class ServerTransport extends BaseTransport {
     private _lastStat;
     private _serverSettings;
     private _prevConsumerSettings;
+    private _prevConsumerFastSharingSettings;
     private _asrTrack;
     private _captureSender;
     private _captureReceiver;
@@ -35,6 +36,7 @@ export default class ServerTransport extends BaseTransport {
     private _rtpReceiversByStreamId;
     private _producerSessionId;
     private _newAudioShareTrack;
+    private _simulcastInfo;
     constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
@@ -44,6 +46,7 @@ export default class ServerTransport extends BaseTransport {
     allowRestart(): void;
     updateSettings(settings: ServerSettings): void;
     setAnimojiTransport(receiver: AnimojiReceiver, sender: AnimojiSender): void;
+    onCameraResolutionChanged(): Promise<void>;
     private _createPerfStatsReporter;
     private _closeConnection;
     private static _closeDataChannel;
@@ -72,7 +75,10 @@ export default class ServerTransport extends BaseTransport {
     private _detectStaleTracks;
     private _allocateConsumer;
     private _processOffer;
+    private _findFirstSimTransceiver;
+    private _setupSimulcastTransceiver;
     private _acceptProducer;
+    private _replaceScreenShareTrack;
     private _handleTracks;
     private _onSignalingNotification;
     private _onAsrTranscription;
@@ -81,5 +87,7 @@ export default class ServerTransport extends BaseTransport {
     static _onSignalingStateChange(pc: RTCPeerConnection, event: any): void;
     private _onConnectionStateChange;
     private _onReplacedTrack;
+    private _onSourcesChanged;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
+    private _changeSimulcastInfo;
 }

package/classes/transport/Statistics.d.ts

@@ -1,25 +1,38 @@
 import { ParticipantId } from '../../types/Participant';
 import { StatItem, StatRtp, StatTransport } from '../../types/Statistics';
 export declare const NO_STAT_REQUEST_DELAY = 1000;
-export declare function distinctById(items: RTCStats[]): RTCStats[];
-export declare function rtcStatsToArray(stats: RTCStatsReport[]): RTCStats[];
+declare function distinctById(items: RTCStats[]): RTCStats[];
+declare function rtcStatsToArray(stats: RTCStatsReport[]): RTCStats[];
 /**
  * Extracts transport statistics from the gives stats
  * @hidden
  */
-export declare function extractTransport(stats: RTCStats[]): StatTransport;
+declare function extractTransport(stats: RTCStats[]): StatTransport;
 /**
  * Extracts media statistics from the given stats
  * @hidden
  */
-export declare function extractRtps(stats: RTCStats[], ssrcMap: Record<string, string>, needToExtractRemote?: boolean): StatRtp[];
+declare function extractRtps(stats: RTCStats[], ssrcMap: Record<string, string>, needToExtractRemote?: boolean): StatRtp[];
 /**
  * Computes delta (the difference) between two stat reports.
  * @hidden
  */
-export declare function delta(current: StatItem, previous: StatItem, needToExtractRemote?: boolean): StatItem;
-export declare function collectStats(pc: RTCPeerConnection, previous: StatItem | null, ssrcMap?: Record<string, string>, needToExtractRemote?: boolean): Promise<StatItem>;
-export declare function setMark(name: string): void;
-export declare function clearMark(name: string): void;
-export declare function measureMark(name: string): null | number;
-export declare function getMarkNameScreenshareFirstFrame(uid: ParticipantId): string;
+declare function delta(current: StatItem, previous: StatItem, needToExtractRemote?: boolean): StatItem;
+declare function collectStats(pc: RTCPeerConnection, previous: StatItem | null, ssrcMap?: Record<string, string>, needToExtractRemote?: boolean): Promise<StatItem>;
+declare function setMark(name: string): void;
+declare function clearMark(name: string): void;
+declare function measureMark(name: string): null | number;
+declare function getMarkNameScreenshareFirstFrame(uid: ParticipantId): string;
+declare const _default: {
+    distinctById: typeof distinctById;
+    rtcStatsToArray: typeof rtcStatsToArray;
+    extractTransport: typeof extractTransport;
+    extractRtps: typeof extractRtps;
+    delta: typeof delta;
+    collectStats: typeof collectStats;
+    setMark: typeof setMark;
+    clearMark: typeof clearMark;
+    measureMark: typeof measureMark;
+    getMarkNameScreenshareFirstFrame: typeof getMarkNameScreenshareFirstFrame;
+};
+export default _default;

package/classes/transport/Transport.d.ts

@@ -66,6 +66,7 @@ export declare class Transport extends EventEmitter {
     getStates(): Record<string, TransportState>;
     setAnimojiSvg(participantId: ParticipantId, svgData: AnimojiSvgData): void;
     setAnimojiFill(fill: RGBTuple | string): void;
+    onCameraResolutionChanged(): Promise<void>;
     private _setStates;
     private _setLocalState;
     private _onSignalingNotification;

package/default/Api.d.ts

@@ -26,8 +26,9 @@ export default class Api extends BaseApi {
     }, speakerIds?: OkUserId[]): Promise<ConversationResponse>;
     startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie }?: {
         onlyAdminCanShareMovie?: boolean;
-    }): Promise<ConversationResponse>;
+    }, externalIds?: ExternalId[]): Promise<ConversationResponse>;
     protected _ensureUuid(): void;
+    deviceId(): string;
     private _preareStartConversationData;
     private _startConversation;
     createJoinLink(conversationId: string): Promise<{

package/default/Signaling.d.ts

@@ -1,7 +1,6 @@
 import BaseSignaling, { AddParticipantParams } from '../abstract/BaseSignaling';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
 import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
-import { NetworkStatReport } from '../types/NetworkStatReport';
 import { TransportTopology } from '../classes/transport/Transport';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
@@ -11,11 +10,13 @@ import SignalingConnectionType from '../enums/SignalingConnectionType';
 import UserRole from '../enums/UserRole';
 import { JSONObject } from '../static/Json';
 import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
+import { ChangeSimulcast } from '../types/ChangeSimulcast';
 import MediaModifiers from '../types/MediaModifiers';
 import MediaSettings from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 import MuteStates from '../types/MuteStates';
-import { CompositeUserId, ParticipantId } from '../types/Participant';
+import { NetworkStatReport } from '../types/NetworkStatReport';
+import { CompositeUserId, ParticipantId, ParticipantStateData } from '../types/Participant';
 import ParticipantLayout, { RequestKeyFrame, StopStream } from '../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import { StreamDescriptionString } from '../types/ParticipantStreamDescription';
@@ -30,8 +31,10 @@ export default class Signaling extends BaseSignaling {
     private datachannelCommandsQueue;
     private incomingCache;
     private responseHandlers;
+    private connectionType;
     private reconnectCount;
     private endpoint;
+    private wtEndpoint;
     protected conversationResolve: Function | null;
     protected conversationReject: Function | null;
     private connected;
@@ -47,15 +50,16 @@ export default class Signaling extends BaseSignaling {
     private producerCommandDataChannel;
     private producerCommandDataChannelEnabled;
     private producerCommandSerializationService;
-    private static readonly RECONNECT_DELAY;
-    private static readonly RECONNECT_MAX_DELAY;
-    private static readonly RECONNECT_MAX_COUNT;
-    private static readonly WAIT_CONNECTION_DELAY;
-    private static readonly WAIT_RESPONSE_DELAY;
-    private static readonly WAIT_MESSAGE_DELAY;
+    private static get RECONNECT_DELAY();
+    private static get RECONNECT_MAX_DELAY();
+    private static get RECONNECT_MAX_COUNT();
+    private static get WAIT_CONNECTION_DELAY();
+    private static get WAIT_RESPONSE_DELAY();
+    private static get WAIT_MESSAGE_DELAY();
     private static _getCapabilityFlags;
     get ready(): boolean;
     setEndpoint(endpoint: string): void;
+    setWebTransportEndpoint(endpoint: string | null): void;
     setConversationId(conversationId: string): void;
     setParticipantIdRegistry(participantIdRegistry: ParticipantIdRegistry): void;
     setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
@@ -85,9 +89,10 @@ export default class Signaling extends BaseSignaling {
     sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
     acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
     changeMediaSettings(mediaSettings: MediaSettings): Promise<SignalingMessage>;
-    changeParticipantState(state: Record<string, string>, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
+    changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
     putHandsDown(): Promise<SignalingMessage>;
-    addParticipant(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
+    addParticipant(externalIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
+    addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<SignalingMessage>;
     allocateConsumer(description: RTCSessionDescription | null, capabilities: {
         [key: string]: number | boolean | string;
@@ -132,6 +137,7 @@ export default class Signaling extends BaseSignaling {
     updateMediaModifiers(mediaModifiers: MediaModifiers): Promise<SignalingMessage>;
     enableVideoSuspend(enabled: boolean): Promise<SignalingMessage>;
     enableVideoSuspendSuggest(enabled: boolean): Promise<SignalingMessage>;
+    changeSimulcast(changeSimulcast: ChangeSimulcast): Promise<SignalingMessage>;
     changeOptions(changes: {
         [key in ConversationOption]?: boolean;
     }): Promise<SignalingMessage>;
@@ -158,7 +164,7 @@ export default class Signaling extends BaseSignaling {
     startAsr(params: IAsrStartParams): Promise<SignalingMessage>;
     stopAsr(params?: IAsrStopParams): Promise<SignalingMessage>;
     requestAsr(request: boolean): Promise<SignalingMessage>;
-    protected _connect(connectionType: SignalingConnectionType): void;
+    protected _connect(connectionType: SignalingConnectionType, useWebTransport: boolean): void;
     protected _disconnect(code?: number): void;
     private _onOpen;
     private _onMessage;
@@ -180,4 +186,8 @@ export default class Signaling extends BaseSignaling {
     protected _stopWaitConnectionMessage(): void;
     private _startDoctor;
     private _stopDoctor;
+    private isWebTransportAvailable;
+    private _getSocketType;
+    private _markTransportStat;
+    private _logTransportStat;
 }

package/enums/ChatRoomEventType.d.ts

@@ -2,7 +2,7 @@
  * Тип команды зала ожидания
  */
 declare enum ChatRoomEventType {
-    ATTENDEE = "ATTENDEE",
+    ATTENDEE = "ATTENDEE",// new Stereo attendee joined/left, new waiting hall participant joined/left
     HAND_UP = "HAND_UP"
 }
 export default ChatRoomEventType;

package/enums/ConversationOption.d.ts

@@ -3,10 +3,10 @@
  */
 declare enum ConversationOption {
     REQUIRE_AUTH_TO_JOIN = "REQUIRE_AUTH_TO_JOIN",
-    AUDIENCE_MODE = "AUDIENCE_MODE",
-    WAITING_HALL = "WAITING_HALL",
+    AUDIENCE_MODE = "AUDIENCE_MODE",// Stereo chat room
+    WAITING_HALL = "WAITING_HALL",// Waiting Hall is ON
     ASR = "ASR",
-    FEEDBACK = "FEEDBACK",
+    FEEDBACK = "FEEDBACK",// Reactions (default = off)
     RECURRING = "RECURRING"
 }
 export default ConversationOption;

package/enums/RecordRole.d.ts

@@ -4,7 +4,7 @@
  * у которых есть роль.
  */
 declare enum RecordRole {
-    KING = "KING",
+    KING = "KING",// участник показывается крупно в записи звонка
     PAWN = "PAWN"
 }
 export default RecordRole;

package/enums/SignalingCommandType.d.ts

@@ -55,6 +55,7 @@ declare enum SignalingCommandType {
     GET_HAND_QUEUE = "get-hand-queue",
     ENABLE_VIDEO_SUSPEND = "enable-video-suspend",
     ENABLE_VIDEO_SUSPEND_SUGGEST = "enable-video-suspend-suggest",
-    PUT_HANDS_DOWN = "put-hands-down"
+    PUT_HANDS_DOWN = "put-hands-down",
+    CHANGE_SIMULCAST = "change-simulcast"
 }
 export default SignalingCommandType;

package/enums/SignalingTransportStat.d.ts

@@ -0,0 +1,17 @@
+import Stat from './Stat';
+export declare const enum SignalingTransportType {
+    WEBSOCKET = "ws",
+    WEBTRANSPORT = "wt"
+}
+export declare const enum SignalingTransportStat {
+    CONNECTED = "connected",
+    RECONNECTED = "reconnected",
+    FAILED_PINGS = "failed_pings",
+    FAILED_EXCEPTIONS = "failed_exception",
+    TIMEOUT = "timeout",
+    RESTART = "restart"
+}
+export declare const SOCKET_STAT: Record<SignalingTransportStat, {
+    [SignalingTransportType.WEBSOCKET]: Stat;
+    [SignalingTransportType.WEBTRANSPORT]: Stat;
+}>;

package/enums/Stat.d.ts

@@ -1,40 +1,55 @@
 declare const enum Stat {
     ERROR = "callError",
-    DEVICES = "callDevices",
-    CALL_SPEC_ERROR = "callSpecError",
-    ICE_CONNECTION_STATE = "callIceConnectionState",
-    ICE_CONNECTION_TYPE = "callIceConnectionType",
-    ICE_RESTART = "callIceRestart",
-    PUSH = "callPush",
-    OUTGOING_CALL = "callStart",
-    OUTGOING_MULTIPARTY_CALL = "callStartMultiparty",
-    JOIN_CONVERSATION = "callJoinConversation",
-    ACCEPTED_OUTGOING = "callAcceptedOutgoing",
-    ACCEPT_INCOMING = "callAcceptIncoming",
+    DEVICES = "callDevices",// залогировать количество %d_%d
+    CALL_SPEC_ERROR = "callSpecError",// ошибки WebRTC
+    ICE_CONNECTION_STATE = "callIceConnectionState",// state
+    ICE_CONNECTION_TYPE = "callIceConnectionType",// type
+    ICE_RESTART = "callIceRestart",// без параметров
+    PUSH = "callPush",// busy / rejected / accepted
+    OUTGOING_CALL = "callStart",// video/audio
+    CALL_FINISH = "call_finish",// событие отправляемое в конце звонка
+    OUTGOING_MULTIPARTY_CALL = "callStartMultiparty",// video/audio
+    JOIN_CONVERSATION = "callJoinConversation",// video/audio
+    ACCEPTED_OUTGOING = "callAcceptedOutgoing",// video/audio
+    ACCEPT_INCOMING = "callAcceptIncoming",// video/audio
     DECLINE_INCOMING = "callDeclineIncoming",
-    ACCEPT_CONCURRENT = "callAcceptConcurrent",
+    ACCEPT_CONCURRENT = "callAcceptConcurrent",// video/audio
     HANGUP = "callHangup",
-    MEDIA_STATUS = "callMediaStatus",
-    DEVICE_CHANGED = "callDeviceChanged",
+    CODEC_USAGE = "codec_usage",// событие когда меняется кодек
+    MEDIA_STATUS = "callMediaStatus",// изменение video_1, audio_0
+    DEVICE_CHANGED = "callDeviceChanged",// смена камеры video/audio/screen
     SOCKET_ACTION = "callSocketAction",
     ADD_PARTICIPANT = "callAddParticipant",
     REMOVE_PARTICIPANT = "callRemoveParticipant",
-    POOR_CONNECTION = "callPoorConnection",
+    POOR_CONNECTION = "callPoorConnection",// video / audio
     TOPOLOGY_CHANGE_REQUESTED = "callTopologyChangeRequested",
-    RELAY_POLICY = "callForceRelay",
+    RELAY_POLICY = "callForceRelay",// 1 / 0
     PAT_ALLOCATED = "patAllocate",
     PAT_DEALLOCATED = "patDeallocate",
     PAT_ERROR = "patError",
     PAT_WAITING_TIME_ERROR = "patWaitingTimeError",
     PAT_OUTDATED_RESPONSE = "patOutdatedResponse",
-    SIGNALING_CONNECTED = "signaling_connected",
-    RECONNECT = "callReconnect",
-    SCREENSHARE_FIRST_FRAME = "screen_share_first_frame",
-    SCREENSHARE_FREEZE_DURATION = "callScreenshareFreezeDuration",
+    SIGNALING_CONNECTED = "signaling_connected",// measure
+    RECONNECT = "callReconnect",// measure
+    SCREENSHARE_FIRST_FRAME = "screen_share_first_frame",// measure
+    SCREENSHARE_FREEZE_DURATION = "callScreenshareFreezeDuration",// measure
     /** Объединение callFirstDataReceivedP2P и callFirstAudioMixDataReceived */
     FIRST_MEDIA_RECEIVED = "first_media_received",
     CALL_EVENTUAL_STAT = "callEventualStat",
     CALL_DECLINED_OR_HANGED_LOCALLY = "CallDeclinedOrHangedLocally",
-    USER_FEEDBACK_RECEIVED = "UserFeedbackReceived"
+    USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
+    CALL_START = "call_start",
+    WEBSOCKET_CONNECTED = "websocket_connected",
+    WEBSOCKET_RECONNECTED = "websocket_reconnected",
+    WEBSOCKET_FAILED_PINGS = "websocket_failed_pings",
+    WEBSOCKET_FAILED_EXCEPTION = "websocket_failed_exception",
+    WEBSOCKET_TIMEOUT = "websocket_timeout",
+    WEBSOCKET_RESTART = "websocket_restart",
+    WEBTRANSPORT_CONNECTED = "webtransport_connected",
+    WEBTRANSPORT_RECONNECTED = "webtransport_reconnected",
+    WEBTRANSPORT_FAILED_PINGS = "webtransport_failed_pings",
+    WEBTRANSPORT_FAILED_EXCEPTION = "webtransport_failed_exception",
+    WEBTRANSPORT_TIMEOUT = "webtransport_timeout",
+    WEBTRANSPORT_RESTART = "webtransport_restart"
 }
 export default Stat;