Reorganize repo structure and standards references

This commit is contained in:
david committed 2026-06-29 05:03:42 +02:00
1 parent 3cb93a81be
commit be2054274d
5885 files changed
+2588 -195

No files matched your search

@@ -0,0 +1,50 @@
/**
* API service-scoped Prometheus registry singleton.
*
* Lazily constructed so test files that mock env vars can swap the registry
* via {@link resetApiMetricsForTests}. The singleton is cheap (~30 KB of
* prom-client default metrics) and is intentionally NOT gated behind
* METRICS_ENABLED — the gate lives on the endpoints, not the registry. This
* lets business code call `apiMetrics.aiTokensConsumedTotal.inc(...)` without
* branching on an env flag everywhere.
*/
import { createDefaultMetrics, createMetricsRegistry, type DefaultMetrics, type MetricsRegistry } from "@toolctrl/metrics";
import { setEnqueueObserver } from "@toolctrl/queue";
type ApiMetricsBundle = {
registry: MetricsRegistry;
metrics: DefaultMetrics;
};
let cached: ApiMetricsBundle | undefined;
export function getApiMetrics(): ApiMetricsBundle {
if (!cached) {
cached = buildApiMetrics();
}
return cached;
}
/**
* Reset the cached bundle. Test-only — production code never calls this.
*/
export function resetApiMetricsForTests(): void {
cached = undefined;
}
function buildApiMetrics(): ApiMetricsBundle {
const revision = process.env.APP_REVISION?.trim() ?? "";
const registry = createMetricsRegistry({
serviceName: "api",
collectDefaultProcessMetrics: true,
...(revision ? { defaultLabels: { revision } } : {}),
});
const metrics = createDefaultMetrics(registry);
// Wire BullMQ enqueue events into queue_jobs_enqueued_total. The queue
// package keeps a module-level observer slot so we register exactly once
// per process; subsequent registrations from re-built bundles overwrite.
setEnqueueObserver((event) => {
metrics.queueJobsEnqueuedTotal.labels({ queue: event.queueName, priority: event.priorityLabel }).inc();
});
return { registry, metrics };
}