@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,123 @@
1
+ # Class: BitString
2
+
3
+ A class to represent a bit string.
4
+
5
+ ## Constructors
6
+
7
+ ### new BitString()
8
+
9
+ > **new BitString**(`numberBits`): [`BitString`](BitString.md)
10
+
11
+ Create a new instance of BitString.
12
+
13
+ #### Parameters
14
+
15
+ • **numberBits**: `number`
16
+
17
+ The length of the bit string.
18
+
19
+ #### Returns
20
+
21
+ [`BitString`](BitString.md)
22
+
23
+ ## Methods
24
+
25
+ ### fromBits()
26
+
27
+ > `static` **fromBits**(`bits`, `numberBits`): [`BitString`](BitString.md)
28
+
29
+ Create a new instance of BitString from a bit array.
30
+
31
+ #### Parameters
32
+
33
+ • **bits**: `Uint8Array`
34
+
35
+ The bits to create the bit string from.
36
+
37
+ • **numberBits**: `number`
38
+
39
+ The number of bits in the bit string.
40
+
41
+ #### Returns
42
+
43
+ [`BitString`](BitString.md)
44
+
45
+ The new instance of BitString.
46
+
47
+ ***
48
+
49
+ ### getBit()
50
+
51
+ > **getBit**(`index`): `boolean`
52
+
53
+ Get the bit at the given index.
54
+
55
+ #### Parameters
56
+
57
+ • **index**: `number`
58
+
59
+ The index to get the bit for.
60
+
61
+ #### Returns
62
+
63
+ `boolean`
64
+
65
+ True if the bit at the index is set.
66
+
67
+ #### Throws
68
+
69
+ GeneralError if the index is out of range.
70
+
71
+ ***
72
+
73
+ ### setBit()
74
+
75
+ > **setBit**(`index`, `value`): `void`
76
+
77
+ Set the bit at the given index.
78
+
79
+ #### Parameters
80
+
81
+ • **index**: `number`
82
+
83
+ The index to set the bit for.
84
+
85
+ • **value**: `boolean`
86
+
87
+ The value to set the bit to.
88
+
89
+ #### Returns
90
+
91
+ `void`
92
+
93
+ #### Throws
94
+
95
+ GeneralError if the index is out of range.
96
+
97
+ ***
98
+
99
+ ### getBits()
100
+
101
+ > **getBits**(): `Uint8Array`
102
+
103
+ Get the bits of the bit string.
104
+
105
+ #### Returns
106
+
107
+ `Uint8Array`
108
+
109
+ The bits stored in a Uint8Array.
110
+
111
+ ***
112
+
113
+ ### getLength()
114
+
115
+ > **getLength**(): `number`
116
+
117
+ Get the length of the bit string.
118
+
119
+ #### Returns
120
+
121
+ `number`
122
+
123
+ The length of the bit string.
@@ -0,0 +1,209 @@
1
+ # Class: Coerce
2
+
3
+ Coerce an object from one type to another.
4
+
5
+ ## Constructors
6
+
7
+ ### new Coerce()
8
+
9
+ > **new Coerce**(): [`Coerce`](Coerce.md)
10
+
11
+ #### Returns
12
+
13
+ [`Coerce`](Coerce.md)
14
+
15
+ ## Methods
16
+
17
+ ### string()
18
+
19
+ > `static` **string**(`value`): `undefined` \| `string`
20
+
21
+ Coerce the value to a string.
22
+
23
+ #### Parameters
24
+
25
+ • **value**: `unknown`
26
+
27
+ The value to coerce.
28
+
29
+ #### Returns
30
+
31
+ `undefined` \| `string`
32
+
33
+ The value if it can be coerced.
34
+
35
+ #### Throws
36
+
37
+ TypeError If the value can not be coerced.
38
+
39
+ ***
40
+
41
+ ### number()
42
+
43
+ > `static` **number**(`value`): `undefined` \| `number`
44
+
45
+ Coerce the value to a number.
46
+
47
+ #### Parameters
48
+
49
+ • **value**: `unknown`
50
+
51
+ The value to coerce.
52
+
53
+ #### Returns
54
+
55
+ `undefined` \| `number`
56
+
57
+ The value if it can be coerced.
58
+
59
+ #### Throws
60
+
61
+ TypeError If the value can not be coerced.
62
+
63
+ ***
64
+
65
+ ### bigint()
66
+
67
+ > `static` **bigint**(`value`): `undefined` \| `bigint`
68
+
69
+ Coerce the value to a bigint.
70
+
71
+ #### Parameters
72
+
73
+ • **value**: `unknown`
74
+
75
+ The value to coerce.
76
+
77
+ #### Returns
78
+
79
+ `undefined` \| `bigint`
80
+
81
+ The value if it can be coerced.
82
+
83
+ #### Throws
84
+
85
+ TypeError If the value can not be coerced.
86
+
87
+ ***
88
+
89
+ ### boolean()
90
+
91
+ > `static` **boolean**(`value`): `undefined` \| `boolean`
92
+
93
+ Coerce the value to a boolean.
94
+
95
+ #### Parameters
96
+
97
+ • **value**: `unknown`
98
+
99
+ The value to coerce.
100
+
101
+ #### Returns
102
+
103
+ `undefined` \| `boolean`
104
+
105
+ The value if it can be coerced.
106
+
107
+ #### Throws
108
+
109
+ TypeError If the value can not be coerced.
110
+
111
+ ***
112
+
113
+ ### date()
114
+
115
+ > `static` **date**(`value`): `undefined` \| `Date`
116
+
117
+ Coerce the value to a date.
118
+
119
+ #### Parameters
120
+
121
+ • **value**: `unknown`
122
+
123
+ The value to coerce.
124
+
125
+ #### Returns
126
+
127
+ `undefined` \| `Date`
128
+
129
+ The value if it can be coerced.
130
+
131
+ #### Throws
132
+
133
+ TypeError If the value can not be coerced.
134
+
135
+ ***
136
+
137
+ ### dateTime()
138
+
139
+ > `static` **dateTime**(`value`): `undefined` \| `Date`
140
+
141
+ Coerce the value to a date/time.
142
+
143
+ #### Parameters
144
+
145
+ • **value**: `unknown`
146
+
147
+ The value to coerce.
148
+
149
+ #### Returns
150
+
151
+ `undefined` \| `Date`
152
+
153
+ The value if it can be coerced.
154
+
155
+ #### Throws
156
+
157
+ TypeError If the value can not be coerced.
158
+
159
+ ***
160
+
161
+ ### time()
162
+
163
+ > `static` **time**(`value`): `undefined` \| `Date`
164
+
165
+ Coerce the value to a time.
166
+
167
+ #### Parameters
168
+
169
+ • **value**: `unknown`
170
+
171
+ The value to coerce.
172
+
173
+ #### Returns
174
+
175
+ `undefined` \| `Date`
176
+
177
+ The value if it can be coerced.
178
+
179
+ #### Throws
180
+
181
+ TypeError If the value can not be coerced.
182
+
183
+ ***
184
+
185
+ ### object()
186
+
187
+ > `static` **object**\<`T`\>(`value`): `undefined` \| `T`
188
+
189
+ Coerce the value to an object.
190
+
191
+ #### Type Parameters
192
+
193
+ • **T** = `unknown`
194
+
195
+ #### Parameters
196
+
197
+ • **value**: `unknown`
198
+
199
+ The value to coerce.
200
+
201
+ #### Returns
202
+
203
+ `undefined` \| `T`
204
+
205
+ The value if it can be coerced.
206
+
207
+ #### Throws
208
+
209
+ TypeError If the value can not be coerced.
@@ -0,0 +1,61 @@
1
+ # Class: Compression
2
+
3
+ A class to handle compression.
4
+
5
+ ## Constructors
6
+
7
+ ### new Compression()
8
+
9
+ > **new Compression**(): [`Compression`](Compression.md)
10
+
11
+ #### Returns
12
+
13
+ [`Compression`](Compression.md)
14
+
15
+ ## Methods
16
+
17
+ ### compress()
18
+
19
+ > `static` **compress**(`bytes`, `type`): `Promise`\<`Uint8Array`\>
20
+
21
+ Compress bytes using GZIP.
22
+
23
+ #### Parameters
24
+
25
+ • **bytes**: `Uint8Array`
26
+
27
+ The bytes to compress.
28
+
29
+ • **type**: [`CompressionType`](../type-aliases/CompressionType.md)
30
+
31
+ The type of compression to use.
32
+
33
+ #### Returns
34
+
35
+ `Promise`\<`Uint8Array`\>
36
+
37
+ The compressed bytes.
38
+
39
+ ***
40
+
41
+ ### decompress()
42
+
43
+ > `static` **decompress**(`compressedBytes`, `type`): `Promise`\<`Uint8Array`\>
44
+
45
+ Decompress a gzipped compressed byte array.
46
+
47
+ #### Parameters
48
+
49
+ • **compressedBytes**: `Uint8Array`
50
+
51
+ The compressed bytes.
52
+
53
+ • **type**: [`CompressionType`](../type-aliases/CompressionType.md)
54
+
55
+ The type of compression to use.
56
+
57
+ #### Returns
58
+
59
+ `Promise`\<`Uint8Array`\>
60
+
61
+ The decompressed bytes.