@vkontakte/calls-sdk 2.8.11-dev.185dd9e4.0 → 2.8.11-dev.1cb064f7.0

package/classes/stat/ConversationStats.d.ts

@@ -0,0 +1,21 @@
+import BaseApi from '../../abstract/BaseApi';
+import BaseLogger from '../../abstract/BaseLogger';
+import HangupReason from '../HangupReason';
+import StatsLogger from '../StatsLogger';
+import TransportTopology from '../../enums/TransportTopology';
+import { CodecStatsAggregator } from './CodecStatsAggregator';
+import { StatAggregator } from './StatAggregator';
+import { StatPings } from './StatPings';
+import { StatSignalingCommands } from './StatSignalingCommands';
+export declare class ConversationStats {
+    readonly logger: StatsLogger;
+    readonly statAggregator: StatAggregator;
+    readonly codecStatsAggregator: CodecStatsAggregator;
+    readonly pings: StatPings;
+    readonly signalingCommands: StatSignalingCommands;
+    constructor(api: BaseApi, externalLogger: BaseLogger | null, getConversationId: () => string | null, getTopology: () => TransportTopology | undefined);
+    logHangup(reason: HangupReason, topology?: TransportTopology): void;
+    flushCallMetrics(topology?: TransportTopology): void;
+    destroy(): void;
+    private static correctHangupReason;
+}

package/classes/stat/StatAggregator.d.ts

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

package/classes/stat/StatFirstMediaReceived.d.ts

@@ -1,4 +1,5 @@
-import { TransportTopology } from '../transport/Transport';
+import TransportTopology from '../../enums/TransportTopology';
+import { StatAggregator } from './StatAggregator';
 /** связанный с операцией `first_media_received` тип логируемого звонка */
 declare enum ECallType {
     DirectOutgoing = "direct_outgoing",
@@ -8,10 +9,12 @@ declare enum ECallType {
     ServerChangeTopology = "server_change_topology"
 }
 export declare class StatFirstMediaReceived {
+    private readonly _statAggregator;
     /** уже поставили засечку на приём звонка */
     protected _isCallMarked: boolean;
     protected _isFinished: boolean;
     protected _callType: ECallType | null;
+    constructor(statAggregator: StatAggregator);
     markAcceptCall(topology: TransportTopology): void;
     markAcceptedCall(topology?: TransportTopology): void;
     markParticipantJoined(topology: TransportTopology): void;

package/classes/stat/StatPings.d.ts

@@ -1,17 +1,17 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import { TransportTopology } from '../transport/Transport';
+import StatsLogger from '../StatsLogger';
+import TransportTopology from '../../enums/TransportTopology';
 export declare class StatPings {
-    private static _instance?;
-    static create(): void;
+    private readonly _logger;
+    private trackerByTransport;
+    private lastSeen;
+    constructor(logger: StatsLogger);
     /**
      * Вызывать при входящем ping в сигналингу.
      * Будет произведен расчет времени между пингами.
      */
-    static mark(transport: SignalingTransportType): void;
+    mark(transport: SignalingTransportType): void;
     /** Отправляем данные в стату */
-    static logMetrics(topology?: TransportTopology): void;
-    static destroy(): void;
-    private trackerByTransport;
-    private lastSeen;
-    private _destroy;
+    logMetrics(topology?: TransportTopology): void;
+    destroy(): void;
 }

package/classes/stat/StatScreenShareFirstFrame.d.ts

@@ -1,7 +1,9 @@
 import { ParticipantId } from '../../types/Participant';
+import { StatAggregator } from './StatAggregator';
 export declare class StatScreenShareFirstFrame {
     protected readonly _participantId: ParticipantId;
+    private readonly _statAggregator;
     protected _firstFrameReceived: boolean;
-    constructor(participantId: ParticipantId);
+    constructor(participantId: ParticipantId, statAggregator: StatAggregator | null);
     measure(width: number, height: number): void;
 }

package/classes/stat/StatSignalingCommands.d.ts

@@ -1,12 +1,12 @@
 import { SignalingTransportType } from '../../enums/SignalingTransportStat';
-import { TransportTopology } from '../transport/Transport';
+import StatsLogger from '../StatsLogger';
+import TransportTopology from '../../enums/TransportTopology';
 export declare class StatSignalingCommands {
-    private static _instance?;
-    static create(): void;
-    static mark(command: string, time: number, transport: SignalingTransportType): void;
-    /** Отправляем данные в стату */
-    static logMetrics(topology?: TransportTopology): void;
-    static destroy(): void;
+    private readonly _logger;
     private trackerByCommand;
-    private _destroy;
+    constructor(logger: StatsLogger);
+    mark(command: string, time: number, transport: SignalingTransportType): void;
+    /** Отправляем данные в стату */
+    logMetrics(topology?: TransportTopology): void;
+    destroy(): void;
 }

package/classes/transport/BaseTransport.d.ts

@@ -1,7 +1,7 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import TransportState from '../../enums/TransportState';
 import EventEmitter from '../EventEmitter';
 import { MediaSource } from '../MediaSource';
-import { TransportState } from './Transport';
 export default abstract class BaseTransport extends EventEmitter {
     protected readonly _signaling: BaseSignaling;
     protected readonly _mediaSource: MediaSource;

package/classes/transport/DirectStatReporter.d.ts

@@ -1,4 +1,5 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import { StatResult } from '../../types/Statistics';
 import EventEmitter from '../EventEmitter';
 import { WeightedAverage } from '../stat/WeightedAverage';
@@ -30,7 +31,8 @@ export default class DirectStatReporter extends EventEmitter {
     private readonly _networkLimits;
     private _lastStatSentTimestamp;
     private _currentState;
-    constructor(signaling: BaseSignaling);
+    private readonly _debug;
+    constructor(signaling: BaseSignaling, debug?: DebugLogger);
     private _calcRttRating;
     private _calcLossRating;
     private _calcBitrateRating;

package/classes/transport/DirectTransport.d.ts

@@ -1,8 +1,12 @@
 import type { AnimojiReceiver, AnimojiSender } from '@vkontakte/calls-vmoji';
 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 { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 import BaseTransport from './BaseTransport';
 export default class DirectTransport extends BaseTransport {
     private readonly _participantId;
@@ -34,7 +38,11 @@ export default class DirectTransport extends BaseTransport {
     private _lastBadConnection;
     private _perfStatReporter;
     private _directStatReporter;
-    constructor(participantId: ParticipantId, isMaster: boolean, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    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);
     get participantId(): ParticipantId;
     updateStatisticsInterval(): void;
     private _isDeadConnection;

package/classes/transport/PerfStatReporter.d.ts

@@ -1,5 +1,7 @@
 import BaseSignaling from '../../abstract/BaseSignaling';
+import { type DebugLogger } from '../../static/Debug';
 import EventEmitter from '../EventEmitter';
+import { StatAggregator } from '../stat/StatAggregator';
 import DirectTransport from './DirectTransport';
 import ServerTransport from './ServerTransport';
 export default class PerfStatReporter extends EventEmitter {
@@ -10,7 +12,9 @@ export default class PerfStatReporter extends EventEmitter {
     private _screenShareStats;
     private _signaling;
     private readonly _directTopology;
-    constructor(transport: ServerTransport | DirectTransport, signaling: BaseSignaling, directTopology?: boolean);
+    private readonly _debug;
+    private readonly _statAggregator;
+    constructor(transport: ServerTransport | DirectTransport, signaling: BaseSignaling, statAggregator?: StatAggregator | null, directTopology?: boolean, debug?: DebugLogger);
     destroy(): void;
     static getEstimatedPerformanceIndex(): number;
     private _handleStats;

package/classes/transport/ServerTransport.d.ts

@@ -1,8 +1,12 @@
 import type { AnimojiReceiver, AnimojiSender } from '@vkontakte/calls-vmoji';
 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 { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 import BaseTransport from './BaseTransport';
 export default class ServerTransport extends BaseTransport {
     private _producerNotification;
@@ -39,7 +43,11 @@ export default class ServerTransport extends BaseTransport {
     private _producerSessionId;
     private _newAudioShareTrack;
     private _simulcastInfo;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    constructor(signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
     close(error?: Error): void;
@@ -88,7 +96,7 @@ export default class ServerTransport extends BaseTransport {
     private _onAsrTranscription;
     private _onProducerUpdated;
     private _onAddTrack;
-    static _onSignalingStateChange(pc: RTCPeerConnection, event: any): void;
+    private _onSignalingStateChange;
     private _onConnectionStateChange;
     private _onReplacedTrack;
     private _onSourcesChanged;

package/classes/transport/Transport.d.ts

@@ -1,9 +1,15 @@
 import type { AnimojiSvgData, RGBTuple } from '@vkontakte/calls-vmoji';
 import BaseSignaling from '../../abstract/BaseSignaling';
+import TransportState from '../../enums/TransportState';
+import TransportTopology from '../../enums/TransportTopology';
+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 { MediaSource } from '../MediaSource';
+import { CodecStatsAggregator } from '../stat/CodecStatsAggregator';
+import { StatAggregator } from '../stat/StatAggregator';
 export declare const enum TransportEvent {
     REMOTE_TRACK_ADDED = "REMOTE_TRACK_ADDED",
     REMOTE_TRACK_REMOVED = "REMOTE_TRACK_REMOVED",
@@ -23,19 +29,6 @@ export declare const enum TransportEvent {
     ANIMOJI_ERROR = "ANIMOJI_ERROR",
     SCREEN_SHARING_STAT = "SCREEN_SHARING_STAT"
 }
-export declare const enum TransportState {
-    IDLE = "IDLE",
-    OPENED = "OPENED",
-    CONNECTING = "CONNECTING",
-    RECONNECTING = "RECONNECTING",
-    CONNECTED = "CONNECTED",
-    CLOSED = "CLOSED",
-    FAILED = "FAILED"
-}
-export declare const enum TransportTopology {
-    DIRECT = "DIRECT",
-    SERVER = "SERVER"
-}
 export declare class Transport extends EventEmitter {
     private readonly _signaling;
     private readonly _mediaSource;
@@ -51,7 +44,11 @@ export declare class Transport extends EventEmitter {
     private _localState;
     private _animojiReceiver;
     private _animojiSender;
-    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings);
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _codecStatsAggregator;
+    constructor(topology: TransportTopology, signaling: BaseSignaling, mediaSource: MediaSource, serverSettings: ServerSettings, debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, codecStatsAggregator?: CodecStatsAggregator | null);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
     allocate(participantId: ParticipantId, isMaster?: boolean): void;

package/default/Signaling.d.ts

@@ -1,13 +1,18 @@
 import BaseSignaling, { AddParticipantParams } from '../abstract/BaseSignaling';
+import StatsLogger from '../classes/StatsLogger';
 import { ParticipantIdRegistry } from '../classes/ParticipantIdRegistry';
 import { SharingStatReport } from '../classes/screenshare/SharingStatReport';
-import { TransportTopology } from '../classes/transport/Transport';
+import { StatAggregator } from '../classes/stat/StatAggregator';
+import { StatPings } from '../classes/stat/StatPings';
+import { StatSignalingCommands } from '../classes/stat/StatSignalingCommands';
+import TransportTopology from '../enums/TransportTopology';
 import ConversationFeature from '../enums/ConversationFeature';
 import ConversationOption from '../enums/ConversationOption';
 import MediaOption from '../enums/MediaOption';
 import SignalingCommandType from '../enums/SignalingCommandType';
 import SignalingConnectionType from '../enums/SignalingConnectionType';
 import UserRole from '../enums/UserRole';
+import { type DebugLogger } from '../static/Debug';
 import { JSONObject } from '../static/Json';
 import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
 import { ChangeSimulcast } from '../types/ChangeSimulcast';
@@ -49,12 +54,18 @@ export default class Signaling extends BaseSignaling {
     private producerCommandDataChannel;
     private producerCommandDataChannelEnabled;
     private producerCommandSerializationService;
+    private readonly _debug;
+    private readonly _logger;
+    private readonly _statAggregator;
+    private readonly _pings;
+    private readonly _signalingCommands;
     private static get RECONNECT_DELAY();
     private static get RECONNECT_MAX_DELAY();
     private static get RECONNECT_MAX_COUNT();
     private static get WAIT_CONNECTION_DELAY();
     private static get WAIT_RESPONSE_DELAY();
     private static get WAIT_MESSAGE_DELAY();
+    constructor(debug?: DebugLogger, logger?: StatsLogger | null, statAggregator?: StatAggregator | null, pings?: StatPings | null, signalingCommands?: StatSignalingCommands | null);
     get ready(): boolean;
     setEndpoint(endpoint: string): void;
     setWebTransportEndpoint(endpoint: string | null): void;

package/enums/SignalingNotification.d.ts

@@ -50,6 +50,7 @@ declare enum SignalingNotification {
     ASR_STARTED = "asr-started",
     ASR_STOPPED = "asr-stopped",
     DECORATIVE_PARTICIPANT_ID_CHANGED = "decorative-participant-id-changed",
-    VIDEO_SUSPEND_SUGGEST = "video-suspend-suggest"
+    VIDEO_SUSPEND_SUGGEST = "video-suspend-suggest",
+    HOLD = "hold"
 }
 export default SignalingNotification;

package/enums/TransportState.d.ts

@@ -0,0 +1,10 @@
+declare const enum TransportState {
+    IDLE = "IDLE",
+    OPENED = "OPENED",
+    CONNECTING = "CONNECTING",
+    RECONNECTING = "RECONNECTING",
+    CONNECTED = "CONNECTED",
+    CLOSED = "CLOSED",
+    FAILED = "FAILED"
+}
+export default TransportState;

package/enums/TransportTopology.d.ts

@@ -0,0 +1,5 @@
+declare const enum TransportTopology {
+    DIRECT = "DIRECT",
+    SERVER = "SERVER"
+}
+export default TransportTopology;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.11-dev.185dd9e4.0",
+  "version": "2.8.11-dev.1cb064f7.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/Capabilities.d.ts

@@ -0,0 +1,5 @@
+import { TCapabilities } from '../types/Capabilities';
+declare namespace Capabilities {
+    function get(): TCapabilities;
+}
+export default Capabilities;

package/static/Debug.d.ts

@@ -7,14 +7,33 @@ export declare enum DebugMessageType {
     WARN = "WARN",
     ERROR = "ERROR"
 }
+export type DebugMessageContext = {
+    readonly sessionId: string | null;
+    readonly conversationId: string | null;
+};
+export type DebugLogger = {
+    debug(...args: any[]): void;
+    log(...args: any[]): void;
+    warn(...args: any[]): void;
+    error(...args: any[]): void;
+};
+export type DebugSessionLogger = DebugLogger & {
+    readonly sessionId: string | null;
+    readonly conversationId: string | null;
+    setConversationId(conversationId: string | null): void;
+};
 declare namespace Debug {
-    let debug: Function;
-    let log: Function;
-    let warn: Function;
-    let error: Function;
-    function enabled(): boolean;
-    function toggle(enable: boolean): void;
-    function send(type: DebugMessageType, ...args: any[]): void;
-    function test(tag: string, ...args: any[]): void;
+    type ContextProvider = () => DebugMessageContext;
+    export function debug(...args: any[]): void;
+    export function log(...args: any[]): void;
+    export function warn(...args: any[]): void;
+    export function error(...args: any[]): void;
+    export function enabled(): boolean;
+    export function toggle(enable: boolean): void;
+    export function send(type: DebugMessageType, ...args: any[]): void;
+    export function createLogger(getContext: ContextProvider): DebugLogger;
+    export function createSessionLogger(initialConversationId?: string | null): DebugSessionLogger;
+    export function test(tag: string, ...args: any[]): void;
+    export {};
 }
 export default Debug;