@bluelibs/runner 2.2.3 → 3.0.0

package/dist/examples/registrator-example.d.ts

@@ -0,0 +1,122 @@
+export declare const userPackage: import("../defs").IRegistrator<(import("../defs").IEventDefinition<{
+    userId: string;
+    email: string;
+}> | import("../defs").IResource<void, {
+    createUser: (email: string) => Promise<{
+        id: string;
+        email: string;
+    }>;
+    getUser: (id: string) => Promise<{
+        id: string;
+        email: string;
+    }>;
+}, {}> | import("../defs").ITask<string, Promise<{
+    id: string;
+    email: string;
+}>, {
+    userService: import("../defs").IResource<void, {
+        createUser: (email: string) => Promise<{
+            id: string;
+            email: string;
+        }>;
+        getUser: (id: string) => Promise<{
+            id: string;
+            email: string;
+        }>;
+    }, {}>;
+    userCreatedEvent: import("../defs").IEventDefinition<{
+        userId: string;
+        email: string;
+    }>;
+}, undefined>)[]> & import("../defs").IResource<void, {
+    items: ({
+        createUser: (email: string) => Promise<{
+            id: string;
+            email: string;
+        }>;
+        getUser: (id: string) => Promise<{
+            id: string;
+            email: string;
+        }>;
+    } | ((args_0: string) => Promise<{
+        id: string;
+        email: string;
+    }>) | ((input: {
+        userId: string;
+        email: string;
+    }) => Promise<void>))[];
+}, any>;
+export declare const loggingPackage: import("../defs").IRegistrator<(import("../defs").IEventDefinition<{
+    level: string;
+    message: string;
+}> | import("../defs").IMiddleware<{
+    logEvent: import("../defs").IEventDefinition<{
+        level: string;
+        message: string;
+    }>;
+}> | import("../defs").IResource<void, {
+    info: (message: string) => Promise<void>;
+    error: (message: string) => Promise<void>;
+}, {
+    logEvent: import("../defs").IEventDefinition<{
+        level: string;
+        message: string;
+    }>;
+}>)[]> & import("../defs").IResource<void, {
+    items: ({
+        info: (message: string) => Promise<void>;
+        error: (message: string) => Promise<void>;
+    } | ((input: {
+        level: string;
+        message: string;
+    }) => Promise<void>))[];
+}, any>;
+export declare const emailPackage: import("../defs").IRegistrator<(import("../defs").IEventDefinition<{
+    to: string;
+    subject: string;
+}> | import("../defs").IResource<void, {
+    sendEmail: (to: string, subject: string, body: string) => Promise<{
+        messageId: string;
+    }>;
+}, {
+    emailSentEvent: import("../defs").IEventDefinition<{
+        to: string;
+        subject: string;
+    }>;
+}> | import("../defs").ITask<undefined, Promise<{
+    messageId: string;
+}>, {
+    emailService: import("../defs").IResource<void, {
+        sendEmail: (to: string, subject: string, body: string) => Promise<{
+            messageId: string;
+        }>;
+    }, {
+        emailSentEvent: import("../defs").IEventDefinition<{
+            to: string;
+            subject: string;
+        }>;
+    }>;
+}, import("../defs").IEventDefinition<{
+    userId: string;
+    email: string;
+}>>)[]> & import("../defs").IResource<void, {
+    items: ({
+        sendEmail: (to: string, subject: string, body: string) => Promise<{
+            messageId: string;
+        }>;
+    } | ((input: {
+        to: string;
+        subject: string;
+    }) => Promise<void>))[];
+}, any>;
+declare function demonstrateRegistrators(): Promise<{
+    createUser: (args_0: string) => Promise<{
+        id: string;
+        email: string;
+    }>;
+    logger: {
+        info: (message: string) => Promise<void>;
+        error: (message: string) => Promise<void>;
+    };
+}>;
+export { demonstrateRegistrators };

package/dist/examples/registrator-example.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emailPackage = exports.loggingPackage = exports.userPackage = void 0;
+exports.demonstrateRegistrators = demonstrateRegistrators;
+const __1 = require("../");
+// === USER MANAGEMENT PACKAGE ===
+const userCreatedEvent = (0, __1.event)({
+    id: "user.events.created",
+});
+const userService = (0, __1.resource)({
+    id: "user.services.user",
+    init: async () => ({
+        createUser: async (email) => ({ id: "123", email }),
+        getUser: async (id) => ({ id, email: "user@example.com" }),
+    }),
+});
+const createUserTask = (0, __1.task)({
+    id: "user.tasks.create",
+    dependencies: {
+        userService,
+        userCreatedEvent,
+    },
+    run: async (email, deps) => {
+        const user = await deps.userService.createUser(email);
+        await deps.userCreatedEvent({ userId: user.id, email: user.email });
+        return user;
+    },
+});
+// BEFORE: Had to create a resource just for registration
+const userPackageOldWay = (0, __1.resource)({
+    id: "user.package.old",
+    register: [userService, createUserTask, userCreatedEvent],
+    // No init logic needed, just grouping items together
+});
+// AFTER: Much cleaner with registrator
+exports.userPackage = (0, __1.registrator)([
+    userService,
+    createUserTask,
+    userCreatedEvent,
+]);
+// === LOGGING PACKAGE ===
+const logEvent = (0, __1.event)({
+    id: "logging.events.log",
+});
+const logMiddleware = (0, __1.middleware)({
+    id: "logging.middleware.taskLogger",
+    dependencies: { logEvent },
+    run: async (data, deps) => {
+        await deps.logEvent({
+            level: "info",
+            message: `Task ${data.taskDefinition?.id} starting`,
+        });
+        const result = await data.next(data.input);
+        await deps.logEvent({
+            level: "info",
+            message: `Task ${data.taskDefinition?.id} completed`,
+        });
+        return result;
+    },
+});
+const loggerService = (0, __1.resource)({
+    id: "logging.services.logger",
+    dependencies: { logEvent },
+    init: async (_, deps) => {
+        // Listen to all log events
+        return {
+            info: (message) => deps.logEvent({ level: "info", message }),
+            error: (message) => deps.logEvent({ level: "error", message }),
+        };
+    },
+});
+exports.loggingPackage = (0, __1.registrator)([
+    logEvent,
+    logMiddleware,
+    loggerService,
+]);
+// === EMAIL PACKAGE ===
+const emailSentEvent = (0, __1.event)({
+    id: "email.events.sent",
+});
+const emailService = (0, __1.resource)({
+    id: "email.services.mailer",
+    dependencies: { emailSentEvent },
+    init: async (_, deps) => ({
+        sendEmail: async (to, subject, body) => {
+            console.log(`Sending email to ${to}: ${subject}`);
+            await deps.emailSentEvent({ to, subject });
+            return { messageId: "msg-123" };
+        },
+    }),
+});
+const sendWelcomeEmailTask = (0, __1.task)({
+    id: "email.tasks.sendWelcome",
+    dependencies: { emailService },
+    on: userCreatedEvent, // Listen to user creation
+    run: async (event, deps) => {
+        const { userId, email } = event.data;
+        return deps.emailService.sendEmail(email, "Welcome!", `Welcome user ${userId}!`);
+    },
+});
+exports.emailPackage = (0, __1.registrator)([
+    emailSentEvent,
+    emailService,
+    sendWelcomeEmailTask,
+]);
+// === MAIN APPLICATION ===
+// Core system services
+const coreServices = (0, __1.registrator)([
+    exports.loggingPackage,
+    // Could add database, cache, config, etc.
+]);
+// Business logic packages
+const businessPackages = (0, __1.registrator)([
+    exports.userPackage,
+    exports.emailPackage,
+    // Could add order, payment, inventory packages, etc.
+]);
+// Main application
+const app = (0, __1.resource)({
+    id: "app",
+    register: [coreServices, businessPackages],
+    dependencies: {
+        createUserTask,
+        loggerService,
+    },
+    async init(_, deps) {
+        await deps.loggerService.info("Application starting...");
+        // Create a test user to demonstrate the system
+        const user = await deps.createUserTask("john@example.com");
+        await deps.loggerService.info(`Application ready! Created user: ${user.id}`);
+        return {
+            createUser: deps.createUserTask,
+            logger: deps.loggerService,
+        };
+    },
+});
+// === DEMONSTRATION ===
+async function demonstrateRegistrators() {
+    console.log("=== Registrator Example ===\n");
+    const appInstance = await (0, __1.run)(app);
+    console.log("\nCreating another user...");
+    const newUser = await appInstance.createUser("jane@example.com");
+    console.log(`\nUser created: ${JSON.stringify(newUser)}`);
+    console.log("\nCheck the logs above to see the middleware and event system in action!");
+    return appInstance;
+}
+//# sourceMappingURL=registrator-example.js.map

package/dist/examples/registrator-example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registrator-example.js","sourceRoot":"","sources":["../../src/examples/registrator-example.ts"],"names":[],"mappings":";;;AA0LS,0DAAuB;AA1LhC,2BAA0E;AAE1E,kCAAkC;AAElC,MAAM,gBAAgB,GAAG,IAAA,SAAK,EAAoC;IAChE,EAAE,EAAE,qBAAqB;CAC1B,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,YAAQ,EAAC;IAC3B,EAAE,EAAE,oBAAoB;IACxB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACjB,UAAU,EAAE,KAAK,EAAE,KAAa,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC3D,OAAO,EAAE,KAAK,EAAE,EAAU,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC;KACnE,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAA,QAAI,EAAC;IAC1B,EAAE,EAAE,mBAAmB;IACvB,YAAY,EAAE;QACZ,WAAW;QACX,gBAAgB;KACjB;IACD,GAAG,EAAE,KAAK,EAAE,KAAa,EAAE,IAAI,EAAE,EAAE;QACjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC,CAAC;AAEH,yDAAyD;AACzD,MAAM,iBAAiB,GAAG,IAAA,YAAQ,EAAC;IACjC,EAAE,EAAE,kBAAkB;IACtB,QAAQ,EAAE,CAAC,WAAW,EAAE,cAAc,EAAE,gBAAgB,CAAC;IACzD,qDAAqD;CACtD,CAAC,CAAC;AAEH,uCAAuC;AAC1B,QAAA,WAAW,GAAG,IAAA,eAAW,EAAC;IACrC,WAAW;IACX,cAAc;IACd,gBAAgB;CACjB,CAAC,CAAC;AAEH,0BAA0B;AAE1B,MAAM,QAAQ,GAAG,IAAA,SAAK,EAAqC;IACzD,EAAE,EAAE,oBAAoB;CACzB,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,IAAA,cAAU,EAAC;IAC/B,EAAE,EAAE,+BAA+B;IACnC,YAAY,EAAE,EAAE,QAAQ,EAAE;IAC1B,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QACxB,MAAM,IAAI,CAAC,QAAQ,CAAC;YAClB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,QAAQ,IAAI,CAAC,cAAc,EAAE,EAAE,WAAW;SACpD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAE3C,MAAM,IAAI,CAAC,QAAQ,CAAC;YAClB,KAAK,EAAE,MAAM;YACb,OAAO,EAAE,QAAQ,IAAI,CAAC,cAAc,EAAE,EAAE,YAAY;SACrD,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC,CAAC;AAEH,MAAM,aAAa,GAAG,IAAA,YAAQ,EAAC;IAC7B,EAAE,EAAE,yBAAyB;IAC7B,YAAY,EAAE,EAAE,QAAQ,EAAE;IAC1B,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACtB,2BAA2B;QAC3B,OAAO;YACL,IAAI,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YACpE,KAAK,EAAE,CAAC,OAAe,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;SACvE,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEU,QAAA,cAAc,GAAG,IAAA,eAAW,EAAC;IACxC,QAAQ;IACR,aAAa;IACb,aAAa;CACd,CAAC,CAAC;AAEH,wBAAwB;AAExB,MAAM,cAAc,GAAG,IAAA,SAAK,EAAkC;IAC5D,EAAE,EAAE,mBAAmB;CACxB,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,IAAA,YAAQ,EAAC;IAC5B,EAAE,EAAE,uBAAuB;IAC3B,YAAY,EAAE,EAAE,cAAc,EAAE;IAChC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QACxB,SAAS,EAAE,KAAK,EAAE,EAAU,EAAE,OAAe,EAAE,IAAY,EAAE,EAAE;YAC7D,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,KAAK,OAAO,EAAE,CAAC,CAAC;YAClD,MAAM,IAAI,CAAC,cAAc,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;YAC3C,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAClC,CAAC;KACF,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,oBAAoB,GAAG,IAAA,QAAI,EAAC;IAChC,EAAE,EAAE,yBAAyB;IAC7B,YAAY,EAAE,EAAE,YAAY,EAAE;IAC9B,EAAE,EAAE,gBAAgB,EAAE,0BAA0B;IAChD,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QACzB,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;QACrC,OAAO,IAAI,CAAC,YAAY,CAAC,SAAS,CAChC,KAAK,EACL,UAAU,EACV,gBAAgB,MAAM,GAAG,CAC1B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEU,QAAA,YAAY,GAAG,IAAA,eAAW,EAAC;IACtC,cAAc;IACd,YAAY;IACZ,oBAAoB;CACrB,CAAC,CAAC;AAEH,2BAA2B;AAE3B,uBAAuB;AACvB,MAAM,YAAY,GAAG,IAAA,eAAW,EAAC;IAC/B,sBAAc;IACd,0CAA0C;CAC3C,CAAC,CAAC;AAEH,0BAA0B;AAC1B,MAAM,gBAAgB,GAAG,IAAA,eAAW,EAAC;IACnC,mBAAW;IACX,oBAAY;IACZ,qDAAqD;CACtD,CAAC,CAAC;AAEH,mBAAmB;AACnB,MAAM,GAAG,GAAG,IAAA,YAAQ,EAAC;IACnB,EAAE,EAAE,KAAK;IACT,QAAQ,EAAE,CAAC,YAAY,EAAE,gBAAgB,CAAC;IAC1C,YAAY,EAAE;QACZ,cAAc;QACd,aAAa;KACd;IACD,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI;QAChB,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAEzD,+CAA+C;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,kBAAkB,CAAC,CAAC;QAE3D,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAC3B,oCAAoC,IAAI,CAAC,EAAE,EAAE,CAC9C,CAAC;QAEF,OAAO;YACL,UAAU,EAAE,IAAI,CAAC,cAAc;YAC/B,MAAM,EAAE,IAAI,CAAC,aAAa;SAC3B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,wBAAwB;AAExB,KAAK,UAAU,uBAAuB;IACpC,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAE7C,MAAM,WAAW,GAAG,MAAM,IAAA,OAAG,EAAC,GAAG,CAAC,CAAC;IAEnC,OAAO,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAC;IAEjE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CACT,0EAA0E,CAC3E,CAAC;IAEF,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/globals/globalEvents.d.ts

@@ -0,0 +1,41 @@
+import { ITask, IResource } from "../defs";
+import { ILog } from "../models/Logger";
+export declare const globalEvents: {
+    beforeInit: import("../defs").IEventDefinition<any>;
+    afterInit: import("../defs").IEventDefinition<any>;
+    log: import("../defs").IEventDefinition<ILog>;
+    tasks: {
+        beforeRun: import("../defs").IEventDefinition<{
+            task: ITask<any, any, any>;
+            input: any;
+        }>;
+        afterRun: import("../defs").IEventDefinition<{
+            task: ITask<any, any, any>;
+            input: any;
+            output: any;
+            setOutput: (newOutput: any) => void;
+        }>;
+        onError: import("../defs").IEventDefinition<{
+            error: any;
+            suppress: () => void;
+            task: ITask<any, any, any>;
+        }>;
+    };
+    resources: {
+        beforeInit: import("../defs").IEventDefinition<{
+            resource: IResource<any, any, any>;
+            config: any;
+        }>;
+        afterInit: import("../defs").IEventDefinition<{
+            resource: IResource<any, any, any>;
+            config: any;
+            value: any;
+        }>;
+        onError: import("../defs").IEventDefinition<{
+            error: Error;
+            suppress: () => void;
+            resource: IResource<any, any, any>;
+        }>;
+    };
+};
+export declare const globalEventsArray: import("../defs").IEventDefinition<any>[];

package/dist/globals/globalEvents.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalEventsArray = exports.globalEvents = void 0;
+const define_1 = require("../define");
+exports.globalEvents = {
+    beforeInit: (0, define_1.defineEvent)({
+        id: "globals.events.beforeInit",
+        meta: {
+            title: "Before Initialization",
+            description: "Triggered before any resource or system-wide initialization occurs.",
+            tags: ["system"],
+        },
+    }),
+    afterInit: (0, define_1.defineEvent)({
+        id: "globals.events.afterInit",
+        meta: {
+            title: "After Initialization",
+            description: "Fired after the system or resource initialization is completed.",
+            tags: ["system"],
+        },
+    }),
+    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,
+];
+//# sourceMappingURL=globalEvents.js.map

package/dist/globals/globalEvents.js.map

@@ -0,0 +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"}

package/dist/globals/globalMiddleware.d.ts

@@ -0,0 +1,23 @@
+import { Context } from "../context";
+/**
+ * Global middlewares
+ */
+export declare const globalMiddlewares: {
+    requireContext: import("../defs").IMiddleware<{
+        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;
+        }, {
+            map: Map<string, 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>;
+    }>;
+};

package/dist/globals/globalMiddleware.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.globalMiddlewares = void 0;
+const cache_middleware_1 = require("./middleware/cache.middleware");
+const requireContext_middleware_1 = require("./middleware/requireContext.middleware");
+const retry_middleware_1 = require("./middleware/retry.middleware");
+/**
+ * Global middlewares
+ */
+exports.globalMiddlewares = {
+    requireContext: requireContext_middleware_1.requireContextMiddleware,
+    retry: retry_middleware_1.retryMiddleware,
+    cache: cache_middleware_1.cacheMiddleware,
+};
+//# sourceMappingURL=globalMiddleware.js.map

package/dist/globals/globalMiddleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"globalMiddleware.js","sourceRoot":"","sources":["../../src/globals/globalMiddleware.ts"],"names":[],"mappings":";;;AAEA,oEAAgE;AAChE,sFAAkF;AAClF,oEAAgE;AAEhE;;GAEG;AACU,QAAA,iBAAiB,GAAG;IAC/B,cAAc,EAAE,oDAAwB;IACxC,KAAK,EAAE,kCAAe;IACtB,KAAK,EAAE,kCAAe;CACvB,CAAC"}

package/dist/globals/globalResources.d.ts

@@ -0,0 +1,27 @@
+import { EventManager } from "../models/EventManager";
+import { Logger } from "../models/Logger";
+import { Store } from "../models/Store";
+import { TaskRunner } from "../models/TaskRunner";
+export declare const globalResources: {
+    store: import("../defs").IResource<Store, Store, {}, any>;
+    eventManager: import("../defs").IResource<EventManager, EventManager, {}, any>;
+    taskRunner: import("../defs").IResource<TaskRunner, TaskRunner, {}, any>;
+    logger: import("../defs").IResource<Logger, Logger, {}, any>;
+    cache: import("../defs").IResource<{
+        defaultOptions?: any;
+        async?: boolean;
+    }, {
+        map: Map<string, 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>;
+    queue: import("../defs").IResource<void, {
+        map: Map<string, import("..").Queue>;
+        run: <T>(id: string, task: (signal: AbortSignal) => Promise<T>) => Promise<T>;
+    }, {}, {
+        map: Map<string, import("..").Queue>;
+    }>;
+};

package/dist/globals/globalResources.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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 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"],
+    },
+});
+exports.globalResources = {
+    store,
+    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"],
+        },
+    }),
+    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"],
+        },
+    }),
+    logger: (0, define_1.defineResource)({
+        id: "globals.resources.logger",
+        init: async (logger) => logger,
+        meta: {
+            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.",
+        },
+    }),
+    cache: cache_middleware_1.cacheResource,
+    queue: queue_resource_1.queueResource,
+};
+//# sourceMappingURL=globalResources.js.map

package/dist/globals/globalResources.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,34 @@
+import { IResource, ITask } from "../../defs";
+export interface ICacheInstance {
+    set(key: string, value: any): void;
+    get(key: string): any;
+    clear(): void;
+}
+export declare const cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, undefined>;
+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, {
+    map: Map<string, ICacheInstance>;
+    cacheFactoryTask: (...args: [] | [any]) => Promise<ICacheInstance>;
+    async: boolean | undefined;
+    defaultOptions: any;
+}, {
+    cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, undefined>;
+}, any>;
+export declare const cacheMiddleware: import("../../defs").IMiddleware<any, {
+    cache: IResource<CacheResourceConfig, {
+        map: Map<string, ICacheInstance>;
+        cacheFactoryTask: (...args: [] | [any]) => Promise<ICacheInstance>;
+        async: boolean | undefined;
+        defaultOptions: any;
+    }, {
+        cacheFactoryTask: ITask<any, Promise<ICacheInstance>, any, undefined>;
+    }, any>;
+}>;
+export {};

package/dist/globals/middleware/cache.middleware.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheMiddleware = exports.cacheResource = exports.cacheFactoryTask = void 0;
+const define_1 = require("../../define");
+const lru_cache_1 = require("lru-cache");
+// Default cache factory task that can be overridden
+exports.cacheFactoryTask = (0, define_1.defineTask)({
+    id: "globals.tasks.cacheFactory",
+    run: async (options) => {
+        return new lru_cache_1.LRUCache(options);
+    },
+});
+exports.cacheResource = (0, define_1.defineResource)({
+    id: "globals.resources.cache",
+    register: [exports.cacheFactoryTask],
+    dependencies: {
+        cacheFactoryTask: exports.cacheFactoryTask,
+    },
+    init: async (config, { cacheFactoryTask }) => {
+        return {
+            map: new Map(),
+            cacheFactoryTask,
+            async: config.async,
+            defaultOptions: {
+                ttl: 10 * 1000,
+                max: 100, // Maximum number of items in cache
+                ttlAutopurge: true, // Automatically purge expired items
+                ...config.defaultOptions,
+            },
+        };
+    },
+    dispose: async (cache) => {
+        for (const cacheInstance of cache.map.values()) {
+            await cacheInstance.clear();
+        }
+    },
+});
+const defaultKeyBuilder = (taskId, input) => `${taskId}-${JSON.stringify(input)}`;
+exports.cacheMiddleware = (0, define_1.defineMiddleware)({
+    id: "globals.middleware.cache",
+    dependencies: { cache: exports.cacheResource },
+    async run({ task, resource, next }, deps, config) {
+        const { cache } = deps;
+        config = {
+            keyBuilder: defaultKeyBuilder,
+            ttl: 10 * 1000,
+            max: 100, // Maximum number of items in cache
+            ttlAutopurge: true, // Automatically purge expired items
+            ...config,
+        };
+        if (!task) {
+            throw new Error("Cache middleware can only be used in tasks");
+        }
+        const taskId = task.definition.id;
+        const isAsync = cache.async;
+        let cacheHolderForTask = cache.map.get(taskId);
+        if (!cacheHolderForTask) {
+            // Extract only LRUCache options, excluding keyBuilder
+            const { keyBuilder, ...lruOptions } = config;
+            const cacheOptions = {
+                ...cache.defaultOptions,
+                ...lruOptions,
+            };
+            // Use the factory task to create the cache instance
+            cacheHolderForTask = await cache.cacheFactoryTask(cacheOptions);
+            cache.map.set(taskId, cacheHolderForTask);
+        }
+        const key = config.keyBuilder(taskId, task.input);
+        const cachedValue = isAsync
+            ? await cacheHolderForTask.get(key)
+            : cacheHolderForTask.get(key);
+        if (cachedValue) {
+            return cachedValue;
+        }
+        const result = await next(task.input);
+        if (isAsync) {
+            await cacheHolderForTask.set(key, result);
+        }
+        else {
+            cacheHolderForTask.set(key, result);
+        }
+        return result;
+    },
+});
+//# sourceMappingURL=cache.middleware.js.map