@mks2508/better-logger 0.0.1

package/src/cli/help.ts

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Help system for Advanced Logger CLI
+ */
+
+import type { ICommand } from './CommandProcessor.js';
+import type { Logger } from '../Logger.js';
+import { StyleBuilder } from '../styling/index.js';
+
+/**
+ * Help command - show comprehensive CLI help
+ */
+export class HelpCommand implements ICommand {
+    name = 'help';
+    description = 'Show CLI help and available commands';
+    usage = '/help [command]';
+
+    execute(_args: string, logger: Logger): void {
+        const helpStyle = new StyleBuilder()
+            .bg('linear-gradient(135deg, #f8f9fa 0%, #e9ecef 100%)')
+            .color('#495057')
+            .padding('15px 20px')
+            .rounded('8px')
+            .border('1px solid #dee2e6')
+            .font('Monaco, Consolas, monospace')
+            .size('13px')
+            .build();
+
+        const helpText = `
+╭─────────────── ADVANCED LOGGER CLI COMMANDS ─────────────────╮
+│                                                             │
+│  CONFIGURATION                                              │
+│  /config            Show current configuration              │
+│  /config {json}     Apply JSON configuration                │
+│  /config key=val    Apply key-value configuration           │
+│  /themes            Show available themes                   │
+│  /banners           Show available banner types             │
+│  /banner [type]     Change/show banner type                 │
+│  /status            Show logger status & buffer stats       │
+│  /demo              Show feature demonstration              │
+│  /reset             Reset to default configuration          │
+│                                                             │
+│  EXPORT & CLIPBOARD                                         │
+│  /export <format>   Export logs (json|csv|md|plain|html)    │
+│  /copy <format>     Copy logs to clipboard                  │
+│  /buffer-size N     Set log buffer size                     │
+│  /buffer-info       Show buffer statistics                  │
+│  /clear-buffer      Clear stored logs                       │
+│                                                             │
+│  EXPORT FILTERS (for export/copy commands)                 │
+│  --level error,warn     Filter by log levels                │
+│  --since 2h             Logs from last 2 hours              │
+│  --until 1h             Logs until 1 hour ago               │
+│  --prefix API,DB        Filter by prefixes                  │
+│  --exclude-prefix INT   Exclude prefixes                    │
+│  --last 50             Last 50 logs only                    │
+│  --first 25            First 25 logs only                   │
+│  --search "error"      Search in log messages               │
+│  --with-stack          Only logs with stack traces          │
+│  --errors-only         Only error + critical logs           │
+│  --group-by level      Group by level/prefix/hour           │
+│                                                             │
+│  EXPORT OPTIONS                                             │
+│  --minimal             Minimal output format                │
+│  --compact             Remove extra whitespace              │
+│  --styled              Include styling (HTML format)        │
+│                                                             │
+├──────────────────── CONFIGURATION OPTIONS ─────────────────┤
+│                                                             │
+│  theme: default | dark | light | neon | minimal | cyberpunk│
+│  bannerType: simple | ascii | unicode | svg | animated     │
+│  verbosity: debug | info | warn | error | critical | silent│
+│  enableColors: true | false                                 │
+│  enableTimestamps: true | false                             │
+│  enableStackTrace: true | false                             │
+│  globalPrefix: "string"                                     │
+│  bufferSize: number (50-10000)                             │
+│                                                             │
+├──────────────────────── EXAMPLES ──────────────────────────┤
+│                                                             │
+│  Basic Configuration:                                       │
+│  /config {"theme":"dark","verbosity":"debug"}               │
+│  /config theme=neon,bufferSize=2000                        │
+│  /banner animated       Change to animated banner          │
+│                                                             │
+│  Export Examples:                                           │
+│  /export json --level=error,warn --last=25                 │
+│  /export csv --since=2h --prefix=API                       │
+│  /export markdown --group-by=level --errors-only           │
+│  /export html --styled --since=1h                          │
+│                                                             │
+│  Clipboard Examples:                                        │
+│  /copy plain --minimal --last=10                           │
+│  /copy json --search="authentication" --compact            │
+│  /copy csv --since=30m --exclude-prefix=DEBUG              │
+│                                                             │
+│  Buffer Management:                                         │
+│  /buffer-size 5000      Increase buffer to 5000 logs       │
+│  /buffer-info           Show detailed buffer statistics     │
+│  /clear-buffer          Clear all stored logs               │
+│                                                             │
+│  Time Formats:                                              │
+│  --since=2h            2 hours ago                          │
+│  --since=30m           30 minutes ago                       │
+│  --since=1d            1 day ago                            │
+│  --since="2024-01-01T10:00:00Z"  Specific ISO date         │
+│                                                             │
+╰─────────────────────────────────────────────────────────────╯`;
+
+        console.log(`%c${helpText}`, helpStyle);
+
+        // Show quick tips
+        logger.group('💡 Quick Tips');
+        const tips = [
+            'Use /demo to see all logger features in action',
+            'Logs are automatically stored in a circular buffer for export',
+            'Export formats: JSON (structured), CSV (Excel), Markdown (readable), Plain (simple), HTML (styled)',
+            'Time filters support relative (2h, 30m) and absolute (ISO) formats',
+            'Combine multiple filters: /export json --level=error --since=1h --search="auth"',
+            'Use /copy for quick clipboard access instead of /export'
+        ];
+        
+        tips.forEach(tip => {
+            logger.info(`• ${tip}`);
+        });
+        logger.groupEnd();
+    }
+}

package/src/cli/index.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview CLI system exports for Advanced Logger
+ */
+
+// Core CLI system
+export { CommandProcessor, type ICommand } from './CommandProcessor.js';
+import { CommandProcessor } from './CommandProcessor.js';
+
+// Commands
+export { ConfigCommand } from './commands/ConfigCommand.js';
+export { ThemesCommand, BannersCommand, BannerCommand } from './commands/ThemeCommand.js';
+export { StatusCommand, ResetCommand, DemoCommand } from './commands/StatusCommand.js';
+export { 
+    ExportCommand, 
+    CopyCommand, 
+    BufferSizeCommand, 
+    ClearBufferCommand, 
+    BufferInfoCommand 
+} from './commands/ExportCommand.js';
+
+// Help system
+export { HelpCommand } from './help.js';
+
+// Import all commands
+import { HelpCommand } from './help.js';
+import { ConfigCommand } from './commands/ConfigCommand.js';
+import { ThemesCommand, BannersCommand, BannerCommand } from './commands/ThemeCommand.js';
+import { StatusCommand, ResetCommand, DemoCommand } from './commands/StatusCommand.js';
+import { 
+    ExportCommand, 
+    CopyCommand, 
+    BufferSizeCommand, 
+    ClearBufferCommand, 
+    BufferInfoCommand 
+} from './commands/ExportCommand.js';
+
+/**
+ * Create and configure default CLI processor
+ */
+export function createDefaultCLI(): CommandProcessor {
+    const processor = new CommandProcessor();
+    
+    // Register all default commands
+    processor.registerCommand(new HelpCommand());
+    processor.registerCommand(new ConfigCommand());
+    processor.registerCommand(new ThemesCommand());
+    processor.registerCommand(new BannersCommand());
+    processor.registerCommand(new BannerCommand());
+    processor.registerCommand(new StatusCommand());
+    processor.registerCommand(new ResetCommand());
+    processor.registerCommand(new DemoCommand());
+    processor.registerCommand(new ExportCommand());
+    processor.registerCommand(new CopyCommand());
+    processor.registerCommand(new BufferSizeCommand());
+    processor.registerCommand(new ClearBufferCommand());
+    processor.registerCommand(new BufferInfoCommand());
+    
+    return processor;
+}

package/src/constants.ts

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Global constants for Advanced Logger
+ */
+
+import type { LogLevel } from './types/index.js';
+
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    verbosity: 'info' as const,
+    enableColors: true,
+    enableTimestamps: true,
+    enableStackTrace: true,
+    theme: 'default' as const,
+    bannerType: 'simple' as const,
+    bufferSize: 1000,
+} as const;
+
+/**
+ * Maximum allowed buffer sizes for performance
+ */
+export const BUFFER_LIMITS = {
+    MIN_SIZE: 50,
+    DEFAULT_SIZE: 1000,
+    MAX_SIZE: 10000,
+} as const;
+
+/**
+ * Export format definitions with extensions
+ */
+export const EXPORT_FORMATS = {
+    json: { extension: '.json', mimeType: 'application/json' },
+    csv: { extension: '.csv', mimeType: 'text/csv' },
+    markdown: { extension: '.md', mimeType: 'text/markdown' },
+    plain: { extension: '.txt', mimeType: 'text/plain' },
+    html: { extension: '.html', mimeType: 'text/html' },
+} as const;
+
+/**
+ * CLI command definitions
+ */
+export const CLI_COMMANDS = {
+    config: 'config',
+    help: 'help',
+    themes: 'themes',
+    banners: 'banners',
+    banner: 'banner',
+    status: 'status',
+    reset: 'reset',
+    demo: 'demo',
+    export: 'export',
+    copy: 'copy',
+    'buffer-size': 'buffer-size',
+    'clear-buffer': 'clear-buffer',
+    'buffer-info': 'buffer-info',
+} as const;
+
+/**
+ * Time parsing constants for relative time filters
+ */
+export const TIME_UNITS = {
+    ms: 1,
+    s: 1000,
+    m: 60 * 1000,
+    h: 60 * 60 * 1000,
+    d: 24 * 60 * 60 * 1000,
+} as const;
+
+/**
+ * Default styling values
+ */
+export const STYLE_DEFAULTS = {
+    FONT_FAMILY: 'Monaco, Consolas, monospace',
+    FONT_SIZE: '12px',
+    BORDER_RADIUS: '4px',
+    PADDING: '4px 8px',
+} as const;
+
+/**
+ * Level priority mapping for filtering
+ */
+export const LEVEL_PRIORITIES: Record<LogLevel, number> = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    critical: 4,
+} as const;

package/src/example.ts

@@ -0,0 +1,88 @@
+/**
+ * @fileoverview Example usage of the advanced Logger system
+ */
+
+import Logger, {
+    debug,
+    info,
+    warn,
+    error,
+    success,
+    createScopedLogger,
+    setGlobalPrefix,
+    setVerbosity,
+    FileLogHandler,
+    AnalyticsLogHandler
+} from './Logger.js';
+import { StyleBuilder } from './styling/index.js';
+
+// Example usage demonstration
+function demonstrateLogger() {
+    // Set up global configuration
+    setGlobalPrefix('APP');
+    setVerbosity('debug');
+
+    // Add custom handlers
+    Logger.addHandler(new FileLogHandler('app.log'));
+    Logger.addHandler(new AnalyticsLogHandler());
+
+    // Create scoped loggers
+    const apiLogger = createScopedLogger('API');
+    const dbLogger = createScopedLogger('DATABASE');
+
+    // Basic logging
+    info('🚀 Application started successfully');
+    debug('Debug information', { config: { mode: 'development' } });
+    warn('⚠️ This is a warning message');
+    error('❌ An error occurred', new Error('Sample error'));
+    success('✅ User authentication successful');
+
+    // Scoped logging
+    apiLogger.info('Fetching user data', { endpoint: '/api/users' });
+    dbLogger.debug('Database query executed', { query: 'SELECT * FROM users' });
+
+    // Advanced features
+    Logger.group('User Session Details');
+    apiLogger.table([
+        { id: 1, name: 'John Doe', email: 'john@example.com' },
+        { id: 2, name: 'Jane Smith', email: 'jane@example.com' }
+    ]);
+    Logger.groupEnd();
+
+    // Performance timing
+    Logger.time('data-processing');
+    // Simulate some processing
+    setTimeout(() => {
+        Logger.timeEnd('data-processing');
+    }, 100);
+
+    // Critical error with stack trace
+    Logger.critical('🔥 Critical system failure detected');
+
+    // Custom styled logging
+    console.log(
+        '%cCustom Styled Message',
+        new StyleBuilder()
+            .bg('linear-gradient(45deg, #ff6b6b, #feca57)')
+            .color('#ffffff')
+            .padding('10px 15px')
+            .rounded('8px')
+            .shadow('0 4px 8px rgba(0,0,0,0.2)')
+            .bold()
+            .build()
+    );
+
+    // Grouped logging with data
+    const users = [
+        { name: 'Alice', role: 'admin' },
+        { name: 'Bob', role: 'user' },
+        { name: 'Charlie', role: 'admin' }
+    ];
+
+    Logger.logGrouped(users, (user) => user.role);
+}
+
+// Run the demonstration
+demonstrateLogger();
+
+export { demonstrateLogger };

package/src/handlers/AnalyticsLogHandler.ts

@@ -0,0 +1,22 @@
+/**
+ * @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 
+            });
+        }
+    }
+}