connectbase-client 5.7.0 → 5.9.0

package/CHANGELOG.md

@@ -3,6 +3,69 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [5.9.0] - 2026-08-02
+
+### Fixed — `_redirects` / `_headers` 가 배포되지 않던 것
+
+`connectbase deploy` 가 `_redirects` 와 `_headers` 를 **조용히 건너뛰고 있었다**. 배포 대상
+판정이 확장자만 봤는데 이 둘은 확장자가 없어(`path.extname()` 이 빈 문자열) 허용목록에
+걸리지 않았다.
+
+두 파일은 플랫폼이 사이트 설정으로 읽는 파일이다 — `_redirects` 는 경로 매핑(프리렌더
+경로를 실제 HTML 로 연결), `_headers` 는 커스텀 응답 헤더. 즉 기능은 지원되는데 업로드
+경로만 비어 있었다. 그래서 배포 스크립트가 `deploy` 직후 MCP `write_file` 로 이 파일들을
+따로 얹는 우회가 관행이 됐다.
+
+```bash
+# 이제 dist 에 두기만 하면 함께 올라간다
+echo "/blog  /blog.html  200" > dist/_redirects
+npx connectbase deploy ./dist
+```
+
+- `_redirects`, `_headers` 만 이름 완전일치로 허용한다. `Dockerfile`·`Makefile`·`LICENSE`
+  같은 다른 확장자 없는 파일은 계속 제외된다 (공개 사이트에 소스가 실리면 안 되므로).
+- 두 파일은 `text/plain; charset=utf-8` 로 업로드된다.
+
+플랫폼 이슈 `019fc195` 의 SDK 측 대응. 같은 이슈에서 MCP `write_file` 자체가 프로덕션에서
+전부 실패하던 결함도 함께 고쳐졌다(서버 측, 별도 배포).
+
+## [5.8.0] - 2026-08-02
+
+### Fixed — `sync_lost` 재동기화: 설계만 있고 한 번도 돌지 않던 복구 경로
+
+game-server 는 클라이언트 송신 버퍼가 넘쳐 delta 를 버리면 `sync_lost` 를 보내고,
+규약상 클라이언트가 `get_state` 로 전체 상태를 다시 받아 기준점을 맞추게 돼 있다.
+그런데 **이 메시지를 처리하는 분기가 SDK 에 없었다** — 타입에는 선언돼 있어서 더
+그럴듯했지만, `GameRoom` 의 switch 에는 없어 `onMessage`(커스텀 메시지) 로 흘렀다.
+
+delta 는 직전 상태에 누적 적용되므로 하나만 놓쳐도 이후 상태가 계속 어긋난다. 즉
+문서화된 desync 복구가 실제로는 한 번도 동작한 적이 없었다.
+
+```ts
+// 별도 설정 없이 동작한다. 복구된 상태는 평소처럼 onStateUpdate 로 온다.
+room.on("onSyncLost", ({ tick, hint }) => setResyncing(true)); // 선택 — 로딩 표시용
+```
+
+- `sync_lost` 수신 시 자동으로 전체 상태를 재요청한다. 서버는 버퍼가 계속 막혀 있으면
+  tick 마다(60Hz) 재시도하므로, in-flight 가드 + 최소 1초 간격으로 억제했다 — 안 그러면
+  이미 혼잡한 연결에 전체 상태 전송이 겹쳐 혼잡을 키운다.
+- `onSyncLost` 핸들러와 `SyncLostMessage` 타입 신설. **복구는 SDK 가 하므로 게임 쪽에서
+  할 일은 없다** — 이 콜백은 로딩 표시나 계측용이다.
+- `room_stale` 도 `GameRoom` 에서 발화한다. `onRoomStale` 핸들러와 `RoomStaleMessage`
+  타입이 이미 있었는데 다른 transport 모듈에만 배선돼 있어 실제 클라이언트에서는 죽어
+  있었다. 두 타입 모두 패키지 루트에서 export 한다.
+
+### Fixed — 연결 URL 이 조용히 깨지던 두 경로
+
+- `appId` 누락 시 `/v1/game//ws`(빈 path 세그먼트)를 만들던 문제. `GameRoom` 에는 이미
+  가드가 있었는데 transport 모듈만 `|| ""` 로 넘기고 있었고, 프로덕션 로그에 실제로
+  `GET /v1/game//ws?client_id=undefined` 가 찍혔다. 이제 명확한 에러로 즉시 실패한다.
+- `clientId` 누락 시 서버에 `client_id=undefined` 라는 그럴듯한 가짜 ID 가 가던 문제.
+  `URLSearchParams.set` 이 undefined 를 문자열 `"undefined"` 로 넣기 때문으로, 타입이
+  `string` 이라 컴파일은 통과하지만 JS 소비자에서는 실제로 비어서 들어온다.
+
+기존 API 변경 없음(추가만).
+
 ## [5.7.0] - 2026-08-01
 
 ### Added — `getScriptLogs` / `getScriptMetrics`: 서버 Lua 를 디버깅할 수 있다

package/dist/cli.js

@@ -220,6 +220,7 @@ var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".gltf",
   ".bin"
 ]);
+var ALLOWED_EXTENSIONLESS_FILES = /* @__PURE__ */ new Set(["_redirects", "_headers"]);
 var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".png",
   ".jpg",
@@ -271,9 +272,15 @@ var MIME_BY_EXT = {
   ".bin": "application/octet-stream"
 };
 function guessMimeType(filePath) {
+  if (ALLOWED_EXTENSIONLESS_FILES.has(path2.basename(filePath))) {
+    return "text/plain; charset=utf-8";
+  }
   return MIME_BY_EXT[path2.extname(filePath).toLowerCase()] || "application/octet-stream";
 }
 function isAllowedDeployExt(filePath) {
+  if (ALLOWED_EXTENSIONLESS_FILES.has(path2.basename(filePath))) {
+    return true;
+  }
   return ALLOWED_EXTENSIONS.has(path2.extname(filePath).toLowerCase());
 }
 function isBinaryDeployExt(filePath) {
@@ -322,7 +329,7 @@ function collectFiles(dir, baseDir = dir) {
       }
     } else if (entry.isFile()) {
       const ext = path2.extname(entry.name).toLowerCase();
-      if (!ALLOWED_EXTENSIONS.has(ext)) {
+      if (!isAllowedDeployExt(entry.name)) {
         continue;
       }
       if (entry.name.startsWith(".")) {