logan-logger 1.1.21 → 2.0.0

package/dist/deno.mjs

@@ -1,4 +1,4 @@
-import { c as e, l as t, n, o as r, r as i, s as a } from "./chunks/factory-2po65gyH.mjs";
-import { a as o, d as s, f as c, i as l, l as u, n as d, o as f, p, r as m, t as h, u as g } from "./chunks/browser-D5QY2oJb.mjs";
-import { n as _, t as v } from "./chunks/formatting-CLctAPm9.mjs";
-export { h as BrowserLogger, d as ConsoleGroupLogger, m as PerformanceLogger, n as createLogger, i as createLoggerForEnvironment, u as detectRuntime, l as filterSensitiveData, v as formatLevel, _ as formatLogEntry, r as getDefaultConfig, g as isBrowser, s as isBun, c as isDeno, p as isNode, a as loadConfigFromEnvironment, e as loadConfigFromFile, t as mergeConfigs, o as safeStringify, f as serializeError };
+import { _ as e, a as t, b as n, c as r, d as i, f as a, i as o, l as s, m as c, n as l, o as u, p as d, r as f, s as p, t as m, u as h, v as g, x as _, y as v } from "./chunks/config-Db6PTLH2.mjs";
+import { c as y, d as b, l as x, n as S, r as C } from "./chunks/factory-CXO2aNcc.mjs";
+import { t as w } from "./chunks/config-file-37L8z8Lm.mjs";
+export { s as BrowserLogger, h as ConsoleGroupLogger, y as ConsoleTransport, i as PerformanceLogger, S as createLogger, C as createLoggerForEnvironment, x as createTransports, e as detectRuntime, a as filterSensitiveData, p as formatLevel, r as formatLogEntry, m as getDefaultConfig, g as isBrowser, v as isBun, n as isDeno, _ as isNode, l as loadConfigFromEnvironment, w as loadConfigFromFile, f as mergeConfigs, b as registerTransport, o as resetEnvironmentWarnings, d as safeStringify, c as serializeError, t as shouldColorize, u as tryParseLogLevel };

package/dist/index.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");var r=e.r(),i={debug:(e,t)=>r.debug(e,t),info:(e,t)=>r.info(e,t),warn:(e,t)=>r.warn(e,t),error:(e,t)=>r.error(e,t)};exports.BaseLogger=t.s,exports.BrowserLogger=t.t,exports.ConsoleGroupLogger=t.n,exports.LogLevel=t.c,exports.LoggerFactory=e.t,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.log=i,exports.logLevelToString=e.i,exports.logger=r,exports.mergeConfigs=e.l,exports.safeStringify=t.a,exports.serializeError=t.o,exports.stringToLogLevel=e.a;
+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");var r=t.r(),i={debug:(e,t)=>r.debug(e,t),info:(e,t)=>r.info(e,t),warn:(e,t)=>r.warn(e,t),error:(e,t)=>r.error(e,t)};exports.BaseLogger=e.h,exports.BrowserLogger=e.l,exports.ConsoleGroupLogger=e.u,exports.ConsoleTransport=t.c,exports.LogLevel=e.g,exports.LoggerFactory=t.t,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.getTransportFactory=t.u,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.log=i,exports.logLevelToString=t.i,exports.logger=r,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.stringToLogLevel=t.a,exports.tryParseLogLevel=e.o;

package/dist/index.d.cts

@@ -2,8 +2,10 @@ import { createLogger, createLoggerForEnvironment } from './core/factory.cjs';
 import { ILogger, LogLevel } from './core/types.cjs';
 export * from './core/factory.cjs';
 export * from './core/logger.cjs';
+export * from './core/transport.cjs';
 export * 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/index.d.mts

@@ -2,8 +2,10 @@ import { createLogger, createLoggerForEnvironment } from './core/factory.mjs';
 import { ILogger, LogLevel } from './core/types.mjs';
 export * from './core/factory.mjs';
 export * from './core/logger.mjs';
+export * from './core/transport.mjs';
 export * 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/index.d.ts

@@ -2,8 +2,10 @@ import { createLogger, createLoggerForEnvironment } from './core/factory';
 import { ILogger, LogLevel } from './core/types';
 export * from './core/factory';
 export * from './core/logger';
+export * from './core/transport';
 export * 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';

package/dist/index.mjs

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

package/dist/node.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/factory-CluPoiZb.cjs");exports.NodeLogger=e.u,exports.createLogger=e.n,exports.createLoggerForEnvironment=e.r,exports.createMorganStream=e.d;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./chunks/factory-BPYE1-Nw.cjs"),t=require("./chunks/file-transport-SA6KG1oM.cjs");exports.ConsoleTransport=e.c,exports.FileTransport=t.t,exports.NodeLogger=e.o,exports.createLogger=e.n,exports.createLoggerForEnvironment=e.r,exports.createMorganStream=e.s,exports.createTransports=e.l,exports.registerTransport=e.d;

package/dist/node.d.cts

@@ -1,3 +1,5 @@
 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 { createMorganStream, NodeLogger } from './runtime/node.cjs';

package/dist/node.d.mts

@@ -1,3 +1,5 @@
 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 { createMorganStream, NodeLogger } from './runtime/node.mjs';

package/dist/node.d.ts

@@ -1,3 +1,5 @@
 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 { createMorganStream, NodeLogger } from './runtime/node';

package/dist/node.mjs

@@ -1,2 +1,3 @@
-import { d as e, n as t, r as n, u as r } from "./chunks/factory-2po65gyH.mjs";
-export { r as NodeLogger, t as createLogger, n as createLoggerForEnvironment, e as createMorganStream };
+import { c as e, d as t, l as n, n as r, o as i, r as a, s as o } from "./chunks/factory-CXO2aNcc.mjs";
+import { t as s } from "./chunks/file-transport-DRyxQq8t.mjs";
+export { e as ConsoleTransport, s as FileTransport, i as NodeLogger, r as createLogger, a as createLoggerForEnvironment, o as createMorganStream, n as createTransports, t as registerTransport };

package/dist/runtime/file-transport.d.cts

@@ -0,0 +1,62 @@
+import { Transport } from '../core/transport.cjs';
+import { LogEntry, LogLevel } from '../core/types.cjs';
+/** Options accepted by {@link FileTransport}. */
+export interface FileTransportOptions {
+    /** Path to the active log file. Relative paths resolve against `process.cwd()`. */
+    filename: string;
+    /** Rotate once the active file reaches this many bytes. `0` disables rotation. */
+    maxsize?: number;
+    /** How many rotated archives to keep (`name.log.1` … `name.log.N`). */
+    maxFiles?: number;
+    /**
+     * Output shape written to the file. Defaults to `'json'` — files are read by
+     * machines, so the structured envelope wins even when the logger's own
+     * format is `'text'`. Set this explicitly to write human-readable lines.
+     */
+    format?: 'json' | 'text' | 'custom';
+    /** Include the timestamp in the text form. Defaults to `true`. */
+    timestamp?: boolean;
+    /** Minimum level this transport accepts. */
+    level?: LogLevel;
+}
+/**
+ * Appends log entries to a file, rotating by size.
+ *
+ * Design notes, all of which are deliberate:
+ *
+ * - **The directory and file handle are created lazily, on first write.** A
+ *   logger that is constructed but never writes to a file touches the disk
+ *   zero times, which is what makes file logging safe to configure in a
+ *   read-only container.
+ * - **Writes are synchronous `writeSync` calls against a held file
+ *   descriptor.** That costs one syscall per line, and in exchange nothing
+ *   sits in a userland buffer waiting to be lost when the process exits.
+ * - **Failures warn once and never throw.** A logging destination going away
+ *   must not take the application with it, and it must not spam the console
+ *   on every subsequent line either.
+ */
+export declare class FileTransport implements Transport {
+    readonly type = "file";
+    readonly level?: LogLevel;
+    private readonly path;
+    private readonly maxsize;
+    private readonly maxFiles;
+    private readonly format;
+    private readonly timestamp;
+    private fd?;
+    private size;
+    private warned;
+    constructor(options: FileTransportOptions);
+    /** Absolute path of the active log file. */
+    get filename(): string;
+    write(entry: LogEntry): void;
+    close(): void;
+    private open;
+    /**
+     * Shift the archives along by one and start a fresh active file.
+     * `name.log` becomes `name.log.1`, `name.log.1` becomes `name.log.2`, and
+     * whatever was at `name.log.<maxFiles>` is dropped.
+     */
+    private rotate;
+    private warnOnce;
+}

package/dist/runtime/file-transport.d.mts

@@ -0,0 +1,62 @@
+import { Transport } from '../core/transport.mjs';
+import { LogEntry, LogLevel } from '../core/types.mjs';
+/** Options accepted by {@link FileTransport}. */
+export interface FileTransportOptions {
+    /** Path to the active log file. Relative paths resolve against `process.cwd()`. */
+    filename: string;
+    /** Rotate once the active file reaches this many bytes. `0` disables rotation. */
+    maxsize?: number;
+    /** How many rotated archives to keep (`name.log.1` … `name.log.N`). */
+    maxFiles?: number;
+    /**
+     * Output shape written to the file. Defaults to `'json'` — files are read by
+     * machines, so the structured envelope wins even when the logger's own
+     * format is `'text'`. Set this explicitly to write human-readable lines.
+     */
+    format?: 'json' | 'text' | 'custom';
+    /** Include the timestamp in the text form. Defaults to `true`. */
+    timestamp?: boolean;
+    /** Minimum level this transport accepts. */
+    level?: LogLevel;
+}
+/**
+ * Appends log entries to a file, rotating by size.
+ *
+ * Design notes, all of which are deliberate:
+ *
+ * - **The directory and file handle are created lazily, on first write.** A
+ *   logger that is constructed but never writes to a file touches the disk
+ *   zero times, which is what makes file logging safe to configure in a
+ *   read-only container.
+ * - **Writes are synchronous `writeSync` calls against a held file
+ *   descriptor.** That costs one syscall per line, and in exchange nothing
+ *   sits in a userland buffer waiting to be lost when the process exits.
+ * - **Failures warn once and never throw.** A logging destination going away
+ *   must not take the application with it, and it must not spam the console
+ *   on every subsequent line either.
+ */
+export declare class FileTransport implements Transport {
+    readonly type = "file";
+    readonly level?: LogLevel;
+    private readonly path;
+    private readonly maxsize;
+    private readonly maxFiles;
+    private readonly format;
+    private readonly timestamp;
+    private fd?;
+    private size;
+    private warned;
+    constructor(options: FileTransportOptions);
+    /** Absolute path of the active log file. */
+    get filename(): string;
+    write(entry: LogEntry): void;
+    close(): void;
+    private open;
+    /**
+     * Shift the archives along by one and start a fresh active file.
+     * `name.log` becomes `name.log.1`, `name.log.1` becomes `name.log.2`, and
+     * whatever was at `name.log.<maxFiles>` is dropped.
+     */
+    private rotate;
+    private warnOnce;
+}

package/dist/runtime/file-transport.d.ts

@@ -0,0 +1,62 @@
+import { Transport } from '../core/transport';
+import { LogEntry, LogLevel } from '../core/types';
+/** Options accepted by {@link FileTransport}. */
+export interface FileTransportOptions {
+    /** Path to the active log file. Relative paths resolve against `process.cwd()`. */
+    filename: string;
+    /** Rotate once the active file reaches this many bytes. `0` disables rotation. */
+    maxsize?: number;
+    /** How many rotated archives to keep (`name.log.1` … `name.log.N`). */
+    maxFiles?: number;
+    /**
+     * Output shape written to the file. Defaults to `'json'` — files are read by
+     * machines, so the structured envelope wins even when the logger's own
+     * format is `'text'`. Set this explicitly to write human-readable lines.
+     */
+    format?: 'json' | 'text' | 'custom';
+    /** Include the timestamp in the text form. Defaults to `true`. */
+    timestamp?: boolean;
+    /** Minimum level this transport accepts. */
+    level?: LogLevel;
+}
+/**
+ * Appends log entries to a file, rotating by size.
+ *
+ * Design notes, all of which are deliberate:
+ *
+ * - **The directory and file handle are created lazily, on first write.** A
+ *   logger that is constructed but never writes to a file touches the disk
+ *   zero times, which is what makes file logging safe to configure in a
+ *   read-only container.
+ * - **Writes are synchronous `writeSync` calls against a held file
+ *   descriptor.** That costs one syscall per line, and in exchange nothing
+ *   sits in a userland buffer waiting to be lost when the process exits.
+ * - **Failures warn once and never throw.** A logging destination going away
+ *   must not take the application with it, and it must not spam the console
+ *   on every subsequent line either.
+ */
+export declare class FileTransport implements Transport {
+    readonly type = "file";
+    readonly level?: LogLevel;
+    private readonly path;
+    private readonly maxsize;
+    private readonly maxFiles;
+    private readonly format;
+    private readonly timestamp;
+    private fd?;
+    private size;
+    private warned;
+    constructor(options: FileTransportOptions);
+    /** Absolute path of the active log file. */
+    get filename(): string;
+    write(entry: LogEntry): void;
+    close(): void;
+    private open;
+    /**
+     * Shift the archives along by one and start a fresh active file.
+     * `name.log` becomes `name.log.1`, `name.log.1` becomes `name.log.2`, and
+     * whatever was at `name.log.<maxFiles>` is dropped.
+     */
+    private rotate;
+    private warnOnce;
+}

package/dist/runtime/node.d.cts

@@ -1,16 +1,47 @@
 import { BaseLogger } from '../core/logger.cjs';
-import { LogEntry, LoggerConfig, LogLevel } from '../core/types.cjs';
+import { Transport } from '../core/transport.cjs';
+import { LogEntry, LoggerConfig } from '../core/types.cjs';
+/**
+ * Logger for Node.js and Bun.
+ *
+ * Writes through an explicit list of transports built from
+ * `LoggerConfig.transports`. With no transports configured it writes to the
+ * console and nowhere else — file logging is opt-in, never implied by
+ * `NODE_ENV`.
+ *
+ * @example
+ * ```typescript
+ * import { NodeLogger, LogLevel } from 'logan-logger/node';
+ *
+ * const logger = new NodeLogger({
+ *   level: LogLevel.INFO,
+ *   transports: [
+ *     { type: 'console', options: {} },
+ *     { type: 'file', level: LogLevel.ERROR, options: { filename: 'logs/error.log' } },
+ *   ],
+ * });
+ * ```
+ */
 export declare class NodeLogger extends BaseLogger {
-    private winston?;
-    constructor(config?: Partial<LoggerConfig>);
-    private initializeWinston;
-    private createWinstonLogger;
+    private readonly transports;
+    /**
+     * @param config - Logger configuration
+     * @param transports - Pre-built transports to adopt instead of building new
+     * ones. Used internally so a child logger shares its parent's destinations.
+     */
+    constructor(config?: Partial<LoggerConfig>, transports?: Transport[]);
+    /** The transports this logger writes through. */
+    getTransports(): readonly Transport[];
+    /** Release every transport's resources. */
+    close(): void;
     protected writeLog(entry: LogEntry): void;
     protected createChild(): BaseLogger;
-    private writeToConsole;
-    private getWinstonLevel;
-    setLevel(level: LogLevel): void;
 }
+/**
+ * Create a Morgan-compatible stream that forwards HTTP access logs to a logger.
+ * @param logger - The logger to write through
+ * @returns An object with a `write` method Morgan can use
+ */
 export declare function createMorganStream(logger: NodeLogger): {
     write: (message: string) => void;
 };

package/dist/runtime/node.d.mts

@@ -1,16 +1,47 @@
 import { BaseLogger } from '../core/logger.mjs';
-import { LogEntry, LoggerConfig, LogLevel } from '../core/types.mjs';
+import { Transport } from '../core/transport.mjs';
+import { LogEntry, LoggerConfig } from '../core/types.mjs';
+/**
+ * Logger for Node.js and Bun.
+ *
+ * Writes through an explicit list of transports built from
+ * `LoggerConfig.transports`. With no transports configured it writes to the
+ * console and nowhere else — file logging is opt-in, never implied by
+ * `NODE_ENV`.
+ *
+ * @example
+ * ```typescript
+ * import { NodeLogger, LogLevel } from 'logan-logger/node';
+ *
+ * const logger = new NodeLogger({
+ *   level: LogLevel.INFO,
+ *   transports: [
+ *     { type: 'console', options: {} },
+ *     { type: 'file', level: LogLevel.ERROR, options: { filename: 'logs/error.log' } },
+ *   ],
+ * });
+ * ```
+ */
 export declare class NodeLogger extends BaseLogger {
-    private winston?;
-    constructor(config?: Partial<LoggerConfig>);
-    private initializeWinston;
-    private createWinstonLogger;
+    private readonly transports;
+    /**
+     * @param config - Logger configuration
+     * @param transports - Pre-built transports to adopt instead of building new
+     * ones. Used internally so a child logger shares its parent's destinations.
+     */
+    constructor(config?: Partial<LoggerConfig>, transports?: Transport[]);
+    /** The transports this logger writes through. */
+    getTransports(): readonly Transport[];
+    /** Release every transport's resources. */
+    close(): void;
     protected writeLog(entry: LogEntry): void;
     protected createChild(): BaseLogger;
-    private writeToConsole;
-    private getWinstonLevel;
-    setLevel(level: LogLevel): void;
 }
+/**
+ * Create a Morgan-compatible stream that forwards HTTP access logs to a logger.
+ * @param logger - The logger to write through
+ * @returns An object with a `write` method Morgan can use
+ */
 export declare function createMorganStream(logger: NodeLogger): {
     write: (message: string) => void;
 };

package/dist/runtime/node.d.ts

@@ -1,16 +1,47 @@
 import { BaseLogger } from '../core/logger';
-import { LogEntry, LoggerConfig, LogLevel } from '../core/types';
+import { Transport } from '../core/transport';
+import { LogEntry, LoggerConfig } from '../core/types';
+/**
+ * Logger for Node.js and Bun.
+ *
+ * Writes through an explicit list of transports built from
+ * `LoggerConfig.transports`. With no transports configured it writes to the
+ * console and nowhere else — file logging is opt-in, never implied by
+ * `NODE_ENV`.
+ *
+ * @example
+ * ```typescript
+ * import { NodeLogger, LogLevel } from 'logan-logger/node';
+ *
+ * const logger = new NodeLogger({
+ *   level: LogLevel.INFO,
+ *   transports: [
+ *     { type: 'console', options: {} },
+ *     { type: 'file', level: LogLevel.ERROR, options: { filename: 'logs/error.log' } },
+ *   ],
+ * });
+ * ```
+ */
 export declare class NodeLogger extends BaseLogger {
-    private winston?;
-    constructor(config?: Partial<LoggerConfig>);
-    private initializeWinston;
-    private createWinstonLogger;
+    private readonly transports;
+    /**
+     * @param config - Logger configuration
+     * @param transports - Pre-built transports to adopt instead of building new
+     * ones. Used internally so a child logger shares its parent's destinations.
+     */
+    constructor(config?: Partial<LoggerConfig>, transports?: Transport[]);
+    /** The transports this logger writes through. */
+    getTransports(): readonly Transport[];
+    /** Release every transport's resources. */
+    close(): void;
     protected writeLog(entry: LogEntry): void;
     protected createChild(): BaseLogger;
-    private writeToConsole;
-    private getWinstonLevel;
-    setLevel(level: LogLevel): void;
 }
+/**
+ * Create a Morgan-compatible stream that forwards HTTP access logs to a logger.
+ * @param logger - The logger to write through
+ * @returns An object with a `write` method Morgan can use
+ */
 export declare function createMorganStream(logger: NodeLogger): {
     write: (message: string) => void;
 };

package/dist/utils/config-file.d.cts

@@ -0,0 +1,2 @@
+import { LoggerConfig } from '../core/types.cjs';
+export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;

package/dist/utils/config-file.d.mts

@@ -0,0 +1,2 @@
+import { LoggerConfig } from '../core/types.mjs';
+export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;

package/dist/utils/config-file.d.ts

@@ -0,0 +1,2 @@
+import { LoggerConfig } from '../core/types';
+export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;

package/dist/utils/config.d.cts

@@ -1,5 +1,36 @@
-import { LoggerConfig } from '../core/types.cjs';
+import { LoggerConfig, LogLevel } from '../core/types.cjs';
+/**
+ * Whether colored output is appropriate right now.
+ *
+ * `capabilities.colorSupport` answers whether the runtime *can* colorize.
+ * This answers whether it *should*: writing ANSI escapes into a redirected
+ * file or a log shipper is worse than writing none, so a non-TTY stdout
+ * disables color unless the caller forces it. Honors the `NO_COLOR` and
+ * `FORCE_COLOR` conventions.
+ * @returns True when the level token should carry ANSI color
+ */
+export declare function shouldColorize(): boolean;
 export declare function getDefaultConfig(): LoggerConfig;
+/**
+ * Reset the warn-once state. Exposed for tests; not part of the public contract.
+ */
+export declare function resetEnvironmentWarnings(): void;
+/**
+ * Parse a log level string, reporting failure rather than guessing.
+ * @param level - The value to parse
+ * @returns The matching level, or undefined if the value is not recognized
+ */
+export declare function tryParseLogLevel(level: string): LogLevel | undefined;
+/**
+ * Read logger configuration from `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP`
+ * and `LOG_COLOR`.
+ *
+ * Only variables that are set and parse successfully appear in the result, so
+ * an absent or malformed variable leaves lower-precedence sources untouched.
+ *
+ * In a browser these values exist only if the bundler inlined them at build
+ * time; otherwise this returns an empty object.
+ * @returns The subset of configuration the environment specifies
+ */
 export declare function loadConfigFromEnvironment(): Partial<LoggerConfig>;
-export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;
 export declare function mergeConfigs(...configs: Partial<LoggerConfig>[]): LoggerConfig;

package/dist/utils/config.d.mts

@@ -1,5 +1,36 @@
-import { LoggerConfig } from '../core/types.mjs';
+import { LoggerConfig, LogLevel } from '../core/types.mjs';
+/**
+ * Whether colored output is appropriate right now.
+ *
+ * `capabilities.colorSupport` answers whether the runtime *can* colorize.
+ * This answers whether it *should*: writing ANSI escapes into a redirected
+ * file or a log shipper is worse than writing none, so a non-TTY stdout
+ * disables color unless the caller forces it. Honors the `NO_COLOR` and
+ * `FORCE_COLOR` conventions.
+ * @returns True when the level token should carry ANSI color
+ */
+export declare function shouldColorize(): boolean;
 export declare function getDefaultConfig(): LoggerConfig;
+/**
+ * Reset the warn-once state. Exposed for tests; not part of the public contract.
+ */
+export declare function resetEnvironmentWarnings(): void;
+/**
+ * Parse a log level string, reporting failure rather than guessing.
+ * @param level - The value to parse
+ * @returns The matching level, or undefined if the value is not recognized
+ */
+export declare function tryParseLogLevel(level: string): LogLevel | undefined;
+/**
+ * Read logger configuration from `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP`
+ * and `LOG_COLOR`.
+ *
+ * Only variables that are set and parse successfully appear in the result, so
+ * an absent or malformed variable leaves lower-precedence sources untouched.
+ *
+ * In a browser these values exist only if the bundler inlined them at build
+ * time; otherwise this returns an empty object.
+ * @returns The subset of configuration the environment specifies
+ */
 export declare function loadConfigFromEnvironment(): Partial<LoggerConfig>;
-export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;
 export declare function mergeConfigs(...configs: Partial<LoggerConfig>[]): LoggerConfig;

package/dist/utils/config.d.ts

@@ -1,5 +1,36 @@
-import { LoggerConfig } from '../core/types';
+import { LoggerConfig, LogLevel } from '../core/types';
+/**
+ * Whether colored output is appropriate right now.
+ *
+ * `capabilities.colorSupport` answers whether the runtime *can* colorize.
+ * This answers whether it *should*: writing ANSI escapes into a redirected
+ * file or a log shipper is worse than writing none, so a non-TTY stdout
+ * disables color unless the caller forces it. Honors the `NO_COLOR` and
+ * `FORCE_COLOR` conventions.
+ * @returns True when the level token should carry ANSI color
+ */
+export declare function shouldColorize(): boolean;
 export declare function getDefaultConfig(): LoggerConfig;
+/**
+ * Reset the warn-once state. Exposed for tests; not part of the public contract.
+ */
+export declare function resetEnvironmentWarnings(): void;
+/**
+ * Parse a log level string, reporting failure rather than guessing.
+ * @param level - The value to parse
+ * @returns The matching level, or undefined if the value is not recognized
+ */
+export declare function tryParseLogLevel(level: string): LogLevel | undefined;
+/**
+ * Read logger configuration from `LOG_LEVEL`, `LOG_FORMAT`, `LOG_TIMESTAMP`
+ * and `LOG_COLOR`.
+ *
+ * Only variables that are set and parse successfully appear in the result, so
+ * an absent or malformed variable leaves lower-precedence sources untouched.
+ *
+ * In a browser these values exist only if the bundler inlined them at build
+ * time; otherwise this returns an empty object.
+ * @returns The subset of configuration the environment specifies
+ */
 export declare function loadConfigFromEnvironment(): Partial<LoggerConfig>;
-export declare function loadConfigFromFile(configPath?: string): Promise<Partial<LoggerConfig>>;
 export declare function mergeConfigs(...configs: Partial<LoggerConfig>[]): LoggerConfig;

package/dist/utils/formatting.d.cts

@@ -1,8 +1,18 @@
 import { LogEntry, LogLevel } from '../core/types.cjs';
+/**
+ * Presentation options for {@link formatLogEntry}, drawn from `LoggerConfig`.
+ */
+export interface FormatOptions {
+    /** Include the timestamp in the text form. Defaults to `true`. */
+    timestamp?: boolean;
+    /** Apply ANSI colour to the level token in the text form. Defaults to `false`. */
+    colorize?: boolean;
+}
 /**
  * Format a log entry for output in different formats.
  * @param entry - The log entry to format
  * @param format - Output format ('json' or 'text')
+ * @param options - Presentation options; they affect the text form only
  * @returns Formatted log string
  * @example
  * ```typescript
@@ -17,11 +27,14 @@ import { LogEntry, LogLevel } from '../core/types.cjs';
  * const textFormat = formatLogEntry(entry, 'text');
  * // Result: "[2024-01-01T12:00:00.000Z] INFO: User logged in {\"userId\":123}"
  *
+ * const bare = formatLogEntry(entry, 'text', { timestamp: false });
+ * // Result: "INFO: User logged in {\"userId\":123}"
+ *
  * const jsonFormat = formatLogEntry(entry, 'json');
  * // Result: {"timestamp":"2024-01-01T12:00:00.000Z","level":"info","message":"User logged in","metadata":{"userId":123},"runtime":"node"}
  * ```
  */
-export declare function formatLogEntry(entry: LogEntry, format?: 'json' | 'text'): string;
+export declare function formatLogEntry(entry: LogEntry, format?: 'json' | 'text', options?: FormatOptions): string;
 /**
  * Format log level as a colored string for terminal output.
  * @param level - The log level to format