@vkontakte/calls-sdk 2.8.12-dev.a3089173.0 → 2.8.12-dev.a4b1a09a.0

package/default/Signaling.d.ts

@@ -1,15 +1,15 @@
 import BaseSignaling, { AddParticipantParams } from '../abstract/BaseSignaling';
-import StatsLogger from '../classes/StatsLogger';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
 import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
 import { StatAggregator } from '../classes/stat/StatAggregator';
 import { StatPings } from '../classes/stat/StatPings';
 import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
-import TransportTopology from '../enums/TransportTopology';
+import StatsLogger from '../classes/StatsLogger';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
 import SignalingConnectionType from '../enums/SignalingConnectionType';
+import TransportTopology from '../enums/TransportTopology';
 import UserRole from '../enums/UserRole';
 import { type DebugLogger } from '../static/Debug';
 import { JSONObject } from '../static/Json';
@@ -35,13 +35,13 @@ export default class Signaling extends BaseSignaling {
     private datachannelCommandsQueue;
     private incomingCache;
     private responseHandlers;
+    private disposed;
     private connectionType;
     private conversationResolve;
     private conversationReject;
     private connected;
     private listenersReady;
     private peerId;
-    private conversationId;
     private connectionMessageWaitTimer;
     private participantIdRegistry;
     private producerNotificationDataChannel;
@@ -60,22 +60,17 @@ export default class Signaling extends BaseSignaling {
     setAbortSignal(signal: AbortSignal | undefined): void;
     setEndpoint(endpoint: string): void;
     setWebTransportEndpoint(endpoint: string | null): void;
-    setConversationId(conversationId: string): void;
     setParticipantIdRegistry(participantIdRegistry: ParticipantIdRegistry): void;
     setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
     setProducerCommandDataChannel(dataChannel: RTCDataChannel): void;
     useCommandDataChannel(status: boolean): void;
-    /**
-     * Free used resources
-     */
-    cleanup(): void;
     /**
      * Open a connection with a signaling server
      */
     connect(connectionType: SignalingConnectionType): Promise<SignalingMessage.Connection>;
     getNextCommandSequenceNumber(): number;
-    hangup(reason: string): Promise<SignalingMessage | void>;
-    sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
+    hangup(reason: string): Promise<SignalingMessage>;
+    sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidateInit): Promise<SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string | null): Promise<SignalingMessage>;
     sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): Promise<SignalingMessage>;
     acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
@@ -138,10 +133,7 @@ export default class Signaling extends BaseSignaling {
     acceptPromotion(reject?: boolean): Promise<SignalingMessage>;
     feedback(key: string): Promise<SignalingMessage>;
     getHandQueue(): Promise<SignalingMessage>;
-    /**
-     * Close a connection with a signaling server
-     */
-    close(): void;
+    dispose(cause?: Error): void;
     /**
      * Этот метод нужен т.к. после получения сообщения "connected" устанавливается транспорт
      * и подписывается на сигналинг. Данные приходят очень быстро и транспорт пропускает
@@ -173,20 +165,25 @@ export default class Signaling extends BaseSignaling {
     private _onError;
     private _serializeErrorEvent;
     private _onClose;
-    private _closeSocket;
+    private _terminate;
+    private _fail;
     private _isRecordCommand;
     private _resolvePendingRecordCommands;
     private _handleCommandResponse;
     private _handleCommandsQueue;
     private _startResponseTimer;
+    private _resolveCommandWithoutResponse;
     private _serializeBinary;
     private _serializeJson;
     private _convertDisplayLayout;
     private _waitConnectionMessage;
     private _stopWaitConnectionMessage;
+    private _onTransportConnecting;
     private _onTransportFailed;
     private _onTransportReconnectScheduled;
     private _onTransportConnectionDead;
+    private _attachNotificationCallError;
+    private _createSignalingCallError;
     private _getSocketType;
     private _markTransportStat;
     private _logTransportStat;

package/default/SignalingTransport.d.ts

@@ -9,13 +9,19 @@ export declare enum SignalingTransportFailure {
 export type SignalingTransportFailedEvent = {
     failure: SignalingTransportFailure;
     message: string;
+    source: SignalingTransportType;
     remote?: boolean;
 };
 export type SignalingTransportReconnectEvent = {
     count: number;
     delay: number;
 };
+export type SignalingTransportConnectingEvent = {
+    connectionType: SignalingConnectionType;
+    source: SignalingTransportType;
+};
 export type SignalingTransportHandlers = {
+    onConnecting: (event: SignalingTransportConnectingEvent) => void;
     onOpen: () => void;
     onMessage: (event: MessageEvent) => void;
     onError: (event: Event) => void;
@@ -51,7 +57,7 @@ export default class SignalingTransport {
     resetReconnectCount(): void;
     connect(connectionType: SignalingConnectionType): void;
     close(code?: number): void;
-    send(data: string | ArrayBuffer): void;
+    send(data: string | ArrayBuffer): Promise<void>;
     private _connect;
     private _connectWebTransport;
     private _connectWebSocket;

package/enums/ClientHangupReason.d.ts

@@ -0,0 +1,7 @@
+import HangupType from './HangupType';
+/**
+ * Причины завершения звонка, которые клиент может передать в {@link hangup}/{@link declineCall}
+ * и пробросить в сигналинг без маппинга.
+ */
+export type ClientHangupReason = HangupType.HUNGUP | HangupType.CANCELED | HangupType.REJECTED | HangupType.BUSY | HangupType.MISSED | HangupType.CALL_TIMEOUT;
+export default ClientHangupReason;

package/enums/HangupType.d.ts

@@ -20,7 +20,6 @@ declare enum HangupType {
     CALLER_IS_REJECTED = "CALLER_IS_REJECTED",
     UNKNOWN_ERROR = "UNKNOWN_ERROR",
     UNSUPPORTED = "UNSUPPORTED",
-    OLD_VERSION = "OLD_VERSION",
     SERVICE_DISABLED = "SERVICE_DISABLED",
     SERVICE_UNAVAILABLE = "SERVICE_UNAVAILABLE",
     EXTERNAL_API_ERROR = "EXTERNAL_API_ERROR",

package/enums/Stat.d.ts

@@ -1,6 +1,5 @@
 declare const enum Stat {
     CALL_INIT = "call_init",
-    CALL_WARMUP = "call_warmup",
     CALL_START = "call_start",
     CALL_ACCEPTED_OUTGOING = "call_accepted_outgoing",
     CALL_ACCEPTED_INCOMING = "call_accepted_incoming",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.12-dev.a3089173.0",
+  "version": "2.8.12-dev.a4b1a09a.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -22,6 +22,6 @@
     "fflate": "^0.8.2",
     "messagepack": "1.1.12",
     "simple-ebml-builder": "0.2.2",
-    "webrtc-adapter": "7.7.0"
+    "webrtc-adapter": "9.0.5"
   }
 }

package/static/AuthData.d.ts

@@ -1,12 +1,22 @@
+import type { OkUserId } from '../types/Participant';
 export default abstract class AuthData {
     private static _sessionKey;
     private static _sessionSecretKey;
     private static _accessToken;
+    private static _userId;
+    private static _reauthorizePromise;
     static get sessionKey(): string | undefined;
     static set sessionKey(value: string | undefined);
     static get sessionSecretKey(): string | undefined;
     static set sessionSecretKey(value: string | undefined);
     static get accessToken(): string | undefined;
     static set accessToken(value: string | undefined);
+    static get userId(): OkUserId | null;
+    static set userId(value: OkUserId | null);
     static isEmpty(): boolean;
+    /**
+     * Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.
+     * Первый вызов выполняет authorizeFn, остальные ждут того же промиса.
+     */
+    static reauthorize(authorizeFn: () => Promise<void>): Promise<void>;
 }

package/static/External.d.ts

@@ -637,6 +637,16 @@ declare namespace External {
     /**
      * Собеседник подключился к сигналлингу
      */
-    function onPeerRegistered(conversationId?: string): void;
+    function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
+    /**
+     * SDK обнаружил ошибку, после которой звонок может продолжаться.
+     *
+     * Callback предназначен для отправки ошибки в клиентский мониторинг.
+     * Его вызов не означает завершение звонка.
+     *
+     * @param error
+     * @param conversationId ID звонка
+     */
+    function onNonFatalError(error: Error, conversationId: string | null): void;
 }
 export default External;

package/static/Params.d.ts

@@ -505,6 +505,16 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableSessionStateUpdates: boolean;
+    /**
+     * Использовать `<audio>` вместо `<video>` для воспроизведения звука в desktop Safari
+     * @hidden
+     */
+    safariAudioElement: boolean;
+    /**
+     * Отправлять пустой ICE candidate (end-of-candidates) удалённому пиру
+     * @hidden
+     */
+    forwardEmptyIceCandidate: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -892,7 +902,14 @@ export type ParamsObject = {
     /**
      * Собеседник подключился к сигналлингу
      */
-    onPeerRegistered?: (conversationId?: string) => void;
+    onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
+    /**
+     * SDK обнаружил ошибку, после которой звонок может продолжаться.
+     *
+     * Callback предназначен для отправки ошибки в клиентский мониторинг.
+     * Его вызов не означает завершение звонка.
+     */
+    onNonFatalError?: (error: Error, conversationId: string | null) => void;
 };
 export default abstract class Params {
     private static _params;
@@ -1027,6 +1044,8 @@ export default abstract class Params {
     static get waitForRecordResponse(): boolean;
     static get transparentAudio(): boolean;
     static get enableSessionStateUpdates(): boolean;
+    static get safariAudioElement(): boolean;
+    static get forwardEmptyIceCandidate(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1063,5 +1082,7 @@ export default abstract class Params {
         waitForRecordResponse: boolean;
         transparentAudio: boolean;
         enableSessionStateUpdates: boolean;
+        safariAudioElement: boolean;
+        forwardEmptyIceCandidate: boolean;
     };
 }

package/static/Utils.d.ts

@@ -9,7 +9,7 @@ export declare const DEVICE_IDX_PARAMETER = "d";
 /** @hidden */
 declare namespace Utils {
     function patchLocalSDP(sdp: string, preferH264: boolean, brokenH264Decoder: boolean, preferVP9: boolean, isAudioNack?: boolean): string;
-    function patchRemoteSDP(sdp: string, oldDataChannelDescription: boolean, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, brokenVP9Encoder: boolean, brokenVP9Decoder: boolean): string;
+    function patchRemoteSDP(sdp: string, preferH264: boolean, brokenH264: boolean, preferVP9: boolean, brokenVP9Encoder: boolean, brokenVP9Decoder: boolean): string;
     function getPeerIdString(peerId: SignalingMessage.PeerId): string;
     function comparePeerId(peerId1: SignalingMessage.PeerId, peerId2: SignalingMessage.PeerId): boolean;
     function getPeerConnectionHostInfo(pc: RTCPeerConnection): Promise<{

package/static/WebRTCUtils.d.ts

@@ -20,7 +20,7 @@ export declare enum FacingMode {
 /**
  * Известные браузеры
  */
-export type BrowserName = 'IE' | 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
+export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
 declare namespace WebRTCUtils {
     /**
      * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -122,6 +122,10 @@ declare namespace WebRTCUtils {
      * Проверяет поддержку WebRTC браузером
      */
     function isBrowserSupported(): boolean;
+    /**
+     * Возвращает первую отсутствующую capability в стабильном порядке.
+     */
+    function getBrowserSupportFailure(): BrowserSupportFailure | null;
     /**
      * Проверяет поддержку шаринга экрана браузером
      */
@@ -139,17 +143,14 @@ declare namespace WebRTCUtils {
      * В некоторых браузерах VP9 decoder сломан
      */
     function isBrokenVP9Decoder(): boolean;
-    /**
-     * Изменился формат описания датаканала в SDP
-     * @link https://blog.mozilla.org/webrtc/how-to-avoid-data-channel-breaking/
-     */
-    function isOldDataChannelDescription(): boolean;
     /**
      * Может ли браузер делать H264 приоритетным
      */
     function canPreferH264(): boolean;
     /**
-     * Некоторые браузеры (Firefox, Safari) некорректно поддерживают симулкаст
+     * Поддержка simulcast браузером.
+     * Safari корректно поддерживает simulcast начиная с версии 18.
+     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
      */
     function isSimulcastSupportedByBrowser(): boolean;
     /**

package/types/SignalingMessage.d.ts

@@ -34,8 +34,11 @@ export type RecordInfo = {
     recordExternalOwnerId?: string;
 };
 export interface SignalingResponse extends SignalingMessage {
-    response?: SignalingCommandType;
     error?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    message?: string;
+    response?: SignalingCommandType;
     reason?: HangupType | FatalError;
     sequence?: number;
     type: 'response' | 'error' | 'timeout';

package/types/WebTransport.d.ts

@@ -1,33 +1,32 @@
 import { WebTransportOptions } from '@fails-components/webtransport';
 import { DebugLogger } from '../static/Debug';
 declare class WebTransportEventual {
+    static isBrowserSupported(): boolean;
+    onopen: ((this: WebTransportEventual, ev: Event) => any) | null;
+    onmessage: ((this: WebTransportEventual, ev: MessageEvent) => any) | null;
+    onerror: ((this: WebTransportEventual, ev: Event) => any) | null;
+    onclose: ((this: WebTransportEventual, ev: CloseEvent) => any) | null;
+    readyState: number;
     private webTransport;
-    private stream;
     private writer;
-    private reader;
     private readonly url;
     private readonly options;
     private readonly compression;
-    private closeRequested;
-    private closeEventEmitted;
     private encoder;
     private decoder;
     private readonly _debug;
-    onopen: ((this: WebTransportEventual, ev: Event) => any) | null;
-    onmessage: ((this: WebTransportEventual, ev: MessageEvent) => any) | null;
-    onerror: ((this: WebTransportEventual, ev: Event) => any) | null;
-    onclose: ((this: WebTransportEventual, ev: CloseEvent) => any) | null;
-    readyState: number;
     constructor(url: string, options?: WebTransportOptions, debug?: DebugLogger);
+    send(data: string): Promise<void>;
+    close(code?: number, reason?: string): void;
     private getCompressionTypeFromUrl;
     private connect;
-    private readChunks;
+    private observeClosed;
     private readLoop;
-    send(data: string): Promise<void>;
+    private fail;
+    private handleStreamError;
+    private requestNativeClose;
+    private finishClose;
+    private emitEvent;
     private createErrorEvent;
-    close(code?: number, reason?: string): void;
-    private closeConnectedTransport;
-    private emitClose;
-    static isBrowserSupported(): boolean;
 }
 export { WebTransportEventual as WebTransport };

package/utils/IceServers.d.ts

@@ -0,0 +1,2 @@
+import IceServer from '../types/IceServer';
+export declare function createIceServers(stunServer?: IceServer, turnServer?: IceServer): IceServer[];

package/utils/NavigatorPermissions.d.ts

@@ -2,8 +2,8 @@ type Device = 'camera' | 'microphone';
 type PermissionStatusState = typeof PermissionStatus.prototype.state;
 type EventListener = (name: Device, state: PermissionStatusState) => void;
 export declare class NavigatorPermissions {
-    private _cameraPermissionStatus;
-    private _microphonePermissionStatus;
+    private _cameraPermissionStatus?;
+    private _microphonePermissionStatus?;
     private _listener;
     static isSupported(): boolean;
     init(listener: EventListener): Promise<void>;