@vkontakte/calls-sdk 2.8.11-dev.f204132b.0 → 2.8.11-dev.fdf6f999.0

package/classes/Conversation.d.ts

@@ -16,7 +16,7 @@ import { ConversationData, ConversationOnStartParams } from '../types/Conversati
 import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk, ExternalUserId } from '../types/ExternalId';
 import type { FastJoinHandler } from '../types/FastJoin';
 import MediaModifiers from '../types/MediaModifiers';
-import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
+import { IVideoDimentions } from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 import MuteStates from '../types/MuteStates';
 import { CompositeUserId, IGetParticipantsParameters, ParticipantId, ParticipantStateData } from '../types/Participant';
@@ -37,7 +37,6 @@ export default class Conversation extends EventEmitter {
     private _conversation;
     private _myLastRequestedLayouts;
     private _state;
-    private _previousState;
     private _participantState;
     private _participants;
     private _pendingParticipants;
@@ -53,8 +52,10 @@ export default class Conversation extends EventEmitter {
     private _isRealTimeAsrRequested;
     private _serverSettings;
     private _serverTimeOffset;
-    private _delayedHangup;
-    private _abortController;
+    private static _current;
+    private static _activationMutex;
+    private static _delayedHangup;
+    private static _abortController;
     private readonly _onUnload;
     private readonly _audioOutput;
     private readonly _stats;
@@ -63,6 +64,8 @@ export default class Conversation extends EventEmitter {
     private _audioFix;
     private _streamByStreamId;
     private _streamIdByStreamDescription;
+    private _participantIdByDebugStreamId;
+    private _mediaTypeByDebugStreamId;
     private _streamWaitTimerByStreamDescription;
     private _sequenceNumberByStreamDescription;
     private _cooldownTimestampByStreamDescription;
@@ -72,10 +75,6 @@ export default class Conversation extends EventEmitter {
     static current(): Conversation | null;
     static hangupAfterInit(): void;
     static id(): string | null;
-    get id(): string;
-    get externalId(): ExternalParticipantId | undefined;
-    get mediaSettings(): MediaSettings | undefined;
-    get isCallHeld(): boolean;
     static debugSessionId(): string | null;
     static getSyncedTime(): number;
     get debugSessionId(): string | null;
@@ -227,6 +226,8 @@ export default class Conversation extends EventEmitter {
     private _sendUpdateDisplayLayout;
     private _cleanupCooldownQueue;
     private _onParticipantSourcesUpdate;
+    private _clearVideoStreamDebugParticipant;
+    private _registerVideoStreamDebugParticipant;
     private _onParticipantPromoted;
     private _onChatRoomUpdated;
     private _onSharedMovieUpdate;
@@ -355,6 +356,7 @@ export default class Conversation extends EventEmitter {
     private _onOptionsChanged;
     private _onNetworkStatus;
     private _onRemoteStreamSecond;
+    private _onDataChannelScreenStreamDebug;
     /**
      * Коллбек, вызывающийся при получении/остановке стрима от AnimojiReceiver
      * @param participantId - участник, к которому относится стрим
@@ -382,6 +384,9 @@ export default class Conversation extends EventEmitter {
     private _onAudioMixStall;
     private _onRemoteSignalledStall;
     private _onRemoteDataStats;
+    private _onVideoStreamDebug;
+    private _resolveVideoStreamDebugMediaType;
+    private _resolveVideoStreamDebugParticipantId;
     private _fixAudioDevice;
     private _fixVideoDevice;
     private _toggleJoinAvailability;
@@ -403,7 +408,6 @@ export default class Conversation extends EventEmitter {
     private _onFeedback;
     private _onDecorativeParticipantIdChanged;
     private _onVideoSuspendSuggest;
-    private _onParticipantHold;
     private _isMe;
     private _getMuteStatesForRoomId;
     private _getMuteStatesForCurrentRoom;
@@ -413,8 +417,6 @@ export default class Conversation extends EventEmitter {
     private _getParticipants;
     private _getParticipant;
 }
-declare function _resetPendingInstance(): void;
-export { _resetPendingInstance };
 export declare class UpdateDisplayLayoutError extends Error {
     readonly participantErrors: {
         externalId: ExternalParticipantId;

package/classes/ConversationResponseValidator.d.ts

@@ -0,0 +1,3 @@
+import ConversationResponse from '../types/ConversationResponse';
+export type ConversationResponseSource = 'startConversation' | 'joinConversation' | 'joinConversationByLink' | 'fastStart' | 'fastJoin';
+export declare function assertValidConversationResponse(response: ConversationResponse | null | undefined, source: ConversationResponseSource): void;

package/classes/MediaSource.d.ts

@@ -47,7 +47,6 @@ export declare class MediaSource extends EventEmitter {
     /** Трек аудио эффектов. Не изменяется на протяжении всего времени */
     private _audioEffectsTrack;
     private _mediaSettings;
-    private _lastMediaSettings;
     private _videoStatusOnScreenCapturingEnabled;
     private _effect;
     private _audioEffectParams;
@@ -68,11 +67,7 @@ export declare class MediaSource extends EventEmitter {
     getSendAudioTrack(): MediaStreamTrack | null;
     get isAnimojiRequested(): boolean;
     addTrackToPeerConnection(pc: RTCPeerConnection, observer: boolean, noDataChannel: boolean): void;
-    /**
-     * @deprecated Используйте гетер mediaSettings
-     */
     getMediaSettings(): MediaSettings;
-    get mediaSettings(): MediaSettings;
     changeDevice(kind: MediaDeviceKind): Promise<void>;
     /**
      * Установка кастомного стрима для видео, например внешний шаринг экрана
@@ -100,8 +95,6 @@ export declare class MediaSource extends EventEmitter {
     private _setEffect;
     private _stopEffect;
     destroy(): void;
-    stopLocalMedia(): Promise<void>;
-    resumeLocalMedia(): Promise<void>;
     toggleScreenCapturing(settings: ScreenCaptureSettings): Promise<void>;
     disableScreenCapturing(): Promise<void>;
     private videoTrackMuteHandler;

package/classes/SpecListener.d.ts

@@ -16,8 +16,6 @@ export default class SpecListener extends EventEmitter {
     constructor(transport: Transport, volumesDetector: VolumesDetector, participants: Record<ParticipantId, Participant>, debug?: DebugLogger, logger?: StatsLogger | null);
     destroy(): void;
     onChangeRemoteMediaSettings(participantId: ParticipantId, mediaSettings: MediaSettings): void;
-    private _getConnectionTimeout;
-    private _getVolumeTimeout;
     private _onTransportStateChanged;
     private _onVolumesDetected;
     private _onConnectionTimeout;

package/classes/stat/StatFirstMediaReceived.d.ts

@@ -4,6 +4,7 @@ import { StatAggregator } from './StatAggregator';
 declare enum ECallType {
     DirectOutgoing = "direct_outgoing",
     DirectIncoming = "direct_incoming",
+    DirectJoin = "direct_join",
     ServerIncoming = "server_incoming",
     ServerJoinServer = "server_join_server",
     ServerChangeTopology = "server_change_topology"
@@ -17,8 +18,8 @@ export declare class StatFirstMediaReceived {
     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/transport/DirectTransport.d.ts

@@ -11,6 +11,11 @@ import BaseTransport from './BaseTransport';
 export default class DirectTransport extends BaseTransport {
     private readonly _participantId;
     private readonly _isMaster;
+    private _hasOutboundVideoDebug;
+    private _hasInboundVideoDebug;
+    private _outboundVideoDebugMediaType;
+    private _inboundVideoDebugMediaType;
+    private _videoDebugBytes;
     private _remoteSDP;
     private _remoteCandidates;
     private _lastRemoteSDP;
@@ -75,6 +80,11 @@ export default class DirectTransport extends BaseTransport {
     private static _patchRemoteDescription;
     private _onReplacedTrack;
     private _startStatInterval;
+    private _reportVideoStreamDebug;
+    private _isOutboundVideoDebugEnabled;
+    private _clearOutboundVideoDebug;
+    private _getVideoDebugMediaType;
+    private _getVideoDebugBitrate;
     /**
      * Check SVC support
      * @see https://webrtc.internaut.com/mc/

package/classes/transport/ServerTransport.d.ts

@@ -9,6 +9,9 @@ import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
 import { StatAggregator } from '../stat/StatAggregator';
 import BaseTransport from './BaseTransport';
 export default class ServerTransport extends BaseTransport {
+    private _outboundVideoDebugMediaTypes;
+    private _inboundVideoDebugParticipants;
+    private _videoDebugBytes;
     private _producerNotification;
     private _producerCommand;
     private _producerScreen;
@@ -40,6 +43,7 @@ export default class ServerTransport extends BaseTransport {
     private _participantIdRegistry;
     private _disabledSenders;
     private _rtpReceiversByStreamId;
+    private _participantIdByVideoTrackId;
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
@@ -82,6 +86,16 @@ export default class ServerTransport extends BaseTransport {
     private _stopSettingsInterval;
     private _collectStat;
     private _reportStats;
+    private _reportVideoStreamDebug;
+    private _isOutboundVideoDebugEnabled;
+    private _getOutboundVideoDebugMediaType;
+    private _getOutboundVideoDebugTrack;
+    private _getVideoDebugStreamId;
+    private _getVideoDebugTrackId;
+    private _createVideoDebugLayer;
+    private _getScreenShareDebugMethod;
+    private _sumVideoDebugBitrate;
+    private _getVideoDebugBitrate;
     private _detectStaleTracks;
     private _allocateConsumer;
     private _processOffer;

package/classes/transport/Transport.d.ts

@@ -3,7 +3,9 @@ import BaseSignaling from '../../abstract/BaseSignaling';
 import TransportState from '../../enums/TransportState';
 import TransportTopology from '../../enums/TransportTopology';
 import { type DebugLogger } from '../../static/Debug';
+import { VideoStreamDebugDirection, type VideoStreamDebugLayer } from '../../static/DebugVideoStats';
 import { ParticipantId } from '../../types/Participant';
+import type { MediaType } from '../../types/ParticipantStreamDescription';
 import ServerSettings from '../../types/ServerSettings';
 import EventEmitter from '../EventEmitter';
 import StatsLogger from '../StatsLogger';
@@ -27,8 +29,24 @@ export declare const enum TransportEvent {
     ASR_TRANSCRIPTION = "ASR_TRANSCRIPTION",
     ANIMOJI_STREAM = "ANIMOJI_STREAM",
     ANIMOJI_ERROR = "ANIMOJI_ERROR",
-    SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT"
+    SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT",
+    VIDEO_STREAM_DEBUG = "VIDEO_STREAM_DEBUG"
 }
+export type VideoStreamDebugEvent = {
+    direction: VideoStreamDebugDirection;
+    mediaType?: MediaType.CAMERA | MediaType.SCREEN;
+    streamId?: ParticipantId;
+    trackId?: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    bitrate?: number;
+    packetsLost?: number;
+    screenShareMethod?: string;
+    layers?: VideoStreamDebugLayer[];
+    clear?: boolean;
+};
 export declare class Transport extends EventEmitter {
     private readonly _signaling;
     private readonly _mediaSource;
@@ -82,6 +100,7 @@ export declare class Transport extends EventEmitter {
     private _onPeerConnectionClosed;
     private _onServerAudioMixStall;
     private _onRemoteDataStats;
+    private _onVideoStreamDebug;
     private _onRemoteTrackAdded;
     private _onRemoteTrackRemoved;
     private _onAsrTranscription;

package/default/Signaling.d.ts

@@ -9,7 +9,6 @@ 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';
@@ -26,29 +25,24 @@ 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 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;
@@ -57,16 +51,13 @@ export default class Signaling extends BaseSignaling {
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
-    private readonly _pings;
-    private readonly _signalingCommands;
-    private static get RECONNECT_DELAY();
-    private static get RECONNECT_MAX_DELAY();
-    private static get RECONNECT_MAX_COUNT();
+    private readonly _statPings;
+    private readonly _statSignalingCommands;
     private static get WAIT_CONNECTION_DELAY();
     private static get WAIT_RESPONSE_DELAY();
-    private static get WAIT_MESSAGE_DELAY();
-    constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, pings?: StatPings | null, signalingCommands?: StatSignalingCommands | null);
     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;
@@ -82,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>;
@@ -173,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/HangupType.d.ts

@@ -53,6 +53,7 @@ declare enum HangupType {
      * - Приложение вызываемого не запущено или упало
      * - Брандмауэр или сетевые ограничения блокируют подключение
      */
-    CALL_TIMEOUT = "CALL_TIMEOUT"
+    CALL_TIMEOUT = "CALL_TIMEOUT",
+    OBSOLETE_CLIENT = "OBSOLETE_CLIENT"
 }
 export default HangupType;

package/enums/SignalingNotification.d.ts

@@ -50,7 +50,6 @@ declare enum SignalingNotification {
     ASR_STARTED = "asr-started",
     ASR_STOPPED = "asr-stopped",
     DECORATIVE_PARTICIPANT_ID_CHANGED = "decorative-participant-id-changed",
-    VIDEO_SUSPEND_SUGGEST = "video-suspend-suggest",
-    HOLD = "hold"
+    VIDEO_SUSPEND_SUGGEST = "video-suspend-suggest"
 }
 export default SignalingNotification;

package/package.json

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

package/static/DebugVideoStats.d.ts

@@ -0,0 +1,37 @@
+import { ExternalParticipantId } from '../types/ExternalId';
+import type { MediaType } from '../types/ParticipantStreamDescription';
+export declare const enum VideoStreamDebugDirection {
+    INBOUND = "inbound",
+    OUTBOUND = "outbound"
+}
+export type VideoStreamDebugData = {
+    mediaType: MediaType.CAMERA | MediaType.SCREEN;
+    direction: VideoStreamDebugDirection;
+    externalParticipantId: ExternalParticipantId;
+    trackId?: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    bitrate?: number;
+    packetsLost?: number;
+    screenShareMethod?: string;
+    layers?: VideoStreamDebugLayer[];
+};
+export type VideoStreamDebugLayer = {
+    rid?: string;
+    ssrc?: number;
+    trackId?: string;
+    mimeType?: string;
+    width?: number;
+    height?: number;
+    frameRate?: number;
+    bitrate?: number;
+    packetsLost?: number;
+};
+declare namespace DebugVideoStats {
+    function format(data: VideoStreamDebugData): string;
+    function send(data: VideoStreamDebugData): void;
+    function clear(externalParticipantId: ExternalParticipantId, mediaType: MediaType.CAMERA | MediaType.SCREEN): void;
+}
+export default DebugVideoStats;