@bluelibs/runner 1.0.0 → 1.2.0

package/dist/models/DependencyProcessor.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DependencyProcessor = void 0;
+const utils = require("../define");
+const ResourceInitializer_1 = require("./ResourceInitializer");
+const errors_1 = require("../errors");
+/**
+ * This class is responsible of setting up dependencies with their respective computedValues.
+ * Note that all elements must have been previously registered otherwise errors will be thrown
+ * when trying to depend on something not in the store.
+ */
+class DependencyProcessor {
+    store;
+    eventManager;
+    taskRunner;
+    resourceInitializer;
+    constructor(store, eventManager, taskRunner) {
+        this.store = store;
+        this.eventManager = eventManager;
+        this.taskRunner = taskRunner;
+        this.resourceInitializer = new ResourceInitializer_1.ResourceInitializer(store, eventManager);
+    }
+    /**
+     * This function is going to go through all the resources, tasks and middleware to compute their required dependencies.
+     */
+    async computeAllDependencies() {
+        for (const middleware of this.store.middlewares.values()) {
+            const deps = middleware.middleware.dependencies;
+            middleware.computedDependencies = await this.extractDependencies(deps);
+        }
+        for (const task of this.store.tasks.values()) {
+            const deps = task.task.dependencies;
+            task.computedDependencies = await this.extractDependencies(deps);
+            let eventDefinition = task.task.on;
+            if (eventDefinition) {
+                if (this.store.events.get(eventDefinition.id) === undefined) {
+                    throw errors_1.Errors.eventNotFound(eventDefinition.id);
+                }
+                this.eventManager.addListener(eventDefinition, async (receivedEvent) => {
+                    return this.taskRunner.run(task.task, receivedEvent, task.computedDependencies);
+                });
+            }
+        }
+        for (const resource of this.store.resources.values()) {
+            await this.processResourceDependencies(resource);
+        }
+    }
+    // Most likely these are resources that no-one has dependencies towards
+    // We need to ensure they work too!
+    async initializeUninitializedResources() {
+        for (const resource of this.store.resources.values()) {
+            if (resource.isInitialized === false &&
+                // The root is the last one to be initialized and is done in a separate process.
+                resource.resource.id !== this.store.root.resource.id) {
+                await this.processResourceDependencies(resource);
+                resource.value = await this.resourceInitializer.initializeResource(resource.resource, resource.config, resource.computedDependencies);
+            }
+        }
+    }
+    /**
+     * Processes dependencies and hooks
+     * @param resource
+     */
+    async processResourceDependencies(resource) {
+        const deps = resource.resource.dependencies;
+        resource.computedDependencies = await this.extractDependencies(deps);
+    }
+    async initializeRoot() {
+        const storeResource = this.store.root;
+        storeResource.value = await this.resourceInitializer.initializeResource(storeResource.resource, storeResource.config, 
+        // They are already computed
+        storeResource.computedDependencies);
+        storeResource.isInitialized = true;
+    }
+    /**
+     * Processes all hooks, should run before emission of any event.
+     * @returns
+     */
+    attachHooks() {
+        // iterate through resources and send them to processHooks
+        for (const resource of this.store.resources.values()) {
+            if (resource.resource.hooks) {
+                this.attachHooksToResource(resource);
+            }
+        }
+    }
+    /**
+     * Processes the hooks for resources
+     * @param hooks
+     * @param deps
+     */
+    attachHooksToResource(resourceStoreElement) {
+        let hooks = resourceStoreElement.resource.hooks;
+        if (typeof hooks === "function") {
+            hooks = hooks(resourceStoreElement.config);
+        }
+        if (hooks.length === 0) {
+            return;
+        }
+        for (const hook of hooks) {
+            const event = hook.event;
+            if (this.store.events.has(event.id) === false) {
+                throw errors_1.Errors.eventNotFound(event.id);
+            }
+            this.eventManager.addListener(event, async (receivedEvent) => {
+                return hook.run(receivedEvent, resourceStoreElement.computedDependencies);
+            });
+        }
+    }
+    async extractDependencies(map) {
+        const object = {};
+        for (const key in map) {
+            object[key] = await this.extractDependency(map[key]);
+        }
+        return object;
+    }
+    async extractDependency(object) {
+        if (utils.isResource(object)) {
+            return this.extractResourceDependency(object);
+        }
+        else if (utils.isTask(object)) {
+            return this.extractTaskDependency(object);
+        }
+        else if (utils.isEvent(object)) {
+            return this.extractEventDependency(object);
+        }
+        else {
+            throw errors_1.Errors.unknownItemType(object);
+        }
+    }
+    /**
+     * Converts the event into a running functions with real inputs
+     * @param object
+     * @returns
+     */
+    extractEventDependency(object) {
+        return async (input) => {
+            return this.eventManager.emit(object, input);
+        };
+    }
+    async extractTaskDependency(object) {
+        const storeTask = this.store.tasks.get(object.id);
+        if (storeTask === undefined) {
+            throw errors_1.Errors.dependencyNotFound(`Task ${object.id}`);
+        }
+        if (!storeTask.isInitialized) {
+            storeTask.isInitialized = true;
+            // it's sanitised
+            const dependencies = object.dependencies;
+            storeTask.computedDependencies = await this.extractDependencies(dependencies);
+        }
+        return (input) => {
+            return this.taskRunner.run(storeTask.task, input, storeTask.computedDependencies);
+        };
+    }
+    async extractResourceDependency(object) {
+        // check if it exists in the store with the value
+        const storeResource = this.store.resources.get(object.id);
+        if (storeResource === undefined) {
+            throw errors_1.Errors.dependencyNotFound(`Resource ${object.id}`);
+        }
+        const { resource, config } = storeResource;
+        if (storeResource.isInitialized) {
+            return storeResource.value;
+        }
+        else {
+            // we need to initialize the resource
+            storeResource.isInitialized = true;
+            // check if it has an initialisation function that provides the value
+            if (resource.init) {
+                storeResource.value = await this.resourceInitializer.initializeResource(resource, config, await this.extractDependencies(resource.dependencies || {}));
+            }
+        }
+        return storeResource.value;
+    }
+}
+exports.DependencyProcessor = DependencyProcessor;
+//# sourceMappingURL=DependencyProcessor.js.map

package/dist/models/DependencyProcessor.js.map

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

package/dist/models/EventManager.d.ts

@@ -0,0 +1,17 @@
+import { EventHandlerType, IEvent, IEventDefinition } from "../defs";
+export interface IEventHandlerOptions<T = any> {
+    order?: number;
+    filter?: (event: IEvent<T>) => boolean;
+}
+export declare class EventManager {
+    #private;
+    private listeners;
+    private globalListeners;
+    get isLocked(): boolean;
+    lock(): void;
+    checkLock(): void;
+    emit<TInput>(eventDefinition: IEventDefinition<TInput>, ...args: TInput extends void ? [] : [TInput]): Promise<void>;
+    addListener<T>(event: IEventDefinition | Array<IEventDefinition>, handler: EventHandlerType<T>, options?: IEventHandlerOptions<T>): void;
+    addGlobalListener(handler: EventHandlerType, options?: IEventHandlerOptions): void;
+    private sortListeners;
+}

package/dist/models/EventManager.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventManager = void 0;
+const errors_1 = require("../errors");
+const HandlerOptionsDefaults = { order: 0 };
+class EventManager {
+    listeners = new Map();
+    globalListeners = [];
+    #isLocked = false;
+    get isLocked() {
+        return this.#isLocked;
+    }
+    lock() {
+        this.#isLocked = true;
+    }
+    checkLock() {
+        if (this.#isLocked) {
+            throw errors_1.Errors.locked("EventManager");
+        }
+    }
+    async emit(eventDefinition, ...args) {
+        const data = args[0];
+        const eventListeners = this.listeners.get(eventDefinition.id) || [];
+        const allListeners = this.sortListeners([
+            ...eventListeners,
+            ...this.globalListeners,
+        ]);
+        const event = {
+            id: eventDefinition.id,
+            data,
+        };
+        for (const listener of allListeners) {
+            const ok = !listener.filter || listener.filter(event);
+            if (ok) {
+                await listener.handler(event);
+            }
+        }
+    }
+    addListener(event, handler, options = HandlerOptionsDefaults) {
+        this.checkLock();
+        if (Array.isArray(event)) {
+            event.forEach((id) => this.addListener(id, handler, options));
+        }
+        else {
+            const eventId = event.id;
+            const listeners = this.listeners.get(eventId) || [];
+            const newListener = {
+                handler,
+                order: options.order || 0,
+                filter: options.filter,
+            };
+            const newListeners = this.sortListeners([...listeners, newListener]);
+            this.listeners.set(eventId, newListeners);
+        }
+    }
+    addGlobalListener(handler, options = HandlerOptionsDefaults) {
+        this.checkLock();
+        const newListener = {
+            handler,
+            order: options.order || 0,
+            filter: options.filter,
+        };
+        this.globalListeners = this.sortListeners([
+            ...this.globalListeners,
+            newListener,
+        ]);
+    }
+    sortListeners(listeners) {
+        return [...listeners].sort((a, b) => a.order - b.order);
+    }
+}
+exports.EventManager = EventManager;
+//# sourceMappingURL=EventManager.js.map

package/dist/models/EventManager.js.map

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

package/dist/models/Logger.d.ts

@@ -0,0 +1,33 @@
+import { EventManager } from "./EventManager";
+export type LogLevels = "trace" | "debug" | "info" | "warn" | "error" | "critical";
+export interface ILog {
+    level: string;
+    context?: string;
+    data: any;
+    timestamp: Date;
+}
+export declare class Logger {
+    private eventManager;
+    static defaultContext: string;
+    severity: {
+        trace: number;
+        debug: number;
+        info: number;
+        warn: number;
+        error: number;
+        critical: number;
+    };
+    constructor(eventManager: EventManager);
+    /**
+     * @param level
+     * @param message
+     */
+    log(level: LogLevels, data: any): Promise<void>;
+    print(log: ILog): Promise<void>;
+    info(data: any): Promise<void>;
+    error(data: any): Promise<void>;
+    warn(data: any): Promise<void>;
+    debug(data: any): Promise<void>;
+    trace(data: any): Promise<void>;
+    critical(data: any): Promise<void>;
+}

package/dist/models/Logger.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const globalEvents_1 = require("../globalEvents");
+class Logger {
+    eventManager;
+    static defaultContext = "app";
+    severity = {
+        trace: 0,
+        debug: 1,
+        info: 2,
+        warn: 3,
+        error: 4,
+        critical: 5,
+    };
+    constructor(eventManager) {
+        this.eventManager = eventManager;
+    }
+    /**
+     * @param level
+     * @param message
+     */
+    async log(level, data) {
+        const log = {
+            level,
+            data,
+            timestamp: new Date(),
+        };
+        await this.eventManager.emit(globalEvents_1.globalEvents.log, log);
+    }
+    async print(log) {
+        // Extract the relevant information from the log
+        const { level, context, data, timestamp } = log;
+        // Format the timestamp to a more readable format
+        const formattedTimestamp = timestamp.toISOString();
+        // Format the log level for better visibility
+        const levelStr = `[${level.toUpperCase()}]`;
+        // Format the context, if provided
+        const contextStr = context ? `(${context})` : "";
+        // Handle different data types, especially if it's an error
+        let dataStr;
+        if (data instanceof Error) {
+            dataStr = `Error: ${data.name} - ${data.message}\nStack Trace:\n${data.stack}`;
+        }
+        else if (typeof data === "object") {
+            dataStr = JSON.stringify(data, null, 2); // Pretty-print JSON objects
+        }
+        else {
+            dataStr = String(data); // Convert any other type to string
+        }
+        // Construct the final log message
+        const logMessage = `${formattedTimestamp} ${levelStr} ${contextStr} - ${dataStr}`;
+        // Print the log message
+        console.log(logMessage);
+    }
+    async info(data) {
+        await this.log("info", data);
+    }
+    async error(data) {
+        await this.log("error", data);
+    }
+    async warn(data) {
+        await this.log("warn", data);
+    }
+    async debug(data) {
+        await this.log("debug", data);
+    }
+    async trace(data) {
+        await this.log("trace", data);
+    }
+    async critical(data) {
+        await this.log("critical", data);
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=Logger.js.map

package/dist/models/Logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.js","sourceRoot":"","sources":["../../src/models/Logger.ts"],"names":[],"mappings":";;;AAAA,kDAA+C;AAkB/C,MAAa,MAAM;IAYG;IAXb,MAAM,CAAC,cAAc,GAAG,KAAK,CAAC;IAE9B,QAAQ,GAAG;QAChB,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC;QACR,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,CAAC;QACP,KAAK,EAAE,CAAC;QACR,QAAQ,EAAE,CAAC;KACZ,CAAC;IAEF,YAAoB,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAElD;;;OAGG;IACI,KAAK,CAAC,GAAG,CAAC,KAAgB,EAAE,IAAS;QAC1C,MAAM,GAAG,GAAS;YAChB,KAAK;YACL,IAAI;YACJ,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC;QAEF,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,GAAS;QAC1B,gDAAgD;QAChD,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,GAAG,CAAC;QAEhD,iDAAiD;QACjD,MAAM,kBAAkB,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;QAEnD,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC;QAE5C,kCAAkC;QAClC,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAEjD,2DAA2D;QAC3D,IAAI,OAAe,CAAC;QACpB,IAAI,IAAI,YAAY,KAAK,EAAE,CAAC;YAC1B,OAAO,GAAG,UAAU,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,mBAAmB,IAAI,CAAC,KAAK,EAAE,CAAC;QACjF,CAAC;aAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACpC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,4BAA4B;QACvE,CAAC;aAAM,CAAC;YACN,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,mCAAmC;QAC7D,CAAC;QAED,kCAAkC;QAClC,MAAM,UAAU,GAAG,GAAG,kBAAkB,IAAI,QAAQ,IAAI,UAAU,MAAM,OAAO,EAAE,CAAC;QAElF,wBAAwB;QACxB,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,IAAS;QACzB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAS;QAC1B,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,IAAI,CAAC,IAAS;QACzB,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAS;QAC1B,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAS;QAC1B,MAAM,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,QAAQ,CAAC,IAAS;QAC7B,MAAM,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;;AAhFH,wBAiFC"}

package/dist/models/ResourceInitializer.d.ts

@@ -0,0 +1,13 @@
+import { DependencyMapType, DependencyValuesType, IResource } from "../defs";
+import { EventManager } from "./EventManager";
+import { Store } from "./Store";
+export declare class ResourceInitializer {
+    protected readonly store: Store;
+    protected readonly eventManager: EventManager;
+    constructor(store: Store, eventManager: EventManager);
+    /**
+     * Begins the execution of an task. These are registered tasks and all sanity checks have been performed at this stage to ensure consistency of the object.
+     * This function can throw only if any of the event listeners or run function throws
+     */
+    initializeResource<TConfig = null, TValue = any, TDeps extends DependencyMapType = {}>(resource: IResource<TConfig, TValue, TDeps>, config: TConfig, dependencies: DependencyValuesType<TDeps>): Promise<TValue | undefined>;
+}

package/dist/models/ResourceInitializer.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceInitializer = void 0;
+const globalEvents_1 = require("../globalEvents");
+class ResourceInitializer {
+    store;
+    eventManager;
+    constructor(store, eventManager) {
+        this.store = store;
+        this.eventManager = eventManager;
+    }
+    /**
+     * Begins the execution of an task. These are registered tasks and all sanity checks have been performed at this stage to ensure consistency of the object.
+     * This function can throw only if any of the event listeners or run function throws
+     */
+    async initializeResource(resource, config, dependencies) {
+        // begin by dispatching the event of creating it.
+        // then ensure the hooks are called
+        // then ensure the middleware are called
+        await this.eventManager.emit(globalEvents_1.globalEvents.resources.beforeInit, {
+            config,
+            resource,
+        });
+        await this.eventManager.emit(resource.events.beforeInit, { config });
+        let error, value;
+        try {
+            if (resource.init) {
+                value = await resource.init(config, dependencies);
+            }
+            await this.eventManager.emit(resource.events.afterInit, {
+                config,
+                value,
+            });
+            await this.eventManager.emit(globalEvents_1.globalEvents.resources.afterInit, {
+                config,
+                resource,
+                value,
+            });
+            return value;
+        }
+        catch (e) {
+            error = e;
+            // If you want to rewthrow the error, this should be done inside the onError event.
+            await this.eventManager.emit(resource.events.onError, { error });
+            await this.eventManager.emit(globalEvents_1.globalEvents.resources.onError, {
+                error,
+                resource,
+            });
+            throw e;
+        }
+    }
+}
+exports.ResourceInitializer = ResourceInitializer;
+//# sourceMappingURL=ResourceInitializer.js.map

package/dist/models/ResourceInitializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceInitializer.js","sourceRoot":"","sources":["../../src/models/ResourceInitializer.ts"],"names":[],"mappings":";;;AAOA,kDAA+C;AAG/C,MAAa,mBAAmB;IAET;IACA;IAFrB,YACqB,KAAY,EACZ,YAA0B;QAD1B,UAAK,GAAL,KAAK,CAAO;QACZ,iBAAY,GAAZ,YAAY,CAAc;IAC5C,CAAC;IAEJ;;;OAGG;IACI,KAAK,CAAC,kBAAkB,CAK7B,QAA2C,EAC3C,MAAe,EACf,YAAyC;QAEzC,iDAAiD;QACjD,mCAAmC;QACnC,wCAAwC;QACxC,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,SAAS,CAAC,UAAU,EAAE;YAC9D,MAAM;YACN,QAAQ;SACT,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAErE,IAAI,KAAK,EAAE,KAAK,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAClB,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACpD,CAAC;YAED,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE;gBACtD,MAAM;gBACN,KAAK;aACN,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,SAAS,CAAC,SAAS,EAAE;gBAC7D,MAAM;gBACN,QAAQ;gBACR,KAAK;aACN,CAAC,CAAC;YAEH,OAAO,KAAK,CAAC;QACf,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,KAAK,GAAG,CAAC,CAAC;YAEV,mFAAmF;YACnF,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACjE,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,2BAAY,CAAC,SAAS,CAAC,OAAO,EAAE;gBAC3D,KAAK;gBACL,QAAQ;aACT,CAAC,CAAC;YAEH,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;CACF;AA1DD,kDA0DC"}

package/dist/models/Store.d.ts

@@ -0,0 +1,90 @@
+import { DependencyMapType, DependencyValuesType, IEventDefinition, IResource, ITask, IResourceWithConfig, RegisterableItems, IMiddleware } from "../defs";
+import { IDependentNode } from "../tools/findCircularDependencies";
+import { EventManager } from "./EventManager";
+export type ResourceStoreElementType<C = any, V = any, D extends DependencyMapType = {}> = {
+    resource: IResource<C, V, D>;
+    computedDependencies?: DependencyValuesType<D>;
+    config: C;
+    value: V;
+    isInitialized?: boolean;
+};
+export type TaskStoreElementType<Input = any, Output extends Promise<any> = any, D extends DependencyMapType = any> = {
+    task: ITask<Input, Output, D>;
+    computedDependencies: DependencyValuesType<D>;
+    isInitialized: boolean;
+};
+export type MiddlewareStoreElementType<TDeps extends DependencyMapType = any> = {
+    middleware: IMiddleware<TDeps>;
+    computedDependencies: DependencyValuesType<TDeps>;
+};
+export type EventStoreElementType = {
+    event: IEventDefinition;
+};
+/**
+ * Store class which is used to store all the resources, tasks, middleware and events.
+ */
+export declare class Store {
+    #private;
+    protected readonly eventManager: EventManager;
+    root: ResourceStoreElementType;
+    tasks: Map<string, TaskStoreElementType>;
+    resources: Map<string, ResourceStoreElementType>;
+    events: Map<string, EventStoreElementType>;
+    middlewares: Map<string, MiddlewareStoreElementType>;
+    overrides: Map<string, IResource | IMiddleware | ITask | IResourceWithConfig>;
+    constructor(eventManager: EventManager);
+    get isLocked(): boolean;
+    lock(): void;
+    checkLock(): void;
+    /**
+     * Store the root before beginning registration
+     * @param root
+     * @param config
+     */
+    initializeStore(root: IResource<any>, config: any): void;
+    /**
+     * Beginning with the root, we perform registering to the container all the resources, tasks, middleware and events.
+     * @param element
+     * @param config
+     */
+    private computeRegistrationDeeply;
+    /**
+     * @param element
+     */
+    private storeOverridesDeeply;
+    /**
+     * middlewares are already stored in their final form and the check for them would be redundant
+     * @param id
+     */
+    protected checkIfIDExists(id: string): void | never;
+    /**
+     * Cleanup
+     */
+    dispose(): Promise<void>;
+    /**
+     * When this is called, all overrides should have been stored in the "overrides" store.
+     */
+    processOverrides(): void;
+    getGlobalMiddlewares(excludingIds: string[]): IMiddleware[];
+    /**
+     * If you want to register something to the store you can use this function.
+     * @param item
+     */
+    storeGenericItem<C>(item: RegisterableItems): void;
+    private storeMiddleware;
+    storeEvent<C>(item: IEventDefinition<void>): void;
+    private storeResourceWithConfig;
+    /**
+     * This is for storing a resource without a config.
+     * @param item
+     */
+    private storeResource;
+    storeEventsForAllTasks(): void;
+    /**
+     * This is for storing a resource without a config.
+     * @param item
+     */
+    private prepareResource;
+    private storeTask;
+    getDependentNodes(): IDependentNode[];
+}