@twin.org/core 0.0.1-next.9 → 0.0.2-next.10

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.
Files changed (85) hide show
  1. package/dist/cjs/index.cjs +2266 -1470
  2. package/dist/esm/index.mjs +2263 -1471
  3. package/dist/types/errors/alreadyExistsError.d.ts +2 -2
  4. package/dist/types/errors/baseError.d.ts +25 -5
  5. package/dist/types/errors/conflictError.d.ts +2 -2
  6. package/dist/types/errors/generalError.d.ts +2 -2
  7. package/dist/types/errors/notFoundError.d.ts +2 -2
  8. package/dist/types/errors/notSupportedError.d.ts +2 -2
  9. package/dist/types/errors/unauthorizedError.d.ts +2 -2
  10. package/dist/types/errors/unprocessableError.d.ts +2 -2
  11. package/dist/types/factories/factory.d.ts +21 -2
  12. package/dist/types/helpers/arrayHelper.d.ts +13 -0
  13. package/dist/types/helpers/envHelper.d.ts +16 -0
  14. package/dist/types/helpers/errorHelper.d.ts +5 -4
  15. package/dist/types/helpers/jsonHelper.d.ts +30 -0
  16. package/dist/types/helpers/objectHelper.d.ts +25 -0
  17. package/dist/types/helpers/uint8ArrayHelper.d.ts +11 -0
  18. package/dist/types/index.d.ts +6 -0
  19. package/dist/types/models/IComponent.d.ts +6 -6
  20. package/dist/types/models/IError.d.ts +2 -2
  21. package/dist/types/models/II18nShared.d.ts +29 -0
  22. package/dist/types/models/coerceType.d.ts +49 -0
  23. package/dist/types/models/compressionType.d.ts +1 -1
  24. package/dist/types/models/objectOrArray.d.ts +4 -0
  25. package/dist/types/utils/asyncCache.d.ts +10 -1
  26. package/dist/types/utils/coerce.d.ts +22 -0
  27. package/dist/types/utils/guards.d.ts +35 -0
  28. package/dist/types/utils/is.d.ts +18 -0
  29. package/dist/types/utils/sharedStore.d.ts +23 -0
  30. package/dist/types/utils/validation.d.ts +2 -0
  31. package/docs/changelog.md +442 -1
  32. package/docs/reference/classes/AlreadyExistsError.md +166 -32
  33. package/docs/reference/classes/ArrayHelper.md +71 -5
  34. package/docs/reference/classes/AsyncCache.md +75 -13
  35. package/docs/reference/classes/Base32.md +9 -5
  36. package/docs/reference/classes/Base58.md +9 -5
  37. package/docs/reference/classes/Base64.md +12 -6
  38. package/docs/reference/classes/Base64Url.md +9 -5
  39. package/docs/reference/classes/BaseError.md +160 -34
  40. package/docs/reference/classes/BitString.md +23 -11
  41. package/docs/reference/classes/Coerce.md +110 -12
  42. package/docs/reference/classes/Compression.md +19 -11
  43. package/docs/reference/classes/ConflictError.md +169 -33
  44. package/docs/reference/classes/Converter.md +72 -28
  45. package/docs/reference/classes/EnvHelper.md +45 -0
  46. package/docs/reference/classes/ErrorHelper.md +22 -10
  47. package/docs/reference/classes/Factory.md +96 -18
  48. package/docs/reference/classes/FilenameHelper.md +6 -4
  49. package/docs/reference/classes/GeneralError.md +164 -32
  50. package/docs/reference/classes/GuardError.md +168 -32
  51. package/docs/reference/classes/Guards.md +398 -80
  52. package/docs/reference/classes/HexHelper.md +18 -8
  53. package/docs/reference/classes/I18n.md +46 -20
  54. package/docs/reference/classes/Is.md +207 -51
  55. package/docs/reference/classes/JsonHelper.md +146 -10
  56. package/docs/reference/classes/NotFoundError.md +166 -32
  57. package/docs/reference/classes/NotImplementedError.md +159 -29
  58. package/docs/reference/classes/NotSupportedError.md +163 -31
  59. package/docs/reference/classes/ObjectHelper.md +197 -39
  60. package/docs/reference/classes/RandomHelper.md +6 -4
  61. package/docs/reference/classes/SharedStore.md +94 -0
  62. package/docs/reference/classes/StringHelper.md +54 -20
  63. package/docs/reference/classes/Uint8ArrayHelper.md +35 -0
  64. package/docs/reference/classes/UnauthorizedError.md +163 -31
  65. package/docs/reference/classes/UnprocessableError.md +164 -32
  66. package/docs/reference/classes/Url.md +37 -17
  67. package/docs/reference/classes/Urn.md +63 -27
  68. package/docs/reference/classes/Validation.md +349 -135
  69. package/docs/reference/classes/ValidationError.md +162 -30
  70. package/docs/reference/index.md +7 -0
  71. package/docs/reference/interfaces/IComponent.md +21 -11
  72. package/docs/reference/interfaces/IError.md +4 -4
  73. package/docs/reference/interfaces/II18nShared.md +47 -0
  74. package/docs/reference/interfaces/IKeyValue.md +3 -1
  75. package/docs/reference/interfaces/ILabelledValue.md +3 -1
  76. package/docs/reference/interfaces/ILocaleDictionary.md +1 -1
  77. package/docs/reference/interfaces/IPatchOperation.md +1 -1
  78. package/docs/reference/interfaces/IValidationFailure.md +1 -1
  79. package/docs/reference/type-aliases/CoerceType.md +5 -0
  80. package/docs/reference/type-aliases/CompressionType.md +1 -1
  81. package/docs/reference/type-aliases/ObjectOrArray.md +11 -0
  82. package/docs/reference/variables/CoerceType.md +67 -0
  83. package/docs/reference/variables/CompressionType.md +2 -2
  84. package/locales/en.json +14 -1
  85. package/package.json +7 -7
@@ -5,13 +5,13 @@ Sourced from https://github.com/beatgammit/base64-js.
5
5
 
6
6
  ## Constructors
7
7
 
8
- ### new Base64()
8
+ ### Constructor
9
9
 
10
- > **new Base64**(): [`Base64`](Base64.md)
10
+ > **new Base64**(): `Base64`
11
11
 
12
12
  #### Returns
13
13
 
14
- [`Base64`](Base64.md)
14
+ `Base64`
15
15
 
16
16
  ## Methods
17
17
 
@@ -23,7 +23,9 @@ Get the byte length of the data.
23
23
 
24
24
  #### Parameters
25
25
 
26
- **base64**: `string`
26
+ ##### base64
27
+
28
+ `string`
27
29
 
28
30
  The base64 string.
29
31
 
@@ -43,7 +45,9 @@ Convert the base 64 string to a byte array.
43
45
 
44
46
  #### Parameters
45
47
 
46
- **base64**: `string`
48
+ ##### base64
49
+
50
+ `string`
47
51
 
48
52
  The base64 string to convert.
49
53
 
@@ -63,7 +67,9 @@ Convert a byte array to base 64.
63
67
 
64
68
  #### Parameters
65
69
 
66
- **bytes**: `Uint8Array`
70
+ ##### bytes
71
+
72
+ `Uint8Array`
67
73
 
68
74
  The byte array to convert.
69
75
 
@@ -5,13 +5,13 @@ https://www.rfc-editor.org/rfc/rfc4648#section-5.
5
5
 
6
6
  ## Constructors
7
7
 
8
- ### new Base64Url()
8
+ ### Constructor
9
9
 
10
- > **new Base64Url**(): [`Base64Url`](Base64Url.md)
10
+ > **new Base64Url**(): `Base64Url`
11
11
 
12
12
  #### Returns
13
13
 
14
- [`Base64Url`](Base64Url.md)
14
+ `Base64Url`
15
15
 
16
16
  ## Methods
17
17
 
@@ -23,7 +23,9 @@ Convert the base 64 string to a byte array.
23
23
 
24
24
  #### Parameters
25
25
 
26
- **base64Url**: `string`
26
+ ##### base64Url
27
+
28
+ `string`
27
29
 
28
30
  The base64 url string to convert.
29
31
 
@@ -43,7 +45,9 @@ Convert a byte array to base 64 url.
43
45
 
44
46
  #### Parameters
45
47
 
46
- **bytes**: `Uint8Array`
48
+ ##### bytes
49
+
50
+ `Uint8Array`
47
51
 
48
52
  The byte array to convert.
49
53
 
@@ -25,37 +25,45 @@ Class to handle errors.
25
25
 
26
26
  ## Constructors
27
27
 
28
- ### new BaseError()
28
+ ### Constructor
29
29
 
30
- > **new BaseError**(`name`, `source`, `message`, `properties`?, `inner`?): [`BaseError`](BaseError.md)
30
+ > **new BaseError**(`name`, `source`, `message`, `properties?`, `cause?`): `BaseError`
31
31
 
32
32
  Create a new instance of BaseError.
33
33
 
34
34
  #### Parameters
35
35
 
36
- **name**: `string`
36
+ ##### name
37
+
38
+ `string`
37
39
 
38
40
  The name of the error.
39
41
 
40
- **source**: `string`
42
+ ##### source
43
+
44
+ `string`
41
45
 
42
46
  The source of the error.
43
47
 
44
- **message**: `string`
48
+ ##### message
49
+
50
+ `string`
45
51
 
46
52
  The message as a code.
47
53
 
48
- **properties?**
54
+ ##### properties?
49
55
 
50
56
  Any additional information for the error.
51
57
 
52
- **inner?**: `unknown`
58
+ ##### cause?
53
59
 
54
- The inner error if we have wrapped another error.
60
+ `unknown`
61
+
62
+ The cause of error if we have wrapped another error.
55
63
 
56
64
  #### Returns
57
65
 
58
- [`BaseError`](BaseError.md)
66
+ `BaseError`
59
67
 
60
68
  #### Overrides
61
69
 
@@ -83,7 +91,7 @@ Any additional information for the error.
83
91
 
84
92
  #### Index Signature
85
93
 
86
- \[`id`: `string`\]: `unknown`
94
+ \[`id`: `string`\]: `unknown`
87
95
 
88
96
  #### Implementation of
89
97
 
@@ -91,33 +99,39 @@ Any additional information for the error.
91
99
 
92
100
  ***
93
101
 
94
- ### inner?
102
+ ### cause?
95
103
 
96
- > `optional` **inner**: [`IError`](../interfaces/IError.md)
104
+ > `optional` **cause**: [`IError`](../interfaces/IError.md)
97
105
 
98
- The inner error if there was one.
106
+ The cause of the error.
99
107
 
100
108
  #### Implementation of
101
109
 
102
- [`IError`](../interfaces/IError.md).[`inner`](../interfaces/IError.md#inner)
110
+ [`IError`](../interfaces/IError.md).[`cause`](../interfaces/IError.md#cause)
111
+
112
+ #### Overrides
113
+
114
+ `Error.cause`
103
115
 
104
116
  ## Methods
105
117
 
106
118
  ### fromError()
107
119
 
108
- > `static` **fromError**(`err`): [`BaseError`](BaseError.md)
120
+ > `static` **fromError**(`err`): `BaseError`
109
121
 
110
122
  Construct an error from an existing one.
111
123
 
112
124
  #### Parameters
113
125
 
114
- **err**: `unknown`
126
+ ##### err
127
+
128
+ `unknown`
115
129
 
116
130
  The existing error.
117
131
 
118
132
  #### Returns
119
133
 
120
- [`BaseError`](BaseError.md)
134
+ `BaseError`
121
135
 
122
136
  The new instance.
123
137
 
@@ -131,7 +145,9 @@ Flatten an error tree.
131
145
 
132
146
  #### Parameters
133
147
 
134
- **err**: `unknown`
148
+ ##### err
149
+
150
+ `unknown`
135
151
 
136
152
  The starting error.
137
153
 
@@ -151,10 +167,12 @@ Expand an error tree.
151
167
 
152
168
  #### Parameters
153
169
 
154
- **errors**: `undefined` \| [`IError`](../interfaces/IError.md)[]
170
+ ##### errors
155
171
 
156
172
  The list of errors to expand.
157
173
 
174
+ `undefined` | [`IError`](../interfaces/IError.md)[]
175
+
158
176
  #### Returns
159
177
 
160
178
  `undefined` \| [`IError`](../interfaces/IError.md)
@@ -171,14 +189,18 @@ Test to see if the error has the specified error name.
171
189
 
172
190
  #### Parameters
173
191
 
174
- **error**: `unknown`
192
+ ##### error
193
+
194
+ `unknown`
175
195
 
176
196
  The error to test.
177
197
 
178
- **name**: `string` \| `RegExp`
198
+ ##### name
179
199
 
180
200
  The name to check for.
181
201
 
202
+ `string` | `RegExp`
203
+
182
204
  #### Returns
183
205
 
184
206
  `error is BaseError`
@@ -195,14 +217,18 @@ Test to see if the error has the specified error message.
195
217
 
196
218
  #### Parameters
197
219
 
198
- **error**: `unknown`
220
+ ##### error
221
+
222
+ `unknown`
199
223
 
200
224
  The error to test.
201
225
 
202
- **message**: `string` \| `RegExp`
226
+ ##### message
203
227
 
204
228
  The message to check for.
205
229
 
230
+ `string` | `RegExp`
231
+
206
232
  #### Returns
207
233
 
208
234
  `error is BaseError`
@@ -219,14 +245,18 @@ Test to see if the error has the specified error code.
219
245
 
220
246
  #### Parameters
221
247
 
222
- **error**: `unknown`
248
+ ##### error
249
+
250
+ `unknown`
223
251
 
224
252
  The error to test.
225
253
 
226
- **code**: `string` \| `RegExp`
254
+ ##### code
227
255
 
228
256
  The code to check for.
229
257
 
258
+ `string` | `RegExp`
259
+
230
260
  #### Returns
231
261
 
232
262
  `boolean`
@@ -243,14 +273,18 @@ Test to see if any of the errors or children have the given error name.
243
273
 
244
274
  #### Parameters
245
275
 
246
- **error**: `unknown`
276
+ ##### error
277
+
278
+ `unknown`
247
279
 
248
280
  The error to test.
249
281
 
250
- **name**: `string` \| `RegExp`
282
+ ##### name
251
283
 
252
284
  The name to check for.
253
285
 
286
+ `string` | `RegExp`
287
+
254
288
  #### Returns
255
289
 
256
290
  `error is BaseError`
@@ -267,14 +301,18 @@ Test to see if any of the errors or children have the given error message.
267
301
 
268
302
  #### Parameters
269
303
 
270
- **error**: `unknown`
304
+ ##### error
305
+
306
+ `unknown`
271
307
 
272
308
  The error to test.
273
309
 
274
- **message**: `string` \| `RegExp`
310
+ ##### message
275
311
 
276
312
  The message to check for.
277
313
 
314
+ `string` | `RegExp`
315
+
278
316
  #### Returns
279
317
 
280
318
  `error is BaseError`
@@ -291,11 +329,15 @@ Test to see if any of the errors or children are from a specific class.
291
329
 
292
330
  #### Parameters
293
331
 
294
- **error**: `unknown`
332
+ ##### error
333
+
334
+ `unknown`
295
335
 
296
336
  The error to test.
297
337
 
298
- **cls**: `string`
338
+ ##### cls
339
+
340
+ `string`
299
341
 
300
342
  The class to check for.
301
343
 
@@ -315,14 +357,18 @@ Test to see if any of the errors or children have the given error code.
315
357
 
316
358
  #### Parameters
317
359
 
318
- **error**: `unknown`
360
+ ##### error
361
+
362
+ `unknown`
319
363
 
320
364
  The error to test.
321
365
 
322
- **code**: `string` \| `RegExp`
366
+ ##### code
323
367
 
324
368
  The code to check for.
325
369
 
370
+ `string` | `RegExp`
371
+
326
372
  #### Returns
327
373
 
328
374
  `error is BaseError`
@@ -331,12 +377,92 @@ True if the error has the name.
331
377
 
332
378
  ***
333
379
 
380
+ ### isEmpty()
381
+
382
+ > `static` **isEmpty**(`err`): `boolean`
383
+
384
+ Is the error empty, i.e. does it have no message, source, properties, or cause?
385
+
386
+ #### Parameters
387
+
388
+ ##### err
389
+
390
+ [`IError`](../interfaces/IError.md)
391
+
392
+ The error to check for being empty.
393
+
394
+ #### Returns
395
+
396
+ `boolean`
397
+
398
+ True if the error is empty.
399
+
400
+ ***
401
+
402
+ ### isAggregateError()
403
+
404
+ > `static` **isAggregateError**(`err`): `err is AggregateError`
405
+
406
+ Is the error an aggregate error.
407
+
408
+ #### Parameters
409
+
410
+ ##### err
411
+
412
+ `unknown`
413
+
414
+ The error to check for being an aggregate error.
415
+
416
+ #### Returns
417
+
418
+ `err is AggregateError`
419
+
420
+ True if the error is an aggregate error.
421
+
422
+ ***
423
+
424
+ ### fromAggregate()
425
+
426
+ > `static` **fromAggregate**(`err`, `includeStackTrace?`): [`IError`](../interfaces/IError.md)[]
427
+
428
+ Convert the aggregate error to an array of errors.
429
+
430
+ #### Parameters
431
+
432
+ ##### err
433
+
434
+ `unknown`
435
+
436
+ The error to convert.
437
+
438
+ ##### includeStackTrace?
439
+
440
+ `boolean`
441
+
442
+ Whether to include the error stack in the model, defaults to false.
443
+
444
+ #### Returns
445
+
446
+ [`IError`](../interfaces/IError.md)[]
447
+
448
+ The array of errors.
449
+
450
+ ***
451
+
334
452
  ### toJsonObject()
335
453
 
336
- > **toJsonObject**(): [`IError`](../interfaces/IError.md)
454
+ > **toJsonObject**(`includeStackTrace?`): [`IError`](../interfaces/IError.md)
337
455
 
338
456
  Serialize the error to the error model.
339
457
 
458
+ #### Parameters
459
+
460
+ ##### includeStackTrace?
461
+
462
+ `boolean`
463
+
464
+ Whether to include the error stack in the model, defaults to false.
465
+
340
466
  #### Returns
341
467
 
342
468
  [`IError`](../interfaces/IError.md)
@@ -4,43 +4,49 @@ A class to represent a bit string.
4
4
 
5
5
  ## Constructors
6
6
 
7
- ### new BitString()
7
+ ### Constructor
8
8
 
9
- > **new BitString**(`numberBits`): [`BitString`](BitString.md)
9
+ > **new BitString**(`numberBits`): `BitString`
10
10
 
11
11
  Create a new instance of BitString.
12
12
 
13
13
  #### Parameters
14
14
 
15
- **numberBits**: `number`
15
+ ##### numberBits
16
+
17
+ `number`
16
18
 
17
19
  The length of the bit string.
18
20
 
19
21
  #### Returns
20
22
 
21
- [`BitString`](BitString.md)
23
+ `BitString`
22
24
 
23
25
  ## Methods
24
26
 
25
27
  ### fromBits()
26
28
 
27
- > `static` **fromBits**(`bits`, `numberBits`): [`BitString`](BitString.md)
29
+ > `static` **fromBits**(`bits`, `numberBits`): `BitString`
28
30
 
29
31
  Create a new instance of BitString from a bit array.
30
32
 
31
33
  #### Parameters
32
34
 
33
- **bits**: `Uint8Array`
35
+ ##### bits
36
+
37
+ `Uint8Array`
34
38
 
35
39
  The bits to create the bit string from.
36
40
 
37
- **numberBits**: `number`
41
+ ##### numberBits
42
+
43
+ `number`
38
44
 
39
45
  The number of bits in the bit string.
40
46
 
41
47
  #### Returns
42
48
 
43
- [`BitString`](BitString.md)
49
+ `BitString`
44
50
 
45
51
  The new instance of BitString.
46
52
 
@@ -54,7 +60,9 @@ Get the bit at the given index.
54
60
 
55
61
  #### Parameters
56
62
 
57
- **index**: `number`
63
+ ##### index
64
+
65
+ `number`
58
66
 
59
67
  The index to get the bit for.
60
68
 
@@ -78,11 +86,15 @@ Set the bit at the given index.
78
86
 
79
87
  #### Parameters
80
88
 
81
- **index**: `number`
89
+ ##### index
90
+
91
+ `number`
82
92
 
83
93
  The index to set the bit for.
84
94
 
85
- **value**: `boolean`
95
+ ##### value
96
+
97
+ `boolean`
86
98
 
87
99
  The value to set the bit to.
88
100