connectbase-client 6.11.0 → 6.12.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` 서버 모드용).
+     * 콜백 URL 의 1회용 `code` 를 토큰으로 교환합니다.
      *
-     * 서버가 `OAUTH_CODE_ONLY=true` 모드면 리다이렉트 URL 에 토큰 대신 `code` 만 포함됩니다.
-     * 이 메서드는 code 를 `POST /v1/auth/oauth/exchange` 로 교환하고 토큰을 자동 저장합니다.
-     *
-     * 권장 호출 순서:
-     *   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 에 출력.
@@ -12139,9 +12395,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 +12424,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 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 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 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 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 WhereCondition, type WhereOperator, ConnectBase as default, detectInAppBrowser, escapeToExternalBrowser, isWebTransportSupported, toAIError, toCreateRoomWire };