@xyo-network/xl1-protocol-sdk 1.30.3 → 1.30.4
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/neutral/block/hydrate/BoundWitnessHydrator.d.ts +8 -12
- package/dist/neutral/block/hydrate/BoundWitnessHydrator.d.ts.map +1 -1
- package/dist/neutral/index.mjs +357 -302
- package/dist/neutral/index.mjs.map +4 -4
- package/dist/neutral/primitives/datalake/NamedDataLake.d.ts +7 -0
- package/dist/neutral/primitives/datalake/NamedDataLake.d.ts.map +1 -0
- package/dist/neutral/primitives/datalake/PayloadLocator.d.ts +55 -0
- package/dist/neutral/primitives/datalake/PayloadLocator.d.ts.map +1 -0
- package/dist/neutral/primitives/datalake/index.d.ts +2 -0
- package/dist/neutral/primitives/datalake/index.d.ts.map +1 -1
- package/package.json +5 -5
|
@@ -1,15 +1,11 @@
|
|
|
1
1
|
import type { Hash } from '@xylabs/sdk-js';
|
|
2
2
|
import type { BoundWitness, Payload } from '@xyo-network/sdk-js';
|
|
3
|
-
import type { DataLakeViewerMethods } from '@xyo-network/xl1-protocol-lib';
|
|
4
3
|
import { LRUCache } from 'lru-cache';
|
|
4
|
+
import type { NamedDataLake } from '../../primitives/datalake/index.ts';
|
|
5
|
+
import { PayloadLocator } from '../../primitives/datalake/index.ts';
|
|
5
6
|
import type { HydrateFunction } from '../../utils/index.ts';
|
|
6
7
|
/** Valid recursion depths for BoundWitness hydration. */
|
|
7
8
|
export type HydrationDepth = 0 | 1 | 2;
|
|
8
|
-
/** A datalake registered with a caller-supplied name for provenance tracking. */
|
|
9
|
-
export interface NamedDataLake {
|
|
10
|
-
name: string;
|
|
11
|
-
viewer: DataLakeViewerMethods;
|
|
12
|
-
}
|
|
13
9
|
/** A function that validates and narrows an unknown value into a typed BoundWitness or hydrated tuple. */
|
|
14
10
|
export type ZodAsserter<T> = (value: unknown, assert: true) => T;
|
|
15
11
|
/** Parameters for BoundWitnessHydrator. */
|
|
@@ -29,16 +25,16 @@ export interface BoundWitnessHydratorParams<TBw extends BoundWitness, THydrated>
|
|
|
29
25
|
export declare class BoundWitnessHydrator<TBw extends BoundWitness, THydrated> {
|
|
30
26
|
protected readonly asBoundWitness: ZodAsserter<TBw>;
|
|
31
27
|
protected readonly asHydrated: ZodAsserter<THydrated>;
|
|
32
|
-
protected readonly datalakes: readonly NamedDataLake[];
|
|
33
28
|
protected readonly isNestedBoundWitness: (payload: Payload) => payload is BoundWitness;
|
|
29
|
+
protected readonly locator: PayloadLocator;
|
|
34
30
|
protected readonly payloadCache: LRUCache<Hash, Payload>;
|
|
35
31
|
protected readonly sourceCache: LRUCache<Hash, string>;
|
|
36
32
|
/**
|
|
37
|
-
* @throws if `params.datalakes` is empty. Required at construction
|
|
38
|
-
* The only zero-datalake hydrate calls that would succeed anyway are
|
|
39
|
-
* or a BW with empty payload_hashes) — not load-bearing enough to justify
|
|
40
|
-
* If lifecycle ordering ever requires construction before sources are wired,
|
|
41
|
-
* an `addDatalake()` mutator over removing this assertion.
|
|
33
|
+
* @throws if `params.datalakes` is empty (propagated from PayloadLocator). Required at construction
|
|
34
|
+
* to fail fast on misconfig. The only zero-datalake hydrate calls that would succeed anyway are
|
|
35
|
+
* degenerate (maxDepth=0 or a BW with empty payload_hashes) — not load-bearing enough to justify
|
|
36
|
+
* loosening the guard. If lifecycle ordering ever requires construction before sources are wired,
|
|
37
|
+
* prefer adding an `addDatalake()` mutator over removing this assertion.
|
|
42
38
|
*/
|
|
43
39
|
constructor(params: BoundWitnessHydratorParams<TBw, THydrated>);
|
|
44
40
|
hydrate(input: Hash | TBw, maxDepth?: HydrationDepth, minDepth?: HydrationDepth): Promise<THydrated>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"BoundWitnessHydrator.d.ts","sourceRoot":"","sources":["../../../../src/block/hydrate/BoundWitnessHydrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;
|
|
1
|
+
{"version":3,"file":"BoundWitnessHydrator.d.ts","sourceRoot":"","sources":["../../../../src/block/hydrate/BoundWitnessHydrator.ts"],"names":[],"mappings":"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"}
|