connectbase-client 6.3.0 → 6.3.2

package/CHANGELOG.md

@@ -3,6 +3,39 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [6.3.2] - 2026-09-08
+
+### Fixed — `init` 이 pnpm / yarn / bun 프로젝트에도 npm 명령을 안내하던 문제
+
+`init` 의 마지막 안내(`npm install`, `npm run deploy`)와 package.json 에 넣는 deploy
+스크립트(`npm run build && …`)가 npm 으로 고정돼 있었습니다. pnpm 프로젝트에서 안내대로
+`npm install` 을 치면 package-lock.json 이 새로 생기고 node_modules 가 pnpm 것과 갈립니다.
+
+이제 package.json 의 `packageManager` 필드, 없으면 잠금 파일(pnpm-lock.yaml / yarn.lock /
+bun.lock / package-lock.json — 모노레포는 git 루트까지 올라가며 탐색)로 패키지 매니저를 알아내
+그 매니저의 명령을 안내하고 스크립트에도 씁니다. pnpm 은 `pnpm deploy` 가 워크스페이스
+배포 내장 명령이라 반드시 `pnpm run deploy` 로 안내합니다. `update` 의 새 버전 안내도
+npm 과 pnpm 을 나란히 찍던 것을 감지된 매니저 하나로 바꿨습니다.
+
+## [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,13 +32,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var cli_exports = {};
 __export(cli_exports, {
   TunnelConnectSelector: () => TunnelConnectSelector,
+  apiErrorMessage: () => apiErrorMessage,
   computeDeployDiff: () => computeDeployDiff,
+  detectPackageManager: () => detectPackageManager,
   getTunnelConnectCandidates: () => getTunnelConnectCandidates,
   guessMimeType: () => guessMimeType,
   isAllowedDeployExt: () => isAllowedDeployExt,
   isBinaryDeployExt: () => isBinaryDeployExt,
   makeRequest: () => makeRequest,
   normalizeRelativePath: () => normalizeRelativePath,
+  packageManagerCommands: () => packageManagerCommands,
   parseArgs: () => parseArgs,
   registerEndpointBinding: () => registerEndpointBinding,
   sha256Hex: () => sha256Hex,
@@ -147,7 +150,7 @@ function handleTunnelError(msg, appId, localPort) {
 }
 
 // src/cli.ts
-var VERSION = "6.3.0" ? "6.3.0" : getPackageVersion();
+var VERSION = "6.3.2" ? "6.3.2" : getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
   reset: "\x1B[0m",
@@ -420,9 +423,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 +583,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 +792,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 +944,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 +973,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 +996,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 +1121,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 +1434,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 +1520,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}`);
@@ -1556,7 +1585,8 @@ ${colors.blue}?${colors.reset} \uC120\uD0DD (\uBC88\uD638): `
 `);
   success(".connectbaserc \uC0DD\uC131 \uC644\uB8CC");
   addToGitignore(".connectbaserc");
-  const { needsInstall } = addDeployScript(deployDir);
+  const pm = packageManagerCommands(detectPackageManager(cwd));
+  const { needsInstall } = addDeployScript(deployDir, pm);
   await setupClaudeCode(secretKey, projectRoot, baseUrl);
   log(`
 ${colors.green}\uCD08\uAE30\uD654 \uC644\uB8CC!${colors.reset}
@@ -1564,10 +1594,10 @@ ${colors.green}\uCD08\uAE30\uD654 \uC644\uB8CC!${colors.reset}
   log(`${colors.dim}\uBC30\uD3EC\uD558\uB824\uBA74:${colors.reset}`);
   if (needsInstall) {
     log(
-      `  ${colors.cyan}npm install${colors.reset}   ${colors.dim}# connectbase-client (CLI \uD3EC\uD568) \uC124\uCE58${colors.reset}`
+      `  ${colors.cyan}${pm.install}${colors.reset}   ${colors.dim}# connectbase-client (CLI \uD3EC\uD568) \uC124\uCE58${colors.reset}`
     );
   }
-  log(`  ${colors.cyan}npm run deploy${colors.reset}`);
+  log(`  ${colors.cyan}${pm.run("deploy")}${colors.reset}`);
   log(`
 ${colors.dim}Claude Code\uC5D0\uC11C MCP\uAC00 \uC790\uB3D9 \uC5F0\uACB0\uB429\uB2C8\uB2E4${colors.reset}
 `);
@@ -1617,7 +1647,45 @@ ${entry}
     success(".gitignore \uC0DD\uC131 \uC644\uB8CC");
   }
 }
-function addDeployScript(deployDir) {
+function detectPackageManager(startDir = process.cwd()) {
+  try {
+    const pkg = JSON.parse(
+      fs2.readFileSync(path2.join(startDir, "package.json"), "utf-8")
+    );
+    const declared = typeof pkg.packageManager === "string" ? pkg.packageManager.split("@")[0] : "";
+    if (declared === "npm" || declared === "pnpm" || declared === "yarn" || declared === "bun") {
+      return declared;
+    }
+  } catch {
+  }
+  const lockfiles = [
+    ["pnpm-lock.yaml", "pnpm"],
+    ["yarn.lock", "yarn"],
+    ["bun.lockb", "bun"],
+    ["bun.lock", "bun"],
+    ["package-lock.json", "npm"],
+    ["npm-shrinkwrap.json", "npm"]
+  ];
+  let dir = path2.resolve(startDir);
+  for (; ; ) {
+    for (const [file, pm] of lockfiles) {
+      if (fs2.existsSync(path2.join(dir, file))) return pm;
+    }
+    if (fs2.existsSync(path2.join(dir, ".git"))) break;
+    const parent = path2.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return "npm";
+}
+function packageManagerCommands(pm) {
+  return {
+    install: `${pm} install`,
+    run: (script) => `${pm} run ${script}`,
+    addLatest: (name) => pm === "npm" ? `npm install ${name}@latest` : `${pm} add ${name}@latest`
+  };
+}
+function addDeployScript(deployDir, pm) {
   const pkgPath = path2.join(process.cwd(), "package.json");
   if (!fs2.existsSync(pkgPath)) {
     warn("package.json\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC5B4 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uCD94\uAC00\uD558\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4");
@@ -1639,7 +1707,7 @@ function addDeployScript(deployDir) {
       );
     } else {
       const deployCmd = `connectbase deploy ${deployDir}`;
-      pkg.scripts.deploy = pkg.scripts.build ? `npm run build && ${deployCmd}` : deployCmd;
+      pkg.scripts.deploy = pkg.scripts.build ? `${pm.run("build")} && ${deployCmd}` : deployCmd;
       success("package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8 \uCD94\uAC00 \uC644\uB8CC");
     }
     fs2.writeFileSync(pkgPath, `${JSON.stringify(pkg, null, 2)}
@@ -2119,10 +2187,10 @@ ${colors.cyan}ConnectBase Update${colors.reset}
       warn(
         `\uC0C8 \uBC84\uC804\uC774 \uC788\uC2B5\uB2C8\uB2E4: v${VERSION} \u2192 v${colors.green}${latestVersion}${colors.reset}`
       );
+      const pm = packageManagerCommands(detectPackageManager(projectRoot));
       log(
-        `  ${colors.cyan}npm install connectbase-client@latest${colors.reset}`
+        `  ${colors.cyan}${pm.addLatest("connectbase-client")}${colors.reset}`
       );
-      log(`  ${colors.cyan}pnpm add connectbase-client@latest${colors.reset}`);
       log("");
     }
   } else {
@@ -2664,8 +2732,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,13 +3811,16 @@ main().catch((err) => {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TunnelConnectSelector,
+  apiErrorMessage,
   computeDeployDiff,
+  detectPackageManager,
   getTunnelConnectCandidates,
   guessMimeType,
   isAllowedDeployExt,
   isBinaryDeployExt,
   makeRequest,
   normalizeRelativePath,
+  packageManagerCommands,
   parseArgs,
   registerEndpointBinding,
   sha256Hex,

package/package.json

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