redis-smq 7.0.6 → 7.1.0

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # CHANGELOG
 
+## 7.1.0 (2022-10-06)
+
+* docs: update README.md (8734e49)
+* build: update npm dependencies (4225c50)
+* test(FanOutExchangeManager): increase code coverage (df4c693)
+* refactor(FanOutExchangeManager): improve unbindQueue() logic (c1440a5)
+* docs: update docs (508430f)
+* fix: fix typing error (05c1575)
+* test: increase code coverage (c4ba4f3)
+* refactor: rename saveExchange() to createExchange() (995ca03)
+* refactor: improve TQueueSettings typing (413f4d3)
+* refactor: bump up redis keys version (3389216)
+* refactor: add EQueueSettingType, remove KEY_QUEUE_SETTINGS_* keys (600199c)
+* refactor(queue-manager): update queue.create() reply payload (f3a12d1)
+* feat(FanOutExchangeManager): add saveExchange(), deleteExchange() (1ce22cc)
+* refactor(redis-keys): clean up validateRedisKey() (e921540)
+* fix(FanOutExchange): fix bindingParams validation (327d045)
+* test(exchange): increase code coverage (f5f5d95)
+* feat(exchange): allow retrieving fanout exchange list (8a96b17)
+* refactor(exchange): improve exchange tag naming (a089738)
+* refactor(message): improve message.exchange typing (9ce281a)
+* refactor(queue-manager): clean up (ce5ab8e)
+* docs(message): update MessageMetadata references (5041a85)
+* test(message): update MessageMetadata references (9888918)
+* refactor(message): rename MessageMetadata to MessageState, clean up (2de18b4)
+* docs(exchange): improve documentation (718a80a)
+* docs(producer): update docs (1965a75)
+* docs(exchange): fix typos (93b4c8e)
+* test(exchange): test exchanges with unmatched queues (d836eab)
+*  fix(exchange): return an error for exchanges with unmatched queues (e89ce06)
+* docs(message): add missing method references (c723ec2)
+* docs(exchange): update docs (1dc02a4)
+* refactor(exchange): rename FanOutExchangeManager methods (f981241)
+* docs(exchange): add FanOutExchangeManager reference (9cecc89)
+* test(exchange): update fanout-exchange tests (be75519)
+* feat(exchange): add FanOutExchangeManager (f8168a4)
+* refactor(exchange): rename files (fd9d906)
+* build: update workflow names (7b1b545)
+* docs(readme): display the status of codeql.yml workflow (94eb97a)
+* perf(redis-keys): fix inefficient regex complexity (dcb4f1f)
+* build: set up code scanning (be0dd02)
+* docs(exchange): update message-exchanges.md (49436af)
+* test(exchange): fix test errors (f3aa786)
+* docs(exchange): fix typos (a62a732)
+* fix(redis-keys): enforce a redis key to start with a letter (a-z) (ecb7493)
+* docs(exchange): update docs (wip) (6d3eaee)
+* fix(exchange): export DirectExchange/TopicExchange/FanOutExchange classes (c070f3c)
+* test(exchange): increase code coverage (063582c)
+* refactor(exchange): add and use InvalidExchangeDataError (482e093)
+* docs(readme): add reference to current release documentation (747e4e3)
+* docs(producer): update producer.produce() parameters (938976e)
+* fix: fix various typings issues (9c51445)
+* chore: update examples (3628813)
+* refactor: update tests (1456c5a)
+* test(exchange): test fanout and topic exchanges (54c081b)
+* feat(queue-manager): allow to bind/unbind a queue to an exchange (cd91109)
+* refactor(exchange): remove code redundancies and clean up (2dc2cba)
+* chore: bump up redis-smq-common to v1.0.4 (5181ad7)
+* feat(exchange): implement missing methods of TopicExchange class (e2119b5)
+* feat(redis-keys): allow redis keys to include a dot (92b8b05)
+* perf(queue-manager): use sscan instead of smembers (8f491f4)
+* feat(exchange): implement direct, fanout, and topic exchanges (1617e9b)
+* chore: bump up redis-smq-common to 1.0.3 (d7f4aba)
+* chore: clean up (ee88201)
+
+## 7.0.7 (2022-08-10)
+
+* Bump up redis-smq-common to v1.0.2 (ff385ad)
+* Update docs (3871e8f)
+
 ## 7.0.6 (2022-08-08)
 
 * Improve consumer/producer shutdown handling (36278ce)

package/README.md

@@ -7,10 +7,10 @@
 
 <p>
    <a href="https://github.com/weyoss/redis-smq/actions/workflows/tests.yml"><img src="https://github.com/weyoss/redis-smq/actions/workflows/tests.yml/badge.svg" alt="Tests" style="max-width:100%;" /></a>
+   <a href="https://github.com/weyoss/redis-smq/actions/workflows/codeql.yml" rel="nofollow"><img src="https://github.com/weyoss/redis-smq/actions/workflows/codeql.yml/badge.svg" alt="Code quality" /></a>
    <a href="https://codecov.io/github/weyoss/redis-smq?branch=master" rel="nofollow"><img src="https://img.shields.io/codecov/c/github/weyoss/redis-smq" alt="Coverage Status" /></a>
    <a href="https://npmjs.org/package/redis-smq" rel="nofollow"><img src="https://img.shields.io/npm/v/redis-smq.svg" alt="NPM version" /></a>
    <a href="https://npmjs.org/package/redis-smq" rel="nofollow"><img src="https://img.shields.io/npm/dm/redis-smq.svg" alt="NPM downloads" /></a>
-   <a href="https://lgtm.com/projects/g/weyoss/redis-smq/context:javascript" rel="nofollow"><img src="https://img.shields.io/lgtm/grade/javascript/github/weyoss/redis-smq.svg?logo=lgtm&logoWidth=18" alt="Code quality" /></a>
 </p>
 
 RedisSMQ is a Node.js library for queuing messages (aka jobs) and processing them asynchronously with consumers. Backed by Redis, it allows scaling up your application with ease of use.
@@ -20,6 +20,7 @@ RedisSMQ is a Node.js library for queuing messages (aka jobs) and processing the
 * **[High-performance message processing](/docs/performance.md)**.
 * **[Multi-Queue Producers](#producer-class) & [Multi-Queue Consumers](#consumer-class)**: Offering flexible Producer/Consumer models, with focus on simplicity and without tons of features. This can make RedisSMQ an ideal message broker for your microservices. 
 * **[Supports both at-least-once/at-most-once delivery](/docs/api/message.md#messageprototypesetretrythreshold)**: In case of failures, while delivering or processing a message, RedisSMQ can guaranty that the message will be not lost and redelivered again. When configured to do so, RedisSMQ can also ensure that the message is delivered at-most-once.
+* **[Supports Different Exchange Types](/docs/message-exchanges.md)**: RedisSMQ offers 3 types of exchanges: [Direct Exchange](/docs/message-exchanges.md#direct-exchange), [Topic Exchange](/docs/message-exchanges.md#topic-exchange), and [Fanout Exchange](/docs/message-exchanges.md#fanout-exchange) for publishing a message to one or multiple queues. 
 * **[Message Expiration](/docs/api/message.md#messageprototypesetttl)**: A message will not be delivered if it has been in a queue for longer than a given amount of time, called TTL (time-to-live).
 * **[Message Consumption Timeout](/docs/api/message.md#messageprototypesetconsumetimeout)**: Timeout for consuming messages.
 * **[Queue Rate Limiting](/docs/queue-rate-limiting.md)**: Allowing you to control the rate at which the messages are consumed from a given queue.
@@ -54,13 +55,14 @@ RedisSMQ is a Node.js library for queuing messages (aka jobs) and processing the
    2. Advanced Topics
       1. [Scheduling Messages](/docs/scheduling-messages.md)
       2. [Priority Queues](/docs/priority-queues.md)
-      3. [Queue Rate Limiting](/docs/queue-rate-limiting.md)
-      4. [Multiplexing](/docs/multiplexing.md)
-      5. [Message Manager](/docs/api/message-manager.md)
-      6. [Queue Manager](/docs/api/queue-manager.md)
-      7. [HTTP API](https://github.com/weyoss/redis-smq-monitor)
-      8. [Web UI](https://github.com/weyoss/redis-smq-monitor-client)
-      9. [Logs](https://github.com/weyoss/redis-smq-common/blob/master/docs/logs.md)
+      3. [Message Exchanges](/docs/message-exchanges.md)
+      4. [Queue Rate Limiting](/docs/queue-rate-limiting.md)
+      5. [Multiplexing](/docs/multiplexing.md)
+      6. [Message Manager](/docs/api/message-manager.md)
+      7. [Queue Manager](/docs/api/queue-manager.md)
+      8. [HTTP API](https://github.com/weyoss/redis-smq-monitor)
+      9. [Web UI](https://github.com/weyoss/redis-smq-monitor-client)
+      10. [Logs](https://github.com/weyoss/redis-smq-common/blob/master/docs/logs.md)
 5. [RedisSMQ Architecture](/docs/redis-smq-architecture.md)
 6. [Performance](#performance)
 7. [Contributing](#contributing)
@@ -68,10 +70,11 @@ RedisSMQ is a Node.js library for queuing messages (aka jobs) and processing the
 
 ## What's new?
 
-**2022.06.18**
+**2022.10.06**
 
-:rocket: Release v7 is finally ready! The RedisSMQ v7 is a refinement release with many improvements toward making 
-things more simple to use and removing any confusions that can occur while working with the message queue.
+:rocket: Release v7.1 is out! The RedisSMQ v7.1 extends the message queue features by introducing **[Message Exchanges](/docs/message-exchanges.md)**. 
+Also, the [Web UI](https://github.com/weyoss/redis-smq-monitor-client) has been reworked for better user experience and to support the new features. 
+So feel to play with the new release, if you encounter any issue, or you have a question do not hesitate to open an issue.
 
 ## Installation
 
@@ -224,6 +227,8 @@ See [Consumer Reference](/docs/api/consumer.md) for more details.
 
 * [Priority Queues](/docs/priority-queues.md)
 
+* [Message Exchanges](/docs/message-exchanges.md)
+
 * [Queue Rate Limiting](/docs/queue-rate-limiting.md)
 
 * [Multiplexing](/docs/multiplexing.md)

package/dist/index.d.ts

@@ -4,3 +4,7 @@ export { Producer } from './src/lib/producer/producer';
 export { Message } from './src/lib/message/message';
 export { MessageManager } from './src/lib/message-manager/message-manager';
 export { QueueManager } from './src/lib/queue-manager/queue-manager';
+export { DirectExchange } from './src/lib/exchange/direct-exchange';
+export { TopicExchange } from './src/lib/exchange/topic-exchange';
+export { FanOutExchange } from './src/lib/exchange/fan-out-exchange';
+export { FanOutExchangeManager } from './src/lib/exchange/fan-out-exchange-manager';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.QueueManager = exports.MessageManager = exports.Message = exports.Producer = exports.Consumer = exports.events = void 0;
+exports.FanOutExchangeManager = exports.FanOutExchange = exports.TopicExchange = exports.DirectExchange = exports.QueueManager = exports.MessageManager = exports.Message = exports.Producer = exports.Consumer = exports.events = void 0;
 var events_1 = require("./src/common/events/events");
 Object.defineProperty(exports, "events", { enumerable: true, get: function () { return events_1.events; } });
 var consumer_1 = require("./src/lib/consumer/consumer");
@@ -13,4 +13,12 @@ var message_manager_1 = require("./src/lib/message-manager/message-manager");
 Object.defineProperty(exports, "MessageManager", { enumerable: true, get: function () { return message_manager_1.MessageManager; } });
 var queue_manager_1 = require("./src/lib/queue-manager/queue-manager");
 Object.defineProperty(exports, "QueueManager", { enumerable: true, get: function () { return queue_manager_1.QueueManager; } });
+var direct_exchange_1 = require("./src/lib/exchange/direct-exchange");
+Object.defineProperty(exports, "DirectExchange", { enumerable: true, get: function () { return direct_exchange_1.DirectExchange; } });
+var topic_exchange_1 = require("./src/lib/exchange/topic-exchange");
+Object.defineProperty(exports, "TopicExchange", { enumerable: true, get: function () { return topic_exchange_1.TopicExchange; } });
+var fan_out_exchange_1 = require("./src/lib/exchange/fan-out-exchange");
+Object.defineProperty(exports, "FanOutExchange", { enumerable: true, get: function () { return fan_out_exchange_1.FanOutExchange; } });
+var fan_out_exchange_manager_1 = require("./src/lib/exchange/fan-out-exchange-manager");
+Object.defineProperty(exports, "FanOutExchangeManager", { enumerable: true, get: function () { return fan_out_exchange_manager_1.FanOutExchangeManager; } });
 //# sourceMappingURL=index.js.map

package/dist/misc/health-check/combined-run.js

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const redis_smq_common_1 = require("redis-smq-common");
-const __1 = require("../..");
+const index_1 = require("../../index");
 const events_1 = require("../../src/common/events/events");
 const queue = `queue_${Date.now()}`;
-const producer = new __1.Producer();
+const producer = new index_1.Producer();
 const produceForever = (err) => {
     if (err)
         console.log(err);
     else {
         if (producer.isGoingUp() || producer.isRunning()) {
-            const message = new __1.Message().setBody('some data').setQueue(queue);
+            const message = new index_1.Message().setBody('some data').setQueue(queue);
             producer.produce(message, produceForever);
         }
     }
 };
-const consumer = new __1.Consumer();
+const consumer = new index_1.Consumer();
 consumer.consume(queue, (message, cb) => cb(), (err) => err && console.log(err));
 consumer.on(events_1.events.UP, () => {
     console.log('UP');
@@ -37,12 +37,12 @@ const serialOnOff = (cb) => redis_smq_common_1.async.waterfall([
 ], cb);
 let queueManager = null;
 redis_smq_common_1.async.waterfall([
-    (cb) => __1.QueueManager.createInstance({}, (err, instance) => {
+    (cb) => index_1.QueueManager.createInstance({}, (err, instance) => {
         if (err)
             cb(err);
         else {
             queueManager = instance;
-            queueManager === null || queueManager === void 0 ? void 0 : queueManager.queue.create(queue, false, cb);
+            queueManager === null || queueManager === void 0 ? void 0 : queueManager.queue.create(queue, false, (err) => cb(err));
         }
     }),
     (cb) => producer.run((err) => cb(err)),

package/dist/src/common/redis-keys/redis-keys.d.ts

@@ -12,8 +12,7 @@ export declare const redisKeys: {
         keyDelayedMessages: string;
         keyRequeueMessages: string;
         keyNamespaces: string;
-        keyQueueSettingsRateLimit: string;
-        keyQueueSettingsPriorityQueuing: string;
+        keyExchanges: string;
     };
     getQueueKeys(queueParams: TQueueParams): {
         keyQueuePending: string;
@@ -36,8 +35,21 @@ export declare const redisKeys: {
         keyDelayedMessages: string;
         keyRequeueMessages: string;
         keyNamespaces: string;
-        keyQueueSettingsRateLimit: string;
-        keyQueueSettingsPriorityQueuing: string;
+        keyExchanges: string;
+    };
+    getFanOutExchangeKeys(bindingKey: string): {
+        keyExchangeBindings: string;
+        keyQueues: string;
+        keyProcessingQueues: string;
+        keyHeartbeats: string;
+        keyHeartbeatConsumerWeight: string;
+        keyScheduledMessages: string;
+        keyScheduledMessageWeight: string;
+        keyLockConsumerWorkersRunner: string;
+        keyDelayedMessages: string;
+        keyRequeueMessages: string;
+        keyNamespaces: string;
+        keyExchanges: string;
     };
     getConsumerKeys(instanceId: string): {
         keyConsumerQueues: string;
@@ -51,8 +63,7 @@ export declare const redisKeys: {
         keyDelayedMessages: string;
         keyRequeueMessages: string;
         keyNamespaces: string;
-        keyQueueSettingsRateLimit: string;
-        keyQueueSettingsPriorityQueuing: string;
+        keyExchanges: string;
     };
     getQueueConsumerKeys(queueParams: TQueueParams, instanceId: string): {
         keyQueueProcessing: string;
@@ -67,8 +78,7 @@ export declare const redisKeys: {
         keyDelayedMessages: string;
         keyRequeueMessages: string;
         keyNamespaces: string;
-        keyQueueSettingsRateLimit: string;
-        keyQueueSettingsPriorityQueuing: string;
+        keyExchanges: string;
         keyQueuePending: string;
         keyQueueDL: string;
         keyQueueProcessingQueues: string;
@@ -80,7 +90,7 @@ export declare const redisKeys: {
         keyQueueSettings: string;
         keyNsQueues: string;
     };
-    getMainKeys(): Record<"keyQueues" | "keyProcessingQueues" | "keyHeartbeats" | "keyHeartbeatConsumerWeight" | "keyScheduledMessages" | "keyScheduledMessageWeight" | "keyLockConsumerWorkersRunner" | "keyDelayedMessages" | "keyRequeueMessages" | "keyNamespaces" | "keyQueueSettingsRateLimit" | "keyQueueSettingsPriorityQueuing", string>;
+    getMainKeys(): Record<"keyQueues" | "keyProcessingQueues" | "keyHeartbeats" | "keyHeartbeatConsumerWeight" | "keyScheduledMessages" | "keyScheduledMessageWeight" | "keyLockConsumerWorkersRunner" | "keyDelayedMessages" | "keyRequeueMessages" | "keyNamespaces" | "keyExchanges", string>;
     validateNamespace(ns: string): string;
     validateRedisKey(key?: string): string;
 };

package/dist/src/common/redis-keys/redis-keys.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.redisKeys = void 0;
 const redis_keys_error_1 = require("./redis-keys.error");
 const keySegmentSeparator = ':';
-const nsPrefix = 'redis-smq-v7';
+const nsPrefix = 'redis-smq-v7.1';
 const globalNamespace = 'global';
 var ERedisKey;
 (function (ERedisKey) {
@@ -29,8 +29,8 @@ var ERedisKey;
     ERedisKey[ERedisKey["KEY_NAMESPACES"] = 20] = "KEY_NAMESPACES";
     ERedisKey[ERedisKey["KEY_QUEUE_RATE_LIMIT_COUNTER"] = 21] = "KEY_QUEUE_RATE_LIMIT_COUNTER";
     ERedisKey[ERedisKey["KEY_QUEUE_SETTINGS"] = 22] = "KEY_QUEUE_SETTINGS";
-    ERedisKey[ERedisKey["KEY_QUEUE_SETTINGS_RATE_LIMIT"] = 23] = "KEY_QUEUE_SETTINGS_RATE_LIMIT";
-    ERedisKey[ERedisKey["KEY_QUEUE_SETTINGS_PRIORITY_QUEUING"] = 24] = "KEY_QUEUE_SETTINGS_PRIORITY_QUEUING";
+    ERedisKey[ERedisKey["KEY_EXCHANGE_BINDINGS"] = 23] = "KEY_EXCHANGE_BINDINGS";
+    ERedisKey[ERedisKey["KEY_EXCHANGES"] = 24] = "KEY_EXCHANGES";
 })(ERedisKey || (ERedisKey = {}));
 function makeNamespacedKeys(keys, namespace, ...rest) {
     const result = {};
@@ -62,6 +62,13 @@ exports.redisKeys = {
         };
         return Object.assign(Object.assign({}, nsKeys), makeNamespacedKeys(queueKeys, queueParams.ns, queueParams.name));
     },
+    getFanOutExchangeKeys(bindingKey) {
+        const mainKeys = this.getMainKeys();
+        const exchangeKeys = {
+            keyExchangeBindings: ERedisKey.KEY_EXCHANGE_BINDINGS,
+        };
+        return Object.assign(Object.assign({}, mainKeys), makeNamespacedKeys(exchangeKeys, globalNamespace, bindingKey));
+    },
     getConsumerKeys(instanceId) {
         const mainKeys = this.getMainKeys();
         const consumerKeys = {
@@ -89,8 +96,7 @@ exports.redisKeys = {
             keyDelayedMessages: ERedisKey.KEY_DELAYED_MESSAGES,
             keyRequeueMessages: ERedisKey.KEY_REQUEUE_MESSAGES,
             keyNamespaces: ERedisKey.KEY_NAMESPACES,
-            keyQueueSettingsRateLimit: ERedisKey.KEY_QUEUE_SETTINGS_RATE_LIMIT,
-            keyQueueSettingsPriorityQueuing: ERedisKey.KEY_QUEUE_SETTINGS_PRIORITY_QUEUING,
+            keyExchanges: ERedisKey.KEY_EXCHANGES,
         };
         return makeNamespacedKeys(mainKeys, globalNamespace);
     },
@@ -105,11 +111,12 @@ exports.redisKeys = {
         if (!key || !key.length) {
             throw new redis_keys_error_1.RedisKeysError('Invalid Redis key. Expected be a non empty string.');
         }
-        const filtered = key.toLowerCase().replace(/[^a-z0-9_-]/g, '');
-        if (filtered.length !== key.length) {
-            throw new redis_keys_error_1.RedisKeysError('Invalid Redis key. Only letters (a-z), numbers (0-9) and (-_) are allowed.');
+        const lowerCase = key.toLowerCase();
+        const filtered = lowerCase.replace(/(?:[a-z][a-z0-9]?)+(?:[-_.]?[a-z0-9])*/, '');
+        if (filtered.length) {
+            throw new redis_keys_error_1.RedisKeysError('Invalid Redis key. Valid characters are letters (a-z) and numbers (0-9). (-_) are allowed between alphanumerics. Use a dot (.) to denote hierarchies.');
         }
-        return filtered;
+        return lowerCase;
     },
 };
 //# sourceMappingURL=redis-keys.js.map

package/dist/src/lib/consumer/consumer-message-handler/acknowledge-message.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.acknowledgeMessage = void 0;
 const redis_keys_1 = require("../../../common/redis-keys/redis-keys");
 function acknowledgeMessage(config, redisClient, message, keyQueueProcessing, cb) {
-    const queue = message.getRequiredQueue();
+    const queue = message.getDestinationQueue();
     const { store, queueSize, expire } = config.messages.store.acknowledged;
     if (store) {
         const { keyQueueAcknowledged } = redis_keys_1.redisKeys.getQueueKeys(queue);

package/dist/src/lib/consumer/consumer-message-handler/dead-letter-message.js

@@ -4,7 +4,7 @@ exports.deadLetterMessage = void 0;
 const redis_keys_1 = require("../../../common/redis-keys/redis-keys");
 const redis_smq_common_1 = require("redis-smq-common");
 function deadLetterMessageTransaction(config, mixed, message, keyQueueProcessing) {
-    const queue = message.getRequiredQueue();
+    const queue = message.getDestinationQueue();
     const { keyQueueDL } = redis_keys_1.redisKeys.getQueueKeys(queue);
     const { store, expire, queueSize } = config.messages.store.deadLettered;
     if (store) {
@@ -25,7 +25,7 @@ function deadLetterMessage(config, mixed, message, keyQueueProcessing, unacknowl
     if (mixed instanceof redis_smq_common_1.RedisClient) {
         if (!cb)
             throw new redis_smq_common_1.errors.PanicError(`Expected a callback function`);
-        const queue = message.getRequiredQueue();
+        const queue = message.getDestinationQueue();
         const { keyQueueDL } = redis_keys_1.redisKeys.getQueueKeys(queue);
         const { store, expire, queueSize } = config.messages.store.deadLettered;
         if (store) {

package/dist/src/lib/consumer/consumer-message-handler/delay-message.js

@@ -4,7 +4,7 @@ exports.delayMessage = exports.delayMessageTransaction = void 0;
 const redis_keys_1 = require("../../../common/redis-keys/redis-keys");
 const redis_smq_common_1 = require("redis-smq-common");
 function delayMessageTransaction(mixed, message, keyQueueProcessing) {
-    const queue = message.getRequiredQueue();
+    const queue = message.getDestinationQueue();
     const { keyDelayedMessages } = redis_keys_1.redisKeys.getQueueKeys(queue);
     mixed.rpoplpush(keyQueueProcessing, keyDelayedMessages);
 }
@@ -13,7 +13,7 @@ function delayMessage(mixed, message, keyQueueProcessing, unacknowledgedCause, c
     if (mixed instanceof redis_smq_common_1.RedisClient) {
         if (!cb)
             throw new redis_smq_common_1.errors.PanicError(`Expected a callback function`);
-        const queue = message.getRequiredQueue();
+        const queue = message.getDestinationQueue();
         const { keyDelayedMessages } = redis_keys_1.redisKeys.getQueueKeys(queue);
         mixed.rpoplpush(keyQueueProcessing, keyDelayedMessages, (err) => cb(err));
     }

package/dist/src/lib/consumer/consumer-message-handler/requeue-message.js

@@ -4,7 +4,7 @@ exports.requeueMessage = void 0;
 const redis_keys_1 = require("../../../common/redis-keys/redis-keys");
 const redis_smq_common_1 = require("redis-smq-common");
 function requeueMessage(mixed, message, keyQueueProcessing, unacknowledgedCause, cb) {
-    const queue = message.getRequiredQueue();
+    const queue = message.getDestinationQueue();
     const { keyRequeueMessages } = redis_keys_1.redisKeys.getQueueKeys(queue);
     if (mixed instanceof redis_smq_common_1.RedisClient) {
         if (!cb)

package/dist/src/lib/exchange/direct-exchange.d.ts

@@ -0,0 +1,10 @@
+import { Exchange } from './exchange';
+import { EExchangeType, IDirectExchangeParams, IRequiredConfig, TQueueParams } from '../../../types';
+import { RedisClient } from 'redis-smq-common';
+import { ICallback } from 'redis-smq-common/dist/types';
+export declare class DirectExchange extends Exchange<TQueueParams | string, EExchangeType.DIRECT> {
+    constructor(queue: TQueueParams | string);
+    protected validateBindingParams(queue: TQueueParams | string): TQueueParams | string;
+    getQueues(redisClient: RedisClient, config: IRequiredConfig, cb: ICallback<TQueueParams[]>): void;
+    static fromJSON(json: Partial<IDirectExchangeParams>): DirectExchange;
+}

package/dist/src/lib/exchange/direct-exchange.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DirectExchange = void 0;
+const exchange_1 = require("./exchange");
+const types_1 = require("../../../types");
+const redis_keys_1 = require("../../common/redis-keys/redis-keys");
+const queue_1 = require("../queue-manager/queue");
+const invalid_exchange_data_error_1 = require("./errors/invalid-exchange-data.error");
+class DirectExchange extends exchange_1.Exchange {
+    constructor(queue) {
+        super(queue, types_1.EExchangeType.DIRECT);
+    }
+    validateBindingParams(queue) {
+        return typeof queue === 'string'
+            ? redis_keys_1.redisKeys.validateRedisKey(queue)
+            : {
+                name: redis_keys_1.redisKeys.validateRedisKey(queue.name),
+                ns: redis_keys_1.redisKeys.validateNamespace(queue.ns),
+            };
+    }
+    getQueues(redisClient, config, cb) {
+        const queue = queue_1.Queue.getParams(config, this.bindingParams);
+        cb(null, [queue]);
+    }
+    static fromJSON(json) {
+        if (!json.bindingParams || json.type !== types_1.EExchangeType.DIRECT)
+            throw new invalid_exchange_data_error_1.InvalidExchangeDataError();
+        const e = new DirectExchange(json.bindingParams);
+        e.fromJSON(json);
+        return e;
+    }
+}
+exports.DirectExchange = DirectExchange;
+//# sourceMappingURL=direct-exchange.js.map

package/dist/src/lib/exchange/errors/destination-queue-required.error.d.ts

@@ -0,0 +1,4 @@
+import { ExchangeError } from './exchange.error';
+export declare class DestinationQueueRequiredError extends ExchangeError {
+    constructor();
+}

package/dist/src/lib/exchange/errors/destination-queue-required.error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DestinationQueueRequiredError = void 0;
+const exchange_error_1 = require("./exchange.error");
+class DestinationQueueRequiredError extends exchange_error_1.ExchangeError {
+    constructor() {
+        super(`Destination queue is required`);
+    }
+}
+exports.DestinationQueueRequiredError = DestinationQueueRequiredError;
+//# sourceMappingURL=destination-queue-required.error.js.map

package/dist/src/lib/exchange/errors/exchange.error.d.ts

@@ -0,0 +1,3 @@
+import { RedisSMQError } from 'redis-smq-common/dist/src/errors/redis-smq.error';
+export declare class ExchangeError extends RedisSMQError {
+}

package/dist/src/lib/exchange/errors/exchange.error.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExchangeError = void 0;
+const redis_smq_error_1 = require("redis-smq-common/dist/src/errors/redis-smq.error");
+class ExchangeError extends redis_smq_error_1.RedisSMQError {
+}
+exports.ExchangeError = ExchangeError;
+//# sourceMappingURL=exchange.error.js.map

package/dist/src/lib/exchange/errors/invalid-exchange-data.error.d.ts

@@ -0,0 +1,4 @@
+import { ExchangeError } from './exchange.error';
+export declare class InvalidExchangeDataError extends ExchangeError {
+    constructor();
+}

package/dist/src/lib/exchange/errors/invalid-exchange-data.error.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidExchangeDataError = void 0;
+const exchange_error_1 = require("./exchange.error");
+class InvalidExchangeDataError extends exchange_error_1.ExchangeError {
+    constructor() {
+        super('Invalid exchange data');
+    }
+}
+exports.InvalidExchangeDataError = InvalidExchangeDataError;
+//# sourceMappingURL=invalid-exchange-data.error.js.map

package/dist/src/lib/exchange/exchange.d.ts

@@ -0,0 +1,19 @@
+import { EExchangeType, IExchangeParams, IRequiredConfig, TQueueParams } from '../../../types';
+import { RedisClient } from 'redis-smq-common';
+import { ICallback } from 'redis-smq-common/dist/types';
+export declare abstract class Exchange<TBindingParams, TBindingType extends EExchangeType> {
+    protected exchangeTag: string;
+    protected destinationQueue: TQueueParams | null;
+    protected bindingParams: TBindingParams;
+    protected type: TBindingType;
+    protected constructor(bindingParams: TBindingParams, type: TBindingType);
+    protected generateExchangeTag(): string;
+    setDestinationQueue(queue: TQueueParams | null): void;
+    getBindingParams(): TBindingParams;
+    getDestinationQueue(): TQueueParams | null;
+    getRequiredDestinationQueue(): TQueueParams;
+    toJSON(): IExchangeParams<TBindingParams, TBindingType>;
+    fromJSON(JSON: Partial<IExchangeParams<TBindingParams, TBindingType>>): void;
+    protected abstract validateBindingParams(bindingParams: TBindingParams): TBindingParams;
+    abstract getQueues(redisClient: RedisClient, config: IRequiredConfig, cb: ICallback<TQueueParams[]>): void;
+}

package/dist/src/lib/exchange/exchange.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Exchange = void 0;
+const uuid_1 = require("uuid");
+const destination_queue_required_error_1 = require("./errors/destination-queue-required.error");
+class Exchange {
+    constructor(bindingParams, type) {
+        this.destinationQueue = null;
+        this.bindingParams = this.validateBindingParams(bindingParams);
+        this.type = type;
+        this.exchangeTag = this.generateExchangeTag();
+    }
+    generateExchangeTag() {
+        return `${this.constructor.name
+            .replace(/([a-z])([A-Z])/, '$1-$2')
+            .toLowerCase()}-${(0, uuid_1.v4)()}`;
+    }
+    setDestinationQueue(queue) {
+        this.destinationQueue = queue;
+    }
+    getBindingParams() {
+        return this.bindingParams;
+    }
+    getDestinationQueue() {
+        return this.destinationQueue;
+    }
+    getRequiredDestinationQueue() {
+        if (!this.destinationQueue) {
+            throw new destination_queue_required_error_1.DestinationQueueRequiredError();
+        }
+        return this.destinationQueue;
+    }
+    toJSON() {
+        return {
+            exchangeTag: this.exchangeTag,
+            destinationQueue: this.destinationQueue,
+            bindingParams: this.bindingParams,
+            type: this.type,
+        };
+    }
+    fromJSON(JSON) {
+        if (JSON.destinationQueue)
+            this.setDestinationQueue(JSON.destinationQueue);
+        if (JSON.exchangeTag)
+            this.exchangeTag = JSON.exchangeTag;
+        if (JSON.type)
+            this.type = JSON.type;
+    }
+}
+exports.Exchange = Exchange;
+//# sourceMappingURL=exchange.js.map

package/dist/src/lib/exchange/fan-out-exchange-manager.d.ts

@@ -0,0 +1,21 @@
+import { IConfig, IRequiredConfig, TQueueParams } from '../../../types';
+import { RedisClient } from 'redis-smq-common';
+import { ICallback, ICompatibleLogger } from 'redis-smq-common/dist/types';
+import { FanOutExchange } from './fan-out-exchange';
+export declare class FanOutExchangeManager {
+    protected config: IRequiredConfig;
+    protected redisClient: RedisClient;
+    protected logger: ICompatibleLogger;
+    protected constructor(config: IRequiredConfig, redisClient: RedisClient, logger: ICompatibleLogger);
+    createExchange(exchange: FanOutExchange, cb: ICallback<void>): void;
+    deleteExchange(exchange: FanOutExchange, cb: ICallback<void>): void;
+    bindQueue(queue: TQueueParams | string, exchange: FanOutExchange, cb: ICallback<void>): void;
+    unbindQueue(queue: TQueueParams | string, exchange: FanOutExchange, cb: ICallback<void>): void;
+    getExchanges(cb: ICallback<string[]>): void;
+    getExchangeQueues(exchange: FanOutExchange, cb: ICallback<TQueueParams[]>): void;
+    getQueueExchange(queue: TQueueParams | string, cb: ICallback<FanOutExchange | null>): void;
+    quit(cb: ICallback<void>): void;
+    static getExchangeQueues(redisClient: RedisClient, exchange: FanOutExchange, cb: ICallback<TQueueParams[]>): void;
+    static getQueueExchange(config: IRequiredConfig, redisClient: RedisClient, queue: TQueueParams | string, cb: ICallback<FanOutExchange | null>): void;
+    static createInstance(config: IConfig | undefined, cb: ICallback<FanOutExchangeManager>): void;
+}