@layerzerolabs/base-definitions 0.0.2 → 0.0.6

package/dist/VO33UEHJ.cjs

@@ -0,0 +1,136 @@
+'use strict';
+
+var YJF4D23A_cjs = require('./YJF4D23A.cjs');
+var dfs = require('@layerzerolabs/dfs');
+
+var RegistrarBuilder = class {
+  static {
+    YJF4D23A_cjs.__name(this, "RegistrarBuilder");
+  }
+  defaultHandler;
+  constructor() {
+    this.defaultHandler = async (node) => {
+      throw new Error(`This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`);
+    };
+  }
+  classHandlers = [];
+  classAliases = [];
+  /**
+   * Add a function fn to be called on all nodes of class
+   * @param nodeClass
+   * @param identifier
+   * @param fn
+   */
+  addClassHandler(nodeClass, identifier, fn) {
+    if (this.classAliases.find(({ fromNodeClass }) => fromNodeClass === nodeClass)) {
+      throw new Error(`Cannot define a handler for a class that is aliased to something else. This would be pointless`);
+    }
+    let i = 0;
+    for (const handler of this.classHandlers) {
+      if (handler.nodeClass === nodeClass) {
+        this.classHandlers[i] = {
+          nodeClass,
+          identifier,
+          fn
+        };
+        return this;
+      }
+      if (handler.nodeClass.prototype.isPrototypeOf(nodeClass.prototype)) {
+        this.classHandlers.splice(i, 0, {
+          nodeClass,
+          identifier,
+          fn
+        });
+        return this;
+      }
+      i++;
+    }
+    this.classHandlers.push({
+      nodeClass,
+      identifier,
+      fn
+    });
+    return this;
+  }
+  /**
+   * Alias some class *from*, such that any node of that class in the tree will be
+   * treated as though it were some other node *to*. The *to* node is given as a
+   * function returning a class instance, so that its dependencies, name, etc can be fixed.
+   * The registrar will ignore the dependencies of the original node, and follow the alias's
+   * dependencies instead.
+   *
+   * Additionally, this method does not affect the typing of the registrar. The output type
+   * of the build() method will not reflect the alias.
+   *
+   * @param fromNodeClass alias instances of this class
+   * @param getToNode method that returns the *to* part of the alias
+   */
+  addClassAlias(fromNodeClass, getToNode) {
+    if (this.classHandlers.find(({ nodeClass }) => nodeClass === fromNodeClass)) {
+      throw new Error(`Cannot define an alias for a class that already has a handler`);
+    }
+    let i = 0;
+    for (const alias of this.classAliases) {
+      if (alias.fromNodeClass === fromNodeClass) {
+        this.classAliases[i] = {
+          fromNodeClass,
+          getToNode
+        };
+        return this;
+      }
+      if (alias.fromNodeClass.prototype.isPrototypeOf(fromNodeClass.prototype)) {
+        this.classAliases.splice(i, 0, {
+          fromNodeClass,
+          getToNode
+        });
+        return this;
+      }
+      i++;
+    }
+    this.classAliases.push({
+      fromNodeClass,
+      getToNode
+    });
+    return this;
+  }
+  /**
+   * Add a default function fn to be used on nodes whose types do not have handlers.
+   * If this is not set, the default behaviour will be to throw
+   * @param fn
+   */
+  addDefault(fn) {
+    this.defaultHandler = fn;
+    return this;
+  }
+  build() {
+    const mergedNodePrehandler = /* @__PURE__ */ YJF4D23A_cjs.__name((node) => {
+      for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {
+        if (node instanceof fromNodeClass) {
+          return toNode(node);
+        }
+      }
+      return node;
+    }, "mergedNodePrehandler");
+    const mergedNodeHandler = /* @__PURE__ */ YJF4D23A_cjs.__name(async (node) => {
+      for (const { nodeClass, identifier, fn } of this.classHandlers) {
+        if (node instanceof nodeClass) {
+          return {
+            key: identifier,
+            value: await fn(node)
+          };
+        }
+      }
+      return {
+        key: "default",
+        value: await this.defaultHandler(node)
+      };
+    }, "mergedNodeHandler");
+    return {
+      traverseDependencies: /* @__PURE__ */ YJF4D23A_cjs.__name(async (node) => await dfs.dfs(node, mergedNodeHandler, mergedNodePrehandler)(), "traverseDependencies")
+    };
+  }
+};
+
+exports.RegistrarBuilder = RegistrarBuilder;
+//# sourceMappingURL=VO33UEHJ.cjs.map
+//# sourceMappingURL=VO33UEHJ.cjs.map

package/dist/VO33UEHJ.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","node","Error","JSON","stringify","classHandlers","classAliases","addClassHandler","nodeClass","identifier","fn","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addDefault","build","mergedNodePrehandler","toNode","mergedNodeHandler","key","value","traverseDependencies","__name","dfs"],"mappings":"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","file":"VO33UEHJ.cjs","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nexport type { Registrar };\nimport { dfs } from '@layerzerolabs/dfs';\n\ntype NodeClass = new (...args: any[]) => DependencyNode<any, any>;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode<any, any>;\n\n/**\n * A builder class for a {@link Registrar}.\n * Builds a registrar that switches on node class--i.e., enables defining\n * specific registration behaviour for specific node classes.\n * Intelligently handles inheritance, always using the most specific\n * handler defined for any given class.\n * The registrar built shall return an object that maps from a handler ID,\n * to a map from node name to the return of each handler,\n * e.g., { objectNodes: { myObjectNode: 'my handler return' }}.\n * This can be used to extract a specific resolved value after resolving the tree,\n * given that the handlers return the resolved nodes.\n */\nexport class RegistrarBuilder<_ReturnTypes> {\n    protected defaultHandler: (node: DependencyNode<any, any>) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode<any, any>) => {\n            throw new Error(\n                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,\n            );\n        };\n    }\n\n    protected classHandlers: {\n        nodeClass: AbstractNodeClass;\n        identifier: string;\n        fn: (node: DependencyNode<any, any>) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode<any, any>) => DependencyNode<any, any>;\n    }[] = [];\n\n    /**\n     * Add a function fn to be called on all nodes of class\n     * @param nodeClass\n     * @param identifier\n     * @param fn\n     */\n    public addClassHandler<\n        Identifier extends string,\n        _NodeClass extends NodeClass,\n        Function extends (node: InstanceType<_NodeClass>) => any,\n    >(nodeClass: _NodeClass, identifier: Identifier, fn: Function) {\n        if (this.classAliases.find(({ fromNodeClass }) => fromNodeClass === nodeClass)) {\n            throw new Error(\n                `Cannot define a handler for a class that is aliased to something else. This would be pointless`,\n            );\n        }\n\n        let i = 0;\n        for (const handler of this.classHandlers) {\n            //check if we are overriding an existing handler\n            if (handler.nodeClass === nodeClass) {\n                this.classHandlers[i] = {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode<any, any>) => Promise<any>,\n                };\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            //check if the new handler has an ordering requirement against an existing handler\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (handler.nodeClass.prototype.isPrototypeOf(nodeClass.prototype)) {\n                this.classHandlers.splice(i, 0, {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode<any, any>) => Promise<any>,\n                });\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            i++;\n        }\n\n        this.classHandlers.push({\n            nodeClass,\n            identifier,\n            fn: fn as unknown as (node: DependencyNode<any, any>) => Promise<any>,\n        });\n\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                [K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Alias some class *from*, such that any node of that class in the tree will be\n     * treated as though it were some other node *to*. The *to* node is given as a\n     * function returning a class instance, so that its dependencies, name, etc can be fixed.\n     * The registrar will ignore the dependencies of the original node, and follow the alias's\n     * dependencies instead.\n     *\n     * Additionally, this method does not affect the typing of the registrar. The output type\n     * of the build() method will not reflect the alias.\n     *\n     * @param fromNodeClass alias instances of this class\n     * @param getToNode method that returns the *to* part of the alias\n     */\n    public addClassAlias<FromNodeClass extends AbstractNodeClass>(\n        fromNodeClass: FromNodeClass,\n        getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode<any, any>,\n    ) {\n        if (this.classHandlers.find(({ nodeClass }) => nodeClass === fromNodeClass)) {\n            throw new Error(`Cannot define an alias for a class that already has a handler`);\n        }\n\n        let i = 0;\n        for (const alias of this.classAliases) {\n            //check if we are overriding an existing alias\n            if (alias.fromNodeClass === fromNodeClass) {\n                this.classAliases[i] = {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (\n                        from: DependencyNode<any, any>,\n                    ) => DependencyNode<any, any>,\n                };\n\n                return this;\n            }\n            //check if the new alias has an ordering requirement against an existing alias\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (alias.fromNodeClass.prototype.isPrototypeOf(fromNodeClass.prototype)) {\n                this.classAliases.splice(i, 0, {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (\n                        from: DependencyNode<any, any>,\n                    ) => DependencyNode<any, any>,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (\n                from: DependencyNode<any, any>,\n            ) => DependencyNode<any, any>,\n        });\n\n        return this;\n    }\n\n    /**\n     * Add a default function fn to be used on nodes whose types do not have handlers.\n     * If this is not set, the default behaviour will be to throw\n     * @param fn\n     */\n    public addDefault(fn: (node: DependencyNode<any, any>) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode<any, any>) => {\n            for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {\n                if (node instanceof fromNodeClass) {\n                    return toNode(node);\n                }\n            }\n            return node;\n        };\n\n        const mergedNodeHandler = async (node: DependencyNode<any, any>) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode<any, any>) =>\n                await dfs<any, _ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n"]}

package/dist/VUOMXK5T.js

@@ -0,0 +1,6 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+export { __name };
+//# sourceMappingURL=VUOMXK5T.js.map
+//# sourceMappingURL=VUOMXK5T.js.map

package/dist/VUOMXK5T.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"VUOMXK5T.js"}

package/dist/YJF4D23A.cjs

@@ -0,0 +1,8 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+exports.__name = __name;
+//# sourceMappingURL=YJF4D23A.cjs.map
+//# sourceMappingURL=YJF4D23A.cjs.map

package/dist/YJF4D23A.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"YJF4D23A.cjs"}

package/dist/definitions.cjs

@@ -1,17 +1,21 @@
 'use strict';
 
-require('reflect-metadata');
-var chunkE4NXJ2OV_cjs = require('./chunk-E4NXJ2OV.cjs');
+var LXFPNTIJ_cjs = require('./LXFPNTIJ.cjs');
+require('./YJF4D23A.cjs');
 
 
 
 Object.defineProperty(exports, "FactoryDefinition", {
   enumerable: true,
-  get: function () { return chunkE4NXJ2OV_cjs.FactoryDefinition; }
+  get: function () { return LXFPNTIJ_cjs.FactoryDefinition; }
 });
 Object.defineProperty(exports, "ObjectDefinition", {
   enumerable: true,
-  get: function () { return chunkE4NXJ2OV_cjs.ObjectDefinition; }
+  get: function () { return LXFPNTIJ_cjs.ObjectDefinition; }
+});
+Object.defineProperty(exports, "serializeDimensions", {
+  enumerable: true,
+  get: function () { return LXFPNTIJ_cjs.serializeDimensions; }
 });
 //# sourceMappingURL=definitions.cjs.map
 //# sourceMappingURL=definitions.cjs.map

package/dist/definitions.d.ts

@@ -1,35 +1,58 @@
-import type { z } from 'zod';
+import type { z } from 'zod/v4';
+import type { FunctionPointer } from '@layerzerolabs/common-utils';
 import type { Dependencies } from '@layerzerolabs/dependency-graph';
 import { DependencyNode } from '@layerzerolabs/dependency-graph';
-import type { IntersectionValueOf, RemoveNever } from '@layerzerolabs/typescript-utils';
-export type Factory<_Dependencies extends Dependencies, Dim extends z.ZodObject<any>, GetImplMetadata extends {
-    getModel: (dim: z.infer<Dim>) => any;
-}> = {
-    getImpl: (dim: z.infer<Dim>) => ReturnType<GetImplMetadata['getModel']>;
+import type { AdvancedRecord, AdvancedRecordLookup, Merge, MethodNameOf, RemoveNever, UnionToIntersection } from '@layerzerolabs/typescript-utils';
+export type DimensionToSchemaMap<DimConstraint extends object = object> = {
+    byDimension?: AdvancedRecord<DimConstraint, z.ZodType>;
+    base: z.ZodType;
 };
-export type GetFactory<_Dependencies extends Dependencies, Dim extends z.ZodObject<any>, GetImplMetadata extends {
-    getModel: (dim: z.infer<Dim>) => any;
-}> = () => Factory<_Dependencies, Dim, GetImplMetadata> | Promise<Factory<_Dependencies, Dim, GetImplMetadata>>;
-export type GetFactoryForDefinition<Definition> = GetFactory<Definition extends FactoryDefinition<any, any, any, infer D> ? D : never, Definition extends FactoryDefinition<any, infer D, any, any> ? D : never, Definition extends FactoryDefinition<any, any, infer G, any> ? G : never>;
-export declare class FactoryDefinition<Name extends string, Dim extends z.ZodObject<any>, GetImplMetadata extends {
-    getKey: (dim: z.infer<Dim>) => any;
-    getModel: (dim: z.infer<Dim>) => any;
-    revLookup: {
-        [key: string]: {
-            dim: z.infer<Dim>;
-            model: any;
-        };
-    };
-}, _Dependencies extends Dependencies> extends DependencyNode<Name, _Dependencies> {
+export type GetModelFromSchema<DMap extends DimensionToSchemaMap, Dim> = AdvancedRecordLookup<DMap['byDimension'], Dim> extends never ? z.infer<DMap['base']> : Merge<z.infer<DMap['base']>, z.infer<AdvancedRecordLookup<DMap['byDimension'], Dim>>>;
+type GetImplFunctionWithConditionalOptionalDim<Dim, Return> = {} extends Dim ? (dim?: Dim) => Return : (dim: Dim) => Return;
+type GetImplOverloads<Dim extends z.ZodObject<any>, DMap extends DimensionToSchemaMap<z.infer<Dim>>> = UnionToIntersection<{
+    [I in keyof DMap['byDimension']]: DMap['byDimension'][I] extends readonly [infer K, any] ? {
+        getImpl: GetImplFunctionWithConditionalOptionalDim<K, GetModelFromSchema<DMap, K>>;
+    } : never;
+}[keyof DMap['byDimension']] | {
+    getImpl: GetImplFunctionWithConditionalOptionalDim<z.infer<Dim>, z.infer<DMap['base']>>;
+}>;
+export type Factory<_Dependencies extends Dependencies, Dim extends z.ZodObject<any>, DMap extends DimensionToSchemaMap<z.infer<Dim>>> = {
+    implKeys: string[];
+} & GetImplOverloads<Dim, DMap>;
+export type GetFactory<_Dependencies extends Dependencies, Dim extends z.ZodObject<any>, DMap extends DimensionToSchemaMap<z.infer<Dim>>> = () => Factory<_Dependencies, Dim, DMap> | Promise<Factory<_Dependencies, Dim, DMap>>;
+/**
+ * Factory definitions are a type of dependency node that shall be resolved to a *factory*.
+ * A factory is an object that provides a getImpl method which accepts some parameters *dim*,
+ * and returns some object getImplMetadata.getModel(dim).
+ * That is, a factory definition is given by the set of parameters it uses to get its implementations,
+ * and a function defining the schema it will return for each set of parameters.
+ * @param name inherited from {@link DependencyNode}
+ * @param dependencies inherited from {@link DependencyNode}
+ * @param dimensions a Zod schema for the parameters this factory operates on.
+ * @param dimensionToSchemaMap A map from dimension objects to the Zod schema for the implementation.
+ * @param getFactory a method that should return an object with a getImpl method that returns
+ * entities adhering to the schema for the corresponding getModel call
+ */
+export declare class FactoryDefinition<Name extends string, Dim extends z.ZodObject<any>, DMap extends DimensionToSchemaMap<z.infer<Dim>>, _Dependencies extends Dependencies> extends DependencyNode<Name, _Dependencies> {
     readonly dimensions: Dim;
-    readonly getImplMetadata: GetImplMetadata;
-    readonly getFactory: GetFactory<_Dependencies, Dim, GetImplMetadata>;
-    constructor({ dimensions, getImplMetadata, getFactory, ...args }: {
+    readonly dimensionToSchemaMap: DMap;
+    readonly getFactory: GetFactory<_Dependencies, Dim, DMap>;
+    constructor({ dimensions, dimensionToSchemaMap, getFactory, ...args }: {
         dimensions: Dim;
-        getImplMetadata: GetImplMetadata;
-        getFactory: GetFactory<_Dependencies, Dim, GetImplMetadata>;
+        dimensionToSchemaMap: DMap;
+        getFactory: GetFactory<_Dependencies, Dim, DMap>;
     } & ConstructorParameters<typeof DependencyNode<Name, _Dependencies>>[0]);
 }
+/**
+ * An object definition is a dependency node that refers to some entity
+ * matching a given schema. That is, it may be resolved to any entity
+ * that adheres to the {@link schema}.
+ * The object definition is abstract, as it cannot be meaningfully resolved without
+ * additional information. For an example of an object definition, see ReflexiveObjectDefinition or ContextDefinition
+ * @param name inherited from {@link DependencyNode}
+ * @param dependencies inherited from {@link DependencyNode}
+ * @param schema a Zod schema defining the expected resolution for this definition
+ */
 export declare abstract class ObjectDefinition<Name extends string, Schema extends z.ZodSchema, _Dependencies extends Dependencies> extends DependencyNode<Name, _Dependencies> {
     readonly schema: Schema;
     constructor({ schema, ...args }: {
@@ -37,21 +60,39 @@ export declare abstract class ObjectDefinition<Name extends string, Schema exten
     } & ConstructorParameters<typeof DependencyNode<Name, _Dependencies>>[0]);
 }
 export type Definition<Name extends string> = FactoryDefinition<Name, any, any, any> | ObjectDefinition<Name, any, any>;
-export type DefinitionResolution<Definition extends DependencyNode<any, any>> = Definition extends ObjectDefinition<any, infer Schema, any> ? z.infer<Schema> : Definition extends FactoryDefinition<any, any, infer GetImpl, any> ? {
-    getImpl: GetImpl['getModel'];
-} : never;
-export type DefinitionsResolution<Deps extends Dependencies> = {
-    [Key in keyof Deps]: DefinitionResolution<Deps[Key]>;
+/**
+ * Infers the expected type of a definition once it has been resolved
+ */
+export type ResolvedDefinition<Definition extends DependencyNode<any, any>> = Definition extends ObjectDefinition<any, infer Schema, any> ? z.infer<Schema> : Definition extends FactoryDefinition<any, infer Dim, infer DMap, any> ? Factory<Definition['dependencies'], Dim, DMap> : Definition extends FactoryDefinition<any, any, any, any> ? Factory<Definition['dependencies'], Definition['dimensions'], Definition['dimensionToSchemaMap']> : unknown;
+/**
+ * Given a record from string to definition, maps each definition T to ResolvedDefinition<T>
+ */
+export type ResolvedDefinitionMap<Deps extends Dependencies> = {
+    [Key in keyof Deps]: ResolvedDefinition<Deps[Key]>;
 };
-export type DefinitionImplsResolution<Definition extends DependencyNode<any, any>, Dim> = Definition extends FactoryDefinition<any, infer _Dim, infer GetImpl, any> ? Dim extends z.infer<_Dim> ? IntersectionValueOf<{
-    [key in keyof GetImpl['revLookup']]: Dim extends GetImpl['revLookup'][key]['dim'] ? GetImpl['revLookup'][key]['model'] : GetImpl['revLookup']['__base']['model'];
-}> : never : never;
-export type DefinitionsImplsResolution<Deps extends Dependencies, Dim> = RemoveNever<{
-    [Key in keyof Deps]: DefinitionImplsResolution<Deps[Key], Dim>;
+/**
+ * For some factory definition F and some dimension D s.t. D ⊇ F.dimensions, infers the expected return type of
+ * ResolvedDefinition<F>.getImpl(D)
+ */
+export type ResolvedFactoryImplementation<Definition extends DependencyNode<any, any>, Dim> = Definition extends FactoryDefinition<any, any, any, any> ? GetModelFromSchema<Definition['dimensionToSchemaMap'], Dim> : never;
+/**
+ * Given a record from string to definition and some dimension D, maps each definition T to ResolvedFactoryImplementation<T, D>
+ */
+export type ResolvedFactoryImplementationMap<Deps extends Dependencies, Dim> = RemoveNever<{
+    [Key in keyof Deps]: ResolvedFactoryImplementation<Deps[Key], Dim>;
 }>;
-export type Context<Deps extends Dependencies, Dim> = {
-    dependencies: DefinitionsResolution<Deps>;
-    impls: DefinitionsImplsResolution<Deps, Dim>;
-    dim: Dim;
+type ActivityFactoryContext<_FactoryDefinition extends FactoryDefinition<any, any, any, any>, Dim> = {
+    getFunctionPointer: _FactoryDefinition extends FactoryDefinition<any, any, any, any> ? <MethodName extends MethodNameOf<ResolvedFactoryImplementation<_FactoryDefinition, Dim>>>(methodName: MethodName) => FunctionPointer<ResolvedFactoryImplementation<_FactoryDefinition, Dim>[MethodName]> : never;
 };
+/**
+ * The parameters that shall be received by a factory's implementation getter
+ */
+export type Context<_FactoryDefinition extends FactoryDefinition<any, any, any, any>, Dim> = {
+    name: _FactoryDefinition extends FactoryDefinition<infer Name, any, any, any> ? Name : never;
+    dependencies: _FactoryDefinition extends FactoryDefinition<any, any, any, infer Deps> ? ResolvedDefinitionMap<Deps> : never;
+    dim: Dim;
+    impls: _FactoryDefinition extends FactoryDefinition<any, any, any, infer Deps> ? ResolvedFactoryImplementationMap<Deps, Dim> : never;
+} & ActivityFactoryContext<_FactoryDefinition, Dim>;
+export declare const serializeDimensions: (dim?: object) => string;
+export {};
 //# sourceMappingURL=definitions.d.ts.map

package/dist/definitions.d.ts.map

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

package/dist/definitions.js

@@ -1,4 +1,4 @@
-import 'reflect-metadata';
-export { FactoryDefinition, ObjectDefinition } from './chunk-ALVDFXDA.js';
+export { FactoryDefinition, ObjectDefinition, serializeDimensions } from './RWF76TF5.js';
+import './VUOMXK5T.js';
 //# sourceMappingURL=definitions.js.map
 //# sourceMappingURL=definitions.js.map

package/dist/index.cjs

@@ -1,22 +1,36 @@
 'use strict';
 
-require('reflect-metadata');
-var chunkE4NXJ2OV_cjs = require('./chunk-E4NXJ2OV.cjs');
-var chunkH2WIRLVA_cjs = require('./chunk-H2WIRLVA.cjs');
+var _67HCA6YT_cjs = require('./67HCA6YT.cjs');
+var VO33UEHJ_cjs = require('./VO33UEHJ.cjs');
+var E2YEEYRA_cjs = require('./E2YEEYRA.cjs');
+var LXFPNTIJ_cjs = require('./LXFPNTIJ.cjs');
+require('./YJF4D23A.cjs');
 
 
 
+Object.defineProperty(exports, "DependencyStore", {
+  enumerable: true,
+  get: function () { return _67HCA6YT_cjs.DependencyStore; }
+});
+Object.defineProperty(exports, "RegistrarBuilder", {
+  enumerable: true,
+  get: function () { return VO33UEHJ_cjs.RegistrarBuilder; }
+});
+Object.defineProperty(exports, "extractSchemaFromFactory", {
+  enumerable: true,
+  get: function () { return E2YEEYRA_cjs.extractSchemaFromFactory; }
+});
 Object.defineProperty(exports, "FactoryDefinition", {
   enumerable: true,
-  get: function () { return chunkE4NXJ2OV_cjs.FactoryDefinition; }
+  get: function () { return LXFPNTIJ_cjs.FactoryDefinition; }
 });
 Object.defineProperty(exports, "ObjectDefinition", {
   enumerable: true,
-  get: function () { return chunkE4NXJ2OV_cjs.ObjectDefinition; }
+  get: function () { return LXFPNTIJ_cjs.ObjectDefinition; }
 });
-Object.defineProperty(exports, "RegistrarBuilder", {
+Object.defineProperty(exports, "serializeDimensions", {
   enumerable: true,
-  get: function () { return chunkH2WIRLVA_cjs.RegistrarBuilder; }
+  get: function () { return LXFPNTIJ_cjs.serializeDimensions; }
 });
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.ts

@@ -1,3 +1,5 @@
 export * from './definitions';
+export * from './lzyringe';
 export * from './registrarBuilder';
+export * from './utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,5 +1,7 @@
-import 'reflect-metadata';
-export { FactoryDefinition, ObjectDefinition } from './chunk-ALVDFXDA.js';
-export { RegistrarBuilder } from './chunk-3HJUWVUI.js';
+export { DependencyStore } from './O4SGLGEI.js';
+export { RegistrarBuilder } from './S2FOVFOI.js';
+export { extractSchemaFromFactory } from './MELXRRC4.js';
+export { FactoryDefinition, ObjectDefinition, serializeDimensions } from './RWF76TF5.js';
+import './VUOMXK5T.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/lzyringe.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var _67HCA6YT_cjs = require('./67HCA6YT.cjs');
+require('./YJF4D23A.cjs');
+
+
+
+Object.defineProperty(exports, "DependencyStore", {
+  enumerable: true,
+  get: function () { return _67HCA6YT_cjs.DependencyStore; }
+});
+//# sourceMappingURL=lzyringe.cjs.map
+//# sourceMappingURL=lzyringe.cjs.map

package/dist/lzyringe.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"lzyringe.cjs"}

package/dist/lzyringe.d.ts

@@ -0,0 +1,24 @@
+export declare class DependencyStore {
+    private store;
+    private throwIfRegistered;
+    private throwIfUnregistered;
+    /** Registers a value that will be resolved literally by resolve()
+     * @throws if already registered
+     */
+    register(key: string, value: any): void;
+    /** Registers a factory function that will be called by resolve()
+     * @throws if already registered
+     */
+    registerFactory(key: string, factory: () => any): void;
+    /** Unregisters a key
+     * @throws if not registered
+     */
+    unregister(key: string): void;
+    /**
+     * Drops all registered values
+     */
+    invalidate(): void;
+    /** Resolves a key to a value */
+    resolve(key: string): any;
+}
+//# sourceMappingURL=lzyringe.d.ts.map

package/dist/lzyringe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lzyringe.d.ts","sourceRoot":"","sources":["../src/lzyringe.ts"],"names":[],"mappings":"AAUA,qBAAa,eAAe;IACxB,OAAO,CAAC,KAAK,CAA4C;IAEzD,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACI,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAKvC;;OAEG;IACI,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAKtD;;OAEG;IACI,UAAU,CAAC,GAAG,EAAE,MAAM;IAK7B;;OAEG;IACI,UAAU;IAIjB,gCAAgC;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM;CAK7B"}

package/dist/lzyringe.js

@@ -0,0 +1,4 @@
+export { DependencyStore } from './O4SGLGEI.js';
+import './VUOMXK5T.js';
+//# sourceMappingURL=lzyringe.js.map
+//# sourceMappingURL=lzyringe.js.map

package/dist/lzyringe.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"lzyringe.js"}

package/dist/registrarBuilder.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
-require('reflect-metadata');
-var chunkH2WIRLVA_cjs = require('./chunk-H2WIRLVA.cjs');
+var VO33UEHJ_cjs = require('./VO33UEHJ.cjs');
+require('./YJF4D23A.cjs');
 
 
 
 Object.defineProperty(exports, "RegistrarBuilder", {
   enumerable: true,
-  get: function () { return chunkH2WIRLVA_cjs.RegistrarBuilder; }
+  get: function () { return VO33UEHJ_cjs.RegistrarBuilder; }
 });
 //# sourceMappingURL=registrarBuilder.cjs.map
 //# sourceMappingURL=registrarBuilder.cjs.map

package/dist/registrarBuilder.d.ts

@@ -1,29 +1,61 @@
 import type { DependencyNode } from '@layerzerolabs/dependency-graph';
 import type { Registrar } from '@layerzerolabs/dfs';
 export type { Registrar };
+type NodeClass = new (...args: any[]) => DependencyNode<any, any>;
+type AbstractNodeClass = abstract new (...args: any[]) => DependencyNode<any, any>;
+/**
+ * A builder class for a {@link Registrar}.
+ * Builds a registrar that switches on node class--i.e., enables defining
+ * specific registration behaviour for specific node classes.
+ * Intelligently handles inheritance, always using the most specific
+ * handler defined for any given class.
+ * The registrar built shall return an object that maps from a handler ID,
+ * to a map from node name to the return of each handler,
+ * e.g., { objectNodes: { myObjectNode: 'my handler return' }}.
+ * This can be used to extract a specific resolved value after resolving the tree,
+ * given that the handlers return the resolved nodes.
+ */
 export declare class RegistrarBuilder<_ReturnTypes> {
     protected defaultHandler: (node: DependencyNode<any, any>) => Promise<any>;
     constructor();
     protected classHandlers: {
-        nodeClass: abstract new (...args: any[]) => DependencyNode<any, any>;
+        nodeClass: AbstractNodeClass;
         identifier: string;
         fn: (node: DependencyNode<any, any>) => Promise<any>;
     }[];
+    protected classAliases: {
+        fromNodeClass: AbstractNodeClass;
+        getToNode: (from: DependencyNode<any, any>) => DependencyNode<any, any>;
+    }[];
     /**
      * Add a function fn to be called on all nodes of class
      * @param nodeClass
      * @param identifier
      * @param fn
      */
-    addClassHandler<Identifier extends string, NodeClass extends new (...args: any[]) => DependencyNode<any, any>, Function extends (node: InstanceType<NodeClass>) => any>(nodeClass: NodeClass, identifier: Identifier, fn: Function): RegistrarBuilder<_ReturnTypes & { [K in Identifier]: {
+    addClassHandler<Identifier extends string, _NodeClass extends NodeClass, Function extends (node: InstanceType<_NodeClass>) => any>(nodeClass: _NodeClass, identifier: Identifier, fn: Function): RegistrarBuilder<_ReturnTypes & { [K in Identifier]: {
         [nodeName: string]: Awaited<ReturnType<Function>>;
     }; }>;
+    /**
+     * Alias some class *from*, such that any node of that class in the tree will be
+     * treated as though it were some other node *to*. The *to* node is given as a
+     * function returning a class instance, so that its dependencies, name, etc can be fixed.
+     * The registrar will ignore the dependencies of the original node, and follow the alias's
+     * dependencies instead.
+     *
+     * Additionally, this method does not affect the typing of the registrar. The output type
+     * of the build() method will not reflect the alias.
+     *
+     * @param fromNodeClass alias instances of this class
+     * @param getToNode method that returns the *to* part of the alias
+     */
+    addClassAlias<FromNodeClass extends AbstractNodeClass>(fromNodeClass: FromNodeClass, getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode<any, any>): this;
     /**
      * Add a default function fn to be used on nodes whose types do not have handlers.
      * If this is not set, the default behaviour will be to throw
      * @param fn
      */
-    addDefault(fn: (node: DependencyNode<any, any>) => Promise<any>): this;
+    addDefault(fn: (node: DependencyNode<any, any>) => any): this;
     build(): Registrar<_ReturnTypes>;
 }
 //# sourceMappingURL=registrarBuilder.d.ts.map

package/dist/registrarBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registrarBuilder.d.ts","sourceRoot":"","sources":["../src/registrarBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,CAAC;AAG1B,qBAAa,gBAAgB,CAAC,YAAY;IACtC,SAAS,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;;IAS3E,SAAS,CAAC,aAAa,EAAE;QACrB,SAAS,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACrE,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACxD,EAAE,CAAM;IAET;;;;;OAKG;IACI,eAAe,CAClB,UAAU,SAAS,MAAM,EACzB,SAAS,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,EAClE,QAAQ,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,KAAK,GAAG,EACzD,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,sCAavC,CAAC;;;IAoCtB;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC;IAK/D,KAAK,IAAI,SAAS,CAAC,YAAY,CAAC;CAqB1C"}
+{"version":3,"file":"registrarBuilder.d.ts","sourceRoot":"","sources":["../src/registrarBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,SAAS,EAAE,CAAC;AAG1B,KAAK,SAAS,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAClE,KAAK,iBAAiB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAEnF;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAgB,CAAC,YAAY;IACtC,SAAS,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;;IAS3E,SAAS,CAAC,aAAa,EAAE;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KACxD,EAAE,CAAM;IAET,SAAS,CAAC,YAAY,EAAE;QACpB,aAAa,EAAE,iBAAiB,CAAC;QACjC,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;KAC3E,EAAE,CAAM;IAET;;;;;OAKG;IACI,eAAe,CAClB,UAAU,SAAS,MAAM,EACzB,UAAU,SAAS,SAAS,EAC5B,QAAQ,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,KAAK,GAAG,EAC1D,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,sCAmBxC,CAAC;;;IAoCtB;;;;;;;;;;;;OAYG;IACI,aAAa,CAAC,aAAa,SAAS,iBAAiB,EACxD,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC;IA6C1F;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,GAAG;IAKtD,KAAK,IAAI,SAAS,CAAC,YAAY,CAAC;CA8B1C"}

package/dist/registrarBuilder.js

@@ -1,4 +1,4 @@
-import 'reflect-metadata';
-export { RegistrarBuilder } from './chunk-3HJUWVUI.js';
+export { RegistrarBuilder } from './S2FOVFOI.js';
+import './VUOMXK5T.js';
 //# sourceMappingURL=registrarBuilder.js.map
 //# sourceMappingURL=registrarBuilder.js.map