@platforma-sdk/model 1.54.10 → 1.55.0

package/dist/render/internal.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"internal.cjs","sources":["../../src/render/internal.ts"],"sourcesContent":["import type { Optional } from \"utility-types\";\nimport type { Branded } from \"../branding\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\nimport type {\n  ArchiveFormat,\n  AnyFunction,\n  Option,\n  PColumn,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  ResultCollection,\n  ValueOrError,\n  DataInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"./accessor\";\n\nexport const StagingAccessorName = \"staging\";\nexport const MainAccessorName = \"main\";\n\nexport type AccessorHandle = Branded<string, \"AccessorHandle\">;\nexport type FutureHandle = Branded<string, \"FutureHandle\">;\n\nexport type PColumnDataUniversal<TreeEntry = TreeNodeAccessor> =\n  | TreeEntry\n  | DataInfo<TreeEntry>\n  | PColumnValues;\n\nexport interface GlobalCfgRenderCtxMethods<AHandle = AccessorHandle, FHandle = FutureHandle> {\n  //\n  // Root accessor creation\n  //\n\n  getAccessorHandleByName(name: string): AHandle | undefined;\n\n  //\n  // Basic resource accessor actions\n  //\n\n  resolveWithCommon(\n    handle: AHandle,\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): AHandle | undefined;\n\n  getResourceType(handle: AHandle): ResourceType;\n\n  getInputsLocked(handle: AHandle): boolean;\n\n  getOutputsLocked(handle: AHandle): boolean;\n\n  getIsReadyOrError(handle: AHandle): boolean;\n\n  getIsFinal(handle: AHandle): boolean;\n\n  getError(handle: AHandle): AHandle | undefined;\n\n  listInputFields(handle: AHandle): string[];\n\n  listOutputFields(handle: AHandle): string[];\n\n  listDynamicFields(handle: AHandle): string[];\n\n  getKeyValueBase64(handle: AHandle, key: string): string | undefined;\n\n  getKeyValueAsString(handle: AHandle, key: string): string | undefined;\n\n  getDataBase64(handle: AHandle): string | undefined;\n\n  getDataAsString(handle: AHandle): string | undefined;\n\n  /** If not final returns undefined */\n  parsePObjectCollection(\n    handle: AHandle,\n    errorOnUnknownField: boolean,\n    prefix: string,\n    ...resolvePath: string[]\n  ): Record<string, PObject<AHandle>> | undefined;\n\n  //\n  // Blob\n  //\n\n  getBlobContentAsBase64(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getBlobContentAsString(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getDownloadedBlobContentHandle(handle: AHandle): FHandle; // LocalBlobHandleAndSize | undefined;\n\n  getOnDemandBlobContentHandle(handle: AHandle): FHandle; // RemoteBlobHandleAndSize | undefined;\n\n  //\n  // Blobs to URLs\n  //\n\n  extractArchiveAndGetURL(handle: AHandle, format: ArchiveFormat): FHandle;\n\n  //\n  // Import progress\n  //\n\n  getImportProgress(handle: AHandle): FHandle; // ImportProgress;\n\n  //\n  // Logs\n  //\n\n  getLastLogs(handle: AHandle, nLines: number): FHandle; // string | undefined;\n\n  getProgressLog(handle: AHandle, patternToSearch: string): FHandle; // string | undefined;\n\n  getProgressLogWithInfo(handle: AHandle, patternToSearch: string): FHandle; // ProgressLogWithInfo | undefined;\n\n  getLogHandle(handle: AHandle): FHandle; // AnyLogHandle | undefined;\n\n  //\n  // Blocks\n  //\n\n  /** @deprecated at some point will stop working and will return dummy values */\n  getBlockLabel(blockId: string): string;\n\n  //\n  // Result Pool\n  //\n\n  getDataFromResultPool(): ResultCollection<PObject<AHandle>>;\n\n  getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<AHandle, Error>>, \"id\">\n  >;\n\n  getSpecsFromResultPool(): ResultCollection<PObjectSpec>;\n\n  getSpecFromResultPoolByRef(blockId: string, exportName: string): PObjectSpec | undefined;\n\n  getDataFromResultPoolByRef(blockId: string, exportName: string): PObject<AHandle> | undefined;\n\n  calculateOptions(predicate: PSpecPredicate): Option[];\n\n  //\n  // PFrame / PTable\n  //\n\n  createPFrame(def: PFrameDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PFrameHandle;\n\n  createPTable(def: PTableDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PTableHandle;\n\n  createPTableV2(\n    def: PTableDefV2<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>,\n  ): PTableHandle;\n\n  //\n  // Computable\n  //\n\n  getCurrentUnstableMarker(): string | undefined;\n\n  //\n  // Logging\n  //\n\n  logInfo(message: string): void;\n\n  logWarn(message: string): void;\n\n  logError(message: string): void;\n}\n\nexport const GlobalCfgRenderCtxFeatureFlags = {\n  explicitColumnsSupport: true as const,\n  inlineColumnsSupport: true as const,\n  activeArgs: true as const,\n  pTablePartitionFiltersSupport: true as const,\n  pFrameInSetFilterSupport: true as const,\n};\n\nexport interface GlobalCfgRenderCtx extends GlobalCfgRenderCtxMethods {\n  //\n  // State: Args, UI State, Active Args\n  //\n  // Old runtime injects these values as strings, new runtime injects them as functions\n  // that return strings, if block declares supportsLazyState flag.\n  // If function not called in lazy state API, then resulting output will not depend on these values,\n  // and thus will not be recalculated on corresponding state change.\n  //\n\n  readonly args: string | (() => string);\n  /** @deprecated Use `data` instead. Optional for backward compatibility - falls back to `data` if not injected. */\n  readonly uiState?: string | (() => string);\n  readonly data: string | (() => string);\n  readonly activeArgs: undefined | string | (() => string | undefined);\n\n  // Note: strings below are used because, anyway, using strings is the only way\n  // to get data inside the QuickJS context, as it is implemented now. With this\n  // approach deserialization can be lazily postponed until it is actually needed.\n  readonly callbackRegistry: Record<string, AnyFunction>;\n  readonly featureFlags?: typeof GlobalCfgRenderCtxFeatureFlags;\n}\n\nexport type FutureAwait = {\n  __awaited_futures__: FutureHandle[];\n};\n\nexport function isFutureAwait(obj: unknown): obj is FutureAwait {\n  return typeof obj === \"object\" && obj !== null && \"__awaited_futures__\" in obj;\n}\n\nfunction addAllFutureAwaits(set: Set<string>, visited: Set<unknown>, node: unknown) {\n  if (visited.has(node)) return;\n  visited.add(node);\n\n  const type = typeof node;\n  if (type === \"object\") {\n    if (isFutureAwait(node)) node.__awaited_futures__.forEach((a) => set.add(a));\n    else if (Array.isArray(node))\n      for (const nested of node) addAllFutureAwaits(set, visited, nested);\n    else\n      for (const [, nested] of Object.entries(node as object))\n        if (nested !== node) addAllFutureAwaits(set, visited, nested);\n  }\n}\n\nexport function getAllFutureAwaits(obj: unknown): Set<string> {\n  const set = new Set<string>();\n  addAllFutureAwaits(set, new Set(), obj);\n  return set;\n}\n"],"names":[],"mappings":";;AAwBO,MAAM,mBAAmB,GAAG;AAC5B,MAAM,gBAAgB,GAAG;AAuJzB,MAAM,8BAA8B,GAAG;AAC5C,IAAA,sBAAsB,EAAE,IAAa;AACrC,IAAA,oBAAoB,EAAE,IAAa;AACnC,IAAA,UAAU,EAAE,IAAa;AACzB,IAAA,6BAA6B,EAAE,IAAa;AAC5C,IAAA,wBAAwB,EAAE,IAAa;;AA8BnC,SAAU,aAAa,CAAC,GAAY,EAAA;AACxC,IAAA,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,qBAAqB,IAAI,GAAG;AAChF;AAEA,SAAS,kBAAkB,CAAC,GAAgB,EAAE,OAAqB,EAAE,IAAa,EAAA;AAChF,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE;AACvB,IAAA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;AAEjB,IAAA,MAAM,IAAI,GAAG,OAAO,IAAI;AACxB,IAAA,IAAI,IAAI,KAAK,QAAQ,EAAE;QACrB,IAAI,aAAa,CAAC,IAAI,CAAC;AAAE,YAAA,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,aAAA,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAC1B,KAAK,MAAM,MAAM,IAAI,IAAI;AAAE,gBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;;YAEnE,KAAK,MAAM,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAc,CAAC;gBACrD,IAAI,MAAM,KAAK,IAAI;AAAE,oBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;IACnE;AACF;AAEM,SAAU,kBAAkB,CAAC,GAAY,EAAA;AAC7C,IAAA,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU;IAC7B,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,CAAC;AACvC,IAAA,OAAO,GAAG;AACZ;;;;;;;;"}
+{"version":3,"file":"internal.cjs","sources":["../../src/render/internal.ts"],"sourcesContent":["import type { Optional } from \"utility-types\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\nimport type {\n  ArchiveFormat,\n  AnyFunction,\n  Option,\n  PColumn,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  ResultCollection,\n  ValueOrError,\n  DataInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"./accessor\";\n\nexport const StagingAccessorName = \"staging\";\nexport const MainAccessorName = \"main\";\n\nexport type AccessorHandle = Branded<string, \"AccessorHandle\">;\nexport type FutureHandle = Branded<string, \"FutureHandle\">;\n\nexport type PColumnDataUniversal<TreeEntry = TreeNodeAccessor> =\n  | TreeEntry\n  | DataInfo<TreeEntry>\n  | PColumnValues;\n\nexport interface GlobalCfgRenderCtxMethods<AHandle = AccessorHandle, FHandle = FutureHandle> {\n  //\n  // Root accessor creation\n  //\n\n  getAccessorHandleByName(name: string): AHandle | undefined;\n\n  //\n  // Basic resource accessor actions\n  //\n\n  resolveWithCommon(\n    handle: AHandle,\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): AHandle | undefined;\n\n  getResourceType(handle: AHandle): ResourceType;\n\n  getInputsLocked(handle: AHandle): boolean;\n\n  getOutputsLocked(handle: AHandle): boolean;\n\n  getIsReadyOrError(handle: AHandle): boolean;\n\n  getIsFinal(handle: AHandle): boolean;\n\n  getError(handle: AHandle): AHandle | undefined;\n\n  listInputFields(handle: AHandle): string[];\n\n  listOutputFields(handle: AHandle): string[];\n\n  listDynamicFields(handle: AHandle): string[];\n\n  getKeyValueBase64(handle: AHandle, key: string): string | undefined;\n\n  getKeyValueAsString(handle: AHandle, key: string): string | undefined;\n\n  getDataBase64(handle: AHandle): string | undefined;\n\n  getDataAsString(handle: AHandle): string | undefined;\n\n  /** If not final returns undefined */\n  parsePObjectCollection(\n    handle: AHandle,\n    errorOnUnknownField: boolean,\n    prefix: string,\n    ...resolvePath: string[]\n  ): Record<string, PObject<AHandle>> | undefined;\n\n  //\n  // Blob\n  //\n\n  getBlobContentAsBase64(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getBlobContentAsString(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getDownloadedBlobContentHandle(handle: AHandle): FHandle; // LocalBlobHandleAndSize | undefined;\n\n  getOnDemandBlobContentHandle(handle: AHandle): FHandle; // RemoteBlobHandleAndSize | undefined;\n\n  //\n  // Blobs to URLs\n  //\n\n  extractArchiveAndGetURL(handle: AHandle, format: ArchiveFormat): FHandle;\n\n  //\n  // Import progress\n  //\n\n  getImportProgress(handle: AHandle): FHandle; // ImportProgress;\n\n  //\n  // Logs\n  //\n\n  getLastLogs(handle: AHandle, nLines: number): FHandle; // string | undefined;\n\n  getProgressLog(handle: AHandle, patternToSearch: string): FHandle; // string | undefined;\n\n  getProgressLogWithInfo(handle: AHandle, patternToSearch: string): FHandle; // ProgressLogWithInfo | undefined;\n\n  getLogHandle(handle: AHandle): FHandle; // AnyLogHandle | undefined;\n\n  //\n  // Blocks\n  //\n\n  /** @deprecated at some point will stop working and will return dummy values */\n  getBlockLabel(blockId: string): string;\n\n  //\n  // Result Pool\n  //\n\n  getDataFromResultPool(): ResultCollection<PObject<AHandle>>;\n\n  getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<AHandle, Error>>, \"id\">\n  >;\n\n  getSpecsFromResultPool(): ResultCollection<PObjectSpec>;\n\n  getSpecFromResultPoolByRef(blockId: string, exportName: string): PObjectSpec | undefined;\n\n  getDataFromResultPoolByRef(blockId: string, exportName: string): PObject<AHandle> | undefined;\n\n  calculateOptions(predicate: PSpecPredicate): Option[];\n\n  //\n  // PFrame / PTable\n  //\n\n  createPFrame(def: PFrameDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PFrameHandle;\n\n  createPTable(def: PTableDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PTableHandle;\n\n  createPTableV2(\n    def: PTableDefV2<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>,\n  ): PTableHandle;\n\n  //\n  // Computable\n  //\n\n  getCurrentUnstableMarker(): string | undefined;\n\n  //\n  // Logging\n  //\n\n  logInfo(message: string): void;\n\n  logWarn(message: string): void;\n\n  logError(message: string): void;\n}\n\nexport const GlobalCfgRenderCtxFeatureFlags = {\n  explicitColumnsSupport: true as const,\n  inlineColumnsSupport: true as const,\n  activeArgs: true as const,\n  pTablePartitionFiltersSupport: true as const,\n  pFrameInSetFilterSupport: true as const,\n};\n\nexport interface GlobalCfgRenderCtx extends GlobalCfgRenderCtxMethods {\n  //\n  // State: Args, UI State, Active Args\n  //\n  // Old runtime injects these values as strings, new runtime injects them as functions\n  // that return strings, if block declares supportsLazyState flag.\n  // If function not called in lazy state API, then resulting output will not depend on these values,\n  // and thus will not be recalculated on corresponding state change.\n  //\n\n  readonly args: string | (() => string);\n  /** @deprecated Use `data` instead. Optional for backward compatibility - falls back to `data` if not injected. */\n  readonly uiState?: string | (() => string);\n  readonly data: string | (() => string);\n  readonly activeArgs: undefined | string | (() => string | undefined);\n\n  // Note: strings below are used because, anyway, using strings is the only way\n  // to get data inside the QuickJS context, as it is implemented now. With this\n  // approach deserialization can be lazily postponed until it is actually needed.\n  readonly callbackRegistry: Record<string, AnyFunction>;\n  readonly featureFlags?: typeof GlobalCfgRenderCtxFeatureFlags;\n}\n\nexport type FutureAwait = {\n  __awaited_futures__: FutureHandle[];\n};\n\nexport function isFutureAwait(obj: unknown): obj is FutureAwait {\n  return typeof obj === \"object\" && obj !== null && \"__awaited_futures__\" in obj;\n}\n\nfunction addAllFutureAwaits(set: Set<string>, visited: Set<unknown>, node: unknown) {\n  if (visited.has(node)) return;\n  visited.add(node);\n\n  const type = typeof node;\n  if (type === \"object\") {\n    if (isFutureAwait(node)) node.__awaited_futures__.forEach((a) => set.add(a));\n    else if (Array.isArray(node))\n      for (const nested of node) addAllFutureAwaits(set, visited, nested);\n    else\n      for (const [, nested] of Object.entries(node as object))\n        if (nested !== node) addAllFutureAwaits(set, visited, nested);\n  }\n}\n\nexport function getAllFutureAwaits(obj: unknown): Set<string> {\n  const set = new Set<string>();\n  addAllFutureAwaits(set, new Set(), obj);\n  return set;\n}\n"],"names":[],"mappings":";;AAwBO,MAAM,mBAAmB,GAAG;AAC5B,MAAM,gBAAgB,GAAG;AAuJzB,MAAM,8BAA8B,GAAG;AAC5C,IAAA,sBAAsB,EAAE,IAAa;AACrC,IAAA,oBAAoB,EAAE,IAAa;AACnC,IAAA,UAAU,EAAE,IAAa;AACzB,IAAA,6BAA6B,EAAE,IAAa;AAC5C,IAAA,wBAAwB,EAAE,IAAa;;AA8BnC,SAAU,aAAa,CAAC,GAAY,EAAA;AACxC,IAAA,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,qBAAqB,IAAI,GAAG;AAChF;AAEA,SAAS,kBAAkB,CAAC,GAAgB,EAAE,OAAqB,EAAE,IAAa,EAAA;AAChF,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE;AACvB,IAAA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;AAEjB,IAAA,MAAM,IAAI,GAAG,OAAO,IAAI;AACxB,IAAA,IAAI,IAAI,KAAK,QAAQ,EAAE;QACrB,IAAI,aAAa,CAAC,IAAI,CAAC;AAAE,YAAA,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,aAAA,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAC1B,KAAK,MAAM,MAAM,IAAI,IAAI;AAAE,gBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;;YAEnE,KAAK,MAAM,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAc,CAAC;gBACrD,IAAI,MAAM,KAAK,IAAI;AAAE,oBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;IACnE;AACF;AAEM,SAAU,kBAAkB,CAAC,GAAY,EAAA;AAC7C,IAAA,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU;IAC7B,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,CAAC;AACvC,IAAA,OAAO,GAAG;AACZ;;;;;;;;"}

package/dist/render/internal.d.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, AnyFunction, Option, PColumn, PColumnValues, PFrameDef, PFrameHandle, PObject, PObjectSpec, PSpecPredicate, PTableDef, PTableDefV2, PTableHandle, ResultCollection, ValueOrError, DataInfo, RangeBytes } from "@milaboratories/pl-model-common";
 import type { TreeNodeAccessor } from "./accessor";

package/dist/render/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/render/internal.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/render/internal.ts"],"names":[],"mappings":"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"}

package/dist/render/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sources":["../../src/render/internal.ts"],"sourcesContent":["import type { Optional } from \"utility-types\";\nimport type { Branded } from \"../branding\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\nimport type {\n  ArchiveFormat,\n  AnyFunction,\n  Option,\n  PColumn,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  ResultCollection,\n  ValueOrError,\n  DataInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"./accessor\";\n\nexport const StagingAccessorName = \"staging\";\nexport const MainAccessorName = \"main\";\n\nexport type AccessorHandle = Branded<string, \"AccessorHandle\">;\nexport type FutureHandle = Branded<string, \"FutureHandle\">;\n\nexport type PColumnDataUniversal<TreeEntry = TreeNodeAccessor> =\n  | TreeEntry\n  | DataInfo<TreeEntry>\n  | PColumnValues;\n\nexport interface GlobalCfgRenderCtxMethods<AHandle = AccessorHandle, FHandle = FutureHandle> {\n  //\n  // Root accessor creation\n  //\n\n  getAccessorHandleByName(name: string): AHandle | undefined;\n\n  //\n  // Basic resource accessor actions\n  //\n\n  resolveWithCommon(\n    handle: AHandle,\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): AHandle | undefined;\n\n  getResourceType(handle: AHandle): ResourceType;\n\n  getInputsLocked(handle: AHandle): boolean;\n\n  getOutputsLocked(handle: AHandle): boolean;\n\n  getIsReadyOrError(handle: AHandle): boolean;\n\n  getIsFinal(handle: AHandle): boolean;\n\n  getError(handle: AHandle): AHandle | undefined;\n\n  listInputFields(handle: AHandle): string[];\n\n  listOutputFields(handle: AHandle): string[];\n\n  listDynamicFields(handle: AHandle): string[];\n\n  getKeyValueBase64(handle: AHandle, key: string): string | undefined;\n\n  getKeyValueAsString(handle: AHandle, key: string): string | undefined;\n\n  getDataBase64(handle: AHandle): string | undefined;\n\n  getDataAsString(handle: AHandle): string | undefined;\n\n  /** If not final returns undefined */\n  parsePObjectCollection(\n    handle: AHandle,\n    errorOnUnknownField: boolean,\n    prefix: string,\n    ...resolvePath: string[]\n  ): Record<string, PObject<AHandle>> | undefined;\n\n  //\n  // Blob\n  //\n\n  getBlobContentAsBase64(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getBlobContentAsString(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getDownloadedBlobContentHandle(handle: AHandle): FHandle; // LocalBlobHandleAndSize | undefined;\n\n  getOnDemandBlobContentHandle(handle: AHandle): FHandle; // RemoteBlobHandleAndSize | undefined;\n\n  //\n  // Blobs to URLs\n  //\n\n  extractArchiveAndGetURL(handle: AHandle, format: ArchiveFormat): FHandle;\n\n  //\n  // Import progress\n  //\n\n  getImportProgress(handle: AHandle): FHandle; // ImportProgress;\n\n  //\n  // Logs\n  //\n\n  getLastLogs(handle: AHandle, nLines: number): FHandle; // string | undefined;\n\n  getProgressLog(handle: AHandle, patternToSearch: string): FHandle; // string | undefined;\n\n  getProgressLogWithInfo(handle: AHandle, patternToSearch: string): FHandle; // ProgressLogWithInfo | undefined;\n\n  getLogHandle(handle: AHandle): FHandle; // AnyLogHandle | undefined;\n\n  //\n  // Blocks\n  //\n\n  /** @deprecated at some point will stop working and will return dummy values */\n  getBlockLabel(blockId: string): string;\n\n  //\n  // Result Pool\n  //\n\n  getDataFromResultPool(): ResultCollection<PObject<AHandle>>;\n\n  getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<AHandle, Error>>, \"id\">\n  >;\n\n  getSpecsFromResultPool(): ResultCollection<PObjectSpec>;\n\n  getSpecFromResultPoolByRef(blockId: string, exportName: string): PObjectSpec | undefined;\n\n  getDataFromResultPoolByRef(blockId: string, exportName: string): PObject<AHandle> | undefined;\n\n  calculateOptions(predicate: PSpecPredicate): Option[];\n\n  //\n  // PFrame / PTable\n  //\n\n  createPFrame(def: PFrameDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PFrameHandle;\n\n  createPTable(def: PTableDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PTableHandle;\n\n  createPTableV2(\n    def: PTableDefV2<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>,\n  ): PTableHandle;\n\n  //\n  // Computable\n  //\n\n  getCurrentUnstableMarker(): string | undefined;\n\n  //\n  // Logging\n  //\n\n  logInfo(message: string): void;\n\n  logWarn(message: string): void;\n\n  logError(message: string): void;\n}\n\nexport const GlobalCfgRenderCtxFeatureFlags = {\n  explicitColumnsSupport: true as const,\n  inlineColumnsSupport: true as const,\n  activeArgs: true as const,\n  pTablePartitionFiltersSupport: true as const,\n  pFrameInSetFilterSupport: true as const,\n};\n\nexport interface GlobalCfgRenderCtx extends GlobalCfgRenderCtxMethods {\n  //\n  // State: Args, UI State, Active Args\n  //\n  // Old runtime injects these values as strings, new runtime injects them as functions\n  // that return strings, if block declares supportsLazyState flag.\n  // If function not called in lazy state API, then resulting output will not depend on these values,\n  // and thus will not be recalculated on corresponding state change.\n  //\n\n  readonly args: string | (() => string);\n  /** @deprecated Use `data` instead. Optional for backward compatibility - falls back to `data` if not injected. */\n  readonly uiState?: string | (() => string);\n  readonly data: string | (() => string);\n  readonly activeArgs: undefined | string | (() => string | undefined);\n\n  // Note: strings below are used because, anyway, using strings is the only way\n  // to get data inside the QuickJS context, as it is implemented now. With this\n  // approach deserialization can be lazily postponed until it is actually needed.\n  readonly callbackRegistry: Record<string, AnyFunction>;\n  readonly featureFlags?: typeof GlobalCfgRenderCtxFeatureFlags;\n}\n\nexport type FutureAwait = {\n  __awaited_futures__: FutureHandle[];\n};\n\nexport function isFutureAwait(obj: unknown): obj is FutureAwait {\n  return typeof obj === \"object\" && obj !== null && \"__awaited_futures__\" in obj;\n}\n\nfunction addAllFutureAwaits(set: Set<string>, visited: Set<unknown>, node: unknown) {\n  if (visited.has(node)) return;\n  visited.add(node);\n\n  const type = typeof node;\n  if (type === \"object\") {\n    if (isFutureAwait(node)) node.__awaited_futures__.forEach((a) => set.add(a));\n    else if (Array.isArray(node))\n      for (const nested of node) addAllFutureAwaits(set, visited, nested);\n    else\n      for (const [, nested] of Object.entries(node as object))\n        if (nested !== node) addAllFutureAwaits(set, visited, nested);\n  }\n}\n\nexport function getAllFutureAwaits(obj: unknown): Set<string> {\n  const set = new Set<string>();\n  addAllFutureAwaits(set, new Set(), obj);\n  return set;\n}\n"],"names":[],"mappings":"AAwBO,MAAM,mBAAmB,GAAG;AAC5B,MAAM,gBAAgB,GAAG;AAuJzB,MAAM,8BAA8B,GAAG;AAC5C,IAAA,sBAAsB,EAAE,IAAa;AACrC,IAAA,oBAAoB,EAAE,IAAa;AACnC,IAAA,UAAU,EAAE,IAAa;AACzB,IAAA,6BAA6B,EAAE,IAAa;AAC5C,IAAA,wBAAwB,EAAE,IAAa;;AA8BnC,SAAU,aAAa,CAAC,GAAY,EAAA;AACxC,IAAA,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,qBAAqB,IAAI,GAAG;AAChF;AAEA,SAAS,kBAAkB,CAAC,GAAgB,EAAE,OAAqB,EAAE,IAAa,EAAA;AAChF,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE;AACvB,IAAA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;AAEjB,IAAA,MAAM,IAAI,GAAG,OAAO,IAAI;AACxB,IAAA,IAAI,IAAI,KAAK,QAAQ,EAAE;QACrB,IAAI,aAAa,CAAC,IAAI,CAAC;AAAE,YAAA,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,aAAA,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAC1B,KAAK,MAAM,MAAM,IAAI,IAAI;AAAE,gBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;;YAEnE,KAAK,MAAM,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAc,CAAC;gBACrD,IAAI,MAAM,KAAK,IAAI;AAAE,oBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;IACnE;AACF;AAEM,SAAU,kBAAkB,CAAC,GAAY,EAAA;AAC7C,IAAA,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU;IAC7B,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,CAAC;AACvC,IAAA,OAAO,GAAG;AACZ;;;;"}
+{"version":3,"file":"internal.js","sources":["../../src/render/internal.ts"],"sourcesContent":["import type { Optional } from \"utility-types\";\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { CommonFieldTraverseOps, FieldTraversalStep, ResourceType } from \"./traversal_ops\";\nimport type {\n  ArchiveFormat,\n  AnyFunction,\n  Option,\n  PColumn,\n  PColumnValues,\n  PFrameDef,\n  PFrameHandle,\n  PObject,\n  PObjectSpec,\n  PSpecPredicate,\n  PTableDef,\n  PTableDefV2,\n  PTableHandle,\n  ResultCollection,\n  ValueOrError,\n  DataInfo,\n  RangeBytes,\n} from \"@milaboratories/pl-model-common\";\nimport type { TreeNodeAccessor } from \"./accessor\";\n\nexport const StagingAccessorName = \"staging\";\nexport const MainAccessorName = \"main\";\n\nexport type AccessorHandle = Branded<string, \"AccessorHandle\">;\nexport type FutureHandle = Branded<string, \"FutureHandle\">;\n\nexport type PColumnDataUniversal<TreeEntry = TreeNodeAccessor> =\n  | TreeEntry\n  | DataInfo<TreeEntry>\n  | PColumnValues;\n\nexport interface GlobalCfgRenderCtxMethods<AHandle = AccessorHandle, FHandle = FutureHandle> {\n  //\n  // Root accessor creation\n  //\n\n  getAccessorHandleByName(name: string): AHandle | undefined;\n\n  //\n  // Basic resource accessor actions\n  //\n\n  resolveWithCommon(\n    handle: AHandle,\n    commonOptions: CommonFieldTraverseOps,\n    ...steps: (FieldTraversalStep | string)[]\n  ): AHandle | undefined;\n\n  getResourceType(handle: AHandle): ResourceType;\n\n  getInputsLocked(handle: AHandle): boolean;\n\n  getOutputsLocked(handle: AHandle): boolean;\n\n  getIsReadyOrError(handle: AHandle): boolean;\n\n  getIsFinal(handle: AHandle): boolean;\n\n  getError(handle: AHandle): AHandle | undefined;\n\n  listInputFields(handle: AHandle): string[];\n\n  listOutputFields(handle: AHandle): string[];\n\n  listDynamicFields(handle: AHandle): string[];\n\n  getKeyValueBase64(handle: AHandle, key: string): string | undefined;\n\n  getKeyValueAsString(handle: AHandle, key: string): string | undefined;\n\n  getDataBase64(handle: AHandle): string | undefined;\n\n  getDataAsString(handle: AHandle): string | undefined;\n\n  /** If not final returns undefined */\n  parsePObjectCollection(\n    handle: AHandle,\n    errorOnUnknownField: boolean,\n    prefix: string,\n    ...resolvePath: string[]\n  ): Record<string, PObject<AHandle>> | undefined;\n\n  //\n  // Blob\n  //\n\n  getBlobContentAsBase64(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getBlobContentAsString(handle: AHandle, range?: RangeBytes): FHandle; // string | undefined\n\n  getDownloadedBlobContentHandle(handle: AHandle): FHandle; // LocalBlobHandleAndSize | undefined;\n\n  getOnDemandBlobContentHandle(handle: AHandle): FHandle; // RemoteBlobHandleAndSize | undefined;\n\n  //\n  // Blobs to URLs\n  //\n\n  extractArchiveAndGetURL(handle: AHandle, format: ArchiveFormat): FHandle;\n\n  //\n  // Import progress\n  //\n\n  getImportProgress(handle: AHandle): FHandle; // ImportProgress;\n\n  //\n  // Logs\n  //\n\n  getLastLogs(handle: AHandle, nLines: number): FHandle; // string | undefined;\n\n  getProgressLog(handle: AHandle, patternToSearch: string): FHandle; // string | undefined;\n\n  getProgressLogWithInfo(handle: AHandle, patternToSearch: string): FHandle; // ProgressLogWithInfo | undefined;\n\n  getLogHandle(handle: AHandle): FHandle; // AnyLogHandle | undefined;\n\n  //\n  // Blocks\n  //\n\n  /** @deprecated at some point will stop working and will return dummy values */\n  getBlockLabel(blockId: string): string;\n\n  //\n  // Result Pool\n  //\n\n  getDataFromResultPool(): ResultCollection<PObject<AHandle>>;\n\n  getDataWithErrorsFromResultPool(): ResultCollection<\n    Optional<PObject<ValueOrError<AHandle, Error>>, \"id\">\n  >;\n\n  getSpecsFromResultPool(): ResultCollection<PObjectSpec>;\n\n  getSpecFromResultPoolByRef(blockId: string, exportName: string): PObjectSpec | undefined;\n\n  getDataFromResultPoolByRef(blockId: string, exportName: string): PObject<AHandle> | undefined;\n\n  calculateOptions(predicate: PSpecPredicate): Option[];\n\n  //\n  // PFrame / PTable\n  //\n\n  createPFrame(def: PFrameDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PFrameHandle;\n\n  createPTable(def: PTableDef<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>): PTableHandle;\n\n  createPTableV2(\n    def: PTableDefV2<PColumn<AHandle | PColumnValues | DataInfo<AHandle>>>,\n  ): PTableHandle;\n\n  //\n  // Computable\n  //\n\n  getCurrentUnstableMarker(): string | undefined;\n\n  //\n  // Logging\n  //\n\n  logInfo(message: string): void;\n\n  logWarn(message: string): void;\n\n  logError(message: string): void;\n}\n\nexport const GlobalCfgRenderCtxFeatureFlags = {\n  explicitColumnsSupport: true as const,\n  inlineColumnsSupport: true as const,\n  activeArgs: true as const,\n  pTablePartitionFiltersSupport: true as const,\n  pFrameInSetFilterSupport: true as const,\n};\n\nexport interface GlobalCfgRenderCtx extends GlobalCfgRenderCtxMethods {\n  //\n  // State: Args, UI State, Active Args\n  //\n  // Old runtime injects these values as strings, new runtime injects them as functions\n  // that return strings, if block declares supportsLazyState flag.\n  // If function not called in lazy state API, then resulting output will not depend on these values,\n  // and thus will not be recalculated on corresponding state change.\n  //\n\n  readonly args: string | (() => string);\n  /** @deprecated Use `data` instead. Optional for backward compatibility - falls back to `data` if not injected. */\n  readonly uiState?: string | (() => string);\n  readonly data: string | (() => string);\n  readonly activeArgs: undefined | string | (() => string | undefined);\n\n  // Note: strings below are used because, anyway, using strings is the only way\n  // to get data inside the QuickJS context, as it is implemented now. With this\n  // approach deserialization can be lazily postponed until it is actually needed.\n  readonly callbackRegistry: Record<string, AnyFunction>;\n  readonly featureFlags?: typeof GlobalCfgRenderCtxFeatureFlags;\n}\n\nexport type FutureAwait = {\n  __awaited_futures__: FutureHandle[];\n};\n\nexport function isFutureAwait(obj: unknown): obj is FutureAwait {\n  return typeof obj === \"object\" && obj !== null && \"__awaited_futures__\" in obj;\n}\n\nfunction addAllFutureAwaits(set: Set<string>, visited: Set<unknown>, node: unknown) {\n  if (visited.has(node)) return;\n  visited.add(node);\n\n  const type = typeof node;\n  if (type === \"object\") {\n    if (isFutureAwait(node)) node.__awaited_futures__.forEach((a) => set.add(a));\n    else if (Array.isArray(node))\n      for (const nested of node) addAllFutureAwaits(set, visited, nested);\n    else\n      for (const [, nested] of Object.entries(node as object))\n        if (nested !== node) addAllFutureAwaits(set, visited, nested);\n  }\n}\n\nexport function getAllFutureAwaits(obj: unknown): Set<string> {\n  const set = new Set<string>();\n  addAllFutureAwaits(set, new Set(), obj);\n  return set;\n}\n"],"names":[],"mappings":"AAwBO,MAAM,mBAAmB,GAAG;AAC5B,MAAM,gBAAgB,GAAG;AAuJzB,MAAM,8BAA8B,GAAG;AAC5C,IAAA,sBAAsB,EAAE,IAAa;AACrC,IAAA,oBAAoB,EAAE,IAAa;AACnC,IAAA,UAAU,EAAE,IAAa;AACzB,IAAA,6BAA6B,EAAE,IAAa;AAC5C,IAAA,wBAAwB,EAAE,IAAa;;AA8BnC,SAAU,aAAa,CAAC,GAAY,EAAA;AACxC,IAAA,OAAO,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,qBAAqB,IAAI,GAAG;AAChF;AAEA,SAAS,kBAAkB,CAAC,GAAgB,EAAE,OAAqB,EAAE,IAAa,EAAA;AAChF,IAAA,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE;AACvB,IAAA,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;AAEjB,IAAA,MAAM,IAAI,GAAG,OAAO,IAAI;AACxB,IAAA,IAAI,IAAI,KAAK,QAAQ,EAAE;QACrB,IAAI,aAAa,CAAC,IAAI,CAAC;AAAE,YAAA,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AACvE,aAAA,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;YAC1B,KAAK,MAAM,MAAM,IAAI,IAAI;AAAE,gBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;;YAEnE,KAAK,MAAM,GAAG,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAc,CAAC;gBACrD,IAAI,MAAM,KAAK,IAAI;AAAE,oBAAA,kBAAkB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC;IACnE;AACF;AAEM,SAAU,kBAAkB,CAAC,GAAY,EAAA;AAC7C,IAAA,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU;IAC7B,kBAAkB,CAAC,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,CAAC;AACvC,IAAA,OAAO,GAAG;AACZ;;;;"}

package/dist/version.cjs

@@ -3,6 +3,10 @@
 var _package = require('./package.json.cjs');
 
 const PlatformaSDKVersion = _package.version;
+const CurrentSdkInfo = {
+    sdkVersion: PlatformaSDKVersion,
+};
 
+exports.CurrentSdkInfo = CurrentSdkInfo;
 exports.PlatformaSDKVersion = PlatformaSDKVersion;
 //# sourceMappingURL=version.cjs.map

package/dist/version.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["import { version } from \"../package.json\";\nexport const PlatformaSDKVersion = version;\n"],"names":["version"],"mappings":";;;;AACO,MAAM,mBAAmB,GAAGA;;;;"}
+{"version":3,"file":"version.cjs","sources":["../src/version.ts"],"sourcesContent":["import { version } from \"../package.json\";\nexport const PlatformaSDKVersion = version;\n\nexport type SdkInfo = {\n  readonly sdkVersion: string;\n};\n\nexport const CurrentSdkInfo: SdkInfo = {\n  sdkVersion: PlatformaSDKVersion,\n};\n"],"names":["version"],"mappings":";;;;AACO,MAAM,mBAAmB,GAAGA;AAM5B,MAAM,cAAc,GAAY;AACrC,IAAA,UAAU,EAAE,mBAAmB;;;;;;"}

package/dist/version.d.ts

@@ -1,2 +1,6 @@
 export declare const PlatformaSDKVersion: string;
+export type SdkInfo = {
+    readonly sdkVersion: string;
+};
+export declare const CurrentSdkInfo: SdkInfo;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,QAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,QAAU,CAAC;AAE3C,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,OAE5B,CAAC"}

package/dist/version.js

@@ -1,6 +1,9 @@
 import { version } from './package.json.js';
 
 const PlatformaSDKVersion = version;
+const CurrentSdkInfo = {
+    sdkVersion: PlatformaSDKVersion,
+};
 
-export { PlatformaSDKVersion };
+export { CurrentSdkInfo, PlatformaSDKVersion };
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["import { version } from \"../package.json\";\nexport const PlatformaSDKVersion = version;\n"],"names":[],"mappings":";;AACO,MAAM,mBAAmB,GAAG;;;;"}
+{"version":3,"file":"version.js","sources":["../src/version.ts"],"sourcesContent":["import { version } from \"../package.json\";\nexport const PlatformaSDKVersion = version;\n\nexport type SdkInfo = {\n  readonly sdkVersion: string;\n};\n\nexport const CurrentSdkInfo: SdkInfo = {\n  sdkVersion: PlatformaSDKVersion,\n};\n"],"names":[],"mappings":";;AACO,MAAM,mBAAmB,GAAG;AAM5B,MAAM,cAAc,GAAY;AACrC,IAAA,UAAU,EAAE,mBAAmB;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/model",
-  "version": "1.54.10",
+  "version": "1.55.0",
   "description": "Platforma.bio SDK / Block Model",
   "files": [
     "./dist/**/*",
@@ -24,10 +24,10 @@
     "fast-json-patch": "^3.1.1",
     "utility-types": "^3.11.0",
     "zod": "~3.23.8",
-    "@milaboratories/helpers": "1.13.4",
+    "@milaboratories/helpers": "1.13.5",
     "@milaboratories/pl-error-like": "1.12.8",
-    "@milaboratories/ptabler-expression-js": "1.1.20",
-    "@milaboratories/pl-model-common": "1.24.10"
+    "@milaboratories/pl-model-common": "1.25.0",
+    "@milaboratories/ptabler-expression-js": "1.1.22"
   },
   "devDependencies": {
     "@vitest/coverage-istanbul": "^4.0.16",
@@ -35,8 +35,8 @@
     "typescript": "~5.6.3",
     "vitest": "^4.0.16",
     "@milaboratories/ts-builder": "1.2.10",
-    "@milaboratories/build-configs": "1.4.4",
-    "@milaboratories/ts-configs": "1.2.1"
+    "@milaboratories/ts-configs": "1.2.1",
+    "@milaboratories/build-configs": "1.4.4"
   },
   "scripts": {
     "build": "ts-builder build --target node",

package/src/bconfig/normalization.ts

@@ -2,6 +2,7 @@ import { extractConfigGeneric, type BlockConfigContainer } from "@milaboratories
 import type { TypedConfigOrConfigLambda, TypedConfigOrString } from "./types";
 import { isConfigLambda } from "./types";
 import type { BlockConfig } from "./v3";
+import { BlockStorageFacadeHandles } from "../block_storage_facade";
 
 export function downgradeCfgOrLambda(data: TypedConfigOrConfigLambda): TypedConfigOrString;
 export function downgradeCfgOrLambda(
@@ -16,5 +17,11 @@ export function downgradeCfgOrLambda(
 }
 
 export function extractConfig(cfg: BlockConfigContainer): BlockConfig {
-  return extractConfigGeneric(cfg) as BlockConfig;
+  const config = extractConfigGeneric(cfg) as BlockConfig;
+  // Fill blockLifecycleCallbacks with defaults for V4 blocks that don't declare them
+  if (config.configVersion === 4 && Object.keys(config.blockLifecycleCallbacks).length === 0) {
+    (config as { blockLifecycleCallbacks: Record<string, unknown> }).blockLifecycleCallbacks =
+      BlockStorageFacadeHandles;
+  }
+  return config;
 }

package/src/block_api_v3.ts

@@ -12,16 +12,16 @@ import type { MutateStoragePayload } from "./block_storage";
 
 /** Defines methods to read and write current block data. */
 export interface BlockApiV3<
+  _Data = unknown,
   _Args = unknown,
   Outputs extends BlockOutputsBase = BlockOutputsBase,
-  _Data = unknown,
   Href extends `/${string}` = `/${string}`,
 > {
   /**
    * Use this method to retrieve block state during UI initialization. Then use
    * {@link onStateUpdates} method to subscribe for updates.
    * */
-  loadBlockState(): Promise<ResultOrError<ValueWithUTag<BlockStateV3<Outputs, _Data, Href>>>>;
+  loadBlockState(): Promise<ResultOrError<ValueWithUTag<BlockStateV3<_Data, Outputs, Href>>>>;
 
   /**
    * Get all json patches (rfc6902) that were applied to the block state.

package/src/block_migrations.test.ts

@@ -1,39 +1,5 @@
 import { describe, expect, it } from "vitest";
-import {
-  DataModelBuilder,
-  defaultRecover,
-  defineDataVersions,
-  makeDataVersioned,
-} from "./block_migrations";
-
-describe("defineDataVersions", () => {
-  it("throws on duplicate version values", () => {
-    expect(() =>
-      defineDataVersions({
-        V1: "v1",
-        V2: "v1", // duplicate!
-      }),
-    ).toThrow("Duplicate version values: v1");
-  });
-
-  it("throws on empty version values", () => {
-    expect(() =>
-      defineDataVersions({
-        V1: "v1",
-        V2: "", // empty!
-      }),
-    ).toThrow("Version values must be non-empty strings (empty: V2)");
-  });
-
-  it("allows unique version values", () => {
-    const versions = defineDataVersions({
-      V1: "v1",
-      V2: "v2",
-    });
-    expect(versions.V1).toBe("v1");
-    expect(versions.V2).toBe("v2");
-  });
-});
+import { DataModelBuilder, defaultRecover, makeDataVersioned } from "./block_migrations";
 
 describe("makeDataVersioned", () => {
   it("creates correct DataVersioned shape", () => {
@@ -44,19 +10,9 @@ describe("makeDataVersioned", () => {
 
 describe("DataModel migrations", () => {
   it("resets to initial data on unknown version", () => {
-    const Version = defineDataVersions({
-      V1: "v1",
-      V2: "v2",
-    });
-
-    type VersionedData = {
-      [Version.V1]: { count: number };
-      [Version.V2]: { count: number; label: string };
-    };
-
-    const dataModel = new DataModelBuilder<VersionedData>()
-      .from(Version.V1)
-      .migrate(Version.V2, (v1) => ({ ...v1, label: "" }))
+    const dataModel = new DataModelBuilder()
+      .from<{ count: number }>("v1")
+      .migrate<{ count: number; label: string }>("v2", (v1) => ({ ...v1, label: "" }))
       .init(() => ({ count: 0, label: "" }));
 
     const result = dataModel.migrate(makeDataVersioned("legacy", { count: 42 }));
@@ -65,141 +21,155 @@ describe("DataModel migrations", () => {
     expect(result.warning).toBe(`Unknown version 'legacy'`);
   });
 
-  it("uses recover() for unknown versions", () => {
-    const Version = defineDataVersions({
-      V1: "v1",
-      V2: "v2",
-    });
+  it("throws at build time on duplicate version key", () => {
+    expect(() =>
+      new DataModelBuilder()
+        .from<{ count: number }>("v1")
+        .migrate<{ count: number; label: string }>("v2", (v1) => ({ ...v1, label: "" }))
+        .migrate<{ count: number; label: string; description: string }>("v1", (v2) => ({
+          ...v2,
+          description: "",
+        })),
+    ).toThrow("Duplicate version 'v1' in migration chain");
+  });
 
-    type VersionedData = {
-      [Version.V1]: { count: number };
-      [Version.V2]: { count: number; label: string };
-    };
-
-    const dataModel = new DataModelBuilder<VersionedData>()
-      .from(Version.V1)
-      .migrate(Version.V2, (v1) => ({ ...v1, label: "" }))
-      .recover((version, data) => {
-        if (version === "legacy" && typeof data === "object" && data !== null && "count" in data) {
-          return { count: (data as { count: number }).count, label: "recovered" };
-        }
-        return defaultRecover(version, data);
+  it("returns initial data on migration failure", () => {
+    const dataModel = new DataModelBuilder()
+      .from<{ numbers: number[] }>("v1")
+      .migrate<{ numbers: number[]; label: string }>("v2", (v1) => {
+        if (v1.numbers.includes(666)) throw new Error("Forbidden number");
+        return { ...v1, label: "ok" };
       })
-      .init(() => ({ count: 0, label: "" }));
+      .init(() => ({ numbers: [], label: "" }));
 
-    const result = dataModel.migrate(makeDataVersioned("legacy", { count: 7 }));
+    const result = dataModel.migrate(makeDataVersioned("v1", { numbers: [666] }));
     expect(result.version).toBe("v2");
-    expect(result.data).toStrictEqual({ count: 7, label: "recovered" });
-    expect(result.warning).toBeUndefined();
+    expect(result.data).toStrictEqual({ numbers: [], label: "" });
+    expect(result.warning).toBe(`Migration v1→v2 failed: Forbidden number`);
   });
 
-  it("allows recover() to delegate to defaultRecover", () => {
-    const Version = defineDataVersions({
-      V1: "v1",
-      V2: "v2",
+  describe("recover()", () => {
+    it("recover() after from() — handles unknown version before any migrations run", () => {
+      const dataModel = new DataModelBuilder()
+        .from<{ count: number }>("v1")
+        .recover((version, data) => {
+          if (
+            version === "legacy" &&
+            typeof data === "object" &&
+            data !== null &&
+            "count" in data
+          ) {
+            return { count: (data as { count: number }).count };
+          }
+          return defaultRecover(version, data);
+        })
+        .migrate<{ count: number; label: string }>("v2", (v1) => ({ ...v1, label: "default" }))
+        .init(() => ({ count: 0, label: "" }));
+
+      // Legacy data is recovered as V1 then goes through v1→v2 migration
+      const result = dataModel.migrate(makeDataVersioned("legacy", { count: 5 }));
+      expect(result.version).toBe("v2");
+      expect(result.data).toStrictEqual({ count: 5, label: "default" });
+      expect(result.warning).toBeUndefined();
     });
 
-    type VersionedData = {
-      [Version.V1]: { count: number };
-      [Version.V2]: { count: number; label: string };
-    };
-
-    const dataModel = new DataModelBuilder<VersionedData>()
-      .from(Version.V1)
-      .migrate(Version.V2, (v1) => ({ ...v1, label: "" }))
-      .recover((version, data) => defaultRecover(version, data))
-      .init(() => ({ count: 0, label: "" }));
+    it("recover() between migrations — recovered data goes through subsequent migrations", () => {
+      type V2 = { count: number; label: string };
+      type V3 = { count: number; label: string; description: string };
+
+      const dataModel = new DataModelBuilder()
+        .from<{ count: number }>("v1")
+        .migrate<V2>("v2", (v1) => ({ ...v1, label: "" }))
+        .recover((version, data) => {
+          if (
+            version === "legacy" &&
+            typeof data === "object" &&
+            data !== null &&
+            "count" in data
+          ) {
+            return { count: (data as { count: number }).count, label: "recovered" };
+          }
+          return defaultRecover(version, data);
+        })
+        .migrate<V3>("v3", (v2) => ({ ...v2, description: "added" }))
+        .init(() => ({ count: 0, label: "", description: "" }));
+
+      const result = dataModel.migrate(makeDataVersioned("legacy", { count: 7 }));
+      expect(result.version).toBe("v3");
+      expect(result.data).toStrictEqual({ count: 7, label: "recovered", description: "added" });
+      expect(result.warning).toBeUndefined();
+    });
 
-    const result = dataModel.migrate(makeDataVersioned("legacy", { count: 7 }));
-    expect(result.version).toBe("v2");
-    expect(result.data).toStrictEqual({ count: 0, label: "" });
-    expect(result.warning).toBe(`Unknown version 'legacy'`);
-  });
+    it("recover() at the end of chain — recovered data is the final type", () => {
+      type V2 = { count: number; label: string };
+
+      const dataModel = new DataModelBuilder()
+        .from<{ count: number }>("v1")
+        .migrate<V2>("v2", (v1) => ({ ...v1, label: "" }))
+        .recover((version, data) => {
+          if (
+            version === "legacy" &&
+            typeof data === "object" &&
+            data !== null &&
+            "count" in data
+          ) {
+            return { count: (data as { count: number }).count, label: "recovered" };
+          }
+          return defaultRecover(version, data);
+        })
+        .init(() => ({ count: 0, label: "" }));
+
+      const result = dataModel.migrate(makeDataVersioned("legacy", { count: 9 }));
+      expect(result.version).toBe("v2");
+      expect(result.data).toStrictEqual({ count: 9, label: "recovered" });
+      expect(result.warning).toBeUndefined();
+    });
 
-  it("returns initial data on migration failure", () => {
-    const Version = defineDataVersions({
-      V1: "v1",
-      V2: "v2",
+    it("recover() delegates to defaultRecover for truly unknown versions", () => {
+      const dataModel = new DataModelBuilder()
+        .from<{ count: number }>("v1")
+        .migrate<{ count: number; label: string }>("v2", (v1) => ({ ...v1, label: "" }))
+        .recover((version, data) => defaultRecover(version, data))
+        .init(() => ({ count: 0, label: "" }));
+
+      const result = dataModel.migrate(makeDataVersioned("unknown", { count: 7 }));
+      expect(result.version).toBe("v2");
+      expect(result.data).toStrictEqual({ count: 0, label: "" });
+      expect(result.warning).toBe(`Unknown version 'unknown'`);
     });
 
-    type VersionedData = {
-      [Version.V1]: { numbers: number[] };
-      [Version.V2]: { numbers: number[]; label: string };
-    };
-
-    const dataModel = new DataModelBuilder<VersionedData>()
-      .from(Version.V1)
-      .migrate(Version.V2, (v1) => {
-        if (v1.numbers.includes(666)) {
-          throw new Error("Forbidden number");
-        }
-        return { ...v1, label: "ok" };
-      })
-      .init(() => ({ numbers: [], label: "" }));
+    it("migration failure after recover() resets to initial data", () => {
+      type V2 = { count: number; label: string };
+      type V3 = { count: number; label: string; description: string };
+
+      const dataModel = new DataModelBuilder()
+        .from<{ count: number }>("v1")
+        .migrate<V2>("v2", (v1) => ({ ...v1, label: "" }))
+        .recover((version, data) => {
+          if (
+            version === "legacy" &&
+            typeof data === "object" &&
+            data !== null &&
+            "count" in data
+          ) {
+            return { count: (data as { count: number }).count, label: "recovered" };
+          }
+          return defaultRecover(version, data);
+        })
+        .migrate<V3>("v3", (_v2) => {
+          throw new Error("v3 failed");
+        })
+        .init(() => ({ count: 0, label: "", description: "" }));
+
+      const result = dataModel.migrate(makeDataVersioned("legacy", { count: 7 }));
+      expect(result.version).toBe("v3");
+      expect(result.data).toStrictEqual({ count: 0, label: "", description: "" });
+      expect(result.warning).toBe("Migration v2→v3 failed: v3 failed");
+    });
 
-    const result = dataModel.migrate(makeDataVersioned("v1", { numbers: [666] }));
-    expect(result.version).toBe("v2");
-    expect(result.data).toStrictEqual({ numbers: [], label: "" });
-    expect(result.warning).toBe(`Migration v1→v2 failed: Forbidden number`);
+    it("recover() cannot be called twice — enforced by type (no recover() on WithRecover)", () => {
+      // This is a compile-time-only check — WithRecover has no recover() method.
+      // Verified by the absence of recover() in DataModelMigrationChainWithRecover.
+    });
   });
 });
-
-function _compileTimeTypeChecks() {
-  const Version = defineDataVersions({
-    V1: "v1",
-    V2: "v2",
-  });
-
-  type VersionedData = {
-    [Version.V1]: { count: number };
-    [Version.V2]: { count: number; label: string };
-  };
-
-  // Valid: complete migration chain
-  new DataModelBuilder<VersionedData>()
-    .from(Version.V1)
-    .migrate(Version.V2, (v1) => ({ ...v1, label: "" }))
-    .init(() => ({ count: 0, label: "" }));
-
-  // Valid: with recover()
-  new DataModelBuilder<VersionedData>()
-    .from(Version.V1)
-    .migrate(Version.V2, (v1) => ({ ...v1, label: "" }))
-    .recover((version, data) => defaultRecover(version, data))
-    .init(() => ({ count: 0, label: "" }));
-
-  new DataModelBuilder<VersionedData>()
-    // @ts-expect-error invalid initial version key
-    .from("v3");
-
-  new DataModelBuilder<VersionedData>()
-    .from(Version.V1)
-    // @ts-expect-error invalid migration target key
-    .migrate("v3", (v1) => ({ ...v1, label: "" }));
-
-  new DataModelBuilder<VersionedData>()
-    .from(Version.V1)
-    // @ts-expect-error migration return type must match target version
-    .migrate(Version.V2, (v1) => ({ ...v1, invalid: true }));
-
-  // Incomplete migration chain - V2 not covered
-  // This errors at compile-time with the `this` parameter constraint:
-  // "The 'this' context of type 'DataModelMigrationChain<..., "v1", "v2">' is not assignable to method's 'this' of type 'DataModelMigrationChain<..., "v1", never>'"
-  // Note: @ts-expect-error doesn't work reliably in unused functions
-  // new DataModelBuilder<VersionedData>()
-  //   .from(Version.V1)
-  //   .init(() => ({ count: 0 }));
-
-  new DataModelBuilder<VersionedData>()
-    .from(Version.V1)
-    .migrate(Version.V2, (v1) => ({ ...v1, label: "" }))
-    .recover((version, data) => defaultRecover(version, data))
-    // @ts-expect-error recover() returns builder without recover() method - cannot call twice (only init() available)
-    .recover((version, data) => defaultRecover(version, data));
-
-  new DataModelBuilder<VersionedData>()
-    .from(Version.V1)
-    .recover((version, data) => defaultRecover(version, data))
-    // @ts-expect-error recover() returns builder without migrate() method (only init() available)
-    .migrate(Version.V2, (v1) => ({ ...v1, label: "" }));
-}