@twin.org/core 0.0.1-next.1

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 (103) hide show
  1. package/LICENSE +201 -0
  2. package/README.md +29 -0
  3. package/dist/cjs/index.cjs +4221 -0
  4. package/dist/esm/index.mjs +4184 -0
  5. package/dist/types/encoding/base32.d.ts +18 -0
  6. package/dist/types/encoding/base64.d.ts +24 -0
  7. package/dist/types/encoding/base64Url.d.ts +18 -0
  8. package/dist/types/errors/alreadyExistsError.d.ts +18 -0
  9. package/dist/types/errors/baseError.d.ts +103 -0
  10. package/dist/types/errors/conflictError.d.ts +19 -0
  11. package/dist/types/errors/generalError.d.ts +20 -0
  12. package/dist/types/errors/guardError.d.ts +19 -0
  13. package/dist/types/errors/notFoundError.d.ts +18 -0
  14. package/dist/types/errors/notImplementedError.d.ts +16 -0
  15. package/dist/types/errors/notSupportedError.d.ts +17 -0
  16. package/dist/types/errors/unauthorizedError.d.ts +17 -0
  17. package/dist/types/errors/unprocessableError.d.ts +20 -0
  18. package/dist/types/errors/validationError.d.ts +18 -0
  19. package/dist/types/factories/componentFactory.d.ts +6 -0
  20. package/dist/types/factories/factory.d.ts +67 -0
  21. package/dist/types/helpers/arrayHelper.d.ts +12 -0
  22. package/dist/types/helpers/errorHelper.d.ts +24 -0
  23. package/dist/types/helpers/filenameHelper.d.ts +11 -0
  24. package/dist/types/helpers/hexHelper.d.ts +30 -0
  25. package/dist/types/helpers/jsonHelper.d.ts +29 -0
  26. package/dist/types/helpers/objectHelper.d.ts +74 -0
  27. package/dist/types/helpers/randomHelper.d.ts +11 -0
  28. package/dist/types/helpers/stringHelper.d.ts +90 -0
  29. package/dist/types/index.d.ts +46 -0
  30. package/dist/types/models/IComponent.d.ts +29 -0
  31. package/dist/types/models/IError.d.ts +31 -0
  32. package/dist/types/models/IKeyValue.d.ts +13 -0
  33. package/dist/types/models/ILabelledValue.d.ts +13 -0
  34. package/dist/types/models/ILocale.d.ts +13 -0
  35. package/dist/types/models/ILocaleDictionary.d.ts +6 -0
  36. package/dist/types/models/ILocalesIndex.d.ts +10 -0
  37. package/dist/types/models/IPatchOperation.d.ts +21 -0
  38. package/dist/types/models/IUrlParts.d.ts +29 -0
  39. package/dist/types/models/IValidationFailure.d.ts +23 -0
  40. package/dist/types/models/compressionType.d.ts +17 -0
  41. package/dist/types/types/bitString.d.ts +41 -0
  42. package/dist/types/types/url.d.ts +56 -0
  43. package/dist/types/types/urn.d.ts +93 -0
  44. package/dist/types/utils/asyncCache.d.ts +33 -0
  45. package/dist/types/utils/coerce.d.ts +61 -0
  46. package/dist/types/utils/compression.d.ts +20 -0
  47. package/dist/types/utils/converter.d.ts +85 -0
  48. package/dist/types/utils/guards.d.ts +190 -0
  49. package/dist/types/utils/i18n.d.ts +81 -0
  50. package/dist/types/utils/is.d.ts +205 -0
  51. package/dist/types/utils/validation.d.ts +245 -0
  52. package/docs/changelog.md +5 -0
  53. package/docs/examples.md +1 -0
  54. package/docs/reference/classes/AlreadyExistsError.md +375 -0
  55. package/docs/reference/classes/ArrayHelper.md +37 -0
  56. package/docs/reference/classes/AsyncCache.md +117 -0
  57. package/docs/reference/classes/Base32.md +57 -0
  58. package/docs/reference/classes/Base64.md +74 -0
  59. package/docs/reference/classes/Base64Url.md +54 -0
  60. package/docs/reference/classes/BaseError.md +344 -0
  61. package/docs/reference/classes/BitString.md +123 -0
  62. package/docs/reference/classes/Coerce.md +209 -0
  63. package/docs/reference/classes/Compression.md +61 -0
  64. package/docs/reference/classes/ConflictError.md +379 -0
  65. package/docs/reference/classes/Converter.md +285 -0
  66. package/docs/reference/classes/ErrorHelper.md +73 -0
  67. package/docs/reference/classes/Factory.md +221 -0
  68. package/docs/reference/classes/FilenameHelper.md +33 -0
  69. package/docs/reference/classes/GeneralError.md +375 -0
  70. package/docs/reference/classes/GuardError.md +379 -0
  71. package/docs/reference/classes/Guards.md +711 -0
  72. package/docs/reference/classes/HexHelper.md +97 -0
  73. package/docs/reference/classes/I18n.md +237 -0
  74. package/docs/reference/classes/Is.md +693 -0
  75. package/docs/reference/classes/JsonHelper.md +92 -0
  76. package/docs/reference/classes/NotFoundError.md +375 -0
  77. package/docs/reference/classes/NotImplementedError.md +367 -0
  78. package/docs/reference/classes/NotSupportedError.md +371 -0
  79. package/docs/reference/classes/ObjectHelper.md +287 -0
  80. package/docs/reference/classes/RandomHelper.md +33 -0
  81. package/docs/reference/classes/StringHelper.md +270 -0
  82. package/docs/reference/classes/UnauthorizedError.md +371 -0
  83. package/docs/reference/classes/UnprocessableError.md +375 -0
  84. package/docs/reference/classes/Url.md +167 -0
  85. package/docs/reference/classes/Urn.md +295 -0
  86. package/docs/reference/classes/Validation.md +821 -0
  87. package/docs/reference/classes/ValidationError.md +371 -0
  88. package/docs/reference/index.md +60 -0
  89. package/docs/reference/interfaces/IComponent.md +79 -0
  90. package/docs/reference/interfaces/IError.md +55 -0
  91. package/docs/reference/interfaces/IKeyValue.md +23 -0
  92. package/docs/reference/interfaces/ILabelledValue.md +23 -0
  93. package/docs/reference/interfaces/ILocale.md +19 -0
  94. package/docs/reference/interfaces/ILocaleDictionary.md +7 -0
  95. package/docs/reference/interfaces/ILocalesIndex.md +11 -0
  96. package/docs/reference/interfaces/IPatchOperation.md +35 -0
  97. package/docs/reference/interfaces/IUrlParts.md +51 -0
  98. package/docs/reference/interfaces/IValidationFailure.md +39 -0
  99. package/docs/reference/type-aliases/CompressionType.md +5 -0
  100. package/docs/reference/variables/ComponentFactory.md +5 -0
  101. package/docs/reference/variables/CompressionType.md +19 -0
  102. package/locales/en.json +98 -0
  103. package/package.json +65 -0
@@ -0,0 +1,379 @@
1
+ # Class: GuardError
2
+
3
+ Class to handle errors which are triggered by data guards.
4
+
5
+ ## Extends
6
+
7
+ - [`BaseError`](BaseError.md)
8
+
9
+ ## Constructors
10
+
11
+ ### new GuardError()
12
+
13
+ > **new GuardError**(`source`, `message`, `propertyName`, `propertyValue`, `propertyOptions`?): [`GuardError`](GuardError.md)
14
+
15
+ Create a new instance of GuardError.
16
+
17
+ #### Parameters
18
+
19
+ • **source**: `string`
20
+
21
+ The source of the error.
22
+
23
+ • **message**: `string`
24
+
25
+ The message as a code.
26
+
27
+ • **propertyName**: `string`
28
+
29
+ The property which triggered the guard error for the item.
30
+
31
+ • **propertyValue**: `unknown`
32
+
33
+ The property value which triggered the guard error for the item.
34
+
35
+ • **propertyOptions?**: `string`
36
+
37
+ The property options which might be allowed.
38
+
39
+ #### Returns
40
+
41
+ [`GuardError`](GuardError.md)
42
+
43
+ #### Overrides
44
+
45
+ [`BaseError`](BaseError.md).[`constructor`](BaseError.md#constructors)
46
+
47
+ ## Properties
48
+
49
+ ### source?
50
+
51
+ > `optional` **source**: `string`
52
+
53
+ The source of the error.
54
+
55
+ #### Inherited from
56
+
57
+ [`BaseError`](BaseError.md).[`source`](BaseError.md#source)
58
+
59
+ ***
60
+
61
+ ### properties?
62
+
63
+ > `optional` **properties**: `object`
64
+
65
+ Any additional information for the error.
66
+
67
+ #### Index Signature
68
+
69
+ \[`id`: `string`\]: `unknown`
70
+
71
+ #### Inherited from
72
+
73
+ [`BaseError`](BaseError.md).[`properties`](BaseError.md#properties)
74
+
75
+ ***
76
+
77
+ ### inner?
78
+
79
+ > `optional` **inner**: [`IError`](../interfaces/IError.md)
80
+
81
+ The inner error if there was one.
82
+
83
+ #### Inherited from
84
+
85
+ [`BaseError`](BaseError.md).[`inner`](BaseError.md#inner)
86
+
87
+ ***
88
+
89
+ ### CLASS\_NAME
90
+
91
+ > `readonly` `static` **CLASS\_NAME**: `string`
92
+
93
+ Runtime name for the class.
94
+
95
+ ## Methods
96
+
97
+ ### fromError()
98
+
99
+ > `static` **fromError**(`err`): [`BaseError`](BaseError.md)
100
+
101
+ Construct an error from an existing one.
102
+
103
+ #### Parameters
104
+
105
+ • **err**: `unknown`
106
+
107
+ The existing error.
108
+
109
+ #### Returns
110
+
111
+ [`BaseError`](BaseError.md)
112
+
113
+ The new instance.
114
+
115
+ #### Inherited from
116
+
117
+ [`BaseError`](BaseError.md).[`fromError`](BaseError.md#fromerror)
118
+
119
+ ***
120
+
121
+ ### flatten()
122
+
123
+ > `static` **flatten**(`err`): [`IError`](../interfaces/IError.md)[]
124
+
125
+ Flatten an error tree.
126
+
127
+ #### Parameters
128
+
129
+ • **err**: `unknown`
130
+
131
+ The starting error.
132
+
133
+ #### Returns
134
+
135
+ [`IError`](../interfaces/IError.md)[]
136
+
137
+ The list of all internal errors.
138
+
139
+ #### Inherited from
140
+
141
+ [`BaseError`](BaseError.md).[`flatten`](BaseError.md#flatten)
142
+
143
+ ***
144
+
145
+ ### expand()
146
+
147
+ > `static` **expand**(`errors`): `undefined` \| [`IError`](../interfaces/IError.md)
148
+
149
+ Expand an error tree.
150
+
151
+ #### Parameters
152
+
153
+ • **errors**: `undefined` \| [`IError`](../interfaces/IError.md)[]
154
+
155
+ The list of errors to expand.
156
+
157
+ #### Returns
158
+
159
+ `undefined` \| [`IError`](../interfaces/IError.md)
160
+
161
+ The first level error.
162
+
163
+ #### Inherited from
164
+
165
+ [`BaseError`](BaseError.md).[`expand`](BaseError.md#expand)
166
+
167
+ ***
168
+
169
+ ### isErrorName()
170
+
171
+ > `static` **isErrorName**(`error`, `name`): `error is BaseError`
172
+
173
+ Test to see if the error has the specified error name.
174
+
175
+ #### Parameters
176
+
177
+ • **error**: `unknown`
178
+
179
+ The error to test.
180
+
181
+ • **name**: `string` \| `RegExp`
182
+
183
+ The name to check for.
184
+
185
+ #### Returns
186
+
187
+ `error is BaseError`
188
+
189
+ True if the error has the name.
190
+
191
+ #### Inherited from
192
+
193
+ [`BaseError`](BaseError.md).[`isErrorName`](BaseError.md#iserrorname)
194
+
195
+ ***
196
+
197
+ ### isErrorMessage()
198
+
199
+ > `static` **isErrorMessage**(`error`, `message`): `error is BaseError`
200
+
201
+ Test to see if the error has the specified error message.
202
+
203
+ #### Parameters
204
+
205
+ • **error**: `unknown`
206
+
207
+ The error to test.
208
+
209
+ • **message**: `string` \| `RegExp`
210
+
211
+ The message to check for.
212
+
213
+ #### Returns
214
+
215
+ `error is BaseError`
216
+
217
+ True if the error has the name.
218
+
219
+ #### Inherited from
220
+
221
+ [`BaseError`](BaseError.md).[`isErrorMessage`](BaseError.md#iserrormessage)
222
+
223
+ ***
224
+
225
+ ### isErrorCode()
226
+
227
+ > `static` **isErrorCode**(`error`, `code`): `boolean`
228
+
229
+ Test to see if the error has the specified error code.
230
+
231
+ #### Parameters
232
+
233
+ • **error**: `unknown`
234
+
235
+ The error to test.
236
+
237
+ • **code**: `string` \| `RegExp`
238
+
239
+ The code to check for.
240
+
241
+ #### Returns
242
+
243
+ `boolean`
244
+
245
+ True if the error has the code.
246
+
247
+ #### Inherited from
248
+
249
+ [`BaseError`](BaseError.md).[`isErrorCode`](BaseError.md#iserrorcode)
250
+
251
+ ***
252
+
253
+ ### someErrorName()
254
+
255
+ > `static` **someErrorName**(`error`, `name`): `error is BaseError`
256
+
257
+ Test to see if any of the errors or children have the given error name.
258
+
259
+ #### Parameters
260
+
261
+ • **error**: `unknown`
262
+
263
+ The error to test.
264
+
265
+ • **name**: `string` \| `RegExp`
266
+
267
+ The name to check for.
268
+
269
+ #### Returns
270
+
271
+ `error is BaseError`
272
+
273
+ True if the error has the name.
274
+
275
+ #### Inherited from
276
+
277
+ [`BaseError`](BaseError.md).[`someErrorName`](BaseError.md#someerrorname)
278
+
279
+ ***
280
+
281
+ ### someErrorMessage()
282
+
283
+ > `static` **someErrorMessage**(`error`, `message`): `error is BaseError`
284
+
285
+ Test to see if any of the errors or children have the given error message.
286
+
287
+ #### Parameters
288
+
289
+ • **error**: `unknown`
290
+
291
+ The error to test.
292
+
293
+ • **message**: `string` \| `RegExp`
294
+
295
+ The message to check for.
296
+
297
+ #### Returns
298
+
299
+ `error is BaseError`
300
+
301
+ True if the error has the name.
302
+
303
+ #### Inherited from
304
+
305
+ [`BaseError`](BaseError.md).[`someErrorMessage`](BaseError.md#someerrormessage)
306
+
307
+ ***
308
+
309
+ ### someErrorClass()
310
+
311
+ > `static` **someErrorClass**(`error`, `cls`): `error is BaseError`
312
+
313
+ Test to see if any of the errors or children are from a specific class.
314
+
315
+ #### Parameters
316
+
317
+ • **error**: `unknown`
318
+
319
+ The error to test.
320
+
321
+ • **cls**: `string`
322
+
323
+ The class to check for.
324
+
325
+ #### Returns
326
+
327
+ `error is BaseError`
328
+
329
+ True if the error has the specific class.
330
+
331
+ #### Inherited from
332
+
333
+ [`BaseError`](BaseError.md).[`someErrorClass`](BaseError.md#someerrorclass)
334
+
335
+ ***
336
+
337
+ ### someErrorCode()
338
+
339
+ > `static` **someErrorCode**(`error`, `code`): `error is BaseError`
340
+
341
+ Test to see if any of the errors or children have the given error code.
342
+
343
+ #### Parameters
344
+
345
+ • **error**: `unknown`
346
+
347
+ The error to test.
348
+
349
+ • **code**: `string` \| `RegExp`
350
+
351
+ The code to check for.
352
+
353
+ #### Returns
354
+
355
+ `error is BaseError`
356
+
357
+ True if the error has the name.
358
+
359
+ #### Inherited from
360
+
361
+ [`BaseError`](BaseError.md).[`someErrorCode`](BaseError.md#someerrorcode)
362
+
363
+ ***
364
+
365
+ ### toJsonObject()
366
+
367
+ > **toJsonObject**(): [`IError`](../interfaces/IError.md)
368
+
369
+ Serialize the error to the error model.
370
+
371
+ #### Returns
372
+
373
+ [`IError`](../interfaces/IError.md)
374
+
375
+ The error model.
376
+
377
+ #### Inherited from
378
+
379
+ [`BaseError`](BaseError.md).[`toJsonObject`](BaseError.md#tojsonobject)