@vkontakte/calls-sdk 2.8.13-dev.7195a780.0 → 2.8.13-dev.7452edd3.0

package/classes/stat/StatQueue.d.ts

@@ -0,0 +1,119 @@
+/** Потолок хранения событий: и очереди на диске, и буфера в памяти вкладки. */
+export declare const RECORD_LIMIT = 5000;
+/** Срок жизни события в очереди. */
+export declare const MAX_AGE_MS: number;
+/** Произвольный набор полей события: скаляры и списки строк. */
+export type StatPayload = Record<string, string | string[] | number | boolean | null>;
+/** Запись очереди без сгенерированного ключа. */
+export type StatQueueEntry = {
+    /** userId владельца события. Не может быть неизвестным. */
+    uid: number;
+    /** conversationId. null — событие залогировано до старта звонка. */
+    vcid: string | null;
+    /** Время записи в device-time, без коррекции по серверу. */
+    ts: number;
+    /** Поправка к серверному времени на момент записи. null — ещё не знали. */
+    delta?: number | null;
+    ev: StatPayload;
+};
+/** Запись очереди, прочитанная из хранилища. */
+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.
+ *
+ * База одна на origin, поэтому класс статический. Ошибки хранилища только
+ * логируются: статистика не влияет на звонок.
+ */
+export default abstract class StatQueue {
+    private static _db;
+    private static _dbPromise;
+    /** Имя базы. Подменяется только тестами, см. __resetForTests(). */
+    private static _dbName;
+    private static _supported;
+    private static _appendsSinceEvictCheck;
+    /** Момент последней неудачи открытия; до конца кулдауна не пробуем снова. */
+    private static _lastOpenFailureAt;
+    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 перечисленным записям, у которых её ещё нет.
+     *
+     * Ключи перечисляются явно: между своими в очередь могли лечь чужие записи,
+     * писанные другими часами.
+     */
+    static fillDelta(ids: number[], delta: number): Promise<void>;
+    static count(): Promise<number>;
+    /**
+     * Читает самые старые события пользователя. Индекс by_uid отдаёт их в
+     * порядке автоинкрементного id, то есть в порядке записи.
+     */
+    static readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
+    static remove(ids: number[]): Promise<void>;
+    /** Уникальные uid, у которых есть записи. Курсор по индексу by_uid с nextunique. */
+    static listUids(): Promise<number[]>;
+    /**
+     * Приводит размер хранилища к лимиту, вынося самые старые звонки целиком:
+     * частично удалённый звонок — это неполная цепочка событий. Записи без
+     * vcid одной группой не считаются, иначе эвикшн вынес бы pre-call события
+     * сразу всех звонков.
+     */
+    static evictToLimit(limit: number): Promise<void>;
+    /** Удаляет события старше указанного возраста. */
+    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;
+    /**
+     * Удаляет все события звонка одной транзакцией.
+     */
+    private static _deleteConversation;
+}

package/classes/stat/StatSignalingCommands.d.ts

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

package/classes/transport/DirectTransport.d.ts

@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
 import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import { MediaSource } from '../MediaSource';
 import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
 import { StatAggregator } from '../stat/StatAggregator';
@@ -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;
@@ -39,11 +43,14 @@ export default class DirectTransport extends BaseTransport {
     private _lastBadConnection;
     private _perfStatReporter;
     private _directStatReporter;
+    private readonly _sdpStats;
+    private readonly _peerConnectionStats;
+    private readonly _networkAdaptationStats;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _codecStatsAggregator;
-    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
+    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     get participantId(): ParticipantId;
     updateStatisticsInterval(): void;
     private _isDeadConnection;
@@ -72,6 +79,10 @@ export default class DirectTransport extends BaseTransport {
     private _markConnected;
     private _onConnectionStateChange;
     private _startReconnection;
+    /**
+     * Запрашивает у сигналинга переход на серверную топологию.
+     * Обычно это делает только мастер, `fromAnySide` снимает это ограничение.
+     */
     private _requestTopologySwitch;
     private _stopReconnection;
     private _startIceRestart;

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

@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
 import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import { MediaSource } from '../MediaSource';
 import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
 import { StatAggregator } from '../stat/StatAggregator';
@@ -45,9 +45,11 @@ export default class ServerTransport extends BaseTransport {
     private readonly _debug;
     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?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
+    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
     close(error?: Error): void;
@@ -81,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/classes/transport/SimulcastSender.d.ts

@@ -2,7 +2,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
 import { type DebugLogger } from '../../static/Debug';
 import type VideoSettings from '../../types/VideoSettings';
 import { MediaSource } from '../MediaSource';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 export default class SimulcastSender {
     private _pc;
     private _transceiver;
@@ -12,7 +12,7 @@ export default class SimulcastSender {
     private readonly _getCameraSettings;
     private readonly _debug;
     private readonly _logger;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
     configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
     finalizeAnswer(sdp: string): string;
     sync({ force }?: {

package/classes/transport/Transport.d.ts

@@ -6,7 +6,7 @@ import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
 import EventEmitter from '../EventEmitter';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import { MediaSource } from '../MediaSource';
 import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
 import { StatAggregator } from '../stat/StatAggregator';
@@ -51,7 +51,7 @@ export declare class Transport extends EventEmitter {
     private readonly _onFirstMediaSent;
     private _firstMediaSentProbeStopped;
     private _vadController;
-    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
+    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
     allocate(participantId: ParticipantId, isMaster?: boolean): void;

package/default/Api.d.ts

@@ -5,23 +5,35 @@ 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 { OkUserId, ParticipantId } from '../types/Participant';
 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;
+    userId(participantId: ParticipantId): ExternalParticipantId | null;
     authorize(): Promise<void>;
+    /** Запрос auth.anonymLogin без побочных эффектов. Пустой токен — версия 2. */
+    private _anonymLogin;
     private _getAnonymLoginCacheKey;
     private _getCachedAnonymLogin;
     private _setCachedAnonymLogin;
     private _removeCachedAnonymLogin;
     private _reauthorize;
     private _applyAnonymLogin;
+    /** Кладёт в кеш id соответствие своего участника из auth.anonymLogin */
+    private _cacheSelfExternalId;
+    private _buildClientStatsData;
+    /** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
+    private _reportClientStatsItemErrors;
+    /** noSession = true, иначе _prepareQuery перебил бы явный session_key. */
+    private _sendClientStatsWith;
+    /** Бекенд отвечает 200 всегда: ошибки статистики лежат в теле. */
     private _sendClientStats;
-    logClientStats(items: ClientStats[]): void;
+    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, }?: {
@@ -47,14 +59,12 @@ export default class Api extends BaseApi {
     }>;
     getAnonymTokenByLink(joinLink: string, username?: string): Promise<string>;
     joinConversationByLink(joinLink: string, isVideo?: boolean, observedIds?: ExternalUserId[], payload?: string): Promise<ConversationResponse>;
-    getCachedOkIdByExternalId(externalId: ExternalId): ParticipantId | null;
-    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
-    getCachedExternalIdByOkId(okId: OkUserId): ExternalParticipantId | null;
-    cacheExternalId(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
-    mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    getDecorativeIdByInitialId(initialId: OkUserId | CompositeUserId | ParticipantId): OkUserId | undefined;
-    replaceByInitialIdIdIfExists(id: OkUserId | CompositeUserId | ParticipantId): OkUserId;
+    getCachedParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    getCachedExternalIdByParticipantId(participantId: ParticipantId): ExternalParticipantId | null;
+    cacheExternalId(participantId: ParticipantId, externalId: ExternalParticipantId): void;
+    mapDecorativeId(decorativeId: ParticipantId, initialId: ParticipantId): void;
+    unmapDecorativeId(initialId: ParticipantId): void;
+    getDecorativeIdByInitialId(initialId: ParticipantId): ParticipantId | undefined;
     getConversationParams(conversationId?: string): Promise<ConversationParams>;
     getUserId(): OkUserId | null;
     setUserId(userId: OkUserId): void;

package/default/Signaling.d.ts

@@ -4,7 +4,7 @@ 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 StatsLogger from '../classes/StatsLogger';
+import StatEventCollector from '../classes/stat/StatEventCollector';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
@@ -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;
@@ -56,7 +58,7 @@ 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;
@@ -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/SessionError.d.ts

@@ -0,0 +1,10 @@
+/** Коды ошибок сессии 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,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,28 @@ 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",
+    SDP_SET_LOCAL_PRANSWER = "sdp_set_local_pranswer",
+    SDP_SET_LOCAL_ANSWER = "sdp_set_local_answer",
+    SDP_SET_LOCAL_ROLLBACK = "sdp_set_local_rollback",
+    SDP_SET_REMOTE_OFFER = "sdp_set_remote_offer",
+    SDP_SET_REMOTE_PRANSWER = "sdp_set_remote_pranswer",
+    SDP_SET_REMOTE_ANSWER = "sdp_set_remote_answer",
+    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.7195a780.0",
+  "version": "2.8.13-dev.7452edd3.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

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;

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;