@vkontakte/calls-sdk 2.8.11-dev.3de63af6.0 → 2.8.11-dev.41bc9113.0

package/classes/CallRegistry.d.ts

@@ -0,0 +1,25 @@
+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;
+    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,11 +16,11 @@ 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';
-import { ParticipantLayout } from '../types/ParticipantLayout';
+import { DisplayLayoutRequest, ParticipantLayout } from '../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import ParticipantPriority from '../types/ParticipantPriority';
 import { ParticipantStreamDescription } from '../types/ParticipantStreamDescription';
@@ -32,10 +32,12 @@ export default class Conversation extends EventEmitter {
     private readonly _api;
     private readonly _signaling;
     private readonly _signalingActor;
+    private readonly _displayLayoutRequester;
     private _mediaSource;
     private _conversation;
     private _myLastRequestedLayouts;
     private _state;
+    private _previousState;
     private _participantState;
     private _participants;
     private _pendingParticipants;
@@ -51,10 +53,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;
@@ -72,6 +72,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;
@@ -205,11 +209,12 @@ 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>;
     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;
@@ -285,7 +290,6 @@ export default class Conversation extends EventEmitter {
     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, remove?: boolean): Promise<undefined>;
     publishStream(roomId?: number | null): Promise<undefined>;
-    recordSetConf(king?: ParticipantId, pawns?: ParticipantId[], hideParticipantCount?: boolean, roomId?: number | null): Promise<void>;
     getStreamInfo(): Promise<{
         movieId: any;
         preview: any;
@@ -350,6 +354,7 @@ export default class Conversation extends EventEmitter {
     private _onPinParticipant;
     private _onOptionsChanged;
     private _onNetworkStatus;
+    private _emitHeldParticipantsStatus;
     private _onRemoteStreamSecond;
     /**
      * Коллбек, вызывающийся при получении/остановке стрима от AnimojiReceiver
@@ -370,6 +375,7 @@ export default class Conversation extends EventEmitter {
     private _onSpeakerChanged;
     private _onTransportStateChanged;
     private _onTransportLocalStateChanged;
+    private _areTransportParticipantsOnHold;
     private _onRemoteTrackAdded;
     private _onRemoteTrackRemoved;
     private _removeAudioTrack;
@@ -399,6 +405,7 @@ export default class Conversation extends EventEmitter {
     private _onFeedback;
     private _onDecorativeParticipantIdChanged;
     private _onVideoSuspendSuggest;
+    private _onParticipantHold;
     private _isMe;
     private _getMuteStatesForRoomId;
     private _getMuteStatesForCurrentRoom;
@@ -408,6 +415,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/DisplayLayoutRequester.d.ts

@@ -0,0 +1,39 @@
+import BaseApi from '../abstract/BaseApi';
+import type { DebugLogger } from '../static/Debug';
+import { DisplayLayoutRequest, ParticipantLayout } from '../types/ParticipantLayout';
+import { Participant, ParticipantId } from '../types/Participant';
+type DisplayLayoutRequesterParams = {
+    api: BaseApi;
+    debug: DebugLogger;
+    getParticipants: () => Promise<Record<ParticipantId, Participant>>;
+    isMe: (participantId: ParticipantId) => boolean;
+    updateDisplayLayout: (layouts: ParticipantLayout[]) => Promise<void>;
+};
+export default class DisplayLayoutRequester {
+    private readonly _api;
+    private readonly _debug;
+    private readonly _getParticipants;
+    private readonly _isMe;
+    private readonly _updateDisplayLayout;
+    private _requestedLayouts;
+    private _uncertainLayouts;
+    private _pendingRequests;
+    private _pendingPromises;
+    private _lastRequests;
+    private _timer;
+    private _inFlight;
+    private _lastFlushAt;
+    private _generation;
+    private _forceNextFlush;
+    constructor({ api, debug, getParticipants, isMe, updateDisplayLayout }: DisplayLayoutRequesterParams);
+    request(requests: DisplayLayoutRequest[]): Promise<void>;
+    resend(): void;
+    cleanupParticipant(participantId: ParticipantId): void;
+    clear(): void;
+    private _schedule;
+    private _flush;
+    private _getRequestLayouts;
+    private _getDiff;
+    private _isChanged;
+}
+export {};

package/classes/ExternalIdCache.d.ts

@@ -0,0 +1,19 @@
+import { ExternalId, ExternalParticipantId } from '../types/ExternalId';
+import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
+export declare class ExternalIdCache {
+    private _okIdToExternalId;
+    private _externalIdToOkId;
+    private _decorativeIdToInitialId;
+    private _initialIdToDecorativeId;
+    getOkId(externalId: ExternalId): OkUserId | null;
+    getExternalId(okId: OkUserId): ExternalParticipantId | null;
+    hasByExternalId(externalId: ExternalId): boolean;
+    hasByOkId(okId: OkUserId): boolean;
+    cache(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
+    mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
+    unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
+    getDecorativeIdByInitialId(initialId: OkUserId | CompositeUserId | ParticipantId): OkUserId | undefined;
+    replaceByInitialIdIdIfExists(id: OkUserId | CompositeUserId | ParticipantId): OkUserId;
+    getParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    clear(): void;
+}

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/default/Api.d.ts

@@ -8,9 +8,7 @@ import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
 export default class Api extends BaseApi {
     private _userId;
     private _uuid;
-    private _externalUidsCache;
-    private _decorativeIdToInitialId;
-    private _initialIdToDecorativeId;
+    private _idCache;
     private _callUnsafe;
     protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
     userId(participantId: ParticipantId): Promise<ExternalParticipantId>;
@@ -25,7 +23,7 @@ export default class Api extends BaseApi {
         audioOnly?: boolean;
         waitForAdmin?: boolean;
         closedConversation?: boolean;
-    }, speakerIds?: OkUserId[]): Promise<ConversationResponse>;
+    }, externalIds?: ExternalId[]): Promise<ConversationResponse>;
     startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, waitForAdmin }?: {
         onlyAdminCanShareMovie?: boolean;
         waitForAdmin?: boolean;
@@ -42,19 +40,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
-     * Этот метод принимает именно ExternalId, т.к. для OkUserId не принципиально наличие deviceIdx
-     * @hidden
-     */
-    getOkIdsByExternalIds(externalIds: ExternalId[]): Promise<OkUserId[]>;
-    getParticipantIdsByExternalIds(externalIds: ExternalId[]): Promise<Map<ExternalId, ParticipantId>>;
     /**
      * NB: Не сохраняет порядок возвращаемых ID
      * @hidden
      */
     getExternalIdsByOkIds(uids: OkUserId[]): Promise<ExternalParticipantId[]>;
     getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | 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;

package/default/Signaling.d.ts

@@ -27,7 +27,7 @@ import { ParticipantListChunkParameters } from '../types/ParticipantListChunk';
 import { StreamDescriptionString } from '../types/ParticipantStreamDescription';
 import { PerfStatReport } from '../types/PerfStatReporter';
 import SignalingMessage, { GetParticipantsSignalingResponse, GetRoomsSignalingResponse, SignalingSuccessResponse } from '../types/SignalingMessage';
-import { IPublishStreamData, IRecordConfData, IStartStreamData, IStopStreamData } from '../types/Streams';
+import { IPublishStreamData, IStartStreamData, IStopStreamData } from '../types/Streams';
 export default class Signaling extends BaseSignaling {
     private socket;
     protected sequence: number;
@@ -130,7 +130,6 @@ export default class Signaling extends BaseSignaling {
     startStream(data: IStartStreamData): Promise<SignalingMessage>;
     stopStream(data?: IStopStreamData): Promise<SignalingMessage>;
     publishStream(data?: IPublishStreamData): Promise<SignalingMessage>;
-    recordSetConf(conf?: IRecordConfData): Promise<SignalingMessage>;
     getRecordStatus(): Promise<SignalingMessage>;
     switchTopology(topology: TransportTopology, force?: boolean): Promise<SignalingMessage>;
     requestRealloc(): Promise<SignalingMessage>;

package/enums/SignalingNotification.d.ts

@@ -50,6 +50,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.3de63af6.0",
+  "version": "2.8.11-dev.41bc9113.0",
   "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;