@nestjs-redisx/metrics 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NestJS RedisX Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,46 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/nestjs-redisx/nestjs-redisx/main/website/public/images/logo.png" alt="NestJS RedisX" />
+</p>
+
+# @nestjs-redisx/metrics
+
+[![npm](https://img.shields.io/npm/v/@nestjs-redisx/metrics)](https://www.npmjs.com/package/@nestjs-redisx/metrics)
+[![npm downloads](https://img.shields.io/npm/dm/@nestjs-redisx/metrics)](https://www.npmjs.com/package/@nestjs-redisx/metrics)
+[![license](https://img.shields.io/npm/l/@nestjs-redisx/metrics)](https://opensource.org/licenses/MIT)
+
+Prometheus metrics plugin for NestJS RedisX. Exposes Redis command latencies, connection pool stats, cache hit rates, and custom metrics via a `/metrics` endpoint. `prom-client` is bundled.
+
+## Installation
+
+```bash
+npm install @nestjs-redisx/core @nestjs-redisx/metrics ioredis
+```
+
+## Quick Example
+
+```typescript
+import { RedisModule } from '@nestjs-redisx/core';
+import { MetricsPlugin } from '@nestjs-redisx/metrics';
+
+@Module({
+  imports: [
+    RedisModule.forRoot({
+      clients: { host: 'localhost', port: 6379 },
+      plugins: [
+        new MetricsPlugin({ prefix: 'redisx_', exposeEndpoint: true }),
+      ],
+    }),
+  ],
+})
+export class AppModule {}
+
+// Scrape: curl http://localhost:3000/metrics
+```
+
+## Documentation
+
+Full documentation: [nestjs-redisx.dev/en/reference/metrics/](https://nestjs-redisx.dev/en/reference/metrics/)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { MetricsPlugin } from './metrics.plugin';
+export { MetricsService } from './metrics/application/services/metrics.service';
+export type { IMetricsService } from './metrics/application/ports';
+export { MetricsController } from './metrics/api/controllers/metrics.controller';
+export type { IMetricsPluginOptions, IMetricsJson } from './shared/types';
+export { MetricsError, MetricRegistrationError } from './shared/errors';
+export { METRICS_PLUGIN_OPTIONS, METRICS_SERVICE, METRICS_REGISTRY } from './shared/constants';
+//# 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":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAGhF,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAGnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AAGjF,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAG1E,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAGxE,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,352 @@
+'use strict';
+
+var common = require('@nestjs/common');
+var promClient = require('prom-client');
+var core = require('@nestjs-redisx/core');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var promClient__namespace = /*#__PURE__*/_interopNamespace(promClient);
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// src/shared/constants/index.ts
+var METRICS_PLUGIN_OPTIONS = /* @__PURE__ */ Symbol.for("METRICS_PLUGIN_OPTIONS");
+var METRICS_SERVICE = /* @__PURE__ */ Symbol.for("METRICS_SERVICE");
+var METRICS_REGISTRY = /* @__PURE__ */ Symbol.for("METRICS_REGISTRY");
+var MetricsError = class extends core.RedisXError {
+  constructor(message, cause) {
+    super(message, core.ErrorCode.OP_FAILED, cause);
+  }
+};
+var MetricRegistrationError = class extends MetricsError {
+  constructor(metricName, cause) {
+    super(`Failed to register metric "${metricName}"`, cause);
+  }
+};
+
+// src/metrics/application/services/metrics.service.ts
+exports.MetricsService = class MetricsService {
+  constructor(config) {
+    this.config = config;
+    this.enabled = config.enabled !== false;
+    this.prefix = config.prefix ?? "redisx_";
+    this.defaultLabels = config.defaultLabels ?? {};
+    this.latencyBuckets = config.histogramBuckets ?? [1e-3, 5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+    this.registry = new promClient__namespace.Registry();
+    this.registry.setDefaultLabels(this.defaultLabels);
+  }
+  registry;
+  counters = /* @__PURE__ */ new Map();
+  histograms = /* @__PURE__ */ new Map();
+  gauges = /* @__PURE__ */ new Map();
+  prefix;
+  defaultLabels;
+  latencyBuckets;
+  enabled;
+  defaultMetricsInterval;
+  onModuleInit() {
+    if (!this.enabled) {
+      return;
+    }
+    this.registerStandardMetrics();
+    if (this.config.collectDefaultMetrics !== false) {
+      const collectInterval = this.config.collectInterval ?? 15e3;
+      promClient__namespace.collectDefaultMetrics({
+        register: this.registry,
+        prefix: this.prefix,
+        ...collectInterval > 0 ? { timeout: collectInterval } : {}
+      });
+    }
+  }
+  onModuleDestroy() {
+    this.registry.clear();
+  }
+  registerStandardMetrics() {
+    const commandMetrics = this.config.commandMetrics !== false;
+    const pluginMetrics = this.config.pluginMetrics !== false;
+    if (commandMetrics) {
+      this.registerCounter(`${this.prefix}commands_total`, "Total Redis commands executed", ["command", "client", "status"]);
+      this.registerHistogram(`${this.prefix}command_duration_seconds`, "Redis command latency in seconds", ["command", "client"], this.latencyBuckets);
+      this.registerGauge(`${this.prefix}connections_active`, "Number of active Redis connections", ["client"]);
+      this.registerCounter(`${this.prefix}errors_total`, "Total Redis errors", ["client", "error_type"]);
+    }
+    if (pluginMetrics) {
+      this.registerCounter(`${this.prefix}cache_hits_total`, "Total cache hits", ["layer"]);
+      this.registerCounter(`${this.prefix}cache_misses_total`, "Total cache misses", ["layer"]);
+      this.registerGauge(`${this.prefix}cache_hit_ratio`, "Cache hit ratio (0-1)", ["layer"]);
+      this.registerGauge(`${this.prefix}cache_size`, "Current cache size", ["layer"]);
+      this.registerCounter(`${this.prefix}cache_stampede_prevented_total`, "Total cache stampede prevention activations");
+      this.registerCounter(`${this.prefix}lock_acquisitions_total`, "Total lock acquisition attempts", ["status"]);
+      this.registerHistogram(`${this.prefix}lock_wait_duration_seconds`, "Lock wait time in seconds", [], this.latencyBuckets);
+      this.registerHistogram(`${this.prefix}lock_hold_duration_seconds`, "Lock hold time in seconds", [], this.latencyBuckets);
+      this.registerGauge(`${this.prefix}locks_active`, "Number of currently held locks");
+      this.registerCounter(`${this.prefix}ratelimit_requests_total`, "Total rate limit requests", ["status"]);
+      this.registerCounter(`${this.prefix}stream_messages_published_total`, "Total stream messages published", ["stream"]);
+      this.registerCounter(`${this.prefix}stream_messages_consumed_total`, "Total stream messages consumed", ["stream", "group", "status"]);
+      this.registerHistogram(`${this.prefix}stream_publish_duration_seconds`, "Stream publish latency in seconds", ["stream"], this.latencyBuckets);
+      this.registerCounter(`${this.prefix}stream_publish_errors_total`, "Total stream publish errors", ["stream"]);
+      this.registerHistogram(`${this.prefix}stream_processing_duration_seconds`, "Stream message processing time in seconds", ["stream", "group"], this.latencyBuckets);
+      this.registerCounter(`${this.prefix}idempotency_requests_total`, "Total idempotency requests", ["status"]);
+      this.registerHistogram(`${this.prefix}idempotency_duration_seconds`, "Idempotency check duration in seconds", [], this.latencyBuckets);
+    }
+  }
+  incrementCounter(name, labels, value = 1) {
+    if (!this.enabled) {
+      return;
+    }
+    const counter = this.counters.get(name);
+    if (!counter) {
+      return;
+    }
+    if (labels) {
+      counter.inc(labels, value);
+    } else {
+      counter.inc(value);
+    }
+  }
+  observeHistogram(name, value, labels) {
+    if (!this.enabled) {
+      return;
+    }
+    const histogram = this.histograms.get(name);
+    if (!histogram) {
+      return;
+    }
+    if (labels) {
+      histogram.observe(labels, value);
+    } else {
+      histogram.observe(value);
+    }
+  }
+  startTimer(name, labels) {
+    if (!this.enabled) {
+      return () => 0;
+    }
+    const histogram = this.histograms.get(name);
+    if (!histogram) {
+      return () => 0;
+    }
+    const startTime = Date.now();
+    return () => {
+      const duration = (Date.now() - startTime) / 1e3;
+      this.observeHistogram(name, duration, labels);
+      return duration;
+    };
+  }
+  setGauge(name, value, labels) {
+    if (!this.enabled) {
+      return;
+    }
+    const gauge = this.gauges.get(name);
+    if (!gauge) {
+      return;
+    }
+    if (labels) {
+      gauge.set(labels, value);
+    } else {
+      gauge.set(value);
+    }
+  }
+  incrementGauge(name, labels, value = 1) {
+    if (!this.enabled) {
+      return;
+    }
+    const gauge = this.gauges.get(name);
+    if (!gauge) {
+      return;
+    }
+    if (labels) {
+      gauge.inc(labels, value);
+    } else {
+      gauge.inc(value);
+    }
+  }
+  decrementGauge(name, labels, value = 1) {
+    if (!this.enabled) {
+      return;
+    }
+    const gauge = this.gauges.get(name);
+    if (!gauge) {
+      return;
+    }
+    if (labels) {
+      gauge.dec(labels, value);
+    } else {
+      gauge.dec(value);
+    }
+  }
+  async getMetrics() {
+    if (!this.enabled) {
+      return "";
+    }
+    return this.registry.metrics();
+  }
+  async getMetricsJson() {
+    if (!this.enabled) {
+      return [];
+    }
+    const metrics = await this.registry.getMetricsAsJSON();
+    return metrics.map((metric) => ({
+      name: metric.name,
+      help: metric.help,
+      type: String(metric.type),
+      values: metric.values.map((v) => ({
+        labels: v.labels ?? {},
+        value: v.value
+      }))
+    }));
+  }
+  registerCounter(name, help, labelNames = []) {
+    if (!this.enabled) {
+      return;
+    }
+    try {
+      const counter = new promClient__namespace.Counter({
+        name,
+        help,
+        labelNames,
+        registers: [this.registry]
+      });
+      this.counters.set(name, counter);
+    } catch (error) {
+      throw new MetricRegistrationError(name, error instanceof Error ? error : void 0);
+    }
+  }
+  registerHistogram(name, help, labelNames = [], buckets) {
+    if (!this.enabled) {
+      return;
+    }
+    try {
+      const histogram = new promClient__namespace.Histogram({
+        name,
+        help,
+        labelNames,
+        buckets: buckets ?? this.latencyBuckets,
+        registers: [this.registry]
+      });
+      this.histograms.set(name, histogram);
+    } catch (error) {
+      throw new MetricRegistrationError(name, error instanceof Error ? error : void 0);
+    }
+  }
+  registerGauge(name, help, labelNames = []) {
+    if (!this.enabled) {
+      return;
+    }
+    try {
+      const gauge = new promClient__namespace.Gauge({
+        name,
+        help,
+        labelNames,
+        registers: [this.registry]
+      });
+      this.gauges.set(name, gauge);
+    } catch (error) {
+      throw new MetricRegistrationError(name, error instanceof Error ? error : void 0);
+    }
+  }
+};
+exports.MetricsService = __decorateClass([
+  common.Injectable(),
+  __decorateParam(0, common.Inject(METRICS_PLUGIN_OPTIONS))
+], exports.MetricsService);
+exports.MetricsController = class MetricsController {
+  constructor(metricsService) {
+    this.metricsService = metricsService;
+  }
+  async getMetrics() {
+    return this.metricsService.getMetrics();
+  }
+};
+__decorateClass([
+  common.Get(),
+  common.Header("Content-Type", "text/plain; version=0.0.4; charset=utf-8")
+], exports.MetricsController.prototype, "getMetrics", 1);
+exports.MetricsController = __decorateClass([
+  common.Controller("metrics"),
+  __decorateParam(0, common.Inject(METRICS_SERVICE))
+], exports.MetricsController);
+
+// src/metrics.plugin.ts
+var DEFAULT_METRICS_CONFIG = {
+  enabled: true,
+  prefix: "redisx_",
+  exposeEndpoint: true,
+  endpoint: "/metrics",
+  histogramBuckets: [1e-3, 5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+  collectDefaultMetrics: true,
+  commandMetrics: true,
+  pluginMetrics: true,
+  collectInterval: 15e3
+};
+var MetricsPlugin = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  name = "metrics";
+  version = "0.1.0";
+  description = "Prometheus metrics collection and export";
+  getProviders() {
+    const config = {
+      enabled: this.options.enabled ?? DEFAULT_METRICS_CONFIG.enabled,
+      prefix: this.options.prefix ?? DEFAULT_METRICS_CONFIG.prefix,
+      exposeEndpoint: this.options.exposeEndpoint ?? DEFAULT_METRICS_CONFIG.exposeEndpoint,
+      endpoint: this.options.endpoint ?? DEFAULT_METRICS_CONFIG.endpoint,
+      histogramBuckets: this.options.histogramBuckets ?? DEFAULT_METRICS_CONFIG.histogramBuckets,
+      collectDefaultMetrics: this.options.collectDefaultMetrics ?? DEFAULT_METRICS_CONFIG.collectDefaultMetrics,
+      commandMetrics: this.options.commandMetrics ?? DEFAULT_METRICS_CONFIG.commandMetrics,
+      pluginMetrics: this.options.pluginMetrics ?? DEFAULT_METRICS_CONFIG.pluginMetrics,
+      collectInterval: this.options.collectInterval ?? DEFAULT_METRICS_CONFIG.collectInterval,
+      defaultLabels: this.options.defaultLabels
+    };
+    return [
+      { provide: METRICS_PLUGIN_OPTIONS, useValue: config },
+      { provide: METRICS_SERVICE, useClass: exports.MetricsService }
+    ];
+  }
+  getExports() {
+    return [METRICS_SERVICE];
+  }
+  getControllers() {
+    if (this.options.exposeEndpoint !== false) {
+      return [exports.MetricsController];
+    }
+    return [];
+  }
+};
+
+exports.METRICS_PLUGIN_OPTIONS = METRICS_PLUGIN_OPTIONS;
+exports.METRICS_REGISTRY = METRICS_REGISTRY;
+exports.METRICS_SERVICE = METRICS_SERVICE;
+exports.MetricRegistrationError = MetricRegistrationError;
+exports.MetricsError = MetricsError;
+exports.MetricsPlugin = MetricsPlugin;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/constants/index.ts","../src/shared/errors/index.ts","../src/metrics/application/services/metrics.service.ts","../src/metrics/api/controllers/metrics.controller.ts","../src/metrics.plugin.ts"],"names":["RedisXError","ErrorCode","MetricsService","promClient","Injectable","MetricsController","Get","Header","Controller","Inject"],"mappings":"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","file":"index.js","sourcesContent":["export const METRICS_PLUGIN_OPTIONS = Symbol.for('METRICS_PLUGIN_OPTIONS');\nexport const METRICS_SERVICE = Symbol.for('METRICS_SERVICE');\nexport const METRICS_REGISTRY = Symbol.for('METRICS_REGISTRY');\n","import { RedisXError, ErrorCode } from '@nestjs-redisx/core';\n\nexport class MetricsError extends RedisXError {\n  constructor(message: string, cause?: Error) {\n    super(message, ErrorCode.OP_FAILED, cause);\n  }\n}\n\nexport class MetricRegistrationError extends MetricsError {\n  constructor(metricName: string, cause?: Error) {\n    super(`Failed to register metric \"${metricName}\"`, cause);\n  }\n}\n","import { Injectable, Inject, OnModuleInit, OnModuleDestroy } from '@nestjs/common';\nimport * as promClient from 'prom-client';\n\nimport { METRICS_PLUGIN_OPTIONS } from '../../../shared/constants';\nimport { MetricRegistrationError } from '../../../shared/errors';\nimport { IMetricsPluginOptions, IMetricsJson } from '../../../shared/types';\nimport { IMetricsService } from '../ports/metrics-service.port';\n\n@Injectable()\nexport class MetricsService implements IMetricsService, OnModuleInit, OnModuleDestroy {\n  private readonly registry: promClient.Registry;\n  private readonly counters = new Map<string, promClient.Counter>();\n  private readonly histograms = new Map<string, promClient.Histogram>();\n  private readonly gauges = new Map<string, promClient.Gauge>();\n  private readonly prefix: string;\n  private readonly defaultLabels: Record<string, string>;\n  private readonly latencyBuckets: number[];\n  private readonly enabled: boolean;\n  private defaultMetricsInterval?: ReturnType<typeof setInterval>;\n\n  constructor(\n    @Inject(METRICS_PLUGIN_OPTIONS)\n    private readonly config: IMetricsPluginOptions,\n  ) {\n    this.enabled = config.enabled !== false;\n    this.prefix = config.prefix ?? 'redisx_';\n    this.defaultLabels = config.defaultLabels ?? {};\n    this.latencyBuckets = config.histogramBuckets ?? [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];\n\n    this.registry = new promClient.Registry();\n    this.registry.setDefaultLabels(this.defaultLabels);\n  }\n\n  onModuleInit(): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    this.registerStandardMetrics();\n\n    if (this.config.collectDefaultMetrics !== false) {\n      const collectInterval = this.config.collectInterval ?? 15000;\n      promClient.collectDefaultMetrics({\n        register: this.registry,\n        prefix: this.prefix,\n        ...(collectInterval > 0 ? { timeout: collectInterval } : {}),\n      });\n    }\n  }\n\n  onModuleDestroy(): void {\n    this.registry.clear();\n  }\n\n  private registerStandardMetrics(): void {\n    const commandMetrics = this.config.commandMetrics !== false;\n    const pluginMetrics = this.config.pluginMetrics !== false;\n\n    // Core metrics\n    if (commandMetrics) {\n      this.registerCounter(`${this.prefix}commands_total`, 'Total Redis commands executed', ['command', 'client', 'status']);\n\n      this.registerHistogram(`${this.prefix}command_duration_seconds`, 'Redis command latency in seconds', ['command', 'client'], this.latencyBuckets);\n\n      this.registerGauge(`${this.prefix}connections_active`, 'Number of active Redis connections', ['client']);\n\n      this.registerCounter(`${this.prefix}errors_total`, 'Total Redis errors', ['client', 'error_type']);\n    }\n\n    // Plugin-specific metrics\n    if (pluginMetrics) {\n      // Cache metrics\n      this.registerCounter(`${this.prefix}cache_hits_total`, 'Total cache hits', ['layer']);\n\n      this.registerCounter(`${this.prefix}cache_misses_total`, 'Total cache misses', ['layer']);\n\n      this.registerGauge(`${this.prefix}cache_hit_ratio`, 'Cache hit ratio (0-1)', ['layer']);\n\n      this.registerGauge(`${this.prefix}cache_size`, 'Current cache size', ['layer']);\n\n      this.registerCounter(`${this.prefix}cache_stampede_prevented_total`, 'Total cache stampede prevention activations');\n\n      // Lock metrics\n      this.registerCounter(`${this.prefix}lock_acquisitions_total`, 'Total lock acquisition attempts', ['status']);\n\n      this.registerHistogram(`${this.prefix}lock_wait_duration_seconds`, 'Lock wait time in seconds', [], this.latencyBuckets);\n\n      this.registerHistogram(`${this.prefix}lock_hold_duration_seconds`, 'Lock hold time in seconds', [], this.latencyBuckets);\n\n      this.registerGauge(`${this.prefix}locks_active`, 'Number of currently held locks');\n\n      // Rate limit metrics\n      this.registerCounter(`${this.prefix}ratelimit_requests_total`, 'Total rate limit requests', ['status']);\n\n      // Stream metrics\n      this.registerCounter(`${this.prefix}stream_messages_published_total`, 'Total stream messages published', ['stream']);\n\n      this.registerCounter(`${this.prefix}stream_messages_consumed_total`, 'Total stream messages consumed', ['stream', 'group', 'status']);\n\n      this.registerHistogram(`${this.prefix}stream_publish_duration_seconds`, 'Stream publish latency in seconds', ['stream'], this.latencyBuckets);\n\n      this.registerCounter(`${this.prefix}stream_publish_errors_total`, 'Total stream publish errors', ['stream']);\n\n      this.registerHistogram(`${this.prefix}stream_processing_duration_seconds`, 'Stream message processing time in seconds', ['stream', 'group'], this.latencyBuckets);\n\n      // Idempotency metrics\n      this.registerCounter(`${this.prefix}idempotency_requests_total`, 'Total idempotency requests', ['status']);\n\n      this.registerHistogram(`${this.prefix}idempotency_duration_seconds`, 'Idempotency check duration in seconds', [], this.latencyBuckets);\n    }\n  }\n\n  incrementCounter(name: string, labels?: Record<string, string>, value = 1): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const counter = this.counters.get(name);\n    if (!counter) {\n      return;\n    }\n\n    if (labels) {\n      counter.inc(labels, value);\n    } else {\n      counter.inc(value);\n    }\n  }\n\n  observeHistogram(name: string, value: number, labels?: Record<string, string>): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const histogram = this.histograms.get(name);\n    if (!histogram) {\n      return;\n    }\n\n    if (labels) {\n      histogram.observe(labels, value);\n    } else {\n      histogram.observe(value);\n    }\n  }\n\n  startTimer(name: string, labels?: Record<string, string>): () => number {\n    if (!this.enabled) {\n      return () => 0;\n    }\n\n    const histogram = this.histograms.get(name);\n    if (!histogram) {\n      return () => 0;\n    }\n\n    const startTime = Date.now();\n\n    return () => {\n      const duration = (Date.now() - startTime) / 1000;\n      this.observeHistogram(name, duration, labels);\n      return duration;\n    };\n  }\n\n  setGauge(name: string, value: number, labels?: Record<string, string>): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const gauge = this.gauges.get(name);\n    if (!gauge) {\n      return;\n    }\n\n    if (labels) {\n      gauge.set(labels, value);\n    } else {\n      gauge.set(value);\n    }\n  }\n\n  incrementGauge(name: string, labels?: Record<string, string>, value = 1): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const gauge = this.gauges.get(name);\n    if (!gauge) {\n      return;\n    }\n\n    if (labels) {\n      gauge.inc(labels, value);\n    } else {\n      gauge.inc(value);\n    }\n  }\n\n  decrementGauge(name: string, labels?: Record<string, string>, value = 1): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const gauge = this.gauges.get(name);\n    if (!gauge) {\n      return;\n    }\n\n    if (labels) {\n      gauge.dec(labels, value);\n    } else {\n      gauge.dec(value);\n    }\n  }\n\n  async getMetrics(): Promise<string> {\n    if (!this.enabled) {\n      return '';\n    }\n\n    return this.registry.metrics();\n  }\n\n  async getMetricsJson(): Promise<IMetricsJson[]> {\n    if (!this.enabled) {\n      return [];\n    }\n\n    const metrics = await this.registry.getMetricsAsJSON();\n\n    return metrics.map((metric: promClient.MetricObjectWithValues<promClient.MetricValue<string>>) => ({\n      name: metric.name,\n      help: metric.help,\n      type: String(metric.type),\n      values: metric.values.map((v: promClient.MetricValue<string>) => ({\n        labels: (v.labels as Record<string, string>) ?? {},\n        value: v.value,\n      })),\n    }));\n  }\n\n  registerCounter(name: string, help: string, labelNames: string[] = []): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    try {\n      const counter = new promClient.Counter({\n        name,\n        help,\n        labelNames,\n        registers: [this.registry],\n      });\n\n      this.counters.set(name, counter);\n    } catch (error) {\n      throw new MetricRegistrationError(name, error instanceof Error ? error : undefined);\n    }\n  }\n\n  registerHistogram(name: string, help: string, labelNames: string[] = [], buckets?: number[]): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    try {\n      const histogram = new promClient.Histogram({\n        name,\n        help,\n        labelNames,\n        buckets: buckets ?? this.latencyBuckets,\n        registers: [this.registry],\n      });\n\n      this.histograms.set(name, histogram);\n    } catch (error) {\n      throw new MetricRegistrationError(name, error instanceof Error ? error : undefined);\n    }\n  }\n\n  registerGauge(name: string, help: string, labelNames: string[] = []): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    try {\n      const gauge = new promClient.Gauge({\n        name,\n        help,\n        labelNames,\n        registers: [this.registry],\n      });\n\n      this.gauges.set(name, gauge);\n    } catch (error) {\n      throw new MetricRegistrationError(name, error instanceof Error ? error : undefined);\n    }\n  }\n}\n","import { Controller, Get, Header, Inject } from '@nestjs/common';\n\nimport { METRICS_SERVICE } from '../../../shared/constants';\nimport { IMetricsService } from '../../application/ports/metrics-service.port';\n\n@Controller('metrics')\nexport class MetricsController {\n  constructor(@Inject(METRICS_SERVICE) private readonly metricsService: IMetricsService) {}\n\n  @Get()\n  @Header('Content-Type', 'text/plain; version=0.0.4; charset=utf-8')\n  async getMetrics(): Promise<string> {\n    return this.metricsService.getMetrics();\n  }\n}\n","/**\n * Metrics plugin for NestJS RedisX.\n * Provides Prometheus metrics collection and export.\n */\n\nimport { Provider, Type } from '@nestjs/common';\nimport { IRedisXPlugin } from '@nestjs-redisx/core';\nimport { METRICS_PLUGIN_OPTIONS, METRICS_SERVICE } from './shared/constants';\nimport { IMetricsPluginOptions } from './shared/types';\nimport { MetricsService } from './metrics/application/services/metrics.service';\nimport { MetricsController } from './metrics/api/controllers/metrics.controller';\n\nconst DEFAULT_METRICS_CONFIG: Required<Omit<IMetricsPluginOptions, 'isGlobal' | 'defaultLabels'>> = {\n  enabled: true,\n  prefix: 'redisx_',\n  exposeEndpoint: true,\n  endpoint: '/metrics',\n  histogramBuckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],\n  collectDefaultMetrics: true,\n  commandMetrics: true,\n  pluginMetrics: true,\n  collectInterval: 15000,\n};\n\n/**\n * Metrics plugin for NestJS RedisX.\n *\n * Provides Prometheus metrics:\n * - Redis command latency\n * - Connection pool stats\n * - Cache hit/miss rates\n * - Error counts\n * - HTTP endpoint for Prometheus scraping\n *\n * @example\n * ```typescript\n * @Module({\n *   imports: [\n *     RedisModule.forRoot({\n *       clients: { host: 'localhost', port: 6379 },\n *       plugins: [\n *         new MetricsPlugin({\n *           enabled: true,\n *           exposeEndpoint: true,\n *           endpoint: '/metrics',\n *         }),\n *       ],\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n */\nexport class MetricsPlugin implements IRedisXPlugin {\n  readonly name = 'metrics';\n  readonly version = '0.1.0';\n  readonly description = 'Prometheus metrics collection and export';\n\n  constructor(private readonly options: IMetricsPluginOptions = {}) {}\n\n  getProviders(): Provider[] {\n    const config: IMetricsPluginOptions = {\n      enabled: this.options.enabled ?? DEFAULT_METRICS_CONFIG.enabled,\n      prefix: this.options.prefix ?? DEFAULT_METRICS_CONFIG.prefix,\n      exposeEndpoint: this.options.exposeEndpoint ?? DEFAULT_METRICS_CONFIG.exposeEndpoint,\n      endpoint: this.options.endpoint ?? DEFAULT_METRICS_CONFIG.endpoint,\n      histogramBuckets: this.options.histogramBuckets ?? DEFAULT_METRICS_CONFIG.histogramBuckets,\n      collectDefaultMetrics: this.options.collectDefaultMetrics ?? DEFAULT_METRICS_CONFIG.collectDefaultMetrics,\n      commandMetrics: this.options.commandMetrics ?? DEFAULT_METRICS_CONFIG.commandMetrics,\n      pluginMetrics: this.options.pluginMetrics ?? DEFAULT_METRICS_CONFIG.pluginMetrics,\n      collectInterval: this.options.collectInterval ?? DEFAULT_METRICS_CONFIG.collectInterval,\n      defaultLabels: this.options.defaultLabels,\n    };\n\n    return [\n      { provide: METRICS_PLUGIN_OPTIONS, useValue: config },\n      { provide: METRICS_SERVICE, useClass: MetricsService },\n    ];\n  }\n\n  getExports(): Array<string | symbol | Provider> {\n    return [METRICS_SERVICE];\n  }\n\n  getControllers(): Type[] {\n    // Only expose controller if endpoint is enabled\n    if (this.options.exposeEndpoint !== false) {\n      return [MetricsController];\n    }\n    return [];\n  }\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,325 @@
+import { Injectable, Inject, Get, Header, Controller } from '@nestjs/common';
+import * as promClient from 'prom-client';
+import { RedisXError, ErrorCode } from '@nestjs-redisx/core';
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
+
+// src/shared/constants/index.ts
+var METRICS_PLUGIN_OPTIONS = /* @__PURE__ */ Symbol.for("METRICS_PLUGIN_OPTIONS");
+var METRICS_SERVICE = /* @__PURE__ */ Symbol.for("METRICS_SERVICE");
+var METRICS_REGISTRY = /* @__PURE__ */ Symbol.for("METRICS_REGISTRY");
+var MetricsError = class extends RedisXError {
+  constructor(message, cause) {
+    super(message, ErrorCode.OP_FAILED, cause);
+  }
+};
+var MetricRegistrationError = class extends MetricsError {
+  constructor(metricName, cause) {
+    super(`Failed to register metric "${metricName}"`, cause);
+  }
+};
+
+// src/metrics/application/services/metrics.service.ts
+var MetricsService = class {
+  constructor(config) {
+    this.config = config;
+    this.enabled = config.enabled !== false;
+    this.prefix = config.prefix ?? "redisx_";
+    this.defaultLabels = config.defaultLabels ?? {};
+    this.latencyBuckets = config.histogramBuckets ?? [1e-3, 5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];
+    this.registry = new promClient.Registry();
+    this.registry.setDefaultLabels(this.defaultLabels);
+  }
+  registry;
+  counters = /* @__PURE__ */ new Map();
+  histograms = /* @__PURE__ */ new Map();
+  gauges = /* @__PURE__ */ new Map();
+  prefix;
+  defaultLabels;
+  latencyBuckets;
+  enabled;
+  defaultMetricsInterval;
+  onModuleInit() {
+    if (!this.enabled) {
+      return;
+    }
+    this.registerStandardMetrics();
+    if (this.config.collectDefaultMetrics !== false) {
+      const collectInterval = this.config.collectInterval ?? 15e3;
+      promClient.collectDefaultMetrics({
+        register: this.registry,
+        prefix: this.prefix,
+        ...collectInterval > 0 ? { timeout: collectInterval } : {}
+      });
+    }
+  }
+  onModuleDestroy() {
+    this.registry.clear();
+  }
+  registerStandardMetrics() {
+    const commandMetrics = this.config.commandMetrics !== false;
+    const pluginMetrics = this.config.pluginMetrics !== false;
+    if (commandMetrics) {
+      this.registerCounter(`${this.prefix}commands_total`, "Total Redis commands executed", ["command", "client", "status"]);
+      this.registerHistogram(`${this.prefix}command_duration_seconds`, "Redis command latency in seconds", ["command", "client"], this.latencyBuckets);
+      this.registerGauge(`${this.prefix}connections_active`, "Number of active Redis connections", ["client"]);
+      this.registerCounter(`${this.prefix}errors_total`, "Total Redis errors", ["client", "error_type"]);
+    }
+    if (pluginMetrics) {
+      this.registerCounter(`${this.prefix}cache_hits_total`, "Total cache hits", ["layer"]);
+      this.registerCounter(`${this.prefix}cache_misses_total`, "Total cache misses", ["layer"]);
+      this.registerGauge(`${this.prefix}cache_hit_ratio`, "Cache hit ratio (0-1)", ["layer"]);
+      this.registerGauge(`${this.prefix}cache_size`, "Current cache size", ["layer"]);
+      this.registerCounter(`${this.prefix}cache_stampede_prevented_total`, "Total cache stampede prevention activations");
+      this.registerCounter(`${this.prefix}lock_acquisitions_total`, "Total lock acquisition attempts", ["status"]);
+      this.registerHistogram(`${this.prefix}lock_wait_duration_seconds`, "Lock wait time in seconds", [], this.latencyBuckets);
+      this.registerHistogram(`${this.prefix}lock_hold_duration_seconds`, "Lock hold time in seconds", [], this.latencyBuckets);
+      this.registerGauge(`${this.prefix}locks_active`, "Number of currently held locks");
+      this.registerCounter(`${this.prefix}ratelimit_requests_total`, "Total rate limit requests", ["status"]);
+      this.registerCounter(`${this.prefix}stream_messages_published_total`, "Total stream messages published", ["stream"]);
+      this.registerCounter(`${this.prefix}stream_messages_consumed_total`, "Total stream messages consumed", ["stream", "group", "status"]);
+      this.registerHistogram(`${this.prefix}stream_publish_duration_seconds`, "Stream publish latency in seconds", ["stream"], this.latencyBuckets);
+      this.registerCounter(`${this.prefix}stream_publish_errors_total`, "Total stream publish errors", ["stream"]);
+      this.registerHistogram(`${this.prefix}stream_processing_duration_seconds`, "Stream message processing time in seconds", ["stream", "group"], this.latencyBuckets);
+      this.registerCounter(`${this.prefix}idempotency_requests_total`, "Total idempotency requests", ["status"]);
+      this.registerHistogram(`${this.prefix}idempotency_duration_seconds`, "Idempotency check duration in seconds", [], this.latencyBuckets);
+    }
+  }
+  incrementCounter(name, labels, value = 1) {
+    if (!this.enabled) {
+      return;
+    }
+    const counter = this.counters.get(name);
+    if (!counter) {
+      return;
+    }
+    if (labels) {
+      counter.inc(labels, value);
+    } else {
+      counter.inc(value);
+    }
+  }
+  observeHistogram(name, value, labels) {
+    if (!this.enabled) {
+      return;
+    }
+    const histogram = this.histograms.get(name);
+    if (!histogram) {
+      return;
+    }
+    if (labels) {
+      histogram.observe(labels, value);
+    } else {
+      histogram.observe(value);
+    }
+  }
+  startTimer(name, labels) {
+    if (!this.enabled) {
+      return () => 0;
+    }
+    const histogram = this.histograms.get(name);
+    if (!histogram) {
+      return () => 0;
+    }
+    const startTime = Date.now();
+    return () => {
+      const duration = (Date.now() - startTime) / 1e3;
+      this.observeHistogram(name, duration, labels);
+      return duration;
+    };
+  }
+  setGauge(name, value, labels) {
+    if (!this.enabled) {
+      return;
+    }
+    const gauge = this.gauges.get(name);
+    if (!gauge) {
+      return;
+    }
+    if (labels) {
+      gauge.set(labels, value);
+    } else {
+      gauge.set(value);
+    }
+  }
+  incrementGauge(name, labels, value = 1) {
+    if (!this.enabled) {
+      return;
+    }
+    const gauge = this.gauges.get(name);
+    if (!gauge) {
+      return;
+    }
+    if (labels) {
+      gauge.inc(labels, value);
+    } else {
+      gauge.inc(value);
+    }
+  }
+  decrementGauge(name, labels, value = 1) {
+    if (!this.enabled) {
+      return;
+    }
+    const gauge = this.gauges.get(name);
+    if (!gauge) {
+      return;
+    }
+    if (labels) {
+      gauge.dec(labels, value);
+    } else {
+      gauge.dec(value);
+    }
+  }
+  async getMetrics() {
+    if (!this.enabled) {
+      return "";
+    }
+    return this.registry.metrics();
+  }
+  async getMetricsJson() {
+    if (!this.enabled) {
+      return [];
+    }
+    const metrics = await this.registry.getMetricsAsJSON();
+    return metrics.map((metric) => ({
+      name: metric.name,
+      help: metric.help,
+      type: String(metric.type),
+      values: metric.values.map((v) => ({
+        labels: v.labels ?? {},
+        value: v.value
+      }))
+    }));
+  }
+  registerCounter(name, help, labelNames = []) {
+    if (!this.enabled) {
+      return;
+    }
+    try {
+      const counter = new promClient.Counter({
+        name,
+        help,
+        labelNames,
+        registers: [this.registry]
+      });
+      this.counters.set(name, counter);
+    } catch (error) {
+      throw new MetricRegistrationError(name, error instanceof Error ? error : void 0);
+    }
+  }
+  registerHistogram(name, help, labelNames = [], buckets) {
+    if (!this.enabled) {
+      return;
+    }
+    try {
+      const histogram = new promClient.Histogram({
+        name,
+        help,
+        labelNames,
+        buckets: buckets ?? this.latencyBuckets,
+        registers: [this.registry]
+      });
+      this.histograms.set(name, histogram);
+    } catch (error) {
+      throw new MetricRegistrationError(name, error instanceof Error ? error : void 0);
+    }
+  }
+  registerGauge(name, help, labelNames = []) {
+    if (!this.enabled) {
+      return;
+    }
+    try {
+      const gauge = new promClient.Gauge({
+        name,
+        help,
+        labelNames,
+        registers: [this.registry]
+      });
+      this.gauges.set(name, gauge);
+    } catch (error) {
+      throw new MetricRegistrationError(name, error instanceof Error ? error : void 0);
+    }
+  }
+};
+MetricsService = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(METRICS_PLUGIN_OPTIONS))
+], MetricsService);
+var MetricsController = class {
+  constructor(metricsService) {
+    this.metricsService = metricsService;
+  }
+  async getMetrics() {
+    return this.metricsService.getMetrics();
+  }
+};
+__decorateClass([
+  Get(),
+  Header("Content-Type", "text/plain; version=0.0.4; charset=utf-8")
+], MetricsController.prototype, "getMetrics", 1);
+MetricsController = __decorateClass([
+  Controller("metrics"),
+  __decorateParam(0, Inject(METRICS_SERVICE))
+], MetricsController);
+
+// src/metrics.plugin.ts
+var DEFAULT_METRICS_CONFIG = {
+  enabled: true,
+  prefix: "redisx_",
+  exposeEndpoint: true,
+  endpoint: "/metrics",
+  histogramBuckets: [1e-3, 5e-3, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],
+  collectDefaultMetrics: true,
+  commandMetrics: true,
+  pluginMetrics: true,
+  collectInterval: 15e3
+};
+var MetricsPlugin = class {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  name = "metrics";
+  version = "0.1.0";
+  description = "Prometheus metrics collection and export";
+  getProviders() {
+    const config = {
+      enabled: this.options.enabled ?? DEFAULT_METRICS_CONFIG.enabled,
+      prefix: this.options.prefix ?? DEFAULT_METRICS_CONFIG.prefix,
+      exposeEndpoint: this.options.exposeEndpoint ?? DEFAULT_METRICS_CONFIG.exposeEndpoint,
+      endpoint: this.options.endpoint ?? DEFAULT_METRICS_CONFIG.endpoint,
+      histogramBuckets: this.options.histogramBuckets ?? DEFAULT_METRICS_CONFIG.histogramBuckets,
+      collectDefaultMetrics: this.options.collectDefaultMetrics ?? DEFAULT_METRICS_CONFIG.collectDefaultMetrics,
+      commandMetrics: this.options.commandMetrics ?? DEFAULT_METRICS_CONFIG.commandMetrics,
+      pluginMetrics: this.options.pluginMetrics ?? DEFAULT_METRICS_CONFIG.pluginMetrics,
+      collectInterval: this.options.collectInterval ?? DEFAULT_METRICS_CONFIG.collectInterval,
+      defaultLabels: this.options.defaultLabels
+    };
+    return [
+      { provide: METRICS_PLUGIN_OPTIONS, useValue: config },
+      { provide: METRICS_SERVICE, useClass: MetricsService }
+    ];
+  }
+  getExports() {
+    return [METRICS_SERVICE];
+  }
+  getControllers() {
+    if (this.options.exposeEndpoint !== false) {
+      return [MetricsController];
+    }
+    return [];
+  }
+};
+
+export { METRICS_PLUGIN_OPTIONS, METRICS_REGISTRY, METRICS_SERVICE, MetricRegistrationError, MetricsController, MetricsError, MetricsPlugin, MetricsService };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/shared/constants/index.ts","../src/shared/errors/index.ts","../src/metrics/application/services/metrics.service.ts","../src/metrics/api/controllers/metrics.controller.ts","../src/metrics.plugin.ts"],"names":["Inject"],"mappings":"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","file":"index.mjs","sourcesContent":["export const METRICS_PLUGIN_OPTIONS = Symbol.for('METRICS_PLUGIN_OPTIONS');\nexport const METRICS_SERVICE = Symbol.for('METRICS_SERVICE');\nexport const METRICS_REGISTRY = Symbol.for('METRICS_REGISTRY');\n","import { RedisXError, ErrorCode } from '@nestjs-redisx/core';\n\nexport class MetricsError extends RedisXError {\n  constructor(message: string, cause?: Error) {\n    super(message, ErrorCode.OP_FAILED, cause);\n  }\n}\n\nexport class MetricRegistrationError extends MetricsError {\n  constructor(metricName: string, cause?: Error) {\n    super(`Failed to register metric \"${metricName}\"`, cause);\n  }\n}\n","import { Injectable, Inject, OnModuleInit, OnModuleDestroy } from '@nestjs/common';\nimport * as promClient from 'prom-client';\n\nimport { METRICS_PLUGIN_OPTIONS } from '../../../shared/constants';\nimport { MetricRegistrationError } from '../../../shared/errors';\nimport { IMetricsPluginOptions, IMetricsJson } from '../../../shared/types';\nimport { IMetricsService } from '../ports/metrics-service.port';\n\n@Injectable()\nexport class MetricsService implements IMetricsService, OnModuleInit, OnModuleDestroy {\n  private readonly registry: promClient.Registry;\n  private readonly counters = new Map<string, promClient.Counter>();\n  private readonly histograms = new Map<string, promClient.Histogram>();\n  private readonly gauges = new Map<string, promClient.Gauge>();\n  private readonly prefix: string;\n  private readonly defaultLabels: Record<string, string>;\n  private readonly latencyBuckets: number[];\n  private readonly enabled: boolean;\n  private defaultMetricsInterval?: ReturnType<typeof setInterval>;\n\n  constructor(\n    @Inject(METRICS_PLUGIN_OPTIONS)\n    private readonly config: IMetricsPluginOptions,\n  ) {\n    this.enabled = config.enabled !== false;\n    this.prefix = config.prefix ?? 'redisx_';\n    this.defaultLabels = config.defaultLabels ?? {};\n    this.latencyBuckets = config.histogramBuckets ?? [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10];\n\n    this.registry = new promClient.Registry();\n    this.registry.setDefaultLabels(this.defaultLabels);\n  }\n\n  onModuleInit(): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    this.registerStandardMetrics();\n\n    if (this.config.collectDefaultMetrics !== false) {\n      const collectInterval = this.config.collectInterval ?? 15000;\n      promClient.collectDefaultMetrics({\n        register: this.registry,\n        prefix: this.prefix,\n        ...(collectInterval > 0 ? { timeout: collectInterval } : {}),\n      });\n    }\n  }\n\n  onModuleDestroy(): void {\n    this.registry.clear();\n  }\n\n  private registerStandardMetrics(): void {\n    const commandMetrics = this.config.commandMetrics !== false;\n    const pluginMetrics = this.config.pluginMetrics !== false;\n\n    // Core metrics\n    if (commandMetrics) {\n      this.registerCounter(`${this.prefix}commands_total`, 'Total Redis commands executed', ['command', 'client', 'status']);\n\n      this.registerHistogram(`${this.prefix}command_duration_seconds`, 'Redis command latency in seconds', ['command', 'client'], this.latencyBuckets);\n\n      this.registerGauge(`${this.prefix}connections_active`, 'Number of active Redis connections', ['client']);\n\n      this.registerCounter(`${this.prefix}errors_total`, 'Total Redis errors', ['client', 'error_type']);\n    }\n\n    // Plugin-specific metrics\n    if (pluginMetrics) {\n      // Cache metrics\n      this.registerCounter(`${this.prefix}cache_hits_total`, 'Total cache hits', ['layer']);\n\n      this.registerCounter(`${this.prefix}cache_misses_total`, 'Total cache misses', ['layer']);\n\n      this.registerGauge(`${this.prefix}cache_hit_ratio`, 'Cache hit ratio (0-1)', ['layer']);\n\n      this.registerGauge(`${this.prefix}cache_size`, 'Current cache size', ['layer']);\n\n      this.registerCounter(`${this.prefix}cache_stampede_prevented_total`, 'Total cache stampede prevention activations');\n\n      // Lock metrics\n      this.registerCounter(`${this.prefix}lock_acquisitions_total`, 'Total lock acquisition attempts', ['status']);\n\n      this.registerHistogram(`${this.prefix}lock_wait_duration_seconds`, 'Lock wait time in seconds', [], this.latencyBuckets);\n\n      this.registerHistogram(`${this.prefix}lock_hold_duration_seconds`, 'Lock hold time in seconds', [], this.latencyBuckets);\n\n      this.registerGauge(`${this.prefix}locks_active`, 'Number of currently held locks');\n\n      // Rate limit metrics\n      this.registerCounter(`${this.prefix}ratelimit_requests_total`, 'Total rate limit requests', ['status']);\n\n      // Stream metrics\n      this.registerCounter(`${this.prefix}stream_messages_published_total`, 'Total stream messages published', ['stream']);\n\n      this.registerCounter(`${this.prefix}stream_messages_consumed_total`, 'Total stream messages consumed', ['stream', 'group', 'status']);\n\n      this.registerHistogram(`${this.prefix}stream_publish_duration_seconds`, 'Stream publish latency in seconds', ['stream'], this.latencyBuckets);\n\n      this.registerCounter(`${this.prefix}stream_publish_errors_total`, 'Total stream publish errors', ['stream']);\n\n      this.registerHistogram(`${this.prefix}stream_processing_duration_seconds`, 'Stream message processing time in seconds', ['stream', 'group'], this.latencyBuckets);\n\n      // Idempotency metrics\n      this.registerCounter(`${this.prefix}idempotency_requests_total`, 'Total idempotency requests', ['status']);\n\n      this.registerHistogram(`${this.prefix}idempotency_duration_seconds`, 'Idempotency check duration in seconds', [], this.latencyBuckets);\n    }\n  }\n\n  incrementCounter(name: string, labels?: Record<string, string>, value = 1): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const counter = this.counters.get(name);\n    if (!counter) {\n      return;\n    }\n\n    if (labels) {\n      counter.inc(labels, value);\n    } else {\n      counter.inc(value);\n    }\n  }\n\n  observeHistogram(name: string, value: number, labels?: Record<string, string>): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const histogram = this.histograms.get(name);\n    if (!histogram) {\n      return;\n    }\n\n    if (labels) {\n      histogram.observe(labels, value);\n    } else {\n      histogram.observe(value);\n    }\n  }\n\n  startTimer(name: string, labels?: Record<string, string>): () => number {\n    if (!this.enabled) {\n      return () => 0;\n    }\n\n    const histogram = this.histograms.get(name);\n    if (!histogram) {\n      return () => 0;\n    }\n\n    const startTime = Date.now();\n\n    return () => {\n      const duration = (Date.now() - startTime) / 1000;\n      this.observeHistogram(name, duration, labels);\n      return duration;\n    };\n  }\n\n  setGauge(name: string, value: number, labels?: Record<string, string>): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const gauge = this.gauges.get(name);\n    if (!gauge) {\n      return;\n    }\n\n    if (labels) {\n      gauge.set(labels, value);\n    } else {\n      gauge.set(value);\n    }\n  }\n\n  incrementGauge(name: string, labels?: Record<string, string>, value = 1): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const gauge = this.gauges.get(name);\n    if (!gauge) {\n      return;\n    }\n\n    if (labels) {\n      gauge.inc(labels, value);\n    } else {\n      gauge.inc(value);\n    }\n  }\n\n  decrementGauge(name: string, labels?: Record<string, string>, value = 1): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    const gauge = this.gauges.get(name);\n    if (!gauge) {\n      return;\n    }\n\n    if (labels) {\n      gauge.dec(labels, value);\n    } else {\n      gauge.dec(value);\n    }\n  }\n\n  async getMetrics(): Promise<string> {\n    if (!this.enabled) {\n      return '';\n    }\n\n    return this.registry.metrics();\n  }\n\n  async getMetricsJson(): Promise<IMetricsJson[]> {\n    if (!this.enabled) {\n      return [];\n    }\n\n    const metrics = await this.registry.getMetricsAsJSON();\n\n    return metrics.map((metric: promClient.MetricObjectWithValues<promClient.MetricValue<string>>) => ({\n      name: metric.name,\n      help: metric.help,\n      type: String(metric.type),\n      values: metric.values.map((v: promClient.MetricValue<string>) => ({\n        labels: (v.labels as Record<string, string>) ?? {},\n        value: v.value,\n      })),\n    }));\n  }\n\n  registerCounter(name: string, help: string, labelNames: string[] = []): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    try {\n      const counter = new promClient.Counter({\n        name,\n        help,\n        labelNames,\n        registers: [this.registry],\n      });\n\n      this.counters.set(name, counter);\n    } catch (error) {\n      throw new MetricRegistrationError(name, error instanceof Error ? error : undefined);\n    }\n  }\n\n  registerHistogram(name: string, help: string, labelNames: string[] = [], buckets?: number[]): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    try {\n      const histogram = new promClient.Histogram({\n        name,\n        help,\n        labelNames,\n        buckets: buckets ?? this.latencyBuckets,\n        registers: [this.registry],\n      });\n\n      this.histograms.set(name, histogram);\n    } catch (error) {\n      throw new MetricRegistrationError(name, error instanceof Error ? error : undefined);\n    }\n  }\n\n  registerGauge(name: string, help: string, labelNames: string[] = []): void {\n    if (!this.enabled) {\n      return;\n    }\n\n    try {\n      const gauge = new promClient.Gauge({\n        name,\n        help,\n        labelNames,\n        registers: [this.registry],\n      });\n\n      this.gauges.set(name, gauge);\n    } catch (error) {\n      throw new MetricRegistrationError(name, error instanceof Error ? error : undefined);\n    }\n  }\n}\n","import { Controller, Get, Header, Inject } from '@nestjs/common';\n\nimport { METRICS_SERVICE } from '../../../shared/constants';\nimport { IMetricsService } from '../../application/ports/metrics-service.port';\n\n@Controller('metrics')\nexport class MetricsController {\n  constructor(@Inject(METRICS_SERVICE) private readonly metricsService: IMetricsService) {}\n\n  @Get()\n  @Header('Content-Type', 'text/plain; version=0.0.4; charset=utf-8')\n  async getMetrics(): Promise<string> {\n    return this.metricsService.getMetrics();\n  }\n}\n","/**\n * Metrics plugin for NestJS RedisX.\n * Provides Prometheus metrics collection and export.\n */\n\nimport { Provider, Type } from '@nestjs/common';\nimport { IRedisXPlugin } from '@nestjs-redisx/core';\nimport { METRICS_PLUGIN_OPTIONS, METRICS_SERVICE } from './shared/constants';\nimport { IMetricsPluginOptions } from './shared/types';\nimport { MetricsService } from './metrics/application/services/metrics.service';\nimport { MetricsController } from './metrics/api/controllers/metrics.controller';\n\nconst DEFAULT_METRICS_CONFIG: Required<Omit<IMetricsPluginOptions, 'isGlobal' | 'defaultLabels'>> = {\n  enabled: true,\n  prefix: 'redisx_',\n  exposeEndpoint: true,\n  endpoint: '/metrics',\n  histogramBuckets: [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10],\n  collectDefaultMetrics: true,\n  commandMetrics: true,\n  pluginMetrics: true,\n  collectInterval: 15000,\n};\n\n/**\n * Metrics plugin for NestJS RedisX.\n *\n * Provides Prometheus metrics:\n * - Redis command latency\n * - Connection pool stats\n * - Cache hit/miss rates\n * - Error counts\n * - HTTP endpoint for Prometheus scraping\n *\n * @example\n * ```typescript\n * @Module({\n *   imports: [\n *     RedisModule.forRoot({\n *       clients: { host: 'localhost', port: 6379 },\n *       plugins: [\n *         new MetricsPlugin({\n *           enabled: true,\n *           exposeEndpoint: true,\n *           endpoint: '/metrics',\n *         }),\n *       ],\n *     }),\n *   ],\n * })\n * export class AppModule {}\n * ```\n */\nexport class MetricsPlugin implements IRedisXPlugin {\n  readonly name = 'metrics';\n  readonly version = '0.1.0';\n  readonly description = 'Prometheus metrics collection and export';\n\n  constructor(private readonly options: IMetricsPluginOptions = {}) {}\n\n  getProviders(): Provider[] {\n    const config: IMetricsPluginOptions = {\n      enabled: this.options.enabled ?? DEFAULT_METRICS_CONFIG.enabled,\n      prefix: this.options.prefix ?? DEFAULT_METRICS_CONFIG.prefix,\n      exposeEndpoint: this.options.exposeEndpoint ?? DEFAULT_METRICS_CONFIG.exposeEndpoint,\n      endpoint: this.options.endpoint ?? DEFAULT_METRICS_CONFIG.endpoint,\n      histogramBuckets: this.options.histogramBuckets ?? DEFAULT_METRICS_CONFIG.histogramBuckets,\n      collectDefaultMetrics: this.options.collectDefaultMetrics ?? DEFAULT_METRICS_CONFIG.collectDefaultMetrics,\n      commandMetrics: this.options.commandMetrics ?? DEFAULT_METRICS_CONFIG.commandMetrics,\n      pluginMetrics: this.options.pluginMetrics ?? DEFAULT_METRICS_CONFIG.pluginMetrics,\n      collectInterval: this.options.collectInterval ?? DEFAULT_METRICS_CONFIG.collectInterval,\n      defaultLabels: this.options.defaultLabels,\n    };\n\n    return [\n      { provide: METRICS_PLUGIN_OPTIONS, useValue: config },\n      { provide: METRICS_SERVICE, useClass: MetricsService },\n    ];\n  }\n\n  getExports(): Array<string | symbol | Provider> {\n    return [METRICS_SERVICE];\n  }\n\n  getControllers(): Type[] {\n    // Only expose controller if endpoint is enabled\n    if (this.options.exposeEndpoint !== false) {\n      return [MetricsController];\n    }\n    return [];\n  }\n}\n"]}

package/dist/metrics/api/controllers/metrics.controller.d.ts

@@ -0,0 +1,7 @@
+import { IMetricsService } from '../../application/ports/metrics-service.port';
+export declare class MetricsController {
+    private readonly metricsService;
+    constructor(metricsService: IMetricsService);
+    getMetrics(): Promise<string>;
+}
+//# sourceMappingURL=metrics.controller.d.ts.map

package/dist/metrics/api/controllers/metrics.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.controller.d.ts","sourceRoot":"","sources":["../../../../src/metrics/api/controllers/metrics.controller.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,8CAA8C,CAAC;AAE/E,qBACa,iBAAiB;IACS,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAAd,cAAc,EAAE,eAAe;IAI/E,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;CAGpC"}

package/dist/metrics/application/ports/index.d.ts

@@ -0,0 +1,2 @@
+export type { IMetricsService } from './metrics-service.port';
+//# sourceMappingURL=index.d.ts.map

package/dist/metrics/application/ports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/metrics/application/ports/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/metrics/application/ports/metrics-service.port.d.ts

@@ -0,0 +1,15 @@
+import { IMetricsJson } from '../../../shared/types';
+export interface IMetricsService {
+    incrementCounter(name: string, labels?: Record<string, string>, value?: number): void;
+    observeHistogram(name: string, value: number, labels?: Record<string, string>): void;
+    startTimer(name: string, labels?: Record<string, string>): () => number;
+    setGauge(name: string, value: number, labels?: Record<string, string>): void;
+    incrementGauge(name: string, labels?: Record<string, string>, value?: number): void;
+    decrementGauge(name: string, labels?: Record<string, string>, value?: number): void;
+    getMetrics(): Promise<string>;
+    getMetricsJson(): Promise<IMetricsJson[]>;
+    registerCounter(name: string, help: string, labelNames?: string[]): void;
+    registerHistogram(name: string, help: string, labelNames?: string[], buckets?: number[]): void;
+    registerGauge(name: string, help: string, labelNames?: string[]): void;
+}
+//# sourceMappingURL=metrics-service.port.d.ts.map

package/dist/metrics/application/ports/metrics-service.port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-service.port.d.ts","sourceRoot":"","sources":["../../../../src/metrics/application/ports/metrics-service.port.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,MAAM,WAAW,eAAe;IAE9B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGtF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IACrF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC;IAGxE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAC7E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpF,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGpF,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9B,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAG1C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzE,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/F,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACxE"}

package/dist/metrics/application/services/metrics.service.d.ts

@@ -0,0 +1,31 @@
+import { OnModuleInit, OnModuleDestroy } from '@nestjs/common';
+import { IMetricsPluginOptions, IMetricsJson } from '../../../shared/types';
+import { IMetricsService } from '../ports/metrics-service.port';
+export declare class MetricsService implements IMetricsService, OnModuleInit, OnModuleDestroy {
+    private readonly config;
+    private readonly registry;
+    private readonly counters;
+    private readonly histograms;
+    private readonly gauges;
+    private readonly prefix;
+    private readonly defaultLabels;
+    private readonly latencyBuckets;
+    private readonly enabled;
+    private defaultMetricsInterval?;
+    constructor(config: IMetricsPluginOptions);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    private registerStandardMetrics;
+    incrementCounter(name: string, labels?: Record<string, string>, value?: number): void;
+    observeHistogram(name: string, value: number, labels?: Record<string, string>): void;
+    startTimer(name: string, labels?: Record<string, string>): () => number;
+    setGauge(name: string, value: number, labels?: Record<string, string>): void;
+    incrementGauge(name: string, labels?: Record<string, string>, value?: number): void;
+    decrementGauge(name: string, labels?: Record<string, string>, value?: number): void;
+    getMetrics(): Promise<string>;
+    getMetricsJson(): Promise<IMetricsJson[]>;
+    registerCounter(name: string, help: string, labelNames?: string[]): void;
+    registerHistogram(name: string, help: string, labelNames?: string[], buckets?: number[]): void;
+    registerGauge(name: string, help: string, labelNames?: string[]): void;
+}
+//# sourceMappingURL=metrics.service.d.ts.map

package/dist/metrics/application/services/metrics.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.service.d.ts","sourceRoot":"","sources":["../../../../src/metrics/application/services/metrics.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAKnF,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAEhE,qBACa,cAAe,YAAW,eAAe,EAAE,YAAY,EAAE,eAAe;IAajF,OAAO,CAAC,QAAQ,CAAC,MAAM;IAZzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAsB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA2C;IACtE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuC;IAC9D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAyB;IACvD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAW;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;IAClC,OAAO,CAAC,sBAAsB,CAAC,CAAiC;gBAI7C,MAAM,EAAE,qBAAqB;IAWhD,YAAY,IAAI,IAAI;IAiBpB,eAAe,IAAI,IAAI;IAIvB,OAAO,CAAC,uBAAuB;IA0D/B,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,SAAI,GAAG,IAAI;IAiBhF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAiBpF,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,MAAM;IAmBvE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAiB5E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,SAAI,GAAG,IAAI;IAiB9E,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,KAAK,SAAI,GAAG,IAAI;IAiBxE,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAQ7B,cAAc,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAkB/C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,GAAG,IAAI;IAmB5E,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI;IAoBlG,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,EAAO,GAAG,IAAI;CAkB3E"}

package/dist/metrics.plugin.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Metrics plugin for NestJS RedisX.
+ * Provides Prometheus metrics collection and export.
+ */
+import { Provider, Type } from '@nestjs/common';
+import { IRedisXPlugin } from '@nestjs-redisx/core';
+import { IMetricsPluginOptions } from './shared/types';
+/**
+ * Metrics plugin for NestJS RedisX.
+ *
+ * Provides Prometheus metrics:
+ * - Redis command latency
+ * - Connection pool stats
+ * - Cache hit/miss rates
+ * - Error counts
+ * - HTTP endpoint for Prometheus scraping
+ *
+ * @example
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     RedisModule.forRoot({
+ *       clients: { host: 'localhost', port: 6379 },
+ *       plugins: [
+ *         new MetricsPlugin({
+ *           enabled: true,
+ *           exposeEndpoint: true,
+ *           endpoint: '/metrics',
+ *         }),
+ *       ],
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class MetricsPlugin implements IRedisXPlugin {
+    private readonly options;
+    readonly name = "metrics";
+    readonly version = "0.1.0";
+    readonly description = "Prometheus metrics collection and export";
+    constructor(options?: IMetricsPluginOptions);
+    getProviders(): Provider[];
+    getExports(): Array<string | symbol | Provider>;
+    getControllers(): Type[];
+}
+//# sourceMappingURL=metrics.plugin.d.ts.map

package/dist/metrics.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.plugin.d.ts","sourceRoot":"","sources":["../src/metrics.plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAgBvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAc,YAAW,aAAa;IAKrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,QAAQ,CAAC,IAAI,aAAa;IAC1B,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,WAAW,8CAA8C;gBAErC,OAAO,GAAE,qBAA0B;IAEhE,YAAY,IAAI,QAAQ,EAAE;IAoB1B,UAAU,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAI/C,cAAc,IAAI,IAAI,EAAE;CAOzB"}

package/dist/shared/constants/index.d.ts

@@ -0,0 +1,4 @@
+export declare const METRICS_PLUGIN_OPTIONS: unique symbol;
+export declare const METRICS_SERVICE: unique symbol;
+export declare const METRICS_REGISTRY: unique symbol;
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/constants/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,eAAuC,CAAC;AAC3E,eAAO,MAAM,eAAe,eAAgC,CAAC;AAC7D,eAAO,MAAM,gBAAgB,eAAiC,CAAC"}

package/dist/shared/errors/index.d.ts

@@ -0,0 +1,8 @@
+import { RedisXError } from '@nestjs-redisx/core';
+export declare class MetricsError extends RedisXError {
+    constructor(message: string, cause?: Error);
+}
+export declare class MetricRegistrationError extends MetricsError {
+    constructor(metricName: string, cause?: Error);
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAa,MAAM,qBAAqB,CAAC;AAE7D,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG3C;AAED,qBAAa,uBAAwB,SAAQ,YAAY;gBAC3C,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAG9C"}

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

@@ -0,0 +1,68 @@
+export interface IMetricsPluginOptions {
+    /**
+     * Make the module global.
+     * @default false
+     */
+    isGlobal?: boolean;
+    /**
+     * Enable metrics collection.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Metrics prefix.
+     * @default 'redisx_'
+     */
+    prefix?: string;
+    /**
+     * Default labels added to all metrics.
+     */
+    defaultLabels?: Record<string, string>;
+    /**
+     * Histogram buckets for latency (in seconds).
+     * @default [0.001, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]
+     */
+    histogramBuckets?: number[];
+    /**
+     * Expose /metrics endpoint.
+     * @default true
+     */
+    exposeEndpoint?: boolean;
+    /**
+     * Metrics endpoint path.
+     * Note: NestJS `@Controller()` path is a compile-time constant.
+     * This option is reserved for future use. The endpoint is always `/metrics`.
+     * @default '/metrics'
+     */
+    endpoint?: string;
+    /**
+     * Collect default Node.js metrics.
+     * @default true
+     */
+    collectDefaultMetrics?: boolean;
+    /**
+     * Enable detailed command metrics.
+     * @default true
+     */
+    commandMetrics?: boolean;
+    /**
+     * Enable plugin-specific metrics (cache, locks, etc).
+     * @default true
+     */
+    pluginMetrics?: boolean;
+    /**
+     * Collection interval for gauges (ms).
+     * @default 15000
+     */
+    collectInterval?: number;
+}
+export interface IMetricsJson {
+    name: string;
+    help: string;
+    type: string;
+    values: Array<{
+        labels: Record<string, string>;
+        value: number;
+    }>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAE5B;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEhC;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@nestjs-redisx/metrics",
+  "version": "1.0.0",
+  "description": "Prometheus metrics plugin for NestJS RedisX with custom metrics support",
+  "author": "NestJS RedisX Team",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "SKIP_INTEGRATION=true vitest run",
+    "test:watch": "SKIP_INTEGRATION=true vitest",
+    "test:cov": "SKIP_INTEGRATION=true vitest run --coverage",
+    "lint": "eslint \"{src,test}/**/*.ts\"",
+    "format": "prettier --write \"{src,test}/**/*.ts\""
+  },
+  "dependencies": {
+    "prom-client": "^15.1.0"
+  },
+  "keywords": [
+    "nestjs",
+    "redis",
+    "metrics",
+    "prometheus",
+    "monitoring",
+    "observability"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nestjs-redisx/nestjs-redisx.git",
+    "directory": "packages/metrics"
+  },
+  "homepage": "https://nestjs-redisx.dev/en/reference/metrics/",
+  "bugs": {
+    "url": "https://github.com/nestjs-redisx/nestjs-redisx/issues"
+  },
+  "peerDependencies": {
+    "@nestjs-redisx/core": "^1.0.0",
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "reflect-metadata": "^0.2.0",
+    "rxjs": "^7.8.0"
+  },
+  "devDependencies": {
+    "@nestjs/testing": "^10.0.0",
+    "@types/express": "^4.17.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.0.0",
+    "prettier": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.6.0",
+    "@vitest/coverage-v8": "^1.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}