@mks2508/better-logger 5.0.0 → 5.0.2

package/CHANGELOG.md

@@ -1,209 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [3.0.0] - 2024-12-28
-
-### 💥 Breaking Changes
-- `ScopedLogger` ya no hereda de `Logger` - usa delegación para ~50-100x menos memoria
-- Métodos `component()`, `api()`, `scope()` ahora son síncronos (antes devolvían Promise)
-- `LogEntry` de hooks renombrado a `HookLogEntry` para evitar conflicto con handlers
-
-### ✨ Features
-
-#### Custom Serializers
-Sistema de serialización extensible para objetos personalizados:
-```typescript
-logger.addSerializer(Error, (err) => ({
-  name: err.name,
-  message: err.message,
-  stack: err.stack?.split('\n').slice(0, 5)
-}));
-
-logger.addSerializer(User, (user) => ({
-  id: user.id,
-  email: user.email  // password omitido por seguridad
-}));
-```
-
-#### Hooks & Middleware
-Sistema de eventos y middleware para interceptar logs:
-```typescript
-// Hooks
-logger.on('beforeLog', (entry) => {
-  entry.correlationId = getCorrelationId();
-  return entry;
-});
-
-logger.on('afterLog', (entry) => {
-  metrics.increment(`logs.${entry.level}`);
-});
-
-// Middleware
-logger.use((entry, next) => {
-  entry.requestId = asyncLocalStorage.getStore()?.requestId;
-  next();
-});
-```
-
-#### Transports System
-Sistema de transports similar a Pino para envío de logs:
-```typescript
-// File transport
-logger.addTransport({
-  target: 'file',
-  options: { destination: '/var/log/app.log' }
-});
-
-// HTTP transport con batching
-logger.addTransport({
-  target: 'http',
-  options: {
-    url: 'https://logs.example.com',
-    batchSize: 100,
-    flushInterval: 5000
-  },
-  level: 'warn'
-});
-
-// Custom transport
-logger.addTransport({
-  target: {
-    name: 'elasticsearch',
-    write: async (record) => {
-      await esClient.index({ index: 'logs', body: record });
-    }
-  }
-});
-```
-
-#### Badges System
-Sistema de badges para etiquetar logs:
-```typescript
-logger.badges(['v3', 'stable']).info('Release publicado');
-logger.badge('DEBUG').info('Modo debug activo');
-logger.clearBadges();
-```
-
-#### Interface Bindings
-Nueva interfaz `Bindings` para contexto de logs:
-```typescript
-interface Bindings {
-  scope?: string;
-  badges?: string[];
-  context?: Record<string, any>;
-}
-```
-
-### 🚀 Performance
-- **~50-100x menos memoria** en child loggers (delegación vs herencia)
-- **~10-20x más rápido** creación de child loggers
-- **Style Cache** con LRU y TTL para estilos computados
-- Serialización automática con detección de tipos
-
-### 📦 New Exports
-```typescript
-// Classes
-export { SerializerRegistry, HookManager, TransportManager };
-export { ConsoleTransport, FileTransport, HttpTransport };
-export { StyleCache, getStyleCache };
-
-// Types
-export type { SerializerFn, SerializerContext, ISerializerRegistry };
-export type { HookLogEntry, HookEvent, HookCallback, MiddlewareFn, IHookManager };
-export type { TransportRecord, TransportTarget, ITransport, StyleCacheConfig };
-```
-
----
-
-## [2.0.0] - 2024-12-20
-
-### ✨ Features
-- **ScopedLogger con delegación**: Arquitectura ligera sin herencia
-- **Métodos síncronos**: `component()`, `api()`, `scope()` ya no son async
-- **logWithBindings()**: Método para logging con contexto de bindings
-
-### 🔧 Internal
-- Refactorizado sistema de child loggers para mejor performance
-- Reducido footprint de memoria en aplicaciones con muchos loggers
-
----
-
-## [1.2.0] - 2024-10-28
-
-### ✨ Added
-- **🌟 Dual Environment Support**: Automatic detection and adaptation between browser and terminal environments
-- **🎨 ANSI Color Support**: Full terminal color support using ANSI escape sequences
-- **🖥️ Terminal Renderer**: Dedicated rendering engine for terminal/servers with optimized formatting
-- **🔄 Smart Adapter System**: Converts CSS-based styles to ANSI formatting automatically
-- **🔍 Environment Detection**: Robust detection of browser, terminal, server, and Node.js environments
-- **📱 All Presets Adapted**: All existing presets (cyberpunk, production, minimal, debug, glassmorphism) now work in terminal
-- **⚡ Performance Optimized**: Zero configuration required - automatic adaptation based on environment
-
-### 🔧 Technical Changes
-- **New Modules**:
-  - `src/terminal/terminal-renderer.ts` - ANSI rendering engine
-  - `src/utils/environment-detector.ts` - Environment detection system
-  - `src/utils/adapter.ts` - CSS to ANSI adapter
-- **Enhanced Core**:
-  - Updated `createStyledOutput()` to support dual rendering
-  - Modified Logger class to pass preset information to terminal renderer
-  - Added smart preset message handling (verbose logs only in browser)
-
-### 🎯 Features
-- **Automatic Environment Detection**: Detects browser vs terminal vs server automatically
-- **Seamless Presets**: Same presets work in both environments with appropriate styling
-- **Color Capability Detection**: Supports full color, basic 16-color, and no-color modes
-- **Terminal Optimized**: Cyberpunk preset with vibrant ANSI colors in terminal
-- **Clean Production Logs**: Professional formatting optimized for server logs
-
-### 📚 Enhanced Documentation
-- Updated package.json with new keywords: terminal, ansi, chalk, server, nodejs
-- Enhanced description highlighting dual environment support
-
-## [1.2.1] - 2024-10-28
-
-### 🔧 Fixes
-- **Enhanced Domain Badges**: Domain/scope now displays as proper badges with background color (e.g., `[CONNECTION]` instead of plain text)
-- **Improved Stack Trace**: Better filtering of minified/bundle files to show TypeScript source locations
-- **Cleaner File Names**: Transforms minified filenames like `Logger-BynuRJQf.js` to clean names like `logger.ts`
-- **Consistent Styling**: All badges (level and domain) now use consistent visual styling
-
-### 🎨 Visual Improvements
-- Domain badges use background color + text styling similar to level badges
-- Uppercase domain names for better visibility
-- Enhanced cyberpunk preset with more vibrant badge styling
-- Better visual hierarchy in terminal logs
-
-### 🐛 Bug Fixes
-- Fixed undefined filename handling in stack trace parsing
-- Improved TypeScript type safety in stack trace functions
-- Better error handling for malformed stack traces
-
----
-
-## [1.1.0] - Previous
-
-### ✨ Added
-- Advanced styling system with CSS gradients and animations
-- Smart presets (cyberpunk, glassmorphism, minimal, debug, production)
-- Scoped loggers with automatic prefix management
-- Performance monitoring with timing capabilities
-- CLI integration with interactive commands
-- Export handlers for file and remote logging
-- SVG and animation support
-- Theme detection and automatic adaptation
-
----
-
-## [1.0.0] - Initial Release
-
-### ✨ Added
-- Core logging functionality with multiple log levels
-- Style Builder with fluent API
-- Browser DevTools integration
-- TypeScript definitions
-- Basic theming system

package/CLAUDE.md

@@ -1,217 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
-
-## Project Overview
-
-This is an **Advanced Logger** TypeScript library that provides state-of-the-art console logging with advanced CSS styling, performance monitoring, and extensible architecture. The project is built with modern TypeScript patterns and targets browser environments.
-
-### Core Architecture
-
-- **Main Logger Class**: `src/Logger.ts` contains the primary Logger class with advanced styling capabilities
-- **Style System**: Built around a fluent `StyleBuilder` class that creates CSS-in-JS console styles
-- **Handler Architecture**: Extensible system with `ILogHandler` interface for custom log destinations (File, Remote, Analytics)
-- **Scoped Logging**: Support for prefixed logger instances for different modules/components
-- **Performance Monitoring**: Built-in timing capabilities with `time()` and `timeEnd()`
-
-### Key Components
-
-- **Logger Core** (`src/Logger.ts:373-732`): Main logger implementation with hierarchical log levels
-- **Style Builder** (`src/Logger.ts:141-226`): Chainable CSS styling system
-- **Log Handlers** (`src/Logger.ts:737-971`): FileLogHandler, RemoteLogHandler, AnalyticsLogHandler
-- **Demo/Test Interface** (`index.html`): Interactive test page with styled buttons
-- **Usage Examples** (`src/example.ts`, `src/main.ts`): Comprehensive usage demonstrations
-
-## Development Commands
-
-### Build & Development
-```bash
-npm run dev          # Start Vite dev server (runs on http://localhost:5173)
-npm run build        # TypeScript compilation + Vite production build
-npm run preview      # Preview production build
-```
-
-### Testing the Logger
-- Open `index.html` in development server
-- Use browser DevTools console to see styled output
-- Click buttons to test different log levels and features
-
-### Testing & Validation
-```bash
-# Validar workflows YAML y estructura
-npm run validate:workflows
-
-# Test completo de resolución de conflictos  
-npm run test:workflows
-
-# Lint YAML con configuración personalizada
-npm run lint:yaml
-
-# Auto-fix problemas YAML comunes
-npm run fix:yaml
-```
-
-**IMPORTANTE**: Siempre ejecutar `npm run test:workflows` antes de commits que modifiquen workflows para verificar que la resolución de conflictos esté intacta.
-
-### Commits Locales Anti-Conflictos
-Para evitar conflictos localmente, **SIEMPRE usa los comandos project-utils** en lugar de `git commit` manual:
-
-```bash
-# Commit automático con AI (RECOMENDADO)
-npm run commit:auto
-
-# Commit interactivo con UI  
-npm run commit:ui
-
-# Para releases específicos
-npm run commit:auto --context "fix critical bug" --work-type "fix"
-npm run commit:auto --context "new feature" --work-type "feature"
-```
-
-**Parámetros disponibles para commit-generator:**
-```bash
-bun project-utils/commit-generator.ts [opciones]
-
---auto-approve                # Ejecutar automáticamente sin confirmación
---quiet                      # Ejecución silenciosa 
---context <texto>            # Contexto del trabajo
---work-type <tipo>           # feature|fix|refactor|docs|test
---affected-components <lista> # Componentes: core,styling,exports,cli,docs
---performance-impact <tipo>   # none|minor|major
---no-push                    # Solo commit, no push
---proposal-file <ruta>       # Usar propuesta existente
-```
-
-**Detección automática de conflictos:**
-- ✅ **Local**: Detecta automáticamente archivos de release (package.json, CHANGELOG.json) 
-- ✅ **GitHub Actions**: Detecta contexto de workflow via RELEASE_WORKFLOW=true
-- ✅ **Estrategia dual**: Pull-rebase-push con MAX_RETRIES=3 + fallback manual
-- ✅ **Smart push**: Sincronización inteligente antes de push
-
-## Architecture Patterns
-
-### Log Level Hierarchy
-```typescript
-LOG_LEVELS = {
-    debug: 0,    // Lowest priority
-    info: 1,
-    warn: 2, 
-    error: 3,
-    critical: 4  // Highest priority
-}
-```
-
-### Styling System
-The project uses a sophisticated CSS-in-JS approach:
-- **StyleBuilder**: Chainable pattern for building console CSS styles
-- **LEVEL_STYLES**: Pre-configured gradients, colors, and shadows for each log level
-- **Dynamic Styling**: Uses `%c` console formatting with built CSS strings
-
-### Handler Pattern
-Extensible logging through the `ILogHandler` interface:
-- Handlers receive log metadata including timestamps, stack traces, and prefixes
-- Multiple handlers can be registered simultaneously
-- Built-in handlers for file logging, remote logging, and analytics
-
-### Performance Features
-- **Stack Trace Parsing**: Automatic caller location detection
-- **Performance Timers**: Built-in timing with `performance.now()`
-- **Grouping**: Console grouping with automatic indentation
-- **Table Display**: Formatted data tables in console
-
-## Code Conventions
-
-### TypeScript Patterns
-- Uses modern ES2022+ features with strict typing
-- Leverages `as const` for readonly object typing
-- Interface-based extensibility patterns
-- Generic types for flexible APIs (`logGrouped<T>`)
-
-### Styling Conventions
-- All styles use CSS gradients and modern properties
-- Consistent color palette across log levels
-- Responsive design patterns in HTML interface
-- CSS Grid for layout with modern browser features
-
-### Error Handling
-- Graceful degradation when browser features unavailable
-- Try-catch blocks around experimental features
-- Silent failure for log handlers to prevent infinite loops
-
-## Browser Compatibility
-
-### Modern Features Used
-- **CSS Gradients**: Extensive use of `linear-gradient()`
-- **Performance API**: `performance.now()` for timing
-- **Modern Console**: `%c` formatting, `console.table()`, `console.group()`
-- **ES2022 Features**: Object.groupBy (with fallback)
-- **Fetch API**: Used in RemoteLogHandler
-
-### Fallback Patterns
-- Stack trace parsing handles different browser formats (Chrome/Firefox)
-- Object.groupBy fallback to reduce()
-- Modern Date API with ISO formatting fallback
-
-## Key Files Structure
-
-```
-src/
-  ├── Logger.ts      # Main logger implementation (972 lines)
-  ├── example.ts     # Comprehensive usage examples  
-  ├── main.ts        # Test functions for HTML interface
-  └── style.css      # Basic Vite styling (not logger-related)
-```
-
-The logger is designed as a single-file library with comprehensive TypeScript documentation and can be imported as individual functions or as a class instance.
-
-## Advanced Anti-Conflict System
-
-### Intelligent Conflict Detection
-The project includes an advanced conflict resolution system in `project-utils/commit-generator.ts` that:
-
-- **Type Analysis**: Detects different types of conflicts (merge, rebase, tmp-files, manual)
-- **Auto-Resolution**: Automatically resolves conflicts in temporary files
-- **Safety Backups**: Creates backup branches before dangerous operations
-- **Context Awareness**: Different strategies for local vs GitHub Actions environments
-
-### Conflict Types Handled
-- `tmp-files`: Conflicts in `.temp`, `tmp`, `.cache` directories - auto-resolvable
-- `merge`: Standard merge conflicts requiring analysis
-- `rebase`: Rebase conflicts with specialized handling
-- `manual`: Critical file conflicts requiring user intervention
-
-### Safety Features
-- **TypeCheck Integration**: Both commit-generator and commit-ui run `npm run type-check` before proceeding
-- **Backup Creation**: Automatic backup branches before risky operations (format: `backup-before-conflict-resolution-TIMESTAMP`)
-- **Critical File Protection**: Special handling for `src/`, `package.json`, `tsconfig.json`, `.github/workflows/`
-- **Manual Intervention Detection**: Identifies when user input is required vs auto-resolvable conflicts
-
-### Usage Commands
-```bash
-# Auto-commit with conflict resolution
-npm run commit:auto
-
-# Interactive UI with conflict handling
-npm run commit:ui
-
-# Test conflict resolution system
-npm run test:workflows
-```
-
-### Environment Variables
-- `GITHUB_ACTIONS=true`: Detects CI environment
-- `RELEASE_WORKFLOW=true`: Activates release-specific conflict strategies
-- `GITHUB_WORKFLOW`: Workflow name for logging and context
-
-## Code Comments Policy
-
-**NO agregar comentarios LLM-generated:**
-- ❌ "estilo Pino", "like Pino", "inspired by X"
-- ❌ "mejorado", "arreglado", "optimizado"
-- ❌ Comentarios obvios que repiten el nombre de la función/interface
-- ❌ "@since 3.0.0" o versiones en JSDoc (ya está en git history)
-
-**SÍ agregar cuando sea necesario:**
-- ✅ JSDoc técnico con @param, @returns, @example útiles
-- ✅ Comentarios que explican el "por qué" no obvio
-- ✅ TODO/FIXME con contexto específico