@layerzerolabs/base-definitions 0.0.66 → 0.0.73

package/.turbo/turbo-build.log

@@ -6,49 +6,49 @@
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.4.0
 CLI Using tsup config: /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions/tsup.config.ts
-CLI Target: es2022
+CLI Target: ES2023
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-CJS dist/definitions.cjs          742.00 B
-CJS dist/index.cjs                1.27 KB
-CJS dist/lzyringe.cjs             302.00 B
-CJS dist/JKTGUQY4.cjs             1.70 KB
-CJS dist/registrarBuilder.cjs     320.00 B
-CJS dist/utils.cjs                341.00 B
-CJS dist/EVDGRGJ5.cjs             4.11 KB
-CJS dist/OIBEOODK.cjs             812.00 B
-CJS dist/VTYVOFLM.cjs             1.68 KB
-CJS dist/YJF4D23A.cjs             245.00 B
-CJS dist/definitions.cjs.map      76.00 B
-CJS dist/index.cjs.map            70.00 B
-CJS dist/lzyringe.cjs.map         73.00 B
-CJS dist/JKTGUQY4.cjs.map         3.78 KB
-CJS dist/registrarBuilder.cjs.map 81.00 B
-CJS dist/utils.cjs.map            70.00 B
-CJS dist/EVDGRGJ5.cjs.map         11.41 KB
-CJS dist/OIBEOODK.cjs.map         1.83 KB
-CJS dist/VTYVOFLM.cjs.map         14.00 KB
-CJS dist/YJF4D23A.cjs.map         73.00 B
-CJS ⚡️ Build success in 278ms
 ESM dist/definitions.js          216.00 B
-ESM dist/index.js                361.00 B
+ESM dist/index.js                389.00 B
 ESM dist/lzyringe.js             146.00 B
 ESM dist/JJBD65HU.js             1.65 KB
-ESM dist/6D5TVHOU.js             4.01 KB
+ESM dist/registrarBuilder.js     191.00 B
+ESM dist/4DUQS2FO.js             4.51 KB
 ESM dist/utils.js                173.00 B
-ESM dist/registrarBuilder.js     163.00 B
 ESM dist/EAPC6542.js             733.00 B
-ESM dist/NQBJGAQC.js             1.47 KB
 ESM dist/VUOMXK5T.js             222.00 B
+ESM dist/NQBJGAQC.js             1.47 KB
 ESM dist/definitions.js.map      75.00 B
 ESM dist/index.js.map            69.00 B
 ESM dist/lzyringe.js.map         72.00 B
 ESM dist/JJBD65HU.js.map         3.78 KB
-ESM dist/6D5TVHOU.js.map         11.40 KB
-ESM dist/utils.js.map            69.00 B
 ESM dist/registrarBuilder.js.map 80.00 B
+ESM dist/4DUQS2FO.js.map         12.78 KB
+ESM dist/utils.js.map            69.00 B
 ESM dist/EAPC6542.js.map         1.82 KB
-ESM dist/NQBJGAQC.js.map         13.99 KB
 ESM dist/VUOMXK5T.js.map         72.00 B
-ESM ⚡️ Build success in 280ms
+ESM dist/NQBJGAQC.js.map         13.99 KB
+ESM ⚡️ Build success in 322ms
+CJS dist/index.cjs                1.42 KB
+CJS dist/lzyringe.cjs             302.00 B
+CJS dist/JKTGUQY4.cjs             1.70 KB
+CJS dist/O7HENH25.cjs             4.66 KB
+CJS dist/registrarBuilder.cjs     478.00 B
+CJS dist/utils.cjs                341.00 B
+CJS dist/VTYVOFLM.cjs             1.68 KB
+CJS dist/YJF4D23A.cjs             245.00 B
+CJS dist/OIBEOODK.cjs             812.00 B
+CJS dist/definitions.cjs          742.00 B
+CJS dist/index.cjs.map            70.00 B
+CJS dist/lzyringe.cjs.map         73.00 B
+CJS dist/JKTGUQY4.cjs.map         3.78 KB
+CJS dist/O7HENH25.cjs.map         12.79 KB
+CJS dist/registrarBuilder.cjs.map 81.00 B
+CJS dist/utils.cjs.map            70.00 B
+CJS dist/VTYVOFLM.cjs.map         14.00 KB
+CJS dist/YJF4D23A.cjs.map         73.00 B
+CJS dist/OIBEOODK.cjs.map         1.83 KB
+CJS dist/definitions.cjs.map      76.00 B
+CJS ⚡️ Build success in 323ms

package/.turbo/turbo-test.log

@@ -7,11 +7,11 @@ Breaking changes might not follow SemVer, please pin Vitest's version when using
 
  RUN  v3.2.3 /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
 
- ✓ test/registrarBuilder.test.ts (4 tests) 7ms
+ ✓ test/registrarBuilder.test.ts (4 tests) 9ms
 
  Test Files  1 passed (1)
       Tests  4 passed (4)
 Type Errors  no errors
-   Start at  18:03:19
-   Duration  566ms (transform 128ms, setup 0ms, collect 100ms, tests 7ms, environment 0ms, prepare 208ms)
+   Start at  20:21:28
+   Duration  596ms (transform 126ms, setup 0ms, collect 113ms, tests 9ms, environment 0ms, prepare 130ms)
 

package/dist/{6D5TVHOU.js → 4DUQS2FO.js}

@@ -128,7 +128,20 @@ var RegistrarBuilder = class {
     };
   }
 };
+var multiplexOrderedRegistrars = /* @__PURE__ */ __name((...registrars) => {
+  const multiplexRegistrar = {
+    traverseDependencies: /* @__PURE__ */ __name(async (...params) => {
+      const acc = {};
+      for (const [name, registrar] of registrars) {
+        const result = await registrar.traverseDependencies(...params);
+        acc[name] = result;
+      }
+      return acc;
+    }, "traverseDependencies")
+  };
+  return multiplexRegistrar;
+}, "multiplexOrderedRegistrars");
 
-export { RegistrarBuilder };
-//# sourceMappingURL=6D5TVHOU.js.map
-//# sourceMappingURL=6D5TVHOU.js.map
+export { RegistrarBuilder, multiplexOrderedRegistrars };
+//# sourceMappingURL=4DUQS2FO.js.map
+//# sourceMappingURL=4DUQS2FO.js.map

package/dist/4DUQS2FO.js.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","ancestry","key","value","traverseDependencies","dfs","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","acc","name","registrar","result"],"mappings":"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","file":"4DUQS2FO.js","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\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, ancestry: DependencyNode[]) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\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>, ancestry: DependencyNode[]) => 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) => 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) => 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) => 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,\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 (from: DependencyNode) => DependencyNode,\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 (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\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, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) =>\n                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n\nexport const multiplexOrderedRegistrars = <\n    const T extends [name: string, registrar: Registrar<{}>][],\n>(\n    ...registrars: T\n) => {\n    const multiplexRegistrar: Registrar<{\n        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]\n            ? Name\n            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;\n    }> = {\n        traverseDependencies: async (\n            ...params: Parameters<Registrar<any>['traverseDependencies']>\n        ) => {\n            const acc: Record<string, any> = {};\n            for (const [name, registrar] of registrars) {\n                const result = await registrar.traverseDependencies(...params);\n                acc[name] = result;\n            }\n\n            return acc;\n        },\n    } as any;\n\n    return multiplexRegistrar;\n};\n"]}

package/dist/{EVDGRGJ5.cjs → O7HENH25.cjs}

@@ -130,7 +130,21 @@ var RegistrarBuilder = class {
     };
   }
 };
+var multiplexOrderedRegistrars = /* @__PURE__ */ YJF4D23A_cjs.__name((...registrars) => {
+  const multiplexRegistrar = {
+    traverseDependencies: /* @__PURE__ */ YJF4D23A_cjs.__name(async (...params) => {
+      const acc = {};
+      for (const [name, registrar] of registrars) {
+        const result = await registrar.traverseDependencies(...params);
+        acc[name] = result;
+      }
+      return acc;
+    }, "traverseDependencies")
+  };
+  return multiplexRegistrar;
+}, "multiplexOrderedRegistrars");
 
 exports.RegistrarBuilder = RegistrarBuilder;
-//# sourceMappingURL=EVDGRGJ5.cjs.map
-//# sourceMappingURL=EVDGRGJ5.cjs.map
+exports.multiplexOrderedRegistrars = multiplexOrderedRegistrars;
+//# sourceMappingURL=O7HENH25.cjs.map
+//# sourceMappingURL=O7HENH25.cjs.map

package/dist/O7HENH25.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","__name","ancestry","key","value","traverseDependencies","dfs","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","acc","name","registrar","result"],"mappings":"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","file":"O7HENH25.cjs","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\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, ancestry: DependencyNode[]) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\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>, ancestry: DependencyNode[]) => 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) => 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) => 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) => 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,\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 (from: DependencyNode) => DependencyNode,\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 (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\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, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) =>\n                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n\nexport const multiplexOrderedRegistrars = <\n    const T extends [name: string, registrar: Registrar<{}>][],\n>(\n    ...registrars: T\n) => {\n    const multiplexRegistrar: Registrar<{\n        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]\n            ? Name\n            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;\n    }> = {\n        traverseDependencies: async (\n            ...params: Parameters<Registrar<any>['traverseDependencies']>\n        ) => {\n            const acc: Record<string, any> = {};\n            for (const [name, registrar] of registrars) {\n                const result = await registrar.traverseDependencies(...params);\n                acc[name] = result;\n            }\n\n            return acc;\n        },\n    } as any;\n\n    return multiplexRegistrar;\n};\n"]}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var JKTGUQY4_cjs = require('./JKTGUQY4.cjs');
-var EVDGRGJ5_cjs = require('./EVDGRGJ5.cjs');
+var O7HENH25_cjs = require('./O7HENH25.cjs');
 var OIBEOODK_cjs = require('./OIBEOODK.cjs');
 var VTYVOFLM_cjs = require('./VTYVOFLM.cjs');
 require('./YJF4D23A.cjs');
@@ -14,7 +14,11 @@ Object.defineProperty(exports, "DependencyStore", {
 });
 Object.defineProperty(exports, "RegistrarBuilder", {
   enumerable: true,
-  get: function () { return EVDGRGJ5_cjs.RegistrarBuilder; }
+  get: function () { return O7HENH25_cjs.RegistrarBuilder; }
+});
+Object.defineProperty(exports, "multiplexOrderedRegistrars", {
+  enumerable: true,
+  get: function () { return O7HENH25_cjs.multiplexOrderedRegistrars; }
 });
 Object.defineProperty(exports, "extractSchemaFromFactory", {
   enumerable: true,

package/dist/index.js

@@ -1,5 +1,5 @@
 export { DependencyStore } from './JJBD65HU.js';
-export { RegistrarBuilder } from './6D5TVHOU.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './4DUQS2FO.js';
 export { extractSchemaFromFactory } from './EAPC6542.js';
 export { FactoryDefinition, ObjectDefinition, deserializeDimensions, serializeDimensions } from './NQBJGAQC.js';
 import './VUOMXK5T.js';

package/dist/registrarBuilder.cjs

@@ -1,13 +1,17 @@
 'use strict';
 
-var EVDGRGJ5_cjs = require('./EVDGRGJ5.cjs');
+var O7HENH25_cjs = require('./O7HENH25.cjs');
 require('./YJF4D23A.cjs');
 
 
 
 Object.defineProperty(exports, "RegistrarBuilder", {
   enumerable: true,
-  get: function () { return EVDGRGJ5_cjs.RegistrarBuilder; }
+  get: function () { return O7HENH25_cjs.RegistrarBuilder; }
+});
+Object.defineProperty(exports, "multiplexOrderedRegistrars", {
+  enumerable: true,
+  get: function () { return O7HENH25_cjs.multiplexOrderedRegistrars; }
 });
 //# sourceMappingURL=registrarBuilder.cjs.map
 //# sourceMappingURL=registrarBuilder.cjs.map

package/dist/registrarBuilder.d.ts

@@ -59,4 +59,5 @@ export declare class RegistrarBuilder<_ReturnTypes> {
     addDefault(fn: (node: DependencyNode, ancestry: DependencyNode[]) => any): this;
     build(): Registrar<_ReturnTypes>;
 }
+export declare const multiplexOrderedRegistrars: <const T extends [name: string, registrar: Registrar<{}>][]>(...registrars: T) => Registrar<{ [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any] ? Name : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never; }>;
 //# 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;AAEpD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,KAAK,SAAS,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AACxD,KAAK,iBAAiB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB,CAAC,YAAY;IACtC,SAAS,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;;IAS7F,SAAS,CAAC,aAAa,EAAE;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KAC1E,EAAE,CAAM;IAET,SAAS,CAAC,YAAY,EAAE;QACpB,aAAa,EAAE,iBAAiB,CAAC;QACjC,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAC;KACvD,EAAE,CAAM;IAET;;;;;OAKG;IACI,eAAe,CAClB,UAAU,SAAS,MAAM,EACzB,UAAU,SAAS,SAAS,EAC5B,QAAQ,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG,EACtF,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,sCAmBxC,EAAE;;;IAoCvB;;;;;;;;;;;;OAYG;IACI,aAAa,CAAC,aAAa,SAAS,iBAAiB,EACxD,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,cAAc;IAuChF;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG;IAKxE,KAAK,IAAI,SAAS,CAAC,YAAY,CAAC;CA8B1C"}
+{"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;AAEpD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,KAAK,SAAS,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AACxD,KAAK,iBAAiB,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,qBAAa,gBAAgB,CAAC,YAAY;IACtC,SAAS,CAAC,cAAc,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;;IAS7F,SAAS,CAAC,aAAa,EAAE;QACrB,SAAS,EAAE,iBAAiB,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;KAC1E,EAAE,CAAM;IAET,SAAS,CAAC,YAAY,EAAE;QACpB,aAAa,EAAE,iBAAiB,CAAC;QACjC,SAAS,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAC;KACvD,EAAE,CAAM;IAET;;;;;OAKG;IACI,eAAe,CAClB,UAAU,SAAS,MAAM,EACzB,UAAU,SAAS,SAAS,EAC5B,QAAQ,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG,EACtF,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE,EAAE,QAAQ,sCAmBxC,EAAE;;;IAoCvB;;;;;;;;;;;;OAYG;IACI,aAAa,CAAC,aAAa,SAAS,iBAAiB,EACxD,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,CAAC,gBAAgB,EAAE,YAAY,CAAC,aAAa,CAAC,KAAK,cAAc;IAuChF;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG;IAKxE,KAAK,IAAI,SAAS,CAAC,YAAY,CAAC;CA8B1C;AAED,eAAO,MAAM,0BAA0B,GACnC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,EAE1D,GAAG,YAAY,CAAC,kBAGX,CAAC,6DAA6D,IAAI,mFAET,GAAG,oBAgBpE,CAAC"}

package/dist/registrarBuilder.js

@@ -1,4 +1,4 @@
-export { RegistrarBuilder } from './6D5TVHOU.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './4DUQS2FO.js';
 import './VUOMXK5T.js';
 //# sourceMappingURL=registrarBuilder.js.map
 //# sourceMappingURL=registrarBuilder.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/base-definitions",
-  "version": "0.0.66",
+  "version": "0.0.73",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -15,16 +15,16 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "zod": "3.25.56",
-    "@layerzerolabs/common-utils": "0.0.66",
-    "@layerzerolabs/dependency-graph": "0.0.66",
-    "@layerzerolabs/dfs": "0.0.66",
-    "@layerzerolabs/typescript-utils": "0.0.66"
+    "@layerzerolabs/common-utils": "0.0.73",
+    "@layerzerolabs/dependency-graph": "0.0.73",
+    "@layerzerolabs/dfs": "0.0.73",
+    "@layerzerolabs/typescript-utils": "0.0.73"
   },
   "devDependencies": {
     "tsup": "^8.4.0",
     "vitest": "^3.2.3",
-    "@layerzerolabs/tsup-configuration": "0.0.66",
-    "@layerzerolabs/typescript-configuration": "0.0.66"
+    "@layerzerolabs/typescript-configuration": "0.0.73",
+    "@layerzerolabs/tsup-configuration": "0.0.73"
   },
   "publishConfig": {
     "access": "restricted",

package/src/registrarBuilder.ts

@@ -200,3 +200,29 @@ export class RegistrarBuilder<_ReturnTypes> {
         };
     }
 }
+
+export const multiplexOrderedRegistrars = <
+    const T extends [name: string, registrar: Registrar<{}>][],
+>(
+    ...registrars: T
+) => {
+    const multiplexRegistrar: Registrar<{
+        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]
+            ? Name
+            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;
+    }> = {
+        traverseDependencies: async (
+            ...params: Parameters<Registrar<any>['traverseDependencies']>
+        ) => {
+            const acc: Record<string, any> = {};
+            for (const [name, registrar] of registrars) {
+                const result = await registrar.traverseDependencies(...params);
+                acc[name] = result;
+            }
+
+            return acc;
+        },
+    } as any;
+
+    return multiplexRegistrar;
+};

package/dist/6D5TVHOU.js.map

@@ -1 +0,0 @@
-{"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","ancestry","key","value","traverseDependencies","dfs"],"mappings":"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","file":"6D5TVHOU.js","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\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, ancestry: DependencyNode[]) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\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>, ancestry: DependencyNode[]) => 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) => 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) => 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) => 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,\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 (from: DependencyNode) => DependencyNode,\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 (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\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, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) =>\n                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n"]}

package/dist/EVDGRGJ5.cjs.map

@@ -1 +0,0 @@
-{"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","__name","ancestry","key","value","traverseDependencies","dfs"],"mappings":"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","file":"EVDGRGJ5.cjs","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\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, ancestry: DependencyNode[]) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\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>, ancestry: DependencyNode[]) => 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) => 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) => 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) => 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,\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 (from: DependencyNode) => DependencyNode,\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 (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\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, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\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, ancestry: DependencyNode[]) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) =>\n                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n"]}