connectbase-client 6.11.0 → 6.13.0

package/dist/index.d.ts

@@ -456,6 +456,17 @@ declare class HttpClient {
     private markNoCookieSession;
     private clearNoCookieSessionMark;
     /** 쿠키 전용 refresh 를 지금 건너뛰어야 하는지 (최근에 401/403 을 받았는지). */
+    /**
+     * 이 브라우저에 세션이 없다는 것을 이미 아는가. 메모리에 access/refresh token 이 없고, 60초 안의 쿠키 복구가
+     * "세션 없음"(401 또는 quiet 204)으로 끝났으면 true 다. 회원 전용 API 는 물어도 401 뿐이라, 부르는 쪽이 요청을
+     * 건너뛰고 {@link rejectNoSession} 으로 같은 오류를 던질 때 쓴다.
+     */
+    knowsNoSession(): boolean;
+    /**
+     * 세션이 없을 때 서버가 돌려주는 것과 같은 401 ApiError 를 요청 없이 만든다. 서버 경로와 같은 변환(buildApiError)과
+     * 오류 알림(emitError)을 거치므로 앱이 받는 오류는 그대로이고, 브라우저 콘솔에 실패한 요청만 남지 않는다.
+     */
+    rejectNoSession(): Promise<ApiError>;
     private isNoCookieSessionMarkFresh;
     /**
      * OAuth redirect callback 직후 호출되어 HttpOnly cookie 를 부트스트랩한다.
@@ -558,6 +569,23 @@ declare class HttpClient {
     tryRestoreSessionFromCookie(): Promise<boolean>;
     private emitError;
     private isTokenExpired;
+    /**
+     * 실시간 연결(`cb.realtime`, `cb.database` 실시간)이 연결 위에서 token 을 갱신할 수 있는지 — token 이 이 클라이언트가 들고
+     * 있는 멤버 세션(같은 앱, 같은 멤버)의 것이고, 세션을 refresh 할 수단(메모리의 refresh token, 또는 브라우저의 HttpOnly
+     * 쿠키)이 있을 때만이다. 앱이 다른 곳에서 받은 토큰(다른 멤버, 함수의 위임 토큰, OAuth 토큰)이면 false.
+     */
+    canRefreshMemberToken(token: string | undefined): boolean;
+    /**
+     * token 과 같은 멤버 세션의 access token 을 minValiditySec 초 이상 남은 것으로 돌려준다. 지금 세션 토큰이 그만큼 남았으면
+     * 그대로, 아니면 HTTP 요청과 같은 refresh(같은 single-flight, 같은 실패 처리 — 세션이 끝났으면 onTokenExpired)를 한다.
+     * 세션이 다르거나 갱신에 실패하면 undefined.
+     *
+     * `replace` 는 token 이 곧 만료된다고 서버가 알렸을 때 쓴다 — 세션 토큰이 token 과 같으면 이쪽 시계로는 아직 남았어도
+     * 갱신한다(기기 시계가 늦으면 서버 기준 만료를 놓친다).
+     */
+    freshTokenForMember(token: string, minValiditySec: number, options?: {
+        replace?: boolean;
+    }): Promise<string | undefined>;
     private prepareHeaders;
     /**
      * 실패 응답(`!response.ok`)을 ApiError 로 변환한다. 던지지도, emitError 하지도 않는다.
@@ -1639,6 +1667,33 @@ interface AppMemberDetail {
     suspended_until?: string;
     suspend_reason?: string;
 }
+/** `cb.appMembers.suspend` 옵션. */
+interface SuspendAppMemberOptions {
+    /**
+     * 정지 사유(1~500자). 정지된 회원이 로그인하거나 실시간에 다시 붙으려 할 때 이 문구가 그대로 보인다 — 회원에게
+     * 보여 줄 문장으로 쓴다.
+     */
+    reason: string;
+    /**
+     * 정지가 풀리는 시각. 생략하면 `unsuspend` 할 때까지 **영구** 정지다. 지금 이후, 2038-01-19T03:14:07Z 이전이어야
+     * 한다(그보다 길게 막으려면 생략한다). `Date` 또는 ISO 8601 문자열.
+     */
+    until?: Date | string;
+}
+/** `cb.appMembers.suspend` 반환값. 백엔드 `SuspendMemberResponse` 매핑. */
+interface SuspendAppMemberResult {
+    member_id: string;
+    is_suspended: boolean;
+    suspended_at: string;
+    /** 없으면 영구 정지. */
+    suspended_until?: string;
+    suspend_reason: string;
+}
+/** `cb.appMembers.unsuspend` 반환값. 백엔드 `UnsuspendMemberResponse` 매핑. */
+interface UnsuspendAppMemberResult {
+    member_id: string;
+    is_suspended: boolean;
+}
 /**
  * 앱 멤버 **관리자 조회** API — 서버사이드 전용.
  *
@@ -1649,7 +1704,8 @@ interface AppMemberDetail {
  * service_role 함수에서 쓰려면 함수 `management_scopes` 에 `app_member:read` 를 opt-in 해야
  * 한다. 이 스코프는 **이메일(개인정보)** 을 함께 열어주므로 어드민/CS 흐름에만 부여할 것.
  *
- * 쓰기(생성·삭제·정지·수정)와 활동 로그 조회는 콘솔 전용이다 — service_role 에 열려 있지 않다.
+ * 쓰기 중 삭제(`remove`, `app_member:write`)와 정지(`suspend`/`unsuspend`, `app_member:suspend`)만 service_role 에
+ * 열려 있다. 생성, 수정과 활동 로그 조회는 콘솔 전용이다.
  *
  * @example
  * ```typescript
@@ -1712,6 +1768,46 @@ declare class AppMembersAPI {
     remove(appId: string, memberId: string): Promise<{
         message: string;
     }>;
+    /**
+     * 앱 멤버를 정지한다. 되돌릴 수 있다(`unsuspend`). (management_scope: `app_member:suspend`)
+     *
+     * 콘솔의 정지와 같은 일을 한다.
+     * - 정지 기간 동안 로그인(비밀번호, 소셜), 토큰 재발급, 실시간 접속이 거부된다. 거부 사유로 `reason` 이 보인다.
+     * - 그 회원의 세션(refresh token)을 모두 끊고, 지금 붙어 있는 실시간 연결(`cb.realtime`, DB 실시간, 게임, WebRTC
+     *   시그널링)을 닫는다(close 4403 `member_revoked`).
+     * - 이미 발급된 access token 은 HTTP 요청에는 만료(최대 1시간)까지 유효하다. 데이터 접근을 즉시 막아야 하면 RLS 규칙에
+     *   정지 여부를 반영한다.
+     * - 활동 로그(invoked_by `service_role`)와 IAM 감사(`app_member.suspend`)에 남는다.
+     *
+     * 이미 정지된 회원이면 400 이다(기간을 바꾸려면 `unsuspend` 후 다시 정지한다). 기간이 지난 정지는 정지로 보지 않는다.
+     *
+     * @param appId 앱 ID (함수 안에서는 `ctx.appId`)
+     * @param memberId 정지할 멤버 ID
+     * @param options `reason`(필수), `until`(생략하면 영구)
+     *
+     * @example
+     * ```typescript
+     * // 함수(service_role, management_scopes: ["app_member:suspend"]) 안에서 — 신고 누적 7일 정지
+     * await ctx.cbAdmin.appMembers.suspend(ctx.appId, memberId, {
+     *   reason: '신고가 누적되어 7일간 이용이 제한됩니다',
+     *   until: new Date(Date.now() + 7 * 24 * 60 * 60 * 1000),
+     * })
+     *
+     * // 결제 사기 — 영구 정지(until 생략)
+     * await ctx.cbAdmin.appMembers.suspend(ctx.appId, memberId, { reason: '결제 이상으로 계정이 정지되었습니다' })
+     * ```
+     */
+    suspend(appId: string, memberId: string, options: SuspendAppMemberOptions): Promise<SuspendAppMemberResult>;
+    /**
+     * 앱 멤버의 정지를 푼다. (management_scope: `app_member:suspend`)
+     *
+     * 정지로 끊긴 세션은 되살아나지 않는다 — 회원은 다시 로그인해야 한다(정지 전에 발급된 토큰으로는 실시간에 다시 붙을
+     * 수 없다). 정지되지 않은 회원이면 400 이다.
+     *
+     * @param appId 앱 ID
+     * @param memberId 정지를 풀 멤버 ID
+     */
+    unsuspend(appId: string, memberId: string): Promise<UnsuspendAppMemberResult>;
 }
 
 /**
@@ -3219,6 +3315,15 @@ declare class DatabaseAPI {
     private pingInterval;
     private realtimeOnStateChange;
     private realtimeOnError;
+    /**
+     * 이 연결이 `token_refresh=1` 로 협상했는지 — 연결 토큰이 SDK 세션의 멤버 토큰이라 연결 위에서 갱신할 수 있을 때만.
+     * 협상하지 않은 연결(다른 곳에서 받은 토큰, cross-app OAuth 토큰)은 예전처럼 동작한다(서버가 만료 뒤 24시간에 닫는다).
+     */
+    private realtimeTokenRefresh;
+    private realtimeAuthRefreshInFlight;
+    private realtimeAuthRetryTimer;
+    /** 서버가 닫기 직전에 보낸 안내(TOKEN_EXPIRED, MEMBER_REVOKED) — 이어지는 close 오류의 메시지가 된다. */
+    private realtimeCloseNotice;
     private activeSubscriptions;
     constructor(http: HttpClient);
     /**
@@ -3600,6 +3705,11 @@ declare class DatabaseAPI {
      */
     onRealtimeError(handler: (error: Error) => void): () => void;
     private setRealtimeState;
+    /**
+     * 연결(재연결)을 연다 — 먼저 토큰을 준비한다. SDK 세션의 멤버 토큰인데 곧(1분 안) 만료되면 새로 받는다. 끊긴 사이 만료된
+     * 토큰으로 붙으면 서버가 거부해 재연결이 멈춘다. 앱이 다른 곳에서 받은 토큰은 건드리지 않는다.
+     */
+    private connectRealtimeSocket;
     private doRealtimeConnect;
     /**
      * 서버에 subscribe 메시지를 보내고 서버 subscription_id를 반환하는 Promise
@@ -3615,6 +3725,16 @@ declare class DatabaseAPI {
     private stopRealtimePing;
     private sendRealtimeMessage;
     private generateRequestId;
+    /**
+     * 연결을 끊지 않고 멤버 토큰을 바꾼다(`auth_refresh`). 새 토큰은 HTTP 요청과 같은 refresh 로 받는다
+     * (`HttpClient.freshTokenForMember`). 한 번에 하나만 보내고, 성공하면 재연결도 새 토큰을 쓴다. 실패하면 30초 뒤 다시 해
+     * 본다(서버는 만료 뒤 유예가 지나야 닫는다). SDK 세션 자체가 끝났으면 더 시도하지 않는다.
+     */
+    private refreshRealtimeAuth;
+    /** 요청 하나를 보내고 같은 request_id 의 응답(또는 error)을 기다린다. */
+    private sendRealtimeRequest;
+    private scheduleRealtimeAuthRetry;
+    private clearRealtimeAuthRetry;
     private debugLog;
 }
 
@@ -6333,8 +6453,8 @@ declare class OAuthAPI {
     private bootConsumePromise;
     /** 이 인스턴스가 `getCallbackResult()` 로 이미 적재한 콜백. 다시 불려도 토큰을 되돌리지 않는다. */
     private loadedCallback;
-    /** 진행 중이거나 끝난 code 교환. 주소에서 code 를 지운 뒤의 재호출이 같은 결과를 받게 한다. */
-    private codeExchange;
+    /** 이 인스턴스가 이미 적재한 code 콜백. 다시 불려도 토큰을 되돌리지 않는다. */
+    private loadedCodeCallback;
     constructor(http: HttpClient);
     /**
      * 활성화된 OAuth 프로바이더 목록 조회
@@ -6444,6 +6564,11 @@ declare class OAuthAPI {
     signInWithPopup(provider: OAuthProvider, callbackUrl?: string, options?: {
         intent?: "signin" | "signup";
     }): Promise<OAuthCallbackResponse>;
+    /**
+     * 네이티브 브릿지가 돌려준 주소에서 로그인 결과를 만든다. code 면 교환하고, 토큰이면(response_type 을 모르는 옛 서버)
+     * 그대로 쓴다.
+     */
+    private readBridgeResult;
     /**
      * 팝업 메시지를 보낼 수 있는 출처: 서버 제공 콜백 페이지(API 서버)와 앱이 지정한 콜백 페이지.
      *
@@ -6475,6 +6600,10 @@ declare class OAuthAPI {
      * 않으면(남이 보낸 링크 등) 토큰을 적재하지 않고 `{ error: 'oauth_state_mismatch' }` 를 돌려줍니다.
      * 토큰은 SDK 가 생성될 때 주소에서 지우므로 `location.search` 로 직접 읽을 수 없습니다.
      *
+     * `signIn()` 은 서버에 1회용 `code` 만 달라고 요청하므로(`response_type=code`) 콜백 주소에는 보통 `?code=&state=` 가 옵니다.
+     * 이 메서드가 state 를 확인한 뒤 `POST /v1/auth/oauth/exchange` 로 교환하고 토큰을 저장합니다(결과 모양은 같다).
+     * state 가 맞지 않는 code 는 교환하지 않고 `{ error: 'oauth_state_mismatch' }` 를 돌려줍니다.
+     *
      * @returns OAuth 결과 (토큰, member_id 등) 또는 null
      *
      * @example
@@ -6505,41 +6634,42 @@ declare class OAuthAPI {
      */
     private loadCallbackOnce;
     /**
-     * (SDK 내부용 — `ConnectBase` 생성자가 호출) 주소의 토큰 콜백을 회수해 지우고 그 종류를 알린다.
+     * (SDK 내부용 — `ConnectBase` 생성자가 호출) 주소의 콜백을 회수해 지우고 그 종류를 알린다.
+     *
+     * 토큰 콜백은 state 와 opener 로 가른다. code 콜백은 이 브라우저에서 시작한 로그인(state 일치)일 때만 여기서
+     * 회수한다 — 앱이 지정한 팝업 콜백 페이지의 code 와 앱 자체 OAuth 의 code 는 앱의 명시 호출에 맡긴다.
      *
-     * @returns `redirect` 면 부팅 안전망 대상, `popup` 이면 팝업 콜백, `none` 이면 토큰 콜백이 아니거나 거부됨.
+     * @returns `redirect` 면 부팅 안전망 대상, `popup` 이면 팝업 콜백, `none` 이면 콜백이 아니거나 거부됨.
      */
     captureCallbackOnBoot(): "redirect" | "popup" | "none";
     /**
      * (SDK 내부용 — `ConnectBase` 생성자가 호출) 부팅 안전망.
      *
      * OAuth 리다이렉트 콜백 페이지에서 앱이 `getCallbackResult()` 를 호출하지 않아도,
-     * `new ConnectBase()` 만으로 URL 의 토큰(`?access_token=&refresh_token=&member_id=`)을
-     * 적재해 세션을 확립한다.
+     * `new ConnectBase()` 만으로 이 브라우저에서 시작한 로그인의 결과(URL 의 토큰, 또는 state 가 맞는 1회용
+     * `code` 의 교환 결과)를 적재해 세션을 확립한다.
      *
      * **왜 필요한가:** 정적 호스팅(웹 스토리지)은 SPA fallback 으로 `/auth/callback` 같은 콜백
      * 경로에 홈 `index.html` 을 서빙한다. 그 페이지가 콜백을 처리하지 않으면 URL 토큰이 영영
      * 소비되지 않아 "로그인 → 다시 로그인 페이지" 무한 루프가 발생한다 (여러 사용자 동시 보고).
-     * 이 안전망은 콜백 처리 코드를 빠뜨린 앱도 동작하게 한다.
+     * 이 안전망은 콜백 처리 코드를 빠뜨린 앱도 동작하게 한다. `signIn()` 이 code 를 받으므로(`response_type=code`) code 도
+     * 같은 이유로 여기서 교환한다.
      *
      * **token rotation race(2026-05-16) 가 없는 이유:** 사전 `re-issue`(cookie 복구) 없이 URL
      * 토큰을 *직접* 소비한다 — `getCallbackResult()` 의 리다이렉트 경로와 동일한 동작이다. 팝업 콜백과
-     * 거부된 콜백(`captureCallbackOnBoot()` 참고)은 생성자에서 제외되어 호출되지 않는다. code-only(`?code=`),
-     * 에러(`?error=`) 콜백도 생성자에서 제외된다 (네트워크 교환/에러 분기는 앱이 명시 호출).
+     * 거부된 콜백(`captureCallbackOnBoot()` 참고)은 생성자에서 제외되어 호출되지 않는다. 에러(`?error=`) 콜백과
+     * state 가 맞지 않는 code 도 생성자에서 제외된다 (에러 분기, 앱 자체 OAuth 는 앱이 명시 호출).
      *
      * @returns 토큰 적재 성공 시 true, no-op(토큰 없음 등)이면 false.
      */
     consumeRedirectCallbackOnBoot(): Promise<boolean>;
     private doConsumeRedirectOnBoot;
     /**
-     * 콜백 URL 에서 1회용 `code` 를 토큰으로 교환합니다 (`OAUTH_CODE_ONLY` 서버 모드용).
-     *
-     * 서버가 `OAUTH_CODE_ONLY=true` 모드면 리다이렉트 URL 에 토큰 대신 `code` 만 포함됩니다.
-     * 이 메서드는 code 를 `POST /v1/auth/oauth/exchange` 로 교환하고 토큰을 자동 저장합니다.
+     * 콜백 URL 의 1회용 `code` 를 토큰으로 교환합니다.
      *
-     * 권장 호출 순서:
-     *   1) `cb.oauth.exchangeCodeFromCallback()` 먼저 — code-only 모드면 성공
-     *   2) null 반환 시 `cb.oauth.getCallbackResult()` 폴백 (legacy 토큰-in-URL 모드)
+     * 이제 `getCallbackResult()` 와 부팅 안전망이 code 도 처리하므로 따로 부를 필요가 없습니다. 이미 이
+     * 메서드를 부르는 앱(`exchangeCodeFromCallback() ?? getCallbackResult()`)은 그대로 동작하고, 같은 code 를 두 번
+     * 교환하지 않습니다.
      *
      * `getCallbackResult()` 와 같은 이유로, 이 브라우저에서 시작한 로그인의 `code` 만 교환합니다. 확인되지
      * 않으면 `oauth_state_mismatch` 오류를 던지고 교환하지 않습니다.
@@ -6551,7 +6681,11 @@ declare class OAuthAPI {
      * ```
      */
     exchangeCodeFromCallback(): Promise<ExchangedCallbackResult | null>;
-    private exchangeCode;
+    /**
+     * 회수한 code 콜백을 마무리한다. code 는 한 번만 교환하고(한 페이지의 인스턴스가 여럿이어도), 리다이렉트면 이
+     * 인스턴스에 토큰을 한 번만 적재하고 쿠키를 부트스트랩한다. 팝업이면 같은 출처 opener 에게 넘기고 창을 닫는다.
+     */
+    private completeCodeCallback;
 }
 
 /**
@@ -6854,7 +6988,17 @@ type PaymentProvider = "toss" | "stripe" | "payapp" | "paypal" | "paddle" | "dod
  */
 type PaymentMode = "test" | "live";
 type PaymentStatus = "pending" | "ready" | "in_progress" | "done" | "canceled" | "partial_canceled" | "aborted" | "expired" | "failed";
-interface PreparePaymentRequest {
+/**
+ * `prepare()` 의 두 형태에 공통인 옵션.
+ *
+ * 금액을 정하는 방법은 둘 중 하나다:
+ * - {@link PreparePaymentWithProduct} — 가격표의 `product_id`(와 `quantity`)만 보낸다. 금액, 통화, 상품명은
+ *   **서버가 콘솔 가격표에서 정한다.** 브라우저에서 부르는 결제는 이 형태를 쓴다.
+ * - {@link PreparePaymentWithAmount} — `amount` 와 `order_name` 을 직접 보낸다(레거시, KRW). 결제 설정의 금액
+ *   출처가 `client` 인 앱이거나, 서버에서 시크릿 키(`cb_sk_`)나 service_role 함수로 부를 때만 받는다. 가격표
+ *   전용 앱(`catalog`, 새 앱의 기본값)에서 브라우저가 금액을 보내면 403 `client_amount_not_allowed` 다.
+ */
+interface PreparePaymentOptions {
     payment_provider?: PaymentProvider;
     /**
      * 사용할 자격증명 모드 오버라이드(선택).
@@ -6919,19 +7063,51 @@ interface PreparePaymentRequest {
      * (미지정 시 결제 설정의 fail_url).
      */
     fail_url?: string;
-    amount: number;
-    order_name: string;
     order_id?: string;
     customer_email?: string;
     customer_name?: string;
     customer_phone?: string;
+    /**
+     * 앱이 정하는 부가 데이터. **클라이언트가 보낸 값이라 권한 지급의 근거로 쓰지 않는다** — 무엇을 샀는지는 결제
+     * 기록의 `product_id`/`quantity` 를 본다.
+     */
     metadata?: Record<string, unknown>;
 }
+/** 가격표 결제 — 서버가 `단가 x 수량` 과 통화를 정한다. */
+interface PreparePaymentWithProduct extends PreparePaymentOptions {
+    /** 콘솔 가격표의 상품 ID (예: `gem_100`). 없거나 판매를 멈춘 상품이면 404 / 409. */
+    product_id: string;
+    /** 수량 (1~1000, 기본 1). 결제 금액 = 단가 x 수량. */
+    quantity?: number;
+    /** 가격표 결제에는 보낼 수 없다(400 `product_with_amount_fields`). */
+    amount?: never;
+    /** 가격표 결제의 상품명은 가격표에서 정한다(400 `product_with_amount_fields`). */
+    order_name?: never;
+}
+/**
+ * 금액 직접 지정(레거시) — 금액은 KRW 원 단위, 최소 100.
+ *
+ * 브라우저 사용자가 금액을 고칠 수 있으므로, 금액 출처가 `client` 인 앱이거나 서버 호출(시크릿 키, service_role
+ * 함수)에서만 쓴다.
+ */
+interface PreparePaymentWithAmount extends PreparePaymentOptions {
+    amount: number;
+    order_name: string;
+    product_id?: never;
+    quantity?: never;
+}
+type PreparePaymentRequest = PreparePaymentWithProduct | PreparePaymentWithAmount;
 interface PreparePaymentResponse {
     payment_id: string;
     order_id: string;
+    /** 서버가 정한 결제 금액(`currency` 의 최소 단위). 결제창에는 이 값을 그대로 넘긴다. */
     amount: number;
+    /** `amount` 의 통화 (ISO 4217). 가격표 상품이면 상품의 통화다. */
+    currency: string;
     order_name: string;
+    /** 가격표 결제면 상품 ID 와 수량. */
+    product_id?: string;
+    quantity?: number;
     payment_provider: PaymentProvider;
     /** 이 결제가 사용한 자격증명 모드. */
     payment_mode: PaymentMode;
@@ -6951,15 +7127,12 @@ interface PreparePaymentResponse {
     checkout_url?: string;
     launch_mode?: "overlay" | "redirect";
 }
-interface CreateCheckoutSessionRequest {
+interface CreateCheckoutSessionOptions {
     /**
      * 사용할 자격증명 모드 오버라이드(선택). `prepare()` 의 `payment_mode` 와 적용 조건이 같다 —
      * 서버 시크릿 키(`cb_sk_*`) 호출에서만 적용되고, 브라우저 공개 키 호출에서는 무시된다.
      */
     payment_mode?: PaymentMode;
-    amount: number;
-    currency: string;
-    product_name: string;
     success_url: string;
     cancel_url: string;
     order_id?: string;
@@ -6967,11 +7140,31 @@ interface CreateCheckoutSessionRequest {
     customer_name?: string;
     metadata?: Record<string, unknown>;
 }
+/** 가격표 결제 — 금액, 통화, 상품명은 서버가 가격표에서 정한다. */
+interface CreateCheckoutSessionWithProduct extends CreateCheckoutSessionOptions {
+    product_id: string;
+    /** 수량 (1~1000, 기본 1) */
+    quantity?: number;
+    amount?: never;
+    currency?: never;
+    product_name?: never;
+}
+/** 금액 직접 지정(레거시). 받는 조건은 `prepare()` 의 금액 형태와 같다. */
+interface CreateCheckoutSessionWithAmount extends CreateCheckoutSessionOptions {
+    amount: number;
+    currency: string;
+    product_name: string;
+    product_id?: never;
+    quantity?: never;
+}
+type CreateCheckoutSessionRequest = CreateCheckoutSessionWithProduct | CreateCheckoutSessionWithAmount;
 interface CreateCheckoutSessionResponse {
     payment_id: string;
     order_id: string;
     amount: number;
     currency: string;
+    product_id?: string;
+    quantity?: number;
     session_id: string;
     session_url: string;
 }
@@ -6988,6 +7181,8 @@ interface ConfirmPaymentResponse {
     order_id: string;
     /** **실제 청구된** 금액. 할인이 적용되면 준비 금액보다 작다. */
     amount: number;
+    /** `amount` 의 통화 (ISO 4217). 가격표 상품은 KRW 가 아닐 수 있다. */
+    currency?: string;
     /** 할인으로 차감된 금액(준비 금액 − 실제 청구액). 할인이 없으면 생략된다. */
     discount_amount?: number;
     status: PaymentStatus;
@@ -7015,6 +7210,12 @@ interface PaymentDetail {
     amount: number;
     /** `amount` 의 통화 (ISO 4217) */
     currency: string;
+    /**
+     * 가격표로 준비한 결제의 상품 ID 와 수량. 서버가 정한 값이라 **권한 지급의 근거로 쓴다**
+     * (`metadata` 는 클라이언트가 보낸 값이다). 금액을 직접 지정한 결제는 비어 있다.
+     */
+    product_id?: string;
+    quantity?: number;
     /**
      * 정산통화 환산액 (MoR 프로바이더가 제공할 때만).
      *
@@ -7075,6 +7276,9 @@ interface PaymentListItem {
     amount: number;
     /** `amount` 의 통화 (ISO 4217). 다통화 결제에서 앱 기본 통화를 가정하면 거짓 금액이 된다 */
     currency: string;
+    /** 가격표 결제의 상품 ID 와 수량 (금액을 직접 지정한 결제는 비어 있다). */
+    product_id?: string;
+    quantity?: number;
     status: PaymentStatus;
     method?: string;
     /** toss | stripe 등 */
@@ -7101,19 +7305,26 @@ declare class PaymentAPI {
     private getPublicPrefix;
     /**
      * 결제 준비
-     * 토스 결제 위젯에 필요한 정보를 반환합니다.
+     * 결제창(토스 위젯, Stripe Elements, 호스티드 결제 페이지)에 필요한 정보를 반환합니다.
+     *
+     * **금액은 서버가 정합니다.** 브라우저에서는 콘솔 가격표의 `product_id`(와 `quantity`)만 보내고, 서버가
+     * `단가 x 수량` 과 통화를 계산합니다. 사용자가 개발자 도구로 요청을 고쳐도 가격을 바꿀 수 없습니다.
+     * `amount` 를 직접 보내는 형태(레거시)는 결제 설정의 금액 출처가 `client` 인 앱이거나, 서버에서
+     * 시크릿 키(`cb_sk_`)나 service_role 함수로 부를 때만 받습니다.
      *
-     * @param data - 결제 준비 정보 (금액, 상품명, 고객 정보 등)
-     * @returns 토스 클라이언트 키, 고객 키, 성공/실패 URL 등
+     * @param data - 가격표 상품(`product_id`, `quantity`) 또는 금액(`amount`, `order_name`), 고객 정보 등
+     * @returns 서버가 정한 금액과 통화, 토스 클라이언트 키, 고객 키, 성공/실패 URL 등
      *
      * @example
      * ```typescript
+     * // 가격표 결제 (권장) — 무엇을 몇 개 살지만 보낸다.
      * const result = await cb.payment.prepare({
-     *     amount: 10000,
-     *     order_name: '프리미엄 1개월',
+     *     product_id: 'gem_100',
+     *     quantity: 2,
      *     customer_email: 'test@example.com',
      *     customer_name: '홍길동'
      * })
+     * // result.amount, result.currency 는 서버가 가격표로 계산한 값이다(단가 x 수량).
      *
      * // Toss V2 결제 플로우
      * if (result.payment_provider === 'toss') {
@@ -7121,7 +7332,7 @@ declare class PaymentAPI {
      *   const payment = tossPayments.payment({ customerKey: result.customer_key })
      *   await payment.requestPayment({
      *     method: 'CARD',
-     *     amount: { currency: 'KRW', value: result.amount },
+     *     amount: { currency: result.currency, value: result.amount },
      *     orderId: result.order_id,
      *     orderName: result.order_name,
      *     successUrl: result.success_url,
@@ -7145,8 +7356,7 @@ declare class PaymentAPI {
      *
      * // 할인 코드 (MoR: dodo/paddle) — PG 대시보드에서 발행한 코드를 그대로 넘긴다.
      * const discounted = await cb.payment.prepare({
-     *   amount: 10000,
-     *   order_name: '프리미엄 1개월',
+     *   product_id: 'premium_month',
      *   discount_code: 'LAUNCH50',   // 미리 적용
      *   allow_discount_code: true,   // 결제창에서 고객이 직접 입력하는 것도 허용 (Dodo)
      * })
@@ -7155,14 +7365,26 @@ declare class PaymentAPI {
      *
      * // 복귀 주소 — 배포마다 자기 호스트로 돌아오게 한다 (QA 가 라이브로 튕기지 않도록)
      * const withReturn = await cb.payment.prepare({
-     *   amount: 14900,
-     *   order_name: '프리미엄 1개월',
+     *   product_id: 'premium_month',
      *   return_url: `${window.location.origin}/app/premium?paid=1`,
      *   fail_url: `${window.location.origin}/app/premium?failed=1`,
      * })
+     *
+     * // 금액 직접 지정 (레거시) — 금액 출처가 client 인 앱, 또는 서버(시크릿 키, service_role 함수) 호출에서만 받는다.
+     * // 가격표 전용 앱에서 브라우저가 보내면 403 client_amount_not_allowed.
+     * const legacy = await cb.payment.prepare({
+     *   amount: 10000,
+     *   order_name: '프리미엄 1개월',
+     * })
      * ```
      *
      * @remarks
+     * 권한(아이템, 기간권)은 결제가 끝난 뒤 결제 기록의 `product_id`/`quantity` 로 지급합니다. `metadata` 는
+     * 클라이언트가 보낸 값이라 근거로 쓰지 않습니다. 가격표 오류는 사유별 코드로 옵니다: 없는 상품 404
+     * `payment_product_not_found`, 판매 중지 409 `payment_product_inactive`, `product_id` 와 `amount`/`order_name`
+     * 을 섞음 400 `product_with_amount_fields`, 프로바이더가 받지 못하는 통화 400 `currency_not_supported`
+     * (toss, payapp 은 KRW 상품만).
+     *
      * PayApp 은 `customer_phone` 이 필수입니다(결제요청 수신 번호). 미지정 시 서버가 거부합니다.
      *
      * 할인 코드는 MoR 프로바이더(dodo/paddle)에서만 지원됩니다. 그 외 프로바이더에 넘기면
@@ -7181,15 +7403,16 @@ declare class PaymentAPI {
      * 응답에 `session_url` 이 포함되며, 브라우저를 해당 URL 로 이동시키면 Stripe 가 카드 입력·결제를 처리한 뒤
      * `success_url` / `cancel_url` 로 복귀한다. `client_secret` 은 서버·클라이언트 어디에도 노출되지 않는다.
      *
-     * @param data - 결제 세션 정보 (금액, 통화, 상품명, success/cancel URL 등)
+     * 금액을 정하는 규칙은 `prepare()` 와 같다 — 브라우저에서는 가격표의 `product_id` 를 보내고, 금액, 통화,
+     * 상품명을 직접 보내는 형태는 금액 출처가 `client` 인 앱이나 서버 호출에서만 받는다.
+     *
+     * @param data - 가격표 상품(`product_id`, `quantity`) 또는 금액(`amount`, `currency`, `product_name`), success/cancel URL 등
      * @returns session_id, session_url (redirect 대상)
      *
      * @example
      * ```typescript
      * const sess = await client.payment.createCheckoutSession({
-     *   amount: 1000,
-     *   currency: 'USD',
-     *   product_name: 'Premium Subscription',
+     *   product_id: 'premium_month',
      *   success_url: 'https://app.example.com/success?session_id={CHECKOUT_SESSION_ID}',
      *   cancel_url: 'https://app.example.com/cancel',
      *   customer_email: 'user@example.com',
@@ -8181,7 +8404,13 @@ interface RealtimeConnectOptions {
     retryInterval?: number;
     /** 사용자 ID (인증된 사용자) */
     userId?: string;
-    /** JWT 액세스 토큰 (앱 멤버 인증용, API Key보다 우선) */
+    /**
+     * JWT 액세스 토큰 (앱 멤버 인증용, API Key보다 우선).
+     *
+     * 이 토큰이 SDK 가 로그인으로 들고 있는 멤버 세션(같은 앱, 같은 멤버)의 것이면, 연결은 만료 전에 SDK 세션으로 새 토큰을
+     * 받아 연결 위에서 바꾼다(`auth_refresh`) — 한 시간마다 끊기지 않는다. 재연결도 새 토큰을 쓴다. 다른 곳에서 받은 토큰이면
+     * 갱신하지 않고 예전처럼 동작한다(서버가 만료 뒤 24시간에 닫는다).
+     */
     accessToken?: string;
     /** 연결 타임아웃 (밀리초, 기본: 30000) */
     timeout?: number;
@@ -8245,14 +8474,14 @@ interface Subscription {
 /** 클라이언트 -> 서버 메시지 */
 interface ClientMessage {
     category: string;
-    action: "subscribe" | "unsubscribe" | "send" | "invoke" | "ping" | "history" | "stream" | "stream_stop" | "mark_read" | "presence_set" | "presence_on_disconnect" | "presence_get" | "presence_get_many" | "presence_subscribe" | "presence_unsubscribe" | "typing_start" | "typing_stop" | "typing_subscribe" | "typing_unsubscribe";
+    action: "subscribe" | "unsubscribe" | "send" | "invoke" | "ping" | "history" | "stream" | "stream_stop" | "mark_read" | "presence_set" | "presence_on_disconnect" | "presence_get" | "presence_get_many" | "presence_subscribe" | "presence_unsubscribe" | "typing_start" | "typing_stop" | "typing_subscribe" | "typing_unsubscribe" | "auth_refresh";
     data?: unknown;
     request_id: string;
 }
 /** 서버 -> 클라이언트 메시지 */
 interface ServerMessage<T = unknown> {
     category?: string;
-    event: "connected" | "subscribed" | "unsubscribed" | "message" | "sent" | "result" | "error" | "pong" | "history" | "stream_token" | "stream_done" | "stream_error" | "stream_tool_call" | "stream_tool_result" | "read_receipt" | "presence" | "presence_status" | "typing";
+    event: "connected" | "subscribed" | "unsubscribed" | "message" | "sent" | "result" | "error" | "pong" | "history" | "stream_token" | "stream_done" | "stream_error" | "stream_tool_call" | "stream_tool_result" | "read_receipt" | "presence" | "presence_status" | "typing" | "token_expiring" | "token_expired" | "token_refreshed";
     data?: T;
     request_id?: string;
     error?: string;
@@ -8354,6 +8583,8 @@ interface ConnectedData {
     app_id: string;
     client_id: string;
     user_id?: string;
+    /** 멤버 토큰의 만료 시각(Unix 초). accessToken 연결에만 있다. */
+    token_expires_at?: number;
 }
 /** 구독 성공 데이터 */
 interface SubscribedData {
@@ -8469,6 +8700,17 @@ declare class RealtimeAPI {
     private readReceiptHandlers;
     constructor(http: HttpClient, socketUrl: string);
     private connectPromise;
+    /**
+     * 이 연결이 `token_refresh=1` 로 협상했는지 — 연결 토큰이 SDK 세션(HttpClient)의 멤버 토큰이라 연결 위에서 갱신할 수
+     * 있을 때만 협상한다. 협상한 연결에만 서버가 만료 안내를 보내고, 협상하지 않은 연결은 예전처럼 만료 뒤 24시간에 닫힌다.
+     */
+    private tokenRefreshNegotiated;
+    /** 진행 중인 auth_refresh — 같은 순간에 두 번 보내지 않는다. */
+    private authRefreshInFlight;
+    /** 갱신이 실패했을 때 다시 해 보는 타이머. */
+    private authRefreshRetryTimer;
+    /** 서버가 닫기 직전에 보낸 안내(TOKEN_EXPIRED, MEMBER_REVOKED) 문구 — 이어지는 4401/4403 close 오류의 메시지가 된다. */
+    private closeNotice;
     /**
      * WebSocket 연결
      * @param options 연결 옵션
@@ -8786,6 +9028,20 @@ declare class RealtimeAPI {
      */
     private connectWithRetry;
     private doConnect;
+    /**
+     * 연결(재연결)에 쓸 토큰을 준비한다 — SDK 세션의 멤버 토큰인데 곧(1분 안) 만료되면 붙기 전에 새로 받는다. 만료된 토큰으로
+     * 붙으면 서버가 거부해 재연결이 멈춘다. 앱이 다른 곳에서 받은 토큰은 건드리지 않는다(예전과 같다).
+     */
+    private prepareConnectToken;
+    /**
+     * 연결을 끊지 않고 멤버 토큰을 바꾼다(`auth_refresh`). 새 토큰은 HTTP 요청과 같은 refresh 로 받는다
+     * (`HttpClient.freshTokenForMember` — 같은 single-flight, 같은 실패 처리). 한 번에 하나만 보내고, 성공하면 재연결도 새
+     * 토큰을 쓴다. 실패하면(세션 일시 장애) 30초 뒤 다시 해 본다 — 서버는 만료 뒤 유예(기본 5분)가 지나야 4401 로 닫는다.
+     * SDK 세션 자체가 끝났으면(로그아웃, refresh 거부) 더 시도하지 않는다.
+     */
+    private refreshConnectionAuth;
+    private scheduleAuthRefreshRetry;
+    private clearAuthRefreshRetry;
     private log;
     /**
      * 에러 로그. `options.debug` 가 true 일 때만 console 에 출력.
@@ -9526,7 +9782,17 @@ interface DeleteBillingKeyResponse {
 }
 type BillingCycle = "daily" | "weekly" | "monthly" | "yearly";
 type SubscriptionStatus = "active" | "paused" | "canceled" | "past_due" | "expired" | "trial";
-interface CreateSubscriptionRequest {
+/**
+ * `create()` 의 두 형태에 공통인 옵션.
+ *
+ * 무엇을 얼마에 청구할지는 둘 중 하나로 정한다:
+ * - {@link CreateSubscriptionWithProduct} — 콘솔 가격표의 정기 상품 `product_id` 만 보낸다. 금액, 통화, 주기,
+ *   플랜명, 무료 체험, MoR PG 가격 ref 는 **서버가 상품에서 정한다.** 브라우저에서 부르는 구독은 이 형태를 쓴다.
+ * - {@link CreateSubscriptionWithAmount} — 금액과 요금제를 직접 보낸다(레거시). 결제 설정의 금액 출처가 `client`
+ *   인 앱이거나 서버(시크릿 키, service_role 함수)에서 부를 때만 받는다. 가격표 전용 앱(`catalog`, 새 앱의 기본값)에서
+ *   브라우저가 보내면 403 `client_amount_not_allowed` 다.
+ */
+interface CreateSubscriptionOptions {
     /** 빌링키 ID (toss/stripe 필수, payapp 미사용 — payurl 모델) */
     billing_key_id?: string;
     /**
@@ -9537,34 +9803,19 @@ interface CreateSubscriptionRequest {
      */
     subscription_id?: string;
     /**
-     * true 면 구독 생성 즉시 1회차를 청구한다(빌링키 모델). false(기본)면 다음 결제일부터 청구.
-     * `trial_days` 가 있으면 즉시 청구하지 않는다(체험 종료 후 첫 청구).
+     * true 면 구독 생성 즉시 1회차를 청구한다(빌링키 모델). 생략하면 가격표 구독은 즉시, 금액 직접 지정은 다음
+     * 결제일부터 청구한다. 체험 기간이 있으면 즉시 청구하지 않는다(체험 종료 후 첫 청구).
+     *
+     * 가격표 전용 앱의 브라우저 호출은 `false` 를 보낼 수 없다(403 `client_schedule_not_allowed`) — 한 주기를 내지 않고
+     * 쓰게 된다. 무료 체험은 가격표 상품의 `trial_days` 로 정한다.
      *
      * MoR(paddle/dodo)은 결제창에서 1회차를 받으므로 이 값을 쓰지 않는다.
      */
     start_now?: boolean;
-    /** 플랜 이름 */
-    plan_name: string;
-    /** 플랜 설명 */
-    plan_description?: string;
-    /** 결제 금액 */
-    amount: number;
-    /** 통화 (기본: KRW) */
-    currency?: string;
-    /** 결제 주기 */
-    billing_cycle: BillingCycle;
-    /** 결제일 (monthly: 1-28일, weekly: 0-6 요일) */
-    billing_day?: number;
     /**
-     * 트라이얼(무료 체험) 기간 (일).
-     *
-     * 빌링키 모델(toss/stripe)에서는 ConnectBase 스케줄러가 체험 종료일에 첫 청구를 건다.
-     * MoR 은 PG 가 정기청구를 소유하므로 결제창 생성 시 체험 일수를 함께 보낸다:
-     * - **Dodo**: 구독마다 지정 가능(0~10000일)
-     * - **Paddle**: 트라이얼이 요금제(price)에 붙는 속성이라 구독마다 지정할 수 없다 →
-     *   400 `trial_days_unsupported`. 체험이 설정된 price 를 Paddle 대시보드에서 따로 만들어 쓴다.
+     * 결제일 (monthly: 1-28일, weekly: 0-6 요일). 가격표 전용 앱의 브라우저 호출은 지정할 수 없다(첫 주기가 길어진다).
      */
-    trial_days?: number;
+    billing_day?: number;
     /**
      * 첫 결제에 적용할 할인/쿠폰 코드(MoR 전용, 선택).
      *
@@ -9596,8 +9847,6 @@ interface CreateSubscriptionRequest {
     customer_phone?: string;
     /** payapp 정기결제 만료일 yyyy-mm-dd (미입력시 +10년) */
     expire_date?: string;
-    /** MoR 필수: PG 카탈로그의 recurring price/product ref (Paddle `pri_*` / Dodo `pdt_*`) */
-    provider_price_ref?: string;
     /**
      * 사용할 자격증명 모드 오버라이드 (test|live). 단건결제 `prepare()` 의 `payment_mode` 와
      * 적용 조건이 **완전히 동일**하다 — 서버 시크릿 키(`cb_sk_*`)로 승격된 호출에서만 적용되고,
@@ -9609,9 +9858,48 @@ interface CreateSubscriptionRequest {
      * 구독은 생성 시점 모드가 고정되므로 이후 갱신 청구·해지도 같은 키로 처리된다.
      */
     payment_mode?: "test" | "live";
-    /** 메타데이터 */
+    /** 메타데이터 (클라이언트 값이라 권한 지급의 근거로 쓰지 않는다 — 구독의 `product_id` 를 본다) */
     metadata?: Record<string, unknown>;
 }
+/** 가격표 정기 상품으로 구독한다 — 금액, 통화, 주기, 플랜명, 체험 기간, PG 가격 ref 를 서버가 정한다. */
+interface CreateSubscriptionWithProduct extends CreateSubscriptionOptions {
+    /** 콘솔 가격표의 정기 상품 ID (예: `premium_month`). 단건 상품이면 400 `product_not_recurring`. */
+    product_id: string;
+    plan_name?: never;
+    plan_description?: never;
+    amount?: never;
+    currency?: never;
+    billing_cycle?: never;
+    trial_days?: never;
+    provider_price_ref?: never;
+}
+/** 금액과 요금제를 직접 정한다(레거시 앱, 서버 호출). */
+interface CreateSubscriptionWithAmount extends CreateSubscriptionOptions {
+    /** 플랜 이름 */
+    plan_name: string;
+    /** 플랜 설명 */
+    plan_description?: string;
+    /** 결제 금액 */
+    amount: number;
+    /** 통화 (기본: KRW) */
+    currency?: string;
+    /** 결제 주기 */
+    billing_cycle: BillingCycle;
+    /**
+     * 트라이얼(무료 체험) 기간 (일).
+     *
+     * 빌링키 모델(toss/stripe)에서는 ConnectBase 스케줄러가 체험 종료일에 첫 청구를 건다.
+     * MoR 은 PG 가 정기청구를 소유하므로 결제창 생성 시 체험 일수를 함께 보낸다:
+     * - **Dodo**: 구독마다 지정 가능(0~10000일)
+     * - **Paddle**: 트라이얼이 요금제(price)에 붙는 속성이라 구독마다 지정할 수 없다 →
+     *   400 `trial_days_unsupported`. 체험이 설정된 price 를 Paddle 대시보드에서 따로 만들어 쓴다.
+     */
+    trial_days?: number;
+    /** MoR 필수: PG 카탈로그의 recurring price/product ref (Paddle `pri_*` / Dodo `pdt_*`) */
+    provider_price_ref?: string;
+    product_id?: never;
+}
+type CreateSubscriptionRequest = CreateSubscriptionWithProduct | CreateSubscriptionWithAmount;
 interface SubscriptionResponse {
     /** 구독 ID (UUID) */
     id: string;
@@ -9634,6 +9922,11 @@ interface SubscriptionResponse {
     launch_mode?: "overlay" | "redirect";
     /** paddle: 현재 구독이 물린 recurring price ID (pri_*) */
     provider_price_ref?: string;
+    /**
+     * 가격표 정기 상품으로 만든 구독이면 그 상품 ID. 서버가 정한 값이라 **권한 지급의 근거로 쓴다**. 금액을 직접
+     * 바꾸거나 PG 가 가격표에 없는 가격으로 바꾸면 비워진다.
+     */
+    product_id?: string;
     /** 플랜 이름 */
     plan_name: string;
     /** 플랜 설명 */
@@ -9701,11 +9994,20 @@ interface SubscriptionResponse {
 interface UpdateSubscriptionRequest {
     /** 새 빌링키 ID */
     billing_key_id?: string;
-    /** 플랜 이름 */
+    /**
+     * 다른 가격표 정기 상품으로 바꾼다(빌링키 구독만, 다음 청구부터 새 금액). 금액, 통화, 주기, 플랜명을 상품에서 정한다.
+     * 정산이 없어 가격표 전용 앱에서는 서버 호출만 쓸 수 있다(브라우저는 403 `client_plan_change_not_allowed`).
+     * MoR 구독은 {@link SubscriptionAPI.changePlan} 을 쓴다. 빈 문자열이면 가격표 연결만 끊는다.
+     */
+    product_id?: string;
+    /** 플랜 이름 (가격표 전용 앱에서는 서버 호출만) */
     plan_name?: string;
     /** 플랜 설명 */
     plan_description?: string;
-    /** 결제 금액 */
+    /**
+     * 결제 금액 (빌링키 구독만, 가격표 전용 앱에서는 서버 호출만). 바꾸면 `product_id` 가 비워진다.
+     * PG 가 청구 금액을 정하는 구독(payapp, paypal, MoR)은 400 `subscription_amount_update_unsupported`.
+     */
     amount?: number;
     /** 메타데이터 */
     metadata?: Record<string, unknown>;
@@ -9790,8 +10092,30 @@ type OnPaymentFailure = "prevent_change" | "apply_change";
  * toss/stripe/payapp/paypal 구독은 PG 네이티브 proration 이 없어 400
  * `plan_change_unsupported` 다.
  */
-interface ChangePlanRequest {
-    /** 새 recurring price/product ref (Paddle `pri_*` / Dodo `pdt_*`) — 필수 */
+interface ChangePlanOptions {
+    /**
+     * 정산 방식 (기본: prorated_immediately). 가격표 전용 앱의 브라우저 호출은 지금 정산하는 모드
+     * (`prorated_immediately`, `full_immediately`, `difference_immediately`)만 쓸 수 있다
+     * (403 `proration_mode_not_allowed`) — 다음 주기로 미루면 돈을 내기 전에 비싼 요금제를 쓴다.
+     */
+    proration_mode?: ProrationMode;
+    /** 즉시청구 실패 시 처리 (기본: prevent_change). 가격표 전용 앱의 브라우저 호출은 `prevent_change` 만. */
+    on_payment_failure?: OnPaymentFailure;
+    /** 메타데이터 병합 (선택) */
+    metadata?: Record<string, unknown>;
+}
+/** 가격표 정기 상품으로 바꾼다 — 새 PG 가격 ref 와 플랜명을 서버가 상품에서 정한다. */
+interface ChangePlanWithProduct extends ChangePlanOptions {
+    /** 콘솔 가격표의 정기 상품 ID. 상품에 이 구독의 프로바이더와 모드용 PG 가격 ref 가 있어야 한다. */
+    product_id: string;
+    provider_price_ref?: never;
+    plan_name?: never;
+    plan_description?: never;
+    amount?: never;
+}
+/** PG 가격 ref 를 직접 지정한다(레거시 앱, 서버 호출). */
+interface ChangePlanWithPriceRef extends ChangePlanOptions {
+    /** 새 recurring price/product ref (Paddle `pri_*` / Dodo `pdt_*`) */
     provider_price_ref: string;
     /** 우리 표시용 플랜명 (선택) */
     plan_name?: string;
@@ -9799,13 +10123,9 @@ interface ChangePlanRequest {
     plan_description?: string;
     /** 우리 기록용 정기 금액 (선택 — 미지정 시 PG 값으로 자동 수렴) */
     amount?: number;
-    /** 정산 방식 (기본: prorated_immediately) */
-    proration_mode?: ProrationMode;
-    /** 즉시청구 실패 시 처리 (기본: prevent_change) */
-    on_payment_failure?: OnPaymentFailure;
-    /** 메타데이터 병합 (선택) */
-    metadata?: Record<string, unknown>;
+    product_id?: never;
 }
+type ChangePlanRequest = ChangePlanWithProduct | ChangePlanWithPriceRef;
 /**
  * 요금제 스왑 미리보기 응답 — 실제 적용 없이 정산 결과만 계산.
  *
@@ -9911,14 +10231,12 @@ interface ListSubscriptionPaymentsResponse {
     limit: number;
     offset: number;
 }
-interface ChargeWithBillingKeyRequest {
+interface ChargeWithBillingKeyOptions {
     /** 빌링키 ID */
     billing_key_id: string;
-    /** 결제 금액 */
-    amount: number;
-    /** 상품명 */
-    order_name: string;
-    /** 주문 ID (선택) */
+    /**
+     * 주문 ID (선택). 재시도는 같은 내용이어야 한다 — 같은 주문 ID 로 다른 금액이나 상품을 보내면 409 `order_id_conflict`.
+     */
     order_id?: string;
     /** 고객 이메일 */
     customer_email?: string;
@@ -9927,6 +10245,24 @@ interface ChargeWithBillingKeyRequest {
     /** 메타데이터 */
     metadata?: Record<string, unknown>;
 }
+/** 가격표 단건 상품으로 청구한다 — 금액과 상품명을 서버가 정한다. */
+interface ChargeWithBillingKeyProduct extends ChargeWithBillingKeyOptions {
+    product_id: string;
+    /** 수량 (1~1000, 기본 1) */
+    quantity?: number;
+    amount?: never;
+    order_name?: never;
+}
+/** 금액을 직접 정한다(레거시 앱, 서버 호출). KRW. */
+interface ChargeWithBillingKeyAmount extends ChargeWithBillingKeyOptions {
+    /** 결제 금액 */
+    amount: number;
+    /** 상품명 */
+    order_name: string;
+    product_id?: never;
+    quantity?: never;
+}
+type ChargeWithBillingKeyRequest = ChargeWithBillingKeyProduct | ChargeWithBillingKeyAmount;
 interface ChargeWithBillingKeyResponse {
     /** 토스 결제 키 */
     payment_key: string;
@@ -9934,6 +10270,11 @@ interface ChargeWithBillingKeyResponse {
     order_id: string;
     /** 결제 금액 */
     amount: number;
+    /** `amount` 의 통화 (ISO 4217) */
+    currency?: string;
+    /** 가격표 결제면 상품 ID 와 수량 */
+    product_id?: string;
+    quantity?: number;
     /** 결제 상태 */
     status: string;
     /** 영수증 URL */
@@ -10060,32 +10401,41 @@ declare class SubscriptionAPI {
      * 구독 생성
      * 정기결제 구독을 생성합니다.
      *
-     * @param data - 구독 정보
-     * @returns 생성된 구독 정보
+     * **금액과 요금제는 서버가 정합니다.** 브라우저에서는 콘솔 가격표의 정기 상품 `product_id` 만 보내고, 서버가
+     * 금액, 통화, 주기, 플랜명, 무료 체험, MoR PG 가격 ref 를 상품에서 정합니다. 금액을 직접 보내는 형태(레거시)는
+     * 결제 설정의 금액 출처가 `client` 인 앱이거나 서버(시크릿 키, service_role 함수)에서 부를 때만 받습니다.
+     *
+     * @param data - 가격표 정기 상품(`product_id`) 또는 금액과 요금제, 빌링키, 고객 정보 등
+     * @returns 생성된 구독 정보 (`product_id` 포함)
      *
      * @example
      * ```typescript
+     * // 가격표 구독 (권장) — 금액, 주기, 체험 기간은 콘솔 가격표의 premium_month 가 정한다
      * const subscription = await client.subscription.create({
      *     billing_key_id: 'bk_xxxxx',
-     *     plan_name: '프리미엄 플랜',
-     *     amount: 9900,
-     *     billing_cycle: 'monthly',
-     *     billing_day: 15,  // 매월 15일 결제
-     *     trial_days: 7     // 7일 무료 체험
+     *     product_id: 'premium_month',
      * })
      *
-     * // MoR(dodo/paddle) 구독 + 할인 코드
+     * // MoR(dodo/paddle) 구독 + 할인 코드 — PG 가격 ref 도 상품의 provider_price_refs 에서 서버가 고른다
      * const promo = await client.subscription.create({
+     *     product_id: 'premium_month',
+     *     discount_code: 'LAUNCH50', // 첫 결제에 적용 (몇 주기까지인지는 PG 쿠폰 설정이 결정)
+     * })
+     *
+     * // 금액 직접 지정 (레거시 앱, 서버 호출) — 가격표 전용 앱에서 브라우저가 보내면 403 client_amount_not_allowed
+     * const legacy = await client.subscription.create({
+     *     billing_key_id: 'bk_xxxxx',
      *     plan_name: '프리미엄 플랜',
      *     amount: 9900,
      *     billing_cycle: 'monthly',
-     *     provider_price_ref: 'pdt_xxxxx', // PG 카탈로그의 recurring 상품
-     *     discount_code: 'LAUNCH50',       // 첫 결제에 적용 (몇 주기까지인지는 PG 쿠폰 설정이 결정)
-     *     trial_days: 14,                  // Dodo 만 지원 — Paddle 은 400 trial_days_unsupported
      * })
      * ```
      *
      * @remarks
+     * 권한은 구독의 `product_id` 로 지급합니다(`metadata` 는 클라이언트 값). 가격표 전용 앱의 브라우저 호출은
+     * `start_now: false` 와 `billing_day` 를 쓸 수 없습니다(403 `client_schedule_not_allowed`) — 둘 다 한 번 낸 돈으로 쓰는
+     * 기간을 늘립니다. 무료 체험은 상품의 `trial_days` 가 정합니다.
+     *
      * 할인 코드(`discount_code`)와 `trial_days` 의 프로바이더 지원 범위가 다릅니다:
      * - **Dodo**: 할인 코드 O, 결제창 쿠폰 입력 토글 O, 구독별 체험 일수 O
      * - **Paddle**: 할인 코드 O(코드→내부 ID 자동 해소), 쿠폰 입력칸은 항상 노출(숨김 불가),
@@ -10127,9 +10477,9 @@ declare class SubscriptionAPI {
      *
      * @example
      * ```typescript
+     * // 서버(시크릿 키, service_role 함수)에서 다른 가격표 상품으로 바꾸기 — 다음 청구부터 새 금액
      * await client.subscription.update(subscriptionId, {
-     *     plan_name: '엔터프라이즈 플랜',
-     *     amount: 29900
+     *     product_id: 'enterprise_month',
      * })
      *
      * // 다음 결제일을 특정 날짜로 옮기기 (기간권·보상)
@@ -10281,11 +10631,10 @@ declare class SubscriptionAPI {
      *
      * @example
      * ```typescript
+     * // 가격표 정기 상품으로 바꾼다 — 새 PG 가격 ref 와 플랜명은 서버가 상품에서 정한다
      * await client.subscription.changePlan(subscriptionId, {
-     *     provider_price_ref: 'pri_family_monthly', // Dodo 는 'pdt_*'
-     *     plan_name: '가족 플랜',
-     *     amount: 24900,
-     *     proration_mode: 'prorated_immediately',
+     *     product_id: 'family_month',
+     *     proration_mode: 'prorated_immediately', // 브라우저는 지금 정산하는 모드만
      * })
      * ```
      */
@@ -10312,7 +10661,7 @@ declare class SubscriptionAPI {
      * @example
      * ```typescript
      * const preview = await client.subscription.previewChangePlan(subscriptionId, {
-     *     provider_price_ref: 'pri_family_monthly',
+     *     product_id: 'family_month',
      * })
      * // 통화를 함께 포맷한다 — 금액만 쓰면 다통화에서 거짓 금액이 된다
      * format(preview.immediate_charge_amount, preview.currency)
@@ -10344,10 +10693,11 @@ declare class SubscriptionAPI {
      *
      * @example
      * ```typescript
+     * // 가격표 단건 상품으로 청구 — 금액과 상품명은 서버가 정한다
      * const result = await client.subscription.chargeWithBillingKey({
      *     billing_key_id: 'bk_xxxxx',
-     *     amount: 15000,
-     *     order_name: '추가 결제'
+     *     product_id: 'gem_100',
+     *     quantity: 2,
      * })
      *
      * if (result.status === 'done') {
@@ -11375,6 +11725,19 @@ interface WebRTCConnectOptions {
     isBroadcaster?: boolean;
     /** 로컬 미디어 스트림 */
     localStream?: MediaStream;
+    /**
+     * 비공개 룸으로 열 때 함께 들어올 회원 ID 목록 (최대 50개, 로그인 회원 연결만).
+     *
+     * 이 연결이 룸을 새로 열면 목록의 회원과 자신만 들어오는 비공개 룸이 된다. 이미 열린 룸이면 그 룸이
+     * 비공개이고 내가 목록에 있어야 들어간다(공개 룸이면 `이미 공개 룸으로 열려 있습니다` 오류).
+     * 참가자 모두가 같은 목록을 보내면 누가 먼저 오든 비공개로 열린다. 룸 ID 는 추측할 수 없는 값을 쓴다.
+     */
+    allowedMemberIds?: string[];
+}
+/** 서버가 join 요청을 바꿨을 때의 알림 (예: `broadcaster_requires_auth`, `broadcaster_role_required`) */
+interface WebRTCWarning {
+    code: string;
+    message: string;
 }
 /** 피어 정보 */
 interface PeerInfo {
@@ -11384,8 +11747,6 @@ interface PeerInfo {
     user_id?: string;
     /** 방송자 여부 */
     is_broadcaster?: boolean;
-    /** 참가 시간 */
-    joined_at?: string;
 }
 /** 룸 정보 */
 interface RoomInfo {
@@ -11448,6 +11809,8 @@ interface RoomSummary {
     peer_count: number;
     broadcaster_count: number;
     viewer_count: number;
+    /** 회원 허용 목록이 있는 비공개 룸이면 true (목록의 회원에게만 보인다) */
+    private?: boolean;
 }
 /**
  * 앱 통계 응답 — server `GetStats` (`GET /v1/apps/:appID/stats`) 의 와이어 형태.
@@ -11474,6 +11837,8 @@ interface JoinRoomRequest {
     room_id: string;
     /** 방송자 요청. 서버가 정한다(`JoinRoomResponse.is_broadcaster`). */
     is_broadcaster?: boolean;
+    /** 비공개 룸 회원 허용 목록 (`WebRTCConnectOptions.allowedMemberIds` 와 같은 규칙) */
+    allowed_member_ids?: string[];
 }
 /** 참가 응답 (`POST /rooms/join`) */
 interface JoinRoomResponse {
@@ -11483,6 +11848,8 @@ interface JoinRoomResponse {
     peers: PeerInfo[];
     /** 서버가 정한 역할 */
     is_broadcaster: boolean;
+    /** 들어간 룸이 비공개 룸이면 true */
+    private?: boolean;
     /** 참가는 됐지만 요청대로 되지 않은 사항 (예: `broadcaster_requires_auth`) */
     warning?: {
         code: string;
@@ -11521,7 +11888,14 @@ declare class WebRTCAPI {
     private currentRoomId;
     private currentPeerId;
     private currentUserId;
-    private isBroadcaster;
+    /** connect 가 요청한 방송자 역할 (switchRoom 이 이어받는다) */
+    private broadcasterRequested;
+    /** 서버가 정한 방송자 역할 (`joined` 의 is_broadcaster) */
+    private broadcasterGranted;
+    /** 비공개 룸 허용 목록 요청 (이 연결에서만 쓴다) */
+    private allowedMemberIds;
+    private privateRoom;
+    private warningListeners;
     private localStream;
     private channelType;
     private peerConnections;
@@ -11569,6 +11943,11 @@ declare class WebRTCAPI {
     private handleAnswer;
     private handleICECandidate;
     private closePeerConnection;
+    /**
+     * 서버 error 메시지의 data 에서 안내 문구를 꺼낸다. 대부분은 문자열이지만 할당량, 동시접속 초과는
+     * `{ error, message, ... }` 객체로 온다.
+     */
+    private static signalingErrorMessage;
     private sendSignaling;
     private handleDisconnect;
     private attemptReconnect;
@@ -11630,6 +12009,15 @@ declare class WebRTCAPI {
      * 현재 채널 타입 조회
      */
     getChannelType(): WebRTCMode;
+    /**
+     * 서버가 정한 방송자 역할인지 조회한다. 요청(`isBroadcaster: true`)과 다를 수 있다 — 익명 연결이나
+     * 채널의 방송자 역할이 없는 회원은 시청자로 참가한다(`onWarning` 으로 이유가 온다).
+     */
+    isBroadcaster(): boolean;
+    /**
+     * 지금 룸이 회원 허용 목록이 있는 비공개 룸인지 조회한다.
+     */
+    isPrivateRoom(): boolean;
     /**
      * 원격 스트림 조회
      */
@@ -11658,6 +12046,17 @@ declare class WebRTCAPI {
      * 에러 이벤트
      */
     onError(callback: (error: Error) => void): () => void;
+    /**
+     * 서버가 join 요청을 바꿨다는 알림 이벤트 (예: 방송자 요청을 시청자로 낮춤)
+     *
+     * @example
+     * ```typescript
+     * cb.webrtc.onWarning(({ code, message }) => {
+     *     if (code === 'broadcaster_role_required') showToast(message)
+     * })
+     * ```
+     */
+    onWarning(callback: (warning: WebRTCWarning) => void): () => void;
     /**
      * 피어 참가 이벤트
      */
@@ -11672,6 +12071,7 @@ declare class WebRTCAPI {
     onRemoteStream(callback: (peerId: string, stream: MediaStream) => void): () => void;
     private setState;
     private emitError;
+    private emitWarning;
     private emitPeerJoined;
     private emitPeerLeft;
     private emitRemoteStream;
@@ -12139,9 +12539,10 @@ declare class ConnectBase {
     /**
      * 현재 페이지가 앱이 직접 처리할 OAuth 콜백 페이지인지 판별.
      *
-     * `?code=...` (OAUTH_CODE_ONLY 흐름) 또는 OAuth 에러 응답 (`?error=...&state=...`) 패턴이면 true.
-     * 콜백 페이지에서 일반 `autoRestoreSession` 을 건너뛰어 rotation race 를 피한다. 토큰 콜백은
-     * 이미 주소에서 회수됐으므로 여기서 보지 않는다(`oauth.captureCallbackOnBoot`).
+     * `?code=...&state=...` 또는 OAuth 에러 응답 (`?error=...&state=...`) 패턴이면 true.
+     * 콜백 페이지에서 일반 `autoRestoreSession` 을 건너뛰어 rotation race 를 피한다. 토큰 콜백과 이
+     * 브라우저의 state 가 돌아온 code 콜백은 이미 주소에서 회수됐으므로 여기 오지 않는다
+     * (`oauth.captureCallbackOnBoot`).
      */
     private isOAuthCallbackUrl;
     /**
@@ -12167,4 +12568,4 @@ declare class ConnectBase {
     updateConfig(config: Partial<ConnectBaseConfig>): void;
 }
 
-export { AIAPI, type AIChatOptions, type AIChatRequest, type AIChatResponse, type AIChatStreamCallbacks, type AIChatStreamOptions, AIError, type AIErrorCode, type AIMessage, type AISource, type AIStreamChunk, type AITool, type AIToolCall, type AIToolEvent, AUTH_MEMBER_ID_TOKEN, type AcceptInvitationResponse, type AckMessagesRequest, type AdMobDailyReport, type AdMobReportResponse, type AdMobReportSummary, type AdReportResponse, type AdReportSummary, type AdmobConnectionInfo, AdsAPI, type AdsenseConnectionInfo, type AgenticSearchProgress, type AggregateResult, type AggregateStage, type AnalyticsConfig, type AnalyticsEvent, ApiError, type ApiErrorDetail, type AppMemberDetail, type AppMemberIdentityDetail, type AppMemberIdentitySummary, type AppMemberList, type AppMemberListItem, type AppMemberProviderType, AppMembersAPI, type AppStatsResponse, type ArchivePolicy, type AtomicOperator, type AtomicOperatorType, AuthError, type AuthSettingsResponse, type BackupInfo, type BatchOperation, type BatchOperationResult, type BatchSetPageMetaRequest, type BatchWriteResult, type BillingCycle, type BillingKeyResponse, type BiometricInfo, type BiometricResult, type BulkCreateResponse, type BulkError, type CPUInfo, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type ChangePlanPreview, type ChangePlanRequest, type Channel, type ChannelMembership, type ChannelStats, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type CompleteUploadRequest, type CompleteUploadResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type ConsentOptions, type ConsumeMessagesResponse, type ConsumeOptions, type CopyTableRequest, type CopyTableResponse, type CreateBackupRequest, type CreateChannelRequest, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreateColumnRequest, type CreateDataRequest, type CreateDocumentRequest, type CreateFolderRequest, type CreateFolderResponse, type CreateGeoIndexRequest, type CreateIndexRequest, type CreateInvitationRequest, type CreateInvitationResponse, type CreateLobbyRequest, type CreateOrganizationRequest, type CreatePlaylistRequest, type CreatePublicKeyRequest, type CreatePublicKeyResponse, type CreateRelationRequest, type CreateRolePayload, type CreateRoleResult, type CreateRoomResult, type CreateSearchIndexRequest, type CreateSecurityRuleRequest, type CreateSubscriptionRequest, type CreateTableRequest, type CreateTopicOptions, type CreateTriggerRequest, type CreateVideoStorageRequest, type DailyReport, type DataItem, type DataType, type DatabaseChange, type DatabaseChangeMessage, type DatabaseChangeType, type DatabaseRealtimeConnectOptions, type DatabaseRealtimeFilter, type DatabaseRealtimeHandlers, type DatabaseRealtimeSubscription, type DatabaseSnapshot, type DatabaseSnapshotMessage, type DatabaseSubscribeOptions, type DeleteBillingKeyResponse, type DeleteWhereResponse, type DeviceInfo, type DocumentResponse, type EnabledProviderInfo, type EnabledProvidersResponse, EndpointAPI, type EndpointCallInit, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type ExportDataRequest, type ExportDataResponse, type FetchDataResponse, type FetchFilesResponse, type FetchPublicKeysResponse, type FileItem, type FileStats, GameAPI, type GameAction, type GameClientConfig, type GameConfig, GameConfigAPI, type GameConfigPatch, type GameConnectionState, type GameConnectionStatus, type GameDelta, GameError, type GameErrorCode, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GenerateUploadURLByPathRequest, type GenerateUploadURLRequest, type GenerateUploadURLResponse, type GeoBoundingBox, type GeoIndex, type GeoNear, type GeoPoint, type GeoPolygon, type GeoQuery, type GeoResponse, type GeoResult, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type HistoryResponse, type ICEServer, type ICEServersResponse, type ImageResult, type ImportDataRequest, type ImportDataResponse, type IndexAnalysis, type IndexRecommendation, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinQueueRequest, type JoinRoomRequest, type JoinRoomResponse, type KnowledgeSearchRequest, type KnowledgeSearchResponse, type KnowledgeSearchResult, type LeaderboardEntry, type LeaderboardListResponse, type LeaderboardScoreEntry, type LifecyclePolicy, type ListAppMembersOptions, type ListBillingKeysResponse, type ListDocumentsResponse, type ListPageMetasOptions, type ListPageMetasResponse, type ListPaymentsOptions, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type LobbyInfo, type LobbyInvite, type LobbyMember, type LobbyVisibility, type MatchResult, type MatchmakingTicket, type MatchqueueListResponse, type MatchqueueTicket, type MemberChangePasswordRequest, type MemberCredentialMessageResponse, type MemberEmailVerificationConfirmRequest, type MemberEmailVerificationConfirmResponse, type MemberEmailVerificationRequest, type MemberInfoResponse, type MemberPasswordResetConfirmRequest, type MemberPasswordResetRequest, type MemberRedirectOption, type MemberSession, type MemberSessionList, type MemberSessionRevokeResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MemoryInfo, type MessageHandler, type MigrateDataRequest, type MigrateDataResponse, type MoveFileRequest, type NackMessageRequest, NativeAPI, type OAuthCallbackResponse, type OAuthProvider, type OnPaymentFailure, type OpenDialogOptions, type OpenDialogResult, type Organization, type OrganizationContext, type OrganizationInvitation, type OrganizationMember, type OrganizationMemberList, type OrganizationRole, OrganizationsAPI, type PageMetaResponse, type PartyInfo, type PartyInvite, type PartyMember, type PauseSubscriptionRequest, type PaymentDetail, type PaymentListItem, type PaymentListResult, type PaymentMode, type PaymentProvider, type PaymentStatus, type PeerInfo, type Platform, type PlayerEvent, type PlayerStats, type Playlist, type PlaylistItem, type PollUntilOptions, type PongMessage, type PopulateOption, type Position, type PostponeBillingRequest, type PreparePaymentRequest, type PreparePaymentResponse, type PresenceChangeHandler, type PresenceInfo, type PresenceSetOptions, type PresenceStatus, type PresenceStatusResult, type ProrationMode, type PublicKeyItem, type PublicKeyPaymentMode, type PublishBatchRequest, type PublishBatchResponse, type PublishMessageRequest, type PublishMessageResponse, type PushPlatform, type PushStatsResult, type PushTopicInfo, type QualityProgress, type QueryOptions, type QueueInfoResponse, type QueueMessage, type ReadReceiptHandler, type ReadReceiptInfo, type RealtimeConnectOptions, RealtimeConnectionError, type RealtimeConnectionErrorCode, type RealtimeMessage, RealtimeRequestError, type RealtimeSendPolicy, type RegisterDeviceRequest, type RelationType, type RenameFileRequest, type RenameFileResponse, type ReplayHighlight, type ReplayInfo, type ReplayPlayerInfo, type RestoreBackupRequest, type RestoreBackupResponse, type RetentionPolicy, type RoleDetail, type RoleList, type RoleListItem, type RolePermissionItem, type RoleUserItem, RolesAPI, type RoomInfo, type RoomStaleMessage, type RoomSummary, type RoomsResponse, type RotatePublicKeyRequest, type RotatePublicKeyResponse, type SaveDialogOptions, type SaveDialogResult, type ScriptDetailResponse, type ScriptListResponse, type ScriptLogEntry, type ScriptLogsResponse, type ScriptMeta, type ScriptMetricsResponse, type ScriptVersion, type ScriptVersionListResponse, type SearchIndex, type SearchOptions, type SearchResponse, type SearchResult, type SecurityRule, type SendOptions, type SendSuperChatOptions, type SendSuperChatResponse, type ServerMessage, SessionManager, type SetPageMetaRequest, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type SlowQueryInfo, type SpectatorInfo, type SpectatorPlayerState, type SpectatorState, type SpeechRecognizeOptions, type SpeechResult, type StateChange, type StateChangeHandler, type StorageUploadOptions, type StorageUploadProgress, type StreamContentPart, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamImageURLPart, type StreamMessage, type StreamOptions, type StreamSession, type StreamTextPart, type StreamTokenCallback, type StreamToolCallCallback, type StreamToolResultCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type SuperChatType, type SyncLostMessage, type SystemInfo, type TTLConfig, type TableAccessLevel, type TableColumnDef, type TableIndex, type TableRelation, type TableSchema, type TableSchemaDefinition, type TokenPersistence, type TransactionRead, type TransactionResult, type TransactionWrite, type TransactionWriteResult, type TranscodeStatus, type TransportType, type Trigger, type TriggerEvent, type TriggerHandlerType, type TypingChangeHandler, type TypingInfo, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateCustomDataRequest, type UpdateCustomDataResponse, type UpdateDataRequest, type UpdateDocumentRequest, type UpdateLobbyRequest, type UpdateOrganizationRequest, type UpdatePublicKeyRequest, type UpdatePublicKeyResponse, type UpdateRolePayload, type UpdateSecurityRuleRequest, type UpdateSubscriptionRequest, type UpdateTriggerRequest, type UpdateVideoRequest, type UpdateVideoStorageRequest, type UploadByPathOptions, type UploadFileOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type ValidateResponse, type ValidationSchema, type ValidationSchemaField, type ValidationStateTransitions, type Video, type VideoComment, type VideoCompleteUploadResponse, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoStorage, type VideoStorageAccessLevel, type VideoStorageListResponse, type VideoVisibility, type VoiceChannel, type VoiceMember, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WhereCondition, type WhereOperator, ConnectBase as default, detectInAppBrowser, escapeToExternalBrowser, isWebTransportSupported, toAIError, toCreateRoomWire };
+export { AIAPI, type AIChatOptions, type AIChatRequest, type AIChatResponse, type AIChatStreamCallbacks, type AIChatStreamOptions, AIError, type AIErrorCode, type AIMessage, type AISource, type AIStreamChunk, type AITool, type AIToolCall, type AIToolEvent, AUTH_MEMBER_ID_TOKEN, type AcceptInvitationResponse, type AckMessagesRequest, type AdMobDailyReport, type AdMobReportResponse, type AdMobReportSummary, type AdReportResponse, type AdReportSummary, type AdmobConnectionInfo, AdsAPI, type AdsenseConnectionInfo, type AgenticSearchProgress, type AggregateResult, type AggregateStage, type AnalyticsConfig, type AnalyticsEvent, ApiError, type ApiErrorDetail, type AppMemberDetail, type AppMemberIdentityDetail, type AppMemberIdentitySummary, type AppMemberList, type AppMemberListItem, type AppMemberProviderType, AppMembersAPI, type AppStatsResponse, type ArchivePolicy, type AtomicOperator, type AtomicOperatorType, AuthError, type AuthSettingsResponse, type BackupInfo, type BatchOperation, type BatchOperationResult, type BatchSetPageMetaRequest, type BatchWriteResult, type BillingCycle, type BillingKeyResponse, type BiometricInfo, type BiometricResult, type BulkCreateResponse, type BulkError, type CPUInfo, type CancelPaymentRequest, type CancelPaymentResponse, type CancelSubscriptionRequest, type CategoryInfo, type ChangePlanOptions, type ChangePlanPreview, type ChangePlanRequest, type ChangePlanWithPriceRef, type ChangePlanWithProduct, type Channel, type ChannelMembership, type ChannelStats, type ChargeWithBillingKeyAmount, type ChargeWithBillingKeyOptions, type ChargeWithBillingKeyProduct, type ChargeWithBillingKeyRequest, type ChargeWithBillingKeyResponse, type ChatMessage, type ClientMessage, type ColumnSchema, type CommentListResponse, type CompleteUploadRequest, type CompleteUploadResponse, type ConfirmBillingKeyRequest, type ConfirmPaymentRequest, type ConfirmPaymentResponse, ConnectBase, type ConnectBaseConfig, type ConnectedData, type ConnectionState, type ConsentOptions, type ConsumeMessagesResponse, type ConsumeOptions, type CopyTableRequest, type CopyTableResponse, type CreateBackupRequest, type CreateChannelRequest, type CreateCheckoutSessionOptions, type CreateCheckoutSessionRequest, type CreateCheckoutSessionResponse, type CreateCheckoutSessionWithAmount, type CreateCheckoutSessionWithProduct, type CreateColumnRequest, type CreateDataRequest, type CreateDocumentRequest, type CreateFolderRequest, type CreateFolderResponse, type CreateGeoIndexRequest, type CreateIndexRequest, type CreateInvitationRequest, type CreateInvitationResponse, type CreateLobbyRequest, type CreateOrganizationRequest, type CreatePlaylistRequest, type CreatePublicKeyRequest, type CreatePublicKeyResponse, type CreateRelationRequest, type CreateRolePayload, type CreateRoleResult, type CreateRoomResult, type CreateSearchIndexRequest, type CreateSecurityRuleRequest, type CreateSubscriptionOptions, type CreateSubscriptionRequest, type CreateSubscriptionWithAmount, type CreateSubscriptionWithProduct, type CreateTableRequest, type CreateTopicOptions, type CreateTriggerRequest, type CreateVideoStorageRequest, type DailyReport, type DataItem, type DataType, type DatabaseChange, type DatabaseChangeMessage, type DatabaseChangeType, type DatabaseRealtimeConnectOptions, type DatabaseRealtimeFilter, type DatabaseRealtimeHandlers, type DatabaseRealtimeSubscription, type DatabaseSnapshot, type DatabaseSnapshotMessage, type DatabaseSubscribeOptions, type DeleteBillingKeyResponse, type DeleteWhereResponse, type DeviceInfo, type DocumentResponse, type EnabledProviderInfo, type EnabledProvidersResponse, EndpointAPI, type EndpointCallInit, type ErrorHandler, type ErrorMessage, type ErrorReport, type ErrorTrackerConfig, type ErrorType, type ExportDataRequest, type ExportDataResponse, type FetchDataResponse, type FetchFilesResponse, type FetchPublicKeysResponse, type FileItem, type FileStats, GameAPI, type GameAction, type GameClientConfig, type GameConfig, GameConfigAPI, type GameConfigPatch, type GameConnectionState, type GameConnectionStatus, type GameDelta, GameError, type GameErrorCode, type GameEventHandlers, type GamePlayer, GameRoom, type GameRoomConfig, type GameRoomInfo, GameRoomTransport, type GameServerMessage, type GameServerMessageType, type GameState, type GameTransportConfig, type GenerateUploadURLByPathRequest, type GenerateUploadURLRequest, type GenerateUploadURLResponse, type GeoBoundingBox, type GeoIndex, type GeoNear, type GeoPoint, type GeoPolygon, type GeoQuery, type GeoResponse, type GeoResult, type GetAuthorizationURLResponse, type GetFileByPathResponse, type GoogleConnectionStatus, type HistoryResponse, type ICEServer, type ICEServersResponse, type ImageResult, type ImportDataRequest, type ImportDataResponse, type IndexAnalysis, type IndexRecommendation, type InitUploadResponse, type InvokeFunctionRequest, type InvokeFunctionResponse, type IssueBillingKeyRequest, type IssueBillingKeyResponse, type JoinQueueRequest, type JoinRoomRequest, type JoinRoomResponse, type KnowledgeSearchRequest, type KnowledgeSearchResponse, type KnowledgeSearchResult, type LeaderboardEntry, type LeaderboardListResponse, type LeaderboardScoreEntry, type LifecyclePolicy, type ListAppMembersOptions, type ListBillingKeysResponse, type ListDocumentsResponse, type ListPageMetasOptions, type ListPageMetasResponse, type ListPaymentsOptions, type ListSubscriptionPaymentsRequest, type ListSubscriptionPaymentsResponse, type ListSubscriptionsRequest, type ListSubscriptionsResponse, type LobbyInfo, type LobbyInvite, type LobbyMember, type LobbyVisibility, type MatchResult, type MatchmakingTicket, type MatchqueueListResponse, type MatchqueueTicket, type MemberChangePasswordRequest, type MemberCredentialMessageResponse, type MemberEmailVerificationConfirmRequest, type MemberEmailVerificationConfirmResponse, type MemberEmailVerificationRequest, type MemberInfoResponse, type MemberPasswordResetConfirmRequest, type MemberPasswordResetRequest, type MemberRedirectOption, type MemberSession, type MemberSessionList, type MemberSessionRevokeResponse, type MemberSignInRequest, type MemberSignInResponse, type MemberSignUpRequest, type MemberSignUpResponse, type MembershipTier, type MemoryInfo, type MessageHandler, type MigrateDataRequest, type MigrateDataResponse, type MoveFileRequest, type NackMessageRequest, NativeAPI, type OAuthCallbackResponse, type OAuthProvider, type OnPaymentFailure, type OpenDialogOptions, type OpenDialogResult, type Organization, type OrganizationContext, type OrganizationInvitation, type OrganizationMember, type OrganizationMemberList, type OrganizationRole, OrganizationsAPI, type PageMetaResponse, type PartyInfo, type PartyInvite, type PartyMember, type PauseSubscriptionRequest, type PaymentDetail, type PaymentListItem, type PaymentListResult, type PaymentMode, type PaymentProvider, type PaymentStatus, type PeerInfo, type Platform, type PlayerEvent, type PlayerStats, type Playlist, type PlaylistItem, type PollUntilOptions, type PongMessage, type PopulateOption, type Position, type PostponeBillingRequest, type PreparePaymentOptions, type PreparePaymentRequest, type PreparePaymentResponse, type PreparePaymentWithAmount, type PreparePaymentWithProduct, type PresenceChangeHandler, type PresenceInfo, type PresenceSetOptions, type PresenceStatus, type PresenceStatusResult, type ProrationMode, type PublicKeyItem, type PublicKeyPaymentMode, type PublishBatchRequest, type PublishBatchResponse, type PublishMessageRequest, type PublishMessageResponse, type PushPlatform, type PushStatsResult, type PushTopicInfo, type QualityProgress, type QueryOptions, type QueueInfoResponse, type QueueMessage, type ReadReceiptHandler, type ReadReceiptInfo, type RealtimeConnectOptions, RealtimeConnectionError, type RealtimeConnectionErrorCode, type RealtimeMessage, RealtimeRequestError, type RealtimeSendPolicy, type RegisterDeviceRequest, type RelationType, type RenameFileRequest, type RenameFileResponse, type ReplayHighlight, type ReplayInfo, type ReplayPlayerInfo, type RestoreBackupRequest, type RestoreBackupResponse, type RetentionPolicy, type RoleDetail, type RoleList, type RoleListItem, type RolePermissionItem, type RoleUserItem, RolesAPI, type RoomInfo, type RoomStaleMessage, type RoomSummary, type RoomsResponse, type RotatePublicKeyRequest, type RotatePublicKeyResponse, type SaveDialogOptions, type SaveDialogResult, type ScriptDetailResponse, type ScriptListResponse, type ScriptLogEntry, type ScriptLogsResponse, type ScriptMeta, type ScriptMetricsResponse, type ScriptVersion, type ScriptVersionListResponse, type SearchIndex, type SearchOptions, type SearchResponse, type SearchResult, type SecurityRule, type SendOptions, type SendSuperChatOptions, type SendSuperChatResponse, type ServerMessage, SessionManager, type SetPageMetaRequest, type Shorts, type ShortsListResponse, type SignalingMessage, type SignalingMessageType, type SlowQueryInfo, type SpectatorInfo, type SpectatorPlayerState, type SpectatorState, type SpeechRecognizeOptions, type SpeechResult, type StateChange, type StateChangeHandler, type StorageUploadOptions, type StorageUploadProgress, type StreamContentPart, type StreamDoneCallback, type StreamDoneData, type StreamErrorCallback, type StreamHandlers, type StreamImageURLPart, type StreamMessage, type StreamOptions, type StreamSession, type StreamTextPart, type StreamTokenCallback, type StreamToolCallCallback, type StreamToolResultCallback, type StreamURLResponse, type SubscribeOptions, type SubscribeTopicRequest, type SubscribedData, type Subscription, type SubscriptionPaymentResponse, type SubscriptionPaymentStatus, type SubscriptionResponse, type SubscriptionStatus, type SuperChat, type SuperChatType, type SuspendAppMemberOptions, type SuspendAppMemberResult, type SyncLostMessage, type SystemInfo, type TTLConfig, type TableAccessLevel, type TableColumnDef, type TableIndex, type TableRelation, type TableSchema, type TableSchemaDefinition, type TokenPersistence, type TransactionRead, type TransactionResult, type TransactionWrite, type TransactionWriteResult, type TranscodeStatus, type TransportType, type Trigger, type TriggerEvent, type TriggerHandlerType, type TypingChangeHandler, type TypingInfo, type UnsuspendAppMemberResult, type UpdateBillingKeyRequest, type UpdateChannelRequest, type UpdateColumnRequest, type UpdateCustomDataRequest, type UpdateCustomDataResponse, type UpdateDataRequest, type UpdateDocumentRequest, type UpdateLobbyRequest, type UpdateOrganizationRequest, type UpdatePublicKeyRequest, type UpdatePublicKeyResponse, type UpdateRolePayload, type UpdateSecurityRuleRequest, type UpdateSubscriptionRequest, type UpdateTriggerRequest, type UpdateVideoRequest, type UpdateVideoStorageRequest, type UploadByPathOptions, type UploadFileOptions, type UploadFileResponse, type UploadOptions, type UploadProgress, type VAPIDPublicKeyResponse, type ValidateResponse, type ValidationSchema, type ValidationSchemaField, type ValidationStateTransitions, type Video, type VideoComment, type VideoCompleteUploadResponse, type VideoListOptions, type VideoListResponse, VideoProcessingError, type VideoQuality, type VideoStatus, type VideoStorage, type VideoStorageAccessLevel, type VideoStorageListResponse, type VideoVisibility, type VoiceChannel, type VoiceMember, type WaitOptions, type WatchHistoryItem, type WebPushSubscription, type WebRTCConnectOptions, type WebRTCConnectionState, type WebRTCMode, type WebRTCWarning, type WhereCondition, type WhereOperator, ConnectBase as default, detectInAppBrowser, escapeToExternalBrowser, isWebTransportSupported, toAIError, toCreateRoomWire };