connectbase-client 3.24.0 → 3.25.1

package/CHANGELOG.md

@@ -3,6 +3,33 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.25.1] - 2026-05-27
+
+### Fixed — 3.25.0 회귀 복구 + heartbeat 헬퍼 정리
+
+3.25.0 이 NativeBridge / inApp 우회 / deploy timeout 을 추가하면서, 같은 시기 3.24.0 에 들어가 있던
+incremental deploy(manifest 기반 +/− diff) 와 `signUp` / `startCentralOAuth` 흐름을 통째로 누락한 채
+release 됐다. 본 패치는 두 라인을 머지해 3.24.0 의 동작을 회복하면서 3.25.0 의 신규 기능을 모두 유지한다.
+
+- **CLI deploy** — `fullDeploy` 만 호출되던 회귀를 닫고 `incrementalDeploy` + `tryFetchManifest` + `computeDeployDiff` + `handleDeployResponse` 복원.
+  - Dev 는 항상 전량(`/deploy/dev`), Prod 는 manifest 기반 `+upsert/-delete` 전송, 변경 0 이면 업로드 skip.
+  - 409 revision conflict 자동 1회 재시도.
+  - 두 경로 모두 `computeDeployTimeout(totalBytes, override)` 결과를 `makeRequest` 의 `timeoutMs` 로 전달.
+  - `startUploadHeartbeat()` 헬퍼로 분리해 incremental / full 양쪽에서 TTY heartbeat 표시 (CI 환경은 무음).
+  - `VERSION` 을 빌드된 `package.json` 에서 읽도록 복원 (`getPackageVersion()`).
+- **OAuth** — `signUp(provider, callbackUrl, state)` 와 `startCentralOAuth(intent)` 가 다시 export.
+  - `signIn` / `signUp` 모두 `startCentralOAuth` 를 거치며, 내부에서 ① NativeBridge 감지 ②
+    3rd-party 인앱 브라우저(`detectInAppBrowser` + `escapeToExternalBrowser`) 처리 ③ 일반 웹 redirect
+    순으로 분기. 3.25.0 에서 `signIn` 만 inApp 처리를 받던 비대칭을 해소.
+  - `signInWithPopup` 도 같은 3-way 분기 + `options.intent` 유지.
+- **Exports** — `detectInAppBrowser`, `escapeToExternalBrowser` 외에 3.24.0 의 `TokenPersistence` 타입과
+  `GameError` 도 함께 re-export (3.25.0 에서 export 라인이 충돌 머지로 일부 빠져있던 회귀).
+
+### Notes — 누락된 CHANGELOG 보강
+
+3.24.0 / 3.25.0 은 CHANGELOG 엔트리 없이 publish 됐다. 향후 retro 엔트리를 보강할 수 있으나, 본 릴리스는
+3.25.0 → 3.25.1 의 diff 만 다룬다.
+
 ## [3.23.0] - 2026-05-26
 
 ### Fixed — OAuth 표준 흐름 페이지 리로드 후 세션 유실 (platform-issue 019e638d)

package/dist/cli.js

@@ -131,7 +131,7 @@ function getPackageVersion() {
     }
   } catch {
   }
-  return "0.15.1";
+  return "3.25.1";
 }
 var VERSION = getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
@@ -280,7 +280,8 @@ function collectFiles(dir, baseDir = dir) {
   }
   return files;
 }
-async function makeRequest(url, method, headers, body) {
+var DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
+async function makeRequest(url, method, headers, body, reqOpts = {}) {
   return new Promise((resolve2, reject) => {
     const parsedUrl = new URL(url);
     const isHttps = parsedUrl.protocol === "https:";
@@ -313,8 +314,16 @@ async function makeRequest(url, method, headers, body) {
         }
       });
     });
-    req.setTimeout(6e4, () => {
-      req.destroy(new Error("\uC694\uCCAD \uC2DC\uAC04 \uCD08\uACFC (60\uCD08)"));
+    req.on("socket", (socket) => {
+      socket.setKeepAlive(true, 3e4);
+    });
+    const timeoutMs = reqOpts.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+    req.setTimeout(timeoutMs, () => {
+      req.destroy(
+        new Error(
+          `\uC694\uCCAD \uC2DC\uAC04 \uCD08\uACFC (${Math.round(timeoutMs / 1e3)}\uCD08). \uD070 \uC0AC\uC774\uD2B8\uB294 --timeout <\uCD08> \uB610\uB294 CONNECTBASE_DEPLOY_TIMEOUT \uD658\uACBD\uBCC0\uC218\uB85C \uB298\uB9AC\uC138\uC694.`
+        )
+      );
     });
     req.on("error", reject);
     if (bodyBuffer) {
@@ -323,7 +332,17 @@ async function makeRequest(url, method, headers, body) {
     req.end();
   });
 }
-async function deploy(directory, config, isDev = false) {
+var DEPLOY_TIMEOUT_BASE_MS = 5 * 6e4;
+var DEPLOY_TIMEOUT_PER_10MB_MS = 6e4;
+var DEPLOY_TIMEOUT_MIN_MS = 10 * 6e4;
+function computeDeployTimeout(totalBytes, override) {
+  if (override && override > 0) return override;
+  const envOverride = process.env.CONNECTBASE_DEPLOY_TIMEOUT ? parseInt(process.env.CONNECTBASE_DEPLOY_TIMEOUT, 10) * 1e3 : 0;
+  if (envOverride > 0) return envOverride;
+  const sizeBased = Math.ceil(totalBytes / (10 * 1024 * 1024)) * DEPLOY_TIMEOUT_PER_10MB_MS;
+  return Math.max(DEPLOY_TIMEOUT_MIN_MS, DEPLOY_TIMEOUT_BASE_MS + sizeBased);
+}
+async function deploy(directory, config, isDev = false, deployOpts = {}) {
   const dir = path2.resolve(directory);
   if (!fs2.existsSync(dir)) {
     error(`\uB514\uB809\uD1A0\uB9AC\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${dir}`);
@@ -363,14 +382,16 @@ async function deploy(directory, config, isDev = false) {
   const envLabel = isDev ? "Dev" : "Prod";
   const baseStorageUrl = `${config.baseUrl}/v1/public/storages/webs/${config.storageId}`;
   const headers = { "X-Public-Key": config.publicKey };
+  const timeoutMs = computeDeployTimeout(totalSize, deployOpts.timeoutMs);
+  log(`${colors.dim}\uD0C0\uC784\uC544\uC6C3: ${Math.round(timeoutMs / 1e3)}\uCD08${colors.reset}`);
   if (isDev) {
-    await fullDeploy(baseStorageUrl, headers, files, envLabel, "deploy/dev");
+    await fullDeploy(baseStorageUrl, headers, files, envLabel, "deploy/dev", timeoutMs);
     return;
   }
   try {
     const manifest = await tryFetchManifest(baseStorageUrl, headers);
     if (!manifest) {
-      await fullDeploy(baseStorageUrl, headers, files, envLabel, "deploy");
+      await fullDeploy(baseStorageUrl, headers, files, envLabel, "deploy", timeoutMs);
       return;
     }
     const diff = computeDeployDiff(files, manifest);
@@ -384,7 +405,7 @@ ${colors.cyan}URL: https://${config.storageId}.web.connectbase.world${colors.res
     info(`\uBCC0\uACBD: ${colors.green}+${diff.upsert.length}${colors.reset} / ${colors.red}-${diff.delete.length}${colors.reset} (\uC804\uCCB4 ${files.length}\uAC1C \uC911)`);
     const uploadSize = diff.upsert.reduce((s, f) => s + f.content.length, 0);
     info(`\uC5C5\uB85C\uB4DC \uD06C\uAE30: ${(uploadSize / 1024).toFixed(1)} KB`);
-    await incrementalDeploy(baseStorageUrl, headers, diff, manifest.revision, envLabel);
+    await incrementalDeploy(baseStorageUrl, headers, diff, manifest.revision, envLabel, timeoutMs);
   } catch (err) {
     process.stdout.write("\r                    \r");
     error(`\uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
@@ -428,15 +449,25 @@ function computeDeployDiff(local, manifest) {
   }
   return { upsert, delete: toDelete };
 }
-async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, envLabel) {
+function startUploadHeartbeat(envLabel, suffix = "\uBC30\uD3EC \uC911") {
+  if (!process.stdout.isTTY) return null;
+  const startedAt = Date.now();
+  return setInterval(() => {
+    const elapsed = Math.floor((Date.now() - startedAt) / 1e3);
+    process.stdout.write(`\r${colors.blue}\u27F3${colors.reset} ${envLabel} ${suffix}... ${colors.dim}(${elapsed}s)${colors.reset}`);
+  }, 1e3);
+}
+async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, envLabel, timeoutMs) {
   process.stdout.write(`${colors.blue}\u27F3${colors.reset} ${envLabel} \uC99D\uBD84 \uBC30\uD3EC \uC911...`);
+  let heartbeat = startUploadHeartbeat(envLabel, "\uC99D\uBD84 \uBC30\uD3EC \uC911");
   const body = JSON.stringify({
     upsert: diff.upsert,
     delete: diff.delete,
     base_revision: baseRevision
   });
-  const res = await makeRequest(`${baseStorageUrl}/deploy/incremental`, "POST", headers, body);
-  process.stdout.write("\r                                   \r");
+  const res = await makeRequest(`${baseStorageUrl}/deploy/incremental`, "POST", headers, body, { timeoutMs });
+  if (heartbeat) clearInterval(heartbeat);
+  process.stdout.write("\r                                              \r");
   if (res.status === 409) {
     warn("\uC11C\uBC84 revision \uC774 \uBCC0\uACBD\uB418\uC5C8\uC2B5\uB2C8\uB2E4. manifest \uC7AC\uC870\uD68C \uD6C4 \uC7AC\uC2DC\uB3C4\uD569\uB2C8\uB2E4.");
     const manifest = await tryFetchManifest(baseStorageUrl, headers);
@@ -450,15 +481,18 @@ async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, en
       base_revision: manifest.revision
     });
     process.stdout.write(`${colors.blue}\u27F3${colors.reset} ${envLabel} \uC99D\uBD84 \uBC30\uD3EC \uC7AC\uC2DC\uB3C4...`);
-    const res2 = await makeRequest(`${baseStorageUrl}/deploy/incremental`, "POST", headers, body2);
-    process.stdout.write("\r                                       \r");
+    heartbeat = startUploadHeartbeat(envLabel, "\uC99D\uBD84 \uBC30\uD3EC \uC7AC\uC2DC\uB3C4");
+    const res2 = await makeRequest(`${baseStorageUrl}/deploy/incremental`, "POST", headers, body2, { timeoutMs });
+    if (heartbeat) clearInterval(heartbeat);
+    process.stdout.write("\r                                              \r");
     handleDeployResponse(res2, envLabel);
     return;
   }
   handleDeployResponse(res, envLabel);
 }
-async function fullDeploy(baseStorageUrl, headers, files, envLabel, endpoint) {
+async function fullDeploy(baseStorageUrl, headers, files, envLabel, endpoint, timeoutMs) {
   process.stdout.write(`${colors.blue}\u27F3${colors.reset} ${envLabel} \uBC30\uD3EC \uC911...`);
+  const heartbeat = startUploadHeartbeat(envLabel);
   const body = JSON.stringify({
     files: files.map((f) => ({
       path: f.path,
@@ -466,8 +500,9 @@ async function fullDeploy(baseStorageUrl, headers, files, envLabel, endpoint) {
       is_binary: f.isBinary
     }))
   });
-  const res = await makeRequest(`${baseStorageUrl}/${endpoint}`, "POST", headers, body);
-  process.stdout.write("\r                    \r");
+  const res = await makeRequest(`${baseStorageUrl}/${endpoint}`, "POST", headers, body, { timeoutMs });
+  if (heartbeat) clearInterval(heartbeat);
+  process.stdout.write("\r                                              \r");
   handleDeployResponse(res, envLabel);
 }
 function handleDeployResponse(response, envLabel) {
@@ -2308,7 +2343,7 @@ ${colors.yellow}\uC635\uC158:${colors.reset}
   -s, --storage <id>    \uC2A4\uD1A0\uB9AC\uC9C0 ID
   -k, --public-key <key>   API Key
   -u, --base-url <url>  \uC11C\uBC84 URL (\uAE30\uBCF8: ${DEFAULT_BASE_URL})
-  -t, --timeout <sec>   \uD130\uB110 \uC694\uCCAD \uD0C0\uC784\uC544\uC6C3 (\uCD08, tunnel \uC804\uC6A9)
+  -t, --timeout <sec>   \uC694\uCCAD \uD0C0\uC784\uC544\uC6C3 (\uCD08, tunnel/deploy \uACF5\uD1B5. deploy \uBBF8\uC9C0\uC815 \uC2DC \uD30C\uC77C \uD06C\uAE30\uC5D0 \uB530\uB77C \uC790\uB3D9 \uC0B0\uC815)
   --max-body <MB>       \uD130\uB110 \uCD5C\uB300 \uBC14\uB514 \uD06C\uAE30 (MB, tunnel \uC804\uC6A9)
   --force               \uD130\uB110 lockfile \uBB34\uC2DC (\uC911\uBCF5 \uC2E4\uD589 \uAC15\uC81C, tunnel \uC804\uC6A9)
   --public              proxy_token \uAC80\uC99D \uBE44\uD65C\uC131\uD654 \u2014 \uC6F9\uD6C5/\uC678\uBD80 \uC9C1\uC811 \uD638\uCD9C\uC6A9 (tunnel \uC804\uC6A9)
@@ -2466,7 +2501,13 @@ async function main() {
       process.exit(1);
     }
     const isDev = parsed.options.dev === "true";
-    await deploy(directory, config, isDev);
+    const deployOpts = {};
+    if (parsed.options.timeout) {
+      const t = parseInt(parsed.options.timeout, 10);
+      if (!isNaN(t) && t > 0) deployOpts.timeoutMs = t * 1e3;
+      else warn(`--timeout \uAC12\uC774 \uC720\uD6A8\uD558\uC9C0 \uC54A\uC544 \uBB34\uC2DC\uB429\uB2C8\uB2E4: ${parsed.options.timeout}`);
+    }
+    await deploy(directory, config, isDev, deployOpts);
   } else if (parsed.command === "tunnel") {
     const portStr = parsed.args[0];
     if (!portStr) {