@raytio/types 5.0.0 → 6.0.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
@@ -24,12 +24,8 @@ Hovering over the type in VSCode will display documentation and available proper
24
24
 
25
25
  ### Enumerations
26
26
 
27
- - [FieldVerification](../enums/index.fieldverification.md)
28
- - [POVerification](../enums/index.poverification.md)
29
-
30
- ### Interfaces
31
-
32
- - [WizardPage](../interfaces/index.wizardpage.md)
27
+ - [FieldVerification](enums/FieldVerification.md)
28
+ - [POVerification](enums/POVerification.md)
33
29
 
34
30
  ### Type aliases
35
31
 
@@ -37,6 +33,8 @@ Hovering over the type in VSCode will display documentation and available proper
37
33
  - [AId](#aid)
38
34
  - [Colors](#colors)
39
35
  - [ConditionallyRequired](#conditionallyrequired)
36
+ - [CustomFonts](#customfonts)
37
+ - [DataTypes](#datatypes)
40
38
  - [Encrypted](#encrypted)
41
39
  - [GId](#gid)
42
40
  - [IId](#iid)
@@ -52,43 +50,51 @@ Hovering over the type in VSCode will display documentation and available proper
52
50
  - [Schema](#schema)
53
51
  - [SchemaField](#schemafield)
54
52
  - [SchemaFieldTag](#schemafieldtag)
53
+ - [SchemaMetadata](#schemametadata)
55
54
  - [SchemaTag](#schematag)
55
+ - [SubmissionStatus](#submissionstatus)
56
56
  - [UId](#uid)
57
57
  - [Urn](#urn)
58
58
  - [UrnNodeType](#urnnodetype)
59
+ - [Validation](#validation)
59
60
  - [Verification](#verification)
61
+ - [VerificationPayload](#verificationpayload)
60
62
  - [VerificationProvider](#verificationprovider)
61
63
  - [WizardConfig](#wizardconfig)
64
+ - [WizardPage](#wizardpage)
62
65
 
63
66
  ## Type aliases
64
67
 
65
68
  ### AA
66
69
 
67
- Ƭ **AA**: *object*
68
-
69
- #### Type declaration:
70
-
71
- Name | Type | Description |
72
- :------ | :------ | :------ |
73
- `a_id` | [*AId*](raytio.md#aid) | - |
74
- `aa_introduction`? | *string* | If a user signs up while completing this form, this message will be sent in the sign up email. |
75
- `callback_uri`? | *string*[] | - |
76
- `description`? | *string* | - |
77
- `name` | *string* | - |
78
- `org_id` | *string* | the id of the associated organisation |
79
- `picture`? | *string* | - |
80
- `picture_url`? | *string* | Easy to use AA logo url for pasting inot emails |
81
- `scopes`? | *string*[] | - |
82
- `service_provider_n_id`? | [*NId*](raytio.md#nid) | the n_id of the associated service provider |
83
- `tags`? | *string*[] | - |
84
- `theme`? | *object* | - |
85
- `theme.colors` | [*Colors*](theme.md#colors) | - |
70
+ Ƭ **AA**: `Object`
71
+
72
+ #### Type declaration
73
+
74
+ | Name | Type | Description |
75
+ | :------ | :------ | :------ |
76
+ | `a_id` | [`AId`](#aid) | - |
77
+ | `aa_help?` | `string` | markdown or string help information including [phoneNumber || email] |
78
+ | `aa_introduction?` | `string` | If a user signs up while completing this form, this message will be sent in the sign up email. |
79
+ | `callback_uri?` | `string`[] | - |
80
+ | `description?` | `string` | - |
81
+ | `name` | `string` | - |
82
+ | `org_id` | `string` | the id of the associated organisation |
83
+ | `picture?` | [`Urn`](#urn) | - |
84
+ | `picture_url?` | `string` | Easy to use AA logo url for pasting inot emails |
85
+ | `ruleset?` | `unknown` | configuration for the submission rules |
86
+ | `scopes?` | `string`[] | - |
87
+ | `service_provider_n_id?` | [`NId`](#nid) | the n_id of the associated service provider |
88
+ | `tags?` | `string`[] | - |
89
+ | `theme?` | `Object` | - |
90
+ | `theme.colors?` | [`Colors`](#colors) | - |
91
+ | `theme.font?` | [`CustomFonts`](#customfonts) | - |
86
92
 
87
93
  ___
88
94
 
89
95
  ### AId
90
96
 
91
- Ƭ **AId**: *StringWithIdentity*<*AId*\>
97
+ Ƭ **AId**: `StringWithIdentity`<``"AId"``\>
92
98
 
93
99
  An `a_id` is the ID of an @see AA
94
100
 
@@ -96,70 +102,98 @@ ___
96
102
 
97
103
  ### Colors
98
104
 
99
- Ƭ **Colors**: *object*
100
-
101
- #### Type declaration:
102
-
103
- Name | Type | Description |
104
- :------ | :------ | :------ |
105
- `blank` | *string* | - |
106
- `blankBackground` | *string* | - |
107
- `climaterolText` | *string* | - |
108
- `climaterolUi` | *string* | - |
109
- `errorRed` | *string* | - |
110
- `feelingHugged` | *string* | - |
111
- `poolblueText` | *string* | - |
112
- `poolblueUi` | *string* | - |
113
- `raytioOrangeHover` | *string* | - |
114
- `raytioOrangeShade` | *string* | only used by the fancy layout on the login screen |
115
- `raytioOrangeText` | *string* | - |
116
- `raytioOrangeUi` | *string* | - |
117
- `sariShade` | *string* | - |
118
- `silverShell` | *string* | - |
119
- `sirPinklyText` | *string* | - |
120
- `sirPinklyUi` | *string* | - |
121
- `successGreen` | *string* | - |
122
- `textFull` | *string* | - |
123
- `textLight` | *string* | - |
124
- `textMedium` | *string* | - |
125
- `violaPerpetuoText` | *string* | - |
126
- `violaPerpetuoUi` | *string* | - |
105
+ Ƭ **Colors**: `Object`
106
+
107
+ #### Type declaration
108
+
109
+ | Name | Type | Description |
110
+ | :------ | :------ | :------ |
111
+ | `blank` | `string` | - |
112
+ | `blankBackground` | `string` | - |
113
+ | `climaterolText` | `string` | - |
114
+ | `climaterolUi` | `string` | - |
115
+ | `errorRed` | `string` | - |
116
+ | `feelingHugged` | `string` | - |
117
+ | `loadingYellow` | `string` | - |
118
+ | `poolblueText` | `string` | - |
119
+ | `poolblueUi` | `string` | - |
120
+ | `raytioOrangeHover` | `string` | - |
121
+ | `raytioOrangeShade` | `string` | only used by the fancy layout on the login screen |
122
+ | `raytioOrangeText` | `string` | - |
123
+ | `raytioOrangeUi` | `string` | - |
124
+ | `sariShade` | `string` | - |
125
+ | `silverShell` | `string` | - |
126
+ | `sirPinklyText` | `string` | - |
127
+ | `sirPinklyUi` | `string` | - |
128
+ | `successGreen` | `string` | - |
129
+ | `textFull` | `string` | - |
130
+ | `textLight` | `string` | - |
131
+ | `textMedium` | `string` | - |
132
+ | `violaPerpetuoText` | `string` | - |
133
+ | `violaPerpetuoUi` | `string` | - |
127
134
 
128
135
  ___
129
136
 
130
137
  ### ConditionallyRequired
131
138
 
132
- Ƭ **ConditionallyRequired**: *object*
139
+ Ƭ **ConditionallyRequired**: `Object`
140
+
141
+ should be renamed since this applies to ConditionallyVerifiable
142
+
143
+ #### Type declaration
144
+
145
+ | Name | Type |
146
+ | :------ | :------ |
147
+ | `field` | `string` |
148
+ | `if` | `Object` |
149
+
150
+ ___
151
+
152
+ ### CustomFonts
153
+
154
+ Ƭ **CustomFonts**: `Object`
155
+
156
+ #### Type declaration
133
157
 
134
- #### Type declaration:
158
+ | Name | Type |
159
+ | :------ | :------ |
160
+ | `body?` | `string` |
161
+ | `header?` | `string` |
135
162
 
136
- Name | Type |
137
- :------ | :------ |
138
- `field` | *string* |
139
- `if` | *object* |
163
+ ___
164
+
165
+ ### DataTypes
166
+
167
+ Ƭ **DataTypes**: ``"string"`` \| ``"number"`` \| ``"boolean"`` \| ``"object"`` \| ``"integer"`` \| ``"array"`` \| ``"null"``
140
168
 
141
169
  ___
142
170
 
143
171
  ### Encrypted
144
172
 
145
- Ƭ **Encrypted**: *object*
173
+ Ƭ **Encrypted**<`_Data`\>: `Object`
146
174
 
147
- #### Type declaration:
175
+ #### Type parameters
148
176
 
149
- Name | Type |
150
- :------ | :------ |
151
- `encrypted_data` | *object* |
152
- `encrypted_data.algorithm` | AesKeyAlgorithm |
153
- `encrypted_data.data` | *string* |
154
- `encrypted_data.iv` | *string* |
155
- `encrypted_key` | *object* |
156
- `encrypted_key.encrypted_key` | *string* |
177
+ | Name | Type |
178
+ | :------ | :------ |
179
+ | `_Data` | `string` |
180
+
181
+ #### Type declaration
182
+
183
+ | Name | Type |
184
+ | :------ | :------ |
185
+ | `encrypted_data` | `Object` |
186
+ | `encrypted_data.algorithm` | `AesKeyAlgorithm` |
187
+ | `encrypted_data.data` | `string` |
188
+ | `encrypted_data.iv` | `string` |
189
+ | `encrypted_key` | `Object` |
190
+ | `encrypted_key.encrypted_key` | `string` |
157
191
 
158
192
  ___
159
193
 
160
194
  ### GId
161
195
 
162
- Ƭ **GId**: *StringWithIdentity*<*GId*\>
196
+ Ƭ **GId**: `StringWithIdentity`<``"GId"``\>
163
197
 
164
198
  A `g_id` is the ID of a group
165
199
 
@@ -167,7 +201,7 @@ ___
167
201
 
168
202
  ### IId
169
203
 
170
- Ƭ **IId**: *StringWithIdentity*<*IId*\>
204
+ Ƭ **IId**: `StringWithIdentity`<``"IId"``\>
171
205
 
172
206
  An `i_id` is the ID of an @see Instance
173
207
 
@@ -175,50 +209,52 @@ ___
175
209
 
176
210
  ### Instance
177
211
 
178
- Ƭ **Instance**: *object*
179
-
180
- #### Type declaration:
181
-
182
- Name | Type | Description |
183
- :------ | :------ | :------ |
184
- `_state`? | SubmissionStatus | **`depreacted`** The status of a submission |
185
- `a_id` | [*AId*](raytio.md#aid) | ID of the access application this submission was made to |
186
- `aa_name` | *string* | name of the access application this submission was made to |
187
- `confirmation_code` | *string* | Code that validates information has been shared |
188
- `data_provider_email` | *string* | Email of user who shared the data |
189
- `end_date` | *string* | Latest date in which the shared information was available |
190
- `i_id` | [*IId*](raytio.md#iid) | Access application instance ID |
191
- `keys` | *object* | - |
192
- `previous_state` | *string* | Previous status of the shared information |
193
- `profile_objects` | [*ProfileObject*](raytio.md#profileobject)[] | data associated is access application's instance |
194
- `reference` | *string* | reference provided by the user who shared the data |
195
- `service_provider_n_id`? | [*NId*](raytio.md#nid) | Service provider ID |
196
- `start_date` | *string* | Earliest date on which the shared information was available |
197
- `state` | SubmissionStatus | The status of a submission |
198
- `sub_service_provider_hash`? | *string* | Hash of the Service Provider ID |
199
- `thread` | *string* | - |
212
+ Ƭ **Instance**: `Object`
213
+
214
+ #### Type declaration
215
+
216
+ | Name | Type | Description |
217
+ | :------ | :------ | :------ |
218
+ | `_state?` | [`SubmissionStatus`](#submissionstatus) | **`depreacted`** The status of a submission |
219
+ | `a_id` | [`AId`](#aid) | ID of the access application this submission was made to |
220
+ | `aa_name` | `string` | name of the access application this submission was made to |
221
+ | `confirmation_code` | `string` | Code that validates information has been shared |
222
+ | `data_provider_email` | `string` | Email of user who shared the data |
223
+ | `end_date` | `string` | Latest date in which the shared information was available |
224
+ | `i_id` | [`IId`](#iid) | Access application instance ID |
225
+ | `keys` | `Object` | - |
226
+ | `previous_state` | [`SubmissionStatus`](#submissionstatus) | Previous status of the shared information |
227
+ | `profile_objects` | [`ProfileObject`](#profileobject)[] | data associated is access application's instance |
228
+ | `reference` | `string` | reference provided by the user who shared the data |
229
+ | `relationships?` | [`Relationship`](#relationship)[] | - |
230
+ | `service_provider_n_id?` | [`NId`](#nid) | Service provider ID |
231
+ | `start_date` | `string` | Earliest date on which the shared information was available |
232
+ | `state` | [`SubmissionStatus`](#submissionstatus) | The status of a submission |
233
+ | `sub_service_provider_hash?` | `string` | Hash of the Service Provider ID |
234
+ | `thread` | `string` | - |
200
235
 
201
236
  ___
202
237
 
203
238
  ### Lookup
204
239
 
205
- Ƭ **Lookup**: *object*
240
+ Ƭ **Lookup**: `Object`
206
241
 
207
- #### Type declaration:
242
+ #### Type declaration
208
243
 
209
- Name | Type | Description |
210
- :------ | :------ | :------ |
211
- `children`? | [*Lookup*](raytio.md#lookup)[] | - |
212
- `description`? | *string* | - |
213
- `key` | *string* \| *number* | - |
214
- `label`? | *string* \| *number* | Used in Antd Cascader |
215
- `value` | *string* \| *number* | - |
244
+ | Name | Type | Description |
245
+ | :------ | :------ | :------ |
246
+ | `children?` | [`Lookup`](#lookup)[] | - |
247
+ | `description?` | `string` | - |
248
+ | `key` | `string` \| `number` | - |
249
+ | `label?` | `string` \| `number` | Used in Antd Cascader |
250
+ | `requires_2FA?` | `boolean` | used in AkahuDynamicSection only |
251
+ | `value` | `string` \| `number` | - |
216
252
 
217
253
  ___
218
254
 
219
255
  ### NId
220
256
 
221
- Ƭ **NId**: *StringWithIdentity*<*NId*\>
257
+ Ƭ **NId**: `StringWithIdentity`<``"NId"``\>
222
258
 
223
259
  An `n_id` is the ID of a @see ProfileObject
224
260
 
@@ -226,32 +262,32 @@ ___
226
262
 
227
263
  ### Organization
228
264
 
229
- Ƭ **Organization**: *object*
265
+ Ƭ **Organization**: `Object`
230
266
 
231
267
  An organization.
232
268
  NOTE: this is different to how the schema defines an Organization. **The schema is wrong (see #468)**
233
269
 
234
- #### Type declaration:
235
-
236
- Name | Type |
237
- :------ | :------ |
238
- `address` | *object* |
239
- `address.city` | *string* |
240
- `address.country` | *string* |
241
- `address.locationType` | *string* |
242
- `address.region` | *string* |
243
- `address.street1` | *string* |
244
- `address.street2` | *string* |
245
- `customer` | *Record*<string, unknown\> |
246
- `email` | *string* |
247
- `id` | *string* |
248
- `name` | *string* |
270
+ #### Type declaration
271
+
272
+ | Name | Type |
273
+ | :------ | :------ |
274
+ | `address` | `Object` |
275
+ | `address.city` | `string` |
276
+ | `address.country` | `string` |
277
+ | `address.locationType` | `string` |
278
+ | `address.region` | `string` |
279
+ | `address.street1` | `string` |
280
+ | `address.street2` | `string` |
281
+ | `customer` | `Record`<`string`, `unknown`\> |
282
+ | `email` | `string` |
283
+ | `id` | `string` |
284
+ | `name` | `string` |
249
285
 
250
286
  ___
251
287
 
252
288
  ### PId
253
289
 
254
- Ƭ **PId**: *StringWithIdentity*<*PId*\>
290
+ Ƭ **PId**: `StringWithIdentity`<``"PId"``\>
255
291
 
256
292
  A `p_id` is the ID of a @see Relationship
257
293
 
@@ -259,29 +295,29 @@ ___
259
295
 
260
296
  ### ProfileObject
261
297
 
262
- Ƭ **ProfileObject**<Properties\>: *object*
298
+ Ƭ **ProfileObject**<`Properties`\>: `Object`
263
299
 
264
300
  You can supply an option type argument if you know exactly what the properties will be
265
301
 
266
- #### Type parameters:
302
+ #### Type parameters
267
303
 
268
- Name | Default |
269
- :------ | :------ |
270
- `Properties` | *any* |
304
+ | Name | Type |
305
+ | :------ | :------ |
306
+ | `Properties` | `Json` |
271
307
 
272
- #### Type declaration:
308
+ #### Type declaration
273
309
 
274
- Name | Type |
275
- :------ | :------ |
276
- `labels` | *string*[] |
277
- `n_id` | [*NId*](raytio.md#nid) |
278
- `properties` | Properties |
310
+ | Name | Type |
311
+ | :------ | :------ |
312
+ | `labels` | `string`[] |
313
+ | `n_id` | [`NId`](#nid) |
314
+ | `properties` | `Properties` |
279
315
 
280
316
  ___
281
317
 
282
318
  ### Properties
283
319
 
284
- Ƭ **Properties**: *object*
320
+ Ƭ **Properties**: `Object`
285
321
 
286
322
  arbitrary key-values pairs stored on a Profile Object.
287
323
  May contain nested JSON and @see Encrypted properties.
@@ -289,153 +325,178 @@ May contain nested JSON and @see Encrypted properties.
289
325
  There are some limits to field names: they cannot be called
290
326
  `__signature` nor can they include the character sequence `<=>`.
291
327
 
292
- #### Type declaration:
328
+ #### Index signature
329
+
330
+ ▪ [fieldName: `string`]: `any`
293
331
 
294
332
  ___
295
333
 
296
334
  ### RealVer
297
335
 
298
- Ƭ **RealVer**: *object*
336
+ Ƭ **RealVer**: `Object`
299
337
 
300
338
  This is what @raytio/core exposes, which is more useable than @see Verification
301
339
 
302
- #### Type declaration:
303
-
304
- Name | Type | Description |
305
- :------ | :------ | :------ |
306
- `belongsToNId`? | [*NId*](raytio.md#nid) | nId of the PO that the verification belongs to. Could be undefined |
307
- `expired` | Date \| *false* | If the verification has expired, it's the date that it expired on. Otherwise it's `false` |
308
- `fieldName` | *string* | - |
309
- `metadata`? | *Record*<string, unknown\> | arbitary metadata returned by the verifier |
310
- `nID` | [*NId*](raytio.md#nid) | nId of the verification |
311
- `provider` | [*VerificationProvider*](verification.md#verificationprovider) | - |
312
- `signature` | *string* | - |
313
- `value` | *string* \| *number* | - |
314
- `verified` | *boolean* | whether the `fieldName`/`value` pair is verified, as confirmed by the API. This should be the single source of truth. |
315
- `xId` | *string* | this will be a unique id to group verifications from the same PO. Doesn't work yet |
340
+ #### Type declaration
341
+
342
+ | Name | Type | Description |
343
+ | :------ | :------ | :------ |
344
+ | `belongsToNId?` | [`NId`](#nid) | nId of the PO that the verification belongs to. Could be undefined |
345
+ | `expired` | `Date` \| ``false`` | If the verification has expired, it's the date that it expired on. Otherwise it's `false` |
346
+ | `fieldName` | `string` | - |
347
+ | `metadata?` | `Record`<`string`, `unknown`\> | arbitary metadata returned by the verifier |
348
+ | `nID` | [`NId`](#nid) | nId of the verification |
349
+ | `provider` | [`VerificationProvider`](#verificationprovider) | - |
350
+ | `signature` | `string` | - |
351
+ | `value` | `unknown` | - |
352
+ | `verified` | `boolean` | whether the `fieldName`/`value` pair is verified, as confirmed by the API. This should be the single source of truth. |
353
+ | `xId` | `string` | this will be a unique id to group verifications from the same PO. Doesn't work yet |
316
354
 
317
355
  ___
318
356
 
319
357
  ### Relationship
320
358
 
321
- Ƭ **Relationship**: *object*
359
+ Ƭ **Relationship**: `Object`
322
360
 
323
- #### Type declaration:
361
+ #### Type declaration
324
362
 
325
- Name | Type |
326
- :------ | :------ |
327
- `end` | [*Urn*](raytio.md#urn) |
328
- `p_id` | [*PId*](raytio.md#pid) |
329
- `properties`? | *object* |
330
- `properties.name`? | *string* |
331
- `properties.p_id` | [*PId*](raytio.md#pid) |
332
- `start` | [*Urn*](raytio.md#urn) |
333
- `type` | *string* |
363
+ | Name | Type |
364
+ | :------ | :------ |
365
+ | `end` | [`Urn`](#urn) |
366
+ | `p_id` | [`PId`](#pid) |
367
+ | `properties?` | `Object` |
368
+ | `properties.name?` | `string` |
369
+ | `properties.p_id` | [`PId`](#pid) |
370
+ | `start` | [`Urn`](#urn) |
371
+ | `type` | `string` |
334
372
 
335
373
  ___
336
374
 
337
375
  ### Schema
338
376
 
339
- Ƭ **Schema**: *object*
377
+ Ƭ **Schema**: `Object`
340
378
 
341
379
  Raytio's variant of JSON Schema. All props marked as optional except
342
380
  `name`. This type can be used for both the schema and for individual fields.
343
381
 
344
- #### Type declaration:
345
-
346
- Name | Type | Description |
347
- :------ | :------ | :------ |
348
- `$id`? | *string* | - |
349
- `$ref`? | *string* | **`deprecated`** not sure why a schema would have this, only fields should |
350
- `$schema`? | *string* | - |
351
- `allOf`? | { `$ref?`: *string* ; `if?`: [*Schema*](schema.md#schema) ; `then?`: [*Schema*](schema.md#schema) }[] | - |
352
- `definitions`? | *Record*<string, { `$ref`: [*Urn*](raytio.md#urn) }\> | - |
353
- `description`? | *string* | - |
354
- `display`? | *object* | - |
355
- `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 |
356
- `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 |
357
- `display.head_main.fields` | *string*[] | - |
358
- `display.head_main.format`? | *string* | - |
359
- `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 |
360
- `display.head_sub.fields` | *string*[] | - |
361
- `display.head_sub.format`? | *string* | - |
362
- `i18n`? | *object* | - |
363
- `name` | *string* | name will always exist on schema |
364
- `onboard_properties`? | *object* | only the schema used for the onboarding wizard have this property |
365
- `onboard_properties.organizations`? | { `access_applications?`: { `links?`: { `description`: *string* ; `wizardConfig`: *Omit*<[*WizardConfig*](wizard.md#wizardconfig), *a_id*\> }[] ; `properties`: *Omit*<[*AA*](raytio.md#aa), *org_id*\> }[] ; `properties`: [*Organization*](raytio.md#organization) }[] | Organizations that should be created. NOTE: if multiple are specified, when the wizard completes, the _first one_ will be selected |
366
- `onboard_properties.profile_objects`? | { `properties`: *Record*<string, unknown\> ; `schema_name`: *string* }[] | Profile Objects that should be created |
367
- `properties`? | *object* | this is deliberately an optional prop, there are cases where properties are undefined, e.g. - from get-all-schema API - if the schema is a sub-object |
368
- `relationships`? | { `anyOf?`: *string*[] ; `direction`: *from* ; `multiple?`: *boolean* ; `oneOf?`: *string*[] ; `properties?`: { [fieldName: string]: [*SchemaField*](schema.md#schemafield); } ; `relationship_name`: *string* ; `required?`: *string*[] ; `type`: *string* }[] | - |
369
- `required`? | (*string* \| [*ConditionallyRequired*](schema.md#conditionallyrequired))[] | added by client |
370
- `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. |
371
- `tags`? | [*SchemaTag*](schema.md#schematag)[] | - |
372
- `title`? | *string* | - |
373
- `type`? | DataTypes | - |
374
- `verified_fields`? | *string*[] | - |
375
- `wasExpandedByClient`? | *boolean* | - |
382
+ #### Type declaration
383
+
384
+ | Name | Type | Description |
385
+ | :------ | :------ | :------ |
386
+ | `$id?` | `string` | **`deprecated`** don't use this |
387
+ | `$ref?` | `string` | **`deprecated`** not sure why a schema would have this, only fields should |
388
+ | `$schema?` | `string` | - |
389
+ | `allOf?` | { `$ref?`: `string` ; `if?`: [`Schema`](#schema) ; `then?`: [`Schema`](modules.md#schema) }[] | - |
390
+ | `definitions?` | `Record`<`string`, `Object`\> | - |
391
+ | `description` | `string` | - |
392
+ | `display?` | `Object` | - |
393
+ | `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 |
394
+ | `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 |
395
+ | `display.head_main.fields` | `string`[] | - |
396
+ | `display.head_main.format?` | `string` | - |
397
+ | `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 |
398
+ | `display.head_sub.fields` | `string`[] | - |
399
+ | `display.head_sub.format?` | `string` | - |
400
+ | `end_date?` | `string` | If this tag exists, the schema is deprecated. ISO Date. |
401
+ | `group_title?` | `string` | the localized title of the `schema_group`. added by the client |
402
+ | `i18n?` | `Object` | - |
403
+ | `n_id?` | [`NId`](#nid) | - |
404
+ | `name` | `string` | these fields will always exist on schema |
405
+ | `onboard_properties?` | `Object` | only the schema used for the onboarding wizard have this property |
406
+ | `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 |
407
+ | `onboard_properties.profile_objects?` | { `properties`: `Record`<`string`, `unknown`\> ; `schema_name`: `string` }[] | Profile Objects that should be created |
408
+ | `onboard_properties.relationships?` | { `from`: `string` ; `properties?`: `Record`<`string`, `string`\> ; `to`: `string` ; `type`: `string` }[] | Relationships that should be created |
409
+ | `onboard_properties.return_to?` | `string` | The relative path in the client to redirect to once finished. May include variables |
410
+ | `properties` | `Object` | 🚨 Note that there are cases where properties are undefined, e.g. if the schema is a sub-object |
411
+ | `relationships?` | { `anyOf?`: `string`[] ; `direction`: ``"from"`` ; `multiple?`: `boolean` ; `oneOf?`: `string`[] ; `properties?`: { [fieldName: string]: [`SchemaField`](#schemafield); } ; `relationship_name`: `string` ; `required?`: `string`[] ; `required_relationship?`: `boolean` ; `type`: `string` }[] | - |
412
+ | `required?` | (`string` \| [`ConditionallyRequired`](#conditionallyrequired))[] | added by client |
413
+ | `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. |
414
+ | `tags?` | [`SchemaTag`](#schematag)[] | - |
415
+ | `title` | `string` | - |
416
+ | `title_plural?` | `string` | plural version of the title |
417
+ | `type?` | [`DataTypes`](#datatypes) | - |
418
+ | `verified_fields?` | (`string` \| [`ConditionallyRequired`](#conditionallyrequired))[] | originally `string[]`, the client modifies this |
419
+ | `wasExpandedByClient?` | `boolean` | - |
376
420
 
377
421
  ___
378
422
 
379
423
  ### SchemaField
380
424
 
381
- Ƭ **SchemaField**: *object*
382
-
383
- #### Type declaration:
384
-
385
- Name | Type | Description |
386
- :------ | :------ | :------ |
387
- `$id`? | *string* | **`deprecated`** don't use, it's inconsistent |
388
- `$ref`? | *string* | If this field refers to a sub-object |
389
- `add_row_btn_label`? | *string* | if this field is a table input, this determines the text to show on the "Add Row" btn |
390
- `allOf`? | [{ `$ref`: *string* }, [*SchemaField*](schema.md#schemafield)] | - |
391
- `content`? | *string* | only checkbox uses this prop |
392
- `contentEncoding`? | *base64* | - |
393
- `contentMediaType`? | *string* | - |
394
- `default`? | *unknown* | - |
395
- `default_signature_name`? | *string* | used on fields that are a signature file picker, see !849 also used to determine if the MediaPicker should be shown inline |
396
- `description`? | *string* | - |
397
- `description_decorator`? | *md* | specifies that the description is formatted in markdown |
398
- `encrypt`? | *boolean* | whether the field should be encrypted |
399
- `enum`? | *unknown*[] | - |
400
- `examples`? | *unknown*[] | - |
401
- `format`? | *date* \| *date-time* | - |
402
- `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 |
403
- `items`? | *object* | for nested JSON |
404
- `items.properties` | *object* | - |
405
- `items.type` | DataTypes | - |
406
- `lookup`? | *string* | URL to a JSON file in the `Lookup` format |
407
- `maxLength`? | *number* | **`deprecated`** raytio's usage not documented |
408
- `maximum`? | *number* | - |
409
- `minLength`? | *number* | **`deprecated`** raytio's usage not documented |
410
- `minimum`? | *number* | - |
411
- `override`? | *object* | - |
412
- `override.permissions` | *object* | - |
413
- `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. |
414
- `pattern`? | *string* | - |
415
- `patternMessage`? | *string* | if a `pattern` is specified, this is the error message |
416
- `priority`? | *number* | - |
417
- `readOnly`? | *boolean* | readOnly means the Wizard won't show this field |
418
- `tags`? | [*SchemaFieldTag*](schema.md#schemafieldtag)[] | - |
419
- `title`? | *string* | - |
420
- `type`? | DataTypes | - |
425
+ Ƭ **SchemaField**: `Object`
426
+
427
+ #### Type declaration
428
+
429
+ | Name | Type | Description |
430
+ | :------ | :------ | :------ |
431
+ | `$id?` | `string` | **`deprecated`** don't use, it's inconsistent |
432
+ | `$ref?` | `string` | If this field refers to a sub-object |
433
+ | `add_row_btn_label?` | `string` | if this field is a table input, this determines the text to show on the "Add Row" btn |
434
+ | `allOf?` | [{ `$ref`: `string` }, [`SchemaField`](#schemafield)] | - |
435
+ | `content?` | `string` | only checkbox uses this prop |
436
+ | `contentEncoding?` | ``"base64"`` | - |
437
+ | `contentMediaType?` | `string` | - |
438
+ | `default?` | `unknown` | the default value |
439
+ | `default_signature_name?` | `string` | used on fields that are a signature file picker, see !849 also used to determine if the MediaPicker should be shown inline |
440
+ | `description?` | `string` | - |
441
+ | `description_decorator?` | ``"md"`` | specifies that the description is formatted in markdown |
442
+ | `encrypt?` | `boolean` | whether the field should be encrypted |
443
+ | `enum?` | `string`[] | - |
444
+ | `examples?` | `unknown`[] | - |
445
+ | `format?` | ``"date"`` \| ``"date-time"`` | - |
446
+ | `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 |
447
+ | `items?` | `Object` | `items` is used for nested arrays, (while `properties` is used for nested objects) |
448
+ | `items.properties` | `Object` | - |
449
+ | `items.type` | [`DataTypes`](#datatypes) | - |
450
+ | `lookup?` | `string` | URL to a JSON file in the `Lookup` format |
451
+ | `maxLength?` | `number` | **`deprecated`** raytio's usage not documented |
452
+ | `maximum?` | `number` | - |
453
+ | `minLength?` | `number` | **`deprecated`** raytio's usage not documented |
454
+ | `minimum?` | `number` | - |
455
+ | `override?` | `Object` | - |
456
+ | `override.permissions` | `Object` | - |
457
+ | `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. |
458
+ | `pattern?` | `string` | - |
459
+ | `patternMessage?` | `string` | if a `pattern` is specified, this is the error message |
460
+ | `priority?` | `number` | - |
461
+ | `properties?` | `Object` | `properties` is used for nested objects, (while `items` is used for nested arrays) |
462
+ | `readOnly?` | `boolean` | readOnly means the Wizard won't show this field |
463
+ | `table_empty_message?` | `string` | if this field is a table input, this determines the text to show if the table is empty |
464
+ | `tags?` | [`SchemaFieldTag`](#schemafieldtag)[] | - |
465
+ | `title?` | `string` | - |
466
+ | `title_plural?` | `string` | - |
467
+ | `type?` | [`DataTypes`](#datatypes) | - |
421
468
 
422
469
  ___
423
470
 
424
471
  ### SchemaFieldTag
425
472
 
426
- Ƭ **SchemaFieldTag**: *password* \| \`group:${string}\` \| \`upload-group:${string}\` \| *display:stars* \| *display:no_autofill* \| *display:currency* \| *display:cascade* \| *display:survey* \| *display:quoting* \| *display:customModal* \| \`display:main\_media:${string}\` \| *action:client_upload* \| *verify:show_if_pending* \| *special:hide_select_behind_button* \| *type:extract_required*
473
+ Ƭ **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:showOnWizard"`` \| \`display:main\_media:${string}\` \| ``"action:client_upload"`` \| ``"verify:show_if_pending"`` \| ``"special:hide_select_behind_button"`` \| ``"type:extract_required"``
474
+
475
+ ___
476
+
477
+ ### SchemaMetadata
478
+
479
+ Ƭ **SchemaMetadata**: `Pick`<[`Schema`](#schema), ``"name"`` \| ``"title"`` \| ``"description"`` \| ``"schema_group"`` \| ``"end_date"`` \| ``"i18n"`` \| ``"display"`` \| ``"tags"`` \| ``"clientLocale"`` \| ``"groupNames"`` \| ``"title_plural"`` \| ``"group_title"``\> & { `__typeof__`: ``"You cannot supply SchemaMetadata to a function that expects Schema"`` ; `isProfileSchema`: `boolean` ; `isSpSchema`: `boolean` }
480
+
481
+ Only certain properties from the schema
427
482
 
428
483
  ___
429
484
 
430
485
  ### SchemaTag
431
486
 
432
- Ƭ **SchemaTag**: *type:provider_profile* \| *type:service_offer* \| *client_only* \| *globally_unique_field* \| *action:verify* \| *action:experimental_pass_urn* \| *type:service_provider* \| *type:marketplace* \| *type:client_only* \| *type:globally_unique_field*
487
+ Ƭ **SchemaTag**: ``"action:experimental_pass_object_store_id"`` \| ``"action:verify"`` \| ``"default_camera:rear"`` \| ``"default_camera:front"`` \| \`link\_to:${string}:${string}\` \| ``"type:service_provider"`` \| ``"type:service_offer"`` \| ``"type:marketplace"`` \| ``"type:client_only"`` \| ``"type:globally_unique_field"``
488
+
489
+ ___
490
+
491
+ ### SubmissionStatus
492
+
493
+ Ƭ **SubmissionStatus**: ``"Submitted"`` \| ``"Processing"`` \| ``"Rejected"`` \| ``"Expired"`` \| ``"Completed"`` \| ``"DataChanged"`` \| ``"Received"`` \| ``"Accepted"``
433
494
 
434
495
  ___
435
496
 
436
497
  ### UId
437
498
 
438
- Ƭ **UId**: *StringWithIdentity*<*UId*\>
499
+ Ƭ **UId**: `StringWithIdentity`<``"UId"``\>
439
500
 
440
501
  A `u_id` is the ID of a user
441
502
 
@@ -451,64 +512,136 @@ ___
451
512
 
452
513
  ### UrnNodeType
453
514
 
454
- Ƭ **UrnNodeType**: *user* \| *profile_object* \| *instance* \| *temp_object* \| *document*
515
+ Ƭ **UrnNodeType**: ``"user"`` \| ``"profile_object"`` \| ``"instance"`` \| ``"temp_object"`` \| ``"document"``
516
+
517
+ ___
518
+
519
+ ### Validation
520
+
521
+ Ƭ **Validation**: `Object`
522
+
523
+ validation data returned by preVerify (part of the extract&map API)
524
+
525
+ #### Type declaration
526
+
527
+ | Name | Type |
528
+ | :------ | :------ |
529
+ | `breakdown` | `Object` |
530
+ | `score` | `number` |
531
+ | `warning?` | `string`[] |
455
532
 
456
533
  ___
457
534
 
458
535
  ### Verification
459
536
 
460
- Ƭ **Verification**<WithValue\>: [*ProfileObject*](raytio.md#profileobject)<{ `field`: *string* ; `n_id`: [*NId*](raytio.md#nid) ; `valid_until?`: *string* ; `verifications`: [{ `data`: { `field`: *string* ; `metadata?`: *Record*<string, unknown\> ; `passed`: *boolean* ; `request_div`: *string* ; `source`: *string* ; `source_n_id`: [*NId*](raytio.md#nid) ; `v_id`: *string* ; `verification_date`: *string* ; `verifier_div`: *string* ; `verifier_id?`: [*NId*](raytio.md#nid) ; `verifier_service_id?`: [*NId*](raytio.md#nid) ; `verifier_source_id?`: [*NId*](raytio.md#nid) } & WithValue *extends* *true* ? { `value`: *string* \| *number* } : {} ; `signature`: *string* }] }\>
537
+ Ƭ **Verification**<`WithValue`\>: [`ProfileObject`](#profileobject)<`Object`\>
461
538
 
462
539
  Different APIs inconsistently include the `value` prop. If you know it exists,
463
540
  use `Verification<true>`, otherwise just `Verification`. Verifications from
464
541
  the DataContext don't have the value.
465
542
 
466
- #### Type parameters:
543
+ #### Type parameters
467
544
 
468
- Name | Type | Default |
469
- :------ | :------ | :------ |
470
- `WithValue` | *boolean* | *false* |
545
+ | Name | Type |
546
+ | :------ | :------ |
547
+ | `WithValue` | extends `boolean```false`` |
548
+
549
+ ___
550
+
551
+ ### VerificationPayload
552
+
553
+ Ƭ **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` } : {}
554
+
555
+ #### Type parameters
556
+
557
+ | Name | Type |
558
+ | :------ | :------ |
559
+ | `WithValue` | extends `boolean` |
471
560
 
472
561
  ___
473
562
 
474
563
  ### VerificationProvider
475
564
 
476
- Ƭ **VerificationProvider**: *object*
565
+ Ƭ **VerificationProvider**: `Object`
477
566
 
478
567
  These `n_id`s point to service provider profile objects
479
568
 
480
- #### Type declaration:
569
+ #### Type declaration
481
570
 
482
- Name | Type | Description |
483
- :------ | :------ | :------ |
484
- `dataSourceNId`? | [*NId*](raytio.md#nid) | - |
485
- `date` | Date | the date which the verification was verified on, or last re-verified on |
486
- `serviceProviderNId`? | [*NId*](raytio.md#nid) | - |
487
- `verifierNId`? | [*NId*](raytio.md#nid) | - |
571
+ | Name | Type | Description |
572
+ | :------ | :------ | :------ |
573
+ | `dataSourceNId?` | [`NId`](#nid) | - |
574
+ | `date` | `Date` | the date which the verification was verified on, or last re-verified on |
575
+ | `serviceProviderNId?` | [`NId`](#nid) | - |
576
+ | `verifierNId?` | [`NId`](#nid) | - |
488
577
 
489
578
  ___
490
579
 
491
580
  ### WizardConfig
492
581
 
493
- Ƭ **WizardConfig**: *object*
582
+ Ƭ **WizardConfig**: `Object`
494
583
 
495
584
  when a form link is generated, this is what gets saved on the API.
496
585
  Each value can be overriden in the query parameters. If specified
497
586
  in the query parameters, it needs to be base64 and/or url encoded.
498
587
 
499
- #### Type declaration:
500
-
501
- Name | Type | Description |
502
- :------ | :------ | :------ |
503
- `a_id` | [*AId*](raytio.md#aid) | - |
504
- `emails`? | *string*[] | if specified, the email addresses that a submission should be sent to |
505
- `expiry_date`? | *number* | number of days in the future |
506
- `pages` | [*WizardPage*](../interfaces/wizard.wizardpage.md)[] | - |
507
- `reference`? | *string* | - |
508
- `return_to`? | *string* | the callback url to redirect to once complete. Must be in the AA's list of authorized callback urls |
509
- `review_text`? | *string* | the text on the WizardReview page |
510
- `signature_schema`? | *string* | if specified, a Wizard will be shown on the review page with this schema |
511
- `skip_share`? | *boolean* | **`deprecated`** added in !244 but never used |
512
- `submit_text`? | *string* | the submit button label |
513
- `terms_schema`? | *string* | if specified, a Wizard will be shown on the review page with this schema |
514
- `update_reference`? | *boolean* | whether the user can change the reference, if there is one in the QP |
588
+ #### Type declaration
589
+
590
+ | Name | Type | Description |
591
+ | :------ | :------ | :------ |
592
+ | `a_id` | [`AId`](#aid) | - |
593
+ | `emails?` | `string`[] | if specified, the email addresses that a submission should be sent to |
594
+ | `expiry_date?` | `number` | number of days in the future |
595
+ | `pages` | [`WizardPage`](#wizardpage)[] | - |
596
+ | `quick_onboard?` | `boolean` | whether the passwordless-signup process should be used if the user visits this form, and they are not logged in. If false, the standard sign-up process will be used |
597
+ | `reference?` | `string` | - |
598
+ | `relationships?` | { `from`: `string` ; `properties?`: `Record`<`string`, `any`\> ; `to`: `string` ; `type`: `string` }[] | a list of relationships that should be created after the wizard completes (see #987) |
599
+ | `return_to?` | `string` | the callback url to redirect to once complete. Must be in the AA's list of authorized callback urls |
600
+ | `review_text?` | `string` | the text on the WizardReview page |
601
+ | `sharing_data_message?` | `string` | the loading message to show next to the spinner after the review screen |
602
+ | `signature_schema?` | `string` | if specified, a Wizard will be shown on the review page with this schema |
603
+ | `skip_share?` | `boolean` | **`deprecated`** added in !244 but never used |
604
+ | `submit_text?` | `string` | the submit button label |
605
+ | `terms_schema?` | `string` | if specified, a Wizard will be shown on the review page with this schema |
606
+ | `update_reference?` | `boolean` | whether the user can change the reference, if there is one in the QP |
607
+
608
+ ___
609
+
610
+ ### WizardPage
611
+
612
+ Ƭ **WizardPage**: `Object`
613
+
614
+ configuration data for a single wizard page (@see WizardConfig)
615
+
616
+ #### Type declaration
617
+
618
+ | Name | Type | Description |
619
+ | :------ | :------ | :------ |
620
+ | `allow_upload?` | `boolean` | do not allow uploading in ImageDynamicSection if this is explictly false |
621
+ | `create_new_text?` | `string` | custom text to display on the Create New button |
622
+ | `description?` | `string` | the fallback description, if there isn't one for the specific situation |
623
+ | `description_create?` | `string` | - |
624
+ | `description_select?` | `string` | - |
625
+ | `description_update?` | `string` | - |
626
+ | `display_field_description?` | `boolean` | whether the field descriptions should be shown |
627
+ | `display_field_title?` | `boolean` | whether the field titles should be shown |
628
+ | `display_mode?` | ``"light"`` \| ``"dark"`` \| ``"default"`` | can you force the colour theme to change for just one page (#1066, #1074). At the moment this on pages that use WebcamImageCapture |
629
+ | `display_schema_description?` | `boolean` | whether the schema description should be shown |
630
+ | `extract_threshold?` | `number` | for ImageDynamicSection, the minimum score to be treated as a pass |
631
+ | `extract_threshold_fail_action?` | ``"capture"`` \| ``"capture_review"`` \| ``"recapture_or_next_step"`` \| ``"review"`` \| ``"next_step"`` | for ImageDynamicSection, the action to take if pre-verify fails |
632
+ | `extract_threshold_null_action?` | [`WizardPage`](#wizardpage)[``"extract_threshold_fail_action"``] | for ImageDynamicSection, the action to take if the API returns no `validation: {}` object |
633
+ | `extract_threshold_pass_action?` | ``"review"`` \| ``"next_step"`` | for ImageDynamicSection, the action to take if pre-verify passes |
634
+ | `field_list?` | `string`[] | if supplied, only the fields that are listed should be shared (#520, #1024) |
635
+ | `filter` | ``"oneOf"`` \| ``"anyOf"`` | - |
636
+ | `multiple?` | `boolean` | if true mulitple POs can be shared |
637
+ | `name?` | `string` \| `symbol` | if undefined, the schema title will be used |
638
+ | `optional?` | `boolean` | if true this page can be skipped. The PageResult wil be undefined |
639
+ | `optional_fields?` | `string`[] | a list of fields that should not be required, even if the schema says they're required |
640
+ | `profile?` | `boolean` | if explictly == false, then it's an AO (not a PO), in which case there can only be one schema |
641
+ | `reverify_header?` | `string` | custom text & header that's displayed on reverfication modal for expired PO |
642
+ | `reverify_text?` | `string` | - |
643
+ | `schemas` | `string`[] | - |
644
+ | `selection_hierarchy_json?` | `string` | a URL to a preset for configuing NestedSchemaSelect. @see DeepConfig |
645
+ | `service_provider_link?` | `boolean` | see #463 |
646
+ | `share?` | ``"profile"`` \| ``"verification"`` \| ``"both"`` | the information to share. undefined implies both. |
647
+ | `verify_data?` | `boolean` | if `false`, ProfileObjects created while completing the form will not be verified. `undefined` implies `true` |