@promster/metrics 15.5.1 → 15.6.0

package/dist/index.d.ts

@@ -0,0 +1,154 @@
+import * as Prometheus from "prom-client";
+import { Counter, CounterConfiguration, Gauge, GaugeConfiguration, Histogram, HistogramConfiguration, Summary, SummaryConfiguration } from "prom-client";
+import { TDefaultedPromsterOptions, TGcMetrics, TGraphQlMetrics, THttpMetrics, TLabelValues, TOptionalPromsterOptions } from "@promster/types";
+export type * from "@promster/types";
+//#region src/client/client.d.ts
+declare const defaultRegister: Prometheus.Registry<"text/plain; version=0.0.4; charset=utf-8">;
+//#endregion
+//#region src/create-gc-metrics/create-gc-metrics.d.ts
+declare const defaultOptions$3: {
+  getLabelValues: () => {};
+  labels: never[];
+  metricPrefix: string;
+  metricNames: {
+    up: string[];
+  };
+  gcCollectionInterval: number;
+};
+declare function createGcMetrics(options: TDefaultedPromsterOptions): TGcMetrics;
+declare namespace createGcMetrics {
+  export { defaultOptions$3 as defaultOptions };
+}
+//#endregion
+//#region src/create-gc-observer/create-gc-observer.d.ts
+declare const createGcObserver: (_metrics: TGcMetrics, options: TDefaultedPromsterOptions) => () => void;
+//#endregion
+//#region src/create-graphql-metrics/create-graphql-metrics.d.ts
+declare const defaultOptions$2: {
+  getLabelValues: () => {};
+  labels: never[];
+  metricPrefix: string;
+  metricTypes: string[];
+  metricNames: {
+    graphQlParseDuration: string[];
+    graphQlValidationDuration: string[];
+    graphQlResolveFieldDuration: string[];
+    graphQlRequestDuration: string[];
+    graphQlErrorsTotal: string[];
+  };
+  metricPercentiles: {
+    graphQlParseDuration: number[];
+    graphQlValidationDuration: number[];
+    graphQlResolveFieldDuration: number[];
+    graphQlRequestDuration: number[];
+    graphQlErrorsTotal: number[];
+  };
+};
+declare function createGraphQlMetrics(options: TDefaultedPromsterOptions): TGraphQlMetrics;
+declare namespace createGraphQlMetrics {
+  export { defaultOptions$2 as defaultOptions };
+}
+//#endregion
+//#region src/create-http-metrics/create-http-metrics.d.ts
+declare const defaultOptions$1: {
+  getLabelValues: () => {};
+  labels: never[];
+  metricPrefix: string;
+  metricTypes: string[];
+  metricNames: {
+    httpRequestsTotal: string[];
+    httpRequestDurationPerPercentileInSeconds: string[];
+    httpRequestDurationInSeconds: string[];
+    httpRequestContentLengthInBytes: string[];
+    httpResponseContentLengthInBytes: string[];
+  };
+  metricBuckets: {
+    httpRequestContentLengthInBytes: number[];
+    httpRequestDurationInSeconds: number[];
+  };
+  metricPercentiles: {
+    httpRequestDurationPerPercentileInSeconds: number[];
+    httpResponseContentLengthInBytes: number[];
+  };
+};
+declare function createHttpMetrics(options: TDefaultedPromsterOptions): THttpMetrics;
+declare namespace createHttpMetrics {
+  export { defaultOptions$1 as defaultOptions };
+}
+//#endregion
+//#region src/create-metric/create-metric.d.ts
+declare const createHistogram: (configuration: HistogramConfiguration<string>) => Histogram<string>;
+declare const createCounter: (configuration: CounterConfiguration<string>) => Counter<string>;
+declare const createGauge: (configuration: GaugeConfiguration<string>) => Gauge<string>;
+declare const createSummary: (configuration: SummaryConfiguration<string>) => Summary<string>;
+//#endregion
+//#region src/end-measurement-from/end-measurement-from.d.ts
+declare function endMeasurementFrom(start: [number, number]): {
+  durationS: number;
+};
+//#endregion
+//#region src/sort-labels/sort-labels.d.ts
+declare function sortLabels(unsortedLabels: TLabelValues): TLabelValues;
+//#endregion
+//#region src/timing/timing.d.ts
+declare class Timing {
+  #private;
+  static NS_PER_SEC: bigint;
+  constructor();
+  value(): {
+    seconds: undefined;
+  } | {
+    seconds: number;
+  };
+  reset(): this;
+  end(): this;
+}
+declare const timing: {
+  start(): Timing;
+};
+//#endregion
+//#region src/create-request-recorder/create-request-recorder.d.ts
+type TRecordingOptions = {
+  labels: TLabelValues;
+  requestContentLength?: number;
+  responseContentLength?: number;
+};
+type TLegacyTiming = [number, number];
+type TRequestRecorder = (_timing: Timing | TLegacyTiming, _recordingOptions: TRecordingOptions) => void;
+declare const defaultOptions: TOptionalPromsterOptions;
+declare function createRequestRecorder(metrics: THttpMetrics, options?: TOptionalPromsterOptions): TRequestRecorder;
+declare namespace createRequestRecorder {
+  export { defaultOptions };
+}
+//#endregion
+//#region src/environment/kubernetes.d.ts
+declare const isRunningInKubernetes: () => boolean;
+//#endregion
+//#region src/environment/skip-metrics-in-environment.d.ts
+type TSkipMetricsInEnvironmentOptions = {
+  detectKubernetes?: TOptionalPromsterOptions['detectKubernetes'];
+};
+declare const skipMetricsInEnvironment: (options: TSkipMetricsInEnvironmentOptions) => boolean;
+//#endregion
+//#region src/normalizers/method/method.d.ts
+declare const normalizeMethod: (method: string) => string;
+//#endregion
+//#region src/normalizers/path/path.d.ts
+declare const normalizePath: (path: string) => string;
+//#endregion
+//#region src/normalizers/status-code/status-code.d.ts
+declare const normalizeStatusCode: (statusCode: number) => number;
+//#endregion
+//#region src/normalizers/index.d.ts
+declare const defaultNormalizers: {
+  normalizeStatusCode: typeof normalizeStatusCode;
+  normalizePath: typeof normalizePath;
+  normalizeMethod: typeof normalizeMethod;
+};
+//#endregion
+//#region src/summary/summary.d.ts
+declare const getSummary: () => Promise<string>;
+declare const getContentType: () => "text/plain; version=0.0.4; charset=utf-8";
+//#endregion
+export { Prometheus, type Timing as TPromsterTiming, type TRequestRecorder, createCounter, createGauge, createGcMetrics, createGcObserver, createGraphQlMetrics, createHistogram, createHttpMetrics, createRequestRecorder, createSummary, defaultNormalizers, defaultRegister, endMeasurementFrom, getContentType, getSummary, isRunningInKubernetes, normalizeMethod, normalizePath, normalizeStatusCode, skipMetricsInEnvironment, sortLabels, timing };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,358 @@
+import { once } from "es-toolkit/function";
+import * as Prometheus from "prom-client";
+import merge from "merge-options";
+import { gcStats } from "@chainsafe/prometheus-gc-stats";
+import url from "node:url";
+import UrlValueParser from "url-value-parser";
+//#region src/environment/kubernetes.ts
+const isRunningInKubernetes = () => Boolean(process.env.KUBERNETES_SERVICE_HOST);
+//#endregion
+//#region src/environment/skip-metrics-in-environment.ts
+const skipMetricsInEnvironment = (options) => options.detectKubernetes === true && !isRunningInKubernetes();
+//#endregion
+//#region src/client/client.ts
+const defaultRegister = Prometheus.register;
+const configure = once((options) => {
+	if (!skipMetricsInEnvironment(options)) Prometheus.collectDefaultMetrics(options);
+});
+//#endregion
+//#region src/create-metric/create-metric.ts
+const createHistogram = (configuration) => {
+	const existingMetric = defaultRegister.getSingleMetric(configuration.name);
+	if (existingMetric instanceof Prometheus.Histogram) return existingMetric;
+	return new Prometheus.Histogram(configuration);
+};
+const createCounter = (configuration) => {
+	const existingMetric = defaultRegister.getSingleMetric(configuration.name);
+	if (existingMetric instanceof Prometheus.Counter) return existingMetric;
+	return new Prometheus.Counter(configuration);
+};
+const createGauge = (configuration) => {
+	const existingMetric = defaultRegister.getSingleMetric(configuration.name);
+	if (existingMetric instanceof Prometheus.Gauge) return existingMetric;
+	return new Prometheus.Gauge(configuration);
+};
+const createSummary = (configuration) => {
+	const existingMetric = defaultRegister.getSingleMetric(configuration.name);
+	if (existingMetric instanceof Prometheus.Summary) return existingMetric;
+	return new Prometheus.Summary(configuration);
+};
+//#endregion
+//#region src/create-gc-metrics/create-gc-metrics.ts
+const asArray$2 = (maybeArray) => Array.isArray(maybeArray) ? maybeArray : [maybeArray];
+const defaultOptions$4 = {
+	getLabelValues: () => ({}),
+	labels: [],
+	metricPrefix: "",
+	metricNames: { up: ["nodejs_up"] },
+	gcCollectionInterval: 6e3
+};
+const getMetrics$2 = (options) => ({ up: asArray$2(options.metricNames.up).map((nameOfUpMetric) => createGauge({
+	name: `${options.metricPrefix}${nameOfUpMetric}`,
+	help: "1 = nodejs server is up, 0 = nodejs server is not up"
+})) });
+const createGcMetrics = (options) => {
+	const defaultedOptions = merge(defaultOptions$4, options);
+	configure({ prefix: defaultedOptions.metricPrefix });
+	return getMetrics$2(defaultedOptions);
+};
+createGcMetrics.defaultOptions = defaultOptions$4;
+//#endregion
+//#region src/create-gc-observer/create-gc-observer.ts
+const defaultOptions$3 = { disableGcMetrics: false };
+const createGcObserver = once((_metrics, options) => () => {
+	gcStats(defaultRegister, {
+		collectionInterval: options.gcCollectionInterval,
+		prefix: options.metricPrefix
+	});
+});
+createGcObserver.defaultOptions = defaultOptions$3;
+//#endregion
+//#region src/create-graphql-metrics/create-graphql-metrics.ts
+const defaultGraphQlPercentiles = [
+	.5,
+	.9,
+	.95,
+	.98,
+	.99
+];
+const defaultLabels$1 = ["operation_name"];
+const asArray$1 = (maybeArray) => Array.isArray(maybeArray) ? maybeArray : [maybeArray];
+const shouldObserveGraphQlParseDurationAsHistogram = (options) => options.metricTypes.includes("graphQlParseDurationHistogram");
+const shouldObserveGraphQlValidationDurationAsHistogram = (options) => options.metricTypes.includes("graphQlValidationDurationHistogram");
+const shouldObserveGraphQlResolveFieldDurationAsHistogram = (options) => options.metricTypes.includes("graphQlResolveFieldDurationHistogram");
+const shouldObserveGraphQlRequestDurationAsHistogram = (options) => options.metricTypes.includes("graphQlRequestDurationHistogram");
+const shouldObserveGraphQlErrorsTotalAsCounter = (options) => options.metricTypes.includes("graphQlErrorsTotal");
+const defaultOptions$2 = {
+	getLabelValues: () => ({}),
+	labels: [],
+	metricPrefix: "",
+	metricTypes: [
+		"graphQlParseDurationHistogram",
+		"graphQlValidationDurationHistogram",
+		"graphQlResolveFieldDurationHistogram",
+		"graphQlRequestDurationHistogram",
+		"graphQlErrorsTotal"
+	],
+	metricNames: {
+		graphQlParseDuration: ["graphql_parse_duration_seconds"],
+		graphQlValidationDuration: ["graphql_validation_duration_seconds"],
+		graphQlResolveFieldDuration: ["graphql_resolve_field_duration_seconds"],
+		graphQlRequestDuration: ["graphql_request_duration_seconds"],
+		graphQlErrorsTotal: ["graphql_errors_total"]
+	},
+	metricPercentiles: {
+		graphQlParseDuration: defaultGraphQlPercentiles,
+		graphQlValidationDuration: defaultGraphQlPercentiles,
+		graphQlResolveFieldDuration: defaultGraphQlPercentiles,
+		graphQlRequestDuration: defaultGraphQlPercentiles,
+		graphQlErrorsTotal: defaultGraphQlPercentiles
+	}
+};
+const getMetrics$1 = (options) => ({
+	graphQlParseDuration: shouldObserveGraphQlParseDurationAsHistogram(options) ? asArray$1(options.metricNames.graphQlParseDuration).map((nameOfGraphQlParseDuration) => createHistogram({
+		name: `${options.metricPrefix}${nameOfGraphQlParseDuration}`,
+		help: "The GraphQL request parse time in seconds.",
+		labelNames: defaultLabels$1.concat(options.labels).toSorted(),
+		buckets: options.metricPercentiles?.graphQlParseDuration || defaultGraphQlPercentiles
+	})) : void 0,
+	graphQlValidationDuration: shouldObserveGraphQlValidationDurationAsHistogram(options) ? asArray$1(options.metricNames.graphQlValidationDuration).map((nameOfGraphQlValidationDuration) => createHistogram({
+		name: `${options.metricPrefix}${nameOfGraphQlValidationDuration}`,
+		help: "The GraphQL request validation time in seconds.",
+		labelNames: defaultLabels$1.concat(options.labels).toSorted(),
+		buckets: options.metricPercentiles?.graphQlValidationDuration || defaultGraphQlPercentiles
+	})) : void 0,
+	graphQlResolveFieldDuration: shouldObserveGraphQlResolveFieldDurationAsHistogram(options) ? asArray$1(options.metricNames.graphQlResolveFieldDuration).map((nameOfGraphQlResolveFieldDuration) => createHistogram({
+		name: `${options.metricPrefix}${nameOfGraphQlResolveFieldDuration}`,
+		help: "The GraphQL field resolving time in seconds.",
+		labelNames: defaultLabels$1.concat(["field_name"]).concat(options.labels).toSorted(),
+		buckets: options.metricPercentiles?.graphQlResolveFieldDuration || defaultGraphQlPercentiles
+	})) : void 0,
+	graphQlRequestDuration: shouldObserveGraphQlRequestDurationAsHistogram(options) ? asArray$1(options.metricNames.graphQlRequestDuration).map((nameOfGraphQlRequestDuration) => createHistogram({
+		name: `${options.metricPrefix}${nameOfGraphQlRequestDuration}`,
+		help: "The GraphQL request duration time in seconds.",
+		labelNames: defaultLabels$1.concat(options.labels).toSorted(),
+		buckets: options.metricPercentiles?.graphQlRequestDuration || defaultGraphQlPercentiles
+	})) : void 0,
+	graphQlErrorsTotal: shouldObserveGraphQlErrorsTotalAsCounter(options) ? asArray$1(options.metricNames.graphQlErrorsTotal).map((nameOfGraphQlErrorsCount) => createCounter({
+		name: `${options.metricPrefix}${nameOfGraphQlErrorsCount}`,
+		help: "Count of errors while parsing, validating, or executing a GraphQL operation.",
+		labelNames: defaultLabels$1.concat(["phase"]).concat(options.labels).toSorted()
+	})) : void 0
+});
+const createGraphQlMetrics = (options) => {
+	const defaultedOptions = merge(defaultOptions$2, options);
+	configure({ prefix: defaultedOptions.metricPrefix });
+	return getMetrics$1(defaultedOptions);
+};
+createGraphQlMetrics.defaultOptions = defaultOptions$2;
+//#endregion
+//#region src/create-http-metrics/create-http-metrics.ts
+const defaultHttpRequestDurationPercentileInSeconds = [
+	.5,
+	.9,
+	.95,
+	.98,
+	.99
+];
+const defaultHttpRequestDurationInSeconds = [
+	.05,
+	.1,
+	.3,
+	.5,
+	.8,
+	1,
+	1.5,
+	2,
+	3,
+	10
+];
+const defaultHttpContentLengthInBytes = [
+	1e5,
+	2e5,
+	5e5,
+	1e6,
+	15e5,
+	2e6,
+	3e6,
+	5e6,
+	1e7
+];
+const defaultLabels = [
+	"path",
+	"status_code",
+	"method"
+];
+const asArray = (maybeArray) => Array.isArray(maybeArray) ? maybeArray : [maybeArray];
+const shouldObserveHttpRequestsAsSummary = (options) => options.metricTypes.includes("httpRequestsSummary");
+const shouldObserveHttpRequestsAsHistogram = (options) => options.metricTypes.includes("httpRequestsHistogram");
+const shouldObserveHttpRequestsAsCounter = (options) => options.metricTypes.includes("httpRequestsTotal");
+const shouldObserveHttpContentLengthAsHistogram = (options) => options.metricTypes.includes("httpContentLengthHistogram");
+const defaultOptions$1 = {
+	getLabelValues: () => ({}),
+	labels: [],
+	metricPrefix: "",
+	metricTypes: ["httpRequestsTotal", "httpRequestsHistogram"],
+	metricNames: {
+		httpRequestsTotal: ["http_requests_total"],
+		httpRequestDurationPerPercentileInSeconds: ["http_request_duration_per_percentile_seconds"],
+		httpRequestDurationInSeconds: ["http_request_duration_seconds"],
+		httpRequestContentLengthInBytes: ["http_request_content_length_bytes"],
+		httpResponseContentLengthInBytes: ["http_response_content_length_bytes"]
+	},
+	metricBuckets: {
+		httpRequestContentLengthInBytes: defaultHttpContentLengthInBytes,
+		httpRequestDurationInSeconds: defaultHttpRequestDurationInSeconds
+	},
+	metricPercentiles: {
+		httpRequestDurationPerPercentileInSeconds: defaultHttpRequestDurationPercentileInSeconds,
+		httpResponseContentLengthInBytes: defaultHttpContentLengthInBytes
+	}
+};
+const getMetrics = (options) => ({
+	httpRequestContentLengthInBytes: shouldObserveHttpContentLengthAsHistogram(options) ? asArray(options.metricNames.httpRequestContentLengthInBytes).map((nameOfHttpContentLengthMetric) => createHistogram({
+		name: `${options.metricPrefix}${nameOfHttpContentLengthMetric}`,
+		help: "The HTTP request content length in bytes.",
+		labelNames: defaultLabels.concat(options.labels).toSorted(),
+		buckets: options.metricBuckets?.httpRequestContentLengthInBytes || defaultHttpContentLengthInBytes
+	})) : void 0,
+	httpResponseContentLengthInBytes: shouldObserveHttpContentLengthAsHistogram(options) ? asArray(options.metricNames.httpResponseContentLengthInBytes).map((nameOfHttpContentLengthMetric) => createHistogram({
+		name: `${options.metricPrefix}${nameOfHttpContentLengthMetric}`,
+		help: "The HTTP response content length in bytes.",
+		labelNames: defaultLabels.concat(options.labels).toSorted(),
+		buckets: options.metricBuckets?.httpResponseContentLengthInBytes || defaultHttpContentLengthInBytes
+	})) : void 0
+});
+const getHttpRequestLatencyMetricsInSeconds = (options) => ({
+	httpRequestDurationPerPercentileInSeconds: shouldObserveHttpRequestsAsSummary(options) ? asArray(options.metricNames.httpRequestDurationPerPercentileInSeconds).map((nameOfHttpRequestDurationPerPercentileInSeconds) => createSummary({
+		name: `${options.metricPrefix}${nameOfHttpRequestDurationPerPercentileInSeconds}`,
+		help: "The HTTP request latencies in seconds.",
+		labelNames: defaultLabels.concat(options.labels).toSorted(),
+		percentiles: options.metricPercentiles?.httpRequestDurationPerPercentileInSeconds || defaultHttpRequestDurationPercentileInSeconds
+	})) : void 0,
+	httpRequestDurationInSeconds: shouldObserveHttpRequestsAsHistogram(options) ? asArray(options.metricNames.httpRequestDurationInSeconds).map((nameOfHttpRequestDurationInSecondsMetric) => createHistogram({
+		name: `${options.metricPrefix}${nameOfHttpRequestDurationInSecondsMetric}`,
+		help: "The HTTP request latencies in seconds.",
+		labelNames: defaultLabels.concat(options.labels).toSorted(),
+		buckets: options.metricBuckets?.httpRequestDurationInSeconds || defaultHttpRequestDurationInSeconds
+	})) : void 0
+});
+const getHttpRequestCounterMetric = (options) => ({ httpRequestsTotal: shouldObserveHttpRequestsAsCounter(options) ? asArray(options.metricNames.httpRequestsTotal).map((nameOfHttpRequestsTotalMetric) => createCounter({
+	name: `${options.metricPrefix}${nameOfHttpRequestsTotalMetric}`,
+	help: "The total HTTP requests.",
+	labelNames: defaultLabels.concat(options.labels).toSorted()
+})) : void 0 });
+const createHttpMetrics = (options) => {
+	const defaultedOptions = merge(defaultOptions$1, options);
+	configure({ prefix: defaultedOptions.metricPrefix });
+	const metrics = getMetrics(defaultedOptions);
+	const httpRequestLatencyMetricsInSeconds = getHttpRequestLatencyMetricsInSeconds(defaultedOptions);
+	const httpRequestCounterMetric = getHttpRequestCounterMetric(defaultedOptions);
+	return Object.assign({}, metrics, httpRequestLatencyMetricsInSeconds, httpRequestCounterMetric);
+};
+createHttpMetrics.defaultOptions = defaultOptions$1;
+//#endregion
+//#region src/end-measurement-from/end-measurement-from.ts
+const NS_PER_SEC = 1e9;
+function endMeasurementFrom(start) {
+	const [seconds, nanoseconds] = process.hrtime(start);
+	return { durationS: (seconds * NS_PER_SEC + nanoseconds) / NS_PER_SEC };
+}
+//#endregion
+//#region src/sort-labels/sort-labels.ts
+function sortLabels(unsortedLabels) {
+	return Object.keys(unsortedLabels).toSorted((a, b) => {
+		if (a < b) return -1;
+		if (a > b) return 1;
+		return 0;
+	}).reduce((sortedLabels, labelName) => {
+		sortedLabels[labelName] = unsortedLabels[labelName];
+		return sortedLabels;
+	}, {});
+}
+//#endregion
+//#region src/create-request-recorder/create-request-recorder.ts
+const defaultOptions = { detectKubernetes: false };
+function isTiming(timing) {
+	return !Array.isArray(timing);
+}
+const createRequestRecorder = (metrics, options = defaultOptions) => {
+	const shouldSkipMetricsByEnvironment = skipMetricsInEnvironment(merge(defaultOptions, options));
+	return (timing, recordingOptions) => {
+		const durationS = isTiming(timing) ? timing.end().value().seconds : endMeasurementFrom(timing).durationS;
+		const labels = sortLabels(recordingOptions.labels);
+		if (!shouldSkipMetricsByEnvironment && durationS !== void 0) {
+			if (metrics.httpRequestDurationInSeconds) for (const httpRequestDurationInSecondsMetricType of metrics.httpRequestDurationInSeconds) httpRequestDurationInSecondsMetricType.observe(labels, durationS);
+		}
+		if (!shouldSkipMetricsByEnvironment && durationS !== void 0) {
+			if (metrics.httpRequestDurationPerPercentileInSeconds) for (const httpRequestDurationPerPercentileInSecondsMetricType of metrics.httpRequestDurationPerPercentileInSeconds) httpRequestDurationPerPercentileInSecondsMetricType.observe(labels, durationS);
+		}
+		if (!shouldSkipMetricsByEnvironment && durationS !== void 0) {
+			if (metrics.httpRequestsTotal) for (const httpRequestsTotalMetricType of metrics.httpRequestsTotal) httpRequestsTotalMetricType.inc(labels);
+		}
+		if (recordingOptions.requestContentLength) {
+			if (metrics.httpRequestContentLengthInBytes) for (const httpRequestContentLengthInBytesMetricType of metrics.httpRequestContentLengthInBytes) httpRequestContentLengthInBytesMetricType.observe(labels, recordingOptions.requestContentLength);
+		}
+		if (recordingOptions.responseContentLength) {
+			if (metrics.httpResponseContentLengthInBytes) for (const httpResponseContentLengthInBytesMetricType of metrics.httpResponseContentLengthInBytes) httpResponseContentLengthInBytesMetricType.observe(labels, recordingOptions.responseContentLength);
+		}
+	};
+};
+createRequestRecorder.defaultOptions = defaultOptions;
+//#endregion
+//#region src/normalizers/method/method.ts
+const normalizeMethod = (method) => method.toLowerCase();
+//#endregion
+//#region src/normalizers/path/path.ts
+const urlValueParser = new UrlValueParser();
+const normalizePath = (path) => {
+	const parsedPathname = url.parse(path).pathname;
+	if (!parsedPathname) return "";
+	return urlValueParser.replacePathValues(parsedPathname, "#val");
+};
+//#endregion
+//#region src/normalizers/status-code/status-code.ts
+const normalizeStatusCode = (statusCode) => statusCode;
+//#endregion
+//#region src/normalizers/index.ts
+const defaultNormalizers = {
+	normalizeStatusCode,
+	normalizePath,
+	normalizeMethod
+};
+//#endregion
+//#region src/summary/summary.ts
+const getSummary = async () => defaultRegister.metrics();
+const getContentType = () => defaultRegister.contentType;
+//#endregion
+//#region src/timing/timing.ts
+var Timing = class Timing {
+	static NS_PER_SEC = BigInt(1e9);
+	#startTime;
+	#endTime;
+	constructor() {
+		this.reset();
+	}
+	value() {
+		const startTime = this.#startTime;
+		const endTime = this.#endTime;
+		if (!endTime || !startTime) return { seconds: void 0 };
+		return { seconds: Number(endTime - startTime) / Number(Timing.NS_PER_SEC) };
+	}
+	reset() {
+		this.#startTime = process.hrtime.bigint();
+		this.#endTime = void 0;
+		return this;
+	}
+	end() {
+		this.#endTime = process.hrtime.bigint();
+		return this;
+	}
+};
+const timing = { start() {
+	return new Timing();
+} };
+//#endregion
+export { Prometheus, createCounter, createGauge, createGcMetrics, createGcObserver, createGraphQlMetrics, createHistogram, createHttpMetrics, createRequestRecorder, createSummary, defaultNormalizers, defaultRegister, endMeasurementFrom, getContentType, getSummary, isRunningInKubernetes, normalizeMethod, normalizePath, normalizeStatusCode, skipMetricsInEnvironment, sortLabels, timing };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["asArray","defaultOptions","getMetrics","defaultOptions","defaultLabels","asArray","defaultOptions","getMetrics","defaultOptions","#startTime","#endTime"],"sources":["../src/environment/kubernetes.ts","../src/environment/skip-metrics-in-environment.ts","../src/client/client.ts","../src/create-metric/create-metric.ts","../src/create-gc-metrics/create-gc-metrics.ts","../src/create-gc-observer/create-gc-observer.ts","../src/create-graphql-metrics/create-graphql-metrics.ts","../src/create-http-metrics/create-http-metrics.ts","../src/end-measurement-from/end-measurement-from.ts","../src/sort-labels/sort-labels.ts","../src/create-request-recorder/create-request-recorder.ts","../src/normalizers/method/method.ts","../src/normalizers/path/path.ts","../src/normalizers/status-code/status-code.ts","../src/normalizers/index.ts","../src/summary/summary.ts","../src/timing/timing.ts"],"sourcesContent":["const isRunningInKubernetes = () =>\n  Boolean(process.env.KUBERNETES_SERVICE_HOST);\n\nexport { isRunningInKubernetes };\n","import type { TOptionalPromsterOptions } from '@promster/types';\n\nimport { isRunningInKubernetes } from './kubernetes';\n\ntype TSkipMetricsInEnvironmentOptions = {\n  detectKubernetes?: TOptionalPromsterOptions['detectKubernetes'];\n};\n\nconst skipMetricsInEnvironment = (options: TSkipMetricsInEnvironmentOptions) =>\n  options.detectKubernetes === true && !isRunningInKubernetes();\n\nexport { skipMetricsInEnvironment };\n","import { once } from 'es-toolkit/function';\nimport type { PrometheusContentType } from 'prom-client';\nimport * as Prometheus from 'prom-client';\n\nimport { skipMetricsInEnvironment } from '../environment';\n\n// NOTE:\n//   This is the `globalRegistry` provided by the `prom-client`\n//   We could create multiple registries with `new Prometheus.registry()`.\nconst defaultRegister = Prometheus.register;\n\ninterface TClientOptions extends Prometheus.DefaultMetricsCollectorConfiguration<PrometheusContentType> {\n  detectKubernetes?: boolean;\n  prefix?: string;\n}\n\nconst configure = once((options: TClientOptions) => {\n  const shouldSkipMetricsInEnvironment = skipMetricsInEnvironment(options);\n\n  if (!shouldSkipMetricsInEnvironment) {\n    Prometheus.collectDefaultMetrics(options);\n  }\n});\n\nexport { Prometheus, defaultRegister, configure };\n","import type {\n  Counter,\n  CounterConfiguration,\n  Gauge,\n  GaugeConfiguration,\n  Histogram,\n  HistogramConfiguration,\n  Summary,\n  SummaryConfiguration,\n} from 'prom-client';\n\nimport { defaultRegister, Prometheus } from '../client';\n\n// NOTE:\n//   All metrics share the `prom-client` global registry (see `../client`).\n//   Registering a metric whose name already exists throws. This happens when\n//   a metric-defining module is evaluated more than once, for instance when a\n//   bundler or package manager ships duplicate physical copies of a package.\n//   These helpers make registration idempotent: an already registered metric\n//   of the same name and type is returned instead of re-created. The first\n//   registration wins, so a later differing configuration is ignored. A name\n//   already taken by a different metric type falls through to `prom-client`,\n//   which rejects it with the clear \"already registered\" error.\n\nconst createHistogram = (\n  configuration: HistogramConfiguration<string>,\n): Histogram<string> => {\n  const existingMetric = defaultRegister.getSingleMetric(configuration.name);\n\n  if (existingMetric instanceof Prometheus.Histogram) {\n    return existingMetric;\n  }\n\n  return new Prometheus.Histogram(configuration);\n};\n\nconst createCounter = (\n  configuration: CounterConfiguration<string>,\n): Counter<string> => {\n  const existingMetric = defaultRegister.getSingleMetric(configuration.name);\n\n  if (existingMetric instanceof Prometheus.Counter) {\n    return existingMetric;\n  }\n\n  return new Prometheus.Counter(configuration);\n};\n\nconst createGauge = (\n  configuration: GaugeConfiguration<string>,\n): Gauge<string> => {\n  const existingMetric = defaultRegister.getSingleMetric(configuration.name);\n\n  if (existingMetric instanceof Prometheus.Gauge) {\n    return existingMetric;\n  }\n\n  return new Prometheus.Gauge(configuration);\n};\n\nconst createSummary = (\n  configuration: SummaryConfiguration<string>,\n): Summary<string> => {\n  const existingMetric = defaultRegister.getSingleMetric(configuration.name);\n\n  if (existingMetric instanceof Prometheus.Summary) {\n    return existingMetric;\n  }\n\n  return new Prometheus.Summary(configuration);\n};\n\nexport { createCounter, createGauge, createHistogram, createSummary };\n","import type { TDefaultedPromsterOptions, TGcMetrics } from '@promster/types';\nimport merge from 'merge-options';\n\nimport { configure } from '../client';\nimport { createGauge } from '../create-metric';\n\nconst asArray = (maybeArray: Readonly<string[] | string>) =>\n  Array.isArray(maybeArray) ? maybeArray : [maybeArray];\n\nconst defaultOptions = {\n  getLabelValues: () => ({}),\n  labels: [],\n  metricPrefix: '',\n  metricNames: {\n    up: ['nodejs_up'],\n  },\n  gcCollectionInterval: 6000,\n};\n\nconst getMetrics = (options: TDefaultedPromsterOptions) => ({\n  up: asArray(options.metricNames.up).map((nameOfUpMetric: string) =>\n    createGauge({\n      name: `${options.metricPrefix}${nameOfUpMetric}`,\n      help: '1 = nodejs server is up, 0 = nodejs server is not up',\n    }),\n  ),\n});\n\nconst createGcMetrics = (options: TDefaultedPromsterOptions): TGcMetrics => {\n  const defaultedOptions: TDefaultedPromsterOptions = merge(\n    defaultOptions,\n    options,\n  );\n\n  configure({\n    prefix: defaultedOptions.metricPrefix,\n  });\n\n  const gcMetrics = getMetrics(defaultedOptions);\n\n  return gcMetrics;\n};\n\ncreateGcMetrics.defaultOptions = defaultOptions;\n\nexport { createGcMetrics };\n","import { gcStats } from '@chainsafe/prometheus-gc-stats';\nimport type { TDefaultedPromsterOptions, TGcMetrics } from '@promster/types';\nimport { once } from 'es-toolkit/function';\n\nimport { defaultRegister } from '../client/client';\n\nconst defaultOptions = {\n  disableGcMetrics: false,\n};\n\nconst createGcObserver = once(\n  (_metrics: TGcMetrics, options: TDefaultedPromsterOptions) => () => {\n    gcStats(defaultRegister, {\n      collectionInterval: options.gcCollectionInterval,\n      prefix: options.metricPrefix,\n    });\n  },\n);\n\n// @ts-expect-error\ncreateGcObserver.defaultOptions = defaultOptions;\n\nexport { createGcObserver };\n","import type {\n  TDefaultedPromsterOptions,\n  TGraphQlMetrics,\n} from '@promster/types';\nimport merge from 'merge-options';\n\nimport { configure } from '../client';\nimport { createCounter, createHistogram } from '../create-metric';\n\nconst defaultGraphQlPercentiles = [0.5, 0.9, 0.95, 0.98, 0.99];\n\nconst defaultLabels = ['operation_name'];\nconst asArray = (maybeArray: Readonly<string[] | string>) =>\n  Array.isArray(maybeArray) ? maybeArray : [maybeArray];\n\nconst shouldObserveGraphQlParseDurationAsHistogram = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('graphQlParseDurationHistogram');\nconst shouldObserveGraphQlValidationDurationAsHistogram = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('graphQlValidationDurationHistogram');\nconst shouldObserveGraphQlResolveFieldDurationAsHistogram = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('graphQlResolveFieldDurationHistogram');\nconst shouldObserveGraphQlRequestDurationAsHistogram = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('graphQlRequestDurationHistogram');\nconst shouldObserveGraphQlErrorsTotalAsCounter = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('graphQlErrorsTotal');\n\nconst defaultOptions = {\n  getLabelValues: () => ({}),\n  labels: [],\n  metricPrefix: '',\n  metricTypes: [\n    'graphQlParseDurationHistogram',\n    'graphQlValidationDurationHistogram',\n    'graphQlResolveFieldDurationHistogram',\n    'graphQlRequestDurationHistogram',\n    'graphQlErrorsTotal',\n  ],\n  metricNames: {\n    graphQlParseDuration: ['graphql_parse_duration_seconds'],\n    graphQlValidationDuration: ['graphql_validation_duration_seconds'],\n    graphQlResolveFieldDuration: ['graphql_resolve_field_duration_seconds'],\n    graphQlRequestDuration: ['graphql_request_duration_seconds'],\n    graphQlErrorsTotal: ['graphql_errors_total'],\n  },\n  metricPercentiles: {\n    graphQlParseDuration: defaultGraphQlPercentiles,\n    graphQlValidationDuration: defaultGraphQlPercentiles,\n    graphQlResolveFieldDuration: defaultGraphQlPercentiles,\n    graphQlRequestDuration: defaultGraphQlPercentiles,\n    graphQlErrorsTotal: defaultGraphQlPercentiles,\n  },\n};\n\nconst getMetrics = (options: TDefaultedPromsterOptions) => ({\n  graphQlParseDuration: shouldObserveGraphQlParseDurationAsHistogram(options)\n    ? asArray(options.metricNames.graphQlParseDuration).map(\n        (nameOfGraphQlParseDuration: string) =>\n          createHistogram({\n            name: `${options.metricPrefix}${nameOfGraphQlParseDuration}`,\n            help: 'The GraphQL request parse time in seconds.',\n            labelNames: defaultLabels.concat(options.labels).toSorted(),\n            buckets:\n              options.metricPercentiles?.graphQlParseDuration ||\n              defaultGraphQlPercentiles,\n          }),\n      )\n    : undefined,\n\n  graphQlValidationDuration: shouldObserveGraphQlValidationDurationAsHistogram(\n    options,\n  )\n    ? asArray(options.metricNames.graphQlValidationDuration).map(\n        (nameOfGraphQlValidationDuration: string) =>\n          createHistogram({\n            name: `${options.metricPrefix}${nameOfGraphQlValidationDuration}`,\n            help: 'The GraphQL request validation time in seconds.',\n            labelNames: defaultLabels.concat(options.labels).toSorted(),\n            buckets:\n              options.metricPercentiles?.graphQlValidationDuration ||\n              defaultGraphQlPercentiles,\n          }),\n      )\n    : undefined,\n\n  graphQlResolveFieldDuration:\n    shouldObserveGraphQlResolveFieldDurationAsHistogram(options)\n      ? asArray(options.metricNames.graphQlResolveFieldDuration).map(\n          (nameOfGraphQlResolveFieldDuration: string) =>\n            createHistogram({\n              name: `${options.metricPrefix}${nameOfGraphQlResolveFieldDuration}`,\n              help: 'The GraphQL field resolving time in seconds.',\n              labelNames: defaultLabels\n                .concat(['field_name'])\n                .concat(options.labels)\n                .toSorted(),\n              buckets:\n                options.metricPercentiles?.graphQlResolveFieldDuration ||\n                defaultGraphQlPercentiles,\n            }),\n        )\n      : undefined,\n\n  graphQlRequestDuration: shouldObserveGraphQlRequestDurationAsHistogram(\n    options,\n  )\n    ? asArray(options.metricNames.graphQlRequestDuration).map(\n        (nameOfGraphQlRequestDuration: string) =>\n          createHistogram({\n            name: `${options.metricPrefix}${nameOfGraphQlRequestDuration}`,\n            help: 'The GraphQL request duration time in seconds.',\n            labelNames: defaultLabels.concat(options.labels).toSorted(),\n            buckets:\n              options.metricPercentiles?.graphQlRequestDuration ||\n              defaultGraphQlPercentiles,\n          }),\n      )\n    : undefined,\n\n  graphQlErrorsTotal: shouldObserveGraphQlErrorsTotalAsCounter(options)\n    ? asArray(options.metricNames.graphQlErrorsTotal).map(\n        (nameOfGraphQlErrorsCount: string) =>\n          createCounter({\n            name: `${options.metricPrefix}${nameOfGraphQlErrorsCount}`,\n            help: 'Count of errors while parsing, validating, or executing a GraphQL operation.',\n            labelNames: defaultLabels\n              .concat(['phase'])\n              .concat(options.labels)\n              .toSorted(),\n          }),\n      )\n    : undefined,\n});\n\nconst createGraphQlMetrics = (\n  options: TDefaultedPromsterOptions,\n): TGraphQlMetrics => {\n  const defaultedOptions: TDefaultedPromsterOptions = merge(\n    defaultOptions,\n    options,\n  );\n\n  configure({\n    prefix: defaultedOptions.metricPrefix,\n  });\n\n  const metrics = getMetrics(defaultedOptions);\n\n  return metrics;\n};\n\ncreateGraphQlMetrics.defaultOptions = defaultOptions;\n\nexport { createGraphQlMetrics };\n","import type { TDefaultedPromsterOptions, THttpMetrics } from '@promster/types';\nimport merge from 'merge-options';\n\nimport { configure } from '../client';\nimport {\n  createCounter,\n  createHistogram,\n  createSummary,\n} from '../create-metric';\n\nconst defaultHttpRequestDurationPercentileInSeconds = [\n  0.5, 0.9, 0.95, 0.98, 0.99,\n];\nconst defaultHttpRequestDurationInSeconds = [\n  0.05, 0.1, 0.3, 0.5, 0.8, 1, 1.5, 2, 3, 10,\n];\nconst defaultHttpContentLengthInBytes = [\n  100000, 200000, 500000, 1000000, 1500000, 2000000, 3000000, 5000000, 10000000,\n];\n\nconst defaultLabels = ['path', 'status_code', 'method'];\nconst asArray = (maybeArray: Readonly<string[] | string>) =>\n  Array.isArray(maybeArray) ? maybeArray : [maybeArray];\n\nconst shouldObserveHttpRequestsAsSummary = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('httpRequestsSummary');\nconst shouldObserveHttpRequestsAsHistogram = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('httpRequestsHistogram');\nconst shouldObserveHttpRequestsAsCounter = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('httpRequestsTotal');\nconst shouldObserveHttpContentLengthAsHistogram = (\n  options: TDefaultedPromsterOptions,\n) => options.metricTypes.includes('httpContentLengthHistogram');\n\nconst defaultOptions = {\n  getLabelValues: () => ({}),\n  labels: [],\n  metricPrefix: '',\n  metricTypes: ['httpRequestsTotal', 'httpRequestsHistogram'],\n  metricNames: {\n    httpRequestsTotal: ['http_requests_total'],\n    httpRequestDurationPerPercentileInSeconds: [\n      'http_request_duration_per_percentile_seconds',\n    ],\n    httpRequestDurationInSeconds: ['http_request_duration_seconds'],\n    httpRequestContentLengthInBytes: ['http_request_content_length_bytes'],\n    httpResponseContentLengthInBytes: ['http_response_content_length_bytes'],\n  },\n  metricBuckets: {\n    httpRequestContentLengthInBytes: defaultHttpContentLengthInBytes,\n    httpRequestDurationInSeconds: defaultHttpRequestDurationInSeconds,\n  },\n  metricPercentiles: {\n    httpRequestDurationPerPercentileInSeconds:\n      defaultHttpRequestDurationPercentileInSeconds,\n    httpResponseContentLengthInBytes: defaultHttpContentLengthInBytes,\n  },\n};\n\nconst getMetrics = (options: TDefaultedPromsterOptions) => ({\n  httpRequestContentLengthInBytes: shouldObserveHttpContentLengthAsHistogram(\n    options,\n  )\n    ? asArray(options.metricNames.httpRequestContentLengthInBytes).map(\n        (nameOfHttpContentLengthMetric: string) =>\n          createHistogram({\n            name: `${options.metricPrefix}${nameOfHttpContentLengthMetric}`,\n            help: 'The HTTP request content length in bytes.',\n            labelNames: defaultLabels.concat(options.labels).toSorted(),\n            buckets:\n              options.metricBuckets?.httpRequestContentLengthInBytes ||\n              defaultHttpContentLengthInBytes,\n          }),\n      )\n    : undefined,\n\n  httpResponseContentLengthInBytes: shouldObserveHttpContentLengthAsHistogram(\n    options,\n  )\n    ? asArray(options.metricNames.httpResponseContentLengthInBytes).map(\n        (nameOfHttpContentLengthMetric: string) =>\n          createHistogram({\n            name: `${options.metricPrefix}${nameOfHttpContentLengthMetric}`,\n            help: 'The HTTP response content length in bytes.',\n            labelNames: defaultLabels.concat(options.labels).toSorted(),\n            buckets:\n              options.metricBuckets?.httpResponseContentLengthInBytes ||\n              defaultHttpContentLengthInBytes,\n          }),\n      )\n    : undefined,\n});\n\nconst getHttpRequestLatencyMetricsInSeconds = (\n  options: TDefaultedPromsterOptions,\n) => ({\n  httpRequestDurationPerPercentileInSeconds: shouldObserveHttpRequestsAsSummary(\n    options,\n  )\n    ? asArray(\n        options.metricNames.httpRequestDurationPerPercentileInSeconds,\n      ).map((nameOfHttpRequestDurationPerPercentileInSeconds: string) =>\n        createSummary({\n          name: `${options.metricPrefix}${nameOfHttpRequestDurationPerPercentileInSeconds}`,\n          help: 'The HTTP request latencies in seconds.',\n          labelNames: defaultLabels.concat(options.labels).toSorted(),\n          percentiles:\n            options.metricPercentiles\n              ?.httpRequestDurationPerPercentileInSeconds ||\n            defaultHttpRequestDurationPercentileInSeconds,\n        }),\n      )\n    : undefined,\n\n  httpRequestDurationInSeconds: shouldObserveHttpRequestsAsHistogram(options)\n    ? asArray(options.metricNames.httpRequestDurationInSeconds).map(\n        (nameOfHttpRequestDurationInSecondsMetric: string) =>\n          createHistogram({\n            name: `${options.metricPrefix}${nameOfHttpRequestDurationInSecondsMetric}`,\n            help: 'The HTTP request latencies in seconds.',\n            labelNames: defaultLabels.concat(options.labels).toSorted(),\n            buckets:\n              options.metricBuckets?.httpRequestDurationInSeconds ||\n              defaultHttpRequestDurationInSeconds,\n          }),\n      )\n    : undefined,\n});\n\nconst getHttpRequestCounterMetric = (options: TDefaultedPromsterOptions) => ({\n  httpRequestsTotal: shouldObserveHttpRequestsAsCounter(options)\n    ? asArray(options.metricNames.httpRequestsTotal).map(\n        (nameOfHttpRequestsTotalMetric: string) =>\n          createCounter({\n            name: `${options.metricPrefix}${nameOfHttpRequestsTotalMetric}`,\n            help: 'The total HTTP requests.',\n            labelNames: defaultLabels.concat(options.labels).toSorted(),\n          }),\n      )\n    : undefined,\n});\n\nconst createHttpMetrics = (\n  options: TDefaultedPromsterOptions,\n): THttpMetrics => {\n  const defaultedOptions: TDefaultedPromsterOptions = merge(\n    defaultOptions,\n    options,\n  );\n\n  configure({\n    prefix: defaultedOptions.metricPrefix,\n  });\n\n  const metrics = getMetrics(defaultedOptions);\n\n  const httpRequestLatencyMetricsInSeconds =\n    getHttpRequestLatencyMetricsInSeconds(defaultedOptions);\n  const httpRequestCounterMetric =\n    getHttpRequestCounterMetric(defaultedOptions);\n\n  return Object.assign(\n    {},\n    metrics,\n    httpRequestLatencyMetricsInSeconds,\n    httpRequestCounterMetric,\n  );\n};\n\ncreateHttpMetrics.defaultOptions = defaultOptions;\n\nexport { createHttpMetrics };\n","const NS_PER_SEC = 1e9;\n\nfunction endMeasurementFrom(start: [number, number]) {\n  const [seconds, nanoseconds] = process.hrtime(start);\n\n  return {\n    durationS: (seconds * NS_PER_SEC + nanoseconds) / NS_PER_SEC,\n  };\n}\n\nexport { endMeasurementFrom };\n","import type { TLabelValues } from '@promster/types';\n\nfunction sortLabels(unsortedLabels: TLabelValues): TLabelValues {\n  return Object.keys(unsortedLabels)\n    .toSorted((a, b) => {\n      if (a < b) {\n        return -1;\n      }\n\n      if (a > b) {\n        return 1;\n      }\n\n      return 0;\n    })\n    .reduce<TLabelValues>((sortedLabels, labelName) => {\n      sortedLabels[labelName] = unsortedLabels[labelName];\n      return sortedLabels;\n    }, {});\n}\n\nexport { sortLabels };\n","import type {\n  TDefaultedPromsterOptions,\n  THttpMetrics,\n  TLabelValues,\n  TOptionalPromsterOptions,\n} from '@promster/types';\nimport merge from 'merge-options';\n\nimport { endMeasurementFrom } from '../end-measurement-from';\nimport { skipMetricsInEnvironment } from '../environment';\nimport { sortLabels } from '../sort-labels';\nimport type { Timing } from '../timing';\n\ntype TRecordingOptions = {\n  labels: TLabelValues;\n  requestContentLength?: number;\n  responseContentLength?: number;\n};\n\ntype TLegacyTiming = [number, number];\nexport type TRequestRecorder = (\n  _timing: Timing | TLegacyTiming,\n  _recordingOptions: TRecordingOptions,\n) => void;\n\nconst defaultOptions: TOptionalPromsterOptions = {\n  detectKubernetes: false,\n};\n\nfunction isTiming(timing: Timing | TLegacyTiming): timing is Timing {\n  return !Array.isArray(timing);\n}\n\nconst createRequestRecorder = (\n  metrics: THttpMetrics,\n  options: TOptionalPromsterOptions = defaultOptions,\n): TRequestRecorder => {\n  const defaultedRecorderOptions: TDefaultedPromsterOptions = merge(\n    defaultOptions,\n    options,\n  );\n  const shouldSkipMetricsByEnvironment = skipMetricsInEnvironment(\n    defaultedRecorderOptions,\n  );\n\n  return (\n    timing: Timing | TLegacyTiming,\n    recordingOptions: TRecordingOptions,\n  ) => {\n    const durationS = isTiming(timing)\n      ? timing.end().value().seconds\n      : endMeasurementFrom(timing).durationS;\n\n    const labels = sortLabels(recordingOptions.labels);\n\n    if (!shouldSkipMetricsByEnvironment && durationS !== undefined) {\n      if (metrics.httpRequestDurationInSeconds) {\n        for (const httpRequestDurationInSecondsMetricType of metrics.httpRequestDurationInSeconds) {\n          httpRequestDurationInSecondsMetricType.observe(labels, durationS);\n        }\n      }\n    }\n\n    if (!shouldSkipMetricsByEnvironment && durationS !== undefined) {\n      if (metrics.httpRequestDurationPerPercentileInSeconds) {\n        for (const httpRequestDurationPerPercentileInSecondsMetricType of metrics.httpRequestDurationPerPercentileInSeconds) {\n          httpRequestDurationPerPercentileInSecondsMetricType.observe(\n            labels,\n            durationS,\n          );\n        }\n      }\n    }\n\n    if (!shouldSkipMetricsByEnvironment && durationS !== undefined) {\n      if (metrics.httpRequestsTotal) {\n        for (const httpRequestsTotalMetricType of metrics.httpRequestsTotal) {\n          httpRequestsTotalMetricType.inc(labels);\n        }\n      }\n    }\n\n    if (recordingOptions.requestContentLength) {\n      if (metrics.httpRequestContentLengthInBytes) {\n        for (const httpRequestContentLengthInBytesMetricType of metrics.httpRequestContentLengthInBytes) {\n          httpRequestContentLengthInBytesMetricType.observe(\n            labels,\n            recordingOptions.requestContentLength,\n          );\n        }\n      }\n    }\n\n    if (recordingOptions.responseContentLength) {\n      if (metrics.httpResponseContentLengthInBytes) {\n        for (const httpResponseContentLengthInBytesMetricType of metrics.httpResponseContentLengthInBytes) {\n          httpResponseContentLengthInBytesMetricType.observe(\n            labels,\n            recordingOptions.responseContentLength,\n          );\n        }\n      }\n    }\n  };\n};\n\ncreateRequestRecorder.defaultOptions = defaultOptions;\n\nexport { createRequestRecorder, sortLabels, endMeasurementFrom };\n","const normalizeMethod = (method: string): string => method.toLowerCase();\n\nexport { normalizeMethod };\n","import url from 'node:url';\n\nimport UrlValueParser from 'url-value-parser';\n\nconst urlValueParser = new UrlValueParser();\n\nconst normalizePath = (path: string): string => {\n  const parsedPathname = url.parse(path).pathname;\n\n  if (!parsedPathname) {\n    return '';\n  }\n\n  return urlValueParser.replacePathValues(parsedPathname, '#val');\n};\n\nexport { normalizePath };\n","const normalizeStatusCode = (statusCode: number): number => statusCode;\n\nexport { normalizeStatusCode };\n","import { normalizeMethod } from './method';\nimport { normalizePath } from './path';\nimport { normalizeStatusCode } from './status-code';\n\nconst defaultNormalizers = {\n  normalizeStatusCode,\n  normalizePath,\n  normalizeMethod,\n};\n\nexport {\n  normalizeStatusCode,\n  normalizePath,\n  normalizeMethod,\n  defaultNormalizers,\n};\n","import { defaultRegister } from '../client';\n\nconst getSummary = async () => defaultRegister.metrics();\nconst getContentType = () => defaultRegister.contentType;\n\nexport { getSummary, getContentType };\n","class Timing {\n  static NS_PER_SEC = BigInt(1e9);\n\n  #startTime?: bigint;\n  #endTime?: bigint;\n\n  constructor() {\n    this.reset();\n  }\n\n  value() {\n    const startTime = this.#startTime;\n    const endTime = this.#endTime;\n\n    if (!endTime || !startTime) {\n      return { seconds: undefined };\n    }\n\n    return { seconds: Number(endTime - startTime) / Number(Timing.NS_PER_SEC) };\n  }\n\n  reset() {\n    this.#startTime = process.hrtime.bigint();\n    this.#endTime = undefined;\n\n    return this;\n  }\n\n  end() {\n    this.#endTime = process.hrtime.bigint();\n\n    return this;\n  }\n}\n\nconst timing = {\n  start() {\n    return new Timing();\n  },\n};\n\nexport default timing;\nexport { Timing };\n"],"mappings":";;;;;;;AAAA,MAAM,8BACJ,QAAQ,QAAQ,IAAI,uBAAuB;;;ACO7C,MAAM,4BAA4B,YAChC,QAAQ,qBAAqB,QAAQ,CAAC,sBAAsB;;;ACA9D,MAAM,kBAAkB,WAAW;AAOnC,MAAM,YAAY,MAAM,YAA4B;CAGlD,IAAI,CAFmC,yBAAyB,OAE9B,GAChC,WAAW,sBAAsB,OAAO;AAE5C,CAAC;;;ACED,MAAM,mBACJ,kBACsB;CACtB,MAAM,iBAAiB,gBAAgB,gBAAgB,cAAc,IAAI;CAEzE,IAAI,0BAA0B,WAAW,WACvC,OAAO;CAGT,OAAO,IAAI,WAAW,UAAU,aAAa;AAC/C;AAEA,MAAM,iBACJ,kBACoB;CACpB,MAAM,iBAAiB,gBAAgB,gBAAgB,cAAc,IAAI;CAEzE,IAAI,0BAA0B,WAAW,SACvC,OAAO;CAGT,OAAO,IAAI,WAAW,QAAQ,aAAa;AAC7C;AAEA,MAAM,eACJ,kBACkB;CAClB,MAAM,iBAAiB,gBAAgB,gBAAgB,cAAc,IAAI;CAEzE,IAAI,0BAA0B,WAAW,OACvC,OAAO;CAGT,OAAO,IAAI,WAAW,MAAM,aAAa;AAC3C;AAEA,MAAM,iBACJ,kBACoB;CACpB,MAAM,iBAAiB,gBAAgB,gBAAgB,cAAc,IAAI;CAEzE,IAAI,0BAA0B,WAAW,SACvC,OAAO;CAGT,OAAO,IAAI,WAAW,QAAQ,aAAa;AAC7C;;;AChEA,MAAMA,aAAW,eACf,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC,UAAU;AAEtD,MAAMC,mBAAiB;CACrB,uBAAuB,CAAC;CACxB,QAAQ,CAAC;CACT,cAAc;CACd,aAAa,EACX,IAAI,CAAC,WAAW,EAClB;CACA,sBAAsB;AACxB;AAEA,MAAMC,gBAAc,aAAwC,EAC1D,IAAIF,UAAQ,QAAQ,YAAY,EAAE,CAAC,CAAC,KAAK,mBACvC,YAAY;CACV,MAAM,GAAG,QAAQ,eAAe;CAChC,MAAM;AACR,CAAC,CACH,EACF;AAEA,MAAM,mBAAmB,YAAmD;CAC1E,MAAM,mBAA8C,MAClDC,kBACA,OACF;CAEA,UAAU,EACR,QAAQ,iBAAiB,aAC3B,CAAC;CAID,OAFkBC,aAAW,gBAEd;AACjB;AAEA,gBAAgB,iBAAiBD;;;ACrCjC,MAAME,mBAAiB,EACrB,kBAAkB,MACpB;AAEA,MAAM,mBAAmB,MACtB,UAAsB,kBAA6C;CAClE,QAAQ,iBAAiB;EACvB,oBAAoB,QAAQ;EAC5B,QAAQ,QAAQ;CAClB,CAAC;AACH,CACF;AAGA,iBAAiB,iBAAiBA;;;ACXlC,MAAM,4BAA4B;CAAC;CAAK;CAAK;CAAM;CAAM;AAAI;AAE7D,MAAMC,kBAAgB,CAAC,gBAAgB;AACvC,MAAMC,aAAW,eACf,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC,UAAU;AAEtD,MAAM,gDACJ,YACG,QAAQ,YAAY,SAAS,+BAA+B;AACjE,MAAM,qDACJ,YACG,QAAQ,YAAY,SAAS,oCAAoC;AACtE,MAAM,uDACJ,YACG,QAAQ,YAAY,SAAS,sCAAsC;AACxE,MAAM,kDACJ,YACG,QAAQ,YAAY,SAAS,iCAAiC;AACnE,MAAM,4CACJ,YACG,QAAQ,YAAY,SAAS,oBAAoB;AAEtD,MAAMC,mBAAiB;CACrB,uBAAuB,CAAC;CACxB,QAAQ,CAAC;CACT,cAAc;CACd,aAAa;EACX;EACA;EACA;EACA;EACA;CACF;CACA,aAAa;EACX,sBAAsB,CAAC,gCAAgC;EACvD,2BAA2B,CAAC,qCAAqC;EACjE,6BAA6B,CAAC,wCAAwC;EACtE,wBAAwB,CAAC,kCAAkC;EAC3D,oBAAoB,CAAC,sBAAsB;CAC7C;CACA,mBAAmB;EACjB,sBAAsB;EACtB,2BAA2B;EAC3B,6BAA6B;EAC7B,wBAAwB;EACxB,oBAAoB;CACtB;AACF;AAEA,MAAMC,gBAAc,aAAwC;CAC1D,sBAAsB,6CAA6C,OAAO,IACtEF,UAAQ,QAAQ,YAAY,oBAAoB,CAAC,CAAC,KAC/C,+BACC,gBAAgB;EACd,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAYD,gBAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;EAC1D,SACE,QAAQ,mBAAmB,wBAC3B;CACJ,CAAC,CACL,IACA,KAAA;CAEJ,2BAA2B,kDACzB,OACF,IACIC,UAAQ,QAAQ,YAAY,yBAAyB,CAAC,CAAC,KACpD,oCACC,gBAAgB;EACd,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAYD,gBAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;EAC1D,SACE,QAAQ,mBAAmB,6BAC3B;CACJ,CAAC,CACL,IACA,KAAA;CAEJ,6BACE,oDAAoD,OAAO,IACvDC,UAAQ,QAAQ,YAAY,2BAA2B,CAAC,CAAC,KACtD,sCACC,gBAAgB;EACd,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAYD,gBACT,OAAO,CAAC,YAAY,CAAC,CAAC,CACtB,OAAO,QAAQ,MAAM,CAAC,CACtB,SAAS;EACZ,SACE,QAAQ,mBAAmB,+BAC3B;CACJ,CAAC,CACL,IACA,KAAA;CAEN,wBAAwB,+CACtB,OACF,IACIC,UAAQ,QAAQ,YAAY,sBAAsB,CAAC,CAAC,KACjD,iCACC,gBAAgB;EACd,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAYD,gBAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;EAC1D,SACE,QAAQ,mBAAmB,0BAC3B;CACJ,CAAC,CACL,IACA,KAAA;CAEJ,oBAAoB,yCAAyC,OAAO,IAChEC,UAAQ,QAAQ,YAAY,kBAAkB,CAAC,CAAC,KAC7C,6BACC,cAAc;EACZ,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAYD,gBACT,OAAO,CAAC,OAAO,CAAC,CAAC,CACjB,OAAO,QAAQ,MAAM,CAAC,CACtB,SAAS;CACd,CAAC,CACL,IACA,KAAA;AACN;AAEA,MAAM,wBACJ,YACoB;CACpB,MAAM,mBAA8C,MAClDE,kBACA,OACF;CAEA,UAAU,EACR,QAAQ,iBAAiB,aAC3B,CAAC;CAID,OAFgBC,aAAW,gBAEd;AACf;AAEA,qBAAqB,iBAAiBD;;;ACjJtC,MAAM,gDAAgD;CACpD;CAAK;CAAK;CAAM;CAAM;AACxB;AACA,MAAM,sCAAsC;CAC1C;CAAM;CAAK;CAAK;CAAK;CAAK;CAAG;CAAK;CAAG;CAAG;AAC1C;AACA,MAAM,kCAAkC;CACtC;CAAQ;CAAQ;CAAQ;CAAS;CAAS;CAAS;CAAS;CAAS;AACvE;AAEA,MAAM,gBAAgB;CAAC;CAAQ;CAAe;AAAQ;AACtD,MAAM,WAAW,eACf,MAAM,QAAQ,UAAU,IAAI,aAAa,CAAC,UAAU;AAEtD,MAAM,sCACJ,YACG,QAAQ,YAAY,SAAS,qBAAqB;AACvD,MAAM,wCACJ,YACG,QAAQ,YAAY,SAAS,uBAAuB;AACzD,MAAM,sCACJ,YACG,QAAQ,YAAY,SAAS,mBAAmB;AACrD,MAAM,6CACJ,YACG,QAAQ,YAAY,SAAS,4BAA4B;AAE9D,MAAME,mBAAiB;CACrB,uBAAuB,CAAC;CACxB,QAAQ,CAAC;CACT,cAAc;CACd,aAAa,CAAC,qBAAqB,uBAAuB;CAC1D,aAAa;EACX,mBAAmB,CAAC,qBAAqB;EACzC,2CAA2C,CACzC,8CACF;EACA,8BAA8B,CAAC,+BAA+B;EAC9D,iCAAiC,CAAC,mCAAmC;EACrE,kCAAkC,CAAC,oCAAoC;CACzE;CACA,eAAe;EACb,iCAAiC;EACjC,8BAA8B;CAChC;CACA,mBAAmB;EACjB,2CACE;EACF,kCAAkC;CACpC;AACF;AAEA,MAAM,cAAc,aAAwC;CAC1D,iCAAiC,0CAC/B,OACF,IACI,QAAQ,QAAQ,YAAY,+BAA+B,CAAC,CAAC,KAC1D,kCACC,gBAAgB;EACd,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAY,cAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;EAC1D,SACE,QAAQ,eAAe,mCACvB;CACJ,CAAC,CACL,IACA,KAAA;CAEJ,kCAAkC,0CAChC,OACF,IACI,QAAQ,QAAQ,YAAY,gCAAgC,CAAC,CAAC,KAC3D,kCACC,gBAAgB;EACd,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAY,cAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;EAC1D,SACE,QAAQ,eAAe,oCACvB;CACJ,CAAC,CACL,IACA,KAAA;AACN;AAEA,MAAM,yCACJ,aACI;CACJ,2CAA2C,mCACzC,OACF,IACI,QACE,QAAQ,YAAY,yCACtB,CAAC,CAAC,KAAK,oDACL,cAAc;EACZ,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAY,cAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;EAC1D,aACE,QAAQ,mBACJ,6CACJ;CACJ,CAAC,CACH,IACA,KAAA;CAEJ,8BAA8B,qCAAqC,OAAO,IACtE,QAAQ,QAAQ,YAAY,4BAA4B,CAAC,CAAC,KACvD,6CACC,gBAAgB;EACd,MAAM,GAAG,QAAQ,eAAe;EAChC,MAAM;EACN,YAAY,cAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;EAC1D,SACE,QAAQ,eAAe,gCACvB;CACJ,CAAC,CACL,IACA,KAAA;AACN;AAEA,MAAM,+BAA+B,aAAwC,EAC3E,mBAAmB,mCAAmC,OAAO,IACzD,QAAQ,QAAQ,YAAY,iBAAiB,CAAC,CAAC,KAC5C,kCACC,cAAc;CACZ,MAAM,GAAG,QAAQ,eAAe;CAChC,MAAM;CACN,YAAY,cAAc,OAAO,QAAQ,MAAM,CAAC,CAAC,SAAS;AAC5D,CAAC,CACL,IACA,KAAA,EACN;AAEA,MAAM,qBACJ,YACiB;CACjB,MAAM,mBAA8C,MAClDA,kBACA,OACF;CAEA,UAAU,EACR,QAAQ,iBAAiB,aAC3B,CAAC;CAED,MAAM,UAAU,WAAW,gBAAgB;CAE3C,MAAM,qCACJ,sCAAsC,gBAAgB;CACxD,MAAM,2BACJ,4BAA4B,gBAAgB;CAE9C,OAAO,OAAO,OACZ,CAAC,GACD,SACA,oCACA,wBACF;AACF;AAEA,kBAAkB,iBAAiBA;;;AC5KnC,MAAM,aAAa;AAEnB,SAAS,mBAAmB,OAAyB;CACnD,MAAM,CAAC,SAAS,eAAe,QAAQ,OAAO,KAAK;CAEnD,OAAO,EACL,YAAY,UAAU,aAAa,eAAe,WACpD;AACF;;;ACNA,SAAS,WAAW,gBAA4C;CAC9D,OAAO,OAAO,KAAK,cAAc,CAAC,CAC/B,UAAU,GAAG,MAAM;EAClB,IAAI,IAAI,GACN,OAAO;EAGT,IAAI,IAAI,GACN,OAAO;EAGT,OAAO;CACT,CAAC,CAAC,CACD,QAAsB,cAAc,cAAc;EACjD,aAAa,aAAa,eAAe;EACzC,OAAO;CACT,GAAG,CAAC,CAAC;AACT;;;ACMA,MAAM,iBAA2C,EAC/C,kBAAkB,MACpB;AAEA,SAAS,SAAS,QAAkD;CAClE,OAAO,CAAC,MAAM,QAAQ,MAAM;AAC9B;AAEA,MAAM,yBACJ,SACA,UAAoC,mBACf;CAKrB,MAAM,iCAAiC,yBAJqB,MAC1D,gBACA,OAGuB,CACzB;CAEA,QACE,QACA,qBACG;EACH,MAAM,YAAY,SAAS,MAAM,IAC7B,OAAO,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,UACrB,mBAAmB,MAAM,CAAC,CAAC;EAE/B,MAAM,SAAS,WAAW,iBAAiB,MAAM;EAEjD,IAAI,CAAC,kCAAkC,cAAc,KAAA;OAC/C,QAAQ,8BACV,KAAK,MAAM,0CAA0C,QAAQ,8BAC3D,uCAAuC,QAAQ,QAAQ,SAAS;EAAA;EAKtE,IAAI,CAAC,kCAAkC,cAAc,KAAA;OAC/C,QAAQ,2CACV,KAAK,MAAM,uDAAuD,QAAQ,2CACxE,oDAAoD,QAClD,QACA,SACF;EAAA;EAKN,IAAI,CAAC,kCAAkC,cAAc,KAAA;OAC/C,QAAQ,mBACV,KAAK,MAAM,+BAA+B,QAAQ,mBAChD,4BAA4B,IAAI,MAAM;EAAA;EAK5C,IAAI,iBAAiB;OACf,QAAQ,iCACV,KAAK,MAAM,6CAA6C,QAAQ,iCAC9D,0CAA0C,QACxC,QACA,iBAAiB,oBACnB;EAAA;EAKN,IAAI,iBAAiB;OACf,QAAQ,kCACV,KAAK,MAAM,8CAA8C,QAAQ,kCAC/D,2CAA2C,QACzC,QACA,iBAAiB,qBACnB;EAAA;CAIR;AACF;AAEA,sBAAsB,iBAAiB;;;AC1GvC,MAAM,mBAAmB,WAA2B,OAAO,YAAY;;;ACIvE,MAAM,iBAAiB,IAAI,eAAe;AAE1C,MAAM,iBAAiB,SAAyB;CAC9C,MAAM,iBAAiB,IAAI,MAAM,IAAI,CAAC,CAAC;CAEvC,IAAI,CAAC,gBACH,OAAO;CAGT,OAAO,eAAe,kBAAkB,gBAAgB,MAAM;AAChE;;;ACdA,MAAM,uBAAuB,eAA+B;;;ACI5D,MAAM,qBAAqB;CACzB;CACA;CACA;AACF;;;ACNA,MAAM,aAAa,YAAY,gBAAgB,QAAQ;AACvD,MAAM,uBAAuB,gBAAgB;;;ACH7C,IAAM,SAAN,MAAM,OAAO;CACX,OAAO,aAAa,OAAO,GAAG;CAE9B;CACA;CAEA,cAAc;EACZ,KAAK,MAAM;CACb;CAEA,QAAQ;EACN,MAAM,YAAY,KAAKC;EACvB,MAAM,UAAU,KAAKC;EAErB,IAAI,CAAC,WAAW,CAAC,WACf,OAAO,EAAE,SAAS,KAAA,EAAU;EAG9B,OAAO,EAAE,SAAS,OAAO,UAAU,SAAS,IAAI,OAAO,OAAO,UAAU,EAAE;CAC5E;CAEA,QAAQ;EACN,KAAKD,aAAa,QAAQ,OAAO,OAAO;EACxC,KAAKC,WAAW,KAAA;EAEhB,OAAO;CACT;CAEA,MAAM;EACJ,KAAKA,WAAW,QAAQ,OAAO,OAAO;EAEtC,OAAO;CACT;AACF;AAEA,MAAM,SAAS,EACb,QAAQ;CACN,OAAO,IAAI,OAAO;AACpB,EACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@promster/metrics",
-  "version": "15.5.1",
+  "version": "15.6.0",
   "description": "Metrics utilities used by all other server integrations",
   "keywords": [
     "continousdelivery",
@@ -22,27 +22,42 @@
     "readme.md",
     "package.json",
     "LICENSE",
-    "dist/**",
-    "modules/**"
+    "dist/**"
   ],
-  "main": "dist/promster-metrics.cjs.js",
-  "types": "dist/promster-metrics.cjs.d.ts",
-  "typings": "dist/promster-metrics.cjs.d.ts",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
     "@chainsafe/prometheus-gc-stats": "1.0.2",
-    "es-toolkit": "1.46.1",
+    "es-toolkit": "1.49.0",
     "merge-options": "3.0.4",
     "tslib": "2.8.1",
     "url-value-parser": "2.2.0"
   },
   "devDependencies": {
-    "@types/node": "24.12.2",
+    "@types/node": "24.13.3",
     "prom-client": "15.1.3",
-    "typescript": "6.0.3",
-    "@promster/types": "15.5.1"
+    "tsdown": "0.22.7",
+    "typescript": "7.0.2",
+    "@promster/tsconfig": "15.6.0",
+    "@promster/tsdown-config": "15.6.0",
+    "@promster/types": "15.6.0"
   },
   "peerDependencies": {
     "prom-client": "13.x.x || 14.x || 15.x"
@@ -50,5 +65,12 @@
   "engines": {
     "node": ">=20",
     "npm": ">=8"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "check-types": "tsc --noEmit",
+    "test": "vitest --run",
+    "test:watch": "vitest",
+    "dev": "tsdown --watch"
   }
 }