logan-logger 1.1.21 → 1.2.0

package/dist/browser.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/browser-Bq67gUmd.cjs"),t=require("./chunks/formatting-Cb_xXgov.cjs");function n(){let t=e.l();return{level:e.c.INFO,format:`text`,timestamp:!0,colorize:t.capabilities.colorSupport,metadata:{},transports:[{type:`console`,options:{}}]}}function r(){return typeof process<`u`&&process.env?process.env.NODE_ENV||process.env.NEXT_PUBLIC_APP_ENV||process.env.ENVIRONMENT||`development`:typeof window<`u`&&globalThis.__ENV__||`development`}function i(t){switch(t){case`production`:return e.c.ERROR;case`staging`:case`test`:return e.c.WARN;case`development`:case`dev`:return e.c.DEBUG;default:return e.c.INFO}}function a(t={}){let r=n(),i={...r,...t,metadata:{...r.metadata,...t.metadata}};return new e.t(i)}function o(){let e=r();return a({level:i(e),colorize:e!==`production`,timestamp:!0,format:e===`production`?`json`:`text`})}var s=o(),c={debug:(e,t)=>s.debug(e,t),info:(e,t)=>s.info(e,t),warn:(e,t)=>s.warn(e,t),error:(e,t)=>s.error(e,t)};exports.BrowserLogger=e.t,exports.ConsoleGroupLogger=e.n,exports.LogLevel=e.c,exports.PerformanceLogger=e.r,exports.createLogger=a,exports.createLoggerForEnvironment=o,exports.detectRuntime=e.l,exports.filterSensitiveData=e.i,exports.formatLevel=t.t,exports.formatLogEntry=t.n,exports.isBrowser=e.u,exports.isBun=e.d,exports.isDeno=e.f,exports.isNode=e.p,exports.log=c,exports.logger=s,exports.safeStringify=e.a,exports.serializeError=e.o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/config-B48Pv18Z.cjs"),t=require("./chunks/formatting-DpOQuUe0.cjs");function n(){return typeof process<`u`&&process.env?process.env.NODE_ENV||process.env.NEXT_PUBLIC_APP_ENV||process.env.ENVIRONMENT||`development`:typeof window<`u`&&globalThis.__ENV__||`development`}function r(t){switch(t){case`production`:return e.p.ERROR;case`staging`:case`test`:return e.p.WARN;case`development`:case`dev`:return e.p.DEBUG;default:return e.p.INFO}}function i(t={}){let n=t.ignoreEnvironment?{}:e.n();return new e.o(e.r(t,n))}function a(){let e=n();return i({level:r(e),colorize:e!==`production`,timestamp:!0,format:e===`production`?`json`:`text`})}var o=a(),s={debug:(e,t)=>o.debug(e,t),info:(e,t)=>o.info(e,t),warn:(e,t)=>o.warn(e,t),error:(e,t)=>o.error(e,t)};exports.BrowserLogger=e.o,exports.ConsoleGroupLogger=e.s,exports.LogLevel=e.p,exports.PerformanceLogger=e.c,exports.createLogger=i,exports.createLoggerForEnvironment=a,exports.detectRuntime=e.m,exports.filterSensitiveData=e.l,exports.formatLevel=t.t,exports.formatLogEntry=t.n,exports.isBrowser=e.h,exports.isBun=e.g,exports.isDeno=e._,exports.isNode=e.v,exports.log=s,exports.logger=o,exports.safeStringify=e.u,exports.serializeError=e.d;

package/dist/browser.mjs

@@ -1,58 +1,37 @@
-import { a as e, c as t, d as n, f as r, i, l as a, n as o, o as s, p as c, r as l, t as u, u as d } from "./chunks/browser-D5QY2oJb.mjs";
-import { n as f, t as p } from "./chunks/formatting-CLctAPm9.mjs";
+import { _ as e, c as t, d as n, g as r, h as i, l as a, m as o, n as s, o as c, p as l, r as u, s as d, u as f, v as p } from "./chunks/config-BMoOvawe.mjs";
+import { n as m, t as h } from "./chunks/formatting-Dd2W74v3.mjs";
 //#region src/browser.ts
-function m() {
-	let e = a();
-	return {
-		level: t.INFO,
-		format: "text",
-		timestamp: !0,
-		colorize: e.capabilities.colorSupport,
-		metadata: {},
-		transports: [{
-			type: "console",
-			options: {}
-		}]
-	};
-}
-function h() {
+function g() {
 	return typeof process < "u" && process.env ? process.env.NODE_ENV || process.env.NEXT_PUBLIC_APP_ENV || process.env.ENVIRONMENT || "development" : typeof window < "u" && globalThis.__ENV__ || "development";
 }
-function g(e) {
+function _(e) {
 	switch (e) {
-		case "production": return t.ERROR;
+		case "production": return l.ERROR;
 		case "staging":
-		case "test": return t.WARN;
+		case "test": return l.WARN;
 		case "development":
-		case "dev": return t.DEBUG;
-		default: return t.INFO;
+		case "dev": return l.DEBUG;
+		default: return l.INFO;
 	}
 }
-function _(e = {}) {
-	let t = m(), n = {
-		...t,
-		...e,
-		metadata: {
-			...t.metadata,
-			...e.metadata
-		}
-	};
-	return new u(n);
+function v(e = {}) {
+	let t = e.ignoreEnvironment ? {} : s();
+	return new c(u(e, t));
 }
-function v() {
-	let e = h();
-	return _({
-		level: g(e),
+function y() {
+	let e = g();
+	return v({
+		level: _(e),
 		colorize: e !== "production",
 		timestamp: !0,
 		format: e === "production" ? "json" : "text"
 	});
 }
-var y = v(), b = {
-	debug: (e, t) => y.debug(e, t),
-	info: (e, t) => y.info(e, t),
-	warn: (e, t) => y.warn(e, t),
-	error: (e, t) => y.error(e, t)
+var b = y(), x = {
+	debug: (e, t) => b.debug(e, t),
+	info: (e, t) => b.info(e, t),
+	warn: (e, t) => b.warn(e, t),
+	error: (e, t) => b.error(e, t)
 };
 //#endregion
-export { u as BrowserLogger, o as ConsoleGroupLogger, t as LogLevel, l as PerformanceLogger, _ as createLogger, v as createLoggerForEnvironment, a as detectRuntime, i as filterSensitiveData, p as formatLevel, f as formatLogEntry, d as isBrowser, n as isBun, r as isDeno, c as isNode, b as log, y as logger, e as safeStringify, s as serializeError };
+export { c as BrowserLogger, d as ConsoleGroupLogger, l as LogLevel, t as PerformanceLogger, v as createLogger, y as createLoggerForEnvironment, o as detectRuntime, a as filterSensitiveData, h as formatLevel, m as formatLogEntry, i as isBrowser, r as isBun, e as isDeno, p as isNode, x as log, b as logger, f as safeStringify, n as serializeError };

package/dist/bun.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/factory-CluPoiZb.cjs"),t=require("./chunks/browser-Bq67gUmd.cjs"),n=require("./chunks/formatting-Cb_xXgov.cjs");exports.NodeLogger=e.u,exports.createLogger=e.n,exports.createLoggerForEnvironment=e.r,exports.detectRuntime=t.l,exports.filterSensitiveData=t.i,exports.formatLevel=n.t,exports.formatLogEntry=n.n,exports.getDefaultConfig=e.o,exports.isBrowser=t.u,exports.isBun=t.d,exports.isDeno=t.f,exports.isNode=t.p,exports.loadConfigFromEnvironment=e.s,exports.loadConfigFromFile=e.c,exports.mergeConfigs=e.l,exports.safeStringify=t.a,exports.serializeError=t.o;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/config-file-BBER_82d.cjs"),t=require("./chunks/config-B48Pv18Z.cjs"),n=require("./chunks/factory-BgsTZqNI.cjs"),r=require("./chunks/formatting-DpOQuUe0.cjs");exports.NodeLogger=n.o,exports.createLogger=n.n,exports.createLoggerForEnvironment=n.r,exports.detectRuntime=t.m,exports.filterSensitiveData=t.l,exports.formatLevel=r.t,exports.formatLogEntry=r.n,exports.getDefaultConfig=t.t,exports.isBrowser=t.h,exports.isBun=t.g,exports.isDeno=t._,exports.isNode=t.v,exports.loadConfigFromEnvironment=t.n,exports.loadConfigFromFile=e.t,exports.mergeConfigs=t.r,exports.resetEnvironmentWarnings=t.i,exports.safeStringify=t.u,exports.serializeError=t.d,exports.tryParseLogLevel=t.a;

package/dist/bun.d.cts

@@ -1,6 +1,7 @@
 export { createLogger, createLoggerForEnvironment } from './core/factory.cjs';
 export type { ILogger, LoggerConfig, LogLevel } from './core/types.cjs';
 export { NodeLogger } from './runtime/node.cjs';
+export * from './utils/config-file.cjs';
 export * from './utils/config.cjs';
 export * from './utils/formatting.cjs';
 export * from './utils/runtime.cjs';

package/dist/bun.d.mts

@@ -1,6 +1,7 @@
 export { createLogger, createLoggerForEnvironment } from './core/factory.mjs';
 export type { ILogger, LoggerConfig, LogLevel } from './core/types.mjs';
 export { NodeLogger } from './runtime/node.mjs';
+export * from './utils/config-file.mjs';
 export * from './utils/config.mjs';
 export * from './utils/formatting.mjs';
 export * from './utils/runtime.mjs';

package/dist/bun.d.ts

@@ -1,6 +1,7 @@
 export { createLogger, createLoggerForEnvironment } from './core/factory';
 export type { ILogger, LoggerConfig, LogLevel } from './core/types';
 export { NodeLogger } from './runtime/node';
+export * from './utils/config-file';
 export * from './utils/config';
 export * from './utils/formatting';
 export * from './utils/runtime';

package/dist/bun.mjs

@@ -1,4 +1,5 @@
-import { c as e, l as t, n, o as r, r as i, s as a, u as o } from "./chunks/factory-2po65gyH.mjs";
-import { a as s, d as c, f as l, i as u, l as d, o as f, p, u as m } from "./chunks/browser-D5QY2oJb.mjs";
-import { n as h, t as g } from "./chunks/formatting-CLctAPm9.mjs";
-export { o as NodeLogger, n as createLogger, i as createLoggerForEnvironment, d as detectRuntime, u as filterSensitiveData, g as formatLevel, h as formatLogEntry, r as getDefaultConfig, m as isBrowser, c as isBun, l as isDeno, p as isNode, a as loadConfigFromEnvironment, e as loadConfigFromFile, t as mergeConfigs, s as safeStringify, f as serializeError };
+import { t as e } from "./chunks/config-file-6g_8ruoz.mjs";
+import { _ as t, a as n, d as r, g as i, h as a, i as o, l as s, m as c, n as l, r as u, t as d, u as f, v as p } from "./chunks/config-BMoOvawe.mjs";
+import { n as m, o as h, r as g } from "./chunks/factory-C-jQh2-v.mjs";
+import { n as _, t as v } from "./chunks/formatting-Dd2W74v3.mjs";
+export { h as NodeLogger, m as createLogger, g as createLoggerForEnvironment, c as detectRuntime, s as filterSensitiveData, v as formatLevel, _ as formatLogEntry, d as getDefaultConfig, a as isBrowser, i as isBun, t as isDeno, p as isNode, l as loadConfigFromEnvironment, e as loadConfigFromFile, u as mergeConfigs, o as resetEnvironmentWarnings, f as safeStringify, r as serializeError, n as tryParseLogLevel };

package/dist/chunks/{__vite-browser-external-BgoQtmXf.mjs → __vite-browser-external-CoORGUub.mjs}

@@ -1,4 +1,4 @@
-import { f as e } from "./factory-2po65gyH.mjs";
+import { n as e } from "./config-file-6g_8ruoz.mjs";
 //#region __vite-browser-external
 var t = /* @__PURE__ */ e(((e, t) => {
 	t.exports = {};

package/dist/chunks/__vite-browser-external-cJWmSHhJ.cjs

@@ -0,0 +1 @@
+var e=require("./config-file-BBER_82d.cjs").n(((e,t)=>{t.exports={}}));Object.defineProperty(exports,"default",{enumerable:!0,get:function(){return e()}});

package/dist/chunks/config-B48Pv18Z.cjs

@@ -0,0 +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=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}({}),l=class{constructor(t={}){this.childMetadata={},this.config=t,this.level=t.level??c.INFO,this.runtime=e().name,this.childMetadata={...t.metadata}}debug(e,t){this.log(c.DEBUG,e,t)}info(e,t){this.log(c.INFO,e,t)}warn(e,t){this.log(c.WARN,e,t)}error(e,t){this.log(c.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:new Date,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}};function u(e,t){let n=new WeakSet;return JSON.stringify(e,(e,t)=>{if(typeof t==`object`&&t){if(n.has(t))return`[Circular]`;n.add(t)}return t instanceof Error?m(t):typeof t==`function`?`[Function: ${t.name||`anonymous`}]`:t===void 0?`[undefined]`:typeof t==`bigint`?`[BigInt: ${t.toString()}]`:typeof t==`symbol`?`[Symbol: ${t.toString()}]`:t},t)}function d(e,t=[`password`,`token`,`secret`,`key`,`auth`]){if(typeof e!=`object`||!e)return e;let n=Array.isArray(e)?[]:{};for(let[r,i]of Object.entries(e))n[r]=t.some(e=>r.toLowerCase().includes(e.toLowerCase()))?`[REDACTED]`:typeof i==`object`&&i?d(i,t):i;return n}var f=[`name`,`message`,`stack`];function p(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 m(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))f.includes(n)||(t[n]=p(e,n));return t}var h=class e extends l{constructor(e={}){super(e)}writeLog(e){let t=this.formatMessage(e),n=this.getConsoleStyle(e.level),r=`%c${t}${e.metadata?` ${u(e.metadata)}`:``}`;switch(e.level){case c.DEBUG:console.debug?console.debug(r,n):console.log(r,n);break;case c.INFO:console.info(r,n);break;case c.WARN:console.warn(r,n);break;case c.ERROR:console.error(r,n)}}createChild(){return new e(this.config)}formatMessage(e){return`[${e.timestamp.toISOString()}] ${c[e.level].toUpperCase()}: ${e.message}`}getConsoleStyle(e){if(!this.config.colorize)return``;switch(e){case c.DEBUG:return`color: #888; font-weight: normal;`;case c.INFO:return`color: #007acc; font-weight: normal;`;case c.WARN:return`color: #ff8c00; font-weight: bold;`;case c.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<=c.ERROR}shouldLog(e){return!this.shouldLogInProduction()&&e<c.ERROR?!1:super.shouldLog(e)}},g=class extends h{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)}},_=class extends h{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 v(){let t=e();return{level:c.INFO,format:`text`,timestamp:!0,colorize:t.capabilities.colorSupport,metadata:{},transports:[{type:`console`,options:{}}]}}var y=[`true`,`1`,`yes`,`on`],b=[`false`,`0`,`no`,`off`],x=new Set;function S(e){x.has(e)||(x.add(e),console.warn(e))}function C(){x.clear()}function w(e){switch(e.trim().toLowerCase()){case`debug`:return c.DEBUG;case`info`:return c.INFO;case`warn`:case`warning`:return c.WARN;case`error`:return c.ERROR;case`silent`:case`none`:return c.SILENT;default:return}}function T(e,t){let n=t.trim().toLowerCase();if(y.includes(n))return!0;if(b.includes(n))return!1;S(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${y.join(`, `)} / ${b.join(`, `)}.`)}function E(){let e={};if(typeof process>`u`||!process.env)return e;let t=process.env;if(t.LOG_LEVEL){let n=w(t.LOG_LEVEL);n===void 0?S(`[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){let n=t.LOG_FORMAT.trim().toLowerCase();n===`json`||n===`text`?e.format=n:S(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`)}if(t.LOG_TIMESTAMP){let n=T(`LOG_TIMESTAMP`,t.LOG_TIMESTAMP);n!==void 0&&(e.timestamp=n)}if(t.LOG_COLOR){let n=T(`LOG_COLOR`,t.LOG_COLOR);n!==void 0&&(e.colorize=n)}return e}function D(...e){let t=v();return e.reduce((e,t)=>({...e,...t,metadata:{...e.metadata,...t.metadata},transports:t.transports||e.transports}),t)}Object.defineProperty(exports,"_",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return D}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return i}});

package/dist/chunks/{browser-D5QY2oJb.mjs → config-BMoOvawe.mjs}

@@ -77,7 +77,7 @@ var c = /* @__PURE__ */ 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;
 }({}), l = class {
 	constructor(t = {}) {
-		this.childMetadata = {}, this.config = t, this.level = t.level ?? c.INFO, this.runtime = e().name;
+		this.childMetadata = {}, this.config = t, this.level = t.level ?? c.INFO, this.runtime = e().name, this.childMetadata = { ...t.metadata };
 	}
 	debug(e, t) {
 		this.log(c.DEBUG, e, t);
@@ -282,4 +282,89 @@ var h = class e extends l {
 	}
 };
 //#endregion
-export { u as a, c, s as d, o as f, d as i, e as l, g as n, m as o, i as p, _ as r, l as s, h as t, a as u };
+//#region src/utils/config.ts
+function v() {
+	let t = e();
+	return {
+		level: c.INFO,
+		format: "text",
+		timestamp: !0,
+		colorize: t.capabilities.colorSupport,
+		metadata: {},
+		transports: [{
+			type: "console",
+			options: {}
+		}]
+	};
+}
+var y = [
+	"true",
+	"1",
+	"yes",
+	"on"
+], b = [
+	"false",
+	"0",
+	"no",
+	"off"
+], x = /* @__PURE__ */ new Set();
+function S(e) {
+	x.has(e) || (x.add(e), console.warn(e));
+}
+function C() {
+	x.clear();
+}
+function w(e) {
+	switch (e.trim().toLowerCase()) {
+		case "debug": return c.DEBUG;
+		case "info": return c.INFO;
+		case "warn":
+		case "warning": return c.WARN;
+		case "error": return c.ERROR;
+		case "silent":
+		case "none": return c.SILENT;
+		default: return;
+	}
+}
+function T(e, t) {
+	let n = t.trim().toLowerCase();
+	if (y.includes(n)) return !0;
+	if (b.includes(n)) return !1;
+	S(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${y.join(", ")} / ${b.join(", ")}.`);
+}
+function E() {
+	let e = {};
+	if (typeof process > "u" || !process.env) return e;
+	let t = process.env;
+	if (t.LOG_LEVEL) {
+		let n = w(t.LOG_LEVEL);
+		n === void 0 ? S(`[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) {
+		let n = t.LOG_FORMAT.trim().toLowerCase();
+		n === "json" || n === "text" ? e.format = n : S(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`);
+	}
+	if (t.LOG_TIMESTAMP) {
+		let n = T("LOG_TIMESTAMP", t.LOG_TIMESTAMP);
+		n !== void 0 && (e.timestamp = n);
+	}
+	if (t.LOG_COLOR) {
+		let n = T("LOG_COLOR", t.LOG_COLOR);
+		n !== void 0 && (e.colorize = n);
+	}
+	return e;
+}
+function D(...e) {
+	let t = v();
+	return e.reduce((e, t) => ({
+		...e,
+		...t,
+		metadata: {
+			...e.metadata,
+			...t.metadata
+		},
+		transports: t.transports || e.transports
+	}), t);
+}
+//#endregion
+export { o as _, w as a, _ as c, m as d, l as f, s as g, a as h, C as i, d as l, e as m, E as n, h as o, c as p, D as r, g as s, v as t, u, i as v };

package/dist/chunks/config-file-6g_8ruoz.mjs

@@ -0,0 +1,68 @@
+import { m as e } from "./config-BMoOvawe.mjs";
+//#region \0rolldown/runtime.js
+var t = Object.create, n = Object.defineProperty, r = Object.getOwnPropertyDescriptor, i = Object.getOwnPropertyNames, a = Object.getPrototypeOf, o = Object.prototype.hasOwnProperty, s = (e, t) => () => (t || (e((t = { exports: {} }).exports, t), e = null), t.exports), c = (e, t, a, s) => {
+	if (t && typeof t == "object" || typeof t == "function") for (var c = i(t), l = 0, u = c.length, d; l < u; l++) d = c[l], !o.call(e, d) && d !== a && n(e, d, {
+		get: ((e) => t[e]).bind(null, d),
+		enumerable: !(s = r(t, d)) || s.enumerable
+	});
+	return e;
+}, l = (e, r, i) => (i = e == null ? {} : t(a(e)), c(r || !e || !e.__esModule || !o.call(e, "default") ? n(i, "default", {
+	value: e,
+	enumerable: !0
+}) : i, e));
+//#endregion
+//#region src/utils/config-file.ts
+async function u(t) {
+	let n = e();
+	if (!n.capabilities.fileSystem) return {};
+	let r = t ? [t] : [
+		"logan.config.json",
+		"logan.config.js",
+		".loganrc",
+		"package.json"
+	];
+	for (let e of r) try {
+		if (n.name === "node") return await d(e);
+		if (n.name === "deno") return await f(e);
+		if (n.name === "bun") return await p(e);
+	} catch {}
+	return {};
+}
+async function d(e) {
+	try {
+		let t = await import("./__vite-browser-external-CoORGUub.mjs").then((e) => /* @__PURE__ */ l(e.default)), n = await import("./__vite-browser-external-CoORGUub.mjs").then((e) => /* @__PURE__ */ l(e.default));
+		if (e.endsWith(".json")) {
+			let n = await t.readFile(e, "utf-8"), r = JSON.parse(n);
+			return e === "package.json" ? r.logan || {} : r;
+		}
+		if (e.endsWith(".js")) {
+			let t = await import(
+				/* @vite-ignore */
+				`file://${n.resolve(e)}`
+);
+			return t.default || t;
+		}
+	} catch {}
+	return {};
+}
+async function f(e) {
+	try {
+		if (e.endsWith(".json")) {
+			let t = await globalThis.Deno.readTextFile(e), n = JSON.parse(t);
+			return e === "package.json" ? n.logan || {} : n;
+		}
+		if (e.endsWith(".js")) {
+			let t = await import(
+				/* @vite-ignore */
+				`./${e}`
+);
+			return t.default || t;
+		}
+	} catch {}
+	return {};
+}
+async function p(e) {
+	return d(e);
+}
+//#endregion
+export { s as n, u as t };

package/dist/chunks/config-file-BBER_82d.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(t||(e((t={exports:{}}).exports,t),e=null),t.exports),s=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},c=(n,r,o)=>(o=n==null?{}:e(i(n)),s(r||!n||!n.__esModule||!a.call(n,`default`)?t(o,`default`,{value:n,enumerable:!0}):o,n));const l=require("./config-B48Pv18Z.cjs");async function u(e){let t=l.m();if(!t.capabilities.fileSystem)return{};let n=e?[e]:[`logan.config.json`,`logan.config.js`,`.loganrc`,`package.json`];for(let e of n)try{if(t.name===`node`)return await d(e);if(t.name===`deno`)return await f(e);if(t.name===`bun`)return await p(e)}catch{}return{}}async function d(e){try{let t=await Promise.resolve().then(()=>c(require("./__vite-browser-external-cJWmSHhJ.cjs").default)),n=await Promise.resolve().then(()=>c(require("./__vite-browser-external-cJWmSHhJ.cjs").default));if(e.endsWith(`.json`)){let n=await t.readFile(e,`utf-8`),r=JSON.parse(n);return e===`package.json`?r.logan||{}:r}if(e.endsWith(`.js`)){let t=await import(`file://${n.resolve(e)}`);return t.default||t}}catch{}return{}}async function f(e){try{if(e.endsWith(`.json`)){let t=await globalThis.Deno.readTextFile(e),n=JSON.parse(t);return e===`package.json`?n.logan||{}:n}if(e.endsWith(`.js`)){let t=await import(`./${e}`);return t.default||t}}catch{}return{}}async function p(e){return d(e)}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return u}});

package/dist/chunks/factory-BgsTZqNI.cjs

@@ -0,0 +1 @@
+const e=require("./config-B48Pv18Z.cjs");var t=class t extends e.f{constructor(e={}){super(e),this.initializeWinston()}async initializeWinston(){try{let e=await import(`winston`);this.winston=this.createWinstonLogger(e)}catch(e){console.warn(`[logan-logger] Winston not found, falling back to console logging:`,e)}}createWinstonLogger(e){let t=e.format.combine(e.format.timestamp({format:`YYYY-MM-DD HH:mm:ss`}),e.format.errors({stack:!0}),e.format.json(),e.format.prettyPrint()),n=e.format.combine(e.format.colorize(),e.format.timestamp({format:`HH:mm:ss`}),e.format.printf(({timestamp:e,level:t,message:n,...r})=>`${e} [${t}]: ${n} ${Object.keys(r).length?JSON.stringify(r,null,2):``}`)),r=e.createLogger({level:this.getWinstonLevel(this.level),format:t,transports:[new e.transports.Console({format:process.env.NODE_ENV===`production`?t:n})]});return process.env.NODE_ENV===`production`&&(r.add(new e.transports.File({filename:`logs/error.log`,level:`error`,maxsize:5242880,maxFiles:5})),r.add(new e.transports.File({filename:`logs/combined.log`,maxsize:5242880,maxFiles:10}))),r}writeLog(e){this.winston?this.winston.log({level:this.getWinstonLevel(e.level),message:e.message,timestamp:e.timestamp,...e.metadata}):this.writeToConsole(e)}createChild(){return new t(this.config)}writeToConsole(t){let n=t.timestamp.toISOString(),r=e.p[t.level].toLowerCase(),i=t.metadata?` ${e.u(t.metadata)}`:``,a=`[${n}] ${r.toUpperCase()}: ${t.message}${i}`;switch(t.level){case e.p.DEBUG:console.debug(a);break;case e.p.INFO:console.info(a);break;case e.p.WARN:console.warn(a);break;case e.p.ERROR:console.error(a)}}getWinstonLevel(t){switch(t){case e.p.DEBUG:return`debug`;case e.p.INFO:return`info`;case e.p.WARN:return`warn`;case e.p.ERROR:return`error`;default:return`info`}}setLevel(e){super.setLevel(e),this.winston&&(this.winston.level=this.getWinstonLevel(e))}};function n(e){return{write:t=>{e.info(t.trim())}}}var r=class n{static create(r={}){let i=e.m(),a=n.mergeConfig(r);switch(i.name){case`node`:return new t(a);case`deno`:return new e.o(a);case`bun`:return new t(a);case`browser`:case`webworker`:return new e.o(a);default:return new e.o(a)}}static createChild(e,t){return e.child(t)}static mergeConfig(t){let n=t.ignoreEnvironment?{}:e.n();return e.r(t,n)}};function i(e){return r.create(e)}function a(){let e=o();return i({level:s(e),colorize:e!==`production`,timestamp:!0,format:e===`production`?`json`:`text`})}function o(){return typeof process<`u`&&process.env?process.env.NODE_ENV||process.env.NEXT_PUBLIC_APP_ENV||process.env.ENVIRONMENT||`development`:typeof window<`u`&&globalThis.__ENV__||`development`}function s(t){switch(t){case`production`:return e.p.ERROR;case`staging`:case`test`:return e.p.WARN;case`development`:case`dev`:return e.p.DEBUG;default:return e.p.INFO}}function c(t){return e.a(t)??e.p.INFO}function l(t){switch(t){case e.p.DEBUG:return`debug`;case e.p.INFO:return`info`;case e.p.WARN:return`warn`;case e.p.ERROR:return`error`;case e.p.SILENT:return`silent`;default:return`info`}}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}});

package/dist/chunks/factory-C-jQh2-v.mjs

@@ -0,0 +1,137 @@
+import { a as e, f as t, m as n, n as r, o as i, p as a, r as o, u as s } from "./config-BMoOvawe.mjs";
+//#region src/runtime/node.ts
+var c = class e extends t {
+	constructor(e = {}) {
+		super(e), this.initializeWinston();
+	}
+	async initializeWinston() {
+		try {
+			let e = await import("winston");
+			this.winston = this.createWinstonLogger(e);
+		} catch (e) {
+			console.warn("[logan-logger] Winston not found, falling back to console logging:", e);
+		}
+	}
+	createWinstonLogger(e) {
+		let t = e.format.combine(e.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), e.format.errors({ stack: !0 }), e.format.json(), e.format.prettyPrint()), n = e.format.combine(e.format.colorize(), e.format.timestamp({ format: "HH:mm:ss" }), e.format.printf(({ timestamp: e, level: t, message: n, ...r }) => `${e} [${t}]: ${n} ${Object.keys(r).length ? JSON.stringify(r, null, 2) : ""}`)), r = e.createLogger({
+			level: this.getWinstonLevel(this.level),
+			format: t,
+			transports: [new e.transports.Console({ format: process.env.NODE_ENV === "production" ? t : n })]
+		});
+		return process.env.NODE_ENV === "production" && (r.add(new e.transports.File({
+			filename: "logs/error.log",
+			level: "error",
+			maxsize: 5242880,
+			maxFiles: 5
+		})), r.add(new e.transports.File({
+			filename: "logs/combined.log",
+			maxsize: 5242880,
+			maxFiles: 10
+		}))), r;
+	}
+	writeLog(e) {
+		this.winston ? this.winston.log({
+			level: this.getWinstonLevel(e.level),
+			message: e.message,
+			timestamp: e.timestamp,
+			...e.metadata
+		}) : this.writeToConsole(e);
+	}
+	createChild() {
+		return new e(this.config);
+	}
+	writeToConsole(e) {
+		let t = e.timestamp.toISOString(), n = a[e.level].toLowerCase(), r = e.metadata ? ` ${s(e.metadata)}` : "", i = `[${t}] ${n.toUpperCase()}: ${e.message}${r}`;
+		switch (e.level) {
+			case a.DEBUG:
+				console.debug(i);
+				break;
+			case a.INFO:
+				console.info(i);
+				break;
+			case a.WARN:
+				console.warn(i);
+				break;
+			case a.ERROR: console.error(i);
+		}
+	}
+	getWinstonLevel(e) {
+		switch (e) {
+			case a.DEBUG: return "debug";
+			case a.INFO: return "info";
+			case a.WARN: return "warn";
+			case a.ERROR: return "error";
+			default: return "info";
+		}
+	}
+	setLevel(e) {
+		super.setLevel(e), this.winston && (this.winston.level = this.getWinstonLevel(e));
+	}
+};
+function l(e) {
+	return { write: (t) => {
+		e.info(t.trim());
+	} };
+}
+//#endregion
+//#region src/core/factory.ts
+var u = class e {
+	static create(t = {}) {
+		let r = n(), a = e.mergeConfig(t);
+		switch (r.name) {
+			case "node": return new c(a);
+			case "deno": return new i(a);
+			case "bun": return new c(a);
+			case "browser":
+			case "webworker": return new i(a);
+			default: return new i(a);
+		}
+	}
+	static createChild(e, t) {
+		return e.child(t);
+	}
+	static mergeConfig(e) {
+		let t = e.ignoreEnvironment ? {} : r();
+		return o(e, t);
+	}
+};
+function d(e) {
+	return u.create(e);
+}
+function f() {
+	let e = p();
+	return d({
+		level: m(e),
+		colorize: e !== "production",
+		timestamp: !0,
+		format: e === "production" ? "json" : "text"
+	});
+}
+function p() {
+	return typeof process < "u" && process.env ? process.env.NODE_ENV || process.env.NEXT_PUBLIC_APP_ENV || process.env.ENVIRONMENT || "development" : typeof window < "u" && globalThis.__ENV__ || "development";
+}
+function m(e) {
+	switch (e) {
+		case "production": return a.ERROR;
+		case "staging":
+		case "test": return a.WARN;
+		case "development":
+		case "dev": return a.DEBUG;
+		default: return a.INFO;
+	}
+}
+function h(t) {
+	return e(t) ?? a.INFO;
+}
+function g(e) {
+	switch (e) {
+		case a.DEBUG: return "debug";
+		case a.INFO: return "info";
+		case a.WARN: return "warn";
+		case a.ERROR: return "error";
+		case a.SILENT: return "silent";
+		default: return "info";
+	}
+}
+//#endregion
+export { h as a, g as i, d as n, c as o, f as r, l as s, u as t };

package/dist/chunks/formatting-Dd2W74v3.mjs

@@ -0,0 +1,29 @@
+import { p as e, u as t } from "./config-BMoOvawe.mjs";
+//#region src/utils/formatting.ts
+function n(n, r = "text") {
+	if (r === "json") {
+		let r = {
+			timestamp: n.timestamp.toISOString(),
+			level: e[n.level].toLowerCase(),
+			message: n.message,
+			runtime: n.runtime
+		};
+		return n.metadata !== void 0 && (r.metadata = n.metadata), t(r);
+	}
+	let i = n.timestamp.toISOString(), a = e[n.level].toUpperCase(), o = n.metadata ? ` ${t(n.metadata)}` : "";
+	return `[${i}] ${a}: ${n.message}${o}`;
+}
+function r(t, n = !1) {
+	let r = e[t].toUpperCase();
+	if (!n) return r;
+	let i = {
+		[e.DEBUG]: "\x1B[36m",
+		[e.INFO]: "\x1B[32m",
+		[e.WARN]: "\x1B[33m",
+		[e.ERROR]: "\x1B[31m",
+		[e.SILENT]: "\x1B[37m"
+	};
+	return `${i[t] || i[e.INFO]}${r}`;
+}
+//#endregion
+export { n, r as t };

package/dist/chunks/formatting-DpOQuUe0.cjs

@@ -0,0 +1 @@
+const e=require("./config-B48Pv18Z.cjs");function t(t,n=`text`){if(n===`json`){let n={timestamp:t.timestamp.toISOString(),level:e.p[t.level].toLowerCase(),message:t.message,runtime:t.runtime};return t.metadata!==void 0&&(n.metadata=t.metadata),e.u(n)}let r=t.timestamp.toISOString(),i=e.p[t.level].toUpperCase(),a=t.metadata?` ${e.u(t.metadata)}`:``;return`[${r}] ${i}: ${t.message}${a}`}function n(t,n=!1){let r=e.p[t].toUpperCase();if(!n)return r;let i={[e.p.DEBUG]:`\x1B[36m`,[e.p.INFO]:`\x1B[32m`,[e.p.WARN]:`\x1B[33m`,[e.p.ERROR]:`\x1B[31m`,[e.p.SILENT]:`\x1B[37m`};return`${i[t]||i[e.p.INFO]}${r}`}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return n}});

package/dist/core/factory.d.cts

@@ -16,6 +16,20 @@ export declare class LoggerFactory {
      * @returns A new logger instance with the additional metadata
      */
     static createChild(parent: ILogger, metadata: Record<string, any>): ILogger;
+    /**
+     * Assemble the effective configuration.
+     *
+     * Precedence, lowest to highest:
+     *
+     *     library defaults  <  explicit config  <  environment variables
+     *
+     * Environment variables win so that an operator can change logging on a
+     * running service without a deploy. A consumer that must not be overridden
+     * that way sets `ignoreEnvironment: true`.
+     *
+     * The config-file link of the chain documented in `docs/environment-variables.md`
+     * is still missing: `loadConfigFromFile` is async and this path is not.
+     */
     private static mergeConfig;
 }
 /**
@@ -42,5 +56,13 @@ export declare function createLogger(config?: Partial<LoggerConfig>): ILogger;
  * @returns A logger instance configured for the current environment
  */
 export declare function createLoggerForEnvironment(): ILogger;
+/**
+ * Convert a level string to a `LogLevel`, falling back to INFO.
+ *
+ * Delegates to the single parser in `utils/config.ts`; use `tryParseLogLevel`
+ * directly when an unrecognized value should be distinguishable from `info`.
+ * @param level - The value to convert
+ * @returns The matching level, or `LogLevel.INFO`
+ */
 export declare function stringToLogLevel(level: string): LogLevel;
 export declare function logLevelToString(level: LogLevel): string;

package/dist/core/factory.d.mts

@@ -16,6 +16,20 @@ export declare class LoggerFactory {
      * @returns A new logger instance with the additional metadata
      */
     static createChild(parent: ILogger, metadata: Record<string, any>): ILogger;
+    /**
+     * Assemble the effective configuration.
+     *
+     * Precedence, lowest to highest:
+     *
+     *     library defaults  <  explicit config  <  environment variables
+     *
+     * Environment variables win so that an operator can change logging on a
+     * running service without a deploy. A consumer that must not be overridden
+     * that way sets `ignoreEnvironment: true`.
+     *
+     * The config-file link of the chain documented in `docs/environment-variables.md`
+     * is still missing: `loadConfigFromFile` is async and this path is not.
+     */
     private static mergeConfig;
 }
 /**
@@ -42,5 +56,13 @@ export declare function createLogger(config?: Partial<LoggerConfig>): ILogger;
  * @returns A logger instance configured for the current environment
  */
 export declare function createLoggerForEnvironment(): ILogger;
+/**
+ * Convert a level string to a `LogLevel`, falling back to INFO.
+ *
+ * Delegates to the single parser in `utils/config.ts`; use `tryParseLogLevel`
+ * directly when an unrecognized value should be distinguishable from `info`.
+ * @param level - The value to convert
+ * @returns The matching level, or `LogLevel.INFO`
+ */
 export declare function stringToLogLevel(level: string): LogLevel;
 export declare function logLevelToString(level: LogLevel): string;

package/dist/core/factory.d.ts

@@ -16,6 +16,20 @@ export declare class LoggerFactory {
      * @returns A new logger instance with the additional metadata
      */
     static createChild(parent: ILogger, metadata: Record<string, any>): ILogger;
+    /**
+     * Assemble the effective configuration.
+     *
+     * Precedence, lowest to highest:
+     *
+     *     library defaults  <  explicit config  <  environment variables
+     *
+     * Environment variables win so that an operator can change logging on a
+     * running service without a deploy. A consumer that must not be overridden
+     * that way sets `ignoreEnvironment: true`.
+     *
+     * The config-file link of the chain documented in `docs/environment-variables.md`
+     * is still missing: `loadConfigFromFile` is async and this path is not.
+     */
     private static mergeConfig;
 }
 /**
@@ -42,5 +56,13 @@ export declare function createLogger(config?: Partial<LoggerConfig>): ILogger;
  * @returns A logger instance configured for the current environment
  */
 export declare function createLoggerForEnvironment(): ILogger;
+/**
+ * Convert a level string to a `LogLevel`, falling back to INFO.
+ *
+ * Delegates to the single parser in `utils/config.ts`; use `tryParseLogLevel`
+ * directly when an unrecognized value should be distinguishable from `info`.
+ * @param level - The value to convert
+ * @returns The matching level, or `LogLevel.INFO`
+ */
 export declare function stringToLogLevel(level: string): LogLevel;
 export declare function logLevelToString(level: LogLevel): string;

package/dist/core/types.d.cts

@@ -62,6 +62,15 @@ export interface LoggerConfig {
     metadata: Record<string, any>;
     /** Transport configurations for log output */
     transports?: TransportConfig[];
+    /**
+     * Ignore `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP` and `LOG_COLOR`.
+     *
+     * Environment variables normally sit at the top of the precedence chain so an
+     * 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.
+     */
+    ignoreEnvironment?: boolean;
 }
 /**
  * Configuration for a specific log transport (output destination).