connectbase-client 3.45.0 → 3.47.0

package/dist/index.js

@@ -33,6 +33,7 @@ __export(index_exports, {
   GameRoom: () => GameRoom,
   GameRoomTransport: () => GameRoomTransport,
   NativeAPI: () => NativeAPI,
+  RolesAPI: () => RolesAPI,
   SessionManager: () => SessionManager,
   VideoProcessingError: () => VideoProcessingError,
   default: () => index_default,
@@ -5448,6 +5449,38 @@ var PaymentAPI = class {
     const prefix = this.getPublicPrefix();
     return this.http.get(`${prefix}/payments/orders/${orderId}`);
   }
+  /**
+   * 앱의 결제 내역 목록을 조회한다 (필터/페이지네이션 지원).
+   *
+   * 서버사이드 전용 — service_role(ctx.cbAdmin, management_scopes=["payment:read"]) 또는 콘솔 JWT
+   * 인증이 필요하다. 재무 데이터이므로 Public Key(cb_pk_) 단독 브라우저 SDK 인스턴스로는 호출할 수
+   * 없다. (다른 payment 메서드와 달리 /v1/public 이 아니라 앱 스코프 dual-auth 라우트를 쓴다.)
+   *
+   * @example
+   * ```typescript
+   * // 함수(service_role, management_scopes: ["payment:read"]) 안에서
+   * const { payments, total } = await ctx.cbAdmin.payment.list(ctx.appId, { status: 'done', limit: 20 })
+   * ```
+   */
+  async list(appId, options) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        'cb.payment.list() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["payment:read"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694.'
+      );
+    }
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.startDate) params.set("start_date", options.startDate);
+    if (options?.endDate) params.set("end_date", options.endDate);
+    if (options?.limit !== void 0)
+      params.set("limit", String(options.limit));
+    if (options?.offset !== void 0)
+      params.set("offset", String(options.offset));
+    const qs = params.toString();
+    return this.http.get(
+      `/v1/apps/${appId}/payments${qs ? `?${qs}` : ""}`
+    );
+  }
 };
 
 // src/api/subscription.ts
@@ -6049,6 +6082,28 @@ var PushAPI = class {
     };
     return this.http.post(`/v1/apps/${appId}/push/send-to-topic`, body);
   }
+  /**
+   * 앱의 푸시 통계(도달/오픈율/클릭율, 디바이스/메시지/토픽 수)를 조회한다.
+   *
+   * 서버사이드 전용 — service_role(ctx.cbAdmin, management_scopes=["push:read"]) 또는 콘솔 JWT
+   * 인증이 필요하다. sendToMembers/sendToTopic 과 동일한 위임 가드 — cb_pk_ 단독(브라우저) SDK
+   * 인스턴스는 차단하고, 위임 Bearer(ctx.cbAdmin) 인스턴스는 허용한다.
+   *
+   * @example
+   * ```typescript
+   * // 함수(service_role, management_scopes: ["push:read"]) 안에서
+   * const stats = await ctx.cbAdmin.push.getStats(ctx.appId)
+   * console.log(stats.open_rate, stats.click_rate)
+   * ```
+   */
+  async getStats(appId) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        'cb.push.getStats() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["push:read"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694.'
+      );
+    }
+    return this.http.get(`/v1/apps/${appId}/push/stats`);
+  }
   // ============ Helper Methods ============
   /**
    * 브라우저 고유 ID 생성 (localStorage에 저장)
@@ -6109,6 +6164,72 @@ var PushAPI = class {
   }
 };
 
+// src/api/roles.ts
+var RolesAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  ensureServerAuth(method) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        `cb.roles.${method}() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["role:read" | "role:manage"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694.`
+      );
+    }
+  }
+  /** 앱의 역할 목록을 조회한다. (management_scope: `role:read`) */
+  async list(appId) {
+    this.ensureServerAuth("list");
+    return this.http.get(`/v1/apps/${appId}/app-roles`);
+  }
+  /** 역할 상세(권한/할당 사용자 포함)를 조회한다. (management_scope: `role:read`) */
+  async get(appId, roleId) {
+    this.ensureServerAuth("get");
+    return this.http.get(`/v1/apps/${appId}/app-roles/${roleId}`);
+  }
+  /** 역할을 생성한다. (management_scope: `role:manage`) */
+  async create(appId, payload) {
+    this.ensureServerAuth("create");
+    return this.http.post(`/v1/apps/${appId}/app-roles`, {
+      role_title: payload.title,
+      role_description: payload.description,
+      selected_permission_ids: payload.permissionIds ?? []
+    });
+  }
+  /**
+   * 역할을 수정한다 — **전체 동기화(replace)**. permissionIds / userIds 는 전달값으로 대체된다.
+   * (management_scope: `role:manage`)
+   */
+  async update(appId, roleId, payload) {
+    this.ensureServerAuth("update");
+    await this.http.put(`/v1/apps/${appId}/app-roles/${roleId}`, {
+      role_title: payload.title,
+      role_description: payload.description,
+      selected_permission_ids: payload.permissionIds,
+      selected_user_ids: payload.userIds
+    });
+  }
+  /**
+   * 역할에 사용자를 할당한다 (제목/설명/권한 보존). EditRole 이 전체 동기화라, 현재 상세를 읽어
+   * 나머지 필드를 유지한 채 사용자 목록만 교체해 PUT 한다. userIds 는 "이 역할을 가질 사용자
+   * 전체"다 (추가가 아니라 동기화). (management_scope: `role:manage`)
+   */
+  async assign(appId, roleId, userIds) {
+    this.ensureServerAuth("assign");
+    const detail = await this.http.get(`/v1/apps/${appId}/app-roles/${roleId}`);
+    await this.http.put(`/v1/apps/${appId}/app-roles/${roleId}`, {
+      role_title: detail.role_name,
+      role_description: detail.role_description,
+      selected_permission_ids: detail.permission_item.map((p) => p.id),
+      selected_user_ids: userIds
+    });
+  }
+  /** 역할을 삭제한다. (management_scope: `role:manage`) */
+  async delete(appId, roleId) {
+    this.ensureServerAuth("delete");
+    await this.http.delete(`/v1/apps/${appId}/app-roles/${roleId}`);
+  }
+};
+
 // src/api/video.ts
 var DEFAULT_CHUNK_SIZE = 5 * 1024 * 1024;
 var VideoProcessingError = class extends Error {
@@ -8061,6 +8182,8 @@ var AdsAPI = class {
 // src/api/native.ts
 var NativeAPI = class {
   constructor() {
+    /** 웹 Web Speech API 인스턴스 (stop() 용) */
+    this._webSpeechRecognition = null;
     /**
      * 크로스 플랫폼 클립보드 API
      */
@@ -8487,6 +8610,109 @@ var NativeAPI = class {
         return false;
       }
     };
+    /**
+     * 크로스 플랫폼 음성 인식(STT) API
+     *
+     * - 모바일(패키징 앱): 네이티브 STT 브릿지(expo-speech-recognition — iOS SFSpeechRecognizer / Android SpeechRecognizer)
+     * - 웹/데스크톱: Web Speech API(webkitSpeechRecognition)
+     *
+     * iOS WKWebView 는 Web Speech API 를 지원하지 않으므로, 패키징 앱에서는 speech 네이티브 기능을 켜면
+     * 자동으로 네이티브 브릿지 경로를 사용한다.
+     *
+     * @example
+     * ```typescript
+     * if (await cb.native.speech.isAvailable()) {
+     *   const result = await cb.native.speech.recognize({
+     *     lang: 'ko-KR',
+     *     onPartial: (text) => console.log('부분 결과:', text),
+     *   })
+     *   console.log('최종:', result.transcript)
+     * }
+     * ```
+     */
+    this.speech = {
+      /**
+       * 음성 인식 지원 여부
+       */
+      isAvailable: async () => {
+        if (this.getPlatform() === "mobile" && window.NativeBridge?.speech) {
+          const r = await window.NativeBridge.speech.isAvailable();
+          return r.available;
+        }
+        if (typeof window === "undefined") return false;
+        return "SpeechRecognition" in window || "webkitSpeechRecognition" in window;
+      },
+      /**
+       * 음성 인식 시작 → 최종 transcript 반환.
+       * `options.onPartial` 로 중간 결과를 실시간 수신할 수 있다.
+       */
+      recognize: async (options) => {
+        if (this.getPlatform() === "mobile" && window.NativeBridge?.speech) {
+          let partialHandler;
+          if (options?.onPartial) {
+            partialHandler = (e) => {
+              const detail = e.detail;
+              if (detail?.transcript) options.onPartial?.(detail.transcript);
+            };
+            window.addEventListener("nativeSpeechPartial", partialHandler);
+          }
+          try {
+            return await window.NativeBridge.speech.recognize(options);
+          } finally {
+            if (partialHandler) window.removeEventListener("nativeSpeechPartial", partialHandler);
+          }
+        }
+        const SR = window;
+        const Ctor = SR.SpeechRecognition || SR.webkitSpeechRecognition;
+        if (!Ctor) {
+          throw new Error("\uC774 \uD50C\uB7AB\uD3FC\uC5D0\uC11C\uB294 \uC74C\uC131 \uC778\uC2DD\uC744 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uD328\uD0A4\uC9D5 \uC571\uC5D0\uC11C\uB294 speech \uB124\uC774\uD2F0\uBE0C \uAE30\uB2A5\uC744 \uD65C\uC131\uD654\uD558\uC138\uC694.");
+        }
+        return new Promise((resolve, reject) => {
+          const recognition = new Ctor();
+          this._webSpeechRecognition = recognition;
+          recognition.lang = options?.lang ?? "en-US";
+          recognition.interimResults = options?.interim ?? true;
+          recognition.continuous = options?.continuous ?? false;
+          let finalTranscript = "";
+          recognition.onresult = (event) => {
+            let interim = "";
+            for (let i = event.resultIndex; i < event.results.length; i++) {
+              const res = event.results[i];
+              if (res.isFinal) {
+                finalTranscript += res[0].transcript;
+              } else {
+                interim += res[0].transcript;
+              }
+            }
+            if (interim && options?.onPartial) options.onPartial(interim);
+          };
+          recognition.onerror = (event) => {
+            this._webSpeechRecognition = null;
+            reject(new Error(event?.error || "\uC74C\uC131 \uC778\uC2DD \uC624\uB958"));
+          };
+          recognition.onend = () => {
+            this._webSpeechRecognition = null;
+            resolve({ transcript: finalTranscript.trim(), isFinal: true });
+          };
+          recognition.start();
+        });
+      },
+      /**
+       * 진행 중인 음성 인식 중지
+       */
+      stop: async () => {
+        if (this.getPlatform() === "mobile" && window.NativeBridge?.speech) {
+          await window.NativeBridge.speech.stop();
+          return;
+        }
+        if (this._webSpeechRecognition) {
+          try {
+            this._webSpeechRecognition.stop();
+          } catch {
+          }
+        }
+      }
+    };
   }
   /**
    * 현재 플랫폼 감지
@@ -11092,6 +11318,7 @@ var ConnectBase = class {
     this.payment = new PaymentAPI(this.http);
     this.subscription = new SubscriptionAPI(this.http);
     this.push = new PushAPI(this.http);
+    this.roles = new RolesAPI(this.http);
     this.video = new VideoAPI(this.http, config.videoUrl || env("CB_VIDEO_URL") || DEFAULT_VIDEO_URL);
     this.game = new GameAPI(this.http, config.gameUrl || env("CB_GAME_URL") || DEFAULT_GAME_URL, config.appId);
     this.ads = new AdsAPI(this.http);
@@ -11187,6 +11414,7 @@ var index_default = ConnectBase;
   GameRoom,
   GameRoomTransport,
   NativeAPI,
+  RolesAPI,
   SessionManager,
   VideoProcessingError,
   detectInAppBrowser,

package/dist/index.mjs

@@ -5403,6 +5403,38 @@ var PaymentAPI = class {
     const prefix = this.getPublicPrefix();
     return this.http.get(`${prefix}/payments/orders/${orderId}`);
   }
+  /**
+   * 앱의 결제 내역 목록을 조회한다 (필터/페이지네이션 지원).
+   *
+   * 서버사이드 전용 — service_role(ctx.cbAdmin, management_scopes=["payment:read"]) 또는 콘솔 JWT
+   * 인증이 필요하다. 재무 데이터이므로 Public Key(cb_pk_) 단독 브라우저 SDK 인스턴스로는 호출할 수
+   * 없다. (다른 payment 메서드와 달리 /v1/public 이 아니라 앱 스코프 dual-auth 라우트를 쓴다.)
+   *
+   * @example
+   * ```typescript
+   * // 함수(service_role, management_scopes: ["payment:read"]) 안에서
+   * const { payments, total } = await ctx.cbAdmin.payment.list(ctx.appId, { status: 'done', limit: 20 })
+   * ```
+   */
+  async list(appId, options) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        'cb.payment.list() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["payment:read"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694.'
+      );
+    }
+    const params = new URLSearchParams();
+    if (options?.status) params.set("status", options.status);
+    if (options?.startDate) params.set("start_date", options.startDate);
+    if (options?.endDate) params.set("end_date", options.endDate);
+    if (options?.limit !== void 0)
+      params.set("limit", String(options.limit));
+    if (options?.offset !== void 0)
+      params.set("offset", String(options.offset));
+    const qs = params.toString();
+    return this.http.get(
+      `/v1/apps/${appId}/payments${qs ? `?${qs}` : ""}`
+    );
+  }
 };
 
 // src/api/subscription.ts
@@ -6004,6 +6036,28 @@ var PushAPI = class {
     };
     return this.http.post(`/v1/apps/${appId}/push/send-to-topic`, body);
   }
+  /**
+   * 앱의 푸시 통계(도달/오픈율/클릭율, 디바이스/메시지/토픽 수)를 조회한다.
+   *
+   * 서버사이드 전용 — service_role(ctx.cbAdmin, management_scopes=["push:read"]) 또는 콘솔 JWT
+   * 인증이 필요하다. sendToMembers/sendToTopic 과 동일한 위임 가드 — cb_pk_ 단독(브라우저) SDK
+   * 인스턴스는 차단하고, 위임 Bearer(ctx.cbAdmin) 인스턴스는 허용한다.
+   *
+   * @example
+   * ```typescript
+   * // 함수(service_role, management_scopes: ["push:read"]) 안에서
+   * const stats = await ctx.cbAdmin.push.getStats(ctx.appId)
+   * console.log(stats.open_rate, stats.click_rate)
+   * ```
+   */
+  async getStats(appId) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        'cb.push.getStats() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["push:read"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694.'
+      );
+    }
+    return this.http.get(`/v1/apps/${appId}/push/stats`);
+  }
   // ============ Helper Methods ============
   /**
    * 브라우저 고유 ID 생성 (localStorage에 저장)
@@ -6064,6 +6118,72 @@ var PushAPI = class {
   }
 };
 
+// src/api/roles.ts
+var RolesAPI = class {
+  constructor(http) {
+    this.http = http;
+  }
+  ensureServerAuth(method) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        `cb.roles.${method}() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["role:read" | "role:manage"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 Functions \uD658\uACBD\uC5D0\uC11C \uC0AC\uC6A9\uD558\uC138\uC694.`
+      );
+    }
+  }
+  /** 앱의 역할 목록을 조회한다. (management_scope: `role:read`) */
+  async list(appId) {
+    this.ensureServerAuth("list");
+    return this.http.get(`/v1/apps/${appId}/app-roles`);
+  }
+  /** 역할 상세(권한/할당 사용자 포함)를 조회한다. (management_scope: `role:read`) */
+  async get(appId, roleId) {
+    this.ensureServerAuth("get");
+    return this.http.get(`/v1/apps/${appId}/app-roles/${roleId}`);
+  }
+  /** 역할을 생성한다. (management_scope: `role:manage`) */
+  async create(appId, payload) {
+    this.ensureServerAuth("create");
+    return this.http.post(`/v1/apps/${appId}/app-roles`, {
+      role_title: payload.title,
+      role_description: payload.description,
+      selected_permission_ids: payload.permissionIds ?? []
+    });
+  }
+  /**
+   * 역할을 수정한다 — **전체 동기화(replace)**. permissionIds / userIds 는 전달값으로 대체된다.
+   * (management_scope: `role:manage`)
+   */
+  async update(appId, roleId, payload) {
+    this.ensureServerAuth("update");
+    await this.http.put(`/v1/apps/${appId}/app-roles/${roleId}`, {
+      role_title: payload.title,
+      role_description: payload.description,
+      selected_permission_ids: payload.permissionIds,
+      selected_user_ids: payload.userIds
+    });
+  }
+  /**
+   * 역할에 사용자를 할당한다 (제목/설명/권한 보존). EditRole 이 전체 동기화라, 현재 상세를 읽어
+   * 나머지 필드를 유지한 채 사용자 목록만 교체해 PUT 한다. userIds 는 "이 역할을 가질 사용자
+   * 전체"다 (추가가 아니라 동기화). (management_scope: `role:manage`)
+   */
+  async assign(appId, roleId, userIds) {
+    this.ensureServerAuth("assign");
+    const detail = await this.http.get(`/v1/apps/${appId}/app-roles/${roleId}`);
+    await this.http.put(`/v1/apps/${appId}/app-roles/${roleId}`, {
+      role_title: detail.role_name,
+      role_description: detail.role_description,
+      selected_permission_ids: detail.permission_item.map((p) => p.id),
+      selected_user_ids: userIds
+    });
+  }
+  /** 역할을 삭제한다. (management_scope: `role:manage`) */
+  async delete(appId, roleId) {
+    this.ensureServerAuth("delete");
+    await this.http.delete(`/v1/apps/${appId}/app-roles/${roleId}`);
+  }
+};
+
 // src/api/video.ts
 var DEFAULT_CHUNK_SIZE = 5 * 1024 * 1024;
 var VideoProcessingError = class extends Error {
@@ -8016,6 +8136,8 @@ var AdsAPI = class {
 // src/api/native.ts
 var NativeAPI = class {
   constructor() {
+    /** 웹 Web Speech API 인스턴스 (stop() 용) */
+    this._webSpeechRecognition = null;
     /**
      * 크로스 플랫폼 클립보드 API
      */
@@ -8442,6 +8564,109 @@ var NativeAPI = class {
         return false;
       }
     };
+    /**
+     * 크로스 플랫폼 음성 인식(STT) API
+     *
+     * - 모바일(패키징 앱): 네이티브 STT 브릿지(expo-speech-recognition — iOS SFSpeechRecognizer / Android SpeechRecognizer)
+     * - 웹/데스크톱: Web Speech API(webkitSpeechRecognition)
+     *
+     * iOS WKWebView 는 Web Speech API 를 지원하지 않으므로, 패키징 앱에서는 speech 네이티브 기능을 켜면
+     * 자동으로 네이티브 브릿지 경로를 사용한다.
+     *
+     * @example
+     * ```typescript
+     * if (await cb.native.speech.isAvailable()) {
+     *   const result = await cb.native.speech.recognize({
+     *     lang: 'ko-KR',
+     *     onPartial: (text) => console.log('부분 결과:', text),
+     *   })
+     *   console.log('최종:', result.transcript)
+     * }
+     * ```
+     */
+    this.speech = {
+      /**
+       * 음성 인식 지원 여부
+       */
+      isAvailable: async () => {
+        if (this.getPlatform() === "mobile" && window.NativeBridge?.speech) {
+          const r = await window.NativeBridge.speech.isAvailable();
+          return r.available;
+        }
+        if (typeof window === "undefined") return false;
+        return "SpeechRecognition" in window || "webkitSpeechRecognition" in window;
+      },
+      /**
+       * 음성 인식 시작 → 최종 transcript 반환.
+       * `options.onPartial` 로 중간 결과를 실시간 수신할 수 있다.
+       */
+      recognize: async (options) => {
+        if (this.getPlatform() === "mobile" && window.NativeBridge?.speech) {
+          let partialHandler;
+          if (options?.onPartial) {
+            partialHandler = (e) => {
+              const detail = e.detail;
+              if (detail?.transcript) options.onPartial?.(detail.transcript);
+            };
+            window.addEventListener("nativeSpeechPartial", partialHandler);
+          }
+          try {
+            return await window.NativeBridge.speech.recognize(options);
+          } finally {
+            if (partialHandler) window.removeEventListener("nativeSpeechPartial", partialHandler);
+          }
+        }
+        const SR = window;
+        const Ctor = SR.SpeechRecognition || SR.webkitSpeechRecognition;
+        if (!Ctor) {
+          throw new Error("\uC774 \uD50C\uB7AB\uD3FC\uC5D0\uC11C\uB294 \uC74C\uC131 \uC778\uC2DD\uC744 \uC9C0\uC6D0\uD558\uC9C0 \uC54A\uC2B5\uB2C8\uB2E4. \uD328\uD0A4\uC9D5 \uC571\uC5D0\uC11C\uB294 speech \uB124\uC774\uD2F0\uBE0C \uAE30\uB2A5\uC744 \uD65C\uC131\uD654\uD558\uC138\uC694.");
+        }
+        return new Promise((resolve, reject) => {
+          const recognition = new Ctor();
+          this._webSpeechRecognition = recognition;
+          recognition.lang = options?.lang ?? "en-US";
+          recognition.interimResults = options?.interim ?? true;
+          recognition.continuous = options?.continuous ?? false;
+          let finalTranscript = "";
+          recognition.onresult = (event) => {
+            let interim = "";
+            for (let i = event.resultIndex; i < event.results.length; i++) {
+              const res = event.results[i];
+              if (res.isFinal) {
+                finalTranscript += res[0].transcript;
+              } else {
+                interim += res[0].transcript;
+              }
+            }
+            if (interim && options?.onPartial) options.onPartial(interim);
+          };
+          recognition.onerror = (event) => {
+            this._webSpeechRecognition = null;
+            reject(new Error(event?.error || "\uC74C\uC131 \uC778\uC2DD \uC624\uB958"));
+          };
+          recognition.onend = () => {
+            this._webSpeechRecognition = null;
+            resolve({ transcript: finalTranscript.trim(), isFinal: true });
+          };
+          recognition.start();
+        });
+      },
+      /**
+       * 진행 중인 음성 인식 중지
+       */
+      stop: async () => {
+        if (this.getPlatform() === "mobile" && window.NativeBridge?.speech) {
+          await window.NativeBridge.speech.stop();
+          return;
+        }
+        if (this._webSpeechRecognition) {
+          try {
+            this._webSpeechRecognition.stop();
+          } catch {
+          }
+        }
+      }
+    };
   }
   /**
    * 현재 플랫폼 감지
@@ -11047,6 +11272,7 @@ var ConnectBase = class {
     this.payment = new PaymentAPI(this.http);
     this.subscription = new SubscriptionAPI(this.http);
     this.push = new PushAPI(this.http);
+    this.roles = new RolesAPI(this.http);
     this.video = new VideoAPI(this.http, config.videoUrl || env("CB_VIDEO_URL") || DEFAULT_VIDEO_URL);
     this.game = new GameAPI(this.http, config.gameUrl || env("CB_GAME_URL") || DEFAULT_GAME_URL, config.appId);
     this.ads = new AdsAPI(this.http);
@@ -11141,6 +11367,7 @@ export {
   GameRoom,
   GameRoomTransport,
   NativeAPI,
+  RolesAPI,
   SessionManager,
   VideoProcessingError,
   index_default as default,

package/package.json

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