connectbase-client 4.3.0 → 4.4.1

package/dist/index.d.mts

@@ -5713,16 +5713,30 @@ interface UpdatePublicKeyResponse {
 /**
  * Public Key 관리 API
  *
+ * 콘솔 JWT 또는 **service_role 함수**(`ctx.cbAdmin`)로 호출한다. 브라우저에서 Public Key(cb_pk_)
+ * 단독으로는 호출할 수 없다 — 키가 자기 자신을 발급/수정하는 경로를 막는다.
+ *
+ * service_role 함수에서 쓰려면 함수 `management_scopes` 에 스코프를 opt-in 해야 한다:
+ * `publickey:read`(목록 조회) / `publickey:manage`(생성·수정·삭제).
+ *
+ * `payment_mode` 로 키마다 결제 자격증명 모드를 고정할 수 있다 — QA 빌드에 `test` 키를 심으면
+ * 앱 설정과 무관하게 그 키의 결제만 테스트로 처리된다(platform-issue 019f9961).
+ *
  * @example
  * ```typescript
  * // Public Key 목록 조회
  * const keys = await cb.publicKey.getPublicKeys('app-id')
  *
- * // 새 Public Key 생성
- * const newKey = await cb.publicKey.createPublicKey('app-id', { name: 'Production' })
- * console.log(newKey.key) // 전체 키 (이때만 볼 수 있음!)
+ * // QA 빌드용 테스트 결제 키 생성
+ * const newKey = await cb.publicKey.createPublicKey('app-id', {
+ *   name: 'QA',
+ *   payment_mode: 'test',
+ * })
+ * console.log(newKey.key)          // 전체 키 (이때만 볼 수 있음!)
+ * console.log(newKey.payment_mode) // 'test' — 되읽어 검증
  *
- * // Public Key 비활성화
+ * // 모드 변경 / 비활성화
+ * await cb.publicKey.updatePublicKey('app-id', 'key-id', { payment_mode: 'live' })
  * await cb.publicKey.updatePublicKey('app-id', 'key-id', { is_active: false })
  *
  * // Public Key 삭제
@@ -5732,8 +5746,9 @@ interface UpdatePublicKeyResponse {
 declare class PublicKeyAPI {
     private http;
     constructor(http: HttpClient);
+    private ensureServerAuth;
     /**
-     * 앱의 Public Key 목록을 조회합니다
+     * 앱의 Public Key 목록을 조회합니다 (management_scope: `publickey:read`)
      * @param appId 앱 ID
      */
     getPublicKeys(appId: string): Promise<FetchPublicKeysResponse>;
@@ -5744,18 +5759,22 @@ declare class PublicKeyAPI {
      * 안전한 곳에 저장하세요.
      *
      * @param appId 앱 ID
-     * @param data 생성할 Public Key 정보
+     * @param data 생성할 Public Key 정보 (`payment_mode` 로 결제 모드 고정 가능)
+     *
+     * (management_scope: `publickey:manage`)
      */
     createPublicKey(appId: string, data: CreatePublicKeyRequest): Promise<CreatePublicKeyResponse>;
     /**
-     * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화)
+     * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화, `payment_mode` 변경)
+     *
+     * (management_scope: `publickey:manage`)
      * @param appId 앱 ID
      * @param keyId Public Key ID
      * @param data 수정할 정보
      */
     updatePublicKey(appId: string, keyId: string, data: UpdatePublicKeyRequest): Promise<UpdatePublicKeyResponse>;
     /**
-     * Public Key 를 삭제합니다
+     * Public Key 를 삭제합니다 (management_scope: `publickey:manage`)
      * @param appId 앱 ID
      * @param keyId Public Key ID
      */

package/dist/index.d.ts

@@ -5713,16 +5713,30 @@ interface UpdatePublicKeyResponse {
 /**
  * Public Key 관리 API
  *
+ * 콘솔 JWT 또는 **service_role 함수**(`ctx.cbAdmin`)로 호출한다. 브라우저에서 Public Key(cb_pk_)
+ * 단독으로는 호출할 수 없다 — 키가 자기 자신을 발급/수정하는 경로를 막는다.
+ *
+ * service_role 함수에서 쓰려면 함수 `management_scopes` 에 스코프를 opt-in 해야 한다:
+ * `publickey:read`(목록 조회) / `publickey:manage`(생성·수정·삭제).
+ *
+ * `payment_mode` 로 키마다 결제 자격증명 모드를 고정할 수 있다 — QA 빌드에 `test` 키를 심으면
+ * 앱 설정과 무관하게 그 키의 결제만 테스트로 처리된다(platform-issue 019f9961).
+ *
  * @example
  * ```typescript
  * // Public Key 목록 조회
  * const keys = await cb.publicKey.getPublicKeys('app-id')
  *
- * // 새 Public Key 생성
- * const newKey = await cb.publicKey.createPublicKey('app-id', { name: 'Production' })
- * console.log(newKey.key) // 전체 키 (이때만 볼 수 있음!)
+ * // QA 빌드용 테스트 결제 키 생성
+ * const newKey = await cb.publicKey.createPublicKey('app-id', {
+ *   name: 'QA',
+ *   payment_mode: 'test',
+ * })
+ * console.log(newKey.key)          // 전체 키 (이때만 볼 수 있음!)
+ * console.log(newKey.payment_mode) // 'test' — 되읽어 검증
  *
- * // Public Key 비활성화
+ * // 모드 변경 / 비활성화
+ * await cb.publicKey.updatePublicKey('app-id', 'key-id', { payment_mode: 'live' })
  * await cb.publicKey.updatePublicKey('app-id', 'key-id', { is_active: false })
  *
  * // Public Key 삭제
@@ -5732,8 +5746,9 @@ interface UpdatePublicKeyResponse {
 declare class PublicKeyAPI {
     private http;
     constructor(http: HttpClient);
+    private ensureServerAuth;
     /**
-     * 앱의 Public Key 목록을 조회합니다
+     * 앱의 Public Key 목록을 조회합니다 (management_scope: `publickey:read`)
      * @param appId 앱 ID
      */
     getPublicKeys(appId: string): Promise<FetchPublicKeysResponse>;
@@ -5744,18 +5759,22 @@ declare class PublicKeyAPI {
      * 안전한 곳에 저장하세요.
      *
      * @param appId 앱 ID
-     * @param data 생성할 Public Key 정보
+     * @param data 생성할 Public Key 정보 (`payment_mode` 로 결제 모드 고정 가능)
+     *
+     * (management_scope: `publickey:manage`)
      */
     createPublicKey(appId: string, data: CreatePublicKeyRequest): Promise<CreatePublicKeyResponse>;
     /**
-     * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화)
+     * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화, `payment_mode` 변경)
+     *
+     * (management_scope: `publickey:manage`)
      * @param appId 앱 ID
      * @param keyId Public Key ID
      * @param data 수정할 정보
      */
     updatePublicKey(appId: string, keyId: string, data: UpdatePublicKeyRequest): Promise<UpdatePublicKeyResponse>;
     /**
-     * Public Key 를 삭제합니다
+     * Public Key 를 삭제합니다 (management_scope: `publickey:manage`)
      * @param appId 앱 ID
      * @param keyId Public Key ID
      */

package/dist/index.js

@@ -6161,11 +6161,19 @@ var PublicKeyAPI = class {
   constructor(http) {
     this.http = http;
   }
+  ensureServerAuth(method) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        `cb.publicKey.${method}() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["publickey:read" | "publickey: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.`
+      );
+    }
+  }
   /**
-   * 앱의 Public Key 목록을 조회합니다
+   * 앱의 Public Key 목록을 조회합니다 (management_scope: `publickey:read`)
    * @param appId 앱 ID
    */
   async getPublicKeys(appId) {
+    this.ensureServerAuth("getPublicKeys");
     return this.http.get(
       `/v1/apps/${appId}/public-keys`
     );
@@ -6177,32 +6185,39 @@ var PublicKeyAPI = class {
    * 안전한 곳에 저장하세요.
    *
    * @param appId 앱 ID
-   * @param data 생성할 Public Key 정보
+   * @param data 생성할 Public Key 정보 (`payment_mode` 로 결제 모드 고정 가능)
+   *
+   * (management_scope: `publickey:manage`)
    */
   async createPublicKey(appId, data) {
+    this.ensureServerAuth("createPublicKey");
     return this.http.post(
       `/v1/apps/${appId}/public-keys`,
       data
     );
   }
   /**
-   * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화)
+   * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화, `payment_mode` 변경)
+   *
+   * (management_scope: `publickey:manage`)
    * @param appId 앱 ID
    * @param keyId Public Key ID
    * @param data 수정할 정보
    */
   async updatePublicKey(appId, keyId, data) {
+    this.ensureServerAuth("updatePublicKey");
     return this.http.patch(
       `/v1/apps/${appId}/public-keys/${keyId}`,
       data
     );
   }
   /**
-   * Public Key 를 삭제합니다
+   * Public Key 를 삭제합니다 (management_scope: `publickey:manage`)
    * @param appId 앱 ID
    * @param keyId Public Key ID
    */
   async deletePublicKey(appId, keyId) {
+    this.ensureServerAuth("deletePublicKey");
     await this.http.delete(`/v1/apps/${appId}/public-keys/${keyId}`);
   }
 };
@@ -10758,8 +10773,16 @@ function sanitizePathForBreadcrumb(rawUrl) {
 }
 
 // src/core/http.ts
+var COOKIE_BEARING_PUBLIC_PATHS = /* @__PURE__ */ new Set([
+  "/v1/public/app-members/signup",
+  "/v1/public/app-members/signin",
+  "/v1/public/app-members/signout"
+]);
 function fetchCredentialsForPath(url) {
   const path = url.split("?")[0];
+  if (COOKIE_BEARING_PUBLIC_PATHS.has(path)) {
+    return "include";
+  }
   return path.startsWith("/v1/public/") ? "omit" : "include";
 }
 var TOKEN_STORAGE_KEY = "cb_auth_tokens";

package/dist/index.mjs

@@ -6115,11 +6115,19 @@ var PublicKeyAPI = class {
   constructor(http) {
     this.http = http;
   }
+  ensureServerAuth(method) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      throw new Error(
+        `cb.publicKey.${method}() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["publickey:read" | "publickey: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.`
+      );
+    }
+  }
   /**
-   * 앱의 Public Key 목록을 조회합니다
+   * 앱의 Public Key 목록을 조회합니다 (management_scope: `publickey:read`)
    * @param appId 앱 ID
    */
   async getPublicKeys(appId) {
+    this.ensureServerAuth("getPublicKeys");
     return this.http.get(
       `/v1/apps/${appId}/public-keys`
     );
@@ -6131,32 +6139,39 @@ var PublicKeyAPI = class {
    * 안전한 곳에 저장하세요.
    *
    * @param appId 앱 ID
-   * @param data 생성할 Public Key 정보
+   * @param data 생성할 Public Key 정보 (`payment_mode` 로 결제 모드 고정 가능)
+   *
+   * (management_scope: `publickey:manage`)
    */
   async createPublicKey(appId, data) {
+    this.ensureServerAuth("createPublicKey");
     return this.http.post(
       `/v1/apps/${appId}/public-keys`,
       data
     );
   }
   /**
-   * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화)
+   * Public Key 를 수정합니다 (이름 변경, 활성화/비활성화, `payment_mode` 변경)
+   *
+   * (management_scope: `publickey:manage`)
    * @param appId 앱 ID
    * @param keyId Public Key ID
    * @param data 수정할 정보
    */
   async updatePublicKey(appId, keyId, data) {
+    this.ensureServerAuth("updatePublicKey");
     return this.http.patch(
       `/v1/apps/${appId}/public-keys/${keyId}`,
       data
     );
   }
   /**
-   * Public Key 를 삭제합니다
+   * Public Key 를 삭제합니다 (management_scope: `publickey:manage`)
    * @param appId 앱 ID
    * @param keyId Public Key ID
    */
   async deletePublicKey(appId, keyId) {
+    this.ensureServerAuth("deletePublicKey");
     await this.http.delete(`/v1/apps/${appId}/public-keys/${keyId}`);
   }
 };
@@ -10712,8 +10727,16 @@ function sanitizePathForBreadcrumb(rawUrl) {
 }
 
 // src/core/http.ts
+var COOKIE_BEARING_PUBLIC_PATHS = /* @__PURE__ */ new Set([
+  "/v1/public/app-members/signup",
+  "/v1/public/app-members/signin",
+  "/v1/public/app-members/signout"
+]);
 function fetchCredentialsForPath(url) {
   const path = url.split("?")[0];
+  if (COOKIE_BEARING_PUBLIC_PATHS.has(path)) {
+    return "include";
+  }
   return path.startsWith("/v1/public/") ? "omit" : "include";
 }
 var TOKEN_STORAGE_KEY = "cb_auth_tokens";

package/package.json

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