@vkontakte/calls-sdk 2.8.12-dev.ecf77be8.0 → 2.8.12-dev.fd0aff08.0

package/classes/conversation/Conversation.d.ts

@@ -5,7 +5,6 @@ import BaseLogger from '../../abstract/BaseLogger';
 import { AddParticipantParams } from '../../abstract/BaseSignaling';
 import ConversationFeature from '../../enums/ConversationFeature';
 import ConversationOption from '../../enums/ConversationOption';
-import type ClientHangupReason from '../../enums/ClientHangupReason';
 import MediaOption from '../../enums/MediaOption';
 import UpdateDisplayLayoutErrorReason from '../../enums/UpdateDisplayLayoutErrorReason';
 import UserRole from '../../enums/UserRole';
@@ -16,6 +15,7 @@ import { IAsrStartParams, IAsrStopParams } from '../../types/Asr';
 import { AudienceModeHandsResponse } from '../../types/AudienceMode';
 import { ConversationData, ConversationOnJoinParams, ConversationOnStartParams } from '../../types/Conversation';
 import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk } from '../../types/ExternalId';
+import type { FastHangupHandler, HangupParams } from '../../types/FastHangup';
 import MediaModifiers from '../../types/MediaModifiers';
 import MediaSettings, { IVideoDimentions } from '../../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../../types/MovieShare';
@@ -57,6 +57,7 @@ export default class Conversation extends EventEmitter {
     private _serverSettings;
     private _serverTimeOffset;
     private _delayedHangup;
+    private _onFastHangup?;
     private _hangupEmitted;
     private _hangupPromise;
     private _abortController;
@@ -78,7 +79,7 @@ export default class Conversation extends EventEmitter {
     private readonly _statFirstMediaReceived;
     constructor(api: BaseApi, externalLogger: BaseLogger | null);
     static current(): Conversation | null;
-    static hangupAfterInit(): void;
+    static hangupAfterInit(onFastHangup?: FastHangupHandler): void;
     static id(): string | null;
     get id(): string;
     get externalId(): ExternalParticipantId | undefined;
@@ -90,6 +91,7 @@ export default class Conversation extends EventEmitter {
     static getSyncedTime(): number;
     get debugSessionId(): string | null;
     getCachedRawOkIdByExternalId(externalId: ExternalId): OkUserId | null;
+    private _buildInternalParams;
     onStart({ opponentIds, opponentType, mediaOptions, payload, joiningAllowed, requireAuthToJoin, onlyAdminCanShareMovie, externalIds, onFastStart, conversationId, }: ConversationOnStartParams): Promise<ConversationData>;
     onJoin(joinArgs: ConversationOnJoinParams): Promise<ConversationData>;
     private _onJoinPart2;
@@ -105,8 +107,8 @@ export default class Conversation extends EventEmitter {
     private _getMainRoomParticipants;
     private _decodeExternalConversationParams;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
-    decline(reason?: ClientHangupReason): Promise<void>;
-    hangup(reason?: ClientHangupReason): Promise<void>;
+    decline(params?: HangupParams): Promise<void>;
+    hangup(params?: HangupParams): Promise<void>;
     addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
@@ -117,7 +119,9 @@ export default class Conversation extends EventEmitter {
     private _closeParticipantTransport;
     private _cleanupRegistry;
     private _emitHangupOnce;
+    private _sendHangupApi;
     private _close;
+    private _sendHangup;
     destroy(): void;
     private _destroy;
     private _getConversationParams;
@@ -222,6 +226,8 @@ export default class Conversation extends EventEmitter {
     setAnimojiFill(fill: RGBTuple | string): void;
     setVideoStream(stream: MediaStream, isScreen?: boolean): Promise<void>;
     setAudioStream(stream: MediaStream): Promise<void>;
+    private readonly _toggleLocalVideo;
+    private readonly _toggleLocalAudio;
     toggleLocalVideo(enabled: boolean): Promise<void>;
     toggleLocalAudio(enabled: boolean): Promise<void>;
     /**
@@ -418,6 +424,8 @@ export default class Conversation extends EventEmitter {
     private _toggleJoinAvailability;
     private _updateDisplayLayoutFromCache;
     private _setParticipantsStatus;
+    private _setParticipantsStalled;
+    private _updateParticipantsStatus;
     private _onJoinLinkChanged;
     private _onRoomsUpdated;
     private _onRoomUpdated;

package/classes/screenshare/StreamBuilder.d.ts

@@ -9,6 +9,7 @@ export default class StreamBuilder extends BaseStreamBuilder {
     private _decoderReady;
     private _decoderBusy;
     private _decoderQueue;
+    private _webCodecsRetryAttempted;
     private _fpsMeter;
     private readonly _logger;
     constructor(participantId: ParticipantId, onStream: IOnStream, onStat: IOnStat, statAggregator: StatAggregator | null, onKeyFrameRequested: VoidFunction, debug?: DebugLogger, logger?: StatsLogger | null);

package/classes/transport/PerfStatReporter.d.ts

@@ -9,6 +9,7 @@ export default class PerfStatReporter extends EventEmitter {
     private _previousNetworkStatReportTimestamp;
     private _previousCallStatReportTimestamp;
     private _previousCallStatReport;
+    private _previousRemoteInboundRtps;
     private _screenShareStats;
     private _signaling;
     private readonly _directTopology;
@@ -21,6 +22,7 @@ export default class PerfStatReporter extends EventEmitter {
     private reportPerfStats;
     private reportNetworkStats;
     private _reportCallStats;
+    private _calculatePacketLoss;
     private _handleScreenSharingStat;
     private _handleTransportStateChanged;
 }

package/classes/transport/ServerTransport.d.ts

@@ -42,12 +42,11 @@ export default class ServerTransport extends BaseTransport {
     private _rtpReceiversByStreamId;
     private _producerSessionId;
     private _newAudioShareTrack;
-    private _simulcastInfo;
-    private _isSimulcastNegotiated;
     private readonly _debug;
     private readonly _logger;
     private readonly _statAggregator;
     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);
     updateStatisticsInterval(): void;
     open(observer?: boolean): void;
@@ -86,8 +85,6 @@ export default class ServerTransport extends BaseTransport {
     private _detectStaleTracks;
     private _allocateConsumer;
     private _processOffer;
-    private _findFirstSimTransceiver;
-    private _setupSimulcastTransceiver;
     private _acceptProducer;
     private _replaceScreenShareTrack;
     private _handleTracks;
@@ -102,7 +99,6 @@ export default class ServerTransport extends BaseTransport {
     private _onReplacedTrack;
     private _onSourcesChanged;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;
-    private _changeSimulcastInfo;
     private _monitorRtpShare;
     private _startMonitorRtpShareInterval;
     private _stopMonitorRtpShareInterval;

package/classes/transport/SimulcastSender.d.ts

@@ -0,0 +1,31 @@
+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;
+    private _changeSimulcast;
+}

package/classes/transport/Transport.d.ts

@@ -50,6 +50,7 @@ export declare class Transport extends EventEmitter {
     private readonly _codecStatsAggregator;
     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);
     updateSettings(settings: ServerSettings): void;
     updateStatisticsInterval(): void;
@@ -96,6 +97,8 @@ export declare class Transport extends EventEmitter {
     private _onAnimojiStream;
     /** Обработчик, досылающий MediaSourceEvent.SOURCE_CHANGED событие до аллокации транспортов */
     private _onAnimojiStatus;
+    private _createVad;
+    private _updateVadTrack;
     private _createAnimojiTransport;
     private _removeAnimojiTransport;
     getStreamWaitingTimeMs(streamId: string, targetRtpTimestamp: number): number;

package/default/Api.d.ts

@@ -1,6 +1,7 @@
 import BaseApi, { ClientStats } from '../abstract/BaseApi';
 import CallType from '../enums/CallType';
 import HangupType from '../enums/HangupType';
+import { IHangupParams } from '../types/Api';
 import ConversationParams from '../types/ConversationParams';
 import ConversationResponse from '../types/ConversationResponse';
 import { ExternalId, ExternalParticipantId, ExternalUserId } from '../types/ExternalId';
@@ -17,7 +18,9 @@ export default class Api extends BaseApi {
     private _getCachedAnonymLogin;
     private _setCachedAnonymLogin;
     private _removeCachedAnonymLogin;
+    private _reauthorize;
     private _applyAnonymLogin;
+    private _sendClientStats;
     logClientStats(items: ClientStats[]): void;
     uploadDebugLogs(conversationId: string, startTime: number, endTime: number, log: string): Promise<void>;
     joinConversation(conversationId: string, isVideo?: boolean, chatId?: string): Promise<ConversationResponse>;
@@ -55,7 +58,7 @@ export default class Api extends BaseApi {
     getConversationParams(conversationId?: string): Promise<ConversationParams>;
     getUserId(): OkUserId | null;
     setUserId(userId: OkUserId): void;
-    hangupConversation(conversationId: string, reason?: HangupType): void;
+    hangupConversation(conversationId: string, reason?: HangupType, params?: Partial<IHangupParams>): void;
     removeHistoryRecords(recordIds: number[]): Promise<void>;
     cleanup(): void;
     getServerTime(): Promise<number>;

package/default/ApiExternal.d.ts

@@ -1,3 +1,4 @@
+import { IHangupParams } from '../types/Api';
 import { IAPIBaseUrl, IApiEnv } from '../types/Params';
 export declare class ApiExternal {
     private readonly _uuid;
@@ -8,5 +9,5 @@ export declare class ApiExternal {
     private _sessionKey;
     constructor(apiEvn: IApiEnv, apiKey: string, callToken: string, baseApiUrl?: IAPIBaseUrl);
     authorize(): Promise<boolean>;
-    hangupConversation(conversationId: string): Promise<void>;
+    hangupConversation(conversationId: string, params?: Partial<IHangupParams>): Promise<void>;
 }

package/default/Signaling.d.ts

@@ -64,6 +64,7 @@ export default class Signaling extends BaseSignaling {
     setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
     setProducerCommandDataChannel(dataChannel: RTCDataChannel): void;
     useCommandDataChannel(status: boolean): void;
+    resetProducerConnection(cause?: Error): void;
     /**
      * Open a connection with a signaling server
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.12-dev.ecf77be8.0",
+  "version": "2.8.12-dev.fd0aff08.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -14,7 +14,7 @@
     "**/*.d.ts"
   ],
   "dependencies": {
-    "@vkontakte/calls-audio-effects": "1.2.8",
+    "@vkontakte/calls-audio-effects": "1.4.1",
     "@vkontakte/calls-video-effects": "2.2.3-beta.7",
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",

package/static/ApiTransport.d.ts

@@ -7,4 +7,7 @@ export declare function sendBeakon(method: string, params?: {
 export declare function request(method: string, params?: {
     [key: string]: any;
 }, noSession?: boolean, customEndpoint?: string): Promise<any>;
+export declare function requestKeepalive(method: string, params?: {
+    [key: string]: any;
+}, noSession?: boolean): Promise<any>;
 export declare function sendFormData(url: string, data: FormData): Promise<void>;

package/static/Params.d.ts

@@ -1,5 +1,5 @@
 import type { VideoEffects } from '@vkontakte/calls-video-effects';
-import type { EffectVoiceChange } from '@vkontakte/calls-audio-effects';
+import type { EffectVoiceChange, VadControllerOptions, VadLib } from '@vkontakte/calls-audio-effects';
 import type * as Vmoji from '@vkontakte/calls-vmoji';
 import { IAsrData } from '../types/Asr';
 import { ConversationData } from '../types/Conversation';
@@ -193,6 +193,14 @@ export type ParamsObject = {
      * Можно установить позднее методом `setAudioEffects`
      */
     audioEffects: EffectVoiceChange | null;
+    /**
+     * Namespace библиотеки VAD из `@vkontakte/calls-audio-effects`.
+     *
+     * Можно установить методом `setVad`
+     */
+    vad: VadLib | null;
+    /** Настройки VAD (threshold, hangoverMs, enabled) */
+    vadOptions: VadControllerOptions;
     /**
      * Максимальная ширина видео в пикселях для видео эффекта
      *
@@ -970,6 +978,10 @@ export default abstract class Params {
     static get displaySurface(): DisplayCaptureSurfaceType;
     static get audioEffects(): EffectVoiceChange | null;
     static set audioEffects(value: EffectVoiceChange | null);
+    static get vad(): VadLib | null;
+    static set vad(value: VadLib | null);
+    static get vadOptions(): VadControllerOptions;
+    static set vadOptions(value: VadControllerOptions);
     static get videoEffects(): VideoEffects | null;
     static set videoEffects(value: VideoEffects | null);
     static get videoEffectMaxWidth(): number;

package/static/ParticipantConnectionStatusUtils.d.ts

@@ -11,6 +11,7 @@ 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/Sdp.d.ts

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

package/static/SignalingCapabilities.d.ts

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

package/static/SimulcastInfo.d.ts

@@ -6,8 +6,10 @@ 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[]): ISimulcastInfo;
-export declare function findScaleResolutionDownBy(rid?: string): 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;

package/static/Utils.d.ts

@@ -77,6 +77,5 @@ 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/types/Api.d.ts

@@ -0,0 +1,9 @@
+import HangupType from '../enums/HangupType';
+export interface IHangupParams {
+    conversationId: string;
+    reason: HangupType;
+    anonymToken?: string;
+    peerId?: string;
+    application_key?: string;
+    session_key?: string;
+}

package/types/Capabilities.d.ts

@@ -18,6 +18,7 @@ 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,6 +49,7 @@ export interface ParticipantSessionState {
 }
 export interface ParticipantConnectionStatus {
     transport: ParticipantStatus;
+    stalled: boolean;
     sessionState?: ParticipantSessionState;
     sessionStateApplicable: boolean;
     sessionStateConnectedBySpeaker: boolean;

package/types/PerfStatReporter.d.ts

@@ -24,10 +24,6 @@ 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/types/SignalingCommand.d.ts

@@ -1,8 +1,10 @@
 import SignalingCommandType from '../enums/SignalingCommandType';
 import { SignalingResponse, SignalingSuccessResponse } from './SignalingMessage';
+export type SignalingCommandRoute = 'websocket' | 'producer';
 interface SignalingCommand<T extends SignalingResponse = SignalingSuccessResponse> {
     sequence: number;
     name: SignalingCommandType;
+    route: SignalingCommandRoute;
     statMarkName: string;
     params: object;
     responseTimer: number;

package/types/SignalingMessage.d.ts

@@ -188,6 +188,7 @@ declare namespace SignalingMessage {
         peerId: PeerId;
         mediaSettings: Partial<MediaSettings>;
         capabilities?: string;
+        externalId?: ExternalId;
     }
     export interface Hungup extends Notification {
         participantId: OkUserId;

package/utils/SerializeLatest.d.ts

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