@vkontakte/calls-sdk 2.8.12-dev.c0dd153e.0 → 2.8.12-dev.c8b26761.0

package/classes/transport/Transport.d.ts

@@ -48,13 +48,16 @@ export declare class Transport extends EventEmitter {
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _codecStatsAggregator;
-    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
+    private readonly _onFirstMediaSent;
+    private _firstMediaSentProbeStopped;
+    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
     allocate(participantId: ParticipantId, isMaster?: boolean): void;
     open(participantIds: ParticipantId[], peerId?: string | null, observer?: boolean, force?: boolean): void;
     close(participantId: ParticipantId): void;
     destroy(): void;
+    stopFirstMediaSentProbe(): void;
     holdClose(): void;
     setRemoteHold(hold: boolean): void;
     getTopology(): TransportTopology;
@@ -69,6 +72,8 @@ export declare class Transport extends EventEmitter {
     private _setStates;
     private _setLocalState;
     private _onSignalingNotification;
+    private _handleFirstMediaSent;
+    private _getFirstMediaSentCallback;
     private _onTopologyChanged;
     private _createDirectTransport;
     private _createServerTransport;

package/default/Api.d.ts

@@ -7,12 +7,11 @@ import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/Exte
 import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
 import PushData from '../types/PushData';
 export default class Api extends BaseApi {
-    private _userId;
     private _uuid;
     private _idCache;
     private _callUnsafe;
-    protected _call(method: string, data?: any, noSession?: boolean): Promise<any>;
-    userId(participantId: ParticipantId): Promise<ExternalParticipantId>;
+    protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
+    userId(participantId: ParticipantId): ExternalParticipantId;
     authorize(): Promise<void>;
     private _getAnonymLoginCacheKey;
     private _getCachedAnonymLogin;

package/default/Signaling.d.ts

@@ -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,21 +60,16 @@ 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>;
+    hangup(reason: string): Promise<SignalingMessage>;
     sendCandidate(participantId: ParticipantId, candidate: RTCIceCandidate): Promise<SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string | null): Promise<SignalingMessage>;
     sendSdp(participantId: ParticipantId, sdp: RTCSessionDescriptionInit, extraPayload?: Record<string, any>): 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,4 +1,9 @@
 declare const enum Stat {
+    CALL_INIT = "call_init",
+    CALL_START = "call_start",
+    CALL_ACCEPTED_OUTGOING = "call_accepted_outgoing",
+    CALL_ACCEPTED_INCOMING = "call_accepted_incoming",
+    FIRST_MEDIA_SENT = "first_media_sent",
     CALL_FINISH = "call_finish",// событие отправляемое в конце звонка
     CODEC_USAGE = "codec_usage",// событие когда меняется кодек
     SIGNALING_CONNECTED = "signaling_connected",// measure
@@ -7,7 +12,6 @@ declare const enum Stat {
     FIRST_MEDIA_RECEIVED = "first_media_received",
     CALL_DECLINED_OR_HANGED_LOCALLY = "CallDeclinedOrHangedLocally",
     USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
-    CALL_START = "call_start",
     SIGNALING_PING_SUMMARY = "signaling_ping_summary",
     SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
     WEBSOCKET_CONNECTED = "websocket_connected",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.12-dev.c0dd153e.0",
+  "version": "2.8.12-dev.c8b26761.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,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/Debug.d.ts

@@ -21,6 +21,7 @@ export type DebugSessionLogger = DebugLogger & {
     readonly sessionId: string | null;
     readonly conversationId: string | null;
     setConversationId(conversationId: string | null): void;
+    send(type: DebugMessageType, ...args: any[]): void;
 };
 declare namespace Debug {
     type ContextProvider = () => DebugMessageContext;

package/static/External.d.ts

@@ -637,6 +637,6 @@ declare namespace External {
     /**
      * Собеседник подключился к сигналлингу
      */
-    function onPeerRegistered(conversationId?: string): void;
+    function onPeerRegistered(conversationId?: string, externalIds?: ExternalId[]): void;
 }
 export default External;

package/static/Params.d.ts

@@ -892,7 +892,7 @@ export type ParamsObject = {
     /**
      * Собеседник подключился к сигналлингу
      */
-    onPeerRegistered?: (conversationId?: string) => void;
+    onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
 };
 export default abstract class Params {
     private static _params;

package/static/WebRTCUtils.d.ts

@@ -122,6 +122,10 @@ declare namespace WebRTCUtils {
      * Проверяет поддержку WebRTC браузером
      */
     function isBrowserSupported(): boolean;
+    /**
+     * Возвращает первую отсутствующую capability в стабильном порядке.
+     */
+    function getBrowserSupportFailure(): BrowserSupportFailure | null;
     /**
      * Проверяет поддержку шаринга экрана браузером
      */

package/types/Conversation.d.ts

@@ -7,7 +7,8 @@ import MediaOption from '../enums/MediaOption';
 import UserRole from '../enums/UserRole';
 import { AsrInfo } from './Asr';
 import { IFeaturesPerRole } from './ConversationFeature';
-import { ExternalId, ExternalParticipantId } from './ExternalId';
+import { ExternalId, ExternalParticipantId, ExternalUserId } from './ExternalId';
+import { FastJoinHandler } from './FastJoin';
 import { FastStartHandler } from './FastStart';
 import MediaModifiers from './MediaModifiers';
 import MuteStates from './MuteStates';
@@ -84,6 +85,16 @@ export type ConversationOnStartParams = {
     onFastStart?: FastStartHandler;
     conversationId?: string;
 };
+export type ConversationOnJoinParams = {
+    conversationId?: string;
+    mediaOptions: MediaOption[];
+    chatId?: string;
+    joinLink?: string;
+    observedIds?: ExternalUserId[];
+    payload?: string;
+    onFastJoin?: FastJoinHandler;
+    anonymous?: boolean;
+};
 export type StartConversationParams = {
     opponentIds?: OkUserId[];
     opponentType: CallType;
@@ -94,7 +105,6 @@ export type StartConversationParams = {
     requireAuthToJoin?: boolean;
     onlyAdminCanShareMovie?: boolean;
     externalIds?: ExternalId[];
-    startedTime: number;
     onFastStart?: FastStartHandler;
     conversationId?: string;
 };

package/types/FastHangup.d.ts

@@ -0,0 +1,68 @@
+import type ClientHangupReason from '../enums/ClientHangupReason';
+import type HangupType from '../enums/HangupType';
+/**
+ * Параметры запроса завершения звонка через внешнего партнёра (fast hangup).
+ *
+ * SDK генерирует объект и передаёт его в {@link FastHangupHandler}.
+ * Хост и backend партнёра пробрасывают `internalParams` как есть, без парсинга.
+ */
+export interface FastHangupParams {
+    /**
+     * ID звонка
+     */
+    conversationId: string;
+    /**
+     * Причина завершения звонка
+     */
+    reason: HangupType;
+    /**
+     * Внутренние параметры звонка (JSON-строка). Генерируется SDK.
+     */
+    internalParams?: string | null;
+}
+/**
+ * Ответ внешнего партнёра на завершение звонка.
+ */
+export interface FastHangupResponse {
+    /**
+     * true — участие в звонке завершено
+     */
+    success: boolean;
+}
+/**
+ * Параметры публичных методов {@link hangup} / {@link declineCall}.
+ *
+ * `reason` и `conversationId` идут в signaling hangup.
+ * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
+ * (явный hangup/decline или delayed hangup во время init).
+ * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
+ * где SDK всегда шлёт beacon, и delayed hangup без handler.
+ */
+export interface HangupParams {
+    /**
+     * ID звонка. Если опущен — завершается текущий активный звонок.
+     */
+    conversationId?: string;
+    /**
+     * Причина завершения для проброса в сигналинг. См. {@link ClientHangupReason}.
+     */
+    reason?: ClientHangupReason;
+    /**
+     * Обработчик fast hangup — завершение звонка через внешнего партнёра.
+     */
+    onFastHangup?: FastHangupHandler;
+}
+/**
+ * Функция-обработчик fast hangup.
+ *
+ * Если передана в {@link HangupParams.onFastHangup} при `hangup` / `declineCall`,
+ * SDK вызывает её вместо API `vchat.hangupConversation`.
+ *
+ * Fire-and-forget: `success` и ошибки логируются SDK и не влияют на teardown и `onHangup`.
+ *
+ * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
+ *
+ * @param params Параметры запроса
+ * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
+ */
+export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;

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/utils/IceServers.d.ts

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