palpo-core 0.0.2

Core library used by the palpo crates.
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
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157

//! `GET /_matrix/client/*/pushers`
//!
//! Gets all currently active pushers for the authenticated user.

use js_option::JsOption;
use salvo::prelude::*;
use serde::{Deserialize, Serialize, de, ser::SerializeStruct};

use crate::RawJsonValue;
use crate::push::{Pusher, PusherIds};
use crate::serde::from_raw_json_value;

// `/v3/` ([spec])
//
// [spec]: https://spec.matrix.org/latest/client-server-api/#get_matrixclientv3pushers
// const METADATA: Metadata = metadata! {
//     method: GET,
//     rate_limited: false,
//     authentication: AccessToken,
//     history: {
//         1.0 => "/_matrix/client/r0/pushers",
//         1.1 => "/_matrix/client/v3/pushers",
//     }
// };
/// Response type for the `get_pushers` endpoint.
#[derive(ToSchema, Serialize, Debug)]
pub struct PushersResBody {
    /// An array containing the current pushers for the user.
    pub pushers: Vec<Pusher>,
}

impl PushersResBody {
    /// Creates a new `Response` with the given pushers.
    pub fn new(pushers: Vec<Pusher>) -> Self {
        Self { pushers }
    }
}

// `POST /_matrix/client/*/pushers/set`
//
// This endpoint allows the creation, modification and deletion of pushers for this user ID.
// `/v3/` ([spec])
//
// [spec]: https://spec.matrix.org/latest/client-server-api/#post_matrixclientv3pushersset

// const METADATA: Metadata = metadata! {
//     method: POST,
//     rate_limited: true,
//     authentication: AccessToken,
//     history: {
//         1.0 => "/_matrix/client/r0/pushers/set",
//         1.1 => "/_matrix/client/v3/pushers/set",
//     }
// };

/// Request type for the `set_pusher` endpoint.
#[derive(ToSchema, Deserialize, Debug)]
pub struct SetPusherReqBody(pub PusherAction);

// impl Request {
//     /// Creates a new `Request` for the given action.
//     pub fn new(action: PusherAction) -> Self {
//         Self { action }
//     }

//     /// Creates a new `Request` to create or update the given pusher.
//     pub fn post(pusher: Pusher) -> Self {
//         Self::new(PusherAction::Post(PusherPostData { pusher, append: false }))
//     }

//     /// Creates a new `Request` to delete the pusher identified by the given IDs.
//     pub fn delete(ids: PusherIds) -> Self {
//         Self::new(PusherAction::Delete(ids))
//     }
// }

/// The action to take for the pusher.
#[derive(ToSchema, Clone, Debug)]
pub enum PusherAction {
    /// Create or update the given pusher.
    Post(PusherPostData),

    /// Delete the pusher identified by the given IDs.
    Delete(PusherIds),
}
impl Serialize for PusherAction {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        match self {
            PusherAction::Post(pusher) => pusher.serialize(serializer),
            PusherAction::Delete(ids) => {
                let mut st = serializer.serialize_struct("PusherAction", 3)?;
                st.serialize_field("pushkey", &ids.pushkey)?;
                st.serialize_field("app_id", &ids.app_id)?;
                st.serialize_field("kind", &None::<&str>)?;
                st.end()
            }
        }
    }
}
#[derive(Debug, Deserialize)]
struct PusherActionDeHelper {
    kind: JsOption<String>,
}

impl<'de> Deserialize<'de> for PusherAction {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: de::Deserializer<'de>,
    {
        let json = Box::<RawJsonValue>::deserialize(deserializer)?;
        let PusherActionDeHelper { kind } = from_raw_json_value(&json)?;

        match kind {
            JsOption::Some(_) => Ok(Self::Post(from_raw_json_value(&json)?)),
            JsOption::Null => Ok(Self::Delete(from_raw_json_value(&json)?)),
            // This is unreachable because we don't use `#[serde(default)]` on the field.
            JsOption::Undefined => Err(de::Error::missing_field("kind")),
        }
    }
}

/// Data necessary to create or update a pusher.
#[derive(ToSchema, Serialize, Clone, Debug)]
pub struct PusherPostData {
    /// The pusher to configure.
    #[serde(flatten)]
    pub pusher: Pusher,

    /// Controls if another pusher with the same pushkey and app id should be created, if there
    /// are already others for other users.
    ///
    /// Defaults to `false`. See the spec for more details.
    #[serde(skip_serializing_if = "crate::serde::is_default", default = "default_false")]
    pub append: bool,
}

#[derive(Debug, Deserialize)]
struct PusherPostDataDeHelper {
    #[serde(default)]
    append: bool,
}
impl<'de> Deserialize<'de> for PusherPostData {
    fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
    where
        D: de::Deserializer<'de>,
    {
        let json = Box::<RawJsonValue>::deserialize(deserializer)?;

        let PusherPostDataDeHelper { append } = from_raw_json_value(&json)?;
        let pusher = from_raw_json_value(&json)?;

        Ok(Self { pusher, append })
    }
}