connectbase-client 3.14.0 → 3.14.2

package/CHANGELOG.md

@@ -3,6 +3,62 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.14.2] - 2026-05-14
+
+### Fixed — `cb.game.createClient()` appId 누락 시 silent 연결 깨짐
+
+NJB 측 `createRoom` → `SCRIPT_NOT_FOUND` 오탐 보고 (019e2210) 로 발견. `appId` 가
+`new ConnectBase({ appId })` 에 설정되지 않은 상태에서 `cb.game.createClient()` 를 쓰면
+`GameRoom.buildConnectionUrl` 이 `wss://.../v1/game//ws` (빈 path 세그먼트) 를 만들어
+game-server 의 `conn.appID` 가 빈 문자열로 들어갔다. 그 결과 `createRoom` 의 스크립트
+검증이 `GetMeta("", name)` → `nats: invalid key` 로 실패해 실제로 존재하는 active
+스크립트가 `SCRIPT_NOT_FOUND` 로 오탐. HTTP 스크립트 메서드 (`uploadScript(appId, ...)`)
+는 appId 가 명시적 인자라 영향 없었고, WS 클라이언트만 전역 appId 에 의존해 깨졌음.
+
+- `GameRoom.connect()` — `appId` 가 비어 있으면 빈 URL 로 붙는 대신 명확한 에러로 즉시
+  reject (`appId is required to connect ...`). `buildConnectionUrl` 에도 hard invariant
+  가드 추가 — `/v1/game//ws` 는 더 이상 생성되지 않는다.
+- `GameAPI.createClient({ appId })` — per-call `appId` 지정을 지원. 이전엔 `this.appId`
+  (전역) 가 `config.appId` 를 무조건 덮어써서 호출별 지정이 불가능했다. 이제
+  `config.appId ?? this.appId` 로 per-call 우선.
+
+> game-server 측에도 defense-in-depth 보정 동반 — `public_key` / `token` 으로 인증된
+> WS 연결은 auth 가 resolve 한 appID 를 authoritative 로 사용 (URL path 의 빈 `:appID`
+> 무시). 유효한 publicKey 를 보내는 클라이언트는 SDK 업그레이드 없이도 자동 교정된다.
+
+### Added — 회귀 가드 테스트
+
+- `test/game-connect-appid.test.ts` — appId 누락 시 `connect()` reject + WS 미생성,
+  `createClient({ appId })` per-call override, `/v1/game//ws` 절대 미생성 단언.
+
+## [3.14.1] - 2026-05-14
+
+### Fixed — `cb.game.*` primitive 호스트 라우팅 회귀 (v3.0.0 이후 잠복)
+
+NJB 측 deleteScript / deactivateScript 404 보고 (2026-05-14) 로 발견. v3.0.0 BREAKING 에서
+matchqueue / leaderboard / scripts primitive 메서드 16개가 `this.http.*` (기본 baseUrl
+= core-server, `api.connectbase.world`) 를 거치도록 잘못 wired 되어 game-server
+(`game.connectbase.world`) 로 라우팅되지 않고 404 회귀. NJB 는 v3.9.0 부터 `uploadScript`
+회귀를 raw fetch 로 우회 중이었음 (apps/game/scripts/upload-lua.mjs 참고).
+
+수정: `GameAPI` 내부 `gameFetch` private helper 도입. `${this.gameServerUrl}${path}` 기준
+fetch + 표준 `getHeaders()` (X-Public-Key / Bearer) + 서버 응답 `{ error }` → `ApiError.code`
+surface + 204/non-JSON 응답을 `undefined` 로 처리. 영향받은 메서드:
+
+- **scripts (8)**: `uploadScript` / `listScripts` / `getScript` / `listScriptVersions` /
+  `activateScript` / `rollbackScript` / `deactivateScript` / `deleteScript`
+- **matchqueue (3)**: `enqueueMatch` / `listMatchqueue` / `cancelMatch`
+- **leaderboard (6)**: `submitScore` / `getTopScores` / `getMemberRank` /
+  `getRankAround` / `resetLeaderboard` / `removeFromLeaderboard`
+
+기존에 raw fetch 로 우회 중이던 통합 코드는 SDK 본 메서드로 회귀해도 무방 (4xx/5xx 시
+`ApiError` 로 throw 되며 status/code 분기는 동일하게 작동).
+
+### Added — 회귀 가드 테스트
+
+- `test/game-host-routing.test.ts` — 17개 메서드 전체가 `game.*` 호스트로 라우팅되는지
+  fetch mock 으로 단언. 동일 회귀 재발 방지.
+
 ## [3.14.0] - 2026-05-14
 
 ### Added — `GameError` 클래스 + `createRoom` 응답 메타