@vkontakte/calls-sdk 2.8.12-dev.dd6d67c5.0 → 2.8.12-dev.dd833275.0

package/types/FastHangup.d.ts

@@ -0,0 +1,66 @@
+import type ClientHangupReason from '../enums/ClientHangupReason';
+import type HangupType from '../enums/HangupType';
+/**
+ * Параметры запроса завершения звонка через внешнего партнёра (fast hangup).
+ *
+ * SDK генерирует объект и передаёт его в {@link FastHangupHandler}.
+ * Хост и backend партнёра пробрасывают `internalParams` как есть, без парсинга.
+ */
+export interface FastHangupParams {
+    /**
+     * ID звонка
+     */
+    conversationId: string;
+    /**
+     * Причина завершения звонка
+     */
+    reason: HangupType;
+    /**
+     * Внутренние параметры звонка (JSON-строка). Генерируется SDK.
+     */
+    internalParams?: string | null;
+}
+/**
+ * Ответ внешнего партнёра на завершение звонка.
+ */
+export interface FastHangupResponse {
+    /**
+     * true — участие в звонке завершено
+     */
+    success: boolean;
+}
+/**
+ * Параметры публичных методов {@link hangup} / {@link declineCall}.
+ *
+ * `reason` и `conversationId` идут в signaling hangup.
+ * `onFastHangup` заменяет Calls API `vchat.hangupConversation`, если обработчик передан
+ * (явный hangup/decline или delayed hangup во время init).
+ * Если обработчик не передан, API hangup не вызывается — кроме закрытия вкладки (`pagehide`),
+ * где SDK всегда шлёт beacon, и delayed hangup без handler.
+ */
+export interface HangupParams {
+    /**
+     * ID звонка. Если опущен — завершается текущий активный звонок.
+     */
+    conversationId?: string;
+    /**
+     * Причина завершения для проброса в сигналинг. См. {@link ClientHangupReason}.
+     */
+    reason?: ClientHangupReason;
+    /**
+     * Обработчик fast hangup — завершение звонка через внешнего партнёра.
+     */
+    onFastHangup?: FastHangupHandler;
+}
+/**
+ * Функция-обработчик fast hangup.
+ *
+ * Если передана в {@link HangupParams.onFastHangup} при `hangup` / `declineCall`,
+ * SDK вызывает её вместо API `vchat.hangupConversation`.
+ *
+ * На `pagehide` не используется — SDK всегда отправляет `sendBeacon`.
+ *
+ * @param params Параметры запроса
+ * @param signal AbortSignal текущего звонка, если он ещё жив на момент вызова
+ */
+export type FastHangupHandler = (params: FastHangupParams, signal?: AbortSignal) => Promise<FastHangupResponse>;

package/types/Participant.d.ts

@@ -49,6 +49,7 @@ export interface ParticipantSessionState {
 }
 export interface ParticipantConnectionStatus {
     transport: ParticipantStatus;
+    stalled: boolean;
     sessionState?: ParticipantSessionState;
     sessionStateApplicable: boolean;
     sessionStateConnectedBySpeaker: boolean;

package/types/PerfStatReporter.d.ts

@@ -24,10 +24,6 @@ export interface CallStatReport {
     audio_concealment_events: number;
     inbound_video_count: number;
     inbound_audio_count: number;
-    packets_lost_video: number;
-    packets_sent_video: number;
-    packets_lost_audio: number;
-    packets_sent_audio: number;
     freeze_count: number;
     total_freezes_duration: number;
     rtt: number;

package/types/SignalingCommand.d.ts

@@ -1,8 +1,10 @@
 import SignalingCommandType from '../enums/SignalingCommandType';
 import { SignalingResponse, SignalingSuccessResponse } from './SignalingMessage';
+export type SignalingCommandRoute = 'websocket' | 'producer';
 interface SignalingCommand<T extends SignalingResponse = SignalingSuccessResponse> {
     sequence: number;
     name: SignalingCommandType;
+    route: SignalingCommandRoute;
     statMarkName: string;
     params: object;
     responseTimer: number;

package/types/SignalingMessage.d.ts

@@ -34,8 +34,11 @@ export type RecordInfo = {
     recordExternalOwnerId?: string;
 };
 export interface SignalingResponse extends SignalingMessage {
-    response?: SignalingCommandType;
     error?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    message?: string;
+    response?: SignalingCommandType;
     reason?: HangupType | FatalError;
     sequence?: number;
     type: 'response' | 'error' | 'timeout';
@@ -185,6 +188,7 @@ declare namespace SignalingMessage {
         peerId: PeerId;
         mediaSettings: Partial<MediaSettings>;
         capabilities?: string;
+        externalId?: ExternalId;
     }
     export interface Hungup extends Notification {
         participantId: OkUserId;

package/types/WebTransport.d.ts

@@ -1,33 +1,32 @@
 import { WebTransportOptions } from '@fails-components/webtransport';
 import { DebugLogger } from '../static/Debug';
 declare class WebTransportEventual {
+    static isBrowserSupported(): boolean;
+    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;
     private webTransport;
-    private stream;
     private writer;
-    private reader;
     private readonly url;
     private readonly options;
     private readonly compression;
-    private closeRequested;
-    private closeEventEmitted;
     private encoder;
     private decoder;
     private readonly _debug;
-    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, debug?: DebugLogger);
+    send(data: string): Promise<void>;
+    close(code?: number, reason?: string): void;
     private getCompressionTypeFromUrl;
     private connect;
-    private readChunks;
+    private observeClosed;
     private readLoop;
-    send(data: string): Promise<void>;
+    private fail;
+    private handleStreamError;
+    private requestNativeClose;
+    private finishClose;
+    private emitEvent;
     private createErrorEvent;
-    close(code?: number, reason?: string): void;
-    private closeConnectedTransport;
-    private emitClose;
-    static isBrowserSupported(): boolean;
 }
 export { WebTransportEventual as WebTransport };

package/utils/IceServers.d.ts

@@ -0,0 +1,2 @@
+import IceServer from '../types/IceServer';
+export declare function createIceServers(stunServer?: IceServer, turnServer?: IceServer): IceServer[];

package/utils/NavigatorPermissions.d.ts

@@ -2,8 +2,8 @@ type Device = 'camera' | 'microphone';
 type PermissionStatusState = typeof PermissionStatus.prototype.state;
 type EventListener = (name: Device, state: PermissionStatusState) => void;
 export declare class NavigatorPermissions {
-    private _cameraPermissionStatus;
-    private _microphonePermissionStatus;
+    private _cameraPermissionStatus?;
+    private _microphonePermissionStatus?;
     private _listener;
     static isSupported(): boolean;
     init(listener: EventListener): Promise<void>;

package/utils/SerializeLatest.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Последовательно выполняет операции, оставляя в очереди только последнее запрошенное значение.
+ * Возвращает ошибку, только если не удалось применить итоговое состояние.
+ */
+export declare function serializeLatest<T>(run: (value: T) => Promise<void> | undefined): (value: T) => Promise<void>;

package/classes/StatsLogger.d.ts

@@ -1,41 +0,0 @@
-import BaseApi from '../abstract/BaseApi';
-import BaseLogger from '../abstract/BaseLogger';
-import StatLog from '../enums/StatLog';
-import TransportTopology from '../enums/TransportTopology';
-type ClientStatsPayload = Record<string, string | number | boolean | undefined | null>;
-export type LogClientStatsOptions = {
-    immediately?: boolean;
-    occurredAt?: number;
-    conversationId?: string | null;
-    deferUntilServerTime?: boolean;
-};
-/**
- * Класс отвечает за отправку различной информации в сервис статистики (события, статистика и подобное)
- */
-export default class StatsLogger extends BaseLogger {
-    private readonly _externalLogger;
-    private readonly _api;
-    private readonly _conversationIdProvider;
-    private readonly _topologyProvider;
-    private readonly _batchInterval;
-    private _batchedClientStats;
-    private _batchTimeout;
-    private _serverTimeDelta;
-    private _waitingForServerTime;
-    private _deferredClientStats;
-    constructor(api: BaseApi, externalLogger: BaseLogger | null, conversationIdProvider: () => string | null, topologyProvider?: () => TransportTopology | undefined);
-    log(name: StatLog, value?: string, immediately?: boolean): void;
-    logClientStats(data: ClientStatsPayload, immediatelyOrOptions?: boolean | LogClientStatsOptions): void;
-    destroy(): void;
-    private _logClientStats;
-    private _getConversationId;
-    private _getCallTopology;
-    private _sendBatch;
-    private _startTimeout;
-    private _stopTimeout;
-    private _sendClientStats;
-    private _calculateServerTimeDelta;
-    private _flushDeferredClientStats;
-    private _now;
-}
-export {};