@mks2508/better-logger 0.14.0-alpha.2 → 1.1.0

package/dist/types/utils/output.d.ts

@@ -1,41 +0,0 @@
-import { LogLevel, StackInfo, DevToolsTheme, AdaptiveColors } from '../types/index.js';
-/**
- * Style configuration for each log level
- */
-export interface LevelStyleConfig {
-    emoji: string;
-    label: string;
-    background: string;
-    color: string;
-    border: string;
-    shadow: string;
-}
-/**
- * Detects the current DevTools theme preference
- */
-export declare function detectDevToolsTheme(): DevToolsTheme;
-/**
- * Gets adaptive color based on current DevTools theme
- */
-export declare function getAdaptiveColor(colors: AdaptiveColors, theme?: DevToolsTheme): string;
-/**
- * Sets up theme change listener for dynamic updates
- */
-export declare function setupThemeChangeListener(callback: (theme: DevToolsTheme) => void): (() => void) | null;
-/**
- * Creates styled console output with multiple %c formatters
- */
-export declare function createStyledOutput(level: LogLevel, levelStyles: Record<LogLevel | 'success', LevelStyleConfig>, prefix: string | undefined, message: string, stackInfo: StackInfo | null, autoDetectTheme?: boolean): [string, ...string[]];
-/**
- * Create a unique ID for log entries
- */
-export declare function generateLogId(): string;
-/**
- * Escape HTML entities for safe HTML output
- */
-export declare function escapeHtml(text: string): string;
-/**
- * Convert objects to safe string representation for logging
- */
-export declare function safeStringify(obj: any, _maxDepth?: number): string;
-//# sourceMappingURL=output.d.ts.map

package/dist/types/utils/output.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/utils/output.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAK5F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAYnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,aAAa,GAAG,MAAM,CAGtF;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAyBtG;AAGD;;GAEG;AACH,wBAAgB,kBAAkB,CAC9B,KAAK,EAAE,QAAQ,EACf,WAAW,EAAE,MAAM,CAAC,QAAQ,GAAG,SAAS,EAAE,gBAAgB,CAAC,EAC3D,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,SAAS,GAAG,IAAI,EAC3B,eAAe,GAAE,OAAc,GAChC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAgEvB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAI/C;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,SAAS,SAAI,GAAG,MAAM,CAY7D"}

package/dist/types/utils/stackTrace.d.ts

@@ -1,6 +0,0 @@
-import { StackInfo } from '../types/index.js';
-/**
- * Parses the current stack trace to extract caller information
- */
-export declare function parseStackTrace(): StackInfo | null;
-//# sourceMappingURL=stackTrace.d.ts.map

package/dist/types/utils/stackTrace.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stackTrace.d.ts","sourceRoot":"","sources":["../../../src/utils/stackTrace.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;GAEG;AACH,wBAAgB,eAAe,IAAI,SAAS,GAAG,IAAI,CAqFlD"}

package/dist/types/utils/timestamps.d.ts

@@ -1,20 +0,0 @@
-/**
- * @fileoverview Timestamp utilities for Advanced Logger
- */
-/**
- * Formats the timestamp using modern Date API
- */
-export declare function formatTimestamp(): string;
-/**
- * Parse relative time strings like "2h", "30m", "1d" into milliseconds
- */
-export declare function parseRelativeTime(timeStr: string): number;
-/**
- * Parse time input which can be Date, ISO string, or relative time
- */
-export declare function parseTimeInput(input: Date | string | number): Date;
-/**
- * Format timestamp for display in different contexts
- */
-export declare function formatDisplayTime(date: Date, format?: 'short' | 'full' | 'time-only'): string;
-//# sourceMappingURL=timestamps.d.ts.map

package/dist/types/utils/timestamps.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"timestamps.d.ts","sourceRoot":"","sources":["../../../src/utils/timestamps.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAQxC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CA2BlE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,GAAE,OAAO,GAAG,MAAM,GAAG,WAAqB,GAAG,MAAM,CAUtG"}

package/dist/utils/environment.js

@@ -1,85 +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.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() {
-    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() {
-    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() {
-    return isBrowser;
-}
-/**
- * Checks if ANSI colors are supported (terminal environments)
- */
-export function supportsANSIColors() {
-    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/dist/utils/formatting.js

@@ -1,117 +0,0 @@
-/**
- * @fileoverview Formatting utilities for Universal Logger
- */
-import { formatTimestamp } from './timestamps.js';
-/**
- * Creates plain text output for any environment
- * No colors, no styling - maximum compatibility
- */
-export function createPlainOutput(level, message, prefix, stackInfo) {
-    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;
-}
-/**
- * Gets the appropriate log method for the level
- * Uses different console methods for better semantics
- */
-export function getConsoleMethod(level) {
-    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, message, args, prefix, stackInfo) {
-    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, columns) {
-    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, maxDepth = 3, currentDepth = 0) {
-    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 = {};
-    for (const [key, value] of Object.entries(obj)) {
-        result[key] = safeSerialize(value, maxDepth, currentDepth + 1);
-    }
-    return result;
-}

package/dist/utils/index.js

@@ -1,6 +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 } from './output.js';

package/dist/utils/opentui-detection.js

@@ -1,116 +0,0 @@
-/**
- * @fileoverview OpenTUI detection and enhancement utilities for core logger
- */
-import { isNode } from './environment.js';
-/**
- * Check if OpenTUI packages are available
- */
-export async function hasOpenTUI() {
-    if (!isNode) {
-        return false; // OpenTUI is Node.js only
-    }
-    try {
-        // Try to dynamically import OpenTUI core
-        // @ts-expect-error - Optional dependency, may not be installed
-        await import('@opentui/core');
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
-}
-/**
- * Check if OpenTUI enhancement package is available
- */
-export async function hasOpenTUILogHandler() {
-    if (!isNode) {
-        return false;
-    }
-    try {
-        // @ts-expect-error - Optional dependency, may not be installed
-        await import('@mks2508/better-logger-nodejs-opentui');
-        return true;
-    }
-    catch (error) {
-        return false;
-    }
-}
-/**
- * Dynamically enhance logger with OpenTUI if available
- */
-export async function tryEnhanceWithOpenTUI(logger) {
-    try {
-        // Check if both OpenTUI and our enhancement package are available
-        const [hasCore, hasEnhancer] = await Promise.all([
-            hasOpenTUI(),
-            hasOpenTUILogHandler()
-        ]);
-        if (!hasCore || !hasEnhancer) {
-            return false;
-        }
-        // Dynamically import and apply enhancement
-        // @ts-expect-error - Optional dependency, may not be installed
-        const { enhanceLoggerWithOpenTUI } = await import('@mks2508/better-logger-nodejs-opentui');
-        const enhanced = await enhanceLoggerWithOpenTUI(logger, {
-            renderer: {
-                animated: true,
-                theme: 'auto',
-                components: {
-                    badges: true,
-                    progressBars: false,
-                    tables: false,
-                    charts: false
-                }
-            }
-        });
-        return enhanced;
-    }
-    catch (error) {
-        console.warn('Failed to enhance logger with OpenTUI:', error);
-        return false;
-    }
-}
-/**
- * Get OpenTUI environment information
- */
-export async function getOpenTUIInfo() {
-    const [coreAvailable, handlerAvailable] = await Promise.all([
-        hasOpenTUI(),
-        hasOpenTUILogHandler()
-    ]);
-    return {
-        available: coreAvailable && handlerAvailable,
-        coreAvailable,
-        handlerAvailable,
-        nodeVersion: isNode ? process.version : null,
-        terminalSupport: isNode ? process.stdout?.isTTY === true : false
-    };
-}
-/**
- * Auto-enhance logger with best available rendering
- */
-export async function autoEnhanceLogger(logger) {
-    // Try OpenTUI first
-    const openTUIEnhanced = await tryEnhanceWithOpenTUI(logger);
-    if (openTUIEnhanced) {
-        return {
-            enhanced: true,
-            method: 'opentui',
-            info: await getOpenTUIInfo()
-        };
-    }
-    // Fallback to ANSI colors if in Node.js
-    if (isNode && process.stdout?.isTTY) {
-        return {
-            enhanced: false,
-            method: 'ansi',
-            info: { reason: 'OpenTUI not available, using ANSI colors' }
-        };
-    }
-    // Plain text fallback
-    return {
-        enhanced: false,
-        method: 'plain',
-        info: { reason: 'No enhanced rendering available' }
-    };
-}

package/dist/utils/output.js

@@ -1,150 +0,0 @@
-/**
- * @fileoverview Styled output creation utilities for Advanced Logger
- */
-import { formatTimestamp } from './timestamps.js';
-import { StyleBuilder } from '../styling/index.js';
-import { ADAPTIVE_COLORS } from '../constants.js';
-/**
- * Detects the current DevTools theme preference
- */
-export function detectDevToolsTheme() {
-    try {
-        if (typeof window === 'undefined' || !window.matchMedia) {
-            return 'light'; // Safe fallback for SSR or older browsers
-        }
-        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
-        return mediaQuery.matches ? 'dark' : 'light';
-    }
-    catch (error) {
-        console.warn('Failed to detect DevTools theme:', error);
-        return 'light'; // Fallback to light theme
-    }
-}
-/**
- * Gets adaptive color based on current DevTools theme
- */
-export function getAdaptiveColor(colors, theme) {
-    const currentTheme = theme ?? detectDevToolsTheme();
-    return colors[currentTheme];
-}
-/**
- * Sets up theme change listener for dynamic updates
- */
-export function setupThemeChangeListener(callback) {
-    try {
-        if (typeof window === 'undefined' || !window.matchMedia) {
-            return null;
-        }
-        const mediaQuery = window.matchMedia('(prefers-color-scheme: dark)');
-        const handler = (e) => {
-            callback(e.matches ? 'dark' : 'light');
-        };
-        // Use newer addEventListener if available, fallback to addListener
-        if (mediaQuery.addEventListener) {
-            mediaQuery.addEventListener('change', handler);
-            return () => mediaQuery.removeEventListener('change', handler);
-        }
-        else if (mediaQuery.addListener) {
-            mediaQuery.addListener(handler);
-            return () => mediaQuery.removeListener?.(handler);
-        }
-        return null;
-    }
-    catch (error) {
-        console.warn('Failed to set up theme change listener:', error);
-        return null;
-    }
-}
-/**
- * Creates styled console output with multiple %c formatters
- */
-export function createStyledOutput(level, levelStyles, prefix, message, stackInfo, autoDetectTheme = true) {
-    const levelConfig = levelStyles[level];
-    const timestamp = formatTimestamp();
-    const currentTheme = autoDetectTheme ? detectDevToolsTheme() : 'light';
-    // Base styles with adaptive colors
-    const timestampStyle = new StyleBuilder()
-        .color(getAdaptiveColor(ADAPTIVE_COLORS.timestamp, currentTheme))
-        .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(getAdaptiveColor(ADAPTIVE_COLORS.prefixBackground, currentTheme))
-        .color(getAdaptiveColor(ADAPTIVE_COLORS.prefix, currentTheme))
-        .padding('2px 6px')
-        .rounded('3px')
-        .bold()
-        .font('Monaco, Consolas, monospace')
-        .size('11px')
-        .build();
-    const messageStyle = new StyleBuilder()
-        .color(getAdaptiveColor(ADAPTIVE_COLORS.messageText, currentTheme))
-        .font('system-ui, -apple-system, sans-serif')
-        .size('14px')
-        .build();
-    const locationStyle = new StyleBuilder()
-        .color(getAdaptiveColor(ADAPTIVE_COLORS.location, currentTheme))
-        .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() {
-    return `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
-}
-/**
- * Escape HTML entities for safe HTML output
- */
-export function escapeHtml(text) {
-    const div = document.createElement('div');
-    div.textContent = text;
-    return div.innerHTML;
-}
-/**
- * Convert objects to safe string representation for logging
- */
-export function safeStringify(obj, _maxDepth = 3) {
-    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/dist/utils/stackTrace.js

@@ -1,81 +0,0 @@
-/**
- * @fileoverview Stack trace parsing utilities for Advanced Logger
- */
-/**
- * Parses the current stack trace to extract caller information
- */
-export function parseStackTrace() {
-    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];
-            if (!line) {
-                continue;
-            }
-            // 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) {
-                continue;
-            }
-            const [, functionName, file, lineStr, columnStr] = match;
-            if (!file) {
-                continue;
-            }
-            // Process file path - remove query params and get filename
-            const fileParts = file.split('/');
-            const fileName = fileParts[fileParts.length - 1];
-            if (!fileName) {
-                continue;
-            }
-            const cleanFileName = fileName.split('?')[0];
-            // Parse line and column numbers
-            const lineNum = lineStr ? parseInt(lineStr, 10) : 0;
-            const columnNum = columnStr ? parseInt(columnStr, 10) : 0;
-            // Clean function name
-            const cleanFunction = functionName && functionName.trim()
-                ? functionName.trim()
-                : undefined;
-            return {
-                file: cleanFileName ? cleanFileName : 'unknown',
-                line: lineNum,
-                column: columnNum,
-                function: cleanFunction
-            };
-        }
-        return null;
-    }
-    catch {
-        return null;
-    }
-}