connectbase-client 3.16.2 → 3.17.0

package/dist/index.d.mts

@@ -168,6 +168,24 @@ declare class HttpClient {
     updateConfig(config: Partial<HttpClientConfig>): void;
     setTokens(accessToken: string, refreshToken: string): void;
     clearTokens(): void;
+    /**
+     * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
+     *
+     * 배경: 콜백 흐름에서 서버가 redirect 응답에 Set-Cookie 를 함께 발급하지만, 일부 deployment /
+     * 브라우저 정책 / 사용자 설정 (3rd-party cookie 차단 등) 환경에서 이 Set-Cookie 가 브라우저에
+     * 저장되지 않는다. `persistence='none'` 모드에서는 토큰이 메모리에만 있고 cookie 가 없는 상태로
+     * 페이지 새로고침이 발생하면 `/v1/auth/re-issue` 가 401 으로 떨어져 강제 로그아웃되는 회귀가
+     * 있다 (platform-issue 019e3960, 2026-05-18).
+     *
+     * 이 메서드는 메모리의 refresh token 으로 한 번 `/v1/auth/re-issue` 를 호출해 서버가 cookie 를
+     * 명시적으로 발급하도록 유도한다. 백엔드는 Bearer + `X-Public-Key` 조합을 SDK 호출 신호로
+     * 인식해 응답에 `cb_member_refresh_token` cookie 를 함께 내려준다.
+     *
+     * persistence='localStorage' / 'sessionStorage' 모드는 새로고침 후에도 메모리 복구가 가능하므로
+     * 호출하지 않는다 (rotation 만 일어나 비용만 증가). 비-브라우저 환경에서도 cookie 자체가 없으므로
+     * 호출하지 않는다.
+     */
+    bootstrapRefreshCookie(): Promise<void>;
     private get persistence();
     private getStorage;
     /**
@@ -6920,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 {
@@ -6988,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
  *
@@ -7055,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

@@ -168,6 +168,24 @@ declare class HttpClient {
     updateConfig(config: Partial<HttpClientConfig>): void;
     setTokens(accessToken: string, refreshToken: string): void;
     clearTokens(): void;
+    /**
+     * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
+     *
+     * 배경: 콜백 흐름에서 서버가 redirect 응답에 Set-Cookie 를 함께 발급하지만, 일부 deployment /
+     * 브라우저 정책 / 사용자 설정 (3rd-party cookie 차단 등) 환경에서 이 Set-Cookie 가 브라우저에
+     * 저장되지 않는다. `persistence='none'` 모드에서는 토큰이 메모리에만 있고 cookie 가 없는 상태로
+     * 페이지 새로고침이 발생하면 `/v1/auth/re-issue` 가 401 으로 떨어져 강제 로그아웃되는 회귀가
+     * 있다 (platform-issue 019e3960, 2026-05-18).
+     *
+     * 이 메서드는 메모리의 refresh token 으로 한 번 `/v1/auth/re-issue` 를 호출해 서버가 cookie 를
+     * 명시적으로 발급하도록 유도한다. 백엔드는 Bearer + `X-Public-Key` 조합을 SDK 호출 신호로
+     * 인식해 응답에 `cb_member_refresh_token` cookie 를 함께 내려준다.
+     *
+     * persistence='localStorage' / 'sessionStorage' 모드는 새로고침 후에도 메모리 복구가 가능하므로
+     * 호출하지 않는다 (rotation 만 일어나 비용만 증가). 비-브라우저 환경에서도 cookie 자체가 없으므로
+     * 호출하지 않는다.
+     */
+    bootstrapRefreshCookie(): Promise<void>;
     private get persistence();
     private getStorage;
     /**
@@ -6920,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 {
@@ -6988,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
  *
@@ -7055,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

@@ -193,6 +193,32 @@ var HttpClient = class {
     this.config.refreshToken = void 0;
     this.removePersistedTokens();
   }
+  /**
+   * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
+   *
+   * 배경: 콜백 흐름에서 서버가 redirect 응답에 Set-Cookie 를 함께 발급하지만, 일부 deployment /
+   * 브라우저 정책 / 사용자 설정 (3rd-party cookie 차단 등) 환경에서 이 Set-Cookie 가 브라우저에
+   * 저장되지 않는다. `persistence='none'` 모드에서는 토큰이 메모리에만 있고 cookie 가 없는 상태로
+   * 페이지 새로고침이 발생하면 `/v1/auth/re-issue` 가 401 으로 떨어져 강제 로그아웃되는 회귀가
+   * 있다 (platform-issue 019e3960, 2026-05-18).
+   *
+   * 이 메서드는 메모리의 refresh token 으로 한 번 `/v1/auth/re-issue` 를 호출해 서버가 cookie 를
+   * 명시적으로 발급하도록 유도한다. 백엔드는 Bearer + `X-Public-Key` 조합을 SDK 호출 신호로
+   * 인식해 응답에 `cb_member_refresh_token` cookie 를 함께 내려준다.
+   *
+   * persistence='localStorage' / 'sessionStorage' 모드는 새로고침 후에도 메모리 복구가 가능하므로
+   * 호출하지 않는다 (rotation 만 일어나 비용만 증가). 비-브라우저 환경에서도 cookie 자체가 없으므로
+   * 호출하지 않는다.
+   */
+  async bootstrapRefreshCookie() {
+    if (typeof window === "undefined") return;
+    if (this.persistence !== "none") return;
+    if (!this.config.refreshToken) return;
+    try {
+      await this.refreshAccessToken();
+    } catch {
+    }
+  }
   // ===== Token Persistence =====
   get persistence() {
     return this.config.persistence ?? "none";
@@ -4758,6 +4784,7 @@ var OAuthAPI = class {
       return result;
     }
     this.http.setTokens(accessToken, refreshToken);
+    void this.http.bootstrapRefreshCookie();
     return result;
   }
   /**
@@ -4796,6 +4823,7 @@ var OAuthAPI = class {
       return result;
     }
     this.http.setTokens(result.access_token, result.refresh_token);
+    void this.http.bootstrapRefreshCookie();
     return result;
   }
 };
@@ -7939,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;
@@ -7976,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

@@ -150,6 +150,32 @@ var HttpClient = class {
     this.config.refreshToken = void 0;
     this.removePersistedTokens();
   }
+  /**
+   * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
+   *
+   * 배경: 콜백 흐름에서 서버가 redirect 응답에 Set-Cookie 를 함께 발급하지만, 일부 deployment /
+   * 브라우저 정책 / 사용자 설정 (3rd-party cookie 차단 등) 환경에서 이 Set-Cookie 가 브라우저에
+   * 저장되지 않는다. `persistence='none'` 모드에서는 토큰이 메모리에만 있고 cookie 가 없는 상태로
+   * 페이지 새로고침이 발생하면 `/v1/auth/re-issue` 가 401 으로 떨어져 강제 로그아웃되는 회귀가
+   * 있다 (platform-issue 019e3960, 2026-05-18).
+   *
+   * 이 메서드는 메모리의 refresh token 으로 한 번 `/v1/auth/re-issue` 를 호출해 서버가 cookie 를
+   * 명시적으로 발급하도록 유도한다. 백엔드는 Bearer + `X-Public-Key` 조합을 SDK 호출 신호로
+   * 인식해 응답에 `cb_member_refresh_token` cookie 를 함께 내려준다.
+   *
+   * persistence='localStorage' / 'sessionStorage' 모드는 새로고침 후에도 메모리 복구가 가능하므로
+   * 호출하지 않는다 (rotation 만 일어나 비용만 증가). 비-브라우저 환경에서도 cookie 자체가 없으므로
+   * 호출하지 않는다.
+   */
+  async bootstrapRefreshCookie() {
+    if (typeof window === "undefined") return;
+    if (this.persistence !== "none") return;
+    if (!this.config.refreshToken) return;
+    try {
+      await this.refreshAccessToken();
+    } catch {
+    }
+  }
   // ===== Token Persistence =====
   get persistence() {
     return this.config.persistence ?? "none";
@@ -4715,6 +4741,7 @@ var OAuthAPI = class {
       return result;
     }
     this.http.setTokens(accessToken, refreshToken);
+    void this.http.bootstrapRefreshCookie();
     return result;
   }
   /**
@@ -4753,6 +4780,7 @@ var OAuthAPI = class {
       return result;
     }
     this.http.setTokens(result.access_token, result.refresh_token);
+    void this.http.bootstrapRefreshCookie();
     return result;
   }
 };
@@ -7896,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;
@@ -7933,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.2",
+  "version": "3.17.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",