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

package/classes/CallRegistry.d.ts

@@ -0,0 +1,26 @@
+import Conversation from './Conversation';
+import MediaSettings from '../types/MediaSettings';
+export interface HoldableConversation extends Conversation {
+    id: string;
+    hold(hold: boolean, lastActiveMediaSettings?: MediaSettings): Promise<void>;
+}
+export declare class CallRegistry {
+    private _conversations;
+    private _activeId;
+    private _mutex;
+    add(conversation: HoldableConversation): void;
+    remove(id: string | null): void;
+    get(id: string): HoldableConversation | undefined;
+    getActive(): HoldableConversation | null;
+    getFirst(): HoldableConversation | null;
+    getActiveId(): string | null;
+    has(id: string): boolean;
+    getAll(): HoldableConversation[];
+    get callsLength(): number;
+    setActive(id: string): Promise<void>;
+    setHold(id: string): Promise<void>;
+    switchCall(id: string): Promise<void>;
+    clear(): void;
+}
+declare const callRegistry: CallRegistry;
+export { callRegistry };

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 { IVideoDimentions } from '../types/MediaSettings';
+import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
 import MuteStates from '../types/MuteStates';
 import { CompositeUserId, IGetParticipantsParameters, ParticipantId, ParticipantStateData } from '../types/Participant';
@@ -37,9 +37,13 @@ export default class Conversation extends EventEmitter {
     private _conversation;
     private _myLastRequestedLayouts;
     private _state;
+    private _previousState;
+    /** Если пользователь в зале ожидания, холд должен вызываться после промоута */
+    private _waitingHallHoldPending;
     private _participantState;
     private _participants;
     private _pendingParticipants;
+    private _directTransportIsMaster?;
     private _transport;
     private _debugInfo;
     private readonly _debug;
@@ -52,10 +56,8 @@ export default class Conversation extends EventEmitter {
     private _isRealTimeAsrRequested;
     private _serverSettings;
     private _serverTimeOffset;
-    private static _current;
-    private static _activationMutex;
-    private static _delayedHangup;
-    private static _abortController;
+    private _delayedHangup;
+    private _abortController;
     private readonly _onUnload;
     private readonly _audioOutput;
     private readonly _stats;
@@ -64,8 +66,6 @@ export default class Conversation extends EventEmitter {
     private _audioFix;
     private _streamByStreamId;
     private _streamIdByStreamDescription;
-    private _participantIdByDebugStreamId;
-    private _mediaTypeByDebugStreamId;
     private _streamWaitTimerByStreamDescription;
     private _sequenceNumberByStreamDescription;
     private _cooldownTimestampByStreamDescription;
@@ -75,6 +75,10 @@ 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;
@@ -110,11 +114,12 @@ export default class Conversation extends EventEmitter {
     setVolume(volume: number): void;
     updateStatisticsInterval(): void;
     private _openTransport;
+    private _allocateParticipantTransport;
     private _close;
     destroy(): Promise<void>;
     private _getConversationParams;
     private _setConversationParams;
-    private _addGeoParamsToEndpoint;
+    private _buildSignalingEndpoint;
     /**
      * @throws ErrorEvent
      */
@@ -129,6 +134,7 @@ export default class Conversation extends EventEmitter {
     private _prepareConversation;
     private _createParticipant;
     private _getParticipantId;
+    private _cacheParticipantExternalIds;
     private _setConversation;
     private _updateConversation;
     private _createMediaSource;
@@ -141,10 +147,16 @@ export default class Conversation extends EventEmitter {
     private _registerParticipants;
     /** Установим состояние локальных мьютов */
     private _registerParticipantLocalMuteState;
-    private _getStatusByTransportState;
+    private _remoteParticipantSessionState;
+    private _buildConnectionStatus;
+    private _isParticipantSessionStateApplicable;
+    private _setTransportStatus;
+    private _setSessionState;
+    private _emitParticipantTransition;
     private _registerParticipantInCache;
     private _getExistedParticipantByIdOrCreate;
     private _getExternalIdByParticipantId;
+    private _getExternalIdsByOkIdsFromCache;
     private _registerParticipantAndSetMarkersIfChunkEnabled;
     private _warnParticipantNotInConversation;
     private _denormalizeMarkers;
@@ -181,6 +193,7 @@ export default class Conversation extends EventEmitter {
     private _cleanupParticipants;
     private _cleanupParticipantAgnosticStreams;
     private _cleanupTransport;
+    private _cleanupTransportForHold;
     private _cleanupSpeakerDetector;
     private _cleanupSpecListener;
     private _cleanupSignaling;
@@ -208,15 +221,18 @@ export default class Conversation extends EventEmitter {
      */
     changePriorities(priorities: ParticipantPriority[]): Promise<void>;
     changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<void>;
-    hold(hold: boolean): Promise<void>;
+    hold(hold: boolean, lastActiveMediaSettings?: MediaSettings): Promise<void>;
+    private _holdLocally;
+    private _resumeLocalMedia;
+    private _restoreStateAfterHold;
+    private _isWaitingForPromotion;
+    private _getWaitingForPromotionStatus;
     putHandsDown(): Promise<void>;
     requestKeyFrame(participantStreamDescription: ParticipantStreamDescription): Promise<void | SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string): Promise<void>;
     updateDisplayLayout(layouts: ParticipantLayout[]): Promise<void>;
     requestDisplayLayout(requests: DisplayLayoutRequest[]): Promise<void>;
     feedback(key: string): Promise<SignalingMessage>;
-    userFeedbackStats(userResponse: number, reason?: string, groupCallUsersCount?: number): void;
-    sendClientEvent(eventType: string, eventData?: Record<string, string | number | boolean>, immediately?: boolean): void;
     private _changeMediaSettings;
     private _stopStreaming;
     /**
@@ -226,8 +242,6 @@ export default class Conversation extends EventEmitter {
     private _sendUpdateDisplayLayout;
     private _cleanupCooldownQueue;
     private _onParticipantSourcesUpdate;
-    private _clearVideoStreamDebugParticipant;
-    private _registerVideoStreamDebugParticipant;
     private _onParticipantPromoted;
     private _onChatRoomUpdated;
     private _onSharedMovieUpdate;
@@ -314,11 +328,17 @@ export default class Conversation extends EventEmitter {
     private _changeMultipleParticipantState;
     private _invokeRolesChangedCallbackIfNeeded;
     private _onSignalingNotification;
+    private _onSignalingTopologyChanged;
     private _onPromotionApproved;
     private _onSignalingReconnect;
     private _onSignalingFailed;
     private _onAcceptedCall;
     private _onHungup;
+    private _onSessionState;
+    private _reconcileParticipantSessionStates;
+    private _updateParticipantExternalId;
+    private _updateParticipantSessionState;
+    private _emitParticipantEffectiveStatusIfSessionOverridesTransport;
     private _onAddedParticipant;
     private _onJoinedParticipant;
     private _onClosedConversation;
@@ -355,8 +375,8 @@ export default class Conversation extends EventEmitter {
     private _onPinParticipant;
     private _onOptionsChanged;
     private _onNetworkStatus;
+    private _emitHeldParticipantsStatus;
     private _onRemoteStreamSecond;
-    private _onDataChannelScreenStreamDebug;
     /**
      * Коллбек, вызывающийся при получении/остановке стрима от AnimojiReceiver
      * @param participantId - участник, к которому относится стрим
@@ -376,6 +396,7 @@ export default class Conversation extends EventEmitter {
     private _onSpeakerChanged;
     private _onTransportStateChanged;
     private _onTransportLocalStateChanged;
+    private _areTransportParticipantsOnHold;
     private _onRemoteTrackAdded;
     private _onRemoteTrackRemoved;
     private _removeAudioTrack;
@@ -384,9 +405,6 @@ export default class Conversation extends EventEmitter {
     private _onAudioMixStall;
     private _onRemoteSignalledStall;
     private _onRemoteDataStats;
-    private _onVideoStreamDebug;
-    private _resolveVideoStreamDebugMediaType;
-    private _resolveVideoStreamDebugParticipantId;
     private _fixAudioDevice;
     private _fixVideoDevice;
     private _toggleJoinAvailability;
@@ -408,6 +426,7 @@ export default class Conversation extends EventEmitter {
     private _onFeedback;
     private _onDecorativeParticipantIdChanged;
     private _onVideoSuspendSuggest;
+    private _onParticipantHold;
     private _isMe;
     private _getMuteStatesForRoomId;
     private _getMuteStatesForCurrentRoom;
@@ -417,6 +436,8 @@ 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/MediaSource.d.ts

@@ -47,6 +47,7 @@ export declare class MediaSource extends EventEmitter {
     /** Трек аудио эффектов. Не изменяется на протяжении всего времени */
     private _audioEffectsTrack;
     private _mediaSettings;
+    private _lastMediaSettings;
     private _videoStatusOnScreenCapturingEnabled;
     private _effect;
     private _audioEffectParams;
@@ -67,7 +68,11 @@ 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>;
     /**
      * Установка кастомного стрима для видео, например внешний шаринг экрана
@@ -95,6 +100,8 @@ export declare class MediaSource extends EventEmitter {
     private _setEffect;
     private _stopEffect;
     destroy(): void;
+    stopLocalMedia(): Promise<void>;
+    resumeLocalMedia(lastActiveMediaSettings?: MediaSettings): Promise<void>;
     toggleScreenCapturing(settings: ScreenCaptureSettings): Promise<void>;
     disableScreenCapturing(): Promise<void>;
     private videoTrackMuteHandler;

package/classes/SpecListener.d.ts

@@ -12,12 +12,17 @@ export default class SpecListener extends EventEmitter {
     private readonly _debug;
     private readonly _logger;
     private _connectionTimeout;
+    private _connectionTimeoutSuppressed;
     private _volumeTimeout;
     constructor(transport: Transport, volumesDetector: VolumesDetector, participants: Record<ParticipantId, Participant>, debug?: DebugLogger, logger?: StatsLogger | null);
     destroy(): void;
     onChangeRemoteMediaSettings(participantId: ParticipantId, mediaSettings: MediaSettings): void;
+    onParticipantHoldChanged(): void;
+    private _getConnectionTimeout;
+    private _getVolumeTimeout;
     private _onTransportStateChanged;
     private _onVolumesDetected;
     private _onConnectionTimeout;
+    private _reportConnectionTimeout;
     private _onVolumeTimeout;
 }

package/classes/StatsLogger.d.ts

@@ -10,20 +10,17 @@ export default class StatsLogger extends BaseLogger {
     private readonly _conversationIdProvider;
     private readonly _batchInterval;
     private _batchedClientStats;
-    private _batchedClientEvents;
     private _batchTimeout;
     private _serverTimeDelta;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null);
     log(name: StatLog, value?: string, immediately?: boolean): void;
     logClientStats(data: Record<string, string | number | boolean | undefined | null>, immediately?: boolean): void;
-    logClientEvent(data: Record<string, string | number | boolean | undefined | null>, immediately?: boolean): void;
     destroy(): void;
     private _getConversationId;
     private _sendBatch;
     private _startTimeout;
     private _stopTimeout;
     private _sendClientStats;
-    private _sendClientEvents;
     private _calculateServerTimeDelta;
     private _now;
 }

package/classes/codec/WorkerBase.d.ts

@@ -12,5 +12,7 @@ export default abstract class WorkerBase {
     protected _sendToWorker(type: string, data?: {
         [key: string]: any;
     }, transfer?: any[]): void;
+    private _formatWorkerError;
+    private _formatWorkerMessageError;
     static isBrowserSupported(): boolean;
 }

package/classes/transport/DirectTransport.d.ts

@@ -11,11 +11,6 @@ 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;
@@ -32,6 +27,7 @@ export default class DirectTransport extends BaseTransport {
     private _iceRestartTimeout;
     private _reconnectionTimeout;
     private _reconnectionPrevented;
+    private _remoteHold;
     private _lastStat;
     private _fingerprint;
     private _neverConnected;
@@ -55,6 +51,10 @@ export default class DirectTransport extends BaseTransport {
     updateSettings(settings: ServerSettings): void;
     preventRestart(): void;
     allowRestart(): void;
+    setRemoteHold(hold: boolean): void;
+    private _recreatePeerConnection;
+    private _createPeerConnection;
+    private _disposePeerConnection;
     setAnimojiTransport(receiver: AnimojiReceiver, sender: AnimojiSender): void;
     close(error?: Error): void;
     private _setState;
@@ -80,11 +80,6 @@ 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,9 +9,6 @@ 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;
@@ -43,7 +40,6 @@ export default class ServerTransport extends BaseTransport {
     private _participantIdRegistry;
     private _disabledSenders;
     private _rtpReceiversByStreamId;
-    private _participantIdByVideoTrackId;
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
@@ -86,16 +82,6 @@ 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,9 +3,7 @@ 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';
@@ -29,24 +27,8 @@ export declare const enum TransportEvent {
     ASR_TRANSCRIPTION = "ASR_TRANSCRIPTION",
     ANIMOJI_STREAM = "ANIMOJI_STREAM",
     ANIMOJI_ERROR = "ANIMOJI_ERROR",
-    SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT",
-    VIDEO_STREAM_DEBUG = "VIDEO_STREAM_DEBUG"
+    SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT"
 }
-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;
@@ -73,6 +55,8 @@ export declare class Transport extends EventEmitter {
     open(participantIds: ParticipantId[], peerId?: string | null, observer?: boolean, force?: boolean): void;
     close(participantId: ParticipantId): void;
     destroy(): void;
+    holdClose(): void;
+    setRemoteHold(hold: boolean): void;
     getTopology(): TransportTopology;
     isAllocated(participantId: ParticipantId): boolean;
     allocated(): string[];
@@ -100,7 +84,6 @@ export declare class Transport extends EventEmitter {
     private _onPeerConnectionClosed;
     private _onServerAudioMixStall;
     private _onRemoteDataStats;
-    private _onVideoStreamDebug;
     private _onRemoteTrackAdded;
     private _onRemoteTrackRemoved;
     private _onAsrTranscription;

package/default/Api.d.ts

@@ -1,10 +1,11 @@
-import BaseApi, { ClientEvent, ClientStats } from '../abstract/BaseApi';
+import BaseApi, { ClientStats } from '../abstract/BaseApi';
 import CallType from '../enums/CallType';
 import HangupType from '../enums/HangupType';
 import ConversationParams from '../types/ConversationParams';
 import ConversationResponse from '../types/ConversationResponse';
 import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
 import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
+import PushData from '../types/PushData';
 export default class Api extends BaseApi {
     private _userId;
     private _uuid;
@@ -13,8 +14,12 @@ export default class Api extends BaseApi {
     protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
     userId(participantId: ParticipantId): Promise<ExternalParticipantId>;
     authorize(): Promise<void>;
+    private _getAnonymLoginCacheKey;
+    private _getCachedAnonymLogin;
+    private _setCachedAnonymLogin;
+    private _removeCachedAnonymLogin;
+    private _applyAnonymLogin;
     logClientStats(items: ClientStats[]): void;
-    logClientEvents(items: ClientEvent[]): void;
     uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
     joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
     createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {
@@ -40,13 +45,9 @@ export default class Api extends BaseApi {
     }>;
     getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
     joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
-    /**
-     * NB: Не сохраняет порядок возвращаемых ID
-     * @hidden
-     */
-    getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;
     getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
     getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
+    getCachedExternalIdByOkId(okId: OkUserId): ExternalParticipantId | null;
     cacheExternalId(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
     mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
     unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
@@ -58,6 +59,6 @@ export default class Api extends BaseApi {
     hangupConversation(conversationId: string, reason?: HangupType): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     cleanup(): void;
-    private _getExternalIdsByOkIds;
     getServerTime(): Promise<number>;
+    getInbounds(): Promise<PushData[]>;
 }

package/default/Signaling.d.ts

@@ -174,6 +174,8 @@ export default class Signaling extends BaseSignaling {
     private _serializeErrorEvent;
     private _onClose;
     private _closeSocket;
+    private _isRecordCommand;
+    private _resolvePendingRecordCommands;
     private _handleCommandResponse;
     private _handleCommandsQueue;
     private _startResponseTimer;

package/enums/SignalingNotification.d.ts

@@ -24,6 +24,7 @@ declare enum SignalingNotification {
     REALLOC_CON = "realloc-con",
     AUDIO_ACTIVITY = "audio-activity",
     SPEAKER_CHANGED = "speaker-changed",
+    SESSION_STATE = "session-state",
     STALLED_ACTIVITY = "stalled-activity",
     CHAT_MESSAGE = "chat-message",
     CUSTOM_DATA = "custom-data",
@@ -50,6 +51,7 @@ 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"
+    VIDEO_SUSPEND_SUGGEST = "video-suspend-suggest",
+    HOLD = "hold"
 }
 export default SignalingNotification;

package/package.json

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

package/static/Capabilities.d.ts

@@ -0,0 +1,5 @@
+import { TCapabilities } from '../types/Capabilities';
+declare namespace Capabilities {
+    function get(): TCapabilities;
+}
+export default Capabilities;