@milaboratories/pl-middle-layer 1.45.5 → 1.46.0

package/dist/model/project_helper.cjs

@@ -4,6 +4,16 @@ var model = require('@platforma-sdk/model');
 var lruCache = require('lru-cache');
 var index = require('../js_render/index.cjs');
 
+// Internal lambda handles for storage operations (registered by SDK's block_storage_vm.ts)
+// All callbacks are prefixed with `__pl_` to indicate internal SDK use
+const STORAGE_NORMALIZE_HANDLE = { __renderLambda: true, handle: '__pl_storage_normalize' };
+const STORAGE_APPLY_UPDATE_HANDLE = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };
+const STORAGE_GET_INFO_HANDLE = { __renderLambda: true, handle: '__pl_storage_getInfo' };
+const STORAGE_MIGRATE_HANDLE = { __renderLambda: true, handle: '__pl_storage_migrate' };
+const ARGS_DERIVE_HANDLE = { __renderLambda: true, handle: '__pl_args_derive' };
+const PRERUN_ARGS_DERIVE_HANDLE = { __renderLambda: true, handle: '__pl_prerunArgs_derive' };
+// Registered by DataModel.registerCallbacks()
+const INITIAL_STORAGE_HANDLE = { __renderLambda: true, handle: '__pl_storage_initial' };
 class ProjectHelper {
     quickJs;
     enrichmentTargetsCache = new lruCache.LRUCache({
@@ -15,6 +25,60 @@ class ProjectHelper {
     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 !== 2) {
+            return { error: new Error('deriveArgsFromStorage is only supported for model API version 2') };
+        }
+        try {
+            const result = index.executeSingleLambda(this.quickJs, ARGS_DERIVE_HANDLE, 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 !== 2) {
+            throw new Error('derivePrerunArgsFromStorage is only supported for model API version 2');
+        }
+        try {
+            const result = index.executeSingleLambda(this.quickJs, PRERUN_ARGS_DERIVE_HANDLE, 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)
@@ -30,6 +94,119 @@ class ProjectHelper {
         const cacheKey = `${key.argsRid}:${key.blockPackRid}`;
         return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;
     }
+    // =============================================================================
+    // VM-based Storage Operations
+    // =============================================================================
+    /**
+     * Normalizes raw blockStorage data using VM-based transformation.
+     * This calls the model's `__pl_storage_normalize` callback which:
+     * - Handles BlockStorage format (with discriminator)
+     * - Handles legacy V1/V2 format ({ args, uiState })
+     * - Handles raw V3 state
+     *
+     * @param blockConfig The block configuration (provides the model code)
+     * @param rawStorage Raw storage data from resource tree (may be JSON string or object)
+     * @returns Object with { storage, state } or undefined if transformation fails
+     */
+    normalizeStorageInVM(blockConfig, rawStorage) {
+        try {
+            const result = index.executeSingleLambda(this.quickJs, STORAGE_NORMALIZE_HANDLE, model.extractCodeWithInfo(blockConfig), rawStorage);
+            return result;
+        }
+        catch (e) {
+            console.warn('[ProjectHelper.normalizeStorageInVM] Storage normalization failed:', e);
+            return 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) {
+        try {
+            const result = index.executeSingleLambda(this.quickJs, INITIAL_STORAGE_HANDLE, 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) {
+        try {
+            const result = index.executeSingleLambda(this.quickJs, STORAGE_APPLY_UPDATE_HANDLE, 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 info from raw storage data by calling the VM's __pl_storage_getInfo callback.
+     * Returns structured info about the storage (e.g., dataVersion).
+     *
+     * @param blockConfig Block configuration
+     * @param rawStorageJson Raw storage as JSON string (or undefined)
+     * @returns Storage info as JSON string (e.g., '{"dataVersion": 1}')
+     */
+    getStorageInfoInVM(blockConfig, rawStorageJson) {
+        try {
+            const result = index.executeSingleLambda(this.quickJs, STORAGE_GET_INFO_HANDLE, model.extractCodeWithInfo(blockConfig), rawStorageJson);
+            return result;
+        }
+        catch (e) {
+            console.error('[ProjectHelper.getStorageInfoInVM] Get storage info 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
+     * - Calculates target version from number of registered migrations
+     * - 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) {
+        try {
+            const result = index.executeSingleLambda(this.quickJs, STORAGE_MIGRATE_HANDLE, model.extractCodeWithInfo(blockConfig), currentStorageJson);
+            return result;
+        }
+        catch (e) {
+            console.error('[ProjectHelper.migrateStorageInVM] Migration failed:', e);
+            return { error: `VM execution failed: ${e}` };
+        }
+    }
 }
 
 exports.ProjectHelper = ProjectHelper;

package/dist/model/project_helper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.cjs","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import { extractCodeWithInfo, type BlockConfig, type PlRef } 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\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<string, EnrichmentTargetsValue, EnrichmentTargetsRequest>({\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  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(this.quickJs, blockConfig.enrichmentTargets, extractCodeWithInfo(blockConfig), args) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(blockConfig: () => BlockConfig, args: () => unknown, key?: { argsRid: ResourceId; blockPackRid: ResourceId }): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined)\n      return this.calculateEnrichmentTargets(req);\n    const cacheKey = `${key.argsRid}:${key.blockPackRid}`;\n    return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;\n  }\n}\n"],"names":["LRUCache","executeSingleLambda","extractCodeWithInfo"],"mappings":";;;;;;MAea,aAAa,CAAA;AAQK,IAAA,OAAA;IAPZ,sBAAsB,GAAG,IAAIA,iBAAQ,CAA2D;AAC/G,QAAA,GAAG,EAAE,GAAG;QACR,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAI;YACxC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE;QAC5D,CAAC;AACF,KAAA,CAAC;AAEF,IAAA,WAAA,CAA6B,OAA0B,EAAA;QAA1B,IAAA,CAAA,OAAO,GAAP,OAAO;IAAsB;AAElD,IAAA,0BAA0B,CAAC,GAA6B,EAAA;AAC9D,QAAA,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE;AACrC,QAAA,IAAI,WAAW,CAAC,iBAAiB,KAAK,SAAS;AAAE,YAAA,OAAO,SAAS;AACjE,QAAA,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE;AACvB,QAAA,MAAM,MAAM,GAAGC,yBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,iBAAiB,EAAEC,yBAAmB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAY;AAClI,QAAA,OAAO,MAAM;IACf;AAEO,IAAA,oBAAoB,CAAC,WAA8B,EAAE,IAAmB,EAAE,GAAuD,EAAA;AACtI,QAAA,MAAM,GAAG,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;QACjC,IAAI,GAAG,KAAK,SAAS;AACnB,YAAA,OAAO,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC;QAC7C,MAAM,QAAQ,GAAG,CAAA,EAAG,GAAG,CAAC,OAAO,CAAA,CAAA,EAAI,GAAG,CAAC,YAAY,CAAA,CAAE;AACrD,QAAA,OAAO,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK;IAC3E;AACD;;;;"}
+{"version":3,"file":"project_helper.cjs","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, PlRef, ConfigRenderLambda } from '@platforma-sdk/model';\nimport { extractCodeWithInfo, ensureError } 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 normalization\n */\ninterface NormalizeStorageResult {\n  storage: unknown;\n  data: unknown;\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: string, info: string, warn?: string } - migration succeeded or reset to initial\n */\nexport type MigrationResult =\n  | { error: string }\n  | { error?: undefined; newStorageJson: string; info: string; warn?: string };\n\n// Internal lambda handles for storage operations (registered by SDK's block_storage_vm.ts)\n// All callbacks are prefixed with `__pl_` to indicate internal SDK use\nconst STORAGE_NORMALIZE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_normalize' };\nconst STORAGE_APPLY_UPDATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };\nconst STORAGE_GET_INFO_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_getInfo' };\nconst STORAGE_MIGRATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_migrate' };\nconst ARGS_DERIVE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_args_derive' };\nconst PRERUN_ARGS_DERIVE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_prerunArgs_derive' };\n// Registered by DataModel.registerCallbacks()\nconst INITIAL_STORAGE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_initial' };\n\n/**\n * Result of args derivation from storage.\n * Returned by __pl_args_derive and __pl_prerunArgs_derive VM callbacks.\n */\ntype ArgsDeriveResult =\n  | { error: string }\n  | { error?: undefined; value: unknown };\n\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<string, EnrichmentTargetsValue, EnrichmentTargetsRequest>({\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(blockConfig: BlockConfig, storageJson: string): ResultOrError<unknown> {\n    if (blockConfig.modelAPIVersion !== 2) {\n      return { error: new Error('deriveArgsFromStorage is only supported for model API version 2') };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        ARGS_DERIVE_HANDLE,\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 !== 2) {\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        PRERUN_ARGS_DERIVE_HANDLE,\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(this.quickJs, blockConfig.enrichmentTargets, extractCodeWithInfo(blockConfig), args) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(blockConfig: () => BlockConfig, args: () => unknown, key?: { argsRid: ResourceId; blockPackRid: ResourceId }): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined)\n      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   * Normalizes raw blockStorage data using VM-based transformation.\n   * This calls the model's `__pl_storage_normalize` callback which:\n   * - Handles BlockStorage format (with discriminator)\n   * - Handles legacy V1/V2 format ({ args, uiState })\n   * - Handles raw V3 state\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param rawStorage Raw storage data from resource tree (may be JSON string or object)\n   * @returns Object with { storage, state } or undefined if transformation fails\n   */\n  public normalizeStorageInVM(blockConfig: BlockConfig, rawStorage: unknown): NormalizeStorageResult | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_NORMALIZE_HANDLE,\n        extractCodeWithInfo(blockConfig),\n        rawStorage,\n      ) as NormalizeStorageResult;\n      return result;\n    } catch (e) {\n      console.warn('[ProjectHelper.normalizeStorageInVM] Storage normalization failed:', e);\n      return undefined;\n    }\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    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        INITIAL_STORAGE_HANDLE,\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(blockConfig: BlockConfig, currentStorageJson: string, payload: { operation: string; value: unknown }): string {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_APPLY_UPDATE_HANDLE,\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 info from raw storage data by calling the VM's __pl_storage_getInfo callback.\n   * Returns structured 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 info as JSON string (e.g., '{\"dataVersion\": 1}')\n   */\n  public getStorageInfoInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): string | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_GET_INFO_HANDLE,\n        extractCodeWithInfo(blockConfig),\n        rawStorageJson,\n      ) as string;\n      return result;\n    } catch (e) {\n      console.error('[ProjectHelper.getStorageInfoInVM] Get storage info 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   * - Calculates target version from number of registered migrations\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(blockConfig: BlockConfig, currentStorageJson: string | undefined): MigrationResult {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_MIGRATE_HANDLE,\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","executeSingleLambda","extractCodeWithInfo","ensureError"],"mappings":"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"}

package/dist/model/project_helper.d.ts

@@ -1,14 +1,123 @@
-import { type BlockConfig, type PlRef } from '@platforma-sdk/model';
+import type { ResultOrError, BlockConfig, PlRef } from '@platforma-sdk/model';
 import type { QuickJSWASMModule } from 'quickjs-emscripten';
 import type { ResourceId } from '@milaboratories/pl-client';
+/**
+ * Result of VM-based storage normalization
+ */
+interface NormalizeStorageResult {
+    storage: unknown;
+    data: unknown;
+}
+/**
+ * Result of VM-based storage migration.
+ * Returned by migrateStorageInVM().
+ *
+ * - Error result: { error: string } - serious failure (no context, etc.)
+ * - Success result: { newStorageJson: string, info: string, warn?: string } - migration succeeded or reset to initial
+ */
+export type MigrationResult = {
+    error: string;
+} | {
+    error?: undefined;
+    newStorageJson: string;
+    info: string;
+    warn?: 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;
+    /**
+     * Normalizes raw blockStorage data using VM-based transformation.
+     * This calls the model's `__pl_storage_normalize` callback which:
+     * - Handles BlockStorage format (with discriminator)
+     * - Handles legacy V1/V2 format ({ args, uiState })
+     * - Handles raw V3 state
+     *
+     * @param blockConfig The block configuration (provides the model code)
+     * @param rawStorage Raw storage data from resource tree (may be JSON string or object)
+     * @returns Object with { storage, state } or undefined if transformation fails
+     */
+    normalizeStorageInVM(blockConfig: BlockConfig, rawStorage: unknown): NormalizeStorageResult | 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 info from raw storage data by calling the VM's __pl_storage_getInfo callback.
+     * Returns structured info about the storage (e.g., dataVersion).
+     *
+     * @param blockConfig Block configuration
+     * @param rawStorageJson Raw storage as JSON string (or undefined)
+     * @returns Storage info as JSON string (e.g., '{"dataVersion": 1}')
+     */
+    getStorageInfoInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): string | 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
+     * - Calculates target version from number of registered migrations
+     * - 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;
 }
+export {};
 //# sourceMappingURL=project_helper.d.ts.map

package/dist/model/project_helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.d.ts","sourceRoot":"","sources":["../../src/model/project_helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEzF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAW5D,qBAAa,aAAa;IAQZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAKpC;gBAE0B,OAAO,EAAE,iBAAiB;IAEvD,OAAO,CAAC,0BAA0B;IAQ3B,oBAAoB,CAAC,WAAW,EAAE,MAAM,WAAW,EAAE,IAAI,EAAE,MAAM,OAAO,EAAE,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,UAAU,CAAA;KAAE,GAAG,KAAK,EAAE,GAAG,SAAS;CAO/J"}
+{"version":3,"file":"project_helper.d.ts","sourceRoot":"","sources":["../../src/model/project_helper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,KAAK,EAAsB,MAAM,sBAAsB,CAAC;AAGlG,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAW5D;;GAEG;AACH,UAAU,sBAAsB;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GACjB;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,cAAc,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAqB/E,qBAAa,aAAa;IAQZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAPpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAKpC;gBAE0B,OAAO,EAAE,iBAAiB;IAMvD;;;;;;;;;;OAUG;IACI,qBAAqB,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;IAsBnG;;;;;;;OAOG;IACI,2BAA2B,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAwB1F,OAAO,CAAC,0BAA0B;IAQ3B,oBAAoB,CAAC,WAAW,EAAE,MAAM,WAAW,EAAE,IAAI,EAAE,MAAM,OAAO,EAAE,GAAG,CAAC,EAAE;QAAE,OAAO,EAAE,UAAU,CAAC;QAAC,YAAY,EAAE,UAAU,CAAA;KAAE,GAAG,KAAK,EAAE,GAAG,SAAS;IAY9J;;;;;;;;;;OAUG;IACI,oBAAoB,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS;IAe9G;;;;;;;;;OASG;IACI,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,MAAM;IAc9D;;;;;;;;;;;;OAYG;IACI,sBAAsB,CAAC,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;IAgB3I;;;;;;;OAOG;IACI,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS;IAmB3G;;;;;;;;;;;;;;OAcG;IACI,kBAAkB,CAAC,WAAW,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,GAAG,SAAS,GAAG,eAAe;CAc7G"}

package/dist/model/project_helper.js

@@ -1,7 +1,17 @@
-import { extractCodeWithInfo } from '@platforma-sdk/model';
+import { extractCodeWithInfo, ensureError } from '@platforma-sdk/model';
 import { LRUCache } from 'lru-cache';
 import { executeSingleLambda } from '../js_render/index.js';
 
+// Internal lambda handles for storage operations (registered by SDK's block_storage_vm.ts)
+// All callbacks are prefixed with `__pl_` to indicate internal SDK use
+const STORAGE_NORMALIZE_HANDLE = { __renderLambda: true, handle: '__pl_storage_normalize' };
+const STORAGE_APPLY_UPDATE_HANDLE = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };
+const STORAGE_GET_INFO_HANDLE = { __renderLambda: true, handle: '__pl_storage_getInfo' };
+const STORAGE_MIGRATE_HANDLE = { __renderLambda: true, handle: '__pl_storage_migrate' };
+const ARGS_DERIVE_HANDLE = { __renderLambda: true, handle: '__pl_args_derive' };
+const PRERUN_ARGS_DERIVE_HANDLE = { __renderLambda: true, handle: '__pl_prerunArgs_derive' };
+// Registered by DataModel.registerCallbacks()
+const INITIAL_STORAGE_HANDLE = { __renderLambda: true, handle: '__pl_storage_initial' };
 class ProjectHelper {
     quickJs;
     enrichmentTargetsCache = new LRUCache({
@@ -13,6 +23,60 @@ class ProjectHelper {
     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 !== 2) {
+            return { error: new Error('deriveArgsFromStorage is only supported for model API version 2') };
+        }
+        try {
+            const result = executeSingleLambda(this.quickJs, ARGS_DERIVE_HANDLE, 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 !== 2) {
+            throw new Error('derivePrerunArgsFromStorage is only supported for model API version 2');
+        }
+        try {
+            const result = executeSingleLambda(this.quickJs, PRERUN_ARGS_DERIVE_HANDLE, 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)
@@ -28,6 +92,119 @@ class ProjectHelper {
         const cacheKey = `${key.argsRid}:${key.blockPackRid}`;
         return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;
     }
+    // =============================================================================
+    // VM-based Storage Operations
+    // =============================================================================
+    /**
+     * Normalizes raw blockStorage data using VM-based transformation.
+     * This calls the model's `__pl_storage_normalize` callback which:
+     * - Handles BlockStorage format (with discriminator)
+     * - Handles legacy V1/V2 format ({ args, uiState })
+     * - Handles raw V3 state
+     *
+     * @param blockConfig The block configuration (provides the model code)
+     * @param rawStorage Raw storage data from resource tree (may be JSON string or object)
+     * @returns Object with { storage, state } or undefined if transformation fails
+     */
+    normalizeStorageInVM(blockConfig, rawStorage) {
+        try {
+            const result = executeSingleLambda(this.quickJs, STORAGE_NORMALIZE_HANDLE, extractCodeWithInfo(blockConfig), rawStorage);
+            return result;
+        }
+        catch (e) {
+            console.warn('[ProjectHelper.normalizeStorageInVM] Storage normalization failed:', e);
+            return 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) {
+        try {
+            const result = executeSingleLambda(this.quickJs, INITIAL_STORAGE_HANDLE, 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) {
+        try {
+            const result = executeSingleLambda(this.quickJs, STORAGE_APPLY_UPDATE_HANDLE, 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 info from raw storage data by calling the VM's __pl_storage_getInfo callback.
+     * Returns structured info about the storage (e.g., dataVersion).
+     *
+     * @param blockConfig Block configuration
+     * @param rawStorageJson Raw storage as JSON string (or undefined)
+     * @returns Storage info as JSON string (e.g., '{"dataVersion": 1}')
+     */
+    getStorageInfoInVM(blockConfig, rawStorageJson) {
+        try {
+            const result = executeSingleLambda(this.quickJs, STORAGE_GET_INFO_HANDLE, extractCodeWithInfo(blockConfig), rawStorageJson);
+            return result;
+        }
+        catch (e) {
+            console.error('[ProjectHelper.getStorageInfoInVM] Get storage info 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
+     * - Calculates target version from number of registered migrations
+     * - 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) {
+        try {
+            const result = executeSingleLambda(this.quickJs, STORAGE_MIGRATE_HANDLE, extractCodeWithInfo(blockConfig), currentStorageJson);
+            return result;
+        }
+        catch (e) {
+            console.error('[ProjectHelper.migrateStorageInVM] Migration failed:', e);
+            return { error: `VM execution failed: ${e}` };
+        }
+    }
 }
 
 export { ProjectHelper };

package/dist/model/project_helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.js","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import { extractCodeWithInfo, type BlockConfig, type PlRef } 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\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<string, EnrichmentTargetsValue, EnrichmentTargetsRequest>({\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  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(this.quickJs, blockConfig.enrichmentTargets, extractCodeWithInfo(blockConfig), args) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(blockConfig: () => BlockConfig, args: () => unknown, key?: { argsRid: ResourceId; blockPackRid: ResourceId }): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined)\n      return this.calculateEnrichmentTargets(req);\n    const cacheKey = `${key.argsRid}:${key.blockPackRid}`;\n    return this.enrichmentTargetsCache.memo(cacheKey, { context: req }).value;\n  }\n}\n"],"names":[],"mappings":";;;;MAea,aAAa,CAAA;AAQK,IAAA,OAAA;IAPZ,sBAAsB,GAAG,IAAI,QAAQ,CAA2D;AAC/G,QAAA,GAAG,EAAE,GAAG;QACR,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,KAAI;YACxC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,0BAA0B,CAAC,OAAO,CAAC,EAAE;QAC5D,CAAC;AACF,KAAA,CAAC;AAEF,IAAA,WAAA,CAA6B,OAA0B,EAAA;QAA1B,IAAA,CAAA,OAAO,GAAP,OAAO;IAAsB;AAElD,IAAA,0BAA0B,CAAC,GAA6B,EAAA;AAC9D,QAAA,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW,EAAE;AACrC,QAAA,IAAI,WAAW,CAAC,iBAAiB,KAAK,SAAS;AAAE,YAAA,OAAO,SAAS;AACjE,QAAA,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE;AACvB,QAAA,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC,iBAAiB,EAAE,mBAAmB,CAAC,WAAW,CAAC,EAAE,IAAI,CAAY;AAClI,QAAA,OAAO,MAAM;IACf;AAEO,IAAA,oBAAoB,CAAC,WAA8B,EAAE,IAAmB,EAAE,GAAuD,EAAA;AACtI,QAAA,MAAM,GAAG,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE;QACjC,IAAI,GAAG,KAAK,SAAS;AACnB,YAAA,OAAO,IAAI,CAAC,0BAA0B,CAAC,GAAG,CAAC;QAC7C,MAAM,QAAQ,GAAG,CAAA,EAAG,GAAG,CAAC,OAAO,CAAA,CAAA,EAAI,GAAG,CAAC,YAAY,CAAA,CAAE;AACrD,QAAA,OAAO,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK;IAC3E;AACD;;;;"}
+{"version":3,"file":"project_helper.js","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, PlRef, ConfigRenderLambda } from '@platforma-sdk/model';\nimport { extractCodeWithInfo, ensureError } 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 normalization\n */\ninterface NormalizeStorageResult {\n  storage: unknown;\n  data: unknown;\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: string, info: string, warn?: string } - migration succeeded or reset to initial\n */\nexport type MigrationResult =\n  | { error: string }\n  | { error?: undefined; newStorageJson: string; info: string; warn?: string };\n\n// Internal lambda handles for storage operations (registered by SDK's block_storage_vm.ts)\n// All callbacks are prefixed with `__pl_` to indicate internal SDK use\nconst STORAGE_NORMALIZE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_normalize' };\nconst STORAGE_APPLY_UPDATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };\nconst STORAGE_GET_INFO_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_getInfo' };\nconst STORAGE_MIGRATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_migrate' };\nconst ARGS_DERIVE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_args_derive' };\nconst PRERUN_ARGS_DERIVE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_prerunArgs_derive' };\n// Registered by DataModel.registerCallbacks()\nconst INITIAL_STORAGE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_initial' };\n\n/**\n * Result of args derivation from storage.\n * Returned by __pl_args_derive and __pl_prerunArgs_derive VM callbacks.\n */\ntype ArgsDeriveResult =\n  | { error: string }\n  | { error?: undefined; value: unknown };\n\nexport class ProjectHelper {\n  private readonly enrichmentTargetsCache = new LRUCache<string, EnrichmentTargetsValue, EnrichmentTargetsRequest>({\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(blockConfig: BlockConfig, storageJson: string): ResultOrError<unknown> {\n    if (blockConfig.modelAPIVersion !== 2) {\n      return { error: new Error('deriveArgsFromStorage is only supported for model API version 2') };\n    }\n\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        ARGS_DERIVE_HANDLE,\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 !== 2) {\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        PRERUN_ARGS_DERIVE_HANDLE,\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(this.quickJs, blockConfig.enrichmentTargets, extractCodeWithInfo(blockConfig), args) as PlRef[];\n    return result;\n  }\n\n  public getEnrichmentTargets(blockConfig: () => BlockConfig, args: () => unknown, key?: { argsRid: ResourceId; blockPackRid: ResourceId }): PlRef[] | undefined {\n    const req = { blockConfig, args };\n    if (key === undefined)\n      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   * Normalizes raw blockStorage data using VM-based transformation.\n   * This calls the model's `__pl_storage_normalize` callback which:\n   * - Handles BlockStorage format (with discriminator)\n   * - Handles legacy V1/V2 format ({ args, uiState })\n   * - Handles raw V3 state\n   *\n   * @param blockConfig The block configuration (provides the model code)\n   * @param rawStorage Raw storage data from resource tree (may be JSON string or object)\n   * @returns Object with { storage, state } or undefined if transformation fails\n   */\n  public normalizeStorageInVM(blockConfig: BlockConfig, rawStorage: unknown): NormalizeStorageResult | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_NORMALIZE_HANDLE,\n        extractCodeWithInfo(blockConfig),\n        rawStorage,\n      ) as NormalizeStorageResult;\n      return result;\n    } catch (e) {\n      console.warn('[ProjectHelper.normalizeStorageInVM] Storage normalization failed:', e);\n      return undefined;\n    }\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    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        INITIAL_STORAGE_HANDLE,\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(blockConfig: BlockConfig, currentStorageJson: string, payload: { operation: string; value: unknown }): string {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_APPLY_UPDATE_HANDLE,\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 info from raw storage data by calling the VM's __pl_storage_getInfo callback.\n   * Returns structured 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 info as JSON string (e.g., '{\"dataVersion\": 1}')\n   */\n  public getStorageInfoInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): string | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_GET_INFO_HANDLE,\n        extractCodeWithInfo(blockConfig),\n        rawStorageJson,\n      ) as string;\n      return result;\n    } catch (e) {\n      console.error('[ProjectHelper.getStorageInfoInVM] Get storage info 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   * - Calculates target version from number of registered migrations\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(blockConfig: BlockConfig, currentStorageJson: string | undefined): MigrationResult {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_MIGRATE_HANDLE,\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":[],"mappings":"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"}