@vkontakte/calls-sdk 2.8.13-dev.3b07b09d.0 → 2.8.13-dev.45510c4e.0

package/classes/AudioOutput.d.ts

@@ -8,7 +8,7 @@ import { StatFirstMediaReceived } from './stat/StatFirstMediaReceived';
 export default class AudioOutput {
     protected _audioElement: HTMLAudioElement | null;
     protected readonly _debug: DebugLogger;
-    private readonly _preparedAudioElement;
+    private _preparedAudioElement;
     private _audioTracks;
     private readonly _allowMultipleTracks;
     private _volume;

package/classes/MediaSource.d.ts

@@ -60,6 +60,8 @@ export declare class MediaSource extends EventEmitter {
     private readonly _logger;
     private _cameraTrackSetAt;
     private _cameraMuteRecoveredAt;
+    private _micTrackSetAt;
+    private _micMuteRecoveredAt;
     constructor(debug?: DebugLogger, logger?: StatEventCollector | null);
     get cameraVideoTrack(): MediaStreamTrack | null;
     set cameraVideoTrack(track: MediaStreamTrack | null);
@@ -83,6 +85,7 @@ export declare class MediaSource extends EventEmitter {
      * @hidden
      */
     setVideoStream(stream: MediaStream, isScreen: boolean): Promise<void>;
+    private _setMicAudioTrack;
     private _initDeviceChangeListener;
     private _destroyDeviceChangeListener;
     private _changeVideoInput;
@@ -109,6 +112,7 @@ export declare class MediaSource extends EventEmitter {
     toggleScreenCapturing(settings: ScreenCaptureSettings): Promise<void>;
     disableScreenCapturing(): Promise<void>;
     private videoTrackMuteHandler;
+    private micTrackMuteHandler;
     toggleVideo(enabled: boolean): Promise<void>;
     toggleAudio(enabled: boolean): Promise<void>;
     toggleAnimojiCapturing(enabled: boolean): void;

package/classes/VolumesDetector.d.ts

@@ -18,6 +18,5 @@ export declare class VolumesDetector extends EventEmitter {
     private _getTransparentAudioLevelByParticipantId;
     private _onSignalledActiveParticipants;
     private _onTopologyChanged;
-    private _isTransparentAudioMode;
     private _destroyDetectors;
 }

package/classes/conversation/Conversation.d.ts

@@ -66,6 +66,7 @@ export default class Conversation extends EventEmitter {
     private _reservedId;
     private readonly _onUnload;
     private readonly _onRestore;
+    private readonly _onVisibilityChange;
     private readonly _audioOutput;
     private readonly _stats;
     private _lastStalled;

package/classes/stat/ApiCallStats.d.ts

@@ -0,0 +1,12 @@
+import { StatAggregator } from './StatAggregator';
+/** Отправляет в стату время выполнения запросов к API */
+export declare class ApiCallStats {
+    private readonly _statAggregator;
+    constructor(statAggregator: StatAggregator | null);
+    /**
+     * @param method название метода API, например `vchat.getConversationParams`
+     * @param duration время от запроса до ответа, мс
+     * @param error описание ошибки, если запрос не удался
+     */
+    log(method: string, duration: number, error?: string): void;
+}

package/classes/stat/ConversationStats.d.ts

@@ -3,6 +3,7 @@ import BaseLogger from '../../abstract/BaseLogger';
 import TransportTopology from '../../enums/TransportTopology';
 import HangupReason from '../HangupReason';
 import StatEventCollector from './StatEventCollector';
+import { ApiCallStats } from './ApiCallStats';
 import { CallLifecycleStats } from './CallLifecycleStats';
 import { CodecStatsAggregator } from './CodecStatsAggregator';
 import { StatAggregator } from './StatAggregator';
@@ -15,23 +16,19 @@ export declare class ConversationStats {
     readonly codecStatsAggregator: CodecStatsAggregator;
     readonly pings: StatPings;
     readonly signalingCommands: StatSignalingCommands;
+    readonly apiCalls: ApiCallStats;
+    private readonly _api;
     private _unloading;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
     /**
-     * Вызывается из pagehide-обработчика: события финиша должны пережить смерть вкладки.
-     *
-     * Сводки пингов и команд сбрасываем здесь же: обычный путь делает это в
-     * flushCallMetrics(), а destroy() их только очищает. Если flushCallMetrics()
-     * уже отработал, трекеры пусты и повторной записи не будет.
+     * Вызывается из pagehide-обработчика: события финиша должны пережить смерть
+     * вкладки. Сводки пингов и команд сбрасываем здесь же — destroy() их только
+     * очищает.
      */
     prepareForUnload(): void;
-    /**
-     * Вкладка пережила pagehide: bfcache вернул документ живым.
-     *
-     * Возвращаем запись в очередь и переносим туда журнал — статистика этого
-     * звонка ещё может уехать в этой же сессии.
-     */
+    /** Вкладка пережила pagehide: возвращаем запись в очередь. */
     restoreAfterUnload(): void;
+    resetPingBaseline(): void;
     logHangup(reason: HangupReason): void;
     flushCallMetrics(): void;
     destroy(): void;

package/classes/stat/PeerConnectionStats.d.ts

@@ -0,0 +1,22 @@
+import { StatAggregator } from './StatAggregator';
+/** Стата жизненного цикла RTCPeerConnection */
+export declare class PeerConnectionStats {
+    private readonly _statAggregator;
+    private _pc;
+    private _lastSignalingStateChange;
+    private _lastGatheringStateChange;
+    private _lastConnectionState;
+    private readonly _handleConnectionStateChange;
+    private readonly _handleSignalingStateChange;
+    private readonly _handleGatheringStateChange;
+    private readonly _handleIceCandidateError;
+    constructor(statAggregator: StatAggregator | null);
+    observe(pc: RTCPeerConnection): void;
+    /** Вызывать перед закрытием соединения: отсюда уходят последнее состояние и closed */
+    stop(): void;
+    logIceRestart(): void;
+    logIceCandidateAddFailed(candidate: RTCIceCandidateInit, error: unknown): void;
+    private _sinceLastChange;
+    private _logConnectionState;
+    private _log;
+}

package/classes/stat/SdpStats.d.ts

@@ -0,0 +1,39 @@
+import { StatAggregator } from './StatAggregator';
+type SdpDescription = {
+    type: RTCSdpType;
+    sdp?: string;
+};
+/**
+ * Отправляет в стату согласование SDP: что сгенерировали, что получили от собеседника
+ * и на какой операции сломались.
+ */
+export declare class SdpStats {
+    private readonly _statAggregator;
+    private _pc;
+    private _gatheringStartedAt;
+    private _remoteSdpReceivedAt;
+    private readonly _handleGatheringStateChange;
+    constructor(statAggregator: StatAggregator | null);
+    /** Начинает следить за сбором кандидатов, предыдущее соединение перестает слушать */
+    observe(pc: RTCPeerConnection): void;
+    stop(): void;
+    /** Сгенерировали свой SDP */
+    logSdpGenerated(type: RTCSdpType): void;
+    /** Собрали свой ICE-кандидат */
+    logCandidateGenerated(candidate: RTCIceCandidate): void;
+    /** Получили SDP от собеседника */
+    logSdpReceived(type: RTCSdpType): void;
+    /** Получили ICE-кандидата от собеседника */
+    logCandidateReceived(candidate: RTCIceCandidateInit): void;
+    /** Не смогли сгенерировать SDP */
+    logCreateFailed(type: RTCSdpType, error: unknown): void;
+    /** Не смогли применить свой SDP */
+    logSetLocalFailed(sdp: SdpDescription, error: unknown): void;
+    /** Не смогли применить SDP собеседника */
+    logSetRemoteFailed(sdp: SdpDescription, error: unknown): void;
+    destroy(): void;
+    private _intervalSince;
+    private _logFailure;
+    private _log;
+}
+export {};

package/classes/stat/StatAggregator.d.ts

@@ -7,8 +7,15 @@ export declare class StatAggregator {
     private _lastCallStatContext;
     constructor(logger: StatEventCollector);
     logCallStat(params: ICallStatLog): void;
-    /** @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588 */
+    /**
+     * Событие уходит с теми полями, что переданы. Без value — уходит без value.
+     * @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588
+     */
     logEventualStat(params: IEventualStatLog): void;
+    /** value — время от метки с тем же именем, что у события. Метки нет — событие не отправляем. */
+    logEventualStatSinceMark(params: IEventualStatLog & {
+        value?: never;
+    }): void;
     destroy(): void;
     private _getCallStatContext;
     private _flushEventualStats;

package/classes/stat/StatClock.d.ts

@@ -1,12 +1,8 @@
 import BaseApi from '../../abstract/BaseApi';
 /**
- * Поправка часов устройства к серверному времени для статистики.
- *
- * delta = Date.now() - serverTime, меряется один раз за сессию. Запись
- * очереди несёт дельту, известную на момент записи: отправка может пройти
- * в другой сессии, когда часы уже уехали. Записи, сделанные до измерения,
- * получают его задним числом — но только свои: хвосты прошлых запусков
- * писались другими часами.
+ * Поправка часов устройства к серверному времени: delta = Date.now() -
+ * serverTime, меряется раз за сессию. Свои записи, сделанные до измерения,
+ * получают поправку задним числом.
  */
 export default abstract class StatClock {
     private static _api;
@@ -23,11 +19,8 @@ export default abstract class StatClock {
     /** Дельта для отправки: измеренная, иначе 0 — время устройства. */
     static get(): Promise<number>;
     /**
-     * Вызывается коллектором после записи события без дельты.
-     *
-     * Ключ приходит асинхронно, уже после append, поэтому измерение может
-     * закончиться раньше: тогда размечаем запись сразу, иначе она осталась
-     * бы без поправки навсегда.
+     * Вызывается коллектором после записи события без дельты. Ключ приходит
+     * после append, поэтому измерение могло закончиться раньше.
      */
     static noteAppended(id: number): void;
     private static _hasCredentials;

package/classes/stat/StatDrainScheduler.d.ts

@@ -1,68 +1,52 @@
 import BaseApi from '../../abstract/BaseApi';
 import { StatQueueEntry } from './StatQueue';
 /**
- * Отправитель очереди статистики: один на вкладку.
- *
- * Живёт от CallsSDK.init() и не завязан на активный звонок. Держит машину
- * состояний триггеров, забирает батч под Web Lock, отправляет и удаляет
- * отправленное.
+ * Отправитель очереди статистики: один на вкладку, живёт от CallsSDK.init()
+ * и не завязан на активный звонок.
  */
 export default abstract class StatDrainScheduler {
     private static _api;
     private static _state;
     private static _timer;
     private static _localCount;
+    /** Звонок завершился, пока шёл дрейн: его хвост не должен ждать таймаут тишины. */
+    private static _callFinishedDuringDrain;
     private static _blockedSession;
+    /** Буфер прямой отправки: события, которые не легли в хранилище. */
+    private static _directBuffer;
+    private static _directTimer;
     static setApi(value: BaseApi): void;
-    /**
-     * Запускает шедулер. Один дрейн на старте подбирает хвосты, оставленные
-     * прошлыми сессиями и закрытыми вкладками.
-     */
+    /** Первый дрейн подбирает хвосты прошлых сессий и закрытых вкладок. */
     static start(value: BaseApi): void;
     /** Вызывается коллектором после записи события в очередь. */
     static notifyAppended(): void;
     /**
-     * Звонок закончился: последние события уходят через секунду, а не через
-     * полминуты тишины.
-     *
-     * Секунда нужна, чтобы дописались все события финиша — запись в очередь
-     * асинхронная — и уехали одним запросом.
+     * Звонок закончился: хвост уходит через секунду, а не через полминуты
+     * тишины. Секунда нужна, чтобы дописались все события финиша.
      */
     static notifyCallFinished(): void;
     /**
-     * Один цикл отправки по всем пользователям очереди.
-     *
-     * Текущий пользователь — живой сессией из AuthData (переавторизацию при
-     * ошибке сессии делает транспорт). Остальные, а до авторизации это все, —
-     * сохранённым session_key из SessionStore. Хвост uid X уходит только
-     * под сессией uid X.
+     * Один цикл отправки по всем владельцам очереди: текущий — живой сессией,
+     * остальные — сохранённым session_key. Хвост uid X уходит только под
+     * сессией uid X.
      *
      * @returns true, если у кого-то был полный батч и имеет смысл повторить.
      */
     static drainOnce(): Promise<boolean>;
     /**
-     * FALLBACK: прямая отправка в обход очереди.
-     *
-     * Вызывается коллектором только когда событие не удалось положить в
-     * IndexedDB: SecurityError в cross-site iframe с заблокированным сторонним
-     * хранилищем, зависший open в Safari, переполненная квота. Событие уходит
-     * одним запросом без подтверждения и без повтора — это уровень доставки
-     * старого StatsLogger, а не гарантия очереди. Для пользователей с рабочим
-     * хранилищем этот путь не используется никогда.
+     * FALLBACK для событий, не попавших в хранилище: копятся в памяти и уходят
+     * пачкой, без подтверждения и повтора.
      *
-     * Событие чужого пользователя не отправляется: запрос уходит под текущей
-     * сессией, а очередь партиционирована по владельцу именно ради этого.
+     * Чужие события не отправляются: запрос уходит под текущей сессией.
      */
-    static sendDirect(entry: StatQueueEntry): Promise<void>;
+    static sendDirect(entry: StatQueueEntry): void;
     private static _currentUserId;
-    /** Живой путь текущего пользователя — прежняя логика drainOnce. @returns число записей в батче. */
+    /** @returns число записей в батче. */
     private static _drainCurrent;
     /**
-     * Хвост другого пользователя под его сохранённым session_key.
-     *
-     * Одна попытка, без перелогина. Недоставленный хвост не удаляется: этот
-     * пользователь может авторизоваться в текущей вкладке, и тогда хвост уйдёт
-     * живой сессией. Размер очереди держит evictToLimit.
+     * Хвост другого пользователя под его сохранённым session_key: одна попытка,
+     * без перелогина. Недоставленное не удаляем — владелец может авторизоваться
+     * в этой вкладке.
      *
      * @returns число записей в батче.
      */
@@ -70,43 +54,26 @@ export default abstract class StatDrainScheduler {
     /**
      * Взаимное исключение между вкладками одного origin.
      *
-     * IndexedDB коммитит транзакцию, как только опустеет очередь её запросов на
-     * текущем тике event loop, поэтому держать транзакцию открытой на время
-     * отправки невозможно: чтение и удаление обязаны быть разными транзакциями.
-     * Всё время запроса записи видны другим вкладкам, и без внешней блокировки
-     * соседняя вкладка отправила бы тот же батч повторно.
-     *
-     * Web Lock удерживается на всё время колбэка, включая сеть, и снимается
-     * браузером автоматически при закрытии или падении вкладки.
+     * Транзакцию IndexedDB нельзя держать открытой на время запроса, поэтому
+     * чтение и удаление разнесены, и без блокировки соседняя вкладка отправила
+     * бы тот же батч повторно.
      */
     private static _withLock;
     /**
-     * Ретраятся ошибки, в которых виновато не содержимое батча: сетевой сбой,
-     * таймаут, 5xx, троттлинг http-429 и ошибка сессии. Сессию транспорт чинит
-     * сам одной реавторизацией с повтором (Api._sendClientStats), но если и она
-     * не помогла, сырая ошибка {error_code} долетает сюда — авторизация может
-     * восстановиться позже, удалять из-за неё батч нельзя.
-     *
-     * Всё остальное считается непроходимым и приводит к удалению батча. Без этого
-     * одно событие, которое сервер отвергает всегда, залипило бы очередь навсегда:
-     * каждый тик читал бы тот же батч, получал ту же ошибку и ничего не удалял,
-     * пока эвикшн не начал бы выбрасывать свежие звонки.
+     * Ретраятся ошибки, в которых виновато не содержимое батча: сеть, 5xx,
+     * http-429, ошибка сессии. Остальное непроходимо и приводит к удалению
+     * батча, иначе одно всегда отвергаемое событие залипило бы очередь.
      */
     private static _isSessionError;
     /**
-     * Транспорт не смог переавторизоваться: authorize() бросил AUTH.
-     *
-     * Чаще всего это протухший authToken хоста: SDK зовёт External.onTokenExpired(),
-     * хост обновляет токен и авторизуется заново. Пока идёт это восстановление,
-     * отправлять нечем, но и удалять хвост нельзя — он уедет после новой сессии.
+     * Транспорт не смог переавторизоваться, чаще всего из-за протухшего
+     * authToken хоста. Хвост не удаляем: он уедет после новой сессии.
      */
     private static _isReauthorizeFailure;
     /**
-     * Останавливает отправку за текущего пользователя до смены session_key.
-     *
-     * Ключ пишется в момент отказа: любое его изменение означает, что
-     * авторизация прошла заново и пробовать снова есть смысл. Чужие хвосты
-     * блокировка не трогает — они уходят своими сохранёнными сессиями.
+     * Останавливает отправку за текущего пользователя до смены session_key:
+     * другой ключ означает, что авторизация прошла заново. Чужие хвосты не
+     * трогает.
      */
     private static _blockSession;
     private static _isSessionBlocked;
@@ -115,6 +82,10 @@ export default abstract class StatDrainScheduler {
     private static _isRetryable;
     /** @param delta текущая поправка — для записей, у которых своей нет. */
     private static _toClientStats;
+    private static _clearDirectTimer;
+    private static _armDirect;
+    /** Отправляет накопленный буфер прямой отправки одним запросом. */
+    private static _flushDirect;
     private static _clearTimer;
     private static _arm;
     private static _drain;

package/classes/stat/StatEventCollector.d.ts

@@ -14,16 +14,11 @@ export type LogClientStatsOptions = {
     deferUntilServerTime?: boolean;
 };
 /**
- * Собирает событие статистики и кладёт его в персистентную очередь.
- *
- * Инстанс на звонок: держит провайдеры conversationId и топологии и ссылку
- * на внешний логгер хоста. Отправкой занимается StatDrainScheduler.
+ * Собирает событие статистики и кладёт его в персистентную очередь. Инстанс на
+ * звонок, отправкой занимается StatDrainScheduler.
  */
 export default class StatEventCollector extends BaseLogger {
-    /**
-     * Общий на вкладку: uid может стать известен уже после того, как коллектор
-     * этого звонка умер, и события всё равно должны уехать.
-     */
+    /** Общий на вкладку: uid может стать известен уже после смерти коллектора. */
     private static _pending;
     private static _pendingOverflow;
     private static _remember;
@@ -32,27 +27,18 @@ export default class StatEventCollector extends BaseLogger {
     private readonly _conversationIdProvider;
     private readonly _topologyProvider;
     private _unloadMode;
-    /**
-     * Старая схема отправки. Не null, когда ручка выключена: тогда коллектор —
-     * просто обёртка над ней, очередь не используется вообще.
-     */
+    /** Старая схема: не null, когда ручка выключена, тогда очередь не используется. */
     private readonly _legacy;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
     log(name: StatLog, value?: string, immediately?: boolean): void;
     /**
-     * Переключает коллектор на синхронный localStorage-журнал.
-     *
-     * Вызывается из pagehide-обработчика: асинхронная запись в IndexedDB не
-     * переживает перезагрузку или навигацию, а журнал переносится в очередь
-     * при следующем старте SDK.
+     * Переключает коллектор на синхронный localStorage-журнал: асинхронная
+     * запись в IndexedDB не переживает pagehide.
      */
     enterUnloadMode(): void;
     /**
-     * Возвращает коллектор на очередь: вкладка пережила pagehide.
-     *
-     * bfcache отдаёт документ обратно живым, отменённая навигация — тоже.
-     * Писать дальше в журнал незачем, а то, что уже туда легло, переносится в
-     * очередь: иначе события финиша дождались бы только следующего старта SDK.
+     * Вкладка пережила pagehide (bfcache, отменённая навигация): возвращаемся
+     * на очередь и переносим в неё уже записанное в журнал.
      */
     exitUnloadMode(): void;
     logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;

package/classes/stat/StatPings.d.ts

@@ -12,5 +12,7 @@ export declare class StatPings {
     mark(transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
     logMetrics(): void;
+    /** Сбрасываем baseline после скрытия страницы, чтобы фоновой простой не стал интервалом ping. */
+    resetBaseline(): void;
     destroy(): void;
 }

package/classes/stat/StatQueue.d.ts

@@ -1,11 +1,6 @@
-/**
- * Потолок хранения событий: и очереди на диске, и буфера событий без владельца
- * в памяти вкладки.
- */
+/** Потолок хранения событий: и очереди на диске, и буфера в памяти вкладки. */
 export declare const RECORD_LIMIT = 5000;
-/**
- * Срок жизни события в очереди.
- */
+/** Срок жизни события в очереди. */
 export declare const MAX_AGE_MS: number;
 /** Произвольный набор скалярных полей события. */
 export type StatPayload = Record<string, string | number | boolean | null>;
@@ -29,13 +24,14 @@ export type StatQueueRecord = StatQueueEntry & {
 /**
  * Персистентная очередь событий статистики поверх IndexedDB.
  *
- * База одна на origin, её делят все звонки и все вкладки, поэтому класс
- * статический: второго экземпляра быть не может. Любая ошибка хранилища
- * только логируется — статистика никогда не влияет на звонок.
+ * База одна на origin, поэтому класс статический. Ошибки хранилища только
+ * логируются: статистика не влияет на звонок.
  */
 export default abstract class StatQueue {
     private static _db;
     private static _dbPromise;
+    /** Имя базы. Подменяется только тестами, см. __resetForTests(). */
+    private static _dbName;
     private static _supported;
     private static _appendsSinceEvictCheck;
     /** Момент последней неудачи открытия; до конца кулдауна не пробуем снова. */
@@ -46,36 +42,27 @@ export default abstract class StatQueue {
     /**
      * Проставляет delta перечисленным записям, у которых её ещё нет.
      *
-     * Ключи перечисляются явно, а не диапазоном: между своими записями в
-     * очередь могут лечь чужие — хвост из журнала умершей вкладки, — а они
-     * писались другими часами, и наша поправка к ним не относится.
+     * Ключи перечисляются явно: между своими в очередь могли лечь чужие записи,
+     * писанные другими часами.
      */
     static fillDelta(ids: number[], delta: number): Promise<void>;
     static count(): Promise<number>;
     /**
-     * Читает самые старые события пользователя.
-     *
-     * Записи индекса с одинаковым ключом упорядочены по первичному ключу, а
-     * первичный ключ здесь — автоинкрементный id, поэтому выборка по индексу
-     * by_uid возвращает события в порядке записи без дополнительной сортировки.
+     * Читает самые старые события пользователя. Индекс 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
-     * одной транзакцией. Записи без vcid (события до старта звонка) нельзя
-     * трактовать как одну группу: иначе один эвикшн вынес бы pre-call события
+     * Приводит размер хранилища к лимиту, вынося самые старые звонки целиком:
+     * частично удалённый звонок — это неполная цепочка событий. Записи без
+     * vcid одной группой не считаются, иначе эвикшн вынес бы pre-call события
      * сразу всех звонков.
      */
     static evictToLimit(limit: number): Promise<void>;
-    /**
-     * Удаляет события старше указанного возраста.
-     */
+    /** Удаляет события старше указанного возраста. */
     static evictOlderThan(maxAgeMs: number, now?: number): Promise<void>;
     private static _checkSupport;
     private static _open;

package/classes/stat/StatUnloadJournal.d.ts

@@ -1,39 +1,27 @@
 import { StatQueueEntry } from './StatQueue';
 /**
- * Синхронный журнал умирающей вкладки.
- *
- * Транзакция IndexedDB, начатая в pagehide-обработчике, не успевает
- * закоммититься при перезагрузке или навигации: браузер сносит документ,
- * не дав движку базы завершить запись. Из синхронных хранилищ на этот момент
- * доступен только localStorage, поэтому события финиша складываются сюда,
- * а при следующем старте SDK переносятся в очередь drainToQueue().
- *
- * Ключ уникален на вкладку: две вкладки, умирающие одновременно, не затирают
- * журналы друг друга.
+ * Синхронный журнал умирающей вкладки поверх localStorage: транзакция
+ * IndexedDB из pagehide не успевает закоммититься. Следующий старт SDK
+ * переносит журнал в очередь. Ключ уникален на вкладку.
  */
 export default abstract class StatUnloadJournal {
     private static _tabKey;
     private static _entries;
     /**
-     * Открывает новый журнал для этой вкладки.
-     *
-     * Вызывается на каждом входе в unload-режим. Вкладка может пережить
-     * pagehide (bfcache, отменённая навигация, сворачивание на мобильном) и
-     * умереть повторно; без сброса второй журнал содержал бы события первого,
-     * уже перенесённые в очередь, и они уехали бы в статистику дважды.
+     * Открывает новый журнал для этой вкладки. Без сброса пережившая pagehide
+     * вкладка записала бы во второй журнал уже перенесённые события.
      */
     static beginTabSession(): void;
     static writeSync(entry: StatQueueEntry): boolean;
     /**
-     * Переносит журналы всех закрытых вкладок в очередь IndexedDB.
-     *
-     * Журнал стирается независимо от исхода переноса: это best-effort страховка,
-     * повторные попытки при неработающем IndexedDB дали бы дубли без шанса на
-     * успех. Статистика никогда не влияет на звонок.
+     * Переносит журналы всех закрытых вкладок в очередь. Журнал стирается
+     * независимо от исхода: повторные попытки дали бы дубли.
      *
      * @returns число перенесённых событий.
      */
     static drainToQueue(): Promise<number>;
+    /** Читает журнал и сразу удаляет его. null — ключа уже нет или хранилище недоступно. */
+    private static _take;
     private static _storage;
     private static _isValidEntry;
 }

package/classes/transport/DirectTransport.d.ts

@@ -39,6 +39,8 @@ export default class DirectTransport extends BaseTransport {
     private _lastBadConnection;
     private _perfStatReporter;
     private _directStatReporter;
+    private readonly _sdpStats;
+    private readonly _peerConnectionStats;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
@@ -72,6 +74,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

@@ -10,6 +10,7 @@ export default class PerfStatReporter extends EventEmitter {
     private _previousCallStatReportTimestamp;
     private _previousCallStatReport;
     private _previousRemoteInboundRtps;
+    private _previousCandidatePair;
     private _screenShareStats;
     private _signaling;
     private readonly _directTopology;
@@ -22,6 +23,7 @@ export default class PerfStatReporter extends EventEmitter {
     private reportPerfStats;
     private reportNetworkStats;
     private _reportCallStats;
+    private _reportCandidatePair;
     private _calculatePacketLoss;
     private _handleScreenSharingStat;
     private _handleTransportStateChanged;

package/classes/transport/ServerTransport.d.ts

@@ -45,6 +45,8 @@ 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?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);