@layerzerolabs/base-definitions 0.2.22 → 0.2.24

package/.turbo/turbo-build.log

@@ -14,42 +14,42 @@
 ESM dist/definitions.js          216.00 B
 ESM dist/index.js                389.00 B
 ESM dist/lzyringe.js             146.00 B
-ESM dist/JJBD65HU.js             1.65 KB
 ESM dist/registrarBuilder.js     191.00 B
 ESM dist/utils.js                173.00 B
-ESM dist/3E4NCL37.js             6.70 KB
+ESM dist/JJBD65HU.js             1.65 KB
+ESM dist/I3HCQWKQ.js             6.70 KB
 ESM dist/2S27VOQW.js             733.00 B
-ESM dist/VUOMXK5T.js             222.00 B
 ESM dist/NX3PKFL6.js             1.47 KB
+ESM dist/VUOMXK5T.js             222.00 B
 ESM dist/definitions.js.map      75.00 B
 ESM dist/index.js.map            69.00 B
 ESM dist/lzyringe.js.map         72.00 B
-ESM dist/JJBD65HU.js.map         3.78 KB
 ESM dist/registrarBuilder.js.map 80.00 B
 ESM dist/utils.js.map            69.00 B
-ESM dist/3E4NCL37.js.map         18.32 KB
+ESM dist/JJBD65HU.js.map         3.78 KB
+ESM dist/I3HCQWKQ.js.map         18.42 KB
 ESM dist/2S27VOQW.js.map         1.81 KB
-ESM dist/VUOMXK5T.js.map         72.00 B
 ESM dist/NX3PKFL6.js.map         13.99 KB
-ESM ⚡️ Build success in 297ms
+ESM dist/VUOMXK5T.js.map         72.00 B
+ESM ⚡️ Build success in 330ms
 CJS dist/definitions.cjs          747.00 B
 CJS dist/index.cjs                1.42 KB
-CJS dist/lzyringe.cjs             302.00 B
 CJS dist/JKTGUQY4.cjs             1.70 KB
 CJS dist/registrarBuilder.cjs     478.00 B
-CJS dist/Q4VTGVJZ.cjs             6.90 KB
 CJS dist/utils.cjs                341.00 B
 CJS dist/BFYIZ3TT.cjs             815.00 B
+CJS dist/GJR4AWAW.cjs             6.90 KB
 CJS dist/5AS4XVUQ.cjs             1.68 KB
+CJS dist/lzyringe.cjs             302.00 B
 CJS dist/YJF4D23A.cjs             245.00 B
 CJS dist/definitions.cjs.map      76.00 B
 CJS dist/index.cjs.map            70.00 B
-CJS dist/lzyringe.cjs.map         73.00 B
 CJS dist/JKTGUQY4.cjs.map         3.78 KB
 CJS dist/registrarBuilder.cjs.map 81.00 B
-CJS dist/Q4VTGVJZ.cjs.map         18.34 KB
 CJS dist/utils.cjs.map            70.00 B
 CJS dist/BFYIZ3TT.cjs.map         1.83 KB
+CJS dist/GJR4AWAW.cjs.map         18.43 KB
 CJS dist/5AS4XVUQ.cjs.map         14.00 KB
+CJS dist/lzyringe.cjs.map         73.00 B
 CJS dist/YJF4D23A.cjs.map         73.00 B
-CJS ⚡️ Build success in 298ms
+CJS ⚡️ Build success in 334ms

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:57966) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1769040920314 is not specified and it doesn't parse as CommonJS.
+(node:67337) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1770955556851 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) 7ms
+ ✓ test/registrarBuilder.test.ts (7 tests) 10ms
 
  Test Files  1 passed (1)
       Tests  7 passed (7)
 Type Errors  no errors
-   Start at  00:18:11
-   Duration  372ms (transform 75ms, setup 0ms, collect 76ms, tests 7ms, environment 0ms, prepare 99ms)
+   Start at  04:08:59
+   Duration  461ms (transform 85ms, setup 0ms, collect 86ms, tests 10ms, environment 0ms, prepare 90ms)
 

package/dist/{Q4VTGVJZ.cjs → GJR4AWAW.cjs}

@@ -178,7 +178,7 @@ var RegistrarBuilder = class {
     }, "mergedNodeHandler");
     return {
       traverseDependencies: /* @__PURE__ */ YJF4D23A_cjs.__name(async (node) => {
-        const entrypoints = this.getEntrypoints(node);
+        const entrypoints = await this.getEntrypoints(node);
         if (entrypoints.length === 1) return await dfs.dfs(node, mergedNodeHandler, mergedNodePrehandler)();
         const dependencies = entrypoints.reduce((acc, cur) => {
           acc[cur.name] = cur;
@@ -214,5 +214,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ YJF4D23A_cjs.__name((...registr
 
 exports.RegistrarBuilder = RegistrarBuilder;
 exports.multiplexOrderedRegistrars = multiplexOrderedRegistrars;
-//# sourceMappingURL=Q4VTGVJZ.cjs.map
-//# sourceMappingURL=Q4VTGVJZ.cjs.map
+//# sourceMappingURL=GJR4AWAW.cjs.map
+//# sourceMappingURL=GJR4AWAW.cjs.map

package/dist/GJR4AWAW.cjs.map

@@ -0,0 +1 @@
+{"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/{3E4NCL37.js → I3HCQWKQ.js}

@@ -176,7 +176,7 @@ var RegistrarBuilder = class {
     }, "mergedNodeHandler");
     return {
       traverseDependencies: /* @__PURE__ */ __name(async (node) => {
-        const entrypoints = this.getEntrypoints(node);
+        const entrypoints = await this.getEntrypoints(node);
         if (entrypoints.length === 1) return await dfs(node, mergedNodeHandler, mergedNodePrehandler)();
         const dependencies = entrypoints.reduce((acc, cur) => {
           acc[cur.name] = cur;
@@ -211,5 +211,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ __name((...registrars) => {
 }, "multiplexOrderedRegistrars");
 
 export { RegistrarBuilder, multiplexOrderedRegistrars };
-//# sourceMappingURL=3E4NCL37.js.map
-//# sourceMappingURL=3E4NCL37.js.map
+//# sourceMappingURL=I3HCQWKQ.js.map
+//# sourceMappingURL=I3HCQWKQ.js.map

package/dist/I3HCQWKQ.js.map

@@ -0,0 +1 @@
+{"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"]}

package/dist/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
 var JKTGUQY4_cjs = require('./JKTGUQY4.cjs');
-var Q4VTGVJZ_cjs = require('./Q4VTGVJZ.cjs');
+var GJR4AWAW_cjs = require('./GJR4AWAW.cjs');
 var BFYIZ3TT_cjs = require('./BFYIZ3TT.cjs');
 var _5AS4XVUQ_cjs = require('./5AS4XVUQ.cjs');
 require('./YJF4D23A.cjs');
@@ -14,11 +14,11 @@ Object.defineProperty(exports, "DependencyStore", {
 });
 Object.defineProperty(exports, "RegistrarBuilder", {
   enumerable: true,
-  get: function () { return Q4VTGVJZ_cjs.RegistrarBuilder; }
+  get: function () { return GJR4AWAW_cjs.RegistrarBuilder; }
 });
 Object.defineProperty(exports, "multiplexOrderedRegistrars", {
   enumerable: true,
-  get: function () { return Q4VTGVJZ_cjs.multiplexOrderedRegistrars; }
+  get: function () { return GJR4AWAW_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 './3E4NCL37.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './I3HCQWKQ.js';
 export { extractSchemaFromFactory } from './2S27VOQW.js';
 export { FactoryDefinition, ObjectDefinition, deserializeDimensions, serializeDimensions } from './NX3PKFL6.js';
 import './VUOMXK5T.js';

package/dist/registrarBuilder.cjs

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

package/dist/registrarBuilder.d.ts

@@ -29,7 +29,7 @@ export declare class RegistrarBuilder<_ReturnTypes> {
         getToNode: (from: DependencyNode) => DependencyNode;
     }[];
     protected nodeAliases: Record<string, (node: DependencyNode) => DependencyNode>;
-    protected getEntrypoints: (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 & {
         ["nodeHandlers"]: {
@@ -73,7 +73,7 @@ export declare class RegistrarBuilder<_ReturnTypes> {
      * Set a custom entrypoint getter function. By default, the entrypoint getter
      * returns the node passed in as the sole entrypoint.
      */
-    setEntrypointsGetter(fn: (node: DependencyNode) => DependencyNode[]): this;
+    setEntrypointsGetter(fn: (node: DependencyNode) => DependencyNode[] | Promise<DependencyNode[]>): this;
     /**
      * Add a default function fn to be used on nodes whose types do not have handlers.
      * If this is not set, the default behaviour will be to throw

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 './3E4NCL37.js';
+export { RegistrarBuilder, multiplexOrderedRegistrars } from './I3HCQWKQ.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.22",
+  "version": "0.2.24",
   "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.22",
-    "@layerzerolabs/dfs": "0.2.22",
-    "@layerzerolabs/typescript-utils": "0.2.22",
-    "@layerzerolabs/function-pointer": "0.2.22"
+    "@layerzerolabs/dependency-graph": "0.2.24",
+    "@layerzerolabs/dfs": "0.2.24",
+    "@layerzerolabs/typescript-utils": "0.2.24",
+    "@layerzerolabs/function-pointer": "0.2.24"
   },
   "devDependencies": {
     "tsup": "^8.4.0",
     "vitest": "^3.2.3",
-    "@layerzerolabs/tsup-configuration": "0.2.22",
-    "@layerzerolabs/typescript-configuration": "0.2.22"
+    "@layerzerolabs/tsup-configuration": "0.2.24",
+    "@layerzerolabs/typescript-configuration": "0.2.24"
   },
   "publishConfig": {
     "access": "restricted",

package/src/registrarBuilder.ts

@@ -41,7 +41,9 @@ export class RegistrarBuilder<_ReturnTypes> {
 
     protected nodeAliases: Record<string, (node: DependencyNode) => DependencyNode> = {};
 
-    protected getEntrypoints: (node: DependencyNode) => DependencyNode[] = (node) => [node];
+    protected getEntrypoints: (
+        node: DependencyNode,
+    ) => DependencyNode[] | Promise<DependencyNode[]> = (node) => [node];
 
     constructor() {
         this.defaultHandler = async (node: DependencyNode) => {
@@ -211,7 +213,9 @@ export class RegistrarBuilder<_ReturnTypes> {
      * Set a custom entrypoint getter function. By default, the entrypoint getter
      * returns the node passed in as the sole entrypoint.
      */
-    public setEntrypointsGetter(fn: (node: DependencyNode) => DependencyNode[]) {
+    public setEntrypointsGetter(
+        fn: (node: DependencyNode) => DependencyNode[] | Promise<DependencyNode[]>,
+    ) {
         this.getEntrypoints = fn;
         return this;
     }
@@ -275,7 +279,7 @@ export class RegistrarBuilder<_ReturnTypes> {
         };
         return {
             traverseDependencies: async (node: DependencyNode) => {
-                const entrypoints = this.getEntrypoints(node);
+                const entrypoints = await this.getEntrypoints(node);
                 if (entrypoints.length === 1)
                     return await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)();
 

package/dist/3E4NCL37.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":"3E4NCL37.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: (node: DependencyNode) => 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(fn: (node: DependencyNode) => DependencyNode[]) {\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 = 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/Q4VTGVJZ.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":"Q4VTGVJZ.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: (node: DependencyNode) => 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(fn: (node: DependencyNode) => DependencyNode[]) {\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 = 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"]}