connectbase-client 3.35.1 → 3.36.0

package/CHANGELOG.md

@@ -3,6 +3,35 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.36.0] - 2026-06-24
+
+### Added — Functions 에서 시크릿 키 없이 푸시 발송 (service_role / act-as-member)
+
+서버사이드 함수가 별도 시크릿 키(`cb_sk_`) 발급 없이 `ctx.cbAdmin`(service_role) 또는
+`ctx.cb`(act-as-member)로 푸시를 보낼 수 있도록 `push.sendToMembers` 의 호출 가드를 완화했다.
+백엔드 dual-auth(`POST /v1/apps/:appID/push/send`)가 service_role 토큰을 받도록 함께 확장됐다.
+
+- **`push.sendToMembers` 위임 Bearer 허용** — 기존 가드 `if (hasPublicKey()) throw` 는
+  `cbWithToken`(ctx.cbAdmin/ctx.cb) 클라이언트가 앱 식별용 `cb_pk_` 를 함께 보내는 탓에
+  위임 호출까지 차단했다. 가드를 **`hasPublicKey() && !hasJWT()`** 로 변경해, 순수 브라우저
+  (Public Key 단독) 인스턴스만 차단하고 위임 Bearer 토큰을 가진 인스턴스는 통과시킨다.
+  공개 API 시그니처·타입 표면은 동일하다.
+
+```ts
+// service_role: true 함수에서 — 시크릿 키 불필요
+await ctx.cbAdmin.push.sendToMembers(ctx.appId, [memberId], { title, body, data })
+```
+
+## [3.35.2] - 2026-06-22
+
+### Changed — 문서·타입 폴리시 (런타임 동작 변화 없음)
+
+SDK 감사에서 발견된 문서·타입 정합성 개선. 공개 API 의 런타임 동작은 동일하다.
+
+- **README AI Streaming 멀티프로바이더 정정** — "Gemini 전용" 프레이밍을 제거하고 실제 지원 프로바이더 6종(`gemini` / `openai` / `claude` / `ollama` / `lm_studio` / `openai_compatible`)을 반영. Stream Options 표의 `provider` 타입을 전체 union 으로 교체하고, `provider`/`model`/`temperature` 의 기본값은 SDK 가 강제하지 않고 서버측 앱 AI 설정에서 결정됨을 명시. 누락돼 있던 `mcpGroup` 옵션도 표에 추가.
+- **`endpoint.pollUntil` predicate 타입 강화 (타입 전용)** — predicate 파라미터를 `(body: any, ...)` → **`(body: unknown, ...)`** 로 변경. 공개 표면에 남아 있던 유일한 `any` 를 제거하고 호출자에게 응답 narrowing 을 강제한다. 런타임 동작은 동일하며, JSDoc 예제도 `unknown` narrowing 방식으로 갱신.
+- **JSDoc 정정** — `recent-calls.ts` 의 breadcrumb 저장 정책 주석이 "쿼리 키 선별 redact" 라 적혀 있었으나 실제 구현은 쿼리스트링을 통째로 strip(더 안전)하므로 주석을 구현에 맞게 정정. `http.ts` 의 stale 참조 `client.support.getRecentCalls()` → `client.support.getRecentApiCalls()` 정정.
+
 ## [3.35.1] - 2026-06-19
 
 ### Changed — 내부 하드닝 (공개 API 동작 변화 없음)

package/README.md

@@ -113,7 +113,7 @@ try {
 - **Push Notifications**: Cross-platform push notification support
 - **WebRTC**: Real-time audio/video communication
 - **Payments**: Subscription and one-time payment support
-- **AI Streaming**: Real-time AI text generation via WebSocket (Gemini)
+- **AI Streaming**: Real-time AI text generation via WebSocket (multi-provider: Gemini, OpenAI, Claude, Ollama, LM Studio, OpenAI-compatible)
 - **Knowledge Base (RAG)**: Document indexing + BM25 search with nori 한국어 형태소. PDF / DOCX / text file upload via `addDocumentFromFile`
 - **Endpoint**: Call your own GPU models on your own PC through one `cb_pk_*` key — ConnectBase forwards the payload as-is (dumb pipe)
 - **Support**: End-user feedback/issue reporting — users send issues to app operators, AI auto-classifies summary/urgency/category
@@ -959,7 +959,10 @@ const unsubTyping = await cb.realtime.onTypingChange('room-id', (typing) => {
 
 #### AI Streaming
 
-Real-time AI text generation using Gemini API through WebSocket.
+Real-time AI text generation through WebSocket. The provider and model are
+resolved from your app's AI config on the server; you can optionally override
+them per request (`provider` / `model`). Supported providers: Gemini, OpenAI,
+Claude, Ollama, LM Studio, and any OpenAI-compatible endpoint.
 
 ```typescript
 // Connect first
@@ -987,9 +990,11 @@ const session = await cb.realtime.stream(
     }
   },
   {
-    model: 'gemini-2.0-flash',  // Optional: default is gemini-2.0-flash
-    temperature: 0.7,           // Optional: 0.0-2.0, default 0.7
-    maxTokens: 1000             // Optional: max output tokens
+    // All fields optional. When omitted, the server uses your app's AI config.
+    provider: 'openai',  // Optional: override the app's configured provider
+    model: 'gpt-4o',     // Optional: override the app's configured model
+    temperature: 0.7,    // Optional: 0.0-2.0
+    maxTokens: 1000      // Optional: max output tokens
   }
 )
 
@@ -997,16 +1002,17 @@ const session = await cb.realtime.stream(
 await session.stop()
 ```
 
-**Stream Options:**
+**Stream Options:** (all optional — defaults are resolved server-side from your app's AI config, not by the SDK)
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
-| `provider` | `'gemini'` | `'gemini'` | AI provider |
-| `model` | `string` | `'gemini-2.0-flash'` | Model name |
+| `provider` | `'gemini' \| 'openai' \| 'claude' \| 'ollama' \| 'lm_studio' \| 'openai_compatible'` | app config | Override the app's configured AI provider |
+| `model` | `string` | app config | Override the app's configured model |
 | `system` | `string` | - | System prompt |
-| `temperature` | `number` | `0.7` | Creativity (0.0-2.0) |
+| `temperature` | `number` | app config | Creativity (0.0-2.0) |
 | `maxTokens` | `number` | - | Max output tokens |
 | `sessionId` | `string` | auto | Session tracking ID |
 | `metadata` | `object` | - | Custom metadata |
+| `mcpGroup` | `string` | - | MCP group slug — enables AI Agent mode (registered MCP server tools) |
 
 **Stream Result (onDone):**
 | Field | Type | Description |