@vkontakte/calls-sdk 2.8.10-dev.52257705.0 → 2.8.10-dev.6360a014.0

package/classes/AudioOutput.d.ts

@@ -3,7 +3,15 @@ type ParticipantAudioOutput = {
     audioElement?: HTMLAudioElement;
     audioTrack?: MediaStreamTrack;
 };
-export default class AudioOutput {
+export interface IAudioOutput {
+    add(track: MediaStreamTrack): void;
+    remove(track: MediaStreamTrack): void;
+    get volume(): number;
+    set volume(volume: number);
+    destroy(): void;
+    changeOutput(): Promise<void>;
+}
+export default class AudioOutput implements IAudioOutput {
     protected _output: ParticipantAudioOutput | null;
     private _volume;
     private readonly _features;

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';
@@ -75,6 +76,7 @@ export default class Conversation extends EventEmitter {
         joinLink?: string;
         observedIds?: ExternalUserId[];
         payload?: string;
+        onFastJoin?: FastJoinHandler;
     }): Promise<ConversationData>;
     private _onJoinPart2;
     private _extractExternalRooms;

package/classes/TransparentAudioOutput.d.ts

@@ -0,0 +1,19 @@
+import { IAudioOutput } from './AudioOutput';
+import { StatFirstMediaReceived } from './stat/StatFirstMediaReceived';
+export default class TransparentAudioOutput implements IAudioOutput {
+    private audioTracks;
+    private audioElement;
+    private _volume;
+    private readonly _features;
+    private readonly _statFirstMediaReceived;
+    constructor(statFirstMediaReceived: StatFirstMediaReceived);
+    add(track: MediaStreamTrack): void;
+    remove(track: MediaStreamTrack): void;
+    get volume(): number;
+    set volume(volume: number);
+    protected _initAudioElement(): void;
+    protected _stopAudioElement(): void;
+    destroy(): void;
+    /** изменяем устройство для воспроизведения аудио */
+    changeOutput(): Promise<void>;
+}

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/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.6360a014.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",

package/static/Params.d.ts

@@ -480,6 +480,12 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     webtransportFF: boolean;
+    /**
+     * Включить поддержку прозрачного аудио
+     *
+     * _По умолчанию: `false`_
+     */
+    transparentAudio: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -985,6 +991,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 +1025,6 @@ export default abstract class Params {
         simulcast: boolean;
         webtransport: boolean;
         webtransportFF: boolean;
+        transparentAudio: boolean;
     };
 }

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) => Promise<FastJoinResponse>;