@vkontakte/calls-sdk 2.8.13-dev.c9243c68.0 → 2.8.13-dev.d26e27ad.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
@@ -15,7 +15,7 @@ export default class AudioOutput {
     private readonly _features;
     private readonly _statFirstMediaReceived;
     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/ExternalIdCache.d.ts

@@ -1,20 +1,16 @@
 import { ExternalId, ExternalParticipantId } from '../types/ExternalId';
-import { CompositeUserId, OkUserId, ParticipantId } from '../types/Participant';
+import { ParticipantId } from '../types/Participant';
 export declare class ExternalIdCache {
     private static _normalizeType;
-    private _okIdToExternalId;
-    private _externalIdToOkId;
+    private _participantIdToExternalId;
+    private _externalIdToParticipantId;
     private _decorativeIdToInitialId;
     private _initialIdToDecorativeId;
-    getOkId(externalId: ExternalId): OkUserId | null;
-    getExternalId(okId: OkUserId): ExternalParticipantId | null;
-    hasByExternalId(externalId: ExternalId): boolean;
-    hasByOkId(okId: OkUserId): boolean;
-    cache(participantId: OkUserId | CompositeUserId | ParticipantId, externalId: ExternalParticipantId): void;
-    mapDecorativeId(decorativeId: OkUserId | CompositeUserId | ParticipantId, initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    unmapDecorativeId(initialId: OkUserId | CompositeUserId | ParticipantId): void;
-    getDecorativeIdByInitialId(initialId: OkUserId | CompositeUserId | ParticipantId): OkUserId | undefined;
-    replaceByInitialIdIdIfExists(id: OkUserId | CompositeUserId | ParticipantId): OkUserId;
-    getParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    getExternalId(participantId: ParticipantId): ExternalParticipantId | null;
+    getParticipantId(externalId: ExternalId): ParticipantId | null;
+    cache(participantId: ParticipantId, externalId: ExternalParticipantId): void;
+    mapDecorativeId(decorativeId: ParticipantId, initialId: ParticipantId): void;
+    unmapDecorativeId(initialId: ParticipantId): void;
+    getDecorativeIdByInitialId(initialId: ParticipantId): ParticipantId | undefined;
     clear(): void;
 }

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/VolumesDetector.d.ts

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

package/classes/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

@@ -20,7 +20,7 @@ import MediaModifiers from '../../types/MediaModifiers';
 import MediaSettings, { IVideoDimentions } from '../../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../../types/MovieShare';
 import MuteStates from '../../types/MuteStates';
-import { CompositeUserId, IGetParticipantsParameters, OkUserId, ParticipantId, ParticipantStateData } from '../../types/Participant';
+import { CompositeUserId, IGetParticipantsParameters, ParticipantId, ParticipantStateData } from '../../types/Participant';
 import { DisplayLayoutRequest, ParticipantLayout } from '../../types/ParticipantLayout';
 import { ParticipantListChunkParameters } from '../../types/ParticipantListChunk';
 import ParticipantPriority from '../../types/ParticipantPriority';
@@ -65,6 +65,7 @@ export default class Conversation extends EventEmitter {
     private _calleeUnavailableTimer;
     private _reservedId;
     private readonly _onUnload;
+    private readonly _onRestore;
     private readonly _audioOutput;
     private readonly _stats;
     private _lastStalled;
@@ -91,7 +92,8 @@ export default class Conversation extends EventEmitter {
     static debugMessageWithContext(type: DebugMessageType, conversationId: string, ...args: any[]): boolean;
     static getSyncedTime(): number;
     get debugSessionId(): string | null;
-    getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
+    getCachedParticipantIdByExternalId(externalId: ExternalId): ParticipantId | null;
+    private _onNonFatalError;
     /**
      * Внешний id звонящего во входящем звонке, либо null, если звонящий не найден.
      */
@@ -169,8 +171,9 @@ export default class Conversation extends EventEmitter {
     private _registerParticipantInCache;
     private _getExistedParticipantByIdOrCreate;
     private _getExternalIdByParticipantId;
-    private _getExternalIdsByOkIdsFromCache;
-    private _getOrCacheExternalIdByCompositeId;
+    private _getExternalIdsByParticipantIds;
+    private _reportMissingExternalIds;
+    private _reportMissingExternalIdsById;
     private _registerParticipantAndSetMarkersIfChunkEnabled;
     private _warnParticipantNotInConversation;
     private _denormalizeMarkers;

package/classes/conversation/Conversation.testUtils.d.ts

@@ -35,6 +35,8 @@ declare function createParams(): {
     onChatRoomUpdated: Mock<import("@vitest/spy").Procedure>;
     onRemoteStatus: Mock<import("@vitest/spy").Procedure>;
     onSpeakerChanged: Mock<import("@vitest/spy").Procedure>;
+    onAcceptedCall: Mock<import("@vitest/spy").Procedure>;
+    onNonFatalError: Mock<import("@vitest/spy").Procedure>;
 };
 export type ConversationTestParams = ReturnType<typeof createParams>;
 export type ConversationTestTools = {

package/classes/conversation/DisplayLayoutRequester.d.ts

@@ -8,6 +8,7 @@ type DisplayLayoutRequesterParams = {
     getParticipants: () => Record<ParticipantId, Participant>;
     isMe: (participantId: ParticipantId) => boolean;
     updateDisplayLayout: (layouts: ParticipantLayout[]) => Promise<void>;
+    onNonFatalError: (message: string) => void;
 };
 export default class DisplayLayoutRequester {
     private readonly _api;
@@ -15,6 +16,7 @@ export default class DisplayLayoutRequester {
     private readonly _getParticipants;
     private readonly _isMe;
     private readonly _updateDisplayLayout;
+    private readonly _onNonFatalError;
     private _requestedLayouts;
     private _uncertainLayouts;
     private _pendingRequests;
@@ -25,7 +27,7 @@ export default class DisplayLayoutRequester {
     private _lastFlushAt;
     private _generation;
     private _forceNextFlush;
-    constructor({ api, debug, getParticipants, isMe, updateDisplayLayout }: DisplayLayoutRequesterParams);
+    constructor({ api, debug, getParticipants, isMe, updateDisplayLayout, onNonFatalError }: DisplayLayoutRequesterParams);
     request(requests: DisplayLayoutRequest[]): Promise<void>;
     resend(): void;
     cleanupParticipant(participantId: ParticipantId): void;

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 {
@@ -12,7 +12,7 @@ export default class StreamBuilder extends BaseStreamBuilder {
     private _webCodecsRetryAttempted;
     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

@@ -2,20 +2,29 @@ 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;
+    private _unloading;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
+    /**
+     * Вызывается из pagehide-обработчика: события финиша должны пережить смерть
+     * вкладки. Сводки пингов и команд сбрасываем здесь же — destroy() их только
+     * очищает.
+     */
+    prepareForUnload(): void;
+    /** Вкладка пережила pagehide: возвращаем запись в очередь. */
+    restoreAfterUnload(): 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/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,92 @@
+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;
+    /** Звонок завершился, пока шёл дрейн: его хвост не должен ждать таймаут тишины. */
+    private static _callFinishedDuringDrain;
+    private static _blockedSession;
+    /** Буфер прямой отправки: события, которые не легли в хранилище. */
+    private static _directBuffer;
+    private static _directTimer;
+    static setApi(value: BaseApi): void;
+    /** Первый дрейн подбирает хвосты прошлых сессий и закрытых вкладок. */
+    static start(value: BaseApi): void;
+    /** Вызывается коллектором после записи события в очередь. */
+    static notifyAppended(): void;
+    /**
+     * Звонок закончился: хвост уходит через секунду, а не через полминуты
+     * тишины. Секунда нужна, чтобы дописались все события финиша.
+     */
+    static notifyCallFinished(): void;
+    /**
+     * Один цикл отправки по всем владельцам очереди: текущий — живой сессией,
+     * остальные — сохранённым session_key. Хвост uid X уходит только под
+     * сессией uid X.
+     *
+     * @returns true, если у кого-то был полный батч и имеет смысл повторить.
+     */
+    static drainOnce(): Promise<boolean>;
+    /**
+     * FALLBACK для событий, не попавших в хранилище: копятся в памяти и уходят
+     * пачкой, без подтверждения и повтора.
+     *
+     * Чужие события не отправляются: запрос уходит под текущей сессией.
+     */
+    static sendDirect(entry: StatQueueEntry): void;
+    private static _currentUserId;
+    /** @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,50 @@
+import BaseApi from '../../abstract/BaseApi';
+import BaseLogger from '../../abstract/BaseLogger';
+import StatLog from '../../enums/StatLog';
+import TransportTopology from '../../enums/TransportTopology';
+type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
+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;
+    private readonly _externalLogger;
+    private readonly _conversationIdProvider;
+    private readonly _topologyProvider;
+    private _unloadMode;
+    /** Старая схема: не null, когда ручка выключена, тогда очередь не используется. */
+    private readonly _legacy;
+    constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
+    log(name: StatLog, value?: string, immediately?: boolean): void;
+    /**
+     * Переключает коллектор на синхронный localStorage-журнал: асинхронная
+     * запись в IndexedDB не переживает pagehide.
+     */
+    enterUnloadMode(): void;
+    /**
+     * Вкладка пережила pagehide (bfcache, отменённая навигация): возвращаемся
+     * на очередь и переносим в неё уже записанное в журнал.
+     */
+    exitUnloadMode(): void;
+    logClientStats(data: ClientStatsPayload, options?: LogClientStatsOptions): void;
+    destroy(): void;
+    private _store;
+    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 в сигналингу.
      * Будет произведен расчет времени между пингами.