@vibexnpm/talkx 3.0.3 → 3.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vibexnpm/talkx",
-    "version": "3.0.3",
+    "version": "3.0.4",
     "type": "module",
     "description": "TalkFlow SDK - Chat & WebRTC unified client",
     "main": "dist/talkflow-sdk.umd.js",

package/src/chat/ChatClient.js

@@ -496,14 +496,16 @@ class ChatClient extends EventEmitter {
      *   {@code format}/{@code language} 로 내 키인지 확인) | {@code 'NO_CHANGE'}(새 대화 없음 — 알림 발생 안 함).
      *   {@code format}/{@code language}=이번 요청이 해소한 키(방 단위 경합 식별용).
      *
-     * @fires summaryUpdate - 완료/실패 시 { roomId, status: 'READY'|'NO_CHANGE'|'FAILED', format, language, updatedAt }
+     * @fires summaryUpdate - { roomId, status: 'READY'|'NO_CHANGE'|'FAILED'|'INVALIDATED', format, languages, updatedAt }.
+     *   fan-out 으로 여러 언어를 한 번에 생성하므로 {@code languages} 는 배열(§S1). {@code INVALIDATED} 는 refreshSummary 가
+     *   아니라 방 원문 삭제/편집으로 발생(요약이 통째로 폐기됨).
      *
      * @example
-     * const { status, format, language } = await chat.refreshSummary(roomId, { format: SummarizeFormat.MINUTES, lang: 'ko' });
-     * if (status === 'STARTED') showSpinner();          // 내 키 진행 시작 — summaryUpdate 대기
+     * const { status } = await chat.refreshSummary(roomId, { format: SummarizeFormat.MINUTES, lang: 'ko' });
+     * if (status === 'STARTED') showSpinner();          // fan-out 진행 시작 — summaryUpdate 대기
      * else if (status === 'ALREADY_RUNNING') {
-     *   // 방에서 다른 키가 도는 중일 수 있다. summaryUpdate 의 format+language 가 { minutes, ko } 가 아니면
-     *   // 그때 다시 refreshSummary 로 내 키를 요청한다(재요청 금지가 아니라 "내 키가 아니면 재요청").
+     *   // 방에서 다른 요약이 도는 중일 수 있다. 완료 이벤트 summaryUpdate 의 languages 에 내 언어가 없으면
+     *   // 그때 다시 refreshSummary 로 내 언어를 요청한다(재요청 금지가 아니라 "내 언어가 없으면 재요청").
      *   showSpinner();
      * } else if (status === 'NO_CHANGE') toast('변경 사항이 없습니다');
      */
@@ -2365,23 +2367,24 @@ class ChatClient extends EventEmitter {
     /**
      * Rolling 누적 요약 완료 알림(summary 채널) 수신 처리 — status 를 그대로 {@code summaryUpdate} 로 emit.
      *
-     * <p>서버 {@code SummaryStreamEvent}: {@code { status: 'READY'|'NO_CHANGE'|'FAILED', roomId, format?, language?, updatedAt? }}.
+     * <p>서버 {@code SummaryStreamEvent}: {@code { status: 'READY'|'NO_CHANGE'|'FAILED'|'INVALIDATED', roomId, format?, languages?, updatedAt? }}.
      * assistant-stream 과 달리 단계/토큰 누적이 없어 상태 관리 없이 그대로 통지한다. transient(저장 안 됨)라 UI 는
      * 이벤트를 신호로만 쓰고 확정 내용은 {@link #getSummary} 로 읽는다. {@code READY}=요약 갱신됨(→ getSummary),
-     * {@code FAILED}=실패(재시도 가능), {@code NO_CHANGE}=변경 없음(대개 refreshSummary 응답에서 동기로 이미 받음).</p>
+     * {@code FAILED}=실패(재시도 가능), {@code NO_CHANGE}=변경 없음(대개 refreshSummary 응답에서 동기로 이미 받음),
+     * {@code INVALIDATED}=방 원문 삭제/편집으로 요약이 통째로 버려짐(→ 요약 화면을 즉시 비우고, 필요 시 refreshSummary 로 재생성).</p>
      *
-     * <p><b>키 식별(format+language)</b>: 방 단위로 한 번에 한 요약만 도므로, 여러 포맷·언어를 요청했다면 이 이벤트의
-     * {@code format}+{@code language} 로 <b>어느 키</b>가 완료/실패했는지 가려 내 키가 아니면 다시 refreshSummary 한다.
-     * {@code READY}·{@code FAILED} 모두 키를 싣는다({@code NO_CHANGE} 는 없음).</p>
+     * <p><b>키 식별(format+languages)</b>: 한 refresh 가 방 활성 언어들을 fan-out 으로 한 번에 생성하므로(§S1), 완료
+     * 이벤트의 {@code languages} 에 내 언어가 있으면 {@code getSummary({ format, lang })} 로 읽는다. {@code READY}·
+     * {@code FAILED} 모두 언어 목록을 싣는다({@code NO_CHANGE}·{@code INVALIDATED} 는 없음).</p>
      * @private
      */
     _handleSummaryEvent(roomId, event) {
         if (!event || !event.status) return;
         this.emit('summaryUpdate', {
             roomId,
-            status: event.status,                 // 'READY' | 'NO_CHANGE' | 'FAILED'
-            format: event.format || null,         // READY/FAILED 포함(NO_CHANGE 는 null)
-            language: event.language || null,     // READY/FAILED 포함(NO_CHANGE 는 null) — 키 식별용
+            status: event.status,                 // 'READY' | 'NO_CHANGE' | 'FAILED' | 'INVALIDATED'
+            format: event.format || null,         // READY/FAILED 포함(NO_CHANGE·INVALIDATED 는 null)
+            languages: event.languages || null,   // fan-out 으로 생성/최신화된 언어 목록(READY/FAILED). 그 외 null
             updatedAt: event.updatedAt || null
         });
     }

package/types/index.d.ts

@@ -395,12 +395,18 @@ export interface RoomSummaryView {
  */
 export interface SummaryUpdateEvent {
     roomId: string;
-    /** {@code 'READY'}(갱신됨 → getSummary) | {@code 'FAILED'}(실패 → 재시도 가능) | {@code 'NO_CHANGE'}(변경 없음). */
-    status: 'READY' | 'NO_CHANGE' | 'FAILED';
-    /** 완료/실패한 포맷. {@code READY}·{@code FAILED} 포함, {@code NO_CHANGE} 는 null. */
+    /**
+     * {@code 'READY'}(갱신됨 → getSummary) | {@code 'FAILED'}(실패 → 재시도 가능) | {@code 'NO_CHANGE'}(변경 없음) |
+     * {@code 'INVALIDATED'}(방 원문 삭제/편집으로 요약이 통째로 버려짐 → 화면을 비우고 필요 시 refreshSummary 로 재생성).
+     */
+    status: 'READY' | 'NO_CHANGE' | 'FAILED' | 'INVALIDATED';
+    /** 완료/실패한 포맷. {@code READY}·{@code FAILED} 포함, {@code NO_CHANGE}·{@code INVALIDATED} 는 null. */
     format: string | null;
-    /** 완료/실패한 언어(소문자 BCP-47 / {@code 'OFF'}). {@code READY}·{@code FAILED} 포함, {@code NO_CHANGE} 는 null — format 과 함께 키 식별. */
-    language: string | null;
+    /**
+     * fan-out 으로 한 번에 생성/최신화된 언어 목록(소문자 BCP-47 / {@code 'OFF'}). {@code READY}·{@code FAILED} 포함,
+     * 그 외 null. 각 사용자는 자기 언어가 이 목록에 있으면 {@code getSummary({ format, lang })} 로 읽는다(§S1).
+     */
+    languages: string[] | null;
     /** 갱신 시각. {@code READY} 만 포함, 그 외 null. */
     updatedAt: string | null;
 }