connectbase-client 5.9.0 → 5.11.0

package/dist/index.d.mts

@@ -264,6 +264,18 @@ declare class HttpClient {
      */
     private bootRestorePromise;
     private bootRestoreAlwaysAwait;
+    /**
+     * 서버가 `X-CB-Direct-Base` 로 알려준 저지연 원본. 학습 전에는 null 이라 항상 `baseUrl`
+     * 을 쓴다. {@link resolveOrigin} 참고.
+     */
+    private directBaseUrl;
+    /**
+     * direct 원본을 이 세션에서 더는 쓰지 않는다는 표시. 한 번이라도 네트워크 레벨에서
+     * 실패하면(CSP `connect-src` 차단, 사내 프록시, DNS 미전파, 호스트 회수 등) 즉시 세워
+     * 이후 요청은 전부 `baseUrl` 로 간다. direct 는 최적화일 뿐 필수가 아니므로 재시도를
+     * 반복하지 않고 한 번에 포기하는 쪽이 안전하다.
+     */
+    private directDisabled;
     /**
      * 클라이언트 생성 시 명시된 요청 타임아웃(ms). 미지정이면 `undefined`.
      *
@@ -406,6 +418,30 @@ declare class HttpClient {
      * (platform-issue 019e638d, 2026-05-26). retry 는 1회 한정 — 무한 루프 차단.
      */
     private doFetch;
+    /**
+     * 이 요청을 보낼 원본을 고른다.
+     *
+     * `credentials:'omit'` 인 요청 — 즉 `X-Public-Key` 로만 인증하고 쿠키를 주고받지 않는
+     * `/v1/public/*` 데이터 평면 — 만 direct 원본으로 보낸다. 이 조건이 곧 안전 조건이다:
+     * 멤버 refresh 쿠키는 **host-only** 로 발급되므로(백엔드 auth_cookie.SetMemberRefreshCookie)
+     * 로그인·가입·로그아웃·OAuth·탈퇴를 다른 호스트로 보내면 세션이 조용히 끊긴다.
+     * `fetchCredentialsForPath` 가 이미 그 경계를 계산하고 있어, 나중에 쿠키 엔드포인트가
+     * 추가돼도 자동으로 제외된다(서버도 같은 경로를 421 로 되돌려보낸다).
+     */
+    private resolveOrigin;
+    /**
+     * 응답에서 저지연 원본 광고를 학습한다.
+     *
+     * 왜 서버가 정하나: 클라이언트는 자기가 어느 나라에서 접속했는지 신뢰성 있게 모르고,
+     * 두 호스트를 재보는 프로브는 요청을 한 번 더 쓴다. Cloudflare 엣지는 `CF-IPCountry` 로
+     * 이미 알고 있으므로 서버가 판단해 알려주는 쪽이 정확하고 공짜다. 서버 env 하나로
+     * 즉시 회수할 수도 있다.
+     *
+     * 값은 검증한다 — https 이고 `baseUrl` 과 같은 등록 도메인이어야 한다. 응답은 우리
+     * 서버에서 TLS 로 오지만, 설정 실수 하나로 SDK 트래픽 전체가 엉뚱한 호스트로 향하는
+     * 일은 없어야 한다.
+     */
+    private learnDirectOrigin;
     private tryFetchOnce;
     get<T>(url: string, config?: RequestConfig): Promise<T>;
     post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<T>;
@@ -1458,6 +1494,33 @@ declare class AppMembersAPI {
      * @param memberId 멤버 ID
      */
     get(appId: string, memberId: string): Promise<AppMemberDetail>;
+    /**
+     * 앱 멤버를 삭제(탈퇴 처리)한다. **되돌릴 수 없다.** (management_scope: `app_member:write`)
+     *
+     * 멤버 행과 함께 로그인 수단(identities)이 지워지므로, 같은 소셜 계정으로 다시 로그인하면
+     * 기존 member_id 로 되살아나지 않고 새 member_id 를 받는다. 결제·구독·푸시 디바이스·방문
+     * 기록 등 멤버에 매달린 행도 함께 사라진다.
+     *
+     * 앱이 자체 테이블(`cb.database`)에 보관한 데이터는 지우지 않는다 — 같은 함수 안에서
+     * `ctx.cbAdmin.database` 로 먼저 정리하고 마지막에 이 메서드를 부르는 순서를 권한다.
+     *
+     * `app_member:read` 로는 열리지 않는다 — 이메일 조회용으로 준 스코프가 회원을 지울 수 있게
+     * 되면 안 되기 때문이다. 정지/수정/생성은 여전히 콘솔 전용이다.
+     *
+     * @param appId 앱 ID
+     * @param memberId 삭제할 멤버 ID
+     *
+     * @example
+     * ```typescript
+     * // 함수(service_role, management_scopes: ["app_member:read", "app_member:write"]) 안에서
+     * // 개인정보 삭제 요청 처리: 앱 데이터 정리 → 멤버 삭제
+     * await ctx.cbAdmin.database.delete('posts', { author_id: memberId })
+     * await ctx.cbAdmin.appMembers.remove(ctx.appId, memberId)
+     * ```
+     */
+    remove(appId: string, memberId: string): Promise<{
+        message: string;
+    }>;
 }
 
 /** 앱 멤버 회원가입 요청 */
@@ -1647,6 +1710,61 @@ declare class AuthAPI {
         custom_data: Record<string, unknown>;
         role: string;
     }>;
+    /**
+     * Admin: 다른 멤버를 삭제(탈퇴 처리)합니다. **되돌릴 수 없습니다.**
+     *
+     * `adminUpdateMember` 와 같은 권한 컨텍스트입니다 — `cb_pk_` 로 앱을 식별하고 함께 보낸
+     * `cb_sk_` 의 사용자가 그 앱에 `app_member:write` 권한을 가져야 합니다. 브라우저 번들에
+     * 시크릿 키를 넣지 마세요. 서버(함수·백엔드)에서만 호출합니다.
+     *
+     * 멤버 행과 함께 **로그인 수단(identities)** 이 지워집니다. 따라서 같은 소셜 계정으로 다시
+     * 로그인하면 기존 member_id 로 되살아나지 않고 **새 member_id** 를 받습니다. 결제·구독·
+     * 푸시 디바이스·방문 기록 등 멤버에 매달린 행도 함께 사라집니다.
+     *
+     * 앱이 자체 테이블(`cb.database`)에 보관한 데이터는 지우지 않습니다 — 그건 `service_role`
+     * 로 앱이 직접 정리하세요.
+     *
+     * 이미 발급된 그 멤버의 access token 은 만료(최대 1시간)까지 서명이 유효합니다. 즉시
+     * 차단이 필요하면 삭제 전에 정지(콘솔 `멤버 정지`)를 함께 쓰세요.
+     *
+     * @example
+     * ```typescript
+     * const cb = new ConnectBase({ publicKey: 'cb_pk_...', secretKey: 'cb_sk_...' })
+     * await cb.auth.adminDeleteMember('member-uuid')
+     * ```
+     */
+    adminDeleteMember(memberID: string): Promise<{
+        message: string;
+        member_id: string;
+    }>;
+    /**
+     * 로그인한 본인이 스스로 탈퇴합니다. **되돌릴 수 없습니다.**
+     *
+     * App Store 심사 가이드라인 5.1.1(v)는 "앱 안에서 가입이 되면 앱 안에서 탈퇴도 가능해야
+     * 한다"를 요구합니다 — 고객센터 안내로는 통과되지 않습니다. 이 메서드가 그 요구를 만족하는
+     * 경로입니다.
+     *
+     * 확인 UI(“정말 탈퇴하시겠습니까?”)는 앱이 책임집니다. 서버는 확인 없이 즉시 삭제합니다.
+     *
+     * 성공하면 로컬 토큰이 정리되고 refresh 쿠키도 서버가 만료시킵니다 — `signOut()` 을 따로
+     * 부를 필요가 없습니다.
+     *
+     * `adminDeleteMember` 와 동일하게 로그인 수단(identities)까지 지우므로, 같은 소셜 계정으로
+     * 재가입하면 새 member_id 를 받습니다.
+     *
+     * @example
+     * ```typescript
+     * // 설정 > 회원 탈퇴 버튼
+     * if (confirm('탈퇴하면 되돌릴 수 없습니다. 계속할까요?')) {
+     *     await cb.auth.deleteMyAccount()
+     *     location.href = '/'
+     * }
+     * ```
+     */
+    deleteMyAccount(): Promise<{
+        message: string;
+        deleted: boolean;
+    }>;
     /**
      * 로그아웃
      */

package/dist/index.d.ts

@@ -264,6 +264,18 @@ declare class HttpClient {
      */
     private bootRestorePromise;
     private bootRestoreAlwaysAwait;
+    /**
+     * 서버가 `X-CB-Direct-Base` 로 알려준 저지연 원본. 학습 전에는 null 이라 항상 `baseUrl`
+     * 을 쓴다. {@link resolveOrigin} 참고.
+     */
+    private directBaseUrl;
+    /**
+     * direct 원본을 이 세션에서 더는 쓰지 않는다는 표시. 한 번이라도 네트워크 레벨에서
+     * 실패하면(CSP `connect-src` 차단, 사내 프록시, DNS 미전파, 호스트 회수 등) 즉시 세워
+     * 이후 요청은 전부 `baseUrl` 로 간다. direct 는 최적화일 뿐 필수가 아니므로 재시도를
+     * 반복하지 않고 한 번에 포기하는 쪽이 안전하다.
+     */
+    private directDisabled;
     /**
      * 클라이언트 생성 시 명시된 요청 타임아웃(ms). 미지정이면 `undefined`.
      *
@@ -406,6 +418,30 @@ declare class HttpClient {
      * (platform-issue 019e638d, 2026-05-26). retry 는 1회 한정 — 무한 루프 차단.
      */
     private doFetch;
+    /**
+     * 이 요청을 보낼 원본을 고른다.
+     *
+     * `credentials:'omit'` 인 요청 — 즉 `X-Public-Key` 로만 인증하고 쿠키를 주고받지 않는
+     * `/v1/public/*` 데이터 평면 — 만 direct 원본으로 보낸다. 이 조건이 곧 안전 조건이다:
+     * 멤버 refresh 쿠키는 **host-only** 로 발급되므로(백엔드 auth_cookie.SetMemberRefreshCookie)
+     * 로그인·가입·로그아웃·OAuth·탈퇴를 다른 호스트로 보내면 세션이 조용히 끊긴다.
+     * `fetchCredentialsForPath` 가 이미 그 경계를 계산하고 있어, 나중에 쿠키 엔드포인트가
+     * 추가돼도 자동으로 제외된다(서버도 같은 경로를 421 로 되돌려보낸다).
+     */
+    private resolveOrigin;
+    /**
+     * 응답에서 저지연 원본 광고를 학습한다.
+     *
+     * 왜 서버가 정하나: 클라이언트는 자기가 어느 나라에서 접속했는지 신뢰성 있게 모르고,
+     * 두 호스트를 재보는 프로브는 요청을 한 번 더 쓴다. Cloudflare 엣지는 `CF-IPCountry` 로
+     * 이미 알고 있으므로 서버가 판단해 알려주는 쪽이 정확하고 공짜다. 서버 env 하나로
+     * 즉시 회수할 수도 있다.
+     *
+     * 값은 검증한다 — https 이고 `baseUrl` 과 같은 등록 도메인이어야 한다. 응답은 우리
+     * 서버에서 TLS 로 오지만, 설정 실수 하나로 SDK 트래픽 전체가 엉뚱한 호스트로 향하는
+     * 일은 없어야 한다.
+     */
+    private learnDirectOrigin;
     private tryFetchOnce;
     get<T>(url: string, config?: RequestConfig): Promise<T>;
     post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<T>;
@@ -1458,6 +1494,33 @@ declare class AppMembersAPI {
      * @param memberId 멤버 ID
      */
     get(appId: string, memberId: string): Promise<AppMemberDetail>;
+    /**
+     * 앱 멤버를 삭제(탈퇴 처리)한다. **되돌릴 수 없다.** (management_scope: `app_member:write`)
+     *
+     * 멤버 행과 함께 로그인 수단(identities)이 지워지므로, 같은 소셜 계정으로 다시 로그인하면
+     * 기존 member_id 로 되살아나지 않고 새 member_id 를 받는다. 결제·구독·푸시 디바이스·방문
+     * 기록 등 멤버에 매달린 행도 함께 사라진다.
+     *
+     * 앱이 자체 테이블(`cb.database`)에 보관한 데이터는 지우지 않는다 — 같은 함수 안에서
+     * `ctx.cbAdmin.database` 로 먼저 정리하고 마지막에 이 메서드를 부르는 순서를 권한다.
+     *
+     * `app_member:read` 로는 열리지 않는다 — 이메일 조회용으로 준 스코프가 회원을 지울 수 있게
+     * 되면 안 되기 때문이다. 정지/수정/생성은 여전히 콘솔 전용이다.
+     *
+     * @param appId 앱 ID
+     * @param memberId 삭제할 멤버 ID
+     *
+     * @example
+     * ```typescript
+     * // 함수(service_role, management_scopes: ["app_member:read", "app_member:write"]) 안에서
+     * // 개인정보 삭제 요청 처리: 앱 데이터 정리 → 멤버 삭제
+     * await ctx.cbAdmin.database.delete('posts', { author_id: memberId })
+     * await ctx.cbAdmin.appMembers.remove(ctx.appId, memberId)
+     * ```
+     */
+    remove(appId: string, memberId: string): Promise<{
+        message: string;
+    }>;
 }
 
 /** 앱 멤버 회원가입 요청 */
@@ -1647,6 +1710,61 @@ declare class AuthAPI {
         custom_data: Record<string, unknown>;
         role: string;
     }>;
+    /**
+     * Admin: 다른 멤버를 삭제(탈퇴 처리)합니다. **되돌릴 수 없습니다.**
+     *
+     * `adminUpdateMember` 와 같은 권한 컨텍스트입니다 — `cb_pk_` 로 앱을 식별하고 함께 보낸
+     * `cb_sk_` 의 사용자가 그 앱에 `app_member:write` 권한을 가져야 합니다. 브라우저 번들에
+     * 시크릿 키를 넣지 마세요. 서버(함수·백엔드)에서만 호출합니다.
+     *
+     * 멤버 행과 함께 **로그인 수단(identities)** 이 지워집니다. 따라서 같은 소셜 계정으로 다시
+     * 로그인하면 기존 member_id 로 되살아나지 않고 **새 member_id** 를 받습니다. 결제·구독·
+     * 푸시 디바이스·방문 기록 등 멤버에 매달린 행도 함께 사라집니다.
+     *
+     * 앱이 자체 테이블(`cb.database`)에 보관한 데이터는 지우지 않습니다 — 그건 `service_role`
+     * 로 앱이 직접 정리하세요.
+     *
+     * 이미 발급된 그 멤버의 access token 은 만료(최대 1시간)까지 서명이 유효합니다. 즉시
+     * 차단이 필요하면 삭제 전에 정지(콘솔 `멤버 정지`)를 함께 쓰세요.
+     *
+     * @example
+     * ```typescript
+     * const cb = new ConnectBase({ publicKey: 'cb_pk_...', secretKey: 'cb_sk_...' })
+     * await cb.auth.adminDeleteMember('member-uuid')
+     * ```
+     */
+    adminDeleteMember(memberID: string): Promise<{
+        message: string;
+        member_id: string;
+    }>;
+    /**
+     * 로그인한 본인이 스스로 탈퇴합니다. **되돌릴 수 없습니다.**
+     *
+     * App Store 심사 가이드라인 5.1.1(v)는 "앱 안에서 가입이 되면 앱 안에서 탈퇴도 가능해야
+     * 한다"를 요구합니다 — 고객센터 안내로는 통과되지 않습니다. 이 메서드가 그 요구를 만족하는
+     * 경로입니다.
+     *
+     * 확인 UI(“정말 탈퇴하시겠습니까?”)는 앱이 책임집니다. 서버는 확인 없이 즉시 삭제합니다.
+     *
+     * 성공하면 로컬 토큰이 정리되고 refresh 쿠키도 서버가 만료시킵니다 — `signOut()` 을 따로
+     * 부를 필요가 없습니다.
+     *
+     * `adminDeleteMember` 와 동일하게 로그인 수단(identities)까지 지우므로, 같은 소셜 계정으로
+     * 재가입하면 새 member_id 를 받습니다.
+     *
+     * @example
+     * ```typescript
+     * // 설정 > 회원 탈퇴 버튼
+     * if (confirm('탈퇴하면 되돌릴 수 없습니다. 계속할까요?')) {
+     *     await cb.auth.deleteMyAccount()
+     *     location.href = '/'
+     * }
+     * ```
+     */
+    deleteMyAccount(): Promise<{
+        message: string;
+        deleted: boolean;
+    }>;
     /**
      * 로그아웃
      */

package/dist/index.js

@@ -1516,8 +1516,9 @@ var AppMembersAPI = class {
   }
   ensureServerAuth(method) {
     if (this.http.hasPublicKey() && !this.http.hasJWT()) {
+      const scope = method === "remove" ? "app_member:write" : "app_member:read";
       throw new Error(
-        `cb.appMembers.${method}() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["app_member:read"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uC790\uAE30 \uC815\uBCF4\uB294 cb.auth.getMe() \uB97C \uC4F0\uC138\uC694.`
+        `cb.appMembers.${method}() \uB294 \uCF58\uC194 JWT \uB610\uB294 service_role(ctx.cbAdmin, management_scopes: ["${scope}"]) \uC778\uC99D\uC774 \uD544\uC694\uD569\uB2C8\uB2E4. Public Key(cb_pk_) \uB2E8\uB3C5 SDK \uC778\uC2A4\uD134\uC2A4\uB85C\uB294 \uD638\uCD9C\uD560 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4 \u2014 \uC790\uAE30 \uC815\uBCF4\uB294 cb.auth.getMe() \uB97C \uC4F0\uACE0, \uBCF8\uC778 \uD0C8\uD1F4\uB294 cb.auth.deleteMyAccount() \uB97C \uC4F0\uC138\uC694.`
       );
     }
   }
@@ -1552,6 +1553,36 @@ var AppMembersAPI = class {
       `/v1/apps/${appId}/app-members/${memberId}`
     );
   }
+  /**
+   * 앱 멤버를 삭제(탈퇴 처리)한다. **되돌릴 수 없다.** (management_scope: `app_member:write`)
+   *
+   * 멤버 행과 함께 로그인 수단(identities)이 지워지므로, 같은 소셜 계정으로 다시 로그인하면
+   * 기존 member_id 로 되살아나지 않고 새 member_id 를 받는다. 결제·구독·푸시 디바이스·방문
+   * 기록 등 멤버에 매달린 행도 함께 사라진다.
+   *
+   * 앱이 자체 테이블(`cb.database`)에 보관한 데이터는 지우지 않는다 — 같은 함수 안에서
+   * `ctx.cbAdmin.database` 로 먼저 정리하고 마지막에 이 메서드를 부르는 순서를 권한다.
+   *
+   * `app_member:read` 로는 열리지 않는다 — 이메일 조회용으로 준 스코프가 회원을 지울 수 있게
+   * 되면 안 되기 때문이다. 정지/수정/생성은 여전히 콘솔 전용이다.
+   *
+   * @param appId 앱 ID
+   * @param memberId 삭제할 멤버 ID
+   *
+   * @example
+   * ```typescript
+   * // 함수(service_role, management_scopes: ["app_member:read", "app_member:write"]) 안에서
+   * // 개인정보 삭제 요청 처리: 앱 데이터 정리 → 멤버 삭제
+   * await ctx.cbAdmin.database.delete('posts', { author_id: memberId })
+   * await ctx.cbAdmin.appMembers.remove(ctx.appId, memberId)
+   * ```
+   */
+  async remove(appId, memberId) {
+    this.ensureServerAuth("remove");
+    return this.http.delete(
+      `/v1/apps/${appId}/app-members/${memberId}`
+    );
+  }
 };
 
 // src/core/validate.ts
@@ -1804,6 +1835,73 @@ var AuthAPI = class {
       fields
     );
   }
+  /**
+   * Admin: 다른 멤버를 삭제(탈퇴 처리)합니다. **되돌릴 수 없습니다.**
+   *
+   * `adminUpdateMember` 와 같은 권한 컨텍스트입니다 — `cb_pk_` 로 앱을 식별하고 함께 보낸
+   * `cb_sk_` 의 사용자가 그 앱에 `app_member:write` 권한을 가져야 합니다. 브라우저 번들에
+   * 시크릿 키를 넣지 마세요. 서버(함수·백엔드)에서만 호출합니다.
+   *
+   * 멤버 행과 함께 **로그인 수단(identities)** 이 지워집니다. 따라서 같은 소셜 계정으로 다시
+   * 로그인하면 기존 member_id 로 되살아나지 않고 **새 member_id** 를 받습니다. 결제·구독·
+   * 푸시 디바이스·방문 기록 등 멤버에 매달린 행도 함께 사라집니다.
+   *
+   * 앱이 자체 테이블(`cb.database`)에 보관한 데이터는 지우지 않습니다 — 그건 `service_role`
+   * 로 앱이 직접 정리하세요.
+   *
+   * 이미 발급된 그 멤버의 access token 은 만료(최대 1시간)까지 서명이 유효합니다. 즉시
+   * 차단이 필요하면 삭제 전에 정지(콘솔 `멤버 정지`)를 함께 쓰세요.
+   *
+   * @example
+   * ```typescript
+   * const cb = new ConnectBase({ publicKey: 'cb_pk_...', secretKey: 'cb_sk_...' })
+   * await cb.auth.adminDeleteMember('member-uuid')
+   * ```
+   */
+  async adminDeleteMember(memberID) {
+    if (!this.http.getSecretKey()) {
+      throw new Error(
+        "adminDeleteMember requires a secretKey. Initialize ConnectBase with both publicKey and secretKey."
+      );
+    }
+    return this.http.delete(
+      `/v1/public/app-members/${encodeURIComponent(memberID)}`
+    );
+  }
+  /**
+   * 로그인한 본인이 스스로 탈퇴합니다. **되돌릴 수 없습니다.**
+   *
+   * App Store 심사 가이드라인 5.1.1(v)는 "앱 안에서 가입이 되면 앱 안에서 탈퇴도 가능해야
+   * 한다"를 요구합니다 — 고객센터 안내로는 통과되지 않습니다. 이 메서드가 그 요구를 만족하는
+   * 경로입니다.
+   *
+   * 확인 UI(“정말 탈퇴하시겠습니까?”)는 앱이 책임집니다. 서버는 확인 없이 즉시 삭제합니다.
+   *
+   * 성공하면 로컬 토큰이 정리되고 refresh 쿠키도 서버가 만료시킵니다 — `signOut()` 을 따로
+   * 부를 필요가 없습니다.
+   *
+   * `adminDeleteMember` 와 동일하게 로그인 수단(identities)까지 지우므로, 같은 소셜 계정으로
+   * 재가입하면 새 member_id 를 받습니다.
+   *
+   * @example
+   * ```typescript
+   * // 설정 > 회원 탈퇴 버튼
+   * if (confirm('탈퇴하면 되돌릴 수 없습니다. 계속할까요?')) {
+   *     await cb.auth.deleteMyAccount()
+   *     location.href = '/'
+   * }
+   * ```
+   */
+  async deleteMyAccount() {
+    try {
+      return await this.http.delete(
+        "/v1/public/app-members/me"
+      );
+    } finally {
+      this.http.clearTokens();
+      this.notifyVisitorTracker(null);
+    }
+  }
   /**
    * 로그아웃
    */
@@ -11343,6 +11441,9 @@ var COOKIE_BEARING_PUBLIC_PATHS = /* @__PURE__ */ new Set([
   "/v1/public/app-members/signin",
   "/v1/public/app-members/signout"
 ]);
+function isAbortError(err) {
+  return typeof err === "object" && err !== null && "name" in err && err.name === "AbortError";
+}
 function fetchCredentialsForPath(url) {
   const path = url.split("?")[0];
   if (COOKIE_BEARING_PUBLIC_PATHS.has(path)) {
@@ -11414,6 +11515,18 @@ var HttpClient = class {
     // OAuth 콜백 부트스트랩처럼 세션 힌트 유무와 무관하게 첫 인증 호출이 반드시 기다려야
     // 하는 boot promise 인지 여부 (setBootRestorePromise 의 alwaysAwait 옵션).
     this.bootRestoreAlwaysAwait = false;
+    /**
+     * 서버가 `X-CB-Direct-Base` 로 알려준 저지연 원본. 학습 전에는 null 이라 항상 `baseUrl`
+     * 을 쓴다. {@link resolveOrigin} 참고.
+     */
+    this.directBaseUrl = null;
+    /**
+     * direct 원본을 이 세션에서 더는 쓰지 않는다는 표시. 한 번이라도 네트워크 레벨에서
+     * 실패하면(CSP `connect-src` 차단, 사내 프록시, DNS 미전파, 호스트 회수 등) 즉시 세워
+     * 이후 요청은 전부 `baseUrl` 로 간다. direct 는 최적화일 뿐 필수가 아니므로 재시도를
+     * 반복하지 않고 한 번에 포기하는 쪽이 안전하다.
+     */
+    this.directDisabled = false;
     this.config = { ...config };
     this.storageKey = this.buildStorageKey();
     this.warnIfUnsafePersistence();
@@ -12004,18 +12117,73 @@ var HttpClient = class {
       });
     }
   }
+  /**
+   * 이 요청을 보낼 원본을 고른다.
+   *
+   * `credentials:'omit'` 인 요청 — 즉 `X-Public-Key` 로만 인증하고 쿠키를 주고받지 않는
+   * `/v1/public/*` 데이터 평면 — 만 direct 원본으로 보낸다. 이 조건이 곧 안전 조건이다:
+   * 멤버 refresh 쿠키는 **host-only** 로 발급되므로(백엔드 auth_cookie.SetMemberRefreshCookie)
+   * 로그인·가입·로그아웃·OAuth·탈퇴를 다른 호스트로 보내면 세션이 조용히 끊긴다.
+   * `fetchCredentialsForPath` 가 이미 그 경계를 계산하고 있어, 나중에 쿠키 엔드포인트가
+   * 추가돼도 자동으로 제외된다(서버도 같은 경로를 421 로 되돌려보낸다).
+   */
+  resolveOrigin(url) {
+    if (this.directBaseUrl && !this.directDisabled && fetchCredentialsForPath(url) === "omit") {
+      return this.directBaseUrl;
+    }
+    return this.config.baseUrl;
+  }
+  /**
+   * 응답에서 저지연 원본 광고를 학습한다.
+   *
+   * 왜 서버가 정하나: 클라이언트는 자기가 어느 나라에서 접속했는지 신뢰성 있게 모르고,
+   * 두 호스트를 재보는 프로브는 요청을 한 번 더 쓴다. Cloudflare 엣지는 `CF-IPCountry` 로
+   * 이미 알고 있으므로 서버가 판단해 알려주는 쪽이 정확하고 공짜다. 서버 env 하나로
+   * 즉시 회수할 수도 있다.
+   *
+   * 값은 검증한다 — https 이고 `baseUrl` 과 같은 등록 도메인이어야 한다. 응답은 우리
+   * 서버에서 TLS 로 오지만, 설정 실수 하나로 SDK 트래픽 전체가 엉뚱한 호스트로 향하는
+   * 일은 없어야 한다.
+   */
+  learnDirectOrigin(response) {
+    if (this.directDisabled || this.directBaseUrl) return;
+    const advertised = response.headers?.get("X-CB-Direct-Base");
+    if (!advertised) return;
+    try {
+      const next = new URL(advertised);
+      const base = new URL(this.config.baseUrl);
+      if (next.protocol !== "https:") return;
+      const tail = (h) => h.split(".").slice(-2).join(".");
+      if (tail(next.hostname) !== tail(base.hostname)) return;
+      this.directBaseUrl = next.origin;
+    } catch {
+    }
+  }
   async tryFetchOnce(url, init, config) {
     const { signal, cleanup } = createTimeoutController({
       timeout: config?.timeout ?? this.config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
       signal: config?.signal
     });
+    const origin = this.resolveOrigin(url);
     try {
-      const response = await fetch(`${this.config.baseUrl}${url}`, {
+      const response = await fetch(`${origin}${url}`, {
         ...init,
         credentials: fetchCredentialsForPath(url),
         signal
       });
+      this.learnDirectOrigin(response);
       return { response, ok: response.ok, status: response.status };
+    } catch (err) {
+      if (origin !== this.config.baseUrl && !isAbortError(err)) {
+        this.directDisabled = true;
+        const response = await fetch(`${this.config.baseUrl}${url}`, {
+          ...init,
+          credentials: fetchCredentialsForPath(url),
+          signal
+        });
+        return { response, ok: response.ok, status: response.status };
+      }
+      throw err;
     } finally {
       cleanup();
     }
@@ -12082,11 +12250,21 @@ var HttpClient = class {
       const extra = new Headers(init.headers);
       extra.forEach((value, key) => mergedHeaders.set(key, value));
     }
-    return fetch(`${this.config.baseUrl}${url}`, {
-      ...init,
-      credentials: fetchCredentialsForPath(url),
-      headers: mergedHeaders
-    });
+    const origin = this.resolveOrigin(url);
+    try {
+      const response = await fetch(`${origin}${url}`, {
+        ...init,
+        credentials: fetchCredentialsForPath(url),
+        headers: mergedHeaders
+      });
+      this.learnDirectOrigin(response);
+      return response;
+    } catch (err) {
+      if (origin !== this.config.baseUrl && !isAbortError(err)) {
+        this.directDisabled = true;
+      }
+      throw err;
+    }
   }
 };