jsonl-logger 0.3.0 → 0.5.0

package/README.md

@@ -83,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`.
@@ -188,7 +240,7 @@ The logger auto-detects the runtime and uses the fastest available I/O:
 
 | Subpath | Export |
 |---------|--------|
-| `jsonl-logger` | `Logger`, `logger`, `errorInfo()`, types (`ErrorInfo`, `LogRecord`, etc.) |
+| `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"},r={messageKey:"message",format(e){return{message:e.message,timestamp:e.timestamp,severity:t[e.level],...e.context}}};export{r 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,5 +1,5 @@
 import type { ErrorInfo, LogContext, LoggerOptions } from './types';
-export type { ErrorInfo, Formatter, FormatterName, InterceptOptions, LogContext, LoggerOptions, LogLevel, LogRecord, } from './types';
+export type { ErrorInfo, Formatter, FormatterName, InterceptOptions, LabelStyle, LogContext, LoggerOptions, LogLevel, LogRecord, TraceContext, } from './types';
 export { logLevelValues, stripAnsi } from './types';
 export declare function errorInfo(err: Error): ErrorInfo;
 export declare class Logger {
@@ -7,10 +7,13 @@ export declare class Logger {
     private min;
     private json;
     private fmt;
+    private labels;
+    private tc?;
     constructor(context?: LogContext, options?: LoggerOptions);
     child(context: LogContext): Logger;
-    private log;
+    private emit;
     private logPlain;
+    log(message: string, meta?: LogContext): void;
     debug(message: string, meta?: LogContext): void;
     info(message: string, meta?: LogContext): void;
     warn(message: string, meta?: LogContext): void;

package/dist/index.js

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

package/dist/intercept.js

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

package/dist/preload.js

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

package/dist/types.d.ts

@@ -6,21 +6,31 @@ export type ErrorInfo = {
     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?: ErrorInfo;
+    trace?: TraceContext;
 };
 export type Formatter = {
     format: (record: LogRecord) => Record<string, unknown>;
     messageKey: string;
 };
+export type LabelStyle = 'icon' | 'none' | 'text';
+export declare const defaultLabelStyle: LabelStyle;
 export type LoggerOptions = {
     formatter?: Formatter;
     json?: boolean;
+    labels?: LabelStyle;
     level?: LogLevel;
+    traceContext?: () => TraceContext | undefined;
 };
 export type FormatterName = 'google-cloud-logging' | 'victoria-logs';
 export declare const defaultFormat: FormatterName | undefined;
@@ -29,6 +39,7 @@ 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;

package/dist/victoria-logs.js

@@ -1 +1 @@
-var o={messageKey:"_msg",format(t){return{_msg:t.message,_time:t.timestamp,level:t.level,...t.context}}};export{o 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.3.0",
+  "version": "0.5.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,6 +17,14 @@ export const GoogleCloudLogging: Formatter = {
       severity: severityMap[record.level],
       ...record.context,
     }
+    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

@@ -3,13 +3,16 @@ import type {
   ErrorInfo,
   Formatter,
   FormatterName,
+  LabelStyle,
   LogContext,
   LoggerOptions,
   LogLevel,
   LogRecord,
+  TraceContext,
 } from './types'
 import {
   defaultFormat,
+  defaultLabelStyle,
   flattenError,
   isJsonMode,
   logLevelValues,
@@ -23,10 +26,12 @@ export type {
   Formatter,
   FormatterName,
   InterceptOptions,
+  LabelStyle,
   LogContext,
   LoggerOptions,
   LogLevel,
   LogRecord,
+  TraceContext,
 } from './types'
 export { logLevelValues, stripAnsi } from './types'
 
@@ -66,16 +71,28 @@ export function errorInfo(err: Error): ErrorInfo {
   return extractErrorInfo(err, new WeakSet())
 }
 
+const levelIcons: Record<LogLevel, string> = {
+  debug: '◆',
+  info: '●',
+  warn: '▲',
+  error: '✖',
+  fatal: '‼',
+}
+
 export class Logger {
   private ctx: LogContext
   private min: number
   private json: boolean
   private fmt: Formatter
+  private labels: LabelStyle
+  private tc?: () => TraceContext | undefined
 
   constructor(context?: LogContext, options?: LoggerOptions) {
     this.ctx = context || {}
     this.json = options?.json ?? defaultJson
     this.fmt = options?.formatter ?? defaultFormatter
+    this.labels = options?.labels ?? defaultLabelStyle
+    this.tc = options?.traceContext
     const level: LogLevel = options?.level ?? defaultLevel
     this.min = logLevelValues[level] ?? logLevelValues.info
   }
@@ -86,17 +103,20 @@ export class Logger {
       {
         json: this.json,
         formatter: this.fmt,
+        labels: this.labels,
+        traceContext: this.tc,
       },
     )
     child.min = this.min
     return child
   }
 
-  private log(
+  private emit(
     level: LogLevel,
     message: string,
     meta?: LogContext,
     err?: Error,
+    neutral?: boolean,
   ): void {
     if (logLevelValues[level] < this.min) return
 
@@ -107,6 +127,10 @@ export class Logger {
       context: meta ? { ...this.ctx, ...meta } : this.ctx,
     }
 
+    if (this.tc) {
+      record.trace = this.tc()
+    }
+
     if (err) {
       record.error = errorInfo(err)
     }
@@ -116,11 +140,15 @@ export class Logger {
       if (record.error) flattenError(formatted, record.error)
       write(JSON.stringify(formatted), isErrorLevel[level])
     } else {
-      this.logPlain(level, record)
+      this.logPlain(level, record, neutral)
     }
   }
 
-  private logPlain(level: LogLevel, record: LogRecord): void {
+  private logPlain(
+    level: LogLevel,
+    record: LogRecord,
+    neutral?: boolean,
+  ): void {
     const colors: Record<LogLevel, string> = {
       debug: '\x1b[36m',
       info: '\x1b[32m',
@@ -134,7 +162,15 @@ export class Logger {
     const time = new Date(record.timestamp).toLocaleTimeString('en-US', {
       hour12: false,
     })
-    const levelStr = level.toUpperCase().padEnd(5)
+
+    let levelStr: string
+    if (this.labels === 'none') {
+      levelStr = ' '
+    } else if (this.labels === 'text') {
+      levelStr = neutral ? '     ' : level.toUpperCase().padEnd(5)
+    } else {
+      levelStr = neutral ? ' ' : `${levelIcons[level]} `
+    }
 
     const ctx = record.context
     const metaStr = Object.keys(ctx).length > 0 ? ` ${JSON.stringify(ctx)}` : ''
@@ -145,7 +181,9 @@ export class Logger {
       let isRoot = true
       while (current) {
         if (current.stack) {
-          errStr += isRoot ? `\n${current.stack}` : `\nCaused by: ${current.stack}`
+          errStr += isRoot
+            ? `\n${current.stack}`
+            : `\nCaused by: ${current.stack}`
         } else {
           errStr += isRoot
             ? `\n  ${current.name}: ${current.message}`
@@ -174,24 +212,28 @@ export class Logger {
     }
   }
 
+  log(message: string, meta?: LogContext): void {
+    this.emit('info', message, meta, undefined, true)
+  }
+
   debug(message: string, meta?: LogContext): void {
-    this.log('debug', message, meta)
+    this.emit('debug', message, meta)
   }
 
   info(message: string, meta?: LogContext): void {
-    this.log('info', message, meta)
+    this.emit('info', message, meta)
   }
 
   warn(message: string, meta?: LogContext): void {
-    this.log('warn', message, meta)
+    this.emit('warn', message, meta)
   }
 
   error(message: string, meta?: LogContext, error?: Error): void {
-    this.log('error', message, meta, error)
+    this.emit('error', message, meta, error)
   }
 
   fatal(message: string, meta?: LogContext, error?: Error): void {
-    this.log('fatal', message, meta, error)
+    this.emit('fatal', message, meta, error)
   }
 }
 

package/src/intercept.ts

@@ -1,6 +1,11 @@
 import { GoogleCloudLogging } from './google-cloud-logging'
 import { errorInfo } from './index'
-import type { Formatter, InterceptOptions, LogLevel } from './types'
+import type {
+  Formatter,
+  InterceptOptions,
+  LogLevel,
+  TraceContext,
+} from './types'
 import { flattenError, logLevelValues, stripAnsi, write } from './types'
 
 type ConsoleMethods = {
@@ -75,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}"`
 
@@ -105,6 +111,7 @@ function createOverride(
       timestamp: new Date().toISOString(),
       context: meta || {},
       error: error ? errorInfo(error) : undefined,
+      trace: traceContext?.(),
     }
 
     const formatted = formatter.format(record)
@@ -122,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'],
@@ -132,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

@@ -9,12 +9,19 @@ export type ErrorInfo = {
   cause?: ErrorInfo
 }
 
+export type TraceContext = {
+  traceId: string
+  spanId: string
+  traceFlags?: number
+}
+
 export type LogRecord = {
   level: LogLevel
   message: string
   timestamp: string
   context: LogContext
   error?: ErrorInfo
+  trace?: TraceContext
 }
 
 export type Formatter = {
@@ -22,10 +29,21 @@ export type Formatter = {
   messageKey: string
 }
 
+export type LabelStyle = 'icon' | 'none' | 'text'
+
+export const defaultLabelStyle: LabelStyle =
+  (process.env.LOG_LABELS as LabelStyle) === 'text'
+    ? 'text'
+    : (process.env.LOG_LABELS as LabelStyle) === 'none'
+      ? 'none'
+      : 'icon'
+
 export type LoggerOptions = {
   formatter?: Formatter
   json?: boolean
+  labels?: LabelStyle
   level?: LogLevel
+  traceContext?: () => TraceContext | undefined
 }
 
 export type FormatterName = 'google-cloud-logging' | 'victoria-logs'
@@ -37,6 +55,7 @@ export type InterceptOptions = {
   formatter?: Formatter
   filter?: (level: LogLevel, message: string) => boolean
   level?: LogLevel
+  traceContext?: () => TraceContext | undefined
 }
 
 export const logLevelValues: Record<LogLevel, number> = {

package/src/victoria-logs.ts

@@ -9,6 +9,13 @@ export const VictoriaLogs: Formatter = {
       level: record.level,
       ...record.context,
     }
+    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
   },
 }