@platforma-sdk/model 1.57.2 → 1.58.1

package/dist/block_model_legacy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block_model_legacy.d.ts","sourceRoot":"","sources":["../src/block_model_legacy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"block_model_legacy.d.ts","sourceRoot":"","sources":["../src/block_model_legacy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EAEZ,KAAK,EACL,0BAA0B,EAE3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAGnE,OAAO,KAAK,EAAkC,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC5F,OAAO,KAAK,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAGhF,OAAO,KAAK,EACV,yBAAyB,EACzB,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,KAAK,oBAAoB,GAAG,SAAS,YAAY,EAAE,CAAC;AAEpD,KAAK,kBAAkB,CAAC,GAAG,SAAS,WAAW,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO,CACvE,GAAG,EACH,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,oBAAoB,GAAG,IAAI,GAAG,KAAK,CAC7F,CAAC;AAEF,KAAK,uBAAuB,GAAG,OAAO,CAAC;AAEvC,KAAK,qBAAqB,CAAC,GAAG,SAAS,WAAW,EAAE,IAAI,EAAE,OAAO,IAAI,OAAO,CAC1E,GAAG,EACH,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,SAAS,uBAAuB,GAAG,IAAI,GAAG,KAAK,CAChG,CAAC;AAEF,KAAK,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;AAElC;;0EAE0E;AAC1E,qBAAa,UAAU,CACrB,IAAI,EACJ,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,EAC5D,OAAO,EACP,IAAI,SAAS,IAAI,MAAM,EAAE,GAAG,GAAG;;IAG7B,OAAO,CAAC,MAAM;IADhB,OAAO;IAgBP,WAAkB,2BAA2B,IAAI,0BAA0B,CAO1E;IAED,sCAAsC;WACxB,MAAM,CAAC,aAAa,EAAE,kBAAkB,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IACnF,sCAAsC;WACxB,MAAM,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IAClD;;;OAGG;WACW,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,kBAAkB,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IACzF;;;OAGG;WACW,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC;IAYxD;;;;;;;SAOK;IACE,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,GAAG,SAAS,WAAW,EACnE,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,GACP,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG;SAAG,CAAC,IAAI,GAAG,GAAG,GAAG;KAAE,EAAE,OAAO,EAAE,IAAI,CAAC;IACpE;;;;;;;SAOK;IACE,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EAC1F,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,EAAE,EACN,KAAK,EAAE,uBAAuB,GAAG;QAAE,UAAU,EAAE,IAAI,CAAA;KAAE,GACpD,UAAU,CACX,IAAI,EACJ,UAAU,GAAG;SACV,CAAC,IAAI,GAAG,GAAG,kBAAkB,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,GAAG;YAAE,UAAU,EAAE,IAAI,CAAA;SAAE;KACrF,EACD,OAAO,EACP,IAAI,CACL;IACD;;;;;;;SAOK;IACE,MAAM,CAAC,KAAK,CAAC,GAAG,SAAS,MAAM,EAAE,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EAC1F,GAAG,EAAE,GAAG,EACR,EAAE,EAAE,EAAE,EACN,KAAK,CAAC,EAAE,uBAAuB,GAC9B,UAAU,CACX,IAAI,EACJ,UAAU,GAAG;SAAG,CAAC,IAAI,GAAG,GAAG,kBAAkB,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;KAAE,EAC9E,OAAO,EACP,IAAI,CACL;IA+BD,mEAAmE;IAC5D,eAAe,CACpB,KAAK,CAAC,GAAG,SAAS,MAAM,EACxB,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,oCAtCA,CAAC;IA0CnB,oEAAoE;IAC7D,gBAAgB,CACrB,KAAK,CAAC,GAAG,SAAS,MAAM,EACxB,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,oCAjEb,CAAC;oBAA4E,IAAI;;IAqEtF,mFAAmF;IAC5E,yBAAyB,CAC9B,KAAK,CAAC,GAAG,SAAS,MAAM,EACxB,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,EACpD,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,oCAzEb,CAAC;oBAA4E,IAAI;;IA6EtF;0CACsC;IAC/B,SAAS,CAAC,GAAG,SAAS,WAAW,EACtC,GAAG,EAAE,GAAG,GAAG,qBAAqB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GACnD,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAC9C,2FAA2F;IACpF,SAAS,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EACtE,EAAE,EAAE,EAAE,GACL,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAqB9C;0CACsC;IAC/B,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,oBAAoB,EAClD,EAAE,EAAE,CAAC,GACJ,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;IACvD,oFAAoF;IAC7E,QAAQ,CACb,KAAK,CAAC,GAAG,SAAS,oBAAoB,EACtC,KAAK,CAAC,EAAE,SAAS,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EACzD,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACrE,QAAQ,CAAC,KAAK,CAAC,GAAG,SAAS,WAAW,EAC3C,GAAG,EAAE,GAAG,GAAG,kBAAkB,CAAC,GAAG,EAAE,IAAI,EAAE,OAAO,CAAC,GAChD,UAAU,CACX,IAAI,EACJ,UAAU,EACV,OAAO,EACP,UAAU,CAAC,YAAY,CAAC,GAAG,EAAE,cAAc,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAC7D;IAuBD,8GAA8G;IACvG,KAAK,CACV,EAAE,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,GAC9C,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAWvC,QAAQ,CACb,EAAE,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,GAC9C,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAWvC,IAAI,CACT,EAAE,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,GAChD,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAW9C;;;SAGK;IACE,WAAW,CAAC,KAAK,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAI5E,qEAAqE;IAC9D,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAOrF,6DAA6D;IACtD,WAAW,CAAC,OAAO,EACxB,cAAc,EAAE,OAAO,GACtB,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAO9C,qDAAqD;IAC9C,gBAAgB,CACrB,KAAK,EAAE,OAAO,CAAC,0BAA0B,CAAC,GACzC,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAU9C;;;OAGG;IACI,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC;IAWtF,IAAI,CACT,UAAU,CAAC,EAAE,CAAC,GACb,iBAAiB,CAClB,WAAW,CAAC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CACrF;IAEM,IAAI,CACT,UAAU,EAAE,CAAC,GACZ,iBAAiB,CAClB,WAAW,CAAC,IAAI,EAAE,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CACrF;CAgFF"}

package/dist/block_model_legacy.js

@@ -247,6 +247,7 @@ class BlockModel {
                             withStatus: Boolean(isConfigLambda(value) && value.withStatus),
                         },
                     ])),
+                    pluginIds: [],
                 },
             };
     }

package/dist/block_model_legacy.js.map

@@ -1 +1 @@
-{"version":3,"file":"block_model_legacy.js","sources":["../src/block_model_legacy.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  AnyFunction,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport type { Checked, ConfigResult, TypedConfig } from \"./config\";\nimport { getImmediate } from \"./config\";\nimport { getPlatformaInstance, isInUI, tryRegisterCallback } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion, PlatformaV1, PlatformaV2 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunctionLegacy } from \"./render\";\nimport { RenderCtxLegacy } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport type {\n  TypedConfigOrConfigLambda,\n  ConfigRenderLambda,\n  StdCtxArgsOnly,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromConfigs,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype SectionsCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends SectionsExpectedType ? true : false\n>;\n\ntype InputsValidExpectedType = boolean;\n\ntype InputsValidCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends InputsValidExpectedType ? true : false\n>;\n\ntype NoOb = Record<string, never>;\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module. */\nexport class BlockModel<\n  Args,\n  OutputsCfg extends Record<string, TypedConfigOrConfigLambda>,\n  UiState,\n  Href extends `/${string}` = \"/\",\n> {\n  private constructor(\n    private config: {\n      readonly renderingMode: BlockRenderingMode;\n      readonly initialArgs?: Args;\n      readonly initialUiState: UiState;\n      readonly outputs: OutputsCfg;\n      readonly inputsValid: TypedConfigOrConfigLambda;\n      readonly sections: TypedConfigOrConfigLambda;\n      readonly title?: ConfigRenderLambda;\n      readonly subtitle?: ConfigRenderLambda;\n      readonly tags?: ConfigRenderLambda;\n      readonly enrichmentTargets?: ConfigRenderLambda;\n      readonly featureFlags: BlockCodeKnownFeatureFlags;\n    },\n  ) {}\n\n  public static get INITIAL_BLOCK_FEATURE_FLAGS(): BlockCodeKnownFeatureFlags {\n    return {\n      supportsLazyState: true,\n      requiresUIAPIVersion: 1,\n      requiresModelAPIVersion: 1,\n      requiresCreatePTable: 2,\n    };\n  }\n\n  /** Initiates configuration builder */\n  public static create(renderingMode: BlockRenderingMode): BlockModel<NoOb, {}, NoOb>;\n  /** Initiates configuration builder */\n  public static create(): BlockModel<NoOb, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(renderingMode: BlockRenderingMode): BlockModel<Args, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(): BlockModel<Args, {}, NoOb>;\n  public static create(renderingMode: BlockRenderingMode = \"Heavy\"): BlockModel<NoOb, {}, NoOb> {\n    return new BlockModel<NoOb, {}, NoOb>({\n      renderingMode,\n      initialUiState: {},\n      outputs: {},\n      inputsValid: getImmediate(true),\n      sections: getImmediate([]),\n      featureFlags: BlockModel.INITIAL_BLOCK_FEATURE_FLAGS,\n    });\n  }\n\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param cfg configuration describing how to render cell value from the blocks\n   *            workflow outputs\n   * @deprecated use lambda-based API\n   * */\n  public output<const Key extends string, const Cfg extends TypedConfig>(\n    key: Key,\n    cfg: Cfg,\n  ): BlockModel<Args, OutputsCfg & { [K in Key]: Cfg }, UiState, Href>;\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModel<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & { withStatus: true };\n    },\n    UiState,\n    Href\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModel<\n    Args,\n    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> },\n    UiState,\n    Href\n  >;\n  public output(\n    key: string,\n    cfgOrRf: TypedConfig | AnyFunction,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    if (typeof cfgOrRf === \"function\") {\n      const handle = `output#${key}`;\n      tryRegisterCallback(handle, () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: {\n            __renderLambda: true,\n            handle,\n            ...flags,\n          },\n        },\n      });\n    } else {\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: cfgOrRf,\n        },\n      });\n    }\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /** Shortcut for {@link output} with retentive and withStatus flags set to true. */\n  public retentiveOutputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true, withStatus: true });\n  }\n\n  /** Sets custom configuration predicate on the block args at which block can be executed\n   * @deprecated use lambda-based API */\n  public argsValid<Cfg extends TypedConfig>(\n    cfg: Cfg & InputsValidCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  /** Sets custom configuration predicate on the block args at which block can be executed */\n  public argsValid<RF extends RenderFunctionLegacy<Args, UiState, boolean>>(\n    rf: RF,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  public argsValid(\n    cfgOrRf: TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (typeof cfgOrRf === \"function\") {\n      tryRegisterCallback(\"inputsValid\", () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: {\n          __renderLambda: true,\n          handle: \"inputsValid\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: cfgOrRf,\n      });\n    }\n  }\n\n  /** Sets the config to generate list of section in the left block overviews panel\n   * @deprecated use lambda-based API */\n  public sections<const S extends SectionsExpectedType>(\n    rf: S,\n  ): BlockModel<Args, OutputsCfg, UiState, DeriveHref<S>>;\n  /** Sets the config to generate list of section in the left block overviews panel */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunctionLegacy<Args, UiState, Ret>,\n  >(rf: RF): BlockModel<Args, OutputsCfg, UiState, DeriveHref<ReturnType<RF>>>;\n  public sections<const Cfg extends TypedConfig>(\n    cfg: Cfg & SectionsCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<\n    Args,\n    OutputsCfg,\n    UiState,\n    DeriveHref<ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>>>\n  >;\n  public sections(\n    arrOrCfgOrRf: SectionsExpectedType | TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (Array.isArray(arrOrCfgOrRf)) {\n      return this.sections(getImmediate(arrOrCfgOrRf));\n    } else if (typeof arrOrCfgOrRf === \"function\") {\n      tryRegisterCallback(\"sections\", () => arrOrCfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: {\n          __renderLambda: true,\n          handle: \"sections\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: arrOrCfgOrRf as TypedConfig,\n      });\n    }\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"title\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      title: {\n        __renderLambda: true,\n        handle: \"title\",\n      },\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"subtitle\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      subtitle: {\n        __renderLambda: true,\n        handle: \"subtitle\",\n      },\n    });\n  }\n\n  public tags(\n    rf: RenderFunctionLegacy<Args, UiState, string[]>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"tags\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      tags: {\n        __renderLambda: true,\n        handle: \"tags\",\n      },\n    });\n  }\n\n  /**\n   * Sets initial args for the block, this value must be specified.\n   * @deprecated use {@link withArgs}\n   * */\n  public initialArgs(value: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return this.withArgs(value);\n  }\n\n  /** Sets initial args for the block, this value must be specified. */\n  public withArgs<Args>(initialArgs: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialArgs,\n    });\n  }\n\n  /** Defines type and sets initial value for block UiState. */\n  public withUiState<UiState>(\n    initialUiState: UiState,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialUiState,\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      featureFlags: {\n        ...this.config.featureFlags,\n        ...flags,\n      },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(lambda: (args: Args) => PlRef[]): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"enrichmentTargets\", lambda);\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      enrichmentTargets: {\n        __renderLambda: true,\n        handle: \"enrichmentTargets\",\n      },\n    });\n  }\n\n  public done(\n    apiVersion?: 1,\n  ): PlatformaExtended<\n    PlatformaV1<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  public done(\n    apiVersion: 2,\n  ): PlatformaExtended<\n    PlatformaV2<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block state, and\n   * other features provided by the platforma to the block. */\n  public done(\n    apiVersion: PlatformaApiVersion = 1,\n  ): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n      requiresUIAPIVersion: apiVersion,\n    }).#done();\n  }\n\n  #done(): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    if (this.config.initialArgs === undefined) throw new Error(\"Initial arguments not set.\");\n\n    const config: BlockConfigContainer = {\n      v4: undefined,\n      v3: {\n        configVersion: 3,\n        modelAPIVersion: 1,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        initialArgs: this.config.initialArgs,\n        initialUiState: this.config.initialUiState,\n        inputsValid: this.config.inputsValid,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: this.config.outputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      initialArgs: this.config.initialArgs,\n      inputsValid: downgradeCfgOrLambda(this.config.inputsValid),\n      sections: downgradeCfgOrLambda(this.config.sections),\n      outputs: Object.fromEntries(\n        Object.entries(this.config.outputs).map(([key, value]) => [\n          key,\n          downgradeCfgOrLambda(value),\n        ]),\n      ),\n    };\n\n    globalThis.platformaApiVersion = this.config.featureFlags\n      .requiresUIAPIVersion as PlatformaApiVersion;\n\n    if (!isInUI())\n      // we are in the configuration rendering routine, not in actual UI\n      return { config } as any;\n    // normal operation inside the UI\n    else\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion: platformaApiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(this.config.outputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n        },\n      };\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"block_model_legacy.js","sources":["../src/block_model_legacy.ts"],"sourcesContent":["import type {\n  BlockRenderingMode,\n  BlockSection,\n  AnyFunction,\n  PlRef,\n  BlockCodeKnownFeatureFlags,\n  BlockConfigContainer,\n} from \"@milaboratories/pl-model-common\";\nimport type { Checked, ConfigResult, TypedConfig } from \"./config\";\nimport { getImmediate } from \"./config\";\nimport { getPlatformaInstance, isInUI, tryRegisterCallback } from \"./internal\";\nimport type { Platforma, PlatformaApiVersion, PlatformaV1, PlatformaV2 } from \"./platforma\";\nimport type { InferRenderFunctionReturn, RenderFunctionLegacy } from \"./render\";\nimport { RenderCtxLegacy } from \"./render\";\nimport { PlatformaSDKVersion } from \"./version\";\nimport type {\n  TypedConfigOrConfigLambda,\n  ConfigRenderLambda,\n  StdCtxArgsOnly,\n  DeriveHref,\n  ConfigRenderLambdaFlags,\n  InferOutputsFromConfigs,\n} from \"./bconfig\";\nimport { downgradeCfgOrLambda, isConfigLambda } from \"./bconfig\";\nimport type { PlatformaExtended } from \"./platforma\";\n\ntype SectionsExpectedType = readonly BlockSection[];\n\ntype SectionsCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends SectionsExpectedType ? true : false\n>;\n\ntype InputsValidExpectedType = boolean;\n\ntype InputsValidCfgChecked<Cfg extends TypedConfig, Args, UiState> = Checked<\n  Cfg,\n  ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>> extends InputsValidExpectedType ? true : false\n>;\n\ntype NoOb = Record<string, never>;\n\n/** Main entry point that each block should use in it's \"config\" module. Don't forget\n * to call {@link done()} at the end of configuration. Value returned by this builder must be\n * exported as constant with name \"platforma\" from the \"config\" module. */\nexport class BlockModel<\n  Args,\n  OutputsCfg extends Record<string, TypedConfigOrConfigLambda>,\n  UiState,\n  Href extends `/${string}` = \"/\",\n> {\n  private constructor(\n    private config: {\n      readonly renderingMode: BlockRenderingMode;\n      readonly initialArgs?: Args;\n      readonly initialUiState: UiState;\n      readonly outputs: OutputsCfg;\n      readonly inputsValid: TypedConfigOrConfigLambda;\n      readonly sections: TypedConfigOrConfigLambda;\n      readonly title?: ConfigRenderLambda;\n      readonly subtitle?: ConfigRenderLambda;\n      readonly tags?: ConfigRenderLambda;\n      readonly enrichmentTargets?: ConfigRenderLambda;\n      readonly featureFlags: BlockCodeKnownFeatureFlags;\n    },\n  ) {}\n\n  public static get INITIAL_BLOCK_FEATURE_FLAGS(): BlockCodeKnownFeatureFlags {\n    return {\n      supportsLazyState: true,\n      requiresUIAPIVersion: 1,\n      requiresModelAPIVersion: 1,\n      requiresCreatePTable: 2,\n    };\n  }\n\n  /** Initiates configuration builder */\n  public static create(renderingMode: BlockRenderingMode): BlockModel<NoOb, {}, NoOb>;\n  /** Initiates configuration builder */\n  public static create(): BlockModel<NoOb, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(renderingMode: BlockRenderingMode): BlockModel<Args, {}, NoOb>;\n  /**\n   * Initiates configuration builder\n   * @deprecated use create method without generic parameter\n   */\n  public static create<Args>(): BlockModel<Args, {}, NoOb>;\n  public static create(renderingMode: BlockRenderingMode = \"Heavy\"): BlockModel<NoOb, {}, NoOb> {\n    return new BlockModel<NoOb, {}, NoOb>({\n      renderingMode,\n      initialUiState: {},\n      outputs: {},\n      inputsValid: getImmediate(true),\n      sections: getImmediate([]),\n      featureFlags: BlockModel.INITIAL_BLOCK_FEATURE_FLAGS,\n    });\n  }\n\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param cfg configuration describing how to render cell value from the blocks\n   *            workflow outputs\n   * @deprecated use lambda-based API\n   * */\n  public output<const Key extends string, const Cfg extends TypedConfig>(\n    key: Key,\n    cfg: Cfg,\n  ): BlockModel<Args, OutputsCfg & { [K in Key]: Cfg }, UiState, Href>;\n  /**\n   * Add output cell wrapped with additional status information to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags: ConfigRenderLambdaFlags & { withStatus: true },\n  ): BlockModel<\n    Args,\n    OutputsCfg & {\n      [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> & { withStatus: true };\n    },\n    UiState,\n    Href\n  >;\n  /**\n   * Add output cell to the configuration\n   *\n   * @param key output cell name, that can be later used to retrieve the rendered value\n   * @param rf  callback calculating output value using context, that allows to access\n   *            workflows outputs and interact with platforma drivers\n   * @param flags additional flags that may alter lambda rendering procedure\n   * */\n  public output<const Key extends string, const RF extends RenderFunctionLegacy<Args, UiState>>(\n    key: Key,\n    rf: RF,\n    flags?: ConfigRenderLambdaFlags,\n  ): BlockModel<\n    Args,\n    OutputsCfg & { [K in Key]: ConfigRenderLambda<InferRenderFunctionReturn<RF>> },\n    UiState,\n    Href\n  >;\n  public output(\n    key: string,\n    cfgOrRf: TypedConfig | AnyFunction,\n    flags: ConfigRenderLambdaFlags = {},\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    if (typeof cfgOrRf === \"function\") {\n      const handle = `output#${key}`;\n      tryRegisterCallback(handle, () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: {\n            __renderLambda: true,\n            handle,\n            ...flags,\n          },\n        },\n      });\n    } else {\n      return new BlockModel({\n        ...this.config,\n        outputs: {\n          ...this.config.outputs,\n          [key]: cfgOrRf,\n        },\n      });\n    }\n  }\n\n  /** Shortcut for {@link output} with retentive flag set to true. */\n  public retentiveOutput<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true });\n  }\n\n  /** Shortcut for {@link output} with withStatus flag set to true. */\n  public outputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { withStatus: true });\n  }\n\n  /** Shortcut for {@link output} with retentive and withStatus flags set to true. */\n  public retentiveOutputWithStatus<\n    const Key extends string,\n    const RF extends RenderFunctionLegacy<Args, UiState>,\n  >(key: Key, rf: RF) {\n    return this.output(key, rf, { retentive: true, withStatus: true });\n  }\n\n  /** Sets custom configuration predicate on the block args at which block can be executed\n   * @deprecated use lambda-based API */\n  public argsValid<Cfg extends TypedConfig>(\n    cfg: Cfg & InputsValidCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  /** Sets custom configuration predicate on the block args at which block can be executed */\n  public argsValid<RF extends RenderFunctionLegacy<Args, UiState, boolean>>(\n    rf: RF,\n  ): BlockModel<Args, OutputsCfg, UiState, Href>;\n  public argsValid(\n    cfgOrRf: TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (typeof cfgOrRf === \"function\") {\n      tryRegisterCallback(\"inputsValid\", () => cfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: {\n          __renderLambda: true,\n          handle: \"inputsValid\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        inputsValid: cfgOrRf,\n      });\n    }\n  }\n\n  /** Sets the config to generate list of section in the left block overviews panel\n   * @deprecated use lambda-based API */\n  public sections<const S extends SectionsExpectedType>(\n    rf: S,\n  ): BlockModel<Args, OutputsCfg, UiState, DeriveHref<S>>;\n  /** Sets the config to generate list of section in the left block overviews panel */\n  public sections<\n    const Ret extends SectionsExpectedType,\n    const RF extends RenderFunctionLegacy<Args, UiState, Ret>,\n  >(rf: RF): BlockModel<Args, OutputsCfg, UiState, DeriveHref<ReturnType<RF>>>;\n  public sections<const Cfg extends TypedConfig>(\n    cfg: Cfg & SectionsCfgChecked<Cfg, Args, UiState>,\n  ): BlockModel<\n    Args,\n    OutputsCfg,\n    UiState,\n    DeriveHref<ConfigResult<Cfg, StdCtxArgsOnly<Args, UiState>>>\n  >;\n  public sections(\n    arrOrCfgOrRf: SectionsExpectedType | TypedConfig | AnyFunction,\n  ): BlockModel<Args, OutputsCfg, UiState, `/${string}`> {\n    if (Array.isArray(arrOrCfgOrRf)) {\n      return this.sections(getImmediate(arrOrCfgOrRf));\n    } else if (typeof arrOrCfgOrRf === \"function\") {\n      tryRegisterCallback(\"sections\", () => arrOrCfgOrRf(new RenderCtxLegacy()));\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: {\n          __renderLambda: true,\n          handle: \"sections\",\n        },\n      });\n    } else {\n      return new BlockModel<Args, OutputsCfg, UiState>({\n        ...this.config,\n        sections: arrOrCfgOrRf as TypedConfig,\n      });\n    }\n  }\n\n  /** Sets a rendering function to derive block title, shown for the block in the left blocks-overview panel. */\n  public title(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"title\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      title: {\n        __renderLambda: true,\n        handle: \"title\",\n      },\n    });\n  }\n\n  public subtitle(\n    rf: RenderFunctionLegacy<Args, UiState, string>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"subtitle\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      subtitle: {\n        __renderLambda: true,\n        handle: \"subtitle\",\n      },\n    });\n  }\n\n  public tags(\n    rf: RenderFunctionLegacy<Args, UiState, string[]>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"tags\", () => rf(new RenderCtxLegacy()));\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      tags: {\n        __renderLambda: true,\n        handle: \"tags\",\n      },\n    });\n  }\n\n  /**\n   * Sets initial args for the block, this value must be specified.\n   * @deprecated use {@link withArgs}\n   * */\n  public initialArgs(value: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return this.withArgs(value);\n  }\n\n  /** Sets initial args for the block, this value must be specified. */\n  public withArgs<Args>(initialArgs: Args): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialArgs,\n    });\n  }\n\n  /** Defines type and sets initial value for block UiState. */\n  public withUiState<UiState>(\n    initialUiState: UiState,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      initialUiState,\n    });\n  }\n\n  /** Sets or overrides feature flags for the block. */\n  public withFeatureFlags(\n    flags: Partial<BlockCodeKnownFeatureFlags>,\n  ): BlockModel<Args, OutputsCfg, UiState, Href> {\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      featureFlags: {\n        ...this.config.featureFlags,\n        ...flags,\n      },\n    });\n  }\n\n  /**\n   * Defines how to derive list of upstream references this block is meant to enrich with its exports from block args.\n   * Influences dependency graph construction.\n   */\n  public enriches(lambda: (args: Args) => PlRef[]): BlockModel<Args, OutputsCfg, UiState, Href> {\n    tryRegisterCallback(\"enrichmentTargets\", lambda);\n    return new BlockModel<Args, OutputsCfg, UiState, Href>({\n      ...this.config,\n      enrichmentTargets: {\n        __renderLambda: true,\n        handle: \"enrichmentTargets\",\n      },\n    });\n  }\n\n  public done(\n    apiVersion?: 1,\n  ): PlatformaExtended<\n    PlatformaV1<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  public done(\n    apiVersion: 2,\n  ): PlatformaExtended<\n    PlatformaV2<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  >;\n\n  /** Renders all provided block settings into a pre-configured platforma API\n   * instance, that can be used in frontend to interact with block state, and\n   * other features provided by the platforma to the block. */\n  public done(\n    apiVersion: PlatformaApiVersion = 1,\n  ): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    return this.withFeatureFlags({\n      ...this.config.featureFlags,\n      requiresUIAPIVersion: apiVersion,\n    }).#done();\n  }\n\n  #done(): PlatformaExtended<\n    Platforma<Args, InferOutputsFromConfigs<Args, OutputsCfg, UiState>, UiState, Href>\n  > {\n    if (this.config.initialArgs === undefined) throw new Error(\"Initial arguments not set.\");\n\n    const config: BlockConfigContainer = {\n      v4: undefined,\n      v3: {\n        configVersion: 3,\n        modelAPIVersion: 1,\n        sdkVersion: PlatformaSDKVersion,\n        renderingMode: this.config.renderingMode,\n        initialArgs: this.config.initialArgs,\n        initialUiState: this.config.initialUiState,\n        inputsValid: this.config.inputsValid,\n        sections: this.config.sections,\n        title: this.config.title,\n        subtitle: this.config.subtitle,\n        tags: this.config.tags,\n        outputs: this.config.outputs,\n        enrichmentTargets: this.config.enrichmentTargets,\n        featureFlags: this.config.featureFlags,\n      },\n\n      // fields below are added to allow previous desktop versions read generated configs\n      sdkVersion: PlatformaSDKVersion,\n      renderingMode: this.config.renderingMode,\n      initialArgs: this.config.initialArgs,\n      inputsValid: downgradeCfgOrLambda(this.config.inputsValid),\n      sections: downgradeCfgOrLambda(this.config.sections),\n      outputs: Object.fromEntries(\n        Object.entries(this.config.outputs).map(([key, value]) => [\n          key,\n          downgradeCfgOrLambda(value),\n        ]),\n      ),\n    };\n\n    globalThis.platformaApiVersion = this.config.featureFlags\n      .requiresUIAPIVersion as PlatformaApiVersion;\n\n    if (!isInUI())\n      // we are in the configuration rendering routine, not in actual UI\n      return { config } as any;\n    // normal operation inside the UI\n    else\n      return {\n        ...getPlatformaInstance({\n          sdkVersion: PlatformaSDKVersion,\n          apiVersion: platformaApiVersion,\n        }),\n        blockModelInfo: {\n          outputs: Object.fromEntries(\n            Object.entries(this.config.outputs).map(([key, value]) => [\n              key,\n              {\n                withStatus: Boolean(isConfigLambda(value) && value.withStatus),\n              },\n            ]),\n          ),\n          pluginIds: [],\n        },\n      };\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/block_storage.cjs

@@ -27,7 +27,7 @@ const BLOCK_STORAGE_SCHEMA_VERSION = "v1";
  * Default data version for new blocks without migrations.
  * Unique identifier ensures blocks are created via DataModel API.
  */
-const DATA_MODEL_DEFAULT_VERSION = "__pl_v1_d4e8f2a1__";
+const DATA_MODEL_LEGACY_VERSION = "__pl_v1_d4e8f2a1__";
 /**
  * Type guard to check if a value is a valid BlockStorage object.
  * Checks for the discriminator key and valid schema version.
@@ -47,10 +47,10 @@ function isBlockStorage(value) {
  * Creates a BlockStorage with the given initial data
  *
  * @param initialData - The initial data value (defaults to empty object)
- * @param version - The initial data version key (defaults to DATA_MODEL_DEFAULT_VERSION)
+ * @param version - The initial data version key (defaults to DATA_MODEL_LEGACY_VERSION)
  * @returns A new BlockStorage instance with discriminator key
  */
-function createBlockStorage(initialData = {}, version = DATA_MODEL_DEFAULT_VERSION) {
+function createBlockStorage(initialData = {}, version = DATA_MODEL_LEGACY_VERSION) {
     return {
         [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
         __dataVersion: version,
@@ -74,7 +74,7 @@ function normalizeBlockStorage(raw) {
             ...storage,
             // Fix for early released version where __dataVersion was a number
             __dataVersion: typeof storage.__dataVersion === "number"
-                ? DATA_MODEL_DEFAULT_VERSION
+                ? DATA_MODEL_LEGACY_VERSION
                 : storage.__dataVersion,
             // Ensure plugin fields have defaults
             __pluginRegistry: storage.__pluginRegistry ?? {},
@@ -127,7 +127,7 @@ function updateStorageData(storage, payload) {
             const { pluginId, value } = payload;
             const currentPlugins = storage.__plugins ?? {};
             const existingEntry = currentPlugins[pluginId];
-            const version = existingEntry?.__dataVersion ?? DATA_MODEL_DEFAULT_VERSION;
+            const version = existingEntry?.__dataVersion ?? DATA_MODEL_LEGACY_VERSION;
             return {
                 ...storage,
                 __plugins: {
@@ -204,32 +204,33 @@ function migrateBlockStorage(storage, config) {
     const oldPlugins = storage.__plugins ?? {};
     const oldRegistry = storage.__pluginRegistry ?? {};
     const newPlugins = {};
-    for (const [pluginId, pluginName] of Object.entries(newPluginRegistry)) {
-        const existingEntry = oldPlugins[pluginId];
-        const existingName = oldRegistry[pluginId];
+    for (const [key, pluginName] of Object.entries(newPluginRegistry)) {
+        const handle = key;
+        const existingEntry = oldPlugins[handle];
+        const existingName = oldRegistry[handle];
         try {
             if (existingEntry && existingName === pluginName) {
                 // Plugin exists with same type - migrate its data
-                const migrated = migratePluginData(pluginId, {
+                const migrated = migratePluginData(handle, {
                     version: existingEntry.__dataVersion,
                     data: existingEntry.__data,
                 });
                 if (migrated) {
-                    newPlugins[pluginId] = { __dataVersion: migrated.version, __data: migrated.data };
+                    newPlugins[handle] = { __dataVersion: migrated.version, __data: migrated.data };
                 }
                 // If undefined returned, plugin is intentionally removed
             }
             else {
                 // New plugin or type changed - create with initial data
-                const initial = createPluginData(pluginId);
-                newPlugins[pluginId] = { __dataVersion: initial.version, __data: initial.data };
+                const initial = createPluginData(handle);
+                newPlugins[handle] = { __dataVersion: initial.version, __data: initial.data };
             }
         }
         catch (error) {
             return {
                 success: false,
                 error: error instanceof Error ? error.message : String(error),
-                failedAt: pluginId,
+                failedAt: handle,
             };
         }
     }
@@ -250,22 +251,25 @@ function migrateBlockStorage(storage, config) {
  * Gets plugin-specific data from block storage.
  * Accepts raw storage (any format) and normalizes internally.
  *
+ * When called with a typed PluginHandle<F>, the return type is automatically
+ * inferred from the factory's phantom `__types.data` field.
+ *
  * @param rawStorage - Raw block storage (may be legacy format or BlockStorage)
- * @param pluginId - The plugin instance id
- * @returns The plugin data
- * @throws If pluginId is not found in storage
+ * @param handle - The plugin handle (branded plugin instance id)
+ * @returns The plugin data, typed via factory inference
+ * @throws If plugin is not found in storage
  */
-function getPluginData(rawStorage, pluginId) {
+function getPluginData(rawStorage, handle) {
     const storage = normalizeBlockStorage(rawStorage);
-    const pluginEntry = storage.__plugins?.[pluginId];
+    const pluginEntry = storage.__plugins?.[handle];
     if (!pluginEntry)
-        throw new Error(`Plugin '${pluginId}' not found in block storage`);
+        throw new Error(`Plugin '${handle}' not found in block storage`);
     return pluginEntry.__data;
 }
 
 exports.BLOCK_STORAGE_KEY = BLOCK_STORAGE_KEY;
 exports.BLOCK_STORAGE_SCHEMA_VERSION = BLOCK_STORAGE_SCHEMA_VERSION;
-exports.DATA_MODEL_DEFAULT_VERSION = DATA_MODEL_DEFAULT_VERSION;
+exports.DATA_MODEL_LEGACY_VERSION = DATA_MODEL_LEGACY_VERSION;
 exports.createBlockStorage = createBlockStorage;
 exports.deriveDataFromStorage = deriveDataFromStorage;
 exports.getPluginData = getPluginData;

package/dist/block_storage.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"block_storage.cjs","sources":["../src/block_storage.ts"],"sourcesContent":["/**\n * BlockStorage - Typed storage abstraction for block persistent data.\n *\n * This module provides:\n * - A typed structure for block storage with versioning and plugin support\n * - Utility functions for manipulating storage\n * - Handler interfaces for model-level customization\n *\n * @module block_storage\n */\n\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { DataMigrationResult, DataVersioned } from \"./block_migrations\";\n\n// =============================================================================\n// Core Types\n// =============================================================================\n\n/**\n * Discriminator key for BlockStorage format detection.\n * This unique hash-based key identifies data as BlockStorage vs legacy formats.\n */\nexport const BLOCK_STORAGE_KEY = \"__pl_a7f3e2b9__\";\n\n/**\n * Current BlockStorage schema version.\n * Increment this when the storage structure itself changes (not block state migrations).\n */\nexport const BLOCK_STORAGE_SCHEMA_VERSION = \"v1\";\n\n/**\n * Default data version for new blocks without migrations.\n * Unique identifier ensures blocks are created via DataModel API.\n */\nexport const DATA_MODEL_DEFAULT_VERSION = \"__pl_v1_d4e8f2a1__\";\n\n/**\n * Type for valid schema versions\n */\nexport type BlockStorageSchemaVersion = \"v1\"; // Add 'v2', 'v3', etc. as schema evolves\n\n/**\n * Branded type for plugin names - globally unique plugin type identifiers.\n * Using a branded type enforces explicit casting (`as PluginName`) which makes\n * it easy to find all plugin name definitions in the codebase and verify uniqueness.\n */\nexport type PluginName = Branded<string, \"PluginName\">;\n\n/**\n * Plugin registry - maps pluginId (unique within a block) to pluginName (globally unique plugin type).\n * Using a Record highlights that pluginIds must be unique within a block.\n */\nexport type PluginRegistry = Record<string, PluginName>;\n\n/**\n * Versioned data - used for both block data and plugin data\n */\nexport interface VersionedData<TData = unknown> {\n  /** Version of the data, used for migrations */\n  __dataVersion: string;\n  /** The persistent data */\n  __data: TData;\n}\n\n/**\n * Core BlockStorage type that holds:\n * - __pl_a7f3e2b9__: Schema version (discriminator key identifies BlockStorage format)\n * - __dataVersion: Version key for block data migrations\n * - __data: The block's user-facing data (state)\n * - __pluginRegistry: Map from pluginId to pluginName (optional)\n * - __plugins: Plugin-specific data keyed by pluginId (optional)\n */\nexport type BlockStorage<TState = unknown> = {\n  /** Schema version - the key itself is the discriminator */\n  readonly [BLOCK_STORAGE_KEY]: BlockStorageSchemaVersion;\n  /** Registry of plugins: pluginId -> pluginName */\n  __pluginRegistry?: PluginRegistry;\n  /** Plugin-specific data, keyed by pluginId */\n  __plugins?: Record<string, VersionedData<unknown>>;\n} & VersionedData<TState>;\n\n/**\n * Type guard to check if a value is a valid BlockStorage object.\n * Checks for the discriminator key and valid schema version.\n */\nexport function isBlockStorage(value: unknown): value is BlockStorage {\n  if (value === null || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  const schemaVersion = obj[BLOCK_STORAGE_KEY];\n  // Currently only 'v1' is valid, but this allows future versions\n  return schemaVersion === \"v1\"; // Add more versions as schema evolves\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Creates a BlockStorage with the given initial data\n *\n * @param initialData - The initial data value (defaults to empty object)\n * @param version - The initial data version key (defaults to DATA_MODEL_DEFAULT_VERSION)\n * @returns A new BlockStorage instance with discriminator key\n */\nexport function createBlockStorage<TState = unknown>(\n  initialData: TState = {} as TState,\n  version: string = DATA_MODEL_DEFAULT_VERSION,\n): BlockStorage<TState> {\n  return {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: version,\n    __data: initialData,\n    __pluginRegistry: {},\n    __plugins: {},\n  };\n}\n\n/**\n * Normalizes raw storage data to BlockStorage format.\n * If the input is already a BlockStorage, returns it as-is (with defaults for missing fields).\n * If the input is legacy format (raw state), wraps it in BlockStorage structure.\n *\n * @param raw - Raw storage data (may be legacy format or BlockStorage)\n * @returns Normalized BlockStorage\n */\nexport function normalizeBlockStorage<TState = unknown>(raw: unknown): BlockStorage<TState> {\n  if (isBlockStorage(raw)) {\n    const storage = raw as BlockStorage<TState>;\n    return {\n      ...storage,\n      // Fix for early released version where __dataVersion was a number\n      __dataVersion:\n        typeof storage.__dataVersion === \"number\"\n          ? DATA_MODEL_DEFAULT_VERSION\n          : storage.__dataVersion,\n      // Ensure plugin fields have defaults\n      __pluginRegistry: storage.__pluginRegistry ?? {},\n      __plugins: storage.__plugins ?? {},\n    };\n  }\n  // Legacy format: raw is the state directly\n  return createBlockStorage(raw as TState);\n}\n\n// =============================================================================\n// Data Access & Update Functions\n// =============================================================================\n\n/**\n * Gets the data from BlockStorage\n *\n * @param storage - The BlockStorage instance\n * @returns The data value\n */\nexport function getStorageData<TState>(storage: BlockStorage<TState>): TState {\n  return storage.__data;\n}\n\n/**\n * Derives data from raw block storage.\n * This function is meant to be called from sdk/ui-vue to extract\n * user-facing data from the raw storage returned by the middle layer.\n *\n * The middle layer returns raw storage (opaque to it), and the UI\n * uses this function to derive the actual data value.\n *\n * @param rawStorage - Raw storage data from middle layer (may be any format)\n * @returns The extracted data value, or undefined if storage is undefined/null\n */\nexport function deriveDataFromStorage<TData = unknown>(rawStorage: unknown): TData {\n  // Normalize to BlockStorage format (handles legacy formats too)\n  const storage = normalizeBlockStorage<TData>(rawStorage);\n  return getStorageData(storage);\n}\n\n/** Payload for storage mutation operations. SDK defines specific operations. */\nexport type MutateStoragePayload<T = unknown> =\n  | { operation: \"update-block-data\"; value: T }\n  | { operation: \"update-plugin-data\"; pluginId: string; value: unknown };\n\n/**\n * Updates the data in BlockStorage (immutable)\n *\n * @param storage - The current BlockStorage\n * @param payload - The update payload with operation and value\n * @returns A new BlockStorage with updated data\n */\nexport function updateStorageData<TValue = unknown>(\n  storage: BlockStorage<TValue>,\n  payload: MutateStoragePayload<TValue>,\n): BlockStorage<TValue> {\n  switch (payload.operation) {\n    case \"update-block-data\":\n      return { ...storage, __data: payload.value };\n    case \"update-plugin-data\": {\n      const { pluginId, value } = payload;\n      const currentPlugins = storage.__plugins ?? {};\n      const existingEntry = currentPlugins[pluginId];\n      const version = existingEntry?.__dataVersion ?? DATA_MODEL_DEFAULT_VERSION;\n      return {\n        ...storage,\n        __plugins: {\n          ...currentPlugins,\n          [pluginId]: {\n            __dataVersion: version,\n            __data: value,\n          },\n        },\n      };\n    }\n    default:\n      throw new Error(`Unknown storage operation: ${(payload as { operation: string }).operation}`);\n  }\n}\n\n/**\n * Storage debug view returned by __pl_storage_debugView callback.\n * Used by developer tools to display block storage info.\n */\nexport interface StorageDebugView {\n  /** Current data version key */\n  dataVersion: string;\n  /** Raw data payload stored in BlockStorage */\n  data: unknown;\n}\n\n// =============================================================================\n// Atomic Migration\n// =============================================================================\n\n/**\n * Result of a successful atomic migration.\n */\nexport interface MigrationSuccess<TState> {\n  success: true;\n  /** The fully migrated storage - commit this to persist */\n  storage: BlockStorage<TState>;\n}\n\n/**\n * Result of a failed atomic migration.\n * The original storage is untouched - user must choose to abort or reset.\n */\nexport interface MigrationFailure {\n  success: false;\n  /** Description of what failed */\n  error: string;\n  /** Which step failed: 'block' or pluginId */\n  failedAt: string;\n}\n\nexport type MigrationResult<TState> = MigrationSuccess<TState> | MigrationFailure;\n\n/**\n * Configuration for atomic block storage migration.\n * Callbacks use DataVersioned format (the DataModel API format).\n * Conversion to internal VersionedData format is handled by migrateBlockStorage().\n */\nexport interface MigrateBlockStorageConfig {\n  /** Migrate block data from any version to latest */\n  migrateBlockData: (versioned: DataVersioned<unknown>) => DataMigrationResult<unknown>;\n  /** Migrate each plugin's data. Return undefined to remove the plugin. */\n  migratePluginData: (\n    pluginId: string,\n    versioned: DataVersioned<unknown>,\n  ) => DataMigrationResult<unknown> | undefined;\n  /** The new plugin registry after migration (pluginId -> pluginName) */\n  newPluginRegistry: PluginRegistry;\n  /** Factory to create initial data for new plugins */\n  createPluginData: (pluginId: string) => DataVersioned<unknown>;\n}\n\n/**\n * Performs atomic migration of block storage including block data and all plugins.\n *\n * Migration is atomic: either everything succeeds and a new storage is returned,\n * or an error is returned and the original storage is completely untouched.\n *\n * Migration steps:\n * 1. Migrate block data\n * 2. For each plugin in newPluginRegistry:\n *    - If plugin exists with same name: migrate its data\n *    - Otherwise (new or type changed): create with initial data\n *    Plugins not in newPluginRegistry are dropped.\n *\n * If any step throws, migration fails and original storage is preserved.\n * User can then choose to:\n * - Abort: keep original storage, don't update block\n * - Reset: call createBlockStorage() to start fresh\n *\n * @param storage - The original storage (will not be modified)\n * @param config - Migration configuration\n * @returns Migration result - either success with new storage, or failure with error info\n *\n * @example\n * const result = migrateBlockStorage(storage, {\n *   migrateBlockData: (versioned) => blockDataModel.migrate(versioned),\n *   migratePluginData: (pluginId, versioned) => getPluginModel(pluginId).migrate(versioned),\n *   newPluginRegistry: { table1: 'dataTable' as PluginName },\n *   createPluginData: (pluginId) => getPluginModel(pluginId).getDefaultData(),\n * });\n *\n * if (result.success) {\n *   commitStorage(result.storage);\n * } else {\n *   const userChoice = await askUser(`Migration failed: ${result.error}. Reset data?`);\n *   if (userChoice === 'reset') {\n *     commitStorage(createBlockStorage(initialData, currentVersion));\n *   }\n *   // else: abort, keep original\n * }\n */\nexport function migrateBlockStorage(\n  storage: BlockStorage<unknown>,\n  config: MigrateBlockStorageConfig,\n): MigrationResult<unknown> {\n  const { migrateBlockData, migratePluginData, newPluginRegistry, createPluginData } = config;\n\n  // Step 1: Migrate block data\n  let migratedData: unknown;\n  let newVersion: string;\n  try {\n    const result = migrateBlockData({ version: storage.__dataVersion, data: storage.__data });\n    migratedData = result.data;\n    newVersion = result.version;\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      failedAt: \"block\",\n    };\n  }\n\n  // Step 2: Migrate plugins\n  const oldPlugins = storage.__plugins ?? {};\n  const oldRegistry = storage.__pluginRegistry ?? {};\n  const newPlugins: Record<string, VersionedData<unknown>> = {};\n\n  for (const [pluginId, pluginName] of Object.entries(newPluginRegistry)) {\n    const existingEntry = oldPlugins[pluginId];\n    const existingName = oldRegistry[pluginId];\n\n    try {\n      if (existingEntry && existingName === pluginName) {\n        // Plugin exists with same type - migrate its data\n        const migrated = migratePluginData(pluginId, {\n          version: existingEntry.__dataVersion,\n          data: existingEntry.__data,\n        });\n        if (migrated) {\n          newPlugins[pluginId] = { __dataVersion: migrated.version, __data: migrated.data };\n        }\n        // If undefined returned, plugin is intentionally removed\n      } else {\n        // New plugin or type changed - create with initial data\n        const initial = createPluginData(pluginId);\n        newPlugins[pluginId] = { __dataVersion: initial.version, __data: initial.data };\n      }\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n        failedAt: pluginId,\n      };\n    }\n  }\n\n  // Step 3: Build final storage atomically\n  const migratedStorage: BlockStorage = {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: newVersion,\n    __data: migratedData,\n    __pluginRegistry: newPluginRegistry,\n    __plugins: newPlugins,\n  };\n\n  return {\n    success: true,\n    storage: migratedStorage,\n  };\n}\n\n/**\n * Gets plugin-specific data from block storage.\n * Accepts raw storage (any format) and normalizes internally.\n *\n * @param rawStorage - Raw block storage (may be legacy format or BlockStorage)\n * @param pluginId - The plugin instance id\n * @returns The plugin data\n * @throws If pluginId is not found in storage\n */\nexport function getPluginData<TData = unknown>(rawStorage: unknown, pluginId: string): TData {\n  const storage = normalizeBlockStorage(rawStorage);\n  const pluginEntry = storage.__plugins?.[pluginId];\n  if (!pluginEntry) throw new Error(`Plugin '${pluginId}' not found in block storage`);\n  return pluginEntry.__data as TData;\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"block_storage.cjs","sources":["../src/block_storage.ts"],"sourcesContent":["/**\n * BlockStorage - Typed storage abstraction for block persistent data.\n *\n * This module provides:\n * - A typed structure for block storage with versioning and plugin support\n * - Utility functions for manipulating storage\n * - Handler interfaces for model-level customization\n *\n * @module block_storage\n */\n\nimport type { Branded } from \"@milaboratories/pl-model-common\";\nimport type { DataVersioned } from \"./block_migrations\";\nimport type { PluginHandle, PluginFactoryLike, InferFactoryData } from \"./plugin_handle\";\n\n// =============================================================================\n// Core Types\n// =============================================================================\n\n/**\n * Discriminator key for BlockStorage format detection.\n * This unique hash-based key identifies data as BlockStorage vs legacy formats.\n */\nexport const BLOCK_STORAGE_KEY = \"__pl_a7f3e2b9__\";\n\n/**\n * Current BlockStorage schema version.\n * Increment this when the storage structure itself changes (not block state migrations).\n */\nexport const BLOCK_STORAGE_SCHEMA_VERSION = \"v1\";\n\n/**\n * Default data version for new blocks without migrations.\n * Unique identifier ensures blocks are created via DataModel API.\n */\nexport const DATA_MODEL_LEGACY_VERSION = \"__pl_v1_d4e8f2a1__\";\n\n/**\n * Type for valid schema versions\n */\nexport type BlockStorageSchemaVersion = \"v1\"; // Add 'v2', 'v3', etc. as schema evolves\n\n/**\n * Branded type for plugin names - globally unique plugin type identifiers.\n * Using a branded type enforces explicit casting (`as PluginName`) which makes\n * it easy to find all plugin name definitions in the codebase and verify uniqueness.\n */\nexport type PluginName = Branded<string, \"PluginName\">;\n\n/**\n * Plugin registry - maps pluginId (unique within a block) to pluginName (globally unique plugin type).\n * Using a Record highlights that pluginIds must be unique within a block.\n */\nexport type PluginRegistry = Record<PluginHandle, PluginName>;\n\n/**\n * Versioned data - used for both block data and plugin data\n */\nexport interface VersionedData<TData = unknown> {\n  /** Version of the data, used for migrations */\n  __dataVersion: string;\n  /** The persistent data */\n  __data: TData;\n}\n\n/**\n * Core BlockStorage type that holds:\n * - __pl_a7f3e2b9__: Schema version (discriminator key identifies BlockStorage format)\n * - __dataVersion: Version key for block data migrations\n * - __data: The block's user-facing data (state)\n * - __pluginRegistry: Map from pluginId to pluginName (optional)\n * - __plugins: Plugin-specific data keyed by pluginId (optional)\n */\nexport type BlockStorage<TState = unknown> = {\n  /** Schema version - the key itself is the discriminator */\n  readonly [BLOCK_STORAGE_KEY]: BlockStorageSchemaVersion;\n  /** Registry of plugins: pluginId -> pluginName */\n  __pluginRegistry?: PluginRegistry;\n  /** Plugin-specific data, keyed by plugin handle */\n  __plugins?: Record<PluginHandle, VersionedData<unknown>>;\n} & VersionedData<TState>;\n\n/**\n * Type guard to check if a value is a valid BlockStorage object.\n * Checks for the discriminator key and valid schema version.\n */\nexport function isBlockStorage(value: unknown): value is BlockStorage {\n  if (value === null || typeof value !== \"object\") return false;\n  const obj = value as Record<string, unknown>;\n  const schemaVersion = obj[BLOCK_STORAGE_KEY];\n  // Currently only 'v1' is valid, but this allows future versions\n  return schemaVersion === \"v1\"; // Add more versions as schema evolves\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Creates a BlockStorage with the given initial data\n *\n * @param initialData - The initial data value (defaults to empty object)\n * @param version - The initial data version key (defaults to DATA_MODEL_LEGACY_VERSION)\n * @returns A new BlockStorage instance with discriminator key\n */\nexport function createBlockStorage<TState = unknown>(\n  initialData: TState = {} as TState,\n  version: string = DATA_MODEL_LEGACY_VERSION,\n): BlockStorage<TState> {\n  return {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: version,\n    __data: initialData,\n    __pluginRegistry: {},\n    __plugins: {},\n  };\n}\n\n/**\n * Normalizes raw storage data to BlockStorage format.\n * If the input is already a BlockStorage, returns it as-is (with defaults for missing fields).\n * If the input is legacy format (raw state), wraps it in BlockStorage structure.\n *\n * @param raw - Raw storage data (may be legacy format or BlockStorage)\n * @returns Normalized BlockStorage\n */\nexport function normalizeBlockStorage<TState = unknown>(raw: unknown): BlockStorage<TState> {\n  if (isBlockStorage(raw)) {\n    const storage = raw as BlockStorage<TState>;\n    return {\n      ...storage,\n      // Fix for early released version where __dataVersion was a number\n      __dataVersion:\n        typeof storage.__dataVersion === \"number\"\n          ? DATA_MODEL_LEGACY_VERSION\n          : storage.__dataVersion,\n      // Ensure plugin fields have defaults\n      __pluginRegistry: storage.__pluginRegistry ?? {},\n      __plugins: storage.__plugins ?? {},\n    };\n  }\n  // Legacy format: raw is the state directly\n  return createBlockStorage(raw as TState);\n}\n\n// =============================================================================\n// Data Access & Update Functions\n// =============================================================================\n\n/**\n * Gets the data from BlockStorage\n *\n * @param storage - The BlockStorage instance\n * @returns The data value\n */\nexport function getStorageData<TState>(storage: BlockStorage<TState>): TState {\n  return storage.__data;\n}\n\n/**\n * Derives data from raw block storage.\n * This function is meant to be called from sdk/ui-vue to extract\n * user-facing data from the raw storage returned by the middle layer.\n *\n * The middle layer returns raw storage (opaque to it), and the UI\n * uses this function to derive the actual data value.\n *\n * @param rawStorage - Raw storage data from middle layer (may be any format)\n * @returns The extracted data value, or undefined if storage is undefined/null\n */\nexport function deriveDataFromStorage<TData = unknown>(rawStorage: unknown): TData {\n  // Normalize to BlockStorage format (handles legacy formats too)\n  const storage = normalizeBlockStorage<TData>(rawStorage);\n  return getStorageData(storage);\n}\n\n/** Payload for storage mutation operations. SDK defines specific operations. */\nexport type MutateStoragePayload<T = unknown> =\n  | { operation: \"update-block-data\"; value: T }\n  | { operation: \"update-plugin-data\"; pluginId: PluginHandle; value: unknown };\n\n/**\n * Updates the data in BlockStorage (immutable)\n *\n * @param storage - The current BlockStorage\n * @param payload - The update payload with operation and value\n * @returns A new BlockStorage with updated data\n */\nexport function updateStorageData<TValue = unknown>(\n  storage: BlockStorage<TValue>,\n  payload: MutateStoragePayload<TValue>,\n): BlockStorage<TValue> {\n  switch (payload.operation) {\n    case \"update-block-data\":\n      return { ...storage, __data: payload.value };\n    case \"update-plugin-data\": {\n      const { pluginId, value } = payload;\n      const currentPlugins = storage.__plugins ?? {};\n      const existingEntry = currentPlugins[pluginId];\n      const version = existingEntry?.__dataVersion ?? DATA_MODEL_LEGACY_VERSION;\n      return {\n        ...storage,\n        __plugins: {\n          ...currentPlugins,\n          [pluginId]: {\n            __dataVersion: version,\n            __data: value,\n          },\n        },\n      };\n    }\n    default:\n      throw new Error(`Unknown storage operation: ${(payload as { operation: string }).operation}`);\n  }\n}\n\n/**\n * Storage debug view returned by __pl_storage_debugView callback.\n * Used by developer tools to display block storage info.\n */\nexport interface StorageDebugView {\n  /** Current data version key */\n  dataVersion: string;\n  /** Raw data payload stored in BlockStorage */\n  data: unknown;\n}\n\n// =============================================================================\n// Atomic Migration\n// =============================================================================\n\n/**\n * Result of a successful atomic migration.\n */\nexport interface MigrationSuccess<TState> {\n  success: true;\n  /** The fully migrated storage - commit this to persist */\n  storage: BlockStorage<TState>;\n}\n\n/**\n * Result of a failed atomic migration.\n * The original storage is untouched - user must choose to abort or reset.\n */\nexport interface MigrationFailure {\n  success: false;\n  /** Description of what failed */\n  error: string;\n  /** Which step failed: 'block' or pluginId */\n  failedAt: string;\n}\n\nexport type MigrationResult<TState> = MigrationSuccess<TState> | MigrationFailure;\n\n/**\n * Configuration for atomic block storage migration.\n * Callbacks use DataVersioned format (the DataModel API format).\n * Conversion to internal VersionedData format is handled by migrateBlockStorage().\n */\nexport interface MigrateBlockStorageConfig {\n  /** Migrate block data from any version to latest. Throws on failure. */\n  migrateBlockData: (versioned: DataVersioned<unknown>) => DataVersioned<unknown>;\n  /** Migrate each plugin's data. Return undefined to remove the plugin. Throws on failure. */\n  migratePluginData: (\n    handle: PluginHandle,\n    versioned: DataVersioned<unknown>,\n  ) => DataVersioned<unknown> | undefined;\n  /** The new plugin registry after migration (pluginId -> pluginName) */\n  newPluginRegistry: PluginRegistry;\n  /** Factory to create initial data for new plugins */\n  createPluginData: (handle: PluginHandle) => DataVersioned<unknown>;\n}\n\n/**\n * Performs atomic migration of block storage including block data and all plugins.\n *\n * Migration is atomic: either everything succeeds and a new storage is returned,\n * or an error is returned and the original storage is completely untouched.\n *\n * Migration steps:\n * 1. Migrate block data\n * 2. For each plugin in newPluginRegistry:\n *    - If plugin exists with same name: migrate its data\n *    - Otherwise (new or type changed): create with initial data\n *    Plugins not in newPluginRegistry are dropped.\n *\n * If any step throws, migration fails and original storage is preserved.\n * User can then choose to:\n * - Abort: keep original storage, don't update block\n * - Reset: call createBlockStorage() to start fresh\n *\n * @param storage - The original storage (will not be modified)\n * @param config - Migration configuration\n * @returns Migration result - either success with new storage, or failure with error info\n *\n * @example\n * const result = migrateBlockStorage(storage, {\n *   migrateBlockData: (versioned) => blockDataModel.migrate(versioned),\n *   migratePluginData: (pluginId, versioned) => getPluginModel(pluginId).migrate(versioned),\n *   newPluginRegistry: { table1: 'dataTable' as PluginName },\n *   createPluginData: (pluginId) => getPluginModel(pluginId).getDefaultData(),\n * });\n *\n * if (result.success) {\n *   commitStorage(result.storage);\n * } else {\n *   const userChoice = await askUser(`Migration failed: ${result.error}. Reset data?`);\n *   if (userChoice === 'reset') {\n *     commitStorage(createBlockStorage(initialData, currentVersion));\n *   }\n *   // else: abort, keep original\n * }\n */\nexport function migrateBlockStorage(\n  storage: BlockStorage<unknown>,\n  config: MigrateBlockStorageConfig,\n): MigrationResult<unknown> {\n  const { migrateBlockData, migratePluginData, newPluginRegistry, createPluginData } = config;\n\n  // Step 1: Migrate block data\n  let migratedData: unknown;\n  let newVersion: string;\n  try {\n    const result = migrateBlockData({ version: storage.__dataVersion, data: storage.__data });\n    migratedData = result.data;\n    newVersion = result.version;\n  } catch (error) {\n    return {\n      success: false,\n      error: error instanceof Error ? error.message : String(error),\n      failedAt: \"block\",\n    };\n  }\n\n  // Step 2: Migrate plugins\n  const oldPlugins = storage.__plugins ?? {};\n  const oldRegistry = storage.__pluginRegistry ?? {};\n  const newPlugins: Record<PluginHandle, VersionedData<unknown>> = {};\n\n  for (const [key, pluginName] of Object.entries(newPluginRegistry)) {\n    const handle = key as PluginHandle;\n    const existingEntry = oldPlugins[handle];\n    const existingName = oldRegistry[handle];\n\n    try {\n      if (existingEntry && existingName === pluginName) {\n        // Plugin exists with same type - migrate its data\n        const migrated = migratePluginData(handle, {\n          version: existingEntry.__dataVersion,\n          data: existingEntry.__data,\n        });\n        if (migrated) {\n          newPlugins[handle] = { __dataVersion: migrated.version, __data: migrated.data };\n        }\n        // If undefined returned, plugin is intentionally removed\n      } else {\n        // New plugin or type changed - create with initial data\n        const initial = createPluginData(handle);\n        newPlugins[handle] = { __dataVersion: initial.version, __data: initial.data };\n      }\n    } catch (error) {\n      return {\n        success: false,\n        error: error instanceof Error ? error.message : String(error),\n        failedAt: handle,\n      };\n    }\n  }\n\n  // Step 3: Build final storage atomically\n  const migratedStorage: BlockStorage = {\n    [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,\n    __dataVersion: newVersion,\n    __data: migratedData,\n    __pluginRegistry: newPluginRegistry,\n    __plugins: newPlugins,\n  };\n\n  return {\n    success: true,\n    storage: migratedStorage,\n  };\n}\n\n/**\n * Gets plugin-specific data from block storage.\n * Accepts raw storage (any format) and normalizes internally.\n *\n * When called with a typed PluginHandle<F>, the return type is automatically\n * inferred from the factory's phantom `__types.data` field.\n *\n * @param rawStorage - Raw block storage (may be legacy format or BlockStorage)\n * @param handle - The plugin handle (branded plugin instance id)\n * @returns The plugin data, typed via factory inference\n * @throws If plugin is not found in storage\n */\nexport function getPluginData<F extends PluginFactoryLike>(\n  rawStorage: unknown,\n  handle: PluginHandle<F>,\n): InferFactoryData<F> {\n  const storage = normalizeBlockStorage(rawStorage);\n  const pluginEntry = storage.__plugins?.[handle];\n  if (!pluginEntry) throw new Error(`Plugin '${handle}' not found in block storage`);\n  return pluginEntry.__data as InferFactoryData<F>;\n}\n"],"names":[],"mappings":"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"}

package/dist/block_storage.d.ts

@@ -9,7 +9,8 @@
  * @module block_storage
  */
 import type { Branded } from "@milaboratories/pl-model-common";
-import type { DataMigrationResult, DataVersioned } from "./block_migrations";
+import type { DataVersioned } from "./block_migrations";
+import type { PluginHandle, PluginFactoryLike, InferFactoryData } from "./plugin_handle";
 /**
  * Discriminator key for BlockStorage format detection.
  * This unique hash-based key identifies data as BlockStorage vs legacy formats.
@@ -24,7 +25,7 @@ export declare const BLOCK_STORAGE_SCHEMA_VERSION = "v1";
  * Default data version for new blocks without migrations.
  * Unique identifier ensures blocks are created via DataModel API.
  */
-export declare const DATA_MODEL_DEFAULT_VERSION = "__pl_v1_d4e8f2a1__";
+export declare const DATA_MODEL_LEGACY_VERSION = "__pl_v1_d4e8f2a1__";
 /**
  * Type for valid schema versions
  */
@@ -39,7 +40,7 @@ export type PluginName = Branded<string, "PluginName">;
  * Plugin registry - maps pluginId (unique within a block) to pluginName (globally unique plugin type).
  * Using a Record highlights that pluginIds must be unique within a block.
  */
-export type PluginRegistry = Record<string, PluginName>;
+export type PluginRegistry = Record<PluginHandle, PluginName>;
 /**
  * Versioned data - used for both block data and plugin data
  */
@@ -62,8 +63,8 @@ export type BlockStorage<TState = unknown> = {
     readonly [BLOCK_STORAGE_KEY]: BlockStorageSchemaVersion;
     /** Registry of plugins: pluginId -> pluginName */
     __pluginRegistry?: PluginRegistry;
-    /** Plugin-specific data, keyed by pluginId */
-    __plugins?: Record<string, VersionedData<unknown>>;
+    /** Plugin-specific data, keyed by plugin handle */
+    __plugins?: Record<PluginHandle, VersionedData<unknown>>;
 } & VersionedData<TState>;
 /**
  * Type guard to check if a value is a valid BlockStorage object.
@@ -74,7 +75,7 @@ export declare function isBlockStorage(value: unknown): value is BlockStorage;
  * Creates a BlockStorage with the given initial data
  *
  * @param initialData - The initial data value (defaults to empty object)
- * @param version - The initial data version key (defaults to DATA_MODEL_DEFAULT_VERSION)
+ * @param version - The initial data version key (defaults to DATA_MODEL_LEGACY_VERSION)
  * @returns A new BlockStorage instance with discriminator key
  */
 export declare function createBlockStorage<TState = unknown>(initialData?: TState, version?: string): BlockStorage<TState>;
@@ -112,7 +113,7 @@ export type MutateStoragePayload<T = unknown> = {
     value: T;
 } | {
     operation: "update-plugin-data";
-    pluginId: string;
+    pluginId: PluginHandle;
     value: unknown;
 };
 /**
@@ -159,14 +160,14 @@ export type MigrationResult<TState> = MigrationSuccess<TState> | MigrationFailur
  * Conversion to internal VersionedData format is handled by migrateBlockStorage().
  */
 export interface MigrateBlockStorageConfig {
-    /** Migrate block data from any version to latest */
-    migrateBlockData: (versioned: DataVersioned<unknown>) => DataMigrationResult<unknown>;
-    /** Migrate each plugin's data. Return undefined to remove the plugin. */
-    migratePluginData: (pluginId: string, versioned: DataVersioned<unknown>) => DataMigrationResult<unknown> | undefined;
+    /** Migrate block data from any version to latest. Throws on failure. */
+    migrateBlockData: (versioned: DataVersioned<unknown>) => DataVersioned<unknown>;
+    /** Migrate each plugin's data. Return undefined to remove the plugin. Throws on failure. */
+    migratePluginData: (handle: PluginHandle, versioned: DataVersioned<unknown>) => DataVersioned<unknown> | undefined;
     /** The new plugin registry after migration (pluginId -> pluginName) */
     newPluginRegistry: PluginRegistry;
     /** Factory to create initial data for new plugins */
-    createPluginData: (pluginId: string) => DataVersioned<unknown>;
+    createPluginData: (handle: PluginHandle) => DataVersioned<unknown>;
 }
 /**
  * Performs atomic migration of block storage including block data and all plugins.
@@ -213,10 +214,13 @@ export declare function migrateBlockStorage(storage: BlockStorage<unknown>, conf
  * Gets plugin-specific data from block storage.
  * Accepts raw storage (any format) and normalizes internally.
  *
+ * When called with a typed PluginHandle<F>, the return type is automatically
+ * inferred from the factory's phantom `__types.data` field.
+ *
  * @param rawStorage - Raw block storage (may be legacy format or BlockStorage)
- * @param pluginId - The plugin instance id
- * @returns The plugin data
- * @throws If pluginId is not found in storage
+ * @param handle - The plugin handle (branded plugin instance id)
+ * @returns The plugin data, typed via factory inference
+ * @throws If plugin is not found in storage
  */
-export declare function getPluginData<TData = unknown>(rawStorage: unknown, pluginId: string): TData;
+export declare function getPluginData<F extends PluginFactoryLike>(rawStorage: unknown, handle: PluginHandle<F>): InferFactoryData<F>;
 //# sourceMappingURL=block_storage.d.ts.map

package/dist/block_storage.d.ts.map

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

package/dist/block_storage.js

@@ -25,7 +25,7 @@ const BLOCK_STORAGE_SCHEMA_VERSION = "v1";
  * Default data version for new blocks without migrations.
  * Unique identifier ensures blocks are created via DataModel API.
  */
-const DATA_MODEL_DEFAULT_VERSION = "__pl_v1_d4e8f2a1__";
+const DATA_MODEL_LEGACY_VERSION = "__pl_v1_d4e8f2a1__";
 /**
  * Type guard to check if a value is a valid BlockStorage object.
  * Checks for the discriminator key and valid schema version.
@@ -45,10 +45,10 @@ function isBlockStorage(value) {
  * Creates a BlockStorage with the given initial data
  *
  * @param initialData - The initial data value (defaults to empty object)
- * @param version - The initial data version key (defaults to DATA_MODEL_DEFAULT_VERSION)
+ * @param version - The initial data version key (defaults to DATA_MODEL_LEGACY_VERSION)
  * @returns A new BlockStorage instance with discriminator key
  */
-function createBlockStorage(initialData = {}, version = DATA_MODEL_DEFAULT_VERSION) {
+function createBlockStorage(initialData = {}, version = DATA_MODEL_LEGACY_VERSION) {
     return {
         [BLOCK_STORAGE_KEY]: BLOCK_STORAGE_SCHEMA_VERSION,
         __dataVersion: version,
@@ -72,7 +72,7 @@ function normalizeBlockStorage(raw) {
             ...storage,
             // Fix for early released version where __dataVersion was a number
             __dataVersion: typeof storage.__dataVersion === "number"
-                ? DATA_MODEL_DEFAULT_VERSION
+                ? DATA_MODEL_LEGACY_VERSION
                 : storage.__dataVersion,
             // Ensure plugin fields have defaults
             __pluginRegistry: storage.__pluginRegistry ?? {},
@@ -125,7 +125,7 @@ function updateStorageData(storage, payload) {
             const { pluginId, value } = payload;
             const currentPlugins = storage.__plugins ?? {};
             const existingEntry = currentPlugins[pluginId];
-            const version = existingEntry?.__dataVersion ?? DATA_MODEL_DEFAULT_VERSION;
+            const version = existingEntry?.__dataVersion ?? DATA_MODEL_LEGACY_VERSION;
             return {
                 ...storage,
                 __plugins: {
@@ -202,32 +202,33 @@ function migrateBlockStorage(storage, config) {
     const oldPlugins = storage.__plugins ?? {};
     const oldRegistry = storage.__pluginRegistry ?? {};
     const newPlugins = {};
-    for (const [pluginId, pluginName] of Object.entries(newPluginRegistry)) {
-        const existingEntry = oldPlugins[pluginId];
-        const existingName = oldRegistry[pluginId];
+    for (const [key, pluginName] of Object.entries(newPluginRegistry)) {
+        const handle = key;
+        const existingEntry = oldPlugins[handle];
+        const existingName = oldRegistry[handle];
         try {
             if (existingEntry && existingName === pluginName) {
                 // Plugin exists with same type - migrate its data
-                const migrated = migratePluginData(pluginId, {
+                const migrated = migratePluginData(handle, {
                     version: existingEntry.__dataVersion,
                     data: existingEntry.__data,
                 });
                 if (migrated) {
-                    newPlugins[pluginId] = { __dataVersion: migrated.version, __data: migrated.data };
+                    newPlugins[handle] = { __dataVersion: migrated.version, __data: migrated.data };
                 }
                 // If undefined returned, plugin is intentionally removed
             }
             else {
                 // New plugin or type changed - create with initial data
-                const initial = createPluginData(pluginId);
-                newPlugins[pluginId] = { __dataVersion: initial.version, __data: initial.data };
+                const initial = createPluginData(handle);
+                newPlugins[handle] = { __dataVersion: initial.version, __data: initial.data };
             }
         }
         catch (error) {
             return {
                 success: false,
                 error: error instanceof Error ? error.message : String(error),
-                failedAt: pluginId,
+                failedAt: handle,
             };
         }
     }
@@ -248,18 +249,21 @@ function migrateBlockStorage(storage, config) {
  * Gets plugin-specific data from block storage.
  * Accepts raw storage (any format) and normalizes internally.
  *
+ * When called with a typed PluginHandle<F>, the return type is automatically
+ * inferred from the factory's phantom `__types.data` field.
+ *
  * @param rawStorage - Raw block storage (may be legacy format or BlockStorage)
- * @param pluginId - The plugin instance id
- * @returns The plugin data
- * @throws If pluginId is not found in storage
+ * @param handle - The plugin handle (branded plugin instance id)
+ * @returns The plugin data, typed via factory inference
+ * @throws If plugin is not found in storage
  */
-function getPluginData(rawStorage, pluginId) {
+function getPluginData(rawStorage, handle) {
     const storage = normalizeBlockStorage(rawStorage);
-    const pluginEntry = storage.__plugins?.[pluginId];
+    const pluginEntry = storage.__plugins?.[handle];
     if (!pluginEntry)
-        throw new Error(`Plugin '${pluginId}' not found in block storage`);
+        throw new Error(`Plugin '${handle}' not found in block storage`);
     return pluginEntry.__data;
 }
 
-export { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION, DATA_MODEL_DEFAULT_VERSION, createBlockStorage, deriveDataFromStorage, getPluginData, getStorageData, isBlockStorage, migrateBlockStorage, normalizeBlockStorage, updateStorageData };
+export { BLOCK_STORAGE_KEY, BLOCK_STORAGE_SCHEMA_VERSION, DATA_MODEL_LEGACY_VERSION, createBlockStorage, deriveDataFromStorage, getPluginData, getStorageData, isBlockStorage, migrateBlockStorage, normalizeBlockStorage, updateStorageData };
 //# sourceMappingURL=block_storage.js.map