@proto-kit/common 0.1.1-develop.211 → 0.1.1-develop.2137

package/dist/config/ModuleContainer.d.ts

@@ -1,42 +1,65 @@
 import "reflect-metadata";
-import { InjectionToken } from "tsyringe";
-import { StringKeyOf, TypedClass } from "../types";
-import { DependencyFactory } from "../dependencyFactory/DependencyFactory";
-import { Configurable, ConfigurableModule } from "./ConfigurableModule";
+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 type BaseModuleType = TypedClass<Configurable<unknown>>;
+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 : never;
+    [ConfigKey in StringKeyOf<Modules>]: InstanceType<Modules[ConfigKey]> extends Configurable<infer Config> ? Config extends NoConfig ? Config | undefined : Config : never;
 };
 /**
- * Parameters required when creating a module container instance
+ * 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 interface ModuleContainerDefinition<Modules extends ModulesRecord> {
-    modules: Modules;
-    config?: ModulesConfig<Modules>;
+export type RecursivePartial<T> = {
+    [Key in keyof T]?: Partial<T[Key]>;
+};
+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;
+export interface ModuleContainerLike {
+    get dependencyContainer(): DependencyContainer;
+    resolveOrFail<ModuleType>(moduleName: string, moduleType: TypedClass<ModuleType>): ModuleType;
 }
 /**
  * Reusable module container facilitating registration, resolution
  * configuration, decoration and validation of modules
  */
-export declare class ModuleContainer<Modules extends ModulesRecord> extends ConfigurableModule<unknown> {
-    definition: ModuleContainerDefinition<Modules>;
+export declare class ModuleContainer<Modules extends ModulesRecord> extends ConfigurableModule<ModulesConfig<Modules>> implements ModuleContainerLike {
+    definition: Modules;
     /**
      * Determines how often are modules decorated upon resolution
      * from the tsyringe DI container
      */
     private static readonly moduleDecorationFrequency;
-    protected readonly container: import("tsyringe").DependencyContainer;
-    constructor(definition: ModuleContainerDefinition<Modules>);
+    private providedContainer?;
+    private eventEmitterProxy;
+    constructor(definition: Modules);
     /**
      * @returns list of module names
      */
@@ -49,13 +72,16 @@ export declare class ModuleContainer<Modules extends ModulesRecord> extends Conf
      * @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(modules: Modules, moduleName: string): asserts moduleName is StringKeyOf<Modules>;
-    isValidModuleName(modules: Modules, moduleName: number | string | symbol): asserts moduleName is StringKeyOf<Modules>;
+    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
@@ -64,11 +90,7 @@ export declare class ModuleContainer<Modules extends ModulesRecord> extends Conf
      * @param modules
      */
     protected registerModules(modules: Modules): void;
-    /**
-     * Inject a set of dependencies using the given list of DependencyFactories
-     * This method should be called during startup
-     */
-    protected registerDependencyFactories(factories: TypedClass<DependencyFactory>[]): void;
+    get events(): EventEmitterProxy<Modules>;
     /**
      * Register a non-module value into the current container
      * @param modules
@@ -83,6 +105,9 @@ export declare class ModuleContainer<Modules extends ModulesRecord> extends Conf
      * @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
      *
@@ -93,17 +118,39 @@ export declare class ModuleContainer<Modules extends ModulesRecord> extends Conf
      * @param moduleName
      * @returns
      */
-    resolve<ResolvableModuleName extends StringKeyOf<Modules>>(moduleName: ResolvableModuleName): InstanceType<Modules[ResolvableModuleName]>;
-    resolveOrFail<ModuleType>(moduleName: string, moduleType: TypedClass<ModuleType>): ModuleType;
+    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;
+    get dependencyContainer(): DependencyContainer;
 }
 //# sourceMappingURL=ModuleContainer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ModuleContainer.d.ts","sourceRoot":"","sources":["../../src/config/ModuleContainer.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAwB,cAAc,EAAa,MAAM,UAAU,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AA+BxE,eAAO,MAAM,qBAAqB;0CA5BM,MAAM;uCAKT,YAAY,OAAO,CAAC;yCAOlB,eAAe,OAAO,CAAC;6CAInB,MAAM;2CAIR,MAAM,QAAQ,MAAM;CAQlB,CAAC;AAG5C,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;AAG/D,MAAM,WAAW,aAAa,CAE5B,UAAU,SAAS,cAAc,GAAG,cAAc;IAElD,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC;CAC5B;AAGD,MAAM,MAAM,aAAa,CAAC,OAAO,SAAS,aAAa,IAAI;KAExD,SAAS,IAAI,WAAW,CAAC,OAAO,CAAC,GAAG,YAAY,CAC/C,OAAO,CAAC,SAAS,CAAC,CACnB,SAAS,YAAY,CAAC,MAAM,MAAM,CAAC,GAChC,MAAM,GACN,KAAK;CACV,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,OAAO,SAAS,aAAa;IACtE,OAAO,EAAE,OAAO,CAAC;IAEjB,MAAM,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,qBAAa,eAAe,CAC1B,OAAO,SAAS,aAAa,CAC7B,SAAQ,kBAAkB,CAAC,OAAO,CAAC;IAUT,UAAU,EAAE,yBAAyB,CAAC,OAAO,CAAC;IATxE;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,yBAAyB,CAAqB;IAGtE,SAAS,CAAC,QAAQ,CAAC,SAAS,yCAAoC;gBAEtC,UAAU,EAAE,yBAAyB,CAAC,OAAO,CAAC;IAMxE;;OAEG;IACH,IAAW,WAAW,aAErB;IAED;;;;;;OAMG;IACH,SAAS,CAAC,cAAc,CACtB,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,eAAe,EAAE,kBAAkB,CAAC,OAAO,CAAC,GAC3C,IAAI;IAmBP;;;;OAIG;IACI,uBAAuB,CAC5B,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC;IAItC,iBAAiB,CACtB,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GACnC,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC;IAM7C;;;;;;OAMG;IACH,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,OAAO;IAiB1C;;;OAGG;IACH,SAAS,CAAC,2BAA2B,CACnC,SAAS,EAAE,UAAU,CAAC,iBAAiB,CAAC,EAAE;IAO5C;;;OAGG;IAGI,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC;IAM1D;;;;;;;OAOG;IACI,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC;IAI/C;;;;;;;;;OASG;IACI,OAAO,CAAC,oBAAoB,SAAS,WAAW,CAAC,OAAO,CAAC,EAC9D,UAAU,EAAE,oBAAoB,GAC/B,YAAY,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAMvC,aAAa,CAAC,UAAU,EAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC;IAYpC;;;OAGG;IACH,SAAS,CAAC,cAAc,CACtB,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,EAChC,eAAe,EAAE,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IAY9D;;;OAGG;IACH,SAAS,CAAC,uBAAuB,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC;CAanE"}
+{"version":3,"file":"ModuleContainer.d.ts","sourceRoot":"","sources":["../../src/config/ModuleContainer.ts"],"names":[],"mappings":"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"}

package/dist/config/ModuleContainer.js

@@ -1,12 +1,14 @@
 import "reflect-metadata";
-import { container, Lifecycle } from "tsyringe";
+import { instanceCachingFactory, isClassProvider, isFactoryProvider, isTokenProvider, isValueProvider, Lifecycle, } from "tsyringe";
 import log from "loglevel";
-import { ConfigurableModule } from "./ConfigurableModule";
+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 max-len
-    // eslint-disable-next-line @typescript-eslint/no-base-to-string,@typescript-eslint/restrict-template-expressions
+    // 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
@@ -16,6 +18,8 @@ const errors = {
     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;
 /**
@@ -27,15 +31,14 @@ export class ModuleContainer extends ConfigurableModule {
         super();
         this.definition = definition;
         // DI container holding all the registered modules
-        this.container = container.createChildContainer();
-        // register all provided modules when the container is created
-        this.registerModules(definition.modules);
+        this.providedContainer = undefined;
+        this.eventEmitterProxy = undefined;
     }
     /**
      * @returns list of module names
      */
     get moduleNames() {
-        return Object.keys(this.definition.modules);
+        return Object.keys(this.definition);
     }
     /**
      * Check if the provided module satisfies the container requirements,
@@ -57,19 +60,34 @@ export class ModuleContainer extends ConfigurableModule {
             }
         });
     }
+    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(modules, moduleName) {
-        this.isValidModuleName(modules, moduleName);
+    assertIsValidModuleName(moduleName) {
+        if (!this.isValidModuleName(this.definition, moduleName)) {
+            throw errors.onlyValidModuleNames(moduleName);
+        }
     }
     isValidModuleName(modules, moduleName) {
-        if (!Object.prototype.hasOwnProperty.call(modules, moduleName)) {
-            throw errors.onlyValidModuleNames(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
@@ -78,29 +96,30 @@ export class ModuleContainer extends ConfigurableModule {
      * @param modules
      */
     registerModules(modules) {
-        for (const moduleName in modules) {
+        Object.keys(modules).forEach((moduleName) => {
             if (Object.prototype.hasOwnProperty.call(modules, moduleName)) {
-                this.assertIsValidModuleName(modules, moduleName);
+                this.assertIsValidModuleName(moduleName);
                 log.debug(`Registering module: ${moduleName}`);
-                this.container.register(moduleName, { useClass: modules[moduleName] }, { lifecycle: Lifecycle.ContainerScoped });
+                const useClass = modules[moduleName];
+                this.container.register(moduleName, { useClass }, { lifecycle: Lifecycle.ContainerScoped });
                 this.onAfterModuleResolution(moduleName);
+                this.registerAliases(moduleName, useClass);
+                if (this.isDependencyFactory(useClass)) {
+                    this.useDependencyFactory(useClass);
+                }
             }
-        }
-    }
-    /**
-     * Inject a set of dependencies using the given list of DependencyFactories
-     * This method should be called during startup
-     */
-    registerDependencyFactories(factories) {
-        factories.forEach((factory) => {
-            this.container.resolve(factory).initDependencies(this.container);
         });
     }
+    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
      */
-    // eslint-disable-next-line no-warning-comments
     // TODO Rename to plural since object is param
     registerValue(modules) {
         Object.entries(modules).forEach(([moduleName, useValue]) => {
@@ -116,7 +135,16 @@ export class ModuleContainer extends ConfigurableModule {
      * @param config
      */
     configure(config) {
-        this.definition.config = 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
@@ -132,10 +160,15 @@ export class ModuleContainer extends ConfigurableModule {
         return this.container.resolve(moduleName);
     }
     resolveOrFail(moduleName, moduleType) {
+        if (!this.container.isRegistered(moduleName)) {
+            throw new Error(`Dependency with token ${moduleName} not registered`);
+        }
         const instance = this.container.resolve(moduleName);
-        const isValidModuleInstance = instance instanceof moduleType;
-        if (!isValidModuleInstance) {
-            throw new Error("Incompatible module instance");
+        if (moduleType !== undefined) {
+            const isValidModuleInstance = instance instanceof moduleType;
+            if (!isValidModuleInstance) {
+                throw errors.validModuleInstance(moduleName, moduleType.name);
+            }
         }
         return instance;
     }
@@ -144,12 +177,86 @@ export class ModuleContainer extends ConfigurableModule {
      * features or module checks
      */
     decorateModule(moduleName, containedModule) {
-        const config = this.definition.config?.[moduleName];
+        const config = super.config?.[moduleName];
         // eslint-disable-next-line @typescript-eslint/strict-boolean-expressions
         if (!config) {
             throw errors.configNotSetInContainer(moduleName.toString());
         }
-        containedModule.config = config;
+        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();
+        // eslint-disable-next-line sonarjs/cognitive-complexity
+        Object.entries(dependencies).forEach(([rawKey, declaration]) => {
+            const key = rawKey.charAt(0).toUpperCase() + rawKey.slice(1);
+            if (!this.container.isRegistered(key) ||
+                declaration.forceOverwrite === true) {
+                if (this.container.isRegistered(key) &&
+                    (declaration?.forceOverwrite ?? false)) {
+                    log.warn(`You are trying to overwrite dependency ${key}, which is already registered. This is currently not supported. Try to define your dependency earlier.`);
+                }
+                // 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);
+                    // Register static dependencies
+                    if (this.isDependencyFactory(declaration.useClass)) {
+                        this.useDependencyFactory(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
@@ -162,11 +269,37 @@ export class ModuleContainer extends ConfigurableModule {
                 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);
+        this.container.register("ParentContainer", { useValue: this });
+    }
+    get dependencyContainer() {
+        return this.container;
+    }
 }
 /**
  * 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":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAIL,sBAAsB,EACtB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,SAAS,GACV,MAAM,UAAU,CAAC;AAClB,OAAO,GAAG,MAAM,UAAU,CAAC;AAC3B,OAAO,KAAK,MAAM,cAAc,CAAC;AAOjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,OAAO,EAEL,kBAAkB,GAEnB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,MAAM,MAAM,GAAG;IACb,uBAAuB,EAAE,CAAC,UAAkB,EAAE,EAAE,CAC9C,IAAI,KAAK,CACP,2BAA2B,UAAU,kDAAkD,CACxF;IAEH,oBAAoB,EAAE,CAAC,UAAgC,EAAE,EAAE,CACzD,IAAI,KAAK;IACP,gEAAgE;IAChE,mEAAmE,UAAU,EAAE,CAChF;IAEH,sBAAsB,EAAE,CAAC,UAAmC,EAAE,EAAE;IAC9D,gEAAgE;IAChE,IAAI,KAAK,CAAC,6BAA6B,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;IAEjE,mBAAmB,EAAE,CAAC,iBAAyB,EAAE,EAAE,CACjD,IAAI,KAAK,CAAC;+BACiB,iBAAiB,gDAAgD,CAAC;IAE/F,iBAAiB,EAAE,CAAC,iBAAyB,EAAE,IAAY,EAAE,EAAE,CAC7D,IAAI,KAAK,CACP,8BAA8B,iBAAiB;;4CAET,IAAI,EAAE,CAC7C;IAEH,yBAAyB,EAAE,CAAC,SAAiB,EAAE,EAAE,CAC/C,IAAI,KAAK,CACP,sHAAsH,SAAS,GAAG,CACnI;IAEH,mBAAmB,EAAE,CAAC,UAAkB,EAAE,cAAsB,EAAE,EAAE,CAClE,IAAI,KAAK,CACP,kCAAkC,UAAU,oBAAoB,cAAc,GAAG,CAClF;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,MAAM,CAAC;AAmE5C;;;GAGG;AACH,MAAM,OAAO,eACX,SAAQ,kBAA0C;IAclD,YAA0B,UAAmB;QAC3C,KAAK,EAAE,CAAC;QADgB,eAAU,GAAV,UAAU,CAAS;QAL7C,kDAAkD;QAC1C,sBAAiB,GAAyB,SAAS,CAAC;QAEpD,sBAAiB,GAA2C,SAAS,CAAC;IAI9E,CAAC;IAED;;OAEG;IACH,IAAW,WAAW;QACpB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;OAMG;IACO,cAAc,CACtB,UAAgC,EAChC,eAA4C;QAE5C,mEAAmE;QACnE,MAAM,YAAY,GAChB,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC;QAE5D,YAAY,EAAE,OAAO,CAAC,CAAC,UAAsC,EAAE,EAAE;YAC/D,MAAM,IAAI,GACR,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;YAEhE,IAAI,IAAI,KAAK,SAAS,EAAE;gBACtB,MAAM,MAAM,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;aAC9C;YAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE;gBACpC,MAAM,MAAM,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;aAClD;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAc,SAAS;QACrB,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;;;OAIG;IACI,uBAAuB,CAC5B,UAAkB;QAElB,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE;YACxD,MAAM,MAAM,CAAC,oBAAoB,CAAC,UAAU,CAAC,CAAC;SAC/C;IACH,CAAC;IAEM,iBAAiB,CACtB,OAAgB,EAChB,UAAoC;QAEpC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IACnE,CAAC;IAEM,0BAA0B,CAC/B,SAA0C;QAE1C,IAAI,SAAS,KAAK,SAAS,EAAE;YAC3B,MAAM,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;SAC/D;IACH,CAAC;IAES,eAAe,CAAC,aAAqB,EAAE,IAAqB;QACpE,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAEvC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACxB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE;YAC7B,QAAQ,EAAE,aAAa;SACxB,CAAC,CACH,CAAC;IACJ,CAAC;IAED;;;;;;OAMG;IACO,eAAe,CAAC,OAAgB;QACxC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE;YAC1C,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE;gBAC7D,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;gBAEzC,GAAG,CAAC,KAAK,CAAC,uBAAuB,UAAU,EAAE,CAAC,CAAC;gBAE/C,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;gBAErC,IAAI,CAAC,SAAS,CAAC,QAAQ,CACrB,UAAU,EACV,EAAE,QAAQ,EAAE,EACZ,EAAE,SAAS,EAAE,SAAS,CAAC,eAAe,EAAE,CACzC,CAAC;gBACF,IAAI,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;gBAEzC,IAAI,CAAC,eAAe,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAE3C,IAAI,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE;oBACtC,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;iBACrC;aACF;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,IAAW,MAAM;QACf,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,EAAE;YACxC,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAU,IAAI,CAAC,CAAC;SAC/D;QACD,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,8CAA8C;IACvC,aAAa,CAAQ,OAA8B;QACxD,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE;YACzD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACI,SAAS,CAAC,MAA8B;QAC7C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,gBAAgB,CAAC,MAAgD;QACtE,IAAI,CAAC,MAAM,GAAG,KAAK,CAGjB,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED,IAAW,MAAM;QACf,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,IAAW,MAAM,CAAC,MAA8B;QAC9C,KAAK,CAAC,MAAM,GAAG,KAAK,CAGlB,IAAI,CAAC,aAAa,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;OASG;IACI,OAAO,CACZ,UAAmB;QAEnB,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAE3B,UAAU,CAAC,CAAC;IAChB,CAAC;IAEM,aAAa,CAClB,UAAkB,EAClB,UAAmC;QAEnC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE;YAC5C,MAAM,IAAI,KAAK,CAAC,yBAAyB,UAAU,iBAAiB,CAAC,CAAC;SACvE;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAa,UAAU,CAAC,CAAC;QAEhE,IAAI,UAAU,KAAK,SAAS,EAAE;YAC5B,MAAM,qBAAqB,GAAG,QAAQ,YAAY,UAAU,CAAC;YAE7D,IAAI,CAAC,qBAAqB,EAAE;gBAC1B,MAAM,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;aAC/D;SACF;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;OAGG;IACO,cAAc,CACtB,UAAgC,EAChC,eAA4D;QAE5D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,CAAC;QAC1C,yEAAyE;QACzE,IAAI,CAAC,MAAM,EAAE;YACX,MAAM,MAAM,CAAC,uBAAuB,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;SAC7D;QAED,IAAI,eAAe,YAAY,eAAe,EAAE;YAC9C,eAAe,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;SACnC;aAAM;YACL,eAAe,CAAC,MAAM,GAAG,MAAM,CAAC;SACjC;IACH,CAAC;IAEO,mBAAmB,CAAC,IAAS;QACnC,OAAO,cAAc,IAAI,IAAI,CAAC;IAChC,CAAC;IAED;;;OAGG;IACO,6BAA6B,CAAC,SAAiC;QACvE,SAAS,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YAChC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QAC5B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACO,oBAAoB,CAAC,OAA0B;QACvD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;QAE5C,wDAAwD;QACxD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,EAAE;YAC7D,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAE7D,IACE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC;gBACjC,WAAW,CAAC,cAAc,KAAK,IAAI,EACnC;gBACA,IACE,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,GAAG,CAAC;oBAChC,CAAC,WAAW,EAAE,cAAc,IAAI,KAAK,CAAC,EACtC;oBACA,GAAG,CAAC,IAAI,CACN,0CAA0C,GAAG,wGAAwG,CACtJ,CAAC;iBACH;gBAED,0DAA0D;gBAC1D,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE;oBAChC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;iBAC3C;qBAAM,IAAI,iBAAiB,CAAC,WAAW,CAAC,EAAE;oBACzC,gDAAgD;oBAChD,kDAAkD;oBAClD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE;wBAC3B,UAAU,EAAE,sBAAsB,CAAC,WAAW,CAAC,UAAU,CAAC;qBAC3D,CAAC,CAAC;iBACJ;qBAAM,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE;oBACvC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE;wBACxC,SAAS,EAAE,SAAS,CAAC,SAAS;qBAC/B,CAAC,CAAC;oBACH,IAAI,CAAC,eAAe,CAClB,GAAG;oBACH,yEAAyE;oBACzE,WAAW,CAAC,QAA+B,CAC5C,CAAC;oBAEF,+BAA+B;oBAC/B,IAAI,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE;wBAClD,IAAI,CAAC,oBAAoB,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;qBACjD;iBACF;qBAAM,IAAI,eAAe,CAAC,WAAW,CAAC,EAAE;oBACvC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,WAAW,EAAE;wBACxC,SAAS,EAAE,SAAS,CAAC,SAAS;qBAC/B,CAAC,CAAC;iBACJ;qBAAM;oBACL,uBAAuB;oBACvB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;iBACrD;aACF;iBAAM;gBACL,GAAG,CAAC,KAAK,CAAC,cAAc,GAAG,+BAA+B,CAAC,CAAC;aAC7D;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACO,uBAAuB,CAAC,UAAgC;QAChE,IAAI,CAAC,SAAS,CAAC,eAAe,CAC5B,UAAU,EACV,CAAC,mBAAmB,EAAE,eAAe,EAAE,EAAE;YACvC,sEAAsE;YACtE,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE;gBAClC,MAAM,MAAM,CAAC,sBAAsB,CAAC,mBAAmB,CAAC,CAAC;aAC1D;YACD,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;YACjD,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE;gBAC1B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE,CAAC;gBACxD,SAAS,CAAC,KAAK,EAAE,CAAC;gBAClB,OAAO,SAAS,CAAC;YACnB,CAAC,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE;gBAC7C,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;aAC5C;QACH,CAAC,EACD,EAAE,SAAS,EAAE,eAAe,CAAC,yBAAyB,EAAE,CACzD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,sBAA8C;QAC1D,IAAI,CAAC,iBAAiB,GAAG,sBAAsB,EAAE,CAAC;QAElD,IAAI,CAAC,aAAa,CAAC;YACjB,sBAAsB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,oBAAoB,EAAE;SACpE,CAAC,CAAC;QAEH,8DAA8D;QAC9D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,IAAW,mBAAmB;QAC5B,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;;AAvWD;;;GAGG;AACqB,yCAAyB,GAAc,MAAM,AAApB,CAAqB"}

package/dist/config/Startable.d.ts

@@ -0,0 +1,4 @@
+export interface Startable {
+    start(): Promise<void>;
+}
+//# sourceMappingURL=Startable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Startable.d.ts","sourceRoot":"","sources":["../../src/config/Startable.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/config/Startable.js

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

package/dist/config/Startable.js.map

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

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

@@ -1,5 +1,10 @@
-import { DependencyContainer } from "tsyringe";
+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
@@ -11,14 +16,14 @@ import { TypedClass } from "../types";
  *
  * DependencyFactories are designed to only be used statically for sets of
  * deps that are necessary for the sequencer to work.
- *
- * Every Factory need the @dependencyFactory annotation (which basically
- * proxies @injectable()) and every method that returns a dependency has to be
- * of the format `() => Dependency` and be annotated with @dependency.
  */
-export declare abstract class DependencyFactory {
-    initDependencies(container: DependencyContainer): void;
+export interface DependencyFactory {
+    dependencies: () => DependencyRecord;
 }
-export declare function dependency(): <Target extends DependencyFactory, Dependency>(target: Target, key: string, descriptor: TypedPropertyDescriptor<() => Dependency>) => TypedPropertyDescriptor<() => Dependency>;
-export declare function dependencyFactory(): <Target extends DependencyFactory>(target: TypedClass<Target>) => void;
+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

@@ -1 +1 @@
-{"version":3,"file":"DependencyFactory.d.ts","sourceRoot":"","sources":["../../src/dependencyFactory/DependencyFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAyB,MAAM,UAAU,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAoBtC;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,iBAAiB;IAC9B,gBAAgB,CAAC,SAAS,EAAE,mBAAmB;CAqBvD;AAuCD,wBAAgB,UAAU,wEAGjB,MAAM,sGAqBd;AAED,wBAAgB,iBAAiB,2EAMhC"}
+{"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"}