@series-inc/venus-sdk 3.1.1-beta.0 → 3.1.1

package/dist/{AdsApi-meVfUcZy.d.mts → AdsApi-BV_VKgMO.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,83 +813,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;
@@ -849,12 +1056,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;
@@ -862,7 +1077,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 {
@@ -876,9 +1095,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;
@@ -988,23 +1207,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;
@@ -1058,97 +1326,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 {
-    /**
-     * @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;
-        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;
@@ -1163,20 +1374,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;
     /**
@@ -1196,6 +1423,11 @@ interface VenusAPI {
     getFeatureGate(options: {
         gateName: string;
     }): Promise<any>;
+    system: SystemApi;
+    getProfile(): Profile;
+    /**
+     * @deprecated Use getProfile() instead
+     */
     getCurrentProfile(): Profile;
     getLaunchParams(): Record<string, string>;
     getLocale(): string;
@@ -1270,11 +1502,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)
      */
@@ -1283,16 +1510,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;
     /**
@@ -1332,7 +1551,7 @@ interface VenusAPI {
         isOptional?: boolean;
     }>>;
     cleanupAssets(): void;
-    assetLoader?: {
+    assetLoader: {
         getCached(url: string): string | null;
     };
     showAvatar3dEditorAsync(options: {
@@ -1353,43 +1572,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;
@@ -1418,4 +1616,4 @@ interface AdsApi {
     showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
 }
 
-export { type AwakeCallback as $, type ActionSheetOption as A, type BatchRecipeRequirementsResult as B, type ShowRewardedAdOptions as C, type ProfileApi as D, type CdnApi as E, type SubPath as F, type FetchBlobOptions as G, type Host as H, type ServerTimeData as I, type GetFutureTimeOptions as J, type AiApi as K, type AiChatCompletionRequest as L, type AiChatCompletionData as M, type NavigationApi as N, type HapticsApi as O, type Profile as P, type QuitOptions as Q, type RecipeRequirementResult as R, type StorageApi as S, type TimeApi as T, HapticFeedbackStyle as U, type VenusAPI as V, type FeaturesApi as W, type Experiment as X, type LifecycleApi as Y, type SleepCallback as Z, type Subscription as _, type VenusSimulationState as a, type RecipeInfo as a$, type PauseCallback as a0, type ResumeCallback as a1, type QuitCallback as a2, type SimulationApi as a3, type ExecuteRecipeOptions as a4, type CollectRecipeResult as a5, type GetActiveRunsOptions as a6, type ExecuteScopedRecipeResult as a7, type GetAvailableRecipesOptions as a8, type GetAvailableRecipesResult as a9, type AssetManifest as aA, type Avatar3dConfig as aB, type ShowEditorOptions as aC, type Avatar3dEdits as aD, type AdsApi as aE, type PostApi as aF, type RoomsApi as aG, type InitializationOptions as aH, type InitializationContext as aI, type HudInsets as aJ, type AiMessage as aK, type Asset as aL, type Category as aM, MockAvatarApi as aN, type TimeIntervalTriggerInput as aO, type NotificationTriggerInput as aP, type OnRequestCallback as aQ, type OnResponseCallback as aR, type OnNotificationCallback as aS, type RpcTransport as aT, type CreateRoomOptions as aU, type JoinOrCreateResult as aV, type RoomSubscriptionOptions as aW, type ProposeMovePayload as aX, type ProposeMoveResult as aY, type ValidateMoveResult as aZ, type ExecuteScopedRecipeOptions as a_, type Recipe as aa, type GetBatchRecipeRequirements as ab, type TriggerRecipeChainOptions as ac, VenusTransport as ad, type LoggingApi as ae, type IapApi as af, type SpendCurrencyOptions as ag, type LoadEmbeddedAssetsResponse as ah, type SharedAssetsApi as ai, type LeaderboardApi as aj, type ScoreToken as ak, type SubmitScoreParams as al, type SubmitScoreResult as am, type GetPagedScoresOptions as an, type PagedScoresResponse as ao, type PlayerRankOptions as ap, type PlayerRankResult as aq, type GetPodiumScoresOptions as ar, type PodiumScoresResponse as as, type PreloaderApi as at, type SocialApi as au, type ShareMetadata as av, type ShareLinkResult as aw, type SocialQRCodeOptions as ax, type QRCodeResult as ay, type Avatar3dApi as az, type VenusSimulationEffect as b, RpcSharedAssetsApi as b0, type LoadEmbeddedAssetsRequest as b1, type LeaderboardModeConfig as b2, type LeaderboardPeriodType as b3, type LeaderboardPeriodConfig as b4, type LeaderboardAntiCheatConfig as b5, type LeaderboardDisplaySettings as b6, type LeaderboardConfig as b7, type LeaderboardEntry as b8, type PodiumScoresContext as b9, createHost as ba, type VenusSimulationRecipe as c, type VenusSimulationConfig as d, type RecipeRequirementQuery as e, type VenusSimulationAPI as f, type VenusConfig as g, type VenusRoomsConfig as h, VenusRoom as i, type AnalyticsApi as j, type RpcRequest as k, type RpcResponse as l, type RpcNotification as m, RpcClient as n, type NavigationStackInfo as o, type PushAppOptions as p, type NotificationsApi as q, type ScheduleLocalNotification as r, type ScheduleNotificationOptions as s, type PopupsApi as t, type ActionSheetItem as u, type ShowActionSheetOptions as v, type ShowAlertOptions as w, type ShowConfirmOptions as x, type ShowToastOptions as y, type ShowInterstitialAdOptions 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 };