@morojs/moro 1.5.3 → 1.5.5

package/src/core/logger/logger.ts

@@ -1,5 +1,6 @@
 // Moro Logger - Beautiful, Fast, Feature-Rich
 import { performance } from 'perf_hooks';
+
 import {
   LogLevel,
   LogEntry,
@@ -31,6 +32,37 @@ export class MoroLogger implements Logger {
   private contextMetadata?: Record<string, any>;
   private parent?: MoroLogger; // Reference to parent logger for level inheritance
 
+  // Performance optimizations
+  private historyIndex = 0;
+  private historySize = 0;
+  private lastMemoryCheck = 0;
+  private memoryCheckInterval = 5000; // 5 seconds
+  private cachedTimestamp = '';
+  private lastTimestamp = 0;
+  private timestampCacheInterval = 100; // 100ms for better precision
+
+  // Object pooling for LogEntry objects (Pino's technique)
+  private static readonly ENTRY_POOL: LogEntry[] = [];
+  private static readonly MAX_POOL_SIZE = 100;
+  private static poolIndex = 0;
+
+  // String builder for efficient concatenation
+  private static stringBuilder: string[] = [];
+  private static stringBuilderIndex = 0;
+
+  // Buffered output for performance
+  private outputBuffer: string[] = [];
+  private bufferSize = 0;
+  private maxBufferSize = 1000;
+  private flushTimeout: NodeJS.Timeout | null = null;
+  private flushInterval = 1; // 1ms micro-batching
+
+  // Buffer overflow protection
+  private bufferOverflowThreshold: number;
+  private emergencyFlushInProgress = false;
+
+  // High-performance output methods
+
   private static readonly LEVELS: Record<LogLevel, number> = {
     debug: 0,
     info: 1,
@@ -49,13 +81,23 @@ export class MoroLogger implements Logger {
     context: '\x1b[34m', // Blue
     metadata: '\x1b[37m', // White
     performance: '\x1b[36m', // Cyan
+    reset: '\x1b[0m', // Reset
   };
 
   private static readonly RESET = '\x1b[0m';
   private static readonly BOLD = '\x1b[1m';
 
+  // Static pre-allocated strings for performance
+  private static readonly LEVEL_STRINGS: Record<LogLevel, string> = {
+    debug: 'DEBUG',
+    info: 'INFO ',
+    warn: 'WARN ',
+    error: 'ERROR',
+    fatal: 'FATAL',
+  };
+
   constructor(options: LoggerOptions = {}) {
-    this.options = {
+    this.options = this.validateOptions({
       level: 'info',
       enableColors: true,
       enableTimestamp: true,
@@ -66,11 +108,18 @@ export class MoroLogger implements Logger {
       outputs: [],
       filters: [],
       maxEntries: 1000,
+      maxBufferSize: 1000,
       ...options,
-    };
+    });
 
     this.level = this.options.level || 'info';
 
+    // Initialize buffer size from options
+    this.maxBufferSize = this.options.maxBufferSize || 1000;
+
+    // Initialize buffer overflow protection
+    this.bufferOverflowThreshold = this.maxBufferSize * 2;
+
     // Add default console output
     this.addOutput({
       name: 'console',
@@ -83,6 +132,58 @@ export class MoroLogger implements Logger {
     this.options.filters?.forEach(filter => this.addFilter(filter));
   }
 
+  // Object pooling methods
+  private static getPooledEntry(): LogEntry {
+    if (MoroLogger.ENTRY_POOL.length > 0) {
+      const entry = MoroLogger.ENTRY_POOL.pop()!;
+      // Properly reset ALL properties to prevent memory leaks
+      entry.timestamp = new Date();
+      entry.level = 'info';
+      entry.message = '';
+      entry.context = undefined;
+      entry.metadata = undefined;
+      entry.performance = undefined;
+      entry.moduleId = undefined;
+      return entry;
+    }
+    return MoroLogger.createFreshEntry();
+  }
+
+  // ADD this new method:
+  private static createFreshEntry(): LogEntry {
+    return {
+      timestamp: new Date(),
+      level: 'info',
+      message: '',
+      context: undefined,
+      metadata: undefined,
+      performance: undefined,
+      moduleId: undefined,
+    };
+  }
+
+  private static returnPooledEntry(entry: LogEntry): void {
+    if (MoroLogger.ENTRY_POOL.length < MoroLogger.MAX_POOL_SIZE) {
+      MoroLogger.ENTRY_POOL.push(entry);
+    }
+  }
+
+  // String builder methods
+  private static resetStringBuilder(): void {
+    MoroLogger.stringBuilder.length = 0;
+    MoroLogger.stringBuilderIndex = 0;
+  }
+
+  private static appendToBuilder(str: string): void {
+    MoroLogger.stringBuilder[MoroLogger.stringBuilderIndex++] = str;
+  }
+
+  private static buildString(): string {
+    const result = MoroLogger.stringBuilder.join('');
+    MoroLogger.resetStringBuilder();
+    return result;
+  }
+
   debug(message: string, context?: string, metadata?: Record<string, any>): void {
     this.log('debug', message, context, metadata);
   }
@@ -158,8 +259,47 @@ export class MoroLogger implements Logger {
   }
 
   getHistory(count?: number): LogEntry[] {
-    const entries = [...this.history];
-    return count ? entries.slice(-count) : entries;
+    if (this.historySize === 0) return [];
+
+    if (this.historySize < (this.options.maxEntries || 1000)) {
+      // History not full yet, return all entries
+      const entries = this.history.slice(0, this.historySize);
+      return count ? entries.slice(-count) : entries;
+    } else {
+      // History is full, use circular buffer logic
+      const entries: LogEntry[] = [];
+      const maxEntries = this.options.maxEntries || 1000;
+
+      for (let i = 0; i < maxEntries; i++) {
+        const index = (this.historyIndex + i) % maxEntries;
+        if (this.history[index]) {
+          entries.push(this.history[index]);
+        }
+      }
+
+      return count ? entries.slice(-count) : entries;
+    }
+  }
+
+  // Cached timestamp formatting to avoid repeated string operations
+  private getCachedTimestamp(timestamp: Date): string {
+    const now = timestamp.getTime();
+    if (now - this.lastTimestamp > this.timestampCacheInterval) {
+      this.lastTimestamp = now;
+      this.cachedTimestamp = timestamp.toISOString().replace('T', ' ').slice(0, 19);
+    }
+    return this.cachedTimestamp;
+  }
+
+  // Cached timestamp generation (updates once per second)
+  private getFastCachedTimestamp(): string {
+    const now = Date.now();
+    if (now - this.lastTimestamp > 1000) {
+      // Update every second
+      this.lastTimestamp = now;
+      this.cachedTimestamp = new Date(now).toISOString().slice(0, 19).replace('T', ' ');
+    }
+    return this.cachedTimestamp;
   }
 
   getMetrics(): LogMetrics {
@@ -189,62 +329,165 @@ export class MoroLogger implements Logger {
     };
   }
 
+  // Optimized logging method
   private log(
     level: LogLevel,
     message: string,
     context?: string,
     metadata?: Record<string, any>
   ): void {
-    // Check level threshold - use parent level if available (for child loggers)
+    // Quick level check - use parent level if available (for child loggers)
     const effectiveLevel = this.parent ? this.parent.level : this.level;
     if (MoroLogger.LEVELS[level] < MoroLogger.LEVELS[effectiveLevel as LogLevel]) {
       return;
     }
 
-    // Create log entry
-    const entry: LogEntry = {
-      timestamp: new Date(),
-      level,
-      message,
-      context: this.contextPrefix
-        ? context
-          ? `${this.contextPrefix}:${context}`
-          : this.contextPrefix
-        : context,
-      metadata: { ...this.contextMetadata, ...metadata },
-      performance: this.options.enablePerformance
-        ? {
-            memory: process.memoryUsage().heapUsed / 1024 / 1024,
-          }
-        : undefined,
-    };
+    // Absolute minimal path for simple logs - pure speed
+    if (!metadata && !context && !this.contextPrefix && !this.contextMetadata) {
+      this.writeSimpleLog(level, message);
+      return;
+    }
+
+    // Minimal path for logs with context but no metadata
+    if (!metadata && !this.contextMetadata) {
+      this.writeSimpleLog(level, message, context);
+      return;
+    }
+
+    // Path for complex logs
+    if (metadata && Object.keys(metadata).length > 0) {
+      this.complexLog(level, message, context, metadata);
+      return;
+    }
+
+    // Full logging path for complex logs
+    this.fullLog(level, message, context, metadata);
+  }
+
+  // Full logging with all features
+  private fullLog(
+    level: LogLevel,
+    message: string,
+    context?: string,
+    metadata?: Record<string, any>
+  ): void {
+    // Use object pooling for LogEntry (Pino's technique)
+    const entry = MoroLogger.getPooledEntry();
+    const now = Date.now();
 
-    // Apply filters
-    for (const filter of this.filters.values()) {
-      if (!filter.filter(entry)) {
-        return;
+    entry.timestamp = new Date(now);
+    entry.level = level;
+    entry.message = message;
+    entry.context = this.contextPrefix
+      ? context
+        ? `${this.contextPrefix}:${context}`
+        : this.contextPrefix
+      : context;
+    entry.metadata = this.createMetadata(metadata);
+    entry.performance = this.options.enablePerformance ? this.getPerformanceData(now) : undefined;
+
+    // Apply filters with early return optimization
+    if (this.filters.size > 0) {
+      for (const filter of this.filters.values()) {
+        if (!filter.filter(entry)) {
+          MoroLogger.returnPooledEntry(entry);
+          return;
+        }
       }
     }
 
     // Update metrics
     this.updateMetrics(entry);
 
-    // Store in history
-    this.history.push(entry);
-    if (this.history.length > (this.options.maxEntries || 1000)) {
-      this.history.shift();
+    // Store in history with circular buffer optimization
+    this.addToHistory(entry);
+
+    // Write to outputs with batched processing
+    this.writeToOutputs(entry, level);
+
+    // Return entry to pool
+    MoroLogger.returnPooledEntry(entry);
+  }
+
+  // Absolute minimal logging - pure speed, no overhead
+  private complexLog(
+    level: LogLevel,
+    message: string,
+    context?: string,
+    metadata?: Record<string, any>
+  ): void {
+    // Use object pooling for LogEntry (Pino's technique)
+    const entry = MoroLogger.getPooledEntry();
+    const now = Date.now();
+
+    entry.timestamp = new Date(now);
+    entry.level = level;
+    entry.message = message;
+    entry.context = this.contextPrefix
+      ? context
+        ? `${this.contextPrefix}:${context}`
+        : this.contextPrefix
+      : context;
+    entry.metadata = this.createMetadata(metadata);
+    entry.performance = this.options.enablePerformance ? this.getPerformanceData(now) : undefined;
+
+    // Write to outputs with batched processing
+    this.writeToOutputs(entry, level);
+
+    // Return entry to pool
+    MoroLogger.returnPooledEntry(entry);
+  }
+
+  // Simple log writer with colors for minimal overhead cases
+  private writeSimpleLog(level: LogLevel, message: string, context?: string): void {
+    const colors = this.options.enableColors !== false;
+    const levelReset = colors ? MoroLogger.RESET : '';
+
+    MoroLogger.resetStringBuilder();
+
+    // Timestamp with caching optimization
+    if (this.options.enableTimestamp !== false) {
+      const timestamp = this.getFastCachedTimestamp();
+      if (colors) {
+        MoroLogger.appendToBuilder(MoroLogger.COLORS.timestamp);
+        MoroLogger.appendToBuilder(timestamp);
+        MoroLogger.appendToBuilder(levelReset);
+      } else {
+        MoroLogger.appendToBuilder(timestamp);
+      }
+      MoroLogger.appendToBuilder(' ');
     }
 
-    // Write to outputs
-    for (const output of this.outputs.values()) {
-      if (!output.level || MoroLogger.LEVELS[level] >= MoroLogger.LEVELS[output.level]) {
-        try {
-          output.write(entry);
-        } catch (error) {
-          console.error('Logger output error:', error);
-        }
+    // Level with pre-allocated strings
+    const levelStr = MoroLogger.LEVEL_STRINGS[level];
+    if (colors) {
+      MoroLogger.appendToBuilder(MoroLogger.COLORS[level]);
+      MoroLogger.appendToBuilder(MoroLogger.BOLD);
+      MoroLogger.appendToBuilder(levelStr);
+      MoroLogger.appendToBuilder(levelReset);
+    } else {
+      MoroLogger.appendToBuilder(levelStr);
+    }
+
+    // Context
+    if (context && this.options.enableContext !== false) {
+      MoroLogger.appendToBuilder(' ');
+      if (colors) {
+        MoroLogger.appendToBuilder(MoroLogger.COLORS.context);
+        MoroLogger.appendToBuilder(`[${context}]`);
+        MoroLogger.appendToBuilder(levelReset);
+      } else {
+        MoroLogger.appendToBuilder(`[${context}]`);
       }
     }
+
+    // Message
+    MoroLogger.appendToBuilder(' ');
+    MoroLogger.appendToBuilder(message);
+
+    // Output main log line with high-performance method
+    const finalMessage = MoroLogger.buildString();
+    this.output(`${finalMessage}\n`, level);
   }
 
   private updateMetrics(entry: LogEntry): void {
@@ -257,18 +500,87 @@ export class MoroLogger implements Logger {
     }
   }
 
+  // Optimized metadata creation to avoid unnecessary object spreading
+  private createMetadata(metadata?: Record<string, any>): Record<string, any> {
+    if (!metadata && !this.contextMetadata) {
+      return {};
+    }
+    if (!metadata) {
+      return { ...this.contextMetadata };
+    }
+    if (!this.contextMetadata) {
+      return { ...metadata };
+    }
+    return { ...this.contextMetadata, ...metadata };
+  }
+
+  // Optimized performance data with caching
+  private getPerformanceData(now: number): { memory: number } | undefined {
+    if (now - this.lastMemoryCheck > this.memoryCheckInterval) {
+      this.lastMemoryCheck = now;
+      this.metrics.memoryUsage = process.memoryUsage().heapUsed / 1024 / 1024;
+    }
+    return { memory: this.metrics.memoryUsage };
+  }
+
+  // Circular buffer implementation for history (O(1) instead of O(n))
+  private addToHistory(entry: LogEntry): void {
+    const maxEntries = this.options.maxEntries || 1000;
+
+    if (this.historySize < maxEntries) {
+      this.history[this.historySize] = entry;
+      this.historySize++;
+    } else {
+      // Circular buffer: overwrite oldest entry
+      this.history[this.historyIndex] = entry;
+      this.historyIndex = (this.historyIndex + 1) % maxEntries;
+    }
+  }
+
+  // Optimized output writing with batching
+  private writeToOutputs(entry: LogEntry, level: LogLevel): void {
+    if (this.outputs.size === 0) return;
+
+    let successCount = 0;
+    const errors: Array<{ outputName: string; error: any }> = [];
+
+    for (const output of this.outputs.values()) {
+      if (!output.level || MoroLogger.LEVELS[level] >= MoroLogger.LEVELS[output.level]) {
+        try {
+          output.write(entry);
+          successCount++;
+        } catch (error) {
+          errors.push({ outputName: output.name, error });
+          this.handleOutputError(output.name, error);
+        }
+      }
+    }
+
+    // If all outputs fail, use emergency console
+    if (successCount === 0 && this.outputs.size > 0) {
+      this.emergencyConsoleWrite(entry);
+    }
+
+    // Log output errors (but avoid infinite loops)
+    if (errors.length > 0 && level !== 'error') {
+      this.error(`Logger output errors: ${errors.length} failed`, 'MoroLogger', {
+        errors: errors.map(e => e.outputName),
+      });
+    }
+  }
+
   private writeToConsole(entry: LogEntry): void {
     const format = this.options.format || 'pretty';
 
     if (format === 'json') {
-      console.log(JSON.stringify(entry));
+      this.output(`${this.safeStringify(entry)}\n`, entry.level);
       return;
     }
 
     if (format === 'compact') {
       const level = entry.level.toUpperCase().padEnd(5);
       const context = entry.context ? `[${entry.context}] ` : '';
-      console.log(`${level} ${context}${entry.message}`);
+      this.output(`${level} ${context}${entry.message}\n`, entry.level);
       return;
     }
 
@@ -278,30 +590,49 @@ export class MoroLogger implements Logger {
 
   private writePrettyLog(entry: LogEntry): void {
     const colors = this.options.enableColors !== false;
-    const parts: string[] = [];
+    const levelReset = colors ? MoroLogger.RESET : '';
 
-    // Timestamp
+    MoroLogger.resetStringBuilder();
+
+    // Timestamp with caching optimization
     if (this.options.enableTimestamp !== false) {
-      const timestamp = entry.timestamp.toISOString().replace('T', ' ').slice(0, 19);
-      parts.push(
-        colors ? `${MoroLogger.COLORS.timestamp}${timestamp}${MoroLogger.RESET}` : timestamp
-      );
+      const timestamp = this.getCachedTimestamp(entry.timestamp);
+      if (colors) {
+        MoroLogger.appendToBuilder(MoroLogger.COLORS.timestamp);
+        MoroLogger.appendToBuilder(timestamp);
+        MoroLogger.appendToBuilder(levelReset);
+      } else {
+        MoroLogger.appendToBuilder(timestamp);
+      }
+      MoroLogger.appendToBuilder(' ');
     }
 
-    // Level with color (remove icons)
-    const levelColor = colors ? MoroLogger.COLORS[entry.level] : '';
-    const levelReset = colors ? MoroLogger.RESET : '';
-    const levelText = entry.level.toUpperCase();
-    parts.push(`${levelColor}${MoroLogger.BOLD}${levelText}${levelReset}`);
+    // Level with pre-allocated strings
+    const levelStr = MoroLogger.LEVEL_STRINGS[entry.level];
+    if (colors) {
+      MoroLogger.appendToBuilder(MoroLogger.COLORS[entry.level]);
+      MoroLogger.appendToBuilder(MoroLogger.BOLD);
+      MoroLogger.appendToBuilder(levelStr);
+      MoroLogger.appendToBuilder(levelReset);
+    } else {
+      MoroLogger.appendToBuilder(levelStr);
+    }
 
     // Context
     if (entry.context && this.options.enableContext !== false) {
-      const contextColor = colors ? MoroLogger.COLORS.context : '';
-      parts.push(`${contextColor}[${entry.context}]${levelReset}`);
+      MoroLogger.appendToBuilder(' ');
+      if (colors) {
+        MoroLogger.appendToBuilder(MoroLogger.COLORS.context);
+        MoroLogger.appendToBuilder(`[${entry.context}]`);
+        MoroLogger.appendToBuilder(levelReset);
+      } else {
+        MoroLogger.appendToBuilder(`[${entry.context}]`);
+      }
     }
 
     // Message
-    parts.push(entry.message);
+    MoroLogger.appendToBuilder(' ');
+    MoroLogger.appendToBuilder(entry.message);
 
     // Performance info
     if (entry.performance && this.options.enablePerformance !== false) {
@@ -316,32 +647,273 @@ export class MoroLogger implements Logger {
       }
 
       if (perfParts.length > 0) {
-        parts.push(`${perfColor}(${perfParts.join(', ')})${levelReset}`);
+        MoroLogger.appendToBuilder(' ');
+        if (colors) {
+          MoroLogger.appendToBuilder(perfColor);
+          MoroLogger.appendToBuilder(`(${perfParts.join(', ')})`);
+          MoroLogger.appendToBuilder(levelReset);
+        } else {
+          MoroLogger.appendToBuilder(`(${perfParts.join(', ')})`);
+        }
       }
     }
 
-    // Metadata
+    // Metadata with optimized JSON stringify
     if (
       entry.metadata &&
       Object.keys(entry.metadata).length > 0 &&
       this.options.enableMetadata !== false
     ) {
       const metaColor = colors ? MoroLogger.COLORS.metadata : '';
-      const cleanMetadata = { ...entry.metadata };
-      delete cleanMetadata.stack; // Handle stack separately
+      const cleanMetadata = this.cleanMetadata(entry.metadata);
 
       if (Object.keys(cleanMetadata).length > 0) {
-        parts.push(`${metaColor}${JSON.stringify(cleanMetadata)}${levelReset}`);
+        MoroLogger.appendToBuilder(' ');
+        if (colors) {
+          MoroLogger.appendToBuilder(metaColor);
+          MoroLogger.appendToBuilder(this.safeStringify(cleanMetadata));
+          MoroLogger.appendToBuilder(levelReset);
+        } else {
+          MoroLogger.appendToBuilder(this.safeStringify(cleanMetadata));
+        }
       }
     }
 
-    // Output main log line
-    console.log(parts.join(' '));
+    // Output main log line with high-performance method
+    const finalMessage = MoroLogger.buildString();
+    this.output(`${finalMessage}\n`, entry.level);
 
     // Stack trace for errors
     if (entry.metadata?.stack && (entry.level === 'error' || entry.level === 'fatal')) {
       const stackColor = colors ? MoroLogger.COLORS.error : '';
-      console.log(`${stackColor}${entry.metadata.stack}${levelReset}`);
+      this.output(`${stackColor}${entry.metadata.stack}${levelReset}\n`, entry.level);
+    }
+  }
+
+  // Optimized metadata cleaning to avoid unnecessary object operations
+  private cleanMetadata(metadata: Record<string, any>): Record<string, any> {
+    const clean: Record<string, any> = {};
+    for (const [key, value] of Object.entries(metadata)) {
+      if (key !== 'stack') {
+        clean[key] = value;
+      }
+    }
+    return clean;
+  }
+
+  // High-performance output with buffering
+  private output(message: string, level: LogLevel = 'info'): void {
+    // Prevent memory exhaustion
+    if (
+      this.outputBuffer.length >= this.bufferOverflowThreshold &&
+      !this.emergencyFlushInProgress
+    ) {
+      this.emergencyFlushInProgress = true;
+      this.forceFlushBuffer();
+      this.emergencyFlushInProgress = false;
+    }
+
+    this.outputBuffer.push(message);
+    this.bufferSize++;
+
+    // Immediate flush for critical levels or full buffer
+    if (level === 'fatal' || level === 'error' || this.bufferSize >= this.maxBufferSize) {
+      this.flushBuffer();
+    } else {
+      this.scheduleFlush();
+    }
+  }
+
+  private scheduleFlush(): void {
+    if (this.flushTimeout) {
+      return; // Already scheduled
+    }
+
+    this.flushTimeout = setTimeout(() => {
+      this.flushBuffer();
+    }, this.flushInterval);
+  }
+
+  private flushBuffer(): void {
+    if (this.outputBuffer.length === 0) {
+      return;
+    }
+
+    // Group messages by stream type
+    const stdoutMessages: string[] = [];
+    const stderrMessages: string[] = [];
+
+    for (const message of this.outputBuffer) {
+      // Determine stream based on message content or level
+      if (message.includes('ERROR') || message.includes('FATAL')) {
+        stderrMessages.push(message);
+      } else {
+        stdoutMessages.push(message);
+      }
+    }
+
+    // Write to appropriate streams with error handling
+    try {
+      if (stdoutMessages.length > 0 && process.stdout.writable) {
+        process.stdout.write(stdoutMessages.join(''));
+      }
+      if (stderrMessages.length > 0 && process.stderr.writable) {
+        process.stderr.write(stderrMessages.join(''));
+      }
+    } catch {
+      // Fallback to console if streams fail
+      try {
+        // eslint-disable-next-line no-console
+        console.log(this.outputBuffer.join(''));
+      } catch {
+        // If even console.log fails, just ignore
+      }
+    }
+
+    // Clear buffer
+    this.outputBuffer.length = 0;
+    this.bufferSize = 0;
+
+    // Clear timeout
+    if (this.flushTimeout) {
+      clearTimeout(this.flushTimeout);
+      this.flushTimeout = null;
+    }
+  }
+
+  // Emergency flush for buffer overflow protection
+  private forceFlushBuffer(): void {
+    if (this.outputBuffer.length === 0) return;
+
+    try {
+      const message = this.outputBuffer.join('');
+      process.stdout.write(message);
+    } catch (error) {
+      // Emergency fallback - write individual messages
+      for (const msg of this.outputBuffer) {
+        try {
+          process.stdout.write(msg);
+        } catch {
+          // If even this fails, give up on this batch
+          break;
+        }
+      }
+    } finally {
+      this.outputBuffer.length = 0;
+      this.bufferSize = 0;
+    }
+  }
+
+  // Safe stringify with circular reference detection
+  private safeStringify(obj: any, maxDepth = 3): string {
+    const seen = new WeakSet();
+
+    const stringify = (value: any, depth: number): any => {
+      if (depth > maxDepth) return '[Max Depth Reached]';
+      if (value === null || typeof value !== 'object') return value;
+      if (seen.has(value)) return '[Circular Reference]';
+
+      seen.add(value);
+
+      if (Array.isArray(value)) {
+        return value.map(item => stringify(item, depth + 1));
+      }
+
+      const result: any = {};
+      for (const [key, val] of Object.entries(value)) {
+        if (typeof val !== 'function') {
+          // Skip functions
+          result[key] = stringify(val, depth + 1);
+        }
+      }
+      return result;
+    };
+
+    try {
+      return JSON.stringify(stringify(obj, 0));
+    } catch (error) {
+      return '[Stringify Error]';
+    }
+  }
+
+  // Configuration validation
+  private validateOptions(options: LoggerOptions): LoggerOptions {
+    const validated = { ...options };
+
+    // Validate log level
+    const validLevels = ['debug', 'info', 'warn', 'error', 'fatal'];
+    if (validated.level && !validLevels.includes(validated.level)) {
+      console.warn(`[MoroLogger] Invalid log level: ${validated.level}, defaulting to 'info'`);
+      validated.level = 'info';
+    }
+
+    // Validate max entries
+    if (validated.maxEntries !== undefined) {
+      if (validated.maxEntries < 1 || validated.maxEntries > 100000) {
+        console.warn(
+          `[MoroLogger] Invalid maxEntries: ${validated.maxEntries}, defaulting to 1000`
+        );
+        validated.maxEntries = 1000;
+      }
+    }
+
+    // Validate buffer size
+    if (validated.maxBufferSize !== undefined) {
+      if (validated.maxBufferSize < 10 || validated.maxBufferSize > 10000) {
+        console.warn(
+          `[MoroLogger] Invalid maxBufferSize: ${validated.maxBufferSize}, defaulting to 1000`
+        );
+        validated.maxBufferSize = 1000;
+      }
+    }
+
+    return validated;
+  }
+
+  // Error handling methods
+  private handleOutputError(outputName: string, error: any): void {
+    // Could implement output retry logic, circuit breaker, etc.
+    // For now, just track the error
+    if (!this.metrics.outputErrors) {
+      this.metrics.outputErrors = {};
+    }
+    this.metrics.outputErrors[outputName] = (this.metrics.outputErrors[outputName] || 0) + 1;
+  }
+
+  private emergencyConsoleWrite(entry: LogEntry): void {
+    const message = `${entry.timestamp.toISOString()} ${entry.level.toUpperCase()} ${entry.message}`;
+    try {
+      if (entry.level === 'error' || entry.level === 'fatal') {
+        process.stderr.write(`[EMERGENCY] ${message}\n`);
+      } else {
+        process.stdout.write(`[EMERGENCY] ${message}\n`);
+      }
+    } catch {
+      // If even emergency write fails, there's nothing more we can do
+    }
+  }
+
+  // Force flush streams (useful for shutdown)
+  public flush(): void {
+    // Clear any pending flush timeout
+    if (this.flushTimeout) {
+      clearTimeout(this.flushTimeout);
+      this.flushTimeout = null;
+    }
+
+    // Flush any remaining buffer
+    this.flushBuffer();
+
+    try {
+      // Force flush streams without ending them
+      if (process.stdout.writable) {
+        process.stdout.write(''); // Force flush without ending
+      }
+      if (process.stderr.writable) {
+        process.stderr.write(''); // Force flush without ending
+      }
+    } catch {
+      // Ignore flush errors
     }
   }
 }
@@ -397,3 +969,18 @@ export function applyLoggingConfiguration(
 export const createFrameworkLogger = (context: string) => {
   return logger.child('Moro', { framework: 'moro', context });
 };
+
+// Graceful shutdown handler to flush any pending logs
+process.on('SIGINT', () => {
+  logger.flush();
+  process.exit(0);
+});
+
+process.on('SIGTERM', () => {
+  logger.flush();
+  process.exit(0);
+});
+
+process.on('beforeExit', () => {
+  logger.flush();
+});