@vkontakte/calls-sdk 2.8.13-dev.c0b363e1.0 → 2.8.13-dev.c70019f1.0

package/classes/CallRegistry.d.ts

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

package/classes/MediaSource.d.ts

@@ -38,6 +38,8 @@ 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 { FastHangupHandler, HangupParams } from '../../types/FastHangup';
+import type { HangupParams } from '../../types/FastHangup';
 import MediaModifiers from '../../types/MediaModifiers';
 import MediaSettings, { IVideoDimentions } from '../../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../../types/MovieShare';
@@ -35,6 +35,9 @@ 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;
@@ -56,14 +59,17 @@ export default class Conversation extends EventEmitter {
     private _isRealTimeAsrRequested;
     private _serverSettings;
     private _serverTimeOffset;
-    private _delayedHangup;
+    private _serverConversationId;
     private _onFastHangup?;
     private _hangupEmitted;
     private _hangupPromise;
+    private _hangupReason;
     private _abortController;
     private _registeredPeerReceived;
     private _calleeUnavailableTimer;
-    private _reservedId;
+    private _pendingId;
+    private _resolveSignalingInitialization;
+    private readonly _signalingInitialization;
     private readonly _onUnload;
     private readonly _onRestore;
     private readonly _onVisibilityChange;
@@ -81,7 +87,6 @@ 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;
@@ -117,6 +122,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>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
@@ -125,11 +131,15 @@ 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;
@@ -153,8 +163,10 @@ 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;
@@ -357,7 +369,6 @@ export default class Conversation extends EventEmitter {
     private _onSignalingFailed;
     private _onAcceptedCall;
     private _onHungup;
-    private _updateParticipantExternalIdOnHungup;
     private _onSessionState;
     private _reconcileParticipantSessionStates;
     private _updateParticipantExternalId;
@@ -461,8 +472,6 @@ 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,6 +37,7 @@ 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/stat/SdpStats.d.ts

@@ -32,7 +32,6 @@ export declare class SdpStats {
     /** Не смогли применить SDP собеседника */
     logSetRemoteFailed(sdp: SdpDescription, error: unknown): void;
     destroy(): void;
-    private _intervalSince;
     private _logFailure;
     private _log;
 }

package/classes/transport/PerfStatReporter.d.ts

@@ -8,8 +8,10 @@ export default class PerfStatReporter extends EventEmitter {
     private _previousPerfStatReportTimestamp;
     private _previousNetworkStatReportTimestamp;
     private _previousCallStatReportTimestamp;
-    private _previousCallStatReport;
+    private _previousCounters;
     private _previousRemoteInboundRtps;
+    private _previousInboundRtps;
+    private _previousOutboundRtps;
     private _previousCandidatePair;
     private _screenShareStats;
     private _signaling;
@@ -25,6 +27,7 @@ export default class PerfStatReporter extends EventEmitter {
     private _reportCallStats;
     private _reportCandidatePair;
     private _calculatePacketLoss;
+    private _calculateOutboundDeltas;
     private _handleScreenSharingStat;
     private _handleTransportStateChanged;
 }

package/classes/transport/ServerTransport.d.ts

@@ -83,6 +83,8 @@ export default class ServerTransport extends BaseTransport {
     private _startSettingsInterval;
     private _stopSettingsInterval;
     private _collectStat;
+    /** mid потока быстрой шары, чтобы отделить его от камеры в статистике */
+    private _getScreenShareMid;
     private _reportStats;
     private _detectStaleTracks;
     private _allocateConsumer;

package/default/Api.d.ts

@@ -10,6 +10,7 @@ import PushData from '../types/PushData';
 export default class Api extends BaseApi {
     private _uuid;
     private _idCache;
+    constructor();
     private _callUnsafe;
     protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
     userId(participantId: ParticipantId): ExternalParticipantId | null;
@@ -22,6 +23,8 @@ export default class Api extends BaseApi {
     private _removeCachedAnonymLogin;
     private _reauthorize;
     private _applyAnonymLogin;
+    /** Кладёт в кеш id соответствие своего участника из auth.anonymLogin */
+    private _cacheSelfExternalId;
     private _buildClientStatsData;
     /** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
     private _reportClientStatsItemErrors;

package/package.json

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

package/static/AuthData.d.ts

@@ -1,9 +1,16 @@
-import type { OkUserId } from '../types/Participant';
+import type { ExternalParticipantId } from '../types/ExternalId';
+import type { OkUserId, ParticipantId } from '../types/Participant';
+/** Свой участник и его внешний id */
+export type SelfExternalId = {
+    participantId: ParticipantId;
+    externalId: ExternalParticipantId;
+};
 export default abstract class AuthData {
     private static _sessionKey;
     private static _sessionSecretKey;
     private static _accessToken;
     private static _userId;
+    private static _selfExternalId;
     private static _reauthorizePromise;
     static get sessionKey(): string | undefined;
     static set sessionKey(value: string | undefined);
@@ -13,6 +20,9 @@ export default abstract class AuthData {
     static set accessToken(value: string | undefined);
     static get userId(): OkUserId | null;
     static set userId(value: OkUserId | null);
+    /** Свой участник и его внешний id из ответа auth.anonymLogin */
+    static get selfExternalId(): SelfExternalId | null;
+    static set selfExternalId(value: SelfExternalId | null);
     static isEmpty(): boolean;
     /**
      * Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.

package/static/BrowserEnvironment.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Определение браузера, операционной системы и доступных возможностей.
+ */
+/**
+ * Известные браузеры
+ */
+export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
+declare namespace BrowserEnvironment {
+    /**
+     * Получение и кэширование версии операционной системы
+     */
+    function initOsVersion(warn: (...args: any[]) => void): Promise<void>;
+    /**
+     * Проверяет поддержку WebRTC браузером
+     */
+    function isBrowserSupported(): boolean;
+    /**
+     * Возвращает первую отсутствующую capability в стабильном порядке.
+     */
+    function getBrowserSupportFailure(): BrowserSupportFailure | null;
+    /**
+     * Проверяет поддержку шаринга экрана браузером
+     */
+    function isScreenCapturingSupported(): boolean;
+    /**
+     * Проверяет поддержку выбора микрофона браузером, независимо от списка устройств и разрешений.
+     * Доступен до init, не запрашивает разрешения и не захватывает медиа.
+     */
+    function canSelectAudioInput(): boolean;
+    /**
+     * Проверяет поддержку выбора аудиовыхода браузером, независимо от списка устройств и разрешений.
+     * Доступен до init, не запрашивает разрешения и не меняет аудиовыход.
+     */
+    function canSelectAudioOutput(): boolean;
+    /**
+     * В некоторых браузерах H264 decoder сломан
+     */
+    function isBrokenH264Decoder(): boolean;
+    /**
+     * В некоторых браузерах VP9 encoder сломан
+     */
+    function isBrokenVP9Encoder(): boolean;
+    /**
+     * В некоторых браузерах VP9 decoder сломан
+     */
+    function isBrokenVP9Decoder(): boolean;
+    /**
+     * Может ли браузер делать H264 приоритетным
+     */
+    function canPreferH264(): boolean;
+    /**
+     * Поддержка simulcast браузером.
+     * Safari корректно поддерживает simulcast начиная с версии 18.
+     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
+     */
+    function isSimulcastSupportedByBrowser(): boolean;
+    /**
+     * Имя операционной системы
+     */
+    function os(): string;
+    /**
+     * Версия операционной системы
+     */
+    function osVersion(): number | null | undefined;
+    /**
+     * Мобильный браузер или нет
+     */
+    function isMobile(): boolean;
+    /**
+     * Имя браузера
+     */
+    function browserName(): BrowserName | string;
+    /**
+     * Версия браузера
+     */
+    function browserVersion(): string;
+    /**
+     * Если браузер основан на хроме - возвращает версию
+     */
+    function baseChromeVersion(): number;
+    /**
+     * Возвращает подверсию браузера (если она есть)
+     */
+    function browserSubVersion(): string;
+    /**
+     * Браузер поддерживает захват звука при трансляции экрана
+     */
+    function isAudioShareSupported(): boolean;
+}
+export default BrowserEnvironment;

package/static/External.d.ts

@@ -635,6 +635,10 @@ 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

@@ -744,7 +744,8 @@ 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;
     /**
@@ -933,6 +934,13 @@ export type ParamsObject = {
      * @param bandwidth текущая полоса пропускания, kbps
      */
     onVideoSuspendSuggest?: (bandwidth: number, conversationId?: string) => void;
+    /**
+     * Первое подключение к сигналингу или переподключение успешно применено к состоянию звонка.
+     * Звонок зарегистрирован под conversationId, локальное управление доступно, в том числе в зале ожидания.
+     * Событие не означает принятие звонка собеседником или готовность WebRTC.
+     * Callback вызывается асинхронно; к моменту вызова звонок может уже завершиться.
+     */
+    onSignalingConnected?: (conversationId: string) => void;
     /**
      * Одобрено повышение пользователя в зале ожидания/зале в режиме Audience
      *

package/static/WebRTCUtils.d.ts

@@ -17,10 +17,6 @@ export declare enum FacingMode {
      */
     ENVIRONMENT = "environment"
 }
-/**
- * Известные браузеры
- */
-export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
 declare namespace WebRTCUtils {
     /**
      * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -118,76 +114,9 @@ declare namespace WebRTCUtils {
      * Возвращает фейковый видео mediaTrack
      */
     function getBlackMediaTrack(width?: number, height?: number): MediaStreamTrack;
-    /**
-     * Проверяет поддержку WebRTC браузером
-     */
-    function isBrowserSupported(): boolean;
-    /**
-     * Возвращает первую отсутствующую capability в стабильном порядке.
-     */
-    function getBrowserSupportFailure(): BrowserSupportFailure | null;
-    /**
-     * Проверяет поддержку шаринга экрана браузером
-     */
-    function isScreenCapturingSupported(): boolean;
-    /**
-     * В некоторых браузерах H264 decoder сломан
-     */
-    function isBrokenH264Decoder(): boolean;
-    /**
-     * В некоторых браузерах VP9 encoder сломан
-     * В симулкасте вп9 енкодер ведет себя некорректно
-     */
-    function isBrokenVP9Encoder(): boolean;
-    /**
-     * В некоторых браузерах VP9 decoder сломан
-     */
-    function isBrokenVP9Decoder(): boolean;
-    /**
-     * Может ли браузер делать H264 приоритетным
-     */
-    function canPreferH264(): boolean;
-    /**
-     * Поддержка simulcast браузером.
-     * Safari корректно поддерживает simulcast начиная с версии 18.
-     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
-     */
-    function isSimulcastSupportedByBrowser(): boolean;
-    /**
-     * Имя операционной системы
-     */
-    function os(): string;
-    /**
-     * Версия операционной системы
-     */
-    function osVersion(): number | null | undefined;
-    /**
-     * Мобильный браузер или нет
-     */
-    function isMobile(): boolean;
-    /**
-     * Имя браузера
-     */
-    function browserName(): BrowserName | string;
-    /**
-     * Версия браузера
-     */
-    function browserVersion(): string;
-    /**
-     * Если браузер основан на хроме - возвращает версию
-     */
-    function baseChromeVersion(): number;
     /**
      * Возвращает AudioContext
      */
     function getAudioContext(): AudioContext;
-    /**
-     * Возвращает подверсию браузера (если она есть)
-     */
-    function browserSubVersion(): string;
-    /**
-     * Браузер поддерживает захват звука при трансляции экрана
-     */
-    function isAudioShareSupported(): boolean;
 }
 export default WebRTCUtils;

package/types/ClientStatsEvent.d.ts

@@ -1,7 +1,8 @@
+import { StatPayload } from '../classes/stat/StatQueue';
 /**
  * Событие статистики SDK, которое получает `onClientStats`
  */
-export type ClientStatsEvent = Record<string, string | number | boolean | null> & {
+export type ClientStatsEvent = StatPayload & {
     /** Имя события из `Stat`. У периодической статистики звонка его нет */
     name?: string;
     /** ID звонка, `null` — пока он неизвестен */

package/types/FastHangup.d.ts

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

package/types/PerfStatReporter.d.ts

@@ -42,6 +42,23 @@ export interface ICallStatLog extends Pick<CallStatReport, 'call_topology' | 'na
     concealment_audio_avg_size?: number;
     video_loss?: number;
     audio_loss?: number;
+    /** Потери входящего видео за период, в процентах */
+    in_video_loss?: number;
+    /** Потери входящего аудио за период, в процентах */
+    in_audio_loss?: number;
+    /** Байты, отправленные по исходящим аудио потокам за период, включая шару звука */
+    audio_bytes_sent?: number;
+    /** Уровень исходящего звука в шкале 16-битного PCM, от 0 до 32767 */
+    audio_level?: number;
+    /** Битрейт исходящего видео без ретрансмитов, кибибит/с */
+    br_encode?: number;
+    /** Битрейт отправки видео камеры, кибибит/с */
+    br_transmit?: number;
+    /** Битрейт ретрансмитов видео камеры, кибибит/с */
+    br_retransmit?: number;
+    /** Кадры камеры, закодированные энкодером за период */
+    frames_encoded?: number;
     cpu_hardware_concurrency?: number;
+    audio_tracks?: number;
     [k: string]: string | number | boolean | undefined;
 }

package/types/Statistics.d.ts

@@ -36,6 +36,10 @@ interface StatRtpOutboundVideo {
     framesSent?: number;
     framesPerSecond?: number;
     targetBitrate?: number;
+    /**
+     * Общее количество кадров, закодированных энкодером
+     */
+    framesEncoded?: number;
 }
 export interface StatRtp extends StatRtpOutboundVideo {
     /**
@@ -65,6 +69,10 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Общее количество байтов, отправленных по этому потоку
      */
     bytesSent: number;
+    /**
+     * Общее количество байтов, отправленных повторно (ретрансмиты) по этому потоку
+     */
+    retransmittedBytesSent?: number;
     /**
      * Общее количество байтов заголовков, полученных по этому потоку
      */
@@ -73,6 +81,11 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Общее количество байтов заголовков, отправленных по этому потоку
      */
     headerBytesSent: number;
+    /**
+     * Уровень звука исходящего аудио потока в момент снятия статистики, от 0 до 1.
+     * Берется из media-source, у входящих потоков его нет.
+     */
+    audioLevel?: number;
     /**
      * Среднее значение джиттера в секундах
      * Джиттер — это вариация задержки в получении пакетов данных.
@@ -113,6 +126,10 @@ export interface StatRtp extends StatRtpOutboundVideo {
      * Идентификатор пользователя, связанный с этим потоком
      */
     userId?: string;
+    /**
+     * Поток демонстрации экрана (быстрая шара), а не камеры
+     */
+    isScreenShare?: boolean;
     /**
      * Пропускная способность в битах в секунду
      */