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

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';
@@ -39,12 +39,11 @@ export default class DirectTransport extends BaseTransport {
     private _lastBadConnection;
     private _perfStatReporter;
     private _directStatReporter;
-    private readonly _sdpStats;
     private readonly _debug;
     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;
@@ -73,6 +72,10 @@ export default class DirectTransport extends BaseTransport {
     private _markConnected;
     private _onConnectionStateChange;
     private _startReconnection;
+    /**
+     * Запрашивает у сигналинга переход на серверную топологию.
+     * Обычно это делает только мастер, `fromAnySide` снимает это ограничение.
+     */
     private _requestTopologySwitch;
     private _stopReconnection;
     private _startIceRestart;

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';
@@ -45,10 +45,9 @@ export default class ServerTransport extends BaseTransport {
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
-    private readonly _sdpStats;
     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;

package/classes/transport/SimulcastSender.d.ts

@@ -2,7 +2,7 @@ import BaseSignaling from '../../abstract/BaseSignaling';
 import { type DebugLogger } from '../../static/Debug';
 import type VideoSettings from '../../types/VideoSettings';
 import { MediaSource } from '../MediaSource';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 export default class SimulcastSender {
     private _pc;
     private _transceiver;
@@ -12,7 +12,7 @@ export default class SimulcastSender {
     private readonly _getCameraSettings;
     private readonly _debug;
     private readonly _logger;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatsLogger | null);
+    constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatEventCollector | null);
     configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
     finalizeAnswer(sdp: string): string;
     sync({ force }?: {

package/classes/transport/Transport.d.ts

@@ -6,7 +6,7 @@ import { type DebugLogger } from '../../static/Debug';
 import { ParticipantId } from '../../types/Participant';
 import ServerSettings from '../../types/ServerSettings';
 import EventEmitter from '../EventEmitter';
-import StatsLogger from '../StatsLogger';
+import StatEventCollector from '../stat/StatEventCollector';
 import { MediaSource } from '../MediaSource';
 import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
 import { StatAggregator } from '../stat/StatAggregator';
@@ -51,7 +51,7 @@ export declare class Transport extends EventEmitter {
     private readonly _onFirstMediaSent;
     private _firstMediaSentProbeStopped;
     private _vadController;
-    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
+    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null, onFirstMediaSent?: (() => void) | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
     allocate(participantId: ParticipantId, isMaster?: boolean): void;

package/default/Api.d.ts

@@ -14,14 +14,23 @@ export default class Api extends BaseApi {
     protected _call(method: string, data?: any, noSession?: boolean, allowReauthorize?: boolean): Promise<any>;
     userId(participantId: ParticipantId): ExternalParticipantId | null;
     authorize(): Promise<void>;
+    /** Запрос auth.anonymLogin без побочных эффектов. Пустой токен — версия 2. */
+    private _anonymLogin;
     private _getAnonymLoginCacheKey;
     private _getCachedAnonymLogin;
     private _setCachedAnonymLogin;
     private _removeCachedAnonymLogin;
     private _reauthorize;
     private _applyAnonymLogin;
+    private _buildClientStatsData;
+    /** Ошибки по отдельным событиям логируются, но батч трактуется целиком. */
+    private _reportClientStatsItemErrors;
+    /** noSession = true, иначе _prepareQuery перебил бы явный session_key. */
+    private _sendClientStatsWith;
+    /** Бекенд отвечает 200 всегда: ошибки статистики лежат в теле. */
     private _sendClientStats;
-    logClientStats(items: ClientStats[]): void;
+    logClientStats(items: ClientStats[]): Promise<void>;
+    logClientStatsWith(sessionKey: string, items: ClientStats[]): Promise<void>;
     uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
     joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
     createConversation(conversationId: string, payload?: string, requireAuthToJoin?: boolean, { onlyAdminCanShareMovie, audienceMode, audioOnly, waitForAdmin, closedConversation, }?: {

package/default/Signaling.d.ts

@@ -4,7 +4,7 @@ import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
 import { StatAggregator } from '../classes/stat/StatAggregator';
 import { StatPings } from '../classes/stat/StatPings';
 import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
-import StatsLogger from '../classes/StatsLogger';
+import StatEventCollector from '../classes/stat/StatEventCollector';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
@@ -56,7 +56,7 @@ export default class Signaling extends BaseSignaling {
     private static get WAIT_CONNECTION_DELAY();
     private static get WAIT_RESPONSE_DELAY();
     get ready(): boolean;
-    constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
+    constructor(debug?: DebugLogger, logger?: StatEventCollector | null, statAggregator?: StatAggregator | null, statPings?: StatPings | null, statSignalingCommands?: StatSignalingCommands | null);
     setAbortSignal(signal: AbortSignal | undefined): void;
     setEndpoint(endpoint: string): void;
     setWebTransportEndpoint(endpoint: string | null): void;

package/enums/SessionError.d.ts

@@ -0,0 +1,10 @@
+/** Коды ошибок сессии API. */
+declare enum SessionError {
+    PARAM_SESSION_EXPIRED = 102,
+    PARAM_SESSION_KEY = 103,
+    PARAM_SIGNATURE = 104,
+    AUTH_LOGIN = 401
+}
+/** Ошибки, после которых имеет смысл переавторизоваться. 401 — токен хоста. */
+export declare function isSessionErrorCode(code: unknown): boolean;
+export default SessionError;

package/enums/Stat.d.ts

@@ -14,18 +14,6 @@ declare const enum Stat {
     USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
     SIGNALING_PING_SUMMARY = "signaling_ping_summary",
     SIGNALING_COMMAND_SUMMARY = "signaling_command_summary",
-    SDP_CREATE_OFFER = "sdp_create_offer",
-    SDP_CREATE_ANSWER = "sdp_create_answer",
-    SDP_SET_LOCAL_OFFER = "sdp_set_local_offer",
-    SDP_SET_LOCAL_PRANSWER = "sdp_set_local_pranswer",
-    SDP_SET_LOCAL_ANSWER = "sdp_set_local_answer",
-    SDP_SET_LOCAL_ROLLBACK = "sdp_set_local_rollback",
-    SDP_SET_REMOTE_OFFER = "sdp_set_remote_offer",
-    SDP_SET_REMOTE_PRANSWER = "sdp_set_remote_pranswer",
-    SDP_SET_REMOTE_ANSWER = "sdp_set_remote_answer",
-    SDP_SET_REMOTE_ROLLBACK = "sdp_set_remote_rollback",
-    SDP_GENERATED = "sdp_generated",
-    SDP_RECEIVED = "sdp_received",
     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.41a8e3bd.0",
+  "version": "2.8.13-dev.500f95ef.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/ApiTransport.d.ts

@@ -1,5 +1,9 @@
 import { IAPIBaseUrl, IApiEnv } from '../types/Params';
 export declare function resetApiEndpoint(): void;
+/**
+ * Убираем слэш на конце
+ */
+export declare function sanitizeApiBaseUrl(url: IAPIBaseUrl): IAPIBaseUrl;
 export declare function _resolveApiEndpoint(apiBaseUrl?: IAPIBaseUrl, apiEnv?: IApiEnv): Promise<string>;
 export declare function sendBeakon(method: string, params?: {
     [key: string]: any;

package/static/Params.d.ts

@@ -42,6 +42,22 @@ export type ParamsObject = {
      * По умолчанию `'0.0.0'`
      */
     appVersion: string;
+    /**
+     * Автоматически запускать отправку клиентской статистики при `init()`.
+     *
+     * При `false` события копятся в очереди, но не уходят в сеть, пока хост не
+     * вызовет `startStats()`.
+     *
+     * _По умолчанию: `true`_
+     */
+    autoStartStats: boolean;
+    /**
+     * Персистентная очередь клиентской статистики: события копятся в IndexedDB
+     * и уезжают пачками с подтверждением, переживая перезагрузку вкладки.
+     *
+     * _По умолчанию: `false`_
+     */
+    statQueueEnabled: boolean;
     /** @hidden */
     clientType: string;
     /** @hidden */
@@ -235,6 +251,13 @@ export type ParamsObject = {
     iceRestartWaitTime: number;
     /** @hidden */
     transportConnectionWaitTime: number;
+    /**
+     * Разрешить запрашивать переход на серверную топологию не только звонящему,
+     * но и принимающей стороне, если не удалось восстановить оборвавшееся p2p-соединение
+     *
+     * _По умолчанию: `false`_
+     */
+    switchTopologyOnReconnectFromAnySide: boolean;
     /**
      * Частота получения статистики в миллисекундах
      *
@@ -946,6 +969,8 @@ export default abstract class Params {
     static set platform(value: string);
     static get clientStatsPlatform(): string;
     static set clientStatsPlatform(value: string);
+    static get autoStartStats(): boolean;
+    static get statQueueEnabled(): boolean;
     static get clientType(): string;
     static set clientType(value: string);
     static get externalUserType(): string;
@@ -1018,6 +1043,7 @@ export default abstract class Params {
     };
     static get iceRestartWaitTime(): number;
     static get transportConnectionWaitTime(): number;
+    static get switchTopologyOnReconnectFromAnySide(): boolean;
     static get statisticsInterval(): number;
     static set statisticsInterval(value: number);
     static get networkStatisticsInterval(): number;
@@ -1099,6 +1125,8 @@ export default abstract class Params {
         clientType: string;
         clientStatsPlatform: string;
         appVersion: string;
+        autoStartStats: boolean;
+        statQueueEnabled: boolean;
         consumerScreenDataChannelPacketSize: number;
         switchVideoAtBadNetwork: boolean;
         simulcast: boolean;

package/static/SessionStore.d.ts

@@ -0,0 +1,29 @@
+export type StoredSession = {
+    sessionKey: string;
+    /** Ключ окружения на момент сохранения, см. currentEndpoint(). */
+    endpoint: string;
+    savedAt: number;
+};
+/**
+ * Снимки сессий по uid на диске. Снимок может быть протухшим и переавторизации
+ * не подлежит, поэтому годится только для отложенных best-effort задач вроде
+ * досылки статистики.
+ */
+export default abstract class SessionStore {
+    static remember(uid: number, session: {
+        sessionKey: string;
+        endpoint: string;
+    }): void;
+    static get(uid: number): StoredSession | null;
+    static forget(uid: number): void;
+    /** Снимок живёт столько же, сколько события, которые он мог бы дослать. */
+    static prune(now?: number): void;
+    /**
+     * Ключ окружения: сессия прода не должна улететь на тестовый кластер.
+     * Адрес нормализуется так же, как в транспорте.
+     */
+    static currentEndpoint(): string;
+    private static _read;
+    private static _write;
+    private static _isValid;
+}

package/static/WebRTCUtils.d.ts

@@ -2,7 +2,7 @@
  * Вспомогательный плагин для работы с WebRTC
  */
 import { IVideoDimentions } from '../types/MediaSettings';
-import type StatsLogger from '../classes/StatsLogger';
+import type StatEventCollector from '../classes/stat/StatEventCollector';
 import { type DebugLogger } from './Debug';
 /**
  * Тип камеры мобильного устройства
@@ -85,24 +85,24 @@ declare namespace WebRTCUtils {
      * @param needAudio Нужно ли аудио
      * @param needEmptyTracks Добавлять ли в стрим пустые треки для отключенного видео/аудио
      */
-    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserMedia(needVideo?: boolean, needAudio?: boolean, needEmptyTracks?: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает трансляцию экрана пользователя с опциональным захватом звука
      */
-    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getScreenMedia(fastScreenShare: boolean, withAudioShare: boolean, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает камеру пользователя
      *
      * @param deviceId ID устройства
      * @param resolution Размеры видео
      */
-    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserVideo(deviceId?: string, resolution?: IVideoDimentions, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Запрашивает микрофон пользователя
      *
      * @param deviceId ID устройства
      */
-    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatsLogger | null): Promise<MediaStream>;
+    function getUserAudio(deviceId?: string, debug?: DebugLogger, logger?: StatEventCollector | null): Promise<MediaStream>;
     /**
      * Устанавливает размер видео в стриме
      *

package/classes/stat/SdpStats.d.ts

@@ -1,38 +0,0 @@
-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;
-}
-export {};