@vibexnpm/talkx 8.11.0 → 8.12.0

package/package.json

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

package/src/chat/ChatClient.js

@@ -1439,14 +1439,16 @@ class ChatClient extends EventEmitter {
      *
      * @param {Object} [params]
      * @param {string} [params.roomId] - 방 하나로 거르기. 생략하면 참여 중인 방 전부. 참여하지 않은 방이면 403
+     * @param {'IMAGE'|'VIDEO'|'AUDIO'|'DOCUMENT'|'FILE'} [params.type] - 종류로 거르기 — 응답 category 와 같은 값
+     *        ({@code FILE} = 기타). 생략하면 전부, 그 밖의 값이면 400. 방·종류를 바꾸면 커서 없이 처음부터 부른다
      * @param {number} [params.size=50] - 페이지 크기 (1-100, 파일 수)
      * @param {string} [params.lastId] - 직전 응답의 lastId 를 그대로 — 불투명 값이라 만들어 쓰지 않는다
      * @param {number} [params.lastSortValue] - 직전 응답의 lastSortValue 를 그대로
      * @returns {Promise<Object>}
      */
     async getFiles(params = {}) {
-        const { roomId, size = 50, lastId, lastSortValue } = params;
-        return this.apiClient.get('/api/v1/files', { roomId, size, lastId, lastSortValue });
+        const { roomId, type, size = 50, lastId, lastSortValue } = params;
+        return this.apiClient.get('/api/v1/files', { roomId, type, size, lastId, lastSortValue });
     }
 
     /**

package/types/__typetests__/files.types.ts

@@ -2,20 +2,20 @@
  * 파일함 타입 — docs/chat.md «파일함» 예제가 <b>실제로 컴파일되는지</b>.
  *
  * <p>jest 는 `.d.ts` 를 보지 않는다. 문서가 약속한 모양(반환은 envelope 째 · 한 줄 = 파일 하나 · 커서 두 칸은 직전 응답
- * 그대로 · 이름·방 이름은 비어 있을 수 있음 · 종류는 다섯 값)이 선언과 맞는지 여기서 tsc 로 고정한다.</p>
+ * 그대로 · 이름·방 이름은 비어 있을 수 있음 · 종류는 다섯 값이고 거를 때도 같은 값)이 선언과 맞는지 여기서 tsc 로 고정한다.</p>
  *
  * <p>실행: {@code npm run typecheck}</p>
  */
 import TalkFlowClient from '../index';
-import type { ChatFile, ChatFileListParams } from '../index';
+import type { ChatFile, ChatFileCategory, ChatFileListParams } from '../index';
 
 declare const talkflow: TalkFlowClient;
 declare const roomId: string;
 
-// 1) 처음부터 끝까지 — 다음 페이지는 응답의 커서 두 칸을 그대로 넘긴다.
-async function loadAll(filterRoomId?: string): Promise<ChatFile[]> {
+// 1) 처음부터 끝까지 — 다음 페이지는 응답의 커서 두 칸을 그대로 넘긴다. 종류 탭이면 type 을 함께 싣는다.
+async function loadAll(filterRoomId?: string, tab?: ChatFileCategory): Promise<ChatFile[]> {
     const rows: ChatFile[] = [];
-    let params: ChatFileListParams = { roomId: filterRoomId, size: 50 };
+    let params: ChatFileListParams = { roomId: filterRoomId, type: tab, size: 50 };
     for (;;) {
         const result = await talkflow.getFiles(params);
         rows.push(...result.data.content);
@@ -43,11 +43,12 @@ function describe(row: ChatFile): string {
     return `${who} · ${room} · ${row.file.fileName ?? link}`;
 }
 
-// 3) 방 목록 필터는 파일함에 없다 — 방 하나는 roomId 로 고른다.
-async function wrongFilter(): Promise<void> {
-    // @ts-expect-error — type 은 방 목록(getRooms) 파라미터다.
+// 3) 종류는 파일 종류 다섯 값뿐 — 방 종류(GROUP 등)는 파일함 type 이 아니다. 응답 category 를 그대로 다시 넣을 수 있다.
+async function wrongFilter(row: ChatFile): Promise<void> {
+    // @ts-expect-error — GROUP 은 방 종류다(방 목록 getRooms 의 type).
     await talkflow.getFiles({ type: 'GROUP' });
-    await talkflow.getFiles({ roomId });
+    await talkflow.getFiles({ roomId, type: 'FILE' });
+    await talkflow.getFiles({ type: row.category });
 }
 
 void [loadAll, describe, wrongFilter];

package/types/index.d.ts

@@ -1290,10 +1290,18 @@ export interface ApiEnvelope<T> {
     message?: string;
 }
 
+/**
+ * 파일 종류 — {@link ChatFile.category} 와 {@link ChatFileListParams.type} 이 같은 값을 쓴다.
+ * {@code FILE} 은 «기타» — 이미지·동영상·음성·문서가 아닌 파일(zip 등).
+ */
+export type ChatFileCategory = 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'FILE';
+
 /** {@link ChatClient.getFiles} 파라미터 — 파일함 한 페이지. */
 export interface ChatFileListParams {
     /** 방 하나로 거르기. 생략하면 내가 지금 참여 중인 방 전부. 참여하지 않은 방이면 403. */
     roomId?: string;
+    /** 종류로 거르기 — 생략하면 전부. 방·종류를 바꾸면 커서({@code lastId}·{@code lastSortValue}) 없이 처음부터 부른다. */
+    type?: ChatFileCategory;
     /** 페이지 크기(파일 수). 기본 50, max 100. */
     size?: number;
     /** 직전 응답의 {@code lastId} 그대로 — 불투명 값이라 만들어 쓰지 않는다. */
@@ -1326,7 +1334,7 @@ export interface ChatFile {
     /** 올린 시각(epoch millis). */
     uploadedAt: number;
     /** 종류 — 파일 MIME 기준, 채팅 첨부 분류와 같다. */
-    category: 'IMAGE' | 'VIDEO' | 'AUDIO' | 'DOCUMENT' | 'FILE';
+    category: ChatFileCategory;
     /** 파일명({@code fileName})·다운로드 링크({@code fileUrl})·MIME({@code fileType})·크기·썸네일 — 채팅 메시지 첨부와 같은 모양. */
     file: FileMetaData;
 }