@proto-kit/common 0.1.1-develop.190 → 0.1.1-develop.2024

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":"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"}

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"}

package/dist/dependencyFactory/DependencyFactory.js

@@ -1,96 +1,2 @@
-import { injectable, Lifecycle } from "tsyringe";
-const errors = {
-    descriptorUndefined: () => new Error("Descriptor of that dependency is undefined!"),
-    dependencyFactoryCalledDirectly: () => new Error("You cannot access the depdendency method directly, use container.resolve"),
-};
-const globalFactoryDependencies = new Map();
-/**
- * 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.
- *
- * 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 class DependencyFactory {
-    initDependencies(container) {
-        const dependencies = globalFactoryDependencies.get(this.constructor.name) ?? {};
-        globalFactoryDependencies.delete(this.constructor.name);
-        for (const [key, useFactory] of Object.entries(dependencies)) {
-            container.register(`${key}_singleton-prototype`, {
-                useFactory: useFactory.bind(this),
-            });
-            const upperCaseKey = key.charAt(0).toUpperCase() + key.slice(1);
-            container.register(upperCaseKey, {
-                useToken: `${key}_singleton-prototype`,
-            }, { lifecycle: Lifecycle.ContainerScoped });
-        }
-    }
-}
-// type DTypes = { [key: string]: TypedClass<unknown> }
-// type Factories<T extends DTypes> = {
-//   [key in keyof T]: T[key] extends TypedClass<infer R> ? () => R : never
-// }
-//
-// export abstract class DF2<Types extends DTypes> {
-//   public constructor(private factories: Factories<Types>) {
-//
-//   }
-//   generateDependencies(): Types {
-//     let x = this.factories;
-//     return {} as Types;
-//   }
-// }
-// export function DF2C<T extends Types>(object: Factories<T>): T {
-//   const c = class C extends DF2<T>{
-//     generateDependencies(): T {
-//       return undefined;
-//     }
-//   }
-//   return new c();
-// }
-// class DF2I extends DF2<{x: typeof ConfigurableModule}> {
-//   constructor() {
-//     super({
-//       x: this.x
-//     });
-//   }
-//
-//   x(): ConfigurableModule<any> {
-//     return {} as ConfigurableModule<any>;
-//   }
-//
-// }
-export function dependency() {
-    return function decorator(target, key, descriptor) {
-        if (descriptor.value !== undefined) {
-            const className = target.constructor.name;
-            if (!globalFactoryDependencies.has(className)) {
-                globalFactoryDependencies.set(className, {});
-            }
-            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
-            globalFactoryDependencies.get(target.constructor.name)[key] =
-                descriptor.value;
-            descriptor.value = () => {
-                throw errors.dependencyFactoryCalledDirectly();
-            };
-        }
-        else {
-            throw errors.descriptorUndefined();
-        }
-        return descriptor;
-    };
-}
-export function dependencyFactory() {
-    return function decorator(target) {
-        injectable()(target);
-    };
-}
+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

package/dist/dependencyFactory/injectOptional.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injectOptional.js","sourceRoot":"","sources":["../../src/dependencyFactory/injectOptional.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EACL,SAAS,EACT,UAAU,EACV,mBAAmB,EACnB,SAAS,EACT,MAAM,GACP,MAAM,UAAU,CAAC;AAIlB,IAAM,iBAAiB,GAAvB,MAAM,iBAAiB;CAAG,CAAA;AAApB,iBAAiB;IAFtB,UAAU,EAAE;IACZ,MAAM,CAAC,SAAS,CAAC,gBAAgB,CAAC;GAC7B,iBAAiB,CAAG;AAE1B,MAAM,kBAAkB;IACf,SAAS,CACd,QAAwC;QAExC,IAAI,QAAQ,YAAY,iBAAiB,EAAE;YACzC,OAAO,SAAS,CAAC;SAClB;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAI,KAAa;IAC7C,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC3D,OAAO,mBAAmB,CAAC,KAAK,EAAE,CAAA,kBAAqB,CAAA,CAAC,CAAC;AAC3D,CAAC"}

package/dist/dummyVerificationKey.d.ts

@@ -0,0 +1,3 @@
+import { VerificationKey } from "o1js";
+export declare function dummyVerificationKey(): VerificationKey;
+//# sourceMappingURL=dummyVerificationKey.d.ts.map

package/dist/dummyVerificationKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dummyVerificationKey.d.ts","sourceRoot":"","sources":["../src/dummyVerificationKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,eAAe,EAAE,MAAM,MAAM,CAAC;AAE9C,wBAAgB,oBAAoB,oBAOnC"}

package/dist/dummyVerificationKey.js

@@ -0,0 +1,8 @@
+import { Field, VerificationKey } from "o1js";
+export function dummyVerificationKey() {
+    return new VerificationKey({
+        hash: Field("3392518251768960475377392625298437850623664973002200885669375116181514017494"),
+        data: "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",
+    });
+}
+//# sourceMappingURL=dummyVerificationKey.js.map

package/dist/dummyVerificationKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dummyVerificationKey.js","sourceRoot":"","sources":["../src/dummyVerificationKey.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAE9C,MAAM,UAAU,oBAAoB;IAClC,OAAO,IAAI,eAAe,CAAC;QACzB,IAAI,EAAE,KAAK,CACT,8EAA8E,CAC/E;QACD,IAAI,EAAE,81EAA81E;KACr2E,CAAC,CAAC;AACL,CAAC"}