@vkontakte/calls-sdk 2.8.6-dev.3c52c9a0.0 → 2.8.6-dev.3e1160f3.0

package/types/Statistics.d.ts

@@ -27,47 +27,194 @@ export interface ILocalIceCandidateStat extends IRemoteIceCandidateStat {
 interface StatRtpOutboundVideo {
     frameHeight?: number;
     frameWidth?: number;
+    /**
+     * Идентификатор потока RTP (RID).
+     *
+     * Используется для идентификации различных потоков видео (например, simulcast) в сессиях WebRTC.
+     */
     rid?: string;
     framesSent?: number;
     framesPerSecond?: number;
     targetBitrate?: number;
 }
 export interface StatRtp extends StatRtpOutboundVideo {
+    /**
+     * Уникальный идентификатор источника синхронизации RTP
+     */
     ssrc: number;
+    /**
+     * Идентификатор медиалинии (MID)
+     *
+     * Используется для уникальной идентификации медиалинии в рамках WebRTC-сессии.
+     * MID помогает сопоставлять медиапотоки с их соответствующими трансиверами.
+     */
+    mid?: string;
+    /**
+     * Тип статистики (например, inbound-rtp, outbound-rtp)
+     */
     type: string;
+    /**
+     * Тип медиа (например, audio, video)
+     */
     kind: string;
+    /**
+     * Общее количество байтов, полученных по этому потоку
+     */
     bytesReceived: number;
+    /**
+     * Общее количество байтов, отправленных по этому потоку
+     */
     bytesSent: number;
+    /**
+     * Общее количество байтов заголовков, полученных по этому потоку
+     */
     headerBytesReceived: number;
+    /**
+     * Общее количество байтов заголовков, отправленных по этому потоку
+     */
     headerBytesSent: number;
+    /**
+     * Среднее значение джиттера в секундах
+     * Джиттер — это вариация задержки в получении пакетов данных.
+     */
     jitter: number;
+    /**
+     * Общее количество потерянных пакетов
+     */
     packetsLost: number;
+    /**
+     * Общее количество полученных пакетов
+     */
     packetsReceived: number;
+    /**
+     * Общее количество отправленных пакетов
+     */
     packetsSent: number;
+    /**
+     * Доля потерянных пакетов
+     */
     fractionLost: number;
+    /**
+     * Количество Picture Loss Indication (PLI) сообщений
+     * PLI — это сообщения, указывающие на потерю кадров изображения.
+     */
     pliCount: number;
+    /**
+     * Количество Full Intra Request (FIR) сообщений
+     * FIR — это запросы на отправку полного внутрикодированного кадра.
+     */
     firCount: number;
+    /**
+     * Количество Negative ACKnowledgement (NACK) сообщений
+     * NACK — это сообщения, указывающие на потерю пакетов данных.
+     */
     nackCount: number;
+    /**
+     * Идентификатор пользователя, связанный с этим потоком
+     */
     userId?: string;
+    /**
+     * Пропускная способность в битах в секунду
+     */
     bandwidth?: number;
+    /**
+     * Процент потерянных пакетов
+     */
     packetLoss?: number;
+    /**
+     * Частота дискретизации в герцах
+     * Частота дискретизации определяет качество звука.
+     */
     clockRate?: number;
+    /**
+     * Название кодека
+     * @example audio/opus, video/vp8
+     */
     mimeType?: string;
+    /**
+     * Библиотека, которая используется для кодека
+     */
+    encoderImplementation?: string;
+    /**
+     * Библиотека, которая используется для декодера
+     */
+    decoderImplementation?: string;
+    /**
+     * Параметры кодека, есть только у audio кодеков
+     */
+    sdpFmtpLine?: string;
+    /**
+     * Общее количество декодированных кадров
+     */
     framesDecoded?: number;
+    /**
+     * Общее количество полученных кадров
+     */
     framesReceived?: number;
+    /**
+     * Общее количество отброшенных кадров
+     */
     framesDropped?: number;
+    /**
+     * Изменение количества отброшенных кадров
+     */
     framesDroppedDelta?: number;
+    /**
+     * Изменение задержки между кадрами
+     */
     interframeDelayVariance?: number;
+    /**
+     * Общее количество полученных аудиосэмплов
+     */
     totalSamplesReceived?: number;
+    /**
+     * Общее время кодирования видео в секундах.
+     *
+     * Показывает, сколько времени было потрачено на кодирование видео кадров.
+     * Не применяется для аудио.
+     */
+    totalEncodeTime?: number;
+    /**
+     * Общее количество замаскированных сэмплов
+     */
     concealedSamples?: number;
+    /**
+     * Количество вставленных сэмплов для замедления
+     */
     insertedSamplesForDeceleration?: number;
+    /**
+     * Количество удаленных сэмплов для ускорения
+     */
     removedSamplesForAcceleration?: number;
+    /**
+     * Количество замаскированных беззвучных сэмплов
+     */
     silentConcealedSamples?: number;
+    /**
+     * Количество событий маскировки
+     */
     concealmentEvents?: number;
+    /**
+     * Общее количество аудиоэнергии
+     * Аудиоэнергия — это мера мощности аудиосигнала.
+     */
     totalAudioEnergy?: number;
+    /**
+     * Общее время замерзания в секундах
+     */
     totalFreezesDuration: number;
+    /**
+     * Изменение общего времени замерзания
+     * Время замерзания — это период, в течение которого поток временно останавливается.
+     */
     totalFreezesDurationDelta?: number;
+    /**
+     * Количество событий замерзания
+     */
     freezeCount: number;
+    /**
+     * Изменение количества событий замерзания
+     */
     freezeCountDelta?: number;
 }
 export type StatItem = {

package/types/WebTransport.d.ts

@@ -0,0 +1,25 @@
+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 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

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

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 };