connectbase-client 5.6.0 → 5.6.2

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [5.6.2] - 2026-08-01
+
+### Docs — `options.timeout` 의 실질 상한을 호출 위치별로 정정
+
+**동작 변경 없음** (JSDoc 문구만). 5.6.1 은 "터널 모델도 300초를 다 쓴다" 고만 적었는데,
+실측해 보니 제약의 위치가 달랐다. ConnectBase→터널 구간은 내부 직결이 되어 CDN 을 안 타지만,
+**외부에서 공개 API 를 부르는 구간**은 여전히 CDN 을 지난다. 비스트리밍 생성은 끝날 때까지
+한 바이트도 흐르지 않아 CDN 의 "첫 바이트까지 ~100초" 타이머에 걸린다.
+
+| 호출 위치 | 실질 상한 |
+|---|---|
+| 서버리스 함수 안 (`ctx.cb`) | 300초 전부 (197초 생성 200 OK) |
+| 외부 → 공개 API | ~100초 (200초 예산 요청이 126초에 524) |
+
+100초를 넘길 수 있는 생성은 `chatStream` 을 쓴다.
+
+## [5.6.1] - 2026-08-01
+
+### Docs — `endpoint://` 터널 모델의 실질 상한 정정
+
+**동작 변경 없음** (JSDoc 문구만). 5.6.0 은 `options.timeout` 상한을 300초로 안내하면서
+"`endpoint://` 로 연결한 자체 호스팅 모델은 앞단 CDN 때문에 ~100초가 실질 상한" 이라는
+단서를 달았다. 그 사이 백엔드가 ConnectBase→터널 구간을 클러스터 내부 직결로 바꿔
+(`TUNNEL_PROXY_UPSTREAM_URL`) CDN 을 아예 거치지 않게 됐다 — 이제 이 구성도 300초를 다 쓴다.
+낡은 단서를 그대로 두면 쓸 수 있는 예산을 스스로 낮춰 잡게 되므로 정정한다.
+
 ## [5.6.0] - 2026-08-01
 
 ### Added — `cb.ai.chat(request, options)` 의 생성 예산 (`options.timeout`)

package/dist/index.d.mts

@@ -656,6 +656,15 @@ interface AIChatOptions {
      * 300초로도 부족한 긴 생성은 `chatStream` 을 쓸 것 — 스트리밍은 총량 상한이 없고
      * 토큰이 흐르는 한 계속된다.
      *
+     * ⚠️ **어디서 부르느냐에 따라 실제 상한이 다르다** (2026-08-01 실측):
+     * - 서버리스 함수 안(`ctx.cb`): **300초 전부** 쓸 수 있다(내부 직결, CDN 없음).
+     * - 외부에서 공개 API 로 직접 호출: 앞단 CDN 이 첫 바이트까지 ~100초만 기다려
+     *   실질 상한이 **~100초**다. 비스트리밍은 끝날 때까지 한 바이트도 안 흐르므로
+     *   그 타이머에 그대로 걸리고, 초과하면 `524` 가 온다.
+     *
+     * 100초를 넘길 수 있는 생성이면 `chatStream` 을 쓸 것 — 첫 토큰이 몇 초 안에 흘러
+     * 이 제약 밖이고 총량 상한도 없다.
+     *
      * @example
      * ```ts
      * // 함수 안에서 긴 번역 배치 — 함수 timeout(300s) 안에서 4분을 준다

package/dist/index.d.ts

@@ -656,6 +656,15 @@ interface AIChatOptions {
      * 300초로도 부족한 긴 생성은 `chatStream` 을 쓸 것 — 스트리밍은 총량 상한이 없고
      * 토큰이 흐르는 한 계속된다.
      *
+     * ⚠️ **어디서 부르느냐에 따라 실제 상한이 다르다** (2026-08-01 실측):
+     * - 서버리스 함수 안(`ctx.cb`): **300초 전부** 쓸 수 있다(내부 직결, CDN 없음).
+     * - 외부에서 공개 API 로 직접 호출: 앞단 CDN 이 첫 바이트까지 ~100초만 기다려
+     *   실질 상한이 **~100초**다. 비스트리밍은 끝날 때까지 한 바이트도 안 흐르므로
+     *   그 타이머에 그대로 걸리고, 초과하면 `524` 가 온다.
+     *
+     * 100초를 넘길 수 있는 생성이면 `chatStream` 을 쓸 것 — 첫 토큰이 몇 초 안에 흘러
+     * 이 제약 밖이고 총량 상한도 없다.
+     *
      * @example
      * ```ts
      * // 함수 안에서 긴 번역 배치 — 함수 timeout(300s) 안에서 4분을 준다

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "connectbase-client",
-	"version": "5.6.0",
+	"version": "5.6.2",
 	"description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
 	"repository": {
 		"type": "git",