@milaboratories/pl-model-backend 1.2.29 → 1.3.0

package/dist/capabilities.cjs

@@ -0,0 +1,25 @@
+//#region src/capabilities.ts
+/**
+* Backend capability tokens advertised by pl in
+* `MaintenanceAPI.Ping.Response.capabilities` and required by compiled
+* templates via `TemplateDataV3.requiredCapabilities`.
+*
+* Single TypeScript source of truth shared across:
+*   - `@platforma-sdk/tengo-builder` — populates the field at compile time
+*   - `@platforma-sdk/block-tools` — copies it onto the published manifest
+*   - `@milaboratories/pl-middle-layer` — checks it at install time
+*
+* Mirror of `pl/platform/api/plapiserver/server_capabilities.go` — keep
+* tokens in sync with the backend's advertised list. Format is
+* `<feature>:<version>`; bump the version when wire semantics change.
+*/
+/**
+* Backend bundles a wasmtime-based WASI 0.2 / Component Model runtime.
+* Templates that reference wasm components via `assets.importWasm(...)`
+* require this capability.
+*/
+const CapabilityWasm = "wasm:v1";
+//#endregion
+exports.CapabilityWasm = CapabilityWasm;
+
+//# sourceMappingURL=capabilities.cjs.map

package/dist/capabilities.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.cjs","names":[],"sources":["../src/capabilities.ts"],"sourcesContent":["/**\n * Backend capability tokens advertised by pl in\n * `MaintenanceAPI.Ping.Response.capabilities` and required by compiled\n * templates via `TemplateDataV3.requiredCapabilities`.\n *\n * Single TypeScript source of truth shared across:\n *   - `@platforma-sdk/tengo-builder` — populates the field at compile time\n *   - `@platforma-sdk/block-tools` — copies it onto the published manifest\n *   - `@milaboratories/pl-middle-layer` — checks it at install time\n *\n * Mirror of `pl/platform/api/plapiserver/server_capabilities.go` — keep\n * tokens in sync with the backend's advertised list. Format is\n * `<feature>:<version>`; bump the version when wire semantics change.\n */\n\n/**\n * Backend bundles a wasmtime-based WASI 0.2 / Component Model runtime.\n * Templates that reference wasm components via `assets.importWasm(...)`\n * require this capability.\n */\nexport const CapabilityWasm = \"wasm:v1\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,iBAAiB"}

package/dist/capabilities.d.ts

@@ -0,0 +1,24 @@
+//#region src/capabilities.d.ts
+/**
+ * Backend capability tokens advertised by pl in
+ * `MaintenanceAPI.Ping.Response.capabilities` and required by compiled
+ * templates via `TemplateDataV3.requiredCapabilities`.
+ *
+ * Single TypeScript source of truth shared across:
+ *   - `@platforma-sdk/tengo-builder` — populates the field at compile time
+ *   - `@platforma-sdk/block-tools` — copies it onto the published manifest
+ *   - `@milaboratories/pl-middle-layer` — checks it at install time
+ *
+ * Mirror of `pl/platform/api/plapiserver/server_capabilities.go` — keep
+ * tokens in sync with the backend's advertised list. Format is
+ * `<feature>:<version>`; bump the version when wire semantics change.
+ */
+/**
+ * Backend bundles a wasmtime-based WASI 0.2 / Component Model runtime.
+ * Templates that reference wasm components via `assets.importWasm(...)`
+ * require this capability.
+ */
+declare const CapabilityWasm = "wasm:v1";
+//#endregion
+export { CapabilityWasm };
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","names":[],"sources":["../src/capabilities.ts"],"mappings":";;AAoBA;;;;;;;;;;;;;;;;;;cAAa,cAAA"}

package/dist/capabilities.js

@@ -0,0 +1,25 @@
+//#region src/capabilities.ts
+/**
+* Backend capability tokens advertised by pl in
+* `MaintenanceAPI.Ping.Response.capabilities` and required by compiled
+* templates via `TemplateDataV3.requiredCapabilities`.
+*
+* Single TypeScript source of truth shared across:
+*   - `@platforma-sdk/tengo-builder` — populates the field at compile time
+*   - `@platforma-sdk/block-tools` — copies it onto the published manifest
+*   - `@milaboratories/pl-middle-layer` — checks it at install time
+*
+* Mirror of `pl/platform/api/plapiserver/server_capabilities.go` — keep
+* tokens in sync with the backend's advertised list. Format is
+* `<feature>:<version>`; bump the version when wire semantics change.
+*/
+/**
+* Backend bundles a wasmtime-based WASI 0.2 / Component Model runtime.
+* Templates that reference wasm components via `assets.importWasm(...)`
+* require this capability.
+*/
+const CapabilityWasm = "wasm:v1";
+//#endregion
+export { CapabilityWasm };
+
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","names":[],"sources":["../src/capabilities.ts"],"sourcesContent":["/**\n * Backend capability tokens advertised by pl in\n * `MaintenanceAPI.Ping.Response.capabilities` and required by compiled\n * templates via `TemplateDataV3.requiredCapabilities`.\n *\n * Single TypeScript source of truth shared across:\n *   - `@platforma-sdk/tengo-builder` — populates the field at compile time\n *   - `@platforma-sdk/block-tools` — copies it onto the published manifest\n *   - `@milaboratories/pl-middle-layer` — checks it at install time\n *\n * Mirror of `pl/platform/api/plapiserver/server_capabilities.go` — keep\n * tokens in sync with the backend's advertised list. Format is\n * `<feature>:<version>`; bump the version when wire semantics change.\n */\n\n/**\n * Backend bundles a wasmtime-based WASI 0.2 / Component Model runtime.\n * Templates that reference wasm components via `assets.importWasm(...)`\n * require this capability.\n */\nexport const CapabilityWasm = \"wasm:v1\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,MAAa,iBAAiB"}

package/dist/index.cjs

@@ -1,6 +1,8 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_capabilities = require("./capabilities.cjs");
 const require_serde = require("./serde.cjs");
 const require_template_resources_v1 = require("./template_resources_v1.cjs");
+exports.CapabilityWasm = require_capabilities.CapabilityWasm;
 Object.defineProperty(exports, "PlTemplateLibV1", {
 	enumerable: true,
 	get: function() {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
+import { CapabilityWasm } from "./capabilities.js";
 import { TemplateAssetData, TemplateData, TemplateLibData, TemplateSoftwareData } from "./template_data_v2.js";
-import { CompiledTemplateV3, TemplateAssetDataV3, TemplateDataV3, TemplateLibDataV3, TemplateSoftwareDataV3 } from "./template_data_v3.js";
+import { CompiledTemplateV3, TemplateAssetDataV3, TemplateDataV3, TemplateLibDataV3, TemplateSoftwareDataV3, TemplateWasmDataV3 } from "./template_data_v3.js";
 import { parseTemplate, serializeTemplate } from "./serde.js";
 import { PlTemplateLibV1, PlTemplateOverrideV1, PlTemplateSoftwareV1, PlTemplateV1 } from "./template_resources_v1.js";
-export { CompiledTemplateV3, PlTemplateLibV1, PlTemplateOverrideV1, PlTemplateSoftwareV1, PlTemplateV1, TemplateAssetData, TemplateAssetDataV3, TemplateData, TemplateDataV3, TemplateLibData, TemplateLibDataV3, TemplateSoftwareData, TemplateSoftwareDataV3, parseTemplate, serializeTemplate };
+export { CapabilityWasm, CompiledTemplateV3, PlTemplateLibV1, PlTemplateOverrideV1, PlTemplateSoftwareV1, PlTemplateV1, TemplateAssetData, TemplateAssetDataV3, TemplateData, TemplateDataV3, TemplateLibData, TemplateLibDataV3, TemplateSoftwareData, TemplateSoftwareDataV3, TemplateWasmDataV3, parseTemplate, serializeTemplate };

package/dist/index.js

@@ -1,3 +1,4 @@
+import { CapabilityWasm } from "./capabilities.js";
 import { parseTemplate, serializeTemplate } from "./serde.js";
 import { PlTemplateLibV1, PlTemplateOverrideV1, PlTemplateSoftwareV1, PlTemplateV1 } from "./template_resources_v1.js";
-export { PlTemplateLibV1, PlTemplateOverrideV1, PlTemplateSoftwareV1, PlTemplateV1, parseTemplate, serializeTemplate };
+export { CapabilityWasm, PlTemplateLibV1, PlTemplateOverrideV1, PlTemplateSoftwareV1, PlTemplateV1, parseTemplate, serializeTemplate };

package/dist/template_data_v3.d.ts

@@ -23,6 +23,14 @@ interface TemplateAssetDataV3 {
   /** hash of the full contents of asset dependency description */
   sourceHash: string;
 }
+interface TemplateWasmDataV3 {
+  /** i.e. @milaboratories/pframes-rs-wasip2:main */
+  name: string;
+  /** i.e. 0.0.0 */
+  version: string;
+  /** sha256 of the base64-encoded wasm bytes stored in hashToSource */
+  sourceHash: string;
+}
 interface TemplateDataV3 {
   /** i.e. @milaboratory/some-package:template */
   name: string;
@@ -43,6 +51,27 @@ interface TemplateDataV3 {
   software: Record<string, TemplateSoftwareDataV3>;
   /** i.e. @milaboratory/genome:human -> the asset metadata */
   assets: Record<string, TemplateAssetDataV3>;
+  /** i.e. @milaboratories/pframes-rs-wasip2:main -> the wasm component metadata.
+   * The actual wasm bytes are base64-encoded and stored under sourceHash in the
+   * parent CompiledTemplateV3.hashToSource map. */
+  wasm?: Record<string, TemplateWasmDataV3>;
+  /**
+   * Backend capability tokens this template (and its transitively-imported
+   * sub-templates) requires to run. Populated by `tengo-builder` at compile
+   * time:
+   *   - `CapabilityWasm` ("wasm:v1") is added when a wasm artifact is
+   *     embedded (via `assets.importWasm`, directly or through a library).
+   *   - Child templates contribute their own `requiredCapabilities` —
+   *     unioned transitively, so the top template carries the full set.
+   *
+   * Consumers (`block-tools pack`, `pl-middle-layer` install gate,
+   * `pl-middle-layer` catalog listing) read this directly; the recursive
+   * tree walk that previously rediscovered the same fact at every
+   * consumer is gone. Tokens are the same vocabulary the backend
+   * advertises in `MaintenanceAPI.Ping.Response.capabilities` — see
+   * `./capabilities.ts`.
+   */
+  requiredCapabilities?: string[];
 }
 interface CompiledTemplateV3 {
   /** Discriminator for future use */
@@ -52,5 +81,5 @@ interface CompiledTemplateV3 {
   template: TemplateDataV3;
 }
 //#endregion
-export { CompiledTemplateV3, TemplateAssetDataV3, TemplateDataV3, TemplateLibDataV3, TemplateSoftwareDataV3 };
+export { CompiledTemplateV3, TemplateAssetDataV3, TemplateDataV3, TemplateLibDataV3, TemplateSoftwareDataV3, TemplateWasmDataV3 };
 //# sourceMappingURL=template_data_v3.d.ts.map

package/dist/template_data_v3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template_data_v3.d.ts","names":[],"sources":["../src/template_data_v3.ts"],"mappings":";UAAiB,iBAAA;EAAA;EAEf,IAAA;;EAEA,OAAA;EAFA;EAIA,UAAA;AAAA;AAAA,UAGe,sBAAA;EAHL;EAKV,IAAA;EAFqC;EAIrC,OAAA;EAJqC;EAMrC,UAAA;AAAA;AAAA,UAGe,mBAAA;EAHL;EAKV,IAAA;EAFe;EAIf,OAAA;;EAEA,UAAA;AAAA;AAAA,UAGe,cAAA;EAHf;EAKA,IAAA;EALU;EAOV,OAAA;EAJ6B;EAO7B,UAAA;EASqB;;;;EAHrB,YAAA;EAOU;EAJV,IAAA,EAAM,MAAA,SAAe,iBAAA;EAMb;EAJR,SAAA,EAAW,MAAA,SAAe,cAAA;EAIZ;EAFd,QAAA,EAAU,MAAA,SAAe,sBAAA;EAhBzB;EAkBA,MAAA,EAAQ,MAAA,SAAe,mBAAA;AAAA;AAAA,UAGR,kBAAA;EATT;EAWN,IAAA;EATA;EAYA,YAAA,EAAc,MAAA;EAEd,QAAA,EAAU,cAAA;AAAA"}
+{"version":3,"file":"template_data_v3.d.ts","names":[],"sources":["../src/template_data_v3.ts"],"mappings":";UAAiB,iBAAA;EAAA;EAEf,IAAA;;EAEA,OAAA;EAFA;EAIA,UAAA;AAAA;AAAA,UAGe,sBAAA;EAHL;EAKV,IAAA;EAFqC;EAIrC,OAAA;EAJqC;EAMrC,UAAA;AAAA;AAAA,UAGe,mBAAA;EAHL;EAKV,IAAA;EAFe;EAIf,OAAA;;EAEA,UAAA;AAAA;AAAA,UAGe,kBAAA;EAHf;EAKA,IAAA;EALU;EAOV,OAAA;EAJiC;EAMjC,UAAA;AAAA;AAAA,UAGe,cAAA;EALf;EAOA,IAAA;EALU;EAOV,OAAA;EAJe;EAOf,UAAA;;;;;EAMA,YAAA;EAOyB;EAJzB,IAAA,EAAM,MAAA,SAAe,iBAAA;EAME;EAJvB,SAAA,EAAW,MAAA,SAAe,cAAA;EAQJ;EANtB,QAAA,EAAU,MAAA,SAAe,sBAAA;EAMZ;EAJb,MAAA,EAAQ,MAAA,SAAe,mBAAA;EApBvB;;;EAwBA,IAAA,GAAO,MAAA,SAAe,kBAAA;EAVtB;;;;;;;;;;;;;;;;EA4BA,oBAAA;AAAA;AAAA,UAGe,kBAAA;EAAkB;EAEjC,IAAA;EAKwB;EAFxB,YAAA,EAAc,MAAA;EAEd,QAAA,EAAU,cAAA;AAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@milaboratories/pl-model-backend",
-  "version": "1.2.29",
+  "version": "1.3.0",
   "description": "Backend model for Platforma.bio",
   "files": [
     "./dist/**/*",
@@ -20,13 +20,15 @@
   "dependencies": {
     "canonicalize": "~2.1.0",
     "zod": "~3.25.76",
-    "@milaboratories/pl-client": "3.5.0"
+    "@milaboratories/pl-client": "3.7.0"
   },
   "devDependencies": {
     "@types/node": "~24.5.2",
+    "@vitest/coverage-istanbul": "^4.1.3",
     "typescript": "~5.9.3",
+    "vitest": "^4.1.3",
+    "@milaboratories/ts-builder": "1.5.0",
     "@milaboratories/build-configs": "2.0.0",
-    "@milaboratories/ts-builder": "1.4.0",
     "@milaboratories/ts-configs": "1.2.3"
   },
   "scripts": {
@@ -36,6 +38,7 @@
     "formatter:check": "ts-builder formatter --check",
     "linter:check": "ts-builder linter --check",
     "types:check": "ts-builder type-check --target node",
+    "test": "vitest run --coverage",
     "do-pack": "rm -f *.tgz && pnpm pack && mv *.tgz package.tgz",
     "fmt": "ts-builder format"
   }

package/src/capabilities.ts

@@ -0,0 +1,21 @@
+/**
+ * Backend capability tokens advertised by pl in
+ * `MaintenanceAPI.Ping.Response.capabilities` and required by compiled
+ * templates via `TemplateDataV3.requiredCapabilities`.
+ *
+ * Single TypeScript source of truth shared across:
+ *   - `@platforma-sdk/tengo-builder` — populates the field at compile time
+ *   - `@platforma-sdk/block-tools` — copies it onto the published manifest
+ *   - `@milaboratories/pl-middle-layer` — checks it at install time
+ *
+ * Mirror of `pl/platform/api/plapiserver/server_capabilities.go` — keep
+ * tokens in sync with the backend's advertised list. Format is
+ * `<feature>:<version>`; bump the version when wire semantics change.
+ */
+
+/**
+ * Backend bundles a wasmtime-based WASI 0.2 / Component Model runtime.
+ * Templates that reference wasm components via `assets.importWasm(...)`
+ * require this capability.
+ */
+export const CapabilityWasm = "wasm:v1";

package/src/index.ts

@@ -1,3 +1,4 @@
+export * from "./capabilities";
 export * from "./serde";
 export * from "./template_data_v2";
 export * from "./template_data_v3";

package/src/template_data_v3.ts

@@ -25,6 +25,15 @@ export interface TemplateAssetDataV3 {
   sourceHash: string;
 }
 
+export interface TemplateWasmDataV3 {
+  /** i.e. @milaboratories/pframes-rs-wasip2:main */
+  name: string;
+  /** i.e. 0.0.0 */
+  version: string;
+  /** sha256 of the base64-encoded wasm bytes stored in hashToSource */
+  sourceHash: string;
+}
+
 export interface TemplateDataV3 {
   /** i.e. @milaboratory/some-package:template */
   name: string;
@@ -48,6 +57,28 @@ export interface TemplateDataV3 {
   software: Record<string, TemplateSoftwareDataV3>;
   /** i.e. @milaboratory/genome:human -> the asset metadata */
   assets: Record<string, TemplateAssetDataV3>;
+  /** i.e. @milaboratories/pframes-rs-wasip2:main -> the wasm component metadata.
+   * The actual wasm bytes are base64-encoded and stored under sourceHash in the
+   * parent CompiledTemplateV3.hashToSource map. */
+  wasm?: Record<string, TemplateWasmDataV3>;
+
+  /**
+   * Backend capability tokens this template (and its transitively-imported
+   * sub-templates) requires to run. Populated by `tengo-builder` at compile
+   * time:
+   *   - `CapabilityWasm` ("wasm:v1") is added when a wasm artifact is
+   *     embedded (via `assets.importWasm`, directly or through a library).
+   *   - Child templates contribute their own `requiredCapabilities` —
+   *     unioned transitively, so the top template carries the full set.
+   *
+   * Consumers (`block-tools pack`, `pl-middle-layer` install gate,
+   * `pl-middle-layer` catalog listing) read this directly; the recursive
+   * tree walk that previously rediscovered the same fact at every
+   * consumer is gone. Tokens are the same vocabulary the backend
+   * advertises in `MaintenanceAPI.Ping.Response.capabilities` — see
+   * `./capabilities.ts`.
+   */
+  requiredCapabilities?: string[];
 }
 
 export interface CompiledTemplateV3 {