@layerzerolabs/base-definitions 0.2.6 → 0.2.8

package/dist/O7HENH25.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/registrarBuilder.ts"],"names":["RegistrarBuilder","defaultHandler","node","Error","JSON","stringify","classHandlers","classAliases","addClassHandler","nodeClass","identifier","fn","find","fromNodeClass","i","handler","prototype","isPrototypeOf","splice","push","addClassAlias","getToNode","alias","addDefault","build","mergedNodePrehandler","toNode","mergedNodeHandler","__name","ancestry","key","value","traverseDependencies","dfs","multiplexOrderedRegistrars","registrars","multiplexRegistrar","params","acc","name","registrar","result"],"mappings":"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","file":"O7HENH25.cjs","sourcesContent":["import type { DependencyNode } from '@layerzerolabs/dependency-graph';\nimport type { Registrar } from '@layerzerolabs/dfs';\nimport { dfs } from '@layerzerolabs/dfs';\nexport type { Registrar };\n\ntype NodeClass = new (...args: any[]) => DependencyNode;\ntype AbstractNodeClass = abstract new (...args: any[]) => DependencyNode;\n\n/**\n * <!-- anchor:RegistrarBuilder -->\n * A builder class for a {@link Registrar}.\n * Builds a registrar that switches on node class--i.e., enables defining\n * specific registration behaviour for specific node classes.\n * Intelligently handles inheritance, always using the most specific\n * handler defined for any given class.\n * The registrar built shall return an object that maps from a handler ID,\n * to a map from node name to the return of each handler,\n * e.g., { objectNodes: { myObjectNode: 'my handler return' }}.\n * This can be used to extract a specific resolved value after resolving the tree,\n * given that the handlers return the resolved nodes.\n */\nexport class RegistrarBuilder<_ReturnTypes> {\n    protected defaultHandler: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    constructor() {\n        this.defaultHandler = async (node: DependencyNode) => {\n            throw new Error(\n                `This registrar does not provide a handler for the dependency type used by ${JSON.stringify(node)}`,\n            );\n        };\n    }\n\n    protected classHandlers: {\n        nodeClass: AbstractNodeClass;\n        identifier: string;\n        fn: (node: DependencyNode, ancestry: DependencyNode[]) => Promise<any>;\n    }[] = [];\n\n    protected classAliases: {\n        fromNodeClass: AbstractNodeClass;\n        getToNode: (from: DependencyNode) => DependencyNode;\n    }[] = [];\n\n    /**\n     * Add a function fn to be called on all nodes of class\n     * @param nodeClass\n     * @param identifier\n     * @param fn\n     */\n    public addClassHandler<\n        Identifier extends string,\n        _NodeClass extends NodeClass,\n        Function extends (node: InstanceType<_NodeClass>, ancestry: DependencyNode[]) => any,\n    >(nodeClass: _NodeClass, identifier: Identifier, fn: Function) {\n        if (this.classAliases.find(({ fromNodeClass }) => fromNodeClass === nodeClass)) {\n            throw new Error(\n                `Cannot define a handler for a class that is aliased to something else. This would be pointless`,\n            );\n        }\n\n        let i = 0;\n        for (const handler of this.classHandlers) {\n            //check if we are overriding an existing handler\n            if (handler.nodeClass === nodeClass) {\n                this.classHandlers[i] = {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                };\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            //check if the new handler has an ordering requirement against an existing handler\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (handler.nodeClass.prototype.isPrototypeOf(nodeClass.prototype)) {\n                this.classHandlers.splice(i, 0, {\n                    nodeClass,\n                    identifier,\n                    fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n                });\n\n                return this as RegistrarBuilder<\n                    _ReturnTypes & {\n                        [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n                    }\n                >;\n            }\n            i++;\n        }\n\n        this.classHandlers.push({\n            nodeClass,\n            identifier,\n            fn: fn as unknown as (node: DependencyNode) => Promise<any>,\n        });\n\n        return this as RegistrarBuilder<\n            _ReturnTypes & {\n                [_K in Identifier]: { [nodeName: string]: Awaited<ReturnType<Function>> };\n            }\n        >;\n    }\n\n    /**\n     * Alias some class *from*, such that any node of that class in the tree will be\n     * treated as though it were some other node *to*. The *to* node is given as a\n     * function returning a class instance, so that its dependencies, name, etc can be fixed.\n     * The registrar will ignore the dependencies of the original node, and follow the alias's\n     * dependencies instead.\n     *\n     * Additionally, this method does not affect the typing of the registrar. The output type\n     * of the build() method will not reflect the alias.\n     *\n     * @param fromNodeClass alias instances of this class\n     * @param getToNode method that returns the *to* part of the alias\n     */\n    public addClassAlias<FromNodeClass extends AbstractNodeClass>(\n        fromNodeClass: FromNodeClass,\n        getToNode: (fromNodeInstance: InstanceType<FromNodeClass>) => DependencyNode,\n    ) {\n        if (this.classHandlers.find(({ nodeClass }) => nodeClass === fromNodeClass)) {\n            throw new Error(`Cannot define an alias for a class that already has a handler`);\n        }\n\n        let i = 0;\n        for (const alias of this.classAliases) {\n            //check if we are overriding an existing alias\n            if (alias.fromNodeClass === fromNodeClass) {\n                this.classAliases[i] = {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                };\n\n                return this;\n            }\n            //check if the new alias has an ordering requirement against an existing alias\n            //(we always want to use more specific handlers if they exist)\n            // eslint-disable-next-line no-prototype-builtins\n            if (alias.fromNodeClass.prototype.isPrototypeOf(fromNodeClass.prototype)) {\n                this.classAliases.splice(i, 0, {\n                    fromNodeClass,\n                    getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n                });\n\n                return this;\n            }\n            i++;\n        }\n\n        this.classAliases.push({\n            fromNodeClass,\n            getToNode: getToNode as unknown as (from: DependencyNode) => DependencyNode,\n        });\n\n        return this;\n    }\n\n    /**\n     * Add a default function fn to be used on nodes whose types do not have handlers.\n     * If this is not set, the default behaviour will be to throw\n     * @param fn\n     */\n    public addDefault(fn: (node: DependencyNode, ancestry: DependencyNode[]) => any) {\n        this.defaultHandler = fn;\n        return this;\n    }\n\n    public build(): Registrar<_ReturnTypes> {\n        const mergedNodePrehandler = (node: DependencyNode) => {\n            for (const { fromNodeClass, getToNode: toNode } of this.classAliases) {\n                if (node instanceof fromNodeClass) {\n                    return toNode(node);\n                }\n            }\n            return node;\n        };\n\n        const mergedNodeHandler = async (node: DependencyNode, ancestry: DependencyNode[]) => {\n            for (const { nodeClass, identifier, fn } of this.classHandlers) {\n                if (node instanceof nodeClass) {\n                    return {\n                        key: identifier,\n                        value: await fn(node, ancestry),\n                    };\n                }\n            }\n\n            return {\n                key: 'default',\n                value: await this.defaultHandler(node, ancestry),\n            };\n        };\n        return {\n            traverseDependencies: async (node: DependencyNode) =>\n                await dfs<_ReturnTypes>(node, mergedNodeHandler, mergedNodePrehandler)(),\n        };\n    }\n}\n\nexport const multiplexOrderedRegistrars = <\n    const T extends [name: string, registrar: Registrar<{}>][],\n>(\n    ...registrars: T\n) => {\n    const multiplexRegistrar: Registrar<{\n        [K in Extract<keyof T, number> as T[K] extends readonly [infer Name extends string, any]\n            ? Name\n            : never]: T[K] extends readonly [any, Registrar<infer Ret>] ? Ret : never;\n    }> = {\n        traverseDependencies: async (\n            ...params: Parameters<Registrar<any>['traverseDependencies']>\n        ) => {\n            const acc: Record<string, any> = {};\n            for (const [name, registrar] of registrars) {\n                const result = await registrar.traverseDependencies(...params);\n                acc[name] = result;\n            }\n\n            return acc;\n        },\n    } as any;\n\n    return multiplexRegistrar;\n};\n"]}

package/dist/VTYVOFLM.cjs.map

@@ -1 +0,0 @@
-{"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;EApIV;;;AAqIoBC,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;EA5KV;;;AA6KoBO,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":"VTYVOFLM.cjs","sourcesContent":["import type { z } from 'zod/v4';\n\nimport type { FunctionPointer } from '@layerzerolabs/common-utils';\nimport type { Dependencies } from '@layerzerolabs/dependency-graph';\nimport { DependencyNode } from '@layerzerolabs/dependency-graph';\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"]}