@crimsonsunset/jsg-logger 1.0.8

package/config/config-manager.js

@@ -0,0 +1,378 @@
+/**
+ * Configuration Manager for CACP Logger
+ * Handles loading, merging, and validation of logger configurations
+ * Implements smart level resolution and file override system
+ */
+
+import defaultConfig from './default-config.json';
+import {COMPONENT_SCHEME, LEVEL_SCHEME} from './component-schemes.js';
+
+export class ConfigManager {
+    constructor() {
+        this.config = {...defaultConfig};
+        this.loadedPaths = [];
+        this.currentFile = null; // Track current file for overrides
+    }
+
+    /**
+     * Load configuration from a file path or object
+     * @param {string|Object} configSource - File path or config object
+     * @returns {Promise<Object>} Merged configuration
+     */
+    async loadConfig(configSource) {
+        try {
+            let externalConfig = {};
+
+            if (typeof configSource === 'string') {
+                // Load from file path
+                if (configSource.startsWith('./') || configSource.startsWith('../')) {
+                    // Relative path - attempt to load
+                    try {
+                        const response = await fetch(configSource);
+                        if (response.ok) {
+                            externalConfig = await response.json();
+                            this.loadedPaths.push(configSource);
+                        }
+                    } catch (error) {
+                        console.warn(`Failed to load config from ${configSource}:`, error.message);
+                    }
+                }
+            } else if (typeof configSource === 'object') {
+                // Direct config object
+                externalConfig = configSource;
+            }
+
+            // Merge configurations
+            this.config = this.mergeConfigs(this.config, externalConfig);
+
+            return this.config;
+        } catch (error) {
+            console.error('ConfigManager: Error loading configuration:', error);
+            return this.config; // Return default config on error
+        }
+    }
+
+    /**
+     * Set current file context for override resolution
+     * @param {string} filePath - Current file path being logged from
+     */
+    setCurrentFile(filePath) {
+        this.currentFile = filePath;
+    }
+
+    /**
+     * Deep merge two configuration objects
+     * @private
+     */
+    mergeConfigs(base, override) {
+        const merged = {...base};
+
+        for (const key in override) {
+            if (override.hasOwnProperty(key)) {
+                if (typeof override[key] === 'object' && !Array.isArray(override[key])) {
+                    merged[key] = this.mergeConfigs(merged[key] || {}, override[key]);
+                } else {
+                    merged[key] = override[key];
+                }
+            }
+        }
+
+        return merged;
+    }
+
+    /**
+     * Get effective log level using hierarchy: file override > component level > global level
+     * @param {string} componentName - Component identifier
+     * @param {string} filePath - Optional file path for override checking
+     * @returns {string} Effective log level
+     */
+    getEffectiveLevel(componentName, filePath = null) {
+        const checkFile = filePath || this.currentFile;
+
+        // 1. Check file overrides first (highest priority)
+        if (checkFile && this.config.fileOverrides) {
+            const fileOverride = this.getFileOverride(checkFile);
+            if (fileOverride && fileOverride.level) {
+                return fileOverride.level;
+            }
+        }
+
+        // 2. Check component-specific level
+        if (this.config.components && this.config.components[componentName] && this.config.components[componentName].level) {
+            return this.config.components[componentName].level;
+        }
+
+        // 3. Fall back to global level
+        return this.config.globalLevel || 'info';
+    }
+
+    /**
+     * Get file override configuration for a given file path
+     * @param {string} filePath - File path to check
+     * @returns {Object|null} File override config or null
+     */
+    getFileOverride(filePath) {
+        if (!this.config.fileOverrides || !filePath) {
+            return null;
+        }
+
+        // Normalize file path (remove leading ./ and ../)
+        const normalizedPath = filePath.replace(/^\.\.?\//g, '');
+
+        // Check exact matches first
+        if (this.config.fileOverrides[normalizedPath]) {
+            return this.config.fileOverrides[normalizedPath];
+        }
+
+        // Check pattern matches
+        for (const pattern in this.config.fileOverrides) {
+            if (this.matchFilePattern(normalizedPath, pattern)) {
+                return this.config.fileOverrides[pattern];
+            }
+        }
+
+        return null;
+    }
+
+    /**
+     * Match file path against a pattern (supports wildcards)
+     * @param {string} filePath - File path to test
+     * @param {string} pattern - Pattern to match against
+     * @returns {boolean} Whether the file matches the pattern
+     * @private
+     */
+    matchFilePattern(filePath, pattern) {
+        // Convert glob pattern to regex
+        const regexPattern = pattern
+                .replace(/\./g, '\\.')  // Escape dots
+                .replace(/\*/g, '.*')   // Convert * to .*
+                .replace(/\?/g, '.')    // Convert ? to .
+            + '$';                  // End of string
+
+        const regex = new RegExp(regexPattern);
+        return regex.test(filePath);
+    }
+
+    /**
+     * Get component configuration with file override support
+     * @param {string} componentName - Component identifier
+     * @param {string} filePath - Optional file path for override checking
+     * @returns {Object} Component configuration
+     */
+    getComponentConfig(componentName, filePath = null) {
+        const baseComponent = this.config.components?.[componentName] || COMPONENT_SCHEME[componentName] || COMPONENT_SCHEME['cacp'];
+
+        // Check for file-specific overrides
+        const checkFile = filePath || this.currentFile;
+        if (checkFile) {
+            const fileOverride = this.getFileOverride(checkFile);
+            if (fileOverride) {
+                return {
+                    ...baseComponent,
+                    ...fileOverride,
+                    level: this.getEffectiveLevel(componentName, checkFile)
+                };
+            }
+        }
+
+        return {
+            ...baseComponent,
+            level: this.getEffectiveLevel(componentName, checkFile)
+        };
+    }
+
+    /**
+     * Get level configuration
+     * @param {number} level - Log level number
+     * @returns {Object} Level configuration
+     */
+    getLevelConfig(level) {
+        // Check if level exists in loaded config
+        if (this.config.levels && this.config.levels[level]) {
+            return this.config.levels[level];
+        }
+
+        // Fallback to default schemes
+        return LEVEL_SCHEME[level] || LEVEL_SCHEME[30];
+    }
+
+    /**
+     * Get global log level
+     * @returns {string} Global log level
+     */
+    getGlobalLevel() {
+        return this.config.globalLevel || 'info';
+    }
+
+    /**
+     * Get timestamp mode
+     * @returns {string} Timestamp mode ('absolute', 'readable', 'relative', 'disable')
+     */
+    getTimestampMode() {
+        return this.config.timestampMode || 'absolute';
+    }
+
+    /**
+     * Get display configuration with file override support
+     * @param {string} filePath - Optional file path for override checking
+     * @returns {Object} Display configuration
+     */
+    getDisplayConfig(filePath = null) {
+        const baseDisplay = this.config.display || {
+            timestamp: true,
+            emoji: true,
+            component: true,
+            level: false,
+            message: true,
+            jsonPayload: true,
+            stackTrace: true
+        };
+
+        // Check for file-specific display overrides
+        const checkFile = filePath || this.currentFile;
+        if (checkFile) {
+            const fileOverride = this.getFileOverride(checkFile);
+            if (fileOverride && fileOverride.display) {
+                return {
+                    ...baseDisplay,
+                    ...fileOverride.display
+                };
+            }
+        }
+
+        return baseDisplay;
+    }
+
+    /**
+     * Get project name
+     * @returns {string} Project name
+     */
+    getProjectName() {
+        return this.config.projectName || 'CACP Logger';
+    }
+
+    /**
+     * Check if auto-registration is enabled
+     * @returns {boolean} Auto-registration flag
+     */
+    isAutoRegisterEnabled() {
+        return this.config.autoRegister !== false;
+    }
+
+    /**
+     * Get formatting configuration
+     * @returns {Object} Format configuration
+     */
+    getFormatConfig() {
+        return this.config.format || {
+            style: 'brackets',
+            componentCase: 'upper',
+            timestamp: 'HH:mm:ss.SSS'
+        };
+    }
+
+    /**
+     * Get all available components
+     * @returns {Array} Array of component names
+     */
+    getAvailableComponents() {
+        const configComponents = Object.keys(this.config.components || {});
+        const schemeComponents = Object.keys(COMPONENT_SCHEME);
+
+        // Combine and deduplicate
+        return [...new Set([...configComponents, ...schemeComponents])];
+    }
+
+    /**
+     * Add or update a component configuration
+     * @param {string} componentName - Component identifier
+     * @param {Object} componentConfig - Component configuration
+     */
+    addComponent(componentName, componentConfig) {
+        if (!this.config.components) {
+            this.config.components = {};
+        }
+
+        this.config.components[componentName] = {
+            ...this.getComponentConfig(componentName),
+            ...componentConfig
+        };
+    }
+
+    /**
+     * Add or update a file override
+     * @param {string} filePath - File path or pattern
+     * @param {Object} overrideConfig - Override configuration
+     */
+    addFileOverride(filePath, overrideConfig) {
+        if (!this.config.fileOverrides) {
+            this.config.fileOverrides = {};
+        }
+
+        this.config.fileOverrides[filePath] = overrideConfig;
+    }
+
+    /**
+     * Format timestamp based on mode
+     * @param {number} timestamp - Unix timestamp
+     * @param {string} mode - Timestamp mode
+     * @returns {string} Formatted timestamp
+     */
+    formatTimestamp(timestamp, mode = null) {
+        const timestampMode = mode || this.getTimestampMode();
+        const date = new Date(timestamp);
+
+        switch (timestampMode) {
+            case 'readable':
+                return date.toLocaleTimeString('en-US', {
+                    hour: 'numeric',
+                    minute: '2-digit',
+                    hour12: true
+                });
+
+            case 'relative':
+                const now = Date.now();
+                const diff = now - timestamp;
+
+                if (diff < 1000) return 'now';
+                if (diff < 60000) return `${Math.floor(diff / 1000)}s ago`;
+                if (diff < 3600000) return `${Math.floor(diff / 60000)}m ago`;
+                return `${Math.floor(diff / 3600000)}h ago`;
+
+            case 'disable':
+                return '';
+
+            case 'absolute':
+            default:
+                return date.toLocaleTimeString('en-US', {
+                    hour12: false,
+                    hour: '2-digit',
+                    minute: '2-digit',
+                    second: '2-digit',
+                    fractionalSecondDigits: 3
+                });
+        }
+    }
+
+    /**
+     * Get configuration summary for debugging
+     * @returns {Object} Configuration summary
+     */
+    getSummary() {
+        return {
+            projectName: this.getProjectName(),
+            globalLevel: this.getGlobalLevel(),
+            timestampMode: this.getTimestampMode(),
+            loadedPaths: this.loadedPaths,
+            componentCount: this.getAvailableComponents().length,
+            fileOverrideCount: Object.keys(this.config.fileOverrides || {}).length,
+            autoRegister: this.isAutoRegisterEnabled(),
+            format: this.getFormatConfig(),
+            display: this.getDisplayConfig(),
+            currentFile: this.currentFile
+        };
+    }
+}
+
+// Create singleton instance
+export const configManager = new ConfigManager();

package/config/default-config.json

@@ -0,0 +1,92 @@
+{
+  "projectName": "CACP Logger",
+  "globalLevel": "info",
+  "autoRegister": true,
+  "format": {
+    "style": "brackets",
+    "componentCase": "upper",
+    "timestamp": "HH:mm:ss.SSS"
+  },
+  "timestampMode": "absolute",
+  "display": {
+    "timestamp": true,
+    "emoji": true,
+    "component": true,
+    "level": false,
+    "message": true,
+    "jsonPayload": true,
+    "stackTrace": true
+  },
+  "levels": {
+    "10": { "name": "TRACE", "emoji": "🔍", "color": "#6C7B7F" },
+    "20": { "name": "DEBUG", "emoji": "🐛", "color": "#74B9FF" },
+    "30": { "name": "INFO", "emoji": "✨", "color": "#00B894" },
+    "40": { "name": "WARN", "emoji": "⚠️", "color": "#FDCB6E" },
+    "50": { "name": "ERROR", "emoji": "🚨", "color": "#E17055" },
+    "60": { "name": "FATAL", "emoji": "💀", "color": "#D63031" }
+  },
+  "components": {
+    "cacp": { 
+      "emoji": "🎯", 
+      "color": "#4A90E2", 
+      "name": "CACP-Core",
+      "level": "info"
+    },
+    "soundcloud": { 
+      "emoji": "🎵", 
+      "color": "#FF5500", 
+      "name": "SoundCloud",
+      "level": "info"
+    },
+    "youtube": { 
+      "emoji": "📹", 
+      "color": "#FF0000", 
+      "name": "YouTube",
+      "level": "info"
+    },
+    "site-detector": { 
+      "emoji": "🔍", 
+      "color": "#00C896", 
+      "name": "SiteDetector",
+      "level": "info"
+    },
+    "websocket": { 
+      "emoji": "🌐", 
+      "color": "#9B59B6", 
+      "name": "WebSocket",
+      "level": "info"
+    },
+    "popup": { 
+      "emoji": "🎛️", 
+      "color": "#FF6B6B", 
+      "name": "Popup",
+      "level": "info"
+    },
+    "background": { 
+      "emoji": "🔧", 
+      "color": "#4ECDC4", 
+      "name": "Background",
+      "level": "info"
+    },
+    "priority-manager": { 
+      "emoji": "⚖️", 
+      "color": "#45B7D1", 
+      "name": "PriorityManager",
+      "level": "info"
+    },
+    "settings": { 
+      "emoji": "⚙️", 
+      "color": "#96CEB4", 
+      "name": "Settings",
+      "level": "info"
+    },
+    "test": { 
+      "emoji": "🧪", 
+      "color": "#FFEAA7", 
+      "name": "Test",
+      "level": "debug"
+    }
+  },
+  "fileOverrides": {
+  }
+}

package/docs/next-session.md

@@ -0,0 +1,136 @@
+# JSG Logger - Session Summary
+
+## 📋 How to Update This Doc
+
+**This is a working document that gets refreshed each session:**
+1. **Wipe accomplished items** - Remove completed tasks and achievements
+2. **Keep undone items** - Leave incomplete tasks for tracking purposes
+3. **Add new priorities** - Include new tasks and blockers that emerge
+4. **Update current state** - Reflect what's working vs what needs attention
+
+**Key difference from roadmap.md:**
+- **This file:** Working session notes, gets refreshed as tasks complete
+- **Roadmap.md:** Permanent historical record, accumulates progress over time
+
+---
+
+**Date:** August 6, 2025  
+**Session Goal:** 🎯 **COMPLETE** - ✅ Logger extraction, NPM publication, and documentation structure  
+**Next Session Goal:** 🎨 **DevTools Panel Implementation** - Browser-based log filtering interface (optional enhancement)
+
+## 🎉 MAJOR ACCOMPLISHMENTS THIS SESSION
+
+### ✅ Logger Extraction & NPM Publication COMPLETE
+- **📦 NPM Package** - Published `@crimsonsunset/jsg-logger` v1.0.6 to registry
+- **🔧 Automated Scripts** - Added `npm run release` for easy version management
+- **📂 Repository Migration** - Successfully extracted from DeskThing-Apps to standalone repo
+- **🔄 Integration Success** - DeskThing-Apps now uses published package instead of local folder
+- **🧹 Cleanup Complete** - Removed old logger folder from DeskThing-Apps
+
+### ✅ Documentation Structure COMPLETE
+- **📄 LICENSE** - Added ISC license file with proper copyright
+- **📋 CHANGELOG.md** - Version history tracking with semantic versioning
+- **🤝 CONTRIBUTING.md** - Guidelines for future contributors
+- **📁 docs/ Folder** - Professional documentation structure
+- **🗺️ roadmap.md** - Comprehensive project roadmap with phases
+- **📝 next-session.md** - Working session tracking template
+
+### ✅ Legal & Professional Polish COMPLETE
+- **⚖️ ISC License** - "AS IS" liability protection with permissive usage
+- **🛡️ Disclaimer** - Clear legal protection in README
+- **📊 Package Metadata** - Professional NPM package with proper keywords
+- **🔗 Repository Links** - GitHub links for issues, bugs, and homepage
+
+## 🎯 Current Status
+
+### **Project State: Feature Complete & Stable** ✅
+- **Core Logger**: Multi-environment logging working perfectly
+- **NPM Package**: Published and successfully integrated
+- **Documentation**: Comprehensive and professional
+- **Legal Protection**: ISC license with "AS IS" disclaimer
+
+### **What's Working Well**
+- ✅ **Beautiful Console Output** - Direct browser logger with perfect formatting
+- ✅ **Runtime Controls** - Dynamic configuration without restarts
+- ✅ **File-Level Precision** - Surgical debugging capabilities
+- ✅ **Multi-Environment** - Seamless browser/CLI/server support
+- ✅ **Professional Package** - NPM-ready with automated publishing
+
+### **No Known Issues**
+- **Zero critical bugs** - Logger is stable and tested
+- **Clean Integration** - DeskThing-Apps migration successful
+- **Documentation Complete** - All standard files in place
+
+## 📋 CURRENT PRIORITIES
+
+### **No Immediate Tasks** ✅
+- **Logger is feature complete** - Core functionality fully implemented
+- **Documentation structure complete** - All standard files added
+- **NPM package stable** - Version 1.0.6 published and working
+
+### **Optional Future Enhancements** (Low Priority)
+- [ ] **DevTools Panel** - Browser-based log filtering interface
+  - Runtime-injected widget with Preact
+  - Collapsible sidebar from left side
+  - Controls console filtering without displaying logs
+  - IndexedDB persistence for panel state
+- [ ] **Performance Monitoring** - Track logging overhead metrics
+- [ ] **Export Utilities** - Save logs to file formats
+- [ ] **Framework Integration Guides** - React, Vue, Svelte examples
+
+## 🔧 Technical Notes
+
+### **NPM Publishing Lessons Learned**
+- **Scoped Packages** - Need `--access public` for free publishing
+- **Internal Imports** - Required multiple patch versions (1.0.1-1.0.4) to fix relative paths
+- **Automated Scripts** - `npm run release` handles version bump + publish in one command
+
+### **Architecture Highlights**  
+- **Browser Logger Breakthrough** - Bypassing Pino for 100% console control
+- **Hierarchical Config** - File > Component > Global precedence
+- **Environment Detection** - Feature detection over user agent parsing
+- **Runtime API** - Complete `logger.controls` interface for dynamic changes
+
+### **Integration Success**
+- **Vite Alias Removal** - Cleanly replaced `@logger` alias with NPM import
+- **Build Compatibility** - Extension builds successfully with published package
+- **Zero Disruption** - Existing DeskThing functionality unchanged
+
+## 🎯 Next Session Possibilities
+
+### **If Continuing Development** (Optional)
+1. **DevTools Panel** - Browser interface for log filtering
+   - Use existing `logger.controls` API (no custom filter engine needed)
+   - Preact for minimal bundle size
+   - IndexedDB for persistence
+   - Runtime injection pattern
+
+2. **Community Features** (If demand exists)
+   - Framework integration examples
+   - Performance monitoring dashboard
+   - Export/import configuration utilities
+
+### **If Project Maintenance Mode**
+- **Monitor NPM usage** - See if package gains adoption
+- **Address issues** - Respond to bug reports or feature requests
+- **Version updates** - Maintain dependencies and compatibility
+
+## 📊 Session Metrics
+
+### **Documentation Added**
+- LICENSE (ISC) - 15 lines
+- CHANGELOG.md - 45 lines with full version history
+- CONTRIBUTING.md - 65 lines with guidelines
+- docs/roadmap.md - 280+ lines comprehensive roadmap
+- docs/next-session.md - 130+ lines session template
+
+### **NPM Package Health**
+- **Version**: 1.0.6 (stable)
+- **Size**: 16.1 kB compressed, 65.0 kB unpacked
+- **Files**: 12 files published
+- **Dependencies**: Only pino for server environments
+- **License**: ISC with "AS IS" protection
+
+### **Project Completion Status**: 100% Core Features ✅
+
+**The JSG Logger is now a complete, professional, reusable NPM package with comprehensive documentation and legal protection.**