pms_md 1.0.4 → 1.0.6

package/node-monitor/src/index.js

@@ -1,300 +1,322 @@
-/**
- * Node Monitor - Main Entry Point
- * Comprehensive monitoring solution for Node.js applications
- */
-
-const MonitoringConfig = require('./config/monitoringConfig');
-const ErrorLogger = require('./logger/errorLogger');
-const NotificationManager = require('./notifiers/notificationManager');
-const ApiErrorMonitor = require('./monitors/apiErrorMonitor');
-const ServerHealthMonitor = require('./monitors/serverHealthMonitor');
-const SystemResourceMonitor = require('./monitors/systemResourceMonitor');
-const DbConnectionMonitor = require('./monitors/dbConnectionMonitor');
-
-class NodeMonitor {
-  constructor(userConfig = {}) {
-    // Initialize configuration
-    this.config = new MonitoringConfig(userConfig);
-    
-    // Initialize logger
-    this.logger = new ErrorLogger(this.config.getAll());
-    
-    // Initialize notification manager
-    this.notificationManager = new NotificationManager(this.config.getAll(), this.logger);
-    
-    // Initialize monitors
-    this.apiErrorMonitor = new ApiErrorMonitor(
-      this.config.getAll(),
-      this.logger,
-      this.notificationManager
-    );
-    
-    this.serverHealthMonitor = new ServerHealthMonitor(
-      this.config.getAll(),
-      this.logger,
-      this.notificationManager
-    );
-    
-    this.systemResourceMonitor = new SystemResourceMonitor(
-      this.config.getAll(),
-      this.logger,
-      this.notificationManager
-    );
-    
-    this.dbConnectionMonitor = new DbConnectionMonitor(
-      this.config.getAll(),
-      this.logger,
-      this.notificationManager
-    );
-
-    this.isStarted = false;
-    
-    this.logger.logInfo('Node Monitor initialized', {
-      app: this.config.get('app.name'),
-      version: this.config.get('app.version'),
-      environment: this.config.get('app.environment')
-    });
-  }
-
-  /**
-   * Start all monitoring services
-   */
-  start() {
-    if (this.isStarted) {
-      this.logger.logWarning('monitor_already_started', 'Monitor is already started');
-      return;
-    }
-
-    this.serverHealthMonitor.start();
-    this.systemResourceMonitor.start();
-    this.dbConnectionMonitor.start();
-
-    this.isStarted = true;
-    this.logger.logInfo('All monitoring services started');
-  }
-
-  /**
-   * Stop all monitoring services
-   */
-  stop() {
-    if (!this.isStarted) {
-      return;
-    }
-
-    this.serverHealthMonitor.stop();
-    this.systemResourceMonitor.stop();
-    this.dbConnectionMonitor.stop();
-
-    this.isStarted = false;
-    this.logger.logInfo('All monitoring services stopped');
-  }
-
-  /**
-   * Get Express error handling middleware
-   */
-  errorMiddleware() {
-    return this.apiErrorMonitor.middleware();
-  }
-
-  /**
-   * Get Express request logger middleware
-   */
-  requestLogger() {
-    return this.apiErrorMonitor.requestLogger();
-  }
-
-  /**
-   * Get 404 handler middleware
-   */
-  notFoundHandler() {
-    return this.apiErrorMonitor.notFoundHandler();
-  }
-
-  /**
-   * Get async error handler wrapper
-   */
-  asyncHandler(fn) {
-    return this.apiErrorMonitor.asyncHandler(fn);
-  }
-
-  /**
-   * Get health check endpoint handler
-   */
-  healthCheckEndpoint() {
-    return this.serverHealthMonitor.healthCheckEndpoint();
-  }
-
-  /**
-   * Get basic health info endpoint handler
-   */
-  healthInfoEndpoint() {
-    return this.serverHealthMonitor.healthInfoEndpoint();
-  }
-
-  /**
-   * Register a custom health check
-   */
-  registerHealthCheck(name, checkFunction) {
-    this.serverHealthMonitor.registerHealthCheck(name, checkFunction);
-  }
-
-  /**
-   * Register a database connection for monitoring
-   */
-  registerDatabase(name, type, connection, testQuery = null) {
-    this.dbConnectionMonitor.registerConnection(name, type, connection, testQuery);
-  }
-
-  /**
-   * Setup graceful shutdown handlers
-   */
-  setupGracefulShutdown(server) {
-    this.serverHealthMonitor.setupGracefulShutdown(server);
-  }
-
-  /**
-   * Get current monitoring status
-   */
-  getStatus() {
-    return {
-      isRunning: this.isStarted,
-      health: this.serverHealthMonitor.getStatus(),
-      system: this.systemResourceMonitor.getCurrentMetrics(),
-      databases: this.dbConnectionMonitor.getStatus(),
-      errors: this.apiErrorMonitor.getStats()
-    };
-  }
-
-  /**
-   * Get system information
-   */
-  getSystemInfo() {
-    return this.systemResourceMonitor.getSystemInfo();
-  }
-
-  /**
-   * Get metrics history
-   */
-  getMetricsHistory() {
-    return this.systemResourceMonitor.getMetricsHistory();
-  }
-
-  /**
-   * Get database statistics
-   */
-  async getDatabaseStats(name) {
-    return this.dbConnectionMonitor.getStats(name);
-  }
-
-  /**
-   * Send custom notification
-   */
-  async notify(level, subject, message, details = {}) {
-    switch (level.toLowerCase()) {
-      case 'critical':
-        return this.notificationManager.sendCritical(subject, message, details);
-      case 'warning':
-        return this.notificationManager.sendWarning(subject, message, details);
-      case 'info':
-        return this.notificationManager.sendInfo(subject, message, details);
-      case 'recovery':
-        return this.notificationManager.sendRecovery(subject, message, details);
-      default:
-        return this.notificationManager.sendInfo(subject, message, details);
-    }
-  }
-
-  /**
-   * Log custom error
-   */
-  logError(type, message, details = {}) {
-    return this.logger.logSystemError(type, message, details);
-  }
-
-  /**
-   * Log custom warning
-   */
-  logWarning(type, message, details = {}) {
-    return this.logger.logWarning(type, message, details);
-  }
-
-  /**
-   * Log custom info
-   */
-  logInfo(message, details = {}) {
-    return this.logger.logInfo(message, details);
-  }
-
-  /**
-   * Get Winston logger instance for custom logging
-   */
-  getLogger() {
-    return this.logger.getLogger();
-  }
-
-  /**
-   * Get configuration
-   */
-  getConfig() {
-    return this.config.getSanitized();
-  }
-
-  /**
-   * Update configuration at runtime
-   */
-  updateConfig(path, value) {
-    this.config.set(path, value);
-    this.logger.logInfo('Configuration updated', { path, value });
-  }
-
-  /**
-   * Create a monitoring dashboard endpoint (returns JSON data)
-   */
-  dashboardEndpoint() {
-    return async (req, res) => {
-      try {
-        const status = this.getStatus();
-        const systemInfo = this.getSystemInfo();
-        const metricsHistory = this.getMetricsHistory();
-
-        res.json({
-          status: 'ok',
-          timestamp: new Date().toISOString(),
-          application: {
-            name: this.config.get('app.name'),
-            version: this.config.get('app.version'),
-            environment: this.config.get('app.environment')
-          },
-          monitoring: status,
-          system: systemInfo,
-          metrics: metricsHistory
-        });
-      } catch (error) {
-        res.status(500).json({
-          status: 'error',
-          error: error.message
-        });
-      }
-    };
-  }
-
-  /**
-   * Static method to create error with status code
-   */
-  static createError(message, statusCode = 500, details = {}) {
-    return ApiErrorMonitor.createError(message, statusCode, details);
-  }
-}
-
-// Export the main class
-module.exports = NodeMonitor;
-
-// Also export individual components for advanced usage
-module.exports.MonitoringConfig = MonitoringConfig;
-module.exports.ErrorLogger = ErrorLogger;
-module.exports.NotificationManager = NotificationManager;
-module.exports.ApiErrorMonitor = ApiErrorMonitor;
-module.exports.ServerHealthMonitor = ServerHealthMonitor;
-module.exports.SystemResourceMonitor = SystemResourceMonitor;
-module.exports.DbConnectionMonitor = DbConnectionMonitor;
-
+/**
+ * Node Monitor - Main Entry Point
+ * Comprehensive monitoring solution for Node.js applications
+ */
+
+const MonitoringConfig = require('./config/monitoringConfig');
+const ErrorLogger = require('./logger/errorLogger');
+const NotificationManager = require('./notifiers/notificationManager');
+const ApiErrorMonitor = require('./monitors/apiErrorMonitor');
+const ServerHealthMonitor = require('./monitors/serverHealthMonitor');
+const SystemResourceMonitor = require('./monitors/systemResourceMonitor');
+const DbConnectionMonitor = require('./monitors/dbConnectionMonitor');
+
+class NodeMonitor {
+  constructor(userConfig = {}) {
+    // Initialize configuration
+    this.config = new MonitoringConfig(userConfig);
+    
+    // Initialize logger
+    this.logger = new ErrorLogger(this.config.getAll());
+    
+    // Initialize notification manager
+    this.notificationManager = new NotificationManager(this.config.getAll(), this.logger);
+    
+    // Initialize monitors
+    this.apiErrorMonitor = new ApiErrorMonitor(
+      this.config.getAll(),
+      this.logger,
+      this.notificationManager
+    );
+    
+    this.serverHealthMonitor = new ServerHealthMonitor(
+      this.config.getAll(),
+      this.logger,
+      this.notificationManager
+    );
+    
+    this.systemResourceMonitor = new SystemResourceMonitor(
+      this.config.getAll(),
+      this.logger,
+      this.notificationManager
+    );
+    
+    this.dbConnectionMonitor = new DbConnectionMonitor(
+      this.config.getAll(),
+      this.logger,
+      this.notificationManager
+    );
+
+    this.isStarted = false;
+    
+    this.logger.logInfo('Node Monitor initialized', {
+      app: this.config.get('app.name'),
+      version: this.config.get('app.version'),
+      environment: this.config.get('app.environment')
+    });
+  }
+
+  /**
+   * Start all monitoring services
+   */
+  start() {
+    if (this.isStarted) {
+      this.logger.logWarning('monitor_already_started', 'Monitor is already started');
+      return;
+    }
+
+    this.serverHealthMonitor.start();
+    this.systemResourceMonitor.start();
+    this.dbConnectionMonitor.start();
+
+    this.isStarted = true;
+    this.logger.logInfo('All monitoring services started');
+  }
+
+  /**
+   * Stop all monitoring services
+   */
+  stop() {
+    if (!this.isStarted) {
+      return;
+    }
+
+    this.serverHealthMonitor.stop();
+    this.systemResourceMonitor.stop();
+    this.dbConnectionMonitor.stop();
+
+    this.isStarted = false;
+    this.logger.logInfo('All monitoring services stopped');
+  }
+
+  /**
+   * Get Express error handling middleware
+   */
+  errorMiddleware() {
+    return this.apiErrorMonitor.middleware();
+  }
+
+  /**
+   * Get Express request logger middleware
+   */
+  requestLogger() {
+    return this.apiErrorMonitor.requestLogger();
+  }
+
+  /**
+   * Get 404 handler middleware
+   */
+  notFoundHandler() {
+    return this.apiErrorMonitor.notFoundHandler();
+  }
+
+  /**
+   * Get async error handler wrapper
+   */
+  asyncHandler(fn) {
+    return this.apiErrorMonitor.asyncHandler(fn);
+  }
+
+  /**
+   * Get health check endpoint handler
+   */
+  healthCheckEndpoint() {
+    return this.serverHealthMonitor.healthCheckEndpoint();
+  }
+
+  /**
+   * Get basic health info endpoint handler
+   */
+  healthInfoEndpoint() {
+    return this.serverHealthMonitor.healthInfoEndpoint();
+  }
+
+  /**
+   * Register a custom health check
+   */
+  registerHealthCheck(name, checkFunction) {
+    this.serverHealthMonitor.registerHealthCheck(name, checkFunction);
+  }
+
+  /**
+   * Register a database connection for monitoring
+   */
+  registerDatabase(name, type, connection, testQuery = null) {
+    this.dbConnectionMonitor.registerConnection(name, type, connection, testQuery);
+  }
+
+  /**
+   * Setup graceful shutdown handlers
+   */
+  setupGracefulShutdown(server) {
+    this.serverHealthMonitor.setupGracefulShutdown(server);
+  }
+
+  /**
+   * Get current monitoring status
+   */
+  getStatus() {
+    return {
+      isRunning: this.isStarted,
+      environment: this.config.get('app.environment'),
+      health: this.serverHealthMonitor.getStatus(),
+      system: this.systemResourceMonitor.getCurrentMetrics(),
+      databases: this.dbConnectionMonitor.getStatus(),
+      errors: this.apiErrorMonitor.getStats()
+    };
+  }
+
+  /**
+   * Get system information
+   */
+  getSystemInfo() {
+    return this.systemResourceMonitor.getSystemInfo();
+  }
+
+  /**
+   * Get metrics history
+   */
+  getMetricsHistory() {
+    return this.systemResourceMonitor.getMetricsHistory();
+  }
+
+  /**
+   * Get database statistics
+   */
+  async getDatabaseStats(name) {
+    return this.dbConnectionMonitor.getStats(name);
+  }
+
+  /**
+   * Send custom notification
+   */
+  async notify(level, subject, message, details = {}) {
+    switch (level.toLowerCase()) {
+      case 'critical':
+        return this.notificationManager.sendCritical(subject, message, details);
+      case 'warning':
+        return this.notificationManager.sendWarning(subject, message, details);
+      case 'info':
+        return this.notificationManager.sendInfo(subject, message, details);
+      case 'recovery':
+        return this.notificationManager.sendRecovery(subject, message, details);
+      default:
+        return this.notificationManager.sendInfo(subject, message, details);
+    }
+  }
+
+  /**
+   * Log custom error
+   */
+  logError(type, message, details = {}) {
+    return this.logger.logSystemError(type, message, details);
+  }
+
+  /**
+   * Log custom warning
+   */
+  logWarning(type, message, details = {}) {
+    return this.logger.logWarning(type, message, details);
+  }
+
+  /**
+   * Log custom info
+   */
+  logInfo(message, details = {}) {
+    return this.logger.logInfo(message, details);
+  }
+
+  /**
+   * Get Winston logger instance for custom logging
+   */
+  getLogger() {
+    return this.logger.getLogger();
+  }
+
+  /**
+   * Get configuration
+   */
+  getConfig() {
+    return this.config.getSanitized();
+  }
+
+  /**
+   * Update configuration at runtime
+   */
+  updateConfig(path, value) {
+    this.config.set(path, value);
+    this.logger.logInfo('Configuration updated', { path, value });
+  }
+
+  /**
+   * Serve monitoring UI (HTML dashboards)
+   * Automatically sets up EJS views and static files from the package
+   *
+   * @param {Express.Application} app - Express application instance
+   * @param {Object} options - UI configuration options
+   * @param {string} options.basePath - Base path for UI routes (default: '')
+   * @param {boolean} options.enableErrorLogs - Enable error logs page (default: true)
+   * @param {string} options.appName - Application name for UI (default: from config)
+   * @returns {UIRouter} UI Router instance
+   *
+   * @example
+   * const monitor = new NodeMonitor({ app: { name: 'My App' } });
+   * monitor.serveUI(app);
+   * // UI available at: /, /health, /monitor/dashboard, /monitor/metrics
+   */
+  serveUI(app, options = {}) {
+    const uiRouter = require('./ui/uiRouter');
+    return uiRouter.setup(app, this, options);
+  }
+
+  /**
+   * Create a monitoring dashboard endpoint (returns JSON data)
+   */
+  dashboardEndpoint() {
+    return async (req, res) => {
+      try {
+        const status = this.getStatus();
+        const systemInfo = this.getSystemInfo();
+        const metricsHistory = this.getMetricsHistory();
+
+        res.json({
+          status: 'ok',
+          timestamp: new Date().toISOString(),
+          application: {
+            name: this.config.get('app.name'),
+            version: this.config.get('app.version'),
+            environment: this.config.get('app.environment')
+          },
+          monitoring: status,
+          system: systemInfo,
+          metrics: metricsHistory
+        });
+      } catch (error) {
+        res.status(500).json({
+          status: 'error',
+          error: error.message
+        });
+      }
+    };
+  }
+
+  /**
+   * Static method to create error with status code
+   */
+  static createError(message, statusCode = 500, details = {}) {
+    return ApiErrorMonitor.createError(message, statusCode, details);
+  }
+}
+
+// Export the main class
+module.exports = NodeMonitor;
+
+// Also export individual components for advanced usage
+module.exports.MonitoringConfig = MonitoringConfig;
+module.exports.ErrorLogger = ErrorLogger;
+module.exports.NotificationManager = NotificationManager;
+module.exports.ApiErrorMonitor = ApiErrorMonitor;
+module.exports.ServerHealthMonitor = ServerHealthMonitor;
+module.exports.SystemResourceMonitor = SystemResourceMonitor;
+module.exports.DbConnectionMonitor = DbConnectionMonitor;
+