@series-inc/venus-sdk 2.6.2 → 3.0.0

package/dist/{AdsApi-C_GcWmfO.d.mts → AdsApi-3DEYUUuj.d.mts}

@@ -61,6 +61,21 @@ declare class RpcClient {
     private handleRpcNotification;
 }
 
+interface StorageApi {
+    key(index: number): Promise<string | null>;
+    clear(): Promise<void>;
+    length(): Promise<number>;
+    getAllItems(): Promise<string[]>;
+    setMultipleItems(items: {
+        key: string;
+        value: string;
+    }[]): Promise<void>;
+    removeMultipleItems(keys: string[]): Promise<void>;
+    setItem(key: string, item: string): Promise<void>;
+    getItem(key: string): Promise<string | null>;
+    removeItem(key: string): Promise<void>;
+}
+
 interface NavigationStackInfo {
     isInStack: boolean;
     stackPosition: number;
@@ -92,9 +107,6 @@ type TimeIntervalTriggerInput = {
 };
 type NotificationTriggerInput = TimeIntervalTriggerInput | null;
 interface ScheduleNotificationOptions {
-    title: string;
-    body: string;
-    trigger: NotificationTriggerInput;
     priority?: number;
     groupId?: string;
     payload?: Record<string, any>;
@@ -107,7 +119,7 @@ interface ScheduleLocalNotification {
     trigger?: NotificationTriggerInput;
 }
 interface NotificationsApi {
-    scheduleAsync(options: ScheduleNotificationOptions): Promise<string | null>;
+    scheduleAsync(title: string, body: string, seconds: number, notificationId?: string, options?: ScheduleNotificationOptions): Promise<string | null>;
     cancelNotification(notificationId: string): Promise<boolean>;
     getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
     isLocalNotificationsEnabled(): Promise<boolean>;
@@ -146,6 +158,10 @@ interface ShowActionSheetOptions {
     disableCancel?: boolean;
 }
 
+interface ProfileApi {
+    getCurrentProfile(): Profile;
+}
+
 type SubPath = string;
 interface FetchBlobOptions {
     timeout?: number;
@@ -159,6 +175,57 @@ interface CdnApi {
     fetchBlob(path: SubPath, options?: FetchBlobOptions): Promise<Blob>;
 }
 
+interface ServerTimeData {
+    serverTime: number;
+    localTime: number;
+    timezoneOffset: number;
+    formattedTime: string;
+    locale: string;
+}
+interface GetFutureTimeOptions {
+    days?: number;
+    hours?: number;
+    minutes?: number;
+    timeOfDay?: {
+        hour: number;
+        minute: number;
+        second: number;
+    };
+    timezone?: any;
+}
+interface TimeApi {
+    requestTimeAsync(): Promise<ServerTimeData>;
+    formatTime(timestamp: number, options?: any): string;
+    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
+    getFutureTimeAsync(options?: GetFutureTimeOptions): Promise<number>;
+}
+
+interface PostInfo {
+    isLiked: boolean;
+    isFollowing: boolean;
+    likesCount: number;
+    commentsCount: number;
+}
+interface ToggleLikeResult {
+    isLiked: boolean;
+    likesCount: number;
+    action: 'liked' | 'unliked';
+}
+interface ToggleFollowResult {
+    isFollowing: boolean;
+    action: 'followed' | 'unfollowed';
+}
+interface OpenCommentsResult {
+    opened: boolean;
+    commentsCount: number;
+}
+interface PostApi {
+    getPostInfo(): Promise<PostInfo>;
+    toggleLikeAsync(): Promise<ToggleLikeResult>;
+    openCommentsAsync(): Promise<OpenCommentsResult>;
+    toggleFollowAsync(): Promise<ToggleFollowResult>;
+}
+
 interface AiMessage {
     /**
      * Depends on the model you are using. Most common is user, system, and assistant.
@@ -232,44 +299,146 @@ interface HapticsApi {
     triggerHapticAsync(style: HapticFeedbackStyle): Promise<void>;
 }
 
-interface Insets {
-    top: number;
-    right: number;
-    bottom: number;
-    left: number;
+interface Experiment {
+    readonly name: string;
+    readonly ruleID: string;
+    readonly value: Record<string, unknown>;
+    readonly groupName: string | null;
 }
-interface PostInfo {
-    postId: string;
-    config: null;
-    isLiked: boolean;
-    isFollowing: boolean;
-    likesCount: number;
-    commentsCount: number;
+interface FeaturesApi {
+    getExperiment(experimentName: string): Promise<Experiment | null>;
+    getFeatureFlag(flagName: string): Promise<boolean>;
+    getFeatureGate(gateName: string): Promise<boolean>;
 }
-interface PlayContext {
-    hudInsets: Insets;
-    postData?: PostInfo;
-    format: 'post';
-}
-type OnPlayCallback = (context: PlayContext) => void;
-type OnPauseCallback = () => void;
-type OnResumeCallback = () => void;
-type OnQuitCallback = () => void;
-type OnHideCallback = () => void;
-interface ShowContext {
-    hudInsets: Insets;
-    postData?: PostInfo;
-}
-type OnShowCallback = (context: ShowContext) => void;
-type OnCleanupCallback = () => void;
+
+type AwakeCallback = () => void;
+type SleepCallback = () => void;
+type ResumeCallback = () => void;
+type PauseCallback = () => void;
+type QuitCallback = () => void;
 interface LifecycleApi {
-    onPlay(callback: OnPlayCallback): void;
-    onPause(callback: OnPauseCallback): void;
-    onResume(callback: OnResumeCallback): void;
-    onQuit(callback: OnQuitCallback): void;
-    onHide(callback: OnHideCallback): void;
-    onShow(callback: OnShowCallback): void;
-    onCleanup(callback: OnCleanupCallback): void;
+    /**
+     * Registers a callback for when the game transitions from "idle" to "active" state.
+     *
+     * This occurs when the game comes to the foreground. Use this to load heavy resources
+     * or resume activities that were paused during sleep.
+     *
+     * @param callback - Function to execute when the game awakens
+     * @returns Subscription object that can be used to unsubscribe from the event
+     */
+    onAwake(callback: AwakeCallback): Subscription;
+    /**
+     * Registers a callback for when the game transitions from "active" to "idle" state.
+     *
+     * This occurs when the game goes to the background. Use this to unload heavy resources,
+     * save state, or pause non-essential activities.
+     *
+     * @param callback - Function to execute when the game goes to sleep
+     * @returns Subscription object that can be used to unsubscribe from the event
+     */
+    onSleep(callback: SleepCallback): Subscription;
+    /**
+     * Registers a callback for when gameplay should resume.
+     *
+     * This occurs when the platform dismisses dialogs or overlays, or when players
+     * return from a temporary switch. Use this to resume game logic and animations.
+     *
+     * @param callback - Function to execute when gameplay resumes
+     * @returns Subscription object that can be used to unsubscribe from the event
+     */
+    onResume(callback: ResumeCallback): Subscription;
+    /**
+     * Registers a callback for when gameplay should pause.
+     *
+     * This occurs when the platform brings up dialogs or overlays, or when players
+     * temporarily switch away. Use this to pause game logic and animations.
+     *
+     * @param callback - Function to execute when gameplay pauses
+     * @returns Subscription object that can be used to unsubscribe from the event
+     */
+    onPause(callback: PauseCallback): Subscription;
+    /**
+     * Registers a callback for final teardown before the game instance is destroyed.
+     *
+     * This is the last chance to clean up resources, save state, and perform any
+     * necessary cleanup before the game instance is destroyed or replaced.
+     *
+     * @param callback - Function to execute during cleanup
+     * @returns Subscription object that can be used to unsubscribe from the event
+     */
+    onQuit(callback: QuitCallback): Subscription;
+}
+
+interface ExecuteRecipeOptions {
+    roomId?: string;
+    batchAmount?: number;
+    allowPartialBatch?: boolean;
+    entity?: string;
+}
+interface GetActiveRunsOptions {
+    roomId?: string;
+}
+interface ExecuteScopedRecipeOptions {
+    roomId?: string;
+}
+interface GetAvailableRecipesOptions {
+    roomId?: string;
+    includeActorRecipes?: boolean;
+}
+interface Recipe {
+    recipeId: string;
+    entity?: string;
+    batchAmount?: number;
+}
+interface TriggerRecipeChainOptions {
+    roomId?: string;
+    context?: any;
+}
+interface CollectRecipeResult {
+    success: boolean;
+    runId: string;
+    rewards: any;
+    message: string;
+}
+interface ExecuteScopedRecipeResult {
+    success: boolean;
+    message: string;
+}
+interface RecipeInfo {
+    id: string;
+    scope: string;
+    clientViewable: boolean;
+}
+interface GetAvailableRecipesResult {
+    success: boolean;
+    recipes: RecipeInfo[];
+}
+interface GetBatchRecipeRequirements {
+    success: boolean;
+    results: RecipeRequirementResult[];
+}
+interface SimulationApi {
+    getStateAsync(roomId?: string): Promise<any>;
+    getConfigAsync(roomId?: string): Promise<VenusSimulationConfig>;
+    executeRecipeAsync(recipeId: string, inputs?: any, options?: ExecuteRecipeOptions): Promise<any>;
+    getActiveRunsAsync(options?: GetActiveRunsOptions): Promise<any>;
+    collectRecipeAsync(runId: string): Promise<CollectRecipeResult>;
+    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: any, options?: ExecuteScopedRecipeOptions | any): Promise<ExecuteScopedRecipeResult>;
+    triggerRecipeChainAsync(recipeId: string, options?: TriggerRecipeChainOptions): Promise<any>;
+    getAvailableRecipesAsync(options?: GetAvailableRecipesOptions): Promise<GetAvailableRecipesResult>;
+    getRecipeRequirementsAsync(recipe: Recipe): Promise<RecipeRequirementResult>;
+    getBatchRecipeRequirementsAsync(recipes: Recipe[]): Promise<GetBatchRecipeRequirements>;
+    resolveFieldValueAsync(entityId: string, fieldPath: string, entity?: string): Promise<any>;
+    getEntityMetadataAsync(entityId: string): Promise<any>;
+    getSlotContainersAsync(): Promise<any>;
+    getSlotAssignmentsAsync(containerId: string): Promise<any>;
+    assignItemToSlotAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
+    removeItemFromSlotAsync(containerId: string, slotId: string): Promise<any>;
+    getAvailableItemsAsync(containerId: string, slotId: string): Promise<Array<any>>;
+    calculatePowerPreviewAsync(containerId: string, slotId: string, candidateItemId: string): Promise<any>;
+    validateSlotAssignmentAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
+    executeBatchOperationsAsync(operations: Array<any>, validateOnly?: boolean): Promise<any>;
+    sumContributions(contributions: Record<string, any>): Record<string, number>;
 }
 
 interface VenusMessage {
@@ -385,6 +554,63 @@ declare class VenusRoom {
     private updateFromRoomData;
 }
 
+interface CreateRoomOptions {
+    maxPlayers?: number;
+    gameType?: string;
+    isPrivate?: boolean;
+    roomCode?: string;
+    name?: string;
+    description?: string;
+    customMetadata?: Record<string, any>;
+}
+interface JoinOrCreateResult {
+    action: 'created' | 'joined';
+    room: VenusRoom;
+    playersJoined: number;
+}
+interface RoomSubscriptionOptions {
+    onData?: (roomData: any) => void;
+    onMessages?: (messagePayload: any) => void;
+    onMoves?: (movePayload: any) => void;
+    onGameEvents?: (eventPayload: any) => void;
+}
+interface ProposeMovePayload {
+    gameSpecificState: any;
+    moveType: string;
+    clientContext?: Record<string, any>;
+    clientProposalId?: string;
+}
+interface ProposeMoveResult {
+    proposedMoveId: string;
+}
+interface ValidateMoveResult {
+    success: boolean;
+    moveId: string;
+    isValid: boolean;
+    reason?: string | null;
+}
+interface RoomsApi {
+    createRoom(options: CreateRoomOptions): Promise<VenusRoom>;
+    joinOrCreateRoom(options: CreateRoomOptions): Promise<JoinOrCreateResult>;
+    joinRoomByCode?(roomCode: string): Promise<VenusRoom>;
+    getUserRooms?(includeArchived?: boolean): Promise<VenusRoom[]>;
+    subscribe?(room: VenusRoom, options: RoomSubscriptionOptions): (() => void) | {
+        unsubscribe(): void;
+    };
+    updateData?(room: VenusRoom, updates: Record<string, any>, merge?: boolean): Promise<any>;
+    getData?(room: VenusRoom): Promise<any>;
+    sendMessage?(room: VenusRoom, messageData: any): Promise<string>;
+    leave?(room: VenusRoom): Promise<any>;
+    startGame?(room: VenusRoom, gameConfig?: Record<string, any>, turnOrder?: string[] | null): Promise<any>;
+    proposeMove?(room: VenusRoom, proposalPayload: ProposeMovePayload): Promise<ProposeMoveResult>;
+    validateMove?(room: VenusRoom, moveId: string, isValid: boolean, reason?: string | null, validatorId?: string | null): Promise<ValidateMoveResult>;
+}
+
+interface LoggingApi {
+    logDebug(message: string, ...args: any[]): void;
+    logError(message: string, ...args: any[]): void;
+}
+
 interface SharedAssetsApi {
     loadCharactersBundle(): Promise<ArrayBuffer>;
     loadBurgerTimeAssetsBundle(): Promise<ArrayBuffer>;
@@ -414,6 +640,133 @@ interface IapApi {
     getCurrencyIcon(): Promise<LoadEmbeddedAssetsResponse>;
 }
 
+interface LeaderboardModeConfig {
+    displayName: string;
+    minDurationSec?: number;
+    maxDurationSec?: number;
+    minScore?: number;
+    maxScore?: number;
+}
+type LeaderboardPeriodType = 'daily' | 'weekly' | 'monthly' | 'alltime';
+interface LeaderboardPeriodConfig {
+    displayName: string;
+    type: LeaderboardPeriodType;
+}
+interface LeaderboardAntiCheatConfig {
+    enableZScoreDetection: boolean;
+    zScoreThreshold: number;
+    enableRateLimit: boolean;
+    minTimeBetweenSubmissionsSec: number;
+    trustScoreDecayPerFlag: number;
+    shadowBanThreshold: number;
+}
+interface LeaderboardDisplaySettings {
+    maxEntriesPerPage: number;
+}
+interface LeaderboardConfig {
+    minDurationSec: number;
+    maxDurationSec: number;
+    minScore: number;
+    maxScore: number;
+    requiresHash: boolean;
+    scoringFields: string[];
+    modes: Record<string, LeaderboardModeConfig>;
+    periods: Record<string, LeaderboardPeriodConfig>;
+    antiCheat: LeaderboardAntiCheatConfig;
+    displaySettings: LeaderboardDisplaySettings;
+}
+interface StartRunResult {
+    sessionId: string;
+    startTime: number;
+    expiresAt: number;
+    hashNonce?: string | null;
+    mode: string;
+}
+interface SubmitScoreOptions {
+    mode?: string;
+    telemetry?: Record<string, any>;
+    metadata?: Record<string, any>;
+    hash?: string;
+}
+interface SubmitScoreResult {
+    accepted: boolean;
+    rank?: number | null;
+    zScore?: number | null;
+    isAnomaly?: boolean;
+}
+interface GetLeaderboardOptions {
+    mode?: string;
+    period?: string;
+    periodDate?: number | string;
+    cursor?: string | null;
+    limit?: number;
+    variant?: 'standard' | 'highlight';
+    topCount?: number;
+    contextAhead?: number;
+    contextBehind?: number;
+}
+interface LeaderboardEntry {
+    profileId: string;
+    username: string;
+    avatarUrl: string | null;
+    score: number;
+    durationSec: number;
+    submittedAt: number;
+    sessionId?: string;
+    rank: number | null;
+    zScore?: number | null;
+    isAnomaly?: boolean;
+    trustScore?: number | null;
+    isShadowBanned?: boolean;
+    expiresAt?: number | null;
+    metadata?: Record<string, any> | null;
+    isSeed?: boolean;
+}
+interface LeaderboardResponse {
+    variant: 'standard' | 'highlight';
+    entries: LeaderboardEntry[];
+    totalEntries: number;
+    nextCursor?: string | null;
+    playerRank: number | null;
+    periodInstance: string;
+}
+interface PlayerStatsOptions {
+    mode?: string;
+    period?: string;
+    periodDate?: number | string;
+}
+interface PlayerStats {
+    rank: number | null;
+    score?: number;
+    totalPlayers: number;
+    percentile?: number;
+    trustScore: number;
+    periodInstance: string;
+}
+interface LeaderboardHighlightContext {
+    topEntries: LeaderboardEntry[];
+    beforePlayer: LeaderboardEntry[];
+    playerEntry?: LeaderboardEntry | null;
+    afterPlayer: LeaderboardEntry[];
+    totalBefore: number;
+    totalAfter: number;
+    omittedBefore: number;
+    omittedAfter: number;
+}
+interface LeaderboardHighlightResponse extends LeaderboardResponse {
+    variant: 'highlight';
+    context: LeaderboardHighlightContext;
+}
+interface LeaderboardHighlightOptions extends Omit<GetLeaderboardOptions, 'variant'> {
+}
+interface LeaderboardApi {
+    startRun(mode?: string): Promise<StartRunResult>;
+    submitScore(sessionId: string, score: number, durationSec: number, options?: SubmitScoreOptions): Promise<SubmitScoreResult>;
+    getLeaderboard(options?: GetLeaderboardOptions): Promise<LeaderboardResponse>;
+    getPlayerStats(options?: PlayerStatsOptions): Promise<PlayerStats>;
+    getLeaderboardHighlight(options?: LeaderboardHighlightOptions): Promise<LeaderboardHighlightResponse>;
+}
+
 interface PreloaderApi {
     showLoadScreen(): Promise<void>;
     hideLoadScreen(): Promise<void>;
@@ -421,6 +774,126 @@ interface PreloaderApi {
     setLoaderProgress(progress: number): Promise<void>;
 }
 
+/**
+ * OpenGraph metadata for rich social previews.
+ *
+ * H5 games provide these values so social networks can render rich cards when
+ * a share link is posted.
+ */
+interface ShareMetadata {
+    /** Preview title shown in link cards (e.g. Twitter, iMessage). */
+    title?: string;
+    /** Preview description shown under the title. */
+    description?: string;
+    /** Preview image URL (must be HTTPS for most social platforms). */
+    imageUrl?: string;
+}
+interface SocialQRCodeOptions {
+    /** Size of the QR code image in pixels. */
+    size?: number;
+    /** Margin around the QR code in pixels. */
+    margin?: number;
+    /** Output format for the rendered QR code. */
+    format?: 'png' | 'svg';
+}
+interface ShareLinkResult {
+    shareUrl: string;
+}
+interface QRCodeResult {
+    shareUrl: string;
+    qrCode: string;
+}
+/**
+ * Social distribution API used by H5 games.
+ *
+ * This unified API powers both share links and QR codes, backed by a single
+ * Firestore document that stores arbitrary launch parameters supplied by the
+ * game.
+ */
+interface SocialApi {
+    /**
+     * Create a share link and invoke the host platform's native share UX.
+     *
+     * Platform behaviour:
+     * - iOS / Android: opens the native share sheet.
+     * - Web: copies the generated URL to the clipboard (with fallback toast).
+     *
+     * @param options.launchParams Arbitrary launch parameters (must include gameId).
+     * @param options.metadata Optional OpenGraph metadata for rich previews.
+     * @returns The generated share URL.
+     */
+    shareLinkAsync(options: {
+        launchParams: Record<string, string>;
+        metadata?: ShareMetadata;
+    }): Promise<ShareLinkResult>;
+    /**
+     * Create a share document and return both the URL and a QR code image.
+     *
+     * Games can render or print the returned QR image or re-use the share URL.
+     *
+     * @param options.launchParams Arbitrary launch parameters (must include gameId).
+     * @param options.metadata Optional OpenGraph metadata for the share.
+     * @param options.qrOptions Customisation for the generated QR code.
+     * @returns The generated share URL and QR code (as a data URL).
+     */
+    createQRCodeAsync(options: {
+        launchParams: Record<string, string>;
+        metadata?: ShareMetadata;
+        qrOptions?: SocialQRCodeOptions;
+    }): Promise<QRCodeResult>;
+}
+
+interface InitializeOptions {
+    usePreloader?: boolean;
+    mock?: Record<string, any>;
+    [key: string]: any;
+}
+interface HudInsets {
+    left: number;
+    top: number;
+    right: number;
+    bottom: number;
+}
+interface InitializationOptions {
+    helpText?: string;
+    hardDisableMock?: boolean;
+    mock?: Record<string, any>;
+    usePreloader?: boolean;
+}
+interface InitializationContext {
+    hudInsets?: HudInsets;
+    initializeAsleep: boolean;
+}
+interface Host {
+    readonly ads: AdsApi;
+    readonly analytics: AnalyticsApi;
+    readonly deviceCache: StorageApi;
+    readonly appStorage: StorageApi;
+    readonly globalStorage: StorageApi;
+    readonly avatar3d: Avatar3dApi;
+    readonly navigation: NavigationApi;
+    readonly notifications: NotificationsApi;
+    readonly popups: PopupsApi;
+    readonly profile: ProfileApi;
+    readonly cdn: CdnApi;
+    readonly time: TimeApi;
+    readonly post: PostApi;
+    readonly ai: AiApi;
+    readonly haptics: HapticsApi;
+    readonly features: FeaturesApi;
+    readonly lifecycle: LifecycleApi;
+    readonly simulation: SimulationApi;
+    readonly rooms: RoomsApi;
+    readonly logging: LoggingApi;
+    readonly leaderboard: LeaderboardApi;
+    readonly preloader: PreloaderApi;
+    readonly social: SocialApi;
+    readonly isInitialized: boolean;
+    readonly iap: IapApi;
+    initialize(options?: InitializationOptions): Promise<InitializationContext>;
+}
+declare function createHost(venusApi: VenusAPI, isMock: boolean): Host;
+
 interface Avatar3dConfig {
     headAsset: string | null;
     outfitAsset: string | null;
@@ -686,18 +1159,15 @@ interface Profile {
 }
 interface VenusAPI {
     config: VenusConfig;
+    launchParams: Record<string, string>;
     _mock: any;
     _bootstrap: {
         apiInjected: boolean;
         venus: any;
     };
-    initializeAsync(options?: {
-        helpText?: string;
-        hardDisableMock?: boolean;
-        mock?: Record<string, any>;
-        usePreloader?: boolean;
-    }): Promise<boolean>;
+    initializeAsync(options?: InitializationOptions): Promise<InitializationContext>;
     simulation: VenusSimulationAPI;
+    leaderboard: LeaderboardApi;
     log(message: string, ...args: any[]): void;
     error(message: string, ...args: any[]): void;
     isAvailable(): boolean;
@@ -722,6 +1192,7 @@ interface VenusAPI {
         gateName: string;
     }): Promise<any>;
     getCurrentProfile(): Profile;
+    getLaunchParams(): Record<string, string>;
     /**
      * @deprecated Please use the popups API. (e.g, VenusAPI.popups)
      */
@@ -791,24 +1262,12 @@ interface VenusAPI {
         length(): Promise<number>;
         key(index: number): Promise<string | null>;
     };
-    onShow(handler: (context?: ShowContext) => void): void;
-    onPlay(handler: (context?: PlayContext) => void): void;
-    onPause(handler: () => void): void;
-    onResume(handler: () => void): void;
-    onQuit(handler: () => void): void;
-    onHide(handler: (context?: any) => void): void;
-    onCleanup(handler: () => void): void;
     requestPopOrQuit(options?: QuitOptions): Promise<boolean>;
     getPostInteractionsAsync(): Promise<any>;
     getPostInteractions(): Promise<any>;
     toggleLikeAsync(): Promise<any>;
     toggleFollowAsync(): Promise<any>;
     openCommentsAsync(options?: any): Promise<void>;
-    sharePostAsync(options: {
-        message: string;
-        title?: string;
-        additionalInfo?: any;
-    }): Promise<void>;
     /**
      * @deprecated Please use the ads API. (e.g, VenusAPI.ads)
      */
@@ -934,12 +1393,22 @@ interface VenusAPI {
     sharedAssets: SharedAssetsApi;
     preloader: PreloaderApi;
     notifications: NotificationsApi;
+    lifecycles: LifecycleApi;
+    social: SocialApi;
 }
 
+interface ShowInterstitialAdOptions {
+    adDisplayId?: string;
+    adDisplayName?: string;
+}
+interface ShowRewardedAdOptions {
+    adDisplayId?: string;
+    adDisplayName?: string;
+}
 interface AdsApi {
     isRewardedAdReadyAsync(): Promise<boolean>;
-    showRewardedAdAsync(): Promise<boolean>;
-    showInterstitialAd(): Promise<boolean>;
+    showRewardedAdAsync(options?: ShowRewardedAdOptions): Promise<boolean>;
+    showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type FetchBlobOptions as $, type AnalyticsApi as A, type RecipeRequirementResult as B, VenusRoom as C, VenusTransport as D, type Subscription as E, type SpendCurrencyOptions as F, type LoadEmbeddedAssetsResponse as G, type HapticsApi as H, type IapApi as I, type SharedAssetsApi as J, type PreloaderApi as K, type LifecycleApi as L, type AdsApi as M, type NavigationApi as N, type OnCleanupCallback as O, type PushAppOptions as P, type QuitOptions as Q, type RpcRequest as R, type ScheduleLocalNotification as S, type Avatar3dApi as T, type CdnApi as U, type VenusAPI as V, type AssetManifest as W, type Avatar3dConfig as X, type ShowEditorOptions as Y, type Avatar3dEdits as Z, type SubPath as _, type RpcResponse as a, type AiMessage as a0, type Asset as a1, type Category as a2, MockAvatarApi as a3, type Insets as a4, type PostInfo as a5, type TimeIntervalTriggerInput as a6, type NotificationTriggerInput as a7, type OnRequestCallback as a8, type OnResponseCallback as a9, type OnNotificationCallback as aa, type RpcTransport as ab, RpcSharedAssetsApi as ac, type LoadEmbeddedAssetsRequest as ad, type VenusSimulationState as ae, type VenusSimulationEffect as af, type VenusSimulationRecipe as ag, type RecipeRequirementQuery as ah, type BatchRecipeRequirementsResult as ai, type VenusSimulationAPI as aj, type VenusConfig as ak, type VenusRoomsConfig as al, type ActionSheetOption as am, type RpcNotification as b, RpcClient as c, type NavigationStackInfo as d, type NotificationsApi as e, type ScheduleNotificationOptions as f, type PopupsApi as g, type ActionSheetItem as h, type ShowActionSheetOptions as i, type ShowAlertOptions as j, type ShowConfirmOptions as k, type ShowToastOptions as l, type Profile as m, type AiApi as n, type AiChatCompletionRequest as o, type AiChatCompletionData as p, HapticFeedbackStyle as q, type OnShowCallback as r, type OnHideCallback as s, type OnPauseCallback as t, type OnPlayCallback as u, type OnQuitCallback as v, type OnResumeCallback as w, type PlayContext as x, type ShowContext as y, type VenusSimulationConfig as z };
+export { type Recipe as $, type AnalyticsApi as A, type Subscription as B, type CdnApi as C, type AwakeCallback as D, type Experiment as E, type FetchBlobOptions as F, type GetFutureTimeOptions as G, type Host as H, type PauseCallback as I, type ResumeCallback as J, type QuitCallback as K, type LifecycleApi as L, type SimulationApi as M, type NavigationApi as N, type VenusSimulationConfig as O, type PushAppOptions as P, type QuitOptions as Q, type RpcRequest as R, type StorageApi as S, type TimeApi as T, type ExecuteRecipeOptions as U, type VenusAPI as V, type CollectRecipeResult as W, type GetActiveRunsOptions as X, type ExecuteScopedRecipeResult as Y, type GetAvailableRecipesOptions as Z, type GetAvailableRecipesResult as _, type RpcResponse as a, type LeaderboardEntry as a$, type GetBatchRecipeRequirements as a0, type TriggerRecipeChainOptions as a1, type RecipeRequirementResult as a2, VenusTransport as a3, type LoggingApi as a4, type IapApi as a5, type SpendCurrencyOptions as a6, type LoadEmbeddedAssetsResponse as a7, type SharedAssetsApi as a8, type LeaderboardApi as a9, type AiMessage as aA, type Asset as aB, type Category as aC, MockAvatarApi as aD, type TimeIntervalTriggerInput as aE, type NotificationTriggerInput as aF, type OnRequestCallback as aG, type OnResponseCallback as aH, type OnNotificationCallback as aI, type RpcTransport as aJ, VenusRoom as aK, type CreateRoomOptions as aL, type JoinOrCreateResult as aM, type RoomSubscriptionOptions as aN, type ProposeMovePayload as aO, type ProposeMoveResult as aP, type ValidateMoveResult as aQ, type ExecuteScopedRecipeOptions as aR, type RecipeInfo as aS, RpcSharedAssetsApi as aT, type LoadEmbeddedAssetsRequest as aU, type LeaderboardModeConfig as aV, type LeaderboardPeriodType as aW, type LeaderboardPeriodConfig as aX, type LeaderboardAntiCheatConfig as aY, type LeaderboardDisplaySettings as aZ, type LeaderboardConfig as a_, type StartRunResult as aa, type SubmitScoreOptions as ab, type SubmitScoreResult as ac, type GetLeaderboardOptions as ad, type LeaderboardResponse as ae, type PlayerStatsOptions as af, type PlayerStats as ag, type LeaderboardHighlightOptions as ah, type LeaderboardHighlightResponse as ai, type PreloaderApi as aj, type Avatar3dApi as ak, type AssetManifest as al, type Avatar3dConfig as am, type ShowEditorOptions as an, type Avatar3dEdits as ao, type SocialApi as ap, type ShareMetadata as aq, type ShareLinkResult as ar, type SocialQRCodeOptions as as, type QRCodeResult as at, type AdsApi as au, type PostApi as av, type RoomsApi as aw, type InitializationOptions as ax, type InitializationContext as ay, type HudInsets as az, type RpcNotification as b, type LeaderboardHighlightContext as b0, type InitializeOptions as b1, createHost as b2, type VenusSimulationState as b3, type VenusSimulationEffect as b4, type VenusSimulationRecipe as b5, type RecipeRequirementQuery as b6, type BatchRecipeRequirementsResult as b7, type VenusSimulationAPI as b8, type VenusConfig as b9, type VenusRoomsConfig as ba, type ActionSheetOption as bb, RpcClient as c, type NavigationStackInfo as d, type NotificationsApi as e, type ScheduleLocalNotification as f, type ScheduleNotificationOptions as g, type PopupsApi as h, type ActionSheetItem as i, type ShowActionSheetOptions as j, type ShowAlertOptions as k, type ShowConfirmOptions as l, type ShowToastOptions as m, type ShowInterstitialAdOptions as n, type ShowRewardedAdOptions as o, type ProfileApi as p, type Profile as q, type SubPath as r, type ServerTimeData as s, type AiApi as t, type AiChatCompletionRequest as u, type AiChatCompletionData as v, type HapticsApi as w, HapticFeedbackStyle as x, type FeaturesApi as y, type SleepCallback as z };