@ncoderz/log-m8 1.2.4 → 1.3.0

package/dist/index.cjs

@@ -22,10 +22,16 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  ConsoleAppender: () => ConsoleAppender,
+  DefaultFormatter: () => DefaultFormatter,
+  FileAppender: () => FileAppender,
+  JsonFormatter: () => JsonFormatter,
   LogLevel: () => LogLevel,
   LogM8: () => LogM82,
   LogM8Utils: () => LogM8Utils,
+  MatchFilter: () => MatchFilter,
   NullLogger: () => NullLogger,
+  PACKAGE_INFO: () => PACKAGE_INFO,
   PluginKind: () => PluginKind
 });
 module.exports = __toCommonJS(index_exports);
@@ -1106,6 +1112,7 @@ var LogM8 = class {
     __publicField(this, "_globalLogLevelNumber");
     __publicField(this, "_logLevelValues");
     __publicField(this, "_logLevelSet");
+    __publicField(this, "_logLevelIndexMap");
     // Buffer for log events before the system is initialized
     __publicField(this, "_logBuffer");
     this._initialized = false;
@@ -1115,8 +1122,11 @@ var LogM8 = class {
     this._filters = [];
     this._logLevelValues = Object.values(LogLevel);
     this._logLevelSet = new Set(this._logLevelValues);
+    this._logLevelIndexMap = new Map(
+      this._logLevelValues.map((level, index) => [level, index])
+    );
     this._globalLogLevel = LogLevel.info;
-    this._globalLogLevelNumber = this._logLevelValues.indexOf(LogLevel.info);
+    this._globalLogLevelNumber = this._logLevelIndexMap.get(LogLevel.info);
     this._logBuffer = [];
     this._pluginManager.registerPluginFactory(new ConsoleAppenderFactory());
     this._pluginManager.registerPluginFactory(new FileAppenderFactory());
@@ -1163,32 +1173,7 @@ var LogM8 = class {
     }
     const appenderConfigs = config.appenders ?? DEFAULT_APPENDERS;
     for (const appenderConfigOrName of appenderConfigs) {
-      const appender = this._pluginManager.createPlugin(
-        PluginKind.appender,
-        appenderConfigOrName
-      );
-      const appenderConfig = LogM8Utils.isString(appenderConfigOrName) ? {
-        name: appender.name
-      } : appenderConfigOrName;
-      const formatter = appenderConfig?.formatter ? this._pluginManager.createPlugin(
-        PluginKind.formatter,
-        appenderConfig.formatter
-      ) : void 0;
-      const filters = [];
-      const ac = appenderConfig;
-      for (const filterConfig of ac.filters ?? []) {
-        const filter = this._pluginManager.createPlugin(PluginKind.filter, filterConfig);
-        if (filter) {
-          filters.push(filter);
-        } else {
-          if (console && console.log) {
-            console.log(
-              `LogM8: Filter '${filterConfig}' not found for appender ${appenderConfig.name}.`
-            );
-          }
-        }
-      }
-      appender.init(appenderConfig, formatter, filters);
+      const appender = this._createAndInitAppender(appenderConfigOrName);
       this._appenders.push(appender);
     }
     this._sortAppenders();
@@ -1295,7 +1280,7 @@ var LogM8 = class {
       this.getLogger(logger).setLevel(levelStr);
     } else {
       this._globalLogLevel = this._logLevelSet.has(levelStr) ? levelStr : this._globalLogLevel;
-      this._globalLogLevelNumber = this._logLevelValues.indexOf(this._globalLogLevel);
+      this._globalLogLevelNumber = this._logLevelIndexMap.get(this._globalLogLevel);
     }
   }
   /**
@@ -1318,6 +1303,101 @@ var LogM8 = class {
     if (!appender) return;
     appender.enabled = false;
   }
+  /**
+   * Adds an appender to the logging system at runtime.
+   *
+   * Creates and initializes the appender using the plugin factory system,
+   * including any configured formatter and filters. The appender is inserted
+   * into the priority-sorted appender list and immediately begins receiving
+   * log events.
+   *
+   * Must be called after init(). The appender name must not already be in use.
+   *
+   * @param config - Appender name (string) or full configuration object
+   *
+   * @throws {Error} When called before init()
+   * @throws {Error} When an appender with the same name already exists
+   * @throws {Error} When the referenced plugin factory is not registered
+   *
+   * @example
+   * ```typescript
+   * // Add by name (uses factory defaults)
+   * Logging.addAppender('console');
+   *
+   * // Add with full configuration
+   * Logging.addAppender({
+   *   name: 'file',
+   *   filename: 'debug.log',
+   *   formatter: 'json-formatter',
+   *   filters: ['sensitive-data'],
+   *   priority: 10
+   * });
+   * ```
+   */
+  addAppender(config) {
+    if (!this._initialized) {
+      throw new Error("LogM8: Cannot add appender before init()");
+    }
+    const name = typeof config === "string" ? config : config.name;
+    if (this._getAppender(name)) {
+      throw new Error(`LogM8: Appender '${name}' already exists`);
+    }
+    const appender = this._createAndInitAppender(config);
+    this._appenders.push(appender);
+    this._sortAppenders();
+  }
+  /**
+   * Removes an appender from the logging system at runtime.
+   *
+   * Flushes any buffered output, disposes the appender, and removes it
+   * from the active appender list. The appender will no longer receive
+   * log events after removal.
+   *
+   * @param name - Name of the appender to remove
+   * @returns True if the appender was found and removed, false otherwise
+   *
+   * @example
+   * ```typescript
+   * // Remove a dynamically added appender
+   * Logging.removeAppender('file');
+   *
+   * // Check if removal succeeded
+   * if (!Logging.removeAppender('unknown')) {
+   *   console.warn('Appender not found');
+   * }
+   * ```
+   */
+  removeAppender(name) {
+    const appender = this._getAppender(name);
+    if (!appender) return false;
+    try {
+      appender.flush();
+    } catch (err) {
+      if (console && console.error) {
+        console.error(`LogM8: Failed to flush appender during removal: ${appender.name}:`, err);
+      }
+    }
+    appender.dispose();
+    this._appenders = this._appenders.filter((a) => a !== appender);
+    return true;
+  }
+  /**
+   * Returns the names of all currently registered appenders.
+   *
+   * The returned array is a snapshot; modifications to it do not affect
+   * the logging system. Names are in priority-sorted order (highest first).
+   *
+   * @returns Array of appender names
+   *
+   * @example
+   * ```typescript
+   * const names = Logging.getAppenderNames();
+   * console.log('Active appenders:', names); // ['console', 'file']
+   * ```
+   */
+  getAppenderNames() {
+    return this._appenders.map((a) => a.name);
+  }
   /**
    * Forces an appender to flush any buffered output.
    *
@@ -1426,9 +1506,10 @@ var LogM8 = class {
   registerPluginFactory(pluginFactory) {
     this._pluginManager.registerPluginFactory(pluginFactory);
   }
-  _log(logger, level, message, ...data) {
-    const levelNumber = this._logLevelValues.indexOf(level);
+  _log(logger, level, message) {
+    const levelNumber = this._logLevelIndexMap.get(level);
     if (levelNumber > logger._levelNumber || levelNumber > this._globalLogLevelNumber) return;
+    const data = arguments.length > 3 ? Array.prototype.slice.call(arguments, 3) : [];
     const logEvent = {
       logger: logger.name,
       level,
@@ -1455,16 +1536,16 @@ var LogM8 = class {
   _setLevel(logger, level) {
     const levelStr = (level ?? "").trim().toLowerCase();
     logger.level = this._logLevelSet.has(levelStr) ? levelStr : logger.level;
-    logger._levelNumber = this._logLevelValues.indexOf(logger.level);
+    logger._levelNumber = this._logLevelIndexMap.get(logger.level);
     logger.isEnabled = logger.level !== LogLevel.off;
     const levelNumber = logger._levelNumber;
-    logger.isFatal = this._logLevelValues.indexOf(LogLevel.fatal) <= levelNumber;
-    logger.isError = this._logLevelValues.indexOf(LogLevel.error) <= levelNumber;
-    logger.isWarn = this._logLevelValues.indexOf(LogLevel.warn) <= levelNumber;
-    logger.isInfo = this._logLevelValues.indexOf(LogLevel.info) <= levelNumber;
-    logger.isDebug = this._logLevelValues.indexOf(LogLevel.debug) <= levelNumber;
-    logger.isTrack = this._logLevelValues.indexOf(LogLevel.track) <= levelNumber;
-    logger.isTrace = this._logLevelValues.indexOf(LogLevel.trace) <= levelNumber;
+    logger.isFatal = this._logLevelIndexMap.get(LogLevel.fatal) <= levelNumber;
+    logger.isError = this._logLevelIndexMap.get(LogLevel.error) <= levelNumber;
+    logger.isWarn = this._logLevelIndexMap.get(LogLevel.warn) <= levelNumber;
+    logger.isInfo = this._logLevelIndexMap.get(LogLevel.info) <= levelNumber;
+    logger.isDebug = this._logLevelIndexMap.get(LogLevel.debug) <= levelNumber;
+    logger.isTrack = this._logLevelIndexMap.get(LogLevel.track) <= levelNumber;
+    logger.isTrace = this._logLevelIndexMap.get(LogLevel.trace) <= levelNumber;
   }
   _setContext(logger, context) {
     logger.context = context ?? {};
@@ -1487,11 +1568,40 @@ var LogM8 = class {
       }
     }
   }
+  _createAndInitAppender(appenderConfigOrName) {
+    const appender = this._pluginManager.createPlugin(
+      PluginKind.appender,
+      appenderConfigOrName
+    );
+    const appenderConfig = LogM8Utils.isString(appenderConfigOrName) ? {
+      name: appender.name
+    } : appenderConfigOrName;
+    const formatter = appenderConfig?.formatter ? this._pluginManager.createPlugin(
+      PluginKind.formatter,
+      appenderConfig.formatter
+    ) : void 0;
+    const filters = [];
+    const ac = appenderConfig;
+    for (const filterConfig of ac.filters ?? []) {
+      const filter = this._pluginManager.createPlugin(PluginKind.filter, filterConfig);
+      if (filter) {
+        filters.push(filter);
+      } else {
+        if (console && console.log) {
+          console.log(
+            `LogM8: Filter '${filterConfig}' not found for appender ${appenderConfig.name}.`
+          );
+        }
+      }
+    }
+    appender.init(appenderConfig, formatter, filters);
+    return appender;
+  }
   _getAppender(name) {
     return this._appenders.find((a) => a.name === name);
   }
   _sortAppenders() {
-    this._appenders.sort((a, b) => {
+    this._appenders = [...this._appenders].sort((a, b) => {
       const aPriority = a?.priority ?? 0;
       const bPriority = b?.priority ?? 0;
       return bPriority - aPriority;
@@ -1509,6 +1619,15 @@ var LogM8 = class {
   }
 };
 
+// src/_generated/package_info.ts
+var PACKAGE_INFO = {
+  "name": "@ncoderz/log-m8",
+  "version": "1.3.0",
+  "author": "RA Sewell <richard.sewell@ncoderz.com>",
+  "license": "BSD-2-Clause",
+  "description": "Logging system for TypeScript / JavaScript"
+};
+
 // src/NullLogger.ts
 var NullLogger = class {
   constructor() {
@@ -1552,10 +1671,16 @@ var NullLogger = class {
 var LogM82 = new LogM8();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  ConsoleAppender,
+  DefaultFormatter,
+  FileAppender,
+  JsonFormatter,
   LogLevel,
   LogM8,
   LogM8Utils,
+  MatchFilter,
   NullLogger,
+  PACKAGE_INFO,
   PluginKind
 });
 //# sourceMappingURL=index.cjs.map