@openvtc/trust-tasks 0.22.5 → 0.22.7

package/dist/vtc/members/authority-reduced-notice/0.1/payload.d.ts

@@ -0,0 +1,208 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/members/authority-reduced-notice/0.1/payload.schema.json
+ */
+import type { Ext } from "../../../../_shared/components.js";
+/**
+ * A community tells a subject that an administrator reduced their administrative authority — revoked their entry, demoted their role, or narrowed what it allows — on whose authority, when, why, and whether anyone else agreed. Unsolicited: the subject did not ask. The removal of a member is vtc/members/removal-notice; this is the reduction of authority, which may leave the subject a member.
+ */
+export interface VTCMembersAuthorityReducedNoticePayload {
+    /**
+     * The subject whose authority was reduced — the notice's recipient. Carried in the payload as well as the envelope so that a forwarded notice still names its subject.
+     */
+    did: string;
+    /**
+     * What happened. `revoked`: the subject's access control entry was removed. `demoted`: its role was changed to one with a lower ceiling. `narrowed`: its role stayed and what it allows was reduced.
+     */
+    code: "revoked" | "demoted" | "narrowed";
+    /**
+     * The role the subject held before the change.
+     */
+    previousRole: string;
+    /**
+     * The role the subject holds after the change. Absent exactly when `code` is `revoked`.
+     */
+    resultingRole?: string;
+    /**
+     * Whether a party other than the deciding administrator and the subject agreed. `consented`: the reduction ran on the consent of at least one other administrator. `unopposed`: nobody other than the decider and the subject held the authority to consent, so the decider's own re-authentication was the only gate. The distinction is the subject's evidence that a reduction no third party reviewed happened.
+     */
+    agreement: "consented" | "unopposed";
+    /**
+     * The deciding administrator's stated reason, verbatim. Absent when none was given; absent and empty are different claims.
+     */
+    reason?: string;
+    /**
+     * When the reduction took effect — not when the notice was sent.
+     */
+    decidedAt: string;
+    /**
+     * DID of the administrator who decided. The community itself is the document's issuer.
+     */
+    decidedBy: string;
+    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 declare const TYPE_URI: "https://trusttasks.org/spec/vtc/members/authority-reduced-notice/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCMembersAuthorityReducedNoticePayload;
+/**
+ * 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 declare const PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $id: "https://trusttasks.org/spec/vtc/members/authority-reduced-notice/0.1";
+    readonly title: "VTC Members Authority-Reduced Notice — payload";
+    readonly description: "A community tells a subject that an administrator reduced their administrative authority — revoked their entry, demoted their role, or narrowed what it allows — on whose authority, when, why, and whether anyone else agreed. Unsolicited: the subject did not ask. The removal of a member is vtc/members/removal-notice; this is the reduction of authority, which may leave the subject a member.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["did", "code", "previousRole", "decidedAt", "decidedBy", "agreement"];
+    readonly properties: {
+        readonly did: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "The subject whose authority was reduced — the notice's recipient. Carried in the payload as well as the envelope so that a forwarded notice still names its subject.";
+        };
+        readonly code: {
+            readonly type: "string";
+            readonly enum: readonly ["revoked", "demoted", "narrowed"];
+            readonly description: "What happened. `revoked`: the subject's access control entry was removed. `demoted`: its role was changed to one with a lower ceiling. `narrowed`: its role stayed and what it allows was reduced.";
+        };
+        readonly previousRole: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "The role the subject held before the change.";
+        };
+        readonly resultingRole: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly description: "The role the subject holds after the change. Absent exactly when `code` is `revoked`.";
+        };
+        readonly agreement: {
+            readonly type: "string";
+            readonly enum: readonly ["consented", "unopposed"];
+            readonly description: "Whether a party other than the deciding administrator and the subject agreed. `consented`: the reduction ran on the consent of at least one other administrator. `unopposed`: nobody other than the decider and the subject held the authority to consent, so the decider's own re-authentication was the only gate. The distinction is the subject's evidence that a reduction no third party reviewed happened.";
+        };
+        readonly reason: {
+            readonly type: "string";
+            readonly maxLength: 1024;
+            readonly description: "The deciding administrator's stated reason, verbatim. Absent when none was given; absent and empty are different claims.";
+        };
+        readonly decidedAt: {
+            readonly type: "string";
+            readonly format: "date-time";
+            readonly description: "When the reduction took effect — not when the notice was sent.";
+        };
+        readonly decidedBy: {
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly description: "DID of the administrator who decided. The community itself is the document's issuer.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Ext: {
+            readonly title: "Ext";
+            readonly 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.";
+            readonly type: "object";
+            readonly minProperties: 1;
+            readonly additionalProperties: true;
+            readonly propertyNames: {
+                readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+            };
+        };
+    };
+};
+/**
+ * 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 declare const SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/members/authority-reduced-notice/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: true;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: true;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vtc/members/authority-reduced-notice/0.1";
+        readonly title: "VTC Members Authority-Reduced Notice — payload";
+        readonly description: "A community tells a subject that an administrator reduced their administrative authority — revoked their entry, demoted their role, or narrowed what it allows — on whose authority, when, why, and whether anyone else agreed. Unsolicited: the subject did not ask. The removal of a member is vtc/members/removal-notice; this is the reduction of authority, which may leave the subject a member.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["did", "code", "previousRole", "decidedAt", "decidedBy", "agreement"];
+        readonly properties: {
+            readonly did: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "The subject whose authority was reduced — the notice's recipient. Carried in the payload as well as the envelope so that a forwarded notice still names its subject.";
+            };
+            readonly code: {
+                readonly type: "string";
+                readonly enum: readonly ["revoked", "demoted", "narrowed"];
+                readonly description: "What happened. `revoked`: the subject's access control entry was removed. `demoted`: its role was changed to one with a lower ceiling. `narrowed`: its role stayed and what it allows was reduced.";
+            };
+            readonly previousRole: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "The role the subject held before the change.";
+            };
+            readonly resultingRole: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly description: "The role the subject holds after the change. Absent exactly when `code` is `revoked`.";
+            };
+            readonly agreement: {
+                readonly type: "string";
+                readonly enum: readonly ["consented", "unopposed"];
+                readonly description: "Whether a party other than the deciding administrator and the subject agreed. `consented`: the reduction ran on the consent of at least one other administrator. `unopposed`: nobody other than the decider and the subject held the authority to consent, so the decider's own re-authentication was the only gate. The distinction is the subject's evidence that a reduction no third party reviewed happened.";
+            };
+            readonly reason: {
+                readonly type: "string";
+                readonly maxLength: 1024;
+                readonly description: "The deciding administrator's stated reason, verbatim. Absent when none was given; absent and empty are different claims.";
+            };
+            readonly decidedAt: {
+                readonly type: "string";
+                readonly format: "date-time";
+                readonly description: "When the reduction took effect — not when the notice was sent.";
+            };
+            readonly decidedBy: {
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly description: "DID of the administrator who decided. The community itself is the document's issuer.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Ext: {
+                readonly title: "Ext";
+                readonly 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.";
+                readonly type: "object";
+                readonly minProperties: 1;
+                readonly additionalProperties: true;
+                readonly propertyNames: {
+                    readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
+                };
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map

package/dist/vtc/members/authority-reduced-notice/0.1/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../src/vtc/members/authority-reduced-notice/0.1/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAG7D;;GAEG;AACH,MAAM,WAAW,uCAAuC;IACtD;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IACzC;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,SAAS,EAAE,WAAW,GAAG,WAAW,CAAC;IACrC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,kHAAkH;AAClH,YAAY,EAAE,GAAG,EAAE,CAAC;AAEpB,2BAA2B;AAC3B,eAAO,MAAM,QAAQ,EAAG,sEAA+E,CAAC;AAExG,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,uCAAuC,CAAC;AAE9D;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiFjB,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOP,CAAC"}

package/dist/vtc/members/authority-reduced-notice/0.1/payload.js

@@ -0,0 +1,112 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/members/authority-reduced-notice/0.1/payload.schema.json
+ */
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/vtc/members/authority-reduced-notice/0.1";
+/**
+ * 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/vtc/members/authority-reduced-notice/0.1",
+    "title": "VTC Members Authority-Reduced Notice — payload",
+    "description": "A community tells a subject that an administrator reduced their administrative authority — revoked their entry, demoted their role, or narrowed what it allows — on whose authority, when, why, and whether anyone else agreed. Unsolicited: the subject did not ask. The removal of a member is vtc/members/removal-notice; this is the reduction of authority, which may leave the subject a member.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "did",
+        "code",
+        "previousRole",
+        "decidedAt",
+        "decidedBy",
+        "agreement"
+    ],
+    "properties": {
+        "did": {
+            "type": "string",
+            "minLength": 1,
+            "description": "The subject whose authority was reduced — the notice's recipient. Carried in the payload as well as the envelope so that a forwarded notice still names its subject."
+        },
+        "code": {
+            "type": "string",
+            "enum": [
+                "revoked",
+                "demoted",
+                "narrowed"
+            ],
+            "description": "What happened. `revoked`: the subject's access control entry was removed. `demoted`: its role was changed to one with a lower ceiling. `narrowed`: its role stayed and what it allows was reduced."
+        },
+        "previousRole": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "description": "The role the subject held before the change."
+        },
+        "resultingRole": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 128,
+            "description": "The role the subject holds after the change. Absent exactly when `code` is `revoked`."
+        },
+        "agreement": {
+            "type": "string",
+            "enum": [
+                "consented",
+                "unopposed"
+            ],
+            "description": "Whether a party other than the deciding administrator and the subject agreed. `consented`: the reduction ran on the consent of at least one other administrator. `unopposed`: nobody other than the decider and the subject held the authority to consent, so the decider's own re-authentication was the only gate. The distinction is the subject's evidence that a reduction no third party reviewed happened."
+        },
+        "reason": {
+            "type": "string",
+            "maxLength": 1024,
+            "description": "The deciding administrator's stated reason, verbatim. Absent when none was given; absent and empty are different claims."
+        },
+        "decidedAt": {
+            "type": "string",
+            "format": "date-time",
+            "description": "When the reduction took effect — not when the notice was sent."
+        },
+        "decidedBy": {
+            "type": "string",
+            "minLength": 1,
+            "description": "DID of the administrator who decided. The community itself is the document's issuer."
+        },
+        "ext": {
+            "$ref": "#/$defs/Ext"
+        }
+    },
+    "$defs": {
+        "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-]+)+$"
+            }
+        }
+    }
+};
+/**
+ * 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: true,
+    isRecipientRequired: true,
+    isIssuedAtRequired: true,
+    payloadSchema: PAYLOAD_SCHEMA,
+};
+//# sourceMappingURL=payload.js.map

package/dist/vtc/members/authority-reduced-notice/0.1/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../../src/vtc/members/authority-reduced-notice/0.1/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA+CH,2BAA2B;AAC3B,MAAM,CAAC,MAAM,QAAQ,GAAG,sEAA+E,CAAC;AAKxG;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,SAAS,EAAE,8CAA8C;IACzD,KAAK,EAAE,sEAAsE;IAC7E,OAAO,EAAE,gDAAgD;IACzD,aAAa,EAAE,wYAAwY;IACvZ,MAAM,EAAE,QAAQ;IAChB,sBAAsB,EAAE,KAAK;IAC7B,UAAU,EAAE;QACV,KAAK;QACL,MAAM;QACN,cAAc;QACd,WAAW;QACX,WAAW;QACX,WAAW;KACZ;IACD,YAAY,EAAE;QACZ,KAAK,EAAE;YACL,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,sKAAsK;SACtL;QACD,MAAM,EAAE;YACN,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE;gBACN,SAAS;gBACT,SAAS;gBACT,UAAU;aACX;YACD,aAAa,EAAE,oMAAoM;SACpN;QACD,cAAc,EAAE;YACd,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,8CAA8C;SAC9D;QACD,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,WAAW,EAAE,GAAG;YAChB,aAAa,EAAE,uFAAuF;SACvG;QACD,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE;gBACN,WAAW;gBACX,WAAW;aACZ;YACD,aAAa,EAAE,mZAAmZ;SACna;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,IAAI;YACjB,aAAa,EAAE,0HAA0H;SAC1I;QACD,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,QAAQ,EAAE,WAAW;YACrB,aAAa,EAAE,gEAAgE;SAChF;QACD,WAAW,EAAE;YACX,MAAM,EAAE,QAAQ;YAChB,WAAW,EAAE,CAAC;YACd,aAAa,EAAE,sFAAsF;SACtG;QACD,KAAK,EAAE;YACL,MAAM,EAAE,aAAa;SACtB;KACF;IACD,OAAO,EAAE;QACP,KAAK,EAAE;YACL,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,uKAAuK;YACtL,MAAM,EAAE,QAAQ;YAChB,eAAe,EAAE,CAAC;YAClB,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE;gBACf,SAAS,EAAE,mCAAmC;aAC/C;SACF;KACF;CACO,CAAC;AAEX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,KAAK;IACf,eAAe,EAAE,IAAI;IACrB,mBAAmB,EAAE,IAAI;IACzB,kBAAkB,EAAE,IAAI;IACxB,aAAa,EAAE,cAAc;CACrB,CAAC"}

package/dist/vtc/roles/_shared/0.1/role.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/roles/_shared/0.1/role.schema.json
+ */
+/**
+ * The administrative role vocabulary of a Verifiable Trust Community, as records. Not itself a Trust Task specification. Capability references reuse acl/_shared/0.2's `CapabilityRef`, so a capability means the same thing on a role as on the AclEntry it bounds.
+ */
+export interface RoleDefinitionSharedDefinitionForTheVtcRolesSpecFamily {
+    [k: string]: unknown | undefined;
+}
+/**
+ * The definitions this shared schema publishes, hoisted to one declaration each.
+ * See "../../../../_shared/components.js".
+ */
+export type { RoleDefinition, RoleName } from "../../../../_shared/components.js";
+//# sourceMappingURL=role.d.ts.map

package/dist/vtc/roles/_shared/0.1/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../../../src/vtc/roles/_shared/0.1/role.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,sDAAsD;IACrE,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAClC;AAED;;;GAGG;AACH,YAAY,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/vtc/roles/_shared/0.1/role.js

@@ -0,0 +1,6 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/roles/_shared/0.1/role.schema.json
+ */
+export {};
+//# sourceMappingURL=role.js.map

package/dist/vtc/roles/_shared/0.1/role.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.js","sourceRoot":"","sources":["../../../../../src/vtc/roles/_shared/0.1/role.ts"],"names":[],"mappings":"AAAA;;;GAGG"}