@openvtc/trust-tasks 0.26.17 → 0.26.19

package/dist/persona/contact/lists/put/1.0/payload.d.ts

@@ -0,0 +1,629 @@
+/**
+ * Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
+ * Source: specs/persona/contact/lists/put/1.0/payload.schema.json
+ */
+import type { ContactList, Ext, ListColour, ListId, ListName, ListOrder } from "../../../../../_shared/components.js";
+/**
+ * Create one of the holder's contact lists, or rename, recolour or reorder an existing one. Without `listId`: create, and `name` is required. With `listId`: update; each detail given replaces the stored one, `removeColour` removes the colour, and each detail absent is unchanged. Membership is not changed here — a contact's lists are set with persona/contact/put 1.1. The outer document members are owned by the framework — SPEC §6.3.
+ */
+export type PersonaContactListsPutPayload = {
+    contextId: string;
+    /**
+     * The list to update. Absent: create a new list, whose identifier the agent assigns and returns.
+     */
+    listId?: ListId;
+    /**
+     * The list's name. Required to create; on an update, replaces the name. Unique within the context.
+     */
+    name?: ListName;
+    /**
+     * The list's colour, replacing any it had. Absent: unchanged (none, on a create).
+     */
+    colour?: ListColour;
+    /**
+     * Remove the list's colour. Update only. Only `true` is accepted.
+     */
+    removeColour?: true;
+    /**
+     * Where the list sorts among the holder's lists. Absent on a create: after every existing list.
+     */
+    order?: ListOrder;
+    ext?: Ext;
+} & {
+    [k: string]: unknown | undefined;
+};
+/**
+ * Success response to persona/contact/lists/put. Type https://trusttasks.org/spec/persona/contact/lists/put/1.0#response. The list as it now stands.
+ */
+export interface PersonaContactListsPutResponsePayload {
+    list: ContactList;
+    /**
+     * True when this request created the list.
+     */
+    created: boolean;
+    /**
+     * True when this request created the list or changed any detail of it. False when every detail given already matched.
+     */
+    changed: boolean;
+    ext?: Ext;
+}
+/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
+export type { ContactList, Ext, ListColour, ListId, ListName, ListOrder };
+/** Trust Task type URI. */
+export declare const TYPE_URI: "https://trusttasks.org/spec/persona/contact/lists/put/1.0";
+/** Stable alias for this specification's request payload shape. */
+export type Payload = PersonaContactListsPutPayload;
+/** Trust Task response type URI (request type URI + "#response"). */
+export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/persona/contact/lists/put/1.0#response";
+/** Stable alias for this specification's success-response payload shape. */
+export type Response = PersonaContactListsPutResponsePayload;
+/**
+ * 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/persona/contact/lists/put/1.0";
+    readonly title: "Persona Contact Lists Put — payload";
+    readonly description: "Create one of the holder's contact lists, or rename, recolour or reorder an existing one. Without `listId`: create, and `name` is required. With `listId`: update; each detail given replaces the stored one, `removeColour` removes the colour, and each detail absent is unchanged. Membership is not changed here — a contact's lists are set with persona/contact/put 1.1. The outer document members are owned by the framework — SPEC §6.3.";
+    readonly type: "object";
+    readonly additionalProperties: false;
+    readonly required: readonly ["contextId"];
+    readonly oneOf: readonly [{
+        readonly required: readonly ["name"];
+        readonly not: {
+            readonly anyOf: readonly [{
+                readonly required: readonly ["listId"];
+            }, {
+                readonly required: readonly ["removeColour"];
+            }];
+        };
+    }, {
+        readonly required: readonly ["listId"];
+        readonly anyOf: readonly [{
+            readonly required: readonly ["name"];
+        }, {
+            readonly required: readonly ["colour"];
+        }, {
+            readonly required: readonly ["removeColour"];
+        }, {
+            readonly required: readonly ["order"];
+        }];
+    }];
+    readonly dependentSchemas: {
+        readonly removeColour: {
+            readonly not: {
+                readonly required: readonly ["colour"];
+            };
+        };
+    };
+    readonly properties: {
+        readonly contextId: {
+            readonly type: "string";
+            readonly minLength: 1;
+        };
+        readonly listId: {
+            readonly $ref: "#/$defs/ListId";
+            readonly description: "The list to update. Absent: create a new list, whose identifier the agent assigns and returns.";
+        };
+        readonly name: {
+            readonly $ref: "#/$defs/ListName";
+            readonly description: "The list's name. Required to create; on an update, replaces the name. Unique within the context.";
+        };
+        readonly colour: {
+            readonly $ref: "#/$defs/ListColour";
+            readonly description: "The list's colour, replacing any it had. Absent: unchanged (none, on a create).";
+        };
+        readonly removeColour: {
+            readonly type: "boolean";
+            readonly const: true;
+            readonly description: "Remove the list's colour. Update only. Only `true` is accepted.";
+        };
+        readonly order: {
+            readonly $ref: "#/$defs/ListOrder";
+            readonly description: "Where the list sorts among the holder's lists. Absent on a create: after every existing list.";
+        };
+        readonly ext: {
+            readonly $ref: "#/$defs/Ext";
+        };
+    };
+    readonly $defs: {
+        readonly Response: {
+            readonly $anchor: "response";
+            readonly title: "Persona Contact Lists Put — response payload";
+            readonly description: "Success response to persona/contact/lists/put. Type https://trusttasks.org/spec/persona/contact/lists/put/1.0#response. The list as it now stands.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["list", "created", "changed"];
+            readonly properties: {
+                readonly list: {
+                    readonly $ref: "#/$defs/ContactList";
+                };
+                readonly created: {
+                    readonly type: "boolean";
+                    readonly description: "True when this request created the list.";
+                };
+                readonly changed: {
+                    readonly type: "boolean";
+                    readonly description: "True when this request created the list or changed any detail of it. False when every detail given already matched.";
+                };
+                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 ContactList: {
+            readonly title: "ContactList";
+            readonly description: "One of the holder's lists, as their agent keeps it. A list is context-scoped, like the contacts it holds: it may hold contacts known by any persona in its context, and contacts from any number of communities, but never a contact of another context.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["listId", "name", "order", "contactCount", "createdAt", "updatedAt"];
+            readonly properties: {
+                readonly listId: {
+                    readonly $ref: "#/$defs/ListId";
+                };
+                readonly name: {
+                    readonly $ref: "#/$defs/ListName";
+                };
+                readonly colour: {
+                    readonly $ref: "#/$defs/ListColour";
+                };
+                readonly order: {
+                    readonly $ref: "#/$defs/ListOrder";
+                };
+                readonly contactCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "How many of the context's contacts are on the list now.";
+                };
+                readonly createdAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the list's name, colour or order last changed. Adding a contact to the list or removing one does not move it.";
+                };
+            };
+        };
+        readonly ListOrder: {
+            readonly title: "ListOrder";
+            readonly description: "Where the holder wants a list among their lists: ascending, ties broken by `name`. A sort key, not a position, so moving one list does not renumber the others; gaps are expected.";
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 1000000;
+        };
+        readonly ListColour: {
+            readonly title: "ListColour";
+            readonly description: "A colour the holder picked for a list, as a six-digit lowercase sRGB hex value (`#1f8a70`). A rendering hint: a consumer MAY map it to the nearest colour of its own palette that keeps contrast in light and dark themes, and MUST NOT rely on colour alone to tell lists apart.";
+            readonly type: "string";
+            readonly pattern: "^#[0-9a-f]{6}$";
+        };
+        readonly ListName: {
+            readonly title: "ListName";
+            readonly description: "The holder's name for one of their lists (\"Mentors\", \"Met at the spring meetup\"), on one line: no control characters. Unique within a context, compared exactly.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+        };
+        readonly ListId: {
+            readonly title: "ListId";
+            readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+            readonly type: "string";
+            readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+        };
+    };
+};
+/** 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: "Persona Contact Lists Put — response payload";
+            readonly description: "Success response to persona/contact/lists/put. Type https://trusttasks.org/spec/persona/contact/lists/put/1.0#response. The list as it now stands.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["list", "created", "changed"];
+            readonly properties: {
+                readonly list: {
+                    readonly $ref: "#/$defs/ContactList";
+                };
+                readonly created: {
+                    readonly type: "boolean";
+                    readonly description: "True when this request created the list.";
+                };
+                readonly changed: {
+                    readonly type: "boolean";
+                    readonly description: "True when this request created the list or changed any detail of it. False when every detail given already matched.";
+                };
+                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 ContactList: {
+            readonly title: "ContactList";
+            readonly description: "One of the holder's lists, as their agent keeps it. A list is context-scoped, like the contacts it holds: it may hold contacts known by any persona in its context, and contacts from any number of communities, but never a contact of another context.";
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["listId", "name", "order", "contactCount", "createdAt", "updatedAt"];
+            readonly properties: {
+                readonly listId: {
+                    readonly $ref: "#/$defs/ListId";
+                };
+                readonly name: {
+                    readonly $ref: "#/$defs/ListName";
+                };
+                readonly colour: {
+                    readonly $ref: "#/$defs/ListColour";
+                };
+                readonly order: {
+                    readonly $ref: "#/$defs/ListOrder";
+                };
+                readonly contactCount: {
+                    readonly type: "integer";
+                    readonly minimum: 0;
+                    readonly description: "How many of the context's contacts are on the list now.";
+                };
+                readonly createdAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                };
+                readonly updatedAt: {
+                    readonly type: "string";
+                    readonly format: "date-time";
+                    readonly description: "When the list's name, colour or order last changed. Adding a contact to the list or removing one does not move it.";
+                };
+            };
+        };
+        readonly ListOrder: {
+            readonly title: "ListOrder";
+            readonly description: "Where the holder wants a list among their lists: ascending, ties broken by `name`. A sort key, not a position, so moving one list does not renumber the others; gaps are expected.";
+            readonly type: "integer";
+            readonly minimum: 0;
+            readonly maximum: 1000000;
+        };
+        readonly ListColour: {
+            readonly title: "ListColour";
+            readonly description: "A colour the holder picked for a list, as a six-digit lowercase sRGB hex value (`#1f8a70`). A rendering hint: a consumer MAY map it to the nearest colour of its own palette that keeps contrast in light and dark themes, and MUST NOT rely on colour alone to tell lists apart.";
+            readonly type: "string";
+            readonly pattern: "^#[0-9a-f]{6}$";
+        };
+        readonly ListName: {
+            readonly title: "ListName";
+            readonly description: "The holder's name for one of their lists (\"Mentors\", \"Met at the spring meetup\"), on one line: no control characters. Unique within a context, compared exactly.";
+            readonly type: "string";
+            readonly minLength: 1;
+            readonly maxLength: 64;
+            readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+        };
+        readonly ListId: {
+            readonly title: "ListId";
+            readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+            readonly type: "string";
+            readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+        };
+    };
+};
+/**
+ * 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/persona/contact/lists/put/1.0";
+    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/persona/contact/lists/put/1.0";
+        readonly title: "Persona Contact Lists Put — payload";
+        readonly description: "Create one of the holder's contact lists, or rename, recolour or reorder an existing one. Without `listId`: create, and `name` is required. With `listId`: update; each detail given replaces the stored one, `removeColour` removes the colour, and each detail absent is unchanged. Membership is not changed here — a contact's lists are set with persona/contact/put 1.1. The outer document members are owned by the framework — SPEC §6.3.";
+        readonly type: "object";
+        readonly additionalProperties: false;
+        readonly required: readonly ["contextId"];
+        readonly oneOf: readonly [{
+            readonly required: readonly ["name"];
+            readonly not: {
+                readonly anyOf: readonly [{
+                    readonly required: readonly ["listId"];
+                }, {
+                    readonly required: readonly ["removeColour"];
+                }];
+            };
+        }, {
+            readonly required: readonly ["listId"];
+            readonly anyOf: readonly [{
+                readonly required: readonly ["name"];
+            }, {
+                readonly required: readonly ["colour"];
+            }, {
+                readonly required: readonly ["removeColour"];
+            }, {
+                readonly required: readonly ["order"];
+            }];
+        }];
+        readonly dependentSchemas: {
+            readonly removeColour: {
+                readonly not: {
+                    readonly required: readonly ["colour"];
+                };
+            };
+        };
+        readonly properties: {
+            readonly contextId: {
+                readonly type: "string";
+                readonly minLength: 1;
+            };
+            readonly listId: {
+                readonly $ref: "#/$defs/ListId";
+                readonly description: "The list to update. Absent: create a new list, whose identifier the agent assigns and returns.";
+            };
+            readonly name: {
+                readonly $ref: "#/$defs/ListName";
+                readonly description: "The list's name. Required to create; on an update, replaces the name. Unique within the context.";
+            };
+            readonly colour: {
+                readonly $ref: "#/$defs/ListColour";
+                readonly description: "The list's colour, replacing any it had. Absent: unchanged (none, on a create).";
+            };
+            readonly removeColour: {
+                readonly type: "boolean";
+                readonly const: true;
+                readonly description: "Remove the list's colour. Update only. Only `true` is accepted.";
+            };
+            readonly order: {
+                readonly $ref: "#/$defs/ListOrder";
+                readonly description: "Where the list sorts among the holder's lists. Absent on a create: after every existing list.";
+            };
+            readonly ext: {
+                readonly $ref: "#/$defs/Ext";
+            };
+        };
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Persona Contact Lists Put — response payload";
+                readonly description: "Success response to persona/contact/lists/put. Type https://trusttasks.org/spec/persona/contact/lists/put/1.0#response. The list as it now stands.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["list", "created", "changed"];
+                readonly properties: {
+                    readonly list: {
+                        readonly $ref: "#/$defs/ContactList";
+                    };
+                    readonly created: {
+                        readonly type: "boolean";
+                        readonly description: "True when this request created the list.";
+                    };
+                    readonly changed: {
+                        readonly type: "boolean";
+                        readonly description: "True when this request created the list or changed any detail of it. False when every detail given already matched.";
+                    };
+                    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 ContactList: {
+                readonly title: "ContactList";
+                readonly description: "One of the holder's lists, as their agent keeps it. A list is context-scoped, like the contacts it holds: it may hold contacts known by any persona in its context, and contacts from any number of communities, but never a contact of another context.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["listId", "name", "order", "contactCount", "createdAt", "updatedAt"];
+                readonly properties: {
+                    readonly listId: {
+                        readonly $ref: "#/$defs/ListId";
+                    };
+                    readonly name: {
+                        readonly $ref: "#/$defs/ListName";
+                    };
+                    readonly colour: {
+                        readonly $ref: "#/$defs/ListColour";
+                    };
+                    readonly order: {
+                        readonly $ref: "#/$defs/ListOrder";
+                    };
+                    readonly contactCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "How many of the context's contacts are on the list now.";
+                    };
+                    readonly createdAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the list's name, colour or order last changed. Adding a contact to the list or removing one does not move it.";
+                    };
+                };
+            };
+            readonly ListOrder: {
+                readonly title: "ListOrder";
+                readonly description: "Where the holder wants a list among their lists: ascending, ties broken by `name`. A sort key, not a position, so moving one list does not renumber the others; gaps are expected.";
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 1000000;
+            };
+            readonly ListColour: {
+                readonly title: "ListColour";
+                readonly description: "A colour the holder picked for a list, as a six-digit lowercase sRGB hex value (`#1f8a70`). A rendering hint: a consumer MAY map it to the nearest colour of its own palette that keeps contrast in light and dark themes, and MUST NOT rely on colour alone to tell lists apart.";
+                readonly type: "string";
+                readonly pattern: "^#[0-9a-f]{6}$";
+            };
+            readonly ListName: {
+                readonly title: "ListName";
+                readonly description: "The holder's name for one of their lists (\"Mentors\", \"Met at the spring meetup\"), on one line: no control characters. Unique within a context, compared exactly.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            };
+            readonly ListId: {
+                readonly title: "ListId";
+                readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+                readonly type: "string";
+                readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+            };
+        };
+    };
+};
+/**
+ * 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/persona/contact/lists/put/1.0#response";
+    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 $ref: "#/$defs/Response";
+        readonly $defs: {
+            readonly Response: {
+                readonly $anchor: "response";
+                readonly title: "Persona Contact Lists Put — response payload";
+                readonly description: "Success response to persona/contact/lists/put. Type https://trusttasks.org/spec/persona/contact/lists/put/1.0#response. The list as it now stands.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["list", "created", "changed"];
+                readonly properties: {
+                    readonly list: {
+                        readonly $ref: "#/$defs/ContactList";
+                    };
+                    readonly created: {
+                        readonly type: "boolean";
+                        readonly description: "True when this request created the list.";
+                    };
+                    readonly changed: {
+                        readonly type: "boolean";
+                        readonly description: "True when this request created the list or changed any detail of it. False when every detail given already matched.";
+                    };
+                    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 ContactList: {
+                readonly title: "ContactList";
+                readonly description: "One of the holder's lists, as their agent keeps it. A list is context-scoped, like the contacts it holds: it may hold contacts known by any persona in its context, and contacts from any number of communities, but never a contact of another context.";
+                readonly type: "object";
+                readonly additionalProperties: false;
+                readonly required: readonly ["listId", "name", "order", "contactCount", "createdAt", "updatedAt"];
+                readonly properties: {
+                    readonly listId: {
+                        readonly $ref: "#/$defs/ListId";
+                    };
+                    readonly name: {
+                        readonly $ref: "#/$defs/ListName";
+                    };
+                    readonly colour: {
+                        readonly $ref: "#/$defs/ListColour";
+                    };
+                    readonly order: {
+                        readonly $ref: "#/$defs/ListOrder";
+                    };
+                    readonly contactCount: {
+                        readonly type: "integer";
+                        readonly minimum: 0;
+                        readonly description: "How many of the context's contacts are on the list now.";
+                    };
+                    readonly createdAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                    };
+                    readonly updatedAt: {
+                        readonly type: "string";
+                        readonly format: "date-time";
+                        readonly description: "When the list's name, colour or order last changed. Adding a contact to the list or removing one does not move it.";
+                    };
+                };
+            };
+            readonly ListOrder: {
+                readonly title: "ListOrder";
+                readonly description: "Where the holder wants a list among their lists: ascending, ties broken by `name`. A sort key, not a position, so moving one list does not renumber the others; gaps are expected.";
+                readonly type: "integer";
+                readonly minimum: 0;
+                readonly maximum: 1000000;
+            };
+            readonly ListColour: {
+                readonly title: "ListColour";
+                readonly description: "A colour the holder picked for a list, as a six-digit lowercase sRGB hex value (`#1f8a70`). A rendering hint: a consumer MAY map it to the nearest colour of its own palette that keeps contrast in light and dark themes, and MUST NOT rely on colour alone to tell lists apart.";
+                readonly type: "string";
+                readonly pattern: "^#[0-9a-f]{6}$";
+            };
+            readonly ListName: {
+                readonly title: "ListName";
+                readonly description: "The holder's name for one of their lists (\"Mentors\", \"Met at the spring meetup\"), on one line: no control characters. Unique within a context, compared exactly.";
+                readonly type: "string";
+                readonly minLength: 1;
+                readonly maxLength: 64;
+                readonly pattern: "^[^\\u0000-\\u001F\\u007F]+$";
+            };
+            readonly ListId: {
+                readonly title: "ListId";
+                readonly description: "Identifier of one of the holder's contact lists: a ULID in Crockford base32, uppercase, assigned by the agent when the list is created. Meaningful only inside the context that holds the list; it is never sent to anyone but the holder's own clients.";
+                readonly type: "string";
+                readonly pattern: "^[0-9A-HJKMNP-TV-Z]{26}$";
+            };
+        };
+    };
+};
+//# sourceMappingURL=payload.d.ts.map

package/dist/persona/contact/lists/put/1.0/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../../src/persona/contact/lists/put/1.0/payload.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAGtH;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;IAChB;;OAEG;IACH,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;OAEG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX,GAAG;IACF,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;CAClC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qCAAqC;IACpD,IAAI,EAAE,WAAW,CAAC;IAClB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,GAAG,CAAC;CACX;AAED,kHAAkH;AAClH,YAAY,EAAE,WAAW,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AAE1E,2BAA2B;AAC3B,eAAO,MAAM,QAAQ,EAAG,2DAAoE,CAAC;AAE7F,mEAAmE;AACnE,MAAM,MAAM,OAAO,GAAG,6BAA6B,CAAC;AAEpD,qEAAqE;AACrE,eAAO,MAAM,iBAAiB,EAAG,oEAA6E,CAAC;AAE/G,4EAA4E;AAC5E,MAAM,MAAM,QAAQ,GAAG,qCAAqC,CAAC;AAE7D;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8MjB,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgH1B,CAAC;AAEX;;;;;GAKG;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOP,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAOhB,CAAC"}