@promster/undici 15.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 suǝʞǝǝpʇ
+
+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,7 @@
+<p align="center">
+  <b style="font-size: 25px">⏰ Promster - Measure undici pool stats with Prometheus 🚦</b>
+</p>
+
+### `@promster/undici`
+
+This repository is part of the `promster` mono repository. Please head [here](https://github.com/tdeekens/promster) for more information.

package/dist/declarations/src/index.d.ts

@@ -0,0 +1 @@
+export { createPoolMetricsExporter, observedPools } from "./pool-metrics.js";

package/dist/declarations/src/pool-metrics.d.ts

@@ -0,0 +1,16 @@
+import type { Pool } from 'undici';
+type TPoolsMetricsExporterOptions = {
+    metricPrefix?: string;
+};
+export declare class ObservedPools {
+    private pools;
+    constructor(initialPools?: Record<string, Pool>);
+    add(origin: string, pool: Pool): void;
+    addMany(pools: Record<string, Pool>): void;
+    remove(origin: string): boolean;
+    get(origin: string): Pool | undefined;
+    [Symbol.iterator](): IterableIterator<[string, Pool]>;
+}
+declare const observedPools: ObservedPools;
+declare function createPoolMetricsExporter(pools: Record<string, Pool>, options?: TPoolsMetricsExporterOptions): void;
+export { createPoolMetricsExporter, observedPools, type TPoolsMetricsExporterOptions, };

package/dist/promster-undici.cjs.d.ts

@@ -0,0 +1,2 @@
+export * from "./declarations/src/index.js";
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJvbXN0ZXItdW5kaWNpLmNqcy5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi9kZWNsYXJhdGlvbnMvc3JjL2luZGV4LmQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEifQ==

package/dist/promster-undici.cjs.dev.js

@@ -0,0 +1,64 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var metrics = require('@promster/metrics');
+
+// Define the stats we want to expose from undici Pool.stats
+// See: https://github.com/nodejs/undici/blob/main/docs/docs/api/PoolStats.md
+
+class ObservedPools {
+  constructor(initialPools) {
+    this.pools = new Map();
+    if (initialPools) {
+      this.addMany(initialPools);
+    }
+  }
+  add(origin, pool) {
+    this.pools.set(origin, pool);
+  }
+  addMany(pools) {
+    for (const [origin, pool] of Object.entries(pools)) {
+      this.add(origin, pool);
+    }
+  }
+  remove(origin) {
+    return this.pools.delete(origin);
+  }
+  get(origin) {
+    return this.pools.get(origin);
+  }
+  [Symbol.iterator]() {
+    return this.pools.entries();
+  }
+}
+const observedPools = new ObservedPools();
+function createPoolMetricsExporter(pools, options) {
+  var _options$metricPrefix;
+  const metricName = `${(_options$metricPrefix = options === null || options === void 0 ? void 0 : options.metricPrefix) !== null && _options$metricPrefix !== void 0 ? _options$metricPrefix : ''}nodejs_undici_pool_stats`;
+  observedPools.addMany(pools);
+  new metrics.Prometheus.Gauge({
+    name: metricName,
+    help: 'Statistics for Undici connection pools. See https://github.com/nodejs/undici/blob/main/docs/docs/api/PoolStats.md',
+    labelNames: ['origin', 'stat_name'],
+    registers: [metrics.defaultRegister],
+    collect() {
+      for (const [origin, pool] of observedPools) {
+        const stats = pool.stats;
+
+        // If the pool has made no requests, it will not have stats
+        if (!stats) {
+          continue;
+        }
+        for (const [statName, value] of Object.entries(stats)) {
+          if (typeof value === 'number' && !Number.isNaN(value)) {
+            this.labels(origin, statName).set(value);
+          }
+        }
+      }
+    }
+  });
+}
+
+exports.createPoolMetricsExporter = createPoolMetricsExporter;
+exports.observedPools = observedPools;

package/dist/promster-undici.cjs.js

@@ -0,0 +1,7 @@
+'use strict';
+
+if (process.env.NODE_ENV === "production") {
+  module.exports = require("./promster-undici.cjs.prod.js");
+} else {
+  module.exports = require("./promster-undici.cjs.dev.js");
+}

package/dist/promster-undici.cjs.prod.js

@@ -0,0 +1,64 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var metrics = require('@promster/metrics');
+
+// Define the stats we want to expose from undici Pool.stats
+// See: https://github.com/nodejs/undici/blob/main/docs/docs/api/PoolStats.md
+
+class ObservedPools {
+  constructor(initialPools) {
+    this.pools = new Map();
+    if (initialPools) {
+      this.addMany(initialPools);
+    }
+  }
+  add(origin, pool) {
+    this.pools.set(origin, pool);
+  }
+  addMany(pools) {
+    for (const [origin, pool] of Object.entries(pools)) {
+      this.add(origin, pool);
+    }
+  }
+  remove(origin) {
+    return this.pools.delete(origin);
+  }
+  get(origin) {
+    return this.pools.get(origin);
+  }
+  [Symbol.iterator]() {
+    return this.pools.entries();
+  }
+}
+const observedPools = new ObservedPools();
+function createPoolMetricsExporter(pools, options) {
+  var _options$metricPrefix;
+  const metricName = `${(_options$metricPrefix = options === null || options === void 0 ? void 0 : options.metricPrefix) !== null && _options$metricPrefix !== void 0 ? _options$metricPrefix : ''}nodejs_undici_pool_stats`;
+  observedPools.addMany(pools);
+  new metrics.Prometheus.Gauge({
+    name: metricName,
+    help: 'Statistics for Undici connection pools. See https://github.com/nodejs/undici/blob/main/docs/docs/api/PoolStats.md',
+    labelNames: ['origin', 'stat_name'],
+    registers: [metrics.defaultRegister],
+    collect() {
+      for (const [origin, pool] of observedPools) {
+        const stats = pool.stats;
+
+        // If the pool has made no requests, it will not have stats
+        if (!stats) {
+          continue;
+        }
+        for (const [statName, value] of Object.entries(stats)) {
+          if (typeof value === 'number' && !Number.isNaN(value)) {
+            this.labels(origin, statName).set(value);
+          }
+        }
+      }
+    }
+  });
+}
+
+exports.createPoolMetricsExporter = createPoolMetricsExporter;
+exports.observedPools = observedPools;

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@promster/undici",
+  "version": "15.0.0",
+  "description": "Undici server integrations of promster",
+  "main": "dist/promster-undici.cjs.js",
+  "typings": "dist/promster-undici.cjs.d.ts",
+  "types": "dist/promster-undici.cjs.d.ts",
+  "files": [
+    "readme.md",
+    "package.json",
+    "LICENSE",
+    "dist/**",
+    "modules/**"
+  ],
+  "engines": {
+    "node": ">=20",
+    "pnpm": ">=8"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/tdeekens/promster.git",
+    "directory": "packages/undici"
+  },
+  "author": "Tobias Deekens <nerd@tdeekens.name>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/tdeekens/promster/issues"
+  },
+  "homepage": "https://github.com/tdeekens/promster#readme",
+  "keywords": [
+    "metrics",
+    "continousdelivery",
+    "prometheus",
+    "undici"
+  ],
+  "dependencies": {
+    "merge-options": "3.0.4",
+    "tslib": "2.6.3",
+    "@promster/metrics": "15.0.0",
+    "@promster/types": "15.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "20.16.13",
+    "prom-client": "15.1.3",
+    "typescript": "5.7.3",
+    "parse-prometheus-text-format": "1.1.1",
+    "undici": "7.7.0",
+    "express": "4.21.2",
+    "@promster/server": "15.0.0",
+    "@promster/express": "15.0.0"
+  },
+  "peerDependencies": {
+    "prom-client": "13.x.x || 14.x || 15.x",
+    "undici": "7.x.x"
+  }
+}