@samuelaj1/eazisend-service-kit 1.0.6 → 1.0.8

package/dist/chunk-TS72ONWN.js

@@ -0,0 +1,97 @@
+// src/middlewares/monitoring.middleware.ts
+import { collectDefaultMetrics, Counter, Gauge, Histogram, Registry } from "prom-client";
+var applications = /* @__PURE__ */ new WeakMap();
+var methods = /* @__PURE__ */ new Set(["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "CONNECT", "TRACE"]);
+function routeLabel(request) {
+  const path = request.route?.path;
+  if (typeof path === "string") return path;
+  if (Array.isArray(path) && path.every((value) => typeof value === "string")) {
+    return path.join("|");
+  }
+  return path instanceof RegExp ? "__regexp__" : "__unmatched__";
+}
+function setupMetrics(app, options) {
+  if (typeof options?.serviceName !== "string" || !options.serviceName.trim()) {
+    throw new Error("Metrics serviceName must be a non-empty string");
+  }
+  const existing = applications.get(app);
+  if (existing) {
+    if (existing.serviceName !== options.serviceName) {
+      throw new Error("Metrics already initialized with a different serviceName");
+    }
+    return existing.registry;
+  }
+  const registry = new Registry();
+  registry.setDefaultLabels({ service: options.serviceName });
+  collectDefaultMetrics({ register: registry });
+  const labelNames = ["method", "route", "status_code"];
+  const requests = new Counter({
+    name: "http_requests_total",
+    help: "Completed HTTP requests",
+    labelNames,
+    registers: [registry]
+  });
+  const duration = new Histogram({
+    name: "http_request_duration_seconds",
+    help: "HTTP request duration in seconds",
+    labelNames,
+    registers: [registry],
+    buckets: [5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+  });
+  const errors = new Counter({
+    name: "http_request_errors_total",
+    help: "Completed HTTP requests with 4xx or 5xx status",
+    labelNames,
+    registers: [registry]
+  });
+  const active = new Gauge({
+    name: "http_active_requests",
+    help: "HTTP requests currently in progress",
+    registers: [registry]
+  });
+  active.set(0);
+  const middleware = (request, response, next) => {
+    if (/^\/metrics\/?$/i.test(request.path)) return next();
+    const started = process.hrtime.bigint();
+    active.inc();
+    let completed = false;
+    const complete = () => {
+      if (completed) return;
+      completed = true;
+      response.removeListener("finish", complete);
+      response.removeListener("close", complete);
+      active.dec();
+      const labels = {
+        method: methods.has(request.method) ? request.method : "OTHER",
+        route: routeLabel(request),
+        // A disconnected response has no completed HTTP status.
+        status_code: response.writableFinished ? String(response.statusCode) : "aborted"
+      };
+      requests.inc(labels);
+      duration.observe(labels, Number(process.hrtime.bigint() - started) / 1e9);
+      if (response.writableFinished && response.statusCode >= 400 && response.statusCode < 600) {
+        errors.inc(labels);
+      }
+    };
+    response.once("finish", complete);
+    response.once("close", complete);
+    next();
+  };
+  app.use(middleware);
+  app.get("/metrics", async (_request, response, next) => {
+    try {
+      const metrics = await registry.metrics();
+      response.setHeader("Content-Type", registry.contentType);
+      response.setHeader("Cache-Control", "no-store");
+      response.end(metrics);
+    } catch (error) {
+      next(error);
+    }
+  });
+  applications.set(app, { serviceName: options.serviceName, registry });
+  return registry;
+}
+
+export {
+  setupMetrics
+};

package/dist/index.cjs

@@ -33,10 +33,12 @@ __export(index_exports, {
   LogLevelTypes: () => LogLevelTypes,
   elasticSearchRepo: () => elasticSearchRepo,
   loggerRepo: () => loggerRepo,
+  rabbitmqRepo: () => rabbitmqRepo,
   registerErrorMiddleware: () => registerErrorMiddleware,
   registerSecurityMiddleware: () => registerSecurityMiddleware,
   registerStandardMiddleware: () => registerStandardMiddleware,
   runServer: () => runServer,
+  setupMetrics: () => setupMetrics,
   verifyGatewayRequest: () => verifyGatewayRequest
 });
 module.exports = __toCommonJS(index_exports);
@@ -66,10 +68,13 @@ var Config = class {
   API_GATEWAY_URL;
   GATEWAY_TOKEN;
   ELASTIC_SEARCH_NODE_URL;
+  RABBITMQ_URL;
   PORT;
   constructor() {
     this.API_GATEWAY_URL = process.env.API_GATEWAY_URL || "";
     this.GATEWAY_TOKEN = process.env.GATEWAY_TOKEN || "";
+    this.ELASTIC_SEARCH_NODE_URL = process.env.ELASTIC_SEARCH_NODE_URL || "";
+    this.RABBITMQ_URL = process.env.RABBITMQ_URL || "";
     this.ELASTIC_SEARCH_NODE_URL = process.env.ELASTIC_SEARCH_NODE_URL?.trim() || "";
     this.PORT = process.env.PORT || "";
   }
@@ -197,6 +202,202 @@ var ElasticsearchRepo = class {
 };
 var elasticSearchRepo = new ElasticsearchRepo();
 
+// src/repositories/rabbitmq.repo.ts
+var import_amqplib = __toESM(require("amqplib"), 1);
+var RabbitmqRepo = class {
+  queueChannel;
+  pendingConnection;
+  /**
+   * Returns the shared channel, creating a connection when necessary.
+   *
+   * @example
+   * ```ts
+   * const channel = await rabbitmqRepo.getQueueConnection();
+   * ```
+   */
+  async getQueueConnection() {
+    if (this.queueChannel) {
+      return this.queueChannel;
+    }
+    if (this.pendingConnection) {
+      return this.pendingConnection;
+    }
+    this.pendingConnection = this.createQueueConnection();
+    try {
+      return await this.pendingConnection;
+    } finally {
+      this.pendingConnection = void 0;
+    }
+  }
+  async createQueueConnection() {
+    let connection;
+    try {
+      connection = await import_amqplib.default.connect(libConfig.RABBITMQ_URL);
+      const channel = await connection.createChannel();
+      const clearChannel = () => {
+        if (this.queueChannel === channel) {
+          this.queueChannel = void 0;
+        }
+      };
+      channel.on("error", (error) => {
+        clearChannel();
+        console.error("RabbitmqRepo channel error:", error);
+      });
+      channel.once("close", clearChannel);
+      connection.on("error", (error) => {
+        clearChannel();
+        console.error("RabbitmqRepo connection error:", error);
+      });
+      connection.once("close", clearChannel);
+      console.log("RabbitmqRepo connected to queue successfully...");
+      this.closeConnection(channel, connection);
+      this.queueChannel = channel;
+      return channel;
+    } catch (error) {
+      if (connection) {
+        await connection.close().catch((closeError) => {
+          console.error("RabbitmqRepo error closing failed connection:", closeError);
+        });
+      }
+      console.error("RabbitmqRepo error creating connection:", error);
+      return void 0;
+    }
+  }
+  /**
+   * Closes the channel and connection when the application shuts down.
+   */
+  closeConnection(channel, connection) {
+    let isClosing = false;
+    const close = async (signal) => {
+      if (isClosing) {
+        return;
+      }
+      isClosing = true;
+      try {
+        try {
+          await channel.close();
+        } finally {
+          await connection.close();
+        }
+        console.log(`RabbitmqRepo queue connection closed after ${signal}`);
+      } catch (error) {
+        console.error("RabbitmqRepo error closing connection:", error);
+      }
+    };
+    process.once("SIGINT", close);
+    process.once("SIGTERM", close);
+    connection.once("close", () => {
+      process.removeListener("SIGINT", close);
+      process.removeListener("SIGTERM", close);
+    });
+  }
+  /**
+   * Establishes the shared RabbitMQ connection during application startup.
+   *
+   * @example
+   * ```ts
+   * await rabbitmqRepo.establishQueueConnection();
+   * ```
+   */
+  async establishQueueConnection() {
+    const channel = await this.getQueueConnection();
+    if (!channel) {
+      throw new Error("No channel found.");
+    }
+  }
+  async connectQueueToExchange(channel, exchange, queueName, routingKey, exchangeType) {
+    await channel.assertExchange(exchange, exchangeType);
+    const q = await channel.assertQueue(queueName, { durable: true, autoDelete: false });
+    await channel.bindQueue(q.queue, exchange, routingKey);
+    return q;
+  }
+  /**
+   * Publishes a typed payload as JSON using the supplied exchange and routing key.
+   *
+   * @example
+   * ```ts
+   * await rabbitmqRepo.publishMessageToQueue<EmailPayload>({
+   *     exchange: 'notifications',
+   *     routingKey: 'email',
+   *     message: { receiverEmail, username, verifyLink, resetLink },
+   *     logMessage: 'Email notification published',
+   * });
+   * ```
+   */
+  async publishMessageToQueue(args) {
+    const serializedMessage = JSON.stringify(args.message);
+    if (serializedMessage === void 0) {
+      throw new Error("Message must be JSON serializable.");
+    }
+    const channel = await this.getQueueConnection();
+    const { exchange, routingKey, logMessage, exchangeType } = args;
+    if (!channel) {
+      throw new Error("No channel found.");
+    }
+    await channel.assertExchange(exchange, exchangeType || "direct");
+    channel.publish(exchange, routingKey, Buffer.from(serializedMessage));
+    if (logMessage) {
+      console.log(logMessage);
+    }
+  }
+  /**
+   * Consumes JSON messages and acknowledges them after the callback succeeds.
+   * Prefetch defaults to 10 when omitted.
+   *
+   * @example
+   * ```ts
+   * await rabbitmqRepo.consumeMessagesFromQueue<EmailPayload>({
+   *     exchange: 'notifications',
+   *     queueName: 'email-queue',
+   *     routingKey: 'email',
+   *     prefetch: 5,
+   *     callback: async ({ receiverEmail, username, verifyLink, resetLink }) => {
+   *         // Process the email.
+   *     },
+   * });
+   * ```
+   */
+  async consumeMessagesFromQueue(args) {
+    const { exchange, queueName, routingKey, callback } = args;
+    const prefetch = args.prefetch ?? 10;
+    if (!Number.isInteger(prefetch) || prefetch < 1 || prefetch > 65535) {
+      throw new Error("Prefetch must be an integer between 1 and 65535.");
+    }
+    const channel = args.channel ?? await this.getQueueConnection();
+    if (!channel) {
+      throw new Error("No channel found.");
+    }
+    const q = await this.connectQueueToExchange(channel, exchange, queueName, routingKey, args.exchangeType ?? "direct");
+    await channel.prefetch(prefetch, false);
+    await channel.consume(q.queue, async (message) => {
+      if (!message) {
+        return;
+      }
+      try {
+        let payload;
+        try {
+          payload = JSON.parse(message.content.toString());
+        } catch (error) {
+          console.error("RabbitmqRepo invalid JSON message:", error);
+          channel.nack(message, false, false);
+          return;
+        }
+        try {
+          await callback(payload);
+        } catch (error) {
+          console.error("RabbitmqRepo message callback failed:", error);
+          channel.nack(message, false, true);
+          return;
+        }
+        channel.ack(message);
+      } catch (error) {
+        console.error("RabbitmqRepo error settling message:", error);
+      }
+    });
+  }
+};
+var rabbitmqRepo = new RabbitmqRepo();
+
 // src/middlewares/gateway.middleware.ts
 var import_jsonwebtoken = __toESM(require("jsonwebtoken"), 1);
 function verifyGatewayRequest(serviceId) {
@@ -228,14 +429,110 @@ function registerErrorMiddleware(app) {
     res.status(import_http_status_codes.StatusCodes.INTERNAL_SERVER_ERROR).json({ error: err.message });
   };
 }
+
+// src/middlewares/monitoring.middleware.ts
+var import_prom_client = require("prom-client");
+var applications = /* @__PURE__ */ new WeakMap();
+var methods = /* @__PURE__ */ new Set(["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "CONNECT", "TRACE"]);
+function routeLabel(request) {
+  const path = request.route?.path;
+  if (typeof path === "string") return path;
+  if (Array.isArray(path) && path.every((value) => typeof value === "string")) {
+    return path.join("|");
+  }
+  return path instanceof RegExp ? "__regexp__" : "__unmatched__";
+}
+function setupMetrics(app, options) {
+  if (typeof options?.serviceName !== "string" || !options.serviceName.trim()) {
+    throw new Error("Metrics serviceName must be a non-empty string");
+  }
+  const existing = applications.get(app);
+  if (existing) {
+    if (existing.serviceName !== options.serviceName) {
+      throw new Error("Metrics already initialized with a different serviceName");
+    }
+    return existing.registry;
+  }
+  const registry = new import_prom_client.Registry();
+  registry.setDefaultLabels({ service: options.serviceName });
+  (0, import_prom_client.collectDefaultMetrics)({ register: registry });
+  const labelNames = ["method", "route", "status_code"];
+  const requests = new import_prom_client.Counter({
+    name: "http_requests_total",
+    help: "Completed HTTP requests",
+    labelNames,
+    registers: [registry]
+  });
+  const duration = new import_prom_client.Histogram({
+    name: "http_request_duration_seconds",
+    help: "HTTP request duration in seconds",
+    labelNames,
+    registers: [registry],
+    buckets: [5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+  });
+  const errors = new import_prom_client.Counter({
+    name: "http_request_errors_total",
+    help: "Completed HTTP requests with 4xx or 5xx status",
+    labelNames,
+    registers: [registry]
+  });
+  const active = new import_prom_client.Gauge({
+    name: "http_active_requests",
+    help: "HTTP requests currently in progress",
+    registers: [registry]
+  });
+  active.set(0);
+  const middleware = (request, response, next) => {
+    if (/^\/metrics\/?$/i.test(request.path)) return next();
+    const started = process.hrtime.bigint();
+    active.inc();
+    let completed = false;
+    const complete = () => {
+      if (completed) return;
+      completed = true;
+      response.removeListener("finish", complete);
+      response.removeListener("close", complete);
+      active.dec();
+      const labels = {
+        method: methods.has(request.method) ? request.method : "OTHER",
+        route: routeLabel(request),
+        // A disconnected response has no completed HTTP status.
+        status_code: response.writableFinished ? String(response.statusCode) : "aborted"
+      };
+      requests.inc(labels);
+      duration.observe(labels, Number(process.hrtime.bigint() - started) / 1e9);
+      if (response.writableFinished && response.statusCode >= 400 && response.statusCode < 600) {
+        errors.inc(labels);
+      }
+    };
+    response.once("finish", complete);
+    response.once("close", complete);
+    next();
+  };
+  app.use(middleware);
+  app.get("/metrics", async (_request, response, next) => {
+    try {
+      const metrics = await registry.metrics();
+      response.setHeader("Content-Type", registry.contentType);
+      response.setHeader("Cache-Control", "no-store");
+      response.end(metrics);
+    } catch (error) {
+      next(error);
+    }
+  });
+  applications.set(app, { serviceName: options.serviceName, registry });
+  return registry;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   LogLevelTypes,
   elasticSearchRepo,
   loggerRepo,
+  rabbitmqRepo,
   registerErrorMiddleware,
   registerSecurityMiddleware,
   registerStandardMiddleware,
   runServer,
+  setupMetrics,
   verifyGatewayRequest
 });

package/dist/index.d.cts

@@ -1,5 +1,8 @@
 import { Express, Request, Response, NextFunction, Application } from 'express';
 import { LogEntry } from 'winston';
+import { Channel } from 'amqplib';
+export { MetricsOptions, setupMetrics } from './middlewares/monitoring.middleware.cjs';
+import 'prom-client';
 
 declare function registerStandardMiddleware(app: Express): void;
 
@@ -27,7 +30,7 @@ declare function runServer(app: Express): void;
 
 /** Configured Elasticsearch cluster */
 declare class ElasticsearchRepo {
-    private elasticSearchClient?;
+    private readonly elasticSearchClient?;
     /** Creates an Elasticsearch client using the configured cluster URL. */
     constructor();
     /**  Elasticsearch connection is established. */
@@ -37,8 +40,84 @@ declare class ElasticsearchRepo {
 }
 declare const elasticSearchRepo: ElasticsearchRepo;
 
+declare class RabbitmqRepo {
+    private queueChannel;
+    private pendingConnection;
+    /**
+     * Returns the shared channel, creating a connection when necessary.
+     *
+     * @example
+     * ```ts
+     * const channel = await rabbitmqRepo.getQueueConnection();
+     * ```
+     */
+    getQueueConnection(): Promise<Channel | undefined>;
+    private createQueueConnection;
+    /**
+     * Closes the channel and connection when the application shuts down.
+     */
+    private closeConnection;
+    /**
+     * Establishes the shared RabbitMQ connection during application startup.
+     *
+     * @example
+     * ```ts
+     * await rabbitmqRepo.establishQueueConnection();
+     * ```
+     */
+    establishQueueConnection(): Promise<void>;
+    private connectQueueToExchange;
+    /**
+     * Publishes a typed payload as JSON using the supplied exchange and routing key.
+     *
+     * @example
+     * ```ts
+     * await rabbitmqRepo.publishMessageToQueue<EmailPayload>({
+     *     exchange: 'notifications',
+     *     routingKey: 'email',
+     *     message: { receiverEmail, username, verifyLink, resetLink },
+     *     logMessage: 'Email notification published',
+     * });
+     * ```
+     */
+    publishMessageToQueue<T>(args: {
+        exchange: string;
+        routingKey: string;
+        message: T;
+        logMessage?: string;
+        exchangeType?: 'direct' | 'fanout';
+    }): Promise<void>;
+    /**
+     * Consumes JSON messages and acknowledges them after the callback succeeds.
+     * Prefetch defaults to 10 when omitted.
+     *
+     * @example
+     * ```ts
+     * await rabbitmqRepo.consumeMessagesFromQueue<EmailPayload>({
+     *     exchange: 'notifications',
+     *     queueName: 'email-queue',
+     *     routingKey: 'email',
+     *     prefetch: 5,
+     *     callback: async ({ receiverEmail, username, verifyLink, resetLink }) => {
+     *         // Process the email.
+     *     },
+     * });
+     * ```
+     */
+    consumeMessagesFromQueue<T = unknown>(args: {
+        exchange: string;
+        queueName: string;
+        routingKey: string;
+        callback: (payload: T) => void | Promise<void>;
+        channel?: Channel;
+        exchangeType?: 'direct' | 'fanout';
+        prefetch?: number;
+    }): Promise<void>;
+}
+declare const rabbitmqRepo: RabbitmqRepo;
+
 declare function verifyGatewayRequest(serviceId: string): (req: Request, _res: Response, next: NextFunction) => void;
 
 declare function registerErrorMiddleware(app: Application): (err: Error, _req: Request, res: Response, _next: NextFunction) => void;
 
-export { LogLevelTypes, elasticSearchRepo, loggerRepo, registerErrorMiddleware, registerSecurityMiddleware, registerStandardMiddleware, runServer, verifyGatewayRequest };
+export { LogLevelTypes, elasticSearchRepo, loggerRepo, rabbitmqRepo, registerErrorMiddleware, registerSecurityMiddleware, registerStandardMiddleware, runServer, verifyGatewayRequest };

package/dist/index.d.ts

@@ -1,5 +1,8 @@
 import { Express, Request, Response, NextFunction, Application } from 'express';
 import { LogEntry } from 'winston';
+import { Channel } from 'amqplib';
+export { MetricsOptions, setupMetrics } from './middlewares/monitoring.middleware.js';
+import 'prom-client';
 
 declare function registerStandardMiddleware(app: Express): void;
 
@@ -27,7 +30,7 @@ declare function runServer(app: Express): void;
 
 /** Configured Elasticsearch cluster */
 declare class ElasticsearchRepo {
-    private elasticSearchClient?;
+    private readonly elasticSearchClient?;
     /** Creates an Elasticsearch client using the configured cluster URL. */
     constructor();
     /**  Elasticsearch connection is established. */
@@ -37,8 +40,84 @@ declare class ElasticsearchRepo {
 }
 declare const elasticSearchRepo: ElasticsearchRepo;
 
+declare class RabbitmqRepo {
+    private queueChannel;
+    private pendingConnection;
+    /**
+     * Returns the shared channel, creating a connection when necessary.
+     *
+     * @example
+     * ```ts
+     * const channel = await rabbitmqRepo.getQueueConnection();
+     * ```
+     */
+    getQueueConnection(): Promise<Channel | undefined>;
+    private createQueueConnection;
+    /**
+     * Closes the channel and connection when the application shuts down.
+     */
+    private closeConnection;
+    /**
+     * Establishes the shared RabbitMQ connection during application startup.
+     *
+     * @example
+     * ```ts
+     * await rabbitmqRepo.establishQueueConnection();
+     * ```
+     */
+    establishQueueConnection(): Promise<void>;
+    private connectQueueToExchange;
+    /**
+     * Publishes a typed payload as JSON using the supplied exchange and routing key.
+     *
+     * @example
+     * ```ts
+     * await rabbitmqRepo.publishMessageToQueue<EmailPayload>({
+     *     exchange: 'notifications',
+     *     routingKey: 'email',
+     *     message: { receiverEmail, username, verifyLink, resetLink },
+     *     logMessage: 'Email notification published',
+     * });
+     * ```
+     */
+    publishMessageToQueue<T>(args: {
+        exchange: string;
+        routingKey: string;
+        message: T;
+        logMessage?: string;
+        exchangeType?: 'direct' | 'fanout';
+    }): Promise<void>;
+    /**
+     * Consumes JSON messages and acknowledges them after the callback succeeds.
+     * Prefetch defaults to 10 when omitted.
+     *
+     * @example
+     * ```ts
+     * await rabbitmqRepo.consumeMessagesFromQueue<EmailPayload>({
+     *     exchange: 'notifications',
+     *     queueName: 'email-queue',
+     *     routingKey: 'email',
+     *     prefetch: 5,
+     *     callback: async ({ receiverEmail, username, verifyLink, resetLink }) => {
+     *         // Process the email.
+     *     },
+     * });
+     * ```
+     */
+    consumeMessagesFromQueue<T = unknown>(args: {
+        exchange: string;
+        queueName: string;
+        routingKey: string;
+        callback: (payload: T) => void | Promise<void>;
+        channel?: Channel;
+        exchangeType?: 'direct' | 'fanout';
+        prefetch?: number;
+    }): Promise<void>;
+}
+declare const rabbitmqRepo: RabbitmqRepo;
+
 declare function verifyGatewayRequest(serviceId: string): (req: Request, _res: Response, next: NextFunction) => void;
 
 declare function registerErrorMiddleware(app: Application): (err: Error, _req: Request, res: Response, _next: NextFunction) => void;
 
-export { LogLevelTypes, elasticSearchRepo, loggerRepo, registerErrorMiddleware, registerSecurityMiddleware, registerStandardMiddleware, runServer, verifyGatewayRequest };
+export { LogLevelTypes, elasticSearchRepo, loggerRepo, rabbitmqRepo, registerErrorMiddleware, registerSecurityMiddleware, registerStandardMiddleware, runServer, verifyGatewayRequest };

package/dist/index.js

@@ -1,3 +1,7 @@
+import {
+  setupMetrics
+} from "./chunk-TS72ONWN.js";
+
 // src/middlewares/standard.middleware.ts
 import { json, urlencoded } from "express";
 import compression from "compression";
@@ -19,10 +23,13 @@ var Config = class {
   API_GATEWAY_URL;
   GATEWAY_TOKEN;
   ELASTIC_SEARCH_NODE_URL;
+  RABBITMQ_URL;
   PORT;
   constructor() {
     this.API_GATEWAY_URL = process.env.API_GATEWAY_URL || "";
     this.GATEWAY_TOKEN = process.env.GATEWAY_TOKEN || "";
+    this.ELASTIC_SEARCH_NODE_URL = process.env.ELASTIC_SEARCH_NODE_URL || "";
+    this.RABBITMQ_URL = process.env.RABBITMQ_URL || "";
     this.ELASTIC_SEARCH_NODE_URL = process.env.ELASTIC_SEARCH_NODE_URL?.trim() || "";
     this.PORT = process.env.PORT || "";
   }
@@ -150,6 +157,202 @@ var ElasticsearchRepo = class {
 };
 var elasticSearchRepo = new ElasticsearchRepo();
 
+// src/repositories/rabbitmq.repo.ts
+import amqp from "amqplib";
+var RabbitmqRepo = class {
+  queueChannel;
+  pendingConnection;
+  /**
+   * Returns the shared channel, creating a connection when necessary.
+   *
+   * @example
+   * ```ts
+   * const channel = await rabbitmqRepo.getQueueConnection();
+   * ```
+   */
+  async getQueueConnection() {
+    if (this.queueChannel) {
+      return this.queueChannel;
+    }
+    if (this.pendingConnection) {
+      return this.pendingConnection;
+    }
+    this.pendingConnection = this.createQueueConnection();
+    try {
+      return await this.pendingConnection;
+    } finally {
+      this.pendingConnection = void 0;
+    }
+  }
+  async createQueueConnection() {
+    let connection;
+    try {
+      connection = await amqp.connect(libConfig.RABBITMQ_URL);
+      const channel = await connection.createChannel();
+      const clearChannel = () => {
+        if (this.queueChannel === channel) {
+          this.queueChannel = void 0;
+        }
+      };
+      channel.on("error", (error) => {
+        clearChannel();
+        console.error("RabbitmqRepo channel error:", error);
+      });
+      channel.once("close", clearChannel);
+      connection.on("error", (error) => {
+        clearChannel();
+        console.error("RabbitmqRepo connection error:", error);
+      });
+      connection.once("close", clearChannel);
+      console.log("RabbitmqRepo connected to queue successfully...");
+      this.closeConnection(channel, connection);
+      this.queueChannel = channel;
+      return channel;
+    } catch (error) {
+      if (connection) {
+        await connection.close().catch((closeError) => {
+          console.error("RabbitmqRepo error closing failed connection:", closeError);
+        });
+      }
+      console.error("RabbitmqRepo error creating connection:", error);
+      return void 0;
+    }
+  }
+  /**
+   * Closes the channel and connection when the application shuts down.
+   */
+  closeConnection(channel, connection) {
+    let isClosing = false;
+    const close = async (signal) => {
+      if (isClosing) {
+        return;
+      }
+      isClosing = true;
+      try {
+        try {
+          await channel.close();
+        } finally {
+          await connection.close();
+        }
+        console.log(`RabbitmqRepo queue connection closed after ${signal}`);
+      } catch (error) {
+        console.error("RabbitmqRepo error closing connection:", error);
+      }
+    };
+    process.once("SIGINT", close);
+    process.once("SIGTERM", close);
+    connection.once("close", () => {
+      process.removeListener("SIGINT", close);
+      process.removeListener("SIGTERM", close);
+    });
+  }
+  /**
+   * Establishes the shared RabbitMQ connection during application startup.
+   *
+   * @example
+   * ```ts
+   * await rabbitmqRepo.establishQueueConnection();
+   * ```
+   */
+  async establishQueueConnection() {
+    const channel = await this.getQueueConnection();
+    if (!channel) {
+      throw new Error("No channel found.");
+    }
+  }
+  async connectQueueToExchange(channel, exchange, queueName, routingKey, exchangeType) {
+    await channel.assertExchange(exchange, exchangeType);
+    const q = await channel.assertQueue(queueName, { durable: true, autoDelete: false });
+    await channel.bindQueue(q.queue, exchange, routingKey);
+    return q;
+  }
+  /**
+   * Publishes a typed payload as JSON using the supplied exchange and routing key.
+   *
+   * @example
+   * ```ts
+   * await rabbitmqRepo.publishMessageToQueue<EmailPayload>({
+   *     exchange: 'notifications',
+   *     routingKey: 'email',
+   *     message: { receiverEmail, username, verifyLink, resetLink },
+   *     logMessage: 'Email notification published',
+   * });
+   * ```
+   */
+  async publishMessageToQueue(args) {
+    const serializedMessage = JSON.stringify(args.message);
+    if (serializedMessage === void 0) {
+      throw new Error("Message must be JSON serializable.");
+    }
+    const channel = await this.getQueueConnection();
+    const { exchange, routingKey, logMessage, exchangeType } = args;
+    if (!channel) {
+      throw new Error("No channel found.");
+    }
+    await channel.assertExchange(exchange, exchangeType || "direct");
+    channel.publish(exchange, routingKey, Buffer.from(serializedMessage));
+    if (logMessage) {
+      console.log(logMessage);
+    }
+  }
+  /**
+   * Consumes JSON messages and acknowledges them after the callback succeeds.
+   * Prefetch defaults to 10 when omitted.
+   *
+   * @example
+   * ```ts
+   * await rabbitmqRepo.consumeMessagesFromQueue<EmailPayload>({
+   *     exchange: 'notifications',
+   *     queueName: 'email-queue',
+   *     routingKey: 'email',
+   *     prefetch: 5,
+   *     callback: async ({ receiverEmail, username, verifyLink, resetLink }) => {
+   *         // Process the email.
+   *     },
+   * });
+   * ```
+   */
+  async consumeMessagesFromQueue(args) {
+    const { exchange, queueName, routingKey, callback } = args;
+    const prefetch = args.prefetch ?? 10;
+    if (!Number.isInteger(prefetch) || prefetch < 1 || prefetch > 65535) {
+      throw new Error("Prefetch must be an integer between 1 and 65535.");
+    }
+    const channel = args.channel ?? await this.getQueueConnection();
+    if (!channel) {
+      throw new Error("No channel found.");
+    }
+    const q = await this.connectQueueToExchange(channel, exchange, queueName, routingKey, args.exchangeType ?? "direct");
+    await channel.prefetch(prefetch, false);
+    await channel.consume(q.queue, async (message) => {
+      if (!message) {
+        return;
+      }
+      try {
+        let payload;
+        try {
+          payload = JSON.parse(message.content.toString());
+        } catch (error) {
+          console.error("RabbitmqRepo invalid JSON message:", error);
+          channel.nack(message, false, false);
+          return;
+        }
+        try {
+          await callback(payload);
+        } catch (error) {
+          console.error("RabbitmqRepo message callback failed:", error);
+          channel.nack(message, false, true);
+          return;
+        }
+        channel.ack(message);
+      } catch (error) {
+        console.error("RabbitmqRepo error settling message:", error);
+      }
+    });
+  }
+};
+var rabbitmqRepo = new RabbitmqRepo();
+
 // src/middlewares/gateway.middleware.ts
 import jwt from "jsonwebtoken";
 function verifyGatewayRequest(serviceId) {
@@ -185,9 +388,11 @@ export {
   LogLevelTypes,
   elasticSearchRepo,
   loggerRepo,
+  rabbitmqRepo,
   registerErrorMiddleware,
   registerSecurityMiddleware,
   registerStandardMiddleware,
   runServer,
+  setupMetrics,
   verifyGatewayRequest
 };

package/dist/middlewares/monitoring.middleware.cjs

@@ -0,0 +1,121 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/middlewares/monitoring.middleware.ts
+var monitoring_middleware_exports = {};
+__export(monitoring_middleware_exports, {
+  setupMetrics: () => setupMetrics
+});
+module.exports = __toCommonJS(monitoring_middleware_exports);
+var import_prom_client = require("prom-client");
+var applications = /* @__PURE__ */ new WeakMap();
+var methods = /* @__PURE__ */ new Set(["GET", "HEAD", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "CONNECT", "TRACE"]);
+function routeLabel(request) {
+  const path = request.route?.path;
+  if (typeof path === "string") return path;
+  if (Array.isArray(path) && path.every((value) => typeof value === "string")) {
+    return path.join("|");
+  }
+  return path instanceof RegExp ? "__regexp__" : "__unmatched__";
+}
+function setupMetrics(app, options) {
+  if (typeof options?.serviceName !== "string" || !options.serviceName.trim()) {
+    throw new Error("Metrics serviceName must be a non-empty string");
+  }
+  const existing = applications.get(app);
+  if (existing) {
+    if (existing.serviceName !== options.serviceName) {
+      throw new Error("Metrics already initialized with a different serviceName");
+    }
+    return existing.registry;
+  }
+  const registry = new import_prom_client.Registry();
+  registry.setDefaultLabels({ service: options.serviceName });
+  (0, import_prom_client.collectDefaultMetrics)({ register: registry });
+  const labelNames = ["method", "route", "status_code"];
+  const requests = new import_prom_client.Counter({
+    name: "http_requests_total",
+    help: "Completed HTTP requests",
+    labelNames,
+    registers: [registry]
+  });
+  const duration = new import_prom_client.Histogram({
+    name: "http_request_duration_seconds",
+    help: "HTTP request duration in seconds",
+    labelNames,
+    registers: [registry],
+    buckets: [5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+  });
+  const errors = new import_prom_client.Counter({
+    name: "http_request_errors_total",
+    help: "Completed HTTP requests with 4xx or 5xx status",
+    labelNames,
+    registers: [registry]
+  });
+  const active = new import_prom_client.Gauge({
+    name: "http_active_requests",
+    help: "HTTP requests currently in progress",
+    registers: [registry]
+  });
+  active.set(0);
+  const middleware = (request, response, next) => {
+    if (/^\/metrics\/?$/i.test(request.path)) return next();
+    const started = process.hrtime.bigint();
+    active.inc();
+    let completed = false;
+    const complete = () => {
+      if (completed) return;
+      completed = true;
+      response.removeListener("finish", complete);
+      response.removeListener("close", complete);
+      active.dec();
+      const labels = {
+        method: methods.has(request.method) ? request.method : "OTHER",
+        route: routeLabel(request),
+        // A disconnected response has no completed HTTP status.
+        status_code: response.writableFinished ? String(response.statusCode) : "aborted"
+      };
+      requests.inc(labels);
+      duration.observe(labels, Number(process.hrtime.bigint() - started) / 1e9);
+      if (response.writableFinished && response.statusCode >= 400 && response.statusCode < 600) {
+        errors.inc(labels);
+      }
+    };
+    response.once("finish", complete);
+    response.once("close", complete);
+    next();
+  };
+  app.use(middleware);
+  app.get("/metrics", async (_request, response, next) => {
+    try {
+      const metrics = await registry.metrics();
+      response.setHeader("Content-Type", registry.contentType);
+      response.setHeader("Cache-Control", "no-store");
+      response.end(metrics);
+    } catch (error) {
+      next(error);
+    }
+  });
+  applications.set(app, { serviceName: options.serviceName, registry });
+  return registry;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  setupMetrics
+});

package/dist/middlewares/monitoring.middleware.d.cts

@@ -0,0 +1,15 @@
+import { Express } from 'express';
+import { Registry } from 'prom-client';
+
+interface MetricsOptions {
+    serviceName: string;
+}
+/**
+ * Register before authentication and application routes so GET /metrics bypasses auth.
+ * Restrict /metrics to internal access at the Kubernetes networking/Ingress level.
+ * Returns an app-local registry for custom metrics (use registers: [registry]).
+ * Router labels use leaf templates, omitting potentially dynamic mount prefixes.
+ */
+declare function setupMetrics(app: Express, options: MetricsOptions): Registry;
+
+export { type MetricsOptions, setupMetrics };

package/dist/middlewares/monitoring.middleware.d.ts

@@ -0,0 +1,15 @@
+import { Express } from 'express';
+import { Registry } from 'prom-client';
+
+interface MetricsOptions {
+    serviceName: string;
+}
+/**
+ * Register before authentication and application routes so GET /metrics bypasses auth.
+ * Restrict /metrics to internal access at the Kubernetes networking/Ingress level.
+ * Returns an app-local registry for custom metrics (use registers: [registry]).
+ * Router labels use leaf templates, omitting potentially dynamic mount prefixes.
+ */
+declare function setupMetrics(app: Express, options: MetricsOptions): Registry;
+
+export { type MetricsOptions, setupMetrics };

package/dist/middlewares/monitoring.middleware.js

@@ -0,0 +1,6 @@
+import {
+  setupMetrics
+} from "../chunk-TS72ONWN.js";
+export {
+  setupMetrics
+};

package/package.json

@@ -1,10 +1,20 @@
 {
   "name": "@samuelaj1/eazisend-service-kit",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "scripts": {
     "build": "tsup"
   },
   "exports": {
+    "./monitoring": {
+      "import": {
+        "types": "./dist/middlewares/monitoring.middleware.d.ts",
+        "default": "./dist/middlewares/monitoring.middleware.js"
+      },
+      "require": {
+        "types": "./dist/middlewares/monitoring.middleware.d.cts",
+        "default": "./dist/middlewares/monitoring.middleware.cjs"
+      }
+    },
     ".": {
       "import": {
         "types": "./dist/index.d.ts",
@@ -29,25 +39,28 @@
   "license": "MIT",
   "type": "module",
   "devDependencies": {
+    "@types/amqplib": "^0.10.8",
+    "@types/compression": "^1.8.1",
+    "@types/cors": "^2.8.19",
     "@types/express": "^5.0.6",
+    "@types/hpp": "^0.2.7",
     "@types/jsonwebtoken": "^9.0.10",
     "tsup": "^8.5.1",
-    "typescript": "^6.0.3",
-    "@types/cors": "^2.8.19",
-    "@types/hpp": "^0.2.7",
-    "@types/compression": "^1.8.1"
+    "typescript": "^6.0.3"
   },
   "dependencies": {
     "@elastic/elasticsearch": "^9.4.2",
+    "amqplib": "^2.2.0",
+    "compression": "^1.8.1",
+    "cors": "^2.8.6",
     "dotenv": "^17.4.2",
     "express": "^5.2.1",
+    "helmet": "^8.3.0",
+    "hpp": "^0.2.3",
     "http-status-codes": "^2.3.0",
     "jsonwebtoken": "^9.0.3",
+    "prom-client": "^15.1.3",
     "winston": "^3.19.0",
-    "winston-elasticsearch": "^0.19.0",
-    "helmet": "^8.3.0",
-    "hpp": "^0.2.3",
-    "cors": "^2.8.6",
-    "compression": "^1.8.1"
+    "winston-elasticsearch": "^0.19.0"
   }
 }