telegram-ssh-bot 2.0.0 → 2.2.0

package/dist/services/CryptoService.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Crypto Service
+ * Provides AES-256-GCM encryption for credential storage
+ */
+import type { EncryptedData } from '../types/index.js';
+/**
+ * Crypto service for encrypting and decrypting sensitive data
+ */
+export declare class CryptoService {
+    private readonly key;
+    constructor(encryptionKey: string);
+    /**
+     * Encrypt plaintext string using AES-256-GCM
+     */
+    encrypt(plaintext: string): EncryptedData;
+    /**
+     * Decrypt encrypted data using AES-256-GCM
+     */
+    decrypt(encrypted: EncryptedData): string;
+    /**
+     * Hash a string using SHA-256
+     */
+    hash(data: string): string;
+    /**
+     * Verify a hash against data
+     */
+    verifyHash(data: string, hash: string): boolean;
+    /**
+     * Generate a random hex string
+     */
+    static generateKey(): string;
+    /**
+     * Generate a random ID
+     */
+    static generateId(prefix?: string): string;
+}
+//# sourceMappingURL=CryptoService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CryptoService.d.ts","sourceRoot":"","sources":["../../src/services/CryptoService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAUvD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,aAAa,EAAE,MAAM;IAcjC;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa;IAyBzC;;OAEG;IACH,OAAO,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM;IAgCzC;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAI1B;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAI/C;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM;IAI5B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;CAI/C"}

package/dist/services/CryptoService.js

@@ -0,0 +1,108 @@
+/**
+ * Crypto Service
+ * Provides AES-256-GCM encryption for credential storage
+ */
+import * as crypto from 'crypto';
+import { InvalidConfigError } from '../errors/index.js';
+/**
+ * Encryption algorithm configuration
+ */
+const ALGORITHM = 'aes-256-gcm';
+const IV_LENGTH = 12; // 12 bytes for GCM
+const AUTH_TAG_LENGTH = 16; // 16 bytes for GCM auth tag
+/**
+ * Crypto service for encrypting and decrypting sensitive data
+ */
+export class CryptoService {
+    key;
+    constructor(encryptionKey) {
+        // Validate key length (should be 64 hex characters = 32 bytes)
+        if (encryptionKey.length !== 64) {
+            throw new InvalidConfigError('Encryption key must be 64 hex characters (32 bytes)');
+        }
+        // Convert hex string to buffer
+        this.key = Buffer.from(encryptionKey, 'hex');
+        if (this.key.length !== 32) {
+            throw new InvalidConfigError('Encryption key must decode to 32 bytes');
+        }
+    }
+    /**
+     * Encrypt plaintext string using AES-256-GCM
+     */
+    encrypt(plaintext) {
+        // Generate random IV
+        const iv = crypto.randomBytes(IV_LENGTH);
+        // Create cipher
+        const cipher = crypto.createCipheriv(ALGORITHM, this.key, iv, {
+            authTagLength: AUTH_TAG_LENGTH,
+        });
+        // Encrypt
+        const encrypted = Buffer.concat([
+            cipher.update(plaintext, 'utf8'),
+            cipher.final(),
+        ]);
+        // Get auth tag
+        const authTag = cipher.getAuthTag();
+        return {
+            iv: iv.toString('base64'),
+            authTag: authTag.toString('base64'),
+            data: encrypted.toString('base64'),
+        };
+    }
+    /**
+     * Decrypt encrypted data using AES-256-GCM
+     */
+    decrypt(encrypted) {
+        // Decode from base64
+        const iv = Buffer.from(encrypted.iv, 'base64');
+        const authTag = Buffer.from(encrypted.authTag, 'base64');
+        const data = Buffer.from(encrypted.data, 'base64');
+        // Validate IV length
+        if (iv.length !== IV_LENGTH) {
+            throw new Error('Invalid IV length');
+        }
+        // Create decipher
+        const decipher = crypto.createDecipheriv(ALGORITHM, this.key, iv, {
+            authTagLength: AUTH_TAG_LENGTH,
+        });
+        // Set auth tag
+        decipher.setAuthTag(authTag);
+        // Decrypt
+        try {
+            const decrypted = Buffer.concat([
+                decipher.update(data),
+                decipher.final(),
+            ]);
+            return decrypted.toString('utf8');
+        }
+        catch (error) {
+            throw new Error('Decryption failed: authentication tag verification failed');
+        }
+    }
+    /**
+     * Hash a string using SHA-256
+     */
+    hash(data) {
+        return crypto.createHash('sha256').update(data).digest('hex');
+    }
+    /**
+     * Verify a hash against data
+     */
+    verifyHash(data, hash) {
+        return this.hash(data) === hash;
+    }
+    /**
+     * Generate a random hex string
+     */
+    static generateKey() {
+        return crypto.randomBytes(32).toString('hex');
+    }
+    /**
+     * Generate a random ID
+     */
+    static generateId(prefix = '') {
+        const id = crypto.randomBytes(8).toString('hex');
+        return prefix ? `${prefix}_${id}` : id;
+    }
+}
+//# sourceMappingURL=CryptoService.js.map

package/dist/services/CryptoService.js.map

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

package/dist/services/HealthService.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Health Service
+ * Provides system health monitoring and status reporting
+ */
+import type { LogContext } from "../types/index.js";
+/**
+ * Component health status
+ */
+export interface ComponentHealth {
+    status: "up" | "down";
+    latency?: number;
+    message?: string;
+    lastCheck?: Date;
+}
+/**
+ * Memory health metrics
+ */
+export interface MemoryHealth {
+    heapUsed: number;
+    heapTotal: number;
+    rss: number;
+    external: number;
+    arrayBuffers: number;
+}
+/**
+ * Overall health status
+ */
+export interface HealthStatus {
+    status: "healthy" | "degraded" | "unhealthy";
+    uptime: number;
+    timestamp: Date;
+    version: string;
+    components: {
+        bot: ComponentHealth;
+        storage: ComponentHealth;
+        memory: MemoryHealth;
+    };
+    metrics: {
+        activeConnections: number;
+        totalServers: number;
+        requestsProcessed: number;
+    };
+}
+/**
+ * Health check options
+ */
+export interface HealthCheckOptions {
+    version: string;
+    startTime: Date;
+}
+/**
+ * Service for monitoring application health
+ */
+export declare class HealthService {
+    private readonly version;
+    private readonly startTime;
+    private requestsProcessed;
+    private activeConnections;
+    private totalServers;
+    private storageHealthy;
+    private botHealthy;
+    private lastStorageCheck;
+    private lastBotCheck;
+    constructor(options: HealthCheckOptions);
+    /**
+     * Get current health status
+     */
+    getHealthStatus(): HealthStatus;
+    /**
+     * Get memory health metrics
+     */
+    private getMemoryHealth;
+    /**
+     * Get bot component health
+     */
+    private getBotHealth;
+    /**
+     * Get storage component health
+     */
+    private getStorageHealth;
+    /**
+     * Determine overall health status
+     */
+    private determineOverallStatus;
+    /**
+     * Get uptime in seconds
+     */
+    private getUptime;
+    /**
+     * Format uptime as human-readable string
+     */
+    formatUptime(): string;
+    /**
+     * Format bytes to human-readable string
+     */
+    formatBytes(bytes: number): string;
+    /**
+     * Get formatted health report
+     */
+    getFormattedHealthReport(): string;
+    /**
+     * Update bot health status
+     */
+    setBotHealth(healthy: boolean): void;
+    /**
+     * Update storage health status
+     */
+    setStorageHealth(healthy: boolean): void;
+    /**
+     * Increment request counter
+     */
+    incrementRequests(): void;
+    /**
+     * Set active connections count
+     */
+    setActiveConnections(count: number): void;
+    /**
+     * Set total servers count
+     */
+    setTotalServers(count: number): void;
+    /**
+     * Get log context for health-related logs
+     */
+    getLogContext(): LogContext;
+}
+//# sourceMappingURL=HealthService.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HealthService.d.ts","sourceRoot":"","sources":["../../src/services/HealthService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,IAAI,GAAG,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE;QACV,GAAG,EAAE,eAAe,CAAC;QACrB,OAAO,EAAE,eAAe,CAAC;QACzB,MAAM,EAAE,YAAY,CAAC;KACtB,CAAC;IACF,OAAO,EAAE;QACP,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAO;IACjC,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,YAAY,CAAqB;gBAE7B,OAAO,EAAE,kBAAkB;IAKvC;;OAEG;IACH,eAAe,IAAI,YAAY;IAwB/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAuB9B;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,YAAY,IAAI,MAAM;IAgBtB;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAalC;;OAEG;IACH,wBAAwB,IAAI,MAAM;IAsClC;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKpC;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKxC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIzC;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,aAAa,IAAI,UAAU;CAS5B"}

package/dist/services/HealthService.js

@@ -0,0 +1,213 @@
+/**
+ * Health Service
+ * Provides system health monitoring and status reporting
+ */
+/**
+ * Service for monitoring application health
+ */
+export class HealthService {
+    version;
+    startTime;
+    requestsProcessed = 0;
+    activeConnections = 0;
+    totalServers = 0;
+    storageHealthy = true;
+    botHealthy = true;
+    lastStorageCheck = null;
+    lastBotCheck = null;
+    constructor(options) {
+        this.version = options.version;
+        this.startTime = options.startTime;
+    }
+    /**
+     * Get current health status
+     */
+    getHealthStatus() {
+        const memory = this.getMemoryHealth();
+        const components = {
+            bot: this.getBotHealth(),
+            storage: this.getStorageHealth(),
+            memory,
+        };
+        const status = this.determineOverallStatus(components);
+        return {
+            status,
+            uptime: this.getUptime(),
+            timestamp: new Date(),
+            version: this.version,
+            components,
+            metrics: {
+                activeConnections: this.activeConnections,
+                totalServers: this.totalServers,
+                requestsProcessed: this.requestsProcessed,
+            },
+        };
+    }
+    /**
+     * Get memory health metrics
+     */
+    getMemoryHealth() {
+        const memUsage = process.memoryUsage();
+        return {
+            heapUsed: memUsage.heapUsed,
+            heapTotal: memUsage.heapTotal,
+            rss: memUsage.rss,
+            external: memUsage.external,
+            arrayBuffers: memUsage.arrayBuffers,
+        };
+    }
+    /**
+     * Get bot component health
+     */
+    getBotHealth() {
+        return {
+            status: this.botHealthy ? "up" : "down",
+            lastCheck: this.lastBotCheck ?? undefined,
+            message: this.botHealthy ? "Bot is running" : "Bot is not responding",
+        };
+    }
+    /**
+     * Get storage component health
+     */
+    getStorageHealth() {
+        return {
+            status: this.storageHealthy ? "up" : "down",
+            lastCheck: this.lastStorageCheck ?? undefined,
+            message: this.storageHealthy
+                ? "Storage is accessible"
+                : "Storage is not accessible",
+        };
+    }
+    /**
+     * Determine overall health status
+     */
+    determineOverallStatus(components) {
+        // Check if any critical component is down
+        if (components.bot.status === "down" ||
+            components.storage.status === "down") {
+            return "unhealthy";
+        }
+        // Check memory usage - degraded if heap usage > 85%
+        const heapUsagePercent = (components.memory.heapUsed / components.memory.heapTotal) * 100;
+        if (heapUsagePercent > 85) {
+            return "degraded";
+        }
+        return "healthy";
+    }
+    /**
+     * Get uptime in seconds
+     */
+    getUptime() {
+        return Math.floor((Date.now() - this.startTime.getTime()) / 1000);
+    }
+    /**
+     * Format uptime as human-readable string
+     */
+    formatUptime() {
+        const uptime = this.getUptime();
+        const days = Math.floor(uptime / 86400);
+        const hours = Math.floor((uptime % 86400) / 3600);
+        const minutes = Math.floor((uptime % 3600) / 60);
+        const seconds = uptime % 60;
+        const parts = [];
+        if (days > 0)
+            parts.push(`${days}d`);
+        if (hours > 0)
+            parts.push(`${hours}h`);
+        if (minutes > 0)
+            parts.push(`${minutes}m`);
+        parts.push(`${seconds}s`);
+        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]}`;
+    }
+    /**
+     * Get formatted health report
+     */
+    getFormattedHealthReport() {
+        const health = this.getHealthStatus();
+        const memory = health.components.memory;
+        const heapUsagePercent = (memory.heapUsed / memory.heapTotal) * 100;
+        const statusEmoji = {
+            healthy: "✅",
+            degraded: "⚠️",
+            unhealthy: "❌",
+        };
+        const componentEmoji = {
+            up: "✅",
+            down: "❌",
+        };
+        let report = `${statusEmoji[health.status]} *System Health*\n\n`;
+        report += `📊 *Status:* ${health.status.toUpperCase()}\n`;
+        report += `⏱️ *Uptime:* ${this.formatUptime()}\n`;
+        report += `📌 *Version:* ${health.version}\n\n`;
+        report += `*Components:*\n`;
+        report += `  ${componentEmoji[health.components.bot.status]} Bot: ${health.components.bot.message}\n`;
+        report += `  ${componentEmoji[health.components.storage.status]} Storage: ${health.components.storage.message}\n\n`;
+        report += `*Memory:*\n`;
+        report += `  📦 Heap: ${this.formatBytes(memory.heapUsed)} / ${this.formatBytes(memory.heapTotal)} (${heapUsagePercent.toFixed(1)}%)\n`;
+        report += `  🖥️ RSS: ${this.formatBytes(memory.rss)}\n`;
+        report += `  🔗 External: ${this.formatBytes(memory.external)}\n\n`;
+        report += `*Metrics:*\n`;
+        report += `  🔌 Active Connections: ${health.metrics.activeConnections}\n`;
+        report += `  📋 Total Servers: ${health.metrics.totalServers}\n`;
+        report += `  📨 Requests Processed: ${health.metrics.requestsProcessed}\n`;
+        return report;
+    }
+    /**
+     * Update bot health status
+     */
+    setBotHealth(healthy) {
+        this.botHealthy = healthy;
+        this.lastBotCheck = new Date();
+    }
+    /**
+     * Update storage health status
+     */
+    setStorageHealth(healthy) {
+        this.storageHealthy = healthy;
+        this.lastStorageCheck = new Date();
+    }
+    /**
+     * Increment request counter
+     */
+    incrementRequests() {
+        this.requestsProcessed++;
+    }
+    /**
+     * Set active connections count
+     */
+    setActiveConnections(count) {
+        this.activeConnections = count;
+    }
+    /**
+     * Set total servers count
+     */
+    setTotalServers(count) {
+        this.totalServers = count;
+    }
+    /**
+     * Get log context for health-related logs
+     */
+    getLogContext() {
+        const health = this.getHealthStatus();
+        return {
+            status: health.status,
+            uptime: health.uptime,
+            activeConnections: health.metrics.activeConnections,
+            heapUsed: health.components.memory.heapUsed,
+        };
+    }
+}
+//# sourceMappingURL=HealthService.js.map

package/dist/services/HealthService.js.map

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

package/dist/services/LoggingService.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Logging Service
+ * Provides structured logging with multiple output formats, log rotation, and request tracking
+ */
+import type { LogContext, LoggingConfig } from "../types/index.js";
+/**
+ * Logging service for structured logging with rotation and request tracking
+ */
+export declare class LoggingService {
+    private readonly level;
+    private readonly format;
+    private readonly file?;
+    private readonly maxFileSize;
+    private readonly maxFiles;
+    private currentLogFile;
+    private requestCounter;
+    private readonly performanceTimers;
+    private logCount;
+    private errorCount;
+    private readonly startTime;
+    constructor(config: LoggingConfig);
+    /**
+     * Log info message
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Log warning message
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Log error message
+     */
+    error(message: string, error?: Error, context?: LogContext): void;
+    /**
+     * Log debug message
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Log with request ID tracking
+     */
+    withRequestId(requestId: string): {
+        info: (message: string, context?: LogContext) => void;
+        warn: (message: string, context?: LogContext) => void;
+        error: (message: string, error?: Error, context?: LogContext) => void;
+        debug: (message: string, context?: LogContext) => void;
+    };
+    /**
+     * Generate a new request ID
+     */
+    generateRequestId(): string;
+    /**
+     * Start a performance timer
+     */
+    startTimer(label: string, context?: LogContext): string;
+    /**
+     * End a performance timer and log the duration
+     */
+    endTimer(timerId: string, additionalContext?: LogContext): number | null;
+    /**
+     * Log performance metrics
+     */
+    logPerformance(operation: string, duration: number, context?: LogContext): void;
+    /**
+     * Log with component context
+     */
+    withComponent(component: string): {
+        info: (message: string, context?: LogContext) => void;
+        warn: (message: string, context?: LogContext) => void;
+        error: (message: string, error?: Error, context?: LogContext) => void;
+        debug: (message: string, context?: LogContext) => void;
+    };
+    /**
+     * Get logging statistics
+     */
+    getStats(): {
+        totalLogs: number;
+        errorCount: number;
+        uptime: number;
+        activeTimers: number;
+        requestCount: number;
+    };
+    /**
+     * Internal log method
+     */
+    private log;
+    /**
+     * Check if should log based on level
+     */
+    private shouldLog;
+    /**
+     * Parse log level from string
+     */
+    private parseLevel;
+    /**
+     * Format log entry as pretty string
+     */
+    private formatPretty;
+    /**
+     * Write log entry to file
+     */
+    private writeToFile;
+    /**
+     * Initialize log file
+     */
+    private initializeLogFile;
+    /**
+     * Rotate log file
+     */
+    private rotateLogFile;
+    /**
+     * Clean up old log files
+     */
+    private cleanupOldLogFiles;
+}
+//# sourceMappingURL=LoggingService.d.ts.map

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

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