@series-inc/venus-sdk 3.0.3 → 3.0.6

package/dist/{AdsApi-CNGRf6j0.d.ts → AdsApi-CIXV8I_p.d.ts}

@@ -56,7 +56,6 @@ declare class RpcClient {
     private addPendingCall;
     private removePendingCall;
     private getPendingCall;
-    private generateId;
     private handleRpcResponse;
     private handleRpcNotification;
 }
@@ -392,12 +391,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 +416,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,83 +765,6 @@ 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;
@@ -668,25 +827,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 +857,7 @@ interface SubmitScoreResult {
     zScore?: number | null;
     isAnomaly?: boolean;
 }
-interface GetLeaderboardOptions {
+interface GetPagedScoresOptions {
     mode?: string;
     period?: string;
     periodDate?: number | string;
@@ -710,9 +873,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 +885,7 @@ interface LeaderboardEntry {
     metadata?: Record<string, any> | null;
     isSeed?: boolean;
 }
-interface LeaderboardResponse {
+interface PagedScoresResponse {
     variant: 'standard' | 'highlight';
     entries: LeaderboardEntry[];
     totalEntries: number;
@@ -730,12 +893,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 +906,7 @@ interface PlayerStats {
     trustScore: number;
     periodInstance: string;
 }
-interface LeaderboardHighlightContext {
+interface PodiumScoresContext {
     topEntries: LeaderboardEntry[];
     beforePlayer: LeaderboardEntry[];
     playerEntry?: LeaderboardEntry | null;
@@ -753,18 +916,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 +981,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 +994,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).
@@ -982,23 +1145,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,35 +1264,46 @@ 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 VenusExecuteRecipeOptions {
+    roomId?: string;
+    batchAmount?: number;
+    allowPartialBatch?: boolean;
+    entity?: string;
+}
+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 VenusConfig {
+    /**
+     * @deprecated Use VenusAPI.getLocale() and VenusAPI.getLanguageCode() instead. Will be removed in v4.0.0
+     * TODO: Remove in SDK v4.0.0
+     */
     user?: {
         id: string;
         username?: string;
@@ -1105,7 +1328,6 @@ interface VenusConfig {
         orientation: string;
         hapticsEnabled: boolean;
     };
-    theme?: Record<string, any>;
     environment?: {
         isDevelopment: boolean;
         platform: string;
@@ -1161,7 +1383,7 @@ interface VenusAPI {
         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;
@@ -1188,6 +1410,8 @@ interface VenusAPI {
     }): Promise<any>;
     getCurrentProfile(): Profile;
     getLaunchParams(): Record<string, string>;
+    getLocale(): string;
+    getLanguageCode(): string;
     /**
      * @deprecated Please use the popups API. (e.g, VenusAPI.popups)
      */
@@ -1320,7 +1544,7 @@ interface VenusAPI {
         isOptional?: boolean;
     }>>;
     cleanupAssets(): void;
-    assetLoader?: {
+    assetLoader: {
         getCached(url: string): string | null;
     };
     showAvatar3dEditorAsync(options: {
@@ -1341,43 +1565,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 +1609,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 SimulationSlotContainer 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 SimulationSlotValidationResult as O, type PushAppOptions as P, type QuitOptions as Q, type RpcRequest as R, type StorageApi as S, type TimeApi as T, type SimulationSubscribeOptions as U, type VenusAPI as V, type SimulationBatchOperation as W, type SimulationBatchOperationsResult as X, type SimulationAvailableItem as Y, type SimulationPowerPreview as Z, type SimulationSlotMutationResult as _, type RpcResponse as a, type InitializationContext as a$, type SimulationAssignment as a0, type SimulationState as a1, type VenusSimulationConfig as a2, type ExecuteRecipeOptions as a3, type ExecuteRecipeResponse as a4, type CollectRecipeResult as a5, type GetActiveRunsOptions as a6, type SimulationRunSummary as a7, type ExecuteScopedRecipeOptions as a8, type ExecuteScopedRecipeResult as a9, type SpendCurrencyOptions as aA, type LoadEmbeddedAssetsResponse as aB, type SharedAssetsApi as aC, type LeaderboardApi as aD, type ScoreToken as aE, type SubmitScoreParams as aF, type SubmitScoreResult as aG, type GetPagedScoresOptions as aH, type PagedScoresResponse as aI, type PlayerRankOptions as aJ, type PlayerRankResult as aK, type GetPodiumScoresOptions as aL, type PodiumScoresResponse as aM, type PreloaderApi as aN, type SocialApi as aO, type ShareMetadata as aP, type ShareLinkResult as aQ, type SocialQRCodeOptions as aR, type QRCodeResult as aS, type Avatar3dApi as aT, type AssetManifest as aU, type Avatar3dConfig as aV, type ShowEditorOptions as aW, type Avatar3dEdits as aX, type AdsApi as aY, type PostApi as aZ, type InitializationOptions as a_, type GetAvailableRecipesOptions as aa, type GetAvailableRecipesResult as ab, type Recipe as ac, type RecipeRequirementResult as ad, type GetBatchRecipeRequirements as ae, type TriggerRecipeChainOptions as af, type RoomDataUpdate as ag, type RoomMessageEvent as ah, type ProposedMoveEvent as ai, VenusTransport as aj, type RoomsApi as ak, type CreateRoomOptions as al, VenusRoom as am, type JoinOrCreateRoomOptions as an, type JoinOrCreateResult as ao, type ListRoomsOptions as ap, type UpdateRoomDataOptions as aq, type RoomMessageRequest as ar, type StartRoomGameOptions as as, type ProposeMoveRequest as at, type ProposeMoveResult as au, type ValidateMoveVerdict as av, type ValidateMoveResult as aw, type RoomSubscriptionOptions as ax, type LoggingApi as ay, type IapApi as az, type RpcNotification as b, type HudInsets as b0, type AiMessage as b1, type Asset as b2, type Category as b3, MockAvatarApi as b4, type TimeIntervalTriggerInput as b5, type NotificationTriggerInput as b6, type OnRequestCallback as b7, type OnResponseCallback as b8, type OnNotificationCallback as b9, type SimulationSnapshotUpdate as bA, type SimulationUpdateData as bB, type VenusSimulationEffect as bC, type VenusSimulationRecipe as bD, type RecipeRequirementQuery as bE, type BatchRecipeRequirementsResult as bF, type VenusExecuteRecipeOptions as bG, type VenusExecuteScopedRecipeOptions as bH, type VenusAvailableRecipe as bI, type VenusCollectRecipeResult as bJ, type VenusExecuteRecipeResult as bK, type VenusConfig as bL, type VenusRoomsConfig as bM, type ActionSheetOption as bN, type RpcTransport as ba, type JoinRoomMatchCriteria as bb, type RoomMessageEventType as bc, type VenusRoomPayload as bd, type RecipeInfo as be, type SimulationPersonalState as bf, type SimulationRoomActiveRecipe as bg, type SimulationRoomState as bh, type SimulationBatchOperationAssign as bi, type SimulationBatchOperationRemove as bj, type SimulationBatchOperationResult as bk, RpcSharedAssetsApi as bl, type LoadEmbeddedAssetsRequest as bm, type LeaderboardModeConfig as bn, type LeaderboardPeriodType as bo, type LeaderboardPeriodConfig as bp, type LeaderboardAntiCheatConfig as bq, type LeaderboardDisplaySettings as br, type LeaderboardConfig as bs, type LeaderboardEntry as bt, type PodiumScoresContext as bu, createHost as bv, type VenusSimulationStateResponse as bw, type SimulationUpdateType as bx, type SimulationEntityUpdate as by, type SimulationActiveRunsUpdate as bz, 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 };