connectbase-client 3.35.2 → 3.36.0

package/dist/index.mjs

@@ -5471,11 +5471,23 @@ var PaymentAPI = class {
    *   // Mount PaymentElement, then:
    *   // stripe.confirmPayment({ elements, redirect: 'if_required' })
    * }
+   *
+   * // PayApp 결제 플로우 (위젯 불필요 — 호스팅 결제창으로 redirect)
+   * // 결제 결과는 서버의 feedbackurl webhook 으로 확정되며, 사용자는 success_url 로 복귀한다.
+   * if (result.payment_provider === 'payapp' && result.payapp_pay_url) {
+   *   window.location.href = result.payapp_pay_url
+   * }
    * ```
+   *
+   * @remarks
+   * PayApp 은 `customer_phone` 이 필수입니다(결제요청 수신 번호). 미지정 시 서버가 거부합니다.
    */
   async prepare(data) {
     const prefix = this.getPublicPrefix();
-    return this.http.post(`${prefix}/payments/prepare`, data);
+    return this.http.post(
+      `${prefix}/payments/prepare`,
+      data
+    );
   }
   /**
    * Stripe-hosted 결제 페이지 세션 생성 (client_secret 미노출 플로우).
@@ -5539,7 +5551,10 @@ var PaymentAPI = class {
    */
   async confirm(data) {
     const prefix = this.getPublicPrefix();
-    return this.http.post(`${prefix}/payments/confirm`, data);
+    return this.http.post(
+      `${prefix}/payments/confirm`,
+      data
+    );
   }
   /**
    * 결제 취소
@@ -6093,20 +6108,22 @@ var PushAPI = class {
   }
   // ============ Server-side Send (Functions / cb_sk_ 전용) ============
   /**
-   * 회원 ID 목록으로 푸시 발송 — Functions / cb_sk_ 인증 환경 전용.
+   * 회원 ID 목록으로 푸시 발송 — Functions / 서버사이드 인증 환경 전용.
    *
-   * 백엔드 라우트 `POST /v1/apps/:appID/push/send` 는 콘솔 JWT 또는 User Secret Key
-   * (`cb_sk_`) 만 받는다. 브라우저 SDK 의 Public Key(`cb_pk_`) 인스턴스에서는 호출
-   * 자체가 차단되며, 권한 누설을 막기 위해 명확한 에러를 던진다.
+   * 백엔드 라우트 `POST /v1/apps/:appID/push/send` 는 콘솔 JWT, User Secret Key(`cb_sk_`),
+   * 또는 service_role 토큰(`ctx.cbAdmin`)을 받는다. 브라우저 SDK 의 Public Key(`cb_pk_`)
+   * **단독** 인스턴스에서는 호출 자체가 차단되며(권한 누설 방지), 명확한 에러를 던진다.
+   * 위임 Bearer 토큰을 가진 인스턴스(`ctx.cbAdmin`/`ctx.cb`)는 cb_pk_ 가 앱 식별용으로만
+   * 실리므로 허용된다.
    *
-   * @param appId 발송 대상 앱 ID (cb_sk_ 환경은 user 단위 권한이므로 명시 전달).
+   * @param appId 발송 대상 앱 ID.
    * @param memberIds 받는 회원 ID 배열 (UUID).
    * @param payload 푸시 내용/옵션.
    *
    * @example
    * ```ts
-   * // ConnectBase Function (Node.js, secrets.CB_SECRET_KEY 주입)
-   * const result = await cb.push.sendToMembers(APP_ID, [memberId], {
+   * // ConnectBase Function (service_role=true) — 시크릿 키 없이 ctx.cbAdmin 으로 발송
+   * const result = await ctx.cbAdmin.push.sendToMembers(ctx.appId, [memberId], {
    *     title: '새 알림',
    *     body: '확인해보세요',
    *     data: { route: '/notifications' },
@@ -6115,9 +6132,9 @@ var PushAPI = class {
    * ```
    */
   async sendToMembers(appId, memberIds, payload) {
-    if (this.http.hasPublicKey()) {
+    if (this.http.hasPublicKey() && !this.http.hasJWT()) {
       throw new Error(
-        "cb.push.sendToMembers() \uB294 User Secret Key(cb_sk_) \uB610\uB294 \uCF58\uC194 JWT \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) 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."
+        "cb.push.sendToMembers() \uB294 User Secret Key(cb_sk_), \uCF58\uC194 JWT, \uB610\uB294 service_role(ctx.cbAdmin) \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."
       );
     }
     if (memberIds.length === 0) {
@@ -6569,8 +6586,9 @@ var VideoAPI = class {
    *
    * @example
    * ```ts
-   * const { url, expires_at } = await cb.video.getStreamUrl(videoId, '720p')
-   * videoElement.src = url
+   * const { master_playlist, qualities, expires_at } = await cb.video.getStreamUrl(videoId)
+   * videoElement.src = master_playlist // 적응형 비트레이트(HLS.js 등으로 재생)
+   * // 특정 화질 고정이 필요하면 qualities['720p'] 사용
    * ```
    */
   async getStreamUrl(videoId, quality) {
@@ -6749,7 +6767,8 @@ var VideoAPI = class {
    */
   async postComment(videoId, content, parentId) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/videos/${videoId}/comments`, {
+    return this.videoFetch("POST", `${prefix}/comments`, {
+      video_id: videoId,
       content,
       parent_id: parentId
     });
@@ -6816,31 +6835,31 @@ var VideoAPI = class {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/channels/${channelId}/memberships/tiers`
+      `${prefix}/channels/${channelId}/membership/tiers`
     );
     return response.tiers;
   }
   /**
    * Join a membership tier
+   *
+   * @param _channelId 현재 서버에서 무시됩니다 (tier 가 채널을 함의). API 안정성을 위해 시그니처만 유지.
+   * @param tierId 가입할 멤버십 티어 ID
    */
-  async joinMembership(channelId, tierId) {
+  async joinMembership(_channelId, tierId) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch(
-      "POST",
-      `${prefix}/channels/${channelId}/memberships/${tierId}/join`,
-      {}
-    );
+    return this.videoFetch("POST", `${prefix}/membership/join`, {
+      tier_id: tierId
+    });
   }
   /**
    * Cancel membership
+   *
+   * @param _channelId 현재 서버에서 무시됩니다. API 안정성을 위해 시그니처만 유지.
+   * @param membershipId 취소할 멤버십 ID
    */
-  async cancelMembership(channelId, membershipId) {
+  async cancelMembership(_channelId, membershipId) {
     const prefix = this.getPublicPrefix();
-    await this.videoFetch(
-      "POST",
-      `${prefix}/channels/${channelId}/memberships/${membershipId}/cancel`,
-      {}
-    );
+    await this.videoFetch("POST", `${prefix}/membership/${membershipId}/cancel`, {});
   }
   // ========== Super Chat Operations ==========
   /**
@@ -6868,13 +6887,15 @@ var VideoAPI = class {
   // ========== Recommendation Operations ==========
   /**
    * Get recommended videos
+   *
+   * @deprecated Use getHomeFeed() — 동일한 개인화 피드(`/recommendations/feed`)를 반환합니다.
    */
   async getRecommendations(limit) {
     const prefix = this.getPublicPrefix();
     const params = limit ? `?limit=${limit}` : "";
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/recommendations${params}`
+      `${prefix}/recommendations/feed${params}`
     );
     return response.videos;
   }
@@ -6886,7 +6907,7 @@ var VideoAPI = class {
     const params = limit ? `?limit=${limit}` : "";
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/recommendations/home${params}`
+      `${prefix}/recommendations/feed${params}`
     );
     return response.videos;
   }
@@ -6898,7 +6919,7 @@ var VideoAPI = class {
     const params = limit ? `?limit=${limit}` : "";
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/recommendations/related/${videoId}${params}`
+      `${prefix}/videos/${videoId}/related${params}`
     );
     return response.videos;
   }
@@ -6919,9 +6940,17 @@ var VideoAPI = class {
    */
   async submitFeedback(videoId, feedback) {
     const prefix = this.getPublicPrefix();
-    await this.videoFetch("POST", `${prefix}/recommendations/feedback`, {
+    if (feedback === "not_interested") {
+      await this.videoFetch(
+        "POST",
+        `${prefix}/recommendations/not-interested/${videoId}`,
+        {}
+      );
+      return;
+    }
+    await this.videoFetch("POST", `${prefix}/recommendations/interactions`, {
       video_id: videoId,
-      feedback
+      type: "like"
     });
   }
 };
@@ -6963,7 +6992,7 @@ var GameConfigAPI = class {
   /**
    * 단일 기능 활성화 — set() 의 편의 wrapper.
    *
-   * @example await cb.game.config.enable(appId, "matchqueue")
+   * @example await cb.game.config.enable(appId, "matchqueue_enabled")
    */
   async enable(appId, feature) {
     return this.set(appId, { [feature]: true });
@@ -7621,7 +7650,7 @@ var GameAPI = class {
     const response = await fetch(`${this.gameServerUrl}/v1/game/${id}/rooms/${roomId}/spectators`, {
       method: "POST",
       headers: { ...this.getHeaders(), "Content-Type": "application/json" },
-      body: JSON.stringify({ player_id: playerId })
+      body: JSON.stringify({ user_id: playerId })
     });
     if (!response.ok) throw new Error(`Failed to join spectator: ${response.statusText}`);
     return response.json();
@@ -10947,11 +10976,11 @@ var GameRoomTransport = class {
     });
   }
   // Private methods
-  send(type, data) {
+  send(type, data, msgId) {
     if (!this.transport?.isConnected()) {
       throw new GameError({ code: "NOT_CONNECTED", message: "Not connected" });
     }
-    const message = JSON.stringify({ type, data });
+    const message = JSON.stringify({ type, data, msg_id: msgId });
     this.transport.send(message, true);
   }
   sendWithHandler(type, data, handler) {
@@ -10960,14 +10989,14 @@ var GameRoomTransport = class {
     setTimeout(() => {
       this.pendingHandlers.delete(id);
     }, 1e4);
-    this.send(type, { ...data, _msg_id: id });
+    this.send(type, data, id);
   }
   handleMessage(data) {
     try {
       const msg = JSON.parse(data);
-      if (msg._msg_id && this.pendingHandlers.has(msg._msg_id)) {
-        const handler = this.pendingHandlers.get(msg._msg_id);
-        this.pendingHandlers.delete(msg._msg_id);
+      if (msg.msg_id && this.pendingHandlers.has(msg.msg_id)) {
+        const handler = this.pendingHandlers.get(msg.msg_id);
+        this.pendingHandlers.delete(msg.msg_id);
         handler(msg);
         return;
       }

package/package.json

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