@vkontakte/calls-sdk 2.8.12-dev.73c9f7fe.0 → 2.8.12-dev.7afbc576.0

package/classes/AudioFix.d.ts

@@ -1,5 +1,5 @@
 import { type DebugLogger } from '../static/Debug';
-import StatsLogger from './StatsLogger';
+import StatEventCollector from './stat/StatEventCollector';
 import { MediaSource } from './MediaSource';
 export default class AudioFix {
     private _fixNoPacketsApplied;
@@ -15,7 +15,7 @@ export default class AudioFix {
     private _lastPacketsSentTime;
     private _toggleAudioPromise;
     private _fixNoPacketsAppliedVideo;
-    constructor(mediaSource: MediaSource, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(mediaSource: MediaSource, debug?: DebugLogger, logger?: StatEventCollector | null);
     private _fixAudioDeviceNoPackets;
     private _fixAudioDeviceTooManyPackets;
     fix(rtps: any[]): void;

package/classes/AudioOutput.d.ts

@@ -1,6 +1,6 @@
 import { type DebugLogger } from '../static/Debug';
 import { ParticipantId } from '../types/Participant';
-import StatsLogger from './StatsLogger';
+import StatEventCollector from './stat/StatEventCollector';
 import { StatFirstMediaReceived } from './stat/StatFirstMediaReceived';
 /**
  * Единый AudioOutput поддерживающий p2p, audioMix и transparent-audio
@@ -14,7 +14,7 @@ export default class AudioOutput {
     private readonly _statFirstMediaReceived;
     protected readonly _debug: DebugLogger;
     private readonly _logger;
-    constructor(statFirstMediaReceived: StatFirstMediaReceived, allowMultipleTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(statFirstMediaReceived: StatFirstMediaReceived, allowMultipleTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null);
     add(participantId: ParticipantId, track: MediaStreamTrack): void;
     remove(participantId: ParticipantId, track: MediaStreamTrack): void;
     get volume(): number;

package/classes/MediaSource.d.ts

@@ -4,7 +4,7 @@ import MediaOption from '../enums/MediaOption';
 import { type DebugLogger } from '../static/Debug';
 import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
 import { ScreenCaptureSettings } from '../types/ScreenCaptureSettings';
-import StatsLogger from './StatsLogger';
+import StatEventCollector from './stat/StatEventCollector';
 export declare const enum MediaSourceEvent {
     SOURCE_CHANGED = "SOURCE_CHANGED",
     SOURCE_READY = "SOURCE_READY",
@@ -60,7 +60,7 @@ export declare class MediaSource extends EventEmitter {
     private readonly _logger;
     private _cameraTrackSetAt;
     private _cameraMuteRecoveredAt;
-    constructor(debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(debug?: DebugLogger, logger?: StatEventCollector | null);
     get cameraVideoTrack(): MediaStreamTrack | null;
     set cameraVideoTrack(track: MediaStreamTrack | null);
     request(mediaOptions?: MediaOption[], needEmptyTracks?: boolean): Promise<void>;

package/classes/SpecListener.d.ts

@@ -2,7 +2,7 @@ import { type DebugLogger } from '../static/Debug';
 import MediaSettings from '../types/MediaSettings';
 import { Participant, ParticipantId } from '../types/Participant';
 import EventEmitter from './EventEmitter';
-import StatsLogger from './StatsLogger';
+import StatEventCollector from './stat/StatEventCollector';
 import { Transport } from './transport/Transport';
 import { VolumesDetector } from './VolumesDetector';
 export default class SpecListener extends EventEmitter {
@@ -14,7 +14,7 @@ export default class SpecListener extends EventEmitter {
     private _connectionTimeout;
     private _connectionTimeoutSuppressed;
     private _volumeTimeout;
-    constructor(transport: Transport, volumesDetector: VolumesDetector, participants: Record<ParticipantId, Participant>, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(transport: Transport, volumesDetector: VolumesDetector, participants: Record<ParticipantId, Participant>, debug?: DebugLogger, logger?: StatEventCollector | null);
     destroy(): void;
     onChangeRemoteMediaSettings(participantId: ParticipantId, mediaSettings: MediaSettings): void;
     onParticipantHoldChanged(): void;

package/classes/codec/LibVPxDecoder.d.ts

@@ -1,9 +1,9 @@
 import { type DebugLogger } from '../../static/Debug';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import IDecoder from './IDecoder';
 import WorkerBase from './WorkerBase';
 export default class LibVPxDecoder extends WorkerBase implements IDecoder {
-    constructor(debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(debug?: DebugLogger, logger?: StatEventCollector | null);
     init(onFrameImage: (image: ImageData) => void, onFrameError: (error: unknown) => void, onKeyFrameRequested: () => void): Promise<void>;
     decodeFrame(timestamp: number, data: Uint8Array, isVP9: boolean, keyFrame?: boolean): void;
     destroy(): void;

package/classes/codec/LibVPxEncoder.d.ts

@@ -1,5 +1,5 @@
 import { type DebugLogger } from '../../static/Debug';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import IEncoder from './IEncoder';
 import { OnFrameCallback } from './Types';
 import WorkerBase from './WorkerBase';
@@ -15,7 +15,7 @@ export default class LibVPxEncoder extends WorkerBase implements IEncoder {
     private _canvasCtx;
     private _frameReadTimeout;
     private _lastFrame;
-    constructor(sourceTrack: MediaStreamTrack, onFrame: OnFrameCallback, useCongestionControl: boolean, maxBitrate: number, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(sourceTrack: MediaStreamTrack, onFrame: OnFrameCallback, useCongestionControl: boolean, maxBitrate: number, debug?: DebugLogger, logger?: StatEventCollector | null);
     private _createDom;
     private _removeDom;
     private _createStream;

package/classes/codec/WebCodecsDecoder.d.ts

@@ -1,9 +1,9 @@
 import { type DebugLogger } from '../../static/Debug';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import IDecoder from './IDecoder';
 import WorkerBase from './WorkerBase';
 export default class WebCodecsDecoder extends WorkerBase implements IDecoder {
-    constructor(debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(debug?: DebugLogger, logger?: StatEventCollector | null);
     init(onFrameImage: (frame: VideoFrame) => void, onFrameError: (error: unknown) => void, onKeyFrameRequested: () => void): Promise<void>;
     decodeFrame(timestamp: number, data: Uint8Array, isVP9: boolean, keyFrame?: boolean): void;
     destroy(): void;

package/classes/codec/WebCodecsEncoder.d.ts

@@ -1,5 +1,5 @@
 import { type DebugLogger } from '../../static/Debug';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import IEncoder from './IEncoder';
 import { OnFrameCallback } from './Types';
 import WorkerBase from './WorkerBase';
@@ -11,7 +11,7 @@ export default class WebCodecsEncoder extends WorkerBase implements IEncoder {
     private readonly _maxBitrate;
     private readonly _useCbr;
     private readonly _frameRate;
-    constructor(sourceTrack: MediaStreamTrack, onFrame: OnFrameCallback, useCongestionControl: boolean, maxBitrate: number, useCbr: boolean, frameRate: number, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(sourceTrack: MediaStreamTrack, onFrame: OnFrameCallback, useCongestionControl: boolean, maxBitrate: number, useCbr: boolean, frameRate: number, debug?: DebugLogger, logger?: StatEventCollector | null);
     init(): Promise<void>;
     requestFrame(keyFrame?: boolean): void;
     setBitrate(bitrate: number, useCbr: boolean, fps: number): void;

package/classes/codec/WorkerBase.d.ts

@@ -1,10 +1,10 @@
 import { type DebugLogger } from '../../static/Debug';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 export default abstract class WorkerBase {
     protected _worker: Worker | null;
     protected readonly _debug: DebugLogger;
-    protected readonly _logger: StatsLogger | null;
-    protected constructor(debug?: DebugLogger, logger?: StatsLogger | null);
+    protected readonly _logger: StatEventCollector | null;
+    protected constructor(debug?: DebugLogger, logger?: StatEventCollector | null);
     protected _createWorker(workerFunctionData: string, onFrame: (data: any) => void, workerArgs?: any[], initArgs?: {
         [key: string]: any;
     }, transfer?: any[]): Promise<void>;

package/classes/conversation/Conversation.d.ts

@@ -5,7 +5,6 @@ import BaseLogger from '../../abstract/BaseLogger';
 import { AddParticipantParams } from '../../abstract/BaseSignaling';
 import ConversationFeature from '../../enums/ConversationFeature';
 import ConversationOption from '../../enums/ConversationOption';
-import type ClientHangupReason from '../../enums/ClientHangupReason';
 import MediaOption from '../../enums/MediaOption';
 import UpdateDisplayLayoutErrorReason from '../../enums/UpdateDisplayLayoutErrorReason';
 import UserRole from '../../enums/UserRole';
@@ -16,6 +15,7 @@ import { IAsrStartParams, IAsrStopParams } from '../../types/Asr';
 import { AudienceModeHandsResponse } from '../../types/AudienceMode';
 import { ConversationData, ConversationOnJoinParams, ConversationOnStartParams } from '../../types/Conversation';
 import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk } from '../../types/ExternalId';
+import type { FastHangupHandler, HangupParams } from '../../types/FastHangup';
 import MediaModifiers from '../../types/MediaModifiers';
 import MediaSettings, { IVideoDimentions } from '../../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../../types/MovieShare';
@@ -57,6 +57,7 @@ export default class Conversation extends EventEmitter {
     private _serverSettings;
     private _serverTimeOffset;
     private _delayedHangup;
+    private _onFastHangup?;
     private _hangupEmitted;
     private _hangupPromise;
     private _abortController;
@@ -78,7 +79,7 @@ export default class Conversation extends EventEmitter {
     private readonly _statFirstMediaReceived;
     constructor(api: BaseApi, externalLogger: BaseLogger | null);
     static current(): Conversation | null;
-    static hangupAfterInit(): void;
+    static hangupAfterInit(onFastHangup?: FastHangupHandler): void;
     static id(): string | null;
     get id(): string;
     get externalId(): ExternalParticipantId | undefined;
@@ -90,6 +91,7 @@ export default class Conversation extends EventEmitter {
     static getSyncedTime(): number;
     get debugSessionId(): string | null;
     getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
+    private _buildInternalParams;
     onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart, conversationId, }: ConversationOnStartParams): Promise<ConversationData>;
     onJoin(joinArgs: ConversationOnJoinParams): Promise<ConversationData>;
     private _onJoinPart2;
@@ -105,8 +107,8 @@ export default class Conversation extends EventEmitter {
     private _getMainRoomParticipants;
     private _decodeExternalConversationParams;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
-    decline(reason?: ClientHangupReason): Promise<void>;
-    hangup(reason?: ClientHangupReason): Promise<void>;
+    decline(params?: HangupParams): Promise<void>;
+    hangup(params?: HangupParams): Promise<void>;
     addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
@@ -119,6 +121,7 @@ export default class Conversation extends EventEmitter {
     private _emitHangupOnce;
     private _sendHangupApi;
     private _close;
+    private _sendHangup;
     destroy(): void;
     private _destroy;
     private _getConversationParams;

package/classes/screenshare/ScreenCaptureReceiver.d.ts

@@ -1,6 +1,6 @@
 import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import { ParticipantIdRegistry } from '../ParticipantIdRegistry';
 import { StatAggregator } from '../stat/StatAggregator';
 import { IOnStat } from './BaseStreamBuilder';
@@ -14,7 +14,7 @@ export default class ScreenCaptureReceiver {
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
-    constructor(datachannel: RTCDataChannel, participantIdRegistry: ParticipantIdRegistry, onStream: (streamId: string, stream: MediaStream) => void, onEos: (streamId: string) => void, onStat: IOnStat, statAggregator?: StatAggregator | null, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(datachannel: RTCDataChannel, participantIdRegistry: ParticipantIdRegistry, onStream: (streamId: string, stream: MediaStream) => void, onEos: (streamId: string) => void, onStat: IOnStat, statAggregator?: StatAggregator | null, debug?: DebugLogger, logger?: StatEventCollector | null);
     private _onDataChannelMessage;
     /**
      * Отправить запрос ключевого кадра в datachannel.

package/classes/screenshare/ScreenCaptureSender.d.ts

@@ -1,6 +1,6 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
 import { type DebugLogger } from '../../static/Debug';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 export default class ScreenCaptureSender {
     private readonly _encoder;
     private readonly _datachannel;
@@ -25,7 +25,7 @@ export default class ScreenCaptureSender {
     private readonly _maxFrameDelay;
     private readonly _debug;
     private readonly _logger;
-    constructor(track: MediaStreamTrack, datachannel: RTCDataChannel, signaling: BaseSignaling, fastSharing: boolean, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(track: MediaStreamTrack, datachannel: RTCDataChannel, signaling: BaseSignaling, fastSharing: boolean, debug?: DebugLogger, logger?: StatEventCollector | null);
     private _handleQueue;
     /**
      * Очищает очередь до опорного кадра

package/classes/screenshare/StreamBuilder.d.ts

@@ -1,6 +1,6 @@
 import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import { StatAggregator } from '../stat/StatAggregator';
 import { BaseStreamBuilder, FrameData, IOnStat, IOnStream } from './BaseStreamBuilder';
 export default class StreamBuilder extends BaseStreamBuilder {
@@ -11,7 +11,7 @@ export default class StreamBuilder extends BaseStreamBuilder {
     private _decoderQueue;
     private _fpsMeter;
     private readonly _logger;
-    constructor(participantId: ParticipantId, onStream: IOnStream, onStat: IOnStat, statAggregator: StatAggregator | null, onKeyFrameRequested: VoidFunction, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(participantId: ParticipantId, onStream: IOnStream, onStat: IOnStat, statAggregator: StatAggregator | null, onKeyFrameRequested: VoidFunction, debug?: DebugLogger, logger?: StatEventCollector | null);
     protected _processFrame(frame: FrameData): void;
     private _initFpsMeter;
     /**

package/classes/stat/CallLifecycleStats.d.ts

@@ -1,4 +1,4 @@
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from './StatEventCollector';
 export type CallLifecycleSource = 'outgoing' | 'incoming' | 'join' | 'anonym_join';
 export interface CallLifecycleInitializationParams {
     source: CallLifecycleSource;
@@ -20,7 +20,7 @@ export declare class CallLifecycleStats {
     private _firstMediaSent;
     private _finished;
     private _destroyed;
-    constructor(logger: StatsLogger, clock?: CallLifecycleClock);
+    constructor(logger: StatEventCollector, clock?: CallLifecycleClock);
     get firstMediaSentReported(): boolean;
     get terminated(): boolean;
     markInitializationStarted({ source, conversationId }: CallLifecycleInitializationParams): void;

package/classes/stat/CodecStatsAggregator.d.ts

@@ -1,5 +1,5 @@
 import { StatItem } from '../../types/Statistics';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from './StatEventCollector';
 import TransportTopology from '../../enums/TransportTopology';
 export type CodecKind = 'audio' | 'video';
 /**
@@ -11,7 +11,7 @@ export declare class CodecStatsAggregator {
     private readonly _logger;
     private readonly _codecUsages;
     private readonly getCurrentTransportTopology;
-    constructor(logger: StatsLogger, getCurrentTransportTopology: () => TransportTopology | undefined);
+    constructor(logger: StatEventCollector, getCurrentTransportTopology: () => TransportTopology | undefined);
     reportUsage(stat: StatItem): void;
     private saveUsage;
     private report;

package/classes/stat/ConversationStats.d.ts

@@ -1,21 +1,28 @@
-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 { CallLifecycleStats } from './CallLifecycleStats';
 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);
+    constructor(externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
+    /**
+     * Вызывается из pagehide-обработчика: события финиша должны пережить смерть вкладки.
+     *
+     * Сводки пингов и команд сбрасываем здесь же: обычный путь делает это в
+     * flushCallMetrics(), а destroy() их только очищает. Если flushCallMetrics()
+     * уже отработал, трекеры пусты и повторной записи не будет.
+     */
+    prepareForUnload(): void;
     logHangup(reason: HangupReason): void;
     flushCallMetrics(): void;
     destroy(): void;

package/classes/stat/StatAggregator.d.ts

@@ -1,11 +1,11 @@
 import { ICallStatLog } from '../../types/PerfStatReporter';
 import { IEventualStatLog } from '../../types/IEventualStatLog';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from './StatEventCollector';
 export declare class StatAggregator {
     private readonly _logger;
     private readonly _eventualLogs;
     private _lastCallStatContext;
-    constructor(logger: StatsLogger);
+    constructor(logger: StatEventCollector);
     logCallStat(params: ICallStatLog): void;
     /** @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588 */
     logEventualStat(params: IEventualStatLog): void;

package/classes/stat/StatDrainScheduler.d.ts

@@ -0,0 +1,78 @@
+import BaseApi from '../../abstract/BaseApi';
+import { StatQueueEntry } from './StatQueue';
+/**
+ * Отправитель очереди статистики: один на вкладку.
+ *
+ * Живёт от CallsSDK.init() и не завязан на активный звонок. Держит машину
+ * состояний триггеров, забирает батч под Web Lock, отправляет и удаляет
+ * отправленное.
+ */
+export default abstract class StatDrainScheduler {
+    private static _api;
+    private static _serverTimeDelta;
+    private static _state;
+    private static _timer;
+    private static _localCount;
+    static setApi(value: BaseApi): void;
+    /**
+     * Запускает шедулер. Один дрейн на старте подбирает хвосты, оставленные
+     * прошлыми сессиями и закрытыми вкладками.
+     */
+    static start(value: BaseApi): void;
+    static stop(): void;
+    /** Вызывается коллектором после записи события в очередь. */
+    static notifyAppended(): void;
+    /**
+     * Один цикл отправки.
+     *
+     * @returns true, если очередь могла остаться непустой и имеет смысл повторить.
+     */
+    static drainOnce(): Promise<boolean>;
+    /**
+     * FALLBACK: прямая отправка в обход очереди.
+     *
+     * Вызывается коллектором только когда событие не удалось положить в
+     * IndexedDB: SecurityError в cross-site iframe с заблокированным сторонним
+     * хранилищем, зависший open в Safari, переполненная квота. Событие уходит
+     * одним запросом без подтверждения и без повтора — это уровень доставки
+     * старого StatsLogger, а не гарантия очереди. Для пользователей с рабочим
+     * хранилищем этот путь не используется никогда.
+     *
+     * Событие чужого пользователя не отправляется: запрос уходит под текущей
+     * сессией, а очередь партиционирована по владельцу именно ради этого.
+     */
+    static sendDirect(entry: StatQueueEntry): Promise<void>;
+    private static _currentUserId;
+    /**
+     * Взаимное исключение между вкладками одного origin.
+     *
+     * IndexedDB коммитит транзакцию, как только опустеет очередь её запросов на
+     * текущем тике event loop, поэтому держать транзакцию открытой на время
+     * отправки невозможно: чтение и удаление обязаны быть разными транзакциями.
+     * Всё время запроса записи видны другим вкладкам, и без внешней блокировки
+     * соседняя вкладка отправила бы тот же батч повторно.
+     *
+     * Web Lock удерживается на всё время колбэка, включая сеть, и снимается
+     * браузером автоматически при закрытии или падении вкладки.
+     */
+    private static _withLock;
+    /**
+     * Ретраятся ошибки, в которых виновато не содержимое батча: сетевой сбой,
+     * таймаут, 5xx, троттлинг http-429 и ошибка сессии. Сессию транспорт чинит
+     * сам одной реавторизацией с повтором (Api._sendClientStats), но если и она
+     * не помогла, сырая ошибка {error_code} долетает сюда — авторизация может
+     * восстановиться позже, удалять из-за неё батч нельзя.
+     *
+     * Всё остальное считается непроходимым и приводит к удалению батча. Без этого
+     * одно событие, которое сервер отвергает всегда, залипило бы очередь навсегда:
+     * каждый тик читал бы тот же батч, получал ту же ошибку и ничего не удалял,
+     * пока эвикшн не начал бы выбрасывать свежие звонки.
+     */
+    private static _isSessionError;
+    private static _isRetryable;
+    private static _getServerTimeDelta;
+    private static _toClientStats;
+    private static _clearTimer;
+    private static _arm;
+    private static _drain;
+}

package/classes/stat/StatEventCollector.d.ts

@@ -0,0 +1,37 @@
+import BaseLogger from '../../abstract/BaseLogger';
+import StatLog from '../../enums/StatLog';
+import TransportTopology from '../../enums/TransportTopology';
+type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
+export type LogClientStatsOptions = {
+    /** Время наступления события. По умолчанию — момент записи. */
+    occurredAt?: number;
+    /** Явный conversationId. По умолчанию берётся из провайдера. */
+    conversationId?: string | null;
+};
+/**
+ * Собирает событие статистики и кладёт его в персистентную очередь.
+ *
+ * Инстанс на звонок: держит провайдеры conversationId и топологии и ссылку
+ * на внешний логгер хоста. Отправкой занимается StatDrainScheduler.
+ */
+export default class StatEventCollector extends BaseLogger {
+    private readonly _externalLogger;
+    private readonly _conversationIdProvider;
+    private readonly _topologyProvider;
+    private _unloadMode;
+    constructor(externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
+    log(name: StatLog, value?: string, immediately?: boolean): void;
+    /**
+     * Переключает коллектор на синхронный localStorage-журнал.
+     *
+     * Вызывается из pagehide-обработчика: асинхронная запись в IndexedDB не
+     * переживает перезагрузку или навигацию, а журнал переносится в очередь
+     * при следующем старте SDK.
+     */
+    enterUnloadMode(): void;
+    logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
+    destroy(): void;
+    private _getConversationId;
+    private _getCallTopology;
+}
+export {};

package/classes/stat/StatPings.d.ts

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

package/classes/stat/StatQueue.d.ts

@@ -0,0 +1,61 @@
+/** Произвольный набор скалярных полей события. */
+export type StatPayload = Record<string, string | number | boolean | null>;
+/** Запись очереди без сгенерированного ключа. */
+export type StatQueueEntry = {
+    /** userId владельца события. Не может быть неизвестным. */
+    uid: number;
+    /** conversationId. null — событие залогировано до старта звонка. */
+    vcid: string | null;
+    /** Время записи в device-time, без коррекции по серверу. */
+    ts: number;
+    ev: StatPayload;
+};
+/** Запись очереди, прочитанная из хранилища. */
+export type StatQueueRecord = StatQueueEntry & {
+    /** Автоинкремент. Единственный источник истины для порядка событий. */
+    id: number;
+};
+/**
+ * Персистентная очередь событий статистики поверх IndexedDB.
+ *
+ * База одна на origin, её делят все звонки и все вкладки, поэтому класс
+ * статический: второго экземпляра быть не может. Любая ошибка хранилища
+ * только логируется — статистика никогда не влияет на звонок.
+ */
+export default abstract class StatQueue {
+    private static _db;
+    private static _dbPromise;
+    private static _supported;
+    private static _appendsSinceEvictCheck;
+    static isSupported(): boolean;
+    static append(entry: StatQueueEntry): Promise<boolean>;
+    static count(): Promise<number>;
+    /**
+     * Читает самые старые события пользователя.
+     *
+     * Записи индекса с одинаковым ключом упорядочены по первичному ключу, а
+     * первичный ключ здесь — автоинкрементный id, поэтому выборка по индексу
+     * by_uid возвращает события в порядке записи без дополнительной сортировки.
+     */
+    static readOldest(uid: number, limit: number): Promise<StatQueueRecord[]>;
+    static remove(ids: number[]): Promise<void>;
+    /**
+     * Приводит размер хранилища к лимиту, удаляя самые старые звонки целиком.
+     *
+     * Частично удалённый звонок — это ровно та неполная цепочка событий, ради
+     * устранения которой заведена задача, поэтому звонок выносится по vcid
+     * одной транзакцией. Записи без vcid (события до старта звонка) нельзя
+     * трактовать как одну группу: иначе один эвикшн вынес бы pre-call события
+     * сразу всех звонков.
+     */
+    static evictToLimit(limit: number): Promise<void>;
+    private static _checkSupport;
+    private static _open;
+    private static _close;
+    private static _createSchema;
+    /** Обёртка над транзакцией: резолвится после успешного коммита. */
+    private static _runTransaction;
+    /** Читает запись с минимальным id, то есть самую старую в хранилище. */
+    private static _readOldestRecord;
+    private static _readIdsByConversation;
+}

package/classes/stat/StatSignalingCommands.d.ts

@@ -1,9 +1,9 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector 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;

package/classes/stat/StatUnloadJournal.d.ts

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

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';
@@ -43,7 +43,7 @@ export default class DirectTransport extends BaseTransport {
     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;

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';
@@ -47,7 +47,7 @@ export default class ServerTransport extends BaseTransport {
     private readonly _statAggregator;
     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;