oauth_pkce.h

#ifndef SOURCEMETA_CORE_OAUTH_PKCE_H_
#define SOURCEMETA_CORE_OAUTH_PKCE_H_
 
#ifndef SOURCEMETA_CORE_OAUTH_EXPORT
#include <sourcemeta/core/oauth_export.h>
#endif
 
#include <sourcemeta/core/oauth_profile.h>
 
#include <array>       // std::array
#include <cstdint>     // std::uint8_t
#include <optional>    // std::optional
#include <string_view> // std::string_view
 
namespace sourcemeta::core {

enum class OAuthPKCEMethod : std::uint8_t {
  S256,
  Plain
};

enum class OAuthPKCEOutcome : std::uint8_t {
  Match,
  NotUsed,
  MissingVerifier,
  MissingChallenge,
  Mismatch,
  MethodNotAllowed,
  MalformedVerifier,
  MalformedChallenge
};

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_pkce_method_code(const OAuthPKCEMethod method) noexcept
    -> std::string_view;

SOURCEMETA_CORE_OAUTH_EXPORT
auto to_oauth_pkce_method(const std::string_view value) noexcept
    -> std::optional<OAuthPKCEMethod>;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_pkce_verifier() -> std::array<char, 43>;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_pkce_challenge(const std::string_view verifier)
    -> std::array<char, 43>;

SOURCEMETA_CORE_OAUTH_EXPORT
auto oauth_pkce_verify(const std::string_view verifier,
                       const std::string_view challenge,
                       const OAuthPKCEMethod method, const OAuthProfile profile)
    -> OAuthPKCEOutcome;
 
} // namespace sourcemeta::core
 
#endif