@raytio/types 6.0.2 → 7.1.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
@@ -27,11 +31,14 @@ Hovering over the type in VSCode will display documentation and available proper
27
31
  - [FieldVerification](enums/FieldVerification.md)
28
32
  - [POVerification](enums/POVerification.md)
29
33
 
30
- ### Type aliases
34
+ ### Type Aliases
31
35
 
32
36
  - [AA](#aa)
37
+ - [AATag](#aatag)
33
38
  - [AId](#aid)
39
+ - [AnyId](#anyid)
34
40
  - [Colors](#colors)
41
+ - [CommonSchemaAttributes](#commonschemaattributes)
35
42
  - [ConditionallyRequired](#conditionallyrequired)
36
43
  - [CustomFonts](#customfonts)
37
44
  - [DataTypes](#datatypes)
@@ -39,6 +46,7 @@ Hovering over the type in VSCode will display documentation and available proper
39
46
  - [GId](#gid)
40
47
  - [IId](#iid)
41
48
  - [Instance](#instance)
49
+ - [LId](#lid)
42
50
  - [Lookup](#lookup)
43
51
  - [NId](#nid)
44
52
  - [OId](#oid)
@@ -51,8 +59,8 @@ Hovering over the type in VSCode will display documentation and available proper
51
59
  - [Schema](#schema)
52
60
  - [SchemaField](#schemafield)
53
61
  - [SchemaFieldTag](#schemafieldtag)
54
- - [SchemaMetadata](#schemametadata)
55
62
  - [SchemaTag](#schematag)
63
+ - [ServerSchemaField](#serverschemafield)
56
64
  - [SubmissionStatus](#submissionstatus)
57
65
  - [UId](#uid)
58
66
  - [Urn](#urn)
@@ -63,10 +71,13 @@ Hovering over the type in VSCode will display documentation and available proper
63
71
  - [VerificationProvider](#verificationprovider)
64
72
  - [WId](#wid)
65
73
  - [Webhook](#webhook)
74
+ - [WebhookStatus](#webhookstatus)
66
75
  - [WizardConfig](#wizardconfig)
67
76
  - [WizardPage](#wizardpage)
77
+ - [WizardPageTag](#wizardpagetag)
78
+ - [WrappedSchema](#wrappedschema)
68
79
 
69
- ## Type aliases
80
+ ## Type Aliases
70
81
 
71
82
  ### AA
72
83
 
@@ -77,30 +88,42 @@ Hovering over the type in VSCode will display documentation and available proper
77
88
  | Name | Type | Description |
78
89
  | :------ | :------ | :------ |
79
90
  | `a_id` | [`AId`](#aid) | - |
80
- | `aa_help?` | `string` | markdown or string help information including [phoneNumber || email] |
91
+ | `aa_help?` | `string` | markdown or string help information including [phoneNumber \|\| email] |
81
92
  | `aa_introduction?` | `string` | If a user signs up while completing this form, this message will be sent in the sign up email. |
82
93
  | `auth_list_enabled?` | `boolean` | if true, only specific email addresses can submit the form |
83
94
  | `callback_uri?` | `string`[] | - |
84
95
  | `description?` | `string` | - |
85
96
  | `name` | `string` | - |
86
- | `org_id` | [`OId`](#oid) | the id of the associated organisation |
97
+ | `org_id` | [`OId`](#oid) | the id of the associated organization |
87
98
  | `picture?` | [`Urn`](#urn) | - |
88
99
  | `picture_url?` | `string` | Easy to use AA logo url for pasting inot emails |
89
100
  | `ruleset?` | `unknown` | configuration for the submission rules |
90
101
  | `scopes?` | `string`[] | - |
91
102
  | `service_provider_n_id?` | [`NId`](#nid) | the n_id of the associated service provider |
92
- | `tags?` | `string`[] | - |
93
- | `theme?` | `Object` | - |
103
+ | `tags?` | [`AATag`](#aatag)[] | - |
104
+ | `theme?` | { `colors?`: [`Colors`](#colors) ; `font?`: [`CustomFonts`](modules.md#customfonts) } | - |
94
105
  | `theme.colors?` | [`Colors`](#colors) | - |
95
106
  | `theme.font?` | [`CustomFonts`](#customfonts) | - |
96
107
 
97
108
  ___
98
109
 
110
+ ### AATag
111
+
112
+ Ƭ **AATag**: ``"type:client_only"`` \| ``"type:share_with_new_user"`` \| \`related\_service\_provider:n\_id:${NId}\` \| ``"ServiceProvider"``
113
+
114
+ ___
115
+
99
116
  ### AId
100
117
 
101
118
  Ƭ **AId**: `StringWithIdentity`<``"AId"``\>
102
119
 
103
- An `a_id` is the ID of an @see AA
120
+ An `a_id` is the ID of an [AA](#aa)
121
+
122
+ ___
123
+
124
+ ### AnyId
125
+
126
+ Ƭ **AnyId**: [`PId`](#pid) \| [`IId`](modules.md#iid) \| [`NId`](modules.md#nid) \| [`GId`](modules.md#gid) \| [`UId`](modules.md#uid) \| [`AId`](modules.md#aid) \| [`OId`](modules.md#oid) \| [`WId`](modules.md#wid)
104
127
 
105
128
  ___
106
129
 
@@ -121,7 +144,7 @@ ___
121
144
  | `poolblueText` | `string` | - |
122
145
  | `poolblueUi` | `string` | - |
123
146
  | `raytioOrangeHover` | `string` | - |
124
- | `raytioOrangeShade` | `string` | only used by the fancy layout on the login screen |
147
+ | `raytioOrangeShade` | `string` | |
125
148
  | `raytioOrangeText` | `string` | - |
126
149
  | `raytioOrangeUi` | `string` | - |
127
150
  | `sariShade` | `string` | - |
@@ -137,6 +160,41 @@ ___
137
160
 
138
161
  ___
139
162
 
163
+ ### CommonSchemaAttributes
164
+
165
+ Ƭ **CommonSchemaAttributes**: `Object`
166
+
167
+ not exported. Attributes that are identical in both client schema & server schema
168
+
169
+ #### Type declaration
170
+
171
+ | Name | Type | Description |
172
+ | :------ | :------ | :------ |
173
+ | `description` | `string` | - |
174
+ | `display?` | { `expand?`: { `fields`: `string`[] ; `label`: `string` }[] ; `head_main?`: { `fields`: `string`[] ; `format?`: `string` } ; `head_sub?`: { `fields`: `string`[] ; `format?`: `string` } } | - |
175
+ | `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 |
176
+ | `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 |
177
+ | `display.head_main.fields` | `string`[] | - |
178
+ | `display.head_main.format?` | `string` | - |
179
+ | `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 |
180
+ | `display.head_sub.fields` | `string`[] | - |
181
+ | `display.head_sub.format?` | `string` | - |
182
+ | `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_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` } }; } | - |
183
+ | `name` | `string` | these fields will always exist on schema |
184
+ | `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 |
185
+ | `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 |
186
+ | `onboard_properties.profile_objects?` | { `properties`: `Record`<`string`, `unknown`\> ; `schema_name`: `string` }[] | Profile Objects that should be created |
187
+ | `onboard_properties.relationships?` | { `from`: `string` ; `properties?`: `Record`<`string`, `string`\> ; `to`: `string` ; `type`: `string` }[] | Relationships that should be created |
188
+ | `onboard_properties.return_to?` | `string` | The relative path in the client to redirect to once finished. May include variables |
189
+ | `relationships?` | { `anyOf?`: `string`[] ; `direction`: ``"from"`` ; `multiple?`: `boolean` ; `oneOf?`: `string`[] ; `properties?`: { `[fieldName: string]`: [`SchemaField`](#schemafield); } ; `relationship_name`: `string` ; `required?`: `string`[] ; `required_relationship?`: `boolean` ; `type`: `string` }[] | - |
190
+ | `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. |
191
+ | `tags?` | [`SchemaTag`](#schematag)[] | - |
192
+ | `title` | `string` | - |
193
+ | `title_plural?` | `string` | plural version of the title |
194
+ | `type?` | [`DataTypes`](#datatypes) | - |
195
+
196
+ ___
197
+
140
198
  ### ConditionallyRequired
141
199
 
142
200
  Ƭ **ConditionallyRequired**: `Object`
@@ -148,7 +206,7 @@ should be renamed since this applies to ConditionallyVerifiable
148
206
  | Name | Type |
149
207
  | :------ | :------ |
150
208
  | `field` | `string` |
151
- | `if` | `Object` |
209
+ | `if` | { `[fieldName: string]`: (`string` \| `number` \| `boolean`)[]; } |
152
210
 
153
211
  ___
154
212
 
@@ -185,11 +243,11 @@ ___
185
243
 
186
244
  | Name | Type |
187
245
  | :------ | :------ |
188
- | `encrypted_data` | `Object` |
246
+ | `encrypted_data` | { `algorithm`: `AesKeyAlgorithm` ; `data`: `string` ; `iv`: `string` } |
189
247
  | `encrypted_data.algorithm` | `AesKeyAlgorithm` |
190
248
  | `encrypted_data.data` | `string` |
191
249
  | `encrypted_data.iv` | `string` |
192
- | `encrypted_key` | `Object` |
250
+ | `encrypted_key` | { `encrypted_key`: `string` } |
193
251
  | `encrypted_key.encrypted_key` | `string` |
194
252
 
195
253
  ___
@@ -206,7 +264,7 @@ ___
206
264
 
207
265
  Ƭ **IId**: `StringWithIdentity`<``"IId"``\>
208
266
 
209
- An `i_id` is the ID of an @see Instance
267
+ An `i_id` is the ID of an [Instance](#instance)
210
268
 
211
269
  ___
212
270
 
@@ -218,14 +276,14 @@ ___
218
276
 
219
277
  | Name | Type | Description |
220
278
  | :------ | :------ | :------ |
221
- | `_state?` | [`SubmissionStatus`](#submissionstatus) | **`depreacted`** The status of a submission |
279
+ | `_state?` | [`SubmissionStatus`](#submissionstatus) | **`Deprecated`** The status of a submission |
222
280
  | `a_id` | [`AId`](#aid) | ID of the access application this submission was made to |
223
281
  | `aa_name` | `string` | name of the access application this submission was made to |
224
282
  | `confirmation_code` | `string` | Code that validates information has been shared |
225
283
  | `data_provider_email` | `string` | Email of user who shared the data |
226
284
  | `end_date` | `string` | Latest date in which the shared information was available |
227
285
  | `i_id` | [`IId`](#iid) | Access application instance ID |
228
- | `keys` | `Object` | - |
286
+ | `keys` | { `[nId: NId]`: { `[fieldName: string]`: { `data`: `string` ; `n_id`: [`NId`](#nid) }; }; } | - |
229
287
  | `previous_state` | [`SubmissionStatus`](#submissionstatus) | Previous status of the shared information |
230
288
  | `profile_objects` | [`ProfileObject`](#profileobject)[] | data associated is access application's instance |
231
289
  | `reference` | `string` | reference provided by the user who shared the data |
@@ -239,6 +297,14 @@ ___
239
297
 
240
298
  ___
241
299
 
300
+ ### LId
301
+
302
+ Ƭ **LId**: `StringWithIdentity`<``"LId"``\>
303
+
304
+ An `l_id` is the ID of any data stored in the KV-Store
305
+
306
+ ___
307
+
242
308
  ### Lookup
243
309
 
244
310
  Ƭ **Lookup**: `Object`
@@ -260,7 +326,7 @@ ___
260
326
 
261
327
  Ƭ **NId**: `StringWithIdentity`<``"NId"``\>
262
328
 
263
- An `n_id` is the ID of a @see ProfileObject
329
+ An `n_id` is the ID of a [ProfileObject](#profileobject)
264
330
 
265
331
  ___
266
332
 
@@ -268,7 +334,7 @@ ___
268
334
 
269
335
  Ƭ **OId**: `StringWithIdentity`<``"OId"``\>
270
336
 
271
- An `o_id` is the ID of an @see Organization
337
+ An `o_id` is the ID of an [Organization](#organization)
272
338
 
273
339
  ___
274
340
 
@@ -283,7 +349,7 @@ NOTE: this is different to how the schema defines an Organization. **The schema
283
349
 
284
350
  | Name | Type |
285
351
  | :------ | :------ |
286
- | `address` | `Object` |
352
+ | `address` | { `city`: `string` ; `country`: `string` ; `locationType`: `string` ; `region`: `string` ; `street1`: `string` ; `street2`: `string` } |
287
353
  | `address.city` | `string` |
288
354
  | `address.country` | `string` |
289
355
  | `address.locationType` | `string` |
@@ -301,7 +367,7 @@ ___
301
367
 
302
368
  Ƭ **PId**: `StringWithIdentity`<``"PId"``\>
303
369
 
304
- A `p_id` is the ID of a @see Relationship
370
+ A `p_id` is the ID of a [Relationship](#relationship)
305
371
 
306
372
  ___
307
373
 
@@ -329,17 +395,17 @@ ___
329
395
 
330
396
  ### Properties
331
397
 
332
- Ƭ **Properties**: `Object`
398
+ Ƭ **Properties**: `Json`
333
399
 
334
400
  arbitrary key-values pairs stored on a Profile Object.
335
- May contain nested JSON and @see Encrypted properties.
401
+ May contain nested JSON and [Encrypted](#encrypted) properties.
336
402
 
337
403
  There are some limits to field names: they cannot be called
338
404
  `__signature` nor can they include the character sequence `<=>`.
339
405
 
340
- #### Index signature
406
+ **`Deprecated`**
341
407
 
342
- [fieldName: `string`]: `any`
408
+ - use Json
343
409
 
344
410
  ___
345
411
 
@@ -347,7 +413,7 @@ ___
347
413
 
348
414
  Ƭ **RealVer**: `Object`
349
415
 
350
- This is what @raytio/core exposes, which is more useable than @see Verification
416
+ This is what @raytio/core exposes, which is more useable than [Verification](#verification)
351
417
 
352
418
  #### Type declaration
353
419
 
@@ -376,7 +442,7 @@ ___
376
442
  | :------ | :------ |
377
443
  | `end` | [`Urn`](#urn) |
378
444
  | `p_id` | [`PId`](#pid) |
379
- | `properties?` | `Object` |
445
+ | `properties?` | { `[fieldName: string]`: `unknown`; `name?`: `string` ; `p_id`: [`PId`](#pid) } |
380
446
  | `properties.name?` | `string` |
381
447
  | `properties.p_id` | [`PId`](#pid) |
382
448
  | `start` | [`Urn`](#urn) |
@@ -386,51 +452,10 @@ ___
386
452
 
387
453
  ### Schema
388
454
 
389
- Ƭ **Schema**: `Object`
455
+ Ƭ **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` }
390
456
 
391
- Raytio's variant of JSON Schema. All props marked as optional except
392
- `name`. This type can be used for both the schema and for individual fields.
393
-
394
- #### Type declaration
395
-
396
- | Name | Type | Description |
397
- | :------ | :------ | :------ |
398
- | `$id?` | `string` | **`deprecated`** don't use this |
399
- | `$ref?` | `string` | **`deprecated`** not sure why a schema would have this, only fields should |
400
- | `$schema?` | `string` | - |
401
- | `allOf?` | { `$ref?`: `string` ; `if?`: [`Schema`](#schema) ; `then?`: [`Schema`](modules.md#schema) }[] | - |
402
- | `definitions?` | `Record`<`string`, `Object`\> | - |
403
- | `description` | `string` | - |
404
- | `display?` | `Object` | - |
405
- | `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 |
406
- | `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 |
407
- | `display.head_main.fields` | `string`[] | - |
408
- | `display.head_main.format?` | `string` | - |
409
- | `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 |
410
- | `display.head_sub.fields` | `string`[] | - |
411
- | `display.head_sub.format?` | `string` | - |
412
- | `end_date?` | `string` | If this tag exists, the schema is deprecated. ISO Date. |
413
- | `group_title?` | `string` | the localized title of the `schema_group`. added by the client |
414
- | `i18n?` | `Object` | - |
415
- | `n_id?` | [`NId`](#nid) | - |
416
- | `name` | `string` | these fields will always exist on schema |
417
- | `onboard_properties?` | `Object` | only the schema used for the onboarding wizard have this property |
418
- | `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 |
419
- | `onboard_properties.profile_objects?` | { `properties`: `Record`<`string`, `unknown`\> ; `schema_name`: `string` }[] | Profile Objects that should be created |
420
- | `onboard_properties.relationships?` | { `from`: `string` ; `properties?`: `Record`<`string`, `string`\> ; `to`: `string` ; `type`: `string` }[] | Relationships that should be created |
421
- | `onboard_properties.return_to?` | `string` | The relative path in the client to redirect to once finished. May include variables |
422
- | `properties` | `Object` | 🚨 Note that there are cases where properties are undefined, e.g. if the schema is a sub-object |
423
- | `relationships?` | { `anyOf?`: `string`[] ; `direction`: ``"from"`` ; `multiple?`: `boolean` ; `oneOf?`: `string`[] ; `properties?`: { [fieldName: string]: [`SchemaField`](#schemafield); } ; `relationship_name`: `string` ; `required?`: `string`[] ; `required_relationship?`: `boolean` ; `type`: `string` }[] | - |
424
- | `required?` | (`string` \| [`ConditionallyRequired`](#conditionallyrequired))[] | added by client |
425
- | `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. |
426
- | `tags?` | [`SchemaTag`](#schematag)[] | - |
427
- | `title` | `string` | - |
428
- | `title_plural?` | `string` | plural version of the title |
429
- | `type?` | [`DataTypes`](#datatypes) | - |
430
- | `verified_fields?` | (`string` \| [`ConditionallyRequired`](#conditionallyrequired))[] | originally `string[]`, the client modifies this |
431
- | `version?` | `string` | - |
432
- | `version_current?` | `boolean` | whether the `version` is the latest version |
433
- | `wasExpandedByClient?` | `boolean` | - |
457
+ Raytio's variant of JSON Schema, as used by the client. It is a modified version
458
+ of what the API returns.
434
459
 
435
460
  ___
436
461
 
@@ -442,10 +467,10 @@ ___
442
467
 
443
468
  | Name | Type | Description |
444
469
  | :------ | :------ | :------ |
445
- | `$id?` | `string` | **`deprecated`** don't use, it's inconsistent |
470
+ | `$id?` | `string` | **`Deprecated`** don't use, it's inconsistent |
446
471
  | `$ref?` | `string` | If this field refers to a sub-object |
447
472
  | `add_row_btn_label?` | `string` | if this field is a table input, this determines the text to show on the "Add Row" btn |
448
- | `allOf?` | [{ `$ref`: `string` }, [`SchemaField`](#schemafield)] | - |
473
+ | `allOf?` | [{ `$ref`: `string` }, [`ServerSchemaField`](#serverschemafield)] | - |
449
474
  | `content?` | `string` | only checkbox uses this prop |
450
475
  | `contentEncoding?` | ``"base64"`` | - |
451
476
  | `contentMediaType?` | `string` | - |
@@ -454,26 +479,28 @@ ___
454
479
  | `description?` | `string` | - |
455
480
  | `description_decorator?` | ``"md"`` | specifies that the description is formatted in markdown |
456
481
  | `encrypt?` | `boolean` | whether the field should be encrypted |
457
- | `enum?` | `string`[] | - |
482
+ | `encrypt_require?` | `boolean` | if true, the user must have encryption enabled to save this data, see #1324 |
483
+ | `enum?` | (`string` \| `number` \| `boolean`)[] | - |
458
484
  | `examples?` | `unknown`[] | - |
459
485
  | `format?` | ``"date"`` \| ``"date-time"`` \| ``"uri"`` | - |
460
486
  | `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 |
461
- | `items?` | `Object` | `items` is used for nested arrays, (while `properties` is used for nested objects) |
462
- | `items.properties` | `Object` | - |
487
+ | `items?` | { `properties`: { `[subFieldName: string]`: [`SchemaField`](#schemafield); } ; `type`: [`DataTypes`](modules.md#datatypes) } | `items` is used for nested arrays, (while `properties` is used for nested objects) |
488
+ | `items.properties` | { `[subFieldName: string]`: [`SchemaField`](#schemafield); } | - |
463
489
  | `items.type` | [`DataTypes`](#datatypes) | - |
464
490
  | `lookup?` | `string` | URL to a JSON file in the `Lookup` format |
465
- | `maxLength?` | `number` | **`deprecated`** raytio's usage not documented |
466
- | `maximum?` | `number` | - |
467
- | `minLength?` | `number` | **`deprecated`** raytio's usage not documented |
468
- | `minimum?` | `number` | - |
469
- | `override?` | `Object` | - |
470
- | `override.permissions` | `Object` | - |
491
+ | `maxLength?` | `number` | **`Deprecated`** raytio's usage not documented |
492
+ | `maximum?` | `number` | for number inputs, the maximum allowed value |
493
+ | `minLength?` | `number` | **`Deprecated`** raytio's usage not documented |
494
+ | `minimum?` | `number` | for number inputs, the minimum allowed value |
495
+ | `override?` | { `permissions`: { `default`: `string` } } | - |
496
+ | `override.permissions` | { `default`: `string` } | - |
471
497
  | `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. |
472
498
  | `pattern?` | `string` | - |
473
499
  | `patternMessage?` | `string` | if a `pattern` is specified, this is the error message |
474
500
  | `priority?` | `number` | - |
475
- | `properties?` | `Object` | `properties` is used for nested objects, (while `items` is used for nested arrays) |
501
+ | `properties?` | { `[subFieldName: string]`: [`SchemaField`](#schemafield); } | `properties` is used for nested objects, (while `items` is used for nested arrays) |
476
502
  | `readOnly?` | `boolean` | readOnly means the Wizard won't show this field |
503
+ | `step?` | `number` | for number inputs, the step size used in the input or slider |
477
504
  | `table_empty_message?` | `string` | if this field is a table input, this determines the text to show if the table is empty |
478
505
  | `tags?` | [`SchemaFieldTag`](#schemafieldtag)[] | - |
479
506
  | `title?` | `string` | - |
@@ -484,21 +511,21 @@ ___
484
511
 
485
512
  ### SchemaFieldTag
486
513
 
487
- Ƭ **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}\` \| ``"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"``
514
+ Ƭ **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"`` \| ``"verify:show_if_pending"`` \| ``"special:hide_select_behind_button"`` \| ``"type:capture_geolocation"`` \| ``"type:extract_required"``
488
515
 
489
516
  ___
490
517
 
491
- ### SchemaMetadata
492
-
493
- Ƭ **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` }
518
+ ### SchemaTag
494
519
 
495
- Only certain properties from the schema
520
+ Ƭ **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"``
496
521
 
497
522
  ___
498
523
 
499
- ### SchemaTag
524
+ ### ServerSchemaField
525
+
526
+ Ƭ **ServerSchemaField**: `Omit`<[`SchemaField`](#schemafield), ``"$prop"``\>
500
527
 
501
- Ƭ **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"``
528
+ the only difference between the client & server's definition is that the client adds `$prop`
502
529
 
503
530
  ___
504
531
 
@@ -518,7 +545,7 @@ ___
518
545
 
519
546
  ### Urn
520
547
 
521
- Ƭ **Urn**: \`urn:${UrnNodeType}:${string}\`
548
+ Ƭ **Urn**: \`urn:${UrnNodeType}:${AnyId}\`
522
549
 
523
550
  e.g. "urn:user:..."
524
551
 
@@ -526,7 +553,7 @@ ___
526
553
 
527
554
  ### UrnNodeType
528
555
 
529
- Ƭ **UrnNodeType**: ``"user"`` \| ``"profile_object"`` \| ``"instance"`` \| ``"temp_object"`` \| ``"document"``
556
+ Ƭ **UrnNodeType**: ``"user"`` \| ``"profile_object"`` \| ``"instance"`` \| ``"schema"`` \| ``"temp_object"`` \| ``"document"``
530
557
 
531
558
  ___
532
559
 
@@ -540,7 +567,7 @@ validation data returned by preVerify (part of the extract&map API)
540
567
 
541
568
  | Name | Type |
542
569
  | :------ | :------ |
543
- | `breakdown` | `Object` |
570
+ | `breakdown` | { `[category: string]`: { `code?`: `number` ; `passed`: `boolean` ; `reason?`: `string` ; `severity?`: ``"low"`` \| ``"medium"`` \| ``"high"`` }; } |
544
571
  | `score` | `number` |
545
572
  | `warning?` | `string`[] |
546
573
 
@@ -548,7 +575,7 @@ ___
548
575
 
549
576
  ### Verification
550
577
 
551
- Ƭ **Verification**<`WithValue`\>: [`ProfileObject`](#profileobject)<`Object`\>
578
+ Ƭ **Verification**<`WithValue`\>: [`ProfileObject`](#profileobject)<{ `field`: `string` ; `n_id`: [`NId`](modules.md#nid) ; `valid_until?`: `string` ; `verifications`: [{ `data`: [`VerificationPayload`](modules.md#verificationpayload)<`WithValue`\> ; `signature`: `string` }] }\>
552
579
 
553
580
  Different APIs inconsistently include the `value` prop. If you know it exists,
554
581
  use `Verification<true>`, otherwise just `Verification`. Verifications from
@@ -558,13 +585,13 @@ the DataContext don't have the value.
558
585
 
559
586
  | Name | Type |
560
587
  | :------ | :------ |
561
- | `WithValue` | extends `boolean```false`` |
588
+ | `WithValue` | extends `boolean` = ``false`` |
562
589
 
563
590
  ___
564
591
 
565
592
  ### VerificationPayload
566
593
 
567
- Ƭ **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` } : {}
594
+ Ƭ **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` ; `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` } : {}
568
595
 
569
596
  #### Type parameters
570
597
 
@@ -595,7 +622,7 @@ ___
595
622
 
596
623
  Ƭ **WId**: `StringWithIdentity`<``"WId"``\>
597
624
 
598
- A `wi_id` is the ID of a @see Webhook
625
+ A `wi_id` is the ID of a [Webhook](#webhook)
599
626
 
600
627
  ___
601
628
 
@@ -609,26 +636,37 @@ ___
609
636
  | :------ | :------ | :------ |
610
637
  | `date_created` | `string` | ISO Date |
611
638
  | `date_updated` | `string` | ISO Date |
639
+ | `provider_signature_check_enabled` | `boolean` | - |
640
+ | `provider_signature_credentials` | `unknown` | - |
612
641
  | `provider_subscription_credentials` | `unknown` | - |
613
642
  | `provider_webhook_id` | [`NId`](#nid) | n_id of "the webhook provider which can be set up against a service provider" |
614
- | `status` | `unknown` | - |
643
+ | `provider_webhook_subscription_id` | [`NId`](#nid) | not sure what this is |
644
+ | `status` | [`WebhookStatus`](#webhookstatus) | - |
645
+ | `subscribe_log?` | { `date`: `string` ; `response_payload`: `Json` ; `response_status_code`: `number` }[] | - |
615
646
  | `webhook_action` | { `webhook_action_type`: `string` }[] | - |
616
- | `webhook_field_mapping_schema` | `Object` | - |
617
- | `webhook_filter_schema` | `Object` | - |
647
+ | `webhook_field_mapping_schema` | { `[key: string]`: `string`; } | - |
648
+ | `webhook_filter_schema` | { `field_name`: `string` ; `field_value`: `string` ; `operator`: `string` } | - |
618
649
  | `webhook_filter_schema.field_name` | `string` | - |
619
650
  | `webhook_filter_schema.field_value` | `string` | - |
620
651
  | `webhook_filter_schema.operator` | `string` | - |
621
652
  | `webhook_filter_source` | `string` | - |
653
+ | `webhook_processing_rules` | `unknown` | - |
622
654
  | `wi_id` | [`WId`](#wid) | - |
623
655
 
624
656
  ___
625
657
 
658
+ ### WebhookStatus
659
+
660
+ Ƭ **WebhookStatus**: ``"subscribed"`` \| ``"pending"`` \| ``"unsubscribe_failed"``
661
+
662
+ ___
663
+
626
664
  ### WizardConfig
627
665
 
628
666
  Ƭ **WizardConfig**: `Object`
629
667
 
630
668
  when a form link is generated, this is what gets saved on the API.
631
- Each value can be overriden in the query parameters. If specified
669
+ Each value can be overridden in the query parameters. If specified
632
670
  in the query parameters, it needs to be base64 and/or url encoded.
633
671
 
634
672
  #### Type declaration
@@ -646,7 +684,7 @@ in the query parameters, it needs to be base64 and/or url encoded.
646
684
  | `review_text?` | `string` | the text on the WizardReview page |
647
685
  | `sharing_data_message?` | `string` | the loading message to show next to the spinner after the review screen |
648
686
  | `signature_schema?` | `string` | if specified, a Wizard will be shown on the review page with this schema |
649
- | `skip_share?` | `boolean` | **`deprecated`** added in !244 but never used |
687
+ | `skip_share?` | `boolean` | **`Deprecated`** added in !244 but never used |
650
688
  | `submit_text?` | `string` | the submit button label |
651
689
  | `terms_schema?` | `string` | if specified, a Wizard will be shown on the review page with this schema |
652
690
  | `update_reference?` | `boolean` | whether the user can change the reference, if there is one in the QP |
@@ -657,13 +695,14 @@ ___
657
695
 
658
696
  Ƭ **WizardPage**: `Object`
659
697
 
660
- configuration data for a single wizard page (@see WizardConfig)
698
+ configuration data for a single wizard page ([WizardConfig](#wizardconfig))
661
699
 
662
700
  #### Type declaration
663
701
 
664
702
  | Name | Type | Description |
665
703
  | :------ | :------ | :------ |
666
704
  | `allow_upload?` | `boolean` | do not allow uploading in ImageDynamicSection if this is explictly false |
705
+ | `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. |
667
706
  | `create_new_text?` | `string` | custom text to display on the Create New button |
668
707
  | `description?` | `string` | the fallback description, if there isn't one for the specific situation |
669
708
  | `description_create?` | `string` | - |
@@ -687,7 +726,35 @@ configuration data for a single wizard page (@see WizardConfig)
687
726
  | `reverify_header?` | `string` | custom text & header that's displayed on reverfication modal for expired PO |
688
727
  | `reverify_text?` | `string` | - |
689
728
  | `schemas` | `string`[] | - |
690
- | `selection_hierarchy_json?` | `string` | a URL to a preset for configuing NestedSchemaSelect. @see DeepConfig |
729
+ | `selection_hierarchy_json?` | `string` | a URL to a preset for configuing NestedSchemaSelect. DeepConfig |
691
730
  | `service_provider_link?` | `boolean` | see #463 |
692
731
  | `share?` | ``"profile"`` \| ``"verification"`` \| ``"both"`` | the information to share. undefined implies both. |
693
- | `verify_data?` | `boolean` | if `false`, ProfileObjects created while completing the form will not be verified. `undefined` implies `true` |
732
+ | `tags?` | [`WizardPageTag`](#wizardpagetag)[] | - |
733
+ | `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 ``` |
734
+
735
+ ___
736
+
737
+ ### WizardPageTag
738
+
739
+ Ƭ **WizardPageTag**: ``"action:require_chip"``
740
+
741
+ ___
742
+
743
+ ### WrappedSchema
744
+
745
+ Ƭ **WrappedSchema**: `Object`
746
+
747
+ This is what's returned by the API
748
+
749
+ #### Type declaration
750
+
751
+ | Name | Type | Description |
752
+ | :------ | :------ | :------ |
753
+ | `active` | ``true`` | - |
754
+ | `end_date` | `string` | ISO Date. If this tag exists, the schema is deprecated. |
755
+ | `name` | `string` | - |
756
+ | `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`[] } | - |
757
+ | `start_date` | `string` | ISO Date |
758
+ | `type` | ``"ss"`` \| ``"ps"`` \| ``"us"`` | - |
759
+ | `version` | `string` | - |
760
+ | `version_current` | `boolean` | whether the `version` is the latest version |
package/dist/crypto.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export declare type Encrypted<_Data = string> = {
1
+ export type Encrypted<_Data = string> = {
2
2
  encrypted_key: {
3
3
  encrypted_key: string;
4
4
  };
package/dist/crypto.js CHANGED
@@ -1,2 +1,2 @@
1
1
  "use strict";
2
- exports.__esModule = true;
2
+ Object.defineProperty(exports, "__esModule", { value: true });
package/dist/index.js CHANGED
@@ -13,7 +13,7 @@ var __createBinding = (this && this.__createBinding) || (Object.create ? (functi
13
13
  var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
- exports.__esModule = true;
16
+ Object.defineProperty(exports, "__esModule", { value: true });
17
17
  __exportStar(require("./crypto"), exports);
18
18
  __exportStar(require("./raytio"), exports);
19
19
  __exportStar(require("./schema"), exports);