@layerzerolabs/base-definitions 1.2.89 → 1.2.90

package/dist/{LFPTWOQW.js → GH7CHOFB.js}

@@ -123,6 +123,8 @@ var RegistrarBuilder = class {
    * Alias a specific named node, such that when encountered in the tree,
    * it will be transformed to a different node before processing.
    * The transformed node's dependencies will be traversed instead.
+   * The transformed node is then passed through the class aliases, so e.g. a replacement
+   * ActivityFactoryDefinition is still wrapped by registrar-specific class aliases.
    * This is useful for short-circuiting dependency traversal for specific nodes.
    *
    * @param nodeName name of the node to alias
@@ -134,6 +136,7 @@ var RegistrarBuilder = class {
   }
   /**
    * Returns a function that resolves node/class aliases registered on this builder.
+   * A node alias's result is passed through the class aliases too.
    * Useful for external traversals (e.g. CDK nodeExplorer) that need to follow
    * the same alias rules as the DFS built by {@link build}.
    */
@@ -230,5 +233,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ __name((...registrars) => {
 }, "multiplexOrderedRegistrars");
 
 export { RegistrarBuilder, multiplexOrderedRegistrars };
-//# sourceMappingURL=LFPTWOQW.js.map
-//# sourceMappingURL=LFPTWOQW.js.map
+//# sourceMappingURL=GH7CHOFB.js.map
+//# sourceMappingURL=GH7CHOFB.js.map

package/dist/GH7CHOFB.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","getPrehandler","nodeAlias","aliased","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","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":"GH7CHOFB.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     * The transformed node is then passed through the class aliases, so e.g. a replacement\n     * ActivityFactoryDefinition is still wrapped by registrar-specific class aliases.\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     * Returns a function that resolves node/class aliases registered on this builder.\n     * A node alias's result is passed through the class aliases too.\n     * Useful for external traversals (e.g. CDK nodeExplorer) that need to follow\n     * the same alias rules as the DFS built by {@link build}.\n     */\n    public getPrehandler(): (node: DependencyNode) => DependencyNode {\n        return (node) => {\n            const nodeAlias = this.nodeAliases[node.name];\n            const aliased = nodeAlias ? nodeAlias(node) : node;\n            for (const { fromNodeClass, getToNode } of this.classAliases) {\n                if (aliased instanceof fromNodeClass) return getToNode(aliased);\n            }\n            return aliased;\n        };\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 = this.getPrehandler();\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.js

@@ -1,5 +1,5 @@
 export { DependencyStore } from './JJBD65HU.js';
-export { RegistrarBuilder, multiplexOrderedRegistrars } from './LFPTWOQW.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './GH7CHOFB.js';
 export { extractSchemaFromFactory } from './Q2CSNG76.js';
 export { FactoryDefinition, ObjectDefinition, deserializeDimensions, serializeDimensions } from './7HVKVF4T.js';
 import './VUOMXK5T.js';

package/dist/registrarBuilder.d.ts

@@ -71,6 +71,8 @@ export declare class RegistrarBuilder<_ReturnTypes> {
      * Alias a specific named node, such that when encountered in the tree,
      * it will be transformed to a different node before processing.
      * The transformed node's dependencies will be traversed instead.
+     * The transformed node is then passed through the class aliases, so e.g. a replacement
+     * ActivityFactoryDefinition is still wrapped by registrar-specific class aliases.
      * This is useful for short-circuiting dependency traversal for specific nodes.
      *
      * @param nodeName name of the node to alias
@@ -79,6 +81,7 @@ export declare class RegistrarBuilder<_ReturnTypes> {
     addNodeAlias(node: DependencyNode, getToNode: (fromNodeInstance: DependencyNode) => DependencyNode): this;
     /**
      * Returns a function that resolves node/class aliases registered on this builder.
+     * A node alias's result is passed through the class aliases too.
      * Useful for external traversals (e.g. CDK nodeExplorer) that need to follow
      * the same alias rules as the DFS built by {@link build}.
      */

package/dist/registrarBuilder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registrarBuilder.d.ts","sourceRoot":"","sources":["../src/registrarBuilder.ts"],"names":[],"mappings":"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"}
+{"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 './LFPTWOQW.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './GH7CHOFB.js';
 import './VUOMXK5T.js';
 //# sourceMappingURL=registrarBuilder.js.map
 //# sourceMappingURL=registrarBuilder.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@layerzerolabs/base-definitions",
-  "version": "1.2.89",
+  "version": "1.2.90",
   "private": false,
   "license": "MIT",
   "type": "module",
@@ -16,15 +16,15 @@
     "dist/**/*"
   ],
   "dependencies": {
-    "@layerzerolabs/dependency-graph": "1.2.89",
-    "@layerzerolabs/dfs": "1.2.89",
-    "@layerzerolabs/function-pointer": "1.2.89",
-    "@layerzerolabs/typescript-utils": "1.2.89",
+    "@layerzerolabs/dependency-graph": "1.2.90",
+    "@layerzerolabs/dfs": "1.2.90",
+    "@layerzerolabs/function-pointer": "1.2.90",
+    "@layerzerolabs/typescript-utils": "1.2.90",
     "zod": "4.3.5"
   },
   "devDependencies": {
-    "@layerzerolabs/tsup-configuration": "1.2.89",
-    "@layerzerolabs/typescript-configuration": "1.2.89",
+    "@layerzerolabs/tsup-configuration": "1.2.90",
+    "@layerzerolabs/typescript-configuration": "1.2.90",
     "tsup": "^8.4.0",
     "vitest": "^4.1.10"
   },

package/dist/LFPTWOQW.js.map

@@ -1 +0,0 @@
-{"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","getPrehandler","nodeAlias","aliased","setEntrypointsGetter","addDefault","build","mergedNodePrehandler","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":"LFPTWOQW.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     * Returns a function that resolves node/class aliases registered on this builder.\n     * Useful for external traversals (e.g. CDK nodeExplorer) that need to follow\n     * the same alias rules as the DFS built by {@link build}.\n     */\n    public getPrehandler(): (node: DependencyNode) => DependencyNode {\n        return (node) => {\n            const nodeAlias = this.nodeAliases[node.name];\n            const aliased = nodeAlias ? nodeAlias(node) : node;\n            for (const { fromNodeClass, getToNode } of this.classAliases) {\n                if (aliased instanceof fromNodeClass) return getToNode(aliased);\n            }\n            return aliased;\n        };\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 = this.getPrehandler();\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"]}