@platforma-sdk/model 1.54.10 → 1.55.0

package/src/render/api.ts

@@ -533,40 +533,40 @@ export class ResultPool implements ColumnProvider, AxisLabelProvider {
 }
 
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) */
-export abstract class RenderCtxBase<Args, Data> {
+export abstract class RenderCtxBase<Args = unknown, Data = unknown> {
   protected readonly ctx: GlobalCfgRenderCtx;
 
   constructor() {
     this.ctx = getCfgRenderCtx();
   }
 
-  private _dataCache?: { v: Data };
+  private dataCache?: { v: Data };
 
   public get data(): Data {
-    if (this._dataCache === undefined) {
+    if (this.dataCache === undefined) {
       const raw = this.ctx.data;
       const value = typeof raw === "function" ? raw() : raw;
-      this._dataCache = { v: value ? JSON.parse(value) : ({} as Data) };
+      this.dataCache = { v: value ? JSON.parse(value) : ({} as Data) };
     }
-    return this._dataCache.v;
+    return this.dataCache.v;
   }
 
   // lazy rendering because this feature is rarely used
-  private _activeArgsCache?: { v?: Args };
+  private activeArgsCache?: { v?: Args };
 
   /**
    * Returns args snapshot the block was executed for (i.e. when "Run" button was pressed).
    * Returns undefined, if block was never executed or stopped mid-way execution, so that the result was cleared.
    * */
   public get activeArgs(): Args | undefined {
-    if (this._activeArgsCache === undefined) {
+    if (this.activeArgsCache === undefined) {
       const raw = this.ctx.activeArgs;
       const value = typeof raw === "function" ? raw() : raw;
-      this._activeArgsCache = {
+      this.activeArgsCache = {
         v: value ? JSON.parse(value) : undefined,
       };
     }
-    return this._activeArgsCache.v;
+    return this.activeArgsCache.v;
   }
 
   // /** Can be used to determine features provided by the desktop instance. */
@@ -711,41 +711,43 @@ export abstract class RenderCtxBase<Args, Data> {
 }
 
 /** Main entry point to the API available within model lambdas (like outputs, sections, etc..) for v3+ blocks */
-export class RenderCtx<Args, Data> extends RenderCtxBase<Args, Data> {
-  private _argsCache?: { v: Args | undefined };
+export class RenderCtx<Args = unknown, Data = unknown> extends RenderCtxBase<Args, Data> {
+  private argsCache?: { v: Args | undefined };
   public get args(): Args | undefined {
-    if (this._argsCache === undefined) {
+    if (this.argsCache === undefined) {
       const raw = this.ctx.args;
       const value = typeof raw === "function" ? raw() : raw;
-      // args can be undefined when derivation fails (e.g., validation error in args())
-      this._argsCache = { v: value === undefined ? undefined : JSON.parse(value) };
+      this.argsCache = { v: value === undefined ? undefined : JSON.parse(value) };
     }
-    return this._argsCache.v;
+    return this.argsCache.v;
   }
 }
 
 /** Render context for legacy v1/v2 blocks - provides backward compatibility */
-export class RenderCtxLegacy<Args, UiState> extends RenderCtxBase<Args, UiState> {
-  private _argsCache?: { v: Args };
+export class RenderCtxLegacy<Args = unknown, UiState = unknown> extends RenderCtxBase<
+  Args,
+  UiState
+> {
+  private argsCache?: { v: Args };
 
   public get args(): Args {
-    if (this._argsCache === undefined) {
+    if (this.argsCache === undefined) {
       const raw = this.ctx.args;
       const value = typeof raw === "function" ? raw() : raw;
-      this._argsCache = { v: JSON.parse(value) };
+      this.argsCache = { v: JSON.parse(value) };
     }
-    return this._argsCache.v;
+    return this.argsCache.v;
   }
 
-  private _uiStateCache?: { v: UiState };
+  private uiStateCache?: { v: UiState };
 
   public get uiState(): UiState {
-    if (this._uiStateCache === undefined) {
+    if (this.uiStateCache === undefined) {
       const raw = this.ctx.uiState!;
       const value = typeof raw === "function" ? raw() : raw;
-      this._uiStateCache = { v: value ? JSON.parse(value) : ({} as UiState) };
+      this.uiStateCache = { v: value ? JSON.parse(value) : ({} as UiState) };
     }
-    return this._uiStateCache.v;
+    return this.uiStateCache.v;
   }
 }
 

package/src/render/internal.ts

@@ -1,5 +1,5 @@
 import type { Optional } from "utility-types";
-import type { Branded } from "../branding";
+import type { Branded } from "@milaboratories/pl-model-common";
 import type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from "./traversal_ops";
 import type {
   ArchiveFormat,

package/src/typing.test.ts

@@ -6,7 +6,7 @@ import {
 } from "@milaboratories/pl-model-common";
 import { expect, test } from "vitest";
 import { DeriveHref, StdCtx } from "./bconfig";
-import { BlockModel } from "./builder";
+import { BlockModel } from "./block_model_legacy";
 import {
   Args,
   ConfigResult,

package/src/version.ts

@@ -1,2 +1,10 @@
 import { version } from "../package.json";
 export const PlatformaSDKVersion = version;
+
+export type SdkInfo = {
+  readonly sdkVersion: string;
+};
+
+export const CurrentSdkInfo: SdkInfo = {
+  sdkVersion: PlatformaSDKVersion,
+};

package/dist/block_storage_vm.cjs

@@ -1,262 +0,0 @@
-'use strict';
-
-var block_storage = require('./block_storage.cjs');
-var plModelCommon = require('@milaboratories/pl-model-common');
-var internal = require('./internal.cjs');
-
-/**
- * BlockStorage VM Integration - Internal module for VM-based storage operations.
- *
- * This module auto-registers internal callbacks that the middle layer can invoke
- * to perform storage transformations. Block developers never interact with these
- * directly - they only see `state`.
- *
- * Registered callbacks (all prefixed with `__pl_` for internal SDK use):
- * - `__pl_storage_applyUpdate`: (currentStorageJson, payload) => updatedStorageJson
- * - `__pl_storage_debugView`: (rawStorage) => JSON string with storage debug view
- * - `__pl_storage_migrate`: (currentStorageJson) => MigrationResult
- * - `__pl_args_derive`: (storageJson) => ArgsDeriveResult
- * - `__pl_prerunArgs_derive`: (storageJson) => ArgsDeriveResult
- *
- * Callbacks registered by DataModel.registerCallbacks():
- * - `__pl_data_initial`: () => initial data
- * - `__pl_data_upgrade`: (versioned) => DataMigrationResult
- * - `__pl_storage_initial`: () => initial BlockStorage as JSON string
- *
- * @module block_storage_vm
- * @internal
- */
-/**
- * Normalizes raw storage data and extracts state.
- * Handles all formats:
- * - New BlockStorage format (has discriminator)
- * - Legacy V1/V2 format ({ args, uiState })
- * - Raw V3 state (any other format)
- *
- * @param rawStorage - Raw data from blockStorage field (may be JSON string or object)
- * @returns Object with normalized storage and extracted state
- */
-function normalizeStorage(rawStorage) {
-    // Handle undefined/null
-    if (rawStorage === undefined || rawStorage === null) {
-        const storage = block_storage.createBlockStorage({});
-        return { storage, data: {} };
-    }
-    // Parse JSON string if needed
-    let parsed = rawStorage;
-    if (typeof rawStorage === "string") {
-        try {
-            parsed = JSON.parse(rawStorage);
-        }
-        catch {
-            // If parsing fails, treat string as the data
-            const storage = block_storage.createBlockStorage(rawStorage);
-            return { storage, data: rawStorage };
-        }
-    }
-    // Check for BlockStorage format (has discriminator)
-    if (block_storage.isBlockStorage(parsed)) {
-        const storage = block_storage.normalizeBlockStorage(parsed);
-        return { storage, data: block_storage.getStorageData(storage) };
-    }
-    // Check for legacy V1/V2 format: { args, uiState }
-    if (isLegacyModelV1ApiFormat(parsed)) {
-        // For legacy format, the whole object IS the data
-        const storage = block_storage.createBlockStorage(parsed);
-        return { storage, data: parsed };
-    }
-    // Raw V3 data - wrap it
-    const storage = block_storage.createBlockStorage(parsed);
-    return { storage, data: parsed };
-}
-/**
- * Applies a state update to existing storage.
- * Used when setData is called from the frontend.
- *
- * @param currentStorageJson - Current storage as JSON string (must be defined)
- * @param newData - New data from application
- * @returns Updated storage as JSON string
- */
-function applyStorageUpdate(currentStorageJson, payload) {
-    const { storage: currentStorage } = normalizeStorage(currentStorageJson);
-    // Update data while preserving other storage fields (version, plugins)
-    const updatedStorage = block_storage.updateStorageData(currentStorage, payload);
-    return JSON.stringify(updatedStorage);
-}
-/**
- * Checks if data is in legacy Model API v1 format.
- * Legacy format has { args, uiState? } at top level without the BlockStorage discriminator.
- */
-function isLegacyModelV1ApiFormat(data) {
-    if (data === null || typeof data !== "object")
-        return false;
-    if (block_storage.isBlockStorage(data))
-        return false;
-    const obj = data;
-    return "args" in obj;
-}
-// =============================================================================
-// Auto-register internal callbacks when module is loaded in VM
-// =============================================================================
-// Register apply update callback (requires existing storage)
-internal.tryRegisterCallback("__pl_storage_applyUpdate", (currentStorageJson, payload) => {
-    return applyStorageUpdate(currentStorageJson, payload);
-});
-/**
- * Gets storage debug view from raw storage data.
- * Returns structured debug info about the storage state.
- *
- * @param rawStorage - Raw data from blockStorage field (may be JSON string or object)
- * @returns JSON string with storage debug view
- */
-function getStorageDebugView(rawStorage) {
-    const { storage } = normalizeStorage(rawStorage);
-    const debugView = {
-        dataVersion: storage.__dataVersion,
-        data: storage.__data,
-    };
-    return plModelCommon.stringifyJson(debugView);
-}
-// Register debug view callback
-internal.tryRegisterCallback("__pl_storage_debugView", (rawStorage) => {
-    return getStorageDebugView(rawStorage);
-});
-/**
- * Runs storage migration using the DataModel's migrate callback.
- * This is the main entry point for the middle layer to trigger migrations.
- *
- * Uses the '__pl_data_upgrade' callback registered by DataModel.registerCallbacks() which:
- * - Handles all migration logic internally
- * - Returns { version, data, warning? } - warning present if reset to initial data
- *
- * @param currentStorageJson - Current storage as JSON string (or undefined)
- * @returns MigrationResult
- */
-function migrateStorage(currentStorageJson) {
-    // Get the callback registry context
-    const ctx = internal.tryGetCfgRenderCtx();
-    if (ctx === undefined) {
-        return { error: "Not in config rendering context" };
-    }
-    // Normalize storage to get current data and version
-    const { storage: currentStorage, data: currentData } = normalizeStorage(currentStorageJson);
-    const currentVersion = currentStorage.__dataVersion;
-    // Helper to create storage with given data and version
-    const createStorageJson = (data, version) => {
-        return JSON.stringify({
-            ...currentStorage,
-            __dataVersion: version,
-            __data: data,
-        });
-    };
-    // Get the migrate callback (registered by DataModel.registerCallbacks())
-    const migrateCallback = ctx.callbackRegistry["__pl_data_upgrade"];
-    if (typeof migrateCallback !== "function") {
-        return { error: "__pl_data_upgrade callback not found (DataModel not registered)" };
-    }
-    // Call the migrator's migrate function
-    let result;
-    try {
-        result = migrateCallback({ version: currentVersion, data: currentData });
-    }
-    catch (e) {
-        const errorMsg = e instanceof Error ? e.message : String(e);
-        return { error: `migrate() threw: ${errorMsg}` };
-    }
-    // Build info message
-    const info = result.version === currentVersion
-        ? `No migration needed (${currentVersion})`
-        : result.warning
-            ? `Reset to initial data (${result.version})`
-            : `Migrated ${currentVersion}→${result.version}`;
-    return {
-        newStorageJson: createStorageJson(result.data, result.version),
-        info,
-        warn: result.warning,
-    };
-}
-// Register migrate callback
-internal.tryRegisterCallback("__pl_storage_migrate", (currentStorageJson) => {
-    return migrateStorage(currentStorageJson);
-});
-/**
- * Derives args from storage using the registered 'args' callback.
- * This extracts data from storage and passes it to the block's args() function.
- *
- * @param storageJson - Storage as JSON string
- * @returns ArgsDeriveResult with derived args or error
- */
-function deriveArgsFromStorage(storageJson) {
-    const ctx = internal.tryGetCfgRenderCtx();
-    if (ctx === undefined) {
-        return { error: "Not in config rendering context" };
-    }
-    // Extract data from storage
-    const { data } = normalizeStorage(storageJson);
-    // Get the args callback (registered by BlockModelV3.args())
-    const argsCallback = ctx.callbackRegistry["args"];
-    if (typeof argsCallback !== "function") {
-        return { error: "args callback not found" };
-    }
-    // Call the args callback with extracted data
-    try {
-        const result = argsCallback(data);
-        return { value: result };
-    }
-    catch (e) {
-        const errorMsg = e instanceof Error ? e.message : String(e);
-        return { error: `args() threw: ${errorMsg}` };
-    }
-}
-// Register args derivation callback
-internal.tryRegisterCallback("__pl_args_derive", (storageJson) => {
-    return deriveArgsFromStorage(storageJson);
-});
-/**
- * Derives prerunArgs from storage using the registered 'prerunArgs' callback.
- * Falls back to 'args' callback if 'prerunArgs' is not defined.
- *
- * @param storageJson - Storage as JSON string
- * @returns ArgsDeriveResult with derived prerunArgs or error
- */
-function derivePrerunArgsFromStorage(storageJson) {
-    const ctx = internal.tryGetCfgRenderCtx();
-    if (ctx === undefined) {
-        return { error: "Not in config rendering context" };
-    }
-    // Extract data from storage
-    const { data } = normalizeStorage(storageJson);
-    // Try prerunArgs callback first
-    const prerunArgsCallback = ctx.callbackRegistry["prerunArgs"];
-    if (typeof prerunArgsCallback === "function") {
-        try {
-            const result = prerunArgsCallback(data);
-            return { value: result };
-        }
-        catch (e) {
-            const errorMsg = e instanceof Error ? e.message : String(e);
-            return { error: `prerunArgs() threw: ${errorMsg}` };
-        }
-    }
-    // Fall back to args callback
-    const argsCallback = ctx.callbackRegistry["args"];
-    if (typeof argsCallback !== "function") {
-        return { error: "args callback not found (fallback from missing prerunArgs)" };
-    }
-    try {
-        const result = argsCallback(data);
-        return { value: result };
-    }
-    catch (e) {
-        const errorMsg = e instanceof Error ? e.message : String(e);
-        return { error: `args() threw (fallback): ${errorMsg}` };
-    }
-}
-// Register prerunArgs derivation callback
-internal.tryRegisterCallback("__pl_prerunArgs_derive", (storageJson) => {
-    return derivePrerunArgsFromStorage(storageJson);
-});
-
-exports.BLOCK_STORAGE_KEY = block_storage.BLOCK_STORAGE_KEY;
-exports.BLOCK_STORAGE_SCHEMA_VERSION = block_storage.BLOCK_STORAGE_SCHEMA_VERSION;
-//# sourceMappingURL=block_storage_vm.cjs.map

package/dist/block_storage_vm.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"block_storage_vm.cjs","sources":["../src/block_storage_vm.ts"],"sourcesContent":["/**\n * BlockStorage VM Integration - Internal module for VM-based storage operations.\n *\n * This module auto-registers internal callbacks that the middle layer can invoke\n * to perform storage transformations. Block developers never interact with these\n * directly - they only see `state`.\n *\n * Registered callbacks (all prefixed with `__pl_` for internal SDK use):\n * - `__pl_storage_applyUpdate`: (currentStorageJson, payload) => updatedStorageJson\n * - `__pl_storage_debugView`: (rawStorage) => JSON string with storage debug view\n * - `__pl_storage_migrate`: (currentStorageJson) => MigrationResult\n * - `__pl_args_derive`: (storageJson) => ArgsDeriveResult\n * - `__pl_prerunArgs_derive`: (storageJson) => ArgsDeriveResult\n *\n * Callbacks registered by DataModel.registerCallbacks():\n * - `__pl_data_initial`: () => initial data\n * - `__pl_data_upgrade`: (versioned) => DataMigrationResult\n * - `__pl_storage_initial`: () => initial BlockStorage as JSON string\n *\n * @module block_storage_vm\n * @internal\n */\n\nimport {\n  BLOCK_STORAGE_KEY,\n  BLOCK_STORAGE_SCHEMA_VERSION,\n  type BlockStorage,\n  type MutateStoragePayload,\n  type StorageDebugView,\n  createBlockStorage,\n  getStorageData,\n  isBlockStorage,\n  normalizeBlockStorage,\n  updateStorageData,\n} from \"./block_storage\";\nimport { stringifyJson, type StringifiedJson } from \"@milaboratories/pl-model-common\";\nimport { tryGetCfgRenderCtx, tryRegisterCallback } from \"./internal\";\n\n/**\n * Result of storage normalization\n */\nexport interface NormalizeStorageResult {\n  /** The normalized BlockStorage object */\n  storage: BlockStorage;\n  /** The extracted data (what developers see) */\n  data: unknown;\n}\n\n/**\n * Normalizes raw storage data and extracts state.\n * Handles all formats:\n * - New BlockStorage format (has discriminator)\n * - Legacy V1/V2 format ({ args, uiState })\n * - Raw V3 state (any other format)\n *\n * @param rawStorage - Raw data from blockStorage field (may be JSON string or object)\n * @returns Object with normalized storage and extracted state\n */\nfunction normalizeStorage(rawStorage: unknown): NormalizeStorageResult {\n  // Handle undefined/null\n  if (rawStorage === undefined || rawStorage === null) {\n    const storage = createBlockStorage({});\n    return { storage, data: {} };\n  }\n\n  // Parse JSON string if needed\n  let parsed = rawStorage;\n  if (typeof rawStorage === \"string\") {\n    try {\n      parsed = JSON.parse(rawStorage);\n    } catch {\n      // If parsing fails, treat string as the data\n      const storage = createBlockStorage(rawStorage);\n      return { storage, data: rawStorage };\n    }\n  }\n\n  // Check for BlockStorage format (has discriminator)\n  if (isBlockStorage(parsed)) {\n    const storage = normalizeBlockStorage(parsed);\n    return { storage, data: getStorageData(storage) };\n  }\n\n  // Check for legacy V1/V2 format: { args, uiState }\n  if (isLegacyModelV1ApiFormat(parsed)) {\n    // For legacy format, the whole object IS the data\n    const storage = createBlockStorage(parsed);\n    return { storage, data: parsed };\n  }\n\n  // Raw V3 data - wrap it\n  const storage = createBlockStorage(parsed);\n  return { storage, data: parsed };\n}\n\n/**\n * Applies a state update to existing storage.\n * Used when setData is called from the frontend.\n *\n * @param currentStorageJson - Current storage as JSON string (must be defined)\n * @param newData - New data from application\n * @returns Updated storage as JSON string\n */\nfunction applyStorageUpdate(currentStorageJson: string, payload: MutateStoragePayload): string {\n  const { storage: currentStorage } = normalizeStorage(currentStorageJson);\n\n  // Update data while preserving other storage fields (version, plugins)\n  const updatedStorage = updateStorageData(currentStorage, payload);\n\n  return JSON.stringify(updatedStorage);\n}\n\n/**\n * Checks if data is in legacy Model API v1 format.\n * Legacy format has { args, uiState? } at top level without the BlockStorage discriminator.\n */\nfunction isLegacyModelV1ApiFormat(data: unknown): data is { args?: unknown } {\n  if (data === null || typeof data !== \"object\") return false;\n  if (isBlockStorage(data)) return false;\n\n  const obj = data as Record<string, unknown>;\n  return \"args\" in obj;\n}\n\n// =============================================================================\n// Auto-register internal callbacks when module is loaded in VM\n// =============================================================================\n\n// Register apply update callback (requires existing storage)\ntryRegisterCallback(\n  \"__pl_storage_applyUpdate\",\n  (currentStorageJson: string, payload: MutateStoragePayload) => {\n    return applyStorageUpdate(currentStorageJson, payload);\n  },\n);\n\n/**\n * Gets storage debug view from raw storage data.\n * Returns structured debug info about the storage state.\n *\n * @param rawStorage - Raw data from blockStorage field (may be JSON string or object)\n * @returns JSON string with storage debug view\n */\nfunction getStorageDebugView(rawStorage: unknown): StringifiedJson<StorageDebugView> {\n  const { storage } = normalizeStorage(rawStorage);\n  const debugView: StorageDebugView = {\n    dataVersion: storage.__dataVersion,\n    data: storage.__data,\n  };\n  return stringifyJson(debugView);\n}\n\n// Register debug view callback\ntryRegisterCallback(\"__pl_storage_debugView\", (rawStorage: unknown) => {\n  return getStorageDebugView(rawStorage);\n});\n\n// =============================================================================\n// Migration Support\n// =============================================================================\n\n/**\n * Result of storage migration.\n * Returned by __pl_storage_migrate callback.\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/** Result from DataModel.migrate() */\ninterface DataMigrationResult {\n  version: string;\n  data: unknown;\n  warning?: string;\n}\n\n/**\n * Runs storage migration using the DataModel's migrate callback.\n * This is the main entry point for the middle layer to trigger migrations.\n *\n * Uses the '__pl_data_upgrade' callback registered by DataModel.registerCallbacks() which:\n * - Handles all migration logic internally\n * - Returns { version, data, warning? } - warning present if reset to initial data\n *\n * @param currentStorageJson - Current storage as JSON string (or undefined)\n * @returns MigrationResult\n */\nfunction migrateStorage(currentStorageJson: string | undefined): MigrationResult {\n  // Get the callback registry context\n  const ctx = tryGetCfgRenderCtx();\n  if (ctx === undefined) {\n    return { error: \"Not in config rendering context\" };\n  }\n\n  // Normalize storage to get current data and version\n  const { storage: currentStorage, data: currentData } = normalizeStorage(currentStorageJson);\n  const currentVersion = currentStorage.__dataVersion;\n\n  // Helper to create storage with given data and version\n  const createStorageJson = (data: unknown, version: string): string => {\n    return JSON.stringify({\n      ...currentStorage,\n      __dataVersion: version,\n      __data: data,\n    });\n  };\n\n  // Get the migrate callback (registered by DataModel.registerCallbacks())\n  const migrateCallback = ctx.callbackRegistry[\"__pl_data_upgrade\"] as\n    | ((v: { version: string; data: unknown }) => DataMigrationResult)\n    | undefined;\n  if (typeof migrateCallback !== \"function\") {\n    return { error: \"__pl_data_upgrade callback not found (DataModel not registered)\" };\n  }\n\n  // Call the migrator's migrate function\n  let result: DataMigrationResult;\n  try {\n    result = migrateCallback({ version: currentVersion, data: currentData });\n  } catch (e) {\n    const errorMsg = e instanceof Error ? e.message : String(e);\n    return { error: `migrate() threw: ${errorMsg}` };\n  }\n\n  // Build info message\n  const info =\n    result.version === currentVersion\n      ? `No migration needed (${currentVersion})`\n      : result.warning\n        ? `Reset to initial data (${result.version})`\n        : `Migrated ${currentVersion}→${result.version}`;\n\n  return {\n    newStorageJson: createStorageJson(result.data, result.version),\n    info,\n    warn: result.warning,\n  };\n}\n\n// Register migrate callback\ntryRegisterCallback(\"__pl_storage_migrate\", (currentStorageJson: string | undefined) => {\n  return migrateStorage(currentStorageJson);\n});\n\n// =============================================================================\n// Args Derivation from Storage\n// =============================================================================\n\n/**\n * Result of args derivation from storage.\n * Returned by __pl_args_derive and __pl_prerunArgs_derive callbacks.\n */\nexport type ArgsDeriveResult = { error: string } | { error?: undefined; value: unknown };\n\n/**\n * Derives args from storage using the registered 'args' callback.\n * This extracts data from storage and passes it to the block's args() function.\n *\n * @param storageJson - Storage as JSON string\n * @returns ArgsDeriveResult with derived args or error\n */\nfunction deriveArgsFromStorage(storageJson: string): ArgsDeriveResult {\n  const ctx = tryGetCfgRenderCtx();\n  if (ctx === undefined) {\n    return { error: \"Not in config rendering context\" };\n  }\n\n  // Extract data from storage\n  const { data } = normalizeStorage(storageJson);\n\n  // Get the args callback (registered by BlockModelV3.args())\n  const argsCallback = ctx.callbackRegistry[\"args\"] as ((data: unknown) => unknown) | undefined;\n  if (typeof argsCallback !== \"function\") {\n    return { error: \"args callback not found\" };\n  }\n\n  // Call the args callback with extracted data\n  try {\n    const result = argsCallback(data);\n    return { value: result };\n  } catch (e) {\n    const errorMsg = e instanceof Error ? e.message : String(e);\n    return { error: `args() threw: ${errorMsg}` };\n  }\n}\n\n// Register args derivation callback\ntryRegisterCallback(\"__pl_args_derive\", (storageJson: string) => {\n  return deriveArgsFromStorage(storageJson);\n});\n\n/**\n * Derives prerunArgs from storage using the registered 'prerunArgs' callback.\n * Falls back to 'args' callback if 'prerunArgs' is not defined.\n *\n * @param storageJson - Storage as JSON string\n * @returns ArgsDeriveResult with derived prerunArgs or error\n */\nfunction derivePrerunArgsFromStorage(storageJson: string): ArgsDeriveResult {\n  const ctx = tryGetCfgRenderCtx();\n  if (ctx === undefined) {\n    return { error: \"Not in config rendering context\" };\n  }\n\n  // Extract data from storage\n  const { data } = normalizeStorage(storageJson);\n\n  // Try prerunArgs callback first\n  const prerunArgsCallback = ctx.callbackRegistry[\"prerunArgs\"] as\n    | ((data: unknown) => unknown)\n    | undefined;\n  if (typeof prerunArgsCallback === \"function\") {\n    try {\n      const result = prerunArgsCallback(data);\n      return { value: result };\n    } catch (e) {\n      const errorMsg = e instanceof Error ? e.message : String(e);\n      return { error: `prerunArgs() threw: ${errorMsg}` };\n    }\n  }\n\n  // Fall back to args callback\n  const argsCallback = ctx.callbackRegistry[\"args\"] as ((data: unknown) => unknown) | undefined;\n  if (typeof argsCallback !== \"function\") {\n    return { error: \"args callback not found (fallback from missing prerunArgs)\" };\n  }\n\n  try {\n    const result = argsCallback(data);\n    return { value: result };\n  } catch (e) {\n    const errorMsg = e instanceof Error ? e.message : String(e);\n    return { error: `args() threw (fallback): ${errorMsg}` };\n  }\n}\n\n// Register prerunArgs derivation callback\ntryRegisterCallback(\"__pl_prerunArgs_derive\", (storageJson: string) => {\n  return derivePrerunArgsFromStorage(storageJson);\n});\n\n// Export discriminator key and schema version for external checks\nexport { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION };\n"],"names":["createBlockStorage","isBlockStorage","normalizeBlockStorage","getStorageData","updateStorageData","tryRegisterCallback","stringifyJson","tryGetCfgRenderCtx"],"mappings":"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"}

package/dist/block_storage_vm.d.ts

@@ -1,59 +0,0 @@
-/**
- * BlockStorage VM Integration - Internal module for VM-based storage operations.
- *
- * This module auto-registers internal callbacks that the middle layer can invoke
- * to perform storage transformations. Block developers never interact with these
- * directly - they only see `state`.
- *
- * Registered callbacks (all prefixed with `__pl_` for internal SDK use):
- * - `__pl_storage_applyUpdate`: (currentStorageJson, payload) => updatedStorageJson
- * - `__pl_storage_debugView`: (rawStorage) => JSON string with storage debug view
- * - `__pl_storage_migrate`: (currentStorageJson) => MigrationResult
- * - `__pl_args_derive`: (storageJson) => ArgsDeriveResult
- * - `__pl_prerunArgs_derive`: (storageJson) => ArgsDeriveResult
- *
- * Callbacks registered by DataModel.registerCallbacks():
- * - `__pl_data_initial`: () => initial data
- * - `__pl_data_upgrade`: (versioned) => DataMigrationResult
- * - `__pl_storage_initial`: () => initial BlockStorage as JSON string
- *
- * @module block_storage_vm
- * @internal
- */
-import { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION, type BlockStorage } from "./block_storage";
-/**
- * Result of storage normalization
- */
-export interface NormalizeStorageResult {
-    /** The normalized BlockStorage object */
-    storage: BlockStorage;
-    /** The extracted data (what developers see) */
-    data: unknown;
-}
-/**
- * Result of storage migration.
- * Returned by __pl_storage_migrate callback.
- *
- * - 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;
-};
-/**
- * Result of args derivation from storage.
- * Returned by __pl_args_derive and __pl_prerunArgs_derive callbacks.
- */
-export type ArgsDeriveResult = {
-    error: string;
-} | {
-    error?: undefined;
-    value: unknown;
-};
-export { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION };
-//# sourceMappingURL=block_storage_vm.d.ts.map

package/dist/block_storage_vm.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"block_storage_vm.d.ts","sourceRoot":"","sources":["../src/block_storage_vm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,KAAK,YAAY,EAQlB,MAAM,iBAAiB,CAAC;AAIzB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,+CAA+C;IAC/C,IAAI,EAAE,OAAO,CAAC;CACf;AAmHD;;;;;;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;AAiF/E;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AA0FzF,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,CAAC"}