@mks2508/better-logger 5.0.0 → 5.0.2

package/src/example.ts

@@ -1,210 +0,0 @@
-/**
- * @fileoverview Comprehensive examples and demonstrations of Better Logger
- */
-
-import logger, {
-    Logger,
-    debug,
-    info,
-    warn,
-    error,
-    success,
-    critical,
-    scope,
-    setGlobalPrefix,
-    setVerbosity,
-    setTheme,
-    setBannerType,
-    showBanner,
-    logWithSVG,
-    logAnimated,
-    cli,
-    createStyle,
-    stylePresets,
-    FileLogHandler,
-    AnalyticsLogHandler
-} from './index.js';
-
-// Visual features demonstrations
-export function demonstrateBanners() {
-    info('🎨 Banner System Demo');
-    
-    showBanner('simple');
-    setTimeout(() => showBanner('ascii'), 1000);
-    setTimeout(() => showBanner('unicode'), 2000);
-    setTimeout(() => showBanner('svg'), 3000);
-    setTimeout(() => showBanner('animated'), 4000);
-}
-
-export function demonstrateThemes() {
-    info('🌈 Theme System Demo');
-    
-    const themes = ['default', 'dark', 'neon', 'cyberpunk', 'retro'];
-    themes.forEach((theme, index) => {
-        setTimeout(() => {
-            setTheme(theme as any);
-            info(`Theme switched to: ${theme}`);
-        }, index * 1500);
-    });
-}
-
-export function demonstrateSVG() {
-    const logoSVG = `<svg width="100" height="50" viewBox="0 0 100 50">
-        <rect width="100" height="50" fill="#667eea"/>
-        <text x="50" y="30" font-family="Arial" font-size="12" fill="white" text-anchor="middle">LOGO</text>
-    </svg>`;
-    
-    logWithSVG('🖼️ Custom SVG Background', logoSVG, {
-        width: 300,
-        height: 60,
-        padding: '20px 100px'
-    });
-}
-
-export function demonstrateAnimations() {
-    logAnimated('✨ Loading animation...', 3);
-    setTimeout(() => logAnimated('🚀 Animation complete!', 2), 3500);
-}
-
-export function demonstrateCLI() {
-    info('💻 CLI Commands Demo');
-    
-    const commands = [
-        '/config theme:neon',
-        '/banner ascii',
-        '/verbose debug',
-        '/prefix DEMO'
-    ];
-    
-    commands.forEach((cmd, index) => {
-        setTimeout(() => {
-            info(`Executing: ${cmd}`);
-            cli(cmd);
-        }, index * 1500);
-    });
-}
-
-export function demonstrateExports() {
-    info('📤 Export functionality would be demonstrated here');
-    info('Note: Export features require ExportLogger from /exports module');
-    
-    const sampleData = [
-        { timestamp: new Date().toISOString(), level: 'info', message: 'Sample log 1' },
-        { timestamp: new Date().toISOString(), level: 'error', message: 'Sample log 2' },
-        { timestamp: new Date().toISOString(), level: 'warn', message: 'Sample log 3' }
-    ];
-    
-    logger.table(sampleData, ['timestamp', 'level', 'message']);
-}
-
-// Core features demonstrations
-export function demonstrateBasicLogging() {
-    setGlobalPrefix('DEMO');
-    setVerbosity('debug');
-
-    debug('🐞 Debug information', { config: { mode: 'development' } });
-    info('ℹ️ Application started successfully');
-    warn('⚠️ This is a warning message');
-    error('❌ An error occurred', new Error('Sample error'));
-    success('✅ User authentication successful');
-    critical('🔥 Critical system failure detected');
-}
-
-export function demonstrateTable() {
-    const userData = [
-        { id: 1, name: 'John Doe', email: 'john@example.com', status: 'active' },
-        { id: 2, name: 'Jane Smith', email: 'jane@example.com', status: 'inactive' },
-        { id: 3, name: 'Bob Johnson', email: 'bob@example.com', status: 'active' }
-    ];
-    
-    logger.table(userData);
-    logger.table(userData, ['name', 'email']);
-}
-
-export function demonstrateGrouping() {
-    logger.group('🔍 User Analysis');
-    info('Analyzing user data...');
-    
-    logger.group('📊 Statistics', false);
-    info('Total users: 150');
-    info('Active users: 120');
-    info('New this month: 25');
-    logger.groupEnd();
-    
-    logger.group('🎯 Top Users');
-    success('Premium user: Alice Johnson');
-    success('Most active: Bob Smith'); 
-    logger.groupEnd();
-    
-    logger.groupEnd();
-}
-
-export function demonstrateTiming() {
-    logger.time('api-request');
-    
-    info('🌐 Making API request...');
-    
-    setTimeout(() => {
-        logger.timeEnd('api-request');
-        success('✅ API request completed');
-    }, Math.random() * 2000 + 500);
-}
-
-export function demonstrateScopedLogger() {
-    const apiLogger = scope('API');
-    const dbLogger = scope('DB');
-    const authLogger = scope('AUTH');
-    
-    apiLogger.info('🌐 Fetching user data', { endpoint: '/api/users' });
-    dbLogger.debug('💾 Database query executed', { query: 'SELECT * FROM users LIMIT 10' });
-    authLogger.success('🔐 User authentication successful', { userId: 12345 });
-    
-    apiLogger.warn('⚠️ Rate limit approaching', { remaining: 10 });
-    dbLogger.error('❌ Connection timeout', { timeout: '5s' });
-}
-
-export function demonstrateTrace() {
-    function deepFunction() {
-        function deeperFunction() {
-            logger.trace('🔍 Deep trace call with full stack');
-        }
-        deeperFunction();
-    }
-    deepFunction();
-}
-
-export function demonstrateCustomStyles() {
-    const customStyle = createStyle()
-        .bg('linear-gradient(135deg, #ff6b6b 0%, #feca57 100%)')
-        .color('white')
-        .padding('12px 20px')
-        .rounded('10px')
-        .shadow('0 4px 15px rgba(0,0,0,0.3)')
-        .bold()
-        .build();
-    
-    console.log('%c🎨 Custom Styled Message', customStyle);
-    console.log('%c✅ Success Style', stylePresets.success);
-    console.log('%c❌ Error Style', stylePresets.error);
-    console.log('%c⚠️ Warning Style', stylePresets.warning);
-}
-
-// Comprehensive demonstration
-export function demonstrateAllFeatures() {
-    info('🌟 Starting comprehensive Better Logger demonstration...');
-    
-    setTimeout(() => demonstrateBanners(), 500);
-    setTimeout(() => demonstrateBasicLogging(), 6000);
-    setTimeout(() => demonstrateCustomStyles(), 8000);
-    setTimeout(() => demonstrateGrouping(), 10000);
-    setTimeout(() => demonstrateTiming(), 13000);
-    setTimeout(() => demonstrateScopedLogger(), 16000);
-    setTimeout(() => demonstrateThemes(), 18000);
-    
-    setTimeout(() => {
-        success('🎉 Demonstration complete! Check your console for all the styled outputs.');
-    }, 25000);
-}
-
-// Auto-run basic demo on import
-demonstrateBasicLogging();

package/src/exports-module.ts

@@ -1,311 +0,0 @@
-/**
- * @fileoverview Exports Module - Export and remote logging capabilities
- * @version 0.0.1
- * 
- * This module provides export functionality for logs including CSV, JSON, XML formats
- * and remote logging capabilities for sending logs to external services.
- */
-
-// Core logger and types
-import { Logger } from './Logger.js';
-import type {
-    LogLevel,
-    Verbosity,
-    ILogHandler
-} from './types/index.js';
-
-// Export handlers
-import {
-    ExportLogHandler,
-    RemoteLogHandler
-} from './handlers/index.js';
-
-/**
- * Logger with export and remote capabilities
- * 
- * @example
- * ```typescript
- * import { ExportLogger } from '@mks2508/better-logger/exports';
- * 
- * const logger = new ExportLogger({ bufferSize: 1000 });
- * 
- * // Log some data
- * logger.info('User logged in', { userId: 123 });
- * logger.error('Failed to process', { error: 'timeout' });
- * 
- * // Export logs
- * const csvData = await logger.exportLogs('csv');
- * const jsonData = await logger.exportLogs('json');
- * 
- * // Setup remote logging
- * logger.addRemoteHandler('https://api.myapp.com/logs', 'api-key');
- * ```
- */
-export class ExportLogger extends Logger {
-    private exportLogHandler?: ExportLogHandler;
-    private remoteHandlers: RemoteLogHandler[] = [];
-
-    constructor(config: { bufferSize?: number } & any = {}) {
-        super(config);
-        
-        // Initialize export handler if buffer size specified
-        if (config.bufferSize) {
-            this.exportLogHandler = new ExportLogHandler(config.bufferSize);
-            this.addHandler(this.exportLogHandler);
-        }
-    }
-
-    /**
-     * Export logs in specified format
-     * 
-     * @param format - Export format (csv, json, xml)
-     * @param options - Export options
-     * @returns Promise resolving to exported data
-     * 
-     * @example
-     * ```typescript
-     * const csvData = await logger.exportLogs('csv');
-     * const jsonData = await logger.exportLogs('json', { 
-     *   filter: { level: 'error' },
-     *   limit: 100 
-     * });
-     * ```
-     */
-    async exportLogs(
-        format: 'csv' | 'json' | 'xml', 
-        options?: {
-            filter?: { level?: LogLevel; from?: Date; to?: Date };
-            limit?: number;
-        }
-    ): Promise<string> {
-        if (!this.exportLogHandler) {
-            throw new Error('Export handler not initialized. Set bufferSize in constructor.');
-        }
-
-        // Temporary implementation - ExportLogHandler needs these methods
-        return JSON.stringify([]);
-    }
-
-    /**
-     * Get current log buffer
-     * 
-     * @returns Array of log entries
-     * 
-     * @example
-     * ```typescript
-     * const logs = logger.getLogs();
-     * console.log(`Buffered ${logs.length} log entries`);
-     * ```
-     */
-    getLogs(): any[] {
-        if (!this.exportLogHandler) {
-            return [];
-        }
-        
-        // Temporary implementation - ExportLogHandler needs these methods
-        return [];
-    }
-
-    /**
-     * Clear the log buffer
-     * 
-     * @example
-     * ```typescript
-     * logger.clearLogs();
-     * ```
-     */
-    clearLogs(): void {
-        if (this.exportLogHandler) {
-            // Temporary implementation - ExportLogHandler needs these methods
-        }
-    }
-
-    /**
-     * Get log statistics
-     * 
-     * @returns Statistics object with counts by level
-     * 
-     * @example
-     * ```typescript
-     * const stats = logger.getLogStats();
-     * console.log(`Errors: ${stats.error}, Warnings: ${stats.warn}`);
-     * ```
-     */
-    getLogStats(): Record<string, number> {
-        if (!this.exportLogHandler) {
-            return {};
-        }
-
-        // Temporary implementation - ExportLogHandler needs these methods
-        return {};
-    }
-
-    /**
-     * Add remote logging handler
-     * 
-     * @param endpoint - Remote endpoint URL
-     * @param apiKey - Optional API key for authentication
-     * 
-     * @example
-     * ```typescript
-     * logger.addRemoteHandler('https://logs.myservice.com/api', 'secret-key');
-     * ```
-     */
-    addRemoteHandler(endpoint: string, apiKey?: string): void {
-        const remoteHandler = new RemoteLogHandler(endpoint, apiKey);
-        this.remoteHandlers.push(remoteHandler);
-        this.addHandler(remoteHandler);
-    }
-
-    /**
-     * Remove all remote handlers
-     * 
-     * @example
-     * ```typescript
-     * logger.clearRemoteHandlers();
-     * ```
-     */
-    clearRemoteHandlers(): void {
-        // Remove from handlers array
-        const allHandlers = this.getHandlers();
-        this.remoteHandlers.forEach(remoteHandler => {
-            const index = allHandlers.indexOf(remoteHandler);
-            if (index > -1) {
-                allHandlers.splice(index, 1);
-            }
-        });
-        
-        this.remoteHandlers = [];
-    }
-
-    /**
-     * Flush all remote handlers (force send pending logs)
-     * 
-     * @example
-     * ```typescript
-     * await logger.flushRemoteHandlers();
-     * ```
-     */
-    async flushRemoteHandlers(): Promise<void> {
-        const flushPromises = this.remoteHandlers.map(handler => 
-            Promise.resolve() // RemoteLogHandler needs flush method
-        );
-        
-        await Promise.all(flushPromises);
-    }
-}
-
-// Create singleton instance with export capabilities
-const exportLogger = new ExportLogger({ bufferSize: 1000 });
-
-/**
- * Export management utilities
- */
-export const exportUtils = {
-    /**
-     * Export current logs as CSV
-     */
-    async exportCSV(options?: any): Promise<string> {
-        return await exportLogger.exportLogs('csv', options);
-    },
-
-    /**
-     * Export current logs as JSON
-     */
-    async exportJSON(options?: any): Promise<string> {
-        return await exportLogger.exportLogs('json', options);
-    },
-
-    /**
-     * Export current logs as XML
-     */
-    async exportXML(options?: any): Promise<string> {
-        return await exportLogger.exportLogs('xml', options);
-    },
-
-    /**
-     * Get log statistics
-     */
-    getStats(): Record<string, number> {
-        return exportLogger.getLogStats();
-    },
-
-    /**
-     * Clear all logs
-     */
-    clear(): void {
-        exportLogger.clearLogs();
-    }
-};
-
-/**
- * Remote logging utilities
- */
-export const remoteUtils = {
-    /**
-     * Add remote logging endpoint
-     */
-    addEndpoint(url: string, apiKey?: string): void {
-        exportLogger.addRemoteHandler(url, apiKey);
-    },
-
-    /**
-     * Clear all remote endpoints
-     */
-    clearEndpoints(): void {
-        exportLogger.clearRemoteHandlers();
-    },
-
-    /**
-     * Flush all remote logs
-     */
-    async flush(): Promise<void> {
-        await exportLogger.flushRemoteHandlers();
-    }
-};
-
-/**
- * Export individual logging methods with export capabilities
- */
-export const debug = (...args: any[]) => exportLogger.debug(...args);
-export const info = (...args: any[]) => exportLogger.info(...args);
-export const warn = (...args: any[]) => exportLogger.warn(...args);
-export const error = (...args: any[]) => exportLogger.error(...args);
-export const success = (...args: any[]) => exportLogger.success(...args);
-export const critical = (...args: any[]) => exportLogger.critical(...args);
-export const trace = (...args: any[]) => exportLogger.trace(...args);
-export const table = (data: any, columns?: string[]) => exportLogger.table(data, columns);
-export const group = (label: string, collapsed?: boolean) => exportLogger.group(label, collapsed);
-export const groupEnd = () => exportLogger.groupEnd();
-export const time = (label: string) => exportLogger.time(label);
-export const timeEnd = (label: string) => exportLogger.timeEnd(label);
-export const setGlobalPrefix = (prefix: string) => exportLogger.setGlobalPrefix(prefix);
-export const scope = (prefix: string) => exportLogger.scope(prefix);
-export const setVerbosity = (level: Verbosity) => exportLogger.setVerbosity(level);
-export const addHandler = (handler: ILogHandler) => exportLogger.addHandler(handler);
-
-/**
- * Export functionality
- */
-export const exportLogs = async (format: 'csv' | 'json' | 'xml', options?: any) => 
-    await exportLogger.exportLogs(format, options);
-export const getLogs = () => exportLogger.getLogs();
-export const clearLogs = () => exportLogger.clearLogs();
-export const getLogStats = () => exportLogger.getLogStats();
-
-/**
- * Remote logging functionality
- */
-export const addRemoteHandler = (endpoint: string, apiKey?: string) => 
-    exportLogger.addRemoteHandler(endpoint, apiKey);
-export const clearRemoteHandlers = () => exportLogger.clearRemoteHandlers();
-export const flushRemoteHandlers = async () => await exportLogger.flushRemoteHandlers();
-
-// Export the singleton as default
-export default exportLogger;
-
-// Re-export handlers
-export { ExportLogHandler, RemoteLogHandler } from './handlers/index.js';
-
-// Re-export types
-export type { ILogHandler } from './types/index.js';

package/src/handlers/AnalyticsLogHandler.ts

@@ -1,22 +0,0 @@
-/**
- * @fileoverview Analytics log handler for Advanced Logger
- */
-
-import type { ILogHandler, LogLevel, LogMetadata } from '../types/index.js';
-
-/**
- * Example custom handler for analytics demonstration
- */
-export class AnalyticsLogHandler implements ILogHandler {
-    handle(level: LogLevel, message: string, _args: any[], metadata: LogMetadata): void {
-        // In a real implementation, this could send analytics data
-        if (level === 'error' || level === 'critical') {
-            // Track errors for analytics
-            console.debug('Analytics: Error tracked', { 
-                level, 
-                message, 
-                timestamp: metadata.timestamp 
-            });
-        }
-    }
-}