connectbase-client 3.46.0 → 3.48.0

package/dist/index.mjs

@@ -139,6 +139,9 @@ var HttpClient = class {
      * 한 번 settle 되면 그 결과(메모리 적재 또는 미로그인)가 항상 반영되어 있다.
      */
     this.bootRestorePromise = null;
+    // OAuth 콜백 부트스트랩처럼 세션 힌트 유무와 무관하게 첫 인증 호출이 반드시 기다려야
+    // 하는 boot promise 인지 여부 (setBootRestorePromise 의 alwaysAwait 옵션).
+    this.bootRestoreAlwaysAwait = false;
     this.config = { ...config };
     this.storageKey = this.buildStorageKey();
     this.warnIfUnsafePersistence();
@@ -148,9 +151,14 @@ var HttpClient = class {
    * 페이지 진입 시 fire-and-forget 으로 시작된 cookie 복구 promise 를 SDK 가 등록한다.
    * 같은 promise 가 `prepareHeaders` 에서 await 되어, 첫 인증 호출이 cookie 복구
    * 완료 후 발화한다.
+   *
+   * options.alwaysAwait=true 면 세션 힌트가 없어도 첫 인증 호출이 이 promise 를
+   * 기다린다 — OAuth 리다이렉트 콜백처럼 "이 부트 promise 가 곧 세션을 만든다"는 것이
+   * 확실한 흐름용 (일반 cookie 복구는 힌트 기반 fast-path 적용).
    */
-  setBootRestorePromise(p) {
+  setBootRestorePromise(p, options) {
     this.bootRestorePromise = p.catch(() => false);
+    this.bootRestoreAlwaysAwait = options?.alwaysAwait === true;
   }
   /** 최근 호출 ring buffer 스냅샷 (시간순). */
   getRecentCalls() {
@@ -179,11 +187,49 @@ var HttpClient = class {
     this.config.accessToken = accessToken;
     this.config.refreshToken = refreshToken;
     this.persistTokens();
+    this.markSessionHint();
   }
   clearTokens() {
     this.config.accessToken = void 0;
     this.config.refreshToken = void 0;
     this.removePersistedTokens();
+    this.clearSessionHint();
+  }
+  // ===== 세션 힌트 =====
+  //
+  // "이 origin 에서 이 앱으로 로그인한 적이 있다"는 boolean 마커 (토큰 아님 — 민감정보 없음).
+  // 부트 시 cookie 복구(`/v1/auth/re-issue`)를 첫 인증 호출이 기다릴지 판단하는 데 쓴다:
+  //   - 힌트 있음 → 기존과 동일하게 대기 (로그인 세션의 첫 호출이 익명으로 나가는 것 방지).
+  //   - 힌트 없음 → 대기 생략. 익명 방문자(공개 사이트 첫 방문 대부분)의 첫 조회가
+  //     re-issue 왕복만큼 빨라진다. 복구 자체는 백그라운드로 계속 진행되므로, 드물게
+  //     힌트가 지워졌지만 cookie 세션이 살아있는 경우도 이후 호출부터 자동 회복된다.
+  //
+  // 세션을 만드는 모든 흐름(로그인/OAuth 콜백/토큰 refresh)이 setTokens 를 경유하므로
+  // 그곳에서 마킹하고, clearTokens(로그아웃)에서 지운다.
+  buildSessionHintKey() {
+    return `${this.buildStorageKey()}:has_session`;
+  }
+  markSessionHint() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.setItem(this.buildSessionHintKey(), "1");
+    } catch {
+    }
+  }
+  clearSessionHint() {
+    if (typeof window === "undefined") return;
+    try {
+      localStorage.removeItem(this.buildSessionHintKey());
+    } catch {
+    }
+  }
+  hasSessionHint() {
+    if (typeof window === "undefined") return false;
+    try {
+      return localStorage.getItem(this.buildSessionHintKey()) === "1";
+    } catch {
+      return true;
+    }
   }
   /**
    * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
@@ -512,7 +558,7 @@ var HttpClient = class {
     if (credential) {
       headers.set("X-Public-Key", credential);
     }
-    if (!config?.skipAuth && !this.config.accessToken && this.config.publicKey && typeof window !== "undefined" && this.bootRestorePromise) {
+    if (!config?.skipAuth && !this.config.accessToken && this.config.publicKey && typeof window !== "undefined" && this.bootRestorePromise && (this.bootRestoreAlwaysAwait || this.hasSessionHint())) {
       try {
         await this.bootRestorePromise;
       } catch {
@@ -1222,6 +1268,7 @@ var DatabaseAPI = class {
     const params = new URLSearchParams();
     if (options?.limit) params.append("limit", options.limit.toString());
     if (options?.offset) params.append("offset", options.offset.toString());
+    if (options?.count === false) params.append("count", "false");
     const queryString = params.toString();
     const url = queryString ? `${prefix}/tables/${tableId}/data?${queryString}` : `${prefix}/tables/${tableId}/data`;
     return this.http.get(url);
@@ -1240,7 +1287,8 @@ var DatabaseAPI = class {
         limit: options.limit,
         offset: options.offset,
         select: options.select,
-        exclude: options.exclude
+        exclude: options.exclude,
+        count: options.count
       }
     );
   }
@@ -1404,7 +1452,8 @@ var DatabaseAPI = class {
         offset: options.offset,
         select: options.select,
         exclude: options.exclude,
-        populate: options.populate
+        populate: options.populate,
+        count: options.count
       }
     );
   }
@@ -5403,6 +5452,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 +6085,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 +6167,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 +11321,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);
@@ -11166,7 +11336,7 @@ var ConnectBase = class {
     const shouldAutoRestore = config.autoRestoreSession ?? true;
     if (shouldAutoRestore && typeof window !== "undefined") {
       if (this.isOAuthRedirectCallbackUrl()) {
-        this.http.setBootRestorePromise(this.oauth.consumeRedirectCallbackOnBoot());
+        this.http.setBootRestorePromise(this.oauth.consumeRedirectCallbackOnBoot(), { alwaysAwait: true });
       } else if (!this.isOAuthCallbackUrl()) {
         this.http.setBootRestorePromise(this.http.tryRestoreSessionFromCookie());
       }
@@ -11246,6 +11416,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.48.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",