@xyo-network/xl1-protocol-sdk 4.0.10 → 4.0.12

package/dist/node/capabilities/factoryBrand.d.ts

@@ -1,46 +0,0 @@
-import type { CreatableProviderFactory } from '../CreatableProvider/index.ts';
-import type { BackingNeed } from './Backing.ts';
-/**
- * Phantom-typed brand on `CreatableProviderFactory` recording which backings
- * the factory's underlying provider needs.
- *
- * Purely a compile-time tag — there is no runtime impact. Runtime callers
- * that don't care can keep using the bare `CreatableProviderFactory` type;
- * locators that want to enforce a backing-subset rule at compile time can
- * accept `BrandedFactory<L>` parameters that constrain what factories may be
- * registered.
- */
-export type BrandedFactory<B extends readonly BackingNeed[] = readonly BackingNeed[]> = CreatableProviderFactory & {
-    readonly __backings?: B;
-};
-/**
- * Brand a factory with the backings it depends on. Returns the same value at
- * runtime — the brand is only a phantom type.
- *
- * @example
- *   const f = backedFactory(
- *     [{ backing: 'chain-store', mode: 'write' }] as const,
- *     SimpleFinalizationRunner.factory(SimpleFinalizationRunner.dependencies, {...}),
- *   )
- *   // f is BrandedFactory<readonly [{backing: 'chain-store', mode: 'write'}]>
- */
-export declare function backedFactory<B extends readonly BackingNeed[]>(_backings: B, factory: CreatableProviderFactory): BrandedFactory<B>;
-/**
- * Helper: brand a factory as needing only the network transport. Convenient
- * shorthand for `JsonRpc*` factories.
- */
-export declare function networkBackedFactory(factory: CreatableProviderFactory): BrandedFactory<readonly [{
-    readonly backing: 'network';
-    readonly mode: 'read';
-}]>;
-/**
- * Runtime check: is `factory`'s declared backings a subset of `availableBackings`?
- *
- * The brand is type-only, so at runtime we have no way to inspect what backings
- * the factory was branded with. This helper exists for cases where the caller
- * has the backings array separately (e.g. from the descriptor that built the
- * factory) and wants a runtime gate. Use `backingsSatisfied` directly with the
- * descriptor's `backings` field.
- */
-export declare function factoryBackingsCompatible(declared: readonly BackingNeed[], available: readonly BackingNeed[]): boolean;
-//# sourceMappingURL=factoryBrand.d.ts.map

package/dist/node/capabilities/factoryBrand.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"factoryBrand.d.ts","sourceRoot":"","sources":["../../../src/capabilities/factoryBrand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAA;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C;;;;;;;;;GASG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,GAAG,SAAS,WAAW,EAAE,IAChF,wBAAwB,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,CAAA;CAAE,CAAA;AAE1D;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,WAAW,EAAE,EAC5D,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAAC,CAAC,CAAC,CAEnB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,wBAAwB,GAChC,cAAc,CAAC,SAAS,CAAC;IAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAEnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,SAAS,EAAE,SAAS,WAAW,EAAE,GAChC,OAAO,CAET"}

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

@@ -1,12 +0,0 @@
-export * from './Backing.ts';
-export * from './Capability.ts';
-export * from './connectionSubsetBySurface.ts';
-export * from './connectionTypes.ts';
-export * from './factoryBrand.ts';
-export * from './locatorFromConfig.ts';
-export * from './needsFromProviderBindings.ts';
-export * from './Provider.ts';
-export * from './providerCandidateFromClass.ts';
-export * from './resolveProviders.ts';
-export * from './surfaceMap.ts';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AACjC,cAAc,wBAAwB,CAAA;AACtC,cAAc,gCAAgC,CAAA;AAC9C,cAAc,eAAe,CAAA;AAC7B,cAAc,iCAAiC,CAAA;AAC/C,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA"}

package/dist/node/capabilities/locatorFromConfig.d.ts

@@ -1,29 +0,0 @@
-import type { ProviderMoniker } from '@xyo-network/xl1-protocol-model';
-import type { LocatorConfig } from '../config/LocatorConfigFields.ts';
-import { ProviderFactoryLocator } from '../CreatableProvider/ProviderFactoryLocator.ts';
-import type { CreatableProviderContext } from '../model/index.ts';
-import type { ProviderDescriptor } from './Provider.ts';
-import { type ResolutionPlan } from './resolveProviders.ts';
-/** Options for building a locator from config-driven provider resolution. */
-export interface LocatorFromConfigOptions {
-    readonly candidates: readonly ProviderDescriptor[];
-    readonly config: LocatorConfig;
-    readonly context?: Omit<CreatableProviderContext, 'config' | 'locator'>;
-    readonly needs: ReadonlySet<ProviderMoniker>;
-}
-/**
- * Resolves which provider classes to register for the given config bindings.
- * Selection uses only `providerBindings` + `connections` — no runtime preconditions.
- */
-export declare function resolveProvidersFromConfig(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor[], config: LocatorConfig): ResolutionPlan;
-/**
- * Registers factories for a resolution plan. Params are empty — implementations
- * are expected to read their bound connection from `context.config` at runtime.
- */
-export declare function registerFactoriesFromPlan(locator: ProviderFactoryLocator, plan: ResolutionPlan): void;
-/**
- * Builds a `ProviderFactoryLocator` from config: resolve candidates, then register
- * winning factories. Connection profiles come from config, not factory params.
- */
-export declare function locatorFromConfig(options: LocatorFromConfigOptions): ProviderFactoryLocator;
-//# sourceMappingURL=locatorFromConfig.d.ts.map

package/dist/node/capabilities/locatorFromConfig.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"locatorFromConfig.d.ts","sourceRoot":"","sources":["../../../src/capabilities/locatorFromConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAA;AAErE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAA;AACvF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACvD,OAAO,EAAE,KAAK,cAAc,EAAoB,MAAM,uBAAuB,CAAA;AAE7E,6EAA6E;AAC7E,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAClD,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,wBAAwB,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAA;IACvE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,CAAA;CAC7C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,MAAM,EAAE,aAAa,GACpB,cAAc,CAMhB;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,sBAAsB,EAC/B,IAAI,EAAE,cAAc,GACnB,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,wBAAwB,GAChC,sBAAsB,CAWxB"}

package/dist/node/capabilities/needsFromProviderBindings.d.ts

@@ -1,8 +0,0 @@
-import type { ProviderMoniker } from '@xyo-network/xl1-protocol-model';
-import type { Config } from '../config/Config.ts';
-import type { ConnectionKind } from '../config/connections/Connection.ts';
-/** Derives resolution needs from every moniker declared in `providerBindings`. */
-export declare function needsFromProviderBindings(config: Pick<Config, 'providerBindings'>): ReadonlySet<ProviderMoniker>;
-/** Derives needs for monikers whose bound connection matches one of the given types. */
-export declare function needsFromConnectionTypes(config: Pick<Config, 'connections' | 'providerBindings'>, connectionTypes: readonly ConnectionKind[]): ReadonlySet<ProviderMoniker>;
-//# sourceMappingURL=needsFromProviderBindings.d.ts.map

package/dist/node/capabilities/needsFromProviderBindings.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"needsFromProviderBindings.d.ts","sourceRoot":"","sources":["../../../src/capabilities/needsFromProviderBindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAA;AAEzE,kFAAkF;AAClF,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,CAAC,GACvC,WAAW,CAAC,eAAe,CAAC,CAE9B;AAED,wFAAwF;AACxF,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,aAAa,GAAG,kBAAkB,CAAC,EACxD,eAAe,EAAE,SAAS,cAAc,EAAE,GACzC,WAAW,CAAC,eAAe,CAAC,CAgB9B"}

package/dist/node/capabilities/providerCandidateFromClass.d.ts

@@ -1,7 +0,0 @@
-import type { CreatableProvider } from '../CreatableProvider/CreatableProvider.ts';
-import type { ProviderDescriptor } from './Provider.ts';
-/** Derives a resolution candidate from a `CreatableProvider` implementation class. */
-export declare function providerCandidateFromClass(creatableProvider: CreatableProvider, id?: string): ProviderDescriptor;
-/** Derives resolution candidates from a list of provider implementation classes. */
-export declare function providerCandidatesFromClasses(creatableProviders: readonly CreatableProvider[]): ProviderDescriptor[];
-//# sourceMappingURL=providerCandidateFromClass.d.ts.map

package/dist/node/capabilities/providerCandidateFromClass.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"providerCandidateFromClass.d.ts","sourceRoot":"","sources":["../../../src/capabilities/providerCandidateFromClass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2CAA2C,CAAA;AAClF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,sFAAsF;AACtF,wBAAgB,0BAA0B,CACxC,iBAAiB,EAAE,iBAAiB,EACpC,EAAE,GAAE,MAA+B,GAClC,kBAAkB,CASpB;AAED,oFAAoF;AACpF,wBAAgB,6BAA6B,CAC3C,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,GAC/C,kBAAkB,EAAE,CAEtB"}

package/dist/node/capabilities/resolveProviders.d.ts

@@ -1,56 +0,0 @@
-import type { ProviderMoniker } from '@xyo-network/xl1-protocol-model';
-import type { ConnectionConfig } from '../config/connections/Connection.ts';
-import type { ProviderDescriptor } from './Provider.ts';
-export interface ResolutionPlan {
-    /** Capability moniker -> winning descriptor id (for snapshot diffing). */
-    readonly bindings: Readonly<Record<ProviderMoniker, string>>;
-    /** Descriptors that lost; included for diagnostics. */
-    readonly rejected: readonly RejectedDescriptor[];
-    /** Descriptors that should be instantiated, in topological order. */
-    readonly selected: readonly ProviderDescriptor[];
-}
-export interface RejectedDescriptor {
-    readonly descriptor: ProviderDescriptor;
-    readonly reason: string;
-}
-export declare class MissingCapabilityError extends Error {
-    readonly moniker: ProviderMoniker;
-    readonly reasons: readonly string[];
-    constructor(moniker: ProviderMoniker, reasons: readonly string[]);
-}
-export declare class AmbiguousProviderError extends Error {
-    readonly candidates: readonly string[];
-    readonly moniker: ProviderMoniker;
-    constructor(moniker: ProviderMoniker, candidates: readonly ProviderDescriptor[]);
-}
-export declare class UnboundProviderError extends Error {
-    readonly moniker: ProviderMoniker;
-    constructor(moniker: ProviderMoniker);
-}
-export declare class UnknownConnectionError extends Error {
-    readonly connectionName: string;
-    readonly moniker: ProviderMoniker;
-    constructor(moniker: ProviderMoniker, connectionName: string);
-}
-interface ProviderBindingLike {
-    connection?: string;
-}
-export interface ResolveProvidersOptions {
-    readonly connections?: Readonly<Record<string, ConnectionConfig>>;
-    readonly providerBindings?: Readonly<Partial<Record<ProviderMoniker, ProviderBindingLike>>>;
-}
-/**
- * Plans which providers to register for a given set of needs.
- *
- * 1. Fixpoint-expand monikers from selected descriptor `dependencies`.
- * 2. Require `providerBindings[moniker].connection` for every connection-consuming
- *    moniker. A moniker satisfied by a single wildcard candidate consumes no
- *    connection of its own (it delegates storage to its dependencies) and binds
- *    directly, with no binding required.
- * 3. Filter candidates by bound connection type.
- * 4. Throw when zero or multiple candidates remain.
- * 5. Toposort selected descriptors using `dependencies`.
- */
-export declare function resolveProviders(needs: ReadonlySet<ProviderMoniker>, candidates: readonly ProviderDescriptor[], options?: ResolveProvidersOptions): ResolutionPlan;
-export {};
-//# sourceMappingURL=resolveProviders.d.ts.map

package/dist/node/capabilities/resolveProviders.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"resolveProviders.d.ts","sourceRoot":"","sources":["../../../src/capabilities/resolveProviders.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAA;AAEtE,OAAO,KAAK,EAAE,gBAAgB,EAAkB,MAAM,qCAAqC,CAAA;AAE3F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAEvD,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC,CAAA;IAC5D,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;IAChD,qEAAqE;IACrE,QAAQ,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACjD;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAA;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;gBAEvB,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE;CAOjE;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,SAAS,kBAAkB,EAAE;CAShF;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe;CAKrC;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;gBAErB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM;CAQ7D;AAED,UAAU,mBAAmB;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAA;IACjE,QAAQ,CAAC,gBAAgB,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAA;CAC5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,CAAC,eAAe,CAAC,EACnC,UAAU,EAAE,SAAS,kBAAkB,EAAE,EACzC,OAAO,GAAE,uBAA4B,GACpC,cAAc,CAsBhB"}

package/dist/node/capabilities/surfaceMap.d.ts

@@ -1,11 +0,0 @@
-import type { Surface } from './Backing.ts';
-export declare function surfaceForBranch(branch: string): Surface | undefined;
-/**
- * Branch keys on `XyoViewer` that may need to be filtered by surface.
- * `connectionSubsetBySurface` iterates over this list to decide what to keep.
- *
- * Each entry is `[viewerKey, fully-qualified-branch-key]`.
- */
-export declare const VIEWER_BRANCH_KEYS: readonly [readonly ["block", "viewer.block"], readonly ["transaction", "viewer.transaction"], readonly ["mempool", "viewer.mempool"], readonly ["finalization", "viewer.finalization"], readonly ["time", "viewer.time"], readonly ["account", "viewer.account.balance"], readonly ["networkStake", "viewer.networkStake"], readonly ["stake", "viewer.stake"], readonly ["step", "viewer.step"]];
-export type ViewerBranchKey = (typeof VIEWER_BRANCH_KEYS)[number][0];
-//# sourceMappingURL=surfaceMap.d.ts.map

package/dist/node/capabilities/surfaceMap.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"surfaceMap.d.ts","sourceRoot":"","sources":["../../../src/capabilities/surfaceMap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAgC3C,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAEpE;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,mYAUrB,CAAA;AAEV,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA"}