pi-crew 0.2.3 → 0.2.5

package/src/observability/exporters/adapter.ts

@@ -1,30 +1,30 @@
-import type { MetricSnapshot } from "../metrics-primitives.ts";
-
-export interface MetricExporter {
-	name: string;
-	push(snapshots: MetricSnapshot[]): Promise<void>;
-	dispose(): void;
-}
-
-export class CompositeExporter implements MetricExporter {
-	name = "composite";
-	private readonly exporters: MetricExporter[];
-
-	constructor(exporters: MetricExporter[]) {
-		this.exporters = exporters;
-	}
-
-	async push(snapshots: MetricSnapshot[]): Promise<void> {
-		await Promise.allSettled(this.exporters.map((exporter) => exporter.push(snapshots)));
-	}
-
-	dispose(): void {
-		for (const exporter of this.exporters) {
-			try {
-				exporter.dispose();
-			} catch {
-				// Best-effort cleanup; one exporter failing shouldn't prevent others.
-			}
-		}
-	}
-}
+import type { MetricSnapshot } from "../metrics-primitives.ts";
+
+export interface MetricExporter {
+	name: string;
+	push(snapshots: MetricSnapshot[]): Promise<void>;
+	dispose(): void;
+}
+
+export class CompositeExporter implements MetricExporter {
+	name = "composite";
+	private readonly exporters: MetricExporter[];
+
+	constructor(exporters: MetricExporter[]) {
+		this.exporters = exporters;
+	}
+
+	async push(snapshots: MetricSnapshot[]): Promise<void> {
+		await Promise.allSettled(this.exporters.map((exporter) => exporter.push(snapshots)));
+	}
+
+	dispose(): void {
+		for (const exporter of this.exporters) {
+			try {
+				exporter.dispose();
+			} catch {
+				// Best-effort cleanup; one exporter failing shouldn't prevent others.
+			}
+		}
+	}
+}

package/src/observability/exporters/otlp-exporter.ts

@@ -1,92 +1,106 @@
-import { logInternalError } from "../../utils/internal-error.ts";
-import { redactSecrets } from "../../utils/redaction.ts";
-import type { MetricRegistry } from "../metric-registry.ts";
-import type { MetricSnapshot } from "../metrics-primitives.ts";
-import type { MetricExporter } from "./adapter.ts";
-
-export interface OTLPExporterOptions {
-	endpoint: string;
-	headers?: Record<string, string>;
-	intervalMs?: number;
-	timeoutMs?: number;
-}
-
-function pointValues(snapshot: MetricSnapshot): unknown[] {
-	const MAX_LABEL_LENGTH = 256;
-	if (snapshot.type === "histogram") {
-		return snapshot.values.map((value) => ({
-			attributes: Object.entries(value.labels).map(([key, item]) => {
-				const redacted = redactSecrets({ [key]: item }) as Record<string, string>;
-				const val = String(redacted[key] ?? item);
-				return { key, value: { stringValue: val.length > MAX_LABEL_LENGTH ? val.slice(0, MAX_LABEL_LENGTH) : val } };
-			}),
-			count: "count" in value ? value.count : undefined,
-			sum: "sum" in value ? value.sum : undefined,
-			bucketCounts: "counts" in value ? value.counts : undefined,
-			explicitBounds: "buckets" in value ? value.buckets : undefined,
-		}));
-	}
-	return snapshot.values.map((value) => ({
-		attributes: Object.entries(value.labels).map(([key, item]) => {
-			const redacted = redactSecrets({ [key]: item }) as Record<string, string>;
-			const val = String(redacted[key] ?? item);
-			return { key, value: { stringValue: val.length > MAX_LABEL_LENGTH ? val.slice(0, MAX_LABEL_LENGTH) : val } };
-		}),
-		asDouble: "value" in value ? value.value : undefined,
-		count: "count" in value ? value.count : undefined,
-		sum: "sum" in value ? value.sum : undefined,
-	}));
-}
-
-export function convertToOTLP(snapshots: MetricSnapshot[]): unknown {
-	return {
-		resourceMetrics: [{
-			resource: { attributes: [{ key: "service.name", value: { stringValue: "pi-crew" } }] },
-			scopeMetrics: [{
-				scope: { name: "pi-crew" },
-				metrics: snapshots.map((snapshot) => ({ name: snapshot.name, description: snapshot.description, [snapshot.type === "histogram" ? "histogram" : snapshot.type === "gauge" ? "gauge" : "sum"]: { dataPoints: pointValues(snapshot) } })),
-			}],
-		}],
-	};
-}
-
-export class OTLPExporter implements MetricExporter {
-	name = "otlp";
-	private timer?: ReturnType<typeof setInterval>;
-	private readonly opts: OTLPExporterOptions;
-	private readonly registry: MetricRegistry;
-
-	constructor(opts: OTLPExporterOptions, registry: MetricRegistry) {
-		this.opts = opts;
-		this.registry = registry;
-	}
-
-	start(): void {
-		this.dispose();
-		this.timer = setInterval(() => { void this.push(this.registry.snapshot()); }, this.opts.intervalMs ?? 60_000);
-		this.timer.unref();
-	}
-
-	async push(snapshots: MetricSnapshot[]): Promise<void> {
-		try {
-			const timeoutMs = this.opts.timeoutMs ?? 10_000;
-			const controller = new AbortController();
-			const timer = setTimeout(() => controller.abort(), timeoutMs);
-			try {
-				const response = await fetch(this.opts.endpoint, { method: "POST", headers: { "content-type": "application/json", ...(this.opts.headers ?? {}) }, body: JSON.stringify(convertToOTLP(snapshots)), signal: controller.signal });
-				if (!response.ok) {
-					logInternalError("otlp-export-http", new Error(`HTTP ${response.status}: ${response.statusText}`), `endpoint=${this.opts.endpoint}`);
-				}
-			} finally {
-				clearTimeout(timer);
-			}
-		} catch (error) {
-			logInternalError("otlp-export", error);
-		}
-	}
-
-	dispose(): void {
-		if (this.timer) clearInterval(this.timer);
-		this.timer = undefined;
-	}
-}
+import { gzip } from "node:zlib";
+import { promisify } from "node:util";
+import { logInternalError } from "../../utils/internal-error.ts";
+import { redactSecrets } from "../../utils/redaction.ts";
+import type { MetricRegistry } from "../metric-registry.ts";
+import type { MetricSnapshot } from "../metrics-primitives.ts";
+import type { MetricExporter } from "./adapter.ts";
+
+const gzipAsync = promisify(gzip);
+
+export interface OTLPExporterOptions {
+	endpoint: string;
+	headers?: Record<string, string>;
+	intervalMs?: number;
+	timeoutMs?: number;
+}
+
+function pointValues(snapshot: MetricSnapshot): unknown[] {
+	const MAX_LABEL_LENGTH = 256;
+	if (snapshot.type === "histogram") {
+		return snapshot.values.map((value) => ({
+			attributes: Object.entries(value.labels).map(([key, item]) => {
+				const redacted = redactSecrets({ [key]: item }) as Record<string, string>;
+				const val = String(redacted[key] ?? item);
+				return { key, value: { stringValue: val.length > MAX_LABEL_LENGTH ? val.slice(0, MAX_LABEL_LENGTH) : val } };
+			}),
+			count: "count" in value ? value.count : undefined,
+			sum: "sum" in value ? value.sum : undefined,
+			bucketCounts: "counts" in value ? value.counts : undefined,
+			explicitBounds: "buckets" in value ? value.buckets : undefined,
+		}));
+	}
+	return snapshot.values.map((value) => ({
+		attributes: Object.entries(value.labels).map(([key, item]) => {
+			const redacted = redactSecrets({ [key]: item }) as Record<string, string>;
+			const val = String(redacted[key] ?? item);
+			return { key, value: { stringValue: val.length > MAX_LABEL_LENGTH ? val.slice(0, MAX_LABEL_LENGTH) : val } };
+		}),
+		asDouble: "value" in value ? value.value : undefined,
+		count: "count" in value ? value.count : undefined,
+		sum: "sum" in value ? value.sum : undefined,
+	}));
+}
+
+export function convertToOTLP(snapshots: MetricSnapshot[]): unknown {
+	return {
+		resourceMetrics: [{
+			resource: { attributes: [{ key: "service.name", value: { stringValue: "pi-crew" } }] },
+			scopeMetrics: [{
+				scope: { name: "pi-crew" },
+				metrics: snapshots.map((snapshot) => ({ name: snapshot.name, description: snapshot.description, [snapshot.type === "histogram" ? "histogram" : snapshot.type === "gauge" ? "gauge" : "sum"]: { dataPoints: pointValues(snapshot) } })),
+			}],
+		}],
+	};
+}
+
+export class OTLPExporter implements MetricExporter {
+	name = "otlp";
+	private timer?: ReturnType<typeof setInterval>;
+	private readonly opts: OTLPExporterOptions;
+	private readonly registry: MetricRegistry;
+
+	constructor(opts: OTLPExporterOptions, registry: MetricRegistry) {
+		this.opts = opts;
+		this.registry = registry;
+	}
+
+	start(): void {
+		this.dispose();
+		this.timer = setInterval(() => { void this.push(this.registry.snapshot()); }, this.opts.intervalMs ?? 60_000);
+		this.timer.unref();
+	}
+
+	async push(snapshots: MetricSnapshot[]): Promise<void> {
+		try {
+			const timeoutMs = this.opts.timeoutMs ?? 10_000;
+			const controller = new AbortController();
+			const timer = setTimeout(() => controller.abort(), timeoutMs);
+			try {
+				// 4.2: gzip body. OTLP HTTP exporters of every flavour accept
+				// `content-encoding: gzip`; collectors expect uncompressed JSON
+				// otherwise. Saves bandwidth on metric-heavy runs (often 3-5x).
+				const json = JSON.stringify(convertToOTLP(snapshots));
+				const body = await gzipAsync(Buffer.from(json));
+				const response = await fetch(this.opts.endpoint, {
+					method: "POST",
+					headers: { "content-type": "application/json", "content-encoding": "gzip", ...(this.opts.headers ?? {}) },
+					body,
+					signal: controller.signal,
+				});
+				if (!response.ok) {
+					logInternalError("otlp-export-http", new Error(`HTTP ${response.status}: ${response.statusText}`), `endpoint=${this.opts.endpoint}`);
+				}
+			} finally {
+				clearTimeout(timer);
+			}
+		} catch (error) {
+			logInternalError("otlp-export", error);
+		}
+	}
+
+	dispose(): void {
+		if (this.timer) clearInterval(this.timer);
+		this.timer = undefined;
+	}
+}

package/src/observability/exporters/prometheus-exporter.ts

@@ -1,54 +1,54 @@
-import type { HistogramPoint, MetricLabels, MetricPoint, MetricSnapshot } from "../metrics-primitives.ts";
-
-function prometheusName(name: string): string {
-	return name.replace(/[^a-zA-Z0-9_:]/g, "_").replace(/^[0-9]/, "_$&");
-}
-
-function escapeLabel(value: string): string {
-	return value.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/"/g, "\\\"");
-}
-
-function labelsText(labels: MetricLabels): string {
-	const entries = Object.entries(labels);
-	if (!entries.length) return "";
-	return `{${entries.map(([key, value]) => `${key}="${escapeLabel(String(value))}"`).join(",")}}`;
-}
-
-function metricType(type: MetricSnapshot["type"]): string {
-	return type === "histogram" ? "histogram" : type === "gauge" ? "gauge" : "counter";
-}
-
-function isHistogramPoint(value: MetricPoint | HistogramPoint): value is HistogramPoint {
-	return "buckets" in value && "counts" in value;
-}
-
-function formatPrometheusValue(num: number): string {
-	if (Number.isNaN(num)) return "Nan";
-	if (num === Number.POSITIVE_INFINITY) return "+Inf";
-	if (num === Number.NEGATIVE_INFINITY) return "-Inf";
-	return String(num);
-}
-
-export function formatPrometheus(snapshots: MetricSnapshot[]): string {
-	const lines: string[] = [];
-	for (const snapshot of snapshots) {
-		const name = prometheusName(snapshot.name);
-		lines.push(`# HELP ${name} ${snapshot.description}`);
-		lines.push(`# TYPE ${name} ${metricType(snapshot.type)}`);
-		for (const value of snapshot.values) {
-			if (isHistogramPoint(value)) {
-				let cumulative = 0;
-				for (let index = 0; index < value.buckets.length; index += 1) {
-					cumulative += value.counts[index] ?? 0;
-					const le = Number.isFinite(value.buckets[index]) ? String(value.buckets[index]) : "+Inf";
-					lines.push(`${name}_bucket${labelsText({ ...value.labels, le })} ${cumulative}`);
-				}
-				lines.push(`${name}_sum${labelsText(value.labels)} ${value.sum}`);
-				lines.push(`${name}_count${labelsText(value.labels)} ${value.count}`);
-			} else {
-				lines.push(`${name}${labelsText(value.labels)} ${formatPrometheusValue(value.value)}`);
-			}
-		}
-	}
-	return `${lines.join("\n")}\n`;
-}
+import type { HistogramPoint, MetricLabels, MetricPoint, MetricSnapshot } from "../metrics-primitives.ts";
+
+function prometheusName(name: string): string {
+	return name.replace(/[^a-zA-Z0-9_:]/g, "_").replace(/^[0-9]/, "_$&");
+}
+
+function escapeLabel(value: string): string {
+	return value.replace(/\\/g, "\\\\").replace(/\n/g, "\\n").replace(/"/g, "\\\"");
+}
+
+function labelsText(labels: MetricLabels): string {
+	const entries = Object.entries(labels);
+	if (!entries.length) return "";
+	return `{${entries.map(([key, value]) => `${key}="${escapeLabel(String(value))}"`).join(",")}}`;
+}
+
+function metricType(type: MetricSnapshot["type"]): string {
+	return type === "histogram" ? "histogram" : type === "gauge" ? "gauge" : "counter";
+}
+
+function isHistogramPoint(value: MetricPoint | HistogramPoint): value is HistogramPoint {
+	return "buckets" in value && "counts" in value;
+}
+
+function formatPrometheusValue(num: number): string {
+	if (Number.isNaN(num)) return "Nan";
+	if (num === Number.POSITIVE_INFINITY) return "+Inf";
+	if (num === Number.NEGATIVE_INFINITY) return "-Inf";
+	return String(num);
+}
+
+export function formatPrometheus(snapshots: MetricSnapshot[]): string {
+	const lines: string[] = [];
+	for (const snapshot of snapshots) {
+		const name = prometheusName(snapshot.name);
+		lines.push(`# HELP ${name} ${snapshot.description}`);
+		lines.push(`# TYPE ${name} ${metricType(snapshot.type)}`);
+		for (const value of snapshot.values) {
+			if (isHistogramPoint(value)) {
+				let cumulative = 0;
+				for (let index = 0; index < value.buckets.length; index += 1) {
+					cumulative += value.counts[index] ?? 0;
+					const le = Number.isFinite(value.buckets[index]) ? String(value.buckets[index]) : "+Inf";
+					lines.push(`${name}_bucket${labelsText({ ...value.labels, le })} ${cumulative}`);
+				}
+				lines.push(`${name}_sum${labelsText(value.labels)} ${value.sum}`);
+				lines.push(`${name}_count${labelsText(value.labels)} ${value.count}`);
+			} else {
+				lines.push(`${name}${labelsText(value.labels)} ${formatPrometheusValue(value.value)}`);
+			}
+		}
+	}
+	return `${lines.join("\n")}\n`;
+}

package/src/observability/metric-registry.ts

@@ -1,87 +1,87 @@
-import { Counter, Gauge, Histogram, type Metric, type MetricSnapshot } from "./metrics-primitives.ts";
-
-const METRIC_NAME_PATTERN = /^crew\.[a-z]+\.[a-z][a-z_]*$/;
-
-function assertMetricName(name: string): void {
-	if (!METRIC_NAME_PATTERN.test(name)) throw new Error(`Invalid metric name '${name}'. Expected crew.<domain>.<measure>.`);
-}
-
-export class MetricRegistry {
-	private metrics = new Map<string, Metric>();
-
-	registerCounter(name: string, description: string): Counter {
-		assertMetricName(name);
-		if (this.metrics.has(name)) throw new Error(`Metric '${name}' is already registered.`);
-		const metric = new Counter(name, description);
-		this.metrics.set(name, metric);
-		return metric;
-	}
-
-	registerGauge(name: string, description: string): Gauge {
-		assertMetricName(name);
-		if (this.metrics.has(name)) throw new Error(`Metric '${name}' is already registered.`);
-		const metric = new Gauge(name, description);
-		this.metrics.set(name, metric);
-		return metric;
-	}
-
-	registerHistogram(name: string, description: string, buckets?: number[]): Histogram {
-		assertMetricName(name);
-		if (this.metrics.has(name)) throw new Error(`Metric '${name}' is already registered.`);
-		const metric = new Histogram(name, description, buckets);
-		this.metrics.set(name, metric);
-		return metric;
-	}
-
-	counter(name: string, description: string): Counter {
-		const existing = this.metrics.get(name);
-		if (existing instanceof Counter) {
-			if (existing.description !== description) {
-				process.stderr.write(`[pi-crew] metric-registry: counter '${name}' description changed; using original: '${existing.description}'\n`);
-			}
-			return existing;
-		}
-		if (existing) throw new Error(`Metric '${name}' is not a counter.`);
-		return this.registerCounter(name, description);
-	}
-
-	gauge(name: string, description: string): Gauge {
-		const existing = this.metrics.get(name);
-		if (existing instanceof Gauge) {
-			if (existing.description !== description) {
-				process.stderr.write(`[pi-crew] metric-registry: gauge '${name}' description changed; using original: '${existing.description}'\n`);
-			}
-			return existing;
-		}
-		if (existing) throw new Error(`Metric '${name}' is not a gauge.`);
-		return this.registerGauge(name, description);
-	}
-
-	histogram(name: string, description: string, buckets?: number[]): Histogram {
-		const existing = this.metrics.get(name);
-		if (existing instanceof Histogram) {
-			if (existing.description !== description) {
-				process.stderr.write(`[pi-crew] metric-registry: histogram '${name}' description changed; using original: '${existing.description}'\n`);
-			}
-			return existing;
-		}
-		if (existing) throw new Error(`Metric '${name}' is not a histogram.`);
-		return this.registerHistogram(name, description, buckets);
-	}
-
-	get(name: string): Metric | undefined {
-		return this.metrics.get(name);
-	}
-
-	snapshot(): MetricSnapshot[] {
-		return [...this.metrics.values()].map((metric) => metric.snapshot());
-	}
-
-	dispose(): void {
-		this.metrics.clear();
-	}
-}
-
-export function createMetricRegistry(): MetricRegistry {
-	return new MetricRegistry();
-}
+import { Counter, Gauge, Histogram, type Metric, type MetricSnapshot } from "./metrics-primitives.ts";
+
+const METRIC_NAME_PATTERN = /^crew\.[a-z]+\.[a-z][a-z_]*$/;
+
+function assertMetricName(name: string): void {
+	if (!METRIC_NAME_PATTERN.test(name)) throw new Error(`Invalid metric name '${name}'. Expected crew.<domain>.<measure>.`);
+}
+
+export class MetricRegistry {
+	private metrics = new Map<string, Metric>();
+
+	registerCounter(name: string, description: string): Counter {
+		assertMetricName(name);
+		if (this.metrics.has(name)) throw new Error(`Metric '${name}' is already registered.`);
+		const metric = new Counter(name, description);
+		this.metrics.set(name, metric);
+		return metric;
+	}
+
+	registerGauge(name: string, description: string): Gauge {
+		assertMetricName(name);
+		if (this.metrics.has(name)) throw new Error(`Metric '${name}' is already registered.`);
+		const metric = new Gauge(name, description);
+		this.metrics.set(name, metric);
+		return metric;
+	}
+
+	registerHistogram(name: string, description: string, buckets?: number[]): Histogram {
+		assertMetricName(name);
+		if (this.metrics.has(name)) throw new Error(`Metric '${name}' is already registered.`);
+		const metric = new Histogram(name, description, buckets);
+		this.metrics.set(name, metric);
+		return metric;
+	}
+
+	counter(name: string, description: string): Counter {
+		const existing = this.metrics.get(name);
+		if (existing instanceof Counter) {
+			if (existing.description !== description) {
+				process.stderr.write(`[pi-crew] metric-registry: counter '${name}' description changed; using original: '${existing.description}'\n`);
+			}
+			return existing;
+		}
+		if (existing) throw new Error(`Metric '${name}' is not a counter.`);
+		return this.registerCounter(name, description);
+	}
+
+	gauge(name: string, description: string): Gauge {
+		const existing = this.metrics.get(name);
+		if (existing instanceof Gauge) {
+			if (existing.description !== description) {
+				process.stderr.write(`[pi-crew] metric-registry: gauge '${name}' description changed; using original: '${existing.description}'\n`);
+			}
+			return existing;
+		}
+		if (existing) throw new Error(`Metric '${name}' is not a gauge.`);
+		return this.registerGauge(name, description);
+	}
+
+	histogram(name: string, description: string, buckets?: number[]): Histogram {
+		const existing = this.metrics.get(name);
+		if (existing instanceof Histogram) {
+			if (existing.description !== description) {
+				process.stderr.write(`[pi-crew] metric-registry: histogram '${name}' description changed; using original: '${existing.description}'\n`);
+			}
+			return existing;
+		}
+		if (existing) throw new Error(`Metric '${name}' is not a histogram.`);
+		return this.registerHistogram(name, description, buckets);
+	}
+
+	get(name: string): Metric | undefined {
+		return this.metrics.get(name);
+	}
+
+	snapshot(): MetricSnapshot[] {
+		return [...this.metrics.values()].map((metric) => metric.snapshot());
+	}
+
+	dispose(): void {
+		this.metrics.clear();
+	}
+}
+
+export function createMetricRegistry(): MetricRegistry {
+	return new MetricRegistry();
+}

package/src/observability/metric-retention.ts

@@ -1,54 +1,54 @@
-import { labelKey, type MetricLabels } from "./metrics-primitives.ts";
-
-interface WindowEvent {
-	timestamp: number;
-	labels: MetricLabels;
-	delta: number;
-}
-
-export class TimeWindowedCounter {
-	private events: WindowEvent[] = [];
-	private readonly windowMs: number;
-	private readonly now: () => number;
-	private static readonly MAX_EVENTS = 100_000;
-
-	constructor(windowMs = 3_600_000, now: () => number = () => Date.now()) {
-		this.windowMs = windowMs;
-		this.now = now;
-	}
-
-	inc(labels: MetricLabels = {}, delta = 1): void {
-		if (!Number.isFinite(delta)) return;
-		// Cap the event array to prevent unbounded memory growth.
-		if (this.events.length >= TimeWindowedCounter.MAX_EVENTS) this.prune();
-		this.events.push({ timestamp: this.now(), labels: { ...labels }, delta });
-		this.prune();
-	}
-
-	count(labels: MetricLabels = {}, durationMs = this.windowMs): number {
-		const now = this.now();
-		this.pruneAt(now);
-		const key = labelKey(labels);
-		const cutoff = now - durationMs;
-		return this.events.filter((event) => event.timestamp >= cutoff && labelKey(event.labels) === key).reduce((sum, event) => sum + event.delta, 0);
-	}
-
-	rate(labels: MetricLabels = {}, durationMs = this.windowMs): number {
-		if (durationMs <= 0) return 0;
-		return this.count(labels, durationMs) / (durationMs / 1000);
-	}
-
-	size(): number {
-		this.prune();
-		return this.events.length;
-	}
-
-	private prune(): void {
-		this.pruneAt(this.now());
-	}
-
-	private pruneAt(now: number): void {
-		const cutoff = now - this.windowMs;
-		this.events = this.events.filter((event) => event.timestamp >= cutoff);
-	}
-}
+import { labelKey, type MetricLabels } from "./metrics-primitives.ts";
+
+interface WindowEvent {
+	timestamp: number;
+	labels: MetricLabels;
+	delta: number;
+}
+
+export class TimeWindowedCounter {
+	private events: WindowEvent[] = [];
+	private readonly windowMs: number;
+	private readonly now: () => number;
+	private static readonly MAX_EVENTS = 100_000;
+
+	constructor(windowMs = 3_600_000, now: () => number = () => Date.now()) {
+		this.windowMs = windowMs;
+		this.now = now;
+	}
+
+	inc(labels: MetricLabels = {}, delta = 1): void {
+		if (!Number.isFinite(delta)) return;
+		// Cap the event array to prevent unbounded memory growth.
+		if (this.events.length >= TimeWindowedCounter.MAX_EVENTS) this.prune();
+		this.events.push({ timestamp: this.now(), labels: { ...labels }, delta });
+		this.prune();
+	}
+
+	count(labels: MetricLabels = {}, durationMs = this.windowMs): number {
+		const now = this.now();
+		this.pruneAt(now);
+		const key = labelKey(labels);
+		const cutoff = now - durationMs;
+		return this.events.filter((event) => event.timestamp >= cutoff && labelKey(event.labels) === key).reduce((sum, event) => sum + event.delta, 0);
+	}
+
+	rate(labels: MetricLabels = {}, durationMs = this.windowMs): number {
+		if (durationMs <= 0) return 0;
+		return this.count(labels, durationMs) / (durationMs / 1000);
+	}
+
+	size(): number {
+		this.prune();
+		return this.events.length;
+	}
+
+	private prune(): void {
+		this.pruneAt(this.now());
+	}
+
+	private pruneAt(now: number): void {
+		const cutoff = now - this.windowMs;
+		this.events = this.events.filter((event) => event.timestamp >= cutoff);
+	}
+}