telegram-ssh-bot 2.0.0 → 2.2.0

package/dist/services/MonitoringService.js

@@ -0,0 +1,267 @@
+/**
+ * Monitoring Service
+ * Provides server health monitoring and alerting
+ */
+import { EventEmitter } from "events";
+/**
+ * Service for monitoring server health
+ */
+export class MonitoringService extends EventEmitter {
+    logger;
+    config;
+    serverStatuses = new Map();
+    checkTimer = null;
+    lastAlertTime = new Map();
+    isRunning = false;
+    checkFunction = null;
+    constructor(config, logger) {
+        super();
+        this.config = {
+            enabled: config.enabled ?? true,
+            checkInterval: config.checkInterval ?? 60000, // 1 minute
+            timeout: config.timeout ?? 10000, // 10 seconds
+            alertThreshold: config.alertThreshold ?? 3, // 3 consecutive failures
+            cooldownPeriod: config.cooldownPeriod ?? 300000, // 5 minutes
+        };
+        this.logger = logger;
+    }
+    /**
+     * Set the check function for server reachability
+     */
+    setCheckFunction(fn) {
+        this.checkFunction = fn;
+    }
+    /**
+     * Start monitoring
+     */
+    start() {
+        if (!this.config.enabled || this.isRunning) {
+            return;
+        }
+        this.isRunning = true;
+        this.scheduleNextCheck();
+        this.logger.info("Monitoring service started", {
+            checkInterval: this.config.checkInterval,
+        });
+    }
+    /**
+     * Stop monitoring
+     */
+    stop() {
+        if (this.checkTimer) {
+            clearTimeout(this.checkTimer);
+            this.checkTimer = null;
+        }
+        this.isRunning = false;
+        this.logger.info("Monitoring service stopped");
+    }
+    /**
+     * Register a server for monitoring
+     */
+    registerServer(server) {
+        const status = {
+            serverId: server.id,
+            serverName: server.note ?? server.host,
+            host: server.host,
+            isReachable: true,
+            lastCheck: null,
+            lastSuccessfulCheck: null,
+            consecutiveFailures: 0,
+            latency: null,
+        };
+        this.serverStatuses.set(server.id, status);
+        this.logger.debug("Server registered for monitoring", {
+            serverId: server.id,
+            serverName: status.serverName,
+        });
+    }
+    /**
+     * Unregister a server from monitoring
+     */
+    unregisterServer(serverId) {
+        this.serverStatuses.delete(serverId);
+        this.lastAlertTime.delete(serverId);
+        this.logger.debug("Server unregistered from monitoring", { serverId });
+    }
+    /**
+     * Get server status
+     */
+    getServerStatus(serverId) {
+        return this.serverStatuses.get(serverId);
+    }
+    /**
+     * Get all server statuses
+     */
+    getAllStatuses() {
+        return Array.from(this.serverStatuses.values());
+    }
+    /**
+     * Check a specific server
+     */
+    async checkServer(server) {
+        const status = this.serverStatuses.get(server.id);
+        if (!status) {
+            throw new Error(`Server ${server.id} not registered for monitoring`);
+        }
+        const previousStatus = { ...status };
+        const startTime = Date.now();
+        try {
+            if (!this.checkFunction) {
+                throw new Error("Check function not configured");
+            }
+            const isReachable = await this.checkFunction(server);
+            const latency = Date.now() - startTime;
+            status.lastCheck = new Date();
+            status.latency = latency;
+            status.error = undefined;
+            if (isReachable) {
+                status.isReachable = true;
+                status.lastSuccessfulCheck = new Date();
+                // Check for recovery
+                if (previousStatus.consecutiveFailures > 0) {
+                    this.emit("server:recovered", {
+                        server,
+                        status,
+                        previousStatus,
+                        timestamp: new Date(),
+                    });
+                    this.logger.info("Server recovered", {
+                        serverId: server.id,
+                        serverName: status.serverName,
+                        previousFailures: previousStatus.consecutiveFailures,
+                    });
+                }
+                status.consecutiveFailures = 0;
+            }
+            else {
+                this.handleFailure(server, status, previousStatus, "Health check returned false");
+            }
+        }
+        catch (error) {
+            const latency = Date.now() - startTime;
+            status.lastCheck = new Date();
+            status.latency = latency;
+            status.error = error instanceof Error ? error.message : String(error);
+            this.handleFailure(server, status, previousStatus, status.error);
+        }
+        return status;
+    }
+    /**
+     * Handle server failure
+     */
+    handleFailure(server, status, previousStatus, error) {
+        status.isReachable = false;
+        status.consecutiveFailures++;
+        status.error = error;
+        this.logger.warn("Server health check failed", {
+            serverId: server.id,
+            serverName: status.serverName,
+            consecutiveFailures: status.consecutiveFailures,
+            error,
+        });
+        // Emit unreachable event
+        this.emit("server:unreachable", {
+            server,
+            status,
+            previousStatus,
+            timestamp: new Date(),
+        });
+        // Check if alert should be triggered
+        if (status.consecutiveFailures >= this.config.alertThreshold) {
+            this.maybeTriggerAlert(server, status, previousStatus);
+        }
+    }
+    /**
+     * Maybe trigger an alert (respects cooldown)
+     */
+    maybeTriggerAlert(server, status, previousStatus) {
+        const lastAlert = this.lastAlertTime.get(server.id);
+        const now = new Date();
+        // Check cooldown
+        if (lastAlert) {
+            const timeSinceLastAlert = now.getTime() - lastAlert.getTime();
+            if (timeSinceLastAlert < this.config.cooldownPeriod) {
+                this.logger.debug("Alert skipped due to cooldown", {
+                    serverId: server.id,
+                    timeSinceLastAlert,
+                    cooldownPeriod: this.config.cooldownPeriod,
+                });
+                return;
+            }
+        }
+        this.lastAlertTime.set(server.id, now);
+        this.emit("alert:triggered", {
+            server,
+            status,
+            previousStatus,
+            timestamp: now,
+        });
+        this.logger.error("Server alert triggered", undefined, {
+            serverId: server.id,
+            serverName: status.serverName,
+            consecutiveFailures: status.consecutiveFailures,
+            error: status.error,
+        });
+    }
+    /**
+     * Schedule next monitoring check
+     */
+    scheduleNextCheck() {
+        this.checkTimer = setTimeout(() => {
+            this.performCheck();
+        }, this.config.checkInterval);
+    }
+    /**
+     * Perform monitoring check on all servers
+     */
+    async performCheck() {
+        const servers = Array.from(this.serverStatuses.keys());
+        if (servers.length === 0) {
+            this.scheduleNextCheck();
+            return;
+        }
+        this.logger.debug("Performing monitoring check", {
+            serverCount: servers.length,
+        });
+        // Check all servers in parallel
+        // Note: We need the actual Server objects, but we only have IDs here
+        // In practice, this would be called with server objects from the caller
+        // For now, we emit an event that the caller can handle
+        this.emit("check:needed", servers);
+        this.scheduleNextCheck();
+    }
+    /**
+     * Get monitoring statistics
+     */
+    getStats() {
+        let reachable = 0;
+        let unreachable = 0;
+        for (const status of this.serverStatuses.values()) {
+            if (status.isReachable) {
+                reachable++;
+            }
+            else {
+                unreachable++;
+            }
+        }
+        return {
+            totalServers: this.serverStatuses.size,
+            reachableServers: reachable,
+            unreachableServers: unreachable,
+            isRunning: this.isRunning,
+        };
+    }
+    /**
+     * Get log context for monitoring-related logs
+     */
+    getLogContext() {
+        const stats = this.getStats();
+        return {
+            monitoring: stats.isRunning,
+            totalServers: stats.totalServers,
+            reachableServers: stats.reachableServers,
+            unreachableServers: stats.unreachableServers,
+        };
+    }
+}
+//# sourceMappingURL=MonitoringService.js.map

package/dist/services/MonitoringService.js.map

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

package/dist/services/NotificationService.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Notification Service
+ * Provides admin notifications for important events
+ */
+import { LoggingService } from "./LoggingService.js";
+import type { IBot, LogContext, Server } from "../types/index.js";
+/**
+ * Notification types
+ */
+export type NotificationType = "startup" | "shutdown" | "error" | "security" | "server_added" | "server_removed" | "connection_lost" | "connection_restored" | "backup_created" | "backup_restored" | "config_reloaded" | "rate_limited" | "unauthorized_access";
+/**
+ * Notification priority
+ */
+export type NotificationPriority = "low" | "normal" | "high" | "critical";
+/**
+ * Notification payload
+ */
+export interface NotificationPayload {
+    type: NotificationType;
+    priority: NotificationPriority;
+    title: string;
+    message: string;
+    details?: Record<string, unknown>;
+    timestamp: Date;
+}
+/**
+ * Notification configuration
+ */
+export interface NotificationConfig {
+    enabled: boolean;
+    notifyOnStartup: boolean;
+    notifyOnShutdown: boolean;
+    notifyOnErrors: boolean;
+    notifyOnSecurity: boolean;
+    adminChatId: string;
+}
+/**
+ * Service for sending admin notifications
+ */
+export declare class NotificationService {
+    private readonly logger;
+    private readonly config;
+    private bot;
+    private notificationCount;
+    private readonly startTime;
+    constructor(config: Partial<NotificationConfig>, logger: LoggingService);
+    /**
+     * Set the bot instance for sending messages
+     */
+    setBot(bot: IBot): void;
+    /**
+     * Send a notification
+     */
+    notify(payload: Omit<NotificationPayload, "timestamp">): Promise<boolean>;
+    /**
+     * Send startup notification
+     */
+    notifyStartup(version: string): Promise<boolean>;
+    /**
+     * Send shutdown notification
+     */
+    notifyShutdown(reason: string): Promise<boolean>;
+    /**
+     * Send error notification
+     */
+    notifyError(error: Error, context?: Record<string, unknown>): Promise<boolean>;
+    /**
+     * Send security notification
+     */
+    notifySecurity(event: string, details?: Record<string, unknown>): Promise<boolean>;
+    /**
+     * Send server added notification
+     */
+    notifyServerAdded(server: Server): Promise<boolean>;
+    /**
+     * Send server removed notification
+     */
+    notifyServerRemoved(server: Server): Promise<boolean>;
+    /**
+     * Send connection lost notification
+     */
+    notifyConnectionLost(server: Server, error?: string): Promise<boolean>;
+    /**
+     * Send connection restored notification
+     */
+    notifyConnectionRestored(server: Server): Promise<boolean>;
+    /**
+     * Send backup created notification
+     */
+    notifyBackupCreated(backupId: string, size: number): Promise<boolean>;
+    /**
+     * Send backup restored notification
+     */
+    notifyBackupRestored(backupId: string): Promise<boolean>;
+    /**
+     * Send config reloaded notification
+     */
+    notifyConfigReloaded(success: boolean): Promise<boolean>;
+    /**
+     * Send rate limited notification
+     */
+    notifyRateLimited(chatId: number, command: string): Promise<boolean>;
+    /**
+     * Send unauthorized access notification
+     */
+    notifyUnauthorizedAccess(chatId: number, username: string | undefined, command: string): Promise<boolean>;
+    /**
+     * Get notification statistics
+     */
+    getStats(): {
+        enabled: boolean;
+        totalNotifications: number;
+        uptime: number;
+    };
+    /**
+     * Get log context for notification-related logs
+     */
+    getLogContext(): LogContext;
+    /**
+     * Format notification message
+     */
+    private formatNotification;
+    /**
+     * Format uptime as human-readable string
+     */
+    private formatUptime;
+    /**
+     * Format bytes to human-readable string
+     */
+    private formatBytes;
+}
+//# sourceMappingURL=NotificationService.d.ts.map

package/dist/services/NotificationService.d.ts.map

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