@stacksjs/logging 0.72.57 → 0.72.61

package/dist/index.js

@@ -1,11 +1,11 @@
 // @bun
-var R=import.meta.require;import{AsyncLocalStorage as x}from"async_hooks";import X from"process";import{Logger as v}from"@stacksjs/clarity";import{handleError as u}from"@stacksjs/error-handling";import{ExitCode as S}from"@stacksjs/types";var I=null,F=null,T=new Set;function z(B){return T.add(B),B.finally(()=>T.delete(B)).catch(()=>{}),B}var w=!1;function d(){if(w)return;w=!0,X.on("beforeExit",()=>{G.flush()})}var K=[],y=new Set,k={debug:0,info:1,success:1,warning:2,error:3};function h(B){let H=B;if(!H||typeof H!=="object"||typeof H.log!=="function")return X.stderr.write(`[logging] Ignoring a transport without a log() function.
-`),null;if(typeof H.name!=="string"||!H.name)return X.stderr.write(`[logging] Ignoring a transport without a name.
-`),null;return K.push(H),()=>{let J=K.indexOf(H);if(J!==-1)K.splice(J,1)}}function HB(B){let H=h(B);if(!H)return()=>{};return L(),H}function JB(){return[...K]}function q(B,H,J){if(K.length===0)return;let Q;try{Q={level:B,message:H,args:J,context:V(),timestamp:new Date().toISOString()}}catch{return}for(let U of K){if(U.level&&k[B]<k[U.level])continue;try{U.log(Q)}catch(Z){if(!y.has(U.name)){y.add(U.name);let j=Z instanceof Error?Z.message:String(Z);X.stderr.write(`[logging] Transport "${U.name}" threw: ${j}. Further throws from it are silent.
-`)}}}}async function c(){let B=K.filter((H)=>typeof H.flush==="function").map((H)=>H.flush().catch(()=>{}));if(B.length>0)await Promise.allSettled(B)}var C=new Set(["debug","info","success","warning","error"]);function _(B,H="info"){if(!B)return H;let J=B.toLowerCase();if(J==="warn")return"warning";if(C.has(J))return J;return X.stderr.write(`[logging] Ignoring invalid LOG_LEVEL="${B}" (expected: ${[...C].join(", ")}); using "${H}".
-`),H}function m(B){if(B==="json"||B==="text")return B;if(B)X.stderr.write(`[logging] Ignoring invalid LOG_FORMAT="${B}" (expected "json" or "text").
-`);return X.env.NODE_ENV==="production"?"json":"text"}function p(B){let H=B.envLevel?_(B.envLevel):B.cfgLevel?_(B.cfgLevel):"info",J=B.envFormat?m(B.envFormat):B.cfgFormat==="json"||B.cfgFormat==="text"?B.cfgFormat:B.isProduction?"json":"text";return{level:H,format:J,writeToFile:B.cfgWriteToFile??!0}}function P(B,H=0){if(H>8)return{name:"Error",message:"[cause chain truncated]"};if(B instanceof Error)return{name:B.name,message:B.message,stack:B.stack,cause:B.cause!=null?P(B.cause,H+1):void 0};if(typeof B==="string")return{name:"Error",message:B};if(B==null)return{name:"Error",message:String(B)};try{return{name:"Error",message:JSON.stringify(W(B))}}catch{return{name:"Error",message:String(B)}}}function M(B){let H=B.stack||`${B.name}: ${B.message}`,J=B.cause;while(J)H+=`
-  caused by: ${J.stack||`${J.name}: ${J.message}`}`,J=J.cause;return H}function W(B,H=0){if(B instanceof Error)return P(B);if(H>=4||B===null||typeof B!=="object")return B;if(Array.isArray(B))return B.map((U)=>W(U,H+1));let J=Object.getPrototypeOf(B);if(J!==Object.prototype&&J!==null)return B;let Q={};for(let[U,Z]of Object.entries(B))Q[U]=W(Z,H+1);return Q}function E(B){return W(B)}var O=new x;function QB(B,H){return O.run(B,H)}function V(){let B=O.getStore(),H=i();if(!H)return B;return{trace_id:H,...B}}function i(){try{let H=globalThis[Symbol.for("stacks.router.traceStorage")]?.getStore?.();if(H)return H;return globalThis[Symbol.for("stacks.router.requestStorage")]?.getStore?.()?._requestId}catch{return}}async function L(){if(I)return;if(F)return F;return d(),F=(async()=>{let B,H,J,Q;try{let Y=(await import("@stacksjs/config")).logging;if(Y){if(B=Y.level,H=Y.format,typeof Y.writeToFile==="boolean")Q=Y.writeToFile;if(Y.logsPath)J=(await import("path")).dirname(Y.logsPath);if(Array.isArray(Y.transports))for(let b of Y.transports)h(b)}}catch{}let{level:U,format:Z,writeToFile:j}=p({envLevel:X.env.LOG_LEVEL,envFormat:X.env.LOG_FORMAT,cfgLevel:B,cfgFormat:H,cfgWriteToFile:Q,isProduction:X.env.NODE_ENV==="production"}),A=J;if(!A)try{A=(await import("@stacksjs/path")).projectPath("storage/logs")}catch{A="storage/logs"}I=new v("stacks",{level:U,logDirectory:A,showTags:!1,fancy:Z!=="json",format:Z,writeToFile:j})})(),F}async function $(){return await L(),I}function N(...B){let H=B.filter((Q)=>Q!==void 0).map((Q)=>{if(Q instanceof Error)return M(P(Q));if(typeof Q==="object"&&Q!==null)return JSON.stringify(W(Q),null,2);return String(Q)}).join(" "),J=O.getStore();if(J?.requestId)return`[${J.requestId}] ${H}`;return H}var n=new Set(["shouldExit","silent","message"]);function l(B){if(!B||typeof B!=="object"||B instanceof Error)return!1;if(!(("shouldExit"in B)||("silent"in B)))return!1;return Object.keys(B).every((H)=>n.has(H))}var G={info:async(...B)=>{let H=N(...B),J=await $();q("info",H,B),await J.info(H)},success:async(B)=>{let H=await $();q("success",B,[B]),await H.success(B)},warn:async(B,H)=>{let J=await $();if(q("warning",B,H===void 0?[B]:[B,H]),H==null){await J.warn(B);return}let Q=W(H);await J.warn(B,Q)},warning:async(B)=>{let H=await $();q("warning",B,[B]),await H.warn(B)},error:async(B,H,J)=>{let Q=l(H)?H:void 0,U;if(typeof B==="string")U=B;else U=M(P(B));if(H!==void 0&&!Q)U=`${U} ${M(P(H))}`;let Z={...V(),...J};if(Object.keys(Z).length>0)try{U=`${U} ${JSON.stringify(E(Z))}`}catch{}let j=await $();if(q("error",U,Q?[B]:[B,H,J].filter((A)=>A!==void 0)),await j.error(U),Q?.shouldExit)u(B,Q)},debug:async(...B)=>{let H=(X.env.LOG_LEVEL||"info").toLowerCase(),J=H==="info"||H==="warn"||H==="error";if(J&&K.length===0)return;let Q=N(...B);if(J){q("debug",Q,B);return}let U=await $();q("debug",Q,B),await U.debug(Q)},dump:async(...B)=>{let H=N(...B);await(await $()).debug(`DUMP: ${H}`)},dd:async(...B)=>{let H=N(...B);await(await $()).error(H),X.exit(S.FatalError)},echo:async(...B)=>{let H=N(...B);await(await $()).info(`ECHO: ${H}`)},time:(B)=>{let H=performance.now();return async(J)=>{let Q=performance.now()-H,U=await $(),Z=J?` ${JSON.stringify(E(J))}`:"";await U.info(`${B}: ${Q.toFixed(2)}ms${Z}`)}},syncWarn:(B)=>{X.stderr.write(`${B}
-`)},syncError:(B)=>{X.stderr.write(`${B}
-`)},fatal:(B,H=S.FatalError)=>{X.stderr.write(`${B}
-`),X.exit(H)},exit:async(B,H=S.Success)=>{if(B)await(H===S.Success?G.success(B):G.error(B));await G.flush(),X.exit(H)},flush:async()=>{if(T.size>0)await Promise.allSettled([...T]);if(await c(),!I&&!F)return;try{let B=await $(),H=B.flush;if(typeof H==="function")await H.call(B)}catch{}}};async function UB(...B){for(let H of B)await G.debug(H)}async function XB(...B){let H=N(...B);console.log(H),X.exit(S.FatalError)}async function ZB(...B){await G.debug(...B)}function g(B){if(B&&typeof B==="object"){let H=B;if(typeof H.status==="number")return H.status;if(typeof H.statusCode==="number")return H.statusCode}return}function $B(B,H={}){let J=H.status??g(B),Q=typeof J==="number"&&J>=400&&J<500,U=H.label??"Unhandled error",Z={...H.context,...J!=null?{status:J}:{}};if(Q){G.debug(`${U} (client error ${J}): ${P(B).message}`);return}G.error(U,B,Z)}function D(B,H,J){let Q=V(),U={event:H,traceId:Q?.requestId,...J};if(B==="warn")z(G.warn(`[${H}]`,U));else z(G[B](U))}var o={request(B,H,J,Q,U={}){let Z=J>=500?"error":J>=400?"warn":"info";D(Z,"http.request",{method:B,path:H,status:J,durationMs:Q,...U})},query(B,H,J={}){D("debug","db.query",{sql:B,durationMs:H,...J})},slowQuery(B,H,J={}){D("warn","db.slow_query",{sql:B,durationMs:H,...J})},job(B,H,J={}){D(H==="failed"?"error":"info",`job.${H}`,{jobName:B,...J})},cache(B,H,J={}){D("debug",`cache.${B}`,{key:H,...J})}};G.struct=o;export{QB as withLogContext,JB as transports,o as struct,p as resolveLogSettings,$B as report,M as renderNormalizedError,HB as registerTransport,_ as parseLogLevel,m as parseLogFormat,P as normalizeError,E as normalizeContext,$ as logger,G as log,V as getLogContext,N as formatMessage,ZB as echo,UB as dump,XB as dd};
+var L=import.meta.require;import{AsyncLocalStorage as z}from"async_hooks";import s from"process";import{Logger as A}from"@stacksjs/clarity";import{handleError as V}from"@stacksjs/error-handling";import{ExitCode as x}from"@stacksjs/types";var b=null,v=null,E=new Set;function P(e){return E.add(e),e.finally(()=>E.delete(e)).catch(()=>{}),e}var O=!1;function D(){if(O)return;O=!0,s.on("beforeExit",()=>{g.flush()})}var u=[],T=new Set,C={debug:0,info:1,success:1,warning:2,error:3};function N(e){let t=e;if(!t||typeof t!=="object"||typeof t.log!=="function")return s.stderr.write(`[logging] Ignoring a transport without a log() function.
+`),null;if(typeof t.name!=="string"||!t.name)return s.stderr.write(`[logging] Ignoring a transport without a name.
+`),null;return u.push(t),()=>{let n=u.indexOf(t);if(n!==-1)u.splice(n,1)}}function ne(e){let t=N(e);if(!t)return()=>{};return I(),t}function re(){return[...u]}function l(e,t,n){if(u.length===0)return;let r;try{r={level:e,message:t,args:n,context:S(),timestamp:new Date().toISOString()}}catch{return}for(let o of u){if(o.level&&C[e]<C[o.level])continue;try{o.log(r)}catch(i){if(!T.has(o.name)){T.add(o.name);let p=i instanceof Error?i.message:String(i);s.stderr.write(`[logging] Transport "${o.name}" threw: ${p}. Further throws from it are silent.
+`)}}}}async function G(){let e=u.filter((t)=>typeof t.flush==="function").map((t)=>t.flush().catch(()=>{}));if(e.length>0)await Promise.allSettled(e)}var j=new Set(["debug","info","success","warning","error"]);function R(e,t="info"){if(!e)return t;let n=e.toLowerCase();if(n==="warn")return"warning";if(j.has(n))return n;return s.stderr.write(`[logging] Ignoring invalid LOG_LEVEL="${e}" (expected: ${[...j].join(", ")}); using "${t}".
+`),t}function M(e){if(e==="json"||e==="text")return e;if(e)s.stderr.write(`[logging] Ignoring invalid LOG_FORMAT="${e}" (expected "json" or "text").
+`);return s.env.NODE_ENV==="production"?"json":"text"}function W(e){let t=e.envLevel?R(e.envLevel):e.cfgLevel?R(e.cfgLevel):"info",n=e.envFormat?M(e.envFormat):e.cfgFormat==="json"||e.cfgFormat==="text"?e.cfgFormat:e.isProduction?"json":"text";return{level:t,format:n,writeToFile:e.cfgWriteToFile??!0}}function m(e,t=0){if(t>8)return{name:"Error",message:"[cause chain truncated]"};if(e instanceof Error)return{name:e.name,message:e.message,stack:e.stack,cause:e.cause!=null?m(e.cause,t+1):void 0};if(typeof e==="string")return{name:"Error",message:e};if(e==null)return{name:"Error",message:String(e)};try{return{name:"Error",message:JSON.stringify(w(e))}}catch{return{name:"Error",message:String(e)}}}function h(e){let t=e.stack||`${e.name}: ${e.message}`,n=e.cause;while(n)t+=`
+  caused by: ${n.stack||`${n.name}: ${n.message}`}`,n=n.cause;return t}function w(e,t=0){if(e instanceof Error)return m(e);if(t>=4||e===null||typeof e!=="object")return e;if(Array.isArray(e))return e.map((o)=>w(o,t+1));let n=Object.getPrototypeOf(e);if(n!==Object.prototype&&n!==null)return e;let r={};for(let[o,i]of Object.entries(e))r[o]=w(i,t+1);return r}function _(e){return w(e)}var k=new z;function oe(e,t){return k.run(e,t)}function S(){let e=k.getStore(),t=J();if(!t)return e;return{trace_id:t,...e}}function J(){try{let t=globalThis[Symbol.for("stacks.router.traceStorage")]?.getStore?.();if(t)return t;return globalThis[Symbol.for("stacks.router.requestStorage")]?.getStore?.()?._requestId}catch{return}}async function I(){if(b)return;if(v)return v;return D(),v=(async()=>{let e,t,n,r;try{let c=(await import("@stacksjs/config")).logging;if(c){if(e=c.level,t=c.format,typeof c.writeToFile==="boolean")r=c.writeToFile;if(c.logsPath)n=(await import("path")).dirname(c.logsPath);if(Array.isArray(c.transports))for(let F of c.transports)N(F)}}catch{}let{level:o,format:i,writeToFile:p}=W({envLevel:s.env.LOG_LEVEL,envFormat:s.env.LOG_FORMAT,cfgLevel:e,cfgFormat:t,cfgWriteToFile:r,isProduction:s.env.NODE_ENV==="production"}),f=n;if(!f)try{f=(await import("@stacksjs/path")).projectPath("storage/logs")}catch{f="storage/logs"}b=new A("stacks",{level:o,logDirectory:f,showTags:!1,fancy:i!=="json",format:i,writeToFile:p})})(),v}async function a(){return await I(),b}function d(...e){let t=e.filter((r)=>r!==void 0).map((r)=>{if(r instanceof Error)return h(m(r));if(typeof r==="object"&&r!==null)return JSON.stringify(w(r),null,2);return String(r)}).join(" "),n=k.getStore();if(n?.requestId)return`[${n.requestId}] ${t}`;return t}var K=new Set(["shouldExit","silent","message"]);function U(e){if(!e||typeof e!=="object"||e instanceof Error)return!1;if(!(("shouldExit"in e)||("silent"in e)))return!1;return Object.keys(e).every((t)=>K.has(t))}var g={info:async(...e)=>{let t=d(...e),n=await a();l("info",t,e),await n.info(t)},success:async(e)=>{let t=await a();l("success",e,[e]),await t.success(e)},warn:async(e,t)=>{let n=await a();if(l("warning",e,t===void 0?[e]:[e,t]),t==null){await n.warn(e);return}let r=w(t);await n.warn(e,r)},warning:async(e)=>{let t=await a();l("warning",e,[e]),await t.warn(e)},error:async(e,t,n)=>{let r=U(t)?t:void 0,o;if(typeof e==="string")o=e;else o=h(m(e));if(t!==void 0&&!r)o=`${o} ${h(m(t))}`;let i={...S(),...n};if(Object.keys(i).length>0)try{o=`${o} ${JSON.stringify(_(i))}`}catch{}let p=await a();if(l("error",o,r?[e]:[e,t,n].filter((f)=>f!==void 0)),await p.error(o),r?.shouldExit)V(e,r)},debug:async(...e)=>{let t=(s.env.LOG_LEVEL||"info").toLowerCase(),n=t==="info"||t==="warn"||t==="error";if(n&&u.length===0)return;let r=d(...e);if(n){l("debug",r,e);return}let o=await a();l("debug",r,e),await o.debug(r)},dump:async(...e)=>{let t=d(...e);await(await a()).debug(`DUMP: ${t}`)},dd:async(...e)=>{let t=d(...e);await(await a()).error(t),s.exit(x.FatalError)},echo:async(...e)=>{let t=d(...e);await(await a()).info(`ECHO: ${t}`)},time:(e)=>{let t=performance.now();return async(n)=>{let r=performance.now()-t,o=await a(),i=n?` ${JSON.stringify(_(n))}`:"";await o.info(`${e}: ${r.toFixed(2)}ms${i}`)}},syncWarn:(e)=>{s.stderr.write(`${e}
+`)},syncError:(e)=>{s.stderr.write(`${e}
+`)},fatal:(e,t=x.FatalError)=>{s.stderr.write(`${e}
+`),s.exit(t)},exit:async(e,t=x.Success)=>{if(e)await(t===x.Success?g.success(e):g.error(e));await g.flush(),s.exit(t)},flush:async()=>{if(E.size>0)await Promise.allSettled([...E]);if(await G(),!b&&!v)return;try{let e=await a(),t=e.flush;if(typeof t==="function")await t.call(e)}catch{}}};async function se(...e){for(let t of e)await g.debug(t)}async function ie(...e){let t=d(...e);console.log(t),s.exit(x.FatalError)}async function ae(...e){await g.debug(...e)}function Y(e){if(e&&typeof e==="object"){let t=e;if(typeof t.status==="number")return t.status;if(typeof t.statusCode==="number")return t.statusCode}return}function ge(e,t={}){let n=t.status??Y(e),r=typeof n==="number"&&n>=400&&n<500,o=t.label??"Unhandled error",i={...t.context,...n!=null?{status:n}:{}};if(r){g.debug(`${o} (client error ${n}): ${m(e).message}`);return}g.error(o,e,i)}function y(e,t,n){let r=S(),o={event:t,traceId:r?.requestId,...n};if(e==="warn")P(g.warn(`[${t}]`,o));else P(g[e](o))}var H={request(e,t,n,r,o={}){let i=n>=500?"error":n>=400?"warn":"info";y(i,"http.request",{method:e,path:t,status:n,durationMs:r,...o})},query(e,t,n={}){y("debug","db.query",{sql:e,durationMs:t,...n})},slowQuery(e,t,n={}){y("warn","db.slow_query",{sql:e,durationMs:t,...n})},job(e,t,n={}){y(t==="failed"?"error":"info",`job.${t}`,{jobName:e,...n})},cache(e,t,n={}){y("debug",`cache.${e}`,{key:t,...n})}};g.struct=H;export{ie as dd,se as dump,ae as echo,d as formatMessage,S as getLogContext,g as log,a as logger,_ as normalizeContext,m as normalizeError,M as parseLogFormat,R as parseLogLevel,ne as registerTransport,h as renderNormalizedError,ge as report,W as resolveLogSettings,H as struct,re as transports,oe as withLogContext};

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/logging",
   "type": "module",
   "sideEffects": false,
-  "version": "0.72.57",
+  "version": "0.72.61",
   "description": "The Stacks logging system.",
   "author": "Chris Breuer",
   "contributors": [
@@ -61,12 +61,12 @@
     "@stacksjs/clarity": "^0.3.33"
   },
   "devDependencies": {
-    "@stacksjs/cli": "0.72.57",
-    "@stacksjs/config": "0.72.57",
-    "@stacksjs/error-handling": "0.72.57",
-    "@stacksjs/path": "0.72.57",
-    "@stacksjs/storage": "0.72.57",
-    "@stacksjs/validation": "0.72.57",
+    "@stacksjs/cli": "0.72.61",
+    "@stacksjs/config": "0.72.61",
+    "@stacksjs/error-handling": "0.72.61",
+    "@stacksjs/path": "0.72.61",
+    "@stacksjs/storage": "0.72.61",
+    "@stacksjs/validation": "0.72.61",
     "better-dx": "^0.2.24"
   }
 }