connectbase-client 6.3.4 → 6.4.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/) 을 따릅니다.
 
+## [6.4.0] - 2026-10-01
+
+### Added — 웹 배포에 브라우저 ML 모델 확장자 허용 (`.onnx` `.tflite` `.task` `.safetensors`)
+
+onnxruntime-web / TensorFlow Lite / MediaPipe Tasks / transformers.js 가 fetch 로 읽는 모델 파일을
+`deploy` 가 허용목록에 없다는 이유로 빠뜨렸습니다. 배포는 성공으로 끝나는데 사이트에서는 404 였습니다.
+이제 네 확장자 모두 바이너리로 수집되며, 웹 스토리지 파일당 한도(약 6 MB)를 넘는 모델은 다른 대용량
+바이너리와 똑같이 presigned URL 로 오브젝트 스토리지에 직접 올라갑니다. `.bin` 으로 이름을 바꾸는
+우회는 더 이상 필요 없습니다.
+
+### Changed — 허용되지 않는 파일이 있으면 배포 때 알려줍니다
+
+허용되지 않는 확장자의 파일은 여전히 배포에서 제외되지만, 이제 조용히 넘어가지 않습니다. 파일 수집
+직후 제외된 파일 목록(앞 10개 + 외 N개), 확장자별 개수, 허용 확장자 목록을 경고로 보여주고, 배포 성공
+메시지 뒤에도 "N개는 포함되지 않았습니다" 를 한 번 더 찍습니다. 숨김 파일/폴더(`.env`, `.git/` 등)는
+의도적 제외라 목록에 넣지 않습니다. 배포 결과(종료 코드)는 바뀌지 않습니다.
+
 ## [6.3.4] - 2026-09-08
 
 ### Fixed — deploy 스크립트가 `npx` 로 CLI 를 부르면 6.3.3 의 "스크립트 안" 판정이 빠지던 문제

package/README.md

@@ -294,7 +294,9 @@ In CI, read the Secret Key from a repository secret:
 ### Requirements
 
 - `index.html` must exist in the root of the deploy directory
-- Supported file types: `.html`, `.css`, `.js`, `.json`, `.svg`, `.png`, `.jpg`, `.gif`, `.webp`, `.woff`, `.woff2`, `.ttf`, `.mp3`, `.mp4`, `.pdf`, `.wasm`, etc.
+- Supported file types: `.html`, `.css`, `.js`, `.json`, `.svg`, `.png`, `.jpg`, `.gif`, `.webp`, `.woff`, `.woff2`, `.ttf`, `.mp3`, `.mp4`, `.pdf`, `.wasm`, 3D assets (`.glb`, `.gltf`, `.bin`), browser ML models (`.onnx`, `.tflite`, `.task`, `.safetensors`), etc.
+- Files with other extensions are skipped, and `deploy` prints the skipped list as a warning. Hidden files and folders (`.env`, `.git/`) are skipped silently.
+- Binary files over the per-file limit (~6 MB) are uploaded directly to object storage via presigned URLs.
 
 ### SPA Mode
 

package/dist/cli.js

@@ -35,8 +35,10 @@ __export(cli_exports, {
   ancestorCommandLines: () => ancestorCommandLines,
   apiErrorMessage: () => apiErrorMessage,
   buildFirstHint: () => buildFirstHint,
+  collectDeployFiles: () => collectDeployFiles,
   computeDeployDiff: () => computeDeployDiff,
   detectPackageManager: () => detectPackageManager,
+  formatSkippedFilesReport: () => formatSkippedFilesReport,
   getTunnelConnectCandidates: () => getTunnelConnectCandidates,
   guessMimeType: () => guessMimeType,
   isAllowedDeployExt: () => isAllowedDeployExt,
@@ -154,7 +156,7 @@ function handleTunnelError(msg, appId, localPort) {
 }
 
 // src/cli.ts
-var VERSION = "6.3.4" ? "6.3.4" : getPackageVersion();
+var VERSION = "6.4.0" ? "6.4.0" : getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
   reset: "\x1B[0m",
@@ -215,7 +217,17 @@ var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([
   // 3D 에셋: .glb/.bin 은 바이너리, .gltf 는 JSON(텍스트)
   ".glb",
   ".gltf",
-  ".bin"
+  ".bin",
+  // 브라우저 추론용 ML 모델 (platform-issue 01a0f660). 전부 바이너리다.
+  //   .onnx        — onnxruntime-web
+  //   .tflite      — TensorFlow Lite (tfjs-tflite 등)
+  //   .task        — MediaPipe Tasks 번들
+  //   .safetensors — transformers.js 등의 가중치
+  // 수 MB~수십 MB 가 흔하므로 BINARY_EXTENSIONS 에도 넣어 대용량 오프로드(presign) 대상으로 만든다.
+  ".onnx",
+  ".tflite",
+  ".task",
+  ".safetensors"
 ]);
 var ALLOWED_EXTENSIONLESS_FILES = /* @__PURE__ */ new Set(["_redirects", "_headers"]);
 var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
@@ -240,7 +252,11 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".zip",
   ".wasm",
   ".glb",
-  ".bin"
+  ".bin",
+  ".onnx",
+  ".tflite",
+  ".task",
+  ".safetensors"
 ]);
 var MIME_BY_EXT = {
   ".png": "image/png",
@@ -266,7 +282,13 @@ var MIME_BY_EXT = {
   ".wasm": "application/wasm",
   ".glb": "model/gltf-binary",
   ".gltf": "model/gltf+json",
-  ".bin": "application/octet-stream"
+  ".bin": "application/octet-stream",
+  // ML 모델은 등록된 표준 MIME 이 없다. 로더(onnxruntime-web/MediaPipe/transformers.js)는
+  // fetch → ArrayBuffer 로 읽으므로 octet-stream 이면 충분하다.
+  ".onnx": "application/octet-stream",
+  ".tflite": "application/octet-stream",
+  ".task": "application/octet-stream",
+  ".safetensors": "application/octet-stream"
 };
 function guessMimeType(filePath) {
   if (ALLOWED_EXTENSIONLESS_FILES.has(path2.basename(filePath))) {
@@ -349,7 +371,13 @@ function loadConfig() {
   }
   return config;
 }
-function collectFiles(dir, baseDir = dir) {
+function collectDeployFiles(dir) {
+  const skipped = [];
+  const files = collectFiles(dir, dir, skipped);
+  skipped.sort();
+  return { files, skipped };
+}
+function collectFiles(dir, baseDir, skipped) {
   const files = [];
   const entries = fs2.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
@@ -357,14 +385,15 @@ function collectFiles(dir, baseDir = dir) {
     const relativePath = path2.relative(baseDir, fullPath);
     if (entry.isDirectory()) {
       if (!entry.name.startsWith(".")) {
-        files.push(...collectFiles(fullPath, baseDir));
+        files.push(...collectFiles(fullPath, baseDir, skipped));
       }
     } else if (entry.isFile()) {
       const ext = path2.extname(entry.name).toLowerCase();
-      if (!isAllowedDeployExt(entry.name)) {
+      if (entry.name.startsWith(".")) {
         continue;
       }
-      if (entry.name.startsWith(".")) {
+      if (!isAllowedDeployExt(entry.name)) {
+        skipped.push(normalizeRelativePath(relativePath));
         continue;
       }
       const isBinary = BINARY_EXTENSIONS.has(ext);
@@ -385,6 +414,44 @@ function collectFiles(dir, baseDir = dir) {
   }
   return files;
 }
+var SKIPPED_FILES_LIST_LIMIT = 10;
+function formatSkippedFilesReport(skipped, limit = SKIPPED_FILES_LIST_LIMIT) {
+  if (skipped.length === 0) return [];
+  const lines = [];
+  lines.push(
+    `\uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 \uD655\uC7A5\uC790\uB77C \uBC30\uD3EC\uC5D0\uC11C \uC81C\uC678\uB41C \uD30C\uC77C ${skipped.length}\uAC1C \u2014 \uC0AC\uC774\uD2B8\uC5D0\uC11C 404 \uAC00 \uB429\uB2C8\uB2E4:`
+  );
+  for (const p of skipped.slice(0, limit)) lines.push(`  \u2022 ${p}`);
+  if (skipped.length > limit) {
+    lines.push(`  \u2026 \uC678 ${skipped.length - limit}\uAC1C`);
+  }
+  const byExt = /* @__PURE__ */ new Map();
+  for (const p of skipped) {
+    const ext = path2.extname(p).toLowerCase() || "(\uD655\uC7A5\uC790 \uC5C6\uC74C)";
+    byExt.set(ext, (byExt.get(ext) ?? 0) + 1);
+  }
+  const extSummary = [...byExt.entries()].sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0])).map(([ext, n]) => `${ext} ${n}\uAC1C`).join(", ");
+  lines.push(`  \uD655\uC7A5\uC790\uBCC4: ${extSummary}`);
+  lines.push(
+    `  \uD5C8\uC6A9 \uD655\uC7A5\uC790: ${[...ALLOWED_EXTENSIONS].join(" ")} (+ \uD655\uC7A5\uC790 \uC5C6\uB294 ${[...ALLOWED_EXTENSIONLESS_FILES].join(", ")})`
+  );
+  lines.push(
+    "  \uD544\uC694\uD55C \uD30C\uC77C\uC774\uBA74 \uD5C8\uC6A9 \uD655\uC7A5\uC790\uB85C \uBC14\uAFB8\uAC70\uB098, \uD30C\uC77C \uC2A4\uD1A0\uB9AC\uC9C0(cb.storage)\uC5D0 \uC62C\uB824 URL \uB85C \uCC38\uC870\uD558\uC138\uC694."
+  );
+  return lines;
+}
+function reportSkippedFiles(skipped) {
+  const lines = formatSkippedFilesReport(skipped);
+  if (lines.length === 0) return;
+  warn(`${colors.yellow}${lines[0]}${colors.reset}`);
+  for (const line of lines.slice(1)) log(line);
+}
+function remindSkippedFiles(skipped) {
+  if (skipped.length === 0) return;
+  warn(
+    `\uB2E8, \uD5C8\uC6A9\uB418\uC9C0 \uC54A\uB294 \uD655\uC7A5\uC790 \uD30C\uC77C ${skipped.length}\uAC1C\uB294 \uBC30\uD3EC\uC5D0 \uD3EC\uD568\uB418\uC9C0 \uC54A\uC558\uC2B5\uB2C8\uB2E4 (\uC704 \uBAA9\uB85D \uCC38\uACE0).`
+  );
+}
 function formatSize(bytes) {
   if (bytes >= 1024 * 1024) return `${(bytes / 1024 / 1024).toFixed(1)} MB`;
   return `${(bytes / 1024).toFixed(1)} KB`;
@@ -699,17 +766,19 @@ async function deploy(directory, config, isDev = false, deployOpts = {}) {
   }
   info(`\uBC30\uD3EC \uC900\uBE44 \uC911... ${dir}`);
   process.stdout.write(`${colors.dim}\uD30C\uC77C \uC218\uC9D1 \uC911...${colors.reset}`);
-  const files = collectFiles(dir);
+  const { files, skipped } = collectDeployFiles(dir);
   process.stdout.write(`\r${colors.dim}                    \r${colors.reset}`);
   if (files.length === 0) {
+    reportSkippedFiles(skipped);
     error("\uBC30\uD3EC\uD560 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4");
     process.exit(1);
   }
   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)`
+    `${colors.green}\u2713${colors.reset} ${files.length}\uAC1C \uD30C\uC77C \uBC1C\uACAC (${sizeKB} KB)${skipped.length > 0 ? ` ${colors.yellow}\u2014 ${skipped.length}\uAC1C \uC81C\uC678${colors.reset}` : ""}`
   );
+  reportSkippedFiles(skipped);
   const target = isDev ? "qa" : void 0;
   const envLabel = isDev ? "QA" : "Prod";
   if (isDev) {
@@ -736,6 +805,7 @@ async function deploy(directory, config, isDev = false, deployOpts = {}) {
         timeoutMs,
         target
       );
+      remindSkippedFiles(skipped);
       return;
     }
     const diff = computeDeployDiff(files, manifest);
@@ -754,6 +824,7 @@ ${colors.cyan}URL: https://${config.storageId}.web.connectbase.world${colors.res
 `
         );
       }
+      remindSkippedFiles(skipped);
       return;
     }
     await offloadLargeBinaries(
@@ -777,6 +848,7 @@ ${colors.cyan}URL: https://${config.storageId}.web.connectbase.world${colors.res
       timeoutMs,
       target
     );
+    remindSkippedFiles(skipped);
   } catch (err) {
     process.stdout.write("\r                    \r");
     error(`\uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
@@ -3880,8 +3952,10 @@ main().catch((err) => {
   ancestorCommandLines,
   apiErrorMessage,
   buildFirstHint,
+  collectDeployFiles,
   computeDeployDiff,
   detectPackageManager,
+  formatSkippedFilesReport,
   getTunnelConnectCandidates,
   guessMimeType,
   isAllowedDeployExt,

package/package.json

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