telegram-ssh-bot 2.0.0 → 2.2.0

package/dist/services/LoggingService.js

@@ -0,0 +1,334 @@
+/**
+ * Logging Service
+ * Provides structured logging with multiple output formats, log rotation, and request tracking
+ */
+import { promises as fs } from "fs";
+import * as path from "path";
+const LOG_LEVELS = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+};
+/**
+ * Logging service for structured logging with rotation and request tracking
+ */
+export class LoggingService {
+    level;
+    format;
+    file;
+    maxFileSize;
+    maxFiles;
+    currentLogFile = null;
+    requestCounter = 0;
+    performanceTimers = new Map();
+    logCount = 0;
+    errorCount = 0;
+    startTime;
+    constructor(config) {
+        this.level = this.parseLevel(config.level);
+        this.format = config.format;
+        this.file = config.file;
+        this.maxFileSize = 10 * 1024 * 1024; // 10MB default
+        this.maxFiles = 5;
+        this.startTime = new Date();
+    }
+    /**
+     * Log info message
+     */
+    info(message, context) {
+        this.log("info", message, undefined, context);
+    }
+    /**
+     * Log warning message
+     */
+    warn(message, context) {
+        this.log("warn", message, undefined, context);
+    }
+    /**
+     * Log error message
+     */
+    error(message, error, context) {
+        this.log("error", message, error, context);
+    }
+    /**
+     * Log debug message
+     */
+    debug(message, context) {
+        this.log("debug", message, undefined, context);
+    }
+    /**
+     * Log with request ID tracking
+     */
+    withRequestId(requestId) {
+        const logWithContext = (level, message, error, context) => {
+            this.log(level, message, error, { ...context, requestId });
+        };
+        return {
+            info: (message, context) => logWithContext("info", message, undefined, context),
+            warn: (message, context) => logWithContext("warn", message, undefined, context),
+            error: (message, error, context) => logWithContext("error", message, error, context),
+            debug: (message, context) => logWithContext("debug", message, undefined, context),
+        };
+    }
+    /**
+     * Generate a new request ID
+     */
+    generateRequestId() {
+        this.requestCounter++;
+        const timestamp = Date.now().toString(36);
+        const counter = this.requestCounter.toString(36).padStart(4, "0");
+        return `req_${timestamp}_${counter}`;
+    }
+    /**
+     * Start a performance timer
+     */
+    startTimer(label, context) {
+        const timerId = `${label}_${Date.now()}_${Math.random().toString(36).substring(2, 6)}`;
+        this.performanceTimers.set(timerId, {
+            startTime: Date.now(),
+            label,
+            context,
+        });
+        return timerId;
+    }
+    /**
+     * End a performance timer and log the duration
+     */
+    endTimer(timerId, additionalContext) {
+        const timer = this.performanceTimers.get(timerId);
+        if (!timer) {
+            this.warn(`Timer not found: ${timerId}`);
+            return null;
+        }
+        this.performanceTimers.delete(timerId);
+        const duration = Date.now() - timer.startTime;
+        this.debug(`Performance: ${timer.label}`, {
+            ...timer.context,
+            ...additionalContext,
+            duration,
+            durationMs: duration,
+        });
+        return duration;
+    }
+    /**
+     * Log performance metrics
+     */
+    logPerformance(operation, duration, context) {
+        this.log("debug", `Performance: ${operation}`, undefined, {
+            ...context,
+            duration,
+            durationMs: duration,
+            performance: true,
+        });
+    }
+    /**
+     * Log with component context
+     */
+    withComponent(component) {
+        const logWithContext = (level, message, error, context) => {
+            this.log(level, message, error, { ...context, component });
+        };
+        return {
+            info: (message, context) => logWithContext("info", message, undefined, context),
+            warn: (message, context) => logWithContext("warn", message, undefined, context),
+            error: (message, error, context) => logWithContext("error", message, error, context),
+            debug: (message, context) => logWithContext("debug", message, undefined, context),
+        };
+    }
+    /**
+     * Get logging statistics
+     */
+    getStats() {
+        return {
+            totalLogs: this.logCount,
+            errorCount: this.errorCount,
+            uptime: Math.floor((Date.now() - this.startTime.getTime()) / 1000),
+            activeTimers: this.performanceTimers.size,
+            requestCount: this.requestCounter,
+        };
+    }
+    /**
+     * Internal log method
+     */
+    log(level, message, error, context) {
+        if (!this.shouldLog(level)) {
+            return;
+        }
+        this.logCount++;
+        if (level === "error") {
+            this.errorCount++;
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level,
+            message,
+            context,
+            error: error
+                ? {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                }
+                : undefined,
+            requestId: context?.requestId,
+            component: context?.component,
+        };
+        const output = this.format === "json" ? JSON.stringify(entry) : this.formatPretty(entry);
+        // Use appropriate console method
+        if (level === "error") {
+            console.error(output);
+        }
+        else if (level === "warn") {
+            console.warn(output);
+        }
+        else {
+            console.log(output);
+        }
+        // Write to file if configured
+        if (this.file) {
+            this.writeToFile(output).catch((err) => {
+                console.error("Failed to write to log file:", err);
+            });
+        }
+    }
+    /**
+     * Check if should log based on level
+     */
+    shouldLog(level) {
+        return LOG_LEVELS[level] >= LOG_LEVELS[this.level];
+    }
+    /**
+     * Parse log level from string
+     */
+    parseLevel(level) {
+        const normalized = level.toLowerCase();
+        if (normalized in LOG_LEVELS) {
+            return normalized;
+        }
+        return "info";
+    }
+    /**
+     * Format log entry as pretty string
+     */
+    formatPretty(entry) {
+        const timestamp = entry.timestamp;
+        const level = entry.level.toUpperCase().padEnd(5);
+        const requestId = entry.requestId ? `[${entry.requestId}] ` : "";
+        const component = entry.component ? `<${entry.component}> ` : "";
+        const context = entry.context ? ` ${JSON.stringify(entry.context)}` : "";
+        const error = entry.error
+            ? `\n  ${entry.error.stack ?? entry.error.message}`
+            : "";
+        return `[${timestamp}] ${level} | ${requestId}${component}${entry.message}${context}${error}`;
+    }
+    /**
+     * Write log entry to file
+     */
+    async writeToFile(line) {
+        if (!this.file) {
+            return;
+        }
+        try {
+            // Check if we need to rotate
+            if (this.currentLogFile && this.currentLogFile.size >= this.maxFileSize) {
+                await this.rotateLogFile();
+            }
+            // Initialize log file if needed
+            if (!this.currentLogFile) {
+                await this.initializeLogFile();
+            }
+            if (this.currentLogFile) {
+                const logLine = line + "\n";
+                await fs.appendFile(this.currentLogFile.path, logLine, "utf-8");
+                this.currentLogFile.size += Buffer.byteLength(logLine, "utf-8");
+            }
+        }
+        catch (error) {
+            // Don't throw, just log to console
+            console.error("Failed to write to log file:", error);
+        }
+    }
+    /**
+     * Initialize log file
+     */
+    async initializeLogFile() {
+        if (!this.file) {
+            return;
+        }
+        const logDir = path.dirname(this.file);
+        await fs.mkdir(logDir, { recursive: true });
+        this.currentLogFile = {
+            path: this.file,
+            size: 0,
+            createdAt: new Date(),
+        };
+        // Check existing file size
+        try {
+            const stats = await fs.stat(this.file);
+            this.currentLogFile.size = stats.size;
+        }
+        catch {
+            // File doesn't exist, that's fine
+        }
+    }
+    /**
+     * Rotate log file
+     */
+    async rotateLogFile() {
+        if (!this.file || !this.currentLogFile) {
+            return;
+        }
+        const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+        const rotatedPath = `${this.file}.${timestamp}`;
+        try {
+            // Ensure any pending writes are complete by waiting a tick
+            // This allows any in-flight appendFile operations to complete
+            await new Promise((resolve) => setImmediate(resolve));
+            // Rename current file
+            await fs.rename(this.file, rotatedPath);
+            // Clean up old files
+            await this.cleanupOldLogFiles();
+            // Reset current log file with fresh state
+            this.currentLogFile = {
+                path: this.file,
+                size: 0,
+                createdAt: new Date(),
+            };
+            console.log(`Log rotated to ${rotatedPath}`);
+        }
+        catch (error) {
+            console.error("Failed to rotate log file:", error);
+        }
+    }
+    /**
+     * Clean up old log files
+     */
+    async cleanupOldLogFiles() {
+        if (!this.file) {
+            return;
+        }
+        const logDir = path.dirname(this.file);
+        const baseName = path.basename(this.file);
+        try {
+            const files = await fs.readdir(logDir);
+            const logFiles = files
+                .filter((f) => f.startsWith(baseName) && f !== baseName)
+                .map((f) => ({
+                name: f,
+                path: path.join(logDir, f),
+            }))
+                .sort((a, b) => b.name.localeCompare(a.name));
+            // Remove files beyond max count
+            const toRemove = logFiles.slice(this.maxFiles - 1);
+            for (const file of toRemove) {
+                await fs.unlink(file.path);
+                console.log(`Removed old log file: ${file.name}`);
+            }
+        }
+        catch (error) {
+            console.error("Failed to cleanup old log files:", error);
+        }
+    }
+}
+//# sourceMappingURL=LoggingService.js.map

package/dist/services/LoggingService.js.map

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

package/dist/services/MonitoringService.d.ts

@@ -0,0 +1,119 @@
+/**
+ * Monitoring Service
+ * Provides server health monitoring and alerting
+ */
+import { EventEmitter } from "events";
+import type { LogContext, Server } from "../types/index.js";
+import { LoggingService } from "./LoggingService.js";
+/**
+ * Server monitoring status
+ */
+export interface ServerMonitorStatus {
+    serverId: string;
+    serverName: string;
+    host: string;
+    isReachable: boolean;
+    lastCheck: Date | null;
+    lastSuccessfulCheck: Date | null;
+    consecutiveFailures: number;
+    latency: number | null;
+    error?: string;
+}
+/**
+ * Monitoring configuration
+ */
+export interface MonitoringConfig {
+    enabled: boolean;
+    checkInterval: number;
+    timeout: number;
+    alertThreshold: number;
+    cooldownPeriod: number;
+}
+/**
+ * Monitoring event types
+ */
+export type MonitoringEvent = "server:unreachable" | "server:recovered" | "server:degraded" | "alert:triggered";
+/**
+ * Monitoring event payload
+ */
+export interface MonitoringEventPayload {
+    server: Server;
+    status: ServerMonitorStatus;
+    previousStatus?: ServerMonitorStatus;
+    timestamp: Date;
+}
+/**
+ * Service for monitoring server health
+ */
+export declare class MonitoringService extends EventEmitter {
+    private readonly logger;
+    private readonly config;
+    private readonly serverStatuses;
+    private checkTimer;
+    private lastAlertTime;
+    private isRunning;
+    private checkFunction;
+    constructor(config: Partial<MonitoringConfig>, logger: LoggingService);
+    /**
+     * Set the check function for server reachability
+     */
+    setCheckFunction(fn: (server: Server) => Promise<boolean>): void;
+    /**
+     * Start monitoring
+     */
+    start(): void;
+    /**
+     * Stop monitoring
+     */
+    stop(): void;
+    /**
+     * Register a server for monitoring
+     */
+    registerServer(server: Server): void;
+    /**
+     * Unregister a server from monitoring
+     */
+    unregisterServer(serverId: string): void;
+    /**
+     * Get server status
+     */
+    getServerStatus(serverId: string): ServerMonitorStatus | undefined;
+    /**
+     * Get all server statuses
+     */
+    getAllStatuses(): ServerMonitorStatus[];
+    /**
+     * Check a specific server
+     */
+    checkServer(server: Server): Promise<ServerMonitorStatus>;
+    /**
+     * Handle server failure
+     */
+    private handleFailure;
+    /**
+     * Maybe trigger an alert (respects cooldown)
+     */
+    private maybeTriggerAlert;
+    /**
+     * Schedule next monitoring check
+     */
+    private scheduleNextCheck;
+    /**
+     * Perform monitoring check on all servers
+     */
+    private performCheck;
+    /**
+     * Get monitoring statistics
+     */
+    getStats(): {
+        totalServers: number;
+        reachableServers: number;
+        unreachableServers: number;
+        isRunning: boolean;
+    };
+    /**
+     * Get log context for monitoring-related logs
+     */
+    getLogContext(): LogContext;
+}
+//# sourceMappingURL=MonitoringService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MonitoringService.d.ts","sourceRoot":"","sources":["../../src/services/MonitoringService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IACvB,mBAAmB,EAAE,IAAI,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,oBAAoB,GACpB,kBAAkB,GAClB,iBAAiB,GACjB,iBAAiB,CAAC;AAEtB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,mBAAmB,CAAC;IAC5B,cAAc,CAAC,EAAE,mBAAmB,CAAC;IACrC,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAC9E,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAuD;gBAEhE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,cAAc;IAYrE;;OAEG;IACH,gBAAgB,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;IAIhE;;OAEG;IACH,KAAK,IAAI,IAAI;IAYb;;OAEG;IACH,IAAI,IAAI,IAAI;IASZ;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAmBpC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMxC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIlE;;OAEG;IACH,cAAc,IAAI,mBAAmB,EAAE;IAIvC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA4D/D;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;YACW,YAAY;IAqB1B;;OAEG;IACH,QAAQ,IAAI;QACV,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,SAAS,EAAE,OAAO,CAAC;KACpB;IAoBD;;OAEG;IACH,aAAa,IAAI,UAAU;CAS5B"}