cronback-api-srv 0.1.0

API server for cronback backend
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

use axum::response::IntoResponse;
use axum::Json;
use dto::{FromProto, IntoProto};
use proto::common::PaginationOut;
use serde::{Deserialize, Serialize};
use validator::Validate;

// The query parameters for pagination and cursor management
#[derive(Debug, Deserialize, IntoProto, Validate)]
#[proto(target = "proto::common::PaginationIn")]
pub(crate) struct Pagination {
    pub cursor: Option<String>,
    #[validate(range(
        min = 1,
        max = 100,
        message = "must be between 1 and 100"
    ))]
    #[serde(default = "default_limit")]
    pub limit: i32,
}

fn default_limit() -> i32 {
    20
}

// An API model that handles formatting paginated responses into Json
#[derive(Debug, Serialize)]
pub(crate) struct Paginated<T> {
    #[serde(flatten)]
    pub pagination: PageMeta,
    pub data: Vec<T>,
}

impl<T> Paginated<T> {
    pub fn from<B>(data: Vec<B>, pagination: PaginationOut) -> Self
    where
        B: Into<T>,
    {
        Self {
            data: data.into_iter().map(Into::into).collect(),
            pagination: pagination.into(),
        }
    }
}

#[derive(Debug, Serialize, FromProto)]
#[proto(target = "proto::common::PaginationOut")]
pub(crate) struct PageMeta {
    pub next_cursor: Option<String>,
    pub has_more: bool,
}

impl<T> IntoResponse for Paginated<T>
where
    T: Serialize,
{
    fn into_response(self) -> axum::response::Response {
        (axum::http::StatusCode::OK, Json(self)).into_response()
    }
}