feat(diagnostics): correlate staff operations errors and audit records

src/lib/foundation/request-context.test.ts

@@ -0,0 +1,27 @@
+import { expect, it } from "vitest";
+import {
+	createStore,
+	getOperationContext,
+	runWithStore,
+	setContextUserId,
+} from "./request-context";
+import type { IpAddress, UserId } from "./types";
+
+it("isolates operation IDs and users across concurrent asynchronous requests", async () => {
+	const first = createStore("test" as IpAddress),
+		second = createStore("test" as IpAddress);
+	expect(first.requestId).not.toBe(second.requestId);
+	await Promise.all(
+		[first, second].map((store, index) =>
+			runWithStore(store, async () => {
+				setContextUserId((index + 1) as UserId);
+				await new Promise((resolve) => setTimeout(resolve, 5 - index));
+				expect(getOperationContext()).toEqual({
+					operationId: store.requestId,
+					userId: index + 1,
+				});
+			}),
+		),
+	);
+	expect(getOperationContext()).toEqual({});
+});

src/lib/foundation/request-context.ts

@@ -38,3 +38,17 @@ export function setContextUserId(userId: UserId): void {
 	const store = als.getStore();
 	if (store) store.userId = userId;
 }
+
+/** Stable correlation data exists only inside an active request or job. */
+export function getOperationContext(): {
+	operationId?: string;
+	userId?: number;
+} {
+	const store = als.getStore();
+	return store
+		? {
+				operationId: store.requestId,
+				...(store.userId === null ? {} : { userId: Number(store.userId) }),
+			}
+		: {};
+}