@series-inc/venus-sdk 2.4.1 → 2.6.2

package/dist/index.d.mts

@@ -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 ScheduleLocalNotificationOptions, 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, I as IapApi, C as SpendCurrencyOptions, D as LoadEmbeddedAssetsResponse, E as SharedAssetsApi, F as AdsApi, G as Avatar3dApi, J as CdnApi, K as AssetManifest, M as Avatar3dConfig, T as ShowEditorOptions, U as Avatar3dEdits, W as SubPath, X as FetchBlobOptions } from './AdsApi-Cz0XgLM8.mjs';
-export { Y as AiMessage, Z as Asset, a4 as CalendarTriggerInput, _ as Category, a5 as DailyTriggerInput, a3 as DateTriggerInput, a0 as Insets, ag as LoadEmbeddedAssetsRequest, $ as MockAvatarApi, a7 as MonthlyTriggerInput, a9 as NotificationTriggerInput, ad as OnNotificationCallback, ab as OnRequestCallback, ac as OnResponseCallback, a1 as PostInfo, af as RpcSharedAssetsApi, ae as RpcTransport, aa as Subscription, a2 as TimeIntervalTriggerInput, a6 as WeeklyTriggerInput, a8 as YearlyTriggerInput } from './AdsApi-Cz0XgLM8.mjs';
+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.mjs';
+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.mjs';
 
 declare class MockAnalyticsApi implements AnalyticsApi {
     recordCustomEvent(eventName: string, payload: Record<string, any>): Promise<void>;
@@ -57,13 +57,29 @@ declare function initializeStackNavigation(venusApi: VenusAPI, host: Host): void
 declare class MockNotificationsApi implements NotificationsApi {
     private readonly venusApi;
     constructor(venusApi: VenusAPI);
-    cancelLocalNotification(notificationId: string): Promise<boolean>;
+    cancelNotification(notificationId: string): Promise<boolean>;
     getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
     isLocalNotificationsEnabled(): Promise<boolean>;
-    scheduleLocalNotification(title: string, body: string, options?: ScheduleLocalNotificationOptions): Promise<string | null>;
+    scheduleAsync(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>;
+    cancelNotification(id: string): Promise<boolean>;
+    getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
+    isLocalNotificationsEnabled(): Promise<boolean>;
+    setLocalNotificationsEnabled(enabled: boolean): Promise<boolean>;
+}
+type NotificationContent = {
+    title: string | null;
+    subtitle: string | null;
+    body: string | null;
+    data?: Record<string, any>;
+};
+
 declare function initializeLocalNotifications(venusApi: VenusAPI, host: Host): void;
 
 declare class RpcPopupsApi implements PopupsApi {
@@ -433,10 +449,67 @@ declare class MockSimulationApi implements SimulationApi {
 
 declare function initializeSimulation(venusApi: VenusAPI, host: Host): void;
 
-interface RoomsApi {
-    createRoom(options: any): Promise<any>;
-    join(roomId: string): Promise<any>;
+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
+ * callbacks registered in the RoomsApi instance.
+ * @param transport The Venus transport to listen for messages
+ * @param getSubscriptions Function to retrieve subscription state from RoomsApi
+ */
+declare function setupRoomNotifications(transport: VenusTransport, getSubscriptions: () => any): Subscription;
+declare function initializeRoomsApi(venusApi: VenusAPI, host: Host): void;
 
 interface LoggingApi {
     logDebug(message: string, ...args: any[]): void;
@@ -488,6 +561,29 @@ declare class MockIapApi implements IapApi {
 
 declare function initializeIap(venusApiInstance: VenusAPI, host: Host): void;
 
+declare class MockPreloaderApi implements PreloaderApi {
+    showLoadScreen(): Promise<void>;
+    hideLoadScreen(): Promise<void>;
+    setLoaderText(text: string): Promise<void>;
+    setLoaderProgress(progress: number): Promise<void>;
+}
+
+declare class RpcPreloaderApi implements PreloaderApi {
+    private readonly rpcClient;
+    constructor(rpcClient: RpcClient);
+    showLoadScreen(): Promise<void>;
+    hideLoadScreen(): Promise<void>;
+    setLoaderText(text: string): Promise<void>;
+    setLoaderProgress(progress: number): Promise<void>;
+}
+
+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;
@@ -509,8 +605,9 @@ interface Host {
     readonly simulation: SimulationApi;
     readonly rooms: RoomsApi;
     readonly logging: LoggingApi;
+    readonly preloader: PreloaderApi;
     readonly isInitialized: boolean;
-    initialize(): Promise<void>;
+    initialize(options?: InitializeOptions): Promise<void>;
     readonly iap: IapApi;
 }
 
@@ -747,8 +844,12 @@ declare enum VenusMessageId {
     H5_ROOM_ELIMINATE_PLAYER = "H5_ROOM_ELIMINATE_PLAYER",
     H5_ROOM_PROMOTE_TO_SPECTATOR = "H5_ROOM_PROMOTE_TO_SPECTATOR",
     H5_LOAD_EMBEDDED_ASSET = "H5_LOAD_EMBEDDED_ASSET",
+    H5_SHOW_LOAD_SCREEN = "H5_SHOW_LOAD_SCREEN",
+    H5_HIDE_LOAD_SCREEN = "H5_HIDE_LOAD_SCREEN",
+    H5_SET_LOADER_TEXT = "H5_SET_LOADER_TEXT",
+    H5_SET_LOADER_PROGRESS = "H5_SET_LOADER_PROGRESS",
     H5_IAP_OPEN_STORE = "H5_IAP_OPEN_STORE",
     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 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, LifecycleApi, LoadEmbeddedAssetsResponse, type LoggingApi, type MethodIds, MockAdsApi, MockAiApi, MockAnalyticsApi, MockCdnApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockProfileApi, MockSharedAssetsApi, MockSimulationApi, MockStorageApi, MockTimeApi, NavigationApi, NavigationStackInfo, NotificationsApi, OnCleanupCallback, OnHideCallback, OnPauseCallback, OnPlayCallback, OnQuitCallback, OnResumeCallback, OnShowCallback, PlayContext, PopupsApi, type ProfileApi, PushAppOptions, QuitOptions, type Recipe, type RecipeInfo, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLifecycleApi, RpcLoggingApi, type RpcMessage, RpcNavigationApi, RpcNotification, RpcPopupsApi, RpcRequest, RpcResponse, RpcSimulationApi, RpcStorageApi, SDK_VERSION, ScheduleLocalNotification, ScheduleLocalNotificationOptions, type ServerTimeData, SharedAssetsApi, ShowActionSheetOptions, ShowAlertOptions, ShowConfirmOptions, ShowContext, ShowEditorOptions, ShowToastOptions, type ShowToastResponse, type SimulationApi, SpendCurrencyOptions, type StorageApi, type StorageType, SubPath, type TimeApi, type TriggerRecipeChainOptions, VenusMessageId, createMockStorageApi, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializeProfile, initializeSimulation, initializeStackNavigation, initializeStorage, initializeTime, isPacificDaylightTime };
+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 };

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 ScheduleLocalNotificationOptions, 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, I as IapApi, C as SpendCurrencyOptions, D as LoadEmbeddedAssetsResponse, E as SharedAssetsApi, F as AdsApi, G as Avatar3dApi, J as CdnApi, K as AssetManifest, M as Avatar3dConfig, T as ShowEditorOptions, U as Avatar3dEdits, W as SubPath, X as FetchBlobOptions } from './AdsApi-Cz0XgLM8.js';
-export { Y as AiMessage, Z as Asset, a4 as CalendarTriggerInput, _ as Category, a5 as DailyTriggerInput, a3 as DateTriggerInput, a0 as Insets, ag as LoadEmbeddedAssetsRequest, $ as MockAvatarApi, a7 as MonthlyTriggerInput, a9 as NotificationTriggerInput, ad as OnNotificationCallback, ab as OnRequestCallback, ac as OnResponseCallback, a1 as PostInfo, af as RpcSharedAssetsApi, ae as RpcTransport, aa as Subscription, a2 as TimeIntervalTriggerInput, a6 as WeeklyTriggerInput, a8 as YearlyTriggerInput } from './AdsApi-Cz0XgLM8.js';
+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';
 
 declare class MockAnalyticsApi implements AnalyticsApi {
     recordCustomEvent(eventName: string, payload: Record<string, any>): Promise<void>;
@@ -57,13 +57,29 @@ declare function initializeStackNavigation(venusApi: VenusAPI, host: Host): void
 declare class MockNotificationsApi implements NotificationsApi {
     private readonly venusApi;
     constructor(venusApi: VenusAPI);
-    cancelLocalNotification(notificationId: string): Promise<boolean>;
+    cancelNotification(notificationId: string): Promise<boolean>;
     getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
     isLocalNotificationsEnabled(): Promise<boolean>;
-    scheduleLocalNotification(title: string, body: string, options?: ScheduleLocalNotificationOptions): Promise<string | null>;
+    scheduleAsync(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>;
+    cancelNotification(id: string): Promise<boolean>;
+    getAllScheduledLocalNotifications(): Promise<ScheduleLocalNotification[]>;
+    isLocalNotificationsEnabled(): Promise<boolean>;
+    setLocalNotificationsEnabled(enabled: boolean): Promise<boolean>;
+}
+type NotificationContent = {
+    title: string | null;
+    subtitle: string | null;
+    body: string | null;
+    data?: Record<string, any>;
+};
+
 declare function initializeLocalNotifications(venusApi: VenusAPI, host: Host): void;
 
 declare class RpcPopupsApi implements PopupsApi {
@@ -433,10 +449,67 @@ declare class MockSimulationApi implements SimulationApi {
 
 declare function initializeSimulation(venusApi: VenusAPI, host: Host): void;
 
-interface RoomsApi {
-    createRoom(options: any): Promise<any>;
-    join(roomId: string): Promise<any>;
+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
+ * callbacks registered in the RoomsApi instance.
+ * @param transport The Venus transport to listen for messages
+ * @param getSubscriptions Function to retrieve subscription state from RoomsApi
+ */
+declare function setupRoomNotifications(transport: VenusTransport, getSubscriptions: () => any): Subscription;
+declare function initializeRoomsApi(venusApi: VenusAPI, host: Host): void;
 
 interface LoggingApi {
     logDebug(message: string, ...args: any[]): void;
@@ -488,6 +561,29 @@ declare class MockIapApi implements IapApi {
 
 declare function initializeIap(venusApiInstance: VenusAPI, host: Host): void;
 
+declare class MockPreloaderApi implements PreloaderApi {
+    showLoadScreen(): Promise<void>;
+    hideLoadScreen(): Promise<void>;
+    setLoaderText(text: string): Promise<void>;
+    setLoaderProgress(progress: number): Promise<void>;
+}
+
+declare class RpcPreloaderApi implements PreloaderApi {
+    private readonly rpcClient;
+    constructor(rpcClient: RpcClient);
+    showLoadScreen(): Promise<void>;
+    hideLoadScreen(): Promise<void>;
+    setLoaderText(text: string): Promise<void>;
+    setLoaderProgress(progress: number): Promise<void>;
+}
+
+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;
@@ -509,8 +605,9 @@ interface Host {
     readonly simulation: SimulationApi;
     readonly rooms: RoomsApi;
     readonly logging: LoggingApi;
+    readonly preloader: PreloaderApi;
     readonly isInitialized: boolean;
-    initialize(): Promise<void>;
+    initialize(options?: InitializeOptions): Promise<void>;
     readonly iap: IapApi;
 }
 
@@ -747,8 +844,12 @@ declare enum VenusMessageId {
     H5_ROOM_ELIMINATE_PLAYER = "H5_ROOM_ELIMINATE_PLAYER",
     H5_ROOM_PROMOTE_TO_SPECTATOR = "H5_ROOM_PROMOTE_TO_SPECTATOR",
     H5_LOAD_EMBEDDED_ASSET = "H5_LOAD_EMBEDDED_ASSET",
+    H5_SHOW_LOAD_SCREEN = "H5_SHOW_LOAD_SCREEN",
+    H5_HIDE_LOAD_SCREEN = "H5_HIDE_LOAD_SCREEN",
+    H5_SET_LOADER_TEXT = "H5_SET_LOADER_TEXT",
+    H5_SET_LOADER_PROGRESS = "H5_SET_LOADER_PROGRESS",
     H5_IAP_OPEN_STORE = "H5_IAP_OPEN_STORE",
     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 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, LifecycleApi, LoadEmbeddedAssetsResponse, type LoggingApi, type MethodIds, MockAdsApi, MockAiApi, MockAnalyticsApi, MockCdnApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockProfileApi, MockSharedAssetsApi, MockSimulationApi, MockStorageApi, MockTimeApi, NavigationApi, NavigationStackInfo, NotificationsApi, OnCleanupCallback, OnHideCallback, OnPauseCallback, OnPlayCallback, OnQuitCallback, OnResumeCallback, OnShowCallback, PlayContext, PopupsApi, type ProfileApi, PushAppOptions, QuitOptions, type Recipe, type RecipeInfo, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLifecycleApi, RpcLoggingApi, type RpcMessage, RpcNavigationApi, RpcNotification, RpcPopupsApi, RpcRequest, RpcResponse, RpcSimulationApi, RpcStorageApi, SDK_VERSION, ScheduleLocalNotification, ScheduleLocalNotificationOptions, type ServerTimeData, SharedAssetsApi, ShowActionSheetOptions, ShowAlertOptions, ShowConfirmOptions, ShowContext, ShowEditorOptions, ShowToastOptions, type ShowToastResponse, type SimulationApi, SpendCurrencyOptions, type StorageApi, type StorageType, SubPath, type TimeApi, type TriggerRecipeChainOptions, VenusMessageId, createMockStorageApi, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializeProfile, initializeSimulation, initializeStackNavigation, initializeStorage, initializeTime, isPacificDaylightTime };
+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 };

package/dist/index.mjs

@@ -1,4 +1,8 @@
-export { HapticFeedbackStyle, HostCdnApi, HostProfileApi, HostTimeApi, MockAdsApi, MockAiApi, MockAnalyticsApi, MockAvatarApi, MockCdnApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockProfileApi, MockSharedAssetsApi, MockSimulationApi, MockStorageApi, MockTimeApi, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLifecycleApi, RpcLoggingApi, RpcNavigationApi, RpcPopupsApi, RpcSharedAssetsApi, RpcSimulationApi, RpcStorageApi, SDK_VERSION, VenusMessageId, createMockStorageApi, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializeProfile, initializeSimulation, initializeStackNavigation, initializeStorage, initializeTime, isPacificDaylightTime } from './chunk-KQZIPQLJ.mjs';
-import './chunk-MWUS3A7C.mjs';
+import { init_rooms } from './chunk-YDXFZ2A2.mjs';
+export { HapticFeedbackStyle, HostCdnApi, HostProfileApi, HostTimeApi, MockAdsApi, MockAiApi, MockAnalyticsApi, MockAvatarApi, MockCdnApi, MockFeaturesApi, MockHapticsApi, MockIapApi, MockLifecycleApi, MockLoggingApi, MockNavigationApi, MockNotificationsApi, MockPopupsApi, MockPreloaderApi, MockProfileApi, MockSharedAssetsApi, MockSimulationApi, MockStorageApi, MockTimeApi, RpcAdsApi, RpcAiApi, RpcAnalyticsApi, RpcAvatarApi, RpcClient, RpcFeaturesApi, RpcHapticsApi, RpcIapApi, RpcLifecycleApi, RpcLoggingApi, RpcNavigationApi, RpcNotificationsApi, RpcPopupsApi, RpcPreloaderApi, RpcSharedAssetsApi, RpcSimulationApi, RpcStorageApi, SDK_VERSION, VenusMessageId, VenusRoom, createMockStorageApi, initializeAds, initializeAi, initializeAnalytics, initializeAvatar3d, initializeCdn, initializeFeaturesApi, initializeHaptics, initializeIap, initializeLifecycleApi, initializeLocalNotifications, initializeLoggingApi, initializePopups, initializePreloader, initializeProfile, initializeRoomsApi, initializeSimulation, initializeStackNavigation, initializeStorage, initializeTime, isPacificDaylightTime, setupRoomNotifications } from './chunk-YDXFZ2A2.mjs';
+import './chunk-W7IPHM67.mjs';
+
+// src/index.ts
+init_rooms();
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;AAeA,UAAA,EAAA","file":"index.mjs","sourcesContent":["export * from './ads'\r\nexport * from './ai'\r\nexport * from './analytics'\r\nexport * from './avatar3d'\r\nexport * from './cdn'\r\nexport * from './features'\r\nexport * from './haptics'\r\nexport * from './iap'\r\nexport * from './lifecycles'\r\nexport * from './logging'\r\nexport * from './navigation'\r\nexport * from './notifications'\r\nexport * from './popups'\r\nexport * from './profile'\r\nexport * from './rpc'\r\nexport * from './rooms'\r\nexport * from './storage'\r\nexport * from './simulation'\r\nexport * from './time'\r\nexport * from './version'\r\nexport * from './shared-assets'\r\nexport * from './VenusMessageId'\r\nexport * from './game-preloader'\r\n"]}