BackupManager.h

/*
 * MIT License
 *
 * Copyright (c) 2026 Adriano dos Santos Fernandes
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */
 
#ifndef FBCPP_BACKUP_MANAGER_H
#define FBCPP_BACKUP_MANAGER_H
 
#include "ServiceManager.h"
#include "fb-cpp-export.h"
#include <cstdint>
#include <optional>
#include <stdexcept>
#include <string>
#include <vector>
 
 
namespace fbcpp
{
    class BackupOptions final
    {
    public:
        struct BackupFileSpec final
        {
            std::string path;
            std::optional<std::uint64_t> length;
        };
 
    public:
        const std::string& getDatabase() const
        {
            return database;
        }
 
        BackupOptions& setDatabase(const std::string& value)
        {
            database = value;
            return *this;
        }
 
        const std::vector<BackupFileSpec>& getBackupFiles() const
        {
            return backupFiles;
        }
 
        BackupOptions& addBackupFile(const std::string& value)
        {
            backupFiles.emplace_back(value, std::nullopt);
            return *this;
        }
 
        BackupOptions& addBackupFile(const std::string& value, std::uint64_t length)
        {
            if (!backupFiles.empty() && !backupFiles.back().length)
                throw std::invalid_argument{"Cannot add a backup file with length after a backup file without length"};
 
            backupFiles.emplace_back(value, length);
            return *this;
        }
 
        BackupOptions& setBackupFile(const std::string& value)
        {
            backupFiles = {{value, std::nullopt}};
            return *this;
        }
 
        BackupOptions& setBackupFile(const std::string& value, std::uint64_t length)
        {
            backupFiles = {{value, length}};
            return *this;
        }
 
        const ServiceManager::VerboseOutput& getVerboseOutput() const
        {
            return verboseOutput;
        }
 
        BackupOptions& setVerboseOutput(ServiceManager::VerboseOutput value)
        {
            verboseOutput = std::move(value);
            return *this;
        }
 
        const std::optional<std::uint32_t>& getParallelWorkers() const
        {
            return parallelWorkers;
        }
 
        BackupOptions& setParallelWorkers(std::uint32_t value)
        {
            parallelWorkers = value;
            return *this;
        }
 
    private:
        std::string database;
        std::vector<BackupFileSpec> backupFiles;
        ServiceManager::VerboseOutput verboseOutput;
        std::optional<std::uint32_t> parallelWorkers;
    };
 
    class RestoreOptions final
    {
    public:
        struct DatabaseFileSpec final
        {
            std::string path;
            std::optional<std::uint64_t> length;
        };
 
    public:
        const std::vector<DatabaseFileSpec>& getDatabaseFiles() const
        {
            return databaseFiles;
        }
 
        RestoreOptions& setDatabase(const std::string& value)
        {
            databaseFiles = {{value, std::nullopt}};
            return *this;
        }
 
        RestoreOptions& setDatabase(const std::string& value, std::uint64_t length)
        {
            databaseFiles = {{value, length}};
            return *this;
        }
 
        RestoreOptions& addDatabaseFile(const std::string& value)
        {
            databaseFiles.emplace_back(value, std::nullopt);
            return *this;
        }
 
        RestoreOptions& addDatabaseFile(const std::string& value, std::uint64_t length)
        {
            if (!databaseFiles.empty() && !databaseFiles.back().length)
            {
                throw std::invalid_argument{
                    "Cannot add a database file with length after a database file without length"};
            }
 
            databaseFiles.emplace_back(value, length);
            return *this;
        }
 
        const std::vector<std::string>& getBackupFiles() const
        {
            return backupFiles;
        }
 
        RestoreOptions& addBackupFile(const std::string& value)
        {
            backupFiles.emplace_back(value);
            return *this;
        }
 
        RestoreOptions& setBackupFile(const std::string& value)
        {
            backupFiles = {value};
            return *this;
        }
 
        bool getReplace() const
        {
            return replace;
        }
 
        RestoreOptions& setReplace(bool value)
        {
            replace = value;
            return *this;
        }
 
        const ServiceManager::VerboseOutput& getVerboseOutput() const
        {
            return verboseOutput;
        }
 
        RestoreOptions& setVerboseOutput(ServiceManager::VerboseOutput value)
        {
            verboseOutput = std::move(value);
            return *this;
        }
 
        const std::optional<std::uint32_t>& getParallelWorkers() const
        {
            return parallelWorkers;
        }
 
        RestoreOptions& setParallelWorkers(std::uint32_t value)
        {
            parallelWorkers = value;
            return *this;
        }
 
        const std::optional<ReplicaMode>& getReplicaMode() const
        {
            return replicaMode;
        }
 
        RestoreOptions& setReplicaMode(ReplicaMode value)
        {
            replicaMode = value;
            return *this;
        }
 
    private:
        std::vector<DatabaseFileSpec> databaseFiles;
        std::vector<std::string> backupFiles;
        bool replace = false;
        ServiceManager::VerboseOutput verboseOutput;
        std::optional<std::uint32_t> parallelWorkers;
        std::optional<ReplicaMode> replicaMode;
    };
 
    class FB_CPP_EXPORT BackupManager final : public ServiceManager
    {
    public:
        using ServiceManager::ServiceManager;
 
    public:
        void backup(const BackupOptions& options);
 
        void restore(const RestoreOptions& options);
    };
}  // namespace fbcpp
 
 
#endif  // FBCPP_BACKUP_MANAGER_H