@mks2508/better-logger 0.14.0-alpha.2 → 0.18.2-alpha.1

package/packages/core/package.json

@@ -1,57 +0,0 @@
-{
-  "name": "@mks2508/better-logger-core",
-  "version": "0.14.0-alpha.1",
-  "type": "module",
-  "description": "Universal core logging functionality for Better Logger - Works in both Node.js and browser environments",
-  "main": "dist/index.cjs",
-  "module": "dist/index.js",
-  "browser": "dist/index.umd.js",
-  "types": "dist/types/core.d.ts",
-  "exports": {
-    ".": {
-      "node": {
-        "import": "./dist/index.js",
-        "require": "./dist/index.cjs"
-      },
-      "browser": {
-        "import": "./dist/index.js",
-        "require": "./dist/index.umd.js"
-      },
-      "default": "./dist/index.js"
-    },
-    "./package.json": "./package.json"
-  },
-  "keywords": [
-    "logger",
-    "console",
-    "core",
-    "typescript",
-    "browser",
-    "nodejs",
-    "universal",
-    "debug",
-    "isomorphic"
-  ],
-  "author": "MKS2508",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MKS2508/advanced-logger.git",
-    "directory": "packages/core"
-  },
-  "bugs": {
-    "url": "https://github.com/MKS2508/advanced-logger/issues"
-  },
-  "homepage": "https://mks2508.github.io/advanced-logger/",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=14.0.0"
-  }
-}

package/packages/exports/package.json

@@ -1,41 +0,0 @@
-{
-  "name": "@mks2508/better-logger-exports",
-  "version": "0.14.0-alpha.1",
-  "type": "module",
-  "description": "Export handlers for Better Logger - File, Remote, Analytics and custom log destinations",
-  "main": "dist/index.js",
-  "types": "dist/types/exports-module.d.ts",
-  "keywords": [
-    "logger",
-    "console",
-    "exports",
-    "handlers",
-    "file",
-    "remote",
-    "analytics",
-    "typescript",
-    "browser"
-  ],
-  "author": "MKS2508",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MKS2508/advanced-logger.git",
-    "directory": "packages/exports"
-  },
-  "bugs": {
-    "url": "https://github.com/MKS2508/advanced-logger/issues"
-  },
-  "homepage": "https://mks2508.github.io/advanced-logger/",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "peerDependencies": {
-    "@mks2508/better-logger-core": "^0.14.0-alpha.1"
-  }
-}

package/packages/nodejs-opentui/README.md

@@ -1,232 +0,0 @@
-# @mks2508/better-logger-nodejs-opentui
-
-Rich terminal logging with OpenTUI - Enhanced Tier 2 Package
-
-## Overview
-
-This package extends the Advanced Logger with [OpenTUI](https://github.com/sst/opentui) capabilities, providing beautiful, interactive terminal user interfaces for your logs. While OpenTUI is still experimental, it offers cutting-edge terminal UI features that transform console logging into rich visual experiences.
-
-## Features
-
-- 🎨 **Rich Visual Components**: Beautiful badges, styled text, and visual elements
-- ⚡ **Performance**: Built on OpenTUI's high-performance rendering engine
-- 🔧 **Easy Integration**: Drop-in enhancement for existing loggers
-- 🎯 **Tier 2 Enhanced**: Focused on essential rich logging without complexity
-- 📱 **Auto-fallback**: Gracefully falls back to standard logging if OpenTUI unavailable
-
-## Installation
-
-```bash
-npm install @mks2508/better-logger-nodejs-opentui
-```
-
-**Dependencies:**
-- `@opentui/core ^0.1.2`
-- `@opentui/react ^0.1.2` (for future components)
-- `@mks2508/better-logger-core ^0.12.0` (peer dependency)
-
-## Quick Start
-
-### Option 1: Quick Setup (Recommended)
-
-```typescript
-import { quickSetup } from '@mks2508/better-logger-nodejs-opentui';
-
-// One line setup - enhances default logger
-const logger = await quickSetup();
-
-logger?.info('🚀 OpenTUI enhanced logging is ready!');
-logger?.warn('⚠️ This will look amazing in terminal');
-logger?.error('❌ Rich error display with badges');
-logger?.critical('🚨 Critical alerts with animations');
-```
-
-### Option 2: Manual Integration
-
-```typescript
-import logger from '@mks2508/better-logger-core';
-import { createOpenTUILogger } from '@mks2508/better-logger-nodejs-opentui';
-
-// Create and add OpenTUI handler
-const openTUIHandler = await createOpenTUILogger({
-  renderer: {
-    animated: true,
-    theme: 'auto',
-    components: {
-      badges: true
-    }
-  }
-});
-
-if (openTUIHandler) {
-  logger.addHandler(openTUIHandler);
-  logger.info('Rich terminal logging enabled!');
-} else {
-  logger.info('Fallback to standard logging');
-}
-```
-
-### Option 3: Enhance Existing Logger
-
-```typescript
-import { enhanceLoggerWithOpenTUI } from '@mks2508/better-logger-nodejs-opentui';
-import myLogger from './my-logger';
-
-// Enhance any logger that has addHandler method
-const enhanced = await enhanceLoggerWithOpenTUI(myLogger, {
-  renderer: { animated: true, theme: 'dark' }
-});
-
-if (enhanced) {
-  myLogger.info('Now with OpenTUI superpowers! 💫');
-}
-```
-
-## Configuration
-
-### OpenTUIRendererOptions
-
-```typescript
-interface OpenTUIRendererOptions {
-  interactive?: boolean;     // false (Tier 2 - basic for now)
-  animated?: boolean;        // true - Enable animations
-  theme?: 'light' | 'dark' | 'auto'; // 'auto' - Adapt to terminal
-  dashboard?: boolean;       // false (reserved for Tier 3)
-  maxHistory?: number;       // 100 - Max log entries to keep
-  components?: {
-    badges?: boolean;        // true - Show level badges
-    progressBars?: boolean;  // false (Tier 2 - keeping simple)
-    tables?: boolean;        // false (Tier 2)
-    charts?: boolean;        // false (Tier 2)
-  };
-}
-```
-
-### Examples
-
-**Animated Logging:**
-```typescript
-const handler = await createOpenTUILogger({
-  renderer: {
-    animated: true,
-    theme: 'dark'
-  }
-});
-
-logger.addHandler(handler);
-
-logger.critical('🚨 This badge pulses with animation!');
-logger.error('❌ Error badges shake to grab attention');
-logger.warn('⚠️ Warning badges pulse subtly');
-```
-
-**Scoped Logging with Prefixes:**
-```typescript
-const apiLogger = logger.scope('API');
-const dbLogger = logger.scope('DATABASE');
-
-apiLogger.info('Request started');    // [ℹ️ INFO] [API] Request started
-dbLogger.error('Connection failed');  // [❌ ERROR] [DATABASE] Connection failed
-```
-
-## Visual Features
-
-### Log Level Badges
-
-Each log level gets a distinctive badge with icon and styling:
-
-- 🔍 **DEBUG** - Gray badge, subtle
-- ℹ️ **INFO** - Blue badge, informative  
-- ⚠️ **WARN** - Yellow badge, pulses
-- ❌ **ERROR** - Red badge, shakes
-- 🚨 **CRITICAL** - Dark red badge, strong pulse
-
-### Animations (Tier 2)
-
-- **Pulse**: Warning and critical levels
-- **Shake**: Error level for attention
-- **None**: Debug and info for clean output
-
-### Auto-Fallback
-
-If OpenTUI is not available, the handler automatically falls back to enhanced plain text:
-
-```
-[10:30:45] 🚨 [CRITICAL] [API] Database connection lost
-[10:30:46] ❌ [ERROR] [AUTH] Login failed for user@example.com
-    at AuthService.validateUser (auth.js:45:12)
-```
-
-## API Reference
-
-### Classes
-
-- **`OpenTUILogHandler`** - Main log handler implementing `ILogHandler`
-- **`OpenTUILogRenderer`** - Core rendering engine using OpenTUI
-
-### Functions
-
-- **`createOpenTUILogger(config?)`** - Factory function for handlers
-- **`enhanceLoggerWithOpenTUI(logger, config?)`** - Enhance existing logger
-- **`quickSetup()`** - One-line setup for default logger
-- **`isOpenTUIAvailable()`** - Check if OpenTUI is available
-
-### Types
-
-All TypeScript interfaces are exported for custom implementations:
-- `OpenTUILogEntry`, `OpenTUIRendererOptions`, `LogComponentStyle`, etc.
-
-## Performance
-
-- **Graceful Degradation**: Zero impact if OpenTUI unavailable
-- **Efficient Rendering**: Leverages OpenTUI's optimized terminal rendering
-- **Memory Management**: Configurable log history limits
-- **Fast Fallback**: Instant fallback to console logging if needed
-
-## Troubleshooting
-
-### OpenTUI Not Available
-
-If you see "OpenTUI not available, falling back to standard logging":
-
-1. **Check Installation**: Ensure `@opentui/core` is installed
-2. **Node Version**: Requires Node.js ≥16.0.0
-3. **Terminal Support**: Some terminals may not fully support OpenTUI features
-4. **Permissions**: Ensure terminal has proper rendering permissions
-
-### Debugging
-
-```typescript
-// Check handler status
-const handler = await createOpenTUILogger();
-console.log('Handler stats:', handler?.getStats());
-
-// Enable debug logging
-process.env.DEBUG = 'opentui:*';
-```
-
-## Roadmap
-
-### Current: Tier 2 Enhanced ✅
-- Rich badges with icons and animations
-- Auto-fallback to plain text
-- Basic OpenTUI integration
-
-### Future: Tier 3 Interactive
-- Live dashboard with filtering
-- Real-time log statistics
-- Interactive components (click, select)
-- Progress bars and charts
-- 3D log visualizations
-
-## Contributing
-
-This package is part of the Advanced Logger ecosystem. See the main repository for contributing guidelines.
-
-## License
-
-MIT - See LICENSE file for details
-
----
-
-**Note**: OpenTUI is experimental and not production-ready. This package provides fallback mechanisms to ensure reliability in all environments.

package/packages/nodejs-opentui/package.json

@@ -1,72 +0,0 @@
-{
-  "name": "@mks2508/better-logger-nodejs-opentui",
-  "version": "0.1.0",
-  "type": "module",
-  "description": "OpenTUI-powered rich terminal logging with interactive components and animations",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
-  "types": "dist/types/index.d.ts",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/types/index.d.ts"
-    },
-    "./components": {
-      "import": "./dist/components.js", 
-      "types": "./dist/types/components.d.ts"
-    },
-    "./package.json": "./package.json"
-  },
-  "keywords": [
-    "logger",
-    "terminal",
-    "tui",
-    "opentui",
-    "interactive",
-    "animated",
-    "console",
-    "nodejs",
-    "rich-logging",
-    "dashboard"
-  ],
-  "author": "MKS2508",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MKS2508/advanced-logger.git",
-    "directory": "packages/nodejs-opentui"
-  },
-  "bugs": {
-    "url": "https://github.com/MKS2508/advanced-logger/issues"
-  },
-  "homepage": "https://mks2508.github.io/advanced-logger/",
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "dependencies": {
-    "@opentui/core": "^0.1.2",
-    "@opentui/react": "^0.1.2"
-  },
-  "devDependencies": {
-    "@types/react": "^18.0.0",
-    "react": "^18.0.0"
-  },
-  "peerDependencies": {
-    "@mks2508/better-logger-core": "^0.12.0"
-  },
-  "scripts": {
-    "build": "tsc && npm run build:rollup",
-    "build:rollup": "echo 'Rollup build placeholder'",
-    "dev": "tsc --watch",
-    "clean": "rm -rf dist",
-    "type-check": "tsc --noEmit"
-  }
-}

package/packages/nodejs-opentui/src/LogRenderer.ts

@@ -1,171 +0,0 @@
-/**
- * @fileoverview Basic OpenTUI log renderer for enhanced terminal logging
- */
-
-import { createCliRenderer, TextRenderable, type Renderable } from '@opentui/core';
-import type { LogLevel } from '@mks2508/better-logger-core';
-import type { OpenTUILogEntry, OpenTUIRendererOptions } from './types.js';
-
-/**
- * Simple OpenTUI log renderer - Tier 2 Enhanced
- */
-export class OpenTUILogRenderer {
-    private renderer: any;
-    private initialized = false;
-    private logHistory: OpenTUILogEntry[] = [];
-    private options: Required<OpenTUIRendererOptions>;
-
-    constructor(options: OpenTUIRendererOptions = {}) {
-        this.options = {
-            interactive: false, // Tier 2: Basic for now
-            animated: true,
-            theme: 'auto',
-            dashboard: false, // Save for Tier 3
-            maxHistory: 100,
-            components: {
-                badges: true,
-                progressBars: false, // Tier 2: Keep simple
-                tables: false,
-                charts: false
-            }
-        };
-        
-        Object.assign(this.options, options);
-    }
-
-    /**
-     * Initialize the OpenTUI renderer
-     */
-    async initialize(): Promise<void> {
-        if (this.initialized) return;
-        
-        try {
-            this.renderer = await createCliRenderer();
-            this.initialized = true;
-        } catch (error) {
-            console.warn('OpenTUI not available, falling back to standard logging');
-            this.initialized = false;
-        }
-    }
-
-    /**
-     * Check if OpenTUI is available and initialized
-     */
-    isAvailable(): boolean {
-        return this.initialized;
-    }
-
-    /**
-     * Render a log entry using OpenTUI
-     */
-    async renderLog(entry: OpenTUILogEntry): Promise<void> {
-        if (!this.initialized) {
-            await this.initialize();
-        }
-        
-        if (!this.isAvailable()) {
-            // Fallback to simple console output
-            this.renderFallback(entry);
-            return;
-        }
-
-        // Add to history
-        this.logHistory.push(entry);
-        if (this.logHistory.length > this.options.maxHistory) {
-            this.logHistory.shift();
-        }
-
-        // Create basic styled output
-        const logRenderable = this.createLogRenderable(entry);
-        this.renderer.root.add(logRenderable);
-    }
-
-    /**
-     * Create OpenTUI renderable for log entry
-     */
-    private createLogRenderable(entry: OpenTUILogEntry): Renderable {
-        const levelColor = this.getLevelColor(entry.level);
-        const levelIcon = this.getLevelIcon(entry.level);
-        
-        // Simple badge + message format for Tier 2
-        const badgeText = `${levelIcon} ${entry.level.toUpperCase()}`;
-        const fullMessage = entry.prefix 
-            ? `[${badgeText}] [${entry.prefix}] ${entry.message}`
-            : `[${badgeText}] ${entry.message}`;
-
-        return new TextRenderable(`log-${entry.id}`, {
-            content: fullMessage,
-            style: {
-                color: levelColor,
-                ...(entry.level === 'critical' && { 
-                    fontWeight: 'bold',
-                    textShadow: `0 0 5px ${levelColor}`
-                })
-            }
-        });
-    }
-
-    /**
-     * Get color for log level
-     */
-    private getLevelColor(level: LogLevel): string {
-        const colors: Record<LogLevel, string> = {
-            debug: '#6c757d',
-            info: '#007bff', 
-            warn: '#ffc107',
-            error: '#dc3545',
-            critical: '#8B0000'
-        };
-        return colors[level];
-    }
-
-    /**
-     * Get icon for log level
-     */
-    private getLevelIcon(level: LogLevel): string {
-        const icons: Record<LogLevel, string> = {
-            debug: '🔍',
-            info: 'ℹ️',
-            warn: '⚠️',
-            error: '❌',
-            critical: '🚨'
-        };
-        return icons[level];
-    }
-
-    /**
-     * Fallback rendering when OpenTUI is not available
-     */
-    private renderFallback(entry: OpenTUILogEntry): void {
-        const icon = this.getLevelIcon(entry.level);
-        const timestamp = entry.timestamp.slice(11, 23);
-        const prefix = entry.prefix ? ` [${entry.prefix}]` : '';
-        
-        console.log(`[${timestamp}] ${icon} [${entry.level.toUpperCase()}]${prefix} ${entry.message}`);
-    }
-
-    /**
-     * Get log history
-     */
-    getHistory(): OpenTUILogEntry[] {
-        return [...this.logHistory];
-    }
-
-    /**
-     * Clear log history
-     */
-    clearHistory(): void {
-        this.logHistory = [];
-    }
-
-    /**
-     * Cleanup resources
-     */
-    destroy(): void {
-        if (this.renderer) {
-            // Cleanup renderer if needed
-            this.renderer = null;
-        }
-        this.initialized = false;
-    }
-}