Add:Ability to edit backup location path on backups page #2973

- Added api endpoint PATCH /api/backups/path
- Cleanup backup page UI for mobile screens

server/controllers/BackupController.js

@@ -1,5 +1,8 @@
+const Path = require('path')
+const fs = require('../libs/fsExtra')
 const Logger = require('../Logger')
-const { encodeUriPath } = require('../utils/fileUtils')
+const Database = require('../Database')
+const fileUtils = require('../utils/fileUtils')
 
 class BackupController {
   constructor() {}
@@ -31,6 +34,56 @@ class BackupController {
     this.backupManager.uploadBackup(req, res)
   }
 
+  /**
+   * PATCH: /api/backups/path
+   * Update the backup path
+   *
+   * @this import('../routers/ApiRouter')
+   *
+   * @param {import('express').Request} req
+   * @param {import('express').Response} res
+   */
+  async updatePath(req, res) {
+    // Validate path is not empty and is a string
+    if (!req.body.path || !req.body.path?.trim?.()) {
+      Logger.error('[BackupController] Update backup path invalid')
+      return res.status(400).send('Invalid request body. Must include path.')
+    }
+
+    const newBackupPath = fileUtils.filePathToPOSIX(Path.resolve(req.body.path))
+
+    if (newBackupPath === this.backupManager.backupPath) {
+      Logger.debug(`[BackupController] Backup path unchanged: ${newBackupPath}`)
+      return res.status(200).send('Backup path unchanged')
+    }
+
+    Logger.info(`[BackupController] Updating backup path to "${newBackupPath}" from "${this.backupManager.backupPath}"`)
+
+    // Check if backup path is set in environment variable
+    if (process.env.BACKUP_PATH) {
+      Logger.warn(`[BackupController] Backup path is set in environment variable BACKUP_PATH. Backup path will be reverted on server restart.`)
+    }
+
+    // Validate backup path is writable and create folder if it does not exist
+    try {
+      const direxists = await fs.pathExists(newBackupPath)
+      if (!direxists) {
+        // If folder does not exist try to make it
+        await fs.mkdir(newBackupPath)
+      }
+    } catch (error) {
+      Logger.error(`[BackupController] updatePath: Failed to ensure backup path "${newBackupPath}"`, error)
+      return res.status(400).send(`Invalid backup path "${req.body.path}"`)
+    }
+
+    Database.serverSettings.backupPath = newBackupPath
+    await Database.updateServerSettings()
+
+    await this.backupManager.reload()
+
+    res.sendStatus(200)
+  }
+
   /**
    * api/backups/:id/download
    *
@@ -39,7 +92,7 @@ class BackupController {
    */
   download(req, res) {
     if (global.XAccel) {
-      const encodedURI = encodeUriPath(global.XAccel + req.backup.fullPath)
+      const encodedURI = fileUtils.encodeUriPath(global.XAccel + req.backup.fullPath)
       Logger.debug(`Use X-Accel to serve static file ${encodedURI}`)
       return res.status(204).header({ 'X-Accel-Redirect': encodedURI }).send()
     }