connectbase-client 3.13.1 → 3.14.1

package/dist/index.mjs

@@ -14,6 +14,20 @@ var AuthError = class extends Error {
     this.name = "AuthError";
   }
 };
+var GameError = class extends Error {
+  constructor(init) {
+    super(init.message || init.code || "GameError");
+    this.name = "GameError";
+    this.code = init.code || "UNKNOWN";
+    this.phase = init.phase;
+    this.feature = init.feature;
+    this.roomId = init.roomId;
+    this.scriptId = init.scriptId;
+    this.originClientId = init.originClientId;
+    this.requested = init.requested;
+    this.available = init.available;
+  }
+};
 
 // src/core/abort.ts
 var DEFAULT_REQUEST_TIMEOUT_MS = 3e4;
@@ -6235,6 +6249,21 @@ var GameConfigAPI = class {
 };
 
 // src/api/game.ts
+function parseGameError(msg) {
+  const payload = msg.data ?? msg;
+  const get = (k) => payload[k];
+  return new GameError({
+    code: get("code") || msg.code,
+    message: get("message") || "Unknown error",
+    phase: get("phase") || msg.phase,
+    feature: get("feature") || msg.feature,
+    roomId: get("room_id") || msg.room_id,
+    scriptId: get("script_id") || msg.script_id,
+    originClientId: get("origin_client_id") || msg.origin_client_id,
+    requested: get("requested") || msg.requested,
+    available: get("available") || msg.available
+  });
+}
 var getDefaultGameServerUrl = () => {
   if (typeof window !== "undefined") {
     const hostname = window.location.hostname;
@@ -6264,6 +6293,8 @@ var GameRoom = class {
     this.actionSequence = 0;
     this._roomId = null;
     this._state = null;
+    this._scriptName = null;
+    this._scriptVersion = null;
     this._isConnected = false;
     this.msgIdCounter = 0;
     this.config = {
@@ -6353,21 +6384,48 @@ var GameRoom = class {
     }
     this._isConnected = false;
     this._roomId = null;
+    this._scriptName = null;
+    this._scriptVersion = null;
   }
   /**
-   * 룸 생성
+   * 룸 생성 (호환 시그니처) — 초기 상태만 반환.
+   *
+   * Attached script 의 검증(scriptName/scriptVersion echo 검사) 이 필요하면
+   * 인스턴스 getter (`room.scriptName`, `room.scriptVersion`) 를 함께 사용하거나,
+   * 메타까지 한 번에 받고 싶다면 {@link createRoomDetailed} 를 사용한다.
+   *
+   * 미존재/비활성 scriptName 은 서버가 `SCRIPT_NOT_FOUND` 로 즉시 reject 한다.
+   * reject 값은 `GameError` 인스턴스이며 `.code`/`.requested`/`.available` 로 분기 가능.
    */
   createRoom(config = {}) {
+    return this.createRoomDetailed(config).then((r) => r.state);
+  }
+  /**
+   * 룸 생성 + 메타 — server 가 attach 한 lua script 이름/버전을 함께 반환.
+   *
+   * @example
+   * const { state, scriptName, scriptVersion } = await room.createRoomDetailed({ scriptName: 'njb-main' })
+   * if (scriptName !== 'njb-main') throw new Error('script mismatch')
+   * console.log('attached', scriptName, 'v', scriptVersion)
+   */
+  createRoomDetailed(config = {}) {
     return new Promise((resolve, reject) => {
       const handler = (msg) => {
         if (msg.type === "room_created") {
           const data = msg.data;
           this._roomId = data.room_id;
           this._state = data.initial_state;
-          resolve(data.initial_state);
+          this._scriptName = data.script_name ?? null;
+          this._scriptVersion = data.script_version ?? null;
+          resolve({
+            roomId: data.room_id,
+            state: data.initial_state,
+            scriptName: data.script_name,
+            scriptVersion: data.script_version
+          });
           return true;
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
           return true;
         }
         return false;
@@ -6375,6 +6433,14 @@ var GameRoom = class {
       this.sendWithHandler("create_room", toCreateRoomWire(config), handler, 15e3, reject);
     });
   }
+  /** Attached lua script 이름 — createRoom 이후 server 가 echo 한 값. */
+  get scriptName() {
+    return this._scriptName;
+  }
+  /** Attached lua script 의 active version. */
+  get scriptVersion() {
+    return this._scriptVersion;
+  }
   /**
    * 룸 참가
    */
@@ -6385,10 +6451,12 @@ var GameRoom = class {
           const data = msg.data;
           this._roomId = data.room_id;
           this._state = data.initial_state;
+          this._scriptName = null;
+          this._scriptVersion = null;
           resolve(data.initial_state);
           return true;
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
           return true;
         }
         return false;
@@ -6402,17 +6470,19 @@ var GameRoom = class {
   leaveRoom() {
     return new Promise((resolve, reject) => {
       if (!this._roomId) {
-        reject(new Error("Not in a room"));
+        reject(new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" }));
         return;
       }
       const handler = (msg) => {
         if (msg.type === "room_left") {
           this._roomId = null;
           this._state = null;
+          this._scriptName = null;
+          this._scriptVersion = null;
           resolve();
           return true;
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
           return true;
         }
         return false;
@@ -6425,7 +6495,7 @@ var GameRoom = class {
    */
   sendAction(action) {
     if (!this._roomId) {
-      throw new Error("Not in a room");
+      throw new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" });
     }
     this.send("action", {
       type: action.type,
@@ -6439,7 +6509,7 @@ var GameRoom = class {
    */
   sendChat(message) {
     if (!this._roomId) {
-      throw new Error("Not in a room");
+      throw new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" });
     }
     this.send("chat", { message });
   }
@@ -6449,7 +6519,7 @@ var GameRoom = class {
   requestState() {
     return new Promise((resolve, reject) => {
       if (!this._roomId) {
-        reject(new Error("Not in a room"));
+        reject(new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" }));
         return;
       }
       const handler = (msg) => {
@@ -6459,7 +6529,7 @@ var GameRoom = class {
           resolve(state);
           return true;
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
           return true;
         }
         return false;
@@ -6478,7 +6548,7 @@ var GameRoom = class {
           resolve(data.rooms);
           return true;
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
           return true;
         }
         return false;
@@ -6500,7 +6570,7 @@ var GameRoom = class {
           resolve(rtt);
           return true;
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
           return true;
         }
         return false;
@@ -6558,12 +6628,12 @@ var GameRoom = class {
     this.ws?.addEventListener("message", messageHandler);
     timeoutId = setTimeout(() => {
       cleanup();
-      const err = new Error(`Request '${type}' timed out after ${timeoutMs}ms`);
-      onError?.(err);
-      this.handlers.onError?.({
+      const err = new GameError({
         code: "TIMEOUT",
-        message: err.message
+        message: `Request '${type}' timed out after ${timeoutMs}ms`
       });
+      onError?.(err);
+      this.handlers.onError?.(err);
     }, timeoutMs);
     try {
       this.send(type, data, msgId);
@@ -6597,10 +6667,7 @@ var GameRoom = class {
           });
           break;
         case "error":
-          this.handlers.onError?.({
-            code: msg.code || "UNKNOWN",
-            message: msg.message || "Unknown error"
-          });
+          this.handlers.onError?.(parseGameError(msg));
           break;
         default:
           break;
@@ -6678,10 +6745,10 @@ var GameRoom = class {
   scheduleReconnect(roomId) {
     if (this.reconnectAttempts >= (this.config.maxReconnectAttempts ?? 5)) {
       console.error("Max reconnect attempts reached");
-      this.handlers.onError?.({
+      this.handlers.onError?.(new GameError({
         code: "MAX_RECONNECT_ATTEMPTS",
         message: "Maximum reconnection attempts reached"
-      });
+      }));
       return;
     }
     const delay = Math.min(
@@ -6702,10 +6769,11 @@ var GameRoom = class {
             console.log(`Successfully rejoined room ${previousRoomId}`);
           } catch (rejoinError) {
             console.error(`Failed to rejoin room ${previousRoomId}:`, rejoinError);
-            this.handlers.onError?.({
+            this.handlers.onError?.(new GameError({
               code: "REJOIN_FAILED",
-              message: `Failed to rejoin room: ${rejoinError}`
-            });
+              message: `Failed to rejoin room: ${rejoinError}`,
+              roomId: previousRoomId
+            }));
           }
         }
       } catch {
@@ -6914,6 +6982,38 @@ var GameAPI = class {
     }
     return headers;
   }
+  // game-server (`game.connectbase.world`) 전용 fetch.
+  //
+  // 회귀 가드 (v3.14.1, NJB report 2026-05-14): matchqueue / leaderboard / scripts 16개
+  // 메서드가 v3.0.0 BREAKING 이후 `this.http.*` 를 통해 기본 baseUrl (=core-server,
+  // `api.connectbase.world`) 로 라우팅되면서 404 회귀. 호스트 분리된 game-server 경로는
+  // 반드시 `this.gameServerUrl` 을 사용해야 한다. 회귀 재발 방지 테스트:
+  // test/game-host-routing.test.ts.
+  async gameFetch(method, path, body, errCode = "GAME_REQUEST_FAILED") {
+    const init = { method, headers: { ...this.getHeaders() } };
+    if (body !== void 0) {
+      init.headers["Content-Type"] = "application/json";
+      init.body = JSON.stringify(body);
+    }
+    const response = await fetch(`${this.gameServerUrl}${path}`, init);
+    if (!response.ok) {
+      let serverCode = errCode;
+      let message = `${method} ${path} failed: ${response.statusText}`;
+      try {
+        const data = await response.json();
+        if (data && typeof data.error === "string") {
+          message = data.error;
+          serverCode = data.error;
+        }
+      } catch {
+      }
+      throw new ApiError(response.status, message, serverCode);
+    }
+    if (response.status === 204) return void 0;
+    const contentType = response.headers.get("content-type") || "";
+    if (!contentType.includes("application/json")) return void 0;
+    return response.json();
+  }
   // ─────────────────────────────────────────────────────────────────────
   // Phase 3 — Matchqueue primitive (mechanism only)
   //
@@ -6934,9 +7034,11 @@ var GameAPI = class {
    * @constraints appId/queueKey/ticketId 는 [a-zA-Z0-9_-] 만 허용. ttlSec=0 이면 만료 없음.
    */
   async enqueueMatch(appId, queueKey, ticketId, attributes, ttlSec) {
-    return this.http.post(
+    return this.gameFetch(
+      "POST",
       `/v1/game/${appId}/matchqueue/${queueKey}/tickets`,
-      { ticket_id: ticketId, attributes, ttl_sec: ttlSec ?? 0 }
+      { ticket_id: ticketId, attributes, ttl_sec: ttlSec ?? 0 },
+      "GAME_ENQUEUE_MATCH_FAILED"
     );
   }
   /**
@@ -6945,16 +7047,22 @@ var GameAPI = class {
    * @example const tickets = await cb.game.listMatchqueue(appId, "ranked")
    */
   async listMatchqueue(appId, queueKey) {
-    return this.http.get(
-      `/v1/game/${appId}/matchqueue/${queueKey}`
+    return this.gameFetch(
+      "GET",
+      `/v1/game/${appId}/matchqueue/${queueKey}`,
+      void 0,
+      "GAME_LIST_MATCHQUEUE_FAILED"
     );
   }
   /**
    * 매칭 큐에서 ticket 제거 (예: 사용자가 매칭 취소).
    */
   async cancelMatch(appId, queueKey, ticketId) {
-    await this.http.delete(
-      `/v1/game/${appId}/matchqueue/${queueKey}/tickets/${ticketId}`
+    await this.gameFetch(
+      "DELETE",
+      `/v1/game/${appId}/matchqueue/${queueKey}/tickets/${ticketId}`,
+      void 0,
+      "GAME_CANCEL_MATCH_FAILED"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -6970,47 +7078,66 @@ var GameAPI = class {
    * await cb.game.submitScore(appId, "global_elo", userId, 32, "incr")
    */
   async submitScore(appId, leaderboardKey, member, score, mode = "set") {
-    return this.http.post(
+    return this.gameFetch(
+      "POST",
       `/v1/game/${appId}/leaderboards/${leaderboardKey}/scores`,
-      { member, score, mode }
+      { member, score, mode },
+      "GAME_SUBMIT_SCORE_FAILED"
     );
   }
   /**
    * 상위 n 명 조회 (기본 10).
    */
   async getTopScores(appId, leaderboardKey, n = 10) {
-    return this.http.get(
-      `/v1/game/${appId}/leaderboards/${leaderboardKey}/top?n=${n}`
+    return this.gameFetch(
+      "GET",
+      `/v1/game/${appId}/leaderboards/${leaderboardKey}/top?n=${n}`,
+      void 0,
+      "GAME_GET_TOP_SCORES_FAILED"
     );
   }
   /**
    * 단일 member 의 rank + score.
    */
   async getMemberRank(appId, leaderboardKey, member) {
-    return this.http.get(
-      `/v1/game/${appId}/leaderboards/${leaderboardKey}/members/${member}`
+    return this.gameFetch(
+      "GET",
+      `/v1/game/${appId}/leaderboards/${leaderboardKey}/members/${member}`,
+      void 0,
+      "GAME_GET_MEMBER_RANK_FAILED"
     );
   }
   /**
    * member 주변 (위 above 명 + 본인 + 아래 below 명) 조회.
    */
   async getRankAround(appId, leaderboardKey, member, above = 5, below = 5) {
-    return this.http.get(
-      `/v1/game/${appId}/leaderboards/${leaderboardKey}/around/${member}?above=${above}&below=${below}`
+    return this.gameFetch(
+      "GET",
+      `/v1/game/${appId}/leaderboards/${leaderboardKey}/around/${member}?above=${above}&below=${below}`,
+      void 0,
+      "GAME_GET_RANK_AROUND_FAILED"
     );
   }
   /**
    * leaderboard 전체 reset (시즌 종료 시).
    */
   async resetLeaderboard(appId, leaderboardKey) {
-    await this.http.delete(`/v1/game/${appId}/leaderboards/${leaderboardKey}`);
+    await this.gameFetch(
+      "DELETE",
+      `/v1/game/${appId}/leaderboards/${leaderboardKey}`,
+      void 0,
+      "GAME_RESET_LEADERBOARD_FAILED"
+    );
   }
   /**
    * 특정 member 만 제거 (계정 삭제 등).
    */
   async removeFromLeaderboard(appId, leaderboardKey, member) {
-    await this.http.delete(
-      `/v1/game/${appId}/leaderboards/${leaderboardKey}/members/${member}`
+    await this.gameFetch(
+      "DELETE",
+      `/v1/game/${appId}/leaderboards/${leaderboardKey}/members/${member}`,
+      void 0,
+      "GAME_REMOVE_FROM_LEADERBOARD_FAILED"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -7025,54 +7152,100 @@ var GameAPI = class {
    * await cb.game.uploadScript(appId, "ranked_br", fs.readFileSync("./ranked.lua", "utf-8"))
    */
   async uploadScript(appId, name, code) {
-    return this.http.post(
+    return this.gameFetch(
+      "POST",
       `/v1/game/${appId}/scripts`,
-      { name, code }
+      { name, code },
+      "GAME_UPLOAD_SCRIPT_FAILED"
     );
   }
   /**
    * app 의 모든 스크립트 메타데이터 목록.
    */
   async listScripts(appId) {
-    return this.http.get(`/v1/game/${appId}/scripts`);
+    return this.gameFetch(
+      "GET",
+      `/v1/game/${appId}/scripts`,
+      void 0,
+      "GAME_LIST_SCRIPTS_FAILED"
+    );
   }
   /**
    * 단일 스크립트 메타 + active version code.
    */
   async getScript(appId, name) {
-    return this.http.get(`/v1/game/${appId}/scripts/${name}`);
+    return this.gameFetch(
+      "GET",
+      `/v1/game/${appId}/scripts/${name}`,
+      void 0,
+      "GAME_GET_SCRIPT_FAILED"
+    );
   }
   /**
    * 단일 스크립트의 모든 버전 이력.
    */
   async listScriptVersions(appId, name) {
-    return this.http.get(
-      `/v1/game/${appId}/scripts/${name}/versions`
+    return this.gameFetch(
+      "GET",
+      `/v1/game/${appId}/scripts/${name}/versions`,
+      void 0,
+      "GAME_LIST_SCRIPT_VERSIONS_FAILED"
     );
   }
   /**
    * 특정 버전 활성화 (hot reload 자동). version=0 또는 미지정 → latest 활성화.
    */
   async activateScript(appId, name, version) {
-    return this.http.post(
+    return this.gameFetch(
+      "POST",
       `/v1/game/${appId}/scripts/${name}/activate`,
-      { version: version ?? 0 }
+      { version: version ?? 0 },
+      "GAME_ACTIVATE_SCRIPT_FAILED"
     );
   }
   /**
    * 직전 active 버전으로 롤백 (hot reload 자동).
    */
   async rollbackScript(appId, name) {
-    return this.http.post(
+    return this.gameFetch(
+      "POST",
       `/v1/game/${appId}/scripts/${name}/rollback`,
-      {}
+      {},
+      "GAME_ROLLBACK_SCRIPT_FAILED"
     );
   }
   /**
-   * 스크립트 비활성화 (status=disabled). 코드/버전은 보존.
+   * 스크립트 비활성화 (status=disabled, ActiveVersion=0). 코드/모든 버전은 보존되며
+   * 이후 {@link activateScript} 로 재활성화할 수 있다.
+   *
+   * v3.14.0 BREAKING — 이전엔 `disableScript` 가 `DELETE /scripts/:name` 을 호출해
+   * Disable 매핑이었으나, server 측 `DELETE` 가 hard-delete 로 분리됨에 따라
+   * `POST /scripts/:name/deactivate` 로 endpoint 이동. 메서드명도 의도 명확화 위해 rename.
    */
-  async disableScript(appId, name) {
-    await this.http.delete(`/v1/game/${appId}/scripts/${name}`);
+  async deactivateScript(appId, name) {
+    await this.gameFetch(
+      "POST",
+      `/v1/game/${appId}/scripts/${name}/deactivate`,
+      {},
+      "GAME_DEACTIVATE_SCRIPT_FAILED"
+    );
+  }
+  /**
+   * 스크립트 영구 삭제 (hard-delete) — 메타 + 모든 버전 영구 제거. 복구 불가.
+   *
+   * 잘못 업로드된 스크립트나 더 이상 사용하지 않는 슬롯을 정리할 때 사용. 단순 비활성화는
+   * {@link deactivateScript} 를 사용한다 (코드 보존, 재활성화 가능).
+   *
+   * v3.14.0 신규 — server 측 `DELETE /scripts/:name` 의 의미가 Disable → hard-delete 로
+   * 변경된 것에 대응.
+   */
+  async deleteScript(appId, name) {
+    await this.gameFetch(
+      "DELETE",
+      `/v1/game/${appId}/scripts/${name}`,
+      void 0,
+      "GAME_DELETE_SCRIPT_FAILED"
+    );
   }
 };
 
@@ -9378,7 +9551,7 @@ var WebTransportTransport = class {
   }
   send(data, reliable = true) {
     if (!this.transport) {
-      throw new Error("Not connected");
+      throw new GameError({ code: "NOT_CONNECTED", message: "Not connected" });
     }
     const bytes = typeof data === "string" ? new TextEncoder().encode(data) : data;
     if (reliable) {
@@ -9469,7 +9642,7 @@ var WebSocketTransport = class {
   }
   send(data, _reliable) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
-      throw new Error("Not connected");
+      throw new GameError({ code: "NOT_CONNECTED", message: "Not connected" });
     }
     if (typeof data === "string") {
       this.ws.send(data);
@@ -9494,6 +9667,8 @@ var GameRoomTransport = class {
     this.actionSequence = 0;
     this._roomId = null;
     this._state = null;
+    this._scriptName = null;
+    this._scriptVersion = null;
     this._isConnected = false;
     this._connectionStatus = "disconnected";
     this._lastError = null;
@@ -9546,6 +9721,14 @@ var GameRoomTransport = class {
   get isConnected() {
     return this._isConnected;
   }
+  /** Attached lua script 이름 — createRoom 이후 server 가 echo 한 값. */
+  get scriptName() {
+    return this._scriptName;
+  }
+  /** Attached lua script 의 active version. */
+  get scriptVersion() {
+    return this._scriptVersion;
+  }
   /**
    * Connection state information
    */
@@ -9598,7 +9781,7 @@ var GameRoomTransport = class {
     const onError = (error) => {
       this._connectionStatus = "error";
       this._lastError = error;
-      this.handlers.onError?.({ code: "CONNECTION_ERROR", message: error.message });
+      this.handlers.onError?.(new GameError({ code: "CONNECTION_ERROR", message: error.message }));
     };
     if (useWebTransport) {
       try {
@@ -9660,18 +9843,35 @@ var GameRoomTransport = class {
     this._state = null;
   }
   /**
-   * Create a new room
+   * Create a new room (호환 시그니처) — 초기 상태만 반환.
+   *
+   * Attached script 메타가 필요하면 {@link createRoomDetailed} 또는 인스턴스 getter
+   * (`transport.scriptName`, `transport.scriptVersion`) 를 사용.
    */
   async createRoom(config = {}) {
+    const r = await this.createRoomDetailed(config);
+    return r.state;
+  }
+  /**
+   * Create a new room — server 가 attach 한 lua script 메타 함께 반환.
+   */
+  async createRoomDetailed(config = {}) {
     return new Promise((resolve, reject) => {
       const handler = (msg) => {
         if (msg.type === "room_created") {
           const data = msg.data;
           this._roomId = data.room_id;
           this._state = data.initial_state;
-          resolve(data.initial_state);
+          this._scriptName = data.script_name ?? null;
+          this._scriptVersion = data.script_version ?? null;
+          resolve({
+            roomId: data.room_id,
+            state: data.initial_state,
+            scriptName: data.script_name,
+            scriptVersion: data.script_version
+          });
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
         }
       };
       this.sendWithHandler("create_room", toCreateRoomWire(config), handler);
@@ -9687,9 +9887,11 @@ var GameRoomTransport = class {
           const data = msg.data;
           this._roomId = data.room_id;
           this._state = data.initial_state;
+          this._scriptName = null;
+          this._scriptVersion = null;
           resolve(data.initial_state);
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
         }
       };
       this.sendWithHandler("join_room", { room_id: roomId, metadata }, handler);
@@ -9701,16 +9903,18 @@ var GameRoomTransport = class {
   async leaveRoom() {
     return new Promise((resolve, reject) => {
       if (!this._roomId) {
-        reject(new Error("Not in a room"));
+        reject(new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" }));
         return;
       }
       const handler = (msg) => {
         if (msg.type === "room_left") {
           this._roomId = null;
           this._state = null;
+          this._scriptName = null;
+          this._scriptVersion = null;
           resolve();
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
         }
       };
       this.sendWithHandler("leave_room", {}, handler);
@@ -9722,7 +9926,7 @@ var GameRoomTransport = class {
    */
   sendAction(action, reliable = false) {
     if (!this._roomId) {
-      throw new Error("Not in a room");
+      throw new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" });
     }
     const message = JSON.stringify({
       type: "action",
@@ -9741,7 +9945,7 @@ var GameRoomTransport = class {
    */
   sendChat(message) {
     if (!this._roomId) {
-      throw new Error("Not in a room");
+      throw new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" });
     }
     this.send("chat", { message });
   }
@@ -9751,7 +9955,7 @@ var GameRoomTransport = class {
   async requestState() {
     return new Promise((resolve, reject) => {
       if (!this._roomId) {
-        reject(new Error("Not in a room"));
+        reject(new GameError({ code: "NOT_IN_ROOM", message: "Not in a room" }));
         return;
       }
       const handler = (msg) => {
@@ -9760,7 +9964,7 @@ var GameRoomTransport = class {
           this._state = state;
           resolve(state);
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
         }
       };
       this.sendWithHandler("get_state", {}, handler);
@@ -9780,7 +9984,7 @@ var GameRoomTransport = class {
           this.handlers.onPong?.(pong);
           resolve(rtt);
         } else if (msg.type === "error") {
-          reject(new Error(msg.data.message));
+          reject(parseGameError(msg));
         }
       };
       this.sendWithHandler("ping", { timestamp }, handler);
@@ -9789,7 +9993,7 @@ var GameRoomTransport = class {
   // Private methods
   send(type, data) {
     if (!this.transport?.isConnected()) {
-      throw new Error("Not connected");
+      throw new GameError({ code: "NOT_CONNECTED", message: "Not connected" });
     }
     const message = JSON.stringify({ type, data });
     this.transport.send(message, true);
@@ -9832,14 +10036,7 @@ var GameRoomTransport = class {
           });
           break;
         case "error":
-          this.handlers.onError?.({
-            code: msg.code || "UNKNOWN",
-            message: msg.message || "Unknown error",
-            phase: msg.phase,
-            feature: msg.feature,
-            roomId: msg.room_id,
-            scriptId: msg.script_id
-          });
+          this.handlers.onError?.(parseGameError(msg));
           break;
         case "room_stale":
           if (this.handlers.onRoomStale) {
@@ -10049,6 +10246,7 @@ export {
   EndpointAPI,
   GameAPI,
   GameConfigAPI,
+  GameError,
   GameRoom,
   GameRoomTransport,
   NativeAPI,