connectbase-client 1.7.0 → 1.8.0

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [1.8.0] - 2026-04-19
+
+웹 스토리지 CLI 배포(`connectbase deploy ./dist`) 를 manifest 기반 **증분 업로드** 로 재구성. 동일 dist 재배포는 거의 즉시 완료되고, 일부만 바뀐 경우 변경분만 전송한다. 서버 DB 쓰기도 단일 트랜잭션 + bulk insert 로 묶어 전체 배포 시간이 짧아짐.
+
+### Added — 증분 배포
+
+- **`GET /v1/public/storages/webs/:storageID/deploy/manifest`** — 현재 배포된 파일의 `path/size/hash(sha256)` 와 결정적 `revision` 반환.
+- **`POST /v1/public/storages/webs/:storageID/deploy/incremental`** — `{ upsert, delete, base_revision? }` 변경분만 적용. 서버가 hash 를 재검증하고 단일 트랜잭션으로 upsert/delete 처리 후 기존 배포 파이프라인으로 Object Storage 에 전체 업로드.
+- CLI 는 prod 배포 시 자동으로 manifest → diff → incremental 순서를 사용한다. 변경 없음이면 `✓ 변경사항 없음` 출력 후 종료.
+- `base_revision` 은 옵션. 동시 배포 경합에서 `409 Conflict` 면 manifest 재조회 후 1회 자동 재시도.
+
+### Changed — 서버 배포 속도 개선 (기존 `/deploy` 포함)
+
+- `CLIDeploy` 가 파일/폴더별 개별 트랜잭션을 단일 트랜잭션 + depth-batch `CreateBulk` 로 교체. 수십~수백 개의 `BEGIN/COMMIT` 왕복이 1회로 축소.
+- 실패 시 기존 파일도 함께 롤백되어 **실패한 배포가 스토리지를 비우는 회귀가 사라짐** (과거엔 DeleteAll 이 선행되고 이후 SaveFile 이 실패하면 스토리지가 빈 상태로 남았음).
+
+### Compatibility
+
+- **구버전 서버**: manifest 엔드포인트 404 → 기존 `/deploy` 전량 업로드로 자동 폴백.
+- **구버전 SDK** (`1.7.x` 이하): 기존 `/deploy` 는 그대로 동작 (내부 로직만 최적화됨).
+- **Dev 배포** (`connectbase deploy --dev`) 는 Object Storage 에 직접 업로드하는 구조상 증분 적용 불가 — 항상 전량 업로드 유지.
+
+### Internal — DB 스키마
+
+- `storage_web_file.content_hash` 컬럼 추가 (Optional, Default `""`). 기존 row 는 manifest 최초 조회 시 lazy backfill.
+
 ## [1.7.0] - 2026-04-19
 
 콘솔(JWT) DB 관리 API 경로 정정 — 기존 메서드들이 실제로 존재하지 않는 라우트(`/v1/apps/:appID/tables/:tableID/...`, `/v1/apps/:appID/triggers`, `/v1/apps/:appID/security/rules`, `/v1/apps/:appID/tables/:tableID/relations`) 를 호출해 서버가 항상 404 를 반환하던 문제를 수정.

package/dist/cli.js

@@ -6,6 +6,10 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -22,8 +26,16 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/cli.ts
+var cli_exports = {};
+__export(cli_exports, {
+  computeDeployDiff: () => computeDeployDiff,
+  normalizeRelativePath: () => normalizeRelativePath,
+  sha256Hex: () => sha256Hex
+});
+module.exports = __toCommonJS(cli_exports);
 var fs2 = __toESM(require("fs"));
 var path2 = __toESM(require("path"));
 var crypto = __toESM(require("crypto"));
@@ -200,6 +212,14 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".zip",
   ".wasm"
 ]);
+function sha256Hex(value) {
+  return crypto.createHash("sha256").update(value, "utf8").digest("hex");
+}
+function normalizeRelativePath(relativePath) {
+  let p = relativePath.replace(/\\/g, "/");
+  if (!p.startsWith("/")) p = `/${p}`;
+  return p;
+}
 function loadConfig() {
   const config = {
     publicKey: process.env.CONNECTBASE_PUBLIC_KEY,
@@ -247,11 +267,12 @@ function collectFiles(dir, baseDir = dir) {
       } else {
         content = fs2.readFileSync(fullPath, "utf-8");
       }
+      const normalized = normalizeRelativePath(relativePath);
       files.push({
-        path: relativePath.replace(/\\/g, "/"),
-        // Windows 경로 변환
+        path: normalized,
         content,
-        isBinary
+        isBinary,
+        hash: sha256Hex(content)
       });
     }
   }
@@ -337,47 +358,133 @@ async function deploy(directory, config, isDev = false) {
   const totalSize = files.reduce((sum, f) => sum + f.content.length, 0);
   const sizeKB = (totalSize / 1024).toFixed(1);
   log(`${colors.green}\u2713${colors.reset} ${files.length}\uAC1C \uD30C\uC77C \uBC1C\uACAC (${sizeKB} KB)`);
-  const deployPath = isDev ? "deploy/dev" : "deploy";
-  const url = `${config.baseUrl}/v1/public/storages/webs/${config.storageId}/${deployPath}`;
   const envLabel = isDev ? "Dev" : "Prod";
-  process.stdout.write(`${colors.blue}\u27F3${colors.reset} ${envLabel} \uBC30\uD3EC \uC911...`);
+  const baseStorageUrl = `${config.baseUrl}/v1/public/storages/webs/${config.storageId}`;
+  const headers = { "X-Public-Key": config.publicKey };
+  if (isDev) {
+    await fullDeploy(baseStorageUrl, headers, files, envLabel, "deploy/dev");
+    return;
+  }
   try {
-    const response = await makeRequest(
-      url,
-      "POST",
-      {
-        "X-Public-Key": config.publicKey ?? config.publicKey
-      },
-      JSON.stringify({
-        files: files.map((f) => ({
-          path: f.path,
-          content: f.content,
-          is_binary: f.isBinary
-        }))
-      })
-    );
+    const manifest = await tryFetchManifest(baseStorageUrl, headers);
+    if (!manifest) {
+      await fullDeploy(baseStorageUrl, headers, files, envLabel, "deploy");
+      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(`
+${colors.cyan}URL: https://${config.storageId}.web.connectbase.world${colors.reset}
+`);
+      return;
+    }
+    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);
+  } catch (err) {
     process.stdout.write("\r                    \r");
-    if (response.status >= 200 && response.status < 300) {
-      success(`${envLabel} \uBC30\uD3EC \uC644\uB8CC!`);
-      const data = response.data;
-      if (data?.dev_url) {
-        log(`
+    error(`\uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
+    process.exit(1);
+  }
+}
+async function tryFetchManifest(baseStorageUrl, headers) {
+  const res = await makeRequest(`${baseStorageUrl}/deploy/manifest`, "GET", 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}`);
+  }
+  const parsed = res.data;
+  if (!parsed || !Array.isArray(parsed.files)) {
+    return null;
+  }
+  return parsed;
+}
+function computeDeployDiff(local, manifest) {
+  const localByPath = /* @__PURE__ */ new Map();
+  for (const f of local) localByPath.set(f.path, f);
+  const remoteByPath = /* @__PURE__ */ new Map();
+  for (const m of manifest.files) remoteByPath.set(m.path, m);
+  const upsert = [];
+  for (const f of local) {
+    const remote = remoteByPath.get(f.path);
+    if (!remote || remote.hash !== f.hash || !remote.hash) {
+      upsert.push({
+        path: f.path,
+        content: f.content,
+        is_binary: f.isBinary,
+        hash: f.hash
+      });
+    }
+  }
+  const toDelete = [];
+  for (const m of manifest.files) {
+    if (!localByPath.has(m.path)) toDelete.push(m.path);
+  }
+  return { upsert, delete: toDelete };
+}
+async function incrementalDeploy(baseStorageUrl, headers, diff, baseRevision, envLabel) {
+  process.stdout.write(`${colors.blue}\u27F3${colors.reset} ${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");
+  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);
+    if (!manifest) {
+      error("\uC7AC\uC2DC\uB3C4 manifest \uC870\uD68C \uC2E4\uD328");
+      process.exit(1);
+    }
+    const body2 = JSON.stringify({
+      upsert: diff.upsert,
+      delete: diff.delete,
+      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");
+    handleDeployResponse(res2, envLabel);
+    return;
+  }
+  handleDeployResponse(res, envLabel);
+}
+async function fullDeploy(baseStorageUrl, headers, files, envLabel, endpoint) {
+  process.stdout.write(`${colors.blue}\u27F3${colors.reset} ${envLabel} \uBC30\uD3EC \uC911...`);
+  const body = JSON.stringify({
+    files: files.map((f) => ({
+      path: f.path,
+      content: f.content,
+      is_binary: f.isBinary
+    }))
+  });
+  const res = await makeRequest(`${baseStorageUrl}/${endpoint}`, "POST", headers, body);
+  process.stdout.write("\r                    \r");
+  handleDeployResponse(res, envLabel);
+}
+function handleDeployResponse(response, envLabel) {
+  if (response.status >= 200 && response.status < 300) {
+    success(`${envLabel} \uBC30\uD3EC \uC644\uB8CC!`);
+    const data = response.data;
+    if (data?.dev_url) {
+      log(`
 ${colors.yellow}Dev URL: ${data.dev_url}${colors.reset}
 `);
-      } else if (data?.url) {
-        log(`
+    } else if (data?.url) {
+      log(`
 ${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}`;
-      error(`\uBC30\uD3EC \uC2E4\uD328: ${errorMsg}`);
-      process.exit(1);
     }
-  } catch (err) {
-    process.stdout.write("\r                    \r");
-    error(`\uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
+  } 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}`;
+    error(`\uBC30\uD3EC \uC2E4\uD328: ${errorMsg}`);
     process.exit(1);
   }
 }
@@ -2117,3 +2224,9 @@ main().catch((err) => {
   error(err.message);
   process.exit(1);
 });
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  computeDeployDiff,
+  normalizeRelativePath,
+  sha256Hex
+});

package/package.json

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