@vkontakte/calls-sdk 2.8.12-dev.26c45af4.0 → 2.8.12-dev.2e0e572e.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/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,31 +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;
-    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 readonly _debug;
+    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>;