d-drive-cli 1.3.2 → 2.1.0

package/README.md

@@ -2,6 +2,8 @@
 
 Command-line tool for D-Drive cloud storage.
 
+**Version: 2.0.0 LTS**
+
 ## Installation
 
 ```bash
@@ -156,6 +158,69 @@ Upload build artifacts from CI/CD:
 - `-f, --force` - Force deletion without confirmation
 - `-r, --recursive` - Delete directory recursively
 
+---
+
+## Task Management
+
+D-Drive supports automated SFTP backup tasks. Use the CLI to manage them:
+
+### List Tasks
+
+```bash
+d-drive tasks list
+# or
+d-drive tasks ls
+```
+
+### Run a Task Immediately
+
+```bash
+d-drive tasks run <taskId>
+```
+
+### Stop a Running Task
+
+```bash
+d-drive tasks stop <taskId>
+```
+
+### Enable/Disable a Task
+
+```bash
+d-drive tasks enable <taskId>
+d-drive tasks disable <taskId>
+```
+
+### Delete a Task
+
+```bash
+d-drive tasks delete <taskId>
+
+# Force delete without confirmation
+d-drive tasks delete <taskId> -f
+```
+
+### Task Examples
+
+```bash
+# List all tasks with status
+$ d-drive tasks list
+● Daily Server Backup [RUNNING]
+  ID: abc123
+  Schedule: 0 2 * * *
+  SFTP: backupuser@backup.example.com:22/backups
+  Destination: /backups/server
+  Last Run: 1/20/2026, 2:00:00 AM (2m 15s)
+
+# Run a backup task manually
+$ d-drive tasks run abc123
+
+# Stop a running task
+$ d-drive tasks stop abc123
+```
+
+---
+
 ## License
 
 MIT

package/dist/commands/tasks.d.ts

@@ -0,0 +1,7 @@
+export declare function tasksListCommand(): Promise<void>;
+export declare function taskRunCommand(taskId: string): Promise<void>;
+export declare function taskStopCommand(taskId: string): Promise<void>;
+export declare function taskDeleteCommand(taskId: string, options: {
+    force?: boolean;
+}): Promise<void>;
+export declare function taskEnableCommand(taskId: string, enable: boolean): Promise<void>;

package/dist/commands/tasks.js

@@ -0,0 +1,167 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasksListCommand = tasksListCommand;
+exports.taskRunCommand = taskRunCommand;
+exports.taskStopCommand = taskStopCommand;
+exports.taskDeleteCommand = taskDeleteCommand;
+exports.taskEnableCommand = taskEnableCommand;
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+const api_1 = require("../api");
+async function tasksListCommand() {
+    const spinner = (0, ora_1.default)('Fetching tasks...').start();
+    try {
+        const client = (0, api_1.createApiClient)();
+        const response = await client.get('/tasks');
+        const tasks = response.data;
+        spinner.stop();
+        if (tasks.length === 0) {
+            console.log(chalk_1.default.yellow('No tasks found.'));
+            return;
+        }
+        console.log(chalk_1.default.bold('\nBackup Tasks:\n'));
+        console.log(chalk_1.default.gray('─'.repeat(80)));
+        for (const task of tasks) {
+            const status = task.enabled ? chalk_1.default.green('●') : chalk_1.default.red('○');
+            const isRunning = task.lastStarted && (!task.lastRun || new Date(task.lastStarted) > new Date(task.lastRun));
+            const runStatus = isRunning ? chalk_1.default.blue(' [RUNNING]') : '';
+            console.log(`${status} ${chalk_1.default.bold(task.name)}${runStatus}`);
+            console.log(`  ${chalk_1.default.gray('ID:')} ${task.id}`);
+            console.log(`  ${chalk_1.default.gray('Schedule:')} ${task.cron}`);
+            console.log(`  ${chalk_1.default.gray('SFTP:')} ${task.sftpUser}@${task.sftpHost}:${task.sftpPort}${task.sftpPath}`);
+            console.log(`  ${chalk_1.default.gray('Destination:')} ${task.destinationPath || '/'}`);
+            console.log(`  ${chalk_1.default.gray('Compress:')} ${task.compress} | ${chalk_1.default.gray('Max Files:')} ${task.maxFiles || 'unlimited'}`);
+            if (task.lastRun) {
+                const lastRun = new Date(task.lastRun).toLocaleString();
+                const runtime = task.lastRuntime ? ` (${formatRuntime(task.lastRuntime)})` : '';
+                console.log(`  ${chalk_1.default.gray('Last Run:')} ${lastRun}${runtime}`);
+            }
+            console.log(chalk_1.default.gray('─'.repeat(80)));
+        }
+        console.log(chalk_1.default.gray(`\nTotal: ${tasks.length} task(s)`));
+    }
+    catch (error) {
+        spinner.fail('Failed to fetch tasks');
+        console.error(chalk_1.default.red(error.response?.data?.error || error.message));
+        process.exit(1);
+    }
+}
+async function taskRunCommand(taskId) {
+    const spinner = (0, ora_1.default)('Starting task...').start();
+    try {
+        const client = (0, api_1.createApiClient)();
+        const response = await client.post(`/tasks/${taskId}/run`);
+        spinner.succeed(chalk_1.default.green('Task started successfully!'));
+        console.log(chalk_1.default.gray(`Task ID: ${taskId}`));
+    }
+    catch (error) {
+        if (error.response?.status === 409) {
+            spinner.fail(chalk_1.default.yellow('Task is already running'));
+        }
+        else {
+            spinner.fail('Failed to start task');
+        }
+        console.error(chalk_1.default.red(error.response?.data?.error || error.message));
+        process.exit(1);
+    }
+}
+async function taskStopCommand(taskId) {
+    const spinner = (0, ora_1.default)('Stopping task...').start();
+    try {
+        const client = (0, api_1.createApiClient)();
+        await client.post(`/tasks/${taskId}/stop`);
+        spinner.succeed(chalk_1.default.green('Task stopped successfully!'));
+    }
+    catch (error) {
+        spinner.fail('Failed to stop task');
+        console.error(chalk_1.default.red(error.response?.data?.error || error.message));
+        process.exit(1);
+    }
+}
+async function taskDeleteCommand(taskId, options) {
+    try {
+        if (!options.force) {
+            const inquirer = await Promise.resolve().then(() => __importStar(require('inquirer')));
+            const { confirm } = await inquirer.default.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirm',
+                    message: `Are you sure you want to delete task ${taskId}?`,
+                    default: false,
+                },
+            ]);
+            if (!confirm) {
+                console.log(chalk_1.default.yellow('Cancelled.'));
+                return;
+            }
+        }
+        const spinner = (0, ora_1.default)('Deleting task...').start();
+        const client = (0, api_1.createApiClient)();
+        await client.delete(`/tasks/${taskId}`);
+        spinner.succeed(chalk_1.default.green('Task deleted successfully!'));
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(error.response?.data?.error || error.message));
+        process.exit(1);
+    }
+}
+async function taskEnableCommand(taskId, enable) {
+    const action = enable ? 'Enabling' : 'Disabling';
+    const spinner = (0, ora_1.default)(`${action} task...`).start();
+    try {
+        const client = (0, api_1.createApiClient)();
+        await client.patch(`/tasks/${taskId}`, { enabled: enable });
+        spinner.succeed(chalk_1.default.green(`Task ${enable ? 'enabled' : 'disabled'} successfully!`));
+    }
+    catch (error) {
+        spinner.fail(`Failed to ${enable ? 'enable' : 'disable'} task`);
+        console.error(chalk_1.default.red(error.response?.data?.error || error.message));
+        process.exit(1);
+    }
+}
+function formatRuntime(seconds) {
+    if (seconds < 60)
+        return `${seconds}s`;
+    const mins = Math.round(seconds / 60);
+    if (mins < 60)
+        return `${mins}m`;
+    const hours = Math.floor(mins / 60);
+    const remainingMins = mins % 60;
+    return `${hours}h ${remainingMins}m`;
+}

package/dist/index.js

@@ -12,6 +12,7 @@ const download_1 = require("./commands/download");
 const list_1 = require("./commands/list");
 const delete_1 = require("./commands/delete");
 const copy_1 = require("./commands/copy");
+const tasks_1 = require("./commands/tasks");
 const pkg = require('../package.json');
 const program = new commander_1.Command();
 program
@@ -59,6 +60,37 @@ program
     .command('copy <path>')
     .description('Make a copy of a file in-place (auto-numbered)')
     .action(copy_1.copyCommand);
+// Tasks commands
+const tasks = program
+    .command('tasks')
+    .description('Manage backup tasks');
+tasks
+    .command('list')
+    .alias('ls')
+    .description('List all backup tasks')
+    .action(tasks_1.tasksListCommand);
+tasks
+    .command('run <taskId>')
+    .description('Run a task immediately')
+    .action(tasks_1.taskRunCommand);
+tasks
+    .command('stop <taskId>')
+    .description('Stop a running task')
+    .action(tasks_1.taskStopCommand);
+tasks
+    .command('delete <taskId>')
+    .alias('rm')
+    .description('Delete a task')
+    .option('-f, --force', 'Force deletion without confirmation')
+    .action(tasks_1.taskDeleteCommand);
+tasks
+    .command('enable <taskId>')
+    .description('Enable a task')
+    .action((taskId) => (0, tasks_1.taskEnableCommand)(taskId, true));
+tasks
+    .command('disable <taskId>')
+    .description('Disable a task')
+    .action((taskId) => (0, tasks_1.taskEnableCommand)(taskId, false));
 // Help command
 program.on('--help', () => {
     console.log('');
@@ -69,5 +101,13 @@ program.on('--help', () => {
     console.log('  $ d-drive download /backups/file.txt ./restored.txt');
     console.log('  $ d-drive list /backups');
     console.log('  $ d-drive delete /backups/old-file.txt');
+    console.log('');
+    console.log(chalk_1.default.bold('Task Commands:'));
+    console.log('  $ d-drive tasks list              List all backup tasks');
+    console.log('  $ d-drive tasks run <taskId>      Run a task immediately');
+    console.log('  $ d-drive tasks stop <taskId>     Stop a running task');
+    console.log('  $ d-drive tasks enable <taskId>   Enable a task');
+    console.log('  $ d-drive tasks disable <taskId>  Disable a task');
+    console.log('  $ d-drive tasks delete <taskId>   Delete a task');
 });
 program.parse();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "d-drive-cli",
-  "version": "1.3.2",
-  "description": "D-Drive CLI tool for developers",
+  "version": "2.1.0",
+  "description": "D-Drive CLI tool for developers (LTS)",
   "main": "dist/index.js",
   "bin": {
     "d-drive": "./dist/index.js"

package/src/commands/tasks.ts

@@ -0,0 +1,162 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import { createApiClient } from '../api';
+
+interface Task {
+  id: string;
+  name: string;
+  enabled: boolean;
+  cron: string;
+  sftpHost: string;
+  sftpPort: number;
+  sftpUser: string;
+  sftpPath: string;
+  destinationPath?: string;
+  compress: string;
+  maxFiles: number;
+  lastRun?: string;
+  lastStarted?: string;
+  lastRuntime?: number;
+}
+
+export async function tasksListCommand() {
+  const spinner = ora('Fetching tasks...').start();
+  
+  try {
+    const client = createApiClient();
+    const response = await client.get('/tasks');
+    const tasks: Task[] = response.data;
+    
+    spinner.stop();
+    
+    if (tasks.length === 0) {
+      console.log(chalk.yellow('No tasks found.'));
+      return;
+    }
+    
+    console.log(chalk.bold('\nBackup Tasks:\n'));
+    console.log(chalk.gray('─'.repeat(80)));
+    
+    for (const task of tasks) {
+      const status = task.enabled ? chalk.green('●') : chalk.red('○');
+      const isRunning = task.lastStarted && (!task.lastRun || new Date(task.lastStarted) > new Date(task.lastRun));
+      const runStatus = isRunning ? chalk.blue(' [RUNNING]') : '';
+      
+      console.log(`${status} ${chalk.bold(task.name)}${runStatus}`);
+      console.log(`  ${chalk.gray('ID:')} ${task.id}`);
+      console.log(`  ${chalk.gray('Schedule:')} ${task.cron}`);
+      console.log(`  ${chalk.gray('SFTP:')} ${task.sftpUser}@${task.sftpHost}:${task.sftpPort}${task.sftpPath}`);
+      console.log(`  ${chalk.gray('Destination:')} ${task.destinationPath || '/'}`);
+      console.log(`  ${chalk.gray('Compress:')} ${task.compress} | ${chalk.gray('Max Files:')} ${task.maxFiles || 'unlimited'}`);
+      
+      if (task.lastRun) {
+        const lastRun = new Date(task.lastRun).toLocaleString();
+        const runtime = task.lastRuntime ? ` (${formatRuntime(task.lastRuntime)})` : '';
+        console.log(`  ${chalk.gray('Last Run:')} ${lastRun}${runtime}`);
+      }
+      
+      console.log(chalk.gray('─'.repeat(80)));
+    }
+    
+    console.log(chalk.gray(`\nTotal: ${tasks.length} task(s)`));
+    
+  } catch (error: any) {
+    spinner.fail('Failed to fetch tasks');
+    console.error(chalk.red(error.response?.data?.error || error.message));
+    process.exit(1);
+  }
+}
+
+export async function taskRunCommand(taskId: string) {
+  const spinner = ora('Starting task...').start();
+  
+  try {
+    const client = createApiClient();
+    const response = await client.post(`/tasks/${taskId}/run`);
+    
+    spinner.succeed(chalk.green('Task started successfully!'));
+    console.log(chalk.gray(`Task ID: ${taskId}`));
+    
+  } catch (error: any) {
+    if (error.response?.status === 409) {
+      spinner.fail(chalk.yellow('Task is already running'));
+    } else {
+      spinner.fail('Failed to start task');
+    }
+    console.error(chalk.red(error.response?.data?.error || error.message));
+    process.exit(1);
+  }
+}
+
+export async function taskStopCommand(taskId: string) {
+  const spinner = ora('Stopping task...').start();
+  
+  try {
+    const client = createApiClient();
+    await client.post(`/tasks/${taskId}/stop`);
+    
+    spinner.succeed(chalk.green('Task stopped successfully!'));
+    
+  } catch (error: any) {
+    spinner.fail('Failed to stop task');
+    console.error(chalk.red(error.response?.data?.error || error.message));
+    process.exit(1);
+  }
+}
+
+export async function taskDeleteCommand(taskId: string, options: { force?: boolean }) {
+  try {
+    if (!options.force) {
+      const inquirer = await import('inquirer');
+      const { confirm } = await inquirer.default.prompt([
+        {
+          type: 'confirm',
+          name: 'confirm',
+          message: `Are you sure you want to delete task ${taskId}?`,
+          default: false,
+        },
+      ]);
+      
+      if (!confirm) {
+        console.log(chalk.yellow('Cancelled.'));
+        return;
+      }
+    }
+    
+    const spinner = ora('Deleting task...').start();
+    const client = createApiClient();
+    await client.delete(`/tasks/${taskId}`);
+    
+    spinner.succeed(chalk.green('Task deleted successfully!'));
+    
+  } catch (error: any) {
+    console.error(chalk.red(error.response?.data?.error || error.message));
+    process.exit(1);
+  }
+}
+
+export async function taskEnableCommand(taskId: string, enable: boolean) {
+  const action = enable ? 'Enabling' : 'Disabling';
+  const spinner = ora(`${action} task...`).start();
+  
+  try {
+    const client = createApiClient();
+    await client.patch(`/tasks/${taskId}`, { enabled: enable });
+    
+    spinner.succeed(chalk.green(`Task ${enable ? 'enabled' : 'disabled'} successfully!`));
+    
+  } catch (error: any) {
+    spinner.fail(`Failed to ${enable ? 'enable' : 'disable'} task`);
+    console.error(chalk.red(error.response?.data?.error || error.message));
+    process.exit(1);
+  }
+}
+
+function formatRuntime(seconds: number): string {
+  if (seconds < 60) return `${seconds}s`;
+  const mins = Math.round(seconds / 60);
+  if (mins < 60) return `${mins}m`;
+  const hours = Math.floor(mins / 60);
+  const remainingMins = mins % 60;
+  return `${hours}h ${remainingMins}m`;
+}

package/src/index.ts

@@ -8,6 +8,7 @@ import { downloadCommand } from './commands/download';
 import { listCommand } from './commands/list';
 import { deleteCommand } from './commands/delete';
 import { copyCommand } from './commands/copy';
+import { tasksListCommand, taskRunCommand, taskStopCommand, taskDeleteCommand, taskEnableCommand } from './commands/tasks';
 const pkg = require('../package.json');
 
 const program = new Command();
@@ -64,6 +65,44 @@ program
   .description('Make a copy of a file in-place (auto-numbered)')
   .action(copyCommand);
 
+// Tasks commands
+const tasks = program
+  .command('tasks')
+  .description('Manage backup tasks');
+
+tasks
+  .command('list')
+  .alias('ls')
+  .description('List all backup tasks')
+  .action(tasksListCommand);
+
+tasks
+  .command('run <taskId>')
+  .description('Run a task immediately')
+  .action(taskRunCommand);
+
+tasks
+  .command('stop <taskId>')
+  .description('Stop a running task')
+  .action(taskStopCommand);
+
+tasks
+  .command('delete <taskId>')
+  .alias('rm')
+  .description('Delete a task')
+  .option('-f, --force', 'Force deletion without confirmation')
+  .action(taskDeleteCommand);
+
+tasks
+  .command('enable <taskId>')
+  .description('Enable a task')
+  .action((taskId: string) => taskEnableCommand(taskId, true));
+
+tasks
+  .command('disable <taskId>')
+  .description('Disable a task')
+  .action((taskId: string) => taskEnableCommand(taskId, false));
+
 // Help command
 program.on('--help', () => {
   console.log('');
@@ -74,6 +113,14 @@ program.on('--help', () => {
   console.log('  $ d-drive download /backups/file.txt ./restored.txt');
   console.log('  $ d-drive list /backups');
   console.log('  $ d-drive delete /backups/old-file.txt');
+  console.log('');
+  console.log(chalk.bold('Task Commands:'));
+  console.log('  $ d-drive tasks list              List all backup tasks');
+  console.log('  $ d-drive tasks run <taskId>      Run a task immediately');
+  console.log('  $ d-drive tasks stop <taskId>     Stop a running task');
+  console.log('  $ d-drive tasks enable <taskId>   Enable a task');
+  console.log('  $ d-drive tasks disable <taskId>  Disable a task');
+  console.log('  $ d-drive tasks delete <taskId>   Delete a task');
 });
 
 program.parse();