@mks2508/better-logger 0.0.2-alpha.2 → 0.8.1-alpha.1

package/demo.html

@@ -6,8 +6,15 @@
     <title>Better Logger - Professional Console Logging</title>
     <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>📊</text></svg>">
     
-    <!-- Import Better Logger from NPM CDN -->
-    <script type="module" src="https://unpkg.com/@mks2508/better-logger@latest/dist/index.js"></script>
+    <!-- Import Better Logger from jsDelivr CDN with local fallback -->
+    <script type="module">
+        try {
+            await import('https://cdn.jsdelivr.net/npm/@mks2508/better-logger@latest/dist/index.js');
+        } catch (e) {
+            console.log('Using local fallback');
+            await import('./dist/index.js');
+        }
+    </script>
     
     <style>
         * {

package/dist/Logger.d.ts

@@ -0,0 +1,176 @@
+/**
+ * @fileoverview Refactored Advanced Logger with modular architecture
+ * @version 2.0.0
+ */
+import type { Verbosity, ThemeVariant, BannerType, LoggerConfig, ILogHandler, StyleOptions } from './types/index.js';
+import { ExportLogHandler } from './handlers/index.js';
+/**
+ * Main Logger class implementing state-of-the-art logging capabilities
+ */
+export declare class Logger {
+    private config;
+    private scopedPrefix?;
+    private handlers;
+    private timers;
+    private groupDepth;
+    private exportHandler?;
+    private cliProcessor?;
+    /**
+     * Creates a new Logger instance
+     */
+    constructor(config?: Partial<LoggerConfig>);
+    /**
+     * Get current configuration
+     */
+    getConfig(): LoggerConfig;
+    /**
+     * Update configuration
+     */
+    updateConfig(updates: Partial<LoggerConfig>): void;
+    /**
+     * Sets the global prefix for all log messages
+     */
+    setGlobalPrefix(prefix: string): void;
+    /**
+     * Sets the verbosity level for filtering log output
+     */
+    setVerbosity(level: Verbosity): void;
+    /**
+     * Sets the logger theme
+     */
+    setTheme(theme: ThemeVariant): void;
+    /**
+     * Set banner type for initialization display
+     */
+    setBannerType(bannerType: BannerType): void;
+    /**
+     * Reset logger to default configuration
+     */
+    resetConfig(): void;
+    /**
+     * Creates a scoped logger with a specific prefix
+     */
+    createScopedLogger(prefix: string): Logger;
+    /**
+     * Adds a custom log handler for extensibility
+     */
+    addHandler(handler: ILogHandler): void;
+    /**
+     * Get all registered handlers
+     */
+    getHandlers(): ILogHandler[];
+    /**
+     * Get export handler if available
+     */
+    getExportHandler(): ExportLogHandler | undefined;
+    /**
+     * Checks if a log level should be output based on current verbosity
+     */
+    private shouldLog;
+    /**
+     * Gets the effective prefix (global + scoped)
+     */
+    private getEffectivePrefix;
+    /**
+     * Core logging method that handles styling and formatting
+     */
+    private log;
+    /**
+     * Logs debug information (lowest priority)
+     */
+    debug(...args: any[]): void;
+    /**
+     * Logs informational messages
+     */
+    info(...args: any[]): void;
+    /**
+     * Logs warning messages
+     */
+    warn(...args: any[]): void;
+    /**
+     * Logs error messages
+     */
+    error(...args: any[]): void;
+    /**
+     * Logs success messages (special info level)
+     */
+    success(...args: any[]): void;
+    /**
+     * Logs trace information (detailed debugging)
+     */
+    trace(...args: any[]): void;
+    /**
+     * Logs critical errors (highest priority)
+     */
+    critical(...args: any[]): void;
+    /**
+     * Displays data in a table format
+     */
+    table(data: any, columns?: string[]): void;
+    /**
+     * Starts a collapsible group in the console
+     */
+    group(label: string, collapsed?: boolean): void;
+    /**
+     * Ends the current console group
+     */
+    groupEnd(): void;
+    /**
+     * Starts a timer with the given label
+     */
+    time(label: string): void;
+    /**
+     * Ends a timer and logs the elapsed time
+     */
+    timeEnd(label: string): void;
+    /**
+     * Display banner with specified or configured type
+     */
+    showBanner(bannerType?: BannerType): void;
+    /**
+     * Log with SVG background image
+     */
+    logWithSVG(message: string, svgContent?: string, options?: StyleOptions): void;
+    /**
+     * Log with animated background gradient
+     */
+    logAnimated(message: string, duration?: number): void;
+    /**
+     * Groups logs by a specific property using modern Object.groupBy (when available)
+     */
+    logGrouped<T>(items: T[], groupBy: (item: T) => string): void;
+    /**
+     * CLI command processor for logger configuration and export
+     */
+    cli(command: string): Promise<void>;
+}
+declare const defaultLogger: Logger;
+export default defaultLogger;
+/**
+ * Export individual methods for convenience (with proper binding)
+ */
+export declare const debug: (...args: any[]) => void;
+export declare const info: (...args: any[]) => void;
+export declare const warn: (...args: any[]) => void;
+export declare const error: (...args: any[]) => void;
+export declare const success: (...args: any[]) => void;
+export declare const trace: (...args: any[]) => void;
+export declare const critical: (...args: any[]) => void;
+export declare const table: (data: any, columns?: string[]) => void;
+export declare const group: (label: string, collapsed?: boolean) => void;
+export declare const groupEnd: () => void;
+export declare const time: (label: string) => void;
+export declare const timeEnd: (label: string) => void;
+export declare const setGlobalPrefix: (prefix: string) => void;
+export declare const createScopedLogger: (prefix: string) => Logger;
+export declare const setVerbosity: (level: Verbosity) => void;
+export declare const addHandler: (handler: ILogHandler) => void;
+export declare const setTheme: (theme: ThemeVariant) => void;
+export declare const setBannerType: (bannerType: BannerType) => void;
+export declare const showBanner: (bannerType?: BannerType) => void;
+export declare const logWithSVG: (message: string, svgContent?: string, options?: StyleOptions) => void;
+export declare const logAnimated: (message: string, duration?: number) => void;
+export declare const cli: (command: string) => Promise<void>;
+export { FileLogHandler, RemoteLogHandler, AnalyticsLogHandler, ExportLogHandler } from './handlers/index.js';
+export { StyleBuilder, StylePresets as Styles } from './styling/index.js';
+//# 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":"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"}

package/dist/Logger.js

@@ -0,0 +1,498 @@
+/**
+ * @fileoverview Refactored Advanced Logger with modular architecture
+ * @version 2.0.0
+ */
+// Utility imports
+import { parseStackTrace, formatTimestamp, createStyledOutput } from './utils/index.js';
+// Styling imports
+import { THEME_PRESETS, THEME_BANNERS, displayInitBanner, StylePresets, StyleBuilder } from './styling/index.js';
+// Handler imports
+import { ExportLogHandler } from './handlers/index.js';
+// CLI imports
+import { createDefaultCLI } from './cli/index.js';
+// Constants
+import { DEFAULT_CONFIG } from './constants.js';
+/**
+ * Current active theme styles
+ */
+let LEVEL_STYLES = THEME_PRESETS.default;
+/**
+ * Main Logger class implementing state-of-the-art logging capabilities
+ */
+export class Logger {
+    config;
+    scopedPrefix;
+    handlers = [];
+    timers = new Map();
+    groupDepth = 0;
+    exportHandler;
+    cliProcessor;
+    /**
+     * Creates a new Logger instance
+     */
+    constructor(config = {}) {
+        this.config = {
+            ...DEFAULT_CONFIG,
+            ...config,
+        };
+        // Initialize export handler if buffer size is specified
+        if (this.config.bufferSize) {
+            this.exportHandler = new ExportLogHandler(this.config.bufferSize);
+            this.handlers.push(this.exportHandler);
+        }
+        // Initialize CLI processor
+        this.cliProcessor = createDefaultCLI();
+    }
+    // ===== CONFIGURATION METHODS =====
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(updates) {
+        this.config = { ...this.config, ...updates };
+    }
+    /**
+     * Sets the global prefix for all log messages
+     */
+    setGlobalPrefix(prefix) {
+        this.config.globalPrefix = prefix;
+    }
+    /**
+     * Sets the verbosity level for filtering log output
+     */
+    setVerbosity(level) {
+        this.config.verbosity = level;
+    }
+    /**
+     * Sets the logger theme
+     */
+    setTheme(theme) {
+        if (theme in THEME_PRESETS) {
+            LEVEL_STYLES = THEME_PRESETS[theme];
+            this.config.theme = theme;
+            // Show theme-specific banner
+            if (theme in THEME_BANNERS) {
+                const themeBanner = THEME_BANNERS[theme];
+                console.log(`%c${themeBanner.simple}`, themeBanner.style);
+            }
+            this.success(`Theme changed to: ${theme}`);
+        }
+        else {
+            this.error(`Invalid theme: ${theme}. Available themes:`, Object.keys(THEME_PRESETS));
+        }
+    }
+    /**
+     * Set banner type for initialization display
+     */
+    setBannerType(bannerType) {
+        this.config.bannerType = bannerType;
+        this.success(`Banner type changed to: ${bannerType}`);
+    }
+    /**
+     * Reset logger to default configuration
+     */
+    resetConfig() {
+        this.config = { ...DEFAULT_CONFIG };
+        LEVEL_STYLES = THEME_PRESETS.default;
+        this.success('Logger configuration reset to defaults');
+    }
+    // ===== SCOPED LOGGER =====
+    /**
+     * Creates a scoped logger with a specific prefix
+     */
+    createScopedLogger(prefix) {
+        const scopedLogger = new Logger(this.config);
+        scopedLogger.scopedPrefix = prefix;
+        scopedLogger.handlers = [...this.handlers];
+        scopedLogger.exportHandler = this.exportHandler;
+        return scopedLogger;
+    }
+    // ===== HANDLER MANAGEMENT =====
+    /**
+     * Adds a custom log handler for extensibility
+     */
+    addHandler(handler) {
+        this.handlers.push(handler);
+    }
+    /**
+     * Get all registered handlers
+     */
+    getHandlers() {
+        return [...this.handlers];
+    }
+    /**
+     * Get export handler if available
+     */
+    getExportHandler() {
+        return this.exportHandler;
+    }
+    // ===== CORE LOGGING METHODS =====
+    /**
+     * Checks if a log level should be output based on current verbosity
+     */
+    shouldLog(level) {
+        if (this.config.verbosity === 'silent')
+            return false;
+        const levels = { debug: 0, info: 1, warn: 2, error: 3, critical: 4 };
+        return levels[level] >= levels[this.config.verbosity];
+    }
+    /**
+     * Gets the effective prefix (global + scoped)
+     */
+    getEffectivePrefix() {
+        const parts = [this.config.globalPrefix, this.scopedPrefix].filter(Boolean);
+        return parts.length > 0 ? parts.join(':') : undefined;
+    }
+    /**
+     * Core logging method that handles styling and formatting
+     */
+    log(level, ...args) {
+        if (!this.shouldLog(level))
+            return;
+        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;
+        const prefix = this.getEffectivePrefix();
+        const message = args.length > 0 ? String(args[0]) : '';
+        const additionalArgs = args.slice(1);
+        // Create styled output
+        const [format, ...styles] = createStyledOutput(level, LEVEL_STYLES, prefix, message, stackInfo);
+        // Add group indentation
+        const groupIndent = '  '.repeat(this.groupDepth);
+        const finalFormat = groupIndent + format;
+        // Output to console
+        if (additionalArgs.length > 0) {
+            console.log(finalFormat, ...styles, ...additionalArgs);
+        }
+        else {
+            console.log(finalFormat, ...styles);
+        }
+        // Update export handler group info
+        if (this.exportHandler) {
+            this.exportHandler.setGroupInfo(this.groupDepth);
+        }
+        // Call custom handlers
+        const metadata = {
+            timestamp: formatTimestamp(),
+            level,
+            prefix,
+            stackInfo: stackInfo ? stackInfo : undefined,
+        };
+        this.handlers.forEach(handler => {
+            try {
+                handler.handle(level, message, args, metadata);
+            }
+            catch (error) {
+                console.error('Log handler failed:', error);
+            }
+        });
+    }
+    /**
+     * Logs debug information (lowest priority)
+     */
+    debug(...args) {
+        this.log('debug', ...args);
+    }
+    /**
+     * Logs informational messages
+     */
+    info(...args) {
+        this.log('info', ...args);
+    }
+    /**
+     * Logs warning messages
+     */
+    warn(...args) {
+        this.log('warn', ...args);
+    }
+    /**
+     * Logs error messages
+     */
+    error(...args) {
+        this.log('error', ...args);
+    }
+    /**
+     * Logs success messages (special info level)
+     */
+    success(...args) {
+        if (!this.shouldLog('info'))
+            return;
+        const stackInfo = this.config.enableStackTrace ? parseStackTrace() : null;
+        const prefix = this.getEffectivePrefix();
+        const message = args.length > 0 ? String(args[0]) : '';
+        const additionalArgs = args.slice(1);
+        // Handle success as special case - use info level with success styling
+        const [format, ...styles] = createStyledOutput('info', LEVEL_STYLES, prefix, message, stackInfo);
+        // Override with success styling
+        const successStyle = LEVEL_STYLES.success;
+        let emoji = '✅';
+        let label = 'SUCCESS';
+        if (successStyle) {
+            if (successStyle.emoji) {
+                emoji = successStyle.emoji;
+            }
+            if (successStyle.label) {
+                label = successStyle.label;
+            }
+        }
+        const successFormat = format.replace(/ℹ️ INFO/, `${emoji} ${label}`);
+        const groupIndent = '  '.repeat(this.groupDepth);
+        const finalFormat = groupIndent + successFormat;
+        if (additionalArgs.length > 0) {
+            console.log(finalFormat, ...styles, ...additionalArgs);
+        }
+        else {
+            console.log(finalFormat, ...styles);
+        }
+        // Call handlers
+        const metadata = {
+            timestamp: formatTimestamp(),
+            level: 'info',
+            prefix,
+            stackInfo: stackInfo ? stackInfo : undefined,
+        };
+        this.handlers.forEach(handler => {
+            try {
+                handler.handle('info', message, args, metadata);
+            }
+            catch (error) {
+                console.error('Log handler failed:', error);
+            }
+        });
+    }
+    /**
+     * Logs trace information (detailed debugging)
+     */
+    trace(...args) {
+        this.log('debug', ...args);
+        if (this.shouldLog('debug')) {
+            console.trace(...args);
+        }
+    }
+    /**
+     * Logs critical errors (highest priority)
+     */
+    critical(...args) {
+        this.log('critical', ...args);
+    }
+    // ===== ADVANCED LOGGING FEATURES =====
+    /**
+     * Displays data in a table format
+     */
+    table(data, columns) {
+        if (!this.shouldLog('info'))
+            return;
+        const prefix = this.getEffectivePrefix();
+        const tableStyle = StylePresets.accent().build();
+        const format = `%c📊 TABLE${prefix ? ` [${prefix}]` : ''}`;
+        console.log(format, tableStyle);
+        if (columns) {
+            console.table(data, columns);
+        }
+        else {
+            console.table(data);
+        }
+    }
+    /**
+     * Starts a collapsible group in the console
+     */
+    group(label, collapsed = false) {
+        const groupStyle = new StyleBuilder()
+            .bg('linear-gradient(135deg, #e3f2fd 0%, #bbdefb 100%)')
+            .color('#1565c0')
+            .border('1px solid #90caf9')
+            .padding('4px 12px')
+            .rounded('6px')
+            .bold()
+            .build();
+        const format = `%c📁 ${label}`;
+        if (collapsed) {
+            console.groupCollapsed(format, groupStyle);
+        }
+        else {
+            console.group(format, groupStyle);
+        }
+        this.groupDepth++;
+    }
+    /**
+     * Ends the current console group
+     */
+    groupEnd() {
+        if (this.groupDepth > 0) {
+            console.groupEnd();
+            this.groupDepth--;
+        }
+    }
+    // ===== PERFORMANCE TIMING =====
+    /**
+     * Starts a timer with the given label
+     */
+    time(label) {
+        const timer = {
+            label,
+            startTime: performance.now(),
+        };
+        this.timers.set(label, timer);
+        const timerStyle = StylePresets.warning().build();
+        console.log(`%c⏱️ Timer started: ${label}`, timerStyle);
+    }
+    /**
+     * Ends a timer and logs the elapsed time
+     */
+    timeEnd(label) {
+        const timer = this.timers.get(label);
+        if (!timer) {
+            this.warn(`Timer '${label}' does not exist`);
+            return;
+        }
+        const elapsed = performance.now() - timer.startTime;
+        this.timers.delete(label);
+        const timerStyle = StylePresets.success().build();
+        console.log(`%c⏱️ Timer ended: ${label} - ${elapsed.toFixed(2)}ms`, timerStyle);
+    }
+    // ===== ADVANCED VISUAL FEATURES =====
+    /**
+     * Display banner with specified or configured type
+     */
+    showBanner(bannerType) {
+        const effectiveBannerType = bannerType ? bannerType : this.config.bannerType;
+        displayInitBanner(effectiveBannerType);
+    }
+    /**
+     * Log with SVG background image
+     */
+    logWithSVG(message, svgContent, options = {}) {
+        const { width = 300, height = 60, padding = '30px 150px' } = options;
+        let svgDataUri = '';
+        if (svgContent) {
+            const encodedSVG = encodeURIComponent(svgContent);
+            svgDataUri = `data:image/svg+xml,${encodedSVG}`;
+        }
+        else {
+            const defaultSVG = `<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 ${width} ${height}'><defs><linearGradient id='grad' x1='0%' y1='0%' x2='100%' y2='0%'><stop offset='0%' style='stop-color:%23667eea'/><stop offset='100%' style='stop-color:%23764ba2'/></linearGradient></defs><rect width='100%' height='100%' fill='url(%23grad)' rx='4'/><text x='${width / 2}' y='${height / 2 + 5}' text-anchor='middle' fill='white' font-family='monospace' font-size='14' font-weight='bold'>${message}</text></svg>`;
+            svgDataUri = `data:image/svg+xml,${encodeURIComponent(defaultSVG)}`;
+        }
+        const svgStyle = new StyleBuilder()
+            .bg(`url("${svgDataUri}") no-repeat center center`)
+            .padding(padding)
+            .color('transparent')
+            .rounded('4px')
+            .build();
+        console.log(`%c${message}`, svgStyle);
+    }
+    /**
+     * Log with animated background gradient
+     */
+    logAnimated(message, duration = 3) {
+        // Inject CSS animation if not already present
+        if (!document.getElementById('logger-animations')) {
+            const style = document.createElement('style');
+            style.id = 'logger-animations';
+            style.textContent = `
+                @keyframes loggerGradient {
+                    0% { background-position: 0% 50%; }
+                    50% { background-position: 100% 50%; }
+                    100% { background-position: 0% 50%; }
+                }
+            `;
+            document.head.appendChild(style);
+        }
+        const animatedStyle = new StyleBuilder()
+            .bg('linear-gradient(-45deg, #667eea, #764ba2, #667eea, #764ba2)')
+            .css('background-size', '400% 400%')
+            .color('#ffffff')
+            .padding('12px 20px')
+            .rounded('8px')
+            .bold()
+            .font('Monaco, Consolas, monospace')
+            .animation(`loggerGradient ${duration}s ease infinite`)
+            .display('inline-block')
+            .build();
+        console.log(`%c${message}`, animatedStyle);
+    }
+    /**
+     * Groups logs by a specific property using modern Object.groupBy (when available)
+     */
+    logGrouped(items, groupBy) {
+        try {
+            // Use Object.groupBy if available (ES2024), otherwise fallback to reduce
+            let grouped;
+            if (Object.groupBy) {
+                grouped = Object.groupBy(items, groupBy);
+            }
+            else {
+                grouped = items.reduce((acc, item) => {
+                    const key = groupBy(item);
+                    if (!acc[key]) {
+                        acc[key] = [];
+                    }
+                    acc[key].push(item);
+                    return acc;
+                }, {});
+            }
+            Object.entries(grouped).forEach(([group, groupItems]) => {
+                this.group(`Group: ${group}`);
+                this.table(groupItems);
+                this.groupEnd();
+            });
+        }
+        catch {
+            this.info('Grouped data:', items);
+        }
+    }
+    // ===== CLI SYSTEM =====
+    /**
+     * CLI command processor for logger configuration and export
+     */
+    async cli(command) {
+        if (!this.cliProcessor) {
+            this.error('CLI processor not initialized');
+            return;
+        }
+        await this.cliProcessor.processCommand(command, this);
+    }
+}
+// Create and export the singleton instance
+const defaultLogger = new Logger({
+    verbosity: 'info',
+    enableColors: true,
+    enableTimestamps: true,
+    enableStackTrace: true,
+    bufferSize: 1000, // Enable export functionality by default
+});
+// Display initialization banner
+displayInitBanner();
+// Export the singleton instance as default
+export default defaultLogger;
+/**
+ * Export individual methods for convenience (with proper binding)
+ */
+export const debug = (...args) => defaultLogger.debug(...args);
+export const info = (...args) => defaultLogger.info(...args);
+export const warn = (...args) => defaultLogger.warn(...args);
+export const error = (...args) => defaultLogger.error(...args);
+export const success = (...args) => defaultLogger.success(...args);
+export const trace = (...args) => defaultLogger.trace(...args);
+export const critical = (...args) => defaultLogger.critical(...args);
+export const table = (data, columns) => defaultLogger.table(data, columns);
+export const group = (label, collapsed) => defaultLogger.group(label, collapsed);
+export const groupEnd = () => defaultLogger.groupEnd();
+export const time = (label) => defaultLogger.time(label);
+export const timeEnd = (label) => defaultLogger.timeEnd(label);
+export const setGlobalPrefix = (prefix) => defaultLogger.setGlobalPrefix(prefix);
+export const createScopedLogger = (prefix) => defaultLogger.createScopedLogger(prefix);
+export const setVerbosity = (level) => defaultLogger.setVerbosity(level);
+export const addHandler = (handler) => defaultLogger.addHandler(handler);
+export const setTheme = (theme) => defaultLogger.setTheme(theme);
+export const setBannerType = (bannerType) => defaultLogger.setBannerType(bannerType);
+export const showBanner = (bannerType) => defaultLogger.showBanner(bannerType);
+export const logWithSVG = (message, svgContent, options) => defaultLogger.logWithSVG(message, svgContent, options);
+export const logAnimated = (message, duration) => defaultLogger.logAnimated(message, duration);
+export const cli = (command) => defaultLogger.cli(command);
+// Re-export handlers and utilities for backward compatibility
+export { FileLogHandler, RemoteLogHandler, AnalyticsLogHandler, ExportLogHandler } from './handlers/index.js';
+export { StyleBuilder, StylePresets as Styles } from './styling/index.js'; // Test change to trigger workflow
+// Test permissions fix