connectbase-client 3.5.0 → 3.5.2

package/CHANGELOG.md

@@ -3,6 +3,44 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.5.2] - 2026-05-01
+
+### Fixed — `connectbase tunnel --label` / `--description` 옵션이 파싱되지 않던 문제
+
+3.5.1 의 인증 헤더 / `await` 수정에도 불구하고 `--label` / `--description` 으로
+endpoint binding 자동 등록이 한 번도 트리거되지 않던 문제를 수정했습니다.
+원인은 `parseArgs()` 의 옵션 파싱 분기 자체가 두 옵션을 매칭하지 않아
+`parsed.options.label === undefined` 로 떨어지고, 결과적으로
+`if (tunnelOpts?.label && tunnelUrl)` 가드가 항상 false 가 되어
+`registerEndpointBinding()` 이 호출되지 않았던 것입니다.
+
+- `parseArgs()` 의 while 루프에 `--label` / `--description` 분기 추가
+  (기존 `--storage` / `--max-body` 와 동일 패턴).
+- `parseArgs()` 를 `export` 로 노출 + `test/cli-parse-args.test.ts` 회귀 테스트
+  추가 — `--label` 단독 / `--label` + `--description` 조합 / 미지정 / `--description`
+  단독 4 가지 케이스를 검증해 동일 회귀 차단.
+
+회귀 영향 범위: 3.5.1 에서 `--label` / `--description` 을 사용했던 모든 호출
+(즉 endpoint binding 자동 등록 기능 전체). 다른 옵션·기본 `tunnel` 동작에는 영향 없음.
+
+## [3.5.1] - 2026-05-01
+
+### Fixed — `connectbase tunnel --label` endpoint 자동 등록 401
+
+`--label` 옵션 사용 시 호출되는 `POST /v1/apps/:appID/endpoints/cli` 가 모든 요청에서
+401 ("유효하지 않은 토큰입니다") 으로 떨어져 endpoint binding 이 한 번도 등록되지
+않던 문제를 수정했습니다. 결과적으로 `cb.endpoint.call("label", ...)` 가 항상
+`endpoint not found` (404) 로 실패했습니다.
+
+- CLI 가 `Authorization: Bearer cb_sk_*` 로 호출하던 것을 서버 dual-auth 미들웨어가
+  요구하는 **`X-Public-Key: cb_sk_*`** 헤더로 변경.
+- `void registerEndpointBinding(...)` 의 fire-and-forget 호출을 `await` 로 변경 —
+  성공/실패 메시지가 "Ctrl+C 로 종료" 안내 앞에 출력됨.
+- 등록 실패 / 네트워크 오류는 stdout 이 아닌 **stderr** (빨간색 ✗) 로 출력 —
+  파이프/리다이렉트 환경에서도 사용자가 실패를 인지할 수 있도록.
+
+회귀 영향 범위: `--label` 사용자만 해당 (기본 `connectbase tunnel <port>` 는 영향 없음).
+
 ## [3.5.0] - 2026-04-30
 
 ### Added — Knowledge Base 사용자별 격리

package/dist/cli.js

@@ -33,6 +33,7 @@ var cli_exports = {};
 __export(cli_exports, {
   computeDeployDiff: () => computeDeployDiff,
   normalizeRelativePath: () => normalizeRelativePath,
+  parseArgs: () => parseArgs,
   sha256Hex: () => sha256Hex
 });
 module.exports = __toCommonJS(cli_exports);
@@ -1571,7 +1572,7 @@ async function registerEndpointBinding(baseUrl, appId, secretKey, tunnelUrl, lab
     const host = u.hostname;
     const tunnelId = host.replace(/\.tunnel\.connectbase\.world$/, "");
     if (!tunnelId || tunnelId === host) {
-      log(`${colors.yellow}\u26A0  tunnel_id \uCD94\uCD9C \uC2E4\uD328 (${tunnelUrl}) \u2014 endpoint \uC790\uB3D9 \uB4F1\uB85D skip${colors.reset}`);
+      error(`tunnel_id \uCD94\uCD9C \uC2E4\uD328 (${tunnelUrl}) \u2014 endpoint "${label}" \uC790\uB3D9 \uB4F1\uB85D skip`);
       return;
     }
     const apiBase = baseUrl.replace(/\/+$/, "");
@@ -1579,7 +1580,7 @@ async function registerEndpointBinding(baseUrl, appId, secretKey, tunnelUrl, lab
       method: "POST",
       headers: {
         "Content-Type": "application/json",
-        "Authorization": `Bearer ${secretKey}`
+        "X-Public-Key": secretKey
       },
       body: JSON.stringify({
         label,
@@ -1591,13 +1592,16 @@ async function registerEndpointBinding(baseUrl, appId, secretKey, tunnelUrl, lab
       success(`Endpoint "${label}" \uC790\uB3D9 \uB4F1\uB85D \uC644\uB8CC`);
       log(`${colors.green}\u2192${colors.reset} SDK: ${colors.cyan}cb.endpoint.call("${label}", { path: "/...", method: "POST", body: ... })${colors.reset}`);
     } else if (res.status === 409) {
-      log(`${colors.yellow}\u26A0  "${label}" \uB77C\uBCA8\uC774 \uC774\uBBF8 \uB4F1\uB85D\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.${colors.reset} \uC0C8 tunnel_id \uB85C \uAC31\uC2E0\uD558\uB824\uBA74 \uCF58\uC194\uC5D0\uC11C \uC218\uB3D9 PATCH.`);
+      warn(`"${label}" \uB77C\uBCA8\uC774 \uC774\uBBF8 \uB4F1\uB85D\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4. \uC0C8 tunnel_id \uB85C \uAC31\uC2E0\uD558\uB824\uBA74 \uCF58\uC194\uC5D0\uC11C \uC218\uB3D9 PATCH.`);
     } else {
       const text = await res.text().catch(() => "");
-      log(`${colors.yellow}\u26A0  endpoint \uB4F1\uB85D \uC2E4\uD328 (status ${res.status}): ${text}${colors.reset}`);
+      error(`Endpoint "${label}" \uC790\uB3D9 \uB4F1\uB85D \uC2E4\uD328 (status ${res.status}): ${text || "(\uBE48 \uC751\uB2F5)"}`);
+      if (res.status === 401) {
+        info("cb_sk_ Secret Key \uC778\uC9C0, \uCF58\uC194\uC5D0\uC11C \uD68C\uC218\uB418\uC9C0 \uC54A\uC558\uB294\uC9C0 \uD655\uC778\uD558\uC138\uC694.");
+      }
     }
   } catch (err) {
-    log(`${colors.yellow}\u26A0  endpoint \uB4F1\uB85D \uC911 \uC5D0\uB7EC: ${err instanceof Error ? err.message : err}${colors.reset}`);
+    error(`Endpoint "${label}" \uC790\uB3D9 \uB4F1\uB85D \uC911 \uB124\uD2B8\uC6CC\uD06C \uC624\uB958: ${err instanceof Error ? err.message : err}`);
   }
 }
 function acquireTunnelLock2(appID, port, force) {
@@ -1736,7 +1740,9 @@ ${colors.cyan}ConnectBase Tunnel${colors.reset}`);
         onMessage: (data) => {
           try {
             const msg = JSON.parse(data);
-            handleMessage(msg, sock, port);
+            handleMessage(msg, sock, port).catch((e) => {
+              error(`\uBA54\uC2DC\uC9C0 \uCC98\uB9AC \uC911 \uC608\uC678: ${e instanceof Error ? e.message : e}`);
+            });
           } catch (e) {
             warn(`\uBA54\uC2DC\uC9C0 \uD30C\uC2F1 \uC2E4\uD328: ${e}`);
           }
@@ -1804,7 +1810,7 @@ ${colors.cyan}ConnectBase Tunnel${colors.reset}`);
     info(`${(delay / 1e3).toFixed(0)}\uCD08 \uD6C4 \uC7AC\uC5F0\uACB0 \uC2DC\uB3C4... (${reconnectAttempts}/${maxReconnectAttempts})`);
     setTimeout(connect, delay);
   }
-  function handleMessage(msg, sock, localPort) {
+  async function handleMessage(msg, sock, localPort) {
     switch (msg.type) {
       case "tunnel_ready": {
         const proxyToken = typeof msg.proxy_token === "string" ? msg.proxy_token : "";
@@ -1832,7 +1838,7 @@ ${colors.dim}\uC678\uBD80 \uC9C1\uC811 \uD638\uCD9C \uC2DC \uB2E4\uC74C \uD5E4\u
           log(`${colors.dim}  $ curl "${tunnelUrl}/?proxy_token=${proxyToken}"${colors.reset}`);
         }
         if (tunnelOpts?.label && tunnelUrl) {
-          void registerEndpointBinding(
+          await registerEndpointBinding(
             config.baseUrl,
             appId,
             tunnelKey,
@@ -2088,6 +2094,10 @@ function parseArgs(args) {
       result.options.timeout = args[++i];
     } else if (arg === "--max-body") {
       result.options.maxBody = args[++i];
+    } else if (arg === "--label") {
+      result.options.label = args[++i];
+    } else if (arg === "--description") {
+      result.options.description = args[++i];
     } else if (arg === "-a" || arg === "--app") {
       result.options.appId = args[++i];
     } else if (arg === "--force") {
@@ -2216,5 +2226,6 @@ main().catch((err) => {
 0 && (module.exports = {
   computeDeployDiff,
   normalizeRelativePath,
+  parseArgs,
   sha256Hex
 });

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "connectbase-client",
-  "version": "3.5.0",
+  "version": "3.5.2",
   "description": "Connect Base JavaScript/TypeScript SDK for browser and Node.js",
   "repository": {
     "type": "git",
-    "url": "https://github.com/connectbase-world/connectbase.git",
+    "url": "git+https://github.com/connectbase-world/connectbase.git",
     "directory": "frontend/package/public/connect-base-client"
   },
   "homepage": "https://github.com/connectbase-world/connectbase/tree/release/frontend/package/public/connect-base-client#readme",
@@ -21,8 +21,8 @@
   "browser": "dist/connect-base.umd.js",
   "unpkg": "dist/connect-base.umd.js",
   "bin": {
-    "connectbase": "./dist/cli.js",
-    "connectbase-client": "./dist/cli.js"
+    "connectbase": "dist/cli.js",
+    "connectbase-client": "dist/cli.js"
   },
   "exports": {
     ".": {