Add openapi specs and docs

1 files changed, 69 insertions, 0 deletions

diff --git a/src/response/error.rs b/src/response/error.rs
new file mode 100644
index 0000000..db39da8
--- /dev/null
+++ b/src/response/error.rs
@@ -0,0 +1,69 @@
+use axum::{
+    http::StatusCode,
+    response::{IntoResponse, Response},
+};
+use serde::Serialize;
+use utoipa::ToSchema;
+
+use crate::ApiError;
+
+#[derive(Serialize, ToSchema)]
+#[schema(examples("fail or error"))]
+enum ErrorStatus {
+    #[serde(rename = "fail")]
+    Fail,
+    #[serde(rename = "error")]
+    Error,
+}
+
+#[derive(Serialize, ToSchema)]
+pub struct ErrorResponse {
+    status: ErrorStatus,
+    #[schema(examples("SomeErrorKind", "NotAuthorized", "Database"))]
+    kind: String,
+    #[schema(examples("some error text"))]
+    message: String,
+}
+
+impl ErrorResponse {
+    pub fn fail(kind: impl Into<String>, message: impl Into<String>) -> Self {
+        Self {
+            status: ErrorStatus::Fail,
+            kind: kind.into(),
+            message: message.into(),
+        }
+    }
+
+    pub fn error(kind: impl Into<String>, message: impl Into<String>) -> Self {
+        Self {
+            status: ErrorStatus::Error,
+            kind: kind.into(),
+            message: message.into(),
+        }
+    }
+}
+
+impl IntoResponse for ErrorResponse {
+    fn into_response(self) -> Response {
+        (
+            match self.status {
+                ErrorStatus::Fail => StatusCode::BAD_REQUEST,
+                ErrorStatus::Error => StatusCode::INTERNAL_SERVER_ERROR,
+            },
+            axum::Json(self),
+        )
+            .into_response()
+    }
+}
+
+impl<T> From<T> for ErrorResponse
+where
+    T: Into<ApiError>,
+{
+    fn from(value: T) -> Self {
+        match value.into() {
+            ApiError::Client(e) => Self::fail(e.kind(), e.into_message()),
+            ApiError::Server(e) => Self::fail(e.kind(), e.into_message()),
+        }
+    }
+}