@xylabs/base 4.13.20 → 4.13.21
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 +444 -4
- package/package.json +5 -5
package/README.md
CHANGED
|
@@ -12,13 +12,453 @@
|
|
|
12
12
|
[![snyk-badge][]][snyk-link]
|
|
13
13
|
[![socket-badge][]][socket-link]
|
|
14
14
|
|
|
15
|
-
Version: 4.13.19
|
|
16
15
|
|
|
17
|
-
|
|
16
|
+
Base functionality used throughout XY Labs TypeScript/JavaScript libraries
|
|
18
17
|
|
|
19
|
-
## Documentation
|
|
18
|
+
## API Documentation
|
|
19
|
+
|
|
20
|
+
**@xylabs/base**
|
|
21
|
+
|
|
22
|
+
***
|
|
23
|
+
|
|
24
|
+
## Classes
|
|
25
|
+
|
|
26
|
+
- [Base](#classes/Base)
|
|
27
|
+
|
|
28
|
+
## Type Aliases
|
|
29
|
+
|
|
30
|
+
- [BaseClassName](#type-aliases/BaseClassName)
|
|
31
|
+
- [BaseParamsFields](#type-aliases/BaseParamsFields)
|
|
32
|
+
- [BaseParams](#type-aliases/BaseParams)
|
|
33
|
+
|
|
34
|
+
## Functions
|
|
35
|
+
|
|
36
|
+
- [disableGloballyUnique](#functions/disableGloballyUnique)
|
|
37
|
+
- [globallyUnique](#functions/globallyUnique)
|
|
38
|
+
|
|
39
|
+
### classes
|
|
40
|
+
|
|
41
|
+
### <a id="Base"></a>Base
|
|
42
|
+
|
|
43
|
+
[**@xylabs/base**](#../README)
|
|
44
|
+
|
|
45
|
+
***
|
|
46
|
+
|
|
47
|
+
## Type Parameters
|
|
48
|
+
|
|
49
|
+
### TParams
|
|
50
|
+
|
|
51
|
+
`TParams` *extends* [`BaseParams`](#../type-aliases/BaseParams) = [`BaseParams`](#../type-aliases/BaseParams)
|
|
52
|
+
|
|
53
|
+
## Constructors
|
|
54
|
+
|
|
55
|
+
### Constructor
|
|
56
|
+
|
|
57
|
+
```ts
|
|
58
|
+
new Base<TParams>(params): Base<TParams>;
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Parameters
|
|
62
|
+
|
|
63
|
+
#### params
|
|
64
|
+
|
|
65
|
+
[`BaseParams`](#../type-aliases/BaseParams)\<`TParams`\>
|
|
66
|
+
|
|
67
|
+
### Returns
|
|
68
|
+
|
|
69
|
+
`Base`\<`TParams`\>
|
|
70
|
+
|
|
71
|
+
## Properties
|
|
72
|
+
|
|
73
|
+
### defaultLogger?
|
|
74
|
+
|
|
75
|
+
```ts
|
|
76
|
+
static optional defaultLogger: Logger;
|
|
77
|
+
```
|
|
78
|
+
|
|
79
|
+
***
|
|
80
|
+
|
|
81
|
+
### globalInstances
|
|
82
|
+
|
|
83
|
+
```ts
|
|
84
|
+
readonly static globalInstances: Record<BaseClassName, WeakRef<Base>[]> = {};
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
***
|
|
88
|
+
|
|
89
|
+
### globalInstancesCountHistory
|
|
90
|
+
|
|
91
|
+
```ts
|
|
92
|
+
readonly static globalInstancesCountHistory: Record<BaseClassName, number[]> = {};
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
***
|
|
96
|
+
|
|
97
|
+
### uniqueName
|
|
98
|
+
|
|
99
|
+
```ts
|
|
100
|
+
readonly static uniqueName: string;
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
## Accessors
|
|
104
|
+
|
|
105
|
+
### historyInterval
|
|
106
|
+
|
|
107
|
+
### Get Signature
|
|
108
|
+
|
|
109
|
+
```ts
|
|
110
|
+
get static historyInterval(): number;
|
|
111
|
+
```
|
|
112
|
+
|
|
113
|
+
#### Returns
|
|
114
|
+
|
|
115
|
+
`number`
|
|
116
|
+
|
|
117
|
+
### Set Signature
|
|
118
|
+
|
|
119
|
+
```ts
|
|
120
|
+
set static historyInterval(value): void;
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
#### Parameters
|
|
124
|
+
|
|
125
|
+
##### value
|
|
126
|
+
|
|
127
|
+
`number`
|
|
128
|
+
|
|
129
|
+
#### Returns
|
|
130
|
+
|
|
131
|
+
`void`
|
|
132
|
+
|
|
133
|
+
***
|
|
134
|
+
|
|
135
|
+
### historyTime
|
|
136
|
+
|
|
137
|
+
### Get Signature
|
|
138
|
+
|
|
139
|
+
```ts
|
|
140
|
+
get static historyTime(): number;
|
|
141
|
+
```
|
|
142
|
+
|
|
143
|
+
#### Returns
|
|
144
|
+
|
|
145
|
+
`number`
|
|
146
|
+
|
|
147
|
+
### Set Signature
|
|
148
|
+
|
|
149
|
+
```ts
|
|
150
|
+
set static historyTime(value): void;
|
|
151
|
+
```
|
|
152
|
+
|
|
153
|
+
#### Parameters
|
|
154
|
+
|
|
155
|
+
##### value
|
|
156
|
+
|
|
157
|
+
`number`
|
|
158
|
+
|
|
159
|
+
#### Returns
|
|
160
|
+
|
|
161
|
+
`void`
|
|
162
|
+
|
|
163
|
+
***
|
|
164
|
+
|
|
165
|
+
### maxGcFrequency
|
|
166
|
+
|
|
167
|
+
### Get Signature
|
|
168
|
+
|
|
169
|
+
```ts
|
|
170
|
+
get static maxGcFrequency(): number;
|
|
171
|
+
```
|
|
172
|
+
|
|
173
|
+
#### Returns
|
|
174
|
+
|
|
175
|
+
`number`
|
|
176
|
+
|
|
177
|
+
### Set Signature
|
|
178
|
+
|
|
179
|
+
```ts
|
|
180
|
+
set static maxGcFrequency(value): void;
|
|
181
|
+
```
|
|
182
|
+
|
|
183
|
+
#### Parameters
|
|
184
|
+
|
|
185
|
+
##### value
|
|
186
|
+
|
|
187
|
+
`number`
|
|
188
|
+
|
|
189
|
+
#### Returns
|
|
190
|
+
|
|
191
|
+
`void`
|
|
192
|
+
|
|
193
|
+
***
|
|
194
|
+
|
|
195
|
+
### maxHistoryDepth
|
|
196
|
+
|
|
197
|
+
### Get Signature
|
|
198
|
+
|
|
199
|
+
```ts
|
|
200
|
+
get static maxHistoryDepth(): number;
|
|
201
|
+
```
|
|
202
|
+
|
|
203
|
+
#### Returns
|
|
204
|
+
|
|
205
|
+
`number`
|
|
206
|
+
|
|
207
|
+
***
|
|
208
|
+
|
|
209
|
+
### logger
|
|
210
|
+
|
|
211
|
+
### Get Signature
|
|
212
|
+
|
|
213
|
+
```ts
|
|
214
|
+
get logger(): undefined | Logger;
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
#### Returns
|
|
218
|
+
|
|
219
|
+
`undefined` \| `Logger`
|
|
220
|
+
|
|
221
|
+
***
|
|
222
|
+
|
|
223
|
+
### meter
|
|
224
|
+
|
|
225
|
+
### Get Signature
|
|
226
|
+
|
|
227
|
+
```ts
|
|
228
|
+
get meter(): undefined | Meter;
|
|
229
|
+
```
|
|
230
|
+
|
|
231
|
+
#### Returns
|
|
232
|
+
|
|
233
|
+
`undefined` \| `Meter`
|
|
234
|
+
|
|
235
|
+
***
|
|
236
|
+
|
|
237
|
+
### params
|
|
238
|
+
|
|
239
|
+
### Get Signature
|
|
240
|
+
|
|
241
|
+
```ts
|
|
242
|
+
get params(): BaseParams<TParams>;
|
|
243
|
+
```
|
|
244
|
+
|
|
245
|
+
#### Returns
|
|
246
|
+
|
|
247
|
+
[`BaseParams`](#../type-aliases/BaseParams)\<`TParams`\>
|
|
248
|
+
|
|
249
|
+
***
|
|
250
|
+
|
|
251
|
+
### tracer
|
|
252
|
+
|
|
253
|
+
### Get Signature
|
|
254
|
+
|
|
255
|
+
```ts
|
|
256
|
+
get tracer(): undefined | Tracer;
|
|
257
|
+
```
|
|
258
|
+
|
|
259
|
+
#### Returns
|
|
260
|
+
|
|
261
|
+
`undefined` \| `Tracer`
|
|
262
|
+
|
|
263
|
+
## Methods
|
|
264
|
+
|
|
265
|
+
### gc()
|
|
266
|
+
|
|
267
|
+
### Call Signature
|
|
268
|
+
|
|
269
|
+
```ts
|
|
270
|
+
static gc(force?): void;
|
|
271
|
+
```
|
|
272
|
+
|
|
273
|
+
#### Parameters
|
|
274
|
+
|
|
275
|
+
##### force?
|
|
276
|
+
|
|
277
|
+
`boolean`
|
|
278
|
+
|
|
279
|
+
#### Returns
|
|
280
|
+
|
|
281
|
+
`void`
|
|
282
|
+
|
|
283
|
+
### Call Signature
|
|
284
|
+
|
|
285
|
+
```ts
|
|
286
|
+
static gc(className): void;
|
|
287
|
+
```
|
|
288
|
+
|
|
289
|
+
#### Parameters
|
|
290
|
+
|
|
291
|
+
##### className
|
|
292
|
+
|
|
293
|
+
`string`
|
|
294
|
+
|
|
295
|
+
#### Returns
|
|
296
|
+
|
|
297
|
+
`void`
|
|
298
|
+
|
|
299
|
+
***
|
|
300
|
+
|
|
301
|
+
### instanceCount()
|
|
302
|
+
|
|
303
|
+
```ts
|
|
304
|
+
static instanceCount(className): number;
|
|
305
|
+
```
|
|
306
|
+
|
|
307
|
+
### Parameters
|
|
308
|
+
|
|
309
|
+
#### className
|
|
310
|
+
|
|
311
|
+
`string`
|
|
312
|
+
|
|
313
|
+
### Returns
|
|
314
|
+
|
|
315
|
+
`number`
|
|
316
|
+
|
|
317
|
+
***
|
|
318
|
+
|
|
319
|
+
### instanceCounts()
|
|
320
|
+
|
|
321
|
+
```ts
|
|
322
|
+
static instanceCounts(): Record<BaseClassName, number>;
|
|
323
|
+
```
|
|
324
|
+
|
|
325
|
+
### Returns
|
|
326
|
+
|
|
327
|
+
`Record`\<[`BaseClassName`](#../type-aliases/BaseClassName), `number`\>
|
|
328
|
+
|
|
329
|
+
***
|
|
330
|
+
|
|
331
|
+
### startHistory()
|
|
332
|
+
|
|
333
|
+
```ts
|
|
334
|
+
static startHistory(): void;
|
|
335
|
+
```
|
|
336
|
+
|
|
337
|
+
### Returns
|
|
338
|
+
|
|
339
|
+
`void`
|
|
340
|
+
|
|
341
|
+
***
|
|
342
|
+
|
|
343
|
+
### stopHistory()
|
|
344
|
+
|
|
345
|
+
```ts
|
|
346
|
+
static stopHistory(): void;
|
|
347
|
+
```
|
|
348
|
+
|
|
349
|
+
### Returns
|
|
350
|
+
|
|
351
|
+
`void`
|
|
352
|
+
|
|
353
|
+
### functions
|
|
354
|
+
|
|
355
|
+
### <a id="disableGloballyUnique"></a>disableGloballyUnique
|
|
356
|
+
|
|
357
|
+
[**@xylabs/base**](#../README)
|
|
358
|
+
|
|
359
|
+
***
|
|
360
|
+
|
|
361
|
+
```ts
|
|
362
|
+
function disableGloballyUnique(): void;
|
|
363
|
+
```
|
|
364
|
+
|
|
365
|
+
## Returns
|
|
366
|
+
|
|
367
|
+
`void`
|
|
368
|
+
|
|
369
|
+
### <a id="globallyUnique"></a>globallyUnique
|
|
370
|
+
|
|
371
|
+
[**@xylabs/base**](#../README)
|
|
372
|
+
|
|
373
|
+
***
|
|
374
|
+
|
|
375
|
+
```ts
|
|
376
|
+
function globallyUnique(
|
|
377
|
+
name,
|
|
378
|
+
value,
|
|
379
|
+
domain): string;
|
|
380
|
+
```
|
|
381
|
+
|
|
382
|
+
## Parameters
|
|
383
|
+
|
|
384
|
+
### name
|
|
385
|
+
|
|
386
|
+
`string`
|
|
387
|
+
|
|
388
|
+
### value
|
|
389
|
+
|
|
390
|
+
`unknown`
|
|
391
|
+
|
|
392
|
+
### domain
|
|
393
|
+
|
|
394
|
+
`string` = `'global'`
|
|
395
|
+
|
|
396
|
+
## Returns
|
|
397
|
+
|
|
398
|
+
`string`
|
|
399
|
+
|
|
400
|
+
### type-aliases
|
|
401
|
+
|
|
402
|
+
### <a id="BaseClassName"></a>BaseClassName
|
|
403
|
+
|
|
404
|
+
[**@xylabs/base**](#../README)
|
|
405
|
+
|
|
406
|
+
***
|
|
407
|
+
|
|
408
|
+
```ts
|
|
409
|
+
type BaseClassName = Exclude<string, "base-class-name-reserved-32546239486">;
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
### <a id="BaseParams"></a>BaseParams
|
|
413
|
+
|
|
414
|
+
[**@xylabs/base**](#../README)
|
|
415
|
+
|
|
416
|
+
***
|
|
417
|
+
|
|
418
|
+
```ts
|
|
419
|
+
type BaseParams<TAdditionalParams> = TAdditionalParams & BaseParamsFields;
|
|
420
|
+
```
|
|
421
|
+
|
|
422
|
+
## Type Parameters
|
|
423
|
+
|
|
424
|
+
### TAdditionalParams
|
|
425
|
+
|
|
426
|
+
`TAdditionalParams` *extends* `EmptyObject` = `EmptyObject`
|
|
427
|
+
|
|
428
|
+
### <a id="BaseParamsFields"></a>BaseParamsFields
|
|
429
|
+
|
|
430
|
+
[**@xylabs/base**](#../README)
|
|
431
|
+
|
|
432
|
+
***
|
|
433
|
+
|
|
434
|
+
```ts
|
|
435
|
+
type BaseParamsFields = object;
|
|
436
|
+
```
|
|
437
|
+
|
|
438
|
+
## Properties
|
|
439
|
+
|
|
440
|
+
### logger?
|
|
441
|
+
|
|
442
|
+
```ts
|
|
443
|
+
optional logger: Logger;
|
|
444
|
+
```
|
|
445
|
+
|
|
446
|
+
***
|
|
447
|
+
|
|
448
|
+
### meterProvider?
|
|
449
|
+
|
|
450
|
+
```ts
|
|
451
|
+
optional meterProvider: MeterProvider;
|
|
452
|
+
```
|
|
453
|
+
|
|
454
|
+
***
|
|
455
|
+
|
|
456
|
+
### traceProvider?
|
|
457
|
+
|
|
458
|
+
```ts
|
|
459
|
+
optional traceProvider: TracerProvider;
|
|
460
|
+
```
|
|
20
461
|
|
|
21
|
-
Coming Soon!
|
|
22
462
|
|
|
23
463
|
Part of [sdk-js](https://www.npmjs.com/package/@xyo-network/sdk-js)
|
|
24
464
|
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@xylabs/base",
|
|
3
|
-
"version": "4.13.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "4.13.21",
|
|
4
|
+
"description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
|
|
5
5
|
"homepage": "https://xyo.network",
|
|
6
6
|
"bugs": {
|
|
7
7
|
"url": "git+https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues",
|
|
@@ -36,9 +36,9 @@
|
|
|
36
36
|
],
|
|
37
37
|
"dependencies": {
|
|
38
38
|
"@opentelemetry/api": "^1.9.0",
|
|
39
|
-
"@xylabs/assert": "^4.13.
|
|
40
|
-
"@xylabs/logger": "^4.13.
|
|
41
|
-
"@xylabs/object": "^4.13.
|
|
39
|
+
"@xylabs/assert": "^4.13.21",
|
|
40
|
+
"@xylabs/logger": "^4.13.21",
|
|
41
|
+
"@xylabs/object": "^4.13.21"
|
|
42
42
|
},
|
|
43
43
|
"devDependencies": {
|
|
44
44
|
"@xylabs/ts-scripts-yarn3": "^7.0.0",
|