@wgtechlabs/log-engine 1.0.2 → 1.0.3

package/dist/formatter.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Log message formatter that provides colorized console output with timestamps
+ * Handles ANSI color codes and structured log message formatting
+ */
+import { LogLevel } from './types';
+/**
+ * LogFormatter class responsible for formatting log messages with colors and timestamps
+ * Creates readable, colored console output with ISO timestamps and local time
+ */
+export declare class LogFormatter {
+    private static readonly colors;
+    /**
+     * Formats a log message with timestamp, level indicator, and appropriate coloring
+     * Creates a structured log entry: [ISO_TIMESTAMP][LOCAL_TIME][LEVEL]: message
+     * @param level - The log level to format for
+     * @param message - The message content to format
+     * @returns Formatted string with ANSI colors and timestamps
+     */
+    static format(level: LogLevel, message: string): string;
+    /**
+     * Converts LogLevel enum to human-readable string
+     * @param level - The LogLevel to convert
+     * @returns String representation of the log level
+     */
+    private static getLevelName;
+    /**
+     * Maps LogLevel to appropriate ANSI color code
+     * Colors help quickly identify message severity in console output
+     * @param level - The LogLevel to get color for
+     * @returns ANSI color escape sequence
+     */
+    private static getLevelColor;
+}
+//# sourceMappingURL=formatter.d.ts.map

package/dist/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../src/formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAEnC;;;GAGG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAU5B;IAEF;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAoBvD;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAW3B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;CAU/B"}

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Main entry point for the Log Engine library
+ * Provides a simple, configurable logging interface with environment-based auto-configuration
+ */
+import { LoggerConfig } from './types';
+/**
+ * Main LogEngine API - provides all logging functionality with a clean interface
+ * Auto-configured based on NODE_ENV, but can be reconfigured at runtime
+ */
+export declare const LogEngine: {
+    /**
+     * Configure the logger with custom settings
+     * @param config - Partial configuration object containing level and/or environment
+     * @example
+     * ```typescript
+     * LogEngine.configure({ level: LogLevel.DEBUG });
+     * LogEngine.configure({ level: LogLevel.WARN, environment: 'staging' });
+     * ```
+     */
+    configure: (config: Partial<LoggerConfig>) => void;
+    /**
+     * Log a debug message (lowest priority)
+     * Only shown when log level is DEBUG or lower
+     * Useful for detailed diagnostic information during development
+     * @param message - The debug message to log
+     * @example
+     * ```typescript
+     * LogEngine.debug('User authentication flow started');
+     * LogEngine.debug(`Processing ${items.length} items`);
+     * ```
+     */
+    debug: (message: string) => void;
+    /**
+     * Log an informational message
+     * General information about application flow and state
+     * Shown when log level is INFO or lower
+     * @param message - The info message to log
+     * @example
+     * ```typescript
+     * LogEngine.info('Application started successfully');
+     * LogEngine.info('User logged in: john@example.com');
+     * ```
+     */
+    info: (message: string) => void;
+    /**
+     * Log a warning message
+     * Indicates potential issues that don't prevent operation
+     * Shown when log level is WARN or lower
+     * @param message - The warning message to log
+     * @example
+     * ```typescript
+     * LogEngine.warn('API rate limit approaching');
+     * LogEngine.warn('Deprecated function called');
+     * ```
+     */
+    warn: (message: string) => void;
+    /**
+     * Log an error message (highest priority)
+     * Indicates serious problems that need attention
+     * Always shown unless log level is SILENT
+     * @param message - The error message to log
+     * @example
+     * ```typescript
+     * LogEngine.error('Database connection failed');
+     * LogEngine.error('Authentication token expired');
+     * ```
+     */
+    error: (message: string) => void;
+};
+export { LogLevel, LoggerConfig } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAY,YAAY,EAAE,MAAM,SAAS,CAAC;AA8BjD;;;GAGG;AACH,eAAO,MAAM,SAAS;IAClB;;;;;;;;OAQG;wBACiB,OAAO,CAAC,YAAY,CAAC;IAEzC;;;;;;;;;;OAUG;qBACc,MAAM;IAEvB;;;;;;;;;;OAUG;oBACa,MAAM;IAEtB;;;;;;;;;;OAUG;oBACa,MAAM;IAEtB;;;;;;;;;;OAUG;qBACc,MAAM;CAC1B,CAAC;AAEF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Core Logger class that handles log message output with configurable levels
+ * Supports DEBUG, INFO, WARN, ERROR levels with intelligent filtering
+ * Uses colorized console output with timestamps for better readability
+ */
+import { LoggerConfig } from './types';
+/**
+ * Logger class responsible for managing log output and configuration
+ * Provides level-based filtering and formatted console output
+ */
+export declare class Logger {
+    private config;
+    /**
+     * Updates logger configuration with new settings
+     * Merges provided config with existing settings (partial update)
+     * @param config - Partial configuration object to apply
+     */
+    configure(config: Partial<LoggerConfig>): void;
+    /**
+     * Determines if a message should be logged based on current log level
+     * Messages are shown only if their level >= configured minimum level
+     * @param level - The log level of the message to check
+     * @returns true if message should be logged, false otherwise
+     */
+    private shouldLog;
+    /**
+     * Log a debug message with DEBUG level formatting
+     * Uses console.log for output with purple/magenta coloring
+     * @param message - The debug message to log
+     */
+    debug(message: string): void;
+    /**
+     * Log an informational message with INFO level formatting
+     * Uses console.log for output with blue coloring
+     * @param message - The info message to log
+     */
+    info(message: string): void;
+    /**
+     * Log a warning message with WARN level formatting
+     * Uses console.warn for output with yellow coloring
+     * @param message - The warning message to log
+     */
+    warn(message: string): void;
+    /**
+     * Log an error message with ERROR level formatting
+     * Uses console.error for output with red coloring
+     * @param message - The error message to log
+     */
+    error(message: string): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAY,YAAY,EAAE,MAAM,SAAS,CAAC;AAGjD;;;GAGG;AACH,qBAAa,MAAM;IAEf,OAAO,CAAC,MAAM,CAEZ;IAEF;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAI9C;;;;;OAKG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO5B;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO3B;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO3B;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;CAM/B"}

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Type definitions for the Log Engine library
+ * Provides strongly-typed interfaces for configuration and log levels
+ */
+/**
+ * Log levels in order of priority (lowest to highest)
+ * Higher numeric values represent higher priority levels
+ * When a level is set, only messages at that level or higher are shown
+ */
+export declare enum LogLevel {
+    /** Detailed diagnostic information, typically only of interest during development */
+    DEBUG = 0,
+    /** General information about application flow and state */
+    INFO = 1,
+    /** Potentially harmful situations that don't prevent operation */
+    WARN = 2,
+    /** Error events that might still allow the application to continue */
+    ERROR = 3,
+    /** Completely disable all logging output */
+    SILENT = 4
+}
+/**
+ * Represents a single log entry with timestamp, level, and message
+ * Used internally for structured logging operations
+ */
+export interface LogEntry {
+    /** When the log entry was created */
+    timestamp: Date;
+    /** The severity level of this log entry */
+    level: LogLevel;
+    /** The actual log message content */
+    message: string;
+}
+/**
+ * Configuration options for the logger
+ * All properties are optional to allow partial updates
+ */
+export interface LoggerConfig {
+    /** Minimum log level to display (filters out lower priority messages) */
+    level: LogLevel;
+    /** Optional environment identifier for context (e.g., 'production', 'staging') */
+    environment?: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AACH,oBAAY,QAAQ;IAChB,qFAAqF;IACrF,KAAK,IAAI;IACT,2DAA2D;IAC3D,IAAI,IAAI;IACR,kEAAkE;IAClE,IAAI,IAAI;IACR,sEAAsE;IACtE,KAAK,IAAI;IACT,4CAA4C;IAC5C,MAAM,IAAI;CACb;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,qCAAqC;IACrC,SAAS,EAAE,IAAI,CAAC;IAChB,2CAA2C;IAC3C,KAAK,EAAE,QAAQ,CAAC;IAChB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IACzB,yEAAyE;IACzE,KAAK,EAAE,QAAQ,CAAC;IAChB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wgtechlabs/log-engine",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "A lightweight and efficient logging utility designed specifically for bot applications running on Node.js.",
   "keywords": [
     "logging",