@series-inc/rundot-game-sdk 5.20.0 → 5.21.0-beta.1

package/dist/{AdsApi-CGUqUO3N.d.ts → AdsApi-DEYh-DVp.d.ts}

@@ -927,7 +927,7 @@ interface LifecycleApi {
      *
      * Use this to navigate back within your game's own UI or show an exit
      * confirmation. If you want the host to perform its default quit behavior,
-     * call `RundotGameAPI.navigation.requestPopOrQuit()` from within the callback.
+     * call `RundotGameAPI.requestPopOrQuit()` from within the callback.
      *
      * On platforms without a hardware back button (iOS, web), this event never fires,
      * but registering a handler is safe and acts as a no-op.
@@ -1333,24 +1333,33 @@ interface StartRoomGameOptions {
     turnOrder?: string[] | null;
 }
 interface RoomsApi {
+    /** @deprecated Rooms V1 is unsupported. Use `RundotGameAPI.realtime.createRoom(roomType)`. */
     createRoomAsync(options: CreateRoomOptions): Promise<RundotGameRoom>;
+    /** @deprecated Rooms V1 is unsupported. Use `RundotGameAPI.realtime.joinOrCreateRoom(roomType)`. */
     joinOrCreateRoomAsync(options: JoinOrCreateRoomOptions): Promise<JoinOrCreateResult>;
+    /** @deprecated Rooms V1 is unsupported. Use `RundotGameAPI.realtime.joinRoomByCode(code)`. */
     joinRoomByCodeAsync(roomCode: string): Promise<RundotGameRoom>;
+    /** @deprecated Rooms V1 is unsupported. No realtime equivalent yet (planned, Track B). */
     getUserRoomsAsync(options?: ListRoomsOptions): Promise<RundotGameRoom[]>;
+    /** @deprecated Rooms V1 is unsupported. Use `room.on()` on a `RundotGameAPI.realtime` room. */
     subscribeAsync(room: RundotGameRoom, options?: RoomSubscriptionOptions): Promise<() => void>;
-    /**
-     * @deprecated Prefer server-authoritative flows (e.g. `proposeMoveAsync` / `startRoomGameAsync`)
-     * and treat `customMetadata.rules.gameState` as the canonical room lifecycle state.
-     */
+    /** @deprecated Rooms V1 is unsupported. Hold state in your realtime `GameRoom` class. */
     updateRoomDataAsync(room: RundotGameRoom, updates: Record<string, unknown>, options?: UpdateRoomDataOptions): Promise<void>;
+    /** @deprecated Rooms V1 is unsupported. Hold state in your realtime `GameRoom` class. */
     getRoomDataAsync(room: RundotGameRoom): Promise<Record<string, unknown>>;
+    /** @deprecated Rooms V1 is unsupported. Use `room.send()` on a `RundotGameAPI.realtime` room. */
     sendRoomMessageAsync(room: RundotGameRoom, message: RoomMessageRequest): Promise<string>;
+    /** @deprecated Rooms V1 is unsupported. Use `room.leave()` on a `RundotGameAPI.realtime` room. */
     leaveRoomAsync(room: RundotGameRoom): Promise<void>;
+    /** @deprecated Rooms V1 is unsupported. Use `this.kick()` in your realtime `GameRoom` class. */
     kickPlayerAsync(room: RundotGameRoom, targetProfileId: string, options?: {
         reason?: string;
     }): Promise<void>;
+    /** @deprecated Rooms V1 is unsupported. Drive lifecycle in your realtime `GameRoom` class. */
     startRoomGameAsync(room: RundotGameRoom, options?: StartRoomGameOptions): Promise<void>;
+    /** @deprecated Rooms V1 is unsupported. Handle moves in `onGameMessage()` in your realtime `GameRoom` class. */
     proposeMoveAsync(room: RundotGameRoom, request: ProposeMoveRequest): Promise<ProposeMoveResult>;
+    /** @deprecated Rooms V1 is unsupported. Handle moves in `onGameMessage()` in your realtime `GameRoom` class. */
     validateMoveAsync(room: RundotGameRoom, moveId: string, verdict: ValidateMoveVerdict): Promise<ValidateMoveResult>;
 }
 
@@ -1549,7 +1558,7 @@ interface LoggingApi {
 }
 
 interface SharedAssetsApi {
-    loadAssetsBundle(game: string, bundleKey: string): Promise<ArrayBuffer>;
+    loadAssetsBundle(game: string, bundleKey: string, fileType?: string): Promise<ArrayBuffer>;
 }
 
 declare class RpcSharedAssetsApi implements SharedAssetsApi {
@@ -1676,6 +1685,8 @@ interface UgcEntry {
         at: number;
     };
     reportCount?: number;
+    isPlatformVisible?: boolean;
+    thumbnailUrl?: string;
 }
 interface UgcCreateParams {
     contentType: string;
@@ -1683,6 +1694,8 @@ interface UgcCreateParams {
     isPublic?: boolean;
     title?: string;
     tags?: string[];
+    isPlatformVisible?: boolean;
+    thumbnailUrl?: string;
 }
 interface UgcUpdateParams {
     id: string;
@@ -1690,6 +1703,8 @@ interface UgcUpdateParams {
     isPublic?: boolean;
     title?: string;
     tags?: string[];
+    isPlatformVisible?: boolean;
+    thumbnailUrl?: string;
 }
 interface UgcListParams {
     contentType?: string;
@@ -1735,6 +1750,8 @@ interface UgcCrossAppCreateParams {
     isPublic?: boolean;
     title?: string;
     tags?: string[];
+    isPlatformVisible?: boolean;
+    thumbnailUrl?: string;
 }
 interface UgcListResponse {
     entries: UgcEntry[];
@@ -1878,6 +1895,19 @@ interface UgcVotingApi {
      */
     getWinners(params?: UgcVoteWinnersListParams): Promise<UgcVoteWinnersResponse>;
 }
+interface UgcRecommendationResponse {
+    recommId: string;
+    entries: Array<UgcEntry & {
+        isLikedByMe?: boolean;
+    }>;
+}
+interface UgcCompositeRecommendationResponse {
+    recommId: string;
+    sourceEntry: UgcEntry | null;
+    entries: Array<UgcEntry & {
+        isLikedByMe?: boolean;
+    }>;
+}
 interface UgcApi {
     /**
      * Create new user-generated content
@@ -2041,6 +2071,14 @@ interface UgcApi {
      * @returns The created entry
      */
     crossAppCreate(params: UgcCrossAppCreateParams): Promise<UgcEntry>;
+    getUserRecommendation(count: number, filter?: string): Promise<UgcRecommendationResponse>;
+    getItemRecommendation(ugcId: string, count: number, filter?: string): Promise<UgcRecommendationResponse>;
+    getCompositeRecommendation(count: number, sourceFilter?: string, resultFilter?: string): Promise<UgcCompositeRecommendationResponse>;
+    getMoreRecommendations(origRecommId: string, count: number): Promise<UgcRecommendationResponse>;
+    addDetailView(ugcId: string, recommId?: string): Promise<void>;
+    addRating(ugcId: string, rating: number, recommId?: string): Promise<void>;
+    addCartAddition(ugcId: string, recommId?: string): Promise<void>;
+    setViewPortion(ugcId: string, portion: number, recommId?: string): Promise<void>;
     /**
      * Weekly voting API. Vote on UGC entries within the current ISO week,
      * read live leaderboards, and read paginated historical winners.
@@ -2253,6 +2291,14 @@ interface UploadResult {
     uploadHeaders: Record<string, string>;
     key: string;
     expiresAt: number;
+    /**
+     * Present only when overwriting an existing file. Pass it straight back to
+     * `confirmUpload(key, { uploadToken })` so the server can atomically resolve
+     * concurrent overwrites of the same key (the matching confirm wins; a
+     * superseded one is rejected). The previous version keeps serving until the
+     * matching confirm commits — reads are never interrupted by an overwrite.
+     */
+    uploadToken?: string;
 }
 interface ListParams {
     prefix?: string;
@@ -2434,6 +2480,13 @@ interface ArchiveExtractResult {
 }
 interface ConfirmUploadOptions {
     clientRef?: string;
+    /** The `uploadToken` returned by `upload()` for an overwrite. Required to confirm an overwrite. */
+    uploadToken?: string;
+}
+interface BatchConfirmOptions {
+    clientRef?: string;
+    /** Per-key `uploadToken`s returned by `batchUpload()` for overwrites, keyed by file key. */
+    uploadTokens?: Record<string, string>;
 }
 interface BatchUploadParams {
     files: Array<{
@@ -2479,7 +2532,7 @@ interface FilesApi {
     upload(params: UploadParams): Promise<UploadResult>;
     confirmUpload(key: string, options?: ConfirmUploadOptions): Promise<FileEntry>;
     batchUpload(params: BatchUploadParams): Promise<BatchUploadResult>;
-    batchConfirm(keys: string[], options?: ConfirmUploadOptions): Promise<BatchConfirmResult>;
+    batchConfirm(keys: string[], options?: BatchConfirmOptions): Promise<BatchConfirmResult>;
     getUrl(params: GetUrlParams): Promise<string>;
     getUrls(params: GetUrlsParams): Promise<GetUrlsResult>;
     getMetadata(params: GetMetadataParams): Promise<FileEntry>;
@@ -2940,6 +2993,25 @@ interface AdminGenApi<TEntry, TReport> {
     resolveReport(reportId: string, action: AdminGenResolveAction): Promise<void>;
 }
 
+type LaunchIntentKind = 'share' | 'deeplink' | 'notification' | 'none' | 'timed_out';
+interface LaunchIntent {
+    kind: LaunchIntentKind;
+    /** Present for kind === 'share'. */
+    shareLinkId?: string;
+    /** Sharer's profile id, when launched from a share. */
+    sharerId?: string;
+    /** Flat string params (share / deeplink / notification payload). */
+    params: Record<string, string>;
+}
+interface ResolveLaunchIntentOptions {
+    /**
+     * How long (ms) the caller is willing to wait for the host to resolve the
+     * launch signal before resolving `{ kind: 'timed_out' }`. Omit for the
+     * platform default. Clamped host-side to a ceiling; `0` means do not wait.
+     */
+    maxWaitMs?: number;
+}
+
 type AppRole = 'owner' | 'editor' | 'none';
 interface AdminUgcBrowseParams {
     contentType?: string | string[];
@@ -3151,6 +3223,17 @@ type AdminThreeDGenListReportsResponse = AdminGenListReportsResponse<ThreeDGenRe
 type AdminThreeDGenResolveAction = AdminGenResolveAction;
 interface AppApi {
     getMyRole(): Promise<AppRole>;
+    /**
+     * Resolve how this game was launched (share / deep link / notification /
+     * none). Resolves as soon as the host has resolved the launch route; if that
+     * hasn't happened yet, waits up to `options.maxWaitMs` (platform-clamped)
+     * then resolves `{ kind: 'timed_out' }`. `timed_out` is not terminal — call
+     * again to keep waiting; once settled the result is returned immediately.
+     * Like every RPC, the promise can still reject on transport-level failures
+     * (host too old to support this message, or RPC timeout) — distinct from a
+     * `timed_out` launch intent.
+     */
+    resolveLaunchIntent(options?: ResolveLaunchIntentOptions): Promise<LaunchIntent>;
     readonly adminUgc: AdminUgcApi;
     readonly adminImageGen: AdminImageGenApi;
     readonly adminVideoGen: AdminVideoGenApi;
@@ -3217,10 +3300,28 @@ interface InitializationContext {
      */
     safeArea?: SafeArea;
     initializeAsleep: boolean;
+    /**
+     * @deprecated Use RundotGameAPI.app.resolveLaunchIntent() instead. This is
+     * the legacy INIT-snapshot read path and cannot represent a deferred deep
+     * link. Will be removed in v6.0.0.
+     */
     launchParams?: Record<string, string>;
+    /**
+     * @deprecated Use RundotGameAPI.app.resolveLaunchIntent() instead. This is
+     * the legacy INIT-snapshot read path and cannot represent a deferred share
+     * link. Will be removed in v6.0.0.
+     */
     shareParams?: Record<string, string>;
+    /**
+     * @deprecated Use RundotGameAPI.app.resolveLaunchIntent() instead. Will be
+     * removed in v6.0.0.
+     */
     notificationParams?: Record<string, string>;
-    /** The share document ID when launched from a share link; `undefined` otherwise. */
+    /**
+     * The share document ID when launched from a share link; `undefined` otherwise.
+     * @deprecated Use RundotGameAPI.app.resolveLaunchIntent() instead. Will be
+     * removed in v6.0.0.
+     */
     shareLinkId?: string;
     /** Data passed from a source game via game-to-game navigation (forward). */
     g2gLaunch?: Record<string, any>;
@@ -3248,6 +3349,7 @@ interface Host {
     readonly features: FeaturesApi;
     readonly lifecycle: LifecycleApi;
     readonly simulation: SimulationApi;
+    /** @deprecated Rooms V1 is unsupported. Use `RundotGameAPI.realtime` (server-authoritative WebSocket rooms). */
     readonly rooms: RoomsApi;
     readonly logging: LoggingApi;
     readonly leaderboard: LeaderboardApi;
@@ -3272,6 +3374,22 @@ interface Host {
     readonly iap: IapApi;
     readonly instanceId: string;
     readonly context?: InitializationContext;
+    /**
+     * Subscribe to host-pushed updates to `context.notificationParams`. Fires
+     * when the user taps a notification for an already-running game. Returns
+     * an unsubscribe function. Optional: hosts that pre-date this push path
+     * (cold-launch only) may not implement it.
+     */
+    onNotificationParamsUpdate?(callback: (params: Record<string, string>) => void): () => void;
+    /**
+     * Fire-and-forget ACK the SDK sends to the host immediately after it
+     * registers the `onNotificationParamsUpdate` subscription. Lets the host
+     * tell "SDK booted past READY" apart from "SDK has a live notification
+     * subscriber" — the latter is the precise signal for "a live push WILL be
+     * received". Optional: Mock / Sandbox hosts have no remote peer and so
+     * don't implement it.
+     */
+    notifyNotificationParamsSubscribeReady?(): void;
     initialize(options?: InitializationOptions): Promise<InitializationContext>;
 }
 /**
@@ -3720,6 +3838,7 @@ interface RundotGameAPI {
         launchContext?: Record<string, any>;
         returnContext?: Record<string, any>;
     }): Promise<void>;
+    /** @deprecated Rooms V1 is unsupported. Use `RundotGameAPI.realtime` (server-authoritative WebSocket rooms). */
     rooms: RoomsApi;
     realtime: MultiplayerApi;
     notifyCleanupComplete(): void;
@@ -3763,6 +3882,11 @@ interface RundotGameAPI {
     video: VideoApi;
     app: AppApi;
     attribution: AttributionApi;
+    /**
+     * The launch context from INIT_SDK. Its intent fields (`launchParams`,
+     * `shareParams`, `notificationParams`, `shareLinkId`) are `@deprecated` —
+     * use `app.resolveLaunchIntent()` instead. Will be removed in v6.0.0.
+     */
     context: InitializationContext;
 }
 
@@ -3781,4 +3905,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type AddToHomeScreenResult as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type ScheduleNotificationOptions as E, type RCSAvailabilityStatus as F, type ScheduleRCSInput as G, type Host as H, type ScheduleRCSResult as I, type RequestRCSOptInInput as J, type RequestRCSOptInResult as K, type PopupsApi as L, type ShowToastOptions as M, type NavigationApi as N, type ShowInterstitialAdOptions as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type ShowRewardedAdOptions as T, type ProfileApi as U, type DeviceApi as V, type DeviceInfo as W, type EnvironmentApi as X, type EnvironmentInfo as Y, type SystemApi as Z, type SafeArea as _, type RecipeRequirementQuery as a, type LoggingApi as a$, type CdnApi as a0, type FetchFromCdnOptions as a1, type AssetUrlResult as a2, type TimeApi as a3, type ServerTimeData as a4, type GetFutureTimeOptions as a5, type AiApi as a6, type AiChatCompletionRequest as a7, type AiChatCompletionData as a8, type AiChatCompletionStreamOptions as a9, type ResetStateOptions as aA, type ResetStateResult as aB, type GetActiveRunsOptions as aC, type ExecuteScopedRecipeOptions as aD, type ExecuteScopedRecipeResult as aE, type GetAvailableRecipesOptions as aF, type GetAvailableRecipesResult as aG, type Recipe as aH, type GetBatchRecipeRequirements as aI, type TriggerRecipeChainOptions as aJ, type RoomDataUpdate as aK, type RoomMessageEvent as aL, type ProposedMoveEvent as aM, RundotGameTransport as aN, type RoomsApi as aO, type CreateRoomOptions as aP, type JoinOrCreateRoomOptions as aQ, type JoinOrCreateResult as aR, type ListRoomsOptions as aS, type UpdateRoomDataOptions as aT, type RoomMessageRequest as aU, type StartRoomGameOptions as aV, type ProposeMoveRequest as aW, type ProposeMoveResult as aX, type ValidateMoveVerdict as aY, type ValidateMoveResult as aZ, type RoomSubscriptionOptions as a_, type AiChatCompletionStreamChunk as aa, type HapticsApi as ab, HapticFeedbackStyle as ac, type FeaturesApi as ad, type Experiment as ae, type LifecycleApi as af, type SleepCallback as ag, type Subscription as ah, type AwakeCallback as ai, type PauseCallback as aj, type ResumeCallback as ak, type QuitCallback as al, type BackButtonCallback as am, type SimulationApi as an, type SimulationSlotValidationResult as ao, type SimulationBatchOperation as ap, type SimulationBatchOperationsResult as aq, type SimulationAvailableItem as ar, type SimulationPowerPreview as as, type SimulationSlotMutationResult as at, type SimulationSlotContainer as au, type SimulationAssignment as av, type SimulationState as aw, type ExecuteRecipeOptions as ax, type ExecuteRecipeResponse as ay, type CollectRecipeResult as az, type RecipeRequirementResult as b, type AdsApi as b$, type IapApi as b0, type SpendCurrencyOptions as b1, type SpendCurrencyResult as b2, type SubscriptionTier as b3, type RunSubscriptionsResponse as b4, type SubscriptionInterval as b5, type PurchaseSubscriptionResponse as b6, type OpenStoreResult as b7, type LoadEmbeddedAssetsResponse as b8, type SharedAssetsApi as b9, type AdminImageGenApi as bA, type AdminVideoGenApi as bB, type AdminSpriteGenApi as bC, type AdminAudioGenApi as bD, type AdminThreeDGenApi as bE, type AppRole as bF, type AdminUgcBrowseParams as bG, type AdminUgcBrowseResponse as bH, type AdminUgcListReportsParams as bI, type AdminUgcListReportsResponse as bJ, type AdminUgcResolveAction as bK, type AdminGenBrowseParams as bL, type AdminGenBrowseResponse as bM, type ImageGenEntry as bN, type AdminGenListReportsParams as bO, type AdminGenListReportsResponse as bP, type ImageGenReport as bQ, type AdminGenResolveAction as bR, type SpriteGenEntry as bS, type SpriteGenReport as bT, type ThreeDGenEntry as bU, type ThreeDGenReport as bV, type Avatar3dApi as bW, type AssetManifest as bX, type Avatar3dConfig as bY, type ShowEditorOptions as bZ, type Avatar3dEdits as b_, type PreloaderApi as ba, type SocialApi as bb, type ShareMetadata as bc, type ShareLinkResult as bd, type SocialQRCodeOptions as be, type QRCodeResult as bf, type ShareClickData as bg, type ShareFileOptions as bh, type ShareFileResult as bi, type CanShareFileResult as bj, type EntitlementApi as bk, type Entitlement as bl, type LedgerEntry as bm, type ShopApi as bn, type StorefrontResponse as bo, type StorefrontItem as bp, type ShopPurchaseResponse as bq, type ShopOrderHistoryResponse as br, type PromptLoginResult as bs, type AccessTier as bt, type AccessGateApi as bu, type TextGenApi as bv, type UgcApi as bw, type VideoApi as bx, type AppApi as by, type AdminUgcApi as bz, type RundotGameAvailableRecipe as c, type JoinRoomMatchCriteria as c$, type SharedStorageHostApi as c0, type FilesApi as c1, type ClipsApi as c2, type MultiplayerApi as c3, type AttributionApi as c4, type InitializationContext as c5, type InitializationOptions as c6, type CaptureConsent as c7, type StartClipRecordingOptions as c8, type ClipBlob as c9, type AdminVideoGenListReportsResponse as cA, type AdminVideoGenResolveAction as cB, type AiContentBlock as cC, type AiImageContent as cD, type AiImageUrlContent as cE, type AiMessage as cF, type AiResponseFormat as cG, type AiTextContent as cH, type AiToolResultContent as cI, type AiToolUseContent as cJ, type Asset as cK, type AudioGenEntry as cL, type AudioGenReport as cM, CLIP_CONTENT_TYPE as cN, type Category as cO, type ClipAudioOptions as cP, type ClipCameraOptions as cQ, type ClipPipLayout as cR, type ClipPipPosition as cS, type ConnectionState as cT, type GetSubscriptionsForTierRequest as cU, type HudInsets as cV, type InboundForKeyEntry as cW, type InboundMethodIds as cX, type InboundStorageApi as cY, type IsPlayerSubscribedRequest as cZ, type JoinOrCreateRoomEnvelopeResponse as c_, type ClipsSupport as ca, type ClipPersistOptions as cb, type ClipResult as cc, type UgcEntry as cd, type CaptureConsentStatus as ce, AccessDeniedError as cf, type AdminGenApi as cg, type AdminImageGenBrowseParams as ch, type AdminImageGenBrowseResponse as ci, type AdminImageGenListReportsParams as cj, type AdminImageGenListReportsResponse as ck, type AdminImageGenResolveAction as cl, type AdminSpriteGenBrowseParams as cm, type AdminSpriteGenBrowseResponse as cn, type AdminSpriteGenListReportsParams as co, type AdminSpriteGenListReportsResponse as cp, type AdminSpriteGenResolveAction as cq, type AdminThreeDGenBrowseParams as cr, type AdminThreeDGenBrowseResponse as cs, type AdminThreeDGenListReportsParams as ct, type AdminThreeDGenListReportsResponse as cu, type AdminThreeDGenResolveAction as cv, type AdminUgcEntry as cw, type AdminVideoGenBrowseParams as cx, type AdminVideoGenBrowseResponse as cy, type AdminVideoGenListReportsParams as cz, type RundotGameCollectRecipeResult as d, type LoadEmbeddedAssetsRequest as d0, MockAvatarApi as d1, type NotificationTriggerInput as d2, type OnNotificationCallback as d3, type OnRequestCallback as d4, type OnResponseCallback as d5, type ProposedMovePayload as d6, type Protocol as d7, type PurchaseSubscriptionRequest as d8, type RCSAvailabilityReason as d9, type SimulationBatchOperationRemove as dA, type SimulationBatchOperationResult as dB, type SimulationPersonalState as dC, type SimulationRoomActiveRecipe as dD, type SimulationRoomState as dE, type StorefrontCollection as dF, type StorefrontCollectionItem as dG, type SubPath as dH, type Tool as dI, type ToolChoice as dJ, type ToolUse as dK, type TimeIntervalTriggerInput as dL, type UgcReport as dM, type VideoGenEntry as dN, type VideoGenReport as dO, createHost as dP, resolveCollectionItemPrice as dQ, type RCSOptInStatus as da, ROOM_GAME_PHASES as db, type RecipeInfo as dc, type RoomEnvelopeResponse as dd, type RoomEvents as de, type RoomGamePhase as df, type RoomMessageEventType as dg, type RoomMessagePayload as dh, type RoomsEnvelopeResponse as di, RpcInboundStorageApi as dj, RpcSharedAssetsApi as dk, type RpcTransport as dl, type RunSubscription as dm, type RundotGameRoomCustomMetadata as dn, type RundotGameRoomPayload as dp, type RundotGameRoomRules as dq, type RundotGameRoomRulesGameState as dr, SHARE_FILE_ALLOWED_MIME_TYPES as ds, SHARE_FILE_MAX_SIZE_BYTES as dt, type ScheduleRCSStatus as du, type ServerPlayer as dv, type ServerRoom as dw, type ShareFileMimeType as dx, type ShopOrder as dy, type SimulationBatchOperationAssign as dz, type RundotGameExecuteRecipeOptions as e, type RundotGameExecuteRecipeResult as f, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };
+export { type AddToHomeScreenResult as $, type AnalyticsApi as A, type BatchRecipeRequirementsResult as B, type NotificationsApi as C, type ScheduleLocalNotification as D, type ScheduleNotificationOptions as E, type RCSAvailabilityStatus as F, type ScheduleRCSInput as G, type Host as H, type ScheduleRCSResult as I, type RequestRCSOptInInput as J, type RequestRCSOptInResult as K, type PopupsApi as L, type ShowToastOptions as M, type NavigationApi as N, type ShowInterstitialAdOptions as O, type Profile as P, type QuitOptions as Q, type RundotGameAPI as R, type SimulationActiveRunsUpdate as S, type ShowRewardedAdOptions as T, type ProfileApi as U, type DeviceApi as V, type DeviceInfo as W, type EnvironmentApi as X, type EnvironmentInfo as Y, type SystemApi as Z, type SafeArea as _, type RecipeRequirementQuery as a, type LoggingApi as a$, type CdnApi as a0, type FetchFromCdnOptions as a1, type AssetUrlResult as a2, type TimeApi as a3, type ServerTimeData as a4, type GetFutureTimeOptions as a5, type AiApi as a6, type AiChatCompletionRequest as a7, type AiChatCompletionData as a8, type AiChatCompletionStreamOptions as a9, type ResetStateOptions as aA, type ResetStateResult as aB, type GetActiveRunsOptions as aC, type ExecuteScopedRecipeOptions as aD, type ExecuteScopedRecipeResult as aE, type GetAvailableRecipesOptions as aF, type GetAvailableRecipesResult as aG, type Recipe as aH, type GetBatchRecipeRequirements as aI, type TriggerRecipeChainOptions as aJ, type RoomDataUpdate as aK, type RoomMessageEvent as aL, type ProposedMoveEvent as aM, RundotGameTransport as aN, type RoomsApi as aO, type CreateRoomOptions as aP, type JoinOrCreateRoomOptions as aQ, type JoinOrCreateResult as aR, type ListRoomsOptions as aS, type UpdateRoomDataOptions as aT, type RoomMessageRequest as aU, type StartRoomGameOptions as aV, type ProposeMoveRequest as aW, type ProposeMoveResult as aX, type ValidateMoveVerdict as aY, type ValidateMoveResult as aZ, type RoomSubscriptionOptions as a_, type AiChatCompletionStreamChunk as aa, type HapticsApi as ab, HapticFeedbackStyle as ac, type FeaturesApi as ad, type Experiment as ae, type LifecycleApi as af, type SleepCallback as ag, type Subscription as ah, type AwakeCallback as ai, type PauseCallback as aj, type ResumeCallback as ak, type QuitCallback as al, type BackButtonCallback as am, type SimulationApi as an, type SimulationSlotValidationResult as ao, type SimulationBatchOperation as ap, type SimulationBatchOperationsResult as aq, type SimulationAvailableItem as ar, type SimulationPowerPreview as as, type SimulationSlotMutationResult as at, type SimulationSlotContainer as au, type SimulationAssignment as av, type SimulationState as aw, type ExecuteRecipeOptions as ax, type ExecuteRecipeResponse as ay, type CollectRecipeResult as az, type RecipeRequirementResult as b, type Avatar3dConfig as b$, type IapApi as b0, type SpendCurrencyOptions as b1, type SpendCurrencyResult as b2, type SubscriptionTier as b3, type RunSubscriptionsResponse as b4, type SubscriptionInterval as b5, type PurchaseSubscriptionResponse as b6, type OpenStoreResult as b7, type LoadEmbeddedAssetsResponse as b8, type SharedAssetsApi as b9, type AdminUgcApi as bA, type AdminImageGenApi as bB, type AdminVideoGenApi as bC, type AdminSpriteGenApi as bD, type AdminAudioGenApi as bE, type AdminThreeDGenApi as bF, type AppRole as bG, type ResolveLaunchIntentOptions as bH, type LaunchIntent as bI, type AdminUgcBrowseParams as bJ, type AdminUgcBrowseResponse as bK, type AdminUgcListReportsParams as bL, type AdminUgcListReportsResponse as bM, type AdminUgcResolveAction as bN, type AdminGenBrowseParams as bO, type AdminGenBrowseResponse as bP, type ImageGenEntry as bQ, type AdminGenListReportsParams as bR, type AdminGenListReportsResponse as bS, type ImageGenReport as bT, type AdminGenResolveAction as bU, type SpriteGenEntry as bV, type SpriteGenReport as bW, type ThreeDGenEntry as bX, type ThreeDGenReport as bY, type Avatar3dApi as bZ, type AssetManifest as b_, type PreloaderApi as ba, type SocialApi as bb, type ShareMetadata as bc, type ShareLinkResult as bd, type SocialQRCodeOptions as be, type QRCodeResult as bf, type ShareClickData as bg, type ShareFileOptions as bh, type ShareFileResult as bi, type CanShareFileResult as bj, type EntitlementApi as bk, type Entitlement as bl, type LedgerEntry as bm, type ShopApi as bn, type StorefrontResponse as bo, type StorefrontItem as bp, type ShopPurchaseResponse as bq, type ShopOrderHistoryResponse as br, type PromptLoginResult as bs, type AccessTier as bt, type AccessGateApi as bu, type TextGenApi as bv, type UgcApi as bw, type MultiplayerApi as bx, type VideoApi as by, type AppApi as bz, type RundotGameAvailableRecipe as c, type IsPlayerSubscribedRequest as c$, type ShowEditorOptions as c0, type Avatar3dEdits as c1, type AdsApi as c2, type SharedStorageHostApi as c3, type FilesApi as c4, type ClipsApi as c5, type AttributionApi as c6, type InitializationContext as c7, type InitializationOptions as c8, type CaptureConsent as c9, type AdminVideoGenBrowseResponse as cA, type AdminVideoGenListReportsParams as cB, type AdminVideoGenListReportsResponse as cC, type AdminVideoGenResolveAction as cD, type AiContentBlock as cE, type AiImageContent as cF, type AiImageUrlContent as cG, type AiMessage as cH, type AiResponseFormat as cI, type AiTextContent as cJ, type AiToolResultContent as cK, type AiToolUseContent as cL, type Asset as cM, type AudioGenEntry as cN, type AudioGenReport as cO, CLIP_CONTENT_TYPE as cP, type Category as cQ, type ClipAudioOptions as cR, type ClipCameraOptions as cS, type ClipPipLayout as cT, type ClipPipPosition as cU, type ConnectionState as cV, type GetSubscriptionsForTierRequest as cW, type HudInsets as cX, type InboundForKeyEntry as cY, type InboundMethodIds as cZ, type InboundStorageApi as c_, type StartClipRecordingOptions as ca, type ClipBlob as cb, type ClipsSupport as cc, type ClipPersistOptions as cd, type ClipResult as ce, type UgcEntry as cf, type CaptureConsentStatus as cg, AccessDeniedError as ch, type AdminGenApi as ci, type AdminImageGenBrowseParams as cj, type AdminImageGenBrowseResponse as ck, type AdminImageGenListReportsParams as cl, type AdminImageGenListReportsResponse as cm, type AdminImageGenResolveAction as cn, type AdminSpriteGenBrowseParams as co, type AdminSpriteGenBrowseResponse as cp, type AdminSpriteGenListReportsParams as cq, type AdminSpriteGenListReportsResponse as cr, type AdminSpriteGenResolveAction as cs, type AdminThreeDGenBrowseParams as ct, type AdminThreeDGenBrowseResponse as cu, type AdminThreeDGenListReportsParams as cv, type AdminThreeDGenListReportsResponse as cw, type AdminThreeDGenResolveAction as cx, type AdminUgcEntry as cy, type AdminVideoGenBrowseParams as cz, type RundotGameCollectRecipeResult as d, type JoinOrCreateRoomEnvelopeResponse as d0, type JoinRoomMatchCriteria as d1, type LaunchIntentKind as d2, type LoadEmbeddedAssetsRequest as d3, MockAvatarApi as d4, type NotificationTriggerInput as d5, type OnNotificationCallback as d6, type OnRequestCallback as d7, type OnResponseCallback as d8, type ProposedMovePayload as d9, type ShareFileMimeType as dA, type ShopOrder as dB, type SimulationBatchOperationAssign as dC, type SimulationBatchOperationRemove as dD, type SimulationBatchOperationResult as dE, type SimulationPersonalState as dF, type SimulationRoomActiveRecipe as dG, type SimulationRoomState as dH, type StorefrontCollection as dI, type StorefrontCollectionItem as dJ, type SubPath as dK, type Tool as dL, type ToolChoice as dM, type ToolUse as dN, type TimeIntervalTriggerInput as dO, type UgcReport as dP, type VideoGenEntry as dQ, type VideoGenReport as dR, createHost as dS, resolveCollectionItemPrice as dT, type Protocol as da, type PurchaseSubscriptionRequest as db, type RCSAvailabilityReason as dc, type RCSOptInStatus as dd, ROOM_GAME_PHASES as de, type RecipeInfo as df, type RoomEnvelopeResponse as dg, type RoomEvents as dh, type RoomGamePhase as di, type RoomMessageEventType as dj, type RoomMessagePayload as dk, type RoomsEnvelopeResponse as dl, RpcInboundStorageApi as dm, RpcSharedAssetsApi as dn, type RpcTransport as dp, type RunSubscription as dq, type RundotGameRoomCustomMetadata as dr, type RundotGameRoomPayload as ds, type RundotGameRoomRules as dt, type RundotGameRoomRulesGameState as du, SHARE_FILE_ALLOWED_MIME_TYPES as dv, SHARE_FILE_MAX_SIZE_BYTES as dw, type ScheduleRCSStatus as dx, type ServerPlayer as dy, type ServerRoom as dz, type RundotGameExecuteRecipeOptions as e, type RundotGameExecuteRecipeResult as f, type RundotGameExecuteScopedRecipeOptions as g, RundotGameRoom as h, type RundotGameSimulationConfig as i, type RundotGameSimulationEffect as j, type RundotGameSimulationRecipe as k, type RundotGameSimulationStateResponse as l, type SimulationEntityUpdate as m, type SimulationRunSummary as n, type SimulationSnapshotUpdate as o, type SimulationSubscribeOptions as p, type SimulationUpdateData as q, type SimulationUpdateType as r, type RpcRequest as s, type RpcResponse as t, type RpcNotification as u, RpcClient as v, type StorageApi as w, type NavigationStackInfo as x, type PushAppOptions as y, type NavigateToGameOptions as z };

package/dist/{chunk-BXGNMZKL.js → chunk-KOTB6NEL.js}

@@ -65,6 +65,8 @@ var RundotGameMessageId = /* @__PURE__ */ ((RundotGameMessageId2) => {
   RundotGameMessageId2["H5_STACK_PUSH_REQUEST"] = "H5_STACK_PUSH_REQUEST";
   RundotGameMessageId2["H5_STACK_POP_REQUEST"] = "H5_STACK_POP_REQUEST";
   RundotGameMessageId2["H5_NAVIGATE_TO_GAME"] = "H5_NAVIGATE_TO_GAME";
+  RundotGameMessageId2["NOTIFICATION_PARAMS_UPDATE"] = "NOTIFICATION_PARAMS_UPDATE";
+  RundotGameMessageId2["NOTIFICATION_PARAMS_SUBSCRIBE_READY"] = "NOTIFICATION_PARAMS_SUBSCRIBE_READY";
   RundotGameMessageId2["SCHEDULE_LOCAL_NOTIFICATION"] = "H5_SCHEDULE_LOCAL_NOTIFICATION";
   RundotGameMessageId2["CANCEL_LOCAL_NOTIFICATION"] = "H5_CANCEL_LOCAL_NOTIFICATION";
   RundotGameMessageId2["GET_ALL_SCHEDULED_LOCAL_NOTIFICATIONS"] = "H5_GET_ALL_SCHEDULED_LOCAL_NOTIFICATIONS";
@@ -199,6 +201,14 @@ var RundotGameMessageId = /* @__PURE__ */ ((RundotGameMessageId2) => {
   RundotGameMessageId2["H5_UGC_CROSS_APP_GET_MANY"] = "H5_UGC_CROSS_APP_GET_MANY";
   RundotGameMessageId2["H5_UGC_CROSS_APP_COUNT"] = "H5_UGC_CROSS_APP_COUNT";
   RundotGameMessageId2["H5_UGC_CROSS_APP_CREATE"] = "H5_UGC_CROSS_APP_CREATE";
+  RundotGameMessageId2["H5_UGC_GET_USER_RECOMMENDATION"] = "H5_UGC_GET_USER_RECOMMENDATION";
+  RundotGameMessageId2["H5_UGC_GET_ITEM_RECOMMENDATION"] = "H5_UGC_GET_ITEM_RECOMMENDATION";
+  RundotGameMessageId2["H5_UGC_GET_COMPOSITE_RECOMMENDATION"] = "H5_UGC_GET_COMPOSITE_RECOMMENDATION";
+  RundotGameMessageId2["H5_UGC_GET_MORE_RECOMMENDATIONS"] = "H5_UGC_GET_MORE_RECOMMENDATIONS";
+  RundotGameMessageId2["H5_UGC_ADD_DETAIL_VIEW"] = "H5_UGC_ADD_DETAIL_VIEW";
+  RundotGameMessageId2["H5_UGC_ADD_RATING"] = "H5_UGC_ADD_RATING";
+  RundotGameMessageId2["H5_UGC_ADD_CART_ADDITION"] = "H5_UGC_ADD_CART_ADDITION";
+  RundotGameMessageId2["H5_UGC_SET_VIEW_PORTION"] = "H5_UGC_SET_VIEW_PORTION";
   RundotGameMessageId2["CLIPS_GET_CAPTURE_CONSENT"] = "H5_CLIPS_GET_CAPTURE_CONSENT";
   RundotGameMessageId2["CLIPS_REQUEST_CAPTURE_CONSENT"] = "H5_CLIPS_REQUEST_CAPTURE_CONSENT";
   RundotGameMessageId2["CLIPS_SET_CAPTURE_CONSENT"] = "H5_CLIPS_SET_CAPTURE_CONSENT";
@@ -251,6 +261,7 @@ var RundotGameMessageId = /* @__PURE__ */ ((RundotGameMessageId2) => {
   RundotGameMessageId2["H5_CDN_REFRESH_ENTITLEMENTS"] = "H5_CDN_REFRESH_ENTITLEMENTS";
   RundotGameMessageId2["H5_APP_GET_MY_ROLE"] = "H5_APP_GET_MY_ROLE";
   RundotGameMessageId2["H5_GET_ATTRIBUTION_PARAMS"] = "H5_GET_ATTRIBUTION_PARAMS";
+  RundotGameMessageId2["H5_RESOLVE_LAUNCH_INTENT"] = "H5_RESOLVE_LAUNCH_INTENT";
   RundotGameMessageId2["H5_APP_ADMIN_UGC_BROWSE"] = "H5_APP_ADMIN_UGC_BROWSE";
   RundotGameMessageId2["H5_APP_ADMIN_UGC_REMOVE_ENTRY"] = "H5_APP_ADMIN_UGC_REMOVE_ENTRY";
   RundotGameMessageId2["H5_APP_ADMIN_UGC_LIST_REPORTS"] = "H5_APP_ADMIN_UGC_LIST_REPORTS";
@@ -2548,10 +2559,7 @@ var RpcRoomsApi = class {
     }
     return rundotGameRooms;
   }
-  /**
-   * @deprecated Prefer server-authoritative flows (e.g. `proposeMoveAsync` / `startRoomGameAsync`)
-   * and treat `customMetadata.rules.gameState` as the canonical room lifecycle state.
-   */
+  /** @deprecated Rooms V1 is unsupported. Hold state in your realtime `GameRoom` class. */
   async updateRoomDataAsync(room, updates, options = {}) {
     await this.rpcClient.call(
       "H5_ROOM_UPDATE_DATA" /* H5_ROOM_UPDATE_DATA */,
@@ -2719,11 +2727,29 @@ var RpcRoomsApi = class {
 };
 
 // src/rooms/index.ts
-function bindMethod(target, targetKey, source, sourceKey) {
+var ROOMS_DEPRECATION_REPLACEMENTS = {
+  createRoomAsync: "RundotGameAPI.realtime.createRoom(roomType)",
+  joinOrCreateRoomAsync: "RundotGameAPI.realtime.joinOrCreateRoom(roomType)",
+  joinRoomByCodeAsync: "RundotGameAPI.realtime.joinRoomByCode(code)",
+  getUserRoomsAsync: "no realtime equivalent yet (planned, Track B)",
+  subscribeAsync: "room.on() on a RundotGameAPI.realtime room",
+  sendRoomMessageAsync: "room.send() on a RundotGameAPI.realtime room",
+  leaveRoomAsync: "room.leave() on a RundotGameAPI.realtime room",
+  updateRoomDataAsync: "server-authoritative state in your realtime GameRoom class",
+  getRoomDataAsync: "server-authoritative state in your realtime GameRoom class",
+  kickPlayerAsync: "this.kick() in your realtime GameRoom class",
+  startRoomGameAsync: "lifecycle logic in your realtime GameRoom class",
+  proposeMoveAsync: "onGameMessage() handling in your realtime GameRoom class",
+  validateMoveAsync: "onGameMessage() handling in your realtime GameRoom class"
+};
+function bindMethod(target, targetKey, source, warn, sourceKey) {
   const key = sourceKey ?? targetKey;
   const fn = source?.[key];
   if (typeof fn === "function") {
-    target[targetKey] = fn.bind(source);
+    target[targetKey] = (...args) => {
+      warn(targetKey);
+      return fn.apply(source, args);
+    };
     return true;
   }
   return false;
@@ -2736,6 +2762,15 @@ function initializeRoomsApi(rundotGameApi, host) {
     );
     return;
   }
+  const warned = /* @__PURE__ */ new Set();
+  const warnDeprecated = (method) => {
+    if (warned.has(method)) return;
+    warned.add(method);
+    const replacement = ROOMS_DEPRECATION_REPLACEMENTS[method] ?? "RundotGameAPI.realtime";
+    console.warn(
+      `[RUN] DEPRECATED: RundotGameAPI.rooms.${method}() is deprecated and unsupported. Realtime (RundotGameAPI.realtime) is the only supported multiplayer API \u2014 use ${replacement}. See the Multiplayer docs for the migration guide.`
+    );
+  };
   const rundotGame = rundotGameApi;
   const existingNamespace = rundotGame.rooms || {};
   const roomsNamespace = Object.assign({}, existingNamespace);
@@ -2755,7 +2790,7 @@ function initializeRoomsApi(rundotGameApi, host) {
     ["validateMoveAsync"]
   ];
   namespaceBindings.forEach(([targetKey, sourceKey]) => {
-    bindMethod(roomsNamespace, targetKey, roomsApi, sourceKey);
+    bindMethod(roomsNamespace, targetKey, roomsApi, warnDeprecated, sourceKey);
   });
   rundotGame.rooms = roomsNamespace;
 }
@@ -4373,6 +4408,12 @@ function applyAccessGates(host) {
     "authenticated_18plus",
     gateConfig
   );
+  host.multiplayer = createAccessGatedApi(
+    host.multiplayer,
+    ["createRoom", "joinOrCreateRoom", "joinRoomByCode"],
+    "authenticated_18plus",
+    gateConfig
+  );
 }
 
 // src/access-gate/RpcAccessGateApi.ts
@@ -5311,6 +5352,9 @@ var HttpAppApi = class {
     const data = await response.json();
     return data.role;
   }
+  async resolveLaunchIntent(_options) {
+    return { kind: "none", params: {} };
+  }
 };
 
 // src/app/SandboxAppApi.ts
@@ -5389,6 +5433,9 @@ var SandboxAppApi = class {
     }
     return "none";
   }
+  async resolveLaunchIntent(_options) {
+    return { kind: "none", params: {} };
+  }
 };
 
 // src/attribution/RpcAttributionApi.ts
@@ -6657,5 +6704,5 @@ var MockMultiplayerApi = class {
 };
 
 export { AccessDeniedError, BaseCdnApi, BrowserCaptureConsent, CLIP_CONTENT_TYPE, ClipRecorder, ClipsApiImpl, DEFAULT_SHARED_LIB_CDN_BASE, DualEmitStorageApi, EMBEDDED_LIBRARIES, EMBEDDED_LIBRARY_BY_KEY, FILE_EXTENSION_PATTERN, HapticFeedbackStyle, HostCdnApi, HostDeviceApi, HostEnvironmentApi, HostProfileApi, HostSystemApi, HostTimeApi, MIN_CDN_PATH_SEGMENTS, MODULE_TO_LIBRARY_SPECIFIERS, MockAccessGateApi, MockAdminUgcApi, MockAdsApi, MockAnalyticsApi, MockAttributionApi, MockAvatarApi, MockCdnApi, MockDebug, MockDeviceApi, MockEntitlementApi, MockEnvironmentApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLifecycleApi, MockLoggingApi, MockMultiplayerApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockPreloaderApi, MockProfileApi, MockSharedAssetsApi, MockShopApi, MockStorageApi, MockSystemApi, MockTimeApi, MockVideoApi, PER_APP_SUBDOMAIN_HOST_PATTERN, ROOM_GAME_PHASES, RpcAccessGateApi, RpcAdsApi, RpcAnalyticsApi, RpcAttributionApi, RpcAvatarApi, RpcEntitlementApi, RpcFeaturesApi, RpcHapticsApi, RpcInboundStorageApi, RpcLifecycleApi, RpcLoggingApi, RpcNavigationApi, RpcNotificationsApi, RpcPopupsApi, RpcPreloaderApi, RpcRoomsApi, RpcSharedAssetsApi, RpcShopApi, RpcStorageApi, RpcVideoApi, RundotGameMessageId, RundotGameRoom, SHARE_FILE_ALLOWED_MIME_TYPES, SHARE_FILE_MAX_SIZE_BYTES, SandboxAppApi, SandboxProfileApi, WsMultiplayerApi, applyAccessGates, base64ToArrayBuffer, base64ToUtf8, buildFunctionsBaseUrl, createAccessGatedApi, createMockAdminGenApi, createMockStorageApi, createRpcAdminGenApi, exchangeForCustomToken, generateId, getCloudRunUrl, getFirebaseClient, getLibraryDefinition, getSandboxConfig, hasHostedUrlStructure, initializeAccessGate, initializeAds, initializeAnalytics, initializeAttribution, initializeAvatar3d, initializeCdn, initializeEntitlements, initializeFeaturesApi, initializeHaptics, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializePreloader, initializeProfile, initializeRoomsApi, initializeShop, initializeStackNavigation, initializeStorage, initializeSystem, initializeTime, initializeVideo, isPacificDaylightTime, isPerAppSubdomain, isSandboxEnabled, mockLog, observeFirestoreCollection, observeFirestoreDocument, parseCdnLocationFromUrl, parseCdnLocationFromWindow, parseCdnPathSegments, resolveCollectionItemPrice, setStoredAppRole, setupRoomNotifications, signInWithGoogle };
-//# sourceMappingURL=chunk-BXGNMZKL.js.map
-//# sourceMappingURL=chunk-BXGNMZKL.js.map
+//# sourceMappingURL=chunk-KOTB6NEL.js.map
+//# sourceMappingURL=chunk-KOTB6NEL.js.map