@openvtc/trust-tasks 0.28.15 → 0.28.16

package/dist/vta/pcs/voter/read/0.7/payload.js

@@ -0,0 +1,315 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vta/pcs/voter/read/0.7/payload.schema.json
+ */
+/** Trust Task type URI. */
+export const TYPE_URI = "https://trusttasks.org/spec/vta/pcs/voter/read/0.7";
+/**
+ * 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 = 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 = null;
+/** Trust Task response type URI (request type URI + "#response"). */
+export const RESPONSE_TYPE_URI = "https://trusttasks.org/spec/vta/pcs/voter/read/0.7#response";
+/**
+ * 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/pcs/voter/read/0.7",
+    "title": "VTA PCS — Voter Read — payload",
+    "description": "A voter's client asks its VTA for a vtc/elections/list, vtc/elections/show or vtc/elections/tombstones/show request signed as the voter's membership DID, so the client can read the community's elections as the member without holding the member's key. For a show of an election put to the members of a party that is itself a member of the community, the VTA can present the member's credential for that party from its vault, bound to the read it signs, and only where that credential was issued by the party the client names.",
+    "type": "object",
+    "additionalProperties": false,
+    "required": [
+        "contextId",
+        "community",
+        "member",
+        "read",
+        "payload"
+    ],
+    "properties": {
+        "contextId": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "description": "The context the voter belongs to."
+        },
+        "community": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 2048,
+            "description": "The community's DID: the recipient of the signed request."
+        },
+        "member": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 2048,
+            "pattern": "^did:",
+            "description": "The voter's membership DID at the community. MUST be a DID the engine holds an authentication key of that the caller may act as."
+        },
+        "read": {
+            "type": "string",
+            "enum": [
+                "list",
+                "show",
+                "tombstone"
+            ],
+            "description": "Which read to sign: vtc/elections/list/0.5, vtc/elections/show/0.6 or vtc/elections/tombstones/show/0.1 (`tombstone`: what the community keeps of an election once the board that opened it is deleted, VTI-BRD-009)."
+        },
+        "payload": {
+            "type": "object",
+            "description": "The request payload of that task, validated against its own schema."
+        },
+        "membershipCredential": {
+            "type": "string",
+            "minLength": 1,
+            "maxLength": 256,
+            "description": "Only with `read` `show`, and only to read an election whose `credential` roll names a member party (vtc/elections/show/0.6, VTI-VOT-015): the vault's local handle (vault/credentials/query) of the membership credential the member chose to present for it, whose subject is `member`. The engine presents it in the `show` request it signs, bound to that document and the community. Opaque; never derived or guessed."
+        },
+        "memberOf": {
+            "type": "string",
+            "minLength": 8,
+            "maxLength": 2048,
+            "pattern": "^did:[a-z0-9]+:\\S+$",
+            "description": "Only with `membershipCredential`: the DID the member was told the election's `credential` roll names (voting/_shared/0.4 `RollRule.memberOf`) — the party whose membership the read is to prove. The engine presents `membershipCredential` only where that credential's issuer is this DID, and otherwise refuses with `membershipCredentialMismatch`, so that it never presents a membership unrelated to the election (VTI-VOT-016)."
+        },
+        "ext": {
+            "$ref": "#/$defs/Ext"
+        }
+    },
+    "dependentSchemas": {
+        "membershipCredential": {
+            "properties": {
+                "read": {
+                    "const": "show"
+                }
+            }
+        },
+        "memberOf": {
+            "required": [
+                "membershipCredential"
+            ]
+        }
+    },
+    "$defs": {
+        "ReadDocument": {
+            "title": "ReadDocument",
+            "description": "A complete, signed vtc/elections/list/0.5, vtc/elections/show/0.6 or vtc/elections/tombstones/show/0.1 request document, ready to send to the community unchanged.",
+            "type": "object",
+            "required": [
+                "id",
+                "type",
+                "issuer",
+                "recipient",
+                "issuedAt",
+                "payload",
+                "proof"
+            ],
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "pattern": "^urn:uuid:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+                },
+                "type": {
+                    "type": "string",
+                    "enum": [
+                        "https://trusttasks.org/spec/vtc/elections/list/0.5",
+                        "https://trusttasks.org/spec/vtc/elections/show/0.6",
+                        "https://trusttasks.org/spec/vtc/elections/tombstones/show/0.1"
+                    ]
+                },
+                "issuer": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The request's `member`."
+                },
+                "recipient": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The request's `community`."
+                },
+                "issuedAt": {
+                    "type": "string",
+                    "format": "date-time"
+                },
+                "expiresAt": {
+                    "type": "string",
+                    "format": "date-time"
+                },
+                "payload": {
+                    "type": "object",
+                    "description": "The request's `payload`, exactly — and, where the request named `membershipCredential`, with `presentation` added: the engine's presentation of that credential, bound to this document."
+                },
+                "proof": {
+                    "type": "object",
+                    "description": "A Data Integrity proof by an `authentication` key of `issuer`."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "VTA PCS — Voter Read — response payload",
+            "description": "The signed read, to send to the community.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "document"
+            ],
+            "properties": {
+                "document": {
+                    "$ref": "#/$defs/ReadDocument"
+                },
+                "ext": {
+                    "$ref": "#/$defs/Ext"
+                }
+            }
+        },
+        "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 {@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": {
+        "ReadDocument": {
+            "title": "ReadDocument",
+            "description": "A complete, signed vtc/elections/list/0.5, vtc/elections/show/0.6 or vtc/elections/tombstones/show/0.1 request document, ready to send to the community unchanged.",
+            "type": "object",
+            "required": [
+                "id",
+                "type",
+                "issuer",
+                "recipient",
+                "issuedAt",
+                "payload",
+                "proof"
+            ],
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "pattern": "^urn:uuid:[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+                },
+                "type": {
+                    "type": "string",
+                    "enum": [
+                        "https://trusttasks.org/spec/vtc/elections/list/0.5",
+                        "https://trusttasks.org/spec/vtc/elections/show/0.6",
+                        "https://trusttasks.org/spec/vtc/elections/tombstones/show/0.1"
+                    ]
+                },
+                "issuer": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The request's `member`."
+                },
+                "recipient": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 2048,
+                    "description": "The request's `community`."
+                },
+                "issuedAt": {
+                    "type": "string",
+                    "format": "date-time"
+                },
+                "expiresAt": {
+                    "type": "string",
+                    "format": "date-time"
+                },
+                "payload": {
+                    "type": "object",
+                    "description": "The request's `payload`, exactly — and, where the request named `membershipCredential`, with `presentation` added: the engine's presentation of that credential, bound to this document."
+                },
+                "proof": {
+                    "type": "object",
+                    "description": "A Data Integrity proof by an `authentication` key of `issuer`."
+                }
+            }
+        },
+        "Response": {
+            "$anchor": "response",
+            "title": "VTA PCS — Voter Read — response payload",
+            "description": "The signed read, to send to the community.",
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+                "document"
+            ],
+            "properties": {
+                "document": {
+                    "$ref": "#/$defs/ReadDocument"
+                },
+                "ext": {
+                    "$ref": "#/$defs/Ext"
+                }
+            }
+        },
+        "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,
+};
+/**
+ * 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,
+};
+//# sourceMappingURL=payload.js.map

package/dist/vta/pcs/voter/read/0.7/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../../../src/vta/pcs/voter/read/0.7/payload.ts"],"names":[],"mappings":"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"}