@raytio/types 7.0.0 → 7.2.0

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/README.md CHANGED
@@ -18,6 +18,10 @@ import type { Schema } from "@raytio/types";
18
18
 
19
19
  Hovering over the type in VSCode will display documentation and available properties.
20
20
 
21
+ # Versioning
22
+
23
+ ⚠️ This package does not strictly follow semver, since every change to the type definitions is a breaking change.
24
+
21
25
  # Documentation
22
26
 
23
27
  ## Table of contents
@@ -26,34 +30,41 @@ Hovering over the type in VSCode will display documentation and available proper
26
30
 
27
31
  - [FieldVerification](enums/FieldVerification.md)
28
32
  - [POVerification](enums/POVerification.md)
33
+ - [SafeHarbourCode](enums/SafeHarbourCode.md)
29
34
 
30
- ### Type aliases
35
+ ### Type Aliases
31
36
 
32
37
  - [AA](#aa)
33
- - [AATags](#aatags)
38
+ - [AATag](#aatag)
34
39
  - [AId](#aid)
35
40
  - [Colors](#colors)
36
41
  - [CommonSchemaAttributes](#commonschemaattributes)
37
42
  - [ConditionallyRequired](#conditionallyrequired)
43
+ - [ContactPoint](#contactpoint)
38
44
  - [CustomFonts](#customfonts)
39
45
  - [DataTypes](#datatypes)
40
46
  - [Encrypted](#encrypted)
41
47
  - [GId](#gid)
42
48
  - [IId](#iid)
43
49
  - [Instance](#instance)
50
+ - [LId](#lid)
51
+ - [Location](#location)
44
52
  - [Lookup](#lookup)
45
53
  - [NId](#nid)
46
54
  - [OId](#oid)
47
55
  - [Organization](#organization)
48
56
  - [PId](#pid)
57
+ - [Party](#party)
58
+ - [PartyMetadata](#partymetadata)
59
+ - [PartySite](#partysite)
49
60
  - [ProfileObject](#profileobject)
50
- - [Properties](#properties)
51
61
  - [RealVer](#realver)
52
62
  - [Relationship](#relationship)
53
63
  - [Schema](#schema)
54
64
  - [SchemaField](#schemafield)
55
65
  - [SchemaFieldTag](#schemafieldtag)
56
66
  - [SchemaTag](#schematag)
67
+ - [SchemaType](#schematype)
57
68
  - [ServerSchemaField](#serverschemafield)
58
69
  - [SubmissionStatus](#submissionstatus)
59
70
  - [UId](#uid)
@@ -68,9 +79,10 @@ Hovering over the type in VSCode will display documentation and available proper
68
79
  - [WebhookStatus](#webhookstatus)
69
80
  - [WizardConfig](#wizardconfig)
70
81
  - [WizardPage](#wizardpage)
82
+ - [WizardPageTag](#wizardpagetag)
71
83
  - [WrappedSchema](#wrappedschema)
72
84
 
73
- ## Type aliases
85
+ ## Type Aliases
74
86
 
75
87
  ### AA
76
88
 
@@ -81,28 +93,35 @@ Hovering over the type in VSCode will display documentation and available proper
81
93
  | Name | Type | Description |
82
94
  | :------ | :------ | :------ |
83
95
  | `a_id` | [`AId`](#aid) | - |
84
- | `aa_help?` | `string` | markdown or string help information including [phoneNumber || email] |
96
+ | `aa_help?` | `string` | markdown or string help information including [phoneNumber \|\| email] |
85
97
  | `aa_introduction?` | `string` | If a user signs up while completing this form, this message will be sent in the sign up email. |
98
+ | `active?` | `boolean` | - |
86
99
  | `auth_list_enabled?` | `boolean` | if true, only specific email addresses can submit the form |
87
100
  | `callback_uri?` | `string`[] | - |
88
101
  | `description?` | `string` | - |
102
+ | `end_date?` | `Date` | - |
103
+ | `key?` | `string` | - |
104
+ | `logout_uri?` | `string`[] | - |
105
+ | `metadata?` | `unknown` | - |
89
106
  | `name` | `string` | - |
90
107
  | `org_id` | [`OId`](#oid) | the id of the associated organization |
91
- | `picture?` | [`Urn`](#urn) | - |
92
- | `picture_url?` | `string` | Easy to use AA logo url for pasting inot emails |
108
+ | `picture?` | [`Urn`](#urn) | **`Deprecated`** see !2101 |
109
+ | `picture_url?` | `string` | Easy to use AA logo url for pasting into emails |
93
110
  | `ruleset?` | `unknown` | configuration for the submission rules |
94
111
  | `scopes?` | `string`[] | - |
112
+ | `secret?` | `unknown` | - |
95
113
  | `service_provider_n_id?` | [`NId`](#nid) | the n_id of the associated service provider |
96
- | `tags?` | [`AATags`](#aatags)[] | - |
97
- | `theme?` | `Object` | - |
114
+ | `start_date?` | `Date` | Currently Unused Attributes |
115
+ | `tags?` | [`AATag`](#aatag)[] | - |
116
+ | `theme?` | { `colors?`: [`Colors`](#colors) ; `font?`: [`CustomFonts`](modules.md#customfonts) } | - |
98
117
  | `theme.colors?` | [`Colors`](#colors) | - |
99
118
  | `theme.font?` | [`CustomFonts`](#customfonts) | - |
100
119
 
101
120
  ___
102
121
 
103
- ### AATags
122
+ ### AATag
104
123
 
105
- Ƭ **AATags**: ``"type:client_only"`` \| ``"type:share_with_new_user"`` \| \`related\_service\_provider:n\_id:${NId}\` \| ``"ServiceProvider"``
124
+ Ƭ **AATag**: ``"type:client_only"`` \| ``"type:share_with_new_user"`` \| \`related\_service\_provider:n\_id:${NId}\` \| ``"ServiceProvider"``
106
125
 
107
126
  ___
108
127
 
@@ -110,7 +129,7 @@ ___
110
129
 
111
130
  Ƭ **AId**: `StringWithIdentity`<``"AId"``\>
112
131
 
113
- An `a_id` is the ID of an @see AA
132
+ An `a_id` is the ID of an [AA](#aa)
114
133
 
115
134
  ___
116
135
 
@@ -158,27 +177,27 @@ not exported. Attributes that are identical in both client schema & server schem
158
177
  | Name | Type | Description |
159
178
  | :------ | :------ | :------ |
160
179
  | `description` | `string` | - |
161
- | `display?` | `Object` | - |
180
+ | `description_decorator?` | ``"md"`` | specifies that the description is formatted in markdown |
181
+ | `display?` | { `expand?`: { `fields`: `string`[] ; `label`: `string` }[] ; `head_main?`: { `fields`: `string`[] ; `format?`: `string` } ; `head_sub?`: { `fields`: `string`[] ; `format?`: `string` } } | - |
162
182
  | `display.expand?` | { `fields`: `string`[] ; `label`: `string` }[] | list of fields that should not be shown by default, unless you expand a collpase section which has a name from the label property. Array because there could be multiple expand groups |
163
- | `display.head_main?` | `Object` | list of fields to be considered the header/name of the PO fields joined with a space unless `format` format string is supplied |
183
+ | `display.head_main?` | { `fields`: `string`[] ; `format?`: `string` } | list of fields to be considered the header/name of the PO fields joined with a space unless `format` format string is supplied |
164
184
  | `display.head_main.fields` | `string`[] | - |
165
185
  | `display.head_main.format?` | `string` | - |
166
- | `display.head_sub?` | `Object` | list of fields to be considered the subheader of the PO fields joined with a space unless `format` format string is supplied |
186
+ | `display.head_sub?` | { `fields`: `string`[] ; `format?`: `string` } | list of fields to be considered the subheader of the PO fields joined with a space unless `format` format string is supplied |
167
187
  | `display.head_sub.fields` | `string`[] | - |
168
188
  | `display.head_sub.format?` | `string` | - |
169
- | `i18n?` | `Object` | - |
170
- | `name` | `string` | these fields will always exist on schema |
171
- | `onboard_properties?` | `Object` | only the schema used for the onboarding wizard have this property |
189
+ | `i18n?` | { `[locale: string]`: { `[fieldNameOrGroupName: string]`: [`ServerSchemaField`](#serverschemafield) & { `title_plural?`: `string` }; `$loading_create_sub_obj`: { `title`: `string` } ; `$loading_delete_pending_ver`: { `title`: `string` } ; `$loading_extract`: { `title`: `string` } ; `$loading_link_to_person`: { `title`: `string` } ; `$loading_long_verification_message`: { `description?`: `string` ; `title?`: `string` } ; `$loading_pending_ver_resubmit`: { `title`: `string` } ; `$loading_permission`: { `title`: `string` } ; `$loading_save`: { `title`: `string` } ; `$loading_update`: { `title`: `string` } ; `$loading_upload`: { `title`: `string` } ; `$loading_verify`: { `title`: `string` } ; `$schema`: { `description?`: `string` ; `title`: `string` ; `title_plural?`: `string` } }; } | - |
190
+ | `onboard_properties?` | { `organizations?`: { `access_applications?`: { `links?`: { `description`: `string` ; `wizardConfig`: `Omit`<[`WizardConfig`](#wizardconfig), ``"a_id"``\> }[] ; `properties`: `Omit`<[`AA`](modules.md#aa), ``"org_id"``\> }[] ; `properties`: [`Organization`](modules.md#organization) }[] ; `profile_objects?`: { `properties`: `Record`<`string`, `unknown`\> ; `schema_name`: `string` }[] ; `relationships?`: { `from`: `string` ; `properties?`: `Record`<`string`, `string`\> ; `to`: `string` ; `type`: `string` }[] ; `return_to?`: `string` } | only the schema used for the onboarding wizard have this property |
172
191
  | `onboard_properties.organizations?` | { `access_applications?`: { `links?`: { `description`: `string` ; `wizardConfig`: `Omit`<[`WizardConfig`](#wizardconfig), ``"a_id"``\> }[] ; `properties`: `Omit`<[`AA`](modules.md#aa), ``"org_id"``\> }[] ; `properties`: [`Organization`](modules.md#organization) }[] | Organizations that should be created. NOTE: if multiple are specified, when the wizard completes, the _first one_ will be selected |
173
192
  | `onboard_properties.profile_objects?` | { `properties`: `Record`<`string`, `unknown`\> ; `schema_name`: `string` }[] | Profile Objects that should be created |
174
193
  | `onboard_properties.relationships?` | { `from`: `string` ; `properties?`: `Record`<`string`, `string`\> ; `to`: `string` ; `type`: `string` }[] | Relationships that should be created |
175
194
  | `onboard_properties.return_to?` | `string` | The relative path in the client to redirect to once finished. May include variables |
176
- | `relationships?` | { `anyOf?`: `string`[] ; `direction`: ``"from"`` ; `multiple?`: `boolean` ; `oneOf?`: `string`[] ; `properties?`: { [fieldName: string]: [`SchemaField`](#schemafield); } ; `relationship_name`: `string` ; `required?`: `string`[] ; `required_relationship?`: `boolean` ; `type`: `string` }[] | - |
195
+ | `relationships?` | { `anyOf?`: `string`[] ; `direction`: ``"from"`` ; `multiple?`: `boolean` ; `oneOf?`: `string`[] ; `properties?`: { `[fieldName: string]`: [`SchemaField`](#schemafield); } ; `relationship_name`: `string` ; `required?`: `string`[] ; `required_relationship?`: `boolean` ; `type`: `string` }[] | - |
177
196
  | `schema_group?` | `string` | the group that a schema belongs to, such as "passports". This is useful for forms that accept different types of similar documents. |
197
+ | `schema_type?` | [`SchemaType`](#schematype) | - |
178
198
  | `tags?` | [`SchemaTag`](#schematag)[] | - |
179
- | `title` | `string` | - |
199
+ | `title` | `string` | these fields will always exist on schema |
180
200
  | `title_plural?` | `string` | plural version of the title |
181
- | `type?` | [`DataTypes`](#datatypes) | - |
182
201
 
183
202
  ___
184
203
 
@@ -193,7 +212,36 @@ should be renamed since this applies to ConditionallyVerifiable
193
212
  | Name | Type |
194
213
  | :------ | :------ |
195
214
  | `field` | `string` |
196
- | `if` | `Object` |
215
+ | `if` | { `[fieldName: string]`: (`string` \| `number` \| `boolean`)[]; } |
216
+
217
+ ___
218
+
219
+ ### ContactPoint
220
+
221
+ Ƭ **ContactPoint**: `Object`
222
+
223
+ A Contact Point for an Organization
224
+
225
+ #### Type declaration
226
+
227
+ | Name | Type |
228
+ | :------ | :------ |
229
+ | `active` | `boolean` |
230
+ | `contact_point_purpose` | `string` |
231
+ | `contact_point_type` | `string` |
232
+ | `e164` | `string` \| ``null`` |
233
+ | `e164_suffix` | `string` \| ``null`` |
234
+ | `e164_type` | `string` \| ``null`` |
235
+ | `email_address` | `string` |
236
+ | `email_address_preferred_format` | `string` |
237
+ | `end_date` | `string` |
238
+ | `id` | `string` |
239
+ | `metadata` | `unknown` |
240
+ | `start_date` | `string` |
241
+ | `to_table` | `string` |
242
+ | `url` | `string` \| ``null`` |
243
+ | `url_type` | `string` \| ``null`` |
244
+ | `uuid` | `string` \| `undefined` |
197
245
 
198
246
  ___
199
247
 
@@ -230,11 +278,11 @@ ___
230
278
 
231
279
  | Name | Type |
232
280
  | :------ | :------ |
233
- | `encrypted_data` | `Object` |
281
+ | `encrypted_data` | { `algorithm`: `AesKeyAlgorithm` ; `data`: `string` ; `iv`: `string` } |
234
282
  | `encrypted_data.algorithm` | `AesKeyAlgorithm` |
235
283
  | `encrypted_data.data` | `string` |
236
284
  | `encrypted_data.iv` | `string` |
237
- | `encrypted_key` | `Object` |
285
+ | `encrypted_key` | { `encrypted_key`: `string` } |
238
286
  | `encrypted_key.encrypted_key` | `string` |
239
287
 
240
288
  ___
@@ -251,7 +299,7 @@ ___
251
299
 
252
300
  Ƭ **IId**: `StringWithIdentity`<``"IId"``\>
253
301
 
254
- An `i_id` is the ID of an @see Instance
302
+ An `i_id` is the ID of an [Instance](#instance)
255
303
 
256
304
  ___
257
305
 
@@ -263,20 +311,29 @@ ___
263
311
 
264
312
  | Name | Type | Description |
265
313
  | :------ | :------ | :------ |
266
- | `_state?` | [`SubmissionStatus`](#submissionstatus) | **`depreacted`** The status of a submission |
314
+ | `_state?` | [`SubmissionStatus`](#submissionstatus) | **`Deprecated`** The status of a submission |
267
315
  | `a_id` | [`AId`](#aid) | ID of the access application this submission was made to |
268
316
  | `aa_name` | `string` | name of the access application this submission was made to |
317
+ | `aack_id?` | `string` | Key (Can be used to retrieve instance) |
318
+ | `active?` | `boolean` | Activity Status |
269
319
  | `confirmation_code` | `string` | Code that validates information has been shared |
270
320
  | `data_provider_email` | `string` | Email of user who shared the data |
321
+ | `device_id?` | `unknown` | Device Id |
271
322
  | `end_date` | `string` | Latest date in which the shared information was available |
272
323
  | `i_id` | [`IId`](#iid) | Access application instance ID |
273
- | `keys` | `Object` | - |
274
- | `previous_state` | [`SubmissionStatus`](#submissionstatus) | Previous status of the shared information |
324
+ | `instance_version?` | `unknown` | Instance Version |
325
+ | `keys` | { `[nId: NId]`: { `[fieldName: string]`: { `data`: `string` ; `n_id`: [`NId`](#nid) }; }; } | - |
326
+ | `metadata?` | `unknown` | Metadata |
327
+ | `platform_footer_html?` | `unknown` | Footer Html |
328
+ | `previous_state?` | [`SubmissionStatus`](#submissionstatus) | Previous status of the shared information |
275
329
  | `profile_objects` | [`ProfileObject`](#profileobject)[] | data associated is access application's instance |
276
330
  | `reference` | `string` | reference provided by the user who shared the data |
331
+ | `related_offers?` | `unknown` | Related Offers |
332
+ | `related_service_types?` | `unknown` | Related Service Types |
277
333
  | `relationships?` | [`Relationship`](#relationship)[] | - |
278
334
  | `score?` | `unknown` | added by the client once it calculates the score |
279
335
  | `service_provider_n_id?` | [`NId`](#nid) | Service provider ID |
336
+ | `source_ip?` | `unknown` | Source IP |
280
337
  | `start_date` | `string` | Earliest date on which the shared information was available |
281
338
  | `state` | [`SubmissionStatus`](#submissionstatus) | The status of a submission |
282
339
  | `sub_service_provider_hash?` | `string` | Hash of the Service Provider ID |
@@ -284,6 +341,53 @@ ___
284
341
 
285
342
  ___
286
343
 
344
+ ### LId
345
+
346
+ Ƭ **LId**: `StringWithIdentity`<``"LId"``\>
347
+
348
+ An `l_id` is the ID of any data stored in the KV-Store
349
+
350
+ ___
351
+
352
+ ### Location
353
+
354
+ Ƭ **Location**: `Object`
355
+
356
+ An Organization Location
357
+
358
+ #### Type declaration
359
+
360
+ | Name | Type |
361
+ | :------ | :------ |
362
+ | `active` | `boolean` |
363
+ | `address_line_1` | `string` \| ``null`` |
364
+ | `address_line_2` | `string` \| ``null`` |
365
+ | `address_line_3` | `string` \| ``null`` |
366
+ | `address_line_4` | `string` \| ``null`` |
367
+ | `administrative_area_level_1` | `string` \| ``null`` |
368
+ | `administrative_area_level_2` | `string` \| ``null`` |
369
+ | `administrative_area_level_3` | `string` \| ``null`` |
370
+ | `city` | `string` \| ``null`` |
371
+ | `country` | `string` \| ``null`` |
372
+ | `end_date` | `string` |
373
+ | `geolocation` | `string` \| ``null`` |
374
+ | `geolocation_outline` | `string` \| ``null`` |
375
+ | `id` | `string` |
376
+ | `locality` | `string` \| ``null`` |
377
+ | `location_description` | `string` \| ``null`` |
378
+ | `location_name` | `string` |
379
+ | `metadata` | `unknown` |
380
+ | `postal_code` | `string` |
381
+ | `postal_code_suffix` | `string` \| ``null`` |
382
+ | `premise` | `string` \| ``null`` |
383
+ | `region` | `string` \| ``null`` |
384
+ | `route` | `string` \| ``null`` |
385
+ | `start_date` | `string` |
386
+ | `street_number` | `string` \| ``null`` |
387
+ | `subpremise` | `string` \| ``null`` |
388
+
389
+ ___
390
+
287
391
  ### Lookup
288
392
 
289
393
  Ƭ **Lookup**: `Object`
@@ -305,7 +409,7 @@ ___
305
409
 
306
410
  Ƭ **NId**: `StringWithIdentity`<``"NId"``\>
307
411
 
308
- An `n_id` is the ID of a @see ProfileObject
412
+ An `n_id` is the ID of a [ProfileObject](#profileobject)
309
413
 
310
414
  ___
311
415
 
@@ -313,7 +417,7 @@ ___
313
417
 
314
418
  Ƭ **OId**: `StringWithIdentity`<``"OId"``\>
315
419
 
316
- An `o_id` is the ID of an @see Organization
420
+ An `o_id` is the ID of an [Organization](#organization)
317
421
 
318
422
  ___
319
423
 
@@ -328,14 +432,8 @@ NOTE: this is different to how the schema defines an Organization. **The schema
328
432
 
329
433
  | Name | Type |
330
434
  | :------ | :------ |
331
- | `address` | `Object` |
332
- | `address.city` | `string` |
333
- | `address.country` | `string` |
334
- | `address.locationType` | `string` |
335
- | `address.region` | `string` |
336
- | `address.street1` | `string` |
337
- | `address.street2` | `string` |
338
- | `customer` | `Record`<`string`, `unknown`\> |
435
+ | `address` | `unknown` |
436
+ | `customer` | `unknown` |
339
437
  | `email` | `string` |
340
438
  | `id` | [`OId`](#oid) |
341
439
  | `name` | `string` |
@@ -346,45 +444,93 @@ ___
346
444
 
347
445
  Ƭ **PId**: `StringWithIdentity`<``"PId"``\>
348
446
 
349
- A `p_id` is the ID of a @see Relationship
447
+ A `p_id` is the ID of a [Relationship](#relationship)
350
448
 
351
449
  ___
352
450
 
353
- ### ProfileObject
451
+ ### Party
354
452
 
355
- Ƭ **ProfileObject**<`Properties`\>: `Object`
453
+ Ƭ **Party**: `Object`
356
454
 
357
- You can supply an option type argument if you know exactly what the properties will be
455
+ An Organisation
358
456
 
359
- #### Type parameters
457
+ #### Type declaration
360
458
 
361
459
  | Name | Type |
362
460
  | :------ | :------ |
363
- | `Properties` | `Json` |
461
+ | `active` | `boolean` |
462
+ | `end_date` | `string` |
463
+ | `id` | `string` |
464
+ | `metadata` | [`PartyMetadata`](#partymetadata) |
465
+ | `party_description` | `string` |
466
+ | `party_name` | `string` |
467
+ | `party_number` | `number` |
468
+ | `party_type` | `string` |
469
+ | `start_date` | `string` |
470
+
471
+ ___
472
+
473
+ ### PartyMetadata
474
+
475
+ Ƭ **PartyMetadata**: `Object`
476
+
477
+ An Organizations credentials
364
478
 
365
479
  #### Type declaration
366
480
 
367
481
  | Name | Type |
368
482
  | :------ | :------ |
369
- | `labels` | `string`[] |
370
- | `n_id` | [`NId`](#nid) |
371
- | `properties` | `Properties` |
483
+ | `centrix_credentials` | `unknown` |
484
+ | `gandalf` | `unknown` |
485
+ | `stripe` | { `customer`: `unknown` } |
486
+ | `stripe.customer` | `unknown` |
372
487
 
373
488
  ___
374
489
 
375
- ### Properties
490
+ ### PartySite
491
+
492
+ Ƭ **PartySite**: `Object`
376
493
 
377
- Ƭ **Properties**: `Object`
494
+ An Organization Site
495
+
496
+ #### Type declaration
497
+
498
+ | Name | Type |
499
+ | :------ | :------ |
500
+ | `active` | `boolean` |
501
+ | `end_date` | `string` |
502
+ | `id` | `string` |
503
+ | `location_number` | `number` |
504
+ | `metadata` | `unknown` |
505
+ | `party_id` | `string` |
506
+ | `party_site_description` | `string` \| ``null`` |
507
+ | `party_site_name` | `string` |
508
+ | `party_site_number` | `string` \| ``null`` |
509
+ | `party_use_primary` | `string` |
510
+ | `party_uses` | `string`[] |
511
+ | `start_date` | `string` |
378
512
 
379
- arbitrary key-values pairs stored on a Profile Object.
380
- May contain nested JSON and @see Encrypted properties.
513
+ ___
514
+
515
+ ### ProfileObject
516
+
517
+ Ƭ **ProfileObject**<`Properties`\>: `Object`
518
+
519
+ You can supply an option type argument if you know exactly what the properties will be
520
+
521
+ #### Type parameters
381
522
 
382
- There are some limits to field names: they cannot be called
383
- `__signature` nor can they include the character sequence `<=>`.
523
+ | Name | Type |
524
+ | :------ | :------ |
525
+ | `Properties` | `Json` |
384
526
 
385
- #### Index signature
527
+ #### Type declaration
386
528
 
387
- [fieldName: `string`]: `any`
529
+ | Name | Type |
530
+ | :------ | :------ |
531
+ | `labels` | `string`[] |
532
+ | `n_id` | [`NId`](#nid) |
533
+ | `properties` | `Properties` |
388
534
 
389
535
  ___
390
536
 
@@ -392,7 +538,7 @@ ___
392
538
 
393
539
  Ƭ **RealVer**: `Object`
394
540
 
395
- This is what @raytio/core exposes, which is more useable than @see Verification
541
+ This is what @raytio/core exposes, which is more useable than [Verification](#verification)
396
542
 
397
543
  #### Type declaration
398
544
 
@@ -401,7 +547,7 @@ This is what @raytio/core exposes, which is more useable than @see Verification
401
547
  | `belongsToNId?` | [`NId`](#nid) | nId of the PO that the verification belongs to. Could be undefined |
402
548
  | `expired` | `Date` \| ``false`` | If the verification has expired, it's the date that it expired on. Otherwise it's `false` |
403
549
  | `fieldName` | `string` | - |
404
- | `metadata?` | `Record`<`string`, `unknown`\> | arbitary metadata returned by the verifier |
550
+ | `metadata?` | [`VerificationPayload`](#verificationpayload)<``false``\>[``"metadata"``] | arbitary metadata returned by the verifier |
405
551
  | `nID` | [`NId`](#nid) | nId of the verification |
406
552
  | `provider` | [`VerificationProvider`](#verificationprovider) | - |
407
553
  | `signature` | `string` | - |
@@ -421,7 +567,7 @@ ___
421
567
  | :------ | :------ |
422
568
  | `end` | [`Urn`](#urn) |
423
569
  | `p_id` | [`PId`](#pid) |
424
- | `properties?` | `Object` |
570
+ | `properties?` | { `[fieldName: string]`: `unknown`; `name?`: `string` ; `p_id`: [`PId`](#pid) } |
425
571
  | `properties.name?` | `string` |
426
572
  | `properties.p_id` | [`PId`](#pid) |
427
573
  | `start` | [`Urn`](#urn) |
@@ -431,7 +577,7 @@ ___
431
577
 
432
578
  ### Schema
433
579
 
434
- Ƭ **Schema**: [`CommonSchemaAttributes`](#commonschemaattributes) & { `clientLocale?`: `string` ; `end_date?`: `string` ; `groupNames?`: `Record`<`string`, `string`\> ; `group_title?`: `string` ; `isProfileSchema?`: `boolean` ; `isSpSchema?`: `boolean` ; `properties`: { [fieldName: string]: [`SchemaField`](modules.md#schemafield); } ; `required?`: (`string` \| [`ConditionallyRequired`](modules.md#conditionallyrequired))[] ; `start_date?`: `string` ; `timing?`: `Record`<``"extract"`` \| ``"live_person"`` \| ``"verify_pending_delay"``, `number`\> ; `verified_fields?`: (`string` \| [`ConditionallyRequired`](modules.md#conditionallyrequired))[] ; `version`: `string` ; `wasExpandedByClient?`: `boolean` }
580
+ Ƭ **Schema**: [`CommonSchemaAttributes`](#commonschemaattributes) & { `clientLocale?`: `string` ; `end_date?`: `string` ; `groupNames?`: `Record`<`string`, `string`\> ; `group_title?`: `string` ; `isProfileSchema?`: `boolean` ; `isSpSchema?`: `boolean` ; `name`: `string` ; `properties`: { `[fieldName: string]`: [`SchemaField`](modules.md#schemafield); } ; `required?`: (`string` \| [`ConditionallyRequired`](modules.md#conditionallyrequired))[] ; `start_date?`: `string` ; `timing?`: `Record`<``"extract"`` \| ``"live_person"`` \| ``"verify_pending_delay"``, `number`\> ; `type?`: [`DataTypes`](modules.md#datatypes) ; `verified_fields?`: (`string` \| [`ConditionallyRequired`](modules.md#conditionallyrequired))[] ; `version`: `string` ; `wasExpandedByClient?`: `boolean` }
435
581
 
436
582
  Raytio's variant of JSON Schema, as used by the client. It is a modified version
437
583
  of what the API returns.
@@ -446,7 +592,7 @@ ___
446
592
 
447
593
  | Name | Type | Description |
448
594
  | :------ | :------ | :------ |
449
- | `$id?` | `string` | **`deprecated`** don't use, it's inconsistent |
595
+ | `$id?` | `string` | **`Deprecated`** don't use, it's inconsistent |
450
596
  | `$ref?` | `string` | If this field refers to a sub-object |
451
597
  | `add_row_btn_label?` | `string` | if this field is a table input, this determines the text to show on the "Add Row" btn |
452
598
  | `allOf?` | [{ `$ref`: `string` }, [`ServerSchemaField`](#serverschemafield)] | - |
@@ -458,26 +604,28 @@ ___
458
604
  | `description?` | `string` | - |
459
605
  | `description_decorator?` | ``"md"`` | specifies that the description is formatted in markdown |
460
606
  | `encrypt?` | `boolean` | whether the field should be encrypted |
607
+ | `encrypt_require?` | `boolean` | if true, the user must have encryption enabled to save this data, see #1324 |
461
608
  | `enum?` | (`string` \| `number` \| `boolean`)[] | - |
462
609
  | `examples?` | `unknown`[] | - |
463
610
  | `format?` | ``"date"`` \| ``"date-time"`` \| ``"uri"`` | - |
464
611
  | `image_silhouette?` | `string` | If this schema requires a photo of a document, you can specify a URL to a silhouette image which will be overlaid on top of the camera. For best results, the image should have a transparent background + minimal white foreground |
465
- | `items?` | `Object` | `items` is used for nested arrays, (while `properties` is used for nested objects) |
466
- | `items.properties` | `Object` | - |
612
+ | `items?` | { `properties`: { `[subFieldName: string]`: [`SchemaField`](#schemafield); } ; `type`: [`DataTypes`](modules.md#datatypes) } | `items` is used for nested arrays, (while `properties` is used for nested objects) |
613
+ | `items.properties` | { `[subFieldName: string]`: [`SchemaField`](#schemafield); } | - |
467
614
  | `items.type` | [`DataTypes`](#datatypes) | - |
468
615
  | `lookup?` | `string` | URL to a JSON file in the `Lookup` format |
469
- | `maxLength?` | `number` | **`deprecated`** raytio's usage not documented |
470
- | `maximum?` | `number` | - |
471
- | `minLength?` | `number` | **`deprecated`** raytio's usage not documented |
472
- | `minimum?` | `number` | - |
473
- | `override?` | `Object` | - |
474
- | `override.permissions` | `Object` | - |
616
+ | `maxLength?` | `number` | **`Deprecated`** raytio's usage not documented |
617
+ | `maximum?` | `number` | for number inputs, the maximum allowed value |
618
+ | `minLength?` | `number` | **`Deprecated`** raytio's usage not documented |
619
+ | `minimum?` | `number` | for number inputs, the minimum allowed value |
620
+ | `override?` | { `permissions`: { `default`: `string` } } | - |
621
+ | `override.permissions` | { `default`: `string` } | - |
475
622
  | `override.permissions.default` | `string` | ideally this could be typed as `keyof typeof GROUPS` but the schemas aren't consistent and we have to assume it could be invalid. |
476
623
  | `pattern?` | `string` | - |
477
624
  | `patternMessage?` | `string` | if a `pattern` is specified, this is the error message |
478
625
  | `priority?` | `number` | - |
479
- | `properties?` | `Object` | `properties` is used for nested objects, (while `items` is used for nested arrays) |
626
+ | `properties?` | { `[subFieldName: string]`: [`SchemaField`](#schemafield); } | `properties` is used for nested objects, (while `items` is used for nested arrays) |
480
627
  | `readOnly?` | `boolean` | readOnly means the Wizard won't show this field |
628
+ | `step?` | `number` | for number inputs, the step size used in the input or slider |
481
629
  | `table_empty_message?` | `string` | if this field is a table input, this determines the text to show if the table is empty |
482
630
  | `tags?` | [`SchemaFieldTag`](#schemafieldtag)[] | - |
483
631
  | `title?` | `string` | - |
@@ -488,13 +636,21 @@ ___
488
636
 
489
637
  ### SchemaFieldTag
490
638
 
491
- Ƭ **SchemaFieldTag**: ``"password"`` \| \`group:${string}\` \| \`upload-group:${string}\` \| ``"display:stars"`` \| ``"display:no_autofill"`` \| ``"display:currency"`` \| ``"display:cascade"`` \| ``"display:survey"`` \| ``"display:quoting"`` \| ``"display:customModal"`` \| ``"display:terms_conditions"`` \| \`display:main\_media:${string}\` \| ``"date_component:day"`` \| ``"date_component:month"`` \| ``"date_component:year"`` \| ``"action:client_upload"`` \| ``"verify:show_if_pending"`` \| ``"special:hide_select_behind_button"`` \| ``"type:capture_geolocation"`` \| ``"type:extract_required"``
639
+ Ƭ **SchemaFieldTag**: ``"password"`` \| \`group:${string}\` \| \`upload-group:${string}\` \| ``"display:stars"`` \| ``"display:no_autofill"`` \| ``"display:currency"`` \| ``"display:cascade"`` \| ``"display:survey"`` \| ``"display:quoting"`` \| ``"display:customModal"`` \| \`display:replace:'${string}':'${string}'\` \| ``"display:terms_conditions"`` \| \`display:main\_media:${string}\` \| ``"date_component:day"`` \| ``"date_component:month"`` \| ``"date_component:year"`` \| ``"action:client_upload"`` \| ``"action:require_webauthn"`` \| ``"verify:show_if_pending"`` \| ``"special:hide_select_behind_button"`` \| ``"type:capture_geolocation"`` \| ``"type:extract_required"``
492
640
 
493
641
  ___
494
642
 
495
643
  ### SchemaTag
496
644
 
497
- Ƭ **SchemaTag**: ``"action:experimental_pass_object_store_id"`` \| ``"action:verify"`` \| ``"default_camera:rear"`` \| ``"default_camera:front"`` \| \`oauth2\_component:name:${string}\` \| \`oauth2\_component:redirect\_url:${string}\` \| \`link\_to:${string}:${string}\` \| ``"type:service_provider"`` \| ``"type:service_offer"`` \| ``"type:marketplace"`` \| ``"type:client_only"`` \| ``"type:globally_unique_field"``
645
+ Ƭ **SchemaTag**: ``"action:experimental_pass_object_store_id"`` \| ``"action:verify"`` \| ``"default_camera:rear"`` \| ``"default_camera:front"`` \| \`oauth2\_component:name:${string}\` \| \`oauth2\_component:redirect\_url:${string}\` \| \`time:${string}:${number}\` \| \`link\_to:${string}:${string}\` \| ``"type:service_provider"`` \| ``"type:service_offer"`` \| ``"type:marketplace"`` \| ``"type:client_only"`` \| ``"type:globally_unique_field"``
646
+
647
+ ___
648
+
649
+ ### SchemaType
650
+
651
+ Ƭ **SchemaType**: ``"ss"`` \| ``"ps"`` \| ``"us"``
652
+
653
+ Type Classification of a Schema returned by API
498
654
 
499
655
  ___
500
656
 
@@ -522,7 +678,7 @@ ___
522
678
 
523
679
  ### Urn
524
680
 
525
- Ƭ **Urn**: \`urn:${UrnNodeType}:${string}\`
681
+ Ƭ **Urn**: \`urn:user:${UId}\` \| \`urn:profile\_object:${NId}\` \| \`urn:instance:${IId}\` \| \`urn:temp\_object:${LId}\` \| \`urn:schema:${string}\` \| \`urn:document:${NId}\`
526
682
 
527
683
  e.g. "urn:user:..."
528
684
 
@@ -544,7 +700,7 @@ validation data returned by preVerify (part of the extract&map API)
544
700
 
545
701
  | Name | Type |
546
702
  | :------ | :------ |
547
- | `breakdown` | `Object` |
703
+ | `breakdown` | { `[category: string]`: { `code?`: `number` ; `passed`: `boolean` ; `reason?`: `string` ; `severity?`: ``"low"`` \| ``"medium"`` \| ``"high"`` }; } |
548
704
  | `score` | `number` |
549
705
  | `warning?` | `string`[] |
550
706
 
@@ -552,7 +708,7 @@ ___
552
708
 
553
709
  ### Verification
554
710
 
555
- Ƭ **Verification**<`WithValue`\>: [`ProfileObject`](#profileobject)<`Object`\>
711
+ Ƭ **Verification**<`WithValue`\>: [`ProfileObject`](#profileobject)<{ `field`: `string` ; `n_id`: [`NId`](modules.md#nid) ; `valid_until?`: `string` ; `verifications`: [{ `data`: [`VerificationPayload`](modules.md#verificationpayload)<`WithValue`\> ; `hashing_algorithm?`: ``"SHA512"`` ; `key_id?`: `string` ; `key_urn?`: `string` ; `signature`: `string` ; `signing_algorithm?`: ``"RSASSA_PSS_SHA_512"`` }] }\>
556
712
 
557
713
  Different APIs inconsistently include the `value` prop. If you know it exists,
558
714
  use `Verification<true>`, otherwise just `Verification`. Verifications from
@@ -562,13 +718,13 @@ the DataContext don't have the value.
562
718
 
563
719
  | Name | Type |
564
720
  | :------ | :------ |
565
- | `WithValue` | extends `boolean```false`` |
721
+ | `WithValue` | extends `boolean` = ``false`` |
566
722
 
567
723
  ___
568
724
 
569
725
  ### VerificationPayload
570
726
 
571
- Ƭ **VerificationPayload**<`WithValue`\>: { `field`: `string` ; `metadata?`: `Record`<`string`, `unknown`\> ; `passed`: `boolean` ; `request_div`: `string` ; `schema?`: `string` ; `source`: `string` ; `source_hashed_n_id?`: [`NId`](#nid) ; `source_n_id?`: [`NId`](modules.md#nid) ; `type?`: ``null`` ; `v_id`: `string` ; `valid_until?`: `string` ; `verification_date`: `string` ; `verifier_div`: `string` ; `verifier_id?`: [`NId`](modules.md#nid) ; `verifier_service_id?`: [`NId`](modules.md#nid) ; `verifier_source_id?`: [`NId`](modules.md#nid) } & `WithValue` extends ``true`` ? { `value`: `string` \| `number` } : {}
727
+ Ƭ **VerificationPayload**<`WithValue`\>: { `field`: `string` ; `metadata?`: { `[otherAttributes: string]`: `unknown`; `pending_details?`: { `pending_time`: ``"short"`` \| ``"long"`` ; `pending_type`: ``"time"`` \| ``"user"`` } ; `safeHarbourScore?`: [`SafeHarbourCode`](enums/SafeHarbourCode.md) ; `status?`: ``"pending"`` } ; `passed`: `boolean` ; `request_div`: `string` ; `schema?`: `string` ; `source`: `string` ; `source_hashed_n_id?`: [`NId`](#nid) ; `source_n_id?`: [`NId`](modules.md#nid) ; `type?`: ``null`` ; `v_id`: `string` ; `verification_date`: `string` ; `verifier_div`: `string` ; `verifier_id?`: [`NId`](modules.md#nid) ; `verifier_service_id?`: [`NId`](modules.md#nid) ; `verifier_source_id?`: [`NId`](modules.md#nid) } & `WithValue` extends ``true`` ? { `value`: `string` \| `number` } : {}
572
728
 
573
729
  #### Type parameters
574
730
 
@@ -599,7 +755,7 @@ ___
599
755
 
600
756
  Ƭ **WId**: `StringWithIdentity`<``"WId"``\>
601
757
 
602
- A `wi_id` is the ID of a @see Webhook
758
+ A `wi_id` is the ID of a [Webhook](#webhook)
603
759
 
604
760
  ___
605
761
 
@@ -621,8 +777,8 @@ ___
621
777
  | `status` | [`WebhookStatus`](#webhookstatus) | - |
622
778
  | `subscribe_log?` | { `date`: `string` ; `response_payload`: `Json` ; `response_status_code`: `number` }[] | - |
623
779
  | `webhook_action` | { `webhook_action_type`: `string` }[] | - |
624
- | `webhook_field_mapping_schema` | `Object` | - |
625
- | `webhook_filter_schema` | `Object` | - |
780
+ | `webhook_field_mapping_schema` | { `[key: string]`: `string`; } | - |
781
+ | `webhook_filter_schema` | { `field_name`: `string` ; `field_value`: `string` ; `operator`: `string` } | - |
626
782
  | `webhook_filter_schema.field_name` | `string` | - |
627
783
  | `webhook_filter_schema.field_value` | `string` | - |
628
784
  | `webhook_filter_schema.operator` | `string` | - |
@@ -651,6 +807,7 @@ in the query parameters, it needs to be base64 and/or url encoded.
651
807
  | Name | Type | Description |
652
808
  | :------ | :------ | :------ |
653
809
  | `a_id` | [`AId`](#aid) | - |
810
+ | `display_sharing_preview?` | `boolean` | If this value is true, the form will display some data sharing information before the form (WizardPreview) |
654
811
  | `emails?` | `string`[] | if specified, the email addresses that a submission should be sent to |
655
812
  | `expiry_date?` | `number` | number of days in the future |
656
813
  | `pages` | [`WizardPage`](#wizardpage)[] | - |
@@ -661,10 +818,11 @@ in the query parameters, it needs to be base64 and/or url encoded.
661
818
  | `review_text?` | `string` | the text on the WizardReview page |
662
819
  | `sharing_data_message?` | `string` | the loading message to show next to the spinner after the review screen |
663
820
  | `signature_schema?` | `string` | if specified, a Wizard will be shown on the review page with this schema |
664
- | `skip_share?` | `boolean` | **`deprecated`** added in !244 but never used |
821
+ | `skip_share?` | `boolean` | **`Deprecated`** added in !244 but never used |
665
822
  | `submit_text?` | `string` | the submit button label |
666
823
  | `terms_schema?` | `string` | if specified, a Wizard will be shown on the review page with this schema |
667
824
  | `update_reference?` | `boolean` | whether the user can change the reference, if there is one in the QP |
825
+ | `webauthn_type?` | (``"usb"`` \| ``"nfc"`` \| ``"ble"`` \| ``"internal"``)[] | if specified, the user must validate their WebAuthN credential before they can submit the form |
668
826
 
669
827
  ___
670
828
 
@@ -672,13 +830,14 @@ ___
672
830
 
673
831
  Ƭ **WizardPage**: `Object`
674
832
 
675
- configuration data for a single wizard page (@see WizardConfig)
833
+ configuration data for a single wizard page ([WizardConfig](#wizardconfig))
676
834
 
677
835
  #### Type declaration
678
836
 
679
837
  | Name | Type | Description |
680
838
  | :------ | :------ | :------ |
681
839
  | `allow_upload?` | `boolean` | do not allow uploading in ImageDynamicSection if this is explictly false |
840
+ | `branching_rule_name?` | `string` | If specified, this is is a "Conditional Wizard Page", which is only shown if the rule passed. This field contains the ID (not name) of the rule. |
682
841
  | `create_new_text?` | `string` | custom text to display on the Create New button |
683
842
  | `description?` | `string` | the fallback description, if there isn't one for the specific situation |
684
843
  | `description_create?` | `string` | - |
@@ -702,10 +861,17 @@ configuration data for a single wizard page (@see WizardConfig)
702
861
  | `reverify_header?` | `string` | custom text & header that's displayed on reverfication modal for expired PO |
703
862
  | `reverify_text?` | `string` | - |
704
863
  | `schemas` | `string`[] | - |
705
- | `selection_hierarchy_json?` | `string` | a URL to a preset for configuing NestedSchemaSelect. @see DeepConfig |
864
+ | `selection_hierarchy_json?` | `string` | a URL to a preset for configuing NestedSchemaSelect. DeepConfig |
706
865
  | `service_provider_link?` | `boolean` | see #463 |
707
866
  | `share?` | ``"profile"`` \| ``"verification"`` \| ``"both"`` | the information to share. undefined implies both. |
708
- | `verify_data?` | `boolean` | if `false`, ProfileObjects created while completing the form will not be verified. `undefined` implies `true` |
867
+ | `tags?` | [`WizardPageTag`](#wizardpagetag)[] | - |
868
+ | `verify_data?` | `boolean` | if `false`, ProfileObjects created while completing the form will not be verified. if `true`, you can only select ProfileObjects that are partially or fully verified. `undefined` implies `true`. **`Default`** ```ts true ``` |
869
+
870
+ ___
871
+
872
+ ### WizardPageTag
873
+
874
+ Ƭ **WizardPageTag**: ``"action:require_chip"``
709
875
 
710
876
  ___
711
877
 
@@ -721,9 +887,9 @@ This is what's returned by the API
721
887
  | :------ | :------ | :------ |
722
888
  | `active` | ``true`` | - |
723
889
  | `end_date` | `string` | ISO Date. If this tag exists, the schema is deprecated. |
724
- | `name` | `string` | - |
725
- | `schema` | [`CommonSchemaAttributes`](#commonschemaattributes) & { `$id?`: `string` ; `$schema?`: `string` ; `allOf?`: { `$ref?`: `string` ; `if?`: `Partial`<[`WrappedSchema`](modules.md#wrappedschema)[``"schema"``]\> ; `then?`: `Partial`<[`WrappedSchema`](modules.md#wrappedschema)[``"schema"``]\> }[] ; `definitions?`: `Record`<`string`, `Object`\> ; `properties`: { [fieldName: string]: [`ServerSchemaField`](modules.md#serverschemafield); } ; `required?`: `string`[] ; `verified_fields?`: `string`[] } | - |
890
+ | `schema` | [`CommonSchemaAttributes`](#commonschemaattributes) & { `$id?`: `string` ; `$schema?`: `string` ; `allOf?`: { `$ref?`: `string` ; `if?`: `Partial`<[`WrappedSchema`](modules.md#wrappedschema)[``"schema"``]\> ; `then?`: `Partial`<[`WrappedSchema`](modules.md#wrappedschema)[``"schema"``]\> }[] ; `definitions?`: `Record`<`string`, { `$ref`: [`Urn`](modules.md#urn) }\> ; `properties`: { `[fieldName: string]`: [`ServerSchemaField`](modules.md#serverschemafield); } ; `required?`: `string`[] ; `verified_fields?`: `string`[] } | - |
891
+ | `schema_name` | `string` | Schema Name Type and Version Properties |
892
+ | `schema_type` | [`SchemaType`](#schematype) | - |
893
+ | `schema_version` | `string` | - |
726
894
  | `start_date` | `string` | ISO Date |
727
- | `type` | ``"ss"`` \| ``"ps"`` \| ``"us"`` | - |
728
- | `version` | `string` | - |
729
- | `version_current` | `boolean` | whether the \`version\` is the latest version |
895
+ | `version_current` | `boolean` | whether the `version` is the latest version |