@vkontakte/calls-sdk 2.8.13-dev.10d918e8.0 → 2.8.13-dev.1736275e.0

package/classes/stat/StatDrainScheduler.d.ts

@@ -9,26 +9,27 @@ export default abstract class StatDrainScheduler {
     private static _state;
     private static _timer;
     private static _localCount;
-    /** Звонок завершился, пока шёл дрейн: его хвост не должен ждать таймаут тишины. */
+    /** Звонок закончился во время отправки: его события уйдут через секунду после неё, а не через 30 с тишины. */
     private static _callFinishedDuringDrain;
     private static _blockedSession;
     /** Буфер прямой отправки: события, которые не легли в хранилище. */
     private static _directBuffer;
     private static _directTimer;
+    private static _tailRecheckTimer;
     static setApi(value: BaseApi): void;
-    /** Первый дрейн подбирает хвосты прошлых сессий и закрытых вкладок. */
+    /** Первая отправка: забирает события, не ушедшие в прошлые запуски, и хвосты звонков закрытых вкладок. */
     static start(value: BaseApi): void;
     /** Вызывается коллектором после записи события в очередь. */
     static notifyAppended(): void;
     /**
-     * Звонок закончился: хвост уходит через секунду, а не через полминуты
-     * тишины. Секунда нужна, чтобы дописались все события финиша.
+     * Звонок закончился: его события уходят через секунду, а не через 30 с
+     * тишины. Секунда нужна, чтобы успели записаться все события конца звонка.
      */
     static notifyCallFinished(): void;
     /**
-     * Один цикл отправки по всем владельцам очереди: текущий — живой сессией,
-     * остальные — сохранённым session_key. Хвост uid X уходит только под
-     * сессией uid X.
+     * Один проход отправки по всем пользователям в очереди: текущий — через
+     * живую сессию, остальные — через сохранённый session_key. События
+     * пользователя X уходят только под сессией X.
      *
      * @returns true, если у кого-то был полный батч и имеет смысл повторить.
      */
@@ -41,12 +42,32 @@ export default abstract class StatDrainScheduler {
      */
     static sendDirect(entry: StatQueueEntry): void;
     private static _currentUserId;
+    private static _firstDrain;
+    /**
+     * Удаляет журналы закрытия вкладки из бет 2.8.13-beta.2…beta.11: читать
+     * их больше некому, а ключи остались бы в localStorage навсегда.
+     *
+     * TODO: удалить через пару релизов после 2.8.13.
+     */
+    private static _removeUnloadJournals;
+    /**
+     * Переносит в очередь хвосты звонков, вкладок которых больше нет:
+     * свободный замок звонка значит, что вкладку закрыли или убили. Если
+     * вкладка жива, проверяем снова через TAIL_RECHECK_DELAY_MS. Иначе
+     * вкладка, которой самой нечего отправлять, забрала бы хвост только при
+     * следующей своей отправке. Вызывается под замком отправки, не бросает.
+     *
+     * @returns число перенесённых хвостов.
+     */
+    private static _adoptCallTails;
+    private static _armTailRecheck;
+    private static _clearTailRecheckTimer;
     /** @returns число записей в батче. */
     private static _drainCurrent;
     /**
-     * Хвост другого пользователя под его сохранённым session_key: одна попытка,
-     * без перелогина. Недоставленное не удаляем — владелец может авторизоваться
-     * в этой вкладке.
+     * События другого пользователя уходят под его сохранённым session_key:
+     * одна попытка, без перелогина. Неотправленное не удаляем, пользователь
+     * может снова войти в этой вкладке.
      *
      * @returns число записей в батче.
      */
@@ -67,13 +88,13 @@ export default abstract class StatDrainScheduler {
     private static _isSessionError;
     /**
      * Транспорт не смог переавторизоваться, чаще всего из-за протухшего
-     * authToken хоста. Хвост не удаляем: он уедет после новой сессии.
+     * authToken хоста. События не удаляем: уйдут после новой сессии.
      */
     private static _isReauthorizeFailure;
     /**
      * Останавливает отправку за текущего пользователя до смены session_key:
-     * другой ключ означает, что авторизация прошла заново. Чужие хвосты не
-     * трогает.
+     * другой ключ означает, что авторизация прошла заново. События других
+     * пользователей не трогает.
      */
     private static _blockSession;
     private static _isSessionBlocked;

package/classes/stat/StatEventCollector.d.ts

@@ -2,7 +2,8 @@ import BaseApi from '../../abstract/BaseApi';
 import BaseLogger from '../../abstract/BaseLogger';
 import StatLog from '../../enums/StatLog';
 import TransportTopology from '../../enums/TransportTopology';
-type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
+import { StatQueueEntry } from './StatQueue';
+export type ClientStatsPayload = Record<string, string | string[] | number | boolean | undefined | null>;
 export type LogClientStatsOptions = {
     /** Время наступления события. По умолчанию — момент записи. */
     occurredAt?: number;
@@ -23,28 +24,24 @@ export default class StatEventCollector extends BaseLogger {
     private static _pendingOverflow;
     private static _remember;
     private static _takePending;
+    /** Вкладка закрывается (pagehide): в очередь больше не пишем. */
+    unloading: boolean;
     private readonly _externalLogger;
     private readonly _conversationIdProvider;
     private readonly _topologyProvider;
-    private _unloadMode;
     /** Старая схема: не null, когда ручка выключена, тогда очередь не используется. */
     private readonly _legacy;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
     log(name: StatLog, value?: string, immediately?: boolean): void;
+    logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
     /**
-     * Переключает коллектор на синхронный localStorage-журнал: асинхронная
-     * запись в IndexedDB не переживает pagehide.
-     */
-    enterUnloadMode(): void;
-    /**
-     * Вкладка пережила pagehide (bfcache, отменённая навигация): возвращаемся
-     * на очередь и переносим в неё уже записанное в журнал.
+     * Собирает запись очереди, никуда её не записывая и не вызывая onClientStats.
+     * null — старая схема, uid неизвестен или в памяти ждут события без uid.
      */
-    exitUnloadMode(): void;
-    logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
+    buildEntry(data: ClientStatsPayload, options?: LogClientStatsOptions): StatQueueEntry | null;
     destroy(): void;
+    private _makeEntry;
     private _store;
     private _getConversationId;
     private _getCallTopology;
 }
-export {};

package/classes/stat/StatPings.d.ts

@@ -1,5 +1,5 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import StatEventCollector from './StatEventCollector';
+import StatEventCollector, { ClientStatsPayload } from './StatEventCollector';
 export declare class StatPings {
     private readonly _logger;
     private trackerByTransport;
@@ -12,5 +12,9 @@ export declare class StatPings {
     mark(transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
     logMetrics(): void;
+    /** Сводки на текущий момент, без отправки и без сброса. */
+    summaries(): ClientStatsPayload[];
+    /** Сбрасываем baseline после скрытия страницы, чтобы фоновой простой не стал интервалом ping. */
+    resetBaseline(): void;
     destroy(): void;
 }

package/classes/stat/StatQueue.d.ts

@@ -2,8 +2,8 @@
 export declare const RECORD_LIMIT = 5000;
 /** Срок жизни события в очереди. */
 export declare const MAX_AGE_MS: number;
-/** Произвольный набор скалярных полей события. */
-export type StatPayload = Record<string, string | number | boolean | null>;
+/** Произвольный набор полей события: скаляры и списки строк. */
+export type StatPayload = Record<string, string | string[] | number | boolean | null>;
 /** Запись очереди без сгенерированного ключа. */
 export type StatQueueEntry = {
     /** userId владельца события. Не может быть неизвестным. */
@@ -21,6 +21,19 @@ export type StatQueueRecord = StatQueueEntry & {
     /** Автоинкремент. Единственный источник истины для порядка событий. */
     id: number;
 };
+/**
+ * Хвост идущего звонка: события, которые уйдут, если вкладка умрёт, не
+ * закончив звонок, — call_finish с причиной terminated и итоги звонка.
+ */
+export type StatTail = {
+    /** `<id вкладки>.<conversationId>` */
+    key: string;
+    uid: number;
+    vcid: string;
+    /** Время финиша в хвосте, device-time. */
+    ts: number;
+    entries: StatQueueEntry[];
+};
 /**
  * Персистентная очередь событий статистики поверх IndexedDB.
  *
@@ -39,6 +52,25 @@ export default abstract class StatQueue {
     static isSupported(): boolean;
     /** @returns ключ записи или null, если хранилище не приняло её. */
     static append(entry: StatQueueEntry): Promise<number | null>;
+    /** Создаёт или перезаписывает хвост звонка. @returns false — хранилище недоступно. */
+    static putTail(tail: StatTail): Promise<boolean>;
+    /**
+     * Обновляет хвост, только если он ещё лежит: пропавший хвост забрала
+     * другая вкладка, воскрешать его нельзя.
+     */
+    static updateTail(tail: StatTail): Promise<'updated' | 'missing' | 'failed'>;
+    /** Удаляет хвост. 'missing' — его уже забрала другая вкладка. */
+    static removeTail(key: string): Promise<'removed' | 'missing' | 'failed'>;
+    static listTailKeys(): Promise<string[]>;
+    /**
+     * Переносит хвост в очередь одной транзакцией. Если у звонка этого
+     * пользователя call_finish уже есть, хвост просто удаляется.
+     *
+     * @returns 'added' — события хвоста в очереди, 'exists' — финиш уже был,
+     * 'expired' — хвост старше MAX_AGE_MS и удалён, 'missing' — хвоста нет,
+     * 'failed' — хранилище недоступно.
+     */
+    static adoptTail(key: string): Promise<'added' | 'exists' | 'expired' | 'missing' | 'failed'>;
     /**
      * Проставляет delta перечисленным записям, у которых её ещё нет.
      *
@@ -66,10 +98,17 @@ export default abstract class StatQueue {
     static evictOlderThan(maxAgeMs: number, now?: number): Promise<void>;
     private static _checkSupport;
     private static _open;
+    /** Раз в EVICT_CHECK_EVERY записей подрезает хранилище до лимита. */
+    private static _countAppend;
     private static _close;
+    /** Создаёт недостающие таблицы: и новую базу, и базу версии 1 с событиями. */
     private static _createSchema;
-    /** Обёртка над транзакцией: резолвится после успешного коммита. */
+    /**
+     * Обёртка над транзакцией: резолвится после успешного коммита. body
+     * получает первую из таблиц и саму транзакцию — для остальных.
+     */
     private static _runTransaction;
+    private static _request;
     /** Читает запись с минимальным id, то есть самую старую в хранилище. */
     private static _readOldestRecord;
     /**

package/classes/stat/StatSignalingCommands.d.ts

@@ -1,5 +1,5 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import StatEventCollector from './StatEventCollector';
+import StatEventCollector, { ClientStatsPayload } from './StatEventCollector';
 export declare class StatSignalingCommands {
     private readonly _logger;
     private trackerByCommand;
@@ -7,5 +7,7 @@ export declare class StatSignalingCommands {
     mark(command: string, time: number, transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
     logMetrics(): void;
+    /** Сводки на текущий момент, без отправки и без сброса. */
+    summaries(): ClientStatsPayload[];
     destroy(): void;
 }

package/classes/transport/DirectTransport.d.ts

@@ -31,6 +31,10 @@ export default class DirectTransport extends BaseTransport {
     private _lastStat;
     private _fingerprint;
     private _neverConnected;
+    private _connectionStartedAt;
+    private _connectionLostAt;
+    /** Запросили переход на серверную топологию, не дождавшись первого подключения p2p */
+    private _serverRequestedOnNoConnection;
     private _serverSettings;
     private _prevConsumerSettings;
     private _networkLimitsForVideo;
@@ -40,6 +44,8 @@ export default class DirectTransport extends BaseTransport {
     private _perfStatReporter;
     private _directStatReporter;
     private readonly _sdpStats;
+    private readonly _peerConnectionStats;
+    private readonly _networkAdaptationStats;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;

package/classes/transport/PerfStatReporter.d.ts

@@ -8,8 +8,11 @@ export default class PerfStatReporter extends EventEmitter {
     private _previousPerfStatReportTimestamp;
     private _previousNetworkStatReportTimestamp;
     private _previousCallStatReportTimestamp;
-    private _previousCallStatReport;
+    private _previousCounters;
     private _previousRemoteInboundRtps;
+    private _previousInboundRtps;
+    private _previousOutboundRtps;
+    private _previousCandidatePair;
     private _screenShareStats;
     private _signaling;
     private readonly _directTopology;
@@ -22,7 +25,10 @@ export default class PerfStatReporter extends EventEmitter {
     private reportPerfStats;
     private reportNetworkStats;
     private _reportCallStats;
+    private _reportCandidatePair;
+    private _calculateRemotePacketLoss;
     private _calculatePacketLoss;
+    private _calculateOutboundDeltas;
     private _handleScreenSharingStat;
     private _handleTransportStateChanged;
 }

package/classes/transport/ServerTransport.d.ts

@@ -46,6 +46,7 @@ export default class ServerTransport extends BaseTransport {
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _sdpStats;
+    private readonly _peerConnectionStats;
     private readonly _codecStatsAggregator;
     private readonly _simulcast;
     constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
@@ -82,6 +83,8 @@ export default class ServerTransport extends BaseTransport {
     private _startSettingsInterval;
     private _stopSettingsInterval;
     private _collectStat;
+    /** mid потока быстрой шары, чтобы отделить его от камеры в статистике */
+    private _getScreenShareMid;
     private _reportStats;
     private _detectStaleTracks;
     private _allocateConsumer;

package/default/Api.d.ts

@@ -10,6 +10,7 @@ import PushData from '../types/PushData';
 export default class Api extends BaseApi {
     private _uuid;
     private _idCache;
+    constructor();
     private _callUnsafe;
     protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
     userId(participantId: ParticipantId): ExternalParticipantId | null;
@@ -22,6 +23,8 @@ export default class Api extends BaseApi {
     private _removeCachedAnonymLogin;
     private _reauthorize;
     private _applyAnonymLogin;
+    /** Кладёт в кеш id соответствие своего участника из auth.anonymLogin */
+    private _cacheSelfExternalId;
     private _buildClientStatsData;
     /** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
     private _reportClientStatsItemErrors;

package/default/Signaling.d.ts

@@ -42,6 +42,8 @@ export default class Signaling extends BaseSignaling {
     private connected;
     private listenersReady;
     private peerId;
+    /** Когда началась череда падений соединения, от неё считаем *_timeout */
+    private reconnectStartedAt;
     private connectionMessageWaitTimer;
     private participantIdRegistry;
     private producerNotificationDataChannel;
@@ -164,7 +166,8 @@ export default class Signaling extends BaseSignaling {
     private _handleCachedMessages;
     private _throwError;
     private _onError;
-    private _serializeErrorEvent;
+    /** Причина ошибки для статы: короткий читаемый текст */
+    private _describeErrorEvent;
     private _onClose;
     private _terminate;
     private _fail;
@@ -182,10 +185,15 @@ export default class Signaling extends BaseSignaling {
     private _onTransportConnecting;
     private _onTransportFailed;
     private _onTransportReconnectScheduled;
+    /** Попыток восстановить соединение больше не будет: отправляем, сколько длилась череда падений */
+    private _logReconnectTimeout;
     private _onTransportConnectionDead;
     private _attachNotificationCallError;
     private _createSignalingCallError;
     private _getSocketType;
     private _markTransportStat;
+    /** Событие уходит с переданными полями, без value — уходит без value */
     private _logTransportStat;
+    /** value — время от метки, поставленной в _markTransportStat; метки нет — событие не отправляем */
+    private _logTransportStatSinceMark;
 }

package/default/SignalingTransport.d.ts

@@ -4,6 +4,7 @@ import { DebugLogger } from '../static/Debug';
 export declare enum SignalingTransportFailure {
     EMPTY_ENDPOINT = "EMPTY_ENDPOINT",
     NETWORK_ERROR = "NETWORK_ERROR",
+    RECONNECT_TIMEOUT = "RECONNECT_TIMEOUT",
     ABORTED = "ABORTED"
 }
 export type SignalingTransportFailedEvent = {
@@ -40,6 +41,7 @@ export default class SignalingTransport {
     private connectionType;
     private reconnectCount;
     private reconnectTimer;
+    private reconnectDeadlineTimer;
     private doctorTimer;
     private forceWebSocket;
     private abortSignal;
@@ -54,7 +56,7 @@ export default class SignalingTransport {
     setPeerId(peerId: number | null): void;
     setLastStamp(lastStamp: number): void;
     setAbortSignal(signal?: AbortSignal): void;
-    resetReconnectCount(): void;
+    onConnectionRestored(): void;
     connect(connectionType: SignalingConnectionType): void;
     close(code?: number): void;
     send(data: string | ArrayBuffer): Promise<void>;
@@ -70,6 +72,8 @@ export default class SignalingTransport {
     private _onClose;
     private _disconnect;
     private _scheduleReconnect;
+    private _startReconnectDeadline;
+    private _stopReconnectDeadline;
     private _getReconnectDelay;
     private _startDoctor;
     private _stopDoctor;

package/enums/ActiveFeature.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Фичи, активные во время звонка. Уходят в метрику active_features,
+ * чтобы по ним разрезать остальную статистику: сколько фризов при включённой камере,
+ * какой битрейт при шаре и так далее.
+ *
+ * Здесь только то, что реально включено прямо сейчас, а не то, что разрешено настройками:
+ * иначе фича попадала бы в метрику у всех, кому ее просто не запретили.
+ *
+ * Сервер принимает только имена из своего списка, незнакомые отбрасывает с ошибкой.
+ * Новое имя добавляем сюда после того, как его добавят на сервере.
+ */
+declare enum ActiveFeature {
+    MICROPHONE = "MICROPHONE",
+    CAMERA = "CAMERA",
+    /** Любая шара экрана, в том числе быстрая */
+    SCREEN = "SCREEN",
+    ANIMOJI = "ANIMOJI"
+}
+export default ActiveFeature;

package/enums/Stat.d.ts

@@ -1,4 +1,7 @@
-declare const enum Stat {
+/**
+ * Имена событий статистики — поле `name` в данных `onClientStats`
+ */
+declare enum Stat {
     CALL_INIT = "call_init",
     CALL_START = "call_start",
     CALL_ACCEPTED_OUTGOING = "call_accepted_outgoing",
@@ -14,6 +17,14 @@ declare const enum Stat {
     USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
     SIGNALING_PING_SUMMARY = "signaling_ping_summary",
     SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
+    API_CALL = "api_call",
+    CONNECTION_STATE_CHANGED = "connection_state_changed",
+    SIGNALING_STATE_CHANGED = "signaling_state_changed",
+    GATHERING_STATE_CHANGED = "gathering_state_changed",
+    ICE_RESTART = "ice_restart",
+    ICE_CANDIDATES_CHANGED = "ice_candidates_changed",
+    ICE_CANDIDATE_GATHERING_FAILED = "ice_candidate_gathering_failed",
+    ICE_CANDIDATE_ADD_FAILED = "ice_candidate_add_failed",
     SDP_CREATE_OFFER = "sdp_create_offer",
     SDP_CREATE_ANSWER = "sdp_create_answer",
     SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
@@ -26,6 +37,8 @@ declare const enum Stat {
     SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
     SDP_GENERATED = "sdp_generated",
     SDP_RECEIVED = "sdp_received",
+    CLIENT_REQUESTED_SERVER_TOPOLOGY = "client_requested_server_topology",
+    VIDEO_ENCODER_CHANGED_BY_NETWORK_ADAPTER = "video_encoder_changed_by_network_adapter",
     WEBSOCKET_CONNECTED = "websocket_connected",
     WEBSOCKET_RECONNECTED = "websocket_reconnected",
     WEBSOCKET_FAILED_PINGS = "websocket_failed_pings",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.13-dev.10d918e8.0",
+  "version": "2.8.13-dev.1736275e.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,9 +1,16 @@
-import type { OkUserId } from '../types/Participant';
+import type { ExternalParticipantId } from '../types/ExternalId';
+import type { OkUserId, ParticipantId } from '../types/Participant';
+/** Свой участник и его внешний id */
+export type SelfExternalId = {
+    participantId: ParticipantId;
+    externalId: ExternalParticipantId;
+};
 export default abstract class AuthData {
     private static _sessionKey;
     private static _sessionSecretKey;
     private static _accessToken;
     private static _userId;
+    private static _selfExternalId;
     private static _reauthorizePromise;
     static get sessionKey(): string | undefined;
     static set sessionKey(value: string | undefined);
@@ -13,6 +20,9 @@ export default abstract class AuthData {
     static set accessToken(value: string | undefined);
     static get userId(): OkUserId | null;
     static set userId(value: OkUserId | null);
+    /** Свой участник и его внешний id из ответа auth.anonymLogin */
+    static get selfExternalId(): SelfExternalId | null;
+    static set selfExternalId(value: SelfExternalId | null);
     static isEmpty(): boolean;
     /**
      * Дедуплицирует одновременные попытки реавторизации из разных инстансов Api.

package/static/BrowserEnvironment.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Определение браузера, операционной системы и доступных возможностей.
+ */
+/**
+ * Известные браузеры
+ */
+export type BrowserName = 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
+declare namespace BrowserEnvironment {
+    /**
+     * Получение и кэширование версии операционной системы
+     */
+    function initOsVersion(warn: (...args: any[]) => void): Promise<void>;
+    /**
+     * Проверяет поддержку WebRTC браузером
+     */
+    function isBrowserSupported(): boolean;
+    /**
+     * Возвращает первую отсутствующую capability в стабильном порядке.
+     */
+    function getBrowserSupportFailure(): BrowserSupportFailure | null;
+    /**
+     * Проверяет поддержку шаринга экрана браузером
+     */
+    function isScreenCapturingSupported(): boolean;
+    /**
+     * Проверяет поддержку выбора микрофона браузером, независимо от списка устройств и разрешений.
+     * Доступен до init, не запрашивает разрешения и не захватывает медиа.
+     */
+    function canSelectAudioInput(): boolean;
+    /**
+     * Проверяет поддержку выбора аудиовыхода браузером, независимо от списка устройств и разрешений.
+     * Доступен до init, не запрашивает разрешения и не меняет аудиовыход.
+     */
+    function canSelectAudioOutput(): boolean;
+    /**
+     * В некоторых браузерах H264 decoder сломан
+     */
+    function isBrokenH264Decoder(): boolean;
+    /**
+     * В некоторых браузерах VP9 encoder сломан
+     */
+    function isBrokenVP9Encoder(): boolean;
+    /**
+     * В некоторых браузерах VP9 decoder сломан
+     */
+    function isBrokenVP9Decoder(): boolean;
+    /**
+     * Может ли браузер делать H264 приоритетным
+     */
+    function canPreferH264(): boolean;
+    /**
+     * Поддержка simulcast браузером.
+     * Safari корректно поддерживает simulcast начиная с версии 18.
+     * Firefox поддерживает simulcast с VP8 начиная с версии 134.
+     */
+    function isSimulcastSupportedByBrowser(): boolean;
+    /**
+     * Имя операционной системы
+     */
+    function os(): string;
+    /**
+     * Версия операционной системы
+     */
+    function osVersion(): number | null | undefined;
+    /**
+     * Мобильный браузер или нет
+     */
+    function isMobile(): boolean;
+    /**
+     * Имя браузера
+     */
+    function browserName(): BrowserName | string;
+    /**
+     * Версия браузера
+     */
+    function browserVersion(): string;
+    /**
+     * Если браузер основан на хроме - возвращает версию
+     */
+    function baseChromeVersion(): number;
+    /**
+     * Возвращает подверсию браузера (если она есть)
+     */
+    function browserSubVersion(): string;
+    /**
+     * Браузер поддерживает захват звука при трансляции экрана
+     */
+    function isAudioShareSupported(): boolean;
+}
+export default BrowserEnvironment;

package/static/External.d.ts

@@ -1,4 +1,5 @@
 import { IAsrData } from '../types/Asr';
+import { ClientStatsEvent } from '../types/ClientStatsEvent';
 import { ConversationData } from '../types/Conversation';
 import HangupReason from '../classes/HangupReason';
 import { MediaTrackKind } from '../classes/MediaSource';
@@ -513,6 +514,12 @@ declare namespace External {
      * @param memory Статистика памяти
      */
     function onStatistics(connection: StatResult, memory: Record<string, number>): void;
+    /**
+     * Событие статистики SDK
+     *
+     * @param data Данные события с `vcid` и `ts`
+     */
+    function onClientStats(data: ClientStatsEvent): void;
     /**
      * Ошибка воспроизведения звука
      */
@@ -628,6 +635,10 @@ declare namespace External {
      */
     function onParticipantIdChanged(prevId: ExternalParticipantId, newId: ExternalParticipantId, conversationId?: string): void;
     function onVideoSuspendSuggest(bandwidth: number, conversationId?: string): void;
+    /**
+     * Успешно применено первое подключение к сигналингу или переподключение.
+     */
+    function onSignalingConnected(conversationId: string): void;
     /**
      * Одобрено повышение пользователя в зеле ожидания/зале в режиме Audience
      *