@xyo-network/xl1-protocol-sdk 4.0.2 → 4.0.4

package/dist/neutral/index.mjs

@@ -1703,7 +1703,7 @@ import {
 } from "@xylabs/sdk";
 import { globalRegistry as globalRegistry9, z as z14 } from "zod/mini";
 
-// src/config/Base.ts
+// src/config/LocatorConfigFields.ts
 import { z as z13 } from "zod/mini";
 
 // src/config/Chain.ts
@@ -1919,6 +1919,11 @@ var ProviderBindingConfigZod = z8.object({
     description: "Named connection from the top-level connections map",
     title: "providerBindings.connection",
     type: "string"
+  }),
+  provider: z8.string().optional().register(globalRegistry6, {
+    description: "Winning provider descriptor id when config is compile-resolved",
+    title: "providerBindings.provider",
+    type: "string"
   })
 }).describe("Provider connection binding");
 var ProviderBindingsConfigZod = z8.record(z8.string(), ProviderBindingConfigZod).default({});
@@ -2922,8 +2927,8 @@ var ValidationConfigZod = z12.object({
   })
 });
 
-// src/config/Base.ts
-var BaseConfigZod = z13.object({
+// src/config/LocatorConfigFields.ts
+var LocatorConfigFieldsZod = z13.strictObject({
   chain: z13._default(ChainConfigZod, ChainConfigZod.parse({})).check(z13.describe("Configuration for the chain")),
   log: z13._default(LogConfigZod, LogConfigZod.parse({})).check(z13.describe("Configuration for logging")),
   connections: z13._default(ConnectionsConfigZod, ConnectionsConfigZod.parse({})).check(z13.describe("Named connection profiles (rpc, rest, s3, lmdb, mongo, evm-rpc)")),
@@ -2932,13 +2937,25 @@ var BaseConfigZod = z13.object({
   telemetry: z13._default(TelemetryConfigZod, TelemetryConfigZod.parse({})).check(z13.describe("Configuration for telemetry")),
   validation: z13._default(ValidationConfigZod, ValidationConfigZod.parse({})).check(z13.describe("Configuration for validation"))
 });
+var LOCATOR_CONFIG_FIELD_KEYS = Object.keys(LocatorConfigFieldsZod.shape);
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseLocatorConfigFields(raw) {
+  const source = isRecord(raw) ? raw : {};
+  const section = {};
+  for (const key of LOCATOR_CONFIG_FIELD_KEYS) {
+    if (Object.hasOwn(source, key)) section[key] = source[key];
+  }
+  return LocatorConfigFieldsZod.parse(section);
+}
 
 // src/config/Actor.ts
 var AccountPathZod = z14.string().check(z14.regex(
   /^(m(\/\d+'?)+|\d+'?(\/\d+'?)*)$/,
   `Invalid BIP-32 derivation path. Use either an absolute path like "m/44'/60'/0'/0/0" or a relative path like "0", "0/1", or "44'/60'/0'/0/0".`
 ));
-var ActorConfigZod = z14.extend(BaseConfigZod, {
+var ActorConfigZod = z14.extend(LocatorConfigFieldsZod, {
   name: z14.string(),
   accountPath: z14.optional(AccountPathZod).register(globalRegistry9, {
     description: 'BIP-32 derivation path for the actor wallet. Absolute when it starts with "m/"; otherwise relative to the root wallet base path. Each actor must derive to a distinct path.',
@@ -2957,9 +2974,12 @@ var ActorsConfigZod = z15._default(
   []
 );
 
+// src/config/Base.ts
+var BaseConfigZod = LocatorConfigFieldsZod;
+
 // src/config/Config.ts
 import { globalRegistry as globalRegistry10, z as z16 } from "zod/mini";
-var ConfigZod = z16.extend(BaseConfigZod, {
+var ConfigZod = z16.extend(LocatorConfigFieldsZod, {
   actors: ActorsConfigZod,
   healthCheckPort: z16.optional(z16.coerce.number()).register(globalRegistry10, {
     description: "Port for the system-wide health, readiness, and liveness endpoints (/healthz, /livez, /readyz). Set to 0 to disable.",
@@ -3005,6 +3025,51 @@ var isHostActorConfig = zodIsFactory3(HostActorConfigZod);
 var asHostActorConfig = zodAsFactory4(HostActorConfigZod, "asHostActorConfig");
 var toHostActorConfig = zodToFactory3(HostActorConfigZod, "toHostActorConfig");
 
+// src/config/ResolvedLocatorConfig.ts
+function assertConnectionReferences(config) {
+  const connections = config.connections ?? {};
+  for (const [moniker, binding] of Object.entries(config.providerBindings ?? {})) {
+    const connectionName = binding?.connection;
+    if (connectionName === void 0 || connectionName === "") continue;
+    if (!Object.hasOwn(connections, connectionName)) {
+      throw new Error(
+        `Resolved locator config: providerBindings.${moniker}.connection references unknown connection "${connectionName}"`
+      );
+    }
+  }
+}
+function assertRequiredBindings(config, needs) {
+  for (const moniker of needs.required) {
+    const binding = config.providerBindings?.[moniker];
+    if (binding === void 0) {
+      throw new Error(
+        `Resolved locator config: missing providerBindings entry for required moniker "${moniker}"`
+      );
+    }
+  }
+}
+function assertResolvedLocatorConfig(raw, options = {}) {
+  const config = LocatorConfigFieldsZod.parse(raw);
+  assertConnectionReferences(config);
+  if (options.needs !== void 0) {
+    assertRequiredBindings(config, options.needs);
+  }
+  return config;
+}
+var ResolvedLocatorConfigZod = LocatorConfigFieldsZod.check((ctx) => {
+  try {
+    assertConnectionReferences(ctx.value);
+  } catch (error) {
+    if (error instanceof Error) {
+      ctx.issues.push({
+        code: "custom",
+        message: error.message,
+        input: ctx.value
+      });
+    }
+  }
+});
+
 // src/config/resolveRestConnectionEndpoint.ts
 import { assertEx as assertEx21, isDefined as isDefined14 } from "@xylabs/sdk";
 function asRestConnectionConfig(connection) {
@@ -3111,7 +3176,7 @@ import { z as z19 } from "zod/mini";
 var SystemStatusRunnerZod = z19.custom((val) => val !== null && val !== void 0 && typeof val === "object");
 var ProviderFactoryLocatorZod = z19.lazy(() => z19.custom((val) => val !== null && val !== void 0 && typeof val === "object" && "context" in val && "registry" in val));
 var BaseConfigContextZod = z19.extend(CachingContextZod, {
-  config: z19.looseObject(BaseConfigZod.shape),
+  config: z19.looseObject(LocatorConfigFieldsZod.shape),
   locator: z19.optional(ProviderFactoryLocatorZod)
 });
 var CreatableProviderContextZod = z19.lazy(() => z19.extend(BaseConfigContextZod, {
@@ -7962,6 +8027,7 @@ export {
   HydratedCache,
   JSONSchemaMetaSchema,
   LmdbConnectionConfigZod,
+  LocatorConfigFieldsZod,
   LoggerStatusReporter,
   MemoryArchivistFactory,
   MemoryConnectionConfigZod,
@@ -7984,6 +8050,7 @@ export {
   ProvidersConfigZod,
   REJECTED_BLOCKS_ARCHIVIST_ROLE,
   REJECTED_TRANSACTIONS_ARCHIVIST_ROLE,
+  ResolvedLocatorConfigZod,
   RestConnectionConfigZod,
   RestDataLakeRunner,
   RestDataLakeViewer,
@@ -8072,6 +8139,7 @@ export {
   asSchemasStepSummaryWithStorageMeta,
   asTransfersStepSummary,
   asTransfersStepSummaryWithStorageMeta,
+  assertResolvedLocatorConfig,
   backedFactory,
   backingsSatisfied,
   balancesMaxStep,
@@ -8183,6 +8251,7 @@ export {
   networkBackedFactory,
   networkStakeStepRewardPositionWeight,
   normalizeConnectionsConfig,
+  parseLocatorConfigFields,
   parseSignedBigInt,
   payloadMapFromStore,
   prettifyZodError,