@twin.org/core 0.0.1-next.6 → 0.0.1-next.60
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/dist/cjs/index.cjs +1672 -787
- package/dist/esm/index.mjs +1668 -788
- package/dist/types/encoding/base58.d.ts +18 -0
- package/dist/types/errors/baseError.d.ts +2 -1
- package/dist/types/factories/factory.d.ts +20 -1
- package/dist/types/helpers/arrayHelper.d.ts +13 -0
- package/dist/types/helpers/envHelper.d.ts +16 -0
- package/dist/types/helpers/errorHelper.d.ts +2 -1
- package/dist/types/helpers/jsonHelper.d.ts +30 -0
- package/dist/types/helpers/objectHelper.d.ts +33 -0
- package/dist/types/helpers/uint8ArrayHelper.d.ts +11 -0
- package/dist/types/index.d.ts +7 -0
- package/dist/types/models/IComponent.d.ts +12 -3
- package/dist/types/models/II18nShared.d.ts +29 -0
- package/dist/types/models/coerceType.d.ts +49 -0
- package/dist/types/models/compressionType.d.ts +1 -1
- package/dist/types/models/objectOrArray.d.ts +4 -0
- package/dist/types/utils/asyncCache.d.ts +10 -1
- package/dist/types/utils/coerce.d.ts +22 -0
- package/dist/types/utils/converter.d.ts +12 -0
- package/dist/types/utils/guards.d.ts +35 -0
- package/dist/types/utils/is.d.ts +12 -0
- package/dist/types/utils/sharedStore.d.ts +23 -0
- package/dist/types/utils/validation.d.ts +2 -0
- package/docs/changelog.md +79 -1
- package/docs/reference/classes/AlreadyExistsError.md +77 -27
- package/docs/reference/classes/ArrayHelper.md +79 -5
- package/docs/reference/classes/AsyncCache.md +75 -13
- package/docs/reference/classes/Base32.md +9 -5
- package/docs/reference/classes/Base58.md +61 -0
- package/docs/reference/classes/Base64.md +12 -6
- package/docs/reference/classes/Base64Url.md +9 -5
- package/docs/reference/classes/BaseError.md +79 -29
- package/docs/reference/classes/BitString.md +23 -11
- package/docs/reference/classes/Coerce.md +110 -12
- package/docs/reference/classes/Compression.md +19 -11
- package/docs/reference/classes/ConflictError.md +80 -28
- package/docs/reference/classes/Converter.md +110 -26
- package/docs/reference/classes/EnvHelper.md +45 -0
- package/docs/reference/classes/ErrorHelper.md +19 -7
- package/docs/reference/classes/Factory.md +95 -17
- package/docs/reference/classes/FilenameHelper.md +6 -4
- package/docs/reference/classes/GeneralError.md +75 -27
- package/docs/reference/classes/GuardError.md +80 -28
- package/docs/reference/classes/Guards.md +398 -80
- package/docs/reference/classes/HexHelper.md +18 -8
- package/docs/reference/classes/I18n.md +46 -20
- package/docs/reference/classes/Is.md +179 -51
- package/docs/reference/classes/JsonHelper.md +146 -10
- package/docs/reference/classes/NotFoundError.md +77 -27
- package/docs/reference/classes/NotImplementedError.md +71 -25
- package/docs/reference/classes/NotSupportedError.md +74 -26
- package/docs/reference/classes/ObjectHelper.md +225 -35
- package/docs/reference/classes/RandomHelper.md +6 -4
- package/docs/reference/classes/SharedStore.md +94 -0
- package/docs/reference/classes/StringHelper.md +54 -20
- package/docs/reference/classes/Uint8ArrayHelper.md +35 -0
- package/docs/reference/classes/UnauthorizedError.md +74 -26
- package/docs/reference/classes/UnprocessableError.md +75 -27
- package/docs/reference/classes/Url.md +37 -17
- package/docs/reference/classes/Urn.md +63 -27
- package/docs/reference/classes/Validation.md +349 -135
- package/docs/reference/classes/ValidationError.md +74 -26
- package/docs/reference/index.md +8 -0
- package/docs/reference/interfaces/IComponent.md +30 -8
- package/docs/reference/interfaces/IError.md +2 -2
- package/docs/reference/interfaces/II18nShared.md +47 -0
- package/docs/reference/interfaces/IKeyValue.md +3 -1
- package/docs/reference/interfaces/ILabelledValue.md +3 -1
- package/docs/reference/interfaces/ILocaleDictionary.md +1 -1
- package/docs/reference/interfaces/IPatchOperation.md +1 -1
- package/docs/reference/interfaces/IValidationFailure.md +1 -1
- package/docs/reference/type-aliases/CoerceType.md +5 -0
- package/docs/reference/type-aliases/CompressionType.md +1 -1
- package/docs/reference/type-aliases/ObjectOrArray.md +11 -0
- package/docs/reference/variables/CoerceType.md +67 -0
- package/docs/reference/variables/CompressionType.md +1 -1
- package/locales/en.json +23 -1
- package/package.json +6 -6
|
@@ -4,42 +4,90 @@ Factory for creating implementation of generic types.
|
|
|
4
4
|
|
|
5
5
|
## Type Parameters
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
### T
|
|
8
|
+
|
|
9
|
+
`T`
|
|
8
10
|
|
|
9
11
|
## Methods
|
|
10
12
|
|
|
11
13
|
### createFactory()
|
|
12
14
|
|
|
13
|
-
> `static` **createFactory**\<`U`\>(`typeName`, `autoInstance`, `matcher
|
|
15
|
+
> `static` **createFactory**\<`U`\>(`typeName`, `autoInstance`, `matcher?`): `Factory`\<`U`\>
|
|
14
16
|
|
|
15
17
|
Create a new factory, which is shared throughout all library instances.
|
|
16
18
|
|
|
17
19
|
#### Type Parameters
|
|
18
20
|
|
|
19
|
-
|
|
21
|
+
##### U
|
|
22
|
+
|
|
23
|
+
`U`
|
|
20
24
|
|
|
21
25
|
#### Parameters
|
|
22
26
|
|
|
23
|
-
|
|
27
|
+
##### typeName
|
|
28
|
+
|
|
29
|
+
`string`
|
|
24
30
|
|
|
25
31
|
The type name for the instances.
|
|
26
32
|
|
|
27
|
-
|
|
33
|
+
##### autoInstance
|
|
34
|
+
|
|
35
|
+
`boolean` = `false`
|
|
28
36
|
|
|
29
37
|
Automatically create an instance when registered.
|
|
30
38
|
|
|
31
|
-
|
|
39
|
+
##### matcher?
|
|
40
|
+
|
|
41
|
+
(`names`, `name`) => `undefined` \| `string`
|
|
32
42
|
|
|
33
43
|
Match the name of the instance.
|
|
34
44
|
|
|
35
45
|
#### Returns
|
|
36
46
|
|
|
37
|
-
|
|
47
|
+
`Factory`\<`U`\>
|
|
38
48
|
|
|
39
49
|
The factory instance.
|
|
40
50
|
|
|
41
51
|
***
|
|
42
52
|
|
|
53
|
+
### getFactories()
|
|
54
|
+
|
|
55
|
+
> `static` **getFactories**(): `object`
|
|
56
|
+
|
|
57
|
+
Get all the factories.
|
|
58
|
+
|
|
59
|
+
#### Returns
|
|
60
|
+
|
|
61
|
+
`object`
|
|
62
|
+
|
|
63
|
+
All the factories.
|
|
64
|
+
|
|
65
|
+
***
|
|
66
|
+
|
|
67
|
+
### resetFactories()
|
|
68
|
+
|
|
69
|
+
> `static` **resetFactories**(): `void`
|
|
70
|
+
|
|
71
|
+
Reset all the factories, which removes any created instances, but not the registrations.
|
|
72
|
+
|
|
73
|
+
#### Returns
|
|
74
|
+
|
|
75
|
+
`void`
|
|
76
|
+
|
|
77
|
+
***
|
|
78
|
+
|
|
79
|
+
### clearFactories()
|
|
80
|
+
|
|
81
|
+
> `static` **clearFactories**(): `void`
|
|
82
|
+
|
|
83
|
+
Clear all the factories, which removes anything registered with the factories.
|
|
84
|
+
|
|
85
|
+
#### Returns
|
|
86
|
+
|
|
87
|
+
`void`
|
|
88
|
+
|
|
89
|
+
***
|
|
90
|
+
|
|
43
91
|
### register()
|
|
44
92
|
|
|
45
93
|
> **register**\<`U`\>(`name`, `generator`): `void`
|
|
@@ -48,15 +96,21 @@ Register a new generator.
|
|
|
48
96
|
|
|
49
97
|
#### Type Parameters
|
|
50
98
|
|
|
51
|
-
|
|
99
|
+
##### U
|
|
100
|
+
|
|
101
|
+
`U`
|
|
52
102
|
|
|
53
103
|
#### Parameters
|
|
54
104
|
|
|
55
|
-
|
|
105
|
+
##### name
|
|
106
|
+
|
|
107
|
+
`string`
|
|
56
108
|
|
|
57
109
|
The name of the generator.
|
|
58
110
|
|
|
59
|
-
|
|
111
|
+
##### generator
|
|
112
|
+
|
|
113
|
+
() => `U`
|
|
60
114
|
|
|
61
115
|
The function to create an instance.
|
|
62
116
|
|
|
@@ -74,7 +128,9 @@ Unregister a generator.
|
|
|
74
128
|
|
|
75
129
|
#### Parameters
|
|
76
130
|
|
|
77
|
-
|
|
131
|
+
##### name
|
|
132
|
+
|
|
133
|
+
`string`
|
|
78
134
|
|
|
79
135
|
The name of the generator to unregister.
|
|
80
136
|
|
|
@@ -100,11 +156,15 @@ Get a generator instance.
|
|
|
100
156
|
|
|
101
157
|
#### Type Parameters
|
|
102
158
|
|
|
103
|
-
|
|
159
|
+
##### U
|
|
160
|
+
|
|
161
|
+
`U`
|
|
104
162
|
|
|
105
163
|
#### Parameters
|
|
106
164
|
|
|
107
|
-
|
|
165
|
+
##### name
|
|
166
|
+
|
|
167
|
+
`string`
|
|
108
168
|
|
|
109
169
|
The name of the instance to generate.
|
|
110
170
|
|
|
@@ -132,11 +192,15 @@ Get a generator instance with no exceptions.
|
|
|
132
192
|
|
|
133
193
|
#### Type Parameters
|
|
134
194
|
|
|
135
|
-
|
|
195
|
+
##### U
|
|
196
|
+
|
|
197
|
+
`U`
|
|
136
198
|
|
|
137
199
|
#### Parameters
|
|
138
200
|
|
|
139
|
-
|
|
201
|
+
##### name
|
|
202
|
+
|
|
203
|
+
`string`
|
|
140
204
|
|
|
141
205
|
The name of the instance to generate.
|
|
142
206
|
|
|
@@ -152,7 +216,19 @@ An instance of the item or undefined if it does not exist.
|
|
|
152
216
|
|
|
153
217
|
> **reset**(): `void`
|
|
154
218
|
|
|
155
|
-
|
|
219
|
+
Remove all the instances and leave the generators intact.
|
|
220
|
+
|
|
221
|
+
#### Returns
|
|
222
|
+
|
|
223
|
+
`void`
|
|
224
|
+
|
|
225
|
+
***
|
|
226
|
+
|
|
227
|
+
### clear()
|
|
228
|
+
|
|
229
|
+
> **clear**(): `void`
|
|
230
|
+
|
|
231
|
+
Remove all the instances and the generators.
|
|
156
232
|
|
|
157
233
|
#### Returns
|
|
158
234
|
|
|
@@ -210,7 +286,9 @@ Does the factory contain the name.
|
|
|
210
286
|
|
|
211
287
|
#### Parameters
|
|
212
288
|
|
|
213
|
-
|
|
289
|
+
##### name
|
|
290
|
+
|
|
291
|
+
`string`
|
|
214
292
|
|
|
215
293
|
The name of the instance to find.
|
|
216
294
|
|
|
@@ -4,13 +4,13 @@ Class to help with filenames.
|
|
|
4
4
|
|
|
5
5
|
## Constructors
|
|
6
6
|
|
|
7
|
-
###
|
|
7
|
+
### Constructor
|
|
8
8
|
|
|
9
|
-
> **new FilenameHelper**():
|
|
9
|
+
> **new FilenameHelper**(): `FilenameHelper`
|
|
10
10
|
|
|
11
11
|
#### Returns
|
|
12
12
|
|
|
13
|
-
|
|
13
|
+
`FilenameHelper`
|
|
14
14
|
|
|
15
15
|
## Methods
|
|
16
16
|
|
|
@@ -22,7 +22,9 @@ Replaces any unsafe characters in the filename.
|
|
|
22
22
|
|
|
23
23
|
#### Parameters
|
|
24
24
|
|
|
25
|
-
|
|
25
|
+
##### filename
|
|
26
|
+
|
|
27
|
+
`unknown`
|
|
26
28
|
|
|
27
29
|
The filename to make safe.
|
|
28
30
|
|
|
@@ -8,37 +8,43 @@ Class to handle errors.
|
|
|
8
8
|
|
|
9
9
|
## Constructors
|
|
10
10
|
|
|
11
|
-
###
|
|
11
|
+
### Constructor
|
|
12
12
|
|
|
13
|
-
> **new GeneralError**(`source`, `message`, `properties
|
|
13
|
+
> **new GeneralError**(`source`, `message`, `properties?`, `inner?`): `GeneralError`
|
|
14
14
|
|
|
15
15
|
Create a new instance of GeneralError.
|
|
16
16
|
|
|
17
17
|
#### Parameters
|
|
18
18
|
|
|
19
|
-
|
|
19
|
+
##### source
|
|
20
|
+
|
|
21
|
+
`string`
|
|
20
22
|
|
|
21
23
|
The source of the error.
|
|
22
24
|
|
|
23
|
-
|
|
25
|
+
##### message
|
|
26
|
+
|
|
27
|
+
`string`
|
|
24
28
|
|
|
25
29
|
The message as a code.
|
|
26
30
|
|
|
27
|
-
|
|
31
|
+
##### properties?
|
|
28
32
|
|
|
29
33
|
Any additional information for the error.
|
|
30
34
|
|
|
31
|
-
|
|
35
|
+
##### inner?
|
|
36
|
+
|
|
37
|
+
`unknown`
|
|
32
38
|
|
|
33
39
|
The inner error if we have wrapped another error.
|
|
34
40
|
|
|
35
41
|
#### Returns
|
|
36
42
|
|
|
37
|
-
|
|
43
|
+
`GeneralError`
|
|
38
44
|
|
|
39
45
|
#### Overrides
|
|
40
46
|
|
|
41
|
-
[`BaseError`](BaseError.md).[`constructor`](BaseError.md#
|
|
47
|
+
[`BaseError`](BaseError.md).[`constructor`](BaseError.md#constructor)
|
|
42
48
|
|
|
43
49
|
## Properties
|
|
44
50
|
|
|
@@ -62,7 +68,7 @@ Any additional information for the error.
|
|
|
62
68
|
|
|
63
69
|
#### Index Signature
|
|
64
70
|
|
|
65
|
-
|
|
71
|
+
\[`id`: `string`\]: `unknown`
|
|
66
72
|
|
|
67
73
|
#### Inherited from
|
|
68
74
|
|
|
@@ -98,7 +104,9 @@ Construct an error from an existing one.
|
|
|
98
104
|
|
|
99
105
|
#### Parameters
|
|
100
106
|
|
|
101
|
-
|
|
107
|
+
##### err
|
|
108
|
+
|
|
109
|
+
`unknown`
|
|
102
110
|
|
|
103
111
|
The existing error.
|
|
104
112
|
|
|
@@ -122,7 +130,9 @@ Flatten an error tree.
|
|
|
122
130
|
|
|
123
131
|
#### Parameters
|
|
124
132
|
|
|
125
|
-
|
|
133
|
+
##### err
|
|
134
|
+
|
|
135
|
+
`unknown`
|
|
126
136
|
|
|
127
137
|
The starting error.
|
|
128
138
|
|
|
@@ -146,10 +156,12 @@ Expand an error tree.
|
|
|
146
156
|
|
|
147
157
|
#### Parameters
|
|
148
158
|
|
|
149
|
-
|
|
159
|
+
##### errors
|
|
150
160
|
|
|
151
161
|
The list of errors to expand.
|
|
152
162
|
|
|
163
|
+
`undefined` | [`IError`](../interfaces/IError.md)[]
|
|
164
|
+
|
|
153
165
|
#### Returns
|
|
154
166
|
|
|
155
167
|
`undefined` \| [`IError`](../interfaces/IError.md)
|
|
@@ -170,14 +182,18 @@ Test to see if the error has the specified error name.
|
|
|
170
182
|
|
|
171
183
|
#### Parameters
|
|
172
184
|
|
|
173
|
-
|
|
185
|
+
##### error
|
|
186
|
+
|
|
187
|
+
`unknown`
|
|
174
188
|
|
|
175
189
|
The error to test.
|
|
176
190
|
|
|
177
|
-
|
|
191
|
+
##### name
|
|
178
192
|
|
|
179
193
|
The name to check for.
|
|
180
194
|
|
|
195
|
+
`string` | `RegExp`
|
|
196
|
+
|
|
181
197
|
#### Returns
|
|
182
198
|
|
|
183
199
|
`error is BaseError`
|
|
@@ -198,14 +214,18 @@ Test to see if the error has the specified error message.
|
|
|
198
214
|
|
|
199
215
|
#### Parameters
|
|
200
216
|
|
|
201
|
-
|
|
217
|
+
##### error
|
|
218
|
+
|
|
219
|
+
`unknown`
|
|
202
220
|
|
|
203
221
|
The error to test.
|
|
204
222
|
|
|
205
|
-
|
|
223
|
+
##### message
|
|
206
224
|
|
|
207
225
|
The message to check for.
|
|
208
226
|
|
|
227
|
+
`string` | `RegExp`
|
|
228
|
+
|
|
209
229
|
#### Returns
|
|
210
230
|
|
|
211
231
|
`error is BaseError`
|
|
@@ -226,14 +246,18 @@ Test to see if the error has the specified error code.
|
|
|
226
246
|
|
|
227
247
|
#### Parameters
|
|
228
248
|
|
|
229
|
-
|
|
249
|
+
##### error
|
|
250
|
+
|
|
251
|
+
`unknown`
|
|
230
252
|
|
|
231
253
|
The error to test.
|
|
232
254
|
|
|
233
|
-
|
|
255
|
+
##### code
|
|
234
256
|
|
|
235
257
|
The code to check for.
|
|
236
258
|
|
|
259
|
+
`string` | `RegExp`
|
|
260
|
+
|
|
237
261
|
#### Returns
|
|
238
262
|
|
|
239
263
|
`boolean`
|
|
@@ -254,14 +278,18 @@ Test to see if any of the errors or children have the given error name.
|
|
|
254
278
|
|
|
255
279
|
#### Parameters
|
|
256
280
|
|
|
257
|
-
|
|
281
|
+
##### error
|
|
282
|
+
|
|
283
|
+
`unknown`
|
|
258
284
|
|
|
259
285
|
The error to test.
|
|
260
286
|
|
|
261
|
-
|
|
287
|
+
##### name
|
|
262
288
|
|
|
263
289
|
The name to check for.
|
|
264
290
|
|
|
291
|
+
`string` | `RegExp`
|
|
292
|
+
|
|
265
293
|
#### Returns
|
|
266
294
|
|
|
267
295
|
`error is BaseError`
|
|
@@ -282,14 +310,18 @@ Test to see if any of the errors or children have the given error message.
|
|
|
282
310
|
|
|
283
311
|
#### Parameters
|
|
284
312
|
|
|
285
|
-
|
|
313
|
+
##### error
|
|
314
|
+
|
|
315
|
+
`unknown`
|
|
286
316
|
|
|
287
317
|
The error to test.
|
|
288
318
|
|
|
289
|
-
|
|
319
|
+
##### message
|
|
290
320
|
|
|
291
321
|
The message to check for.
|
|
292
322
|
|
|
323
|
+
`string` | `RegExp`
|
|
324
|
+
|
|
293
325
|
#### Returns
|
|
294
326
|
|
|
295
327
|
`error is BaseError`
|
|
@@ -310,11 +342,15 @@ Test to see if any of the errors or children are from a specific class.
|
|
|
310
342
|
|
|
311
343
|
#### Parameters
|
|
312
344
|
|
|
313
|
-
|
|
345
|
+
##### error
|
|
346
|
+
|
|
347
|
+
`unknown`
|
|
314
348
|
|
|
315
349
|
The error to test.
|
|
316
350
|
|
|
317
|
-
|
|
351
|
+
##### cls
|
|
352
|
+
|
|
353
|
+
`string`
|
|
318
354
|
|
|
319
355
|
The class to check for.
|
|
320
356
|
|
|
@@ -338,14 +374,18 @@ Test to see if any of the errors or children have the given error code.
|
|
|
338
374
|
|
|
339
375
|
#### Parameters
|
|
340
376
|
|
|
341
|
-
|
|
377
|
+
##### error
|
|
378
|
+
|
|
379
|
+
`unknown`
|
|
342
380
|
|
|
343
381
|
The error to test.
|
|
344
382
|
|
|
345
|
-
|
|
383
|
+
##### code
|
|
346
384
|
|
|
347
385
|
The code to check for.
|
|
348
386
|
|
|
387
|
+
`string` | `RegExp`
|
|
388
|
+
|
|
349
389
|
#### Returns
|
|
350
390
|
|
|
351
391
|
`error is BaseError`
|
|
@@ -360,10 +400,18 @@ True if the error has the name.
|
|
|
360
400
|
|
|
361
401
|
### toJsonObject()
|
|
362
402
|
|
|
363
|
-
> **toJsonObject**(): [`IError`](../interfaces/IError.md)
|
|
403
|
+
> **toJsonObject**(`includeStackTrace?`): [`IError`](../interfaces/IError.md)
|
|
364
404
|
|
|
365
405
|
Serialize the error to the error model.
|
|
366
406
|
|
|
407
|
+
#### Parameters
|
|
408
|
+
|
|
409
|
+
##### includeStackTrace?
|
|
410
|
+
|
|
411
|
+
`boolean`
|
|
412
|
+
|
|
413
|
+
Whether to include the error stack in the model, defaults to false.
|
|
414
|
+
|
|
367
415
|
#### Returns
|
|
368
416
|
|
|
369
417
|
[`IError`](../interfaces/IError.md)
|