@kaushverse/rabbitmq-core 1.0.5 → 1.0.7

package/README.md

@@ -0,0 +1,98 @@
+# @kaushverse/rabbitmq-core
+
+Production-ready RabbitMQ SDK for Node.js microservices.
+
+This package provides a clean and opinionated way to **connect**, **publish**, **consume**, and **monitor RabbitMQ**, while handling **TLS**, **logging**, **health checks**, and **graceful shutdown** automatically.
+
+---
+
+## Features
+
+- Single RabbitMQ connection per service
+- Supports `amqp://` and `amqps://`
+- Message publishing and consuming helpers
+- Built-in bootstrap for service lifecycle
+- Structured logger (pretty logs in dev, JSON in prod)
+- Health check helper for monitoring
+- Graceful shutdown (SIGINT / SIGTERM)
+- Framework agnostic (Express, Fastify, NestJS)
+
+---
+
+## Installation
+
+```bash
+npm install @kaushverse/rabbitmq-core
+```
+
+## Full Express Service Example
+
+Below is a complete example showing how to use `@kaushverse/rabbitmq-core`
+inside an Express-based microservice with health checks and publishing routes.
+
+### Example: `order-service`
+
+```ts
+import "dotenv/config";
+import express from "express";
+import { bootstrap, rabbitHealth } from "@kaushverse/rabbitmq-core";
+
+const app = express();
+app.use(express.json());
+
+// Health check endpoint
+app.get("/health", (_, res) => {
+  res.json({
+    status: "ok",
+    ...rabbitHealth(),
+  });
+});
+
+// Bootstrap the service
+bootstrap({
+  serviceName: "order-service",
+  rabbit: {
+    url: process.env.RABBITMQ_URL!,
+    tls: {
+      caPath: process.env.RABBITMQ_CA_PATH,
+      servername: process.env.RABBITMQ_SERVERNAME,
+      rejectUnauthorized: false, // set true in production
+    },
+  },
+  start: () => {
+    app.listen(3000, () => {
+      console.log("🚀 API running on port 3000");
+    });
+  },
+});
+```
+
+```js
+RABBITMQ_URL=amqps://user:password@mq.example.com:5671/vhost
+RABBITMQ_CA_PATH=./certs/ca.pem
+RABBITMQ_SERVERNAME=mq.example.com
+```
+
+## Publishing Messages
+
+Use `publishMessage` to publish events to RabbitMQ.
+The SDK automatically handles channels, serialization, and persistence.
+
+### Import
+
+```js
+import { publishMessage } from "@kaushverse/rabbitmq-core";
+
+await publishMessage({
+  exchange: "order.events",
+  type: "topic",
+  routingKey: "order.created",
+  message: {
+    orderId: "ORD-123",
+    amount: 499,
+  },
+  headers: {
+    source: "order-service",
+  },
+});
+```

package/dist/index.js

@@ -61,39 +61,50 @@ function loadCA(caPath) {
 // src/connection.ts
 var connection = null;
 var channel = null;
-var connected = false;
 var rabbitEvents = new import_events.EventEmitter();
+rabbitEvents.setMaxListeners(20);
 async function connectRabbitMQ(options) {
-  if (channel && connected) return channel;
+  if (connection && channel) return channel;
   try {
-    const ca = loadCA(options.tls?.caPath);
-    connection = await import_amqplib.default.connect(options.url, {
-      ca,
+    const isSecure = options.url.startsWith("amqps://");
+    if (!isSecure && options.tls) {
+      console.warn("\u26A0\uFE0F TLS options ignored for amqp:// connection");
+    }
+    const socketOptions = isSecure ? {
+      ca: loadCA(options.tls?.caPath),
       servername: options.tls?.servername,
       rejectUnauthorized: options.tls?.rejectUnauthorized ?? true
-    });
+    } : void 0;
+    connection = await import_amqplib.default.connect(options.url, socketOptions);
     channel = await connection.createChannel();
-    connected = true;
     rabbitEvents.emit("connected");
     connection.on("close", () => {
-      connected = false;
+      connection = null;
       channel = null;
       rabbitEvents.emit("disconnected");
     });
     connection.on("error", (err) => {
-      connected = false;
+      rabbitEvents.emit("error", err);
+    });
+    channel.on("close", () => {
+      channel = null;
+    });
+    channel.on("error", (err) => {
       rabbitEvents.emit("error", err);
     });
     return channel;
   } catch (err) {
-    connected = false;
+    connection = null;
+    channel = null;
     rabbitEvents.emit("error", err);
     throw err;
   }
 }
 function getChannel() {
   if (!channel) {
-    throw new Error("\u274C RabbitMQ not initialized. Call connectRabbitMQ()");
+    throw new Error(
+      "\u274C RabbitMQ channel not available. Call connectRabbitMQ()"
+    );
   }
   return channel;
 }
@@ -104,12 +115,11 @@ async function closeRabbitMQ() {
   } finally {
     channel = null;
     connection = null;
-    connected = false;
     rabbitEvents.emit("disconnected");
   }
 }
 function isRabbitConnected() {
-  return connected;
+  return Boolean(connection && channel);
 }
 
 // src/consumer.ts
@@ -219,7 +229,7 @@ async function bootstrap({
     await connectRabbitMQ(rabbit);
     logger.info("\u{1F407} RabbitMQ connected");
     await start();
-    logger.info("\u{1F680} Service started successfully");
+    logger.info(`\u{1F680} ${serviceName2} started successfully`);
     const shutdown = async (signal) => {
       logger.warn("\u{1F6D1} Shutdown signal received", { signal });
       await closeRabbitMQ();
@@ -239,12 +249,12 @@ async function bootstrap({
 
 // src/health/index.ts
 function rabbitHealth() {
-  const connected2 = isRabbitConnected();
+  const connected = isRabbitConnected();
   return {
     "\u{1F407}": {
       service: "rabbitmq",
-      status: connected2 ? "\u{1F7E2} up" : "\u{1F534} down",
-      healthy: connected2
+      status: connected ? "\u{1F7E2} up" : "\u{1F534} down",
+      healthy: connected
     }
   };
 }

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@kaushverse/rabbitmq-core",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "description": "Reusable RabbitMQ (AMQP / AMQPS) core for Node.js & microservices",
   "author": "Kaushik (KaushVerse)",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
-    "dist"
+    "dist",
+    "README.md"
   ],
   "scripts": {
     "build": "tsup src/index.ts --dts",