mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-08 20:42:43 +00:00
Marc-André Bombeck
b4166cdc84
Work a request starts and does not wait for runs inside the request's
context, so an annotate({ action }) from it landed on the request's event
whenever it ran before the event was emitted. The measurement tail's
status re-warm logged a hand-entered reading as
insights.status.invalidate.skipped on some requests and as
measurement.create on others.
runDetached starts such work so that its action is dropped for the event
it was detached from; meta, warnings and the auth it reads stay as they
were, and an event the work opens for itself keeps its own action.
fireAndForget now takes a function and starts it detached, and every
trackBackgroundTask handle on a request path is built with runDetached,
which a structural guard holds.
75 lines
2.7 KiB
TypeScript
75 lines
2.7 KiB
TypeScript
import { AsyncLocalStorage } from "node:async_hooks";
|
|
import type { WideEvent } from "./types";
|
|
import { WideEventBuilder } from "./event-builder";
|
|
import { detachedParent, registerDetachedEventSource } from "./detached";
|
|
import { registerSourcePriorityParseObserver } from "@/lib/validations/source-priority";
|
|
import { registerRecurrenceParseErrorObserver } from "@/lib/medications/scheduling/recurrence";
|
|
import {
|
|
DATETIME_NO_SECONDS_COUNTER,
|
|
registerDatetimeNoSecondsObserver,
|
|
} from "@/lib/validations/datetime";
|
|
|
|
/** AsyncLocalStorage fuer den aktuellen Request-Kontext */
|
|
export const eventStorage = new AsyncLocalStorage<WideEventBuilder>();
|
|
|
|
/** Aktuellen EventBuilder abrufen (null falls ausserhalb eines Kontexts) */
|
|
export function getEvent(): WideEventBuilder | null {
|
|
return eventStorage.getStore() ?? null;
|
|
}
|
|
|
|
// `runDetached` (./detached) reads the current event through this getter;
|
|
// registered here so the two modules do not import each other.
|
|
registerDetachedEventSource(getEvent);
|
|
|
|
/**
|
|
* Convenience: Felder im aktuellen Event annotieren.
|
|
* Safe to call anywhere — no-op wenn kein Kontext aktiv.
|
|
*/
|
|
export function annotate(fields: {
|
|
action?: WideEvent["action"];
|
|
meta?: Record<string, unknown>;
|
|
}): void {
|
|
const evt = getEvent();
|
|
if (!evt) return;
|
|
// Detached work never renames the event it was started from.
|
|
if (fields.action && detachedParent() !== evt) {
|
|
evt.setAction(fields.action);
|
|
}
|
|
if (fields.meta) {
|
|
for (const [key, value] of Object.entries(fields.meta)) {
|
|
evt.addMeta(key, value);
|
|
}
|
|
}
|
|
}
|
|
|
|
// v1.4.25 — wire the schema-parser breadcrumb into the
|
|
// AsyncLocalStorage-backed `annotate()` only on the server. The
|
|
// validations module stays bundle-safe for client imports; this side
|
|
// effect runs the first time any server module imports the logging
|
|
// context.
|
|
registerSourcePriorityParseObserver((fields) => {
|
|
annotate(fields);
|
|
});
|
|
|
|
// A medication recurrence rule that does not parse. Same bundle-safe
|
|
// registration: the scheduling module also runs in the browser.
|
|
registerRecurrenceParseErrorObserver((rrule) => {
|
|
annotate({
|
|
action: { name: "medication.recurrence.parse_error" },
|
|
meta: { rrule },
|
|
});
|
|
});
|
|
|
|
// v1.43 — count every request instant refused for lacking seconds, per wide
|
|
// event, so a client still on a minute-precision encoder is visible in the
|
|
// logs (`meta["validation.datetime.no_seconds"]`) before its users report
|
|
// the 422. Same bundle-safe registration as the breadcrumb above.
|
|
const noSecondsCounts = new WeakMap<WideEventBuilder, number>();
|
|
registerDatetimeNoSecondsObserver(() => {
|
|
const evt = getEvent();
|
|
if (!evt) return;
|
|
const next = (noSecondsCounts.get(evt) ?? 0) + 1;
|
|
noSecondsCounts.set(evt, next);
|
|
evt.addMeta(DATETIME_NO_SECONDS_COUNTER, next);
|
|
});
|