connectbase-client 3.13.0 → 3.14.0

package/dist/index.js

@@ -29,6 +29,7 @@ __export(index_exports, {
   EndpointAPI: () => EndpointAPI,
   GameAPI: () => GameAPI,
   GameConfigAPI: () => GameConfigAPI,
+  GameError: () => GameError,
   GameRoom: () => GameRoom,
   GameRoomTransport: () => GameRoomTransport,
   NativeAPI: () => NativeAPI,
@@ -56,6 +57,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;
@@ -6277,6 +6292,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;
@@ -6306,6 +6336,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 = {
@@ -6395,21 +6427,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;
@@ -6417,6 +6476,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;
+  }
   /**
    * 룸 참가
    */
@@ -6427,10 +6494,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;
@@ -6444,17 +6513,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;
@@ -6467,7 +6538,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,
@@ -6481,7 +6552,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 });
   }
@@ -6491,7 +6562,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) => {
@@ -6501,7 +6572,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;
@@ -6520,7 +6591,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;
@@ -6542,7 +6613,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;
@@ -6600,12 +6671,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);
@@ -6639,10 +6710,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;
@@ -6720,10 +6788,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(
@@ -6744,10 +6812,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 {
@@ -7111,9 +7180,26 @@ var GameAPI = class {
     );
   }
   /**
-   * 스크립트 비활성화 (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 deactivateScript(appId, name) {
+    await this.http.post(`/v1/game/${appId}/scripts/${name}/deactivate`, {});
+  }
+  /**
+   * 스크립트 영구 삭제 (hard-delete) — 메타 + 모든 버전 영구 제거. 복구 불가.
+   *
+   * 잘못 업로드된 스크립트나 더 이상 사용하지 않는 슬롯을 정리할 때 사용. 단순 비활성화는
+   * {@link deactivateScript} 를 사용한다 (코드 보존, 재활성화 가능).
+   *
+   * v3.14.0 신규 — server 측 `DELETE /scripts/:name` 의 의미가 Disable → hard-delete 로
+   * 변경된 것에 대응.
    */
-  async disableScript(appId, name) {
+  async deleteScript(appId, name) {
     await this.http.delete(`/v1/game/${appId}/scripts/${name}`);
   }
 };
@@ -9420,7 +9506,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) {
@@ -9511,7 +9597,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);
@@ -9536,6 +9622,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;
@@ -9588,6 +9676,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
    */
@@ -9640,7 +9736,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 {
@@ -9702,18 +9798,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);
@@ -9729,9 +9842,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);
@@ -9743,16 +9858,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);
@@ -9764,7 +9881,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",
@@ -9783,7 +9900,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 });
   }
@@ -9793,7 +9910,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) => {
@@ -9802,7 +9919,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);
@@ -9822,7 +9939,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);
@@ -9831,7 +9948,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);
@@ -9874,14 +9991,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) {
@@ -10092,6 +10202,7 @@ var index_default = ConnectBase;
   EndpointAPI,
   GameAPI,
   GameConfigAPI,
+  GameError,
   GameRoom,
   GameRoomTransport,
   NativeAPI,