@saga-bus/middleware-metrics 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+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,114 @@
+# @saga-bus/middleware-metrics
+
+Prometheus metrics middleware for saga-bus.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/middleware-metrics prom-client
+```
+
+## Usage
+
+```typescript
+import { createMetricsMiddleware } from "@saga-bus/middleware-metrics";
+import { createBus } from "@saga-bus/core";
+import { register } from "prom-client";
+
+const metricsMiddleware = createMetricsMiddleware();
+
+const bus = createBus({
+  middleware: [metricsMiddleware],
+  sagas: [...],
+  transport,
+});
+
+// Expose metrics endpoint (e.g., with Express)
+app.get("/metrics", async (req, res) => {
+  res.set("Content-Type", register.contentType);
+  res.end(await register.metrics());
+});
+```
+
+## Features
+
+- Message processing counter (success/failure)
+- Processing duration histogram
+- Saga lifecycle tracking (created/completed)
+- Customizable metric prefix
+- Configurable histogram buckets
+- Per-saga and per-message-type labels
+
+## Metrics
+
+| Metric | Type | Labels | Description |
+|--------|------|--------|-------------|
+| `saga_bus_messages_processed_total` | Counter | `message_type`, `saga_name` | Successfully processed messages |
+| `saga_bus_messages_failed_total` | Counter | `message_type`, `saga_name`, `error_type` | Failed message processing |
+| `saga_bus_message_processing_duration_ms` | Histogram | `message_type`, `saga_name` | Processing duration in milliseconds |
+| `saga_bus_sagas_created_total` | Counter | `saga_name`, `message_type` | New saga instances created |
+| `saga_bus_sagas_completed_total` | Counter | `saga_name` | Completed saga instances |
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `registry` | `Registry` | default | Prometheus registry |
+| `prefix` | `string` | `"saga_bus"` | Metric name prefix |
+| `durationBuckets` | `number[]` | `[1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000]` | Histogram buckets (ms) |
+| `recordSagaLabels` | `boolean` | `true` | Include saga_name label |
+
+## Custom Registry
+
+```typescript
+import { Registry } from "prom-client";
+
+const customRegistry = new Registry();
+
+const metricsMiddleware = createMetricsMiddleware({
+  registry: customRegistry,
+  prefix: "myapp",
+});
+
+// Use custom registry for metrics endpoint
+app.get("/metrics", async (req, res) => {
+  res.set("Content-Type", customRegistry.contentType);
+  res.end(await customRegistry.metrics());
+});
+```
+
+## Direct Metric Access
+
+Use `createMetricsMiddlewareWithMetrics` when you need direct access to metric objects:
+
+```typescript
+import { createMetricsMiddlewareWithMetrics } from "@saga-bus/middleware-metrics";
+
+const { middleware, metrics } = createMetricsMiddlewareWithMetrics();
+
+// Access metrics directly
+const processedCount = await metrics.messagesProcessed.get();
+console.log(`Processed: ${processedCount.values[0]?.value}`);
+```
+
+## Grafana Dashboard
+
+Example PromQL queries for dashboards:
+
+```promql
+# Message throughput (per minute)
+rate(saga_bus_messages_processed_total[1m])
+
+# P95 processing duration
+histogram_quantile(0.95, rate(saga_bus_message_processing_duration_ms_bucket[5m]))
+
+# Error rate
+rate(saga_bus_messages_failed_total[5m]) / rate(saga_bus_messages_processed_total[5m])
+
+# Sagas in flight (created - completed)
+saga_bus_sagas_created_total - saga_bus_sagas_completed_total
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,178 @@
+"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/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createMetricsMiddleware: () => createMetricsMiddleware,
+  createMetricsMiddlewareWithMetrics: () => createMetricsMiddlewareWithMetrics
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/MetricsMiddleware.ts
+var import_prom_client = require("prom-client");
+var DEFAULT_DURATION_BUCKETS = [1, 5, 10, 25, 50, 100, 250, 500, 1e3, 2500, 5e3];
+function createMetricsMiddleware(options = {}) {
+  const registry = options.registry ?? import_prom_client.register;
+  const prefix = options.prefix ?? "saga_bus";
+  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;
+  const recordSagaLabels = options.recordSagaLabels ?? true;
+  const baseLabelNames = ["message_type"];
+  const sagaLabelNames = recordSagaLabels ? [...baseLabelNames, "saga_name"] : baseLabelNames;
+  const messagesProcessed = new import_prom_client.Counter({
+    name: `${prefix}_messages_processed_total`,
+    help: "Total number of messages successfully processed",
+    labelNames: sagaLabelNames,
+    registers: [registry]
+  });
+  const messagesFailed = new import_prom_client.Counter({
+    name: `${prefix}_messages_failed_total`,
+    help: "Total number of messages that failed processing",
+    labelNames: [...sagaLabelNames, "error_type"],
+    registers: [registry]
+  });
+  const processingDuration = new import_prom_client.Histogram({
+    name: `${prefix}_message_processing_duration_ms`,
+    help: "Message processing duration in milliseconds",
+    labelNames: sagaLabelNames,
+    buckets: durationBuckets,
+    registers: [registry]
+  });
+  const sagasCreated = new import_prom_client.Counter({
+    name: `${prefix}_sagas_created_total`,
+    help: "Total number of new saga instances created",
+    labelNames: ["saga_name", "message_type"],
+    registers: [registry]
+  });
+  const sagasCompleted = new import_prom_client.Counter({
+    name: `${prefix}_sagas_completed_total`,
+    help: "Total number of saga instances completed",
+    labelNames: ["saga_name"],
+    registers: [registry]
+  });
+  return async (ctx, next) => {
+    const startTime = performance.now();
+    const messageType = ctx.envelope.type;
+    const sagaName = ctx.sagaName;
+    const isNewSaga = !ctx.existingState;
+    const labels = recordSagaLabels ? { message_type: messageType, saga_name: sagaName } : { message_type: messageType };
+    try {
+      await next();
+      const durationMs = performance.now() - startTime;
+      messagesProcessed.inc(labels);
+      processingDuration.observe(labels, durationMs);
+      if (isNewSaga && ctx.postState) {
+        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });
+      }
+      if (ctx.postState?.metadata?.isCompleted) {
+        sagasCompleted.inc({ saga_name: sagaName });
+      }
+    } catch (error) {
+      const durationMs = performance.now() - startTime;
+      const errorType = getErrorType(error);
+      messagesFailed.inc({ ...labels, error_type: errorType });
+      processingDuration.observe(labels, durationMs);
+      throw error;
+    }
+  };
+}
+function getErrorType(error) {
+  if (error instanceof Error) {
+    return error.name || "Error";
+  }
+  return "Unknown";
+}
+function createMetricsMiddlewareWithMetrics(options = {}) {
+  const registry = options.registry ?? import_prom_client.register;
+  const prefix = options.prefix ?? "saga_bus";
+  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;
+  const recordSagaLabels = options.recordSagaLabels ?? true;
+  const baseLabelNames = ["message_type"];
+  const sagaLabelNames = recordSagaLabels ? [...baseLabelNames, "saga_name"] : baseLabelNames;
+  const messagesProcessed = new import_prom_client.Counter({
+    name: `${prefix}_messages_processed_total`,
+    help: "Total number of messages successfully processed",
+    labelNames: sagaLabelNames,
+    registers: [registry]
+  });
+  const messagesFailed = new import_prom_client.Counter({
+    name: `${prefix}_messages_failed_total`,
+    help: "Total number of messages that failed processing",
+    labelNames: [...sagaLabelNames, "error_type"],
+    registers: [registry]
+  });
+  const processingDuration = new import_prom_client.Histogram({
+    name: `${prefix}_message_processing_duration_ms`,
+    help: "Message processing duration in milliseconds",
+    labelNames: sagaLabelNames,
+    buckets: durationBuckets,
+    registers: [registry]
+  });
+  const sagasCreated = new import_prom_client.Counter({
+    name: `${prefix}_sagas_created_total`,
+    help: "Total number of new saga instances created",
+    labelNames: ["saga_name", "message_type"],
+    registers: [registry]
+  });
+  const sagasCompleted = new import_prom_client.Counter({
+    name: `${prefix}_sagas_completed_total`,
+    help: "Total number of saga instances completed",
+    labelNames: ["saga_name"],
+    registers: [registry]
+  });
+  const metrics = {
+    messagesProcessed,
+    messagesFailed,
+    processingDuration,
+    sagasCreated,
+    sagasCompleted
+  };
+  const middleware = async (ctx, next) => {
+    const startTime = performance.now();
+    const messageType = ctx.envelope.type;
+    const sagaName = ctx.sagaName;
+    const isNewSaga = !ctx.existingState;
+    const labels = recordSagaLabels ? { message_type: messageType, saga_name: sagaName } : { message_type: messageType };
+    try {
+      await next();
+      const durationMs = performance.now() - startTime;
+      messagesProcessed.inc(labels);
+      processingDuration.observe(labels, durationMs);
+      if (isNewSaga && ctx.postState) {
+        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });
+      }
+      if (ctx.postState?.metadata?.isCompleted) {
+        sagasCompleted.inc({ saga_name: sagaName });
+      }
+    } catch (error) {
+      const durationMs = performance.now() - startTime;
+      const errorType = getErrorType(error);
+      messagesFailed.inc({ ...labels, error_type: errorType });
+      processingDuration.observe(labels, durationMs);
+      throw error;
+    }
+  };
+  return { middleware, metrics };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createMetricsMiddleware,
+  createMetricsMiddlewareWithMetrics
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/MetricsMiddleware.ts"],"sourcesContent":["export {\n  createMetricsMiddleware,\n  createMetricsMiddlewareWithMetrics,\n} from \"./MetricsMiddleware.js\";\nexport type { MetricsMiddlewareOptions, SagaBusMetrics } from \"./types.js\";\n","import {\n  Counter,\n  Histogram,\n  register as defaultRegister,\n} from \"prom-client\";\nimport type { SagaMiddleware, SagaPipelineContext } from \"@saga-bus/core\";\nimport type { MetricsMiddlewareOptions, SagaBusMetrics } from \"./types.js\";\n\nconst DEFAULT_DURATION_BUCKETS = [1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000];\n\n/**\n * Creates a Prometheus metrics middleware for saga-bus.\n *\n * Records:\n * - Messages processed (counter)\n * - Messages failed (counter)\n * - Processing duration (histogram)\n * - Sagas created (counter)\n * - Sagas completed (counter)\n *\n * @example\n * ```typescript\n * import { createMetricsMiddleware } from \"@saga-bus/middleware-metrics\";\n * import { register } from \"prom-client\";\n *\n * const metricsMiddleware = createMetricsMiddleware({\n *   prefix: \"my_app\",\n * });\n *\n * const bus = createBus({\n *   middleware: [metricsMiddleware],\n *   // ...\n * });\n *\n * // Expose metrics endpoint\n * app.get(\"/metrics\", async (req, res) => {\n *   res.set(\"Content-Type\", register.contentType);\n *   res.end(await register.metrics());\n * });\n * ```\n */\nexport function createMetricsMiddleware(\n  options: MetricsMiddlewareOptions = {}\n): SagaMiddleware {\n  const registry = options.registry ?? defaultRegister;\n  const prefix = options.prefix ?? \"saga_bus\";\n  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;\n  const recordSagaLabels = options.recordSagaLabels ?? true;\n\n  // Build label names\n  const baseLabelNames = [\"message_type\"];\n  const sagaLabelNames = recordSagaLabels\n    ? [...baseLabelNames, \"saga_name\"]\n    : baseLabelNames;\n\n  // Create metrics\n  const messagesProcessed = new Counter({\n    name: `${prefix}_messages_processed_total`,\n    help: \"Total number of messages successfully processed\",\n    labelNames: sagaLabelNames,\n    registers: [registry],\n  });\n\n  const messagesFailed = new Counter({\n    name: `${prefix}_messages_failed_total`,\n    help: \"Total number of messages that failed processing\",\n    labelNames: [...sagaLabelNames, \"error_type\"],\n    registers: [registry],\n  });\n\n  const processingDuration = new Histogram({\n    name: `${prefix}_message_processing_duration_ms`,\n    help: \"Message processing duration in milliseconds\",\n    labelNames: sagaLabelNames,\n    buckets: durationBuckets,\n    registers: [registry],\n  });\n\n  const sagasCreated = new Counter({\n    name: `${prefix}_sagas_created_total`,\n    help: \"Total number of new saga instances created\",\n    labelNames: [\"saga_name\", \"message_type\"],\n    registers: [registry],\n  });\n\n  const sagasCompleted = new Counter({\n    name: `${prefix}_sagas_completed_total`,\n    help: \"Total number of saga instances completed\",\n    labelNames: [\"saga_name\"],\n    registers: [registry],\n  });\n\n  return async (ctx: SagaPipelineContext, next: () => Promise<void>) => {\n    const startTime = performance.now();\n    const messageType = ctx.envelope.type;\n    const sagaName = ctx.sagaName;\n    const isNewSaga = !ctx.existingState;\n\n    const labels = recordSagaLabels\n      ? { message_type: messageType, saga_name: sagaName }\n      : { message_type: messageType };\n\n    try {\n      await next();\n\n      // Record successful processing\n      const durationMs = performance.now() - startTime;\n      messagesProcessed.inc(labels);\n      processingDuration.observe(labels, durationMs);\n\n      // Track saga lifecycle\n      if (isNewSaga && ctx.postState) {\n        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });\n      }\n\n      if (ctx.postState?.metadata?.isCompleted) {\n        sagasCompleted.inc({ saga_name: sagaName });\n      }\n    } catch (error) {\n      // Record failed processing\n      const durationMs = performance.now() - startTime;\n      const errorType = getErrorType(error);\n\n      messagesFailed.inc({ ...labels, error_type: errorType });\n      processingDuration.observe(labels, durationMs);\n\n      throw error;\n    }\n  };\n}\n\nfunction getErrorType(error: unknown): string {\n  if (error instanceof Error) {\n    return error.name || \"Error\";\n  }\n  return \"Unknown\";\n}\n\n/**\n * Creates metrics and returns both the middleware and the metrics objects.\n * Useful when you need direct access to the metric objects.\n *\n * @example\n * ```typescript\n * const { middleware, metrics } = createMetricsMiddlewareWithMetrics();\n *\n * // Access metrics directly\n * console.log(await metrics.messagesProcessed.get());\n * ```\n */\nexport function createMetricsMiddlewareWithMetrics(\n  options: MetricsMiddlewareOptions = {}\n): { middleware: SagaMiddleware; metrics: SagaBusMetrics } {\n  const registry = options.registry ?? defaultRegister;\n  const prefix = options.prefix ?? \"saga_bus\";\n  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;\n  const recordSagaLabels = options.recordSagaLabels ?? true;\n\n  // Build label names\n  const baseLabelNames = [\"message_type\"];\n  const sagaLabelNames = recordSagaLabels\n    ? [...baseLabelNames, \"saga_name\"]\n    : baseLabelNames;\n\n  // Create metrics\n  const messagesProcessed = new Counter({\n    name: `${prefix}_messages_processed_total`,\n    help: \"Total number of messages successfully processed\",\n    labelNames: sagaLabelNames,\n    registers: [registry],\n  });\n\n  const messagesFailed = new Counter({\n    name: `${prefix}_messages_failed_total`,\n    help: \"Total number of messages that failed processing\",\n    labelNames: [...sagaLabelNames, \"error_type\"],\n    registers: [registry],\n  });\n\n  const processingDuration = new Histogram({\n    name: `${prefix}_message_processing_duration_ms`,\n    help: \"Message processing duration in milliseconds\",\n    labelNames: sagaLabelNames,\n    buckets: durationBuckets,\n    registers: [registry],\n  });\n\n  const sagasCreated = new Counter({\n    name: `${prefix}_sagas_created_total`,\n    help: \"Total number of new saga instances created\",\n    labelNames: [\"saga_name\", \"message_type\"],\n    registers: [registry],\n  });\n\n  const sagasCompleted = new Counter({\n    name: `${prefix}_sagas_completed_total`,\n    help: \"Total number of saga instances completed\",\n    labelNames: [\"saga_name\"],\n    registers: [registry],\n  });\n\n  const metrics: SagaBusMetrics = {\n    messagesProcessed,\n    messagesFailed,\n    processingDuration,\n    sagasCreated,\n    sagasCompleted,\n  };\n\n  const middleware: SagaMiddleware = async (\n    ctx: SagaPipelineContext,\n    next: () => Promise<void>\n  ) => {\n    const startTime = performance.now();\n    const messageType = ctx.envelope.type;\n    const sagaName = ctx.sagaName;\n    const isNewSaga = !ctx.existingState;\n\n    const labels = recordSagaLabels\n      ? { message_type: messageType, saga_name: sagaName }\n      : { message_type: messageType };\n\n    try {\n      await next();\n\n      const durationMs = performance.now() - startTime;\n      messagesProcessed.inc(labels);\n      processingDuration.observe(labels, durationMs);\n\n      if (isNewSaga && ctx.postState) {\n        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });\n      }\n\n      if (ctx.postState?.metadata?.isCompleted) {\n        sagasCompleted.inc({ saga_name: sagaName });\n      }\n    } catch (error) {\n      const durationMs = performance.now() - startTime;\n      const errorType = getErrorType(error);\n\n      messagesFailed.inc({ ...labels, error_type: errorType });\n      processingDuration.observe(labels, durationMs);\n\n      throw error;\n    }\n  };\n\n  return { middleware, metrics };\n}\n"],"mappings":"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","names":["defaultRegister"]}

package/dist/index.d.cts

@@ -0,0 +1,106 @@
+import { SagaMiddleware } from '@saga-bus/core';
+import { Registry, Counter, Histogram } from 'prom-client';
+
+/**
+ * Options for configuring the metrics middleware.
+ */
+interface MetricsMiddlewareOptions {
+    /**
+     * Prometheus registry to use. Defaults to the global default registry.
+     */
+    registry?: Registry;
+    /**
+     * Prefix for metric names. Defaults to "saga_bus".
+     */
+    prefix?: string;
+    /**
+     * Custom labels to add to all metrics.
+     */
+    customLabels?: Record<string, string>;
+    /**
+     * Histogram buckets for processing duration in milliseconds.
+     * Defaults to [1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000]
+     */
+    durationBuckets?: number[];
+    /**
+     * Whether to record saga-related labels (saga_name, is_new, is_completed).
+     * Defaults to true.
+     */
+    recordSagaLabels?: boolean;
+}
+/**
+ * Metrics exposed by the middleware.
+ */
+interface SagaBusMetrics {
+    /**
+     * Counter for total messages processed.
+     */
+    messagesProcessed: Counter;
+    /**
+     * Counter for total messages failed.
+     */
+    messagesFailed: Counter;
+    /**
+     * Histogram for message processing duration.
+     */
+    processingDuration: Histogram;
+    /**
+     * Counter for sagas created.
+     */
+    sagasCreated: Counter;
+    /**
+     * Counter for sagas completed.
+     */
+    sagasCompleted: Counter;
+}
+
+/**
+ * Creates a Prometheus metrics middleware for saga-bus.
+ *
+ * Records:
+ * - Messages processed (counter)
+ * - Messages failed (counter)
+ * - Processing duration (histogram)
+ * - Sagas created (counter)
+ * - Sagas completed (counter)
+ *
+ * @example
+ * ```typescript
+ * import { createMetricsMiddleware } from "@saga-bus/middleware-metrics";
+ * import { register } from "prom-client";
+ *
+ * const metricsMiddleware = createMetricsMiddleware({
+ *   prefix: "my_app",
+ * });
+ *
+ * const bus = createBus({
+ *   middleware: [metricsMiddleware],
+ *   // ...
+ * });
+ *
+ * // Expose metrics endpoint
+ * app.get("/metrics", async (req, res) => {
+ *   res.set("Content-Type", register.contentType);
+ *   res.end(await register.metrics());
+ * });
+ * ```
+ */
+declare function createMetricsMiddleware(options?: MetricsMiddlewareOptions): SagaMiddleware;
+/**
+ * Creates metrics and returns both the middleware and the metrics objects.
+ * Useful when you need direct access to the metric objects.
+ *
+ * @example
+ * ```typescript
+ * const { middleware, metrics } = createMetricsMiddlewareWithMetrics();
+ *
+ * // Access metrics directly
+ * console.log(await metrics.messagesProcessed.get());
+ * ```
+ */
+declare function createMetricsMiddlewareWithMetrics(options?: MetricsMiddlewareOptions): {
+    middleware: SagaMiddleware;
+    metrics: SagaBusMetrics;
+};
+
+export { type MetricsMiddlewareOptions, type SagaBusMetrics, createMetricsMiddleware, createMetricsMiddlewareWithMetrics };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+import { SagaMiddleware } from '@saga-bus/core';
+import { Registry, Counter, Histogram } from 'prom-client';
+
+/**
+ * Options for configuring the metrics middleware.
+ */
+interface MetricsMiddlewareOptions {
+    /**
+     * Prometheus registry to use. Defaults to the global default registry.
+     */
+    registry?: Registry;
+    /**
+     * Prefix for metric names. Defaults to "saga_bus".
+     */
+    prefix?: string;
+    /**
+     * Custom labels to add to all metrics.
+     */
+    customLabels?: Record<string, string>;
+    /**
+     * Histogram buckets for processing duration in milliseconds.
+     * Defaults to [1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000]
+     */
+    durationBuckets?: number[];
+    /**
+     * Whether to record saga-related labels (saga_name, is_new, is_completed).
+     * Defaults to true.
+     */
+    recordSagaLabels?: boolean;
+}
+/**
+ * Metrics exposed by the middleware.
+ */
+interface SagaBusMetrics {
+    /**
+     * Counter for total messages processed.
+     */
+    messagesProcessed: Counter;
+    /**
+     * Counter for total messages failed.
+     */
+    messagesFailed: Counter;
+    /**
+     * Histogram for message processing duration.
+     */
+    processingDuration: Histogram;
+    /**
+     * Counter for sagas created.
+     */
+    sagasCreated: Counter;
+    /**
+     * Counter for sagas completed.
+     */
+    sagasCompleted: Counter;
+}
+
+/**
+ * Creates a Prometheus metrics middleware for saga-bus.
+ *
+ * Records:
+ * - Messages processed (counter)
+ * - Messages failed (counter)
+ * - Processing duration (histogram)
+ * - Sagas created (counter)
+ * - Sagas completed (counter)
+ *
+ * @example
+ * ```typescript
+ * import { createMetricsMiddleware } from "@saga-bus/middleware-metrics";
+ * import { register } from "prom-client";
+ *
+ * const metricsMiddleware = createMetricsMiddleware({
+ *   prefix: "my_app",
+ * });
+ *
+ * const bus = createBus({
+ *   middleware: [metricsMiddleware],
+ *   // ...
+ * });
+ *
+ * // Expose metrics endpoint
+ * app.get("/metrics", async (req, res) => {
+ *   res.set("Content-Type", register.contentType);
+ *   res.end(await register.metrics());
+ * });
+ * ```
+ */
+declare function createMetricsMiddleware(options?: MetricsMiddlewareOptions): SagaMiddleware;
+/**
+ * Creates metrics and returns both the middleware and the metrics objects.
+ * Useful when you need direct access to the metric objects.
+ *
+ * @example
+ * ```typescript
+ * const { middleware, metrics } = createMetricsMiddlewareWithMetrics();
+ *
+ * // Access metrics directly
+ * console.log(await metrics.messagesProcessed.get());
+ * ```
+ */
+declare function createMetricsMiddlewareWithMetrics(options?: MetricsMiddlewareOptions): {
+    middleware: SagaMiddleware;
+    metrics: SagaBusMetrics;
+};
+
+export { type MetricsMiddlewareOptions, type SagaBusMetrics, createMetricsMiddleware, createMetricsMiddlewareWithMetrics };

package/dist/index.js

@@ -0,0 +1,154 @@
+// src/MetricsMiddleware.ts
+import {
+  Counter,
+  Histogram,
+  register as defaultRegister
+} from "prom-client";
+var DEFAULT_DURATION_BUCKETS = [1, 5, 10, 25, 50, 100, 250, 500, 1e3, 2500, 5e3];
+function createMetricsMiddleware(options = {}) {
+  const registry = options.registry ?? defaultRegister;
+  const prefix = options.prefix ?? "saga_bus";
+  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;
+  const recordSagaLabels = options.recordSagaLabels ?? true;
+  const baseLabelNames = ["message_type"];
+  const sagaLabelNames = recordSagaLabels ? [...baseLabelNames, "saga_name"] : baseLabelNames;
+  const messagesProcessed = new Counter({
+    name: `${prefix}_messages_processed_total`,
+    help: "Total number of messages successfully processed",
+    labelNames: sagaLabelNames,
+    registers: [registry]
+  });
+  const messagesFailed = new Counter({
+    name: `${prefix}_messages_failed_total`,
+    help: "Total number of messages that failed processing",
+    labelNames: [...sagaLabelNames, "error_type"],
+    registers: [registry]
+  });
+  const processingDuration = new Histogram({
+    name: `${prefix}_message_processing_duration_ms`,
+    help: "Message processing duration in milliseconds",
+    labelNames: sagaLabelNames,
+    buckets: durationBuckets,
+    registers: [registry]
+  });
+  const sagasCreated = new Counter({
+    name: `${prefix}_sagas_created_total`,
+    help: "Total number of new saga instances created",
+    labelNames: ["saga_name", "message_type"],
+    registers: [registry]
+  });
+  const sagasCompleted = new Counter({
+    name: `${prefix}_sagas_completed_total`,
+    help: "Total number of saga instances completed",
+    labelNames: ["saga_name"],
+    registers: [registry]
+  });
+  return async (ctx, next) => {
+    const startTime = performance.now();
+    const messageType = ctx.envelope.type;
+    const sagaName = ctx.sagaName;
+    const isNewSaga = !ctx.existingState;
+    const labels = recordSagaLabels ? { message_type: messageType, saga_name: sagaName } : { message_type: messageType };
+    try {
+      await next();
+      const durationMs = performance.now() - startTime;
+      messagesProcessed.inc(labels);
+      processingDuration.observe(labels, durationMs);
+      if (isNewSaga && ctx.postState) {
+        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });
+      }
+      if (ctx.postState?.metadata?.isCompleted) {
+        sagasCompleted.inc({ saga_name: sagaName });
+      }
+    } catch (error) {
+      const durationMs = performance.now() - startTime;
+      const errorType = getErrorType(error);
+      messagesFailed.inc({ ...labels, error_type: errorType });
+      processingDuration.observe(labels, durationMs);
+      throw error;
+    }
+  };
+}
+function getErrorType(error) {
+  if (error instanceof Error) {
+    return error.name || "Error";
+  }
+  return "Unknown";
+}
+function createMetricsMiddlewareWithMetrics(options = {}) {
+  const registry = options.registry ?? defaultRegister;
+  const prefix = options.prefix ?? "saga_bus";
+  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;
+  const recordSagaLabels = options.recordSagaLabels ?? true;
+  const baseLabelNames = ["message_type"];
+  const sagaLabelNames = recordSagaLabels ? [...baseLabelNames, "saga_name"] : baseLabelNames;
+  const messagesProcessed = new Counter({
+    name: `${prefix}_messages_processed_total`,
+    help: "Total number of messages successfully processed",
+    labelNames: sagaLabelNames,
+    registers: [registry]
+  });
+  const messagesFailed = new Counter({
+    name: `${prefix}_messages_failed_total`,
+    help: "Total number of messages that failed processing",
+    labelNames: [...sagaLabelNames, "error_type"],
+    registers: [registry]
+  });
+  const processingDuration = new Histogram({
+    name: `${prefix}_message_processing_duration_ms`,
+    help: "Message processing duration in milliseconds",
+    labelNames: sagaLabelNames,
+    buckets: durationBuckets,
+    registers: [registry]
+  });
+  const sagasCreated = new Counter({
+    name: `${prefix}_sagas_created_total`,
+    help: "Total number of new saga instances created",
+    labelNames: ["saga_name", "message_type"],
+    registers: [registry]
+  });
+  const sagasCompleted = new Counter({
+    name: `${prefix}_sagas_completed_total`,
+    help: "Total number of saga instances completed",
+    labelNames: ["saga_name"],
+    registers: [registry]
+  });
+  const metrics = {
+    messagesProcessed,
+    messagesFailed,
+    processingDuration,
+    sagasCreated,
+    sagasCompleted
+  };
+  const middleware = async (ctx, next) => {
+    const startTime = performance.now();
+    const messageType = ctx.envelope.type;
+    const sagaName = ctx.sagaName;
+    const isNewSaga = !ctx.existingState;
+    const labels = recordSagaLabels ? { message_type: messageType, saga_name: sagaName } : { message_type: messageType };
+    try {
+      await next();
+      const durationMs = performance.now() - startTime;
+      messagesProcessed.inc(labels);
+      processingDuration.observe(labels, durationMs);
+      if (isNewSaga && ctx.postState) {
+        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });
+      }
+      if (ctx.postState?.metadata?.isCompleted) {
+        sagasCompleted.inc({ saga_name: sagaName });
+      }
+    } catch (error) {
+      const durationMs = performance.now() - startTime;
+      const errorType = getErrorType(error);
+      messagesFailed.inc({ ...labels, error_type: errorType });
+      processingDuration.observe(labels, durationMs);
+      throw error;
+    }
+  };
+  return { middleware, metrics };
+}
+export {
+  createMetricsMiddleware,
+  createMetricsMiddlewareWithMetrics
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/MetricsMiddleware.ts"],"sourcesContent":["import {\n  Counter,\n  Histogram,\n  register as defaultRegister,\n} from \"prom-client\";\nimport type { SagaMiddleware, SagaPipelineContext } from \"@saga-bus/core\";\nimport type { MetricsMiddlewareOptions, SagaBusMetrics } from \"./types.js\";\n\nconst DEFAULT_DURATION_BUCKETS = [1, 5, 10, 25, 50, 100, 250, 500, 1000, 2500, 5000];\n\n/**\n * Creates a Prometheus metrics middleware for saga-bus.\n *\n * Records:\n * - Messages processed (counter)\n * - Messages failed (counter)\n * - Processing duration (histogram)\n * - Sagas created (counter)\n * - Sagas completed (counter)\n *\n * @example\n * ```typescript\n * import { createMetricsMiddleware } from \"@saga-bus/middleware-metrics\";\n * import { register } from \"prom-client\";\n *\n * const metricsMiddleware = createMetricsMiddleware({\n *   prefix: \"my_app\",\n * });\n *\n * const bus = createBus({\n *   middleware: [metricsMiddleware],\n *   // ...\n * });\n *\n * // Expose metrics endpoint\n * app.get(\"/metrics\", async (req, res) => {\n *   res.set(\"Content-Type\", register.contentType);\n *   res.end(await register.metrics());\n * });\n * ```\n */\nexport function createMetricsMiddleware(\n  options: MetricsMiddlewareOptions = {}\n): SagaMiddleware {\n  const registry = options.registry ?? defaultRegister;\n  const prefix = options.prefix ?? \"saga_bus\";\n  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;\n  const recordSagaLabels = options.recordSagaLabels ?? true;\n\n  // Build label names\n  const baseLabelNames = [\"message_type\"];\n  const sagaLabelNames = recordSagaLabels\n    ? [...baseLabelNames, \"saga_name\"]\n    : baseLabelNames;\n\n  // Create metrics\n  const messagesProcessed = new Counter({\n    name: `${prefix}_messages_processed_total`,\n    help: \"Total number of messages successfully processed\",\n    labelNames: sagaLabelNames,\n    registers: [registry],\n  });\n\n  const messagesFailed = new Counter({\n    name: `${prefix}_messages_failed_total`,\n    help: \"Total number of messages that failed processing\",\n    labelNames: [...sagaLabelNames, \"error_type\"],\n    registers: [registry],\n  });\n\n  const processingDuration = new Histogram({\n    name: `${prefix}_message_processing_duration_ms`,\n    help: \"Message processing duration in milliseconds\",\n    labelNames: sagaLabelNames,\n    buckets: durationBuckets,\n    registers: [registry],\n  });\n\n  const sagasCreated = new Counter({\n    name: `${prefix}_sagas_created_total`,\n    help: \"Total number of new saga instances created\",\n    labelNames: [\"saga_name\", \"message_type\"],\n    registers: [registry],\n  });\n\n  const sagasCompleted = new Counter({\n    name: `${prefix}_sagas_completed_total`,\n    help: \"Total number of saga instances completed\",\n    labelNames: [\"saga_name\"],\n    registers: [registry],\n  });\n\n  return async (ctx: SagaPipelineContext, next: () => Promise<void>) => {\n    const startTime = performance.now();\n    const messageType = ctx.envelope.type;\n    const sagaName = ctx.sagaName;\n    const isNewSaga = !ctx.existingState;\n\n    const labels = recordSagaLabels\n      ? { message_type: messageType, saga_name: sagaName }\n      : { message_type: messageType };\n\n    try {\n      await next();\n\n      // Record successful processing\n      const durationMs = performance.now() - startTime;\n      messagesProcessed.inc(labels);\n      processingDuration.observe(labels, durationMs);\n\n      // Track saga lifecycle\n      if (isNewSaga && ctx.postState) {\n        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });\n      }\n\n      if (ctx.postState?.metadata?.isCompleted) {\n        sagasCompleted.inc({ saga_name: sagaName });\n      }\n    } catch (error) {\n      // Record failed processing\n      const durationMs = performance.now() - startTime;\n      const errorType = getErrorType(error);\n\n      messagesFailed.inc({ ...labels, error_type: errorType });\n      processingDuration.observe(labels, durationMs);\n\n      throw error;\n    }\n  };\n}\n\nfunction getErrorType(error: unknown): string {\n  if (error instanceof Error) {\n    return error.name || \"Error\";\n  }\n  return \"Unknown\";\n}\n\n/**\n * Creates metrics and returns both the middleware and the metrics objects.\n * Useful when you need direct access to the metric objects.\n *\n * @example\n * ```typescript\n * const { middleware, metrics } = createMetricsMiddlewareWithMetrics();\n *\n * // Access metrics directly\n * console.log(await metrics.messagesProcessed.get());\n * ```\n */\nexport function createMetricsMiddlewareWithMetrics(\n  options: MetricsMiddlewareOptions = {}\n): { middleware: SagaMiddleware; metrics: SagaBusMetrics } {\n  const registry = options.registry ?? defaultRegister;\n  const prefix = options.prefix ?? \"saga_bus\";\n  const durationBuckets = options.durationBuckets ?? DEFAULT_DURATION_BUCKETS;\n  const recordSagaLabels = options.recordSagaLabels ?? true;\n\n  // Build label names\n  const baseLabelNames = [\"message_type\"];\n  const sagaLabelNames = recordSagaLabels\n    ? [...baseLabelNames, \"saga_name\"]\n    : baseLabelNames;\n\n  // Create metrics\n  const messagesProcessed = new Counter({\n    name: `${prefix}_messages_processed_total`,\n    help: \"Total number of messages successfully processed\",\n    labelNames: sagaLabelNames,\n    registers: [registry],\n  });\n\n  const messagesFailed = new Counter({\n    name: `${prefix}_messages_failed_total`,\n    help: \"Total number of messages that failed processing\",\n    labelNames: [...sagaLabelNames, \"error_type\"],\n    registers: [registry],\n  });\n\n  const processingDuration = new Histogram({\n    name: `${prefix}_message_processing_duration_ms`,\n    help: \"Message processing duration in milliseconds\",\n    labelNames: sagaLabelNames,\n    buckets: durationBuckets,\n    registers: [registry],\n  });\n\n  const sagasCreated = new Counter({\n    name: `${prefix}_sagas_created_total`,\n    help: \"Total number of new saga instances created\",\n    labelNames: [\"saga_name\", \"message_type\"],\n    registers: [registry],\n  });\n\n  const sagasCompleted = new Counter({\n    name: `${prefix}_sagas_completed_total`,\n    help: \"Total number of saga instances completed\",\n    labelNames: [\"saga_name\"],\n    registers: [registry],\n  });\n\n  const metrics: SagaBusMetrics = {\n    messagesProcessed,\n    messagesFailed,\n    processingDuration,\n    sagasCreated,\n    sagasCompleted,\n  };\n\n  const middleware: SagaMiddleware = async (\n    ctx: SagaPipelineContext,\n    next: () => Promise<void>\n  ) => {\n    const startTime = performance.now();\n    const messageType = ctx.envelope.type;\n    const sagaName = ctx.sagaName;\n    const isNewSaga = !ctx.existingState;\n\n    const labels = recordSagaLabels\n      ? { message_type: messageType, saga_name: sagaName }\n      : { message_type: messageType };\n\n    try {\n      await next();\n\n      const durationMs = performance.now() - startTime;\n      messagesProcessed.inc(labels);\n      processingDuration.observe(labels, durationMs);\n\n      if (isNewSaga && ctx.postState) {\n        sagasCreated.inc({ saga_name: sagaName, message_type: messageType });\n      }\n\n      if (ctx.postState?.metadata?.isCompleted) {\n        sagasCompleted.inc({ saga_name: sagaName });\n      }\n    } catch (error) {\n      const durationMs = performance.now() - startTime;\n      const errorType = getErrorType(error);\n\n      messagesFailed.inc({ ...labels, error_type: errorType });\n      processingDuration.observe(labels, durationMs);\n\n      throw error;\n    }\n  };\n\n  return { middleware, metrics };\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@saga-bus/middleware-metrics",
+  "version": "1.0.0",
+  "description": "Prometheus metrics middleware for saga-bus",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/deanforan/saga-bus.git",
+    "directory": "packages/middleware-metrics"
+  },
+  "bugs": {
+    "url": "https://github.com/deanforan/saga-bus/issues"
+  },
+  "homepage": "https://github.com/deanforan/saga-bus#readme",
+  "keywords": [
+    "saga",
+    "message-bus",
+    "middleware",
+    "metrics",
+    "prometheus",
+    "observability"
+  ],
+  "dependencies": {
+    "prom-client": "^15.1.0",
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0",
+    "@repo/typescript-config": "0.0.0",
+    "@repo/eslint-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@saga-bus/core": ">=0.1.0",
+    "prom-client": ">=14.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}