@openvtc/trust-tasks 0.26.17 → 0.26.18

package/dist/vtc/directory/card/show/0.1/payload.d.ts

@@ -0,0 +1,1144 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/vtc/directory/card/show/0.1/payload.schema.json
+ */
+import type { Audience, CardBlobRef, CardValues, DirectoryCard, Discoverability, EntryId, Ext, FieldKey, FieldValue, FieldVisibility, Introductions, Listing, VerifiedValue } from "../../../../../_shared/components.js";
+/**
+ * A member reads their own directory card whole: every value, the visibility of each field, their discoverability and introduction settings, and its revision. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export interface VTCDirectoryCardShowPayload {
+    ext?: Ext;
+}
+/**
+ * The success response to a vtc/directory/card/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/card/show/0.1#response.
+ */
+export interface VTCDirectoryCardShowResponsePayload {
+    card: DirectoryCard;
+    /**
+     * Required fields the card has no value for. While any is missing the entry is not listed, whatever `discoverability.listing` says.
+     *
+     * @maxItems 64
+     */
+    missingRequired: FieldKey[];
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { Audience, CardBlobRef, CardValues, DirectoryCard, Discoverability, EntryId, Ext, FieldKey, FieldValue, FieldVisibility, Introductions, Listing, VerifiedValue };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/vtc/directory/card/show/0.1";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = VTCDirectoryCardShowPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/vtc/directory/card/show/0.1#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = VTCDirectoryCardShowResponsePayload;
+/**
+ * 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/directory/card/show/0.1";
+    readonly title: "VTC Directory — Card — Show — payload";
+    readonly description: "A member reads their own directory card whole: every value, the visibility of each field, their discoverability and introduction settings, and its revision. The outer document members are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Directory — Card — Show — response payload";
+            readonly description: "The success response to a vtc/directory/card/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/card/show/0.1#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["card", "missingRequired"];
+            readonly properties: {
+                readonly card: {
+                    readonly $ref: "#/$defs/DirectoryCard";
+                };
+                readonly missingRequired: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly $ref: "#/$defs/FieldKey";
+                    };
+                    readonly description: "Required fields the card has no value for. While any is missing the entry is not listed, whatever `discoverability.listing` says.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        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-]+)+$";
+            };
+        };
+        readonly FieldKey: {
+            readonly title: "FieldKey";
+            readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+        };
+        readonly DirectoryCard: {
+            readonly title: "DirectoryCard";
+            readonly description: "A member's own directory record: their values, a visibility for each field, their discoverability and who may ask to be introduced. Returned whole only to its subject. Every other reader receives a `DirectoryEntry`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["entryId", "values", "visibility", "discoverability", "introductions", "revision", "updatedAt"];
+            readonly properties: {
+                readonly entryId: {
+                    readonly $ref: "#/$defs/EntryId";
+                };
+                readonly values: {
+                    readonly $ref: "#/$defs/CardValues";
+                };
+                readonly visibility: {
+                    readonly $ref: "#/$defs/FieldVisibility";
+                };
+                readonly discoverability: {
+                    readonly $ref: "#/$defs/Discoverability";
+                };
+                readonly introductions: {
+                    readonly $ref: "#/$defs/Introductions";
+                };
+                readonly groupAudience: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+                    };
+                    readonly description: "The community groups whose members count as the `groups` audience for this card. Absent: every community group the subject belongs to. A group the subject has left stops counting at once.";
+                };
+                readonly revision: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Incremented on every accepted change to the card, by its subject or by an administrator's assertion.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the card last changed.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry directory data that bypasses the projection.";
+                };
+            };
+        };
+        readonly Introductions: {
+            readonly title: "Introductions";
+            readonly description: "Who may ask the community to introduce them to this member. `anyone`: any active member who can find the entry. `groups`: only members who share a community group with them. `connections`: only members holding an attributed, in-force verified relationship with them. `off`: nobody. A refused introduction is never reported to its sender.";
+            readonly type: "string";
+            readonly enum: readonly ["anyone", "groups", "connections", "off"];
+        };
+        readonly Discoverability: {
+            readonly title: "Discoverability";
+            readonly description: "The member's three discoverability decisions, made separately.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["listing", "search", "external"];
+            readonly properties: {
+                readonly listing: {
+                    readonly $ref: "#/$defs/Listing";
+                };
+                readonly search: {
+                    readonly type: "string";
+                    readonly enum: readonly ["byName", "exactNickname", "off"];
+                    readonly description: "What a member's search may match. `byName`: `displayName` or `nickname`. `exactNickname`: only an exact `nickname`. `off`: nothing. A DID is never a search key for a non-administrator, whatever this says.";
+                };
+                readonly external: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the member publishes a public card — the fields whose visibility is `public`, signed by the member — through the community's trust registry. A second consent, separate from registry-publication consent (`publishConsent`), which it requires. A community that cannot yet publish external cards refuses `true` with `notAvailable`.";
+                };
+            };
+        };
+        readonly Listing: {
+            readonly title: "Listing";
+            readonly description: "Whether members can find the entry. `listed`: it appears when members browse. `findable`: it does not appear when browsing, but a search that matches it under `search` returns it. `hidden`: no member finds it by browsing or searching; administrators still see it, and members who share a group that shows its members see it in that group's member list.";
+            readonly type: "string";
+            readonly enum: readonly ["listed", "findable", "hidden"];
+        };
+        readonly FieldVisibility: {
+            readonly title: "FieldVisibility";
+            readonly description: "The audience the member chose for each field. A field with no entry here takes its definition's `defaultVisibility`. The community MUST NOT widen a member's choice: widening a field's ceiling or default changes no visibility already recorded.";
+            readonly type: "object";
+            readonly maxProperties: 64;
+            readonly propertyNames: {
+                readonly $ref: "#/$defs/FieldKey";
+            };
+            readonly additionalProperties: {
+                readonly $ref: "#/$defs/Audience";
+            };
+        };
+        readonly Audience: {
+            readonly title: "Audience";
+            readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+            readonly type: "string";
+            readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+        };
+        readonly CardValues: {
+            readonly title: "CardValues";
+            readonly description: "A card's stored values, keyed by field. Holds `member`-, `admin`- and `credential`-sourced fields only; derived fields (`role`, `joinedAt`, `did`, `personhood`) are read from the community's own records when a projection is made, never stored here. At most 64 values, and at most 16 KiB serialized excluding the blobs a `CardBlobRef` names.";
+            readonly type: "object";
+            readonly maxProperties: 64;
+            readonly propertyNames: {
+                readonly $ref: "#/$defs/FieldKey";
+            };
+            readonly additionalProperties: {
+                readonly $ref: "#/$defs/FieldValue";
+            };
+        };
+        readonly FieldValue: {
+            readonly title: "FieldValue";
+            readonly description: "The value of one field. Which shape a field takes is fixed by its definition's `type`: text-like types (`text`, `longText`, `url`, `email`, `phone`, `enum`, `date` as YYYY-MM-DD, `country` as ISO 3166-1 alpha-2, `did`) are strings; `multiEnum` and the base field `links` are arrays of strings; `image` and the base field `avatar` are a `CardBlobRef`; `claim` is a `VerifiedValue`; the derived base field `personhood` is a boolean.";
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly maxLength: 2000;
+            }, {
+                readonly type: "boolean";
+            }, {
+                readonly type: "array";
+                readonly maxItems: 32;
+                readonly items: {
+                    readonly type: "string";
+                    readonly maxLength: 500;
+                };
+            }, {
+                readonly $ref: "#/$defs/CardBlobRef";
+            }, {
+                readonly $ref: "#/$defs/VerifiedValue";
+            }];
+        };
+        readonly VerifiedValue: {
+            readonly title: "VerifiedValue";
+            readonly description: "The value of a `credential`-sourced field: a claim the member disclosed from a credential they presented, with the issuer that attests it. A verified value always names its issuer, and a self-asserted value is never shaped as one. The community keeps only the disclosed claim and these facts about it — never the presentation.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["value", "issuer", "verifiedAt"];
+            readonly properties: {
+                readonly value: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly maxLength: 2000;
+                    }, {
+                        readonly type: "boolean";
+                    }, {
+                        readonly type: "number";
+                    }];
+                    readonly description: "The disclosed claim value.";
+                };
+                readonly issuer: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "DID of the credential's issuer, shown as the field's verification badge.";
+                };
+                readonly credentialType: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "The most specific `type` of the credential the claim came from.";
+                };
+                readonly verifiedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community verified the presentation.";
+                };
+                readonly validUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the credential expires, where it does. The community withdraws the value once it passes.";
+                };
+            };
+        };
+        readonly CardBlobRef: {
+            readonly title: "CardBlobRef";
+            readonly description: "A content-addressed image held in the community's blob store — an avatar or an `image` field. At most 256 KiB, images only, re-encoded by the community on upload (metadata stripped, dimensions capped) so its digest does not link the member across communities. `url` and `urlExpiresAt` appear only in a projection: a short-lived URL the community checks against the same projection, so a member-only image is never a public URL.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["sha256", "mediaType"];
+            readonly properties: {
+                readonly sha256: {
+                    readonly type: "string";
+                    readonly pattern: "^[0-9a-f]{64}$";
+                    readonly description: "Lowercase hex SHA-256 of the stored, re-encoded bytes.";
+                };
+                readonly mediaType: {
+                    readonly type: "string";
+                    readonly enum: readonly ["image/png", "image/jpeg", "image/webp", "image/avif"];
+                    readonly description: "Media type of the stored bytes.";
+                };
+                readonly size: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 262144;
+                    readonly description: "Size in bytes of the stored bytes.";
+                };
+                readonly url: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly maxLength: 2048;
+                    readonly description: "Projection only: a URL the viewer can fetch the image from until `urlExpiresAt`.";
+                };
+                readonly urlExpiresAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Projection only: when `url` stops working.";
+                };
+            };
+        };
+        readonly EntryId: {
+            readonly title: "EntryId";
+            readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+            readonly type: "string";
+            readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+        };
+    };
+};
+/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
+export declare const RESPONSE_PAYLOAD_SCHEMA: {
+    readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+    readonly $ref: "#/$defs/Response";
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "VTC Directory — Card — Show — response payload";
+            readonly description: "The success response to a vtc/directory/card/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/card/show/0.1#response.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["card", "missingRequired"];
+            readonly properties: {
+                readonly card: {
+                    readonly $ref: "#/$defs/DirectoryCard";
+                };
+                readonly missingRequired: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly items: {
+                        readonly $ref: "#/$defs/FieldKey";
+                    };
+                    readonly description: "Required fields the card has no value for. While any is missing the entry is not listed, whatever `discoverability.listing` says.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                };
+            };
+        };
+        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-]+)+$";
+            };
+        };
+        readonly FieldKey: {
+            readonly title: "FieldKey";
+            readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 128;
+            readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+        };
+        readonly DirectoryCard: {
+            readonly title: "DirectoryCard";
+            readonly description: "A member's own directory record: their values, a visibility for each field, their discoverability and who may ask to be introduced. Returned whole only to its subject. Every other reader receives a `DirectoryEntry`.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["entryId", "values", "visibility", "discoverability", "introductions", "revision", "updatedAt"];
+            readonly properties: {
+                readonly entryId: {
+                    readonly $ref: "#/$defs/EntryId";
+                };
+                readonly values: {
+                    readonly $ref: "#/$defs/CardValues";
+                };
+                readonly visibility: {
+                    readonly $ref: "#/$defs/FieldVisibility";
+                };
+                readonly discoverability: {
+                    readonly $ref: "#/$defs/Discoverability";
+                };
+                readonly introductions: {
+                    readonly $ref: "#/$defs/Introductions";
+                };
+                readonly groupAudience: {
+                    readonly type: "array";
+                    readonly maxItems: 64;
+                    readonly uniqueItems: true;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+                    };
+                    readonly description: "The community groups whose members count as the `groups` audience for this card. Absent: every community group the subject belongs to. A group the subject has left stops counting at once.";
+                };
+                readonly revision: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "Incremented on every accepted change to the card, by its subject or by an administrator's assertion.";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the card last changed.";
+                };
+                readonly ext: {
+                    readonly $ref: "#/$defs/Ext";
+                    readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry directory data that bypasses the projection.";
+                };
+            };
+        };
+        readonly Introductions: {
+            readonly title: "Introductions";
+            readonly description: "Who may ask the community to introduce them to this member. `anyone`: any active member who can find the entry. `groups`: only members who share a community group with them. `connections`: only members holding an attributed, in-force verified relationship with them. `off`: nobody. A refused introduction is never reported to its sender.";
+            readonly type: "string";
+            readonly enum: readonly ["anyone", "groups", "connections", "off"];
+        };
+        readonly Discoverability: {
+            readonly title: "Discoverability";
+            readonly description: "The member's three discoverability decisions, made separately.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["listing", "search", "external"];
+            readonly properties: {
+                readonly listing: {
+                    readonly $ref: "#/$defs/Listing";
+                };
+                readonly search: {
+                    readonly type: "string";
+                    readonly enum: readonly ["byName", "exactNickname", "off"];
+                    readonly description: "What a member's search may match. `byName`: `displayName` or `nickname`. `exactNickname`: only an exact `nickname`. `off`: nothing. A DID is never a search key for a non-administrator, whatever this says.";
+                };
+                readonly external: {
+                    readonly type: "boolean";
+                    readonly description: "Whether the member publishes a public card — the fields whose visibility is `public`, signed by the member — through the community's trust registry. A second consent, separate from registry-publication consent (`publishConsent`), which it requires. A community that cannot yet publish external cards refuses `true` with `notAvailable`.";
+                };
+            };
+        };
+        readonly Listing: {
+            readonly title: "Listing";
+            readonly description: "Whether members can find the entry. `listed`: it appears when members browse. `findable`: it does not appear when browsing, but a search that matches it under `search` returns it. `hidden`: no member finds it by browsing or searching; administrators still see it, and members who share a group that shows its members see it in that group's member list.";
+            readonly type: "string";
+            readonly enum: readonly ["listed", "findable", "hidden"];
+        };
+        readonly FieldVisibility: {
+            readonly title: "FieldVisibility";
+            readonly description: "The audience the member chose for each field. A field with no entry here takes its definition's `defaultVisibility`. The community MUST NOT widen a member's choice: widening a field's ceiling or default changes no visibility already recorded.";
+            readonly type: "object";
+            readonly maxProperties: 64;
+            readonly propertyNames: {
+                readonly $ref: "#/$defs/FieldKey";
+            };
+            readonly additionalProperties: {
+                readonly $ref: "#/$defs/Audience";
+            };
+        };
+        readonly Audience: {
+            readonly title: "Audience";
+            readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+            readonly type: "string";
+            readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+        };
+        readonly CardValues: {
+            readonly title: "CardValues";
+            readonly description: "A card's stored values, keyed by field. Holds `member`-, `admin`- and `credential`-sourced fields only; derived fields (`role`, `joinedAt`, `did`, `personhood`) are read from the community's own records when a projection is made, never stored here. At most 64 values, and at most 16 KiB serialized excluding the blobs a `CardBlobRef` names.";
+            readonly type: "object";
+            readonly maxProperties: 64;
+            readonly propertyNames: {
+                readonly $ref: "#/$defs/FieldKey";
+            };
+            readonly additionalProperties: {
+                readonly $ref: "#/$defs/FieldValue";
+            };
+        };
+        readonly FieldValue: {
+            readonly title: "FieldValue";
+            readonly description: "The value of one field. Which shape a field takes is fixed by its definition's `type`: text-like types (`text`, `longText`, `url`, `email`, `phone`, `enum`, `date` as YYYY-MM-DD, `country` as ISO 3166-1 alpha-2, `did`) are strings; `multiEnum` and the base field `links` are arrays of strings; `image` and the base field `avatar` are a `CardBlobRef`; `claim` is a `VerifiedValue`; the derived base field `personhood` is a boolean.";
+            readonly anyOf: readonly [{
+                readonly type: "string";
+                readonly maxLength: 2000;
+            }, {
+                readonly type: "boolean";
+            }, {
+                readonly type: "array";
+                readonly maxItems: 32;
+                readonly items: {
+                    readonly type: "string";
+                    readonly maxLength: 500;
+                };
+            }, {
+                readonly $ref: "#/$defs/CardBlobRef";
+            }, {
+                readonly $ref: "#/$defs/VerifiedValue";
+            }];
+        };
+        readonly VerifiedValue: {
+            readonly title: "VerifiedValue";
+            readonly description: "The value of a `credential`-sourced field: a claim the member disclosed from a credential they presented, with the issuer that attests it. A verified value always names its issuer, and a self-asserted value is never shaped as one. The community keeps only the disclosed claim and these facts about it — never the presentation.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["value", "issuer", "verifiedAt"];
+            readonly properties: {
+                readonly value: {
+                    readonly anyOf: readonly [{
+                        readonly type: "string";
+                        readonly maxLength: 2000;
+                    }, {
+                        readonly type: "boolean";
+                    }, {
+                        readonly type: "number";
+                    }];
+                    readonly description: "The disclosed claim value.";
+                };
+                readonly issuer: {
+                    readonly type: "string";
+                    readonly pattern: "^did:";
+                    readonly maxLength: 2048;
+                    readonly description: "DID of the credential's issuer, shown as the field's verification badge.";
+                };
+                readonly credentialType: {
+                    readonly type: "string";
+                    readonly minLength: 1;
+                    readonly maxLength: 128;
+                    readonly description: "The most specific `type` of the credential the claim came from.";
+                };
+                readonly verifiedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the community verified the presentation.";
+                };
+                readonly validUntil: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the credential expires, where it does. The community withdraws the value once it passes.";
+                };
+            };
+        };
+        readonly CardBlobRef: {
+            readonly title: "CardBlobRef";
+            readonly description: "A content-addressed image held in the community's blob store — an avatar or an `image` field. At most 256 KiB, images only, re-encoded by the community on upload (metadata stripped, dimensions capped) so its digest does not link the member across communities. `url` and `urlExpiresAt` appear only in a projection: a short-lived URL the community checks against the same projection, so a member-only image is never a public URL.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["sha256", "mediaType"];
+            readonly properties: {
+                readonly sha256: {
+                    readonly type: "string";
+                    readonly pattern: "^[0-9a-f]{64}$";
+                    readonly description: "Lowercase hex SHA-256 of the stored, re-encoded bytes.";
+                };
+                readonly mediaType: {
+                    readonly type: "string";
+                    readonly enum: readonly ["image/png", "image/jpeg", "image/webp", "image/avif"];
+                    readonly description: "Media type of the stored bytes.";
+                };
+                readonly size: {
+                    readonly type: "integer";
+                    readonly minimum: 1;
+                    readonly maximum: 262144;
+                    readonly description: "Size in bytes of the stored bytes.";
+                };
+                readonly url: {
+                    readonly type: "string";
+                    readonly format: "uri";
+                    readonly maxLength: 2048;
+                    readonly description: "Projection only: a URL the viewer can fetch the image from until `urlExpiresAt`.";
+                };
+                readonly urlExpiresAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "Projection only: when `url` stops working.";
+                };
+            };
+        };
+        readonly EntryId: {
+            readonly title: "EntryId";
+            readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+            readonly type: "string";
+            readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+        };
+    };
+};
+/**
+ * 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/directory/card/show/0.1";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $id: "https://trusttasks.org/spec/vtc/directory/card/show/0.1";
+        readonly title: "VTC Directory — Card — Show — payload";
+        readonly description: "A member reads their own directory card whole: every value, the visibility of each field, their discoverability and introduction settings, and its revision. The outer document members are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly properties: {
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Directory — Card — Show — response payload";
+                readonly description: "The success response to a vtc/directory/card/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/card/show/0.1#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["card", "missingRequired"];
+                readonly properties: {
+                    readonly card: {
+                        readonly $ref: "#/$defs/DirectoryCard";
+                    };
+                    readonly missingRequired: {
+                        readonly type: "array";
+                        readonly maxItems: 64;
+                        readonly items: {
+                            readonly $ref: "#/$defs/FieldKey";
+                        };
+                        readonly description: "Required fields the card has no value for. While any is missing the entry is not listed, whatever `discoverability.listing` says.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            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-]+)+$";
+                };
+            };
+            readonly FieldKey: {
+                readonly title: "FieldKey";
+                readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+            };
+            readonly DirectoryCard: {
+                readonly title: "DirectoryCard";
+                readonly description: "A member's own directory record: their values, a visibility for each field, their discoverability and who may ask to be introduced. Returned whole only to its subject. Every other reader receives a `DirectoryEntry`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["entryId", "values", "visibility", "discoverability", "introductions", "revision", "updatedAt"];
+                readonly properties: {
+                    readonly entryId: {
+                        readonly $ref: "#/$defs/EntryId";
+                    };
+                    readonly values: {
+                        readonly $ref: "#/$defs/CardValues";
+                    };
+                    readonly visibility: {
+                        readonly $ref: "#/$defs/FieldVisibility";
+                    };
+                    readonly discoverability: {
+                        readonly $ref: "#/$defs/Discoverability";
+                    };
+                    readonly introductions: {
+                        readonly $ref: "#/$defs/Introductions";
+                    };
+                    readonly groupAudience: {
+                        readonly type: "array";
+                        readonly maxItems: 64;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+                        };
+                        readonly description: "The community groups whose members count as the `groups` audience for this card. Absent: every community group the subject belongs to. A group the subject has left stops counting at once.";
+                    };
+                    readonly revision: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Incremented on every accepted change to the card, by its subject or by an administrator's assertion.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the card last changed.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry directory data that bypasses the projection.";
+                    };
+                };
+            };
+            readonly Introductions: {
+                readonly title: "Introductions";
+                readonly description: "Who may ask the community to introduce them to this member. `anyone`: any active member who can find the entry. `groups`: only members who share a community group with them. `connections`: only members holding an attributed, in-force verified relationship with them. `off`: nobody. A refused introduction is never reported to its sender.";
+                readonly type: "string";
+                readonly enum: readonly ["anyone", "groups", "connections", "off"];
+            };
+            readonly Discoverability: {
+                readonly title: "Discoverability";
+                readonly description: "The member's three discoverability decisions, made separately.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["listing", "search", "external"];
+                readonly properties: {
+                    readonly listing: {
+                        readonly $ref: "#/$defs/Listing";
+                    };
+                    readonly search: {
+                        readonly type: "string";
+                        readonly enum: readonly ["byName", "exactNickname", "off"];
+                        readonly description: "What a member's search may match. `byName`: `displayName` or `nickname`. `exactNickname`: only an exact `nickname`. `off`: nothing. A DID is never a search key for a non-administrator, whatever this says.";
+                    };
+                    readonly external: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the member publishes a public card — the fields whose visibility is `public`, signed by the member — through the community's trust registry. A second consent, separate from registry-publication consent (`publishConsent`), which it requires. A community that cannot yet publish external cards refuses `true` with `notAvailable`.";
+                    };
+                };
+            };
+            readonly Listing: {
+                readonly title: "Listing";
+                readonly description: "Whether members can find the entry. `listed`: it appears when members browse. `findable`: it does not appear when browsing, but a search that matches it under `search` returns it. `hidden`: no member finds it by browsing or searching; administrators still see it, and members who share a group that shows its members see it in that group's member list.";
+                readonly type: "string";
+                readonly enum: readonly ["listed", "findable", "hidden"];
+            };
+            readonly FieldVisibility: {
+                readonly title: "FieldVisibility";
+                readonly description: "The audience the member chose for each field. A field with no entry here takes its definition's `defaultVisibility`. The community MUST NOT widen a member's choice: widening a field's ceiling or default changes no visibility already recorded.";
+                readonly type: "object";
+                readonly maxProperties: 64;
+                readonly propertyNames: {
+                    readonly $ref: "#/$defs/FieldKey";
+                };
+                readonly additionalProperties: {
+                    readonly $ref: "#/$defs/Audience";
+                };
+            };
+            readonly Audience: {
+                readonly title: "Audience";
+                readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+                readonly type: "string";
+                readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+            };
+            readonly CardValues: {
+                readonly title: "CardValues";
+                readonly description: "A card's stored values, keyed by field. Holds `member`-, `admin`- and `credential`-sourced fields only; derived fields (`role`, `joinedAt`, `did`, `personhood`) are read from the community's own records when a projection is made, never stored here. At most 64 values, and at most 16 KiB serialized excluding the blobs a `CardBlobRef` names.";
+                readonly type: "object";
+                readonly maxProperties: 64;
+                readonly propertyNames: {
+                    readonly $ref: "#/$defs/FieldKey";
+                };
+                readonly additionalProperties: {
+                    readonly $ref: "#/$defs/FieldValue";
+                };
+            };
+            readonly FieldValue: {
+                readonly title: "FieldValue";
+                readonly description: "The value of one field. Which shape a field takes is fixed by its definition's `type`: text-like types (`text`, `longText`, `url`, `email`, `phone`, `enum`, `date` as YYYY-MM-DD, `country` as ISO 3166-1 alpha-2, `did`) are strings; `multiEnum` and the base field `links` are arrays of strings; `image` and the base field `avatar` are a `CardBlobRef`; `claim` is a `VerifiedValue`; the derived base field `personhood` is a boolean.";
+                readonly anyOf: readonly [{
+                    readonly type: "string";
+                    readonly maxLength: 2000;
+                }, {
+                    readonly type: "boolean";
+                }, {
+                    readonly type: "array";
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly maxLength: 500;
+                    };
+                }, {
+                    readonly $ref: "#/$defs/CardBlobRef";
+                }, {
+                    readonly $ref: "#/$defs/VerifiedValue";
+                }];
+            };
+            readonly VerifiedValue: {
+                readonly title: "VerifiedValue";
+                readonly description: "The value of a `credential`-sourced field: a claim the member disclosed from a credential they presented, with the issuer that attests it. A verified value always names its issuer, and a self-asserted value is never shaped as one. The community keeps only the disclosed claim and these facts about it — never the presentation.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["value", "issuer", "verifiedAt"];
+                readonly properties: {
+                    readonly value: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly maxLength: 2000;
+                        }, {
+                            readonly type: "boolean";
+                        }, {
+                            readonly type: "number";
+                        }];
+                        readonly description: "The disclosed claim value.";
+                    };
+                    readonly issuer: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "DID of the credential's issuer, shown as the field's verification badge.";
+                    };
+                    readonly credentialType: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "The most specific `type` of the credential the claim came from.";
+                    };
+                    readonly verifiedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community verified the presentation.";
+                    };
+                    readonly validUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the credential expires, where it does. The community withdraws the value once it passes.";
+                    };
+                };
+            };
+            readonly CardBlobRef: {
+                readonly title: "CardBlobRef";
+                readonly description: "A content-addressed image held in the community's blob store — an avatar or an `image` field. At most 256 KiB, images only, re-encoded by the community on upload (metadata stripped, dimensions capped) so its digest does not link the member across communities. `url` and `urlExpiresAt` appear only in a projection: a short-lived URL the community checks against the same projection, so a member-only image is never a public URL.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["sha256", "mediaType"];
+                readonly properties: {
+                    readonly sha256: {
+                        readonly type: "string";
+                        readonly pattern: "^[0-9a-f]{64}$";
+                        readonly description: "Lowercase hex SHA-256 of the stored, re-encoded bytes.";
+                    };
+                    readonly mediaType: {
+                        readonly type: "string";
+                        readonly enum: readonly ["image/png", "image/jpeg", "image/webp", "image/avif"];
+                        readonly description: "Media type of the stored bytes.";
+                    };
+                    readonly size: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 262144;
+                        readonly description: "Size in bytes of the stored bytes.";
+                    };
+                    readonly url: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly maxLength: 2048;
+                        readonly description: "Projection only: a URL the viewer can fetch the image from until `urlExpiresAt`.";
+                    };
+                    readonly urlExpiresAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Projection only: when `url` stops working.";
+                    };
+                };
+            };
+            readonly EntryId: {
+                readonly title: "EntryId";
+                readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+                readonly type: "string";
+                readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+            };
+        };
+    };
+};
+/**
+ * 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 declare const RESPONSE_SPEC: {
+    readonly typeUri: "https://trusttasks.org/spec/vtc/directory/card/show/0.1#response";
+    readonly isBearer: false;
+    readonly isProofRequired: false;
+    readonly isRecipientRequired: true;
+    readonly isIssuedAtRequired: false;
+    readonly payloadSchema: {
+        readonly $schema: "https://json-schema.org/draft/2020-12/schema";
+        readonly $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "VTC Directory — Card — Show — response payload";
+                readonly description: "The success response to a vtc/directory/card/show/0.1 request. Carried in a Trust Task document whose type is https://trusttasks.org/spec/vtc/directory/card/show/0.1#response.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["card", "missingRequired"];
+                readonly properties: {
+                    readonly card: {
+                        readonly $ref: "#/$defs/DirectoryCard";
+                    };
+                    readonly missingRequired: {
+                        readonly type: "array";
+                        readonly maxItems: 64;
+                        readonly items: {
+                            readonly $ref: "#/$defs/FieldKey";
+                        };
+                        readonly description: "Required fields the card has no value for. While any is missing the entry is not listed, whatever `discoverability.listing` says.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                    };
+                };
+            };
+            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-]+)+$";
+                };
+            };
+            readonly FieldKey: {
+                readonly title: "FieldKey";
+                readonly description: "Identifier of a directory field. A key with no `.` is a BASE field, the same in every community: `displayName`, `nickname`, `avatar`, `pronouns`, `bio`, `links` (written by the member) and `role`, `joinedAt`, `did`, `personhood` (derived from the community's own records, never stored on a card). A community-defined field MUST use a reverse-DNS key (`org.example.employer`), so a base key never collides with one, and a key is never reused with a different meaning once defined.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 128;
+                readonly pattern: "^([a-z][a-z0-9-]*\\.)*[a-z][a-zA-Z0-9]{0,63}$";
+            };
+            readonly DirectoryCard: {
+                readonly title: "DirectoryCard";
+                readonly description: "A member's own directory record: their values, a visibility for each field, their discoverability and who may ask to be introduced. Returned whole only to its subject. Every other reader receives a `DirectoryEntry`.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["entryId", "values", "visibility", "discoverability", "introductions", "revision", "updatedAt"];
+                readonly properties: {
+                    readonly entryId: {
+                        readonly $ref: "#/$defs/EntryId";
+                    };
+                    readonly values: {
+                        readonly $ref: "#/$defs/CardValues";
+                    };
+                    readonly visibility: {
+                        readonly $ref: "#/$defs/FieldVisibility";
+                    };
+                    readonly discoverability: {
+                        readonly $ref: "#/$defs/Discoverability";
+                    };
+                    readonly introductions: {
+                        readonly $ref: "#/$defs/Introductions";
+                    };
+                    readonly groupAudience: {
+                        readonly type: "array";
+                        readonly maxItems: 64;
+                        readonly uniqueItems: true;
+                        readonly items: {
+                            readonly type: "string";
+                            readonly pattern: "^grp_[A-Za-z0-9_-]{16,64}$";
+                        };
+                        readonly description: "The community groups whose members count as the `groups` audience for this card. Absent: every community group the subject belongs to. A group the subject has left stops counting at once.";
+                    };
+                    readonly revision: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "Incremented on every accepted change to the card, by its subject or by an administrator's assertion.";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the card last changed.";
+                    };
+                    readonly ext: {
+                        readonly $ref: "#/$defs/Ext";
+                        readonly description: "Ecosystem-defined extension members per SPEC.md §4.5.1. An extension member MUST NOT carry directory data that bypasses the projection.";
+                    };
+                };
+            };
+            readonly Introductions: {
+                readonly title: "Introductions";
+                readonly description: "Who may ask the community to introduce them to this member. `anyone`: any active member who can find the entry. `groups`: only members who share a community group with them. `connections`: only members holding an attributed, in-force verified relationship with them. `off`: nobody. A refused introduction is never reported to its sender.";
+                readonly type: "string";
+                readonly enum: readonly ["anyone", "groups", "connections", "off"];
+            };
+            readonly Discoverability: {
+                readonly title: "Discoverability";
+                readonly description: "The member's three discoverability decisions, made separately.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["listing", "search", "external"];
+                readonly properties: {
+                    readonly listing: {
+                        readonly $ref: "#/$defs/Listing";
+                    };
+                    readonly search: {
+                        readonly type: "string";
+                        readonly enum: readonly ["byName", "exactNickname", "off"];
+                        readonly description: "What a member's search may match. `byName`: `displayName` or `nickname`. `exactNickname`: only an exact `nickname`. `off`: nothing. A DID is never a search key for a non-administrator, whatever this says.";
+                    };
+                    readonly external: {
+                        readonly type: "boolean";
+                        readonly description: "Whether the member publishes a public card — the fields whose visibility is `public`, signed by the member — through the community's trust registry. A second consent, separate from registry-publication consent (`publishConsent`), which it requires. A community that cannot yet publish external cards refuses `true` with `notAvailable`.";
+                    };
+                };
+            };
+            readonly Listing: {
+                readonly title: "Listing";
+                readonly description: "Whether members can find the entry. `listed`: it appears when members browse. `findable`: it does not appear when browsing, but a search that matches it under `search` returns it. `hidden`: no member finds it by browsing or searching; administrators still see it, and members who share a group that shows its members see it in that group's member list.";
+                readonly type: "string";
+                readonly enum: readonly ["listed", "findable", "hidden"];
+            };
+            readonly FieldVisibility: {
+                readonly title: "FieldVisibility";
+                readonly description: "The audience the member chose for each field. A field with no entry here takes its definition's `defaultVisibility`. The community MUST NOT widen a member's choice: widening a field's ceiling or default changes no visibility already recorded.";
+                readonly type: "object";
+                readonly maxProperties: 64;
+                readonly propertyNames: {
+                    readonly $ref: "#/$defs/FieldKey";
+                };
+                readonly additionalProperties: {
+                    readonly $ref: "#/$defs/Audience";
+                };
+            };
+            readonly Audience: {
+                readonly title: "Audience";
+                readonly description: "Who may see a directory field, ordered from narrowest to widest. `admins`: holders of `vtc.directory.admin` (and, for derived fields, `vtc.members.manage`). `groups`: members who share at least one community group with the subject (narrowed to the groups the subject names in `groupAudience`, where it names any). `connections`: members holding an attributed, in-force verified relationship with the subject at the community. `members`: every active member. `public`: anyone, and what the member's signed public card carries outside the community.\n\n`groups` and `connections` are not a chain: a viewer sees a field when they satisfy the audience the subject chose for it or any wider audience. Every audience includes the administrators, and the subject always sees their own whole card. There is no `onlyMe`: a value nobody else should see is not directory data.";
+                readonly type: "string";
+                readonly enum: readonly ["admins", "groups", "connections", "members", "public"];
+            };
+            readonly CardValues: {
+                readonly title: "CardValues";
+                readonly description: "A card's stored values, keyed by field. Holds `member`-, `admin`- and `credential`-sourced fields only; derived fields (`role`, `joinedAt`, `did`, `personhood`) are read from the community's own records when a projection is made, never stored here. At most 64 values, and at most 16 KiB serialized excluding the blobs a `CardBlobRef` names.";
+                readonly type: "object";
+                readonly maxProperties: 64;
+                readonly propertyNames: {
+                    readonly $ref: "#/$defs/FieldKey";
+                };
+                readonly additionalProperties: {
+                    readonly $ref: "#/$defs/FieldValue";
+                };
+            };
+            readonly FieldValue: {
+                readonly title: "FieldValue";
+                readonly description: "The value of one field. Which shape a field takes is fixed by its definition's `type`: text-like types (`text`, `longText`, `url`, `email`, `phone`, `enum`, `date` as YYYY-MM-DD, `country` as ISO 3166-1 alpha-2, `did`) are strings; `multiEnum` and the base field `links` are arrays of strings; `image` and the base field `avatar` are a `CardBlobRef`; `claim` is a `VerifiedValue`; the derived base field `personhood` is a boolean.";
+                readonly anyOf: readonly [{
+                    readonly type: "string";
+                    readonly maxLength: 2000;
+                }, {
+                    readonly type: "boolean";
+                }, {
+                    readonly type: "array";
+                    readonly maxItems: 32;
+                    readonly items: {
+                        readonly type: "string";
+                        readonly maxLength: 500;
+                    };
+                }, {
+                    readonly $ref: "#/$defs/CardBlobRef";
+                }, {
+                    readonly $ref: "#/$defs/VerifiedValue";
+                }];
+            };
+            readonly VerifiedValue: {
+                readonly title: "VerifiedValue";
+                readonly description: "The value of a `credential`-sourced field: a claim the member disclosed from a credential they presented, with the issuer that attests it. A verified value always names its issuer, and a self-asserted value is never shaped as one. The community keeps only the disclosed claim and these facts about it — never the presentation.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["value", "issuer", "verifiedAt"];
+                readonly properties: {
+                    readonly value: {
+                        readonly anyOf: readonly [{
+                            readonly type: "string";
+                            readonly maxLength: 2000;
+                        }, {
+                            readonly type: "boolean";
+                        }, {
+                            readonly type: "number";
+                        }];
+                        readonly description: "The disclosed claim value.";
+                    };
+                    readonly issuer: {
+                        readonly type: "string";
+                        readonly pattern: "^did:";
+                        readonly maxLength: 2048;
+                        readonly description: "DID of the credential's issuer, shown as the field's verification badge.";
+                    };
+                    readonly credentialType: {
+                        readonly type: "string";
+                        readonly minLength: 1;
+                        readonly maxLength: 128;
+                        readonly description: "The most specific `type` of the credential the claim came from.";
+                    };
+                    readonly verifiedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the community verified the presentation.";
+                    };
+                    readonly validUntil: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the credential expires, where it does. The community withdraws the value once it passes.";
+                    };
+                };
+            };
+            readonly CardBlobRef: {
+                readonly title: "CardBlobRef";
+                readonly description: "A content-addressed image held in the community's blob store — an avatar or an `image` field. At most 256 KiB, images only, re-encoded by the community on upload (metadata stripped, dimensions capped) so its digest does not link the member across communities. `url` and `urlExpiresAt` appear only in a projection: a short-lived URL the community checks against the same projection, so a member-only image is never a public URL.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["sha256", "mediaType"];
+                readonly properties: {
+                    readonly sha256: {
+                        readonly type: "string";
+                        readonly pattern: "^[0-9a-f]{64}$";
+                        readonly description: "Lowercase hex SHA-256 of the stored, re-encoded bytes.";
+                    };
+                    readonly mediaType: {
+                        readonly type: "string";
+                        readonly enum: readonly ["image/png", "image/jpeg", "image/webp", "image/avif"];
+                        readonly description: "Media type of the stored bytes.";
+                    };
+                    readonly size: {
+                        readonly type: "integer";
+                        readonly minimum: 1;
+                        readonly maximum: 262144;
+                        readonly description: "Size in bytes of the stored bytes.";
+                    };
+                    readonly url: {
+                        readonly type: "string";
+                        readonly format: "uri";
+                        readonly maxLength: 2048;
+                        readonly description: "Projection only: a URL the viewer can fetch the image from until `urlExpiresAt`.";
+                    };
+                    readonly urlExpiresAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "Projection only: when `url` stops working.";
+                    };
+                };
+            };
+            readonly EntryId: {
+                readonly title: "EntryId";
+                readonly description: "Opaque identifier of one directory entry: `dir_` followed by 16 to 64 base64url characters. Random, scoped to one community, and stable for the life of the membership — it survives a rotation of the member's DID, which is why groups, notes and cards are keyed by it. It MUST NOT be derived from, and MUST NOT reveal, any DID of the member, and the same person's entries in two communities MUST NOT share one. Compared by exact string equality.";
+                readonly type: "string";
+                readonly pattern: "^dir_[A-Za-z0-9_-]{16,64}$";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map