@series-inc/venus-sdk 2.6.2 → 3.0.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AnalyticsApi, R as RpcRequest, a as RpcResponse, b as RpcNotification, c as RpcClient, V as VenusAPI, N as NavigationApi, Q as QuitOptions, d as NavigationStackInfo, P as PushAppOptions, e as NotificationsApi, S as ScheduleLocalNotification, f as ScheduleNotificationOptions, g as PopupsApi, h as ActionSheetItem, i as ShowActionSheetOptions, j as ShowAlertOptions, k as ShowConfirmOptions, l as ShowToastOptions, m as Profile, n as AiApi, o as AiChatCompletionRequest, p as AiChatCompletionData, H as HapticsApi, q as HapticFeedbackStyle, L as LifecycleApi, O as OnCleanupCallback, r as OnShowCallback, s as OnHideCallback, t as OnPauseCallback, u as OnPlayCallback, v as OnQuitCallback, w as OnResumeCallback, x as PlayContext, y as ShowContext, z as VenusSimulationConfig, B as RecipeRequirementResult, C as VenusRoom, D as VenusTransport, E as Subscription, I as IapApi, F as SpendCurrencyOptions, G as LoadEmbeddedAssetsResponse, J as SharedAssetsApi, K as PreloaderApi, M as AdsApi, T as Avatar3dApi, U as CdnApi, W as AssetManifest, X as Avatar3dConfig, Y as ShowEditorOptions, Z as Avatar3dEdits, _ as SubPath, $ as FetchBlobOptions } from './AdsApi-C_GcWmfO.js';
-export { a0 as AiMessage, a1 as Asset, a2 as Category, a4 as Insets, ad as LoadEmbeddedAssetsRequest, a3 as MockAvatarApi, a7 as NotificationTriggerInput, aa as OnNotificationCallback, a8 as OnRequestCallback, a9 as OnResponseCallback, a5 as PostInfo, ac as RpcSharedAssetsApi, ab as RpcTransport, a6 as TimeIntervalTriggerInput } from './AdsApi-C_GcWmfO.js';
+import { A as AnalyticsApi, R as RpcRequest, a as RpcResponse, b as RpcNotification, c as RpcClient, V as VenusAPI, H as Host, S as StorageApi, N as NavigationApi, Q as QuitOptions, d as NavigationStackInfo, P as PushAppOptions, e as NotificationsApi, f as ScheduleLocalNotification, g as ScheduleNotificationOptions, h as PopupsApi, i as ActionSheetItem, j as ShowActionSheetOptions, k as ShowAlertOptions, l as ShowConfirmOptions, m as ShowToastOptions, n as ShowInterstitialAdOptions, o as ShowRewardedAdOptions, p as ProfileApi, q as Profile, C as CdnApi, r as SubPath, F as FetchBlobOptions, T as TimeApi, s as ServerTimeData, G as GetFutureTimeOptions, t as AiApi, u as AiChatCompletionRequest, v as AiChatCompletionData, w as HapticsApi, x as HapticFeedbackStyle, y as FeaturesApi, E as Experiment, L as LifecycleApi, z as SleepCallback, B as Subscription, D as AwakeCallback, I as PauseCallback, J as ResumeCallback, K as QuitCallback, M as SimulationApi, O as VenusSimulationConfig, U as ExecuteRecipeOptions, W as CollectRecipeResult, X as GetActiveRunsOptions, Y as ExecuteScopedRecipeResult, Z as GetAvailableRecipesOptions, _ as GetAvailableRecipesResult, $ as Recipe, a0 as GetBatchRecipeRequirements, a1 as TriggerRecipeChainOptions, a2 as RecipeRequirementResult, a3 as VenusTransport, a4 as LoggingApi, a5 as IapApi, a6 as SpendCurrencyOptions, a7 as LoadEmbeddedAssetsResponse, a8 as SharedAssetsApi, a9 as LeaderboardApi, aa as StartRunResult, ab as SubmitScoreOptions, ac as SubmitScoreResult, ad as GetLeaderboardOptions, ae as LeaderboardResponse, af as PlayerStatsOptions, ag as PlayerStats, ah as LeaderboardHighlightOptions, ai as LeaderboardHighlightResponse, aj as PreloaderApi, ak as Avatar3dApi, al as AssetManifest, am as Avatar3dConfig, an as ShowEditorOptions, ao as Avatar3dEdits, ap as SocialApi, aq as ShareMetadata, ar as ShareLinkResult, as as SocialQRCodeOptions, at as QRCodeResult, au as AdsApi, av as PostApi, aw as RoomsApi, ax as InitializationOptions, ay as InitializationContext, az as HudInsets } from './AdsApi-3DEYUUuj.js';
+export { aA as AiMessage, aB as Asset, aC as Category, aL as CreateRoomOptions, aR as ExecuteScopedRecipeOptions, b1 as InitializeOptions, aM as JoinOrCreateResult, aY as LeaderboardAntiCheatConfig, a_ as LeaderboardConfig, aZ as LeaderboardDisplaySettings, a$ as LeaderboardEntry, b0 as LeaderboardHighlightContext, aV as LeaderboardModeConfig, aX as LeaderboardPeriodConfig, aW as LeaderboardPeriodType, aU as LoadEmbeddedAssetsRequest, aD as MockAvatarApi, aF as NotificationTriggerInput, aI as OnNotificationCallback, aG as OnRequestCallback, aH as OnResponseCallback, aO as ProposeMovePayload, aP as ProposeMoveResult, aS as RecipeInfo, aN as RoomSubscriptionOptions, aT as RpcSharedAssetsApi, aJ as RpcTransport, aE as TimeIntervalTriggerInput, aQ as ValidateMoveResult, aK as VenusRoom, b2 as createHost } from './AdsApi-3DEYUUuj.js';
 
 declare class MockAnalyticsApi implements AnalyticsApi {
     recordCustomEvent(eventName: string, payload: Record<string, any>): Promise<void>;
@@ -17,21 +17,61 @@ declare class RpcAnalyticsApi implements AnalyticsApi {
 
 declare function initializeAnalytics(venusApiInstance: VenusAPI, host: Host): void;
 
-interface StorageApi {
-    key(index: number): Promise<string | null>;
+type StorageType = 'globalStorage' | 'deviceCache' | 'appStorage';
+declare function createMockStorageApi(storageType: StorageType, appUrl?: string): MockStorageApi;
+declare class MockStorageApi implements StorageApi {
+    private readonly prefix;
+    private readonly syncDelay;
+    constructor(prefix: string, syncDelay: number);
     clear(): Promise<void>;
-    length(): Promise<number>;
     getAllItems(): Promise<string[]>;
-    setMultipleItems(items: {
+    getItem(key: string): Promise<string | null>;
+    key(index: number): Promise<string | null>;
+    length(): Promise<number>;
+    removeItem(key: string): Promise<void>;
+    setItem(key: string, item: string): Promise<void>;
+    setMultipleItems(entries: {
         key: string;
         value: string;
     }[]): Promise<void>;
     removeMultipleItems(keys: string[]): Promise<void>;
-    setItem(key: string, item: string): Promise<void>;
+    private buildKey;
+    private extractKey;
+    private keys;
+    private simulateSyncDelay;
+}
+
+interface MethodIds {
+    clear: string;
+    getItem: string;
+    getKey: string;
+    length: string;
+    removeItem: string;
+    setItem: string;
+    getAllItems?: string;
+    removeMultipleItems?: string;
+    setMultipleItems?: string;
+}
+declare class RpcStorageApi implements StorageApi {
+    private readonly rpcClient;
+    private readonly methodIds;
+    constructor(rpcClient: RpcClient, methodIds: MethodIds);
+    clear(): Promise<void>;
     getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    key(index: number): Promise<string | null>;
+    length(): Promise<number>;
     removeItem(key: string): Promise<void>;
+    removeMultipleItems(keys: string[]): Promise<void>;
+    getAllItems(): Promise<string[]>;
+    setMultipleItems(items: {
+        key: string;
+        value: string;
+    }[]): Promise<void>;
 }
 
+declare function initializeStorage(venusApiInstance: VenusAPI, host: Host): void;
+
 declare class MockNavigationApi implements NavigationApi {
     private readonly venusApi;
     constructor(venusApi: VenusAPI);
@@ -60,14 +100,14 @@ declare class MockNotificationsApi implements NotificationsApi {
     cancelNotification(notificationId: string): Promise<boolean>;
     getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
     isLocalNotificationsEnabled(): Promise<boolean>;
-    scheduleAsync(options: ScheduleNotificationOptions): Promise<string | null>;
+    scheduleAsync(title: string, body: string, seconds: number, notificationId?: string, options?: ScheduleNotificationOptions): Promise<string | null>;
     setLocalNotificationsEnabled(enabled: boolean): Promise<boolean>;
 }
 
 declare class RpcNotificationsApi implements NotificationsApi {
     private readonly rpcClient;
     constructor(rpcClient: RpcClient);
-    scheduleAsync(options: ScheduleNotificationOptions): Promise<string | null>;
+    scheduleAsync(title: string, body: string, seconds: number, notificationId?: string, options?: ScheduleNotificationOptions): Promise<string | null>;
     cancelNotification(id: string): Promise<boolean>;
     getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
     isLocalNotificationsEnabled(): Promise<boolean>;
@@ -101,7 +141,7 @@ interface MockOverlay {
     adOverlay: HTMLElement;
     actionSheetOverlay: HTMLElement;
     appVisibilityState: 'visible' | 'hidden';
-    showAdOverlay: () => Promise<boolean>;
+    showAdOverlay: (options?: ShowInterstitialAdOptions | ShowRewardedAdOptions) => Promise<boolean>;
     showActionSheet: (items: ActionSheetItem[], options?: ShowActionSheetOptions) => Promise<string | number | null>;
 }
 interface OverlayElements {
@@ -119,10 +159,6 @@ declare class MockPopupsApi implements PopupsApi {
 
 declare function initializePopups(venusApi: VenusAPI, host: Host): void;
 
-interface ProfileApi {
-    getCurrentProfile(): Profile;
-}
-
 declare class HostProfileApi implements ProfileApi {
     getCurrentProfile(): Profile;
 }
@@ -133,31 +169,30 @@ declare class MockProfileApi implements ProfileApi {
 
 declare function initializeProfile(venusApi: VenusAPI, host: Host): void;
 
-interface ServerTimeData {
-    serverTime: number;
-    localTime: number;
-    timezoneOffset: number;
-    formattedTime: string;
-    locale: string;
-}
-interface GetFutureTimeOptions {
-    days?: number;
-    hours?: number;
-    minutes?: number;
-    timeOfDay?: {
-        hour: number;
-        minute: number;
-        second: number;
-    };
-    timezone?: any;
+declare class HostCdnApi implements CdnApi {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    fetchBlob(path: SubPath, options?: FetchBlobOptions): Promise<Blob>;
+    fetchFromCdn(url: string, request?: RequestInit): Promise<Response>;
+    getAssetCdnBaseUrl(): string;
+    resolveAssetUrl(subPath: string): string;
+    resolveAvatarAssetUrl(subPath: string): string;
+    resolveSharedLibUrl(subPath: string): string;
 }
-interface TimeApi {
-    requestTimeAsync(): Promise<ServerTimeData>;
-    formatTime(timestamp: number, options?: any): string;
-    formatNumber(value: number, options?: Intl.NumberFormatOptions): string;
-    getFutureTimeAsync(options?: GetFutureTimeOptions): Promise<number>;
+
+declare class MockCdnApi implements CdnApi {
+    private readonly baseUrl;
+    constructor();
+    fetchBlob(path: SubPath, options?: FetchBlobOptions): Promise<Blob>;
+    getAssetCdnBaseUrl(): string;
+    resolveAssetUrl(subPath: string): string;
+    resolveAvatarAssetUrl(subPath: string): string;
+    resolveSharedLibUrl(subPath: string): string;
+    fetchFromCdn(url: string, options?: RequestInit): Promise<Response>;
 }
 
+declare function initializeCdn(venusApi: VenusAPI, host: Host): void;
+
 declare class HostTimeApi implements TimeApi {
     private readonly rpcClient;
     constructor(rpcClient: RpcClient);
@@ -181,44 +216,6 @@ declare class MockTimeApi implements TimeApi {
 
 declare function initializeTime(venusApi: VenusAPI, host: Host): void;
 
-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 ShareContext {
-    message?: string;
-    title?: string;
-    senderId?: string | null;
-    additionalInfo?: Record<string, any>;
-}
-interface SharePostResult {
-    shared: true;
-    platform: string;
-    customMessage?: string;
-}
-interface PostApi {
-    getPostInfo(): Promise<PostInfo>;
-    toggleLikeAsync(): Promise<ToggleLikeResult>;
-    openCommentsAsync(): Promise<OpenCommentsResult>;
-    toggleFollowAsync(): Promise<ToggleFollowResult>;
-    sharePostAsync(context: ShareContext): Promise<SharePostResult>;
-}
-
 declare class RpcAiApi implements AiApi {
     private readonly rpcClient;
     constructor(rpcClient: RpcClient);
@@ -247,18 +244,6 @@ declare class MockHapticsApi implements HapticsApi {
 
 declare function initializeHaptics(venusApi: VenusAPI, host: Host): void;
 
-interface Experiment {
-    readonly name: string;
-    readonly ruleID: string;
-    readonly value: Record<string, unknown>;
-    readonly groupName: string | null;
-}
-interface FeaturesApi {
-    getExperiment(experimentName: string): Promise<Experiment | null>;
-    getFeatureFlag(flagName: string): Promise<boolean>;
-    getFeatureGate(gateName: string): Promise<boolean>;
-}
-
 declare class RpcFeaturesApi implements FeaturesApi {
     private readonly rpcClient;
     constructor(rcpClient: RpcClient);
@@ -276,113 +261,35 @@ declare class MockFeaturesApi implements FeaturesApi {
 declare function initializeFeaturesApi(venusApi: VenusAPI, host: Host): void;
 
 declare class MockLifecycleApi implements LifecycleApi {
-    private playCallbacks;
     private pauseCallbacks;
     private resumeCallbacks;
+    private awakeCallbacks;
+    private sleepCallbacks;
     private quitCallbacks;
-    private showCallbacks;
-    private hideCallbacks;
-    onCleanup(callback: OnCleanupCallback): void;
-    onShow(callback: OnShowCallback): void;
-    onHide(callback: OnHideCallback): void;
-    onPause(callback: OnPauseCallback): void;
-    onPlay(callback: OnPlayCallback): void;
-    onQuit(callback: OnQuitCallback): void;
-    onResume(callback: OnResumeCallback): void;
-    triggerOnPlayCallbacks(context: PlayContext): void;
-    triggerOnPauseCallbacks(): void;
-    triggerOnResumeCallbacks(): void;
-    triggerOnShowCallbacks(context: ShowContext): void;
-    triggerOnHideCallbacks(): void;
-    triggerOnQuitCallbacks(): void;
+    onSleep(callback: SleepCallback): Subscription;
+    onAwake(callback: AwakeCallback): Subscription;
+    onPause(callback: PauseCallback): Subscription;
+    onResume(callback: ResumeCallback): Subscription;
+    onQuit(callback: QuitCallback): Subscription;
+    triggerPauseCallbacks(): void;
+    triggerResumeCallbacks(): void;
+    triggerAwakeCallbacks(): void;
+    triggerSleepCallbacks(): void;
+    triggerQuitCallbacks(): void;
 }
 
 declare class RpcLifecycleApi implements LifecycleApi {
     private readonly rpcClient;
     constructor(rpcClient: RpcClient);
-    onCleanup(callback: OnCleanupCallback): void;
-    onHide(callback: OnHideCallback): void;
-    onPause(callback: OnPauseCallback): void;
-    onPlay(callback: OnPlayCallback): void;
-    onQuit(callback: OnQuitCallback): void;
-    onResume(callback: OnResumeCallback): void;
-    onShow(callback: OnShowCallback): void;
+    onQuit(callback: QuitCallback): Subscription;
+    onSleep(callback: SleepCallback): Subscription;
+    onAwake(callback: AwakeCallback): Subscription;
+    onResume(callback: ResumeCallback): Subscription;
+    onPause(callback: PauseCallback): Subscription;
 }
 
 declare function initializeLifecycleApi(venusApi: VenusAPI, host: Host): void;
 
-interface ExecuteRecipeOptions {
-    roomId?: string;
-    batchAmount?: number;
-    allowPartialBatch?: boolean;
-    entity?: string;
-}
-interface GetActiveRunsOptions {
-    roomId?: string;
-}
-interface ExecuteScopedRecipeOptions {
-    roomId?: string;
-}
-interface GetAvailableRecipesOptions {
-    roomId?: string;
-    includeActorRecipes?: boolean;
-}
-interface Recipe {
-    recipeId: string;
-    entity?: string;
-    batchAmount?: number;
-}
-interface TriggerRecipeChainOptions {
-    roomId?: string;
-    context?: any;
-}
-interface CollectRecipeResult {
-    success: boolean;
-    runId: string;
-    rewards: any;
-    message: string;
-}
-interface ExecuteScopedRecipeResult {
-    success: boolean;
-    message: string;
-}
-interface RecipeInfo {
-    id: string;
-    scope: string;
-    clientViewable: boolean;
-}
-interface GetAvailableRecipesResult {
-    success: boolean;
-    recipes: RecipeInfo[];
-}
-interface GetBatchRecipeRequirements {
-    success: boolean;
-    results: RecipeRequirementResult[];
-}
-interface SimulationApi {
-    getStateAsync(roomId?: string): Promise<any>;
-    getConfigAsync(roomId?: string): Promise<VenusSimulationConfig>;
-    executeRecipeAsync(recipeId: string, inputs?: any, options?: ExecuteRecipeOptions): Promise<any>;
-    getActiveRunsAsync(options?: GetActiveRunsOptions): Promise<any>;
-    collectRecipeAsync(runId: string): Promise<CollectRecipeResult>;
-    executeScopedRecipeAsync(recipeId: string, entity: string, inputs?: any, options?: ExecuteScopedRecipeOptions | any): Promise<ExecuteScopedRecipeResult>;
-    triggerRecipeChainAsync(recipeId: string, options?: TriggerRecipeChainOptions): Promise<any>;
-    getAvailableRecipesAsync(options?: GetAvailableRecipesOptions): Promise<GetAvailableRecipesResult>;
-    getRecipeRequirementsAsync(recipe: Recipe): Promise<RecipeRequirementResult>;
-    getBatchRecipeRequirementsAsync(recipes: Recipe[]): Promise<GetBatchRecipeRequirements>;
-    resolveFieldValueAsync(entityId: string, fieldPath: string, entity?: string): Promise<any>;
-    getEntityMetadataAsync(entityId: string): Promise<any>;
-    getSlotContainersAsync(): Promise<any>;
-    getSlotAssignmentsAsync(containerId: string): Promise<any>;
-    assignItemToSlotAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
-    removeItemFromSlotAsync(containerId: string, slotId: string): Promise<any>;
-    getAvailableItemsAsync(containerId: string, slotId: string): Promise<Array<any>>;
-    calculatePowerPreviewAsync(containerId: string, slotId: string, candidateItemId: string): Promise<any>;
-    validateSlotAssignmentAsync(containerId: string, slotId: string, itemId: string): Promise<any>;
-    executeBatchOperationsAsync(operations: Array<any>, validateOnly?: boolean): Promise<any>;
-    sumContributions(contributions: Record<string, any>): Record<string, number>;
-}
-
 declare class RpcSimulationApi implements SimulationApi {
     private readonly rpcClient;
     private _simulationConfig;
@@ -449,58 +356,6 @@ declare class MockSimulationApi implements SimulationApi {
 
 declare function initializeSimulation(venusApi: VenusAPI, host: Host): void;
 
-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>;
-}
-
 /**
  * Set up room notification listeners using the transport's onVenusMessage hook.
  * This routes host-sent room notifications (H5_ROOM_DATA_UPDATED, etc.) to the
@@ -511,11 +366,6 @@ interface RoomsApi {
 declare function setupRoomNotifications(transport: VenusTransport, getSubscriptions: () => any): Subscription;
 declare function initializeRoomsApi(venusApi: VenusAPI, host: Host): void;
 
-interface LoggingApi {
-    logDebug(message: string, ...args: any[]): void;
-    logError(message: string, ...args: any[]): void;
-}
-
 declare class MockLoggingApi implements LoggingApi {
     logDebug(message?: any, ...args: any[]): void;
     logError(message: string, ...args: any[]): void;
@@ -561,6 +411,39 @@ declare class MockIapApi implements IapApi {
 
 declare function initializeIap(venusApiInstance: VenusAPI, host: Host): void;
 
+declare class RpcLeaderboardApi implements LeaderboardApi {
+    private readonly rpcClient;
+    constructor(rpcClient: RpcClient);
+    startRun(mode?: string): Promise<StartRunResult>;
+    submitScore(sessionId: string, score: number, durationSec: number, options?: SubmitScoreOptions): Promise<SubmitScoreResult>;
+    getLeaderboard(options?: GetLeaderboardOptions): Promise<LeaderboardResponse>;
+    getPlayerStats(options?: PlayerStatsOptions): Promise<PlayerStats>;
+    getLeaderboardHighlight(options?: LeaderboardHighlightOptions): Promise<LeaderboardHighlightResponse>;
+}
+
+declare class MockLeaderboardApi implements LeaderboardApi {
+    private sessions;
+    private entriesByMode;
+    private sessionCounter;
+    private requiresHash;
+    constructor(options?: {
+        requiresHash?: boolean;
+    });
+    configure(options: {
+        requiresHash?: boolean;
+    }): void;
+    private generateNonce;
+    private getModeKey;
+    private getEntriesForMode;
+    startRun(mode?: string): Promise<StartRunResult>;
+    submitScore(sessionId: string, score: number, durationSec: number, options?: SubmitScoreOptions): Promise<SubmitScoreResult>;
+    getLeaderboard(options?: GetLeaderboardOptions): Promise<LeaderboardResponse>;
+    getPlayerStats(_options?: PlayerStatsOptions): Promise<PlayerStats>;
+    getLeaderboardHighlight(options?: LeaderboardHighlightOptions): Promise<LeaderboardHighlightResponse>;
+}
+
+declare function initializeLeaderboard(venusApiInstance: VenusAPI, host: Host): void;
+
 declare class MockPreloaderApi implements PreloaderApi {
     showLoadScreen(): Promise<void>;
     hideLoadScreen(): Promise<void>;
@@ -579,38 +462,6 @@ declare class RpcPreloaderApi implements PreloaderApi {
 
 declare function initializePreloader(venusApi: VenusAPI, host: Host): void;
 
-interface InitializeOptions {
-    usePreloader?: boolean;
-    mock?: Record<string, any>;
-    [key: string]: any;
-}
-interface Host {
-    readonly ads: AdsApi;
-    readonly analytics: AnalyticsApi;
-    readonly deviceCache: StorageApi;
-    readonly appStorage: StorageApi;
-    readonly globalStorage: StorageApi;
-    readonly avatar3d: Avatar3dApi;
-    readonly navigation: NavigationApi;
-    readonly notifications: NotificationsApi;
-    readonly popups: PopupsApi;
-    readonly profile: ProfileApi;
-    readonly cdn: CdnApi;
-    readonly time: TimeApi;
-    readonly post: PostApi;
-    readonly ai: AiApi;
-    readonly haptics: HapticsApi;
-    readonly features: FeaturesApi;
-    readonly lifecycle: LifecycleApi;
-    readonly simulation: SimulationApi;
-    readonly rooms: RoomsApi;
-    readonly logging: LoggingApi;
-    readonly preloader: PreloaderApi;
-    readonly isInitialized: boolean;
-    initialize(options?: InitializeOptions): Promise<void>;
-    readonly iap: IapApi;
-}
-
 declare class RpcAvatarApi implements Avatar3dApi {
     private readonly venusApi;
     private readonly rpcClient;
@@ -627,104 +478,52 @@ declare class RpcAvatarApi implements Avatar3dApi {
 
 declare function initializeAvatar3d(venusApi: VenusAPI, host: Host): void;
 
-declare class HostCdnApi implements CdnApi {
-    private readonly baseUrl;
-    constructor(baseUrl: string);
-    fetchBlob(path: SubPath, options?: FetchBlobOptions): Promise<Blob>;
-    fetchFromCdn(url: string, request?: RequestInit): Promise<Response>;
-    getAssetCdnBaseUrl(): string;
-    resolveAssetUrl(subPath: string): string;
-    resolveAvatarAssetUrl(subPath: string): string;
-    resolveSharedLibUrl(subPath: string): string;
-}
-
-declare class MockCdnApi implements CdnApi {
-    private readonly baseUrl;
-    constructor();
-    fetchBlob(path: SubPath, options?: FetchBlobOptions): Promise<Blob>;
-    getAssetCdnBaseUrl(): string;
-    resolveAssetUrl(subPath: string): string;
-    resolveAvatarAssetUrl(subPath: string): string;
-    resolveSharedLibUrl(subPath: string): string;
-    fetchFromCdn(url: string, options?: RequestInit): Promise<Response>;
-}
-
-declare function initializeCdn(venusApi: VenusAPI, host: Host): void;
+declare class RpcSocialApi implements SocialApi {
+    private readonly rpcClient;
+    constructor(rpcClient: RpcClient);
+    shareLinkAsync(options: {
+        launchParams: Record<string, string>;
+        metadata?: ShareMetadata;
+    }): Promise<ShareLinkResult>;
+    createQRCodeAsync(options: {
+        launchParams: Record<string, string>;
+        metadata?: ShareMetadata;
+        qrOptions?: SocialQRCodeOptions;
+    }): Promise<QRCodeResult>;
+}
+
+declare class MockSocialApi implements SocialApi {
+    shareLinkAsync(options: {
+        launchParams: Record<string, string>;
+    }): Promise<ShareLinkResult>;
+    createQRCodeAsync(options: {
+        launchParams: Record<string, string>;
+        qrOptions?: SocialQRCodeOptions;
+    }): Promise<QRCodeResult>;
+    private createMockUrl;
+}
+
+declare function initializeSocial(venusApi: VenusAPI, host: Host): void;
 
 declare class RpcAdsApi implements AdsApi {
     private readonly rpcClient;
     constructor(rpcClient: RpcClient);
-    showInterstitialAd(): Promise<boolean>;
+    showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
     isRewardedAdReadyAsync(): Promise<boolean>;
-    showRewardedAdAsync(): Promise<boolean>;
+    showRewardedAdAsync(options?: ShowRewardedAdOptions): Promise<boolean>;
 }
 
 declare class MockAdsApi implements AdsApi {
     private mockOverlay;
     constructor(mockOverlay: MockOverlay);
     isRewardedAdReadyAsync(): Promise<boolean>;
-    showRewardedAdAsync(): Promise<boolean>;
-    showInterstitialAd(): Promise<boolean>;
+    showRewardedAdAsync(options?: ShowRewardedAdOptions): Promise<boolean>;
+    showInterstitialAd(options?: ShowInterstitialAdOptions): Promise<boolean>;
     private log;
 }
 
 declare function initializeAds(venusApiInstance: VenusAPI, host: Host): void;
 
-type StorageType = 'globalStorage' | 'deviceCache' | 'appStorage';
-declare function createMockStorageApi(storageType: StorageType, appUrl?: string): MockStorageApi;
-declare class MockStorageApi implements StorageApi {
-    private readonly prefix;
-    private readonly syncDelay;
-    constructor(prefix: string, syncDelay: number);
-    clear(): Promise<void>;
-    getAllItems(): Promise<string[]>;
-    getItem(key: string): Promise<string | null>;
-    key(index: number): Promise<string | null>;
-    length(): Promise<number>;
-    removeItem(key: string): Promise<void>;
-    setItem(key: string, item: string): Promise<void>;
-    setMultipleItems(entries: {
-        key: string;
-        value: string;
-    }[]): Promise<void>;
-    removeMultipleItems(keys: string[]): Promise<void>;
-    private buildKey;
-    private extractKey;
-    private keys;
-    private simulateSyncDelay;
-}
-
-interface MethodIds {
-    clear: string;
-    getItem: string;
-    getKey: string;
-    length: string;
-    removeItem: string;
-    setItem: string;
-    getAllItems?: string;
-    removeMultipleItems?: string;
-    setMultipleItems?: string;
-}
-declare class RpcStorageApi implements StorageApi {
-    private readonly rpcClient;
-    private readonly methodIds;
-    constructor(rpcClient: RpcClient, methodIds: MethodIds);
-    clear(): Promise<void>;
-    getItem(key: string): Promise<string | null>;
-    setItem(key: string, value: string): Promise<void>;
-    key(index: number): Promise<string | null>;
-    length(): Promise<number>;
-    removeItem(key: string): Promise<void>;
-    removeMultipleItems(keys: string[]): Promise<void>;
-    getAllItems(): Promise<string[]>;
-    setMultipleItems(items: {
-        key: string;
-        value: string;
-    }[]): Promise<void>;
-}
-
-declare function initializeStorage(venusApiInstance: VenusAPI, host: Host): void;
-
 declare const SDK_VERSION: string;
 
 declare enum VenusMessageId {
@@ -776,7 +575,8 @@ declare enum VenusMessageId {
     TOGGLE_LIKE = "H5_TOGGLE_LIKE",
     OPEN_COMMENTS = "H5_OPEN_COMMENTS",// For opening comments with callback support
     TOGGLE_FOLLOW = "H5_TOGGLE_FOLLOW",
-    SHARE_POST = "H5_SHARE_POST",
+    SHARE_LINK = "H5_SHARE_LINK",
+    CREATE_SHARE_QRCODE = "H5_CREATE_SHARE_QRCODE",
     AI_CHAT_COMPLETION = "H5_AI_CHAT_COMPLETION",
     AI_GET_AVAILABLE_MODELS = "H5_AI_GET_AVAILABLE_MODELS",
     TRIGGER_HAPTIC = "H5_TRIGGER_HAPTIC",
@@ -788,13 +588,11 @@ declare enum VenusMessageId {
     IAP_WALLET_UPDATE = "IAP_WALLET_UPDATE",
     READY = "READY",
     INIT_SDK = "INITIALIZE_SDK",
-    PLAY = "PLAY",
     PAUSE = "PAUSE",
     RESUME = "RESUME",
-    SHOWN = "SHOWN",// Previously AWAKE
-    HIDDEN = "HIDDEN",// Previously SLEEP
-    QUIT = "QUIT",// Previously STOP
-    CLEANUP = "CLEANUP",
+    AWAKE = "AWAKE",
+    SLEEP = "SLEEP",
+    QUIT = "QUIT",
     /** given the experiment name, returns the entire experiment object as configured for the current user */
     GET_EXPERIMENT = "H5_GET_EXPERIMENT",
     /** returns the boolean value for a feature flag using the statsig parameter store, or the feature flags constants as fallback */
@@ -821,6 +619,11 @@ declare enum VenusMessageId {
     H5_SIMULATION_GET_AVAILABLE_ITEMS = "H5_SIMULATION_GET_AVAILABLE_ITEMS",
     H5_SIMULATION_VALIDATE_ASSIGNMENT = "H5_SIMULATION_VALIDATE_ASSIGNMENT",
     H5_SIMULATION_BATCH_OPERATIONS = "H5_SIMULATION_BATCH_OPERATIONS",
+    H5_LEADERBOARD_START_RUN = "H5_LEADERBOARD_START_RUN",
+    H5_LEADERBOARD_SUBMIT_SCORE = "H5_LEADERBOARD_SUBMIT_SCORE",
+    H5_LEADERBOARD_GET = "H5_LEADERBOARD_GET",
+    H5_LEADERBOARD_GET_HIGHLIGHT = "H5_LEADERBOARD_GET_HIGHLIGHT",
+    H5_LEADERBOARD_GET_PLAYER_STATS = "H5_LEADERBOARD_GET_PLAYER_STATS",
     H5_ROOM_CREATE = "H5_ROOM_CREATE",
     H5_ROOM_JOIN = "H5_ROOM_JOIN",
     H5_ROOM_JOIN_OR_CREATE = "H5_ROOM_JOIN_OR_CREATE",
@@ -852,4 +655,50 @@ declare enum VenusMessageId {
     H5_IAP_GET_CURRENCY_ICON = "H5_IAP_GET_CURRENCY_ICON"
 }
 
-export { ActionSheetItem, AdsApi, AiApi, AiChatCompletionData, AiChatCompletionRequest, AnalyticsApi, AssetManifest, Avatar3dApi, Avatar3dConfig, Avatar3dEdits, CdnApi, type CollectRecipeResult, type CreateRoomOptions, type ExecuteRecipeOptions, type ExecuteScopedRecipeOptions, type ExecuteScopedRecipeResult, type Experiment, type FeaturesApi, FetchBlobOptions, type GetActiveRunsOptions, type GetAvailableRecipesOptions, type GetAvailableRecipesResult, type GetBatchRecipeRequirements, type GetFutureTimeOptions, HapticFeedbackStyle, HapticsApi, HostCdnApi, HostProfileApi, HostTimeApi, IapApi, type JoinOrCreateResult, LifecycleApi, LoadEmbeddedAssetsResponse, type LoggingApi, type MethodIds, MockAdsApi, MockAiApi, MockAnalyticsApi, MockCdnApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockPreloaderApi, MockProfileApi, MockSharedAssetsApi, MockSimulationApi, MockStorageApi, MockTimeApi, NavigationApi, NavigationStackInfo, type NotificationContent, NotificationsApi, OnCleanupCallback, OnHideCallback, OnPauseCallback, OnPlayCallback, OnQuitCallback, OnResumeCallback, OnShowCallback, PlayContext, PopupsApi, PreloaderApi, type ProfileApi, type ProposeMovePayload, type ProposeMoveResult, PushAppOptions, QuitOptions, type Recipe, type RecipeInfo, type RoomSubscriptionOptions, type RoomsApi, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLifecycleApi, RpcLoggingApi, type RpcMessage, RpcNavigationApi, RpcNotification, RpcNotificationsApi, RpcPopupsApi, RpcPreloaderApi, RpcRequest, RpcResponse, RpcSimulationApi, RpcStorageApi, SDK_VERSION, ScheduleLocalNotification, ScheduleNotificationOptions, type ServerTimeData, SharedAssetsApi, ShowActionSheetOptions, ShowAlertOptions, ShowConfirmOptions, ShowContext, ShowEditorOptions, ShowToastOptions, type ShowToastResponse, type SimulationApi, SpendCurrencyOptions, type StorageApi, type StorageType, SubPath, Subscription, type TimeApi, type TriggerRecipeChainOptions, type ValidateMoveResult, VenusMessageId, VenusRoom, createMockStorageApi, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializePreloader, initializeProfile, initializeRoomsApi, initializeSimulation, initializeStackNavigation, initializeStorage, initializeTime, isPacificDaylightTime, setupRoomNotifications };
+declare class RemoteHost implements Host {
+    readonly ads: AdsApi;
+    readonly analytics: AnalyticsApi;
+    readonly deviceCache: StorageApi;
+    readonly appStorage: StorageApi;
+    readonly globalStorage: StorageApi;
+    readonly avatar3d: Avatar3dApi;
+    readonly navigation: NavigationApi;
+    readonly notifications: NotificationsApi;
+    readonly popups: PopupsApi;
+    readonly profile: ProfileApi;
+    readonly cdn: CdnApi;
+    readonly time: TimeApi;
+    readonly post: PostApi;
+    readonly ai: AiApi;
+    readonly haptics: HapticsApi;
+    readonly features: FeaturesApi;
+    readonly lifecycle: LifecycleApi;
+    readonly simulation: SimulationApi;
+    readonly rooms: RoomsApi;
+    readonly logging: LoggingApi;
+    readonly iap: IapApi;
+    readonly leaderboard: LeaderboardApi;
+    readonly preloader: PreloaderApi;
+    readonly social: SocialApi;
+    get isInitialized(): boolean;
+    private readonly venusApi;
+    private readonly rpcClient;
+    private _isInitialized;
+    constructor(venusApi: VenusAPI);
+    initialize(options?: InitializationOptions): Promise<InitializationContext>;
+    private log;
+}
+interface InitResponse {
+    initializeAsleep: boolean;
+    instanceId: string;
+    profile?: {
+        id: string;
+        username: string;
+        avatarUrl?: string | null;
+        isAnonymous?: boolean;
+    };
+    hudInsets?: HudInsets;
+    launchParams?: Record<string, string>;
+}
+
+export { ActionSheetItem, AdsApi, AiApi, AiChatCompletionData, AiChatCompletionRequest, AnalyticsApi, AssetManifest, Avatar3dApi, Avatar3dConfig, Avatar3dEdits, AwakeCallback, CdnApi, CollectRecipeResult, ExecuteRecipeOptions, ExecuteScopedRecipeResult, Experiment, FeaturesApi, FetchBlobOptions, GetActiveRunsOptions, GetAvailableRecipesOptions, GetAvailableRecipesResult, GetBatchRecipeRequirements, GetFutureTimeOptions, GetLeaderboardOptions, HapticFeedbackStyle, HapticsApi, Host, HostCdnApi, HostProfileApi, HostTimeApi, HudInsets, IapApi, type InitResponse, InitializationContext, InitializationOptions, LeaderboardApi, LeaderboardHighlightOptions, LeaderboardHighlightResponse, LeaderboardResponse, LifecycleApi, LoadEmbeddedAssetsResponse, LoggingApi, type MethodIds, MockAdsApi, MockAiApi, MockAnalyticsApi, MockCdnApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLeaderboardApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockPreloaderApi, MockProfileApi, MockSharedAssetsApi, MockSimulationApi, MockSocialApi, MockStorageApi, MockTimeApi, NavigationApi, NavigationStackInfo, type NotificationContent, NotificationsApi, PauseCallback, PlayerStats, PlayerStatsOptions, PopupsApi, PreloaderApi, ProfileApi, PushAppOptions, QRCodeResult, QuitCallback, QuitOptions, Recipe, RemoteHost, ResumeCallback, RoomsApi, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLeaderboardApi, RpcLifecycleApi, RpcLoggingApi, type RpcMessage, RpcNavigationApi, RpcNotification, RpcNotificationsApi, RpcPopupsApi, RpcPreloaderApi, RpcRequest, RpcResponse, RpcSimulationApi, RpcSocialApi, RpcStorageApi, SDK_VERSION, ScheduleLocalNotification, ScheduleNotificationOptions, ServerTimeData, ShareLinkResult, ShareMetadata, SharedAssetsApi, ShowActionSheetOptions, ShowAlertOptions, ShowConfirmOptions, ShowEditorOptions, ShowInterstitialAdOptions, ShowRewardedAdOptions, ShowToastOptions, type ShowToastResponse, SimulationApi, SleepCallback, SocialApi, SocialQRCodeOptions, SpendCurrencyOptions, StartRunResult, StorageApi, type StorageType, SubPath, SubmitScoreOptions, SubmitScoreResult, Subscription, TimeApi, TriggerRecipeChainOptions, VenusMessageId, createMockStorageApi, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLeaderboard, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializePreloader, initializeProfile, initializeRoomsApi, initializeSimulation, initializeSocial, initializeStackNavigation, initializeStorage, initializeTime, isPacificDaylightTime, setupRoomNotifications };