@vkontakte/calls-sdk 2.8.13-dev.957e6761.0 → 2.8.13-dev.a071796a.0

package/classes/AudioOutput.d.ts

@@ -15,8 +15,9 @@ export default class AudioOutput {
     private readonly _features;
     private readonly _statFirstMediaReceived;
     private readonly _logger;
+    private _autoplayRecoveryController;
     constructor(statFirstMediaReceived: StatFirstMediaReceived, allowMultipleTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null);
-    add(participantId: ParticipantId, track: MediaStreamTrack): void;
+    add(participantId: ParticipantId, track: MediaStreamTrack, replaceAll?: boolean): void;
     remove(participantId: ParticipantId, track: MediaStreamTrack): void;
     get volume(): number;
     set volume(volume: number);
@@ -26,6 +27,7 @@ export default class AudioOutput {
     protected _getTracks(): MediaStreamTrack[];
     protected _initAudioElement(): void;
     protected _stopAudioElement(): void;
+    private _stopAutoplayRecovery;
     private _createAudioElement;
     private _prepareAudioElement;
     private _addTrackToAudioElement;

package/classes/CallRegistry.d.ts

@@ -6,31 +6,18 @@ export interface HoldableConversation extends Conversation {
 }
 export declare class CallRegistry {
     private _conversations;
-    private _pending;
-    private _initialIds;
-    private _hangups;
+    private _reserved;
     private _activeId;
-    private _selected;
     private _mutex;
     private _pendingRemovals;
-    addPending(conversation: HoldableConversation): void;
-    selectPending(conversation: HoldableConversation): HoldableConversation | null;
-    isSelected(conversation: HoldableConversation): boolean;
-    releaseSelection(conversation: HoldableConversation, previous?: HoldableConversation | null): void;
-    selectIfNone(conversation: HoldableConversation): void;
+    reserve(id: string): void;
     add(conversation: HoldableConversation): void;
-    remove(conversation: HoldableConversation): void;
+    remove(id: string | null): void;
     get(id: string): HoldableConversation | undefined;
-    getPending(id?: string): HoldableConversation | null;
-    isPending(conversation: HoldableConversation): boolean;
-    getLocal(id?: string): HoldableConversation | null;
-    trackHangup(conversation: HoldableConversation, promise: Promise<void>): void;
-    getHangup(id?: string): Promise<void> | undefined;
-    removeHangup(promise: Promise<void>): void;
     getActive(): HoldableConversation | null;
     getFirst(): HoldableConversation | null;
     getActiveId(): string | null;
-    has(id: string, except?: HoldableConversation): boolean;
+    has(id: string): boolean;
     getAll(): HoldableConversation[];
     get callsLength(): number;
     setActive(id: string): Promise<void>;

package/classes/MediaSource.d.ts

@@ -39,8 +39,6 @@ export declare class MediaSource extends EventEmitter {
     private _screenTrack;
     private _audioShareTrack;
     private _screenShareTrack;
-    private _screenCaptureRequest;
-    private _destroyed;
     /** Трек для отправки в медиа-канал. Может отличаться при скриншаринге в дата-канал */
     private _sendVideoTrack;
     /** Трек с камеры. В стриме будет другой трек при включенных видео эффектах */

package/classes/conversation/Conversation.d.ts

@@ -15,7 +15,7 @@ import { IAsrStartParams, IAsrStopParams } from '../../types/Asr';
 import { AudienceModeHandsResponse } from '../../types/AudienceMode';
 import { ConversationData, ConversationOnJoinParams, ConversationOnStartParams } from '../../types/Conversation';
 import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk } from '../../types/ExternalId';
-import type { HangupParams } from '../../types/FastHangup';
+import type { FastHangupHandler, HangupParams } from '../../types/FastHangup';
 import MediaModifiers from '../../types/MediaModifiers';
 import MediaSettings, { IVideoDimentions } from '../../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../../types/MovieShare';
@@ -35,9 +35,6 @@ export default class Conversation extends EventEmitter {
     private readonly _signalingActor;
     private readonly _displayLayoutRequester;
     private _mediaSource;
-    private _requestingLocalMedia;
-    private _requestedLocalAudio?;
-    private _requestedLocalVideo?;
     private _conversation;
     private _myLastRequestedLayouts;
     private _state;
@@ -59,17 +56,14 @@ export default class Conversation extends EventEmitter {
     private _isRealTimeAsrRequested;
     private _serverSettings;
     private _serverTimeOffset;
-    private _serverConversationId;
+    private _delayedHangup;
     private _onFastHangup?;
     private _hangupEmitted;
     private _hangupPromise;
-    private _hangupReason;
     private _abortController;
     private _registeredPeerReceived;
     private _calleeUnavailableTimer;
-    private _pendingId;
-    private _resolveSignalingInitialization;
-    private readonly _signalingInitialization;
+    private _reservedId;
     private readonly _onUnload;
     private readonly _onRestore;
     private readonly _onVisibilityChange;
@@ -87,6 +81,7 @@ export default class Conversation extends EventEmitter {
     private readonly _statFirstMediaReceived;
     constructor(api: BaseApi, externalLogger: BaseLogger | null);
     static current(): Conversation | null;
+    static hangupAfterInit(onFastHangup?: FastHangupHandler): void;
     static id(): string | null;
     get id(): string;
     get externalId(): ExternalParticipantId | undefined;
@@ -122,8 +117,7 @@ export default class Conversation extends EventEmitter {
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
     decline(params?: HangupParams): Promise<void>;
     hangup(params?: HangupParams): Promise<void>;
-    private _waitForHangup;
-    addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
+    addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<ExternalParticipant[] | undefined>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
     setVolume(volume: number): void;
@@ -131,15 +125,11 @@ export default class Conversation extends EventEmitter {
     private _openTransport;
     private _allocateParticipantTransport;
     private _closeParticipantTransport;
-    private _registerPending;
     private _cleanupRegistry;
-    private _applyInitialActiveSelection;
     private _emitHangupOnce;
     private _sendHangupApi;
     private _close;
     private _sendHangup;
-    private _throwIfClosed;
-    private _applyServerConversation;
     destroy(): void;
     private _destroy;
     private _getConversationParams;
@@ -163,14 +153,13 @@ export default class Conversation extends EventEmitter {
     private _cacheParticipantExternalIds;
     private _setConversation;
     private _updateConversation;
-    private _requestLocalMedia;
     private _createMediaSource;
     private _connectSignaling;
-    private _completeSignalingInitialization;
     private _processConnection;
     private _onConversationParticipantListChunk;
     private _createParticipantListChunk;
     private _participantListChunkToExternalChunk;
+    private _participantsToExternal;
     private _registerConnectionParticipants;
     private _registerParticipants;
     /** Установим состояние локальных мьютов */
@@ -477,6 +466,8 @@ export default class Conversation extends EventEmitter {
     private _registerParticipant;
     private _getParticipant;
 }
+declare function _resetPendingInstance(): void;
+export { _resetPendingInstance };
 export declare class UpdateDisplayLayoutError extends Error {
     readonly participantErrors: {
         externalId: ExternalParticipantId;

package/classes/conversation/Conversation.testUtils.d.ts

@@ -37,7 +37,6 @@ declare function createParams(): {
     onSpeakerChanged: Mock<import("@vitest/spy").Procedure>;
     onAcceptedCall: Mock<import("@vitest/spy").Procedure>;
     onNonFatalError: Mock<import("@vitest/spy").Procedure>;
-    onSignalingConnected: Mock<import("@vitest/spy").Procedure>;
 };
 export type ConversationTestParams = ReturnType<typeof createParams>;
 export type ConversationTestTools = {

package/classes/transport/Transport.d.ts

@@ -37,6 +37,8 @@ export declare class Transport extends EventEmitter {
     private _opened;
     private _directTransport;
     private _serverTransport;
+    private _pendingServerAudio;
+    private _serverAudioController;
     private _serverSettings;
     private _dtListeners;
     private _stListeners;
@@ -91,6 +93,9 @@ export declare class Transport extends EventEmitter {
     private _onServerAudioMixStall;
     private _onRemoteDataStats;
     private _onRemoteTrackAdded;
+    private _onServerTrackAdded;
+    private _trySwitchToServerAudio;
+    private _clearPendingServerAudio;
     private _onRemoteTrackRemoved;
     private _onAsrTranscription;
     private _onSourceChanged;

package/package.json

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

package/static/External.d.ts

@@ -635,10 +635,6 @@ declare namespace External {
      */
     function onParticipantIdChanged(prevId: ExternalParticipantId, newId: ExternalParticipantId, conversationId?: string): void;
     function onVideoSuspendSuggest(bandwidth: number, conversationId?: string): void;
-    /**
-     * Успешно применено первое подключение к сигналингу или переподключение.
-     */
-    function onSignalingConnected(conversationId: string): void;
     /**
      * Одобрено повышение пользователя в зеле ожидания/зале в режиме Audience
      *

package/static/Params.d.ts

@@ -562,9 +562,7 @@ export type ParamsObject = {
      */
     forwardEmptyIceCandidate: boolean;
     /**
-     * Получен локальный стрим с камеры/микрофона, в том числе до подключения сигналинга.
-     * Повторяется после изменения видео (включение, выключение, смена камеры).
-     * Повторное событие может содержать тот же MediaStream с обновлёнными треками.
+     * Получен локальный стрим с камеры/микрофона
      */
     onLocalStream?: (stream: MediaStream | null, mediaSettings: MediaSettings, conversationId?: string) => void;
     /**
@@ -746,8 +744,7 @@ export type ParamsObject = {
     onLocalVolume?: (volume: number, isMicEnabled: boolean) => void;
     onJoinStatus?: (available: boolean, chatId: string, conversationId?: string) => void;
     /**
-     * Звонок завершён локально. При hangup callback планируется сразу, ровно один раз, без ожидания сети.
-     * Доставляется асинхронно; Promise hangup отдельно ждёт известную SDK работу по завершению.
+     * Звонок был завершен
      */
     onHangup?: (type: HangupReason | Error, conversationId: string | null) => void;
     /**
@@ -936,13 +933,6 @@ export type ParamsObject = {
      * @param bandwidth текущая полоса пропускания, kbps
      */
     onVideoSuspendSuggest?: (bandwidth: number, conversationId?: string) => void;
-    /**
-     * Первое подключение к сигналингу или переподключение успешно применено к состоянию звонка.
-     * Звонок зарегистрирован под conversationId, локальное управление доступно, в том числе в зале ожидания.
-     * Событие не означает принятие звонка собеседником или готовность WebRTC.
-     * Callback вызывается асинхронно; к моменту вызова звонок может уже завершиться.
-     */
-    onSignalingConnected?: (conversationId: string) => void;
     /**
      * Одобрено повышение пользователя в зале ожидания/зале в режиме Audience
      *

package/types/FastHangup.d.ts

@@ -34,15 +34,13 @@ export interface FastHangupResponse {
  *
  * `reason` и `conversationId` идут в signaling hangup.
  * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
- * (явный hangup/decline, включая отмену инициализации).
- * При `hangup` без обработчика SDK отправляет Calls API beacon, если серверный ID уже известен.
- * При `declineCall` без обработчика остаётся только signaling hangup.
- * На закрытии вкладки (`pagehide`) SDK всегда использует beacon вместо обработчика.
+ * (явный hangup/decline или delayed hangup во время init).
+ * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
+ * где SDK всегда шлёт beacon, и delayed hangup без handler.
  */
 export interface HangupParams {
     /**
-     * Текущий или исходный ID для локального hangup; declineCall требует текущий ID готового звонка.
-     * Без ID: активный готовый, затем первый готовый, а для hangup — также единственный готовящийся звонок.
+     * ID звонка. Если опущен — завершается текущий активный звонок.
      */
     conversationId?: string;
     /**
@@ -63,6 +61,6 @@ export interface HangupParams {
  * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
  *
  * @param params Параметры запроса
- * @param signal При `hangup` — отдельный AbortSignal завершения, при `declineCall` — сигнал текущего звонка, если он есть
+ * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
  */
 export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;