@vkontakte/calls-sdk 2.8.13-dev.48bea36c.0 → 2.8.13-dev.49da331a.0

package/classes/AudioOutput.d.ts

@@ -15,6 +15,7 @@ export default class AudioOutput {
     private readonly _features;
     private readonly _statFirstMediaReceived;
     private readonly _logger;
+    private _autoplayRecoveryController;
     constructor(statFirstMediaReceived: StatFirstMediaReceived, allowMultipleTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null);
     add(participantId: ParticipantId, track: MediaStreamTrack): void;
     remove(participantId: ParticipantId, track: MediaStreamTrack): void;
@@ -26,6 +27,7 @@ export default class AudioOutput {
     protected _getTracks(): MediaStreamTrack[];
     protected _initAudioElement(): void;
     protected _stopAudioElement(): void;
+    private _stopAutoplayRecovery;
     private _createAudioElement;
     private _prepareAudioElement;
     private _addTrackToAudioElement;

package/classes/MediaSource.d.ts

@@ -1,5 +1,6 @@
 import type { IEffect } from '@vkontakte/calls-video-effects';
 import EventEmitter from '../classes/EventEmitter';
+import ActiveFeature from '../enums/ActiveFeature';
 import MediaOption from '../enums/MediaOption';
 import { type DebugLogger } from '../static/Debug';
 import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
@@ -77,6 +78,8 @@ export declare class MediaSource extends EventEmitter {
      */
     getMediaSettings(): MediaSettings;
     get mediaSettings(): MediaSettings;
+    /** Что сейчас включено у пользователя — для метрики active_features */
+    get activeFeatures(): ActiveFeature[];
     changeDevice(kind: MediaDeviceKind): Promise<void>;
     /**
      * Установка кастомного стрима для видео, например внешний шаринг экрана

package/classes/StatsLogger.d.ts

@@ -2,7 +2,7 @@ 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>;
+type ClientStatsPayload = Record<string, string | string[] | number | boolean | undefined | null>;
 export type LogClientStatsOptions = {
     immediately?: boolean;
     occurredAt?: number;

package/classes/conversation/Conversation.d.ts

@@ -117,7 +117,7 @@ export default class Conversation extends EventEmitter {
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
     decline(params?: HangupParams): Promise<void>;
     hangup(params?: HangupParams): Promise<void>;
-    addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
+    addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<ExternalParticipant[] | undefined>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
     setVolume(volume: number): void;
@@ -159,6 +159,7 @@ export default class Conversation extends EventEmitter {
     private _onConversationParticipantListChunk;
     private _createParticipantListChunk;
     private _participantListChunkToExternalChunk;
+    private _participantsToExternal;
     private _registerConnectionParticipants;
     private _registerParticipants;
     /** Установим состояние локальных мьютов */
@@ -453,6 +454,11 @@ export default class Conversation extends EventEmitter {
     private _onVideoSuspendSuggest;
     private _onParticipantHold;
     private _isMe;
+    /**
+     * Сколько человек сейчас в звонке. Считаем только принявших: приглашенные,
+     * у которых еще идет вызов, ресурсы не потребляют.
+     */
+    private _getParticipantsCount;
     private _getMuteStatesForRoomId;
     private _getMuteStatesForCurrentRoom;
     private _setMuteStatesForRoomId;

package/classes/stat/BatteryStats.d.ts

@@ -0,0 +1,25 @@
+import StatEventCollector from './StatEventCollector';
+export interface BatteryClock {
+    monotonicNow(): number;
+}
+/**
+ * Метрика battery_level_change: на каждое изменение уровня заряда отправляется
+ * само изменение в процентных пунктах и время, за которое оно произошло.
+ * Пока устройство на зарядке, замеры не ведутся: зарядка сбрасывает точку отсчёта,
+ * и первое изменение после неё только задаёт новую.
+ *
+ * Battery Status API есть только в Chromium, в Safari и Firefox его нет —
+ * там класс молча ничего не делает.
+ */
+export declare class BatteryStats {
+    private readonly _logger;
+    private readonly _clock;
+    private _battery;
+    private _previous;
+    private _destroyed;
+    constructor(logger: StatEventCollector, clock?: BatteryClock);
+    destroy(): void;
+    private _subscribe;
+    private _handleChargingChange;
+    private _handleLevelChange;
+}

package/classes/stat/CallLifecycleStats.d.ts

@@ -1,4 +1,5 @@
 import StatEventCollector from './StatEventCollector';
+import { CallStatTail } from './CallStatTail';
 export type CallLifecycleSource = 'outgoing' | 'incoming' | 'join' | 'anonym_join';
 export interface CallLifecycleInitializationParams {
     source: CallLifecycleSource;
@@ -11,6 +12,8 @@ export interface CallLifecycleClock {
 export declare class CallLifecycleStats {
     private readonly _logger;
     private readonly _clock;
+    /** Хвост звонка в очереди; null — выключен */
+    private readonly _tail;
     private _conversationId;
     private _callStartLabel;
     private _lifecycleStartedAtMonotonic;
@@ -20,7 +23,7 @@ export declare class CallLifecycleStats {
     private _firstMediaSent;
     private _finished;
     private _destroyed;
-    constructor(logger: StatEventCollector, clock?: CallLifecycleClock);
+    constructor(logger: StatEventCollector, clock?: CallLifecycleClock, tail?: CallStatTail | null);
     get firstMediaSentReported(): boolean;
     get terminated(): boolean;
     markInitializationStarted({ source, conversationId }: CallLifecycleInitializationParams): void;
@@ -31,9 +34,15 @@ export declare class CallLifecycleStats {
     markFirstMediaSent(): void;
     markFinished(reason: unknown): void;
     markTerminated(): void;
+    /** Вкладка скрыта: обновляет время в хвосте звонка. */
+    markHidden(): void;
+    /** Вкладка снова видна: обновляет время в хвосте звонка. */
+    markVisible(): void;
     destroy(): void;
     private _canRecord;
     private _durationSince;
+    /** Ведёт хвост звонка, когда известен conversationId. */
+    private _startTail;
     private _finish;
     private _ensureConversationId;
     private _record;

package/classes/stat/CallStatTail.d.ts

@@ -0,0 +1,76 @@
+import type StatEventCollector from './StatEventCollector';
+import type { ClientStatsPayload } from './StatEventCollector';
+export interface CallStatTailClock {
+    wallNow(): number;
+}
+/**
+ * Хвост звонка: call_finish с причиной terminated и итоги звонка, которые
+ * лежат в очереди статистики, пока звонок идёт. Время в хвосте — последний
+ * момент, когда вкладка была жива. Если вкладка умрёт, не закончив звонок,
+ * хвост перенесёт в очередь другая вкладка или следующий старт SDK.
+ *
+ * Пока хвост ведётся, вкладка держит замок звонка: свободный замок значит,
+ * что вкладки больше нет или она выгружена.
+ */
+export declare class CallStatTail {
+    private static _tabId;
+    /** id вкладки, создаётся при первом обращении */
+    static get tabId(): string;
+    static lockName(key: string): string;
+    static isSupported(): boolean;
+    private readonly _logger;
+    private readonly _summaries;
+    private readonly _clock;
+    private _status;
+    private _vcid;
+    private _key;
+    /** Первая запись хвоста; null — ещё не было или не удалась */
+    private _creation;
+    /** Последний снимок итогов звонка */
+    private _summaryCache;
+    private _touches;
+    private _timer;
+    /** Отпускает замок звонка */
+    private _releaseLock;
+    /** Запросы замка подряд, которые закончились без выдачи */
+    private _lockFailures;
+    /** Вызывается, когда хвост забрала другая вкладка */
+    private _onAdopted;
+    /** @param summaries итоги звонка на текущий момент: codec_usage и сводки сигналинга */
+    constructor(logger: StatEventCollector, summaries: () => ClientStatsPayload[], clock?: CallStatTailClock);
+    /** Начинает вести хвост звонка: сначала замок, потом запись. */
+    start(vcid: string, onAdopted: () => void): void;
+    /** Перезаписывает хвост с текущим временем. */
+    touch(): void;
+    /**
+     * Звонок закончился: снимает хвост и вызывает write, который пишет
+     * настоящий финиш. Если хвост уже забрала другая вкладка, write не
+     * вызывается.
+     */
+    complete(write: () => void): void;
+    /** Снимает хвост без финиша. */
+    stop(): void;
+    /**
+     * Вкладка выгружается: хвост остаётся на диске, замок отпускается. Из
+     * pagehide запись в IndexedDB не коммитится, поэтому хвост и есть финиш.
+     */
+    abandon(): void;
+    private _requestLock;
+    /** Замок держится, пока не разрешён возвращённый промис. */
+    private _onLockGranted;
+    /**
+     * Замок отпустили мы, его отняли (Safari при приостановке страницы) или
+     * не выдали. Отнятый просим снова: пока его нет, хвост может забрать
+     * другая вкладка, и следующая запись это заметит.
+     */
+    private _onLockGone;
+    private _onTimer;
+    /** Первая запись создаёт хвост, остальные обновляют его, только если он ещё лежит. */
+    private _write;
+    private _buildTail;
+    private _collectSummaries;
+    private _adopt;
+    private _finish;
+    private _release;
+    private _clearTimer;
+}

package/classes/stat/ClientResourceStats.d.ts

@@ -0,0 +1,41 @@
+import ActiveFeature from '../../enums/ActiveFeature';
+import { type DebugLogger } from '../../static/Debug';
+/** Метрики ресурсов клиента за интервал между отправками callStat */
+export type ClientResourceReport = {
+    /** Максимум участников за интервал */
+    participants_max?: number;
+    /** Фичи, включенные в любой момент интервала */
+    active_features?: string[];
+    /** Максимальная площадь окна за интервал, в мегапикселях */
+    app_total_area_mpx_max?: number;
+};
+export type ClientResourceSources = {
+    getParticipantsCount: () => number;
+    getActiveFeatures: () => ActiveFeature[];
+};
+/**
+ * Копит ресурсные метрики между отправками callStat: репортер забирает накопленное
+ * через takeReport() и начинает копить заново.
+ *
+ * Замеряем чаще, чем отправляем, потому что нас интересует не состояние в момент отправки,
+ * а что происходило за интервал: пик участников и все фичи, которые успели поработать.
+ */
+export declare class ClientResourceStats {
+    private readonly _sources;
+    private readonly _debug;
+    private _timer;
+    private _participantsMax;
+    private _areaMpxMax;
+    private _features;
+    constructor(sources: ClientResourceSources, debug?: DebugLogger);
+    /** Забрать накопленное за интервал и начать копить заново */
+    takeReport(): ClientResourceReport;
+    destroy(): void;
+    private _sample;
+    /**
+     * Площадь окна в физических пикселях: CSS-пиксели умножаем на devicePixelRatio,
+     * иначе одно и то же окно на экране с ретиной и без давало бы одинаковую цифру.
+     * Приложение в вебе — это одна вкладка, суммировать нечего.
+     */
+    private _measureAreaMpx;
+}

package/classes/stat/CodecStatsAggregator.d.ts

@@ -1,5 +1,5 @@
 import { StatItem } from '../../types/Statistics';
-import StatEventCollector from './StatEventCollector';
+import StatEventCollector, { ClientStatsPayload } from './StatEventCollector';
 import TransportTopology from '../../enums/TransportTopology';
 export type CodecKind = 'audio' | 'video';
 /**
@@ -13,7 +13,10 @@ export declare class CodecStatsAggregator {
     private readonly getCurrentTransportTopology;
     constructor(logger: StatEventCollector, getCurrentTransportTopology: () => TransportTopology | undefined);
     reportUsage(stat: StatItem): void;
+    /** События codec_usage, которые ушли бы сейчас при конце звонка: по текущему кодеку аудио и видео. */
+    usageReports(): ClientStatsPayload[];
     private saveUsage;
     private report;
+    private _toLog;
     destroy(): void;
 }

package/classes/stat/ConversationStats.d.ts

@@ -4,7 +4,9 @@ import TransportTopology from '../../enums/TransportTopology';
 import HangupReason from '../HangupReason';
 import StatEventCollector from './StatEventCollector';
 import { ApiCallStats } from './ApiCallStats';
+import { BatteryStats } from './BatteryStats';
 import { CallLifecycleStats } from './CallLifecycleStats';
+import { ClientResourceSources, ClientResourceStats } from './ClientResourceStats';
 import { CodecStatsAggregator } from './CodecStatsAggregator';
 import { StatAggregator } from './StatAggregator';
 import { StatPings } from './StatPings';
@@ -17,19 +19,28 @@ export declare class ConversationStats {
     readonly pings: StatPings;
     readonly signalingCommands: StatSignalingCommands;
     readonly apiCalls: ApiCallStats;
+    readonly resources: ClientResourceStats;
+    readonly battery: BatteryStats;
     private readonly _api;
+    /** Хвост звонка в очереди; null — выключен */
+    private readonly _tail;
     private _unloading;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
+    constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined, resourceSources: ClientResourceSources);
     /**
-     * Вызывается из pagehide-обработчика: события финиша должны пережить смерть
-     * вкладки. Сводки пингов и команд сбрасываем здесь же — destroy() их только
-     * очищает.
+     * Вызывается из pagehide-обработчика. Запись в IndexedDB оттуда не
+     * коммитится, поэтому финиш и итоги звонка доставит его хвост, а
+     * коллектор перестаёт писать в очередь. Сводки пингов и команд
+     * логируем ради onClientStats: destroy() их только очищает.
      */
     prepareForUnload(): void;
-    /** Вкладка пережила pagehide: возвращаем запись в очередь. */
+    /** Вкладка пережила pagehide: снова пишем в очередь. */
     restoreAfterUnload(): void;
     resetPingBaseline(): void;
+    markHidden(): void;
+    markVisible(): void;
     logHangup(reason: HangupReason): void;
     flushCallMetrics(): void;
     destroy(): void;
+    /** Итоги звонка, которые уйдут в хвосте, если вкладка умрёт посреди звонка. */
+    private _callSummaries;
 }

package/classes/stat/NetworkAdaptationStats.d.ts

@@ -0,0 +1,35 @@
+import { StatAggregator } from './StatAggregator';
+/** Причина события client_requested_server_topology */
+export declare const enum ServerTopologyReason {
+    NO_CONNECTION_TIMEOUT = "no_connection_timeout",
+    CONNECTION_FAILED = "connection_failed",
+    SUCCESS_CONNECTION = "success_connection",
+    /** Возможна на бэке, в вебе пока не поддержана */
+    NO_DATA_TIMEOUT = "no_data_timeout",
+    /** Возможна на бэке, в вебе пока не поддержана */
+    SUCCESS_AUDIO = "success_audio",
+    /** Возможна на бэке, в вебе пока не поддержана */
+    CONNECTION_ACCEPTED_FAILED = "connection_accepted_failed"
+}
+export declare const enum NetworkQuality {
+    GOOD = "good",
+    BAD_1 = "bad_1",
+    BAD_2 = "bad_2"
+}
+export type VideoEncoderChange = {
+    /** Круговая задержка, мс */
+    rtt: number;
+    /** Потери, проценты */
+    loss: number;
+    networkQuality: NetworkQuality;
+    /** mimeType исходящего видео, например video/VP8 */
+    mimeType: string | undefined;
+    source: 'camera' | 'screencast' | 'all';
+};
+/** Отправляет в стату решения клиента по смене топологии и настроек видеоэнкодера */
+export declare class NetworkAdaptationStats {
+    private readonly _statAggregator;
+    constructor(statAggregator: StatAggregator | null);
+    logServerTopologyRequested(reason: ServerTopologyReason, elapsed: number): void;
+    logVideoEncoderChanged(change: VideoEncoderChange): void;
+}

package/classes/stat/SdpStats.d.ts

@@ -32,8 +32,9 @@ export declare class SdpStats {
     /** Не смогли применить SDP собеседника */
     logSetRemoteFailed(sdp: SdpDescription, error: unknown): void;
     destroy(): void;
-    private _intervalSince;
     private _logFailure;
     private _log;
 }
+/** Браузер может спрятать локальный адрес за именем вида <uuid>.local, такой кандидат в стату не шлём */
+export declare function isIpAddress(address: string): boolean;
 export {};

package/classes/stat/StatAggregator.d.ts

@@ -1,11 +1,13 @@
 import { ICallStatLog } from '../../types/PerfStatReporter';
 import { IEventualStatLog } from '../../types/IEventualStatLog';
 import StatEventCollector from './StatEventCollector';
+import { ClientResourceStats } from './ClientResourceStats';
 export declare class StatAggregator {
     private readonly _logger;
+    private readonly _resources;
     private readonly _eventualLogs;
     private _lastCallStatContext;
-    constructor(logger: StatEventCollector);
+    constructor(logger: StatEventCollector, resources?: ClientResourceStats | null);
     logCallStat(params: ICallStatLog): void;
     /**
      * Событие уходит с теми полями, что переданы. Без value — уходит без value.

package/classes/stat/StatDrainScheduler.d.ts

@@ -15,6 +15,7 @@ export default abstract class StatDrainScheduler {
     /** Буфер прямой отправки: события, которые не легли в хранилище. */
     private static _directBuffer;
     private static _directTimer;
+    private static _tailRecheckTimer;
     static setApi(value: BaseApi): void;
     /** Первый дрейн подбирает хвосты прошлых сессий и закрытых вкладок. */
     static start(value: BaseApi): void;
@@ -41,6 +42,18 @@ export default abstract class StatDrainScheduler {
      */
     static sendDirect(entry: StatQueueEntry): void;
     private static _currentUserId;
+    /**
+     * Переносит в очередь хвосты звонков умерших и выгруженных вкладок:
+     * свободный замок звонка значит, что вести хвост больше некому. Хвосты
+     * живых вкладок проверяются снова через TAIL_RECHECK_DELAY_MS, иначе
+     * простаивающая вкладка подобрала бы их только на своей отправке.
+     * Вызывается под замком отправки. Не бросает.
+     *
+     * @returns число перенесённых хвостов.
+     */
+    private static _adoptCallTails;
+    private static _armTailRecheck;
+    private static _clearTailRecheckTimer;
     /** @returns число записей в батче. */
     private static _drainCurrent;
     /**

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;
@@ -32,19 +33,23 @@ export default class StatEventCollector extends BaseLogger {
     constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
     log(name: StatLog, value?: string, immediately?: boolean): void;
     /**
-     * Переключает коллектор на синхронный localStorage-журнал: асинхронная
-     * запись в IndexedDB не переживает pagehide.
+     * После pagehide события не пишутся в очередь: запись в IndexedDB оттуда
+     * не коммитится, а в bfcache закоммитилась бы позже и задвоила хвост
+     * звонка. Конец звонка доставит его хвост.
      */
     enterUnloadMode(): void;
-    /**
-     * Вкладка пережила pagehide (bfcache, отменённая навигация): возвращаемся
-     * на очередь и переносим в неё уже записанное в журнал.
-     */
+    /** Вкладка пережила pagehide (bfcache, отменённая навигация): снова пишем в очередь. */
     exitUnloadMode(): void;
     logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
+    /**
+     * Запись очереди для события без записи в очередь и без External.onClientStats.
+     * null — старая схема, uid неизвестен или в памяти ждут события без uid.
+     */
+    buildEntry(data: ClientStatsPayload, options?: LogClientStatsOptions): StatQueueEntry | null;
     destroy(): void;
+    /** Собирает запись очереди без владельца: conversationId, время, поправку и данные события. */
+    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,6 +12,8 @@ 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,24 @@ 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' — финиш уже был,
+     * 'missing' — хвоста нет, 'failed' — хранилище недоступно.
+     */
+    static adoptTail(key: string): Promise<'added' | 'exists' | 'missing' | 'failed'>;
     /**
      * Проставляет delta перечисленным записям, у которых её ещё нет.
      *
@@ -66,10 +97,18 @@ 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;
@@ -41,6 +45,7 @@ export default class DirectTransport extends BaseTransport {
     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,10 @@ 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;
@@ -24,7 +26,9 @@ export default class PerfStatReporter extends EventEmitter {
     private reportNetworkStats;
     private _reportCallStats;
     private _reportCandidatePair;
+    private _calculateRemotePacketLoss;
     private _calculatePacketLoss;
+    private _calculateOutboundDeltas;
     private _handleScreenSharingStat;
     private _handleTransportStateChanged;
 }

package/classes/transport/ServerTransport.d.ts

@@ -83,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;