@vkontakte/calls-sdk 2.8.6-dev.97c05c29.0 → 2.8.6-dev.9cc6d398.0

package/classes/Conversation.d.ts

@@ -78,19 +78,18 @@ export default class Conversation extends EventEmitter {
     private _onJoinPart2;
     private _extractExternalRooms;
     private _extractExternalRoomsData;
-    onPush(conversationId: string, type?: UserType, peerId?: number, conversationParams?: string): Promise<void>;
+    onPush(conversationId: string, type?: UserType, peerId?: number): Promise<void>;
     private _isInWaitingHall;
     private _isRestricted;
     private _isAudienceMode;
     private _isAudienceModeListener;
     private _acceptConcurrent;
     private _getMainRoomParticipants;
-    private _decodeExternalConversationParams;
-    private _logCallStartEvent;
     accept(mediaOptions: MediaOption[]): Promise<ConversationData>;
     decline(): Promise<void>;
     hangup(): Promise<void>;
-    addParticipant(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
+    addParticipant(participantIds: ExternalId[], params?: AddParticipantParams): Promise<void>;
+    addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<void>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<void>;
     setVolume(volume: number): void;
     updateStatisticsInterval(): void;
@@ -98,7 +97,6 @@ export default class Conversation extends EventEmitter {
     private _close;
     destroy(): void;
     private _getConversationParams;
-    private _setConversationParams;
     private _addGeoParamsToEndpoint;
     /**
      * @throws ErrorEvent

package/default/Signaling.d.ts

@@ -33,6 +33,7 @@ export default class Signaling extends BaseSignaling {
     private responseHandlers;
     private reconnectCount;
     private endpoint;
+    private wtEndpoint;
     protected conversationResolve: Function | null;
     protected conversationReject: Function | null;
     private connected;
@@ -57,6 +58,7 @@ export default class Signaling extends BaseSignaling {
     private static _getCapabilityFlags;
     get ready(): boolean;
     setEndpoint(endpoint: string): void;
+    setWebTransportEndpoint(endpoint: string | null): void;
     setConversationId(conversationId: string): void;
     setParticipantIdRegistry(participantIdRegistry: ParticipantIdRegistry): void;
     setProducerNotificationDataChannel(dataChannel: RTCDataChannel): void;
@@ -88,7 +90,8 @@ export default class Signaling extends BaseSignaling {
     changeMediaSettings(mediaSettings: MediaSettings): Promise<SignalingMessage>;
     changeParticipantState(state: ParticipantStateData, compositeUserId?: CompositeUserId): Promise<SignalingMessage>;
     putHandsDown(): Promise<SignalingMessage>;
-    addParticipant(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
+    addParticipant(externalIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
+    addParticipantLegacy(participantIds: CompositeUserId[], params?: AddParticipantParams): Promise<SignalingMessage>;
     removeParticipant(participantId: CompositeUserId, ban?: boolean): Promise<SignalingMessage>;
     allocateConsumer(description: RTCSessionDescription | null, capabilities: {
         [key: string]: number | boolean | string;
@@ -160,7 +163,7 @@ export default class Signaling extends BaseSignaling {
     startAsr(params: IAsrStartParams): Promise<SignalingMessage>;
     stopAsr(params?: IAsrStopParams): Promise<SignalingMessage>;
     requestAsr(request: boolean): Promise<SignalingMessage>;
-    protected _connect(connectionType: SignalingConnectionType): void;
+    protected _connect(connectionType: SignalingConnectionType, useWebTransport: boolean): void;
     protected _disconnect(code?: number): void;
     private _onOpen;
     private _onMessage;
@@ -182,4 +185,5 @@ export default class Signaling extends BaseSignaling {
     protected _stopWaitConnectionMessage(): void;
     private _startDoctor;
     private _stopDoctor;
+    private isWebtransportAvailable;
 }

package/enums/Stat.d.ts

@@ -37,7 +37,6 @@ declare const enum Stat {
     FIRST_MEDIA_RECEIVED = "first_media_received",
     CALL_EVENTUAL_STAT = "callEventualStat",
     CALL_DECLINED_OR_HANGED_LOCALLY = "CallDeclinedOrHangedLocally",
-    USER_FEEDBACK_RECEIVED = "UserFeedbackReceived",
-    CALL_START = "call_start"
+    USER_FEEDBACK_RECEIVED = "UserFeedbackReceived"
 }
 export default Stat;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vkontakte/calls-sdk",
-  "version": "2.8.6-dev.97c05c29.0",
+  "version": "2.8.6-dev.9cc6d398.0",
   "author": "vk.com",
   "description": "Library for video calls based on the vk.com platform",
   "homepage": "https://vk.com",
@@ -14,11 +14,14 @@
     "**/*.d.ts"
   ],
   "dependencies": {
+    "@fails-components/webtransport": "^1.3.0",
+    "@fails-components/webtransport-transport-http3-quiche": "^1.3.0",
     "@vkontakte/calls-audio-effects": "1.2.8",
     "@vkontakte/calls-video-effects": "2.2.3-beta.5",
     "@vkontakte/calls-vmoji": "1.0.10-beta.17",
     "@vkontakte/libvpx": "2.0.9",
     "bit-buffer": "0.2.5",
+    "fflate": "^0.8.2",
     "messagepack": "1.1.12",
     "simple-ebml-builder": "0.2.2",
     "webrtc-adapter": "7.7.0"

package/static/Params.d.ts

@@ -461,6 +461,31 @@ export type ParamsObject = {
      * _По умолчанию: `false`_
      */
     enableLogPerfStatReport: boolean;
+    /**
+     * Поддержка переключения качества видео в зависимости от сети
+     * Только для режима p2p
+     *
+     * _По умолчанию: `false`_
+     */
+    switchVideoAtBadNetwork: boolean;
+    /**
+     * Включает деградацию фпс для видео с камеры при низком фпс с включенными вирт фонами
+     *
+     * _По умолчанию: `false`_
+     */
+    enableVideoEffectsFpsDegradation: boolean;
+    /**
+     * Включить поддержку simulcast на отправке
+     *
+     * _По умолчанию: `false`_
+     */
+    simulcast: boolean;
+    /**
+     * Включить поддержку webtransport для сигналинга
+     *
+     * _По умолчанию: `false`_
+     */
+    webtransport: boolean;
     /**
      * Получен локальный стрим с камеры/микрофона
      */
@@ -834,27 +859,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;
@@ -984,7 +988,8 @@ 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 toJSON(): {
         apiKey: string;
         apiEnv: string;
@@ -1013,5 +1018,7 @@ export default abstract class Params {
         clientStatsPlatform: string;
         consumerScreenDataChannelPacketSize: number;
         switchVideoAtBadNetwork: boolean;
+        simulcast: boolean;
+        webtransport: boolean;
     };
 }

package/types/ConversationParams.d.ts

@@ -10,17 +10,6 @@ type ConversationParams = {
     isp_as_org?: string;
     loc_cc?: string;
     loc_reg?: string;
-    external_user_type?: string;
-};
-export type ExternalConversationParams = {
-    et: number;
-    iv: boolean;
-    srcp: string;
-    stne: string;
-    tkn: string;
-    trne: string;
-    trnp: string;
-    trnu: string;
-    wse: string;
+    external_user_type: string;
 };
 export default ConversationParams;

package/types/ConversationResponse.d.ts

@@ -1,5 +1,4 @@
 import HangupType from '../enums/HangupType';
-import IceServer from './IceServer';
 /**
  * Начальные данные создания звонка
  * @hidden
@@ -13,6 +12,10 @@ type ConversationResponse = {
      * URL для подключения
      */
     endpoint: string;
+    /**
+     * URL для подключения по WebTransport
+     */
+    wt_endpoint?: string;
     /**
      * Токен комнаты для подключения к звонку по ссылке
      */
@@ -28,9 +31,5 @@ type ConversationResponse = {
      * Порядковый номер, присвоенный устройству при входе в звонок
      */
     device_idx?: number;
-    turn_server?: IceServer;
-    stun_server?: IceServer;
-    client_type?: string;
-    token: string;
 };
 export default ConversationResponse;

package/types/ExternalId.d.ts

@@ -19,6 +19,7 @@ export declare namespace ExternalIdUtils {
     function fromId(id: ExternalUserId, type?: ExternalIdType, deviceIdx?: number): ExternalParticipantId;
     function fromSignalingParticipant(participant: SignalingMessage.Participant, useDecorative?: boolean): ExternalParticipantId | undefined;
     function fromSignaling(signalingId: SignalingMessage.ExternalId, deviceIdx?: number): ExternalParticipantId;
+    function toSignaling(externalId: ExternalId): string;
     function toString(externalId: ExternalId): ExternalIdString;
     function fromIdToString(id: ExternalUserId, type?: ExternalIdType, deviceIdx?: number): ExternalIdString;
     function fromString(stringId: ExternalIdString): ExternalParticipantId;

package/types/WebTransport.d.ts

@@ -0,0 +1,34 @@
+interface WebTransportHash {
+    algorithm?: string;
+    value?: BufferSource;
+}
+interface WebTransportOptions {
+    allowPooling?: boolean;
+    congestionControl?: CongestionControlType;
+    requireUnreliable?: boolean;
+    serverCertificateHashes?: WebTransportHash[];
+}
+type CongestionControlType = 'default' | 'low-latency' | 'throughput';
+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 readLoop;
+    send(data: string): Promise<void>;
+    close(code?: number, reason?: string): void;
+}
+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/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;
+    getNumBytesForLengthInteger(data: Uint8Array): number;
+}
+export { VariableLengthIntegerEncoder, VariableLengthIntegerDecoder };

package/utils/Lz4.d.ts

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