connectbase-client 3.16.0 → 3.16.1

package/dist/index.d.mts

@@ -5585,20 +5585,24 @@ interface ChatMessage {
 /**
  * GameErrorCode — game-server 가 surface 하는 에러 코드 literal union.
  *
- * - `SCRIPT_NOT_FOUND` : createRoom 의 scriptName 이 미존재/비활성. 응답에 requested + available 동봉.
- * - `NO_ACTION_HANDLER`: action 의 type 에 대응하는 lua handler 미정의 (`onAction` 또는 `handlers[type]`).
- * - `FEATURE_DISABLED` : entity/matchqueue/leaderboard 등 opt-in feature 가 OFF. feature 필드로 분기.
- * - `SCRIPT_ERROR`     : lua 실행 중 일반 에러 (분류되지 않은 throw / runtime error).
- * - `SCRIPT_TIMEOUT`   : Lua hook 의 context deadline 초과 (기본 100ms).
- * - `RATE_LIMITED`     : per-app script rate limit 초과 (`SCRIPT_RATE_PER_SEC`).
- * - `QUOTA_EXCEEDED`   : plan 한도(`script_executions/month`) 초과.
- * - `TIMEOUT`          : SDK 측 sendWithHandler timeout (서버 응답 없음).
- * - `UNKNOWN`          : 분류되지 않은 server 에러 (server 에 신규 코드가 생겼는데 SDK 미반영).
+ * - `SCRIPT_NOT_FOUND`     : createRoom 의 scriptName 이 미존재/비활성. 응답에 requested + available 동봉.
+ * - `NO_ACTION_HANDLER`    : action 의 type 에 대응하는 lua handler 미정의 (`onAction` 또는 `handlers[type]`).
+ * - `FEATURE_DISABLED`     : entity/matchqueue/leaderboard 등 opt-in feature 가 OFF. feature 필드로 분기.
+ * - `SCRIPT_ERROR`         : lua 실행 중 일반 에러 (분류되지 않은 throw / runtime error).
+ * - `SCRIPT_TIMEOUT`       : 사용자 hook code 의 context deadline 초과 (기본 100ms). hook 본문이 느림.
+ * - `SCRIPT_SETUP_OVERRUN` : hook 호출 *전* 플랫폼 측 setup phase (스크립트 로드 + state 직렬화 + API 주입) 가
+ *                            setupBudget(기본 100ms / onInit 1s) 초과. 일반적으로 룸 state 가 너무 큼.
+ *                            해결: state 의 큰 데이터를 entity primitive 로 이전, state.dbg.* 누적 중단.
+ *                            issue 019e2c29 후 도입 (2026-05-16).
+ * - `RATE_LIMITED`         : per-app script rate limit 초과 (`SCRIPT_RATE_PER_SEC`).
+ * - `QUOTA_EXCEEDED`       : plan 한도(`script_executions/month`) 초과.
+ * - `TIMEOUT`              : SDK 측 sendWithHandler timeout (서버 응답 없음).
+ * - `UNKNOWN`              : 분류되지 않은 server 에러 (server 에 신규 코드가 생겼는데 SDK 미반영).
  *
  * literal autocomplete 를 유지하면서 미래에 server 가 신규 코드를 추가해도 타입 에러가
  * 안 나도록 `string & {}` 도 union 에 포함 (TypeScript 'string literal type widening' 우회 패턴).
  */
-type GameErrorCode = 'SCRIPT_NOT_FOUND' | 'NO_ACTION_HANDLER' | 'FEATURE_DISABLED' | 'SCRIPT_ERROR' | 'SCRIPT_TIMEOUT' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'TIMEOUT' | 'UNKNOWN' | (string & {});
+type GameErrorCode = 'SCRIPT_NOT_FOUND' | 'NO_ACTION_HANDLER' | 'FEATURE_DISABLED' | 'SCRIPT_ERROR' | 'SCRIPT_TIMEOUT' | 'SCRIPT_SETUP_OVERRUN' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'TIMEOUT' | 'UNKNOWN' | (string & {});
 /**
  * 에러 메시지 — server `error` 메시지의 wire format. SDK 사용자에게는 GameError
  * 인스턴스(class)로 surface 되지만, 본 인터페이스는 raw payload 매핑 + 타입 추론용.

package/dist/index.d.ts

@@ -5585,20 +5585,24 @@ interface ChatMessage {
 /**
  * GameErrorCode — game-server 가 surface 하는 에러 코드 literal union.
  *
- * - `SCRIPT_NOT_FOUND` : createRoom 의 scriptName 이 미존재/비활성. 응답에 requested + available 동봉.
- * - `NO_ACTION_HANDLER`: action 의 type 에 대응하는 lua handler 미정의 (`onAction` 또는 `handlers[type]`).
- * - `FEATURE_DISABLED` : entity/matchqueue/leaderboard 등 opt-in feature 가 OFF. feature 필드로 분기.
- * - `SCRIPT_ERROR`     : lua 실행 중 일반 에러 (분류되지 않은 throw / runtime error).
- * - `SCRIPT_TIMEOUT`   : Lua hook 의 context deadline 초과 (기본 100ms).
- * - `RATE_LIMITED`     : per-app script rate limit 초과 (`SCRIPT_RATE_PER_SEC`).
- * - `QUOTA_EXCEEDED`   : plan 한도(`script_executions/month`) 초과.
- * - `TIMEOUT`          : SDK 측 sendWithHandler timeout (서버 응답 없음).
- * - `UNKNOWN`          : 분류되지 않은 server 에러 (server 에 신규 코드가 생겼는데 SDK 미반영).
+ * - `SCRIPT_NOT_FOUND`     : createRoom 의 scriptName 이 미존재/비활성. 응답에 requested + available 동봉.
+ * - `NO_ACTION_HANDLER`    : action 의 type 에 대응하는 lua handler 미정의 (`onAction` 또는 `handlers[type]`).
+ * - `FEATURE_DISABLED`     : entity/matchqueue/leaderboard 등 opt-in feature 가 OFF. feature 필드로 분기.
+ * - `SCRIPT_ERROR`         : lua 실행 중 일반 에러 (분류되지 않은 throw / runtime error).
+ * - `SCRIPT_TIMEOUT`       : 사용자 hook code 의 context deadline 초과 (기본 100ms). hook 본문이 느림.
+ * - `SCRIPT_SETUP_OVERRUN` : hook 호출 *전* 플랫폼 측 setup phase (스크립트 로드 + state 직렬화 + API 주입) 가
+ *                            setupBudget(기본 100ms / onInit 1s) 초과. 일반적으로 룸 state 가 너무 큼.
+ *                            해결: state 의 큰 데이터를 entity primitive 로 이전, state.dbg.* 누적 중단.
+ *                            issue 019e2c29 후 도입 (2026-05-16).
+ * - `RATE_LIMITED`         : per-app script rate limit 초과 (`SCRIPT_RATE_PER_SEC`).
+ * - `QUOTA_EXCEEDED`       : plan 한도(`script_executions/month`) 초과.
+ * - `TIMEOUT`              : SDK 측 sendWithHandler timeout (서버 응답 없음).
+ * - `UNKNOWN`              : 분류되지 않은 server 에러 (server 에 신규 코드가 생겼는데 SDK 미반영).
  *
  * literal autocomplete 를 유지하면서 미래에 server 가 신규 코드를 추가해도 타입 에러가
  * 안 나도록 `string & {}` 도 union 에 포함 (TypeScript 'string literal type widening' 우회 패턴).
  */
-type GameErrorCode = 'SCRIPT_NOT_FOUND' | 'NO_ACTION_HANDLER' | 'FEATURE_DISABLED' | 'SCRIPT_ERROR' | 'SCRIPT_TIMEOUT' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'TIMEOUT' | 'UNKNOWN' | (string & {});
+type GameErrorCode = 'SCRIPT_NOT_FOUND' | 'NO_ACTION_HANDLER' | 'FEATURE_DISABLED' | 'SCRIPT_ERROR' | 'SCRIPT_TIMEOUT' | 'SCRIPT_SETUP_OVERRUN' | 'RATE_LIMITED' | 'QUOTA_EXCEEDED' | 'TIMEOUT' | 'UNKNOWN' | (string & {});
 /**
  * 에러 메시지 — server `error` 메시지의 wire format. SDK 사용자에게는 GameError
  * 인스턴스(class)로 surface 되지만, 본 인터페이스는 raw payload 매핑 + 타입 추론용.

package/package.json

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