@getstrata/bootstrap 2.2.7 → 2.2.8

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # @getstrata/bootstrap changelog
 
+## 2.2.8
+
+- Add bounded read-only Postgres outbox metrics
+
 ## 2.2.7
 
 - Where an ordinary operation needs SQL because the framework cannot express it

package/dist/bootstrap/metricsRoutes.d.ts

@@ -1,4 +1,15 @@
-declare function createMetricsRoutes(): {
+import { type OutboxMetricsCollector } from "@getstrata/core/events/outbox";
+import { type RedisQueueSnapshotOptions } from "@getstrata/core/queue/queueMetrics";
+interface MetricsRoutesOptions {
+    /** Opt in to shared Redis queue observations; no database or failed-job scan. */
+    queue?: RedisQueueSnapshotOptions & {
+        redisUrl: string;
+    };
+    /** Explicit platform outbox observation; caller owns collector shutdown. */
+    outbox?: Pick<OutboxMetricsCollector, "collect">;
+}
+declare function createMetricsRoutes(options?: MetricsRoutesOptions): {
     "/metrics": (request: Request) => Promise<Response>;
 };
+export type { MetricsRoutesOptions };
 export { createMetricsRoutes };

package/dist/entries/metricsRoutes.js

@@ -1,7 +1,12 @@
 // @bun
 // ../../src/bootstrap/metricsRoutes.ts
 import { timingSafeEqual } from "crypto";
+import { renderOutboxMetrics } from "@getstrata/core/events/outbox";
 import { prometheusRegistry } from "@getstrata/core/metrics/prometheus";
+import {
+  readRedisQueueSnapshot,
+  renderRedisQueueMetrics
+} from "@getstrata/core/queue/queueMetrics";
 import { isProductionEnv } from "@getstrata/core/runtime/appEnv";
 function tokensMatch(left, right) {
   const leftBuffer = Buffer.from(left);
@@ -23,16 +28,33 @@ function authorizeMetrics(request) {
   }
   return true;
 }
-function createMetricsRoutes() {
+function createMetricsRoutes(options = {}) {
+  let collection;
+  const collect = () => {
+    if (!options.queue && !options.outbox)
+      return Promise.resolve("");
+    const failure = (name) => `# HELP strata_${name}_collector_success Whether the configured ${name} collection succeeded.
+# TYPE strata_${name}_collector_success gauge
+strata_${name}_collector_success 0
+`;
+    collection ??= Promise.all([
+      options.queue ? readRedisQueueSnapshot(options.queue.redisUrl, options.queue).then(renderRedisQueueMetrics).catch(() => failure("queue")) : Promise.resolve(""),
+      options.outbox ? Promise.resolve().then(() => options.outbox?.collect()).then((snapshot) => snapshot ? renderOutboxMetrics(snapshot) : "").catch(() => failure("outbox")) : Promise.resolve("")
+    ]).then((parts) => parts.join("")).finally(() => {
+      collection = undefined;
+    });
+    return collection;
+  };
   return {
     "/metrics": async (request) => {
       if (!authorizeMetrics(request)) {
         return new Response("Not Found", { status: 404 });
       }
-      return new Response(prometheusRegistry.renderMetrics(), {
+      return new Response(prometheusRegistry.renderMetrics() + await collect(), {
         status: 200,
         headers: {
-          "content-type": "text/plain; version=0.0.4; charset=utf-8"
+          "content-type": "text/plain; version=0.0.4; charset=utf-8",
+          "cache-control": "no-store"
         }
       });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getstrata/bootstrap",
-  "version": "2.2.7",
+  "version": "2.2.8",
   "description": "Strata application bootstrap: HttpKernel, DI, web session helpers",
   "type": "module",
   "license": "MIT",
@@ -190,7 +190,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@getstrata/core": "^2.2.7",
+    "@getstrata/core": "^2.2.8",
     "typescript": "^5.9.0 || ^6.0.0 || ^7.0.0"
   },
   "engines": {