@vkontakte/calls-sdk 2.8.10-dev.52257705.0 → 2.8.10-dev.53a954ba.0

package/classes/AudioOutput.d.ts

@@ -1,22 +1,27 @@
+import { ParticipantId } from '../types/Participant';
 import { StatFirstMediaReceived } from './stat/StatFirstMediaReceived';
-type ParticipantAudioOutput = {
-    audioElement?: HTMLAudioElement;
-    audioTrack?: MediaStreamTrack;
-};
+/**
+ * Единый AudioOutput поддерживающий p2p, audioMix и transparent-audio
+ */
 export default class AudioOutput {
-    protected _output: ParticipantAudioOutput | null;
+    protected _audioElement: HTMLAudioElement | null;
+    private _audioTracks;
+    private readonly _allowMultipleTracks;
     private _volume;
     private readonly _features;
     private readonly _statFirstMediaReceived;
-    constructor(statFirstMediaReceived: StatFirstMediaReceived);
-    add(track: MediaStreamTrack): void;
-    remove(track: MediaStreamTrack): void;
+    constructor(statFirstMediaReceived: StatFirstMediaReceived, allowMultipleTracks?: boolean);
+    add(participantId: ParticipantId, track: MediaStreamTrack): void;
+    remove(participantId: ParticipantId, track: MediaStreamTrack): void;
     get volume(): number;
     set volume(volume: number);
-    protected _initAudioElement(): void;
-    protected _stopAudioElement(): void;
     destroy(): void;
     /** изменяем устройство для воспроизведения аудио */
     changeOutput(): Promise<void>;
+    protected _getTracks(): MediaStreamTrack[];
+    protected _initAudioElement(): void;
+    protected _stopAudioElement(): void;
+    private _addTrackToAudioElement;
+    private _removeTrackFromAudioElement;
+    private _clearTracks;
 }
-export {};

package/classes/Conversation.d.ts

@@ -14,6 +14,7 @@ import { IAsrStartParams, IAsrStopParams } from '../types/Asr';
 import { AudienceModeHandsResponse } from '../types/AudienceMode';
 import { ConversationData, ConversationOnStartParams } from '../types/Conversation';
 import { ExternalId, ExternalParticipant, ExternalParticipantId, ExternalParticipantListChunk, ExternalUserId } from '../types/ExternalId';
+import type { FastJoinHandler } from '../types/FastJoin';
 import MediaModifiers from '../types/MediaModifiers';
 import { IVideoDimentions } from '../types/MediaSettings';
 import { IAddMovieParams, IUpdateMovieData } from '../types/MovieShare';
@@ -51,6 +52,7 @@ export default class Conversation extends EventEmitter {
     private static _current;
     private static _activationMutex;
     private static _delayedHangup;
+    private static _abortController;
     private readonly _onUnload;
     private readonly _audioOutput;
     private _lastStalled;
@@ -75,6 +77,7 @@ export default class Conversation extends EventEmitter {
         joinLink?: string;
         observedIds?: ExternalUserId[];
         payload?: string;
+        onFastJoin?: FastJoinHandler;
     }): Promise<ConversationData>;
     private _onJoinPart2;
     private _extractExternalRooms;
@@ -196,6 +199,7 @@ export default class Conversation extends EventEmitter {
      */
     changePriorities(priorities: ParticipantPriority[]): Promise<void>;
     changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<void>;
+    hold(hold: boolean): Promise<void>;
     putHandsDown(): Promise<void>;
     requestKeyFrame(participantStreamDescription: ParticipantStreamDescription): Promise<void | SignalingMessage>;
     requestTestMode(consumerCommand: string, producerCommand: string): Promise<void>;

package/classes/VolumesDetector.d.ts

@@ -4,15 +4,20 @@ export declare const enum VolumesDetectorEvent {
     VOLUMES_DETECTED = "VOLUMES_DETECTED"
 }
 export declare class VolumesDetector extends EventEmitter {
-    private _detector;
+    private _detectors;
     private _interval;
     private _activeParticipants;
     private _removedParticipants;
+    private _topology;
     constructor(transport: Transport);
     destroy(): void;
     private _onRemoteTrackAdded;
     private _onRemoteTrackRemoved;
     private _collectVolumes;
+    private _getAudioTrackLevelByParticipantId;
+    private _getTransparentAudioLevelByParticipantId;
     private _onSignalledActiveParticipants;
     private _onTopologyChanged;
+    private _isTransparentAudioMode;
+    private _destroyDetectors;
 }

package/classes/transport/DirectTransport.d.ts

@@ -55,6 +55,7 @@ export default class DirectTransport extends BaseTransport {
     private _handleIceCandidate;
     private _onSignalingStateChange;
     private _onIceConnectionStateChange;
+    private _markConnected;
     private _onConnectionStateChange;
     private _startReconnection;
     private _requestTopologySwitch;

package/classes/transport/ServerTransport.d.ts

@@ -25,6 +25,7 @@ export default class ServerTransport extends BaseTransport {
     private _perfStatReporter;
     private _producerOfferIsProcessing;
     private _producerNextOffer;
+    private _producerNextSessionId;
     private _lastStat;
     private _serverSettings;
     private _prevConsumerSettings;

package/default/Signaling.d.ts

@@ -89,6 +89,7 @@ export default class Signaling extends BaseSignaling {
     acceptCall(mediaSettings: MediaSettings): Promise<SignalingMessage>;
     changeMediaSettings(mediaSettings: MediaSettings): Promise<SignalingMessage>;
     changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
+    hold(hold: boolean): Promise<SignalingMessage>;
     putHandsDown(): Promise<SignalingMessage>;
     addParticipant(externalIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
     addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
@@ -96,7 +97,7 @@ export default class Signaling extends BaseSignaling {
     allocateConsumer(description: RTCSessionDescription | null, capabilities: {
         [key: string]: number | boolean | string;
     }): Promise<SignalingMessage>;
-    acceptProducer(description: RTCSessionDescriptionInit, ssrcs: string[]): Promise<SignalingMessage>;
+    acceptProducer(description: RTCSessionDescriptionInit, ssrcs: string[], sessionId: string): Promise<SignalingMessage>;
     /**
      * @deprecated Use updateDisplayLayout instead
      */

package/devtools/DevTools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * DevTools for SDK
+ * Позволяет подменять значения ручек перед инициализацией SDK
+ */
+import Params from './modules/Params';
+import type { DevToolsOptions } from './types';
+export type { DevToolsOptions };
+/**
+ * DevTools API for runtime SDK configuration
+ * Singleton class to ensure consistent state across the application
+ */
+declare class DevTools {
+    private static instance;
+    static getInstance(): DevTools;
+    readonly params: Params;
+    private storage;
+    private constructor();
+}
+declare const _default: DevTools;
+export default _default;

package/devtools/DevToolsStorage.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Storage utility for DevTools
+ * Handles persistence of DevTools options in localStorage
+ */
+import type { DevToolsOptions } from './types';
+/**
+ * Storage utility for DevTools
+ */
+export default class DevToolsStorage {
+    set(key: string, value: any): void;
+    get<T>(key: string): T | null;
+    remove(key: string): void;
+    clear(): void;
+    getAll(): DevToolsOptions;
+    private getStorage;
+}

package/devtools/index.d.ts

@@ -0,0 +1 @@
+export { default as devtools } from './DevTools';

package/devtools/modules/Params.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Params module for DevTools
+ * Позволяет подменять значения ручек перед инициализацией SDK
+ */
+import type DevToolsStorage from '../DevToolsStorage';
+import type { DevToolsOptions } from '../types';
+export type { DevToolsOptions };
+export default class Params {
+    private storage;
+    constructor(storage: DevToolsStorage);
+    /**
+     * Set an option override
+     * @param key - Option name
+     * @param value - Option value
+     * @example
+     * ```ts
+     * __CALLS_SDK.params.set('webtransport', true);
+     * ```
+     */
+    set<K extends keyof DevToolsOptions>(key: K, value: DevToolsOptions[K]): void;
+    /**
+     * Get an option override value
+     * @param key - Option name
+     * @returns Option value if override is set, null if not set
+     * @example
+     * ```ts
+     * const value = __CALLS_SDK.params.get('webtransport');
+     * ```
+     */
+    get<K extends keyof DevToolsOptions>(key: K): DevToolsOptions[K] | null;
+    /**
+     * Clear a specific option override
+     * @param key - Option name
+     * @example
+     * ```ts
+     * __CALLS_SDK.params.clear('webtransport');
+     * ```
+     */
+    clear<K extends keyof DevToolsOptions>(key: K): void;
+    /**
+     * Clear all DevTools overrides
+     * @example
+     * ```ts
+     * __CALLS_SDK.params.clearAll();
+     * ```
+     */
+    clearAll(): void;
+    /**
+     * Get all current DevTools overrides
+     * @returns Current override values
+     * @example
+     * ```ts
+     * const overrides = __CALLS_SDK.params.getAll();
+     * console.log(overrides); // { webtransport: true }
+     * ```
+     */
+    getAll(): DevToolsOptions;
+    /**
+     * Apply DevTools overrides to client options
+     * DevTools overrides take precedence over client-provided options
+     * @param clientOptions - Original client options
+     * @returns Modified options with DevTools overrides applied
+     */
+    applyOverrides<T extends DevToolsOptions>(clientOptions: T): T;
+}

package/devtools/types.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Type definitions for DevTools
+ */
+import type { ParamsObject } from '../static/Params';
+type Primitive = string | number | boolean;
+type PrimitiveKeys<T> = {
+    [K in keyof T]-?: Exclude<T[K], undefined> extends Primitive ? K : never;
+}[keyof T];
+export type PrimitiveParamsObject = Pick<ParamsObject, PrimitiveKeys<ParamsObject>>;
+/**
+ * Available DevTools options that can be overridden
+ * All properties are optional
+ */
+export type DevToolsOptions = Partial<PrimitiveParamsObject>;
+export {};

package/enums/HangupType.d.ts

@@ -38,6 +38,10 @@ declare enum HangupType {
      * Проблемы при работе через FastStart
      */
     FAST_START_ERROR = "FAST_START_ERROR",
+    /**
+     * Проблемы при работе через FastJoin
+     */
+    FAST_JOIN_ERROR = "FAST_JOIN_ERROR",
     /**
      * Таймаут инициализации вызова – звонок не начался
      *

package/enums/SignalingCommandType.d.ts

@@ -55,6 +55,7 @@ declare enum SignalingCommandType {
     GET_HAND_QUEUE = "get-hand-queue",
     ENABLE_VIDEO_SUSPEND = "enable-video-suspend",
     ENABLE_VIDEO_SUSPEND_SUGGEST = "enable-video-suspend-suggest",
+    HOLD = "hold",
     PUT_HANDS_DOWN = "put-hands-down",
     CHANGE_SIMULCAST = "change-simulcast"
 }

package/enums/TrackId.d.ts

@@ -1,5 +1,6 @@
 export declare const enum TrackId {
     AUDIO_MIX = "audio-mix",
-    PARTICIPANT_AGNOSTIC_TRACK_PREFIX = "pat"
+    PARTICIPANT_AGNOSTIC_TRACK_PREFIX = "pat",
+    TRANSPARENT_AUDIO_TRACK_PREFIX = "ta"
 }
 export default TrackId;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.10-dev.52257705.0",
+  "version": "2.8.10-dev.53a954ba.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/Params.d.ts

@@ -343,6 +343,7 @@ export type ParamsObject = {
      * Включает поддержку режима WAIT_FOR_ADMIN в звонках.
      */
     waitForAdminInGroupCalls: boolean;
+    hold: boolean;
     /**
      * Индекс участника для первого chunk'а который придет при установке соединения с сервером
      *
@@ -480,6 +481,12 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     webtransportFF: boolean;
+    /**
+     * Включить поддержку прозрачного аудио
+     *
+     * _По умолчанию: `false`_
+     */
+    transparentAudio: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -963,6 +970,7 @@ export default abstract class Params {
     static get useChatRooms(): boolean;
     static get addParticipant(): boolean;
     static get waitForAdminInGroupCalls(): boolean;
+    static get hold(): boolean;
     static get participantListChunkInitIndex(): number;
     static get participantListChunkInitCount(): number | null;
     static get filterObservers(): boolean;
@@ -985,6 +993,7 @@ export default abstract class Params {
     static get simulcast(): boolean;
     static get webtransport(): boolean;
     static get webtransportFF(): boolean;
+    static get transparentAudio(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1018,5 +1027,6 @@ export default abstract class Params {
         simulcast: boolean;
         webtransport: boolean;
         webtransportFF: boolean;
+        transparentAudio: boolean;
     };
 }

package/static/SignalingCapabilities.d.ts

@@ -20,6 +20,7 @@ declare const PREDICATES: {
     readonly addParticipant: () => boolean;
     readonly p2pRelay: () => boolean;
     readonly waitForAdmin: () => boolean;
+    readonly hold: () => boolean;
 };
 type ParticipantCapabilitiesKeys = keyof typeof PREDICATES;
 export type ParticipantCapabilities = Record<ParticipantCapabilitiesKeys, boolean>;

package/static/Utils.d.ts

@@ -33,7 +33,9 @@ declare namespace Utils {
     function uuid(): string;
     function debounce<F extends (...args: Parameters<F>) => ReturnType<F>>(func: F, ms: number): (this: any, ..._args: Parameters<F>) => void;
     function sdpFingerprint(sdp: string): bigint | null;
-    function delay(time: number): Promise<unknown>;
+    function delay(time: number, { signal }?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
     function applySettings(pc: RTCPeerConnection, videoSettings: VideoSettings, prevSettings: any): any;
     function applyVideoTrackSettings(videoSettings: VideoSettings, s: RTCRtpSender, track: MediaStreamTrack | null, prevSettings: any, retSettings: any): void;
     /**

package/static/WebRTCUtils.d.ts

@@ -75,6 +75,7 @@ declare namespace WebRTCUtils {
      * Проверяет получены ли разрешения, необходимые для текущего звонка
      */
     function hasPermissions(needVideo?: boolean): boolean;
+    function releaseFirefoxMicrophonePermissionWarmup(): void;
     /**
      * Запрашивает камеру и микрофон пользователя
      *

package/types/FastJoin.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Параметры для fast join
+ */
+export interface FastJoinParams {
+    joinLink: string;
+    isVideo: boolean;
+    internalParams: string;
+}
+export interface FastJoinResponse {
+    conversationId: string;
+    internalCallerParams: string;
+}
+export type FastJoinHandler = (params: FastJoinParams, signal?: AbortSignal) => Promise<FastJoinResponse>;

package/types/FastStart.d.ts

@@ -44,4 +44,4 @@ export interface FastStartResponse {
         status: string;
     }[];
 }
-export type FastStartHandler = (params: FastStartParams) => Promise<FastStartResponse>;
+export type FastStartHandler = (params: FastStartParams, signal?: AbortSignal) => Promise<FastStartResponse>;