connectbase-client 6.3.0 → 6.3.1

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [6.3.1] - 2026-09-08
+
+### Fixed — `init` 의 웹 스토리지 생성 실패가 `[object Object]` 로만 찍히던 문제
+
+앱에 이미 같은 이름의 웹 스토리지가 있는 상태에서 `init` 이 같은 이름으로 생성을 시도하면
+서버는 409 를 돌려주는데, CLI 가 그 응답 본문(`{ error: { code, message } }`)을 문자열로
+찍어 `생성 실패: [object Object]` 만 보였습니다. 원인이 이름 충돌이라는 사실을 알 길이
+없었고, 스토리지 선택 프롬프트에서 Enter 만 치면 정확히 이 경로로 들어갔습니다.
+
+- 에러 응답 형식이 `{ error: "문자열" }` 이든 표준 봉투 `{ error: { code, message,
+  suggestion } }` 이든 사람이 읽을 메시지로 정리하는 헬퍼(`apiErrorMessage`)를 두고,
+  `init` / `deploy` / `promote` / 배포 이력 / presign / 앱 생성 / 인증 세션의 에러 출력을
+  전부 이 헬퍼로 통일했습니다. 서버가 제안(suggestion)을 보내면 함께 보여 줍니다.
+- 대화형 `init` 도 `--yes` 와 같은 규칙으로, 입력한 이름과 같은 웹 스토리지가 이미 있으면
+  생성 대신 그 스토리지를 재사용합니다. 서버 요청 없이 즉시 넘어가므로 409 자체가 나지
+  않습니다.
+- 서버(core-server)도 같은 앱의 이름 중복을 미리 검사해 `같은 이름의 웹 스토리지가 이미
+  있습니다: "<이름>"` 이라는 409 를 돌려줍니다. 구버전 CLI 로도 이제 이 문장이 보입니다.
+
 ## [6.3.0] - 2026-09-07
 
 ### Fixed — Secret Key 가 만료되면 `init` 을 다시 돌릴 수 없던 문제

package/dist/cli.js

@@ -32,6 +32,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var cli_exports = {};
 __export(cli_exports, {
   TunnelConnectSelector: () => TunnelConnectSelector,
+  apiErrorMessage: () => apiErrorMessage,
   computeDeployDiff: () => computeDeployDiff,
   getTunnelConnectCandidates: () => getTunnelConnectCandidates,
   guessMimeType: () => guessMimeType,
@@ -147,7 +148,7 @@ function handleTunnelError(msg, appId, localPort) {
 }
 
 // src/cli.ts
-var VERSION = "6.3.0" ? "6.3.0" : getPackageVersion();
+var VERSION = "6.3.1" ? "6.3.1" : getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
   reset: "\x1B[0m",
@@ -420,9 +421,9 @@ async function requestDeployPresign(baseStorageUrl, headers, files, timeoutMs) {
   );
   if (res.status === 404) return null;
   if (res.status < 200 || res.status >= 300) {
-    const data = res.data;
-    const msg = typeof data === "object" && data !== null ? data.message || data.error || JSON.stringify(data) : `HTTP ${res.status}`;
-    throw new Error(`presign \uC694\uCCAD \uC2E4\uD328: ${msg}`);
+    throw new Error(
+      `presign \uC694\uCCAD \uC2E4\uD328: ${apiErrorMessage(res.data, res.status)}`
+    );
   }
   const parsed = res.data;
   return parsed?.urls ?? [];
@@ -580,6 +581,27 @@ async function offloadLargeBinaries(baseStorageUrl, headers, diff, _envLabel, ti
   }
 }
 var DEFAULT_REQUEST_TIMEOUT_MS = 6e4;
+function apiErrorMessage(data, status) {
+  const fallback = `HTTP ${status}`;
+  if (typeof data === "string") return data.trim() || fallback;
+  if (typeof data !== "object" || data === null) return fallback;
+  const body = data;
+  const str = (v) => typeof v === "string" && v.trim() ? v.trim() : void 0;
+  let message;
+  let suggestion;
+  if (typeof body.error === "object" && body.error !== null) {
+    const detail = body.error;
+    message = str(detail.message) ?? str(detail.code);
+    suggestion = str(detail.suggestion);
+  } else {
+    message = str(body.message) ?? str(body.error);
+  }
+  if (!message) {
+    const raw = JSON.stringify(body);
+    return raw === "{}" ? fallback : `${fallback}: ${raw}`;
+  }
+  return suggestion ? `${message} (${suggestion})` : message;
+}
 async function makeRequest(url, method, headers, body, reqOpts = {}) {
   return new Promise((resolve2, reject) => {
     const parsedUrl = new URL(url);
@@ -768,9 +790,9 @@ async function tryFetchManifest(baseStorageUrl, headers) {
   );
   if (res.status === 404) return null;
   if (res.status < 200 || res.status >= 300) {
-    const data = res.data;
-    const msg = typeof data === "object" && data !== null ? data.message || data.error || JSON.stringify(data) : `HTTP ${res.status}`;
-    throw new Error(`manifest \uC870\uD68C \uC2E4\uD328: ${msg}`);
+    throw new Error(
+      `manifest \uC870\uD68C \uC2E4\uD328: ${apiErrorMessage(res.data, res.status)}`
+    );
   }
   const parsed = res.data;
   if (!parsed || !Array.isArray(parsed.files)) {
@@ -920,8 +942,7 @@ ${colors.cyan}URL: ${data.url}${colors.reset}
 `);
     }
   } else {
-    const data = response.data;
-    const errorMsg = typeof data === "object" && data !== null ? data.message || data.error || JSON.stringify(data) : typeof data === "string" ? data : `HTTP ${response.status}`;
+    const errorMsg = apiErrorMessage(response.data, response.status);
     if (!reportDeployAuthError(response.status, response.data)) {
       error(`\uBC30\uD3EC \uC2E4\uD328: ${errorMsg}`);
     }
@@ -950,8 +971,7 @@ async function promote(config, deploymentId) {
     process.exit(1);
   }
   if (res.status < 200 || res.status >= 300) {
-    const data2 = res.data;
-    const msg = typeof data2 === "object" && data2 !== null ? data2.error || data2.message || JSON.stringify(data2) : `HTTP ${res.status}`;
+    const msg = apiErrorMessage(res.data, res.status);
     if (!reportDeployAuthError(res.status, res.data)) {
       error(`promote \uC2E4\uD328: ${msg}`);
     }
@@ -974,8 +994,7 @@ async function listReleases(config) {
     headers
   );
   if (res.status < 200 || res.status >= 300) {
-    const data2 = res.data;
-    const msg = typeof data2 === "object" && data2 !== null ? data2.error || data2.message || JSON.stringify(data2) : `HTTP ${res.status}`;
+    const msg = apiErrorMessage(res.data, res.status);
     if (!reportDeployAuthError(res.status, res.data)) {
       error(`\uBC30\uD3EC \uC774\uB825 \uC870\uD68C \uC2E4\uD328: ${msg}`);
     }
@@ -1100,9 +1119,9 @@ async function browserAuthFlow(baseUrl = DEFAULT_BASE_URL) {
     {}
   );
   if (startRes.status !== 200) {
-    const errData = startRes.data;
-    const detail = errData?.error || errData?.message || `HTTP ${startRes.status}`;
-    error(`\uC778\uC99D \uC138\uC158 \uC2DC\uC791\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4: ${detail}`);
+    error(
+      `\uC778\uC99D \uC138\uC158 \uC2DC\uC791\uC5D0 \uC2E4\uD328\uD588\uC2B5\uB2C8\uB2E4: ${apiErrorMessage(startRes.data, startRes.status)}`
+    );
     process.exit(1);
   }
   const { session_id } = startRes.data;
@@ -1413,8 +1432,9 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `
         process.exit(1);
       }
       if (createRes.status !== 201) {
-        const data = createRes.data;
-        error(`\uC571 \uC0DD\uC131 \uC2E4\uD328: ${data?.error || `HTTP ${createRes.status}`}`);
+        error(
+          `\uC571 \uC0DD\uC131 \uC2E4\uD328: ${apiErrorMessage(createRes.data, createRes.status)}`
+        );
         process.exit(1);
       }
       const createData = createRes.data;
@@ -1498,27 +1518,34 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `
           const name = nonInteractive ? projectName : await prompt(
             `${colors.blue}?${colors.reset} \uC2A4\uD1A0\uB9AC\uC9C0 \uC774\uB984 (${projectName}): `
           ) || projectName;
-          info("\uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0 \uC0DD\uC131 \uC911...");
-          const createRes = await makeRequest(
-            `${baseUrl}/v1/public/storages/webs`,
-            "POST",
-            {
-              "X-Public-Key": publicKeyForSdk,
-              "X-User-Secret-Key": secretKey,
-              Authorization: `Bearer ${secretKey}`
-            },
-            JSON.stringify({ name })
-          );
-          if (createRes.status !== 200) {
-            const data = createRes.data;
-            error(
-              `\uC0DD\uC131 \uC2E4\uD328: ${data?.error || data?.message || `HTTP ${createRes.status}`}`
+          const sameName = storages.find((s) => s.name === name);
+          if (sameName) {
+            storageId = sameName.id;
+            success(
+              `\uAC19\uC740 \uC774\uB984\uC758 \uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0\uAC00 \uC774\uBBF8 \uC788\uC5B4 \uC7AC\uC0AC\uC6A9\uD569\uB2C8\uB2E4: ${sameName.name}`
             );
-            process.exit(1);
+          } else {
+            info("\uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0 \uC0DD\uC131 \uC911...");
+            const createRes = await makeRequest(
+              `${baseUrl}/v1/public/storages/webs`,
+              "POST",
+              {
+                "X-Public-Key": publicKeyForSdk,
+                "X-User-Secret-Key": secretKey,
+                Authorization: `Bearer ${secretKey}`
+              },
+              JSON.stringify({ name })
+            );
+            if (createRes.status !== 200) {
+              error(
+                `\uC0DD\uC131 \uC2E4\uD328: ${apiErrorMessage(createRes.data, createRes.status)}`
+              );
+              process.exit(1);
+            }
+            const createData = createRes.data;
+            storageId = createData.storage_web_id;
+            success(`\uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0 \uC0DD\uC131 \uC644\uB8CC: ${createData.name}`);
           }
-          const createData = createRes.data;
-          storageId = createData.storage_web_id;
-          success(`\uC6F9 \uC2A4\uD1A0\uB9AC\uC9C0 \uC0DD\uC131 \uC644\uB8CC: ${createData.name}`);
         }
       } else {
         throw new Error(`HTTP ${listRes.status}`);
@@ -2664,8 +2691,7 @@ ${colors.blue}?${colors.reset} \uC571 \uC120\uD0DD (\uBC88\uD638): `
     process.exit(1);
   }
   if (createRes.status !== 201) {
-    const data = createRes.data;
-    error(`\uC571 \uC0DD\uC131 \uC2E4\uD328: ${data?.error || `HTTP ${createRes.status}`}`);
+    error(`\uC571 \uC0DD\uC131 \uC2E4\uD328: ${apiErrorMessage(createRes.data, createRes.status)}`);
     process.exit(1);
   }
   const createData = createRes.data;
@@ -3744,6 +3770,7 @@ main().catch((err) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TunnelConnectSelector,
+  apiErrorMessage,
   computeDeployDiff,
   getTunnelConnectCandidates,
   guessMimeType,

package/package.json

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