connectbase-client 3.14.0 → 3.14.1

package/dist/index.d.mts

@@ -6149,6 +6149,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

@@ -6149,6 +6149,7 @@ declare class GameAPI {
     downloadReplay(replayId: string): Promise<ArrayBuffer>;
     getReplayHighlights(replayId: string): Promise<ReplayHighlight[]>;
     private getHeaders;
+    private gameFetch;
     /**
      * matchqueue 에 ticket 등록.
      *

package/dist/index.js

@@ -7025,6 +7025,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 +7077,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 +7090,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 +7121,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 +7195,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 +7266,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 +7283,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

@@ -6982,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)
   //
@@ -7002,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"
     );
   }
   /**
@@ -7013,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"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -7038,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"
     );
   }
   // ─────────────────────────────────────────────────────────────────────
@@ -7093,47 +7152,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 +7223,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 +7240,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.1",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",