@platforma-sdk/model 1.48.14 → 1.50.0

package/dist/raw_globals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raw_globals.d.ts","sourceRoot":"","sources":["../src/raw_globals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAGrE,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlE,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED,wBAAgB,uBAAuB,CACrC,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC,EAC/F,OAAO,GAAG,OAAO,EACjB,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,KACrC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAE3C;AAED,wFAAwF"}
+{"version":3,"file":"raw_globals.d.ts","sourceRoot":"","sources":["../src/raw_globals.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAGxE,OAAO,KAAK,EAAE,SAAS,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGlE,wBAAgB,sBAAsB,IAAI,mBAAmB,CAE5D;AAED,wBAAgB,uBAAuB,CACrC,IAAI,GAAG,OAAO,EACd,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAC,EACrG,OAAO,GAAG,OAAO,EACjB,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,KACrC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAE3C;AAED,wFAAwF"}

package/dist/raw_globals.js.map

@@ -1 +1 @@
-{"version":3,"file":"raw_globals.js","sources":["../src/raw_globals.ts"],"sourcesContent":["import type { ValueOrErrors } from '@milaboratories/pl-model-common';\nimport {} from './global';\nimport { getPlatformaInstance } from './internal';\nimport type { Platforma, PlatformaApiVersion } from './platforma';\nimport { PlatformaSDKVersion } from './version';\n\nexport function getPlatformaApiVersion(): PlatformaApiVersion {\n  return platformaApiVersion ?? 1; // undefined means 1 for backward compatibility\n}\n\nexport function getRawPlatformaInstance<\n  Args = unknown,\n  Outputs extends Record<string, ValueOrErrors<unknown>> = Record<string, ValueOrErrors<unknown>>,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(): Platforma<Args, Outputs, UiState, Href> {\n  return getPlatformaInstance<Args, Outputs, UiState, Href>({ sdkVersion: PlatformaSDKVersion, apiVersion: platformaApiVersion });\n}\n\n/** Returns a global platforma instance or a provided fallback if it's not available. */\n// export function getPlatformaOrDefault<\n//   Args = unknown,\n//   Outputs extends Record<string, ValueOrErrors<unknown>> = Record<string, ValueOrErrors<unknown>>,\n//   UiState = unknown,\n//   Href extends `/${string}` = `/${string}`,\n// >(): PlatformaV1<Args, Outputs, UiState, Href> | PlatformaV2<Args, Outputs, UiState, Href> {\n//   try {\n//     return getRawPlatformaInstance<Args, Outputs, UiState, Href>();\n//   } catch {\n//     return platforma;\n//   }\n// }\n"],"names":[],"mappings":";;;SAMgB,sBAAsB,GAAA;AACpC,IAAA,OAAO,mBAAmB,IAAI,CAAC,CAAC;AAClC;SAEgB,uBAAuB,GAAA;AAMrC,IAAA,OAAO,oBAAoB,CAA+B,EAAE,UAAU,EAAE,mBAAmB,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AACjI;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;;"}
+{"version":3,"file":"raw_globals.js","sources":["../src/raw_globals.ts"],"sourcesContent":["import type { OutputWithStatus } from '@milaboratories/pl-model-common';\nimport {} from './global';\nimport { getPlatformaInstance } from './internal';\nimport type { Platforma, PlatformaApiVersion } from './platforma';\nimport { PlatformaSDKVersion } from './version';\n\nexport function getPlatformaApiVersion(): PlatformaApiVersion {\n  return platformaApiVersion ?? 1; // undefined means 1 for backward compatibility\n}\n\nexport function getRawPlatformaInstance<\n  Args = unknown,\n  Outputs extends Record<string, OutputWithStatus<unknown>> = Record<string, OutputWithStatus<unknown>>,\n  UiState = unknown,\n  Href extends `/${string}` = `/${string}`,\n>(): Platforma<Args, Outputs, UiState, Href> {\n  return getPlatformaInstance<Args, Outputs, UiState, Href>({ sdkVersion: PlatformaSDKVersion, apiVersion: platformaApiVersion });\n}\n\n/** Returns a global platforma instance or a provided fallback if it's not available. */\n// export function getPlatformaOrDefault<\n//   Args = unknown,\n//   Outputs extends Record<string, ValueOrErrors<unknown>> = Record<string, ValueOrErrors<unknown>>,\n//   UiState = unknown,\n//   Href extends `/${string}` = `/${string}`,\n// >(): PlatformaV1<Args, Outputs, UiState, Href> | PlatformaV2<Args, Outputs, UiState, Href> {\n//   try {\n//     return getRawPlatformaInstance<Args, Outputs, UiState, Href>();\n//   } catch {\n//     return platforma;\n//   }\n// }\n"],"names":[],"mappings":";;;SAMgB,sBAAsB,GAAA;AACpC,IAAA,OAAO,mBAAmB,IAAI,CAAC,CAAC;AAClC;SAEgB,uBAAuB,GAAA;AAMrC,IAAA,OAAO,oBAAoB,CAA+B,EAAE,UAAU,EAAE,mBAAmB,EAAE,UAAU,EAAE,mBAAmB,EAAE,CAAC;AACjI;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@platforma-sdk/model",
-  "version": "1.48.14",
+  "version": "1.50.0",
   "description": "Platforma.bio SDK / Block Model",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -23,20 +23,20 @@
     "canonicalize": "~2.1.0",
     "es-toolkit": "^1.39.10",
     "zod": "~3.23.8",
+    "@milaboratories/ptabler-expression-js": "1.1.9",
     "@milaboratories/pl-error-like": "1.12.5",
-    "@milaboratories/pl-model-common": "1.21.10",
-    "@milaboratories/ptabler-expression-js": "1.1.7"
+    "@milaboratories/pl-model-common": "1.23.0"
   },
   "devDependencies": {
     "typescript": "~5.6.3",
     "vitest": "^4.0.16",
     "@vitest/coverage-istanbul": "^4.0.16",
     "fast-json-patch": "^3.1.1",
-    "@milaboratories/build-configs": "1.2.1",
-    "@milaboratories/helpers": "1.12.1",
-    "@milaboratories/ts-builder": "1.2.1",
+    "@milaboratories/eslint-config": "1.0.5",
+    "@milaboratories/helpers": "1.13.0",
     "@milaboratories/ts-configs": "1.2.0",
-    "@milaboratories/eslint-config": "1.0.5"
+    "@milaboratories/ts-builder": "1.2.1",
+    "@milaboratories/build-configs": "1.2.1"
   },
   "scripts": {
     "type-check": "ts-builder types --target node",

package/src/bconfig/lambdas.ts

@@ -29,13 +29,22 @@ export type ConfigRenderLambdaFlags = {
    * nobody is actively monitoring rendered values. Like file upload progress, that triggers upload itself.
    * */
   isActive?: boolean;
+
+  /**
+   * If true, result will be wrapped with additional status information,
+   * such as stability status and explicit error
+   */
+  withStatus?: boolean;
 };
 
 /** Creates branded Cfg type */
-export interface ConfigRenderLambda<_Return = unknown> extends ConfigRenderLambdaFlags {
+export interface ConfigRenderLambda<Return = unknown> extends ConfigRenderLambdaFlags {
   /** Type marker */
   __renderLambda: true;
 
+  /** Phantom property for type inference. Never set at runtime. */
+  __phantomReturn?: Return;
+
   /** Reference to a callback registered inside the model code. */
   handle: string;
 }

package/src/block_state_util.ts

@@ -1,4 +1,4 @@
-import type { BlockOutputsBase, ValueOrErrors } from '@milaboratories/pl-model-common';
+import type { BlockOutputsBase, OutputWithStatus } from '@milaboratories/pl-model-common';
 import type { ErrorLike } from '@milaboratories/pl-error-like';
 
 export class OutputError extends Error {
@@ -10,12 +10,12 @@ export class OutputError extends Error {
   }
 }
 
-export function readOutput<T>(outputValue: ValueOrErrors<T>): T {
+export function readOutput<T>(outputValue: OutputWithStatus<T>): T {
   if (!outputValue.ok) throw new OutputError(outputValue.errors, outputValue.moreErrors);
   return outputValue.value;
 }
 
-type ExtractValueType<V extends ValueOrErrors<unknown>> = Extract<V, { ok: true }>['value'];
+type ExtractValueType<V extends OutputWithStatus<unknown>> = Extract<V, { ok: true }>['value'];
 type SimpleOutputs<Outputs extends BlockOutputsBase> = {
   [Key in keyof Outputs]: ExtractValueType<Outputs[Key]>;
 };

package/src/builder.ts

@@ -1,4 +1,4 @@
-import type { BlockRenderingMode, BlockSection, ValueOrErrors, AnyFunction, PlRef, BlockCodeKnownFeatureFlags, BlockConfigContainer } from '@milaboratories/pl-model-common';
+import type { BlockRenderingMode, BlockSection, AnyFunction, PlRef, BlockCodeKnownFeatureFlags, BlockConfigContainer, OutputWithStatus } from '@milaboratories/pl-model-common';
 import type { Checked, ConfigResult, TypedConfig } from './config';
 import { getImmediate } from './config';
 import { getPlatformaInstance, isInUI, tryRegisterCallback } from './internal';
@@ -17,6 +17,7 @@ import type {
 } from './bconfig';
 import {
   downgradeCfgOrLambda,
+  isConfigLambda,
 } from './bconfig';
 
 type SectionsExpectedType = readonly BlockSection[];
@@ -57,22 +58,28 @@ export class BlockModel<
   Href extends `/${string}` = '/',
 > {
   private constructor(
-    private readonly _renderingMode: BlockRenderingMode,
-    private readonly _initialArgs: Args | undefined,
-    private readonly _initialUiState: UiState,
-    private readonly _outputs: OutputsCfg,
-    private readonly _inputsValid: TypedConfigOrConfigLambda,
-    private readonly _sections: TypedConfigOrConfigLambda,
-    private readonly _title: ConfigRenderLambda | undefined,
-    private readonly _enrichmentTargets: ConfigRenderLambda | undefined,
-    private readonly _featureFlags: BlockCodeKnownFeatureFlags,
+    private config: {
+      readonly renderingMode: BlockRenderingMode;
+      readonly initialArgs?: Args;
+      readonly initialUiState: UiState;
+      readonly outputs: OutputsCfg;
+      readonly inputsValid: TypedConfigOrConfigLambda;
+      readonly sections: TypedConfigOrConfigLambda;
+      readonly title?: ConfigRenderLambda;
+      readonly subtitle?: ConfigRenderLambda;
+      readonly tags?: ConfigRenderLambda;
+      readonly enrichmentTargets?: ConfigRenderLambda;
+      readonly featureFlags: BlockCodeKnownFeatureFlags;
+    },
   ) {}
 
-  public static readonly INITIAL_BLOCK_FEATURE_FLAGS: BlockCodeKnownFeatureFlags = {
-    supportsLazyState: true,
-    requiresUIAPIVersion: 1,
-    requiresModelAPIVersion: 1,
-  };
+  public static get INITIAL_BLOCK_FEATURE_FLAGS(): BlockCodeKnownFeatureFlags {
+    return {
+      supportsLazyState: true,
+      requiresUIAPIVersion: 1,
+      requiresModelAPIVersion: 1,
+    };
+  }
 
   /** Initiates configuration builder */
   public static create(renderingMode: BlockRenderingMode): BlockModel<NoOb, {}, NoOb>;
@@ -89,17 +96,14 @@ export class BlockModel<
    */
   public static create<Args>(): BlockModel<Args, {}, NoOb>;
   public static create(renderingMode: BlockRenderingMode = 'Heavy'): BlockModel<NoOb, {}, NoOb> {
-    return new BlockModel<NoOb, {}, NoOb>(
+    return new BlockModel<NoOb, {}, NoOb>({
       renderingMode,
-      undefined,
-      {},
-      {},
-      getImmediate(true),
-      getImmediate([]),
-      undefined,
-      undefined,
-      { ...BlockModel.INITIAL_BLOCK_FEATURE_FLAGS },
-    );
+      initialUiState: {},
+      outputs: {},
+      inputsValid: getImmediate(true),
+      sections: getImmediate([]),
+      featureFlags: BlockModel.INITIAL_BLOCK_FEATURE_FLAGS,
+    });
   }
 
   /**
@@ -114,6 +118,24 @@ export class BlockModel<
     key: Key,
     cfg: Cfg
   ): BlockModel<Args, OutputsCfg & { [K in Key]: Cfg }, UiState, Href>;
+  /**
+   * Add output cell wrapped with additional status information to the configuration
+   *
+   * @param key output cell name, that can be later used to retrieve the rendered value
+   * @param rf  callback calculating output value using context, that allows to access
+   *            workflows outputs and interact with platforma drivers
+   * @param flags additional flags that may alter lambda rendering procedure
+   * */
+  public output<const Key extends string, const RF extends RenderFunction<Args, UiState>>(
+    key: Key,
+    rf: RF,
+    flags: ConfigRenderLambdaFlags & { withStatus: true }
+  ): BlockModel<
+    Args,
+    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & { withStatus: true } },
+    UiState,
+    Href
+  >;
   /**
    * Add output cell to the configuration
    *
@@ -140,54 +162,52 @@ export class BlockModel<
     if (typeof cfgOrRf === 'function') {
       const handle = `output#${key}`;
       tryRegisterCallback(handle, () => cfgOrRf(new RenderCtx()));
-      return new BlockModel(
-        this._renderingMode,
-        this._initialArgs,
-        this._initialUiState,
-        {
-          ...this._outputs,
+      return new BlockModel({
+        ...this.config,
+        outputs: {
+          ...this.config.outputs,
           [key]: {
             __renderLambda: true,
             handle,
             ...flags,
-          } satisfies ConfigRenderLambda,
+          },
         },
-        this._inputsValid,
-        this._sections,
-        this._title,
-        this._enrichmentTargets,
-        this._featureFlags,
-      );
-    } else
-      return new BlockModel(
-        this._renderingMode,
-        this._initialArgs,
-        this._initialUiState,
-        {
-          ...this._outputs,
+      });
+    } else {
+      return new BlockModel({
+        ...this.config,
+        outputs: {
+          ...this.config.outputs,
           [key]: cfgOrRf,
         },
-        this._inputsValid,
-        this._sections,
-        this._title,
-        this._enrichmentTargets,
-        this._featureFlags,
-      );
+      });
+    }
   }
 
   /** Shortcut for {@link output} with retentive flag set to true. */
   public retentiveOutput<const Key extends string, const RF extends RenderFunction<Args, UiState>>(
     key: Key,
     rf: RF,
-  ): BlockModel<
-      Args,
-    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> },
-    UiState,
-    Href
-    > {
+  ) {
     return this.output(key, rf, { retentive: true });
   }
 
+  /** Shortcut for {@link output} with withStatus flag set to true. */
+  public outputWithStatus<const Key extends string, const RF extends RenderFunction<Args, UiState>>(
+    key: Key,
+    rf: RF,
+  ) {
+    return this.output(key, rf, { withStatus: true });
+  }
+
+  /** Shortcut for {@link output} with retentive and withStatus flags set to true. */
+  public retentiveOutputWithStatus<const Key extends string, const RF extends RenderFunction<Args, UiState>>(
+    key: Key,
+    rf: RF,
+  ) {
+    return this.output(key, rf, { retentive: true, withStatus: true });
+  }
+
   /** Sets custom configuration predicate on the block args at which block can be executed
    * @deprecated use lambda-based API */
   public argsValid<Cfg extends TypedConfig>(
@@ -202,32 +222,19 @@ export class BlockModel<
   ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {
     if (typeof cfgOrRf === 'function') {
       tryRegisterCallback('inputsValid', () => cfgOrRf(new RenderCtx()));
-      return new BlockModel<Args, OutputsCfg, UiState>(
-        this._renderingMode,
-        this._initialArgs,
-        this._initialUiState,
-        this._outputs,
-        {
+      return new BlockModel<Args, OutputsCfg, UiState>({
+        ...this.config,
+        inputsValid: {
           __renderLambda: true,
           handle: 'inputsValid',
-        } satisfies ConfigRenderLambda,
-        this._sections,
-        this._title,
-        this._enrichmentTargets,
-        this._featureFlags,
-      );
-    } else
-      return new BlockModel<Args, OutputsCfg, UiState>(
-        this._renderingMode,
-        this._initialArgs,
-        this._initialUiState,
-        this._outputs,
-        cfgOrRf,
-        this._sections,
-        this._title,
-        this._enrichmentTargets,
-        this._featureFlags,
-      );
+        },
+      });
+    } else {
+      return new BlockModel<Args, OutputsCfg, UiState>({
+        ...this.config,
+        inputsValid: cfgOrRf,
+      });
+    }
   }
 
   /** Sets the config to generate list of section in the left block overviews panel
@@ -255,29 +262,19 @@ export class BlockModel<
       return this.sections(getImmediate(arrOrCfgOrRf));
     } else if (typeof arrOrCfgOrRf === 'function') {
       tryRegisterCallback('sections', () => arrOrCfgOrRf(new RenderCtx()));
-      return new BlockModel<Args, OutputsCfg, UiState>(
-        this._renderingMode,
-        this._initialArgs,
-        this._initialUiState,
-        this._outputs,
-        this._inputsValid,
-        { __renderLambda: true, handle: 'sections' } as ConfigRenderLambda,
-        this._title,
-        this._enrichmentTargets,
-        this._featureFlags,
-      );
-    } else
-      return new BlockModel<Args, OutputsCfg, UiState>(
-        this._renderingMode,
-        this._initialArgs,
-        this._initialUiState,
-        this._outputs,
-        this._inputsValid,
-        arrOrCfgOrRf as TypedConfig,
-        this._title,
-        this._enrichmentTargets,
-        this._featureFlags,
-      );
+      return new BlockModel<Args, OutputsCfg, UiState>({
+        ...this.config,
+        sections: {
+          __renderLambda: true,
+          handle: 'sections',
+        },
+      });
+    } else {
+      return new BlockModel<Args, OutputsCfg, UiState>({
+        ...this.config,
+        sections: arrOrCfgOrRf as TypedConfig,
+      });
+    }
   }
 
   /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */
@@ -285,17 +282,39 @@ export class BlockModel<
     rf: RenderFunction<Args, UiState, string>,
   ): BlockModel<Args, OutputsCfg, UiState, Href> {
     tryRegisterCallback('title', () => rf(new RenderCtx()));
-    return new BlockModel<Args, OutputsCfg, UiState, Href>(
-      this._renderingMode,
-      this._initialArgs,
-      this._initialUiState,
-      this._outputs,
-      this._inputsValid,
-      this._sections,
-      { __renderLambda: true, handle: 'title' } as ConfigRenderLambda,
-      this._enrichmentTargets,
-      this._featureFlags,
-    );
+    return new BlockModel<Args, OutputsCfg, UiState, Href>({
+      ...this.config,
+      title: {
+        __renderLambda: true,
+        handle: 'title',
+      },
+    });
+  }
+
+  public subtitle(
+    rf: RenderFunction<Args, UiState, string>,
+  ): BlockModel<Args, OutputsCfg, UiState, Href> {
+    tryRegisterCallback('subtitle', () => rf(new RenderCtx()));
+    return new BlockModel<Args, OutputsCfg, UiState, Href>({
+      ...this.config,
+      subtitle: {
+        __renderLambda: true,
+        handle: 'subtitle',
+      },
+    });
+  }
+
+  public tags(
+    rf: RenderFunction<Args, UiState, string[]>,
+  ): BlockModel<Args, OutputsCfg, UiState, Href> {
+    tryRegisterCallback('tags', () => rf(new RenderCtx()));
+    return new BlockModel<Args, OutputsCfg, UiState, Href>({
+      ...this.config,
+      tags: {
+        __renderLambda: true,
+        handle: 'tags',
+      },
+    });
   }
 
   /**
@@ -303,62 +322,34 @@ export class BlockModel<
    * @deprecated use {@link withArgs}
    * */
   public initialArgs(value: Args): BlockModel<Args, OutputsCfg, UiState, Href> {
-    return new BlockModel<Args, OutputsCfg, UiState, Href>(
-      this._renderingMode,
-      value,
-      this._initialUiState,
-      this._outputs,
-      this._inputsValid,
-      this._sections,
-      this._title,
-      this._enrichmentTargets,
-      this._featureFlags,
-    );
+    return this.withArgs(value);
   }
 
   /** Sets initial args for the block, this value must be specified. */
-  public withArgs<Args>(initialValue: Args): BlockModel<Args, OutputsCfg, UiState, Href> {
-    return new BlockModel<Args, OutputsCfg, UiState, Href>(
-      this._renderingMode,
-      initialValue,
-      this._initialUiState,
-      this._outputs,
-      this._inputsValid,
-      this._sections,
-      this._title,
-      this._enrichmentTargets,
-      this._featureFlags,
-    );
+  public withArgs<Args>(initialArgs: Args): BlockModel<Args, OutputsCfg, UiState, Href> {
+    return new BlockModel<Args, OutputsCfg, UiState, Href>({
+      ...this.config,
+      initialArgs,
+    });
   }
 
   /** Defines type and sets initial value for block UiState. */
-  public withUiState<UiState>(initialValue: UiState): BlockModel<Args, OutputsCfg, UiState, Href> {
-    return new BlockModel<Args, OutputsCfg, UiState, Href>(
-      this._renderingMode,
-      this._initialArgs,
-      initialValue,
-      this._outputs,
-      this._inputsValid,
-      this._sections,
-      this._title,
-      this._enrichmentTargets,
-      this._featureFlags,
-    );
+  public withUiState<UiState>(initialUiState: UiState): BlockModel<Args, OutputsCfg, UiState, Href> {
+    return new BlockModel<Args, OutputsCfg, UiState, Href>({
+      ...this.config,
+      initialUiState,
+    });
   }
 
   /** Sets or overrides feature flags for the block. */
   public withFeatureFlags(flags: Partial<BlockCodeKnownFeatureFlags>): BlockModel<Args, OutputsCfg, UiState, Href> {
-    return new BlockModel<Args, OutputsCfg, UiState, Href>(
-      this._renderingMode,
-      this._initialArgs,
-      this._initialUiState,
-      this._outputs,
-      this._inputsValid,
-      this._sections,
-      this._title,
-      this._enrichmentTargets,
-      { ...this._featureFlags, ...flags },
-    );
+    return new BlockModel<Args, OutputsCfg, UiState, Href>({
+      ...this.config,
+      featureFlags: {
+        ...this.config.featureFlags,
+        ...flags,
+      },
+    });
   }
 
   /**
@@ -369,89 +360,96 @@ export class BlockModel<
     lambda: (args: Args) => PlRef[],
   ): BlockModel<Args, OutputsCfg, UiState, Href> {
     tryRegisterCallback('enrichmentTargets', lambda);
-    return new BlockModel<Args, OutputsCfg, UiState, Href>(
-      this._renderingMode,
-      this._initialArgs,
-      this._initialUiState,
-      this._outputs,
-      this._inputsValid,
-      this._sections,
-      this._title,
-      { __renderLambda: true, handle: 'enrichmentTargets' } as ConfigRenderLambda,
-      this._featureFlags,
-    );
+    return new BlockModel<Args, OutputsCfg, UiState, Href>({
+      ...this.config,
+      enrichmentTargets: {
+        __renderLambda: true,
+        handle: 'enrichmentTargets',
+      },
+    });
   }
 
-  public done(apiVersion?: 1): PlatformaV1<
+  public done(apiVersion?: 1): PlatformaExtended<PlatformaV1<
     Args,
     InferOutputsFromConfigs<Args, OutputsCfg, UiState>,
     UiState,
     Href
-  >;
+  >>;
 
-  public done(apiVersion: 2): PlatformaV2<
+  public done(apiVersion: 2): PlatformaExtended<PlatformaV2<
     Args,
     InferOutputsFromConfigs<Args, OutputsCfg, UiState>,
     UiState,
     Href
-  >;
+  >>;
 
   /** Renders all provided block settings into a pre-configured platforma API
    * instance, that can be used in frontend to interact with block state, and
    * other features provided by the platforma to the block. */
-  public done(apiVersion?: PlatformaApiVersion): Platforma<
+  public done(apiVersion: PlatformaApiVersion = 1): PlatformaExtended<Platforma<
     Args,
     InferOutputsFromConfigs<Args, OutputsCfg, UiState>,
     UiState,
     Href
-  > {
-    const requiresUIAPIVersion = apiVersion ?? 1;
+  >> {
     return this.withFeatureFlags({
-      ...this._featureFlags,
-      requiresUIAPIVersion,
-    })._done(requiresUIAPIVersion);
+      ...this.config.featureFlags,
+      requiresUIAPIVersion: apiVersion,
+    }).#done();
   }
 
-  public _done(apiVersion: PlatformaApiVersion): Platforma<
+  #done(): PlatformaExtended<Platforma<
     Args,
     InferOutputsFromConfigs<Args, OutputsCfg, UiState>,
     UiState,
     Href
-  > {
-    if (this._initialArgs === undefined) throw new Error('Initial arguments not set.');
+  >> {
+    if (this.config.initialArgs === undefined) throw new Error('Initial arguments not set.');
 
     const config: BlockConfigContainer = {
       v3: {
         sdkVersion: PlatformaSDKVersion,
-        renderingMode: this._renderingMode,
-        initialArgs: this._initialArgs,
-        initialUiState: this._initialUiState,
-        inputsValid: this._inputsValid,
-        sections: this._sections,
-        title: this._title,
-        outputs: this._outputs,
-        enrichmentTargets: this._enrichmentTargets,
-        featureFlags: this._featureFlags,
+        renderingMode: this.config.renderingMode,
+        initialArgs: this.config.initialArgs,
+        initialUiState: this.config.initialUiState,
+        inputsValid: this.config.inputsValid,
+        sections: this.config.sections,
+        title: this.config.title,
+        subtitle: this.config.subtitle,
+        tags: this.config.tags,
+        outputs: this.config.outputs,
+        enrichmentTargets: this.config.enrichmentTargets,
+        featureFlags: this.config.featureFlags,
       },
 
       // fields below are added to allow previous desktop versions read generated configs
       sdkVersion: PlatformaSDKVersion,
-      renderingMode: this._renderingMode,
-      initialArgs: this._initialArgs,
-      inputsValid: downgradeCfgOrLambda(this._inputsValid),
-      sections: downgradeCfgOrLambda(this._sections),
+      renderingMode: this.config.renderingMode,
+      initialArgs: this.config.initialArgs,
+      inputsValid: downgradeCfgOrLambda(this.config.inputsValid),
+      sections: downgradeCfgOrLambda(this.config.sections),
       outputs: Object.fromEntries(
-        Object.entries(this._outputs).map(([key, value]) => [key, downgradeCfgOrLambda(value)]),
+        Object.entries(this.config.outputs).map(([key, value]) => [key, downgradeCfgOrLambda(value)]),
       ),
     };
 
-    globalThis.platformaApiVersion = apiVersion;
+    globalThis.platformaApiVersion = this.config.featureFlags.requiresUIAPIVersion as PlatformaApiVersion;
 
     if (!isInUI())
     // we are in the configuration rendering routine, not in actual UI
       return { config } as any;
     // normal operation inside the UI
-    else return getPlatformaInstance({ sdkVersion: PlatformaSDKVersion, apiVersion: platformaApiVersion }) as any;
+    else return {
+      ...getPlatformaInstance({ sdkVersion: PlatformaSDKVersion, apiVersion: platformaApiVersion }),
+      blockModelInfo: {
+        outputs: Object.fromEntries(
+          Object.entries(this.config.outputs)
+            .map(([key, value]) => [key, {
+              withStatus: Boolean(isConfigLambda(value) && value.withStatus),
+            }]),
+        ),
+      },
+    };
   }
 }
 
@@ -466,5 +464,17 @@ type InferOutputsFromConfigs<
   OutputsCfg extends Record<string, TypedConfigOrConfigLambda>,
   UiState,
 > = {
-  [Key in keyof OutputsCfg]: ValueOrErrors<InferOutputType<OutputsCfg[Key], Args, UiState>>;
+  [Key in keyof OutputsCfg]:
+    & OutputWithStatus<InferOutputType<OutputsCfg[Key], Args, UiState>>
+    & { __unwrap: (OutputsCfg[Key] extends { withStatus: true } ? false : true) };
+};
+
+export type PlatformaExtended<Pl extends Platforma = Platforma> = Pl & {
+  blockModelInfo: BlockModelInfo;
+};
+
+export type BlockModelInfo = {
+  outputs: Record<string, {
+    withStatus: boolean;
+  }>;
 };