@xylabs/base 4.13.19 → 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 CHANGED
@@ -12,13 +12,453 @@
12
12
  [![snyk-badge][]][snyk-link]
13
13
  [![socket-badge][]][socket-link]
14
14
 
15
- Version: 4.13.15
16
15
 
17
- Primary SDK for using XYO Protocol 2.0
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.19",
4
- "description": "Primary SDK for using XYO Protocol 2.0",
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",
@@ -22,21 +22,27 @@
22
22
  "exports": {
23
23
  ".": {
24
24
  "types": "./dist/neutral/index.d.ts",
25
+ "source": "./src/index.ts",
25
26
  "default": "./dist/neutral/index.mjs"
26
27
  },
27
28
  "./package.json": "./package.json"
28
29
  },
29
- "module": "dist/neutral/index.mjs",
30
- "types": "dist/neutral/index.d.ts",
30
+ "module": "./dist/neutral/index.mjs",
31
+ "source": "./src/index.ts",
32
+ "types": "./dist/neutral/index.d.ts",
33
+ "files": [
34
+ "dist",
35
+ "src"
36
+ ],
31
37
  "dependencies": {
32
38
  "@opentelemetry/api": "^1.9.0",
33
- "@xylabs/assert": "^4.13.19",
34
- "@xylabs/logger": "^4.13.19",
35
- "@xylabs/object": "^4.13.19"
39
+ "@xylabs/assert": "^4.13.21",
40
+ "@xylabs/logger": "^4.13.21",
41
+ "@xylabs/object": "^4.13.21"
36
42
  },
37
43
  "devDependencies": {
38
- "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.27",
39
- "@xylabs/tsconfig": "^7.0.0-rc.27",
44
+ "@xylabs/ts-scripts-yarn3": "^7.0.0",
45
+ "@xylabs/tsconfig": "^7.0.0",
40
46
  "tslib": "^2.8.1",
41
47
  "typescript": "^5.8.3"
42
48
  },
package/typedoc.json DELETED
@@ -1,5 +0,0 @@
1
- {
2
- "$schema": "https://typedoc.org/schema.json",
3
- "entryPoints": ["./src/index.ts"],
4
- "tsconfig": "./tsconfig.typedoc.json"
5
- }
package/xy.config.ts DELETED
@@ -1,10 +0,0 @@
1
- import type { XyTsupConfig } from '@xylabs/ts-scripts-yarn3'
2
- const config: XyTsupConfig = {
3
- compile: {
4
- browser: {},
5
- neutral: { src: true },
6
- node: {},
7
- },
8
- }
9
-
10
- export default config