ante-erp-cli 1.11.27 → 1.11.28

package/bin/ante-cli.js

@@ -38,6 +38,15 @@ import { exposeDbPorts, secureDbPorts, dbPortStatus } from '../src/commands/data
 import { setDomain } from '../src/commands/set-domain.js';
 import { sslEnable, sslStatus } from '../src/commands/ssl-enable.js';
 import { regenerateCompose } from '../src/commands/regenerate-compose.js';
+import {
+  setDailyBackup,
+  disableDailyBackup,
+  dailyBackupStatus,
+  dailyBackupRun,
+  dailyBackupLogs,
+  dailyBackupList,
+  dailyBackupClean
+} from '../src/commands/daily-backup.js';
 
 // Installation & Setup
 program
@@ -111,6 +120,56 @@ program
   .option('--force', 'Skip confirmation prompts')
   .action(restore);
 
+// Daily Automated Backups
+program
+  .command('set-daily-backup')
+  .description('Configure automated daily backups to S3/DigitalOcean Spaces')
+  .option('--endpoint <url>', 'S3 endpoint URL')
+  .option('--region <region>', 'S3 region', 'sgp1')
+  .option('--bucket <name>', 'S3 bucket name')
+  .option('--access-key <key>', 'S3 access key')
+  .option('--secret-key <key>', 'S3 secret key')
+  .option('--schedule <cron>', 'Cron schedule', '0 3 * * *')
+  .option('--retention <days>', 'Retention period in days', '30')
+  .option('--folder-prefix <name>', 'Custom folder prefix (default: server IP)')
+  .option('--test', 'Run test backup immediately after setup')
+  .action(setDailyBackup);
+
+program
+  .command('disable-daily-backup')
+  .description('Disable automated daily backups')
+  .action(disableDailyBackup);
+
+const dailyBackupCmd = program
+  .command('daily-backup')
+  .description('Manage daily backup operations');
+
+dailyBackupCmd
+  .command('status')
+  .description('Show daily backup status and configuration')
+  .action(dailyBackupStatus);
+
+dailyBackupCmd
+  .command('run')
+  .description('Trigger manual backup now')
+  .action(dailyBackupRun);
+
+dailyBackupCmd
+  .command('logs')
+  .description('View backup logs')
+  .option('--lines <n>', 'Number of lines to show', '50')
+  .action(dailyBackupLogs);
+
+dailyBackupCmd
+  .command('list')
+  .description('List remote backups on S3')
+  .action(dailyBackupList);
+
+dailyBackupCmd
+  .command('clean')
+  .description('Clean old backups manually (keeps retention days)')
+  .action(dailyBackupClean);
+
 // System Reset
 program
   .command('reset')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ante-erp-cli",
-  "version": "1.11.27",
+  "version": "1.11.28",
   "description": "Comprehensive CLI tool for managing ANTE ERP self-hosted installations",
   "type": "module",
   "bin": {
@@ -42,6 +42,8 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
+    "@aws-sdk/client-s3": "^3.645.0",
+    "@aws-sdk/lib-storage": "^3.645.0",
     "boxen": "^7.1.0",
     "chalk": "^5.3.0",
     "cli-table3": "^0.6.3",

package/src/commands/daily-backup-runner.js

@@ -0,0 +1,173 @@
+#!/usr/bin/env node
+
+/**
+ * Daily Backup Runner Script
+ * Executed by cron job to run automated backups
+ * This script runs independently and logs to ~/.ante-cli-backup.log
+ */
+
+import { join } from 'path';
+import { writeFileSync, appendFileSync, existsSync } from 'fs';
+import os from 'os';
+import Conf from 'conf';
+import { backup } from './backup.js';
+import { createS3Client, uploadFileToS3, cleanOldS3Backups } from '../utils/s3-client.js';
+import { decryptFields } from '../utils/crypto.js';
+
+const config = new Conf({ projectName: 'ante-cli' });
+const logFile = join(os.homedir(), '.ante-cli-backup.log');
+
+/**
+ * Log message to file with timestamp
+ */
+function log(message, level = 'INFO') {
+  const timestamp = new Date().toISOString();
+  const logMessage = `[${timestamp}] [${level}] ${message}\n`;
+
+  try {
+    if (!existsSync(logFile)) {
+      writeFileSync(logFile, '');
+    }
+    appendFileSync(logFile, logMessage);
+  } catch (error) {
+    console.error('Failed to write to log file:', error.message);
+  }
+
+  // Also output to console (will be captured by cron)
+  console.log(logMessage.trim());
+}
+
+/**
+ * Main backup execution function
+ */
+async function runDailyBackup() {
+  log('========================================');
+  log('Starting automated daily backup...');
+
+  try {
+    // Load configuration
+    const dailyBackupConfig = config.get('dailyBackup');
+
+    if (!dailyBackupConfig || !dailyBackupConfig.enabled) {
+      log('Daily backups are not enabled. Exiting.', 'WARN');
+      return;
+    }
+
+    log(`Backup configuration loaded successfully`);
+    log(`S3 Bucket: ${dailyBackupConfig.s3.bucket}`);
+    log(`Folder Prefix: ${dailyBackupConfig.folderPrefix}`);
+    log(`Retention: ${dailyBackupConfig.retention} days`);
+
+    // Step 1: Create local backup
+    log('Step 1/3: Creating local backup...');
+    const backupFile = await backup({ silent: true });
+
+    if (!backupFile) {
+      throw new Error('Failed to create local backup - no file returned');
+    }
+
+    log(`Local backup created successfully: ${backupFile}`, 'SUCCESS');
+
+    // Step 2: Upload to S3
+    log('Step 2/3: Uploading backup to S3...');
+
+    const s3Config = decryptFields(dailyBackupConfig.s3, ['accessKey', 'secretKey']);
+    const s3Client = createS3Client(s3Config);
+
+    const fileName = backupFile.split('/').pop();
+    const s3Key = `${dailyBackupConfig.folderPrefix}/${fileName}`;
+
+    log(`S3 Key: ${s3Key}`);
+
+    let lastProgress = 0;
+    const uploadResult = await uploadFileToS3(
+      s3Client,
+      backupFile,
+      s3Config.bucket,
+      s3Key,
+      (percentage, loaded, total) => {
+        // Log progress every 25%
+        if (percentage >= lastProgress + 25) {
+          log(`Upload progress: ${percentage}%`);
+          lastProgress = percentage;
+        }
+      }
+    );
+
+    if (!uploadResult.success) {
+      throw new Error(`S3 upload failed: ${uploadResult.error}`);
+    }
+
+    log(`Backup uploaded successfully to S3`, 'SUCCESS');
+    log(`S3 URL: ${uploadResult.url}`);
+    log(`File size: ${(uploadResult.size / 1024 / 1024).toFixed(2)} MB`);
+
+    // Step 3: Clean old backups
+    log('Step 3/3: Cleaning old backups...');
+
+    const cleanResult = await cleanOldS3Backups(
+      s3Client,
+      s3Config.bucket,
+      dailyBackupConfig.folderPrefix,
+      dailyBackupConfig.retention
+    );
+
+    if (!cleanResult.success) {
+      log(`Warning: Failed to clean old backups: ${cleanResult.error}`, 'WARN');
+    } else if (cleanResult.deleted > 0) {
+      log(`Cleaned ${cleanResult.deleted} old backup(s)`, 'SUCCESS');
+      cleanResult.backups.forEach(name => {
+        log(`  - Deleted: ${name}`);
+      });
+    } else {
+      log('No old backups to clean');
+    }
+
+    // Update configuration
+    config.set('dailyBackup.lastBackup', new Date().toISOString());
+    config.set('dailyBackup.lastStatus', 'success');
+
+    log('Automated backup completed successfully!', 'SUCCESS');
+    log('========================================\n');
+
+    process.exit(0);
+  } catch (error) {
+    log(`BACKUP FAILED: ${error.message}`, 'ERROR');
+
+    if (error.stack) {
+      log(`Stack trace: ${error.stack}`, 'ERROR');
+    }
+
+    // Update configuration
+    config.set('dailyBackup.lastStatus', 'failed');
+
+    log('========================================\n');
+
+    process.exit(1);
+  }
+}
+
+/**
+ * Handle script errors
+ */
+process.on('unhandledRejection', (error) => {
+  log(`Unhandled rejection: ${error.message}`, 'ERROR');
+  if (error.stack) {
+    log(`Stack trace: ${error.stack}`, 'ERROR');
+  }
+  process.exit(1);
+});
+
+process.on('uncaughtException', (error) => {
+  log(`Uncaught exception: ${error.message}`, 'ERROR');
+  if (error.stack) {
+    log(`Stack trace: ${error.stack}`, 'ERROR');
+  }
+  process.exit(1);
+});
+
+// Run the backup
+runDailyBackup().catch((error) => {
+  log(`Fatal error: ${error.message}`, 'ERROR');
+  process.exit(1);
+});