connectbase-client 5.0.0 → 5.1.0

package/CHANGELOG.md

@@ -3,6 +3,45 @@
 본 SDK 의 모든 주요 변경사항을 [Keep a Changelog](https://keepachangelog.com/ko/1.1.0/) 형식으로 기록합니다.
 버전은 [Semantic Versioning](https://semver.org/lang/ko/) 을 따릅니다.
 
+## [5.1.0] - 2026-07-30
+
+### Added — 앱 멤버 관리자 조회 `cb.appMembers` (이메일 포함)
+
+앱 소유자가 자기 앱 멤버의 이메일을 조회할 경로가 없었다 (platform-issue 019fb13c). 플랫폼은
+이메일을 보관하는데(RLS `auth.email`, 본인 `getMe().email`) 관리자 방향 읽기 경로에서만 빠져
+있었다. `cb.appMembers.list()` / `cb.appMembers.get()` 을 추가했다.
+
+```typescript
+// service_role 함수 안에서 (management_scopes: ["app_member:read"])
+// 문의로 들어온 이메일이 어느 회원인지 대조
+const found = await ctx.cbAdmin.appMembers.list(ctx.appId, { search: 'user@example.com' })
+console.log(found.total_count, found.app_members[0]?.email, found.app_members[0]?.nickname)
+
+// 자체 어드민 회원 목록
+const page = await ctx.cbAdmin.appMembers.list(ctx.appId, { page: 1, pageSize: 50 })
+
+// 회원 상세 — 로그인 수단까지
+const detail = await ctx.cbAdmin.appMembers.get(ctx.appId, found.app_members[0].id)
+console.log(detail.email, detail.identities.map((i) => i.type))  // ['GOOGLE']
+```
+
+- **서버사이드 전용**: 콘솔 JWT 또는 service_role 함수(`ctx.cbAdmin`)가 필요하다. Public Key
+  (`cb_pk_`) 단독 브라우저 인스턴스에서 호출하면 던진다 — 다른 회원의 개인정보를 클라이언트에서
+  읽는 경로를 만들지 않기 위한 의도적 제약이다. 멤버가 **자기** 정보를 볼 때는 `cb.auth.getMe()`.
+- service_role 함수에서 쓰려면 함수 `management_scopes` 에 **`app_member:read`** 를 opt-in 한다
+  (신규 스코프). 이메일을 열어주므로 어드민/CS 흐름에만 부여할 것.
+- `search` 는 **닉네임 · 이메일 · 로그인 identity(email/username)** 를 함께 부분 일치(대소문자
+  무시)한다. `total_count` 도 이 필터를 반영한다.
+- `email` 은 `app_members.email` 컬럼 우선, 비어 있으면 EMAIL identity 의 `provider_uid` 로
+  fallback 한다(backfill 이전 가입 멤버). 이메일이 정말 없는 멤버는 빈 문자열이다.
+- 쓰기(생성/삭제/정지/수정)와 활동 로그 조회는 콘솔 전용이라 이 스코프로 열리지 않는다.
+
+새 타입: `AppMemberList`, `AppMemberListItem`, `AppMemberDetail`, `AppMemberIdentitySummary`,
+`AppMemberIdentityDetail`, `AppMemberProviderType`, `ListAppMembersOptions`.
+
+관련 MCP 도구 `list_members` / `get_member` 도 같은 데이터를 돌려주며, `list_members` 에
+`search` 인자가 추가됐다.
+
 ## [5.0.0] - 2026-07-27
 
 ### BREAKING — AI 스트리밍 `onError` 가 문자열이 아닌 `AIError` 객체를 전달