d-drive-cli 2.2.2 → 2.2.3

package/README.md

@@ -70,7 +70,7 @@ drive config -l
 #### Upload
 
 ```bash
-# Upload single file
+# Upload single file (encrypted by default)
 drive upload ./file.txt
 
 # Upload to specific folder
@@ -78,21 +78,22 @@ drive upload ./file.txt /backups/
 
 # Upload directory recursively
 drive upload ./myproject /backups/ -r
-
-# Upload with encryption
-drive upload ./sensitive.txt -e
 ```
 
+> **Note:** All CLI uploads are **encrypted by default** for security. Files are encrypted server-side using AES-256-GCM encryption before storage.
+
 #### Download
 
 ```bash
-# Download file
+# Download file (automatically decrypted)
 drive download /backups/file.txt
 
 # Download to specific location
 drive download /backups/file.txt ./local-file.txt
 ```
 
+> **Note:** Encrypted files are automatically decrypted during download.
+
 #### List
 
 ```bash
@@ -108,15 +109,14 @@ drive ls /backups -l
 ```
 
 #### Delete
-
-```bash
-# Delete file (with confirmation)
+, moves to recycle bin)
 drive rm /old-file.txt
 
 # Force delete without confirmation
 drive rm /old-file.txt -f
+```
 
-# Delete directory recursively
+> **Note:** Deleted files are moved to the recycle bin and can be restored via the web interface. The `-r` flag is accepted but directory deletion operates the same way (moves entire directory to recycle bin).elete directory recursively
 drive rm /old-folder -r
 ```
 
@@ -129,26 +129,45 @@ drive cp /backups/file.txt
 ```
 
 ### Task Management
-
-D-Drive supports SFTP backup tasks that can be managed via CLI.
+ Tasks run on a schedule (cron) to automatically backup files from remote SFTP servers.
 
 ```bash
-# List all tasks
+# List all tasks with status
 drive tasks ls
 
-# Run a task immediately
+# Run a task immediately (ignores schedule)
 drive tasks run <task-id>
 
 # Stop a running task
 drive tasks stop <task-id>
 
-# Enable/disable a task
+# Enable a task (allows scheduled runs)
 drive tasks enable <task-id>
+
+# Disable a task (prevents scheduled runs)
 drive tasks disable <task-id>
 
-# Delete a task
+# Delete a task (with confirmation)
 drive tasks rm <task-id>
-drive tasks rm <task-id> -f  # Force delete
+
+# Force delete without confirmation
+drive tasks rm <task-id> -f
+```
+
+**Task List Output:**
+```
+📋 SFTP Backup Tasks:
+────────────────────────────────────────────────────────
+ID: clmxyz123...
+Name: Daily Backup
+Status: ✓ Running (5m 23s) | ⏸ Stopped | ✓ Enabled
+Schedule: 0 2 * * * (daily at 2:00 AM)
+SFTP: user@server.example.com:22 → /backups/
+Compression: GZIP | Keep: 5 files
+────────────────────────────────────────────────────────
+```
+
+> **Note:** Tasks can only be created/edited via the web interface. The CLI allows management and execution only.ve tasks rm <task-id> -f  # Force delete
 ```
 
 ### Info & Status
@@ -194,10 +213,10 @@ Interactive mode provides a menu-driven interface for all operations.
 ### Backup a Project
 
 ```bash
-# Create a backup of your project
+# Create an encrypted backup of your project
 drive upload ./my-project /backups/my-project/ -r
 
-# List backups
+# List backups with details
 drive ls /backups/my-project -l
 ```
 
@@ -205,29 +224,207 @@ drive ls /backups/my-project -l
 
 ```bash
 #!/bin/bash
-# backup.sh
+# backup.sh - Daily project backup
 
 DATE=$(date +%Y-%m-%d)
-drive upload ./data "/backups/$DATE/"
-echo "Backup completed: $DATE"
+PROJECT_NAME="my-app"
+
+echo "Starting backup for $PROJECT_NAME on $DATE..."
+
+# Upload with automatic encryption
+drive upload ./ "/backups/$PROJECT_NAME/$DATE/" -r
+
+if [ $? -eq 0 ]; then
+  echo "✓ Backup completed successfully: $DATE"
+  
+  # List to verify
+  drive ls "/backups/$PROJECT_NAME/" -l
+else
+  echo "✗ Backup failed!"
+  exit 1
+fi
+```configure the CLI using environment variables instead of `drive config`:
+
+```bash
+# Set in your shell profile (~/.bashrc, ~/.zshrc, etc.)
+export DDRIVE_API_KEY=dd_your_api_key_here
+export DDRIVE_API_URL=https://your-server/api
+
+# Or use inline for single commands
+DDRIVE_API_KEY=dd_key123 drive ls /
 ```
 
-### Download and Restore
+**Variables:**
+- `DDRIVE_API_KEY` - Your D-Drive API key (starts with `dd_`)
+- `DDRIVE_API_URL` - API base URL (default: `https://localhost/api`)
+
+**Priority:**
+1. Environment variables (highest)
+2. Config file (`~/.ddrive-cli-config`)
+3. Default values (lowest)
 
+**View current configuration:**
 ```bash
+drive config --list
+# List available backups
+drive ls /backups/ -l
+
 # Download latest backup
 drive download /backups/2026-01-24/data.tar.gz ./restore/
 
 # Extract
-tar -xzf ./restore/data.tar.gz
+tar -xzf ./restore/data.tar.gz -C ./restore/
+
+echo "Restore complete!"
+```
+
+### Monitor Task Status
+
+```bash
+#!/bin/bash
+# check-tasks.sh - Monitor backup task status
+
+echo "Checking SFTP backup tasks..."
+drive tasks ls
+
+# Run a specific task
+TASK_ID="clmxyz123..."
+echo "Running task $TASK_ID..."
+drive tasks run $TASK_ID
+**Causes:**
+- Server is not running
+- Incorrect API URL
+- Network/firewall issues
+- SSL/TLS certificate problems
+
+**Solutions:**
+```bash
+# Check your configuration
+drive config --list
+
+# Test with correct URL (include /api path)
+drive config --url https://your-server/api
+
+# Verify server is accessible
+curl https://your-server/api/setup/status
+
+# For local development with self-signed certs
+export NODE_TLS_REJECT_UNAUTHORIZED=0  # Not recommended for production!
+```
+
+### "Invalid API key"
+**Causes:**
+- API key is incorrect or expired
+- Missing `dd_` prefix
+- Extra spaces or characters
+
+**Solutions:**
+```bash
+# Generate a new API key:
+# 1. Open D-Drive web interface
+# 2. Go to Settings → API Keys
+# 3. Click "Create API Key"
+# 4. Copy the full key (including dd_ prefix)
+
+# Configure with new key
+drive config --key dd_your_new_key_here
+
+# Verify it works
+drive info
 ```
 
-## Environment Variables
+### "Permission denied"
+**Causes:**
+- Using wrong account/API key
+- File/folder doesn't belong to you
+- Insufficient permissions
+
+**Solutions:**
+```bash
+# Check which user you're authenticated as
+drive info
+
+# Ensure you're using the correct API key
+drive config --list
+```
+
+### "File not found" when listing nested folders
+**Causes:**
+- Folder path typo
+- Folder doesn't exist
+- Path should start with /
+
+**Solutions:**
+```bash
+# List root to see available folders
+drive ls /
+
+# Use absolute paths
+drive ls /backups/subfolder
+
+# Use long format to see full paths
+drive ls / -l
+```
+
+### Upload/Download Progress Not Showing
+**Causes:**
+- File is too small (progress skipped)
+- Terminal doesn't support progress bars
+
+**Solutions:**
+- Progress bars automatically appear for larger files
+- Check that your terminal supports ANSI escape codes
+- Try in a different terminal (iTerm2, gnome-terminal, etc.)
 
-You can also configure the CLI using environment variables:
+### Task Won't Run
+**Causes:**
+- Task is disabled
+- Another task instance is already running
+- SFTP credentials are invalid
+- Network connectivity issues
 
+**Solutions:**
 ```bash
-export DDRIVE_API_KEY=dd_your_api_key
+# Check task status
+drive tasks ls
+
+# Enable if disabled
+drive tasks enable <task-id>
+
+# If shows "Running" but stuck, stop and restart
+drive tasks stop <task-id>
+drive tasks run <task-id>
+
+# Check server logs for detailed errors
+```
+
+### npm Installation Issues
+**MacOS/Linux:**
+```bash
+# Permission errors - use one of these methods:
+
+# Method 1: Install globally with correct permissions
+sudo npm install -g d-drive-cli
+
+# Method 2: Use npx (no installation needed)
+npx d-drive-cli ls /
+
+# Method 3: Configure npm to use different directory
+mkdir ~/.npm-global
+npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
+npm install -g d-drive-cli
+```
+
+**Windows:**
+```powershell
+# Run PowerShell as Administrator
+npm install -g d-drive-cli
+
+# Or use npx
+npx d-drive-cli ls /
+```
 export DDRIVE_API_URL=https://your-server/api
 ```
 
@@ -249,6 +446,14 @@ export DDRIVE_API_URL=https://your-server/api
 
 ## Changelog
 
+### v2.2.3
+- **Bug fixes:**
+  - Fixed nested folder path resolution in `list` command
+  - Improved API key validation (now uses `/auth/me` endpoint)
+  - Added directory deletion warning message
+  - Better error messages for directory download attempts
+- **Documentation:** Enhanced CLI README and API docs
+
 ### v2.2.2
 - **ACTUALLY** fixed double output issue (previous v2.2.1 had wrong fix)
 - Added `process.exit(0)` after help display to prevent Commander.js duplicate

package/dist/commands/config.js

@@ -26,8 +26,8 @@ async function configCommand(options) {
             // Accept keys entered with or without the `dd_` prefix, and strip any accidental "Bearer " prefix
             const rawKey = options.key.replace(/^Bearer\s+/i, '').trim();
             const normalizedKey = rawKey.startsWith('dd_') ? rawKey : `dd_${rawKey}`;
-            // Validate API key by calling a protected endpoint that accepts API keys (authenticate middleware)
-            const validateUrl = apiUrl.replace(/\/$/, '') + '/api-keys';
+            // Validate API key by calling /auth/me endpoint (simpler and more reliable)
+            const validateUrl = apiUrl.replace(/\/$/, '') + '/auth/me';
             const response = await axios_1.default.get(validateUrl, {
                 headers: {
                     Authorization: `Bearer ${normalizedKey}`,

package/dist/commands/delete.js

@@ -23,6 +23,10 @@ async function deleteCommand(remotePath, options) {
         }
         const file = files[0];
         spinner.stop();
+        // Warn if trying to delete a directory
+        if (file.type === 'DIRECTORY') {
+            console.log(chalk_1.default.yellow('Warning: This is a directory. All contents will be moved to recycle bin.'));
+        }
         // Confirm deletion
         if (!options.force) {
             const answers = await inquirer_1.default.prompt([

package/dist/commands/download.js

@@ -26,6 +26,8 @@ async function downloadCommand(source, destination = './', options) {
         const file = files[0];
         if (file.type === 'DIRECTORY') {
             spinner.fail(chalk_1.default.red('Cannot download directories yet'));
+            console.log(chalk_1.default.gray('Tip: Download individual files from the directory instead.'));
+            console.log(chalk_1.default.gray('Use: drive ls ' + source + ' -l'));
             return;
         }
         spinner.text = 'Downloading...';

package/dist/commands/list.js

@@ -61,13 +61,22 @@ async function listCommand(remotePath = '/', options) {
     }
 }
 function findFolderByPath(files, targetPath) {
-    // Simple path matching - looks for folder by name in the path
-    const pathParts = targetPath.split('/').filter(p => p);
+    // Build full path for each file and match against target
+    const normalizedTarget = targetPath.startsWith('/') ? targetPath : '/' + targetPath;
     for (const file of files) {
-        if (file.type === 'DIRECTORY' && file.name === pathParts[0]) {
+        if (file.type === 'DIRECTORY' && file.path === normalizedTarget) {
             return file;
         }
     }
+    // Fallback: try matching by name only (for root-level folders)
+    const pathParts = targetPath.split('/').filter(p => p);
+    if (pathParts.length === 1) {
+        for (const file of files) {
+            if (file.type === 'DIRECTORY' && file.name === pathParts[0]) {
+                return file;
+            }
+        }
+    }
     return null;
 }
 function formatFileSize(bytes) {

package/dist/index.js

@@ -20,8 +20,8 @@ const program = new commander_1.Command();
 // ASCII art banner
 const banner = `
 ${chalk_1.default.cyan('╔═══════════════════════════════════════╗')}
-${chalk_1.default.cyan('║')}  ${chalk_1.default.bold.white('D-Drive CLI')} ${chalk_1.default.gray('v' + (pkg.version || '2.2.0'))}              ${chalk_1.default.cyan('║')}
-${chalk_1.default.cyan('║')}  ${chalk_1.default.gray('Discord-based cloud storage')}         ${chalk_1.default.cyan('║')}
+${chalk_1.default.cyan('║')}  ${chalk_1.default.bold.white('D-Drive CLI')} ${chalk_1.default.gray('v' + (pkg.version || '2.2.0'))}              ${chalk_1.default.cyan('    ║')}
+${chalk_1.default.cyan('║')}  ${chalk_1.default.gray('Discord-based cloud storage')}         ${chalk_1.default.cyan(' ║')}
 ${chalk_1.default.cyan('╚═══════════════════════════════════════╝')}
 `;
 program

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "d-drive-cli",
-  "version": "2.2.2",
+  "version": "2.2.3",
   "description": "D-Drive CLI tool for developers - Discord cloud storage",
   "main": "dist/index.js",
   "bin": {
@@ -21,23 +21,23 @@
   "author": "jasonzli-DEV",
   "license": "MIT",
   "dependencies": {
-    "commander": "^11.1.0",
     "axios": "^1.6.5",
     "chalk": "^4.1.2",
-    "ora": "^5.4.1",
+    "commander": "^11.1.0",
     "conf": "^10.2.0",
-    "inquirer": "^8.2.6",
     "form-data": "^4.0.0",
     "fs-extra": "^11.2.0",
     "glob": "^10.3.10",
+    "inquirer": "^8.2.6",
+    "ora": "^5.4.1",
     "progress": "^2.0.3"
   },
   "devDependencies": {
-    "@types/node": "^20.10.7",
-    "@types/inquirer": "^8.2.10",
     "@types/fs-extra": "^11.0.4",
+    "@types/inquirer": "^8.2.10",
+    "@types/node": "^20.10.7",
     "@types/progress": "^2.0.7",
-    "typescript": "^5.3.3",
-    "ts-node": "^10.9.2"
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3"
   }
 }

package/src/commands/config.ts

@@ -31,8 +31,8 @@ export async function configCommand(options: ConfigOptions) {
       const rawKey = options.key.replace(/^Bearer\s+/i, '').trim();
       const normalizedKey = rawKey.startsWith('dd_') ? rawKey : `dd_${rawKey}`;
 
-      // Validate API key by calling a protected endpoint that accepts API keys (authenticate middleware)
-      const validateUrl = apiUrl.replace(/\/$/, '') + '/api-keys';
+      // Validate API key by calling /auth/me endpoint (simpler and more reliable)
+      const validateUrl = apiUrl.replace(/\/$/, '') + '/auth/me';
       const response = await axios.get(validateUrl, {
         headers: {
           Authorization: `Bearer ${normalizedKey}`,

package/src/commands/delete.ts

@@ -28,6 +28,11 @@ export async function deleteCommand(remotePath: string, options: DeleteOptions)
     const file = files[0];
     spinner.stop();
 
+    // Warn if trying to delete a directory
+    if (file.type === 'DIRECTORY') {
+      console.log(chalk.yellow('Warning: This is a directory. All contents will be moved to recycle bin.'));
+    }
+
     // Confirm deletion
     if (!options.force) {
       const answers = await inquirer.prompt([

package/src/commands/download.ts

@@ -34,6 +34,8 @@ export async function downloadCommand(
 
     if (file.type === 'DIRECTORY') {
       spinner.fail(chalk.red('Cannot download directories yet'));
+      console.log(chalk.gray('Tip: Download individual files from the directory instead.'));
+      console.log(chalk.gray('Use: drive ls ' + source + ' -l'));
       return;
     }
 

package/src/commands/list.ts

@@ -71,14 +71,25 @@ export async function listCommand(remotePath: string = '/', options: ListOptions
 }
 
 function findFolderByPath(files: any[], targetPath: string): any | null {
-  // Simple path matching - looks for folder by name in the path
-  const pathParts = targetPath.split('/').filter(p => p);
+  // Build full path for each file and match against target
+  const normalizedTarget = targetPath.startsWith('/') ? targetPath : '/' + targetPath;
   
   for (const file of files) {
-    if (file.type === 'DIRECTORY' && file.name === pathParts[0]) {
+    if (file.type === 'DIRECTORY' && file.path === normalizedTarget) {
       return file;
     }
   }
+  
+  // Fallback: try matching by name only (for root-level folders)
+  const pathParts = targetPath.split('/').filter(p => p);
+  if (pathParts.length === 1) {
+    for (const file of files) {
+      if (file.type === 'DIRECTORY' && file.name === pathParts[0]) {
+        return file;
+      }
+    }
+  }
+  
   return null;
 }
 

package/src/index.ts

@@ -18,8 +18,8 @@ const program = new Command();
 // ASCII art banner
 const banner = `
 ${chalk.cyan('╔═══════════════════════════════════════╗')}
-${chalk.cyan('║')}  ${chalk.bold.white('D-Drive CLI')} ${chalk.gray('v' + (pkg.version || '2.2.0'))}              ${chalk.cyan('║')}
-${chalk.cyan('║')}  ${chalk.gray('Discord-based cloud storage')}         ${chalk.cyan('║')}
+${chalk.cyan('║')}  ${chalk.bold.white('D-Drive CLI')} ${chalk.gray('v' + (pkg.version || '2.2.0'))}              ${chalk.cyan('    ║')}
+${chalk.cyan('║')}  ${chalk.gray('Discord-based cloud storage')}         ${chalk.cyan(' ║')}
 ${chalk.cyan('╚═══════════════════════════════════════╝')}
 `;