npm - pms_md - Versions diffs - 1.0.0 - Mend

pms_md 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (55) hide show

package/README.md +93 -0
package/node-monitor/ARCHITECTURE.md +341 -0
package/node-monitor/CHANGELOG.md +105 -0
package/node-monitor/CONTRIBUTING.md +96 -0
package/node-monitor/DESIGN_IMPROVEMENTS.md +286 -0
package/node-monitor/FILTER_BUTTONS_FIX.md +303 -0
package/node-monitor/GETTING_STARTED.md +416 -0
package/node-monitor/INSTALLATION.md +470 -0
package/node-monitor/LICENSE +22 -0
package/node-monitor/PUBLISHING_GUIDE.md +331 -0
package/node-monitor/QUICK_REFERENCE.md +252 -0
package/node-monitor/README.md +458 -0
package/node-monitor/READY_TO_PUBLISH.md +272 -0
package/node-monitor/SETUP_GUIDE.md +479 -0
package/node-monitor/examples/EMAIL_SETUP_GUIDE.md +282 -0
package/node-monitor/examples/ERROR_LOGGING_GUIDE.md +405 -0
package/node-monitor/examples/GET_APP_PASSWORD.md +145 -0
package/node-monitor/examples/LOG_FILES_REFERENCE.md +336 -0
package/node-monitor/examples/QUICK_START_EMAIL.md +126 -0
package/node-monitor/examples/express-app.js +499 -0
package/node-monitor/examples/package-lock.json +1295 -0
package/node-monitor/examples/package.json +18 -0
package/node-monitor/examples/public/css/style.css +718 -0
package/node-monitor/examples/public/js/dashboard.js +207 -0
package/node-monitor/examples/public/js/health.js +114 -0
package/node-monitor/examples/public/js/main.js +89 -0
package/node-monitor/examples/public/js/metrics.js +225 -0
package/node-monitor/examples/public/js/theme.js +138 -0
package/node-monitor/examples/views/dashboard.ejs +20 -0
package/node-monitor/examples/views/error-logs.ejs +1129 -0
package/node-monitor/examples/views/health.ejs +21 -0
package/node-monitor/examples/views/home.ejs +341 -0
package/node-monitor/examples/views/layout.ejs +50 -0
package/node-monitor/examples/views/metrics.ejs +16 -0
package/node-monitor/examples/views/partials/footer.ejs +16 -0
package/node-monitor/examples/views/partials/header.ejs +35 -0
package/node-monitor/examples/views/partials/nav.ejs +23 -0
package/node-monitor/examples/views/status.ejs +390 -0
package/node-monitor/package-lock.json +4300 -0
package/node-monitor/package.json +76 -0
package/node-monitor/pre-publish-check.js +200 -0
package/node-monitor/src/config/monitoringConfig.js +255 -0
package/node-monitor/src/index.js +300 -0
package/node-monitor/src/logger/errorLogger.js +297 -0
package/node-monitor/src/monitors/apiErrorMonitor.js +156 -0
package/node-monitor/src/monitors/dbConnectionMonitor.js +389 -0
package/node-monitor/src/monitors/serverHealthMonitor.js +320 -0
package/node-monitor/src/monitors/systemResourceMonitor.js +357 -0
package/node-monitor/src/notifiers/emailNotifier.js +248 -0
package/node-monitor/src/notifiers/notificationManager.js +96 -0
package/node-monitor/src/notifiers/slackNotifier.js +209 -0
package/node-monitor/src/views/dashboard.html +530 -0
package/node-monitor/src/views/health.html +399 -0
package/node-monitor/src/views/metrics.html +406 -0
package/package.json +22 -0

package/node-monitor/src/notifiers/emailNotifier.js ADDED Viewed

@@ -0,0 +1,248 @@
+/**
+ * Email Notifier
+ * Sends email notifications using Nodemailer
+ */
+const nodemailer = require('nodemailer');
+class EmailNotifier {
+  constructor(config, logger) {
+    this.config = config.notifications.email;
+    this.appConfig = config.app;
+    this.logger = logger;
+    this.transporter = null;
+    this.lastSent = new Map(); // Track last sent time per alert type
+    this.cooldown = config.notifications.cooldown;
+    if (this.config.enabled) {
+      this.initialize();
+    }
+  }
+  /**
+   * Initialize email transporter
+   */
+  initialize() {
+    try {
+      this.transporter = nodemailer.createTransport({
+        host: this.config.host,
+        port: this.config.port,
+        secure: this.config.secure,
+        auth: {
+          user: this.config.auth.user,
+          pass: this.config.auth.pass
+        }
+      });
+      // Verify connection
+      this.transporter.verify((error) => {
+        if (error) {
+          this.logger.logWarning('email_config', 'Email transporter verification failed', { error: error.message });
+        } else {
+          this.logger.logInfo('Email notifier initialized successfully');
+        }
+      });
+    } catch (error) {
+      this.logger.logWarning('email_config', 'Failed to initialize email notifier', { error: error.message });
+    }
+  }
+  /**
+   * Check if cooldown period has passed
+   */
+  canSend(alertType) {
+    const lastSentTime = this.lastSent.get(alertType);
+    if (!lastSentTime) return true;
+    return Date.now() - lastSentTime >= this.cooldown;
+  }
+  /**
+   * Send email notification
+   */
+  async send(alertType, subject, message, details = {}) {
+    if (!this.config.enabled || !this.transporter) {
+      return { success: false, reason: 'Email notifications not enabled or configured' };
+    }
+    if (!this.canSend(alertType)) {
+      return { success: false, reason: 'Cooldown period active' };
+    }
+    try {
+      const htmlContent = this.generateHtmlEmail(alertType, subject, message, details);
+      const textContent = this.generateTextEmail(alertType, subject, message, details);
+      const mailOptions = {
+        from: this.config.from || this.config.auth.user,
+        to: this.config.recipients.join(', '),
+        subject: `[${this.appConfig.name}] ${subject}`,
+        text: textContent,
+        html: htmlContent
+      };
+      const info = await this.transporter.sendMail(mailOptions);
+      this.lastSent.set(alertType, Date.now());
+      this.logger.logInfo('Email notification sent', { alertType, messageId: info.messageId });
+      return { success: true, messageId: info.messageId };
+    } catch (error) {
+      this.logger.logWarning('email_send_failed', 'Failed to send email notification', {
+        error: error.message,
+        alertType
+      });
+      return { success: false, reason: error.message };
+    }
+  }
+  /**
+   * Generate HTML email content
+   */
+  generateHtmlEmail(alertType, subject, message, details) {
+    const severity = this.getSeverityColor(alertType);
+    const timestamp = new Date().toLocaleString();
+    let detailsHtml = '';
+    if (Object.keys(details).length > 0) {
+      detailsHtml = '<h3>Details:</h3><table style="border-collapse: collapse; width: 100%;">';
+      for (const [key, value] of Object.entries(details)) {
+        detailsHtml += `
+          <tr>
+            <td style="padding: 8px; border: 1px solid #ddd; font-weight: bold;">${this.formatKey(key)}</td>
+            <td style="padding: 8px; border: 1px solid #ddd;">${this.formatValue(value)}</td>
+          </tr>
+        `;
+      }
+      detailsHtml += '</table>';
+    }
+    return `
+      <!DOCTYPE html>
+      <html>
+      <head>
+        <style>
+          body { font-family: Arial, sans-serif; line-height: 1.6; color: #333; }
+          .container { max-width: 600px; margin: 0 auto; padding: 20px; }
+          .header { background-color: ${severity}; color: white; padding: 20px; border-radius: 5px 5px 0 0; }
+          .content { background-color: #f9f9f9; padding: 20px; border: 1px solid #ddd; border-top: none; }
+          .footer { background-color: #333; color: white; padding: 10px; text-align: center; font-size: 12px; border-radius: 0 0 5px 5px; }
+          table { margin-top: 10px; }
+        </style>
+      </head>
+      <body>
+        <div class="container">
+          <div class="header">
+            <h2 style="margin: 0;">🚨 ${subject}</h2>
+          </div>
+          <div class="content">
+            <p><strong>Message:</strong> ${message}</p>
+            <p><strong>Application:</strong> ${this.appConfig.name} (v${this.appConfig.version})</p>
+            <p><strong>Environment:</strong> ${this.appConfig.environment}</p>
+            <p><strong>Hostname:</strong> ${this.appConfig.hostname}</p>
+            <p><strong>Time:</strong> ${timestamp}</p>
+            ${detailsHtml}
+          </div>
+          <div class="footer">
+            Node Monitor - Automated Alert System
+          </div>
+        </div>
+      </body>
+      </html>
+    `;
+  }
+  /**
+   * Generate plain text email content
+   */
+  generateTextEmail(alertType, subject, message, details) {
+    const timestamp = new Date().toLocaleString();
+    let text = `
+🚨 ${subject}
+Message: ${message}
+Application: ${this.appConfig.name} (v${this.appConfig.version})
+Environment: ${this.appConfig.environment}
+Hostname: ${this.appConfig.hostname}
+Time: ${timestamp}
+`;
+    if (Object.keys(details).length > 0) {
+      text += '\nDetails:\n';
+      for (const [key, value] of Object.entries(details)) {
+        text += `  ${this.formatKey(key)}: ${this.formatValue(value)}\n`;
+      }
+    }
+    text += '\n---\nNode Monitor - Automated Alert System';
+    return text;
+  }
+  /**
+   * Get severity color based on alert type
+   */
+  getSeverityColor(alertType) {
+    const type = alertType.toLowerCase();
+    if (type.includes('critical') || type.includes('down') || type.includes('failed')) {
+      return '#dc3545'; // Red
+    }
+    if (type.includes('warning') || type.includes('high')) {
+      return '#ffc107'; // Yellow
+    }
+    if (type.includes('recovery') || type.includes('success')) {
+      return '#28a745'; // Green
+    }
+    return '#007bff'; // Blue (info)
+  }
+  /**
+   * Format key for display
+   */
+  formatKey(key) {
+    return key
+      .replace(/([A-Z])/g, ' $1')
+      .replace(/^./, str => str.toUpperCase())
+      .trim();
+  }
+  /**
+   * Format value for display
+   */
+  formatValue(value) {
+    if (typeof value === 'object') {
+      return JSON.stringify(value, null, 2);
+    }
+    return String(value);
+  }
+  /**
+   * Send critical alert
+   */
+  async sendCritical(subject, message, details) {
+    return this.send('critical', `🔴 CRITICAL: ${subject}`, message, details);
+  }
+  /**
+   * Send warning alert
+   */
+  async sendWarning(subject, message, details) {
+    return this.send('warning', `⚠️ WARNING: ${subject}`, message, details);
+  }
+  /**
+   * Send info alert
+   */
+  async sendInfo(subject, message, details) {
+    return this.send('info', `ℹ️ INFO: ${subject}`, message, details);
+  }
+  /**
+   * Send recovery notification
+   */
+  async sendRecovery(subject, message, details) {
+    return this.send('recovery', `✅ RECOVERY: ${subject}`, message, details);
+  }
+}
+module.exports = EmailNotifier;

package/node-monitor/src/notifiers/notificationManager.js ADDED Viewed

@@ -0,0 +1,96 @@
+/**
+ * Notification Manager
+ * Coordinates all notification channels
+ */
+const EmailNotifier = require('./emailNotifier');
+const SlackNotifier = require('./slackNotifier');
+class NotificationManager {
+  constructor(config, logger) {
+    this.config = config;
+    this.logger = logger;
+    this.notifiers = [];
+    this.initialize();
+  }
+  /**
+   * Initialize all enabled notifiers
+   */
+  initialize() {
+    if (this.config.notifications.email.enabled) {
+      this.notifiers.push(new EmailNotifier(this.config, this.logger));
+    }
+    if (this.config.notifications.slack.enabled) {
+      this.notifiers.push(new SlackNotifier(this.config, this.logger));
+    }
+    // SMS notifier can be added here when implemented
+    // if (this.config.notifications.sms.enabled) {
+    //   this.notifiers.push(new SmsNotifier(this.config, this.logger));
+    // }
+    this.logger.logInfo(`Notification manager initialized with ${this.notifiers.length} notifier(s)`);
+  }
+  /**
+   * Send notification through all enabled channels
+   */
+  async notify(alertType, subject, message, details = {}) {
+    if (!this.config.notifications.enabled || this.notifiers.length === 0) {
+      return { success: false, reason: 'No notifiers enabled' };
+    }
+    const results = await Promise.allSettled(
+      this.notifiers.map(notifier =>
+        notifier.send(alertType, subject, message, details)
+      )
+    );
+    const summary = {
+      total: results.length,
+      successful: results.filter(r => r.status === 'fulfilled' && r.value.success).length,
+      failed: results.filter(r => r.status === 'rejected' || !r.value.success).length,
+      results: results
+    };
+    return summary;
+  }
+  /**
+   * Send critical alert
+   */
+  async sendCritical(subject, message, details = {}) {
+    this.logger.logSystemError('critical_alert', subject, details);
+    return this.notify('critical', subject, message, details);
+  }
+  /**
+   * Send warning alert
+   */
+  async sendWarning(subject, message, details = {}) {
+    this.logger.logWarning('warning_alert', subject, details);
+    return this.notify('warning', subject, message, details);
+  }
+  /**
+   * Send info notification
+   */
+  async sendInfo(subject, message, details = {}) {
+    this.logger.logInfo(subject, details);
+    return this.notify('info', subject, message, details);
+  }
+  /**
+   * Send recovery notification
+   */
+  async sendRecovery(subject, message, details = {}) {
+    this.logger.logInfo(`Recovery: ${subject}`, details);
+    return this.notify('recovery', subject, message, details);
+  }
+}
+module.exports = NotificationManager;

package/node-monitor/src/notifiers/slackNotifier.js ADDED Viewed

@@ -0,0 +1,209 @@
+/**
+ * Slack Notifier
+ * Sends notifications to Slack using Incoming Webhooks
+ */
+const { IncomingWebhook } = require('@slack/webhook');
+class SlackNotifier {
+  constructor(config, logger) {
+    this.config = config.notifications.slack;
+    this.appConfig = config.app;
+    this.logger = logger;
+    this.webhook = null;
+    this.lastSent = new Map();
+    this.cooldown = config.notifications.cooldown;
+    if (this.config.enabled) {
+      this.initialize();
+    }
+  }
+  /**
+   * Initialize Slack webhook
+   */
+  initialize() {
+    try {
+      this.webhook = new IncomingWebhook(this.config.webhook);
+      this.logger.logInfo('Slack notifier initialized successfully');
+    } catch (error) {
+      this.logger.logWarning('slack_config', 'Failed to initialize Slack notifier', {
+        error: error.message
+      });
+    }
+  }
+  /**
+   * Check if cooldown period has passed
+   */
+  canSend(alertType) {
+    const lastSentTime = this.lastSent.get(alertType);
+    if (!lastSentTime) return true;
+    return Date.now() - lastSentTime >= this.cooldown;
+  }
+  /**
+   * Send Slack notification
+   */
+  async send(alertType, subject, message, details = {}) {
+    if (!this.config.enabled || !this.webhook) {
+      return { success: false, reason: 'Slack notifications not enabled or configured' };
+    }
+    if (!this.canSend(alertType)) {
+      return { success: false, reason: 'Cooldown period active' };
+    }
+    try {
+      const payload = this.buildPayload(alertType, subject, message, details);
+      await this.webhook.send(payload);
+      this.lastSent.set(alertType, Date.now());
+      this.logger.logInfo('Slack notification sent', { alertType });
+      return { success: true };
+    } catch (error) {
+      this.logger.logWarning('slack_send_failed', 'Failed to send Slack notification', {
+        error: error.message,
+        alertType
+      });
+      return { success: false, reason: error.message };
+    }
+  }
+  /**
+   * Build Slack message payload
+   */
+  buildPayload(alertType, subject, message, details) {
+    const color = this.getSeverityColor(alertType);
+    const emoji = this.getSeverityEmoji(alertType);
+    const timestamp = Math.floor(Date.now() / 1000);
+    const fields = [
+      {
+        title: 'Application',
+        value: `${this.appConfig.name} (v${this.appConfig.version})`,
+        short: true
+      },
+      {
+        title: 'Environment',
+        value: this.appConfig.environment,
+        short: true
+      },
+      {
+        title: 'Hostname',
+        value: this.appConfig.hostname,
+        short: true
+      },
+      {
+        title: 'Alert Type',
+        value: alertType.toUpperCase(),
+        short: true
+      }
+    ];
+    // Add custom details as fields
+    for (const [key, value] of Object.entries(details)) {
+      if (typeof value !== 'object') {
+        fields.push({
+          title: this.formatKey(key),
+          value: String(value),
+          short: true
+        });
+      }
+    }
+    return {
+      username: this.config.username,
+      channel: this.config.channel,
+      icon_emoji: emoji,
+      attachments: [
+        {
+          color: color,
+          title: subject,
+          text: message,
+          fields: fields,
+          footer: 'Node Monitor',
+          footer_icon: 'https://platform.slack-edge.com/img/default_application_icon.png',
+          ts: timestamp
+        }
+      ]
+    };
+  }
+  /**
+   * Get severity color for Slack
+   */
+  getSeverityColor(alertType) {
+    const type = alertType.toLowerCase();
+    if (type.includes('critical') || type.includes('down') || type.includes('failed')) {
+      return 'danger'; // Red
+    }
+    if (type.includes('warning') || type.includes('high')) {
+      return 'warning'; // Yellow
+    }
+    if (type.includes('recovery') || type.includes('success')) {
+      return 'good'; // Green
+    }
+    return '#007bff'; // Blue (info)
+  }
+  /**
+   * Get severity emoji
+   */
+  getSeverityEmoji(alertType) {
+    const type = alertType.toLowerCase();
+    if (type.includes('critical') || type.includes('down') || type.includes('failed')) {
+      return ':rotating_light:';
+    }
+    if (type.includes('warning') || type.includes('high')) {
+      return ':warning:';
+    }
+    if (type.includes('recovery') || type.includes('success')) {
+      return ':white_check_mark:';
+    }
+    return ':information_source:';
+  }
+  /**
+   * Format key for display
+   */
+  formatKey(key) {
+    return key
+      .replace(/([A-Z])/g, ' $1')
+      .replace(/^./, str => str.toUpperCase())
+      .trim();
+  }
+  /**
+   * Send critical alert
+   */
+  async sendCritical(subject, message, details) {
+    return this.send('critical', `🔴 CRITICAL: ${subject}`, message, details);
+  }
+  /**
+   * Send warning alert
+   */
+  async sendWarning(subject, message, details) {
+    return this.send('warning', `⚠️ WARNING: ${subject}`, message, details);
+  }
+  /**
+   * Send info alert
+   */
+  async sendInfo(subject, message, details) {
+    return this.send('info', `ℹ️ INFO: ${subject}`, message, details);
+  }
+  /**
+   * Send recovery notification
+   */
+  async sendRecovery(subject, message, details) {
+    return this.send('recovery', `✅ RECOVERY: ${subject}`, message, details);
+  }
+}
+module.exports = SlackNotifier;