connectbase-client 3.12.0 → 3.13.1

package/CHANGELOG.md

@@ -3,6 +3,50 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.13.1] - 2026-05-13
+
+### Documentation — README batch/transaction 예제 타입 회귀 수정
+
+README 의 `cb.database.batch()` / `cb.database.transaction()` 예제가 구 시그니처
+(`table: 'string'`) 를 사용해 `tsc --noEmit` 에서 `TS2353` 발생하던 문제 수정.
+
+- `table:` → `table_id:` (UUID, 실제 `BatchOperation` 타입과 일치)
+- 3.12+ 의 `success:false` throw 동작 반영 — try/catch 패턴 명시
+
+코드 변경은 없음. README 만 갱신.
+
+## [3.13.0] - 2026-05-13
+
+### Removed — `PlatformIssueDetail.triage_summary` / `triaged_at` 필드
+
+ConnectBase 가 Platform Issue 의 AI 자동 분류 (triage) 기능을 통째 제거함에 따라
+SDK 의 응답 타입에서도 다음 필드를 제거.
+
+```typescript
+// 이전 (3.12 이하)
+interface PlatformIssueDetail {
+  triage_summary?: string  // ← 제거
+  triaged_at?: string      // ← 제거
+  // ...
+}
+
+// 3.13+ — AI 요약 필드 없음. status / resolution_note / external_links 로 진행 확인.
+```
+
+`status='triaged'` enum 값은 운영자 수동 분류 의미로 유지된다 (코드 변경 불필요).
+
+### Behavior change — `cb.support.reportPlatformBug` 의 category/severity 자동 보정 없음
+
+이전: AI triage 가 발행 직후 비동기로 category / severity 를 보정.
+3.13+: 운영자가 admin 콘솔에서 수동 조정. SDK 발행자가 지정한 값이 그대로 유지된다.
+
+### Backend wiring (참고)
+
+- `backend/cmd/core-server/app/worker/platform_issue_triage/` 워커 전체 제거
+- `ent` 컬럼 6개 (`triage_summary`/`triage_keywords`/`triage_similar_issue_ids`/`body_embedding`/`triaged_at`/`triage_skip_reason`) 드롭
+- `POST /v1/admin/platform-issues/:id/retriage` + `/bulk-retriage` endpoint 제거
+- MCP `admin_retriage_platform_issue` 도구 제거
+
 ## [3.12.0] - 2026-05-13
 
 ### Fixed — `cb.database.batch()` / `cb.database.transaction()` silent success 회귀 (platform-issue 019e1c9c)

package/README.md

@@ -587,26 +587,41 @@ nearby.results.forEach(place => {
 
 #### Batch & Transactions
 
+`table_id` 는 항상 UUID. 콘솔/REST 로 생성한 테이블의 UUID 를 그대로 사용한다.
+
+v3.12+ 부터 server 가 부분 실패(`success: false`)를 응답하면 SDK 가 첫 실패 op 의
+error 메시지로 throw 한다 — silent success 회귀 방지 차원. 호출자는 try/catch 로 감싼다.
+
 ```typescript
 // Batch: atomic multi-table operations
-await cb.database.batch([
-  { type: 'create', table: 'orders', data: { product: 'A', qty: 1 } },
-  { type: 'update', table: 'inventory', doc_id: 'item-a', operators: {
-    qty: { type: 'increment', value: -1 }
-  }},
-  { type: 'update', table: 'stats', doc_id: 'daily', operators: {
-    order_count: { type: 'increment', value: 1 },
-    last_order: { type: 'serverTimestamp' }
-  }}
-])
+try {
+  const result = await cb.database.batch([
+    { type: 'create', table_id: ORDERS_TABLE_ID, data: { product: 'A', qty: 1 } },
+    { type: 'update', table_id: INVENTORY_TABLE_ID, doc_id: 'item-a', operators: {
+      qty: { type: 'increment', value: -1 }
+    }},
+    { type: 'update', table_id: STATS_TABLE_ID, doc_id: 'daily', operators: {
+      order_count: { type: 'increment', value: 1 },
+      last_order: { type: 'serverTimestamp' }
+    }}
+  ])
+  // result.success, result.results[i].{success, doc_id, error}
+} catch (e) {
+  // RLS 거부 / 검증 실패 / table_id 오타 등 — 전체 batch 가 atomic 하게 롤백
+  console.error('batch failed:', (e as Error).message)
+}
 
 // Transaction: read-then-write with ACID guarantees
-await cb.database.transaction(
-  [{ table: 'accounts', doc_id: 'user-1', alias: 'sender' }],
-  [{ type: 'update', table: 'accounts', doc_id: 'user-1', operators: {
-    balance: { type: 'increment', value: -100 }
-  }}]
-)
+try {
+  await cb.database.transaction(
+    [{ table_id: ACCOUNTS_TABLE_ID, doc_id: 'user-1', alias: 'sender' }],
+    [{ type: 'update', table_id: ACCOUNTS_TABLE_ID, doc_id: 'user-1', operators: {
+      balance: { type: 'increment', value: -100 }
+    }}]
+  )
+} catch (e) {
+  console.error('transaction failed:', (e as Error).message)
+}
 ```
 
 #### Populate (Relation Query / JOIN)

package/dist/index.d.mts

@@ -7546,7 +7546,7 @@ declare class SupportAPI {
      * 본인이 발행한 platform issue 의 처리 진행 상황을 단건 조회.
      *
      * AI 가 "내가 발행한 이슈 처리됐어?" 를 폴링하는 표준 경로. status / resolution_note /
-     * triage_summary / external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
+     * external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
      *
      * @throws ApiError 404 — 본인 issue 가 아니거나 존재하지 않음
      */
@@ -7572,9 +7572,9 @@ interface ReportPlatformBugRequest {
     title: string;
     /** 본문 (≤16KB, markdown) */
     body: string;
-    /** 카테고리. 기본 `other`. AI triage 가 보정. */
+    /** 카테고리. 기본 `other`. 운영자가 admin 콘솔에서 조정 가능. */
     category?: PlatformIssueCategory;
-    /** 긴급도. 기본 `medium`. AI triage 가 보정. */
+    /** 긴급도. 기본 `medium`. 운영자가 admin 콘솔에서 조정 가능. */
     severity?: PlatformIssueSeverity;
     /** AppMember 가 없는 경우 회신용 이메일. */
     reporterEmail?: string;
@@ -7618,12 +7618,11 @@ interface ReportPlatformBugResponse {
 /**
  * Platform issue 의 처리 진행 상황 (reporter 시점).
  *
- * admin-only 필드(`assignee_user_id`, internal triage signal) 는 server 가 redact.
+ * admin-only 필드(`assignee_user_id` 등) 는 server 가 redact.
  *
  * 주요 필드:
  *   - `status`           : `open` → `triaged` → `in_progress` → `resolved` | `wontfix` | `duplicate`
  *   - `resolution_note`  : 단말 상태 진입 시 ConnectBase 운영팀이 작성한 처리 결과 (markdown)
- *   - `triage_summary`   : AI triage 가 작성한 1줄 요약
  *   - `external_links`   : 운영팀이 연결한 GitHub PR / Linear ticket 등
  *   - `resolved_at`      : `resolved`/`wontfix` 진입 시각 (해결됐는지 빠른 검사용)
  */
@@ -7639,8 +7638,6 @@ interface PlatformIssueDetail {
     sdk_version?: string;
     sdk_platform?: 'web' | 'node' | 'unity' | 'godot' | 'unreal' | 'cli' | 'mcp' | 'other';
     environment?: 'production' | 'staging' | 'development' | 'unknown';
-    triage_summary?: string;
-    triaged_at?: string;
     external_links?: Array<{
         kind: string;
         url: string;

package/dist/index.d.ts

@@ -7546,7 +7546,7 @@ declare class SupportAPI {
      * 본인이 발행한 platform issue 의 처리 진행 상황을 단건 조회.
      *
      * AI 가 "내가 발행한 이슈 처리됐어?" 를 폴링하는 표준 경로. status / resolution_note /
-     * triage_summary / external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
+     * external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
      *
      * @throws ApiError 404 — 본인 issue 가 아니거나 존재하지 않음
      */
@@ -7572,9 +7572,9 @@ interface ReportPlatformBugRequest {
     title: string;
     /** 본문 (≤16KB, markdown) */
     body: string;
-    /** 카테고리. 기본 `other`. AI triage 가 보정. */
+    /** 카테고리. 기본 `other`. 운영자가 admin 콘솔에서 조정 가능. */
     category?: PlatformIssueCategory;
-    /** 긴급도. 기본 `medium`. AI triage 가 보정. */
+    /** 긴급도. 기본 `medium`. 운영자가 admin 콘솔에서 조정 가능. */
     severity?: PlatformIssueSeverity;
     /** AppMember 가 없는 경우 회신용 이메일. */
     reporterEmail?: string;
@@ -7618,12 +7618,11 @@ interface ReportPlatformBugResponse {
 /**
  * Platform issue 의 처리 진행 상황 (reporter 시점).
  *
- * admin-only 필드(`assignee_user_id`, internal triage signal) 는 server 가 redact.
+ * admin-only 필드(`assignee_user_id` 등) 는 server 가 redact.
  *
  * 주요 필드:
  *   - `status`           : `open` → `triaged` → `in_progress` → `resolved` | `wontfix` | `duplicate`
  *   - `resolution_note`  : 단말 상태 진입 시 ConnectBase 운영팀이 작성한 처리 결과 (markdown)
- *   - `triage_summary`   : AI triage 가 작성한 1줄 요약
  *   - `external_links`   : 운영팀이 연결한 GitHub PR / Linear ticket 등
  *   - `resolved_at`      : `resolved`/`wontfix` 진입 시각 (해결됐는지 빠른 검사용)
  */
@@ -7639,8 +7638,6 @@ interface PlatformIssueDetail {
     sdk_version?: string;
     sdk_platform?: 'web' | 'node' | 'unity' | 'godot' | 'unreal' | 'cli' | 'mcp' | 'other';
     environment?: 'production' | 'staging' | 'development' | 'unknown';
-    triage_summary?: string;
-    triaged_at?: string;
     external_links?: Array<{
         kind: string;
         url: string;

package/dist/index.js

@@ -9284,7 +9284,7 @@ var SupportAPI = class {
    * 본인이 발행한 platform issue 의 처리 진행 상황을 단건 조회.
    *
    * AI 가 "내가 발행한 이슈 처리됐어?" 를 폴링하는 표준 경로. status / resolution_note /
-   * triage_summary / external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
+   * external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
    *
    * @throws ApiError 404 — 본인 issue 가 아니거나 존재하지 않음
    */

package/dist/index.mjs

@@ -9242,7 +9242,7 @@ var SupportAPI = class {
    * 본인이 발행한 platform issue 의 처리 진행 상황을 단건 조회.
    *
    * AI 가 "내가 발행한 이슈 처리됐어?" 를 폴링하는 표준 경로. status / resolution_note /
-   * triage_summary / external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
+   * external_links 로 ConnectBase 운영팀의 처리 상태를 확인.
    *
    * @throws ApiError 404 — 본인 issue 가 아니거나 존재하지 않음
    */

package/package.json

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