@xyo-network/xl1-protocol-sdk 1.30.2 → 1.30.4

package/dist/neutral/primitives/datalake/NamedDataLake.d.ts

@@ -0,0 +1,7 @@
+import type { DataLakeViewerMethods } from '@xyo-network/xl1-protocol-lib';
+/** A datalake registered with a caller-supplied name for provenance tracking. */
+export interface NamedDataLake {
+    name: string;
+    viewer: DataLakeViewerMethods;
+}
+//# sourceMappingURL=NamedDataLake.d.ts.map

package/dist/neutral/primitives/datalake/NamedDataLake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamedDataLake.d.ts","sourceRoot":"","sources":["../../../../src/primitives/datalake/NamedDataLake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAE1E,iFAAiF;AACjF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,qBAAqB,CAAA;CAC9B"}

package/dist/neutral/primitives/datalake/PayloadLocator.d.ts

@@ -0,0 +1,55 @@
+import type { Hash } from '@xylabs/sdk-js';
+import type { Payload } from '@xyo-network/sdk-js';
+import type { NamedDataLake } from './NamedDataLake.ts';
+/** A payload paired with the name of the datalake that served it. */
+export interface PayloadLocation {
+    payload: Payload;
+    source: string;
+}
+/** Parameters for PayloadLocator. */
+export interface PayloadLocatorParams {
+    datalakes: readonly NamedDataLake[];
+}
+/**
+ * Stateless multi-datalake fetch orchestration.
+ *
+ * Given hash(es) and a list of named datalakes, finds where each hash lives.
+ * Filters non-Payload datalake entries (e.g. ArrayBuffer) — use a binary-aware locator
+ * if you need those.
+ *
+ * No caching: callers that want caching should wrap this (see BoundWitnessHydrator for
+ * one example of wrapping with an LRU).
+ */
+export declare class PayloadLocator {
+    protected readonly datalakes: readonly NamedDataLake[];
+    /**
+     * @throws if `params.datalakes` is empty. Required at construction to fail fast on misconfig.
+     *   The only zero-datalake calls that wouldn't already throw are degenerate (no hashes input),
+     *   not load-bearing enough to justify loosening the guard.
+     */
+    constructor(params: PayloadLocatorParams);
+    /**
+     * Exhaustive: queries every datalake for the hash(es). Does NOT short-circuit.
+     *
+     * Scalar form returns an array with one `PayloadLocation` per datalake that has the hash
+     * (in registration order; empty if no datalake had it).
+     * Batch form returns a Map keyed by input hash, value is the same per-hash array.
+     */
+    findAll(hash: Hash): Promise<PayloadLocation[]>;
+    findAll(hashes: readonly Hash[]): Promise<Map<Hash, PayloadLocation[]>>;
+    /**
+     * First-found across datalakes in registration order. Short-circuits per hash:
+     * once a hash is located in datalake N, later datalakes are not queried for it.
+     *
+     * Scalar form returns the single PayloadLocation (or `undefined` if no datalake had it).
+     * Batch form returns a Map keyed by input hash, preserving insertion order. Missing
+     * hashes are simply absent from the map.
+     */
+    findFirst(hash: Hash): Promise<PayloadLocation | undefined>;
+    findFirst(hashes: readonly Hash[]): Promise<Map<Hash, PayloadLocation>>;
+    /** Fetch a single hash from a single datalake, filtering non-Payload entries. */
+    protected fetchOne(dl: NamedDataLake, hash: Hash): Promise<Payload | undefined>;
+    protected findAllBatch(hashes: readonly Hash[]): Promise<Map<Hash, PayloadLocation[]>>;
+    protected findFirstBatch(hashes: readonly Hash[]): Promise<Map<Hash, PayloadLocation>>;
+}
+//# sourceMappingURL=PayloadLocator.d.ts.map

package/dist/neutral/primitives/datalake/PayloadLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PayloadLocator.d.ts","sourceRoot":"","sources":["../../../../src/primitives/datalake/PayloadLocator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAGlD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,qEAAqE;AACrE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,qCAAqC;AACrC,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAA;CACpC;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAA;IAEtD;;;;OAIG;gBACS,MAAM,EAAE,oBAAoB;IAUxC;;;;;;OAMG;IACH,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IAC/C,OAAO,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;IAWvE;;;;;;;OAOG;IACH,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC;IAC3D,SAAS,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IAWvE,iFAAiF;cACjE,QAAQ,CAAC,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;cAQrE,YAAY,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;cAe5E,cAAc,CAAC,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;CAkB7F"}

package/dist/neutral/primitives/datalake/index.d.ts

@@ -1,3 +1,5 @@
 export * from './addDataLakePayloads.ts';
 export * from './addDataLakePayloadsToPayloads.ts';
+export * from './NamedDataLake.ts';
+export * from './PayloadLocator.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/neutral/primitives/datalake/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/primitives/datalake/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,oCAAoC,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/primitives/datalake/index.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA;AACxC,cAAc,oCAAoC,CAAA;AAClD,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/xl1-protocol-sdk",
-  "version": "1.30.2",
+  "version": "1.30.4",
   "description": "XYO Layer One SDK Protocol",
   "homepage": "https://xylabs.com",
   "bugs": {
@@ -42,9 +42,9 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/xl1-protocol-model": "~1.30.2",
-    "@xyo-network/xl1-protocol-lib": "~1.30.2",
-    "@xyo-network/xl1-schema": "~1.30.2"
+    "@xyo-network/xl1-protocol-lib": "~1.30.4",
+    "@xyo-network/xl1-protocol-model": "~1.30.4",
+    "@xyo-network/xl1-schema": "~1.30.4"
   },
   "devDependencies": {
     "@bitauth/libauth": "~3.0.0",
@@ -102,7 +102,7 @@
     "wasm-feature-detect": "~1.8.0",
     "webextension-polyfill": "^0.12.0",
     "zod": "~4.4.3",
-    "@xyo-network/xl1-network-model": "~1.30.2"
+    "@xyo-network/xl1-network-model": "~1.30.4"
   },
   "peerDependencies": {
     "@bitauth/libauth": "~3.0",