@openvtc/trust-tasks 0.14.1 → 0.15.0

package/src/vta/credentials/issue/0.2/payload.ts

@@ -3,16 +3,15 @@
  * Source: specs/vta/credentials/issue/0.2/payload.schema.json
  */
 
+import type { CredentialId, Ext, IssuedCredentialBase } from "../../../../_shared/components.js";
+
+
 /**
  * The success response to a vta/credentials/issue request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vta/credentials/issue/0.1#response.
  *
  * Composed from the shared IssuedCredential rather than restating it: that definition is the issuance receipt every issuer returns, and duplicating it here let the two drift silently. `unevaluatedProperties` closes the object after the `allOf` is applied, which is what makes the composition possible at all — `additionalProperties` is evaluated per-subschema against the whole object and would reject `supersedes` and `ext`.
  */
 export type VTACredentialsIssueResponsePayload = IssuedCredentialBase;
-/**
- * Stable identifier for an issued credential — the handle for revocation and audit. Opaque to the holder: it MUST be echoed verbatim when revoking and MUST NOT be parsed.
- */
-export type CredentialId = string;
 
 export interface VTACredentialsIssuePayload {
   /**
@@ -35,35 +34,15 @@ export interface VTACredentialsIssuePayload {
    * Optional human-readable rationale, recorded for audit.
    */
   purpose?: string;
-  ext?: Ext;
-}
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext {
-  [k: string]: unknown | undefined;
-}
-/**
- * The members of an issuance receipt, deliberately left **open** so a consuming specification can `$ref` it under `allOf` and add its own, then close the result with `unevaluatedProperties: false`.
- *
- * A closure inside this definition would defeat that. Both `additionalProperties` and `unevaluatedProperties` are evaluated against the whole instance from within the subschema that declares them, and neither can see members the *outer* schema matched — so either one here rejects the consumer's extras. Only an `unevaluatedProperties` at the outer level sees everything the composition matched. Use `IssuedCredential` where a closed standalone shape is wanted.
- */
-export interface IssuedCredentialBase {
-  credentialId: CredentialId;
-  /**
-   * The issued Verifiable Credential (W3C VC Data Model 2.0), signed by the issuer's key. Opaque to the framework.
-   */
-  credential: {};
   /**
-   * When the credential was minted.
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
    */
-  issuedAt?: string;
-  /**
-   * When the credential's validUntil falls due.
-   */
-  expiresAt: string;
+  ext?: Ext;
 }
 
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { CredentialId, Ext, IssuedCredentialBase };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/credentials/issue/0.2" as const;
 

package/src/vta/credentials/revoke/0.1/payload.ts

@@ -3,34 +3,28 @@
  * Source: specs/vta/credentials/revoke/0.1/payload.schema.json
  */
 
-/**
- * The id of the credential to revoke (as returned by vta/credentials/issue).
- */
-export type CredentialId = string;
-/**
- * Stable identifier for an issued credential — the handle for revocation and audit. Opaque to the holder: it MUST be echoed verbatim when revoking and MUST NOT be parsed.
- */
-export type CredentialId1 = string;
+import type { CredentialId, Ext } from "../../../../_shared/components.js";
+
 
 export interface VTACredentialsRevokePayload {
+  /**
+   * The id of the credential to revoke (as returned by vta/credentials/issue).
+   */
   credentialId: CredentialId;
   /**
    * Optional human-readable rationale, recorded for audit.
    */
   reason?: 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;
-}
 /**
  * The success response to a vta/credentials/revoke request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vta/credentials/revoke/0.1#response.
  */
 export interface VTACredentialsRevokeResponsePayload {
-  credentialId: CredentialId1;
+  credentialId: CredentialId;
   /**
    * When the revocation was recorded.
    */
@@ -39,15 +33,15 @@ export interface VTACredentialsRevokeResponsePayload {
    * When the revoked credential carried a credentialStatus entry (claims-profile credentials such as GovernancePolicyCredential), the published status-list index whose bit was flipped — so the caller can confirm the externally-visible effect. Absent for credentials without published status.
    */
   statusListIndex?: number;
-  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 { CredentialId, Ext };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/credentials/revoke/0.1" as const;
 

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

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/create/1.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Resolved scope of the stored template.
  */
@@ -13,6 +16,9 @@ export type Scope = Builtin | Global | Context;
  */
 export interface VTADIDTemplateCreatePayload {
   template: DidTemplate;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
   ext?: Ext;
 }
 /**
@@ -60,12 +66,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 get/update.
  */
@@ -108,6 +108,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/create/1.0" as const;
 

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

@@ -3,10 +3,8 @@
  * Source: specs/vta/did-templates/create/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";
+
 
 /**
  * Create a new DID template on a VTA. Omit `contextId` to create in the global scope (super-admin gated); set it to create a template scoped to that context (gated on the context's admin, or a super-admin). The template's own `name` is the resource id within the selected scope; the VTA refuses duplicates (use update to replace). The success response is the persisted DidTemplateRecord.
@@ -16,102 +14,19 @@ export interface VTADIDTemplateCreatePayload {
    * Scope selector. Absent: the global scope, gated on a super-administrator. Present: the context the template is scoped to, gated on that context's administrator (or a super-administrator).
    */
   contextId?: string;
-  template: DidTemplate;
-  ext?: Ext;
-}
-/**
- * Full template document to store. 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.
+   * Full template document to store. Validated against the v1 template schema before persistence; an invalid shape is rejected with the framework's `malformedRequest`.
    */
-  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.
-   */
-  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/create/2.0" as const;
 

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

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/delete/1.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Remove a global DID template from a VTA by name. Super-admin gated. The success response echoes the deleted name for audit pipelines.
  */
@@ -11,14 +14,11 @@ export interface VTADIDTemplateDeletePayload {
    * Resource id — the name of the global template to remove.
    */
   name: 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;
-}
 /**
  * Confirmation that the named global template was removed.
  */
@@ -31,15 +31,15 @@ export interface VTADIDTemplateDeleteResponsePayload {
    * Always true on success.
    */
   deleted: boolean;
-  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/delete/1.0" as const;
 

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

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/delete/2.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Remove a DID template from a VTA by name. Omit `contextId` to remove from the global scope (super-admin gated); set it to remove a template scoped to that context (gated on the context's admin, or a super-admin). The success response echoes the deleted name for audit pipelines.
  */
@@ -15,14 +18,11 @@ export interface VTADIDTemplateDeletePayload {
    * Resource id — the name of the template to remove within the selected scope.
    */
   name: 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;
-}
 /**
  * Confirmation that the named template was removed from the selected scope.
  */
@@ -35,15 +35,15 @@ export interface VTADIDTemplateDeleteResponsePayload {
    * Always true on success.
    */
   deleted: boolean;
-  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/delete/2.0" as const;
 

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

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/get/1.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Resolved scope of the stored template.
  */
@@ -16,14 +19,11 @@ export interface VTADIDTemplateGetPayload {
    * Template name to fetch.
    */
   name: 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;
-}
 /**
  * The persisted DidTemplateRecord. The DidTemplate fields are flattened at the top level alongside the resolved scope and provenance metadata. Same shape returned by create/update.
  */
@@ -66,6 +66,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/get/1.0" as const;
 

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

@@ -3,10 +3,8 @@
  * Source: specs/vta/did-templates/get/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";
+
 
 /**
  * Fetch one DID template on a VTA by name. Omit `contextId` to read from the global scope (any authenticated caller); set it to read a template scoped to that context (requires access to the context). The success response is the persisted DidTemplateRecord.
@@ -20,56 +18,15 @@ export interface VTADIDTemplateGetPayload {
    * Template name to fetch within the selected scope.
    */
   name: string;
-  ext?: Ext;
-}
-/**
- * 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.
-   */
-  updatedAt: number;
   /**
-   * 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, DidTemplateRecord, Ext, Global, Scope };
+
 /** Trust Task type URI. */
 export const TYPE_URI = "https://trusttasks.org/spec/vta/did-templates/get/2.0" as const;
 

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

@@ -3,6 +3,9 @@
  * Source: specs/vta/did-templates/list/1.0/payload.schema.json
  */
 
+import type { Ext } from "../../../../_shared/components.js";
+
+
 /**
  * Resolved scope of the stored template.
  */
@@ -12,14 +15,11 @@ export type Scope = Builtin | Global | Context;
  * List all global DID templates on a VTA. Open to any authenticated caller. The request takes no parameters. The success response is the array of persisted DidTemplateRecords.
  */
 export interface VTADIDTemplateListPayload {
+  /**
+   * 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 global template, in an array.
  */
@@ -28,7 +28,10 @@ export interface VTADIDTemplateListResponsePayload {
    * Every stored global template, sorted by name; empty when none exist.
    */
   templates: DidTemplateRecord[];
-  ext?: Ext1;
+  /**
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
+   */
+  ext?: Ext;
 }
 /**
  * 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.
@@ -71,12 +74,9 @@ export interface Context {
   type: "context";
   contextId: string;
 }
-/**
- * Ecosystem-defined extension members per SPEC.md §4.5.1.
- */
-export interface Ext1 {
-  [k: string]: unknown | undefined;
-}
+
+/** 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/list/1.0" as const;

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.
+   * Ecosystem-defined extension members per SPEC.md §4.5.1.
    */
-  createdAt: number;
-  /**
-   * UTC unix-epoch seconds of the last write.
-   */
-  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;