@mamindom/common 1.0.119 → 1.0.121

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './enum';
 export * from './grpc';
 export * from './rbac';
+export * from './rmq';
 export * from './utils';

package/dist/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./enum"), exports);
 __exportStar(require("./grpc"), exports);
 __exportStar(require("./rbac"), exports);
+__exportStar(require("./rmq"), exports);
 __exportStar(require("./utils"), exports);

package/dist/rmq/bootstrap-dlx.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Convention: dead-letter exchange and queue names are derived from the
+ * primary queue name. `cart_queue` → `cart.dlx` + `cart.dlq`. The `_queue`
+ * or `-queue` suffix is stripped; if absent, the whole name is used.
+ *
+ * Keeping this as a pure function (instead of env vars) prevents the class
+ * of bugs where producer and consumer disagree on DLX naming and trigger
+ * PRECONDITION_FAILED on queue declare.
+ */
+export declare function dlxNameFor(queue: string): string;
+export declare function dlqNameFor(queue: string): string;
+/**
+ * queueOptions.arguments needed for a queue that should dead-letter into its
+ * conventional DLX. Use in `app.connectMicroservice(...)` and in every
+ * `ClientsModule.registerAsync` that declares the same queue, so producer
+ * and consumer declares stay equivalent.
+ */
+export declare function rmqQueueDlxArguments(queue: string): {
+    'x-dead-letter-exchange': string;
+};
+export interface BootstrapRmqDlxOptions {
+    url: string;
+    queue: string;
+}
+/**
+ * Idempotently declares the DLX trio for the given queue: fanout exchange +
+ * DLQ queue + binding. Run once at service bootstrap, before connecting RMQ
+ * microservice. Safe to repeat — RabbitMQ no-ops on identical re-declares.
+ *
+ * `amqplib` is loaded lazily so services that import other helpers from this
+ * module but don't actually run RMQ (e.g. gateway-service) don't need amqplib
+ * in their node_modules.
+ *
+ * Why fanout: dead-lettered messages keep their original routing key, but
+ * we want every message into the DLX to land in the DLQ regardless of key.
+ */
+export declare function bootstrapRmqDlx(opts: BootstrapRmqDlxOptions): Promise<void>;

package/dist/rmq/bootstrap-dlx.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dlxNameFor = dlxNameFor;
+exports.dlqNameFor = dlqNameFor;
+exports.rmqQueueDlxArguments = rmqQueueDlxArguments;
+exports.bootstrapRmqDlx = bootstrapRmqDlx;
+const common_1 = require("@nestjs/common");
+/**
+ * Convention: dead-letter exchange and queue names are derived from the
+ * primary queue name. `cart_queue` → `cart.dlx` + `cart.dlq`. The `_queue`
+ * or `-queue` suffix is stripped; if absent, the whole name is used.
+ *
+ * Keeping this as a pure function (instead of env vars) prevents the class
+ * of bugs where producer and consumer disagree on DLX naming and trigger
+ * PRECONDITION_FAILED on queue declare.
+ */
+function dlxNameFor(queue) {
+    return `${stripQueueSuffix(queue)}.dlx`;
+}
+function dlqNameFor(queue) {
+    return `${stripQueueSuffix(queue)}.dlq`;
+}
+function stripQueueSuffix(queue) {
+    return queue.replace(/[_-]queue$/, '');
+}
+/**
+ * queueOptions.arguments needed for a queue that should dead-letter into its
+ * conventional DLX. Use in `app.connectMicroservice(...)` and in every
+ * `ClientsModule.registerAsync` that declares the same queue, so producer
+ * and consumer declares stay equivalent.
+ */
+function rmqQueueDlxArguments(queue) {
+    return { 'x-dead-letter-exchange': dlxNameFor(queue) };
+}
+/**
+ * Idempotently declares the DLX trio for the given queue: fanout exchange +
+ * DLQ queue + binding. Run once at service bootstrap, before connecting RMQ
+ * microservice. Safe to repeat — RabbitMQ no-ops on identical re-declares.
+ *
+ * `amqplib` is loaded lazily so services that import other helpers from this
+ * module but don't actually run RMQ (e.g. gateway-service) don't need amqplib
+ * in their node_modules.
+ *
+ * Why fanout: dead-lettered messages keep their original routing key, but
+ * we want every message into the DLX to land in the DLQ regardless of key.
+ */
+async function bootstrapRmqDlx(opts) {
+    const logger = new common_1.Logger('RmqDlxBootstrap');
+    const dlx = dlxNameFor(opts.queue);
+    const dlq = dlqNameFor(opts.queue);
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const amqp = require('amqplib');
+    const connection = await amqp.connect(opts.url);
+    try {
+        const channel = await connection.createChannel();
+        try {
+            await channel.assertExchange(dlx, 'fanout', { durable: true });
+            await channel.assertQueue(dlq, { durable: true });
+            await channel.bindQueue(dlq, dlx, '');
+            logger.log(`DLX ready for ${opts.queue}: ${dlx} → ${dlq}`);
+        }
+        finally {
+            await channel.close();
+        }
+    }
+    finally {
+        await connection.close();
+    }
+}

package/dist/rmq/index.d.ts

@@ -0,0 +1 @@
+export * from './bootstrap-dlx';

package/dist/rmq/index.js

@@ -0,0 +1,17 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./bootstrap-dlx"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mamindom/common",
-	"version": "1.0.119",
+	"version": "1.0.121",
 	"type": "commonjs",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",
@@ -16,7 +16,9 @@
 	},
 	"devDependencies": {
 		"@mamindom/core": "^1.0.4",
+		"@types/amqplib": "^0.10.5",
 		"@types/node": "^25.3.5",
+		"amqplib": "^0.10.9",
 		"prettier": "^3.8.1",
 		"typescript": "^5.9.3"
 	},
@@ -25,5 +27,8 @@
 		"@nestjs/common": "^11.1.16",
 		"@nestjs/config": "^4.0.3",
 		"@nestjs/microservices": "^11.1.16"
+	},
+	"peerDependencies": {
+		"amqplib": "^0.10.0"
 	}
 }