@vkontakte/calls-sdk 2.8.6-dev.a5d3a18a.0 → 2.8.6-dev.a76637b5.0

package/static/External.d.ts

@@ -226,7 +226,7 @@ declare namespace External {
      * @param markers
      */
     function onParticipantJoined(userId: ExternalId, markers: ExternalParticipantListMarkers | null): void;
-    function onLocalParticipantState(participantState: ParticipantStateMapped): void;
+    function onLocalParticipantState(participantState: ParticipantStateMapped, global?: boolean): void;
     /**
      * Изменились данные состояний собеседника
      *
@@ -420,7 +420,7 @@ declare namespace External {
      * Закончена запись звонка
      * @param roomId ID зала в котором остановлена запись
      */
-    function onRecordStopped(roomId?: number | null): void;
+    function onRecordStopped(roomId: number | null | undefined, stopBy: ExternalParticipantId | null): void;
     /**
      * Состояние своей сети
      *

package/static/Params.d.ts

@@ -82,6 +82,8 @@ export type ParamsObject = {
     /** @hidden */
     wssBase: string;
     /** @hidden */
+    wtsBase: string;
+    /** @hidden */
     wssToken: string;
     /** @hidden */
     signalingReconnectDelay: number;
@@ -461,6 +463,50 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableLogPerfStatReport: boolean;
+    /**
+     * Поддержка переключения качества видео в зависимости от сети
+     * Только для режима p2p
+     *
+     * _По умолчанию: `false`_
+     */
+    switchVideoAtBadNetwork: boolean;
+    /**
+     * Включает деградацию фпс для видео с камеры при низком фпс с включенными вирт фонами
+     *
+     * _По умолчанию: `false`_
+     */
+    enableVideoEffectsFpsDegradation: boolean;
+    /**
+     * Включить поддержку simulcast на отправке
+     *
+     * _По умолчанию: `false`_
+     */
+    simulcast: boolean;
+    /**
+     * Включить поддержку webtransport для сигналинга
+     *
+     * _По умолчанию: `false`_
+     */
+    webtransport: boolean;
+    /**
+     * Включить поддержку webtransport для сигналинга в FireFox
+     * Отдельная ручка, так как есть проблемы сейчас с FF
+     *
+     * _По умолчанию: `false`_
+     */
+    webtransportFF: boolean;
+    /**
+     * Скриншара
+     * Включить возможность запрашивать ключевой кадр декодером
+     * @hidden
+     */
+    streamBuilderKeyFrameRequest: boolean;
+    /**
+     * Скриншара
+     * Включить переключение на LibVPX при проблемах с WebCodecsDecoder
+     * @hidden
+     */
+    streamBuilderAutoSwitchToLibVPX: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -565,8 +611,11 @@ export type ParamsObject = {
     /**
      * Получены данные по изменению локальных состояний со стороны админа
      * Например, принудительно опущена рука
+     *
+     *  @param participantState  Полный объект состояния участника, полученный от SDK/сервера.
+     *  @param global `true` – действие глобальное (для всех участников), `false` – действие локальное (только у текущего пользователя).
      */
-    onLocalParticipantState?: (participantState: ParticipantStateMapped) => void;
+    onLocalParticipantState?: (participantState: ParticipantStateMapped, global: boolean) => void;
     /**
      * Изменились данные состояний собеседника
      */
@@ -681,7 +730,7 @@ export type ParamsObject = {
     /**
      * Закончена трансляция/запись звонка
      */
-    onRecordStopped?: (roomId: number | null) => void;
+    onRecordStopped?: (roomId: number | null, stopBy: ExternalParticipantId | null) => void;
     /**
      * Состояние своей сети
      *
@@ -834,27 +883,6 @@ export type ParamsObject = {
      * Собеседник подключился к сигналлингу
      */
     onPeerRegistered?: () => void;
-    /**
-     * Поддержка переключения качества видео в зависимости от сети
-     * Только для режима p2p
-     *
-     * _По умолчанию: `false`_
-     */
-    switchVideoAtBadNetwork: boolean;
-    /** включает деградацию фпс для видео с камеры при низком фпс с включенными вирт фонами */
-    enableVideoEffectsFpsDegradation: boolean;
-    /**
-     * Включить поддержку simulcast на отправке
-     *
-     * _По умолчанию: `false`_
-     */
-    simulcast: boolean;
-    /**
-     * Не запрашивать conversation params при входе в звонок
-     *
-     * _По умолчанию: `false`_
-     */
-    skipConversationParams?: boolean;
 };
 export default abstract class Params {
     private static _params;
@@ -891,6 +919,8 @@ export default abstract class Params {
     static set iceServers(value: IceServer[]);
     static get wssBase(): string;
     static set wssBase(value: string);
+    static get wtsBase(): string;
+    static set wtsBase(value: string);
     static get wssToken(): string;
     static set wssToken(value: string);
     static get signalingReconnectDelay(): number;
@@ -984,7 +1014,14 @@ export default abstract class Params {
     static get enableVideoEffectsFpsDegradation(): boolean;
     static get simulcast(): boolean;
     static set simulcast(value: boolean);
-    static get skipConversationParams(): boolean | undefined;
+    static get webtransport(): boolean;
+    static set webtransport(value: boolean);
+    static get webtransportFF(): boolean;
+    static set webtransportFF(value: boolean);
+    static set streamBuilderKeyFrameRequest(value: boolean);
+    static get streamBuilderKeyFrameRequest(): boolean;
+    static set streamBuilderAutoSwitchToLibVPX(value: boolean);
+    static get streamBuilderAutoSwitchToLibVPX(): boolean;
     static toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1013,5 +1050,10 @@ export default abstract class Params {
         clientStatsPlatform: string;
         consumerScreenDataChannelPacketSize: number;
         switchVideoAtBadNetwork: boolean;
+        simulcast: boolean;
+        webtransport: boolean;
+        webtransportFF: boolean;
+        streamBuilderKeyFrameRequest: boolean;
+        streamBuilderAutoSwitchToLibVPX: boolean;
     };
 }

package/static/SimulcastInfo.d.ts

@@ -10,4 +10,4 @@ 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 findScaleResolutionDownBy(rid?: string): number;

package/static/Utils.d.ts

@@ -71,7 +71,7 @@ declare namespace Utils {
     function participantMarkerCompare(marker1: ExternalParticipantListMarker | undefined, marker2: ExternalParticipantListMarker | undefined): number;
     /** убирает все ключи со значением `V` на 1 уровне */
     function objectFilterOutValues<T extends Record<string, V>, V = unknown>(obj: T, value?: unknown | unknown[]): Partial<T>;
-    function objectReduce<R, T extends Object>(obj: T, callback: (acc: R, value: T[keyof T], key: keyof T) => R, initialValue: R): R;
+    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;

package/static/WebRTCUtils.d.ts

@@ -21,7 +21,9 @@ export declare enum FacingMode {
 export type BrowserName = 'IE' | 'Edge' | 'Chrome' | 'Firefox' | 'Yandex' | 'Opera' | 'Sferum';
 declare namespace WebRTCUtils {
     /**
-     * Инициализирует устройства. До вызова этого метода бесполезно опрашивать другие публичные методы
+     * До вызова этого метода бесполезно опрашивать другие публичные методы.
+     * - Инициализирует устройства.
+     * - Получает версию ОС
      */
     function init(): Promise<void>;
     /**
@@ -151,6 +153,10 @@ declare namespace WebRTCUtils {
      * Имя операционной системы
      */
     function os(): string;
+    /**
+     * Версия операционной системы
+     */
+    function osVersion(): number | null | undefined;
     /**
      * Мобильный браузер или нет
      */

package/types/Conversation.d.ts

@@ -8,6 +8,7 @@ import UserRole from '../enums/UserRole';
 import { AsrInfo } from './Asr';
 import { IFeaturesPerRole } from './ConversationFeature';
 import { ExternalId, ExternalParticipantId } from './ExternalId';
+import { FastStartHandler } from './FastStart';
 import MediaModifiers from './MediaModifiers';
 import MuteStates from './MuteStates';
 import { OkUserId, ParticipantId } from './Participant';
@@ -79,6 +80,7 @@ export type ConversationOnStartParams = {
     requireAuthToJoin?: boolean;
     onlyAdminCanShareMovie?: boolean;
     externalIds?: ExternalId[];
+    onFastStart?: FastStartHandler;
 };
 export type StartConversationParams = {
     opponentIds?: OkUserId[];
@@ -91,4 +93,5 @@ export type StartConversationParams = {
     onlyAdminCanShareMovie?: boolean;
     externalIds?: ExternalId[];
     startedTime: number;
+    onFastStart?: FastStartHandler;
 };

package/types/ConversationParams.d.ts

@@ -2,6 +2,7 @@ import IceServer from './IceServer';
 type ConversationParams = {
     token: string;
     endpoint: string;
+    wt_endpoint?: string;
     turn_server?: IceServer;
     stun_server?: IceServer;
     client_type?: string;
@@ -22,5 +23,6 @@ export type ExternalConversationParams = {
     trnp: string;
     trnu: string;
     wse: string;
+    wte: string;
 };
 export default ConversationParams;

package/types/ConversationResponse.d.ts

@@ -13,6 +13,10 @@ type ConversationResponse = {
      * URL для подключения
      */
     endpoint: string;
+    /**
+     * URL для подключения по WebTransport
+     */
+    wt_endpoint?: string;
     /**
      * Токен комнаты для подключения к звонку по ссылке
      */

package/types/ExternalId.d.ts

@@ -1,4 +1,5 @@
 import MediaOption from '../enums/MediaOption';
+import UserRole from '../enums/UserRole';
 import { ParticipantStatus } from '../static/External';
 import MediaSettings from './MediaSettings';
 import { ISharedMovieInfo } from './MovieShare';
@@ -96,6 +97,7 @@ export interface ExternalParticipant {
     unmuteOptions: MediaOption[];
     markers: ExternalParticipantListMarkers | null;
     movieShareInfos?: ISharedMovieInfo[];
+    roles: UserRole[];
 }
 /**
  * Позиция в чанке

package/types/FastStart.d.ts

@@ -0,0 +1,46 @@
+import { HangupType, IceServer } from '../CallsSDK';
+import CallType from '../enums/CallType';
+import MediaOption from '../enums/MediaOption';
+import { ExternalId } from './ExternalId';
+/**
+ * Параметры, которые нужно вернуть для создания fastStart
+ */
+export interface InternalParams {
+    platform: string;
+    sdkVersion: string;
+    clientAppKey: string;
+    deviceId: string;
+    protocolVersion: number;
+    domainId?: string;
+}
+export interface InternalCallerParams {
+    id: ID;
+    isConcurrent: boolean;
+    endpoint: string;
+    wtEndpoint: string;
+    clientType: string;
+    turn: IceServer;
+    stun: IceServer;
+}
+export interface ID {
+    internal: number;
+    external: string;
+}
+export interface FastStartParams {
+    conversationId: string;
+    internalParams: string;
+    externalIds?: ExternalId[];
+    opponentType: CallType;
+    mediaOptions: MediaOption[];
+    joiningAllowed?: boolean;
+    requireAuthToJoin?: boolean;
+    isVideo?: boolean;
+}
+export interface FastStartResponse {
+    internalCallerParams: string;
+    rejectedParticipants: {
+        id: string;
+        status: HangupType;
+    }[];
+}
+export type FastStartHandler = (params: FastStartParams) => Promise<FastStartResponse>;

package/types/SignalingCommand.d.ts

@@ -3,6 +3,7 @@ import { SignalingResponse, SignalingSuccessResponse } from './SignalingMessage'
 interface SignalingCommand<T extends SignalingResponse = SignalingSuccessResponse> {
     sequence: number;
     name: SignalingCommandType;
+    statMarkName: string;
     params: object;
     responseTimer: number;
     needResponse: boolean;

package/types/SignalingMessage.d.ts

@@ -276,7 +276,6 @@ declare namespace SignalingMessage {
     }
     export interface FeatureSetChanged extends Notification {
         features: ConversationFeature[];
-        featuresPerRole?: IFeaturesPerRole | null;
     }
     export interface MultipartyChatCreated extends Notification {
         chatId: string;
@@ -289,6 +288,7 @@ declare namespace SignalingMessage {
         recordInfo: RecordInfo;
     }
     export interface RecordStopped extends Notification {
+        /** кто остановил запись или если в комнатах, то это админ */
         participant: ParticipantId;
         recordMovieId: number;
     }

package/types/Streams.d.ts

@@ -9,6 +9,7 @@ export interface IStartStreamData {
 }
 export interface IStopStreamData {
     roomId: number | null;
+    remove?: boolean;
 }
 export interface IPublishStreamData {
     roomId: number | null;

package/types/WebTransport.d.ts

@@ -0,0 +1,26 @@
+import { WebTransportOptions } from '@fails-components/webtransport';
+declare class WebTransportEventual {
+    private webTransport;
+    private stream;
+    private writer;
+    private reader;
+    private readonly url;
+    private readonly options;
+    private readonly compression;
+    private encoder;
+    private decoder;
+    onopen: ((this: WebTransportEventual, ev: Event) => any) | null;
+    onmessage: ((this: WebTransportEventual, ev: MessageEvent) => any) | null;
+    onerror: ((this: WebTransportEventual, ev: Event) => any) | null;
+    onclose: ((this: WebTransportEventual, ev: CloseEvent) => any) | null;
+    readyState: number;
+    constructor(url: string, options?: WebTransportOptions);
+    private getCompressionTypeFromUrl;
+    private connect;
+    private readChunks;
+    private readLoop;
+    send(data: string): Promise<void>;
+    close(code?: number, reason?: string): void;
+    static isBrowserSupported(): boolean;
+}
+export { WebTransportEventual as WebTransport };

package/utils/LengthPrefixed.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Encodes a string into a Uint8Array, prepending the length of the string as a variable-length integer and optionally compressing it.
+ */
+declare class LengthPrefixedTextEncoder {
+    private readonly encoder;
+    private readonly compression;
+    private readonly lengthEncoder;
+    constructor(compression?: 'gzip' | 'deflate' | 'deflate-raw' | null);
+    /**
+     * Encodes the given string into a Uint8Array.
+     *
+     * @param data The string to encode.
+     * @returns A Uint8Array containing the length-prefixed and optionally compressed encoded string.
+     * @throws {RangeError} If the string length exceeds the maximum representable value.
+     */
+    encode(data: string): Uint8Array;
+    private compress;
+}
+/**
+ * Decodes a stream of Uint8Arrays into strings, where each string
+ * is prefixed by its length as a variable-length integer and optionally decompressed.
+ */
+declare class LengthPrefixedTextDecoder {
+    private readonly decoder;
+    private readonly compression;
+    private readonly lengthDecoder;
+    private buffer;
+    private expectedLength;
+    private offset;
+    private lengthPrefixLength;
+    constructor(compression?: 'gzip' | 'deflate' | 'deflate-raw' | null);
+    /**
+     * Decodes a Uint8Array into a list of strings.
+     *
+     * @param data The Uint8Array to decode.
+     * @returns An array of decoded strings.
+     */
+    decode(data: Uint8Array): string[];
+    /**
+     * Reads the length prefix from the beginning of the data.
+     *
+     * @param data The Uint8Array containing the length prefix.
+     * @returns The length of the message, or null if there's not enough data to read the length.
+     */
+    private readLength;
+    private decompress;
+}
+export { LengthPrefixedTextEncoder, LengthPrefixedTextDecoder };

package/utils/Lz4.d.ts

@@ -1 +1 @@
-export declare function lz4Decompress(input: Uint8Array, outputLength: number): Uint8Array;
+export declare function lz4Decompress(input: Uint8Array, outputLength: number): Uint8Array<ArrayBuffer>;

package/utils/MsgPackerBufferUtils.d.ts

@@ -13,7 +13,7 @@ export declare function createWriteBuffer(): {
     putUi32(v: number): void;
     putUi64(v: number): void;
     putF(v: number): void;
-    ui8array(): Uint8Array;
+    ui8array(): Uint8Array<ArrayBuffer>;
 };
 export declare function createReadBuffer(buf: BufferSource): {
     peek(): number;

package/utils/P2Quantile.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Класс, реализующий возможность найти медиану или другой персентиль не храня весь поток данных для расчета
+ */
+export declare class P2Quantile {
+    private readonly q;
+    private inits;
+    private n;
+    private np;
+    private qv;
+    constructor(q: number);
+    add(x: number): void;
+    value(): number;
+    private bootstrap;
+}

package/utils/StatTracker.d.ts

@@ -0,0 +1,18 @@
+export declare class StatTracker {
+    private count;
+    private minVal;
+    private maxVal;
+    private mean;
+    private p50;
+    private p95;
+    add(x: number): void;
+    snapshot(): {
+        min: number;
+        max: number;
+        avg: number;
+        median: number;
+        p95: number;
+        count: number;
+    };
+    get hasData(): boolean;
+}

package/utils/VariableLengthInteger.d.ts

@@ -0,0 +1,18 @@
+declare class VariableLengthIntegerEncoder {
+    /**
+     * Encodes an integer using a variable-length integer encoding.
+     * @param num The number to encode.
+     * @returns A Uint8Array representing the encoded integer.
+     */
+    encode(num: number | bigint): Uint8Array;
+}
+declare class VariableLengthIntegerDecoder {
+    /**
+     * Decodes an integer from a Uint8Array using variable-length integer encoding.
+     * @param data The Uint8Array to decode.
+     * @returns The decoded integer.
+     */
+    decode(data: Uint8Array): bigint | null;
+    getNumBytesForLengthInteger(data: Uint8Array): number;
+}
+export { VariableLengthIntegerEncoder, VariableLengthIntegerDecoder };

package/utils/Welford.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Класс, реализующий алгоритм для подсчета среднего налету без хранения чисел
+ */
+export declare class Welford {
+    private n;
+    private mean;
+    add(x: number): void;
+    get avg(): number;
+}

package/worker/LibVPxDecoderWorker.d.ts

@@ -1,4 +1,3 @@
-/// <reference lib="webworker" />
 import type libvpx from '@vkontakte/libvpx';
 declare const _default: (vpx: typeof libvpx, urlResolver: (url: string) => string) => void;
 export default _default;

package/worker/LibVPxEncoderWorker.d.ts

@@ -1,4 +1,3 @@
-/// <reference lib="webworker" />
 import type libvpx from '@vkontakte/libvpx';
 declare const _default: (vpx: typeof libvpx, urlResolver: (url: string) => string, useCongestionControl: boolean, maxBitrate: number) => void;
 export default _default;

package/worker/WebCodecsDecoderWorker.d.ts

@@ -1,3 +1,2 @@
-/// <reference lib="webworker" />
 declare const _default: (videoFrameTransferable: boolean) => void;
 export default _default;

package/worker/WebCodecsEncoderWorker.d.ts

@@ -1,3 +1,2 @@
-/// <reference lib="webworker" />
 declare const _default: () => void;
 export default _default;