connectbase-client 6.14.0 → 6.15.0

package/dist/index.d.mts

@@ -153,7 +153,8 @@ declare class GameError extends Error {
     toJSON(): Record<string, unknown>;
 }
 /**
- * 실시간(WebSocket) 연결 거부 코드. socket-server 가 연결을 받지 않은 이유이고, 대응이 코드마다 다르다.
+ * 실시간(WebSocket) 연결 거부 코드. 서버(`cb.realtime` 의 socket-server, `cb.database` 실시간의 data-server)가 연결을 받지
+ * 않은 이유이고, 대응이 코드마다 다르다.
  *
  * | 코드 | 원인 | 재시도 | 권장 대응 |
  * |------|------|--------|-----------|
@@ -169,8 +170,15 @@ declare class GameError extends Error {
  * | `invalid_ws_ticket` | 1회용 연결 티켓이 만료됐거나 이미 쓰였다 | 가능 | `connect()` 가 새 티켓으로 스스로 다시 붙는다 |
  * | `ws_ticket_unavailable` | 서버의 티켓 저장소 일시 장애 | 가능 | `connect()` 가 다시 시도하고, 티켓을 못 받으면 예전 방식으로 붙는다 |
  * | `query_credential_rejected` | 서버가 URL 쿼리 자격증명을 받지 않도록 설정됐다 | 불가 | 1회용 티켓으로 붙는 SDK 로 올린다 |
+ * | `ambiguous_credentials` | 티켓과 다른 자격증명을 함께 보냈다 | 불가 | 직접 짠 클라이언트라면 둘 중 하나만 보낸다 |
+ * | `rate_limit_exceeded` | 요청 속도 제한 (`cb.database` 실시간) | 가능 | `retryAfterMs` 가 있으면 그 뒤에 스스로 다시 붙는다 |
+ * | `invalid_token` | cross-app OAuth 토큰 검증 실패 (`cb.database` 실시간) | 불가 | 새 토큰으로 다시 연결 |
+ * | `member_revoked` | 멤버 정지, 삭제, 세션 전체 종료 | 불가 | 다시 로그인. `message` 에 앱이 적은 정지 사유가 있다 |
+ * | `token_expired` | 연결 중 멤버 토큰이 만료됐고 갱신할 수 없다 | 불가 | 새 토큰으로 다시 연결 |
+ *
+ * 코드를 모르는 거부도 close 코드가 4429, 4500, 4503 이면 재시도 가능으로 본다.
  */
-type RealtimeConnectionErrorCode = "connection_limit_exceeded" | "quota_exceeded" | "server_at_capacity" | "rate_limited" | "auth_unavailable" | "unauthorized" | "forbidden" | "invalid_user_id" | "internal_error" | "invalid_ws_ticket" | "ws_ticket_unavailable" | "query_credential_rejected" | (string & {});
+type RealtimeConnectionErrorCode = "connection_limit_exceeded" | "quota_exceeded" | "server_at_capacity" | "rate_limited" | "auth_unavailable" | "unauthorized" | "forbidden" | "invalid_user_id" | "internal_error" | "invalid_ws_ticket" | "ws_ticket_unavailable" | "query_credential_rejected" | "ambiguous_credentials" | "rate_limit_exceeded" | "invalid_token" | "member_revoked" | "token_expired" | (string & {});
 /**
  * 서버가 이유를 밝히고 실시간 연결을 거부했을 때 `cb.realtime.connect()` 가 던지는 에러.
  *
@@ -3720,6 +3728,13 @@ declare class DatabaseAPI {
      */
     private realtimeTicket;
     private doRealtimeConnect;
+    /**
+     * 서버가 연결을 거부했다(티켓 발급 거부, 또는 reject_mode=close 로 받은 업그레이드 거부). cb.realtime 과 같은 규칙이다 —
+     * 다시 해서 될 거부(`retryable`: 일시 장애, 속도 제한, 동시접속 한도, 만료된 티켓)는 서버가 알려 준 시각(`retryAfterMs`)
+     * 이후로 재연결을 이어 가고, 아니면(자격증명, 멤버 폐기, 할당량) 멈추고 `onRealtimeError` 로 알린다. 재시도를 다 써도
+     * 거부되면 마지막 거부를 알린다.
+     */
+    private handleRealtimeRejection;
     /**
      * 서버에 subscribe 메시지를 보내고 서버 subscription_id를 반환하는 Promise
      */
@@ -3729,6 +3744,10 @@ declare class DatabaseAPI {
      */
     private resubscribeAll;
     private handleRealtimeMessage;
+    /**
+     * 지수 백오프로 다시 붙는다. cause 는 이번 시도를 끝낸 서버의 거부다 — 알려 준 재시도 시각(`retryAfterMs`)보다 일찍 다시
+     * 하지 않고, 재시도를 다 쓰면 일반 오류 대신 그 거부를 알린다.
+     */
     private attemptRealtimeReconnect;
     private startRealtimePing;
     private stopRealtimePing;
@@ -10982,7 +11001,7 @@ interface ReportPlatformBugRequest {
     /** SDK 버전 override (자동 감지 실패 시). */
     sdkVersion?: string;
     /** SDK 플랫폼 override. */
-    sdkPlatform?: "web" | "node" | "unity" | "godot" | "unreal" | "cli" | "mcp" | "other";
+    sdkPlatform?: "web" | "node" | "cli" | "mcp" | "other";
     /** 환경 (production/staging/development). 기본 unknown. */
     environment?: "production" | "staging" | "development" | "unknown";
 }
@@ -11019,7 +11038,7 @@ interface PlatformIssueDetail {
     status: "open" | "triaged" | "in_progress" | "resolved" | "wontfix" | "duplicate";
     resolution_note?: string;
     sdk_version?: string;
-    sdk_platform?: "web" | "node" | "unity" | "godot" | "unreal" | "cli" | "mcp" | "other";
+    sdk_platform?: "web" | "node" | "cli" | "mcp" | "other";
     environment?: "production" | "staging" | "development" | "unknown";
     external_links?: Array<{
         kind: string;

package/dist/index.d.ts

@@ -153,7 +153,8 @@ declare class GameError extends Error {
     toJSON(): Record<string, unknown>;
 }
 /**
- * 실시간(WebSocket) 연결 거부 코드. socket-server 가 연결을 받지 않은 이유이고, 대응이 코드마다 다르다.
+ * 실시간(WebSocket) 연결 거부 코드. 서버(`cb.realtime` 의 socket-server, `cb.database` 실시간의 data-server)가 연결을 받지
+ * 않은 이유이고, 대응이 코드마다 다르다.
  *
  * | 코드 | 원인 | 재시도 | 권장 대응 |
  * |------|------|--------|-----------|
@@ -169,8 +170,15 @@ declare class GameError extends Error {
  * | `invalid_ws_ticket` | 1회용 연결 티켓이 만료됐거나 이미 쓰였다 | 가능 | `connect()` 가 새 티켓으로 스스로 다시 붙는다 |
  * | `ws_ticket_unavailable` | 서버의 티켓 저장소 일시 장애 | 가능 | `connect()` 가 다시 시도하고, 티켓을 못 받으면 예전 방식으로 붙는다 |
  * | `query_credential_rejected` | 서버가 URL 쿼리 자격증명을 받지 않도록 설정됐다 | 불가 | 1회용 티켓으로 붙는 SDK 로 올린다 |
+ * | `ambiguous_credentials` | 티켓과 다른 자격증명을 함께 보냈다 | 불가 | 직접 짠 클라이언트라면 둘 중 하나만 보낸다 |
+ * | `rate_limit_exceeded` | 요청 속도 제한 (`cb.database` 실시간) | 가능 | `retryAfterMs` 가 있으면 그 뒤에 스스로 다시 붙는다 |
+ * | `invalid_token` | cross-app OAuth 토큰 검증 실패 (`cb.database` 실시간) | 불가 | 새 토큰으로 다시 연결 |
+ * | `member_revoked` | 멤버 정지, 삭제, 세션 전체 종료 | 불가 | 다시 로그인. `message` 에 앱이 적은 정지 사유가 있다 |
+ * | `token_expired` | 연결 중 멤버 토큰이 만료됐고 갱신할 수 없다 | 불가 | 새 토큰으로 다시 연결 |
+ *
+ * 코드를 모르는 거부도 close 코드가 4429, 4500, 4503 이면 재시도 가능으로 본다.
  */
-type RealtimeConnectionErrorCode = "connection_limit_exceeded" | "quota_exceeded" | "server_at_capacity" | "rate_limited" | "auth_unavailable" | "unauthorized" | "forbidden" | "invalid_user_id" | "internal_error" | "invalid_ws_ticket" | "ws_ticket_unavailable" | "query_credential_rejected" | (string & {});
+type RealtimeConnectionErrorCode = "connection_limit_exceeded" | "quota_exceeded" | "server_at_capacity" | "rate_limited" | "auth_unavailable" | "unauthorized" | "forbidden" | "invalid_user_id" | "internal_error" | "invalid_ws_ticket" | "ws_ticket_unavailable" | "query_credential_rejected" | "ambiguous_credentials" | "rate_limit_exceeded" | "invalid_token" | "member_revoked" | "token_expired" | (string & {});
 /**
  * 서버가 이유를 밝히고 실시간 연결을 거부했을 때 `cb.realtime.connect()` 가 던지는 에러.
  *
@@ -3720,6 +3728,13 @@ declare class DatabaseAPI {
      */
     private realtimeTicket;
     private doRealtimeConnect;
+    /**
+     * 서버가 연결을 거부했다(티켓 발급 거부, 또는 reject_mode=close 로 받은 업그레이드 거부). cb.realtime 과 같은 규칙이다 —
+     * 다시 해서 될 거부(`retryable`: 일시 장애, 속도 제한, 동시접속 한도, 만료된 티켓)는 서버가 알려 준 시각(`retryAfterMs`)
+     * 이후로 재연결을 이어 가고, 아니면(자격증명, 멤버 폐기, 할당량) 멈추고 `onRealtimeError` 로 알린다. 재시도를 다 써도
+     * 거부되면 마지막 거부를 알린다.
+     */
+    private handleRealtimeRejection;
     /**
      * 서버에 subscribe 메시지를 보내고 서버 subscription_id를 반환하는 Promise
      */
@@ -3729,6 +3744,10 @@ declare class DatabaseAPI {
      */
     private resubscribeAll;
     private handleRealtimeMessage;
+    /**
+     * 지수 백오프로 다시 붙는다. cause 는 이번 시도를 끝낸 서버의 거부다 — 알려 준 재시도 시각(`retryAfterMs`)보다 일찍 다시
+     * 하지 않고, 재시도를 다 쓰면 일반 오류 대신 그 거부를 알린다.
+     */
     private attemptRealtimeReconnect;
     private startRealtimePing;
     private stopRealtimePing;
@@ -10982,7 +11001,7 @@ interface ReportPlatformBugRequest {
     /** SDK 버전 override (자동 감지 실패 시). */
     sdkVersion?: string;
     /** SDK 플랫폼 override. */
-    sdkPlatform?: "web" | "node" | "unity" | "godot" | "unreal" | "cli" | "mcp" | "other";
+    sdkPlatform?: "web" | "node" | "cli" | "mcp" | "other";
     /** 환경 (production/staging/development). 기본 unknown. */
     environment?: "production" | "staging" | "development" | "unknown";
 }
@@ -11019,7 +11038,7 @@ interface PlatformIssueDetail {
     status: "open" | "triaged" | "in_progress" | "resolved" | "wontfix" | "duplicate";
     resolution_note?: string;
     sdk_version?: string;
-    sdk_platform?: "web" | "node" | "unity" | "godot" | "unreal" | "cli" | "mcp" | "other";
+    sdk_platform?: "web" | "node" | "cli" | "mcp" | "other";
     environment?: "production" | "staging" | "development" | "unknown";
     external_links?: Array<{
         kind: string;

package/dist/index.js

@@ -291,7 +291,7 @@ var RealtimeConnectionError = class extends Error {
     this.name = "RealtimeConnectionError";
     this.code = init.code || "unknown";
     this.closeCode = init.closeCode;
-    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code);
+    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code, init.closeCode);
     this.details = init.details;
     this.retryAfterMs = init.retryAfterMs;
   }
@@ -308,8 +308,8 @@ var RealtimeConnectionError = class extends Error {
     };
   }
 };
-function isRetryableRealtimeRejection(code) {
-  return code === "connection_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
+function isRetryableRealtimeRejection(code, closeCode) {
+  return closeCode === 4429 || closeCode === 4500 || closeCode === 4503 || code === "connection_limit_exceeded" || code === "rate_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
 }
 var RealtimeRequestError = class extends Error {
   constructor(init) {
@@ -3807,6 +3807,20 @@ var REALTIME_CLOSING_NOTICE_CODES = /* @__PURE__ */ new Set([
 ]);
 var CLOSE_CODE_TOKEN_EXPIRED = 4401;
 var CLOSE_CODE_MEMBER_REVOKED = 4403;
+function toRealtimeRejection(msg) {
+  if (msg.type !== "error" || msg.request_id || typeof msg.close_code !== "number") {
+    return null;
+  }
+  const details = msg.details;
+  return new RealtimeConnectionError({
+    code: typeof msg.code === "string" ? msg.code : void 0,
+    message: typeof msg.message === "string" ? msg.message : void 0,
+    closeCode: msg.close_code,
+    retryable: typeof msg.retryable === "boolean" ? msg.retryable : void 0,
+    details: details && typeof details === "object" && !Array.isArray(details) ? details : void 0,
+    retryAfterMs: typeof msg.retry_after_ms === "number" && msg.retry_after_ms > 0 ? msg.retry_after_ms : void 0
+  });
+}
 var DatabaseAPI = class {
   constructor(http) {
     this.realtimeWs = null;
@@ -4749,18 +4763,13 @@ var DatabaseAPI = class {
       ticket = await this.realtimeTicket();
     } catch (e) {
       if (e instanceof WsTicketError) {
-        if (e.status === 429 && this.realtimeOptions) {
-          this.attemptRealtimeReconnect();
-        } else {
-          this.setRealtimeState("disconnected");
-        }
         const err = new RealtimeConnectionError({
           code: e.code,
           message: e.message,
           closeCode: 4e3 + e.status,
           retryAfterMs: e.retryAfterMs
         });
-        this.realtimeOnError?.(err);
+        this.handleRealtimeRejection(err);
         throw err;
       }
       throw e;
@@ -4794,10 +4803,14 @@ var DatabaseAPI = class {
       this.realtimeOptions.accessToken
     );
     if (this.realtimeTokenRefresh) url += "&token_refresh=1";
+    url += "&reject_mode=close";
     return new Promise((resolve, reject) => {
       try {
-        this.realtimeWs = new WebSocket(url);
+        const ws = new WebSocket(url);
+        this.realtimeWs = ws;
         let settled = false;
+        let accepted = false;
+        let rejection = null;
         const connectTimeout = setTimeout(() => {
           if (!settled) {
             settled = true;
@@ -4809,7 +4822,8 @@ var DatabaseAPI = class {
             reject(new Error("Connection timeout"));
           }
         }, REALTIME_CONNECT_TIMEOUT_MS);
-        this.realtimeWs.onopen = () => {
+        const accept = () => {
+          accepted = true;
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
@@ -4822,15 +4836,28 @@ var DatabaseAPI = class {
           this.resubscribeAll();
           resolve();
         };
-        this.realtimeWs.onmessage = (event) => {
+        ws.onopen = () => {
+          ws.send(JSON.stringify({ type: "ping", timestamp: Date.now() }));
+        };
+        ws.onmessage = (event) => {
+          let msg;
           try {
-            const msg = JSON.parse(event.data);
-            this.handleRealtimeMessage(msg);
+            msg = JSON.parse(event.data);
           } catch {
             this.debugLog("Failed to parse realtime message");
+            return;
+          }
+          if (!accepted) {
+            const rejected = toRealtimeRejection(msg);
+            if (rejected) {
+              rejection = rejected;
+              return;
+            }
+            accept();
           }
+          this.handleRealtimeMessage(msg);
         };
-        this.realtimeWs.onclose = (event) => {
+        ws.onclose = (event) => {
           this.debugLog(
             `Database realtime disconnected (code=${event?.code}, reason=${event?.reason})`
           );
@@ -4839,12 +4866,25 @@ var DatabaseAPI = class {
           this.clearRealtimeAuthRetry();
           const notice = this.realtimeCloseNotice;
           this.realtimeCloseNotice = null;
+          const code = event?.code;
+          if (!accepted && code >= 4e3 && code <= 4999) {
+            const err = rejection ?? new RealtimeConnectionError({
+              code: event.reason || void 0,
+              closeCode: code
+            });
+            if (!settled) {
+              settled = true;
+              clearTimeout(connectTimeout);
+              reject(err);
+            }
+            this.handleRealtimeRejection(err);
+            return;
+          }
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
             reject(new Error("Connection closed during handshake"));
           }
-          const code = event?.code;
           if (this.realtimeOptions && this.realtimeState !== "disconnected" && (code === CLOSE_CODE_MEMBER_REVOKED || code === CLOSE_CODE_TOKEN_EXPIRED && !this.http.canRefreshMemberToken(
             this.realtimeOptions.accessToken
           ))) {
@@ -4862,7 +4902,7 @@ var DatabaseAPI = class {
             this.attemptRealtimeReconnect();
           }
         };
-        this.realtimeWs.onerror = () => {
+        ws.onerror = () => {
           this.debugLog("Database realtime error");
           this.realtimeOnError?.(new Error("WebSocket connection error"));
         };
@@ -4872,6 +4912,21 @@ var DatabaseAPI = class {
       }
     });
   }
+  /**
+   * 서버가 연결을 거부했다(티켓 발급 거부, 또는 reject_mode=close 로 받은 업그레이드 거부). cb.realtime 과 같은 규칙이다 —
+   * 다시 해서 될 거부(`retryable`: 일시 장애, 속도 제한, 동시접속 한도, 만료된 티켓)는 서버가 알려 준 시각(`retryAfterMs`)
+   * 이후로 재연결을 이어 가고, 아니면(자격증명, 멤버 폐기, 할당량) 멈추고 `onRealtimeError` 로 알린다. 재시도를 다 써도
+   * 거부되면 마지막 거부를 알린다.
+   */
+  handleRealtimeRejection(err) {
+    if (!this.realtimeOptions || this.realtimeState === "disconnected") return;
+    if (err.retryable) {
+      this.attemptRealtimeReconnect(err);
+      return;
+    }
+    this.setRealtimeState("disconnected");
+    this.realtimeOnError?.(err);
+  }
   /**
    * 서버에 subscribe 메시지를 보내고 서버 subscription_id를 반환하는 Promise
    */
@@ -5044,21 +5099,25 @@ var DatabaseAPI = class {
         break;
     }
   }
-  attemptRealtimeReconnect() {
+  /**
+   * 지수 백오프로 다시 붙는다. cause 는 이번 시도를 끝낸 서버의 거부다 — 알려 준 재시도 시각(`retryAfterMs`)보다 일찍 다시
+   * 하지 않고, 재시도를 다 쓰면 일반 오류 대신 그 거부를 알린다.
+   */
+  attemptRealtimeReconnect(cause) {
     const maxRetries = this.realtimeOptions?.maxRetries ?? 5;
     const retryInterval = this.realtimeOptions?.retryInterval ?? 1e3;
     if (this.realtimeRetryCount >= maxRetries) {
       this.setRealtimeState("disconnected");
       this.realtimeOnError?.(
-        new Error("Realtime connection lost. Max retries exceeded.")
+        cause ?? new Error("Realtime connection lost. Max retries exceeded.")
       );
       return;
     }
     this.setRealtimeState("connecting");
     this.realtimeRetryCount++;
-    const delay = Math.min(
-      retryInterval * 2 ** (this.realtimeRetryCount - 1),
-      3e4
+    const delay = Math.max(
+      Math.min(retryInterval * 2 ** (this.realtimeRetryCount - 1), 3e4),
+      cause?.retryAfterMs ?? 0
     );
     this.debugLog(
       `Reconnecting in ${delay}ms (attempt ${this.realtimeRetryCount}/${maxRetries})`
@@ -13550,8 +13609,8 @@ var SupportAPI = class {
   }
 };
 function detectSdkVersion() {
-  if ("6.14.0") {
-    return "6.14.0";
+  if ("6.15.0") {
+    return "6.15.0";
   }
   return "unknown";
 }

package/dist/index.mjs

@@ -238,7 +238,7 @@ var RealtimeConnectionError = class extends Error {
     this.name = "RealtimeConnectionError";
     this.code = init.code || "unknown";
     this.closeCode = init.closeCode;
-    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code);
+    this.retryable = init.retryable ?? isRetryableRealtimeRejection(this.code, init.closeCode);
     this.details = init.details;
     this.retryAfterMs = init.retryAfterMs;
   }
@@ -255,8 +255,8 @@ var RealtimeConnectionError = class extends Error {
     };
   }
 };
-function isRetryableRealtimeRejection(code) {
-  return code === "connection_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
+function isRetryableRealtimeRejection(code, closeCode) {
+  return closeCode === 4429 || closeCode === 4500 || closeCode === 4503 || code === "connection_limit_exceeded" || code === "rate_limit_exceeded" || code === "server_at_capacity" || code === "rate_limited" || code === "auth_unavailable" || code === "internal_error" || code === "invalid_ws_ticket" || code === "ws_ticket_unavailable";
 }
 var RealtimeRequestError = class extends Error {
   constructor(init) {
@@ -3754,6 +3754,20 @@ var REALTIME_CLOSING_NOTICE_CODES = /* @__PURE__ */ new Set([
 ]);
 var CLOSE_CODE_TOKEN_EXPIRED = 4401;
 var CLOSE_CODE_MEMBER_REVOKED = 4403;
+function toRealtimeRejection(msg) {
+  if (msg.type !== "error" || msg.request_id || typeof msg.close_code !== "number") {
+    return null;
+  }
+  const details = msg.details;
+  return new RealtimeConnectionError({
+    code: typeof msg.code === "string" ? msg.code : void 0,
+    message: typeof msg.message === "string" ? msg.message : void 0,
+    closeCode: msg.close_code,
+    retryable: typeof msg.retryable === "boolean" ? msg.retryable : void 0,
+    details: details && typeof details === "object" && !Array.isArray(details) ? details : void 0,
+    retryAfterMs: typeof msg.retry_after_ms === "number" && msg.retry_after_ms > 0 ? msg.retry_after_ms : void 0
+  });
+}
 var DatabaseAPI = class {
   constructor(http) {
     this.realtimeWs = null;
@@ -4696,18 +4710,13 @@ var DatabaseAPI = class {
       ticket = await this.realtimeTicket();
     } catch (e) {
       if (e instanceof WsTicketError) {
-        if (e.status === 429 && this.realtimeOptions) {
-          this.attemptRealtimeReconnect();
-        } else {
-          this.setRealtimeState("disconnected");
-        }
         const err = new RealtimeConnectionError({
           code: e.code,
           message: e.message,
           closeCode: 4e3 + e.status,
           retryAfterMs: e.retryAfterMs
         });
-        this.realtimeOnError?.(err);
+        this.handleRealtimeRejection(err);
         throw err;
       }
       throw e;
@@ -4741,10 +4750,14 @@ var DatabaseAPI = class {
       this.realtimeOptions.accessToken
     );
     if (this.realtimeTokenRefresh) url += "&token_refresh=1";
+    url += "&reject_mode=close";
     return new Promise((resolve, reject) => {
       try {
-        this.realtimeWs = new WebSocket(url);
+        const ws = new WebSocket(url);
+        this.realtimeWs = ws;
         let settled = false;
+        let accepted = false;
+        let rejection = null;
         const connectTimeout = setTimeout(() => {
           if (!settled) {
             settled = true;
@@ -4756,7 +4769,8 @@ var DatabaseAPI = class {
             reject(new Error("Connection timeout"));
           }
         }, REALTIME_CONNECT_TIMEOUT_MS);
-        this.realtimeWs.onopen = () => {
+        const accept = () => {
+          accepted = true;
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
@@ -4769,15 +4783,28 @@ var DatabaseAPI = class {
           this.resubscribeAll();
           resolve();
         };
-        this.realtimeWs.onmessage = (event) => {
+        ws.onopen = () => {
+          ws.send(JSON.stringify({ type: "ping", timestamp: Date.now() }));
+        };
+        ws.onmessage = (event) => {
+          let msg;
           try {
-            const msg = JSON.parse(event.data);
-            this.handleRealtimeMessage(msg);
+            msg = JSON.parse(event.data);
           } catch {
             this.debugLog("Failed to parse realtime message");
+            return;
+          }
+          if (!accepted) {
+            const rejected = toRealtimeRejection(msg);
+            if (rejected) {
+              rejection = rejected;
+              return;
+            }
+            accept();
           }
+          this.handleRealtimeMessage(msg);
         };
-        this.realtimeWs.onclose = (event) => {
+        ws.onclose = (event) => {
           this.debugLog(
             `Database realtime disconnected (code=${event?.code}, reason=${event?.reason})`
           );
@@ -4786,12 +4813,25 @@ var DatabaseAPI = class {
           this.clearRealtimeAuthRetry();
           const notice = this.realtimeCloseNotice;
           this.realtimeCloseNotice = null;
+          const code = event?.code;
+          if (!accepted && code >= 4e3 && code <= 4999) {
+            const err = rejection ?? new RealtimeConnectionError({
+              code: event.reason || void 0,
+              closeCode: code
+            });
+            if (!settled) {
+              settled = true;
+              clearTimeout(connectTimeout);
+              reject(err);
+            }
+            this.handleRealtimeRejection(err);
+            return;
+          }
           if (!settled) {
             settled = true;
             clearTimeout(connectTimeout);
             reject(new Error("Connection closed during handshake"));
           }
-          const code = event?.code;
           if (this.realtimeOptions && this.realtimeState !== "disconnected" && (code === CLOSE_CODE_MEMBER_REVOKED || code === CLOSE_CODE_TOKEN_EXPIRED && !this.http.canRefreshMemberToken(
             this.realtimeOptions.accessToken
           ))) {
@@ -4809,7 +4849,7 @@ var DatabaseAPI = class {
             this.attemptRealtimeReconnect();
           }
         };
-        this.realtimeWs.onerror = () => {
+        ws.onerror = () => {
           this.debugLog("Database realtime error");
           this.realtimeOnError?.(new Error("WebSocket connection error"));
         };
@@ -4819,6 +4859,21 @@ var DatabaseAPI = class {
       }
     });
   }
+  /**
+   * 서버가 연결을 거부했다(티켓 발급 거부, 또는 reject_mode=close 로 받은 업그레이드 거부). cb.realtime 과 같은 규칙이다 —
+   * 다시 해서 될 거부(`retryable`: 일시 장애, 속도 제한, 동시접속 한도, 만료된 티켓)는 서버가 알려 준 시각(`retryAfterMs`)
+   * 이후로 재연결을 이어 가고, 아니면(자격증명, 멤버 폐기, 할당량) 멈추고 `onRealtimeError` 로 알린다. 재시도를 다 써도
+   * 거부되면 마지막 거부를 알린다.
+   */
+  handleRealtimeRejection(err) {
+    if (!this.realtimeOptions || this.realtimeState === "disconnected") return;
+    if (err.retryable) {
+      this.attemptRealtimeReconnect(err);
+      return;
+    }
+    this.setRealtimeState("disconnected");
+    this.realtimeOnError?.(err);
+  }
   /**
    * 서버에 subscribe 메시지를 보내고 서버 subscription_id를 반환하는 Promise
    */
@@ -4991,21 +5046,25 @@ var DatabaseAPI = class {
         break;
     }
   }
-  attemptRealtimeReconnect() {
+  /**
+   * 지수 백오프로 다시 붙는다. cause 는 이번 시도를 끝낸 서버의 거부다 — 알려 준 재시도 시각(`retryAfterMs`)보다 일찍 다시
+   * 하지 않고, 재시도를 다 쓰면 일반 오류 대신 그 거부를 알린다.
+   */
+  attemptRealtimeReconnect(cause) {
     const maxRetries = this.realtimeOptions?.maxRetries ?? 5;
     const retryInterval = this.realtimeOptions?.retryInterval ?? 1e3;
     if (this.realtimeRetryCount >= maxRetries) {
       this.setRealtimeState("disconnected");
       this.realtimeOnError?.(
-        new Error("Realtime connection lost. Max retries exceeded.")
+        cause ?? new Error("Realtime connection lost. Max retries exceeded.")
       );
       return;
     }
     this.setRealtimeState("connecting");
     this.realtimeRetryCount++;
-    const delay = Math.min(
-      retryInterval * 2 ** (this.realtimeRetryCount - 1),
-      3e4
+    const delay = Math.max(
+      Math.min(retryInterval * 2 ** (this.realtimeRetryCount - 1), 3e4),
+      cause?.retryAfterMs ?? 0
     );
     this.debugLog(
       `Reconnecting in ${delay}ms (attempt ${this.realtimeRetryCount}/${maxRetries})`
@@ -13497,8 +13556,8 @@ var SupportAPI = class {
   }
 };
 function detectSdkVersion() {
-  if ("6.14.0") {
-    return "6.14.0";
+  if ("6.15.0") {
+    return "6.15.0";
   }
   return "unknown";
 }

package/package.json

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