@milaboratories/pl-middle-layer 1.48.11 → 1.48.13

package/dist/model/block_pack_spec.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_pack_spec.cjs","sources":["../../src/model/block_pack_spec.ts"],"sourcesContent":["import type { ExplicitTemplate, PreparedTemplate } from \"./template_spec\";\nimport type { ResourceType } from \"@milaboratories/pl-client\";\nimport type { BlockConfigContainer } from \"@platforma-sdk/model\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\n\nexport type FrontendSpec = FrontendFromUrl | FrontendFromFolder;\n\nexport interface FrontendFromUrlData {\n  url: string;\n}\n\nexport const FrontendFromUrlResourceType: ResourceType = { name: \"Frontend/FromUrl\", version: \"1\" };\n\n/** Directs user of the block pack to download the contents from the URL\n * outside the pl infrastructure. */\nexport interface FrontendFromUrl extends FrontendFromUrlData {\n  type: \"url\";\n}\n\nexport interface FrontendFromFolderData {\n  path: string;\n  /** HMAC signature of the path using local secret encoded as hex. */\n  signature: string;\n}\n\nexport const FrontendFromFolderResourceType: ResourceType = {\n  name: \"Frontend/FromFolder\",\n  version: \"1\",\n};\n\n/** Directs user of the block pack to load frontend from specific local\n * folder. Signature allows to confirm that this is the same client who\n * added the resource. */\nexport interface FrontendFromFolder extends FrontendFromFolderData {\n  type: \"local\";\n}\n\n/** Direct instructions to create block-pack from client. Currently, this\n * is the only block-pack spec that can be directly materialized. */\nexport interface BlockPackExplicit {\n  type: \"explicit\";\n  template: ExplicitTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n}\n\n/** Block-pack spec that can be materialized in pl. */\nexport type BlockPackSpecPrepared = {\n  type: \"prepared\";\n  template: PreparedTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n};\n\n/** All block-pack specs. */\nexport type BlockPackSpecAny = BlockPackSpecPrepared | BlockPackExplicit | BlockPackSpec;\n"],"names":[],"mappings":";;AAWO,MAAM,2BAA2B,GAAiB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG;AAc1F,MAAM,8BAA8B,GAAiB;AAC1D,IAAA,IAAI,EAAE,qBAAqB;AAC3B,IAAA,OAAO,EAAE,GAAG;;;;;;"}
+{"version":3,"file":"block_pack_spec.cjs","names":[],"sources":["../../src/model/block_pack_spec.ts"],"sourcesContent":["import type { ExplicitTemplate, PreparedTemplate } from \"./template_spec\";\nimport type { ResourceType } from \"@milaboratories/pl-client\";\nimport type { BlockConfigContainer } from \"@platforma-sdk/model\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\n\nexport type FrontendSpec = FrontendFromUrl | FrontendFromFolder;\n\nexport interface FrontendFromUrlData {\n  url: string;\n}\n\nexport const FrontendFromUrlResourceType: ResourceType = { name: \"Frontend/FromUrl\", version: \"1\" };\n\n/** Directs user of the block pack to download the contents from the URL\n * outside the pl infrastructure. */\nexport interface FrontendFromUrl extends FrontendFromUrlData {\n  type: \"url\";\n}\n\nexport interface FrontendFromFolderData {\n  path: string;\n  /** HMAC signature of the path using local secret encoded as hex. */\n  signature: string;\n}\n\nexport const FrontendFromFolderResourceType: ResourceType = {\n  name: \"Frontend/FromFolder\",\n  version: \"1\",\n};\n\n/** Directs user of the block pack to load frontend from specific local\n * folder. Signature allows to confirm that this is the same client who\n * added the resource. */\nexport interface FrontendFromFolder extends FrontendFromFolderData {\n  type: \"local\";\n}\n\n/** Direct instructions to create block-pack from client. Currently, this\n * is the only block-pack spec that can be directly materialized. */\nexport interface BlockPackExplicit {\n  type: \"explicit\";\n  template: ExplicitTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n}\n\n/** Block-pack spec that can be materialized in pl. */\nexport type BlockPackSpecPrepared = {\n  type: \"prepared\";\n  template: PreparedTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n};\n\n/** All block-pack specs. */\nexport type BlockPackSpecAny = BlockPackSpecPrepared | BlockPackExplicit | BlockPackSpec;\n"],"mappings":";;AAWA,MAAa,8BAA4C;CAAE,MAAM;CAAoB,SAAS;CAAK;AAcnG,MAAa,iCAA+C;CAC1D,MAAM;CACN,SAAS;CACV"}

package/dist/model/block_pack_spec.d.ts

@@ -1,46 +1,50 @@
-import type { ExplicitTemplate, PreparedTemplate } from "./template_spec";
-import type { ResourceType } from "@milaboratories/pl-client";
-import type { BlockConfigContainer } from "@platforma-sdk/model";
-import type { BlockPackSpec } from "@milaboratories/pl-model-middle-layer";
-export type FrontendSpec = FrontendFromUrl | FrontendFromFolder;
-export interface FrontendFromUrlData {
-    url: string;
+import { ExplicitTemplate, PreparedTemplate } from "./template_spec.js";
+import { BlockConfigContainer } from "@platforma-sdk/model";
+import { BlockPackSpec } from "@milaboratories/pl-model-middle-layer";
+import { ResourceType } from "@milaboratories/pl-client";
+
+//#region src/model/block_pack_spec.d.ts
+type FrontendSpec = FrontendFromUrl | FrontendFromFolder;
+interface FrontendFromUrlData {
+  url: string;
 }
-export declare const FrontendFromUrlResourceType: ResourceType;
+declare const FrontendFromUrlResourceType: ResourceType;
 /** Directs user of the block pack to download the contents from the URL
  * outside the pl infrastructure. */
-export interface FrontendFromUrl extends FrontendFromUrlData {
-    type: "url";
+interface FrontendFromUrl extends FrontendFromUrlData {
+  type: "url";
 }
-export interface FrontendFromFolderData {
-    path: string;
-    /** HMAC signature of the path using local secret encoded as hex. */
-    signature: string;
+interface FrontendFromFolderData {
+  path: string;
+  /** HMAC signature of the path using local secret encoded as hex. */
+  signature: string;
 }
-export declare const FrontendFromFolderResourceType: ResourceType;
+declare const FrontendFromFolderResourceType: ResourceType;
 /** Directs user of the block pack to load frontend from specific local
  * folder. Signature allows to confirm that this is the same client who
  * added the resource. */
-export interface FrontendFromFolder extends FrontendFromFolderData {
-    type: "local";
+interface FrontendFromFolder extends FrontendFromFolderData {
+  type: "local";
 }
 /** Direct instructions to create block-pack from client. Currently, this
  * is the only block-pack spec that can be directly materialized. */
-export interface BlockPackExplicit {
-    type: "explicit";
-    template: ExplicitTemplate;
-    config: BlockConfigContainer;
-    frontend: FrontendSpec;
-    source: BlockPackSpec;
+interface BlockPackExplicit {
+  type: "explicit";
+  template: ExplicitTemplate;
+  config: BlockConfigContainer;
+  frontend: FrontendSpec;
+  source: BlockPackSpec;
 }
 /** Block-pack spec that can be materialized in pl. */
-export type BlockPackSpecPrepared = {
-    type: "prepared";
-    template: PreparedTemplate;
-    config: BlockConfigContainer;
-    frontend: FrontendSpec;
-    source: BlockPackSpec;
+type BlockPackSpecPrepared = {
+  type: "prepared";
+  template: PreparedTemplate;
+  config: BlockConfigContainer;
+  frontend: FrontendSpec;
+  source: BlockPackSpec;
 };
 /** All block-pack specs. */
-export type BlockPackSpecAny = BlockPackSpecPrepared | BlockPackExplicit | BlockPackSpec;
+type BlockPackSpecAny = BlockPackSpecPrepared | BlockPackExplicit | BlockPackSpec;
+//#endregion
+export { BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec };
 //# sourceMappingURL=block_pack_spec.d.ts.map

package/dist/model/block_pack_spec.js

@@ -1,8 +1,13 @@
-const FrontendFromUrlResourceType = { name: "Frontend/FromUrl", version: "1" };
+//#region src/model/block_pack_spec.ts
+const FrontendFromUrlResourceType = {
+	name: "Frontend/FromUrl",
+	version: "1"
+};
 const FrontendFromFolderResourceType = {
-    name: "Frontend/FromFolder",
-    version: "1",
+	name: "Frontend/FromFolder",
+	version: "1"
 };
 
+//#endregion
 export { FrontendFromFolderResourceType, FrontendFromUrlResourceType };
-//# sourceMappingURL=block_pack_spec.js.map
+//# sourceMappingURL=block_pack_spec.js.map

package/dist/model/block_pack_spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_pack_spec.js","sources":["../../src/model/block_pack_spec.ts"],"sourcesContent":["import type { ExplicitTemplate, PreparedTemplate } from \"./template_spec\";\nimport type { ResourceType } from \"@milaboratories/pl-client\";\nimport type { BlockConfigContainer } from \"@platforma-sdk/model\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\n\nexport type FrontendSpec = FrontendFromUrl | FrontendFromFolder;\n\nexport interface FrontendFromUrlData {\n  url: string;\n}\n\nexport const FrontendFromUrlResourceType: ResourceType = { name: \"Frontend/FromUrl\", version: \"1\" };\n\n/** Directs user of the block pack to download the contents from the URL\n * outside the pl infrastructure. */\nexport interface FrontendFromUrl extends FrontendFromUrlData {\n  type: \"url\";\n}\n\nexport interface FrontendFromFolderData {\n  path: string;\n  /** HMAC signature of the path using local secret encoded as hex. */\n  signature: string;\n}\n\nexport const FrontendFromFolderResourceType: ResourceType = {\n  name: \"Frontend/FromFolder\",\n  version: \"1\",\n};\n\n/** Directs user of the block pack to load frontend from specific local\n * folder. Signature allows to confirm that this is the same client who\n * added the resource. */\nexport interface FrontendFromFolder extends FrontendFromFolderData {\n  type: \"local\";\n}\n\n/** Direct instructions to create block-pack from client. Currently, this\n * is the only block-pack spec that can be directly materialized. */\nexport interface BlockPackExplicit {\n  type: \"explicit\";\n  template: ExplicitTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n}\n\n/** Block-pack spec that can be materialized in pl. */\nexport type BlockPackSpecPrepared = {\n  type: \"prepared\";\n  template: PreparedTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n};\n\n/** All block-pack specs. */\nexport type BlockPackSpecAny = BlockPackSpecPrepared | BlockPackExplicit | BlockPackSpec;\n"],"names":[],"mappings":"AAWO,MAAM,2BAA2B,GAAiB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,GAAG;AAc1F,MAAM,8BAA8B,GAAiB;AAC1D,IAAA,IAAI,EAAE,qBAAqB;AAC3B,IAAA,OAAO,EAAE,GAAG;;;;;"}
+{"version":3,"file":"block_pack_spec.js","names":[],"sources":["../../src/model/block_pack_spec.ts"],"sourcesContent":["import type { ExplicitTemplate, PreparedTemplate } from \"./template_spec\";\nimport type { ResourceType } from \"@milaboratories/pl-client\";\nimport type { BlockConfigContainer } from \"@platforma-sdk/model\";\nimport type { BlockPackSpec } from \"@milaboratories/pl-model-middle-layer\";\n\nexport type FrontendSpec = FrontendFromUrl | FrontendFromFolder;\n\nexport interface FrontendFromUrlData {\n  url: string;\n}\n\nexport const FrontendFromUrlResourceType: ResourceType = { name: \"Frontend/FromUrl\", version: \"1\" };\n\n/** Directs user of the block pack to download the contents from the URL\n * outside the pl infrastructure. */\nexport interface FrontendFromUrl extends FrontendFromUrlData {\n  type: \"url\";\n}\n\nexport interface FrontendFromFolderData {\n  path: string;\n  /** HMAC signature of the path using local secret encoded as hex. */\n  signature: string;\n}\n\nexport const FrontendFromFolderResourceType: ResourceType = {\n  name: \"Frontend/FromFolder\",\n  version: \"1\",\n};\n\n/** Directs user of the block pack to load frontend from specific local\n * folder. Signature allows to confirm that this is the same client who\n * added the resource. */\nexport interface FrontendFromFolder extends FrontendFromFolderData {\n  type: \"local\";\n}\n\n/** Direct instructions to create block-pack from client. Currently, this\n * is the only block-pack spec that can be directly materialized. */\nexport interface BlockPackExplicit {\n  type: \"explicit\";\n  template: ExplicitTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n}\n\n/** Block-pack spec that can be materialized in pl. */\nexport type BlockPackSpecPrepared = {\n  type: \"prepared\";\n  template: PreparedTemplate;\n  config: BlockConfigContainer;\n  frontend: FrontendSpec;\n  source: BlockPackSpec;\n};\n\n/** All block-pack specs. */\nexport type BlockPackSpecAny = BlockPackSpecPrepared | BlockPackExplicit | BlockPackSpec;\n"],"mappings":";AAWA,MAAa,8BAA4C;CAAE,MAAM;CAAoB,SAAS;CAAK;AAcnG,MAAa,iCAA+C;CAC1D,MAAM;CACN,SAAS;CACV"}

package/dist/model/frontend.d.ts

@@ -1,10 +1,13 @@
+//#region src/model/frontend.d.ts
 /** Middle layer provides information about where frontend for a specific block
  * was unpacked and basic meta information about the enclosed UI
  * (i.e. SDK version). */
-export interface FrontendData {
-    /** URL of the frontend */
-    readonly url: string;
-    /** SDK version used by the UI */
-    readonly sdkVersion: string;
+interface FrontendData {
+  /** URL of the frontend */
+  readonly url: string;
+  /** SDK version used by the UI */
+  readonly sdkVersion: string;
 }
+//#endregion
+export { FrontendData };
 //# sourceMappingURL=frontend.d.ts.map

package/dist/model/index.d.ts

@@ -1,3 +1,2 @@
-export * from "./block_pack_spec";
-export { type ProjectListEntry, type ProjectField } from "./project_model";
-//# sourceMappingURL=index.d.ts.map
+import { BlockPackExplicit, BlockPackSpecAny, BlockPackSpecPrepared, FrontendFromFolder, FrontendFromFolderData, FrontendFromFolderResourceType, FrontendFromUrl, FrontendFromUrlData, FrontendFromUrlResourceType, FrontendSpec } from "./block_pack_spec.js";
+import { ProjectField, ProjectListEntry } from "./project_model.js";

package/dist/model/project_helper.cjs

@@ -1,196 +1,157 @@
-'use strict';
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_index = require('../js_render/index.cjs');
+let _platforma_sdk_model = require("@platforma-sdk/model");
+let lru_cache = require("lru-cache");
 
-var model = require('@platforma-sdk/model');
-var lruCache = require('lru-cache');
-var index = require('../js_render/index.cjs');
-
-class ProjectHelper {
-    quickJs;
-    enrichmentTargetsCache = new lruCache.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 !== model.BLOCK_STORAGE_FACADE_VERSION) {
-            return {
-                error: new Error("deriveArgsFromStorage is only supported for model API version 2"),
-            };
-        }
-        try {
-            const result = index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[model.BlockStorageFacadeCallbacks.ArgsDerive], model.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: model.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 !== model.BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("derivePrerunArgsFromStorage is only supported for model API version 2");
-        }
-        try {
-            const result = index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[model.BlockStorageFacadeCallbacks.PrerunArgsDerive], model.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 = index.executeSingleLambda(this.quickJs, blockConfig.enrichmentTargets, model.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 !== model.BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("getInitialStorageInVM is only supported for model API version 2");
-        }
-        try {
-            const result = index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[model.BlockStorageFacadeCallbacks.StorageInitial], model.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 !== model.BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("applyStorageUpdateInVM is only supported for model API version 2");
-        }
-        try {
-            const result = index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[model.BlockStorageFacadeCallbacks.StorageApplyUpdate], model.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 !== model.BLOCK_STORAGE_FACADE_VERSION) {
-            throw new Error("getStorageDebugViewInVM is only supported for model API version 2");
-        }
-        try {
-            const result = index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[model.BlockStorageFacadeCallbacks.StorageDebugView], model.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 !== model.BLOCK_STORAGE_FACADE_VERSION) {
-            return { error: "migrateStorageInVM is only supported for model API version 2" };
-        }
-        try {
-            const result = index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[model.BlockStorageFacadeCallbacks.StorageMigrate], model.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 lru_cache.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 !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) return { error: /* @__PURE__ */ new Error("deriveArgsFromStorage is only supported for model API version 2") };
+		try {
+			const result = require_index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.ArgsDerive], (0, _platforma_sdk_model.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: (0, _platforma_sdk_model.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 !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) throw new Error("derivePrerunArgsFromStorage is only supported for model API version 2");
+		try {
+			const result = require_index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.PrerunArgsDerive], (0, _platforma_sdk_model.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 require_index.executeSingleLambda(this.quickJs, blockConfig.enrichmentTargets, (0, _platforma_sdk_model.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 !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) throw new Error("getInitialStorageInVM is only supported for model API version 2");
+		try {
+			return require_index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.StorageInitial], (0, _platforma_sdk_model.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 !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) throw new Error("applyStorageUpdateInVM is only supported for model API version 2");
+		try {
+			return require_index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.StorageApplyUpdate], (0, _platforma_sdk_model.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 !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) throw new Error("getStorageDebugViewInVM is only supported for model API version 2");
+		try {
+			return require_index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.StorageDebugView], (0, _platforma_sdk_model.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 !== _platforma_sdk_model.BLOCK_STORAGE_FACADE_VERSION) return { error: "migrateStorageInVM is only supported for model API version 2" };
+		try {
+			return require_index.executeSingleLambda(this.quickJs, blockConfig.blockLifecycleCallbacks[_platforma_sdk_model.BlockStorageFacadeCallbacks.StorageMigrate], (0, _platforma_sdk_model.extractCodeWithInfo)(blockConfig), currentStorageJson);
+		} catch (e) {
+			console.error("[ProjectHelper.migrateStorageInVM] Migration failed:", e);
+			return { error: `VM execution failed: ${e}` };
+		}
+	}
+};
 
+//#endregion
 exports.ProjectHelper = ProjectHelper;
-//# sourceMappingURL=project_helper.cjs.map
+//# sourceMappingURL=project_helper.cjs.map

package/dist/model/project_helper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.cjs","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type {\n  ResultOrError,\n  BlockConfig,\n  BlockStorage,\n  PlRef,\n  StorageDebugView,\n} from \"@platforma-sdk/model\";\nimport type { StringifiedJson } from \"@milaboratories/pl-model-common\";\nimport {\n  extractCodeWithInfo,\n  ensureError,\n  BlockStorageFacadeCallbacks,\n  BLOCK_STORAGE_FACADE_VERSION,\n} from \"@platforma-sdk/model\";\nimport { LRUCache } from \"lru-cache\";\nimport type { QuickJSWASMModule } from \"quickjs-emscripten\";\nimport { executeSingleLambda } from \"../js_render\";\nimport type { ResourceId } from \"@milaboratories/pl-client\";\n\ntype EnrichmentTargetsRequest = {\n  blockConfig: () => BlockConfig;\n  args: () => unknown;\n};\n\ntype EnrichmentTargetsValue = {\n  value: PlRef[] | undefined;\n};\n\n/**\n * Result of VM-based storage migration.\n * Returned by migrateStorageInVM().\n *\n * - Error result: { error: string } - serious failure (no context, etc.)\n * - Success result: { newStorageJson: StringifiedJson<BlockStorage>, info: string } - migration succeeded\n */\nexport type MigrationResult =\n  | { error: string }\n  | { error?: undefined; newStorageJson: StringifiedJson<BlockStorage>; info: string };\n\n/**\n * Result of args derivation from storage.\n * Returned by __pl_args_derive and __pl_prerunArgs_derive VM callbacks.\n */\ntype ArgsDeriveResult = { error: string } | { error?: undefined; value: unknown };\n\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<\n    string,\n    EnrichmentTargetsValue,\n    EnrichmentTargetsRequest\n  >({\n    max: 256,\n    memoMethod: (_key, _value, { context }) => {\n      return { value: this.calculateEnrichmentTargets(context) };\n    },\n  });\n\n  constructor(private readonly quickJs: QuickJSWASMModule) {}\n\n  // =============================================================================\n  // Args Derivation from Storage (V3+)\n  // =============================================================================\n\n  /**\n   * Derives args directly from storage JSON using VM callback.\n   * The VM extracts data from storage and calls the block's args() function.\n   *\n   * This allows the middle layer to work only with storage JSON,\n   * without needing to know the underlying data structure.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived args object, or error if derivation fails\n   */\n  public deriveArgsFromStorage(\n    blockConfig: BlockConfig,\n    storageJson: string,\n  ): ResultOrError<unknown> {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return {\n        error: new Error(\"deriveArgsFromStorage is only supported for model API version 2\"),\n      };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.ArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        return { error: new Error(result.error) };\n      }\n      return { value: result.value };\n    } catch (e) {\n      return { error: new Error(\"Args derivation from storage failed\", { cause: ensureError(e) }) };\n    }\n  }\n\n  /**\n   * Derives prerunArgs directly from storage JSON using VM callback.\n   * Falls back to args() if prerunArgs is not defined in the block model.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived prerunArgs, or undefined if derivation fails\n   */\n  public derivePrerunArgsFromStorage(blockConfig: BlockConfig, storageJson: string): unknown {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"derivePrerunArgsFromStorage is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.PrerunArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        // Return undefined if derivation fails (skip block in staging)\n        return undefined;\n      }\n      return result.value;\n    } catch {\n      // Return undefined if derivation fails (skip block in staging)\n      return undefined;\n    }\n  }\n\n  private calculateEnrichmentTargets(req: EnrichmentTargetsRequest): PlRef[] | undefined {\n    const blockConfig = req.blockConfig();\n    if (blockConfig.enrichmentTargets === undefined) return undefined;\n    const args = req.args();\n    const result = executeSingleLambda(\n      this.quickJs,\n      blockConfig.enrichmentTargets,\n      extractCodeWithInfo(blockConfig),\n      args,\n    ) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(\n    blockConfig: () => BlockConfig,\n    args: () => unknown,\n    key?: { argsRid: ResourceId; blockPackRid: ResourceId },\n  ): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined) return this.calculateEnrichmentTargets(req);\n    const cacheKey = `${key.argsRid}:${key.blockPackRid}`;\n    return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;\n  }\n\n  // =============================================================================\n  // VM-based Storage Operations\n  // =============================================================================\n\n  /**\n   * Creates initial BlockStorage for a new block using VM-based transformation.\n   * This calls the '__pl_storage_initial' callback registered by DataModel which:\n   * - Gets initial data from DataModel.getDefaultData()\n   * - Creates BlockStorage with correct version\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @returns Initial storage as JSON string\n   * @throws Error if storage creation fails\n   */\n  public getInitialStorageInVM(blockConfig: BlockConfig): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getInitialStorageInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageInitial],\n        extractCodeWithInfo(blockConfig),\n      ) as string;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.getInitialStorageInVM] Initial storage creation failed:\", e);\n      throw new Error(`Block initial storage creation failed: ${e}`);\n    }\n  }\n\n  /**\n   * Applies a state update using VM-based transformation.\n   * This calls the model's `__pl_storage_applyUpdate` callback which:\n   * - Normalizes current storage\n   * - Updates state while preserving other fields (version, plugins)\n   * - Returns the updated storage as JSON string\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param currentStorageJson Current storage as JSON string (must be defined)\n   * @param newState New state from developer\n   * @returns Updated storage as JSON string\n   * @throws Error if storage update fails\n   */\n  public applyStorageUpdateInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string,\n    payload: { operation: string; value: unknown },\n  ): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"applyStorageUpdateInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageApplyUpdate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n        payload,\n      ) as string;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.applyStorageUpdateInVM] Storage update failed:\", e);\n      throw new Error(`Block storage update failed: ${e}`);\n    }\n  }\n\n  /**\n   * Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.\n   * Returns structured debug info about the storage (e.g., dataVersion).\n   *\n   * @param blockConfig Block configuration\n   * @param rawStorageJson Raw storage as JSON string (or undefined)\n   * @returns Storage debug view as JSON string (e.g., '{\"dataVersion\": \"v1\"}')\n   */\n  public getStorageDebugViewInVM(\n    blockConfig: BlockConfig,\n    rawStorageJson: string | undefined,\n  ): StringifiedJson<StorageDebugView> | undefined {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getStorageDebugViewInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageDebugView],\n        extractCodeWithInfo(blockConfig),\n        rawStorageJson,\n      ) as StringifiedJson<StorageDebugView>;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.getStorageDebugViewInVM] Get storage debug view failed:\", e);\n      return undefined;\n    }\n  }\n\n  // =============================================================================\n  // Block State Migrations\n  // =============================================================================\n\n  /**\n   * Runs block state migrations via VM-based transformation.\n   * This calls the model's `__pl_storage_migrate` callback which:\n   * - Normalizes current storage to get state and version\n   * - Applies DataModel upgrade to reach target version key\n   * - Runs all necessary migrations sequentially\n   * - Returns new storage with updated state and version\n   *\n   * The middle layer doesn't need to know about dataVersion or storage internals.\n   * All migration logic is encapsulated in the model.\n   *\n   * @param blockConfig The NEW block configuration (provides the model code with migrations)\n   * @param currentStorageJson Current storage as JSON string (or undefined)\n   * @returns MigrationResult with new storage or skip/error info\n   */\n  public migrateStorageInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string | undefined,\n  ): MigrationResult {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return { error: \"migrateStorageInVM is only supported for model API version 2\" };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageMigrate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n      ) as MigrationResult;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.migrateStorageInVM] Migration failed:\", e);\n      return { error: `VM execution failed: ${e}` };\n    }\n  }\n}\n"],"names":["LRUCache","BLOCK_STORAGE_FACADE_VERSION","executeSingleLambda","BlockStorageFacadeCallbacks","extractCodeWithInfo","ensureError"],"mappings":"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"}
+{"version":3,"file":"project_helper.cjs","names":["LRUCache","BLOCK_STORAGE_FACADE_VERSION","executeSingleLambda","BlockStorageFacadeCallbacks"],"sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type {\n  ResultOrError,\n  BlockConfig,\n  BlockStorage,\n  PlRef,\n  StorageDebugView,\n} from \"@platforma-sdk/model\";\nimport type { StringifiedJson } from \"@milaboratories/pl-model-common\";\nimport {\n  extractCodeWithInfo,\n  ensureError,\n  BlockStorageFacadeCallbacks,\n  BLOCK_STORAGE_FACADE_VERSION,\n} from \"@platforma-sdk/model\";\nimport { LRUCache } from \"lru-cache\";\nimport type { QuickJSWASMModule } from \"quickjs-emscripten\";\nimport { executeSingleLambda } from \"../js_render\";\nimport type { ResourceId } from \"@milaboratories/pl-client\";\n\ntype EnrichmentTargetsRequest = {\n  blockConfig: () => BlockConfig;\n  args: () => unknown;\n};\n\ntype EnrichmentTargetsValue = {\n  value: PlRef[] | undefined;\n};\n\n/**\n * Result of VM-based storage migration.\n * Returned by migrateStorageInVM().\n *\n * - Error result: { error: string } - serious failure (no context, etc.)\n * - Success result: { newStorageJson: StringifiedJson<BlockStorage>, info: string } - migration succeeded\n */\nexport type MigrationResult =\n  | { error: string }\n  | { error?: undefined; newStorageJson: StringifiedJson<BlockStorage>; info: string };\n\n/**\n * Result of args derivation from storage.\n * Returned by __pl_args_derive and __pl_prerunArgs_derive VM callbacks.\n */\ntype ArgsDeriveResult = { error: string } | { error?: undefined; value: unknown };\n\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<\n    string,\n    EnrichmentTargetsValue,\n    EnrichmentTargetsRequest\n  >({\n    max: 256,\n    memoMethod: (_key, _value, { context }) => {\n      return { value: this.calculateEnrichmentTargets(context) };\n    },\n  });\n\n  constructor(private readonly quickJs: QuickJSWASMModule) {}\n\n  // =============================================================================\n  // Args Derivation from Storage (V3+)\n  // =============================================================================\n\n  /**\n   * Derives args directly from storage JSON using VM callback.\n   * The VM extracts data from storage and calls the block's args() function.\n   *\n   * This allows the middle layer to work only with storage JSON,\n   * without needing to know the underlying data structure.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived args object, or error if derivation fails\n   */\n  public deriveArgsFromStorage(\n    blockConfig: BlockConfig,\n    storageJson: string,\n  ): ResultOrError<unknown> {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return {\n        error: new Error(\"deriveArgsFromStorage is only supported for model API version 2\"),\n      };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.ArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        return { error: new Error(result.error) };\n      }\n      return { value: result.value };\n    } catch (e) {\n      return { error: new Error(\"Args derivation from storage failed\", { cause: ensureError(e) }) };\n    }\n  }\n\n  /**\n   * Derives prerunArgs directly from storage JSON using VM callback.\n   * Falls back to args() if prerunArgs is not defined in the block model.\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param storageJson Storage as JSON string\n   * @returns The derived prerunArgs, or undefined if derivation fails\n   */\n  public derivePrerunArgsFromStorage(blockConfig: BlockConfig, storageJson: string): unknown {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"derivePrerunArgsFromStorage is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.PrerunArgsDerive],\n        extractCodeWithInfo(blockConfig),\n        storageJson,\n      ) as ArgsDeriveResult;\n\n      if (result.error !== undefined) {\n        // Return undefined if derivation fails (skip block in staging)\n        return undefined;\n      }\n      return result.value;\n    } catch {\n      // Return undefined if derivation fails (skip block in staging)\n      return undefined;\n    }\n  }\n\n  private calculateEnrichmentTargets(req: EnrichmentTargetsRequest): PlRef[] | undefined {\n    const blockConfig = req.blockConfig();\n    if (blockConfig.enrichmentTargets === undefined) return undefined;\n    const args = req.args();\n    const result = executeSingleLambda(\n      this.quickJs,\n      blockConfig.enrichmentTargets,\n      extractCodeWithInfo(blockConfig),\n      args,\n    ) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(\n    blockConfig: () => BlockConfig,\n    args: () => unknown,\n    key?: { argsRid: ResourceId; blockPackRid: ResourceId },\n  ): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined) return this.calculateEnrichmentTargets(req);\n    const cacheKey = `${key.argsRid}:${key.blockPackRid}`;\n    return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;\n  }\n\n  // =============================================================================\n  // VM-based Storage Operations\n  // =============================================================================\n\n  /**\n   * Creates initial BlockStorage for a new block using VM-based transformation.\n   * This calls the '__pl_storage_initial' callback registered by DataModel which:\n   * - Gets initial data from DataModel.getDefaultData()\n   * - Creates BlockStorage with correct version\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @returns Initial storage as JSON string\n   * @throws Error if storage creation fails\n   */\n  public getInitialStorageInVM(blockConfig: BlockConfig): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getInitialStorageInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageInitial],\n        extractCodeWithInfo(blockConfig),\n      ) as string;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.getInitialStorageInVM] Initial storage creation failed:\", e);\n      throw new Error(`Block initial storage creation failed: ${e}`);\n    }\n  }\n\n  /**\n   * Applies a state update using VM-based transformation.\n   * This calls the model's `__pl_storage_applyUpdate` callback which:\n   * - Normalizes current storage\n   * - Updates state while preserving other fields (version, plugins)\n   * - Returns the updated storage as JSON string\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param currentStorageJson Current storage as JSON string (must be defined)\n   * @param newState New state from developer\n   * @returns Updated storage as JSON string\n   * @throws Error if storage update fails\n   */\n  public applyStorageUpdateInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string,\n    payload: { operation: string; value: unknown },\n  ): string {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"applyStorageUpdateInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageApplyUpdate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n        payload,\n      ) as string;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.applyStorageUpdateInVM] Storage update failed:\", e);\n      throw new Error(`Block storage update failed: ${e}`);\n    }\n  }\n\n  /**\n   * Gets storage debug view from raw storage data by calling the VM's __pl_storage_debugView callback.\n   * Returns structured debug info about the storage (e.g., dataVersion).\n   *\n   * @param blockConfig Block configuration\n   * @param rawStorageJson Raw storage as JSON string (or undefined)\n   * @returns Storage debug view as JSON string (e.g., '{\"dataVersion\": \"v1\"}')\n   */\n  public getStorageDebugViewInVM(\n    blockConfig: BlockConfig,\n    rawStorageJson: string | undefined,\n  ): StringifiedJson<StorageDebugView> | undefined {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      throw new Error(\"getStorageDebugViewInVM is only supported for model API version 2\");\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageDebugView],\n        extractCodeWithInfo(blockConfig),\n        rawStorageJson,\n      ) as StringifiedJson<StorageDebugView>;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.getStorageDebugViewInVM] Get storage debug view failed:\", e);\n      return undefined;\n    }\n  }\n\n  // =============================================================================\n  // Block State Migrations\n  // =============================================================================\n\n  /**\n   * Runs block state migrations via VM-based transformation.\n   * This calls the model's `__pl_storage_migrate` callback which:\n   * - Normalizes current storage to get state and version\n   * - Applies DataModel upgrade to reach target version key\n   * - Runs all necessary migrations sequentially\n   * - Returns new storage with updated state and version\n   *\n   * The middle layer doesn't need to know about dataVersion or storage internals.\n   * All migration logic is encapsulated in the model.\n   *\n   * @param blockConfig The NEW block configuration (provides the model code with migrations)\n   * @param currentStorageJson Current storage as JSON string (or undefined)\n   * @returns MigrationResult with new storage or skip/error info\n   */\n  public migrateStorageInVM(\n    blockConfig: BlockConfig,\n    currentStorageJson: string | undefined,\n  ): MigrationResult {\n    if (blockConfig.modelAPIVersion !== BLOCK_STORAGE_FACADE_VERSION) {\n      return { error: \"migrateStorageInVM is only supported for model API version 2\" };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        blockConfig.blockLifecycleCallbacks[BlockStorageFacadeCallbacks.StorageMigrate],\n        extractCodeWithInfo(blockConfig),\n        currentStorageJson,\n      ) as MigrationResult;\n      return result;\n    } catch (e) {\n      console.error(\"[ProjectHelper.migrateStorageInVM] Migration failed:\", e);\n      return { error: `VM execution failed: ${e}` };\n    }\n  }\n}\n"],"mappings":"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"}