@milaboratories/pl-deployments 2.15.17 → 2.15.19

package/dist/ssh/ssh.cjs

@@ -1,627 +1,563 @@
-'use strict';
-
-var ssh = require('ssh2');
-var net = require('node:net');
-var dns = require('node:dns');
-var fs = require('node:fs');
-var fsp = require('node:fs/promises');
-var upath = require('upath');
-var tsHelpers = require('@milaboratories/ts-helpers');
-var node_crypto = require('node:crypto');
-var ssh_errors = require('./ssh_errors.cjs');
+const require_runtime = require('../_virtual/_rolldown/runtime.cjs');
+const require_ssh_errors = require('./ssh_errors.cjs');
+let _milaboratories_ts_helpers = require("@milaboratories/ts-helpers");
+let node_fs = require("node:fs");
+node_fs = require_runtime.__toESM(node_fs);
+let node_fs_promises = require("node:fs/promises");
+let upath = require("upath");
+upath = require_runtime.__toESM(upath);
+let ssh2 = require("ssh2");
+ssh2 = require_runtime.__toESM(ssh2);
+let node_net = require("node:net");
+node_net = require_runtime.__toESM(node_net);
+let node_dns = require("node:dns");
+node_dns = require_runtime.__toESM(node_dns);
+let node_crypto = require("node:crypto");
 
+//#region src/ssh/ssh.ts
 const defaultConfig = {
-    keepaliveInterval: 60000,
-    keepaliveCountMax: 10,
+	keepaliveInterval: 6e4,
+	keepaliveCountMax: 10
+};
+var SshClient = class SshClient {
+	config;
+	homeDir;
+	forwardedServers = [];
+	constructor(logger, client) {
+		this.logger = logger;
+		this.client = client;
+	}
+	/**
+	* Initializes the SshClient and establishes a connection using the provided configuration.
+	* @param config - The connection configuration object for the SSH client.
+	* @returns A new instance of SshClient with an active connection.
+	*/
+	static async init(logger, config) {
+		const withDefaults = {
+			...defaultConfig,
+			...config
+		};
+		const client = new SshClient(logger, new ssh2.Client());
+		await client.connect(withDefaults);
+		return client;
+	}
+	getForwardedServers() {
+		return this.forwardedServers;
+	}
+	getFullHostName() {
+		return `${this.config?.host}:${this.config?.port}`;
+	}
+	getUserName() {
+		return this.config?.username;
+	}
+	/**
+	* Connects to the SSH server using the specified configuration.
+	* @param config - The connection configuration object for the SSH client.
+	* @returns A promise that resolves when the connection is established or rejects on error.
+	*/
+	async connect(config) {
+		this.config = config;
+		return await connect(this.client, config, () => {}, () => {});
+	}
+	/**
+	* Executes a command on the SSH server.
+	* @param command - The command to execute on the remote server.
+	* @returns A promise resolving with the command's stdout and stderr outputs.
+	*/
+	async exec(command) {
+		return new Promise((resolve, reject) => {
+			this.client.exec(command, (err, stream) => {
+				if (err) return reject(/* @__PURE__ */ new Error(`ssh.exec: ${command}: ${err}`));
+				let stdout = "";
+				let stderr = "";
+				stream.on("close", (code) => {
+					if (code === 0) resolve({
+						stdout,
+						stderr
+					});
+					else reject(/* @__PURE__ */ new Error(`Command ${command} exited with code ${code}, stdout: ${stdout}, stderr: ${stderr}`));
+				}).on("data", (data) => {
+					stdout += data.toString();
+				}).stderr.on("data", (data) => {
+					stderr += data.toString();
+				});
+			});
+		});
+	}
+	/**
+	* Retrieves the supported authentication methods for a given host and port.
+	* @param host - The hostname or IP address of the server.
+	* @param port - The port number to connect to on the server.
+	* @returns 'publickey' | 'password'[] A promise resolving with a list of supported authentication methods.
+	*/
+	static async getAuthTypes(host, port) {
+		return new Promise((resolve) => {
+			let stdout = "";
+			const conn = new ssh2.Client();
+			conn.on("ready", () => {
+				conn.end();
+				const types = this.extractAuthMethods(stdout);
+				resolve(types.length === 0 ? ["publickey", "password"] : types);
+			});
+			conn.on("error", () => {
+				conn.end();
+				resolve(["publickey", "password"]);
+			});
+			conn.connect({
+				host,
+				port,
+				username: (/* @__PURE__ */ new Date()).getTime().toString(),
+				debug: (err) => {
+					stdout += `${err}\n`;
+				}
+			});
+		});
+	}
+	/**
+	* Extracts authentication methods from debug logs.
+	* @param log - The debug log output containing authentication information.
+	* @returns An array of extracted authentication methods.
+	*/
+	static extractAuthMethods(log) {
+		const match = log.match(/Inbound: Received USERAUTH_FAILURE \((.+)\)/);
+		return match && match[1] ? match[1].split(",").map((method) => method.trim()) : [];
+	}
+	/**
+	* Sets up port forwarding between a remote port on the SSH server and a local port.
+	* A new connection is used for this operation instead of an existing one.
+	* @param ports - An object specifying the remote and local port configuration.
+	* @param config - Optional connection configuration for the SSH client.
+	* @returns { server: net.Server } A promise resolving with the created server instance.
+	*/
+	async forwardPort(ports, config) {
+		const log = `ssh.forward:${ports.localPort}:${ports.remotePort}.id_${(0, node_crypto.randomBytes)(1).toString("hex")}`;
+		config = config ?? this.config;
+		const persistentClient = new _milaboratories_ts_helpers.RetryablePromise((p) => {
+			return new Promise((resolve, reject) => {
+				const client = new ssh2.Client();
+				client.on("ready", () => {
+					this.logger.info(`${log}.client.ready`);
+					resolve(client);
+				});
+				client.on("error", (err) => {
+					this.logger.info(`${log}.client.error: ${err}`);
+					p.reset();
+					reject(err);
+				});
+				client.on("close", () => {
+					this.logger.info(`${log}.client.closed`);
+					p.reset();
+				});
+				client.connect(config);
+			});
+		});
+		await persistentClient.ensure();
+		return new Promise((resolve, reject) => {
+			const server = node_net.default.createServer({ pauseOnConnect: true }, async (localSocket) => {
+				const sockLog = `${log}.sock_${(0, node_crypto.randomBytes)(1).toString("hex")}`;
+				let conn;
+				try {
+					conn = await persistentClient.ensure();
+				} catch (e) {
+					this.logger.info(`${sockLog}.persistentClient.catch: ${e}`);
+					localSocket.end();
+					return;
+				}
+				conn.setNoDelay(true);
+				localSocket.setNoDelay(true);
+				let stream;
+				try {
+					stream = await forwardOut(this.logger, conn, "127.0.0.1", 0, "127.0.0.1", ports.remotePort);
+				} catch (e) {
+					this.logger.error(`${sockLog}.forwardOut.err: ${e}`);
+					localSocket.end();
+					return;
+				}
+				localSocket.pipe(stream);
+				stream.pipe(localSocket);
+				localSocket.resume();
+				stream.on("error", (err) => {
+					this.logger.error(`${sockLog}.stream.error: ${err}`);
+					localSocket.end();
+					stream.end();
+				});
+				stream.on("close", () => {
+					localSocket.end();
+					stream.end();
+				});
+				localSocket.on("close", () => {
+					this.logger.info(`${sockLog}.localSocket: closed`);
+					localSocket.end();
+					stream.end();
+				});
+			});
+			server.listen(ports.localPort, "127.0.0.1", () => {
+				this.logger.info(`${log}.server: started listening`);
+				this.forwardedServers.push(server);
+				resolve({ server });
+			});
+			server.on("error", (err) => {
+				server.close();
+				reject(/* @__PURE__ */ new Error(`${log}.server: error: ${JSON.stringify(err)}`));
+			});
+			server.on("close", () => {
+				this.logger.info(`${log}.server: closed ${JSON.stringify(ports)}`);
+				this.forwardedServers = this.forwardedServers.filter((s) => s !== server);
+			});
+		});
+	}
+	closeForwardedPorts() {
+		this.logger.info("[SSH] Closing all forwarded ports...");
+		this.forwardedServers.forEach((server) => {
+			const rawAddress = server.address();
+			if (rawAddress && typeof rawAddress !== "string") {
+				const address = rawAddress;
+				this.logger.info(`[SSH] Closing port forward for server ${address.address}:${address.port}`);
+			}
+			server.close();
+		});
+		this.forwardedServers = [];
+	}
+	/**
+	* Checks if a specified host is available by performing a DNS lookup.
+	* @param hostname - The hostname or IP address to check.
+	* @returns A promise resolving with `true` if the host is reachable, otherwise `false`.
+	*/
+	static async checkHostAvailability(hostname) {
+		return new Promise((resolve) => {
+			node_dns.default.lookup(hostname, (err) => {
+				resolve(!err);
+			});
+		});
+	}
+	/**
+	* Determines whether a private key requires a passphrase for use.
+	* @param privateKey - The private key content to check.
+	* @returns A promise resolving with `true` if a passphrase is required, otherwise `false`.
+	*/
+	static async isPassphraseRequiredForKey(privateKey) {
+		return new Promise((resolve, reject) => {
+			try {
+				if (ssh2.default.utils.parseKey(privateKey) instanceof Error) resolve(true);
+				return resolve(false);
+			} catch (err) {
+				console.log("Error parsing privateKey");
+				reject(/* @__PURE__ */ new Error(`ssh.isPassphraseRequiredForKey: err ${err}`));
+			}
+		});
+	}
+	/**
+	* Uploads a local file to a remote server via SFTP.
+	* This function creates new SFTP connection
+	* @param localPath - The local file path.
+	* @param remotePath - The remote file path on the server.
+	* @returns A promise resolving with `true` if the file was successfully uploaded.
+	*/
+	async uploadFile(localPath, remotePath) {
+		return await (0, _milaboratories_ts_helpers.retry)(async () => {
+			return await this.withSftp(async (sftp) => {
+				return new Promise((resolve, reject) => {
+					sftp.fastPut(localPath, remotePath, (err) => {
+						if (err) return reject(new require_ssh_errors.SFTPUploadError(err, localPath, remotePath));
+						resolve(true);
+					});
+				});
+			});
+		}, _milaboratories_ts_helpers.Retry3TimesWithDelay, (e) => require_ssh_errors.SFTPError.from(e)?.isGenericFailure ?? false);
+	}
+	async withSftp(callback) {
+		return new Promise((resolve, reject) => {
+			this.client.sftp((err, sftp) => {
+				if (err) return reject(new Error(`ssh.withSftp: sftp err: ${err}`, { cause: err }));
+				callback(sftp).then(resolve).catch((err) => {
+					reject(new Error(`ssh.withSftp.callback: err ${err}`, { cause: err }));
+				}).finally(() => {
+					sftp?.end();
+				});
+			});
+		});
+	}
+	async writeFileOnTheServer(remotePath, data, mode = 432) {
+		return this.withSftp(async (sftp) => {
+			return this.writeFile(sftp, remotePath, data, mode);
+		});
+	}
+	async getForderStructure(sftp, remotePath, data = {
+		files: [],
+		directories: []
+	}) {
+		return new Promise((resolve, reject) => {
+			sftp.readdir(remotePath, async (err, items) => {
+				if (err) return reject(err);
+				for (const item of items) {
+					const itemPath = `${remotePath}/${item.filename}`;
+					if (item.attrs.isDirectory()) {
+						data.directories.push(itemPath);
+						try {
+							await this.getForderStructure(sftp, itemPath, data);
+						} catch (error) {
+							return reject(error instanceof Error ? error : new Error(String(error)));
+						}
+					} else data.files.push(itemPath);
+				}
+				resolve(data);
+			});
+		});
+	}
+	rmdir(sftp, path) {
+		return new Promise((resolve, reject) => {
+			sftp.rmdir(path, (err) => err ? reject(err) : resolve(true));
+		});
+	}
+	unlink(sftp, path) {
+		return new Promise((resolve, reject) => {
+			sftp.unlink(path, (err) => err ? reject(err) : resolve(true));
+		});
+	}
+	async deleteFolder(path) {
+		return this.withSftp(async (sftp) => {
+			try {
+				const list = await this.getForderStructure(sftp, path);
+				this.logger.info(`ssh.deleteFolder list of files and directories`);
+				this.logger.info(`ssh.deleteFolder list of files: ${list.files}`);
+				this.logger.info(`ssh.deleteFolder list of directories: ${list.directories}`);
+				for (const filePath of list.files) {
+					this.logger.info(`ssh.deleteFolder unlink file ${filePath}`);
+					await this.unlink(sftp, filePath);
+				}
+				list.directories.sort((a, b) => b.length - a.length);
+				for (const directoryPath of list.directories) {
+					this.logger.info(`ssh.deleteFolder rmdir  ${directoryPath}`);
+					await this.rmdir(sftp, directoryPath);
+				}
+				await this.rmdir(sftp, path);
+				return true;
+			} catch (e) {
+				this.logger.error(e);
+				const message = e instanceof Error ? e.message : "";
+				throw new Error(`ssh.deleteFolder: path: ${path}, message: ${message}`);
+			}
+		});
+	}
+	async readFile(remotePath) {
+		return this.withSftp(async (sftp) => {
+			return new Promise((resolve, reject) => {
+				sftp.readFile(remotePath, (err, buffer) => {
+					if (err) return reject(/* @__PURE__ */ new Error(`ssh.readFile: ${err}`));
+					resolve(buffer.toString());
+				});
+			});
+		});
+	}
+	async chmod(path, mode) {
+		return this.withSftp(async (sftp) => {
+			return new Promise((resolve, reject) => {
+				sftp.chmod(path, mode, (err) => {
+					if (err) return reject(/* @__PURE__ */ new Error(`ssh.chmod: ${err}, path: ${path}, mode: ${mode}`));
+					return resolve(void 0);
+				});
+			});
+		});
+	}
+	async checkFileExists(remotePath) {
+		return this.withSftp(async (sftp) => {
+			return new Promise((resolve, reject) => {
+				sftp.stat(remotePath, (err, stats) => {
+					if (err) {
+						if (err?.code === 2) return resolve(false);
+						return reject(/* @__PURE__ */ new Error(`ssh.checkFileExists: err ${err}`));
+					}
+					resolve(stats.isFile());
+				});
+			});
+		});
+	}
+	async checkPathExists(remotePath) {
+		return this.withSftp(async (sftp) => {
+			return new Promise((resolve, reject) => {
+				sftp.stat(remotePath, (err, stats) => {
+					if (err) {
+						if (err.code === 2) return resolve({
+							exists: false,
+							isFile: false,
+							isDirectory: false
+						});
+						return reject(/* @__PURE__ */ new Error(`ssh.checkPathExists: ${err}`));
+					}
+					resolve({
+						exists: true,
+						isFile: stats.isFile(),
+						isDirectory: stats.isDirectory()
+					});
+				});
+			});
+		});
+	}
+	async writeFile(sftp, remotePath, data, mode = 432) {
+		return new Promise((resolve, reject) => {
+			sftp.writeFile(remotePath, data, { mode }, (err) => {
+				if (err) return reject(/* @__PURE__ */ new Error(`ssh.writeFile: err ${err}, remotePath: ${remotePath}`));
+				resolve(true);
+			});
+		});
+	}
+	uploadFileUsingExistingSftp(sftp, localPath, remotePath, mode = 432) {
+		return new Promise((resolve, reject) => {
+			(0, node_fs_promises.readFile)(localPath).then(async (result) => {
+				return this.writeFile(sftp, remotePath, result, mode).then(() => {
+					resolve(void 0);
+				}).catch((err) => {
+					const msg = `uploadFileUsingExistingSftp: ${err}`;
+					this.logger.error(msg);
+					reject(new Error(msg));
+				});
+			});
+		});
+	}
+	async __uploadDirectory(sftp, localDir, remoteDir, mode = 432) {
+		return new Promise((resolve, reject) => {
+			node_fs.default.readdir(localDir, async (err, files) => {
+				if (err) return reject(/* @__PURE__ */ new Error(`ssh.__uploadDir: err ${err}, localDir: ${localDir}, remoteDir: ${remoteDir}`));
+				try {
+					await this.__createRemoteDirectory(sftp, remoteDir);
+					for (const file of files) {
+						const localPath = upath.default.join(localDir, file);
+						const remotePath = `${remoteDir}/${file}`;
+						if (node_fs.default.lstatSync(localPath).isDirectory()) await this.__uploadDirectory(sftp, localPath, remotePath, mode);
+						else await this.uploadFileUsingExistingSftp(sftp, localPath, remotePath, mode);
+					}
+					resolve();
+				} catch (err) {
+					const msg = `ssh.__uploadDir: catched err ${err}`;
+					this.logger.error(msg);
+					reject(new Error(msg));
+				}
+			});
+		});
+	}
+	/**
+	* Uploads a local directory and its contents (including subdirectories) to the remote server via SFTP.
+	* @param localDir - The path to the local directory to upload.
+	* @param remoteDir - The path to the remote directory on the server.
+	* @returns A promise that resolves when the directory and its contents are uploaded.
+	*/
+	async uploadDirectory(localDir, remoteDir, mode = 432) {
+		return new Promise((resolve, reject) => {
+			this.withSftp(async (sftp) => {
+				try {
+					await this.__uploadDirectory(sftp, localDir, remoteDir, mode);
+					resolve();
+				} catch (e) {
+					reject(/* @__PURE__ */ new Error(`ssh.uploadDirectory: ${e}`));
+				}
+			});
+		});
+	}
+	/**
+	* Ensures that a remote directory and all its parent directories exist.
+	* @param sftp - The SFTP wrapper.
+	* @param remotePath - The path to the remote directory.
+	* @returns A promise that resolves when the directory is created.
+	*/
+	__createRemoteDirectory(sftp, remotePath) {
+		return new Promise((resolve, reject) => {
+			const directories = remotePath.split("/");
+			let currentPath = "";
+			const createNext = (index) => {
+				if (index >= directories.length) return resolve();
+				currentPath += `${directories[index]}/`;
+				sftp.stat(currentPath, (err) => {
+					if (err) sftp.mkdir(currentPath, (err) => {
+						if (err) return reject(/* @__PURE__ */ new Error(`ssh.__createRemDir: err ${err}, remotePath: ${remotePath}`));
+						createNext(index + 1);
+					});
+					else createNext(index + 1);
+				});
+			};
+			createNext(0);
+		});
+	}
+	/**
+	* Ensures that a remote directory and all its parent directories exist.
+	* @param sftp - The SFTP wrapper.
+	* @param remotePath - The path to the remote directory.
+	* @returns A promise that resolves when the directory is created.
+	*/
+	ensureRemoteDirCreated(remotePath, mode = 493) {
+		return this.withSftp(async (sftp) => {
+			const directories = remotePath.split("/");
+			let currentPath = "";
+			for (const directory of directories) {
+				currentPath += `${directory}/`;
+				try {
+					await new Promise((resolve, reject) => {
+						sftp.stat(currentPath, (err) => {
+							if (!err) return resolve();
+							sftp.mkdir(currentPath, { mode }, (err) => {
+								if (err) return reject(/* @__PURE__ */ new Error(`ssh.createRemoteDir: err ${err}, remotePath: ${remotePath}`));
+								resolve();
+							});
+						});
+					});
+				} catch (error) {
+					console.error(`Failed to create directory: ${currentPath}`, error);
+					throw error;
+				}
+			}
+		});
+	}
+	/**
+	* Downloads a file from the remote server to a local path via SFTP.
+	* @param remotePath - The remote file path on the server.
+	* @param localPath - The local file path to save the file.
+	* @returns A promise resolving with `true` if the file was successfully downloaded.
+	*/
+	async downloadFile(remotePath, localPath) {
+		return this.withSftp(async (sftp) => {
+			return new Promise((resolve, reject) => {
+				sftp.fastGet(remotePath, localPath, (err) => {
+					if (err) return reject(/* @__PURE__ */ new Error(`ssh.downloadFile: err ${err}, remotePath: ${remotePath}, localPath: ${localPath}`));
+					resolve(true);
+				});
+			});
+		});
+	}
+	/**
+	* Closes the SSH client connection and forwarded ports.
+	*/
+	close() {
+		this.closeForwardedPorts();
+		this.client.end();
+	}
 };
-class SshClient {
-    logger;
-    client;
-    config;
-    homeDir;
-    forwardedServers = [];
-    constructor(logger, client) {
-        this.logger = logger;
-        this.client = client;
-    }
-    /**
-     * Initializes the SshClient and establishes a connection using the provided configuration.
-     * @param config - The connection configuration object for the SSH client.
-     * @returns A new instance of SshClient with an active connection.
-     */
-    static async init(logger, config) {
-        const withDefaults = {
-            ...defaultConfig,
-            ...config,
-        };
-        const client = new SshClient(logger, new ssh.Client());
-        await client.connect(withDefaults);
-        return client;
-    }
-    getForwardedServers() {
-        return this.forwardedServers;
-    }
-    getFullHostName() {
-        return `${this.config?.host}:${this.config?.port}`;
-    }
-    getUserName() {
-        return this.config?.username;
-    }
-    /**
-     * Connects to the SSH server using the specified configuration.
-     * @param config - The connection configuration object for the SSH client.
-     * @returns A promise that resolves when the connection is established or rejects on error.
-     */
-    async connect(config) {
-        this.config = config;
-        return await connect(this.client, config);
-    }
-    /**
-     * Executes a command on the SSH server.
-     * @param command - The command to execute on the remote server.
-     * @returns A promise resolving with the command's stdout and stderr outputs.
-     */
-    async exec(command) {
-        return new Promise((resolve, reject) => {
-            this.client.exec(command, (err, stream) => {
-                if (err) {
-                    return reject(new Error(`ssh.exec: ${command}: ${err}`));
-                }
-                let stdout = "";
-                let stderr = "";
-                stream
-                    .on("close", (code) => {
-                    if (code === 0) {
-                        resolve({ stdout, stderr });
-                    }
-                    else {
-                        reject(new Error(`Command ${command} exited with code ${code}, stdout: ${stdout}, stderr: ${stderr}`));
-                    }
-                })
-                    .on("data", (data) => {
-                    stdout += data.toString();
-                })
-                    .stderr.on("data", (data) => {
-                    stderr += data.toString();
-                });
-            });
-        });
-    }
-    /**
-     * Retrieves the supported authentication methods for a given host and port.
-     * @param host - The hostname or IP address of the server.
-     * @param port - The port number to connect to on the server.
-     * @returns 'publickey' | 'password'[] A promise resolving with a list of supported authentication methods.
-     */
-    static async getAuthTypes(host, port) {
-        return new Promise((resolve) => {
-            let stdout = "";
-            const conn = new ssh.Client();
-            conn.on("ready", () => {
-                conn.end();
-                const types = this.extractAuthMethods(stdout);
-                resolve(types.length === 0 ? ["publickey", "password"] : types);
-            });
-            conn.on("error", () => {
-                conn.end();
-                resolve(["publickey", "password"]);
-            });
-            conn.connect({
-                host,
-                port,
-                username: new Date().getTime().toString(),
-                debug: (err) => {
-                    stdout += `${err}\n`;
-                },
-            });
-        });
-    }
-    /**
-     * Extracts authentication methods from debug logs.
-     * @param log - The debug log output containing authentication information.
-     * @returns An array of extracted authentication methods.
-     */
-    static extractAuthMethods(log) {
-        const match = log.match(/Inbound: Received USERAUTH_FAILURE \((.+)\)/);
-        return match && match[1] ? match[1].split(",").map((method) => method.trim()) : [];
-    }
-    /**
-     * Sets up port forwarding between a remote port on the SSH server and a local port.
-     * A new connection is used for this operation instead of an existing one.
-     * @param ports - An object specifying the remote and local port configuration.
-     * @param config - Optional connection configuration for the SSH client.
-     * @returns { server: net.Server } A promise resolving with the created server instance.
-     */
-    async forwardPort(ports, config) {
-        const log = `ssh.forward:${ports.localPort}:${ports.remotePort}.id_${node_crypto.randomBytes(1).toString("hex")}`;
-        config = config ?? this.config;
-        // we make this thing persistent so that if the connection
-        // drops (it happened in the past because of lots of errors and forwardOut opened channels),
-        // we'll recreate it here.
-        const persistentClient = new tsHelpers.RetryablePromise((p) => {
-            return new Promise((resolve, reject) => {
-                const client = new ssh.Client();
-                client.on("ready", () => {
-                    this.logger.info(`${log}.client.ready`);
-                    resolve(client);
-                });
-                client.on("error", (err) => {
-                    this.logger.info(`${log}.client.error: ${err}`);
-                    p.reset();
-                    reject(err);
-                });
-                client.on("close", () => {
-                    this.logger.info(`${log}.client.closed`);
-                    p.reset();
-                });
-                client.connect(config);
-            });
-        });
-        await persistentClient.ensure(); // warm up a connection
-        return new Promise((resolve, reject) => {
-            const server = net.createServer({ pauseOnConnect: true }, async (localSocket) => {
-                const sockLog = `${log}.sock_${node_crypto.randomBytes(1).toString("hex")}`;
-                // this.logger.info(`${sockLog}.localSocket: start connection`);
-                let conn;
-                try {
-                    conn = await persistentClient.ensure();
-                }
-                catch (e) {
-                    this.logger.info(`${sockLog}.persistentClient.catch: ${e}`);
-                    localSocket.end();
-                    return;
-                }
-                // Remove TCP buffering.
-                // Although it means less throughput (bad), it also less latency (good).
-                // It could help when we have
-                // small messages like in our grpc transactions.
-                // And it also could help when we have tcp forwarding to not buffer messages in the middle.
-                conn.setNoDelay(true);
-                localSocket.setNoDelay(true);
-                let stream;
-                try {
-                    stream = await forwardOut(this.logger, conn, "127.0.0.1", 0, "127.0.0.1", ports.remotePort);
-                }
-                catch (e) {
-                    this.logger.error(`${sockLog}.forwardOut.err: ${e}`);
-                    localSocket.end();
-                    return;
-                }
-                localSocket.pipe(stream);
-                stream.pipe(localSocket);
-                localSocket.resume();
-                // this.logger.info(`${sockLog}.forwardOut: connected`);
-                stream.on("error", (err) => {
-                    this.logger.error(`${sockLog}.stream.error: ${err}`);
-                    localSocket.end();
-                    stream.end();
-                });
-                stream.on("close", () => {
-                    // this.logger.info(`${sockLog}.stream.close: closed`);
-                    localSocket.end();
-                    stream.end();
-                });
-                localSocket.on("close", () => {
-                    this.logger.info(`${sockLog}.localSocket: closed`);
-                    localSocket.end();
-                    stream.end();
-                });
-            });
-            server.listen(ports.localPort, "127.0.0.1", () => {
-                this.logger.info(`${log}.server: started listening`);
-                this.forwardedServers.push(server);
-                resolve({ server });
-            });
-            server.on("error", (err) => {
-                server.close();
-                reject(new Error(`${log}.server: error: ${JSON.stringify(err)}`));
-            });
-            server.on("close", () => {
-                this.logger.info(`${log}.server: closed ${JSON.stringify(ports)}`);
-                this.forwardedServers = this.forwardedServers.filter((s) => s !== server);
-            });
-        });
-    }
-    closeForwardedPorts() {
-        this.logger.info("[SSH] Closing all forwarded ports...");
-        this.forwardedServers.forEach((server) => {
-            const rawAddress = server.address();
-            if (rawAddress && typeof rawAddress !== "string") {
-                const address = rawAddress;
-                this.logger.info(`[SSH] Closing port forward for server ${address.address}:${address.port}`);
-            }
-            server.close();
-        });
-        this.forwardedServers = [];
-    }
-    /**
-     * Checks if a specified host is available by performing a DNS lookup.
-     * @param hostname - The hostname or IP address to check.
-     * @returns A promise resolving with `true` if the host is reachable, otherwise `false`.
-     */
-    static async checkHostAvailability(hostname) {
-        return new Promise((resolve) => {
-            dns.lookup(hostname, (err) => {
-                resolve(!err);
-            });
-        });
-    }
-    /**
-     * Determines whether a private key requires a passphrase for use.
-     * @param privateKey - The private key content to check.
-     * @returns A promise resolving with `true` if a passphrase is required, otherwise `false`.
-     */
-    static async isPassphraseRequiredForKey(privateKey) {
-        return new Promise((resolve, reject) => {
-            try {
-                const keyOrError = ssh.utils.parseKey(privateKey);
-                if (keyOrError instanceof Error) {
-                    resolve(true);
-                }
-                return resolve(false);
-            }
-            catch (err) {
-                console.log("Error parsing privateKey");
-                reject(new Error(`ssh.isPassphraseRequiredForKey: err ${err}`));
-            }
-        });
-    }
-    /**
-     * Uploads a local file to a remote server via SFTP.
-     * This function creates new SFTP connection
-     * @param localPath - The local file path.
-     * @param remotePath - The remote file path on the server.
-     * @returns A promise resolving with `true` if the file was successfully uploaded.
-     */
-    async uploadFile(localPath, remotePath) {
-        return await tsHelpers.retry(async () => {
-            return await this.withSftp(async (sftp) => {
-                return new Promise((resolve, reject) => {
-                    sftp.fastPut(localPath, remotePath, (err) => {
-                        if (err) {
-                            const newErr = new ssh_errors.SFTPUploadError(err, localPath, remotePath);
-                            return reject(newErr);
-                        }
-                        resolve(true);
-                    });
-                });
-            });
-        }, tsHelpers.Retry3TimesWithDelay, (e) => ssh_errors.SFTPError.from(e)?.isGenericFailure ?? false);
-    }
-    async withSftp(callback) {
-        return new Promise((resolve, reject) => {
-            this.client.sftp((err, sftp) => {
-                if (err) {
-                    return reject(new Error(`ssh.withSftp: sftp err: ${err}`, { cause: err }));
-                }
-                callback(sftp)
-                    .then(resolve)
-                    .catch((err) => {
-                    reject(new Error(`ssh.withSftp.callback: err ${err}`, { cause: err }));
-                })
-                    .finally(() => {
-                    sftp?.end();
-                });
-            });
-        });
-    }
-    async writeFileOnTheServer(remotePath, data, mode = 0o660) {
-        return this.withSftp(async (sftp) => {
-            return this.writeFile(sftp, remotePath, data, mode);
-        });
-    }
-    async getForderStructure(sftp, remotePath, data = { files: [], directories: [] }) {
-        return new Promise((resolve, reject) => {
-            sftp.readdir(remotePath, async (err, items) => {
-                if (err) {
-                    return reject(err);
-                }
-                for (const item of items) {
-                    const itemPath = `${remotePath}/${item.filename}`;
-                    if (item.attrs.isDirectory()) {
-                        data.directories.push(itemPath);
-                        try {
-                            await this.getForderStructure(sftp, itemPath, data);
-                        }
-                        catch (error) {
-                            return reject(error instanceof Error ? error : new Error(String(error)));
-                        }
-                    }
-                    else {
-                        data.files.push(itemPath);
-                    }
-                }
-                resolve(data);
-            });
-        });
-    }
-    rmdir(sftp, path) {
-        return new Promise((resolve, reject) => {
-            sftp.rmdir(path, (err) => (err ? reject(err) : resolve(true)));
-        });
-    }
-    unlink(sftp, path) {
-        return new Promise((resolve, reject) => {
-            sftp.unlink(path, (err) => (err ? reject(err) : resolve(true)));
-        });
-    }
-    async deleteFolder(path) {
-        return this.withSftp(async (sftp) => {
-            try {
-                const list = await this.getForderStructure(sftp, path);
-                this.logger.info(`ssh.deleteFolder list of files and directories`);
-                this.logger.info(`ssh.deleteFolder list of files: ${list.files}`);
-                this.logger.info(`ssh.deleteFolder list of directories: ${list.directories}`);
-                for (const filePath of list.files) {
-                    this.logger.info(`ssh.deleteFolder unlink file ${filePath}`);
-                    await this.unlink(sftp, filePath);
-                }
-                list.directories.sort((a, b) => b.length - a.length);
-                for (const directoryPath of list.directories) {
-                    this.logger.info(`ssh.deleteFolder rmdir  ${directoryPath}`);
-                    await this.rmdir(sftp, directoryPath);
-                }
-                await this.rmdir(sftp, path);
-                return true;
-            }
-            catch (e) {
-                this.logger.error(e);
-                const message = e instanceof Error ? e.message : "";
-                throw new Error(`ssh.deleteFolder: path: ${path}, message: ${message}`);
-            }
-        });
-    }
-    async readFile(remotePath) {
-        return this.withSftp(async (sftp) => {
-            return new Promise((resolve, reject) => {
-                sftp.readFile(remotePath, (err, buffer) => {
-                    if (err) {
-                        return reject(new Error(`ssh.readFile: ${err}`));
-                    }
-                    resolve(buffer.toString());
-                });
-            });
-        });
-    }
-    async chmod(path, mode) {
-        return this.withSftp(async (sftp) => {
-            return new Promise((resolve, reject) => {
-                sftp.chmod(path, mode, (err) => {
-                    if (err) {
-                        return reject(new Error(`ssh.chmod: ${err}, path: ${path}, mode: ${mode}`));
-                    }
-                    return resolve(undefined);
-                });
-            });
-        });
-    }
-    async checkFileExists(remotePath) {
-        return this.withSftp(async (sftp) => {
-            return new Promise((resolve, reject) => {
-                sftp.stat(remotePath, (err, stats) => {
-                    if (err) {
-                        if (err?.code === 2) {
-                            return resolve(false);
-                        }
-                        return reject(new Error(`ssh.checkFileExists: err ${err}`));
-                    }
-                    resolve(stats.isFile());
-                });
-            });
-        });
-    }
-    async checkPathExists(remotePath) {
-        return this.withSftp(async (sftp) => {
-            return new Promise((resolve, reject) => {
-                sftp.stat(remotePath, (err, stats) => {
-                    if (err) {
-                        if (err.code === 2) {
-                            return resolve({ exists: false, isFile: false, isDirectory: false });
-                        }
-                        return reject(new Error(`ssh.checkPathExists: ${err}`));
-                    }
-                    resolve({
-                        exists: true,
-                        isFile: stats.isFile(),
-                        isDirectory: stats.isDirectory(),
-                    });
-                });
-            });
-        });
-    }
-    async writeFile(sftp, remotePath, data, mode = 0o660) {
-        return new Promise((resolve, reject) => {
-            sftp.writeFile(remotePath, data, { mode }, (err) => {
-                if (err) {
-                    return reject(new Error(`ssh.writeFile: err ${err}, remotePath: ${remotePath}`));
-                }
-                resolve(true);
-            });
-        });
-    }
-    uploadFileUsingExistingSftp(sftp, localPath, remotePath, mode = 0o660) {
-        return new Promise((resolve, reject) => {
-            void fsp.readFile(localPath).then(async (result) => {
-                return this.writeFile(sftp, remotePath, result, mode)
-                    .then(() => {
-                    resolve(undefined);
-                })
-                    .catch((err) => {
-                    const msg = `uploadFileUsingExistingSftp: ${err}`;
-                    this.logger.error(msg);
-                    reject(new Error(msg));
-                });
-            });
-        });
-    }
-    async __uploadDirectory(sftp, localDir, remoteDir, mode = 0o660) {
-        return new Promise((resolve, reject) => {
-            fs.readdir(localDir, async (err, files) => {
-                if (err) {
-                    return reject(new Error(`ssh.__uploadDir: err ${err}, localDir: ${localDir}, remoteDir: ${remoteDir}`));
-                }
-                try {
-                    await this.__createRemoteDirectory(sftp, remoteDir);
-                    for (const file of files) {
-                        const localPath = upath.join(localDir, file);
-                        const remotePath = `${remoteDir}/${file}`;
-                        if (fs.lstatSync(localPath).isDirectory()) {
-                            await this.__uploadDirectory(sftp, localPath, remotePath, mode);
-                        }
-                        else {
-                            await this.uploadFileUsingExistingSftp(sftp, localPath, remotePath, mode);
-                        }
-                    }
-                    resolve();
-                }
-                catch (err) {
-                    const msg = `ssh.__uploadDir: catched err ${err}`;
-                    this.logger.error(msg);
-                    reject(new Error(msg));
-                }
-            });
-        });
-    }
-    /**
-     * Uploads a local directory and its contents (including subdirectories) to the remote server via SFTP.
-     * @param localDir - The path to the local directory to upload.
-     * @param remoteDir - The path to the remote directory on the server.
-     * @returns A promise that resolves when the directory and its contents are uploaded.
-     */
-    async uploadDirectory(localDir, remoteDir, mode = 0o660) {
-        return new Promise((resolve, reject) => {
-            void this.withSftp(async (sftp) => {
-                try {
-                    await this.__uploadDirectory(sftp, localDir, remoteDir, mode);
-                    resolve();
-                }
-                catch (e) {
-                    reject(new Error(`ssh.uploadDirectory: ${e}`));
-                }
-            });
-        });
-    }
-    /**
-     * Ensures that a remote directory and all its parent directories exist.
-     * @param sftp - The SFTP wrapper.
-     * @param remotePath - The path to the remote directory.
-     * @returns A promise that resolves when the directory is created.
-     */
-    __createRemoteDirectory(sftp, remotePath) {
-        return new Promise((resolve, reject) => {
-            const directories = remotePath.split("/");
-            let currentPath = "";
-            const createNext = (index) => {
-                if (index >= directories.length) {
-                    return resolve();
-                }
-                currentPath += `${directories[index]}/`;
-                sftp.stat(currentPath, (err) => {
-                    if (err) {
-                        sftp.mkdir(currentPath, (err) => {
-                            if (err) {
-                                return reject(new Error(`ssh.__createRemDir: err ${err}, remotePath: ${remotePath}`));
-                            }
-                            createNext(index + 1);
-                        });
-                    }
-                    else {
-                        createNext(index + 1);
-                    }
-                });
-            };
-            createNext(0);
-        });
-    }
-    /**
-     * Ensures that a remote directory and all its parent directories exist.
-     * @param sftp - The SFTP wrapper.
-     * @param remotePath - The path to the remote directory.
-     * @returns A promise that resolves when the directory is created.
-     */
-    ensureRemoteDirCreated(remotePath, mode = 0o755) {
-        return this.withSftp(async (sftp) => {
-            const directories = remotePath.split("/");
-            let currentPath = "";
-            for (const directory of directories) {
-                currentPath += `${directory}/`;
-                try {
-                    await new Promise((resolve, reject) => {
-                        sftp.stat(currentPath, (err) => {
-                            if (!err)
-                                return resolve();
-                            sftp.mkdir(currentPath, { mode }, (err) => {
-                                if (err) {
-                                    return reject(new Error(`ssh.createRemoteDir: err ${err}, remotePath: ${remotePath}`));
-                                }
-                                resolve();
-                            });
-                        });
-                    });
-                }
-                catch (error) {
-                    console.error(`Failed to create directory: ${currentPath}`, error);
-                    throw error;
-                }
-            }
-        });
-    }
-    /**
-     * Downloads a file from the remote server to a local path via SFTP.
-     * @param remotePath - The remote file path on the server.
-     * @param localPath - The local file path to save the file.
-     * @returns A promise resolving with `true` if the file was successfully downloaded.
-     */
-    async downloadFile(remotePath, localPath) {
-        return this.withSftp(async (sftp) => {
-            return new Promise((resolve, reject) => {
-                sftp.fastGet(remotePath, localPath, (err) => {
-                    if (err) {
-                        return reject(new Error(`ssh.downloadFile: err ${err}, remotePath: ${remotePath}, localPath: ${localPath}`));
-                    }
-                    resolve(true);
-                });
-            });
-        });
-    }
-    /**
-     * Closes the SSH client connection and forwarded ports.
-     */
-    close() {
-        this.closeForwardedPorts();
-        this.client.end();
-    }
-}
 async function connect(client, config, onError, onClose) {
-    return new Promise((resolve, reject) => {
-        client.on("ready", () => {
-            resolve(client);
-        });
-        client.on("error", (err) => {
-            reject(new Error(`ssh.connect: ${err}`));
-        });
-        client.on("close", () => {
-        });
-        client.connect(config);
-        // Remove TCP buffering.
-        // Although it means less throughput (bad), it also means less latency (good).
-        // It could help when we have
-        // small messages like in our grpc transactions.
-        // And it also could help when we have tcp forwarding to not buffer messages in the middle.
-        client.setNoDelay(true);
-    });
+	return new Promise((resolve, reject) => {
+		client.on("ready", () => {
+			resolve(client);
+		});
+		client.on("error", (err) => {
+			onError(err);
+			reject(/* @__PURE__ */ new Error(`ssh.connect: ${err}`));
+		});
+		client.on("close", () => {
+			onClose();
+		});
+		client.connect(config);
+		client.setNoDelay(true);
+	});
 }
 async function forwardOut(logger, conn, localHost, localPort, remoteHost, remotePort) {
-    return new Promise((resolve, reject) => {
-        conn.forwardOut(localHost, localPort, remoteHost, remotePort, (err, stream) => {
-            if (err) {
-                logger.error(`forwardOut.error: ${err}`);
-                return reject(err);
-            }
-            return resolve(stream);
-        });
-    });
+	return new Promise((resolve, reject) => {
+		conn.forwardOut(localHost, localPort, remoteHost, remotePort, (err, stream) => {
+			if (err) {
+				logger.error(`forwardOut.error: ${err}`);
+				return reject(err);
+			}
+			return resolve(stream);
+		});
+	});
 }
 
+//#endregion
 exports.SshClient = SshClient;
-//# sourceMappingURL=ssh.cjs.map
+//# sourceMappingURL=ssh.cjs.map