@xyo-network/xl1-protocol-sdk 3.0.4 → 3.0.6

package/dist/neutral/Archivists/MemoryArchivistFactory.d.ts

@@ -1,15 +1,18 @@
 import type { ArchivistInstance } from '@xyo-network/sdk-js';
-import type { MemoryTransportConfig } from '../config/transports/Transport.ts';
+import type { TransportConfig } from '../config/transports/Transport.ts';
 import type { ArchivistConnectOptions } from './ArchivistConnectOptions.ts';
 /**
  * Static, process-global factory for in-memory archivists. `connect` caches by
  * (connectionName, archivistName) so two callers binding the same memory connection
  * and role share one MemoryArchivist — i.e. the same physical store. Without this,
  * each caller would create an isolated Map and silently read/write divergent data.
+ *
+ * `connect` accepts the wide `TransportConfig` (the memory variant carries no fields)
+ * so the class satisfies `ArchivistFactory` and can be held in the factory registry.
  */
 export declare class MemoryArchivistFactory {
     private static readonly cache;
-    static connect(connectionName: string, _config: MemoryTransportConfig, options: ArchivistConnectOptions): Promise<ArchivistInstance>;
+    static connect(connectionName: string, _config: TransportConfig, options: ArchivistConnectOptions): Promise<ArchivistInstance>;
     /** Test-only: drop all cached memory archivists so a fresh process state can be simulated. */
     static reset(): Promise<void>;
 }

package/dist/neutral/Archivists/MemoryArchivistFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryArchivistFactory.d.ts","sourceRoot":"","sources":["../../../src/Archivists/MemoryArchivistFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAG3E;;;;;GAKG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAA+B;WAE/C,OAAO,CAClB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAW7B,8FAA8F;WACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}
+{"version":3,"file":"MemoryArchivistFactory.d.ts","sourceRoot":"","sources":["../../../src/Archivists/MemoryArchivistFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAG3E;;;;;;;;GAQG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAA+B;WAE/C,OAAO,CAClB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAW7B,8FAA8F;WACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

package/dist/neutral/Archivists/archivistFactoryRegistry.d.ts

@@ -0,0 +1,9 @@
+import type { TransportConfig } from '../config/transports/Transport.ts';
+import type { ArchivistFactory } from './ArchivistFactory.ts';
+/** Register the factory used to self-provision archivists for a connection type. */
+export declare function registerArchivistFactory(type: TransportConfig['type'], factory: ArchivistFactory): void;
+/** The factory registered for a connection type, or undefined if none. */
+export declare function getArchivistFactory(type: TransportConfig['type']): ArchivistFactory | undefined;
+/** Test-only: clear host-registered factories, restoring the default (memory-only) state. */
+export declare function resetArchivistFactories(): void;
+//# sourceMappingURL=archivistFactoryRegistry.d.ts.map

package/dist/neutral/Archivists/archivistFactoryRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivistFactoryRegistry.d.ts","sourceRoot":"","sources":["../../../src/Archivists/archivistFactoryRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAA;AACxE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAY7D,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAEvG;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAE/F;AAKD,6FAA6F;AAC7F,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/dist/neutral/Archivists/connectArchivist.d.ts

@@ -2,10 +2,10 @@ import type { ArchivistInstance } from '@xyo-network/sdk-js';
 import type { ArchivistConnectOptions } from './ArchivistConnectOptions.ts';
 import type { ArchivistConnectionBinding } from './ArchivistFactory.ts';
 /**
- * Connect an archivist for a connection binding + logical role, dispatching on the
- * connection's substrate type. Memory is implemented here; lmdb/mongo are still
- * provisioned (injected) by the host and are not yet self-provisioned — binding one
- * of those without an injected archivist is a configuration error and throws loudly.
+ * Connect an archivist for a connection binding + logical role, dispatching to the
+ * factory registered for the connection's substrate type. Memory is registered by the
+ * protocol SDK; hosts register lmdb/mongo (etc.) via `registerArchivistFactory`. An
+ * unregistered type is a configuration error and throws loudly.
  */
 export declare function connectArchivist(binding: ArchivistConnectionBinding, options: ArchivistConnectOptions): Promise<ArchivistInstance>;
 //# sourceMappingURL=connectArchivist.d.ts.map

package/dist/neutral/Archivists/connectArchivist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connectArchivist.d.ts","sourceRoot":"","sources":["../../../src/Archivists/connectArchivist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAGvE;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAS5B"}
+{"version":3,"file":"connectArchivist.d.ts","sourceRoot":"","sources":["../../../src/Archivists/connectArchivist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAE5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAC3E,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAGvE;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CAM5B"}

package/dist/neutral/Archivists/index.d.ts

@@ -1,5 +1,6 @@
 export * from './ArchivistConnectOptions.ts';
 export * from './ArchivistFactory.ts';
+export * from './archivistFactoryRegistry.ts';
 export * from './archivistRoles.ts';
 export * from './connectArchivist.ts';
 export * from './MemoryArchivistFactory.ts';

package/dist/neutral/Archivists/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Archivists/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Archivists/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAA;AAC5C,cAAc,uBAAuB,CAAA;AACrC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA"}

package/dist/neutral/index.mjs

@@ -216,13 +216,6 @@ var ArchivistInstanceCache = class {
   }
 };
 
-// src/Archivists/archivistRoles.ts
-var CHAIN_ARCHIVIST_ROLE = "chain";
-var PENDING_TRANSACTIONS_ARCHIVIST_ROLE = "pending-transactions";
-var PENDING_BLOCKS_ARCHIVIST_ROLE = "pending-blocks";
-var REJECTED_BLOCKS_ARCHIVIST_ROLE = "rejected-blocks";
-var REJECTED_TRANSACTIONS_ARCHIVIST_ROLE = "rejected-transactions";
-
 // src/Archivists/MemoryArchivistFactory.ts
 import { MemoryArchivist } from "@xyo-network/sdk-js";
 var MemoryArchivistFactory = class _MemoryArchivistFactory {
@@ -243,16 +236,34 @@ var MemoryArchivistFactory = class _MemoryArchivistFactory {
   }
 };
 
+// src/Archivists/archivistFactoryRegistry.ts
+var registry = /* @__PURE__ */ new Map();
+function registerArchivistFactory(type, factory) {
+  registry.set(type, factory);
+}
+function getArchivistFactory(type) {
+  return registry.get(type);
+}
+registerArchivistFactory("memory", MemoryArchivistFactory);
+function resetArchivistFactories() {
+  registry.clear();
+  registerArchivistFactory("memory", MemoryArchivistFactory);
+}
+
+// src/Archivists/archivistRoles.ts
+var CHAIN_ARCHIVIST_ROLE = "chain";
+var PENDING_TRANSACTIONS_ARCHIVIST_ROLE = "pending-transactions";
+var PENDING_BLOCKS_ARCHIVIST_ROLE = "pending-blocks";
+var REJECTED_BLOCKS_ARCHIVIST_ROLE = "rejected-blocks";
+var REJECTED_TRANSACTIONS_ARCHIVIST_ROLE = "rejected-transactions";
+
 // src/Archivists/connectArchivist.ts
 async function connectArchivist(binding, options) {
-  switch (binding.config.type) {
-    case "memory": {
-      return await MemoryArchivistFactory.connect(binding.name, binding.config, options);
-    }
-    default: {
-      throw new Error(`connectArchivist: connection type '${binding.config.type}' is not self-provisioned \u2014 inject the archivist instead`);
-    }
+  const factory = getArchivistFactory(binding.config.type);
+  if (factory === void 0) {
+    throw new Error(`connectArchivist: no archivist factory registered for connection type '${binding.config.type}'`);
   }
+  return await factory.connect(binding.name, binding.config, options);
 }
 
 // src/block/hydrate/allHashesPresent.ts
@@ -1265,7 +1276,7 @@ var buildProviderFactory = (provider, defaultParams, labels) => {
   };
   return factory;
 };
-var registerCreatableProviderFactory = (registry, factory, labels, primary = false) => {
+var registerCreatableProviderFactory = (registry2, factory, labels, primary = false) => {
   const primaryMonikers = primary !== true && isTruthy(primary) ? Array.isArray(primary) ? primary : [primary] : [];
   for (const primaryMoniker of primaryMonikers) {
     if (!factory.monikers.includes(primaryMoniker)) {
@@ -1289,17 +1300,17 @@ var registerCreatableProviderFactory = (registry, factory, labels, primary = fal
     throw new Error(`Invalid primary value: ${String(primary)}`);
   };
   const factoryClone = buildProviderFactory(factory, factory.defaultParams, labels);
-  registry[factoryClone.defaultMoniker] = [factoryClone, ...registry[factoryClone.defaultMoniker] ?? []];
+  registry2[factoryClone.defaultMoniker] = [factoryClone, ...registry2[factoryClone.defaultMoniker] ?? []];
   for (const moniker of factoryClone.monikers) {
     if (moniker === factoryClone.defaultMoniker) continue;
-    registry[moniker] = isPrimaryForMoniker(moniker) ? [factoryClone, ...registry[moniker] ?? []] : [...registry[moniker] ?? [], factoryClone];
+    registry2[moniker] = isPrimaryForMoniker(moniker) ? [factoryClone, ...registry2[moniker] ?? []] : [...registry2[moniker] ?? [], factoryClone];
   }
 };
-var registerCreatableProviderFactories = (factories, registry = {}, primary = false) => {
+var registerCreatableProviderFactories = (factories, registry2 = {}, primary = false) => {
   for (const factory of factories) {
-    registerCreatableProviderFactory(registry, factory, void 0, primary);
+    registerCreatableProviderFactory(registry2, factory, void 0, primary);
   }
-  return registry;
+  return registry2;
 };
 
 // src/CreatableProvider/LabeledCreatableProviderFactory.ts
@@ -1319,8 +1330,8 @@ var ProviderFactoryLocator = class _ProviderFactoryLocator {
   _frozen = false;
   _parent;
   _validateDepsOnRegister;
-  constructor(context, registry = {}, validateDepsOnRegister = false) {
-    this._registry = registry;
+  constructor(context, registry2 = {}, validateDepsOnRegister = false) {
+    this._registry = registry2;
     this._context = { ...context, locator: this };
     this._parent = context.locator;
     this._validateDepsOnRegister = validateDepsOnRegister;
@@ -1365,16 +1376,16 @@ var ProviderFactoryLocator = class _ProviderFactoryLocator {
     );
   }
   merge(locator) {
-    const registry = { ...this.registry };
+    const registry2 = { ...this.registry };
     for (const moniker in locator.registry) {
-      const existing = registry[moniker];
+      const existing = registry2[moniker];
       if (existing === void 0) {
-        registry[moniker] = locator.registry[moniker];
+        registry2[moniker] = locator.registry[moniker];
       } else {
         existing.push(...locator.registry[moniker] ?? []);
       }
     }
-    return new _ProviderFactoryLocator(this.context, registry);
+    return new _ProviderFactoryLocator(this.context, registry2);
   }
   /**
    * Registers a single module factory (with optional tags) with the locator
@@ -4778,7 +4789,7 @@ var SimpleAccountBalanceViewer = class extends AbstractCreatableProvider {
     }, this.context);
   }
 };
-__publicField(SimpleAccountBalanceViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleAccountBalanceViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleAccountBalanceViewer, "defaultMoniker", AccountBalanceViewerMoniker);
 __publicField(SimpleAccountBalanceViewer, "dependencies", [BlockViewerMoniker]);
 __publicField(SimpleAccountBalanceViewer, "monikers", [AccountBalanceViewerMoniker]);
@@ -5101,7 +5112,7 @@ var SimpleBlockRewardViewer = class extends AbstractCreatableProvider {
     );
   }
 };
-__publicField(SimpleBlockRewardViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
+__publicField(SimpleBlockRewardViewer, "connectionTypes", ["lmdb", "mongo", "memory", "rpc"]);
 __publicField(SimpleBlockRewardViewer, "defaultMoniker", BlockRewardViewerMoniker);
 __publicField(SimpleBlockRewardViewer, "dependencies", []);
 __publicField(SimpleBlockRewardViewer, "monikers", [BlockRewardViewerMoniker]);
@@ -5245,7 +5256,7 @@ var SimpleBlockValidationViewer = class extends AbstractCreatableProvider {
     return [...this._uncleWindowedChainCache];
   }
 };
-__publicField(SimpleBlockValidationViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
+__publicField(SimpleBlockValidationViewer, "connectionTypes", ["lmdb", "mongo", "memory", "rpc"]);
 __publicField(SimpleBlockValidationViewer, "defaultMoniker", BlockValidationViewerMoniker);
 __publicField(SimpleBlockValidationViewer, "dependencies", [AccountBalanceViewerMoniker2, BlockViewerMoniker3, ChainContractViewerMoniker]);
 __publicField(SimpleBlockValidationViewer, "monikers", [BlockValidationViewerMoniker]);
@@ -5305,7 +5316,7 @@ var SimpleChainContractViewer = class extends AbstractCreatableProvider {
     return this.params.stakingTokenAddress;
   }
 };
-__publicField(SimpleChainContractViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleChainContractViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleChainContractViewer, "defaultMoniker", ChainContractViewerMoniker2);
 __publicField(SimpleChainContractViewer, "dependencies", [FinalizationViewerMoniker2]);
 __publicField(SimpleChainContractViewer, "monikers", [ChainContractViewerMoniker2]);
@@ -6630,7 +6641,7 @@ var SimpleXyoRunner = class extends AbstractCreatableProvider {
     this._mempoolRunner = await this.locator.getInstance(MempoolRunnerMoniker2);
   }
 };
-__publicField(SimpleXyoRunner, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleXyoRunner, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleXyoRunner, "defaultMoniker", XyoRunnerMoniker);
 __publicField(SimpleXyoRunner, "dependencies", [MempoolRunnerMoniker2]);
 __publicField(SimpleXyoRunner, "monikers", [XyoRunnerMoniker]);
@@ -6860,7 +6871,7 @@ var SimpleStakeTotalsViewer = class extends AbstractCreatableProvider {
     return withdrawn;
   }
 };
-__publicField(SimpleStakeTotalsViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleStakeTotalsViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleStakeTotalsViewer, "defaultMoniker", StakeTotalsViewerMoniker);
 __publicField(SimpleStakeTotalsViewer, "dependencies", [StakeTotalsViewerMoniker]);
 __publicField(SimpleStakeTotalsViewer, "monikers", [StakeTotalsViewerMoniker]);
@@ -6992,7 +7003,7 @@ var SimpleStakeViewer = class extends AbstractCreatableProvider {
     return this.positions.filter((s) => s.withdrawBlock !== 0);
   }
 };
-__publicField(SimpleStakeViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleStakeViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleStakeViewer, "defaultMoniker", StakeViewerMoniker2);
 __publicField(SimpleStakeViewer, "dependencies", [StakeEventsViewerMoniker2]);
 __publicField(SimpleStakeViewer, "monikers", [StakeViewerMoniker2]);
@@ -7164,7 +7175,7 @@ var SimpleTimeSyncViewer = class extends AbstractCreatableProvider {
     return timePayload;
   }
 };
-__publicField(SimpleTimeSyncViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleTimeSyncViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleTimeSyncViewer, "defaultMoniker", TimeSyncViewerMoniker);
 __publicField(SimpleTimeSyncViewer, "dependencies", [BlockViewerMoniker4]);
 __publicField(SimpleTimeSyncViewer, "monikers", [TimeSyncViewerMoniker]);
@@ -7290,7 +7301,7 @@ var SimpleTransactionValidationViewer = class extends AbstractCreatableProvider
     }));
   }
 };
-__publicField(SimpleTransactionValidationViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
+__publicField(SimpleTransactionValidationViewer, "connectionTypes", ["lmdb", "mongo", "memory", "rpc"]);
 __publicField(SimpleTransactionValidationViewer, "defaultMoniker", TransactionValidationViewerMoniker2);
 __publicField(SimpleTransactionValidationViewer, "dependencies", [AccountBalanceViewerMoniker3, ChainContractViewerMoniker5, BlockViewerMoniker5]);
 __publicField(SimpleTransactionValidationViewer, "monikers", [TransactionValidationViewerMoniker2]);
@@ -7372,7 +7383,7 @@ var SimpleTransactionViewer = class extends AbstractCreatableProvider {
     return await this.byHash(transactionHash);
   }
 };
-__publicField(SimpleTransactionViewer, "connectionTypes", ["lmdb", "mongo"]);
+__publicField(SimpleTransactionViewer, "connectionTypes", ["lmdb", "mongo", "memory"]);
 __publicField(SimpleTransactionViewer, "defaultMoniker", TransactionViewerMoniker);
 __publicField(SimpleTransactionViewer, "dependencies", [BlockViewerMoniker6]);
 __publicField(SimpleTransactionViewer, "monikers", [TransactionViewerMoniker]);
@@ -7549,7 +7560,7 @@ var SimpleWindowedBlockViewer = class extends AbstractCreatableProvider {
     });
   }
 };
-__publicField(SimpleWindowedBlockViewer, "connectionTypes", ["lmdb", "mongo", "rpc"]);
+__publicField(SimpleWindowedBlockViewer, "connectionTypes", ["lmdb", "mongo", "memory", "rpc"]);
 __publicField(SimpleWindowedBlockViewer, "defaultMoniker", WindowedBlockViewerMoniker2);
 __publicField(SimpleWindowedBlockViewer, "dependencies", [BlockViewerMoniker7]);
 __publicField(SimpleWindowedBlockViewer, "monikers", [WindowedBlockViewerMoniker2]);
@@ -8286,6 +8297,7 @@ export {
   flattenHydratedTransaction,
   flattenHydratedTransactions,
   generateXyoBaseWalletFromPhrase,
+  getArchivistFactory,
   getBlockRateBlocks,
   getEmptyContext,
   getEmptyProviderContext,
@@ -8354,9 +8366,11 @@ export {
   providerFactoryDescription,
   rateMultipliers,
   readPayloadMapFromStore,
+  registerArchivistFactory,
   registerCreatableProviderFactories,
   registerCreatableProviderFactory,
   registerFactoriesFromPlan,
+  resetArchivistFactories,
   resolveConfig,
   resolveProviders,
   resolveProvidersFromConfig,