@series-inc/venus-sdk 3.1.2 → 3.2.0

package/dist/index.d.mts

@@ -1,5 +1,6 @@
-import { A as AnalyticsApi, R as RpcRequest, a as RpcResponse, b as RpcNotification, c as RpcClient, V as VenusAPI, H as Host, S as StorageApi, N as NavigationApi, Q as QuitOptions, d as NavigationStackInfo, P as PushAppOptions, e as NotificationsApi, f as ScheduleLocalNotification, g as ScheduleNotificationOptions, h as PopupsApi, i as ActionSheetItem, j as ShowActionSheetOptions, k as ShowAlertOptions, l as ShowConfirmOptions, m as ShowToastOptions, n as ShowInterstitialAdOptions, o as ShowRewardedAdOptions, p as ProfileApi, q as Profile, C as CdnApi, r as SubPath, F as FetchBlobOptions, T as TimeApi, s as ServerTimeData, G as GetFutureTimeOptions, t as AiApi, u as AiChatCompletionRequest, v as AiChatCompletionData, w as HapticsApi, x as HapticFeedbackStyle, y as FeaturesApi, E as Experiment, L as LifecycleApi, z as SleepCallback, B as Subscription, D as AwakeCallback, I as PauseCallback, J as ResumeCallback, K as QuitCallback, M as SimulationApi, O as VenusSimulationConfig, U as ExecuteRecipeOptions, W as CollectRecipeResult, X as GetActiveRunsOptions, Y as ExecuteScopedRecipeResult, Z as GetAvailableRecipesOptions, _ as GetAvailableRecipesResult, $ as Recipe, a0 as GetBatchRecipeRequirements, a1 as TriggerRecipeChainOptions, a2 as RecipeRequirementResult, a3 as VenusTransport, a4 as LoggingApi, a5 as IapApi, a6 as SpendCurrencyOptions, a7 as LoadEmbeddedAssetsResponse, a8 as SharedAssetsApi, a9 as LeaderboardApi, aa as StartRunResult, ab as SubmitScoreOptions, ac as SubmitScoreResult, ad as GetLeaderboardOptions, ae as LeaderboardResponse, af as PlayerStatsOptions, ag as PlayerStats, ah as LeaderboardHighlightOptions, ai as LeaderboardHighlightResponse, aj as PreloaderApi, ak as SocialApi, al as ShareMetadata, am as ShareLinkResult, an as SocialQRCodeOptions, ao as QRCodeResult, ap as Avatar3dApi, aq as AssetManifest, ar as Avatar3dConfig, as as ShowEditorOptions, at as Avatar3dEdits, au as AdsApi, av as PostApi, aw as RoomsApi, ax as InitializationOptions, ay as InitializationContext, az as HudInsets } from './AdsApi-CNGRf6j0.mjs';
-export { aA as AiMessage, aB as Asset, aC as Category, aL as CreateRoomOptions, aR as ExecuteScopedRecipeOptions, aM as JoinOrCreateResult, aY as LeaderboardAntiCheatConfig, a_ as LeaderboardConfig, aZ as LeaderboardDisplaySettings, a$ as LeaderboardEntry, b0 as LeaderboardHighlightContext, aV as LeaderboardModeConfig, aX as LeaderboardPeriodConfig, aW as LeaderboardPeriodType, aU as LoadEmbeddedAssetsRequest, aD as MockAvatarApi, aF as NotificationTriggerInput, aI as OnNotificationCallback, aG as OnRequestCallback, aH as OnResponseCallback, aO as ProposeMovePayload, aP as ProposeMoveResult, aS as RecipeInfo, aN as RoomSubscriptionOptions, aT as RpcSharedAssetsApi, aJ as RpcTransport, aE as TimeIntervalTriggerInput, aQ as ValidateMoveResult, aK as VenusRoom, b1 as createHost } from './AdsApi-CNGRf6j0.mjs';
+import { r as AnalyticsApi, s as RpcRequest, t as RpcResponse, u as RpcNotification, v as RpcClient, V as VenusAPI, H as Host, w as StorageApi, N as NavigationApi, Q as QuitOptions, x as NavigationStackInfo, y as PushAppOptions, z as NotificationsApi, C as ScheduleLocalNotification, D as ScheduleNotificationOptions, E as PopupsApi, F as ActionSheetItem, G as ShowActionSheetOptions, I as ShowAlertOptions, J as ShowConfirmOptions, K as ShowToastOptions, L as ShowInterstitialAdOptions, M as ShowRewardedAdOptions, O as ProfileApi, P as Profile, T as DeviceApi, U as DeviceInfo, W as EnvironmentApi, X as EnvironmentInfo, Y as SystemApi, Z as SafeArea, _ as CdnApi, $ as SubPath, a0 as FetchBlobOptions, a1 as TimeApi, a2 as ServerTimeData, a3 as GetFutureTimeOptions, a4 as AiApi, a5 as AiChatCompletionRequest, a6 as AiChatCompletionData, a7 as HapticsApi, a8 as HapticFeedbackStyle, a9 as FeaturesApi, aa as Experiment, ab as LifecycleApi, ac as SleepCallback, ad as Subscription, ae as AwakeCallback, af as PauseCallback, ag as ResumeCallback, ah as QuitCallback, ai as SimulationApi, aj as SimulationSlotValidationResult, g as SimulationSubscribeOptions, ak as SimulationBatchOperation, al as SimulationBatchOperationsResult, am as SimulationAvailableItem, an as SimulationPowerPreview, ao as SimulationSlotMutationResult, ap as SimulationSlotContainer, aq as SimulationAssignment, ar as SimulationState, j as VenusSimulationConfig, as as ExecuteRecipeOptions, at as ExecuteRecipeResponse, au as CollectRecipeResult, av as GetActiveRunsOptions, S as SimulationRunSummary, aw as ExecuteScopedRecipeOptions, ax as ExecuteScopedRecipeResult, ay as GetAvailableRecipesOptions, az as GetAvailableRecipesResult, aA as Recipe, R as RecipeRequirementResult, aB as GetBatchRecipeRequirements, aC as TriggerRecipeChainOptions, aD as RoomDataUpdate, aE as RoomMessageEvent, aF as ProposedMoveEvent, aG as VenusTransport, aH as RoomsApi, aI as CreateRoomOptions, q as VenusRoom, aJ as JoinOrCreateRoomOptions, aK as JoinOrCreateResult, aL as ListRoomsOptions, aM as UpdateRoomDataOptions, aN as RoomMessageRequest, aO as StartRoomGameOptions, aP as ProposeMoveRequest, aQ as ProposeMoveResult, aR as ValidateMoveVerdict, aS as ValidateMoveResult, aT as RoomSubscriptionOptions, aU as LoggingApi, aV as IapApi, aW as SpendCurrencyOptions, aX as LoadEmbeddedAssetsResponse, aY as SharedAssetsApi, aZ as LeaderboardApi, a_ as ScoreToken, a$ as SubmitScoreParams, b0 as SubmitScoreResult, b1 as GetPagedScoresOptions, b2 as PagedScoresResponse, b3 as PlayerRankOptions, b4 as PlayerRankResult, b5 as GetPodiumScoresOptions, b6 as PodiumScoresResponse, b7 as PreloaderApi, b8 as SocialApi, b9 as ShareMetadata, ba as ShareLinkResult, bb as SocialQRCodeOptions, bc as QRCodeResult, bd as Avatar3dApi, be as AssetManifest, bf as Avatar3dConfig, bg as ShowEditorOptions, bh as Avatar3dEdits, bi as AdsApi, bj as InitializationOptions, bk as InitializationContext } from './AdsApi-DFutZ7_q.mjs';
+export { bl as AiMessage, bm as Asset, bn as Category, bP as HudInsets, bv as JoinRoomMatchCriteria, bK as LeaderboardAntiCheatConfig, bM as LeaderboardConfig, bL as LeaderboardDisplaySettings, bN as LeaderboardEntry, bH as LeaderboardModeConfig, bJ as LeaderboardPeriodConfig, bI as LeaderboardPeriodType, bG as LoadEmbeddedAssetsRequest, bo as MockAvatarApi, bq as NotificationTriggerInput, bt as OnNotificationCallback, br as OnRequestCallback, bs as OnResponseCallback, bO as PodiumScoresContext, by as RecipeInfo, bw as RoomMessageEventType, bF as RpcSharedAssetsApi, bu as RpcTransport, bC as SimulationBatchOperationAssign, bD as SimulationBatchOperationRemove, bE as SimulationBatchOperationResult, bz as SimulationPersonalState, bA as SimulationRoomActiveRecipe, bB as SimulationRoomState, bp as TimeIntervalTriggerInput, bx as VenusRoomPayload, bQ as createHost } from './AdsApi-DFutZ7_q.mjs';
+export { WEBVIEW_LIBRARY_SHIM_SOURCE, getWebviewLibraryShimSource } from './webview/index.mjs';
 
 declare class MockAnalyticsApi implements AnalyticsApi {
     recordCustomEvent(eventName: string, payload: Record<string, any>): Promise<void>;
@@ -160,15 +161,77 @@ declare class MockPopupsApi implements PopupsApi {
 declare function initializePopups(venusApi: VenusAPI, host: Host): void;
 
 declare class HostProfileApi implements ProfileApi {
+    private readonly venusApi;
+    constructor(venusApi: VenusAPI);
     getCurrentProfile(): Profile;
 }
 
 declare class MockProfileApi implements ProfileApi {
+    private readonly venusApi;
+    constructor(venusApi: VenusAPI);
     getCurrentProfile(): Profile;
 }
 
 declare function initializeProfile(venusApi: VenusAPI, host: Host): void;
 
+declare class HostDeviceApi implements DeviceApi {
+    private readonly venusApi;
+    constructor(venusApi: VenusAPI);
+    getDevice(): DeviceInfo;
+}
+
+declare class MockDeviceApi implements DeviceApi {
+    private readonly venusApi;
+    constructor(venusApi: VenusAPI);
+    getDevice(): DeviceInfo;
+}
+
+declare class HostEnvironmentApi implements EnvironmentApi {
+    private readonly venusApi;
+    constructor(venusApi: VenusAPI);
+    getEnvironment(): EnvironmentInfo;
+}
+
+declare class MockEnvironmentApi implements EnvironmentApi {
+    private readonly venusApi;
+    constructor(venusApi: VenusAPI);
+    getEnvironment(): EnvironmentInfo;
+}
+
+/**
+ * Host implementation of SystemApi that delegates to device and environment APIs.
+ * Acts as a facade combining both system-level information sources.
+ */
+declare class HostSystemApi implements SystemApi {
+    private readonly deviceApi;
+    private readonly environmentApi;
+    private readonly venusApi;
+    constructor(deviceApi: DeviceApi, environmentApi: EnvironmentApi, venusApi: VenusAPI);
+    getDevice(): DeviceInfo;
+    getEnvironment(): EnvironmentInfo;
+    getSafeArea(): SafeArea;
+    isMobile(): boolean;
+    isWeb(): boolean;
+}
+
+/**
+ * Mock implementation of SystemApi for local development.
+ * Delegates to mock device and environment APIs.
+ */
+declare class MockSystemApi implements SystemApi {
+    private readonly deviceApi;
+    private readonly environmentApi;
+    private readonly venusApi;
+    constructor(deviceApi: DeviceApi, environmentApi: EnvironmentApi, venusApi: VenusAPI);
+    getDevice(): DeviceInfo;
+    getEnvironment(): EnvironmentInfo;
+    getSafeArea(): SafeArea;
+    isMobile(): boolean;
+    isWeb(): boolean;
+}
+
+declare function initializeSystem(venusApi: VenusAPI, host: Host): void;
+
 declare class HostCdnApi implements CdnApi {
     private readonly baseUrl;
     constructor(baseUrl: string);
@@ -181,8 +244,10 @@ declare class HostCdnApi implements CdnApi {
 }
 
 declare class MockCdnApi implements CdnApi {
-    private readonly baseUrl;
-    constructor();
+    private readonly venusApi;
+    constructor(venusApi: VenusAPI);
+    private get baseUrl();
+    private get forceRemoteCdn();
     fetchBlob(path: SubPath, options?: FetchBlobOptions): Promise<Blob>;
     getAssetCdnBaseUrl(): string;
     resolveAssetUrl(subPath: string): string;
@@ -195,7 +260,8 @@ declare function initializeCdn(venusApi: VenusAPI, host: Host): void;
 
 declare class HostTimeApi implements TimeApi {
     private readonly rpcClient;
-    constructor(rpcClient: RpcClient);
+    private readonly venusApi;
+    constructor(rpcClient: RpcClient, venusApi: VenusAPI);
     requestTimeAsync(): Promise<ServerTimeData>;
     formatTime(timestamp: number, options?: any): string;
     formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
@@ -211,7 +277,6 @@ declare class MockTimeApi implements TimeApi {
     formatTime(timestamp: number, options?: any): string;
     getFutureTimeAsync(options?: GetFutureTimeOptions): Promise<number>;
     requestTimeAsync(): Promise<ServerTimeData>;
-    private getLocale;
 }
 
 declare function initializeTime(venusApi: VenusAPI, host: Host): void;
@@ -293,69 +358,41 @@ declare function initializeLifecycleApi(venusApi: VenusAPI, host: Host): void;
 declare class RpcSimulationApi implements SimulationApi {
     private readonly rpcClient;
     private _simulationConfig;
+    private readonly subscriptionCallbacks;
     constructor(rpcClient: RpcClient);
-    validateSlotAssignmentAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
-    sumContributions(contributions: Record<string, any>): Record<string, number>;
-    executeBatchOperationsAsync(operations: Array<any>, validateOnly?: boolean): Promise<any>;
-    getAvailableItemsAsync(containerId: string, slotId: string): Promise<Array<any>>;
-    calculatePowerPreviewAsync(containerId: string, slotId: string, candidateItemId: string): Promise<any>;
-    assignItemToSlotAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
-    removeItemFromSlotAsync(containerId: string, slotId: string): Promise<any>;
-    getSlotContainersAsync(): Promise<any>;
-    getSlotAssignmentsAsync(containerId: string): Promise<any>;
-    getStateAsync(roomId?: string): Promise<any>;
+    isEnabled(): boolean;
+    validateSlotAssignmentAsync(containerId: string, slotId: string, itemId: string): Promise<SimulationSlotValidationResult>;
+    subscribeAsync(options: SimulationSubscribeOptions): Promise<() => void>;
+    executeBatchOperationsAsync(operations: Array<SimulationBatchOperation>, validateOnly?: boolean): Promise<SimulationBatchOperationsResult>;
+    getAvailableItemsAsync(containerId: string, slotId: string): Promise<SimulationAvailableItem[]>;
+    calculatePowerPreviewAsync(containerId: string, slotId: string, candidateItemId: string): Promise<SimulationPowerPreview>;
+    assignItemToSlotAsync(containerId: string, slotId: string, itemId: string): Promise<SimulationSlotMutationResult>;
+    removeItemFromSlotAsync(containerId: string, slotId: string): Promise<SimulationSlotMutationResult>;
+    getSlotContainersAsync(): Promise<SimulationSlotContainer[]>;
+    getSlotAssignmentsAsync(containerId: string): Promise<SimulationAssignment[]>;
+    getStateAsync(roomId?: string): Promise<SimulationState>;
     getConfigAsync(roomId?: string): Promise<VenusSimulationConfig>;
-    executeRecipeAsync(recipeId: string, inputs?: any, options?: ExecuteRecipeOptions): Promise<any>;
+    executeRecipeAsync(recipeId: string, inputs?: Record<string, unknown>, options?: ExecuteRecipeOptions): Promise<ExecuteRecipeResponse>;
     collectRecipeAsync(runId: string): Promise<CollectRecipeResult>;
-    getActiveRunsAsync(options?: GetActiveRunsOptions): Promise<any>;
-    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: any, options?: any): Promise<ExecuteScopedRecipeResult>;
+    getActiveRunsAsync(options?: GetActiveRunsOptions): Promise<SimulationRunSummary[]>;
+    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: Record<string, unknown>, options?: ExecuteScopedRecipeOptions): Promise<ExecuteScopedRecipeResult>;
     getAvailableRecipesAsync(options?: GetAvailableRecipesOptions): Promise<GetAvailableRecipesResult>;
-    getRecipeRequirementsAsync(recipe: Recipe): Promise<any>;
-    getBatchRecipeRequirementsAsync(recipes: Recipe[]): Promise<GetBatchRecipeRequirements>;
-    triggerRecipeChainAsync(recipeId: string, options?: TriggerRecipeChainOptions): Promise<any>;
-    getEntityMetadataAsync(entityId: string): Promise<any>;
-    resolveFieldValueAsync(entityId: string, fieldPath: string, entity?: string): Promise<any>;
-}
-
-declare class MockSimulationApi implements SimulationApi {
-    private readonly mockSimulationConfigs;
-    private readonly mockSimulationStates;
-    private readonly mockActiveTimers;
-    private readonly appId;
-    private readonly providedSimulationConfig;
-    constructor(simulationConfig?: VenusSimulationConfig | null);
-    sumContributions(contributions: Record<string, any>): Record<string, number>;
-    validateSlotAssignmentAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
-    executeBatchOperationsAsync(operations: Array<any>, validateOnly?: boolean): Promise<any>;
-    getAvailableItemsAsync(containerId: string, slotId: string): Promise<Array<any>>;
-    calculatePowerPreviewAsync(containerId: string, slotId: string, candidateItemId: string): Promise<any>;
-    getSlotContainersAsync(): Promise<any>;
-    getSlotAssignmentsAsync(containerId: string): Promise<any>;
-    resolveFieldValueAsync(entityId: string, fieldPath: string, entity?: string): Promise<any>;
-    getEntityMetadataAsync(entityId: string): Promise<any>;
-    collectRecipeAsync(runId: string): Promise<CollectRecipeResult>;
-    executeRecipeAsync(recipeId: string, inputs?: any, options?: ExecuteRecipeOptions): Promise<any>;
-    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: any, options?: any): Promise<ExecuteScopedRecipeResult>;
-    getActiveRunsAsync(options?: GetActiveRunsOptions): Promise<any>;
-    getAvailableRecipesAsync(options?: GetAvailableRecipesOptions): Promise<GetAvailableRecipesResult>;
-    getBatchRecipeRequirementsAsync(recipes: Recipe[]): Promise<GetBatchRecipeRequirements>;
     getRecipeRequirementsAsync(recipe: Recipe): Promise<RecipeRequirementResult>;
-    triggerRecipeChainAsync(recipeId: string, options?: TriggerRecipeChainOptions): Promise<any>;
-    private log;
-    private executeRecipe;
-    private initializeSimulationState;
-    private generateRunId;
-    private completeRun;
-    private createSeededRandom;
-    private applyEffects;
-    getConfigAsync(): Promise<any>;
-    getStateAsync(roomId?: string): Promise<any>;
-    assignItemToSlotAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
-    removeItemFromSlotAsync(containerId: string, slotId: string): Promise<any>;
+    getBatchRecipeRequirementsAsync(recipes: Recipe[]): Promise<GetBatchRecipeRequirements>;
+    triggerRecipeChainAsync(recipeId: string, options?: TriggerRecipeChainOptions): Promise<ExecuteRecipeResponse>;
+    getEntityMetadataAsync(entityId: string): Promise<Record<string, unknown>>;
+    resolveFieldValueAsync(entityId: string, fieldPath: string, entity?: string): Promise<unknown>;
+    private handleSimulationUpdate;
+    private ensureValidSubscribeOptions;
 }
 
 declare function initializeSimulation(venusApi: VenusAPI, host: Host): void;
 
+interface RoomNotificationSubscriptionState {
+    data: Record<string, Array<(event: RoomDataUpdate) => void>>;
+    messages: Record<string, Array<(event: RoomMessageEvent) => void>>;
+    gameEvents: Record<string, Array<(event: ProposedMoveEvent) => void>>;
+}
 /**
  * Set up room notification listeners using the transport's onVenusMessage hook.
  * This routes host-sent room notifications (H5_ROOM_DATA_UPDATED, etc.) to the
@@ -363,7 +400,34 @@ declare function initializeSimulation(venusApi: VenusAPI, host: Host): void;
  * @param transport The Venus transport to listen for messages
  * @param getSubscriptions Function to retrieve subscription state from RoomsApi
  */
-declare function setupRoomNotifications(transport: VenusTransport, getSubscriptions: () => any): Subscription;
+declare function setupRoomNotifications(transport: VenusTransport, getSubscriptions: () => RoomNotificationSubscriptionState): Subscription;
+
+declare class RpcRoomsApi implements RoomsApi {
+    private readonly rpcClient;
+    private readonly subscriptions;
+    constructor(rpcClient: RpcClient);
+    /**
+     * Get the subscription state for external access (used by setupRoomNotifications)
+     */
+    getSubscriptions(): RoomNotificationSubscriptionState;
+    /**
+     * Set up room notification routing from the transport
+     */
+    setupNotifications(transport: VenusTransport): void;
+    createRoomAsync(options: CreateRoomOptions): Promise<VenusRoom>;
+    joinOrCreateRoomAsync(options: JoinOrCreateRoomOptions): Promise<JoinOrCreateResult>;
+    joinRoomByCodeAsync(roomCode: string): Promise<VenusRoom>;
+    getUserRoomsAsync(options?: ListRoomsOptions): Promise<VenusRoom[]>;
+    updateRoomDataAsync(room: VenusRoom, updates: Record<string, unknown>, options?: UpdateRoomDataOptions): Promise<void>;
+    getRoomDataAsync(room: VenusRoom): Promise<Record<string, unknown>>;
+    sendRoomMessageAsync(venusRoom: VenusRoom, request: RoomMessageRequest): Promise<string>;
+    leaveRoomAsync(room: VenusRoom): Promise<void>;
+    startRoomGameAsync(room: VenusRoom, options?: StartRoomGameOptions): Promise<void>;
+    proposeMoveAsync(room: VenusRoom, proposalPayload: ProposeMoveRequest): Promise<ProposeMoveResult>;
+    validateMoveAsync(_room: VenusRoom, moveId: string, verdict: ValidateMoveVerdict): Promise<ValidateMoveResult>;
+    subscribeAsync(room: VenusRoom, options?: RoomSubscriptionOptions): Promise<() => void>;
+}
+
 declare function initializeRoomsApi(venusApi: VenusAPI, host: Host): void;
 
 declare class MockLoggingApi implements LoggingApi {
@@ -395,9 +459,61 @@ declare class RpcIapApi implements IapApi {
 declare class MockSharedAssetsApi implements SharedAssetsApi {
     private readonly venusApi;
     constructor(venusApi: VenusAPI);
-    loadBurgerTimeAssetsBundle(): Promise<ArrayBuffer>;
-    loadCharactersBundle(): Promise<ArrayBuffer>;
-}
+    loadAssetsBundle(game: string, bundleKey: string, fileType?: string): Promise<ArrayBuffer>;
+    loadLibraryCode(libraryKey: string): Promise<string>;
+}
+
+type ModuleSpecifierMatch = 'exact' | 'prefix';
+interface ModuleSpecifierConfig {
+    match: ModuleSpecifierMatch;
+    value: string;
+    behavior?: 'default' | 'react-jsx-runtime' | 'react-jsx-dev-runtime' | 'namespace';
+}
+interface EmbeddedLibraryDefinition {
+    libraryKey: string;
+    assetKey: string;
+    packageName: string;
+    version: string;
+    globalVar: string;
+    cdnPath: string;
+    moduleSpecifiers: ModuleSpecifierConfig[];
+    loadStage: number;
+    enabled: boolean;
+}
+declare const DEFAULT_SHARED_LIB_CDN_BASE = "https://venus-static-01293ak.web.app/libs";
+declare const EMBEDDED_LIBRARIES: EmbeddedLibraryDefinition[];
+declare const EMBEDDED_LIBRARY_BY_KEY: Record<string, EmbeddedLibraryDefinition>;
+declare const MODULE_TO_LIBRARY_SPECIFIERS: {
+    libraryKey: string;
+    match: ModuleSpecifierMatch;
+    value: string;
+    behavior?: "default" | "react-jsx-runtime" | "react-jsx-dev-runtime" | "namespace";
+}[];
+/**
+ * Get library definition by key, throwing if not found.
+ * @param libraryKey - Library key (e.g., 'phaser@3.90.0')
+ * @returns Library definition
+ * @throws Error if library key is not found
+ */
+declare function getLibraryDefinition(libraryKey: string): EmbeddedLibraryDefinition;
+
+/**
+ * Base64 encoding/decoding utilities for embedded assets and libraries.
+ *
+ * These utilities handle base64 data received from the Venus host via RPC,
+ * converting it to ArrayBuffer or UTF-8 strings with appropriate fallbacks
+ * for different JavaScript environments.
+ */
+/**
+ * Convert base64 string to ArrayBuffer.
+ * Uses native atob() when available for best performance.
+ */
+declare function base64ToArrayBuffer(base64: string): ArrayBuffer;
+/**
+ * Convert base64 string to UTF-8 string.
+ * Tries multiple decoding strategies for maximum compatibility.
+ */
+declare function base64ToUtf8(base64: string): string;
 
 declare class MockIapApi implements IapApi {
     private _hardCurrency;
@@ -413,35 +529,96 @@ declare function initializeIap(venusApiInstance: VenusAPI, host: Host): void;
 
 declare class RpcLeaderboardApi implements LeaderboardApi {
     private readonly rpcClient;
+    /** Cache of score tokens for automatic hash computation */
+    private tokenCache;
     constructor(rpcClient: RpcClient);
-    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>;
+    /**
+     * Create a score token for submitting a score.
+     * Token is cached for automatic hash computation if score sealing is enabled.
+     *
+     * @param mode - Optional game mode
+     * @returns Score token with sealing data if enabled
+     */
+    createScoreToken(mode?: string): Promise<ScoreToken>;
+    /**
+     * Submit a score to the leaderboard.
+     * Automatically computes hash if score sealing is enabled and token was created via createScoreToken().
+     *
+     * @param params - Score submission parameters
+     * @returns Submission result with acceptance status and rank
+     * @throws Error if token not found in cache
+     */
+    submitScore(params: SubmitScoreParams): Promise<SubmitScoreResult>;
+    getPagedScores(options?: GetPagedScoresOptions): Promise<PagedScoresResponse>;
+    getMyRank(options?: PlayerRankOptions): Promise<PlayerRankResult>;
+    getPodiumScores(options?: GetPodiumScoresOptions): Promise<PodiumScoresResponse>;
 }
 
 declare class MockLeaderboardApi implements LeaderboardApi {
-    private sessions;
+    private tokens;
+    /** Cache of score tokens for automatic hash computation */
+    private tokenCache;
     private entriesByMode;
-    private sessionCounter;
-    private requiresHash;
+    private tokenCounter;
+    private enableScoreSealing;
+    private scoreSealingSecret;
     constructor(options?: {
-        requiresHash?: boolean;
+        enableScoreSealing?: boolean;
+        scoreSealingSecret?: string;
     });
+    /**
+     * Configure mock leaderboard settings
+     *
+     * @param options - Configuration options
+     */
     configure(options: {
-        requiresHash?: boolean;
+        enableScoreSealing?: boolean;
+        scoreSealingSecret?: string;
     }): void;
     private generateNonce;
     private getModeKey;
     private getEntriesForMode;
-    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>;
+    /**
+     * Create a mock score token for testing.
+     * Token is cached for automatic hash computation if score sealing is enabled.
+     *
+     * @param mode - Optional game mode
+     * @returns Score token with sealing data if enabled
+     */
+    createScoreToken(mode?: string): Promise<ScoreToken>;
+    /**
+     * Submit a mock score to the leaderboard.
+     * Automatically computes hash if score sealing is enabled and token was created via createScoreToken().
+     *
+     * @param params - Score submission parameters
+     * @returns Submission result with acceptance status and rank
+     * @throws Error if token not found in cache or validation fails
+     */
+    submitScore(params: SubmitScoreParams): Promise<SubmitScoreResult>;
+    getPagedScores(options?: GetPagedScoresOptions): Promise<PagedScoresResponse>;
+    getMyRank(_options?: PlayerRankOptions): Promise<PlayerRankResult>;
+    getPodiumScores(options?: GetPodiumScoresOptions): Promise<PodiumScoresResponse>;
 }
 
+/**
+ * Hash algorithm used for score sealing
+ */
+declare const HASH_ALGORITHM_WEB_CRYPTO = "SHA-256";
+declare const HASH_ALGORITHM_NODE = "sha256";
+/**
+ * Compute HMAC-SHA256 hash for score sealing.
+ * Hash always includes: score, duration, token
+ * Matches server-side hash computation exactly.
+ *
+ * @param score - The score value
+ * @param duration - Duration in seconds
+ * @param token - Score token
+ * @param sealingNonce - One-time nonce for this submission
+ * @param sealingSecret - Secret key for HMAC
+ * @returns Hex-encoded hash string
+ */
+declare function computeScoreHash(score: number, duration: number, token: string, sealingNonce: string, sealingSecret: string): Promise<string>;
+
 declare function initializeLeaderboard(venusApiInstance: VenusAPI, host: Host): void;
 
 declare class MockPreloaderApi implements PreloaderApi {
@@ -571,10 +748,6 @@ declare enum VenusMessageId {
     CONFIRM_DIALOG = "H5_CONFIRM_DIALOG",
     ACTION_SHEET_SHOW = "H5_ACTION_SHEET_SHOW",
     REQUEST_SERVER_TIME = "H5_REQUEST_SERVER_TIME",
-    GET_POST_INTERACTIONS = "H5_GET_POST_INTERACTIONS",
-    TOGGLE_LIKE = "H5_TOGGLE_LIKE",
-    OPEN_COMMENTS = "H5_OPEN_COMMENTS",// For opening comments with callback support
-    TOGGLE_FOLLOW = "H5_TOGGLE_FOLLOW",
     SHARE_LINK = "H5_SHARE_LINK",
     CREATE_SHARE_QRCODE = "H5_CREATE_SHARE_QRCODE",
     AI_CHAT_COMPLETION = "H5_AI_CHAT_COMPLETION",
@@ -619,11 +792,14 @@ declare enum VenusMessageId {
     H5_SIMULATION_GET_AVAILABLE_ITEMS = "H5_SIMULATION_GET_AVAILABLE_ITEMS",
     H5_SIMULATION_VALIDATE_ASSIGNMENT = "H5_SIMULATION_VALIDATE_ASSIGNMENT",
     H5_SIMULATION_BATCH_OPERATIONS = "H5_SIMULATION_BATCH_OPERATIONS",
-    H5_LEADERBOARD_START_RUN = "H5_LEADERBOARD_START_RUN",
+    H5_SIMULATION_SUBSCRIBE = "H5_SIMULATION_SUBSCRIBE",
+    H5_SIMULATION_UNSUBSCRIBE = "H5_SIMULATION_UNSUBSCRIBE",
+    H5_SIMULATION_UPDATE = "H5_SIMULATION_UPDATE",
+    H5_LEADERBOARD_CREATE_SCORE_TOKEN = "H5_LEADERBOARD_CREATE_SCORE_TOKEN",
     H5_LEADERBOARD_SUBMIT_SCORE = "H5_LEADERBOARD_SUBMIT_SCORE",
-    H5_LEADERBOARD_GET = "H5_LEADERBOARD_GET",
-    H5_LEADERBOARD_GET_HIGHLIGHT = "H5_LEADERBOARD_GET_HIGHLIGHT",
-    H5_LEADERBOARD_GET_PLAYER_STATS = "H5_LEADERBOARD_GET_PLAYER_STATS",
+    H5_LEADERBOARD_GET_PAGED_SCORES = "H5_LEADERBOARD_GET_PAGED_SCORES",
+    H5_LEADERBOARD_GET_PODIUM_SCORES = "H5_LEADERBOARD_GET_PODIUM_SCORES",
+    H5_LEADERBOARD_GET_MY_RANK = "H5_LEADERBOARD_GET_MY_RANK",
     H5_ROOM_CREATE = "H5_ROOM_CREATE",
     H5_ROOM_JOIN = "H5_ROOM_JOIN",
     H5_ROOM_JOIN_OR_CREATE = "H5_ROOM_JOIN_OR_CREATE",
@@ -666,9 +842,9 @@ declare class RemoteHost implements Host {
     readonly notifications: NotificationsApi;
     readonly popups: PopupsApi;
     readonly profile: ProfileApi;
+    readonly system: SystemApi;
     readonly cdn: CdnApi;
     readonly time: TimeApi;
-    readonly post: PostApi;
     readonly ai: AiApi;
     readonly haptics: HapticsApi;
     readonly features: FeaturesApi;
@@ -691,14 +867,26 @@ declare class RemoteHost implements Host {
 interface InitResponse {
     initializeAsleep: boolean;
     instanceId: string;
-    profile?: {
+    profile: {
         id: string;
         username: string;
         avatarUrl?: string | null;
         isAnonymous?: boolean;
     };
-    hudInsets?: HudInsets;
-    launchParams?: Record<string, string>;
+    safeArea?: SafeArea;
+    launchParams: Record<string, string>;
+    environment: EnvironmentInfo;
+    device: DeviceInfo;
+    locale: string;
+    languageCode: string;
+    rooms?: {
+        gameType?: string;
+        rulesPreset?: string;
+        matchmaking?: Record<string, any>;
+        createOptions?: Record<string, any>;
+        privateMatchDefaults?: Record<string, any>;
+        [key: string]: any;
+    };
 }
 
-export { ActionSheetItem, AdsApi, AiApi, AiChatCompletionData, AiChatCompletionRequest, AnalyticsApi, AssetManifest, Avatar3dApi, Avatar3dConfig, Avatar3dEdits, AwakeCallback, CdnApi, CollectRecipeResult, ExecuteRecipeOptions, ExecuteScopedRecipeResult, Experiment, FeaturesApi, FetchBlobOptions, GetActiveRunsOptions, GetAvailableRecipesOptions, GetAvailableRecipesResult, GetBatchRecipeRequirements, GetFutureTimeOptions, GetLeaderboardOptions, HapticFeedbackStyle, HapticsApi, Host, HostCdnApi, HostProfileApi, HostTimeApi, HudInsets, IapApi, type InitResponse, InitializationContext, InitializationOptions, LeaderboardApi, LeaderboardHighlightOptions, LeaderboardHighlightResponse, LeaderboardResponse, LifecycleApi, LoadEmbeddedAssetsResponse, LoggingApi, type MethodIds, MockAdsApi, MockAiApi, MockAnalyticsApi, MockCdnApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLeaderboardApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockPreloaderApi, MockProfileApi, MockSharedAssetsApi, MockSimulationApi, MockSocialApi, MockStorageApi, MockTimeApi, NavigationApi, NavigationStackInfo, type NotificationContent, NotificationsApi, PauseCallback, PlayerStats, PlayerStatsOptions, PopupsApi, PreloaderApi, ProfileApi, PushAppOptions, QRCodeResult, QuitCallback, QuitOptions, Recipe, RemoteHost, ResumeCallback, RoomsApi, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLeaderboardApi, RpcLifecycleApi, RpcLoggingApi, type RpcMessage, RpcNavigationApi, RpcNotification, RpcNotificationsApi, RpcPopupsApi, RpcPreloaderApi, RpcRequest, RpcResponse, RpcSimulationApi, RpcSocialApi, RpcStorageApi, SDK_VERSION, ScheduleLocalNotification, ScheduleNotificationOptions, ServerTimeData, ShareLinkResult, ShareMetadata, SharedAssetsApi, ShowActionSheetOptions, ShowAlertOptions, ShowConfirmOptions, ShowEditorOptions, ShowInterstitialAdOptions, ShowRewardedAdOptions, ShowToastOptions, type ShowToastResponse, SimulationApi, SleepCallback, SocialApi, SocialQRCodeOptions, SpendCurrencyOptions, StartRunResult, StorageApi, type StorageType, SubPath, SubmitScoreOptions, SubmitScoreResult, Subscription, TimeApi, TriggerRecipeChainOptions, VenusMessageId, createMockStorageApi, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLeaderboard, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializePreloader, initializeProfile, initializeRoomsApi, initializeSimulation, initializeSocial, initializeStackNavigation, initializeStorage, initializeTime, isPacificDaylightTime, setupRoomNotifications };
+export { ActionSheetItem, AdsApi, AiApi, AiChatCompletionData, AiChatCompletionRequest, AnalyticsApi, AssetManifest, Avatar3dApi, Avatar3dConfig, Avatar3dEdits, AwakeCallback, CdnApi, CollectRecipeResult, CreateRoomOptions, DEFAULT_SHARED_LIB_CDN_BASE, DeviceApi, DeviceInfo, EMBEDDED_LIBRARIES, EMBEDDED_LIBRARY_BY_KEY, type EmbeddedLibraryDefinition, EnvironmentApi, EnvironmentInfo, ExecuteRecipeOptions, ExecuteRecipeResponse, ExecuteScopedRecipeOptions, ExecuteScopedRecipeResult, Experiment, FeaturesApi, FetchBlobOptions, GetActiveRunsOptions, GetAvailableRecipesOptions, GetAvailableRecipesResult, GetBatchRecipeRequirements, GetFutureTimeOptions, GetPagedScoresOptions, GetPodiumScoresOptions, HASH_ALGORITHM_NODE, HASH_ALGORITHM_WEB_CRYPTO, HapticFeedbackStyle, HapticsApi, Host, HostCdnApi, HostDeviceApi, HostEnvironmentApi, HostProfileApi, HostSystemApi, HostTimeApi, IapApi, type InitResponse, InitializationContext, InitializationOptions, JoinOrCreateResult, JoinOrCreateRoomOptions, LeaderboardApi, LifecycleApi, ListRoomsOptions, LoadEmbeddedAssetsResponse, LoggingApi, MODULE_TO_LIBRARY_SPECIFIERS, type MethodIds, MockAdsApi, MockAiApi, MockAnalyticsApi, MockCdnApi, MockDeviceApi, MockEnvironmentApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLeaderboardApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockPreloaderApi, MockProfileApi, MockSharedAssetsApi, MockSocialApi, MockStorageApi, MockSystemApi, MockTimeApi, type ModuleSpecifierConfig, type ModuleSpecifierMatch, NavigationApi, NavigationStackInfo, type NotificationContent, NotificationsApi, PagedScoresResponse, PauseCallback, PlayerRankOptions, PlayerRankResult, PodiumScoresResponse, PopupsApi, PreloaderApi, ProfileApi, ProposeMoveRequest, ProposeMoveResult, ProposedMoveEvent, PushAppOptions, QRCodeResult, QuitCallback, QuitOptions, Recipe, RemoteHost, ResumeCallback, RoomDataUpdate, RoomMessageEvent, RoomMessageRequest, type RoomNotificationSubscriptionState, RoomSubscriptionOptions, RoomsApi, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLeaderboardApi, RpcLifecycleApi, RpcLoggingApi, type RpcMessage, RpcNavigationApi, RpcNotification, RpcNotificationsApi, RpcPopupsApi, RpcPreloaderApi, RpcRequest, RpcResponse, RpcRoomsApi, RpcSimulationApi, RpcSocialApi, RpcStorageApi, SDK_VERSION, SafeArea, ScheduleLocalNotification, ScheduleNotificationOptions, ScoreToken, ServerTimeData, ShareLinkResult, ShareMetadata, SharedAssetsApi, ShowActionSheetOptions, ShowAlertOptions, ShowConfirmOptions, ShowEditorOptions, ShowInterstitialAdOptions, ShowRewardedAdOptions, ShowToastOptions, type ShowToastResponse, SimulationApi, SimulationAssignment, SimulationAvailableItem, SimulationBatchOperation, SimulationBatchOperationsResult, SimulationPowerPreview, SimulationRunSummary, SimulationSlotContainer, SimulationSlotMutationResult, SimulationSlotValidationResult, SimulationState, SleepCallback, SocialApi, SocialQRCodeOptions, SpendCurrencyOptions, StartRoomGameOptions, StorageApi, type StorageType, SubPath, SubmitScoreParams, SubmitScoreResult, Subscription, SystemApi, TimeApi, TriggerRecipeChainOptions, UpdateRoomDataOptions, ValidateMoveResult, ValidateMoveVerdict, VenusMessageId, VenusRoom, base64ToArrayBuffer, base64ToUtf8, computeScoreHash, createMockStorageApi, getLibraryDefinition, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLeaderboard, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializePreloader, initializeProfile, initializeRoomsApi, initializeSimulation, initializeSocial, initializeStackNavigation, initializeStorage, initializeSystem, initializeTime, isPacificDaylightTime, setupRoomNotifications };