@layerzerolabs/base-definitions 0.2.6 → 0.2.8

package/.turbo/turbo-build.log

@@ -4,51 +4,51 @@
 
 CLI Building entry: src/definitions.ts, src/index.ts, src/lzyringe.ts, src/registrarBuilder.ts, src/utils.ts
 CLI Using tsconfig: tsconfig.json
-CLI tsup v8.4.0
+CLI tsup v8.5.1
 CLI Using tsup config: /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions/tsup.config.ts
 CLI Target: ES2023
 CLI Cleaning output folder
 CJS Build start
 ESM Build start
 CJS dist/definitions.cjs          742.00 B
-CJS dist/index.cjs                1.42 KB
 CJS dist/lzyringe.cjs             302.00 B
-CJS dist/registrarBuilder.cjs     478.00 B
-CJS dist/utils.cjs                341.00 B
+CJS dist/index.cjs                1.42 KB
 CJS dist/JKTGUQY4.cjs             1.70 KB
-CJS dist/OIBEOODK.cjs             812.00 B
+CJS dist/registrarBuilder.cjs     478.00 B
+CJS dist/6HCJDYOS.cjs             812.00 B
+CJS dist/utils.cjs                343.00 B
+CJS dist/E35XJD2D.cjs             1.68 KB
+CJS dist/Q4VTGVJZ.cjs             6.90 KB
 CJS dist/YJF4D23A.cjs             245.00 B
-CJS dist/O7HENH25.cjs             4.66 KB
-CJS dist/VTYVOFLM.cjs             1.68 KB
 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/index.cjs.map            70.00 B
 CJS dist/registrarBuilder.cjs.map 81.00 B
+CJS dist/6HCJDYOS.cjs.map         1.83 KB
 CJS dist/utils.cjs.map            70.00 B
-CJS dist/JKTGUQY4.cjs.map         3.78 KB
-CJS dist/OIBEOODK.cjs.map         1.83 KB
 CJS dist/YJF4D23A.cjs.map         73.00 B
-CJS dist/O7HENH25.cjs.map         12.79 KB
-CJS dist/VTYVOFLM.cjs.map         14.00 KB
-CJS ⚡️ Build success in 272ms
-ESM dist/definitions.js          216.00 B
+CJS dist/E35XJD2D.cjs.map         14.01 KB
+CJS dist/Q4VTGVJZ.cjs.map         18.34 KB
+CJS ⚡️ Build success in 186ms
 ESM dist/lzyringe.js             146.00 B
-ESM dist/index.js                389.00 B
-ESM dist/JJBD65HU.js             1.65 KB
+ESM dist/definitions.js          216.00 B
 ESM dist/registrarBuilder.js     191.00 B
+ESM dist/index.js                389.00 B
+ESM dist/F7GZNVSO.js             733.00 B
 ESM dist/utils.js                173.00 B
-ESM dist/EAPC6542.js             733.00 B
-ESM dist/4DUQS2FO.js             4.51 KB
-ESM dist/NQBJGAQC.js             1.47 KB
+ESM dist/JJBD65HU.js             1.65 KB
+ESM dist/3E4NCL37.js             6.70 KB
+ESM dist/XAFNHADO.js             1.47 KB
 ESM dist/VUOMXK5T.js             222.00 B
-ESM dist/definitions.js.map      75.00 B
 ESM dist/lzyringe.js.map         72.00 B
-ESM dist/index.js.map            69.00 B
-ESM dist/JJBD65HU.js.map         3.78 KB
+ESM dist/definitions.js.map      75.00 B
 ESM dist/registrarBuilder.js.map 80.00 B
+ESM dist/index.js.map            69.00 B
 ESM dist/utils.js.map            69.00 B
-ESM dist/EAPC6542.js.map         1.82 KB
-ESM dist/4DUQS2FO.js.map         12.78 KB
-ESM dist/NQBJGAQC.js.map         13.99 KB
+ESM dist/F7GZNVSO.js.map         1.82 KB
+ESM dist/JJBD65HU.js.map         3.78 KB
 ESM dist/VUOMXK5T.js.map         72.00 B
-ESM ⚡️ Build success in 273ms
+ESM dist/XAFNHADO.js.map         13.99 KB
+ESM dist/3E4NCL37.js.map         18.32 KB
+ESM ⚡️ Build success in 186ms

package/.turbo/turbo-lint.log

@@ -2,3 +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:26841) [MODULE_TYPELESS_PACKAGE_JSON] Warning: Module type of file:///home/runner/work/monorepo-internal/monorepo-internal/eslint.config.js?mtime=1766427679294 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

@@ -5,13 +5,13 @@
 Testing types with tsc and vue-tsc is an experimental feature.
 Breaking changes might not follow SemVer, please pin Vitest's version when using it.
 
- RUN  v3.2.3 /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
+ RUN  v3.2.4 /home/runner/work/monorepo-internal/monorepo-internal/packages/framework/definitions/base-definitions
 
- ✓ test/registrarBuilder.test.ts (4 tests) 9ms
+ ✓ test/registrarBuilder.test.ts (7 tests) 10ms
 
  Test Files  1 passed (1)
-      Tests  4 passed (4)
+      Tests  7 passed (7)
 Type Errors  no errors
-   Start at  21:06:01
-   Duration  626ms (transform 185ms, setup 0ms, collect 159ms, tests 9ms, environment 0ms, prepare 192ms)
+   Start at  18:26:22
+   Duration  548ms (transform 117ms, setup 0ms, collect 114ms, tests 10ms, environment 0ms, prepare 124ms)
 

package/dist/{4DUQS2FO.js → 3E4NCL37.js}

@@ -1,4 +1,5 @@
 import { __name } from './VUOMXK5T.js';
+import { DependencyNode } from '@layerzerolabs/dependency-graph';
 import { dfs } from '@layerzerolabs/dfs';
 
 var RegistrarBuilder = class {
@@ -6,13 +7,25 @@ var RegistrarBuilder = class {
     __name(this, "RegistrarBuilder");
   }
   defaultHandler;
+  nodeHandlers = {};
+  classHandlers = [];
+  classAliases = [];
+  nodeAliases = {};
+  getEntrypoints = /* @__PURE__ */ __name((node) => [
+    node
+  ], "getEntrypoints");
   constructor() {
     this.defaultHandler = async (node) => {
       throw new Error(`This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`);
     };
   }
-  classHandlers = [];
-  classAliases = [];
+  addNodeHandler(node, fn) {
+    if (this.nodeHandlers[node.name]) {
+      throw new Error(`Cannot define a node handler for an identifier that already has a handler: ${node.name}`);
+    }
+    this.nodeHandlers[node.name] = fn;
+    return this;
+  }
   /**
    * Add a function fn to be called on all nodes of class
    * @param nodeClass
@@ -91,6 +104,27 @@ var RegistrarBuilder = class {
     });
     return this;
   }
+  /**
+   * 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.
+   * This is useful for short-circuiting dependency traversal for specific nodes.
+   *
+   * @param nodeName name of the node to alias
+   * @param getToNode method that returns the transformed node
+   */
+  addNodeAlias(node, getToNode) {
+    this.nodeAliases[node.name] = getToNode;
+    return this;
+  }
+  /**
+   * Set a custom entrypoint getter function. By default, the entrypoint getter
+   * returns the node passed in as the sole entrypoint.
+   */
+  setEntrypointsGetter(fn) {
+    this.getEntrypoints = fn;
+    return this;
+  }
   /**
    * Add a default function fn to be used on nodes whose types do not have handlers.
    * If this is not set, the default behaviour will be to throw
@@ -102,6 +136,10 @@ var RegistrarBuilder = class {
   }
   build() {
     const mergedNodePrehandler = /* @__PURE__ */ __name((node) => {
+      const nodeAlias = this.nodeAliases[node.name];
+      if (nodeAlias) {
+        return nodeAlias(node);
+      }
       for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {
         if (node instanceof fromNodeClass) {
           return toNode(node);
@@ -110,6 +148,19 @@ var RegistrarBuilder = class {
       return node;
     }, "mergedNodePrehandler");
     const mergedNodeHandler = /* @__PURE__ */ __name(async (node, ancestry) => {
+      if (node.name === "_virtualEntrypoint") {
+        return {
+          key: node.name,
+          value: void 0
+        };
+      }
+      const nodeHandler = this.nodeHandlers[node.name];
+      if (nodeHandler) {
+        return {
+          key: node.name,
+          value: await nodeHandler(node, ancestry)
+        };
+      }
       for (const { nodeClass, identifier, fn } of this.classHandlers) {
         if (node instanceof nodeClass) {
           return {
@@ -124,7 +175,24 @@ var RegistrarBuilder = class {
       };
     }, "mergedNodeHandler");
     return {
-      traverseDependencies: /* @__PURE__ */ __name(async (node) => await dfs(node, mergedNodeHandler, mergedNodePrehandler)(), "traverseDependencies")
+      traverseDependencies: /* @__PURE__ */ __name(async (node) => {
+        const entrypoints = this.getEntrypoints(node);
+        if (entrypoints.length === 1) return await dfs(node, mergedNodeHandler, mergedNodePrehandler)();
+        const dependencies = entrypoints.reduce((acc, cur) => {
+          acc[cur.name] = cur;
+          return acc;
+        }, {});
+        let VirtualNode = class VirtualNode extends DependencyNode {
+          static {
+            __name(this, "VirtualNode");
+          }
+        };
+        const virtualEntrypoint = new VirtualNode({
+          name: "_virtualEntrypoint",
+          dependencies
+        });
+        return await dfs(virtualEntrypoint, mergedNodeHandler, mergedNodePrehandler)();
+      }, "traverseDependencies")
     };
   }
 };
@@ -143,5 +211,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ __name((...registrars) => {
 }, "multiplexOrderedRegistrars");
 
 export { RegistrarBuilder, multiplexOrderedRegistrars };
-//# sourceMappingURL=4DUQS2FO.js.map
-//# sourceMappingURL=4DUQS2FO.js.map
+//# sourceMappingURL=3E4NCL37.js.map
+//# sourceMappingURL=3E4NCL37.js.map

package/dist/3E4NCL37.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":"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/{OIBEOODK.cjs → 6HCJDYOS.cjs}

@@ -1,11 +1,11 @@
 'use strict';
 
-var VTYVOFLM_cjs = require('./VTYVOFLM.cjs');
+var E35XJD2D_cjs = require('./E35XJD2D.cjs');
 var YJF4D23A_cjs = require('./YJF4D23A.cjs');
 
 // src/utils.ts
 var extractSchemaFromFactory = /* @__PURE__ */ YJF4D23A_cjs.__name((factory, dimension) => {
-  const schema = (factory.dimensionToSchemaMap.byDimension && Object.values(factory.dimensionToSchemaMap.byDimension).find(([dim]) => VTYVOFLM_cjs.serializeDimensions(dim) === VTYVOFLM_cjs.serializeDimensions(dimension))?.[1]) ?? factory.dimensionToSchemaMap.base;
+  const schema = (factory.dimensionToSchemaMap.byDimension && Object.values(factory.dimensionToSchemaMap.byDimension).find(([dim]) => E35XJD2D_cjs.serializeDimensions(dim) === E35XJD2D_cjs.serializeDimensions(dimension))?.[1]) ?? factory.dimensionToSchemaMap.base;
   if (!schema?.shape) {
     throw new Error(`Couldn't resolve the schema of factory ${factory.name} for dim ${JSON.stringify(dimension)}`);
   }
@@ -13,5 +13,5 @@ var extractSchemaFromFactory = /* @__PURE__ */ YJF4D23A_cjs.__name((factory, dim
 }, "extractSchemaFromFactory");
 
 exports.extractSchemaFromFactory = extractSchemaFromFactory;
-//# sourceMappingURL=OIBEOODK.cjs.map
-//# sourceMappingURL=OIBEOODK.cjs.map
+//# sourceMappingURL=6HCJDYOS.cjs.map
+//# sourceMappingURL=6HCJDYOS.cjs.map

package/dist/{OIBEOODK.cjs.map → 6HCJDYOS.cjs.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils.ts"],"names":["extractSchemaFromFactory","__name","factory","dimension","schema","dimensionToSchemaMap","byDimension","Object","values","find","dim","serializeDimensions","base","shape","Error","name","JSON","stringify"],"mappings":";;;;;;AAOO,IAAMA,wBAAAA,mBAA2BC,mBAAA,CAAA,CACpCC,OAAAA,EACAC,SAAAA,KAAAA;AAEA,EAAA,MAAMC,MAAAA,GAAAA,CACDF,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAAA,IAC1BC,MAAAA,CAAOC,OAAON,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAW,CAAA,CAAoBG,IAAAA,CACtE,CAAC,CAACC,GAAAA,CAAAA,KAASC,gCAAAA,CAAoBD,GAAAA,CAAAA,KAASC,gCAAAA,CAAoBR,SAAAA,CAAAA,CAAAA,GAC5D,CAAA,CAAA,KACRD,OAAAA,CAAQG,oBAAAA,CAAqBO,IAAAA;AACjC,EAAA,IAAI,CAACR,QAAQS,KAAAA,EAAO;AAChB,IAAA,MAAM,IAAIC,KAAAA,CACN,CAAA,uCAAA,EAA0CZ,OAAAA,CAAQa,IAAI,YAAYC,IAAAA,CAAKC,SAAAA,CAAUd,SAAAA,CAAAA,CAAAA,CAAY,CAAA;AAErG,EAAA;AAEA,EAAA,OAAOC,MAAAA;AACX,CAAA,EAjBwC,0BAAA","file":"OIBEOODK.cjs","sourcesContent":["import type z from 'zod/v4';\n\nimport type { AdvancedRecord } from '@layerzerolabs/typescript-utils';\n\nimport type { Factory } from './definitions';\nimport { type FactoryDefinition, serializeDimensions } from './definitions';\n\nexport const extractSchemaFromFactory = <Dim extends z.ZodObject>(\n    factory: FactoryDefinition<any, Dim, any, any, any> | Factory<any, any, any, any>,\n    dimension: z.infer<Dim>,\n): z.ZodObject => {\n    const schema =\n        (factory.dimensionToSchemaMap.byDimension &&\n            Object.values(factory.dimensionToSchemaMap.byDimension as AdvancedRecord).find(\n                ([dim]) => serializeDimensions(dim) === serializeDimensions(dimension),\n            )?.[1]) ??\n        factory.dimensionToSchemaMap.base;\n    if (!schema?.shape) {\n        throw new Error(\n            `Couldn't resolve the schema of factory ${factory.name} for dim ${JSON.stringify(dimension)}`,\n        );\n    }\n\n    return schema;\n};\n"]}
+{"version":3,"sources":["../src/utils.ts"],"names":["extractSchemaFromFactory","__name","factory","dimension","schema","dimensionToSchemaMap","byDimension","Object","values","find","dim","serializeDimensions","base","shape","Error","name","JSON","stringify"],"mappings":";;;;;;AAOO,IAAMA,wBAAAA,mBAA2BC,mBAAA,CAAA,CACpCC,OAAAA,EACAC,SAAAA,KAAAA;AAEA,EAAA,MAAMC,MAAAA,GAAAA,CACDF,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAAA,IAC1BC,MAAAA,CAAOC,OAAON,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAW,CAAA,CAAoBG,IAAAA,CACtE,CAAC,CAACC,GAAAA,CAAAA,KAASC,gCAAAA,CAAoBD,GAAAA,CAAAA,KAASC,gCAAAA,CAAoBR,SAAAA,CAAAA,CAAAA,GAC5D,CAAA,CAAA,KACRD,OAAAA,CAAQG,oBAAAA,CAAqBO,IAAAA;AACjC,EAAA,IAAI,CAACR,QAAQS,KAAAA,EAAO;AAChB,IAAA,MAAM,IAAIC,KAAAA,CACN,CAAA,uCAAA,EAA0CZ,OAAAA,CAAQa,IAAI,YAAYC,IAAAA,CAAKC,SAAAA,CAAUd,SAAAA,CAAAA,CAAAA,CAAY,CAAA;AAErG,EAAA;AAEA,EAAA,OAAOC,MAAAA;AACX,CAAA,EAjBwC,0BAAA","file":"6HCJDYOS.cjs","sourcesContent":["import type z from 'zod/v4';\n\nimport type { AdvancedRecord } from '@layerzerolabs/typescript-utils';\n\nimport type { Factory } from './definitions';\nimport { type FactoryDefinition, serializeDimensions } from './definitions';\n\nexport const extractSchemaFromFactory = <Dim extends z.ZodObject>(\n    factory: FactoryDefinition<any, Dim, any, any, any> | Factory<any, any, any, any>,\n    dimension: z.infer<Dim>,\n): z.ZodObject => {\n    const schema =\n        (factory.dimensionToSchemaMap.byDimension &&\n            Object.values(factory.dimensionToSchemaMap.byDimension as AdvancedRecord).find(\n                ([dim]) => serializeDimensions(dim) === serializeDimensions(dimension),\n            )?.[1]) ??\n        factory.dimensionToSchemaMap.base;\n    if (!schema?.shape) {\n        throw new Error(\n            `Couldn't resolve the schema of factory ${factory.name} for dim ${JSON.stringify(dimension)}`,\n        );\n    }\n\n    return schema;\n};\n"]}

package/dist/{VTYVOFLM.cjs → E35XJD2D.cjs}

@@ -49,5 +49,5 @@ exports.FactoryDefinition = FactoryDefinition;
 exports.ObjectDefinition = ObjectDefinition;
 exports.deserializeDimensions = deserializeDimensions;
 exports.serializeDimensions = serializeDimensions;
-//# sourceMappingURL=VTYVOFLM.cjs.map
-//# sourceMappingURL=VTYVOFLM.cjs.map
+//# sourceMappingURL=E35XJD2D.cjs.map
+//# sourceMappingURL=E35XJD2D.cjs.map

package/dist/E35XJD2D.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/definitions.ts"],"names":["FactoryDefinition","DependencyNode","dimensions","specialization","dimensionToSchemaMap","getFactory","args","ObjectDefinition","schema","serializeDimensions","__name","dim","Object","keys","length","entries","sort","map","dimName","dimVal","join","deserializeDimensions","serializedDim","fromEntries","split","pair","dimValParts"],"mappings":";;;;;AAkIO,IAAMA,iBAAAA,GAAN,cAMGC,8BAAAA,CAAAA;EArIV;;;AAsIoBC,EAAAA,UAAAA;AACAC,EAAAA,cAAAA;AACAC,EAAAA,oBAAAA;AACAC,EAAAA,UAAAA;AAChB,EAAA,WAAA,CAAY,EACRH,UAAAA,EACAC,cAAAA,EACAC,sBACAC,UAAAA,EACA,GAAGC,MAAAA,EAMmE;AACtE,IAAA,KAAA,CAAMA,IAAAA,CAAAA;AACN,IAAA,IAAA,CAAKJ,UAAAA,GAAaA,UAAAA;AAClB,IAAA,IAAA,CAAKC,cAAAA,GAAiBA,cAAAA;AACtB,IAAA,IAAA,CAAKC,oBAAAA,GAAuBA,oBAAAA;AAC5B,IAAA,IAAA,CAAKC,UAAAA,GAAaA,UAAAA;AACtB,EAAA;AACJ;AAaO,IAAeE,gBAAAA,GAAf,cAIGN,8BAAAA,CAAAA;EA7KV;;;AA8KoBO,EAAAA,MAAAA;AAEhB,EAAA,WAAA,CAAY,EACRA,MAAAA,EACA,GAAGF,IAAAA,EAAAA,EAGmE;AACtE,IAAA,KAAA,CAAMA,IAAAA,CAAAA;AACN,IAAA,IAAA,CAAKE,MAAAA,GAASA,MAAAA;AAClB,EAAA;AACJ;AA8GO,IAAMC,mBAAAA,mBAAsBC,mBAAA,CAAA,CAACC,GAAAA,GAAc,EAAC,KAAC;AAChD,EAAA,OAAOC,MAAAA,CAAOC,IAAAA,CAAKF,GAAAA,CAAAA,CAAKG,MAAAA,GAClBF,OAAOG,OAAAA,CAAQJ,GAAAA,CAAAA,CACVK,IAAAA,EAAI,CACJC,GAAAA,CAAI,CAAC,CAACC,OAAAA,EAASC,MAAAA,CAAAA,KAAY,CAAA,EAAGD,OAAAA,CAAAA,CAAAA,EAAWC,MAAAA,CAAAA,CAAQ,CAAA,CACjDC,IAAAA,CAAK,GAAA,CAAA,GACV,OAAA;AACV,CAAA,EAPmC,qBAAA;AAS5B,IAAMC,qBAAAA,wCAAyBC,aAAAA,KAAAA;AAClC,EAAA,IAAIA,kBAAkB,OAAA,EAAS;AAC3B,IAAA,OAAO,EAAC;AACZ,EAAA;AAEA,EAAA,OAAOV,MAAAA,CAAOW,YACVD,aAAAA,CAAcE,KAAAA,CAAM,GAAA,CAAA,CAAKP,GAAAA,CAAI,CAACQ,IAAAA,KAAAA;AAC1B,IAAA,MAAM,CAACP,OAAAA,EAAS,GAAGQ,WAAAA,CAAAA,GAAeD,IAAAA,CAAKD,MAAM,GAAA,CAAA;AAC7C,IAAA,OAAO;AAACN,MAAAA,OAAAA;AAASQ,MAAAA,WAAAA,CAAYN,KAAK,GAAA;;AACtC,EAAA,CAAA,CAAA,CAAA;AAER,CAAA,EAXqC,uBAAA","file":"E35XJD2D.cjs","sourcesContent":["import type { z } from 'zod/v4';\n\nimport type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { FunctionPointer } from '@layerzerolabs/function-pointer';\nimport type {\n    AdvancedRecord,\n    AdvancedRecordLookup,\n    Merge,\n    MethodNameOf,\n    RemoveNever,\n    UnionToIntersection,\n} from '@layerzerolabs/typescript-utils';\nimport type { IsAny } from '@layerzerolabs/typescript-utils';\n\nexport type DimensionToSchemaMap<DimConstraint extends object = object> = {\n    byDimension?: AdvancedRecord<DimConstraint, z.ZodType>;\n    base: z.ZodType;\n};\n\nexport type FactorySpecialization<DMap extends DimensionToSchemaMap = DimensionToSchemaMap> = {\n    spec: z.ZodObject<any>;\n    exempt: readonly MethodNameOf<GetSupersetOfModelsFromSchema<DMap>>[];\n};\n\nexport type WithInjectedSpecialization<T, Specialization extends FactorySpecialization<any>> = [\n    {},\n] extends [z.infer<Specialization['spec']>]\n    ? T\n    : {\n          [K in keyof T]: K extends Specialization['exempt'][number]\n              ? T[K]\n              : T[K] extends (...args: infer A) => infer R\n                ? (specialization: z.infer<Specialization['spec']>, ...args: A) => R\n                : T[K];\n      };\n\nexport type WithSpecializeMethod<WithInjection, WithoutInjection, S> = {} extends S\n    ? WithoutInjection\n    : WithInjection extends (...args: infer Args) => infer Ret\n      ? (...args: Args) => Ret\n      : WithInjection & {\n            specialize: (specialization: S) => WithoutInjection;\n        };\n\nexport type GetModelFromSchema<DMap extends DimensionToSchemaMap, Dim> =\n    IsAny<Dim> extends true\n        ? z.infer<DMap['base']>\n        : AdvancedRecordLookup<DMap['byDimension'], Dim> extends never\n          ? z.infer<DMap['base']>\n          : Merge<z.infer<DMap['base']>, z.infer<AdvancedRecordLookup<DMap['byDimension'], Dim>>>;\n\nexport type GetSupersetOfModelsFromSchema<DMap extends DimensionToSchemaMap> = UnionToIntersection<\n    {\n        [Key in keyof DMap['byDimension']]: DMap['byDimension'][Key] extends [any, any]\n            ? z.infer<DMap['byDimension'][Key][1]>\n            : never;\n    }[keyof DMap['byDimension']]\n> &\n    z.infer<DMap['base']>;\n\ntype GetImplFunctionWithConditionalOptionalDim<Dim, Return> = {} extends Dim\n    ? (dim?: Dim) => Return\n    : (dim: Dim) => Return;\n\ntype GetImplOverloads<\n    Dim extends z.ZodObject<any>,\n    Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n> = UnionToIntersection<\n    | {\n          [I in keyof DMap['byDimension']]: DMap['byDimension'][I] extends readonly [infer K, any]\n              ? {\n                    getImpl: GetImplFunctionWithConditionalOptionalDim<\n                        K,\n                        WithSpecializeMethod<\n                            WithInjectedSpecialization<GetModelFromSchema<DMap, K>, Specialization>,\n                            GetModelFromSchema<DMap, K>,\n                            z.infer<Specialization['spec']>\n                        >\n                    >;\n                }\n              : never;\n      }[keyof DMap['byDimension']]\n    | {\n          getImpl: GetImplFunctionWithConditionalOptionalDim<\n              z.infer<Dim>,\n              WithSpecializeMethod<\n                  WithInjectedSpecialization<z.infer<DMap['base']>, Specialization>,\n                  z.infer<DMap['base']>,\n                  z.infer<Specialization['spec']>\n              >\n          >;\n      }\n>;\n\nexport type Factory<\n    _Dependencies extends Dependencies,\n    Dim extends z.ZodObject<any>,\n    Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n> = {\n    name: string;\n    implKeys: string[];\n    dimensionToSchemaMap: DMap;\n} & GetImplOverloads<Dim, Specialization, DMap>;\n\nexport type GetFactory<\n    _Dependencies extends Dependencies,\n    Dim extends z.ZodObject<any>,\n    Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n> = () =>\n    | Factory<_Dependencies, Dim, Specialization, DMap>\n    | Promise<Factory<_Dependencies, Dim, Specialization, DMap>>;\n\n/**\n * <!-- anchor:FactoryDefinition -->\n * Factory definitions are a type of dependency node that shall be resolved to a *factory*.\n * A factory is an object that provides a getImpl method which accepts some parameters `dim`,\n * and returns some object `getImplMetadata.getModel(dim)`.\n * That is, a factory definition is given by the set of parameters it uses to get its implementations,\n * and a function defining the schema it will return for each set of parameters.\n * @param name inherited from {@link DependencyNode}\n * @param dependencies inherited from {@link DependencyNode}\n * @param dimensions a Zod schema for the parameters this factory operates on.\n * @param dimensionToSchemaMap A map from dimension objects to the Zod schema for the implementation.\n * @param getFactory a method that should return an object with a `getImpl` method that returns\n * entities adhering to the schema for the corresponding `getModel` call\n */\nexport class FactoryDefinition<\n    Name extends string,\n    Dim extends z.ZodObject<any>,\n    const Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n    _Dependencies extends Dependencies,\n> extends DependencyNode<Name, _Dependencies> {\n    public readonly dimensions: Dim;\n    public readonly specialization: Specialization;\n    public readonly dimensionToSchemaMap: DMap;\n    public readonly getFactory: GetFactory<_Dependencies, Dim, Specialization, DMap>;\n    constructor({\n        dimensions,\n        specialization,\n        dimensionToSchemaMap,\n        getFactory,\n        ...args\n    }: {\n        dimensions: Dim;\n        specialization: Specialization;\n        dimensionToSchemaMap: DMap;\n        getFactory: GetFactory<_Dependencies, Dim, Specialization, DMap>;\n    } & ConstructorParameters<typeof DependencyNode<Name, _Dependencies>>[0]) {\n        super(args);\n        this.dimensions = dimensions;\n        this.specialization = specialization;\n        this.dimensionToSchemaMap = dimensionToSchemaMap;\n        this.getFactory = getFactory;\n    }\n}\n\n/**\n * <!-- anchor:ObjectDefinition -->\n * An object definition is a dependency node that refers to some entity\n * matching a given schema. That is, it may be resolved to any entity\n * that adheres to the {@link schema}.\n * The object definition is abstract, as it cannot be meaningfully resolved without\n * additional information. For an example of an object definition, see ReflexiveObjectDefinition or ContextDefinition\n * @param name inherited from {@link DependencyNode}\n * @param dependencies inherited from {@link DependencyNode}\n * @param schema a Zod schema defining the expected resolution for this definition\n */\nexport abstract class ObjectDefinition<\n    Name extends string,\n    Schema extends z.ZodSchema,\n    _Dependencies extends Dependencies,\n> extends DependencyNode<Name, _Dependencies> {\n    public readonly schema: Schema;\n\n    constructor({\n        schema,\n        ...args\n    }: {\n        schema: Schema;\n    } & ConstructorParameters<typeof DependencyNode<Name, _Dependencies>>[0]) {\n        super(args);\n        this.schema = schema;\n    }\n}\n\nexport type Definition<Name extends string> =\n    | FactoryDefinition<Name, any, any, any, any>\n    | ObjectDefinition<Name, any, any>;\n\n/**\n * Infers the expected type of a definition once it has been resolved\n */\nexport type ResolvedDefinition<Definition extends DependencyNode<any, any>> =\n    Definition extends ObjectDefinition<any, infer Schema, any>\n        ? z.infer<Schema>\n        : Definition extends FactoryDefinition<\n                any,\n                infer Dim,\n                infer Specialization,\n                infer DMap,\n                any\n            >\n          ? Factory<Definition['dependencies'], Dim, Specialization, DMap>\n          : Definition extends FactoryDefinition<any, any, any, any, any>\n            ? Factory<\n                  Definition['dependencies'],\n                  Definition['dimensions'],\n                  Definition['specialization'],\n                  Definition['dimensionToSchemaMap']\n              >\n            : unknown;\n\n/**\n * Given a record from string to definition, maps each definition T to ResolvedDefinition<T>. Removes `definition` suffix from name\n */\nexport type ResolvedDefinitionMap<Deps extends Dependencies> = {\n    [Key in keyof Deps as Key extends `${infer Name}Definition` ? Name : Key]: ResolvedDefinition<\n        Deps[Key]\n    >;\n};\n\n/**\n * For some factory definition F and some dimension D s.t. D ⊇ F.dimensions, infers the expected return type of\n * ResolvedDefinition<F>.getImpl(D)\n */\nexport type ResolvedFactoryImplementation<Definition extends DependencyNode<any, any>, Dim> =\n    Definition extends FactoryDefinition<any, any, any, any, any>\n        ? WithSpecializeMethod<\n              WithInjectedSpecialization<\n                  GetModelFromSchema<Definition['dimensionToSchemaMap'], Dim>,\n                  Definition['specialization']\n              >,\n              GetModelFromSchema<Definition['dimensionToSchemaMap'], Dim>,\n              z.infer<Definition['specialization']['spec']>\n          >\n        : never;\n\ntype RemoveDefinitionSuffix<Key extends string> = Key extends `${infer Name}Definition`\n    ? Name\n    : Key;\ntype ReplaceFactorySuffix<Key extends string> = Key extends `${infer Name}Factory`\n    ? `${Name}Impl`\n    : Key;\n\n/**\n * Given a record from string to definition and some dimension D, maps each definition T to ResolvedFactoryImplementation<T, D>\n * Removes Definition | ActivityFactory | Factory from the suffix of the key\n */\nexport type ResolvedFactoryImplementationMap<Deps extends Dependencies, Dim> = RemoveNever<{\n    [Key in keyof Deps as Key extends string\n        ? ReplaceFactorySuffix<RemoveDefinitionSuffix<Key>>\n        : never]: ResolvedFactoryImplementation<Deps[Key], Dim>;\n}>;\n\ntype ActivityFactoryContext<\n    _FactoryDefinition extends FactoryDefinition<any, any, any, any, any>,\n    Dim,\n    _PrivateSchemaExtension extends z.ZodObject = z.ZodObject<{}, z.core.$strip>,\n> = {\n    getFunctionPointer: <\n        MethodName extends MethodNameOf<\n            ResolvedFactoryImplementation<_FactoryDefinition, Dim> &\n                z.infer<_PrivateSchemaExtension>\n        >,\n    >(\n        methodName: MethodName,\n    ) => FunctionPointer<\n        (ResolvedFactoryImplementation<_FactoryDefinition, Dim> &\n            z.infer<_PrivateSchemaExtension>)[MethodName]\n    >;\n};\n\n/**\n * The parameters that shall be received by a factory's implementation getter\n */\nexport type Context<\n    _FactoryDefinition extends FactoryDefinition<any, any, any, any, any>,\n    Dim,\n    _PrivateSchemaExtension extends z.ZodObject = z.ZodObject<{}, z.core.$strip>,\n> = {\n    name: _FactoryDefinition extends FactoryDefinition<infer Name, any, any, any, any>\n        ? Name\n        : never;\n    dependencies: _FactoryDefinition extends FactoryDefinition<any, any, any, any, infer Deps>\n        ? ResolvedDefinitionMap<Deps>\n        : never;\n    dim: Dim;\n    impls: _FactoryDefinition extends FactoryDefinition<any, any, any, any, infer Deps>\n        ? ResolvedFactoryImplementationMap<Deps, Dim>\n        : never;\n    self: ResolvedFactoryImplementation<_FactoryDefinition, Dim> & z.infer<_PrivateSchemaExtension>;\n} & ActivityFactoryContext<_FactoryDefinition, Dim, _PrivateSchemaExtension>;\n\nexport const serializeDimensions = (dim: object = {}) => {\n    return Object.keys(dim).length\n        ? Object.entries(dim)\n              .sort()\n              .map(([dimName, dimVal]) => `${dimName}_${dimVal}`)\n              .join('&')\n        : '_base';\n};\n\nexport const deserializeDimensions = (serializedDim: string) => {\n    if (serializedDim === '_base') {\n        return {};\n    }\n\n    return Object.fromEntries(\n        serializedDim.split('&').map((pair) => {\n            const [dimName, ...dimValParts] = pair.split('_');\n            return [dimName, dimValParts.join('_')];\n        }),\n    );\n};\n"]}

package/dist/{EAPC6542.js → F7GZNVSO.js}

@@ -1,4 +1,4 @@
-import { serializeDimensions } from './NQBJGAQC.js';
+import { serializeDimensions } from './XAFNHADO.js';
 import { __name } from './VUOMXK5T.js';
 
 // src/utils.ts
@@ -11,5 +11,5 @@ var extractSchemaFromFactory = /* @__PURE__ */ __name((factory, dimension) => {
 }, "extractSchemaFromFactory");
 
 export { extractSchemaFromFactory };
-//# sourceMappingURL=EAPC6542.js.map
-//# sourceMappingURL=EAPC6542.js.map
+//# sourceMappingURL=F7GZNVSO.js.map
+//# sourceMappingURL=F7GZNVSO.js.map

package/dist/{EAPC6542.js.map → F7GZNVSO.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/utils.ts"],"names":["extractSchemaFromFactory","factory","dimension","schema","dimensionToSchemaMap","byDimension","Object","values","find","dim","serializeDimensions","base","shape","Error","name","JSON","stringify"],"mappings":";;;;AAOO,IAAMA,wBAAAA,mBAA2B,MAAA,CAAA,CACpCC,OAAAA,EACAC,SAAAA,KAAAA;AAEA,EAAA,MAAMC,MAAAA,GAAAA,CACDF,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAAA,IAC1BC,MAAAA,CAAOC,OAAON,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAW,CAAA,CAAoBG,IAAAA,CACtE,CAAC,CAACC,GAAAA,CAAAA,KAASC,mBAAAA,CAAoBD,GAAAA,CAAAA,KAASC,mBAAAA,CAAoBR,SAAAA,CAAAA,CAAAA,GAC5D,CAAA,CAAA,KACRD,OAAAA,CAAQG,oBAAAA,CAAqBO,IAAAA;AACjC,EAAA,IAAI,CAACR,QAAQS,KAAAA,EAAO;AAChB,IAAA,MAAM,IAAIC,KAAAA,CACN,CAAA,uCAAA,EAA0CZ,OAAAA,CAAQa,IAAI,YAAYC,IAAAA,CAAKC,SAAAA,CAAUd,SAAAA,CAAAA,CAAAA,CAAY,CAAA;AAErG,EAAA;AAEA,EAAA,OAAOC,MAAAA;AACX,CAAA,EAjBwC,0BAAA","file":"EAPC6542.js","sourcesContent":["import type z from 'zod/v4';\n\nimport type { AdvancedRecord } from '@layerzerolabs/typescript-utils';\n\nimport type { Factory } from './definitions';\nimport { type FactoryDefinition, serializeDimensions } from './definitions';\n\nexport const extractSchemaFromFactory = <Dim extends z.ZodObject>(\n    factory: FactoryDefinition<any, Dim, any, any, any> | Factory<any, any, any, any>,\n    dimension: z.infer<Dim>,\n): z.ZodObject => {\n    const schema =\n        (factory.dimensionToSchemaMap.byDimension &&\n            Object.values(factory.dimensionToSchemaMap.byDimension as AdvancedRecord).find(\n                ([dim]) => serializeDimensions(dim) === serializeDimensions(dimension),\n            )?.[1]) ??\n        factory.dimensionToSchemaMap.base;\n    if (!schema?.shape) {\n        throw new Error(\n            `Couldn't resolve the schema of factory ${factory.name} for dim ${JSON.stringify(dimension)}`,\n        );\n    }\n\n    return schema;\n};\n"]}
+{"version":3,"sources":["../src/utils.ts"],"names":["extractSchemaFromFactory","factory","dimension","schema","dimensionToSchemaMap","byDimension","Object","values","find","dim","serializeDimensions","base","shape","Error","name","JSON","stringify"],"mappings":";;;;AAOO,IAAMA,wBAAAA,mBAA2B,MAAA,CAAA,CACpCC,OAAAA,EACAC,SAAAA,KAAAA;AAEA,EAAA,MAAMC,MAAAA,GAAAA,CACDF,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAAA,IAC1BC,MAAAA,CAAOC,OAAON,OAAAA,CAAQG,oBAAAA,CAAqBC,WAAW,CAAA,CAAoBG,IAAAA,CACtE,CAAC,CAACC,GAAAA,CAAAA,KAASC,mBAAAA,CAAoBD,GAAAA,CAAAA,KAASC,mBAAAA,CAAoBR,SAAAA,CAAAA,CAAAA,GAC5D,CAAA,CAAA,KACRD,OAAAA,CAAQG,oBAAAA,CAAqBO,IAAAA;AACjC,EAAA,IAAI,CAACR,QAAQS,KAAAA,EAAO;AAChB,IAAA,MAAM,IAAIC,KAAAA,CACN,CAAA,uCAAA,EAA0CZ,OAAAA,CAAQa,IAAI,YAAYC,IAAAA,CAAKC,SAAAA,CAAUd,SAAAA,CAAAA,CAAAA,CAAY,CAAA;AAErG,EAAA;AAEA,EAAA,OAAOC,MAAAA;AACX,CAAA,EAjBwC,0BAAA","file":"F7GZNVSO.js","sourcesContent":["import type z from 'zod/v4';\n\nimport type { AdvancedRecord } from '@layerzerolabs/typescript-utils';\n\nimport type { Factory } from './definitions';\nimport { type FactoryDefinition, serializeDimensions } from './definitions';\n\nexport const extractSchemaFromFactory = <Dim extends z.ZodObject>(\n    factory: FactoryDefinition<any, Dim, any, any, any> | Factory<any, any, any, any>,\n    dimension: z.infer<Dim>,\n): z.ZodObject => {\n    const schema =\n        (factory.dimensionToSchemaMap.byDimension &&\n            Object.values(factory.dimensionToSchemaMap.byDimension as AdvancedRecord).find(\n                ([dim]) => serializeDimensions(dim) === serializeDimensions(dimension),\n            )?.[1]) ??\n        factory.dimensionToSchemaMap.base;\n    if (!schema?.shape) {\n        throw new Error(\n            `Couldn't resolve the schema of factory ${factory.name} for dim ${JSON.stringify(dimension)}`,\n        );\n    }\n\n    return schema;\n};\n"]}

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

@@ -1,6 +1,7 @@
 'use strict';
 
 var YJF4D23A_cjs = require('./YJF4D23A.cjs');
+var dependencyGraph = require('@layerzerolabs/dependency-graph');
 var dfs = require('@layerzerolabs/dfs');
 
 var RegistrarBuilder = class {
@@ -8,13 +9,25 @@ var RegistrarBuilder = class {
     YJF4D23A_cjs.__name(this, "RegistrarBuilder");
   }
   defaultHandler;
+  nodeHandlers = {};
+  classHandlers = [];
+  classAliases = [];
+  nodeAliases = {};
+  getEntrypoints = /* @__PURE__ */ YJF4D23A_cjs.__name((node) => [
+    node
+  ], "getEntrypoints");
   constructor() {
     this.defaultHandler = async (node) => {
       throw new Error(`This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`);
     };
   }
-  classHandlers = [];
-  classAliases = [];
+  addNodeHandler(node, fn) {
+    if (this.nodeHandlers[node.name]) {
+      throw new Error(`Cannot define a node handler for an identifier that already has a handler: ${node.name}`);
+    }
+    this.nodeHandlers[node.name] = fn;
+    return this;
+  }
   /**
    * Add a function fn to be called on all nodes of class
    * @param nodeClass
@@ -93,6 +106,27 @@ var RegistrarBuilder = class {
     });
     return this;
   }
+  /**
+   * 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.
+   * This is useful for short-circuiting dependency traversal for specific nodes.
+   *
+   * @param nodeName name of the node to alias
+   * @param getToNode method that returns the transformed node
+   */
+  addNodeAlias(node, getToNode) {
+    this.nodeAliases[node.name] = getToNode;
+    return this;
+  }
+  /**
+   * Set a custom entrypoint getter function. By default, the entrypoint getter
+   * returns the node passed in as the sole entrypoint.
+   */
+  setEntrypointsGetter(fn) {
+    this.getEntrypoints = fn;
+    return this;
+  }
   /**
    * Add a default function fn to be used on nodes whose types do not have handlers.
    * If this is not set, the default behaviour will be to throw
@@ -104,6 +138,10 @@ var RegistrarBuilder = class {
   }
   build() {
     const mergedNodePrehandler = /* @__PURE__ */ YJF4D23A_cjs.__name((node) => {
+      const nodeAlias = this.nodeAliases[node.name];
+      if (nodeAlias) {
+        return nodeAlias(node);
+      }
       for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {
         if (node instanceof fromNodeClass) {
           return toNode(node);
@@ -112,6 +150,19 @@ var RegistrarBuilder = class {
       return node;
     }, "mergedNodePrehandler");
     const mergedNodeHandler = /* @__PURE__ */ YJF4D23A_cjs.__name(async (node, ancestry) => {
+      if (node.name === "_virtualEntrypoint") {
+        return {
+          key: node.name,
+          value: void 0
+        };
+      }
+      const nodeHandler = this.nodeHandlers[node.name];
+      if (nodeHandler) {
+        return {
+          key: node.name,
+          value: await nodeHandler(node, ancestry)
+        };
+      }
       for (const { nodeClass, identifier, fn } of this.classHandlers) {
         if (node instanceof nodeClass) {
           return {
@@ -126,7 +177,24 @@ var RegistrarBuilder = class {
       };
     }, "mergedNodeHandler");
     return {
-      traverseDependencies: /* @__PURE__ */ YJF4D23A_cjs.__name(async (node) => await dfs.dfs(node, mergedNodeHandler, mergedNodePrehandler)(), "traverseDependencies")
+      traverseDependencies: /* @__PURE__ */ YJF4D23A_cjs.__name(async (node) => {
+        const entrypoints = this.getEntrypoints(node);
+        if (entrypoints.length === 1) return await dfs.dfs(node, mergedNodeHandler, mergedNodePrehandler)();
+        const dependencies = entrypoints.reduce((acc, cur) => {
+          acc[cur.name] = cur;
+          return acc;
+        }, {});
+        let VirtualNode = class VirtualNode extends dependencyGraph.DependencyNode {
+          static {
+            YJF4D23A_cjs.__name(this, "VirtualNode");
+          }
+        };
+        const virtualEntrypoint = new VirtualNode({
+          name: "_virtualEntrypoint",
+          dependencies
+        });
+        return await dfs.dfs(virtualEntrypoint, mergedNodeHandler, mergedNodePrehandler)();
+      }, "traverseDependencies")
     };
   }
 };
@@ -146,5 +214,5 @@ var multiplexOrderedRegistrars = /* @__PURE__ */ YJF4D23A_cjs.__name((...registr
 
 exports.RegistrarBuilder = RegistrarBuilder;
 exports.multiplexOrderedRegistrars = multiplexOrderedRegistrars;
-//# sourceMappingURL=O7HENH25.cjs.map
-//# sourceMappingURL=O7HENH25.cjs.map
+//# sourceMappingURL=Q4VTGVJZ.cjs.map
+//# sourceMappingURL=Q4VTGVJZ.cjs.map

package/dist/Q4VTGVJZ.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":"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"]}

package/dist/{NQBJGAQC.js → XAFNHADO.js}

@@ -44,5 +44,5 @@ var deserializeDimensions = /* @__PURE__ */ __name((serializedDim) => {
 }, "deserializeDimensions");
 
 export { FactoryDefinition, ObjectDefinition, deserializeDimensions, serializeDimensions };
-//# sourceMappingURL=NQBJGAQC.js.map
-//# sourceMappingURL=NQBJGAQC.js.map
+//# sourceMappingURL=XAFNHADO.js.map
+//# sourceMappingURL=XAFNHADO.js.map

package/dist/XAFNHADO.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/definitions.ts"],"names":["FactoryDefinition","DependencyNode","dimensions","specialization","dimensionToSchemaMap","getFactory","args","ObjectDefinition","schema","serializeDimensions","dim","Object","keys","length","entries","sort","map","dimName","dimVal","join","deserializeDimensions","serializedDim","fromEntries","split","pair","dimValParts"],"mappings":";;;AAkIO,IAAMA,iBAAAA,GAAN,cAMGC,cAAAA,CAAAA;EArIV;;;AAsIoBC,EAAAA,UAAAA;AACAC,EAAAA,cAAAA;AACAC,EAAAA,oBAAAA;AACAC,EAAAA,UAAAA;AAChB,EAAA,WAAA,CAAY,EACRH,UAAAA,EACAC,cAAAA,EACAC,sBACAC,UAAAA,EACA,GAAGC,MAAAA,EAMmE;AACtE,IAAA,KAAA,CAAMA,IAAAA,CAAAA;AACN,IAAA,IAAA,CAAKJ,UAAAA,GAAaA,UAAAA;AAClB,IAAA,IAAA,CAAKC,cAAAA,GAAiBA,cAAAA;AACtB,IAAA,IAAA,CAAKC,oBAAAA,GAAuBA,oBAAAA;AAC5B,IAAA,IAAA,CAAKC,UAAAA,GAAaA,UAAAA;AACtB,EAAA;AACJ;AAaO,IAAeE,gBAAAA,GAAf,cAIGN,cAAAA,CAAAA;EA7KV;;;AA8KoBO,EAAAA,MAAAA;AAEhB,EAAA,WAAA,CAAY,EACRA,MAAAA,EACA,GAAGF,IAAAA,EAAAA,EAGmE;AACtE,IAAA,KAAA,CAAMA,IAAAA,CAAAA;AACN,IAAA,IAAA,CAAKE,MAAAA,GAASA,MAAAA;AAClB,EAAA;AACJ;AA8GO,IAAMC,mBAAAA,mBAAsB,MAAA,CAAA,CAACC,GAAAA,GAAc,EAAC,KAAC;AAChD,EAAA,OAAOC,MAAAA,CAAOC,IAAAA,CAAKF,GAAAA,CAAAA,CAAKG,MAAAA,GAClBF,OAAOG,OAAAA,CAAQJ,GAAAA,CAAAA,CACVK,IAAAA,EAAI,CACJC,GAAAA,CAAI,CAAC,CAACC,OAAAA,EAASC,MAAAA,CAAAA,KAAY,CAAA,EAAGD,OAAAA,CAAAA,CAAAA,EAAWC,MAAAA,CAAAA,CAAQ,CAAA,CACjDC,IAAAA,CAAK,GAAA,CAAA,GACV,OAAA;AACV,CAAA,EAPmC,qBAAA;AAS5B,IAAMC,qBAAAA,2BAAyBC,aAAAA,KAAAA;AAClC,EAAA,IAAIA,kBAAkB,OAAA,EAAS;AAC3B,IAAA,OAAO,EAAC;AACZ,EAAA;AAEA,EAAA,OAAOV,MAAAA,CAAOW,YACVD,aAAAA,CAAcE,KAAAA,CAAM,GAAA,CAAA,CAAKP,GAAAA,CAAI,CAACQ,IAAAA,KAAAA;AAC1B,IAAA,MAAM,CAACP,OAAAA,EAAS,GAAGQ,WAAAA,CAAAA,GAAeD,IAAAA,CAAKD,MAAM,GAAA,CAAA;AAC7C,IAAA,OAAO;AAACN,MAAAA,OAAAA;AAASQ,MAAAA,WAAAA,CAAYN,KAAK,GAAA;;AACtC,EAAA,CAAA,CAAA,CAAA;AAER,CAAA,EAXqC,uBAAA","file":"XAFNHADO.js","sourcesContent":["import type { z } from 'zod/v4';\n\nimport type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { FunctionPointer } from '@layerzerolabs/function-pointer';\nimport type {\n    AdvancedRecord,\n    AdvancedRecordLookup,\n    Merge,\n    MethodNameOf,\n    RemoveNever,\n    UnionToIntersection,\n} from '@layerzerolabs/typescript-utils';\nimport type { IsAny } from '@layerzerolabs/typescript-utils';\n\nexport type DimensionToSchemaMap<DimConstraint extends object = object> = {\n    byDimension?: AdvancedRecord<DimConstraint, z.ZodType>;\n    base: z.ZodType;\n};\n\nexport type FactorySpecialization<DMap extends DimensionToSchemaMap = DimensionToSchemaMap> = {\n    spec: z.ZodObject<any>;\n    exempt: readonly MethodNameOf<GetSupersetOfModelsFromSchema<DMap>>[];\n};\n\nexport type WithInjectedSpecialization<T, Specialization extends FactorySpecialization<any>> = [\n    {},\n] extends [z.infer<Specialization['spec']>]\n    ? T\n    : {\n          [K in keyof T]: K extends Specialization['exempt'][number]\n              ? T[K]\n              : T[K] extends (...args: infer A) => infer R\n                ? (specialization: z.infer<Specialization['spec']>, ...args: A) => R\n                : T[K];\n      };\n\nexport type WithSpecializeMethod<WithInjection, WithoutInjection, S> = {} extends S\n    ? WithoutInjection\n    : WithInjection extends (...args: infer Args) => infer Ret\n      ? (...args: Args) => Ret\n      : WithInjection & {\n            specialize: (specialization: S) => WithoutInjection;\n        };\n\nexport type GetModelFromSchema<DMap extends DimensionToSchemaMap, Dim> =\n    IsAny<Dim> extends true\n        ? z.infer<DMap['base']>\n        : AdvancedRecordLookup<DMap['byDimension'], Dim> extends never\n          ? z.infer<DMap['base']>\n          : Merge<z.infer<DMap['base']>, z.infer<AdvancedRecordLookup<DMap['byDimension'], Dim>>>;\n\nexport type GetSupersetOfModelsFromSchema<DMap extends DimensionToSchemaMap> = UnionToIntersection<\n    {\n        [Key in keyof DMap['byDimension']]: DMap['byDimension'][Key] extends [any, any]\n            ? z.infer<DMap['byDimension'][Key][1]>\n            : never;\n    }[keyof DMap['byDimension']]\n> &\n    z.infer<DMap['base']>;\n\ntype GetImplFunctionWithConditionalOptionalDim<Dim, Return> = {} extends Dim\n    ? (dim?: Dim) => Return\n    : (dim: Dim) => Return;\n\ntype GetImplOverloads<\n    Dim extends z.ZodObject<any>,\n    Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n> = UnionToIntersection<\n    | {\n          [I in keyof DMap['byDimension']]: DMap['byDimension'][I] extends readonly [infer K, any]\n              ? {\n                    getImpl: GetImplFunctionWithConditionalOptionalDim<\n                        K,\n                        WithSpecializeMethod<\n                            WithInjectedSpecialization<GetModelFromSchema<DMap, K>, Specialization>,\n                            GetModelFromSchema<DMap, K>,\n                            z.infer<Specialization['spec']>\n                        >\n                    >;\n                }\n              : never;\n      }[keyof DMap['byDimension']]\n    | {\n          getImpl: GetImplFunctionWithConditionalOptionalDim<\n              z.infer<Dim>,\n              WithSpecializeMethod<\n                  WithInjectedSpecialization<z.infer<DMap['base']>, Specialization>,\n                  z.infer<DMap['base']>,\n                  z.infer<Specialization['spec']>\n              >\n          >;\n      }\n>;\n\nexport type Factory<\n    _Dependencies extends Dependencies,\n    Dim extends z.ZodObject<any>,\n    Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n> = {\n    name: string;\n    implKeys: string[];\n    dimensionToSchemaMap: DMap;\n} & GetImplOverloads<Dim, Specialization, DMap>;\n\nexport type GetFactory<\n    _Dependencies extends Dependencies,\n    Dim extends z.ZodObject<any>,\n    Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n> = () =>\n    | Factory<_Dependencies, Dim, Specialization, DMap>\n    | Promise<Factory<_Dependencies, Dim, Specialization, DMap>>;\n\n/**\n * <!-- anchor:FactoryDefinition -->\n * Factory definitions are a type of dependency node that shall be resolved to a *factory*.\n * A factory is an object that provides a getImpl method which accepts some parameters `dim`,\n * and returns some object `getImplMetadata.getModel(dim)`.\n * That is, a factory definition is given by the set of parameters it uses to get its implementations,\n * and a function defining the schema it will return for each set of parameters.\n * @param name inherited from {@link DependencyNode}\n * @param dependencies inherited from {@link DependencyNode}\n * @param dimensions a Zod schema for the parameters this factory operates on.\n * @param dimensionToSchemaMap A map from dimension objects to the Zod schema for the implementation.\n * @param getFactory a method that should return an object with a `getImpl` method that returns\n * entities adhering to the schema for the corresponding `getModel` call\n */\nexport class FactoryDefinition<\n    Name extends string,\n    Dim extends z.ZodObject<any>,\n    const Specialization extends FactorySpecialization<DMap>,\n    DMap extends DimensionToSchemaMap<z.infer<Dim>>,\n    _Dependencies extends Dependencies,\n> extends DependencyNode<Name, _Dependencies> {\n    public readonly dimensions: Dim;\n    public readonly specialization: Specialization;\n    public readonly dimensionToSchemaMap: DMap;\n    public readonly getFactory: GetFactory<_Dependencies, Dim, Specialization, DMap>;\n    constructor({\n        dimensions,\n        specialization,\n        dimensionToSchemaMap,\n        getFactory,\n        ...args\n    }: {\n        dimensions: Dim;\n        specialization: Specialization;\n        dimensionToSchemaMap: DMap;\n        getFactory: GetFactory<_Dependencies, Dim, Specialization, DMap>;\n    } & ConstructorParameters<typeof DependencyNode<Name, _Dependencies>>[0]) {\n        super(args);\n        this.dimensions = dimensions;\n        this.specialization = specialization;\n        this.dimensionToSchemaMap = dimensionToSchemaMap;\n        this.getFactory = getFactory;\n    }\n}\n\n/**\n * <!-- anchor:ObjectDefinition -->\n * An object definition is a dependency node that refers to some entity\n * matching a given schema. That is, it may be resolved to any entity\n * that adheres to the {@link schema}.\n * The object definition is abstract, as it cannot be meaningfully resolved without\n * additional information. For an example of an object definition, see ReflexiveObjectDefinition or ContextDefinition\n * @param name inherited from {@link DependencyNode}\n * @param dependencies inherited from {@link DependencyNode}\n * @param schema a Zod schema defining the expected resolution for this definition\n */\nexport abstract class ObjectDefinition<\n    Name extends string,\n    Schema extends z.ZodSchema,\n    _Dependencies extends Dependencies,\n> extends DependencyNode<Name, _Dependencies> {\n    public readonly schema: Schema;\n\n    constructor({\n        schema,\n        ...args\n    }: {\n        schema: Schema;\n    } & ConstructorParameters<typeof DependencyNode<Name, _Dependencies>>[0]) {\n        super(args);\n        this.schema = schema;\n    }\n}\n\nexport type Definition<Name extends string> =\n    | FactoryDefinition<Name, any, any, any, any>\n    | ObjectDefinition<Name, any, any>;\n\n/**\n * Infers the expected type of a definition once it has been resolved\n */\nexport type ResolvedDefinition<Definition extends DependencyNode<any, any>> =\n    Definition extends ObjectDefinition<any, infer Schema, any>\n        ? z.infer<Schema>\n        : Definition extends FactoryDefinition<\n                any,\n                infer Dim,\n                infer Specialization,\n                infer DMap,\n                any\n            >\n          ? Factory<Definition['dependencies'], Dim, Specialization, DMap>\n          : Definition extends FactoryDefinition<any, any, any, any, any>\n            ? Factory<\n                  Definition['dependencies'],\n                  Definition['dimensions'],\n                  Definition['specialization'],\n                  Definition['dimensionToSchemaMap']\n              >\n            : unknown;\n\n/**\n * Given a record from string to definition, maps each definition T to ResolvedDefinition<T>. Removes `definition` suffix from name\n */\nexport type ResolvedDefinitionMap<Deps extends Dependencies> = {\n    [Key in keyof Deps as Key extends `${infer Name}Definition` ? Name : Key]: ResolvedDefinition<\n        Deps[Key]\n    >;\n};\n\n/**\n * For some factory definition F and some dimension D s.t. D ⊇ F.dimensions, infers the expected return type of\n * ResolvedDefinition<F>.getImpl(D)\n */\nexport type ResolvedFactoryImplementation<Definition extends DependencyNode<any, any>, Dim> =\n    Definition extends FactoryDefinition<any, any, any, any, any>\n        ? WithSpecializeMethod<\n              WithInjectedSpecialization<\n                  GetModelFromSchema<Definition['dimensionToSchemaMap'], Dim>,\n                  Definition['specialization']\n              >,\n              GetModelFromSchema<Definition['dimensionToSchemaMap'], Dim>,\n              z.infer<Definition['specialization']['spec']>\n          >\n        : never;\n\ntype RemoveDefinitionSuffix<Key extends string> = Key extends `${infer Name}Definition`\n    ? Name\n    : Key;\ntype ReplaceFactorySuffix<Key extends string> = Key extends `${infer Name}Factory`\n    ? `${Name}Impl`\n    : Key;\n\n/**\n * Given a record from string to definition and some dimension D, maps each definition T to ResolvedFactoryImplementation<T, D>\n * Removes Definition | ActivityFactory | Factory from the suffix of the key\n */\nexport type ResolvedFactoryImplementationMap<Deps extends Dependencies, Dim> = RemoveNever<{\n    [Key in keyof Deps as Key extends string\n        ? ReplaceFactorySuffix<RemoveDefinitionSuffix<Key>>\n        : never]: ResolvedFactoryImplementation<Deps[Key], Dim>;\n}>;\n\ntype ActivityFactoryContext<\n    _FactoryDefinition extends FactoryDefinition<any, any, any, any, any>,\n    Dim,\n    _PrivateSchemaExtension extends z.ZodObject = z.ZodObject<{}, z.core.$strip>,\n> = {\n    getFunctionPointer: <\n        MethodName extends MethodNameOf<\n            ResolvedFactoryImplementation<_FactoryDefinition, Dim> &\n                z.infer<_PrivateSchemaExtension>\n        >,\n    >(\n        methodName: MethodName,\n    ) => FunctionPointer<\n        (ResolvedFactoryImplementation<_FactoryDefinition, Dim> &\n            z.infer<_PrivateSchemaExtension>)[MethodName]\n    >;\n};\n\n/**\n * The parameters that shall be received by a factory's implementation getter\n */\nexport type Context<\n    _FactoryDefinition extends FactoryDefinition<any, any, any, any, any>,\n    Dim,\n    _PrivateSchemaExtension extends z.ZodObject = z.ZodObject<{}, z.core.$strip>,\n> = {\n    name: _FactoryDefinition extends FactoryDefinition<infer Name, any, any, any, any>\n        ? Name\n        : never;\n    dependencies: _FactoryDefinition extends FactoryDefinition<any, any, any, any, infer Deps>\n        ? ResolvedDefinitionMap<Deps>\n        : never;\n    dim: Dim;\n    impls: _FactoryDefinition extends FactoryDefinition<any, any, any, any, infer Deps>\n        ? ResolvedFactoryImplementationMap<Deps, Dim>\n        : never;\n    self: ResolvedFactoryImplementation<_FactoryDefinition, Dim> & z.infer<_PrivateSchemaExtension>;\n} & ActivityFactoryContext<_FactoryDefinition, Dim, _PrivateSchemaExtension>;\n\nexport const serializeDimensions = (dim: object = {}) => {\n    return Object.keys(dim).length\n        ? Object.entries(dim)\n              .sort()\n              .map(([dimName, dimVal]) => `${dimName}_${dimVal}`)\n              .join('&')\n        : '_base';\n};\n\nexport const deserializeDimensions = (serializedDim: string) => {\n    if (serializedDim === '_base') {\n        return {};\n    }\n\n    return Object.fromEntries(\n        serializedDim.split('&').map((pair) => {\n            const [dimName, ...dimValParts] = pair.split('_');\n            return [dimName, dimValParts.join('_')];\n        }),\n    );\n};\n"]}