@series-inc/venus-sdk 3.1.2 → 3.2.1-beta.0

package/dist/{AdsApi-CNGRf6j0.d.mts → AdsApi-or6zfdzM.d.mts}

@@ -56,7 +56,6 @@ declare class RpcClient {
     private addPendingCall;
     private removePendingCall;
     private getPendingCall;
-    private generateId;
     private handleRpcResponse;
     private handleRpcNotification;
 }
@@ -162,6 +161,80 @@ interface ProfileApi {
     getCurrentProfile(): Profile;
 }
 
+interface DeviceInfo {
+    readonly screenSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly viewportSize: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly orientation: string;
+    readonly pixelRatio: number;
+    readonly fontScale: number;
+    readonly deviceType: string;
+    readonly hapticsEnabled: boolean;
+    readonly haptics: {
+        readonly supported: boolean;
+        readonly enabled: boolean;
+    };
+}
+interface DeviceApi {
+    getDevice(): DeviceInfo;
+}
+
+interface EnvironmentInfo {
+    readonly isDevelopment: boolean;
+    readonly platform: string;
+    readonly platformVersion: string;
+    readonly browserInfo?: {
+        readonly browser: string;
+        readonly userAgent: string;
+        readonly isMobile: boolean;
+        readonly isTablet: boolean;
+        readonly language: string;
+    };
+}
+interface EnvironmentApi {
+    getEnvironment(): EnvironmentInfo;
+}
+
+/**
+ * System API provides access to device and environment information.
+ * This is a unified namespace for system-level configuration data.
+ */
+interface SystemApi {
+    /**
+     * Get device information (screen size, orientation, capabilities, etc.)
+     * @throws Error if called before VenusAPI.initializeAsync() completes
+     */
+    getDevice(): DeviceInfo;
+    /**
+     * Get environment information (platform, browser, development mode, etc.)
+     * @throws Error if called before VenusAPI.initializeAsync() completes
+     */
+    getEnvironment(): EnvironmentInfo;
+    /**
+     * Get safe area insets (padding to avoid device notches and host UI).
+     * This includes the toolbar/feedHeader height plus device safe areas.
+     * Safe area is static - it's set once during initialization and doesn't change.
+     * @returns SafeArea with top, right, bottom, left padding values in pixels
+     * @throws Error if called before VenusAPI.initializeAsync() completes
+     */
+    getSafeArea(): SafeArea;
+    /**
+     * Check if running on mobile device
+     * @returns true if on mobile device (iOS, Android, or mobile browser)
+     */
+    isMobile(): boolean;
+    /**
+     * Check if running on web platform
+     * @returns true if on web platform
+     */
+    isWeb(): boolean;
+}
+
 type SubPath = string;
 interface FetchBlobOptions {
     timeout?: number;
@@ -200,32 +273,6 @@ interface TimeApi {
     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.
@@ -392,12 +439,12 @@ interface Recipe {
 }
 interface TriggerRecipeChainOptions {
     roomId?: string;
-    context?: any;
+    context?: Record<string, unknown>;
 }
 interface CollectRecipeResult {
     success: boolean;
     runId: string;
-    rewards: any;
+    rewards: Record<string, unknown>;
     message: string;
 }
 interface ExecuteScopedRecipeResult {
@@ -417,28 +464,265 @@ interface GetBatchRecipeRequirements {
     success: boolean;
     results: RecipeRequirementResult[];
 }
+interface SimulationPersonalState {
+    inventory: Record<string, number | string>;
+    activeRuns: SimulationRunSummary[];
+    disabledRecipes: string[];
+}
+interface SimulationRoomActiveRecipe {
+    recipeId: string;
+    scope: 'room' | 'actor';
+    startedAt: number;
+    expiresAt: number;
+    commitmentEndsAt?: number;
+}
+interface SimulationRoomState {
+    activeRecipes: Record<string, SimulationRoomActiveRecipe>;
+    sharedAssets: Record<string, number | string>;
+    actors: Array<Record<string, unknown>>;
+    activeRuns: SimulationRunSummary[];
+}
+type SimulationState = SimulationPersonalState | SimulationRoomState;
+interface SimulationSlotContainer {
+    entityId: string;
+    slots: Record<string, unknown>;
+    isOwned: boolean;
+    powerCalculationRecipe?: string;
+}
+interface SimulationAvailableItem {
+    entityId: string;
+    quantity: number;
+    metadata: Record<string, unknown>;
+    tags: string[];
+    isCompatible: boolean;
+}
+interface SimulationSlotValidationResult {
+    valid: boolean;
+    error?: string;
+}
+interface SimulationAssignment {
+    id: string;
+    containerId: string;
+    slotId: string;
+    itemId: string | null;
+    profileId: string;
+    appId: string;
+    createdAt: number;
+    metadata?: Record<string, unknown>;
+}
+interface SimulationSlotMutationResult {
+    success: boolean;
+    error?: string;
+    association?: SimulationAssignment;
+}
+interface SimulationBatchOperationAssign {
+    type: 'assign';
+    containerId: string;
+    slotId: string;
+    itemId: string;
+}
+interface SimulationBatchOperationRemove {
+    type: 'remove';
+    containerId: string;
+    slotId: string;
+    itemId?: string;
+}
+type SimulationBatchOperation = SimulationBatchOperationAssign | SimulationBatchOperationRemove;
+interface SimulationBatchOperationResult {
+    success: boolean;
+    error?: string;
+    association?: SimulationAssignment;
+    operation: SimulationBatchOperation;
+}
+interface SimulationBatchOperationsResult {
+    success: boolean;
+    results: SimulationBatchOperationResult[];
+    affectedContainers: string[];
+}
+interface SimulationPowerPreview {
+    currentPower: number;
+    previewPower: number;
+    powerDelta: number;
+    breakdown: Record<string, number>;
+}
+interface ExecuteRecipeResponse {
+    success: boolean;
+    status?: string;
+    runId?: string;
+    expiresAt?: string;
+    queuePosition?: number;
+    outputs?: Record<string, number | string>;
+    data?: Record<string, unknown>;
+    message?: string;
+    amountRequested?: number;
+    amountFulfilled?: number;
+    partialSuccess?: boolean;
+}
 interface SimulationApi {
-    getStateAsync(roomId?: string): Promise<any>;
+    isEnabled(): boolean;
+    getStateAsync(roomId?: string): Promise<SimulationState>;
     getConfigAsync(roomId?: string): Promise<VenusSimulationConfig>;
-    executeRecipeAsync(recipeId: string, inputs?: any, options?: ExecuteRecipeOptions): Promise<any>;
-    getActiveRunsAsync(options?: GetActiveRunsOptions): Promise<any>;
+    executeRecipeAsync(recipeId: string, inputs?: Record<string, unknown>, options?: ExecuteRecipeOptions): Promise<ExecuteRecipeResponse>;
+    getActiveRunsAsync(options?: GetActiveRunsOptions): Promise<SimulationRunSummary[]>;
     collectRecipeAsync(runId: string): Promise<CollectRecipeResult>;
-    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: any, options?: ExecuteScopedRecipeOptions | any): Promise<ExecuteScopedRecipeResult>;
-    triggerRecipeChainAsync(recipeId: string, options?: TriggerRecipeChainOptions): Promise<any>;
+    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: Record<string, unknown>, options?: ExecuteScopedRecipeOptions): Promise<ExecuteScopedRecipeResult>;
+    triggerRecipeChainAsync(recipeId: string, options?: TriggerRecipeChainOptions): Promise<ExecuteRecipeResponse>;
     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>;
+    resolveFieldValueAsync(entityId: string, fieldPath: string, entity?: string): Promise<unknown>;
+    getEntityMetadataAsync(entityId: string): Promise<Record<string, unknown>>;
+    getSlotContainersAsync(): Promise<SimulationSlotContainer[]>;
+    getSlotAssignmentsAsync(containerId: string): Promise<SimulationAssignment[]>;
+    assignItemToSlotAsync(containerId: string, slotId: string, itemId: string): Promise<SimulationSlotMutationResult>;
+    removeItemFromSlotAsync(containerId: string, slotId: string): Promise<SimulationSlotMutationResult>;
+    getAvailableItemsAsync(containerId: string, slotId: string): Promise<SimulationAvailableItem[]>;
+    calculatePowerPreviewAsync(containerId: string, slotId: string, candidateItemId: string): Promise<SimulationPowerPreview>;
+    validateSlotAssignmentAsync(containerId: string, slotId: string, itemId: string): Promise<SimulationSlotValidationResult>;
+    executeBatchOperationsAsync(operations: Array<SimulationBatchOperation>, validateOnly?: boolean): Promise<SimulationBatchOperationsResult>;
+    subscribeAsync(options: SimulationSubscribeOptions): Promise<() => void>;
+}
+
+interface VenusRoomPayload extends Record<string, unknown> {
+    id: string;
+    name?: string;
+    currentPlayers?: string[];
+    maxPlayers?: number;
+    gameType?: string;
+    appId?: string;
+    type?: string;
+    createdBy?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    isPrivate?: boolean;
+    status?: string;
+    customMetadata?: Record<string, unknown>;
+    admins?: string[];
+    roomCode?: string;
+    description?: string;
+    data?: Record<string, unknown>;
+    version?: string;
+}
+declare class VenusRoom {
+    readonly id: string;
+    name?: string;
+    players: string[];
+    maxPlayers?: number;
+    gameType?: string;
+    appId?: string;
+    type?: string;
+    createdBy?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    isPrivate?: boolean;
+    status?: string;
+    customMetadata: Record<string, unknown>;
+    admins: string[];
+    roomCode?: string;
+    description?: string;
+    data: Record<string, unknown>;
+    version?: string;
+    constructor(roomData: VenusRoomPayload);
+}
+
+interface CreateRoomOptions {
+    maxPlayers?: number;
+    gameType?: string;
+    isPrivate?: boolean;
+    roomCode?: string;
+    name?: string;
+    description?: string;
+    customMetadata?: Record<string, unknown>;
+    data?: Record<string, unknown>;
+}
+interface JoinRoomMatchCriteria {
+    isPrivate?: boolean;
+    hasSpace?: boolean;
+    gameType?: string;
+    [key: string]: unknown;
+}
+interface JoinOrCreateRoomOptions {
+    matchCriteria?: JoinRoomMatchCriteria;
+    createOptions: CreateRoomOptions;
+}
+interface JoinOrCreateResult {
+    action: 'created' | 'joined';
+    room: VenusRoom;
+    playersJoined: number;
+}
+interface ListRoomsOptions {
+    includeArchived?: boolean;
+}
+interface RoomDataUpdate {
+    type: 'H5_ROOM_DATA_UPDATED';
+    roomId: string;
+    roomData: Record<string, unknown>;
+    timestamp?: number;
+}
+type RoomMessageEventType = 'H5_ROOM_MESSAGE_RECEIVED' | 'H5_ROOM_MESSAGE_UPDATED' | 'H5_ROOM_MESSAGE_DELETED';
+interface RoomMessageEvent {
+    type: RoomMessageEventType;
+    roomId: string;
+    message: Record<string, unknown>;
+    timestamp?: number;
+}
+interface ProposedMoveEvent {
+    type: 'app:h5:proposedMoveValidationUpdated';
+    roomId: string;
+    proposedMoveData: Record<string, unknown>;
+    proposedMoveId?: string;
+    changeType?: string;
+    timestamp?: number;
+}
+interface RoomSubscriptionOptions {
+    onData?: (event: RoomDataUpdate) => void;
+    onMessages?: (event: RoomMessageEvent) => void;
+    onGameEvents?: (event: ProposedMoveEvent) => void;
+}
+interface ProposeMoveRequest {
+    gameSpecificState: Record<string, unknown>;
+    moveType: string;
+    clientContext?: Record<string, unknown>;
+    clientProposalId?: string;
+}
+interface ProposeMoveResult {
+    proposedMoveId: string;
+}
+interface ValidateMoveVerdict {
+    isValid: boolean;
+    reason?: string | null;
+    validatorId?: string | null;
+}
+interface ValidateMoveResult {
+    success: boolean;
+    moveId: string;
+    isValid: boolean;
+    reason?: string | null;
+}
+interface UpdateRoomDataOptions {
+    merge?: boolean;
+}
+interface RoomMessageRequest {
+    message: Record<string, unknown>;
+    metadata?: Record<string, unknown>;
+}
+interface StartRoomGameOptions {
+    gameConfig?: Record<string, unknown>;
+    turnOrder?: string[] | null;
+}
+interface RoomsApi {
+    createRoomAsync(options: CreateRoomOptions): Promise<VenusRoom>;
+    joinOrCreateRoomAsync(options: JoinOrCreateRoomOptions): Promise<JoinOrCreateResult>;
+    joinRoomByCodeAsync(roomCode: string): Promise<VenusRoom>;
+    getUserRoomsAsync(options?: ListRoomsOptions): Promise<VenusRoom[]>;
+    subscribeAsync(room: VenusRoom, options?: RoomSubscriptionOptions): Promise<() => void>;
+    updateRoomDataAsync(room: VenusRoom, updates: Record<string, unknown>, options?: UpdateRoomDataOptions): Promise<void>;
+    getRoomDataAsync(room: VenusRoom): Promise<Record<string, unknown>>;
+    sendRoomMessageAsync(room: VenusRoom, message: RoomMessageRequest): Promise<string>;
+    leaveRoomAsync(room: VenusRoom): Promise<void>;
+    startRoomGameAsync(room: VenusRoom, options?: StartRoomGameOptions): Promise<void>;
+    proposeMoveAsync(room: VenusRoom, request: ProposeMoveRequest): Promise<ProposeMoveResult>;
+    validateMoveAsync(room: VenusRoom, moveId: string, verdict: ValidateMoveVerdict): Promise<ValidateMoveResult>;
 }
 
 interface VenusMessage {
@@ -529,99 +813,20 @@ declare class VenusTransport implements RpcTransport {
     private notifyVenusMessageReceived;
 }
 
-declare class VenusRoom {
-    readonly id: string;
-    name: string;
-    players: any[];
-    maxPlayers: number;
-    gameType: string;
-    appId: string;
-    type: any;
-    createdBy: string;
-    createdAt: number;
-    updatedAt: number;
-    isPrivate: boolean;
-    currentPlayers: string[];
-    status: any;
-    customMetadata: Record<string, any>;
-    admins: string[];
-    roomCode: string;
-    description: string;
-    data: Record<string, any>;
-    version: string;
-    private _subscriptions;
-    constructor(roomData: any);
-    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>;
+    loadAssetsBundle(game: string, bundleKey: string): Promise<ArrayBuffer>;
 }
 
 declare class RpcSharedAssetsApi implements SharedAssetsApi {
     private readonly venusApi;
     private readonly rpcClient;
     constructor(rpcClient: RpcClient, venusApi: VenusAPI);
-    loadBurgerTimeAssetsBundle(): Promise<ArrayBuffer>;
-    loadCharactersBundle(): Promise<ArrayBuffer>;
+    loadAssetsBundle(game: string, bundleKey: string, fileType?: string): Promise<ArrayBuffer>;
 }
 interface LoadEmbeddedAssetsRequest {
     assetKey: string;
@@ -668,25 +873,29 @@ interface LeaderboardConfig {
     maxDurationSec: number;
     minScore: number;
     maxScore: number;
-    requiresHash: boolean;
-    scoringFields: string[];
+    requiresToken: boolean;
+    enableScoreSealing: boolean;
+    scoreSealingSecret?: string;
     modes: Record<string, LeaderboardModeConfig>;
     periods: Record<string, LeaderboardPeriodConfig>;
     antiCheat: LeaderboardAntiCheatConfig;
     displaySettings: LeaderboardDisplaySettings;
 }
-interface StartRunResult {
-    sessionId: string;
+interface ScoreToken {
+    token: string;
     startTime: number;
     expiresAt: number;
-    hashNonce?: string | null;
+    sealingNonce?: string | null;
+    sealingSecret?: string | null;
     mode: string;
 }
-interface SubmitScoreOptions {
+interface SubmitScoreParams {
+    token?: string;
+    score: number;
+    duration: number;
     mode?: string;
     telemetry?: Record<string, any>;
     metadata?: Record<string, any>;
-    hash?: string;
 }
 interface SubmitScoreResult {
     accepted: boolean;
@@ -694,7 +903,7 @@ interface SubmitScoreResult {
     zScore?: number | null;
     isAnomaly?: boolean;
 }
-interface GetLeaderboardOptions {
+interface GetPagedScoresOptions {
     mode?: string;
     period?: string;
     periodDate?: number | string;
@@ -710,9 +919,9 @@ interface LeaderboardEntry {
     username: string;
     avatarUrl: string | null;
     score: number;
-    durationSec: number;
+    duration: number;
     submittedAt: number;
-    sessionId?: string;
+    token?: string;
     rank: number | null;
     zScore?: number | null;
     isAnomaly?: boolean;
@@ -722,7 +931,7 @@ interface LeaderboardEntry {
     metadata?: Record<string, any> | null;
     isSeed?: boolean;
 }
-interface LeaderboardResponse {
+interface PagedScoresResponse {
     variant: 'standard' | 'highlight';
     entries: LeaderboardEntry[];
     totalEntries: number;
@@ -730,12 +939,12 @@ interface LeaderboardResponse {
     playerRank: number | null;
     periodInstance: string;
 }
-interface PlayerStatsOptions {
+interface PlayerRankOptions {
     mode?: string;
     period?: string;
     periodDate?: number | string;
 }
-interface PlayerStats {
+interface PlayerRankResult {
     rank: number | null;
     score?: number;
     totalPlayers: number;
@@ -743,7 +952,7 @@ interface PlayerStats {
     trustScore: number;
     periodInstance: string;
 }
-interface LeaderboardHighlightContext {
+interface PodiumScoresContext {
     topEntries: LeaderboardEntry[];
     beforePlayer: LeaderboardEntry[];
     playerEntry?: LeaderboardEntry | null;
@@ -753,18 +962,18 @@ interface LeaderboardHighlightContext {
     omittedBefore: number;
     omittedAfter: number;
 }
-interface LeaderboardHighlightResponse extends LeaderboardResponse {
+interface PodiumScoresResponse extends PagedScoresResponse {
     variant: 'highlight';
-    context: LeaderboardHighlightContext;
+    context: PodiumScoresContext;
 }
-interface LeaderboardHighlightOptions extends Omit<GetLeaderboardOptions, 'variant'> {
+interface GetPodiumScoresOptions extends Omit<GetPagedScoresOptions, '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>;
+    createScoreToken(mode?: string): Promise<ScoreToken>;
+    submitScore(params: SubmitScoreParams): Promise<SubmitScoreResult>;
+    getPagedScores(options?: GetPagedScoresOptions): Promise<PagedScoresResponse>;
+    getMyRank(options?: PlayerRankOptions): Promise<PlayerRankResult>;
+    getPodiumScores(options?: GetPodiumScoresOptions): Promise<PodiumScoresResponse>;
 }
 
 interface PreloaderApi {
@@ -818,7 +1027,7 @@ interface SocialApi {
      * - 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.launchParams Arbitrary launch parameters for your game.
      * @param options.metadata Optional OpenGraph metadata for rich previews.
      * @returns The generated share URL.
      */
@@ -831,7 +1040,7 @@ interface SocialApi {
      *
      * 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.launchParams Arbitrary launch parameters for your game.
      * @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).
@@ -843,12 +1052,20 @@ interface SocialApi {
     }): Promise<QRCodeResult>;
 }
 
-interface HudInsets {
+/**
+ * Safe area insets representing padding needed to avoid device notches and host UI.
+ * Includes toolbar/feedHeader height + device safe areas.
+ */
+interface SafeArea {
     left: number;
     top: number;
     right: number;
     bottom: number;
 }
+/**
+ * @deprecated Use SafeArea instead. Will be removed in v4.0.0
+ */
+type HudInsets = SafeArea;
 interface InitializationOptions {
     helpText?: string;
     hardDisableMock?: boolean;
@@ -856,7 +1073,11 @@ interface InitializationOptions {
     usePreloader?: boolean;
 }
 interface InitializationContext {
-    hudInsets?: HudInsets;
+    /**
+     * Safe area insets from INIT_SDK response.
+     * @deprecated Use VenusAPI.system.getSafeArea() instead. Will be removed in v4.0.0
+     */
+    safeArea?: SafeArea;
     initializeAsleep: boolean;
 }
 interface Host {
@@ -870,9 +1091,9 @@ interface 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;
@@ -982,23 +1203,72 @@ interface RecipeRequirementResult {
     recipeId: string;
     entity: string | null;
     amount?: number;
-    inputs: Record<string, any>;
+    inputs: Record<string, number | string>;
     canAfford: boolean;
     disabled: boolean;
 }
-interface VenusSimulationState {
-    inventory: Record<string, number | string>;
+interface SimulationRunSummary {
+    id: string;
+    recipeId: string;
+    status: string;
+    startTime: number;
+    expiresAt: number;
+    entity?: string;
+    inputs?: Record<string, number | string>;
+    outputs?: Record<string, number | string>;
+    commitmentEndsAt?: number;
+    participantCount?: number;
+}
+type VenusSimulationStateResponse = SimulationPersonalState | SimulationRoomState;
+type SimulationUpdateType = 'entity' | 'activeRuns' | 'snapshot';
+interface SimulationUpdateBase {
+    timestamp: number;
+    reason?: 'recipe_completed' | 'auto_restart' | 'manual_update' | 'state_sync';
+}
+interface SimulationEntityUpdate extends SimulationUpdateBase {
+    type: 'entity';
+    entities: Array<{
+        entityId: string;
+        quantity: number | string;
+    }>;
+}
+interface SimulationActiveRunsUpdate extends SimulationUpdateBase {
+    type: 'activeRuns';
     activeRuns: Array<{
         id: string;
         recipeId: string;
         status: string;
         startTime: number;
         expiresAt: number;
+        entity?: string;
         inputs?: Record<string, number | string>;
         outputs?: Record<string, number | string>;
+    }>;
+}
+interface SimulationSnapshotUpdate extends SimulationUpdateBase {
+    type: 'snapshot';
+    entities?: Array<{
+        entityId: string;
+        quantity: number | string;
+    }>;
+    activeRuns?: Array<{
+        id: string;
+        recipeId: string;
+        status: string;
+        startTime: number;
+        expiresAt: number;
         entity?: string;
+        inputs?: Record<string, number | string>;
+        outputs?: Record<string, number | string>;
     }>;
-    disabledRecipes: string[];
+}
+type SimulationUpdateData = SimulationEntityUpdate | SimulationActiveRunsUpdate | SimulationSnapshotUpdate;
+interface SimulationSubscribeOptions {
+    entities?: string[];
+    tags?: string[];
+    activeRuns?: boolean;
+    roomId?: string;
+    onUpdate: (data: SimulationUpdateData) => void;
 }
 interface VenusSimulationEffect {
     type: string;
@@ -1052,93 +1322,40 @@ interface RecipeRequirementQuery {
 interface BatchRecipeRequirementsResult {
     success: boolean;
     results: RecipeRequirementResult[];
-    errors?: Array<any>;
+    errors?: Array<unknown>;
 }
-interface VenusSimulationAPI {
-    isEnabled(): boolean;
-    getStateAsync(options?: {
-        roomId?: string;
-    }): Promise<VenusSimulationState>;
-    getConfigAsync(): Promise<VenusSimulationConfig>;
-    executeRecipeAsync(recipeId: string, inputs?: Record<string, any>, options?: any): Promise<any>;
-    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: Record<string, any>, roomId?: string, options?: any): Promise<any>;
-    getActiveRunsAsync(): Promise<any[]>;
-    collectRecipeAsync(runId: string): Promise<any>;
-    triggerRecipeChainAsync(triggerRecipeId: string, context?: any, roomId?: string): Promise<any>;
-    getRecipeRequirementsAsync(recipeId: string, entity?: string, amount?: number): Promise<RecipeRequirementResult>;
-    getBatchRecipeRequirementsAsync(queries: RecipeRequirementQuery[]): Promise<BatchRecipeRequirementsResult>;
-    getAvailableRecipesAsync(roomId?: string, includeActorRecipes?: boolean): Promise<Array<any>>;
-    resolveFieldValueAsync(entityId: string, fieldPath: string, entity?: string): Promise<any>;
-    getEntityMetadataAsync(entityId: string): Promise<any>;
-    getSlotContainersAsync(): Promise<Array<any>>;
-    getSlotAssignmentsAsync(containerId: string): Promise<Array<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 VenusConfig {
-    user?: {
-        id: string;
-        username?: string;
-        languageCode: string;
-        locale: string;
-    };
-    profile?: {
-        id: string;
-        username: string;
-        avatarUrl?: string;
-        isAnonymous?: boolean;
-    };
-    device?: {
-        screenSize: {
-            width: number;
-            height: number;
-        };
-        viewportSize: {
-            width: number;
-            height: number;
-        };
-        orientation: string;
-        hapticsEnabled: boolean;
-    };
-    theme?: Record<string, any>;
-    environment?: {
-        isDevelopment: boolean;
-        platform: string;
-        platformVersion: string;
-        browserInfo?: {
-            browser: string;
-            isMobile: boolean;
-        };
-    };
-    ui: {
-        safeArea: {
-            top: number;
-            left: number;
-            right: number;
-            bottom: number;
-        };
-        controls: Record<string, any>;
-    };
-    rooms?: VenusRoomsConfig;
+interface VenusExecuteRecipeOptions {
+    roomId?: string;
+    batchAmount?: number;
+    allowPartialBatch?: boolean;
+    entity?: string;
 }
-interface VenusRoomsConfig {
-    gameType?: string;
-    rulesPreset?: string;
-    matchmaking?: {
-        defaultCriteria?: Record<string, any>;
-        [key: string]: any;
-    };
-    createOptions?: Record<string, any>;
-    privateMatchDefaults?: {
-        createOptions?: Record<string, any>;
-        allowCustomCode?: boolean;
-    };
-    [key: string]: any;
+interface VenusExecuteScopedRecipeOptions {
+    roomId?: string;
+}
+interface VenusAvailableRecipe {
+    id: string;
+    scope: string;
+    clientViewable: boolean;
+}
+interface VenusCollectRecipeResult {
+    success: boolean;
+    runId: string;
+    rewards: Record<string, unknown>;
+    message: string;
+}
+interface VenusExecuteRecipeResult {
+    success: boolean;
+    status?: string;
+    runId?: string;
+    expiresAt?: string;
+    queuePosition?: number;
+    outputs?: Record<string, number | string>;
+    data?: Record<string, unknown>;
+    message?: string;
+    amountRequested?: number;
+    amountFulfilled?: number;
+    partialSuccess?: boolean;
 }
 interface ActionSheetOption {
     label: string;
@@ -1153,20 +1370,36 @@ interface Profile {
     isAnonymous?: boolean;
 }
 interface VenusAPI {
-    config: VenusConfig;
+    /**
+     * @deprecated All config properties have been removed. Use VenusAPI methods instead.
+     * Will be removed in v4.0.0
+     */
+    config: Record<string, never>;
     launchParams: Record<string, string>;
+    _profileData?: Profile;
+    _deviceData?: DeviceInfo;
+    _environmentData?: EnvironmentInfo;
+    _safeAreaData?: SafeArea;
+    _localeData?: string;
+    _languageCodeData?: string;
     _mock: any;
     _bootstrap: {
         apiInjected: boolean;
         venus: any;
     };
     initializeAsync(options?: InitializationOptions): Promise<InitializationContext>;
-    simulation: VenusSimulationAPI;
+    simulation: SimulationApi;
     leaderboard: LeaderboardApi;
     log(message: string, ...args: any[]): void;
     error(message: string, ...args: any[]): void;
     isAvailable(): boolean;
+    /**
+     * @deprecated Use VenusAPI.system.isMobile() instead
+     */
     isMobile(): boolean;
+    /**
+     * @deprecated Use VenusAPI.system.isWeb() instead
+     */
     isWeb(): boolean;
     isMock(): boolean;
     /**
@@ -1186,8 +1419,15 @@ interface VenusAPI {
     getFeatureGate(options: {
         gateName: string;
     }): Promise<any>;
+    system: SystemApi;
+    getProfile(): Profile;
+    /**
+     * @deprecated Use getProfile() instead
+     */
     getCurrentProfile(): Profile;
     getLaunchParams(): Record<string, string>;
+    getLocale(): string;
+    getLanguageCode(): string;
     /**
      * @deprecated Please use the popups API. (e.g, VenusAPI.popups)
      */
@@ -1258,11 +1498,6 @@ interface VenusAPI {
         key(index: number): Promise<string | null>;
     };
     requestPopOrQuit(options?: QuitOptions): Promise<boolean>;
-    getPostInteractionsAsync(): Promise<any>;
-    getPostInteractions(): Promise<any>;
-    toggleLikeAsync(): Promise<any>;
-    toggleFollowAsync(): Promise<any>;
-    openCommentsAsync(options?: any): Promise<void>;
     /**
      * @deprecated Please use the ads API. (e.g, VenusAPI.ads)
      */
@@ -1271,16 +1506,8 @@ interface VenusAPI {
      * @deprecated Please use the ads API. (e.g, VenusAPI.ads)
      */
     showRewardedAdAsync(): Promise<boolean>;
-    requestTimeAsync(): Promise<{
-        serverTime: number;
-    }>;
-    getFutureTimeAsync(options: {
-        days?: number;
-        hours?: number;
-        minutes?: number;
-        timeOfDay?: any;
-        timezone?: string;
-    }): Promise<number>;
+    requestTimeAsync(): Promise<ServerTimeData>;
+    getFutureTimeAsync(options: GetFutureTimeOptions): Promise<number>;
     formatTime(timestamp: number, options?: any): string;
     formatNumber(value: number, options?: any): string;
     /**
@@ -1320,7 +1547,7 @@ interface VenusAPI {
         isOptional?: boolean;
     }>>;
     cleanupAssets(): void;
-    assetLoader?: {
+    assetLoader: {
         getCached(url: string): string | null;
     };
     showAvatar3dEditorAsync(options: {
@@ -1341,43 +1568,22 @@ interface VenusAPI {
         isInStack: boolean;
         stackPosition: number;
     };
-    rooms: {
-        create(options: any): Promise<VenusRoom>;
-        joinOrCreate(options: any): Promise<{
-            action: 'created' | 'joined';
-            room: VenusRoom;
-            playersJoined: number;
-        }>;
-        joinByCode(roomCode: string): Promise<VenusRoom>;
-        list(includeArchived?: boolean): Promise<VenusRoom[]>;
-        subscribeToRoom(room: VenusRoom, options: {
-            onData?: (event: any) => void;
-            onMessages?: (event: any) => void;
-            onMoves?: (event: any) => void;
-            onGameEvents?: (event: any) => void;
-        }): () => void;
-        proposeMove(room: VenusRoom, proposalPayload: {
-            gameSpecificState: any;
-            moveType: string;
-            clientContext?: Record<string, any>;
-            clientProposalId?: string;
-        }): Promise<{
-            proposedMoveId: string;
-        }>;
-        validateMove(room: VenusRoom, moveId: string, isValid: boolean, reason?: string, validatorId?: string): Promise<any>;
-        updateRoomData(room: VenusRoom, updates: any, merge?: boolean): Promise<any>;
-        getRoomData(room: VenusRoom): Promise<any>;
-        sendRoomMessage(room: VenusRoom, messageData: any): Promise<string>;
-        startRoomGame(room: VenusRoom, gameConfig?: any, turnOrder?: any): Promise<any>;
-        leaveRoom(room: VenusRoom): Promise<any>;
-    };
+    rooms: RoomsApi;
     notifyCleanupComplete(): void;
     RoomEvents: {
         OPTIMISTIC_GAME_STATE_UPDATED: string;
         PROPOSED_MOVE_VALIDATION_UPDATED: string;
     };
-    numbers?: {
-        normalize(value: string | number): string;
+    numbers: {
+        isBigNumber(value: any): boolean;
+        normalize(value: string | number | any): any;
+        format: {
+            incremental(value: any): string;
+        };
+        calculateGeometricSeriesCost(baseCost: number | string, multiplier: number, currentQuantity: number, purchaseAmount: number): any;
+        calculateMaxAffordableDecimal(availableCash: number | string, baseCost: number | string, multiplier: number, currentQuantity: number): number;
+        formatDecimalCurrency(decimalValue: any): string;
+        Decimal: any;
     };
     iap: IapApi;
     cdn: CdnApi;
@@ -1406,4 +1612,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-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 SocialApi as ak, type ShareMetadata as al, type ShareLinkResult as am, type SocialQRCodeOptions as an, type QRCodeResult as ao, type Avatar3dApi as ap, type AssetManifest as aq, type Avatar3dConfig as ar, type ShowEditorOptions as as, type Avatar3dEdits 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, createHost as b1, type VenusSimulationState as b2, type VenusSimulationEffect as b3, type VenusSimulationRecipe as b4, type RecipeRequirementQuery as b5, type BatchRecipeRequirementsResult as b6, type VenusSimulationAPI as b7, type VenusConfig as b8, type VenusRoomsConfig as b9, type ActionSheetOption as ba, 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 };
+export { type SubPath as $, type ActionSheetOption as A, type BatchRecipeRequirementsResult as B, type ScheduleLocalNotification as C, type ScheduleNotificationOptions as D, type PopupsApi as E, type ActionSheetItem as F, type ShowActionSheetOptions as G, type Host as H, type ShowAlertOptions as I, type ShowConfirmOptions as J, type ShowToastOptions as K, type ShowInterstitialAdOptions as L, type ShowRewardedAdOptions as M, type NavigationApi as N, type ProfileApi as O, type Profile as P, type QuitOptions as Q, type RecipeRequirementResult as R, type SimulationRunSummary as S, type DeviceApi as T, type DeviceInfo as U, type VenusAPI as V, type EnvironmentApi as W, type EnvironmentInfo as X, type SystemApi as Y, type SafeArea as Z, type CdnApi as _, type VenusSimulationStateResponse as a, type SubmitScoreParams as a$, type FetchBlobOptions as a0, type TimeApi as a1, type ServerTimeData as a2, type GetFutureTimeOptions as a3, type AiApi as a4, type AiChatCompletionRequest as a5, type AiChatCompletionData as a6, type HapticsApi as a7, HapticFeedbackStyle as a8, type FeaturesApi as a9, type Recipe as aA, type GetBatchRecipeRequirements as aB, type TriggerRecipeChainOptions as aC, type RoomDataUpdate as aD, type RoomMessageEvent as aE, type ProposedMoveEvent as aF, VenusTransport as aG, type RoomsApi as aH, type CreateRoomOptions as aI, type JoinOrCreateRoomOptions as aJ, type JoinOrCreateResult as aK, type ListRoomsOptions as aL, type UpdateRoomDataOptions as aM, type RoomMessageRequest as aN, type StartRoomGameOptions as aO, type ProposeMoveRequest as aP, type ProposeMoveResult as aQ, type ValidateMoveVerdict as aR, type ValidateMoveResult as aS, type RoomSubscriptionOptions as aT, type LoggingApi as aU, type IapApi as aV, type SpendCurrencyOptions as aW, type LoadEmbeddedAssetsResponse as aX, type SharedAssetsApi as aY, type LeaderboardApi as aZ, type ScoreToken as a_, type Experiment as aa, type LifecycleApi as ab, type SleepCallback as ac, type Subscription as ad, type AwakeCallback as ae, type PauseCallback as af, type ResumeCallback as ag, type QuitCallback as ah, type SimulationApi as ai, type SimulationSlotValidationResult as aj, type SimulationBatchOperation as ak, type SimulationBatchOperationsResult as al, type SimulationAvailableItem as am, type SimulationPowerPreview as an, type SimulationSlotMutationResult as ao, type SimulationSlotContainer as ap, type SimulationAssignment as aq, type SimulationState as ar, type ExecuteRecipeOptions as as, type ExecuteRecipeResponse as at, type CollectRecipeResult as au, type GetActiveRunsOptions as av, type ExecuteScopedRecipeOptions as aw, type ExecuteScopedRecipeResult as ax, type GetAvailableRecipesOptions as ay, type GetAvailableRecipesResult as az, type SimulationUpdateType as b, type SubmitScoreResult as b0, type GetPagedScoresOptions as b1, type PagedScoresResponse as b2, type PlayerRankOptions as b3, type PlayerRankResult as b4, type GetPodiumScoresOptions as b5, type PodiumScoresResponse as b6, type PreloaderApi as b7, type SocialApi as b8, type ShareMetadata as b9, type SimulationRoomActiveRecipe as bA, type SimulationRoomState as bB, type SimulationBatchOperationAssign as bC, type SimulationBatchOperationRemove as bD, type SimulationBatchOperationResult as bE, RpcSharedAssetsApi as bF, type LoadEmbeddedAssetsRequest as bG, type LeaderboardModeConfig as bH, type LeaderboardPeriodType as bI, type LeaderboardPeriodConfig as bJ, type LeaderboardAntiCheatConfig as bK, type LeaderboardDisplaySettings as bL, type LeaderboardConfig as bM, type LeaderboardEntry as bN, type PodiumScoresContext as bO, type HudInsets as bP, createHost as bQ, type ShareLinkResult as ba, type SocialQRCodeOptions as bb, type QRCodeResult as bc, type Avatar3dApi as bd, type AssetManifest as be, type Avatar3dConfig as bf, type ShowEditorOptions as bg, type Avatar3dEdits as bh, type AdsApi as bi, type InitializationOptions as bj, type InitializationContext as bk, type AiMessage as bl, type Asset as bm, type Category as bn, MockAvatarApi as bo, type TimeIntervalTriggerInput as bp, type NotificationTriggerInput as bq, type OnRequestCallback as br, type OnResponseCallback as bs, type OnNotificationCallback as bt, type RpcTransport as bu, type JoinRoomMatchCriteria as bv, type RoomMessageEventType as bw, type VenusRoomPayload as bx, type RecipeInfo as by, type SimulationPersonalState as bz, type SimulationEntityUpdate as c, type SimulationActiveRunsUpdate as d, type SimulationSnapshotUpdate as e, type SimulationUpdateData as f, type SimulationSubscribeOptions as g, type VenusSimulationEffect as h, type VenusSimulationRecipe as i, type VenusSimulationConfig as j, type RecipeRequirementQuery as k, type VenusExecuteRecipeOptions as l, type VenusExecuteScopedRecipeOptions as m, type VenusAvailableRecipe as n, type VenusCollectRecipeResult as o, type VenusExecuteRecipeResult as p, VenusRoom as q, type AnalyticsApi 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 NotificationsApi as z };