connectbase-client 3.10.0 → 3.12.0

package/CHANGELOG.md

@@ -3,6 +3,102 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.12.0] - 2026-05-13
+
+### Fixed — `cb.database.batch()` / `cb.database.transaction()` silent success 회귀 (platform-issue 019e1c9c)
+
+서버가 `success: false` + 개별 op `error` 로 부분 실패를 표현해도 SDK 가 그냥 Promise 를 resolve 해
+호출자가 "성공" 으로 오해하던 문제 수정. 이제 첫 실패 op 의 error 메시지로 `throw`.
+
+```typescript
+try {
+  await cb.database.batch([{
+    type: 'update',
+    table_id: '019d86bf-...',
+    doc_id: '019de33a-...',
+    operators: { like_count: { type: 'increment', value: 1 } },
+  }])
+} catch (e) {
+  // 이제 RLS 거부, table_id 오타, 검증 실패 등이 명확히 throw 됨
+  console.error(e.message)
+}
+```
+
+### Added — `BatchWriteResult` / `TransactionResult` / `BatchOperationResult` / `TransactionWriteResult` 타입 export
+
+batch/transaction 응답이 `{ results: Record<string, unknown>[] }` 에서 정형 타입으로 변경:
+
+```typescript
+import type { BatchWriteResult, BatchOperationResult } from 'connectbase-client'
+
+const r: BatchWriteResult = await cb.database.batch(ops)
+// r.success: boolean
+// r.results[i]: { index, success, doc_id?, error? }
+// r.total_count / success_count / failed_count
+```
+
+### Behavior change — batch/transaction 부분 실패가 더 이상 silent 통과되지 않음
+
+이전: `success: false` 응답도 `await cb.database.batch(...)` 가 정상 resolve → 호출자가 매번
+`response.success` 와 `response.results[i].success` 를 직접 확인해야 했음.
+
+본 버전부터: `success: false` 면 즉시 `throw new Error(<첫 실패 op error>)`. 부분 실패를
+silent 처리하던 코드가 있다면 try/catch 로 감싸야 한다.
+
+### Backend wiring (참고)
+
+본 fix 는 data-server 의 다음 변경과 짝을 이룬다 (별도 배포 필요):
+- `transaction_service` 의 3 callsite (executeRead / RunTransaction commit / BatchWrite) 가
+  `table_id` (UUID) 를 title 로 잘못 lookup → 항상 "ent: table not found" 회귀를 함께 수정
+  (platform-issue 019e1c9c/eba6).
+- batch/transaction 이 RLS 평가를 통째로 건너뛰던 보안 회귀 수정. operators 가 머지된 finalData
+  를 newData 로 RLS 에 전달해 `.update` predicate 가 실제 변경 결과 기준으로 평가됨
+  (platform-issue 019e1c9c/c155).
+
+## [3.11.0] - 2026-05-10
+
+### Fixed — `cb.game.createClient().createRoom()` 의 `scriptName` / 기타 wire 필드 매핑 (platform-issue 019e123a)
+
+게임 룸 생성 시 SDK 의 camelCase config (`scriptName`, `tickRate`, `maxPlayers`, `roomId`,
+`categoryId`) 가 게임 서버 (Go 핸들러 JSON 태그 = snake_case) 가 기대하는 와이어 형식으로
+매핑되지 않아, **`scriptName` 미전달 → `RoomConfig.ScriptID` 비어 있음 → `onTick` /
+`onPlayerJoin` 등 모든 사용자 Lua hook 이 silent skip** 되던 문제 수정. NJB 앱 보고로 확인.
+
+### Added — `GameRoomConfig.scriptName`
+
+```typescript
+const room = cb.game.createClient({ clientId: 'p1' })
+await room.connect()
+await room.createRoom({
+  tickRate: 20,
+  maxPlayers: 100,
+  scriptName: 'njb-main', // ← 콘솔/REST 로 업로드+활성화한 Lua 스크립트 이름
+})
+```
+
+지정 시 룸의 `onRoomCreate` / `onPlayerJoin` / `onTick` / `onAction` / `onLeave` 가 해당
+스크립트로 디스패치된다. 미지정 시 server tick + delta 만 흐르고 사용자 hook 은 호출되지 않음.
+
+### Added — `toCreateRoomWire(config)` 헬퍼 export
+
+테스트/디버깅 용으로 `import { toCreateRoomWire } from 'connectbase-client'`. SDK 가 내부적으로
+`create_room` WebSocket 메시지 생성 시 사용하는 매핑 함수.
+
+### Behavior change — `tickRate` / `maxPlayers` 등이 이제 실제로 적용됨
+
+이전 버전은 camelCase 그대로 와이어로 보냈으나 게임 서버가 snake_case 만 인식해 모든 룸이
+**서버 기본값 (tick_rate=64, max_players=100)** 으로 생성됐다. 본 버전부터 SDK 가 명시한 값이
+실제로 반영된다. 이전 동작에 의존한 코드가 있다면 명시 값을 검토할 것.
+
+### Backend wiring (참고)
+
+본 fix 는 game-server 의 다음 변경과 짝을 이룬다 (별도 배포 필요):
+- `CreateRoomRequest` 에 `script_name` (+ `script` alias) 필드 추가, `handleCreateRoom` 이
+  `RoomConfig.ScriptID = appID:scriptName` 으로 매핑
+- 신규 `scripts.Loader` — 게임 서버 부팅 시 활성 스크립트 일괄 로드 + `game.scripts.reload.>`
+  NATS 구독으로 Activate/Rollback/Disable 이벤트를 ScriptEngine 에 반영. legacy `HotReloader`
+  는 다른 subject/schema 라 미사용 코드였음 (이번에 발견된 누락)
+
 ## [3.10.0] - 2026-05-10
 
 ### Fixed — `/v1/auth/re-issue` 일시 실패에 강제 로그아웃 (platform-issue 019e11cf)

package/README.md

@@ -321,8 +321,11 @@ Create a new game room.
 const state = await gameClient.createRoom({
   roomId: 'my-custom-room',        // Optional: Custom room ID
   categoryId: 'battle-royale',     // Optional: Room category
-  maxPlayers: 100,                 // Optional: Max players (default: 10)
+  maxPlayers: 100,                 // Optional: Max players (default: 100)
   tickRate: 64,                    // Optional: Server tick rate (default: 64)
+  scriptName: 'main',              // Optional (3.11.0+): Lua script attached to the room
+                                   // (uploaded+activated via console or POST /v1/game/:appID/scripts).
+                                   // Required for onTick / onPlayerJoin / onAction etc. to fire.
   metadata: { map: 'forest' }      // Optional: Custom metadata
 })
 ```