@vibexnpm/talkx 8.10.0 → 8.12.0

package/dist/index.d.ts

@@ -631,6 +631,8 @@ export interface FileMetaData {
      */
     fileId?: string;
     fileUrl: string;
+    /** MIME 타입(예: {@code 'image/png'}) — 서버가 업로드·메시지·파일함 응답에 싣는 값. */
+    fileType?: string;
     fileName?: string;
     fileSize?: number;
     contentType?: string;
@@ -1288,6 +1290,55 @@ 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} 그대로 — 불투명 값이라 만들어 쓰지 않는다. */
+    lastId?: string;
+    /** 직전 응답의 {@code lastSortValue} 그대로(epoch millis) — {@link CursorPageParams} 와 같은 형. */
+    lastSortValue?: number | string;
+}
+
+/**
+ * 파일함 한 줄 — 파일 하나(메시지 하나에 파일이 여러 개면 여러 줄).
+ *
+ * <p>보이는 범위는 채팅 화면과 같다 — 참여 중인 방만, 재입장 이전·보관 기간 밖·삭제된 메시지의 파일은 오지 않는다.</p>
+ */
+export interface ChatFile {
+    /** 이 줄의 id — 목록 key 로 쓴다. 페이지 커서 {@code lastId} 와 같은 모양. */
+    id: string;
+    roomId: string;
+    /** 방 이름 — 1:1 은 상대 이름. 상대를 찾지 못하면 null. */
+    roomName: string | null;
+    roomType: ChatRoomTypeValue | null;
+    /** 이 파일이 실린 메시지 — {@link ChatMessage.messageId} 와 같은 값. */
+    messageId: string;
+    /** 올린 쪽 id — 사람은 사용자 id, PM 이 만든 파일은 페르소나 id. */
+    uploaderId: string;
+    uploaderType: SenderTypeValue;
+    /** 사람은 닉네임, PM 은 페르소나 이름. 찾지 못하면(탈퇴·삭제) null. */
+    uploaderName: string | null;
+    /** 사람만. PM 은 null. */
+    uploaderProfileUrl: string | null;
+    /** 올린 시각(epoch millis). */
+    uploadedAt: number;
+    /** 종류 — 파일 MIME 기준, 채팅 첨부 분류와 같다. */
+    category: ChatFileCategory;
+    /** 파일명({@code fileName})·다운로드 링크({@code fileUrl})·MIME({@code fileType})·크기·썸네일 — 채팅 메시지 첨부와 같은 모양. */
+    file: FileMetaData;
+}
+
 // ============================================================================
 // Event payloads
 // ============================================================================
@@ -2397,6 +2448,13 @@ export class ChatClient implements SdkEventEmitter<ChatClientEvents> {
      * WebSocket 이벤트와 동일 형 (REST 원시 응답은 ISO 문자열).</p>
      */
     getMessages(roomId: string, params?: CursorPageParams): Promise<ApiEnvelope<CursorPageResponse<ChatMessage>>>;
+
+    /**
+     * 파일함 — 내가 지금 참여 중인 방들에 올라온 파일(미디어 포함), 최신순 커서 페이징. 반환은 envelope 째
+     * ({@code result.data.content}). 한 줄이 파일 하나다. {@code roomId} 를 주면 그 방만(참여하지 않은 방이면 403).
+     * 다음 페이지는 응답의 {@code lastId}·{@code lastSortValue} 를 그대로 넘긴다.
+     */
+    getFiles(params?: ChatFileListParams): Promise<ApiEnvelope<CursorPageResponse<ChatFile>>>;
     fetchLinkPreview(url: string): Promise<FetchLinkPreviewResponse | null>;
     sendMessage(roomId: string, data: SendMessageData): Promise<SendMessageResult>;
     /** Optimistic UI 버전 — 응답 전 base/예측 messageIds 동기 반환. */
@@ -2883,6 +2941,13 @@ export default class TalkFlowClient implements SdkEventEmitter<TalkFlowClientEve
      * WebSocket 이벤트와 동일 형 (REST 원시 응답은 ISO 문자열).</p>
      */
     getMessages(roomId: string, params?: CursorPageParams): Promise<ApiEnvelope<CursorPageResponse<ChatMessage>>>;
+
+    /**
+     * 파일함 — 내가 지금 참여 중인 방들에 올라온 파일(미디어 포함), 최신순 커서 페이징. 반환은 envelope 째
+     * ({@code result.data.content}). 한 줄이 파일 하나다. {@code roomId} 를 주면 그 방만(참여하지 않은 방이면 403).
+     * 다음 페이지는 응답의 {@code lastId}·{@code lastSortValue} 를 그대로 넘긴다.
+     */
+    getFiles(params?: ChatFileListParams): Promise<ApiEnvelope<CursorPageResponse<ChatFile>>>;
     fetchLinkPreview(url: string): Promise<FetchLinkPreviewResponse | null>;
     sendMessage(roomId: string, data: SendMessageData): Promise<SendMessageResult>;
     /** Optimistic UI 버전 — 응답 전 base/예측 messageIds 동기 반환. */