connectbase-client 0.6.38 → 0.7.0

package/dist/index.mjs

@@ -3923,6 +3923,15 @@ var PaymentAPI = class {
    *     successUrl: prepareResult.success_url,
    *     failUrl: prepareResult.fail_url
    * })
+   *
+   * // Stripe 결제 플로우:
+   * // const result = await client.payment.prepare({ amount: 1000, order_name: 'Product' })
+   * // if (result.payment_provider === 'stripe') {
+   * //   const stripe = await loadStripe(result.stripe_publishable_key)
+   * //   const elements = stripe.elements({ clientSecret: result.stripe_client_secret })
+   * //   // Mount PaymentElement, then:
+   * //   // stripe.confirmPayment({ elements, redirect: 'if_required' })
+   * // }
    * ```
    */
   async prepare(data) {
@@ -6631,6 +6640,162 @@ var NativeAPI = class {
   }
 };
 
+// src/api/knowledge.ts
+var KnowledgeAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  // ========== Document ==========
+  /**
+   * 문서 추가
+   *
+   * 지식 베이스에 새 문서를 추가합니다. 텍스트 소스인 경우 즉시 처리됩니다.
+   *
+   * @param kbID - 지식 베이스 ID
+   * @param data - 문서 생성 요청
+   * @returns 생성된 문서 정보
+   *
+   * @example
+   * ```typescript
+   * // 텍스트 문서
+   * const doc = await cb.knowledge.addDocument('kb-id', {
+   *     name: 'FAQ',
+   *     source_type: 'text',
+   *     content: '자주 묻는 질문들...'
+   * })
+   *
+   * // URL에서 가져오기
+   * const doc2 = await cb.knowledge.addDocument('kb-id', {
+   *     name: '도움말',
+   *     source_type: 'url',
+   *     source_url: 'https://example.com/help.html'
+   * })
+   * ```
+   */
+  async addDocument(kbID, data) {
+    return this.http.post(
+      `/v1/public/knowledge-bases/${kbID}/documents`,
+      data
+    );
+  }
+  /**
+   * 문서 목록 조회
+   *
+   * @param kbID - 지식 베이스 ID
+   * @returns 문서 목록
+   */
+  async listDocuments(kbID) {
+    return this.http.get(
+      `/v1/public/knowledge-bases/${kbID}/documents`
+    );
+  }
+  /**
+   * 문서 삭제
+   *
+   * 문서와 관련된 모든 청크도 함께 삭제됩니다.
+   *
+   * @param kbID - 지식 베이스 ID
+   * @param docID - 문서 ID
+   */
+  async deleteDocument(kbID, docID) {
+    await this.http.delete(`/v1/public/knowledge-bases/${kbID}/documents/${docID}`);
+  }
+  // ========== Search ==========
+  /**
+   * 문서 검색
+   *
+   * 키워드 기반으로 관련 문서 청크를 검색합니다.
+   * 제목, 내용, 키워드 필드에서 매칭되며 점수 기반으로 정렬됩니다.
+   *
+   * @param kbID - 지식 베이스 ID
+   * @param request - 검색 요청
+   * @returns 검색 결과
+   *
+   * @example
+   * ```typescript
+   * const results = await cb.knowledge.search('kb-id', {
+   *     query: '환불 신청 방법',
+   *     top_k: 5  // 상위 5개 결과
+   * })
+   *
+   * for (const result of results.results) {
+   *     console.log(`[${result.score}] ${result.title}`)
+   *     console.log(result.content)
+   * }
+   * ```
+   */
+  async search(kbID, request) {
+    return this.http.post(
+      `/v1/public/knowledge-bases/${kbID}/search`,
+      request
+    );
+  }
+  /**
+   * 문서 검색 (GET 방식)
+   *
+   * 쿼리 파라미터로 검색합니다.
+   *
+   * @param kbID - 지식 베이스 ID
+   * @param query - 검색 쿼리
+   * @param topK - 반환할 결과 수 (기본값: 지식 베이스 설정)
+   */
+  async searchGet(kbID, query, topK) {
+    const params = new URLSearchParams({ query });
+    if (topK) params.append("top_k", String(topK));
+    return this.http.get(
+      `/v1/public/knowledge-bases/${kbID}/search?${params.toString()}`
+    );
+  }
+};
+
+// src/api/queue.ts
+var QueueAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * 메시지 발행
+   */
+  async publish(queueID, data) {
+    return this.http.post(`/v1/public/queues/${queueID}/messages`, data);
+  }
+  /**
+   * 배치 메시지 발행 (최대 100개)
+   */
+  async publishBatch(queueID, data) {
+    return this.http.post(`/v1/public/queues/${queueID}/messages/batch`, data);
+  }
+  /**
+   * 메시지 소비 (Pull 방식)
+   */
+  async consume(queueID, options) {
+    const params = new URLSearchParams();
+    if (options?.max_messages) params.set("max_messages", String(options.max_messages));
+    if (options?.visibility_timeout) params.set("visibility_timeout", String(options.visibility_timeout));
+    const query = params.toString();
+    return this.http.get(`/v1/public/queues/${queueID}/messages${query ? `?${query}` : ""}`);
+  }
+  /**
+   * 메시지 처리 완료 확인 (Ack)
+   */
+  async ack(queueID, messageIds) {
+    const data = { message_ids: messageIds };
+    return this.http.post(`/v1/public/queues/${queueID}/messages/ack`, data);
+  }
+  /**
+   * 메시지 재시도 요청 (Nack)
+   */
+  async nack(queueID, messageId, options) {
+    return this.http.post(`/v1/public/queues/${queueID}/messages/${messageId}/nack`, options || {});
+  }
+  /**
+   * 큐 정보 조회
+   */
+  async getInfo(queueID) {
+    return this.http.get(`/v1/public/queues/${queueID}`);
+  }
+};
+
 // src/api/game-transport.ts
 var WebTransportTransport = class {
   constructor(config, onMessage, onClose, onError) {
@@ -7306,6 +7471,8 @@ var ConnectBase = class {
     this.game = new GameAPI(this.http, config.gameUrl || DEFAULT_GAME_URL, config.appId);
     this.ads = new AdsAPI(this.http);
     this.native = new NativeAPI();
+    this.knowledge = new KnowledgeAPI(this.http);
+    this.queue = new QueueAPI(this.http);
   }
   /**
    * 수동으로 토큰 설정 (기존 토큰으로 세션 복원 시)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "connectbase-client",
-  "version": "0.6.38",
+  "version": "0.7.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",
@@ -29,6 +29,12 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "release": "pnpm build && npm publish --access public"
+  },
   "keywords": [
     "connect-base",
     "baas",
@@ -52,11 +58,5 @@
   },
   "engines": {
     "node": ">=16"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "release": "pnpm build && npm publish --access public"
   }
-}
+}