@vkontakte/calls-sdk 2.8.8-dev.cf529496.0 → 2.8.8-dev.d457738f.0

package/classes/Conversation.d.ts

@@ -81,6 +81,7 @@ export default class Conversation extends EventEmitter {
     private _extractExternalRoomsData;
     onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string, wsEndpoint?: string): Promise<void>;
     private _isInWaitingHall;
+    private _isWaitForAdmin;
     private _isRestricted;
     private _isAudienceMode;
     private _isAudienceModeListener;
@@ -204,6 +205,10 @@ export default class Conversation extends EventEmitter {
     sendClientEvent(eventType: string, eventData?: Record<string, string | number | boolean>, immediately?: boolean): void;
     private _changeMediaSettings;
     private _stopStreaming;
+    /**
+     * @param layoutByStreamDescription
+     * @param throwErrorOutside false используется при внутреннем обращении, когда обработка ошибки не нужна
+     */
     private _sendUpdateDisplayLayout;
     private _cleanupCooldownQueue;
     private _onParticipantSourcesUpdate;
@@ -288,6 +293,7 @@ export default class Conversation extends EventEmitter {
     private _onLocalMediaStreamChanged;
     private _onScreenSharingStatus;
     private _changeRemoteMediaSettings;
+    private _extractLocalParticipantFromConnection;
     private _changeLocalParticipantState;
     private _changeRemoteParticipantState;
     private _changeMultipleParticipantState;

package/classes/Conversation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/classes/VolumesDetector.d.ts

@@ -7,6 +7,7 @@ export declare class VolumesDetector extends EventEmitter {
     private _detector;
     private _interval;
     private _activeParticipants;
+    private _removedParticipants;
     constructor(transport: Transport);
     destroy(): void;
     private _onRemoteTrackAdded;

package/classes/screenshare/PacketHistory.test.d.ts

@@ -0,0 +1 @@
+export {};

package/classes/screenshare/ScreenCaptureSender.test.d.ts

@@ -0,0 +1 @@
+export {};

package/classes/transport/ServerTransport.test.d.ts

@@ -0,0 +1 @@
+export {};

package/default/Api.d.ts

@@ -20,13 +20,15 @@ export default class Api extends BaseApi {
     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, }?: {
+    createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, }?: {
         onlyAdminCanShareMovie?: boolean;
         audienceMode?: boolean;
         audioOnly?: boolean;
+        waitForAdmin?: boolean;
     }, speakerIds?: OkUserId[]): Promise<ConversationResponse>;
-    startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie }?: {
+    startConversation(conversationId: string, ids?: OkUserId[], type?: CallType, isVideo?: boolean, payload?: string, joiningAllowed?: boolean, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, waitForAdmin }?: {
         onlyAdminCanShareMovie?: boolean;
+        waitForAdmin?: boolean;
     }, externalIds?: ExternalId[]): Promise<ConversationResponse>;
     protected _ensureUuid(): void;
     deviceId(): string;

package/default/Api.test.d.ts

@@ -0,0 +1 @@
+export {};

package/default/Signaling.d.ts

@@ -56,7 +56,6 @@ export default class Signaling extends BaseSignaling {
     private static get WAIT_CONNECTION_DELAY();
     private static get WAIT_RESPONSE_DELAY();
     private static get WAIT_MESSAGE_DELAY();
-    private static _getCapabilityFlags;
     get ready(): boolean;
     setEndpoint(endpoint: string): void;
     setWebTransportEndpoint(endpoint: string | null): void;
@@ -184,6 +183,9 @@ export default class Signaling extends BaseSignaling {
     private _convertDisplayLayout;
     protected _waitConnectionMessage(): void;
     protected _stopWaitConnectionMessage(): void;
+    /**
+     * Отвечает за timeout логику в WebSocket, если неполучаем никаких сообщений в течении WAIT_MESSAGE_DELAY, то запускаем реконнект
+     */
     private _startDoctor;
     private _stopDoctor;
     private isWebTransportAvailable;

package/default/Signaling.test.d.ts

@@ -0,0 +1 @@
+export {};

package/enums/ConversationOption.d.ts

@@ -5,6 +5,8 @@ declare enum ConversationOption {
     REQUIRE_AUTH_TO_JOIN = "REQUIRE_AUTH_TO_JOIN",
     AUDIENCE_MODE = "AUDIENCE_MODE",// Stereo chat room
     WAITING_HALL = "WAITING_HALL",// Waiting Hall is ON
+    WAIT_FOR_ADMIN = "WAIT_FOR_ADMIN",
+    ADMIN_IS_HERE = "ADMIN_IS_HERE",
     ASR = "ASR",
     FEEDBACK = "FEEDBACK",// Reactions (default = off)
     RECURRING = "RECURRING"

package/enums/FatalError.d.ts

@@ -2,21 +2,85 @@
  * Типы ошибок
  */
 declare enum FatalError {
+    /**
+     * Ошибка комбинированных разрешений на микрофон и камеру
+     * Выбрасывается при отсутствии разрешений на оба устройства одновременно
+     */
     MIC_CAMERA_PERMISSION = "mic_camera",
+    /**
+     * Отсутствуют разрешения на доступ к камере
+     * Выбрасывается при отказе пользователя в доступе к камере или системном запрете
+     */
     CAMERA_PERMISSION = "camera",
+    /**
+     * Отсутствуют разрешения на доступ к микрофону
+     * Выбрасывается при отказе пользователя в доступе к микрофону или системном запрете
+     */
     MIC_PERMISSION = "mic",
+    /**
+     * Камера заблокирована другим приложением
+     * Выбрасывается когда камера уже используется другим приложением
+     */
     CAMERA_ACCESS = "cameralock",
+    /**
+     * Микрофон заблокирован другим приложением
+     * Выбрасывается когда микрофон уже используется другим приложением
+     */
     MIC_ACCESS = "miclock",
+    /**
+     * Микрофон не найден
+     * Выбрасывается когда система не может найти доступный микрофон
+     */
     MIC_NOT_FOUND = "nomic",
+    /**
+     * Отсутствуют разрешения на доступ к экрану
+     * Выбрасывается при отказе пользователя в доступе к скриншарингу
+     */
     SCREEN_PERMISSION = "screenpermission",
+    /**
+     * Общий сбой доступа к экрану
+     * Выбрасывается при общих ошибках скриншаринга, кроме отказа в разрешении
+     */
     SCREEN_ACCESS = "screenlock",
+    /**
+     * Ошибка соединения
+     * Выбрасывается при проблемах с сетевым соединением
+     */
     CONNECTION = "connection",
+    /**
+     * Сетевая ошибка
+     * Выбрасывается при сетевых проблемах во время вызова
+     */
     NETWORK = "network",
+    /**
+     * Неизвестная ошибка
+     * Выбрасывается как fallback для непредвиденных ошибок
+     */
     UNKNOWN = "unknown",
+    /**
+     * Браузер или окружение не поддерживаются
+     * Выбрасывается при запуске в неподдерживаемом браузере или окружении
+     */
     UNSUPPORTED = "unsupported",
+    /**
+     * Сбой сигнализации (signaling)
+     * Выбрасывается при ошибках соединения с сервером сигнализации
+     */
     SIGNALING_FAILED = "signalingfailed",
+    /**
+     * Ошибка API или отсутствует ключ API
+     * Выбрасывается при ошибках вызова API или отсутствии API ключа
+     */
     API = "api",
+    /**
+     * Ошибка аутентификации
+     * Выбрасывается при ошибках аутентификации API
+     */
     AUTH = "auth",
+    /**
+     * Медиа-ограничения слишком строгие
+     * Выбрасывается когда запрошенные параметры медиа не могут быть удовлетворены
+     */
     OVERCONSTRAINED = "overconstrained"
 }
 export default FatalError;

package/enums/HangupType.d.ts

@@ -21,6 +21,7 @@ declare enum HangupType {
     UNSUPPORTED = "UNSUPPORTED",
     OLD_VERSION = "OLD_VERSION",
     SERVICE_DISABLED = "SERVICE_DISABLED",
+    SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
     EXTERNAL_API_ERROR = "EXTERNAL_API_ERROR",
     SOCKET_CLOSED = "SOCKET_CLOSED",
     ENDED = "ENDED",
@@ -28,6 +29,22 @@ declare enum HangupType {
     ANOTHER_DEVICE = "ANOTHER_DEVICE",
     NOT_FOUND = "NOT_FOUND",
     VCHAT_DETAILED_ERROR = "VCHAT_DETAILED_ERROR",
-    TIMEOUT = "TIMEOUT"
+    TIMEOUT = "TIMEOUT",
+    /**
+     * Проблемы при работе через FastStart
+     */
+    FAST_START_ERROR = "FAST_START_ERROR",
+    /**
+     * Таймаут инициализации вызова – звонок не начался
+     *
+     * Этот статус означает, что вызов был инициирован, но к нему
+     * ни один участник не подключился через WebSocket/WebTransport
+     * в ожидаемый период времени. Обычно это происходит, когда:
+     * - Устройства вызываемого находятся офлайн
+     * - Проблемы с сетевым соединением мешают установить связь
+     * - Приложение вызываемого не запущено или упало
+     * - Брандмауэр или сетевые ограничения блокируют подключение
+     */
+    CALL_TIMEOUT = "CALL_TIMEOUT"
 }
 export default HangupType;

package/package.json

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

package/static/External.d.ts

@@ -22,11 +22,13 @@ import { IRoomId, Room, RoomParticipantUpdate, Rooms, RoomsUpdate } from '../typ
 import { VmojiError } from '../types/Vmoji';
 import { DebugMessageType } from './Debug';
 import { JSONObject } from './Json';
+import { ParticipantCapabilities } from './SignalingCapabilities';
 /**
  * Статус собеседника
  */
 export declare enum ParticipantStatus {
     WAITING_HALL = "WAITING_HALL",
+    WAIT_FOR_ADMIN = "WAIT_FOR_ADMIN",
     WAITING = "WAITING",
     CONNECTING = "CONNECTING",
     CONNECTED = "CONNECTED",
@@ -342,8 +344,9 @@ declare namespace External {
     /**
      * Исходящий звонок был принят кем-то
      * @param userId
+     * @param capabilities
      */
-    function onAcceptedCall(userId: ExternalId): void;
+    function onAcceptedCall(userId: ExternalId, capabilities: ParticipantCapabilities): void;
     function onRateNeeded(): void;
     /**
      * Изменился говорящий в звонке

package/static/Params.d.ts

@@ -27,6 +27,7 @@ import { VmojiError } from '../types/Vmoji';
 import { DebugMessageType } from './Debug';
 import { ParticipantStatus } from './External';
 import { JSONObject } from './Json';
+import { ParticipantCapabilities } from './SignalingCapabilities';
 import { FacingMode } from './WebRTCUtils';
 /**
  * Параметры инициализации
@@ -103,6 +104,17 @@ export type ParamsObject = {
     debugLog: boolean;
     /** @hidden */
     debug: boolean;
+    /**
+     * Выставляет таймаут в ms для fetch запросов от sdk
+     * По умолчанию 5000 ms
+     * @hidden
+     */
+    apiTimeout: number;
+    /**
+     * Количество ретраев прежде чем сбросить ошибку
+     * @hidden
+     */
+    apiMaxAttempt: number;
     /**
      * Не отправлять в ICE-кандидатах персональные IP-адреса
      * @see [RTCIceTransportPolicy](https://www.w3.org/TR/webrtc/#rtcicetransportpolicy-enum)
@@ -359,6 +371,10 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     useChatRooms: boolean;
+    /**
+     * Включить поддержку добавления участника в разговор
+     */
+    addParticipant: boolean;
     /**
      * Индекс участника для первого chunk'а который придет при установке соединения с сервером
      *
@@ -704,7 +720,7 @@ export type ParamsObject = {
     /**
      * Звонок был завершен
      */
-    onHangup?: (type: HangupReason, conversationId: string | null) => void;
+    onHangup?: (type: HangupReason | Error, conversationId: string | null) => void;
     /**
      * Входящий звонок был принят мной
      */
@@ -713,7 +729,7 @@ export type ParamsObject = {
      * Исходящий звонок был принят кем-то
      * @param userId
      */
-    onAcceptedCall?: (userId: ExternalParticipantId) => void;
+    onAcceptedCall?: (userId: ExternalParticipantId, capabilities: ParticipantCapabilities) => void;
     /**
      * Список устройств изменился
      */
@@ -921,6 +937,8 @@ export default abstract class Params {
     static get apiBaseUrl(): IAPIBaseUrl;
     static set apiBaseUrl(apiBaseUrl: IAPIBaseUrl);
     static apiEndpoint(apiEnv?: IApiEnv): string;
+    static get apiTimeout(): number;
+    static get apiMaxAttempt(): number;
     static get authToken(): string;
     static set authToken(value: string);
     static get anonymToken(): string;
@@ -1004,6 +1022,7 @@ export default abstract class Params {
     static get useParticipantListChunk(): boolean;
     static get useRooms(): boolean;
     static get useChatRooms(): boolean;
+    static get addParticipant(): boolean;
     static get participantListChunkInitIndex(): number;
     static get participantListChunkInitCount(): number | null;
     static get serverAudioRed(): boolean;
@@ -1044,6 +1063,7 @@ export default abstract class Params {
         useParticipantListChunk: boolean;
         useRooms: boolean;
         useChatRooms: boolean;
+        addParticipant: boolean;
         fastScreenShare: boolean;
         participantListChunkInitCount: number | null;
         screenShareCongestionControl: boolean;

package/static/SignalingCapabilities.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @see https://confluence.vk.team/display/VIDEOOK/Websocket+Capability+Flags
+ */
+declare const PREDICATES: {
+    readonly producerScreenTrack: () => boolean;
+    readonly videoTracksCount: () => boolean;
+    readonly waitingHall: () => boolean;
+    readonly filteredMessages: () => boolean;
+    readonly consumerScreenTrack: () => boolean;
+    readonly muteNotificationForAdmins: () => boolean;
+    readonly movieShare: () => boolean;
+    readonly useParticipantListChunk: () => boolean;
+    readonly useRooms: () => boolean;
+    readonly vmoji: () => boolean;
+    readonly useCallsToContacts: () => boolean;
+    readonly useChatRooms: () => boolean;
+    readonly audienceModeHandUpTimestamps: () => boolean;
+    readonly animojiBackendRender: () => boolean;
+    readonly sessionStateUpdates: () => boolean;
+    readonly addParticipant: () => boolean;
+    readonly waitForAdmin: () => boolean;
+};
+type ParticipantCapabilitiesKeys = keyof typeof PREDICATES;
+export type ParticipantCapabilities = Record<ParticipantCapabilitiesKeys, boolean>;
+export declare class SignalingCapabilities {
+    static getFlags(): string;
+    static parseCapabilities(mask?: string): ParticipantCapabilities;
+}
+export {};

package/static/Utils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/static/WebRTCUtils.test.d.ts

@@ -0,0 +1 @@
+export {};

package/types/Conversation.d.ts

@@ -64,6 +64,7 @@ export type ConversationData = {
     muteStatesPersonal: MuteStates;
     networkRating: number;
     waitingHall: boolean;
+    waitForAdmin: boolean;
     observer: boolean;
     roomId: IRoomId;
     audienceMode: boolean;

package/types/FastStart.d.ts

@@ -1,4 +1,4 @@
-import { HangupType, IceServer } from '../CallsSDK';
+import { IceServer } from '../CallsSDK';
 import CallType from '../enums/CallType';
 import MediaOption from '../enums/MediaOption';
 import { ExternalId } from './ExternalId';
@@ -37,10 +37,10 @@ export interface FastStartParams {
     isVideo?: boolean;
 }
 export interface FastStartResponse {
-    internalCallerParams: string;
+    internalCallerParams?: string;
     rejectedParticipants: {
         id: string;
-        status: HangupType;
+        status: string;
     }[];
 }
 export type FastStartHandler = (params: FastStartParams) => Promise<FastStartResponse>;

package/types/Params.d.ts

@@ -1,2 +1,2 @@
-export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | string;
+export type IApiEnv = 'AUTO' | 'PROD' | 'CALLS' | 'PROD_OK' | 'TEST' | 'VIDEOTEST' | 'CALLSTEST' | 'CALLS_BETA' | 'CALLS_BENDER' | 'CALLS_MAMES' | 'CALLS_MARS' | string;
 export type IAPIBaseUrl = string | null;

package/types/SignalingMessage.d.ts

@@ -182,6 +182,7 @@ declare namespace SignalingMessage {
         deviceIdx?: number;
         peerId: PeerId;
         mediaSettings: Partial<MediaSettings>;
+        capabilities?: string;
     }
     export interface Hungup extends Notification {
         participantId: OkUserId;

package/utils/IList.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/LengthPrefixed.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/P2Quantile.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/VariableLengthInteger.test.d.ts

@@ -0,0 +1 @@
+export {};

package/utils/Welford.test.d.ts

@@ -0,0 +1 @@
+export {};