connectbase-client 3.14.0 → 3.14.2

package/dist/index.d.mts

@@ -6115,7 +6115,11 @@ declare class GameAPI {
     readonly config: GameConfigAPI;
     constructor(http: HttpClient, gameServerUrl?: string, appId?: string);
     /**
-     * 게임 룸 클라이언트 생성
+     * 게임 룸 클라이언트 생성.
+     *
+     * `appId` 는 `createClient({ appId })` 로 호출별 지정하거나, 생략 시 `new ConnectBase({ appId })`
+     * 의 전역 값을 사용한다. 둘 다 없으면 `connect()` 가 명확한 에러로 reject 한다 — 빈 appId 로
+     * `/v1/game//ws` 에 붙어 server 측이 SCRIPT_NOT_FOUND 로 깨지던 silent 회귀 차단 (NJB 019e2210).
      */
     createClient(config: Omit<GameClientConfig, 'gameServerUrl'>): GameRoom;
     /**
@@ -6149,6 +6153,7 @@ declare class GameAPI {
     downloadReplay(replayId: string): Promise<ArrayBuffer>;
     getReplayHighlights(replayId: string): Promise<ReplayHighlight[]>;
     private getHeaders;
+    private gameFetch;
     /**
      * matchqueue 에 ticket 등록.
      *

package/dist/index.d.ts

@@ -6115,7 +6115,11 @@ declare class GameAPI {
     readonly config: GameConfigAPI;
     constructor(http: HttpClient, gameServerUrl?: string, appId?: string);
     /**
-     * 게임 룸 클라이언트 생성
+     * 게임 룸 클라이언트 생성.
+     *
+     * `appId` 는 `createClient({ appId })` 로 호출별 지정하거나, 생략 시 `new ConnectBase({ appId })`
+     * 의 전역 값을 사용한다. 둘 다 없으면 `connect()` 가 명확한 에러로 reject 한다 — 빈 appId 로
+     * `/v1/game//ws` 에 붙어 server 측이 SCRIPT_NOT_FOUND 로 깨지던 silent 회귀 차단 (NJB 019e2210).
      */
     createClient(config: Omit<GameClientConfig, 'gameServerUrl'>): GameRoom;
     /**
@@ -6149,6 +6153,7 @@ declare class GameAPI {
     downloadReplay(replayId: string): Promise<ArrayBuffer>;
     getReplayHighlights(replayId: string): Promise<ReplayHighlight[]>;
     private getHeaders;
+    private gameFetch;
     /**
      * matchqueue 에 ticket 등록.
      *

package/dist/index.js

@@ -6382,6 +6382,12 @@ var GameRoom = class {
         resolve();
         return;
       }
+      if (!this.config.appId) {
+        reject(new Error(
+          "cb.game: appId is required to connect. Pass it to `new ConnectBase({ appId })` or per-client via `cb.game.createClient({ appId, clientId })`."
+        ));
+        return;
+      }
       const url = this.buildConnectionUrl(roomId);
       this.ws = new WebSocket(url);
       const onOpen = () => {
@@ -6636,8 +6642,10 @@ var GameRoom = class {
     if (this.config.accessToken) {
       params.set("token", this.config.accessToken);
     }
-    const appId = this.config.appId || "";
-    return `${wsUrl}/v1/game/${appId}/ws?${params.toString()}`;
+    if (!this.config.appId) {
+      throw new Error("cb.game: appId is required to build a game connection URL");
+    }
+    return `${wsUrl}/v1/game/${this.config.appId}/ws?${params.toString()}`;
   }
   send(type, data, msgId) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
@@ -6844,13 +6852,19 @@ var GameAPI = class {
     this.config = new GameConfigAPI(http, appId);
   }
   /**
-   * 게임 룸 클라이언트 생성
+   * 게임 룸 클라이언트 생성.
+   *
+   * `appId` 는 `createClient({ appId })` 로 호출별 지정하거나, 생략 시 `new ConnectBase({ appId })`
+   * 의 전역 값을 사용한다. 둘 다 없으면 `connect()` 가 명확한 에러로 reject 한다 — 빈 appId 로
+   * `/v1/game//ws` 에 붙어 server 측이 SCRIPT_NOT_FOUND 로 깨지던 silent 회귀 차단 (NJB 019e2210).
    */
   createClient(config) {
     return new GameRoom({
       ...config,
       gameServerUrl: this.gameServerUrl.replace(/^http/, "ws"),
-      appId: this.appId,
+      // per-call appId 가 있으면 그것을 우선 (없을 때만 전역 fallback). 이전엔 this.appId 가
+      // config.appId 를 무조건 덮어써서 호출별 지정이 불가능했다.
+      appId: config.appId ?? this.appId,
       publicKey: this.http.getPublicKey(),
       accessToken: this.http.getAccessToken()
     });
@@ -7025,6 +7039,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)
   //
@@ -7045,9 +7091,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"
     );
   }
   /**
@@ -7056,16 +7104,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"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -7081,47 +7135,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"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -7136,47 +7209,66 @@ 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"
     );
   }
   /**
@@ -7188,7 +7280,12 @@ var GameAPI = class {
    * `POST /scripts/:name/deactivate` 로 endpoint 이동. 메서드명도 의도 명확화 위해 rename.
    */
   async deactivateScript(appId, name) {
-    await this.http.post(`/v1/game/${appId}/scripts/${name}/deactivate`, {});
+    await this.gameFetch(
+      "POST",
+      `/v1/game/${appId}/scripts/${name}/deactivate`,
+      {},
+      "GAME_DEACTIVATE_SCRIPT_FAILED"
+    );
   }
   /**
    * 스크립트 영구 삭제 (hard-delete) — 메타 + 모든 버전 영구 제거. 복구 불가.
@@ -7200,7 +7297,12 @@ var GameAPI = class {
    * 변경된 것에 대응.
    */
   async deleteScript(appId, name) {
-    await this.http.delete(`/v1/game/${appId}/scripts/${name}`);
+    await this.gameFetch(
+      "DELETE",
+      `/v1/game/${appId}/scripts/${name}`,
+      void 0,
+      "GAME_DELETE_SCRIPT_FAILED"
+    );
   }
 };
 

package/dist/index.mjs

@@ -6339,6 +6339,12 @@ var GameRoom = class {
         resolve();
         return;
       }
+      if (!this.config.appId) {
+        reject(new Error(
+          "cb.game: appId is required to connect. Pass it to `new ConnectBase({ appId })` or per-client via `cb.game.createClient({ appId, clientId })`."
+        ));
+        return;
+      }
       const url = this.buildConnectionUrl(roomId);
       this.ws = new WebSocket(url);
       const onOpen = () => {
@@ -6593,8 +6599,10 @@ var GameRoom = class {
     if (this.config.accessToken) {
       params.set("token", this.config.accessToken);
     }
-    const appId = this.config.appId || "";
-    return `${wsUrl}/v1/game/${appId}/ws?${params.toString()}`;
+    if (!this.config.appId) {
+      throw new Error("cb.game: appId is required to build a game connection URL");
+    }
+    return `${wsUrl}/v1/game/${this.config.appId}/ws?${params.toString()}`;
   }
   send(type, data, msgId) {
     if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
@@ -6801,13 +6809,19 @@ var GameAPI = class {
     this.config = new GameConfigAPI(http, appId);
   }
   /**
-   * 게임 룸 클라이언트 생성
+   * 게임 룸 클라이언트 생성.
+   *
+   * `appId` 는 `createClient({ appId })` 로 호출별 지정하거나, 생략 시 `new ConnectBase({ appId })`
+   * 의 전역 값을 사용한다. 둘 다 없으면 `connect()` 가 명확한 에러로 reject 한다 — 빈 appId 로
+   * `/v1/game//ws` 에 붙어 server 측이 SCRIPT_NOT_FOUND 로 깨지던 silent 회귀 차단 (NJB 019e2210).
    */
   createClient(config) {
     return new GameRoom({
       ...config,
       gameServerUrl: this.gameServerUrl.replace(/^http/, "ws"),
-      appId: this.appId,
+      // per-call appId 가 있으면 그것을 우선 (없을 때만 전역 fallback). 이전엔 this.appId 가
+      // config.appId 를 무조건 덮어써서 호출별 지정이 불가능했다.
+      appId: config.appId ?? this.appId,
       publicKey: this.http.getPublicKey(),
       accessToken: this.http.getAccessToken()
     });
@@ -6982,6 +6996,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)
   //
@@ -7002,9 +7048,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"
     );
   }
   /**
@@ -7013,16 +7061,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"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -7038,47 +7092,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"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -7093,47 +7166,66 @@ 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"
     );
   }
   /**
@@ -7145,7 +7237,12 @@ var GameAPI = class {
    * `POST /scripts/:name/deactivate` 로 endpoint 이동. 메서드명도 의도 명확화 위해 rename.
    */
   async deactivateScript(appId, name) {
-    await this.http.post(`/v1/game/${appId}/scripts/${name}/deactivate`, {});
+    await this.gameFetch(
+      "POST",
+      `/v1/game/${appId}/scripts/${name}/deactivate`,
+      {},
+      "GAME_DEACTIVATE_SCRIPT_FAILED"
+    );
   }
   /**
    * 스크립트 영구 삭제 (hard-delete) — 메타 + 모든 버전 영구 제거. 복구 불가.
@@ -7157,7 +7254,12 @@ var GameAPI = class {
    * 변경된 것에 대응.
    */
   async deleteScript(appId, name) {
-    await this.http.delete(`/v1/game/${appId}/scripts/${name}`);
+    await this.gameFetch(
+      "DELETE",
+      `/v1/game/${appId}/scripts/${name}`,
+      void 0,
+      "GAME_DELETE_SCRIPT_FAILED"
+    );
   }
 };
 

package/package.json

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