connectbase-client 3.34.0 → 3.35.0

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.35.0] - 2026-06-17
+
+### Fixed — doc-audit 발견 SDK/서버 계약 버그 (퍼블리시 전엔 미동작이던 기능 정상화)
+
+3-way 문서 정합성 감사 중 발견된 SDK↔서버 계약 불일치를 코드 기준으로 정렬.
+
+- **video 업로드 전면 정상화** — SDK↔서버 계약 불일치로 업로드가 동작하지 않던 것을 수정.
+  - **Breaking (타입)**: `InitUploadResponse` 가 `{ session_id, video_id, ... }` → **`{ upload_id, chunk_size, total_chunks, expires_at }`** (서버 실제 응답).
+  - 청크 업로드는 `PUT .../uploads/:uploadId/chunk?chunk_index=N`, 완료 응답 `{ video_id, status }` → `get(video_id)` 로 전체 Video 조회.
+  - `getThumbnails()` 를 서버 단일 thumbnail 엔드포인트(`/thumbnail`)에 정합.
+- **WebRTC 응답 타입 정합** — `getStats()`/`getRooms()` 타입이 서버 wire shape 와 달랐음.
+  - **Breaking (타입)**: `AppStatsResponse` = `{ room_count, total_peers, total_broadcasters, total_viewers, channel_stats }`; rooms 는 `{ rooms: RoomSummary[] }` (`RoomStats` 제거, `ChannelStats`/`RoomSummary` 추가).
+- **`subscription.cancel()`** — `immediate` 옵션이 서버에 전달되지 않던 것을 `cancel_at_end` 로 매핑. 인자 없이 호출 시 기본 = 현재 결제 주기 종료 시 해지.
+- **`game.getRoom()`** — 서버 `{ room: ... }` 래핑을 언랩하지 않아 `undefined` 를 반환하던 것 수정.
+- **HTTP `PUT`** — `FormData` 본문일 때 `Content-Type` 을 제거하지 않아 storage video 프록시 청크 업로드가 깨지던 것 수정.
+- analytics JSDoc 예제의 존재하지 않는 `track()` → `trackEvent()` 정정.
+
+> 모두 pre-launch(사용자 0) 단계 수정으로 실사용 호환성 파괴는 없습니다. video/WebRTC 타입 Breaking 은 직전까지 해당 기능이 end-to-end 로 동작한 적이 없습니다.
+
 ## [3.34.0] - 2026-06-15
 
 ### Changed — `geoQuery` 계약 표준화 (이전엔 백엔드와 형식이 달라 동작하지 않던 기능)

package/README.md

@@ -1282,17 +1282,20 @@ cb.webrtc.disconnect()
 ### Payments & Subscriptions
 
 ```typescript
-// Create a subscription
+// Create a subscription (정기 결제)
 const subscription = await cb.subscription.create({
-  planId: 'premium-monthly',
-  billingKeyId: 'billing-key-1'
+  billing_key_id: 'billing-key-1',
+  plan_name: 'premium-monthly',
+  amount: 9900,
+  billing_cycle: 'monthly'
 })
 
-// Check subscription status
-const status = await cb.subscription.getStatus()
+// Check subscription status (단건 조회)
+const detail = await cb.subscription.get(subscription.id)
+console.log(detail.status)
 
-// Cancel subscription
-await cb.subscription.cancel()
+// Cancel subscription (기본: 현재 결제 주기 종료 시 해지)
+await cb.subscription.cancel(subscription.id)
 ```
 
 ### Support (End-user Issue Reporting)