@noego/logger 0.0.2 → 0.0.4

package/dist/core/logging_manager.d.ts

@@ -1,9 +1,10 @@
-import { LogLevel } from './log_level.js';
+import { LogLevelInput, LogLevelDefinition, LogLevelValue } from './log_level.js';
 import { LogTransport, LogEntry } from './log_transport.js';
 
 interface ConfigureLoggingOptions {
-    level?: LogLevel;
-    loggers?: Record<string, LogLevel>;
+    level?: LogLevelInput;
+    loggers?: Record<string, LogLevelInput>;
+    levels?: LogLevelDefinition[];
     transports?: LogTransport[];
     serviceName?: string;
 }
@@ -14,17 +15,17 @@ declare class LoggingManager {
     private readonly environment;
     private loggerLevels;
     constructor();
-    getLevel(): LogLevel;
-    setLevel(level: LogLevel): void;
-    setLoggerLevel(name: string, level: LogLevel): void;
-    shouldLog(level: LogLevel, loggerName?: string): boolean;
+    getLevel(): LogLevelValue;
+    setLevel(level: LogLevelInput): void;
+    setLoggerLevel(name: string, level: LogLevelInput): void;
+    shouldLog(level: LogLevelInput, loggerName?: string): boolean;
     addTransport(transport: LogTransport): void;
     setTransports(transports: LogTransport[]): void;
     clearTransports(): void;
     setServiceName(name: string): void;
     log(entry: Omit<LogEntry, "environment" | "service">): void;
     closeAll(): Promise<void>;
-    formatMessage(level: LogLevel, name: string, message: string): string;
+    formatMessage(level: LogLevelInput, name: string, message: string): string;
 }
 /**
  * Gets the global LoggingManager singleton instance.

package/dist/core/logging_manager.js

@@ -1,4 +1,4 @@
-import { logLevelName, parseLogLevel } from "./log_level.js";
+import { logLevelName, parseLogLevel, registerLogLevels } from "./log_level.js";
 import { ConsoleTransport } from "../transports/console_transport.js";
 const MANAGER_SYMBOL = /* @__PURE__ */ Symbol.for("@noego/logger");
 class LoggingManager {
@@ -16,19 +16,20 @@ class LoggingManager {
     return this.level;
   }
   setLevel(level) {
-    this.level = level;
+    this.level = parseLogLevel(level);
   }
   setLoggerLevel(name, level) {
-    this.loggerLevels.set(name, level);
+    this.loggerLevels.set(name, parseLogLevel(level));
   }
   shouldLog(level, loggerName) {
+    const parsedLevel = parseLogLevel(level);
     if (loggerName) {
       const loggerLevel = this.loggerLevels.get(loggerName);
       if (loggerLevel !== void 0) {
-        return level >= loggerLevel;
+        return parsedLevel >= loggerLevel;
       }
     }
-    return level >= this.level;
+    return parsedLevel >= this.level;
   }
   addTransport(transport) {
     this.transports.push(transport);
@@ -75,6 +76,9 @@ function getManager() {
 }
 function configureLogging(options) {
   const manager = getManager();
+  if (options.levels) {
+    registerLogLevels(options.levels);
+  }
   if (options.level !== void 0) {
     manager.setLevel(options.level);
   }

package/dist/core/logging_manager.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/logging_manager.ts"],"sourcesContent":["import { LogLevel, logLevelName, parseLogLevel } from \"./log_level.js\";\nimport type { LogEntry, LogTransport } from \"./log_transport.js\";\nimport { ConsoleTransport } from \"../transports/console_transport.js\";\n\nconst MANAGER_SYMBOL = Symbol.for(\"@noego/logger\");\n\ninterface GlobalWithManager {\n  [MANAGER_SYMBOL]?: LoggingManager;\n}\n\nexport interface ConfigureLoggingOptions {\n  level?: LogLevel;\n  loggers?: Record<string, LogLevel>;\n  transports?: LogTransport[];\n  serviceName?: string;\n}\n\nexport class LoggingManager {\n  private level: LogLevel;\n  private transports: LogTransport[] = [];\n  private service: string;\n  private readonly environment: string;\n  private loggerLevels: Map<string, LogLevel> = new Map();\n\n  constructor() {\n    const logLevelEnv =\n      typeof process !== \"undefined\" ? process.env?.LOG_LEVEL : undefined;\n    const serviceNameEnv =\n      typeof process !== \"undefined\" ? process.env?.SERVICE_NAME : undefined;\n    const nodeEnv =\n      typeof process !== \"undefined\" ? process.env?.NODE_ENV : undefined;\n\n    this.level = parseLogLevel(logLevelEnv);\n    this.service = serviceNameEnv ?? \"noego\";\n    this.environment = nodeEnv ?? \"development\";\n  }\n\n  getLevel(): LogLevel {\n    return this.level;\n  }\n\n  setLevel(level: LogLevel): void {\n    this.level = level;\n  }\n\n  setLoggerLevel(name: string, level: LogLevel): void {\n    this.loggerLevels.set(name, level);\n  }\n\n  shouldLog(level: LogLevel, loggerName?: string): boolean {\n    if (loggerName) {\n      const loggerLevel = this.loggerLevels.get(loggerName);\n      if (loggerLevel !== undefined) {\n        return level >= loggerLevel;\n      }\n    }\n    return level >= this.level;\n  }\n\n  addTransport(transport: LogTransport): void {\n    this.transports.push(transport);\n  }\n\n  setTransports(transports: LogTransport[]): void {\n    this.transports = [...transports];\n  }\n\n  clearTransports(): void {\n    this.transports = [];\n  }\n\n  setServiceName(name: string): void {\n    this.service = name;\n  }\n\n  log(entry: Omit<LogEntry, \"environment\" | \"service\">): void {\n    const fullEntry: LogEntry = {\n      ...entry,\n      environment: this.environment,\n      service: this.service,\n    };\n\n    for (const transport of this.transports) {\n      transport.log(fullEntry);\n    }\n  }\n\n  async closeAll(): Promise<void> {\n    for (const transport of this.transports) {\n      if (transport.close) {\n        await transport.close();\n      }\n    }\n  }\n\n  formatMessage(level: LogLevel, name: string, message: string): string {\n    const timestamp = new Date().toISOString();\n    return `[${timestamp}] [${name}] [${logLevelName(level)}] ${message}`;\n  }\n}\n\n/**\n * Gets the global LoggingManager singleton instance.\n * Creates one with a default ConsoleTransport if it doesn't exist.\n */\nexport function getManager(): LoggingManager {\n  const global = globalThis as GlobalWithManager;\n\n  if (!global[MANAGER_SYMBOL]) {\n    const manager = new LoggingManager();\n\n    // Add default ConsoleTransport\n    manager.addTransport(new ConsoleTransport());\n\n    global[MANAGER_SYMBOL] = manager;\n  }\n\n  return global[MANAGER_SYMBOL];\n}\n\n/**\n * Configures the global LoggingManager instance.\n * This mutates the singleton instance returned by getManager().\n */\nexport function configureLogging(options: ConfigureLoggingOptions): void {\n  const manager = getManager();\n\n  if (options.level !== undefined) {\n    manager.setLevel(options.level);\n  }\n\n  if (options.loggers) {\n    for (const [name, level] of Object.entries(options.loggers)) {\n      manager.setLoggerLevel(name, level);\n    }\n  }\n\n  if (options.transports) {\n    // Clear existing transports and add new ones\n    manager.setTransports(options.transports);\n  }\n\n  if (options.serviceName) {\n    // Update service name\n    manager.setServiceName(options.serviceName);\n  }\n}\n\n/**\n * Shuts down the global LoggingManager by closing all transports.\n */\nexport async function shutdown(): Promise<void> {\n  const manager = getManager();\n  await manager.closeAll();\n}\n"],"mappings":"AAAA,SAAmB,cAAc,qBAAqB;AAEtD,SAAS,wBAAwB;AAEjC,MAAM,iBAAiB,uBAAO,IAAI,eAAe;AAa1C,MAAM,eAAe;AAAA,EAO1B,cAAc;AALd,SAAQ,aAA6B,CAAC;AAGtC,SAAQ,eAAsC,oBAAI,IAAI;AAGpD,UAAM,cACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,YAAY;AAC5D,UAAM,iBACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,eAAe;AAC/D,UAAM,UACJ,OAAO,YAAY,cAAc,QAAQ,KAAK,WAAW;AAE3D,SAAK,QAAQ,cAAc,WAAW;AACtC,SAAK,UAAU,kBAAkB;AACjC,SAAK,cAAc,WAAW;AAAA,EAChC;AAAA,EAEA,WAAqB;AACnB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,SAAS,OAAuB;AAC9B,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,eAAe,MAAc,OAAuB;AAClD,SAAK,aAAa,IAAI,MAAM,KAAK;AAAA,EACnC;AAAA,EAEA,UAAU,OAAiB,YAA8B;AACvD,QAAI,YAAY;AACd,YAAM,cAAc,KAAK,aAAa,IAAI,UAAU;AACpD,UAAI,gBAAgB,QAAW;AAC7B,eAAO,SAAS;AAAA,MAClB;AAAA,IACF;AACA,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA,EAEA,aAAa,WAA+B;AAC1C,SAAK,WAAW,KAAK,SAAS;AAAA,EAChC;AAAA,EAEA,cAAc,YAAkC;AAC9C,SAAK,aAAa,CAAC,GAAG,UAAU;AAAA,EAClC;AAAA,EAEA,kBAAwB;AACtB,SAAK,aAAa,CAAC;AAAA,EACrB;AAAA,EAEA,eAAe,MAAoB;AACjC,SAAK,UAAU;AAAA,EACjB;AAAA,EAEA,IAAI,OAAwD;AAC1D,UAAM,YAAsB;AAAA,MAC1B,GAAG;AAAA,MACH,aAAa,KAAK;AAAA,MAClB,SAAS,KAAK;AAAA,IAChB;AAEA,eAAW,aAAa,KAAK,YAAY;AACvC,gBAAU,IAAI,SAAS;AAAA,IACzB;AAAA,EACF;AAAA,EAEA,MAAM,WAA0B;AAC9B,eAAW,aAAa,KAAK,YAAY;AACvC,UAAI,UAAU,OAAO;AACnB,cAAM,UAAU,MAAM;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,cAAc,OAAiB,MAAc,SAAyB;AACpE,UAAM,aAAY,oBAAI,KAAK,GAAE,YAAY;AACzC,WAAO,IAAI,SAAS,MAAM,IAAI,MAAM,aAAa,KAAK,CAAC,KAAK,OAAO;AAAA,EACrE;AACF;AAMO,SAAS,aAA6B;AAC3C,QAAM,SAAS;AAEf,MAAI,CAAC,OAAO,cAAc,GAAG;AAC3B,UAAM,UAAU,IAAI,eAAe;AAGnC,YAAQ,aAAa,IAAI,iBAAiB,CAAC;AAE3C,WAAO,cAAc,IAAI;AAAA,EAC3B;AAEA,SAAO,OAAO,cAAc;AAC9B;AAMO,SAAS,iBAAiB,SAAwC;AACvE,QAAM,UAAU,WAAW;AAE3B,MAAI,QAAQ,UAAU,QAAW;AAC/B,YAAQ,SAAS,QAAQ,KAAK;AAAA,EAChC;AAEA,MAAI,QAAQ,SAAS;AACnB,eAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,QAAQ,OAAO,GAAG;AAC3D,cAAQ,eAAe,MAAM,KAAK;AAAA,IACpC;AAAA,EACF;AAEA,MAAI,QAAQ,YAAY;AAEtB,YAAQ,cAAc,QAAQ,UAAU;AAAA,EAC1C;AAEA,MAAI,QAAQ,aAAa;AAEvB,YAAQ,eAAe,QAAQ,WAAW;AAAA,EAC5C;AACF;AAKA,eAAsB,WAA0B;AAC9C,QAAM,UAAU,WAAW;AAC3B,QAAM,QAAQ,SAAS;AACzB;","names":[]}
+{"version":3,"sources":["../../src/core/logging_manager.ts"],"sourcesContent":["import { type LogLevelDefinition, type LogLevelInput, type LogLevelValue, logLevelName, parseLogLevel, registerLogLevels } from \"./log_level.js\";\nimport type { LogEntry, LogTransport } from \"./log_transport.js\";\nimport { ConsoleTransport } from \"../transports/console_transport.js\";\n\nconst MANAGER_SYMBOL = Symbol.for(\"@noego/logger\");\n\ninterface GlobalWithManager {\n  [MANAGER_SYMBOL]?: LoggingManager;\n}\n\nexport interface ConfigureLoggingOptions {\n  level?: LogLevelInput;\n  loggers?: Record<string, LogLevelInput>;\n  levels?: LogLevelDefinition[];\n  transports?: LogTransport[];\n  serviceName?: string;\n}\n\nexport class LoggingManager {\n  private level: LogLevelValue;\n  private transports: LogTransport[] = [];\n  private service: string;\n  private readonly environment: string;\n  private loggerLevels: Map<string, LogLevelValue> = new Map();\n\n  constructor() {\n    const logLevelEnv =\n      typeof process !== \"undefined\" ? process.env?.LOG_LEVEL : undefined;\n    const serviceNameEnv =\n      typeof process !== \"undefined\" ? process.env?.SERVICE_NAME : undefined;\n    const nodeEnv =\n      typeof process !== \"undefined\" ? process.env?.NODE_ENV : undefined;\n\n    this.level = parseLogLevel(logLevelEnv);\n    this.service = serviceNameEnv ?? \"noego\";\n    this.environment = nodeEnv ?? \"development\";\n  }\n\n  getLevel(): LogLevelValue {\n    return this.level;\n  }\n\n  setLevel(level: LogLevelInput): void {\n    this.level = parseLogLevel(level);\n  }\n\n  setLoggerLevel(name: string, level: LogLevelInput): void {\n    this.loggerLevels.set(name, parseLogLevel(level));\n  }\n\n  shouldLog(level: LogLevelInput, loggerName?: string): boolean {\n    const parsedLevel = parseLogLevel(level);\n\n    if (loggerName) {\n      const loggerLevel = this.loggerLevels.get(loggerName);\n      if (loggerLevel !== undefined) {\n        return parsedLevel >= loggerLevel;\n      }\n    }\n    return parsedLevel >= this.level;\n  }\n\n  addTransport(transport: LogTransport): void {\n    this.transports.push(transport);\n  }\n\n  setTransports(transports: LogTransport[]): void {\n    this.transports = [...transports];\n  }\n\n  clearTransports(): void {\n    this.transports = [];\n  }\n\n  setServiceName(name: string): void {\n    this.service = name;\n  }\n\n  log(entry: Omit<LogEntry, \"environment\" | \"service\">): void {\n    const fullEntry: LogEntry = {\n      ...entry,\n      environment: this.environment,\n      service: this.service,\n    };\n\n    for (const transport of this.transports) {\n      transport.log(fullEntry);\n    }\n  }\n\n  async closeAll(): Promise<void> {\n    for (const transport of this.transports) {\n      if (transport.close) {\n        await transport.close();\n      }\n    }\n  }\n\n  formatMessage(level: LogLevelInput, name: string, message: string): string {\n    const timestamp = new Date().toISOString();\n    return `[${timestamp}] [${name}] [${logLevelName(level)}] ${message}`;\n  }\n}\n\n/**\n * Gets the global LoggingManager singleton instance.\n * Creates one with a default ConsoleTransport if it doesn't exist.\n */\nexport function getManager(): LoggingManager {\n  const global = globalThis as GlobalWithManager;\n\n  if (!global[MANAGER_SYMBOL]) {\n    const manager = new LoggingManager();\n\n    // Add default ConsoleTransport\n    manager.addTransport(new ConsoleTransport());\n\n    global[MANAGER_SYMBOL] = manager;\n  }\n\n  return global[MANAGER_SYMBOL];\n}\n\n/**\n * Configures the global LoggingManager instance.\n * This mutates the singleton instance returned by getManager().\n */\nexport function configureLogging(options: ConfigureLoggingOptions): void {\n  const manager = getManager();\n\n  if (options.levels) {\n    registerLogLevels(options.levels);\n  }\n\n  if (options.level !== undefined) {\n    manager.setLevel(options.level);\n  }\n\n  if (options.loggers) {\n    for (const [name, level] of Object.entries(options.loggers)) {\n      manager.setLoggerLevel(name, level);\n    }\n  }\n\n  if (options.transports) {\n    // Clear existing transports and add new ones\n    manager.setTransports(options.transports);\n  }\n\n  if (options.serviceName) {\n    // Update service name\n    manager.setServiceName(options.serviceName);\n  }\n}\n\n/**\n * Shuts down the global LoggingManager by closing all transports.\n */\nexport async function shutdown(): Promise<void> {\n  const manager = getManager();\n  await manager.closeAll();\n}\n"],"mappings":"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","names":[]}

package/dist/get_logger.d.cts

@@ -1,6 +1,6 @@
 import { Logger } from './core/abstract_logger.cjs';
-import './core/logging_manager.cjs';
 import './core/log_level.cjs';
+import './core/logging_manager.cjs';
 import './core/log_transport.cjs';
 
 /**

package/dist/get_logger.d.ts

@@ -1,6 +1,6 @@
 import { Logger } from './core/abstract_logger.js';
-import './core/logging_manager.js';
 import './core/log_level.js';
+import './core/logging_manager.js';
 import './core/log_transport.js';
 
 /**

package/dist/index.cjs

@@ -26,6 +26,8 @@ __export(index_exports, {
   getManager: () => import_logging_manager.getManager,
   logLevelName: () => import_log_level.logLevelName,
   parseLogLevel: () => import_log_level.parseLogLevel,
+  registerLogLevel: () => import_log_level.registerLogLevel,
+  registerLogLevels: () => import_log_level.registerLogLevels,
   shutdown: () => import_logging_manager.shutdown
 });
 module.exports = __toCommonJS(index_exports);
@@ -43,6 +45,8 @@ var import_console_transport = require("./transports/console_transport.cjs");
   getManager,
   logLevelName,
   parseLogLevel,
+  registerLogLevel,
+  registerLogLevels,
   shutdown
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { LogLevel, parseLogLevel, logLevelName } from './core/log_level.cjs';\nexport type { LogEntry, LogTransport } from './core/log_transport.cjs';\nexport type { Logger } from './core/abstract_logger.cjs';\nexport { getLogger } from './get_logger.cjs';\nexport { getManager, configureLogging, shutdown, LoggingManager } from './core/logging_manager.cjs';\nexport type { ConfigureLoggingOptions } from './core/logging_manager.cjs';\nexport { ConsoleTransport } from './transports/console_transport.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAsD;AAGtD,wBAA0B;AAC1B,6BAAuE;AAEvE,+BAAiC;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { LogLevel, logLevelName, parseLogLevel, registerLogLevel, registerLogLevels } from './core/log_level.cjs';\nexport type { LogLevelDefinition, LogLevelInput, LogLevelValue } from './core/log_level.cjs';\nexport type { LogEntry, LogTransport } from './core/log_transport.cjs';\nexport type { Logger } from './core/abstract_logger.cjs';\nexport { getLogger } from './get_logger.cjs';\nexport { getManager, configureLogging, shutdown, LoggingManager } from './core/logging_manager.cjs';\nexport type { ConfigureLoggingOptions } from './core/logging_manager.cjs';\nexport { ConsoleTransport } from './transports/console_transport.cjs';\nexport type { ConsoleTransportOptions, ConsoleWriter } from './transports/console_transport.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAA2F;AAI3F,wBAA0B;AAC1B,6BAAuE;AAEvE,+BAAiC;","names":[]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-export { LogLevel, logLevelName, parseLogLevel } from './core/log_level.cjs';
+export { LogLevel, LogLevelDefinition, LogLevelInput, LogLevelValue, logLevelName, parseLogLevel, registerLogLevel, registerLogLevels } from './core/log_level.cjs';
 export { LogEntry, LogTransport } from './core/log_transport.cjs';
 export { Logger } from './core/abstract_logger.cjs';
 export { getLogger } from './get_logger.cjs';
 export { ConfigureLoggingOptions, LoggingManager, configureLogging, getManager, shutdown } from './core/logging_manager.cjs';
-export { ConsoleTransport } from './transports/console_transport.cjs';
+export { ConsoleTransport, ConsoleTransportOptions, ConsoleWriter } from './transports/console_transport.cjs';

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-export { LogLevel, logLevelName, parseLogLevel } from './core/log_level.js';
+export { LogLevel, LogLevelDefinition, LogLevelInput, LogLevelValue, logLevelName, parseLogLevel, registerLogLevel, registerLogLevels } from './core/log_level.js';
 export { LogEntry, LogTransport } from './core/log_transport.js';
 export { Logger } from './core/abstract_logger.js';
 export { getLogger } from './get_logger.js';
 export { ConfigureLoggingOptions, LoggingManager, configureLogging, getManager, shutdown } from './core/logging_manager.js';
-export { ConsoleTransport } from './transports/console_transport.js';
+export { ConsoleTransport, ConsoleTransportOptions, ConsoleWriter } from './transports/console_transport.js';

package/dist/index.js

@@ -1,4 +1,4 @@
-import { LogLevel, parseLogLevel, logLevelName } from "./core/log_level.js";
+import { LogLevel, logLevelName, parseLogLevel, registerLogLevel, registerLogLevels } from "./core/log_level.js";
 import { getLogger } from "./get_logger.js";
 import { getManager, configureLogging, shutdown, LoggingManager } from "./core/logging_manager.js";
 import { ConsoleTransport } from "./transports/console_transport.js";
@@ -11,6 +11,8 @@ export {
   getManager,
   logLevelName,
   parseLogLevel,
+  registerLogLevel,
+  registerLogLevels,
   shutdown
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { LogLevel, parseLogLevel, logLevelName } from './core/log_level.js';\nexport type { LogEntry, LogTransport } from './core/log_transport.js';\nexport type { Logger } from './core/abstract_logger.js';\nexport { getLogger } from './get_logger.js';\nexport { getManager, configureLogging, shutdown, LoggingManager } from './core/logging_manager.js';\nexport type { ConfigureLoggingOptions } from './core/logging_manager.js';\nexport { ConsoleTransport } from './transports/console_transport.js';\n"],"mappings":"AAAA,SAAS,UAAU,eAAe,oBAAoB;AAGtD,SAAS,iBAAiB;AAC1B,SAAS,YAAY,kBAAkB,UAAU,sBAAsB;AAEvE,SAAS,wBAAwB;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export { LogLevel, logLevelName, parseLogLevel, registerLogLevel, registerLogLevels } from './core/log_level.js';\nexport type { LogLevelDefinition, LogLevelInput, LogLevelValue } from './core/log_level.js';\nexport type { LogEntry, LogTransport } from './core/log_transport.js';\nexport type { Logger } from './core/abstract_logger.js';\nexport { getLogger } from './get_logger.js';\nexport { getManager, configureLogging, shutdown, LoggingManager } from './core/logging_manager.js';\nexport type { ConfigureLoggingOptions } from './core/logging_manager.js';\nexport { ConsoleTransport } from './transports/console_transport.js';\nexport type { ConsoleTransportOptions, ConsoleWriter } from './transports/console_transport.js';\n"],"mappings":"AAAA,SAAS,UAAU,cAAc,eAAe,kBAAkB,yBAAyB;AAI3F,SAAS,iBAAiB;AAC1B,SAAS,YAAY,kBAAkB,UAAU,sBAAsB;AAEvE,SAAS,wBAAwB;","names":[]}

package/dist/transports/console.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transports/console.ts"],"sourcesContent":["// Re-export everything from console_transport for the ./transports/console entry point\nexport { ConsoleTransport } from './console_transport.cjs';\nexport { ConsoleTransport as default } from './console_transport.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,+BAAiC;AACjC,IAAAA,4BAA4C;","names":["import_console_transport"]}
+{"version":3,"sources":["../../src/transports/console.ts"],"sourcesContent":["// Re-export everything from console_transport for the ./transports/console entry point\nexport { ConsoleTransport } from './console_transport.cjs';\nexport type { ConsoleTransportOptions, ConsoleWriter } from './console_transport.cjs';\nexport { ConsoleTransport as default } from './console_transport.cjs';\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,+BAAiC;AAEjC,IAAAA,4BAA4C;","names":["import_console_transport"]}

package/dist/transports/console.d.cts

@@ -1,2 +1,2 @@
-export { ConsoleTransport, ConsoleTransport as default } from './console_transport.cjs';
+export { ConsoleTransport, ConsoleTransportOptions, ConsoleWriter, ConsoleTransport as default } from './console_transport.cjs';
 import '../core/log_transport.cjs';

package/dist/transports/console.d.ts

@@ -1,2 +1,2 @@
-export { ConsoleTransport, ConsoleTransport as default } from './console_transport.js';
+export { ConsoleTransport, ConsoleTransportOptions, ConsoleWriter, ConsoleTransport as default } from './console_transport.js';
 import '../core/log_transport.js';

package/dist/transports/console.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transports/console.ts"],"sourcesContent":["// Re-export everything from console_transport for the ./transports/console entry point\nexport { ConsoleTransport } from './console_transport.js';\nexport { ConsoleTransport as default } from './console_transport.js';\n"],"mappings":"AACA,SAAS,wBAAwB;AACjC,SAA6B,oBAApBA,yBAAmC;","names":["ConsoleTransport"]}
+{"version":3,"sources":["../../src/transports/console.ts"],"sourcesContent":["// Re-export everything from console_transport for the ./transports/console entry point\nexport { ConsoleTransport } from './console_transport.js';\nexport type { ConsoleTransportOptions, ConsoleWriter } from './console_transport.js';\nexport { ConsoleTransport as default } from './console_transport.js';\n"],"mappings":"AACA,SAAS,wBAAwB;AAEjC,SAA6B,oBAApBA,yBAAmC;","names":["ConsoleTransport"]}

package/dist/transports/console_transport.cjs

@@ -22,23 +22,206 @@ __export(console_transport_exports, {
   default: () => console_transport_default
 });
 module.exports = __toCommonJS(console_transport_exports);
+const MAX_LINE_LENGTH = 16 * 1024;
+const MAX_STRING_LENGTH = 4 * 1024;
+const MAX_DEPTH = 6;
+const MAX_COLLECTION_ENTRIES = 50;
+const MAX_NORMALIZED_VALUES = 200;
+const TRUNCATION_SUFFIX = "...[truncated]";
+const defaultStdoutWriter = (line) => console.log(line);
+const defaultStderrWriter = (line) => console.error(line);
 class ConsoleTransport {
+  constructor(options = {}) {
+    this.stdoutWriter = options.stdout ?? defaultStdoutWriter;
+    this.stderrWriter = options.stderr ?? defaultStderrWriter;
+  }
   log(entry) {
-    const contextStr = entry.context !== void 0 ? ` ${JSON.stringify(entry.context)}` : "";
-    const formatted = `[${entry.timestamp}] [${entry.logger}] [${entry.level}] ${entry.message}${contextStr}`;
-    switch (entry.level) {
-      case "ERROR":
-      case "FATAL":
-        console.error(formatted);
-        break;
-      case "WARN":
-        console.warn(formatted);
-        break;
-      default:
-        console.log(formatted);
-        break;
+    let level = "UNKNOWN";
+    let formatted = "[unknown-time] [unknown-logger] [UNKNOWN] [formatting failed]";
+    try {
+      level = this.readLevel(entry);
+      formatted = this.formatEntry(entry, level);
+    } catch {
+    }
+    const writer = level === "ERROR" || level === "FATAL" ? this.stderrWriter : this.stdoutWriter;
+    try {
+      writer(formatted);
+    } catch {
+    }
+  }
+  formatEntry(entry, level) {
+    const timestamp = toBoundedText(readProperty(entry, "timestamp"), "unknown-time", 128);
+    const logger = toBoundedText(readProperty(entry, "logger"), "unknown-logger", 256);
+    const message = toBoundedText(readProperty(entry, "message"), "[unavailable message]", MAX_STRING_LENGTH);
+    const context = readProperty(entry, "context");
+    const contextSuffix = context === void 0 ? "" : ` ${serializeContext(context)}`;
+    return truncate(`[${timestamp}] [${logger}] [${level}] ${message}${contextSuffix}`, MAX_LINE_LENGTH);
+  }
+  readLevel(entry) {
+    return toBoundedText(readProperty(entry, "level"), "UNKNOWN", 32).toUpperCase();
+  }
+}
+function readProperty(value, key) {
+  try {
+    return Reflect.get(value, key);
+  } catch (error) {
+    return `[Property access failed: ${describeFailure(error)}]`;
+  }
+}
+function serializeContext(context) {
+  try {
+    const normalized = normalizeValue(context, {
+      active: /* @__PURE__ */ new WeakSet(),
+      remainingValues: MAX_NORMALIZED_VALUES
+    }, 0);
+    return truncate(JSON.stringify(normalized), MAX_LINE_LENGTH);
+  } catch {
+    return '"[Context serialization failed]"';
+  }
+}
+function normalizeValue(value, state, depth) {
+  if (state.remainingValues <= 0) {
+    return "[Value limit reached]";
+  }
+  state.remainingValues -= 1;
+  switch (typeof value) {
+    case "undefined":
+      return "[undefined]";
+    case "string":
+      return truncate(value, MAX_STRING_LENGTH);
+    case "boolean":
+      return value;
+    case "number":
+      return Number.isFinite(value) ? value : String(value);
+    case "bigint":
+      return `${value.toString()}n`;
+    case "symbol":
+      return toBoundedText(value, "[Symbol]", MAX_STRING_LENGTH);
+    case "function":
+      return describeFunction(value);
+    case "object":
+      return normalizeObjectValue(value, state, depth);
+  }
+}
+function normalizeObjectValue(value, state, depth) {
+  if (value === null) {
+    return null;
+  }
+  if (depth >= MAX_DEPTH) {
+    return `[Depth limit ${MAX_DEPTH} reached]`;
+  }
+  if (state.active.has(value)) {
+    return "[Circular]";
+  }
+  state.active.add(value);
+  try {
+    if (isError(value)) {
+      return normalizeError(value, state, depth + 1);
+    }
+    if (Array.isArray(value)) {
+      return normalizeArray(value, state, depth + 1);
+    }
+    return normalizeRecord(value, state, depth + 1);
+  } catch (error) {
+    return `[Object serialization failed: ${describeFailure(error)}]`;
+  } finally {
+    state.active.delete(value);
+  }
+}
+function normalizeError(error, state, depth) {
+  const normalized = createNormalizedRecord();
+  normalized.name = normalizeValue(readProperty(error, "name"), state, depth);
+  normalized.message = normalizeValue(readProperty(error, "message"), state, depth);
+  const stack = readProperty(error, "stack");
+  if (stack !== void 0) {
+    normalized.stack = normalizeValue(stack, state, depth);
+  }
+  const cause = readProperty(error, "cause");
+  if (cause !== void 0) {
+    normalized.cause = normalizeValue(cause, state, depth);
+  }
+  appendEnumerableProperties(error, normalized, state, depth, /* @__PURE__ */ new Set(["name", "message", "stack", "cause"]));
+  return normalized;
+}
+function normalizeArray(value, state, depth) {
+  const length = value.length;
+  const normalized = [];
+  const includedLength = Math.min(length, MAX_COLLECTION_ENTRIES);
+  for (let index = 0; index < includedLength; index += 1) {
+    normalized.push(normalizeOwnProperty(value, String(index), state, depth, "[Empty]"));
+  }
+  if (length > includedLength) {
+    normalized.push(`[${length - includedLength} more items]`);
+  }
+  return normalized;
+}
+function normalizeRecord(value, state, depth) {
+  const normalized = createNormalizedRecord();
+  appendEnumerableProperties(value, normalized, state, depth);
+  return normalized;
+}
+function appendEnumerableProperties(value, target, state, depth, excludedKeys = /* @__PURE__ */ new Set()) {
+  const keys = Object.keys(value).filter((key) => !excludedKeys.has(key));
+  const includedKeys = keys.slice(0, MAX_COLLECTION_ENTRIES);
+  for (const key of includedKeys) {
+    target[key] = normalizeOwnProperty(value, key, state, depth, "[Unavailable]");
+  }
+  if (keys.length > includedKeys.length) {
+    target["[Truncated properties]"] = `${keys.length - includedKeys.length} more properties`;
+  }
+}
+function normalizeOwnProperty(value, key, state, depth, unavailableValue) {
+  try {
+    const descriptor = Object.getOwnPropertyDescriptor(value, key);
+    if (!descriptor) {
+      return unavailableValue;
     }
+    if ("value" in descriptor) {
+      return normalizeValue(descriptor.value, state, depth);
+    }
+    return descriptor.get ? "[Getter]" : "[Setter]";
+  } catch (error) {
+    return `[Property serialization failed: ${describeFailure(error)}]`;
+  }
+}
+function createNormalizedRecord() {
+  return /* @__PURE__ */ Object.create(null);
+}
+function describeFunction(value) {
+  try {
+    return truncate(value.name ? `[Function ${value.name}]` : "[Function]", MAX_STRING_LENGTH);
+  } catch {
+    return "[Function]";
+  }
+}
+function isError(value) {
+  try {
+    return value instanceof Error || Object.prototype.toString.call(value) === "[object Error]";
+  } catch {
+    return false;
+  }
+}
+function describeFailure(error) {
+  if (error instanceof Error) {
+    return toBoundedText(error.message, error.name || "Error", 256);
+  }
+  return toBoundedText(error, "unknown failure", 256);
+}
+function toBoundedText(value, fallback, maxLength) {
+  try {
+    return truncate(typeof value === "string" ? value : String(value), maxLength);
+  } catch {
+    return fallback;
+  }
+}
+function truncate(value, maxLength) {
+  if (value.length <= maxLength) {
+    return value;
+  }
+  if (maxLength <= TRUNCATION_SUFFIX.length) {
+    return TRUNCATION_SUFFIX.slice(0, maxLength);
   }
+  return `${value.slice(0, maxLength - TRUNCATION_SUFFIX.length)}${TRUNCATION_SUFFIX}`;
 }
 var console_transport_default = ConsoleTransport;
 // Annotate the CommonJS export names for ESM import in node:

package/dist/transports/console_transport.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/transports/console_transport.ts"],"sourcesContent":["import type { LogEntry, LogTransport } from \"../core/log_transport.cjs\";\n\nexport class ConsoleTransport implements LogTransport {\n  log(entry: LogEntry): void {\n    const contextStr = entry.context !== undefined ? ` ${JSON.stringify(entry.context)}` : \"\";\n    const formatted = `[${entry.timestamp}] [${entry.logger}] [${entry.level}] ${entry.message}${contextStr}`;\n\n    switch (entry.level) {\n      case \"ERROR\":\n      case \"FATAL\":\n        console.error(formatted);\n        break;\n      case \"WARN\":\n        console.warn(formatted);\n        break;\n      default:\n        console.log(formatted);\n        break;\n    }\n  }\n}\n\nexport default ConsoleTransport;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEO,MAAM,iBAAyC;AAAA,EACpD,IAAI,OAAuB;AACzB,UAAM,aAAa,MAAM,YAAY,SAAY,IAAI,KAAK,UAAU,MAAM,OAAO,CAAC,KAAK;AACvF,UAAM,YAAY,IAAI,MAAM,SAAS,MAAM,MAAM,MAAM,MAAM,MAAM,KAAK,KAAK,MAAM,OAAO,GAAG,UAAU;AAEvG,YAAQ,MAAM,OAAO;AAAA,MACnB,KAAK;AAAA,MACL,KAAK;AACH,gBAAQ,MAAM,SAAS;AACvB;AAAA,MACF,KAAK;AACH,gBAAQ,KAAK,SAAS;AACtB;AAAA,MACF;AACE,gBAAQ,IAAI,SAAS;AACrB;AAAA,IACJ;AAAA,EACF;AACF;AAEA,IAAO,4BAAQ;","names":[]}
+{"version":3,"sources":["../../src/transports/console_transport.ts"],"sourcesContent":["import type { LogEntry, LogTransport } from \"../core/log_transport.cjs\";\n\nconst MAX_LINE_LENGTH = 16 * 1024;\nconst MAX_STRING_LENGTH = 4 * 1024;\nconst MAX_DEPTH = 6;\nconst MAX_COLLECTION_ENTRIES = 50;\nconst MAX_NORMALIZED_VALUES = 200;\nconst TRUNCATION_SUFFIX = \"...[truncated]\";\n\nexport type ConsoleWriter = (line: string) => void;\n\nexport interface ConsoleTransportOptions {\n  stdout?: ConsoleWriter;\n  stderr?: ConsoleWriter;\n}\n\ntype NormalizedValue =\n  | null\n  | boolean\n  | number\n  | string\n  | NormalizedValue[]\n  | { [key: string]: NormalizedValue };\n\ninterface NormalizationState {\n  readonly active: WeakSet<object>;\n  remainingValues: number;\n}\n\nconst defaultStdoutWriter: ConsoleWriter = (line) => console.log(line);\nconst defaultStderrWriter: ConsoleWriter = (line) => console.error(line);\n\nexport class ConsoleTransport implements LogTransport {\n  private readonly stdoutWriter: ConsoleWriter;\n  private readonly stderrWriter: ConsoleWriter;\n\n  constructor(options: ConsoleTransportOptions = {}) {\n    this.stdoutWriter = options.stdout ?? defaultStdoutWriter;\n    this.stderrWriter = options.stderr ?? defaultStderrWriter;\n  }\n\n  log(entry: LogEntry): void {\n    let level = \"UNKNOWN\";\n    let formatted = \"[unknown-time] [unknown-logger] [UNKNOWN] [formatting failed]\";\n\n    try {\n      level = this.readLevel(entry);\n      formatted = this.formatEntry(entry, level);\n    } catch {\n      // Logging must never make the caller fail.\n    }\n\n    const writer = level === \"ERROR\" || level === \"FATAL\"\n      ? this.stderrWriter\n      : this.stdoutWriter;\n\n    try {\n      writer(formatted);\n    } catch {\n      // Console and injected writer failures are intentionally isolated.\n    }\n  }\n\n  private formatEntry(entry: LogEntry, level: string): string {\n    const timestamp = toBoundedText(readProperty(entry, \"timestamp\"), \"unknown-time\", 128);\n    const logger = toBoundedText(readProperty(entry, \"logger\"), \"unknown-logger\", 256);\n    const message = toBoundedText(readProperty(entry, \"message\"), \"[unavailable message]\", MAX_STRING_LENGTH);\n    const context = readProperty(entry, \"context\");\n    const contextSuffix = context === undefined ? \"\" : ` ${serializeContext(context)}`;\n\n    return truncate(`[${timestamp}] [${logger}] [${level}] ${message}${contextSuffix}`, MAX_LINE_LENGTH);\n  }\n\n  private readLevel(entry: LogEntry): string {\n    return toBoundedText(readProperty(entry, \"level\"), \"UNKNOWN\", 32).toUpperCase();\n  }\n}\n\nfunction readProperty(value: object, key: PropertyKey): unknown {\n  try {\n    return Reflect.get(value, key);\n  } catch (error) {\n    return `[Property access failed: ${describeFailure(error)}]`;\n  }\n}\n\nfunction serializeContext(context: unknown): string {\n  try {\n    const normalized = normalizeValue(context, {\n      active: new WeakSet<object>(),\n      remainingValues: MAX_NORMALIZED_VALUES,\n    }, 0);\n\n    return truncate(JSON.stringify(normalized), MAX_LINE_LENGTH);\n  } catch {\n    return '\"[Context serialization failed]\"';\n  }\n}\n\nfunction normalizeValue(\n  value: unknown,\n  state: NormalizationState,\n  depth: number,\n): NormalizedValue {\n  if (state.remainingValues <= 0) {\n    return \"[Value limit reached]\";\n  }\n  state.remainingValues -= 1;\n\n  switch (typeof value) {\n    case \"undefined\":\n      return \"[undefined]\";\n    case \"string\":\n      return truncate(value, MAX_STRING_LENGTH);\n    case \"boolean\":\n      return value;\n    case \"number\":\n      return Number.isFinite(value) ? value : String(value);\n    case \"bigint\":\n      return `${value.toString()}n`;\n    case \"symbol\":\n      return toBoundedText(value, \"[Symbol]\", MAX_STRING_LENGTH);\n    case \"function\":\n      return describeFunction(value);\n    case \"object\":\n      return normalizeObjectValue(value, state, depth);\n  }\n}\n\nfunction normalizeObjectValue(\n  value: object | null,\n  state: NormalizationState,\n  depth: number,\n): NormalizedValue {\n  if (value === null) {\n    return null;\n  }\n  if (depth >= MAX_DEPTH) {\n    return `[Depth limit ${MAX_DEPTH} reached]`;\n  }\n  if (state.active.has(value)) {\n    return \"[Circular]\";\n  }\n\n  state.active.add(value);\n  try {\n    if (isError(value)) {\n      return normalizeError(value, state, depth + 1);\n    }\n    if (Array.isArray(value)) {\n      return normalizeArray(value, state, depth + 1);\n    }\n    return normalizeRecord(value, state, depth + 1);\n  } catch (error) {\n    return `[Object serialization failed: ${describeFailure(error)}]`;\n  } finally {\n    state.active.delete(value);\n  }\n}\n\nfunction normalizeError(\n  error: object,\n  state: NormalizationState,\n  depth: number,\n): { [key: string]: NormalizedValue } {\n  const normalized = createNormalizedRecord();\n  normalized.name = normalizeValue(readProperty(error, \"name\"), state, depth);\n  normalized.message = normalizeValue(readProperty(error, \"message\"), state, depth);\n\n  const stack = readProperty(error, \"stack\");\n  if (stack !== undefined) {\n    normalized.stack = normalizeValue(stack, state, depth);\n  }\n\n  const cause = readProperty(error, \"cause\");\n  if (cause !== undefined) {\n    normalized.cause = normalizeValue(cause, state, depth);\n  }\n\n  appendEnumerableProperties(error, normalized, state, depth, new Set([\"name\", \"message\", \"stack\", \"cause\"]));\n  return normalized;\n}\n\nfunction normalizeArray(\n  value: unknown[],\n  state: NormalizationState,\n  depth: number,\n): NormalizedValue[] {\n  const length = value.length;\n  const normalized: NormalizedValue[] = [];\n  const includedLength = Math.min(length, MAX_COLLECTION_ENTRIES);\n\n  for (let index = 0; index < includedLength; index += 1) {\n    normalized.push(normalizeOwnProperty(value, String(index), state, depth, \"[Empty]\"));\n  }\n  if (length > includedLength) {\n    normalized.push(`[${length - includedLength} more items]`);\n  }\n\n  return normalized;\n}\n\nfunction normalizeRecord(\n  value: object,\n  state: NormalizationState,\n  depth: number,\n): { [key: string]: NormalizedValue } {\n  const normalized = createNormalizedRecord();\n  appendEnumerableProperties(value, normalized, state, depth);\n  return normalized;\n}\n\nfunction appendEnumerableProperties(\n  value: object,\n  target: { [key: string]: NormalizedValue },\n  state: NormalizationState,\n  depth: number,\n  excludedKeys: ReadonlySet<string> = new Set(),\n): void {\n  const keys = Object.keys(value).filter((key) => !excludedKeys.has(key));\n  const includedKeys = keys.slice(0, MAX_COLLECTION_ENTRIES);\n\n  for (const key of includedKeys) {\n    target[key] = normalizeOwnProperty(value, key, state, depth, \"[Unavailable]\");\n  }\n  if (keys.length > includedKeys.length) {\n    target[\"[Truncated properties]\"] = `${keys.length - includedKeys.length} more properties`;\n  }\n}\n\nfunction normalizeOwnProperty(\n  value: object,\n  key: string,\n  state: NormalizationState,\n  depth: number,\n  unavailableValue: string,\n): NormalizedValue {\n  try {\n    const descriptor = Object.getOwnPropertyDescriptor(value, key);\n    if (!descriptor) {\n      return unavailableValue;\n    }\n    if (\"value\" in descriptor) {\n      return normalizeValue(descriptor.value, state, depth);\n    }\n    return descriptor.get ? \"[Getter]\" : \"[Setter]\";\n  } catch (error) {\n    return `[Property serialization failed: ${describeFailure(error)}]`;\n  }\n}\n\nfunction createNormalizedRecord(): { [key: string]: NormalizedValue } {\n  return Object.create(null) as { [key: string]: NormalizedValue };\n}\n\nfunction describeFunction(value: Function): string {\n  try {\n    return truncate(value.name ? `[Function ${value.name}]` : \"[Function]\", MAX_STRING_LENGTH);\n  } catch {\n    return \"[Function]\";\n  }\n}\n\nfunction isError(value: object): boolean {\n  try {\n    return value instanceof Error || Object.prototype.toString.call(value) === \"[object Error]\";\n  } catch {\n    return false;\n  }\n}\n\nfunction describeFailure(error: unknown): string {\n  if (error instanceof Error) {\n    return toBoundedText(error.message, error.name || \"Error\", 256);\n  }\n  return toBoundedText(error, \"unknown failure\", 256);\n}\n\nfunction toBoundedText(value: unknown, fallback: string, maxLength: number): string {\n  try {\n    return truncate(typeof value === \"string\" ? value : String(value), maxLength);\n  } catch {\n    return fallback;\n  }\n}\n\nfunction truncate(value: string, maxLength: number): string {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  if (maxLength <= TRUNCATION_SUFFIX.length) {\n    return TRUNCATION_SUFFIX.slice(0, maxLength);\n  }\n  return `${value.slice(0, maxLength - TRUNCATION_SUFFIX.length)}${TRUNCATION_SUFFIX}`;\n}\n\nexport default ConsoleTransport;\n"],"mappings":"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","names":[]}

package/dist/transports/console_transport.d.cts

@@ -1,7 +1,17 @@
 import { LogTransport, LogEntry } from '../core/log_transport.cjs';
 
+type ConsoleWriter = (line: string) => void;
+interface ConsoleTransportOptions {
+    stdout?: ConsoleWriter;
+    stderr?: ConsoleWriter;
+}
 declare class ConsoleTransport implements LogTransport {
+    private readonly stdoutWriter;
+    private readonly stderrWriter;
+    constructor(options?: ConsoleTransportOptions);
     log(entry: LogEntry): void;
+    private formatEntry;
+    private readLevel;
 }
 
-export { ConsoleTransport, ConsoleTransport as default };
+export { ConsoleTransport, type ConsoleTransportOptions, type ConsoleWriter, ConsoleTransport as default };

package/dist/transports/console_transport.d.ts

@@ -1,7 +1,17 @@
 import { LogTransport, LogEntry } from '../core/log_transport.js';
 
+type ConsoleWriter = (line: string) => void;
+interface ConsoleTransportOptions {
+    stdout?: ConsoleWriter;
+    stderr?: ConsoleWriter;
+}
 declare class ConsoleTransport implements LogTransport {
+    private readonly stdoutWriter;
+    private readonly stderrWriter;
+    constructor(options?: ConsoleTransportOptions);
     log(entry: LogEntry): void;
+    private formatEntry;
+    private readLevel;
 }
 
-export { ConsoleTransport, ConsoleTransport as default };
+export { ConsoleTransport, type ConsoleTransportOptions, type ConsoleWriter, ConsoleTransport as default };