@mks2508/better-logger 5.0.0 → 5.0.2

package/src/utils/environment-detector.ts

@@ -1,170 +0,0 @@
-/**
- * Environment Detector - Robust environment detection for logger
- * Detects browser, terminal, server, and other runtime environments
- */
-
-export type Environment = 'browser' | 'terminal' | 'server' | 'webworker' | 'deno' | 'unknown';
-
-/**
- * Main environment detection function
- */
-export function getEnvironment(): Environment {
-    // Check for Deno first
-    if (typeof globalThis !== 'undefined' && (globalThis as any).Deno) {
-        return 'deno';
-    }
-
-    // Check for WebWorker
-    if (typeof window === 'undefined' && typeof self !== 'undefined' && typeof (self as any).importScripts === 'function') {
-        return 'webworker';
-    }
-
-    // Check for Node.js (server environment)
-    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
-        // Determine if it's running in a terminal or as a server
-        if (isRunningInTerminal()) {
-            return 'terminal';
-        }
-        return 'server';
-    }
-
-    // Check for browser
-    if (typeof window !== 'undefined' && typeof document !== 'undefined') {
-        return 'browser';
-    }
-
-    return 'unknown';
-}
-
-/**
- * Check if running in an interactive terminal
- */
-export function isRunningInTerminal(): boolean {
-    // Check for common terminal indicators
-    if (typeof process === 'undefined') return false;
-
-    const isTTY = process.stdout && process.stdout.isTTY;
-    const hasTerminalEnv = process.env && (
-        process.env.TERM ||
-        process.env.TERM_PROGRAM ||
-        process.env.SSH_TTY ||
-        process.env.TERM_SESSION_ID
-    );
-
-    // Check if we're running in common terminal programs
-    const terminalPrograms = [
-        'vscode',
-        'hyper',
-        'iterm',
-        'terminal',
-        'alacritty',
-        'kitty',
-        'gnome-terminal',
-        'konsole',
-        'xterm',
-        'tmux',
-        'screen'
-    ];
-
-    const isTerminalProgram = hasTerminalEnv && terminalPrograms.some(program =>
-        process.env.TERM_PROGRAM?.toLowerCase().includes(program) ||
-        process.env.TERM?.toLowerCase().includes(program)
-    );
-
-    return Boolean(isTTY || hasTerminalEnv || isTerminalProgram);
-}
-
-/**
- * Check if environment supports ANSI colors
- */
-export function supportsANSI(): boolean {
-    const env = getEnvironment();
-
-    if (env === 'browser') return false;
-    if (env === 'terminal') return true;
-    if (env === 'server') return checkServerANSISupport();
-
-    return false;
-}
-
-/**
- * Check if server environment supports ANSI colors
- */
-function checkServerANSISupport(): boolean {
-    if (typeof process === 'undefined') return false;
-
-    // Check common environment variables that indicate ANSI support
-    const supportsANSI = process.env && (
-        process.env.COLORTERM ||
-        process.env.FORCE_COLOR ||
-        (process.env.TERM && process.env.TERM !== 'dumb') ||
-        process.env.TERM_PROGRAM
-    );
-
-    return Boolean(supportsANSI);
-}
-
-/**
- * Get environment-specific color capability
- */
-export function getColorCapability(): 'full' | 'basic' | 'none' {
-    const env = getEnvironment();
-
-    if (env === 'browser') {
-        return 'full'; // CSS colors
-    }
-
-    if (!supportsANSI()) {
-        return 'none';
-    }
-
-    // Check for 256-color or truecolor support
-    if (typeof process !== 'undefined' && process.env) {
-        const hasTrueColor = process.env.COLORTERM === 'truecolor' || process.env.COLORTERM === '24bit';
-        const has256Colors = process.env.TERM && process.env.TERM.includes('256');
-
-        if (hasTrueColor || has256Colors) {
-            return 'full';
-        }
-    }
-
-    return 'basic'; // Basic 16 colors
-}
-
-/**
- * Get terminal width in columns
- */
-export function getTerminalWidth(): number {
-    if (typeof process !== 'undefined' && process.stdout?.columns) {
-        return process.stdout.columns;
-    }
-    return 80;
-}
-
-/**
- * Get terminal height in rows
- */
-export function getTerminalHeight(): number {
-    if (typeof process !== 'undefined' && process.stdout?.rows) {
-        return process.stdout.rows;
-    }
-    return 24;
-}
-
-/**
- * Environment information for debugging
- */
-export function getEnvironmentInfo() {
-    return {
-        environment: getEnvironment(),
-        supportsANSI: supportsANSI(),
-        colorCapability: getColorCapability(),
-        isTTY: typeof process !== 'undefined' ? Boolean(process.stdout?.isTTY) : false,
-        platform: typeof process !== 'undefined' ? process.platform : 'unknown',
-        nodeVersion: typeof process !== 'undefined' ? process.versions?.node : null,
-        term: typeof process !== 'undefined' ? process.env?.TERM : null,
-        colorTerm: typeof process !== 'undefined' ? process.env?.COLORTERM : null,
-        terminalWidth: getTerminalWidth(),
-        terminalHeight: getTerminalHeight()
-    };
-}

package/src/utils/environment.ts

@@ -1,94 +0,0 @@
-/**
- * @fileoverview Environment detection utilities for Universal Logger
- */
-
-/**
- * Checks if running in Node.js environment
- */
-export const isNode = typeof process !== 'undefined' && 
-                      process.versions && 
-                      process.versions.node;
-
-/**
- * Checks if running in browser environment
- */
-export const isBrowser = typeof window !== 'undefined' && 
-                          typeof document !== 'undefined';
-
-/**
- * Checks if running in web worker environment
- */
-export const isWebWorker = typeof self !== 'undefined' && 
-                            typeof (self as any).importScripts === 'function';
-
-/**
- * Checks if running in Deno environment
- */
-export const isDeno = typeof globalThis !== 'undefined' && 
-                      'Deno' in globalThis;
-
-/**
- * Gets the current runtime environment
- */
-export function getRuntimeEnvironment(): 'node' | 'browser' | 'webworker' | 'deno' | 'unknown' {
-    if (isNode) return 'node';
-    if (isBrowser) return 'browser';
-    if (isWebWorker) return 'webworker';
-    if (isDeno) return 'deno';
-    return 'unknown';
-}
-
-/**
- * Checks if colors/styling should be supported in current environment
- */
-export function supportsColors(): boolean {
-    if (isBrowser) {
-        // Browser always supports CSS colors
-        return true;
-    }
-    
-    if (isNode) {
-        // Check if Node.js supports colors
-        return process.stdout?.isTTY === true || 
-               process.env.FORCE_COLOR === '1' ||
-               process.env.FORCE_COLOR === 'true';
-    }
-    
-    return false;
-}
-
-/**
- * Checks if CSS styling is supported (browser-only feature)
- */
-export function supportsCSSColors(): boolean {
-    return isBrowser;
-}
-
-/**
- * Checks if ANSI colors are supported (terminal environments)
- */
-export function supportsANSIColors(): boolean {
-    if (isNode) {
-        return process.stdout?.isTTY === true || 
-               process.env.FORCE_COLOR === '1' ||
-               process.env.FORCE_COLOR === 'true';
-    }
-    
-    return false;
-}
-
-/**
- * Gets environment-specific information
- */
-export function getEnvironmentInfo() {
-    const env = getRuntimeEnvironment();
-    
-    return {
-        runtime: env,
-        supportsColors: supportsColors(),
-        supportsCSSColors: supportsCSSColors(),
-        supportsANSIColors: supportsANSIColors(),
-        isProduction: isNode ? process.env.NODE_ENV === 'production' : false,
-        version: isNode ? process.versions.node : (isBrowser ? navigator.userAgent : 'unknown')
-    };
-}

package/src/utils/formatting.ts

@@ -1,332 +0,0 @@
-/**
- * @fileoverview Formatting utilities for Universal Logger
- */
-
-import type { LogLevel, StackInfo, OutputFormat } from '../types/index.js';
-import { formatTimestamp } from './timestamps.js';
-import { isNode, supportsANSIColors } from './environment.js';
-import {
-    formatLogLevelANSI,
-    formatTimestampANSI,
-    formatPrefixANSI,
-    formatLocationANSI,
-    sanitizeEmojis,
-    BUILD_FORMATTERS
-} from './ansi-colors.js';
-
-// Re-export the type for convenience
-export type { OutputFormat } from '../types/index.js';
-
-/**
- * Creates output based on environment and format preference
- */
-export function createOutput(
-    level: LogLevel,
-    message: string,
-    prefix?: string,
-    stackInfo?: StackInfo | null,
-    format: OutputFormat = 'auto'
-): string {
-    const detectedFormat = format === 'auto' ? detectOptimalFormat() : format;
-
-    switch (detectedFormat) {
-        case 'ansi':
-            return createANSIOutput(level, message, prefix, stackInfo);
-        case 'build':
-            return createBuildOutput(level, message, prefix, stackInfo);
-        case 'ci':
-            return createCIOutput(level, message, prefix, stackInfo);
-        case 'plain':
-        default:
-            return createPlainOutput(level, message, prefix, stackInfo);
-    }
-}
-
-/**
- * Creates plain text output for any environment
- * No colors, no styling - maximum compatibility
- */
-export function createPlainOutput(
-    level: LogLevel,
-    message: string,
-    prefix?: string,
-    stackInfo?: StackInfo | null
-): string {
-    const timestamp = formatTimestamp();
-    const timeStr = timestamp.slice(11, 23); // HH:MM:SS.mmm
-
-    let output = `[${timeStr}] [${level.toUpperCase()}]`;
-
-    if (prefix) {
-        output += ` [${prefix}]`;
-    }
-
-    output += ` ${message}`;
-
-    if (stackInfo) {
-        output += ` (${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`;
-    }
-
-    return output;
-}
-
-/**
- * Creates ANSI-colored output for terminals
- */
-export function createANSIOutput(
-    level: LogLevel,
-    message: string,
-    prefix?: string,
-    stackInfo?: StackInfo | null
-): string {
-    const timestamp = formatTimestamp();
-    const timeStr = timestamp.slice(11, 23);
-
-    let output = '';
-
-    // Timestamp
-    output += formatTimestampANSI(`[${timeStr}]`) + ' ';
-
-    // Log level with colors
-    output += formatLogLevelANSI(level) + ' ';
-
-    // Prefix if provided
-    if (prefix) {
-        output += formatPrefixANSI(prefix) + ' ';
-    }
-
-    // Message
-    output += message;
-
-    // Stack info if provided
-    if (stackInfo) {
-        output += ' ' + formatLocationANSI(`(${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`);
-    }
-
-    return sanitizeEmojis(output);
-}
-
-/**
- * Creates build-friendly output (optimized for Next.js builds, webpack, etc.)
- */
-export function createBuildOutput(
-    level: LogLevel,
-    message: string,
-    prefix?: string,
-    stackInfo?: StackInfo | null
-): string {
-    const timestamp = formatTimestamp();
-    const timeStr = timestamp.slice(11, 23);
-
-    let output = '';
-
-    // Use ANSI colors if supported
-    if (supportsANSIColors()) {
-        output += formatTimestampANSI(`[${timeStr}]`) + ' ';
-
-        // Use build-specific formatters
-        switch (level) {
-            case 'info':
-                output += BUILD_FORMATTERS.info(message);
-                break;
-            case 'warn':
-                output += BUILD_FORMATTERS.warning(message);
-                break;
-            case 'error':
-            case 'critical':
-                output += BUILD_FORMATTERS.error(message);
-                break;
-            default:
-                output += `${formatLogLevelANSI(level)} ${message}`;
-        }
-    } else {
-        // Fallback to plain text
-        output = `[${timeStr}] [${level.toUpperCase()}]`;
-
-        if (prefix) {
-            output += ` [${prefix}]`;
-        }
-
-        output += ` ${message}`;
-    }
-
-    if (stackInfo) {
-        output += ` (${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`;
-    }
-
-    return sanitizeEmojis(output);
-}
-
-/**
- * Creates CI-friendly output (no emojis, simple formatting)
- */
-export function createCIOutput(
-    level: LogLevel,
-    message: string,
-    prefix?: string,
-    stackInfo?: StackInfo | null
-): string {
-    const timestamp = formatTimestamp();
-    const timeStr = timestamp.slice(11, 23);
-
-    let output = `[${timeStr}] [${level.toUpperCase()}]`;
-
-    if (prefix) {
-        output += ` [${prefix}]`;
-    }
-
-    output += ` ${message}`;
-
-    if (stackInfo) {
-        output += ` (${stackInfo.file}:${stackInfo.line}:${stackInfo.column})`;
-    }
-
-    // Always remove emojis for CI
-    return sanitizeEmojis(output);
-}
-
-/**
- * Detects the optimal output format based on environment
- */
-export function detectOptimalFormat(): OutputFormat {
-    // Check for specific environment variables
-    const isCI = process.env.CI ||
-                 process.env.GITHUB_ACTIONS ||
-                 process.env.JENKINS_URL ||
-                 process.env.GITLAB_CI ||
-                 process.env.TRAVIS ||
-                 process.env.CIRCLECI;
-
-    const isBuild = process.env.NODE_ENV === 'production' ||
-                   process.env.BUILD_MODE === 'production' ||
-                   process.argv.some(arg => arg.includes('build') || arg.includes('webpack'));
-
-    const isNextJS = process.env.NEXT_RUNTIME ||
-                     process.argv.some(arg => arg.includes('next'));
-
-    // CI environment - always use plain text
-    if (isCI) {
-        return 'ci';
-    }
-
-    // Next.js build environment
-    if (isNextJS || isBuild) {
-        return 'build';
-    }
-
-    // Node.js with ANSI support
-    if (isNode && supportsANSIColors()) {
-        return 'ansi';
-    }
-
-    // Default to plain text
-    return 'plain';
-}
-
-/**
- * Gets the appropriate log method for the level
- * Uses different console methods for better semantics
- */
-export function getConsoleMethod(level: LogLevel): 'log' | 'info' | 'warn' | 'error' {
-    switch (level) {
-        case 'debug':
-            return 'log';
-        case 'info':
-            return 'info';
-        case 'warn':
-            return 'warn';
-        case 'error':
-        case 'critical':
-            return 'error';
-        default:
-            return 'log';
-    }
-}
-
-/**
- * Create a simple log entry object for handlers
- */
-export function createLogEntry(
-    level: LogLevel,
-    message: string,
-    args: any[],
-    prefix?: string,
-    stackInfo?: StackInfo | null
-) {
-    return {
-        timestamp: formatTimestamp(),
-        level: level.toUpperCase(),
-        prefix,
-        message,
-        args: args.slice(1), // Exclude the first message argument
-        location: stackInfo ? {
-            file: stackInfo.file,
-            line: stackInfo.line,
-            column: stackInfo.column,
-            function: stackInfo.function
-        } : undefined,
-        raw: args
-    };
-}
-
-/**
- * Format data for table display in plain text
- */
-export function formatTablePlain(data: any, columns?: string[]): string {
-    try {
-        if (Array.isArray(data)) {
-            if (data.length === 0) return '[Empty Array]';
-            
-            // Simple array formatting
-            if (typeof data[0] !== 'object') {
-                return data.map((item, i) => `${i}: ${item}`).join('\n');
-            }
-            
-            // Object array formatting
-            const keys = columns || Object.keys(data[0] || {});
-            const header = keys.join('\t');
-            const rows = data.map(item => 
-                keys.map(key => String(item[key] || '')).join('\t')
-            );
-            
-            return [header, ...rows].join('\n');
-        }
-        
-        if (typeof data === 'object' && data !== null) {
-            // Simple object formatting
-            return Object.entries(data)
-                .map(([key, value]) => `${key}: ${value}`)
-                .join('\n');
-        }
-        
-        return String(data);
-    } catch (error) {
-        return `[Error formatting table: ${error}]`;
-    }
-}
-
-/**
- * Safe object serialization for logging
- */
-export function safeSerialize(obj: any, maxDepth: number = 3, currentDepth: number = 0): any {
-    if (currentDepth >= maxDepth) {
-        return '[Max Depth Reached]';
-    }
-    
-    if (obj === null) return null;
-    if (obj === undefined) return '[undefined]';
-    if (typeof obj === 'function') return '[Function]';
-    if (obj instanceof Error) return `[Error: ${obj.message}]`;
-    if (obj instanceof Date) return obj.toISOString();
-    if (typeof obj !== 'object') return obj;
-    
-    if (Array.isArray(obj)) {
-        return obj.map(item => safeSerialize(item, maxDepth, currentDepth + 1));
-    }
-    
-    const result: any = {};
-    for (const [key, value] of Object.entries(obj)) {
-        result[key] = safeSerialize(value, maxDepth, currentDepth + 1);
-    }
-    return result;
-}

package/src/utils/index.ts

@@ -1,33 +0,0 @@
-/**
- * @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,
-    detectDevToolsTheme,
-    getAdaptiveColor,
-    setupThemeChangeListener,
-    type LevelStyleConfig
-} from './output.js';
-export {
-    createPlainOutput,
-    createOutput,
-    createANSIOutput,
-    createBuildOutput,
-    createCIOutput,
-    detectOptimalFormat,
-    getConsoleMethod,
-    createLogEntry,
-    formatTablePlain,
-    safeSerialize
-} from './formatting.js';