connectbase-client 3.11.0 → 3.13.0

package/dist/index.js

@@ -1344,23 +1344,38 @@ var DatabaseAPI = class {
   // ============ Batch & Transactions ============
   /**
    * 배치 쓰기 (여러 테이블 다중 문서 원자적 처리)
+   *
+   * 서버는 HTTP 200 + `success:false` + 개별 op `error` 로 부분 실패를 표현한다.
+   * SDK 는 호출자가 silent success 로 오해하지 않도록 첫 실패 op 의 메시지로 throw 한다.
    */
   async batch(operations) {
     const prefix = this.getPublicPrefix();
-    return this.http.post(
+    const response = await this.http.post(
       `${prefix}/batch`,
       { operations }
     );
+    if (response && response.success === false) {
+      const first = response.results?.find((r) => r && r.success === false);
+      throw new Error(first?.error || "batch operation failed");
+    }
+    return response;
   }
   /**
    * 트랜잭션 실행 (읽기 → 쓰기 ACID)
+   *
+   * 서버는 부분 실패가 없는 ACID 트랜잭션을 보장하지만, 검증/RLS/충돌은
+   * `success:false` + `error` 로 알린다. SDK 는 silent success 회귀 방지 차원에서 throw.
    */
   async transaction(reads, writes) {
     const prefix = this.getPublicPrefix();
-    return this.http.post(
+    const response = await this.http.post(
       `${prefix}/transactions`,
       { reads, writes }
     );
+    if (response && response.success === false) {
+      throw new Error(response.error || "transaction failed");
+    }
+    return response;
   }
   // ============ Populate (Relation Query) ============
   /**
@@ -9115,6 +9130,67 @@ var SupportAPI = class {
     if (req.recaptchaToken) body.recaptcha_token = req.recaptchaToken;
     return this.http.post("/v1/public/reports", body);
   }
+  /**
+   * 다른 앱(target) 에 자기 사용자(end-user) 명의로 cross-app 위임 이슈를 발행한다.
+   *
+   * **사용 시나리오**: source_app(예: Makers) 의 backend 가 OAuth `authorization_code` grant 로
+   * 발급받은 사용자 access_token 을 사용해, target_app(예: ai-tool) 에게 "Makers user A 가 보낸"
+   * 이슈로 제보. target 측 콘솔 inbox 에는 `reporter_kind=user` + `reporter_app_id=Makers` 로 표시.
+   *
+   * 본 메서드는 SDK 의 publicKey/secretKey 인증 컨텍스트를 사용하지 않고, 호출자가 명시적으로 전달한
+   * cross-app OAuth Bearer access_token 만 사용 (server-to-server 위임 흐름).
+   *
+   * @param req - 발행 본문
+   * @param req.targetAppId - 수신 앱 ID (= OAuth token 의 audience `app:<uuid>` 와 일치해야 함)
+   * @param req.accessToken - source_app 이 발급받은 cross-app OAuth access_token (authorization_code grant)
+   *
+   * @throws ApiError 401 — `delegated_user_required`: access_token 이 client_credentials grant
+   * @throws ApiError 403 — `trust_chain_violation`: source_app 이 target_app 의 cross-app provider 로 등록되지 않음
+   * @throws ApiError 403 — `insufficient_scope`: token 에 `issue:report:on-behalf-of-user` 미포함
+   *
+   * @example Makers backend → ai-tool 에 사용자 명의 제보
+   * ```typescript
+   * await cb.support.reportIssueOnBehalfOfUser({
+   *     targetAppId: 'ai-tool-uuid',
+   *     accessToken: makersUserAccessToken, // authorization_code grant 토큰
+   *     title: '생성 실패',
+   *     body: 'prompt X 가 5분째 응답 없음',
+   *     category: 'bug',
+   *     metadata: { prompt_id: 'p_42' },
+   * })
+   * ```
+   */
+  async reportIssueOnBehalfOfUser(req) {
+    if (!req.targetAppId) throw new Error("targetAppId is required");
+    if (!req.accessToken) throw new Error("accessToken is required");
+    const body = {
+      title: req.title,
+      body: req.body
+    };
+    if (req.category) body.category = req.category;
+    if (req.metadata) body.metadata = req.metadata;
+    const url = `${this.http.getBaseUrl()}/v1/integrations/providers/${encodeURIComponent(req.targetAppId)}/issues/by-user`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${req.accessToken}`
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: response.statusText };
+      }
+      const errObj = errorBody ?? {};
+      const message = errObj.error_description ?? errObj.error ?? `HTTP ${response.status}`;
+      throw new Error(`reportIssueOnBehalfOfUser failed (${response.status}): ${message}`);
+    }
+    return await response.json();
+  }
   /**
    * ConnectBase 플랫폼 자체 버그/요청/문의를 발행한다.
    *
@@ -9208,7 +9284,7 @@ var SupportAPI = class {
    * 본인이 발행한 platform issue 의 처리 진행 상황을 단건 조회.
    *
    * AI 가 "내가 발행한 이슈 처리됐어?" 를 폴링하는 표준 경로. status / resolution_note /
-   * triage_summary / external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
+   * external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
    *
    * @throws ApiError 404 — 본인 issue 가 아니거나 존재하지 않음
    */
@@ -9800,9 +9876,29 @@ var GameRoomTransport = class {
         case "error":
           this.handlers.onError?.({
             code: msg.code || "UNKNOWN",
-            message: msg.message || "Unknown error"
+            message: msg.message || "Unknown error",
+            phase: msg.phase,
+            feature: msg.feature,
+            roomId: msg.room_id,
+            scriptId: msg.script_id
           });
           break;
+        case "room_stale":
+          if (this.handlers.onRoomStale) {
+            this.handlers.onRoomStale({
+              reason: msg.reason || "unknown",
+              roomId: msg.room_id || "",
+              scriptId: msg.script_id,
+              scriptVersion: msg.script_version,
+              serverTime: msg.server_time || 0
+            });
+          } else {
+            console.warn(
+              "[connect-base game] room_stale received but onRoomStale handler not set:",
+              { reason: msg.reason, roomId: msg.room_id, scriptVersion: msg.script_version }
+            );
+          }
+          break;
       }
     } catch {
       console.error("Failed to parse game message:", data);

package/dist/index.mjs

@@ -1302,23 +1302,38 @@ var DatabaseAPI = class {
   // ============ Batch & Transactions ============
   /**
    * 배치 쓰기 (여러 테이블 다중 문서 원자적 처리)
+   *
+   * 서버는 HTTP 200 + `success:false` + 개별 op `error` 로 부분 실패를 표현한다.
+   * SDK 는 호출자가 silent success 로 오해하지 않도록 첫 실패 op 의 메시지로 throw 한다.
    */
   async batch(operations) {
     const prefix = this.getPublicPrefix();
-    return this.http.post(
+    const response = await this.http.post(
       `${prefix}/batch`,
       { operations }
     );
+    if (response && response.success === false) {
+      const first = response.results?.find((r) => r && r.success === false);
+      throw new Error(first?.error || "batch operation failed");
+    }
+    return response;
   }
   /**
    * 트랜잭션 실행 (읽기 → 쓰기 ACID)
+   *
+   * 서버는 부분 실패가 없는 ACID 트랜잭션을 보장하지만, 검증/RLS/충돌은
+   * `success:false` + `error` 로 알린다. SDK 는 silent success 회귀 방지 차원에서 throw.
    */
   async transaction(reads, writes) {
     const prefix = this.getPublicPrefix();
-    return this.http.post(
+    const response = await this.http.post(
       `${prefix}/transactions`,
       { reads, writes }
     );
+    if (response && response.success === false) {
+      throw new Error(response.error || "transaction failed");
+    }
+    return response;
   }
   // ============ Populate (Relation Query) ============
   /**
@@ -9073,6 +9088,67 @@ var SupportAPI = class {
     if (req.recaptchaToken) body.recaptcha_token = req.recaptchaToken;
     return this.http.post("/v1/public/reports", body);
   }
+  /**
+   * 다른 앱(target) 에 자기 사용자(end-user) 명의로 cross-app 위임 이슈를 발행한다.
+   *
+   * **사용 시나리오**: source_app(예: Makers) 의 backend 가 OAuth `authorization_code` grant 로
+   * 발급받은 사용자 access_token 을 사용해, target_app(예: ai-tool) 에게 "Makers user A 가 보낸"
+   * 이슈로 제보. target 측 콘솔 inbox 에는 `reporter_kind=user` + `reporter_app_id=Makers` 로 표시.
+   *
+   * 본 메서드는 SDK 의 publicKey/secretKey 인증 컨텍스트를 사용하지 않고, 호출자가 명시적으로 전달한
+   * cross-app OAuth Bearer access_token 만 사용 (server-to-server 위임 흐름).
+   *
+   * @param req - 발행 본문
+   * @param req.targetAppId - 수신 앱 ID (= OAuth token 의 audience `app:<uuid>` 와 일치해야 함)
+   * @param req.accessToken - source_app 이 발급받은 cross-app OAuth access_token (authorization_code grant)
+   *
+   * @throws ApiError 401 — `delegated_user_required`: access_token 이 client_credentials grant
+   * @throws ApiError 403 — `trust_chain_violation`: source_app 이 target_app 의 cross-app provider 로 등록되지 않음
+   * @throws ApiError 403 — `insufficient_scope`: token 에 `issue:report:on-behalf-of-user` 미포함
+   *
+   * @example Makers backend → ai-tool 에 사용자 명의 제보
+   * ```typescript
+   * await cb.support.reportIssueOnBehalfOfUser({
+   *     targetAppId: 'ai-tool-uuid',
+   *     accessToken: makersUserAccessToken, // authorization_code grant 토큰
+   *     title: '생성 실패',
+   *     body: 'prompt X 가 5분째 응답 없음',
+   *     category: 'bug',
+   *     metadata: { prompt_id: 'p_42' },
+   * })
+   * ```
+   */
+  async reportIssueOnBehalfOfUser(req) {
+    if (!req.targetAppId) throw new Error("targetAppId is required");
+    if (!req.accessToken) throw new Error("accessToken is required");
+    const body = {
+      title: req.title,
+      body: req.body
+    };
+    if (req.category) body.category = req.category;
+    if (req.metadata) body.metadata = req.metadata;
+    const url = `${this.http.getBaseUrl()}/v1/integrations/providers/${encodeURIComponent(req.targetAppId)}/issues/by-user`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${req.accessToken}`
+      },
+      body: JSON.stringify(body)
+    });
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+        errorBody = { error: response.statusText };
+      }
+      const errObj = errorBody ?? {};
+      const message = errObj.error_description ?? errObj.error ?? `HTTP ${response.status}`;
+      throw new Error(`reportIssueOnBehalfOfUser failed (${response.status}): ${message}`);
+    }
+    return await response.json();
+  }
   /**
    * ConnectBase 플랫폼 자체 버그/요청/문의를 발행한다.
    *
@@ -9166,7 +9242,7 @@ var SupportAPI = class {
    * 본인이 발행한 platform issue 의 처리 진행 상황을 단건 조회.
    *
    * AI 가 "내가 발행한 이슈 처리됐어?" 를 폴링하는 표준 경로. status / resolution_note /
-   * triage_summary / external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
+   * external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
    *
    * @throws ApiError 404 — 본인 issue 가 아니거나 존재하지 않음
    */
@@ -9758,9 +9834,29 @@ var GameRoomTransport = class {
         case "error":
           this.handlers.onError?.({
             code: msg.code || "UNKNOWN",
-            message: msg.message || "Unknown error"
+            message: msg.message || "Unknown error",
+            phase: msg.phase,
+            feature: msg.feature,
+            roomId: msg.room_id,
+            scriptId: msg.script_id
           });
           break;
+        case "room_stale":
+          if (this.handlers.onRoomStale) {
+            this.handlers.onRoomStale({
+              reason: msg.reason || "unknown",
+              roomId: msg.room_id || "",
+              scriptId: msg.script_id,
+              scriptVersion: msg.script_version,
+              serverTime: msg.server_time || 0
+            });
+          } else {
+            console.warn(
+              "[connect-base game] room_stale received but onRoomStale handler not set:",
+              { reason: msg.reason, roomId: msg.room_id, scriptVersion: msg.script_version }
+            );
+          }
+          break;
       }
     } catch {
       console.error("Failed to parse game message:", data);

package/package.json

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