#pragma once

#include <string>

// --- Namespace SystemUtils: utilidades multiplataforma para operaciones del sistema ---
namespace SystemUtils {
// --- Enums ---
enum class Result {  // Códigos de resultado para operaciones del sistema
    SUCCESS = 0,
    PERMISSION_DENIED,  // Sin permisos para crear la carpeta
    PATH_TOO_LONG,      // Ruta demasiado larga
    ALREADY_EXISTS,     // Ya existe (solo si se considera error)
    INVALID_PATH,       // Ruta inválida
    UNKNOWN_ERROR       // Error desconocido
};

// --- Estructuras ---
struct FolderConfig {         // Configuración para creación de carpetas
        bool create_parents;  // Crear carpetas padre si no existen
        bool fail_if_exists;  // Fallar si la carpeta ya existe
        int permissions;      // Permisos Unix (ignorado en Windows)

        // Constructor con valores por defecto
        FolderConfig()
            : create_parents(true), fail_if_exists(false), permissions(0755)  // rwxr-xr-x
        {}
};

// --- Funciones ---
Result createApplicationFolder(const std::string& app_name, std::string& out_path);                              // Crea la carpeta del sistema donde guardar datos de la aplicación
Result createApplicationFolder(const std::string& app_name, std::string& out_path, const FolderConfig& config);  // Crea la carpeta del sistema con configuración personalizada
Result createFolder(const std::string& path);                                                                    // Crea una carpeta en la ruta especificada
Result createFolder(const std::string& path, const FolderConfig& config);                                        // Crea una carpeta con configuración personalizada
std::string getApplicationDataPath(const std::string& app_name);                                                 // Obtiene la ruta de datos de la aplicación (sin crearla)
bool folderExists(const std::string& path);                                                                      // Verifica si una carpeta existe
const char* resultToString(Result result);                                                                       // Convierte un código de resultado a string descriptivo
std::string getHomeDirectory();                                                                                  // Obtiene el directorio home del usuario
std::string getTempDirectory();                                                                                  // Obtiene el directorio temporal del sistema

}  // namespace SystemUtils