jsonl-logger 0.2.3 → 0.4.0

package/README.md

@@ -1,3 +1,8 @@
+[![Monthly Downloads](https://img.shields.io/npm/dm/jsonl-logger.svg)](https://www.npmjs.com/package/jsonl-logger)
+[![NPM](https://img.shields.io/npm/v/jsonl-logger.svg 'NPM package version')](https://www.npmjs.com/package/jsonl-logger)
+[![CI](https://github.com/annexare/jsonl-logger/actions/workflows/ci.yml/badge.svg)](https://github.com/annexare/jsonl-logger/actions/workflows/ci.yml)
+
+
 # JSONL Logger
 
 Lightweight JSON Lines logger with pluggable formatters (**Google Cloud Logging**, **VictoriaLogs**). Modern **ESM**-only, zero dependencies, Bun-first, works on Node.js and Deno.
@@ -78,6 +83,58 @@ console.log('plain text') // → structured JSON
 originalConsole.log('bypass interception')
 ```
 
+## OpenTelemetry
+
+The logger supports automatic trace context injection. Supply a `traceContext` getter that returns the active span's trace/span IDs — the formatter maps them to platform-specific fields automatically.
+
+### With `@opentelemetry/api`
+
+```typescript
+import { trace } from '@opentelemetry/api'
+import { Logger } from 'jsonl-logger'
+
+const logger = new Logger({}, {
+  traceContext: () => {
+    const span = trace.getActiveSpan()
+    if (!span) return undefined
+    const { traceId, spanId, traceFlags } = span.spanContext()
+    return { traceId, spanId, traceFlags }
+  },
+})
+
+logger.info('request handled', { path: '/api' })
+// GCL output includes "logging.googleapis.com/trace", "logging.googleapis.com/spanId", etc.
+// VictoriaLogs output includes "trace_id", "span_id", etc.
+```
+
+### Custom trace context
+
+```typescript
+const logger = new Logger({}, {
+  traceContext: () => ({
+    traceId: myTracer.currentTraceId(),
+    spanId: myTracer.currentSpanId(),
+  }),
+})
+```
+
+The `traceContext` option is also available on `intercept()`:
+
+```typescript
+import { intercept } from 'jsonl-logger/intercept'
+
+intercept({
+  traceContext: () => {
+    const span = trace.getActiveSpan()
+    if (!span) return undefined
+    const { traceId, spanId, traceFlags } = span.spanContext()
+    return { traceId, spanId, traceFlags }
+  },
+})
+```
+
+Child loggers inherit the `traceContext` getter from their parent.
+
 ## Next.js Integration
 
 The preload module reads `LOG_FORMAT` and only activates when it's set. Safe to include unconditionally — it's a no-op without `LOG_FORMAT`.
@@ -122,6 +179,49 @@ requestLogger.info('Processing request')
 // All entries include requestId and service
 ```
 
+## Error Handling
+
+Errors passed to `error()` / `fatal()` capture the full stack trace and `error.cause` chain:
+
+```typescript
+const inner = new Error('ECONNREFUSED')
+const outer = new Error('fetch failed', { cause: inner })
+logger.error('API call failed', { endpoint: '/users' }, outer)
+```
+
+**Dev mode** (no `LOG_FORMAT`) — colored plain text with full stack:
+```
+18:42:05 ERROR API call failed {"endpoint":"/users"}
+Error: fetch failed
+    at handler (/app/api/route.ts:42:5)
+Caused by: Error: ECONNREFUSED
+    at connect (/app/db.ts:10:3)
+```
+
+**Production** (`LOG_FORMAT` set) — structured JSON with `error.*` and `error.cause.*` fields:
+```json
+{
+  "message": "API call failed",
+  "severity": "ERROR",
+  "endpoint": "/users",
+  "error.name": "Error",
+  "error.message": "fetch failed",
+  "error.stack": "Error: fetch failed\n    at handler ...",
+  "error.cause.name": "Error",
+  "error.cause.message": "ECONNREFUSED",
+  "error.cause.stack": "Error: ECONNREFUSED\n    at connect ..."
+}
+```
+
+The `errorInfo()` helper is exported for use in custom formatters:
+
+```typescript
+import { errorInfo } from 'jsonl-logger'
+
+const info = errorInfo(caughtError)
+// { name, message, stack, cause?: { name, message, stack, cause?: ... } }
+```
+
 ## Environment Variables
 
 | Variable | Default | Description |
@@ -140,7 +240,7 @@ The logger auto-detects the runtime and uses the fastest available I/O:
 
 | Subpath | Export |
 |---------|--------|
-| `jsonl-logger` | `Logger`, `logger`, types |
+| `jsonl-logger` | `Logger`, `logger`, `errorInfo()`, types (`ErrorInfo`, `LogRecord`, `TraceContext`, etc.) |
 | `jsonl-logger/google-cloud-logging` | `GoogleCloudLogging` formatter |
 | `jsonl-logger/victoria-logs` | `VictoriaLogs` formatter |
 | `jsonl-logger/intercept` | `intercept()`, `originalConsole` |

package/dist/google-cloud-logging.js

@@ -1 +1 @@
-var t={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},o={messageKey:"message",format(e){let r={message:e.message,timestamp:e.timestamp,severity:t[e.level],...e.context};if(e.error){if(r["error.name"]=e.error.name,r["error.message"]=e.error.message,e.error.stack)r["error.stack"]=e.error.stack}return r}};export{o as GoogleCloudLogging};
+var g={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},a={messageKey:"message",format(e){let t={message:e.message,timestamp:e.timestamp,severity:g[e.level],...e.context};if(e.trace){if(t["logging.googleapis.com/trace"]=e.trace.traceId,t["logging.googleapis.com/spanId"]=e.trace.spanId,e.trace.traceFlags!==void 0)t["logging.googleapis.com/trace_sampled"]=(e.trace.traceFlags&1)===1}return t}};export{a as GoogleCloudLogging};

package/dist/index.d.ts

@@ -1,11 +1,13 @@
-import type { LogContext, LoggerOptions } from './types';
-export type { Formatter, FormatterName, InterceptOptions, LogContext, LoggerOptions, LogLevel, LogRecord, } from './types';
+import type { ErrorInfo, LogContext, LoggerOptions } from './types';
+export type { ErrorInfo, Formatter, FormatterName, InterceptOptions, LogContext, LoggerOptions, LogLevel, LogRecord, TraceContext, } from './types';
 export { logLevelValues, stripAnsi } from './types';
+export declare function errorInfo(err: Error): ErrorInfo;
 export declare class Logger {
     private ctx;
     private min;
     private json;
     private fmt;
+    private tc?;
     constructor(context?: LogContext, options?: LoggerOptions);
     child(context: LogContext): Logger;
     private log;

package/dist/index.js

@@ -1,3 +1,7 @@
-var C={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},a={messageKey:"message",format(o){let t={message:o.message,timestamp:o.timestamp,severity:C[o.level],...o.context};if(o.error){if(t["error.name"]=o.error.name,t["error.message"]=o.error.message,o.error.stack)t["error.stack"]=o.error.stack}return t}};var f={messageKey:"_msg",format(o){let t={_msg:o.message,_time:o.timestamp,level:o.level,...o.context};if(o.error){if(t["error.name"]=o.error.name,t["error.message"]=o.error.message,o.error.stack)t["error.stack"]=o.error.stack}return t}};var i=process.env.LOG_FORMAT,v=!!i,n={debug:0,info:1,warn:2,error:3,fatal:4},k=/\x1b\[[0-9;]*m/g;function l(o){return o.replace(k,"")}var m=typeof process<"u"&&process.stdout&&typeof process.stdout.write==="function"?"node":typeof Deno<"u"&&Deno.stdout?"deno":"browser",p=m==="deno"?new TextEncoder:null;function x(o,t){if(m==="node")(t?process.stderr??process.stdout:process.stdout).write(`${o}
-`);else if(m==="deno"&&p){let e=p.encode(`${o}
-`);if(t)Deno.stderr.writeSync(e);else Deno.stdout.writeSync(e)}else if(t)console.error(o);else console.log(o)}var y={"google-cloud-logging":a,"victoria-logs":f},F=i&&y[i]||a,u=v,O=process.env.LOG_LEVEL||(u?"info":"debug"),d={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};class L{ctx;min;json;fmt;constructor(o,t){this.ctx=o||{},this.json=t?.json??u,this.fmt=t?.formatter??F;let e=t?.level??O;this.min=n[e]??n.info}child(o){let t=new L({...this.ctx,...o},{json:this.json,formatter:this.fmt});return t.min=this.min,t}log(o,t,e,r){if(n[o]<this.min)return;let s={level:o,message:this.json?l(t).trim():t,timestamp:new Date().toISOString(),context:e?{...this.ctx,...e}:this.ctx};if(r)s.error={name:r.name,message:r.message,stack:r.stack};if(this.json)x(JSON.stringify(this.fmt.format(s)),d[o]);else this.logPlain(o,s)}logPlain(o,t){let e={debug:"\x1B[36m",info:"\x1B[32m",warn:"\x1B[33m",error:"\x1B[31m",fatal:"\x1B[35m"},r="\x1B[0m",s=e[o],h=new Date(t.timestamp).toLocaleTimeString("en-US",{hour12:!1}),R=o.toUpperCase().padEnd(5),c=t.context,w=Object.keys(c).length>0?` ${JSON.stringify(c)}`:"",b=t.error?` [${t.error.name}: ${t.error.message}]`:"",g=`${s}${h} ${R}\x1B[0m ${t.message}${w}${b}`;switch(o){case"debug":console.debug(g);break;case"warn":console.warn(g);break;case"error":case"fatal":console.error(g);break;default:console.log(g)}}debug(o,t){this.log("debug",o,t)}info(o,t){this.log("info",o,t)}warn(o,t){this.log("warn",o,t)}error(o,t,e){this.log("error",o,t,e)}fatal(o,t,e){this.log("fatal",o,t,e)}}var V=new L;export{l as stripAnsi,V as logger,n as logLevelValues,L as Logger};
+var k={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},f={messageKey:"message",format(t){let o={message:t.message,timestamp:t.timestamp,severity:k[t.level],...t.context};if(t.trace){if(o["logging.googleapis.com/trace"]=t.trace.traceId,o["logging.googleapis.com/spanId"]=t.trace.spanId,t.trace.traceFlags!==void 0)o["logging.googleapis.com/trace_sampled"]=(t.trace.traceFlags&1)===1}return o}};var d={messageKey:"_msg",format(t){let o={_msg:t.message,_time:t.timestamp,level:t.level,...t.context};if(t.trace){if(o.trace_id=t.trace.traceId,o.span_id=t.trace.spanId,t.trace.traceFlags!==void 0)o.trace_flags=t.trace.traceFlags}return o}};var i=process.env.LOG_FORMAT,C=!!i,a={debug:0,info:1,warn:2,error:3,fatal:4},$=/\x1b\[[0-9;]*m/g;function u(t){return t.replace($,"")}function p(t,o,e="error"){if(t[`${e}.name`]=o.name,t[`${e}.message`]=o.message,o.stack)t[`${e}.stack`]=o.stack;if(o.cause)p(t,o.cause,`${e}.cause`)}var L=typeof process<"u"&&process.stdout&&typeof process.stdout.write==="function"?"node":typeof Deno<"u"&&Deno.stdout?"deno":"browser",x=L==="deno"?new TextEncoder:null;function R(t,o){if(L==="node")(o?process.stderr??process.stdout:process.stdout).write(`${t}
+`);else if(L==="deno"&&x){let e=x.encode(`${t}
+`);if(o)Deno.stderr.writeSync(e);else Deno.stdout.writeSync(e)}else if(o)console.error(t);else console.log(t)}var E={"google-cloud-logging":f,"victoria-logs":d},O=i&&E[i]||f,w=C,S=process.env.LOG_LEVEL||(w?"info":"debug"),y={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};function b(t,o){return o.add(t),{name:t.name,message:t.message,stack:t.stack,...t.cause instanceof Error&&!o.has(t.cause)?{cause:b(t.cause,o)}:{}}}function j(t){return b(t,new WeakSet)}class h{ctx;min;json;fmt;tc;constructor(t,o){this.ctx=t||{},this.json=o?.json??w,this.fmt=o?.formatter??O,this.tc=o?.traceContext;let e=o?.level??S;this.min=a[e]??a.info}child(t){let o=new h({...this.ctx,...t},{json:this.json,formatter:this.fmt,traceContext:this.tc});return o.min=this.min,o}log(t,o,e,c){if(a[t]<this.min)return;let s={level:t,message:this.json?u(o).trim():o,timestamp:new Date().toISOString(),context:e?{...this.ctx,...e}:this.ctx};if(this.tc)s.trace=this.tc();if(c)s.error=j(c);if(this.json){let g=this.fmt.format(s);if(s.error)p(g,s.error);R(JSON.stringify(g),y[t])}else this.logPlain(t,s)}logPlain(t,o){let e={debug:"\x1B[36m",info:"\x1B[32m",warn:"\x1B[33m",error:"\x1B[31m",fatal:"\x1B[35m"},c="\x1B[0m",s=e[t],g=new Date(o.timestamp).toLocaleTimeString("en-US",{hour12:!1}),I=t.toUpperCase().padEnd(5),v=o.context,F=Object.keys(v).length>0?` ${JSON.stringify(v)}`:"",m="";if(o.error){let n=o.error,l=!0;while(n){if(n.stack)m+=l?`
+${n.stack}`:`
+Caused by: ${n.stack}`;else m+=l?`
+  ${n.name}: ${n.message}`:`
+Caused by: ${n.name}: ${n.message}`;n=n.cause,l=!1}}let r=`${s}${g} ${I}\x1B[0m ${o.message}${F}${m}`;switch(t){case"debug":console.debug(r);break;case"warn":console.warn(r);break;case"error":case"fatal":console.error(r);break;default:console.log(r)}}debug(t,o){this.log("debug",t,o)}info(t,o){this.log("info",t,o)}warn(t,o){this.log("warn",t,o)}error(t,o,e){this.log("error",t,o,e)}fatal(t,o,e){this.log("fatal",t,o,e)}}var J=new h;export{u as stripAnsi,J as logger,a as logLevelValues,j as errorInfo,h as Logger};

package/dist/intercept.js

@@ -1,3 +1,7 @@
-var Q={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},W={messageKey:"message",format(R){let k={message:R.message,timestamp:R.timestamp,severity:Q[R.level],...R.context};if(R.error){if(k["error.name"]=R.error.name,k["error.message"]=R.error.message,R.error.stack)k["error.stack"]=R.error.stack}return k}};var X=process.env.LOG_FORMAT,L=!!X,T={debug:0,info:1,warn:2,error:3,fatal:4},Y=/\x1b\[[0-9;]*m/g;function q(R){return R.replace(Y,"")}var B=typeof process<"u"&&process.stdout&&typeof process.stdout.write==="function"?"node":typeof Deno<"u"&&Deno.stdout?"deno":"browser",j=B==="deno"?new TextEncoder:null;function U(R,k){if(B==="node")(k?process.stderr??process.stdout:process.stdout).write(`${R}
-`);else if(B==="deno"&&j){let I=j.encode(`${R}
-`);if(k)Deno.stderr.writeSync(I);else Deno.stdout.writeSync(I)}else if(k)console.error(R);else console.log(R)}var S={log:console.log.bind(console),info:console.info.bind(console),warn:console.warn.bind(console),error:console.error.bind(console),debug:console.debug.bind(console)};function Z(...R){let k="";for(let I=0;I<R.length;I++){if(I>0)k+=" ";let C=R[I];if(typeof C==="string")k+=q(C);else if(C instanceof Error)k+=C.message;else try{k+=JSON.stringify(C)}catch{k+=String(C)}}return k.trim()}function _(...R){let k;for(let I of R)if(typeof I==="object"&&I!==null&&!(I instanceof Error)&&!Array.isArray(I)){if(!k)k={};Object.assign(k,I)}return k}function $(...R){for(let k of R)if(k instanceof Error)return k}var w={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};function y(R,k,I,C){let A=`"${k.messageKey}"`;return(...F)=>{if(F.length===1&&typeof F[0]==="string"&&F[0].charCodeAt(0)===123&&F[0].includes(A)){U(F[0],w[R]);return}if(T[R]<I)return;let G=Z(...F);if(C&&!C(R,G))return;let H=_(...F),N=$(...F),O={level:R,message:G,timestamp:new Date().toISOString(),context:H||{},error:N?{name:N.name,message:N.message,stack:N.stack}:void 0};U(JSON.stringify(k.format(O)),w[R])}}var z="__jsonlLoggerIntercepted";function V(R){if(globalThis[z])return;globalThis[z]=!0;let k=R?.formatter??W,I=T[R?.level??"debug"],C=R?.filter,A=[["log","info"],["info","info"],["warn","warn"],["error","error"],["debug","debug"]];for(let[F,G]of A)console[F]=y(G,k,I,C)}export{S as originalConsole,V as intercept};
+var j={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},u={messageKey:"message",format(t){let o={message:t.message,timestamp:t.timestamp,severity:j[t.level],...t.context};if(t.trace){if(o["logging.googleapis.com/trace"]=t.trace.traceId,o["logging.googleapis.com/spanId"]=t.trace.spanId,t.trace.traceFlags!==void 0)o["logging.googleapis.com/trace_sampled"]=(t.trace.traceFlags&1)===1}return o}};var w={messageKey:"_msg",format(t){let o={_msg:t.message,_time:t.timestamp,level:t.level,...t.context};if(t.trace){if(o.trace_id=t.trace.traceId,o.span_id=t.trace.spanId,t.trace.traceFlags!==void 0)o.trace_flags=t.trace.traceFlags}return o}};var x=process.env.LOG_FORMAT,$=!!x,m={debug:0,info:1,warn:2,error:3,fatal:4},_=/\x1b\[[0-9;]*m/g;function h(t){return t.replace(_,"")}function p(t,o,n="error"){if(t[`${n}.name`]=o.name,t[`${n}.message`]=o.message,o.stack)t[`${n}.stack`]=o.stack;if(o.cause)p(t,o.cause,`${n}.cause`)}var b=typeof process<"u"&&process.stdout&&typeof process.stdout.write==="function"?"node":typeof Deno<"u"&&Deno.stdout?"deno":"browser",k=b==="deno"?new TextEncoder:null;function l(t,o){if(b==="node")(o?process.stderr??process.stdout:process.stdout).write(`${t}
+`);else if(b==="deno"&&k){let n=k.encode(`${t}
+`);if(o)Deno.stderr.writeSync(n);else Deno.stdout.writeSync(n)}else if(o)console.error(t);else console.log(t)}var E={"google-cloud-logging":u,"victoria-logs":w},N=x&&E[x]||u,v=$,T=process.env.LOG_LEVEL||(v?"info":"debug"),y={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};function d(t,o){return o.add(t),{name:t.name,message:t.message,stack:t.stack,...t.cause instanceof Error&&!o.has(t.cause)?{cause:d(t.cause,o)}:{}}}function F(t){return d(t,new WeakSet)}class I{ctx;min;json;fmt;tc;constructor(t,o){this.ctx=t||{},this.json=o?.json??v,this.fmt=o?.formatter??N,this.tc=o?.traceContext;let n=o?.level??T;this.min=m[n]??m.info}child(t){let o=new I({...this.ctx,...t},{json:this.json,formatter:this.fmt,traceContext:this.tc});return o.min=this.min,o}log(t,o,n,e){if(m[t]<this.min)return;let c={level:t,message:this.json?h(o).trim():o,timestamp:new Date().toISOString(),context:n?{...this.ctx,...n}:this.ctx};if(this.tc)c.trace=this.tc();if(e)c.error=F(e);if(this.json){let a=this.fmt.format(c);if(c.error)p(a,c.error);l(JSON.stringify(a),y[t])}else this.logPlain(t,c)}logPlain(t,o){let n={debug:"\x1B[36m",info:"\x1B[32m",warn:"\x1B[33m",error:"\x1B[31m",fatal:"\x1B[35m"},e="\x1B[0m",c=n[t],a=new Date(o.timestamp).toLocaleTimeString("en-US",{hour12:!1}),i=t.toUpperCase().padEnd(5),L=o.context,R=Object.keys(L).length>0?` ${JSON.stringify(L)}`:"",f="";if(o.error){let s=o.error,C=!0;while(s){if(s.stack)f+=C?`
+${s.stack}`:`
+Caused by: ${s.stack}`;else f+=C?`
+  ${s.name}: ${s.message}`:`
+Caused by: ${s.name}: ${s.message}`;s=s.cause,C=!1}}let g=`${c}${a} ${i}\x1B[0m ${o.message}${R}${f}`;switch(t){case"debug":console.debug(g);break;case"warn":console.warn(g);break;case"error":case"fatal":console.error(g);break;default:console.log(g)}}debug(t,o){this.log("debug",t,o)}info(t,o){this.log("info",t,o)}warn(t,o){this.log("warn",t,o)}error(t,o,n){this.log("error",t,o,n)}fatal(t,o,n){this.log("fatal",t,o,n)}}var H=new I;var D={log:console.log.bind(console),info:console.info.bind(console),warn:console.warn.bind(console),error:console.error.bind(console),debug:console.debug.bind(console)};function G(...t){let o="";for(let n=0;n<t.length;n++){if(n>0)o+=" ";let e=t[n];if(typeof e==="string")o+=h(e);else if(e instanceof Error)o+=e.message;else try{o+=JSON.stringify(e)}catch{o+=String(e)}}return o.trim()}function A(...t){let o;for(let n of t)if(typeof n==="object"&&n!==null&&!(n instanceof Error)&&!Array.isArray(n)){if(!o)o={};Object.assign(o,n)}return o}function J(...t){for(let o of t)if(o instanceof Error)return o}var O={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};function U(t,o,n,e,c){let a=`"${o.messageKey}"`;return(...i)=>{if(i.length===1&&typeof i[0]==="string"&&i[0].charCodeAt(0)===123&&i[0].includes(a)){l(i[0],O[t]);return}if(m[t]<n)return;let L=G(...i);if(e&&!e(t,L))return;let R=A(...i),f=J(...i),g={level:t,message:L,timestamp:new Date().toISOString(),context:R||{},error:f?F(f):void 0,trace:c?.()},s=o.format(g);if(g.error)p(s,g.error);l(JSON.stringify(s),O[t])}}var S="__jsonlLoggerIntercepted";function K(t){if(globalThis[S])return;globalThis[S]=!0;let o=t?.formatter??u,n=m[t?.level??"debug"],e=t?.filter,c=t?.traceContext,a=[["log","info"],["info","info"],["warn","warn"],["error","error"],["debug","debug"]];for(let[i,L]of a)console[i]=U(L,o,n,e,c)}export{D as originalConsole,K as intercept};

package/dist/preload.js

@@ -1,3 +1,7 @@
-var V={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},F={messageKey:"message",format(m){let n={message:m.message,timestamp:m.timestamp,severity:V[m.level],...m.context};if(m.error){if(n["error.name"]=m.error.name,n["error.message"]=m.error.message,m.error.stack)n["error.stack"]=m.error.stack}return n}};var _={messageKey:"_msg",format(m){let n={_msg:m.message,_time:m.timestamp,level:m.level,...m.context};if(m.error){if(n["error.name"]=m.error.name,n["error.message"]=m.error.message,m.error.stack)n["error.stack"]=m.error.stack}return n}};var p=process.env.LOG_FORMAT,Q=!!p,I={debug:0,info:1,warn:2,error:3,fatal:4},W=/\x1b\[[0-9;]*m/g;function C(m){return m.replace(W,"")}var G=typeof process<"u"&&process.stdout&&typeof process.stdout.write==="function"?"node":typeof Deno<"u"&&Deno.stdout?"deno":"browser",w=G==="deno"?new TextEncoder:null;function N(m,n){if(G==="node")(n?process.stderr??process.stdout:process.stdout).write(`${m}
-`);else if(G==="deno"&&w){let R=w.encode(`${m}
-`);if(n)Deno.stderr.writeSync(R);else Deno.stdout.writeSync(R)}else if(n)console.error(m);else console.log(m)}var $={log:console.log.bind(console),info:console.info.bind(console),warn:console.warn.bind(console),error:console.error.bind(console),debug:console.debug.bind(console)};function c(...m){let n="";for(let R=0;R<m.length;R++){if(R>0)n+=" ";let o=m[R];if(typeof o==="string")n+=C(o);else if(o instanceof Error)n+=o.message;else try{n+=JSON.stringify(o)}catch{n+=String(o)}}return n.trim()}function j(...m){let n;for(let R of m)if(typeof R==="object"&&R!==null&&!(R instanceof Error)&&!Array.isArray(R)){if(!n)n={};Object.assign(n,R)}return n}function q(...m){for(let n of m)if(n instanceof Error)return n}var A={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};function t(m,n,R,o){let y=`"${n.messageKey}"`;return(...k)=>{if(k.length===1&&typeof k[0]==="string"&&k[0].charCodeAt(0)===123&&k[0].includes(y)){N(k[0],A[m]);return}if(I[m]<R)return;let f=c(...k);if(o&&!o(m,f))return;let T=j(...k),L=q(...k),U={level:m,message:f,timestamp:new Date().toISOString(),context:T||{},error:L?{name:L.name,message:L.message,stack:L.stack}:void 0};N(JSON.stringify(n.format(U)),A[m])}}var B="__jsonlLoggerIntercepted";function O(m){if(globalThis[B])return;globalThis[B]=!0;let n=m?.formatter??F,R=I[m?.level??"debug"],o=m?.filter,y=[["log","info"],["info","info"],["warn","warn"],["error","error"],["debug","debug"]];for(let[k,f]of y)console[k]=t(f,n,R,o)}if(p){let n={"google-cloud-logging":F,"victoria-logs":_}[p]??F,R=process.env.LOG_LEVEL||"info";O({formatter:n,level:R})}
+var N={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},g={messageKey:"message",format(t){let o={message:t.message,timestamp:t.timestamp,severity:N[t.level],...t.context};if(t.trace){if(o["logging.googleapis.com/trace"]=t.trace.traceId,o["logging.googleapis.com/spanId"]=t.trace.spanId,t.trace.traceFlags!==void 0)o["logging.googleapis.com/trace_sampled"]=(t.trace.traceFlags&1)===1}return o}};var x={messageKey:"_msg",format(t){let o={_msg:t.message,_time:t.timestamp,level:t.level,...t.context};if(t.trace){if(o.trace_id=t.trace.traceId,o.span_id=t.trace.spanId,t.trace.traceFlags!==void 0)o.trace_flags=t.trace.traceFlags}return o}};var l=process.env.LOG_FORMAT,d=!!l,f={debug:0,info:1,warn:2,error:3,fatal:4},S=/\x1b\[[0-9;]*m/g;function r(t){return t.replace(S,"")}function u(t,o,n="error"){if(t[`${n}.name`]=o.name,t[`${n}.message`]=o.message,o.stack)t[`${n}.stack`]=o.stack;if(o.cause)u(t,o.cause,`${n}.cause`)}var C=typeof process<"u"&&process.stdout&&typeof process.stdout.write==="function"?"node":typeof Deno<"u"&&Deno.stdout?"deno":"browser",I=C==="deno"?new TextEncoder:null;function h(t,o){if(C==="node")(o?process.stderr??process.stdout:process.stdout).write(`${t}
+`);else if(C==="deno"&&I){let n=I.encode(`${t}
+`);if(o)Deno.stderr.writeSync(n);else Deno.stdout.writeSync(n)}else if(o)console.error(t);else console.log(t)}var _={"google-cloud-logging":g,"victoria-logs":x},j=l&&_[l]||g,v=d,y=process.env.LOG_LEVEL||(v?"info":"debug"),G={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};function k(t,o){return o.add(t),{name:t.name,message:t.message,stack:t.stack,...t.cause instanceof Error&&!o.has(t.cause)?{cause:k(t.cause,o)}:{}}}function b(t){return k(t,new WeakSet)}class w{ctx;min;json;fmt;tc;constructor(t,o){this.ctx=t||{},this.json=o?.json??v,this.fmt=o?.formatter??j,this.tc=o?.traceContext;let n=o?.level??y;this.min=f[n]??f.info}child(t){let o=new w({...this.ctx,...t},{json:this.json,formatter:this.fmt,traceContext:this.tc});return o.min=this.min,o}log(t,o,n,e){if(f[t]<this.min)return;let i={level:t,message:this.json?r(o).trim():o,timestamp:new Date().toISOString(),context:n?{...this.ctx,...n}:this.ctx};if(this.tc)i.trace=this.tc();if(e)i.error=b(e);if(this.json){let a=this.fmt.format(i);if(i.error)u(a,i.error);h(JSON.stringify(a),G[t])}else this.logPlain(t,i)}logPlain(t,o){let n={debug:"\x1B[36m",info:"\x1B[32m",warn:"\x1B[33m",error:"\x1B[31m",fatal:"\x1B[35m"},e="\x1B[0m",i=n[t],a=new Date(o.timestamp).toLocaleTimeString("en-US",{hour12:!1}),c=t.toUpperCase().padEnd(5),L=o.context,R=Object.keys(L).length>0?` ${JSON.stringify(L)}`:"",p="";if(o.error){let s=o.error,F=!0;while(s){if(s.stack)p+=F?`
+${s.stack}`:`
+Caused by: ${s.stack}`;else p+=F?`
+  ${s.name}: ${s.message}`:`
+Caused by: ${s.name}: ${s.message}`;s=s.cause,F=!1}}let m=`${i}${a} ${c}\x1B[0m ${o.message}${R}${p}`;switch(t){case"debug":console.debug(m);break;case"warn":console.warn(m);break;case"error":case"fatal":console.error(m);break;default:console.log(m)}}debug(t,o){this.log("debug",t,o)}info(t,o){this.log("info",t,o)}warn(t,o){this.log("warn",t,o)}error(t,o,n){this.log("error",t,o,n)}fatal(t,o,n){this.log("fatal",t,o,n)}}var P=new w;var K={log:console.log.bind(console),info:console.info.bind(console),warn:console.warn.bind(console),error:console.error.bind(console),debug:console.debug.bind(console)};function T(...t){let o="";for(let n=0;n<t.length;n++){if(n>0)o+=" ";let e=t[n];if(typeof e==="string")o+=r(e);else if(e instanceof Error)o+=e.message;else try{o+=JSON.stringify(e)}catch{o+=String(e)}}return o.trim()}function V(...t){let o;for(let n of t)if(typeof n==="object"&&n!==null&&!(n instanceof Error)&&!Array.isArray(n)){if(!o)o={};Object.assign(o,n)}return o}function A(...t){for(let o of t)if(o instanceof Error)return o}var $={debug:!1,info:!1,warn:!1,error:!0,fatal:!0};function J(t,o,n,e,i){let a=`"${o.messageKey}"`;return(...c)=>{if(c.length===1&&typeof c[0]==="string"&&c[0].charCodeAt(0)===123&&c[0].includes(a)){h(c[0],$[t]);return}if(f[t]<n)return;let L=T(...c);if(e&&!e(t,L))return;let R=V(...c),p=A(...c),m={level:t,message:L,timestamp:new Date().toISOString(),context:R||{},error:p?b(p):void 0,trace:i?.()},s=o.format(m);if(m.error)u(s,m.error);h(JSON.stringify(s),$[t])}}var O="__jsonlLoggerIntercepted";function E(t){if(globalThis[O])return;globalThis[O]=!0;let o=t?.formatter??g,n=f[t?.level??"debug"],e=t?.filter,i=t?.traceContext,a=[["log","info"],["info","info"],["warn","warn"],["error","error"],["debug","debug"]];for(let[c,L]of a)console[c]=J(L,o,n,e,i)}if(l){let o={"google-cloud-logging":g,"victoria-logs":x}[l]??g,n=process.env.LOG_LEVEL||"info";E({formatter:o,level:n})}

package/dist/types.d.ts

@@ -1,15 +1,23 @@
 export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
 export type LogContext = Record<string, unknown>;
+export type ErrorInfo = {
+    name: string;
+    message: string;
+    stack?: string;
+    cause?: ErrorInfo;
+};
+export type TraceContext = {
+    traceId: string;
+    spanId: string;
+    traceFlags?: number;
+};
 export type LogRecord = {
     level: LogLevel;
     message: string;
     timestamp: string;
     context: LogContext;
-    error?: {
-        name: string;
-        message: string;
-        stack?: string;
-    };
+    error?: ErrorInfo;
+    trace?: TraceContext;
 };
 export type Formatter = {
     format: (record: LogRecord) => Record<string, unknown>;
@@ -19,6 +27,7 @@ export type LoggerOptions = {
     formatter?: Formatter;
     json?: boolean;
     level?: LogLevel;
+    traceContext?: () => TraceContext | undefined;
 };
 export type FormatterName = 'google-cloud-logging' | 'victoria-logs';
 export declare const defaultFormat: FormatterName | undefined;
@@ -27,7 +36,9 @@ export type InterceptOptions = {
     formatter?: Formatter;
     filter?: (level: LogLevel, message: string) => boolean;
     level?: LogLevel;
+    traceContext?: () => TraceContext | undefined;
 };
 export declare const logLevelValues: Record<LogLevel, number>;
 export declare function stripAnsi(str: string): string;
+export declare function flattenError(entry: Record<string, unknown>, error: ErrorInfo, prefix?: string): void;
 export declare function write(data: string, isError: boolean): void;

package/dist/victoria-logs.js

@@ -1 +1 @@
-var t={messageKey:"_msg",format(e){let r={_msg:e.message,_time:e.timestamp,level:e.level,...e.context};if(e.error){if(r["error.name"]=e.error.name,r["error.message"]=e.error.message,e.error.stack)r["error.stack"]=e.error.stack}return r}};export{t as VictoriaLogs};
+var a={messageKey:"_msg",format(t){let e={_msg:t.message,_time:t.timestamp,level:t.level,...t.context};if(t.trace){if(e.trace_id=t.trace.traceId,e.span_id=t.trace.spanId,t.trace.traceFlags!==void 0)e.trace_flags=t.trace.traceFlags}return e}};export{a as VictoriaLogs};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsonl-logger",
-  "version": "0.2.3",
+  "version": "0.4.0",
   "description": "Lightweight ESM-only JSON Lines logger with pluggable formatters for Google Cloud Logging, VictoriaLogs, and more",
   "license": "MIT",
   "type": "module",
@@ -49,7 +49,7 @@
     "test": "bun test"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.2",
+    "@biomejs/biome": "2.4.3",
     "@types/bun": "1.3.9",
     "typescript": "5.9.3"
   },

package/src/google-cloud-logging.ts

@@ -17,10 +17,13 @@ export const GoogleCloudLogging: Formatter = {
       severity: severityMap[record.level],
       ...record.context,
     }
-    if (record.error) {
-      entry['error.name'] = record.error.name
-      entry['error.message'] = record.error.message
-      if (record.error.stack) entry['error.stack'] = record.error.stack
+    if (record.trace) {
+      entry['logging.googleapis.com/trace'] = record.trace.traceId
+      entry['logging.googleapis.com/spanId'] = record.trace.spanId
+      if (record.trace.traceFlags !== undefined) {
+        entry['logging.googleapis.com/trace_sampled'] =
+          (record.trace.traceFlags & 1) === 1
+      }
     }
     return entry
   },

package/src/index.ts

@@ -1,14 +1,17 @@
 import { GoogleCloudLogging } from './google-cloud-logging'
 import type {
+  ErrorInfo,
   Formatter,
   FormatterName,
   LogContext,
   LoggerOptions,
   LogLevel,
   LogRecord,
+  TraceContext,
 } from './types'
 import {
   defaultFormat,
+  flattenError,
   isJsonMode,
   logLevelValues,
   stripAnsi,
@@ -17,6 +20,7 @@ import {
 import { VictoriaLogs } from './victoria-logs'
 
 export type {
+  ErrorInfo,
   Formatter,
   FormatterName,
   InterceptOptions,
@@ -24,6 +28,7 @@ export type {
   LoggerOptions,
   LogLevel,
   LogRecord,
+  TraceContext,
 } from './types'
 export { logLevelValues, stripAnsi } from './types'
 
@@ -47,16 +52,34 @@ const isErrorLevel: Record<LogLevel, boolean> = {
   fatal: true,
 }
 
+function extractErrorInfo(err: Error, visited: WeakSet<Error>): ErrorInfo {
+  visited.add(err)
+  return {
+    name: err.name,
+    message: err.message,
+    stack: err.stack,
+    ...(err.cause instanceof Error && !visited.has(err.cause)
+      ? { cause: extractErrorInfo(err.cause, visited) }
+      : {}),
+  }
+}
+
+export function errorInfo(err: Error): ErrorInfo {
+  return extractErrorInfo(err, new WeakSet())
+}
+
 export class Logger {
   private ctx: LogContext
   private min: number
   private json: boolean
   private fmt: Formatter
+  private tc?: () => TraceContext | undefined
 
   constructor(context?: LogContext, options?: LoggerOptions) {
     this.ctx = context || {}
     this.json = options?.json ?? defaultJson
     this.fmt = options?.formatter ?? defaultFormatter
+    this.tc = options?.traceContext
     const level: LogLevel = options?.level ?? defaultLevel
     this.min = logLevelValues[level] ?? logLevelValues.info
   }
@@ -67,6 +90,7 @@ export class Logger {
       {
         json: this.json,
         formatter: this.fmt,
+        traceContext: this.tc,
       },
     )
     child.min = this.min
@@ -88,12 +112,18 @@ export class Logger {
       context: meta ? { ...this.ctx, ...meta } : this.ctx,
     }
 
+    if (this.tc) {
+      record.trace = this.tc()
+    }
+
     if (err) {
-      record.error = { name: err.name, message: err.message, stack: err.stack }
+      record.error = errorInfo(err)
     }
 
     if (this.json) {
-      write(JSON.stringify(this.fmt.format(record)), isErrorLevel[level])
+      const formatted = this.fmt.format(record)
+      if (record.error) flattenError(formatted, record.error)
+      write(JSON.stringify(formatted), isErrorLevel[level])
     } else {
       this.logPlain(level, record)
     }
@@ -118,9 +148,24 @@ export class Logger {
     const ctx = record.context
     const metaStr = Object.keys(ctx).length > 0 ? ` ${JSON.stringify(ctx)}` : ''
 
-    const errStr = record.error
-      ? ` [${record.error.name}: ${record.error.message}]`
-      : ''
+    let errStr = ''
+    if (record.error) {
+      let current: ErrorInfo | undefined = record.error
+      let isRoot = true
+      while (current) {
+        if (current.stack) {
+          errStr += isRoot
+            ? `\n${current.stack}`
+            : `\nCaused by: ${current.stack}`
+        } else {
+          errStr += isRoot
+            ? `\n  ${current.name}: ${current.message}`
+            : `\nCaused by: ${current.name}: ${current.message}`
+        }
+        current = current.cause
+        isRoot = false
+      }
+    }
 
     const output = `${color}${time} ${levelStr}${reset} ${record.message}${metaStr}${errStr}`
 

package/src/intercept.ts

@@ -1,6 +1,12 @@
 import { GoogleCloudLogging } from './google-cloud-logging'
-import type { Formatter, InterceptOptions, LogLevel } from './types'
-import { logLevelValues, stripAnsi, write } from './types'
+import { errorInfo } from './index'
+import type {
+  Formatter,
+  InterceptOptions,
+  LogLevel,
+  TraceContext,
+} from './types'
+import { flattenError, logLevelValues, stripAnsi, write } from './types'
 
 type ConsoleMethods = {
   log: typeof console.log
@@ -74,6 +80,7 @@ function createOverride(
   formatter: Formatter,
   minLevel: number,
   filter?: (level: LogLevel, message: string) => boolean,
+  traceContext?: () => TraceContext | undefined,
 ): (...args: unknown[]) => void {
   const msgKey = `"${formatter.messageKey}"`
 
@@ -103,12 +110,13 @@ function createOverride(
       message,
       timestamp: new Date().toISOString(),
       context: meta || {},
-      error: error
-        ? { name: error.name, message: error.message, stack: error.stack }
-        : undefined,
+      error: error ? errorInfo(error) : undefined,
+      trace: traceContext?.(),
     }
 
-    write(JSON.stringify(formatter.format(record)), isErrorLevel[level])
+    const formatted = formatter.format(record)
+    if (record.error) flattenError(formatted, record.error)
+    write(JSON.stringify(formatted), isErrorLevel[level])
   }
 }
 
@@ -121,6 +129,7 @@ export function intercept(options?: InterceptOptions): void {
   const formatter = options?.formatter ?? GoogleCloudLogging
   const minLevel = logLevelValues[options?.level ?? 'debug']
   const filter = options?.filter
+  const traceContext = options?.traceContext
 
   const methodMap: [keyof ConsoleMethods, LogLevel][] = [
     ['log', 'info'],
@@ -131,6 +140,12 @@ export function intercept(options?: InterceptOptions): void {
   ]
 
   for (const [method, level] of methodMap) {
-    console[method] = createOverride(level, formatter, minLevel, filter)
+    console[method] = createOverride(
+      level,
+      formatter,
+      minLevel,
+      filter,
+      traceContext,
+    )
   }
 }

package/src/types.ts

@@ -2,12 +2,26 @@ export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal'
 
 export type LogContext = Record<string, unknown>
 
+export type ErrorInfo = {
+  name: string
+  message: string
+  stack?: string
+  cause?: ErrorInfo
+}
+
+export type TraceContext = {
+  traceId: string
+  spanId: string
+  traceFlags?: number
+}
+
 export type LogRecord = {
   level: LogLevel
   message: string
   timestamp: string
   context: LogContext
-  error?: { name: string; message: string; stack?: string }
+  error?: ErrorInfo
+  trace?: TraceContext
 }
 
 export type Formatter = {
@@ -19,6 +33,7 @@ export type LoggerOptions = {
   formatter?: Formatter
   json?: boolean
   level?: LogLevel
+  traceContext?: () => TraceContext | undefined
 }
 
 export type FormatterName = 'google-cloud-logging' | 'victoria-logs'
@@ -30,6 +45,7 @@ export type InterceptOptions = {
   formatter?: Formatter
   filter?: (level: LogLevel, message: string) => boolean
   level?: LogLevel
+  traceContext?: () => TraceContext | undefined
 }
 
 export const logLevelValues: Record<LogLevel, number> = {
@@ -47,6 +63,17 @@ export function stripAnsi(str: string): string {
   return str.replace(ansiPattern, '')
 }
 
+export function flattenError(
+  entry: Record<string, unknown>,
+  error: ErrorInfo,
+  prefix = 'error',
+): void {
+  entry[`${prefix}.name`] = error.name
+  entry[`${prefix}.message`] = error.message
+  if (error.stack) entry[`${prefix}.stack`] = error.stack
+  if (error.cause) flattenError(entry, error.cause, `${prefix}.cause`)
+}
+
 /**
  * Detect runtime once, resolve streams at call time.
  * Stream lookup is deferred so tests/runtime can replace process.stdout.

package/src/victoria-logs.ts

@@ -9,10 +9,12 @@ export const VictoriaLogs: Formatter = {
       level: record.level,
       ...record.context,
     }
-    if (record.error) {
-      entry['error.name'] = record.error.name
-      entry['error.message'] = record.error.message
-      if (record.error.stack) entry['error.stack'] = record.error.stack
+    if (record.trace) {
+      entry.trace_id = record.trace.traceId
+      entry.span_id = record.trace.spanId
+      if (record.trace.traceFlags !== undefined) {
+        entry.trace_flags = record.trace.traceFlags
+      }
     }
     return entry
   },