axon-logger 1.0.0

package/dist/logger/ConfigLoader.js

@@ -0,0 +1,210 @@
+"use strict";
+/**
+ * Configuration loader for AXON Logger
+ * Handles loading configuration from multiple sources with proper precedence
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFromEnvironment = loadFromEnvironment;
+exports.loadFromFile = loadFromFile;
+exports.mergeConfigurations = mergeConfigurations;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const types_1 = require("./types");
+/**
+ * Loads configuration from environment variables
+ * Environment variables are prefixed with AXON_
+ * @returns Partial configuration from environment variables
+ */
+function loadFromEnvironment() {
+    const config = {};
+    // Load log level from AXON_LOG_LEVEL
+    if (process.env.AXON_LOG_LEVEL) {
+        const levelStr = process.env.AXON_LOG_LEVEL.toUpperCase();
+        if (levelStr in types_1.LogLevel && isNaN(Number(levelStr))) {
+            config.level = types_1.LogLevel[levelStr];
+        }
+    }
+    // Load output path from AXON_OUTPUT_PATH
+    if (process.env.AXON_OUTPUT_PATH) {
+        config.outputPath = process.env.AXON_OUTPUT_PATH;
+    }
+    // Load max file size from AXON_MAX_FILE_SIZE
+    if (process.env.AXON_MAX_FILE_SIZE) {
+        const size = parseInt(process.env.AXON_MAX_FILE_SIZE, 10);
+        if (!isNaN(size) && size > 0) {
+            config.maxFileSize = size;
+        }
+    }
+    // Load rotation interval from AXON_ROTATION_INTERVAL
+    if (process.env.AXON_ROTATION_INTERVAL) {
+        const interval = process.env.AXON_ROTATION_INTERVAL.toLowerCase();
+        if (['hourly', 'daily', 'weekly', 'none'].includes(interval)) {
+            config.rotationInterval = interval;
+        }
+    }
+    // Load buffer size from AXON_BUFFER_SIZE
+    if (process.env.AXON_BUFFER_SIZE) {
+        const size = parseInt(process.env.AXON_BUFFER_SIZE, 10);
+        if (!isNaN(size) && size > 0) {
+            config.bufferSize = size;
+        }
+    }
+    // Load flush interval from AXON_FLUSH_INTERVAL
+    if (process.env.AXON_FLUSH_INTERVAL) {
+        const interval = parseInt(process.env.AXON_FLUSH_INTERVAL, 10);
+        if (!isNaN(interval) && interval >= 0) {
+            config.flushInterval = interval;
+        }
+    }
+    // Load delimiter from AXON_DELIMITER
+    if (process.env.AXON_DELIMITER) {
+        const delimiter = process.env.AXON_DELIMITER;
+        if (delimiter === ',' || delimiter === '\t' || delimiter === '|' || delimiter === 'tab' || delimiter === 'pipe') {
+            config.delimiter = delimiter === 'tab' ? '\t' : delimiter === 'pipe' ? '|' : delimiter;
+        }
+    }
+    // Load omit null values from AXON_OMIT_NULL_VALUES
+    if (process.env.AXON_OMIT_NULL_VALUES) {
+        const value = process.env.AXON_OMIT_NULL_VALUES.toLowerCase();
+        if (value === 'true' || value === 'false') {
+            config.omitNullValues = value === 'true';
+        }
+    }
+    return config;
+}
+/**
+ * Loads configuration from a .axonrc.json file
+ * Searches for the file in the current directory and parent directories
+ * @param startDir - Directory to start searching from (defaults to current working directory)
+ * @returns Partial configuration from file, or empty object if file not found
+ */
+function loadFromFile(startDir) {
+    const searchDir = startDir || process.cwd();
+    const configFileName = '.axonrc.json';
+    try {
+        // Search for config file in current directory and parent directories
+        let currentDir = searchDir;
+        let configPath = null;
+        // Search up to 10 levels up
+        for (let i = 0; i < 10; i++) {
+            const candidatePath = path.join(currentDir, configFileName);
+            if (fs.existsSync(candidatePath)) {
+                configPath = candidatePath;
+                break;
+            }
+            const parentDir = path.dirname(currentDir);
+            if (parentDir === currentDir) {
+                // Reached root directory
+                break;
+            }
+            currentDir = parentDir;
+        }
+        if (!configPath) {
+            return {};
+        }
+        // Read and parse the config file
+        const fileContent = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(fileContent);
+        // Validate that it's an object
+        if (typeof config !== 'object' || config === null) {
+            console.warn(`AXON: Invalid config file at ${configPath}: must be a JSON object`);
+            return {};
+        }
+        // Convert string log level to enum if present
+        if (config.level && typeof config.level === 'string') {
+            const levelStr = config.level.toUpperCase();
+            if (levelStr in types_1.LogLevel && isNaN(Number(levelStr))) {
+                config.level = types_1.LogLevel[levelStr];
+            }
+        }
+        return config;
+    }
+    catch (error) {
+        // Silently ignore file read/parse errors
+        if (error instanceof Error && error.message.includes('JSON')) {
+            console.warn(`AXON: Failed to parse config file: ${error.message}`);
+        }
+        return {};
+    }
+}
+/**
+ * Merges configuration from multiple sources with proper precedence
+ * Precedence order (highest to lowest): constructor > environment > file > defaults
+ * @param constructorConfig - Configuration passed to Logger constructor
+ * @param startDir - Directory to start searching for config file (optional)
+ * @returns Fully resolved configuration with all fields populated
+ */
+function mergeConfigurations(constructorConfig, startDir) {
+    // Load from all sources
+    const fileConfig = loadFromFile(startDir);
+    const envConfig = loadFromEnvironment();
+    // Merge with precedence: constructor > env > file > defaults
+    const merged = {
+        ...types_1.DEFAULT_CONFIG,
+        ...fileConfig,
+        ...envConfig,
+        ...constructorConfig,
+        // Handle nested objects specially - only merge if they are valid objects
+        fieldAliases: (() => {
+            // If constructor provides fieldAliases, use it (even if invalid - validation will catch it)
+            if (constructorConfig.fieldAliases !== undefined) {
+                // If it's a valid object, merge with defaults
+                if (typeof constructorConfig.fieldAliases === 'object' &&
+                    constructorConfig.fieldAliases !== null &&
+                    !Array.isArray(constructorConfig.fieldAliases)) {
+                    return {
+                        ...types_1.DEFAULT_CONFIG.fieldAliases,
+                        ...(fileConfig.fieldAliases && typeof fileConfig.fieldAliases === 'object' ? fileConfig.fieldAliases : {}),
+                        ...(envConfig.fieldAliases && typeof envConfig.fieldAliases === 'object' ? envConfig.fieldAliases : {}),
+                        ...constructorConfig.fieldAliases
+                    };
+                }
+                // Return invalid value as-is for validation to catch
+                return constructorConfig.fieldAliases;
+            }
+            // Otherwise merge from other sources
+            return {
+                ...types_1.DEFAULT_CONFIG.fieldAliases,
+                ...(fileConfig.fieldAliases && typeof fileConfig.fieldAliases === 'object' ? fileConfig.fieldAliases : {}),
+                ...(envConfig.fieldAliases && typeof envConfig.fieldAliases === 'object' ? envConfig.fieldAliases : {})
+            };
+        })(),
+        // Ensure environment is always set
+        environment: (0, types_1.detectEnvironment)()
+    };
+    return merged;
+}
+//# sourceMappingURL=ConfigLoader.js.map

package/dist/logger/ConfigLoader.js.map

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

package/dist/logger/Logger.d.ts

@@ -0,0 +1,142 @@
+/**
+ * Logger class
+ * Main logging interface for AXON framework
+ */
+import { LogLevel, LogEntry, LoggerConfig, ResolvedConfig } from './types';
+import { FileManager } from '../file-manager/FileManager';
+import { BrowserFileManager } from '../file-manager/BrowserFileManager';
+/**
+ * Logger class
+ * Provides methods for logging at different severity levels with metadata support
+ */
+export declare class Logger {
+    private config;
+    private globalMetadata;
+    private serializer;
+    private fileManager;
+    private buffer;
+    /**
+     * Creates a new Logger instance
+     * @param config - Configuration options for the logger
+     * @throws Error if configuration values are invalid
+     */
+    constructor(config: LoggerConfig);
+    /**
+     * Logs a debug message
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    debug(message: string, metadata?: Record<string, any>): void;
+    /**
+     * Logs an info message
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    info(message: string, metadata?: Record<string, any>): void;
+    /**
+     * Logs a warning message
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    warn(message: string, metadata?: Record<string, any>): void;
+    /**
+     * Logs an error message
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    error(message: string, metadata?: Record<string, any>): void;
+    /**
+     * Logs a fatal error message
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    fatal(message: string, metadata?: Record<string, any>): void;
+    /**
+     * Internal log method that handles log level filtering and entry creation
+     * @param level - The log level
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    private log;
+    /**
+     * Applies metadata filtering based on configured patterns
+     * @param metadata - Metadata object to filter
+     * @returns Filtered metadata object
+     * @private
+     */
+    private applyMetadataFilter;
+    /**
+     * Sets global metadata that will be included in all subsequent log entries
+     * @param metadata - Metadata object to set as global
+     */
+    setGlobalMetadata(metadata: Record<string, any>): void;
+    /**
+     * Clears all global metadata
+     */
+    clearGlobalMetadata(): void;
+    /**
+     * Inserts a section marker into the log
+     * Section markers help identify and extract specific sections of logs
+     * @param label - The label for the section marker
+     */
+    mark(label: string): void;
+    /**
+     * Flushes buffered log entries to storage
+     * Forces immediate write of all pending entries
+     */
+    flush(): Promise<void>;
+    /**
+     * Closes the logger
+     * Flushes remaining entries and releases resources
+     */
+    close(): Promise<void>;
+    /**
+     * Gets the current configuration
+     * @returns The resolved configuration object
+     */
+    getConfig(): Readonly<ResolvedConfig>;
+    /**
+     * Gets the file manager (for testing purposes)
+     * @returns The file manager instance
+     */
+    getFileManager(): FileManager | BrowserFileManager;
+    /**
+     * Gets the current global metadata (for testing purposes)
+     * @returns Copy of the current global metadata
+     */
+    getGlobalMetadata(): Readonly<Record<string, any>>;
+    /**
+     * Gets the current buffer (for testing purposes)
+     * @returns Copy of the current buffer
+     */
+    getBuffer(): ReadonlyArray<string | LogEntry>;
+    /**
+     * Sets the log level at runtime
+     * @param level - The new log level
+     * @throws Error if the log level is invalid
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Updates configuration at runtime
+     * Only non-critical settings can be updated (level, bufferSize, flushInterval, fieldAliases, omitNullValues, delimiter)
+     * Critical settings like outputPath, maxFileSize, and rotationInterval cannot be changed at runtime
+     * @param partial - Partial configuration to update
+     * @throws Error if trying to update critical settings or if validation fails
+     */
+    updateConfig(partial: Partial<LoggerConfig>): void;
+    /**
+     * Logs a fatal error message synchronously (bypasses buffering)
+     * Use for critical errors that must be written immediately
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    fatalSync(message: string, metadata?: Record<string, any>): Promise<void>;
+    /**
+     * Logs an error message synchronously (bypasses buffering)
+     * Use for critical errors that must be written immediately
+     * @param message - The log message
+     * @param metadata - Optional metadata to attach to the log entry
+     */
+    errorSync(message: string, metadata?: Record<string, any>): Promise<void>;
+}
+//# sourceMappingURL=Logger.d.ts.map

package/dist/logger/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../src/logger/Logger.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG3E,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AA+FxE;;;GAGG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,UAAU,CAAiB;IACnC,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,MAAM,CAA6B;IAE3C;;;;OAIG;gBACS,MAAM,EAAE,YAAY;IAiChC;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI5D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3D;;;;OAIG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI3D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI5D;;;;OAIG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAI5D;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAsDX;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAoC3B;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAItD;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;;;OAIG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAMzB;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8B5B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;;OAGG;IACH,SAAS,IAAI,QAAQ,CAAC,cAAc,CAAC;IAIrC;;;OAGG;IACH,cAAc,IAAI,WAAW,GAAG,kBAAkB;IAIlD;;;OAGG;IACH,iBAAiB,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAIlD;;;OAGG;IACH,SAAS,IAAI,aAAa,CAAC,MAAM,GAAG,QAAQ,CAAC;IAI7C;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAQ/B;;;;;;OAMG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAmDlD;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C/E;;;;;OAKG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CA8ChF"}