connectbase-client 3.52.0 → 3.53.0

package/CHANGELOG.md

@@ -3,6 +3,23 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.53.0] - 2026-07-23
+
+### Changed — 웹 스토리지 배포: `--dev` → QA 채널 별칭(deprecated)
+
+웹 스토리지 배포를 **QA → promote 불변배포 단일 파이프라인**으로 수렴했다. 막다른 길이던
+레거시 dev 배포(별도 `.dev.web.connectbase.world` 호스트 + `{id}/dev` 저장경로)는 서버에서
+제거됐고, `--dev` 플래그는 남아 있으나 이제 **QA 채널 배포의 별칭**으로 동작한다.
+
+- `deploy --dev` 는 `promote_mode` 와 무관하게 이번 릴리스를 **QA 포인터에만** 반영한다
+  (production 미반영). 실행 시 deprecation 안내를 출력하며, 검증 후 `promote` 로 production
+  에 반영한다. **deprecated** — 정식 흐름 `deploy`(신규 스토리지 기본 `manual` → QA)
+  → `releases` → `promote` 사용을 권장한다.
+- `deploy` / `promote` / `releases` 명령의 인터페이스와 프로그래매틱 API 는 변경 없음.
+
+> 참고(서버 측): 신규 웹 스토리지는 기본 `promote_mode=manual` 로 생성된다 — `deploy` 는
+> QA 에만 반영되고 production 은 명시적 `promote` 로만 바뀐다. 기존 스토리지는 영향 없다.
+
 ## [3.52.0] - 2026-07-22
 
 ### Added — Paddle(MoR) 임베디드 결제 타입

package/dist/cli.js

@@ -377,8 +377,8 @@ function validateFileSizes(files) {
   );
   process.exit(1);
 }
-async function requestDeployPresign(baseStorageUrl, headers, files, timeoutMs, dev = false) {
-  const body = JSON.stringify(dev ? { files, dev: true } : { files });
+async function requestDeployPresign(baseStorageUrl, headers, files, timeoutMs) {
+  const body = JSON.stringify({ files });
   const res = await makeRequest(
     `${baseStorageUrl}/deploy/presign`,
     "POST",
@@ -547,73 +547,6 @@ async function offloadLargeBinaries(baseStorageUrl, headers, diff, _envLabel, ti
     f.content = "";
   }
 }
-async function offloadDevLargeBinaries(baseStorageUrl, headers, files, timeoutMs) {
-  const large = files.filter(
-    (f) => f.isBinary && Buffer.byteLength(f.content, "utf8") > WEB_FILE_MAX_STORED_BYTES
-  );
-  if (large.length === 0) return files;
-  const presignFiles = large.map((f) => ({
-    path: f.path,
-    size: Buffer.from(f.content, "base64").length,
-    mime_type: guessMimeType(f.path)
-  }));
-  let presigned;
-  try {
-    presigned = await requestDeployPresign(
-      baseStorageUrl,
-      headers,
-      presignFiles,
-      timeoutMs,
-      true
-    );
-  } catch (err) {
-    error(
-      `dev \uB300\uC6A9\uB7C9 \uD30C\uC77C \uC5C5\uB85C\uB4DC \uC900\uBE44 \uC2E4\uD328: ${err instanceof Error ? err.message : err}`
-    );
-    process.exit(1);
-  }
-  if (presigned === null) {
-    info(
-      "\uC11C\uBC84\uAC00 \uB300\uC6A9\uB7C9 \uC9C1\uC811 \uC5C5\uB85C\uB4DC\uB97C \uBBF8\uC9C0\uC6D0 \u2014 dev \uB294 \uC804\uB7C9 \uC5C5\uB85C\uB4DC\uB85C \uC9C4\uD589\uD569\uB2C8\uB2E4."
-    );
-    return files;
-  }
-  if (!presigned.every((p) => p.object_key.includes("/dev/"))) {
-    info(
-      "\uC11C\uBC84\uAC00 dev \uC9C1\uC811 \uC5C5\uB85C\uB4DC\uB97C \uBBF8\uC9C0\uC6D0(\uC751\uB2F5 \uD0A4\uAC00 dev \uACBD\uB85C \uC544\uB2D8) \u2014 dev \uB294 \uC804\uB7C9 \uC5C5\uB85C\uB4DC\uB85C \uC9C4\uD589\uD569\uB2C8\uB2E4."
-    );
-    return files;
-  }
-  const urlByPath = new Map(presigned.map((p) => [p.path, p.upload_url]));
-  info(
-    `\uB300\uC6A9\uB7C9 \uBC14\uC774\uB108\uB9AC ${large.length}\uAC1C\uB97C dev Object Storage \uB85C \uC9C1\uC811 \uC5C5\uB85C\uB4DC\uD569\uB2C8\uB2E4...`
-  );
-  const offloaded = /* @__PURE__ */ new Set();
-  for (const f of large) {
-    const uploadUrl = urlByPath.get(f.path);
-    if (!uploadUrl) {
-      error(`presign \uC751\uB2F5\uC5D0 \uC5C5\uB85C\uB4DC URL \uC774 \uC5C6\uC2B5\uB2C8\uB2E4: ${f.path}`);
-      process.exit(1);
-    }
-    const bytes = Buffer.from(f.content, "base64");
-    try {
-      await putToPresignedUrl(
-        uploadUrl,
-        bytes,
-        guessMimeType(f.path),
-        timeoutMs
-      );
-    } catch (err) {
-      error(
-        `dev \uC5C5\uB85C\uB4DC \uC2E4\uD328 (${f.path}): ${err instanceof Error ? err.message : err}`
-      );
-      process.exit(1);
-    }
-    success(`\uC9C1\uC811 \uC5C5\uB85C\uB4DC(dev): ${f.path} (${formatSize(bytes.length)})`);
-    offloaded.add(f.path);
-  }
-  return files.filter((f) => !offloaded.has(f.path));
-}
 var DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
 async function makeRequest(url, method, headers, body, reqOpts = {}) {
   return new Promise((resolve2, reject) => {
@@ -722,30 +655,19 @@ async function deploy(directory, config, isDev = false, deployOpts = {}) {
   log(
     `${colors.green}\u2713${colors.reset} ${files.length}\uAC1C \uD30C\uC77C \uBC1C\uACAC (${sizeKB} KB)`
   );
-  const envLabel = isDev ? "Dev" : "Prod";
+  const target = isDev ? "qa" : void 0;
+  const envLabel = isDev ? "QA" : "Prod";
+  if (isDev) {
+    warn(
+      `${colors.yellow}--dev \uB294 deprecated${colors.reset} \uC785\uB2C8\uB2E4 \u2014 QA \uCC44\uB110\uB85C \uBC30\uD3EC\uD569\uB2C8\uB2E4(production \uBBF8\uBC18\uC601). \uC774\uD6C4 ${colors.cyan}npx connectbase promote${colors.reset} \uB85C production \uC5D0 \uBC18\uC601\uD558\uC138\uC694. promote_mode=manual \uC774\uBA74 \uC77C\uBC18 ${colors.cyan}deploy${colors.reset} \uB3C4 \uB3D9\uC77C\uD558\uAC8C QA \uB85C \uBC30\uD3EC\uB429\uB2C8\uB2E4.`
+    );
+  }
   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) {
-    const toSend = await offloadDevLargeBinaries(
-      baseStorageUrl,
-      headers,
-      files,
-      timeoutMs
-    );
-    await fullDeploy(
-      baseStorageUrl,
-      headers,
-      toSend,
-      envLabel,
-      "deploy/dev",
-      timeoutMs
-    );
-    return;
-  }
   try {
     const manifest = await tryFetchManifest(baseStorageUrl, headers);
     if (!manifest) {
@@ -756,18 +678,27 @@ async function deploy(directory, config, isDev = false, deployOpts = {}) {
         files,
         envLabel,
         "deploy",
-        timeoutMs
+        timeoutMs,
+        target
       );
       return;
     }
     const diff = computeDeployDiff(files, manifest);
     if (diff.upsert.length === 0 && diff.delete.length === 0) {
       success(`\uBCC0\uACBD\uC0AC\uD56D \uC5C6\uC74C (${files.length}\uAC1C \uD30C\uC77C \uC77C\uCE58)`);
-      log(
-        `
+      if (target === "qa") {
+        log(
+          `
+${colors.dim}QA/production \uD3EC\uC778\uD130\uB294 \uADF8\uB300\uB85C\uC785\uB2C8\uB2E4. \uC0C8 \uBC30\uD3EC\uAC00 \uC5C6\uC73C\uBA74 \uBC18\uC601\uD560 \uAC83\uB3C4 \uC5C6\uC2B5\uB2C8\uB2E4.${colors.reset}
+`
+        );
+      } else {
+        log(
+          `
 ${colors.cyan}URL: https://${config.storageId}.web.connectbase.world${colors.reset}
 `
-      );
+        );
+      }
       return;
     }
     await offloadLargeBinaries(
@@ -788,7 +719,8 @@ ${colors.cyan}URL: https://${config.storageId}.web.connectbase.world${colors.res
       diff,
       manifest.revision,
       envLabel,
-      timeoutMs
+      timeoutMs,
+      target
     );
   } catch (err) {
     process.stdout.write("\r                    \r");
@@ -847,7 +779,7 @@ function startUploadHeartbeat(envLabel, suffix = "\uBC30\uD3EC \uC911") {
     );
   }, 1e3);
 }
-async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, envLabel, timeoutMs) {
+async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, envLabel, timeoutMs, target) {
   process.stdout.write(
     `${colors.blue}\u27F3${colors.reset} ${envLabel} \uC99D\uBD84 \uBC30\uD3EC \uC911...`
   );
@@ -855,7 +787,8 @@ async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, en
   const body = JSON.stringify({
     upsert: diff.upsert,
     delete: diff.delete,
-    base_revision: baseRevision
+    base_revision: baseRevision,
+    ...target ? { target } : {}
   });
   const res = await makeRequest(
     `${baseStorageUrl}/deploy/incremental`,
@@ -876,7 +809,8 @@ async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, en
     const body2 = JSON.stringify({
       upsert: diff.upsert,
       delete: diff.delete,
-      base_revision: manifest.revision
+      base_revision: manifest.revision,
+      ...target ? { target } : {}
     });
     process.stdout.write(
       `${colors.blue}\u27F3${colors.reset} ${envLabel} \uC99D\uBD84 \uBC30\uD3EC \uC7AC\uC2DC\uB3C4...`
@@ -896,7 +830,7 @@ async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, en
   }
   handleDeployResponse(res, envLabel);
 }
-async function fullDeploy(baseStorageUrl, headers, files, envLabel, endpoint, timeoutMs) {
+async function fullDeploy(baseStorageUrl, headers, files, envLabel, endpoint, timeoutMs, target) {
   process.stdout.write(`${colors.blue}\u27F3${colors.reset} ${envLabel} \uBC30\uD3EC \uC911...`);
   const heartbeat = startUploadHeartbeat(envLabel);
   const body = JSON.stringify({
@@ -904,7 +838,8 @@ async function fullDeploy(baseStorageUrl, headers, files, envLabel, endpoint, ti
       path: f.path,
       content: f.content,
       is_binary: f.isBinary
-    }))
+    })),
+    ...target ? { target } : {}
   });
   const res = await makeRequest(
     `${baseStorageUrl}/${endpoint}`,
@@ -947,11 +882,7 @@ ${colors.yellow}QA URL:  ${dep.qa_url}${colors.reset}`);
       return;
     }
     success(`${envLabel} \uBC30\uD3EC \uC644\uB8CC!`);
-    if (data?.dev_url) {
-      log(`
-${colors.yellow}Dev URL: ${data.dev_url}${colors.reset}
-`);
-    } else if (data?.url) {
+    if (data?.url) {
       log(`
 ${colors.cyan}URL: ${data.url}${colors.reset}
 `);
@@ -3422,8 +3353,9 @@ ${colors.yellow}\uBA85\uB839\uC5B4:${colors.reset}
   update                SDK \uBC84\uC804 \uCCB4\uD06C + \uBB38\uC11C/MCP \uC77C\uAD04 \uC5C5\uB370\uC774\uD2B8 (\uBAA8\uB178\uB808\uD3EC \uB8E8\uD2B8 \uC9C0\uC6D0)
   docs                  SDK \uBB38\uC11C \uB2E4\uC6B4\uB85C\uB4DC/\uC5C5\uB370\uC774\uD2B8 (\uBAA8\uB178\uB808\uD3EC \uC790\uB3D9 \uAC10\uC9C0)
   mcp                   MCP \uC11C\uBC84 \uC124\uC815 (.mcp.json \uC0DD\uC131/\uC5C5\uB370\uC774\uD2B8, \uBAA8\uB178\uB808\uD3EC \uC790\uB3D9 \uAC10\uC9C0)
-  deploy <directory>    \uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0\uC5D0 \uD30C\uC77C \uBC30\uD3EC (--dev: Dev \uD658\uACBD)
-                        promote_mode=manual \uC774\uBA74 QA \uD658\uACBD\uC5D0\uB9CC \uBC30\uD3EC\uB429\uB2C8\uB2E4
+  deploy <directory>    \uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0\uC5D0 \uD30C\uC77C \uBC30\uD3EC
+                        promote_mode=manual \uC774\uBA74 QA \uD658\uACBD\uC5D0\uB9CC \uBC30\uD3EC\uB429\uB2C8\uB2E4 (\uC2E0\uADDC \uC2A4\uD1A0\uB9AC\uC9C0 \uAE30\uBCF8\uAC12)
+                        --dev \uB294 promote_mode \uBB34\uAD00 QA \uBC30\uD3EC (deprecated: QA \uBCC4\uCE6D)
   promote [releaseId]   QA \uAC80\uC99D \uD6C4 production \uBC18\uC601 (\uBBF8\uC9C0\uC815: \uCD5C\uC2E0 \uBC30\uD3EC, \uACFC\uAC70 id: \uB864\uBC31)
   releases              \uBC30\uD3EC \uC774\uB825 \uC870\uD68C (release \uBC88\uD638/\uC0C1\uD0DC/production\xB7QA \uD3EC\uC778\uD130)
   tunnel <port>         \uB85C\uCEEC \uC11C\uBE44\uC2A4\uB97C \uC778\uD130\uB137\uC5D0 \uB178\uCD9C
@@ -3447,7 +3379,7 @@ ${colors.yellow}\uC635\uC158:${colors.reset}
   --token <value>       proxy_token \uACE0\uC815\uAC12 (16-128\uC790 [A-Za-z0-9_-]) \u2014 \uC7AC\uC5F0\uACB0\uC5D0\uB3C4 \uD1A0\uD070 \uD68C\uC804 \uBC29\uC9C0. \uC678\uBD80 MCP custom_header \uB4F1 \uC548\uC815 \uD1B5\uD569\uC6A9 (tunnel \uC804\uC6A9)
   --label <name>        Endpoint binding \uC790\uB3D9 \uB4F1\uB85D (tunnel \uC804\uC6A9) \u2014 SDK \uC758 cb.endpoint.call(label) \uD638\uCD9C \uAC00\uB2A5
   --description <text>  Endpoint binding \uC124\uBA85 (--label \uB3D9\uBC18 \uC2DC\uB9CC)
-  -d, --dev             Dev \uD658\uACBD\uC5D0 \uBC30\uD3EC (deploy \uC804\uC6A9)
+  -d, --dev             QA \uD658\uACBD\uC5D0\uB9CC \uBC30\uD3EC (deploy \uC804\uC6A9, deprecated \u2014 QA \uBCC4\uCE6D)
   -y, --yes             \uBE44\uB300\uD654\uD615 \uCD08\uAE30\uD654 \u2014 \uD504\uB86C\uD504\uD2B8 \uC5C6\uC774 \uAE30\uBCF8\uAC12/\uD50C\uB798\uADF8\uB85C \uC9C4\uD589 (init \uC804\uC6A9, CI/AI \uC5D0\uC774\uC804\uD2B8\uC6A9)
   -a, --app <id>        \uAE30\uC874 \uC571 ID \uC9C0\uC815 (init \uC804\uC6A9)
   --secret-key <key>    Secret Key (cb_sk_) \uC9C0\uC815 (init/mcp)
@@ -3482,14 +3414,11 @@ ${colors.yellow}\uBE60\uB978 \uC2DC\uC791:${colors.reset}
   ${colors.dim}# 4. Prod \uBC30\uD3EC${colors.reset}
   npm run deploy
 
-  ${colors.dim}# 4-1. QA \uC6CC\uD06C\uD50C\uB85C\uC6B0 (\uCF58\uC194\uC5D0\uC11C promote_mode=manual \uC124\uC815 \uC2DC)${colors.reset}
+  ${colors.dim}# 4-1. QA \uC6CC\uD06C\uD50C\uB85C\uC6B0 (\uC2E0\uADDC \uC2A4\uD1A0\uB9AC\uC9C0 \uAE30\uBCF8 promote_mode=manual)${colors.reset}
   npx connectbase deploy ./dist   ${colors.dim}# QA \uD658\uACBD\uC5D0\uB9CC \uBC30\uD3EC${colors.reset}
   npx connectbase releases        ${colors.dim}# \uBC30\uD3EC \uC774\uB825 \uD655\uC778${colors.reset}
   npx connectbase promote         ${colors.dim}# QA \uAC80\uC99D \uD6C4 production \uBC18\uC601${colors.reset}
 
-  ${colors.dim}# 4-2. Dev \uD658\uACBD \uBC30\uD3EC (\uB0B4\uBD80 \uD655\uC778\uC6A9)${colors.reset}
-  npx connectbase deploy ./dist --dev
-
   ${colors.dim}# 5. \uD130\uB110 (\uAE30\uBCF8)${colors.reset}
   npx connectbase tunnel 3000
 

package/package.json

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