@vkontakte/calls-sdk 2.8.12-dev.dd6d67c5.0 → 2.8.12-dev.dd833275.0

package/default/Api.d.ts

@@ -1,25 +1,49 @@
 import BaseApi, { ClientStats } from '../abstract/BaseApi';
 import CallType from '../enums/CallType';
 import HangupType from '../enums/HangupType';
+import { IHangupParams } from '../types/Api';
 import ConversationParams from '../types/ConversationParams';
 import ConversationResponse from '../types/ConversationResponse';
 import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
 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>;
+    protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
     userId(participantId: ParticipantId): ExternalParticipantId;
     authorize(): Promise<void>;
+    /**
+     * Запрос auth.anonymLogin без побочных эффектов: ничего не пишет в
+     * AuthData и кэш. Пустой токен — анонимный логин версии 2.
+     */
+    private _anonymLogin;
     private _getAnonymLoginCacheKey;
     private _getCachedAnonymLogin;
     private _setCachedAnonymLogin;
     private _removeCachedAnonymLogin;
+    private _reauthorize;
     private _applyAnonymLogin;
-    logClientStats(items: ClientStats[]): void;
+    private _buildClientStatsData;
+    /**
+     * Ошибки по отдельным событиям логируются, но не влияют на результат:
+     * батч трактуется целиком, иначе одно всегда отвергаемое событие
+     * залипило бы очередь навсегда.
+     */
+    private _reportClientStatsItemErrors;
+    /**
+     * noSession = true: _prepareQuery не подставит session_key из AuthData,
+     * наш явный ключ останется; application_key добавится как обычно.
+     */
+    private _sendClientStatsWith;
+    /**
+     * Бекенд присылает 200 в любой ситуации, нужно читать тело.
+     * В теле есть ошибки если есть проблемы со статой.
+     */
+    private _sendClientStats;
+    logClientStats(items: ClientStats[]): Promise<void>;
+    logClientStatsWith(sessionKey: string, items: ClientStats[]): Promise<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, waitForAdmin, closedConversation, }?: {
@@ -56,7 +80,7 @@ export default class Api extends BaseApi {
     getConversationParams(conversationId?: string): Promise<ConversationParams>;
     getUserId(): OkUserId | null;
     setUserId(userId: OkUserId): void;
-    hangupConversation(conversationId: string, reason?: HangupType): void;
+    hangupConversation(conversationId: string, reason?: HangupType, params?: Partial<IHangupParams>): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     cleanup(): void;
     getServerTime(): Promise<number>;

package/default/ApiExternal.d.ts

@@ -1,3 +1,4 @@
+import { IHangupParams } from '../types/Api';
 import { IAPIBaseUrl, IApiEnv } from '../types/Params';
 export declare class ApiExternal {
     private readonly _uuid;
@@ -8,5 +9,5 @@ export declare class ApiExternal {
     private _sessionKey;
     constructor(apiEvn: IApiEnv, apiKey: string, callToken: string, baseApiUrl?: IAPIBaseUrl);
     authorize(): Promise<boolean>;
-    hangupConversation(conversationId: string): Promise<void>;
+    hangupConversation(conversationId: string, params?: Partial<IHangupParams>): Promise<void>;
 }

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 StatEventCollector from '../classes/stat/StatEventCollector';
 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;
@@ -56,26 +56,22 @@ export default class Signaling extends BaseSignaling {
     private static get WAIT_CONNECTION_DELAY();
     private static get WAIT_RESPONSE_DELAY();
     get ready(): boolean;
-    constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
+    constructor(debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
     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;
+    resetProducerConnection(cause?: Error): 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 +134,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 +166,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/SessionError.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Коды ошибок сессии API
+ */
+declare enum SessionError {
+    PARAM_SESSION_EXPIRED = 102,
+    PARAM_SESSION_KEY = 103,
+    PARAM_SIGNATURE = 104,
+    AUTH_LOGIN = 401
+}
+/**
+ * Ошибки, после которых имеет смысл переавторизоваться: сессия протухла или
+ * подпись не сошлась. 401 сюда не входит — там протух токен хоста.
+ */
+export declare function isSessionErrorCode(code: unknown): boolean;
+export default SessionError;

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.dd6d67c5.0",
+  "version": "2.8.12-dev.dd833275.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -14,7 +14,7 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/calls-audio-effects": "1.2.8",
+    "@vkontakte/calls-audio-effects": "1.4.1",
     "@vkontakte/calls-video-effects": "2.2.3-beta.7",
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",
@@ -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/ApiTransport.d.ts

@@ -1,5 +1,9 @@
 import { IAPIBaseUrl, IApiEnv } from '../types/Params';
 export declare function resetApiEndpoint(): void;
+/**
+ * Убираем слэш на конце
+ */
+export declare function sanitizeApiBaseUrl(url: IAPIBaseUrl): IAPIBaseUrl;
 export declare function _resolveApiEndpoint(apiBaseUrl?: IAPIBaseUrl, apiEnv?: IApiEnv): Promise<string>;
 export declare function sendBeakon(method: string, params?: {
     [key: string]: any;
@@ -7,4 +11,7 @@ export declare function sendBeakon(method: string, params?: {
 export declare function request(method: string, params?: {
     [key: string]: any;
 }, noSession?: boolean, customEndpoint?: string): Promise<any>;
+export declare function requestKeepalive(method: string, params?: {
+    [key: string]: any;
+}, noSession?: boolean): Promise<any>;
 export declare function sendFormData(url: string, data: FormData): Promise<void>;

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

package/static/Params.d.ts

@@ -1,5 +1,5 @@
 import type { VideoEffects } from '@vkontakte/calls-video-effects';
-import type { EffectVoiceChange } from '@vkontakte/calls-audio-effects';
+import type { EffectVoiceChange, VadControllerOptions, VadLib } from '@vkontakte/calls-audio-effects';
 import type * as Vmoji from '@vkontakte/calls-vmoji';
 import { IAsrData } from '../types/Asr';
 import { ConversationData } from '../types/Conversation';
@@ -37,6 +37,18 @@ export type ParamsObject = {
     platform: string;
     /** @hidden */
     clientStatsPlatform: string;
+    /**
+     * Автоматически запускать отправку клиентской статистики при `init()`.
+     *
+     * Если `false`, события звонков продолжают копиться в IndexedDB, но в сеть
+     * не уходят, пока хост не вызовет `startStats()`. Так хост может прогреть
+     * приложение, не нагружая сеть. До старта неактивен и fallback прямой
+     * отправки при недоступном хранилище. Если `startStats()` не вызвать
+     * никогда, очередь дорастёт до лимита и начнёт вытеснять старые звонки.
+     *
+     * _По умолчанию: `true`_
+     */
+    autoStartStats: boolean;
     /** @hidden */
     clientType: string;
     /** @hidden */
@@ -193,6 +205,14 @@ export type ParamsObject = {
      * Можно установить позднее методом `setAudioEffects`
      */
     audioEffects: EffectVoiceChange | null;
+    /**
+     * Namespace библиотеки VAD из `@vkontakte/calls-audio-effects`.
+     *
+     * Можно установить методом `setVad`
+     */
+    vad: VadLib | null;
+    /** Настройки VAD (threshold, hangoverMs, enabled) */
+    vadOptions: VadControllerOptions;
     /**
      * Максимальная ширина видео в пикселях для видео эффекта
      *
@@ -505,6 +525,16 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableSessionStateUpdates: boolean;
+    /**
+     * Использовать `<audio>` вместо `<video>` для воспроизведения звука в desktop Safari
+     * @hidden
+     */
+    safariAudioElement: boolean;
+    /**
+     * Отправлять пустой ICE candidate (end-of-candidates) удалённому пиру
+     * @hidden
+     */
+    forwardEmptyIceCandidate: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -892,7 +922,7 @@ export type ParamsObject = {
     /**
      * Собеседник подключился к сигналлингу
      */
-    onPeerRegistered?: (conversationId?: string) => void;
+    onPeerRegistered?: (conversationId?: string, externalIds?: ExternalId[]) => void;
 };
 export default abstract class Params {
     private static _params;
@@ -910,6 +940,7 @@ export default abstract class Params {
     static set platform(value: string);
     static get clientStatsPlatform(): string;
     static set clientStatsPlatform(value: string);
+    static get autoStartStats(): boolean;
     static get clientType(): string;
     static set clientType(value: string);
     static get externalUserType(): string;
@@ -960,6 +991,10 @@ export default abstract class Params {
     static get displaySurface(): DisplayCaptureSurfaceType;
     static get audioEffects(): EffectVoiceChange | null;
     static set audioEffects(value: EffectVoiceChange | null);
+    static get vad(): VadLib | null;
+    static set vad(value: VadLib | null);
+    static get vadOptions(): VadControllerOptions;
+    static set vadOptions(value: VadControllerOptions);
     static get videoEffects(): VideoEffects | null;
     static set videoEffects(value: VideoEffects | null);
     static get videoEffectMaxWidth(): number;
@@ -1027,6 +1062,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;
@@ -1056,6 +1093,7 @@ export default abstract class Params {
         movieShare: boolean;
         clientType: string;
         clientStatsPlatform: string;
+        autoStartStats: boolean;
         consumerScreenDataChannelPacketSize: number;
         switchVideoAtBadNetwork: boolean;
         simulcast: boolean;
@@ -1063,5 +1101,7 @@ export default abstract class Params {
         waitForRecordResponse: boolean;
         transparentAudio: boolean;
         enableSessionStateUpdates: boolean;
+        safariAudioElement: boolean;
+        forwardEmptyIceCandidate: boolean;
     };
 }

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -11,6 +11,7 @@ declare namespace ParticipantConnectionStatusUtils {
     function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
     function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState, sessionStateConnectedBySpeaker?: boolean): StatusTransition;
     function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
+    function setStalled(status: ParticipantConnectionStatus, stalled: boolean): StatusTransition;
     function setSessionStateApplicable(status: ParticipantConnectionStatus, applicable: boolean): StatusTransition;
 }
 export default ParticipantConnectionStatusUtils;

package/static/Sdp.d.ts

@@ -0,0 +1,3 @@
+export declare const SDP_LINE_ENDING = "\r\n";
+export declare function splitSdpLines(sdp: string): string[];
+export declare function joinSdpLines(lines: string[]): string;

package/static/SessionStore.d.ts

@@ -0,0 +1,38 @@
+export type StoredSession = {
+    sessionKey: string;
+    /** Ключ окружения на момент сохранения, см. currentEndpoint(). */
+    endpoint: string;
+    savedAt: number;
+};
+/**
+ * Снимки сессий по uid на диске. В памяти сессия текущего пользователя —
+ * AuthData; здесь — то, что SDK видел раньше.
+ *
+ * Это снимок: он может быть протухшим, переавторизовать его извне нельзя.
+ * Годится только для отложенных best-effort задач (например, досылка
+ * статистики). Живые запросы звонка им подписывать нельзя.
+ *
+ * Хранится только session_key: секрет сессии транспорту не нужен, а токен
+ * хоста незачем — протухший снимок не переавторизуется, а выбрасывается.
+ */
+export default abstract class SessionStore {
+    static remember(uid: number, session: {
+        sessionKey: string;
+        endpoint: string;
+    }): void;
+    static get(uid: number): StoredSession | null;
+    static forget(uid: number): void;
+    /** Удаляет записи старше MAX_AGE_MS. */
+    static prune(now?: number): void;
+    /**
+     * Ключ окружения: сессия прода не должна улететь на тестовый кластер.
+     * Синхронный, в отличие от резолва endpoint в транспорте.
+     *
+     * Адрес нормализуется так же, как в транспорте: иначе снимок, сделанный
+     * при apiBaseUrl со слэшем на конце, не совпал бы сам с собой.
+     */
+    static currentEndpoint(): string;
+    private static _read;
+    private static _write;
+    private static _isValid;
+}

package/static/SignalingCapabilities.d.ts

@@ -1,5 +1,5 @@
 /**
- * @see https://confluence.vk.team/display/VIDEOOK/Websocket+Capability+Flags
+ * @see https://confluence.vk.team/display/CALLS/Websocket+Capability+Flags
  */
 declare const PREDICATES: {
     readonly producerScreenTrack: () => boolean;

package/static/SimulcastInfo.d.ts

@@ -6,8 +6,10 @@ export declare const SIMULCAST_DEFAULT: {
     BITRATE: number;
 };
 export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
-export declare const MAP_RID_TO_SCALE_RESOLUTION_DOWN_BY: Record<string, number>;
 export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
 export declare function findBitrateAsc(maxDimension: number, bitrates: VideoBitrateSettings[]): number;
-export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[]): ISimulcastInfo;
-export declare function findScaleResolutionDownBy(rid?: string): number;
+export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[], fps?: number): {
+    streams: import("../types/SimulcastInfo").SimulcastStreamInfo[];
+};
+export declare function findScaleResolutionDownBy(rid: string | undefined, simulcastInfo: ISimulcastInfo): number;
+export declare function applySimulcastInfoToEncodings(encodings: RTCRtpEncodingParameters[], simulcastInfo: ISimulcastInfo, maxDimension?: number, maxBitrate?: number): void;

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<{
@@ -77,6 +77,5 @@ declare namespace Utils {
     function objectReduce<R, T extends object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
     const setImmediate: (fn: VoidFunction) => VoidFunction;
     function isObject(obj: unknown): obj is object;
-    function patchSimulcastAnswerSdp(sdp: string, trans: RTCRtpTransceiver, width: number, height: number): string;
 }
 export default Utils;

package/static/WebRTCUtils.d.ts

@@ -2,7 +2,7 @@
  * Вспомогательный плагин для работы с WebRTC
  */
 import { IVideoDimentions } from '../types/MediaSettings';
-import type StatsLogger from '../classes/StatsLogger';
+import type StatEventCollector from '../classes/stat/StatEventCollector';
 import { type DebugLogger } from './Debug';
 /**
  * Тип камеры мобильного устройства
@@ -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 {
     /**
      * До вызова этого метода бесполезно опрашивать другие публичные методы.
@@ -85,24 +85,24 @@ declare namespace WebRTCUtils {
      * @param needAudio Нужно ли аудио
      * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
      */
-    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
      */
-    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает камеру пользователя
      *
      * @param deviceId ID устройства
      * @param resolution Размеры видео
      */
-    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает микрофон пользователя
      *
      * @param deviceId ID устройства
      */
-    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Устанавливает размер видео в стриме
      *
@@ -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/Api.d.ts

@@ -0,0 +1,9 @@
+import HangupType from '../enums/HangupType';
+export interface IHangupParams {
+    conversationId: string;
+    reason: HangupType;
+    anonymToken?: string;
+    peerId?: string;
+    application_key?: string;
+    session_key?: string;
+}

package/types/Capabilities.d.ts

@@ -18,6 +18,7 @@ export type TCapabilities = {
     fastScreenShare: boolean;
     videoSuspend: boolean;
     simulcast: boolean;
+    simulcastNativeOrder: boolean;
     consumerFastScreenShare: boolean;
     consumerFastScreenShareQualityOnDemand: boolean;
     transparentAudio: boolean;

package/types/ExternalId.d.ts

@@ -1,5 +1,4 @@
 import MediaOption from '../enums/MediaOption';
-import UserType from '../enums/UserType';
 import UserRole from '../enums/UserRole';
 import { ParticipantStatus } from '../static/External';
 import MediaSettings from './MediaSettings';
@@ -20,7 +19,7 @@ export declare namespace ExternalIdUtils {
     function fromIds(ids: ExternalUserId[] | ExternalId[]): ExternalId[];
     function fromId(id: ExternalUserId, type?: ExternalIdType, deviceIdx?: number): ExternalParticipantId;
     function fromSignalingParticipant(participant: SignalingMessage.Participant, useDecorative?: boolean, fallbackToNonDecorative?: boolean): ExternalParticipantId | undefined;
-    function fromSignaling(signalingId: SignalingMessage.ExternalId, deviceIdx?: number, idType?: UserType): ExternalParticipantId;
+    function fromSignaling(signalingId: SignalingMessage.ExternalId, deviceIdx?: number): ExternalParticipantId;
     function toSignaling(externalId: ExternalId): string;
     function toString(externalId: ExternalId): ExternalIdString;
     function fromIdToString(id: ExternalUserId, type?: ExternalIdType, deviceIdx?: number): ExternalIdString;