@vkontakte/calls-sdk 2.8.8-dev.4e225733.0 → 2.8.8-dev.52b6ccd7.0

package/classes/Conversation.d.ts

@@ -204,6 +204,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 +292,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.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/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",
@@ -29,6 +30,10 @@ declare enum HangupType {
     NOT_FOUND = "NOT_FOUND",
     VCHAT_DETAILED_ERROR = "VCHAT_DETAILED_ERROR",
     TIMEOUT = "TIMEOUT",
+    /**
+     * Проблемы при работе через FastStart
+     */
+    FAST_START_ERROR = "FAST_START_ERROR",
     /**
      * Таймаут инициализации вызова – звонок не начался
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.8-dev.4e225733.0",
+  "version": "2.8.8-dev.52b6ccd7.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,6 +22,7 @@ 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';
 /**
  * Статус собеседника
  */
@@ -342,8 +343,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,12 @@ export type ParamsObject = {
     debugLog: boolean;
     /** @hidden */
     debug: boolean;
+    /**
+     * Выставляет таймаут в ms для fetch запросов от sdk
+     * По умолчанию 5000 ms
+     * @hidden
+     */
+    apiTimeout: number;
     /**
      * Не отправлять в ICE-кандидатах персональные IP-адреса
      * @see [RTCIceTransportPolicy](https://www.w3.org/TR/webrtc/#rtcicetransportpolicy-enum)
@@ -359,6 +366,10 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     useChatRooms: boolean;
+    /**
+     * Включить поддержку добавления участника в разговор
+     */
+    addParticipant: boolean;
     /**
      * Индекс участника для первого chunk'а который придет при установке соединения с сервером
      *
@@ -704,7 +715,7 @@ export type ParamsObject = {
     /**
      * Звонок был завершен
      */
-    onHangup?: (type: HangupReason, conversationId: string | null) => void;
+    onHangup?: (type: HangupReason | Error, conversationId: string | null) => void;
     /**
      * Входящий звонок был принят мной
      */
@@ -713,7 +724,7 @@ export type ParamsObject = {
      * Исходящий звонок был принят кем-то
      * @param userId
      */
-    onAcceptedCall?: (userId: ExternalParticipantId) => void;
+    onAcceptedCall?: (userId: ExternalParticipantId, capabilities: ParticipantCapabilities) => void;
     /**
      * Список устройств изменился
      */
@@ -921,6 +932,7 @@ 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 authToken(): string;
     static set authToken(value: string);
     static get anonymToken(): string;
@@ -1004,6 +1016,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 +1057,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,24 @@
+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 addParticipant: () => 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/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/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 {};