@mks2508/better-logger 5.0.0 → 5.0.2

package/src/cli/help.ts

@@ -1,127 +0,0 @@
-/**
- * @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

@@ -1,71 +0,0 @@
-/**
- * @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';
-import { 
-    HistoryCommand, 
-    ClearHistoryCommand, 
-    InteractiveCommand, 
-    PluginsCommand 
-} from './commands/HistoryCommand.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());
-    
-    // Register new enhanced commands
-    processor.registerCommand(new HistoryCommand());
-    processor.registerCommand(new ClearHistoryCommand());
-    processor.registerCommand(new InteractiveCommand());
-    processor.registerCommand(new PluginsCommand());
-    
-    return processor;
-}

package/src/cli-module.ts

@@ -1,21 +0,0 @@
-/**
- * @fileoverview CLI-only entry point for @mks2508/better-logger/cli
- * Exports only CLI primitives for minimal bundle size in CLI tools.
- * @version 5.0.0
- * @since 5.0.0
- */
-
-export { renderStep } from './cli-primitives/step.js';
-export { renderHeader } from './cli-primitives/header.js';
-export { renderDivider } from './cli-primitives/divider.js';
-export { renderBox } from './cli-primitives/box.js';
-export { renderTable } from './cli-primitives/cli-table.js';
-export { SpinnerManager, NoopSpinner } from './cli-primitives/spinner.js';
-export { ServerFallback } from './cli-primitives/server-fallback.js';
-
-export type {
-    CLILogLevel,
-    ISpinnerHandle,
-    IBoxOptions,
-    ITableOptions,
-} from './types/index.js';

package/src/cli-primitives/box.ts

@@ -1,86 +0,0 @@
-/**
- * @fileoverview Box renderer for CLI primitives
- * @since 5.0.0
- */
-
-import type { IBoxOptions } from '../types/core.js';
-import type { ColorCapability } from '../terminal/color-converter.js';
-import { getANSIForeground, ANSI } from '../terminal/color-converter.js';
-import { getTerminalWidth } from '../utils/environment-detector.js';
-import { stripAnsi, getVisibleLength } from '../terminal/formatter.js';
-
-/**
- * Border character sets for different styles
- */
-const BORDER_CHARS = {
-    single:  { tl: '\u250c', tr: '\u2510', bl: '\u2514', br: '\u2518', h: '\u2500', v: '\u2502' },
-    rounded: { tl: '\u256d', tr: '\u256e', bl: '\u2570', br: '\u256f', h: '\u2500', v: '\u2502' },
-    double:  { tl: '\u2554', tr: '\u2557', bl: '\u255a', br: '\u255d', h: '\u2550', v: '\u2551' },
-    bold:    { tl: '\u250f', tr: '\u2513', bl: '\u2517', br: '\u251b', h: '\u2501', v: '\u2503' },
-} as const;
-
-/**
- * Renders content inside a bordered box
- * @param content - Content string (may contain newlines)
- * @param options - Box rendering options
- * @param colorCap - Terminal color capability
- * @returns Formatted box string with border
- */
-export function renderBox(content: string, options: IBoxOptions = {}, colorCap: ColorCapability = 'full'): string {
-    const {
-        title,
-        borderColor,
-        borderStyle = 'rounded',
-        padding = 0,
-    } = options;
-
-    const chars = BORDER_CHARS[borderStyle] ?? BORDER_CHARS.rounded;
-    const lines = content.split('\n');
-    const maxTermWidth = Math.min(getTerminalWidth() - 4, 80);
-
-    // Calculate content width from visible text
-    const contentWidths = lines.map(l => getVisibleLength(l));
-    const titleWidth = title ? stripAnsi(title).length + 2 : 0; // +2 for spaces around title
-    const maxContentWidth = Math.max(...contentWidths, titleWidth);
-    const innerWidth = Math.min(maxContentWidth + 2, maxTermWidth); // +2 for horizontal padding
-
-    // Color wrapper for border chars
-    const bc = borderColor && colorCap !== 'none'
-        ? getANSIForeground(borderColor, colorCap)
-        : '';
-    const reset = bc ? ANSI.reset : '';
-
-    const wrap = (char: string) => `${bc}${char}${reset}`;
-
-    // Build top border (with optional title)
-    let topBorder: string;
-    if (title) {
-        const titleStr = ` ${title} `;
-        const afterTitle = innerWidth - stripAnsi(titleStr).length;
-        topBorder = `  ${wrap(chars.tl)}${wrap(chars.h)}${wrap(titleStr)}${wrap(chars.h.repeat(Math.max(0, afterTitle - 1)))}${wrap(chars.tr)}`;
-    } else {
-        topBorder = `  ${wrap(chars.tl)}${wrap(chars.h.repeat(innerWidth))}${wrap(chars.tr)}`;
-    }
-
-    // Build bottom border
-    const bottomBorder = `  ${wrap(chars.bl)}${wrap(chars.h.repeat(innerWidth))}${wrap(chars.br)}`;
-
-    // Build padding lines
-    const emptyLine = `  ${wrap(chars.v)}${' '.repeat(innerWidth)}${wrap(chars.v)}`;
-    const paddingLines = padding > 0 ? Array(padding).fill(emptyLine) : [];
-
-    // Build content lines
-    const contentLines = lines.map(line => {
-        const visible = getVisibleLength(line);
-        const pad = innerWidth - visible - 1; // -1 for left space
-        return `  ${wrap(chars.v)} ${line}${' '.repeat(Math.max(0, pad))}${wrap(chars.v)}`;
-    });
-
-    return [
-        topBorder,
-        ...paddingLines,
-        ...contentLines,
-        ...paddingLines,
-        bottomBorder,
-    ].join('\n');
-}

package/src/cli-primitives/cli-table.ts

@@ -1,62 +0,0 @@
-/**
- * @fileoverview CLI table renderer for CLI primitives
- * @since 5.0.0
- */
-
-import type { ITableOptions } from '../types/core.js';
-import type { ColorCapability } from '../terminal/color-converter.js';
-import { getANSIForeground, ANSI } from '../terminal/color-converter.js';
-import { getVisibleLength, padToWidth } from '../terminal/formatter.js';
-
-/**
- * Renders an array of objects as a formatted ASCII table
- * @param rows - Array of row objects
- * @param options - Table rendering options
- * @param colorCap - Terminal color capability
- * @returns Formatted table string
- */
-export function renderTable(
-    rows: Record<string, unknown>[],
-    options: ITableOptions = {},
-    colorCap: ColorCapability = 'full'
-): string {
-    if (rows.length === 0) return '';
-
-    // Determine columns from options or first row's keys
-    const columns = options.columns ?? Object.keys(rows[0]!);
-    const headers = options.head ?? columns;
-
-    // Calculate column widths (max of header and all values)
-    const colWidths = columns.map((col, i) => {
-        const headerLen = getVisibleLength(headers[i] ?? col);
-        const maxValueLen = rows.reduce((max, row) => {
-            const val = String(row[col] ?? '');
-            return Math.max(max, getVisibleLength(val));
-        }, 0);
-        return Math.max(headerLen, maxValueLen) + 2; // +2 for padding
-    });
-
-    // Color helpers
-    const cyan = colorCap !== 'none' ? getANSIForeground('#00bcd4', colorCap) : '';
-    const dim = colorCap !== 'none' ? ANSI.dim : '';
-    const reset = colorCap !== 'none' ? ANSI.reset : '';
-
-    // Build header row
-    const headerRow = '  ' + columns.map((col, i) => {
-        const label = headers[i] ?? col;
-        return cyan + ANSI.bold + padToWidth(` ${label}`, colWidths[i]!) + reset;
-    }).join('');
-
-    // Build separator
-    const separator = '  ' + dim + colWidths.map(w => '\u2500'.repeat(w)).join('\u2500') + reset;
-
-    // Build data rows
-    const dataRows = rows.map(row => {
-        return '  ' + columns.map((col, i) => {
-            const val = String(row[col] ?? '');
-            return padToWidth(` ${val}`, colWidths[i]!);
-        }).join('');
-    });
-
-    return [headerRow, separator, ...dataRows].join('\n');
-}

package/src/cli-primitives/divider.ts

@@ -1,17 +0,0 @@
-/**
- * @fileoverview Divider renderer for CLI primitives
- * @since 5.0.0
- */
-
-import { ANSI } from '../terminal/color-converter.js';
-import { getTerminalWidth } from '../utils/environment-detector.js';
-
-/**
- * Renders a horizontal divider line
- * @param width - Optional explicit width (defaults to terminal width capped at 60)
- * @returns Formatted divider string
- */
-export function renderDivider(width?: number): string {
-    const w = width ?? Math.min(getTerminalWidth() - 4, 60);
-    return ANSI.dim + '  ' + '\u2500'.repeat(w) + ANSI.reset;
-}

package/src/cli-primitives/header.ts

@@ -1,18 +0,0 @@
-/**
- * @fileoverview Header renderer for CLI primitives
- * @since 5.0.0
- */
-
-import { ANSI } from '../terminal/color-converter.js';
-
-/**
- * Renders a styled header with optional subtitle
- * @param title - Main title text
- * @param subtitle - Optional subtitle (rendered dimmed)
- * @returns Formatted header string
- */
-export function renderHeader(title: string, subtitle?: string): string {
-    const t = ANSI.bold + title + ANSI.reset;
-    const s = subtitle ? ANSI.dim + ` ${subtitle}` + ANSI.reset : '';
-    return `  ${t}${s}`;
-}

package/src/cli-primitives/index.ts

@@ -1,13 +0,0 @@
-/**
- * @fileoverview CLI Primitives - Built-in terminal UI components for better-logger
- * @version 5.0.0
- * @since 5.0.0
- */
-
-export { renderStep } from './step.js';
-export { renderHeader } from './header.js';
-export { renderDivider } from './divider.js';
-export { renderBox } from './box.js';
-export { renderTable } from './cli-table.js';
-export { SpinnerManager, NoopSpinner } from './spinner.js';
-export { ServerFallback } from './server-fallback.js';

package/src/cli-primitives/server-fallback.ts

@@ -1,54 +0,0 @@
-/**
- * @fileoverview Server/JSON fallback for CLI primitives in non-TTY environments
- * @since 5.0.0
- */
-
-import type { IBoxOptions, ITableOptions } from '../types/core.js';
-import type { Logger } from '../Logger.js';
-
-/**
- * Server-mode fallback: outputs CLI primitives as plain logger calls
- * when not running in an interactive terminal.
- *
- * @since 5.0.0
- */
-export class ServerFallback {
-    private logger: Logger;
-
-    constructor(logger: Logger) {
-        this.logger = logger;
-    }
-
-    /** Render step as plain info log */
-    step(current: number, total: number, msg: string): void {
-        this.logger.info(`[${current}/${total}] ${msg}`);
-    }
-
-    /** Render header as plain info log */
-    header(title: string, subtitle?: string): void {
-        const text = subtitle ? `${title} ${subtitle}` : title;
-        this.logger.info(text);
-    }
-
-    /** Divider is a no-op in server mode */
-    divider(): void {
-        // No-op in server/JSON mode
-    }
-
-    /** Blank line is a no-op in server mode */
-    blank(): void {
-        // No-op in server/JSON mode
-    }
-
-    /** Render box content as plain info log */
-    box(content: string, _options?: IBoxOptions): void {
-        this.logger.info(content);
-    }
-
-    /** Render table rows as plain info logs */
-    cliTable(rows: Record<string, unknown>[], _options?: ITableOptions): void {
-        for (const row of rows) {
-            this.logger.info(JSON.stringify(row));
-        }
-    }
-}

package/src/cli-primitives/spinner.ts

@@ -1,133 +0,0 @@
-/**
- * @fileoverview Built-in spinner implementation for CLI primitives
- * @since 5.0.0
- */
-
-import type { ISpinnerHandle, LoggerConfig } from '../types/core.js';
-import type { Logger } from '../Logger.js';
-import { ANSI } from '../terminal/color-converter.js';
-
-/** Braille-based spinner animation frames */
-const SPINNER_FRAMES = ['\u280b', '\u2819', '\u2839', '\u2838', '\u283c', '\u2834', '\u2826', '\u2827', '\u2807', '\u280f'];
-
-/** Spinner frame interval in milliseconds */
-const FRAME_INTERVAL = 80;
-
-/**
- * Interactive terminal spinner with in-place line updates.
- * Writes to stderr to avoid polluting piped stdout.
- *
- * @implements {ISpinnerHandle}
- * @since 5.0.0
- */
-export class SpinnerManager implements ISpinnerHandle {
-    private message: string;
-    private frameIndex = 0;
-    private interval: ReturnType<typeof setInterval> | null = null;
-    private _logger: Logger;
-
-    constructor(message: string, _config: LoggerConfig, logger: Logger) {
-        this.message = message;
-        this._logger = logger;
-    }
-
-    /** Start the spinner animation */
-    start(): void {
-        if (this.interval) return; // Already running
-
-        // Switch logger to buffer mode to prevent garbled output
-        this._logger.updateConfig({ outputMode: 'silent' });
-
-        this.frameIndex = 0;
-        this.render();
-        this.interval = setInterval(() => {
-            this.frameIndex = (this.frameIndex + 1) % SPINNER_FRAMES.length;
-            this.render();
-        }, FRAME_INTERVAL);
-    }
-
-    /** Stop the spinner without a status message */
-    stop(): void {
-        this.clearInterval();
-        this.clearLine();
-        // Restore logger output
-        this._logger.updateConfig({ outputMode: 'console' });
-    }
-
-    /** Stop with a success indicator */
-    succeed(msg?: string): void {
-        this.clearInterval();
-        this.clearLine();
-        const text = msg ?? this.message;
-        process.stderr.write(`  ${ANSI.fg.green}\u2713${ANSI.reset} ${text}\n`);
-        this._logger.updateConfig({ outputMode: 'console' });
-    }
-
-    /** Stop with a failure indicator */
-    fail(msg?: string): void {
-        this.clearInterval();
-        this.clearLine();
-        const text = msg ?? this.message;
-        process.stderr.write(`  ${ANSI.fg.red}\u2717${ANSI.reset} ${text}\n`);
-        this._logger.updateConfig({ outputMode: 'console' });
-    }
-
-    /** Update the spinner text while running */
-    text(msg: string): void {
-        this.message = msg;
-    }
-
-    private render(): void {
-        const frame = SPINNER_FRAMES[this.frameIndex] ?? SPINNER_FRAMES[0];
-        const line = `  ${ANSI.fg.cyan}${frame}${ANSI.reset} ${this.message}`;
-        process.stderr.write(`\r\x1b[K${line}`);
-    }
-
-    private clearLine(): void {
-        process.stderr.write('\r\x1b[K');
-    }
-
-    private clearInterval(): void {
-        if (this.interval) {
-            clearInterval(this.interval);
-            this.interval = null;
-        }
-    }
-}
-
-/**
- * No-op spinner for non-TTY environments or silent mode.
- * Logs start/succeed/fail as plain log messages.
- *
- * @implements {ISpinnerHandle}
- * @since 5.0.0
- */
-export class NoopSpinner implements ISpinnerHandle {
-    private message: string;
-    private _logger: Logger;
-
-    constructor(message: string, logger: Logger) {
-        this.message = message;
-        this._logger = logger;
-    }
-
-    start(): void {
-        this._logger.info(this.message);
-    }
-
-    stop(): void {
-        // No-op
-    }
-
-    succeed(msg?: string): void {
-        this._logger.success(msg ?? this.message);
-    }
-
-    fail(msg?: string): void {
-        this._logger.error(msg ?? this.message);
-    }
-
-    text(msg: string): void {
-        this.message = msg;
-    }
-}

package/src/cli-primitives/step.ts

@@ -1,22 +0,0 @@
-/**
- * @fileoverview Step progress renderer for CLI primitives
- * @since 5.0.0
- */
-
-import { getANSIForeground, ANSI, type ColorCapability } from '../terminal/color-converter.js';
-
-/**
- * Renders a step progress indicator like `  [2/5] Analyzing repository...`
- * @param current - Current step number
- * @param total - Total number of steps
- * @param msg - Step description message
- * @param colorCap - Terminal color capability
- * @returns Formatted step string
- */
-export function renderStep(current: number, total: number, msg: string, colorCap: ColorCapability): string {
-    const label = `[${current}/${total}]`;
-    const colored = colorCap !== 'none'
-        ? getANSIForeground('#00bcd4', colorCap) + ANSI.bold + label + ANSI.reset
-        : label;
-    return `  ${colored} ${msg}`;
-}