@vkontakte/calls-sdk 2.8.12-dev.6473a056.0 → 2.8.12-dev.68a694c3.0

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
+}
+export default SessionError;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.12-dev.6473a056.0",
+  "version": "2.8.12-dev.68a694c3.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -11,7 +11,6 @@ declare namespace ParticipantConnectionStatusUtils {
     function computeEffective(status: ParticipantConnectionStatus): ParticipantStatus;
     function setSessionState(status: ParticipantConnectionStatus, sessionState?: ParticipantSessionState, sessionStateConnectedBySpeaker?: boolean): StatusTransition;
     function setTransport(status: ParticipantConnectionStatus, transport: ParticipantStatus): StatusTransition;
-    function setStalled(status: ParticipantConnectionStatus, stalled: boolean): StatusTransition;
     function setSessionStateApplicable(status: ParticipantConnectionStatus, applicable: boolean): StatusTransition;
 }
 export default ParticipantConnectionStatusUtils;

package/static/SignalingCapabilities.d.ts

@@ -1,5 +1,5 @@
 /**
- * @see https://confluence.vk.team/display/CALLS/Websocket+Capability+Flags
+ * @see https://confluence.vk.team/display/VIDEOOK/Websocket+Capability+Flags
  */
 declare const PREDICATES: {
     readonly producerScreenTrack: () => boolean;

package/static/SimulcastInfo.d.ts

@@ -6,10 +6,8 @@ export declare const SIMULCAST_DEFAULT: {
     BITRATE: number;
 };
 export declare const SIMULCAST_SCALABILITY_MODE = "L1T2";
+export declare const MAP_RID_TO_SCALE_RESOLUTION_DOWN_BY: Record<string, number>;
 export declare function isEqualSimulcastInfo(si1: ISimulcastInfo | null, si2: ISimulcastInfo | null): boolean;
 export declare function findBitrateAsc(maxDimension: number, bitrates: VideoBitrateSettings[]): number;
-export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[], fps?: number): {
-    streams: import("../types/SimulcastInfo").SimulcastStreamInfo[];
-};
-export declare function findScaleResolutionDownBy(rid: string | undefined, simulcastInfo: ISimulcastInfo): number;
-export declare function applySimulcastInfoToEncodings(encodings: RTCRtpEncodingParameters[], simulcastInfo: ISimulcastInfo, maxDimension?: number, maxBitrate?: number): void;
+export declare function calculateSimulcastInfo(width?: number, height?: number, bitrates?: VideoBitrateSettings[]): ISimulcastInfo;
+export declare function findScaleResolutionDownBy(rid?: string): number;

package/static/Utils.d.ts

@@ -77,5 +77,6 @@ declare namespace Utils {
     function objectReduce<R, T extends object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
     const setImmediate: (fn: VoidFunction) => VoidFunction;
     function isObject(obj: unknown): obj is object;
+    function patchSimulcastAnswerSdp(sdp: string, trans: RTCRtpTransceiver, width: number, height: number): string;
 }
 export default Utils;

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

@@ -18,7 +18,6 @@ export type TCapabilities = {
     fastScreenShare: boolean;
     videoSuspend: boolean;
     simulcast: boolean;
-    simulcastNativeOrder: boolean;
     consumerFastScreenShare: boolean;
     consumerFastScreenShareQualityOnDemand: boolean;
     transparentAudio: boolean;

package/types/FastHangup.d.ts

@@ -0,0 +1,66 @@
+import type ClientHangupReason from '../enums/ClientHangupReason';
+import type HangupType from '../enums/HangupType';
+/**
+ * Параметры запроса завершения звонка через внешнего партнёра (fast hangup).
+ *
+ * SDK генерирует объект и передаёт его в {@link FastHangupHandler}.
+ * Хост и backend партнёра пробрасывают `internalParams` как есть, без парсинга.
+ */
+export interface FastHangupParams {
+    /**
+     * ID звонка
+     */
+    conversationId: string;
+    /**
+     * Причина завершения звонка
+     */
+    reason: HangupType;
+    /**
+     * Внутренние параметры звонка (JSON-строка). Генерируется SDK.
+     */
+    internalParams?: string | null;
+}
+/**
+ * Ответ внешнего партнёра на завершение звонка.
+ */
+export interface FastHangupResponse {
+    /**
+     * true — участие в звонке завершено
+     */
+    success: boolean;
+}
+/**
+ * Параметры публичных методов {@link hangup} / {@link declineCall}.
+ *
+ * `reason` и `conversationId` идут в signaling hangup.
+ * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
+ * (явный hangup/decline или delayed hangup во время init).
+ * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
+ * где SDK всегда шлёт beacon, и delayed hangup без handler.
+ */
+export interface HangupParams {
+    /**
+     * ID звонка. Если опущен — завершается текущий активный звонок.
+     */
+    conversationId?: string;
+    /**
+     * Причина завершения для проброса в сигналинг. См. {@link ClientHangupReason}.
+     */
+    reason?: ClientHangupReason;
+    /**
+     * Обработчик fast hangup — завершение звонка через внешнего партнёра.
+     */
+    onFastHangup?: FastHangupHandler;
+}
+/**
+ * Функция-обработчик fast hangup.
+ *
+ * Если передана в {@link HangupParams.onFastHangup} при `hangup` / `declineCall`,
+ * SDK вызывает её вместо API `vchat.hangupConversation`.
+ *
+ * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
+ *
+ * @param params Параметры запроса
+ * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
+ */
+export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;

package/types/Participant.d.ts

@@ -49,7 +49,6 @@ export interface ParticipantSessionState {
 }
 export interface ParticipantConnectionStatus {
     transport: ParticipantStatus;
-    stalled: boolean;
     sessionState?: ParticipantSessionState;
     sessionStateApplicable: boolean;
     sessionStateConnectedBySpeaker: boolean;

package/types/PerfStatReporter.d.ts

@@ -24,6 +24,10 @@ export interface CallStatReport {
     audio_concealment_events: number;
     inbound_video_count: number;
     inbound_audio_count: number;
+    packets_lost_video: number;
+    packets_sent_video: number;
+    packets_lost_audio: number;
+    packets_sent_audio: number;
     freeze_count: number;
     total_freezes_duration: number;
     rtt: number;

package/classes/StatsLogger.d.ts

@@ -1,41 +0,0 @@
-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 = {
-    immediately?: boolean;
-    occurredAt?: number;
-    conversationId?: string | null;
-    deferUntilServerTime?: boolean;
-};
-/**
- * Класс отвечает за отправку различной информации в сервис статистики (события, статистика и подобное)
- */
-export default class StatsLogger extends BaseLogger {
-    private readonly _externalLogger;
-    private readonly _api;
-    private readonly _conversationIdProvider;
-    private readonly _topologyProvider;
-    private readonly _batchInterval;
-    private _batchedClientStats;
-    private _batchTimeout;
-    private _serverTimeDelta;
-    private _waitingForServerTime;
-    private _deferredClientStats;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
-    log(name: StatLog, value?: string, immediately?: boolean): void;
-    logClientStats(data: ClientStatsPayload, immediatelyOrOptions?: boolean | LogClientStatsOptions): void;
-    destroy(): void;
-    private _logClientStats;
-    private _getConversationId;
-    private _getCallTopology;
-    private _sendBatch;
-    private _startTimeout;
-    private _stopTimeout;
-    private _sendClientStats;
-    private _calculateServerTimeDelta;
-    private _flushDeferredClientStats;
-    private _now;
-}
-export {};

package/classes/transport/SimulcastSender.d.ts

@@ -1,30 +0,0 @@
-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';
-export default class SimulcastSender {
-    private _pc;
-    private _transceiver;
-    private _currentSimulcastInfo;
-    private readonly _signaling;
-    private readonly _mediaSource;
-    private readonly _getCameraSettings;
-    private readonly _debug;
-    private readonly _logger;
-    constructor(signaling: BaseSignaling, mediaSource: MediaSource, getCameraSettings: () => VideoSettings | null, debug?: DebugLogger, logger?: StatsLogger | null);
-    configureFromRemoteOffer(pc: RTCPeerConnection): Promise<void>;
-    finalizeAnswer(sdp: string): string;
-    sync({ force }?: {
-        force?: boolean;
-    }): Promise<void>;
-    replaceTrack(track: MediaStreamTrack): boolean;
-    reset(): void;
-    private _findTransceiver;
-    private _findMediaSection;
-    private _getConfig;
-    private _getTrackConfig;
-    private _applyConfig;
-    private _applyCurrentMediaState;
-    private _syncReplacedTrack;
-}

package/static/Sdp.d.ts

@@ -1,3 +0,0 @@
-export declare const SDP_LINE_ENDING = "\r\n";
-export declare function splitSdpLines(sdp: string): string[];
-export declare function joinSdpLines(lines: string[]): string;

package/utils/SerializeLatest.d.ts

@@ -1,5 +0,0 @@
-/**
- * Последовательно выполняет операции, оставляя в очереди только последнее запрошенное значение.
- * Возвращает ошибку, только если не удалось применить итоговое состояние.
- */
-export declare function serializeLatest<T>(run: (value: T) => Promise<void> | undefined): (value: T) => Promise<void>;