connectbase-client 3.46.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 {
@@ -11197,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);
@@ -11292,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 {
@@ -11152,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);
@@ -11246,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.46.0",
+  "version": "3.47.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",