jsonl-logger 0.2.2 → 0.3.0

package/README.md

@@ -1,6 +1,13 @@
-# jsonl-logger
+[![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)
 
-Lightweight JSON Lines (JSONL) logger with pluggable formatters. Modern ESM-only, zero dependencies, Bun-first, works on Node.js and Deno.
+
+# 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.
+
+Next.js (and other hardcoded plain text logs) become JSON-only logging for systems where it is required.
 
 ## Install
 
@@ -29,20 +36,14 @@ Set `LOG_FORMAT` to enable JSON output with a specific formatter:
 
 ```bash
 LOG_FORMAT=google-cloud-logging bun run server.ts
-```
-
-```typescript
-// Output: {"message":"...","timestamp":"...","severity":"INFO",...}
+# Output: {"message":"...","timestamp":"...","severity":"INFO",...}
 ```
 
 ### VictoriaLogs
 
 ```bash
 LOG_FORMAT=victoria-logs bun run server.ts
-```
-
-```typescript
-// Output: {"_msg":"...","_time":"...","level":"info",...}
+# Output: {"_msg":"...","_time":"...","level":"info",...}
 ```
 
 ### Custom Formatter
@@ -82,15 +83,41 @@ console.log('plain text') // → structured JSON
 originalConsole.log('bypass interception')
 ```
 
-## Preload (Next.js Standalone)
+## Next.js Integration
 
-Auto-intercept from first line using `--preload`:
+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`.
 
-```bash
-LOG_FORMAT=victoria-logs bun --preload jsonl-logger/preload server.js
+### Instrumentation
+
+Next.js auto-detects `instrumentation.ts` at the project root. Use it to load the preload module on the server:
+
+```ts
+export async function register() {
+  if (process.env.NEXT_RUNTIME === 'nodejs' || typeof Bun !== 'undefined') {
+    await import('jsonl-logger/preload')
+  }
+}
 ```
 
-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`.
+### Dockerfile (Standalone with Bun)
+
+Next.js standalone output doesn't include all `node_modules`. Copy `jsonl-logger` explicitly from the build stage:
+
+```dockerfile
+COPY --from=build /app/node_modules/jsonl-logger ./node_modules/jsonl-logger
+
+ENV LOG_FORMAT=victoria-logs
+
+CMD ["bun", "--preload", "jsonl-logger/preload", "server.js"]
+```
+
+### Node.js
+
+For non-Bun deployments, use `--import` to preload:
+
+```bash
+LOG_FORMAT=google-cloud-logging node --import jsonl-logger/preload server.js
+```
 
 ## Child Loggers
 
@@ -100,6 +127,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 |
@@ -118,7 +188,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`, 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 t={debug:"DEBUG",info:"INFO",warn:"WARNING",error:"ERROR",fatal:"CRITICAL"},r={messageKey:"message",format(e){return{message:e.message,timestamp:e.timestamp,severity:t[e.level],...e.context}}};export{r as GoogleCloudLogging};

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-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, } from './types';
 export { logLevelValues, stripAnsi } from './types';
+export declare function errorInfo(err: Error): ErrorInfo;
 export declare class Logger {
     private ctx;
     private min;

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

package/dist/types.d.ts

@@ -1,15 +1,17 @@
 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 LogRecord = {
     level: LogLevel;
     message: string;
     timestamp: string;
     context: LogContext;
-    error?: {
-        name: string;
-        message: string;
-        stack?: string;
-    };
+    error?: ErrorInfo;
 };
 export type Formatter = {
     format: (record: LogRecord) => Record<string, unknown>;
@@ -30,4 +32,5 @@ export type InterceptOptions = {
 };
 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 o={messageKey:"_msg",format(t){return{_msg:t.message,_time:t.timestamp,level:t.level,...t.context}}};export{o as VictoriaLogs};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jsonl-logger",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Lightweight ESM-only JSON Lines logger with pluggable formatters for Google Cloud Logging, VictoriaLogs, and more",
   "license": "MIT",
   "type": "module",

package/src/google-cloud-logging.ts

@@ -17,11 +17,6 @@ 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
-    }
     return entry
   },
 }

package/src/index.ts

@@ -1,5 +1,6 @@
 import { GoogleCloudLogging } from './google-cloud-logging'
 import type {
+  ErrorInfo,
   Formatter,
   FormatterName,
   LogContext,
@@ -9,6 +10,7 @@ import type {
 } from './types'
 import {
   defaultFormat,
+  flattenError,
   isJsonMode,
   logLevelValues,
   stripAnsi,
@@ -17,6 +19,7 @@ import {
 import { VictoriaLogs } from './victoria-logs'
 
 export type {
+  ErrorInfo,
   Formatter,
   FormatterName,
   InterceptOptions,
@@ -47,6 +50,22 @@ 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
@@ -89,11 +108,13 @@ export class Logger {
     }
 
     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 +139,22 @@ 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,7 @@
 import { GoogleCloudLogging } from './google-cloud-logging'
+import { errorInfo } from './index'
 import type { Formatter, InterceptOptions, LogLevel } from './types'
-import { logLevelValues, stripAnsi, write } from './types'
+import { flattenError, logLevelValues, stripAnsi, write } from './types'
 
 type ConsoleMethods = {
   log: typeof console.log
@@ -103,12 +104,12 @@ 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,
     }
 
-    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])
   }
 }
 

package/src/types.ts

@@ -2,12 +2,19 @@ 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 LogRecord = {
   level: LogLevel
   message: string
   timestamp: string
   context: LogContext
-  error?: { name: string; message: string; stack?: string }
+  error?: ErrorInfo
 }
 
 export type Formatter = {
@@ -47,6 +54,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,11 +9,6 @@ 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
-    }
     return entry
   },
 }