@wgtechlabs/log-engine/dist/esm/logger/filtering.js

A lightweight, security-first logging utility with automatic data redaction for Node.js applications - the first logging library with built-in PII protection.

/**
 * Log level and mode filtering logic
 * Handles the decision logic for whether messages should be logged
 */
import { LogLevel, LogMode } from '../types/index.js';
/**
 * Filtering logic for log messages based on levels and modes
 * Determines whether a message should be output based on current configuration
 */
export class LogFilter {
    /**
       * Determines if a message should be logged based on current log mode
       * Messages are shown only if their level is appropriate for the configured mode
       * LOG level is special - it always outputs regardless of configured mode (except when OFF is set)
       * OFF mode disables all logging including LOG level messages
       * @param level - The log level of the message to check
       * @param currentMode - The current logging mode
       * @returns true if message should be logged, false otherwise
       */
    static shouldLog(level, currentMode) {
        // Get the severity rank for the message level using safe lookup
        const messageSeverity = LogFilter.getSeverityRank(level);
        // Get the minimum severity threshold for the current mode using safe lookup
        const modeThreshold = LogFilter.getModeThreshold(currentMode);
        // Allow the message if its severity meets or exceeds the mode threshold
        return messageSeverity >= modeThreshold;
    }
    /**
       * Get the severity rank for a log level
       * @param level - The log level to get rank for
       * @returns Numeric severity rank
       */
    static getSeverityRank(level) {
        switch (level) {
            case LogLevel.DEBUG: return 0;
            case LogLevel.INFO: return 1;
            case LogLevel.WARN: return 2;
            case LogLevel.ERROR: return 3;
            case LogLevel.LOG: return 99;
            default: return 0;
        }
    }
    /**
       * Get the threshold for a log mode
       * @param mode - The log mode to get threshold for
       * @returns Numeric threshold value
       */
    static getModeThreshold(mode) {
        switch (mode) {
            case LogMode.DEBUG: return 0;
            case LogMode.INFO: return 1;
            case LogMode.WARN: return 2;
            case LogMode.ERROR: return 3;
            case LogMode.SILENT: return 99;
            case LogMode.OFF: return 100;
            default: return 0;
        }
    }
}
// Maps LogLevel values to severity ranks for consistent comparison
LogFilter.SEVERITY_RANKS = {
    [LogLevel.DEBUG]: 0,
    [LogLevel.INFO]: 1,
    [LogLevel.WARN]: 2,
    [LogLevel.ERROR]: 3,
    [LogLevel.LOG]: 99 // Special case - always outputs (except when OFF)
};
// Maps LogMode values to minimum severity rank required for output
LogFilter.MODE_THRESHOLDS = {
    [LogMode.DEBUG]: 0, // Shows DEBUG and above
    [LogMode.INFO]: 1, // Shows INFO and above
    [LogMode.WARN]: 2, // Shows WARN and above
    [LogMode.ERROR]: 3, // Shows ERROR and above
    [LogMode.SILENT]: 99, // Only shows LOG messages
    [LogMode.OFF]: 100 // Shows nothing
};
//# sourceMappingURL=filtering.js.map