@openvtc/trust-tasks 0.14.2 → 0.16.0

package/src/vta/did-templates/list/2.0/payload.ts

@@ -3,10 +3,8 @@
  * Source: specs/vta/did-templates/list/2.0/payload.schema.json
  */
 
-/**
- * Resolved scope of the stored template.
- */
-export type Scope = Builtin | Global | Context;
+import type { Builtin_VtaV0_1 as Builtin, Context_VtaV0_1 as Context, DidTemplateRecord, Ext, Global_VtaV0_1 as Global, Scope_VtaV0_1 as Scope } from "../../../../_shared/components.js";
+
 
 /**
  * List the DID templates in one scope on a VTA. Omit `contextId` to list the global templates (any authenticated caller); set it to list the templates scoped to that context (requires access to the context). The success response is the array of persisted DidTemplateRecords for the selected scope.
@@ -16,14 +14,11 @@ export interface VTADIDTemplateListPayload {
    * Scope selector. Absent: the global scope. Present: the context whose templates are listed; the caller MUST have access to that context.
    */
   contextId?: string;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
   ext?: Ext;
 }
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
 /**
  * Every stored template in the selected scope, in an array.
  */
@@ -32,56 +27,15 @@ export interface VTADIDTemplateListResponsePayload {
    * Every stored template in the selected scope, sorted by name; empty when none exist.
    */
   templates: DidTemplateRecord[];
-  ext?: Ext1;
-}
-/**
- * A persisted template. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by get/create/update and carried per-item by list.
- */
-export interface DidTemplateRecord {
-  schemaVersion: 1;
-  name: string;
-  kind: string;
-  description?: string | null;
-  methods?: string[];
-  requiredVars?: string[];
-  optionalVars?: {
-    [k: string]: unknown | undefined;
-  };
-  defaults?: {
-    [k: string]: unknown | undefined;
-  };
-  document: {};
-  scope: Scope;
-  /**
-   * UTC unix-epoch seconds the template was first stored.
-   */
-  createdAt: number;
   /**
-   * UTC unix-epoch seconds of the last write.
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
    */
-  updatedAt: number;
-  /**
-   * DID of the admin who last wrote the template.
-   */
-  createdBy: string;
-}
-export interface Builtin {
-  type: "builtin";
-}
-export interface Global {
-  type: "global";
-}
-export interface Context {
-  type: "context";
-  contextId: string;
-}
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext1 {
-  [k: string]: unknown | undefined;
+  ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Builtin, Context, DidTemplateRecord, Ext, Global, Scope };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/did-templates/list/2.0" as const;
 
@@ -189,7 +143,8 @@ export const PAYLOAD_SCHEMA = {
           "type": [
             "string",
             "null"
-          ]
+          ],
+          "maxLength": 1024
         },
         "methods": {
           "type": "array",
@@ -358,7 +313,8 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": [
             "string",
             "null"
-          ]
+          ],
+          "maxLength": 1024
         },
         "methods": {
           "type": "array",
@@ -466,6 +422,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: false,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -479,5 +436,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: false,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;

package/src/vta/did-templates/render/1.0/payload.ts

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/render/1.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Render a global DID template to a DID document. Authenticated callers supply variables; the VTA injects ambient variables (VTA_DID, VTA_URL, NOW) server-side, merges the caller's on top, substitutes every placeholder, and returns the rendered document.
  */
@@ -17,14 +20,11 @@ export interface VTADIDTemplateRenderPayload {
   vars?: {
     [k: string]: unknown | undefined;
   };
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
   ext?: Ext;
 }
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
 /**
  * The rendered DID document.
  */
@@ -33,15 +33,15 @@ export interface VTADIDTemplateRenderResponsePayload {
    * The rendered DID document with all placeholders substituted.
    */
   document: {};
-  ext?: Ext1;
-}
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext1 {
-  [k: string]: unknown | undefined;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
+  ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/did-templates/render/1.0" as const;
 
@@ -173,6 +173,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -186,5 +187,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;

package/src/vta/did-templates/render/2.0/payload.ts

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/render/2.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Render a DID template to a DID document. Omit `contextId` to render a global template; set it to render a template scoped to that context (requires access to the context; the VTA MAY fall back to a global template of the same name). Callers supply variables; the VTA injects ambient variables (VTA_DID, VTA_URL, NOW — plus CONTEXT_ID and, if set on the context, CONTEXT_DID when contextId is present) server-side, merges the caller's on top, substitutes every placeholder, and returns the rendered document.
  */
@@ -21,14 +24,11 @@ export interface VTADIDTemplateRenderPayload {
   vars?: {
     [k: string]: unknown | undefined;
   };
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
   ext?: Ext;
 }
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
 /**
  * The rendered DID document.
  */
@@ -37,15 +37,15 @@ export interface VTADIDTemplateRenderResponsePayload {
    * The rendered DID document with all placeholders substituted.
    */
   document: {};
-  ext?: Ext1;
-}
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext1 {
-  [k: string]: unknown | undefined;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
+  ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/did-templates/render/2.0" as const;
 
@@ -182,6 +182,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: false,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -195,5 +196,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: false,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;

package/src/vta/did-templates/update/1.0/payload.ts

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/update/1.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Resolved scope of the stored template.
  */
@@ -17,6 +20,9 @@ export interface VTADIDTemplateUpdatePayload {
    */
   name: string;
   template: DidTemplate;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
   ext?: Ext;
 }
 /**
@@ -64,12 +70,6 @@ export interface DidTemplate {
    */
   document: {};
 }
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
 /**
  * The persisted DidTemplateRecord. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by create/get.
  */
@@ -112,6 +112,9 @@ export interface Context {
   contextId: string;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/did-templates/update/1.0" as const;
 
@@ -592,6 +595,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -605,5 +609,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: false,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;

package/src/vta/did-templates/update/2.0/payload.ts

@@ -3,10 +3,8 @@
  * Source: specs/vta/did-templates/update/2.0/payload.schema.json
  */
 
-/**
- * Resolved scope of the stored template.
- */
-export type Scope = Builtin | Global | Context;
+import type { Builtin_VtaV0_1 as Builtin, Context_VtaV0_1 as Context, DidTemplate, DidTemplateRecord, Ext, Global_VtaV0_1 as Global, Scope_VtaV0_1 as Scope } from "../../../../_shared/components.js";
+
 
 /**
  * Replace an existing DID template on a VTA. Omit `contextId` to replace in the global scope (super-admin gated); set it to replace a template scoped to that context (gated on the context's admin, or a super-admin). The `name` is the resource id within the selected scope and MUST equal `template.name`; the VTA replaces the stored body, preserving createdAt/createdBy and advancing updatedAt. The success response is the persisted DidTemplateRecord.
@@ -20,102 +18,19 @@ export interface VTADIDTemplateUpdatePayload {
    * Resource id — the template's name within the selected scope. MUST equal `template.name` or the VTA rejects with the framework's `malformedRequest`.
    */
   name: string;
-  template: DidTemplate;
-  ext?: Ext;
-}
-/**
- * Full replacement template document. Validated against the v1 template schema before persistence; an invalid shape is rejected with the framework's `malformedRequest`.
- */
-export interface DidTemplate {
-  /**
-   * Template schema version. Currently always 1.
-   */
-  schemaVersion: 1;
-  /**
-   * Template id within its scope. Lowercase alphanumeric and hyphen only.
-   */
-  name: string;
-  /**
-   * Classification hint, e.g. `mediator`, `did-host-http`, `app`. Drives downstream provisioning behaviour.
-   */
-  kind: string;
-  /**
-   * Human-readable description of what the template provisions.
-   */
-  description?: string | null;
-  /**
-   * DID methods this template targets, e.g. ["webvh", "web"] for a hosted DID or ["key"] for a did:key.
-   */
-  methods?: string[];
-  /**
-   * Variables the caller MUST supply at render time. MUST NOT include reserved ambient names (DID, SIGNING_KEY_MB, KA_KEY_MB, VTA_DID, VTA_URL, CONTEXT_ID, CONTEXT_DID, NOW).
-   */
-  requiredVars?: string[];
-  /**
-   * Variables with default values, keyed by variable name.
-   */
-  optionalVars?: {
-    [k: string]: unknown | undefined;
-  };
-  /**
-   * Hints for CLI / setup wizards (e.g. preRotationCount, portable, addMediatorService).
-   */
-  defaults?: {
-    [k: string]: unknown | undefined;
-  };
-  /**
-   * The DID document body with `{TOKEN}` placeholders. `document.id` MUST contain the `{DID}` placeholder. Every `{TOKEN}` MUST be declared in requiredVars/optionalVars or be a reserved ambient name.
-   */
-  document: {};
-}
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
-/**
- * A persisted template. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by get/create/update and carried per-item by list.
- */
-export interface DidTemplateRecord {
-  schemaVersion: 1;
-  name: string;
-  kind: string;
-  description?: string | null;
-  methods?: string[];
-  requiredVars?: string[];
-  optionalVars?: {
-    [k: string]: unknown | undefined;
-  };
-  defaults?: {
-    [k: string]: unknown | undefined;
-  };
-  document: {};
-  scope: Scope;
-  /**
-   * UTC unix-epoch seconds the template was first stored.
-   */
-  createdAt: number;
   /**
-   * UTC unix-epoch seconds of the last write.
+   * Full replacement template document. Validated against the v1 template schema before persistence; an invalid shape is rejected with the framework's `malformedRequest`.
    */
-  updatedAt: number;
+  template: DidTemplate;
   /**
-   * DID of the admin who last wrote the template.
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
    */
-  createdBy: string;
-}
-export interface Builtin {
-  type: "builtin";
-}
-export interface Global {
-  type: "global";
-}
-export interface Context {
-  type: "context";
-  contextId: string;
+  ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Builtin, Context, DidTemplate, DidTemplateRecord, Ext, Global, Scope };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/did-templates/update/2.0" as const;
 
@@ -209,7 +124,8 @@ export const PAYLOAD_SCHEMA = {
           "type": [
             "string",
             "null"
-          ]
+          ],
+          "maxLength": 1024
         },
         "methods": {
           "type": "array",
@@ -347,6 +263,7 @@ export const PAYLOAD_SCHEMA = {
             "string",
             "null"
           ],
+          "maxLength": 1024,
           "description": "Human-readable description of what the template provisions."
         },
         "methods": {
@@ -427,7 +344,8 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
           "type": [
             "string",
             "null"
-          ]
+          ],
+          "maxLength": 1024
         },
         "methods": {
           "type": "array",
@@ -565,6 +483,7 @@ export const RESPONSE_PAYLOAD_SCHEMA = {
             "string",
             "null"
           ],
+          "maxLength": 1024,
           "description": "Human-readable description of what the template provisions."
         },
         "methods": {
@@ -611,6 +530,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -624,5 +544,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;

package/src/vta/memory/delete/0.1/payload.ts

@@ -3,6 +3,9 @@
  * Source: specs/vta/memory/delete/0.1/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 export interface VTAMemoryDeletePayload {
   /**
    * The VTA context the item lives in.
@@ -14,12 +17,6 @@ export interface VTAMemoryDeletePayload {
   key: string;
   ext?: Ext;
 }
-/**
- * Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
 /**
  * Success response to vta/memory/delete. Type https://trusttasks.org/spec/vta/memory/delete/0.1#response.
  */
@@ -31,6 +28,9 @@ export interface VTAMemoryDeleteResponsePayload {
   ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/memory/delete/0.1" as const;
 
@@ -156,6 +156,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -169,5 +170,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;

package/src/vta/memory/list/0.1/payload.ts

@@ -3,6 +3,9 @@
  * Source: specs/vta/memory/list/0.1/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 export interface VTAMemoryListPayload {
   /**
    * The VTA context whose memory items to recall.
@@ -10,12 +13,6 @@ export interface VTAMemoryListPayload {
   contextId: string;
   ext?: Ext;
 }
-/**
- * Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
 /**
  * Success response to vta/memory/list. Type https://trusttasks.org/spec/vta/memory/list/0.1#response.
  */
@@ -30,6 +27,9 @@ export interface VTAMemoryListResponsePayload {
   ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/memory/list/0.1" as const;
 
@@ -182,6 +182,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: false,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -195,5 +196,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;

package/src/vta/memory/put/0.1/payload.ts

@@ -3,6 +3,9 @@
  * Source: specs/vta/memory/put/0.1/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 export interface VTAMemoryPutPayload {
   /**
    * The VTA context the memory item is scoped to (the isolation boundary).
@@ -16,14 +19,11 @@ export interface VTAMemoryPutPayload {
    * Opaque memory text (a fact, summary, or preference).
    */
   value: string;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
   ext?: Ext;
 }
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
 /**
  * Success response to vta/memory/put. Type https://trusttasks.org/spec/vta/memory/put/0.1#response.
  */
@@ -32,15 +32,12 @@ export interface VTAMemoryPutResponsePayload {
    * The stored item's key.
    */
   key: string;
-  ext?: Ext1;
-}
-/**
- * Vendor-namespaced extension object per SPEC.md §4.5.1. Each immediate key MUST be a reverse-DNS namespace; structure under each namespace is opaque to the framework.
- */
-export interface Ext1 {
-  [k: string]: unknown | undefined;
+  ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Ext };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/memory/put/0.1" as const;
 
@@ -172,6 +169,7 @@ export const SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: PAYLOAD_SCHEMA,
 } as const;
 
@@ -185,5 +183,6 @@ export const RESPONSE_SPEC = {
   isBearer: false,
   isProofRequired: true,
   isRecipientRequired: true,
+  isIssuedAtRequired: true,
   payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
 } as const;