@openvtc/trust-tasks 0.28.17 → 0.28.19

package/src/vta/collection/settings/set/0.1/payload.ts

@@ -0,0 +1,319 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vta/collection/settings/set/0.1/payload.schema.json
+ */
+
+import type { CollectionSetting, ContextId_VtaCollectionV0_1 as ContextId, Did_NotificationsV0_1 as Did, Ext } from "../../../../../_shared/components.js";
+
+
+/**
+ * A client with administrative authority over a trust context enables or disables collection by default there: whether its VTA collects for the context's identifiers that no client has claimed (VTI-NTF-094, VTI-NTF-095). The VTA stores the setting, applies it before it answers — disabling it stops collection and closes the VTA's connections for those identifiers — and records the change in its audit trail (VTI-NTF-096). The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.
+ */
+export interface VTACollectionSettingsSetPayload {
+  /**
+   * The trust context whose setting to change. The change applies to that context's identifiers alone, not to its ancestors' or descendants' (VTI-NTF-094).
+   */
+  contextId: ContextId;
+  /**
+   * true to enable collection by default for the context, false to disable it.
+   */
+  collectByDefault: boolean;
+  ext?: Ext;
+}
+/**
+ * The context's setting once the change has taken effect.
+ */
+export interface VTACollectionSettingsSetResponsePayload {
+  setting: CollectionSetting;
+  /**
+   * Whether this request changed the setting. False when the context already held the value asked for, in which case nothing changed but the record of the request (VTI-NTF-095).
+   */
+  changed: boolean;
+}
+
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { CollectionSetting, ContextId, Did, Ext };
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/vta/collection/settings/set/0.1" as const;
+
+/**
+ * The earlier version of this specification that this one declares it
+ * extends (front matter `extends`, SPEC §5.2 "Declared extension"), or
+ * `null`. Only the direct declaration — follow the chain with
+ * `extendsChain` / `readForSpec`.
+ */
+export const EXTENDS: string | null = null;
+
+/**
+ * Why this version is deprecated, or `null` while it is current. A
+ * superseded or retired version is still supported, and is withdrawn from
+ * this package in a later scheduled batch (SPEC "Superseded and Withdrawn
+ * Versions").
+ */
+export const DEPRECATION: string | null = null;
+
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTACollectionSettingsSetPayload;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vta/collection/settings/set/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTACollectionSettingsSetResponsePayload;
+
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export const PAYLOAD_SCHEMA = {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trusttasks.org/spec/vta/collection/settings/set/0.1",
+  "title": "VTA Collection — Settings — Set — payload",
+  "description": "A client with administrative authority over a trust context enables or disables collection by default there: whether its VTA collects for the context's identifiers that no client has claimed (VTI-NTF-094, VTI-NTF-095). The VTA stores the setting, applies it before it answers — disabling it stops collection and closes the VTA's connections for those identifiers — and records the change in its audit trail (VTI-NTF-096). The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contextId",
+    "collectByDefault"
+  ],
+  "properties": {
+    "contextId": {
+      "$ref": "#/$defs/ContextId",
+      "description": "The trust context whose setting to change. The change applies to that context's identifiers alone, not to its ancestors' or descendants' (VTI-NTF-094)."
+    },
+    "collectByDefault": {
+      "type": "boolean",
+      "description": "true to enable collection by default for the context, false to disable it."
+    },
+    "ext": {
+      "$ref": "#/$defs/Ext"
+    }
+  },
+  "$defs": {
+    "Response": {
+      "$anchor": "response",
+      "title": "VTA Collection — Settings — Set — response payload",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "setting",
+        "changed"
+      ],
+      "description": "The context's setting once the change has taken effect.",
+      "properties": {
+        "setting": {
+          "$ref": "#/$defs/CollectionSetting"
+        },
+        "changed": {
+          "type": "boolean",
+          "description": "Whether this request changed the setting. False when the context already held the value asked for, in which case nothing changed but the record of the request (VTI-NTF-095)."
+        }
+      }
+    },
+    "CollectionSetting": {
+      "title": "CollectionSetting",
+      "description": "Whether the VTA collects by default for the identifiers of one trust context that no client has claimed (VTI-NTF-094 – VTI-NTF-098), and who last changed that. The VTA collects for them exactly when `collectByDefault` is true and `suspendedByOperator` is false. `changedBy` and `changedAt` are present together, and both absent while the setting has never been changed.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contextId",
+        "collectByDefault",
+        "suspendedByOperator"
+      ],
+      "properties": {
+        "contextId": {
+          "$ref": "#/$defs/ContextId",
+          "description": "The trust context the setting belongs to. It applies to that context's identifiers alone, not to its ancestors' or descendants' (VTI-NTF-094)."
+        },
+        "collectByDefault": {
+          "type": "boolean",
+          "description": "The context's own setting: true unless a party with administrative authority over the context has disabled it (VTI-NTF-094, VTI-NTF-095). The VTA keeps it across restarts."
+        },
+        "suspendedByOperator": {
+          "type": "boolean",
+          "description": "Whether the VTA's operator has suspended collection by default for every context (VTI-NTF-098). While true, the VTA collects for no unclaimed identifier here whatever `collectByDefault` says, and does not change it; once lifted, `collectByDefault` applies again. Always false at a VTA that offers its operator no suspension."
+        },
+        "changedBy": {
+          "$ref": "#/$defs/Did",
+          "description": "The subject of the access control entry that last changed `collectByDefault` (VTI-NTF-096)."
+        },
+        "changedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When `collectByDefault` was last changed."
+        }
+      },
+      "dependentSchemas": {
+        "changedBy": {
+          "required": [
+            "changedAt"
+          ]
+        },
+        "changedAt": {
+          "required": [
+            "changedBy"
+          ]
+        }
+      }
+    },
+    "Did": {
+      "title": "Did",
+      "description": "A DID.",
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 2048,
+      "pattern": "^did:[a-z0-9]+:\\S+$"
+    },
+    "ContextId": {
+      "title": "ContextId",
+      "description": "The trust context the identifier belongs to.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "Ext": {
+      "title": "Ext",
+      "description": "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.",
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+      }
+    }
+  }
+} as const;
+
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export const RESPONSE_PAYLOAD_SCHEMA = {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$ref": "#/$defs/Response",
+  "$defs": {
+    "Response": {
+      "$anchor": "response",
+      "title": "VTA Collection — Settings — Set — response payload",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "setting",
+        "changed"
+      ],
+      "description": "The context's setting once the change has taken effect.",
+      "properties": {
+        "setting": {
+          "$ref": "#/$defs/CollectionSetting"
+        },
+        "changed": {
+          "type": "boolean",
+          "description": "Whether this request changed the setting. False when the context already held the value asked for, in which case nothing changed but the record of the request (VTI-NTF-095)."
+        }
+      }
+    },
+    "CollectionSetting": {
+      "title": "CollectionSetting",
+      "description": "Whether the VTA collects by default for the identifiers of one trust context that no client has claimed (VTI-NTF-094 – VTI-NTF-098), and who last changed that. The VTA collects for them exactly when `collectByDefault` is true and `suspendedByOperator` is false. `changedBy` and `changedAt` are present together, and both absent while the setting has never been changed.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contextId",
+        "collectByDefault",
+        "suspendedByOperator"
+      ],
+      "properties": {
+        "contextId": {
+          "$ref": "#/$defs/ContextId",
+          "description": "The trust context the setting belongs to. It applies to that context's identifiers alone, not to its ancestors' or descendants' (VTI-NTF-094)."
+        },
+        "collectByDefault": {
+          "type": "boolean",
+          "description": "The context's own setting: true unless a party with administrative authority over the context has disabled it (VTI-NTF-094, VTI-NTF-095). The VTA keeps it across restarts."
+        },
+        "suspendedByOperator": {
+          "type": "boolean",
+          "description": "Whether the VTA's operator has suspended collection by default for every context (VTI-NTF-098). While true, the VTA collects for no unclaimed identifier here whatever `collectByDefault` says, and does not change it; once lifted, `collectByDefault` applies again. Always false at a VTA that offers its operator no suspension."
+        },
+        "changedBy": {
+          "$ref": "#/$defs/Did",
+          "description": "The subject of the access control entry that last changed `collectByDefault` (VTI-NTF-096)."
+        },
+        "changedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When `collectByDefault` was last changed."
+        }
+      },
+      "dependentSchemas": {
+        "changedBy": {
+          "required": [
+            "changedAt"
+          ]
+        },
+        "changedAt": {
+          "required": [
+            "changedBy"
+          ]
+        }
+      }
+    },
+    "Did": {
+      "title": "Did",
+      "description": "A DID.",
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 2048,
+      "pattern": "^did:[a-z0-9]+:\\S+$"
+    },
+    "ContextId": {
+      "title": "ContextId",
+      "description": "The trust context the identifier belongs to.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "Ext": {
+      "title": "Ext",
+      "description": "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.",
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+      }
+    }
+  }
+} as const;
+
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export const SPEC = {
+  typeUri: TYPE_URI,
+  isBearer: false,
+  isProofRequired: false,
+  isRecipientRequired: true,
+  isIssuedAtRequired: true,
+  payloadSchema: PAYLOAD_SCHEMA,
+} as const;
+
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export const RESPONSE_SPEC = {
+  typeUri: RESPONSE_TYPE_URI,
+  isBearer: false,
+  isProofRequired: false,
+  isRecipientRequired: true,
+  isIssuedAtRequired: true,
+  payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
+} as const;

package/src/vta/collection/settings/show/0.1/payload.ts

@@ -0,0 +1,296 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vta/collection/settings/show/0.1/payload.schema.json
+ */
+
+import type { CollectionSetting, ContextId_VtaCollectionV0_1 as ContextId, Did_NotificationsV0_1 as Did, Ext } from "../../../../../_shared/components.js";
+
+
+/**
+ * A client with standing in a trust context reads whether its VTA collects by default for that context's identifiers no client has claimed, who last changed that and when, and whether the VTA's operator has suspended collection by default for every context (VTI-NTF-096). The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.
+ */
+export interface VTACollectionSettingsShowPayload {
+  /**
+   * The trust context whose setting to read.
+   */
+  contextId: ContextId;
+  ext?: Ext;
+}
+/**
+ * The context's setting as the VTA holds and applies it.
+ */
+export interface VTACollectionSettingsShowResponsePayload {
+  setting: CollectionSetting;
+}
+
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { CollectionSetting, ContextId, Did, Ext };
+
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/vta/collection/settings/show/0.1" as const;
+
+/**
+ * The earlier version of this specification that this one declares it
+ * extends (front matter `extends`, SPEC §5.2 "Declared extension"), or
+ * `null`. Only the direct declaration — follow the chain with
+ * `extendsChain` / `readForSpec`.
+ */
+export const EXTENDS: string | null = null;
+
+/**
+ * Why this version is deprecated, or `null` while it is current. A
+ * superseded or retired version is still supported, and is withdrawn from
+ * this package in a later scheduled batch (SPEC "Superseded and Withdrawn
+ * Versions").
+ */
+export const DEPRECATION: string | null = null;
+
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTACollectionSettingsShowPayload;
+
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vta/collection/settings/show/0.1#response" as const;
+
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTACollectionSettingsShowResponsePayload;
+
+/**
+ * This specification's payload schema, as a value.
+ *
+ * SPEC.md §7.2 item 2 is performed against this. It is shipped as data
+ * rather than only as a `.json` file because TypeScript types are erased
+ * at runtime: without a schema a consumer has nothing to validate, and
+ * every REQUIRED payload member is optional in practice. Cross-file
+ * `$ref`s are already inlined, so it needs no resolver.
+ */
+export const PAYLOAD_SCHEMA = {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://trusttasks.org/spec/vta/collection/settings/show/0.1",
+  "title": "VTA Collection — Settings — Show — payload",
+  "description": "A client with standing in a trust context reads whether its VTA collects by default for that context's identifiers no client has claimed, who last changed that and when, and whether the VTA's operator has suspended collection by default for every context (VTI-NTF-096). The outer document members (id, type, issuer, recipient, issuedAt, expiresAt, proof) are owned by the framework — SPEC §6.3.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "contextId"
+  ],
+  "properties": {
+    "contextId": {
+      "$ref": "#/$defs/ContextId",
+      "description": "The trust context whose setting to read."
+    },
+    "ext": {
+      "$ref": "#/$defs/Ext"
+    }
+  },
+  "$defs": {
+    "Response": {
+      "$anchor": "response",
+      "title": "VTA Collection — Settings — Show — response payload",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "setting"
+      ],
+      "description": "The context's setting as the VTA holds and applies it.",
+      "properties": {
+        "setting": {
+          "$ref": "#/$defs/CollectionSetting"
+        }
+      }
+    },
+    "CollectionSetting": {
+      "title": "CollectionSetting",
+      "description": "Whether the VTA collects by default for the identifiers of one trust context that no client has claimed (VTI-NTF-094 – VTI-NTF-098), and who last changed that. The VTA collects for them exactly when `collectByDefault` is true and `suspendedByOperator` is false. `changedBy` and `changedAt` are present together, and both absent while the setting has never been changed.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contextId",
+        "collectByDefault",
+        "suspendedByOperator"
+      ],
+      "properties": {
+        "contextId": {
+          "$ref": "#/$defs/ContextId",
+          "description": "The trust context the setting belongs to. It applies to that context's identifiers alone, not to its ancestors' or descendants' (VTI-NTF-094)."
+        },
+        "collectByDefault": {
+          "type": "boolean",
+          "description": "The context's own setting: true unless a party with administrative authority over the context has disabled it (VTI-NTF-094, VTI-NTF-095). The VTA keeps it across restarts."
+        },
+        "suspendedByOperator": {
+          "type": "boolean",
+          "description": "Whether the VTA's operator has suspended collection by default for every context (VTI-NTF-098). While true, the VTA collects for no unclaimed identifier here whatever `collectByDefault` says, and does not change it; once lifted, `collectByDefault` applies again. Always false at a VTA that offers its operator no suspension."
+        },
+        "changedBy": {
+          "$ref": "#/$defs/Did",
+          "description": "The subject of the access control entry that last changed `collectByDefault` (VTI-NTF-096)."
+        },
+        "changedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When `collectByDefault` was last changed."
+        }
+      },
+      "dependentSchemas": {
+        "changedBy": {
+          "required": [
+            "changedAt"
+          ]
+        },
+        "changedAt": {
+          "required": [
+            "changedBy"
+          ]
+        }
+      }
+    },
+    "Did": {
+      "title": "Did",
+      "description": "A DID.",
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 2048,
+      "pattern": "^did:[a-z0-9]+:\\S+$"
+    },
+    "ContextId": {
+      "title": "ContextId",
+      "description": "The trust context the identifier belongs to.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "Ext": {
+      "title": "Ext",
+      "description": "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.",
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+      }
+    }
+  }
+} as const;
+
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export const RESPONSE_PAYLOAD_SCHEMA = {
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$ref": "#/$defs/Response",
+  "$defs": {
+    "Response": {
+      "$anchor": "response",
+      "title": "VTA Collection — Settings — Show — response payload",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "setting"
+      ],
+      "description": "The context's setting as the VTA holds and applies it.",
+      "properties": {
+        "setting": {
+          "$ref": "#/$defs/CollectionSetting"
+        }
+      }
+    },
+    "CollectionSetting": {
+      "title": "CollectionSetting",
+      "description": "Whether the VTA collects by default for the identifiers of one trust context that no client has claimed (VTI-NTF-094 – VTI-NTF-098), and who last changed that. The VTA collects for them exactly when `collectByDefault` is true and `suspendedByOperator` is false. `changedBy` and `changedAt` are present together, and both absent while the setting has never been changed.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "contextId",
+        "collectByDefault",
+        "suspendedByOperator"
+      ],
+      "properties": {
+        "contextId": {
+          "$ref": "#/$defs/ContextId",
+          "description": "The trust context the setting belongs to. It applies to that context's identifiers alone, not to its ancestors' or descendants' (VTI-NTF-094)."
+        },
+        "collectByDefault": {
+          "type": "boolean",
+          "description": "The context's own setting: true unless a party with administrative authority over the context has disabled it (VTI-NTF-094, VTI-NTF-095). The VTA keeps it across restarts."
+        },
+        "suspendedByOperator": {
+          "type": "boolean",
+          "description": "Whether the VTA's operator has suspended collection by default for every context (VTI-NTF-098). While true, the VTA collects for no unclaimed identifier here whatever `collectByDefault` says, and does not change it; once lifted, `collectByDefault` applies again. Always false at a VTA that offers its operator no suspension."
+        },
+        "changedBy": {
+          "$ref": "#/$defs/Did",
+          "description": "The subject of the access control entry that last changed `collectByDefault` (VTI-NTF-096)."
+        },
+        "changedAt": {
+          "type": "string",
+          "format": "date-time",
+          "description": "When `collectByDefault` was last changed."
+        }
+      },
+      "dependentSchemas": {
+        "changedBy": {
+          "required": [
+            "changedAt"
+          ]
+        },
+        "changedAt": {
+          "required": [
+            "changedBy"
+          ]
+        }
+      }
+    },
+    "Did": {
+      "title": "Did",
+      "description": "A DID.",
+      "type": "string",
+      "minLength": 8,
+      "maxLength": 2048,
+      "pattern": "^did:[a-z0-9]+:\\S+$"
+    },
+    "ContextId": {
+      "title": "ContextId",
+      "description": "The trust context the identifier belongs to.",
+      "type": "string",
+      "minLength": 1,
+      "maxLength": 256
+    },
+    "Ext": {
+      "title": "Ext",
+      "description": "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.",
+      "type": "object",
+      "minProperties": 1,
+      "additionalProperties": true,
+      "propertyNames": {
+        "pattern": "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$"
+      }
+    }
+  }
+} as const;
+
+/**
+ * SPEC.md §7.2 policy for the request variant, from this specification's
+ * front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
+ * per-specification and cannot be derived from the document alone, and
+ * item 2 needs the schema this carries.
+ */
+export const SPEC = {
+  typeUri: TYPE_URI,
+  isBearer: false,
+  isProofRequired: false,
+  isRecipientRequired: true,
+  isIssuedAtRequired: false,
+  payloadSchema: PAYLOAD_SCHEMA,
+} as const;
+
+/**
+ * SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
+ * tracks the *issuer* party's requirement because a response swaps the
+ * parties (§7.3 item 5).
+ */
+export const RESPONSE_SPEC = {
+  typeUri: RESPONSE_TYPE_URI,
+  isBearer: false,
+  isProofRequired: false,
+  isRecipientRequired: true,
+  isIssuedAtRequired: false,
+  payloadSchema: RESPONSE_PAYLOAD_SCHEMA,
+} as const;

package/src/vtc/badges/_shared/0.1/badge.ts

@@ -0,0 +1,23 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/badges/_shared/0.1/badge.schema.json
+ */
+
+/**
+ * A Verifiable Trust Community's badges (VTI Community Badges chapter, VTI-BDG-*): pictures with a name that a member earns, holds and shows on their directory card. Not itself a Trust Task specification (the `_shared` folder is skipped by the registry build and the codegen).
+ *
+ * A COMMUNITY BADGE IS A BADGE GROUP. A badge of kind `community` is backed by exactly one community group (vtc/groups/*), referenced by `groupId` here and by `badgeId` on the group: its owners are the group's managers, its holders the group's members, and the group's own DID issues its holders the badge credential (VTI-BDG-010, VTI-BDG-011, VTI-BDG-060). A badge group never carries authority (VTI-BDG-012). A badge of kind `kudos` has no group and no credential (VTI-BDG-041).
+ *
+ * AN AWARD IS AN OFFER UNTIL ACCEPTED. Giving a badge records an award in state `offered`; nothing is admitted, issued or shown until the recipient accepts (VTI-BDG-020, VTI-BDG-021). Each giving of a repeatable or kudos badge is an award of its own (VTI-BDG-022, VTI-BDG-041).
+ *
+ * BADGES CONFER NOTHING. The community never reads a badge, an award or a badge credential in an authorization decision (VTI-BDG-002).
+ */
+export interface BadgeSharedDefinitionsForTheVtcBadgesSpecFamily {
+  [k: string]: unknown | undefined;
+}
+
+/**
+ * The definitions this shared schema publishes, hoisted to one declaration each.
+ * See "../../../../_shared/components.js".
+ */
+export type { Award, AwardId, AwardNote, AwardState, Badge, BadgeCriteria, BadgeDescription, BadgeId, BadgeKind, BadgeLimits, BadgeName, BadgeSettings, BadgeState, KudosMakers, MyBadge, WallEntry, WallVisibility } from "../../../../_shared/components.js";