@vibexnpm/talkx 8.5.0 → 8.7.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;
@@ -1043,14 +1044,20 @@ export interface DecisionResponse {
     optionId: string;
 }
 
+/**
+ * 회사 역할. `GUEST` 는 회사 밖에서 초대받아 그 회사 계정을 가진 사람이다 — 초대받은 방에서 채팅만 하고 PM·AI 버튼·조직도·
+ * 방 만들기·초대 등은 서버가 막는다(403 `GUEST_FORBIDDEN`). 화면 노출 판단용이며 인가 근거는 아니다.
+ */
+export type CompanyRole = 'PARTNER' | 'MEMBER' | 'GUEST';
+
 /** 로그인한 회원. `userId` 는 메시지 발신자 식별과 같은 값이다. */
 export interface LoginMember {
     userId: string;
     email?: string | null;
     nickname?: string | null;
     profileUrl?: string | null;
-    /** 회사 역할 — 클라이언트가 파트너 화면 노출을 결정한다. 인가 근거는 아니다(서버가 재확인). */
-    companyRole: 'PARTNER' | 'MEMBER';
+    /** 회사 역할 — 클라이언트가 파트너·게스트 화면 노출을 결정한다. 인가 근거는 아니다(서버가 재확인). */
+    companyRole: CompanyRole;
     preferredLanguage?: string | null;
     /**
      * 초기 비밀번호를 아직 안 바꿨는가 — `true` 면 **비밀번호 변경 화면으로 보내라**.
@@ -1062,11 +1069,11 @@ export interface LoginMember {
 }
 
 /**
- * `TalkFlowClient.loginUser` 응답.
- *
- * 회사 선택 단계가 없다 — 로그인 키가 전역 유일이라 이메일 하나로 회원과 회사가 함께 정해진다.
+ * `TalkFlowClient.loginUser` 의 로그인 성공 응답. 회사 선택이 필요하면 대신 {@link WorkspaceSelection} 이 온다 —
+ * `workspaceSelectionRequired` 로 가른다.
  */
 export interface LoginResult {
+    workspaceSelectionRequired?: false;
     /** SDK가 저장·회전하는 갱신 자격. 직접 API를 쓰는 경우에만 응답에서 사용한다. */
     refreshToken?: string;
     /** 서버 현재 시각 및 refresh 만료 시각, Unix epoch 밀리초. */
@@ -1082,6 +1089,23 @@ export interface LoginResult {
     user: LoginMember;
 }
 
+/** 로그인 회사 선택지 하나. */
+export interface Workspace {
+    projectId: string;
+    companyName: string | null;
+    /** 그 회사에서의 역할 — 선택 화면에 «게스트» 표시를 붙이는 데 쓴다. */
+    companyRole: CompanyRole;
+}
+
+/**
+ * 로그인 회사 선택 결과 — 같은 이메일의 여러 회사 계정에서 비밀번호가 둘 이상 맞았다. **토큰이 없고 저장된 세션은 그대로다.**
+ * 고른 `projectId` 를 실어 같은 이메일·비밀번호로 `loginUser` 를 다시 부른다.
+ */
+export interface WorkspaceSelection {
+    workspaceSelectionRequired: true;
+    workspaces: Workspace[];
+}
+
 /** 회사 조직도의 회원 — 초대 UI 에 필요한 것만. */
 export interface DirectoryMember {
     userId: string;
@@ -1123,7 +1147,7 @@ export interface MyProfile {
     phone?: string | null;
     profileUrl?: string | null;
     /** 회사 역할 — 방 역할(ParticipantResponse.role)과 다른 축이다. */
-    companyRole: 'PARTNER' | 'MEMBER';
+    companyRole: CompanyRole;
     orgNodeId?: string | null;
     orgName?: string | null;
     preferredLanguage?: string | null;
@@ -1169,6 +1193,10 @@ export interface ParticipantResponse {
     role: 'OWNER' | 'ADMIN' | 'MEMBER' | 'ASSISTANT';
     /** 참가 시각(epoch millis). */
     joinedAt: number;
+    /**
+     * 회사 역할 — 게스트 배지(`GUEST`)용. 방 역할({@link role})과 다른 축이다. PM(ASSISTANT)·정보를 못 찾은 참여자는 없다.
+     */
+    companyRole?: CompanyRole;
 }
 
 /** 채팅방 last message preview. */
@@ -1279,6 +1307,8 @@ export interface RoomListMemberInfo {
     userId: string;
     nickname?: string | null;
     profileUrl?: string | null;
+    /** 회사 역할 — 방금 들어온 게스트에도 다시 읽지 않고 배지를 그린다. PM·역할을 모르는 경로는 없다. */
+    companyRole?: CompanyRole;
 }
 
 export interface RoomListUpdateEvent {
@@ -1609,6 +1639,8 @@ export interface TalkFlowClientOptions {
     maxReconnectDelay?: number;
     /** 최대 재연결 시도. 기본 10. */
     maxReconnectAttempts?: number;
+    /** 기존 연결의 재시도 소진 후 자동 복구 대기(ms, 기본 60000, ±20% 지터). 0이면 비활성화. */
+    reconnectRecoveryDelay?: number;
     /** 수신 하트비트 간격 (ms). 기본 10000. */
     heartbeatIncoming?: number;
     /** 발신 하트비트 간격 (ms). 기본 10000. */
@@ -1931,7 +1963,7 @@ export interface ChatMessageReceivedPayload {
 
 export interface MemberChangePayload {
     roomId: string;
-    members: Array<{ userId: string; nickname?: string; profileUrl?: string | null }>;
+    members: Array<{ userId: string; nickname?: string; profileUrl?: string | null; companyRole?: CompanyRole }>;
     participantCount: number;
     timestamp?: number;
 }
@@ -2093,6 +2125,8 @@ export interface TalkFlowClientEvents {
     mediaStateChanged: unknown;
     callStarted: unknown;
     callEnded: unknown;
+    /** 그룹 통화 재참가가 불가능해 로컬 통화를 종료한 경우. */
+    callRecoveryFailed: { roomId: string; error: unknown };
     callRequested: unknown;
     callAccepted: unknown;
     callRejected: unknown;
@@ -2186,6 +2220,8 @@ export interface WebRTCClientEvents {
     error: unknown;
     callStarted: unknown;
     callEnded: unknown;
+    /** 그룹 통화 재참가가 불가능해 로컬 통화를 종료한 경우. */
+    callRecoveryFailed: { roomId: string; error: unknown };
     callRequested: unknown;
     callAccepted: unknown;
     callRejected: unknown;
@@ -2394,6 +2430,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 +2448,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>;
@@ -2588,16 +2631,18 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     /**
      * 회원 로그인 — 클라이언트 생성 **전에** 호출한다. Server Key 도 고객사 BFF 도 필요 없다.
      * 응답의 `clientKey`/`projectId`/`accessToken` 이 그대로 SDK 초기화 입력이다.
-     * 회사 선택 단계가 없다 — 로그인 키가 전역 유일이다.
+     * 같은 이메일로 비밀번호가 맞는 회사 계정이 둘 이상이면 {@link WorkspaceSelection} 이 온다 — 고른 `projectId` 로 다시 부른다.
      */
     static loginUser(options: {
         serverUrl: string;
         email: string;
         password: string;
-    }): Promise<LoginResult>;
+        /** 회사 선택 응답에서 고른 회사. */
+        projectId?: string;
+    }): Promise<LoginResult | WorkspaceSelection>;
 
-    /** 회원 로그인 (인스턴스) — 재로그인·계정 전환용. 성공 시 토큰을 자동 설정한다. */
-    loginUser(credentials: { email: string; password: string }): Promise<LoginResult>;
+    /** 회원 로그인 (인스턴스) — 재로그인·계정 전환용. 성공 시 토큰을 자동 설정한다. 회사 선택 결과면 토큰을 설정하지 않는다. */
+    loginUser(credentials: { email: string; password: string; projectId?: string }): Promise<LoginResult | WorkspaceSelection>;
 
     /** localStorage의 refresh로 복구. 세션이 없으면 null, 네트워크/서버 장애는 reject. */
     static restoreSession(options: { serverUrl: string }): Promise<LoginResult | null>;
@@ -2631,6 +2676,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 +2908,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>;