@mks2508/better-logger 0.0.1

package/src/styling/themes.ts

@@ -0,0 +1,235 @@
+/**
+ * @fileoverview Theme presets for Advanced Logger
+ */
+
+import type { ThemeVariant } from '../types/index.js';
+import type { LevelStyleConfig } from '../utils/index.js';
+
+/**
+ * Theme configurations for different visual styles
+ */
+export const THEME_PRESETS: Record<ThemeVariant, Record<string, LevelStyleConfig>> = {
+    default: {
+        debug: {
+            emoji: '🐞', label: 'DEBUG',
+            background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
+            color: '#ffffff', border: '1px solid #667eea',
+            shadow: '0 2px 4px rgba(102, 126, 234, 0.3)',
+        },
+        info: {
+            emoji: 'ℹ️', label: 'INFO',
+            background: 'linear-gradient(135deg, #74b9ff 0%, #0984e3 100%)',
+            color: '#ffffff', border: '1px solid #74b9ff',
+            shadow: '0 2px 4px rgba(116, 185, 255, 0.3)',
+        },
+        warn: {
+            emoji: '⚠️', label: 'WARN',
+            background: 'linear-gradient(135deg, #fdcb6e 0%, #e17055 100%)',
+            color: '#2d3436', border: '1px solid #fdcb6e',
+            shadow: '0 2px 4px rgba(253, 203, 110, 0.3)',
+        },
+        error: {
+            emoji: '❌', label: 'ERROR',
+            background: 'linear-gradient(135deg, #e84393 0%, #d63031 100%)',
+            color: '#ffffff', border: '1px solid #e84393',
+            shadow: '0 2px 4px rgba(232, 67, 147, 0.3)',
+        },
+        success: {
+            emoji: '✅', label: 'SUCCESS',
+            background: 'linear-gradient(135deg, #00b894 0%, #00a085 100%)',
+            color: '#ffffff', border: '1px solid #00b894',
+            shadow: '0 2px 4px rgba(0, 184, 148, 0.3)',
+        },
+        critical: {
+            emoji: '🔥', label: 'CRITICAL',
+            background: 'linear-gradient(135deg, #ff3838 0%, #ff1744 100%)',
+            color: '#ffffff', border: '2px solid #ff3838',
+            shadow: '0 4px 8px rgba(255, 56, 56, 0.5)',
+        },
+    },
+    dark: {
+        debug: {
+            emoji: '🌙', label: 'DEBUG',
+            background: 'linear-gradient(135deg, #2d3748 0%, #4a5568 100%)',
+            color: '#e2e8f0', border: '1px solid #4a5568',
+            shadow: '0 2px 4px rgba(45, 55, 72, 0.8)',
+        },
+        info: {
+            emoji: '💡', label: 'INFO',
+            background: 'linear-gradient(135deg, #1a202c 0%, #2d3748 100%)',
+            color: '#90cdf4', border: '1px solid #3182ce',
+            shadow: '0 2px 4px rgba(26, 32, 44, 0.8)',
+        },
+        warn: {
+            emoji: '⚡', label: 'WARN',
+            background: 'linear-gradient(135deg, #744210 0%, #975a16 100%)',
+            color: '#faf089', border: '1px solid #d69e2e',
+            shadow: '0 2px 4px rgba(116, 66, 16, 0.8)',
+        },
+        error: {
+            emoji: '💀', label: 'ERROR',
+            background: 'linear-gradient(135deg, #742a2a 0%, #9b2c2c 100%)',
+            color: '#feb2b2', border: '1px solid #e53e3e',
+            shadow: '0 2px 4px rgba(116, 42, 42, 0.8)',
+        },
+        success: {
+            emoji: '🎯', label: 'SUCCESS',
+            background: 'linear-gradient(135deg, #276749 0%, #2f855a 100%)',
+            color: '#9ae6b4', border: '1px solid #38a169',
+            shadow: '0 2px 4px rgba(39, 103, 73, 0.8)',
+        },
+        critical: {
+            emoji: '💥', label: 'CRITICAL',
+            background: 'linear-gradient(135deg, #1a1a1a 0%, #ff0000 100%)',
+            color: '#ffffff', border: '2px solid #ff0000',
+            shadow: '0 4px 8px rgba(255, 0, 0, 0.9)',
+        },
+    },
+    neon: {
+        debug: {
+            emoji: '⚡', label: 'DEBUG',
+            background: 'linear-gradient(135deg, #0f3460 0%, #e94560 100%)',
+            color: '#00ffff', border: '1px solid #00ffff',
+            shadow: '0 0 10px rgba(0, 255, 255, 0.5)',
+        },
+        info: {
+            emoji: '🔮', label: 'INFO',
+            background: 'linear-gradient(135deg, #16213e 0%, #0f3460 100%)',
+            color: '#00ff41', border: '1px solid #00ff41',
+            shadow: '0 0 10px rgba(0, 255, 65, 0.5)',
+        },
+        warn: {
+            emoji: '⚠️', label: 'WARN',
+            background: 'linear-gradient(135deg, #533a03 0%, #e94560 100%)',
+            color: '#ffff00', border: '1px solid #ffff00',
+            shadow: '0 0 10px rgba(255, 255, 0, 0.5)',
+        },
+        error: {
+            emoji: '💥', label: 'ERROR',
+            background: 'linear-gradient(135deg, #5c0a0a 0%, #ff073a 100%)',
+            color: '#ff073a', border: '1px solid #ff073a',
+            shadow: '0 0 10px rgba(255, 7, 58, 0.8)',
+        },
+        success: {
+            emoji: '✨', label: 'SUCCESS',
+            background: 'linear-gradient(135deg, #0a5c0a 0%, #39ff14 100%)',
+            color: '#39ff14', border: '1px solid #39ff14',
+            shadow: '0 0 10px rgba(57, 255, 20, 0.8)',
+        },
+        critical: {
+            emoji: '🌟', label: 'CRITICAL',
+            background: 'linear-gradient(135deg, #000000 0%, #ff0080 100%)',
+            color: '#ff0080', border: '2px solid #ff0080',
+            shadow: '0 0 20px rgba(255, 0, 128, 1)',
+        },
+    },
+    minimal: {
+        debug: {
+            emoji: '', label: 'DEBUG',
+            background: '#f7fafc', color: '#4a5568',
+            border: '1px solid #e2e8f0', shadow: 'none',
+        },
+        info: {
+            emoji: '', label: 'INFO',
+            background: '#ebf8ff', color: '#2b6cb0',
+            border: '1px solid #bee3f8', shadow: 'none',
+        },
+        warn: {
+            emoji: '', label: 'WARN',
+            background: '#fffbf0', color: '#c05621',
+            border: '1px solid #fed7aa', shadow: 'none',
+        },
+        error: {
+            emoji: '', label: 'ERROR',
+            background: '#fef5f5', color: '#c53030',
+            border: '1px solid #fca5a5', shadow: 'none',
+        },
+        success: {
+            emoji: '', label: 'SUCCESS',
+            background: '#f0fff4', color: '#2f855a',
+            border: '1px solid #9ae6b4', shadow: 'none',
+        },
+        critical: {
+            emoji: '', label: 'CRITICAL',
+            background: '#fef5f5', color: '#e53e3e',
+            border: '2px solid #f56565', shadow: 'none',
+        },
+    },
+    // Additional theme variants can be added here
+    light: {
+        debug: {
+            emoji: '🔍', label: 'DEBUG',
+            background: 'linear-gradient(135deg, #e3f2fd 0%, #bbdefb 100%)',
+            color: '#1565c0', border: '1px solid #90caf9',
+            shadow: '0 1px 3px rgba(33, 150, 243, 0.2)',
+        },
+        info: {
+            emoji: 'ℹ️', label: 'INFO',
+            background: 'linear-gradient(135deg, #f3e5f5 0%, #e1bee7 100%)',
+            color: '#7b1fa2', border: '1px solid #ce93d8',
+            shadow: '0 1px 3px rgba(156, 39, 176, 0.2)',
+        },
+        warn: {
+            emoji: '⚠️', label: 'WARN',
+            background: 'linear-gradient(135deg, #fff8e1 0%, #ffecb3 100%)',
+            color: '#f57c00', border: '1px solid #ffcc02',
+            shadow: '0 1px 3px rgba(255, 152, 0, 0.2)',
+        },
+        error: {
+            emoji: '❌', label: 'ERROR',
+            background: 'linear-gradient(135deg, #ffebee 0%, #ffcdd2 100%)',
+            color: '#d32f2f', border: '1px solid #f44336',
+            shadow: '0 1px 3px rgba(244, 67, 54, 0.2)',
+        },
+        success: {
+            emoji: '✅', label: 'SUCCESS',
+            background: 'linear-gradient(135deg, #e8f5e8 0%, #c8e6c9 100%)',
+            color: '#388e3c', border: '1px solid #4caf50',
+            shadow: '0 1px 3px rgba(76, 175, 80, 0.2)',
+        },
+        critical: {
+            emoji: '🚨', label: 'CRITICAL',
+            background: 'linear-gradient(135deg, #fce4ec 0%, #f8bbd9 100%)',
+            color: '#c2185b', border: '2px solid #e91e63',
+            shadow: '0 2px 6px rgba(233, 30, 99, 0.3)',
+        },
+    },
+    cyberpunk: {
+        debug: {
+            emoji: '🤖', label: 'DEBUG',
+            background: 'linear-gradient(135deg, #0d1b2a 0%, #415a77 100%)',
+            color: '#00d4aa', border: '1px solid #00d4aa',
+            shadow: '0 0 15px rgba(0, 212, 170, 0.4)',
+        },
+        info: {
+            emoji: '🔗', label: 'INFO',
+            background: 'linear-gradient(135deg, #1b263b 0%, #0d1b2a 100%)',
+            color: '#00b4d8', border: '1px solid #00b4d8',
+            shadow: '0 0 15px rgba(0, 180, 216, 0.4)',
+        },
+        warn: {
+            emoji: '⚡', label: 'WARN',
+            background: 'linear-gradient(135deg, #f72585 0%, #b5179e 100%)',
+            color: '#ffff3f', border: '1px solid #ffff3f',
+            shadow: '0 0 15px rgba(255, 255, 63, 0.4)',
+        },
+        error: {
+            emoji: '💀', label: 'ERROR',
+            background: 'linear-gradient(135deg, #7209b7 0%, #480ca8 100%)',
+            color: '#ff006e', border: '1px solid #ff006e',
+            shadow: '0 0 15px rgba(255, 0, 110, 0.6)',
+        },
+        success: {
+            emoji: '⚡', label: 'SUCCESS',
+            background: 'linear-gradient(135deg, #003566 0%, #001d3d 100%)',
+            color: '#00f5ff', border: '1px solid #00f5ff',
+            shadow: '0 0 15px rgba(0, 245, 255, 0.4)',
+        },
+        critical: {
+            emoji: '💥', label: 'CRITICAL',
+            background: 'linear-gradient(135deg, #000000 0%, #ff0040 100%)',
+            color: '#ff0040', border: '2px solid #ff0040',
+            shadow: '0 0 25px rgba(255, 0, 64, 0.8)',
+        },
+    },
+};

package/src/types/core.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Core type definitions for Advanced Logger
+ */
+
+/**
+ * Supported log levels in hierarchical order (debug < info < warn < error < critical)
+ */
+export const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    critical: 4,
+} as const;
+
+/**
+ * Log level type derived from LOG_LEVELS keys
+ */
+export type LogLevel = keyof typeof LOG_LEVELS;
+
+/**
+ * Verbosity level type for filtering logs
+ */
+export type Verbosity = LogLevel | 'silent';
+
+/**
+ * Theme variants for different visual styles
+ */
+export type ThemeVariant = 'default' | 'dark' | 'light' | 'neon' | 'minimal' | 'cyberpunk';
+
+/**
+ * Banner types for different visual approaches
+ */
+export type BannerType = 'simple' | 'ascii' | 'unicode' | 'svg' | 'animated';
+
+/**
+ * Export formats for log data
+ */
+export type ExportFormat = 'json' | 'csv' | 'markdown' | 'plain' | 'html';
+
+/**
+ * Configuration interface for logger instances
+ */
+export interface LoggerConfig {
+    globalPrefix?: string;
+    verbosity: Verbosity;
+    enableColors: boolean;
+    enableTimestamps: boolean;
+    enableStackTrace: boolean;
+    theme?: ThemeVariant;
+    bannerType?: BannerType;
+    bufferSize?: number;
+}
+
+/**
+ * Parsed stack trace information
+ */
+export interface StackInfo {
+    file: string;
+    line: number;
+    column: number;
+    function?: string;
+}
+
+/**
+ * Timer entry for performance measurement
+ */
+export interface TimerEntry {
+    label: string;
+    startTime: number;
+}
+
+/**
+ * Options for styling components
+ */
+export interface StyleOptions {
+    width?: number;
+    height?: number;
+    padding?: string;
+}

package/src/types/handlers.ts

@@ -0,0 +1,95 @@
+/**
+ * @fileoverview Handler and metadata type definitions for Advanced Logger
+ */
+
+import type { LogLevel, StackInfo } from './core.js';
+
+/**
+ * Metadata associated with each log entry
+ */
+export interface LogMetadata {
+    timestamp: string;
+    level: LogLevel;
+    prefix?: string;
+    stackInfo?: StackInfo;
+    group?: string;
+}
+
+/**
+ * Interface for custom log handlers (extensibility)
+ */
+export interface ILogHandler {
+    handle(level: LogLevel, message: string, args: any[], metadata: LogMetadata): void;
+}
+
+/**
+ * Stored log entry for export functionality
+ */
+export interface LogEntry {
+    id: string;
+    timestamp: string;
+    level: LogLevel;
+    prefix?: string;
+    message: string;
+    args: any[];
+    location?: StackInfo;
+    groupInfo?: {
+        depth: number;
+        groupName?: string;
+    };
+}
+
+/**
+ * Export filter options
+ */
+export interface ExportFilters {
+    levels?: LogLevel[];
+    since?: Date | string | number; // Date, ISO string, or hours ago
+    until?: Date | string | number;
+    prefixes?: string[];
+    excludePrefixes?: string[];
+    withStackTrace?: boolean;
+    errorsOnly?: boolean;
+    last?: number;
+    first?: number;
+    search?: string;
+    groupBy?: 'level' | 'prefix' | 'hour' | 'date';
+}
+
+/**
+ * Export options for different formats
+ */
+export interface ExportOptions {
+    minimal?: boolean;
+    compact?: boolean;
+    styled?: boolean;
+    includeMetadata?: boolean;
+    groupBy?: ExportFilters['groupBy'];
+}
+
+/**
+ * Export result with metadata
+ */
+export interface ExportResult {
+    format: string;
+    data: string;
+    metadata: {
+        totalLogs: number;
+        filteredLogs: number;
+        exportedAt: string;
+        filters?: ExportFilters;
+        options?: ExportOptions;
+    };
+}
+
+/**
+ * Buffer statistics for log management
+ */
+export interface BufferStats {
+    size: number;
+    maxSize: number;
+    usage: number; // percentage
+    oldestLog?: Date;
+    newestLog?: Date;
+    levelCounts: Record<LogLevel, number>;
+}

package/src/types/index.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileoverview Type definitions exports for Advanced Logger
+ */
+
+// Core types
+export type {
+    LogLevel,
+    Verbosity,
+    ThemeVariant,
+    BannerType,
+    ExportFormat,
+    LoggerConfig,
+    StackInfo,
+    TimerEntry,
+    StyleOptions,
+} from './core.js';
+
+export { LOG_LEVELS } from './core.js';
+
+// Handler types
+export type {
+    LogMetadata,
+    ILogHandler,
+    LogEntry,
+    ExportFilters,
+    ExportOptions,
+    ExportResult,
+    BufferStats,
+} from './handlers.js';

package/src/typescript.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="32" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path fill="#007ACC" d="M0 128v128h256V0H0z"></path><path fill="#FFF" d="m56.612 128.85l-.081 10.483h33.32v94.68h23.568v-94.68h33.321v-10.28c0-5.69-.122-10.444-.284-10.566c-.122-.162-20.4-.244-44.983-.203l-44.74.122l-.121 10.443Zm149.955-10.742c6.501 1.625 11.459 4.51 16.01 9.224c2.357 2.52 5.851 7.111 6.136 8.208c.08.325-11.053 7.802-17.798 11.988c-.244.162-1.22-.894-2.317-2.52c-3.291-4.795-6.745-6.867-12.028-7.233c-7.76-.528-12.759 3.535-12.718 10.321c0 1.992.284 3.17 1.097 4.795c1.707 3.536 4.876 5.649 14.832 9.956c18.326 7.883 26.168 13.084 31.045 20.48c5.445 8.249 6.664 21.415 2.966 31.208c-4.063 10.646-14.14 17.879-28.323 20.276c-4.388.772-14.79.65-19.504-.203c-10.28-1.828-20.033-6.908-26.047-13.572c-2.357-2.6-6.949-9.387-6.664-9.874c.122-.163 1.178-.813 2.356-1.504c1.138-.65 5.446-3.129 9.509-5.485l7.355-4.267l1.544 2.276c2.154 3.29 6.867 7.801 9.712 9.305c8.167 4.307 19.383 3.698 24.909-1.26c2.357-2.153 3.332-4.388 3.332-7.68c0-2.966-.366-4.266-1.91-6.501c-1.99-2.845-6.054-5.242-17.595-10.24c-13.206-5.69-18.895-9.224-24.096-14.832c-3.007-3.25-5.852-8.452-7.03-12.8c-.975-3.617-1.22-12.678-.447-16.335c2.723-12.76 12.353-21.659 26.25-24.3c4.51-.853 14.994-.528 19.424.569Z"></path></svg>

package/src/utils/index.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Utility functions exports for Advanced Logger
+ */
+
+export { parseStackTrace } from './stackTrace.js';
+export { 
+    formatTimestamp, 
+    parseRelativeTime, 
+    parseTimeInput, 
+    formatDisplayTime 
+} from './timestamps.js';
+export { 
+    createStyledOutput, 
+    generateLogId, 
+    escapeHtml, 
+    safeStringify,
+    type LevelStyleConfig 
+} from './output.js';

package/src/utils/output.ts

@@ -0,0 +1,127 @@
+/**
+ * @fileoverview Styled output creation utilities for Advanced Logger
+ */
+
+import type { LogLevel, StackInfo } from '../types/index.js';
+import { formatTimestamp } from './timestamps.js';
+import { StyleBuilder } from '../styling/index.js';
+
+/**
+ * Style configuration for each log level
+ */
+export interface LevelStyleConfig {
+    emoji: string;
+    label: string;
+    background: string;
+    color: string;
+    border: string;
+    shadow: string;
+}
+
+
+/**
+ * Creates styled console output with multiple %c formatters
+ */
+export function createStyledOutput(
+    level: LogLevel,
+    levelStyles: Record<LogLevel | 'success', LevelStyleConfig>,
+    prefix: string | undefined,
+    message: string,
+    stackInfo: StackInfo | null
+): [string, ...string[]] {
+    const levelConfig = levelStyles[level];
+    const timestamp = formatTimestamp();
+
+    // Base styles
+    const timestampStyle = new StyleBuilder()
+        .color('#666')
+        .size('11px')
+        .font('Monaco, Consolas, monospace')
+        .build();
+
+    const levelStyle = new StyleBuilder()
+        .bg(levelConfig.background)
+        .color(levelConfig.color)
+        .border(levelConfig.border)
+        .shadow(levelConfig.shadow)
+        .padding('2px 8px')
+        .rounded('4px')
+        .bold()
+        .font('Monaco, Consolas, monospace')
+        .size('12px')
+        .build();
+
+    const prefixStyle = new StyleBuilder()
+        .bg('#2d3748')
+        .color('#e2e8f0')
+        .padding('2px 6px')
+        .rounded('3px')
+        .bold()
+        .font('Monaco, Consolas, monospace')
+        .size('11px')
+        .build();
+
+    const messageStyle = new StyleBuilder()
+        .color('#2d3748')
+        .font('system-ui, -apple-system, sans-serif')
+        .size('14px')
+        .build();
+
+    const locationStyle = new StyleBuilder()
+        .color('#718096')
+        .size('11px')
+        .font('Monaco, Consolas, monospace')
+        .build();
+
+    // Build format string and styles
+    let format = `%c${timestamp.slice(11, 23)} %c${levelConfig.emoji} ${levelConfig.label}`;
+    const styles = [timestampStyle, levelStyle];
+
+    if (prefix) {
+        format += ` %c${prefix}`;
+        styles.push(prefixStyle);
+    }
+
+    format += ` %c${message}`;
+    styles.push(messageStyle);
+
+    if (stackInfo) {
+        format += ` %c(${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`;
+        styles.push(locationStyle);
+    }
+
+    return [format, ...styles];
+}
+
+/**
+ * Create a unique ID for log entries
+ */
+export function generateLogId(): string {
+    return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+
+/**
+ * Escape HTML entities for safe HTML output
+ */
+export function escapeHtml(text: string): string {
+    const div = document.createElement('div');
+    div.textContent = text;
+    return div.innerHTML;
+}
+
+/**
+ * Convert objects to safe string representation for logging
+ */
+export function safeStringify(obj: any, _maxDepth = 3): string {
+    try {
+        return JSON.stringify(obj, (_key, value) => {
+            if (typeof value === 'function') return '[Function]';
+            if (value instanceof Error) return `[Error: ${value.message}]`;
+            if (value instanceof Date) return value.toISOString();
+            if (typeof value === 'undefined') return '[undefined]';
+            return value;
+        }, 2);
+    } catch (error) {
+        return String(obj);
+    }
+}

package/src/utils/stackTrace.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Stack trace parsing utilities for Advanced Logger
+ */
+
+import type { StackInfo } from '../types/index.js';
+
+/**
+ * Parses the current stack trace to extract caller information
+ */
+export function parseStackTrace(): StackInfo | null {
+    try {
+        const stack = new Error().stack;
+        if (!stack) return null;
+
+        const lines = stack.split('\n').filter(line => line.trim());
+        
+        // Find the first caller that's not from Logger methods
+        for (let i = 1; i < lines.length; i++) {
+            const line = lines[i];
+            
+            // Skip if line contains Logger methods or parseStackTrace
+            if (line.includes('parseStackTrace') || 
+                line.includes('Logger.') || 
+                line.includes('.log(') ||
+                line.includes('createStyledOutput')) {
+                continue;
+            }
+
+            // Parse different stack trace formats
+            let match;
+            
+            // Chrome format: "at functionName (file:line:column)" or "at file:line:column"
+            const chromeMatch = line.match(/at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?$/);
+            if (chromeMatch) {
+                match = chromeMatch;
+            } else {
+                // Firefox format: "functionName@file:line:column"
+                const firefoxMatch = line.match(/(.+?)@(.+?):(\d+):(\d+)$/);
+                if (firefoxMatch) {
+                    match = firefoxMatch;
+                } else {
+                    // Safari/other formats
+                    const safariMatch = line.match(/(\S+)?@(.+?):(\d+):(\d+)$/);
+                    if (safariMatch) {
+                        match = safariMatch;
+                    }
+                }
+            }
+
+            if (match) {
+                const [, functionName, file, line, column] = match;
+                
+                return {
+                    file: file?.split('/').pop()?.split('?')[0] || 'unknown',
+                    line: parseInt(line, 10) || 0,
+                    column: parseInt(column, 10) || 0,
+                    function: functionName?.trim() || undefined,
+                };
+            }
+        }
+        
+        return null;
+    } catch {
+        return null;
+    }
+}