@vkontakte/calls-sdk 2.8.13-dev.41a8e3bd.0 → 2.8.13-dev.47735529.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/CallsSDK.d.ts +35 -12
  2. package/abstract/BaseApi.d.ts +13 -9
  3. package/calls-sdk.cjs.js +7 -7
  4. package/calls-sdk.esm.js +4266 -2781
  5. package/classes/AudioFix.d.ts +2 -2
  6. package/classes/AudioOutput.d.ts +5 -3
  7. package/classes/MediaSource.d.ts +9 -2
  8. package/classes/SpecListener.d.ts +2 -2
  9. package/classes/StatsLogger.d.ts +1 -1
  10. package/classes/VolumesDetector.d.ts +0 -1
  11. package/classes/codec/LibVPxDecoder.d.ts +2 -2
  12. package/classes/codec/LibVPxEncoder.d.ts +2 -2
  13. package/classes/codec/WebCodecsDecoder.d.ts +2 -2
  14. package/classes/codec/WebCodecsEncoder.d.ts +2 -2
  15. package/classes/codec/WorkerBase.d.ts +3 -3
  16. package/classes/conversation/Conversation.d.ts +9 -1
  17. package/classes/screenshare/ScreenCaptureReceiver.d.ts +2 -2
  18. package/classes/screenshare/ScreenCaptureSender.d.ts +2 -2
  19. package/classes/screenshare/StreamBuilder.d.ts +2 -2
  20. package/classes/stat/ApiCallStats.d.ts +12 -0
  21. package/classes/stat/BatteryStats.d.ts +25 -0
  22. package/classes/stat/CallLifecycleStats.d.ts +11 -2
  23. package/classes/stat/ClientResourceStats.d.ts +41 -0
  24. package/classes/stat/CodecStatsAggregator.d.ts +2 -2
  25. package/classes/stat/ConversationStats.d.ts +22 -3
  26. package/classes/stat/NetworkAdaptationStats.d.ts +35 -0
  27. package/classes/stat/PeerConnectionStats.d.ts +22 -0
  28. package/classes/stat/ProvisionalFinish.d.ts +37 -0
  29. package/classes/stat/ProvisionalFinishStore.d.ts +104 -0
  30. package/classes/stat/SdpStats.d.ts +2 -0
  31. package/classes/stat/Stat.testUtils.d.ts +10 -0
  32. package/classes/stat/StatAggregator.d.ts +12 -3
  33. package/classes/stat/StatClock.d.ts +28 -0
  34. package/classes/stat/StatDrainScheduler.d.ts +102 -0
  35. package/classes/stat/StatEventCollector.d.ts +58 -0
  36. package/classes/stat/StatPings.d.ts +4 -2
  37. package/classes/stat/StatQueue.d.ts +90 -0
  38. package/classes/stat/StatSignalingCommands.d.ts +2 -2
  39. package/classes/stat/StatUnloadJournal.d.ts +27 -0
  40. package/classes/transport/DirectTransport.d.ts +12 -2
  41. package/classes/transport/PerfStatReporter.d.ts +7 -1
  42. package/classes/transport/ServerTransport.d.ts +5 -2
  43. package/classes/transport/SimulcastSender.d.ts +2 -2
  44. package/classes/transport/Transport.d.ts +2 -2
  45. package/default/Api.d.ts +13 -1
  46. package/default/Signaling.d.ts +11 -3
  47. package/default/SignalingTransport.d.ts +5 -1
  48. package/enums/ActiveFeature.d.ts +19 -0
  49. package/enums/SessionError.d.ts +10 -0
  50. package/enums/Stat.d.ts +14 -1
  51. package/package.json +1 -1
  52. package/static/ApiTransport.d.ts +4 -0
  53. package/static/AuthData.d.ts +11 -1
  54. package/static/BrowserEnvironment.d.ts +90 -0
  55. package/static/External.d.ts +7 -0
  56. package/static/Params.d.ts +47 -0
  57. package/static/SessionStore.d.ts +29 -0
  58. package/static/SimulcastInfo.d.ts +1 -0
  59. package/static/WebRTCUtils.d.ts +5 -76
  60. package/types/ClientStatsEvent.d.ts +12 -0
  61. package/types/IEventualStatLog.d.ts +1 -1
  62. package/types/Params.d.ts +1 -1
  63. package/types/PerfStatReporter.d.ts +26 -1
  64. package/types/SignalingMessage.d.ts +1 -0
  65. package/types/Statistics.d.ts +22 -7
@@ -0,0 +1,104 @@
1
+ import { StatQueueEntry } from './StatQueue';
2
+ /** Запись старше не переносим: до предела очереди нужен запас на отправку. */
3
+ export declare const MAX_RECORD_AGE_MS: number;
4
+ /** Предварительный финиш: запись очереди и id вкладки-владельца. */
5
+ export type ProvisionalFinishRecord = StatQueueEntry & {
6
+ /** conversationId звонка */
7
+ vcid: string;
8
+ /** id вкладки, которая ведёт звонок */
9
+ tab: string;
10
+ };
11
+ export type ProvisionalFinishStoreOptions = {
12
+ /** Префикс ключей в localStorage */
13
+ keyPrefix?: string;
14
+ /** Префикс имени замка вкладки */
15
+ lockPrefix?: string;
16
+ };
17
+ /**
18
+ * Предварительные финиши звонков вкладки в localStorage. Пока у вкладки есть
19
+ * звонки, она держит Web Lock со своим id и пишет свои записи только под ним.
20
+ * Записи вкладок, чей замок свободен, переносит в очередь adoptOrphans().
21
+ */
22
+ export declare class ProvisionalFinishStore {
23
+ private readonly _keyPrefix;
24
+ private readonly _lockPrefix;
25
+ /** id документа, создаётся при первом обращении */
26
+ private _tabId;
27
+ /** Число звонков вкладки с предварительным финишем */
28
+ private _holders;
29
+ private _lockState;
30
+ /** Номер текущего запроса замка */
31
+ private _generation;
32
+ /** Отпускает выданный замок */
33
+ private _releaseLock;
34
+ /** Записи, которые ждут первой выдачи замка, по vcid */
35
+ private _waiting;
36
+ /** vcid своих записей, лежащих в localStorage */
37
+ private _written;
38
+ /** vcid, чьи записи забрала другая вкладка */
39
+ private _adopted;
40
+ /** Ждут возврата замка */
41
+ private _whenOwned;
42
+ constructor({ keyPrefix, lockPrefix }?: ProvisionalFinishStoreOptions);
43
+ /** id документа */
44
+ get tabId(): string;
45
+ isSupported(): boolean;
46
+ /** Звонок начал держать запись: при первом звонке вкладка просит замок. */
47
+ hold(): void;
48
+ /** Звонок больше не держит запись: после последнего замок отпускается. */
49
+ unhold(): void;
50
+ /** Пишет запись звонка. Пока замок не выдан или не возвращён, запись ждёт в памяти. */
51
+ save(record: ProvisionalFinishRecord): void;
52
+ remove(vcid: string): void;
53
+ /** Запись звонка забрала другая вкладка, пока у этой не было замка. */
54
+ isAdopted(vcid: string): boolean;
55
+ /** Вызывает callback, когда записи вкладки снова под её замком; если замок не отнимали — сразу. */
56
+ whenOwned(callback: () => void): void;
57
+ /**
58
+ * Переносит в очередь записи вкладок, чей замок свободен. Вызывается под
59
+ * замком отправки. Не бросает.
60
+ *
61
+ * @returns число добавленных финишей.
62
+ */
63
+ adoptOrphans(now?: number): Promise<number>;
64
+ private _requestLock;
65
+ /** Колбэк выдачи замка. Замок держится, пока не разрешён возвращённый промис. */
66
+ private _onGranted;
67
+ /** Промис запроса замка завершился: замок отпустили мы, его отняли или не выдали. */
68
+ private _onLockGone;
69
+ private _fail;
70
+ private _release;
71
+ /** Сверяет все свои записи после возврата замка. */
72
+ private _markAdopted;
73
+ /**
74
+ * Чужие вкладки трогают наши ключи только под нашим замком. Поэтому
75
+ * пропавший свой ключ значит, что запись забрала другая вкладка: замок
76
+ * у нас отнимали, даже если уведомление об этом ещё не пришло. Ошибку
77
+ * чтения переносом не считаем: лишний финиш лучше потерянного.
78
+ *
79
+ * @returns true, если запись звонка забрали.
80
+ */
81
+ private _detectAdopted;
82
+ private _writeWaiting;
83
+ private _flushWhenOwned;
84
+ private _run;
85
+ private _write;
86
+ /** Ключи записей других вкладок, сгруппированные по вкладке. Битые и протухшие записи удаляет. */
87
+ private _findOrphans;
88
+ /**
89
+ * Переносит одну запись под замком её вкладки. Порядок «добавить, потом
90
+ * удалить ключ»: при обрыве между шагами следующий перенос получит exists.
91
+ *
92
+ * @returns true, если финиш добавлен в очередь.
93
+ */
94
+ private _adoptOne;
95
+ /** Разбирает запись. null — битый JSON или не та форма. */
96
+ private _parse;
97
+ private _key;
98
+ private _getItem;
99
+ private _removeKey;
100
+ private _storage;
101
+ private _locks;
102
+ }
103
+ declare const _default: ProvisionalFinishStore;
104
+ export default _default;
@@ -35,4 +35,6 @@ export declare class SdpStats {
35
35
  private _logFailure;
36
36
  private _log;
37
37
  }
38
+ /** Браузер может спрятать локальный адрес за именем вида <uuid>.local, такой кандидат в стату не шлём */
39
+ export declare function isIpAddress(address: string): boolean;
38
40
  export {};
@@ -0,0 +1,10 @@
1
+ import type { MockInstance } from 'vitest';
2
+ /**
3
+ * Дожидается работы, которую код запускает в фоне и не отдаёт промис: ждёт всё,
4
+ * что вернули вызовы шпионов, пока не перестанут появляться новые вызовы.
5
+ *
6
+ * Замена опросу vi.waitFor: тот сдаётся через секунду, а IndexedDB на
7
+ * загруженной машине отвечает дольше. Шпионы должны пропускать вызов к
8
+ * настоящему методу (vi.spyOn без подмены).
9
+ */
10
+ export declare function settleCalls(...spies: MockInstance[]): Promise<void>;
@@ -1,14 +1,23 @@
1
1
  import { ICallStatLog } from '../../types/PerfStatReporter';
2
2
  import { IEventualStatLog } from '../../types/IEventualStatLog';
3
- import StatsLogger from '../StatsLogger';
3
+ import StatEventCollector from './StatEventCollector';
4
+ import { ClientResourceStats } from './ClientResourceStats';
4
5
  export declare class StatAggregator {
5
6
  private readonly _logger;
7
+ private readonly _resources;
6
8
  private readonly _eventualLogs;
7
9
  private _lastCallStatContext;
8
- constructor(logger: StatsLogger);
10
+ constructor(logger: StatEventCollector, resources?: ClientResourceStats | null);
9
11
  logCallStat(params: ICallStatLog): void;
10
- /** @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588 */
12
+ /**
13
+ * Событие уходит с теми полями, что переданы. Без value — уходит без value.
14
+ * @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588
15
+ */
11
16
  logEventualStat(params: IEventualStatLog): void;
17
+ /** value — время от метки с тем же именем, что у события. Метки нет — событие не отправляем. */
18
+ logEventualStatSinceMark(params: IEventualStatLog & {
19
+ value?: never;
20
+ }): void;
12
21
  destroy(): void;
13
22
  private _getCallStatContext;
14
23
  private _flushEventualStats;
@@ -0,0 +1,28 @@
1
+ import BaseApi from '../../abstract/BaseApi';
2
+ /**
3
+ * Поправка часов устройства к серверному времени: delta = Date.now() -
4
+ * serverTime, меряется раз за сессию. Свои записи, сделанные до измерения,
5
+ * получают поправку задним числом.
6
+ */
7
+ export default abstract class StatClock {
8
+ private static _api;
9
+ private static _delta;
10
+ private static _pending;
11
+ /** Ключи своих записей, ушедших в очередь до измерения. */
12
+ private static _idsAwaitingDelta;
13
+ private static _lastFailureAt;
14
+ static setApi(value: BaseApi): void;
15
+ /** Дельта из кэша, без запроса. null — ещё не измерена. */
16
+ static delta(): number | null;
17
+ /** Запускает измерение, если его ещё нет. Результата не ждёт. */
18
+ static ensure(): void;
19
+ /** Дельта для отправки: измеренная, иначе 0 — время устройства. */
20
+ static get(): Promise<number>;
21
+ /**
22
+ * Вызывается коллектором после записи события без дельты. Ключ приходит
23
+ * после append, поэтому измерение могло закончиться раньше.
24
+ */
25
+ static noteAppended(id: number): void;
26
+ private static _hasCredentials;
27
+ private static _measure;
28
+ }
@@ -0,0 +1,102 @@
1
+ import BaseApi from '../../abstract/BaseApi';
2
+ import { StatQueueEntry } from './StatQueue';
3
+ /**
4
+ * Отправитель очереди статистики: один на вкладку, живёт от CallsSDK.init()
5
+ * и не завязан на активный звонок.
6
+ */
7
+ export default abstract class StatDrainScheduler {
8
+ private static _api;
9
+ private static _state;
10
+ private static _timer;
11
+ private static _localCount;
12
+ /** Звонок завершился, пока шёл дрейн: его хвост не должен ждать таймаут тишины. */
13
+ private static _callFinishedDuringDrain;
14
+ private static _blockedSession;
15
+ /** Буфер прямой отправки: события, которые не легли в хранилище. */
16
+ private static _directBuffer;
17
+ private static _directTimer;
18
+ static setApi(value: BaseApi): void;
19
+ /** Первый дрейн подбирает хвосты прошлых сессий и закрытых вкладок. */
20
+ static start(value: BaseApi): void;
21
+ /**
22
+ * Переносит журналы закрытых вкладок в очередь под замком отправки:
23
+ * перенос предварительных финишей сверяется с очередью и не должен
24
+ * застать журнал забранным, но ещё не записанным.
25
+ *
26
+ * @returns число перенесённых событий.
27
+ */
28
+ static importUnloadJournal(): Promise<number>;
29
+ /** Вызывается коллектором после записи события в очередь. */
30
+ static notifyAppended(): void;
31
+ /**
32
+ * Звонок закончился: хвост уходит через секунду, а не через полминуты
33
+ * тишины. Секунда нужна, чтобы дописались все события финиша.
34
+ */
35
+ static notifyCallFinished(): void;
36
+ /**
37
+ * Один цикл отправки по всем владельцам очереди: текущий — живой сессией,
38
+ * остальные — сохранённым session_key. Хвост uid X уходит только под
39
+ * сессией uid X.
40
+ *
41
+ * @returns true, если у кого-то был полный батч и имеет смысл повторить.
42
+ */
43
+ static drainOnce(): Promise<boolean>;
44
+ /**
45
+ * FALLBACK для событий, не попавших в хранилище: копятся в памяти и уходят
46
+ * пачкой, без подтверждения и повтора.
47
+ *
48
+ * Чужие события не отправляются: запрос уходит под текущей сессией.
49
+ */
50
+ static sendDirect(entry: StatQueueEntry): void;
51
+ private static _currentUserId;
52
+ /** Переносит в очередь предварительные финиши закрытых вкладок. */
53
+ private static _adoptProvisionalFinishes;
54
+ /** @returns число записей в батче. */
55
+ private static _drainCurrent;
56
+ /**
57
+ * Хвост другого пользователя под его сохранённым session_key: одна попытка,
58
+ * без перелогина. Недоставленное не удаляем — владелец может авторизоваться
59
+ * в этой вкладке.
60
+ *
61
+ * @returns число записей в батче.
62
+ */
63
+ private static _drainStored;
64
+ /**
65
+ * Взаимное исключение между вкладками одного origin.
66
+ *
67
+ * Транзакцию IndexedDB нельзя держать открытой на время запроса, поэтому
68
+ * чтение и удаление разнесены, и без блокировки соседняя вкладка отправила
69
+ * бы тот же батч повторно.
70
+ */
71
+ private static _withLock;
72
+ /**
73
+ * Ретраятся ошибки, в которых виновато не содержимое батча: сеть, 5xx,
74
+ * http-429, ошибка сессии. Остальное непроходимо и приводит к удалению
75
+ * батча, иначе одно всегда отвергаемое событие залипило бы очередь.
76
+ */
77
+ private static _isSessionError;
78
+ /**
79
+ * Транспорт не смог переавторизоваться, чаще всего из-за протухшего
80
+ * authToken хоста. Хвост не удаляем: он уедет после новой сессии.
81
+ */
82
+ private static _isReauthorizeFailure;
83
+ /**
84
+ * Останавливает отправку за текущего пользователя до смены session_key:
85
+ * другой ключ означает, что авторизация прошла заново. Чужие хвосты не
86
+ * трогает.
87
+ */
88
+ private static _blockSession;
89
+ private static _isSessionBlocked;
90
+ /** Сессия или токен протухли: 102, 103, 104 или 401. */
91
+ private static _isAuthError;
92
+ private static _isRetryable;
93
+ /** @param delta текущая поправка — для записей, у которых своей нет. */
94
+ private static _toClientStats;
95
+ private static _clearDirectTimer;
96
+ private static _armDirect;
97
+ /** Отправляет накопленный буфер прямой отправки одним запросом. */
98
+ private static _flushDirect;
99
+ private static _clearTimer;
100
+ private static _arm;
101
+ private static _drain;
102
+ }
@@ -0,0 +1,58 @@
1
+ import BaseApi from '../../abstract/BaseApi';
2
+ import BaseLogger from '../../abstract/BaseLogger';
3
+ import StatLog from '../../enums/StatLog';
4
+ import TransportTopology from '../../enums/TransportTopology';
5
+ import { StatQueueEntry } from './StatQueue';
6
+ type ClientStatsPayload = Record<string, string | string[] | number | boolean | undefined | null>;
7
+ export type LogClientStatsOptions = {
8
+ /** Время наступления события. По умолчанию — момент записи. */
9
+ occurredAt?: number;
10
+ /** Явный conversationId. По умолчанию берётся из провайдера. */
11
+ conversationId?: string | null;
12
+ /** Только для старой схемы (`Params.statQueueEnabled === false`): отправить батч сразу. */
13
+ immediately?: boolean;
14
+ /** Только для старой схемы: придержать событие, пока не посчитана поправка на серверное время. */
15
+ deferUntilServerTime?: boolean;
16
+ };
17
+ /**
18
+ * Собирает событие статистики и кладёт его в персистентную очередь. Инстанс на
19
+ * звонок, отправкой занимается StatDrainScheduler.
20
+ */
21
+ export default class StatEventCollector extends BaseLogger {
22
+ /** Общий на вкладку: uid может стать известен уже после смерти коллектора. */
23
+ private static _pending;
24
+ private static _pendingOverflow;
25
+ private static _remember;
26
+ private static _takePending;
27
+ private readonly _externalLogger;
28
+ private readonly _conversationIdProvider;
29
+ private readonly _topologyProvider;
30
+ private _unloadMode;
31
+ /** Старая схема: не null, когда ручка выключена, тогда очередь не используется. */
32
+ private readonly _legacy;
33
+ constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
34
+ log(name: StatLog, value?: string, immediately?: boolean): void;
35
+ /**
36
+ * Переключает коллектор на синхронный localStorage-журнал: асинхронная
37
+ * запись в IndexedDB не переживает pagehide.
38
+ */
39
+ enterUnloadMode(): void;
40
+ /**
41
+ * Вкладка пережила pagehide (bfcache, отменённая навигация): возвращаемся
42
+ * на очередь и переносим в неё уже записанное в журнал.
43
+ */
44
+ exitUnloadMode(): void;
45
+ logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
46
+ /**
47
+ * Запись очереди для события без записи в очередь и без External.onClientStats.
48
+ * null — старая схема, uid неизвестен или в памяти ждут события без uid.
49
+ */
50
+ buildEntry(data: ClientStatsPayload, options?: LogClientStatsOptions): StatQueueEntry | null;
51
+ destroy(): void;
52
+ /** Собирает запись очереди без владельца: conversationId, время, поправку и данные события. */
53
+ private _makeEntry;
54
+ private _store;
55
+ private _getConversationId;
56
+ private _getCallTopology;
57
+ }
58
+ export {};
@@ -1,10 +1,10 @@
1
1
  import { SignalingTransportType } from '../../enums/SignalingTransportStat';
2
- import StatsLogger from '../StatsLogger';
2
+ import StatEventCollector from './StatEventCollector';
3
3
  export declare class StatPings {
4
4
  private readonly _logger;
5
5
  private trackerByTransport;
6
6
  private lastSeen;
7
- constructor(logger: StatsLogger);
7
+ constructor(logger: StatEventCollector);
8
8
  /**
9
9
  * Вызывать при входящем ping в сигналингу.
10
10
  * Будет произведен расчет времени между пингами.
@@ -12,5 +12,7 @@ export declare class StatPings {
12
12
  mark(transport: SignalingTransportType): void;
13
13
  /** Отправляем данные в стату */
14
14
  logMetrics(): void;
15
+ /** Сбрасываем baseline после скрытия страницы, чтобы фоновой простой не стал интервалом ping. */
16
+ resetBaseline(): void;
15
17
  destroy(): void;
16
18
  }
@@ -0,0 +1,90 @@
1
+ /** Потолок хранения событий: и очереди на диске, и буфера в памяти вкладки. */
2
+ export declare const RECORD_LIMIT = 5000;
3
+ /** Срок жизни события в очереди. */
4
+ export declare const MAX_AGE_MS: number;
5
+ /** Произвольный набор полей события: скаляры и списки строк. */
6
+ export type StatPayload = Record<string, string | string[] | number | boolean | null>;
7
+ /** Запись очереди без сгенерированного ключа. */
8
+ export type StatQueueEntry = {
9
+ /** userId владельца события. Не может быть неизвестным. */
10
+ uid: number;
11
+ /** conversationId. null — событие залогировано до старта звонка. */
12
+ vcid: string | null;
13
+ /** Время записи в device-time, без коррекции по серверу. */
14
+ ts: number;
15
+ /** Поправка к серверному времени на момент записи. null — ещё не знали. */
16
+ delta?: number | null;
17
+ ev: StatPayload;
18
+ };
19
+ /** Запись очереди, прочитанная из хранилища. */
20
+ export type StatQueueRecord = StatQueueEntry & {
21
+ /** Автоинкремент. Единственный источник истины для порядка событий. */
22
+ id: number;
23
+ };
24
+ /**
25
+ * Персистентная очередь событий статистики поверх IndexedDB.
26
+ *
27
+ * База одна на origin, поэтому класс статический. Ошибки хранилища только
28
+ * логируются: статистика не влияет на звонок.
29
+ */
30
+ export default abstract class StatQueue {
31
+ private static _db;
32
+ private static _dbPromise;
33
+ /** Имя базы. Подменяется только тестами, см. __resetForTests(). */
34
+ private static _dbName;
35
+ private static _supported;
36
+ private static _appendsSinceEvictCheck;
37
+ /** Момент последней неудачи открытия; до конца кулдауна не пробуем снова. */
38
+ private static _lastOpenFailureAt;
39
+ static isSupported(): boolean;
40
+ /** @returns ключ записи или null, если хранилище не приняло её. */
41
+ static append(entry: StatQueueEntry): Promise<number | null>;
42
+ /**
43
+ * Добавляет call_finish, если у звонка этого пользователя его ещё нет.
44
+ * Проверка и запись идут одной транзакцией.
45
+ *
46
+ * @returns 'added' — добавлен, 'exists' — уже был, 'failed' — хранилище недоступно.
47
+ */
48
+ static appendFinishOnce(entry: StatQueueEntry & {
49
+ vcid: string;
50
+ }): Promise<'added' | 'exists' | 'failed'>;
51
+ /**
52
+ * Проставляет delta перечисленным записям, у которых её ещё нет.
53
+ *
54
+ * Ключи перечисляются явно: между своими в очередь могли лечь чужие записи,
55
+ * писанные другими часами.
56
+ */
57
+ static fillDelta(ids: number[], delta: number): Promise<void>;
58
+ static count(): Promise<number>;
59
+ /**
60
+ * Читает самые старые события пользователя. Индекс by_uid отдаёт их в
61
+ * порядке автоинкрементного id, то есть в порядке записи.
62
+ */
63
+ static readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
64
+ static remove(ids: number[]): Promise<void>;
65
+ /** Уникальные uid, у которых есть записи. Курсор по индексу by_uid с nextunique. */
66
+ static listUids(): Promise<number[]>;
67
+ /**
68
+ * Приводит размер хранилища к лимиту, вынося самые старые звонки целиком:
69
+ * частично удалённый звонок — это неполная цепочка событий. Записи без
70
+ * vcid одной группой не считаются, иначе эвикшн вынес бы pre-call события
71
+ * сразу всех звонков.
72
+ */
73
+ static evictToLimit(limit: number): Promise<void>;
74
+ /** Удаляет события старше указанного возраста. */
75
+ static evictOlderThan(maxAgeMs: number, now?: number): Promise<void>;
76
+ private static _checkSupport;
77
+ private static _open;
78
+ /** Раз в EVICT_CHECK_EVERY записей подрезает хранилище до лимита. */
79
+ private static _countAppend;
80
+ private static _close;
81
+ private static _createSchema;
82
+ /** Обёртка над транзакцией: резолвится после успешного коммита. */
83
+ private static _runTransaction;
84
+ /** Читает запись с минимальным id, то есть самую старую в хранилище. */
85
+ private static _readOldestRecord;
86
+ /**
87
+ * Удаляет все события звонка одной транзакцией.
88
+ */
89
+ private static _deleteConversation;
90
+ }
@@ -1,9 +1,9 @@
1
1
  import { SignalingTransportType } from '../../enums/SignalingTransportStat';
2
- import StatsLogger from '../StatsLogger';
2
+ import StatEventCollector from './StatEventCollector';
3
3
  export declare class StatSignalingCommands {
4
4
  private readonly _logger;
5
5
  private trackerByCommand;
6
- constructor(logger: StatsLogger);
6
+ constructor(logger: StatEventCollector);
7
7
  mark(command: string, time: number, transport: SignalingTransportType): void;
8
8
  /** Отправляем данные в стату */
9
9
  logMetrics(): void;
@@ -0,0 +1,27 @@
1
+ import { StatQueueEntry } from './StatQueue';
2
+ /**
3
+ * Синхронный журнал умирающей вкладки поверх localStorage: транзакция
4
+ * IndexedDB из pagehide не успевает закоммититься. Следующий старт SDK
5
+ * переносит журнал в очередь. Ключ уникален на вкладку.
6
+ */
7
+ export default abstract class StatUnloadJournal {
8
+ private static _tabKey;
9
+ private static _entries;
10
+ /**
11
+ * Открывает новый журнал для этой вкладки. Без сброса пережившая pagehide
12
+ * вкладка записала бы во второй журнал уже перенесённые события.
13
+ */
14
+ static beginTabSession(): void;
15
+ static writeSync(entry: StatQueueEntry): boolean;
16
+ /**
17
+ * Переносит журналы всех закрытых вкладок в очередь. Журнал стирается
18
+ * независимо от исхода: повторные попытки дали бы дубли.
19
+ *
20
+ * @returns число перенесённых событий.
21
+ */
22
+ static drainToQueue(): Promise<number>;
23
+ /** Читает журнал и сразу удаляет его. null — ключа уже нет или хранилище недоступно. */
24
+ private static _take;
25
+ private static _storage;
26
+ private static _isValidEntry;
27
+ }
@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
3
3
  import { type DebugLogger } from '../../static/Debug';
4
4
  import { ParticipantId } from '../../types/Participant';
5
5
  import ServerSettings from '../../types/ServerSettings';
6
- import StatsLogger from '../StatsLogger';
6
+ import StatEventCollector from '../stat/StatEventCollector';
7
7
  import { MediaSource } from '../MediaSource';
8
8
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
9
9
  import { StatAggregator } from '../stat/StatAggregator';
@@ -31,6 +31,10 @@ export default class DirectTransport extends BaseTransport {
31
31
  private _lastStat;
32
32
  private _fingerprint;
33
33
  private _neverConnected;
34
+ private _connectionStartedAt;
35
+ private _connectionLostAt;
36
+ /** Запросили переход на серверную топологию, не дождавшись первого подключения p2p */
37
+ private _serverRequestedOnNoConnection;
34
38
  private _serverSettings;
35
39
  private _prevConsumerSettings;
36
40
  private _networkLimitsForVideo;
@@ -40,11 +44,13 @@ export default class DirectTransport extends BaseTransport {
40
44
  private _perfStatReporter;
41
45
  private _directStatReporter;
42
46
  private readonly _sdpStats;
47
+ private readonly _peerConnectionStats;
48
+ private readonly _networkAdaptationStats;
43
49
  private readonly _debug;
44
50
  private readonly _logger;
45
51
  private readonly _statAggregator;
46
52
  private readonly _codecStatsAggregator;
47
- 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);
53
+ 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);
48
54
  get participantId(): ParticipantId;
49
55
  updateStatisticsInterval(): void;
50
56
  private _isDeadConnection;
@@ -73,6 +79,10 @@ export default class DirectTransport extends BaseTransport {
73
79
  private _markConnected;
74
80
  private _onConnectionStateChange;
75
81
  private _startReconnection;
82
+ /**
83
+ * Запрашивает у сигналинга переход на серверную топологию.
84
+ * Обычно это делает только мастер, `fromAnySide` снимает это ограничение.
85
+ */
76
86
  private _requestTopologySwitch;
77
87
  private _stopReconnection;
78
88
  private _startIceRestart;
@@ -8,8 +8,11 @@ export default class PerfStatReporter extends EventEmitter {
8
8
  private _previousPerfStatReportTimestamp;
9
9
  private _previousNetworkStatReportTimestamp;
10
10
  private _previousCallStatReportTimestamp;
11
- private _previousCallStatReport;
11
+ private _previousCounters;
12
12
  private _previousRemoteInboundRtps;
13
+ private _previousInboundRtps;
14
+ private _previousOutboundRtps;
15
+ private _previousCandidatePair;
13
16
  private _screenShareStats;
14
17
  private _signaling;
15
18
  private readonly _directTopology;
@@ -22,7 +25,10 @@ export default class PerfStatReporter extends EventEmitter {
22
25
  private reportPerfStats;
23
26
  private reportNetworkStats;
24
27
  private _reportCallStats;
28
+ private _reportCandidatePair;
29
+ private _calculateRemotePacketLoss;
25
30
  private _calculatePacketLoss;
31
+ private _calculateOutboundDeltas;
26
32
  private _handleScreenSharingStat;
27
33
  private _handleTransportStateChanged;
28
34
  }
@@ -3,7 +3,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
3
3
  import { type DebugLogger } from '../../static/Debug';
4
4
  import { ParticipantId } from '../../types/Participant';
5
5
  import ServerSettings from '../../types/ServerSettings';
6
- import StatsLogger from '../StatsLogger';
6
+ import StatEventCollector from '../stat/StatEventCollector';
7
7
  import { MediaSource } from '../MediaSource';
8
8
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
9
9
  import { StatAggregator } from '../stat/StatAggregator';
@@ -46,9 +46,10 @@ export default class ServerTransport extends BaseTransport {
46
46
  private readonly _logger;
47
47
  private readonly _statAggregator;
48
48
  private readonly _sdpStats;
49
+ private readonly _peerConnectionStats;
49
50
  private readonly _codecStatsAggregator;
50
51
  private readonly _simulcast;
51
- constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
52
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
52
53
  updateStatisticsInterval(): void;
53
54
  open(observer?: boolean): void;
54
55
  close(error?: Error): void;
@@ -82,6 +83,8 @@ export default class ServerTransport extends BaseTransport {
82
83
  private _startSettingsInterval;
83
84
  private _stopSettingsInterval;
84
85
  private _collectStat;
86
+ /** mid потока быстрой шары, чтобы отделить его от камеры в статистике */
87
+ private _getScreenShareMid;
85
88
  private _reportStats;
86
89
  private _detectStaleTracks;
87
90
  private _allocateConsumer;
@@ -2,7 +2,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
2
2
  import { type DebugLogger } from '../../static/Debug';
3
3
  import type VideoSettings from '../../types/VideoSettings';
4
4
  import { MediaSource } from '../MediaSource';
5
- import StatsLogger from '../StatsLogger';
5
+ import StatEventCollector from '../stat/StatEventCollector';
6
6
  export default class SimulcastSender {
7
7
  private _pc;
8
8
  private _transceiver;
@@ -12,7 +12,7 @@ export default class SimulcastSender {
12
12
  private readonly _getCameraSettings;
13
13
  private readonly _debug;
14
14
  private readonly _logger;
15
- constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatsLogger | null);
15
+ constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
16
16
  configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
17
17
  finalizeAnswer(sdp: string): string;
18
18
  sync({ force }?: {
@@ -6,7 +6,7 @@ import { type DebugLogger } from '../../static/Debug';
6
6
  import { ParticipantId } from '../../types/Participant';
7
7
  import ServerSettings from '../../types/ServerSettings';
8
8
  import EventEmitter from '../EventEmitter';
9
- import StatsLogger from '../StatsLogger';
9
+ import StatEventCollector from '../stat/StatEventCollector';
10
10
  import { MediaSource } from '../MediaSource';
11
11
  import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
12
12
  import { StatAggregator } from '../stat/StatAggregator';
@@ -51,7 +51,7 @@ export declare class Transport extends EventEmitter {
51
51
  private readonly _onFirstMediaSent;
52
52
  private _firstMediaSentProbeStopped;
53
53
  private _vadController;
54
- constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
54
+ constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
55
55
  updateSettings(settings: ServerSettings): void;
56
56
  updateStatisticsInterval(): void;
57
57
  allocate(participantId: ParticipantId, isMaster?: boolean): void;