@taco_tsinghua/graphnode-sdk 0.1.17 → 0.1.21

package/dist/endpoints/ai.d.ts

@@ -39,38 +39,33 @@ export declare class AiApi {
     constructor(rb: RequestBuilder);
     /**
      * 대화 내에서 AI와 채팅을 진행합니다.
+     * - 파일 첨부 가능 (files 인자)
+     * - 스트리밍 기본 지원 (Server-Sent Events)
+     * - onStream 콜백을 통해 청크 수신 가능
+     * - Promise는 최종 완료된 응답(AIChatResponseDto)으로 resolve됨 (기존 호환성 유지)
+     *
      * @param conversationId - 대화 ID
      * @param dto - 채팅 요청 데이터
-     *    - `model` ('openai' | 'deepseek'): 사용할 AI 모델
-     *    - `chatContent` (string): 사용자 입력 메시지 내용
-     * @returns 업데이트된 메시지 목록
-     *    - `messages` (MessageDto[]): 생성된 메시지 목록 (사용자 메시지 + AI 응답 메시지)
-     * @example
-     * const response = await client.ai.chat('c_123', {
-     *   model: 'openai',
-     *   chatContent: 'Hello, how are you?'
-     * });
-     * console.log(response.data);
-     * // Output:
-     * {
-     *   messages: [
-     *     {
-     *       id: 'm_user_1',
-     *       role: 'user',
-     *       content: 'Hello, how are you?',
-     *       createdAt: '2024-02-20T10:00:00Z',
-     *       ...
-     *     },
-     *     {
-     *       id: 'm_ai_1',
-     *       role: 'assistant',
-     *       content: 'I am doing well, thank you!',
-     *       createdAt: '2024-02-20T10:00:01Z',
-     *       ...
-     *     }
-     *   ]
-     * }
+     * @param files - (선택) 업로드할 파일 리스트
+     * @param onStream - (선택) 스트림 청크 수신 콜백
      */
-    chat(conversationId: string, dto: AIChatRequestDto): Promise<HttpResponse<AIChatResponseDto>>;
+    chat(conversationId: string, dto: AIChatRequestDto, files?: File[], onStream?: (chunk: string) => void): Promise<HttpResponse<AIChatResponseDto>>;
+    /**
+     * AI 채팅 스트림을 엽니다.
+     * @param conversationId
+     * @param dto
+     * @param onEvent
+     * @param options
+     */
+    chatStream(conversationId: string, dto: AIChatRequestDto, files: File[] | undefined, onEvent: (event: any) => void, options?: {
+        signal?: AbortSignal;
+        fetchImpl?: any;
+    }): Promise<() => void>;
+    /**
+     * AI 관련 파일을 다운로드합니다.
+     * @param fileKey 파일 키 (S3 Key)
+     * @returns Blob 객체
+     */
+    downloadFile(fileKey: string): Promise<Blob>;
 }
 //# sourceMappingURL=ai.d.ts.map

package/dist/endpoints/ai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/endpoints/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAEtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,IAAI,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;CAG9F"}
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/endpoints/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,KAAK;IACJ,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAGtC;;;;;;;;;;;OAWG;IACG,IAAI,CACR,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,gBAAgB,EACrB,KAAK,CAAC,EAAE,IAAI,EAAE,EACd,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC;IA6H3C;;;;;;OAMG;IACG,UAAU,CACd,cAAc,EAAE,MAAM,EACtB,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,IAAI,EAAE,YAAK,EAClB,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,EAC7B,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAC;QAAC,SAAS,CAAC,EAAE,GAAG,CAAA;KAAO,GACtD,OAAO,CAAC,MAAM,IAAI,CAAC;IAkFtB;;;;OAIG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUnD"}

package/dist/endpoints/ai.js

@@ -16,40 +16,229 @@ export class AiApi {
     }
     /**
      * 대화 내에서 AI와 채팅을 진행합니다.
+     * - 파일 첨부 가능 (files 인자)
+     * - 스트리밍 기본 지원 (Server-Sent Events)
+     * - onStream 콜백을 통해 청크 수신 가능
+     * - Promise는 최종 완료된 응답(AIChatResponseDto)으로 resolve됨 (기존 호환성 유지)
+     *
      * @param conversationId - 대화 ID
      * @param dto - 채팅 요청 데이터
-     *    - `model` ('openai' | 'deepseek'): 사용할 AI 모델
-     *    - `chatContent` (string): 사용자 입력 메시지 내용
-     * @returns 업데이트된 메시지 목록
-     *    - `messages` (MessageDto[]): 생성된 메시지 목록 (사용자 메시지 + AI 응답 메시지)
-     * @example
-     * const response = await client.ai.chat('c_123', {
-     *   model: 'openai',
-     *   chatContent: 'Hello, how are you?'
-     * });
-     * console.log(response.data);
-     * // Output:
-     * {
-     *   messages: [
-     *     {
-     *       id: 'm_user_1',
-     *       role: 'user',
-     *       content: 'Hello, how are you?',
-     *       createdAt: '2024-02-20T10:00:00Z',
-     *       ...
-     *     },
-     *     {
-     *       id: 'm_ai_1',
-     *       role: 'assistant',
-     *       content: 'I am doing well, thank you!',
-     *       createdAt: '2024-02-20T10:00:01Z',
-     *       ...
-     *     }
-     *   ]
-     * }
+     * @param files - (선택) 업로드할 파일 리스트
+     * @param onStream - (선택) 스트림 청크 수신 콜백
      */
-    chat(conversationId, dto) {
-        return this.rb.path(`/v1/ai/conversations/${conversationId}/chat`).post(dto);
+    async chat(conversationId, dto, files, onStream) {
+        const rb = this.rb.path(`/v1/ai/conversations/${conversationId}/chat`);
+        // 1. Body 준비 (JSON or FormData)
+        let body;
+        if (files && files.length > 0) {
+            const formData = new FormData();
+            formData.append('id', dto.id);
+            formData.append('model', dto.model);
+            formData.append('chatContent', dto.chatContent);
+            files.forEach((file) => formData.append('files', file));
+            body = formData;
+        }
+        else {
+            body = dto;
+        }
+        try {
+            // 2. 요청 전송 (Accept: text/event-stream 강제)
+            // sendRaw에 extraHeaders를 전달하여 요청
+            const res = await rb.sendRaw('POST', body, { Accept: 'text/event-stream' });
+            if (!res.ok) {
+                let errBody;
+                try {
+                    errBody = await res.json();
+                }
+                catch {
+                    errBody = await res.text();
+                }
+                return {
+                    isSuccess: false,
+                    error: { statusCode: res.status, message: res.statusText, body: errBody },
+                };
+            }
+            // 3. 응답 처리 (SSE vs JSON)
+            const contentType = res.headers.get('content-type') || '';
+            if (!contentType.includes('text/event-stream')) {
+                // SSE가 아니면 일반 JSON으로 처리 (Fallback)
+                const json = await res.json();
+                return { isSuccess: true, statusCode: res.status, data: json };
+            }
+            // 4. SSE 스트림 파싱
+            if (!res.body) {
+                throw new Error('Response body is empty');
+            }
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            let finalResult = null;
+            let finalError = null;
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                buffer += decoder.decode(value, { stream: true });
+                // SSE 이벤트 파싱 로직
+                // 예: "event: chunk\ndata: {...}\n\n"
+                const parts = buffer.split('\n\n');
+                buffer = parts.pop() || ''; // 마지막 불완전한 부분은 버퍼에 남김
+                for (const part of parts) {
+                    const lines = part.split('\n');
+                    let eventName = 'message';
+                    let dataStr = '';
+                    for (const line of lines) {
+                        const trimmed = line.trim();
+                        if (trimmed.startsWith('event:'))
+                            eventName = trimmed.slice(6).trim();
+                        else if (trimmed.startsWith('data:'))
+                            dataStr = trimmed.slice(5).trim();
+                    }
+                    if (dataStr) {
+                        try {
+                            const parsed = JSON.parse(dataStr);
+                            if (eventName === 'chunk') {
+                                if (onStream)
+                                    onStream(parsed.text);
+                            }
+                            else if (eventName === 'result') {
+                                finalResult = parsed;
+                            }
+                            else if (eventName === 'error') {
+                                finalError = parsed.message;
+                            }
+                        }
+                        catch {
+                            // JSON 파싱 에러 무시
+                        }
+                    }
+                }
+            }
+            // 스트림 종료 후 처리
+            if (finalError) {
+                return {
+                    isSuccess: false,
+                    error: { statusCode: 500, message: finalError },
+                };
+            }
+            if (!finalResult) {
+                // result 이벤트 없이 끝난 경우 (예: 연결 끊김 등)
+                return {
+                    isSuccess: false,
+                    error: { statusCode: 500, message: 'Stream ended without result' },
+                };
+            }
+            return {
+                isSuccess: true,
+                statusCode: 201, // Created
+                data: finalResult,
+            };
+        }
+        catch (e) {
+            return {
+                isSuccess: false,
+                error: {
+                    statusCode: 0,
+                    message: e instanceof Error ? e.message : String(e),
+                },
+            };
+        }
+    }
+    /**
+     * AI 채팅 스트림을 엽니다.
+     * @param conversationId
+     * @param dto
+     * @param onEvent
+     * @param options
+     */
+    async chatStream(conversationId, dto, files = [], onEvent, options = {}) {
+        const url = this.rb.path(`/v1/ai/conversations/${conversationId}/chat`).url();
+        // Body 준비
+        let body;
+        const headers = {
+            Accept: 'text/event-stream',
+        };
+        if (files.length > 0) {
+            const formData = new FormData();
+            formData.append('id', dto.id);
+            formData.append('model', dto.model);
+            formData.append('chatContent', dto.chatContent);
+            files.forEach((f) => formData.append('files', f));
+            body = formData;
+            // Content-Type for FormData is handled by browser/fetch
+        }
+        else {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(dto);
+        }
+        // Agent.ts의 openAgentChatStream 로직과 유사하게 구현 (여기서는 간소화된 fetch 호출)
+        // 실제로는 http-builder가 스트리밍을 직접 지원하지 않으므로, fetch를 직접 호출해야 함.
+        // this.rb의 credentials, headers 등을 재사용하고 싶지만 private임.
+        // 여기서는 간단히 global fetch 사용 가정.
+        const fetchImpl = options.fetchImpl || globalThis.fetch;
+        const controller = new AbortController();
+        const signal = options.signal || controller.signal;
+        try {
+            const res = await fetchImpl(url, {
+                method: 'POST',
+                headers,
+                body,
+                signal,
+                credentials: 'include', // SDK 기본값 따름
+            });
+            if (!res.body)
+                return () => controller.abort();
+            const reader = res.body.getReader();
+            const decoder = new TextDecoder();
+            let buffer = '';
+            (async () => {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    buffer += decoder.decode(value, { stream: true });
+                    const parts = buffer.split('\n\n');
+                    buffer = parts.pop() || '';
+                    for (const part of parts) {
+                        const lines = part.split('\n');
+                        let eventName = 'message';
+                        let dataStr = '';
+                        for (const line of lines) {
+                            if (line.startsWith('event:'))
+                                eventName = line.slice(6).trim();
+                            else if (line.startsWith('data:'))
+                                dataStr = line.slice(5).trim();
+                        }
+                        if (dataStr) {
+                            try {
+                                const parsed = JSON.parse(dataStr);
+                                onEvent({ event: eventName, data: parsed });
+                            }
+                            catch {
+                                // ignore
+                            }
+                        }
+                    }
+                }
+            })();
+        }
+        catch (e) {
+            onEvent({ event: 'error', data: { message: String(e) } });
+        }
+        return () => controller.abort();
+    }
+    /**
+     * AI 관련 파일을 다운로드합니다.
+     * @param fileKey 파일 키 (S3 Key)
+     * @returns Blob 객체
+     */
+    async downloadFile(fileKey) {
+        const rb = this.rb.path(`/v1/ai/files/${fileKey}`);
+        const res = await rb.sendRaw('GET', undefined, {});
+        if (!res.ok) {
+            throw new Error(`Failed to download file: ${res.statusText}`);
+        }
+        return await res.blob();
     }
 }
 //# sourceMappingURL=ai.js.map

package/dist/endpoints/ai.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/endpoints/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AA4BvE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,KAAK;IAChB,YAAoB,EAAkB;QAAlB,OAAE,GAAF,EAAE,CAAgB;IAAG,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,IAAI,CAAC,cAAsB,EAAE,GAAqB;QAChD,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,wBAAwB,cAAc,OAAO,CAAC,CAAC,IAAI,CAAoB,GAAG,CAAC,CAAC;IAClG,CAAC;CACF"}
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/endpoints/ai.ts"],"names":[],"mappings":"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"}

package/dist/endpoints/graph.d.ts

@@ -1,5 +1,5 @@
 import { RequestBuilder, type HttpResponse } from '../http-builder.js';
-import type { GraphNodeDto, GraphEdgeDto, GraphClusterDto, GraphStatsDto, GraphSnapshotDto, CreateEdgeResponse, UpdateNodePayload } from '../types/graph.js';
+import type { GraphNodeDto, GraphEdgeDto, GraphClusterDto, GraphStatsDto, GraphSnapshotDto, GraphSubclusterDto, CreateEdgeResponse, UpdateNodePayload } from '../types/graph.js';
 /**
  * Graph API
  *
@@ -259,6 +259,9 @@ export declare class GraphApi {
      * // Output: (No content)
      */
     deleteCluster(clusterId: string): Promise<HttpResponse<void>>;
+    listSubclusters(): Promise<HttpResponse<GraphSubclusterDto[]>>;
+    getSubcluster(subclusterId: string): Promise<HttpResponse<GraphSubclusterDto>>;
+    deleteSubcluster(subclusterId: string): Promise<HttpResponse<void>>;
     /**
      * 특정 클러스터와 그 안의 모든 노드 및 엣지를 삭제합니다.
      * @param clusterId - 삭제할 클러스터의 ID

package/dist/endpoints/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;gBAExB,EAAE,EAAE,cAAc;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAInE;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IAIlD;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAI5D;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAInF;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIvD;;;;;;OAMG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAI9D;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,kBAAkB,CAAC,CAAC;IAIzE;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,IAAI,OAAO,CAAC,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;IAIlD;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIvD;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAI/E;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC,eAAe,EAAE,CAAC,CAAC;IAIxD;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;IAIrE;;;;;;OAMG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAI7D;;;;;;OAMG;IACH,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAIpE;;;;;;;;;;;;;;OAcG;IACH,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAIhD;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAItD;;;;;;;;;;OAUG;IACH,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;CAGtE"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"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"}

package/dist/endpoints/graph.js

@@ -285,6 +285,16 @@ export class GraphApi {
     deleteCluster(clusterId) {
         return this.rb.path(`/clusters/${clusterId}`).delete();
     }
+    // --- Subclusters ---
+    async listSubclusters() {
+        return this.rb.path('/subclusters').get();
+    }
+    async getSubcluster(subclusterId) {
+        return this.rb.path(`/subclusters/${subclusterId}`).get();
+    }
+    async deleteSubcluster(subclusterId) {
+        return this.rb.path(`/subclusters/${subclusterId}`).delete();
+    }
     /**
      * 특정 클러스터와 그 안의 모든 노드 및 엣지를 삭제합니다.
      * @param clusterId - 삭제할 클러스터의 ID

package/dist/endpoints/graph.js.map

@@ -1 +1 @@
-{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"graph.js","sourceRoot":"","sources":["../../src/endpoints/graph.ts"],"names":[],"mappings":"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"}

package/dist/endpoints/graphAi.d.ts

@@ -1,5 +1,6 @@
 import { RequestBuilder, type HttpResponse } from '../http-builder.js';
 import type { GraphGenerationResponseDto } from '../types/graphAi.js';
+import type { GraphSummaryDto } from '../types/graph.js';
 import type { AiInputData } from '../types/aiInput.js';
 /**
  * Graph AI API
@@ -71,5 +72,25 @@ export declare class GraphAiApi {
      * ```
      */
     generateGraphTest(data: AiInputData[]): Promise<HttpResponse<GraphGenerationResponseDto>>;
+    /**
+     * Request graph summary generation (Async)
+     *
+     * Starts a background task to generate insights and summaries for the user's graph network.
+     *
+     * **API Endpoint**: `POST /v1/graph-ai/summary`
+     *
+     * @returns Verification of task acceptance
+     */
+    requestSummary(): Promise<HttpResponse<GraphGenerationResponseDto>>;
+    /**
+     * Get generated graph summary
+     *
+     * Retrieves the previously generated summary. Returns 404 if not found or not ready.
+     *
+     * **API Endpoint**: `GET /v1/graph-ai/summary`
+     *
+     * @returns The graph summary DTO
+     */
+    getSummary(): Promise<HttpResponse<GraphSummaryDto>>;
 }
 //# sourceMappingURL=graphAi.d.ts.map

package/dist/endpoints/graphAi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graphAi.d.ts","sourceRoot":"","sources":["../../src/endpoints/graphAi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IAEpC;;;;OAIG;gBACS,EAAE,EAAE,cAAc;IAI9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAIxE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;CAGhG"}
+{"version":3,"file":"graphAi.d.ts","sourceRoot":"","sources":["../../src/endpoints/graphAi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;IAEpC;;;;OAIG;gBACS,EAAE,EAAE,cAAc;IAI9B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAIxE;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACG,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAI/F;;;;;;;;OAQG;IACG,cAAc,IAAI,OAAO,CAAC,YAAY,CAAC,0BAA0B,CAAC,CAAC;IAIzE;;;;;;;;OAQG;IACG,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,eAAe,CAAC,CAAC;CAG3D"}

package/dist/endpoints/graphAi.js

@@ -74,5 +74,29 @@ export class GraphAiApi {
     async generateGraphTest(data) {
         return this.rb.path('/test/generate-json').post(data);
     }
+    /**
+     * Request graph summary generation (Async)
+     *
+     * Starts a background task to generate insights and summaries for the user's graph network.
+     *
+     * **API Endpoint**: `POST /v1/graph-ai/summary`
+     *
+     * @returns Verification of task acceptance
+     */
+    async requestSummary() {
+        return this.rb.path('/summary').post();
+    }
+    /**
+     * Get generated graph summary
+     *
+     * Retrieves the previously generated summary. Returns 404 if not found or not ready.
+     *
+     * **API Endpoint**: `GET /v1/graph-ai/summary`
+     *
+     * @returns The graph summary DTO
+     */
+    async getSummary() {
+        return this.rb.path('/summary').get();
+    }
 }
 //# sourceMappingURL=graphAi.js.map

package/dist/endpoints/graphAi.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphAi.js","sourceRoot":"","sources":["../../src/endpoints/graphAi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AAIvE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,UAAU;IAGrB;;;;OAIG;IACH,YAAY,EAAkB;QAC5B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAmB;QACzC,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;CACF"}
+{"version":3,"file":"graphAi.js","sourceRoot":"","sources":["../../src/endpoints/graphAi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AAKvE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,UAAU;IAGrB;;;;OAIG;IACH,YAAY,EAAkB;QAC5B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,iBAAiB,CAAC,IAAmB;QACzC,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC;IACxC,CAAC;CACF"}

package/dist/endpoints/notification.d.ts

@@ -14,6 +14,7 @@ export declare class NotificationApi {
     private readonly rb;
     constructor(rb: RequestBuilder);
     /**
+     * @deprecated
      * 실시간 알림 수신을 위한 SSE(Server-Sent Events) 스트림 URL을 반환합니다.
      *
      * 이 엔드포인트는 `text/event-stream` 형식으로 데이터를 스트리밍합니다.
@@ -39,5 +40,17 @@ export declare class NotificationApi {
      * };
      */
     getStreamUrl(): string;
+    /**
+     * FCM 디바이스 토큰을 등록합니다.
+     *
+     * @param token - FCM 디바이스 토큰
+     */
+    registerDeviceToken(token: string): Promise<void>;
+    /**
+     * FCM 디바이스 토큰을 삭제(등록 해제)합니다.
+     *
+     * @param token - 삭제할 FCM 디바이스 토큰
+     */
+    removeDeviceToken(token: string): Promise<void>;
 }
 //# sourceMappingURL=notification.d.ts.map

package/dist/endpoints/notification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/endpoints/notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;gBAExB,EAAE,EAAE,cAAc;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY,IAAI,MAAM;CAGvB"}
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../src/endpoints/notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAiB;gBAExB,EAAE,EAAE,cAAc;IAI9B;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,YAAY,IAAI,MAAM;IAItB;;;;OAIG;IACG,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;;OAIG;IACG,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAItD"}

package/dist/endpoints/notification.js

@@ -15,6 +15,7 @@ export class NotificationApi {
         this.rb = rb.path('/v1/notifications');
     }
     /**
+     * @deprecated
      * 실시간 알림 수신을 위한 SSE(Server-Sent Events) 스트림 URL을 반환합니다.
      *
      * 이 엔드포인트는 `text/event-stream` 형식으로 데이터를 스트리밍합니다.
@@ -42,5 +43,21 @@ export class NotificationApi {
     getStreamUrl() {
         return this.rb.path('/stream').url();
     }
+    /**
+     * FCM 디바이스 토큰을 등록합니다.
+     *
+     * @param token - FCM 디바이스 토큰
+     */
+    async registerDeviceToken(token) {
+        await this.rb.path('/device-token').post({ token });
+    }
+    /**
+     * FCM 디바이스 토큰을 삭제(등록 해제)합니다.
+     *
+     * @param token - 삭제할 FCM 디바이스 토큰
+     */
+    async removeDeviceToken(token) {
+        await this.rb.path('/device-token').delete({ token });
+    }
 }
 //# sourceMappingURL=notification.js.map

package/dist/endpoints/notification.js.map

@@ -1 +1 @@
-{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/endpoints/notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAe;IAG1B,YAAY,EAAkB;QAC5B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;IACvC,CAAC;CACF"}
+{"version":3,"file":"notification.js","sourceRoot":"","sources":["../../src/endpoints/notification.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,eAAe;IAG1B,YAAY,EAAkB;QAC5B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,YAAY;QACV,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,CAAC;IACvC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,mBAAmB,CAAC,KAAa;QACrC,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB,CAAC,KAAa;QACnC,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACxD,CAAC;CAEF"}

package/dist/endpoints/sync.d.ts

@@ -60,6 +60,8 @@ export declare class SyncApi {
      * });
      * console.log('Sync push completed');
      */
-    push(data: SyncPushRequest): Promise<HttpResponse<void>>;
+    push(data: SyncPushRequest): Promise<HttpResponse<{
+        success: boolean;
+    }>>;
 }
 //# sourceMappingURL=sync.d.ts.map

package/dist/endpoints/sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/endpoints/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAEtC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAKpE;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;CAGzD"}
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/endpoints/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,qBAAa,OAAO;IACN,OAAO,CAAC,EAAE;gBAAF,EAAE,EAAE,cAAc;IAEtC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAC;IAKpE;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAGzE"}

package/dist/endpoints/sync.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/endpoints/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AAGvE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,OAAO;IAClB,YAAoB,EAAkB;QAAlB,OAAE,GAAF,EAAE,CAAgB;IAAG,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CAAC,KAAqB;QACxB,MAAM,QAAQ,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAoB,CAAC;IAC1F,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,IAAqB;QACxB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAO,IAAI,CAAC,CAAC;IACxD,CAAC;CACF"}
+{"version":3,"file":"sync.js","sourceRoot":"","sources":["../../src/endpoints/sync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAqB,MAAM,oBAAoB,CAAC;AAGvE;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,OAAO;IAClB,YAAoB,EAAkB;QAAlB,OAAE,GAAF,EAAE,CAAgB;IAAG,CAAC;IAE1C;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,IAAI,CAAC,KAAqB;QACxB,MAAM,QAAQ,GAAG,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACrE,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAoB,CAAC;IAC1F,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,CAAC,IAAqB;QACxB,OAAO,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAuB,IAAI,CAAC,CAAC;IACxE,CAAC;CACF"}

package/dist/http-builder.d.ts

@@ -26,13 +26,50 @@ export type HttpResponseError = {
 };
 export type HttpResponse<T> = HttpResponseSuccess<T> | HttpResponseError;
 export declare class RequestBuilder {
+    /**
+     * API 기본 URL (마지막 슬래시 제거됨)
+     * @private
+     */
     private readonly baseUrl;
+    /**
+     * 실제 HTTP 요청을 수행할 fetch 함수 구현체
+     * @private
+     */
     private readonly fetchImpl;
+    /**
+     * 모든 요청에 포함될 기본 HTTP 헤더 (예: Accept: application/json)
+     * @private
+     */
     private readonly headers;
+    /**
+     * 자격 증명(쿠키) 전송 모드 ('include' | 'omit' | 'same-origin')
+     * - 'include'로 설정 시 브라우저가 자동으로 쿠키를 전송합니다.
+     * @private
+     */
     private readonly credentials;
+    /**
+     * Access Token을 동적으로 반환하는 함수 또는 정적 문자열.
+     * - 함수로 설정된 경우 요청 시점의 최신 토큰을 조회하여 Authorization 헤더에 사용합니다.
+     * - 값이 없으면(undefined) Authorization 헤더를 추가하지 않습니다 (쿠키 인증 의존).
+     * @private
+     */
     private readonly accessToken?;
+    /**
+     * 현재 빌더가 가지고 있는 URL 경로 조각들
+     * @private
+     */
     private readonly segments;
+    /**
+     * 현재 빌더가 가지고 있는 쿼리 파라미터들
+     * @private
+     */
     private readonly queryParams;
+    /**
+     * RequestBuilder 생성자
+     * @param opts 빌더 공통 옵션 (baseUrl, fetch, headers 등)
+     * @param segments 초기 URL 경로 조각 리스트
+     * @param query 초기 쿼리 파라미터
+     */
     constructor(opts: BuilderOptions, segments?: string[], query?: URLSearchParams);
     /**
      * 경로 조각을 추가한다. '/v1/me' 같은 절대 경로도 허용한다.
@@ -49,6 +86,7 @@ export declare class RequestBuilder {
     patch<T>(body?: unknown): Promise<HttpResponse<T>>;
     delete<T>(body?: unknown): Promise<HttpResponse<T>>;
     url(): string;
+    sendRaw(method: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<Response>;
     private send;
 }
 /**