@vkontakte/calls-sdk 2.8.6-dev.1d6b5a10.0 → 2.8.6-dev.1df341c4.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, ParticipantStateData } 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
@@ -225,7 +230,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>;
@@ -262,7 +267,7 @@ export default class Conversation extends EventEmitter {
     switchRoom(toRoomId: number | null, participantId?: ParticipantId): Promise<void>;
     removeRooms(roomIds: number[]): Promise<void>;
     startStream(isRecord?: boolean, name?: string | null, movieId?: string | null, privacy?: 'PUBLIC' | 'FRIENDS' | 'DIRECT_LINK', groupId?: string | null, roomId?: number | null): Promise<undefined>;
-    stopStream(roomId?: number | null): Promise<undefined>;
+    stopStream(roomId?: number | null, remove?: boolean): Promise<undefined>;
     publishStream(roomId?: number | null): Promise<undefined>;
     recordSetConf(king?: ParticipantId, pawns?: ParticipantId[], hideParticipantCount?: boolean, roomId?: number | null): Promise<void>;
     getStreamInfo(): Promise<{
@@ -309,6 +314,7 @@ export default class Conversation extends EventEmitter {
     private _onChatMessage;
     private _onCustomData;
     private _onRecordInfo;
+    private _onStopRecordInfo;
     private _changePinnedParticipantForRoom;
     _changeRecordInfoForRoom(): Promise<void>;
     private _changeAsrInfoForRoom;
@@ -341,6 +347,7 @@ export default class Conversation extends EventEmitter {
     private _onAnimojiError;
     private _onPeerConnectionClosed;
     private _changeFeatureSet;
+    private _changeFeaturesPerRole;
     private _changeNeedRate;
     private _onVolumesDetected;
     private _onSpeakerChanged;
@@ -380,6 +387,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/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/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/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,16 +10,17 @@ 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 { 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';
 import { PerfStatReport } from '../types/PerfStatReporter';
-import { ChangeSimulcast } from '../types/ChangeSimulcast';
 import SignalingMessage, { GetParticipantsSignalingResponse, GetRoomsSignalingResponse, SignalingSuccessResponse } from '../types/SignalingMessage';
 import { IPublishStreamData, IRecordConfData, IStartStreamData, IStopStreamData } from '../types/Streams';
 export default class Signaling extends BaseSignaling {
@@ -31,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;
@@ -48,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;
@@ -88,7 +91,8 @@ export default class Signaling extends BaseSignaling {
     changeMediaSettings(mediaSettings: MediaSettings): 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;
@@ -160,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;
@@ -182,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/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;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.6-dev.1d6b5a10.0",
+  "version": "2.8.6-dev.1df341c4.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -19,8 +19,12 @@
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",
     "bit-buffer": "0.2.5",
+    "fflate": "^0.8.2",
     "messagepack": "1.1.12",
     "simple-ebml-builder": "0.2.2",
     "webrtc-adapter": "7.7.0"
-  }
+  },
+  "workspaces": [
+    "workspaces/sandbox"
+  ]
 }

package/static/ApiTransport.d.ts

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

package/static/External.d.ts

@@ -226,7 +226,7 @@ declare namespace External {
      * @param markers
      */
     function onParticipantJoined(userId: ExternalId, markers: ExternalParticipantListMarkers | null): void;
-    function onLocalParticipantState(participantState: ParticipantStateMapped): void;
+    function onLocalParticipantState(participantState: ParticipantStateMapped, global?: boolean): void;
     /**
      * Изменились данные состояний собеседника
      *
@@ -420,7 +420,7 @@ declare namespace External {
      * Закончена запись звонка
      * @param roomId ID зала в котором остановлена запись
      */
-    function onRecordStopped(roomId?: number | null): void;
+    function onRecordStopped(roomId: number | null | undefined, stopBy: ExternalParticipantId | null): void;
     /**
      * Состояние своей сети
      *

package/static/Params.d.ts

@@ -82,6 +82,8 @@ export type ParamsObject = {
     /** @hidden */
     wssBase: string;
     /** @hidden */
+    wtsBase: string;
+    /** @hidden */
     wssToken: string;
     /** @hidden */
     signalingReconnectDelay: number;
@@ -461,6 +463,38 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableLogPerfStatReport: boolean;
+    /**
+     * Поддержка переключения качества видео в зависимости от сети
+     * Только для режима p2p
+     *
+     * _По умолчанию: `false`_
+     */
+    switchVideoAtBadNetwork: boolean;
+    /**
+     * Включает деградацию фпс для видео с камеры при низком фпс с включенными вирт фонами
+     *
+     * _По умолчанию: `false`_
+     */
+    enableVideoEffectsFpsDegradation: boolean;
+    /**
+     * Включить поддержку simulcast на отправке
+     *
+     * _По умолчанию: `false`_
+     */
+    simulcast: boolean;
+    /**
+     * Включить поддержку webtransport для сигналинга
+     *
+     * _По умолчанию: `false`_
+     */
+    webtransport: boolean;
+    /**
+     * Включить поддержку webtransport для сигналинга в FireFox
+     * Отдельная ручка, так как есть проблемы сейчас с FF
+     *
+     * _По умолчанию: `false`_
+     */
+    webtransportFF: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -565,8 +599,11 @@ export type ParamsObject = {
     /**
      * Получены данные по изменению локальных состояний со стороны админа
      * Например, принудительно опущена рука
+     *
+     *  @param participantState  Полный объект состояния участника, полученный от SDK/сервера.
+     *  @param global `true` – действие глобальное (для всех участников), `false` – действие локальное (только у текущего пользователя).
      */
-    onLocalParticipantState?: (participantState: ParticipantStateMapped) => void;
+    onLocalParticipantState?: (participantState: ParticipantStateMapped, global: boolean) => void;
     /**
      * Изменились данные состояний собеседника
      */
@@ -681,7 +718,7 @@ export type ParamsObject = {
     /**
      * Закончена трансляция/запись звонка
      */
-    onRecordStopped?: (roomId: number | null) => void;
+    onRecordStopped?: (roomId: number | null, stopBy: ExternalParticipantId | null) => void;
     /**
      * Состояние своей сети
      *
@@ -834,21 +871,6 @@ export type ParamsObject = {
      * Собеседник подключился к сигналлингу
      */
     onPeerRegistered?: () => void;
-    /**
-     * Поддержка переключения качества видео в зависимости от сети
-     * Только для режима p2p
-     *
-     * _По умолчанию: `false`_
-     */
-    switchVideoAtBadNetwork: boolean;
-    /** включает деградацию фпс для видео с камеры при низком фпс с включенными вирт фонами */
-    enableVideoEffectsFpsDegradation: boolean;
-    /**
-     * Включить поддержку simulcast на отправке
-     *
-     * _По умолчанию: `false`_
-     */
-    simulcast: boolean;
 };
 export default abstract class Params {
     private static _params;
@@ -885,6 +907,8 @@ export default abstract class Params {
     static set iceServers(value: IceServer[]);
     static get wssBase(): string;
     static set wssBase(value: string);
+    static get wtsBase(): string;
+    static set wtsBase(value: string);
     static get wssToken(): string;
     static set wssToken(value: string);
     static get signalingReconnectDelay(): number;
@@ -978,6 +1002,10 @@ export default abstract class Params {
     static get enableVideoEffectsFpsDegradation(): boolean;
     static get simulcast(): boolean;
     static set simulcast(value: boolean);
+    static get webtransport(): boolean;
+    static set webtransport(value: boolean);
+    static get webtransportFF(): boolean;
+    static set webtransportFF(value: boolean);
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1006,5 +1034,8 @@ export default abstract class Params {
         clientStatsPlatform: string;
         consumerScreenDataChannelPacketSize: number;
         switchVideoAtBadNetwork: boolean;
+        simulcast: boolean;
+        webtransport: boolean;
+        webtransportFF: boolean;
     };
 }

package/static/SimulcastInfo.d.ts

@@ -10,4 +10,4 @@ export declare const MAP_RID_TO_SCALE_RESOLUTION_DOWN_BY: Record<string, number>
 export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
 export declare function findBitrateAsc(maxDimension: number, bitrates: VideoBitrateSettings[]): number;
 export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[]): ISimulcastInfo;
-export declare function findScaleResolutionDownBy(rid: string): number;
+export declare function findScaleResolutionDownBy(rid?: string): number;