connectbase-client 5.12.2 → 5.12.3

package/dist/index.d.mts

@@ -276,6 +276,19 @@ declare class HttpClient {
      * 반복하지 않고 한 번에 포기하는 쪽이 안전하다.
      */
     private directDisabled;
+    /**
+     * 서버가 `X-CB-Realtime-Direct-Base` 로 알려준 socket-server 저지연 원본(`wss://...`).
+     * HTTP direct(`directBaseUrl`)와 별도 값·별도 킬 스위치 — core-server 응답에서만 학습되고
+     * (WS 업그레이드 응답 헤더는 브라우저가 못 읽는다), `RealtimeAPI.doConnect()` 가 매 연결
+     * 시도마다 lazy 하게 조회한다. platform-issue 019fe448.
+     */
+    private directRealtimeBaseUrl;
+    /**
+     * realtime WS 연결이 direct 원본에서 네트워크 레벨로 실패하면 세운다 — `directDisabled`
+     * 와 같은 철학("한 번 실패하면 이 세션에서는 포기하고 원래 호스트로")이지만, 실패 감지가
+     * WS 상태 머신(RealtimeAPI) 쪽에서 일어나므로 별도 플래그로 둔다.
+     */
+    private directRealtimeDisabled;
     /**
      * 클라이언트 생성 시 명시된 요청 타임아웃(ms). 미지정이면 `undefined`.
      *
@@ -377,6 +390,18 @@ declare class HttpClient {
      * Base URL 반환
      */
     getBaseUrl(): string;
+    /**
+     * socket-server 의 direct(저지연) WS 원본. 아직 학습 전이거나(REST 요청을 한 번도 안
+     * 보냈거나 서버가 광고를 안 함) 네트워크 레벨로 실패해 이 세션에서 포기했으면 `null` —
+     * 호출자(`RealtimeAPI`)는 이 경우 원래 소켓 URL로 폴백해야 한다.
+     */
+    getDirectRealtimeBaseUrl(): string | null;
+    /**
+     * direct WS 원본이 네트워크 레벨로 실패했을 때 `RealtimeAPI` 가 호출한다. 이후 연결
+     * 시도는 이 세션 동안 전부 원래 소켓 URL로 간다 — direct 는 최적화일 뿐 필수가 아니므로
+     * 재시도를 반복하지 않는다(`directDisabled`/HTTP direct 와 같은 철학).
+     */
+    disableDirectRealtime(): void;
     /**
      * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
      *

package/dist/index.d.ts

@@ -276,6 +276,19 @@ declare class HttpClient {
      * 반복하지 않고 한 번에 포기하는 쪽이 안전하다.
      */
     private directDisabled;
+    /**
+     * 서버가 `X-CB-Realtime-Direct-Base` 로 알려준 socket-server 저지연 원본(`wss://...`).
+     * HTTP direct(`directBaseUrl`)와 별도 값·별도 킬 스위치 — core-server 응답에서만 학습되고
+     * (WS 업그레이드 응답 헤더는 브라우저가 못 읽는다), `RealtimeAPI.doConnect()` 가 매 연결
+     * 시도마다 lazy 하게 조회한다. platform-issue 019fe448.
+     */
+    private directRealtimeBaseUrl;
+    /**
+     * realtime WS 연결이 direct 원본에서 네트워크 레벨로 실패하면 세운다 — `directDisabled`
+     * 와 같은 철학("한 번 실패하면 이 세션에서는 포기하고 원래 호스트로")이지만, 실패 감지가
+     * WS 상태 머신(RealtimeAPI) 쪽에서 일어나므로 별도 플래그로 둔다.
+     */
+    private directRealtimeDisabled;
     /**
      * 클라이언트 생성 시 명시된 요청 타임아웃(ms). 미지정이면 `undefined`.
      *
@@ -377,6 +390,18 @@ declare class HttpClient {
      * Base URL 반환
      */
     getBaseUrl(): string;
+    /**
+     * socket-server 의 direct(저지연) WS 원본. 아직 학습 전이거나(REST 요청을 한 번도 안
+     * 보냈거나 서버가 광고를 안 함) 네트워크 레벨로 실패해 이 세션에서 포기했으면 `null` —
+     * 호출자(`RealtimeAPI`)는 이 경우 원래 소켓 URL로 폴백해야 한다.
+     */
+    getDirectRealtimeBaseUrl(): string | null;
+    /**
+     * direct WS 원본이 네트워크 레벨로 실패했을 때 `RealtimeAPI` 가 호출한다. 이후 연결
+     * 시도는 이 세션 동안 전부 원래 소켓 URL로 간다 — direct 는 최적화일 뿐 필수가 아니므로
+     * 재시도를 반복하지 않는다(`directDisabled`/HTTP direct 와 같은 철학).
+     */
+    disableDirectRealtime(): void;
     /**
      * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
      *

package/dist/index.js

@@ -8141,7 +8141,9 @@ var RealtimeAPI = class {
       this.state = "connecting";
       this.notifyStateChange();
       this.log("Connecting...");
-      const wsUrl = this.socketUrl.replace(/^http/, "ws");
+      const directWsBase = this.http.getDirectRealtimeBaseUrl();
+      const usingDirect = !!directWsBase;
+      const wsUrl = (directWsBase ?? this.socketUrl).replace(/^http/, "ws");
       let url;
       if (this.options.accessToken) {
         url = `${wsUrl}/v1/realtime/auth?access_token=${encodeURIComponent(this.options.accessToken)}&client_id=${this.clientId}`;
@@ -8171,6 +8173,7 @@ var RealtimeAPI = class {
             this.ws.close();
             this.ws = null;
           }
+          if (usingDirect) this.http.disableDirectRealtime();
           this.state = "disconnected";
           this.notifyStateChange();
           reject(
@@ -8209,6 +8212,7 @@ var RealtimeAPI = class {
           if (!settled && this.state === "connecting") {
             settled = true;
             clearTimeout(timeoutId);
+            if (usingDirect) this.http.disableDirectRealtime();
             reject(
               new Error(
                 `Connection closed: ${event.reason || "unknown reason"}`
@@ -8226,12 +8230,14 @@ var RealtimeAPI = class {
           if (!settled && this.state === "connecting") {
             settled = true;
             clearTimeout(timeoutId);
+            if (usingDirect) this.http.disableDirectRealtime();
             reject(new Error("Failed to connect"));
           }
         };
       } catch (e) {
         settled = true;
         clearTimeout(timeoutId);
+        if (usingDirect) this.http.disableDirectRealtime();
         reject(e);
       }
     });
@@ -11550,6 +11556,19 @@ var HttpClient = class {
      * 반복하지 않고 한 번에 포기하는 쪽이 안전하다.
      */
     this.directDisabled = false;
+    /**
+     * 서버가 `X-CB-Realtime-Direct-Base` 로 알려준 socket-server 저지연 원본(`wss://...`).
+     * HTTP direct(`directBaseUrl`)와 별도 값·별도 킬 스위치 — core-server 응답에서만 학습되고
+     * (WS 업그레이드 응답 헤더는 브라우저가 못 읽는다), `RealtimeAPI.doConnect()` 가 매 연결
+     * 시도마다 lazy 하게 조회한다. platform-issue 019fe448.
+     */
+    this.directRealtimeBaseUrl = null;
+    /**
+     * realtime WS 연결이 direct 원본에서 네트워크 레벨로 실패하면 세운다 — `directDisabled`
+     * 와 같은 철학("한 번 실패하면 이 세션에서는 포기하고 원래 호스트로")이지만, 실패 감지가
+     * WS 상태 머신(RealtimeAPI) 쪽에서 일어나므로 별도 플래그로 둔다.
+     */
+    this.directRealtimeDisabled = false;
     this.config = { ...config };
     this.storageKey = this.buildStorageKey();
     this.warnIfUnsafePersistence();
@@ -11795,6 +11814,22 @@ var HttpClient = class {
   getBaseUrl() {
     return this.config.baseUrl;
   }
+  /**
+   * socket-server 의 direct(저지연) WS 원본. 아직 학습 전이거나(REST 요청을 한 번도 안
+   * 보냈거나 서버가 광고를 안 함) 네트워크 레벨로 실패해 이 세션에서 포기했으면 `null` —
+   * 호출자(`RealtimeAPI`)는 이 경우 원래 소켓 URL로 폴백해야 한다.
+   */
+  getDirectRealtimeBaseUrl() {
+    return this.directRealtimeDisabled ? null : this.directRealtimeBaseUrl;
+  }
+  /**
+   * direct WS 원본이 네트워크 레벨로 실패했을 때 `RealtimeAPI` 가 호출한다. 이후 연결
+   * 시도는 이 세션 동안 전부 원래 소켓 URL로 간다 — direct 는 최적화일 뿐 필수가 아니므로
+   * 재시도를 반복하지 않는다(`directDisabled`/HTTP direct 와 같은 철학).
+   */
+  disableDirectRealtime() {
+    this.directRealtimeDisabled = true;
+  }
   /**
    * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
    *
@@ -12178,17 +12213,37 @@ var HttpClient = class {
    * 일은 없어야 한다.
    */
   learnDirectOrigin(response) {
-    if (this.directDisabled || this.directBaseUrl) return;
-    const advertised = response.headers?.get("X-CB-Direct-Base");
-    if (!advertised) return;
+    if (!response.headers) return;
+    const tail = (h) => h.split(".").slice(-2).join(".");
+    let base;
     try {
-      const next = new URL(advertised);
-      const base = new URL(this.config.baseUrl);
-      if (next.protocol !== "https:") return;
-      const tail = (h) => h.split(".").slice(-2).join(".");
-      if (tail(next.hostname) !== tail(base.hostname)) return;
-      this.directBaseUrl = next.origin;
+      base = new URL(this.config.baseUrl);
     } catch {
+      return;
+    }
+    if (!this.directDisabled && !this.directBaseUrl) {
+      const advertised = response.headers.get("X-CB-Direct-Base");
+      if (advertised) {
+        try {
+          const next = new URL(advertised);
+          if (next.protocol === "https:" && tail(next.hostname) === tail(base.hostname)) {
+            this.directBaseUrl = next.origin;
+          }
+        } catch {
+        }
+      }
+    }
+    if (!this.directRealtimeDisabled && !this.directRealtimeBaseUrl) {
+      const advertisedRealtime = response.headers.get("X-CB-Realtime-Direct-Base");
+      if (advertisedRealtime) {
+        try {
+          const next = new URL(advertisedRealtime);
+          if (next.protocol === "wss:" && tail(next.hostname) === tail(base.hostname)) {
+            this.directRealtimeBaseUrl = next.origin;
+          }
+        } catch {
+        }
+      }
     }
   }
   /**

package/dist/index.mjs

@@ -8092,7 +8092,9 @@ var RealtimeAPI = class {
       this.state = "connecting";
       this.notifyStateChange();
       this.log("Connecting...");
-      const wsUrl = this.socketUrl.replace(/^http/, "ws");
+      const directWsBase = this.http.getDirectRealtimeBaseUrl();
+      const usingDirect = !!directWsBase;
+      const wsUrl = (directWsBase ?? this.socketUrl).replace(/^http/, "ws");
       let url;
       if (this.options.accessToken) {
         url = `${wsUrl}/v1/realtime/auth?access_token=${encodeURIComponent(this.options.accessToken)}&client_id=${this.clientId}`;
@@ -8122,6 +8124,7 @@ var RealtimeAPI = class {
             this.ws.close();
             this.ws = null;
           }
+          if (usingDirect) this.http.disableDirectRealtime();
           this.state = "disconnected";
           this.notifyStateChange();
           reject(
@@ -8160,6 +8163,7 @@ var RealtimeAPI = class {
           if (!settled && this.state === "connecting") {
             settled = true;
             clearTimeout(timeoutId);
+            if (usingDirect) this.http.disableDirectRealtime();
             reject(
               new Error(
                 `Connection closed: ${event.reason || "unknown reason"}`
@@ -8177,12 +8181,14 @@ var RealtimeAPI = class {
           if (!settled && this.state === "connecting") {
             settled = true;
             clearTimeout(timeoutId);
+            if (usingDirect) this.http.disableDirectRealtime();
             reject(new Error("Failed to connect"));
           }
         };
       } catch (e) {
         settled = true;
         clearTimeout(timeoutId);
+        if (usingDirect) this.http.disableDirectRealtime();
         reject(e);
       }
     });
@@ -11501,6 +11507,19 @@ var HttpClient = class {
      * 반복하지 않고 한 번에 포기하는 쪽이 안전하다.
      */
     this.directDisabled = false;
+    /**
+     * 서버가 `X-CB-Realtime-Direct-Base` 로 알려준 socket-server 저지연 원본(`wss://...`).
+     * HTTP direct(`directBaseUrl`)와 별도 값·별도 킬 스위치 — core-server 응답에서만 학습되고
+     * (WS 업그레이드 응답 헤더는 브라우저가 못 읽는다), `RealtimeAPI.doConnect()` 가 매 연결
+     * 시도마다 lazy 하게 조회한다. platform-issue 019fe448.
+     */
+    this.directRealtimeBaseUrl = null;
+    /**
+     * realtime WS 연결이 direct 원본에서 네트워크 레벨로 실패하면 세운다 — `directDisabled`
+     * 와 같은 철학("한 번 실패하면 이 세션에서는 포기하고 원래 호스트로")이지만, 실패 감지가
+     * WS 상태 머신(RealtimeAPI) 쪽에서 일어나므로 별도 플래그로 둔다.
+     */
+    this.directRealtimeDisabled = false;
     this.config = { ...config };
     this.storageKey = this.buildStorageKey();
     this.warnIfUnsafePersistence();
@@ -11746,6 +11765,22 @@ var HttpClient = class {
   getBaseUrl() {
     return this.config.baseUrl;
   }
+  /**
+   * socket-server 의 direct(저지연) WS 원본. 아직 학습 전이거나(REST 요청을 한 번도 안
+   * 보냈거나 서버가 광고를 안 함) 네트워크 레벨로 실패해 이 세션에서 포기했으면 `null` —
+   * 호출자(`RealtimeAPI`)는 이 경우 원래 소켓 URL로 폴백해야 한다.
+   */
+  getDirectRealtimeBaseUrl() {
+    return this.directRealtimeDisabled ? null : this.directRealtimeBaseUrl;
+  }
+  /**
+   * direct WS 원본이 네트워크 레벨로 실패했을 때 `RealtimeAPI` 가 호출한다. 이후 연결
+   * 시도는 이 세션 동안 전부 원래 소켓 URL로 간다 — direct 는 최적화일 뿐 필수가 아니므로
+   * 재시도를 반복하지 않는다(`directDisabled`/HTTP direct 와 같은 철학).
+   */
+  disableDirectRealtime() {
+    this.directRealtimeDisabled = true;
+  }
   /**
    * 이 클라이언트에 설정된 앱 ID 반환 (미설정 시 undefined).
    *
@@ -12129,17 +12164,37 @@ var HttpClient = class {
    * 일은 없어야 한다.
    */
   learnDirectOrigin(response) {
-    if (this.directDisabled || this.directBaseUrl) return;
-    const advertised = response.headers?.get("X-CB-Direct-Base");
-    if (!advertised) return;
+    if (!response.headers) return;
+    const tail = (h) => h.split(".").slice(-2).join(".");
+    let base;
     try {
-      const next = new URL(advertised);
-      const base = new URL(this.config.baseUrl);
-      if (next.protocol !== "https:") return;
-      const tail = (h) => h.split(".").slice(-2).join(".");
-      if (tail(next.hostname) !== tail(base.hostname)) return;
-      this.directBaseUrl = next.origin;
+      base = new URL(this.config.baseUrl);
     } catch {
+      return;
+    }
+    if (!this.directDisabled && !this.directBaseUrl) {
+      const advertised = response.headers.get("X-CB-Direct-Base");
+      if (advertised) {
+        try {
+          const next = new URL(advertised);
+          if (next.protocol === "https:" && tail(next.hostname) === tail(base.hostname)) {
+            this.directBaseUrl = next.origin;
+          }
+        } catch {
+        }
+      }
+    }
+    if (!this.directRealtimeDisabled && !this.directRealtimeBaseUrl) {
+      const advertisedRealtime = response.headers.get("X-CB-Realtime-Direct-Base");
+      if (advertisedRealtime) {
+        try {
+          const next = new URL(advertisedRealtime);
+          if (next.protocol === "wss:" && tail(next.hostname) === tail(base.hostname)) {
+            this.directRealtimeBaseUrl = next.origin;
+          }
+        } catch {
+        }
+      }
     }
   }
   /**

package/package.json

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