connectbase-client 6.14.0 → 6.15.0

package/CHANGELOG.md

@@ -3,6 +3,31 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [6.15.0] - 2026-11-11
+
+### Changed — `cb.database` 실시간 연결 거부의 이유를 알린다 (`reject_mode=close`)
+
+- 브라우저는 실패한 WebSocket 핸드셰이크의 HTTP 상태를 읽지 못해, DB 실시간 연결의 거부(토큰 무효, 멤버 정지, 동시접속
+  한도, 속도 제한, URL 쿼리 자격증명 거부 등)가 이유 없는 `Connection closed during handshake` 와 재연결 반복으로만 보였다.
+  이제 `cb.database.connectRealtime()` 은 `cb.realtime` 처럼 `reject_mode=close` 로 협상하고, 서버가 보낸 이유를
+  `RealtimeConnectionError`(`code`, `message`, `closeCode` = 4000 + HTTP 상태, `retryable`, `retryAfterMs`, `details`)로
+  `connectRealtime()` 의 거부와 `onRealtimeError` 에 알린다.
+- 재시도 규칙은 `cb.realtime` 과 같다. 다시 해도 같은 거부(4401 `unauthorized`, 4403 `member_revoked` 등)는 재연결을 멈추고
+  알린다. 일시 장애, 속도 제한, 동시접속 한도(4503, 4429, 4402)는 `retryAfterMs` 보다 일찍 다시 붙지 않으면서 재연결을 이어
+  가고, 재시도를 다 쓰면 일반 오류 대신 마지막 거부를 알린다. 티켓 발급 거부도 같은 규칙이다(예전에는 429 만 다시 붙었고,
+  그때마다 `onRealtimeError` 로 알렸다).
+- 열린 것만으로는 서버가 받아들였는지 알 수 없어, 열린 직후 `ping` 을 보내 첫 응답으로 연결을 확정한다. 그래서
+  `connectRealtime()` 이 한 왕복 늦게 끝난다. 협상을 모르는 예전 서버도 `ping` 에 답하므로 예전처럼 붙는다.
+- `RealtimeConnectionError` 의 재시도 기본값: 서버가 `retryable` 을 보내지 않은 거부도 close 코드가 4429, 4500, 4503 이면
+  재시도 가능으로 본다. `rate_limit_exceeded` 를 재시도 가능한 코드에 더했다.
+
+### Removed — 플랫폼 이슈의 게임 엔진 SDK 플랫폼 값
+
+- `cb.support.reportPlatformBug({ sdkPlatform })` 와 `PlatformIssueDetail.sdk_platform` 의 타입에서 `"unity"`,
+  `"godot"`, `"unreal"` 을 뺀다. 게임 엔진 SDK 는 지원을 끝냈고, 서버도 이 값을 다른 모르는 값처럼 거부한다(400).
+  남은 값은 `"web"`, `"node"`, `"cli"`, `"mcp"`, `"other"` 다. 값을 생략하면 SDK 가 `web`/`node` 를 정하는 동작은
+  그대로다.
+
 ## [6.14.0] - 2026-11-11
 
 ### Security — WebSocket 연결 URL 에 자격증명을 싣지 않는다 (1회용 티켓)

package/README.md

@@ -1000,7 +1000,7 @@ await subscription.unsubscribe()
 await cb.realtime.disconnect()
 ```
 
-#### 로그인 멤버 연결의 토큰 갱신과 멤버 폐기 (Unreleased)
+#### 로그인 멤버 연결의 토큰 갱신과 멤버 폐기 (6.12.0 부터)
 
 `cb.realtime.connect({ accessToken })` 과 `cb.database.connectRealtime({ accessToken })` 에 넘긴 토큰이 SDK 가 로그인으로
 들고 있는 멤버 세션(같은 앱, 같은 멤버)의 것이면, SDK 가 만료 전에 HTTP 요청과 같은 refresh 로 새 토큰을 받아 **연결을 끊지
@@ -1092,6 +1092,22 @@ try {
 구버전 서버면 지수 백오프). 연결 제한 시간(`timeout`, 기본 30초) 안에 못 붙을 때만 이 에러를 던집니다. `unauthorized` 처럼
 다시 해도 소용없는 거부는 바로 던집니다.
 
+`cb.database.connectRealtime()` 도 같은 방식으로 거부 이유를 받습니다(6.15.0 부터). 예전에는 이유 없는
+`Connection closed during handshake` 였습니다.
+
+```typescript
+try {
+  await cb.database.connectRealtime({ accessToken })
+} catch (e) {
+  if (e instanceof RealtimeConnectionError) {
+    e.code        // 'unauthorized' | 'member_revoked' | 'connection_limit_exceeded' | 'rate_limit_exceeded' | 'auth_unavailable' | ...
+    e.closeCode   // 4000 + HTTP 상태 (4401, 4403, 4402, 4429, 4503)
+    e.retryable   // true 면 SDK 가 retryAfterMs 이후로 스스로 다시 붙는다
+  }
+}
+cb.database.onRealtimeError((e) => { /* 다시 붙지 않는 거부, 또는 재시도를 다 쓴 마지막 거부 */ })
+```
+
 #### Broadcast categories: publishers (v6.6.0)
 
 1명이 방송하고 많은 사람이 받는 카테고리는 콘솔에서 **방송인 역할**(`publisher_roles`)과 **발행 정책**(`send_policy`)을

package/dist/cli.js

@@ -170,7 +170,7 @@ function handleTunnelError(msg, appId, localPort) {
 }
 
 // src/cli.ts
-var VERSION = "6.14.0" ? "6.14.0" : getPackageVersion();
+var VERSION = "6.15.0" ? "6.15.0" : getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
   reset: "\x1B[0m",