@milaboratories/pl-middle-layer 1.46.8 → 1.46.10

package/dist/model/block_storage_helper.cjs

@@ -69,21 +69,21 @@ function serializeBlockStorage(storage) {
     return JSON.stringify(storage);
 }
 /**
- * Checks if the storage needs migration based on version.
+ * Checks if the storage needs migration based on version key.
  *
  * @param storage - Current BlockStorage
- * @param targetVersion - Target schema version
+ * @param targetVersion - Target version key
  * @returns true if migration is needed
  */
 function needsMigration(storage, targetVersion) {
-    return model.getStorageDataVersion(storage) < targetVersion;
+    return model.getStorageDataVersion(storage) !== targetVersion;
 }
 /**
  * Migrates BlockStorage from one version to another.
  *
  * @param storage - Current BlockStorage
- * @param fromVersion - Source version
- * @param toVersion - Target version
+ * @param fromVersion - Source version key
+ * @param toVersion - Target version key
  * @param handlers - Optional custom handlers
  * @returns Migrated BlockStorage
  */
@@ -116,7 +116,7 @@ function isLegacyV1V2Format(rawData) {
  * @returns BlockStorage with legacy data as state
  */
 function convertLegacyToBlockStorage(legacyData) {
-    return model.createBlockStorage(legacyData, 1);
+    return model.createBlockStorage(legacyData);
 }
 /**
  * Smart parser that handles all storage formats:

package/dist/model/block_storage_helper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_storage_helper.cjs","sources":["../../src/model/block_storage_helper.ts"],"sourcesContent":["/**\n * Block Storage Helper - Middle layer utilities for BlockStorage operations.\n *\n * This module provides the bridge between the SDK's BlockStorage abstraction\n * and the middle layer's storage operations. Block developers never interact\n * with this - they only see `state`.\n *\n * @module block_storage_helper\n */\n\nimport type {\n  BlockStorage,\n  BlockStorageHandlers,\n} from '@platforma-sdk/model';\nimport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n} from '@platforma-sdk/model';\n\n// Re-export types for convenience\nexport type { BlockStorage, BlockStorageHandlers };\n\n// Re-export utilities that middle layer needs\nexport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n};\n\n/**\n * Parses raw blockStorage data (from resource tree) into BlockStorage.\n * Handles both legacy format (raw state) and new format (BlockStorage).\n *\n * @param rawData - Raw data from blockStorage field (may be string or parsed object)\n * @returns Normalized BlockStorage object\n */\nexport function parseBlockStorage<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  if (typeof rawData === 'string') {\n    try {\n      const parsed = JSON.parse(rawData);\n      return normalizeBlockStorage<TState>(parsed);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  return normalizeBlockStorage<TState>(rawData);\n}\n\n/**\n * Extracts the user-facing data from BlockStorage.\n * This is what block developers see in their .args() callbacks.\n *\n * @param storage - The BlockStorage object\n * @returns The data value that developers work with\n */\nexport function extractDataForDeveloper<TState>(storage: BlockStorage<TState>): TState {\n  return getStorageData(storage);\n}\n\n/**\n * Creates a new BlockStorage with updated state.\n * Used when setState is called from the frontend.\n *\n * @param currentStorage - Current BlockStorage (or undefined for new blocks)\n * @param newState - New state from developer\n * @param handlers - Optional custom handlers (defaults to standard handlers)\n * @returns Updated BlockStorage\n */\nexport function applyStateUpdate<TState>(\n  currentStorage: BlockStorage<TState> | undefined,\n  newState: TState,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const storage = currentStorage ?? createBlockStorage<TState>({} as TState);\n  const transform = handlers.transformStateForStorage ?? defaultBlockStorageHandlers.transformStateForStorage;\n  return transform(storage, newState) as BlockStorage<TState>;\n}\n\n/**\n * Serializes BlockStorage for writing to the resource tree.\n *\n * @param storage - The BlockStorage to serialize\n * @returns JSON string\n */\nexport function serializeBlockStorage(storage: BlockStorage): string {\n  return JSON.stringify(storage);\n}\n\n/**\n * Checks if the storage needs migration based on version.\n *\n * @param storage - Current BlockStorage\n * @param targetVersion - Target schema version\n * @returns true if migration is needed\n */\nexport function needsMigration(storage: BlockStorage, targetVersion: number): boolean {\n  return getStorageDataVersion(storage) < targetVersion;\n}\n\n/**\n * Migrates BlockStorage from one version to another.\n *\n * @param storage - Current BlockStorage\n * @param fromVersion - Source version\n * @param toVersion - Target version\n * @param handlers - Optional custom handlers\n * @returns Migrated BlockStorage\n */\nexport function migrateBlockStorage<TState>(\n  storage: BlockStorage<TState>,\n  fromVersion: number,\n  toVersion: number,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const migrate = handlers.migrateStorage ?? defaultBlockStorageHandlers.migrateStorage;\n  return migrate(storage, fromVersion, toVersion) as BlockStorage<TState>;\n}\n\n/**\n * V1/V2 legacy format - state stored as { args, uiState }\n */\nexport interface LegacyV1V2State {\n  args?: unknown;\n  uiState?: unknown;\n}\n\n/**\n * Checks if the raw data is in legacy V1/V2 format.\n * V1/V2 blocks stored { args, uiState } directly, not wrapped in BlockStorage.\n *\n * @param rawData - Raw data from blockStorage field\n * @returns true if data is in legacy format\n */\nexport function isLegacyV1V2Format(rawData: unknown): rawData is LegacyV1V2State {\n  if (rawData === null || typeof rawData !== 'object') return false;\n  // If it has the discriminator, it's BlockStorage format\n  if (isBlockStorage(rawData)) return false;\n\n  const obj = rawData as Record<string, unknown>;\n  // Legacy format has 'args' and/or 'uiState' at top level, no discriminator\n  return ('args' in obj || 'uiState' in obj);\n}\n\n/**\n * Converts legacy V1/V2 format to BlockStorage.\n * For backward compatibility with existing blocks.\n *\n * @param legacyData - Data in { args, uiState } format\n * @returns BlockStorage with legacy data as state\n */\nexport function convertLegacyToBlockStorage(legacyData: LegacyV1V2State): BlockStorage<LegacyV1V2State> {\n  return createBlockStorage(legacyData, 1);\n}\n\n/**\n * Smart parser that handles all storage formats:\n * - New BlockStorage format\n * - Legacy V1/V2 format ({ args, uiState })\n * - Raw state (any other format)\n *\n * @param rawData - Raw data from blockStorage field\n * @returns Normalized BlockStorage\n */\nexport function parseBlockStorageSmart<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  let parsed = rawData;\n  if (typeof rawData === 'string') {\n    try {\n      parsed = JSON.parse(rawData);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  // Check for legacy V1/V2 format\n  if (isLegacyV1V2Format(parsed)) {\n    return convertLegacyToBlockStorage(parsed) as unknown as BlockStorage<TState>;\n  }\n\n  // Use standard normalization\n  return normalizeBlockStorage<TState>(parsed);\n}\n"],"names":["createBlockStorage","normalizeBlockStorage","getStorageData","defaultBlockStorageHandlers","getStorageDataVersion","isBlockStorage"],"mappings":"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"}
+{"version":3,"file":"block_storage_helper.cjs","sources":["../../src/model/block_storage_helper.ts"],"sourcesContent":["/**\n * Block Storage Helper - Middle layer utilities for BlockStorage operations.\n *\n * This module provides the bridge between the SDK's BlockStorage abstraction\n * and the middle layer's storage operations. Block developers never interact\n * with this - they only see `state`.\n *\n * @module block_storage_helper\n */\n\nimport type {\n  BlockStorage,\n  BlockStorageHandlers,\n} from '@platforma-sdk/model';\nimport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n} from '@platforma-sdk/model';\n\n// Re-export types for convenience\nexport type { BlockStorage, BlockStorageHandlers };\n\n// Re-export utilities that middle layer needs\nexport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n};\n\n/**\n * Parses raw blockStorage data (from resource tree) into BlockStorage.\n * Handles both legacy format (raw state) and new format (BlockStorage).\n *\n * @param rawData - Raw data from blockStorage field (may be string or parsed object)\n * @returns Normalized BlockStorage object\n */\nexport function parseBlockStorage<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  if (typeof rawData === 'string') {\n    try {\n      const parsed = JSON.parse(rawData);\n      return normalizeBlockStorage<TState>(parsed);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  return normalizeBlockStorage<TState>(rawData);\n}\n\n/**\n * Extracts the user-facing data from BlockStorage.\n * This is what block developers see in their .args() callbacks.\n *\n * @param storage - The BlockStorage object\n * @returns The data value that developers work with\n */\nexport function extractDataForDeveloper<TState>(storage: BlockStorage<TState>): TState {\n  return getStorageData(storage);\n}\n\n/**\n * Creates a new BlockStorage with updated state.\n * Used when setState is called from the frontend.\n *\n * @param currentStorage - Current BlockStorage (or undefined for new blocks)\n * @param newState - New state from developer\n * @param handlers - Optional custom handlers (defaults to standard handlers)\n * @returns Updated BlockStorage\n */\nexport function applyStateUpdate<TState>(\n  currentStorage: BlockStorage<TState> | undefined,\n  newState: TState,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const storage = currentStorage ?? createBlockStorage<TState>({} as TState);\n  const transform = handlers.transformStateForStorage ?? defaultBlockStorageHandlers.transformStateForStorage;\n  return transform(storage, newState) as BlockStorage<TState>;\n}\n\n/**\n * Serializes BlockStorage for writing to the resource tree.\n *\n * @param storage - The BlockStorage to serialize\n * @returns JSON string\n */\nexport function serializeBlockStorage(storage: BlockStorage): string {\n  return JSON.stringify(storage);\n}\n\n/**\n * Checks if the storage needs migration based on version key.\n *\n * @param storage - Current BlockStorage\n * @param targetVersion - Target version key\n * @returns true if migration is needed\n */\nexport function needsMigration(storage: BlockStorage, targetVersion: string): boolean {\n  return getStorageDataVersion(storage) !== targetVersion;\n}\n\n/**\n * Migrates BlockStorage from one version to another.\n *\n * @param storage - Current BlockStorage\n * @param fromVersion - Source version key\n * @param toVersion - Target version key\n * @param handlers - Optional custom handlers\n * @returns Migrated BlockStorage\n */\nexport function migrateBlockStorage<TState>(\n  storage: BlockStorage<TState>,\n  fromVersion: string,\n  toVersion: string,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const migrate = handlers.migrateStorage ?? defaultBlockStorageHandlers.migrateStorage;\n  return migrate(storage, fromVersion, toVersion) as BlockStorage<TState>;\n}\n\n/**\n * V1/V2 legacy format - state stored as { args, uiState }\n */\nexport interface LegacyV1V2State {\n  args?: unknown;\n  uiState?: unknown;\n}\n\n/**\n * Checks if the raw data is in legacy V1/V2 format.\n * V1/V2 blocks stored { args, uiState } directly, not wrapped in BlockStorage.\n *\n * @param rawData - Raw data from blockStorage field\n * @returns true if data is in legacy format\n */\nexport function isLegacyV1V2Format(rawData: unknown): rawData is LegacyV1V2State {\n  if (rawData === null || typeof rawData !== 'object') return false;\n  // If it has the discriminator, it's BlockStorage format\n  if (isBlockStorage(rawData)) return false;\n\n  const obj = rawData as Record<string, unknown>;\n  // Legacy format has 'args' and/or 'uiState' at top level, no discriminator\n  return ('args' in obj || 'uiState' in obj);\n}\n\n/**\n * Converts legacy V1/V2 format to BlockStorage.\n * For backward compatibility with existing blocks.\n *\n * @param legacyData - Data in { args, uiState } format\n * @returns BlockStorage with legacy data as state\n */\nexport function convertLegacyToBlockStorage(legacyData: LegacyV1V2State): BlockStorage<LegacyV1V2State> {\n  return createBlockStorage(legacyData);\n}\n\n/**\n * Smart parser that handles all storage formats:\n * - New BlockStorage format\n * - Legacy V1/V2 format ({ args, uiState })\n * - Raw state (any other format)\n *\n * @param rawData - Raw data from blockStorage field\n * @returns Normalized BlockStorage\n */\nexport function parseBlockStorageSmart<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  let parsed = rawData;\n  if (typeof rawData === 'string') {\n    try {\n      parsed = JSON.parse(rawData);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  // Check for legacy V1/V2 format\n  if (isLegacyV1V2Format(parsed)) {\n    return convertLegacyToBlockStorage(parsed) as unknown as BlockStorage<TState>;\n  }\n\n  // Use standard normalization\n  return normalizeBlockStorage<TState>(parsed);\n}\n"],"names":["createBlockStorage","normalizeBlockStorage","getStorageData","defaultBlockStorageHandlers","getStorageDataVersion","isBlockStorage"],"mappings":"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"}

package/dist/model/block_storage_helper.d.ts

@@ -45,23 +45,23 @@ export declare function applyStateUpdate<TState>(currentStorage: BlockStorage<TS
  */
 export declare function serializeBlockStorage(storage: BlockStorage): string;
 /**
- * Checks if the storage needs migration based on version.
+ * Checks if the storage needs migration based on version key.
  *
  * @param storage - Current BlockStorage
- * @param targetVersion - Target schema version
+ * @param targetVersion - Target version key
  * @returns true if migration is needed
  */
-export declare function needsMigration(storage: BlockStorage, targetVersion: number): boolean;
+export declare function needsMigration(storage: BlockStorage, targetVersion: string): boolean;
 /**
  * Migrates BlockStorage from one version to another.
  *
  * @param storage - Current BlockStorage
- * @param fromVersion - Source version
- * @param toVersion - Target version
+ * @param fromVersion - Source version key
+ * @param toVersion - Target version key
  * @param handlers - Optional custom handlers
  * @returns Migrated BlockStorage
  */
-export declare function migrateBlockStorage<TState>(storage: BlockStorage<TState>, fromVersion: number, toVersion: number, handlers?: BlockStorageHandlers<TState>): BlockStorage<TState>;
+export declare function migrateBlockStorage<TState>(storage: BlockStorage<TState>, fromVersion: string, toVersion: string, handlers?: BlockStorageHandlers<TState>): BlockStorage<TState>;
 /**
  * V1/V2 legacy format - state stored as { args, uiState }
  */

package/dist/model/block_storage_helper.js

@@ -68,21 +68,21 @@ function serializeBlockStorage(storage) {
     return JSON.stringify(storage);
 }
 /**
- * Checks if the storage needs migration based on version.
+ * Checks if the storage needs migration based on version key.
  *
  * @param storage - Current BlockStorage
- * @param targetVersion - Target schema version
+ * @param targetVersion - Target version key
  * @returns true if migration is needed
  */
 function needsMigration(storage, targetVersion) {
-    return getStorageDataVersion(storage) < targetVersion;
+    return getStorageDataVersion(storage) !== targetVersion;
 }
 /**
  * Migrates BlockStorage from one version to another.
  *
  * @param storage - Current BlockStorage
- * @param fromVersion - Source version
- * @param toVersion - Target version
+ * @param fromVersion - Source version key
+ * @param toVersion - Target version key
  * @param handlers - Optional custom handlers
  * @returns Migrated BlockStorage
  */
@@ -115,7 +115,7 @@ function isLegacyV1V2Format(rawData) {
  * @returns BlockStorage with legacy data as state
  */
 function convertLegacyToBlockStorage(legacyData) {
-    return createBlockStorage(legacyData, 1);
+    return createBlockStorage(legacyData);
 }
 /**
  * Smart parser that handles all storage formats:

package/dist/model/block_storage_helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_storage_helper.js","sources":["../../src/model/block_storage_helper.ts"],"sourcesContent":["/**\n * Block Storage Helper - Middle layer utilities for BlockStorage operations.\n *\n * This module provides the bridge between the SDK's BlockStorage abstraction\n * and the middle layer's storage operations. Block developers never interact\n * with this - they only see `state`.\n *\n * @module block_storage_helper\n */\n\nimport type {\n  BlockStorage,\n  BlockStorageHandlers,\n} from '@platforma-sdk/model';\nimport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n} from '@platforma-sdk/model';\n\n// Re-export types for convenience\nexport type { BlockStorage, BlockStorageHandlers };\n\n// Re-export utilities that middle layer needs\nexport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n};\n\n/**\n * Parses raw blockStorage data (from resource tree) into BlockStorage.\n * Handles both legacy format (raw state) and new format (BlockStorage).\n *\n * @param rawData - Raw data from blockStorage field (may be string or parsed object)\n * @returns Normalized BlockStorage object\n */\nexport function parseBlockStorage<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  if (typeof rawData === 'string') {\n    try {\n      const parsed = JSON.parse(rawData);\n      return normalizeBlockStorage<TState>(parsed);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  return normalizeBlockStorage<TState>(rawData);\n}\n\n/**\n * Extracts the user-facing data from BlockStorage.\n * This is what block developers see in their .args() callbacks.\n *\n * @param storage - The BlockStorage object\n * @returns The data value that developers work with\n */\nexport function extractDataForDeveloper<TState>(storage: BlockStorage<TState>): TState {\n  return getStorageData(storage);\n}\n\n/**\n * Creates a new BlockStorage with updated state.\n * Used when setState is called from the frontend.\n *\n * @param currentStorage - Current BlockStorage (or undefined for new blocks)\n * @param newState - New state from developer\n * @param handlers - Optional custom handlers (defaults to standard handlers)\n * @returns Updated BlockStorage\n */\nexport function applyStateUpdate<TState>(\n  currentStorage: BlockStorage<TState> | undefined,\n  newState: TState,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const storage = currentStorage ?? createBlockStorage<TState>({} as TState);\n  const transform = handlers.transformStateForStorage ?? defaultBlockStorageHandlers.transformStateForStorage;\n  return transform(storage, newState) as BlockStorage<TState>;\n}\n\n/**\n * Serializes BlockStorage for writing to the resource tree.\n *\n * @param storage - The BlockStorage to serialize\n * @returns JSON string\n */\nexport function serializeBlockStorage(storage: BlockStorage): string {\n  return JSON.stringify(storage);\n}\n\n/**\n * Checks if the storage needs migration based on version.\n *\n * @param storage - Current BlockStorage\n * @param targetVersion - Target schema version\n * @returns true if migration is needed\n */\nexport function needsMigration(storage: BlockStorage, targetVersion: number): boolean {\n  return getStorageDataVersion(storage) < targetVersion;\n}\n\n/**\n * Migrates BlockStorage from one version to another.\n *\n * @param storage - Current BlockStorage\n * @param fromVersion - Source version\n * @param toVersion - Target version\n * @param handlers - Optional custom handlers\n * @returns Migrated BlockStorage\n */\nexport function migrateBlockStorage<TState>(\n  storage: BlockStorage<TState>,\n  fromVersion: number,\n  toVersion: number,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const migrate = handlers.migrateStorage ?? defaultBlockStorageHandlers.migrateStorage;\n  return migrate(storage, fromVersion, toVersion) as BlockStorage<TState>;\n}\n\n/**\n * V1/V2 legacy format - state stored as { args, uiState }\n */\nexport interface LegacyV1V2State {\n  args?: unknown;\n  uiState?: unknown;\n}\n\n/**\n * Checks if the raw data is in legacy V1/V2 format.\n * V1/V2 blocks stored { args, uiState } directly, not wrapped in BlockStorage.\n *\n * @param rawData - Raw data from blockStorage field\n * @returns true if data is in legacy format\n */\nexport function isLegacyV1V2Format(rawData: unknown): rawData is LegacyV1V2State {\n  if (rawData === null || typeof rawData !== 'object') return false;\n  // If it has the discriminator, it's BlockStorage format\n  if (isBlockStorage(rawData)) return false;\n\n  const obj = rawData as Record<string, unknown>;\n  // Legacy format has 'args' and/or 'uiState' at top level, no discriminator\n  return ('args' in obj || 'uiState' in obj);\n}\n\n/**\n * Converts legacy V1/V2 format to BlockStorage.\n * For backward compatibility with existing blocks.\n *\n * @param legacyData - Data in { args, uiState } format\n * @returns BlockStorage with legacy data as state\n */\nexport function convertLegacyToBlockStorage(legacyData: LegacyV1V2State): BlockStorage<LegacyV1V2State> {\n  return createBlockStorage(legacyData, 1);\n}\n\n/**\n * Smart parser that handles all storage formats:\n * - New BlockStorage format\n * - Legacy V1/V2 format ({ args, uiState })\n * - Raw state (any other format)\n *\n * @param rawData - Raw data from blockStorage field\n * @returns Normalized BlockStorage\n */\nexport function parseBlockStorageSmart<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  let parsed = rawData;\n  if (typeof rawData === 'string') {\n    try {\n      parsed = JSON.parse(rawData);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  // Check for legacy V1/V2 format\n  if (isLegacyV1V2Format(parsed)) {\n    return convertLegacyToBlockStorage(parsed) as unknown as BlockStorage<TState>;\n  }\n\n  // Use standard normalization\n  return normalizeBlockStorage<TState>(parsed);\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"block_storage_helper.js","sources":["../../src/model/block_storage_helper.ts"],"sourcesContent":["/**\n * Block Storage Helper - Middle layer utilities for BlockStorage operations.\n *\n * This module provides the bridge between the SDK's BlockStorage abstraction\n * and the middle layer's storage operations. Block developers never interact\n * with this - they only see `state`.\n *\n * @module block_storage_helper\n */\n\nimport type {\n  BlockStorage,\n  BlockStorageHandlers,\n} from '@platforma-sdk/model';\nimport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n} from '@platforma-sdk/model';\n\n// Re-export types for convenience\nexport type { BlockStorage, BlockStorageHandlers };\n\n// Re-export utilities that middle layer needs\nexport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  createBlockStorage,\n  defaultBlockStorageHandlers,\n  getPluginData,\n  getStorageData,\n  getStorageDataVersion,\n  isBlockStorage,\n  normalizeBlockStorage,\n  setPluginData,\n  updateStorageData,\n  updateStorageDataVersion,\n};\n\n/**\n * Parses raw blockStorage data (from resource tree) into BlockStorage.\n * Handles both legacy format (raw state) and new format (BlockStorage).\n *\n * @param rawData - Raw data from blockStorage field (may be string or parsed object)\n * @returns Normalized BlockStorage object\n */\nexport function parseBlockStorage<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  if (typeof rawData === 'string') {\n    try {\n      const parsed = JSON.parse(rawData);\n      return normalizeBlockStorage<TState>(parsed);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  return normalizeBlockStorage<TState>(rawData);\n}\n\n/**\n * Extracts the user-facing data from BlockStorage.\n * This is what block developers see in their .args() callbacks.\n *\n * @param storage - The BlockStorage object\n * @returns The data value that developers work with\n */\nexport function extractDataForDeveloper<TState>(storage: BlockStorage<TState>): TState {\n  return getStorageData(storage);\n}\n\n/**\n * Creates a new BlockStorage with updated state.\n * Used when setState is called from the frontend.\n *\n * @param currentStorage - Current BlockStorage (or undefined for new blocks)\n * @param newState - New state from developer\n * @param handlers - Optional custom handlers (defaults to standard handlers)\n * @returns Updated BlockStorage\n */\nexport function applyStateUpdate<TState>(\n  currentStorage: BlockStorage<TState> | undefined,\n  newState: TState,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const storage = currentStorage ?? createBlockStorage<TState>({} as TState);\n  const transform = handlers.transformStateForStorage ?? defaultBlockStorageHandlers.transformStateForStorage;\n  return transform(storage, newState) as BlockStorage<TState>;\n}\n\n/**\n * Serializes BlockStorage for writing to the resource tree.\n *\n * @param storage - The BlockStorage to serialize\n * @returns JSON string\n */\nexport function serializeBlockStorage(storage: BlockStorage): string {\n  return JSON.stringify(storage);\n}\n\n/**\n * Checks if the storage needs migration based on version key.\n *\n * @param storage - Current BlockStorage\n * @param targetVersion - Target version key\n * @returns true if migration is needed\n */\nexport function needsMigration(storage: BlockStorage, targetVersion: string): boolean {\n  return getStorageDataVersion(storage) !== targetVersion;\n}\n\n/**\n * Migrates BlockStorage from one version to another.\n *\n * @param storage - Current BlockStorage\n * @param fromVersion - Source version key\n * @param toVersion - Target version key\n * @param handlers - Optional custom handlers\n * @returns Migrated BlockStorage\n */\nexport function migrateBlockStorage<TState>(\n  storage: BlockStorage<TState>,\n  fromVersion: string,\n  toVersion: string,\n  handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,\n): BlockStorage<TState> {\n  const migrate = handlers.migrateStorage ?? defaultBlockStorageHandlers.migrateStorage;\n  return migrate(storage, fromVersion, toVersion) as BlockStorage<TState>;\n}\n\n/**\n * V1/V2 legacy format - state stored as { args, uiState }\n */\nexport interface LegacyV1V2State {\n  args?: unknown;\n  uiState?: unknown;\n}\n\n/**\n * Checks if the raw data is in legacy V1/V2 format.\n * V1/V2 blocks stored { args, uiState } directly, not wrapped in BlockStorage.\n *\n * @param rawData - Raw data from blockStorage field\n * @returns true if data is in legacy format\n */\nexport function isLegacyV1V2Format(rawData: unknown): rawData is LegacyV1V2State {\n  if (rawData === null || typeof rawData !== 'object') return false;\n  // If it has the discriminator, it's BlockStorage format\n  if (isBlockStorage(rawData)) return false;\n\n  const obj = rawData as Record<string, unknown>;\n  // Legacy format has 'args' and/or 'uiState' at top level, no discriminator\n  return ('args' in obj || 'uiState' in obj);\n}\n\n/**\n * Converts legacy V1/V2 format to BlockStorage.\n * For backward compatibility with existing blocks.\n *\n * @param legacyData - Data in { args, uiState } format\n * @returns BlockStorage with legacy data as state\n */\nexport function convertLegacyToBlockStorage(legacyData: LegacyV1V2State): BlockStorage<LegacyV1V2State> {\n  return createBlockStorage(legacyData);\n}\n\n/**\n * Smart parser that handles all storage formats:\n * - New BlockStorage format\n * - Legacy V1/V2 format ({ args, uiState })\n * - Raw state (any other format)\n *\n * @param rawData - Raw data from blockStorage field\n * @returns Normalized BlockStorage\n */\nexport function parseBlockStorageSmart<TState = unknown>(rawData: unknown): BlockStorage<TState> {\n  if (rawData === undefined || rawData === null) {\n    return createBlockStorage<TState>({} as TState);\n  }\n\n  // If it's a string, parse it first\n  let parsed = rawData;\n  if (typeof rawData === 'string') {\n    try {\n      parsed = JSON.parse(rawData);\n    } catch {\n      // If parsing fails, treat the string as the state itself\n      return createBlockStorage(rawData as unknown as TState);\n    }\n  }\n\n  // Check for legacy V1/V2 format\n  if (isLegacyV1V2Format(parsed)) {\n    return convertLegacyToBlockStorage(parsed) as unknown as BlockStorage<TState>;\n  }\n\n  // Use standard normalization\n  return normalizeBlockStorage<TState>(parsed);\n}\n"],"names":[],"mappings":"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"}

package/dist/model/project_helper.cjs

@@ -145,7 +145,7 @@ class ProjectHelper {
      *
      * @param blockConfig Block configuration
      * @param rawStorageJson Raw storage as JSON string (or undefined)
-     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": 1}')
+     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
      */
     getStorageDebugViewInVM(blockConfig, rawStorageJson) {
         try {
@@ -164,7 +164,7 @@ class ProjectHelper {
      * 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
+     * - Applies DataModel upgrade to reach target version key
      * - Runs all necessary migrations sequentially
      * - Returns new storage with updated state and version
      *

package/dist/model/project_helper.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.cjs","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, PlRef, ConfigRenderLambda, StorageDebugView } from '@platforma-sdk/model';\nimport type { StringifiedJson } from '@milaboratories/pl-model-common';\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 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_APPLY_UPDATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };\nconst STORAGE_DEBUG_VIEW_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_debugView' };\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   * 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 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\": 1}')\n   */\n  public getStorageDebugViewInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_DEBUG_VIEW_HANDLE,\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   * - 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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"}
+{"version":3,"file":"project_helper.cjs","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, PlRef, ConfigRenderLambda, StorageDebugView } from '@platforma-sdk/model';\nimport type { StringifiedJson } from '@milaboratories/pl-model-common';\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 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_APPLY_UPDATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };\nconst STORAGE_DEBUG_VIEW_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_debugView' };\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   * 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 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(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_DEBUG_VIEW_HANDLE,\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(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

@@ -81,14 +81,14 @@ export declare class ProjectHelper {
      *
      * @param blockConfig Block configuration
      * @param rawStorageJson Raw storage as JSON string (or undefined)
-     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": 1}')
+     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
      */
     getStorageDebugViewInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined;
     /**
      * Runs block state migrations via VM-based transformation.
      * This calls the model's `__pl_storage_migrate` callback which:
      * - Normalizes current storage to get state and version
-     * - Calculates target version from number of registered migrations
+     * - Applies DataModel upgrade to reach target version key
      * - Runs all necessary migrations sequentially
      * - Returns new storage with updated state and version
      *

package/dist/model/project_helper.js

@@ -143,7 +143,7 @@ class ProjectHelper {
      *
      * @param blockConfig Block configuration
      * @param rawStorageJson Raw storage as JSON string (or undefined)
-     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": 1}')
+     * @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
      */
     getStorageDebugViewInVM(blockConfig, rawStorageJson) {
         try {
@@ -162,7 +162,7 @@ class ProjectHelper {
      * 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
+     * - Applies DataModel upgrade to reach target version key
      * - Runs all necessary migrations sequentially
      * - Returns new storage with updated state and version
      *

package/dist/model/project_helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"project_helper.js","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, PlRef, ConfigRenderLambda, StorageDebugView } from '@platforma-sdk/model';\nimport type { StringifiedJson } from '@milaboratories/pl-model-common';\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 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_APPLY_UPDATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };\nconst STORAGE_DEBUG_VIEW_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_debugView' };\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   * 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 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\": 1}')\n   */\n  public getStorageDebugViewInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_DEBUG_VIEW_HANDLE,\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   * - 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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"}
+{"version":3,"file":"project_helper.js","sources":["../../src/model/project_helper.ts"],"sourcesContent":["import type { ResultOrError, BlockConfig, PlRef, ConfigRenderLambda, StorageDebugView } from '@platforma-sdk/model';\nimport type { StringifiedJson } from '@milaboratories/pl-model-common';\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 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_APPLY_UPDATE_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_applyUpdate' };\nconst STORAGE_DEBUG_VIEW_HANDLE: ConfigRenderLambda = { __renderLambda: true, handle: '__pl_storage_debugView' };\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   * 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 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(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined {\n    try {\n      const result = executeSingleLambda(\n        this.quickJs,\n        STORAGE_DEBUG_VIEW_HANDLE,\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(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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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-middle-layer",
-  "version": "1.46.8",
+  "version": "1.46.10",
   "description": "Pl Middle Layer",
   "engines": {
     "node": ">=22.19.0"
@@ -33,22 +33,22 @@
     "zod": "~3.23.8",
     "remeda": "^2.28.0",
     "@milaboratories/pl-http": "1.2.0",
-    "@milaboratories/resolve-helper": "1.1.1",
     "@milaboratories/computable": "2.8.2",
-    "@platforma-sdk/block-tools": "2.6.33",
-    "@milaboratories/pl-drivers": "1.11.42",
+    "@platforma-sdk/block-tools": "2.6.35",
+    "@milaboratories/resolve-helper": "1.1.1",
     "@milaboratories/pl-client": "2.16.24",
+    "@milaboratories/pl-drivers": "1.11.42",
+    "@milaboratories/pl-model-middle-layer": "1.10.4",
     "@milaboratories/pl-model-backend": "1.1.41",
-    "@milaboratories/pl-tree": "1.8.32",
     "@milaboratories/pl-model-common": "1.24.1",
-    "@milaboratories/pl-model-middle-layer": "1.10.2",
-    "@milaboratories/ts-helpers": "1.7.0",
-    "@platforma-sdk/model": "1.53.0",
-    "@milaboratories/pl-errors": "1.1.56",
+    "@milaboratories/pl-tree": "1.8.32",
+    "@platforma-sdk/model": "1.53.2",
     "@platforma-sdk/workflow-tengo": "5.8.1",
     "@milaboratories/pl-config": "1.7.11",
+    "@milaboratories/ts-helpers": "1.7.0",
+    "@milaboratories/pl-errors": "1.1.56",
     "@milaboratories/pl-deployments": "2.15.5",
-    "@milaboratories/pf-driver": "1.0.28"
+    "@milaboratories/pf-driver": "1.0.30"
   },
   "devDependencies": {
     "semver": "^7.7.2",
@@ -60,9 +60,9 @@
     "@types/node": "~24.5.2",
     "tslib": "~2.7.0",
     "@milaboratories/build-configs": "1.4.0",
-    "@milaboratories/ts-configs": "1.2.0",
     "@milaboratories/eslint-config": "1.0.5",
-    "@milaboratories/ts-builder": "1.2.4"
+    "@milaboratories/ts-builder": "1.2.4",
+    "@milaboratories/ts-configs": "1.2.0"
   },
   "scripts": {
     "type-check": "ts-builder types --target node",

package/src/model/block_storage_helper.ts

@@ -113,29 +113,29 @@ export function serializeBlockStorage(storage: BlockStorage): string {
 }
 
 /**
- * Checks if the storage needs migration based on version.
+ * Checks if the storage needs migration based on version key.
  *
  * @param storage - Current BlockStorage
- * @param targetVersion - Target schema version
+ * @param targetVersion - Target version key
  * @returns true if migration is needed
  */
-export function needsMigration(storage: BlockStorage, targetVersion: number): boolean {
-  return getStorageDataVersion(storage) < targetVersion;
+export function needsMigration(storage: BlockStorage, targetVersion: string): boolean {
+  return getStorageDataVersion(storage) !== targetVersion;
 }
 
 /**
  * Migrates BlockStorage from one version to another.
  *
  * @param storage - Current BlockStorage
- * @param fromVersion - Source version
- * @param toVersion - Target version
+ * @param fromVersion - Source version key
+ * @param toVersion - Target version key
  * @param handlers - Optional custom handlers
  * @returns Migrated BlockStorage
  */
 export function migrateBlockStorage<TState>(
   storage: BlockStorage<TState>,
-  fromVersion: number,
-  toVersion: number,
+  fromVersion: string,
+  toVersion: string,
   handlers: BlockStorageHandlers<TState> = defaultBlockStorageHandlers as BlockStorageHandlers<TState>,
 ): BlockStorage<TState> {
   const migrate = handlers.migrateStorage ?? defaultBlockStorageHandlers.migrateStorage;
@@ -175,7 +175,7 @@ export function isLegacyV1V2Format(rawData: unknown): rawData is LegacyV1V2State
  * @returns BlockStorage with legacy data as state
  */
 export function convertLegacyToBlockStorage(legacyData: LegacyV1V2State): BlockStorage<LegacyV1V2State> {
-  return createBlockStorage(legacyData, 1);
+  return createBlockStorage(legacyData);
 }
 
 /**

package/src/model/project_helper.ts

@@ -202,7 +202,7 @@ export class ProjectHelper {
    *
    * @param blockConfig Block configuration
    * @param rawStorageJson Raw storage as JSON string (or undefined)
-   * @returns Storage debug view as JSON string (e.g., '{"dataVersion": 1}')
+   * @returns Storage debug view as JSON string (e.g., '{"dataVersion": "v1"}')
    */
   public getStorageDebugViewInVM(blockConfig: BlockConfig, rawStorageJson: string | undefined): StringifiedJson<StorageDebugView> | undefined {
     try {
@@ -227,7 +227,7 @@ export class ProjectHelper {
    * 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
+   * - Applies DataModel upgrade to reach target version key
    * - Runs all necessary migrations sequentially
    * - Returns new storage with updated state and version
    *