logan-logger 2.5.1 → 2.5.2

package/dist/chunks/{config-DsFnr-rq.mjs → formatting-DTrgGC8g.mjs}

@@ -344,54 +344,27 @@ var D = class e extends f {
 	clearMeasures(e) {
 		typeof performance < "u" && performance.clearMeasures && performance.clearMeasures(e);
 	}
-};
-//#endregion
-//#region src/utils/formatting.ts
-function A(e, t = "text", n = {}) {
-	if (t === "json") {
-		let t = {
-			timestamp: e.timestamp.toISOString(),
-			level: u[e.level].toLowerCase(),
-			message: e.message,
-			runtime: e.runtime
-		};
-		return e.metadata !== void 0 && (t.metadata = e.metadata), g(t);
-	}
-	let r = n.timestamp === !1 ? "" : `[${e.timestamp.toISOString()}] `, i = j(e.level, n.colorize === !0), a = e.metadata ? ` ${g(e.metadata)}` : "";
-	return `${r}${i}: ${e.message}${a}`;
+}, A = /* @__PURE__ */ new Set();
+function j(e) {
+	A.has(e) || (A.add(e), console.warn(e));
 }
-function j(e, t = !1) {
-	let n = u[e].toUpperCase();
-	if (!t) return n;
-	let r = {
-		[u.DEBUG]: "\x1B[36m",
-		[u.INFO]: "\x1B[32m",
-		[u.WARN]: "\x1B[33m",
-		[u.ERROR]: "\x1B[31m",
-		[u.SILENT]: "\x1B[37m"
-	};
-	return `${r[e] || r[u.INFO]}${n}`;
+function M() {
+	A.clear();
 }
 //#endregion
-//#region src/utils/warn-once.ts
-var M = /* @__PURE__ */ new Set();
-function N(e) {
-	M.has(e) || (M.add(e), console.warn(e));
+//#region src/utils/config.ts
+function N() {
+	return e().capabilities.colorSupport ? typeof process > "u" || !process.env ? !0 : process.env.FORCE_COLOR ? process.env.FORCE_COLOR !== "0" : process.stdout?.isTTY === !0 : !1;
 }
 function P() {
-	M.clear();
+	return typeof process > "u" || !process.env ? !1 : !!process.env.NO_COLOR;
 }
-//#endregion
-//#region src/utils/config.ts
 function F() {
-	return e().capabilities.colorSupport ? typeof process > "u" || !process.env ? !0 : process.env.NO_COLOR ? !1 : process.env.FORCE_COLOR ? process.env.FORCE_COLOR !== "0" : process.stdout?.isTTY === !0 : !1;
-}
-function I() {
 	return {
 		level: u.INFO,
 		format: "text",
 		timestamp: !0,
-		colorize: F(),
+		colorize: N(),
 		metadata: {},
 		transports: [{
 			type: "console",
@@ -399,21 +372,21 @@ function I() {
 		}]
 	};
 }
-var L = [
+var I = [
 	"true",
 	"1",
 	"yes",
 	"on"
-], R = [
+], L = [
 	"false",
 	"0",
 	"no",
 	"off"
 ];
-function z() {
-	P();
+function R() {
+	M();
 }
-function B(e) {
+function z(e) {
 	switch (e.trim().toLowerCase()) {
 		case "debug": return u.DEBUG;
 		case "info": return u.INFO;
@@ -425,36 +398,36 @@ function B(e) {
 		default: return;
 	}
 }
-function V(e, t) {
+function B(e, t) {
 	let n = t.trim().toLowerCase();
-	if (L.includes(n)) return !0;
-	if (R.includes(n)) return !1;
-	N(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${L.join(", ")} / ${R.join(", ")}.`);
+	if (I.includes(n)) return !0;
+	if (L.includes(n)) return !1;
+	j(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${I.join(", ")} / ${L.join(", ")}.`);
 }
-function H() {
+function V() {
 	let e = {};
 	if (typeof process > "u" || !process.env) return e;
 	let t = process.env;
 	if (t.LOG_LEVEL !== void 0) {
-		let n = B(t.LOG_LEVEL);
-		n === void 0 ? N(`[logan-logger] LOG_LEVEL="${t.LOG_LEVEL}" is not a recognized level and was ignored. Accepted: debug, info, warn, error, silent.`) : e.level = n;
+		let n = z(t.LOG_LEVEL);
+		n === void 0 ? j(`[logan-logger] LOG_LEVEL="${t.LOG_LEVEL}" is not a recognized level and was ignored. Accepted: debug, info, warn, error, silent.`) : e.level = n;
 	}
 	if (t.LOG_FORMAT !== void 0) {
 		let n = t.LOG_FORMAT.trim().toLowerCase();
-		n === "json" || n === "text" ? e.format = n : N(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`);
+		n === "json" || n === "text" ? e.format = n : j(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`);
 	}
 	if (t.LOG_TIMESTAMP !== void 0) {
-		let n = V("LOG_TIMESTAMP", t.LOG_TIMESTAMP);
+		let n = B("LOG_TIMESTAMP", t.LOG_TIMESTAMP);
 		n !== void 0 && (e.timestamp = n);
 	}
 	if (t.LOG_COLOR !== void 0) {
-		let n = V("LOG_COLOR", t.LOG_COLOR);
-		n !== void 0 && (e.colorize = n);
+		let n = B("LOG_COLOR", t.LOG_COLOR);
+		n !== void 0 && (e.colorize = n), n === !0 && P() && j("[logan-logger] NO_COLOR is set and LOG_COLOR=true asks for color. NO_COLOR takes precedence: defaulting to no color.");
 	}
 	return e;
 }
-function U(...e) {
-	let t = I();
+function H(...e) {
+	let t = F();
 	return e.reduce((e, t) => ({
 		...e,
 		...t,
@@ -465,5 +438,38 @@ function U(...e) {
 		transports: t.transports || e.transports
 	}), t);
 }
+function U(e) {
+	return P() ? {
+		...e,
+		colorize: !1
+	} : e;
+}
+//#endregion
+//#region src/utils/formatting.ts
+function W(e, t = "text", n = {}) {
+	if (t === "json") {
+		let t = {
+			timestamp: e.timestamp.toISOString(),
+			level: u[e.level].toLowerCase(),
+			message: e.message,
+			runtime: e.runtime
+		};
+		return e.metadata !== void 0 && (t.metadata = e.metadata), g(t);
+	}
+	let r = n.timestamp === !1 ? "" : `[${e.timestamp.toISOString()}] `, i = G(e.level, n.colorize === !0), a = e.metadata ? ` ${g(e.metadata)}` : "";
+	return `${r}${i}: ${e.message}${a}`;
+}
+function G(e, t = !1) {
+	let n = u[e].toUpperCase();
+	if (!t) return n;
+	let r = {
+		[u.DEBUG]: "\x1B[36m",
+		[u.INFO]: "\x1B[32m",
+		[u.WARN]: "\x1B[33m",
+		[u.ERROR]: "\x1B[31m",
+		[u.SILENT]: "\x1B[37m"
+	};
+	return `${r[e] || r[u.INFO]}${n}`;
+}
 //#endregion
-export { i as S, u as _, F as a, s as b, j as c, O as d, k as f, f as g, E as h, z as i, A as l, g as m, H as n, B as o, C as p, U as r, N as s, I as t, D as u, e as v, o as x, a as y };
+export { o as C, s as S, E as _, V as a, e as b, R as c, j as d, D as f, g, C as h, F as i, N as l, k as m, W as n, H as o, O as p, U as r, P as s, G as t, z as u, f as v, i as w, a as x, u as y };

package/dist/chunks/{config-BoVokyIX.cjs → formatting-pzIQGL_7.cjs}

@@ -1 +1 @@
-function e(){let e=t();return{name:e,version:n(e),capabilities:r(e)}}function t(){return globalThis.Deno===void 0?globalThis.Bun===void 0?typeof window<`u`&&typeof document<`u`?`browser`:typeof globalThis.importScripts==`function`&&typeof window>`u`?`webworker`:typeof process<`u`&&process.versions&&process.versions.node?`node`:`unknown`:`bun`:`deno`}function n(e){switch(e){case`node`:return typeof process<`u`?process.version:void 0;case`deno`:return globalThis.Deno===void 0?void 0:globalThis.Deno.version?.deno;case`bun`:return globalThis.Bun===void 0?void 0:globalThis.Bun.version;case`browser`:return typeof navigator<`u`?navigator.userAgent:void 0;default:return}}function r(e){switch(e){case`node`:return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case`deno`:return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case`bun`:return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case`browser`:return{fileSystem:!1,colorSupport:!0,processInfo:!1,streams:!1};case`webworker`:return{fileSystem:!1,colorSupport:!1,processInfo:!1,streams:!1};default:return{fileSystem:!1,colorSupport:!1,processInfo:!1,streams:!1}}}function i(){return t()===`node`}function a(){return t()===`browser`}function o(){return t()===`deno`}function s(){return t()===`bun`}var c=Symbol.for(`logan-logger.internals`);function l(e){return e[c]??{}}var u=function(e){return e[e.DEBUG=0]=`DEBUG`,e[e.INFO=1]=`INFO`,e[e.WARN=2]=`WARN`,e[e.ERROR=3]=`ERROR`,e[e.SILENT=4]=`SILENT`,e}({}),d=()=>new Date,f=class{constructor(t={}){this.childMetadata={},this.config=t,this.level=t.level??u.INFO;let n=l(t);this.now=n.now??d,this.runtime=n.runtime??e().name,this.childMetadata={...t.metadata}}debug(e,t){this.log(u.DEBUG,e,t)}info(e,t){this.log(u.INFO,e,t)}warn(e,t){this.log(u.WARN,e,t)}error(e,t){this.log(u.ERROR,e,t)}log(e,t,n){if(!this.shouldLog(e))return;let r=typeof t==`function`?t():t,i={...this.childMetadata,...n},a={timestamp:this.now(),level:e,message:r,metadata:Object.keys(i).length>0?i:void 0,runtime:this.runtime};this.writeLog(a)}setLevel(e){this.level=e}getLevel(){return this.level}child(e){let t=this.createChild();return t.childMetadata={...this.childMetadata,...e},t}shouldLog(e){return e>=this.level}},p=100;function m(e,t,n,r){if(e===void 0)return`[undefined]`;if(typeof e==`bigint`)return`[BigInt: ${e.toString()}]`;if(typeof e==`symbol`)return`[Symbol: ${e.toString()}]`;if(typeof e==`function`)return`[Function: ${e.name||`anonymous`}]`;if(typeof e!=`object`||!e)return e;let i=e;if(t.has(i))return`[Circular]`;if(n>=r)return`[MaxDepth]`;t.add(i);try{if(i instanceof Error)return h(E(i),t,n,r);let e=i.toJSON;if(typeof e==`function`)return m(e.call(i),t,n,r);if(Array.isArray(i)){let e=[];for(let a=0;a<i.length;a++)e.push(m(i[a],t,n+1,r));return e}return h(i,t,n,r)}finally{t.delete(i)}}function h(e,t,n,r){let i={};for(let[a,o]of Object.entries(e))i[a]=m(o,t,n+1,r);return i}function g(e,t,n={}){let r=n.maxDepth??p;return JSON.stringify(m(e,new Set,0,r),null,t)}var _=[`password`,`token`,`secret`,`key`,`auth`,`authorization`,`apikey`,`authtoken`,`accesstoken`,`secretkey`],v=/[A-Z]+(?![a-z])|[A-Z]?[a-z]+|[0-9]+/g;function y(e){return(e.match(v)??[]).map(e=>e.toLowerCase())}function b(e){let t=[];for(let n of e){let e=y(n);if(e.length===0)continue;let r=e.join(``);t.push({tokens:e.map(e=>[e,`${e}s`]),joined:r,joinedPlural:`${r}s`})}return t}function x(e,t){let n=y(e);if(n.length===0)return!1;let r=n.join(``);return t.some(e=>e.tokens.every(([e,t])=>n.includes(e)||n.includes(t))||r===e.joined||r===e.joinedPlural)}function S(e,t,n){if(typeof e!=`object`||!e)return e;let r=n.get(e);if(r!==void 0)return r;let i=Array.isArray(e)?[]:{};n.set(e,i);for(let[r,a]of Object.entries(e))i[r]=x(r,t)?`[REDACTED]`:S(a,t,n);return i}function C(e,t=_){return S(e,b(t),new Map)}var w=[`name`,`message`,`stack`];function T(e,t){let n=Object.getOwnPropertyDescriptor(e,t);if(n){if(n.get)try{return n.get.call(e)}catch{return`[Throws]`}return n.value}}function E(e){if(!(e instanceof Error))return e;let t={name:e.name,message:e.message};e.stack!==void 0&&(t.stack=e.stack);for(let n of Object.getOwnPropertyNames(e))w.includes(n)||(t[n]=T(e,n));return t}var D=class e extends f{constructor(e={}){super(e)}writeLog(e){let t=this.formatMessage(e),n=this.getConsoleStyle(e.level),r=`%c${t}${e.metadata?` ${g(e.metadata)}`:``}`;switch(e.level){case u.DEBUG:console.debug?console.debug(r,n):console.log(r,n);break;case u.INFO:console.info(r,n);break;case u.WARN:console.warn(r,n);break;case u.ERROR:console.error(r,n)}}createChild(){return new e(this.config)}formatMessage(e){return`[${e.timestamp.toISOString()}] ${u[e.level].toUpperCase()}: ${e.message}`}getConsoleStyle(e){if(!this.config.colorize)return``;switch(e){case u.DEBUG:return`color: #888; font-weight: normal;`;case u.INFO:return`color: #007acc; font-weight: normal;`;case u.WARN:return`color: #ff8c00; font-weight: bold;`;case u.ERROR:return`color: #dc3545; font-weight: bold;`;default:return``}}shouldLogInProduction(){return(globalThis.process?.env?.NODE_ENV||globalThis.process?.env?.NEXT_PUBLIC_APP_ENV||`development`)!==`production`||this.level<=u.ERROR}shouldLog(e){return!this.shouldLogInProduction()&&e<u.ERROR?!1:super.shouldLog(e)}},O=class extends D{constructor(...e){super(...e),this.groupStack=[]}group(e){console.group(e),this.groupStack.push(e)}groupCollapsed(e){console.groupCollapsed(e),this.groupStack.push(e)}groupEnd(){console.groupEnd(),this.groupStack.pop()}getCurrentGroupStack(){return[...this.groupStack]}getCurrentGroupPath(){return this.groupStack.join(` > `)}time(e){console.time(e)}timeEnd(e){console.timeEnd(e)}trace(e,t){console.trace(e,t)}count(e){console.count(e)}countReset(e){console.countReset(e)}table(e){console.table(e)}},k=class extends D{mark(e){typeof performance<`u`&&performance.mark&&performance.mark(e)}measure(e,t,n){if(typeof performance<`u`&&performance.measure)try{performance.measure(e,t,n);let r=performance.getEntriesByName(e,`measure`);if(r.length>0){let t=r[r.length-1];this.info(`Performance: ${e}`,{duration:t.duration,startTime:t.startTime})}}catch(t){this.warn(`Failed to measure performance`,{name:e,error:t})}}clearMarks(e){typeof performance<`u`&&performance.clearMarks&&performance.clearMarks(e)}clearMeasures(e){typeof performance<`u`&&performance.clearMeasures&&performance.clearMeasures(e)}};function A(e,t=`text`,n={}){if(t===`json`){let t={timestamp:e.timestamp.toISOString(),level:u[e.level].toLowerCase(),message:e.message,runtime:e.runtime};return e.metadata!==void 0&&(t.metadata=e.metadata),g(t)}let r=n.timestamp===!1?``:`[${e.timestamp.toISOString()}] `,i=j(e.level,n.colorize===!0),a=e.metadata?` ${g(e.metadata)}`:``;return`${r}${i}: ${e.message}${a}`}function j(e,t=!1){let n=u[e].toUpperCase();if(!t)return n;let r={[u.DEBUG]:`\x1B[36m`,[u.INFO]:`\x1B[32m`,[u.WARN]:`\x1B[33m`,[u.ERROR]:`\x1B[31m`,[u.SILENT]:`\x1B[37m`};return`${r[e]||r[u.INFO]}${n}`}var M=new Set;function N(e){M.has(e)||(M.add(e),console.warn(e))}function P(){M.clear()}function F(){return e().capabilities.colorSupport?typeof process>`u`||!process.env?!0:process.env.NO_COLOR?!1:process.env.FORCE_COLOR?process.env.FORCE_COLOR!==`0`:process.stdout?.isTTY===!0:!1}function I(){return{level:u.INFO,format:`text`,timestamp:!0,colorize:F(),metadata:{},transports:[{type:`console`,options:{}}]}}var L=[`true`,`1`,`yes`,`on`],R=[`false`,`0`,`no`,`off`];function z(){P()}function B(e){switch(e.trim().toLowerCase()){case`debug`:return u.DEBUG;case`info`:return u.INFO;case`warn`:case`warning`:return u.WARN;case`error`:return u.ERROR;case`silent`:case`none`:return u.SILENT;default:return}}function V(e,t){let n=t.trim().toLowerCase();if(L.includes(n))return!0;if(R.includes(n))return!1;N(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${L.join(`, `)} / ${R.join(`, `)}.`)}function H(){let e={};if(typeof process>`u`||!process.env)return e;let t=process.env;if(t.LOG_LEVEL!==void 0){let n=B(t.LOG_LEVEL);n===void 0?N(`[logan-logger] LOG_LEVEL="${t.LOG_LEVEL}" is not a recognized level and was ignored. Accepted: debug, info, warn, error, silent.`):e.level=n}if(t.LOG_FORMAT!==void 0){let n=t.LOG_FORMAT.trim().toLowerCase();n===`json`||n===`text`?e.format=n:N(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`)}if(t.LOG_TIMESTAMP!==void 0){let n=V(`LOG_TIMESTAMP`,t.LOG_TIMESTAMP);n!==void 0&&(e.timestamp=n)}if(t.LOG_COLOR!==void 0){let n=V(`LOG_COLOR`,t.LOG_COLOR);n!==void 0&&(e.colorize=n)}return e}function U(...e){let t=I();return e.reduce((e,t)=>({...e,...t,metadata:{...e.metadata,...t.metadata},transports:t.transports||e.transports}),t)}Object.defineProperty(exports,"S",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return F}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return z}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return H}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return B}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return U}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return I}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return a}});
+function e(){let e=t();return{name:e,version:n(e),capabilities:r(e)}}function t(){return globalThis.Deno===void 0?globalThis.Bun===void 0?typeof window<`u`&&typeof document<`u`?`browser`:typeof globalThis.importScripts==`function`&&typeof window>`u`?`webworker`:typeof process<`u`&&process.versions&&process.versions.node?`node`:`unknown`:`bun`:`deno`}function n(e){switch(e){case`node`:return typeof process<`u`?process.version:void 0;case`deno`:return globalThis.Deno===void 0?void 0:globalThis.Deno.version?.deno;case`bun`:return globalThis.Bun===void 0?void 0:globalThis.Bun.version;case`browser`:return typeof navigator<`u`?navigator.userAgent:void 0;default:return}}function r(e){switch(e){case`node`:return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case`deno`:return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case`bun`:return{fileSystem:!0,colorSupport:!0,processInfo:!0,streams:!0};case`browser`:return{fileSystem:!1,colorSupport:!0,processInfo:!1,streams:!1};case`webworker`:return{fileSystem:!1,colorSupport:!1,processInfo:!1,streams:!1};default:return{fileSystem:!1,colorSupport:!1,processInfo:!1,streams:!1}}}function i(){return t()===`node`}function a(){return t()===`browser`}function o(){return t()===`deno`}function s(){return t()===`bun`}var c=Symbol.for(`logan-logger.internals`);function l(e){return e[c]??{}}var u=function(e){return e[e.DEBUG=0]=`DEBUG`,e[e.INFO=1]=`INFO`,e[e.WARN=2]=`WARN`,e[e.ERROR=3]=`ERROR`,e[e.SILENT=4]=`SILENT`,e}({}),d=()=>new Date,f=class{constructor(t={}){this.childMetadata={},this.config=t,this.level=t.level??u.INFO;let n=l(t);this.now=n.now??d,this.runtime=n.runtime??e().name,this.childMetadata={...t.metadata}}debug(e,t){this.log(u.DEBUG,e,t)}info(e,t){this.log(u.INFO,e,t)}warn(e,t){this.log(u.WARN,e,t)}error(e,t){this.log(u.ERROR,e,t)}log(e,t,n){if(!this.shouldLog(e))return;let r=typeof t==`function`?t():t,i={...this.childMetadata,...n},a={timestamp:this.now(),level:e,message:r,metadata:Object.keys(i).length>0?i:void 0,runtime:this.runtime};this.writeLog(a)}setLevel(e){this.level=e}getLevel(){return this.level}child(e){let t=this.createChild();return t.childMetadata={...this.childMetadata,...e},t}shouldLog(e){return e>=this.level}},p=100;function m(e,t,n,r){if(e===void 0)return`[undefined]`;if(typeof e==`bigint`)return`[BigInt: ${e.toString()}]`;if(typeof e==`symbol`)return`[Symbol: ${e.toString()}]`;if(typeof e==`function`)return`[Function: ${e.name||`anonymous`}]`;if(typeof e!=`object`||!e)return e;let i=e;if(t.has(i))return`[Circular]`;if(n>=r)return`[MaxDepth]`;t.add(i);try{if(i instanceof Error)return h(E(i),t,n,r);let e=i.toJSON;if(typeof e==`function`)return m(e.call(i),t,n,r);if(Array.isArray(i)){let e=[];for(let a=0;a<i.length;a++)e.push(m(i[a],t,n+1,r));return e}return h(i,t,n,r)}finally{t.delete(i)}}function h(e,t,n,r){let i={};for(let[a,o]of Object.entries(e))i[a]=m(o,t,n+1,r);return i}function g(e,t,n={}){let r=n.maxDepth??p;return JSON.stringify(m(e,new Set,0,r),null,t)}var _=[`password`,`token`,`secret`,`key`,`auth`,`authorization`,`apikey`,`authtoken`,`accesstoken`,`secretkey`],v=/[A-Z]+(?![a-z])|[A-Z]?[a-z]+|[0-9]+/g;function y(e){return(e.match(v)??[]).map(e=>e.toLowerCase())}function b(e){let t=[];for(let n of e){let e=y(n);if(e.length===0)continue;let r=e.join(``);t.push({tokens:e.map(e=>[e,`${e}s`]),joined:r,joinedPlural:`${r}s`})}return t}function x(e,t){let n=y(e);if(n.length===0)return!1;let r=n.join(``);return t.some(e=>e.tokens.every(([e,t])=>n.includes(e)||n.includes(t))||r===e.joined||r===e.joinedPlural)}function S(e,t,n){if(typeof e!=`object`||!e)return e;let r=n.get(e);if(r!==void 0)return r;let i=Array.isArray(e)?[]:{};n.set(e,i);for(let[r,a]of Object.entries(e))i[r]=x(r,t)?`[REDACTED]`:S(a,t,n);return i}function C(e,t=_){return S(e,b(t),new Map)}var w=[`name`,`message`,`stack`];function T(e,t){let n=Object.getOwnPropertyDescriptor(e,t);if(n){if(n.get)try{return n.get.call(e)}catch{return`[Throws]`}return n.value}}function E(e){if(!(e instanceof Error))return e;let t={name:e.name,message:e.message};e.stack!==void 0&&(t.stack=e.stack);for(let n of Object.getOwnPropertyNames(e))w.includes(n)||(t[n]=T(e,n));return t}var D=class e extends f{constructor(e={}){super(e)}writeLog(e){let t=this.formatMessage(e),n=this.getConsoleStyle(e.level),r=`%c${t}${e.metadata?` ${g(e.metadata)}`:``}`;switch(e.level){case u.DEBUG:console.debug?console.debug(r,n):console.log(r,n);break;case u.INFO:console.info(r,n);break;case u.WARN:console.warn(r,n);break;case u.ERROR:console.error(r,n)}}createChild(){return new e(this.config)}formatMessage(e){return`[${e.timestamp.toISOString()}] ${u[e.level].toUpperCase()}: ${e.message}`}getConsoleStyle(e){if(!this.config.colorize)return``;switch(e){case u.DEBUG:return`color: #888; font-weight: normal;`;case u.INFO:return`color: #007acc; font-weight: normal;`;case u.WARN:return`color: #ff8c00; font-weight: bold;`;case u.ERROR:return`color: #dc3545; font-weight: bold;`;default:return``}}shouldLogInProduction(){return(globalThis.process?.env?.NODE_ENV||globalThis.process?.env?.NEXT_PUBLIC_APP_ENV||`development`)!==`production`||this.level<=u.ERROR}shouldLog(e){return!this.shouldLogInProduction()&&e<u.ERROR?!1:super.shouldLog(e)}},O=class extends D{constructor(...e){super(...e),this.groupStack=[]}group(e){console.group(e),this.groupStack.push(e)}groupCollapsed(e){console.groupCollapsed(e),this.groupStack.push(e)}groupEnd(){console.groupEnd(),this.groupStack.pop()}getCurrentGroupStack(){return[...this.groupStack]}getCurrentGroupPath(){return this.groupStack.join(` > `)}time(e){console.time(e)}timeEnd(e){console.timeEnd(e)}trace(e,t){console.trace(e,t)}count(e){console.count(e)}countReset(e){console.countReset(e)}table(e){console.table(e)}},k=class extends D{mark(e){typeof performance<`u`&&performance.mark&&performance.mark(e)}measure(e,t,n){if(typeof performance<`u`&&performance.measure)try{performance.measure(e,t,n);let r=performance.getEntriesByName(e,`measure`);if(r.length>0){let t=r[r.length-1];this.info(`Performance: ${e}`,{duration:t.duration,startTime:t.startTime})}}catch(t){this.warn(`Failed to measure performance`,{name:e,error:t})}}clearMarks(e){typeof performance<`u`&&performance.clearMarks&&performance.clearMarks(e)}clearMeasures(e){typeof performance<`u`&&performance.clearMeasures&&performance.clearMeasures(e)}},A=new Set;function j(e){A.has(e)||(A.add(e),console.warn(e))}function M(){A.clear()}function N(){return e().capabilities.colorSupport?typeof process>`u`||!process.env?!0:process.env.FORCE_COLOR?process.env.FORCE_COLOR!==`0`:process.stdout?.isTTY===!0:!1}function P(){return typeof process>`u`||!process.env?!1:!!process.env.NO_COLOR}function F(){return{level:u.INFO,format:`text`,timestamp:!0,colorize:N(),metadata:{},transports:[{type:`console`,options:{}}]}}var I=[`true`,`1`,`yes`,`on`],L=[`false`,`0`,`no`,`off`];function R(){M()}function z(e){switch(e.trim().toLowerCase()){case`debug`:return u.DEBUG;case`info`:return u.INFO;case`warn`:case`warning`:return u.WARN;case`error`:return u.ERROR;case`silent`:case`none`:return u.SILENT;default:return}}function B(e,t){let n=t.trim().toLowerCase();if(I.includes(n))return!0;if(L.includes(n))return!1;j(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${I.join(`, `)} / ${L.join(`, `)}.`)}function V(){let e={};if(typeof process>`u`||!process.env)return e;let t=process.env;if(t.LOG_LEVEL!==void 0){let n=z(t.LOG_LEVEL);n===void 0?j(`[logan-logger] LOG_LEVEL="${t.LOG_LEVEL}" is not a recognized level and was ignored. Accepted: debug, info, warn, error, silent.`):e.level=n}if(t.LOG_FORMAT!==void 0){let n=t.LOG_FORMAT.trim().toLowerCase();n===`json`||n===`text`?e.format=n:j(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`)}if(t.LOG_TIMESTAMP!==void 0){let n=B(`LOG_TIMESTAMP`,t.LOG_TIMESTAMP);n!==void 0&&(e.timestamp=n)}if(t.LOG_COLOR!==void 0){let n=B(`LOG_COLOR`,t.LOG_COLOR);n!==void 0&&(e.colorize=n),n===!0&&P()&&j(`[logan-logger] NO_COLOR is set and LOG_COLOR=true asks for color. NO_COLOR takes precedence: defaulting to no color.`)}return e}function H(...e){let t=F();return e.reduce((e,t)=>({...e,...t,metadata:{...e.metadata,...t.metadata},transports:t.transports||e.transports}),t)}function U(e){return P()?{...e,colorize:!1}:e}function W(e,t=`text`,n={}){if(t===`json`){let t={timestamp:e.timestamp.toISOString(),level:u[e.level].toLowerCase(),message:e.message,runtime:e.runtime};return e.metadata!==void 0&&(t.metadata=e.metadata),g(t)}let r=n.timestamp===!1?``:`[${e.timestamp.toISOString()}] `,i=G(e.level,n.colorize===!0),a=e.metadata?` ${g(e.metadata)}`:``;return`${r}${i}: ${e.message}${a}`}function G(e,t=!1){let n=u[e].toUpperCase();if(!t)return n;let r={[u.DEBUG]:`\x1B[36m`,[u.INFO]:`\x1B[32m`,[u.WARN]:`\x1B[33m`,[u.ERROR]:`\x1B[31m`,[u.SILENT]:`\x1B[37m`};return`${r[e]||r[u.INFO]}${n}`}Object.defineProperty(exports,"C",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"S",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return V}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return R}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return F}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return W}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return H}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return O}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return U}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return P}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return G}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return z}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"w",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return u}});

package/dist/core/types.d.cts

@@ -69,6 +69,18 @@ export interface LoggerConfig {
      * operator can raise verbosity on a running service without a deploy. A
      * library that must pin its own logging regardless of the host application's
      * environment sets this instead.
+     *
+     * Those four variables and no others. `NO_COLOR` is unaffected: it is the end
+     * user's preference rather than the host application's setting, and it stays
+     * an override that nothing here can defeat. See SPEC §6.4.1.
+     *
+     * It does silence one diagnostic. The `NO_COLOR`/`LOG_COLOR=true`
+     * disagreement warning is emitted while reading the environment, which this
+     * flag skips, so with both variables set and this flag on, color is disabled
+     * and nothing is reported. Nothing is lost that the flag had not already
+     * discarded — `LOG_COLOR` was out of the running before `NO_COLOR` arrived,
+     * so the two never disagreed about anything that was going to be honored, and
+     * `LOG_COLOR="bogus"` goes equally unreported under this flag.
      */
     ignoreEnvironment?: boolean;
 }

package/dist/core/types.d.mts

@@ -69,6 +69,18 @@ export interface LoggerConfig {
      * operator can raise verbosity on a running service without a deploy. A
      * library that must pin its own logging regardless of the host application's
      * environment sets this instead.
+     *
+     * Those four variables and no others. `NO_COLOR` is unaffected: it is the end
+     * user's preference rather than the host application's setting, and it stays
+     * an override that nothing here can defeat. See SPEC §6.4.1.
+     *
+     * It does silence one diagnostic. The `NO_COLOR`/`LOG_COLOR=true`
+     * disagreement warning is emitted while reading the environment, which this
+     * flag skips, so with both variables set and this flag on, color is disabled
+     * and nothing is reported. Nothing is lost that the flag had not already
+     * discarded — `LOG_COLOR` was out of the running before `NO_COLOR` arrived,
+     * so the two never disagreed about anything that was going to be honored, and
+     * `LOG_COLOR="bogus"` goes equally unreported under this flag.
      */
     ignoreEnvironment?: boolean;
 }

package/dist/core/types.d.ts

@@ -69,6 +69,18 @@ export interface LoggerConfig {
      * operator can raise verbosity on a running service without a deploy. A
      * library that must pin its own logging regardless of the host application's
      * environment sets this instead.
+     *
+     * Those four variables and no others. `NO_COLOR` is unaffected: it is the end
+     * user's preference rather than the host application's setting, and it stays
+     * an override that nothing here can defeat. See SPEC §6.4.1.
+     *
+     * It does silence one diagnostic. The `NO_COLOR`/`LOG_COLOR=true`
+     * disagreement warning is emitted while reading the environment, which this
+     * flag skips, so with both variables set and this flag on, color is disabled
+     * and nothing is reported. Nothing is lost that the flag had not already
+     * discarded — `LOG_COLOR` was out of the running before `NO_COLOR` arrived,
+     * so the two never disagreed about anything that was going to be honored, and
+     * `LOG_COLOR="bogus"` goes equally unreported under this flag.
      */
     ignoreEnvironment?: boolean;
 }

package/dist/deno.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/config-BoVokyIX.cjs"),t=require("./chunks/config-file-C_hoT1V-.cjs");exports.BrowserLogger=e.u,exports.ConsoleGroupLogger=e.d,exports.ConsoleTransport=t.l,exports.PerformanceLogger=e.f,exports.createLogger=t.r,exports.createLoggerForEnvironment=t.i,exports.createTransports=t.u,exports.detectRuntime=e.v,exports.filterSensitiveData=e.p,exports.formatLevel=e.c,exports.formatLogEntry=e.l,exports.getDefaultConfig=e.t,exports.isBrowser=e.y,exports.isBun=e.b,exports.isDeno=e.x,exports.isNode=e.S,exports.loadConfigFromEnvironment=e.n,exports.loadConfigFromFile=t.t,exports.mergeConfigs=e.r,exports.registerTransport=t.f,exports.resetEnvironmentWarnings=e.i,exports.safeStringify=e.m,exports.serializeError=e.h,exports.shouldColorize=e.a,exports.tryParseLogLevel=e.o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/formatting-pzIQGL_7.cjs"),t=require("./chunks/config-file-Bi7lhPHV.cjs");exports.BrowserLogger=e.f,exports.ConsoleGroupLogger=e.p,exports.ConsoleTransport=t.l,exports.PerformanceLogger=e.m,exports.applyNoColorOverride=e.r,exports.createLogger=t.r,exports.createLoggerForEnvironment=t.i,exports.createTransports=t.u,exports.detectRuntime=e.b,exports.filterSensitiveData=e.h,exports.formatLevel=e.t,exports.formatLogEntry=e.n,exports.getDefaultConfig=e.i,exports.isBrowser=e.x,exports.isBun=e.S,exports.isDeno=e.C,exports.isNode=e.w,exports.loadConfigFromEnvironment=e.a,exports.loadConfigFromFile=t.t,exports.mergeConfigs=e.o,exports.noColorRequested=e.s,exports.registerTransport=t.f,exports.resetEnvironmentWarnings=e.c,exports.safeStringify=e.g,exports.serializeError=e._,exports.shouldColorize=e.l,exports.tryParseLogLevel=e.u;

package/dist/deno.mjs

@@ -1,3 +1,3 @@
-import { S as e, a as t, b as n, c as r, d as i, f as a, h as o, i as s, l as c, m as l, n as u, o as d, p as f, r as p, t as m, u as h, v as g, x as _, y as v } from "./chunks/config-DsFnr-rq.mjs";
-import { f as y, i as b, l as x, r as S, t as C, u as w } from "./chunks/config-file-z0J0xfos.mjs";
-export { h as BrowserLogger, i as ConsoleGroupLogger, x as ConsoleTransport, a as PerformanceLogger, S as createLogger, b as createLoggerForEnvironment, w as createTransports, g as detectRuntime, f as filterSensitiveData, r as formatLevel, c as formatLogEntry, m as getDefaultConfig, v as isBrowser, n as isBun, _ as isDeno, e as isNode, u as loadConfigFromEnvironment, C as loadConfigFromFile, p as mergeConfigs, y as registerTransport, s as resetEnvironmentWarnings, l as safeStringify, o as serializeError, t as shouldColorize, d as tryParseLogLevel };
+import { C as e, S as t, _ as n, a as r, b as i, c as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, w as y, x as b } from "./chunks/formatting-DTrgGC8g.mjs";
+import { f as x, i as S, l as C, r as w, t as T, u as E } from "./chunks/config-file-B2bCuTsh.mjs";
+export { o as BrowserLogger, m as ConsoleGroupLogger, C as ConsoleTransport, d as PerformanceLogger, h as applyNoColorOverride, w as createLogger, S as createLoggerForEnvironment, E as createTransports, i as detectRuntime, c as filterSensitiveData, _ as formatLevel, f as formatLogEntry, l as getDefaultConfig, b as isBrowser, t as isBun, e as isDeno, y as isNode, r as loadConfigFromEnvironment, T as loadConfigFromFile, p as mergeConfigs, g as noColorRequested, x as registerTransport, a as resetEnvironmentWarnings, s as safeStringify, n as serializeError, u as shouldColorize, v as tryParseLogLevel };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/config-BoVokyIX.cjs"),t=require("./chunks/config-file-C_hoT1V-.cjs");var n=t.i(),r={debug:(e,t)=>n.debug(e,t),info:(e,t)=>n.info(e,t),warn:(e,t)=>n.warn(e,t),error:(e,t)=>n.error(e,t)};exports.BaseLogger=e.g,exports.BrowserLogger=e.u,exports.ConsoleGroupLogger=e.d,exports.ConsoleTransport=t.l,exports.LogLevel=e._,exports.LoggerFactory=t.n,exports.PerformanceLogger=e.f,exports.createLogger=t.r,exports.createLoggerForEnvironment=t.i,exports.createTransports=t.u,exports.detectRuntime=e.v,exports.filterSensitiveData=e.p,exports.formatLevel=e.c,exports.formatLogEntry=e.l,exports.getDefaultConfig=e.t,exports.getTransportFactory=t.d,exports.isBrowser=e.y,exports.isBun=e.b,exports.isDeno=e.x,exports.isNode=e.S,exports.loadConfigFromEnvironment=e.n,exports.loadConfigFromFile=t.t,exports.log=r,exports.logLevelToString=t.a,exports.logger=n,exports.mergeConfigs=e.r,exports.registerTransport=t.f,exports.resetEnvironmentWarnings=e.i,exports.safeStringify=e.m,exports.serializeError=e.h,exports.shouldColorize=e.a,exports.stringToLogLevel=t.o,exports.tryParseLogLevel=e.o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/formatting-pzIQGL_7.cjs"),t=require("./chunks/config-file-Bi7lhPHV.cjs");var n=t.i(),r={debug:(e,t)=>n.debug(e,t),info:(e,t)=>n.info(e,t),warn:(e,t)=>n.warn(e,t),error:(e,t)=>n.error(e,t)};exports.BaseLogger=e.v,exports.BrowserLogger=e.f,exports.ConsoleGroupLogger=e.p,exports.ConsoleTransport=t.l,exports.LogLevel=e.y,exports.LoggerFactory=t.n,exports.PerformanceLogger=e.m,exports.applyNoColorOverride=e.r,exports.createLogger=t.r,exports.createLoggerForEnvironment=t.i,exports.createTransports=t.u,exports.detectRuntime=e.b,exports.filterSensitiveData=e.h,exports.formatLevel=e.t,exports.formatLogEntry=e.n,exports.getDefaultConfig=e.i,exports.getTransportFactory=t.d,exports.isBrowser=e.x,exports.isBun=e.S,exports.isDeno=e.C,exports.isNode=e.w,exports.loadConfigFromEnvironment=e.a,exports.loadConfigFromFile=t.t,exports.log=r,exports.logLevelToString=t.a,exports.logger=n,exports.mergeConfigs=e.o,exports.noColorRequested=e.s,exports.registerTransport=t.f,exports.resetEnvironmentWarnings=e.c,exports.safeStringify=e.g,exports.serializeError=e._,exports.shouldColorize=e.l,exports.stringToLogLevel=t.o,exports.tryParseLogLevel=e.u;

package/dist/index.mjs

@@ -1,11 +1,11 @@
-import { S as e, _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, t as g, u as _, v, x as y, y as b } from "./chunks/config-DsFnr-rq.mjs";
-import { a as x, d as S, f as C, i as w, l as T, n as E, o as D, r as O, t as k, u as A } from "./chunks/config-file-z0J0xfos.mjs";
+import { C as e, S as t, _ as n, a as r, b as i, c as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, v as y, w as b, x, y as S } from "./chunks/formatting-DTrgGC8g.mjs";
+import { a as C, d as w, f as T, i as E, l as D, n as O, o as k, r as A, t as j, u as M } from "./chunks/config-file-B2bCuTsh.mjs";
 //#region src/index.ts
-var j = w(), M = {
-	debug: (e, t) => j.debug(e, t),
-	info: (e, t) => j.info(e, t),
-	warn: (e, t) => j.warn(e, t),
-	error: (e, t) => j.error(e, t)
+var N = E(), P = {
+	debug: (e, t) => N.debug(e, t),
+	info: (e, t) => N.info(e, t),
+	warn: (e, t) => N.warn(e, t),
+	error: (e, t) => N.error(e, t)
 };
 //#endregion
-export { s as BaseLogger, _ as BrowserLogger, a as ConsoleGroupLogger, T as ConsoleTransport, t as LogLevel, E as LoggerFactory, o as PerformanceLogger, O as createLogger, w as createLoggerForEnvironment, A as createTransports, v as detectRuntime, m as filterSensitiveData, i as formatLevel, u as formatLogEntry, g as getDefaultConfig, S as getTransportFactory, b as isBrowser, r as isBun, y as isDeno, e as isNode, f as loadConfigFromEnvironment, k as loadConfigFromFile, M as log, x as logLevelToString, j as logger, h as mergeConfigs, C as registerTransport, l as resetEnvironmentWarnings, d as safeStringify, c as serializeError, n as shouldColorize, D as stringToLogLevel, p as tryParseLogLevel };
+export { y as BaseLogger, o as BrowserLogger, m as ConsoleGroupLogger, D as ConsoleTransport, S as LogLevel, O as LoggerFactory, d as PerformanceLogger, h as applyNoColorOverride, A as createLogger, E as createLoggerForEnvironment, M as createTransports, i as detectRuntime, c as filterSensitiveData, _ as formatLevel, f as formatLogEntry, l as getDefaultConfig, w as getTransportFactory, x as isBrowser, t as isBun, e as isDeno, b as isNode, r as loadConfigFromEnvironment, j as loadConfigFromFile, P as log, C as logLevelToString, N as logger, p as mergeConfigs, g as noColorRequested, T as registerTransport, a as resetEnvironmentWarnings, s as safeStringify, n as serializeError, u as shouldColorize, k as stringToLogLevel, v as tryParseLogLevel };

package/dist/node.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/config-file-C_hoT1V-.cjs"),t=require("./chunks/file-transport-93M9zaPy.cjs");exports.ConsoleTransport=e.l,exports.FileTransport=t.t,exports.NodeLogger=e.s,exports.createLogger=e.r,exports.createLoggerForEnvironment=e.i,exports.createMorganStream=e.c,exports.createTransports=e.u,exports.loadConfigFromFile=e.t,exports.registerTransport=e.f;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/config-file-Bi7lhPHV.cjs"),t=require("./chunks/file-transport-jelqRjCs.cjs");exports.ConsoleTransport=e.l,exports.FileTransport=t.t,exports.NodeLogger=e.s,exports.createLogger=e.r,exports.createLoggerForEnvironment=e.i,exports.createMorganStream=e.c,exports.createTransports=e.u,exports.loadConfigFromFile=e.t,exports.registerTransport=e.f;

package/dist/node.mjs

@@ -1,3 +1,3 @@
-import { c as e, f as t, i as n, l as r, r as i, s as a, t as o, u as s } from "./chunks/config-file-z0J0xfos.mjs";
-import { t as c } from "./chunks/file-transport-DF_YtZ1J.mjs";
+import { c as e, f as t, i as n, l as r, r as i, s as a, t as o, u as s } from "./chunks/config-file-B2bCuTsh.mjs";
+import { t as c } from "./chunks/file-transport-DtEHuVUw.mjs";
 export { r as ConsoleTransport, c as FileTransport, a as NodeLogger, i as createLogger, n as createLoggerForEnvironment, e as createMorganStream, s as createTransports, o as loadConfigFromFile, t as registerTransport };

package/dist/utils/config.d.cts

@@ -1,15 +1,44 @@
 import { LoggerConfig, LogLevel } from '../core/types.cjs';
 /**
- * Whether colored output is appropriate right now.
+ * Whether colored output is appropriate by default.
  *
  * `capabilities.colorSupport` answers whether the runtime *can* colorize.
  * This answers whether it *should*: writing ANSI escapes into a redirected
  * file or a log shipper is worse than writing none, so a non-TTY stdout
- * disables color unless the caller forces it. Honors the `NO_COLOR` and
- * `FORCE_COLOR` conventions.
- * @returns True when the level token should carry ANSI color
+ * disables color unless the caller forces it.
+ *
+ * This resolves the **default** only — every source in SPEC §6.2 outranks it.
+ * `NO_COLOR` is deliberately not consulted here: §6.4.1 makes it an override
+ * that beats every configuration source, so checking it at this layer would
+ * let `LOG_COLOR=true` or an explicit `colorize: true` defeat it. It is applied
+ * after the merge instead — see `noColorRequested`, `applyNoColorOverride`, and
+ * `createTransports`, which applies it again to per-transport options.
+ * @returns True when the level token should carry ANSI color by default
  */
 export declare function shouldColorize(): boolean;
+/**
+ * Whether the user has asked every program in this session not to emit color.
+ *
+ * SPEC §6.4.1. Presence is the entire signal and the value is meaningless, so
+ * `NO_COLOR=0` disables color exactly as `NO_COLOR=1` does. The value is read
+ * raw — neither trimmed nor case-folded — so a single space is a non-empty
+ * value and disables color.
+ *
+ * An empty string counts as **unset**, per no-color.org's own wording:
+ * "present and not an empty string". That is the exact opposite of the rule
+ * §6.3 imposes on `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP` and `LOG_COLOR`,
+ * where an empty value is *set*, matches nothing, and must warn — which is why
+ * `loadConfigFromEnvironment` below guards those with `!== undefined` rather
+ * than truthiness (#84).
+ *
+ * The two rules are opposite deliberately and **must not be reconciled**: §6.3
+ * governs variables in this library's namespace, where an empty value is a
+ * mistake worth reporting, while `NO_COLOR` is defined by a standard this
+ * library does not own and cannot revise. A truthiness test is correct here
+ * and a bug ninety lines further down.
+ * @returns True when `NO_COLOR` is set to a non-empty value
+ */
+export declare function noColorRequested(): boolean;
 export declare function getDefaultConfig(): LoggerConfig;
 /**
  * Reset the warn-once state, config file warnings included. Exposed for tests;
@@ -31,7 +60,61 @@ export declare function tryParseLogLevel(level: string): LogLevel | undefined;
  *
  * In a browser these values exist only if the bundler inlined them at build
  * time; otherwise this returns an empty object.
+ *
+ * **This reads the environment; it does not apply SPEC §6.4.1's `NO_COLOR`
+ * veto.** Called on its own under `NO_COLOR=1 LOG_COLOR=true` it emits the
+ * disagreement diagnostic and still returns `{ colorize: true }`: the message
+ * describes what the *resolved* configuration will do, not what this function
+ * did. `applyNoColorOverride` is what actually forces `colorize` off, and
+ * `createTransports` enforces it per transport. A caller assembling a
+ * configuration by hand from this function must apply the former, or let
+ * `createLogger()` do both.
  * @returns The subset of configuration the environment specifies
  */
 export declare function loadConfigFromEnvironment(): Partial<LoggerConfig>;
 export declare function mergeConfigs(...configs: Partial<LoggerConfig>[]): LoggerConfig;
+/**
+ * Apply SPEC §6.4.1's `NO_COLOR` override to an already-merged configuration.
+ *
+ * `NO_COLOR` is not another tier of §6.2's chain — it outranks all of it — so
+ * it cannot be expressed as one more argument to `mergeConfigs`, where anything
+ * later would beat it. That is precisely the bug this replaces: `shouldColorize()`
+ * consulted `NO_COLOR` at the defaults layer, so `LOG_COLOR=true` and an explicit
+ * `colorize: true` both silently defeated it.
+ *
+ * Precedence is the whole reason it is a separate step, and the only one. It is
+ * *not* that `mergeConfigs` must be kept clear of the environment: that function
+ * seeds itself with `getDefaultConfig()`, which calls `shouldColorize()`, which
+ * reads `FORCE_COLOR` and `process.stdout.isTTY`. It has always read the
+ * environment, and a purity argument here would be false.
+ *
+ * **`ignoreEnvironment` does not suppress this**, deliberately. That flag is
+ * documented as opting out of `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP` and
+ * `LOG_COLOR` by name, and it exists so a library is not hijacked by the *host
+ * application's* operational settings. `NO_COLOR` is a different kind of thing:
+ * the *end user's* preference, expressed to every program in their session. A
+ * library author who sets the flag for the documented reason must not silently
+ * also acquire "and ignore the user's `NO_COLOR`" — least of all because
+ * `ignoreEnvironment` is settable from a config file, which would let a file
+ * checked into a repository defeat every one of that project's users.
+ *
+ * **This is not the only place the veto is applied, and it must not be.** It
+ * rewrites the top-level `colorize` and nothing else, so a per-transport
+ * `options: { colorize: true }` sails straight past it — the console transport
+ * factory resolves `options.colorize ?? context.colorize`. `createTransports`
+ * therefore resolves `NO_COLOR` again when it builds each transport, which also
+ * covers a directly constructed `new NodeLogger(...)` that never reached this
+ * function. Between the two, no configuration source defeats `NO_COLOR`:
+ * neither `LOG_COLOR`, nor an explicit `colorize: true`, nor a config file, nor
+ * a per-transport option, nor `ignoreEnvironment`.
+ *
+ * What still does: bypassing configuration resolution entirely. `new
+ * BrowserLogger({ colorize: true })` reads `config.colorize` and consults no
+ * environment at all, so it honors neither `NO_COLOR` nor `LOG_COLOR` nor a
+ * config file. That is a property of constructing an adapter by hand rather
+ * than a hole in the veto, and `docs/configuration.md` says so where a reader
+ * meets `NO_COLOR`.
+ * @param config - The configuration after the whole precedence chain
+ * @returns The configuration with color forced off when `NO_COLOR` applies
+ */
+export declare function applyNoColorOverride(config: LoggerConfig): LoggerConfig;

package/dist/utils/config.d.mts

@@ -1,15 +1,44 @@
 import { LoggerConfig, LogLevel } from '../core/types.mjs';
 /**
- * Whether colored output is appropriate right now.
+ * Whether colored output is appropriate by default.
  *
  * `capabilities.colorSupport` answers whether the runtime *can* colorize.
  * This answers whether it *should*: writing ANSI escapes into a redirected
  * file or a log shipper is worse than writing none, so a non-TTY stdout
- * disables color unless the caller forces it. Honors the `NO_COLOR` and
- * `FORCE_COLOR` conventions.
- * @returns True when the level token should carry ANSI color
+ * disables color unless the caller forces it.
+ *
+ * This resolves the **default** only — every source in SPEC §6.2 outranks it.
+ * `NO_COLOR` is deliberately not consulted here: §6.4.1 makes it an override
+ * that beats every configuration source, so checking it at this layer would
+ * let `LOG_COLOR=true` or an explicit `colorize: true` defeat it. It is applied
+ * after the merge instead — see `noColorRequested`, `applyNoColorOverride`, and
+ * `createTransports`, which applies it again to per-transport options.
+ * @returns True when the level token should carry ANSI color by default
  */
 export declare function shouldColorize(): boolean;
+/**
+ * Whether the user has asked every program in this session not to emit color.
+ *
+ * SPEC §6.4.1. Presence is the entire signal and the value is meaningless, so
+ * `NO_COLOR=0` disables color exactly as `NO_COLOR=1` does. The value is read
+ * raw — neither trimmed nor case-folded — so a single space is a non-empty
+ * value and disables color.
+ *
+ * An empty string counts as **unset**, per no-color.org's own wording:
+ * "present and not an empty string". That is the exact opposite of the rule
+ * §6.3 imposes on `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP` and `LOG_COLOR`,
+ * where an empty value is *set*, matches nothing, and must warn — which is why
+ * `loadConfigFromEnvironment` below guards those with `!== undefined` rather
+ * than truthiness (#84).
+ *
+ * The two rules are opposite deliberately and **must not be reconciled**: §6.3
+ * governs variables in this library's namespace, where an empty value is a
+ * mistake worth reporting, while `NO_COLOR` is defined by a standard this
+ * library does not own and cannot revise. A truthiness test is correct here
+ * and a bug ninety lines further down.
+ * @returns True when `NO_COLOR` is set to a non-empty value
+ */
+export declare function noColorRequested(): boolean;
 export declare function getDefaultConfig(): LoggerConfig;
 /**
  * Reset the warn-once state, config file warnings included. Exposed for tests;
@@ -31,7 +60,61 @@ export declare function tryParseLogLevel(level: string): LogLevel | undefined;
  *
  * In a browser these values exist only if the bundler inlined them at build
  * time; otherwise this returns an empty object.
+ *
+ * **This reads the environment; it does not apply SPEC §6.4.1's `NO_COLOR`
+ * veto.** Called on its own under `NO_COLOR=1 LOG_COLOR=true` it emits the
+ * disagreement diagnostic and still returns `{ colorize: true }`: the message
+ * describes what the *resolved* configuration will do, not what this function
+ * did. `applyNoColorOverride` is what actually forces `colorize` off, and
+ * `createTransports` enforces it per transport. A caller assembling a
+ * configuration by hand from this function must apply the former, or let
+ * `createLogger()` do both.
  * @returns The subset of configuration the environment specifies
  */
 export declare function loadConfigFromEnvironment(): Partial<LoggerConfig>;
 export declare function mergeConfigs(...configs: Partial<LoggerConfig>[]): LoggerConfig;
+/**
+ * Apply SPEC §6.4.1's `NO_COLOR` override to an already-merged configuration.
+ *
+ * `NO_COLOR` is not another tier of §6.2's chain — it outranks all of it — so
+ * it cannot be expressed as one more argument to `mergeConfigs`, where anything
+ * later would beat it. That is precisely the bug this replaces: `shouldColorize()`
+ * consulted `NO_COLOR` at the defaults layer, so `LOG_COLOR=true` and an explicit
+ * `colorize: true` both silently defeated it.
+ *
+ * Precedence is the whole reason it is a separate step, and the only one. It is
+ * *not* that `mergeConfigs` must be kept clear of the environment: that function
+ * seeds itself with `getDefaultConfig()`, which calls `shouldColorize()`, which
+ * reads `FORCE_COLOR` and `process.stdout.isTTY`. It has always read the
+ * environment, and a purity argument here would be false.
+ *
+ * **`ignoreEnvironment` does not suppress this**, deliberately. That flag is
+ * documented as opting out of `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP` and
+ * `LOG_COLOR` by name, and it exists so a library is not hijacked by the *host
+ * application's* operational settings. `NO_COLOR` is a different kind of thing:
+ * the *end user's* preference, expressed to every program in their session. A
+ * library author who sets the flag for the documented reason must not silently
+ * also acquire "and ignore the user's `NO_COLOR`" — least of all because
+ * `ignoreEnvironment` is settable from a config file, which would let a file
+ * checked into a repository defeat every one of that project's users.
+ *
+ * **This is not the only place the veto is applied, and it must not be.** It
+ * rewrites the top-level `colorize` and nothing else, so a per-transport
+ * `options: { colorize: true }` sails straight past it — the console transport
+ * factory resolves `options.colorize ?? context.colorize`. `createTransports`
+ * therefore resolves `NO_COLOR` again when it builds each transport, which also
+ * covers a directly constructed `new NodeLogger(...)` that never reached this
+ * function. Between the two, no configuration source defeats `NO_COLOR`:
+ * neither `LOG_COLOR`, nor an explicit `colorize: true`, nor a config file, nor
+ * a per-transport option, nor `ignoreEnvironment`.
+ *
+ * What still does: bypassing configuration resolution entirely. `new
+ * BrowserLogger({ colorize: true })` reads `config.colorize` and consults no
+ * environment at all, so it honors neither `NO_COLOR` nor `LOG_COLOR` nor a
+ * config file. That is a property of constructing an adapter by hand rather
+ * than a hole in the veto, and `docs/configuration.md` says so where a reader
+ * meets `NO_COLOR`.
+ * @param config - The configuration after the whole precedence chain
+ * @returns The configuration with color forced off when `NO_COLOR` applies
+ */
+export declare function applyNoColorOverride(config: LoggerConfig): LoggerConfig;