molex-ftp-client 2.1.0 → 2.2.2

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [2.2.0] - 2026-02-02
+
+### Fixed
+- **CRITICAL: Fixed 30-second timeout on all data transfers** - upload, download, list, downloadStream now complete instantly
+- Commands with data connections no longer wait for 226 completion response, dramatically improving speed
+- Download speed improved from 0.03 MB/s to 2.47 MB/s (80x faster!)
+- Recursive directory deletion now blazing fast (sub-second instead of minutes)
+
+### Added
+- `removeDir(path, recursive)` - Remove directories with optional recursive deletion
+- `chmod(path, mode)` - Change file permissions (Unix/Linux servers)
+- `listDetailed(path)` - Get parsed directory listings with permissions, owner, size, etc.
+- `site(command)` - Execute server-specific SITE commands
+
+### Improved
+- `listDetailed()` now filters out `.` and `..` entries automatically
+- Better handling of unknown file types in recursive operations
+
 ## [2.1.0] - 2026-02-02
 
 ### Added

package/README.md

@@ -1,15 +1,22 @@
 # molex-ftp-client
 
-Lightweight FTP client built with native Node.js TCP sockets. Zero dependencies, optimized for performance.
+[![npm version](https://img.shields.io/npm/v/molex-ftp-client.svg)](https://www.npmjs.com/package/molex-ftp-client)
+[![npm downloads](https://img.shields.io/npm/dm/molex-ftp-client.svg)](https://www.npmjs.com/package/molex-ftp-client)
+[![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D14-brightgreen.svg)](https://nodejs.org)
+[![Dependencies](https://img.shields.io/badge/dependencies-0-success.svg)](package.json)
+
+> **Lightweight FTP client built with native Node.js TCP sockets. Zero dependencies, optimized for performance.**
 
 ## Features
 
 - **Zero dependencies** - Uses only native Node.js modules
 - **Promise-based API** - Modern async/await support
-- **TCP optimizations** - TCP_NODELAY and keep-alive applied by default
+- **TCP optimizations** - TCP_NODELAY and keep-alive applied by default (~2.5 MB/s transfer speeds)
 - **Auto-create directories** - Upload files to nested paths automatically
 - **Streaming support** - Memory-efficient downloads for large files
-- **Full FTP support** - Upload, download, list, delete, rename, stat, and more
+- **Full FTP support** - Upload, download, list, delete, rename, chmod, stat, and more
+- **Debug mode** - See all FTP commands and responses in real-time
 
 ## Installation
 
@@ -83,11 +90,13 @@ await client.upload('content', '/deep/path/file.txt', true); // Auto-create dirs
 const data = await client.download('/path/file.txt');
 ```
 
-#### `downloadStream(remotePath, writeStream)` → `number` (bytes)
+#### `downloadStream(remotePath, writeStream)` → `number`
+Stream download directly to a writable stream (for saving to disk or processing chunks).
 ```javascript
 const fs = require('fs');
-const stream = fs.createWriteStream('./local.bin');
-const bytes = await client.downloadStream('/remote.bin', stream);
+const fileStream = fs.createWriteStream('./local-file.bin');
+const bytes = await client.downloadStream('/remote.bin', fileStream);
+console.log(`Saved ${bytes} bytes to disk`);
 ```
 
 #### `delete(path)`
@@ -95,6 +104,13 @@ const bytes = await client.downloadStream('/remote.bin', stream);
 await client.delete('/path/file.txt');
 ```
 
+#### `removeDir(path, recursive)`
+Remove directory, optionally with all contents.
+```javascript
+await client.removeDir('/path/emptydir');           // Remove empty directory
+await client.removeDir('/path/dir', true);          // Delete recursively with contents
+```
+
 #### `rename(from, to)`
 ```javascript
 await client.rename('/old.txt', '/new.txt');
@@ -117,13 +133,37 @@ const info = await client.stat('/path/file.txt');
 const bytes = await client.size('/path/file.txt');
 ```
 
+#### `modifiedTime(path)` → `Date`
+```javascript
+const date = await client.modifiedTime('/path/file.txt');
+```
+
+#### `chmod(path, mode)`
+Change file permissions (Unix/Linux servers only).
+```javascript
+await client.chmod('/path/file.txt', '755');    // String format
+await client.chmod('/path/script.sh', 0755);    // Octal format
+```
+
 ### Directory Methods
 
 #### `list(path)` → `string`
+Raw directory listing.
 ```javascript
 const listing = await client.list('/path');
 ```
 
+#### `listDetailed(path)` → `Array`
+Parsed directory listing with permissions, owner, size, etc.
+```javascript
+const files = await client.listDetailed('/path');
+// [
+//   { name: 'file.txt', type: 'file', permissions: '-rw-r--r--', 
+//     owner: 'user', group: 'group', size: 1024, date: 'Jan 15 10:30' },
+//   { name: 'subdir', type: 'directory', permissions: 'drwxr-xr-x', ... }
+// ]
+```
+
 #### `mkdir(path)`
 ```javascript
 await client.mkdir('/path/newdir');
@@ -166,6 +206,13 @@ Toggle debug mode at runtime.
 client.setDebug(true);
 ```
 
+#### `site(command)` → `Object`
+Execute server-specific SITE commands.
+```javascript
+await client.site('CHMOD 755 /path/file.txt');  // Alternative chmod
+const response = await client.site('HELP');      // Get server help
+```
+
 ## Events
 
 ```javascript
@@ -198,13 +245,15 @@ TCP optimizations are automatically applied:
 - **TCP_NODELAY** - Disables Nagle's algorithm for lower latency
 - **Keep-alive** - Detects dead connections (10s interval)
 
-For large files, use `downloadStream()` for memory-efficient transfers:
+**Typical transfer speeds:** ~2.5 MB/s for 1MB files over standard internet connections.
+
+For large files, use `downloadStream()` to save directly to disk without buffering in memory:
 
 ```javascript
 const fs = require('fs');
-const stream = fs.createWriteStream('./large.zip');
-const bytes = await client.downloadStream('/backup.zip', stream);
-console.log(`Downloaded ${bytes} bytes`);
+const fileStream = fs.createWriteStream('./large-backup.zip');
+const bytes = await client.downloadStream('/backup.zip', fileStream);
+console.log(`Saved ${bytes} bytes to disk`);
 ```
 
 ## Error Handling

package/lib/FTPClient.js

@@ -165,6 +165,17 @@ class FTPClient extends EventEmitter
     return this._commands.delete(path);
   }
 
+  /**
+   * Remove directory
+   * @param {string} path - Directory path
+   * @param {boolean} recursive - Delete all contents recursively (default: false)
+   * @returns {Promise<void>}
+   */
+  async removeDir(path, recursive = false)
+  {
+    return this._commands.removeDir(path, recursive);
+  }
+
   /**
    * Rename file
    * @param {string} from - Current name
@@ -242,6 +253,26 @@ class FTPClient extends EventEmitter
     };
   }
 
+  /**
+   * Get current client state for debugging
+   * @returns {Object}
+   */
+  getState()
+  {
+    return {
+      connected: this.connected,
+      authenticated: this.authenticated,
+      host: this._connection?.host || null,
+      port: this._connection?.port || null,
+      user: this._connection?.user || null,
+      commandCount: this._commandCount,
+      lastCommand: this._lastCommand,
+      timeout: this.timeout,
+      debug: this.debug,
+      keepAlive: this.keepAlive
+    };
+  }
+
   /**
    * Check if connected and authenticated
    * @returns {boolean}
@@ -261,6 +292,37 @@ class FTPClient extends EventEmitter
     this._debug(`Debug mode ${enabled ? 'enabled' : 'disabled'}`);
   }
 
+  /**
+   * Change file permissions (Unix/Linux servers only)
+   * @param {string} path - File or directory path
+   * @param {string|number} mode - Permissions (e.g., '755', 0755)
+   * @returns {Promise<void>}
+   */
+  async chmod(path, mode)
+  {
+    return this._commands.chmod(path, mode);
+  }
+
+  /**
+   * Execute a SITE command (server-specific commands)
+   * @param {string} command - SITE command to execute
+   * @returns {Promise<Object>}
+   */
+  async site(command)
+  {
+    return this._commands.site(command);
+  }
+
+  /**
+   * Get detailed directory listing with permissions, owner, size, etc.
+   * @param {string} path - Directory path
+   * @returns {Promise<Array>}
+   */
+  async listDetailed(path = '.')
+  {
+    return this._commands.listDetailed(path);
+  }
+
   /**
    * Close connection
    * @returns {Promise<void>}

package/lib/commands.js

@@ -36,7 +36,9 @@ class FTPCommands {
         if (!commandSent) {
           commandSent = true;
           this.client._debug(`Data connection established for upload`);
-          this.connection.sendCommand(`STOR ${remotePath}`, true).catch(reject);
+          // Just send command, don't wait for completion
+          this.client.socket.write(`STOR ${remotePath}\r\n`);
+          this.client._commandCount++;
           
           // Write data to data socket
           this.client.dataSocket.write(buffer);
@@ -47,25 +49,10 @@ class FTPCommands {
       this.client.dataSocket.on('error', reject);
 
       this.client.dataSocket.on('close', () => {
-        // Wait for final response from control socket
-        const finalHandler = (line) => {
-          const code = parseInt(line.substring(0, 3));
-          if (code === 226 || code === 250) {
-            this.client.removeListener('response', finalHandler);
-            this.client._debug(`Upload completed successfully`);
-            resolve();
-          } else if (code >= 400) {
-            this.client.removeListener('response', finalHandler);
-            reject(new Error(`Upload failed - FTP Error ${code}: ${line.substring(4)} (path: ${remotePath})`));
-          }
-        };
-        this.client.on('response', finalHandler);
-        
-        // Timeout if no response
-        setTimeout(() => {
-          this.client.removeListener('response', finalHandler);
-          resolve();
-        }, this.client.timeout || 5000);
+        // Upload complete
+        this.client._debug(`Upload completed successfully`);
+        // Small delay to let 226 response arrive before next command
+        setTimeout(() => resolve(), 10);
       });
     });
   }
@@ -85,46 +72,40 @@ class FTPCommands {
     return new Promise((resolve, reject) => {
       const chunks = [];
       let commandSent = false;
+      let dataComplete = false;
+      let commandComplete = false;
+
+      const checkComplete = () => {
+        if (dataComplete && commandComplete) {
+          const result = Buffer.concat(chunks);
+          this.client._debug(`Download completed: ${result.length} bytes`);
+          resolve(result);
+        }
+      };
 
       this.client.dataSocket = createOptimizedSocket({ host, port }, () => {
         // Send RETR command to start download (expects 150, then 226)
         if (!commandSent) {
           commandSent = true;
           this.client._debug(`Data connection established for download`);
-          this.connection.sendCommand(`RETR ${remotePath}`, true).catch(reject);
+          // Just send command, don't wait for completion - data socket will handle it
+          this.client.socket.write(`RETR ${remotePath}\r\n`);
+          this.client._commandCount++;
         }
       });
 
       this.client.dataSocket.on('data', (chunk) => {
         chunks.push(chunk);
-        this.client._debug(`Received ${chunk.length} bytes`);
       });
 
       this.client.dataSocket.on('error', reject);
 
       this.client.dataSocket.on('close', () => {
-        // Wait for final 226 response
-        const finalHandler = (line) => {
-          const code = parseInt(line.substring(0, 3));
-          if (code === 226 || code === 250) {
-            this.client.removeListener('response', finalHandler);
-            const result = Buffer.concat(chunks);
-            this.client._debug(`Download completed: ${result.length} bytes`);
-            resolve(result);
-          } else if (code >= 400) {
-            this.client.removeListener('response', finalHandler);
-            reject(new Error(`Download failed - FTP Error ${code}: ${line.substring(4)} (path: ${remotePath})`));
-          }
-        };
-        this.client.on('response', finalHandler);
-        
-        // Timeout if no response
-        setTimeout(() => {
-          this.client.removeListener('response', finalHandler);
-          if (chunks.length > 0) {
-            resolve(Buffer.concat(chunks));
-          }
-        }, this.client.timeout || 5000);
+        // Data transfer complete, resolve immediately
+        const result = Buffer.concat(chunks);
+        this.client._debug(`Download completed: ${result.length} bytes`);
+        // Small delay to let 226 response arrive before next command
+        setTimeout(() => resolve(result), 10);
       });
     });
   }
@@ -151,7 +132,9 @@ class FTPCommands {
         if (!commandSent) {
           commandSent = true;
           this.client._debug(`Data connection established for streaming download`);
-          this.connection.sendCommand(`RETR ${remotePath}`, true).catch(reject);
+          // Just send command, don't wait for completion
+          this.client.socket.write(`RETR ${remotePath}\r\n`);
+          this.client._commandCount++;
         }
       });
 
@@ -166,33 +149,11 @@ class FTPCommands {
       });
 
       this.client.dataSocket.on('close', () => {
-        // Wait for final 226 response
-        const finalHandler = (line) => {
-          const code = parseInt(line.substring(0, 3));
-          if (code === 226 || code === 250) {
-            this.client.removeListener('response', finalHandler);
-            writeStream.end();
-            this.client._debug(`Streaming download completed: ${totalBytes} bytes`);
-            resolve(totalBytes);
-          } else if (code >= 400) {
-            this.client.removeListener('response', finalHandler);
-            writeStream.end();
-            reject(new Error(`Download failed - FTP Error ${code}: ${line.substring(4)} (path: ${remotePath})`));
-          }
-        };
-        this.client.on('response', finalHandler);
-        
-        // Timeout if no response
-        setTimeout(() => {
-          this.client.removeListener('response', finalHandler);
-          if (totalBytes > 0) {
-            writeStream.end();
-            resolve(totalBytes);
-          } else {
-            writeStream.end();
-            reject(new Error('Download timeout'));
-          }
-        }, this.client.timeout || 5000);
+        // Streaming complete
+        writeStream.end();
+        this.client._debug(`Streaming download completed: ${totalBytes} bytes`);
+        // Small delay to let 226 response arrive before next command
+        setTimeout(() => resolve(totalBytes), 10);
       });
     });
   }
@@ -213,7 +174,9 @@ class FTPCommands {
       this.client.dataSocket = createOptimizedSocket({ host, port }, () => {
         if (!commandSent) {
           commandSent = true;
-          this.connection.sendCommand(`LIST ${path}`, true).catch(reject);
+          // Just send command, don't wait for completion
+          this.client.socket.write(`LIST ${path}\r\n`);
+          this.client._commandCount++;
         }
       });
 
@@ -224,21 +187,9 @@ class FTPCommands {
       this.client.dataSocket.on('error', reject);
 
       this.client.dataSocket.on('close', () => {
-        // Wait for final 226 response
-        const finalHandler = (line) => {
-          const code = parseInt(line.substring(0, 3));
-          if (code === 226 || code === 250) {
-            this.client.removeListener('response', finalHandler);
-            resolve(Buffer.concat(chunks).toString('utf8'));
-          }
-        };
-        this.client.on('response', finalHandler);
-        
-        // Timeout fallback
-        setTimeout(() => {
-          this.client.removeListener('response', finalHandler);
-          resolve(Buffer.concat(chunks).toString('utf8'));
-        }, this.client.timeout || 3000);
+        // Data transfer complete, resolve immediately
+        // Small delay to let 226 response arrive before next command
+        setTimeout(() => resolve(Buffer.concat(chunks).toString('utf8')), 10);
       });
     });
   }
@@ -280,6 +231,57 @@ class FTPCommands {
     await this.connection.sendCommand(`DELE ${path}`);
   }
 
+  /**
+   * Remove directory
+   * @param {string} path - Directory path
+   * @param {boolean} recursive - Delete all contents recursively (default: false)
+   * @returns {Promise<void>}
+   */
+  async removeDir(path, recursive = false) {
+    if (!recursive) {
+      // Remove empty directory only
+      await this.connection.sendCommand(`RMD ${path}`);
+      return;
+    }
+
+    // Recursive delete - get contents and delete everything
+    try {
+      const listing = await this.list(path);
+      const lines = listing.split('\n').filter(line => line.trim());
+      
+      // Process each line - faster than listDetailed
+      for (const line of lines) {
+        // Skip . and .. and empty lines
+        if (!line || line.includes(' .') || line.includes(' ..')) continue;
+        
+        // Extract filename (last part of line)
+        const parts = line.trim().split(/\s+/);
+        const name = parts[parts.length - 1];
+        if (name === '.' || name === '..') continue;
+        
+        const fullPath = `${path}/${name}`.replace(/\/+/g, '/');
+        const isDir = line.startsWith('d');
+        
+        if (isDir) {
+          // Directory - recurse
+          await this.removeDir(fullPath, true);
+        } else {
+          // File - delete
+          try {
+            await this.delete(fullPath);
+          } catch (err) {
+            this.client._debug(`Could not delete file ${fullPath}: ${err.message}`);
+          }
+        }
+      }
+      
+      // Remove the now-empty directory
+      await this.connection.sendCommand(`RMD ${path}`);
+    } catch (err) {
+      throw new Error(`Failed to remove directory ${path}: ${err.message}`);
+    }
+  }
+
   /**
    * Rename file
    * @param {string} from - Current name
@@ -406,6 +408,71 @@ class FTPCommands {
     const response = await this.connection.sendCommand(`MDTM ${path}`);
     return parseMdtmResponse(response.message);
   }
+
+  /**
+   * Change file permissions (Unix/Linux servers only)
+   * @param {string} path - File or directory path
+   * @param {string|number} mode - Permissions (e.g., '755', 0755, or 'rwxr-xr-x')
+   * @returns {Promise<void>}
+   */
+  async chmod(path, mode) {
+    // Convert numeric mode to octal string if needed
+    const modeStr = typeof mode === 'number' ? mode.toString(8) : String(mode).replace(/[^0-7]/g, '');
+    
+    if (!/^[0-7]{3,4}$/.test(modeStr)) {
+      throw new Error(`Invalid chmod mode: ${mode}. Use octal format like '755' or 0755`);
+    }
+
+    this.client._debug(`Changing permissions of ${path} to ${modeStr}`);
+    await this.connection.sendCommand(`SITE CHMOD ${modeStr} ${path}`);
+  }
+
+  /**
+   * Execute a SITE command (server-specific commands)
+   * @param {string} command - SITE command to execute (without 'SITE' prefix)
+   * @returns {Promise<Object>}
+   */
+  async site(command) {
+    this.client._debug(`Executing SITE command: ${command}`);
+    return await this.connection.sendCommand(`SITE ${command}`);
+  }
+
+  /**
+   * Parse directory listing into structured objects
+   * @param {string} path - Directory path
+   * @returns {Promise<Array>} Array of file/directory objects
+   */
+  async listDetailed(path = '.') {
+    const listing = await this.list(path);
+    const lines = listing.split('\n').filter(line => line.trim() && !line.startsWith('total'));
+    
+    return lines.map(line => {
+      // Parse Unix-style LIST format
+      const match = line.match(/^([drwxlst-]{10})\s+(\d+)\s+(\S+)\s+(\S+)\s+(\d+)\s+(\S+\s+\S+\s+\S+)\s+(.+)$/);
+      
+      if (match) {
+        const [, perms, links, owner, group, size, date, name] = match;
+        return {
+          name,
+          type: perms[0] === 'd' ? 'directory' : (perms[0] === 'l' ? 'symlink' : 'file'),
+          permissions: perms,
+          owner,
+          group,
+          size: parseInt(size),
+          date,
+          raw: line
+        };
+      }
+      
+      // Fallback for non-standard formats - try to extract name
+      const parts = line.trim().split(/\s+/);
+      return { 
+        name: parts[parts.length - 1], 
+        type: 'unknown',
+        raw: line 
+      };
+    }).filter(item => item.name && item.name !== '.' && item.name !== '..');
+  }
 }
 
 module.exports = FTPCommands;

package/lib/connection.js

@@ -18,6 +18,11 @@ class FTPConnection {
    * @returns {Promise<void>}
    */
   async connect({ host, port = 21, user = 'anonymous', password = 'anonymous@' }) {
+    // Store connection parameters for getState()
+    this.host = host;
+    this.port = port;
+    this.user = user;
+    
     this.client._debug(`Connecting to ${host}:${port} as ${user}`);
     
     return new Promise((resolve, reject) => {
@@ -171,6 +176,10 @@ class FTPConnection {
       }
       this.client.connected = false;
       this.client.authenticated = false;
+      // Reset connection parameters
+      this.host = null;
+      this.port = null;
+      this.user = null;
       this.client._debug('Connection closed');
     }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "molex-ftp-client",
-  "version": "2.1.0",
+  "version": "2.2.2",
   "description": "Lightweight FTP client using native Node.js TCP sockets (net module) with zero dependencies",
   "main": "index.js",
   "scripts": {
@@ -30,5 +30,8 @@
   "homepage": "https://github.com/tonywied17/molex-ftp-client#readme",
   "engines": {
     "node": ">=12.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
   }
 }

package/test-comprehensive.js

@@ -0,0 +1,235 @@
+const FTPClient = require('./index.js');
+
+// Test configuration
+const CONFIG = {
+  host: '',
+  port: 21,
+  user: '',
+  password: ''
+};
+
+const TEST_DIR = '/molex-ftp-testing';
+
+// Test runner
+async function runTests() {
+  const client = new FTPClient({ 
+    debug: true,
+    timeout: 30000
+  });
+
+  console.log('\n🧪 Starting FTP Client Comprehensive Test Suite\n');
+  console.log('=' .repeat(60));
+
+  try {
+    // Test 1: Connect
+    console.log('\n✅ TEST 1: Connect to FTP server');
+    await client.connect(CONFIG);
+    console.log(`   Connected to ${CONFIG.host}:${CONFIG.port}`);
+
+    // Test 2: Get current directory
+    console.log('\n✅ TEST 2: Get current working directory');
+    const currentDir = await client.pwd();
+    console.log(`   Current directory: ${currentDir}`);
+
+    // Test 3: Create test directory
+    console.log(`\n✅ TEST 3: Create test directory ${TEST_DIR}`);
+    try {
+      await client.mkdir(TEST_DIR);
+      console.log(`   Created ${TEST_DIR}`);
+    } catch (err) {
+      console.log(`   Directory already exists or error: ${err.message}`);
+    }
+
+    // Test 4: Change to test directory
+    console.log(`\n✅ TEST 4: Change to test directory`);
+    await client.cd(TEST_DIR);
+    const newDir = await client.pwd();
+    console.log(`   Changed to: ${newDir}`);
+
+    // Test 5: Upload a text file
+    console.log('\n✅ TEST 5: Upload text file');
+    const testContent = 'Hello from molex-ftp-client!\nTimestamp: ' + new Date().toISOString();
+    await client.upload(testContent, 'test-file.txt');
+    console.log('   Uploaded test-file.txt');
+
+    // Test 6: Upload with auto-directory creation
+    console.log('\n✅ TEST 6: Upload with auto-directory creation');
+    await client.upload('Nested file content', 'subdir/nested/deep.txt', true);
+    console.log('   Uploaded subdir/nested/deep.txt (created directories)');
+
+    // Test 7: Check if file exists
+    console.log('\n✅ TEST 7: Check if file exists');
+    const exists = await client.exists('test-file.txt');
+    console.log(`   test-file.txt exists: ${exists}`);
+
+    // Test 8: Get file stats
+    console.log('\n✅ TEST 8: Get file statistics');
+    const stat = await client.stat('test-file.txt');
+    console.log(`   Stats:`, stat);
+
+    // Test 9: Get file size
+    console.log('\n✅ TEST 9: Get file size');
+    const size = await client.size('test-file.txt');
+    console.log(`   Size: ${size} bytes`);
+
+    // Test 10: Download file
+    console.log('\n✅ TEST 10: Download file');
+    const downloaded = await client.download('test-file.txt');
+    console.log(`   Downloaded ${downloaded.length} bytes`);
+    console.log(`   Content: ${downloaded.toString().substring(0, 50)}...`);
+
+    // Test 11: List directory
+    console.log('\n✅ TEST 11: List directory (raw)');
+    const listing = await client.list('.');
+    console.log(`   Listing:\n${listing.split('\n').slice(0, 5).join('\n')}`);
+
+    // Test 12: List directory detailed
+    console.log('\n✅ TEST 12: List directory (detailed)');
+    const detailedListing = await client.listDetailed('.');
+    console.log(`   Found ${detailedListing.length} items:`);
+    detailedListing.forEach(item => {
+      console.log(`   - ${item.type === 'directory' ? '📁' : '📄'} ${item.name} (${item.permissions || 'N/A'})`);
+    });
+
+    // Test 13: Rename file
+    console.log('\n✅ TEST 13: Rename file');
+    await client.rename('test-file.txt', 'renamed-file.txt');
+    console.log('   Renamed test-file.txt → renamed-file.txt');
+
+    // Test 14: Get modified time
+    console.log('\n✅ TEST 14: Get file modification time');
+    try {
+      const modTime = await client.modifiedTime('renamed-file.txt');
+      console.log(`   Modified: ${modTime}`);
+    } catch (err) {
+      console.log(`   Not supported or error: ${err.message}`);
+    }
+
+    // Test 15: Create multiple directories
+    console.log('\n✅ TEST 15: Create nested directories');
+    await client.mkdir('test-dir-1');
+    await client.mkdir('test-dir-2');
+    await client.ensureDir('deep/nested/structure');
+    console.log('   Created test-dir-1, test-dir-2, and deep/nested/structure');
+
+    // Test 16: Upload file with Buffer
+    console.log('\n✅ TEST 16: Upload file using Buffer');
+    const buffer = Buffer.from('Binary content test', 'utf8');
+    await client.upload(buffer, 'test-dir-1/buffer-test.bin');
+    console.log('   Uploaded buffer-test.bin to test-dir-1');
+
+    // Test 17: Download with stream
+    console.log('\n✅ TEST 17: Download using stream');
+    const { PassThrough } = require('stream');
+    const stream = new PassThrough();
+    const chunks = [];
+    stream.on('data', chunk => chunks.push(chunk));
+    const bytes = await client.downloadStream('renamed-file.txt', stream);
+    console.log(`   Downloaded ${bytes} bytes via stream`);
+
+    // Test 17b: Large file upload/download performance test
+    console.log('\n✅ TEST 17b: Large file performance test');
+    const largeData = Buffer.alloc(1024 * 1024, 'x'); // 1MB file
+    console.log(`   Uploading 1MB file...`);
+    const uploadStart = Date.now();
+    await client.upload(largeData, 'large-test.bin');
+    const uploadTime = Date.now() - uploadStart;
+    console.log(`   Upload: ${(largeData.length / uploadTime / 1024).toFixed(2)} MB/s (${uploadTime}ms)`);
+    
+    console.log(`   Downloading 1MB file...`);
+    const downloadStart = Date.now();
+    const largeDownload = await client.download('large-test.bin');
+    const downloadTime = Date.now() - downloadStart;
+    console.log(`   Download: ${(largeDownload.length / downloadTime / 1024).toFixed(2)} MB/s (${downloadTime}ms)`);
+    
+    await client.delete('large-test.bin');
+    console.log(`   Cleaned up large-test.bin`);
+
+    // Test 18: Try chmod (may not work on all servers)
+    console.log('\n✅ TEST 18: Change file permissions (chmod)');
+    try {
+      await client.chmod('renamed-file.txt', '644');
+      console.log('   Changed permissions to 644');
+    } catch (err) {
+      console.log(`   Not supported or error: ${err.message}`);
+    }
+
+    // Test 19: Execute SITE command
+    console.log('\n✅ TEST 19: Execute SITE command');
+    try {
+      const response = await client.site('HELP');
+      console.log(`   SITE HELP response: ${response.message.substring(0, 50)}...`);
+    } catch (err) {
+      console.log(`   Not supported or error: ${err.message}`);
+    }
+
+    // Test 20: Check connection state
+    console.log('\n✅ TEST 20: Get client state');
+    const state = client.getStats();
+    console.log(`   Connected: ${state.connected}, Authenticated: ${state.authenticated}`);
+    console.log(`   Commands executed: ${state.commandCount}`);
+
+    // Test 21: Delete single file
+    console.log('\n✅ TEST 21: Delete single file');
+    await client.delete('test-dir-1/buffer-test.bin');
+    console.log('   Deleted buffer-test.bin');
+
+    // Test 22: Remove empty directory
+    console.log('\n✅ TEST 22: Remove empty directory');
+    await client.removeDir('test-dir-1');
+    console.log('   Removed test-dir-1');
+
+    // Test 23: Remove directory recursively
+    console.log('\n✅ TEST 23: Remove directory recursively');
+    await client.removeDir('subdir', true);
+    console.log('   Recursively removed subdir and all contents');
+
+    // Test 24: Final directory listing
+    console.log('\n✅ TEST 24: Final directory listing');
+    const finalListing = await client.listDetailed('.');
+    console.log(`   Items remaining: ${finalListing.length}`);
+
+    // Cleanup: Remove test directory
+    console.log('\n🧹 CLEANUP: Removing test directory');
+    await client.cd('..');
+    await client.removeDir(TEST_DIR, true);
+    console.log(`   Removed ${TEST_DIR} and all contents`);
+
+    // Close connection
+    console.log('\n✅ Closing connection');
+    await client.close();
+    console.log('   Connection closed');
+
+    console.log('\n' + '='.repeat(60));
+    console.log('🎉 ALL TESTS PASSED!');
+    console.log('='.repeat(60) + '\n');
+
+  } catch (err) {
+    console.error('\n❌ TEST FAILED:', err.message);
+    console.error('Stack:', err.stack);
+    
+    // Try to cleanup and close
+    try {
+      console.log('\n🧹 Attempting cleanup...');
+      await client.cd('/');
+      try {
+        await client.removeDir(TEST_DIR, true);
+        console.log('   Cleaned up test directory');
+      } catch (e) {
+        console.log('   Could not clean up:', e.message);
+      }
+      await client.close();
+    } catch (e) {
+      console.log('   Could not close connection:', e.message);
+    }
+    
+    process.exit(1);
+  }
+}
+
+// Run the tests
+console.log('Starting comprehensive FTP client tests...');
+runTests().catch(err => {
+  console.error('Fatal error:', err);
+  process.exit(1);
+});

package/benchmark.js

@@ -1,86 +0,0 @@
-/**
- * Performance benchmark for FTP client
- * Compare different performance presets
- */
-
-const FTPClient = require('./index.js');
-
-async function benchmark() {
-  const testData = 'x'.repeat(50000); // 50KB test data
-  const presets = ['DEFAULT', 'LOW_LATENCY', 'HIGH_THROUGHPUT', 'BALANCED'];
-  
-  console.log('\n=== FTP Client Performance Benchmark ===\n');
-  console.log('Test data size:', testData.length, 'bytes\n');
-
-  for (const preset of presets) {
-    console.log(`Testing ${preset} preset...`);
-    
-    const client = new FTPClient({
-      debug: false,
-      timeout: 60000,
-      performancePreset: preset
-    });
-
-    try {
-      // Connect
-      const connectStart = Date.now();
-      await client.connect({
-        host: 'ftp.example.com',
-        port: 21,
-        user: 'username',
-        password: 'password'
-      });
-      const connectTime = Date.now() - connectStart;
-
-      // Upload
-      const uploadStart = Date.now();
-      await client.upload(testData, '/benchmark-test.txt', true);
-      const uploadTime = Date.now() - uploadStart;
-
-      // Download
-      const downloadStart = Date.now();
-      const data = await client.download('/benchmark-test.txt');
-      const downloadTime = Date.now() - downloadStart;
-
-      // Cleanup
-      await client.delete('/benchmark-test.txt');
-      await client.close();
-
-      console.log(`  Connect:  ${connectTime}ms`);
-      console.log(`  Upload:   ${uploadTime}ms`);
-      console.log(`  Download: ${downloadTime}ms`);
-      console.log(`  Total:    ${connectTime + uploadTime + downloadTime}ms`);
-      console.log('');
-
-    } catch (err) {
-      console.error(`  Error: ${err.message}\n`);
-      await client.close();
-    }
-
-    // Wait between tests
-    await new Promise(resolve => setTimeout(resolve, 1000));
-  }
-
-  console.log('=== Benchmark Complete ===\n');
-  console.log('Recommendation:');
-  console.log('  - Use LOW_LATENCY for small files (< 1MB)');
-  console.log('  - Use HIGH_THROUGHPUT for large files (> 10MB)');
-  console.log('  - Use BALANCED for mixed workloads\n');
-}
-
-// Only run if called directly
-if (require.main === module) {
-  console.log('\n⚠️  Update the benchmark() function with your FTP credentials to test.\n');
-  console.log('Example:');
-  console.log('  await client.connect({');
-  console.log('    host: "ftp.example.com",');
-  console.log('    port: 21,');
-  console.log('    user: "username",');
-  console.log('    password: "password"');
-  console.log('  });\n');
-  
-  // Uncomment to run benchmark:
-  // benchmark();
-}
-
-module.exports = benchmark;