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

package/classes/stat/ConversationStats.d.ts

@@ -2,21 +2,34 @@ import BaseApi from '../../abstract/BaseApi';
 import BaseLogger from '../../abstract/BaseLogger';
 import TransportTopology from '../../enums/TransportTopology';
 import HangupReason from '../HangupReason';
-import StatsLogger from '../StatsLogger';
+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';
 import { StatSignalingCommands } from './StatSignalingCommands';
 export declare class ConversationStats {
-    readonly logger: StatsLogger;
+    readonly logger: StatEventCollector;
     readonly lifecycle: CallLifecycleStats;
     readonly statAggregator: StatAggregator;
     readonly codecStatsAggregator: CodecStatsAggregator;
     readonly pings: StatPings;
     readonly signalingCommands: StatSignalingCommands;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
+    readonly apiCalls: ApiCallStats;
+    readonly resources: ClientResourceStats;
+    readonly battery: BatteryStats;
+    private readonly _api;
+    private readonly _tail;
+    constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined, resourceSources: ClientResourceSources);
+    /** pagehide. Сводки пингов и команд логируем только для onClientStats: в очередь после pagehide уже не пишем. */
+    prepareForUnload(): void;
+    resetPingBaseline(): 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/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,40 @@
+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 _logFailure;
+    private _log;
+}
+/** Браузер может спрятать локальный адрес за именем вида <uuid>.local, такой кандидат в стату не шлём */
+export declare function isIpAddress(address: string): boolean;
+export {};

package/classes/stat/Stat.testUtils.d.ts

@@ -0,0 +1,17 @@
+import type { MockInstance } from 'vitest';
+import { StatTail } from './StatQueue';
+/**
+ * Дожидается работы, которую код запускает в фоне и не отдаёт промис: ждёт всё,
+ * что вернули вызовы шпионов, пока не перестанут появляться новые вызовы.
+ *
+ * Замена опросу vi.waitFor: тот сдаётся через секунду, а IndexedDB на
+ * загруженной машине отвечает дольше. Шпионы должны пропускать вызов к
+ * настоящему методу (vi.spyOn без подмены).
+ */
+export declare function settleCalls(...spies: MockInstance[]): Promise<void>;
+/** Ключ хвоста звонка этой вкладки. */
+export declare function tailKey(vcid: string): string;
+/** Все хвосты звонков на диске. Чтения хвостов у StatQueue нет: таблицу читаем напрямую. */
+export declare function readTails(): Promise<StatTail[]>;
+/** Хвост звонка этой вкладки. */
+export declare function readTail(vcid: string): Promise<StatTail | undefined>;

package/classes/stat/StatAggregator.d.ts

@@ -1,14 +1,23 @@
 import { ICallStatLog } from '../../types/PerfStatReporter';
 import { IEventualStatLog } from '../../types/IEventualStatLog';
-import StatsLogger from '../StatsLogger';
+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: StatsLogger);
+    constructor(logger: StatEventCollector, resources?: ClientResourceStats | null);
     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

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

package/classes/stat/StatDrainScheduler.d.ts

@@ -0,0 +1,113 @@
+import BaseApi from '../../abstract/BaseApi';
+import { StatQueueEntry } from './StatQueue';
+/**
+ * Отправитель очереди статистики: один на вкладку, живёт от CallsSDK.init()
+ * и не завязан на активный звонок.
+ */
+export default abstract class StatDrainScheduler {
+    private static _api;
+    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. События
+     * пользователя X уходят только под сессией X.
+     *
+     * @returns true, если у кого-то был полный батч и имеет смысл повторить.
+     */
+    static drainOnce(): Promise<boolean>;
+    /**
+     * FALLBACK для событий, не попавших в хранилище: копятся в памяти и уходят
+     * пачкой, без подтверждения и повтора.
+     *
+     * Чужие события не отправляются: запрос уходит под текущей сессией.
+     */
+    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:
+     * одна попытка, без перелогина. Неотправленное не удаляем, пользователь
+     * может снова войти в этой вкладке.
+     *
+     * @returns число записей в батче.
+     */
+    private static _drainStored;
+    /**
+     * Взаимное исключение между вкладками одного origin.
+     *
+     * Транзакцию IndexedDB нельзя держать открытой на время запроса, поэтому
+     * чтение и удаление разнесены, и без блокировки соседняя вкладка отправила
+     * бы тот же батч повторно.
+     */
+    private static _withLock;
+    /**
+     * Ретраятся ошибки, в которых виновато не содержимое батча: сеть, 5xx,
+     * http-429, ошибка сессии. Остальное непроходимо и приводит к удалению
+     * батча, иначе одно всегда отвергаемое событие залипило бы очередь.
+     */
+    private static _isSessionError;
+    /**
+     * Транспорт не смог переавторизоваться, чаще всего из-за протухшего
+     * authToken хоста. События не удаляем: уйдут после новой сессии.
+     */
+    private static _isReauthorizeFailure;
+    /**
+     * Останавливает отправку за текущего пользователя до смены session_key:
+     * другой ключ означает, что авторизация прошла заново. События других
+     * пользователей не трогает.
+     */
+    private static _blockSession;
+    private static _isSessionBlocked;
+    /** Сессия или токен протухли: 102, 103, 104 или 401. */
+    private static _isAuthError;
+    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

@@ -0,0 +1,47 @@
+import BaseApi from '../../abstract/BaseApi';
+import BaseLogger from '../../abstract/BaseLogger';
+import StatLog from '../../enums/StatLog';
+import TransportTopology from '../../enums/TransportTopology';
+import { StatQueueEntry } from './StatQueue';
+export type ClientStatsPayload = Record<string, string | string[] | number | boolean | undefined | null>;
+export type LogClientStatsOptions = {
+    /** Время наступления события. По умолчанию — момент записи. */
+    occurredAt?: number;
+    /** Явный conversationId. По умолчанию берётся из провайдера. */
+    conversationId?: string | null;
+    /** Только для старой схемы (`Params.statQueueEnabled === false`): отправить батч сразу. */
+    immediately?: boolean;
+    /** Только для старой схемы: придержать событие, пока не посчитана поправка на серверное время. */
+    deferUntilServerTime?: boolean;
+};
+/**
+ * Собирает событие статистики и кладёт его в персистентную очередь. Инстанс на
+ * звонок, отправкой занимается StatDrainScheduler.
+ */
+export default class StatEventCollector extends BaseLogger {
+    /** Общий на вкладку: uid может стать известен уже после смерти коллектора. */
+    private static _pending;
+    private static _pendingOverflow;
+    private static _remember;
+    private static _takePending;
+    /** Вкладка закрывается (pagehide): в очередь больше не пишем. */
+    unloading: boolean;
+    private readonly _externalLogger;
+    private readonly _conversationIdProvider;
+    private readonly _topologyProvider;
+    /** Старая схема: не 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;
+    /**
+     * Собирает запись очереди, никуда её не записывая и не вызывая onClientStats.
+     * null — старая схема, uid неизвестен или в памяти ждут события без uid.
+     */
+    buildEntry(data: ClientStatsPayload, options?: LogClientStatsOptions): StatQueueEntry | null;
+    destroy(): void;
+    private _makeEntry;
+    private _store;
+    private _getConversationId;
+    private _getCallTopology;
+}

package/classes/stat/StatPings.d.ts

@@ -1,10 +1,10 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector, { ClientStatsPayload } from './StatEventCollector';
 export declare class StatPings {
     private readonly _logger;
     private trackerByTransport;
     private lastSeen;
-    constructor(logger: StatsLogger);
+    constructor(logger: StatEventCollector);
     /**
      * Вызывать при входящем ping в сигналингу.
      * Будет произведен расчет времени между пингами.
@@ -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

@@ -0,0 +1,118 @@
+/** Потолок хранения событий: и очереди на диске, и буфера в памяти вкладки. */
+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;