logan-logger 1.1.21 → 2.0.0

package/dist/chunks/factory-CXO2aNcc.mjs

@@ -0,0 +1,169 @@
+import { _ as e, a as t, c as n, g as r, h as i, l as a, n as o, o as s, r as c } from "./config-Db6PTLH2.mjs";
+//#region src/core/transport.ts
+var l = /* @__PURE__ */ new Map();
+function u(e, t) {
+	l.set(e, t);
+}
+function d(e) {
+	return l.get(e);
+}
+var f = 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(e) {
+		let t = n(e, this.format, this.formatOptions);
+		switch (e.level) {
+			case r.DEBUG:
+				console.debug(t);
+				break;
+			case r.WARN:
+				console.warn(t);
+				break;
+			case r.ERROR:
+				console.error(t);
+				break;
+			default: console.info(t);
+		}
+	}
+};
+u("console", (e, t) => {
+	let n = e.options ?? {};
+	return new f({
+		format: n.format ?? t.format,
+		timestamp: n.timestamp ?? t.timestamp,
+		colorize: n.colorize ?? t.colorize,
+		level: e.level
+	});
+}), u("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 p(e) {
+	let t = {
+		format: e.format ?? "text",
+		timestamp: e.timestamp ?? !0,
+		colorize: e.colorize ?? !1
+	};
+	if (e.transports === void 0) return [new f({
+		format: t.format,
+		timestamp: t.timestamp,
+		colorize: t.colorize
+	})];
+	let n = [];
+	for (let r of e.transports) {
+		let e = d(r.type);
+		if (!e) {
+			console.warn(`[logan-logger] ${m(r.type)}`);
+			continue;
+		}
+		try {
+			n.push(e(r, t));
+		} catch (e) {
+			console.warn(`[logan-logger] transport '${r.type}' failed to initialize:`, e);
+		}
+	}
+	return n;
+}
+function m(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`;
+}
+//#endregion
+//#region src/runtime/node.ts
+var h = class e extends i {
+	constructor(e = {}, t) {
+		super(e), this.transports = t ?? p(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 e(this.config, this.transports);
+	}
+};
+function g(e) {
+	return { write: (t) => {
+		e.info(t.trim());
+	} };
+}
+//#endregion
+//#region src/core/factory.ts
+var _ = class t {
+	static create(n = {}) {
+		let r = e(), i = t.mergeConfig(n);
+		switch (r.name) {
+			case "node": return new h(i);
+			case "deno": return new a(i);
+			case "bun": return new h(i);
+			case "browser":
+			case "webworker": return new a(i);
+			default: return new a(i);
+		}
+	}
+	static createChild(e, t) {
+		return e.child(t);
+	}
+	static mergeConfig(e) {
+		let t = e.ignoreEnvironment ? {} : o();
+		return c(e, t);
+	}
+};
+function v(e) {
+	return _.create(e);
+}
+function y() {
+	let e = b();
+	return v({
+		level: x(e),
+		colorize: e !== "production" && t(),
+		timestamp: !0,
+		format: e === "production" ? "json" : "text"
+	});
+}
+function b() {
+	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 x(e) {
+	switch (e) {
+		case "production": return r.ERROR;
+		case "staging":
+		case "test": return r.WARN;
+		case "development":
+		case "dev": return r.DEBUG;
+		default: return r.INFO;
+	}
+}
+function S(e) {
+	return s(e) ?? r.INFO;
+}
+function C(e) {
+	switch (e) {
+		case r.DEBUG: return "debug";
+		case r.INFO: return "info";
+		case r.WARN: return "warn";
+		case r.ERROR: return "error";
+		case r.SILENT: return "silent";
+		default: return "info";
+	}
+}
+//#endregion
+export { S as a, f as c, u as d, C as i, p as l, v as n, h as o, y as r, g as s, _ as t, d as u };

package/dist/chunks/file-transport-DRyxQq8t.mjs

@@ -0,0 +1,80 @@
+import { c as e } from "./config-Db6PTLH2.mjs";
+import { d as t } from "./factory-CXO2aNcc.mjs";
+import { closeSync as n, existsSync as r, fstatSync as i, mkdirSync as a, openSync as o, renameSync as s, unlinkSync as c, writeSync as l } from "node:fs";
+import { dirname as u, resolve as d } from "node:path";
+//#region src/runtime/file-transport.ts
+var f = 5242880, p = 5, m = class {
+	constructor(e) {
+		if (this.type = "file", this.size = 0, this.warned = !1, !e?.filename) throw Error("file transport requires options.filename");
+		this.path = d(e.filename), this.maxsize = e.maxsize ?? f, this.maxFiles = e.maxFiles ?? p, this.format = e.format === "text" ? "text" : "json", this.timestamp = e.timestamp !== !1, this.level = e.level;
+	}
+	get filename() {
+		return this.path;
+	}
+	write(t) {
+		let n = `${e(t, this.format, {
+			timestamp: this.timestamp,
+			colorize: !1
+		})}\n`;
+		try {
+			this.open(), this.maxsize > 0 && this.size >= this.maxsize && (this.rotate(), this.open()), this.size += l(this.fd, n);
+		} catch (e) {
+			this.warnOnce(e);
+		}
+	}
+	close() {
+		if (this.fd !== void 0) try {
+			n(this.fd);
+		} finally {
+			this.fd = void 0;
+		}
+	}
+	open() {
+		if (this.fd !== void 0) return;
+		let e = u(this.path);
+		try {
+			a(e, { recursive: !0 });
+		} catch (t) {
+			throw h("create log directory", e, t);
+		}
+		try {
+			this.fd = o(this.path, "a");
+		} catch (e) {
+			throw h("open log file", this.path, e);
+		}
+		this.size = i(this.fd).size;
+	}
+	rotate() {
+		if (this.close(), this.maxFiles <= 0) {
+			r(this.path) && c(this.path), this.size = 0;
+			return;
+		}
+		let e = `${this.path}.${this.maxFiles}`;
+		r(e) && c(e);
+		for (let e = this.maxFiles - 1; e >= 1; e--) {
+			let t = `${this.path}.${e}`;
+			r(t) && s(t, `${this.path}.${e + 1}`);
+		}
+		r(this.path) && s(this.path, `${this.path}.1`), this.size = 0;
+	}
+	warnOnce(e) {
+		this.close(), !this.warned && (this.warned = !0, console.warn(`[logan-logger] file transport for '${this.path}' failed and will keep retrying quietly:`, e instanceof Error ? e.message : e));
+	}
+};
+function h(e, t, n) {
+	let r = n, i = r?.code ? ` [${r.code}]` : "", a = r?.syscall ? ` during ${r.syscall}` : "", o = /* @__PURE__ */ Error(`could not ${e} '${t}'${i}${a}: ${r?.message ?? n}`);
+	return o.cause = n, o;
+}
+t("file", (e, t) => {
+	let n = e.options ?? {};
+	return new m({
+		filename: n.filename,
+		maxsize: n.maxsize,
+		maxFiles: n.maxFiles,
+		format: n.format,
+		timestamp: n.timestamp ?? t.timestamp,
+		level: e.level
+	});
+});
+//#endregion
+export { m as t };

package/dist/chunks/file-transport-SA6KG1oM.cjs

@@ -0,0 +1 @@
+const e=require("./config-PPDFSral.cjs"),t=require("./factory-BPYE1-Nw.cjs");let n=require("node:fs"),r=require("node:path");var i=5242880,a=5,o=class{constructor(e){if(this.type=`file`,this.size=0,this.warned=!1,!e?.filename)throw Error(`file transport requires options.filename`);this.path=(0,r.resolve)(e.filename),this.maxsize=e.maxsize??i,this.maxFiles=e.maxFiles??a,this.format=e.format===`text`?`text`:`json`,this.timestamp=e.timestamp!==!1,this.level=e.level}get filename(){return this.path}write(t){let r=`${e.c(t,this.format,{timestamp:this.timestamp,colorize:!1})}\n`;try{this.open(),this.maxsize>0&&this.size>=this.maxsize&&(this.rotate(),this.open()),this.size+=(0,n.writeSync)(this.fd,r)}catch(e){this.warnOnce(e)}}close(){if(this.fd!==void 0)try{(0,n.closeSync)(this.fd)}finally{this.fd=void 0}}open(){if(this.fd!==void 0)return;let e=(0,r.dirname)(this.path);try{(0,n.mkdirSync)(e,{recursive:!0})}catch(t){throw s(`create log directory`,e,t)}try{this.fd=(0,n.openSync)(this.path,`a`)}catch(e){throw s(`open log file`,this.path,e)}this.size=(0,n.fstatSync)(this.fd).size}rotate(){if(this.close(),this.maxFiles<=0){(0,n.existsSync)(this.path)&&(0,n.unlinkSync)(this.path),this.size=0;return}let e=`${this.path}.${this.maxFiles}`;(0,n.existsSync)(e)&&(0,n.unlinkSync)(e);for(let e=this.maxFiles-1;e>=1;e--){let t=`${this.path}.${e}`;(0,n.existsSync)(t)&&(0,n.renameSync)(t,`${this.path}.${e+1}`)}(0,n.existsSync)(this.path)&&(0,n.renameSync)(this.path,`${this.path}.1`),this.size=0}warnOnce(e){this.close(),!this.warned&&(this.warned=!0,console.warn(`[logan-logger] file transport for '${this.path}' failed and will keep retrying quietly:`,e instanceof Error?e.message:e))}};function s(e,t,n){let r=n,i=r?.code?` [${r.code}]`:``,a=r?.syscall?` during ${r.syscall}`:``,o=Error(`could not ${e} '${t}'${i}${a}: ${r?.message??n}`);return o.cause=n,o}t.d(`file`,(e,t)=>{let n=e.options??{};return new o({filename:n.filename,maxsize:n.maxsize,maxFiles:n.maxFiles,format:n.format,timestamp:n.timestamp??t.timestamp,level:e.level})}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return o}});

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/transport.d.cts

@@ -0,0 +1,73 @@
+import { FormatOptions } from '../utils/formatting.cjs';
+import { LogEntry, LoggerConfig, LogLevel, TransportConfig } from './types.cjs';
+/**
+ * A destination log entries are written to.
+ *
+ * Transports are constructed once per logger and shared with every child
+ * logger, so a transport that owns a resource (a file handle, a socket) must
+ * open exactly one of them however many children are created.
+ */
+export interface Transport {
+    /** Transport type, used in diagnostics. */
+    readonly type: string;
+    /** Minimum level this transport accepts. Undefined means "whatever the logger allows". */
+    readonly level?: LogLevel;
+    /** Write one entry. */
+    write(entry: LogEntry): void;
+    /** Release any resources held. Safe to call more than once. */
+    close?(): void;
+}
+/**
+ * The logger-level presentation settings a transport inherits unless its own
+ * options override them.
+ */
+export interface TransportContext {
+    format: 'json' | 'text' | 'custom';
+    timestamp: boolean;
+    colorize: boolean;
+}
+/** Builds a transport from its configuration entry. */
+export type TransportFactory = (config: TransportConfig, context: TransportContext) => Transport;
+/**
+ * Register a factory for a transport type so it can be named in
+ * `LoggerConfig.transports`.
+ *
+ * Runtime-specific transports register themselves from their runtime entry
+ * point — the Node file transport is registered by `logan-logger/node`, which
+ * is what keeps `node:fs` out of the browser build.
+ *
+ * @param type - Value matched against `TransportConfig.type`
+ * @param factory - Builder invoked once per configured transport
+ */
+export declare function registerTransport(type: string, factory: TransportFactory): void;
+/** Look up a registered transport factory. */
+export declare function getTransportFactory(type: string): TransportFactory | undefined;
+/** Options accepted by {@link ConsoleTransport}. */
+export interface ConsoleTransportOptions extends FormatOptions {
+    /** Output shape. `'custom'` is treated as `'text'`. */
+    format?: 'json' | 'text' | 'custom';
+    /** Minimum level this transport accepts. */
+    level?: LogLevel;
+}
+/**
+ * Writes formatted entries to the runtime console, routing each level to the
+ * matching console method so devtools and journald keep their severity.
+ */
+export declare class ConsoleTransport implements Transport {
+    readonly type = "console";
+    readonly level?: LogLevel;
+    private readonly format;
+    private readonly formatOptions;
+    constructor(options?: ConsoleTransportOptions);
+    write(entry: LogEntry): void;
+}
+/**
+ * Build the transports described by a logger configuration.
+ *
+ * Each transport is constructed behind its own guard so that one failing to
+ * initialize cannot take the others down with it.
+ *
+ * @param config - The logger configuration
+ * @returns The transports that were built successfully
+ */
+export declare function createTransports(config: Partial<LoggerConfig>): Transport[];

package/dist/core/transport.d.mts

@@ -0,0 +1,73 @@
+import { FormatOptions } from '../utils/formatting.mjs';
+import { LogEntry, LoggerConfig, LogLevel, TransportConfig } from './types.mjs';
+/**
+ * A destination log entries are written to.
+ *
+ * Transports are constructed once per logger and shared with every child
+ * logger, so a transport that owns a resource (a file handle, a socket) must
+ * open exactly one of them however many children are created.
+ */
+export interface Transport {
+    /** Transport type, used in diagnostics. */
+    readonly type: string;
+    /** Minimum level this transport accepts. Undefined means "whatever the logger allows". */
+    readonly level?: LogLevel;
+    /** Write one entry. */
+    write(entry: LogEntry): void;
+    /** Release any resources held. Safe to call more than once. */
+    close?(): void;
+}
+/**
+ * The logger-level presentation settings a transport inherits unless its own
+ * options override them.
+ */
+export interface TransportContext {
+    format: 'json' | 'text' | 'custom';
+    timestamp: boolean;
+    colorize: boolean;
+}
+/** Builds a transport from its configuration entry. */
+export type TransportFactory = (config: TransportConfig, context: TransportContext) => Transport;
+/**
+ * Register a factory for a transport type so it can be named in
+ * `LoggerConfig.transports`.
+ *
+ * Runtime-specific transports register themselves from their runtime entry
+ * point — the Node file transport is registered by `logan-logger/node`, which
+ * is what keeps `node:fs` out of the browser build.
+ *
+ * @param type - Value matched against `TransportConfig.type`
+ * @param factory - Builder invoked once per configured transport
+ */
+export declare function registerTransport(type: string, factory: TransportFactory): void;
+/** Look up a registered transport factory. */
+export declare function getTransportFactory(type: string): TransportFactory | undefined;
+/** Options accepted by {@link ConsoleTransport}. */
+export interface ConsoleTransportOptions extends FormatOptions {
+    /** Output shape. `'custom'` is treated as `'text'`. */
+    format?: 'json' | 'text' | 'custom';
+    /** Minimum level this transport accepts. */
+    level?: LogLevel;
+}
+/**
+ * Writes formatted entries to the runtime console, routing each level to the
+ * matching console method so devtools and journald keep their severity.
+ */
+export declare class ConsoleTransport implements Transport {
+    readonly type = "console";
+    readonly level?: LogLevel;
+    private readonly format;
+    private readonly formatOptions;
+    constructor(options?: ConsoleTransportOptions);
+    write(entry: LogEntry): void;
+}
+/**
+ * Build the transports described by a logger configuration.
+ *
+ * Each transport is constructed behind its own guard so that one failing to
+ * initialize cannot take the others down with it.
+ *
+ * @param config - The logger configuration
+ * @returns The transports that were built successfully
+ */
+export declare function createTransports(config: Partial<LoggerConfig>): Transport[];

package/dist/core/transport.d.ts

@@ -0,0 +1,73 @@
+import { FormatOptions } from '../utils/formatting';
+import { LogEntry, LoggerConfig, LogLevel, TransportConfig } from './types';
+/**
+ * A destination log entries are written to.
+ *
+ * Transports are constructed once per logger and shared with every child
+ * logger, so a transport that owns a resource (a file handle, a socket) must
+ * open exactly one of them however many children are created.
+ */
+export interface Transport {
+    /** Transport type, used in diagnostics. */
+    readonly type: string;
+    /** Minimum level this transport accepts. Undefined means "whatever the logger allows". */
+    readonly level?: LogLevel;
+    /** Write one entry. */
+    write(entry: LogEntry): void;
+    /** Release any resources held. Safe to call more than once. */
+    close?(): void;
+}
+/**
+ * The logger-level presentation settings a transport inherits unless its own
+ * options override them.
+ */
+export interface TransportContext {
+    format: 'json' | 'text' | 'custom';
+    timestamp: boolean;
+    colorize: boolean;
+}
+/** Builds a transport from its configuration entry. */
+export type TransportFactory = (config: TransportConfig, context: TransportContext) => Transport;
+/**
+ * Register a factory for a transport type so it can be named in
+ * `LoggerConfig.transports`.
+ *
+ * Runtime-specific transports register themselves from their runtime entry
+ * point — the Node file transport is registered by `logan-logger/node`, which
+ * is what keeps `node:fs` out of the browser build.
+ *
+ * @param type - Value matched against `TransportConfig.type`
+ * @param factory - Builder invoked once per configured transport
+ */
+export declare function registerTransport(type: string, factory: TransportFactory): void;
+/** Look up a registered transport factory. */
+export declare function getTransportFactory(type: string): TransportFactory | undefined;
+/** Options accepted by {@link ConsoleTransport}. */
+export interface ConsoleTransportOptions extends FormatOptions {
+    /** Output shape. `'custom'` is treated as `'text'`. */
+    format?: 'json' | 'text' | 'custom';
+    /** Minimum level this transport accepts. */
+    level?: LogLevel;
+}
+/**
+ * Writes formatted entries to the runtime console, routing each level to the
+ * matching console method so devtools and journald keep their severity.
+ */
+export declare class ConsoleTransport implements Transport {
+    readonly type = "console";
+    readonly level?: LogLevel;
+    private readonly format;
+    private readonly formatOptions;
+    constructor(options?: ConsoleTransportOptions);
+    write(entry: LogEntry): void;
+}
+/**
+ * Build the transports described by a logger configuration.
+ *
+ * Each transport is constructed behind its own guard so that one failing to
+ * initialize cannot take the others down with it.
+ *
+ * @param config - The logger configuration
+ * @returns The transports that were built successfully
+ */
+export declare function createTransports(config: Partial<LoggerConfig>): Transport[];

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).

package/dist/core/types.d.mts

@@ -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).

package/dist/core/types.d.ts

@@ -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).

package/dist/deno.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.BrowserLogger=t.t,exports.ConsoleGroupLogger=t.n,exports.PerformanceLogger=t.r,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");exports.BrowserLogger=e.l,exports.ConsoleGroupLogger=e.u,exports.ConsoleTransport=t.c,exports.PerformanceLogger=e.d,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/deno.d.cts

@@ -1,6 +1,8 @@
 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 { BrowserLogger, ConsoleGroupLogger, PerformanceLogger } from './runtime/browser.cjs';
+export * from './utils/config-file.cjs';
 export * from './utils/config.cjs';
 export * from './utils/formatting.cjs';
 export * from './utils/runtime.cjs';

package/dist/deno.d.mts

@@ -1,6 +1,8 @@
 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 { BrowserLogger, ConsoleGroupLogger, PerformanceLogger } from './runtime/browser.mjs';
+export * from './utils/config-file.mjs';
 export * from './utils/config.mjs';
 export * from './utils/formatting.mjs';
 export * from './utils/runtime.mjs';

package/dist/deno.d.ts

@@ -1,6 +1,8 @@
 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 { BrowserLogger, ConsoleGroupLogger, PerformanceLogger } from './runtime/browser';
+export * from './utils/config-file';
 export * from './utils/config';
 export * from './utils/formatting';
 export * from './utils/runtime';