@vkontakte/calls-sdk 2.8.13-dev.05e6b21e.0 → 2.8.13-dev.06c783b8.0

package/classes/AudioOutput.d.ts

@@ -1,7 +1,6 @@
 import { type DebugLogger } from '../static/Debug';
 import { ParticipantId } from '../types/Participant';
 import StatEventCollector from './stat/StatEventCollector';
-import { MediaStats } from './stat/MediaStats';
 import { StatFirstMediaReceived } from './stat/StatFirstMediaReceived';
 /**
  * Единый AudioOutput поддерживающий p2p, audioMix и transparent-audio
@@ -16,8 +15,7 @@ export default class AudioOutput {
     private readonly _features;
     private readonly _statFirstMediaReceived;
     private readonly _logger;
-    private readonly _mediaStats;
-    constructor(statFirstMediaReceived: StatFirstMediaReceived, allowMultipleTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null, mediaStats?: MediaStats | 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

@@ -5,7 +5,6 @@ import { type DebugLogger } from '../static/Debug';
 import MediaSettings, { IVideoDimentions } from '../types/MediaSettings';
 import { ScreenCaptureSettings } from '../types/ScreenCaptureSettings';
 import StatEventCollector from './stat/StatEventCollector';
-import { MediaStats } from './stat/MediaStats';
 export declare const enum MediaSourceEvent {
     SOURCE_CHANGED = "SOURCE_CHANGED",
     SOURCE_READY = "SOURCE_READY",
@@ -59,12 +58,11 @@ export declare class MediaSource extends EventEmitter {
     private readonly _videoEffectsFpsLimiter?;
     private readonly _debug;
     private readonly _logger;
-    private readonly _mediaStats;
     private _cameraTrackSetAt;
     private _cameraMuteRecoveredAt;
     private _micTrackSetAt;
     private _micMuteRecoveredAt;
-    constructor(debug?: DebugLogger, logger?: StatEventCollector | null, mediaStats?: MediaStats | 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/stat/ConversationStats.d.ts

@@ -6,7 +6,6 @@ import StatEventCollector from './StatEventCollector';
 import { ApiCallStats } from './ApiCallStats';
 import { CallLifecycleStats } from './CallLifecycleStats';
 import { CodecStatsAggregator } from './CodecStatsAggregator';
-import { MediaStats } from './MediaStats';
 import { StatAggregator } from './StatAggregator';
 import { StatPings } from './StatPings';
 import { StatSignalingCommands } from './StatSignalingCommands';
@@ -18,7 +17,6 @@ export declare class ConversationStats {
     readonly pings: StatPings;
     readonly signalingCommands: StatSignalingCommands;
     readonly apiCalls: ApiCallStats;
-    readonly media: MediaStats;
     private readonly _api;
     private _unloading;
     constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);

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

@@ -31,6 +31,10 @@ export default class DirectTransport extends BaseTransport {
     private _lastStat;
     private _fingerprint;
     private _neverConnected;
+    private _connectionStartedAt;
+    private _connectionLostAt;
+    /** Запросили переход на серверную топологию, не дождавшись первого подключения p2p */
+    private _serverRequestedOnNoConnection;
     private _serverSettings;
     private _prevConsumerSettings;
     private _networkLimitsForVideo;
@@ -40,6 +44,8 @@ export default class DirectTransport extends BaseTransport {
     private _perfStatReporter;
     private _directStatReporter;
     private readonly _sdpStats;
+    private readonly _peerConnectionStats;
+    private readonly _networkAdaptationStats;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;

package/classes/transport/PerfStatReporter.d.ts

@@ -10,6 +10,7 @@ export default class PerfStatReporter extends EventEmitter {
     private _previousCallStatReportTimestamp;
     private _previousCallStatReport;
     private _previousRemoteInboundRtps;
+    private _previousCandidatePair;
     private _screenShareStats;
     private _signaling;
     private readonly _directTopology;
@@ -22,6 +23,7 @@ export default class PerfStatReporter extends EventEmitter {
     private reportPerfStats;
     private reportNetworkStats;
     private _reportCallStats;
+    private _reportCandidatePair;
     private _calculatePacketLoss;
     private _handleScreenSharingStat;
     private _handleTransportStateChanged;

package/classes/transport/ServerTransport.d.ts

@@ -46,6 +46,7 @@ export default class ServerTransport extends BaseTransport {
     private readonly _logger;
     private readonly _statAggregator;
     private readonly _sdpStats;
+    private readonly _peerConnectionStats;
     private readonly _codecStatsAggregator;
     private readonly _simulcast;
     constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);

package/default/SignalingTransport.d.ts

@@ -4,6 +4,7 @@ import { DebugLogger } from '../static/Debug';
 export declare enum SignalingTransportFailure {
     EMPTY_ENDPOINT = "EMPTY_ENDPOINT",
     NETWORK_ERROR = "NETWORK_ERROR",
+    RECONNECT_TIMEOUT = "RECONNECT_TIMEOUT",
     ABORTED = "ABORTED"
 }
 export type SignalingTransportFailedEvent = {
@@ -40,6 +41,7 @@ export default class SignalingTransport {
     private connectionType;
     private reconnectCount;
     private reconnectTimer;
+    private reconnectDeadlineTimer;
     private doctorTimer;
     private forceWebSocket;
     private abortSignal;
@@ -54,7 +56,7 @@ export default class SignalingTransport {
     setPeerId(peerId: number | null): void;
     setLastStamp(lastStamp: number): void;
     setAbortSignal(signal?: AbortSignal): void;
-    resetReconnectCount(): void;
+    onConnectionRestored(): void;
     connect(connectionType: SignalingConnectionType): void;
     close(code?: number): void;
     send(data: string | ArrayBuffer): Promise<void>;
@@ -70,6 +72,8 @@ export default class SignalingTransport {
     private _onClose;
     private _disconnect;
     private _scheduleReconnect;
+    private _startReconnectDeadline;
+    private _stopReconnectDeadline;
     private _getReconnectDelay;
     private _startDoctor;
     private _stopDoctor;

package/enums/Stat.d.ts

@@ -18,6 +18,13 @@ declare enum Stat {
     SIGNALING_PING_SUMMARY = "signaling_ping_summary",
     SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
     API_CALL = "api_call",
+    CONNECTION_STATE_CHANGED = "connection_state_changed",
+    SIGNALING_STATE_CHANGED = "signaling_state_changed",
+    GATHERING_STATE_CHANGED = "gathering_state_changed",
+    ICE_RESTART = "ice_restart",
+    ICE_CANDIDATES_CHANGED = "ice_candidates_changed",
+    ICE_CANDIDATE_GATHERING_FAILED = "ice_candidate_gathering_failed",
+    ICE_CANDIDATE_ADD_FAILED = "ice_candidate_add_failed",
     SDP_CREATE_OFFER = "sdp_create_offer",
     SDP_CREATE_ANSWER = "sdp_create_answer",
     SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
@@ -30,9 +37,8 @@ declare enum Stat {
     SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
     SDP_GENERATED = "sdp_generated",
     SDP_RECEIVED = "sdp_received",
-    AUDIO_ERROR = "audio_error",
-    ML_READY_TO_USE = "ml_ready_to_use",
-    ML_ERROR = "ml_error",
+    CLIENT_REQUESTED_SERVER_TOPOLOGY = "client_requested_server_topology",
+    VIDEO_ENCODER_CHANGED_BY_NETWORK_ADAPTER = "video_encoder_changed_by_network_adapter",
     WEBSOCKET_CONNECTED = "websocket_connected",
     WEBSOCKET_RECONNECTED = "websocket_reconnected",
     WEBSOCKET_FAILED_PINGS = "websocket_failed_pings",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.13-dev.05e6b21e.0",
+  "version": "2.8.13-dev.06c783b8.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/Params.d.ts

@@ -115,6 +115,8 @@ export type ParamsObject = {
     /** @hidden */
     signalingReconnectMaxCount: number;
     /** @hidden */
+    signalingReconnectMaxDuration: number;
+    /** @hidden */
     waitConnectionDelay: number;
     /** @hidden */
     waitResponseDelay: number;
@@ -298,6 +300,13 @@ export type ParamsObject = {
     perfStatReportEnabled: boolean;
     /** @hidden */
     callStatReportEnabled: boolean;
+    /**
+     * Отправлять событие статистики ice_candidate_gathering_failed
+     *
+     * _По умолчанию: `false`_
+     * @hidden
+     */
+    iceCandidateErrorStatEnabled: boolean;
     /**
      * Отдавать приоритет кодеку H264 для исходящего видео
      *
@@ -1007,6 +1016,7 @@ export default abstract class Params {
     static get signalingReconnectDelay(): number;
     static get signalingReconnectMaxDelay(): number;
     static get signalingReconnectMaxCount(): number;
+    static get signalingReconnectMaxDuration(): number;
     static get waitConnectionDelay(): number;
     static get waitResponseDelay(): number;
     static get waitMessageDelay(): number;
@@ -1056,6 +1066,7 @@ export default abstract class Params {
     static get networkStatisticsInterval(): number;
     static get perfStatReportEnabled(): boolean;
     static get callStatReportEnabled(): boolean;
+    static get iceCandidateErrorStatEnabled(): boolean;
     static get enableLogPerfStatReport(): boolean;
     static get asrDataChannel(): boolean;
     static get consumerScreenDataChannelPacketSize(): number;
@@ -1127,6 +1138,7 @@ export default abstract class Params {
         videoSuspend: boolean;
         debugLog: boolean;
         callStatReportEnabled: boolean;
+        iceCandidateErrorStatEnabled: boolean;
         joinFromMultipleDevices: boolean;
         movieShare: boolean;
         clientType: string;

package/classes/stat/MediaStats.d.ts

@@ -1,22 +0,0 @@
-import { StatAggregator } from './StatAggregator';
-/** Идентификатор ML-модели, с которой работает SDK */
-export type MlSource = 'audio_effects';
-/** Отправляет в стату ошибки аудио-подсистемы и события ML-моделей */
-export declare class MediaStats {
-    private readonly _statAggregator;
-    constructor(statAggregator: StatAggregator | null);
-    /**
-     * Ошибка работы с аудио
-     *
-     * @param operation что делали: `init`, `start`, `stop` или `deinit`
-     */
-    logAudioError(operation: string, error?: unknown): void;
-    /**
-     * Модель скачалась и готова к работе
-     *
-     * @param duration сколько заняла подготовка модели, мс
-     */
-    logMlReady(source: MlSource, duration: number): void;
-    /** Модель не подготовилась или упала в работе */
-    logMlError(source: MlSource, error?: unknown): void;
-}