// SPDX-FileCopyrightText: 2025 UnionTech Software Technology Co., Ltd.
//
// SPDX-License-Identifier: GPL-3.0-or-later


#ifndef BASEKIT_ERRORS_EXCEPTIONS_H
#define BASEKIT_ERRORS_EXCEPTIONS_H

#include "errors/system_error.h"
#include "system/source_location.h"

#include <exception>
#include <string>
#include <utility>

//! Throw extended exception macro
/*!
    Throw extended exception with the current location.
*/
#define throwex throw __LOCATION__ +

namespace BaseKit {

//! Exception
/*!
    Exception base interface.

    Not thread-safe.
*/
class Exception : public std::exception
{
public:
    //! Default class constructor
    /*!
        \param message - Exception message (default is "")
    */
    explicit Exception(const std::string& message = "") : _message(message), _location() {}
    Exception(const Exception&) = default;
    Exception(Exception&&) = default;
    virtual ~Exception() = default;

    Exception& operator=(const Exception&) = default;
    Exception& operator=(Exception&&) = default;

    //! Get exception message
    const std::string& message() const noexcept { return _message; }
    //! Get exception location
    const SourceLocation& location() const noexcept { return _location; }

    //! Get string identifying exception
    const char* what() const noexcept override;

    //! Get string from the current exception
    virtual std::string string() const;

    //! Output exception into the given output stream
    friend std::ostream& operator<<(std::ostream& os, const Exception& ex)
    { os << ex.string(); return os; }

    //! Link exception with source location
    template<class T>
    friend T&& operator+(const SourceLocation& location, T&& instance)
    { instance._location = location; return std::forward<T>(instance); }

protected:
    //! Cached exception string
    mutable std::string _cache;
    //! Exception message
    std::string _message;
    //! Exception location
    SourceLocation _location;
};

//! Argument exception
class ArgumentException : public Exception
{
public:
    using Exception::Exception;
};

//! Domain exception
class DomainException : public Exception
{
public:
    using Exception::Exception;
};

//! Runtime exception
class RuntimeException : public Exception
{
public:
    using Exception::Exception;
};

//! Security exception
class SecurityException : public Exception
{
public:
    using Exception::Exception;
};

//! System exception
class SystemException : public Exception
{
public:
    //! Create system exception based on the last system error code
    SystemException()
        : SystemException(SystemError::GetLast())
    {}
    //! Create system exception based on the given system error code
    /*!
        \param error - System error code
    */
    explicit SystemException(int error)
        : SystemException(SystemError::Description(error), error)
    {}
    //! Create system exception based on the given exception message
    /*!
        \param message - Exception message
    */
    explicit SystemException(const std::string& message)
        : SystemException(message, SystemError::GetLast())
    {}
    //! Create system exception based on the given exception message and system error code
    /*!
        \param message - Exception message
        \param error - System error code
    */
    explicit SystemException(const std::string& message, int error)
        : Exception(message),
          _system_error(error),
          _system_message(SystemError::Description(error))
    {}

    //! Get system error code
    int system_error() const noexcept { return _system_error; }
    //! Get system error message
    const std::string& system_message() const noexcept { return _system_message; }

    //! Get string from the current system exception
    std::string string() const override;

protected:
    //! System error code
    int _system_error;
    //! System error message
    std::string _system_message;
};

} // namespace BaseKit

// #include "exceptions.inl"

#endif // BASEKIT_ERRORS_EXCEPTIONS_H
