connectbase-client 3.35.2 → 3.37.0

package/dist/index.js

@@ -5517,11 +5517,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 미노출 플로우).
@@ -5585,7 +5597,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
+    );
   }
   /**
    * 결제 취소
@@ -6139,20 +6154,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' },
@@ -6161,9 +6178,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) {
@@ -6615,8 +6632,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) {
@@ -6702,31 +6720,37 @@ var VideoAPI = class {
   }
   // ========== Playlist Operations ==========
   /**
-   * Create a playlist
+   * Create a playlist for a channel.
+   * 백엔드는 `POST /v1/public/playlists` 에 body 로 `channel_id` 를 받는다 (AppMember 인증).
    */
   async createPlaylist(channelId, data) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/channels/${channelId}/playlists`, data);
+    return this.videoFetch("POST", `${prefix}/playlists`, {
+      ...data,
+      channel_id: channelId
+    });
   }
   /**
-   * Get playlists for a channel
+   * Get a channel's public playlists.
+   * 백엔드는 `GET /v1/public/playlists/public?channel_id=` 로 공개 플레이리스트를 반환한다.
    */
   async getPlaylists(channelId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/channels/${channelId}/playlists`
+      `${prefix}/playlists/public?channel_id=${encodeURIComponent(channelId)}`
     );
     return response.playlists;
   }
   /**
-   * Get playlist items
+   * Get playlist items.
+   * 백엔드는 별도 items 라우트가 없고 `GET /v1/public/playlists/:id` 응답에 items 를 포함한다.
    */
   async getPlaylistItems(playlistId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/playlists/${playlistId}/items`
+      `${prefix}/playlists/${playlistId}`
     );
     return response.items;
   }
@@ -6795,7 +6819,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
     });
@@ -6862,42 +6887,55 @@ 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 ==========
   /**
-   * Send a super chat
+   * Send a super chat to a channel.
+   *
+   * 백엔드는 `POST /v1/public/super-chats` 에 `channel_id`/`type`/`amount` 를 요구하고,
+   * `video_id` 또는 `live_id` 중 하나로 대상을 지정한다 (AppMember 인증 필수).
+   * 응답의 `client_secret` 으로 결제(Stripe)를 확정해야 슈퍼챗이 노출된다.
+   *
+   * @param channelId 슈퍼챗을 받을 채널 ID
+   * @param amount 금액(최소 단위 정수)
+   * @param options videoId 또는 liveId 중 하나로 대상 지정 + 종류/메시지/통화
    */
-  async sendSuperChat(videoId, amount, message, currency) {
+  async sendSuperChat(channelId, amount, options) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/videos/${videoId}/super-chats`, {
+    return this.videoFetch("POST", `${prefix}/super-chats`, {
+      channel_id: channelId,
+      type: options?.type ?? "super_thanks",
       amount,
-      message,
-      currency: currency || "USD"
+      video_id: options?.videoId,
+      live_id: options?.liveId,
+      currency: options?.currency ?? "USD",
+      message: options?.message,
+      sticker_id: options?.stickerId
     });
   }
   /**
@@ -6914,13 +6952,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;
   }
@@ -6932,7 +6972,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;
   }
@@ -6944,7 +6984,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;
   }
@@ -6965,9 +7005,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"
     });
   }
 };
@@ -7009,7 +7057,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 });
@@ -7667,7 +7715,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();
@@ -10993,11 +11041,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) {
@@ -11006,14 +11054,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/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) {
@@ -6656,31 +6674,37 @@ var VideoAPI = class {
   }
   // ========== Playlist Operations ==========
   /**
-   * Create a playlist
+   * Create a playlist for a channel.
+   * 백엔드는 `POST /v1/public/playlists` 에 body 로 `channel_id` 를 받는다 (AppMember 인증).
    */
   async createPlaylist(channelId, data) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/channels/${channelId}/playlists`, data);
+    return this.videoFetch("POST", `${prefix}/playlists`, {
+      ...data,
+      channel_id: channelId
+    });
   }
   /**
-   * Get playlists for a channel
+   * Get a channel's public playlists.
+   * 백엔드는 `GET /v1/public/playlists/public?channel_id=` 로 공개 플레이리스트를 반환한다.
    */
   async getPlaylists(channelId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/channels/${channelId}/playlists`
+      `${prefix}/playlists/public?channel_id=${encodeURIComponent(channelId)}`
     );
     return response.playlists;
   }
   /**
-   * Get playlist items
+   * Get playlist items.
+   * 백엔드는 별도 items 라우트가 없고 `GET /v1/public/playlists/:id` 응답에 items 를 포함한다.
    */
   async getPlaylistItems(playlistId) {
     const prefix = this.getPublicPrefix();
     const response = await this.videoFetch(
       "GET",
-      `${prefix}/playlists/${playlistId}/items`
+      `${prefix}/playlists/${playlistId}`
     );
     return response.items;
   }
@@ -6749,7 +6773,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,42 +6841,55 @@ 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 ==========
   /**
-   * Send a super chat
+   * Send a super chat to a channel.
+   *
+   * 백엔드는 `POST /v1/public/super-chats` 에 `channel_id`/`type`/`amount` 를 요구하고,
+   * `video_id` 또는 `live_id` 중 하나로 대상을 지정한다 (AppMember 인증 필수).
+   * 응답의 `client_secret` 으로 결제(Stripe)를 확정해야 슈퍼챗이 노출된다.
+   *
+   * @param channelId 슈퍼챗을 받을 채널 ID
+   * @param amount 금액(최소 단위 정수)
+   * @param options videoId 또는 liveId 중 하나로 대상 지정 + 종류/메시지/통화
    */
-  async sendSuperChat(videoId, amount, message, currency) {
+  async sendSuperChat(channelId, amount, options) {
     const prefix = this.getPublicPrefix();
-    return this.videoFetch("POST", `${prefix}/videos/${videoId}/super-chats`, {
+    return this.videoFetch("POST", `${prefix}/super-chats`, {
+      channel_id: channelId,
+      type: options?.type ?? "super_thanks",
       amount,
-      message,
-      currency: currency || "USD"
+      video_id: options?.videoId,
+      live_id: options?.liveId,
+      currency: options?.currency ?? "USD",
+      message: options?.message,
+      sticker_id: options?.stickerId
     });
   }
   /**
@@ -6868,13 +6906,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 +6926,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 +6938,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 +6959,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 +7011,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 +7669,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 +10995,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 +11008,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.37.0",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",