@vkontakte/calls-sdk 2.8.13-beta.1 → 2.8.13-beta.11

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
@@ -8,14 +8,15 @@ import { StatFirstMediaReceived } from './stat/StatFirstMediaReceived';
 export default class AudioOutput {
     protected _audioElement: HTMLAudioElement | null;
     protected readonly _debug: DebugLogger;
-    private readonly _preparedAudioElement;
+    private _preparedAudioElement;
     private _audioTracks;
     private readonly _allowMultipleTracks;
     private _volume;
     private readonly _features;
     private readonly _statFirstMediaReceived;
     private readonly _logger;
-    constructor(statFirstMediaReceived: StatFirstMediaReceived, allowMultipleTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null);
+    private _autoplayRecoveryController;
+    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;
@@ -26,6 +27,7 @@ export default class AudioOutput {
     protected _getTracks(): MediaStreamTrack[];
     protected _initAudioElement(): void;
     protected _stopAudioElement(): void;
+    private _stopAutoplayRecovery;
     private _createAudioElement;
     private _prepareAudioElement;
     private _addTrackToAudioElement;

package/classes/MediaSource.d.ts

@@ -1,10 +1,11 @@
 import type { IEffect } from '@vkontakte/calls-video-effects';
 import EventEmitter from '../classes/EventEmitter';
+import ActiveFeature from '../enums/ActiveFeature';
 import MediaOption from '../enums/MediaOption';
 import { type DebugLogger } from '../static/Debug';
 import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
 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 +61,9 @@ export declare class MediaSource extends EventEmitter {
     private readonly _logger;
     private _cameraTrackSetAt;
     private _cameraMuteRecoveredAt;
-    constructor(debug?: DebugLogger, logger?: StatsLogger | null);
+    private _micTrackSetAt;
+    private _micMuteRecoveredAt;
+    constructor(debug?: DebugLogger, logger?: StatEventCollector | null);
     get cameraVideoTrack(): MediaStreamTrack | null;
     set cameraVideoTrack(track: MediaStreamTrack | null);
     request(mediaOptions?: MediaOption[], needEmptyTracks?: boolean): Promise<void>;
@@ -75,6 +78,8 @@ export declare class MediaSource extends EventEmitter {
      */
     getMediaSettings(): MediaSettings;
     get mediaSettings(): MediaSettings;
+    /** Что сейчас включено у пользователя — для метрики active_features */
+    get activeFeatures(): ActiveFeature[];
     changeDevice(kind: MediaDeviceKind): Promise<void>;
     /**
      * Установка кастомного стрима для видео, например внешний шаринг экрана
@@ -83,6 +88,7 @@ export declare class MediaSource extends EventEmitter {
      * @hidden
      */
     setVideoStream(stream: MediaStream, isScreen: boolean): Promise<void>;
+    private _setMicAudioTrack;
     private _initDeviceChangeListener;
     private _destroyDeviceChangeListener;
     private _changeVideoInput;
@@ -109,6 +115,7 @@ export declare class MediaSource extends EventEmitter {
     toggleScreenCapturing(settings: ScreenCaptureSettings): Promise<void>;
     disableScreenCapturing(): Promise<void>;
     private videoTrackMuteHandler;
+    private micTrackMuteHandler;
     toggleVideo(enabled: boolean): Promise<void>;
     toggleAudio(enabled: boolean): Promise<void>;
     toggleAnimojiCapturing(enabled: boolean): 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/StatsLogger.d.ts

@@ -2,7 +2,7 @@ import BaseApi from '../abstract/BaseApi';
 import BaseLogger from '../abstract/BaseLogger';
 import StatLog from '../enums/StatLog';
 import TransportTopology from '../enums/TransportTopology';
-type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
+type ClientStatsPayload = Record<string, string | string[] | number | boolean | undefined | null>;
 export type LogClientStatsOptions = {
     immediately?: boolean;
     occurredAt?: number;

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

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

package/classes/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/ApiCallStats.d.ts

@@ -0,0 +1,12 @@
+import { StatAggregator } from './StatAggregator';
+/** Отправляет в стату время выполнения запросов к API */
+export declare class ApiCallStats {
+    private readonly _statAggregator;
+    constructor(statAggregator: StatAggregator | null);
+    /**
+     * @param method название метода API, например `vchat.getConversationParams`
+     * @param duration время от запроса до ответа, мс
+     * @param error описание ошибки, если запрос не удался
+     */
+    log(method: string, duration: number, error?: string): void;
+}

package/classes/stat/BatteryStats.d.ts

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

package/classes/stat/CallLifecycleStats.d.ts

@@ -1,4 +1,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/ClientResourceStats.d.ts

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

package/classes/stat/CodecStatsAggregator.d.ts

@@ -1,5 +1,5 @@
 import { StatItem } from '../../types/Statistics';
-import 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,37 @@ import BaseApi from '../../abstract/BaseApi';
 import BaseLogger from '../../abstract/BaseLogger';
 import TransportTopology from '../../enums/TransportTopology';
 import HangupReason from '../HangupReason';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from './StatEventCollector';
+import { ApiCallStats } from './ApiCallStats';
+import { BatteryStats } from './BatteryStats';
 import { CallLifecycleStats } from './CallLifecycleStats';
+import { ClientResourceSources, ClientResourceStats } from './ClientResourceStats';
 import { CodecStatsAggregator } from './CodecStatsAggregator';
 import { StatAggregator } from './StatAggregator';
 import { StatPings } from './StatPings';
 import { StatSignalingCommands } from './StatSignalingCommands';
 export declare class ConversationStats {
-    readonly logger: StatsLogger;
+    readonly logger: StatEventCollector;
     readonly lifecycle: CallLifecycleStats;
     readonly statAggregator: StatAggregator;
     readonly codecStatsAggregator: CodecStatsAggregator;
     readonly pings: StatPings;
     readonly signalingCommands: StatSignalingCommands;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
+    readonly apiCalls: ApiCallStats;
+    readonly resources: ClientResourceStats;
+    readonly battery: BatteryStats;
+    private readonly _api;
+    private _unloading;
+    constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined, resourceSources: ClientResourceSources);
+    /**
+     * Вызывается из pagehide-обработчика: события финиша должны пережить смерть
+     * вкладки. Сводки пингов и команд сбрасываем здесь же — destroy() их только
+     * очищает.
+     */
+    prepareForUnload(): void;
+    /** Вкладка пережила pagehide: возвращаем запись в очередь. */
+    restoreAfterUnload(): void;
+    resetPingBaseline(): void;
     logHangup(reason: HangupReason): void;
     flushCallMetrics(): void;
     destroy(): void;

package/classes/stat/NetworkAdaptationStats.d.ts

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

package/classes/stat/PeerConnectionStats.d.ts

@@ -0,0 +1,22 @@
+import { StatAggregator } from './StatAggregator';
+/** Стата жизненного цикла RTCPeerConnection */
+export declare class PeerConnectionStats {
+    private readonly _statAggregator;
+    private _pc;
+    private _lastSignalingStateChange;
+    private _lastGatheringStateChange;
+    private _lastConnectionState;
+    private readonly _handleConnectionStateChange;
+    private readonly _handleSignalingStateChange;
+    private readonly _handleGatheringStateChange;
+    private readonly _handleIceCandidateError;
+    constructor(statAggregator: StatAggregator | null);
+    observe(pc: RTCPeerConnection): void;
+    /** Вызывать перед закрытием соединения: отсюда уходят последнее состояние и closed */
+    stop(): void;
+    logIceRestart(): void;
+    logIceCandidateAddFailed(candidate: RTCIceCandidateInit, error: unknown): void;
+    private _sinceLastChange;
+    private _logConnectionState;
+    private _log;
+}

package/classes/stat/SdpStats.d.ts

@@ -0,0 +1,40 @@
+import { StatAggregator } from './StatAggregator';
+type SdpDescription = {
+    type: RTCSdpType;
+    sdp?: string;
+};
+/**
+ * Отправляет в стату согласование SDP: что сгенерировали, что получили от собеседника
+ * и на какой операции сломались.
+ */
+export declare class SdpStats {
+    private readonly _statAggregator;
+    private _pc;
+    private _gatheringStartedAt;
+    private _remoteSdpReceivedAt;
+    private readonly _handleGatheringStateChange;
+    constructor(statAggregator: StatAggregator | null);
+    /** Начинает следить за сбором кандидатов, предыдущее соединение перестает слушать */
+    observe(pc: RTCPeerConnection): void;
+    stop(): void;
+    /** Сгенерировали свой SDP */
+    logSdpGenerated(type: RTCSdpType): void;
+    /** Собрали свой ICE-кандидат */
+    logCandidateGenerated(candidate: RTCIceCandidate): void;
+    /** Получили SDP от собеседника */
+    logSdpReceived(type: RTCSdpType): void;
+    /** Получили ICE-кандидата от собеседника */
+    logCandidateReceived(candidate: RTCIceCandidateInit): void;
+    /** Не смогли сгенерировать SDP */
+    logCreateFailed(type: RTCSdpType, error: unknown): void;
+    /** Не смогли применить свой SDP */
+    logSetLocalFailed(sdp: SdpDescription, error: unknown): void;
+    /** Не смогли применить SDP собеседника */
+    logSetRemoteFailed(sdp: SdpDescription, error: unknown): void;
+    destroy(): void;
+    private _logFailure;
+    private _log;
+}
+/** Браузер может спрятать локальный адрес за именем вида <uuid>.local, такой кандидат в стату не шлём */
+export declare function isIpAddress(address: string): boolean;
+export {};

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

@@ -0,0 +1,10 @@
+import type { MockInstance } from 'vitest';
+/**
+ * Дожидается работы, которую код запускает в фоне и не отдаёт промис: ждёт всё,
+ * что вернули вызовы шпионов, пока не перестанут появляться новые вызовы.
+ *
+ * Замена опросу vi.waitFor: тот сдаётся через секунду, а IndexedDB на
+ * загруженной машине отвечает дольше. Шпионы должны пропускать вызов к
+ * настоящему методу (vi.spyOn без подмены).
+ */
+export declare function settleCalls(...spies: MockInstance[]): Promise<void>;

package/classes/stat/StatAggregator.d.ts

@@ -1,14 +1,23 @@
 import { ICallStatLog } from '../../types/PerfStatReporter';
 import { IEventualStatLog } from '../../types/IEventualStatLog';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from './StatEventCollector';
+import { ClientResourceStats } from './ClientResourceStats';
 export declare class StatAggregator {
     private readonly _logger;
+    private readonly _resources;
     private readonly _eventualLogs;
     private _lastCallStatContext;
-    constructor(logger: StatsLogger);
+    constructor(logger: StatEventCollector, resources?: ClientResourceStats | null);
     logCallStat(params: ICallStatLog): void;
-    /** @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588 */
+    /**
+     * Событие уходит с теми полями, что переданы. Без value — уходит без value.
+     * @link https://wiki.odkl.ru/pages/viewpage.action?pageId=100892588
+     */
     logEventualStat(params: IEventualStatLog): void;
+    /** value — время от метки с тем же именем, что у события. Метки нет — событие не отправляем. */
+    logEventualStatSinceMark(params: IEventualStatLog & {
+        value?: never;
+    }): void;
     destroy(): void;
     private _getCallStatContext;
     private _flushEventualStats;

package/classes/stat/StatClock.d.ts

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