connectbase-client 6.7.0 → 6.8.0

package/CHANGELOG.md

@@ -3,6 +3,36 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [6.8.0] - 2026-10-23
+
+### Added — 서버 코드에서 토픽 만들기: `cb.push.createTopic(appId, name, options?)`
+
+방마다 쓰는 토픽(`cc_<room>` 같은)을 서버 코드가 만들어 두고, 기기는 그 뒤에 `subscribeTopic` 으로 구독합니다. 같은
+이름의 토픽이 이미 있으면 오류 없이 그 토픽을 돌려줍니다(설정은 바꾸지 않습니다) — 트리거가 다시 실행돼도 안전합니다.
+공개 키(cb_pk_) 단독 인스턴스로는 호출할 수 없고, 함수의 `ctx.cbAdmin` 은 management_scopes 에 `push:write` 가 있어야
+합니다(platform-issue 01a167dd). 함수는 배포할 때 이 SDK 의 최신 판을 설치하므로, 쓰려면 함수를 다시 배포하세요.
+
+```ts
+// concerts 트리거 함수
+await ctx.cbAdmin.push.createTopic(appId, `cc_${row.room}`, { displayName: row.title })
+```
+
+### Fixed — 웹 푸시 기기의 토픽 구독과 등록 해제
+
+`registerWebPush` 로 등록한 브라우저 기기를 `subscribeTopic` / `unsubscribeTopic` 으로 구독시키지 못했고,
+`unregisterWebPush` 도 실패했습니다. 웹 푸시 기기의 `device_token` 은 endpoint URL(`https://…/send/…`, 슬래시 포함)인데
+SDK 가 그 값을 요청 경로에 넣어 서버 라우트가 맞지 않았습니다(인코딩해도 서버 라우팅 전에 풀립니다). 이제 기기 토큰은
+요청 본문으로 보냅니다(`POST /v1/public/push/topics/subscribe`, `/topics/unsubscribe`, `/devices/unregister`) — 네이티브
+(FCM, APNs) 기기도 같은 방법으로 동작하며, 호출 방법은 그대로입니다(platform-issue 01a167dd).
+
+```ts
+const device = await cb.push.registerWebPush(subscription)
+await cb.push.subscribeTopic(device.device_token, 'announcements') // 토픽은 콘솔에서 미리 만든다
+```
+
+이 판은 위 엔드포인트가 있는 서버(2026-10-23 배포)가 필요합니다. 예전 판(경로에 토큰)도 네이티브 기기에서는 계속
+동작합니다.
+
 ## [6.7.0] - 2026-10-22
 
 ### Added — 서버가 검증한 보낸 사람: `message.fromMember`

package/README.md

@@ -1108,7 +1108,7 @@ try {
 ```
 
 방송인 여부는 구독할 때 정해집니다. 멤버 역할이나 카테고리 설정을 바꾸면 다시 구독(또는 재연결)할 때 반영되고,
-카테고리 설정은 서버 캐시 때문에 최대 5분 뒤에 반영됩니다. room 채널(v6.7.0)은 room 인가 함수가 `publisher: true` 로
+카테고리 설정은 저장하면 몇 초 안에 서버 전체에 퍼집니다. room 채널(v6.7.0)은 room 인가 함수가 `publisher: true` 로
 room 마다 방송인을 정할 수도 있습니다(위 "Rooms").
 
 #### Presence / Typing
@@ -1431,7 +1431,17 @@ const subscription = await registration.pushManager.subscribe({
   userVisibleOnly: true,
   applicationServerKey: vapidKey.public_key
 })
-await cb.push.registerWebPush(subscription)
+const webDevice = await cb.push.registerWebPush(subscription)
+// Browser devices subscribe the same way (v6.8.0+: device_token is the endpoint URL)
+await cb.push.subscribeTopic(webDevice.device_token, 'news')
+```
+
+Topics must exist before devices subscribe; subscribing to an unknown topic fails with 404. Create them in the console,
+or from server code (v6.8.0+, not available to public-key-only instances):
+
+```typescript
+// e.g. in a database trigger function: one topic per room, safe to call again (returns the existing topic)
+await ctx.cbAdmin.push.createTopic(ctx.appId, `cc_${room}`, { displayName: title })
 ```
 
 ### WebRTC

package/dist/cli.js

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