@wgtechlabs/log-engine 2.2.2 → 2.3.0-dev.aafa39c

package/README.md

@@ -1,35 +1,27 @@
-# Log Engine 📜🚂 [![made by](https://img.shields.io/badge/made%20by-WG%20Tech%20Labs-0060a0.svg?logo=github&longCache=true&labelColor=181717&style=flat-square)](https://github.com/wgtechlabs)
+# @wgtechlabs/log-engine
 
-[![codecov](https://img.shields.io/codecov/c/github/wgtechlabs/log-engine?token=PWRJTBVKQ9&style=flat-square&logo=codecov&labelColor=181717)](https://codecov.io/gh/wgtechlabs/log-engine) [![npm downloads](https://img.shields.io/npm/dm/%40wgtechlabs%2Flog-engine?style=flat-square&logo=npm&label=installs&labelColor=181717&color=%23CD0000)](https://www.npmjs.com/package/@wgtechlabs/log-engine) [![sponsors](https://img.shields.io/badge/sponsor-%E2%9D%A4-%23db61a2.svg?&logo=github&logoColor=white&labelColor=181717&style=flat-square)](https://github.com/sponsors/wgtechlabs) [![release](https://img.shields.io/github/release/wgtechlabs/log-engine.svg?logo=github&labelColor=181717&color=green&style=flat-square)](https://github.com/wgtechlabs/log-engine/releases) [![star](https://img.shields.io/github/stars/wgtechlabs/log-engine.svg?&logo=github&labelColor=181717&color=yellow&style=flat-square)](https://github.com/wgtechlabs/log-engine/stargazers) [![license](https://img.shields.io/github/license/wgtechlabs/log-engine.svg?&logo=github&labelColor=181717&style=flat-square)](https://github.com/wgtechlabs/log-engine/blob/main/license)
-
-[![banner](https://raw.githubusercontent.com/wgtechlabs/log-engine/main/.github/assets/repo_banner.jpg)](https://github.com/wgtechlabs/log-engine)
+![GitHub Repo Banner](https://ghrb.waren.build/banner?header=log-engine+%F0%9F%93%9C%F0%9F%9A%82&subheader=ultimate+logging+solution&bg=016EEA&color=FFFFFF&headerfont=Google+Sans+Code&subheaderfont=Kinewave&watermarkpos=bottom-right)
+<!-- Created with GitHub Repo Banner by Waren Gonzaga: https://ghrb.waren.build -->
 
-WG's Log Engine is the **ultimate logging solution for Node.js developers** - a lightweight, battle-tested utility specifically engineered for Discord bots, Telegram bots, web servers, APIs, and server-side applications. Born from real-world development challenges and proven in production environments like the [Unthread Discord Bot](https://github.com/wgtechlabs/unthread-discord-bot/), Log Engine delivers enterprise-grade logging with zero complexity, beautiful color-coded console output, **revolutionary configurable output routing**, and **advanced automatic data redaction with comprehensive PII protection**.
+[![codecov](https://img.shields.io/codecov/c/github/wgtechlabs/log-engine?token=PWRJTBVKQ9&style=flat-square&logo=codecov&labelColor=181717)](https://codecov.io/gh/wgtechlabs/log-engine) [![npm downloads](https://img.shields.io/npm/dm/%40wgtechlabs%2Flog-engine?style=flat-square&logo=npm&label=installs&labelColor=181717&color=%23CD0000)](https://www.npmjs.com/package/@wgtechlabs/log-engine) [![sponsors](https://img.shields.io/badge/sponsor-%E2%9D%A4-%23db61a2.svg?&logo=github&logoColor=white&labelColor=181717&style=flat-square)](https://github.com/sponsors/wgtechlabs) [![release](https://img.shields.io/github/release/wgtechlabs/log-engine.svg?logo=github&labelColor=181717&color=green&style=flat-square)](https://github.com/wgtechlabs/log-engine/releases) [![star](https://img.shields.io/github/stars/wgtechlabs/log-engine.svg?&logo=github&labelColor=181717&color=yellow&style=flat-square)](https://github.com/wgtechlabs/log-engine/stargazers) [![license](https://img.shields.io/github/license/wgtechlabs/log-engine.svg?&logo=github&labelColor=181717&style=flat-square)](https://github.com/wgtechlabs/log-engine/blob/main/license)
 
-**The first logging library with built-in advanced PII protection, configurable output handlers, and comprehensive TypeScript support.** Stop wrestling with logging configurations and start building amazing applications safely. Whether you're creating the next viral Discord community bot, building high-performance APIs, developing microservices, or deploying production servers, Log Engine provides intelligent logging with vibrant colors, flexible output routing to any destination, advanced customizable redaction patterns, and automatic sensitive data protection that scales with your application's growth - from your first "Hello World" to handling millions of requests across distributed systems.
+Log Engine is a lightweight, zero-dependency logging library for Node.js, built because logging should protect sensitive data and just work, without complex configs or security afterthoughts. Through automatic environment detection, **built-in PII redaction**, **configurable output routing**, color-coded console output, and full TypeScript support, it delivers enterprise-grade logging for Discord bots, web servers, APIs, and any server-side application. Proven in production environments like the [Unthread Discord Bot](https://github.com/wgtechlabs/unthread-discord-bot/).
 
 ## ❣️ Motivation
 
-Picture this: It's 2 AM, your server is crashing in production, and you're staring at a terminal filled with thousands of debug messages mixed with critical errors. Sound familiar? I've been there too many times. I created Log Engine because every developer deserves to sleep peacefully, knowing their logs are working intelligently in the background.
-
-Log Engine transforms your development experience from chaotic debugging sessions into confident, data-driven problem solving. No more guessing what went wrong, no more drowning in irrelevant logs, no more manual configuration headaches. Just clear, contextual information exactly when and where you need it. Because great applications deserve great logging, and great developers deserve tools that just work.
+I created Log Engine after too many 2 AM debugging sessions, staring at terminals flooded with noise while hunting for the one error that matters. Every developer deserves clear, contextual logs that just work, no guessing, no configuration headaches, no drowning in irrelevant output. Great applications deserve great logging.
 
 ## ✨ Key Features
 
-- **🔒 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.
-- **🎯 Dynamic Field Management**: Runtime configuration of sensitive fields with case-insensitive matching and partial field name detection.
-- **🛠️ Developer-Friendly API**: Advanced redaction methods including `testFieldRedaction()`, `withoutRedaction()`, and comprehensive configuration management.
-- **📊 Comprehensive TypeScript Support**: Full type definitions with 15+ interfaces covering all functionality for maximum developer experience and IDE support.
-- **🚀 Lightweight & Fast**: Minimal overhead with maximum performance - designed to enhance your application, not slow it down.
-- **📚 No Learning Curve**: Dead simple API that you can master in seconds. No extensive documentation, complex configurations, or setup required - Log Engine works instantly.
-- **🌈 Colorized Console Output**: Beautiful ANSI color-coded log levels with intelligent terminal formatting - instantly identify message severity at a glance with color-coded output.
-- **🎛️ Multiple Log Modes**: Support for DEBUG, INFO, WARN, ERROR, SILENT, OFF, and special LOG levels with smart filtering - just set your mode and let it handle the rest.
-- **⚙️ 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.
-- **🔌 Easy Integration**: Simple API that works seamlessly with existing Node.js applications. Just `import` and start logging - no middleware, plugins, or configuration required.
+- **🔒 Advanced Data Redaction** — Built-in PII protection with custom regex patterns, dynamic field management, and environment-based configuration. Security-first logging by default.
+- **🎯 Configurable Output Handlers** — Route logs to any destination: files, HTTP endpoints, databases, or multiple outputs simultaneously.
+- **🎨 Context-Aware Emoji** — Intelligent emoji selection based on log content with 37 curated gitmoji mappings, fully customizable.
+- **🌈 Color-Coded Console Output** — ANSI color-coded levels and timestamps for instant severity recognition.
+- **🎛️ Multiple Log Modes** — DEBUG, INFO, WARN, ERROR, SILENT, OFF, and a special always-visible LOG level.
+- **⚙️ Auto-Configuration** — Detects `NODE_ENV` and sets appropriate log levels automatically. No setup required.
+- **📊 Full TypeScript Support** — 15+ type definitions and interfaces for complete IDE support.
+- **🔗 Zero Dependencies** — No external dependencies. Lightweight with automated bundle size monitoring under 1MB.
+- **🔌 Simple API** — Just `import` and start logging. No middleware, plugins, or configuration files needed.
 
 ## ⚠️ Breaking Changes Notice
 
@@ -327,15 +319,15 @@ LogEngine.log('Critical message'); // ❌ Hidden with OFF - complete silence!
 
 ### Log Format
 
-Log messages are beautifully formatted with colorized timestamps, levels, and smart terminal output:
+Log messages are formatted with colorized timestamps, levels, context-aware emoji, and smart terminal output:
 
 ```bash
 # Example colorized output (colors visible in terminal)
-[2025-05-29T16:57:45.678Z][4:57PM][DEBUG]: Debugging application flow
-[2025-05-29T16:57:46.123Z][4:57PM][INFO]: Server started successfully  
-[2025-05-29T16:57:47.456Z][4:57PM][WARN]: API rate limit approaching
-[2025-05-29T16:57:48.789Z][4:57PM][ERROR]: Database connection failed
-[2025-05-29T16:57:49.012Z][4:57PM][LOG]: Application startup complete
+[2025-05-29T16:57:45.678Z][4:57PM][DEBUG][🐞]: Debugging application flow
+[2025-05-29T16:57:46.123Z][4:57PM][INFO][🚀]: Server started successfully  
+[2025-05-29T16:57:47.456Z][4:57PM][WARN][⚡️]: API rate limit approaching
+[2025-05-29T16:57:48.789Z][4:57PM][ERROR][🗃️]: Database connection failed
+[2025-05-29T16:57:49.012Z][4:57PM][LOG][✅]: Application startup complete
 ```
 
 **Color Scheme:**
@@ -346,6 +338,7 @@ Log messages are beautifully formatted with colorized timestamps, levels, and sm
 - 🔴 **ERROR**: Red - Error messages requiring immediate action
 - 🟢 **LOG**: Green - Critical messages that always display
 - ⚫ **Timestamps**: Gray (ISO) and Cyan (local time) for easy scanning
+- 🎨 **Emoji**: Context-aware emoji selected based on log content (can be disabled via `includeEmoji: false`)
 
 ### Customizing Log Elements
 
@@ -353,10 +346,11 @@ Log messages are beautifully formatted with colorized timestamps, levels, and sm
 
 #### Available Customization Options
 
-You can control the inclusion of timestamp elements:
+You can control the inclusion of these elements:
 
 - **ISO Timestamp**: `[2025-05-29T16:57:45.678Z]` - Precise UTC timestamp
 - **Local Time**: `[4:57PM]` - Human-readable local time
+- **Emoji**: `[🚀]` - Context-aware emoji indicator (enabled by default)
 - **Log Level**: `[INFO]` - Always included (non-customizable as per design)
 
 #### Format Configuration Examples
@@ -364,10 +358,10 @@ You can control the inclusion of timestamp elements:
 ```typescript
 import { LogEngine, LogMode } from '@wgtechlabs/log-engine';
 
-// Default format (backward compatible)
+// Default format (backward compatible - emoji enabled by default)
 LogEngine.configure({ mode: LogMode.DEBUG });
 LogEngine.info('Server started');
-// Output: [2025-05-29T16:57:45.678Z][4:57PM][INFO]: Server started
+// Output: [2025-05-29T16:57:45.678Z][4:57PM][INFO][🚀]: Server started
 
 // Only ISO timestamp
 LogEngine.configure({ 
@@ -378,7 +372,7 @@ LogEngine.configure({
   }
 });
 LogEngine.info('Database connected');
-// Output: [2025-05-29T16:57:45.678Z][INFO]: Database connected
+// Output: [2025-05-29T16:57:45.678Z][INFO][🗃️]: Database connected
 
 // Only local time
 LogEngine.configure({ 
@@ -389,14 +383,15 @@ LogEngine.configure({
   }
 });
 LogEngine.warn('Rate limit approaching');
-// Output: [4:57PM][WARN]: Rate limit approaching
+// Output: [4:57PM][WARN][⚡️]: Rate limit approaching
 
-// Minimal format (no timestamps)
+// Minimal format (no timestamps, no emoji)
 LogEngine.configure({ 
   mode: LogMode.DEBUG,
   format: {
     includeIsoTimestamp: false,
-    includeLocalTime: false
+    includeLocalTime: false,
+    includeEmoji: false
   }
 });
 LogEngine.error('Connection failed');
@@ -413,6 +408,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:
+
+```text
+[ISO_TIMESTAMP][LOCAL_TIME][LEVEL][EMOJI]: message [data]
+```
+
+Example:
+```text
+[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.
@@ -901,7 +1097,8 @@ 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 validate` - Run full validation (lint + test + build)
+- `pnpm size:check` - Check bundle size to maintain lightweight feature
+- `pnpm validate` - Run full validation (lint + test + build + size check)
 
 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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"}