connectbase-client 3.16.3 → 3.17.1

package/dist/index.d.mts

@@ -6938,6 +6938,20 @@ interface CreateDocumentRequest {
     source_type?: 'file' | 'text' | 'url';
     content?: string;
     source_url?: string;
+    /**
+     * source_type='file' 일 때 사용. 바이너리를 base64 로 인코딩해서 보낸다.
+     * 서버가 PDF / DOCX / text 류를 자동으로 텍스트 추출 → 청킹·인덱싱 한다.
+     * 파일 50MB 상한, 이미지 OCR / 스캔 PDF 는 미지원.
+     * 일반적으로는 [`KnowledgeAPI.addDocumentFromFile`](../api/knowledge.ts) 헬퍼를 사용하면
+     * Blob / File 로 직접 넘길 수 있다.
+     */
+    file_content?: string;
+    /**
+     * file_content 의 MIME (예: 'application/pdf',
+     * 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'text/markdown').
+     * 비어있으면 서버가 매직 바이트로 자동 추정 — 정확도를 위해 명시 권장.
+     */
+    mime_type?: string;
     metadata?: Record<string, unknown>;
 }
 interface DocumentResponse {
@@ -7006,6 +7020,18 @@ interface KnowledgeSearchResponse {
     total: number;
 }
 
+/**
+ * `addDocumentFromFile` 입력 형식.
+ *
+ * - `File` (DOM) — 브라우저 `<input type="file">` 결과를 그대로 사용. name / type 이 자동 추출됨.
+ * - `Blob` (DOM) — Blob.type 이 MIME 으로 사용됨 (없으면 서버 자동 추정).
+ * - `{ data, mimeType?, name? }` — Node.js Buffer / Uint8Array. mimeType 명시 권장.
+ */
+type KnowledgeFileInput = File | Blob | {
+    data: Uint8Array | ArrayBuffer;
+    mimeType?: string;
+    name?: string;
+};
 /**
  * Knowledge Base API
  *
@@ -7073,6 +7099,50 @@ declare class KnowledgeAPI {
      * ```
      */
     addDocument(kbID: string, data: CreateDocumentRequest): Promise<DocumentResponse>;
+    /**
+     * 파일을 KB 에 추가 (PDF / DOCX / text 파일).
+     *
+     * 브라우저에서 `<input type="file">` 로 받은 `File` 또는 `Blob` 을 그대로 넘기면 SDK 가
+     * base64 로 인코딩 + MIME 추정 후 서버에 보낸다. 서버는 PDF / DOCX / text 류를 자동
+     * 텍스트 추출하여 기존 청킹·인덱싱 파이프라인을 태운다.
+     *
+     * 지원 MIME (2026-05 기준):
+     *   - `application/pdf` (텍스트 PDF — 스캔 이미지 PDF 는 미지원)
+     *   - `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX)
+     *   - `text/*` (plain / markdown / csv / html)
+     *   - `application/json`
+     *
+     * 비지원 MIME (이미지 OCR / 한글 HWP / XLSX 등) 은 향후 추가될 예정 — 현재는 명시적 에러.
+     *
+     * 파일 크기 상한: 50MB (원본 바이너리 기준).
+     *
+     * @param kbID - Knowledge Base ID
+     * @param file - 업로드할 파일. `File` (DOM) / `Blob` / `{ data, mimeType, name }` (Node) 모두 가능
+     * @param options - name 오버라이드 + metadata
+     * @returns 생성된 문서 정보 (서버에서 status='processing' → 청킹 완료 후 'ready')
+     *
+     * @example
+     * ```typescript
+     * // 브라우저: <input type="file"> 로 받은 File
+     * const file = event.target.files[0]
+     * const doc = await cb.knowledge.addDocumentFromFile('kb-id', file, {
+     *     metadata: { tag: 'manual' }
+     * })
+     *
+     * // Node.js: fs.readFileSync 로 읽은 Buffer
+     * import { readFileSync } from 'node:fs'
+     * const data = readFileSync('./report.pdf')
+     * const doc = await cb.knowledge.addDocumentFromFile('kb-id', {
+     *     data,
+     *     mimeType: 'application/pdf',
+     *     name: 'report.pdf',
+     * })
+     * ```
+     */
+    addDocumentFromFile(kbID: string, file: KnowledgeFileInput, options?: {
+        name?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<DocumentResponse>;
     /**
      * 문서 목록 조회
      *

package/dist/index.d.ts

@@ -6938,6 +6938,20 @@ interface CreateDocumentRequest {
     source_type?: 'file' | 'text' | 'url';
     content?: string;
     source_url?: string;
+    /**
+     * source_type='file' 일 때 사용. 바이너리를 base64 로 인코딩해서 보낸다.
+     * 서버가 PDF / DOCX / text 류를 자동으로 텍스트 추출 → 청킹·인덱싱 한다.
+     * 파일 50MB 상한, 이미지 OCR / 스캔 PDF 는 미지원.
+     * 일반적으로는 [`KnowledgeAPI.addDocumentFromFile`](../api/knowledge.ts) 헬퍼를 사용하면
+     * Blob / File 로 직접 넘길 수 있다.
+     */
+    file_content?: string;
+    /**
+     * file_content 의 MIME (예: 'application/pdf',
+     * 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'text/markdown').
+     * 비어있으면 서버가 매직 바이트로 자동 추정 — 정확도를 위해 명시 권장.
+     */
+    mime_type?: string;
     metadata?: Record<string, unknown>;
 }
 interface DocumentResponse {
@@ -7006,6 +7020,18 @@ interface KnowledgeSearchResponse {
     total: number;
 }
 
+/**
+ * `addDocumentFromFile` 입력 형식.
+ *
+ * - `File` (DOM) — 브라우저 `<input type="file">` 결과를 그대로 사용. name / type 이 자동 추출됨.
+ * - `Blob` (DOM) — Blob.type 이 MIME 으로 사용됨 (없으면 서버 자동 추정).
+ * - `{ data, mimeType?, name? }` — Node.js Buffer / Uint8Array. mimeType 명시 권장.
+ */
+type KnowledgeFileInput = File | Blob | {
+    data: Uint8Array | ArrayBuffer;
+    mimeType?: string;
+    name?: string;
+};
 /**
  * Knowledge Base API
  *
@@ -7073,6 +7099,50 @@ declare class KnowledgeAPI {
      * ```
      */
     addDocument(kbID: string, data: CreateDocumentRequest): Promise<DocumentResponse>;
+    /**
+     * 파일을 KB 에 추가 (PDF / DOCX / text 파일).
+     *
+     * 브라우저에서 `<input type="file">` 로 받은 `File` 또는 `Blob` 을 그대로 넘기면 SDK 가
+     * base64 로 인코딩 + MIME 추정 후 서버에 보낸다. 서버는 PDF / DOCX / text 류를 자동
+     * 텍스트 추출하여 기존 청킹·인덱싱 파이프라인을 태운다.
+     *
+     * 지원 MIME (2026-05 기준):
+     *   - `application/pdf` (텍스트 PDF — 스캔 이미지 PDF 는 미지원)
+     *   - `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX)
+     *   - `text/*` (plain / markdown / csv / html)
+     *   - `application/json`
+     *
+     * 비지원 MIME (이미지 OCR / 한글 HWP / XLSX 등) 은 향후 추가될 예정 — 현재는 명시적 에러.
+     *
+     * 파일 크기 상한: 50MB (원본 바이너리 기준).
+     *
+     * @param kbID - Knowledge Base ID
+     * @param file - 업로드할 파일. `File` (DOM) / `Blob` / `{ data, mimeType, name }` (Node) 모두 가능
+     * @param options - name 오버라이드 + metadata
+     * @returns 생성된 문서 정보 (서버에서 status='processing' → 청킹 완료 후 'ready')
+     *
+     * @example
+     * ```typescript
+     * // 브라우저: <input type="file"> 로 받은 File
+     * const file = event.target.files[0]
+     * const doc = await cb.knowledge.addDocumentFromFile('kb-id', file, {
+     *     metadata: { tag: 'manual' }
+     * })
+     *
+     * // Node.js: fs.readFileSync 로 읽은 Buffer
+     * import { readFileSync } from 'node:fs'
+     * const data = readFileSync('./report.pdf')
+     * const doc = await cb.knowledge.addDocumentFromFile('kb-id', {
+     *     data,
+     *     mimeType: 'application/pdf',
+     *     name: 'report.pdf',
+     * })
+     * ```
+     */
+    addDocumentFromFile(kbID: string, file: KnowledgeFileInput, options?: {
+        name?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<DocumentResponse>;
     /**
      * 문서 목록 조회
      *

package/dist/index.js

@@ -7967,6 +7967,40 @@ var NativeAPI = class {
 };
 
 // src/api/knowledge.ts
+async function readFileInput(file) {
+  if (typeof Blob !== "undefined" && file instanceof Blob) {
+    const buffer = await file.arrayBuffer();
+    const name = "name" in file ? file.name : void 0;
+    return {
+      data: bytesToBase64(new Uint8Array(buffer)),
+      mimeType: file.type || "",
+      defaultName: name
+    };
+  }
+  const obj = file;
+  if (!obj || obj.data === void 0) {
+    throw new Error("addDocumentFromFile: file must be a Blob/File or { data, mimeType?, name? }");
+  }
+  const bytes = obj.data instanceof Uint8Array ? obj.data : new Uint8Array(obj.data);
+  return {
+    data: bytesToBase64(bytes),
+    mimeType: obj.mimeType ?? "",
+    defaultName: obj.name
+  };
+}
+function bytesToBase64(bytes) {
+  const g = globalThis;
+  if (g.Buffer) {
+    return g.Buffer.from(bytes).toString("base64");
+  }
+  const chunkSize = 8192;
+  let binary = "";
+  for (let i = 0; i < bytes.length; i += chunkSize) {
+    const chunk = bytes.subarray(i, Math.min(i + chunkSize, bytes.length));
+    binary += String.fromCharCode.apply(null, Array.from(chunk));
+  }
+  return btoa(binary);
+}
 var KnowledgeAPI = class {
   constructor(http) {
     this.http = http;
@@ -8004,6 +8038,57 @@ var KnowledgeAPI = class {
       data
     );
   }
+  /**
+   * 파일을 KB 에 추가 (PDF / DOCX / text 파일).
+   *
+   * 브라우저에서 `<input type="file">` 로 받은 `File` 또는 `Blob` 을 그대로 넘기면 SDK 가
+   * base64 로 인코딩 + MIME 추정 후 서버에 보낸다. 서버는 PDF / DOCX / text 류를 자동
+   * 텍스트 추출하여 기존 청킹·인덱싱 파이프라인을 태운다.
+   *
+   * 지원 MIME (2026-05 기준):
+   *   - `application/pdf` (텍스트 PDF — 스캔 이미지 PDF 는 미지원)
+   *   - `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX)
+   *   - `text/*` (plain / markdown / csv / html)
+   *   - `application/json`
+   *
+   * 비지원 MIME (이미지 OCR / 한글 HWP / XLSX 등) 은 향후 추가될 예정 — 현재는 명시적 에러.
+   *
+   * 파일 크기 상한: 50MB (원본 바이너리 기준).
+   *
+   * @param kbID - Knowledge Base ID
+   * @param file - 업로드할 파일. `File` (DOM) / `Blob` / `{ data, mimeType, name }` (Node) 모두 가능
+   * @param options - name 오버라이드 + metadata
+   * @returns 생성된 문서 정보 (서버에서 status='processing' → 청킹 완료 후 'ready')
+   *
+   * @example
+   * ```typescript
+   * // 브라우저: <input type="file"> 로 받은 File
+   * const file = event.target.files[0]
+   * const doc = await cb.knowledge.addDocumentFromFile('kb-id', file, {
+   *     metadata: { tag: 'manual' }
+   * })
+   *
+   * // Node.js: fs.readFileSync 로 읽은 Buffer
+   * import { readFileSync } from 'node:fs'
+   * const data = readFileSync('./report.pdf')
+   * const doc = await cb.knowledge.addDocumentFromFile('kb-id', {
+   *     data,
+   *     mimeType: 'application/pdf',
+   *     name: 'report.pdf',
+   * })
+   * ```
+   */
+  async addDocumentFromFile(kbID, file, options) {
+    const { data, mimeType, defaultName } = await readFileInput(file);
+    const name = options?.name ?? defaultName ?? "document";
+    return this.addDocument(kbID, {
+      name,
+      source_type: "file",
+      file_content: data,
+      mime_type: mimeType,
+      metadata: options?.metadata
+    });
+  }
   /**
    * 문서 목록 조회
    *

package/dist/index.mjs

@@ -7924,6 +7924,40 @@ var NativeAPI = class {
 };
 
 // src/api/knowledge.ts
+async function readFileInput(file) {
+  if (typeof Blob !== "undefined" && file instanceof Blob) {
+    const buffer = await file.arrayBuffer();
+    const name = "name" in file ? file.name : void 0;
+    return {
+      data: bytesToBase64(new Uint8Array(buffer)),
+      mimeType: file.type || "",
+      defaultName: name
+    };
+  }
+  const obj = file;
+  if (!obj || obj.data === void 0) {
+    throw new Error("addDocumentFromFile: file must be a Blob/File or { data, mimeType?, name? }");
+  }
+  const bytes = obj.data instanceof Uint8Array ? obj.data : new Uint8Array(obj.data);
+  return {
+    data: bytesToBase64(bytes),
+    mimeType: obj.mimeType ?? "",
+    defaultName: obj.name
+  };
+}
+function bytesToBase64(bytes) {
+  const g = globalThis;
+  if (g.Buffer) {
+    return g.Buffer.from(bytes).toString("base64");
+  }
+  const chunkSize = 8192;
+  let binary = "";
+  for (let i = 0; i < bytes.length; i += chunkSize) {
+    const chunk = bytes.subarray(i, Math.min(i + chunkSize, bytes.length));
+    binary += String.fromCharCode.apply(null, Array.from(chunk));
+  }
+  return btoa(binary);
+}
 var KnowledgeAPI = class {
   constructor(http) {
     this.http = http;
@@ -7961,6 +7995,57 @@ var KnowledgeAPI = class {
       data
     );
   }
+  /**
+   * 파일을 KB 에 추가 (PDF / DOCX / text 파일).
+   *
+   * 브라우저에서 `<input type="file">` 로 받은 `File` 또는 `Blob` 을 그대로 넘기면 SDK 가
+   * base64 로 인코딩 + MIME 추정 후 서버에 보낸다. 서버는 PDF / DOCX / text 류를 자동
+   * 텍스트 추출하여 기존 청킹·인덱싱 파이프라인을 태운다.
+   *
+   * 지원 MIME (2026-05 기준):
+   *   - `application/pdf` (텍스트 PDF — 스캔 이미지 PDF 는 미지원)
+   *   - `application/vnd.openxmlformats-officedocument.wordprocessingml.document` (DOCX)
+   *   - `text/*` (plain / markdown / csv / html)
+   *   - `application/json`
+   *
+   * 비지원 MIME (이미지 OCR / 한글 HWP / XLSX 등) 은 향후 추가될 예정 — 현재는 명시적 에러.
+   *
+   * 파일 크기 상한: 50MB (원본 바이너리 기준).
+   *
+   * @param kbID - Knowledge Base ID
+   * @param file - 업로드할 파일. `File` (DOM) / `Blob` / `{ data, mimeType, name }` (Node) 모두 가능
+   * @param options - name 오버라이드 + metadata
+   * @returns 생성된 문서 정보 (서버에서 status='processing' → 청킹 완료 후 'ready')
+   *
+   * @example
+   * ```typescript
+   * // 브라우저: <input type="file"> 로 받은 File
+   * const file = event.target.files[0]
+   * const doc = await cb.knowledge.addDocumentFromFile('kb-id', file, {
+   *     metadata: { tag: 'manual' }
+   * })
+   *
+   * // Node.js: fs.readFileSync 로 읽은 Buffer
+   * import { readFileSync } from 'node:fs'
+   * const data = readFileSync('./report.pdf')
+   * const doc = await cb.knowledge.addDocumentFromFile('kb-id', {
+   *     data,
+   *     mimeType: 'application/pdf',
+   *     name: 'report.pdf',
+   * })
+   * ```
+   */
+  async addDocumentFromFile(kbID, file, options) {
+    const { data, mimeType, defaultName } = await readFileInput(file);
+    const name = options?.name ?? defaultName ?? "document";
+    return this.addDocument(kbID, {
+      name,
+      source_type: "file",
+      file_content: data,
+      mime_type: mimeType,
+      metadata: options?.metadata
+    });
+  }
   /**
    * 문서 목록 조회
    *

package/package.json

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