connectbase-client 3.3.0 → 3.4.0

package/CHANGELOG.md

@@ -3,6 +3,19 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.3.1] - 2026-04-30
+
+### Fixed — Docs
+
+3.3.0 publish 직후 SDK 감사에서 `README.md` 의 `### Game Server` 섹션에 신규 API
+`cb.game.config` 가 누락된 것을 발견. npm 페이지의 사용자 1차 문서 정합성을 위해
+patch release 로 보강.
+
+- README 의 `## API Reference > ### Game Server` 아래에 `#### cb.game.config — Feature
+  Opt-in (v3.1+, SDK 3.3.0+)` 섹션 추가 — get/set/enable/disable 4개 메서드 시그니처,
+  partial PATCH 의미, HTTP 응답 코드 표 (403 / 429 / 402), OPT_IN.md cross-link.
+- 코드 동작 변화 없음. README/CHANGELOG 만 수정.
+
 ## [3.3.0] - 2026-04-30
 
 ### Added — `cb.game.config` (게임 기능 opt-in 토글)

package/README.md

@@ -229,6 +229,43 @@ curl -X PUT "https://api.connectbase.world/v1/apps/{appID}/storages/webs/{storag
 
 ### Game Server
 
+#### `cb.game.config` — Feature Opt-in (v3.1+, SDK 3.3.0+)
+
+The game server's 7 features (`matchqueue` / `leaderboard` / `entity` / `scripts` /
+`voice` / `replay` / `spectator`) are **explicit opt-in per app** as of v3.1
+(2026-04-30). Disabled features return HTTP **403 `feature_disabled`**.
+New apps default to all-OFF; existing apps without a config row fall back to
+all-ON for compatibility.
+
+```typescript
+// Inspect current toggles
+const cfg = await cb.game.config.get(appId)
+// → { matchqueue_enabled, leaderboard_enabled, entity_enabled, scripts_enabled,
+//     voice_enabled, replay_enabled, spectator_enabled }
+
+// Partial update — only the keys you send are applied; others are preserved.
+await cb.game.config.set(appId, {
+  matchqueue_enabled: true,
+  leaderboard_enabled: true,
+})
+
+// Single-toggle convenience wrappers
+await cb.game.config.enable(appId, 'matchqueue_enabled')
+await cb.game.config.disable(appId, 'voice_enabled')
+```
+
+The PATCH publishes a NATS invalidation so game-server caches drop the entry
+immediately (30s TTL is the safety net).
+
+| HTTP code | Body `error` | Meaning | Client action |
+|-----------|--------------|---------|---------------|
+| **403** | `feature_disabled` | Feature is not enabled for this app | Toggle via console or `cb.game.config.set(...)` |
+| **429** | `cap_exceeded` | Per-app cardinality cap reached | Remove old rows or ask the operator to raise the cap env |
+| **402** | `quota_exceeded` | Plan limit reached on a write route | Upgrade plan |
+
+See [docs/game-server/OPT_IN.md](https://github.com/connectbase-world/connectbase/blob/release/docs/game-server/OPT_IN.md)
+for the full policy.
+
 #### GameRoom
 
 The main class for real-time game communication.