@mks2508/better-logger 5.0.0 → 5.0.2

package/src/types/transports.ts

@@ -1,52 +0,0 @@
-import type { LogLevel, StackInfo } from './core.js';
-
-export interface TransportRecord {
-    level: LogLevel;
-    levelValue: number;
-    time: number;
-    msg: string;
-    prefix?: string;
-    location?: {
-        file: string;
-        line: number;
-        column: number;
-        function?: string;
-    };
-    [key: string]: any;
-}
-
-export interface TransportOptions {
-    level?: LogLevel;
-    transform?: (record: TransportRecord) => TransportRecord | null;
-    batchSize?: number;
-    flushInterval?: number;
-    [key: string]: any;
-}
-
-export interface TransportTarget {
-    target: string | ITransport;
-    options?: TransportOptions;
-    level?: LogLevel;
-}
-
-export interface ITransport {
-    readonly name: string;
-    write(record: TransportRecord): void | Promise<void>;
-    flush?(): void | Promise<void>;
-    close?(): void | Promise<void>;
-    isReady?(): boolean;
-}
-
-export interface IBufferedTransport extends ITransport {
-    readonly bufferSize: number;
-    readonly maxBufferSize: number;
-    flush(): Promise<void>;
-}
-
-export interface ITransportManager {
-    add(target: TransportTarget): string;
-    remove(id: string): boolean;
-    write(record: TransportRecord): Promise<void>;
-    flush(): Promise<void>;
-    close(): Promise<void>;
-}

package/src/typescript.svg

@@ -1 +0,0 @@
-<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/adapter.ts

@@ -1,291 +0,0 @@
-/**
- * CSS to ANSI Adapter - Converts CSS-based styles to ANSI terminal styles
- * Bridges the gap between browser styling and terminal rendering
- */
-
-import type { LogStyles } from '../types/index.js';
-import type { ANSIStyle } from '../terminal/terminal-renderer.js';
-import { TerminalRenderer } from '../terminal/terminal-renderer.js';
-import type { LogLevel } from '../types/index.js';
-import { getColorCapability } from './environment-detector.js';
-
-export class CSS2ANSIAdapter {
-    private renderer: TerminalRenderer;
-
-    constructor() {
-        const colorCapability = getColorCapability();
-        this.renderer = new TerminalRenderer(colorCapability);
-    }
-
-    /**
-     * Convert LogStyles to ANSIStyle for terminal rendering
-     */
-    adaptStyles(
-        level: LogLevel,
-        message: string,
-        timestamp?: string,
-        prefix?: string,
-        location?: string,
-        styles?: LogStyles,
-        presetName?: string
-    ): ANSIStyle {
-        // Special handling for specific presets that need unique terminal representations
-        if (presetName) {
-            switch (presetName) {
-                case 'cyberpunk':
-                    return this.renderer.renderCyberpunk(level, message, timestamp, prefix, location);
-                case 'minimal':
-                    return this.renderer.renderMinimal(level, message, timestamp, prefix);
-                case 'production':
-                    return this.adaptProductionStyles(level, message, timestamp, prefix, location, styles);
-                case 'debug':
-                    return this.adaptDebugStyles(level, message, timestamp, prefix, location, styles);
-                case 'glassmorphism':
-                    return this.adaptGlassmorphismStyles(level, message, timestamp, prefix, location, styles);
-            }
-        }
-
-        // Default adaptation using the renderer
-        return this.renderer.renderTerminal(level, message, timestamp, prefix, location, styles);
-    }
-
-    /**
-     * Adapt production preset for terminal
-     */
-    private adaptProductionStyles(
-        level: LogLevel,
-        message: string,
-        timestamp?: string,
-        prefix?: string,
-        location?: string,
-        styles?: LogStyles
-    ): ANSIStyle {
-        const reset = '\x1b[0m';
-        const levelChalk = this.renderer.getChalkForLevel(level);
-
-        const parts: string[] = [];
-
-        // Production: clean, essential info only
-        if (timestamp && styles?.timestamp?.show) {
-            parts.push(levelChalk.dim(timestamp));
-        }
-
-        if (styles?.level?.show) {
-            parts.push(levelChalk.color(`[${this.renderer['getLevelText'](level)}]`));
-        }
-
-        // Skip prefix in production (as per preset config)
-        if (prefix && styles?.prefix?.show) {
-            parts.push(levelChalk.dim(`[${prefix}]`));
-        }
-
-        if (message && styles?.message?.show) {
-            parts.push(levelChalk.reset(message));
-        }
-
-        // Skip location in production (as per preset config)
-        if (location && styles?.location?.show) {
-            parts.push(levelChalk.dim(`(${location})`));
-        }
-
-        return {
-            text: parts.join(' ') + reset,
-            reset
-        };
-    }
-
-    /**
-     * Adapt debug preset for terminal
-     */
-    private adaptDebugStyles(
-        level: LogLevel,
-        message: string,
-        timestamp?: string,
-        prefix?: string,
-        location?: string,
-        styles?: LogStyles
-    ): ANSIStyle {
-        const reset = '\x1b[0m';
-        const levelChalk = this.renderer.getChalkForLevel(level);
-
-        const parts: string[] = [];
-
-        // Debug: monospace fonts, detailed info, compact layout
-        if (timestamp && styles?.timestamp?.show) {
-            parts.push(levelChalk.dim(timestamp));
-        }
-
-        if (styles?.level?.show) {
-            if (styles?.level?.style === 'compact') {
-                parts.push(levelChalk.color(`[${this.renderer['getLevelText'](level)}]`));
-            } else {
-                parts.push(levelChalk.bold(`[${this.renderer['getLevelText'](level)}]`));
-            }
-        }
-
-        if (prefix && styles?.prefix?.show) {
-            if (styles?.prefix?.style === 'compact') {
-                parts.push(levelChalk.cyan.dim(`[${prefix}]`));
-            } else {
-                parts.push(levelChalk.cyan.bold(`[${prefix}]`));
-            }
-        }
-
-        if (message && styles?.message?.show) {
-            parts.push(levelChalk.reset(message));
-        }
-
-        // Debug usually shows location
-        if (location && styles?.location?.show) {
-            if (styles?.location?.style === 'clickable') {
-                parts.push(levelChalk.dim(`${location} (clickable)`));
-            } else {
-                parts.push(levelChalk.dim(`(${location})`));
-            }
-        }
-
-        return {
-            text: parts.join(' ') + reset,
-            reset
-        };
-    }
-
-    /**
-     * Adapt glassmorphism preset for terminal
-     */
-    private adaptGlassmorphismStyles(
-        level: LogLevel,
-        message: string,
-        timestamp?: string,
-        prefix?: string,
-        location?: string,
-        styles?: LogStyles
-    ): ANSIStyle {
-        const reset = '\x1b[0m';
-        const levelChalk = this.renderer.getChalkForLevel(level);
-
-        const parts: string[] = [];
-
-        // Glassmorphism: subtle, transparent effects
-        if (timestamp && styles?.timestamp?.show) {
-            parts.push(levelChalk.dim(timestamp));
-        }
-
-        if (styles?.level?.show) {
-            // Subtle level styling with dim background effect
-            parts.push(levelChalk.bgGray(` ${this.renderer['getLevelText'](level)} `));
-        }
-
-        if (prefix && styles?.prefix?.show) {
-            parts.push(levelChalk.bgBlue(`[${prefix}]`));
-        }
-
-        if (message && styles?.message?.show) {
-            parts.push(levelChalk.reset(message));
-        }
-
-        if (location && styles?.location?.show) {
-            parts.push(levelChalk.dim(`(${location})`));
-        }
-
-        return {
-            text: parts.join(' ') + reset,
-            reset
-        };
-    }
-
-    /**
-     * Convert CSS color values to ANSI-friendly colors
-     */
-    adaptColor(cssColor: string): string {
-        // Handle hex colors
-        if (cssColor.startsWith('#')) {
-            return cssColor; // TerminalRenderer will handle this
-        }
-
-        // Handle RGB colors
-        if (cssColor.startsWith('rgb(')) {
-            return cssColor; // TerminalRenderer will handle this
-        }
-
-        // Handle CSS gradients - extract primary color
-        if (cssColor.includes('gradient')) {
-            return this.extractColorFromGradient(cssColor);
-        }
-
-        // Handle CSS color names
-        return this.cssNameToANSI(cssColor);
-    }
-
-    /**
-     * Extract primary color from CSS gradient
-     */
-    private extractColorFromGradient(gradient: string): string {
-        // Extract first color from linear-gradient
-        const match = gradient.match(/#[0-9a-fA-F]{6}|rgb\([^)]+\)/);
-        return match ? match[0] : '#ffffff';
-    }
-
-    /**
-     * Convert CSS color names to ANSI-compatible names
-     */
-    private cssNameToANSI(cssColor: string): string {
-        const colorMap: Record<string, string> = {
-            'black': 'black',
-            'white': 'white',
-            'red': 'red',
-            'green': 'green',
-            'blue': 'blue',
-            'yellow': 'yellow',
-            'cyan': 'cyan',
-            'magenta': 'magenta',
-            'gray': 'gray',
-            'grey': 'gray',
-            'orange': 'yellow',
-            'purple': 'magenta',
-            'pink': 'red',
-            'brown': 'yellow',
-            'lightblue': 'cyan',
-            'lightgreen': 'green',
-            'lightgray': 'gray',
-            'lightgrey': 'gray'
-        };
-
-        return colorMap[cssColor.toLowerCase()] || 'white';
-    }
-
-    /**
-     * Check if a style should be rendered in terminal
-     */
-    shouldRenderStyle(styleType: string, styles?: LogStyles): boolean {
-        if (!styles) return true;
-
-        const styleConfig = (styles as any)[styleType];
-        return styleConfig?.show !== false;
-    }
-
-    /**
-     * Get renderer instance for advanced usage
-     */
-    getRenderer(): TerminalRenderer {
-        return this.renderer;
-    }
-}
-
-// Singleton instance for consistent styling
-export const css2ansiAdapter = new CSS2ANSIAdapter();
-
-/**
- * Convenience function for quick style adaptation
- */
-export function adaptToTerminal(
-    level: LogLevel,
-    message: string,
-    timestamp?: string,
-    prefix?: string,
-    location?: string,
-    styles?: LogStyles,
-    presetName?: string
-): ANSIStyle {
-    return css2ansiAdapter.adaptStyles(level, message, timestamp, prefix, location, styles, presetName);
-}

package/src/utils/ansi-colors.ts

@@ -1,333 +0,0 @@
-/**
- * @fileoverview ANSI color utilities for terminal environments
- * @since 1.0.0
- */
-
-import type { LogLevel } from '../types/index.js';
-import { supportsANSIColors } from './environment.js';
-
-/**
- * ANSI color codes for terminal styling
- */
-export const ANSI_CODES = {
-    // Colors
-    black: 30,
-    red: 31,
-    green: 32,
-    yellow: 33,
-    blue: 34,
-    magenta: 35,
-    cyan: 36,
-    white: 37,
-
-    // Bright colors
-    brightBlack: 90,
-    brightRed: 91,
-    brightGreen: 92,
-    brightYellow: 93,
-    brightBlue: 94,
-    brightMagenta: 95,
-    brightCyan: 96,
-    brightWhite: 97,
-
-    // Background colors
-    bgBlack: 40,
-    bgRed: 41,
-    bgGreen: 42,
-    bgYellow: 43,
-    bgBlue: 44,
-    bgMagenta: 45,
-    bgCyan: 46,
-    bgWhite: 47,
-
-    // Background bright colors
-    bgBrightBlack: 100,
-    bgBrightRed: 101,
-    bgBrightGreen: 102,
-    bgBrightYellow: 103,
-    bgBrightBlue: 104,
-    bgBrightMagenta: 105,
-    bgBrightCyan: 106,
-    bgBrightWhite: 107,
-
-    // Styles
-    reset: 0,
-    bold: 1,
-    dim: 2,
-    italic: 3,
-    underline: 4,
-    blink: 5,
-    inverse: 7,
-    hidden: 8,
-    strikethrough: 9,
-
-    // Reset specific
-    resetBold: 22,
-    resetDim: 22,
-    resetItalic: 23,
-    resetUnderline: 24,
-    resetBlink: 25,
-    resetInverse: 27,
-    resetHidden: 28,
-    resetStrikethrough: 29
-} as const;
-
-/**
- * ANSI color presets for different log levels
- */
-export const ANSI_LEVEL_STYLES: Record<LogLevel | 'success', {
-    color: number;
-    background?: number;
-    styles: number[];
-    emoji: string;
-}> = {
-    debug: {
-        color: ANSI_CODES.brightBlack,
-        styles: [ANSI_CODES.dim],
-        emoji: '🔍'
-    },
-    info: {
-        color: ANSI_CODES.blue,
-        styles: [ANSI_CODES.bold],
-        emoji: 'ℹ️'
-    },
-    warn: {
-        color: ANSI_CODES.yellow,
-        background: ANSI_CODES.bgYellow,
-        styles: [ANSI_CODES.bold, ANSI_CODES.black],
-        emoji: '⚠️'
-    },
-    error: {
-        color: ANSI_CODES.red,
-        background: ANSI_CODES.bgRed,
-        styles: [ANSI_CODES.bold],
-        emoji: '❌'
-    },
-    critical: {
-        color: ANSI_CODES.white,
-        background: ANSI_CODES.bgRed,
-        styles: [ANSI_CODES.bold, ANSI_CODES.blink],
-        emoji: '🚨'
-    },
-    success: {
-        color: ANSI_CODES.green,
-        background: ANSI_CODES.bgGreen,
-        styles: [ANSI_CODES.bold],
-        emoji: '✅'
-    }
-};
-
-/**
- * Creates an ANSI escape sequence
- */
-function ansi(code: number | number[]): string {
-    const codes = Array.isArray(code) ? code : [code];
-    return `\x1b[${codes.join(';')}m`;
-}
-
-/**
- * Applies ANSI styling to text
- */
-export function ansiStyle(text: string, codes: number[]): string {
-    if (!supportsANSIColors()) return text;
-    return `${ansi(codes)}${text}${ansi(ANSI_CODES.reset)}`;
-}
-
-/**
- * Applies color to text
- */
-export function ansiColor(text: string, color: number): string {
-    return ansiStyle(text, [color]);
-}
-
-/**
- * Applies background color to text
- */
-export function ansiBackground(text: string, bg: number, color?: number): string {
-    if (color) {
-        return ansiStyle(text, [color, bg]);
-    }
-    return ansiStyle(text, [bg]);
-}
-
-/**
- * Makes text bold
- */
-export function ansiBold(text: string): string {
-    return ansiStyle(text, [ANSI_CODES.bold]);
-}
-
-/**
- * Makes text dim
- */
-export function ansiDim(text: string): string {
-    return ansiStyle(text, [ANSI_CODES.dim]);
-}
-
-/**
- * Underlines text
- */
-export function ansiUnderline(text: string): string {
-    return ansiStyle(text, [ANSI_CODES.underline]);
-}
-
-/**
- * Specialized formatters for different contexts
- */
-
-/**
- * Format timestamp for terminal
- */
-export function formatTimestampANSI(timestamp: string): string {
-    return ansiColor(timestamp, ANSI_CODES.brightBlack);
-}
-
-/**
- * Format log level for terminal
- */
-export function formatLogLevelANSI(level: LogLevel, useEmojis: boolean = true): string {
-    const style = ANSI_LEVEL_STYLES[level];
-    const emoji = useEmojis ? style.emoji : '';
-    const label = level.toUpperCase().padEnd(8);
-
-    if (!supportsANSIColors()) {
-        return `${emoji} ${label}`;
-    }
-
-    let codes = [style.color, ...style.styles];
-    if (style.background) {
-        codes.push(style.background);
-    }
-
-    return ansiStyle(`${emoji} ${label}`, codes);
-}
-
-/**
- * Format success message for terminal
- */
-export function formatSuccessANSI(message: string, useEmojis: boolean = true): string {
-    const style = ANSI_LEVEL_STYLES.success;
-    const emoji = useEmojis ? style.emoji : '';
-
-    if (!supportsANSIColors()) {
-        return `${emoji} SUCCESS: ${message}`;
-    }
-
-    const prefix = ansiStyle(`${emoji} SUCCESS:`, [style.color, ...style.styles]);
-    return `${prefix} ${message}`;
-}
-
-/**
- * Format prefix for terminal
- */
-export function formatPrefixANSI(prefix: string): string {
-    if (!supportsANSIColors()) {
-        return `[${prefix}]`;
-    }
-
-    return ansiStyle(`[${prefix}]`, [ANSI_CODES.cyan, ANSI_CODES.bold]);
-}
-
-/**
- * Format file location for terminal
- */
-export function formatLocationANSI(location: string): string {
-    if (!supportsANSIColors()) {
-        return `(${location})`;
-    }
-
-    return ansiColor(`(${location})`, ANSI_CODES.brightBlack);
-}
-
-/**
- * Format build-specific messages
- */
-export const BUILD_FORMATTERS = {
-    /**
-     * Format compilation step
-     */
-    compilation: (step: string, status: 'starting' | 'completed' | 'failed' = 'starting') => {
-        const stepText = ansiBold(step);
-
-        switch (status) {
-            case 'starting':
-                return `${ansiColor('⚙️', ANSI_CODES.blue)} ${stepText}...`;
-            case 'completed':
-                return `${ansiColor('✓', ANSI_CODES.green)} ${stepText} ${ansiColor('completed', ANSI_CODES.green)}`;
-            case 'failed':
-                return `${ansiColor('✗', ANSI_CODES.red)} ${stepText} ${ansiColor('failed', ANSI_CODES.red)}`;
-            default:
-                return stepText;
-        }
-    },
-
-    /**
-     * Format warning message
-     */
-    warning: (message: string) => {
-        return `${ansiColor('⚠', ANSI_CODES.yellow)} ${ansiStyle('Warning:', [ANSI_CODES.yellow, ANSI_CODES.bold])} ${message}`;
-    },
-
-    /**
-     * Format error message
-     */
-    error: (message: string) => {
-        return `${ansiColor('✗', ANSI_CODES.red)} ${ansiStyle('Error:', [ANSI_CODES.red, ANSI_CODES.bold])} ${message}`;
-    },
-
-    /**
-     * Format success message
-     */
-    success: (message: string) => {
-        return `${ansiColor('✓', ANSI_CODES.green)} ${ansiColor(message, ANSI_CODES.green)}`;
-    },
-
-    /**
-     * Format info message
-     */
-    info: (message: string) => {
-        return `${ansiColor('ℹ', ANSI_CODES.blue)} ${message}`;
-    }
-};
-
-/**
- * Terminal-friendly emoji alternatives for environments that don't support them
- */
-export const EMOJI_ALTERNATIVES = {
-    '🔍': '[DEBUG]',
-    'ℹ️': '[INFO]',
-    '⚠️': '[WARN]',
-    '❌': '[ERROR]',
-    '🚨': '[CRITICAL]',
-    '✅': '[OK]',
-    '✓': '[OK]',
-    '✗': '[FAIL]',
-    '⚙️': '[BUILD]',
-    '📦': '[PKG]'
-};
-
-/**
- * Replace emojis with text alternatives for non-emoji terminals
- */
-export function sanitizeEmojis(text: string): string {
-    // Check if we're in a terminal that likely supports emojis
-    const isModernTerminal = process.env.TERM &&
-        (process.env.TERM.includes('xterm') ||
-         process.env.TERM.includes('screen') ||
-         process.env.TERM.includes('tmux'));
-
-    const isCI = process.env.CI || process.env.GITHUB_ACTIONS || process.env.JENKINS_URL;
-
-    // Use emojis if we have a modern terminal and not in CI
-    if (isModernTerminal && !isCI) {
-        return text;
-    }
-
-    // Replace emojis with text alternatives
-    let result = text;
-    Object.entries(EMOJI_ALTERNATIVES).forEach(([emoji, alt]) => {
-        result = result.replace(new RegExp(emoji, 'g'), alt);
-    });
-
-    return result;
-}