@vibexnpm/talkx 5.2.0 → 5.3.0

package/README.md

@@ -75,6 +75,7 @@ await client.connect(jwtToken, { enablePush: true });
 | [chat.md](docs/chat.md) | 채팅방 관리, 메시지 전송, 파일 업로드, 답글, 리액션, 핀, 타이핑, 채팅방 리스트 실시간 갱신, **AI 어시스턴트 페르소나 (멘션 응답)** |
 | [push.md](docs/push.md) | **웹 푸시 알림.** 권한 lifecycle, 활성화 패턴 (자동 vs 사용자 액션), 디바이스 토글, 알림 클릭 라우팅 |
 | [webrtc.md](docs/webrtc.md) | 1:1 / 그룹 통화, 미디어 제어, 디바이스 관리, TURN 서버 |
+| [vote.md](docs/vote.md) | **투표.** 생성(멱등키 필수) · 투표/재투표 · 결과 마스킹 · 이미지 선택지 · 채팅 카드 렌더링 |
 | [events.md](docs/events.md) | 모든 이벤트 레퍼런스. 채팅 이벤트 처리 패턴 (`eventType` 분기 vs 상태 필드 렌더) |
 | [errors.md](docs/errors.md) | 에러 분류 (`PushErrorReason`, `ErrorTypes`), HTTP 상태 코드, 입력 제약 |
 

package/dist/index.d.ts

@@ -1260,6 +1260,29 @@ export interface AssistantRoomProgressEvent {
     textAvailable?: boolean;
 }
 
+/** {@link ChatClient.getAssistantProgress} 가 돌려주는 stream 1건. */
+export interface AssistantProgressStreamSnapshot {
+    streamId: string;
+    personaId: string | null;
+    phase: 'THINKING' | 'SEARCHING' | 'PLANNING' | 'WRITING' | null;
+    label: string | null;
+    text: string | null;
+    textAvailable: boolean;
+    /** 서버 스냅샷으로 복원된 진행분이면 true. */
+    resumed: boolean;
+}
+
+/**
+ * 방의 **현재** AI 진행 상태 (v5.3.0 — {@link ChatClient.getAssistantProgress} 반환).
+ *
+ * <p>{@link AssistantRoomProgressEvent} 와 같은 형태에 stream 단위 UI 를 위한 `streams` 가 더해진다.
+ * 이벤트는 transient 라 화면을 나갔다 들어오면 다시 오지 않는다 — 마운트 시 이걸 한 번 읽는다.</p>
+ */
+export interface AssistantProgressSnapshot extends AssistantRoomProgressEvent {
+    /** 살아 있는 stream 전체 (도착 순서). 없으면 빈 배열. */
+    streams: AssistantProgressStreamSnapshot[];
+}
+
 // ============================================================================
 // Options — constructor & method
 // ============================================================================
@@ -2017,6 +2040,17 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
 
     startTyping(roomId: string): void;
     stopTyping(roomId: string): void;
+
+    /**
+     * 방의 현재 AI 진행 상태를 즉시 반환 (네트워크 호출 없음, v5.3.0).
+     * 진행 표시 이벤트는 transient 라 방 화면 마운트 시 이걸 읽어 버블을 복원한다.
+     */
+    getAssistantProgress(roomId: string): AssistantProgressSnapshot;
+    /**
+     * 구독 중인 모든 방의 진행 스트림 스냅샷을 서버에서 다시 받는다 (v5.1.0).
+     * 재연결·탭 복귀 때 SDK 가 자동 호출하므로 보통은 직접 부를 일이 없다.
+     */
+    resumeAssistantStreams(reason?: string): Promise<void>;
 }
 
 export class WebRTCClient implements SdkEventEmitter<WebRTCClientEvents> {
@@ -2400,6 +2434,17 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
     startTyping(roomId: string): void;
     stopTyping(roomId: string): void;
 
+    /**
+     * 방의 현재 AI 진행 상태를 즉시 반환 (네트워크 호출 없음, v5.3.0).
+     * 진행 표시 이벤트는 transient 라 방 화면 마운트 시 이걸 읽어 버블을 복원한다.
+     */
+    getAssistantProgress(roomId: string): AssistantProgressSnapshot;
+    /**
+     * 구독 중인 모든 방의 진행 스트림 스냅샷을 서버에서 다시 받는다 (v5.1.0).
+     * 재연결·탭 복귀 때 SDK 가 자동 호출하므로 보통은 직접 부를 일이 없다.
+     */
+    resumeAssistantStreams(reason?: string): Promise<void>;
+
     // WebRTC delegations
     initializeIceServers(): Promise<RTCIceServer[]>;
     getTurnCredentials(): Promise<{ iceServers: RTCIceServer[] }>;