connectbase-client 6.3.1 → 6.3.3

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/) 을 따릅니다.
 
+## [6.3.3] - 2026-09-08
+
+### Fixed — `deploy` 가 방금 빌드한 직후에도 "배포 전 빌드를 먼저 실행하세요" 를 찍던 문제
+
+package.json 에 build 스크립트만 있으면 무조건 경고했습니다. `pnpm run deploy`(= `vite build &&
+connectbase deploy`) 처럼 빌드를 끝낸 직후 실행돼도 "먼저 빌드하라" 가 찍혀, 방금 올린 배포가
+낡은 것처럼 보였습니다. 명령도 `npm run build` 로 고정돼 있었습니다.
+
+이제 npm / pnpm / yarn / bun 이 스크립트 실행 시 넣어 주는 `npm_lifecycle_event` 가 package.json
+scripts 의 이름이면(=그 스크립트 안에서 실행 중) 안내를 생략합니다. 빌드가 포함된 deploy
+스크립트가 있는데 직접 `connectbase deploy` 를 친 경우엔 그 스크립트를 쓰라고만 안내하고,
+그 외에는 감지된 패키지 매니저의 `run build` 명령으로 안내합니다.
+
+## [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]` 로만 찍히던 문제

package/dist/cli.js

@@ -33,13 +33,16 @@ var cli_exports = {};
 __export(cli_exports, {
   TunnelConnectSelector: () => TunnelConnectSelector,
   apiErrorMessage: () => apiErrorMessage,
+  buildFirstHint: () => buildFirstHint,
   computeDeployDiff: () => computeDeployDiff,
+  detectPackageManager: () => detectPackageManager,
   getTunnelConnectCandidates: () => getTunnelConnectCandidates,
   guessMimeType: () => guessMimeType,
   isAllowedDeployExt: () => isAllowedDeployExt,
   isBinaryDeployExt: () => isBinaryDeployExt,
   makeRequest: () => makeRequest,
   normalizeRelativePath: () => normalizeRelativePath,
+  packageManagerCommands: () => packageManagerCommands,
   parseArgs: () => parseArgs,
   registerEndpointBinding: () => registerEndpointBinding,
   sha256Hex: () => sha256Hex,
@@ -148,7 +151,7 @@ function handleTunnelError(msg, appId, localPort) {
 }
 
 // src/cli.ts
-var VERSION = "6.3.1" ? "6.3.1" : getPackageVersion();
+var VERSION = "6.3.3" ? "6.3.3" : getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
   reset: "\x1B[0m",
@@ -676,14 +679,8 @@ async function deploy(directory, config, isDev = false, deployOpts = {}) {
   if (fs2.existsSync(pkgPath)) {
     try {
       const pkg = JSON.parse(fs2.readFileSync(pkgPath, "utf-8"));
-      if (pkg.scripts?.build) {
-        warn(
-          `\uBC30\uD3EC \uC804 \uBE4C\uB4DC\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694: ${colors.cyan}npm run build && npx connectbase-client deploy${colors.reset}`
-        );
-        warn(
-          `\uB610\uB294 package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uB4F1\uB85D\uD558\uC138\uC694: ${colors.cyan}npx connectbase-client init${colors.reset}`
-        );
-      }
+      const pm = packageManagerCommands(detectPackageManager(process.cwd()));
+      for (const line of buildFirstHint(pkg, pm)) warn(line);
     } catch {
     }
   }
@@ -1583,7 +1580,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}
@@ -1591,10 +1589,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}
 `);
@@ -1644,7 +1642,61 @@ ${entry}
     success(".gitignore \uC0DD\uC131 \uC644\uB8CC");
   }
 }
-function addDeployScript(deployDir) {
+function buildFirstHint(pkg, pm, lifecycleEvent = process.env.npm_lifecycle_event) {
+  const scripts = pkg?.scripts ?? {};
+  if (!scripts.build) return [];
+  if (lifecycleEvent && Object.keys(scripts).includes(lifecycleEvent)) {
+    return [];
+  }
+  if (typeof scripts.deploy === "string" && scripts.deploy.includes("build")) {
+    return [
+      `\uBE4C\uB4DC\uAE4C\uC9C0 \uD55C \uBC88\uC5D0 \uD558\uB824\uBA74 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uC4F0\uC138\uC694: ${pm.run("deploy")}`
+    ];
+  }
+  return [
+    `\uBC30\uD3EC \uC804 \uBE4C\uB4DC\uB97C \uBA3C\uC800 \uC2E4\uD589\uD558\uC138\uC694: ${pm.run("build")} && npx connectbase-client deploy`,
+    "\uB610\uB294 package.json\uC5D0 deploy \uC2A4\uD06C\uB9BD\uD2B8\uB97C \uB4F1\uB85D\uD558\uC138\uC694: npx connectbase-client init"
+  ];
+}
+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");
@@ -1666,7 +1718,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)}
@@ -2146,10 +2198,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 {
@@ -3771,13 +3823,16 @@ main().catch((err) => {
 0 && (module.exports = {
   TunnelConnectSelector,
   apiErrorMessage,
+  buildFirstHint,
   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.1",
+	"version": "6.3.3",
 	"description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
 	"repository": {
 		"type": "git",