@proto-kit/common 0.1.1-develop.0

package/dist/config/ModuleContainer.d.ts

@@ -0,0 +1,162 @@
+import "reflect-metadata";
+import { DependencyContainer, InjectionToken } from "tsyringe";
+import { MergeObjects, StringKeyOf, TypedClass } from "../types";
+import { DependencyFactory, InferDependencies } from "../dependencyFactory/DependencyFactory";
+import { EventEmitterProxy } from "../events/EventEmitterProxy";
+import { Configurable, ConfigurableModule, NoConfig } from "./ConfigurableModule";
+import { ChildContainerProvider } from "./ChildContainerProvider";
+import { ChildContainerCreatable } from "./ChildContainerCreatable";
+export declare const ModuleContainerErrors: {
+    configNotSetInContainer: (moduleName: string) => Error;
+    onlyValidModuleNames: (moduleName: NonNullable<unknown>) => Error;
+    unableToDecorateModule: (moduleName: InjectionToken<unknown>) => Error;
+    nonModuleDependency: (runtimeModuleName: string) => Error;
+    unknownDependency: (runtimeModuleName: string, name: string) => Error;
+    dependencyContainerNotSet: (className: string) => Error;
+    validModuleInstance: (moduleName: string, moduleTypeName: string) => Error;
+};
+export interface BaseModuleInstanceType extends ChildContainerCreatable, Configurable<unknown> {
+}
+export type BaseModuleType = TypedClass<BaseModuleInstanceType>;
+export interface ModulesRecord<ModuleType extends BaseModuleType = BaseModuleType> {
+    [name: string]: ModuleType;
+}
+export type ModulesConfig<Modules extends ModulesRecord> = {
+    [ConfigKey in StringKeyOf<Modules>]: InstanceType<Modules[ConfigKey]> extends Configurable<infer Config> ? Config extends NoConfig ? Config | undefined : Config : never;
+};
+/**
+ * This type make any config partial (i.e. optional) up to the first level
+ * So { Module: { a: { b: string } } }
+ * will become
+ * { Module?: { a?: { b: string } } }
+ * Note that b does not become optional, as we don't want nested objects to
+ * become unreasonably partialized (for example Field).
+ */
+export type RecursivePartial<T> = {
+    [Key in keyof T]?: Partial<T[Key]>;
+};
+/**
+ * Parameters required when creating a module container instance
+ */
+export interface ModuleContainerDefinition<Modules extends ModulesRecord> {
+    modules: Modules;
+    /**
+     * @deprecated
+     */
+    config?: ModulesConfig<Modules>;
+}
+export type FilterNeverValues<Type extends Record<string, unknown>> = {
+    [Key in keyof Type as Type[Key] extends never ? never : Key]: Type[Key];
+};
+export type DependenciesFromModules<Modules extends ModulesRecord> = FilterNeverValues<{
+    [Key in keyof Modules]: Modules[Key] extends TypedClass<DependencyFactory> ? InferDependencies<InstanceType<Modules[Key]>> : never;
+}>;
+export type ResolvableModules<Modules extends ModulesRecord> = MergeObjects<DependenciesFromModules<Modules>> & Modules;
+/**
+ * Reusable module container facilitating registration, resolution
+ * configuration, decoration and validation of modules
+ */
+export declare class ModuleContainer<Modules extends ModulesRecord> extends ConfigurableModule<ModulesConfig<Modules>> {
+    definition: ModuleContainerDefinition<Modules>;
+    /**
+     * Determines how often are modules decorated upon resolution
+     * from the tsyringe DI container
+     */
+    private static readonly moduleDecorationFrequency;
+    private providedContainer?;
+    private eventEmitterProxy;
+    constructor(definition: ModuleContainerDefinition<Modules>);
+    /**
+     * @returns list of module names
+     */
+    get moduleNames(): string[];
+    /**
+     * Check if the provided module satisfies the container requirements,
+     * such as only injecting other known modules.
+     *
+     * @param moduleName
+     * @param containedModule
+     */
+    protected validateModule(moduleName: StringKeyOf<Modules>, containedModule: ConfigurableModule<unknown>): void;
+    protected get container(): DependencyContainer;
+    /**
+     * Assert that the iterated `moduleName` is of ModuleName type,
+     * otherwise it may be just string e.g. when modules are iterated over
+     * using e.g. a for loop.
+     */
+    assertIsValidModuleName(moduleName: string): asserts moduleName is StringKeyOf<Modules>;
+    isValidModuleName(modules: Modules, moduleName: number | string | symbol): moduleName is StringKeyOf<Modules>;
+    assertContainerInitialized(container: DependencyContainer | undefined): asserts container is DependencyContainer;
+    protected registerAliases(originalToken: string, clas: TypedClass<any>): void;
+    /**
+     * Register modules into the current container, and registers
+     * a respective resolution hook in order to decorate the module
+     * upon/after resolution.
+     *
+     * @param modules
+     */
+    protected registerModules(modules: Modules): void;
+    get events(): EventEmitterProxy<Modules>;
+    /**
+     * Register a non-module value into the current container
+     * @param modules
+     */
+    registerValue<Value>(modules: Record<string, Value>): void;
+    protected registerClasses(modules: Record<string, TypedClass<unknown>>): void;
+    /**
+     * Provide additional configuration after the ModuleContainer was created.
+     *
+     * Keep in mind that modules are only decorated once after they are resolved,
+     * therefore applying any configuration must happen
+     * before the first resolution.
+     * @param config
+     */
+    configure(config: ModulesConfig<Modules>): void;
+    configurePartial(config: RecursivePartial<ModulesConfig<Modules>>): void;
+    get config(): ModulesConfig<Modules>;
+    set config(config: ModulesConfig<Modules>);
+    /**
+     * Resolves a module from the current module container
+     *
+     * We have to narrow down the `ModuleName` type here to
+     * `ResolvableModuleName`, otherwise the resolved value might
+     * be any module instance, not the one specifically requested as argument.
+     *
+     * @param moduleName
+     * @returns
+     */
+    resolve<KeyType extends StringKeyOf<ResolvableModules<Modules>>>(moduleName: KeyType): InstanceType<ResolvableModules<Modules>[KeyType]>;
+    resolveOrFail<ModuleType>(moduleName: string, moduleType: TypedClass<ModuleType>): ModuleType;
+    /**
+     * Override this in the child class to provide custom
+     * features or module checks
+     */
+    protected decorateModule(moduleName: StringKeyOf<Modules>, containedModule: InstanceType<Modules[StringKeyOf<Modules>]>): void;
+    private isDependencyFactory;
+    /**
+     * Inject a set of dependencies using the given list of DependencyFactories
+     * This method should be called during startup
+     */
+    protected initializeDependencyFactories(factories: StringKeyOf<Modules>[]): void;
+    /**
+     * Retrieves all dependencies generated by a particular dependencyfactory
+     * and injects them inside this modulecontainer's DI container.
+     * This will be automatically called for every module, but can also be called
+     * explicitly to initialize an extra factory
+     * @param factory
+     * @private
+     */
+    protected useDependencyFactory(factory: DependencyFactory): void;
+    /**
+     * Handle module resolution, e.g. by decorating resolved modules
+     * @param moduleName
+     */
+    protected onAfterModuleResolution(moduleName: StringKeyOf<Modules>): void;
+    /**
+     * This is a placeholder for individual modules to override.
+     * This method will be called whenever the underlying container fully
+     * initialized
+     */
+    create(childContainerProvider: ChildContainerProvider): void;
+}
+//# sourceMappingURL=ModuleContainer.d.ts.map

package/dist/config/ModuleContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleContainer.d.ts","sourceRoot":"","sources":["../../src/config/ModuleContainer.ts"],"names":[],"mappings":"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"}

package/dist/config/ModuleContainer.js

@@ -0,0 +1,289 @@
+import "reflect-metadata";
+import { instanceCachingFactory, isClassProvider, isFactoryProvider, isTokenProvider, isValueProvider, Lifecycle, } from "tsyringe";
+import log from "loglevel";
+import merge from "lodash/merge";
+import { EventEmitterProxy } from "../events/EventEmitterProxy";
+import { ConfigurableModule, } from "./ConfigurableModule";
+import { getInjectAliases } from "./injectAlias";
+const errors = {
+    configNotSetInContainer: (moduleName) => new Error(`Trying to get config of ${moduleName}, but it was not yet set in the module container`),
+    onlyValidModuleNames: (moduleName) => new Error(
+    // eslint-disable-next-line @typescript-eslint/no-base-to-string
+    `Only known module names are allowed, using unknown module name: ${moduleName}`),
+    unableToDecorateModule: (moduleName) => 
+    // eslint-disable-next-line @typescript-eslint/no-base-to-string
+    new Error(`Unable to decorate module ${moduleName.toString()}`),
+    nonModuleDependency: (runtimeModuleName) => new Error(`
+  Unable to register module: ${runtimeModuleName}, attempting to inject a non-module dependency`),
+    unknownDependency: (runtimeModuleName, name) => new Error(`Unable to register module: ${runtimeModuleName}, 
+      attempting to inject a dependency that is not registered 
+      as a runtime module for this chain: ${name}`),
+    dependencyContainerNotSet: (className) => new Error(`DependencyContainer not set. Be sure to only call DI-related function in create() and not inside the constructor. (${className})`),
+    validModuleInstance: (moduleName, moduleTypeName) => new Error(`Incompatible module instance ("${moduleName}" not instanceof ${moduleTypeName})`),
+};
+export const ModuleContainerErrors = errors;
+/**
+ * Reusable module container facilitating registration, resolution
+ * configuration, decoration and validation of modules
+ */
+export class ModuleContainer extends ConfigurableModule {
+    constructor(definition) {
+        super();
+        this.definition = definition;
+        // DI container holding all the registered modules
+        this.providedContainer = undefined;
+        this.eventEmitterProxy = undefined;
+    }
+    /**
+     * @returns list of module names
+     */
+    get moduleNames() {
+        return Object.keys(this.definition.modules);
+    }
+    /**
+     * Check if the provided module satisfies the container requirements,
+     * such as only injecting other known modules.
+     *
+     * @param moduleName
+     * @param containedModule
+     */
+    validateModule(moduleName, containedModule) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+        const dependencies = Reflect.getMetadata("design:paramtypes", containedModule);
+        dependencies?.forEach((dependency) => {
+            const name = typeof dependency === "string" ? dependency : dependency.name;
+            if (name === undefined) {
+                throw errors.nonModuleDependency(moduleName);
+            }
+            if (!this.moduleNames.includes(name)) {
+                throw errors.unknownDependency(moduleName, name);
+            }
+        });
+    }
+    get container() {
+        this.assertContainerInitialized(this.providedContainer);
+        return this.providedContainer;
+    }
+    /**
+     * Assert that the iterated `moduleName` is of ModuleName type,
+     * otherwise it may be just string e.g. when modules are iterated over
+     * using e.g. a for loop.
+     */
+    assertIsValidModuleName(moduleName) {
+        if (!this.isValidModuleName(this.definition.modules, moduleName)) {
+            throw errors.onlyValidModuleNames(moduleName);
+        }
+    }
+    isValidModuleName(modules, moduleName) {
+        return Object.prototype.hasOwnProperty.call(modules, moduleName);
+    }
+    assertContainerInitialized(container) {
+        if (container === undefined) {
+            throw errors.dependencyContainerNotSet(this.constructor.name);
+        }
+    }
+    registerAliases(originalToken, clas) {
+        const aliases = getInjectAliases(clas);
+        aliases.forEach((alias) => this.container.register(alias, {
+            useToken: originalToken,
+        }));
+    }
+    /**
+     * Register modules into the current container, and registers
+     * a respective resolution hook in order to decorate the module
+     * upon/after resolution.
+     *
+     * @param modules
+     */
+    registerModules(modules) {
+        Object.keys(modules).forEach((moduleName) => {
+            if (Object.prototype.hasOwnProperty.call(modules, moduleName)) {
+                this.assertIsValidModuleName(moduleName);
+                log.debug(`Registering module: ${moduleName}`);
+                const useClass = modules[moduleName];
+                this.container.register(moduleName, { useClass }, { lifecycle: Lifecycle.ContainerScoped });
+                this.onAfterModuleResolution(moduleName);
+                this.registerAliases(moduleName, useClass);
+            }
+        });
+    }
+    get events() {
+        if (this.eventEmitterProxy === undefined) {
+            this.eventEmitterProxy = new EventEmitterProxy(this);
+        }
+        return this.eventEmitterProxy;
+    }
+    /**
+     * Register a non-module value into the current container
+     * @param modules
+     */
+    // TODO Rename to plural since object is param
+    registerValue(modules) {
+        Object.entries(modules).forEach(([moduleName, useValue]) => {
+            this.container.register(moduleName, { useValue });
+        });
+    }
+    registerClasses(modules) {
+        Object.entries(modules).forEach(([moduleName, useClass]) => {
+            this.container.register(moduleName, { useClass }, { lifecycle: Lifecycle.ContainerScoped });
+        });
+    }
+    /**
+     * Provide additional configuration after the ModuleContainer was created.
+     *
+     * Keep in mind that modules are only decorated once after they are resolved,
+     * therefore applying any configuration must happen
+     * before the first resolution.
+     * @param config
+     */
+    configure(config) {
+        this.config = config;
+    }
+    configurePartial(config) {
+        this.config = merge(this.currentConfig ?? {}, config);
+    }
+    get config() {
+        return super.config;
+    }
+    set config(config) {
+        super.config = merge(this.currentConfig ?? {}, config);
+    }
+    /**
+     * Resolves a module from the current module container
+     *
+     * We have to narrow down the `ModuleName` type here to
+     * `ResolvableModuleName`, otherwise the resolved value might
+     * be any module instance, not the one specifically requested as argument.
+     *
+     * @param moduleName
+     * @returns
+     */
+    resolve(moduleName) {
+        return this.container.resolve(moduleName);
+    }
+    resolveOrFail(moduleName, moduleType) {
+        const instance = this.container.resolve(moduleName);
+        const isValidModuleInstance = instance instanceof moduleType;
+        if (!isValidModuleInstance) {
+            throw errors.validModuleInstance(moduleName, moduleType.name);
+        }
+        return instance;
+    }
+    /**
+     * Override this in the child class to provide custom
+     * features or module checks
+     */
+    decorateModule(moduleName, containedModule) {
+        const config = super.config?.[moduleName];
+        // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
+        if (!config) {
+            throw errors.configNotSetInContainer(moduleName.toString());
+        }
+        if (containedModule instanceof ModuleContainer) {
+            containedModule.configure(config);
+        }
+        else {
+            containedModule.config = config;
+        }
+    }
+    isDependencyFactory(type) {
+        return "dependencies" in type;
+    }
+    /**
+     * Inject a set of dependencies using the given list of DependencyFactories
+     * This method should be called during startup
+     */
+    initializeDependencyFactories(factories) {
+        factories.forEach((factoryName) => {
+            this.resolve(factoryName);
+        });
+    }
+    /**
+     * Retrieves all dependencies generated by a particular dependencyfactory
+     * and injects them inside this modulecontainer's DI container.
+     * This will be automatically called for every module, but can also be called
+     * explicitly to initialize an extra factory
+     * @param factory
+     * @private
+     */
+    useDependencyFactory(factory) {
+        const dependencies = factory.dependencies();
+        Object.entries(dependencies).forEach(([rawKey, declaration]) => {
+            const key = rawKey.charAt(0).toUpperCase() + rawKey.slice(1);
+            if (!this.container.isRegistered(key) ||
+                declaration.forceOverwrite === true) {
+                // Find correct provider type and call respective register
+                if (isValueProvider(declaration)) {
+                    this.container.register(key, declaration);
+                }
+                else if (isFactoryProvider(declaration)) {
+                    // this enables us to have a singletoned factory
+                    // that returns the same instance for each resolve
+                    this.container.register(key, {
+                        useFactory: instanceCachingFactory(declaration.useFactory),
+                    });
+                }
+                else if (isClassProvider(declaration)) {
+                    this.container.register(key, declaration, {
+                        lifecycle: Lifecycle.Singleton,
+                    });
+                    this.registerAliases(key, 
+                    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+                    declaration.useClass);
+                }
+                else if (isTokenProvider(declaration)) {
+                    this.container.register(key, declaration, {
+                        lifecycle: Lifecycle.Singleton,
+                    });
+                }
+                else {
+                    // Can never be reached
+                    throw new Error("Above if-statement is exhaustive");
+                }
+            }
+            else {
+                log.debug(`Dependency ${key} already registered, skipping`);
+            }
+        });
+    }
+    /**
+     * Handle module resolution, e.g. by decorating resolved modules
+     * @param moduleName
+     */
+    onAfterModuleResolution(moduleName) {
+        this.container.afterResolution(moduleName, (containedModuleName, containedModule) => {
+            // special case where tsyringe may return multiple known instances (?)
+            if (Array.isArray(containedModule)) {
+                throw errors.unableToDecorateModule(containedModuleName);
+            }
+            this.decorateModule(moduleName, containedModule);
+            containedModule.create(() => {
+                const container = this.container.createChildContainer();
+                container.reset();
+                return container;
+            });
+            if (this.isDependencyFactory(containedModule)) {
+                this.useDependencyFactory(containedModule);
+            }
+        }, { frequency: ModuleContainer.moduleDecorationFrequency });
+    }
+    /**
+     * This is a placeholder for individual modules to override.
+     * This method will be called whenever the underlying container fully
+     * initialized
+     */
+    create(childContainerProvider) {
+        this.providedContainer = childContainerProvider();
+        this.registerValue({
+            ChildContainerProvider: () => this.container.createChildContainer(),
+        });
+        // register all provided modules when the container is created
+        this.registerModules(this.definition.modules);
+    }
+}
+/**
+ * Determines how often are modules decorated upon resolution
+ * from the tsyringe DI container
+ */
+ModuleContainer.moduleDecorationFrequency = "Once";
+//# sourceMappingURL=ModuleContainer.js.map

package/dist/config/ModuleContainer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModuleContainer.js","sourceRoot":"","sources":["../../src/config/ModuleContainer.ts"],"names":[],"mappings":"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"}

package/dist/config/injectAlias.d.ts

@@ -0,0 +1,18 @@
+import { TypedClass } from "../types";
+export declare const injectAliasMetadataKey = "protokit-inject-alias";
+/**
+ * Attaches metadata to the class that the ModuleContainer can pick up
+ * and inject this class in the DI container under the specified aliases.
+ * This method supports inheritance, therefore also gets aliases defined
+ * on superclasses
+ */
+export declare function injectAlias(aliases: string[]): (target: TypedClass<unknown>) => void;
+/**
+ * Marks the class to implement a certain interface T, while also attaching
+ * a DI-injection alias as metadata, that will be picked up by the ModuleContainer
+ * to allow resolving by that interface name
+ * @param name The name of the injection alias, convention is to use the same as the name of T
+ */
+export declare function implement<T>(name: string): (target: TypedClass<T>) => void;
+export declare function getInjectAliases(target: TypedClass<unknown>): string[];
+//# sourceMappingURL=injectAlias.d.ts.map

package/dist/config/injectAlias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectAlias.d.ts","sourceRoot":"","sources":["../../src/config/injectAlias.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtC,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,YAC3B,WAAW,OAAO,CAAC,UA+BpC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,YAM7B,WAAW,CAAC,CAAC,UAIxB;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,GAAG,MAAM,EAAE,CAOtE"}

package/dist/config/injectAlias.js

@@ -0,0 +1,47 @@
+export const injectAliasMetadataKey = "protokit-inject-alias";
+/**
+ * Attaches metadata to the class that the ModuleContainer can pick up
+ * and inject this class in the DI container under the specified aliases.
+ * This method supports inheritance, therefore also gets aliases defined
+ * on superclasses
+ */
+export function injectAlias(aliases) {
+    return (target) => {
+        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+        const superAliases = Reflect.getMetadata(injectAliasMetadataKey, 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        Object.getPrototypeOf(target));
+        // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+        const existingAliases = Reflect.getMetadata(injectAliasMetadataKey, target);
+        let allAliases = aliases;
+        if (superAliases !== undefined) {
+            allAliases = allAliases.concat(superAliases);
+        }
+        if (existingAliases !== undefined) {
+            allAliases = allAliases.concat(existingAliases);
+        }
+        Reflect.defineMetadata(injectAliasMetadataKey, allAliases.filter((value, index, array) => array.indexOf(value) === index), target);
+    };
+}
+/**
+ * Marks the class to implement a certain interface T, while also attaching
+ * a DI-injection alias as metadata, that will be picked up by the ModuleContainer
+ * to allow resolving by that interface name
+ * @param name The name of the injection alias, convention is to use the same as the name of T
+ */
+export function implement(name) {
+    return (
+    /**
+     * Check if the target class extends RuntimeModule, while
+     * also providing static config presets
+     */
+    target) => {
+        injectAlias([name])(target);
+    };
+}
+export function getInjectAliases(target) {
+    // eslint-disable-next-line @typescript-eslint/consistent-type-assertions
+    const aliases = Reflect.getMetadata(injectAliasMetadataKey, target);
+    return aliases ?? [];
+}
+//# sourceMappingURL=injectAlias.js.map

package/dist/config/injectAlias.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectAlias.js","sourceRoot":"","sources":["../../src/config/injectAlias.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,OAAiB;IAC3C,OAAO,CAAC,MAA2B,EAAE,EAAE;QACrC,yEAAyE;QACzE,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,CACtC,sBAAsB;QACtB,iEAAiE;QACjE,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CACN,CAAC;QAE1B,yEAAyE;QACzE,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CACzC,sBAAsB,EACtB,MAAM,CACiB,CAAC;QAE1B,IAAI,UAAU,GAAG,OAAO,CAAC;QAEzB,IAAI,YAAY,KAAK,SAAS,EAAE;YAC9B,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;SAC9C;QACD,IAAI,eAAe,KAAK,SAAS,EAAE;YACjC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;SACjD;QAED,OAAO,CAAC,cAAc,CACpB,sBAAsB,EACtB,UAAU,CAAC,MAAM,CACf,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,KAAK,CACxD,EACD,MAAM,CACP,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAI,IAAY;IACvC,OAAO;IACL;;;OAGG;IACH,MAAqB,EACrB,EAAE;QACF,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IAC1D,yEAAyE;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CACjC,sBAAsB,EACtB,MAAM,CACK,CAAC;IACd,OAAO,OAAO,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/dist/dependencyFactory/DependencyFactory.d.ts

@@ -0,0 +1,29 @@
+import { ClassProvider, FactoryProvider, TokenProvider, ValueProvider } from "tsyringe";
+import { TypedClass } from "../types";
+import type { BaseModuleInstanceType } from "../config/ModuleContainer";
+export type DependencyDeclaration<Dependency> = ClassProvider<Dependency> | FactoryProvider<Dependency> | TokenProvider<Dependency> | ValueProvider<Dependency>;
+export type DependencyRecord = Record<string, DependencyDeclaration<unknown> & {
+    forceOverwrite?: boolean;
+}>;
+/**
+ * This is an abstract class for creating DependencyFactories, a pattern
+ * to bundle multiple smaller services into one and register them into the
+ * injection context.
+ *
+ * This can for example be a StorageDependencyFactory that creates dependencies
+ * like StateService, MerkleWitnessService, etc. So in general, services that
+ * are not ConfigurableModules, but still are their own logical unit.
+ *
+ * DependencyFactories are designed to only be used statically for sets of
+ * deps that are necessary for the sequencer to work.
+ */
+export interface DependencyFactory {
+    dependencies: () => DependencyRecord;
+}
+export type TypeFromDependencyDeclaration<Declaration extends DependencyDeclaration<unknown>> = Declaration extends DependencyDeclaration<infer Dependency> ? Dependency : never;
+export type CapitalizeAny<Key extends string | number | symbol> = Key extends string ? Capitalize<Key> : Key;
+export type MapDependencyRecordToTypes<Record extends DependencyRecord> = {
+    [Key in keyof Record as CapitalizeAny<Key>]: TypedClass<TypeFromDependencyDeclaration<Record[Key]>>;
+};
+export type InferDependencies<Class extends BaseModuleInstanceType> = Class extends DependencyFactory ? MapDependencyRecordToTypes<ReturnType<Class["dependencies"]>> : never;
+//# sourceMappingURL=DependencyFactory.d.ts.map

package/dist/dependencyFactory/DependencyFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyFactory.d.ts","sourceRoot":"","sources":["../../src/dependencyFactory/DependencyFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,eAAe,EACf,aAAa,EACb,aAAa,EACd,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE,MAAM,MAAM,qBAAqB,CAAC,UAAU,IACxC,aAAa,CAAC,UAAU,CAAC,GACzB,eAAe,CAAC,UAAU,CAAC,GAC3B,aAAa,CAAC,UAAU,CAAC,GACzB,aAAa,CAAC,UAAU,CAAC,CAAC;AAE9B,MAAM,MAAM,gBAAgB,GAAG,MAAM,CACnC,MAAM,EACN,qBAAqB,CAAC,OAAO,CAAC,GAAG;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,CAC9D,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,gBAAgB,CAAC;CACtC;AAED,MAAM,MAAM,6BAA6B,CACvC,WAAW,SAAS,qBAAqB,CAAC,OAAO,CAAC,IAElD,WAAW,SAAS,qBAAqB,CAAC,MAAM,UAAU,CAAC,GACvD,UAAU,GACV,KAAK,CAAC;AAEZ,MAAM,MAAM,aAAa,CAAC,GAAG,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,IAC5D,GAAG,SAAS,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;AAE7C,MAAM,MAAM,0BAA0B,CAAC,MAAM,SAAS,gBAAgB,IAAI;KACvE,GAAG,IAAI,MAAM,MAAM,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,UAAU,CACrD,6BAA6B,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAC3C;CACF,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,sBAAsB,IAChE,KAAK,SAAS,iBAAiB,GAC3B,0BAA0B,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,GAC7D,KAAK,CAAC"}

package/dist/dependencyFactory/DependencyFactory.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=DependencyFactory.js.map

package/dist/dependencyFactory/DependencyFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DependencyFactory.js","sourceRoot":"","sources":["../../src/dependencyFactory/DependencyFactory.ts"],"names":[],"mappings":""}

package/dist/dependencyFactory/injectOptional.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This function injects a dependency only if it has been registered, otherwise
+ * injects undefined. This can be useful for having optional dependencies, where
+ * tsyringe would normally error out and not be able to resolve. With this
+ * decorator, we can now do this.
+ *
+ * The strategy we employ here is that we inject a dummy into the global
+ * container that is of type UndefinedDisguise. We can't inject undefined
+ * directly, therefore we use this object to disguise itself as undefined.
+ * Then a child container registers something under the same token, it by
+ * default resolves that new dependency. If that doesn't happen, the
+ * resolution hits our disguise, which we then convert into undefined
+ * using the Transform
+ */
+export declare function injectOptional<T>(token: string): (target: any, propertyKey: string | symbol | undefined, parameterIndex: number) => any;
+//# sourceMappingURL=injectOptional.d.ts.map

package/dist/dependencyFactory/injectOptional.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectOptional.d.ts","sourceRoot":"","sources":["../../src/dependencyFactory/injectOptional.ts"],"names":[],"mappings":"AAuBA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,0FAG9C"}

package/dist/dependencyFactory/injectOptional.js

@@ -0,0 +1,40 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { container, injectable, injectWithTransform, Lifecycle, scoped, } from "tsyringe";
+let UndefinedDisguise = class UndefinedDisguise {
+};
+UndefinedDisguise = __decorate([
+    injectable(),
+    scoped(Lifecycle.ResolutionScoped)
+], UndefinedDisguise);
+class UndefinedTransform {
+    transform(incoming) {
+        if (incoming instanceof UndefinedDisguise) {
+            return undefined;
+        }
+        return incoming;
+    }
+}
+/**
+ * This function injects a dependency only if it has been registered, otherwise
+ * injects undefined. This can be useful for having optional dependencies, where
+ * tsyringe would normally error out and not be able to resolve. With this
+ * decorator, we can now do this.
+ *
+ * The strategy we employ here is that we inject a dummy into the global
+ * container that is of type UndefinedDisguise. We can't inject undefined
+ * directly, therefore we use this object to disguise itself as undefined.
+ * Then a child container registers something under the same token, it by
+ * default resolves that new dependency. If that doesn't happen, the
+ * resolution hits our disguise, which we then convert into undefined
+ * using the Transform
+ */
+export function injectOptional(token) {
+    container.register(token, { useClass: UndefinedDisguise });
+    return injectWithTransform(token, (UndefinedTransform));
+}
+//# sourceMappingURL=injectOptional.js.map