connectbase-client 3.35.0 → 3.35.2

package/CHANGELOG.md

@@ -3,6 +3,26 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [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 동작 변화 없음)
+
+프론트엔드 감사에서 발견된 SDK 내부 타입·안전성 개선. 공개 API 시그니처와 런타임 동작은 동일하다.
+
+- **`HttpClient.getAppId()` 공개 접근자 추가** — `database` API 의 `requireAppId()` 가 `(this.http as unknown as { config })` 로 private 필드를 침투하던 cast 를 제거하고 정식 접근자를 사용.
+- **토큰 응답 검증 가드 추가** — `signUpMember`/게스트 재발급/신규 게스트 로그인의 `setTokens` 호출 전에 `assertShape({ access_token, refresh_token, ... })` 검증을 추가(기존 `signInMember`/`getMe` 와 동일 패턴). 정상 응답은 그대로 동작하며, 서버가 잘못된 토큰 응답을 줄 때만 조용히 잘못된 토큰을 저장하지 않고 throw 한다.
+- **타입 안전성** — analytics 의 `(window as any)`/`(navigator as any)` 를 좁은 인터페이스(`VisitorTrackerBridge`/`NavigatorWithGPC`)로 교체. 런타임 동작 무변화.
+
 ## [3.35.0] - 2026-06-17
 
 ### Fixed — doc-audit 발견 SDK/서버 계약 버그 (퍼블리시 전엔 미동작이던 기능 정상화)

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 |