connectbase-client 3.18.0 → 3.20.0

package/dist/index.mjs

@@ -8007,6 +8007,15 @@ var KnowledgeAPI = class {
    *     source_type: 'url',
    *     source_url: 'https://example.com/help.html'
    * })
+   *
+   * // external_id 로 idempotent 동기화 (빌드 스크립트 등)
+   * // 같은 external_id 로 다시 호출하면 기존 문서를 교체한다 (문서 id 유지).
+   * await cb.knowledge.addDocument('kb-id', {
+   *     name: '블로그: 제목',
+   *     source_type: 'text',
+   *     content: '...',
+   *     external_id: 'blog/my-post-slug',
+   * })
    * ```
    */
   async addDocument(kbID, data) {
@@ -8015,6 +8024,58 @@ var KnowledgeAPI = class {
       data
     );
   }
+  /**
+   * 문서 수정 (update/upsert)
+   *
+   * 기존 문서의 내용·이름·메타데이터를 교체합니다. **문서 id 는 그대로 유지**되므로
+   * 검색 결과의 `document_id` 를 외부에서 참조(인용·캐시)해도 편집 후 깨지지 않습니다.
+   * 보낸 필드만 교체되며, 내용/이름/메타데이터가 실제로 바뀌면 자동으로 재청킹·재색인됩니다.
+   *
+   * @param kbID - 지식 베이스 ID
+   * @param docID - 문서 ID
+   * @param data - 변경할 필드 (생략한 필드는 변경 없음)
+   * @returns 수정된 문서 정보
+   *
+   * @example
+   * ```typescript
+   * // 내용만 교체 — document_id 는 그대로
+   * const doc = await cb.knowledge.updateDocument('kb-id', 'doc-id', {
+   *     content: '갱신된 환불 정책...',
+   * })
+   *
+   * // 이름 + 메타데이터 교체
+   * await cb.knowledge.updateDocument('kb-id', 'doc-id', {
+   *     name: 'FAQ (2026)',
+   *     metadata: { tag: 'faq', updated: '2026-05' },
+   * })
+   * ```
+   */
+  async updateDocument(kbID, docID, data) {
+    return this.http.put(
+      `/v1/public/knowledge-bases/${kbID}/documents/${docID}`,
+      data
+    );
+  }
+  /**
+   * 파일로 문서 수정 (PDF / DOCX / text 파일 재업로드).
+   *
+   * [`addDocumentFromFile`](#addDocumentFromFile) 의 update 버전. 문서 id 는 유지됩니다.
+   *
+   * @param kbID - Knowledge Base ID
+   * @param docID - 문서 ID
+   * @param file - 새 파일. `File` (DOM) / `Blob` / `{ data, mimeType, name }` (Node) 모두 가능
+   * @param options - name / metadata 오버라이드
+   * @returns 수정된 문서 정보
+   */
+  async updateDocumentFromFile(kbID, docID, file, options) {
+    const { data, mimeType } = await readFileInput(file);
+    return this.updateDocument(kbID, docID, {
+      name: options?.name,
+      file_content: data,
+      mime_type: mimeType,
+      metadata: options?.metadata
+    });
+  }
   /**
    * 파일을 KB 에 추가 (PDF / DOCX / text 파일).
    *
@@ -8066,36 +8127,6 @@ var KnowledgeAPI = class {
       metadata: options?.metadata
     });
   }
-  /**
-   * 문서 수정 (재색인)
-   *
-   * `content` / `file_content` / `metadata` 중 하나라도 포함하면 전체 재색인이 일어나며
-   * 색인 토큰이 다시 과금됩니다. `name` 만 보내면 재색인 없이 라벨만 변경됩니다.
-   * 재색인 시 서버는 status='pending' 으로 즉시 응답하고 색인은 백그라운드로 진행됩니다
-   * (addDocument 와 동일) — get/listDocuments 로 'ready' 전환을 확인하세요.
-   *
-   * @param kbID - 지식 베이스 ID
-   * @param docID - 문서 ID
-   * @param data - 수정 요청 (모든 필드 옵셔널)
-   * @returns 수정된 문서 정보
-   *
-   * @example
-   * ```typescript
-   * // 내용 갱신 (전체 재색인 발생)
-   * await cb.knowledge.updateDocument('kb-id', 'doc-id', {
-   *     content: '환불은 구매 후 14일 이내에 가능합니다...'
-   * })
-   *
-   * // 이름만 변경 (재색인 없음)
-   * await cb.knowledge.updateDocument('kb-id', 'doc-id', { name: '환불 정책 v2' })
-   * ```
-   */
-  async updateDocument(kbID, docID, data) {
-    return this.http.put(
-      `/v1/public/knowledge-bases/${kbID}/documents/${docID}`,
-      data
-    );
-  }
   /**
    * 문서 목록 조회
    *
@@ -8189,6 +8220,7 @@ var AIAPI = class {
    *     knowledgeBaseId: 'kb-id',
    * }, {
    *     onSources: (sources) => console.log('참조:', sources),
+   *     onReasoning: (reasoning) => process.stdout.write(reasoning),
    *     onToken: (content) => process.stdout.write(content),
    *     onDone: () => console.log('\\n완료'),
    *     onError: (error) => console.error('에러:', error)
@@ -8247,9 +8279,14 @@ var AIAPI = class {
             });
             continue;
           }
-          if (event.type === "heartbeat" || event.type === "searching") {
+          if (event.type === "searching") {
+            if (event.searching) callbacks.onSearching?.(event.searching);
+            continue;
+          }
+          if (event.type === "heartbeat") {
             continue;
           }
+          if (event.reasoning) callbacks.onReasoning?.(event.reasoning);
           if (event.content) callbacks.onToken?.(event.content);
           if (event.done) {
             callbacks.onDone?.();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "3.18.0",
+  "version": "3.20.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",