connectbase-client 3.5.1 → 3.5.3

package/CHANGELOG.md

@@ -3,6 +3,54 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.5.3] - 2026-05-01
+
+### Fixed — `connectbase tunnel --label` 의 `tunnel_id` 추출 실패
+
+3.5.2 의 `parseArgs()` 패치로 `--label` / `--description` 이 정상 파싱되어
+`registerEndpointBinding()` 까지 호출되는 것은 확인됐으나, 함수 진입 직후
+`tunnel_id` 추출 단계에서 즉시 skip 되어 자동 등록이 여전히 한 번도
+수행되지 않던 문제를 수정했습니다.
+
+원인: 추출 로직이 `https://<id>.tunnel.connectbase.world` (subdomain 기반)
+형식을 가정했으나, 실제 발급 URL 은 `https://tunnel.connectbase.world/<id>`
+(path 기반) 입니다. `host.replace(/\.tunnel\.connectbase\.world$/, '')` 가
+정규식 매칭에 실패해 입력을 그대로 반환 → `tunnelId === host` 조건으로
+"tunnel_id 추출 실패" 분기 진입 → 자동 등록 skip.
+
+- URL 파싱을 제거하고, 서버가 `tunnel_ready` 메시지에 직접 실어 보내는
+  `tunnel_id` 필드를 그대로 사용하도록 변경 (서버 권위값 기준 — 향후 URL
+  형식 변경에 영향받지 않음).
+- `registerEndpointBinding()` 시그니처: `tunnelUrl` → `tunnelId` 로 단순화 +
+  `export` 노출 → 단위 테스트 가능.
+- `test/cli-register-endpoint.test.ts` 회귀 가드 5 케이스 신규 추가:
+  201 (정상 등록 — body.tunnel_id 검증), description 기본값, baseUrl trailing
+  slash 정규화, appId URL 인코딩, 409/401/5xx/네트워크 오류 시 호출부
+  흐름 유지 (throw 하지 않음).
+
+회귀 영향 범위: 3.5.2 의 `--label` 자동 등록 사용자 (해당 기능을 처음으로
+정상 동작시킴). 다른 옵션 / 기본 `tunnel` 동작에는 영향 없음.
+
+## [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

package/dist/cli.js

@@ -33,6 +33,8 @@ var cli_exports = {};
 __export(cli_exports, {
   computeDeployDiff: () => computeDeployDiff,
   normalizeRelativePath: () => normalizeRelativePath,
+  parseArgs: () => parseArgs,
+  registerEndpointBinding: () => registerEndpointBinding,
   sha256Hex: () => sha256Hex
 });
 module.exports = __toCommonJS(cli_exports);
@@ -1565,15 +1567,8 @@ ${colors.blue}?${colors.reset} \uC571 \uC120\uD0DD (\uBC88\uD638): `);
   success(`\uC571 \uC0DD\uC131 \uC644\uB8CC: ${createData.app_name}`);
   return { appId: createData.app_id, publicKey: createData.public_key };
 }
-async function registerEndpointBinding(baseUrl, appId, secretKey, tunnelUrl, label, description) {
+async function registerEndpointBinding(baseUrl, appId, secretKey, tunnelId, label, description) {
   try {
-    const u = new URL(tunnelUrl);
-    const host = u.hostname;
-    const tunnelId = host.replace(/\.tunnel\.connectbase\.world$/, "");
-    if (!tunnelId || tunnelId === host) {
-      error(`tunnel_id \uCD94\uCD9C \uC2E4\uD328 (${tunnelUrl}) \u2014 endpoint "${label}" \uC790\uB3D9 \uB4F1\uB85D skip`);
-      return;
-    }
     const apiBase = baseUrl.replace(/\/+$/, "");
     const res = await fetch(`${apiBase}/v1/apps/${encodeURIComponent(appId)}/endpoints/cli`, {
       method: "POST",
@@ -1836,15 +1831,20 @@ ${colors.dim}\uC678\uBD80 \uC9C1\uC811 \uD638\uCD9C \uC2DC \uB2E4\uC74C \uD5E4\u
           log(`${colors.dim}  $ curl -H "X-Proxy-Token: ${proxyToken}" ${tunnelUrl}/${colors.reset}`);
           log(`${colors.dim}  $ curl "${tunnelUrl}/?proxy_token=${proxyToken}"${colors.reset}`);
         }
-        if (tunnelOpts?.label && tunnelUrl) {
-          await registerEndpointBinding(
-            config.baseUrl,
-            appId,
-            tunnelKey,
-            tunnelUrl,
-            tunnelOpts.label,
-            tunnelOpts.description
-          );
+        if (tunnelOpts?.label) {
+          const tunnelId = typeof msg.tunnel_id === "string" ? msg.tunnel_id : "";
+          if (!tunnelId) {
+            error(`tunnel_ready \uBA54\uC2DC\uC9C0\uC5D0 tunnel_id \uAC00 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 endpoint "${tunnelOpts.label}" \uC790\uB3D9 \uB4F1\uB85D skip`);
+          } else {
+            await registerEndpointBinding(
+              config.baseUrl,
+              appId,
+              tunnelKey,
+              tunnelId,
+              tunnelOpts.label,
+              tunnelOpts.description
+            );
+          }
         }
         log(`
 ${colors.dim}Ctrl+C\uB85C \uC885\uB8CC${colors.reset}
@@ -2093,6 +2093,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") {
@@ -2221,5 +2225,7 @@ main().catch((err) => {
 0 && (module.exports = {
   computeDeployDiff,
   normalizeRelativePath,
+  parseArgs,
+  registerEndpointBinding,
   sha256Hex
 });

package/package.json

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