telegram-ssh-bot 2.0.0 → 2.2.0

package/dist/config/schema.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Configuration validation schema using Joi
+ */
+import Joi from "joi";
+export declare const configSchema: Joi.ObjectSchema<any>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/config/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,GAAG,MAAM,KAAK,CAAC;AAEtB,eAAO,MAAM,YAAY,uBAkDZ,CAAC"}

package/dist/config/schema.js

@@ -0,0 +1,50 @@
+/**
+ * Configuration validation schema using Joi
+ */
+import Joi from "joi";
+export const configSchema = Joi.object({
+    telegram: Joi.object({
+        token: Joi.string().required(),
+        chatId: Joi.string().required(),
+        ownerIds: Joi.array().items(Joi.string()).min(1).required(),
+        polling: Joi.boolean().default(true),
+    }).required(),
+    security: Joi.object({
+        encryptionKey: Joi.string().length(64).required(), // 32 bytes hex
+        rateLimit: Joi.object({
+            enabled: Joi.boolean().default(true),
+            windowMs: Joi.number().min(1000).max(3600000).default(60000),
+            maxRequests: Joi.number().min(1).max(1000).default(30),
+            skipFailedRequests: Joi.boolean().default(false),
+        }).required(),
+        allowedCommands: Joi.array().items(Joi.string()).optional(),
+        blockedCommands: Joi.array().items(Joi.string()).optional(),
+    }).required(),
+    ssh: Joi.object({
+        defaultPrivateKeyPath: Joi.string().required(),
+        defaultPort: Joi.number().min(1).max(65535).default(22),
+        connectionTimeout: Joi.number().min(1000).max(120000).default(30000),
+        keepaliveInterval: Joi.number().min(1000).max(60000).default(10000),
+        maxConnections: Joi.number().min(1).max(20).default(5),
+        commandTimeout: Joi.number().min(1000).max(300000).default(60000),
+    }).required(),
+    logging: Joi.object({
+        level: Joi.string().valid("debug", "info", "warn", "error").default("info"),
+        format: Joi.string().valid("json", "pretty").default("json"),
+        file: Joi.string().optional(),
+    }).required(),
+    storage: Joi.object({
+        serversFile: Joi.string().required(),
+        encryptionEnabled: Joi.boolean().default(true),
+    }).required(),
+    backup: Joi.object({
+        enabled: Joi.boolean().default(true),
+        intervalMs: Joi.number().min(60000).max(86400000).default(3600000),
+        maxCount: Joi.number().min(1).max(100).default(10),
+    }).required(),
+    monitoring: Joi.object({
+        enabled: Joi.boolean().default(true),
+        intervalMs: Joi.number().min(10000).max(3600000).default(300000),
+    }).required(),
+}).required();
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

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

package/dist/core/Bot.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Telegram Bot Core
+ * Provides bot lifecycle management and command routing
+ */
+import TelegramBot from "node-telegram-bot-api";
+import { LoggingService } from "../services/LoggingService.js";
+import type { IBot, ICommandHandler, IMiddleware, MessageOptions } from "../types/index.js";
+/**
+ * Bot configuration
+ */
+interface BotConfig {
+    token: string;
+    ownerIds: string[];
+    polling: boolean;
+    /** Optional custom API URL for Telegram Bot API proxies */
+    apiUrl?: string;
+}
+/**
+ * Telegram Bot implementation
+ */
+export declare class Bot implements IBot {
+    private readonly bot;
+    private readonly ownerIds;
+    private readonly logger;
+    private readonly commands;
+    private readonly middlewares;
+    private started;
+    constructor(config: BotConfig, logger: LoggingService);
+    /**
+     * Start the bot
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the bot
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a command handler
+     */
+    registerCommand(handler: ICommandHandler): void;
+    /**
+     * Add middleware
+     */
+    use(middleware: IMiddleware): void;
+    /**
+     * Send a message
+     */
+    sendMessage(chatId: number, message: string, options?: MessageOptions): Promise<void>;
+    /**
+     * Check if user is owner
+     */
+    isOwner(userId: number): boolean;
+    /**
+     * Get the underlying TelegramBot instance
+     */
+    getTelegramBot(): TelegramBot;
+    /**
+     * Setup message and command handlers
+     */
+    private setupHandlers;
+    /**
+     * Handle incoming message
+     */
+    private handleMessage;
+    /**
+     * Handle command message
+     */
+    private handleCommand;
+    /**
+     * Handle regular (non-command) message
+     */
+    private handleRegularMessage;
+    /**
+     * Execute middleware stack
+     */
+    private executeMiddleware;
+    /**
+     * Create message context from Telegram message
+     */
+    private createMessageContext;
+    /**
+     * Handle error and send user-friendly message
+     */
+    private handleError;
+    /**
+     * Set bot commands in Telegram
+     */
+    private setCommands;
+}
+export {};
+//# sourceMappingURL=Bot.d.ts.map

package/dist/core/Bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Bot.d.ts","sourceRoot":"","sources":["../../src/core/Bot.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,WAAW,MAAM,uBAAuB,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAGV,IAAI,EACJ,eAAe,EACf,WAAW,EAEX,cAAc,EACf,MAAM,mBAAmB,CAAC;AAE3B;;GAEG;AACH,UAAU,SAAS;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,2DAA2D;IAC3D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAQD;;GAEG;AACH,qBAAa,GAAI,YAAW,IAAI;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAc;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2C;IACpE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,cAAc;IAUrD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAa3B;;OAEG;IACH,eAAe,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI;IAK/C;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,WAAW,GAAG,IAAI;IAKlC;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,cAAc,IAAI,WAAW;IAI7B;;OAEG;IACH,OAAO,CAAC,aAAa;IAsBrB;;OAEG;YACW,aAAa;IAY3B;;OAEG;YACW,aAAa;IA8C3B;;OAEG;YACW,oBAAoB;IAsBlC;;OAEG;YACW,iBAAiB;IAyB/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;YACW,WAAW;IAsBzB;;OAEG;YACW,WAAW;CAiB1B"}

package/dist/core/Bot.js

@@ -0,0 +1,263 @@
+/**
+ * Telegram Bot Core
+ * Provides bot lifecycle management and command routing
+ */
+import TelegramBot from "node-telegram-bot-api";
+import { UnauthorizedError } from "../errors/index.js";
+/**
+ * Pre-compiled command regex pattern
+ * Matches: /command[@bot_username] [args]
+ */
+const COMMAND_REGEX = /^\/(\w+)(?:@\w+)?(?:\s+(.*))?$/;
+/**
+ * Telegram Bot implementation
+ */
+export class Bot {
+    bot;
+    ownerIds;
+    logger;
+    commands = new Map();
+    middlewares = [];
+    started = false;
+    constructor(config, logger) {
+        const options = { polling: config.polling };
+        if (config.apiUrl) {
+            options.baseApiUrl = config.apiUrl;
+        }
+        this.bot = new TelegramBot(config.token, options);
+        this.ownerIds = new Set(config.ownerIds);
+        this.logger = logger;
+    }
+    /**
+     * Start the bot
+     */
+    async start() {
+        if (this.started) {
+            return;
+        }
+        // Register command handlers
+        this.setupHandlers();
+        // Set bot commands
+        await this.setCommands();
+        this.started = true;
+        this.logger.info("Bot started");
+    }
+    /**
+     * Stop the bot
+     */
+    async stop() {
+        if (!this.started) {
+            return;
+        }
+        if (this.bot.isPolling()) {
+            await this.bot.stopPolling();
+        }
+        this.started = false;
+        this.logger.info("Bot stopped");
+    }
+    /**
+     * Register a command handler
+     */
+    registerCommand(handler) {
+        this.commands.set(handler.name, handler);
+        this.logger.debug("Command registered", { command: handler.name });
+    }
+    /**
+     * Add middleware
+     */
+    use(middleware) {
+        this.middlewares.push(middleware);
+        this.logger.debug("Middleware added");
+    }
+    /**
+     * Send a message
+     */
+    async sendMessage(chatId, message, options) {
+        const sendOptions = {};
+        if (options?.parseMode) {
+            sendOptions.parse_mode = options.parseMode;
+        }
+        if (options?.disableWebPagePreview) {
+            sendOptions.disable_web_page_preview = options.disableWebPagePreview;
+        }
+        if (options?.protectContent) {
+            sendOptions.protect_content = options.protectContent;
+        }
+        await this.bot.sendMessage(chatId, message, sendOptions);
+    }
+    /**
+     * Check if user is owner
+     */
+    isOwner(userId) {
+        return this.ownerIds.has(String(userId));
+    }
+    /**
+     * Get the underlying TelegramBot instance
+     */
+    getTelegramBot() {
+        return this.bot;
+    }
+    /**
+     * Setup message and command handlers
+     */
+    setupHandlers() {
+        // Handle all messages
+        this.bot.on("message", async (msg) => {
+            try {
+                await this.handleMessage(msg);
+            }
+            catch (error) {
+                this.logger.error("Error handling message", error instanceof Error ? error : new Error(String(error)), {
+                    chatId: msg.chat.id,
+                });
+            }
+        });
+        // Handle polling errors
+        this.bot.on("polling_error", (error) => {
+            this.logger.error("Polling error", error);
+        });
+    }
+    /**
+     * Handle incoming message
+     */
+    async handleMessage(msg) {
+        const context = this.createMessageContext(msg);
+        // Check if it's a command
+        if (msg.text?.startsWith("/")) {
+            await this.handleCommand(msg, context);
+        }
+        else {
+            // Handle as regular message (SSH command if connected)
+            await this.handleRegularMessage(msg, context);
+        }
+    }
+    /**
+     * Handle command message
+     */
+    async handleCommand(msg, context) {
+        const text = msg.text;
+        if (!text) {
+            return;
+        }
+        // Parse command using pre-compiled regex
+        const match = text.match(COMMAND_REGEX);
+        if (!match) {
+            return;
+        }
+        const commandName = match[1] ?? "";
+        const args = match[2] ?? "";
+        // Find handler
+        const handler = this.commands.get(commandName);
+        if (!handler) {
+            await this.sendMessage(context.chatId, `Unknown command: /${commandName}`);
+            return;
+        }
+        // Create command context
+        const commandContext = {
+            ...context,
+            command: commandName,
+            args,
+            match,
+        };
+        // Execute middleware stack
+        try {
+            await this.executeMiddleware(commandContext, async () => {
+                await handler.execute(commandContext);
+            });
+        }
+        catch (error) {
+            await this.handleError(context.chatId, error);
+        }
+    }
+    /**
+     * Handle regular (non-command) message
+     */
+    async handleRegularMessage(msg, context) {
+        // Find a default handler for regular messages
+        const defaultHandler = this.commands.get("_message");
+        if (defaultHandler) {
+            try {
+                await this.executeMiddleware(context, async () => {
+                    await defaultHandler.execute({
+                        ...context,
+                        command: "_message",
+                        args: msg.text ?? "",
+                        match: [],
+                    });
+                });
+            }
+            catch (error) {
+                await this.handleError(context.chatId, error);
+            }
+        }
+    }
+    /**
+     * Execute middleware stack
+     */
+    async executeMiddleware(context, final) {
+        let index = 0;
+        const next = async () => {
+            if (index < this.middlewares.length) {
+                const middleware = this.middlewares[index];
+                if (middleware) {
+                    index++;
+                    await middleware.execute({
+                        ...context,
+                        next,
+                        state: {},
+                    });
+                }
+            }
+            else {
+                await final();
+            }
+        };
+        await next();
+    }
+    /**
+     * Create message context from Telegram message
+     */
+    createMessageContext(msg) {
+        return {
+            message: msg,
+            chatId: msg.chat.id,
+            userId: msg.from?.id ?? 0,
+            text: msg.text,
+            isOwner: this.isOwner(msg.from?.id ?? 0),
+            timestamp: new Date(),
+        };
+    }
+    /**
+     * Handle error and send user-friendly message
+     */
+    async handleError(chatId, error) {
+        if (error instanceof UnauthorizedError) {
+            await this.sendMessage(chatId, "⛔ Unauthorized: You are not allowed to use this bot.");
+            return;
+        }
+        const message = error instanceof Error ? error.message : "An unexpected error occurred";
+        await this.sendMessage(chatId, `❌ Error: ${message}`);
+        this.logger.error("Command error", error instanceof Error ? error : new Error(String(error)), {
+            chatId,
+        });
+    }
+    /**
+     * Set bot commands in Telegram
+     */
+    async setCommands() {
+        const commands = [];
+        for (const [, handler] of this.commands) {
+            if (handler.name !== "_message") {
+                commands.push({
+                    command: handler.name,
+                    description: handler.description,
+                });
+            }
+        }
+        if (commands.length > 0) {
+            await this.bot.setMyCommands(commands);
+            this.logger.debug("Bot commands set", { count: commands.length });
+        }
+    }
+}
+//# sourceMappingURL=Bot.js.map

package/dist/core/Bot.js.map

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

package/dist/core/ConnectionPool.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Connection Pool
+ * Manages multiple SSH connections with pooling, timeout, and health monitoring
+ */
+import { EventEmitter } from "events";
+import { LoggingService } from "../services/LoggingService.js";
+import type { CommandResult, SSHConnectionConfig } from "../types/index.js";
+import { SSHClient } from "./SSHClient.js";
+/**
+ * Pooled connection wrapper
+ */
+interface PooledConnection {
+    id: string;
+    serverId: string;
+    client: SSHClient;
+    createdAt: Date;
+    lastUsedAt: Date;
+    inUse: boolean;
+    healthCheckFailures: number;
+}
+/**
+ * Connection pool options
+ */
+export interface ConnectionPoolOptions {
+    maxConnections: number;
+    connectionTimeout: number;
+    commandTimeout: number;
+    idleTimeout: number;
+    healthCheckInterval: number;
+    maxHealthCheckFailures: number;
+}
+/**
+ * Pool statistics
+ */
+export interface PoolStats {
+    totalConnections: number;
+    activeConnections: number;
+    idleConnections: number;
+    waitingRequests: number;
+    totalRequestsServed: number;
+}
+/**
+ * Connection pool for managing multiple SSH connections
+ */
+export declare class ConnectionPool extends EventEmitter {
+    private readonly connections;
+    private readonly waitingQueue;
+    private readonly options;
+    private readonly logger;
+    private healthCheckTimer;
+    private idleCheckTimer;
+    private totalRequestsServed;
+    private isDraining;
+    constructor(options: Partial<ConnectionPoolOptions>, logger: LoggingService);
+    /**
+     * Initialize the connection pool
+     */
+    initialize(): Promise<void>;
+    /**
+     * Acquire a connection from the pool
+     */
+    acquire(serverId: string, config: SSHConnectionConfig): Promise<PooledConnection>;
+    /**
+     * Release a connection back to the pool
+     */
+    release(connection: PooledConnection): void;
+    /**
+     * Remove a connection from the pool
+     */
+    remove(connectionId: string): Promise<void>;
+    /**
+     * Drain all connections and shutdown pool
+     */
+    drain(): Promise<void>;
+    /**
+     * Get pool statistics
+     */
+    getStats(): PoolStats;
+    /**
+     * Get active connection count
+     */
+    getActiveCount(): number;
+    /**
+     * Execute a command on a pooled connection
+     */
+    executeCommand(serverId: string, config: SSHConnectionConfig, command: string): Promise<CommandResult>;
+    /**
+     * Find an idle connection for the given server
+     */
+    private findIdleConnection;
+    /**
+     * Create a new connection
+     */
+    private createConnection;
+    /**
+     * Wait for a connection to become available
+     */
+    private waitForConnection;
+    /**
+     * Process waiting queue when connections become available
+     */
+    private processWaitingQueue;
+    /**
+     * Start health check timer
+     */
+    private startHealthCheck;
+    /**
+     * Perform health check on all connections
+     */
+    private performHealthCheck;
+    /**
+     * Start idle connection check timer
+     */
+    private startIdleCheck;
+    /**
+     * Remove idle connections that have exceeded idle timeout
+     */
+    private removeIdleConnections;
+    /**
+     * Generate unique connection ID
+     */
+    private generateConnectionId;
+}
+export {};
+//# sourceMappingURL=ConnectionPool.d.ts.map

package/dist/core/ConnectionPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConnectionPool.d.ts","sourceRoot":"","sources":["../../src/core/ConnectionPool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAMtC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;GAEG;AACH,UAAU,gBAAgB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAcD;;GAEG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;IACxE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,gBAAgB,CAA+B;IACvD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,UAAU,CAAS;gBAEf,OAAO,EAAE,OAAO,CAAC,qBAAqB,CAAC,EAAE,MAAM,EAAE,cAAc;IAa3E;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAQjC;;OAEG;IACG,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,gBAAgB,CAAC;IA2B5B;;OAEG;IACH,OAAO,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAkB3C;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBjD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC5B;;OAEG;IACH,QAAQ,IAAI,SAAS;IAqBrB;;OAEG;IACH,cAAc,IAAI,MAAM;IAUxB;;OAEG;IACG,cAAc,CAClB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,aAAa,CAAC;IAWzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;YACW,gBAAgB;IA+C9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiEzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAkC3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAMxB;;OAEG;YACW,kBAAkB;IAiChC;;OAEG;IACH,OAAO,CAAC,cAAc;IAMtB;;OAEG;YACW,qBAAqB;IAoBnC;;OAEG;IACH,OAAO,CAAC,oBAAoB;CAG7B"}