@tanngo11/log 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,19 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.4.2
4
+
5
+ Fixed:
6
+ - `withLogging` resolves to the handler's own response type (for example `NextResponse` with
7
+ `.cookies`) instead of plain `Response`.
8
+ - `package.json` is listed in `exports`, so tools that read it can resolve it.
9
+
10
+ ## 0.4.1
11
+
12
+ Fixed:
13
+ - `withLogging` now returns a function with exactly the handler's parameters (`()`, `(request)`
14
+ or `(request, { params })`), so Next.js route type checks accept the wrapped export. When it is
15
+ called without a request (a direct call in a unit test), it runs the handler without logging.
16
+
3
17
  ## 0.4.0
4
18
 
5
19
  Added:
package/dist/next.cjs CHANGED
@@ -320,11 +320,13 @@ function trySetHeader(res, name, value) {
320
320
  }
321
321
  }
322
322
  function withLogging(log, handler, opts = {}) {
323
- return (request, context) => {
323
+ return async (...args) => {
324
+ const request = args[0];
325
+ if (!(request instanceof Request)) return await handler(...args);
324
326
  const ctx = requestContextFields(request.headers);
325
327
  const path = new URL(request.url).pathname;
326
328
  const start = performance.now();
327
- return runWithStore(ctx, async (store) => {
329
+ return await runWithStore(ctx, async (store) => {
328
330
  const summary = (status, err) => logHttpRequest(
329
331
  log,
330
332
  {
@@ -339,7 +341,7 @@ function withLogging(log, handler, opts = {}) {
339
341
  opts
340
342
  );
341
343
  try {
342
- const res = await handler(request, context);
344
+ const res = await handler(...args);
343
345
  summary(res.status, store.error);
344
346
  trySetHeader(res, "x-request-id", ctx.request_id);
345
347
  return res;
package/dist/next.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/next.ts","../src/context.ts","../src/global.ts","../src/redact.ts","../src/error.ts","../src/normalize.ts","../src/request-id.ts","../src/http.ts","../src/process.ts"],"sourcesContent":["import { runWithStore } from \"./context\";\nimport { isLogged, markLogged } from \"./error\";\nimport { logHttpRequest, requestContextFields, type HeaderSource, type HttpLogOptions } from \"./http\";\nimport type { Logger } from \"./logger\";\nimport type { Fields } from \"./normalize\";\nimport { installProcessHandlers, logStartup } from \"./process\";\n\nexport interface WithLoggingOptions extends HttpLogOptions {\n /** Route template, e.g. \"/api/orders/[id]\". Left empty when not given. */\n route?: string;\n}\n\n/** Status for Next's control-flow errors (redirect(), notFound(), forbidden()...), else undefined. */\nexport function nextControlStatus(err: unknown): number | undefined {\n const digest = (err as { digest?: unknown } | null)?.digest;\n if (typeof digest !== \"string\") return undefined;\n if (digest.startsWith(\"NEXT_REDIRECT\")) {\n const status = Number(digest.split(\";\")[3]);\n return Number.isInteger(status) && status >= 300 ? status : 307;\n }\n if (digest === \"NEXT_NOT_FOUND\") return 404;\n if (digest.startsWith(\"NEXT_HTTP_ERROR_FALLBACK;\")) return Number(digest.split(\";\")[1]) || 404;\n return undefined;\n}\n\nfunction asError(value: unknown): unknown {\n if (typeof value === \"object\" && value !== null) return value;\n return Object.assign(new Error(String(value)), { name: \"NonErrorThrown\", thrown: value });\n}\n\nfunction trySetHeader(res: Response, name: string, value: string): void {\n try {\n res.headers.set(name, value);\n } catch {\n // Some responses (Response.redirect, proxied fetch responses) have immutable headers.\n }\n}\n\n/** Wraps an App Router route handler: request context + one http.request line. */\nexport function withLogging<R extends Request, C>(\n log: Logger,\n handler: (request: R, context: C) => Response | Promise<Response>,\n opts: WithLoggingOptions = {},\n): (request: R, context: C) => Promise<Response> {\n return (request, context) => {\n const ctx = requestContextFields(request.headers);\n const path = new URL(request.url).pathname;\n const start = performance.now();\n return runWithStore(ctx, async (store) => {\n const summary = (status: number, err: unknown) =>\n logHttpRequest(\n log,\n {\n method: request.method,\n route: opts.route,\n path,\n status,\n duration_ms: performance.now() - start,\n err,\n fields: store.fields,\n },\n opts,\n );\n try {\n const res = await handler(request, context);\n summary(res.status, store.error);\n trySetHeader(res, \"x-request-id\", ctx.request_id);\n return res;\n } catch (caught) {\n const control = nextControlStatus(caught);\n // Non-objects cannot be marked as logged, so onRequestError would log them again.\n const err = control === undefined ? asError(caught) : caught;\n summary(control ?? 500, control === undefined ? err : store.error);\n throw err;\n }\n });\n };\n}\n\nexport interface NextRequestInfo {\n path?: string;\n method?: string;\n headers?: Record<string, string | string[] | undefined>;\n}\n\nexport interface NextErrorContext {\n routerKind?: string;\n routePath?: string;\n routeType?: string;\n}\n\n/** `export const onRequestError = nextOnRequestError(log)` in instrumentation.ts. */\nexport function nextOnRequestError(log: Logger, opts: HttpLogOptions = {}) {\n return async (err: unknown, request: NextRequestInfo, context: NextErrorContext): Promise<void> => {\n if (isLogged(err) || nextControlStatus(err) !== undefined) return;\n const digest = (err as { digest?: unknown } | null)?.digest;\n logHttpRequest(\n log,\n {\n method: request?.method ?? \"GET\",\n route: context?.routePath,\n path: request?.path ?? \"\",\n status: 500,\n err,\n fields: {\n ...requestContextFields(request?.headers ?? {}),\n next_route_type: context?.routeType,\n next_router_kind: context?.routerKind,\n next_digest: typeof digest === \"string\" ? digest : undefined,\n },\n },\n opts,\n );\n };\n}\n\n/** Call from `register()` in instrumentation.ts. Does nothing on the edge runtime. */\nexport function registerNext(log: Logger, fields?: Fields): void {\n if (process.env.NEXT_RUNTIME && process.env.NEXT_RUNTIME !== \"nodejs\") return;\n // Next keeps serving after an unhandled rejection, so do not exit.\n installProcessHandlers(log, { exitOnCrash: false });\n logStartup(log, { port: process.env.PORT ? Number(process.env.PORT) : undefined, ...fields });\n}\n\nexport interface WithActionOptions {\n /** Request headers source. Defaults to `headers()` from next/headers. */\n headers?: () => HeaderSource | Promise<HeaderSource>;\n}\n\nasync function nextHeaders(): Promise<HeaderSource> {\n try {\n const mod = (await import(\"next/headers\")) as { headers: () => HeaderSource | Promise<HeaderSource> };\n return await mod.headers();\n } catch {\n // Called outside a request (tests, scripts) or Next is not installed.\n return {};\n }\n}\n\n/**\n * Wraps a server action: request context (request_id from x-request-id) plus one\n * `action.completed` / `action.failed` line. redirect()/notFound() count as completed.\n */\nexport function withAction<A extends unknown[], R>(\n log: Logger,\n name: string,\n action: (...args: A) => Promise<R>,\n opts: WithActionOptions = {},\n): (...args: A) => Promise<R> {\n return async (...args) => {\n const headers = await (opts.headers ?? nextHeaders)();\n const start = performance.now();\n return runWithStore({ ...requestContextFields(headers), action_name: name }, async (store) => {\n const fields = () => ({ ...store.fields, duration_ms: Math.round(performance.now() - start) });\n try {\n const result = await action(...args);\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", err: store.error });\n return result;\n } catch (caught) {\n const control = nextControlStatus(caught);\n if (control !== undefined) {\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", next_control_status: control });\n throw caught;\n }\n const err = asError(caught);\n log.error(\"server action failed\", { ...fields(), event: \"action.failed\", err });\n markLogged(err);\n throw err;\n }\n });\n };\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { globalSingleton } from \"./global\";\nimport type { Fields } from \"./normalize\";\n\nexport interface ContextStore {\n fields: Fields;\n error?: unknown;\n /** Route template captured while the router still knew it (Express error path). */\n route?: string;\n parent?: ContextStore;\n}\n\nconst als = globalSingleton(\"als\", () => new AsyncLocalStorage<ContextStore>());\n\nexport const STORE_KEY: symbol = Symbol.for(\"@tanngo11/log.store\");\n\nexport function runWithStore<T>(fields: Fields, fn: (store: ContextStore) => T): T {\n const parent = als.getStore();\n const store: ContextStore = { fields: { ...parent?.fields, ...fields }, parent };\n return als.run(store, () => fn(store));\n}\n\nexport function withContext<T>(fields: Fields, fn: () => T): T {\n return runWithStore(fields, () => fn());\n}\n\nexport function currentStore(): ContextStore | undefined {\n return als.getStore();\n}\n\nexport function getContext(): Fields {\n return als.getStore()?.fields ?? {};\n}\n\n// Applies to the current context and every enclosing one, so a field added inside a nested\n// withContext/runJob still reaches the request's http.request line.\nexport function addContext(fields: Fields): void {\n for (let s = als.getStore(); s; s = s.parent) Object.assign(s.fields, fields);\n}\n\n// Sets the error on the store and on enclosing stores that have none yet.\nexport function recordErrorIn(store: ContextStore, err: unknown): void {\n store.error = err;\n for (let s = store.parent; s; s = s.parent) if (s.error === undefined) s.error = err;\n}\n\n// Marks the error that the current request/job summary line should carry. Does not write a line.\nexport function recordError(err: unknown): void {\n const store = als.getStore();\n if (store) recordErrorIn(store, err);\n}\n\nexport function attachStore(target: object, store: ContextStore): void {\n (target as Record<symbol, ContextStore>)[STORE_KEY] = store;\n}\n\nexport function storeOf(target: unknown): ContextStore | undefined {\n if (typeof target !== \"object\" || target === null) return undefined;\n return (target as Record<symbol, ContextStore | undefined>)[STORE_KEY];\n}\n","// Singletons shared by every copy of this package loaded in the process (ESM and CJS builds,\n// or duplicated installs), so context and dedupe state never split.\nexport function globalSingleton<T>(name: string, make: () => T): T {\n const key = Symbol.for(`@tanngo11/log.${name}`);\n const g = globalThis as unknown as Record<symbol, T | undefined>;\n let value = g[key];\n if (value === undefined) {\n value = make();\n g[key] = value;\n }\n return value;\n}\n","// Redaction shared by the logger and the error serializer. The collector redacts again,\n// but it cannot see secrets inside JSON-encoded strings, so the app side must catch them.\n\nexport const DEFAULT_REDACT_KEYS = [\n \"password\", \"passwd\", \"pwd\", \"passphrase\", \"secret\", \"client_secret\",\n \"token\", \"access_token\", \"refresh_token\", \"id_token\", \"auth_token\",\n \"api_key\", \"apikey\", \"access_key\", \"secret_key\", \"private_key\",\n \"authorization\", \"cookie\", \"set_cookie\", \"session_id\", \"sessionid\",\n \"credential\", \"credentials\", \"dsn\", \"connection_string\", \"conn_string\", \"jwt\", \"bearer\",\n];\n\n/** Opt-in value patterns for `redactValues`. Not on by default: they can hit ordinary numbers. */\nexport const REDACT_PATTERNS = {\n /** Vietnamese mobile numbers: 0912345678, +84912345678, 84912345678. */\n phoneVN: /(?<![\\d+])(?:\\+?84|0)[35789]\\d{8}(?!\\d)/g,\n /** Visa, Mastercard, Amex, Discover-like card numbers, with optional spaces or dashes. */\n paymentCard: /(?<!\\d)(?:4\\d{3}|5[1-5]\\d{2}|2[2-7]\\d{2}|3[47]\\d{2}|6(?:011|5\\d{2}))(?:[ -]?\\d{4}){2}[ -]?\\d{1,4}(?!\\d)/g,\n /** IPv4 addresses. */\n ipv4: /(?<![\\d.])(?:\\d{1,3}\\.){3}\\d{1,3}(?![\\d.])/g,\n} as const;\n\n// Keys that only describe a secret (count, type, timestamps, flags) stay readable.\nconst SAFE_SUFFIXES = [\"_count\", \"_type\", \"_length\", \"_expires_at\", \"_expires_in\", \"_ttl\", \"_at\", \"_ms\", \"_enabled\"];\n\nexport const REDACTED = \"[REDACTED]\";\n\nexport function toSnakeCase(key: string): string {\n return key\n .replace(/([a-z0-9])([A-Z])/g, \"$1_$2\")\n .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1_$2\")\n .replace(/[^A-Za-z0-9_]+/g, \"_\")\n .toLowerCase();\n}\n\nconst URL_CREDENTIALS_RE = /([a-z][a-z0-9+.-]*:\\/\\/)[^\\s/@:\"']+:[^\\s/@\"']+@/gi;\nconst BEARER_RE = /\\bBearer\\s+[A-Za-z0-9._~+/=-]+/gi;\nconst JWT_RE = /\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+/g;\nconst EMAIL_RE = /[A-Za-z0-9._%+-]+@([A-Za-z0-9-]+(?:\\.[A-Za-z0-9-]+)*\\.[A-Za-z]{2,})/g;\n\nexport type KeyPattern = string | RegExp;\n\nexport interface RedactorOptions {\n /** Extra sensitive keys: names (matched like the defaults) or patterns tested on the snake_case key. */\n keys?: readonly KeyPattern[];\n /** Extra value patterns; every match inside any string becomes [REDACTED]. */\n values?: readonly RegExp[];\n}\n\nexport interface Redactor {\n isSensitive(key: string): boolean;\n /** Masks secrets and emails that appear inside free text. */\n scrub(s: string): string;\n /** JSON.stringify that redacts sensitive keys at any depth and never throws. */\n json(value: unknown): string;\n}\n\nfunction globalize(re: RegExp): RegExp {\n return re.flags.includes(\"g\") ? new RegExp(re.source, re.flags) : new RegExp(re.source, `${re.flags}g`);\n}\n\nexport function createRedactor(opts: RedactorOptions = {}): Redactor {\n const words = [...DEFAULT_REDACT_KEYS];\n const keyPatterns: RegExp[] = [];\n for (const k of opts.keys ?? []) {\n if (typeof k === \"string\") words.push(toSnakeCase(k));\n else keyPatterns.push(new RegExp(k.source, k.flags.replace(\"g\", \"\")));\n }\n const valuePatterns = (opts.values ?? []).map(globalize);\n\n const isSensitive = (key: string): boolean => {\n const k = toSnakeCase(key);\n if (keyPatterns.some((re) => re.test(k))) return true;\n if (!words.includes(k) && SAFE_SUFFIXES.some((s) => k.endsWith(s))) return false;\n return words.some((w) => k === w || k.startsWith(`${w}_`) || k.endsWith(`_${w}`) || k.includes(`_${w}_`));\n };\n\n const scrub = (s: string): string => {\n let out = s\n .replace(URL_CREDENTIALS_RE, `$1${REDACTED}@`)\n .replace(BEARER_RE, `Bearer ${REDACTED}`)\n .replace(JWT_RE, \"[REDACTED_JWT]\")\n .replace(EMAIL_RE, \"***@$1\");\n for (const re of valuePatterns) out = out.replace(re, REDACTED);\n return out;\n };\n\n const json = (value: unknown): string => {\n if (typeof value === \"string\") return value;\n try {\n const text = JSON.stringify(value, (key, val: unknown) => {\n if (key && val !== null && val !== undefined && isSensitive(key)) return REDACTED;\n if (typeof val === \"bigint\") return val.toString();\n if (val instanceof Error) return { name: val.name, message: val.message };\n return val;\n });\n return text ?? String(value);\n } catch {\n return String(value);\n }\n };\n\n return { isSensitive, scrub, json };\n}\n\nexport const defaultRedactor: Redactor = createRedactor();\n","import { globalSingleton } from \"./global\";\nimport { defaultRedactor } from \"./redact\";\n\nexport interface ErrFields {\n err_type?: string;\n err_message?: string;\n err_code?: string;\n err_stack?: string;\n err_cause?: string;\n}\n\nconst MAX_CAUSE_DEPTH = 5;\n\nexport function isErrorLike(v: unknown): v is Error {\n if (v instanceof Error) return true;\n return (\n typeof v === \"object\" &&\n v !== null &&\n typeof (v as { message?: unknown }).message === \"string\" &&\n (\"stack\" in v || \"name\" in v)\n );\n}\n\nfunction errorType(e: Error): string {\n if (e.name && e.name !== \"Error\") return e.name;\n const ctor = (e as { constructor?: { name?: string } }).constructor?.name;\n return ctor && ctor !== \"Object\" ? ctor : \"Error\";\n}\n\nexport function serializeError(err: unknown): ErrFields {\n if (!isErrorLike(err)) {\n if (typeof err === \"string\") return { err_type: \"string\", err_message: err };\n return { err_type: typeof err, err_message: defaultRedactor.json(err) };\n }\n const e = err as Error & { code?: unknown; cause?: unknown };\n const out: ErrFields = { err_type: errorType(e), err_message: String(e.message ?? \"\") };\n if (e.code !== undefined && e.code !== null) out.err_code = String(e.code);\n if (typeof e.stack === \"string\") out.err_stack = e.stack;\n\n const causes: string[] = [];\n let cause = e.cause;\n while (cause !== undefined && cause !== null && causes.length < MAX_CAUSE_DEPTH) {\n if (isErrorLike(cause)) {\n causes.push(`${errorType(cause)}: ${cause.message}`);\n cause = (cause as { cause?: unknown }).cause;\n } else {\n causes.push(defaultRedactor.json(cause));\n cause = undefined;\n }\n }\n if (causes.length > 0) out.err_cause = causes.join(\" <- \");\n return out;\n}\n\nconst logged = globalSingleton(\"logged\", () => new WeakSet<object>());\n\n// Marks an error as already written, so a later boundary (e.g. Next's onRequestError)\n// does not log it a second time.\nexport function markLogged(err: unknown): void {\n if (typeof err === \"object\" && err !== null) logged.add(err);\n}\n\nexport function isLogged(err: unknown): boolean {\n return typeof err === \"object\" && err !== null && logged.has(err);\n}\n","import { isErrorLike, serializeError } from \"./error\";\nimport type { Level } from \"./levels\";\nimport { REDACTED, toSnakeCase, type Redactor } from \"./redact\";\n\nexport { DEFAULT_REDACT_KEYS, toSnakeCase } from \"./redact\";\n\n/** Final per-field hook: return a replacement, or undefined to drop the field. */\nexport type RedactHook = (key: string, value: Primitive) => unknown;\n\nexport type Fields = Record<string, unknown>;\nexport type Primitive = string | number | boolean | null;\nexport type LogRecord = Record<string, Primitive>;\n\nexport interface NormalizeOptions {\n snakeCase: boolean;\n redactor: Redactor;\n hook?: RedactHook;\n}\n\n// Fields the redact hook never sees, so every line keeps its level, message and event.\nconst HOOK_EXEMPT = new Set([\"level\", \"message\", \"event\"]);\n\n// Keys owned by Vector (overwritten or deleted on ingest) or by the logger itself.\nexport const RESERVED_KEYS = new Set([\n \"project\", \"service\", \"vps\", \"version\", \"container_name\", \"container_id\", \"image\", \"stream\",\n \"_timestamp\", \"label\", \"host\", \"source_type\", \"msg\", \"lvl\", \"severity\", \"level\", \"message\",\n]);\n\nexport const MAX_LINE_BYTES = 16000;\nconst MAX_MESSAGE = 500;\nconst MAX_STACK = 4000;\nconst MAX_STRING = 1000;\nconst MAX_DEPTH = 3;\nconst TRUNCATED = \"…[truncated]\";\n\n// Fields kept when a line is too large.\nconst KEEP_ON_SHRINK = new Set([\n \"level\", \"message\", \"event\", \"request_id\", \"trace_id\", \"span_id\", \"job_name\", \"job_id\", \"job_attempt\",\n \"user_id\", \"tenant_id\", \"err_type\", \"err_message\", \"err_code\",\n]);\n\nexport function stripUrl(url: string): string {\n const noQuery = url.split(/[?#]/, 1)[0] ?? \"\";\n return noQuery.replace(/^([a-z][a-z0-9+.-]*:\\/\\/)[^/@\\s]*@/i, \"$1\");\n}\n\nexport function truncate(s: string, max: number): string {\n return s.length > max ? s.slice(0, max - TRUNCATED.length) + TRUNCATED : s;\n}\n\nfunction isPlainObject(v: unknown): v is Fields {\n if (typeof v !== \"object\" || v === null) return false;\n const proto = Object.getPrototypeOf(v);\n return proto === Object.prototype || proto === null;\n}\n\nfunction isUrlKey(key: string): boolean {\n return key === \"http_path\" || key === \"http_url\" || key.endsWith(\"_url\");\n}\n\nfunction flattenInto(out: LogRecord, prefix: string, obj: Fields, depth: number, opts: NormalizeOptions): void {\n for (const [rawKey, value] of Object.entries(obj)) {\n const key = opts.snakeCase ? toSnakeCase(rawKey) : rawKey;\n const full = prefix ? `${prefix}_${key}` : key;\n if (value === undefined || typeof value === \"function\" || typeof value === \"symbol\") continue;\n if (value !== null && (opts.redactor.isSensitive(rawKey) || opts.redactor.isSensitive(full))) {\n out[full] = REDACTED;\n continue;\n }\n if (value === null || typeof value === \"string\" || typeof value === \"boolean\") {\n out[full] = value;\n } else if (typeof value === \"number\") {\n out[full] = Number.isFinite(value) ? value : String(value);\n } else if (typeof value === \"bigint\") {\n out[full] = value.toString();\n } else if (value instanceof Date) {\n out[full] = Number.isNaN(value.getTime()) ? \"Invalid Date\" : value.toISOString();\n } else if (isErrorLike(value)) {\n out[full] = `${value.name}: ${value.message}`;\n } else if (isPlainObject(value) && depth < MAX_DEPTH - 1) {\n flattenInto(out, full, value, depth + 1, opts);\n } else {\n // Arrays, deep objects, class instances: stringified with sensitive keys redacted.\n out[full] = opts.redactor.json(value);\n }\n }\n}\n\nfunction finalize(key: string, value: Primitive, opts: NormalizeOptions): Primitive {\n if (typeof value !== \"string\") return value;\n const v = opts.redactor.scrub(isUrlKey(key) ? stripUrl(value) : value);\n return truncate(v, key === \"err_stack\" ? MAX_STACK : MAX_STRING);\n}\n\nexport function buildRecord(\n level: Level,\n message: unknown,\n sources: (Fields | undefined)[],\n opts: NormalizeOptions,\n): LogRecord {\n const merged: Fields = {};\n for (const source of sources) if (source) Object.assign(merged, source);\n\n let err: unknown;\n if (merged.err !== undefined && merged.err !== null) {\n err = merged.err;\n delete merged.err;\n } else if (isErrorLike(merged.error)) {\n err = merged.error;\n delete merged.error;\n }\n\n const flat: LogRecord = {};\n flattenInto(flat, \"\", merged, 0, opts);\n if (err !== undefined) Object.assign(flat, serializeError(err));\n\n const text = typeof message === \"string\" ? message : opts.redactor.json(message);\n const out: LogRecord = { level, message: truncate(opts.redactor.scrub(text), MAX_MESSAGE) };\n for (const [k, v] of Object.entries(flat)) {\n const key = RESERVED_KEYS.has(k) ? `app_${k}` : k;\n let value = finalize(key, v, opts);\n if (opts.hook && !HOOK_EXEMPT.has(key)) {\n const replaced = opts.hook(key, value);\n if (replaced === undefined) continue;\n value = typeof replaced === \"object\" && replaced !== null ? opts.redactor.json(replaced) : (replaced as Primitive);\n }\n out[key] = value;\n }\n return out;\n}\n\nfunction byteLength(s: string): number {\n // UTF-8 uses at most 3 bytes per UTF-16 code unit: skip encoding short lines.\n if (s.length * 3 <= MAX_LINE_BYTES) return s.length;\n return new TextEncoder().encode(s).length;\n}\n\nexport function serializeRecord(record: LogRecord): string {\n const line = JSON.stringify(record);\n if (byteLength(line) <= MAX_LINE_BYTES) return line;\n const small: LogRecord = {};\n for (const [k, v] of Object.entries(record)) {\n if (KEEP_ON_SHRINK.has(k) || k.startsWith(\"http_\")) small[k] = v;\n }\n small.log_truncated = true;\n return JSON.stringify(small);\n}\n","// No imports: this module is shared with the edge entry (next-edge).\nexport const REQUEST_ID_RE = /^[A-Za-z0-9._-]{1,64}$/;\nconst TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;\n\nexport function newRequestId(): string {\n return globalThis.crypto.randomUUID();\n}\n\nfunction first(header?: string | string[] | null): string | undefined {\n return Array.isArray(header) ? header[0] : (header ?? undefined);\n}\n\nexport function resolveRequestId(header?: string | string[] | null): string {\n const value = first(header);\n return value && REQUEST_ID_RE.test(value) ? value : newRequestId();\n}\n\nexport function parseTraceparent(header?: string | string[] | null): { trace_id: string; span_id: string } | undefined {\n const value = first(header)?.trim().toLowerCase();\n const m = value ? TRACEPARENT_RE.exec(value) : null;\n if (!m) return undefined;\n const [, version, traceId, spanId] = m as unknown as [string, string, string, string];\n if (version === \"ff\" || /^0+$/.test(traceId) || /^0+$/.test(spanId)) return undefined;\n return { trace_id: traceId, span_id: spanId };\n}\n","import { getContext } from \"./context\";\nimport { markLogged, serializeError } from \"./error\";\nimport type { Logger } from \"./logger\";\nimport { stripUrl, type Fields } from \"./normalize\";\nimport { parseTraceparent, resolveRequestId } from \"./request-id\";\n\nexport { newRequestId, parseTraceparent, REQUEST_ID_RE, resolveRequestId } from \"./request-id\";\n\nexport type HeaderSource = Headers | Record<string, string | string[] | undefined>;\n\nfunction header(headers: HeaderSource, name: string): string | string[] | undefined {\n if (typeof (headers as Headers).get === \"function\") return (headers as Headers).get(name) ?? undefined;\n return (headers as Record<string, string | string[] | undefined>)[name];\n}\n\nexport function requestContextFields(headers: HeaderSource): { request_id: string; trace_id?: string; span_id?: string } {\n const out: { request_id: string; trace_id?: string; span_id?: string } = {\n request_id: resolveRequestId(header(headers, \"x-request-id\")),\n };\n const tp = parseTraceparent(header(headers, \"traceparent\"));\n if (tp) Object.assign(out, tp);\n return out;\n}\n\n// Headers to forward to services we own, so their logs share request_id / trace_id.\nexport function propagationHeaders(): Record<string, string> {\n const ctx = getContext();\n const out: Record<string, string> = {};\n if (typeof ctx.request_id === \"string\") out[\"x-request-id\"] = ctx.request_id;\n if (typeof ctx.trace_id === \"string\" && typeof ctx.span_id === \"string\") {\n out.traceparent = `00-${ctx.trace_id}-${ctx.span_id}-01`;\n }\n return out;\n}\n\nexport const DEFAULT_SKIP_PATHS: (string | RegExp)[] = [\n /^\\/(health|healthz|ready|readyz|livez)\\/?$/,\n \"/favicon.ico\",\n /^\\/_next\\/static\\//,\n];\n\nexport interface HttpLogOptions {\n skipPaths?: (string | RegExp)[];\n}\n\nexport interface HttpRequestInfo {\n method: string;\n route?: string;\n path: string;\n status: number;\n duration_ms?: number;\n err?: unknown;\n fields?: Fields;\n}\n\nexport function shouldSkip(method: string, path: string, skipPaths: (string | RegExp)[] = DEFAULT_SKIP_PATHS): boolean {\n if (method.toUpperCase() === \"OPTIONS\") return true;\n const p = stripUrl(path);\n return skipPaths.some((s) => (typeof s === \"string\" ? p === s : s.test(p)));\n}\n\n// Writes the one `http.request` summary line for an inbound request.\nexport function logHttpRequest(log: Logger, info: HttpRequestInfo, opts: HttpLogOptions = {}): void {\n if (shouldSkip(info.method, info.path, opts.skipPaths)) return;\n const level = info.status >= 500 ? \"error\" : info.status >= 400 ? \"warn\" : \"info\";\n const path = stripUrl(info.path);\n const errFields: Fields = {};\n if (info.err !== undefined && info.err !== null) {\n Object.assign(errFields, serializeError(info.err));\n if (info.status < 500) delete errFields.err_stack;\n markLogged(info.err);\n }\n // Route templates keep the message bounded; the raw path would make one message per URL.\n const message = info.route ? `${info.method} ${info.route} ${info.status}` : `${info.method} ${info.status}`;\n log[level](message, {\n ...info.fields,\n event: \"http.request\",\n http_method: info.method,\n http_route: info.route,\n http_path: path,\n http_status: info.status,\n duration_ms: info.duration_ms === undefined ? undefined : Math.round(info.duration_ms),\n ...errFields,\n });\n}\n","import { globalSingleton } from \"./global\";\nimport type { Logger } from \"./logger\";\nimport type { Fields } from \"./normalize\";\n\nexport function logStartup(log: Logger, fields: Fields = {}): void {\n log.info(\"app started\", {\n event: \"app.started\",\n runtime_version: `node ${process.versions.node}`,\n log_level: log.level,\n ...fields,\n });\n}\n\n/** Call at the start of your own shutdown handler (e.g. on SIGTERM). The library never handles signals. */\nexport function logShutdown(log: Logger, fields: Fields = {}): void {\n log.info(\"app stopping\", { event: \"app.stopping\", ...fields });\n}\n\nexport interface ProcessHandlerOptions {\n /** Exit with code 1 after an uncaught error. Next.js keeps serving, so its adapter passes false. */\n exitOnCrash?: boolean;\n /** Time other crash handlers (Sentry, APM) get to flush before exit. Default 1000 ms. */\n exitDelayMs?: number;\n exit?: (code: number) => void;\n}\n\nexport function crashHandlers(log: Logger, opts: ProcessHandlerOptions = {}) {\n const exitOnCrash = opts.exitOnCrash ?? true;\n const exitDelayMs = opts.exitDelayMs ?? 1000;\n const exit = opts.exit ?? ((code: number) => process.exit(code));\n let exiting = false;\n const crash = (source: string, err: unknown) => {\n if (!exitOnCrash) {\n log.error(\"unhandled error\", { event: \"app.unhandled_error\", crash_source: source, err });\n return;\n }\n log.fatal(\"app crashed\", { event: \"app.crashed\", crash_source: source, err });\n if (exiting) return;\n exiting = true;\n if (typeof process !== \"undefined\") process.exitCode = 1;\n // Deferred so listeners registered after ours still run; unref so a process with nothing\n // left to do exits on its own (with exitCode 1) without waiting.\n const timer = setTimeout(() => exit(1), exitDelayMs);\n (timer as { unref?: () => void }).unref?.();\n };\n return {\n onUncaught: (err: unknown) => crash(\"uncaughtException\", err),\n onRejection: (reason: unknown) => crash(\"unhandledRejection\", reason),\n };\n}\n\nconst state = globalSingleton(\"process\", () => ({ installed: false }));\n\n/** Logs uncaught exceptions and unhandled rejections. Does not touch SIGTERM/SIGINT. */\nexport function installProcessHandlers(log: Logger, opts: ProcessHandlerOptions = {}): void {\n if (state.installed || typeof process === \"undefined\" || typeof process.on !== \"function\") return;\n state.installed = true;\n const h = crashHandlers(log, opts);\n process.on(\"uncaughtException\", h.onUncaught);\n process.on(\"unhandledRejection\", h.onRejection);\n}\n"],"mappings":"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","names":["header"]}
1
+ {"version":3,"sources":["../src/next.ts","../src/context.ts","../src/global.ts","../src/redact.ts","../src/error.ts","../src/normalize.ts","../src/request-id.ts","../src/http.ts","../src/process.ts"],"sourcesContent":["import { runWithStore } from \"./context\";\nimport { isLogged, markLogged } from \"./error\";\nimport { logHttpRequest, requestContextFields, type HeaderSource, type HttpLogOptions } from \"./http\";\nimport type { Logger } from \"./logger\";\nimport type { Fields } from \"./normalize\";\nimport { installProcessHandlers, logStartup } from \"./process\";\n\nexport interface WithLoggingOptions extends HttpLogOptions {\n /** Route template, e.g. \"/api/orders/[id]\". Left empty when not given. */\n route?: string;\n}\n\n/** Status for Next's control-flow errors (redirect(), notFound(), forbidden()...), else undefined. */\nexport function nextControlStatus(err: unknown): number | undefined {\n const digest = (err as { digest?: unknown } | null)?.digest;\n if (typeof digest !== \"string\") return undefined;\n if (digest.startsWith(\"NEXT_REDIRECT\")) {\n const status = Number(digest.split(\";\")[3]);\n return Number.isInteger(status) && status >= 300 ? status : 307;\n }\n if (digest === \"NEXT_NOT_FOUND\") return 404;\n if (digest.startsWith(\"NEXT_HTTP_ERROR_FALLBACK;\")) return Number(digest.split(\";\")[1]) || 404;\n return undefined;\n}\n\nfunction asError(value: unknown): unknown {\n if (typeof value === \"object\" && value !== null) return value;\n return Object.assign(new Error(String(value)), { name: \"NonErrorThrown\", thrown: value });\n}\n\nfunction trySetHeader(res: Response, name: string, value: string): void {\n try {\n res.headers.set(name, value);\n } catch {\n // Some responses (Response.redirect, proxied fetch responses) have immutable headers.\n }\n}\n\n/** Any App Router route handler: `()`, `(request)` or `(request, { params })`. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type RouteHandler = (...args: any[]) => Response | Promise<Response>;\n\n/**\n * Wraps an App Router route handler: request context + one http.request line. The returned\n * function has exactly the handler's parameters, so Next's route type checks still pass.\n */\nexport function withLogging<H extends RouteHandler>(\n log: Logger,\n handler: H,\n opts: WithLoggingOptions = {},\n): (...args: Parameters<H>) => Promise<Awaited<ReturnType<H>>> {\n return async (...args): Promise<Awaited<ReturnType<H>>> => {\n const request: unknown = args[0];\n // Next always passes the request; direct calls in unit tests may not.\n if (!(request instanceof Request)) return (await handler(...args)) as Awaited<ReturnType<H>>;\n const ctx = requestContextFields(request.headers);\n const path = new URL(request.url).pathname;\n const start = performance.now();\n return await runWithStore(ctx, async (store): Promise<Awaited<ReturnType<H>>> => {\n const summary = (status: number, err: unknown) =>\n logHttpRequest(\n log,\n {\n method: request.method,\n route: opts.route,\n path,\n status,\n duration_ms: performance.now() - start,\n err,\n fields: store.fields,\n },\n opts,\n );\n try {\n const res = (await handler(...args)) as Awaited<ReturnType<H>>;\n summary((res as Response).status, store.error);\n trySetHeader(res as Response, \"x-request-id\", ctx.request_id);\n return res;\n } catch (caught) {\n const control = nextControlStatus(caught);\n // Non-objects cannot be marked as logged, so onRequestError would log them again.\n const err = control === undefined ? asError(caught) : caught;\n summary(control ?? 500, control === undefined ? err : store.error);\n throw err;\n }\n });\n };\n}\n\nexport interface NextRequestInfo {\n path?: string;\n method?: string;\n headers?: Record<string, string | string[] | undefined>;\n}\n\nexport interface NextErrorContext {\n routerKind?: string;\n routePath?: string;\n routeType?: string;\n}\n\n/** `export const onRequestError = nextOnRequestError(log)` in instrumentation.ts. */\nexport function nextOnRequestError(log: Logger, opts: HttpLogOptions = {}) {\n return async (err: unknown, request: NextRequestInfo, context: NextErrorContext): Promise<void> => {\n if (isLogged(err) || nextControlStatus(err) !== undefined) return;\n const digest = (err as { digest?: unknown } | null)?.digest;\n logHttpRequest(\n log,\n {\n method: request?.method ?? \"GET\",\n route: context?.routePath,\n path: request?.path ?? \"\",\n status: 500,\n err,\n fields: {\n ...requestContextFields(request?.headers ?? {}),\n next_route_type: context?.routeType,\n next_router_kind: context?.routerKind,\n next_digest: typeof digest === \"string\" ? digest : undefined,\n },\n },\n opts,\n );\n };\n}\n\n/** Call from `register()` in instrumentation.ts. Does nothing on the edge runtime. */\nexport function registerNext(log: Logger, fields?: Fields): void {\n if (process.env.NEXT_RUNTIME && process.env.NEXT_RUNTIME !== \"nodejs\") return;\n // Next keeps serving after an unhandled rejection, so do not exit.\n installProcessHandlers(log, { exitOnCrash: false });\n logStartup(log, { port: process.env.PORT ? Number(process.env.PORT) : undefined, ...fields });\n}\n\nexport interface WithActionOptions {\n /** Request headers source. Defaults to `headers()` from next/headers. */\n headers?: () => HeaderSource | Promise<HeaderSource>;\n}\n\nasync function nextHeaders(): Promise<HeaderSource> {\n try {\n const mod = (await import(\"next/headers\")) as { headers: () => HeaderSource | Promise<HeaderSource> };\n return await mod.headers();\n } catch {\n // Called outside a request (tests, scripts) or Next is not installed.\n return {};\n }\n}\n\n/**\n * Wraps a server action: request context (request_id from x-request-id) plus one\n * `action.completed` / `action.failed` line. redirect()/notFound() count as completed.\n */\nexport function withAction<A extends unknown[], R>(\n log: Logger,\n name: string,\n action: (...args: A) => Promise<R>,\n opts: WithActionOptions = {},\n): (...args: A) => Promise<R> {\n return async (...args) => {\n const headers = await (opts.headers ?? nextHeaders)();\n const start = performance.now();\n return runWithStore({ ...requestContextFields(headers), action_name: name }, async (store) => {\n const fields = () => ({ ...store.fields, duration_ms: Math.round(performance.now() - start) });\n try {\n const result = await action(...args);\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", err: store.error });\n return result;\n } catch (caught) {\n const control = nextControlStatus(caught);\n if (control !== undefined) {\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", next_control_status: control });\n throw caught;\n }\n const err = asError(caught);\n log.error(\"server action failed\", { ...fields(), event: \"action.failed\", err });\n markLogged(err);\n throw err;\n }\n });\n };\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\nimport { globalSingleton } from \"./global\";\nimport type { Fields } from \"./normalize\";\n\nexport interface ContextStore {\n fields: Fields;\n error?: unknown;\n /** Route template captured while the router still knew it (Express error path). */\n route?: string;\n parent?: ContextStore;\n}\n\nconst als = globalSingleton(\"als\", () => new AsyncLocalStorage<ContextStore>());\n\nexport const STORE_KEY: symbol = Symbol.for(\"@tanngo11/log.store\");\n\nexport function runWithStore<T>(fields: Fields, fn: (store: ContextStore) => T): T {\n const parent = als.getStore();\n const store: ContextStore = { fields: { ...parent?.fields, ...fields }, parent };\n return als.run(store, () => fn(store));\n}\n\nexport function withContext<T>(fields: Fields, fn: () => T): T {\n return runWithStore(fields, () => fn());\n}\n\nexport function currentStore(): ContextStore | undefined {\n return als.getStore();\n}\n\nexport function getContext(): Fields {\n return als.getStore()?.fields ?? {};\n}\n\n// Applies to the current context and every enclosing one, so a field added inside a nested\n// withContext/runJob still reaches the request's http.request line.\nexport function addContext(fields: Fields): void {\n for (let s = als.getStore(); s; s = s.parent) Object.assign(s.fields, fields);\n}\n\n// Sets the error on the store and on enclosing stores that have none yet.\nexport function recordErrorIn(store: ContextStore, err: unknown): void {\n store.error = err;\n for (let s = store.parent; s; s = s.parent) if (s.error === undefined) s.error = err;\n}\n\n// Marks the error that the current request/job summary line should carry. Does not write a line.\nexport function recordError(err: unknown): void {\n const store = als.getStore();\n if (store) recordErrorIn(store, err);\n}\n\nexport function attachStore(target: object, store: ContextStore): void {\n (target as Record<symbol, ContextStore>)[STORE_KEY] = store;\n}\n\nexport function storeOf(target: unknown): ContextStore | undefined {\n if (typeof target !== \"object\" || target === null) return undefined;\n return (target as Record<symbol, ContextStore | undefined>)[STORE_KEY];\n}\n","// Singletons shared by every copy of this package loaded in the process (ESM and CJS builds,\n// or duplicated installs), so context and dedupe state never split.\nexport function globalSingleton<T>(name: string, make: () => T): T {\n const key = Symbol.for(`@tanngo11/log.${name}`);\n const g = globalThis as unknown as Record<symbol, T | undefined>;\n let value = g[key];\n if (value === undefined) {\n value = make();\n g[key] = value;\n }\n return value;\n}\n","// Redaction shared by the logger and the error serializer. The collector redacts again,\n// but it cannot see secrets inside JSON-encoded strings, so the app side must catch them.\n\nexport const DEFAULT_REDACT_KEYS = [\n \"password\", \"passwd\", \"pwd\", \"passphrase\", \"secret\", \"client_secret\",\n \"token\", \"access_token\", \"refresh_token\", \"id_token\", \"auth_token\",\n \"api_key\", \"apikey\", \"access_key\", \"secret_key\", \"private_key\",\n \"authorization\", \"cookie\", \"set_cookie\", \"session_id\", \"sessionid\",\n \"credential\", \"credentials\", \"dsn\", \"connection_string\", \"conn_string\", \"jwt\", \"bearer\",\n];\n\n/** Opt-in value patterns for `redactValues`. Not on by default: they can hit ordinary numbers. */\nexport const REDACT_PATTERNS = {\n /** Vietnamese mobile numbers: 0912345678, +84912345678, 84912345678. */\n phoneVN: /(?<![\\d+])(?:\\+?84|0)[35789]\\d{8}(?!\\d)/g,\n /** Visa, Mastercard, Amex, Discover-like card numbers, with optional spaces or dashes. */\n paymentCard: /(?<!\\d)(?:4\\d{3}|5[1-5]\\d{2}|2[2-7]\\d{2}|3[47]\\d{2}|6(?:011|5\\d{2}))(?:[ -]?\\d{4}){2}[ -]?\\d{1,4}(?!\\d)/g,\n /** IPv4 addresses. */\n ipv4: /(?<![\\d.])(?:\\d{1,3}\\.){3}\\d{1,3}(?![\\d.])/g,\n} as const;\n\n// Keys that only describe a secret (count, type, timestamps, flags) stay readable.\nconst SAFE_SUFFIXES = [\"_count\", \"_type\", \"_length\", \"_expires_at\", \"_expires_in\", \"_ttl\", \"_at\", \"_ms\", \"_enabled\"];\n\nexport const REDACTED = \"[REDACTED]\";\n\nexport function toSnakeCase(key: string): string {\n return key\n .replace(/([a-z0-9])([A-Z])/g, \"$1_$2\")\n .replace(/([A-Z]+)([A-Z][a-z])/g, \"$1_$2\")\n .replace(/[^A-Za-z0-9_]+/g, \"_\")\n .toLowerCase();\n}\n\nconst URL_CREDENTIALS_RE = /([a-z][a-z0-9+.-]*:\\/\\/)[^\\s/@:\"']+:[^\\s/@\"']+@/gi;\nconst BEARER_RE = /\\bBearer\\s+[A-Za-z0-9._~+/=-]+/gi;\nconst JWT_RE = /\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+/g;\nconst EMAIL_RE = /[A-Za-z0-9._%+-]+@([A-Za-z0-9-]+(?:\\.[A-Za-z0-9-]+)*\\.[A-Za-z]{2,})/g;\n\nexport type KeyPattern = string | RegExp;\n\nexport interface RedactorOptions {\n /** Extra sensitive keys: names (matched like the defaults) or patterns tested on the snake_case key. */\n keys?: readonly KeyPattern[];\n /** Extra value patterns; every match inside any string becomes [REDACTED]. */\n values?: readonly RegExp[];\n}\n\nexport interface Redactor {\n isSensitive(key: string): boolean;\n /** Masks secrets and emails that appear inside free text. */\n scrub(s: string): string;\n /** JSON.stringify that redacts sensitive keys at any depth and never throws. */\n json(value: unknown): string;\n}\n\nfunction globalize(re: RegExp): RegExp {\n return re.flags.includes(\"g\") ? new RegExp(re.source, re.flags) : new RegExp(re.source, `${re.flags}g`);\n}\n\nexport function createRedactor(opts: RedactorOptions = {}): Redactor {\n const words = [...DEFAULT_REDACT_KEYS];\n const keyPatterns: RegExp[] = [];\n for (const k of opts.keys ?? []) {\n if (typeof k === \"string\") words.push(toSnakeCase(k));\n else keyPatterns.push(new RegExp(k.source, k.flags.replace(\"g\", \"\")));\n }\n const valuePatterns = (opts.values ?? []).map(globalize);\n\n const isSensitive = (key: string): boolean => {\n const k = toSnakeCase(key);\n if (keyPatterns.some((re) => re.test(k))) return true;\n if (!words.includes(k) && SAFE_SUFFIXES.some((s) => k.endsWith(s))) return false;\n return words.some((w) => k === w || k.startsWith(`${w}_`) || k.endsWith(`_${w}`) || k.includes(`_${w}_`));\n };\n\n const scrub = (s: string): string => {\n let out = s\n .replace(URL_CREDENTIALS_RE, `$1${REDACTED}@`)\n .replace(BEARER_RE, `Bearer ${REDACTED}`)\n .replace(JWT_RE, \"[REDACTED_JWT]\")\n .replace(EMAIL_RE, \"***@$1\");\n for (const re of valuePatterns) out = out.replace(re, REDACTED);\n return out;\n };\n\n const json = (value: unknown): string => {\n if (typeof value === \"string\") return value;\n try {\n const text = JSON.stringify(value, (key, val: unknown) => {\n if (key && val !== null && val !== undefined && isSensitive(key)) return REDACTED;\n if (typeof val === \"bigint\") return val.toString();\n if (val instanceof Error) return { name: val.name, message: val.message };\n return val;\n });\n return text ?? String(value);\n } catch {\n return String(value);\n }\n };\n\n return { isSensitive, scrub, json };\n}\n\nexport const defaultRedactor: Redactor = createRedactor();\n","import { globalSingleton } from \"./global\";\nimport { defaultRedactor } from \"./redact\";\n\nexport interface ErrFields {\n err_type?: string;\n err_message?: string;\n err_code?: string;\n err_stack?: string;\n err_cause?: string;\n}\n\nconst MAX_CAUSE_DEPTH = 5;\n\nexport function isErrorLike(v: unknown): v is Error {\n if (v instanceof Error) return true;\n return (\n typeof v === \"object\" &&\n v !== null &&\n typeof (v as { message?: unknown }).message === \"string\" &&\n (\"stack\" in v || \"name\" in v)\n );\n}\n\nfunction errorType(e: Error): string {\n if (e.name && e.name !== \"Error\") return e.name;\n const ctor = (e as { constructor?: { name?: string } }).constructor?.name;\n return ctor && ctor !== \"Object\" ? ctor : \"Error\";\n}\n\nexport function serializeError(err: unknown): ErrFields {\n if (!isErrorLike(err)) {\n if (typeof err === \"string\") return { err_type: \"string\", err_message: err };\n return { err_type: typeof err, err_message: defaultRedactor.json(err) };\n }\n const e = err as Error & { code?: unknown; cause?: unknown };\n const out: ErrFields = { err_type: errorType(e), err_message: String(e.message ?? \"\") };\n if (e.code !== undefined && e.code !== null) out.err_code = String(e.code);\n if (typeof e.stack === \"string\") out.err_stack = e.stack;\n\n const causes: string[] = [];\n let cause = e.cause;\n while (cause !== undefined && cause !== null && causes.length < MAX_CAUSE_DEPTH) {\n if (isErrorLike(cause)) {\n causes.push(`${errorType(cause)}: ${cause.message}`);\n cause = (cause as { cause?: unknown }).cause;\n } else {\n causes.push(defaultRedactor.json(cause));\n cause = undefined;\n }\n }\n if (causes.length > 0) out.err_cause = causes.join(\" <- \");\n return out;\n}\n\nconst logged = globalSingleton(\"logged\", () => new WeakSet<object>());\n\n// Marks an error as already written, so a later boundary (e.g. Next's onRequestError)\n// does not log it a second time.\nexport function markLogged(err: unknown): void {\n if (typeof err === \"object\" && err !== null) logged.add(err);\n}\n\nexport function isLogged(err: unknown): boolean {\n return typeof err === \"object\" && err !== null && logged.has(err);\n}\n","import { isErrorLike, serializeError } from \"./error\";\nimport type { Level } from \"./levels\";\nimport { REDACTED, toSnakeCase, type Redactor } from \"./redact\";\n\nexport { DEFAULT_REDACT_KEYS, toSnakeCase } from \"./redact\";\n\n/** Final per-field hook: return a replacement, or undefined to drop the field. */\nexport type RedactHook = (key: string, value: Primitive) => unknown;\n\nexport type Fields = Record<string, unknown>;\nexport type Primitive = string | number | boolean | null;\nexport type LogRecord = Record<string, Primitive>;\n\nexport interface NormalizeOptions {\n snakeCase: boolean;\n redactor: Redactor;\n hook?: RedactHook;\n}\n\n// Fields the redact hook never sees, so every line keeps its level, message and event.\nconst HOOK_EXEMPT = new Set([\"level\", \"message\", \"event\"]);\n\n// Keys owned by Vector (overwritten or deleted on ingest) or by the logger itself.\nexport const RESERVED_KEYS = new Set([\n \"project\", \"service\", \"vps\", \"version\", \"container_name\", \"container_id\", \"image\", \"stream\",\n \"_timestamp\", \"label\", \"host\", \"source_type\", \"msg\", \"lvl\", \"severity\", \"level\", \"message\",\n]);\n\nexport const MAX_LINE_BYTES = 16000;\nconst MAX_MESSAGE = 500;\nconst MAX_STACK = 4000;\nconst MAX_STRING = 1000;\nconst MAX_DEPTH = 3;\nconst TRUNCATED = \"…[truncated]\";\n\n// Fields kept when a line is too large.\nconst KEEP_ON_SHRINK = new Set([\n \"level\", \"message\", \"event\", \"request_id\", \"trace_id\", \"span_id\", \"job_name\", \"job_id\", \"job_attempt\",\n \"user_id\", \"tenant_id\", \"err_type\", \"err_message\", \"err_code\",\n]);\n\nexport function stripUrl(url: string): string {\n const noQuery = url.split(/[?#]/, 1)[0] ?? \"\";\n return noQuery.replace(/^([a-z][a-z0-9+.-]*:\\/\\/)[^/@\\s]*@/i, \"$1\");\n}\n\nexport function truncate(s: string, max: number): string {\n return s.length > max ? s.slice(0, max - TRUNCATED.length) + TRUNCATED : s;\n}\n\nfunction isPlainObject(v: unknown): v is Fields {\n if (typeof v !== \"object\" || v === null) return false;\n const proto = Object.getPrototypeOf(v);\n return proto === Object.prototype || proto === null;\n}\n\nfunction isUrlKey(key: string): boolean {\n return key === \"http_path\" || key === \"http_url\" || key.endsWith(\"_url\");\n}\n\nfunction flattenInto(out: LogRecord, prefix: string, obj: Fields, depth: number, opts: NormalizeOptions): void {\n for (const [rawKey, value] of Object.entries(obj)) {\n const key = opts.snakeCase ? toSnakeCase(rawKey) : rawKey;\n const full = prefix ? `${prefix}_${key}` : key;\n if (value === undefined || typeof value === \"function\" || typeof value === \"symbol\") continue;\n if (value !== null && (opts.redactor.isSensitive(rawKey) || opts.redactor.isSensitive(full))) {\n out[full] = REDACTED;\n continue;\n }\n if (value === null || typeof value === \"string\" || typeof value === \"boolean\") {\n out[full] = value;\n } else if (typeof value === \"number\") {\n out[full] = Number.isFinite(value) ? value : String(value);\n } else if (typeof value === \"bigint\") {\n out[full] = value.toString();\n } else if (value instanceof Date) {\n out[full] = Number.isNaN(value.getTime()) ? \"Invalid Date\" : value.toISOString();\n } else if (isErrorLike(value)) {\n out[full] = `${value.name}: ${value.message}`;\n } else if (isPlainObject(value) && depth < MAX_DEPTH - 1) {\n flattenInto(out, full, value, depth + 1, opts);\n } else {\n // Arrays, deep objects, class instances: stringified with sensitive keys redacted.\n out[full] = opts.redactor.json(value);\n }\n }\n}\n\nfunction finalize(key: string, value: Primitive, opts: NormalizeOptions): Primitive {\n if (typeof value !== \"string\") return value;\n const v = opts.redactor.scrub(isUrlKey(key) ? stripUrl(value) : value);\n return truncate(v, key === \"err_stack\" ? MAX_STACK : MAX_STRING);\n}\n\nexport function buildRecord(\n level: Level,\n message: unknown,\n sources: (Fields | undefined)[],\n opts: NormalizeOptions,\n): LogRecord {\n const merged: Fields = {};\n for (const source of sources) if (source) Object.assign(merged, source);\n\n let err: unknown;\n if (merged.err !== undefined && merged.err !== null) {\n err = merged.err;\n delete merged.err;\n } else if (isErrorLike(merged.error)) {\n err = merged.error;\n delete merged.error;\n }\n\n const flat: LogRecord = {};\n flattenInto(flat, \"\", merged, 0, opts);\n if (err !== undefined) Object.assign(flat, serializeError(err));\n\n const text = typeof message === \"string\" ? message : opts.redactor.json(message);\n const out: LogRecord = { level, message: truncate(opts.redactor.scrub(text), MAX_MESSAGE) };\n for (const [k, v] of Object.entries(flat)) {\n const key = RESERVED_KEYS.has(k) ? `app_${k}` : k;\n let value = finalize(key, v, opts);\n if (opts.hook && !HOOK_EXEMPT.has(key)) {\n const replaced = opts.hook(key, value);\n if (replaced === undefined) continue;\n value = typeof replaced === \"object\" && replaced !== null ? opts.redactor.json(replaced) : (replaced as Primitive);\n }\n out[key] = value;\n }\n return out;\n}\n\nfunction byteLength(s: string): number {\n // UTF-8 uses at most 3 bytes per UTF-16 code unit: skip encoding short lines.\n if (s.length * 3 <= MAX_LINE_BYTES) return s.length;\n return new TextEncoder().encode(s).length;\n}\n\nexport function serializeRecord(record: LogRecord): string {\n const line = JSON.stringify(record);\n if (byteLength(line) <= MAX_LINE_BYTES) return line;\n const small: LogRecord = {};\n for (const [k, v] of Object.entries(record)) {\n if (KEEP_ON_SHRINK.has(k) || k.startsWith(\"http_\")) small[k] = v;\n }\n small.log_truncated = true;\n return JSON.stringify(small);\n}\n","// No imports: this module is shared with the edge entry (next-edge).\nexport const REQUEST_ID_RE = /^[A-Za-z0-9._-]{1,64}$/;\nconst TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;\n\nexport function newRequestId(): string {\n return globalThis.crypto.randomUUID();\n}\n\nfunction first(header?: string | string[] | null): string | undefined {\n return Array.isArray(header) ? header[0] : (header ?? undefined);\n}\n\nexport function resolveRequestId(header?: string | string[] | null): string {\n const value = first(header);\n return value && REQUEST_ID_RE.test(value) ? value : newRequestId();\n}\n\nexport function parseTraceparent(header?: string | string[] | null): { trace_id: string; span_id: string } | undefined {\n const value = first(header)?.trim().toLowerCase();\n const m = value ? TRACEPARENT_RE.exec(value) : null;\n if (!m) return undefined;\n const [, version, traceId, spanId] = m as unknown as [string, string, string, string];\n if (version === \"ff\" || /^0+$/.test(traceId) || /^0+$/.test(spanId)) return undefined;\n return { trace_id: traceId, span_id: spanId };\n}\n","import { getContext } from \"./context\";\nimport { markLogged, serializeError } from \"./error\";\nimport type { Logger } from \"./logger\";\nimport { stripUrl, type Fields } from \"./normalize\";\nimport { parseTraceparent, resolveRequestId } from \"./request-id\";\n\nexport { newRequestId, parseTraceparent, REQUEST_ID_RE, resolveRequestId } from \"./request-id\";\n\nexport type HeaderSource = Headers | Record<string, string | string[] | undefined>;\n\nfunction header(headers: HeaderSource, name: string): string | string[] | undefined {\n if (typeof (headers as Headers).get === \"function\") return (headers as Headers).get(name) ?? undefined;\n return (headers as Record<string, string | string[] | undefined>)[name];\n}\n\nexport function requestContextFields(headers: HeaderSource): { request_id: string; trace_id?: string; span_id?: string } {\n const out: { request_id: string; trace_id?: string; span_id?: string } = {\n request_id: resolveRequestId(header(headers, \"x-request-id\")),\n };\n const tp = parseTraceparent(header(headers, \"traceparent\"));\n if (tp) Object.assign(out, tp);\n return out;\n}\n\n// Headers to forward to services we own, so their logs share request_id / trace_id.\nexport function propagationHeaders(): Record<string, string> {\n const ctx = getContext();\n const out: Record<string, string> = {};\n if (typeof ctx.request_id === \"string\") out[\"x-request-id\"] = ctx.request_id;\n if (typeof ctx.trace_id === \"string\" && typeof ctx.span_id === \"string\") {\n out.traceparent = `00-${ctx.trace_id}-${ctx.span_id}-01`;\n }\n return out;\n}\n\nexport const DEFAULT_SKIP_PATHS: (string | RegExp)[] = [\n /^\\/(health|healthz|ready|readyz|livez)\\/?$/,\n \"/favicon.ico\",\n /^\\/_next\\/static\\//,\n];\n\nexport interface HttpLogOptions {\n skipPaths?: (string | RegExp)[];\n}\n\nexport interface HttpRequestInfo {\n method: string;\n route?: string;\n path: string;\n status: number;\n duration_ms?: number;\n err?: unknown;\n fields?: Fields;\n}\n\nexport function shouldSkip(method: string, path: string, skipPaths: (string | RegExp)[] = DEFAULT_SKIP_PATHS): boolean {\n if (method.toUpperCase() === \"OPTIONS\") return true;\n const p = stripUrl(path);\n return skipPaths.some((s) => (typeof s === \"string\" ? p === s : s.test(p)));\n}\n\n// Writes the one `http.request` summary line for an inbound request.\nexport function logHttpRequest(log: Logger, info: HttpRequestInfo, opts: HttpLogOptions = {}): void {\n if (shouldSkip(info.method, info.path, opts.skipPaths)) return;\n const level = info.status >= 500 ? \"error\" : info.status >= 400 ? \"warn\" : \"info\";\n const path = stripUrl(info.path);\n const errFields: Fields = {};\n if (info.err !== undefined && info.err !== null) {\n Object.assign(errFields, serializeError(info.err));\n if (info.status < 500) delete errFields.err_stack;\n markLogged(info.err);\n }\n // Route templates keep the message bounded; the raw path would make one message per URL.\n const message = info.route ? `${info.method} ${info.route} ${info.status}` : `${info.method} ${info.status}`;\n log[level](message, {\n ...info.fields,\n event: \"http.request\",\n http_method: info.method,\n http_route: info.route,\n http_path: path,\n http_status: info.status,\n duration_ms: info.duration_ms === undefined ? undefined : Math.round(info.duration_ms),\n ...errFields,\n });\n}\n","import { globalSingleton } from \"./global\";\nimport type { Logger } from \"./logger\";\nimport type { Fields } from \"./normalize\";\n\nexport function logStartup(log: Logger, fields: Fields = {}): void {\n log.info(\"app started\", {\n event: \"app.started\",\n runtime_version: `node ${process.versions.node}`,\n log_level: log.level,\n ...fields,\n });\n}\n\n/** Call at the start of your own shutdown handler (e.g. on SIGTERM). The library never handles signals. */\nexport function logShutdown(log: Logger, fields: Fields = {}): void {\n log.info(\"app stopping\", { event: \"app.stopping\", ...fields });\n}\n\nexport interface ProcessHandlerOptions {\n /** Exit with code 1 after an uncaught error. Next.js keeps serving, so its adapter passes false. */\n exitOnCrash?: boolean;\n /** Time other crash handlers (Sentry, APM) get to flush before exit. Default 1000 ms. */\n exitDelayMs?: number;\n exit?: (code: number) => void;\n}\n\nexport function crashHandlers(log: Logger, opts: ProcessHandlerOptions = {}) {\n const exitOnCrash = opts.exitOnCrash ?? true;\n const exitDelayMs = opts.exitDelayMs ?? 1000;\n const exit = opts.exit ?? ((code: number) => process.exit(code));\n let exiting = false;\n const crash = (source: string, err: unknown) => {\n if (!exitOnCrash) {\n log.error(\"unhandled error\", { event: \"app.unhandled_error\", crash_source: source, err });\n return;\n }\n log.fatal(\"app crashed\", { event: \"app.crashed\", crash_source: source, err });\n if (exiting) return;\n exiting = true;\n if (typeof process !== \"undefined\") process.exitCode = 1;\n // Deferred so listeners registered after ours still run; unref so a process with nothing\n // left to do exits on its own (with exitCode 1) without waiting.\n const timer = setTimeout(() => exit(1), exitDelayMs);\n (timer as { unref?: () => void }).unref?.();\n };\n return {\n onUncaught: (err: unknown) => crash(\"uncaughtException\", err),\n onRejection: (reason: unknown) => crash(\"unhandledRejection\", reason),\n };\n}\n\nconst state = globalSingleton(\"process\", () => ({ installed: false }));\n\n/** Logs uncaught exceptions and unhandled rejections. Does not touch SIGTERM/SIGINT. */\nexport function installProcessHandlers(log: Logger, opts: ProcessHandlerOptions = {}): void {\n if (state.installed || typeof process === \"undefined\" || typeof process.on !== \"function\") return;\n state.installed = true;\n const h = crashHandlers(log, opts);\n process.on(\"uncaughtException\", h.onUncaught);\n process.on(\"unhandledRejection\", h.onRejection);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,8BAAkC;;;ACE3B,SAAS,gBAAmB,MAAc,MAAkB;AACjE,QAAM,MAAM,uBAAO,IAAI,iBAAiB,IAAI,EAAE;AAC9C,QAAM,IAAI;AACV,MAAI,QAAQ,EAAE,GAAG;AACjB,MAAI,UAAU,QAAW;AACvB,YAAQ,KAAK;AACb,MAAE,GAAG,IAAI;AAAA,EACX;AACA,SAAO;AACT;;;ADCA,IAAM,MAAM,gBAAgB,OAAO,MAAM,IAAI,0CAAgC,CAAC;AAIvE,SAAS,aAAgB,QAAgB,IAAmC;AACjF,QAAM,SAAS,IAAI,SAAS;AAC5B,QAAM,QAAsB,EAAE,QAAQ,EAAE,GAAG,QAAQ,QAAQ,GAAG,OAAO,GAAG,OAAO;AAC/E,SAAO,IAAI,IAAI,OAAO,MAAM,GAAG,KAAK,CAAC;AACvC;;;AEjBO,IAAM,sBAAsB;AAAA,EACjC;AAAA,EAAY;AAAA,EAAU;AAAA,EAAO;AAAA,EAAc;AAAA,EAAU;AAAA,EACrD;AAAA,EAAS;AAAA,EAAgB;AAAA,EAAiB;AAAA,EAAY;AAAA,EACtD;AAAA,EAAW;AAAA,EAAU;AAAA,EAAc;AAAA,EAAc;AAAA,EACjD;AAAA,EAAiB;AAAA,EAAU;AAAA,EAAc;AAAA,EAAc;AAAA,EACvD;AAAA,EAAc;AAAA,EAAe;AAAA,EAAO;AAAA,EAAqB;AAAA,EAAe;AAAA,EAAO;AACjF;AAaA,IAAM,gBAAgB,CAAC,UAAU,SAAS,WAAW,eAAe,eAAe,QAAQ,OAAO,OAAO,UAAU;AAE5G,IAAM,WAAW;AAEjB,SAAS,YAAY,KAAqB;AAC/C,SAAO,IACJ,QAAQ,sBAAsB,OAAO,EACrC,QAAQ,yBAAyB,OAAO,EACxC,QAAQ,mBAAmB,GAAG,EAC9B,YAAY;AACjB;AAEA,IAAM,qBAAqB;AAC3B,IAAM,YAAY;AAClB,IAAM,SAAS;AACf,IAAM,WAAW;AAmBjB,SAAS,UAAU,IAAoB;AACrC,SAAO,GAAG,MAAM,SAAS,GAAG,IAAI,IAAI,OAAO,GAAG,QAAQ,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,QAAQ,GAAG,GAAG,KAAK,GAAG;AACxG;AAEO,SAAS,eAAe,OAAwB,CAAC,GAAa;AACnE,QAAM,QAAQ,CAAC,GAAG,mBAAmB;AACrC,QAAM,cAAwB,CAAC;AAC/B,aAAW,KAAK,KAAK,QAAQ,CAAC,GAAG;AAC/B,QAAI,OAAO,MAAM,SAAU,OAAM,KAAK,YAAY,CAAC,CAAC;AAAA,QAC/C,aAAY,KAAK,IAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,KAAK,EAAE,CAAC,CAAC;AAAA,EACtE;AACA,QAAM,iBAAiB,KAAK,UAAU,CAAC,GAAG,IAAI,SAAS;AAEvD,QAAM,cAAc,CAAC,QAAyB;AAC5C,UAAM,IAAI,YAAY,GAAG;AACzB,QAAI,YAAY,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,CAAC,EAAG,QAAO;AACjD,QAAI,CAAC,MAAM,SAAS,CAAC,KAAK,cAAc,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,EAAG,QAAO;AAC3E,WAAO,MAAM,KAAK,CAAC,MAAM,MAAM,KAAK,EAAE,WAAW,GAAG,CAAC,GAAG,KAAK,EAAE,SAAS,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,IAAI,CAAC,GAAG,CAAC;AAAA,EAC1G;AAEA,QAAM,QAAQ,CAAC,MAAsB;AACnC,QAAI,MAAM,EACP,QAAQ,oBAAoB,KAAK,QAAQ,GAAG,EAC5C,QAAQ,WAAW,UAAU,QAAQ,EAAE,EACvC,QAAQ,QAAQ,gBAAgB,EAChC,QAAQ,UAAU,QAAQ;AAC7B,eAAW,MAAM,cAAe,OAAM,IAAI,QAAQ,IAAI,QAAQ;AAC9D,WAAO;AAAA,EACT;AAEA,QAAM,OAAO,CAAC,UAA2B;AACvC,QAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAI;AACF,YAAM,OAAO,KAAK,UAAU,OAAO,CAAC,KAAK,QAAiB;AACxD,YAAI,OAAO,QAAQ,QAAQ,QAAQ,UAAa,YAAY,GAAG,EAAG,QAAO;AACzE,YAAI,OAAO,QAAQ,SAAU,QAAO,IAAI,SAAS;AACjD,YAAI,eAAe,MAAO,QAAO,EAAE,MAAM,IAAI,MAAM,SAAS,IAAI,QAAQ;AACxE,eAAO;AAAA,MACT,CAAC;AACD,aAAO,QAAQ,OAAO,KAAK;AAAA,IAC7B,QAAQ;AACN,aAAO,OAAO,KAAK;AAAA,IACrB;AAAA,EACF;AAEA,SAAO,EAAE,aAAa,OAAO,KAAK;AACpC;AAEO,IAAM,kBAA4B,eAAe;;;AC7FxD,IAAM,kBAAkB;AAEjB,SAAS,YAAY,GAAwB;AAClD,MAAI,aAAa,MAAO,QAAO;AAC/B,SACE,OAAO,MAAM,YACb,MAAM,QACN,OAAQ,EAA4B,YAAY,aAC/C,WAAW,KAAK,UAAU;AAE/B;AAEA,SAAS,UAAU,GAAkB;AACnC,MAAI,EAAE,QAAQ,EAAE,SAAS,QAAS,QAAO,EAAE;AAC3C,QAAM,OAAQ,EAA0C,aAAa;AACrE,SAAO,QAAQ,SAAS,WAAW,OAAO;AAC5C;AAEO,SAAS,eAAe,KAAyB;AACtD,MAAI,CAAC,YAAY,GAAG,GAAG;AACrB,QAAI,OAAO,QAAQ,SAAU,QAAO,EAAE,UAAU,UAAU,aAAa,IAAI;AAC3E,WAAO,EAAE,UAAU,OAAO,KAAK,aAAa,gBAAgB,KAAK,GAAG,EAAE;AAAA,EACxE;AACA,QAAM,IAAI;AACV,QAAM,MAAiB,EAAE,UAAU,UAAU,CAAC,GAAG,aAAa,OAAO,EAAE,WAAW,EAAE,EAAE;AACtF,MAAI,EAAE,SAAS,UAAa,EAAE,SAAS,KAAM,KAAI,WAAW,OAAO,EAAE,IAAI;AACzE,MAAI,OAAO,EAAE,UAAU,SAAU,KAAI,YAAY,EAAE;AAEnD,QAAM,SAAmB,CAAC;AAC1B,MAAI,QAAQ,EAAE;AACd,SAAO,UAAU,UAAa,UAAU,QAAQ,OAAO,SAAS,iBAAiB;AAC/E,QAAI,YAAY,KAAK,GAAG;AACtB,aAAO,KAAK,GAAG,UAAU,KAAK,CAAC,KAAK,MAAM,OAAO,EAAE;AACnD,cAAS,MAA8B;AAAA,IACzC,OAAO;AACL,aAAO,KAAK,gBAAgB,KAAK,KAAK,CAAC;AACvC,cAAQ;AAAA,IACV;AAAA,EACF;AACA,MAAI,OAAO,SAAS,EAAG,KAAI,YAAY,OAAO,KAAK,MAAM;AACzD,SAAO;AACT;AAEA,IAAM,SAAS,gBAAgB,UAAU,MAAM,oBAAI,QAAgB,CAAC;AAI7D,SAAS,WAAW,KAAoB;AAC7C,MAAI,OAAO,QAAQ,YAAY,QAAQ,KAAM,QAAO,IAAI,GAAG;AAC7D;AAEO,SAAS,SAAS,KAAuB;AAC9C,SAAO,OAAO,QAAQ,YAAY,QAAQ,QAAQ,OAAO,IAAI,GAAG;AAClE;;;ACvBO,SAAS,SAAS,KAAqB;AAC5C,QAAM,UAAU,IAAI,MAAM,QAAQ,CAAC,EAAE,CAAC,KAAK;AAC3C,SAAO,QAAQ,QAAQ,uCAAuC,IAAI;AACpE;;;AC3CO,IAAM,gBAAgB;AAC7B,IAAM,iBAAiB;AAEhB,SAAS,eAAuB;AACrC,SAAO,WAAW,OAAO,WAAW;AACtC;AAEA,SAAS,MAAMA,SAAuD;AACpE,SAAO,MAAM,QAAQA,OAAM,IAAIA,QAAO,CAAC,IAAKA,WAAU;AACxD;AAEO,SAAS,iBAAiBA,SAA2C;AAC1E,QAAM,QAAQ,MAAMA,OAAM;AAC1B,SAAO,SAAS,cAAc,KAAK,KAAK,IAAI,QAAQ,aAAa;AACnE;AAEO,SAAS,iBAAiBA,SAAsF;AACrH,QAAM,QAAQ,MAAMA,OAAM,GAAG,KAAK,EAAE,YAAY;AAChD,QAAM,IAAI,QAAQ,eAAe,KAAK,KAAK,IAAI;AAC/C,MAAI,CAAC,EAAG,QAAO;AACf,QAAM,CAAC,EAAE,SAAS,SAAS,MAAM,IAAI;AACrC,MAAI,YAAY,QAAQ,OAAO,KAAK,OAAO,KAAK,OAAO,KAAK,MAAM,EAAG,QAAO;AAC5E,SAAO,EAAE,UAAU,SAAS,SAAS,OAAO;AAC9C;;;ACdA,SAAS,OAAO,SAAuB,MAA6C;AAClF,MAAI,OAAQ,QAAoB,QAAQ,WAAY,QAAQ,QAAoB,IAAI,IAAI,KAAK;AAC7F,SAAQ,QAA0D,IAAI;AACxE;AAEO,SAAS,qBAAqB,SAAoF;AACvH,QAAM,MAAmE;AAAA,IACvE,YAAY,iBAAiB,OAAO,SAAS,cAAc,CAAC;AAAA,EAC9D;AACA,QAAM,KAAK,iBAAiB,OAAO,SAAS,aAAa,CAAC;AAC1D,MAAI,GAAI,QAAO,OAAO,KAAK,EAAE;AAC7B,SAAO;AACT;AAaO,IAAM,qBAA0C;AAAA,EACrD;AAAA,EACA;AAAA,EACA;AACF;AAgBO,SAAS,WAAW,QAAgB,MAAc,YAAiC,oBAA6B;AACrH,MAAI,OAAO,YAAY,MAAM,UAAW,QAAO;AAC/C,QAAM,IAAI,SAAS,IAAI;AACvB,SAAO,UAAU,KAAK,CAAC,MAAO,OAAO,MAAM,WAAW,MAAM,IAAI,EAAE,KAAK,CAAC,CAAE;AAC5E;AAGO,SAAS,eAAe,KAAa,MAAuB,OAAuB,CAAC,GAAS;AAClG,MAAI,WAAW,KAAK,QAAQ,KAAK,MAAM,KAAK,SAAS,EAAG;AACxD,QAAM,QAAQ,KAAK,UAAU,MAAM,UAAU,KAAK,UAAU,MAAM,SAAS;AAC3E,QAAM,OAAO,SAAS,KAAK,IAAI;AAC/B,QAAM,YAAoB,CAAC;AAC3B,MAAI,KAAK,QAAQ,UAAa,KAAK,QAAQ,MAAM;AAC/C,WAAO,OAAO,WAAW,eAAe,KAAK,GAAG,CAAC;AACjD,QAAI,KAAK,SAAS,IAAK,QAAO,UAAU;AACxC,eAAW,KAAK,GAAG;AAAA,EACrB;AAEA,QAAM,UAAU,KAAK,QAAQ,GAAG,KAAK,MAAM,IAAI,KAAK,KAAK,IAAI,KAAK,MAAM,KAAK,GAAG,KAAK,MAAM,IAAI,KAAK,MAAM;AAC1G,MAAI,KAAK,EAAE,SAAS;AAAA,IAClB,GAAG,KAAK;AAAA,IACR,OAAO;AAAA,IACP,aAAa,KAAK;AAAA,IAClB,YAAY,KAAK;AAAA,IACjB,WAAW;AAAA,IACX,aAAa,KAAK;AAAA,IAClB,aAAa,KAAK,gBAAgB,SAAY,SAAY,KAAK,MAAM,KAAK,WAAW;AAAA,IACrF,GAAG;AAAA,EACL,CAAC;AACH;;;AChFO,SAAS,WAAW,KAAa,SAAiB,CAAC,GAAS;AACjE,MAAI,KAAK,eAAe;AAAA,IACtB,OAAO;AAAA,IACP,iBAAiB,QAAQ,QAAQ,SAAS,IAAI;AAAA,IAC9C,WAAW,IAAI;AAAA,IACf,GAAG;AAAA,EACL,CAAC;AACH;AAeO,SAAS,cAAc,KAAa,OAA8B,CAAC,GAAG;AAC3E,QAAM,cAAc,KAAK,eAAe;AACxC,QAAM,cAAc,KAAK,eAAe;AACxC,QAAM,OAAO,KAAK,SAAS,CAAC,SAAiB,QAAQ,KAAK,IAAI;AAC9D,MAAI,UAAU;AACd,QAAM,QAAQ,CAAC,QAAgB,QAAiB;AAC9C,QAAI,CAAC,aAAa;AAChB,UAAI,MAAM,mBAAmB,EAAE,OAAO,uBAAuB,cAAc,QAAQ,IAAI,CAAC;AACxF;AAAA,IACF;AACA,QAAI,MAAM,eAAe,EAAE,OAAO,eAAe,cAAc,QAAQ,IAAI,CAAC;AAC5E,QAAI,QAAS;AACb,cAAU;AACV,QAAI,OAAO,YAAY,YAAa,SAAQ,WAAW;AAGvD,UAAM,QAAQ,WAAW,MAAM,KAAK,CAAC,GAAG,WAAW;AACnD,IAAC,MAAiC,QAAQ;AAAA,EAC5C;AACA,SAAO;AAAA,IACL,YAAY,CAAC,QAAiB,MAAM,qBAAqB,GAAG;AAAA,IAC5D,aAAa,CAAC,WAAoB,MAAM,sBAAsB,MAAM;AAAA,EACtE;AACF;AAEA,IAAM,QAAQ,gBAAgB,WAAW,OAAO,EAAE,WAAW,MAAM,EAAE;AAG9D,SAAS,uBAAuB,KAAa,OAA8B,CAAC,GAAS;AAC1F,MAAI,MAAM,aAAa,OAAO,YAAY,eAAe,OAAO,QAAQ,OAAO,WAAY;AAC3F,QAAM,YAAY;AAClB,QAAM,IAAI,cAAc,KAAK,IAAI;AACjC,UAAQ,GAAG,qBAAqB,EAAE,UAAU;AAC5C,UAAQ,GAAG,sBAAsB,EAAE,WAAW;AAChD;;;AR/CO,SAAS,kBAAkB,KAAkC;AAClE,QAAM,SAAU,KAAqC;AACrD,MAAI,OAAO,WAAW,SAAU,QAAO;AACvC,MAAI,OAAO,WAAW,eAAe,GAAG;AACtC,UAAM,SAAS,OAAO,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC;AAC1C,WAAO,OAAO,UAAU,MAAM,KAAK,UAAU,MAAM,SAAS;AAAA,EAC9D;AACA,MAAI,WAAW,iBAAkB,QAAO;AACxC,MAAI,OAAO,WAAW,2BAA2B,EAAG,QAAO,OAAO,OAAO,MAAM,GAAG,EAAE,CAAC,CAAC,KAAK;AAC3F,SAAO;AACT;AAEA,SAAS,QAAQ,OAAyB;AACxC,MAAI,OAAO,UAAU,YAAY,UAAU,KAAM,QAAO;AACxD,SAAO,OAAO,OAAO,IAAI,MAAM,OAAO,KAAK,CAAC,GAAG,EAAE,MAAM,kBAAkB,QAAQ,MAAM,CAAC;AAC1F;AAEA,SAAS,aAAa,KAAe,MAAc,OAAqB;AACtE,MAAI;AACF,QAAI,QAAQ,IAAI,MAAM,KAAK;AAAA,EAC7B,QAAQ;AAAA,EAER;AACF;AAUO,SAAS,YACd,KACA,SACA,OAA2B,CAAC,GACiC;AAC7D,SAAO,UAAU,SAA0C;AACzD,UAAM,UAAmB,KAAK,CAAC;AAE/B,QAAI,EAAE,mBAAmB,SAAU,QAAQ,MAAM,QAAQ,GAAG,IAAI;AAChE,UAAM,MAAM,qBAAqB,QAAQ,OAAO;AAChD,UAAM,OAAO,IAAI,IAAI,QAAQ,GAAG,EAAE;AAClC,UAAM,QAAQ,YAAY,IAAI;AAC9B,WAAO,MAAM,aAAa,KAAK,OAAO,UAA2C;AAC/E,YAAM,UAAU,CAAC,QAAgB,QAC/B;AAAA,QACE;AAAA,QACA;AAAA,UACE,QAAQ,QAAQ;AAAA,UAChB,OAAO,KAAK;AAAA,UACZ;AAAA,UACA;AAAA,UACA,aAAa,YAAY,IAAI,IAAI;AAAA,UACjC;AAAA,UACA,QAAQ,MAAM;AAAA,QAChB;AAAA,QACA;AAAA,MACF;AACF,UAAI;AACF,cAAM,MAAO,MAAM,QAAQ,GAAG,IAAI;AAClC,gBAAS,IAAiB,QAAQ,MAAM,KAAK;AAC7C,qBAAa,KAAiB,gBAAgB,IAAI,UAAU;AAC5D,eAAO;AAAA,MACT,SAAS,QAAQ;AACf,cAAM,UAAU,kBAAkB,MAAM;AAExC,cAAM,MAAM,YAAY,SAAY,QAAQ,MAAM,IAAI;AACtD,gBAAQ,WAAW,KAAK,YAAY,SAAY,MAAM,MAAM,KAAK;AACjE,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AACF;AAeO,SAAS,mBAAmB,KAAa,OAAuB,CAAC,GAAG;AACzE,SAAO,OAAO,KAAc,SAA0B,YAA6C;AACjG,QAAI,SAAS,GAAG,KAAK,kBAAkB,GAAG,MAAM,OAAW;AAC3D,UAAM,SAAU,KAAqC;AACrD;AAAA,MACE;AAAA,MACA;AAAA,QACE,QAAQ,SAAS,UAAU;AAAA,QAC3B,OAAO,SAAS;AAAA,QAChB,MAAM,SAAS,QAAQ;AAAA,QACvB,QAAQ;AAAA,QACR;AAAA,QACA,QAAQ;AAAA,UACN,GAAG,qBAAqB,SAAS,WAAW,CAAC,CAAC;AAAA,UAC9C,iBAAiB,SAAS;AAAA,UAC1B,kBAAkB,SAAS;AAAA,UAC3B,aAAa,OAAO,WAAW,WAAW,SAAS;AAAA,QACrD;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAGO,SAAS,aAAa,KAAa,QAAuB;AAC/D,MAAI,QAAQ,IAAI,gBAAgB,QAAQ,IAAI,iBAAiB,SAAU;AAEvE,yBAAuB,KAAK,EAAE,aAAa,MAAM,CAAC;AAClD,aAAW,KAAK,EAAE,MAAM,QAAQ,IAAI,OAAO,OAAO,QAAQ,IAAI,IAAI,IAAI,QAAW,GAAG,OAAO,CAAC;AAC9F;AAOA,eAAe,cAAqC;AAClD,MAAI;AACF,UAAM,MAAO,MAAM,OAAO,cAAc;AACxC,WAAO,MAAM,IAAI,QAAQ;AAAA,EAC3B,QAAQ;AAEN,WAAO,CAAC;AAAA,EACV;AACF;AAMO,SAAS,WACd,KACA,MACA,QACA,OAA0B,CAAC,GACC;AAC5B,SAAO,UAAU,SAAS;AACxB,UAAM,UAAU,OAAO,KAAK,WAAW,aAAa;AACpD,UAAM,QAAQ,YAAY,IAAI;AAC9B,WAAO,aAAa,EAAE,GAAG,qBAAqB,OAAO,GAAG,aAAa,KAAK,GAAG,OAAO,UAAU;AAC5F,YAAM,SAAS,OAAO,EAAE,GAAG,MAAM,QAAQ,aAAa,KAAK,MAAM,YAAY,IAAI,IAAI,KAAK,EAAE;AAC5F,UAAI;AACF,cAAM,SAAS,MAAM,OAAO,GAAG,IAAI;AACnC,YAAI,KAAK,2BAA2B,EAAE,GAAG,OAAO,GAAG,OAAO,oBAAoB,KAAK,MAAM,MAAM,CAAC;AAChG,eAAO;AAAA,MACT,SAAS,QAAQ;AACf,cAAM,UAAU,kBAAkB,MAAM;AACxC,YAAI,YAAY,QAAW;AACzB,cAAI,KAAK,2BAA2B,EAAE,GAAG,OAAO,GAAG,OAAO,oBAAoB,qBAAqB,QAAQ,CAAC;AAC5G,gBAAM;AAAA,QACR;AACA,cAAM,MAAM,QAAQ,MAAM;AAC1B,YAAI,MAAM,wBAAwB,EAAE,GAAG,OAAO,GAAG,OAAO,iBAAiB,IAAI,CAAC;AAC9E,mBAAW,GAAG;AACd,cAAM;AAAA,MACR;AAAA,IACF,CAAC;AAAA,EACH;AACF;","names":["header"]}
package/dist/next.d.cts CHANGED
@@ -7,8 +7,13 @@ interface WithLoggingOptions extends HttpLogOptions {
7
7
  }
8
8
  /** Status for Next's control-flow errors (redirect(), notFound(), forbidden()...), else undefined. */
9
9
  declare function nextControlStatus(err: unknown): number | undefined;
10
- /** Wraps an App Router route handler: request context + one http.request line. */
11
- declare function withLogging<R extends Request, C>(log: Logger, handler: (request: R, context: C) => Response | Promise<Response>, opts?: WithLoggingOptions): (request: R, context: C) => Promise<Response>;
10
+ /** Any App Router route handler: `()`, `(request)` or `(request, { params })`. */
11
+ type RouteHandler = (...args: any[]) => Response | Promise<Response>;
12
+ /**
13
+ * Wraps an App Router route handler: request context + one http.request line. The returned
14
+ * function has exactly the handler's parameters, so Next's route type checks still pass.
15
+ */
16
+ declare function withLogging<H extends RouteHandler>(log: Logger, handler: H, opts?: WithLoggingOptions): (...args: Parameters<H>) => Promise<Awaited<ReturnType<H>>>;
12
17
  interface NextRequestInfo {
13
18
  path?: string;
14
19
  method?: string;
@@ -33,4 +38,4 @@ interface WithActionOptions {
33
38
  */
34
39
  declare function withAction<A extends unknown[], R>(log: Logger, name: string, action: (...args: A) => Promise<R>, opts?: WithActionOptions): (...args: A) => Promise<R>;
35
40
 
36
- export { type NextErrorContext, type NextRequestInfo, type WithActionOptions, type WithLoggingOptions, nextControlStatus, nextOnRequestError, registerNext, withAction, withLogging };
41
+ export { type NextErrorContext, type NextRequestInfo, type RouteHandler, type WithActionOptions, type WithLoggingOptions, nextControlStatus, nextOnRequestError, registerNext, withAction, withLogging };
package/dist/next.d.ts CHANGED
@@ -7,8 +7,13 @@ interface WithLoggingOptions extends HttpLogOptions {
7
7
  }
8
8
  /** Status for Next's control-flow errors (redirect(), notFound(), forbidden()...), else undefined. */
9
9
  declare function nextControlStatus(err: unknown): number | undefined;
10
- /** Wraps an App Router route handler: request context + one http.request line. */
11
- declare function withLogging<R extends Request, C>(log: Logger, handler: (request: R, context: C) => Response | Promise<Response>, opts?: WithLoggingOptions): (request: R, context: C) => Promise<Response>;
10
+ /** Any App Router route handler: `()`, `(request)` or `(request, { params })`. */
11
+ type RouteHandler = (...args: any[]) => Response | Promise<Response>;
12
+ /**
13
+ * Wraps an App Router route handler: request context + one http.request line. The returned
14
+ * function has exactly the handler's parameters, so Next's route type checks still pass.
15
+ */
16
+ declare function withLogging<H extends RouteHandler>(log: Logger, handler: H, opts?: WithLoggingOptions): (...args: Parameters<H>) => Promise<Awaited<ReturnType<H>>>;
12
17
  interface NextRequestInfo {
13
18
  path?: string;
14
19
  method?: string;
@@ -33,4 +38,4 @@ interface WithActionOptions {
33
38
  */
34
39
  declare function withAction<A extends unknown[], R>(log: Logger, name: string, action: (...args: A) => Promise<R>, opts?: WithActionOptions): (...args: A) => Promise<R>;
35
40
 
36
- export { type NextErrorContext, type NextRequestInfo, type WithActionOptions, type WithLoggingOptions, nextControlStatus, nextOnRequestError, registerNext, withAction, withLogging };
41
+ export { type NextErrorContext, type NextRequestInfo, type RouteHandler, type WithActionOptions, type WithLoggingOptions, nextControlStatus, nextOnRequestError, registerNext, withAction, withLogging };
package/dist/next.js CHANGED
@@ -36,11 +36,13 @@ function trySetHeader(res, name, value) {
36
36
  }
37
37
  }
38
38
  function withLogging(log, handler, opts = {}) {
39
- return (request, context) => {
39
+ return async (...args) => {
40
+ const request = args[0];
41
+ if (!(request instanceof Request)) return await handler(...args);
40
42
  const ctx = requestContextFields(request.headers);
41
43
  const path = new URL(request.url).pathname;
42
44
  const start = performance.now();
43
- return runWithStore(ctx, async (store) => {
45
+ return await runWithStore(ctx, async (store) => {
44
46
  const summary = (status, err) => logHttpRequest(
45
47
  log,
46
48
  {
@@ -55,7 +57,7 @@ function withLogging(log, handler, opts = {}) {
55
57
  opts
56
58
  );
57
59
  try {
58
- const res = await handler(request, context);
60
+ const res = await handler(...args);
59
61
  summary(res.status, store.error);
60
62
  trySetHeader(res, "x-request-id", ctx.request_id);
61
63
  return res;
package/dist/next.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/next.ts"],"sourcesContent":["import { runWithStore } from \"./context\";\nimport { isLogged, markLogged } from \"./error\";\nimport { logHttpRequest, requestContextFields, type HeaderSource, type HttpLogOptions } from \"./http\";\nimport type { Logger } from \"./logger\";\nimport type { Fields } from \"./normalize\";\nimport { installProcessHandlers, logStartup } from \"./process\";\n\nexport interface WithLoggingOptions extends HttpLogOptions {\n /** Route template, e.g. \"/api/orders/[id]\". Left empty when not given. */\n route?: string;\n}\n\n/** Status for Next's control-flow errors (redirect(), notFound(), forbidden()...), else undefined. */\nexport function nextControlStatus(err: unknown): number | undefined {\n const digest = (err as { digest?: unknown } | null)?.digest;\n if (typeof digest !== \"string\") return undefined;\n if (digest.startsWith(\"NEXT_REDIRECT\")) {\n const status = Number(digest.split(\";\")[3]);\n return Number.isInteger(status) && status >= 300 ? status : 307;\n }\n if (digest === \"NEXT_NOT_FOUND\") return 404;\n if (digest.startsWith(\"NEXT_HTTP_ERROR_FALLBACK;\")) return Number(digest.split(\";\")[1]) || 404;\n return undefined;\n}\n\nfunction asError(value: unknown): unknown {\n if (typeof value === \"object\" && value !== null) return value;\n return Object.assign(new Error(String(value)), { name: \"NonErrorThrown\", thrown: value });\n}\n\nfunction trySetHeader(res: Response, name: string, value: string): void {\n try {\n res.headers.set(name, value);\n } catch {\n // Some responses (Response.redirect, proxied fetch responses) have immutable headers.\n }\n}\n\n/** Wraps an App Router route handler: request context + one http.request line. */\nexport function withLogging<R extends Request, C>(\n log: Logger,\n handler: (request: R, context: C) => Response | Promise<Response>,\n opts: WithLoggingOptions = {},\n): (request: R, context: C) => Promise<Response> {\n return (request, context) => {\n const ctx = requestContextFields(request.headers);\n const path = new URL(request.url).pathname;\n const start = performance.now();\n return runWithStore(ctx, async (store) => {\n const summary = (status: number, err: unknown) =>\n logHttpRequest(\n log,\n {\n method: request.method,\n route: opts.route,\n path,\n status,\n duration_ms: performance.now() - start,\n err,\n fields: store.fields,\n },\n opts,\n );\n try {\n const res = await handler(request, context);\n summary(res.status, store.error);\n trySetHeader(res, \"x-request-id\", ctx.request_id);\n return res;\n } catch (caught) {\n const control = nextControlStatus(caught);\n // Non-objects cannot be marked as logged, so onRequestError would log them again.\n const err = control === undefined ? asError(caught) : caught;\n summary(control ?? 500, control === undefined ? err : store.error);\n throw err;\n }\n });\n };\n}\n\nexport interface NextRequestInfo {\n path?: string;\n method?: string;\n headers?: Record<string, string | string[] | undefined>;\n}\n\nexport interface NextErrorContext {\n routerKind?: string;\n routePath?: string;\n routeType?: string;\n}\n\n/** `export const onRequestError = nextOnRequestError(log)` in instrumentation.ts. */\nexport function nextOnRequestError(log: Logger, opts: HttpLogOptions = {}) {\n return async (err: unknown, request: NextRequestInfo, context: NextErrorContext): Promise<void> => {\n if (isLogged(err) || nextControlStatus(err) !== undefined) return;\n const digest = (err as { digest?: unknown } | null)?.digest;\n logHttpRequest(\n log,\n {\n method: request?.method ?? \"GET\",\n route: context?.routePath,\n path: request?.path ?? \"\",\n status: 500,\n err,\n fields: {\n ...requestContextFields(request?.headers ?? {}),\n next_route_type: context?.routeType,\n next_router_kind: context?.routerKind,\n next_digest: typeof digest === \"string\" ? digest : undefined,\n },\n },\n opts,\n );\n };\n}\n\n/** Call from `register()` in instrumentation.ts. Does nothing on the edge runtime. */\nexport function registerNext(log: Logger, fields?: Fields): void {\n if (process.env.NEXT_RUNTIME && process.env.NEXT_RUNTIME !== \"nodejs\") return;\n // Next keeps serving after an unhandled rejection, so do not exit.\n installProcessHandlers(log, { exitOnCrash: false });\n logStartup(log, { port: process.env.PORT ? Number(process.env.PORT) : undefined, ...fields });\n}\n\nexport interface WithActionOptions {\n /** Request headers source. Defaults to `headers()` from next/headers. */\n headers?: () => HeaderSource | Promise<HeaderSource>;\n}\n\nasync function nextHeaders(): Promise<HeaderSource> {\n try {\n const mod = (await import(\"next/headers\")) as { headers: () => HeaderSource | Promise<HeaderSource> };\n return await mod.headers();\n } catch {\n // Called outside a request (tests, scripts) or Next is not installed.\n return {};\n }\n}\n\n/**\n * Wraps a server action: request context (request_id from x-request-id) plus one\n * `action.completed` / `action.failed` line. redirect()/notFound() count as completed.\n */\nexport function withAction<A extends unknown[], R>(\n log: Logger,\n name: string,\n action: (...args: A) => Promise<R>,\n opts: WithActionOptions = {},\n): (...args: A) => Promise<R> {\n return async (...args) => {\n const headers = await (opts.headers ?? nextHeaders)();\n const start = performance.now();\n return runWithStore({ ...requestContextFields(headers), action_name: name }, async (store) => {\n const fields = () => ({ ...store.fields, duration_ms: Math.round(performance.now() - start) });\n try {\n const result = await action(...args);\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", err: store.error });\n return result;\n } catch (caught) {\n const control = nextControlStatus(caught);\n if (control !== undefined) {\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", next_control_status: control });\n throw caught;\n }\n const err = asError(caught);\n log.error(\"server action failed\", { ...fields(), event: \"action.failed\", err });\n markLogged(err);\n throw err;\n }\n });\n };\n}\n"],"mappings":"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","names":[]}
1
+ {"version":3,"sources":["../src/next.ts"],"sourcesContent":["import { runWithStore } from \"./context\";\nimport { isLogged, markLogged } from \"./error\";\nimport { logHttpRequest, requestContextFields, type HeaderSource, type HttpLogOptions } from \"./http\";\nimport type { Logger } from \"./logger\";\nimport type { Fields } from \"./normalize\";\nimport { installProcessHandlers, logStartup } from \"./process\";\n\nexport interface WithLoggingOptions extends HttpLogOptions {\n /** Route template, e.g. \"/api/orders/[id]\". Left empty when not given. */\n route?: string;\n}\n\n/** Status for Next's control-flow errors (redirect(), notFound(), forbidden()...), else undefined. */\nexport function nextControlStatus(err: unknown): number | undefined {\n const digest = (err as { digest?: unknown } | null)?.digest;\n if (typeof digest !== \"string\") return undefined;\n if (digest.startsWith(\"NEXT_REDIRECT\")) {\n const status = Number(digest.split(\";\")[3]);\n return Number.isInteger(status) && status >= 300 ? status : 307;\n }\n if (digest === \"NEXT_NOT_FOUND\") return 404;\n if (digest.startsWith(\"NEXT_HTTP_ERROR_FALLBACK;\")) return Number(digest.split(\";\")[1]) || 404;\n return undefined;\n}\n\nfunction asError(value: unknown): unknown {\n if (typeof value === \"object\" && value !== null) return value;\n return Object.assign(new Error(String(value)), { name: \"NonErrorThrown\", thrown: value });\n}\n\nfunction trySetHeader(res: Response, name: string, value: string): void {\n try {\n res.headers.set(name, value);\n } catch {\n // Some responses (Response.redirect, proxied fetch responses) have immutable headers.\n }\n}\n\n/** Any App Router route handler: `()`, `(request)` or `(request, { params })`. */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type RouteHandler = (...args: any[]) => Response | Promise<Response>;\n\n/**\n * Wraps an App Router route handler: request context + one http.request line. The returned\n * function has exactly the handler's parameters, so Next's route type checks still pass.\n */\nexport function withLogging<H extends RouteHandler>(\n log: Logger,\n handler: H,\n opts: WithLoggingOptions = {},\n): (...args: Parameters<H>) => Promise<Awaited<ReturnType<H>>> {\n return async (...args): Promise<Awaited<ReturnType<H>>> => {\n const request: unknown = args[0];\n // Next always passes the request; direct calls in unit tests may not.\n if (!(request instanceof Request)) return (await handler(...args)) as Awaited<ReturnType<H>>;\n const ctx = requestContextFields(request.headers);\n const path = new URL(request.url).pathname;\n const start = performance.now();\n return await runWithStore(ctx, async (store): Promise<Awaited<ReturnType<H>>> => {\n const summary = (status: number, err: unknown) =>\n logHttpRequest(\n log,\n {\n method: request.method,\n route: opts.route,\n path,\n status,\n duration_ms: performance.now() - start,\n err,\n fields: store.fields,\n },\n opts,\n );\n try {\n const res = (await handler(...args)) as Awaited<ReturnType<H>>;\n summary((res as Response).status, store.error);\n trySetHeader(res as Response, \"x-request-id\", ctx.request_id);\n return res;\n } catch (caught) {\n const control = nextControlStatus(caught);\n // Non-objects cannot be marked as logged, so onRequestError would log them again.\n const err = control === undefined ? asError(caught) : caught;\n summary(control ?? 500, control === undefined ? err : store.error);\n throw err;\n }\n });\n };\n}\n\nexport interface NextRequestInfo {\n path?: string;\n method?: string;\n headers?: Record<string, string | string[] | undefined>;\n}\n\nexport interface NextErrorContext {\n routerKind?: string;\n routePath?: string;\n routeType?: string;\n}\n\n/** `export const onRequestError = nextOnRequestError(log)` in instrumentation.ts. */\nexport function nextOnRequestError(log: Logger, opts: HttpLogOptions = {}) {\n return async (err: unknown, request: NextRequestInfo, context: NextErrorContext): Promise<void> => {\n if (isLogged(err) || nextControlStatus(err) !== undefined) return;\n const digest = (err as { digest?: unknown } | null)?.digest;\n logHttpRequest(\n log,\n {\n method: request?.method ?? \"GET\",\n route: context?.routePath,\n path: request?.path ?? \"\",\n status: 500,\n err,\n fields: {\n ...requestContextFields(request?.headers ?? {}),\n next_route_type: context?.routeType,\n next_router_kind: context?.routerKind,\n next_digest: typeof digest === \"string\" ? digest : undefined,\n },\n },\n opts,\n );\n };\n}\n\n/** Call from `register()` in instrumentation.ts. Does nothing on the edge runtime. */\nexport function registerNext(log: Logger, fields?: Fields): void {\n if (process.env.NEXT_RUNTIME && process.env.NEXT_RUNTIME !== \"nodejs\") return;\n // Next keeps serving after an unhandled rejection, so do not exit.\n installProcessHandlers(log, { exitOnCrash: false });\n logStartup(log, { port: process.env.PORT ? Number(process.env.PORT) : undefined, ...fields });\n}\n\nexport interface WithActionOptions {\n /** Request headers source. Defaults to `headers()` from next/headers. */\n headers?: () => HeaderSource | Promise<HeaderSource>;\n}\n\nasync function nextHeaders(): Promise<HeaderSource> {\n try {\n const mod = (await import(\"next/headers\")) as { headers: () => HeaderSource | Promise<HeaderSource> };\n return await mod.headers();\n } catch {\n // Called outside a request (tests, scripts) or Next is not installed.\n return {};\n }\n}\n\n/**\n * Wraps a server action: request context (request_id from x-request-id) plus one\n * `action.completed` / `action.failed` line. redirect()/notFound() count as completed.\n */\nexport function withAction<A extends unknown[], R>(\n log: Logger,\n name: string,\n action: (...args: A) => Promise<R>,\n opts: WithActionOptions = {},\n): (...args: A) => Promise<R> {\n return async (...args) => {\n const headers = await (opts.headers ?? nextHeaders)();\n const start = performance.now();\n return runWithStore({ ...requestContextFields(headers), action_name: name }, async (store) => {\n const fields = () => ({ ...store.fields, duration_ms: Math.round(performance.now() - start) });\n try {\n const result = await action(...args);\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", err: store.error });\n return result;\n } catch (caught) {\n const control = nextControlStatus(caught);\n if (control !== undefined) {\n log.info(\"server action completed\", { ...fields(), event: \"action.completed\", next_control_status: control });\n throw caught;\n }\n const err = asError(caught);\n log.error(\"server action failed\", { ...fields(), event: \"action.failed\", err });\n markLogged(err);\n throw err;\n }\n });\n };\n}\n"],"mappings":"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","names":[]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@tanngo11/log",
3
- "version": "0.4.0",
3
+ "version": "0.4.2",
4
4
  "description": "Structured JSON logging for Node services, implementing log contract v1",
5
5
  "license": "MIT",
6
6
  "repository": {
@@ -112,7 +112,8 @@
112
112
  "types": "./dist/strapi.d.cts",
113
113
  "default": "./dist/strapi.cjs"
114
114
  }
115
- }
115
+ },
116
+ "./package.json": "./package.json"
116
117
  },
117
118
  "scripts": {
118
119
  "build": "tsup",