fandwill-vo 0.5.0

Serde, garde, and utoipa value objects for the Fandwill platform API.
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use serde::{Deserialize, Serialize};

use crate::listings::ListingsVO;
use crate::reviews::{ReviewReplyVO, ReviewsVO};

#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(feature = "utoipa", derive(utoipa::ToSchema))]
pub struct ListingsVOWithValidation {
    #[serde(flatten)]
    pub inner: ListingsVO,
    pub markdown_validation: Vec<serde_json::Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(feature = "utoipa", derive(utoipa::ToSchema))]
pub struct ReviewsVOWithValidation {
    #[serde(flatten)]
    pub inner: ReviewsVO,
    pub markdown_validation: Vec<serde_json::Value>,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[cfg_attr(feature = "utoipa", derive(utoipa::ToSchema))]
pub struct ReviewReplyVOWithValidation {
    #[serde(flatten)]
    pub inner: ReviewReplyVO,
    pub markdown_validation: Vec<serde_json::Value>,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn listing_validation_response_deserializes_from_flattened_json() {
        let response: ListingsVOWithValidation = serde_json::from_value(serde_json::json!({
            "id": "listing",
            "created_by": "user",
            "title": "Title",
            "description": "Description",
            "content": "Content",
            "banners": [],
            "capabilities": {"edit": "administrators", "reply": "everyone"},
            "created_at": "2026-08-04T00:00:00Z",
            "updated_at": "2026-08-04T00:00:00Z",
            "markdown_validation": [{"level": "warning"}]
        }))
        .unwrap();

        assert_eq!(response.inner.id, "listing");
        assert_eq!(response.markdown_validation.len(), 1);

        let roundtrip: ListingsVOWithValidation =
            serde_json::from_value(serde_json::to_value(&response).unwrap()).unwrap();
        assert_eq!(roundtrip.inner.id, response.inner.id);
        assert_eq!(roundtrip.markdown_validation, response.markdown_validation);
    }

    #[test]
    fn review_validation_responses_deserialize_from_flattened_json() {
        let review: ReviewsVOWithValidation = serde_json::from_value(serde_json::json!({
            "id": "review",
            "created_by": "user",
            "listing_id": "listing",
            "content": "Content",
            "like_count": 0,
            "viewer_liked": false,
            "created_at": "2026-08-04T00:00:00Z",
            "markdown_validation": []
        }))
        .unwrap();
        assert_eq!(review.inner.id, "review");
        let review_roundtrip: ReviewsVOWithValidation =
            serde_json::from_value(serde_json::to_value(&review).unwrap()).unwrap();
        assert_eq!(review_roundtrip.inner.id, review.inner.id);

        let reply: ReviewReplyVOWithValidation = serde_json::from_value(serde_json::json!({
            "id": "reply",
            "review_id": "review",
            "parent_reply_id": null,
            "created_by": "user",
            "content": "Content",
            "created_at": "2026-08-04T00:00:00Z",
            "markdown_validation": []
        }))
        .unwrap();
        assert_eq!(reply.inner.id, "reply");
        let reply_roundtrip: ReviewReplyVOWithValidation =
            serde_json::from_value(serde_json::to_value(&reply).unwrap()).unwrap();
        assert_eq!(reply_roundtrip.inner.id, reply.inner.id);
    }
}