openapi_error.h

#ifndef SOURCEMETA_CORE_OPENAPI_ERROR_H_
#define SOURCEMETA_CORE_OPENAPI_ERROR_H_
 
#ifndef SOURCEMETA_CORE_OPENAPI_EXPORT
#include <sourcemeta/core/openapi_export.h>
#endif
 
#include <sourcemeta/core/json.h>
#include <sourcemeta/core/jsonpointer.h>
 
#include <cstdint>     // std::uint64_t
#include <exception>   // std::exception
#include <string>      // std::string
#include <string_view> // std::string_view
#include <utility>     // std::move
 
namespace sourcemeta::core {
 
// Exporting symbols that depends on the standard C++ library is considered
// safe.
// https://learn.microsoft.com/en-us/cpp/error-messages/compiler-warnings/compiler-warning-level-2-c4275?view=msvc-170&redirectedfrom=MSDN
#if defined(_MSC_VER)
#pragma warning(push)
#pragma warning(disable : 4251 4275)
#endif

class SOURCEMETA_CORE_OPENAPI_EXPORT OpenAPIError : public std::exception {
public:
  OpenAPIError(Pointer location, const char *message)
      : location_{std::move(location)}, message_{message} {}
  OpenAPIError(Pointer location, std::string message) = delete;
  OpenAPIError(Pointer location, std::string &&message) = delete;
  OpenAPIError(Pointer location, std::string_view message) = delete;

  OpenAPIError(JSON::String base, Pointer location, const char *message)
      : base_{std::move(base)}, location_{std::move(location)},
        message_{message} {}
  OpenAPIError(JSON::String base, Pointer location,
               std::string message) = delete;
  OpenAPIError(JSON::String base, Pointer location,
               std::string &&message) = delete;
  OpenAPIError(JSON::String base, Pointer location,
               std::string_view message) = delete;
 
  [[nodiscard]] auto what() const noexcept -> const char * override {
    return this->message_;
  }

  [[nodiscard]] auto location() const noexcept -> const Pointer & {
    return this->location_;
  }

  [[nodiscard]] auto base() const noexcept -> JSON::StringView {
    return this->base_;
  }
 
private:
  JSON::String base_;
  Pointer location_;
  const char *message_;
};

class SOURCEMETA_CORE_OPENAPI_EXPORT OpenAPIResolutionError
    : public std::exception {
public:
  OpenAPIResolutionError(JSON::String base, Pointer location,
                         JSON::String identifier, const char *message)
      : base_{std::move(base)}, location_{std::move(location)},
        identifier_{std::move(identifier)}, message_{message} {}
  OpenAPIResolutionError(JSON::String base, Pointer location,
                         JSON::String identifier, std::string message) = delete;
  OpenAPIResolutionError(JSON::String base, Pointer location,
                         JSON::String identifier,
                         std::string &&message) = delete;
  OpenAPIResolutionError(JSON::String base, Pointer location,
                         JSON::String identifier,
                         std::string_view message) = delete;
 
  [[nodiscard]] auto what() const noexcept -> const char * override {
    return this->message_;
  }

  [[nodiscard]] auto identifier() const noexcept -> JSON::StringView {
    return this->identifier_;
  }

  [[nodiscard]] auto location() const noexcept -> const Pointer & {
    return this->location_;
  }

  [[nodiscard]] auto base() const noexcept -> JSON::StringView {
    return this->base_;
  }
 
private:
  JSON::String base_;
  Pointer location_;
  JSON::String identifier_;
  const char *message_;
};

class SOURCEMETA_CORE_OPENAPI_EXPORT OpenAPIReferenceError
    : public std::exception {
public:
  OpenAPIReferenceError(JSON::String base, Pointer location,
                        JSON::String identifier, const char *message)
      : base_{std::move(base)}, location_{std::move(location)},
        identifier_{std::move(identifier)}, message_{message} {}
  OpenAPIReferenceError(JSON::String base, Pointer location,
                        JSON::String identifier, std::string message) = delete;
  OpenAPIReferenceError(JSON::String base, Pointer location,
                        JSON::String identifier,
                        std::string &&message) = delete;
  OpenAPIReferenceError(JSON::String base, Pointer location,
                        JSON::String identifier,
                        std::string_view message) = delete;
 
  [[nodiscard]] auto what() const noexcept -> const char * override {
    return this->message_;
  }

  [[nodiscard]] auto identifier() const noexcept -> JSON::StringView {
    return this->identifier_;
  }

  [[nodiscard]] auto location() const noexcept -> const Pointer & {
    return this->location_;
  }

  [[nodiscard]] auto base() const noexcept -> JSON::StringView {
    return this->base_;
  }
 
private:
  JSON::String base_;
  Pointer location_;
  JSON::String identifier_;
  const char *message_;
};

class SOURCEMETA_CORE_OPENAPI_EXPORT OpenAPIFrameLimitError
    : public std::exception {
public:
  OpenAPIFrameLimitError(const std::uint64_t limit) : limit_{limit} {}
 
  [[nodiscard]] auto what() const noexcept -> const char * override {
    return "The OpenAPI Description exceeds the maximum number of locations "
           "that framing may register";
  }

  [[nodiscard]] auto limit() const noexcept -> std::uint64_t {
    return this->limit_;
  }
 
private:
  std::uint64_t limit_;
};

class SOURCEMETA_CORE_OPENAPI_EXPORT OpenAPIBundleLimitError
    : public std::exception {
public:
  OpenAPIBundleLimitError(const std::uint64_t limit) : limit_{limit} {}
 
  [[nodiscard]] auto what() const noexcept -> const char * override {
    return "The OpenAPI Description exceeds the maximum number of locations "
           "that bundling may analyse";
  }

  [[nodiscard]] auto limit() const noexcept -> std::uint64_t {
    return this->limit_;
  }
 
private:
  std::uint64_t limit_;
};
 
#if defined(_MSC_VER)
#pragma warning(pop)
#endif
 
} // namespace sourcemeta::core
 
#endif