@openvtc/trust-tasks 0.17.5 → 0.17.6
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +27 -0
- package/dist/auth/step-up/approve-response/0.3/payload.d.ts +887 -0
- package/dist/auth/step-up/approve-response/0.3/payload.d.ts.map +1 -0
- package/dist/auth/step-up/approve-response/0.3/payload.js +505 -0
- package/dist/auth/step-up/approve-response/0.3/payload.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/index.js.map +1 -1
- package/dist/persona/claim-types/list/1.0/payload.d.ts +772 -0
- package/dist/persona/claim-types/list/1.0/payload.d.ts.map +1 -0
- package/dist/persona/claim-types/list/1.0/payload.js +389 -0
- package/dist/persona/claim-types/list/1.0/payload.js.map +1 -0
- package/package.json +1 -1
- package/src/auth/step-up/approve-response/0.3/payload.ts +594 -0
- package/src/index.ts +2 -0
- package/src/persona/claim-types/list/1.0/payload.ts +590 -0
|
@@ -0,0 +1,772 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Generated by scripts/build-ts-bindings.mjs — DO NOT EDIT BY HAND.
|
|
3
|
+
* Source: specs/persona/claim-types/list/1.0/payload.schema.json
|
|
4
|
+
*/
|
|
5
|
+
import type { ClaimType, Ext, ReleaseRequirement, Sensitivity } from "../../../../_shared/components.js";
|
|
6
|
+
/**
|
|
7
|
+
* Serve the claim-type registry this agent resolves against. A client that cannot read the table has to ship a copy of it, and a copy is a re-sync obligation on every change.
|
|
8
|
+
*/
|
|
9
|
+
export interface PersonaClaimTypesListPayload {
|
|
10
|
+
ext?: Ext;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Success response to persona/claim-types/list. Type https://trusttasks.org/spec/persona/claim-types/list/1.0#response.
|
|
14
|
+
*/
|
|
15
|
+
export interface PersonaClaimTypesListResponsePayload {
|
|
16
|
+
/**
|
|
17
|
+
* Version of the core registry this agent implements — the version of _shared/claim-types.json, not of this task. A client caching the table keys the cache on this.
|
|
18
|
+
*/
|
|
19
|
+
registryVersion: string;
|
|
20
|
+
/**
|
|
21
|
+
* The registered tokens. Both exact tokens and family prefixes appear here, undistinguished: which one an entry is follows from whether a given token equals it or descends from it, and marking them would invite a client to walk only one kind.
|
|
22
|
+
*
|
|
23
|
+
* @maxItems 512
|
|
24
|
+
*/
|
|
25
|
+
entries: {
|
|
26
|
+
type: ClaimType;
|
|
27
|
+
sensitivity: Sensitivity;
|
|
28
|
+
release: ReleaseRequirement;
|
|
29
|
+
/**
|
|
30
|
+
* Mask style, independent of sensitivity: any style that is not `none` is masked on screen whatever the sensitivity. Named rather than enumerated inline so a maintainer may serve a style this version does not list; a client that does not recognise a style MUST treat it as `full` rather than as `none`.
|
|
31
|
+
*/
|
|
32
|
+
mask: string;
|
|
33
|
+
/**
|
|
34
|
+
* Marks a type a community may ask for without it being remarkable. The minimum set contains only normal-sensitivity, consent-release types; that is a rule rather than a coincidence.
|
|
35
|
+
*/
|
|
36
|
+
minimumSet?: boolean;
|
|
37
|
+
/**
|
|
38
|
+
* OIDC standard claims this type answers. A recorded mapping, applied at presentation — the token stays the maintainer's own and no external vocabulary is primary.
|
|
39
|
+
*
|
|
40
|
+
* @maxItems 16
|
|
41
|
+
*/
|
|
42
|
+
oidc?: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [
|
|
43
|
+
string,
|
|
44
|
+
string,
|
|
45
|
+
string,
|
|
46
|
+
string,
|
|
47
|
+
string,
|
|
48
|
+
string,
|
|
49
|
+
string,
|
|
50
|
+
string,
|
|
51
|
+
string,
|
|
52
|
+
string,
|
|
53
|
+
string,
|
|
54
|
+
string,
|
|
55
|
+
string,
|
|
56
|
+
string,
|
|
57
|
+
string
|
|
58
|
+
] | [
|
|
59
|
+
string,
|
|
60
|
+
string,
|
|
61
|
+
string,
|
|
62
|
+
string,
|
|
63
|
+
string,
|
|
64
|
+
string,
|
|
65
|
+
string,
|
|
66
|
+
string,
|
|
67
|
+
string,
|
|
68
|
+
string,
|
|
69
|
+
string,
|
|
70
|
+
string,
|
|
71
|
+
string,
|
|
72
|
+
string,
|
|
73
|
+
string,
|
|
74
|
+
string
|
|
75
|
+
];
|
|
76
|
+
}[];
|
|
77
|
+
/**
|
|
78
|
+
* The floor: what a token with no entry and no registered prefix resolves to. Served rather than assumed, because a client that hard-codes it cannot be tightened by a maintainer that raises it.
|
|
79
|
+
*/
|
|
80
|
+
unregistered: {
|
|
81
|
+
sensitivity: Sensitivity;
|
|
82
|
+
release: ReleaseRequirement;
|
|
83
|
+
mask: string;
|
|
84
|
+
};
|
|
85
|
+
/**
|
|
86
|
+
* Each axis ordered MOST PROTECTIVE FIRST. This is what makes rule 3 computable by a client: resolution takes the longest registered prefix and the unregistered floor and keeps whichever is more protective, which requires an ordering the client did not invent.
|
|
87
|
+
*/
|
|
88
|
+
strictness: {
|
|
89
|
+
/**
|
|
90
|
+
* @maxItems 8
|
|
91
|
+
*/
|
|
92
|
+
sensitivity: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string];
|
|
93
|
+
/**
|
|
94
|
+
* @maxItems 8
|
|
95
|
+
*/
|
|
96
|
+
release: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string];
|
|
97
|
+
/**
|
|
98
|
+
* @maxItems 16
|
|
99
|
+
*/
|
|
100
|
+
mask: [] | [string] | [string, string] | [string, string, string] | [string, string, string, string] | [string, string, string, string, string] | [string, string, string, string, string, string] | [string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string] | [string, string, string, string, string, string, string, string, string, string, string, string, string, string] | [
|
|
101
|
+
string,
|
|
102
|
+
string,
|
|
103
|
+
string,
|
|
104
|
+
string,
|
|
105
|
+
string,
|
|
106
|
+
string,
|
|
107
|
+
string,
|
|
108
|
+
string,
|
|
109
|
+
string,
|
|
110
|
+
string,
|
|
111
|
+
string,
|
|
112
|
+
string,
|
|
113
|
+
string,
|
|
114
|
+
string,
|
|
115
|
+
string
|
|
116
|
+
] | [
|
|
117
|
+
string,
|
|
118
|
+
string,
|
|
119
|
+
string,
|
|
120
|
+
string,
|
|
121
|
+
string,
|
|
122
|
+
string,
|
|
123
|
+
string,
|
|
124
|
+
string,
|
|
125
|
+
string,
|
|
126
|
+
string,
|
|
127
|
+
string,
|
|
128
|
+
string,
|
|
129
|
+
string,
|
|
130
|
+
string,
|
|
131
|
+
string,
|
|
132
|
+
string
|
|
133
|
+
];
|
|
134
|
+
};
|
|
135
|
+
ext?: Ext;
|
|
136
|
+
}
|
|
137
|
+
/** Shared definitions this specification references, re-exported under the names it used to declare them with. */
|
|
138
|
+
export type { ClaimType, Ext, ReleaseRequirement, Sensitivity };
|
|
139
|
+
/** Trust Task type URI. */
|
|
140
|
+
export declare const TYPE_URI: "https://trusttasks.org/spec/persona/claim-types/list/1.0";
|
|
141
|
+
/** Stable alias for this specification's request payload shape. */
|
|
142
|
+
export type Payload = PersonaClaimTypesListPayload;
|
|
143
|
+
/** Trust Task response type URI (request type URI + "#response"). */
|
|
144
|
+
export declare const RESPONSE_TYPE_URI: "https://trusttasks.org/spec/persona/claim-types/list/1.0#response";
|
|
145
|
+
/** Stable alias for this specification's success-response payload shape. */
|
|
146
|
+
export type Response = PersonaClaimTypesListResponsePayload;
|
|
147
|
+
/**
|
|
148
|
+
* This specification's payload schema, as a value.
|
|
149
|
+
*
|
|
150
|
+
* SPEC.md §7.2 item 2 is performed against this. It is shipped as data
|
|
151
|
+
* rather than only as a `.json` file because TypeScript types are erased
|
|
152
|
+
* at runtime: without a schema a consumer has nothing to validate, and
|
|
153
|
+
* every REQUIRED payload member is optional in practice. Cross-file
|
|
154
|
+
* `$ref`s are already inlined, so it needs no resolver.
|
|
155
|
+
*/
|
|
156
|
+
export declare const PAYLOAD_SCHEMA: {
|
|
157
|
+
readonly $schema: "https://json-schema.org/draft/2020-12/schema";
|
|
158
|
+
readonly $id: "https://trusttasks.org/spec/persona/claim-types/list/1.0";
|
|
159
|
+
readonly title: "Persona Claim Types List — payload";
|
|
160
|
+
readonly description: "Serve the claim-type registry this agent resolves against. A client that cannot read the table has to ship a copy of it, and a copy is a re-sync obligation on every change.";
|
|
161
|
+
readonly type: "object";
|
|
162
|
+
readonly additionalProperties: false;
|
|
163
|
+
readonly properties: {
|
|
164
|
+
readonly ext: {
|
|
165
|
+
readonly $ref: "#/$defs/Ext";
|
|
166
|
+
};
|
|
167
|
+
};
|
|
168
|
+
readonly $defs: {
|
|
169
|
+
readonly Response: {
|
|
170
|
+
readonly $anchor: "response";
|
|
171
|
+
readonly title: "Persona Claim Types List — response payload";
|
|
172
|
+
readonly description: "Success response to persona/claim-types/list. Type https://trusttasks.org/spec/persona/claim-types/list/1.0#response.";
|
|
173
|
+
readonly type: "object";
|
|
174
|
+
readonly additionalProperties: false;
|
|
175
|
+
readonly required: readonly ["registryVersion", "entries", "unregistered", "strictness"];
|
|
176
|
+
readonly properties: {
|
|
177
|
+
readonly registryVersion: {
|
|
178
|
+
readonly type: "string";
|
|
179
|
+
readonly maxLength: 32;
|
|
180
|
+
readonly description: "Version of the core registry this agent implements — the version of _shared/claim-types.json, not of this task. A client caching the table keys the cache on this.";
|
|
181
|
+
};
|
|
182
|
+
readonly entries: {
|
|
183
|
+
readonly type: "array";
|
|
184
|
+
readonly maxItems: 512;
|
|
185
|
+
readonly description: "The registered tokens. Both exact tokens and family prefixes appear here, undistinguished: which one an entry is follows from whether a given token equals it or descends from it, and marking them would invite a client to walk only one kind.";
|
|
186
|
+
readonly items: {
|
|
187
|
+
readonly type: "object";
|
|
188
|
+
readonly additionalProperties: false;
|
|
189
|
+
readonly required: readonly ["type", "sensitivity", "release", "mask"];
|
|
190
|
+
readonly properties: {
|
|
191
|
+
readonly type: {
|
|
192
|
+
readonly $ref: "#/$defs/ClaimType";
|
|
193
|
+
};
|
|
194
|
+
readonly sensitivity: {
|
|
195
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
196
|
+
};
|
|
197
|
+
readonly release: {
|
|
198
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
199
|
+
};
|
|
200
|
+
readonly mask: {
|
|
201
|
+
readonly type: "string";
|
|
202
|
+
readonly maxLength: 32;
|
|
203
|
+
readonly description: "Mask style, independent of sensitivity: any style that is not `none` is masked on screen whatever the sensitivity. Named rather than enumerated inline so a maintainer may serve a style this version does not list; a client that does not recognise a style MUST treat it as `full` rather than as `none`.";
|
|
204
|
+
};
|
|
205
|
+
readonly minimumSet: {
|
|
206
|
+
readonly type: "boolean";
|
|
207
|
+
readonly description: "Marks a type a community may ask for without it being remarkable. The minimum set contains only normal-sensitivity, consent-release types; that is a rule rather than a coincidence.";
|
|
208
|
+
};
|
|
209
|
+
readonly oidc: {
|
|
210
|
+
readonly type: "array";
|
|
211
|
+
readonly maxItems: 16;
|
|
212
|
+
readonly items: {
|
|
213
|
+
readonly type: "string";
|
|
214
|
+
readonly maxLength: 64;
|
|
215
|
+
};
|
|
216
|
+
readonly description: "OIDC standard claims this type answers. A recorded mapping, applied at presentation — the token stays the maintainer's own and no external vocabulary is primary.";
|
|
217
|
+
};
|
|
218
|
+
};
|
|
219
|
+
};
|
|
220
|
+
};
|
|
221
|
+
readonly unregistered: {
|
|
222
|
+
readonly type: "object";
|
|
223
|
+
readonly additionalProperties: false;
|
|
224
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
225
|
+
readonly description: "The floor: what a token with no entry and no registered prefix resolves to. Served rather than assumed, because a client that hard-codes it cannot be tightened by a maintainer that raises it.";
|
|
226
|
+
readonly properties: {
|
|
227
|
+
readonly sensitivity: {
|
|
228
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
229
|
+
};
|
|
230
|
+
readonly release: {
|
|
231
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
232
|
+
};
|
|
233
|
+
readonly mask: {
|
|
234
|
+
readonly type: "string";
|
|
235
|
+
readonly maxLength: 32;
|
|
236
|
+
};
|
|
237
|
+
};
|
|
238
|
+
};
|
|
239
|
+
readonly strictness: {
|
|
240
|
+
readonly type: "object";
|
|
241
|
+
readonly additionalProperties: false;
|
|
242
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
243
|
+
readonly description: "Each axis ordered MOST PROTECTIVE FIRST. This is what makes rule 3 computable by a client: resolution takes the longest registered prefix and the unregistered floor and keeps whichever is more protective, which requires an ordering the client did not invent.";
|
|
244
|
+
readonly properties: {
|
|
245
|
+
readonly sensitivity: {
|
|
246
|
+
readonly type: "array";
|
|
247
|
+
readonly maxItems: 8;
|
|
248
|
+
readonly items: {
|
|
249
|
+
readonly type: "string";
|
|
250
|
+
readonly maxLength: 32;
|
|
251
|
+
};
|
|
252
|
+
};
|
|
253
|
+
readonly release: {
|
|
254
|
+
readonly type: "array";
|
|
255
|
+
readonly maxItems: 8;
|
|
256
|
+
readonly items: {
|
|
257
|
+
readonly type: "string";
|
|
258
|
+
readonly maxLength: 32;
|
|
259
|
+
};
|
|
260
|
+
};
|
|
261
|
+
readonly mask: {
|
|
262
|
+
readonly type: "array";
|
|
263
|
+
readonly maxItems: 16;
|
|
264
|
+
readonly items: {
|
|
265
|
+
readonly type: "string";
|
|
266
|
+
readonly maxLength: 32;
|
|
267
|
+
};
|
|
268
|
+
};
|
|
269
|
+
};
|
|
270
|
+
};
|
|
271
|
+
readonly ext: {
|
|
272
|
+
readonly $ref: "#/$defs/Ext";
|
|
273
|
+
};
|
|
274
|
+
};
|
|
275
|
+
};
|
|
276
|
+
readonly Ext: {
|
|
277
|
+
readonly title: "Ext";
|
|
278
|
+
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.";
|
|
279
|
+
readonly type: "object";
|
|
280
|
+
readonly minProperties: 1;
|
|
281
|
+
readonly additionalProperties: true;
|
|
282
|
+
readonly propertyNames: {
|
|
283
|
+
readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
|
|
284
|
+
};
|
|
285
|
+
};
|
|
286
|
+
readonly ReleaseRequirement: {
|
|
287
|
+
readonly title: "ReleaseRequirement";
|
|
288
|
+
readonly description: "What it takes to let a value LEAVE. Distinct from `Sensitivity`, which governs showing it to the holder.\n\n`consent` is the ordinary gate: `persona/disclosure/preview` renders what would leave and `persona/disclosure/present` releases it, so a human sees it once.\n\n`stepUp` additionally requires a fresh authentication bound to THAT preview — not to the session. Without the binding, \"each time\" degrades into \"once per login\", which is the failure the requirement exists to prevent; the single-use `previewId` the preview already mints is what an implementation binds to. A maintainer MUST refuse `persona/disclosure/present` for a `stepUp` attribute when no such approval accompanies it.\n\nAbsent means *not decided by the holder* and resolves from the claim-type registry, which defaults `payment.*` and `gov.*` to `stepUp`.";
|
|
289
|
+
readonly type: "string";
|
|
290
|
+
readonly enum: readonly ["consent", "stepUp"];
|
|
291
|
+
};
|
|
292
|
+
readonly Sensitivity: {
|
|
293
|
+
readonly title: "Sensitivity";
|
|
294
|
+
readonly description: "How carefully a value is shown TO ITS OWN HOLDER. `high` means a consumer masks it by default, reveals it one attribute at a time on a deliberate act, and — the half that is not cosmetic — omits it from a listing that did not ask for sensitive values.\n\nAbsent means *not decided by the holder*, not `normal`: a consumer resolves it from the claim-type registry (see CLAIM-TYPES.md §4), which is why this member is optional and why an unregistered token resolves conservatively rather than permissively.\n\nDistinct from how linkable the value is. A payment card is highly sensitive and barely linkable — every card number is unique, so knowing one tells a second verifier nothing about the first. Reading either as a proxy for the other produces a consumer that hides the wrong things.";
|
|
295
|
+
readonly type: "string";
|
|
296
|
+
readonly enum: readonly ["normal", "high"];
|
|
297
|
+
};
|
|
298
|
+
readonly ClaimType: {
|
|
299
|
+
readonly title: "ClaimType";
|
|
300
|
+
readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
|
|
301
|
+
readonly type: "string";
|
|
302
|
+
readonly minLength: 1;
|
|
303
|
+
readonly maxLength: 128;
|
|
304
|
+
readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
|
|
305
|
+
};
|
|
306
|
+
};
|
|
307
|
+
};
|
|
308
|
+
/** As {@link PAYLOAD_SCHEMA}, for the success-response variant. */
|
|
309
|
+
export declare const RESPONSE_PAYLOAD_SCHEMA: {
|
|
310
|
+
readonly $schema: "https://json-schema.org/draft/2020-12/schema";
|
|
311
|
+
readonly $ref: "#/$defs/Response";
|
|
312
|
+
readonly $defs: {
|
|
313
|
+
readonly Response: {
|
|
314
|
+
readonly $anchor: "response";
|
|
315
|
+
readonly title: "Persona Claim Types List — response payload";
|
|
316
|
+
readonly description: "Success response to persona/claim-types/list. Type https://trusttasks.org/spec/persona/claim-types/list/1.0#response.";
|
|
317
|
+
readonly type: "object";
|
|
318
|
+
readonly additionalProperties: false;
|
|
319
|
+
readonly required: readonly ["registryVersion", "entries", "unregistered", "strictness"];
|
|
320
|
+
readonly properties: {
|
|
321
|
+
readonly registryVersion: {
|
|
322
|
+
readonly type: "string";
|
|
323
|
+
readonly maxLength: 32;
|
|
324
|
+
readonly description: "Version of the core registry this agent implements — the version of _shared/claim-types.json, not of this task. A client caching the table keys the cache on this.";
|
|
325
|
+
};
|
|
326
|
+
readonly entries: {
|
|
327
|
+
readonly type: "array";
|
|
328
|
+
readonly maxItems: 512;
|
|
329
|
+
readonly description: "The registered tokens. Both exact tokens and family prefixes appear here, undistinguished: which one an entry is follows from whether a given token equals it or descends from it, and marking them would invite a client to walk only one kind.";
|
|
330
|
+
readonly items: {
|
|
331
|
+
readonly type: "object";
|
|
332
|
+
readonly additionalProperties: false;
|
|
333
|
+
readonly required: readonly ["type", "sensitivity", "release", "mask"];
|
|
334
|
+
readonly properties: {
|
|
335
|
+
readonly type: {
|
|
336
|
+
readonly $ref: "#/$defs/ClaimType";
|
|
337
|
+
};
|
|
338
|
+
readonly sensitivity: {
|
|
339
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
340
|
+
};
|
|
341
|
+
readonly release: {
|
|
342
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
343
|
+
};
|
|
344
|
+
readonly mask: {
|
|
345
|
+
readonly type: "string";
|
|
346
|
+
readonly maxLength: 32;
|
|
347
|
+
readonly description: "Mask style, independent of sensitivity: any style that is not `none` is masked on screen whatever the sensitivity. Named rather than enumerated inline so a maintainer may serve a style this version does not list; a client that does not recognise a style MUST treat it as `full` rather than as `none`.";
|
|
348
|
+
};
|
|
349
|
+
readonly minimumSet: {
|
|
350
|
+
readonly type: "boolean";
|
|
351
|
+
readonly description: "Marks a type a community may ask for without it being remarkable. The minimum set contains only normal-sensitivity, consent-release types; that is a rule rather than a coincidence.";
|
|
352
|
+
};
|
|
353
|
+
readonly oidc: {
|
|
354
|
+
readonly type: "array";
|
|
355
|
+
readonly maxItems: 16;
|
|
356
|
+
readonly items: {
|
|
357
|
+
readonly type: "string";
|
|
358
|
+
readonly maxLength: 64;
|
|
359
|
+
};
|
|
360
|
+
readonly description: "OIDC standard claims this type answers. A recorded mapping, applied at presentation — the token stays the maintainer's own and no external vocabulary is primary.";
|
|
361
|
+
};
|
|
362
|
+
};
|
|
363
|
+
};
|
|
364
|
+
};
|
|
365
|
+
readonly unregistered: {
|
|
366
|
+
readonly type: "object";
|
|
367
|
+
readonly additionalProperties: false;
|
|
368
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
369
|
+
readonly description: "The floor: what a token with no entry and no registered prefix resolves to. Served rather than assumed, because a client that hard-codes it cannot be tightened by a maintainer that raises it.";
|
|
370
|
+
readonly properties: {
|
|
371
|
+
readonly sensitivity: {
|
|
372
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
373
|
+
};
|
|
374
|
+
readonly release: {
|
|
375
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
376
|
+
};
|
|
377
|
+
readonly mask: {
|
|
378
|
+
readonly type: "string";
|
|
379
|
+
readonly maxLength: 32;
|
|
380
|
+
};
|
|
381
|
+
};
|
|
382
|
+
};
|
|
383
|
+
readonly strictness: {
|
|
384
|
+
readonly type: "object";
|
|
385
|
+
readonly additionalProperties: false;
|
|
386
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
387
|
+
readonly description: "Each axis ordered MOST PROTECTIVE FIRST. This is what makes rule 3 computable by a client: resolution takes the longest registered prefix and the unregistered floor and keeps whichever is more protective, which requires an ordering the client did not invent.";
|
|
388
|
+
readonly properties: {
|
|
389
|
+
readonly sensitivity: {
|
|
390
|
+
readonly type: "array";
|
|
391
|
+
readonly maxItems: 8;
|
|
392
|
+
readonly items: {
|
|
393
|
+
readonly type: "string";
|
|
394
|
+
readonly maxLength: 32;
|
|
395
|
+
};
|
|
396
|
+
};
|
|
397
|
+
readonly release: {
|
|
398
|
+
readonly type: "array";
|
|
399
|
+
readonly maxItems: 8;
|
|
400
|
+
readonly items: {
|
|
401
|
+
readonly type: "string";
|
|
402
|
+
readonly maxLength: 32;
|
|
403
|
+
};
|
|
404
|
+
};
|
|
405
|
+
readonly mask: {
|
|
406
|
+
readonly type: "array";
|
|
407
|
+
readonly maxItems: 16;
|
|
408
|
+
readonly items: {
|
|
409
|
+
readonly type: "string";
|
|
410
|
+
readonly maxLength: 32;
|
|
411
|
+
};
|
|
412
|
+
};
|
|
413
|
+
};
|
|
414
|
+
};
|
|
415
|
+
readonly ext: {
|
|
416
|
+
readonly $ref: "#/$defs/Ext";
|
|
417
|
+
};
|
|
418
|
+
};
|
|
419
|
+
};
|
|
420
|
+
readonly Ext: {
|
|
421
|
+
readonly title: "Ext";
|
|
422
|
+
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.";
|
|
423
|
+
readonly type: "object";
|
|
424
|
+
readonly minProperties: 1;
|
|
425
|
+
readonly additionalProperties: true;
|
|
426
|
+
readonly propertyNames: {
|
|
427
|
+
readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
|
|
428
|
+
};
|
|
429
|
+
};
|
|
430
|
+
readonly ReleaseRequirement: {
|
|
431
|
+
readonly title: "ReleaseRequirement";
|
|
432
|
+
readonly description: "What it takes to let a value LEAVE. Distinct from `Sensitivity`, which governs showing it to the holder.\n\n`consent` is the ordinary gate: `persona/disclosure/preview` renders what would leave and `persona/disclosure/present` releases it, so a human sees it once.\n\n`stepUp` additionally requires a fresh authentication bound to THAT preview — not to the session. Without the binding, \"each time\" degrades into \"once per login\", which is the failure the requirement exists to prevent; the single-use `previewId` the preview already mints is what an implementation binds to. A maintainer MUST refuse `persona/disclosure/present` for a `stepUp` attribute when no such approval accompanies it.\n\nAbsent means *not decided by the holder* and resolves from the claim-type registry, which defaults `payment.*` and `gov.*` to `stepUp`.";
|
|
433
|
+
readonly type: "string";
|
|
434
|
+
readonly enum: readonly ["consent", "stepUp"];
|
|
435
|
+
};
|
|
436
|
+
readonly Sensitivity: {
|
|
437
|
+
readonly title: "Sensitivity";
|
|
438
|
+
readonly description: "How carefully a value is shown TO ITS OWN HOLDER. `high` means a consumer masks it by default, reveals it one attribute at a time on a deliberate act, and — the half that is not cosmetic — omits it from a listing that did not ask for sensitive values.\n\nAbsent means *not decided by the holder*, not `normal`: a consumer resolves it from the claim-type registry (see CLAIM-TYPES.md §4), which is why this member is optional and why an unregistered token resolves conservatively rather than permissively.\n\nDistinct from how linkable the value is. A payment card is highly sensitive and barely linkable — every card number is unique, so knowing one tells a second verifier nothing about the first. Reading either as a proxy for the other produces a consumer that hides the wrong things.";
|
|
439
|
+
readonly type: "string";
|
|
440
|
+
readonly enum: readonly ["normal", "high"];
|
|
441
|
+
};
|
|
442
|
+
readonly ClaimType: {
|
|
443
|
+
readonly title: "ClaimType";
|
|
444
|
+
readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
|
|
445
|
+
readonly type: "string";
|
|
446
|
+
readonly minLength: 1;
|
|
447
|
+
readonly maxLength: 128;
|
|
448
|
+
readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
|
|
449
|
+
};
|
|
450
|
+
};
|
|
451
|
+
};
|
|
452
|
+
/**
|
|
453
|
+
* SPEC.md §7.2 policy for the request variant, from this specification's
|
|
454
|
+
* front matter. Pass to `consumeInbound` — items 5b, 7 and 8 are
|
|
455
|
+
* per-specification and cannot be derived from the document alone, and
|
|
456
|
+
* item 2 needs the schema this carries.
|
|
457
|
+
*/
|
|
458
|
+
export declare const SPEC: {
|
|
459
|
+
readonly typeUri: "https://trusttasks.org/spec/persona/claim-types/list/1.0";
|
|
460
|
+
readonly isBearer: false;
|
|
461
|
+
readonly isProofRequired: true;
|
|
462
|
+
readonly isRecipientRequired: true;
|
|
463
|
+
readonly isIssuedAtRequired: false;
|
|
464
|
+
readonly payloadSchema: {
|
|
465
|
+
readonly $schema: "https://json-schema.org/draft/2020-12/schema";
|
|
466
|
+
readonly $id: "https://trusttasks.org/spec/persona/claim-types/list/1.0";
|
|
467
|
+
readonly title: "Persona Claim Types List — payload";
|
|
468
|
+
readonly description: "Serve the claim-type registry this agent resolves against. A client that cannot read the table has to ship a copy of it, and a copy is a re-sync obligation on every change.";
|
|
469
|
+
readonly type: "object";
|
|
470
|
+
readonly additionalProperties: false;
|
|
471
|
+
readonly properties: {
|
|
472
|
+
readonly ext: {
|
|
473
|
+
readonly $ref: "#/$defs/Ext";
|
|
474
|
+
};
|
|
475
|
+
};
|
|
476
|
+
readonly $defs: {
|
|
477
|
+
readonly Response: {
|
|
478
|
+
readonly $anchor: "response";
|
|
479
|
+
readonly title: "Persona Claim Types List — response payload";
|
|
480
|
+
readonly description: "Success response to persona/claim-types/list. Type https://trusttasks.org/spec/persona/claim-types/list/1.0#response.";
|
|
481
|
+
readonly type: "object";
|
|
482
|
+
readonly additionalProperties: false;
|
|
483
|
+
readonly required: readonly ["registryVersion", "entries", "unregistered", "strictness"];
|
|
484
|
+
readonly properties: {
|
|
485
|
+
readonly registryVersion: {
|
|
486
|
+
readonly type: "string";
|
|
487
|
+
readonly maxLength: 32;
|
|
488
|
+
readonly description: "Version of the core registry this agent implements — the version of _shared/claim-types.json, not of this task. A client caching the table keys the cache on this.";
|
|
489
|
+
};
|
|
490
|
+
readonly entries: {
|
|
491
|
+
readonly type: "array";
|
|
492
|
+
readonly maxItems: 512;
|
|
493
|
+
readonly description: "The registered tokens. Both exact tokens and family prefixes appear here, undistinguished: which one an entry is follows from whether a given token equals it or descends from it, and marking them would invite a client to walk only one kind.";
|
|
494
|
+
readonly items: {
|
|
495
|
+
readonly type: "object";
|
|
496
|
+
readonly additionalProperties: false;
|
|
497
|
+
readonly required: readonly ["type", "sensitivity", "release", "mask"];
|
|
498
|
+
readonly properties: {
|
|
499
|
+
readonly type: {
|
|
500
|
+
readonly $ref: "#/$defs/ClaimType";
|
|
501
|
+
};
|
|
502
|
+
readonly sensitivity: {
|
|
503
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
504
|
+
};
|
|
505
|
+
readonly release: {
|
|
506
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
507
|
+
};
|
|
508
|
+
readonly mask: {
|
|
509
|
+
readonly type: "string";
|
|
510
|
+
readonly maxLength: 32;
|
|
511
|
+
readonly description: "Mask style, independent of sensitivity: any style that is not `none` is masked on screen whatever the sensitivity. Named rather than enumerated inline so a maintainer may serve a style this version does not list; a client that does not recognise a style MUST treat it as `full` rather than as `none`.";
|
|
512
|
+
};
|
|
513
|
+
readonly minimumSet: {
|
|
514
|
+
readonly type: "boolean";
|
|
515
|
+
readonly description: "Marks a type a community may ask for without it being remarkable. The minimum set contains only normal-sensitivity, consent-release types; that is a rule rather than a coincidence.";
|
|
516
|
+
};
|
|
517
|
+
readonly oidc: {
|
|
518
|
+
readonly type: "array";
|
|
519
|
+
readonly maxItems: 16;
|
|
520
|
+
readonly items: {
|
|
521
|
+
readonly type: "string";
|
|
522
|
+
readonly maxLength: 64;
|
|
523
|
+
};
|
|
524
|
+
readonly description: "OIDC standard claims this type answers. A recorded mapping, applied at presentation — the token stays the maintainer's own and no external vocabulary is primary.";
|
|
525
|
+
};
|
|
526
|
+
};
|
|
527
|
+
};
|
|
528
|
+
};
|
|
529
|
+
readonly unregistered: {
|
|
530
|
+
readonly type: "object";
|
|
531
|
+
readonly additionalProperties: false;
|
|
532
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
533
|
+
readonly description: "The floor: what a token with no entry and no registered prefix resolves to. Served rather than assumed, because a client that hard-codes it cannot be tightened by a maintainer that raises it.";
|
|
534
|
+
readonly properties: {
|
|
535
|
+
readonly sensitivity: {
|
|
536
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
537
|
+
};
|
|
538
|
+
readonly release: {
|
|
539
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
540
|
+
};
|
|
541
|
+
readonly mask: {
|
|
542
|
+
readonly type: "string";
|
|
543
|
+
readonly maxLength: 32;
|
|
544
|
+
};
|
|
545
|
+
};
|
|
546
|
+
};
|
|
547
|
+
readonly strictness: {
|
|
548
|
+
readonly type: "object";
|
|
549
|
+
readonly additionalProperties: false;
|
|
550
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
551
|
+
readonly description: "Each axis ordered MOST PROTECTIVE FIRST. This is what makes rule 3 computable by a client: resolution takes the longest registered prefix and the unregistered floor and keeps whichever is more protective, which requires an ordering the client did not invent.";
|
|
552
|
+
readonly properties: {
|
|
553
|
+
readonly sensitivity: {
|
|
554
|
+
readonly type: "array";
|
|
555
|
+
readonly maxItems: 8;
|
|
556
|
+
readonly items: {
|
|
557
|
+
readonly type: "string";
|
|
558
|
+
readonly maxLength: 32;
|
|
559
|
+
};
|
|
560
|
+
};
|
|
561
|
+
readonly release: {
|
|
562
|
+
readonly type: "array";
|
|
563
|
+
readonly maxItems: 8;
|
|
564
|
+
readonly items: {
|
|
565
|
+
readonly type: "string";
|
|
566
|
+
readonly maxLength: 32;
|
|
567
|
+
};
|
|
568
|
+
};
|
|
569
|
+
readonly mask: {
|
|
570
|
+
readonly type: "array";
|
|
571
|
+
readonly maxItems: 16;
|
|
572
|
+
readonly items: {
|
|
573
|
+
readonly type: "string";
|
|
574
|
+
readonly maxLength: 32;
|
|
575
|
+
};
|
|
576
|
+
};
|
|
577
|
+
};
|
|
578
|
+
};
|
|
579
|
+
readonly ext: {
|
|
580
|
+
readonly $ref: "#/$defs/Ext";
|
|
581
|
+
};
|
|
582
|
+
};
|
|
583
|
+
};
|
|
584
|
+
readonly Ext: {
|
|
585
|
+
readonly title: "Ext";
|
|
586
|
+
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.";
|
|
587
|
+
readonly type: "object";
|
|
588
|
+
readonly minProperties: 1;
|
|
589
|
+
readonly additionalProperties: true;
|
|
590
|
+
readonly propertyNames: {
|
|
591
|
+
readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
|
|
592
|
+
};
|
|
593
|
+
};
|
|
594
|
+
readonly ReleaseRequirement: {
|
|
595
|
+
readonly title: "ReleaseRequirement";
|
|
596
|
+
readonly description: "What it takes to let a value LEAVE. Distinct from `Sensitivity`, which governs showing it to the holder.\n\n`consent` is the ordinary gate: `persona/disclosure/preview` renders what would leave and `persona/disclosure/present` releases it, so a human sees it once.\n\n`stepUp` additionally requires a fresh authentication bound to THAT preview — not to the session. Without the binding, \"each time\" degrades into \"once per login\", which is the failure the requirement exists to prevent; the single-use `previewId` the preview already mints is what an implementation binds to. A maintainer MUST refuse `persona/disclosure/present` for a `stepUp` attribute when no such approval accompanies it.\n\nAbsent means *not decided by the holder* and resolves from the claim-type registry, which defaults `payment.*` and `gov.*` to `stepUp`.";
|
|
597
|
+
readonly type: "string";
|
|
598
|
+
readonly enum: readonly ["consent", "stepUp"];
|
|
599
|
+
};
|
|
600
|
+
readonly Sensitivity: {
|
|
601
|
+
readonly title: "Sensitivity";
|
|
602
|
+
readonly description: "How carefully a value is shown TO ITS OWN HOLDER. `high` means a consumer masks it by default, reveals it one attribute at a time on a deliberate act, and — the half that is not cosmetic — omits it from a listing that did not ask for sensitive values.\n\nAbsent means *not decided by the holder*, not `normal`: a consumer resolves it from the claim-type registry (see CLAIM-TYPES.md §4), which is why this member is optional and why an unregistered token resolves conservatively rather than permissively.\n\nDistinct from how linkable the value is. A payment card is highly sensitive and barely linkable — every card number is unique, so knowing one tells a second verifier nothing about the first. Reading either as a proxy for the other produces a consumer that hides the wrong things.";
|
|
603
|
+
readonly type: "string";
|
|
604
|
+
readonly enum: readonly ["normal", "high"];
|
|
605
|
+
};
|
|
606
|
+
readonly ClaimType: {
|
|
607
|
+
readonly title: "ClaimType";
|
|
608
|
+
readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
|
|
609
|
+
readonly type: "string";
|
|
610
|
+
readonly minLength: 1;
|
|
611
|
+
readonly maxLength: 128;
|
|
612
|
+
readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
|
|
613
|
+
};
|
|
614
|
+
};
|
|
615
|
+
};
|
|
616
|
+
};
|
|
617
|
+
/**
|
|
618
|
+
* SPEC.md §7.2 policy for the success-response variant. `isRecipientRequired`
|
|
619
|
+
* tracks the *issuer* party's requirement because a response swaps the
|
|
620
|
+
* parties (§7.3 item 5).
|
|
621
|
+
*/
|
|
622
|
+
export declare const RESPONSE_SPEC: {
|
|
623
|
+
readonly typeUri: "https://trusttasks.org/spec/persona/claim-types/list/1.0#response";
|
|
624
|
+
readonly isBearer: false;
|
|
625
|
+
readonly isProofRequired: true;
|
|
626
|
+
readonly isRecipientRequired: true;
|
|
627
|
+
readonly isIssuedAtRequired: false;
|
|
628
|
+
readonly payloadSchema: {
|
|
629
|
+
readonly $schema: "https://json-schema.org/draft/2020-12/schema";
|
|
630
|
+
readonly $ref: "#/$defs/Response";
|
|
631
|
+
readonly $defs: {
|
|
632
|
+
readonly Response: {
|
|
633
|
+
readonly $anchor: "response";
|
|
634
|
+
readonly title: "Persona Claim Types List — response payload";
|
|
635
|
+
readonly description: "Success response to persona/claim-types/list. Type https://trusttasks.org/spec/persona/claim-types/list/1.0#response.";
|
|
636
|
+
readonly type: "object";
|
|
637
|
+
readonly additionalProperties: false;
|
|
638
|
+
readonly required: readonly ["registryVersion", "entries", "unregistered", "strictness"];
|
|
639
|
+
readonly properties: {
|
|
640
|
+
readonly registryVersion: {
|
|
641
|
+
readonly type: "string";
|
|
642
|
+
readonly maxLength: 32;
|
|
643
|
+
readonly description: "Version of the core registry this agent implements — the version of _shared/claim-types.json, not of this task. A client caching the table keys the cache on this.";
|
|
644
|
+
};
|
|
645
|
+
readonly entries: {
|
|
646
|
+
readonly type: "array";
|
|
647
|
+
readonly maxItems: 512;
|
|
648
|
+
readonly description: "The registered tokens. Both exact tokens and family prefixes appear here, undistinguished: which one an entry is follows from whether a given token equals it or descends from it, and marking them would invite a client to walk only one kind.";
|
|
649
|
+
readonly items: {
|
|
650
|
+
readonly type: "object";
|
|
651
|
+
readonly additionalProperties: false;
|
|
652
|
+
readonly required: readonly ["type", "sensitivity", "release", "mask"];
|
|
653
|
+
readonly properties: {
|
|
654
|
+
readonly type: {
|
|
655
|
+
readonly $ref: "#/$defs/ClaimType";
|
|
656
|
+
};
|
|
657
|
+
readonly sensitivity: {
|
|
658
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
659
|
+
};
|
|
660
|
+
readonly release: {
|
|
661
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
662
|
+
};
|
|
663
|
+
readonly mask: {
|
|
664
|
+
readonly type: "string";
|
|
665
|
+
readonly maxLength: 32;
|
|
666
|
+
readonly description: "Mask style, independent of sensitivity: any style that is not `none` is masked on screen whatever the sensitivity. Named rather than enumerated inline so a maintainer may serve a style this version does not list; a client that does not recognise a style MUST treat it as `full` rather than as `none`.";
|
|
667
|
+
};
|
|
668
|
+
readonly minimumSet: {
|
|
669
|
+
readonly type: "boolean";
|
|
670
|
+
readonly description: "Marks a type a community may ask for without it being remarkable. The minimum set contains only normal-sensitivity, consent-release types; that is a rule rather than a coincidence.";
|
|
671
|
+
};
|
|
672
|
+
readonly oidc: {
|
|
673
|
+
readonly type: "array";
|
|
674
|
+
readonly maxItems: 16;
|
|
675
|
+
readonly items: {
|
|
676
|
+
readonly type: "string";
|
|
677
|
+
readonly maxLength: 64;
|
|
678
|
+
};
|
|
679
|
+
readonly description: "OIDC standard claims this type answers. A recorded mapping, applied at presentation — the token stays the maintainer's own and no external vocabulary is primary.";
|
|
680
|
+
};
|
|
681
|
+
};
|
|
682
|
+
};
|
|
683
|
+
};
|
|
684
|
+
readonly unregistered: {
|
|
685
|
+
readonly type: "object";
|
|
686
|
+
readonly additionalProperties: false;
|
|
687
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
688
|
+
readonly description: "The floor: what a token with no entry and no registered prefix resolves to. Served rather than assumed, because a client that hard-codes it cannot be tightened by a maintainer that raises it.";
|
|
689
|
+
readonly properties: {
|
|
690
|
+
readonly sensitivity: {
|
|
691
|
+
readonly $ref: "#/$defs/Sensitivity";
|
|
692
|
+
};
|
|
693
|
+
readonly release: {
|
|
694
|
+
readonly $ref: "#/$defs/ReleaseRequirement";
|
|
695
|
+
};
|
|
696
|
+
readonly mask: {
|
|
697
|
+
readonly type: "string";
|
|
698
|
+
readonly maxLength: 32;
|
|
699
|
+
};
|
|
700
|
+
};
|
|
701
|
+
};
|
|
702
|
+
readonly strictness: {
|
|
703
|
+
readonly type: "object";
|
|
704
|
+
readonly additionalProperties: false;
|
|
705
|
+
readonly required: readonly ["sensitivity", "release", "mask"];
|
|
706
|
+
readonly description: "Each axis ordered MOST PROTECTIVE FIRST. This is what makes rule 3 computable by a client: resolution takes the longest registered prefix and the unregistered floor and keeps whichever is more protective, which requires an ordering the client did not invent.";
|
|
707
|
+
readonly properties: {
|
|
708
|
+
readonly sensitivity: {
|
|
709
|
+
readonly type: "array";
|
|
710
|
+
readonly maxItems: 8;
|
|
711
|
+
readonly items: {
|
|
712
|
+
readonly type: "string";
|
|
713
|
+
readonly maxLength: 32;
|
|
714
|
+
};
|
|
715
|
+
};
|
|
716
|
+
readonly release: {
|
|
717
|
+
readonly type: "array";
|
|
718
|
+
readonly maxItems: 8;
|
|
719
|
+
readonly items: {
|
|
720
|
+
readonly type: "string";
|
|
721
|
+
readonly maxLength: 32;
|
|
722
|
+
};
|
|
723
|
+
};
|
|
724
|
+
readonly mask: {
|
|
725
|
+
readonly type: "array";
|
|
726
|
+
readonly maxItems: 16;
|
|
727
|
+
readonly items: {
|
|
728
|
+
readonly type: "string";
|
|
729
|
+
readonly maxLength: 32;
|
|
730
|
+
};
|
|
731
|
+
};
|
|
732
|
+
};
|
|
733
|
+
};
|
|
734
|
+
readonly ext: {
|
|
735
|
+
readonly $ref: "#/$defs/Ext";
|
|
736
|
+
};
|
|
737
|
+
};
|
|
738
|
+
};
|
|
739
|
+
readonly Ext: {
|
|
740
|
+
readonly title: "Ext";
|
|
741
|
+
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.";
|
|
742
|
+
readonly type: "object";
|
|
743
|
+
readonly minProperties: 1;
|
|
744
|
+
readonly additionalProperties: true;
|
|
745
|
+
readonly propertyNames: {
|
|
746
|
+
readonly pattern: "^[a-z][a-z0-9-]*(\\.[a-z0-9-]+)+$";
|
|
747
|
+
};
|
|
748
|
+
};
|
|
749
|
+
readonly ReleaseRequirement: {
|
|
750
|
+
readonly title: "ReleaseRequirement";
|
|
751
|
+
readonly description: "What it takes to let a value LEAVE. Distinct from `Sensitivity`, which governs showing it to the holder.\n\n`consent` is the ordinary gate: `persona/disclosure/preview` renders what would leave and `persona/disclosure/present` releases it, so a human sees it once.\n\n`stepUp` additionally requires a fresh authentication bound to THAT preview — not to the session. Without the binding, \"each time\" degrades into \"once per login\", which is the failure the requirement exists to prevent; the single-use `previewId` the preview already mints is what an implementation binds to. A maintainer MUST refuse `persona/disclosure/present` for a `stepUp` attribute when no such approval accompanies it.\n\nAbsent means *not decided by the holder* and resolves from the claim-type registry, which defaults `payment.*` and `gov.*` to `stepUp`.";
|
|
752
|
+
readonly type: "string";
|
|
753
|
+
readonly enum: readonly ["consent", "stepUp"];
|
|
754
|
+
};
|
|
755
|
+
readonly Sensitivity: {
|
|
756
|
+
readonly title: "Sensitivity";
|
|
757
|
+
readonly description: "How carefully a value is shown TO ITS OWN HOLDER. `high` means a consumer masks it by default, reveals it one attribute at a time on a deliberate act, and — the half that is not cosmetic — omits it from a listing that did not ask for sensitive values.\n\nAbsent means *not decided by the holder*, not `normal`: a consumer resolves it from the claim-type registry (see CLAIM-TYPES.md §4), which is why this member is optional and why an unregistered token resolves conservatively rather than permissively.\n\nDistinct from how linkable the value is. A payment card is highly sensitive and barely linkable — every card number is unique, so knowing one tells a second verifier nothing about the first. Reading either as a proxy for the other produces a consumer that hides the wrong things.";
|
|
758
|
+
readonly type: "string";
|
|
759
|
+
readonly enum: readonly ["normal", "high"];
|
|
760
|
+
};
|
|
761
|
+
readonly ClaimType: {
|
|
762
|
+
readonly title: "ClaimType";
|
|
763
|
+
readonly description: "The vocabulary token naming what a value IS — `name.legal`, `phone.mobile`, `address.postal`, `person.birthDate`. Dotted, most-general segment first, so that a consumer with no knowledge of the specific token can still group by its prefix.\n\nThe token is the maintainer's own; no external vocabulary is primary. External vocabularies (vCard/jCard, OIDC standard claims, schema.org) are mappings applied at PRESENTATION by a renderer, not at rest, so that a query written in any of them can be matched without the store having to live inside any one of them.\n\nThe `x:` prefix is an open extension namespace and is not decoration. The closest prior art — Windows CardSpace's self-issued card — supported exactly fifteen predefined claim types with no extensibility, and that is the specific way it failed the requirement a holder actually has. An `x:` attribute stores, composes, binds and discloses exactly like a known one; it renders generically and matches only an explicit query.";
|
|
764
|
+
readonly type: "string";
|
|
765
|
+
readonly minLength: 1;
|
|
766
|
+
readonly maxLength: 128;
|
|
767
|
+
readonly pattern: "^(x:)?[a-z][a-zA-Z0-9]*(\\.[a-z][a-zA-Z0-9]*)*$";
|
|
768
|
+
};
|
|
769
|
+
};
|
|
770
|
+
};
|
|
771
|
+
};
|
|
772
|
+
//# sourceMappingURL=payload.d.ts.map
|