telegram-ssh-bot 2.0.0 → 2.2.0

package/dist/services/NotificationService.js

@@ -0,0 +1,297 @@
+/**
+ * Notification Service
+ * Provides admin notifications for important events
+ */
+/**
+ * Service for sending admin notifications
+ */
+export class NotificationService {
+    logger;
+    config;
+    bot = null;
+    notificationCount = 0;
+    startTime;
+    constructor(config, logger) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            notifyOnStartup: config.notifyOnStartup ?? true,
+            notifyOnShutdown: config.notifyOnShutdown ?? true,
+            notifyOnErrors: config.notifyOnErrors ?? true,
+            notifyOnSecurity: config.notifyOnSecurity ?? true,
+            adminChatId: config.adminChatId ?? "",
+        };
+        this.logger = logger;
+        this.startTime = new Date();
+    }
+    /**
+     * Set the bot instance for sending messages
+     */
+    setBot(bot) {
+        this.bot = bot;
+    }
+    /**
+     * Send a notification
+     */
+    async notify(payload) {
+        if (!this.config.enabled || !this.bot || !this.config.adminChatId) {
+            this.logger.debug("Notification skipped", {
+                enabled: this.config.enabled,
+                hasBot: !!this.bot,
+                hasChatId: !!this.config.adminChatId,
+            });
+            return false;
+        }
+        const fullPayload = {
+            ...payload,
+            timestamp: new Date(),
+        };
+        try {
+            const message = this.formatNotification(fullPayload);
+            await this.bot.sendMessage(parseInt(this.config.adminChatId, 10), message, { parseMode: "Markdown" });
+            this.notificationCount++;
+            this.logger.debug("Notification sent", {
+                type: payload.type,
+                priority: payload.priority,
+            });
+            return true;
+        }
+        catch (error) {
+            this.logger.error("Failed to send notification", error, {
+                type: payload.type,
+            });
+            return false;
+        }
+    }
+    /**
+     * Send startup notification
+     */
+    async notifyStartup(version) {
+        if (!this.config.notifyOnStartup) {
+            return false;
+        }
+        return this.notify({
+            type: "startup",
+            priority: "normal",
+            title: "🚀 Bot Started",
+            message: `Telegram SSH Bot has started successfully.\n\nVersion: ${version}\nStarted at: ${this.startTime.toISOString()}`,
+        });
+    }
+    /**
+     * Send shutdown notification
+     */
+    async notifyShutdown(reason) {
+        if (!this.config.notifyOnShutdown) {
+            return false;
+        }
+        const uptime = Math.floor((Date.now() - this.startTime.getTime()) / 1000);
+        return this.notify({
+            type: "shutdown",
+            priority: "high",
+            title: "🛑 Bot Shutting Down",
+            message: `Telegram SSH Bot is shutting down.\n\nReason: ${reason}\nUptime: ${this.formatUptime(uptime)}`,
+        });
+    }
+    /**
+     * Send error notification
+     */
+    async notifyError(error, context) {
+        if (!this.config.notifyOnErrors) {
+            return false;
+        }
+        return this.notify({
+            type: "error",
+            priority: "high",
+            title: "⚠️ Error Occurred",
+            message: `An error occurred:\n\n${error.message}\n\nStack: \`${error.stack?.split("\n")[0] ?? "N/A"}\``,
+            details: { errorName: error.name, ...context },
+        });
+    }
+    /**
+     * Send security notification
+     */
+    async notifySecurity(event, details) {
+        if (!this.config.notifyOnSecurity) {
+            return false;
+        }
+        return this.notify({
+            type: "security",
+            priority: "critical",
+            title: "🔒 Security Event",
+            message: `Security event detected:\n\n${event}`,
+            details,
+        });
+    }
+    /**
+     * Send server added notification
+     */
+    async notifyServerAdded(server) {
+        return this.notify({
+            type: "server_added",
+            priority: "normal",
+            title: "➕ Server Added",
+            message: `New server added:\n\nHost: \`${server.host}\`\nUsername: \`${server.username}\`\nPort: ${server.port}`,
+            details: { serverId: server.id },
+        });
+    }
+    /**
+     * Send server removed notification
+     */
+    async notifyServerRemoved(server) {
+        return this.notify({
+            type: "server_removed",
+            priority: "normal",
+            title: "➖ Server Removed",
+            message: `Server removed:\n\nHost: \`${server.host}\`\nUsername: \`${server.username}\``,
+            details: { serverId: server.id },
+        });
+    }
+    /**
+     * Send connection lost notification
+     */
+    async notifyConnectionLost(server, error) {
+        return this.notify({
+            type: "connection_lost",
+            priority: "high",
+            title: "🔌 Connection Lost",
+            message: `Connection lost to server:\n\nHost: \`${server.host}\`\n${error ? `Error: ${error}` : ""}`,
+            details: { serverId: server.id, error },
+        });
+    }
+    /**
+     * Send connection restored notification
+     */
+    async notifyConnectionRestored(server) {
+        return this.notify({
+            type: "connection_restored",
+            priority: "normal",
+            title: "✅ Connection Restored",
+            message: `Connection restored to server:\n\nHost: \`${server.host}\``,
+            details: { serverId: server.id },
+        });
+    }
+    /**
+     * Send backup created notification
+     */
+    async notifyBackupCreated(backupId, size) {
+        return this.notify({
+            type: "backup_created",
+            priority: "low",
+            title: "💾 Backup Created",
+            message: `Backup created successfully.\n\nID: \`${backupId}\`\nSize: ${this.formatBytes(size)}`,
+            details: { backupId, size },
+        });
+    }
+    /**
+     * Send backup restored notification
+     */
+    async notifyBackupRestored(backupId) {
+        return this.notify({
+            type: "backup_restored",
+            priority: "normal",
+            title: "📂 Backup Restored",
+            message: `Backup restored successfully.\n\nID: \`${backupId}\``,
+            details: { backupId },
+        });
+    }
+    /**
+     * Send config reloaded notification
+     */
+    async notifyConfigReloaded(success) {
+        return this.notify({
+            type: "config_reloaded",
+            priority: success ? "normal" : "high",
+            title: success ? "⚙️ Config Reloaded" : "⚠️ Config Reload Failed",
+            message: success
+                ? "Configuration reloaded successfully."
+                : "Configuration reload failed. Check logs for details.",
+        });
+    }
+    /**
+     * Send rate limited notification
+     */
+    async notifyRateLimited(chatId, command) {
+        return this.notify({
+            type: "rate_limited",
+            priority: "normal",
+            title: "⏱️ Rate Limited",
+            message: `User rate limited.\n\nChat ID: ${chatId}\nCommand: \`${command}\``,
+            details: { chatId, command },
+        });
+    }
+    /**
+     * Send unauthorized access notification
+     */
+    async notifyUnauthorizedAccess(chatId, username, command) {
+        return this.notify({
+            type: "unauthorized_access",
+            priority: "critical",
+            title: "🚫 Unauthorized Access",
+            message: `Unauthorized access attempt.\n\nChat ID: ${chatId}\nUsername: ${username ?? "Unknown"}\nCommand: \`${command}\``,
+            details: { chatId, username, command },
+        });
+    }
+    /**
+     * Get notification statistics
+     */
+    getStats() {
+        return {
+            enabled: this.config.enabled,
+            totalNotifications: this.notificationCount,
+            uptime: Math.floor((Date.now() - this.startTime.getTime()) / 1000),
+        };
+    }
+    /**
+     * Get log context for notification-related logs
+     */
+    getLogContext() {
+        const stats = this.getStats();
+        return {
+            notificationsEnabled: stats.enabled,
+            totalNotifications: stats.totalNotifications,
+        };
+    }
+    /**
+     * Format notification message
+     */
+    formatNotification(payload) {
+        const priorityEmoji = {
+            low: "ℹ️",
+            normal: "📢",
+            high: "⚠️",
+            critical: "🚨",
+        };
+        let message = `${priorityEmoji[payload.priority]} *${payload.title}*\n\n`;
+        message += payload.message;
+        message += `\n\n_Time: ${payload.timestamp.toISOString()}_`;
+        return message;
+    }
+    /**
+     * Format uptime as human-readable string
+     */
+    formatUptime(seconds) {
+        const days = Math.floor(seconds / 86400);
+        const hours = Math.floor((seconds % 86400) / 3600);
+        const minutes = Math.floor((seconds % 3600) / 60);
+        const parts = [];
+        if (days > 0)
+            parts.push(`${days}d`);
+        if (hours > 0)
+            parts.push(`${hours}h`);
+        parts.push(`${minutes}m`);
+        return parts.join(" ");
+    }
+    /**
+     * Format bytes to human-readable string
+     */
+    formatBytes(bytes) {
+        const units = ["B", "KB", "MB", "GB"];
+        let value = bytes;
+        let unitIndex = 0;
+        while (value >= 1024 && unitIndex < units.length - 1) {
+            value /= 1024;
+            unitIndex++;
+        }
+        return `${value.toFixed(2)} ${units[unitIndex]}`;
+    }
+}
+//# sourceMappingURL=NotificationService.js.map

package/dist/services/NotificationService.js.map

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

package/dist/services/RateLimiter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Rate Limiter Service
+ * Provides rate limiting for API requests
+ */
+import type { RateLimitConfig } from "../types/index.js";
+/**
+ * Rate limiter service for controlling request frequency
+ */
+export declare class RateLimiter {
+    private readonly config;
+    private readonly store;
+    private cleanupTimer;
+    private static readonly CLEANUP_INTERVAL_MS;
+    constructor(config: RateLimitConfig);
+    /**
+     * Start automatic cleanup timer
+     * Runs cleanup periodically to remove expired records
+     */
+    startAutoCleanup(): void;
+    /**
+     * Stop automatic cleanup timer
+     * Should be called during shutdown
+     */
+    stopAutoCleanup(): void;
+    /**
+     * Check if a request is allowed for the given identifier
+     * @throws RateLimitedError if rate limit is exceeded
+     */
+    checkLimit(identifier: string): boolean;
+    /**
+     * Check if identifier is currently rate limited
+     */
+    isLimited(identifier: string): boolean;
+    /**
+     * Get remaining requests for identifier
+     */
+    getRemaining(identifier: string): number;
+    /**
+     * Reset rate limit for identifier
+     */
+    reset(identifier: string): void;
+    /**
+     * Reset all rate limits
+     */
+    resetAll(): void;
+    /**
+     * Clean up expired records
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=RateLimiter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RateLimiter.d.ts","sourceRoot":"","sources":["../../src/services/RateLimiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWzD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2C;IACjE,OAAO,CAAC,YAAY,CAA+B;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAiB;gBAEhD,MAAM,EAAE,eAAe;IAInC;;;OAGG;IACH,gBAAgB,IAAI,IAAI;IAexB;;;OAGG;IACH,eAAe,IAAI,IAAI;IAOvB;;;OAGG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IA4CvC;;OAEG;IACH,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAatC;;OAEG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAcxC;;OAEG;IACH,KAAK,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAI/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAIhB;;OAEG;IACH,OAAO,IAAI,IAAI;CAoBhB"}

package/dist/services/RateLimiter.js

@@ -0,0 +1,141 @@
+/**
+ * Rate Limiter Service
+ * Provides rate limiting for API requests
+ */
+import { RateLimitedError } from "../errors/index.js";
+/**
+ * Rate limiter service for controlling request frequency
+ */
+export class RateLimiter {
+    config;
+    store = new Map();
+    cleanupTimer = null;
+    static CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Start automatic cleanup timer
+     * Runs cleanup periodically to remove expired records
+     */
+    startAutoCleanup() {
+        if (this.cleanupTimer) {
+            return; // Already running
+        }
+        this.cleanupTimer = setInterval(() => {
+            this.cleanup();
+        }, RateLimiter.CLEANUP_INTERVAL_MS);
+        // Prevent the timer from keeping the process alive
+        if (this.cleanupTimer.unref) {
+            this.cleanupTimer.unref();
+        }
+    }
+    /**
+     * Stop automatic cleanup timer
+     * Should be called during shutdown
+     */
+    stopAutoCleanup() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+    }
+    /**
+     * Check if a request is allowed for the given identifier
+     * @throws RateLimitedError if rate limit is exceeded
+     */
+    checkLimit(identifier) {
+        if (!this.config.enabled) {
+            return true;
+        }
+        const now = Date.now();
+        // Get or create record
+        let record = this.store.get(identifier);
+        if (!record) {
+            record = { requests: [], blocked: false };
+            this.store.set(identifier, record);
+        }
+        // Check if blocked
+        if (record.blocked) {
+            if (record.blockedUntil && now < record.blockedUntil) {
+                const retryAfter = Math.ceil((record.blockedUntil - now) / 1000);
+                throw new RateLimitedError(retryAfter, { context: { identifier } });
+            }
+            // Reset block
+            record.blocked = false;
+            record.blockedUntil = undefined;
+        }
+        // Clean old requests
+        record.requests = record.requests.filter((time) => now - time < this.config.windowMs);
+        // Check limit
+        if (record.requests.length >= this.config.maxRequests) {
+            record.blocked = true;
+            record.blockedUntil = now + this.config.windowMs;
+            throw new RateLimitedError(Math.ceil(this.config.windowMs / 1000), {
+                context: { identifier },
+            });
+        }
+        // Record request
+        record.requests.push(now);
+        return true;
+    }
+    /**
+     * Check if identifier is currently rate limited
+     */
+    isLimited(identifier) {
+        const record = this.store.get(identifier);
+        if (!record) {
+            return false;
+        }
+        if (record.blocked && record.blockedUntil) {
+            return Date.now() < record.blockedUntil;
+        }
+        return false;
+    }
+    /**
+     * Get remaining requests for identifier
+     */
+    getRemaining(identifier) {
+        const record = this.store.get(identifier);
+        if (!record) {
+            return this.config.maxRequests;
+        }
+        const now = Date.now();
+        const validRequests = record.requests.filter((time) => now - time < this.config.windowMs);
+        return Math.max(0, this.config.maxRequests - validRequests.length);
+    }
+    /**
+     * Reset rate limit for identifier
+     */
+    reset(identifier) {
+        this.store.delete(identifier);
+    }
+    /**
+     * Reset all rate limits
+     */
+    resetAll() {
+        this.store.clear();
+    }
+    /**
+     * Clean up expired records
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, record] of this.store.entries()) {
+            // Remove expired blocked records
+            if (record.blocked && record.blockedUntil && now >= record.blockedUntil) {
+                this.store.delete(key);
+                continue;
+            }
+            // Remove records with no valid requests
+            const validRequests = record.requests.filter((time) => now - time < this.config.windowMs);
+            if (validRequests.length === 0) {
+                this.store.delete(key);
+            }
+            else {
+                record.requests = validRequests;
+            }
+        }
+    }
+}
+//# sourceMappingURL=RateLimiter.js.map

package/dist/services/RateLimiter.js.map

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

package/dist/services/ValidationService.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Validation Service
+ * Provides input validation and sanitization
+ */
+import type { SanitizedCommand, ServerConfig, SSHConnectionConfig, ValidationResult } from "../types/index.js";
+/**
+ * Validation service for input sanitization and validation
+ */
+export declare class ValidationService {
+    private readonly allowedCommands;
+    private readonly blockedCommands;
+    constructor(options?: {
+        allowedCommands?: string[];
+        blockedCommands?: string[];
+    });
+    /**
+     * Validate and sanitize a command
+     */
+    validateCommand(command: string): ValidationResult<SanitizedCommand>;
+    /**
+     * Validate server configuration
+     */
+    validateServerConfig(data: Partial<ServerConfig>): ValidationResult<ServerConfig>;
+    /**
+     * Validate SSH connection configuration
+     */
+    validateSSHConfig(config: SSHConnectionConfig): ValidationResult<SSHConnectionConfig>;
+    /**
+     * Validate a path for file operations
+     */
+    validatePath(inputPath: string, basePath?: string): ValidationResult<string>;
+    /**
+     * Validate a host address
+     */
+    validateHost(host: string): ValidationResult<string>;
+    /**
+     * Validate a port number
+     */
+    validatePort(port: number): ValidationResult<number>;
+    /**
+     * Parse and validate a port from string
+     */
+    parsePort(portStr: string): ValidationResult<number>;
+    /**
+     * Sanitize a command string
+     */
+    sanitizeCommand(command: string): SanitizedCommand;
+}
+//# sourceMappingURL=ValidationService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidationService.d.ts","sourceRoot":"","sources":["../../src/services/ValidationService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,mBAAmB,CAAC;AAS3B;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;gBAE3C,OAAO,CAAC,EAAE;QACpB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5B;IAKD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;IA+BpE;;OAEG;IACH,oBAAoB,CAClB,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAC1B,gBAAgB,CAAC,YAAY,CAAC;IAyDjC;;OAEG;IACH,iBAAiB,CACf,MAAM,EAAE,mBAAmB,GAC1B,gBAAgB,CAAC,mBAAmB,CAAC;IAgCxC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAI5E;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAIpD;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAIpD;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;IAIpD;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,gBAAgB;CAGnD"}