@wgtechlabs/log-engine 2.2.2-pr.886b796 → 2.2.2-pr.cb278e2

package/README.md

@@ -16,6 +16,7 @@ Log Engine transforms your development experience from chaotic debugging session
 
 ## ✨ Key Features
 
+- **🎨 Context-Aware Emoji (New!)**: Intelligent emoji support that enhances log readability by analyzing content and automatically selecting relevant visual indicators - based on the gitmoji set with 40+ curated mappings and fully customizable.
 - **🔒 Advanced Data Redaction (Enhanced!)**: Built-in PII protection with **custom regex patterns**, **dynamic field management**, and **environment-based configuration** - the first logging library with comprehensive security-first logging by default.
 - **🎯 Configurable Output Handlers (New!)**: Revolutionary output routing system supporting **custom destinations**, **multiple simultaneous outputs**, and **production-ready handlers** - redirect logs to files, HTTP endpoints, GUI applications, testing frameworks, or any custom destination with zero configuration complexity.
 - **⚡ Custom Redaction Patterns**: Add your own regex patterns for advanced field detection and enterprise-specific data protection requirements.
@@ -29,7 +30,6 @@ Log Engine transforms your development experience from chaotic debugging session
 - **⚙️ Auto-Configuration**: Intelligent environment-based setup using NODE_ENV variables. No config files, initialization scripts, or manual setup - Log Engine works perfectly out of the box.
 - **✨ Enhanced Formatting**: Structured log entries with dual timestamps (ISO + human-readable) and colored level indicators for maximum readability.
 - **🔗 Zero Dependencies**: No external dependencies for maximum compatibility and security - keeps your bundle clean and your project simple.
-- **📏 Size Monitoring**: Automated bundle size checking ensures the package stays under 1MB to maintain its lightweight promise.
 - **🔌 Easy Integration**: Simple API that works seamlessly with existing Node.js applications. Just `import` and start logging - no middleware, plugins, or configuration required.
 
 ## ⚠️ Breaking Changes Notice
@@ -414,6 +414,207 @@ LogEngine.error('Connection failed');
 
 **Note**: Log levels (`[DEBUG]`, `[INFO]`, `[WARN]`, `[ERROR]`, `[LOG]`) are always included regardless of configuration to maintain log clarity and filtering capabilities.
 
+## 🎨 Context-Aware Emoji Support
+
+**LogEngine features intelligent emoji support that enhances log readability by adding visual context to each log message.** The emoji engine analyzes your log content (level + message + data) and automatically selects the most relevant emoji, making it easier to visually parse large logs and instantly identify the type of each log line.
+
+### Features
+
+- **🎯 Context-Aware Selection**: Automatically analyzes message content and data to select appropriate emoji
+- **📦 Rich Emoji Set**: Based on [gitmoji](https://gitmoji.dev) with 40+ curated emoji mappings
+- **🔄 Smart Fallback**: Uses level-specific emoji when no context match is found
+- **🛠️ Fully Customizable**: Extend or override emoji mappings and fallback behavior
+- **✅ Enabled by Default**: Emoji are automatically included in logs (can be disabled via `includeEmoji: false`)
+
+### Quick Start
+
+```typescript
+import { LogEngine } from '@wgtechlabs/log-engine';
+
+// Emoji are enabled by default - just start logging!
+LogEngine.error('Database connection failed');
+// Output: [2026-02-11T14:00:00.000Z][2:00PM][ERROR][🗃️]: Database connection failed
+
+LogEngine.info('Deployed to production successfully');
+// Output: [2026-02-11T14:00:01.000Z][2:00PM][INFO][🚀]: Deployed to production successfully
+
+LogEngine.warn('Performance degradation detected');
+// Output: [2026-02-11T14:00:02.000Z][2:00PM][WARN][⚡️]: Performance degradation detected
+
+LogEngine.info('Unknown event happened');
+// Output: [2026-02-11T14:00:03.000Z][2:00PM][INFO][ℹ️]: Unknown event happened (fallback)
+
+// Disable emoji if needed
+LogEngine.configure({
+  format: {
+    includeEmoji: false
+  }
+});
+```
+
+### Context-Aware Emoji Mappings
+
+LogEngine intelligently matches keywords in your log messages to select appropriate emoji:
+
+| Context | Keywords | Emoji | Example |
+|---------|----------|-------|---------|
+| **Database** | database, db, sql, query, mongo, postgres | 🗃️ | "Database query failed" |
+| **Deployment** | deploy, release, launched, production | 🚀 | "Deployed to production" |
+| **Performance** | performance, speed, optimize, latency | ⚡️ | "Performance issues detected" |
+| **Security** | security, vulnerability, auth, permission | 🔒️ | "Security breach detected" |
+| **Critical** | critical, urgent, emergency, crash | 🚑️ | "Critical system failure" |
+| **Bugs** | bug, fix, defect, issue | 🐛 | "Fixed bug in login" |
+| **Network** | network, http, api, endpoint | 🌐 | "API request failed" |
+| **Testing** | tests, testing, validation | ✅ | "All tests passed" |
+
+### Fallback Emoji by Level
+
+When no context-specific emoji matches, LogEngine uses these fallback emoji:
+
+| Log Level | Emoji | Description |
+|-----------|-------|-------------|
+| `DEBUG` | 🐞 | Debugging information |
+| `INFO` | ℹ️ | General information |
+| `WARN` | ⚠️ | Warning messages |
+| `ERROR` | ❌ | Error messages |
+| `LOG` | ✅ | Critical log messages |
+
+### Custom Emoji Configuration
+
+#### Custom Context Mappings
+
+Add your own emoji mappings for custom contexts:
+
+```typescript
+LogEngine.configure({
+  format: {
+    emoji: {
+      customMappings: [
+        {
+          emoji: '🎯',
+          code: ':dart:',
+          description: 'Goal achieved',
+          keywords: ['goal', 'target', 'achieved', 'milestone']
+        },
+        {
+          emoji: '💰',
+          code: ':moneybag:',
+          description: 'Payment operations',
+          keywords: ['payment', 'transaction', 'billing', 'invoice']
+        }
+      ]
+    }
+  }
+});
+
+LogEngine.info('Payment processed successfully');
+// Output: [INFO][💰]: Payment processed successfully
+
+LogEngine.info('Sales target achieved');
+// Output: [INFO][🎯]: Sales target achieved
+```
+
+#### Custom Fallback Emoji
+
+Override the default fallback emoji for each log level:
+
+```typescript
+LogEngine.configure({
+  format: {
+    emoji: {
+      customFallbacks: {
+        DEBUG: '🔍',
+        INFO: '📢',
+        WARN: '🚨',
+        ERROR: '💀',
+        LOG: '🎉'
+      }
+    }
+  }
+});
+
+LogEngine.info('Generic info message');
+// Output: [INFO][📢]: Generic info message
+```
+
+#### Use Custom Mappings Exclusively
+
+Use only your custom mappings and ignore the built-in set:
+
+```typescript
+LogEngine.configure({
+  format: {
+    emoji: {
+      useCustomOnly: true,
+      customMappings: [
+        // Your custom mappings only
+      ]
+    }
+  }
+});
+```
+
+### Data Context Analysis
+
+The emoji selector also analyzes data objects for context:
+
+```typescript
+LogEngine.info('Operation completed', {
+  database: 'postgres',
+  table: 'users',
+  rows: 1000
+});
+// Output: [INFO][🗃️]: Operation completed { database: 'postgres', ... }
+
+LogEngine.warn('Issue detected', {
+  performance: 'degraded',
+  latency: '500ms'
+});
+// Output: [WARN][⚡️]: Issue detected { performance: 'degraded', ... }
+```
+
+### Programmatic Access
+
+Access emoji utilities directly for advanced use cases:
+
+```typescript
+import { EmojiSelector, EMOJI_MAPPINGS, FALLBACK_EMOJI } from '@wgtechlabs/log-engine';
+
+// Check all available emoji mappings
+console.log(EMOJI_MAPPINGS);
+// [{ emoji: '🐛', code: ':bug:', description: 'Fix a bug', keywords: [...] }, ...]
+
+// Check fallback emoji
+console.log(FALLBACK_EMOJI);
+// { DEBUG: '🐞', INFO: 'ℹ️', WARN: '⚠️', ERROR: '❌', LOG: '✅' }
+
+// Configure emoji selector directly (for customization)
+EmojiSelector.configure({
+  customMappings: [...]
+});
+```
+
+### Output Format
+
+With emoji (enabled by default), the log format is:
+
+```
+[ISO_TIMESTAMP][LOCAL_TIME][LEVEL][EMOJI]: message [data]
+```
+
+Example:
+```
+[2026-02-11T14:00:00.000Z][2:00PM][ERROR][🗃️]: Database connection failed
+```
+
+### Benefits
+
+- **👁️ Visual Clarity**: Instantly identify log context at a glance
+- **🎯 Better Debugging**: Quickly locate specific types of logs in large outputs
+- **🎨 Enhanced UX**: More engaging and pleasant logging experience
+- **🔧 Flexible**: Fully customizable to match your project's needs
+- **🔒 Compatibility Note**: Enabled by default – existing log output will include emojis; disable or customize emoji behavior via configuration to preserve prior formats
+
 ## 🔒 Advanced Data Redaction
 
 **LogEngine features comprehensive built-in PII protection with advanced customization capabilities that automatically redacts sensitive information from your logs.** This security-first approach prevents accidental exposure of passwords, tokens, emails, and other sensitive data while maintaining full debugging capabilities with enterprise-grade flexibility.
@@ -902,8 +1103,7 @@ Contributions are welcome, create a pull request to this repo and I will review
 - `pnpm lint:security` - Run security-focused linting
 - `pnpm secure` - Run comprehensive security checks
 - `pnpm build` - Build the TypeScript project
-- `pnpm size:check` - Check bundle size to maintain lightweight feature
-- `pnpm validate` - Run full validation (lint + test + build + size check)
+- `pnpm validate` - Run full validation (lint + test + build)
 
 Read the project's [contributing guide](./CONTRIBUTING.md) for detailed development setup, testing guidelines, and contribution requirements.
 

package/dist/cjs/formatter/emoji-data.cjs

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Emoji data for context-aware logging
+ * Based on gitmoji.dev emoji set
+ * Each entry maps emoji to keywords that help identify when to use it
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_EMOJI = exports.EMOJI_MAPPINGS = void 0;
+/**
+ * Curated emoji mappings for context-aware logging
+ * Based on the gitmoji set from https://gitmoji.dev
+ * Ordered by specificity - more specific keywords first
+ */
+exports.EMOJI_MAPPINGS = [
+    // More specific contexts first
+    // Database (specific)
+    { emoji: '🗃️', code: ':card_file_box:', description: 'Database related', keywords: ['database', 'db', 'sql', 'query', 'table', 'schema', 'migration', 'mongo', 'postgres', 'mysql'] },
+    // Deployment and releases (specific)
+    { emoji: '🚀', code: ':rocket:', description: 'Deploy or release', keywords: ['deploy', 'deployed', 'deployment', 'release', 'launched', 'production'] },
+    // Performance (specific)
+    { emoji: '⚡️', code: ':zap:', description: 'Improve performance', keywords: ['performance', 'speed', 'optimize', 'fast', 'slow', 'latency', 'throughput'] },
+    // Security (specific)
+    { emoji: '🔒️', code: ':lock:', description: 'Fix security issues', keywords: ['security', 'secure', 'vulnerability', 'exploit', 'auth', 'authentication', 'authorization', 'permission'] },
+    // Critical issues (specific)
+    { emoji: '🚑️', code: ':ambulance:', description: 'Critical hotfix', keywords: ['critical', 'hotfix', 'urgent', 'emergency', 'crash', 'fatal'] },
+    // Bugs and fixes (specific)
+    { emoji: '🐛', code: ':bug:', description: 'Fix a bug', keywords: ['bug', 'fix', 'fixed', 'fixing', 'defect', 'issue'] },
+    // Less specific/generic contexts last
+    // Errors and failures (generic)
+    { emoji: '❌', code: ':x:', description: 'Error or failure', keywords: ['error', 'fail', 'failed', 'failure', 'exception', 'reject'] },
+    { emoji: '🔥', code: ':fire:', description: 'Remove code or files', keywords: ['remove', 'delete', 'deprecated', 'obsolete'] },
+    { emoji: '🐌', code: ':snail:', description: 'Slow performance', keywords: ['timeout', 'hang', 'freeze'] },
+    { emoji: '🔓️', code: ':unlock:', description: 'Unlock or access', keywords: ['unlock', 'access', 'grant', 'allow'] },
+    { emoji: '💾', code: ':floppy_disk:', description: 'Save or persist data', keywords: ['save', 'saved', 'saving', 'persist', 'write', 'store'] },
+    { emoji: '🎉', code: ':tada:', description: 'Initial commit or milestone', keywords: ['initial', 'milestone', 'celebrate', 'success', 'complete'] },
+    // Configuration
+    { emoji: '🔧', code: ':wrench:', description: 'Configuration changes', keywords: ['config', 'configuration', 'setting', 'settings', 'configure'] },
+    { emoji: '⚙️', code: ':gear:', description: 'Configuration or settings', keywords: ['setup', 'init', 'initialize'] },
+    // API and network
+    { emoji: '🌐', code: ':globe_with_meridians:', description: 'Network or internet', keywords: ['network', 'internet', 'http', 'https', 'request', 'response', 'api', 'endpoint'] },
+    { emoji: '🔌', code: ':electric_plug:', description: 'Connection or plugin', keywords: ['connect', 'connection', 'disconnect', 'plugin', 'integration'] },
+    // Testing
+    { emoji: '✅', code: ':white_check_mark:', description: 'Tests passing', keywords: ['tests', 'testing', 'pass', 'passed', 'validation', 'validate'] },
+    { emoji: '🧪', code: ':test_tube:', description: 'Running tests', keywords: ['experiment', 'trial', 'spec'] },
+    // Documentation
+    { emoji: '📝', code: ':memo:', description: 'Add or update documentation', keywords: ['document', 'documentation', 'docs', 'readme', 'comment'] },
+    { emoji: '💡', code: ':bulb:', description: 'New idea or insight', keywords: ['idea', 'insight', 'suggestion', 'tip', 'hint'] },
+    // Dependencies
+    { emoji: '➕', code: ':heavy_plus_sign:', description: 'Add dependency', keywords: ['add', 'added', 'adding', 'install', 'dependency', 'package'] },
+    { emoji: '➖', code: ':heavy_minus_sign:', description: 'Remove dependency', keywords: ['uninstall', 'removed'] },
+    { emoji: '⬆️', code: ':arrow_up:', description: 'Upgrade dependencies', keywords: ['upgrade', 'update', 'updated'] },
+    { emoji: '⬇️', code: ':arrow_down:', description: 'Downgrade dependencies', keywords: ['downgrade', 'rollback'] },
+    // Files and structure
+    { emoji: '📦', code: ':package:', description: 'Update compiled files', keywords: ['package', 'build', 'compile', 'bundle'] },
+    { emoji: '🚚', code: ':truck:', description: 'Move or rename files', keywords: ['move', 'moved', 'rename', 'renamed', 'relocate'] },
+    // Work in progress
+    { emoji: '🚧', code: ':construction:', description: 'Work in progress', keywords: ['wip', 'progress', 'working', 'ongoing', 'incomplete'] },
+    // Breaking changes
+    { emoji: '💥', code: ':boom:', description: 'Breaking changes', keywords: ['breaking', 'break', 'incompatible'] },
+    // Accessibility
+    { emoji: '♿️', code: ':wheelchair:', description: 'Improve accessibility', keywords: ['accessibility', 'a11y', 'accessible'] },
+    // Internationalization
+    { emoji: '🌍', code: ':earth_africa:', description: 'Internationalization', keywords: ['i18n', 'localization', 'l10n', 'translation', 'language'] },
+    // UI and styling
+    { emoji: '💄', code: ':lipstick:', description: 'Update UI and style', keywords: ['ui', 'style', 'css', 'design', 'interface', 'layout'] },
+    { emoji: '🎨', code: ':art:', description: 'Improve structure', keywords: ['refactor', 'refactoring', 'restructure', 'format'] },
+    // Logging and monitoring
+    { emoji: '🔊', code: ':loud_sound:', description: 'Add or update logs', keywords: ['logging', 'trace'] },
+    { emoji: '🔇', code: ':mute:', description: 'Remove logs', keywords: ['silent', 'quiet', 'mute'] },
+    { emoji: '📊', code: ':bar_chart:', description: 'Analytics or metrics', keywords: ['analytics', 'metrics', 'stats', 'statistics', 'monitor', 'monitoring'] },
+    // Code review
+    { emoji: '👌', code: ':ok_hand:', description: 'Code review changes', keywords: ['review', 'approve', 'approved', 'lgtm'] },
+    // Catch-all for new features (put last)
+    { emoji: '✨', code: ':sparkles:', description: 'New feature', keywords: ['feature', 'new', 'enhancement', 'improve', 'improved'] },
+];
+/**
+ * Default fallback emoji for each log level
+ * These are used when no context-specific emoji matches
+ */
+exports.FALLBACK_EMOJI = {
+    DEBUG: '🐞',
+    INFO: 'ℹ️',
+    WARN: '⚠️',
+    ERROR: '❌',
+    LOG: '✅'
+};
+//# sourceMappingURL=emoji-data.js.map

package/dist/cjs/formatter/emoji-data.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Emoji data for context-aware logging
+ * Based on gitmoji.dev emoji set
+ * Each entry maps emoji to keywords that help identify when to use it
+ */
+import { EmojiMapping } from '../types';
+/**
+ * Curated emoji mappings for context-aware logging
+ * Based on the gitmoji set from https://gitmoji.dev
+ * Ordered by specificity - more specific keywords first
+ */
+export declare const EMOJI_MAPPINGS: EmojiMapping[];
+/**
+ * Default fallback emoji for each log level
+ * These are used when no context-specific emoji matches
+ */
+export declare const FALLBACK_EMOJI: Record<'DEBUG' | 'INFO' | 'WARN' | 'ERROR' | 'LOG', string>;
+//# sourceMappingURL=emoji-data.d.ts.map

package/dist/cjs/formatter/emoji-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emoji-data.d.ts","sourceRoot":"","sources":["../../../src/formatter/emoji-data.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,YAAY,EAsFxC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,EAAE,MAAM,CAMtF,CAAC"}

package/dist/cjs/formatter/emoji-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emoji-data.js","sourceRoot":"","sources":["../../../src/formatter/emoji-data.ts"],"names":[],"mappings":"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"}

package/dist/cjs/formatter/emoji-selector.cjs

@@ -0,0 +1,216 @@
+"use strict";
+/**
+ * Emoji selector for context-aware logging
+ * Analyzes log messages to select appropriate emoji based on context
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmojiSelector = void 0;
+const types_1 = require("../types/index.cjs");
+const emoji_data_1 = require("./emoji-data.cjs");
+/**
+ * Emoji selector class
+ * Provides context-aware emoji selection for log messages
+ */
+class EmojiSelector {
+    /**
+     * Configure the emoji selector
+     * @param config - Configuration options
+     */
+    static configure(config) {
+        EmojiSelector.config = {
+            ...EmojiSelector.config,
+            ...config
+        };
+        // Invalidate compiled cache when config changes
+        EmojiSelector.compiledMappings = null;
+    }
+    /**
+     * Get current configuration
+     * @returns Current emoji configuration
+     */
+    static getConfig() {
+        const { customMappings = [], customFallbacks = {}, ...rest } = EmojiSelector.config;
+        return {
+            ...rest,
+            customMappings: [...customMappings],
+            customFallbacks: { ...customFallbacks }
+        };
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    static reset() {
+        EmojiSelector.config = {
+            customMappings: [],
+            customFallbacks: {},
+            useCustomOnly: false
+        };
+        // Clear compiled cache
+        EmojiSelector.compiledMappings = null;
+    }
+    /**
+     * Get compiled emoji mappings with precompiled regex patterns
+     * This is cached to avoid recompiling regex on every log line
+     */
+    static getCompiledMappings() {
+        if (EmojiSelector.compiledMappings) {
+            return EmojiSelector.compiledMappings;
+        }
+        const { customMappings = [], useCustomOnly } = EmojiSelector.config;
+        const mappings = useCustomOnly ? customMappings : [...customMappings, ...emoji_data_1.EMOJI_MAPPINGS];
+        EmojiSelector.compiledMappings = mappings.map(mapping => ({
+            ...mapping,
+            regexes: mapping.keywords.map(keyword => {
+                // Escape regex metacharacters to prevent ReDoS and invalid patterns
+                const escapedKeyword = keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+                // Precompile regex for performance
+                return new RegExp(`\\b${escapedKeyword}\\b`, 'i');
+            })
+        }));
+        return EmojiSelector.compiledMappings;
+    }
+    /**
+     * Select appropriate emoji based on log level and message content
+     * @param level - Log level
+     * @param message - Log message
+     * @param data - Optional log data
+     * @returns Selected emoji or empty string
+     */
+    static selectEmoji(level, message, data) {
+        // Try to find context-aware emoji
+        const contextEmoji = EmojiSelector.findContextEmoji(message, data);
+        if (contextEmoji) {
+            return contextEmoji;
+        }
+        // Fall back to level-based emoji
+        return EmojiSelector.getFallbackEmoji(level);
+    }
+    /**
+     * Find emoji based on message and data context
+     * @param message - Log message
+     * @param data - Optional log data
+     * @returns Emoji if match found, null otherwise
+     */
+    static findContextEmoji(message, data) {
+        const searchText = EmojiSelector.prepareSearchText(message, data);
+        const compiledMappings = EmojiSelector.getCompiledMappings();
+        // Search through compiled mappings for keyword matches
+        for (const mapping of compiledMappings) {
+            if (EmojiSelector.matchesWithCompiledRegexes(searchText, mapping.regexes)) {
+                return mapping.emoji;
+            }
+        }
+        return null;
+    }
+    /**
+     * Get combined mappings (custom + default or custom only)
+     * @returns Array of emoji mappings
+     * @deprecated Use getCompiledMappings() for better performance
+     */
+    static getMappings() {
+        const { customMappings = [], useCustomOnly = false } = EmojiSelector.config;
+        if (useCustomOnly) {
+            return customMappings;
+        }
+        // Merge custom mappings first (higher priority) with defaults
+        return [...customMappings, ...emoji_data_1.EMOJI_MAPPINGS];
+    }
+    /**
+     * Prepare text for searching by combining message and data
+     * @param message - Log message
+     * @param data - Optional log data
+     * @returns Lowercase combined text
+     */
+    static prepareSearchText(message, data) {
+        let text = message.toLowerCase();
+        // If data is provided and is an object, include its keys and string values
+        if (data && typeof data === 'object') {
+            try {
+                const dataStr = JSON.stringify(data).toLowerCase();
+                text += ' ' + dataStr;
+            }
+            catch {
+                // Ignore circular references or stringify errors
+            }
+        }
+        else if (data && typeof data === 'string') {
+            text += ' ' + data.toLowerCase();
+        }
+        return text;
+    }
+    /**
+     * Check if search text matches any of the precompiled regexes
+     * @param searchText - Lowercase text to search in
+     * @param regexes - Precompiled regex patterns
+     * @returns true if any regex matches
+     */
+    static matchesWithCompiledRegexes(searchText, regexes) {
+        return regexes.some(regex => regex.test(searchText));
+    }
+    /**
+     * Check if search text matches any of the keywords
+     * @param searchText - Lowercase text to search in
+     * @param keywords - Keywords to look for
+     * @returns true if any keyword matches
+     * @deprecated Use matchesWithCompiledRegexes() for better performance
+     */
+    static matchesKeywords(searchText, keywords) {
+        return keywords.some(keyword => {
+            // Escape regex metacharacters to prevent ReDoS and invalid patterns
+            const escapedKeyword = keyword.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+            // Use word boundary matching for more accurate results
+            // Safe: escapedKeyword is sanitized by regex escape above
+            // eslint-disable-next-line security/detect-non-literal-regexp
+            const regex = new RegExp(`\\b${escapedKeyword}\\b`, 'i');
+            return regex.test(searchText);
+        });
+    }
+    /**
+     * Get fallback emoji for a given log level
+     * @param level - Log level
+     * @returns Fallback emoji for the level
+     */
+    static getFallbackEmoji(level) {
+        const levelName = EmojiSelector.getLevelName(level);
+        // Explicitly handle unknown levels: no emoji by default
+        if (levelName === 'UNKNOWN') {
+            return '';
+        }
+        const { customFallbacks = {} } = EmojiSelector.config;
+        // Check custom fallbacks first
+        // Safe: levelName is constrained to specific log level strings
+        // eslint-disable-next-line security/detect-object-injection
+        if (levelName in customFallbacks && customFallbacks[levelName]) {
+            // eslint-disable-next-line security/detect-object-injection
+            return customFallbacks[levelName] || '';
+        }
+        // Use default fallback
+        // Safe: levelName is constrained to specific log level strings
+        // eslint-disable-next-line security/detect-object-injection
+        return emoji_data_1.FALLBACK_EMOJI[levelName] || '';
+    }
+    /**
+     * Convert LogLevel enum to string
+     * @param level - Log level
+     * @returns Level name as string
+     */
+    static getLevelName(level) {
+        switch (level) {
+            case types_1.LogLevel.DEBUG: return 'DEBUG';
+            case types_1.LogLevel.INFO: return 'INFO';
+            case types_1.LogLevel.WARN: return 'WARN';
+            case types_1.LogLevel.ERROR: return 'ERROR';
+            case types_1.LogLevel.LOG: return 'LOG';
+            default: return 'UNKNOWN';
+        }
+    }
+}
+exports.EmojiSelector = EmojiSelector;
+EmojiSelector.config = {
+    customMappings: [],
+    customFallbacks: {},
+    useCustomOnly: false
+};
+// Cache for precompiled regex patterns
+EmojiSelector.compiledMappings = null;
+//# sourceMappingURL=emoji-selector.js.map

package/dist/cjs/formatter/emoji-selector.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Emoji selector for context-aware logging
+ * Analyzes log messages to select appropriate emoji based on context
+ */
+import { LogLevel, LogData, EmojiConfig } from '../types';
+/**
+ * Emoji selector class
+ * Provides context-aware emoji selection for log messages
+ */
+export declare class EmojiSelector {
+    private static config;
+    private static compiledMappings;
+    /**
+     * Configure the emoji selector
+     * @param config - Configuration options
+     */
+    static configure(config: Partial<EmojiConfig>): void;
+    /**
+     * Get current configuration
+     * @returns Current emoji configuration
+     */
+    static getConfig(): EmojiConfig;
+    /**
+     * Reset configuration to defaults
+     */
+    static reset(): void;
+    /**
+     * Get compiled emoji mappings with precompiled regex patterns
+     * This is cached to avoid recompiling regex on every log line
+     */
+    private static getCompiledMappings;
+    /**
+     * Select appropriate emoji based on log level and message content
+     * @param level - Log level
+     * @param message - Log message
+     * @param data - Optional log data
+     * @returns Selected emoji or empty string
+     */
+    static selectEmoji(level: LogLevel, message: string, data?: LogData): string;
+    /**
+     * Find emoji based on message and data context
+     * @param message - Log message
+     * @param data - Optional log data
+     * @returns Emoji if match found, null otherwise
+     */
+    private static findContextEmoji;
+    /**
+     * Get combined mappings (custom + default or custom only)
+     * @returns Array of emoji mappings
+     * @deprecated Use getCompiledMappings() for better performance
+     */
+    private static getMappings;
+    /**
+     * Prepare text for searching by combining message and data
+     * @param message - Log message
+     * @param data - Optional log data
+     * @returns Lowercase combined text
+     */
+    private static prepareSearchText;
+    /**
+     * Check if search text matches any of the precompiled regexes
+     * @param searchText - Lowercase text to search in
+     * @param regexes - Precompiled regex patterns
+     * @returns true if any regex matches
+     */
+    private static matchesWithCompiledRegexes;
+    /**
+     * Check if search text matches any of the keywords
+     * @param searchText - Lowercase text to search in
+     * @param keywords - Keywords to look for
+     * @returns true if any keyword matches
+     * @deprecated Use matchesWithCompiledRegexes() for better performance
+     */
+    private static matchesKeywords;
+    /**
+     * Get fallback emoji for a given log level
+     * @param level - Log level
+     * @returns Fallback emoji for the level
+     */
+    private static getFallbackEmoji;
+    /**
+     * Convert LogLevel enum to string
+     * @param level - Log level
+     * @returns Level name as string
+     */
+    private static getLevelName;
+}
+//# sourceMappingURL=emoji-selector.d.ts.map

package/dist/cjs/formatter/emoji-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emoji-selector.d.ts","sourceRoot":"","sources":["../../../src/formatter/emoji-selector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAgB,MAAM,UAAU,CAAC;AAcxE;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,MAAM,CAInB;IAGF,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAuC;IAEtE;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,IAAI;IASpD;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,WAAW;IAU/B;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;IAUpB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAqBlC;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM;IAW5E;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAc/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAW1B;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAkBhC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAIzC;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAY9B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAwB/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAU5B"}