@vibexnpm/talkx 9.1.0 → 9.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@vibexnpm/talkx",
-    "version": "9.1.0",
+    "version": "9.2.0",
     "type": "module",
     "description": "TalkFlow SDK - Chat & video call (LiveKit SFU) unified client",
     "main": "dist/talkflow-sdk.umd.js",

package/src/chat/ChatClient.js

@@ -283,11 +283,13 @@ class ChatClient extends EventEmitter {
      *   'GROUP' 은 "그룹 탭" 시맨틱 — PRIVATE_GROUP/TEAM 을 포함한 그룹 전체를 반환
      *   (PRIVATE_GROUP/TEAM 값을 보내도 동일하게 그룹 전체 — 타입별 정확 필터 아님).
      *   특정 타입만 필요하면 응답의 {@code roomType} 필드로 클라이언트에서 거른다.
+     * @param {'USER'|'SCHEDULED_REPORT'} [params.origin] - 만든 경위 필터. {@code USER} = 사람이 만든 방,
+     *   {@code SCHEDULED_REPORT} = 예약 보고 전용 방. 생략 시 전부. 커서 페이지라 클라이언트에서 거르면 뒤쪽 방을 놓친다.
      * @returns {Promise<Object>}
      */
     async getRooms(params = {}) {
-        const { size = 50, lastId, lastSortValue, type } = params;
-        return this.apiClient.get('/api/v1/rooms/my', { size, lastId, lastSortValue, type });
+        const { size = 50, lastId, lastSortValue, type, origin } = params;
+        return this.apiClient.get('/api/v1/rooms/my', { size, lastId, lastSortValue, type, origin });
     }
 
     /**

package/src/constants.js

@@ -218,6 +218,19 @@ export const ChatRoomType = {
     TEAM: 'TEAM'
 };
 
+/**
+ * 방이 생긴 경위 (서버 {@code ChatRoomOrigin} enum 과 일치).
+ *
+ * <ul>
+ *   <li>{@code USER} — 사람이 만든 방. 목록 거르기 값이고, 방 응답에는 칸이 오지 않는다</li>
+ *   <li>{@code SCHEDULED_REPORT} — 예약 보고가 만든 전용 방</li>
+ * </ul>
+ */
+export const ChatRoomOrigin = {
+    USER: 'USER',
+    SCHEDULED_REPORT: 'SCHEDULED_REPORT'
+};
+
 /**
  * 어시스턴트 참여 모드 (서버 {@code AssistantMode} enum 과 일치).
  *

package/src/index.js

@@ -47,6 +47,7 @@ export {
     ChatMessageType,
     DecisionCardLimits,
     ChatRoomType,
+    ChatRoomOrigin,
     AssistantMode,
     RoomAiType,
     EngagementIntensity,

package/types/__typetests__/roomOrigin.types.ts

@@ -0,0 +1,32 @@
+/**
+ * 방 만든 경위 타입 — docs/scheduled-reports.md «예약 방 구분» 예제가 <b>실제로 컴파일되는지</b>.
+ *
+ * <p>거르기 값은 둘이고, 방 응답의 칸은 예약 방일 때만 있다.</p>
+ *
+ * <p>실행: {@code npm run typecheck}</p>
+ */
+import TalkFlowClient, { ChatRoomOrigin } from '../index';
+import type { ChatRoomOriginValue, ChatRoomResponse, RoomMeta } from '../index';
+
+declare const talkflow: TalkFlowClient;
+declare const room: ChatRoomResponse;
+declare const meta: RoomMeta;
+
+async function tabs(): Promise<void> {
+    await talkflow.getRooms({ origin: 'USER', size: 50 });
+    await talkflow.getRooms({ origin: ChatRoomOrigin.SCHEDULED_REPORT, type: 'GROUP' });
+    await talkflow.getRooms();
+
+    // @ts-expect-error — 거르기 값은 USER·SCHEDULED_REPORT 뿐이다.
+    await talkflow.getRooms({ origin: 'BOT' });
+}
+
+const isReportRoom: boolean = room.origin === 'SCHEDULED_REPORT';
+const fromEvent: boolean = meta.origin === ChatRoomOrigin.SCHEDULED_REPORT;
+const peopleRoomEvent: boolean = meta.origin === null;
+const value: ChatRoomOriginValue = ChatRoomOrigin.USER;
+
+// @ts-expect-error — 방 응답에 USER 는 오지 않는다. 칸이 없으면 사람이 만든 방이다.
+const never: boolean = room.origin === 'USER';
+
+void [tabs, isReportRoom, fromEvent, peopleRoomEvent, value, never];

package/types/index.d.ts

@@ -143,6 +143,15 @@ export const ChatRoomType: {
 };
 export type ChatRoomTypeValue = typeof ChatRoomType[keyof typeof ChatRoomType];
 
+/** 방이 생긴 경위 — 사람이 만든 방({@code USER}) · 예약 보고 전용 방({@code SCHEDULED_REPORT}). */
+export const ChatRoomOrigin: {
+    /** 사람이 만든 방 — {@link CursorPageParams.origin} 거르기 값. 방 응답에는 칸이 오지 않는다. */
+    readonly USER: 'USER';
+    /** 예약 보고가 만든 전용 방. */
+    readonly SCHEDULED_REPORT: 'SCHEDULED_REPORT';
+};
+export type ChatRoomOriginValue = typeof ChatRoomOrigin[keyof typeof ChatRoomOrigin];
+
 export const AssistantMode: {
     readonly GENERAL: 'GENERAL';
     readonly PEOPLE_ONLY: 'PEOPLE_ONLY';
@@ -1256,6 +1265,8 @@ export interface ChatRoomResponse {
     assistantMode?: AssistantModeValue;
     /** 방 AI 사용 방식 (상위 SSOT). 구버전 서버 응답에서는 없을 수 있음. */
     roomAiType?: RoomAiTypeValue;
+    /** 방이 생긴 경위 — 예약 보고 전용 방만 값이 있다. 없으면 사람이 만든 방이다. */
+    origin?: 'SCHEDULED_REPORT';
     /** PM 개입 강도 (PM_BACKSTAGE 방 전용). 그 외 방 타입/구버전 응답에서는 없을 수 있음. */
     engagementIntensity?: EngagementIntensityValue;
     roomName: string;
@@ -1645,6 +1656,8 @@ export interface RoomMeta {
     roomAiType?: RoomAiTypeValue;
     /** ROOM_UPDATED 메타의 PM 개입 강도 (PM_BACKSTAGE 방 전용). */
     engagementIntensity?: EngagementIntensityValue;
+    /** ROOM_UPDATED 메타의 방 만든 경위 — 예약 보고 전용 방만 값이 있고, 사람이 만든 방은 {@code null} 이다. */
+    origin?: 'SCHEDULED_REPORT' | null;
 }
 
 /** 채팅방 리스트 실시간 업데이트 이벤트. */
@@ -2075,6 +2088,8 @@ export interface CursorPageParams {
     lastSortValue?: number | string;
     /** 방 리스트에서 타입 필터. */
     type?: ChatRoomTypeValue;
+    /** 방 리스트에서 만든 경위 필터. 커서 페이지라 클라이언트에서 거르면 뒤쪽 방을 놓친다. */
+    origin?: ChatRoomOriginValue;
 }
 
 /**