@vkontakte/calls-sdk 2.8.11-dev.d27d8de2.0 → 2.8.11-dev.d5496fb5.0

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,6 +37,9 @@ export default class Conversation extends EventEmitter {
     private _conversation;
     private _myLastRequestedLayouts;
     private _state;
+    private _previousState;
+    /** Если пользователь в зале ожидания, холд должен вызываться после промоута */
+    private _waitingHallHoldPending;
     private _participantState;
     private _participants;
     private _pendingParticipants;
@@ -52,10 +55,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;
@@ -73,6 +74,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;
@@ -139,11 +144,15 @@ 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;
@@ -180,6 +189,7 @@ export default class Conversation extends EventEmitter {
     private _cleanupParticipants;
     private _cleanupParticipantAgnosticStreams;
     private _cleanupTransport;
+    private _cleanupTransportForHold;
     private _cleanupSpeakerDetector;
     private _cleanupSpecListener;
     private _cleanupSignaling;
@@ -207,15 +217,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;
     /**
@@ -311,11 +324,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;
@@ -352,6 +371,7 @@ export default class Conversation extends EventEmitter {
     private _onPinParticipant;
     private _onOptionsChanged;
     private _onNetworkStatus;
+    private _emitHeldParticipantsStatus;
     private _onRemoteStreamSecond;
     /**
      * Коллбек, вызывающийся при получении/остановке стрима от AnimojiReceiver
@@ -372,6 +392,7 @@ export default class Conversation extends EventEmitter {
     private _onSpeakerChanged;
     private _onTransportStateChanged;
     private _onTransportLocalStateChanged;
+    private _areTransportParticipantsOnHold;
     private _onRemoteTrackAdded;
     private _onRemoteTrackRemoved;
     private _removeAudioTrack;
@@ -401,6 +422,7 @@ export default class Conversation extends EventEmitter {
     private _onFeedback;
     private _onDecorativeParticipantIdChanged;
     private _onVideoSuspendSuggest;
+    private _onParticipantHold;
     private _isMe;
     private _getMuteStatesForRoomId;
     private _getMuteStatesForCurrentRoom;
@@ -410,6 +432,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/transport/DirectTransport.d.ts

@@ -27,6 +27,7 @@ export default class DirectTransport extends BaseTransport {
     private _iceRestartTimeout;
     private _reconnectionTimeout;
     private _reconnectionPrevented;
+    private _remoteHold;
     private _lastStat;
     private _fingerprint;
     private _neverConnected;
@@ -50,6 +51,8 @@ export default class DirectTransport extends BaseTransport {
     updateSettings(settings: ServerSettings): void;
     preventRestart(): void;
     allowRestart(): void;
+    setRemoteHold(hold: boolean): void;
+    private _recreatePeerConnection;
     setAnimojiTransport(receiver: AnimojiReceiver, sender: AnimojiSender): void;
     close(error?: Error): void;
     private _setState;

package/classes/transport/Transport.d.ts

@@ -55,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[];

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;
@@ -19,7 +20,6 @@ export default class Api extends BaseApi {
     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, }?: {
@@ -45,9 +45,13 @@ 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;
@@ -59,5 +63,7 @@ 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/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.d27d8de2.0",
+  "version": "2.8.11-dev.d5496fb5.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",