@acmekit/event-bus-redis 2.13.1

package/README.md

@@ -0,0 +1,79 @@
+<p align="center">
+  <a href="https://www.acmekit.com">
+    <img alt="AcmeKit" src="https://user-images.githubusercontent.com/7554214/153162406-bf8fd16f-aa98-4604-b87b-e13ab4baf604.png" width="100" />
+  </a>
+</p>
+<h1 align="center">
+  @acmekit/event-bus-redis
+</h1>
+
+<h4 align="center">
+  <a href="https://docs.acmekit.com">Documentation</a> |
+  <a href="https://www.acmekit.com">Website</a>
+</h4>
+
+<p align="center">
+An open source composable commerce engine built for developers.
+</p>
+<p align="center">
+  <a href="https://github.com/acmekit/acmekit/blob/master/LICENSE">
+    <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="AcmeKit is released under the MIT license." />
+  </a>
+  <a href="https://circleci.com/gh/acmekit/acmekit">
+    <img src="https://circleci.com/gh/acmekit/acmekit.svg?style=shield" alt="Current CircleCI build status." />
+  </a>
+  <a href="https://github.com/acmekit/acmekit/blob/master/CONTRIBUTING.md">
+    <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat" alt="PRs welcome!" />
+  </a>
+    <a href="https://www.producthunt.com/posts/acmekit"><img src="https://img.shields.io/badge/Product%20Hunt-%231%20Product%20of%20the%20Day-%23DA552E" alt="Product Hunt"></a>
+  <a href="https://discord.gg/xpCwq3Kfn8">
+    <img src="https://img.shields.io/badge/chat-on%20discord-7289DA.svg" alt="Discord Chat" />
+  </a>
+  <a href="https://twitter.com/intent/follow?screen_name=acmekit">
+    <img src="https://img.shields.io/twitter/follow/acmekit.svg?label=Follow%20@acmekit" alt="Follow @acmekit" />
+  </a>
+</p>
+
+## Overview
+
+Redis Event Bus module for AcmeKit. When installed, the events system of AcmeKit is powered by BullMQ and `io-redis`. BullMQ is responsible for the message queue and worker. `io-redis` is the underlying Redis client, that BullMQ connects to for events storage.
+
+## Getting started
+
+Install the module:
+
+```bash
+yarn add @acmekit/event-bus-redis
+```
+
+Add the module to your `acmekit-config.js`:
+
+```js
+module.exports = {
+  // ...
+  modules: [
+    {
+      resolve: "@acmekit/event-bus-redis",
+      options: {
+        redisUrl: "redis:..",
+      },
+    },
+  ],
+  // ...
+}
+```
+
+## Configuration
+
+The module can be configured with the following options:
+
+| Option         | Type      | Description                                                                                                              | Default         |
+| -------------- | --------- | ------------------------------------------------------------------------------------------------------------------------ | --------------- |
+| `redisUrl`     | `string`  | URL of the Redis instance to connect to.                                                                                 | `events-worker` |
+| `queueName`    | `string?` | Name of the BullMQ queue.                                                                                                | `events-queue`  |
+| `queueOptions` | `object?` | Options for the BullMQ queue. See BullMQ's [documentation](https://api.docs.bullmq.io/interfaces/QueueOptions.html).     | `{}`            |
+| `redisOptions` | `object?` | Options for the Redis instance. See `io-redis`'s [documentation](https://luin.github.io/ioredis/index.html#RedisOptions) | `{}`            |
+
+**Info**: See how the options are applied in the [RedisEventBusService](https://github.com/acmekit/acmekit/blob/0c1d1d590463fa30b083c4312293348bdf6596be/packages/event-bus-redis/src/services/event-bus-redis.ts#L52) and [loader](https://github.com/acmekit/acmekit/blob/0c1d1d590463fa30b083c4312293348bdf6596be/packages/event-bus-redis/src/loaders/index.ts).
+
+If you do not provide a `redisUrl` in the module options, the server will fail to start.

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { ModuleExports } from "@acmekit/framework/types";
+declare const moduleDefinition: ModuleExports;
+export default moduleDefinition;
+export * from "./initialize";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AAOxD,QAAA,MAAM,gBAAgB,EAAE,aAGvB,CAAA;AAED,eAAe,gBAAgB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const loaders_1 = __importDefault(require("./loaders"));
+const event_bus_redis_1 = __importDefault(require("./services/event-bus-redis"));
+const service = event_bus_redis_1.default;
+const loaders = [loaders_1.default];
+const moduleDefinition = {
+    service,
+    loaders,
+};
+exports.default = moduleDefinition;
+__exportStar(require("./initialize"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;AACA,wDAA8B;AAC9B,iFAA6D;AAE7D,MAAM,OAAO,GAAG,yBAAoB,CAAA;AACpC,MAAM,OAAO,GAAG,CAAC,iBAAM,CAAC,CAAA;AAExB,MAAM,gBAAgB,GAAkB;IACtC,OAAO;IACP,OAAO;CACR,CAAA;AAED,kBAAe,gBAAgB,CAAA;AAC/B,+CAA4B;AAC5B,0CAAuB"}

package/dist/initialize/index.d.ts

@@ -0,0 +1,4 @@
+import { ExternalModuleDeclaration, IEventBusService } from "@acmekit/framework/types";
+import { EventBusRedisModuleOptions } from "../types";
+export declare const initialize: (options?: EventBusRedisModuleOptions | ExternalModuleDeclaration) => Promise<IEventBusService>;
+//# sourceMappingURL=index.d.ts.map

package/dist/initialize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/initialize/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,EACzB,gBAAgB,EAEjB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAA;AAErD,eAAO,MAAM,UAAU,GACrB,UAAU,0BAA0B,GAAG,yBAAyB,KAC/D,OAAO,CAAC,gBAAgB,CAW1B,CAAA"}

package/dist/initialize/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initialize = void 0;
+const modules_sdk_1 = require("@acmekit/framework/modules-sdk");
+const utils_1 = require("@acmekit/framework/utils");
+const initialize = async (options) => {
+    const serviceKey = utils_1.Modules.EVENT_BUS;
+    const loaded = await modules_sdk_1.AcmeKitModule.bootstrap({
+        moduleKey: serviceKey,
+        defaultPath: "@acmekit/event-bus-redis",
+        declaration: options,
+    });
+    return loaded[serviceKey];
+};
+exports.initialize = initialize;
+//# sourceMappingURL=index.js.map

package/dist/initialize/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/initialize/index.ts"],"names":[],"mappings":";;;AAAA,gEAA8D;AAM9D,oDAAkD;AAG3C,MAAM,UAAU,GAAG,KAAK,EAC7B,OAAgE,EACrC,EAAE;IAC7B,MAAM,UAAU,GAAG,eAAO,CAAC,SAAS,CAAA;IACpC,MAAM,MAAM,GAAG,MAAM,2BAAa,CAAC,SAAS,CAAmB;QAC7D,SAAS,EAAE,UAAU;QACrB,WAAW,EAAE,0BAA0B;QACvC,WAAW,EAAE,OAEgB;KAC9B,CAAC,CAAA;IAEF,OAAO,MAAM,CAAC,UAAU,CAAC,CAAA;AAC3B,CAAC,CAAA;AAbY,QAAA,UAAU,cAatB"}

package/dist/loaders/index.d.ts

@@ -0,0 +1,4 @@
+import { LoaderOptions } from "@acmekit/framework/types";
+declare const _default: ({ container, logger, options, }: LoaderOptions) => Promise<void>;
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/loaders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;yBAKlC,iCAInB,aAAa,KAAG,OAAO,CAAC,IAAI,CAAC;AAJhC,wBA+CC"}

package/dist/loaders/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const awilix_1 = require("@acmekit/framework/awilix");
+const ioredis_1 = __importDefault(require("ioredis"));
+const os_1 = require("os");
+exports.default = async ({ container, logger, options, }) => {
+    const { redisUrl, redisOptions, queueName, queueOptions, workerOptions, jobOptions, } = options;
+    if (!redisUrl) {
+        throw Error("No `redisUrl` provided in project config. It is required for the Redis Event Bus.");
+    }
+    const connection = new ioredis_1.default(redisUrl, {
+        // Required config. See: https://github.com/OptimalBits/bull/blob/develop/CHANGELOG.md#breaking-changes
+        maxRetriesPerRequest: null,
+        enableReadyCheck: false,
+        // Lazy connect to properly handle connection errors
+        lazyConnect: true,
+        ...(redisOptions ?? {}),
+    });
+    try {
+        await new Promise(async (resolve) => {
+            await connection.connect(resolve);
+        });
+        logger?.info(`Connection to Redis in module 'event-bus-redis' established`);
+    }
+    catch (err) {
+        logger?.error(`An error occurred while connecting to Redis in module 'event-bus-redis':${os_1.EOL} ${err}`);
+    }
+    container.register({
+        eventBusRedisConnection: (0, awilix_1.asValue)(connection),
+        eventBusRedisQueueName: (0, awilix_1.asValue)(queueName ?? "events-queue"),
+        eventBusRedisQueueOptions: (0, awilix_1.asValue)(queueOptions ?? {}),
+        eventBusRedisWorkerOptions: (0, awilix_1.asValue)(workerOptions ?? {}),
+        eventBusRedisJobOptions: (0, awilix_1.asValue)(jobOptions ?? {}),
+    });
+};
+//# sourceMappingURL=index.js.map

package/dist/loaders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/loaders/index.ts"],"names":[],"mappings":";;;;;AAAA,sDAAmD;AAEnD,sDAA2B;AAC3B,2BAAwB;AAGxB,kBAAe,KAAK,EAAE,EACpB,SAAS,EACT,MAAM,EACN,OAAO,GACO,EAAiB,EAAE;IACjC,MAAM,EACJ,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,aAAa,EACb,UAAU,GACX,GAAG,OAAqC,CAAA;IAEzC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,KAAK,CACT,mFAAmF,CACpF,CAAA;IACH,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,iBAAK,CAAC,QAAQ,EAAE;QACrC,uGAAuG;QACvG,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EAAE,KAAK;QACvB,oDAAoD;QACpD,WAAW,EAAE,IAAI;QACjB,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC;KACxB,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAClC,MAAM,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;QACnC,CAAC,CAAC,CAAA;QACF,MAAM,EAAE,IAAI,CAAC,6DAA6D,CAAC,CAAA;IAC7E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,EAAE,KAAK,CACX,2EAA2E,QAAG,IAAI,GAAG,EAAE,CACxF,CAAA;IACH,CAAC;IAED,SAAS,CAAC,QAAQ,CAAC;QACjB,uBAAuB,EAAE,IAAA,gBAAO,EAAC,UAAU,CAAC;QAC5C,sBAAsB,EAAE,IAAA,gBAAO,EAAC,SAAS,IAAI,cAAc,CAAC;QAC5D,yBAAyB,EAAE,IAAA,gBAAO,EAAC,YAAY,IAAI,EAAE,CAAC;QACtD,0BAA0B,EAAE,IAAA,gBAAO,EAAC,aAAa,IAAI,EAAE,CAAC;QACxD,uBAAuB,EAAE,IAAA,gBAAO,EAAC,UAAU,IAAI,EAAE,CAAC;KACnD,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/dist/services/event-bus-redis.d.ts

@@ -0,0 +1,69 @@
+import { InternalModuleDeclaration, Logger, Message } from "@acmekit/framework/types";
+import { AbstractEventBusModuleService } from "@acmekit/framework/utils";
+import { Queue, QueueOptions, Worker, WorkerOptions } from "bullmq";
+import { Redis } from "ioredis";
+import { BullJob, EmitOptions, EventBusRedisModuleOptions, Options } from "../types";
+type InjectedDependencies = {
+    logger: Logger;
+    eventBusRedisConnection: Redis;
+    eventBusRedisQueueName: string;
+    eventBusRedisQueueOptions: Omit<QueueOptions, "connection">;
+    eventBusRedisWorkerOptions: Omit<WorkerOptions, "connection">;
+    eventBusRedisJobOptions: EmitOptions;
+};
+/**
+ * Can keep track of multiple subscribers to different events and run the
+ * subscribers when events happen. Events will run asynchronously.
+ */
+export default class RedisEventBusService extends AbstractEventBusModuleService {
+    protected readonly logger_: Logger;
+    protected readonly eventBusRedisConnection_: Redis;
+    protected readonly queueName_: string;
+    protected readonly queueOptions_: Omit<QueueOptions, "connection">;
+    protected readonly workerOptions_: Omit<WorkerOptions, "connection">;
+    protected readonly jobOptions_: EmitOptions;
+    protected queue_: Queue;
+    protected bullWorker_: Worker;
+    constructor({ logger, eventBusRedisConnection, eventBusRedisQueueName, eventBusRedisQueueOptions, eventBusRedisWorkerOptions, eventBusRedisJobOptions, }: InjectedDependencies, _moduleOptions: EventBusRedisModuleOptions | undefined, _moduleDeclaration: InternalModuleDeclaration);
+    __hooks: {
+        onApplicationStart: () => Promise<void>;
+        onApplicationShutdown: () => Promise<void>;
+        onApplicationPrepareShutdown: () => Promise<void>;
+    };
+    /**
+     * Build events for queue processing with priority handling.
+     *
+     * Priority levels (lower number = higher priority):
+     * - 10: Critical business events (e.g., order placed)
+     * - 100: Default priority for normal events (default)
+     * - 2,097,152: Lowest priority for internal events
+     *
+     * Priority override hierarchy (highest to lowest precedence):
+     * 1. Message-level options (eventData.options.priority)
+     * 2. Emit-level options (options.priority)
+     * 3. Module-level job options (this.jobOptions_.priority)
+     * 4. Internal flag default (options.internal ? EventPriority.LOWEST : EventPriority.DEFAULT)
+     */
+    private buildEvents;
+    /**
+     * Emit a single or number of events
+     * @param eventsData
+     * @param options
+     */
+    emit<T = unknown>(eventsData: Message<T> | Message<T>[], options?: Options): Promise<void>;
+    private setExpire;
+    private groupEvents;
+    private getGroupedEvents;
+    releaseGroupedEvents(eventGroupId: string): Promise<void>;
+    clearGroupedEvents(eventGroupId: string, { eventNames, }?: {
+        eventNames?: string[];
+    }): Promise<void>;
+    /**
+     * Handles incoming jobs.
+     * @param job The job object
+     * @return resolves to the results of the subscriber calls.
+     */
+    worker_: <T>(job: BullJob<T>) => Promise<unknown>;
+}
+export {};
+//# sourceMappingURL=event-bus-redis.d.ts.map

package/dist/services/event-bus-redis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus-redis.d.ts","sourceRoot":"","sources":["../../src/services/event-bus-redis.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,yBAAyB,EACzB,MAAM,EACN,OAAO,EACR,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,6BAA6B,EAI9B,MAAM,0BAA0B,CAAA;AACjC,OAAO,EAEL,KAAK,EACL,YAAY,EACZ,MAAM,EACN,aAAa,EACd,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EACL,OAAO,EACP,WAAW,EACX,0BAA0B,EAC1B,OAAO,EACR,MAAM,UAAU,CAAA;AAEjB,KAAK,oBAAoB,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,uBAAuB,EAAE,KAAK,CAAA;IAC9B,sBAAsB,EAAE,MAAM,CAAA;IAC9B,yBAAyB,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAC3D,0BAA0B,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;IAC7D,uBAAuB,EAAE,WAAW,CAAA;CACrC,CAAA;AAQD;;;GAGG;AAEH,MAAM,CAAC,OAAO,OAAO,oBAAqB,SAAQ,6BAA6B;IAC7E,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAClC,SAAS,CAAC,QAAQ,CAAC,wBAAwB,EAAE,KAAK,CAAA;IAElD,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IACrC,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAClE,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;IACpE,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAA;IAI3C,SAAS,CAAC,MAAM,EAAE,KAAK,CAAA;IACvB,SAAS,CAAC,WAAW,EAAE,MAAM,CAAA;gBAG3B,EACE,MAAM,EACN,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,GACxB,EAAE,oBAAoB,EACvB,cAAc,EAAE,0BAA0B,YAAK,EAC/C,kBAAkB,EAAE,yBAAyB;IAmC/C,OAAO;;;;MAYN;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,WAAW;IAuDnB;;;;OAIG;IACG,IAAI,CAAC,CAAC,GAAG,OAAO,EACpB,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,EACrC,OAAO,GAAE,OAAY,GACpB,OAAO,CAAC,IAAI,CAAC;YA+DF,SAAS;YAQT,WAAW;YAUX,gBAAgB;IAUxB,oBAAoB,CAAC,YAAY,EAAE,MAAM;IA+BzC,kBAAkB,CACtB,YAAY,EAAE,MAAM,EACpB,EACE,UAAU,GACX,GAAE;QACD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;KACjB;IAwCR;;;;OAIG;IACH,OAAO,GAAU,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,OAAO,CAAC,CAsGrD;CACF"}

package/dist/services/event-bus-redis.js

@@ -0,0 +1,296 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const utils_1 = require("@acmekit/framework/utils");
+const bullmq_1 = require("bullmq");
+/**
+ * Can keep track of multiple subscribers to different events and run the
+ * subscribers when events happen. Events will run asynchronously.
+ */
+// eslint-disable-next-line max-len
+class RedisEventBusService extends utils_1.AbstractEventBusModuleService {
+    constructor({ logger, eventBusRedisConnection, eventBusRedisQueueName, eventBusRedisQueueOptions, eventBusRedisWorkerOptions, eventBusRedisJobOptions, }, _moduleOptions = {}, _moduleDeclaration) {
+        // @ts-ignore
+        super(...arguments);
+        this.__hooks = {
+            onApplicationStart: async () => {
+                await this.bullWorker_?.run();
+            },
+            onApplicationShutdown: async () => {
+                await this.queue_.close();
+                // eslint-disable-next-line max-len
+                this.eventBusRedisConnection_.disconnect();
+            },
+            onApplicationPrepareShutdown: async () => {
+                await this.bullWorker_?.close();
+            },
+        };
+        /**
+         * Handles incoming jobs.
+         * @param job The job object
+         * @return resolves to the results of the subscriber calls.
+         */
+        this.worker_ = async (job) => {
+            const { data, name, opts } = job;
+            const eventSubscribers = this.eventToSubscribersMap.get(name) || [];
+            const wildcardSubscribers = this.eventToSubscribersMap.get("*") || [];
+            const allSubscribers = eventSubscribers.concat(wildcardSubscribers);
+            // Pull already completed subscribers from the job data
+            const completedSubscribers = job.data.completedSubscriberIds || [];
+            // Filter out already completed subscribers from the all subscribers
+            const subscribersInCurrentAttempt = allSubscribers.filter((subscriber) => subscriber.id && !completedSubscribers.includes(subscriber.id));
+            const currentAttempt = job.attemptsMade;
+            const isRetry = currentAttempt > 1;
+            const configuredAttempts = job.opts.attempts;
+            const isFinalAttempt = currentAttempt === configuredAttempts;
+            if (!opts.internal) {
+                if (isRetry) {
+                    if (isFinalAttempt) {
+                        this.logger_.info(`Final retry attempt for ${name}`);
+                    }
+                    this.logger_.info(`Retrying ${name} which has ${eventSubscribers.length} subscribers (${subscribersInCurrentAttempt.length} of them failed)`);
+                }
+                else {
+                    const prioirityInfo = opts.priority != undefined ? ` (priority: ${opts.priority})` : "";
+                    this.logger_.info(`Processing ${name}${prioirityInfo} which has ${eventSubscribers.length} subscribers`);
+                }
+            }
+            const completedSubscribersInCurrentAttempt = [];
+            const subscribersResult = await Promise.all(subscribersInCurrentAttempt.map(async ({ id, subscriber }) => {
+                // De-serialize the event data and metadata from a single field into the original format expected by the subscribers
+                const event = {
+                    name,
+                    data: data.data,
+                    metadata: data.metadata,
+                };
+                try {
+                    return await subscriber(event).then((data) => {
+                        // For every subscriber that completes successfully, add their id to the list of completed subscribers
+                        completedSubscribersInCurrentAttempt.push(id);
+                        return data;
+                    });
+                }
+                catch (err) {
+                    this.logger_?.warn(`An error occurred while processing ${name}:`);
+                    this.logger_?.warn(err);
+                    return err;
+                }
+            }));
+            // If the number of completed subscribers is different from the number of subcribers to process in current attempt, some of them failed
+            const didSubscribersFail = completedSubscribersInCurrentAttempt.length !==
+                subscribersInCurrentAttempt.length;
+            const isRetriesConfigured = configuredAttempts > 1;
+            // Therefore, if retrying is configured, we try again
+            const shouldRetry = didSubscribersFail && isRetriesConfigured && !isFinalAttempt;
+            if (shouldRetry) {
+                const updatedCompletedSubscribers = [
+                    ...completedSubscribers,
+                    ...completedSubscribersInCurrentAttempt,
+                ];
+                job.data.completedSubscriberIds = updatedCompletedSubscribers;
+                await job.updateData(job.data);
+                const errorMessage = `One or more subscribers of ${name} failed. Retrying...`;
+                this.logger_.warn(errorMessage);
+                throw Error(errorMessage);
+            }
+            if (didSubscribersFail && !isFinalAttempt) {
+                // If retrying is not configured, we log a warning to allow server admins to recover manually
+                this.logger_.warn(`One or more subscribers of ${name} failed. Retrying is not configured. Use 'attempts' option when emitting events.`);
+            }
+            return subscribersResult;
+        };
+        this.eventBusRedisConnection_ = eventBusRedisConnection;
+        this.logger_ = logger;
+        this.queueName_ = eventBusRedisQueueName ?? "events-queue";
+        this.queueOptions_ = eventBusRedisQueueOptions ?? {};
+        this.workerOptions_ = eventBusRedisWorkerOptions ?? {};
+        this.jobOptions_ = eventBusRedisJobOptions ?? {};
+        // TODO: Comment temporarely and we will re enable it in the near future #14478
+        // this.eventOptions_ =
+        //   _moduleOptions.eventOptions ??
+        //   _moduleDeclaration.options?.eventOptions ??
+        //   {}
+        this.queue_ = new bullmq_1.Queue(this.queueName_, {
+            prefix: `${this.constructor.name}`,
+            ...this.queueOptions_,
+            connection: eventBusRedisConnection,
+        });
+        // Register our worker to handle emit calls
+        if (this.isWorkerMode) {
+            this.bullWorker_ = new bullmq_1.Worker(this.queueName_, this.worker_, {
+                prefix: `${this.constructor.name}`,
+                ...this.workerOptions_,
+                connection: eventBusRedisConnection,
+                autorun: false,
+            });
+        }
+    }
+    /**
+     * Build events for queue processing with priority handling.
+     *
+     * Priority levels (lower number = higher priority):
+     * - 10: Critical business events (e.g., order placed)
+     * - 100: Default priority for normal events (default)
+     * - 2,097,152: Lowest priority for internal events
+     *
+     * Priority override hierarchy (highest to lowest precedence):
+     * 1. Message-level options (eventData.options.priority)
+     * 2. Emit-level options (options.priority)
+     * 3. Module-level job options (this.jobOptions_.priority)
+     * 4. Internal flag default (options.internal ? EventPriority.LOWEST : EventPriority.DEFAULT)
+     */
+    buildEvents(eventsData, options = {}) {
+        const opts = {
+            // default options
+            removeOnComplete: true,
+            attempts: 1,
+            priority: options.internal ? utils_1.EventPriority.LOWEST : utils_1.EventPriority.DEFAULT,
+            // global options
+            ...this.jobOptions_,
+            ...options,
+        };
+        return eventsData.map((eventData) => {
+            // We want to preserve event data + metadata. However, bullmq only allows for a single data field.
+            // Therefore, upon adding jobs to the queue we will serialize the event data and metadata into a single field
+            // and upon processing the job, we will deserialize it back into the original format expected by the subscribers.
+            const event = {
+                data: eventData.data,
+                metadata: eventData.metadata,
+            };
+            const finalOptions = {
+                ...opts,
+                ...eventData.options,
+            };
+            // TODO: Comment temporarely and we will re enable it in the near future #14478
+            // finalOptions.priority =
+            //   eventData.options?.priority ??
+            //   this.eventOptions_[eventData.name]?.priority
+            if (finalOptions.priority != undefined &&
+                (finalOptions.priority < 1 ||
+                    finalOptions.priority > utils_1.EventPriority.LOWEST)) {
+                this.logger_.warn(`Invalid priority value: ${finalOptions.priority} for event ${eventData.name}. Must be between 1 and ${utils_1.EventPriority.LOWEST}`);
+                finalOptions.priority = utils_1.EventPriority.DEFAULT;
+                this.logger_.warn(`Setting priority to default value: ${utils_1.EventPriority.DEFAULT} for event ${eventData.name}`);
+            }
+            return {
+                data: event,
+                name: eventData.name,
+                opts: finalOptions,
+            };
+        });
+    }
+    /**
+     * Emit a single or number of events
+     * @param eventsData
+     * @param options
+     */
+    async emit(eventsData, options = {}) {
+        let eventsDataArray = Array.isArray(eventsData) ? eventsData : [eventsData];
+        const { groupedEventsTTL = 600 } = options;
+        delete options.groupedEventsTTL;
+        const eventsToEmit = eventsDataArray.filter((eventData) => !(0, utils_1.isPresent)(eventData.metadata?.eventGroupId));
+        const eventsToGroup = eventsDataArray.filter((eventData) => (0, utils_1.isPresent)(eventData.metadata?.eventGroupId));
+        const groupEventsMap = new Map();
+        for (const event of eventsToGroup) {
+            const groupId = event.metadata?.eventGroupId;
+            const groupEvents = groupEventsMap.get(groupId) ?? [];
+            groupEvents.push(event);
+            groupEventsMap.set(groupId, groupEvents);
+        }
+        const promises = [];
+        if (eventsToEmit.length) {
+            eventsToEmit.map((eventData) => this.callInterceptors(eventData, { isGrouped: false }));
+            const eventsWithSubscribers = eventsToEmit.filter((eventData) => {
+                const eventSubscribers = this.eventToSubscribersMap.get(eventData.name) || [];
+                const wildcardSubscribers = this.eventToSubscribersMap.get("*") || [];
+                return eventSubscribers.length || wildcardSubscribers.length;
+            });
+            if (eventsWithSubscribers.length) {
+                const emitData = this.buildEvents(eventsWithSubscribers, options);
+                promises.push(this.queue_.addBulk(emitData));
+            }
+        }
+        for (const [groupId, events] of groupEventsMap.entries()) {
+            if (!events?.length) {
+                continue;
+            }
+            // Set a TTL for the key of the list that is scoped to a group
+            // This will be helpful in preventing stale data from staying in redis for too long
+            // in the event the module fails to cleanup events. For long running workflows, setting a much higher
+            // TTL or even skipping the TTL would be required
+            void this.setExpire(groupId, groupedEventsTTL);
+            const eventsData = this.buildEvents(events, options);
+            promises.push(this.groupEvents(groupId, eventsData));
+        }
+        await (0, utils_1.promiseAll)(promises);
+    }
+    async setExpire(eventGroupId, ttl) {
+        if (!eventGroupId) {
+            return;
+        }
+        await this.eventBusRedisConnection_.expire(`staging:${eventGroupId}`, ttl);
+    }
+    async groupEvents(eventGroupId, events) {
+        await this.eventBusRedisConnection_.rpush(`staging:${eventGroupId}`, ...events.map((event) => JSON.stringify(event)));
+    }
+    async getGroupedEvents(eventGroupId) {
+        return await this.eventBusRedisConnection_
+            .lrange(`staging:${eventGroupId}`, 0, -1)
+            .then((result) => {
+            return result.map((jsonString) => JSON.parse(jsonString));
+        });
+    }
+    async releaseGroupedEvents(eventGroupId) {
+        const groupedEvents = await this.getGroupedEvents(eventGroupId);
+        // Call interceptors before emitting grouped events
+        // Extract the original messages from the job data structure
+        groupedEvents.map((jobData) => {
+            const message = {
+                name: jobData.name,
+                data: jobData.data,
+                metadata: jobData.data.metadata,
+            };
+            this.callInterceptors(message, {
+                isGrouped: true,
+                eventGroupId,
+            });
+        });
+        const eventsWithSubscribers = groupedEvents.filter((jobData) => {
+            const eventSubscribers = this.eventToSubscribersMap.get(jobData.name) || [];
+            const wildcardSubscribers = this.eventToSubscribersMap.get("*") || [];
+            return eventSubscribers.length || wildcardSubscribers.length;
+        });
+        if (eventsWithSubscribers.length) {
+            await this.queue_.addBulk(eventsWithSubscribers);
+        }
+        await this.clearGroupedEvents(eventGroupId);
+    }
+    async clearGroupedEvents(eventGroupId, { eventNames, } = {}) {
+        if (!eventGroupId) {
+            return;
+        }
+        if (eventNames?.length) {
+            /**
+             * If any event names are provided, we keep all events except the ones that match the event
+             * names. which allow to partially clear an event group.
+             */
+            const eventsToKeep = await this.eventBusRedisConnection_
+                .lrange(`staging:${eventGroupId}`, 0, -1)
+                .then((result) => {
+                return result
+                    .map((jsonString) => JSON.parse(jsonString))
+                    .filter((event) => !eventNames.includes(event.name));
+            });
+            // Create a pipeline
+            const pipeline = this.eventBusRedisConnection_.pipeline();
+            // Empty the current list
+            pipeline.del(`staging:${eventGroupId}`);
+            // Add the remaining events to the list
+            pipeline.rpush(`staging:${eventGroupId}`, ...eventsToKeep.map((event) => JSON.stringify(event)));
+            await pipeline.exec();
+            return;
+        }
+        await this.eventBusRedisConnection_.unlink(`staging:${eventGroupId}`);
+    }
+}
+exports.default = RedisEventBusService;
+//# sourceMappingURL=event-bus-redis.js.map

package/dist/services/event-bus-redis.js.map

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

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/index.ts","../src/initialize/index.ts","../src/loaders/index.ts","../src/services/event-bus-redis.ts","../src/services/__tests__/event-bus.ts","../src/types/index.ts"],"version":"5.9.3"}

package/dist/types/index.d.ts

@@ -0,0 +1,62 @@
+import { BulkJobOptions, Job, JobsOptions, QueueOptions, WorkerOptions } from "bullmq";
+import { RedisOptions } from "ioredis";
+export type JobData<T> = {
+    eventName: string;
+    data: T;
+    completedSubscriberIds?: string[] | undefined;
+};
+export type Options = BulkJobOptions & {
+    groupedEventsTTL?: number;
+    internal?: boolean;
+};
+export type BullJob<T> = {
+    data: JobData<T>;
+    opts: Job["opts"] & Options;
+} & Job;
+export type EmitOptions = JobsOptions;
+export type EventBusRedisModuleOptions = {
+    /**
+     * Queue name for the event bus
+     */
+    queueName?: string;
+    /**
+     * Options for BullMQ Queue instance
+     * @see https://api.docs.bullmq.io/interfaces/v5.QueueOptions.html
+     */
+    queueOptions?: Omit<QueueOptions, "connection">;
+    /**
+     * Options for BullMQ Worker instance
+     * @see https://api.docs.bullmq.io/interfaces/v5.WorkerOptions.html
+     */
+    workerOptions?: Omit<WorkerOptions, "connection">;
+    /**
+     * Redis connection string
+     */
+    redisUrl?: string;
+    /**
+     * Redis client options
+     */
+    redisOptions?: RedisOptions;
+    /**
+     * Global options passed to all `EventBusService.emit` in the core as well as your own emitters. The options are forwarded to Bull's `Queue.add` method.
+     *
+     * The global options can be overridden by passing options to `EventBusService.emit` directly.
+     *
+     * Example
+     * ```js
+     * {
+     *    removeOnComplete: { age: 10 },
+     * }
+     * ```
+     *
+     * @see https://api.docs.bullmq.io/interfaces/BaseJobOptions.html
+     */
+    jobOptions?: EmitOptions;
+};
+declare module "@acmekit/types" {
+    interface ModuleOptions {
+        "@acmekit/event-bus-redis": EventBusRedisModuleOptions;
+        "@acmekit/acmekit/event-bus-redis": EventBusRedisModuleOptions;
+    }
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,cAAc,EACd,GAAG,EACH,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtC,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,CAAC,CAAA;IACP,sBAAsB,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI;IACvB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;IAChB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAA;CAC5B,GAAG,GAAG,CAAA;AAEP,MAAM,MAAM,WAAW,GAAG,WAAW,CAAA;AAErC,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;IAE/C;;;OAGG;IACH,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAA;IAEjD;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,YAAY,CAAC,EAAE,YAAY,CAAA;IAE3B;;;;;;;;;;;;;OAaG;IACH,UAAU,CAAC,EAAE,WAAW,CAAA;CAGzB,CAAA;AAED,OAAO,QAAQ,gBAAgB,CAAC;IAC9B,UAAU,aAAa;QACrB,0BAA0B,EAAE,0BAA0B,CAAA;QACtD,kCAAkC,EAAE,0BAA0B,CAAA;KAC/D;CACF"}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+"use strict";
+// TODO: Comment temporarely and we will re enable it in the near future #14478
+// import type { EventBusEventsOptions } from "@acmekit/types"
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,8DAA8D"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@acmekit/event-bus-redis",
+  "version": "2.13.1",
+  "description": "Redis Event Bus Module for AcmeKit",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "!dist/**/__tests__",
+    "!dist/**/__mocks__",
+    "!dist/**/__fixtures__"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/acmekit/acmekit",
+    "directory": "packages/modules/event-bus-redis"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "author": "AcmeKit",
+  "license": "MIT",
+  "devDependencies": {
+    "@acmekit/framework": "2.13.1",
+    "@acmekit/types": "2.13.1",
+    "@acmekit/utils": "2.13.1"
+  },
+  "scripts": {
+    "watch": "yarn run -T tsc --build --watch",
+    "build": "yarn run -T rimraf dist && yarn run -T tsc --build",
+    "test": "../../../node_modules/.bin/jest --silent --bail --forceExit",
+    "test:integration": "../../../node_modules/.bin/jest --passWithNoTests --no-cache --bail --detectOpenHandles --forceExit --logHeapUsage --testPathPattern=\"integration-tests/__tests__/.*\\.spec\\.ts\""
+  },
+  "dependencies": {
+    "bullmq": "5.13.0",
+    "ioredis": "^5.4.1"
+  },
+  "peerDependencies": {
+    "@acmekit/framework": "2.13.1"
+  }
+}