logan-logger 1.1.21 → 2.0.0

package/README.md

@@ -6,11 +6,15 @@
 
 A universal TypeScript logging library that works consistently across all JavaScript runtimes: Node.js, Deno, Bun, browsers, and WebAssembly environments.
 
+> **Upgrading from 1.x?** See the [2.0 migration guide](./docs/migration-2.0.md).
+> Winston is gone, file logging is opt-in, and repeated object references are no
+> longer reported as `[Circular]`.
+
 ## Features
 
 - 🌐 **Universal Runtime Support** - Works in Node.js, Deno, Bun, browsers, and WebAssembly
 - ⚛️ **Next.js Ready** - Full compatibility with App Router, Server Components, and API Routes
-- 🪶 **Zero Dependencies** - Core functionality with no required dependencies
+- 🪶 **Zero Dependencies** - No dependencies at all, required or optional, on any runtime
 - ⚡ **Performance First** - Lazy evaluation, zero-allocation logging, minimal memory footprint
 - 🎯 **TypeScript Native** - Full type safety with comprehensive type definitions
 - 🔧 **Flexible Configuration** - Environment-based auto-configuration or manual setup
@@ -170,13 +174,18 @@ const logger = createLoggerForEnvironment();
 
 Logan Logger provides runtime-specific entry points for optimal bundling and type safety:
 
-**🟢 Node.js with Winston Support:**
+**🟢 Node.js with file logging:**
 ```typescript
-import { createLogger, NodeLogger, createMorganStream } from 'logan-logger/node';
+import { createLogger, LogLevel, NodeLogger, createMorganStream } from 'logan-logger/node';
 
 const logger = new NodeLogger({
   transports: [
-    { type: 'file', options: { filename: 'app.log' } }
+    { type: 'console', options: {} },
+    {
+      type: 'file',
+      level: LogLevel.ERROR,
+      options: { filename: 'logs/error.log', maxsize: 5_242_880, maxFiles: 5 }
+    }
   ]
 });
 
@@ -184,6 +193,17 @@ const logger = new NodeLogger({
 app.use(morgan('combined', { stream: createMorganStream(logger) }));
 ```
 
+File logging is **opt-in**: with no `transports` configured a logger writes to the
+console and nowhere else, whatever `NODE_ENV` says. The log directory is created
+lazily on the first write, so a logger that is configured but never used touches
+the disk zero times.
+
+The `file` transport is registered by the `logan-logger/node` and
+`logan-logger/bun` entry points. It is deliberately absent from the main
+`logan-logger` entry so that `node:fs` never reaches a browser bundle — configure
+a file transport from the main entry and you get a warning telling you which
+entry point to import instead.
+
 **🌐 Browser-Optimized (Webpack/Vite-Safe):**
 ```typescript
 import { createLogger, BrowserLogger, PerformanceLogger } from 'logan-logger/browser';
@@ -240,7 +260,7 @@ logger.info('User processed', safeData);
 | Runtime | Import Path | Status | Implementation | Features |
 |---------|-------------|--------|----------------|----------|
 | **Next.js 13+** | `logan-logger` | ✅ **Full** | **Auto-detection** | **Server/Client Components, API Routes, Edge Runtime** |
-| Node.js 20+ | `logan-logger/node` | ✅ Full | Winston + Console | File logging, transports, Morgan integration |
+| Node.js 20+ | `logan-logger/node` | ✅ Full | Console + File transports | File logging with size rotation, custom transports, Morgan integration |
 | Bun | `logan-logger/bun` | ✅ Full | NodeLogger adapter | Same as Node.js |
 | Browser | `logan-logger/browser` | ✅ Full | Console API | CSS styling, performance marks, grouping |
 | Deno | `@logan/logger/deno` (JSR) | ✅ Basic | BrowserLogger adapter | Console logging (native implementation planned) |
@@ -264,10 +284,16 @@ enum LogLevel {
 ```bash
 LOG_LEVEL=debug      # debug, info, warn, error, silent
 LOG_FORMAT=json      # json, text
-LOG_TIMESTAMP=true   # true, false
-LOG_COLOR=false      # true, false
+LOG_TIMESTAMP=true   # true/1/yes/on, false/0/no/off
+LOG_COLOR=false      # true/1/yes/on, false/0/no/off
 ```
 
+These sit at the **top** of the precedence chain — above configuration passed to
+`createLogger()` — so an operator can change logging on a running service without
+a deploy. Opt out with `createLogger({ ..., ignoreEnvironment: true })`. A value
+that does not parse is ignored with a warning rather than silently resolving to a
+default.
+
 > **📋 See [Environment Variables Documentation](./docs/environment-variables.md) for complete details, examples, and runtime-specific considerations.**
 
 ### Configuration Options
@@ -282,6 +308,56 @@ interface LoggerConfig {
 }
 ```
 
+`timestamp` and `colorize` apply to the **text** form only. The JSON envelope
+always carries a timestamp and is never colorized, so a structured log stream
+stays parseable. `colorize` additionally defers to the terminal: ANSI escapes are
+suppressed when stdout is not a TTY, and the `NO_COLOR` / `FORCE_COLOR`
+conventions are honored.
+
+### Transports
+
+`transports` lists exactly where records go, in order. Omit it and you get the
+console alone.
+
+```typescript
+import { LogLevel, NodeLogger } from 'logan-logger/node';
+
+const logger = new NodeLogger({
+  transports: [
+    { type: 'console', options: { format: 'text', colorize: true } },
+    { type: 'file', level: LogLevel.ERROR, options: { filename: 'logs/error.log' } }
+  ]
+});
+```
+
+| Type | Available from | Options |
+|---|---|---|
+| `console` | everywhere | `format`, `timestamp`, `colorize` |
+| `file` | `logan-logger/node`, `logan-logger/bun` | `filename`, `maxsize`, `maxFiles`, `format`, `timestamp` |
+| `custom` | everywhere | `transport` — any object with a `write(entry)` method |
+
+Each transport is constructed behind its own guard: one failing to initialize
+warns and is dropped, and the rest keep working. The same applies at write time.
+
+A child logger **shares** its parent's transport instances, so
+`logger.child({ requestId })` per request costs no extra file handles.
+
+Plug in your own destination either inline:
+
+```typescript
+const logger = new NodeLogger({
+  transports: [{ type: 'custom', options: { transport: { type: 'syslog', write(entry) { /* … */ } } } }]
+});
+```
+
+or by name, so it can be selected from configuration:
+
+```typescript
+import { registerTransport } from 'logan-logger';
+
+registerTransport('syslog', (config, context) => new SyslogTransport(config.options));
+```
+
 ## API Reference
 
 ### Core Methods

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-PPDFSral.cjs");function t(){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 n(t){switch(t){case`production`:return e.g.ERROR;case`staging`:case`test`:return e.g.WARN;case`development`:case`dev`:return e.g.DEBUG;default:return e.g.INFO}}function r(t={}){let n=t.ignoreEnvironment?{}:e.n();return new e.l(e.r(t,n))}function i(){let e=t();return r({level:n(e),colorize:e!==`production`,timestamp:!0,format:e===`production`?`json`:`text`})}var a=i(),o={debug:(e,t)=>a.debug(e,t),info:(e,t)=>a.info(e,t),warn:(e,t)=>a.warn(e,t),error:(e,t)=>a.error(e,t)};exports.BrowserLogger=e.l,exports.ConsoleGroupLogger=e.u,exports.LogLevel=e.g,exports.PerformanceLogger=e.d,exports.createLogger=r,exports.createLoggerForEnvironment=i,exports.detectRuntime=e._,exports.filterSensitiveData=e.f,exports.formatLevel=e.s,exports.formatLogEntry=e.c,exports.isBrowser=e.v,exports.isBun=e.y,exports.isDeno=e.b,exports.isNode=e.x,exports.log=o,exports.logger=a,exports.safeStringify=e.p,exports.serializeError=e.m;

package/dist/browser.mjs

@@ -1,58 +1,36 @@
-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, b as t, c as n, d as r, f as i, g as a, l as o, m as s, n as c, p as l, r as u, s as d, u as f, v as p, x as m, y as h } from "./chunks/config-Db6PTLH2.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 a.ERROR;
 		case "staging":
-		case "test": return t.WARN;
+		case "test": return a.WARN;
 		case "development":
-		case "dev": return t.DEBUG;
-		default: return t.INFO;
+		case "dev": return a.DEBUG;
+		default: return a.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 ? {} : c();
+	return new o(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 { o as BrowserLogger, f as ConsoleGroupLogger, a as LogLevel, r as PerformanceLogger, v as createLogger, y as createLoggerForEnvironment, e as detectRuntime, i as filterSensitiveData, d as formatLevel, n as formatLogEntry, p as isBrowser, h as isBun, t as isDeno, m as isNode, x as log, b as logger, l as safeStringify, s 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-PPDFSral.cjs"),t=require("./chunks/factory-BPYE1-Nw.cjs"),n=require("./chunks/config-file-Dvyi1e80.cjs"),r=require("./chunks/file-transport-SA6KG1oM.cjs");exports.ConsoleTransport=t.c,exports.FileTransport=r.t,exports.NodeLogger=t.o,exports.createLogger=t.n,exports.createLoggerForEnvironment=t.r,exports.createTransports=t.l,exports.detectRuntime=e._,exports.filterSensitiveData=e.f,exports.formatLevel=e.s,exports.formatLogEntry=e.c,exports.getDefaultConfig=e.t,exports.isBrowser=e.v,exports.isBun=e.y,exports.isDeno=e.b,exports.isNode=e.x,exports.loadConfigFromEnvironment=e.n,exports.loadConfigFromFile=n.t,exports.mergeConfigs=e.r,exports.registerTransport=t.d,exports.resetEnvironmentWarnings=e.i,exports.safeStringify=e.p,exports.serializeError=e.m,exports.shouldColorize=e.a,exports.tryParseLogLevel=e.o;

package/dist/bun.d.cts

@@ -1,6 +1,9 @@
 export { createLogger, createLoggerForEnvironment } from './core/factory.cjs';
-export type { ILogger, LoggerConfig, LogLevel } from './core/types.cjs';
+export { ConsoleTransport, createTransports, registerTransport, type Transport, type TransportFactory, } from './core/transport.cjs';
+export type { ILogger, LoggerConfig, LogLevel, TransportConfig } from './core/types.cjs';
+export { FileTransport, type FileTransportOptions } from './runtime/file-transport.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,9 @@
 export { createLogger, createLoggerForEnvironment } from './core/factory.mjs';
-export type { ILogger, LoggerConfig, LogLevel } from './core/types.mjs';
+export { ConsoleTransport, createTransports, registerTransport, type Transport, type TransportFactory, } from './core/transport.mjs';
+export type { ILogger, LoggerConfig, LogLevel, TransportConfig } from './core/types.mjs';
+export { FileTransport, type FileTransportOptions } from './runtime/file-transport.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,9 @@
 export { createLogger, createLoggerForEnvironment } from './core/factory';
-export type { ILogger, LoggerConfig, LogLevel } from './core/types';
+export { ConsoleTransport, createTransports, registerTransport, type Transport, type TransportFactory, } from './core/transport';
+export type { ILogger, LoggerConfig, LogLevel, TransportConfig } from './core/types';
+export { FileTransport, type FileTransportOptions } from './runtime/file-transport';
 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 { _ as e, a as t, b as n, c as r, f as i, i as a, m as o, n as s, o as c, p as l, r as u, s as d, t as f, v as p, x as m, y as h } from "./chunks/config-Db6PTLH2.mjs";
+import { c as g, d as _, l as v, n as y, o as b, r as x } from "./chunks/factory-CXO2aNcc.mjs";
+import { t as S } from "./chunks/config-file-37L8z8Lm.mjs";
+import { t as C } from "./chunks/file-transport-DRyxQq8t.mjs";
+export { g as ConsoleTransport, C as FileTransport, b as NodeLogger, y as createLogger, x as createLoggerForEnvironment, v as createTransports, e as detectRuntime, i as filterSensitiveData, d as formatLevel, r as formatLogEntry, f as getDefaultConfig, p as isBrowser, h as isBun, n as isDeno, m as isNode, s as loadConfigFromEnvironment, S as loadConfigFromFile, u as mergeConfigs, _ as registerTransport, a as resetEnvironmentWarnings, l as safeStringify, o as serializeError, t as shouldColorize, c as tryParseLogLevel };

package/dist/chunks/{browser-D5QY2oJb.mjs → config-Db6PTLH2.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);
@@ -121,20 +121,41 @@ var c = /* @__PURE__ */ function(e) {
 	shouldLog(e) {
 		return e >= this.level;
 	}
-};
-//#endregion
-//#region src/utils/serialization.ts
-function u(e, t) {
-	let n = /* @__PURE__ */ new WeakSet();
-	return JSON.stringify(e, (e, t) => {
-		if (typeof t == "object" && t) {
-			if (n.has(t)) return "[Circular]";
-			n.add(t);
+}, u = 100;
+function d(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 f(_(i), t, n, r);
+		let e = i.toJSON;
+		if (typeof e == "function") return d(e.call(i), t, n, r);
+		if (Array.isArray(i)) {
+			let e = [];
+			for (let a = 0; a < i.length; a++) e.push(d(i[a], t, n + 1, r));
+			return e;
 		}
-		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);
+		return f(i, t, n, r);
+	} finally {
+		t.delete(i);
+	}
 }
-function d(e, t = [
+function f(e, t, n, r) {
+	let i = {};
+	for (let [a, o] of Object.entries(e)) i[a] = d(o, t, n + 1, r);
+	return i;
+}
+function p(e, t, n = {}) {
+	let r = n.maxDepth ?? u;
+	return JSON.stringify(d(e, /* @__PURE__ */ new Set(), 0, r), null, t);
+}
+function m(e, t = [
 	"password",
 	"token",
 	"secret",
@@ -143,15 +164,15 @@ function d(e, t = [
 ]) {
 	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;
+	for (let [r, i] of Object.entries(e)) n[r] = t.some((e) => r.toLowerCase().includes(e.toLowerCase())) ? "[REDACTED]" : typeof i == "object" && i ? m(i, t) : i;
 	return n;
 }
-var f = [
+var h = [
 	"name",
 	"message",
 	"stack"
 ];
-function p(e, t) {
+function g(e, t) {
 	let n = Object.getOwnPropertyDescriptor(e, t);
 	if (n) {
 		if (n.get) try {
@@ -162,24 +183,24 @@ function p(e, t) {
 		return n.value;
 	}
 }
-function m(e) {
+function _(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));
+	for (let n of Object.getOwnPropertyNames(e)) h.includes(n) || (t[n] = g(e, n));
 	return t;
 }
 //#endregion
 //#region src/runtime/browser.ts
-var h = class e extends l {
+var v = 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)}` : ""}`;
+		let t = this.formatMessage(e), n = this.getConsoleStyle(e.level), r = `%c${t}${e.metadata ? ` ${p(e.metadata)}` : ""}`;
 		switch (e.level) {
 			case c.DEBUG:
 				console.debug ? console.debug(r, n) : console.log(r, n);
@@ -215,7 +236,7 @@ var h = class e extends l {
 	shouldLog(e) {
 		return !this.shouldLogInProduction() && e < c.ERROR ? !1 : super.shouldLog(e);
 	}
-}, g = class extends h {
+}, y = class extends v {
 	constructor(...e) {
 		super(...e), this.groupStack = [];
 	}
@@ -252,7 +273,7 @@ var h = class e extends l {
 	table(e) {
 		console.table(e);
 	}
-}, _ = class extends h {
+}, b = class extends v {
 	mark(e) {
 		typeof performance < "u" && performance.mark && performance.mark(e);
 	}
@@ -282,4 +303,118 @@ 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/formatting.ts
+function x(e, t = "text", n = {}) {
+	if (t === "json") {
+		let t = {
+			timestamp: e.timestamp.toISOString(),
+			level: c[e.level].toLowerCase(),
+			message: e.message,
+			runtime: e.runtime
+		};
+		return e.metadata !== void 0 && (t.metadata = e.metadata), p(t);
+	}
+	let r = n.timestamp === !1 ? "" : `[${e.timestamp.toISOString()}] `, i = S(e.level, n.colorize === !0), a = e.metadata ? ` ${p(e.metadata)}` : "";
+	return `${r}${i}: ${e.message}${a}`;
+}
+function S(e, t = !1) {
+	let n = c[e].toUpperCase();
+	if (!t) return n;
+	let r = {
+		[c.DEBUG]: "\x1B[36m",
+		[c.INFO]: "\x1B[32m",
+		[c.WARN]: "\x1B[33m",
+		[c.ERROR]: "\x1B[31m",
+		[c.SILENT]: "\x1B[37m"
+	};
+	return `${r[e] || r[c.INFO]}${n}`;
+}
+//#endregion
+//#region src/utils/config.ts
+function C() {
+	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 w() {
+	return {
+		level: c.INFO,
+		format: "text",
+		timestamp: !0,
+		colorize: C(),
+		metadata: {},
+		transports: [{
+			type: "console",
+			options: {}
+		}]
+	};
+}
+var T = [
+	"true",
+	"1",
+	"yes",
+	"on"
+], E = [
+	"false",
+	"0",
+	"no",
+	"off"
+], D = /* @__PURE__ */ new Set();
+function O(e) {
+	D.has(e) || (D.add(e), console.warn(e));
+}
+function k() {
+	D.clear();
+}
+function A(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 j(e, t) {
+	let n = t.trim().toLowerCase();
+	if (T.includes(n)) return !0;
+	if (E.includes(n)) return !1;
+	O(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${T.join(", ")} / ${E.join(", ")}.`);
+}
+function M() {
+	let e = {};
+	if (typeof process > "u" || !process.env) return e;
+	let t = process.env;
+	if (t.LOG_LEVEL) {
+		let n = A(t.LOG_LEVEL);
+		n === void 0 ? O(`[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 : O(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`);
+	}
+	if (t.LOG_TIMESTAMP) {
+		let n = j("LOG_TIMESTAMP", t.LOG_TIMESTAMP);
+		n !== void 0 && (e.timestamp = n);
+	}
+	if (t.LOG_COLOR) {
+		let n = j("LOG_COLOR", t.LOG_COLOR);
+		n !== void 0 && (e.colorize = n);
+	}
+	return e;
+}
+function N(...e) {
+	let t = w();
+	return e.reduce((e, t) => ({
+		...e,
+		...t,
+		metadata: {
+			...e.metadata,
+			...t.metadata
+		},
+		transports: t.transports || e.transports
+	}), t);
+}
+//#endregion
+export { e as _, C as a, o as b, x as c, b as d, m as f, c as g, l as h, k as i, v as l, _ as m, M as n, A as o, p, N as r, S as s, w as t, y as u, a as v, i as x, s as y };

package/dist/chunks/config-PPDFSral.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}},u=100;function d(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 f(_(i),t,n,r);let e=i.toJSON;if(typeof e==`function`)return d(e.call(i),t,n,r);if(Array.isArray(i)){let e=[];for(let a=0;a<i.length;a++)e.push(d(i[a],t,n+1,r));return e}return f(i,t,n,r)}finally{t.delete(i)}}function f(e,t,n,r){let i={};for(let[a,o]of Object.entries(e))i[a]=d(o,t,n+1,r);return i}function p(e,t,n={}){let r=n.maxDepth??u;return JSON.stringify(d(e,new Set,0,r),null,t)}function m(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?m(i,t):i;return n}var h=[`name`,`message`,`stack`];function g(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){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))h.includes(n)||(t[n]=g(e,n));return t}var v=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?` ${p(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)}},y=class extends v{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)}},b=class extends v{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 x(e,t=`text`,n={}){if(t===`json`){let t={timestamp:e.timestamp.toISOString(),level:c[e.level].toLowerCase(),message:e.message,runtime:e.runtime};return e.metadata!==void 0&&(t.metadata=e.metadata),p(t)}let r=n.timestamp===!1?``:`[${e.timestamp.toISOString()}] `,i=S(e.level,n.colorize===!0),a=e.metadata?` ${p(e.metadata)}`:``;return`${r}${i}: ${e.message}${a}`}function S(e,t=!1){let n=c[e].toUpperCase();if(!t)return n;let r={[c.DEBUG]:`\x1B[36m`,[c.INFO]:`\x1B[32m`,[c.WARN]:`\x1B[33m`,[c.ERROR]:`\x1B[31m`,[c.SILENT]:`\x1B[37m`};return`${r[e]||r[c.INFO]}${n}`}function C(){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 w(){return{level:c.INFO,format:`text`,timestamp:!0,colorize:C(),metadata:{},transports:[{type:`console`,options:{}}]}}var T=[`true`,`1`,`yes`,`on`],E=[`false`,`0`,`no`,`off`],D=new Set;function O(e){D.has(e)||(D.add(e),console.warn(e))}function k(){D.clear()}function A(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 j(e,t){let n=t.trim().toLowerCase();if(T.includes(n))return!0;if(E.includes(n))return!1;O(`[logan-logger] ${e}="${t}" is not a recognized boolean and was ignored. Accepted: ${T.join(`, `)} / ${E.join(`, `)}.`)}function M(){let e={};if(typeof process>`u`||!process.env)return e;let t=process.env;if(t.LOG_LEVEL){let n=A(t.LOG_LEVEL);n===void 0?O(`[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:O(`[logan-logger] LOG_FORMAT="${t.LOG_FORMAT}" is not a recognized format and was ignored. Accepted: json, text.`)}if(t.LOG_TIMESTAMP){let n=j(`LOG_TIMESTAMP`,t.LOG_TIMESTAMP);n!==void 0&&(e.timestamp=n)}if(t.LOG_COLOR){let n=j(`LOG_COLOR`,t.LOG_COLOR);n!==void 0&&(e.colorize=n)}return e}function N(...e){let t=w();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 e}}),Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return C}}),Object.defineProperty(exports,"b",{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return x}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return b}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"g",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"h",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return k}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return _}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return A}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return N}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return S}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return y}}),Object.defineProperty(exports,"v",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"x",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"y",{enumerable:!0,get:function(){return s}});

package/dist/chunks/config-file-37L8z8Lm.mjs

@@ -0,0 +1,56 @@
+import { _ as e } from "./config-Db6PTLH2.mjs";
+//#region src/utils/config-file.ts
+async function t(t) {
+	let a = e();
+	if (!a.capabilities.fileSystem) return {};
+	let o = t ? [t] : [
+		"logan.config.json",
+		"logan.config.js",
+		".loganrc",
+		"package.json"
+	];
+	for (let e of o) try {
+		if (a.name === "node") return await n(e);
+		if (a.name === "deno") return await r(e);
+		if (a.name === "bun") return await i(e);
+	} catch {}
+	return {};
+}
+async function n(e) {
+	try {
+		let t = await import("node:fs/promises"), n = await import("node:path");
+		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 r(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 i(e) {
+	return n(e);
+}
+//#endregion
+export { t };

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

@@ -0,0 +1 @@
+const e=require("./config-PPDFSral.cjs");async function t(t){let a=e._();if(!a.capabilities.fileSystem)return{};let o=t?[t]:[`logan.config.json`,`logan.config.js`,`.loganrc`,`package.json`];for(let e of o)try{if(a.name===`node`)return await n(e);if(a.name===`deno`)return await r(e);if(a.name===`bun`)return await i(e)}catch{}return{}}async function n(e){try{let t=await import(`node:fs/promises`),n=await import(`node:path`);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 r(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 i(e){return n(e)}Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return t}});

package/dist/chunks/factory-BPYE1-Nw.cjs

@@ -0,0 +1 @@
+const e=require("./config-PPDFSral.cjs");var t=new Map;function n(e,n){t.set(e,n)}function r(e){return t.get(e)}var i=class{constructor(e={}){this.type=`console`,this.level=e.level,this.format=e.format===`json`?`json`:`text`,this.formatOptions={timestamp:e.timestamp!==!1,colorize:e.colorize===!0}}write(t){let n=e.c(t,this.format,this.formatOptions);switch(t.level){case e.g.DEBUG:console.debug(n);break;case e.g.WARN:console.warn(n);break;case e.g.ERROR:console.error(n);break;default:console.info(n)}}};n(`console`,(e,t)=>{let n=e.options??{};return new i({format:n.format??t.format,timestamp:n.timestamp??t.timestamp,colorize:n.colorize??t.colorize,level:e.level})}),n(`custom`,e=>{let t=e.options?.transport;if(!t||typeof t.write!=`function`)throw Error(`custom transport requires options.transport to be an object with a write(entry) method`);return e.level===void 0?t:{type:t.type??`custom`,level:e.level,write:e=>t.write(e),close:t.close?()=>t.close?.():void 0}});function a(e){let t={format:e.format??`text`,timestamp:e.timestamp??!0,colorize:e.colorize??!1};if(e.transports===void 0)return[new i({format:t.format,timestamp:t.timestamp,colorize:t.colorize})];let n=[];for(let i of e.transports){let e=r(i.type);if(!e){console.warn(`[logan-logger] ${o(i.type)}`);continue}try{n.push(e(i,t))}catch(e){console.warn(`[logan-logger] transport '${i.type}' failed to initialize:`,e)}}return n}function o(e){return e===`file`?`the 'file' transport is not registered; import from 'logan-logger/node' (or 'logan-logger/bun') rather than the main entry point to use file logging`:e===`http`?`the 'http' transport is not built in; supply one with { type: 'custom', options: { transport } }`:`unknown transport type '${e}'; skipping`}var s=class t extends e.h{constructor(e={},t){super(e),this.transports=t??a(e)}getTransports(){return this.transports}close(){for(let e of this.transports)e.close?.()}writeLog(e){for(let t of this.transports)if(!(t.level!==void 0&&e.level<t.level))try{t.write(e)}catch(e){console.warn(`[logan-logger] transport '${t.type}' failed to write:`,e)}}createChild(){return new t(this.config,this.transports)}};function c(e){return{write:t=>{e.info(t.trim())}}}var l=class t{static create(n={}){let r=e._(),i=t.mergeConfig(n);switch(r.name){case`node`:return new s(i);case`deno`:return new e.l(i);case`bun`:return new s(i);case`browser`:case`webworker`:return new e.l(i);default:return new e.l(i)}}static createChild(e,t){return e.child(t)}static mergeConfig(t){let n=t.ignoreEnvironment?{}:e.n();return e.r(t,n)}};function u(e){return l.create(e)}function d(){let t=f();return u({level:p(t),colorize:t!==`production`&&e.a(),timestamp:!0,format:t===`production`?`json`:`text`})}function f(){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 p(t){switch(t){case`production`:return e.g.ERROR;case`staging`:case`test`:return e.g.WARN;case`development`:case`dev`:return e.g.DEBUG;default:return e.g.INFO}}function m(t){return e.o(t)??e.g.INFO}function h(t){switch(t){case e.g.DEBUG:return`debug`;case e.g.INFO:return`info`;case e.g.WARN:return`warn`;case e.g.ERROR:return`error`;case e.g.SILENT:return`silent`;default:return`info`}}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return i}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return a}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return l}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return r}});