@wgtechlabs/log-engine 2.2.2 → 2.3.0-dev.8fdf09c

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

@@ -0,0 +1,209 @@
+"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
+                // eslint-disable-next-line security/detect-non-literal-regexp -- Safe: keyword is escaped above to prevent ReDoS
+                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;
+    }
+    /**
+     * 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 only keys for analysis
+        // Avoid expensive JSON.stringify on full object to optimize performance
+        if (data && typeof data === 'object') {
+            try {
+                const keys = Object.keys(data).join(' ').toLowerCase();
+                text += ' ' + keys;
+            }
+            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));
+    }
+    /**
+     * 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 using safe property access
+        if (Object.prototype.hasOwnProperty.call(customFallbacks, levelName)) {
+            switch (levelName) {
+                case 'DEBUG':
+                    return customFallbacks.DEBUG || '';
+                case 'INFO':
+                    return customFallbacks.INFO || '';
+                case 'WARN':
+                    return customFallbacks.WARN || '';
+                case 'ERROR':
+                    return customFallbacks.ERROR || '';
+                case 'LOG':
+                    return customFallbacks.LOG || '';
+                default:
+                    // levelName is type-constrained, but default defensively returns empty
+                    return '';
+            }
+        }
+        // Use default fallback with explicit switch
+        switch (levelName) {
+            case 'DEBUG':
+                return emoji_data_1.FALLBACK_EMOJI.DEBUG;
+            case 'INFO':
+                return emoji_data_1.FALLBACK_EMOJI.INFO;
+            case 'WARN':
+                return emoji_data_1.FALLBACK_EMOJI.WARN;
+            case 'ERROR':
+                return emoji_data_1.FALLBACK_EMOJI.ERROR;
+            case 'LOG':
+                return emoji_data_1.FALLBACK_EMOJI.LOG;
+            default:
+                return '';
+        }
+    }
+    /**
+     * 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,74 @@
+/**
+ * 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;
+    /**
+     * 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;
+    /**
+     * 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,EAAE,MAAM,UAAU,CAAC;AAc1D;;;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;IAsBlC;;;;;;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;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAmBhC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAIzC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA8C/B;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;CAU5B"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"emoji-selector.js","sourceRoot":"","sources":["../../../src/formatter/emoji-selector.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,oCAA0D;AAC1D,6CAA8D;AAa9D;;;GAGG;AACH,MAAa,aAAa;IAUxB;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,MAA4B;QAC3C,aAAa,CAAC,MAAM,GAAG;YACrB,GAAG,aAAa,CAAC,MAAM;YACvB,GAAG,MAAM;SACV,CAAC;QACF,gDAAgD;QAChD,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS;QACd,MAAM,EAAE,cAAc,GAAG,EAAE,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC;QAEpF,OAAO;YACL,GAAG,IAAI;YACP,cAAc,EAAE,CAAC,GAAG,cAAc,CAAC;YACnC,eAAe,EAAE,EAAE,GAAG,eAAe,EAAE;SACxC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,aAAa,CAAC,MAAM,GAAG;YACrB,cAAc,EAAE,EAAE;YAClB,eAAe,EAAE,EAAE;YACnB,aAAa,EAAE,KAAK;SACrB,CAAC;QACF,uBAAuB;QACvB,aAAa,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACxC,CAAC;IAED;;;OAGG;IACK,MAAM,CAAC,mBAAmB;QAChC,IAAI,aAAa,CAAC,gBAAgB,EAAE,CAAC;YACnC,OAAO,aAAa,CAAC,gBAAgB,CAAC;QACxC,CAAC;QAED,MAAM,EAAE,cAAc,GAAG,EAAE,EAAE,aAAa,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC;QACpE,MAAM,QAAQ,GAAG,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAAG,cAAc,EAAE,GAAG,2BAAc,CAAC,CAAC;QAEzF,aAAa,CAAC,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxD,GAAG,OAAO;YACV,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE;gBACtC,oEAAoE;gBACpE,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;gBACtE,mCAAmC;gBACnC,iHAAiH;gBACjH,OAAO,IAAI,MAAM,CAAC,MAAM,cAAc,KAAK,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC,CAAC;SACH,CAAC,CAAC,CAAC;QAEJ,OAAO,aAAa,CAAC,gBAAgB,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,WAAW,CAAC,KAAe,EAAE,OAAe,EAAE,IAAc;QACjE,kCAAkC;QAClC,MAAM,YAAY,GAAG,aAAa,CAAC,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnE,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,iCAAiC;QACjC,OAAO,aAAa,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,gBAAgB,CAAC,OAAe,EAAE,IAAc;QAC7D,MAAM,UAAU,GAAG,aAAa,CAAC,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,gBAAgB,GAAG,aAAa,CAAC,mBAAmB,EAAE,CAAC;QAE7D,uDAAuD;QACvD,KAAK,MAAM,OAAO,IAAI,gBAAgB,EAAE,CAAC;YACvC,IAAI,aAAa,CAAC,0BAA0B,CAAC,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC1E,OAAO,OAAO,CAAC,KAAK,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,iBAAiB,CAAC,OAAe,EAAE,IAAc;QAC9D,IAAI,IAAI,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;QAEjC,uEAAuE;QACvE,wEAAwE;QACxE,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;gBACvD,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,iDAAiD;YACnD,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5C,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACK,MAAM,CAAC,0BAA0B,CAAC,UAAkB,EAAE,OAAiB;QAC7E,OAAO,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,gBAAgB,CAAC,KAAe;QAC7C,MAAM,SAAS,GAAG,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpD,wDAAwD;QACxD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,EAAE,eAAe,GAAG,EAAE,EAAE,GAAG,aAAa,CAAC,MAAM,CAAC;QAEtD,0DAA0D;QAC1D,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,EAAE,CAAC;YACrE,QAAQ,SAAS,EAAE,CAAC;gBACpB,KAAK,OAAO;oBACV,OAAO,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC;gBACrC,KAAK,MAAM;oBACT,OAAO,eAAe,CAAC,IAAI,IAAI,EAAE,CAAC;gBACpC,KAAK,MAAM;oBACT,OAAO,eAAe,CAAC,IAAI,IAAI,EAAE,CAAC;gBACpC,KAAK,OAAO;oBACV,OAAO,eAAe,CAAC,KAAK,IAAI,EAAE,CAAC;gBACrC,KAAK,KAAK;oBACR,OAAO,eAAe,CAAC,GAAG,IAAI,EAAE,CAAC;gBACnC;oBACE,uEAAuE;oBACvE,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,4CAA4C;QAC5C,QAAQ,SAAS,EAAE,CAAC;YACpB,KAAK,OAAO;gBACV,OAAO,2BAAc,CAAC,KAAK,CAAC;YAC9B,KAAK,MAAM;gBACT,OAAO,2BAAc,CAAC,IAAI,CAAC;YAC7B,KAAK,MAAM;gBACT,OAAO,2BAAc,CAAC,IAAI,CAAC;YAC7B,KAAK,OAAO;gBACV,OAAO,2BAAc,CAAC,KAAK,CAAC;YAC9B,KAAK,KAAK;gBACR,OAAO,2BAAc,CAAC,GAAG,CAAC;YAC5B;gBACE,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,MAAM,CAAC,YAAY,CAAC,KAAe;QACzC,QAAQ,KAAK,EAAE,CAAC;YAChB,KAAK,gBAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC;YACpC,KAAK,gBAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC;YAClC,KAAK,gBAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC;YAClC,KAAK,gBAAQ,CAAC,KAAK,CAAC,CAAC,OAAO,OAAO,CAAC;YACpC,KAAK,gBAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC;YAChC,OAAO,CAAC,CAAC,OAAO,SAAS,CAAC;QAC1B,CAAC;IACH,CAAC;;AAtNH,sCAuNC;AAtNgB,oBAAM,GAAgB;IACnC,cAAc,EAAE,EAAE;IAClB,eAAe,EAAE,EAAE;IACnB,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,uCAAuC;AACxB,8BAAgB,GAAkC,IAAI,CAAC"}

package/dist/cjs/formatter/index.cjs

@@ -4,7 +4,7 @@
  * Provides centralized access to all formatting functionality
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LogFormatter = exports.styleData = exports.formatData = exports.formatTimestamp = exports.getTimestampComponents = exports.colorScheme = exports.colors = exports.MessageFormatter = void 0;
+exports.LogFormatter = exports.FALLBACK_EMOJI = exports.EMOJI_MAPPINGS = exports.EmojiSelector = exports.styleData = exports.formatData = exports.formatTimestamp = exports.getTimestampComponents = exports.colorScheme = exports.colors = exports.MessageFormatter = void 0;
 var message_formatter_1 = require("./message-formatter.cjs");
 Object.defineProperty(exports, "MessageFormatter", { enumerable: true, get: function () { return message_formatter_1.MessageFormatter; } });
 var colors_1 = require("./colors.cjs");
@@ -16,6 +16,11 @@ Object.defineProperty(exports, "formatTimestamp", { enumerable: true, get: funct
 var data_formatter_1 = require("./data-formatter.cjs");
 Object.defineProperty(exports, "formatData", { enumerable: true, get: function () { return data_formatter_1.formatData; } });
 Object.defineProperty(exports, "styleData", { enumerable: true, get: function () { return data_formatter_1.styleData; } });
+var emoji_selector_1 = require("./emoji-selector.cjs");
+Object.defineProperty(exports, "EmojiSelector", { enumerable: true, get: function () { return emoji_selector_1.EmojiSelector; } });
+var emoji_data_1 = require("./emoji-data.cjs");
+Object.defineProperty(exports, "EMOJI_MAPPINGS", { enumerable: true, get: function () { return emoji_data_1.EMOJI_MAPPINGS; } });
+Object.defineProperty(exports, "FALLBACK_EMOJI", { enumerable: true, get: function () { return emoji_data_1.FALLBACK_EMOJI; } });
 // Backward compatibility - maintain the original LogFormatter class interface
 var message_formatter_2 = require("./message-formatter.cjs");
 Object.defineProperty(exports, "LogFormatter", { enumerable: true, get: function () { return message_formatter_2.MessageFormatter; } });

package/dist/cjs/formatter/index.d.ts

@@ -6,5 +6,7 @@ export { MessageFormatter } from './message-formatter';
 export { colors, colorScheme } from './colors';
 export { getTimestampComponents, formatTimestamp } from './timestamp';
 export { formatData, styleData } from './data-formatter';
+export { EmojiSelector } from './emoji-selector';
+export { EMOJI_MAPPINGS, FALLBACK_EMOJI } from './emoji-data';
 export { MessageFormatter as LogFormatter } from './message-formatter';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/formatter/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formatter/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAGzD,OAAO,EAAE,gBAAgB,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/formatter/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAG9D,OAAO,EAAE,gBAAgB,IAAI,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/cjs/formatter/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/formatter/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,mCAA+C;AAAtC,gGAAA,MAAM,OAAA;AAAE,qGAAA,WAAW,OAAA;AAC5B,yCAAsE;AAA7D,mHAAA,sBAAsB,OAAA;AAAE,4GAAA,eAAe,OAAA;AAChD,mDAAyD;AAAhD,4GAAA,UAAU,OAAA;AAAE,2GAAA,SAAS,OAAA;AAE9B,8EAA8E;AAC9E,yDAAuE;AAA9D,iHAAA,gBAAgB,OAAgB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/formatter/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,yDAAuD;AAA9C,qHAAA,gBAAgB,OAAA;AACzB,mCAA+C;AAAtC,gGAAA,MAAM,OAAA;AAAE,qGAAA,WAAW,OAAA;AAC5B,yCAAsE;AAA7D,mHAAA,sBAAsB,OAAA;AAAE,4GAAA,eAAe,OAAA;AAChD,mDAAyD;AAAhD,4GAAA,UAAU,OAAA;AAAE,2GAAA,SAAS,OAAA;AAC9B,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,2CAA8D;AAArD,4GAAA,cAAc,OAAA;AAAE,4GAAA,cAAc,OAAA;AAEvC,8EAA8E;AAC9E,yDAAuE;AAA9D,iHAAA,gBAAgB,OAAgB"}

package/dist/cjs/formatter/message-formatter.cjs

@@ -9,6 +9,7 @@ const types_1 = require("../types/index.cjs");
 const colors_1 = require("./colors.cjs");
 const timestamp_1 = require("./timestamp.cjs");
 const data_formatter_1 = require("./data-formatter.cjs");
+const emoji_selector_1 = require("./emoji-selector.cjs");
 /**
  * Core message formatter class
  * Provides the main formatting functionality for log messages
@@ -21,14 +22,18 @@ class MessageFormatter {
        * @param message - The message content to format
        * @param data - Optional data object to include in the log output
        * @param formatConfig - Optional format configuration to control element inclusion
+       * @param options - Optional per-call options (e.g., emoji override)
        * @returns Formatted string with ANSI colors and timestamps
        */
-    static format(level, message, data, formatConfig) {
+    static format(level, message, data, formatConfig, options) {
         // Merge provided format configuration with the default configuration
         const config = {
             ...MessageFormatter.DEFAULT_FORMAT_CONFIG,
             ...formatConfig
         };
+        // Note: EmojiSelector configuration is handled at the Logger.configure() level
+        // to avoid invalidating the compiled regex cache on every log call.
+        // This preserves the performance optimization of regex precompilation.
         // Build timestamp string conditionally
         let timestamp = '';
         if (config.includeIsoTimestamp || config.includeLocalTime) {
@@ -49,8 +54,23 @@ class MessageFormatter {
         const levelName = MessageFormatter.getLevelName(level);
         const levelColor = MessageFormatter.getLevelColor(level);
         const coloredLevel = `${levelColor}[${levelName}]${colors_1.colors.reset}`;
+        // Select emoji based on context if includeEmoji is true (default)
+        // Use override emoji from options if provided (including empty string to suppress), otherwise use EmojiSelector
+        let emoji = '';
+        if (config.includeEmoji !== false) {
+            if (options?.emoji !== undefined) {
+                // Use override emoji (even if empty string)
+                emoji = options.emoji;
+            }
+            else {
+                // Auto-select emoji
+                emoji = emoji_selector_1.EmojiSelector.selectEmoji(level, message, data);
+            }
+        }
+        const emojiPart = emoji ? `[${emoji}]` : '';
         // Format the base message (level is always included as per requirements)
-        let formattedMessage = `${timestamp}${coloredLevel}: ${message}`;
+        // Format: [TIMESTAMP][LEVEL][EMOJI]: message
+        let formattedMessage = `${timestamp}${coloredLevel}${emojiPart}: ${message}`;
         // Append data if provided
         if (data !== undefined) {
             const dataString = (0, data_formatter_1.formatData)(data);
@@ -132,6 +152,7 @@ exports.MessageFormatter = MessageFormatter;
  */
 MessageFormatter.DEFAULT_FORMAT_CONFIG = {
     includeIsoTimestamp: true,
-    includeLocalTime: true
+    includeLocalTime: true,
+    includeEmoji: true
 };
 //# sourceMappingURL=message-formatter.js.map

package/dist/cjs/formatter/message-formatter.d.ts

@@ -2,7 +2,7 @@
  * Core message formatting functionality
  * Handles the main log message formatting with colors, timestamps, and levels
  */
-import { LogLevel, LogData, LogFormatConfig } from '../types';
+import { LogLevel, LogData, LogFormatConfig, LogCallOptions } from '../types';
 /**
  * Core message formatter class
  * Provides the main formatting functionality for log messages
@@ -19,9 +19,10 @@ export declare class MessageFormatter {
        * @param message - The message content to format
        * @param data - Optional data object to include in the log output
        * @param formatConfig - Optional format configuration to control element inclusion
+       * @param options - Optional per-call options (e.g., emoji override)
        * @returns Formatted string with ANSI colors and timestamps
        */
-    static format(level: LogLevel, message: string, data?: LogData, formatConfig?: LogFormatConfig): string;
+    static format(level: LogLevel, message: string, data?: LogData, formatConfig?: LogFormatConfig, options?: LogCallOptions): string;
     /**
        * Formats a Log Engine system message with [LOG ENGINE] prefix instead of log levels
        * Used for internal messages like deprecation warnings that should be distinguished from user logs

package/dist/cjs/formatter/message-formatter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"message-formatter.d.ts","sourceRoot":"","sources":["../../../src/formatter/message-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK9D;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAG3C;IAEF;;;;;;;;SAQK;IACL,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,eAAe,GAAG,MAAM;IA0CvG;;;;;;SAMK;IACL,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,eAAe,GAAG,MAAM;IA8BnF;;;;SAIK;IACL,OAAO,CAAC,MAAM,CAAC,YAAY;IAW3B;;;;;SAKK;IACL,OAAO,CAAC,MAAM,CAAC,aAAa;CAU7B"}
+{"version":3,"file":"message-formatter.d.ts","sourceRoot":"","sources":["../../../src/formatter/message-formatter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAM9E;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAI3C;IAEF;;;;;;;;;SASK;IACL,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM;IA6DjI;;;;;;SAMK;IACL,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,eAAe,GAAG,MAAM;IA8BnF;;;;SAIK;IACL,OAAO,CAAC,MAAM,CAAC,YAAY;IAW3B;;;;;SAKK;IACL,OAAO,CAAC,MAAM,CAAC,aAAa;CAU7B"}

package/dist/cjs/formatter/message-formatter.js.map

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

package/dist/cjs/index.cjs

@@ -21,7 +21,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RedactionController = exports.defaultRedactionConfig = exports.DataRedactor = exports.LogLevel = exports.LogMode = exports.LogEngine = void 0;
+exports.FALLBACK_EMOJI = exports.EMOJI_MAPPINGS = exports.EmojiSelector = exports.RedactionController = exports.defaultRedactionConfig = exports.DataRedactor = exports.LogLevel = exports.LogMode = exports.LogEngine = void 0;
 const logger_1 = require("./logger/index.cjs");
 const redaction_1 = require("./redaction/index.cjs");
 // Create a singleton logger instance
@@ -46,92 +46,107 @@ exports.LogEngine = {
        * Only shown in DEVELOPMENT mode
        * @param message - The debug message to log
        * @param data - Optional data object to log (sensitive data will be redacted)
+       * @param options - Optional per-call options (e.g., emoji override)
        * @example
        * ```typescript
        * LogEngine.debug('Processing user data', { userId: 123, email: 'user@example.com' });
+       * LogEngine.debug('Starting process', undefined, { emoji: '🔍' });
        * ```
        */
-    debug: (message, data) => logger.debug(message, data),
+    debug: (message, data, options) => logger.debug(message, data, options),
     /**
        * Log an info message with automatic data redaction
        * Shown in DEVELOPMENT and PRODUCTION modes
        * @param message - The info message to log
        * @param data - Optional data object to log (sensitive data will be redacted)
+       * @param options - Optional per-call options (e.g., emoji override)
        * @example
        * ```typescript
        * LogEngine.info('User login successful', { username: 'john' });
+       * LogEngine.info('Database initialized', undefined, { emoji: '✅' });
        * ```
        */
-    info: (message, data) => logger.info(message, data),
+    info: (message, data, options) => logger.info(message, data, options),
     /**
        * Log a warning message with automatic data redaction
        * Shown in DEVELOPMENT and PRODUCTION modes
        * @param message - The warning message to log
        * @param data - Optional data object to log (sensitive data will be redacted)
+       * @param options - Optional per-call options (e.g., emoji override)
        * @example
        * ```typescript
        * LogEngine.warn('API rate limit approaching', { requestsRemaining: 10 });
+       * LogEngine.warn('Low disk space', undefined, { emoji: '💾' });
        * ```
        */
-    warn: (message, data) => logger.warn(message, data),
+    warn: (message, data, options) => logger.warn(message, data, options),
     /**
        * Log an error message with automatic data redaction
        * Shown in DEVELOPMENT and PRODUCTION modes
        * @param message - The error message to log
        * @param data - Optional data object to log (sensitive data will be redacted)
+       * @param options - Optional per-call options (e.g., emoji override)
        * @example
        * ```typescript
        * LogEngine.error('Database connection failed', { host: 'localhost', port: 5432 });
+       * LogEngine.error('Critical failure', undefined, { emoji: '💥' });
        * ```
        */
-    error: (message, data) => logger.error(message, data),
+    error: (message, data, options) => logger.error(message, data, options),
     /**
        * Log a critical message with automatic data redaction
        * Always shown regardless of mode (except OFF)
        * @param message - The critical log message to log
        * @param data - Optional data object to log (sensitive data will be redacted)
+       * @param options - Optional per-call options (e.g., emoji override)
        * @example
        * ```typescript
        * LogEngine.log('Application starting', { version: '1.0.0' });
+       * LogEngine.log('System ready', undefined, { emoji: '🚀' });
        * ```
        */
-    log: (message, data) => logger.log(message, data),
+    log: (message, data, options) => logger.log(message, data, options),
     // Raw methods that bypass redaction (use with caution)
     /**
        * Log a debug message without redaction (use with caution)
        * Bypasses automatic data redaction for debugging purposes
        * @param message - The debug message to log
        * @param data - Optional data object to log (no redaction applied)
+       * @param options - Optional per-call options (e.g., emoji override)
        */
-    debugRaw: (message, data) => logger.debugRaw(message, data),
+    debugRaw: (message, data, options) => logger.debugRaw(message, data, options),
     /**
        * Log an info message without redaction (use with caution)
        * Bypasses automatic data redaction for debugging purposes
        * @param message - The info message to log
        * @param data - Optional data object to log (no redaction applied)
+       * @param options - Optional per-call options (e.g., emoji override)
        */
-    infoRaw: (message, data) => logger.infoRaw(message, data),
+    infoRaw: (message, data, options) => logger.infoRaw(message, data, options),
     /**
        * Log a warning message without redaction (use with caution)
        * Bypasses automatic data redaction for debugging purposes
        * @param message - The warning message to log
        * @param data - Optional data object to log (no redaction applied)
+       * @param options - Optional per-call options (e.g., emoji override)
        */
-    warnRaw: (message, data) => logger.warnRaw(message, data),
+    warnRaw: (message, data, options) => logger.warnRaw(message, data, options),
     /**
        * Log an error message without redaction (use with caution)
        * Bypasses automatic data redaction for debugging purposes
        * @param message - The error message to log
        * @param data - Optional data object to log (no redaction applied)
+       * @param options - Optional per-call options (e.g., emoji override)
        */
-    errorRaw: (message, data) => logger.errorRaw(message, data),
+    errorRaw: (message, data, options) => logger.errorRaw(message, data, options),
     /**
        * Log a critical message without redaction (use with caution)
        * Bypasses automatic data redaction for debugging purposes
        * @param message - The critical log message to log
        * @param data - Optional data object to log (no redaction applied)
+       * @param options - Optional per-call options (e.g., emoji override)
        */
-    logRaw: (message, data) => logger.logRaw(message, data),
+    logRaw: (message, data, options) => logger.logRaw(message, data, options),
     // Redaction configuration methods
     /**
        * Configure data redaction settings
@@ -179,14 +194,15 @@ exports.LogEngine = {
        * @example
        * ```typescript
        * LogEngine.withoutRedaction().info('Debug data', sensitiveObject);
+       * LogEngine.withoutRedaction().info('Custom emoji', undefined, { emoji: '🔍' });
        * ```
        */
     withoutRedaction: () => ({
-        debug: (message, data) => logger.debugRaw(message, data),
-        info: (message, data) => logger.infoRaw(message, data),
-        warn: (message, data) => logger.warnRaw(message, data),
-        error: (message, data) => logger.errorRaw(message, data),
-        log: (message, data) => logger.logRaw(message, data)
+        debug: (message, data, options) => logger.debugRaw(message, data, options),
+        info: (message, data, options) => logger.infoRaw(message, data, options),
+        warn: (message, data, options) => logger.warnRaw(message, data, options),
+        error: (message, data, options) => logger.errorRaw(message, data, options),
+        log: (message, data, options) => logger.logRaw(message, data, options)
     })
 };
 // Re-export types and utilities for external use
@@ -197,6 +213,10 @@ var redaction_2 = require("./redaction/index.cjs");
 Object.defineProperty(exports, "DataRedactor", { enumerable: true, get: function () { return redaction_2.DataRedactor; } });
 Object.defineProperty(exports, "defaultRedactionConfig", { enumerable: true, get: function () { return redaction_2.defaultRedactionConfig; } });
 Object.defineProperty(exports, "RedactionController", { enumerable: true, get: function () { return redaction_2.RedactionController; } });
+var formatter_1 = require("./formatter/index.cjs");
+Object.defineProperty(exports, "EmojiSelector", { enumerable: true, get: function () { return formatter_1.EmojiSelector; } });
+Object.defineProperty(exports, "EMOJI_MAPPINGS", { enumerable: true, get: function () { return formatter_1.EMOJI_MAPPINGS; } });
+Object.defineProperty(exports, "FALLBACK_EMOJI", { enumerable: true, get: function () { return formatter_1.FALLBACK_EMOJI; } });
 // Default export for convenience
 exports.default = exports.LogEngine;
 //# sourceMappingURL=index.js.map