connectbase-client 2.0.0 → 3.0.1

package/CHANGELOG.md

@@ -3,6 +3,70 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [3.0.1] - 2026-04-28
+
+### Fixed
+
+- `npx connectbase docs` 가 인증 없이 곧장 문서를 받도록 수정. 백엔드 `/v1/storages/webs/claude-md`
+  는 public 라우트인데 CLI 가 불필요하게 브라우저 인증 → 앱 선택 → Public Key 발급을 강제하던
+  흐름을 제거. 캐시된 publicKey 가 있으면 문서에 박아주고, 없으면 백엔드가 placeholder
+  (`YOUR_PUBLIC_KEY_HERE`) 로 대체해 그대로 다운로드.
+
+## [3.0.0] - 2026-04-28 — BREAKING
+
+게임 서버 mechanism-only 재설계. ConnectBase 가 박아두던 게임 룰 (파티/로비/랭킹/매치메이킹/
+killcam/highlight) 을 모두 제거하고, primitive (`cb.game.matchqueue`, `cb.game.leaderboard`,
+`cb.game.scripts`) + 사용자 Lua 로 대체. 1:1 마이그레이션은 [MIGRATION_v3.md](../../../docs/sdk/MIGRATION_v3.md).
+
+### Removed (BREAKING)
+
+- **Lobby**: `listLobbies`, `createLobby`, `getLobby`, `joinLobby`, `leaveLobby`, `toggleReady`,
+  `startGame`, `kickPlayer`, `updateLobby`, `sendLobbyChat`, `invitePlayer`, `acceptInvite`,
+  `declineInvite`, `getPlayerInvites` 메서드 + 관련 타입 (`LobbyInfo`, `CreateLobbyRequest`,
+  `UpdateLobbyRequest`, `LobbyInvite`)
+- **Party**: `createParty`, `joinParty`, `acceptPartyInvite`, `declinePartyInvite`,
+  `leaveParty`, `kickFromParty`, `inviteToParty`, `getParty`, `getMyParties`, `setReady`,
+  `setPartyMetadata`, `getPartyInvites`, `sendPartyChat` + `PartyInfo`, `PartyInvite`
+- **Matchmaking**: `joinQueue`, `leaveQueue`, `getMatchStatus` + `JoinQueueRequest`,
+  `MatchmakingTicket`
+- **Ranking**: `getLeaderboard`, `getPlayerStats`, `getPlayerRank` + `LeaderboardEntry` (구
+  player_id/rating/tier/wins/losses 시그니처. 신규 `LeaderboardScoreEntry` 가 대체).
+- **Killcam/Highlight**: `cb.game.replay.killcam(...)`, `cb.game.replay.highlights(...)`
+  관련 endpoint 가 백엔드에서 제거되어 SDK 호출 시 404. 사용자가 `cb.game.replay.download`
+  로 raw frame 받아 클라/Lua 에서 직접 처리.
+
+### Added — v3 primitive
+
+- **Matchqueue** (`cb.game.matchqueue.*` → `enqueueMatch / listMatchqueue / cancelMatch`):
+  rating/region 등 attributes 는 free-form. 매칭 알고리즘은 사용자 Lua 가 list → notify.
+- **Leaderboard** (`submitScore / getTopScores / getMemberRank / getRankAround / resetLeaderboard / removeFromLeaderboard`):
+  ELO/티어/시즌 박지 않음. 시즌은 key suffix (`ranks:2026q2`) 로 분리, 점수 공식은 Lua.
+- **Scripts** (`uploadScript / listScripts / getScript / listScriptVersions /
+  activateScript / rollbackScript / disableScript`): Lua 스크립트 영속 메타 + 버전 + hot reload.
+- 신규 타입: `MatchqueueTicket`, `MatchqueueListResponse`, `LeaderboardScoreEntry`,
+  `LeaderboardListResponse`, `ScriptMeta`, `ScriptVersion`, `ScriptListResponse`,
+  `ScriptVersionListResponse`, `ScriptDetailResponse`.
+
+### Backend 영향
+
+- game-server v3 부터 `/v1/game/:appID/matchqueue/:key/*`, `/leaderboards/:key/*`,
+  `/scripts/*` 라우트가 유일한 게임 메커니즘 endpoint. lobby/party/ranking/matchmaking
+  엔드포인트는 모두 404.
+- 자세한 변경: [`docs/sdk/MIGRATION_v3.md`](../../../docs/sdk/MIGRATION_v3.md),
+  [`docs/game-server/RECIPES.md`](../../../docs/game-server/RECIPES.md).
+
+### Migration 요약
+
+```ts
+// Before (v2.x)
+await cb.game.matchmaking.join({ mode: "ranked", rating: 1500 })
+await cb.game.ranking.submit({ leaderboard: "elo", score: 2150 })
+
+// After (v3.0)
+await cb.game.enqueueMatch(appId, "ranked", userId, { rating: 1500 })
+await cb.game.submitScore(appId, "elo", userId, 32, "incr")
+```
+
 ## [2.0.0] - 2026-04-27 — BREAKING
 
 Realtime presence/typing 단일화의 최종 단계. 1.13 deprecation 단계를 건너뛰고 즉시

package/dist/cli.js

@@ -952,70 +952,6 @@ function detectMonorepo(gitRoot) {
   }
   return result;
 }
-async function ensureDocsPublicKey(config) {
-  if (config.publicKey) return config.publicKey;
-  const rcPath = path2.join(process.cwd(), ".connectbaserc");
-  const baseUrl = config.baseUrl || DEFAULT_BASE_URL;
-  const readRc = () => {
-    if (!fs2.existsSync(rcPath)) return {};
-    try {
-      return JSON.parse(fs2.readFileSync(rcPath, "utf-8"));
-    } catch {
-      return {};
-    }
-  };
-  const writeRc = (data) => {
-    fs2.writeFileSync(rcPath, JSON.stringify(data, null, 2) + "\n");
-    addToGitignore(".connectbaserc");
-  };
-  let secretKey = config.secretKey;
-  if (!secretKey) {
-    info("Public Key \uBC1C\uAE09\uC744 \uC704\uD574 \uBE0C\uB77C\uC6B0\uC800 \uC778\uC99D\uC744 \uC2DC\uC791\uD569\uB2C8\uB2E4...");
-    secretKey = await browserAuthFlow();
-    const rc2 = readRc();
-    rc2.secretKey = secretKey;
-    writeRc(rc2);
-    config.secretKey = secretKey;
-  }
-  const savedAppId = readRc().tunnelAppId || "";
-  const resolved = await resolveApp(secretKey, baseUrl, savedAppId);
-  let publicKey = resolved.publicKey;
-  if (!publicKey) {
-    info("Public Key \uBC1C\uAE09 \uC911...");
-    const res = await makeRequest(
-      `${baseUrl}/v1/public/cli/apps/${resolved.appId}/public-keys`,
-      "POST",
-      { "X-Public-Key": secretKey },
-      JSON.stringify({ name: "CLI Docs Key" })
-    );
-    if (res.status !== 201) {
-      const data2 = res.data;
-      const detail = data2?.error || data2?.message || `HTTP ${res.status}`;
-      error(`Public Key \uBC1C\uAE09 \uC2E4\uD328: ${detail}`);
-      process.exit(1);
-    }
-    const data = res.data;
-    if (!data.key) {
-      error("Public Key \uBC1C\uAE09 \uC751\uB2F5\uC774 \uBE44\uC5B4 \uC788\uC2B5\uB2C8\uB2E4");
-      process.exit(1);
-    }
-    publicKey = data.key;
-    success("Public Key \uBC1C\uAE09 \uC644\uB8CC");
-  }
-  const rc = readRc();
-  let changed = false;
-  if (rc.publicKey !== publicKey) {
-    rc.publicKey = publicKey;
-    changed = true;
-  }
-  if (rc.tunnelAppId !== resolved.appId) {
-    rc.tunnelAppId = resolved.appId;
-    changed = true;
-  }
-  if (changed) writeRc(rc);
-  config.publicKey = publicKey;
-  return publicKey;
-}
 async function downloadDocs(publicKey, templates, baseDir) {
   if (!baseDir) {
     baseDir = getProjectRoot();
@@ -2165,8 +2101,7 @@ async function main() {
       setupRoot: parsed.options.setupRoot === "true"
     });
   } else if (parsed.command === "docs") {
-    const docsPublicKey = await ensureDocsPublicKey(config);
-    await downloadDocs(docsPublicKey);
+    await downloadDocs(config.publicKey || "");
   } else if (parsed.command === "mcp") {
     await setupMcp();
   } else if (parsed.command === "deploy") {