@vkontakte/calls-sdk 2.8.13-dev.b0dfcfc5.0 → 2.8.13-dev.b18b02e0.0

package/CallsSDK.d.ts

@@ -28,6 +28,7 @@ import RoomsEventType from './enums/RoomsEventType';
 import SignalingCommandType from './enums/SignalingCommandType';
 import SignalingConnectionType from './enums/SignalingConnectionType';
 import SignalingNotification from './enums/SignalingNotification';
+import Stat from './enums/Stat';
 import UserRole from './enums/UserRole';
 import UserType from './enums/UserType';
 import { DebugMessageType } from './static/Debug';
@@ -36,7 +37,8 @@ import { ParticipantStatus } from './static/External';
 import { JSONArray, JSONObject, JSONType } from './static/Json';
 import { ParamsObject } from './static/Params';
 import Utils from './static/Utils';
-import WebRTCUtils, { BrowserName, FacingMode } from './static/WebRTCUtils';
+import BrowserEnvironment, { BrowserName } from './static/BrowserEnvironment';
+import WebRTCUtils, { FacingMode } from './static/WebRTCUtils';
 import { IAsrData, IAsrStartParams, IAsrStopParams } from './types/Asr';
 import { ConversationData } from './types/Conversation';
 import { IFeaturesPerRole } from './types/ConversationFeature';
@@ -59,6 +61,7 @@ import { IRoomId, Room, RoomParticipantUpdate, Rooms, RoomsUpdate } from './type
 import { ScreenCaptureSettings } from './types/ScreenCaptureSettings';
 import SignalingMessage, { GetRoomsSignalingResponse, GetParticipantsSignalingResponse } from './types/SignalingMessage';
 import { StatResult } from './types/Statistics';
+import { ClientStatsEvent } from './types/ClientStatsEvent';
 import { IStartStreamData, IStopStreamData, IPublishStreamData } from './types/Streams';
 import { WaitingHallResponse } from './types/WaitingHall';
 import { ArrayDequeue } from './utils/ArrayDequeue';
@@ -144,43 +147,57 @@ export declare const browser: {
      *
      * _Метод доступен до инициализации_
      */
-    isBrowserSupported: typeof WebRTCUtils.isBrowserSupported;
+    isBrowserSupported: typeof BrowserEnvironment.isBrowserSupported;
     /**
      * Проверяет поддержку трансляции экрана браузером
      *
      * _Метод доступен до инициализации_
      */
-    isScreenCapturingSupported: typeof WebRTCUtils.isScreenCapturingSupported;
+    isScreenCapturingSupported: typeof BrowserEnvironment.isScreenCapturingSupported;
+    /**
+     * Проверяет поддержку выбора микрофона браузером, независимо от списка устройств и разрешений.
+     * Не запрашивает разрешения и не захватывает медиа.
+     *
+     * _Метод доступен до инициализации_
+     */
+    canSelectAudioInput: typeof BrowserEnvironment.canSelectAudioInput;
+    /**
+     * Проверяет поддержку выбора аудиовыхода браузером, независимо от списка устройств и разрешений.
+     * Не запрашивает разрешения и не меняет аудиовыход.
+     *
+     * _Метод доступен до инициализации_
+     */
+    canSelectAudioOutput: typeof BrowserEnvironment.canSelectAudioOutput;
     /**
      * Имя операционной системы
      *
      * _Метод доступен до инициализации_
      */
-    os: typeof WebRTCUtils.os;
+    os: typeof BrowserEnvironment.os;
     /**
      * Мобильный браузер или нет
      *
      * _Метод доступен до инициализации_
      */
-    isMobile: typeof WebRTCUtils.isMobile;
+    isMobile: typeof BrowserEnvironment.isMobile;
     /**
      * Имя браузера
      *
      * _Метод доступен до инициализации_
      */
-    browserName: typeof WebRTCUtils.browserName;
+    browserName: typeof BrowserEnvironment.browserName;
     /**
      * Версия браузера
      *
      * _Метод доступен до инициализации_
      */
-    browserVersion: typeof WebRTCUtils.browserVersion;
+    browserVersion: typeof BrowserEnvironment.browserVersion;
     /**
      * Если браузер основан на хроме - возвращает версию
      *
      * _Метод доступен до инициализации_
      */
-    baseChromeVersion: typeof WebRTCUtils.baseChromeVersion;
+    baseChromeVersion: typeof BrowserEnvironment.baseChromeVersion;
     /**
      * Возвращает AudioContext
      */
@@ -190,7 +207,7 @@ export declare const browser: {
      *
      * _Метод доступен до инициализации_
      */
-    isAudioShareSupported: typeof WebRTCUtils.isAudioShareSupported;
+    isAudioShareSupported: typeof BrowserEnvironment.isAudioShareSupported;
 };
 /**
  * Вспомогательные функции
@@ -258,7 +275,7 @@ export declare function callInternal(ids: OkUserId[], type: CallType | undefined
  * Для любого входящего пуша нужно вызвать этот метод.
  * Если уже есть активный звонок, метод отправит "занято" вызывающему абоненту
  *
- * `acceptCall` и `declineCall` будут работать только после вызова `processPush`
+ * Перед `acceptCall` и `declineCall` необходимо дождаться успешного завершения `processPush`.
  *
  * @param conversationId ID звонка
  * @param conversationParams conversationParams в base64
@@ -321,7 +338,10 @@ export declare function joinCallByLink(joinLink: string, mediaOptions?: MediaOpt
  * для проброса в сигналинг: по умолчанию `HUNGUP` (если звонок активен) или `CANCELED`.
  * См. {@link ClientHangupReason}.
  * `params.onFastHangup` — опционально: вместо Calls API hangup, если обработчик передан.
- * Без него API hangup не вызывается (signaling hangup остаётся). На `pagehide` всегда beacon.
+ * Без него отправляется Calls API beacon, если серверный ID уже известен. На `pagehide` всегда beacon.
+ * Локальное завершение и постановка onHangup в очередь происходят сразу; Promise ждёт известную SDK работу по завершению
+ * в пределах waitResponseDelay, без подтверждения доставки beacon или signaling HANGUP.
+ * Повторный вызов для того же завершающегося звонка возвращает тот же Promise.
  * См. {@link HangupParams}.
  */
 export declare function hangup(params?: HangupParams): Promise<void>;
@@ -330,8 +350,9 @@ export declare function hangup(params?: HangupParams): Promise<void>;
  *
  * @param externalIds Внешние ID пользователей
  * @param params Параметры
+ * @returns Участники из ответа сервера в публичном формате; undefined, если активного звонка нет или сигналинг не готов.
  */
-export declare function addParticipant(externalIds: ExternalId | ExternalId[], params?: AddParticipantParams): Promise<void>;
+export declare function addParticipant(externalIds: ExternalId | ExternalId[], params?: AddParticipantParams): Promise<ExternalParticipant[] | undefined>;
 /**
  * @deprecated - используйте addParticipant
  * @param uids
@@ -809,5 +830,5 @@ export declare function getSyncedTime(): number;
  * Версия SDK
  */
 export declare function version(): string;
-export type { AddParticipantParams, AudienceModeHandsResponse, BrowserName, ClientHangupReason, CompositeUserId, ConversationData, ConversationParams, ConversationResponse, CustomError, ExternalId, ExternalParticipant, ExternalParticipantListChunk, ExternalParticipantListMarker, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, DisplayLayoutRequest, GetParticipantsSignalingResponse, GetRoomsSignalingResponse, HangupReasonData, IApiEnv, IAPIBaseUrl, IAsrStartParams, IAsrStopParams, IAsrData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantId, ParticipantLayout, ParticipantListMarkers, ParticipantListType, ParticipantPriority, ParticipantsStateList, ParticipantStateData, ParticipantStateDataKey, ParticipantStateMapped, ParticipantStreamDescription, ParticipantListChunkParameters, ParticipantListMarker, RequestKeyFrame, Rooms, IGetParticipantsParameters, ScreenCaptureSettings, SignalingMessage, StatResult, StopStream, WaitingHallResponse, IMovieMetaData, IVideoDimentions, IFeedbackExternal, ISharedMovieInfo, ISharedMovieStoppedInfo, ISharedMovieState, ISharedMovieStateResponse, IAddMovieParams, IOnRemoteMovieData, IMoviePreview, IRoomId, Room, RoomsUpdate, RoomParticipantUpdate, IUpdateMovieData, IFeaturesPerRole, IMuteParticipantParams, IMuteParticipantInternalParams, IStartStreamData, IStopStreamData, IPublishStreamData, VmojiError, FastStartHandler, FastStartParams, FastJoinHandler, FastJoinParams, FastJoinResponse, FastHangupHandler, FastHangupParams, FastHangupResponse, HangupParams, };
-export { Api, AuthData, BaseLogger, CallDirection, CallType, ChatRoomEventType, ConversationOption, DebugMessageType, ExternalIdType, FacingMode, FatalError, HangupReason, HangupType, MediaOption, MediaTrackKind, MediaType, MuteState, ParticipantState, ParticipantStateDataValue, ParticipantStatus, RecordRole, Signaling, SignalingCommandType, SignalingConnectionType, SignalingNotification, UserRole, UserType, TransportTopology, RoomsEventType, ConversationFeature, ArrayDequeue, ApiExternal, VolumeDetector, };
+export type { AddParticipantParams, AudienceModeHandsResponse, BrowserName, ClientHangupReason, ClientStatsEvent, CompositeUserId, ConversationData, ConversationParams, ConversationResponse, CustomError, ExternalId, ExternalParticipant, ExternalParticipantListChunk, ExternalParticipantListMarker, ExternalParticipantListMarkers as ExternalParticipantMarkers, ExternalParticipantId, DisplayLayoutRequest, GetParticipantsSignalingResponse, GetRoomsSignalingResponse, HangupReasonData, IApiEnv, IAPIBaseUrl, IAsrStartParams, IAsrStopParams, IAsrData, IceServer, JSONArray, JSONObject, JSONType, Layout, MediaModifiers, MediaSettings, MuteStates, OkUserId, ParamsObject, ParticipantId, ParticipantLayout, ParticipantListMarkers, ParticipantListType, ParticipantPriority, ParticipantsStateList, ParticipantStateData, ParticipantStateDataKey, ParticipantStateMapped, ParticipantStreamDescription, ParticipantListChunkParameters, ParticipantListMarker, RequestKeyFrame, Rooms, IGetParticipantsParameters, ScreenCaptureSettings, SignalingMessage, StatResult, StopStream, WaitingHallResponse, IMovieMetaData, IVideoDimentions, IFeedbackExternal, ISharedMovieInfo, ISharedMovieStoppedInfo, ISharedMovieState, ISharedMovieStateResponse, IAddMovieParams, IOnRemoteMovieData, IMoviePreview, IRoomId, Room, RoomsUpdate, RoomParticipantUpdate, IUpdateMovieData, IFeaturesPerRole, IMuteParticipantParams, IMuteParticipantInternalParams, IStartStreamData, IStopStreamData, IPublishStreamData, VmojiError, FastStartHandler, FastStartParams, FastJoinHandler, FastJoinParams, FastJoinResponse, FastHangupHandler, FastHangupParams, FastHangupResponse, HangupParams, };
+export { Api, AuthData, BaseLogger, CallDirection, CallType, ChatRoomEventType, ConversationOption, DebugMessageType, ExternalIdType, FacingMode, FatalError, HangupReason, HangupType, MediaOption, MediaTrackKind, MediaType, MuteState, ParticipantState, ParticipantStateDataValue, ParticipantStatus, RecordRole, Signaling, SignalingCommandType, SignalingConnectionType, SignalingNotification, Stat, UserRole, UserType, TransportTopology, RoomsEventType, ConversationFeature, ArrayDequeue, ApiExternal, VolumeDetector, };

package/abstract/BaseApi.d.ts

@@ -11,7 +11,7 @@ import { ApiCallStats } from '../classes/stat/ApiCallStats';
 export type ClientStats = {
     call_topology: 'D' | 'S';
     vcid: ConversationData['id'] | null;
-    [k: string]: string | number | boolean | null;
+    [k: string]: string | string[] | number | boolean | null;
 };
 export type LogItem = {
     count?: number;