@layerzerolabs/base-definitions 0.2.59 → 0.2.61

package/.turbo/turbo-build.log

@@ -11,45 +11,45 @@
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
-ESM dist/definitions.js          216.00 B
-ESM dist/registrarBuilder.js     191.00 B
-ESM dist/lzyringe.js             146.00 B
-ESM dist/JJBD65HU.js             1.65 KB
-ESM dist/utils.js                173.00 B
-ESM dist/I3HCQWKQ.js             6.70 KB
-ESM dist/PG5UTJ4W.js             733.00 B
-ESM dist/G6XKLFF4.js             1.47 KB
-ESM dist/index.js                389.00 B
-ESM dist/VUOMXK5T.js             222.00 B
-ESM dist/definitions.js.map      75.00 B
-ESM dist/registrarBuilder.js.map 80.00 B
-ESM dist/JJBD65HU.js.map         3.78 KB
-ESM dist/lzyringe.js.map         72.00 B
-ESM dist/utils.js.map            69.00 B
-ESM dist/I3HCQWKQ.js.map         18.42 KB
-ESM dist/PG5UTJ4W.js.map         1.81 KB
-ESM dist/G6XKLFF4.js.map         14.09 KB
-ESM dist/index.js.map            69.00 B
-ESM dist/VUOMXK5T.js.map         72.00 B
-ESM ⚡️ Build success in 317ms
-CJS dist/index.cjs                1.43 KB
 CJS dist/definitions.cjs          747.00 B
 CJS dist/lzyringe.cjs             302.00 B
-CJS dist/JKTGUQY4.cjs             1.70 KB
 CJS dist/registrarBuilder.cjs     478.00 B
-CJS dist/2YGTKLAP.cjs             1.68 KB
-CJS dist/GJR4AWAW.cjs             6.90 KB
-CJS dist/YJF4D23A.cjs             245.00 B
-CJS dist/2IH6HX7W.cjs             815.00 B
+CJS dist/JKTGUQY4.cjs             1.70 KB
 CJS dist/utils.cjs                343.00 B
-CJS dist/index.cjs.map            70.00 B
+CJS dist/Y4WRKZUM.cjs             7.31 KB
+CJS dist/2IH6HX7W.cjs             815.00 B
+CJS dist/YJF4D23A.cjs             245.00 B
+CJS dist/2YGTKLAP.cjs             1.68 KB
+CJS dist/index.cjs                1.43 KB
 CJS dist/definitions.cjs.map      76.00 B
+CJS dist/registrarBuilder.cjs.map 81.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/2YGTKLAP.cjs.map         14.10 KB
-CJS dist/GJR4AWAW.cjs.map         18.43 KB
-CJS dist/YJF4D23A.cjs.map         73.00 B
-CJS dist/2IH6HX7W.cjs.map         1.83 KB
 CJS dist/utils.cjs.map            70.00 B
-CJS ⚡️ Build success in 318ms
+CJS dist/2IH6HX7W.cjs.map         1.83 KB
+CJS dist/index.cjs.map            70.00 B
+CJS dist/YJF4D23A.cjs.map         73.00 B
+CJS dist/2YGTKLAP.cjs.map         14.10 KB
+CJS dist/Y4WRKZUM.cjs.map         19.32 KB
+CJS ⚡️ Build success in 186ms
+ESM dist/definitions.js          216.00 B
+ESM dist/lzyringe.js             146.00 B
+ESM dist/index.js                389.00 B
+ESM dist/JJBD65HU.js             1.65 KB
+ESM dist/registrarBuilder.js     191.00 B
+ESM dist/PG5UTJ4W.js             733.00 B
+ESM dist/utils.js                173.00 B
+ESM dist/5V2VE36W.js             7.11 KB
+ESM dist/VUOMXK5T.js             222.00 B
+ESM dist/G6XKLFF4.js             1.47 KB
+ESM dist/lzyringe.js.map         72.00 B
+ESM dist/index.js.map            69.00 B
+ESM dist/JJBD65HU.js.map         3.78 KB
+ESM dist/registrarBuilder.js.map 80.00 B
+ESM dist/PG5UTJ4W.js.map         1.81 KB
+ESM dist/utils.js.map            69.00 B
+ESM dist/5V2VE36W.js.map         19.30 KB
+ESM dist/definitions.js.map      75.00 B
+ESM dist/VUOMXK5T.js.map         72.00 B
+ESM dist/G6XKLFF4.js.map         14.09 KB
+ESM ⚡️ Build success in 187ms

package/.turbo/turbo-lint.log

@@ -2,7 +2,7 @@
 > @layerzerolabs/base-definitions@0.0.2 lint /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
 > eslint . --max-warnings 0 || (eslint . --fix --max-warnings 0 && false)
 
-(node:57197) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1774308661363 is not specified and it doesn't parse as CommonJS.
+(node:55587) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1774486407645 is not specified and it doesn't parse as CommonJS.
 Reparsing as ES module because module syntax was detected. This incurs a performance overhead.
 To eliminate this warning, add "type": "module" to /home/runner/work/monorepo-internal/monorepo-internal/package.json.
 (Use `node --trace-warnings ...` to show where the warning was created)

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.4 /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
 
- ✓ test/registrarBuilder.test.ts (7 tests) 13ms
+ ✓ test/registrarBuilder.test.ts (7 tests) 12ms
 
  Test Files  1 passed (1)
       Tests  7 passed (7)
 Type Errors  no errors
-   Start at  23:33:23
-   Duration  713ms (transform 148ms, setup 0ms, collect 149ms, tests 13ms, environment 0ms, prepare 222ms)
+   Start at  00:55:54
+   Duration  539ms (transform 111ms, setup 0ms, collect 118ms, tests 12ms, environment 0ms, prepare 115ms)
 

package/dist/{I3HCQWKQ.js → 5V2VE36W.js}

@@ -19,13 +19,28 @@ var RegistrarBuilder = class {
       throw new Error(`This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`);
     };
   }
-  addNodeHandler(node, fn) {
+  addNodeHandler(node, identifier, fn) {
     if (this.nodeHandlers[node.name]) {
       throw new Error(`Cannot define a node handler for an identifier that already has a handler: ${node.name}`);
     }
-    this.nodeHandlers[node.name] = fn;
+    this.nodeHandlers[node.name] = {
+      fn,
+      identifier
+    };
     return this;
   }
+  /**
+   * Returns the class handler identifier that would be used for a given node,
+   * or undefined if no class handler matches.
+   */
+  getClassIdentifierForNode(node) {
+    for (const { nodeClass, identifier } of this.classHandlers) {
+      if (node instanceof nodeClass) {
+        return identifier;
+      }
+    }
+    return void 0;
+  }
   /**
    * Add a function fn to be called on all nodes of class
    * @param nodeClass
@@ -157,8 +172,8 @@ var RegistrarBuilder = class {
       const nodeHandler = this.nodeHandlers[node.name];
       if (nodeHandler) {
         return {
-          key: node.name,
-          value: await nodeHandler(node, ancestry)
+          key: nodeHandler.identifier ?? node.name,
+          value: await nodeHandler.fn(node, ancestry)
         };
       }
       for (const { nodeClass, identifier, fn } of this.classHandlers) {
@@ -211,5 +226,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ __name((...registrars) => {
 }, "multiplexOrderedRegistrars");
 
 export { RegistrarBuilder, multiplexOrderedRegistrars };
-//# sourceMappingURL=I3HCQWKQ.js.map
-//# sourceMappingURL=I3HCQWKQ.js.map
+//# sourceMappingURL=5V2VE36W.js.map
+//# sourceMappingURL=5V2VE36W.js.map

package/dist/5V2VE36W.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","nodeHandlers","classHandlers","classAliases","nodeAliases","getEntrypoints","node","Error","JSON","stringify","addNodeHandler","identifier","fn","name","getClassIdentifierForNode","nodeClass","undefined","addClassHandler","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addNodeAlias","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","nodeAlias","toNode","mergedNodeHandler","ancestry","key","value","nodeHandler","traverseDependencies","entrypoints","length","dfs","dependencies","reduce","acc","cur","VirtualNode","DependencyNode","virtualEntrypoint","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","registrar","result"],"mappings":"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","file":"5V2VE36W.js","sourcesContent":["import type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { 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\n    protected nodeHandlers: Record<\n        string,\n        {\n            fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n            identifier: string;\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    protected nodeAliases: Record<string, (node: DependencyNode) => DependencyNode> = {};\n\n    protected getEntrypoints: (\n        node: DependencyNode,\n    ) => DependencyNode[] | Promise<DependencyNode[]> = (node) => [node];\n\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    public addNodeHandler<\n        Node extends DependencyNode,\n        Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,\n    >(node: DependencyNode, identifier: string, fn: Function) {\n        if (this.nodeHandlers[node.name]) {\n            throw new Error(\n                `Cannot define a node handler for an identifier that already has a handler: ${node.name}`,\n            );\n        }\n        this.nodeHandlers[node.name] = {\n            fn: fn as unknown as (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>,\n            identifier,\n        };\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                ['nodeHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Returns the class handler identifier that would be used for a given node,\n     * or undefined if no class handler matches.\n     */\n    public getClassIdentifierForNode(node: DependencyNode): string | undefined {\n        for (const { nodeClass, identifier } of this.classHandlers) {\n            if (node instanceof nodeClass) {\n                return identifier;\n            }\n        }\n        return undefined;\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     * Alias a specific named node, such that when encountered in the tree,\n     * it will be transformed to a different node before processing.\n     * The transformed node's dependencies will be traversed instead.\n     * This is useful for short-circuiting dependency traversal for specific nodes.\n     *\n     * @param nodeName name of the node to alias\n     * @param getToNode method that returns the transformed node\n     */\n    public addNodeAlias(\n        node: DependencyNode,\n        getToNode: (fromNodeInstance: DependencyNode) => DependencyNode,\n    ) {\n        this.nodeAliases[node.name] = getToNode;\n        return this;\n    }\n\n    /**\n     * Set a custom entrypoint getter function. By default, the entrypoint getter\n     * returns the node passed in as the sole entrypoint.\n     */\n    public setEntrypointsGetter(\n        fn: (node: DependencyNode) => DependencyNode[] | Promise<DependencyNode[]>,\n    ) {\n        this.getEntrypoints = fn;\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            // Check node aliases first (more specific)\n            const nodeAlias = this.nodeAliases[node.name];\n            if (nodeAlias) {\n                return nodeAlias(node);\n            }\n\n            // Then check class aliases\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            if (node.name === '_virtualEntrypoint') {\n                return {\n                    key: node.name,\n                    value: undefined,\n                };\n            }\n\n            const nodeHandler = this.nodeHandlers[node.name];\n            if (nodeHandler) {\n                return {\n                    key: nodeHandler.identifier ?? node.name,\n                    value: await nodeHandler.fn(node, ancestry),\n                };\n            }\n\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                const entrypoints = await this.getEntrypoints(node);\n                if (entrypoints.length === 1)\n                    return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();\n\n                const dependencies = entrypoints.reduce((acc, cur) => {\n                    acc[cur.name] = cur;\n                    return acc;\n                }, {} as Dependencies);\n\n                class VirtualNode extends DependencyNode {}\n\n                const virtualEntrypoint = new VirtualNode({\n                    name: '_virtualEntrypoint',\n                    dependencies,\n                });\n\n                return await dfs<_ReturnTypes>(\n                    virtualEntrypoint,\n                    mergedNodeHandler,\n                    mergedNodePrehandler,\n                )();\n            },\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/{GJR4AWAW.cjs → Y4WRKZUM.cjs}

@@ -21,13 +21,28 @@ var RegistrarBuilder = class {
       throw new Error(`This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`);
     };
   }
-  addNodeHandler(node, fn) {
+  addNodeHandler(node, identifier, fn) {
     if (this.nodeHandlers[node.name]) {
       throw new Error(`Cannot define a node handler for an identifier that already has a handler: ${node.name}`);
     }
-    this.nodeHandlers[node.name] = fn;
+    this.nodeHandlers[node.name] = {
+      fn,
+      identifier
+    };
     return this;
   }
+  /**
+   * Returns the class handler identifier that would be used for a given node,
+   * or undefined if no class handler matches.
+   */
+  getClassIdentifierForNode(node) {
+    for (const { nodeClass, identifier } of this.classHandlers) {
+      if (node instanceof nodeClass) {
+        return identifier;
+      }
+    }
+    return void 0;
+  }
   /**
    * Add a function fn to be called on all nodes of class
    * @param nodeClass
@@ -159,8 +174,8 @@ var RegistrarBuilder = class {
       const nodeHandler = this.nodeHandlers[node.name];
       if (nodeHandler) {
         return {
-          key: node.name,
-          value: await nodeHandler(node, ancestry)
+          key: nodeHandler.identifier ?? node.name,
+          value: await nodeHandler.fn(node, ancestry)
         };
       }
       for (const { nodeClass, identifier, fn } of this.classHandlers) {
@@ -214,5 +229,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ YJF4D23A_cjs.__name((...registr
 
 exports.RegistrarBuilder = RegistrarBuilder;
 exports.multiplexOrderedRegistrars = multiplexOrderedRegistrars;
-//# sourceMappingURL=GJR4AWAW.cjs.map
-//# sourceMappingURL=GJR4AWAW.cjs.map
+//# sourceMappingURL=Y4WRKZUM.cjs.map
+//# sourceMappingURL=Y4WRKZUM.cjs.map

package/dist/Y4WRKZUM.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","nodeHandlers","classHandlers","classAliases","nodeAliases","getEntrypoints","node","Error","JSON","stringify","addNodeHandler","identifier","fn","name","getClassIdentifierForNode","nodeClass","undefined","addClassHandler","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addNodeAlias","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","nodeAlias","toNode","mergedNodeHandler","__name","ancestry","key","value","nodeHandler","traverseDependencies","entrypoints","length","dfs","dependencies","reduce","acc","cur","VirtualNode","DependencyNode","virtualEntrypoint","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","registrar","result"],"mappings":"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","file":"Y4WRKZUM.cjs","sourcesContent":["import type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { 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\n    protected nodeHandlers: Record<\n        string,\n        {\n            fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n            identifier: string;\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    protected nodeAliases: Record<string, (node: DependencyNode) => DependencyNode> = {};\n\n    protected getEntrypoints: (\n        node: DependencyNode,\n    ) => DependencyNode[] | Promise<DependencyNode[]> = (node) => [node];\n\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    public addNodeHandler<\n        Node extends DependencyNode,\n        Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,\n    >(node: DependencyNode, identifier: string, fn: Function) {\n        if (this.nodeHandlers[node.name]) {\n            throw new Error(\n                `Cannot define a node handler for an identifier that already has a handler: ${node.name}`,\n            );\n        }\n        this.nodeHandlers[node.name] = {\n            fn: fn as unknown as (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>,\n            identifier,\n        };\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                ['nodeHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Returns the class handler identifier that would be used for a given node,\n     * or undefined if no class handler matches.\n     */\n    public getClassIdentifierForNode(node: DependencyNode): string | undefined {\n        for (const { nodeClass, identifier } of this.classHandlers) {\n            if (node instanceof nodeClass) {\n                return identifier;\n            }\n        }\n        return undefined;\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     * Alias a specific named node, such that when encountered in the tree,\n     * it will be transformed to a different node before processing.\n     * The transformed node's dependencies will be traversed instead.\n     * This is useful for short-circuiting dependency traversal for specific nodes.\n     *\n     * @param nodeName name of the node to alias\n     * @param getToNode method that returns the transformed node\n     */\n    public addNodeAlias(\n        node: DependencyNode,\n        getToNode: (fromNodeInstance: DependencyNode) => DependencyNode,\n    ) {\n        this.nodeAliases[node.name] = getToNode;\n        return this;\n    }\n\n    /**\n     * Set a custom entrypoint getter function. By default, the entrypoint getter\n     * returns the node passed in as the sole entrypoint.\n     */\n    public setEntrypointsGetter(\n        fn: (node: DependencyNode) => DependencyNode[] | Promise<DependencyNode[]>,\n    ) {\n        this.getEntrypoints = fn;\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            // Check node aliases first (more specific)\n            const nodeAlias = this.nodeAliases[node.name];\n            if (nodeAlias) {\n                return nodeAlias(node);\n            }\n\n            // Then check class aliases\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            if (node.name === '_virtualEntrypoint') {\n                return {\n                    key: node.name,\n                    value: undefined,\n                };\n            }\n\n            const nodeHandler = this.nodeHandlers[node.name];\n            if (nodeHandler) {\n                return {\n                    key: nodeHandler.identifier ?? node.name,\n                    value: await nodeHandler.fn(node, ancestry),\n                };\n            }\n\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                const entrypoints = await this.getEntrypoints(node);\n                if (entrypoints.length === 1)\n                    return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();\n\n                const dependencies = entrypoints.reduce((acc, cur) => {\n                    acc[cur.name] = cur;\n                    return acc;\n                }, {} as Dependencies);\n\n                class VirtualNode extends DependencyNode {}\n\n                const virtualEntrypoint = new VirtualNode({\n                    name: '_virtualEntrypoint',\n                    dependencies,\n                });\n\n                return await dfs<_ReturnTypes>(\n                    virtualEntrypoint,\n                    mergedNodeHandler,\n                    mergedNodePrehandler,\n                )();\n            },\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 GJR4AWAW_cjs = require('./GJR4AWAW.cjs');
+var Y4WRKZUM_cjs = require('./Y4WRKZUM.cjs');
 var _2IH6HX7W_cjs = require('./2IH6HX7W.cjs');
 var _2YGTKLAP_cjs = require('./2YGTKLAP.cjs');
 require('./YJF4D23A.cjs');
@@ -14,11 +14,11 @@ Object.defineProperty(exports, "DependencyStore", {
 });
 Object.defineProperty(exports, "RegistrarBuilder", {
   enumerable: true,
-  get: function () { return GJR4AWAW_cjs.RegistrarBuilder; }
+  get: function () { return Y4WRKZUM_cjs.RegistrarBuilder; }
 });
 Object.defineProperty(exports, "multiplexOrderedRegistrars", {
   enumerable: true,
-  get: function () { return GJR4AWAW_cjs.multiplexOrderedRegistrars; }
+  get: function () { return Y4WRKZUM_cjs.multiplexOrderedRegistrars; }
 });
 Object.defineProperty(exports, "extractSchemaFromFactory", {
   enumerable: true,

package/dist/index.js

@@ -1,5 +1,5 @@
 export { DependencyStore } from './JJBD65HU.js';
-export { RegistrarBuilder, multiplexOrderedRegistrars } from './I3HCQWKQ.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './5V2VE36W.js';
 export { extractSchemaFromFactory } from './PG5UTJ4W.js';
 export { FactoryDefinition, ObjectDefinition, deserializeDimensions, serializeDimensions } from './G6XKLFF4.js';
 import './VUOMXK5T.js';

package/dist/registrarBuilder.cjs

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

package/dist/registrarBuilder.d.ts

@@ -18,7 +18,10 @@ type AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;
  */
 export declare class RegistrarBuilder<_ReturnTypes> {
     protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;
-    protected nodeHandlers: Record<string, (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>>;
+    protected nodeHandlers: Record<string, {
+        fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;
+        identifier: string;
+    }>;
     protected classHandlers: {
         nodeClass: AbstractNodeClass;
         identifier: string;
@@ -31,11 +34,16 @@ export declare class RegistrarBuilder<_ReturnTypes> {
     protected nodeAliases: Record<string, (node: DependencyNode) => DependencyNode>;
     protected getEntrypoints: (node: DependencyNode) => DependencyNode[] | Promise<DependencyNode[]>;
     constructor();
-    addNodeHandler<Node extends DependencyNode, Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>>(node: DependencyNode, fn: Function): RegistrarBuilder<_ReturnTypes & {
+    addNodeHandler<Node extends DependencyNode, Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>>(node: DependencyNode, identifier: string, fn: Function): RegistrarBuilder<_ReturnTypes & {
         ["nodeHandlers"]: {
             [nodeName: string]: Awaited<ReturnType<Function>>;
         };
     }>;
+    /**
+     * Returns the class handler identifier that would be used for a given node,
+     * or undefined if no class handler matches.
+     */
+    getClassIdentifierForNode(node: DependencyNode): string | undefined;
     /**
      * Add a function fn to be called on all nodes of class
      * @param nodeClass

package/dist/registrarBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registrarBuilder.d.ts","sourceRoot":"","sources":["../src/registrarBuilder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,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;IAE7F,SAAS,CAAC,YAAY,EAAE,MAAM,CAC1B,MAAM,EACN,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CACrE,CAAM;IAEP,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,SAAS,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,CAAC,CAAM;IAErF,SAAS,CAAC,cAAc,EAAE,CACtB,IAAI,EAAE,cAAc,KACnB,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAoB;;IAU9D,cAAc,CACjB,IAAI,SAAS,cAAc,EAC3B,QAAQ,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,EAC3E,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,QAAQ,GAUjB,gBAAgB,CAC3B,YAAY,GAAG;QACX,CAAC,cAAc,CAAC,EAAE;YAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAA;SAAE,CAAC;KAC3E,CACJ;IAGL;;;;;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;;;;;;;;OAQG;IACI,YAAY,CACf,IAAI,EAAE,cAAc,EACpB,SAAS,EAAE,CAAC,gBAAgB,EAAE,cAAc,KAAK,cAAc;IAMnE;;;OAGG;IACI,oBAAoB,CACvB,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,cAAc,EAAE,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAM9E;;;;OAIG;IACI,UAAU,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,KAAK,GAAG;IAKxE,KAAK,IAAI,SAAS,CAAC,YAAY,CAAC;CAyE1C;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"}
+{"version":3,"file":"registrarBuilder.d.ts","sourceRoot":"","sources":["../src/registrarBuilder.ts"],"names":[],"mappings":"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"}

package/dist/registrarBuilder.js

@@ -1,4 +1,4 @@
-export { RegistrarBuilder, multiplexOrderedRegistrars } from './I3HCQWKQ.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './5V2VE36W.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.2.59",
+  "version": "0.2.61",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -15,16 +15,16 @@
   "types": "./dist/index.d.ts",
   "dependencies": {
     "zod": "4.3.5",
-    "@layerzerolabs/dependency-graph": "0.2.59",
-    "@layerzerolabs/function-pointer": "0.2.59",
-    "@layerzerolabs/typescript-utils": "0.2.59",
-    "@layerzerolabs/dfs": "0.2.59"
+    "@layerzerolabs/typescript-utils": "0.2.61",
+    "@layerzerolabs/dependency-graph": "0.2.61",
+    "@layerzerolabs/dfs": "0.2.61",
+    "@layerzerolabs/function-pointer": "0.2.61"
   },
   "devDependencies": {
     "tsup": "^8.4.0",
     "vitest": "^3.2.3",
-    "@layerzerolabs/tsup-configuration": "0.2.59",
-    "@layerzerolabs/typescript-configuration": "0.2.59"
+    "@layerzerolabs/tsup-configuration": "0.2.61",
+    "@layerzerolabs/typescript-configuration": "0.2.61"
   },
   "publishConfig": {
     "access": "restricted",

package/src/registrarBuilder.ts

@@ -25,7 +25,10 @@ export class RegistrarBuilder<_ReturnTypes> {
 
     protected nodeHandlers: Record<
         string,
-        (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>
+        {
+            fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;
+            identifier: string;
+        }
     > = {};
 
     protected classHandlers: {
@@ -56,16 +59,16 @@ export class RegistrarBuilder<_ReturnTypes> {
     public addNodeHandler<
         Node extends DependencyNode,
         Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,
-    >(node: DependencyNode, fn: Function) {
+    >(node: DependencyNode, identifier: string, fn: Function) {
         if (this.nodeHandlers[node.name]) {
             throw new Error(
                 `Cannot define a node handler for an identifier that already has a handler: ${node.name}`,
             );
         }
-        this.nodeHandlers[node.name] = fn as unknown as (
-            node: DependencyNode,
-            ancestry: DependencyNode[],
-        ) => Promise<any>;
+        this.nodeHandlers[node.name] = {
+            fn: fn as unknown as (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>,
+            identifier,
+        };
         return this as RegistrarBuilder<
             _ReturnTypes & {
                 ['nodeHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };
@@ -73,6 +76,19 @@ export class RegistrarBuilder<_ReturnTypes> {
         >;
     }
 
+    /**
+     * Returns the class handler identifier that would be used for a given node,
+     * or undefined if no class handler matches.
+     */
+    public getClassIdentifierForNode(node: DependencyNode): string | undefined {
+        for (const { nodeClass, identifier } of this.classHandlers) {
+            if (node instanceof nodeClass) {
+                return identifier;
+            }
+        }
+        return undefined;
+    }
+
     /**
      * Add a function fn to be called on all nodes of class
      * @param nodeClass
@@ -258,8 +274,8 @@ export class RegistrarBuilder<_ReturnTypes> {
             const nodeHandler = this.nodeHandlers[node.name];
             if (nodeHandler) {
                 return {
-                    key: node.name,
-                    value: await nodeHandler(node, ancestry),
+                    key: nodeHandler.identifier ?? node.name,
+                    value: await nodeHandler.fn(node, ancestry),
                 };
             }
 

package/test/registrarBuilder.test.ts

@@ -131,7 +131,7 @@ describe('Node handlers', () => {
                 classHandlerCalled = true;
                 return 'from-class';
             })
-            .addNodeHandler(mySimpleClassA1, async () => {
+            .addNodeHandler(mySimpleClassA1, 'MySimpleClassA', async () => {
                 namedHandlerCalled = true;
                 return 'from-named';
             })
@@ -148,7 +148,7 @@ describe('Node handlers', () => {
         let receivedAncestry: DependencyNode[] | undefined;
 
         const builder = new RegistrarBuilder()
-            .addNodeHandler(mySimpleClassA1, async (node, ancestry) => {
+            .addNodeHandler(mySimpleClassA1, 'MySimpleClassA', async (node, ancestry) => {
                 receivedNode = node;
                 receivedAncestry = ancestry;
                 return 'named-result';
@@ -166,8 +166,8 @@ describe('Node handlers', () => {
     test('Registering duplicate node handlers should throw', () => {
         expect(() => {
             new RegistrarBuilder()
-                .addNodeHandler(mySimpleClassA1, async () => 'first')
-                .addNodeHandler(mySimpleClassA1, async () => 'second');
+                .addNodeHandler(mySimpleClassA1, 'MySimpleClassA', async () => 'first')
+                .addNodeHandler(mySimpleClassA1, 'MySimpleClassA', async () => 'second');
         }).toThrow(
             'Cannot define a node handler for an identifier that already has a handler: MySimpleClassA',
         );

package/dist/GJR4AWAW.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","nodeHandlers","classHandlers","classAliases","nodeAliases","getEntrypoints","node","Error","JSON","stringify","addNodeHandler","fn","name","addClassHandler","nodeClass","identifier","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addNodeAlias","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","nodeAlias","toNode","mergedNodeHandler","__name","ancestry","key","value","undefined","nodeHandler","traverseDependencies","entrypoints","length","dfs","dependencies","reduce","acc","cur","VirtualNode","DependencyNode","virtualEntrypoint","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","registrar","result"],"mappings":"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","file":"GJR4AWAW.cjs","sourcesContent":["import type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { 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\n    protected nodeHandlers: Record<\n        string,\n        (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>\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    protected nodeAliases: Record<string, (node: DependencyNode) => DependencyNode> = {};\n\n    protected getEntrypoints: (\n        node: DependencyNode,\n    ) => DependencyNode[] | Promise<DependencyNode[]> = (node) => [node];\n\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    public addNodeHandler<\n        Node extends DependencyNode,\n        Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,\n    >(node: DependencyNode, fn: Function) {\n        if (this.nodeHandlers[node.name]) {\n            throw new Error(\n                `Cannot define a node handler for an identifier that already has a handler: ${node.name}`,\n            );\n        }\n        this.nodeHandlers[node.name] = fn as unknown as (\n            node: DependencyNode,\n            ancestry: DependencyNode[],\n        ) => Promise<any>;\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                ['nodeHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\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     * Alias a specific named node, such that when encountered in the tree,\n     * it will be transformed to a different node before processing.\n     * The transformed node's dependencies will be traversed instead.\n     * This is useful for short-circuiting dependency traversal for specific nodes.\n     *\n     * @param nodeName name of the node to alias\n     * @param getToNode method that returns the transformed node\n     */\n    public addNodeAlias(\n        node: DependencyNode,\n        getToNode: (fromNodeInstance: DependencyNode) => DependencyNode,\n    ) {\n        this.nodeAliases[node.name] = getToNode;\n        return this;\n    }\n\n    /**\n     * Set a custom entrypoint getter function. By default, the entrypoint getter\n     * returns the node passed in as the sole entrypoint.\n     */\n    public setEntrypointsGetter(\n        fn: (node: DependencyNode) => DependencyNode[] | Promise<DependencyNode[]>,\n    ) {\n        this.getEntrypoints = fn;\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            // Check node aliases first (more specific)\n            const nodeAlias = this.nodeAliases[node.name];\n            if (nodeAlias) {\n                return nodeAlias(node);\n            }\n\n            // Then check class aliases\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            if (node.name === '_virtualEntrypoint') {\n                return {\n                    key: node.name,\n                    value: undefined,\n                };\n            }\n\n            const nodeHandler = this.nodeHandlers[node.name];\n            if (nodeHandler) {\n                return {\n                    key: node.name,\n                    value: await nodeHandler(node, ancestry),\n                };\n            }\n\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                const entrypoints = await this.getEntrypoints(node);\n                if (entrypoints.length === 1)\n                    return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();\n\n                const dependencies = entrypoints.reduce((acc, cur) => {\n                    acc[cur.name] = cur;\n                    return acc;\n                }, {} as Dependencies);\n\n                class VirtualNode extends DependencyNode {}\n\n                const virtualEntrypoint = new VirtualNode({\n                    name: '_virtualEntrypoint',\n                    dependencies,\n                });\n\n                return await dfs<_ReturnTypes>(\n                    virtualEntrypoint,\n                    mergedNodeHandler,\n                    mergedNodePrehandler,\n                )();\n            },\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/I3HCQWKQ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","nodeHandlers","classHandlers","classAliases","nodeAliases","getEntrypoints","node","Error","JSON","stringify","addNodeHandler","fn","name","addClassHandler","nodeClass","identifier","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addNodeAlias","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","nodeAlias","toNode","mergedNodeHandler","ancestry","key","value","undefined","nodeHandler","traverseDependencies","entrypoints","length","dfs","dependencies","reduce","acc","cur","VirtualNode","DependencyNode","virtualEntrypoint","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","registrar","result"],"mappings":"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","file":"I3HCQWKQ.js","sourcesContent":["import type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { 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\n    protected nodeHandlers: Record<\n        string,\n        (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>\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    protected nodeAliases: Record<string, (node: DependencyNode) => DependencyNode> = {};\n\n    protected getEntrypoints: (\n        node: DependencyNode,\n    ) => DependencyNode[] | Promise<DependencyNode[]> = (node) => [node];\n\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    public addNodeHandler<\n        Node extends DependencyNode,\n        Function extends (node: Node, ancestry: DependencyNode[]) => Promise<any>,\n    >(node: DependencyNode, fn: Function) {\n        if (this.nodeHandlers[node.name]) {\n            throw new Error(\n                `Cannot define a node handler for an identifier that already has a handler: ${node.name}`,\n            );\n        }\n        this.nodeHandlers[node.name] = fn as unknown as (\n            node: DependencyNode,\n            ancestry: DependencyNode[],\n        ) => Promise<any>;\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                ['nodeHandlers']: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\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     * Alias a specific named node, such that when encountered in the tree,\n     * it will be transformed to a different node before processing.\n     * The transformed node's dependencies will be traversed instead.\n     * This is useful for short-circuiting dependency traversal for specific nodes.\n     *\n     * @param nodeName name of the node to alias\n     * @param getToNode method that returns the transformed node\n     */\n    public addNodeAlias(\n        node: DependencyNode,\n        getToNode: (fromNodeInstance: DependencyNode) => DependencyNode,\n    ) {\n        this.nodeAliases[node.name] = getToNode;\n        return this;\n    }\n\n    /**\n     * Set a custom entrypoint getter function. By default, the entrypoint getter\n     * returns the node passed in as the sole entrypoint.\n     */\n    public setEntrypointsGetter(\n        fn: (node: DependencyNode) => DependencyNode[] | Promise<DependencyNode[]>,\n    ) {\n        this.getEntrypoints = fn;\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            // Check node aliases first (more specific)\n            const nodeAlias = this.nodeAliases[node.name];\n            if (nodeAlias) {\n                return nodeAlias(node);\n            }\n\n            // Then check class aliases\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            if (node.name === '_virtualEntrypoint') {\n                return {\n                    key: node.name,\n                    value: undefined,\n                };\n            }\n\n            const nodeHandler = this.nodeHandlers[node.name];\n            if (nodeHandler) {\n                return {\n                    key: node.name,\n                    value: await nodeHandler(node, ancestry),\n                };\n            }\n\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                const entrypoints = await this.getEntrypoints(node);\n                if (entrypoints.length === 1)\n                    return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();\n\n                const dependencies = entrypoints.reduce((acc, cur) => {\n                    acc[cur.name] = cur;\n                    return acc;\n                }, {} as Dependencies);\n\n                class VirtualNode extends DependencyNode {}\n\n                const virtualEntrypoint = new VirtualNode({\n                    name: '_virtualEntrypoint',\n                    dependencies,\n                });\n\n                return await dfs<_ReturnTypes>(\n                    virtualEntrypoint,\n                    mergedNodeHandler,\n                    mergedNodePrehandler,\n                )();\n            },\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"]}