logan-logger 1.1.2 → 1.1.6

package/dist/node-NjRZ5jt7.mjs

@@ -0,0 +1,334 @@
+import { g as L, L as r, s as w, d as l, B as c } from "./browser-C6UkWymL.mjs";
+class i extends L {
+  constructor(e = {}) {
+    super(e), this.initializeWinston();
+  }
+  async initializeWinston() {
+    try {
+      const e = await import("winston");
+      this.winston = this.createWinstonLogger(e);
+    } catch {
+      console.warn("[logan-logger] Winston not found, falling back to console logging");
+    }
+  }
+  createWinstonLogger(e) {
+    const n = e.format.combine(
+      e.format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }),
+      e.format.errors({ stack: !0 }),
+      e.format.json(),
+      e.format.prettyPrint()
+    ), o = e.format.combine(
+      e.format.colorize(),
+      e.format.timestamp({ format: "HH:mm:ss" }),
+      e.format.printf(({ timestamp: a, level: g, message: d, ...u }) => {
+        const p = Object.keys(u).length ? JSON.stringify(u, null, 2) : "";
+        return `${a} [${g}]: ${d} ${p}`;
+      })
+    ), s = e.createLogger({
+      level: this.getWinstonLevel(this.level),
+      format: n,
+      transports: [
+        new e.transports.Console({
+          format: process.env.NODE_ENV === "production" ? n : o
+        })
+      ]
+    });
+    return process.env.NODE_ENV === "production" && (s.add(
+      new e.transports.File({
+        filename: "logs/error.log",
+        level: "error",
+        maxsize: 5242880,
+        // 5MB
+        maxFiles: 5
+      })
+    ), s.add(
+      new e.transports.File({
+        filename: "logs/combined.log",
+        maxsize: 5242880,
+        // 5MB
+        maxFiles: 10
+      })
+    )), s;
+  }
+  writeLog(e) {
+    this.winston ? this.winston.log({
+      level: this.getWinstonLevel(e.level),
+      message: e.message,
+      timestamp: e.timestamp,
+      ...e.metadata
+    }) : this.writeToConsole(e);
+  }
+  createChild() {
+    return new i(this.config);
+  }
+  writeToConsole(e) {
+    const n = e.timestamp.toISOString(), o = r[e.level].toLowerCase(), s = e.metadata ? ` ${w(e.metadata)}` : "", a = `[${n}] ${o.toUpperCase()}: ${e.message}${s}`;
+    switch (e.level) {
+      case r.DEBUG:
+        console.debug(a);
+        break;
+      case r.INFO:
+        console.info(a);
+        break;
+      case r.WARN:
+        console.warn(a);
+        break;
+      case r.ERROR:
+        console.error(a);
+        break;
+    }
+  }
+  getWinstonLevel(e) {
+    switch (e) {
+      case r.DEBUG:
+        return "debug";
+      case r.INFO:
+        return "info";
+      case r.WARN:
+        return "warn";
+      case r.ERROR:
+        return "error";
+      default:
+        return "info";
+    }
+  }
+  setLevel(e) {
+    super.setLevel(e), this.winston && (this.winston.level = this.getWinstonLevel(e));
+  }
+}
+function b(t) {
+  return {
+    write: (e) => {
+      t.info(e.trim());
+    }
+  };
+}
+function f() {
+  const t = l();
+  return {
+    level: r.INFO,
+    format: "text",
+    timestamp: !0,
+    colorize: t.capabilities.colorSupport,
+    metadata: {},
+    transports: [
+      {
+        type: "console",
+        options: {}
+      }
+    ]
+  };
+}
+function T() {
+  const t = {};
+  if (typeof process < "u" && process.env) {
+    const e = process.env;
+    e.LOG_LEVEL && (t.level = E(e.LOG_LEVEL)), e.LOG_FORMAT && ["json", "text"].includes(e.LOG_FORMAT) && (t.format = e.LOG_FORMAT), e.LOG_TIMESTAMP && (t.timestamp = e.LOG_TIMESTAMP.toLowerCase() === "true"), e.LOG_COLOR && (t.colorize = e.LOG_COLOR.toLowerCase() === "true");
+  }
+  return t;
+}
+async function W(t) {
+  const e = l();
+  if (!e.capabilities.fileSystem)
+    return {};
+  const n = t ? [t] : [
+    "logan.config.json",
+    "logan.config.js",
+    ".loganrc",
+    "package.json"
+    // Check for logan config in package.json
+  ];
+  for (const o of n)
+    try {
+      if (e.name === "node")
+        return await m(o);
+      if (e.name === "deno")
+        return await v(o);
+      if (e.name === "bun")
+        return await O(o);
+    } catch {
+    }
+  return {};
+}
+async function m(t) {
+  try {
+    const e = await import("./__vite-browser-external-DYxpcVy9.mjs"), n = await import("./__vite-browser-external-DYxpcVy9.mjs");
+    if (t.endsWith(".json")) {
+      const o = await e.readFile(t, "utf-8"), s = JSON.parse(o);
+      return t === "package.json" ? s.logan || {} : s;
+    } else if (t.endsWith(".js")) {
+      const s = await import(n.resolve(t));
+      return s.default || s;
+    }
+  } catch {
+  }
+  return {};
+}
+async function v(t) {
+  try {
+    if (t.endsWith(".json")) {
+      const e = await globalThis.Deno.readTextFile(t), n = JSON.parse(e);
+      return t === "package.json" ? n.logan || {} : n;
+    } else if (t.endsWith(".js")) {
+      const e = await import(
+        /* @vite-ignore */
+        `./${t}`
+      );
+      return e.default || e;
+    }
+  } catch {
+  }
+  return {};
+}
+async function O(t) {
+  return m(t);
+}
+function E(t) {
+  switch (t.toLowerCase()) {
+    case "debug":
+      return r.DEBUG;
+    case "info":
+      return r.INFO;
+    case "warn":
+    case "warning":
+      return r.WARN;
+    case "error":
+      return r.ERROR;
+    case "silent":
+    case "none":
+      return r.SILENT;
+    default:
+      return r.INFO;
+  }
+}
+function _(...t) {
+  const e = f();
+  return t.reduce((n, o) => ({
+    ...n,
+    ...o,
+    metadata: {
+      ...n.metadata,
+      ...o.metadata
+    },
+    transports: o.transports || n.transports
+  }), e);
+}
+class N {
+  /**
+   * Create a logger instance appropriate for the current runtime.
+   * @param config - Optional configuration for the logger
+   * @returns A logger instance
+   */
+  static create(e = {}) {
+    const n = l(), o = this.mergeConfig(e);
+    switch (n.name) {
+      case "node":
+        return new i(o);
+      case "deno":
+        return new c(o);
+      case "bun":
+        return new i(o);
+      case "browser":
+      case "webworker":
+        return new c(o);
+      default:
+        return new c(o);
+    }
+  }
+  /**
+   * Create a child logger with additional metadata.
+   * @param parent - The parent logger instance
+   * @param metadata - Additional metadata to include in all child log messages
+   * @returns A new logger instance with the additional metadata
+   */
+  static createChild(e, n) {
+    return e.child(n);
+  }
+  static mergeConfig(e) {
+    const n = f();
+    return {
+      ...n,
+      ...e,
+      metadata: {
+        ...n.metadata,
+        ...e.metadata
+      }
+    };
+  }
+}
+function h(t) {
+  return N.create(t);
+}
+function I() {
+  const t = R(), e = {
+    level: F(t),
+    colorize: t !== "production",
+    timestamp: !0,
+    format: t === "production" ? "json" : "text"
+  };
+  return h(e);
+}
+function R() {
+  return typeof process < "u" && process.env ? process.env.NODE_ENV || process.env.NEXT_PUBLIC_APP_ENV || process.env.ENVIRONMENT || "development" : typeof window < "u" && globalThis.__ENV__ || "development";
+}
+function F(t) {
+  switch (t) {
+    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(t) {
+  switch (t.toLowerCase()) {
+    case "debug":
+      return r.DEBUG;
+    case "info":
+      return r.INFO;
+    case "warn":
+    case "warning":
+      return r.WARN;
+    case "error":
+      return r.ERROR;
+    case "silent":
+    case "none":
+      return r.SILENT;
+    default:
+      return r.INFO;
+  }
+}
+function G(t) {
+  switch (t) {
+    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";
+  }
+}
+export {
+  N as L,
+  i as N,
+  I as a,
+  W as b,
+  h as c,
+  G as d,
+  b as e,
+  f as g,
+  T as l,
+  _ as m,
+  S as s
+};

package/dist/node-jP3ESR8x.js

@@ -0,0 +1 @@
+"use strict";var p=Object.create;var g=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var E=Object.getPrototypeOf,N=Object.prototype.hasOwnProperty;var h=(t,e,o,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let s of O(e))!N.call(t,s)&&s!==o&&g(t,s,{get:()=>e[s],enumerable:!(n=w(e,s))||n.enumerable});return t};var R=(t,e,o)=>(o=t!=null?p(E(t)):{},h(e||!t||!t.__esModule?g(o,"default",{value:t,enumerable:!0}):o,t));const r=require("./browser-BzeNXjes.js");class i extends r.BaseLogger{constructor(e={}){super(e),this.initializeWinston()}async initializeWinston(){try{const e=await import("winston");this.winston=this.createWinstonLogger(e)}catch{console.warn("[logan-logger] Winston not found, falling back to console logging")}}createWinstonLogger(e){const o=e.format.combine(e.format.timestamp({format:"YYYY-MM-DD HH:mm:ss"}),e.format.errors({stack:!0}),e.format.json(),e.format.prettyPrint()),n=e.format.combine(e.format.colorize(),e.format.timestamp({format:"HH:mm:ss"}),e.format.printf(({timestamp:a,level:m,message:d,...l})=>{const v=Object.keys(l).length?JSON.stringify(l,null,2):"";return`${a} [${m}]: ${d} ${v}`})),s=e.createLogger({level:this.getWinstonLevel(this.level),format:o,transports:[new e.transports.Console({format:process.env.NODE_ENV==="production"?o:n})]});return process.env.NODE_ENV==="production"&&(s.add(new e.transports.File({filename:"logs/error.log",level:"error",maxsize:5242880,maxFiles:5})),s.add(new e.transports.File({filename:"logs/combined.log",maxsize:5242880,maxFiles:10}))),s}writeLog(e){this.winston?this.winston.log({level:this.getWinstonLevel(e.level),message:e.message,timestamp:e.timestamp,...e.metadata}):this.writeToConsole(e)}createChild(){return new i(this.config)}writeToConsole(e){const o=e.timestamp.toISOString(),n=r.LogLevel[e.level].toLowerCase(),s=e.metadata?` ${r.safeStringify(e.metadata)}`:"",a=`[${o}] ${n.toUpperCase()}: ${e.message}${s}`;switch(e.level){case r.LogLevel.DEBUG:console.debug(a);break;case r.LogLevel.INFO:console.info(a);break;case r.LogLevel.WARN:console.warn(a);break;case r.LogLevel.ERROR:console.error(a);break}}getWinstonLevel(e){switch(e){case r.LogLevel.DEBUG:return"debug";case r.LogLevel.INFO:return"info";case r.LogLevel.WARN:return"warn";case r.LogLevel.ERROR:return"error";default:return"info"}}setLevel(e){super.setLevel(e),this.winston&&(this.winston.level=this.getWinstonLevel(e))}}function F(t){return{write:e=>{t.info(e.trim())}}}function c(){const t=r.detectRuntime();return{level:r.LogLevel.INFO,format:"text",timestamp:!0,colorize:t.capabilities.colorSupport,metadata:{},transports:[{type:"console",options:{}}]}}function C(){const t={};if(typeof process<"u"&&process.env){const e=process.env;e.LOG_LEVEL&&(t.level=W(e.LOG_LEVEL)),e.LOG_FORMAT&&["json","text"].includes(e.LOG_FORMAT)&&(t.format=e.LOG_FORMAT),e.LOG_TIMESTAMP&&(t.timestamp=e.LOG_TIMESTAMP.toLowerCase()==="true"),e.LOG_COLOR&&(t.colorize=e.LOG_COLOR.toLowerCase()==="true")}return t}async function b(t){const e=r.detectRuntime();if(!e.capabilities.fileSystem)return{};const o=t?[t]:["logan.config.json","logan.config.js",".loganrc","package.json"];for(const n of o)try{if(e.name==="node")return await u(n);if(e.name==="deno")return await T(n);if(e.name==="bun")return await S(n)}catch{}return{}}async function u(t){try{const e=await Promise.resolve().then(()=>require("./__vite-browser-external-BcPniuRQ.js")),o=await Promise.resolve().then(()=>require("./__vite-browser-external-BcPniuRQ.js"));if(t.endsWith(".json")){const n=await e.readFile(t,"utf-8"),s=JSON.parse(n);return t==="package.json"?s.logan||{}:s}else if(t.endsWith(".js")){const s=await import(o.resolve(t));return s.default||s}}catch{}return{}}async function T(t){try{if(t.endsWith(".json")){const e=await globalThis.Deno.readTextFile(t),o=JSON.parse(e);return t==="package.json"?o.logan||{}:o}else if(t.endsWith(".js")){const e=await import(`./${t}`);return e.default||e}}catch{}return{}}async function S(t){return u(t)}function W(t){switch(t.toLowerCase()){case"debug":return r.LogLevel.DEBUG;case"info":return r.LogLevel.INFO;case"warn":case"warning":return r.LogLevel.WARN;case"error":return r.LogLevel.ERROR;case"silent":case"none":return r.LogLevel.SILENT;default:return r.LogLevel.INFO}}function _(...t){const e=c();return t.reduce((o,n)=>({...o,...n,metadata:{...o.metadata,...n.metadata},transports:n.transports||o.transports}),e)}class L{static create(e={}){const o=r.detectRuntime(),n=this.mergeConfig(e);switch(o.name){case"node":return new i(n);case"deno":return new r.BrowserLogger(n);case"bun":return new i(n);case"browser":case"webworker":return new r.BrowserLogger(n);default:return new r.BrowserLogger(n)}}static createChild(e,o){return e.child(o)}static mergeConfig(e){const o=c();return{...o,...e,metadata:{...o.metadata,...e.metadata}}}}function f(t){return L.create(t)}function I(){const t=D(),e={level:G(t),colorize:t!=="production",timestamp:!0,format:t==="production"?"json":"text"};return f(e)}function D(){return typeof process<"u"&&process.env?process.env.NODE_ENV||process.env.NEXT_PUBLIC_APP_ENV||process.env.ENVIRONMENT||"development":typeof window<"u"&&globalThis.__ENV__||"development"}function G(t){switch(t){case"production":return r.LogLevel.ERROR;case"staging":case"test":return r.LogLevel.WARN;case"development":case"dev":return r.LogLevel.DEBUG;default:return r.LogLevel.INFO}}function j(t){switch(t.toLowerCase()){case"debug":return r.LogLevel.DEBUG;case"info":return r.LogLevel.INFO;case"warn":case"warning":return r.LogLevel.WARN;case"error":return r.LogLevel.ERROR;case"silent":case"none":return r.LogLevel.SILENT;default:return r.LogLevel.INFO}}function M(t){switch(t){case r.LogLevel.DEBUG:return"debug";case r.LogLevel.INFO:return"info";case r.LogLevel.WARN:return"warn";case r.LogLevel.ERROR:return"error";case r.LogLevel.SILENT:return"silent";default:return"info"}}exports.LoggerFactory=L;exports.NodeLogger=i;exports.createLogger=f;exports.createLoggerForEnvironment=I;exports.createMorganStream=F;exports.getDefaultConfig=c;exports.loadConfigFromEnvironment=C;exports.loadConfigFromFile=b;exports.logLevelToString=M;exports.mergeConfigs=_;exports.stringToLogLevel=j;

package/dist/node.d.ts

@@ -1,190 +1,3 @@
-declare abstract class BaseLogger implements ILogger {
-    protected level: LogLevel;
-    protected config: Partial<LoggerConfig>;
-    protected runtime: RuntimeName;
-    protected childMetadata: Record<string, any>;
-    protected constructor(config?: Partial<LoggerConfig>);
-    debug(message: LogMessage, metadata?: any): void;
-    info(message: LogMessage, metadata?: any): void;
-    warn(message: LogMessage, metadata?: any): void;
-    error(message: LogMessage, metadata?: any): void;
-    log(level: LogLevel, message: LogMessage, metadata?: any): void;
-    setLevel(level: LogLevel): void;
-    getLevel(): LogLevel;
-    child(metadata: Record<string, any>): ILogger;
-    protected shouldLog(level: LogLevel): boolean;
-    protected abstract writeLog(entry: LogEntry): void;
-    protected abstract createChild(): BaseLogger;
-}
-
-/**
- * Convenience function for creating a logger instance.
- * @param config - Optional configuration for the logger
- * @returns A logger instance appropriate for the current runtime
- * @example
- * ```typescript
- * import { createLogger, LogLevel } from 'logan-logger';
- *
- * const logger = createLogger({
- *   level: LogLevel.DEBUG,
- *   colorize: true
- * });
- *
- * logger.info('Hello world!');
- * ```
- */
-export declare function createLogger(config?: Partial<LoggerConfig>): ILogger;
-
-/**
- * Create a logger with configuration based on the current environment.
- * Automatically detects production/development/test environments and
- * sets appropriate log levels and formatting.
- * @returns A logger instance configured for the current environment
- */
-export declare function createLoggerForEnvironment(): ILogger;
-
-export declare function createMorganStream(logger: NodeLogger): {
-    write: (message: string) => void;
-};
-
-/**
- * Main logger interface providing methods for logging at different levels.
- * This interface is implemented by all logger implementations across different runtimes.
- */
-export declare interface ILogger {
-    /**
-     * Log a debug message. Only shown when log level is DEBUG.
-     * @param message - The message to log (string or lazy function)
-     * @param metadata - Optional structured data to include
-     */
-    debug(message: LogMessage, metadata?: any): void;
-    /**
-     * Log an informational message.
-     * @param message - The message to log (string or lazy function)
-     * @param metadata - Optional structured data to include
-     */
-    info(message: LogMessage, metadata?: any): void;
-    /**
-     * Log a warning message.
-     * @param message - The message to log (string or lazy function)
-     * @param metadata - Optional structured data to include
-     */
-    warn(message: LogMessage, metadata?: any): void;
-    /**
-     * Log an error message.
-     * @param message - The message to log (string or lazy function)
-     * @param metadata - Optional structured data to include
-     */
-    error(message: LogMessage, metadata?: any): void;
-    /**
-     * Log a message at a specific level.
-     * @param level - The log level
-     * @param message - The message to log (string or lazy function)
-     * @param metadata - Optional structured data to include
-     */
-    log(level: LogLevel, message: LogMessage, metadata?: any): void;
-    /**
-     * Set the minimum log level for this logger.
-     * @param level - The minimum log level
-     */
-    setLevel(level: LogLevel): void;
-    /**
-     * Get the current minimum log level.
-     * @returns The current log level
-     */
-    getLevel(): LogLevel;
-    /**
-     * Create a child logger with additional metadata.
-     * @param metadata - Additional metadata to include in all child log messages
-     * @returns A new logger instance with the additional metadata
-     */
-    child(metadata: Record<string, any>): ILogger;
-}
-
-/**
- * Internal representation of a log entry.
- */
-declare interface LogEntry {
-    /** When the log entry was created */
-    timestamp: Date;
-    /** Log level of this entry */
-    level: LogLevel;
-    /** The log message */
-    message: string;
-    /** Additional structured data */
-    metadata?: Record<string, any>;
-    /** Runtime that generated this log entry */
-    runtime: RuntimeName;
-}
-
-/**
- * Configuration options for creating a logger instance.
- */
-export declare interface LoggerConfig {
-    /** Minimum log level to output */
-    level: LogLevel;
-    /** Output format for log messages */
-    format: 'json' | 'text' | 'custom';
-    /** Whether to include timestamps in log output */
-    timestamp: boolean;
-    /** Whether to colorize log output (if supported) */
-    colorize: boolean;
-    /** Default metadata to include with all log messages */
-    metadata: Record<string, any>;
-    /** Transport configurations for log output */
-    transports?: TransportConfig[];
-}
-
-/**
- * Log levels in ascending order of severity.
- * Used to filter which messages should be logged.
- */
-export declare enum LogLevel {
-    /** Debug messages - most verbose */
-    DEBUG = 0,
-    /** Informational messages */
-    INFO = 1,
-    /** Warning messages */
-    WARN = 2,
-    /** Error messages */
-    ERROR = 3,
-    /** No messages - silent mode */
-    SILENT = 4
-}
-
-/**
- * A log message can be a string or a function that returns a string.
- * Functions enable lazy evaluation for expensive log message generation.
- */
-declare type LogMessage = string | (() => string);
-
-export declare class NodeLogger extends BaseLogger {
-    private winston?;
-    constructor(config?: Partial<LoggerConfig>);
-    private initializeWinston;
-    private createWinstonLogger;
-    protected writeLog(entry: LogEntry): void;
-    protected createChild(): BaseLogger;
-    private writeToConsole;
-    private getWinstonLevel;
-    setLevel(level: LogLevel): void;
-}
-
-/**
- * Supported JavaScript runtime environments.
- */
-declare type RuntimeName = 'node' | 'deno' | 'bun' | 'browser' | 'webworker' | 'unknown';
-
-/**
- * Configuration for a specific log transport (output destination).
- */
-declare interface TransportConfig {
-    /** Type of transport */
-    type: 'console' | 'file' | 'http' | 'custom';
-    /** Minimum log level for this transport */
-    level?: LogLevel;
-    /** Transport-specific options */
-    options: Record<string, any>;
-}
-
-export { }
+export { NodeLogger, createMorganStream } from './runtime/node';
+export type { ILogger, LoggerConfig, LogLevel } from './core/types';
+export { createLogger, createLoggerForEnvironment } from './core/factory';

package/dist/node.esm.js

@@ -1,4 +1,4 @@
-import { N as a, a as o, c as g, r as t } from "./node-BqvVrzA_.mjs";
+import { N as a, c as o, a as g, e as t } from "./node-NjRZ5jt7.mjs";
 export {
   a as NodeLogger,
   o as createLogger,

package/dist/node.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./node-BKsollr4.js");exports.NodeLogger=e.NodeLogger;exports.createLogger=e.createLogger;exports.createLoggerForEnvironment=e.createLoggerForEnvironment;exports.createMorganStream=e.createMorganStream;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./node-jP3ESR8x.js");exports.NodeLogger=e.NodeLogger;exports.createLogger=e.createLogger;exports.createLoggerForEnvironment=e.createLoggerForEnvironment;exports.createMorganStream=e.createMorganStream;

package/dist/runtime/browser.d.ts

@@ -0,0 +1,31 @@
+import { BaseLogger } from '../core/logger';
+import { LogEntry, LogLevel, LoggerConfig } from '../core/types';
+export declare class BrowserLogger extends BaseLogger {
+    constructor(config?: Partial<LoggerConfig>);
+    protected writeLog(entry: LogEntry): void;
+    protected createChild(): BaseLogger;
+    private formatMessage;
+    private getConsoleStyle;
+    private shouldLogInProduction;
+    protected shouldLog(level: LogLevel): boolean;
+}
+export declare class ConsoleGroupLogger extends BrowserLogger {
+    private groupStack;
+    group(label: string): void;
+    groupCollapsed(label: string): void;
+    groupEnd(): void;
+    getCurrentGroupStack(): string[];
+    getCurrentGroupPath(): string;
+    time(label: string): void;
+    timeEnd(label: string): void;
+    trace(message: string, metadata?: any): void;
+    count(label?: string): void;
+    countReset(label?: string): void;
+    table(data: any): void;
+}
+export declare class PerformanceLogger extends BrowserLogger {
+    mark(name: string): void;
+    measure(name: string, startMark?: string, endMark?: string): void;
+    clearMarks(name?: string): void;
+    clearMeasures(name?: string): void;
+}

package/dist/runtime/node.d.ts

@@ -0,0 +1,16 @@
+import { BaseLogger } from '../core/logger';
+import { LogEntry, LogLevel, LoggerConfig } from '../core/types';
+export declare class NodeLogger extends BaseLogger {
+    private winston?;
+    constructor(config?: Partial<LoggerConfig>);
+    private initializeWinston;
+    private createWinstonLogger;
+    protected writeLog(entry: LogEntry): void;
+    protected createChild(): BaseLogger;
+    private writeToConsole;
+    private getWinstonLevel;
+    setLevel(level: LogLevel): void;
+}
+export declare function createMorganStream(logger: NodeLogger): {
+    write: (message: string) => void;
+};

package/dist/utils/config.d.ts

@@ -0,0 +1,5 @@
+import { LoggerConfig } from '../core/types';
+export declare function getDefaultConfig(): LoggerConfig;
+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.ts

@@ -0,0 +1,31 @@
+import { LogEntry, LogLevel } from '../core/types';
+/**
+ * Format a log entry for output in different formats.
+ * @param entry - The log entry to format
+ * @param format - Output format ('json' or 'text')
+ * @returns Formatted log string
+ * @example
+ * ```typescript
+ * const entry: LogEntry = {
+ *   timestamp: new Date(),
+ *   level: LogLevel.INFO,
+ *   message: 'User logged in',
+ *   metadata: { userId: 123 },
+ *   runtime: 'node'
+ * };
+ *
+ * const textFormat = formatLogEntry(entry, 'text');
+ * // Result: "[2024-01-01T12:00:00.000Z] 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;
+/**
+ * Format log level as a colored string for terminal output.
+ * @param level - The log level to format
+ * @param colorize - Whether to apply ANSI color codes
+ * @returns Formatted level string with optional colors
+ */
+export declare function formatLevel(level: LogLevel, colorize?: boolean): string;

package/dist/utils/runtime.d.ts

@@ -0,0 +1,31 @@
+import { RuntimeInfo } from '../core/types';
+/**
+ * Detects the current JavaScript runtime environment and its capabilities.
+ * @returns Information about the detected runtime
+ * @example
+ * ```typescript
+ * const runtime = detectRuntime();
+ * console.log(`Running on: ${runtime.name} ${runtime.version}`);
+ * ```
+ */
+export declare function detectRuntime(): RuntimeInfo;
+/**
+ * Check if the current runtime is Node.js.
+ * @returns True if running in Node.js
+ */
+export declare function isNode(): boolean;
+/**
+ * Check if the current runtime is a browser.
+ * @returns True if running in a browser
+ */
+export declare function isBrowser(): boolean;
+/**
+ * Check if the current runtime is Deno.
+ * @returns True if running in Deno
+ */
+export declare function isDeno(): boolean;
+/**
+ * Check if the current runtime is Bun.
+ * @returns True if running in Bun
+ */
+export declare function isBun(): boolean;