@xyo-network/xl1-providers 1.26.39 → 1.26.41

package/dist/browser/creators/createRestDataLake.d.ts

@@ -0,0 +1,32 @@
+import type { RestDataLakeViewerParams } from '@xyo-network/xl1-protocol-sdk';
+import { RestDataLakeRunner, RestDataLakeViewer } from '@xyo-network/xl1-protocol-sdk';
+/**
+ * Creates a read-only {@link RestDataLakeViewer} bound to the given REST
+ * endpoint, using a default {@link BaseConfig} context (see
+ * {@link baseConfigFactoryLocator}). The viewer is the only provider
+ * registered on the underlying locator, which is then frozen before the
+ * instance is resolved and returned.
+ *
+ * Use this for read-only data-lake access (e.g. `get(hashes)`) when you don't
+ * need a full actor or remote-RPC stack — only protocol defaults plus the
+ * data-lake endpoint.
+ *
+ * @param dataLakeEndpoint - Base URL of the REST data lake (e.g.
+ *   `https://beta.api.archivist.xyo.network/dataLake`).
+ */
+export declare function createRestDataLakeViewer(dataLakeEndpoint: string): Promise<import("@xyo-network/xl1-protocol-sdk").CreatableProviderInstance<RestDataLakeViewer<RestDataLakeViewerParams>>>;
+/**
+ * Creates a read-write {@link RestDataLakeRunner} bound to the given REST
+ * endpoint, using a default {@link BaseConfig} context (see
+ * {@link baseConfigFactoryLocator}). The runner is the only provider
+ * registered on the underlying locator, which is then frozen before the
+ * instance is resolved and returned.
+ *
+ * Use this when you need to insert payloads into the data lake in addition to
+ * reading them, without spinning up a full actor or remote-RPC stack.
+ *
+ * @param dataLakeEndpoint - Base URL of the REST data lake (e.g.
+ *   `https://beta.api.archivist.xyo.network/dataLake`).
+ */
+export declare function createRestDataLakeRunner(dataLakeEndpoint: string): Promise<import("@xyo-network/xl1-protocol-sdk").CreatableProviderInstance<RestDataLakeRunner<RestDataLakeViewerParams>>>;
+//# sourceMappingURL=createRestDataLake.d.ts.map

package/dist/browser/creators/createRestDataLake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createRestDataLake.d.ts","sourceRoot":"","sources":["../../../src/creators/createRestDataLake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAA;AAItF;;;;;;;;;;;;;GAaG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,EAAE,MAAM,4HAUzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,gBAAgB,EAAE,MAAM,4HAUzB"}

package/dist/browser/creators/index.d.ts

@@ -0,0 +1,2 @@
+export * from './createRestDataLake.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/creators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/creators/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAA"}

package/dist/browser/index.d.ts

@@ -1,6 +1,7 @@
 export * from './buildProviderLocator.ts';
 export * from './buildProviderLocatorV2.ts';
 export * from './buildSimpleXyoSignerV2.ts';
+export * from './creators/index.ts';
 export * from './locators/index.ts';
 export * from './NodeXyoRunner.ts';
 export * from './NodeXyoViewer.ts';

package/dist/browser/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA;AAClC,cAAc,sBAAsB,CAAA;AACpC,cAAc,kCAAkC,CAAA;AAChD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA"}

package/dist/browser/index.mjs

@@ -1327,10 +1327,27 @@ async function buildSimpleXyoSignerV2(context, account) {
   return await locator.getInstance(XyoSignerMoniker);
 }
 
+// src/creators/createRestDataLake.ts
+import { RestDataLakeRunner, RestDataLakeViewer as RestDataLakeViewer3 } from "@xyo-network/xl1-protocol-sdk";
+
+// src/locators/baseConfigFactoryLocator.ts
+import {
+  BaseConfigZod,
+  ProviderFactoryLocator as ProviderFactoryLocator4
+} from "@xyo-network/xl1-protocol-sdk";
+async function baseConfigFactoryLocator() {
+  const config = BaseConfigZod.parse({});
+  return new ProviderFactoryLocator4({
+    config,
+    singletons: {},
+    caches: {}
+  }, {});
+}
+
 // src/locators/basicRemoteRunnerLocator.ts
 import { isDefined as isDefined2 } from "@xylabs/sdk-js";
 import {
-  ProviderFactoryLocator as ProviderFactoryLocator7,
+  ProviderFactoryLocator as ProviderFactoryLocator8,
   RestDataLakeViewer as RestDataLakeViewer2,
   SimpleXyoGatewayRunner as SimpleXyoGatewayRunner2
 } from "@xyo-network/xl1-protocol-sdk";
@@ -1340,7 +1357,7 @@ import { JsonRpcXyoRunner as JsonRpcXyoRunner3, JsonRpcXyoSigner } from "@xyo-ne
 import { isDefined } from "@xylabs/sdk-js";
 import {
   ActorConfigZod,
-  ProviderFactoryLocator as ProviderFactoryLocator6,
+  ProviderFactoryLocator as ProviderFactoryLocator7,
   RestDataLakeViewer,
   SimpleTransactionViewer as SimpleTransactionViewer2,
   SimpleXyoGateway as SimpleXyoGateway2
@@ -1386,7 +1403,7 @@ SimpleXyoConnectionViewer = __decorateClass([
 
 // src/locators/commonLocatorFromConfig.ts
 import {
-  ProviderFactoryLocator as ProviderFactoryLocator4,
+  ProviderFactoryLocator as ProviderFactoryLocator5,
   SimpleBlockRewardViewer,
   SimpleTimeSyncViewer as SimpleTimeSyncViewer3,
   SimpleTransactionValidationViewer,
@@ -1394,7 +1411,7 @@ import {
   SimpleWindowedBlockViewer as SimpleWindowedBlockViewer3
 } from "@xyo-network/xl1-protocol-sdk";
 function commonLocatorFromConfig(context, validateDepsOnRegister = false) {
-  const locator = new ProviderFactoryLocator4(context, {}, validateDepsOnRegister);
+  const locator = new ProviderFactoryLocator5(context, {}, validateDepsOnRegister);
   locator.registerMany([
     SimpleNetworkStakeViewer.factory(SimpleNetworkStakeViewer.dependencies, {}),
     SimpleTimeSyncViewer3.factory(SimpleTimeSyncViewer3.dependencies, {}),
@@ -1414,7 +1431,7 @@ function commonLocatorFromConfig(context, validateDepsOnRegister = false) {
 
 // src/locators/remoteLocatorFromConfig.ts
 import {
-  ProviderFactoryLocator as ProviderFactoryLocator5,
+  ProviderFactoryLocator as ProviderFactoryLocator6,
   SimpleBlockValidationViewer,
   SimpleStakeEventsViewer as SimpleStakeEventsViewer3
 } from "@xyo-network/xl1-protocol-sdk";
@@ -1430,7 +1447,7 @@ import {
   JsonRpcXyoViewer as JsonRpcXyoViewer3
 } from "@xyo-network/xl1-rpc";
 function remoteLocatorFromConfig(context, validateDepsOnRegister = false, validators) {
-  const locator = new ProviderFactoryLocator5(context, {}, validateDepsOnRegister);
+  const locator = new ProviderFactoryLocator6(context, {}, validateDepsOnRegister);
   locator.registerMany([
     JsonRpcMempoolViewer3.factory(JsonRpcMempoolViewer3.dependencies, {}),
     JsonRpcMempoolRunner3.factory(JsonRpcMempoolRunner3.dependencies, {}),
@@ -1459,7 +1476,7 @@ async function basicRemoteViewerLocator(name, remoteConfig, dataLakeEndpoint, op
     caches: {}
   });
   const remoteLocator = await remoteLocatorFromConfig(rootLocator.context, false, options?.validators);
-  const locator = new ProviderFactoryLocator6(remoteLocator.context, {});
+  const locator = new ProviderFactoryLocator7(remoteLocator.context, {});
   locator.registerMany([
     SimpleXyoGateway2.factory(SimpleXyoGateway2.dependencies, {}),
     SimpleXyoConnectionViewer.factory(SimpleXyoConnectionViewer.dependencies, {}),
@@ -1477,7 +1494,7 @@ async function basicRemoteViewerLocator(name, remoteConfig, dataLakeEndpoint, op
 // src/locators/basicRemoteRunnerLocator.ts
 async function basicRemoteRunnerLocator(name, remoteConfig, signerTransport, dataLakeEndpoint, options) {
   const remoteViewerLocator = await basicRemoteViewerLocator(name, remoteConfig, dataLakeEndpoint, options);
-  const locator = new ProviderFactoryLocator7(remoteViewerLocator.context, {});
+  const locator = new ProviderFactoryLocator8(remoteViewerLocator.context, {});
   const providers = [
     SimpleXyoConnectionRunner.factory(SimpleXyoConnectionRunner.dependencies, {}),
     JsonRpcXyoRunner3.factory(JsonRpcXyoRunner3.dependencies, {})
@@ -1517,6 +1534,22 @@ async function rootLocatorFromConfig(context, validateDepsOnRegister = false, va
   return locator;
 }
 
+// src/creators/createRestDataLake.ts
+async function createRestDataLakeViewer(dataLakeEndpoint) {
+  const locator = await baseConfigFactoryLocator();
+  const dataLakeViewerParams = { endpoint: dataLakeEndpoint };
+  locator.register(RestDataLakeViewer3.factory(RestDataLakeViewer3.dependencies, dataLakeViewerParams));
+  locator.freeze();
+  return await locator.getInstance(RestDataLakeViewer3.defaultMoniker);
+}
+async function createRestDataLakeRunner(dataLakeEndpoint) {
+  const locator = await baseConfigFactoryLocator();
+  const dataLakeRunnerParams = { endpoint: dataLakeEndpoint };
+  locator.register(RestDataLakeRunner.factory(RestDataLakeRunner.dependencies, dataLakeRunnerParams));
+  locator.freeze();
+  return await locator.getInstance(RestDataLakeRunner.defaultMoniker);
+}
+
 // src/NodeXyoRunner.ts
 import { assertEx as assertEx6 } from "@xylabs/sdk-js";
 import { asArchivistInstance } from "@xyo-network/sdk-js";
@@ -1782,6 +1815,7 @@ export {
   SimpleXyoConnectionRunner,
   SimpleXyoConnectionViewer,
   SimpleXyoViewer,
+  baseConfigFactoryLocator,
   basicRemoteRunnerLocator,
   basicRemoteViewerLocator,
   buildEmptyProviderLocator,
@@ -1794,6 +1828,8 @@ export {
   buildSimpleProviderLocatorV2,
   buildSimpleXyoSignerV2,
   commonLocatorFromConfig,
+  createRestDataLakeRunner,
+  createRestDataLakeViewer,
   registerGatewayRunnerWithLocatorIfProvided,
   registerGatewayWithLocator,
   registerSimpleStakeViewerWithLocator,