node-red-contrib-best-sftp 1.0.0

package/README.md

@@ -0,0 +1,205 @@
+# node-red-contrib-best-sftp
+
+A reliable SFTP client node for Node-RED with keyboard-interactive authentication support.
+
+## Features
+
+- **Multiple authentication methods**: Password, keyboard-interactive, and SSH private key
+- **9 SFTP operations**: list, get, put, delete, mkdir, rmdir, rename, exists, stat
+- **Keyboard-interactive auth**: Works with servers that require interactive authentication
+- **Dynamic configuration**: Override settings via message properties
+- **Status indicators**: Visual feedback for connection and operation states
+- **Secure credential storage**: Passwords and keys encrypted by Node-RED
+
+## Installation
+
+### Via Node-RED Palette Manager
+
+1. Open Node-RED
+2. Go to Menu → Manage Palette → Install
+3. Search for `node-red-contrib-best-sftp`
+4. Click Install
+
+### Via npm
+
+```bash
+cd ~/.node-red
+npm install node-red-contrib-best-sftp
+```
+
+Then restart Node-RED.
+
+## Nodes
+
+### sftp-config
+
+Configuration node that stores SFTP server connection settings.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| Host | string | SFTP server hostname or IP |
+| Port | number | SFTP port (default: 22) |
+| Username | string | Authentication username |
+| Password | string | Authentication password |
+| Keyboard Auth | boolean | Enable keyboard-interactive authentication |
+| Private Key | string | SSH private key (optional) |
+| Passphrase | string | Private key passphrase (optional) |
+
+### sftp-best
+
+Main SFTP operations node.
+
+| Property | Type | Description |
+|----------|------|-------------|
+| Server | sftp-config | Reference to server configuration |
+| Operation | string | SFTP operation to perform |
+| Remote Path | string | Path on the remote server |
+| Local Path | string | Local file path (for get/put operations) |
+| Recursive | boolean | Recursive mode for mkdir/rmdir |
+
+## Operations
+
+### list
+Lists contents of a remote directory.
+
+**Input:** `msg.remotePath` or `msg.payload` (path string)
+**Output:** `msg.payload` - Array of file objects with `name`, `type`, `size`, `modifyTime`
+
+### get
+Downloads a file from the remote server.
+
+**Input:** `msg.remotePath` - Remote file path
+**Output:** `msg.payload` - File contents as Buffer, or `{success, localPath}` if local path specified
+
+### put
+Uploads a file to the remote server.
+
+**Input:** `msg.payload` - Buffer with file contents, or use `msg.localPath` for local file
+**Output:** `msg.payload` - `{success: true, remotePath}`
+
+### delete
+Deletes a file on the remote server.
+
+**Input:** `msg.remotePath` - File to delete
+**Output:** `msg.payload` - `{success: true, deleted}`
+
+### mkdir
+Creates a directory on the remote server.
+
+**Input:** `msg.remotePath` - Directory path, `msg.recursive` - Create parent directories
+**Output:** `msg.payload` - `{success: true, created}`
+
+### rmdir
+Removes a directory on the remote server.
+
+**Input:** `msg.remotePath` - Directory path, `msg.recursive` - Remove contents
+**Output:** `msg.payload` - `{success: true, removed}`
+
+### rename
+Renames or moves a file/directory.
+
+**Input:** `msg.remotePath` - Source path, `msg.newPath` - Destination path
+**Output:** `msg.payload` - `{success: true, from, to}`
+
+### exists
+Checks if a path exists on the remote server.
+
+**Input:** `msg.remotePath` - Path to check
+**Output:** `msg.payload` - `'d'` (directory), `'-'` (file), `'l'` (link), or `false`; `msg.exists` - boolean
+
+### stat
+Gets file/directory information.
+
+**Input:** `msg.remotePath` - Path to stat
+**Output:** `msg.payload` - Stats object with `size`, `mode`, `accessTime`, `modifyTime`
+
+## Message Properties
+
+All operations add metadata to the output message:
+
+```javascript
+msg.sftp = {
+    operation: 'list',
+    remotePath: '/home/user/files',
+    host: 'sftp.example.com',
+    port: 22
+}
+```
+
+### Input Overrides
+
+You can override node configuration via message properties:
+
+| Property | Description |
+|----------|-------------|
+| `msg.operation` | Override the operation type |
+| `msg.remotePath` | Override the remote path |
+| `msg.localPath` | Override the local path |
+| `msg.newPath` | Destination path for rename |
+| `msg.recursive` | Override recursive setting |
+| `msg.host` | Override server host |
+| `msg.port` | Override server port |
+| `msg.username` | Override username |
+
+## Examples
+
+### List Directory
+
+```javascript
+msg.remotePath = '/home/user/documents';
+msg.operation = 'list';
+return msg;
+```
+
+### Download File to Buffer
+
+```javascript
+msg.remotePath = '/home/user/data.csv';
+msg.operation = 'get';
+return msg;
+// Output: msg.payload contains file buffer
+```
+
+### Upload from Buffer
+
+```javascript
+msg.payload = Buffer.from('Hello World');
+msg.remotePath = '/home/user/hello.txt';
+msg.operation = 'put';
+return msg;
+```
+
+### Check if File Exists
+
+```javascript
+msg.remotePath = '/home/user/config.json';
+msg.operation = 'exists';
+return msg;
+// Output: msg.exists = true/false
+```
+
+## Status Indicators
+
+| Status | Meaning |
+|--------|---------|
+| Yellow dot | Connecting to server |
+| Green dot | Connected / Operation complete |
+| Blue dot | Operation in progress |
+| Red ring | Error occurred |
+
+## Requirements
+
+- Node.js >= 18.0.0
+- Node-RED >= 2.0.0
+
+## License
+
+MIT
+
+## Contributing
+
+Issues and pull requests welcome at [GitHub](https://github.com/digitalnodecom/node-red-contrib-best-sftp).
+
+## Author
+
+Trajche <trajche@kralev.eu>

package/nodes/sftp-config.html

@@ -0,0 +1,95 @@
+<script type="text/javascript">
+    RED.nodes.registerType('sftp-config', {
+        category: 'config',
+        defaults: {
+            name: { value: '' },
+            host: { value: '', required: true },
+            port: { value: 22, required: true, validate: RED.validators.number() },
+            tryKeyboard: { value: true }
+        },
+        credentials: {
+            username: { type: 'text' },
+            password: { type: 'password' },
+            privateKey: { type: 'password' },
+            passphrase: { type: 'password' }
+        },
+        label: function() {
+            if (this.name) {
+                return this.name;
+            }
+            var user = this.credentials && this.credentials.username ? this.credentials.username : 'user';
+            return user + '@' + (this.host || 'sftp-server') + ':' + (this.port || 22);
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="sftp-config">
+    <div class="form-row">
+        <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-config-input-name" placeholder="Optional display name">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-host"><i class="fa fa-server"></i> Host</label>
+        <input type="text" id="node-config-input-host" placeholder="sftp.example.com">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-port"><i class="fa fa-hashtag"></i> Port</label>
+        <input type="number" id="node-config-input-port" placeholder="22">
+    </div>
+    <hr>
+    <div class="form-row">
+        <label for="node-config-input-username"><i class="fa fa-user"></i> Username</label>
+        <input type="text" id="node-config-input-username" placeholder="username">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-password"><i class="fa fa-lock"></i> Password</label>
+        <input type="password" id="node-config-input-password" placeholder="password">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-tryKeyboard"><i class="fa fa-keyboard-o"></i> Keyboard Auth</label>
+        <input type="checkbox" id="node-config-input-tryKeyboard" style="width:auto; margin-left:0;">
+        <span style="margin-left:5px;">Use keyboard-interactive authentication</span>
+    </div>
+    <hr>
+    <div class="form-row">
+        <label for="node-config-input-privateKey"><i class="fa fa-key"></i> Private Key</label>
+        <textarea id="node-config-input-privateKey" rows="4" style="width:70%" placeholder="-----BEGIN RSA PRIVATE KEY-----&#10;...&#10;-----END RSA PRIVATE KEY-----"></textarea>
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-passphrase"><i class="fa fa-shield"></i> Passphrase</label>
+        <input type="password" id="node-config-input-passphrase" placeholder="Key passphrase (if encrypted)">
+    </div>
+</script>
+
+<script type="text/html" data-help-name="sftp-config">
+    <p>Configuration node for SFTP server connection settings.</p>
+
+    <h3>Settings</h3>
+    <dl class="message-properties">
+        <dt>Host <span class="property-type">string</span></dt>
+        <dd>The SFTP server hostname or IP address.</dd>
+
+        <dt>Port <span class="property-type">number</span></dt>
+        <dd>The SFTP server port (default: 22).</dd>
+
+        <dt>Username <span class="property-type">string</span></dt>
+        <dd>The username for authentication.</dd>
+
+        <dt>Password <span class="property-type">string</span></dt>
+        <dd>The password for authentication. Used for password and keyboard-interactive auth.</dd>
+
+        <dt>Private Key <span class="property-type">string</span></dt>
+        <dd>Optional SSH private key for key-based authentication.</dd>
+
+        <dt>Passphrase <span class="property-type">string</span></dt>
+        <dd>Passphrase for encrypted private keys.</dd>
+    </dl>
+
+    <h3>Authentication</h3>
+    <p>This node supports multiple authentication methods:</p>
+    <ul>
+        <li><b>Password</b> - Standard password authentication</li>
+        <li><b>Keyboard-interactive</b> - Interactive authentication (uses password)</li>
+        <li><b>Public key</b> - SSH key-based authentication</li>
+    </ul>
+</script>

package/nodes/sftp-config.js

@@ -0,0 +1,29 @@
+module.exports = function(RED) {
+    'use strict';
+
+    function SFTPConfigNode(config) {
+        RED.nodes.createNode(this, config);
+
+        // Non-sensitive configuration
+        this.name = config.name;
+        this.host = config.host;
+        this.port = config.port || 22;
+        this.tryKeyboard = config.tryKeyboard;
+
+        // Credentials (stored encrypted)
+        const creds = this.credentials || {};
+        this.username = creds.username;
+        this.password = creds.password;
+        this.privateKey = creds.privateKey;
+        this.passphrase = creds.passphrase;
+    }
+
+    RED.nodes.registerType('sftp-config', SFTPConfigNode, {
+        credentials: {
+            username: { type: 'text' },
+            password: { type: 'password' },
+            privateKey: { type: 'password' },
+            passphrase: { type: 'password' }
+        }
+    });
+};

package/nodes/sftp.html

@@ -0,0 +1,209 @@
+<script type="text/javascript">
+    RED.nodes.registerType('sftp-best', {
+        category: 'storage',
+        color: '#4B8BBE',
+        defaults: {
+            name: { value: '' },
+            server: { value: '', type: 'sftp-config', required: true },
+            operation: { value: 'list' },
+            remotePath: { value: '/' },
+            localPath: { value: '' },
+            recursive: { value: false }
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'file.svg',
+        paletteLabel: 'SFTP',
+        label: function() {
+            if (this.name) {
+                return this.name;
+            }
+            var op = this.operation || 'list';
+            return 'sftp-best ' + op;
+        },
+        labelStyle: function() {
+            return this.name ? 'node_label_italic' : '';
+        },
+        oneditprepare: function() {
+            var node = this;
+
+            function updateVisibility() {
+                var op = $('#node-input-operation').val();
+
+                // Hide all optional rows first
+                $('.sftp-best-localpath-row').hide();
+                $('.sftp-best-recursive-row').hide();
+
+                // Show relevant fields based on operation
+                switch (op) {
+                    case 'get':
+                        $('.sftp-best-localpath-row').show();
+                        $('#localpath-label').text('Local Path (optional)');
+                        $('#localpath-help').text('Leave empty to return file as buffer');
+                        break;
+                    case 'put':
+                        $('.sftp-best-localpath-row').show();
+                        $('#localpath-label').text('Local Path');
+                        $('#localpath-help').text('Source file path, or send buffer in msg.payload');
+                        break;
+                    case 'rename':
+                        $('.sftp-best-localpath-row').show();
+                        $('#localpath-label').text('New Path');
+                        $('#localpath-help').text('New remote path/name');
+                        break;
+                    case 'mkdir':
+                    case 'rmdir':
+                        $('.sftp-best-recursive-row').show();
+                        break;
+                }
+            }
+
+            $('#node-input-operation').on('change', updateVisibility);
+            updateVisibility();
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="sftp-best">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-server"><i class="fa fa-server"></i> Server</label>
+        <input type="text" id="node-input-server">
+    </div>
+    <div class="form-row">
+        <label for="node-input-operation"><i class="fa fa-tasks"></i> Operation</label>
+        <select id="node-input-operation">
+            <option value="list">List Directory</option>
+            <option value="get">Download File</option>
+            <option value="put">Upload File</option>
+            <option value="delete">Delete File</option>
+            <option value="mkdir">Create Directory</option>
+            <option value="rmdir">Remove Directory</option>
+            <option value="rename">Rename/Move</option>
+            <option value="exists">Check Exists</option>
+            <option value="stat">Get File Info</option>
+        </select>
+    </div>
+    <div class="form-row">
+        <label for="node-input-remotePath"><i class="fa fa-folder-open"></i> Remote Path</label>
+        <input type="text" id="node-input-remotePath" placeholder="/">
+    </div>
+    <div class="form-row sftp-best-localpath-row">
+        <label for="node-input-localPath"><i class="fa fa-file"></i> <span id="localpath-label">Local Path</span></label>
+        <input type="text" id="node-input-localPath" placeholder="">
+        <div class="form-tips" id="localpath-help"></div>
+    </div>
+    <div class="form-row sftp-best-recursive-row">
+        <label for="node-input-recursive"><i class="fa fa-sitemap"></i> Recursive</label>
+        <input type="checkbox" id="node-input-recursive" style="width:auto; margin-left:0;">
+        <span style="margin-left:5px;">Create/remove subdirectories</span>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="sftp-best">
+    <p>Performs SFTP operations on a remote server using ssh2-sftp-client.</p>
+
+    <h3>Operations</h3>
+    <dl class="message-properties">
+        <dt>list</dt>
+        <dd>Lists contents of a remote directory. Returns array of file objects.</dd>
+
+        <dt>get</dt>
+        <dd>Downloads a file. Returns file buffer or writes to local path.</dd>
+
+        <dt>put</dt>
+        <dd>Uploads a file from local path or msg.payload buffer.</dd>
+
+        <dt>delete</dt>
+        <dd>Deletes a remote file.</dd>
+
+        <dt>mkdir</dt>
+        <dd>Creates a remote directory. Use recursive for nested paths.</dd>
+
+        <dt>rmdir</dt>
+        <dd>Removes a remote directory. Use recursive to remove contents.</dd>
+
+        <dt>rename</dt>
+        <dd>Renames or moves a remote file/directory.</dd>
+
+        <dt>exists</dt>
+        <dd>Checks if path exists. Returns 'd' (dir), '-' (file), 'l' (link), or false.</dd>
+
+        <dt>stat</dt>
+        <dd>Gets file/directory statistics (size, permissions, times).</dd>
+    </dl>
+
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">string | buffer</span></dt>
+        <dd>For list/get/delete/exists/stat: remote path (overrides config).
+            For put: file content as buffer.</dd>
+
+        <dt class="optional">remotePath <span class="property-type">string</span></dt>
+        <dd>Override the remote path setting.</dd>
+
+        <dt class="optional">localPath <span class="property-type">string</span></dt>
+        <dd>Override the local path setting.</dd>
+
+        <dt class="optional">operation <span class="property-type">string</span></dt>
+        <dd>Override the operation type.</dd>
+
+        <dt class="optional">newPath <span class="property-type">string</span></dt>
+        <dd>For rename: the destination path.</dd>
+
+        <dt class="optional">recursive <span class="property-type">boolean</span></dt>
+        <dd>For mkdir/rmdir: create/remove subdirectories.</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">varies</span></dt>
+        <dd>
+            <ul>
+                <li><b>list:</b> Array of file objects with name, type, size, modifyTime</li>
+                <li><b>get:</b> File buffer or {success, localPath}</li>
+                <li><b>put:</b> {success, remotePath}</li>
+                <li><b>delete:</b> {success, deleted}</li>
+                <li><b>mkdir:</b> {success, created}</li>
+                <li><b>rmdir:</b> {success, removed}</li>
+                <li><b>rename:</b> {success, from, to}</li>
+                <li><b>exists:</b> 'd', '-', 'l', or false</li>
+                <li><b>stat:</b> File statistics object</li>
+            </ul>
+        </dd>
+
+        <dt>sftp-best <span class="property-type">object</span></dt>
+        <dd>Metadata: operation, remotePath, host, port</dd>
+
+        <dt>exists <span class="property-type">boolean</span></dt>
+        <dd>For exists operation: true if path exists.</dd>
+    </dl>
+
+    <h3>Status</h3>
+    <p>The node shows connection and operation status:</p>
+    <ul>
+        <li><b>Yellow dot:</b> Connecting</li>
+        <li><b>Green dot:</b> Connected / Done</li>
+        <li><b>Blue dot:</b> Operation in progress</li>
+        <li><b>Red ring:</b> Error occurred</li>
+    </ul>
+
+    <h3>Example: List Directory</h3>
+    <pre>msg.payload = '/home/user/files';
+// or
+msg.remotePath = '/home/user/files';
+msg.operation = 'list';</pre>
+
+    <h3>Example: Download File</h3>
+    <pre>msg.remotePath = '/home/user/file.csv';
+msg.operation = 'get';
+// Returns file buffer in msg.payload</pre>
+
+    <h3>Example: Upload Buffer</h3>
+    <pre>msg.payload = Buffer.from('file content');
+msg.remotePath = '/home/user/newfile.txt';
+msg.operation = 'put';</pre>
+</script>

package/nodes/sftp.js

@@ -0,0 +1,196 @@
+module.exports = function(RED) {
+    'use strict';
+
+    const Client = require('ssh2-sftp-client');
+
+    function SFTPNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        // Get config node reference
+        this.server = RED.nodes.getNode(config.server);
+        this.operation = config.operation || 'list';
+        this.remotePath = config.remotePath || '/';
+        this.localPath = config.localPath || '';
+        this.recursive = config.recursive || false;
+
+        if (!this.server) {
+            node.error('No SFTP server configured');
+            node.status({ fill: 'red', shape: 'ring', text: 'no server' });
+            return;
+        }
+
+        node.on('input', async function(msg, send, done) {
+            send = send || function() { node.send.apply(node, arguments); };
+
+            const sftp = new Client();
+            const password = node.server.password;
+
+            // Build connection config
+            const tryKeyboard = node.server.tryKeyboard !== false;
+            const connectionConfig = {
+                host: msg.host || node.server.host,
+                port: msg.port || node.server.port || 22,
+                username: msg.username || node.server.username,
+                tryKeyboard: tryKeyboard,
+                readyTimeout: 30000
+            };
+
+            // Add password if provided
+            if (password) {
+                connectionConfig.password = password;
+            }
+
+            // Add private key if provided
+            if (node.server.privateKey) {
+                connectionConfig.privateKey = node.server.privateKey;
+                if (node.server.passphrase) {
+                    connectionConfig.passphrase = node.server.passphrase;
+                }
+            }
+
+            // Handle keyboard-interactive authentication
+            if (connectionConfig.tryKeyboard) {
+                sftp.client.on('keyboard-interactive', (name, instructions, lang, prompts, finish) => {
+                    finish(prompts.map(() => password));
+                });
+            }
+
+            // Get operation parameters from msg or config
+            const operation = msg.operation || node.operation;
+            // Only use msg.payload as path if it's a non-empty string
+            let remotePath = node.remotePath || '/';
+            if (msg.remotePath && typeof msg.remotePath === 'string') {
+                remotePath = msg.remotePath;
+            } else if (msg.payload && typeof msg.payload === 'string' && msg.payload.startsWith('/')) {
+                remotePath = msg.payload;
+            }
+            const localPath = msg.localPath || node.localPath;
+            const recursive = msg.recursive !== undefined ? msg.recursive : node.recursive;
+
+            try {
+                node.status({ fill: 'yellow', shape: 'dot', text: 'connecting...' });
+                await sftp.connect(connectionConfig);
+                node.status({ fill: 'green', shape: 'dot', text: 'connected' });
+
+                let result;
+
+                switch (operation) {
+                    case 'list':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'listing...' });
+                        result = await sftp.list(remotePath);
+                        msg.payload = result;
+                        break;
+
+                    case 'get':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'downloading...' });
+                        if (localPath) {
+                            await sftp.get(remotePath, localPath);
+                            msg.payload = { success: true, localPath: localPath };
+                        } else {
+                            // Return as buffer
+                            result = await sftp.get(remotePath);
+                            msg.payload = result;
+                        }
+                        break;
+
+                    case 'put':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'uploading...' });
+                        if (Buffer.isBuffer(msg.payload)) {
+                            await sftp.put(msg.payload, remotePath);
+                        } else if (localPath) {
+                            await sftp.put(localPath, remotePath);
+                        } else {
+                            throw new Error('put operation requires msg.payload as Buffer or localPath');
+                        }
+                        msg.payload = { success: true, remotePath: remotePath };
+                        break;
+
+                    case 'delete':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'deleting...' });
+                        await sftp.delete(remotePath);
+                        msg.payload = { success: true, deleted: remotePath };
+                        break;
+
+                    case 'mkdir':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'creating dir...' });
+                        await sftp.mkdir(remotePath, recursive);
+                        msg.payload = { success: true, created: remotePath };
+                        break;
+
+                    case 'rmdir':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'removing dir...' });
+                        await sftp.rmdir(remotePath, recursive);
+                        msg.payload = { success: true, removed: remotePath };
+                        break;
+
+                    case 'rename':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'renaming...' });
+                        const newPath = msg.newPath || localPath;
+                        if (!newPath) {
+                            throw new Error('rename operation requires msg.newPath or localPath');
+                        }
+                        await sftp.rename(remotePath, newPath);
+                        msg.payload = { success: true, from: remotePath, to: newPath };
+                        break;
+
+                    case 'exists':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'checking...' });
+                        result = await sftp.exists(remotePath);
+                        msg.payload = result; // false, 'd', '-', or 'l'
+                        msg.exists = result !== false;
+                        break;
+
+                    case 'stat':
+                        node.status({ fill: 'blue', shape: 'dot', text: 'getting stats...' });
+                        result = await sftp.stat(remotePath);
+                        msg.payload = result;
+                        break;
+
+                    default:
+                        throw new Error('Unknown operation: ' + operation);
+                }
+
+                // Add metadata
+                msg.sftp = {
+                    operation: operation,
+                    remotePath: remotePath,
+                    host: connectionConfig.host,
+                    port: connectionConfig.port
+                };
+
+                node.status({ fill: 'green', shape: 'dot', text: 'done' });
+                send(msg);
+
+                // Clear status after 2 seconds
+                setTimeout(() => {
+                    node.status({});
+                }, 2000);
+
+                if (done) {
+                    done();
+                }
+
+            } catch (err) {
+                node.status({ fill: 'red', shape: 'ring', text: err.message.substring(0, 20) });
+                if (done) {
+                    done(err);
+                } else {
+                    node.error(err.message, msg);
+                }
+            } finally {
+                try {
+                    await sftp.end();
+                } catch (e) {
+                    // Ignore close errors
+                }
+            }
+        });
+
+        node.on('close', function() {
+            node.status({});
+        });
+    }
+
+    RED.nodes.registerType('sftp-best', SFTPNode);
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "node-red-contrib-best-sftp",
+  "version": "1.0.0",
+  "description": "Reliable SFTP client node for Node-RED with keyboard-interactive auth support",
+  "keywords": [
+    "node-red",
+    "sftp",
+    "ssh",
+    "file-transfer",
+    "ftp"
+  ],
+  "author": "Trajche <trajche@kralev.eu>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/digitalnodecom/node-red-contrib-best-sftp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/digitalnodecom/node-red-contrib-best-sftp/issues"
+  },
+  "homepage": "https://github.com/digitalnodecom/node-red-contrib-best-sftp#readme",
+  "node-red": {
+    "version": ">=2.0.0",
+    "nodes": {
+      "sftp-config": "nodes/sftp-config.js",
+      "sftp-best": "nodes/sftp.js"
+    }
+  },
+  "dependencies": {
+    "ssh2-sftp-client": "^12.0.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0",
+    "node-red": "^4.1.3",
+    "node-red-node-test-helper": "^0.3.6"
+  },
+  "scripts": {
+    "test": "jest"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "jest": {
+    "testEnvironment": "node",
+    "testMatch": [
+      "**/test/**/*_spec.js"
+    ],
+    "testTimeout": 10000
+  }
+}