oauth_error.h

#ifndef SOURCEMETA_CORE_OAUTH_ERROR_H_
#define SOURCEMETA_CORE_OAUTH_ERROR_H_
 
#ifndef SOURCEMETA_CORE_OAUTH_EXPORT
#include <sourcemeta/core/oauth_export.h>
#endif
 
#include <sourcemeta/core/http.h>
 
#include <cstdint>     // std::uint8_t
#include <exception>   // std::exception
#include <optional>    // std::optional
#include <string_view> // std::string_view
 
namespace sourcemeta::core {

enum class OAuthAuthorizationError : std::uint8_t {
  InvalidRequest,
  UnauthorizedClient,
  AccessDenied,
  UnsupportedResponseType,
  InvalidScope,
  ServerError,
  TemporarilyUnavailable
};

enum class OAuthTokenError : std::uint8_t {
  InvalidRequest,
  InvalidClient,
  InvalidGrant,
  UnauthorizedClient,
  UnsupportedGrantType,
  InvalidScope,
  AuthorizationPending,
  SlowDown,
  AccessDenied,
  ExpiredToken,
  InvalidTarget,
  InvalidDPoPProof,
  UseDPoPNonce,
  UnsupportedTokenType
};

enum class OAuthBearerError : std::uint8_t {
  InvalidRequest,
  InvalidToken,
  InsufficientScope,
  InvalidDPoPProof,
  UseDPoPNonce
};

enum class OAuthRegistrationError : std::uint8_t {
  InvalidRedirectURI,
  InvalidClientMetadata,
  InvalidSoftwareStatement,
  UnapprovedSoftwareStatement
};

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_error_code(const OAuthAuthorizationError error) noexcept
    -> std::string_view;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_error_code(const OAuthTokenError error) noexcept -> std::string_view;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_error_code(const OAuthBearerError error) noexcept
    -> std::string_view;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_error_code(const OAuthRegistrationError error) noexcept
    -> std::string_view;

SOURCEMETA_CORE_OAUTH_EXPORT
auto to_oauth_authorization_error(const std::string_view code) noexcept
    -> std::optional<OAuthAuthorizationError>;

SOURCEMETA_CORE_OAUTH_EXPORT
auto to_oauth_token_error(const std::string_view code) noexcept
    -> std::optional<OAuthTokenError>;

SOURCEMETA_CORE_OAUTH_EXPORT
auto to_oauth_bearer_error(const std::string_view code) noexcept
    -> std::optional<OAuthBearerError>;

SOURCEMETA_CORE_OAUTH_EXPORT
auto to_oauth_registration_error(const std::string_view code) noexcept
    -> std::optional<OAuthRegistrationError>;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_token_error_status(const OAuthTokenError error,
                              const bool authenticated_via_header) noexcept
    -> HTTPStatus;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_bearer_error_status(const OAuthBearerError error) noexcept
    -> HTTPStatus;
 
#if defined(_MSC_VER)
#pragma warning(disable : 4251 4275)
#endif

class SOURCEMETA_CORE_OAUTH_EXPORT OAuthMetadataParseError
    : public std::exception {
public:
  [[nodiscard]] auto what() const noexcept -> const char * override {
    return "The input is not a valid OAuth metadata document";
  }
};

class SOURCEMETA_CORE_OAUTH_EXPORT OAuthRegistrationParseError
    : public std::exception {
public:
  [[nodiscard]] auto what() const noexcept -> const char * override {
    return "The input is not a valid OAuth client registration document";
  }
};
 
#if defined(_MSC_VER)
#pragma warning(default : 4251 4275)
#endif
 
} // namespace sourcemeta::core
 
#endif