78 lines
3.1 KiB
TypeScript
78 lines
3.1 KiB
TypeScript
|
/**
|
||
|
|
* Structured logger — pino with JSON output in production, pretty in dev.
|
||
|
|
*
|
||
|
|
* Use as:
|
||
|
|
* import { log, withRequest } from "@/lib/logger";
|
||
|
|
* log.info({ doc_id, page }, "rendering page");
|
||
|
|
* log.error({ err }, "embed-service down");
|
||
|
|
*
|
||
|
|
* For request-scoped logging:
|
||
|
|
* const reqLog = withRequest(request);
|
||
|
|
* reqLog.info({ duration_ms: dt }, "hybrid_search done");
|
||
|
|
*
|
||
|
|
* Edge runtime falls back to a console adapter (pino requires node).
|
||
|
|
*/
|
||
|
|
import pino from "pino";
|
||
|
|
|
||
|
|
// Edge runtime doesn't support pino's worker thread; detect and fall back.
|
||
|
|
const isEdge = typeof process === "undefined" || process.env.NEXT_RUNTIME === "edge";
|
||
|
|
|
||
|
|
function build(): pino.Logger {
|
||
|
|
if (isEdge) {
|
||
|
|
// Minimal adapter so middleware can call log.* without crashing.
|
||
|
|
const noop = () => undefined;
|
||
|
|
return {
|
||
|
|
info: (o: unknown, m?: string) => console.log(JSON.stringify({ level: "info", msg: m, ...(typeof o === "object" ? o : { v: o }) })),
|
||
|
|
warn: (o: unknown, m?: string) => console.warn(JSON.stringify({ level: "warn", msg: m, ...(typeof o === "object" ? o : { v: o }) })),
|
||
|
|
error: (o: unknown, m?: string) => console.error(JSON.stringify({ level: "error", msg: m, ...(typeof o === "object" ? o : { v: o }) })),
|
||
|
|
debug: noop,
|
||
|
|
trace: noop,
|
||
|
|
fatal: (o: unknown, m?: string) => console.error(JSON.stringify({ level: "fatal", msg: m, ...(typeof o === "object" ? o : { v: o }) })),
|
||
|
|
child: () => build(),
|
||
|
|
} as unknown as pino.Logger;
|
||
|
|
}
|
||
|
|
return pino({
|
||
|
|
level: process.env.LOG_LEVEL || "info",
|
||
|
|
base: {
|
||
|
|
app: "disclosure-web",
|
||
|
|
env: process.env.NODE_ENV || "development",
|
||
|
|
},
|
||
|
|
timestamp: pino.stdTimeFunctions.isoTime,
|
||
|
|
// Production: NDJSON (one JSON per line). Dev: pretty-printed.
|
||
|
|
transport: process.env.NODE_ENV === "production" ? undefined : {
|
||
|
|
target: "pino-pretty",
|
||
|
|
options: { colorize: true, translateTime: "SYS:HH:MM:ss.l" },
|
||
|
|
},
|
||
|
|
});
|
||
|
|
}
|
||
|
|
|
||
|
|
export const log: pino.Logger = build();
|
||
|
|
|
||
|
|
/** Create a child logger bound to a request's correlation id. */
|
||
|
|
export function withRequest(req: Request | { headers: Headers }): pino.Logger {
|
||
|
|
const id = req.headers.get("x-correlation-id") ||
|
||
|
|
req.headers.get("x-request-id") ||
|
||
|
|
cryptoRandomId();
|
||
|
|
return log.child({ correlation_id: id });
|
||
|
|
}
|
||
|
|
|
||
|
|
/** Get-or-mint a correlation id for a request. */
|
||
|
|
export function correlationId(req: Request | { headers: Headers }): string {
|
||
|
|
return req.headers.get("x-correlation-id") ||
|
||
|
|
req.headers.get("x-request-id") ||
|
||
|
|
cryptoRandomId();
|
||
|
|
}
|
||
|
|
|
||
|
|
function cryptoRandomId(): string {
|
||
|
|
// 16 hex chars — short enough for logs, enough entropy for non-security uses.
|
||
|
|
// Both edge runtime and Node 19+ expose globalThis.crypto; older Node falls
|
||
|
|
// back to Math.random (acceptable: this is correlation, not security).
|
||
|
|
const g = globalThis as { crypto?: { getRandomValues?: (a: Uint8Array) => void } };
|
||
|
|
if (g.crypto?.getRandomValues) {
|
||
|
|
const buf = new Uint8Array(8);
|
||
|
|
g.crypto.getRandomValues(buf);
|
||
|
|
return Array.from(buf, (b) => b.toString(16).padStart(2, "0")).join("");
|
||
|
|
}
|
||
|
|
return Math.random().toString(36).slice(2, 18);
|
||
|
|
}
|