@vkontakte/calls-sdk 2.8.6-dev.e8081e23.0 → 2.8.6-dev.e9164ba1.0

package/classes/Conversation.d.ts

@@ -30,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;
@@ -77,7 +79,7 @@ export default class Conversation extends EventEmitter {
     private _onJoinPart2;
     private _extractExternalRooms;
     private _extractExternalRoomsData;
-    onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string): Promise<void>;
+    onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string, wsEndpoint?: string): Promise<void>;
     private _isInWaitingHall;
     private _isRestricted;
     private _isAudienceMode;
@@ -96,7 +98,7 @@ export default class Conversation extends EventEmitter {
     updateStatisticsInterval(): void;
     private _openTransport;
     private _close;
-    destroy(): void;
+    destroy(): Promise<void>;
     private _getConversationParams;
     private _setConversationParams;
     private _addGeoParamsToEndpoint;
@@ -228,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>;
@@ -383,6 +385,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

@@ -52,6 +52,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;

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/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/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,6 +31,7 @@ export default class Signaling extends BaseSignaling {
     private datachannelCommandsQueue;
     private incomingCache;
     private responseHandlers;
+    private connectionType;
     private reconnectCount;
     private endpoint;
     private wtEndpoint;
@@ -49,12 +50,12 @@ 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;
@@ -186,4 +187,7 @@ export default class Signaling extends BaseSignaling {
     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,44 +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",
-    CALL_FINISH = "call_finish",
-    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",
-    CODEC_USAGE = "codec_usage",
-    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",
     CALL_START = "call_start",
-    WEBTRANSPORT_CONNECTED = "webtransport_connected"
+    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.e8081e23.0",
+  "version": "2.8.6-dev.e9164ba1.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

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

package/static/Utils.d.ts

@@ -71,7 +71,7 @@ declare namespace Utils {
     function participantMarkerCompare(marker1: ExternalParticipantListMarker | undefined, marker2: ExternalParticipantListMarker | undefined): number;
     /** убирает все ключи со значением `V` на 1 уровне */
     function objectFilterOutValues<T extends Record<string, V>, V = unknown>(obj: T, value?: unknown | unknown[]): Partial<T>;
-    function objectReduce<R, T extends Object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
+    function objectReduce<R, T extends object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
     const setImmediate: (fn: VoidFunction) => VoidFunction;
     function isObject(obj: unknown): obj is object;
     function patchSimulcastAnswerSdp(sdp: string, trans: RTCRtpTransceiver, width: number, height: number): string;

package/types/ConversationParams.d.ts

@@ -23,5 +23,6 @@ export type ExternalConversationParams = {
     trnp: string;
     trnu: string;
     wse: string;
+    wte: string;
 };
 export default ConversationParams;

package/types/WebTransport.d.ts

@@ -1,14 +1,4 @@
-interface WebTransportHash {
-    algorithm?: string;
-    value?: BufferSource;
-}
-interface WebTransportOptions {
-    allowPooling?: boolean;
-    congestionControl?: CongestionControlType;
-    requireUnreliable?: boolean;
-    serverCertificateHashes?: WebTransportHash[];
-}
-type CongestionControlType = 'default' | 'low-latency' | 'throughput';
+import { WebTransportOptions } from '@fails-components/webtransport';
 declare class WebTransportEventual {
     private webTransport;
     private stream;

package/utils/Lz4.d.ts

@@ -1 +1 @@
-export declare function lz4Decompress(input: Uint8Array, outputLength: number): Uint8Array;
+export declare function lz4Decompress(input: Uint8Array, outputLength: number): Uint8Array<ArrayBuffer>;

package/utils/MsgPackerBufferUtils.d.ts

@@ -13,7 +13,7 @@ export declare function createWriteBuffer(): {
     putUi32(v: number): void;
     putUi64(v: number): void;
     putF(v: number): void;
-    ui8array(): Uint8Array;
+    ui8array(): Uint8Array<ArrayBuffer>;
 };
 export declare function createReadBuffer(buf: BufferSource): {
     peek(): number;

package/utils/VariableLengthInteger.d.ts

@@ -12,7 +12,7 @@ declare class VariableLengthIntegerDecoder {
      * @param data The Uint8Array to decode.
      * @returns The decoded integer.
      */
-    decode(data: Uint8Array): bigint;
+    decode(data: Uint8Array): bigint | null;
     getNumBytesForLengthInteger(data: Uint8Array): number;
 }
 export { VariableLengthIntegerEncoder, VariableLengthIntegerDecoder };

package/worker/LibVPxDecoderWorker.d.ts

@@ -1,4 +1,3 @@
-/// <reference lib="webworker" />
 import type libvpx from '@vkontakte/libvpx';
 declare const _default: (vpx: typeof libvpx, urlResolver: (url: string) => string) => void;
 export default _default;

package/worker/LibVPxEncoderWorker.d.ts

@@ -1,4 +1,3 @@
-/// <reference lib="webworker" />
 import type libvpx from '@vkontakte/libvpx';
 declare const _default: (vpx: typeof libvpx, urlResolver: (url: string) => string, useCongestionControl: boolean, maxBitrate: number) => void;
 export default _default;

package/worker/WebCodecsDecoderWorker.d.ts

@@ -1,3 +1,2 @@
-/// <reference lib="webworker" />
 declare const _default: (videoFrameTransferable: boolean) => void;
 export default _default;

package/worker/WebCodecsEncoderWorker.d.ts

@@ -1,3 +1,2 @@
-/// <reference lib="webworker" />
 declare const _default: () => void;
 export default _default;