@milaboratories/pl-middle-layer 1.48.11 → 1.48.13

package/dist/model/project_helper.d.ts

@@ -1,7 +1,9 @@
-import type { ResultOrError, BlockConfig, BlockStorage, PlRef, StorageDebugView } from "@platforma-sdk/model";
-import type { StringifiedJson } from "@milaboratories/pl-model-common";
-import type { QuickJSWASMModule } from "quickjs-emscripten";
-import type { ResourceId } from "@milaboratories/pl-client";
+import { BlockConfig, BlockStorage, PlRef, ResultOrError, StorageDebugView } from "@platforma-sdk/model";
+import { ResourceId } from "@milaboratories/pl-client";
+import { QuickJSWASMModule } from "quickjs-emscripten";
+import { StringifiedJson } from "@milaboratories/pl-model-common";
+
+//#region src/model/project_helper.d.ts
 /**
  * Result of VM-based storage migration.
  * Returned by migrateStorageInVM().
@@ -9,95 +11,97 @@ import type { ResourceId } from "@milaboratories/pl-client";
  * - Error result: { error: string } - serious failure (no context, etc.)
  * - Success result: { newStorageJson: StringifiedJson<BlockStorage>, info: string } - migration succeeded
  */
-export type MigrationResult = {
-    error: string;
+type MigrationResult = {
+  error: string;
 } | {
-    error?: undefined;
-    newStorageJson: StringifiedJson<BlockStorage>;
-    info: string;
+  error?: undefined;
+  newStorageJson: StringifiedJson<BlockStorage>;
+  info: string;
 };
-export declare class ProjectHelper {
-    private readonly quickJs;
-    private readonly enrichmentTargetsCache;
-    constructor(quickJs: QuickJSWASMModule);
-    /**
-     * Derives args directly from storage JSON using VM callback.
-     * The VM extracts data from storage and calls the block's args() function.
-     *
-     * This allows the middle layer to work only with storage JSON,
-     * without needing to know the underlying data structure.
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @param storageJson Storage as JSON string
-     * @returns The derived args object, or error if derivation fails
-     */
-    deriveArgsFromStorage(blockConfig: BlockConfig, storageJson: string): ResultOrError<unknown>;
-    /**
-     * Derives prerunArgs directly from storage JSON using VM callback.
-     * Falls back to args() if prerunArgs is not defined in the block model.
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @param storageJson Storage as JSON string
-     * @returns The derived prerunArgs, or undefined if derivation fails
-     */
-    derivePrerunArgsFromStorage(blockConfig: BlockConfig, storageJson: string): unknown;
-    private calculateEnrichmentTargets;
-    getEnrichmentTargets(blockConfig: () => BlockConfig, args: () => unknown, key?: {
-        argsRid: ResourceId;
-        blockPackRid: ResourceId;
-    }): PlRef[] | undefined;
-    /**
-     * Creates initial BlockStorage for a new block using VM-based transformation.
-     * This calls the '__pl_storage_initial' callback registered by DataModel which:
-     * - Gets initial data from DataModel.getDefaultData()
-     * - Creates BlockStorage with correct version
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @returns Initial storage as JSON string
-     * @throws Error if storage creation fails
-     */
-    getInitialStorageInVM(blockConfig: BlockConfig): string;
-    /**
-     * Applies a state update using VM-based transformation.
-     * This calls the model's `__pl_storage_applyUpdate` callback which:
-     * - Normalizes current storage
-     * - Updates state while preserving other fields (version, plugins)
-     * - Returns the updated storage as JSON string
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @param currentStorageJson Current storage as JSON string (must be defined)
-     * @param newState New state from developer
-     * @returns Updated storage as JSON string
-     * @throws Error if storage update fails
-     */
-    applyStorageUpdateInVM(blockConfig: BlockConfig, currentStorageJson: string, payload: {
-        operation: string;
-        value: unknown;
-    }): string;
-    /**
-     * Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.
-     * Returns structured debug info about the storage (e.g., dataVersion).
-     *
-     * @param blockConfig Block configuration
-     * @param rawStorageJson Raw storage as JSON string (or undefined)
-     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
-     */
-    getStorageDebugViewInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined;
-    /**
-     * Runs block state migrations via VM-based transformation.
-     * This calls the model's `__pl_storage_migrate` callback which:
-     * - Normalizes current storage to get state and version
-     * - Applies DataModel upgrade to reach target version key
-     * - Runs all necessary migrations sequentially
-     * - Returns new storage with updated state and version
-     *
-     * The middle layer doesn't need to know about dataVersion or storage internals.
-     * All migration logic is encapsulated in the model.
-     *
-     * @param blockConfig The NEW block configuration (provides the model code with migrations)
-     * @param currentStorageJson Current storage as JSON string (or undefined)
-     * @returns MigrationResult with new storage or skip/error info
-     */
-    migrateStorageInVM(blockConfig: BlockConfig, currentStorageJson: string | undefined): MigrationResult;
+declare class ProjectHelper {
+  private readonly quickJs;
+  private readonly enrichmentTargetsCache;
+  constructor(quickJs: QuickJSWASMModule);
+  /**
+   * Derives args directly from storage JSON using VM callback.
+   * The VM extracts data from storage and calls the block's args() function.
+   *
+   * This allows the middle layer to work only with storage JSON,
+   * without needing to know the underlying data structure.
+   *
+   * @param blockConfig The block configuration (provides the model code)
+   * @param storageJson Storage as JSON string
+   * @returns The derived args object, or error if derivation fails
+   */
+  deriveArgsFromStorage(blockConfig: BlockConfig, storageJson: string): ResultOrError<unknown>;
+  /**
+   * Derives prerunArgs directly from storage JSON using VM callback.
+   * Falls back to args() if prerunArgs is not defined in the block model.
+   *
+   * @param blockConfig The block configuration (provides the model code)
+   * @param storageJson Storage as JSON string
+   * @returns The derived prerunArgs, or undefined if derivation fails
+   */
+  derivePrerunArgsFromStorage(blockConfig: BlockConfig, storageJson: string): unknown;
+  private calculateEnrichmentTargets;
+  getEnrichmentTargets(blockConfig: () => BlockConfig, args: () => unknown, key?: {
+    argsRid: ResourceId;
+    blockPackRid: ResourceId;
+  }): PlRef[] | undefined;
+  /**
+   * Creates initial BlockStorage for a new block using VM-based transformation.
+   * This calls the '__pl_storage_initial' callback registered by DataModel which:
+   * - Gets initial data from DataModel.getDefaultData()
+   * - Creates BlockStorage with correct version
+   *
+   * @param blockConfig The block configuration (provides the model code)
+   * @returns Initial storage as JSON string
+   * @throws Error if storage creation fails
+   */
+  getInitialStorageInVM(blockConfig: BlockConfig): string;
+  /**
+   * Applies a state update using VM-based transformation.
+   * This calls the model's `__pl_storage_applyUpdate` callback which:
+   * - Normalizes current storage
+   * - Updates state while preserving other fields (version, plugins)
+   * - Returns the updated storage as JSON string
+   *
+   * @param blockConfig The block configuration (provides the model code)
+   * @param currentStorageJson Current storage as JSON string (must be defined)
+   * @param newState New state from developer
+   * @returns Updated storage as JSON string
+   * @throws Error if storage update fails
+   */
+  applyStorageUpdateInVM(blockConfig: BlockConfig, currentStorageJson: string, payload: {
+    operation: string;
+    value: unknown;
+  }): string;
+  /**
+   * Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.
+   * Returns structured debug info about the storage (e.g., dataVersion).
+   *
+   * @param blockConfig Block configuration
+   * @param rawStorageJson Raw storage as JSON string (or undefined)
+   * @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
+   */
+  getStorageDebugViewInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined;
+  /**
+   * Runs block state migrations via VM-based transformation.
+   * This calls the model's `__pl_storage_migrate` callback which:
+   * - Normalizes current storage to get state and version
+   * - Applies DataModel upgrade to reach target version key
+   * - Runs all necessary migrations sequentially
+   * - Returns new storage with updated state and version
+   *
+   * The middle layer doesn't need to know about dataVersion or storage internals.
+   * All migration logic is encapsulated in the model.
+   *
+   * @param blockConfig The NEW block configuration (provides the model code with migrations)
+   * @param currentStorageJson Current storage as JSON string (or undefined)
+   * @returns MigrationResult with new storage or skip/error info
+   */
+  migrateStorageInVM(blockConfig: BlockConfig, currentStorageJson: string | undefined): MigrationResult;
 }
+//#endregion
+export { ProjectHelper };
 //# sourceMappingURL=project_helper.d.ts.map

package/dist/model/project_helper.js

@@ -1,194 +1,156 @@
-import { BLOCK_STORAGE_FACADE_VERSION, BlockStorageFacadeCallbacks, extractCodeWithInfo, ensureError } from '@platforma-sdk/model';
-import { LRUCache } from 'lru-cache';
-import { executeSingleLambda } from '../js_render/index.js';
+import { executeSingleLambda } from "../js_render/index.js";
+import { BLOCK_STORAGE_FACADE_VERSION, BlockStorageFacadeCallbacks, ensureError, extractCodeWithInfo } from "@platforma-sdk/model";
+import { LRUCache } from "lru-cache";
 
-class ProjectHelper {
-    quickJs;
-    enrichmentTargetsCache = new LRUCache({
-        max: 256,
-        memoMethod: (_key, _value, { context }) => {
-            return { value: this.calculateEnrichmentTargets(context) };
-        },
-    });
-    constructor(quickJs) {
-        this.quickJs = quickJs;
-    }
-    // =============================================================================
-    // Args Derivation from Storage (V3+)
-    // =============================================================================
-    /**
-     * Derives args directly from storage JSON using VM callback.
-     * The VM extracts data from storage and calls the block's args() function.
-     *
-     * This allows the middle layer to work only with storage JSON,
-     * without needing to know the underlying data structure.
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @param storageJson Storage as JSON string
-     * @returns The derived args object, or error if derivation fails
-     */
-    deriveArgsFromStorage(blockConfig, storageJson) {
-        if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {
-            return {
-                error: new Error("deriveArgsFromStorage is only supported for model API version 2"),
-            };
-        }
-        try {
-            const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.ArgsDerive], extractCodeWithInfo(blockConfig), storageJson);
-            if (result.error !== undefined) {
-                return { error: new Error(result.error) };
-            }
-            return { value: result.value };
-        }
-        catch (e) {
-            return { error: new Error("Args derivation from storage failed", { cause: ensureError(e) }) };
-        }
-    }
-    /**
-     * Derives prerunArgs directly from storage JSON using VM callback.
-     * Falls back to args() if prerunArgs is not defined in the block model.
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @param storageJson Storage as JSON string
-     * @returns The derived prerunArgs, or undefined if derivation fails
-     */
-    derivePrerunArgsFromStorage(blockConfig, storageJson) {
-        if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("derivePrerunArgsFromStorage is only supported for model API version 2");
-        }
-        try {
-            const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.PrerunArgsDerive], extractCodeWithInfo(blockConfig), storageJson);
-            if (result.error !== undefined) {
-                // Return undefined if derivation fails (skip block in staging)
-                return undefined;
-            }
-            return result.value;
-        }
-        catch {
-            // Return undefined if derivation fails (skip block in staging)
-            return undefined;
-        }
-    }
-    calculateEnrichmentTargets(req) {
-        const blockConfig = req.blockConfig();
-        if (blockConfig.enrichmentTargets === undefined)
-            return undefined;
-        const args = req.args();
-        const result = executeSingleLambda(this.quickJs, blockConfig.enrichmentTargets, extractCodeWithInfo(blockConfig), args);
-        return result;
-    }
-    getEnrichmentTargets(blockConfig, args, key) {
-        const req = { blockConfig, args };
-        if (key === undefined)
-            return this.calculateEnrichmentTargets(req);
-        const cacheKey = `${key.argsRid}:${key.blockPackRid}`;
-        return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;
-    }
-    // =============================================================================
-    // VM-based Storage Operations
-    // =============================================================================
-    /**
-     * Creates initial BlockStorage for a new block using VM-based transformation.
-     * This calls the '__pl_storage_initial' callback registered by DataModel which:
-     * - Gets initial data from DataModel.getDefaultData()
-     * - Creates BlockStorage with correct version
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @returns Initial storage as JSON string
-     * @throws Error if storage creation fails
-     */
-    getInitialStorageInVM(blockConfig) {
-        if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("getInitialStorageInVM is only supported for model API version 2");
-        }
-        try {
-            const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageInitial], extractCodeWithInfo(blockConfig));
-            return result;
-        }
-        catch (e) {
-            console.error("[ProjectHelper.getInitialStorageInVM] Initial storage creation failed:", e);
-            throw new Error(`Block initial storage creation failed: ${e}`);
-        }
-    }
-    /**
-     * Applies a state update using VM-based transformation.
-     * This calls the model's `__pl_storage_applyUpdate` callback which:
-     * - Normalizes current storage
-     * - Updates state while preserving other fields (version, plugins)
-     * - Returns the updated storage as JSON string
-     *
-     * @param blockConfig The block configuration (provides the model code)
-     * @param currentStorageJson Current storage as JSON string (must be defined)
-     * @param newState New state from developer
-     * @returns Updated storage as JSON string
-     * @throws Error if storage update fails
-     */
-    applyStorageUpdateInVM(blockConfig, currentStorageJson, payload) {
-        if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("applyStorageUpdateInVM is only supported for model API version 2");
-        }
-        try {
-            const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageApplyUpdate], extractCodeWithInfo(blockConfig), currentStorageJson, payload);
-            return result;
-        }
-        catch (e) {
-            console.error("[ProjectHelper.applyStorageUpdateInVM] Storage update failed:", e);
-            throw new Error(`Block storage update failed: ${e}`);
-        }
-    }
-    /**
-     * Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.
-     * Returns structured debug info about the storage (e.g., dataVersion).
-     *
-     * @param blockConfig Block configuration
-     * @param rawStorageJson Raw storage as JSON string (or undefined)
-     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
-     */
-    getStorageDebugViewInVM(blockConfig, rawStorageJson) {
-        if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("getStorageDebugViewInVM is only supported for model API version 2");
-        }
-        try {
-            const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageDebugView], extractCodeWithInfo(blockConfig), rawStorageJson);
-            return result;
-        }
-        catch (e) {
-            console.error("[ProjectHelper.getStorageDebugViewInVM] Get storage debug view failed:", e);
-            return undefined;
-        }
-    }
-    // =============================================================================
-    // Block State Migrations
-    // =============================================================================
-    /**
-     * Runs block state migrations via VM-based transformation.
-     * This calls the model's `__pl_storage_migrate` callback which:
-     * - Normalizes current storage to get state and version
-     * - Applies DataModel upgrade to reach target version key
-     * - Runs all necessary migrations sequentially
-     * - Returns new storage with updated state and version
-     *
-     * The middle layer doesn't need to know about dataVersion or storage internals.
-     * All migration logic is encapsulated in the model.
-     *
-     * @param blockConfig The NEW block configuration (provides the model code with migrations)
-     * @param currentStorageJson Current storage as JSON string (or undefined)
-     * @returns MigrationResult with new storage or skip/error info
-     */
-    migrateStorageInVM(blockConfig, currentStorageJson) {
-        if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {
-            return { error: "migrateStorageInVM is only supported for model API version 2" };
-        }
-        try {
-            const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageMigrate], extractCodeWithInfo(blockConfig), currentStorageJson);
-            return result;
-        }
-        catch (e) {
-            console.error("[ProjectHelper.migrateStorageInVM] Migration failed:", e);
-            return { error: `VM execution failed: ${e}` };
-        }
-    }
-}
+//#region src/model/project_helper.ts
+var ProjectHelper = class {
+	enrichmentTargetsCache = new LRUCache({
+		max: 256,
+		memoMethod: (_key, _value, { context }) => {
+			return { value: this.calculateEnrichmentTargets(context) };
+		}
+	});
+	constructor(quickJs) {
+		this.quickJs = quickJs;
+	}
+	/**
+	* Derives args directly from storage JSON using VM callback.
+	* The VM extracts data from storage and calls the block's args() function.
+	*
+	* This allows the middle layer to work only with storage JSON,
+	* without needing to know the underlying data structure.
+	*
+	* @param blockConfig The block configuration (provides the model code)
+	* @param storageJson Storage as JSON string
+	* @returns The derived args object, or error if derivation fails
+	*/
+	deriveArgsFromStorage(blockConfig, storageJson) {
+		if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) return { error: /* @__PURE__ */ new Error("deriveArgsFromStorage is only supported for model API version 2") };
+		try {
+			const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.ArgsDerive], extractCodeWithInfo(blockConfig), storageJson);
+			if (result.error !== void 0) return { error: new Error(result.error) };
+			return { value: result.value };
+		} catch (e) {
+			return { error: new Error("Args derivation from storage failed", { cause: ensureError(e) }) };
+		}
+	}
+	/**
+	* Derives prerunArgs directly from storage JSON using VM callback.
+	* Falls back to args() if prerunArgs is not defined in the block model.
+	*
+	* @param blockConfig The block configuration (provides the model code)
+	* @param storageJson Storage as JSON string
+	* @returns The derived prerunArgs, or undefined if derivation fails
+	*/
+	derivePrerunArgsFromStorage(blockConfig, storageJson) {
+		if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) throw new Error("derivePrerunArgsFromStorage is only supported for model API version 2");
+		try {
+			const result = executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.PrerunArgsDerive], extractCodeWithInfo(blockConfig), storageJson);
+			if (result.error !== void 0) return;
+			return result.value;
+		} catch {
+			return;
+		}
+	}
+	calculateEnrichmentTargets(req) {
+		const blockConfig = req.blockConfig();
+		if (blockConfig.enrichmentTargets === void 0) return void 0;
+		const args = req.args();
+		return executeSingleLambda(this.quickJs, blockConfig.enrichmentTargets, extractCodeWithInfo(blockConfig), args);
+	}
+	getEnrichmentTargets(blockConfig, args, key) {
+		const req = {
+			blockConfig,
+			args
+		};
+		if (key === void 0) return this.calculateEnrichmentTargets(req);
+		const cacheKey = `${key.argsRid}:${key.blockPackRid}`;
+		return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;
+	}
+	/**
+	* Creates initial BlockStorage for a new block using VM-based transformation.
+	* This calls the '__pl_storage_initial' callback registered by DataModel which:
+	* - Gets initial data from DataModel.getDefaultData()
+	* - Creates BlockStorage with correct version
+	*
+	* @param blockConfig The block configuration (provides the model code)
+	* @returns Initial storage as JSON string
+	* @throws Error if storage creation fails
+	*/
+	getInitialStorageInVM(blockConfig) {
+		if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) throw new Error("getInitialStorageInVM is only supported for model API version 2");
+		try {
+			return executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageInitial], extractCodeWithInfo(blockConfig));
+		} catch (e) {
+			console.error("[ProjectHelper.getInitialStorageInVM] Initial storage creation failed:", e);
+			throw new Error(`Block initial storage creation failed: ${e}`);
+		}
+	}
+	/**
+	* Applies a state update using VM-based transformation.
+	* This calls the model's `__pl_storage_applyUpdate` callback which:
+	* - Normalizes current storage
+	* - Updates state while preserving other fields (version, plugins)
+	* - Returns the updated storage as JSON string
+	*
+	* @param blockConfig The block configuration (provides the model code)
+	* @param currentStorageJson Current storage as JSON string (must be defined)
+	* @param newState New state from developer
+	* @returns Updated storage as JSON string
+	* @throws Error if storage update fails
+	*/
+	applyStorageUpdateInVM(blockConfig, currentStorageJson, payload) {
+		if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) throw new Error("applyStorageUpdateInVM is only supported for model API version 2");
+		try {
+			return executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageApplyUpdate], extractCodeWithInfo(blockConfig), currentStorageJson, payload);
+		} catch (e) {
+			console.error("[ProjectHelper.applyStorageUpdateInVM] Storage update failed:", e);
+			throw new Error(`Block storage update failed: ${e}`);
+		}
+	}
+	/**
+	* Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.
+	* Returns structured debug info about the storage (e.g., dataVersion).
+	*
+	* @param blockConfig Block configuration
+	* @param rawStorageJson Raw storage as JSON string (or undefined)
+	* @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
+	*/
+	getStorageDebugViewInVM(blockConfig, rawStorageJson) {
+		if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) throw new Error("getStorageDebugViewInVM is only supported for model API version 2");
+		try {
+			return executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageDebugView], extractCodeWithInfo(blockConfig), rawStorageJson);
+		} catch (e) {
+			console.error("[ProjectHelper.getStorageDebugViewInVM] Get storage debug view failed:", e);
+			return;
+		}
+	}
+	/**
+	* Runs block state migrations via VM-based transformation.
+	* This calls the model's `__pl_storage_migrate` callback which:
+	* - Normalizes current storage to get state and version
+	* - Applies DataModel upgrade to reach target version key
+	* - Runs all necessary migrations sequentially
+	* - Returns new storage with updated state and version
+	*
+	* The middle layer doesn't need to know about dataVersion or storage internals.
+	* All migration logic is encapsulated in the model.
+	*
+	* @param blockConfig The NEW block configuration (provides the model code with migrations)
+	* @param currentStorageJson Current storage as JSON string (or undefined)
+	* @returns MigrationResult with new storage or skip/error info
+	*/
+	migrateStorageInVM(blockConfig, currentStorageJson) {
+		if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) return { error: "migrateStorageInVM is only supported for model API version 2" };
+		try {
+			return executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageMigrate], extractCodeWithInfo(blockConfig), currentStorageJson);
+		} catch (e) {
+			console.error("[ProjectHelper.migrateStorageInVM] Migration failed:", e);
+			return { error: `VM execution failed: ${e}` };
+		}
+	}
+};
 
+//#endregion
 export { ProjectHelper };
-//# sourceMappingURL=project_helper.js.map
+//# sourceMappingURL=project_helper.js.map