@vibexnpm/talkx 8.5.0 → 8.6.0

package/dist/index.d.ts

@@ -577,6 +577,7 @@ export const DefaultConfig: {
     readonly environment: EnvironmentValue;
     readonly reconnectDelay: number;
     readonly maxReconnectAttempts: number;
+    readonly reconnectRecoveryDelay: number;
     readonly heartbeatIncoming: number;
     readonly heartbeatOutgoing: number;
     readonly apiTimeout: number;
@@ -1609,6 +1610,8 @@ export interface TalkFlowClientOptions {
     maxReconnectDelay?: number;
     /** 최대 재연결 시도. 기본 10. */
     maxReconnectAttempts?: number;
+    /** 기존 연결의 재시도 소진 후 자동 복구 대기(ms, 기본 60000, ±20% 지터). 0이면 비활성화. */
+    reconnectRecoveryDelay?: number;
     /** 수신 하트비트 간격 (ms). 기본 10000. */
     heartbeatIncoming?: number;
     /** 발신 하트비트 간격 (ms). 기본 10000. */
@@ -2093,6 +2096,8 @@ export interface TalkFlowClientEvents {
     mediaStateChanged: unknown;
     callStarted: unknown;
     callEnded: unknown;
+    /** 그룹 통화 재참가가 불가능해 로컬 통화를 종료한 경우. */
+    callRecoveryFailed: { roomId: string; error: unknown };
     callRequested: unknown;
     callAccepted: unknown;
     callRejected: unknown;
@@ -2186,6 +2191,8 @@ export interface WebRTCClientEvents {
     error: unknown;
     callStarted: unknown;
     callEnded: unknown;
+    /** 그룹 통화 재참가가 불가능해 로컬 통화를 종료한 경우. */
+    callRecoveryFailed: { roomId: string; error: unknown };
     callRequested: unknown;
     callAccepted: unknown;
     callRejected: unknown;
@@ -2394,6 +2401,13 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
     resumeAssistantStreams(reason?: string): Promise<void>;
 }
 
+/** POST /api/v1/webrtc/rooms 요청. 생략한 값은 서버 기본값을 사용합니다. */
+export interface CreateCallRoomRequest {
+    invitedUsers?: string[];
+    title?: string;
+    maxParticipants?: number;
+}
+
 export class WebRTCClient implements SdkEventEmitter<WebRTCClientEvents> {
     on<K extends keyof WebRTCClientEvents>(event: K, listener: (payload: WebRTCClientEvents[K]) => void): () => void;
     once<K extends keyof WebRTCClientEvents>(event: K, listener: (payload: WebRTCClientEvents[K]) => void): () => void;
@@ -2405,7 +2419,7 @@ export class WebRTCClient implements SdkEventEmitter<WebRTCClientEvents> {
     initializeIceServers(): Promise<RTCIceServer[]>;
     getTurnCredentials(): Promise<{ iceServers: RTCIceServer[] }>;
 
-    createCallRoom(data: unknown): Promise<unknown>;
+    createCallRoom(data: CreateCallRoomRequest): Promise<unknown>;
     getCallRoom(roomId: string): Promise<unknown>;
     joinCallRoomApi(roomId: string): Promise<unknown>;
     leaveCallRoomApi(roomId: string): Promise<unknown>;
@@ -2631,6 +2645,10 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     changeMyPassword(params: { currentPassword: string; newPassword: string }): Promise<unknown>;
 
     // Connection lifecycle
+    /**
+     * 연결 완료까지 기다립니다. 이전 연결의 자동 복구가 이어지는 동안 재시도 한도 소진으로 reject하지 않습니다.
+     * 복구 연결 시 resolve하며, 명시적 disconnect·인증 종료·최초 연결 실패 시 reject합니다.
+     */
     connect(jwt?: string, options?: ConnectOptions): Promise<void>;
     disconnect(): Promise<void>;
     logout(): Promise<void>;
@@ -2859,7 +2877,7 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     initializeIceServers(): Promise<RTCIceServer[]>;
     getTurnCredentials(): Promise<{ iceServers: RTCIceServer[] }>;
 
-    createCallRoom(data: unknown): Promise<unknown>;
+    createCallRoom(data: CreateCallRoomRequest): Promise<unknown>;
     getCallRoom(roomId: string): Promise<unknown>;
     joinCallRoomApi(roomId: string): Promise<unknown>;
     leaveCallRoomApi(roomId: string): Promise<unknown>;