connectbase-client 3.28.0 → 3.29.0

package/CHANGELOG.md

@@ -3,6 +3,40 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.29.0] - 2026-06-02
+
+### Added — `connectbase tunnel --token <고정값>` proxy_token 핀 (platform-issue 019e8623)
+
+비-public 터널의 `proxy_token` 이 **재연결마다 회전**해, 그 토큰을 스냅샷 저장하는 통합
+(외부 MCP `custom_header X-Proxy-Token`, 터널을 가리키는 웹훅 등)이 다음 재연결부터
+`401 invalid or missing proxy token` 으로 깨지던 문제를 해결한다.
+
+- **`cli.ts` — `tunnel --token <value>`** — proxy_token 을 고정값으로 핀. 재연결 핸드셰이크마다
+  같은 값(`?proxy_token=`)을 보내 회전을 방지한다. 16~128자 `[A-Za-z0-9_-]` 검증(클라 선검사 +
+  서버 `ValidateProxyToken` 동일 규칙). 미지정 시 기존 동작(매 연결 새 발급) 유지 — 하위호환.
+- **CLI 라벨 재등록 idempotent** — 같은 라벨 + 같은 `tunnel_id` 재등록은 더 이상 409 경고를
+  내지 않고 기존 바인딩을 그대로 유지한다(콘솔 수동 PATCH 안내 제거). 라벨이 *다른* tunnel_id 에
+  묶여 있을 때만 충돌로 처리. 회전이 이미 일어나 깨진 경우의 즉시 복구용으로 백엔드에
+  현재 토큰 조회 경로(MCP `get_tunnel_label_proxy_token` / REST `GET .../endpoint-proxy-token/:label`)도
+  추가됐다.
+
+## [3.28.1] - 2026-06-02
+
+### Added — `RelationType` 에 `many-to-one` 추가 (platform-issue 019e83a0-c7d0)
+
+`cb.database.createRelation` 의 `relation_type` 으로 `many-to-one`(외래키→부모 단일 객체
+populate 의 정석)을 지정할 수 있게 됐다. 기존엔 문서/MCP 는 `many-to-one` 을 안내하면서도
+SDK/REST 관계 API 는 `one-to-one | one-to-many | many-to-many` 3종만 허용해, 문서대로
+`many-to-one` 을 쓰면 `400 유효하지 않은 관계 타입` + TS 타입 에러가 났다.
+
+- **`types/database.ts` — `RelationType`** 에 `'many-to-one'` 추가(4종 동등). additive 변경이라
+  하위호환. 백엔드(data-server)도 ent enum·populate(단일 객체) 동등 처리하도록 함께 수정됨.
+
+### Fixed — `oauth.signIn` JSDoc 예시 정정
+
+`createIfNotExists` 예시가 `callbackUrl` 자리에 클라이언트 인스턴스(`cb`)를 넘기는 오기였다.
+실제 URL 문자열로 교정(런타임/타입 영향 없음, 문서만).
+
 ## [3.28.0] - 2026-06-02
 
 ### Added — `cb.ai.chatStream` 취소(AbortSignal) 지원 (platform-issue 019e82e1)

package/dist/cli.js

@@ -1779,7 +1779,7 @@ async function registerEndpointBinding(baseUrl, appId, secretKey, tunnelId, labe
       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) {
-      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.`);
+      warn(`"${label}" \uB77C\uBCA8\uC774 \uB2E4\uB978 \uD130\uB110\uC5D0 \uC774\uBBF8 \uBB36\uC5EC \uC788\uC2B5\uB2C8\uB2E4. \uC774 \uD130\uB110\uB85C \uC62E\uAE30\uB824\uBA74 \uCF58\uC194\uC5D0\uC11C endpoint \uC758 tunnel_id \uB97C \uC218\uC815(PATCH)\uD558\uC138\uC694.`);
     } else {
       const text = await res.text().catch(() => "");
       error(`Endpoint "${label}" \uC790\uB3D9 \uB4F1\uB85D \uC2E4\uD328 (status ${res.status}): ${text || "(\uBE48 \uC751\uB2F5)"}`);
@@ -1867,6 +1867,9 @@ async function startTunnel(port, config, tunnelOpts) {
   if (tunnelOpts?.public) {
     wsPath += `&public=1`;
   }
+  if (tunnelOpts?.token) {
+    wsPath += `&proxy_token=${encodeURIComponent(tunnelOpts.token)}`;
+  }
   let reconnectAttempts = 0;
   const maxReconnectAttempts = 10;
   let shouldReconnect = true;
@@ -2350,6 +2353,7 @@ ${colors.yellow}\uC635\uC158:${colors.reset}
   --force               \uD130\uB110 lockfile \uBB34\uC2DC (\uC911\uBCF5 \uC2E4\uD589 \uAC15\uC81C, tunnel \uC804\uC6A9)
   --public              proxy_token \uAC80\uC99D \uBE44\uD65C\uC131\uD654 \u2014 \uC6F9\uD6C5/\uC678\uBD80 \uC9C1\uC811 \uD638\uCD9C\uC6A9 (tunnel \uC804\uC6A9)
   --show-token          proxy_token \uACFC curl \uC608\uC2DC\uB97C \uCD9C\uB825 (--public \uC544\uB2CC \uACBD\uC6B0)
+  --token <value>       proxy_token \uACE0\uC815\uAC12 (16-128\uC790 [A-Za-z0-9_-]) \u2014 \uC7AC\uC5F0\uACB0\uC5D0\uB3C4 \uD1A0\uD070 \uD68C\uC804 \uBC29\uC9C0. \uC678\uBD80 MCP custom_header \uB4F1 \uC548\uC815 \uD1B5\uD569\uC6A9 (tunnel \uC804\uC6A9)
   --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             Dev \uD658\uACBD\uC5D0 \uBC30\uD3EC (deploy \uC804\uC6A9)
@@ -2429,6 +2433,8 @@ function parseArgs(args) {
       result.options.label = args[++i];
     } else if (arg === "--description") {
       result.options.description = args[++i];
+    } else if (arg === "--token") {
+      result.options.token = args[++i];
     } else if (arg === "-a" || arg === "--app") {
       result.options.appId = args[++i];
     } else if (arg === "--force") {
@@ -2548,6 +2554,13 @@ async function main() {
     if (parsed.options.description) {
       tunnelOpts.description = parsed.options.description;
     }
+    if (parsed.options.token) {
+      if (!/^[A-Za-z0-9_-]{16,128}$/.test(parsed.options.token)) {
+        error("--token \uC740 16-128\uC790\uC758 [A-Za-z0-9_-] \uC5EC\uC57C \uD569\uB2C8\uB2E4");
+        process.exit(1);
+      }
+      tunnelOpts.token = parsed.options.token;
+    }
     await startTunnel(port, config, tunnelOpts);
   } else {
     error(`\uC54C \uC218 \uC5C6\uB294 \uBA85\uB839\uC5B4: ${parsed.command}`);

package/dist/index.d.mts

@@ -1372,7 +1372,7 @@ interface SlowQueryInfo {
     count: number;
     avg_time: number;
 }
-type RelationType = 'one-to-one' | 'one-to-many' | 'many-to-many';
+type RelationType = 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
 interface TableRelation {
     id: string;
     app_id: string;
@@ -3874,7 +3874,7 @@ declare class OAuthAPI {
      * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback')
      *
      * // 로그인=가입 통합 버튼 — 신규면 자동 가입
-     * await cb.oauth.signIn('google', cb, undefined, { createIfNotExists: true })
+     * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback', undefined, { createIfNotExists: true })
      * ```
      *
      * @example

package/dist/index.d.ts

@@ -1372,7 +1372,7 @@ interface SlowQueryInfo {
     count: number;
     avg_time: number;
 }
-type RelationType = 'one-to-one' | 'one-to-many' | 'many-to-many';
+type RelationType = 'one-to-one' | 'one-to-many' | 'many-to-one' | 'many-to-many';
 interface TableRelation {
     id: string;
     app_id: string;
@@ -3874,7 +3874,7 @@ declare class OAuthAPI {
      * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback')
      *
      * // 로그인=가입 통합 버튼 — 신규면 자동 가입
-     * await cb.oauth.signIn('google', cb, undefined, { createIfNotExists: true })
+     * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback', undefined, { createIfNotExists: true })
      * ```
      *
      * @example

package/dist/index.js

@@ -4837,7 +4837,7 @@ var OAuthAPI = class {
    * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback')
    *
    * // 로그인=가입 통합 버튼 — 신규면 자동 가입
-   * await cb.oauth.signIn('google', cb, undefined, { createIfNotExists: true })
+   * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback', undefined, { createIfNotExists: true })
    * ```
    *
    * @example

package/dist/index.mjs

@@ -4791,7 +4791,7 @@ var OAuthAPI = class {
    * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback')
    *
    * // 로그인=가입 통합 버튼 — 신규면 자동 가입
-   * await cb.oauth.signIn('google', cb, undefined, { createIfNotExists: true })
+   * await cb.oauth.signIn('google', 'https://myapp.com/oauth/callback', undefined, { createIfNotExists: true })
    * ```
    *
    * @example

package/package.json

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