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

package/dist/node/Archivists/ArchivistConnectOptions.d.ts

@@ -0,0 +1,8 @@
+/** Logical archivist identity + tuning, independent of substrate. */
+export interface ArchivistConnectOptions {
+    /** Optional maximum entry count for the underlying store. Omit to use the substrate default. */
+    max?: number;
+    /** Logical archivist name (role) within the connection — half of the cache key. */
+    name: string;
+}
+//# sourceMappingURL=ArchivistConnectOptions.d.ts.map

package/dist/node/Archivists/ArchivistConnectOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchivistConnectOptions.d.ts","sourceRoot":"","sources":["../../../src/Archivists/ArchivistConnectOptions.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,WAAW,uBAAuB;IACtC,gGAAgG;IAChG,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAA;CACb"}

package/dist/node/Archivists/ArchivistFactory.d.ts

@@ -0,0 +1,31 @@
+import type { ArchivistInstance } from '@xyo-network/sdk-js';
+import type { ConnectionConfig } from '../config/connections/Connection.ts';
+import type { ArchivistConnectOptions } from './ArchivistConnectOptions.ts';
+/** A connection binding handed to a factory: the connection's name plus its config. */
+export interface ArchivistConnectionBinding {
+    config: ConnectionConfig;
+    name: string;
+}
+/**
+ * Contract every substrate factory implements. `connect` is a static method on the
+ * concrete class (see MemoryArchivistFactory); this interface documents the shape and
+ * lets call sites depend on the abstraction rather than a concrete factory.
+ */
+export interface ArchivistFactory {
+    connect(connectionName: string, config: ConnectionConfig, options: ArchivistConnectOptions): Promise<ArchivistInstance>;
+}
+/** Compose the cache key from the connection name and the logical archivist name. */
+export declare function archivistCacheKey(connectionName: string, archivistName: string): string;
+/**
+ * Per-substrate cache of archivist instances keyed by (connectionName, archivistName).
+ * A single Mutex serializes creation so concurrent callers with the same key share
+ * one instance rather than racing to create two.
+ */
+export declare class ArchivistInstanceCache {
+    private readonly cache;
+    private readonly mutex;
+    clear(): Promise<void>;
+    getOrCreate(connectionName: string, archivistName: string, create: () => Promise<ArchivistInstance>): Promise<ArchivistInstance>;
+    has(connectionName: string, archivistName: string): boolean;
+}
+//# sourceMappingURL=ArchivistFactory.d.ts.map

package/dist/node/Archivists/ArchivistFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArchivistFactory.d.ts","sourceRoot":"","sources":["../../../src/Archivists/ArchivistFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAE3E,uFAAuF;AACvF,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,gBAAgB,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,uBAAuB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACxH;AAKD,qFAAqF;AACrF,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAEvF;AAED;;;;GAIG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuC;IAC7D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IAE9B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,WAAW,CACf,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,GACvC,OAAO,CAAC,iBAAiB,CAAC;IAW7B,GAAG,CAAC,cAAc,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO;CAG5D"}

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

@@ -0,0 +1,19 @@
+import type { ArchivistInstance } from '@xyo-network/sdk-js';
+import type { ConnectionConfig } from '../config/connections/Connection.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 `ConnectionConfig` (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: ConnectionConfig, options: ArchivistConnectOptions): Promise<ArchivistInstance>;
+    /** Test-only: drop all cached memory archivists so a fresh process state can be simulated. */
+    static reset(): Promise<void>;
+}
+//# sourceMappingURL=MemoryArchivistFactory.d.ts.map

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

@@ -0,0 +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,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,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,gBAAgB,EACzB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,iBAAiB,CAAC;IAW7B,8FAA8F;WACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}

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

@@ -0,0 +1,9 @@
+import type { ConnectionConfig } from '../config/connections/Connection.ts';
+import type { ArchivistFactory } from './ArchivistFactory.ts';
+/** Register the factory used to self-provision archivists for a connection type. */
+export declare function registerArchivistFactory(type: ConnectionConfig['type'], factory: ArchivistFactory): void;
+/** The factory registered for a connection type, or undefined if none. */
+export declare function getArchivistFactory(type: ConnectionConfig['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/node/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,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAY7D,oFAAoF;AACpF,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAExG;AAED,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,GAAG,gBAAgB,GAAG,SAAS,CAEhG;AAKD,6FAA6F;AAC7F,wBAAgB,uBAAuB,IAAI,IAAI,CAG9C"}

package/dist/node/Archivists/archivistRoles.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Canonical logical archivist names ("roles") within a connection. Providers and
+ * bootstrap genesis must agree on these strings — they form half of the
+ * ArchivistFactory cache key (connectionName, archivistName), so a mismatch would
+ * silently split a store that callers expect to share.
+ */
+export declare const CHAIN_ARCHIVIST_ROLE = "chain";
+export declare const PENDING_TRANSACTIONS_ARCHIVIST_ROLE = "pending-transactions";
+export declare const PENDING_BLOCKS_ARCHIVIST_ROLE = "pending-blocks";
+export declare const REJECTED_BLOCKS_ARCHIVIST_ROLE = "rejected-blocks";
+export declare const REJECTED_TRANSACTIONS_ARCHIVIST_ROLE = "rejected-transactions";
+//# sourceMappingURL=archivistRoles.d.ts.map

package/dist/node/Archivists/archivistRoles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archivistRoles.d.ts","sourceRoot":"","sources":["../../../src/Archivists/archivistRoles.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,UAAU,CAAA;AAC3C,eAAO,MAAM,mCAAmC,yBAAyB,CAAA;AACzE,eAAO,MAAM,6BAA6B,mBAAmB,CAAA;AAC7D,eAAO,MAAM,8BAA8B,oBAAoB,CAAA;AAC/D,eAAO,MAAM,oCAAoC,0BAA0B,CAAA"}

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

@@ -0,0 +1,11 @@
+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 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/node/Archivists/connectArchivist.d.ts.map

@@ -0,0 +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,CAM5B"}

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

@@ -0,0 +1,7 @@
+export * from './ArchivistConnectOptions.ts';
+export * from './ArchivistFactory.ts';
+export * from './archivistFactoryRegistry.ts';
+export * from './archivistRoles.ts';
+export * from './connectArchivist.ts';
+export * from './MemoryArchivistFactory.ts';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,+BAA+B,CAAA;AAC7C,cAAc,qBAAqB,CAAA;AACnC,cAAc,uBAAuB,CAAA;AACrC,cAAc,6BAA6B,CAAA"}

package/dist/node/ChainContextHelpers.d.ts

@@ -0,0 +1,10 @@
+import type { CachingContext, MapType } from '@xyo-network/xl1-protocol-lib';
+/** Retrieves or creates a named cache from the caching context */
+export declare function contextCache<TCacheValue>(context: CachingContext, name: string, create?: () => MapType<string, TCacheValue>): MapType<string, TCacheValue>;
+/** Options for the withContextCacheResponse helper */
+export interface withContextCacheResponseOptions {
+    max?: number;
+}
+/** Executes a function with LRU caching, returning the cached result if available */
+export declare function withContextCacheResponse<T extends string | number | bigint | {}>(context: CachingContext, name: string, key: string, func: () => Promise<T extends string | number | bigint | {} ? T : never>, { max }?: withContextCacheResponseOptions): Promise<T>;
+//# sourceMappingURL=ChainContextHelpers.d.ts.map

package/dist/node/ChainContextHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChainContextHelpers.d.ts","sourceRoot":"","sources":["../../src/ChainContextHelpers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AAE5E,kEAAkE;AAClE,wBAAgB,YAAY,CAAC,WAAW,EACtC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,GAC1C,OAAO,CAAC,MAAM,EAAE,WAAW,CAAC,CAQ9B;AAED,sDAAsD;AACtD,MAAM,WAAW,+BAA+B;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAED,qFAAqF;AACrF,wBAAsB,wBAAwB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,EAAE,EACpF,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,EACxE,EAAE,GAAY,EAAE,GAAE,+BAAoC,GACrD,OAAO,CAAC,CAAC,CAAC,CAcZ"}

package/dist/node/CreatableProvider/AbstractCreatableProvider.d.ts

@@ -0,0 +1,114 @@
+import type { Logger } from '@xylabs/sdk';
+import { AbstractCreatable } from '@xylabs/sdk';
+import type { Provider, ProviderMoniker } from '@xyo-network/xl1-protocol-lib';
+import type { CreatableProvider, CreatableProviderEventData, CreatableProviderInstance, CreatableProviderParams, ProviderMap } from './CreatableProvider.ts';
+import { ProviderFactory } from './ProviderFactory.ts';
+/** Abstract base class for CreatableProvider implementations. */
+export declare abstract class AbstractCreatableProvider<TParams extends CreatableProviderParams = CreatableProviderParams, TEventData extends CreatableProviderEventData = CreatableProviderEventData> extends AbstractCreatable<TParams, TEventData> implements Omit<CreatableProviderInstance, 'moniker'> {
+    dependencies: ProviderMap;
+    protected _contextCache: TParams['context'] | undefined;
+    protected _logger: Logger | undefined | null;
+    abstract readonly moniker: ProviderMoniker;
+    get logger(): Logger | undefined;
+    get meter(): import("@opentelemetry/api").Meter | undefined;
+    get tracer(): import("@opentelemetry/api").Tracer | undefined;
+    protected get config(): {
+        chain: {
+            id?: import("@xylabs/sdk").BrandedHex | undefined;
+            genesisRewardAddress?: (Lowercase<string> & {
+                readonly __hex: true;
+            } & {
+                readonly __address: true;
+            }) | import("@xyo-network/sdk-protocol").XyoQuantAddress | undefined;
+        };
+        log: {
+            logLevel: "error" | "warn" | "info" | "log" | "debug" | "trace";
+            silent: boolean;
+        };
+        connections: Record<string, {
+            root: string;
+            type: "lmdb";
+            access?: "read" | "write" | undefined;
+            store?: string | undefined;
+        } | {
+            type: "mongo";
+            connectionString?: string | undefined;
+            database?: string | undefined;
+            domain?: string | undefined;
+            password?: string | undefined;
+            username?: string | undefined;
+        } | {
+            type: "rpc";
+            protocol: string;
+            url?: string | undefined;
+            networkId?: string | undefined;
+            sessionId?: string | undefined;
+        } | {
+            type: "rest";
+            baseUrl: string;
+        } | {
+            type: "s3";
+            bucket?: string | undefined;
+            endpoint?: string | undefined;
+            prefix?: string | undefined;
+            readUrl?: string | undefined;
+            accessKeyId?: string | undefined;
+            accountId?: string | undefined;
+            secretAccessKey?: string | undefined;
+        } | {
+            type: "evm-rpc";
+            url: string;
+            chainId?: string | undefined;
+        } | {
+            type: "memory";
+        }>;
+        providerBindings: Record<string, {
+            connection?: string | undefined;
+            provider?: string | undefined;
+        }>;
+        providers: {
+            [x: string]: unknown;
+            moniker: string;
+            labels?: string[] | undefined;
+        }[];
+        telemetry: {
+            metrics?: {
+                scrape: {
+                    path: string;
+                    port?: number | undefined;
+                };
+            } | undefined;
+            otel?: {
+                otlpEndpoint?: string | undefined;
+            } | undefined;
+        };
+        validation: {
+            signerAuthorizations: ({
+                type: "completedStepReward";
+                signers: (import("@xyo-network/sdk-protocol").XyoQuantAddress | (Lowercase<string> & {
+                    readonly __hex: true;
+                } & {
+                    readonly __address: true;
+                }))[];
+            } | {
+                type: "derivedReceive";
+                scope: string;
+                signers: (import("@xyo-network/sdk-protocol").XyoQuantAddress | (Lowercase<string> & {
+                    readonly __hex: true;
+                } & {
+                    readonly __address: true;
+                }))[];
+            })[];
+            minCandidates: number;
+            backoffMs: number;
+        };
+    };
+    protected get context(): import("../index.ts").CreatableProviderContextType;
+    protected get locator(): import("./ProviderFactoryLocatorInstance.ts").ProviderFactoryLocatorInstance<import("../index.ts").CreatableProviderContextType>;
+    static factory<TInstance extends CreatableProviderInstance, TDependencies extends ProviderMoniker[] = ProviderMoniker[]>(this: CreatableProvider<TInstance>, dependencies: TDependencies, params: Omit<TInstance['params'], 'context'>): ProviderFactory<TInstance, TDependencies>;
+    static paramsHandler<T extends CreatableProviderInstance>(params?: Partial<T['params']>): Promise<T["params"]>;
+    createHandler(): Promise<void>;
+    locateAndCreate<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker']): Promise<CreatableProviderInstance<TProvider>>;
+    tryLocateAndCreate<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker']): Promise<CreatableProviderInstance<TProvider> | undefined>;
+}
+//# sourceMappingURL=AbstractCreatableProvider.d.ts.map

package/dist/node/CreatableProvider/AbstractCreatableProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractCreatableProvider.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/AbstractCreatableProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EACL,iBAAiB,EAClB,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAE9E,OAAO,KAAK,EACV,iBAAiB,EACjB,0BAA0B,EAAE,yBAAyB,EAAE,uBAAuB,EAC9E,WAAW,EACZ,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,iEAAiE;AACjE,8BAAsB,yBAAyB,CAAC,OAAO,SAAS,uBAAuB,GAAG,uBAAuB,EAC/G,UAAU,SAAS,0BAA0B,GAAG,0BAA0B,CAAE,SAAQ,iBAAiB,CAAC,OAAO,EAAE,UAAU,CACzH,YAAW,IAAI,CAAC,yBAAyB,EAAE,SAAS,CAAC;IACrD,YAAY,EAAE,WAAW,CAAK;IAE9B,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;IACvD,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IAE5C,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IAE1C,IAAa,MAAM,uBAOlB;IAED,IAAa,KAAK,mDAEjB;IAED,IAAa,MAAM,oDAElB;IAED,SAAS,KAAK,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEnB;IAED,SAAS,KAAK,OAAO,uDAEpB;IAED,SAAS,KAAK,OAAO,qIAEpB;IAED,MAAM,CAAC,OAAO,CAAC,SAAS,SAAS,yBAAyB,EAAE,aAAa,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,EACrH,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAClC,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC;WAMxB,aAAa,CAAC,CAAC,SAAS,yBAAyB,EACrE,MAAM,GAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAM;IAgBpB,aAAa;IAUtB,eAAe,CAAC,SAAS,SAAS,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC;IAI1F,kBAAkB,CAAC,SAAS,SAAS,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC;CAGpG"}

package/dist/node/CreatableProvider/CreatableProvider.d.ts

@@ -0,0 +1,67 @@
+import type { Creatable, CreatableInstance, CreatableParams, EventData, Labels, WithOptionalLabels } from '@xylabs/sdk';
+import type { Provider, ProviderMoniker } from '@xyo-network/xl1-protocol-lib';
+import type { Surface } from '../capabilities/Backing.ts';
+import type { ConnectionKind } from '../config/connections/Connection.ts';
+import type { CreatableProviderContext } from '../model/index.ts';
+/** Connection kinds declared on creatable provider statics (connections plus wallet). */
+export type CreatableProviderConnectionType = ConnectionKind | 'wallet';
+import type { GetInstanceOptions } from './GetInstanceOptions.ts';
+import type { LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts';
+/** Parameters for CreatableProvider. */
+export interface CreatableProviderParams<TContext extends CreatableProviderContext = CreatableProviderContext> extends CreatableParams {
+    context: TContext;
+}
+/** CreatableProviderEventData interface. */
+export interface CreatableProviderEventData extends EventData {
+}
+/** CreatableProviderInstance type. */
+export type CreatableProviderInstance<TProvider extends Provider<ProviderMoniker> = Provider<ProviderMoniker>, TDependencies extends ProviderMoniker[] = ProviderMoniker[], TParams extends CreatableProviderParams = CreatableProviderParams, TEventData extends CreatableProviderEventData = CreatableProviderEventData> = CreatableInstance<TParams, TEventData> & TProvider & {
+    dependencies: ProviderMap<TDependencies[number]>;
+};
+/** ProviderFactoryScope type. */
+export type ProviderFactoryScope = 'global' | 'context' | 'local';
+/** CreatableProviderFactory interface. */
+export interface CreatableProviderFactory<T extends CreatableProviderInstance = CreatableProviderInstance, TDependencies extends ProviderMoniker[] = ProviderMoniker[]> extends Omit<CreatableProvider<T>, 'create' | 'createHandler' | 'paramsHandler'> {
+    readonly connectionTypes?: readonly CreatableProviderConnectionType[];
+    creatableProvider: CreatableProvider<T>;
+    defaultParams: Omit<T['params'], 'context'>;
+    readonly dependencies: TDependencies;
+    labels?: Labels;
+    providerName: string;
+    resolvedMoniker: string;
+    scope: ProviderFactoryScope;
+    readonly surface?: Surface;
+    uniqueId: symbol;
+    getInstance(this: CreatableProviderFactory<T>, params: T['params'], options?: GetInstanceOptions): Promise<T>;
+    tryGetInstance(this: CreatableProviderFactory<T>, params: T['params'], options?: GetInstanceOptions): Promise<T | undefined>;
+}
+/** LabeledCreatableProvider interface. */
+export interface LabeledCreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance, TDependencies extends ProviderMoniker[] = ProviderMoniker[]> extends CreatableProvider<T>, WithOptionalLabels {
+    factory(dependencies: TDependencies, params: Omit<T['params'], 'context'>): LabeledCreatableProviderFactory<T>;
+}
+/** ProviderMap type. */
+export type ProviderMap<T extends ProviderMoniker = ProviderMoniker> = Partial<Record<T, CreatableProviderInstance<Provider<T>>>>;
+/** CreatableProvider interface. */
+export interface CreatableProvider<T extends CreatableProviderInstance = CreatableProviderInstance, TDependencies extends ProviderMoniker[] = ProviderMoniker[]> extends Creatable<T> {
+    readonly connectionTypes?: readonly CreatableProviderConnectionType[];
+    readonly defaultMoniker: ProviderMoniker;
+    readonly dependencies: TDependencies;
+    readonly monikers: ProviderMoniker[];
+    readonly surface?: Surface;
+    factory(dependencies: TDependencies, params: Omit<T['params'], 'context'>): CreatableProviderFactory<T>;
+}
+/**
+ * Class annotation to be used to decorate Providers which support
+ * an asynchronous creation pattern
+ * @returns The decorated Provider requiring it implement the members
+ * of the CreatableProvider as statics properties/methods
+ */
+export declare function creatableProvider<TProvider extends CreatableProviderInstance = CreatableProviderInstance>(): <U extends CreatableProvider<TProvider>>(constructor: U) => void;
+/**
+ * Class annotation to be used to decorate Providers which support
+ * an asynchronous creation pattern
+ * @returns The decorated Provider requiring it implement the members
+ * of the CreatableProvider as statics properties/methods
+ */
+export declare function labeledCreatableProvider<TProvider extends CreatableProviderInstance = CreatableProviderInstance>(): <U extends LabeledCreatableProvider<TProvider>>(constructor: U) => void;
+//# sourceMappingURL=CreatableProvider.d.ts.map

package/dist/node/CreatableProvider/CreatableProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableProvider.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/CreatableProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EAAE,iBAAiB,EAAE,eAAe,EAC7C,SAAS,EACT,MAAM,EAAE,kBAAkB,EAC3B,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAE9E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAEjE,yFAAyF;AACzF,MAAM,MAAM,+BAA+B,GAAG,cAAc,GAAG,QAAQ,CAAA;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AACjE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AAE3F,wCAAwC;AACxC,MAAM,WAAW,uBAAuB,CAAC,QAAQ,SAAS,wBAAwB,GAAG,wBAAwB,CAAE,SAAQ,eAAe;IACpI,OAAO,EAAE,QAAQ,CAAA;CAClB;AACD,4CAA4C;AAC5C,MAAM,WAAW,0BAA2B,SAAQ,SAAS;CAAG;AAEhE,sCAAsC;AACtC,MAAM,MAAM,yBAAyB,CACnC,SAAS,SAAS,QAAQ,CAAC,eAAe,CAAC,GAAG,QAAQ,CAAC,eAAe,CAAC,EACvE,aAAa,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,EAC3D,OAAO,SAAS,uBAAuB,GAAG,uBAAuB,EACjE,UAAU,SAAS,0BAA0B,GAAG,0BAA0B,IACxE,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,SAAS,GAAG;IACrD,YAAY,EAAE,WAAW,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAA;CACjD,CAAA;AAEH,iCAAiC;AACjC,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAA;AAEjE,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,EACvG,aAAa,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,CAC3D,SAAQ,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,eAAe,CAAC;IAChF,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAA;IACrE,iBAAiB,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAA;IACvC,aAAa,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;IAE3C,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAA;IAEpC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,eAAe,EAAE,MAAM,CAAA;IACvB,KAAK,EAAE,oBAAoB,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAE1B,QAAQ,EAAE,MAAM,CAAA;IAEhB,WAAW,CACT,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EACjC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAE3C,cAAc,CACZ,IAAI,EAAE,wBAAwB,CAAC,CAAC,CAAC,EACjC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;CAExD;AAED,0CAA0C;AAC1C,MAAM,WAAW,wBAAwB,CAAC,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,EACvG,aAAa,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,CAAE,SAAQ,iBAAiB,CAAC,CAAC,CAAC,EAAE,kBAAkB;IAC7G,OAAO,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,GAAG,+BAA+B,CAAC,CAAC,CAAC,CAAA;CAC/G;AAED,wBAAwB;AACxB,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,yBAAyB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEjI,mCAAmC;AACnC,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,EAChG,aAAa,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IAEjF,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,+BAA+B,EAAE,CAAA;IACrE,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAA;IACxC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAA;IACpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,EAAE,CAAA;IAEpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,OAAO,CAAC,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,GAAG,wBAAwB,CAAC,CAAC,CAAC,CAAA;CACxG;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,SAAS,yBAAyB,GAAG,yBAAyB,MAC/F,CAAC,SAAS,iBAAiB,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,UAI/D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,yBAAyB,GAAG,yBAAyB,MACtG,CAAC,SAAS,wBAAwB,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,UAItE"}

package/dist/node/CreatableProvider/CreatableProviderRegistry.d.ts

@@ -0,0 +1,13 @@
+import type { Labels } from '@xylabs/sdk';
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol-lib';
+import type { CreatableProviderFactory, CreatableProviderInstance } from './CreatableProvider.ts';
+import type { LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts';
+/** CreatableProviderRegistry type. */
+export type CreatableProviderRegistry<TMonikers extends ProviderMoniker[] = ProviderMoniker[]> = Record<TMonikers[number], (CreatableProviderFactory | LabeledCreatableProviderFactory)[] | undefined>;
+/** registerCreatableProviderFactory constant. */
+export declare const registerCreatableProviderFactory: <TProvider extends CreatableProviderInstance>(registry: CreatableProviderRegistry, factory: CreatableProviderFactory<TProvider> | LabeledCreatableProviderFactory<TProvider>, labels?: Labels, 
+/** register this as the primary factory for every schema it supports */
+primary?: boolean | ProviderMoniker | ProviderMoniker[]) => void;
+/** registerCreatableProviderFactories constant. */
+export declare const registerCreatableProviderFactories: (factories: (CreatableProviderFactory | LabeledCreatableProviderFactory)[], registry?: CreatableProviderRegistry, primary?: boolean) => CreatableProviderRegistry<string[]>;
+//# sourceMappingURL=CreatableProviderRegistry.d.ts.map

package/dist/node/CreatableProvider/CreatableProviderRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableProviderRegistry.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/CreatableProviderRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AACjG,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AAG3F,sCAAsC;AACtC,MAAM,MAAM,yBAAyB,CAAC,SAAS,SAAS,eAAe,EAAE,GAAG,eAAe,EAAE,IACzF,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,wBAAwB,GAAG,+BAA+B,CAAC,EAAE,GAAG,SAAS,CAAC,CAAA;AA0BzG,iDAAiD;AACjD,eAAO,MAAM,gCAAgC,GAAI,SAAS,SAAS,yBAAyB,EAC1F,UAAU,yBAAyB,EACnC,SAAS,wBAAwB,CAAC,SAAS,CAAC,GAAG,+BAA+B,CAAC,SAAS,CAAC,EACzF,SAAS,MAAM;AACf,wEAAwE;AACxE,UAAS,OAAO,GAAG,eAAe,GAAG,eAAe,EAAU,SA+C/D,CAAA;AAED,mDAAmD;AACnD,eAAO,MAAM,kCAAkC,GAC7C,WAAW,CAAC,wBAAwB,GAAG,+BAA+B,CAAC,EAAE,EACzE,WAAU,yBAA8B,EACxC,iBAAe,wCAMhB,CAAA"}

package/dist/node/CreatableProvider/GetInstanceOptions.d.ts

@@ -0,0 +1,10 @@
+import type { Labels } from '@xylabs/sdk';
+/** Options for GetInstance. */
+export interface GetInstanceOptions {
+    start?: boolean;
+}
+/** Options for ProviderFactoryGetInstance. */
+export interface ProviderFactoryGetInstanceOptions extends GetInstanceOptions {
+    labels?: Labels;
+}
+//# sourceMappingURL=GetInstanceOptions.d.ts.map

package/dist/node/CreatableProvider/GetInstanceOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GetInstanceOptions.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/GetInstanceOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,8CAA8C;AAC9C,MAAM,WAAW,iCAAkC,SAAQ,kBAAkB;IAC3E,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB"}

package/dist/node/CreatableProvider/LabeledCreatableProviderFactory.d.ts

@@ -0,0 +1,14 @@
+import type { WithOptionalLabels } from '@xylabs/sdk';
+import type { CreatableProviderFactory, CreatableProviderInstance } from './CreatableProvider.ts';
+/** LabeledCreatableProviderFactory type. */
+export type LabeledCreatableProviderFactory<T extends CreatableProviderInstance = CreatableProviderInstance> = CreatableProviderFactory<T> & WithOptionalLabels;
+/** hasLabels constant. */
+export declare const hasLabels: (factory: CreatableProviderFactory | LabeledCreatableProviderFactory) => factory is LabeledCreatableProviderFactory;
+/**
+ * Class annotation to be used to decorate Providers which support
+ * an asynchronous labeled creation factory pattern
+ * @returns The decorated Provider requiring it implement the members
+ * of the CreatableProvider as statics properties/methods
+ */
+export declare function labeledCreatableProviderFactory<TProvider extends CreatableProviderInstance = CreatableProviderInstance>(): <U extends LabeledCreatableProviderFactory<TProvider>>(constructor: U) => void;
+//# sourceMappingURL=LabeledCreatableProviderFactory.d.ts.map

package/dist/node/CreatableProvider/LabeledCreatableProviderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LabeledCreatableProviderFactory.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/LabeledCreatableProviderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAErD,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AAEjG,4CAA4C;AAC5C,MAAM,MAAM,+BAA+B,CAAC,CAAC,SAAS,yBAAyB,GAAG,yBAAyB,IAAI,wBAAwB,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAA;AAE/J,0BAA0B;AAC1B,eAAO,MAAM,SAAS,GAAI,SAAS,wBAAwB,GAAG,+BAA+B,KAAG,OAAO,IAAI,+BAE1G,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,SAAS,SAAS,yBAAyB,GAAG,yBAAyB,MAC7G,CAAC,SAAS,+BAA+B,CAAC,SAAS,CAAC,EAAE,aAAa,CAAC,UAI7E"}

package/dist/node/CreatableProvider/ProviderFactory.d.ts

@@ -0,0 +1,29 @@
+import type { Labels } from '@xylabs/sdk';
+import type { ProviderMoniker } from '@xyo-network/xl1-protocol-lib';
+import type { CreatableProvider, CreatableProviderFactory, CreatableProviderInstance, ProviderFactoryScope } from './CreatableProvider.ts';
+import type { GetInstanceOptions } from './GetInstanceOptions.ts';
+declare global {
+    var xyoServiceSingletons: Record<string, unknown>;
+}
+/** ProviderFactoryDescription helper function. */
+export declare function providerFactoryDescription(factory: CreatableProviderFactory, labels?: Labels): string;
+/** ProviderFactory implementation. */
+export declare class ProviderFactory<TProvider extends CreatableProviderInstance, TDependencies extends ProviderMoniker[]> implements CreatableProviderFactory<TProvider> {
+    creatableProvider: CreatableProvider<TProvider>;
+    defaultMoniker: CreatableProvider<TProvider>['monikers'][number];
+    defaultParams: Omit<TProvider['params'], 'context'>;
+    dependencies: TDependencies;
+    labels?: Labels;
+    monikers: CreatableProvider<TProvider>['monikers'];
+    providerName: string;
+    scope: ProviderFactoryScope;
+    private _uniqueId;
+    constructor(creatableProvider: CreatableProvider<TProvider>, dependencies: TDependencies, params: Omit<TProvider['params'], 'context'>, labels?: Labels, scope?: ProviderFactoryScope);
+    get resolvedMoniker(): string;
+    get uniqueId(): symbol;
+    static withParams<TInstance extends CreatableProviderInstance, TDependencies extends ProviderMoniker[]>(creatableProvider: CreatableProvider<TInstance>, dependencies: TDependencies, params: Omit<TInstance['params'], 'context'>, labels?: Labels): ProviderFactory<TInstance, TDependencies>;
+    factory<TInstance extends CreatableProviderInstance, TDependencies extends ProviderMoniker[]>(this: CreatableProviderFactory<TInstance, TDependencies>, dependencies: TDependencies, params: Omit<TInstance['params'], 'context'>, labels?: Labels): ProviderFactory<TInstance, TDependencies>;
+    getInstance(this: CreatableProviderFactory<TProvider>, params: TProvider['params'], { start }: GetInstanceOptions): Promise<TProvider>;
+    tryGetInstance(this: CreatableProviderFactory<TProvider>, params: TProvider['params'], options?: GetInstanceOptions): Promise<TProvider | undefined>;
+}
+//# sourceMappingURL=ProviderFactory.d.ts.map

package/dist/node/CreatableProvider/ProviderFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFactory.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/ProviderFactory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAA;AAE7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAEpE,OAAO,KAAK,EACV,iBAAiB,EAAE,wBAAwB,EAAE,yBAAyB,EACtE,oBAAoB,EACrB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClD;AAED,kDAAkD;AAClD,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,wBAAwB,EAAE,MAAM,CAAC,EAAE,MAAM,UAE5F;AAED,sCAAsC;AACtC,qBAAa,eAAe,CAAC,SAAS,SAAS,yBAAyB,EACtE,aAAa,SAAS,eAAe,EAAE,CAAE,YAAW,wBAAwB,CAAC,SAAS,CAAC;IACvF,iBAAiB,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAA;IAE/C,cAAc,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;IAEhE,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,CAAA;IAEnD,YAAY,EAAE,aAAa,CAAA;IAE3B,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,QAAQ,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAA;IAElD,YAAY,EAAE,MAAM,CAAA;IAEpB,KAAK,EAAE,oBAAoB,CAAA;IAE3B,OAAO,CAAC,SAAS,CAAQ;gBAGvB,iBAAiB,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAC/C,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,EAC5C,MAAM,GAAE,MAAW,EACnB,KAAK,GAAE,oBAAgC;IAczC,IAAI,eAAe,WAIlB;IAED,IAAI,QAAQ,IAAI,MAAM,CAErB;IAED,MAAM,CAAC,UAAU,CAAC,SAAS,SAAS,yBAAyB,EAAE,aAAa,SAAS,eAAe,EAAE,EACpG,iBAAiB,EAAE,iBAAiB,CAAC,SAAS,CAAC,EAC/C,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,EAC5C,MAAM,GAAE,MAAW;IAKrB,OAAO,CAAC,SAAS,SAAS,yBAAyB,EAAE,aAAa,SAAS,eAAe,EAAE,EAC1F,IAAI,EAAE,wBAAwB,CAAC,SAAS,EAAE,aAAa,CAAC,EACxD,YAAY,EAAE,aAAa,EAC3B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,EAC5C,MAAM,GAAE,MAAW;IAKf,WAAW,CAAC,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAAE,EAAE,KAAY,EAAE,EAAE,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC;IAkC7I,cAAc,CAClB,IAAI,EAAE,wBAAwB,CAAC,SAAS,CAAC,EACzC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,EAC3B,OAAO,CAAC,EAAE,kBAAkB,GAC3B,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;CAOlC"}

package/dist/node/CreatableProvider/ProviderFactoryLocator.d.ts

@@ -0,0 +1,61 @@
+import { type Labels } from '@xylabs/sdk';
+import type { Provider, ProviderMoniker } from '@xyo-network/xl1-protocol-lib';
+import type { CreatableProviderContext } from '../model/index.ts';
+import type { CreatableProviderFactory, CreatableProviderInstance } from './CreatableProvider.ts';
+import { type CreatableProviderRegistry } from './CreatableProviderRegistry.ts';
+import type { ProviderFactoryGetInstanceOptions } from './GetInstanceOptions.ts';
+import { type LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts';
+import type { ProviderFactoryLocatorInstance } from './ProviderFactoryLocatorInstance.ts';
+/**
+ * A class which encapsulates the Service Locator Pattern for Provider Factories
+ */
+export declare class ProviderFactoryLocator<TContext extends CreatableProviderContext = CreatableProviderContext, TMonikers extends ProviderMoniker[] = ProviderMoniker[]> implements ProviderFactoryLocatorInstance<TContext> {
+    protected readonly _context: TContext;
+    protected readonly _registry: CreatableProviderRegistry<TMonikers>;
+    private _frozen;
+    private _parent?;
+    private _validateDepsOnRegister;
+    constructor(context: (Omit<TContext, 'locator'> & {
+        locator?: TContext['locator'];
+    }), registry?: CreatableProviderRegistry, validateDepsOnRegister?: boolean);
+    get context(): TContext;
+    get logger(): import("@xylabs/sdk").Logger | undefined;
+    /**
+     * The current registry for the module factory
+     */
+    get registry(): Readonly<CreatableProviderRegistry>;
+    protected get validateDepsOnRegister(): boolean;
+    freeze(): void;
+    getInstance<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker'], { start, labels }?: ProviderFactoryGetInstanceOptions): Promise<CreatableProviderInstance<TProvider>>;
+    has(moniker: TMonikers[number]): boolean;
+    /**
+     * Locates a provider factory that matches the supplied moniker and labels
+     * @param moniker The config moniker for the provider
+     * @param labels The labels for the provider factory
+     * @returns A provider factory that matches the supplied moniker and labels or throws if one is not found
+     */
+    locate<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker'], labels?: Labels): CreatableProviderFactory<CreatableProviderInstance<TProvider>> | LabeledCreatableProviderFactory<CreatableProviderInstance<TProvider>>;
+    merge(locator: ProviderFactoryLocatorInstance): ProviderFactoryLocatorInstance;
+    /**
+     * Registers a single module factory (with optional tags) with the locator
+     * @param factory The factory to register
+     * @param labels The labels for the module factory
+     */
+    register(factory: CreatableProviderFactory, labels?: Labels, primary?: boolean | ProviderMoniker | ProviderMoniker[]): this;
+    /**
+     * Registers multiple module factories with the locator
+     * @param factories The factories to register
+     */
+    registerMany(factories: CreatableProviderFactory[]): this;
+    registered(moniker: ProviderMoniker): boolean;
+    tryGetInstance<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker'], { start, labels }?: ProviderFactoryGetInstanceOptions): Promise<CreatableProviderInstance<TProvider> | undefined>;
+    /**
+     * Tries to locate a module factory that matches the supplied moniker and labels
+     * @param moniker The config moniker for the module
+     * @param labels The labels for the module factory
+     * @returns A module factory that matches the supplied moniker and labels or undefined
+     */
+    tryLocate<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker'], labels?: Labels): CreatableProviderFactory<CreatableProviderInstance<TProvider>> | LabeledCreatableProviderFactory<CreatableProviderInstance<TProvider>> | undefined;
+    validateDependencies(recursive?: boolean): void;
+}
+//# sourceMappingURL=ProviderFactoryLocator.d.ts.map

package/dist/node/CreatableProvider/ProviderFactoryLocator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFactoryLocator.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/ProviderFactoryLocator.ts"],"names":[],"mappings":"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"}

package/dist/node/CreatableProvider/ProviderFactoryLocatorInstance.d.ts

@@ -0,0 +1,47 @@
+import type { Labels } from '@xylabs/sdk';
+import type { Provider, ProviderMoniker } from '@xyo-network/xl1-protocol-lib';
+import type { CreatableProviderContext } from '../model/index.ts';
+import type { CreatableProviderFactory, CreatableProviderInstance } from './CreatableProvider.ts';
+import type { CreatableProviderRegistry } from './CreatableProviderRegistry.ts';
+import type { ProviderFactoryGetInstanceOptions } from './GetInstanceOptions.ts';
+import type { LabeledCreatableProviderFactory } from './LabeledCreatableProviderFactory.ts';
+/** Interface for ProviderFactoryLocator instances. */
+export interface ProviderFactoryLocatorInstance<T extends CreatableProviderContext = CreatableProviderContext> {
+    context: T;
+    /**
+     * The current registry for the module factory
+     */
+    registry: Readonly<CreatableProviderRegistry>;
+    freeze(): void;
+    getInstance<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker'], options?: ProviderFactoryGetInstanceOptions): Promise<CreatableProviderInstance<TProvider>>;
+    /**
+     * Locates a module factory that matches the supplied moniker and labels
+     * @param moniker The config moniker for the module
+     * @param labels The labels for the module factory
+     * @returns A module factory that matches the supplied moniker and labels or throws if one is not found
+     */
+    locate<TProvider extends Provider<ProviderMoniker>>(moniker: ProviderMoniker, labels?: Labels): CreatableProviderFactory<CreatableProviderInstance<TProvider>> | LabeledCreatableProviderFactory<CreatableProviderInstance<TProvider>> | undefined;
+    merge(locator: ProviderFactoryLocatorInstance): ProviderFactoryLocatorInstance;
+    /**
+     * Registers a single module factory (with optional tags) with the locator
+     * @param factory The factory to register
+     * @param labels The labels for the module factory
+     */
+    register(factory: CreatableProviderFactory, labels?: Labels, primary?: boolean | ProviderMoniker | ProviderMoniker[]): ProviderFactoryLocatorInstance;
+    /**
+     * Registers multiple module factories with the locator
+     * @param factories The factories to register
+     */
+    registerMany(factories: CreatableProviderFactory[]): ProviderFactoryLocatorInstance;
+    registered(moniker: ProviderMoniker): boolean;
+    tryGetInstance<TProvider extends Provider<ProviderMoniker>>(moniker: TProvider['moniker'], options?: ProviderFactoryGetInstanceOptions): Promise<CreatableProviderInstance<TProvider> | undefined>;
+    /**
+     * Tries to locate a module factory that matches the supplied moniker and labels
+     * @param moniker The config moniker for the module
+     * @param labels The labels for the module factory
+     * @returns A module factory that matches the supplied moniker and labels or undefined
+     */
+    tryLocate<TProvider extends Provider<ProviderMoniker>>(moniker: ProviderMoniker, labels?: Labels): CreatableProviderFactory<CreatableProviderInstance<TProvider>> | LabeledCreatableProviderFactory<CreatableProviderInstance<TProvider>> | undefined;
+    validateDependencies(): void;
+}
+//# sourceMappingURL=ProviderFactoryLocatorInstance.d.ts.map

package/dist/node/CreatableProvider/ProviderFactoryLocatorInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProviderFactoryLocatorInstance.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/ProviderFactoryLocatorInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAE9E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAA;AACjG,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAA;AAC/E,OAAO,KAAK,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAA;AAChF,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,sCAAsC,CAAA;AAE3F,sDAAsD;AACtD,MAAM,WAAW,8BAA8B,CAAC,CAAC,SAAS,wBAAwB,GAAG,wBAAwB;IAE3G,OAAO,EAAE,CAAC,CAAA;IAEV;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC,yBAAyB,CAAC,CAAA;IAE7C,MAAM,IAAI,IAAI,CAAA;IAEd,WAAW,CAAC,SAAS,SAAS,QAAQ,CAAC,eAAe,CAAC,EACrD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,OAAO,CAAC,EAAE,iCAAiC,GAC1C,OAAO,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,CAAA;IAEhD;;;;;OAKG;IACH,MAAM,CAAC,SAAS,SAAS,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,MAAM,GAC3F,wBAAwB,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,GAAG,+BAA+B,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IAEpJ,KAAK,CAAC,OAAO,EAAE,8BAA8B,GAAG,8BAA8B,CAAA;IAE9E;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,wBAAwB,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,eAAe,GAAG,eAAe,EAAE,GAAG,8BAA8B,CAAA;IAErJ;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,wBAAwB,EAAE,GAAG,8BAA8B,CAAA;IAEnF,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAA;IAE7C,cAAc,CAAC,SAAS,SAAS,QAAQ,CAAC,eAAe,CAAC,EACxD,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,EAC7B,OAAO,CAAC,EAAE,iCAAiC,GAC1C,OAAO,CAAC,yBAAyB,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC,CAAA;IAE5D;;;;;OAKG;IACH,SAAS,CAAC,SAAS,SAAS,QAAQ,CAAC,eAAe,CAAC,EACnD,OAAO,EAAE,eAAe,EACxB,MAAM,CAAC,EAAE,MAAM,GACd,wBAAwB,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,GAAG,+BAA+B,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC,GAAG,SAAS,CAAA;IAErJ,oBAAoB,IAAI,IAAI,CAAA;CAC7B"}

package/dist/node/CreatableProvider/index.d.ts

@@ -0,0 +1,9 @@
+export * from './AbstractCreatableProvider.ts';
+export * from './CreatableProvider.ts';
+export * from './CreatableProviderRegistry.ts';
+export * from './GetInstanceOptions.ts';
+export * from './LabeledCreatableProviderFactory.ts';
+export * from './ProviderFactory.ts';
+export * from './ProviderFactoryLocator.ts';
+export * from './ProviderFactoryLocatorInstance.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/CreatableProvider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/CreatableProvider/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,yBAAyB,CAAA;AACvC,cAAc,sCAAsC,CAAA;AACpD,cAAc,sBAAsB,CAAA;AACpC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,qCAAqC,CAAA"}

package/dist/node/SignedBigInt.d.ts

@@ -0,0 +1,22 @@
+import { type Hex } from '@xylabs/sdk';
+/** Represents a negative bigint value stored as a hex string */
+export interface NegativeBigInt {
+    negative: Hex;
+}
+/** Represents a positive bigint value stored as a hex string */
+export interface PositiveBigInt {
+    positive: Hex;
+}
+/** A signed bigint value represented as either a negative or positive hex string */
+export type SignedBigInt = NegativeBigInt | PositiveBigInt;
+/** Type guard that checks if a value is a NegativeBigInt */
+export declare const isNegativeBigInt: (value: unknown) => value is NegativeBigInt;
+/** Type guard that checks if a value is a PositiveBigInt */
+export declare const isPositiveBigInt: (value: unknown) => value is PositiveBigInt;
+/** parseSignedBigInt constant. */
+export declare const parseSignedBigInt: (value: SignedBigInt) => bigint;
+/** toSignedBigInt constant. */
+export declare const toSignedBigInt: (value: bigint) => SignedBigInt;
+/** toPositiveBigInt constant. */
+export declare const toPositiveBigInt: (value: unknown) => PositiveBigInt;
+//# sourceMappingURL=SignedBigInt.d.ts.map

package/dist/node/SignedBigInt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignedBigInt.d.ts","sourceRoot":"","sources":["../../src/SignedBigInt.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,GAAG,EAGT,MAAM,aAAa,CAAA;AAGpB,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,GAAG,CAAA;CACd;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,GAAG,CAAA;CACd;AAED,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,cAAc,CAAA;AAE1D,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAE1D,CAAA;AAED,4DAA4D;AAC5D,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,cAE1D,CAAA;AAED,kCAAkC;AAClC,eAAO,MAAM,iBAAiB,GAAI,OAAO,YAAY,KAAG,MAQvD,CAAA;AAED,+BAA+B;AAC/B,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,YAE9C,CAAA;AAED,iCAAiC;AACjC,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,cAWjD,CAAA"}