@bluelibs/runner 3.4.2 → 4.0.1

package/dist/errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ValidationError = exports.StoreAlreadyInitializedError = exports.LockedError = exports.MiddlewareAlreadyGlobalError = exports.EventNotFoundError = exports.CircularDependenciesError = exports.UnknownItemTypeError = exports.DependencyNotFoundError = exports.DuplicateRegistrationError = exports.RuntimeError = void 0;
+exports.ValidationError = exports.StoreAlreadyInitializedError = exports.LockedError = exports.TagNotFoundError = exports.MiddlewareNotRegisteredError = exports.ResourceNotFoundError = exports.EventNotFoundError = exports.CircularDependenciesError = exports.ContextError = exports.UnknownItemTypeError = exports.DependencyNotFoundError = exports.DuplicateRegistrationError = exports.RuntimeError = void 0;
 /**
  * Base error class for all BlueLibs Runner errors
  */
@@ -16,7 +16,7 @@ exports.RuntimeError = RuntimeError;
  */
 class DuplicateRegistrationError extends RuntimeError {
     constructor(type, id) {
-        super(`${type} "${id.toString()}" already registered`);
+        super(`${type} "${id.toString()}" already registered. You might have used the same 'id' in two different components or you may have registered the same element twice.`);
         this.name = "DuplicateRegistrationError";
     }
 }
@@ -41,12 +41,34 @@ class UnknownItemTypeError extends RuntimeError {
     }
 }
 exports.UnknownItemTypeError = UnknownItemTypeError;
+/**
+ * Error thrown whenever a requested context is not available.
+ */
+class ContextError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ContextError";
+    }
+}
+exports.ContextError = ContextError;
 /**
  * Error thrown when circular dependencies are detected
  */
 class CircularDependenciesError extends RuntimeError {
     constructor(cycles) {
-        super(`Circular dependencies detected: ${cycles.join(", ")}`);
+        const cycleDetails = cycles.map((cycle) => `  • ${cycle}`).join("\n");
+        const hasMiddleware = cycles.some((cycle) => cycle.includes("middleware"));
+        let guidance = "\n\nTo resolve circular dependencies:";
+        guidance +=
+            "\n  • Consider refactoring to reduce coupling between components";
+        guidance += "\n  • Extract shared dependencies into separate resources";
+        if (hasMiddleware) {
+            guidance +=
+                "\n  • For middleware: you can filter out tasks/resources using everywhere(fn)";
+            guidance +=
+                "\n  • Consider using events for communication instead of direct dependencies";
+        }
+        super(`Circular dependencies detected:\n${cycleDetails}${guidance}`);
         this.name = "CircularDependenciesError";
     }
 }
@@ -62,16 +84,32 @@ class EventNotFoundError extends RuntimeError {
 }
 exports.EventNotFoundError = EventNotFoundError;
 /**
- * Error thrown when attempting to make a middleware global when it's already global
+ * Error thrown when a resource is not found in the store
+ */
+class ResourceNotFoundError extends RuntimeError {
+    constructor(id) {
+        super(`Resource "${id.toString()}" not found. Did you forget to register it or are you using the correct id?`);
+        this.name = "ResourceNotFoundError";
+    }
+}
+exports.ResourceNotFoundError = ResourceNotFoundError;
+class MiddlewareNotRegisteredError extends RuntimeError {
+    constructor(type, source, middlewareId) {
+        super(`Middleware inside ${type} "${source}" depends on "${middlewareId}" but it's not registered. Did you forget to register it?`);
+        this.name = `MiddlewareNotRegisteredError: ${type} ${source} ${middlewareId}`;
+    }
+}
+exports.MiddlewareNotRegisteredError = MiddlewareNotRegisteredError;
+/**
+ * Error thrown when a tag is not found in the registry
  */
-class MiddlewareAlreadyGlobalError extends RuntimeError {
+class TagNotFoundError extends RuntimeError {
     constructor(id) {
-        super("Cannot call .everywhere() on an already global middleware: " +
-            id.toString());
-        this.name = "MiddlewareAlreadyGlobalError";
+        super(`Tag "${id}" not registered. Did you forget to register it inside a resource?`);
+        this.name = "TagNotRegisteredError";
     }
 }
-exports.MiddlewareAlreadyGlobalError = MiddlewareAlreadyGlobalError;
+exports.TagNotFoundError = TagNotFoundError;
 /**
  * Error thrown when attempting to modify a locked component
  */
@@ -97,7 +135,9 @@ exports.StoreAlreadyInitializedError = StoreAlreadyInitializedError;
  */
 class ValidationError extends RuntimeError {
     constructor(type, id, originalError) {
-        const errorMessage = originalError instanceof Error ? originalError.message : String(originalError);
+        const errorMessage = originalError instanceof Error
+            ? originalError.message
+            : String(originalError);
         super(`${type} validation failed for ${id.toString()}: ${errorMessage}`);
         this.name = "ValidationError";
     }

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED;;GAEG;AACH,MAAa,0BAA2B,SAAQ,YAAY;IAC1D,YAAY,IAAY,EAAE,EAAmB;QAC3C,KAAK,CAAC,GAAG,IAAI,KAAK,EAAE,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AALD,gEAKC;AAED;;GAEG;AACH,MAAa,uBAAwB,SAAQ,YAAY;IACvD,YAAY,GAAoB;QAC9B,KAAK,CACH,cAAc,GAAG,CAAC,QAAQ,EAAE,+DAA+D,CAC5F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAPD,0DAOC;AAED;;GAEG;AACH,MAAa,oBAAqB,SAAQ,YAAY;IACpD,YAAY,IAAS;QACnB,KAAK,CAAC,sBAAsB,IAAI,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC;AAED;;GAEG;AACH,MAAa,yBAA0B,SAAQ,YAAY;IACzD,YAAY,MAAgB;QAC1B,KAAK,CAAC,mCAAmC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AALD,8DAKC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,EAAmB;QAC7B,KAAK,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,6CAA6C,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED;;GAEG;AACH,MAAa,4BAA6B,SAAQ,YAAY;IAC5D,YAAY,EAAmB;QAC7B,KAAK,CACH,6DAA6D;YAC3D,EAAE,CAAC,QAAQ,EAAE,CAChB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AARD,oEAQC;AAED;;GAEG;AACH,MAAa,WAAY,SAAQ,YAAY;IAC3C,YAAY,IAAqB;QAC/B,KAAK,CAAC,qBAAqB,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;QACjE,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AALD,kCAKC;AAED;;GAEG;AACH,MAAa,4BAA6B,SAAQ,YAAY;IAC5D;QACE,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AALD,oEAKC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,IAAY,EAAE,EAAmB,EAAE,aAA6B;QAC1E,MAAM,YAAY,GAAG,aAAa,YAAY,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;QACpG,KAAK,CAAC,GAAG,IAAI,0BAA0B,EAAE,CAAC,QAAQ,EAAE,KAAK,YAAY,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAND,0CAMC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/globals/globalEvents.d.ts

@@ -1,41 +1,17 @@
-import { ITask, IResource, IEvent } from "../defs";
-import { ILog } from "../models/Logger";
+import { IEvent, IResource } from "../defs";
 export declare const globalEvents: {
-    beforeInit: IEvent<void>;
-    afterInit: IEvent<void>;
-    log: IEvent<ILog>;
-    tasks: {
-        beforeRun: IEvent<{
-            task: ITask<any, any, any>;
-            input: any;
-        }>;
-        afterRun: IEvent<{
-            task: ITask<any, any, any>;
-            input: any;
-            output: any;
-            setOutput: (newOutput: any) => void;
-        }>;
-        onError: IEvent<{
-            error: any;
-            suppress: () => void;
-            task: ITask<any, any, any>;
-        }>;
-    };
-    resources: {
-        beforeInit: IEvent<{
-            resource: IResource<any, any, any>;
-            config: any;
-        }>;
-        afterInit: IEvent<{
-            resource: IResource<any, any, any>;
-            config: any;
-            value: any;
-        }>;
-        onError: IEvent<{
-            error: Error;
-            suppress: () => void;
-            resource: IResource<any, any, any>;
-        }>;
-    };
+    /**
+     * Emitted when the system is fully initialized and ready for work.
+     */
+    readonly ready: IEvent<{
+        root: IResource<any, any, any, any>;
+    }>;
+    /**
+     * Central error boundary event for any thrown error across the runner.
+     */
+    readonly unhandledError: IEvent<{
+        kind: "task" | "middleware" | "resourceInit" | "hook" | "process" | "run";
+        error: any;
+    }>;
 };
-export declare const globalEventsArray: IEvent<void>[];
+export declare const globalEventsArray: IEvent<any>[];

package/dist/globals/globalEvents.js

@@ -2,93 +2,32 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.globalEventsArray = exports.globalEvents = void 0;
 const define_1 = require("../define");
+const globalTags_1 = require("./globalTags");
+const systemTag = globalTags_1.globalTags.system;
 exports.globalEvents = {
-    beforeInit: (0, define_1.defineEvent)({
-        id: "globals.events.beforeInit",
+    // Minimal core events retained if any (custom events can still be defined by users)
+    /**
+     * Emitted when the system is fully initialized and ready for work.
+     */
+    ready: (0, define_1.defineEvent)({
+        id: "globals.events.ready",
         meta: {
-            title: "Before Initialization",
-            description: "Triggered before any resource or system-wide initialization occurs.",
-            tags: ["system"],
+            title: "System Ready",
+            description: "Emitted when the system has completed boot and is ready for listeners to start work." +
+                "This runs right before returning value for run().",
         },
     }),
-    afterInit: (0, define_1.defineEvent)({
-        id: "globals.events.afterInit",
+    /**
+     * Central error boundary event for any thrown error across the runner.
+     */
+    unhandledError: (0, define_1.defineEvent)({
+        id: "globals.events.unhandledError",
         meta: {
-            title: "After Initialization",
-            description: "Fired after the system or resource initialization is completed.",
-            tags: ["system"],
+            title: "Unhandled Error",
+            description: "Central error boundary event for any thrown error across the runner.",
         },
+        tags: [systemTag, globalTags_1.globalTags.excludeFromGlobalHooks],
     }),
-    log: (0, define_1.defineEvent)({
-        id: "globals.events.log",
-        meta: {
-            title: "Log Event",
-            description: "Used to log events and messages across the system.",
-            tags: ["system"],
-        },
-    }),
-    tasks: {
-        beforeRun: (0, define_1.defineEvent)({
-            id: "globals.events.tasks.beforeRun",
-            meta: {
-                title: "Before Task Execution",
-                description: "Triggered before a task starts running, providing access to the input data.",
-                tags: ["system"],
-            },
-        }),
-        afterRun: (0, define_1.defineEvent)({
-            id: "globals.events.tasks.afterRun",
-            meta: {
-                title: "After Task Execution",
-                description: "Fired after a task has completed, providing both the input and output data.",
-                tags: ["system"],
-            },
-        }),
-        onError: (0, define_1.defineEvent)({
-            id: "globals.events.tasks.onError",
-            meta: {
-                title: "Task Error",
-                description: "Triggered when an error occurs during task execution. Allows error suppression.",
-                tags: ["system"],
-            },
-        }),
-    },
-    resources: {
-        beforeInit: (0, define_1.defineEvent)({
-            id: "globals.events.resources.beforeInit",
-            meta: {
-                title: "Before Resource Initialization",
-                description: "Fired before a resource is initialized, with access to the configuration.",
-                tags: ["system"],
-            },
-        }),
-        afterInit: (0, define_1.defineEvent)({
-            id: "globals.events.resources.afterInit",
-            meta: {
-                title: "After Resource Initialization",
-                description: "Fired after a resource has been initialized, providing the final value.",
-                tags: ["system"],
-            },
-        }),
-        onError: (0, define_1.defineEvent)({
-            id: "globals.events.resources.onError",
-            meta: {
-                title: "Resource Error",
-                description: "Triggered when an error occurs during resource initialization. Allows error suppression.",
-                tags: ["system"],
-            },
-        }),
-    },
 };
-exports.globalEventsArray = [
-    exports.globalEvents.log,
-    exports.globalEvents.beforeInit,
-    exports.globalEvents.afterInit,
-    exports.globalEvents.tasks.beforeRun,
-    exports.globalEvents.tasks.afterRun,
-    exports.globalEvents.tasks.onError,
-    exports.globalEvents.resources.beforeInit,
-    exports.globalEvents.resources.afterInit,
-    exports.globalEvents.resources.onError,
-];
+exports.globalEventsArray = [exports.globalEvents.ready];
 //# sourceMappingURL=globalEvents.js.map

package/dist/globals/globalEvents.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalEvents.js","sourceRoot":"","sources":["../../src/globals/globalEvents.ts"],"names":[],"mappings":";;;AAAA,sCAAwC;AAI3B,QAAA,YAAY,GAAG;IAC1B,UAAU,EAAE,IAAA,oBAAW,EAAC;QACtB,EAAE,EAAE,2BAA2B;QAC/B,IAAI,EAAE;YACJ,KAAK,EAAE,uBAAuB;YAC9B,WAAW,EACT,qEAAqE;YACvE,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB;KACF,CAAC;IACF,SAAS,EAAE,IAAA,oBAAW,EAAC;QACrB,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE;YACJ,KAAK,EAAE,sBAAsB;YAC7B,WAAW,EACT,iEAAiE;YACnE,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB;KACF,CAAC;IACF,GAAG,EAAE,IAAA,oBAAW,EAAO;QACrB,EAAE,EAAE,oBAAoB;QACxB,IAAI,EAAE;YACJ,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,oDAAoD;YACjE,IAAI,EAAE,CAAC,QAAQ,CAAC;SACjB;KACF,CAAC;IACF,KAAK,EAAE;QACL,SAAS,EAAE,IAAA,oBAAW,EAGnB;YACD,EAAE,EAAE,gCAAgC;YACpC,IAAI,EAAE;gBACJ,KAAK,EAAE,uBAAuB;gBAC9B,WAAW,EACT,6EAA6E;gBAC/E,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB;SACF,CAAC;QACF,QAAQ,EAAE,IAAA,oBAAW,EAKlB;YACD,EAAE,EAAE,+BAA+B;YACnC,IAAI,EAAE;gBACJ,KAAK,EAAE,sBAAsB;gBAC7B,WAAW,EACT,6EAA6E;gBAC/E,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB;SACF,CAAC;QACF,OAAO,EAAE,IAAA,oBAAW,EAIjB;YACD,EAAE,EAAE,8BAA8B;YAClC,IAAI,EAAE;gBACJ,KAAK,EAAE,YAAY;gBACnB,WAAW,EACT,iFAAiF;gBACnF,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB;SACF,CAAC;KACH;IACD,SAAS,EAAE;QACT,UAAU,EAAE,IAAA,oBAAW,EAGpB;YACD,EAAE,EAAE,qCAAqC;YACzC,IAAI,EAAE;gBACJ,KAAK,EAAE,gCAAgC;gBACvC,WAAW,EACT,2EAA2E;gBAC7E,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB;SACF,CAAC;QACF,SAAS,EAAE,IAAA,oBAAW,EAInB;YACD,EAAE,EAAE,oCAAoC;YACxC,IAAI,EAAE;gBACJ,KAAK,EAAE,+BAA+B;gBACtC,WAAW,EACT,yEAAyE;gBAC3E,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB;SACF,CAAC;QACF,OAAO,EAAE,IAAA,oBAAW,EAIjB;YACD,EAAE,EAAE,kCAAkC;YACtC,IAAI,EAAE;gBACJ,KAAK,EAAE,gBAAgB;gBACvB,WAAW,EACT,0FAA0F;gBAC5F,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB;SACF,CAAC;KACH;CACF,CAAC;AAEW,QAAA,iBAAiB,GAAG;IAC/B,oBAAY,CAAC,GAAG;IAChB,oBAAY,CAAC,UAAU;IACvB,oBAAY,CAAC,SAAS;IACtB,oBAAY,CAAC,KAAK,CAAC,SAAS;IAC5B,oBAAY,CAAC,KAAK,CAAC,QAAQ;IAC3B,oBAAY,CAAC,KAAK,CAAC,OAAO;IAC1B,oBAAY,CAAC,SAAS,CAAC,UAAU;IACjC,oBAAY,CAAC,SAAS,CAAC,SAAS;IAChC,oBAAY,CAAC,SAAS,CAAC,OAAO;CAC/B,CAAC"}
+{"version":3,"file":"globalEvents.js","sourceRoot":"","sources":["../../src/globals/globalEvents.ts"],"names":[],"mappings":";;;AAAA,sCAAwC;AAQxC,6CAA0C;AAE1C,MAAM,SAAS,GAAG,uBAAU,CAAC,MAAM,CAAC;AAEvB,QAAA,YAAY,GAAG;IAC1B,oFAAoF;IACpF;;OAEG;IACH,KAAK,EAAE,IAAA,oBAAW,EAEf;QACD,EAAE,EAAE,sBAAsB;QAC1B,IAAI,EAAE;YACJ,KAAK,EAAE,cAAc;YACrB,WAAW,EACT,sFAAsF;gBACtF,mDAAmD;SACtD;KACF,CAAC;IACF;;OAEG;IACH,cAAc,EAAE,IAAA,oBAAW,EAGxB;QACD,EAAE,EAAE,+BAA+B;QACnC,IAAI,EAAE;YACJ,KAAK,EAAE,iBAAiB;YACxB,WAAW,EACT,sEAAsE;SACzE;QACD,IAAI,EAAE,CAAC,SAAS,EAAE,uBAAU,CAAC,sBAAsB,CAAC;KACrD,CAAC;CACM,CAAC;AAEE,QAAA,iBAAiB,GAAkB,CAAC,oBAAY,CAAC,KAAK,CAAC,CAAC"}

package/dist/globals/globalMiddleware.d.ts

@@ -3,22 +3,29 @@ import { Context } from "../context";
  * Global middlewares
  */
 export declare const globalMiddlewares: {
-    requireContext: import("../defs").IMiddleware<{
+    requireContext: import("../defs").ITaskMiddleware<{
         context: Context<any>;
-    }, import("../defs").DependencyMapType>;
-    retry: import("../defs").IMiddleware<import("./middleware/retry.middleware").RetryMiddlewareConfig, import("../defs").DependencyMapType>;
-    cache: import("../defs").IMiddleware<any, {
-        cache: import("../defs").IResource<{
-            defaultOptions?: any;
-            async?: boolean;
-        }, Promise<{
-            map: Map<string | symbol, import("./middleware/cache.middleware").ICacheInstance>;
-            cacheFactoryTask: (...args: [] | [any]) => Promise<import("./middleware/cache.middleware").ICacheInstance>;
-            async: boolean | undefined;
-            defaultOptions: any;
-        }>, {
-            cacheFactoryTask: import("../defs").ITask<any, Promise<import("./middleware/cache.middleware").ICacheInstance>, any, undefined, any>;
-        }, any, any>;
-    }>;
-    timeout: import("../defs").IMiddleware<import("./middleware/timeout.middleware").TimeoutMiddlewareConfig, import("../defs").DependencyMapType>;
+    }, void, void, any>;
+    task: {
+        requireContext: import("../defs").ITaskMiddleware<{
+            context: Context<any>;
+        }, void, void, any>;
+        cache: import("../defs").ITaskMiddleware<any, void, void, {
+            cache: import("../defs").IResource<{
+                defaultOptions?: any;
+            }, Promise<{
+                map: Map<string, import("./middleware/cache.middleware").ICacheInstance>;
+                cacheFactoryTask: import("../defs").TaskDependencyWithIntercept<any, Promise<import("./middleware/cache.middleware").ICacheInstance>>;
+                defaultOptions: any;
+            }>, {
+                cacheFactoryTask: import("../defs").ITask<any, Promise<import("./middleware/cache.middleware").ICacheInstance>, any, any, import("../defs").TagType[], import("../defs").TaskMiddlewareAttachmentType[]>;
+            }, any, any, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
+        }>;
+        retry: import("../defs").ITaskMiddleware<import("./middleware/retry.middleware").RetryMiddlewareConfig, void, void, any>;
+        timeout: import("../defs").ITaskMiddleware<import("./middleware/timeout.middleware").TimeoutMiddlewareConfig, void, void, any>;
+    };
+    resource: {
+        retry: import("../defs").IResourceMiddleware<import("./middleware/retry.middleware").RetryMiddlewareConfig, void, void, any>;
+        timeout: import("../defs").IResourceMiddleware<import("./middleware/timeout.middleware").TimeoutMiddlewareConfig, void, void, any>;
+    };
 };

package/dist/globals/globalMiddleware.js

@@ -9,9 +9,17 @@ const timeout_middleware_1 = require("./middleware/timeout.middleware");
  * Global middlewares
  */
 exports.globalMiddlewares = {
-    requireContext: requireContext_middleware_1.requireContextMiddleware,
-    retry: retry_middleware_1.retryMiddleware,
-    cache: cache_middleware_1.cacheMiddleware,
-    timeout: timeout_middleware_1.timeoutMiddleware,
+    requireContext: requireContext_middleware_1.requireContextTaskMiddleware,
+    task: {
+        requireContext: requireContext_middleware_1.requireContextTaskMiddleware,
+        cache: cache_middleware_1.cacheMiddleware,
+        // common with resources
+        retry: retry_middleware_1.retryTaskMiddleware,
+        timeout: timeout_middleware_1.timeoutTaskMiddleware,
+    },
+    resource: {
+        retry: retry_middleware_1.retryResourceMiddleware,
+        timeout: timeout_middleware_1.timeoutResourceMiddleware,
+    },
 };
 //# sourceMappingURL=globalMiddleware.js.map

package/dist/globals/globalMiddleware.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalMiddleware.js","sourceRoot":"","sources":["../../src/globals/globalMiddleware.ts"],"names":[],"mappings":";;;AAEA,oEAAgE;AAChE,sFAAkF;AAClF,oEAAgE;AAChE,wEAAoE;AAEpE;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,cAAc,EAAE,oDAAwB;IACxC,KAAK,EAAE,kCAAe;IACtB,KAAK,EAAE,kCAAe;IACtB,OAAO,EAAE,sCAAiB;CAC3B,CAAC"}
+{"version":3,"file":"globalMiddleware.js","sourceRoot":"","sources":["../../src/globals/globalMiddleware.ts"],"names":[],"mappings":";;;AACA,oEAAgE;AAChE,sFAAsF;AACtF,oEAGuC;AACvC,wEAGyC;AAEzC;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,cAAc,EAAE,wDAA4B;IAC5C,IAAI,EAAE;QACJ,cAAc,EAAE,wDAA4B;QAC5C,KAAK,EAAE,kCAAe;QACtB,wBAAwB;QACxB,KAAK,EAAE,sCAAmB;QAC1B,OAAO,EAAE,0CAAqB;KAC/B;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,0CAAuB;QAC9B,OAAO,EAAE,8CAAyB;KACnC;CACF,CAAC"}

package/dist/globals/globalResources.d.ts

@@ -2,44 +2,29 @@ import { EventManager } from "../models/EventManager";
 import { Logger } from "../models/Logger";
 import { Store } from "../models/Store";
 import { TaskRunner } from "../models/TaskRunner";
+import { MiddlewareManager } from "../models/MiddlewareManager";
 export declare const globalResources: {
-    store: import("../defs").IResource<Store, Promise<Store>, {}, any, {
-        title: string;
-        description: string;
-        tags: string[];
-    }>;
-    eventManager: import("../defs").IResource<EventManager, Promise<EventManager>, {}, any, {
-        title: string;
-        description: string;
-        tags: string[];
-    }>;
-    taskRunner: import("../defs").IResource<TaskRunner, Promise<TaskRunner>, {}, any, {
-        title: string;
-        description: string;
-        tags: string[];
-    }>;
-    logger: import("../defs").IResource<Logger, Promise<Logger>, {}, any, {
-        title: string;
-        description: string;
-    }>;
+    store: import("../defs").IResource<void, Promise<Store>, {}, any, any, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
+    middlewareManager: import("../defs").IResource<void, Promise<MiddlewareManager>, {}, any, any, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
+    eventManager: import("../defs").IResource<void, Promise<EventManager>, {}, any, any, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
+    taskRunner: import("../defs").IResource<void, Promise<TaskRunner>, {}, any, any, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
+    logger: import("../defs").IResource<void, Promise<Logger>, {}, any, any, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
     cache: import("../defs").IResource<{
         defaultOptions?: any;
-        async?: boolean;
     }, Promise<{
-        map: Map<string | symbol, import("./middleware/cache.middleware").ICacheInstance>;
-        cacheFactoryTask: (...args: [] | [any]) => Promise<import("./middleware/cache.middleware").ICacheInstance>;
-        async: boolean | undefined;
+        map: Map<string, import("./middleware/cache.middleware").ICacheInstance>;
+        cacheFactoryTask: import("../defs").TaskDependencyWithIntercept<any, Promise<import("./middleware/cache.middleware").ICacheInstance>>;
         defaultOptions: any;
     }>, {
-        cacheFactoryTask: import("../defs").ITask<any, Promise<import("./middleware/cache.middleware").ICacheInstance>, any, undefined, any>;
-    }, any, any>;
+        cacheFactoryTask: import("../defs").ITask<any, Promise<import("./middleware/cache.middleware").ICacheInstance>, any, any, import("../defs").TagType[], import("../defs").TaskMiddlewareAttachmentType[]>;
+    }, any, any, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
     queue: import("../defs").IResource<void, Promise<{
-        map: Map<string | symbol, import("..").Queue>;
+        map: Map<string, import("..").Queue>;
         run: <T>(id: string, task: (signal: AbortSignal) => Promise<T>) => Promise<T>;
     }>, {}, {
-        map: Map<string | symbol, import("..").Queue>;
+        map: Map<string, import("..").Queue>;
     }, {
         title: string;
         description: string;
-    }>;
+    }, import("../defs").TagType[], import("../defs").ResourceMiddlewareAttachmentType[]>;
 };

package/dist/globals/globalResources.js

@@ -4,42 +4,50 @@ exports.globalResources = void 0;
 const define_1 = require("../define");
 const cache_middleware_1 = require("./middleware/cache.middleware");
 const queue_resource_1 = require("./resources/queue.resource");
+const globalTags_1 = require("./globalTags");
+const systemTag = globalTags_1.globalTags.system;
 const store = (0, define_1.defineResource)({
     id: "globals.resources.store",
-    init: async (store) => store,
     meta: {
         title: "Store",
         description: "A global store that can be used to store and retrieve tasks, resources, events and middleware",
-        tags: ["internal"],
     },
+    tags: [systemTag],
 });
 exports.globalResources = {
     store,
+    middlewareManager: (0, define_1.defineResource)({
+        id: "globals.resources.middlewareManager",
+        meta: {
+            title: "Middleware Manager",
+            description: "Manages all middleware and middleware interceptors.",
+        },
+        tags: [systemTag],
+    }),
     eventManager: (0, define_1.defineResource)({
         id: "globals.resources.eventManager",
-        init: async (em) => em,
         meta: {
             title: "Event Manager",
             description: "Manages all events and event listeners. This is meant to be used internally for most use-cases.",
-            tags: ["internal"],
         },
+        tags: [systemTag],
     }),
     taskRunner: (0, define_1.defineResource)({
         id: "globals.resources.taskRunner",
-        init: async (runner) => runner,
         meta: {
             title: "Task Runner",
             description: "Manages the execution of tasks and task dependencies. This is meant to be used internally for most use-cases.",
-            tags: ["internal"],
         },
+        tags: [systemTag],
     }),
     logger: (0, define_1.defineResource)({
         id: "globals.resources.logger",
-        init: async (logger) => logger,
         meta: {
+            // We skip system tag for logger because it's part of the utility toolkit.
             title: "Logger",
             description: "Logs all events and errors. This is meant to be used internally for most use-cases. Emits a globals.log event for each log.",
         },
+        tags: [systemTag],
     }),
     cache: cache_middleware_1.cacheResource,
     queue: queue_resource_1.queueResource,

package/dist/globals/globalResources.js.map

@@ -1 +1 @@
-{"version":3,"file":"globalResources.js","sourceRoot":"","sources":["../../src/globals/globalResources.ts"],"names":[],"mappings":";;;AAAA,sCAA2C;AAK3C,oEAA8D;AAC9D,+DAA2D;AAE3D,MAAM,KAAK,GAAG,IAAA,uBAAc,EAAC;IAC3B,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE,KAAK,EAAE,KAAY,EAAE,EAAE,CAAC,KAAK;IACnC,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO;QACd,WAAW,EACT,+FAA+F;QACjG,IAAI,EAAE,CAAC,UAAU,CAAC;KACnB;CACF,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG;IAC7B,KAAK;IACL,YAAY,EAAE,IAAA,uBAAc,EAAC;QAC3B,EAAE,EAAE,gCAAgC;QACpC,IAAI,EAAE,KAAK,EAAE,EAAgB,EAAE,EAAE,CAAC,EAAE;QACpC,IAAI,EAAE;YACJ,KAAK,EAAE,eAAe;YACtB,WAAW,EACT,iGAAiG;YACnG,IAAI,EAAE,CAAC,UAAU,CAAC;SACnB;KACF,CAAC;IACF,UAAU,EAAE,IAAA,uBAAc,EAAC;QACzB,EAAE,EAAE,8BAA8B;QAClC,IAAI,EAAE,KAAK,EAAE,MAAkB,EAAE,EAAE,CAAC,MAAM;QAC1C,IAAI,EAAE;YACJ,KAAK,EAAE,aAAa;YACpB,WAAW,EACT,+GAA+G;YACjH,IAAI,EAAE,CAAC,UAAU,CAAC;SACnB;KACF,CAAC;IACF,MAAM,EAAE,IAAA,uBAAc,EAAC;QACrB,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE,KAAK,EAAE,MAAc,EAAE,EAAE,CAAC,MAAM;QACtC,IAAI,EAAE;YACJ,KAAK,EAAE,QAAQ;YACf,WAAW,EACT,6HAA6H;SAChI;KACF,CAAC;IACF,KAAK,EAAE,gCAAa;IACpB,KAAK,EAAE,8BAAa;CACrB,CAAC"}
+{"version":3,"file":"globalResources.js","sourceRoot":"","sources":["../../src/globals/globalResources.ts"],"names":[],"mappings":";;;AAAA,sCAA2C;AAK3C,oEAA8D;AAC9D,+DAA2D;AAC3D,6CAA0C;AAG1C,MAAM,SAAS,GAAG,uBAAU,CAAC,MAAM,CAAC;AAEpC,MAAM,KAAK,GAAG,IAAA,uBAAc,EAAuB;IACjD,EAAE,EAAE,yBAAyB;IAC7B,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO;QACd,WAAW,EACT,+FAA+F;KAClG;IACD,IAAI,EAAE,CAAC,SAAS,CAAC;CAClB,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG;IAC7B,KAAK;IACL,iBAAiB,EAAE,IAAA,uBAAc,EAAmC;QAClE,EAAE,EAAE,qCAAqC;QACzC,IAAI,EAAE;YACJ,KAAK,EAAE,oBAAoB;YAC3B,WAAW,EAAE,qDAAqD;SACnE;QACD,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB,CAAC;IACF,YAAY,EAAE,IAAA,uBAAc,EAA8B;QACxD,EAAE,EAAE,gCAAgC;QACpC,IAAI,EAAE;YACJ,KAAK,EAAE,eAAe;YACtB,WAAW,EACT,iGAAiG;SACpG;QACD,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB,CAAC;IACF,UAAU,EAAE,IAAA,uBAAc,EAA4B;QACpD,EAAE,EAAE,8BAA8B;QAClC,IAAI,EAAE;YACJ,KAAK,EAAE,aAAa;YACpB,WAAW,EACT,+GAA+G;SAClH;QACD,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB,CAAC;IACF,MAAM,EAAE,IAAA,uBAAc,EAAwB;QAC5C,EAAE,EAAE,0BAA0B;QAC9B,IAAI,EAAE;YACJ,0EAA0E;YAC1E,KAAK,EAAE,QAAQ;YACf,WAAW,EACT,6HAA6H;SAChI;QACD,IAAI,EAAE,CAAC,SAAS,CAAC;KAClB,CAAC;IACF,KAAK,EAAE,gCAAa;IACpB,KAAK,EAAE,8BAAa;CACrB,CAAC"}

package/dist/globals/globalTags.d.ts

@@ -0,0 +1,9 @@
+export declare const globalTags: {
+    system: import("../defs").ITag<{
+        metadata?: Record<string, any>;
+    }, void, void>;
+    excludeFromGlobalHooks: import("../defs").ITag<{
+        metadata?: Record<string, any>;
+    }, void, void>;
+    debug: import("../defs").ITag<import("./resources/debug").DebugFriendlyConfig, void, void>;
+};

package/dist/globals/globalTags.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalTags = void 0;
+const define_1 = require("../define");
+const debug_tag_1 = require("./resources/debug/debug.tag");
+exports.globalTags = {
+    system: (0, define_1.defineTag)({
+        id: "globals.tags.system",
+        meta: {
+            title: "System",
+            description: "System-wide tags. Used for filtering out noise when you're focusing on your application.",
+        },
+    }),
+    excludeFromGlobalHooks: (0, define_1.defineTag)({
+        id: "globals.tags.excludeFromGlobalHooks",
+        meta: {
+            title: "Exclude Event From Global Hooks",
+            description: "Marks events that should not be dispatched to global hooks (on: '*').",
+        },
+    }),
+    debug: debug_tag_1.debugTag,
+};
+//# sourceMappingURL=globalTags.js.map

package/dist/globals/globalTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalTags.js","sourceRoot":"","sources":["../../src/globals/globalTags.ts"],"names":[],"mappings":";;;AAAA,sCAAsC;AAEtC,2DAAuD;AAE1C,QAAA,UAAU,GAAG;IACxB,MAAM,EAAE,IAAA,kBAAS,EAEd;QACD,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE;YACJ,KAAK,EAAE,QAAQ;YACf,WAAW,EACT,0FAA0F;SAC7F;KACF,CAAC;IACF,sBAAsB,EAAE,IAAA,kBAAS,EAE9B;QACD,EAAE,EAAE,qCAAqC;QACzC,IAAI,EAAE;YACJ,KAAK,EAAE,iCAAiC;YACxC,WAAW,EACT,uEAAuE;SAC1E;KACF,CAAC;IACF,KAAK,EAAE,oBAAQ;CAChB,CAAC"}

package/dist/globals/middleware/cache.middleware.d.ts

@@ -4,31 +4,24 @@ export interface ICacheInstance {
     get(key: string): any;
     clear(): void;
 }
-export declare const cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, undefined, any>;
+export declare const cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, any, import("../../defs").TagType[], import("../../defs").TaskMiddlewareAttachmentType[]>;
 type CacheResourceConfig = {
     defaultOptions?: any;
-    /**
-     * This specifies whether the cache handler is async or not (get, set, clear)
-     * This is for speed purposes.
-     */
-    async?: boolean;
 };
 export declare const cacheResource: IResource<CacheResourceConfig, Promise<{
-    map: Map<string | symbol, ICacheInstance>;
-    cacheFactoryTask: (...args: [] | [any]) => Promise<ICacheInstance>;
-    async: boolean | undefined;
+    map: Map<string, ICacheInstance>;
+    cacheFactoryTask: import("../../defs").TaskDependencyWithIntercept<any, Promise<ICacheInstance>>;
     defaultOptions: any;
 }>, {
-    cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, undefined, any>;
-}, any, any>;
-export declare const cacheMiddleware: import("../../defs").IMiddleware<any, {
+    cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, any, import("../../defs").TagType[], import("../../defs").TaskMiddlewareAttachmentType[]>;
+}, any, any, import("../../defs").TagType[], import("../../defs").ResourceMiddlewareAttachmentType[]>;
+export declare const cacheMiddleware: import("../../defs").ITaskMiddleware<any, void, void, {
     cache: IResource<CacheResourceConfig, Promise<{
-        map: Map<string | symbol, ICacheInstance>;
-        cacheFactoryTask: (...args: [] | [any]) => Promise<ICacheInstance>;
-        async: boolean | undefined;
+        map: Map<string, ICacheInstance>;
+        cacheFactoryTask: import("../../defs").TaskDependencyWithIntercept<any, Promise<ICacheInstance>>;
         defaultOptions: any;
     }>, {
-        cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, undefined, any>;
-    }, any, any>;
+        cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, any, import("../../defs").TagType[], import("../../defs").TaskMiddlewareAttachmentType[]>;
+    }, any, any, import("../../defs").TagType[], import("../../defs").ResourceMiddlewareAttachmentType[]>;
 }>;
 export {};