connectbase-client 6.7.0 → 6.9.0

package/CHANGELOG.md

@@ -3,6 +3,62 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [6.9.0] - 2026-10-30
+
+### Added — 확장자 없는 파일 배포: `deploy --include-extensionless`
+
+무작위 이름의 데이터 파일처럼 확장자 없이 서빙해야 하는 파일을 웹 스토리지에 배포할 수 있습니다. 켜면 확장자 없는
+파일을 바이너리로 올리고(한도를 넘는 큰 파일은 presigned 직접 업로드), 사이트는 `application/octet-stream` 으로
+바이트 그대로 서빙합니다(추적 스크립트 주입, gzip 없음, Range 지원, 캐시 1시간).
+
+```bash
+npx connectbase-client deploy ./dist --include-extensionless
+```
+
+`.connectbaserc` 에 `"includeExtensionless": true` 를 넣어도 같습니다. 기본값은 지금처럼 제외입니다 — `deploy` 의
+기본 디렉터리가 `.` 이라 프로젝트 루트를 배포하면 Dockerfile, LICENSE, 키 파일(id_rsa, kubeconfig 등) 같은 확장자
+없는 파일이 공개될 수 있어서입니다. 켜도 숨김 파일과 폴더(`.env`, `.ssh/` 등)는 여전히 제외되고, `_redirects`,
+`_headers` 는 지금처럼 텍스트 사이트 설정 파일로 올라갑니다. 확장자 없는 파일이 제외되면 제외 목록 경고에 켜는 방법이
+함께 나옵니다.
+
+서빙은 2026-10-30 이후 서버(manifest 항목의 `binary` 표시)가 필요합니다. 그 전 배포에 들어 있던 확장자 없는 경로는
+지금처럼 HTML(SPA 라우트)로 다룹니다.
+
+### Added — `.mvx` 허용
+
+`.mvx`(사이트 자체 형식의 3D/자료 파일)를 바이너리 허용 확장자로 추가했습니다. `application/octet-stream`, 캐시
+1시간으로 서빙되며, 큰 파일은 presigned 경로로 자동 오프로드됩니다.
+
+## [6.8.0] - 2026-10-23
+
+### Added — 서버 코드에서 토픽 만들기: `cb.push.createTopic(appId, name, options?)`
+
+방마다 쓰는 토픽(`cc_<room>` 같은)을 서버 코드가 만들어 두고, 기기는 그 뒤에 `subscribeTopic` 으로 구독합니다. 같은
+이름의 토픽이 이미 있으면 오류 없이 그 토픽을 돌려줍니다(설정은 바꾸지 않습니다) — 트리거가 다시 실행돼도 안전합니다.
+공개 키(cb_pk_) 단독 인스턴스로는 호출할 수 없고, 함수의 `ctx.cbAdmin` 은 management_scopes 에 `push:write` 가 있어야
+합니다(platform-issue 01a167dd). 함수는 배포할 때 이 SDK 의 최신 판을 설치하므로, 쓰려면 함수를 다시 배포하세요.
+
+```ts
+// concerts 트리거 함수
+await ctx.cbAdmin.push.createTopic(appId, `cc_${row.room}`, { displayName: row.title })
+```
+
+### Fixed — 웹 푸시 기기의 토픽 구독과 등록 해제
+
+`registerWebPush` 로 등록한 브라우저 기기를 `subscribeTopic` / `unsubscribeTopic` 으로 구독시키지 못했고,
+`unregisterWebPush` 도 실패했습니다. 웹 푸시 기기의 `device_token` 은 endpoint URL(`https://…/send/…`, 슬래시 포함)인데
+SDK 가 그 값을 요청 경로에 넣어 서버 라우트가 맞지 않았습니다(인코딩해도 서버 라우팅 전에 풀립니다). 이제 기기 토큰은
+요청 본문으로 보냅니다(`POST /v1/public/push/topics/subscribe`, `/topics/unsubscribe`, `/devices/unregister`) — 네이티브
+(FCM, APNs) 기기도 같은 방법으로 동작하며, 호출 방법은 그대로입니다(platform-issue 01a167dd).
+
+```ts
+const device = await cb.push.registerWebPush(subscription)
+await cb.push.subscribeTopic(device.device_token, 'announcements') // 토픽은 콘솔에서 미리 만든다
+```
+
+이 판은 위 엔드포인트가 있는 서버(2026-10-23 배포)가 필요합니다. 예전 판(경로에 토큰)도 네이티브 기기에서는 계속
+동작합니다.
+
 ## [6.7.0] - 2026-10-22
 
 ### Added — 서버가 검증한 보낸 사람: `message.fromMember`

package/README.md

@@ -294,7 +294,8 @@ 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`, 3D assets (`.glb`, `.gltf`, `.bin`), browser ML models (`.onnx`, `.tflite`, `.task`, `.safetensors`), etc.
+- Supported file types: `.html`, `.css`, `.js`, `.json`, `.svg`, `.png`, `.jpg`, `.gif`, `.webp`, `.woff`, `.woff2`, `.ttf`, `.mp3`, `.mp4`, `.pdf`, `.wasm`, 3D/data assets (`.glb`, `.gltf`, `.bin`, `.mvx`), browser ML models (`.onnx`, `.tflite`, `.task`, `.safetensors`), etc.
+- Files without an extension (e.g. randomly named data files) are skipped by default so that a project-root deploy does not publish files like `Dockerfile` or `id_rsa`. Pass `--include-extensionless` (or set `"includeExtensionless": true` in `.connectbaserc`) to deploy them as binary; they are served as `application/octet-stream` byte for byte (requires 6.9.0+).
 - 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.
 
@@ -1108,7 +1109,7 @@ try {
 ```
 
 방송인 여부는 구독할 때 정해집니다. 멤버 역할이나 카테고리 설정을 바꾸면 다시 구독(또는 재연결)할 때 반영되고,
-카테고리 설정은 서버 캐시 때문에 최대 5분 뒤에 반영됩니다. room 채널(v6.7.0)은 room 인가 함수가 `publisher: true` 로
+카테고리 설정은 저장하면 몇 초 안에 서버 전체에 퍼집니다. room 채널(v6.7.0)은 room 인가 함수가 `publisher: true` 로
 room 마다 방송인을 정할 수도 있습니다(위 "Rooms").
 
 #### Presence / Typing
@@ -1431,7 +1432,17 @@ const subscription = await registration.pushManager.subscribe({
   userVisibleOnly: true,
   applicationServerKey: vapidKey.public_key
 })
-await cb.push.registerWebPush(subscription)
+const webDevice = await cb.push.registerWebPush(subscription)
+// Browser devices subscribe the same way (v6.8.0+: device_token is the endpoint URL)
+await cb.push.subscribeTopic(webDevice.device_token, 'news')
+```
+
+Topics must exist before devices subscribe; subscribing to an unknown topic fails with 404. Create them in the console,
+or from server code (v6.8.0+, not available to public-key-only instances):
+
+```typescript
+// e.g. in a database trigger function: one topic per room, safe to call again (returns the existing topic)
+await ctx.cbAdmin.push.createTopic(ctx.appId, `cc_${room}`, { displayName: title })
 ```
 
 ### WebRTC

package/dist/cli.js

@@ -43,6 +43,7 @@ __export(cli_exports, {
   guessMimeType: () => guessMimeType,
   isAllowedDeployExt: () => isAllowedDeployExt,
   isBinaryDeployExt: () => isBinaryDeployExt,
+  isExtensionlessDataFile: () => isExtensionlessDataFile,
   makeRequest: () => makeRequest,
   normalizeRelativePath: () => normalizeRelativePath,
   packageManagerCommands: () => packageManagerCommands,
@@ -156,7 +157,7 @@ function handleTunnelError(msg, appId, localPort) {
 }
 
 // src/cli.ts
-var VERSION = "6.7.0" ? "6.7.0" : getPackageVersion();
+var VERSION = "6.9.0" ? "6.9.0" : getPackageVersion();
 var DEFAULT_BASE_URL = "https://api.connectbase.world";
 var colors = {
   reset: "\x1B[0m",
@@ -218,6 +219,8 @@ var ALLOWED_EXTENSIONS = /* @__PURE__ */ new Set([
   ".glb",
   ".gltf",
   ".bin",
+  // 사이트 자체 형식의 3D/자료 파일(바이너리, 2026-10-30). 브라우저는 fetch 로만 읽는다.
+  ".mvx",
   // 브라우저 추론용 ML 모델 (platform-issue 01a0f660). 전부 바이너리다.
   //   .onnx        — onnxruntime-web
   //   .tflite      — TensorFlow Lite (tfjs-tflite 등)
@@ -253,6 +256,7 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".wasm",
   ".glb",
   ".bin",
+  ".mvx",
   ".onnx",
   ".tflite",
   ".task",
@@ -283,6 +287,7 @@ var MIME_BY_EXT = {
   ".glb": "model/gltf-binary",
   ".gltf": "model/gltf+json",
   ".bin": "application/octet-stream",
+  ".mvx": "application/octet-stream",
   // ML 모델은 등록된 표준 MIME 이 없다. 로더(onnxruntime-web/MediaPipe/transformers.js)는
   // fetch → ArrayBuffer 로 읽으므로 octet-stream 이면 충분하다.
   ".onnx": "application/octet-stream",
@@ -305,6 +310,10 @@ function isAllowedDeployExt(filePath) {
 function isBinaryDeployExt(filePath) {
   return BINARY_EXTENSIONS.has(path2.extname(filePath).toLowerCase());
 }
+function isExtensionlessDataFile(filePath) {
+  const base = path2.basename(filePath);
+  return path2.extname(base) === "" && !ALLOWED_EXTENSIONLESS_FILES.has(base);
+}
 var WEB_FILE_MAX_STORED_BYTES = 6 * 1024 * 1024 - 64 * 1024;
 function sha256Hex(value) {
   return crypto.createHash("sha256").update(value, "utf8").digest("hex");
@@ -365,19 +374,21 @@ function loadConfig() {
       if (rcContent.storageId) config.storageId = rcContent.storageId;
       if (rcContent.baseUrl) config.baseUrl = rcContent.baseUrl;
       if (rcContent.deployDir) config.deployDir = rcContent.deployDir;
+      if (rcContent.includeExtensionless === true)
+        config.includeExtensionless = true;
     } catch {
       warn(".connectbaserc \uD30C\uC77C\uC744 \uC77D\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4");
     }
   }
   return config;
 }
-function collectDeployFiles(dir) {
+function collectDeployFiles(dir, options = {}) {
   const skipped = [];
-  const files = collectFiles(dir, dir, skipped);
+  const files = collectFiles(dir, dir, skipped, options);
   skipped.sort();
   return { files, skipped };
 }
-function collectFiles(dir, baseDir, skipped) {
+function collectFiles(dir, baseDir, skipped, options) {
   const files = [];
   const entries = fs2.readdirSync(dir, { withFileTypes: true });
   for (const entry of entries) {
@@ -385,18 +396,19 @@ function collectFiles(dir, baseDir, skipped) {
     const relativePath = path2.relative(baseDir, fullPath);
     if (entry.isDirectory()) {
       if (!entry.name.startsWith(".")) {
-        files.push(...collectFiles(fullPath, baseDir, skipped));
+        files.push(...collectFiles(fullPath, baseDir, skipped, options));
       }
     } else if (entry.isFile()) {
       const ext = path2.extname(entry.name).toLowerCase();
       if (entry.name.startsWith(".")) {
         continue;
       }
-      if (!isAllowedDeployExt(entry.name)) {
+      const extensionlessData = options.includeExtensionless === true && isExtensionlessDataFile(entry.name);
+      if (!extensionlessData && !isAllowedDeployExt(entry.name)) {
         skipped.push(normalizeRelativePath(relativePath));
         continue;
       }
-      const isBinary = BINARY_EXTENSIONS.has(ext);
+      const isBinary = extensionlessData || BINARY_EXTENSIONS.has(ext);
       let content;
       if (isBinary) {
         content = fs2.readFileSync(fullPath).toString("base64");
@@ -438,6 +450,11 @@ function formatSkippedFilesReport(skipped, limit = SKIPPED_FILES_LIST_LIMIT) {
   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."
   );
+  if (skipped.some((p) => isExtensionlessDataFile(p))) {
+    lines.push(
+      '  \uD655\uC7A5\uC790 \uC5C6\uB294 \uD30C\uC77C\uC740 --include-extensionless (\uB610\uB294 .connectbaserc \uC758 "includeExtensionless": true) \uB85C \uBC14\uC774\uB108\uB9AC(application/octet-stream)\uB85C \uBC30\uD3EC\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.'
+    );
+  }
   return lines;
 }
 function reportSkippedFiles(skipped) {
@@ -766,8 +783,18 @@ 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, skipped } = collectDeployFiles(dir);
+  const { files, skipped } = collectDeployFiles(dir, {
+    includeExtensionless: deployOpts.includeExtensionless
+  });
   process.stdout.write(`\r${colors.dim}                    \r${colors.reset}`);
+  if (deployOpts.includeExtensionless) {
+    const extensionless = files.filter((f) => isExtensionlessDataFile(f.path));
+    if (extensionless.length > 0) {
+      info(
+        `\uD655\uC7A5\uC790 \uC5C6\uB294 \uD30C\uC77C ${extensionless.length}\uAC1C\uB97C \uBC14\uC774\uB108\uB9AC(application/octet-stream)\uB85C \uD3EC\uD568\uD569\uB2C8\uB2E4 (--include-extensionless)`
+      );
+    }
+  }
   if (files.length === 0) {
     reportSkippedFiles(skipped);
     error("\uBC30\uD3EC\uD560 \uD30C\uC77C\uC774 \uC5C6\uC2B5\uB2C8\uB2E4");
@@ -3670,6 +3697,7 @@ ${colors.yellow}\uC635\uC158:${colors.reset}
   --label <name>        Endpoint binding \uC790\uB3D9 \uB4F1\uB85D (tunnel \uC804\uC6A9) \u2014 SDK \uC758 cb.endpoint.call(label) \uD638\uCD9C \uAC00\uB2A5
   --description <text>  Endpoint binding \uC124\uBA85 (--label \uB3D9\uBC18 \uC2DC\uB9CC)
   -d, --dev             QA \uD658\uACBD\uC5D0\uB9CC \uBC30\uD3EC (deploy \uC804\uC6A9, deprecated \u2014 QA \uBCC4\uCE6D)
+  --include-extensionless  \uD655\uC7A5\uC790 \uC5C6\uB294 \uD30C\uC77C\uB3C4 \uBC14\uC774\uB108\uB9AC(application/octet-stream)\uB85C \uBC30\uD3EC (deploy \uC804\uC6A9, \uAE30\uBCF8: \uC81C\uC678)
   -y, --yes             \uBE44\uB300\uD654\uD615 \uCD08\uAE30\uD654 \u2014 \uD504\uB86C\uD504\uD2B8 \uC5C6\uC774 \uAE30\uBCF8\uAC12/\uD50C\uB798\uADF8\uB85C \uC9C4\uD589 (init \uC804\uC6A9, CI/AI \uC5D0\uC774\uC804\uD2B8\uC6A9)
   -a, --app <id>        \uAE30\uC874 \uC571 ID \uC9C0\uC815 (init \uC804\uC6A9)
   --secret-key <key>    Secret Key (cb_sk_) \uC9C0\uC815 (init/mcp)
@@ -3727,7 +3755,8 @@ ${colors.yellow}\uC124\uC815 \uD30C\uC77C (.connectbaserc):${colors.reset}
     "publicKey": "cb_pk_...",
     "secretKey": "cb_sk_...",
     "storageId": "your-storage-id",
-    "deployDir": "./dist"
+    "deployDir": "./dist",
+    "includeExtensionless": false   ${colors.dim}// true \uBA74 \uD655\uC7A5\uC790 \uC5C6\uB294 \uD30C\uC77C\uB3C4 \uBC30\uD3EC (= --include-extensionless)${colors.reset}
   }
 `);
 }
@@ -3771,6 +3800,8 @@ function parseArgs(args) {
       result.options.showToken = "true";
     } else if (arg === "-d" || arg === "--dev") {
       result.options.dev = "true";
+    } else if (arg === "--include-extensionless") {
+      result.options.includeExtensionless = "true";
     } else if (arg === "--check") {
       result.options.check = "true";
     } else if (arg === "--skip-docs") {
@@ -3845,7 +3876,9 @@ async function main() {
       process.exit(1);
     }
     const isDev = parsed.options.dev === "true";
-    const deployOpts = {};
+    const deployOpts = {
+      includeExtensionless: parsed.options.includeExtensionless === "true" || fileConfig.includeExtensionless === true
+    };
     if (parsed.options.timeout) {
       const t = parseInt(parsed.options.timeout, 10);
       if (!Number.isNaN(t) && t > 0) deployOpts.timeoutMs = t * 1e3;
@@ -3960,6 +3993,7 @@ main().catch((err) => {
   guessMimeType,
   isAllowedDeployExt,
   isBinaryDeployExt,
+  isExtensionlessDataFile,
   makeRequest,
   normalizeRelativePath,
   packageManagerCommands,