connectbase-client 5.11.0 → 5.12.1

package/dist/index.d.mts

@@ -442,6 +442,17 @@ declare class HttpClient {
      * 일은 없어야 한다.
      */
     private learnDirectOrigin;
+    /**
+     * SDK 인증 헤더를 **주입하지 않는** raw fetch. 저지연 원본 선택과 폴백만 얹는다.
+     *
+     * `cb.endpoint.call()`(`/v1/proxy/*`) 전용이다. 그 경로는 dumb pipe 라 요청 헤더가
+     * 사용자 PC 의 모델 서버로 그대로 전달된다 — `prepareHeaders()` 를 태우면 SDK 의
+     * `Authorization` 이 남의 서버로 나가고, 호출자가 자기 모델 서버용으로 설정한
+     * `Authorization` 을 덮어쓴다. 그래서 fetchRaw 를 재사용하지 않는다.
+     *
+     * @param path `/v1/proxy/...` 형태의 절대 경로 (origin 없이)
+     */
+    fetchPassthrough(path: string, init: RequestInit): Promise<Response>;
     private tryFetchOnce;
     get<T>(url: string, config?: RequestConfig): Promise<T>;
     post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<T>;
@@ -3146,6 +3157,8 @@ declare class EndpointAPI {
      * @param init - fetch() 의 RequestInit + path. path 는 사용자 모델 서버의 엔드포인트 경로 (예: "/prompt", "/v1/chat/completions").
      */
     call(label: string, init: EndpointCallInit): Promise<Response>;
+    /** `/v1/proxy/<label><path>` 절대 경로(origin 없이). URL 조립 규칙의 단일 출처. */
+    private proxyPath;
     /**
      * 라벨 + path 의 최종 호출 URL `${baseUrl}/v1/proxy/${label}${path}` 을 조립해서
      * 반환. URL 을 다른 시스템 (Service Worker, 백엔드 워커, 로깅) 에 넘기거나

package/dist/index.d.ts

@@ -442,6 +442,17 @@ declare class HttpClient {
      * 일은 없어야 한다.
      */
     private learnDirectOrigin;
+    /**
+     * SDK 인증 헤더를 **주입하지 않는** raw fetch. 저지연 원본 선택과 폴백만 얹는다.
+     *
+     * `cb.endpoint.call()`(`/v1/proxy/*`) 전용이다. 그 경로는 dumb pipe 라 요청 헤더가
+     * 사용자 PC 의 모델 서버로 그대로 전달된다 — `prepareHeaders()` 를 태우면 SDK 의
+     * `Authorization` 이 남의 서버로 나가고, 호출자가 자기 모델 서버용으로 설정한
+     * `Authorization` 을 덮어쓴다. 그래서 fetchRaw 를 재사용하지 않는다.
+     *
+     * @param path `/v1/proxy/...` 형태의 절대 경로 (origin 없이)
+     */
+    fetchPassthrough(path: string, init: RequestInit): Promise<Response>;
     private tryFetchOnce;
     get<T>(url: string, config?: RequestConfig): Promise<T>;
     post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<T>;
@@ -3146,6 +3157,8 @@ declare class EndpointAPI {
      * @param init - fetch() 의 RequestInit + path. path 는 사용자 모델 서버의 엔드포인트 경로 (예: "/prompt", "/v1/chat/completions").
      */
     call(label: string, init: EndpointCallInit): Promise<Response>;
+    /** `/v1/proxy/<label><path>` 절대 경로(origin 없이). URL 조립 규칙의 단일 출처. */
+    private proxyPath;
     /**
      * 라벨 + path 의 최종 호출 URL `${baseUrl}/v1/proxy/${label}${path}` 을 조립해서
      * 반환. URL 을 다른 시스템 (Service Worker, 백엔드 워커, 로깅) 에 넘기거나

package/dist/index.js

@@ -3121,7 +3121,7 @@ var EndpointAPI = class {
         `EndpointAPI.call: path must start with '/', got ${JSON.stringify(init.path)}`
       );
     }
-    const url = this.url(label, init.path);
+    const path = this.proxyPath(label, init.path);
     const headers = new Headers(init.headers ?? {});
     if (!headers.has("X-Public-Key")) {
       const pk = this.http.getPublicKey();
@@ -3132,7 +3132,7 @@ var EndpointAPI = class {
       }
       headers.set("X-Public-Key", pk);
     }
-    return fetch(url, {
+    return this.http.fetchPassthrough(path, {
       method: init.method ?? "GET",
       headers,
       body: init.body,
@@ -3141,6 +3141,16 @@ var EndpointAPI = class {
       redirect: "follow"
     });
   }
+  /** `/v1/proxy/<label><path>` 절대 경로(origin 없이). URL 조립 규칙의 단일 출처. */
+  proxyPath(label, path) {
+    if (!label) throw new Error("EndpointAPI.call: label required");
+    if (!path || !path.startsWith("/")) {
+      throw new Error(
+        `EndpointAPI.call: path must start with '/', got ${JSON.stringify(path)}`
+      );
+    }
+    return `/v1/proxy/${encodeURIComponent(label)}${path}`;
+  }
   /**
    * 라벨 + path 의 최종 호출 URL `${baseUrl}/v1/proxy/${label}${path}` 을 조립해서
    * 반환. URL 을 다른 시스템 (Service Worker, 백엔드 워커, 로깅) 에 넘기거나
@@ -7295,6 +7305,7 @@ var RealtimeAPI = class {
    * (degraded) AI stream() 이 SSE 로 동작하게 한다. 백그라운드 WS 재연결 머신은 정지한다.
    */
   activateSseFallback(cause) {
+    if (this.sseFallbackActive) return;
     if (this.ws) {
       try {
         this.ws.close();
@@ -7302,14 +7313,20 @@ var RealtimeAPI = class {
       }
       this.ws = null;
     }
+    const causeMsg = cause instanceof Error ? cause.message : String(cause);
     this.sseFallbackActive = true;
     this.activeTransport = "sse";
     this.state = "connected";
     this.retryCount = 0;
     this.log(
-      `WS unavailable (${cause instanceof Error ? cause.message : String(cause)}); using SSE fallback transport for AI streaming`
+      `WS unavailable (${causeMsg}); using SSE fallback transport for AI streaming`
     );
     this.notifyStateChange();
+    this.notifyError(
+      new Error(
+        `Realtime WebSocket unavailable, downgraded to SSE fallback transport (cb.realtime.transport === 'sse'). Only realtime.stream() works in this mode \u2014 subscribe/send/setPresence/typing calls will throw. Cause: ${causeMsg}`
+      )
+    );
   }
   /**
    * 연결 해제
@@ -11449,7 +11466,7 @@ function fetchCredentialsForPath(url) {
   if (COOKIE_BEARING_PUBLIC_PATHS.has(path)) {
     return "include";
   }
-  return path.startsWith("/v1/public/") ? "omit" : "include";
+  return path.startsWith("/v1/public/") || path.startsWith("/v1/proxy/") ? "omit" : "include";
 }
 var TOKEN_STORAGE_KEY = "cb_auth_tokens";
 function gatewayCodeFromStatus(status) {
@@ -11648,7 +11665,7 @@ var HttpClient = class {
     if (this.persistence !== "none") return;
     if (!this.config.refreshToken) return;
     try {
-      await this.refreshAccessToken();
+      await this.refreshAccessToken({ silent: true });
     } catch {
     }
   }
@@ -11781,7 +11798,8 @@ var HttpClient = class {
   getAppId() {
     return this.config.appId;
   }
-  async refreshAccessToken() {
+  async refreshAccessToken(options) {
+    const silent = options?.silent ?? false;
     if (this.isRefreshing) {
       return this.refreshPromise;
     }
@@ -11895,27 +11913,35 @@ var HttpClient = class {
         );
         this.refreshLockedUntil = Date.now() + backoffMs;
         if (failureKind === "permanent") {
-          this.clearTokens();
-          this.config.onTokenExpired?.();
+          if (!silent) {
+            this.clearTokens();
+            this.config.onTokenExpired?.();
+          }
           const error2 = new AuthError(`${baseMsg}. Please login again.`);
-          this.emitError(error2);
-          this.config.onAuthError?.(error2);
+          if (!silent) {
+            this.emitError(error2);
+            this.config.onAuthError?.(error2);
+          }
           throw error2;
         }
         if (failureKind === "client_bug") {
           const error2 = new AuthError(
             `${baseMsg}. Client request invalid; tokens preserved.`
           );
-          this.emitError(error2);
-          this.config.onAuthError?.(error2);
+          if (!silent) {
+            this.emitError(error2);
+            this.config.onAuthError?.(error2);
+          }
           throw error2;
         }
         const error = new AuthError(
           `${baseMsg}. Transient failure; tokens preserved, will retry after backoff.`
         );
-        this.emitError(error);
-        this.config.onTransientRefreshFailure?.(error);
-        this.config.onAuthError?.(error);
+        if (!silent) {
+          this.emitError(error);
+          this.config.onTransientRefreshFailure?.(error);
+          this.config.onAuthError?.(error);
+        }
         throw error;
       } finally {
         cleanup();
@@ -12159,6 +12185,30 @@ var HttpClient = class {
     } catch {
     }
   }
+  /**
+   * SDK 인증 헤더를 **주입하지 않는** raw fetch. 저지연 원본 선택과 폴백만 얹는다.
+   *
+   * `cb.endpoint.call()`(`/v1/proxy/*`) 전용이다. 그 경로는 dumb pipe 라 요청 헤더가
+   * 사용자 PC 의 모델 서버로 그대로 전달된다 — `prepareHeaders()` 를 태우면 SDK 의
+   * `Authorization` 이 남의 서버로 나가고, 호출자가 자기 모델 서버용으로 설정한
+   * `Authorization` 을 덮어쓴다. 그래서 fetchRaw 를 재사용하지 않는다.
+   *
+   * @param path `/v1/proxy/...` 형태의 절대 경로 (origin 없이)
+   */
+  async fetchPassthrough(path, init) {
+    const origin = this.resolveOrigin(path);
+    try {
+      const response = await fetch(`${origin}${path}`, init);
+      this.learnDirectOrigin(response);
+      return response;
+    } catch (err) {
+      if (origin !== this.config.baseUrl && !isAbortError(err)) {
+        this.directDisabled = true;
+        return fetch(`${this.config.baseUrl}${path}`, init);
+      }
+      throw err;
+    }
+  }
   async tryFetchOnce(url, init, config) {
     const { signal, cleanup } = createTimeoutController({
       timeout: config?.timeout ?? this.config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,

package/dist/index.mjs

@@ -3072,7 +3072,7 @@ var EndpointAPI = class {
         `EndpointAPI.call: path must start with '/', got ${JSON.stringify(init.path)}`
       );
     }
-    const url = this.url(label, init.path);
+    const path = this.proxyPath(label, init.path);
     const headers = new Headers(init.headers ?? {});
     if (!headers.has("X-Public-Key")) {
       const pk = this.http.getPublicKey();
@@ -3083,7 +3083,7 @@ var EndpointAPI = class {
       }
       headers.set("X-Public-Key", pk);
     }
-    return fetch(url, {
+    return this.http.fetchPassthrough(path, {
       method: init.method ?? "GET",
       headers,
       body: init.body,
@@ -3092,6 +3092,16 @@ var EndpointAPI = class {
       redirect: "follow"
     });
   }
+  /** `/v1/proxy/<label><path>` 절대 경로(origin 없이). URL 조립 규칙의 단일 출처. */
+  proxyPath(label, path) {
+    if (!label) throw new Error("EndpointAPI.call: label required");
+    if (!path || !path.startsWith("/")) {
+      throw new Error(
+        `EndpointAPI.call: path must start with '/', got ${JSON.stringify(path)}`
+      );
+    }
+    return `/v1/proxy/${encodeURIComponent(label)}${path}`;
+  }
   /**
    * 라벨 + path 의 최종 호출 URL `${baseUrl}/v1/proxy/${label}${path}` 을 조립해서
    * 반환. URL 을 다른 시스템 (Service Worker, 백엔드 워커, 로깅) 에 넘기거나
@@ -7246,6 +7256,7 @@ var RealtimeAPI = class {
    * (degraded) AI stream() 이 SSE 로 동작하게 한다. 백그라운드 WS 재연결 머신은 정지한다.
    */
   activateSseFallback(cause) {
+    if (this.sseFallbackActive) return;
     if (this.ws) {
       try {
         this.ws.close();
@@ -7253,14 +7264,20 @@ var RealtimeAPI = class {
       }
       this.ws = null;
     }
+    const causeMsg = cause instanceof Error ? cause.message : String(cause);
     this.sseFallbackActive = true;
     this.activeTransport = "sse";
     this.state = "connected";
     this.retryCount = 0;
     this.log(
-      `WS unavailable (${cause instanceof Error ? cause.message : String(cause)}); using SSE fallback transport for AI streaming`
+      `WS unavailable (${causeMsg}); using SSE fallback transport for AI streaming`
     );
     this.notifyStateChange();
+    this.notifyError(
+      new Error(
+        `Realtime WebSocket unavailable, downgraded to SSE fallback transport (cb.realtime.transport === 'sse'). Only realtime.stream() works in this mode \u2014 subscribe/send/setPresence/typing calls will throw. Cause: ${causeMsg}`
+      )
+    );
   }
   /**
    * 연결 해제
@@ -11400,7 +11417,7 @@ function fetchCredentialsForPath(url) {
   if (COOKIE_BEARING_PUBLIC_PATHS.has(path)) {
     return "include";
   }
-  return path.startsWith("/v1/public/") ? "omit" : "include";
+  return path.startsWith("/v1/public/") || path.startsWith("/v1/proxy/") ? "omit" : "include";
 }
 var TOKEN_STORAGE_KEY = "cb_auth_tokens";
 function gatewayCodeFromStatus(status) {
@@ -11599,7 +11616,7 @@ var HttpClient = class {
     if (this.persistence !== "none") return;
     if (!this.config.refreshToken) return;
     try {
-      await this.refreshAccessToken();
+      await this.refreshAccessToken({ silent: true });
     } catch {
     }
   }
@@ -11732,7 +11749,8 @@ var HttpClient = class {
   getAppId() {
     return this.config.appId;
   }
-  async refreshAccessToken() {
+  async refreshAccessToken(options) {
+    const silent = options?.silent ?? false;
     if (this.isRefreshing) {
       return this.refreshPromise;
     }
@@ -11846,27 +11864,35 @@ var HttpClient = class {
         );
         this.refreshLockedUntil = Date.now() + backoffMs;
         if (failureKind === "permanent") {
-          this.clearTokens();
-          this.config.onTokenExpired?.();
+          if (!silent) {
+            this.clearTokens();
+            this.config.onTokenExpired?.();
+          }
           const error2 = new AuthError(`${baseMsg}. Please login again.`);
-          this.emitError(error2);
-          this.config.onAuthError?.(error2);
+          if (!silent) {
+            this.emitError(error2);
+            this.config.onAuthError?.(error2);
+          }
           throw error2;
         }
         if (failureKind === "client_bug") {
           const error2 = new AuthError(
             `${baseMsg}. Client request invalid; tokens preserved.`
           );
-          this.emitError(error2);
-          this.config.onAuthError?.(error2);
+          if (!silent) {
+            this.emitError(error2);
+            this.config.onAuthError?.(error2);
+          }
           throw error2;
         }
         const error = new AuthError(
           `${baseMsg}. Transient failure; tokens preserved, will retry after backoff.`
         );
-        this.emitError(error);
-        this.config.onTransientRefreshFailure?.(error);
-        this.config.onAuthError?.(error);
+        if (!silent) {
+          this.emitError(error);
+          this.config.onTransientRefreshFailure?.(error);
+          this.config.onAuthError?.(error);
+        }
         throw error;
       } finally {
         cleanup();
@@ -12110,6 +12136,30 @@ var HttpClient = class {
     } catch {
     }
   }
+  /**
+   * SDK 인증 헤더를 **주입하지 않는** raw fetch. 저지연 원본 선택과 폴백만 얹는다.
+   *
+   * `cb.endpoint.call()`(`/v1/proxy/*`) 전용이다. 그 경로는 dumb pipe 라 요청 헤더가
+   * 사용자 PC 의 모델 서버로 그대로 전달된다 — `prepareHeaders()` 를 태우면 SDK 의
+   * `Authorization` 이 남의 서버로 나가고, 호출자가 자기 모델 서버용으로 설정한
+   * `Authorization` 을 덮어쓴다. 그래서 fetchRaw 를 재사용하지 않는다.
+   *
+   * @param path `/v1/proxy/...` 형태의 절대 경로 (origin 없이)
+   */
+  async fetchPassthrough(path, init) {
+    const origin = this.resolveOrigin(path);
+    try {
+      const response = await fetch(`${origin}${path}`, init);
+      this.learnDirectOrigin(response);
+      return response;
+    } catch (err) {
+      if (origin !== this.config.baseUrl && !isAbortError(err)) {
+        this.directDisabled = true;
+        return fetch(`${this.config.baseUrl}${path}`, init);
+      }
+      throw err;
+    }
+  }
   async tryFetchOnce(url, init, config) {
     const { signal, cleanup } = createTimeoutController({
       timeout: config?.timeout ?? this.config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,

package/package.json

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