@series-inc/venus-sdk 3.4.2 → 3.4.3-beta.0

package/dist/{AdsApi-ihIIoDSK.d.ts → AdsApi-Dt9Yx0qb.d.ts}

@@ -65,6 +65,7 @@ interface StorageApi {
     clear(): Promise<void>;
     length(): Promise<number>;
     getAllItems(): Promise<string[]>;
+    getAllData(): Promise<Record<string, string>>;
     setMultipleItems(items: {
         key: string;
         value: string;
@@ -444,7 +445,7 @@ interface GetBatchRecipeRequirements {
     results: RecipeRequirementResult[];
 }
 interface SimulationPersonalState {
-    inventory: Record<string, number | string>;
+    entities: Record<string, number | string>;
     activeRuns: SimulationRunSummary[];
     disabledRecipes: string[];
 }
@@ -754,6 +755,9 @@ interface RoomsApi {
     getRoomDataAsync(room: VenusRoom): Promise<Record<string, unknown>>;
     sendRoomMessageAsync(room: VenusRoom, message: RoomMessageRequest): Promise<string>;
     leaveRoomAsync(room: VenusRoom): Promise<void>;
+    kickPlayerAsync(room: VenusRoom, targetProfileId: string, options?: {
+        reason?: string;
+    }): 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>;
@@ -1143,7 +1147,31 @@ interface Host {
     readonly context?: InitializationContext;
     initialize(options?: InitializationOptions): Promise<InitializationContext>;
 }
-declare function createHost(venusApi: VenusAPI, isMock: boolean): Host;
+/**
+ * Create a Host instance based on the runtime environment.
+ *
+ * ## Why SandboxHost uses dynamic import
+ *
+ * SandboxHost depends on Firebase (~200KB+ gzipped) for authentication and
+ * Firestore. This is ONLY needed during local development when using the
+ * Venus sandbox mode (connecting to real Firebase backend via Vite dev server).
+ *
+ * In production builds (H5 games deployed to Venus app):
+ * - `window.__VENUS_SANDBOX__` is never set (Vite plugin only runs in dev)
+ * - `isSandboxEnabled()` returns false
+ * - SandboxHost is never instantiated
+ *
+ * Using a static import like `import { SandboxHost } from './SandboxHost.ts'`
+ * would cause Rollup/Vite to bundle SandboxHost AND all its dependencies
+ * (including Firebase) into the production bundle, even though they're unused.
+ *
+ * Dynamic import (`await import('./SandboxHost.ts')`) tells the bundler to
+ * code-split SandboxHost into a separate chunk that's only loaded at runtime
+ * when the condition is true. In production, this chunk is never loaded.
+ *
+ * This keeps production bundles small (~200KB+ smaller) and faster to load.
+ */
+declare function createHost(venusApi: VenusAPI, isMock: boolean): Promise<Host>;
 
 interface Avatar3dConfig {
     headAsset: string | null;