misskey-api 0.2.0

API bindings of Misskey, including requests/responses of endpoints and messages on channels
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

use crate::model::{
    id::Id,
    note::{Note, Reaction},
    user::User,
    user_group::UserGroupInvitation,
};

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};
use strum_macros::EnumDiscriminants;
use thiserror::Error;

#[derive(Serialize, Deserialize, Debug, Clone)]
#[serde(rename_all = "camelCase")]
pub struct Notification {
    pub id: Id<Notification>,
    pub created_at: DateTime<Utc>,
    /// This field is [`Id<User>`] (i.e. not [`Option`]) on <span class="module-item stab portability" style="display: inline-block; font-size: 80%;"><strong>non-<code style="background-color: transparent;">feature="12-17-0"</code></strong></span>.
    #[cfg(feature = "12-27-0")]
    pub user_id: Option<Id<User>>,
    /// This field is [`User`] (i.e. not [`Option`]) on <span class="module-item stab portability" style="display: inline-block; font-size: 80%;"><strong>non-<code style="background-color: transparent;">feature="12-17-0"</code></strong></span>.
    #[cfg(feature = "12-27-0")]
    pub user: Option<User>,
    #[cfg(not(feature = "12-27-0"))]
    pub user_id: Id<User>,
    #[cfg(not(feature = "12-27-0"))]
    pub user: User,
    #[cfg(feature = "12-39-0")]
    #[cfg_attr(docsrs, doc(cfg(feature = "12-39-0")))]
    pub is_read: bool,
    #[serde(flatten)]
    pub body: NotificationBody,
}

impl_entity!(Notification);

#[derive(Serialize, Deserialize, Debug, Clone, EnumDiscriminants)]
#[serde(rename_all = "camelCase", tag = "type")]
#[strum_discriminants(name(NotificationType))]
#[strum_discriminants(derive(Serialize, Deserialize, Hash))]
#[strum_discriminants(serde(rename_all = "camelCase"))]
pub enum NotificationBody {
    Follow,
    FollowRequestAccepted,
    ReceiveFollowRequest,
    Mention { note: Note },
    Reply { note: Note },
    Renote { note: Note },
    Quote { note: Note },
    Reaction { note: Note, reaction: Reaction },
    PollVote { note: Note, choice: u64 },
    GroupInvited { invitation: UserGroupInvitation },
    // TODO: Implement
    App {},
}

#[derive(Debug, Error, Clone)]
#[error("invalid notification type")]
pub struct ParseNotificationTypeError {
    _priv: (),
}

impl std::str::FromStr for NotificationType {
    type Err = ParseNotificationTypeError;

    fn from_str(s: &str) -> Result<NotificationType, Self::Err> {
        match s {
            "follow" | "Follow" => Ok(NotificationType::Follow),
            "followRequestAccepted" | "FollowRequestAccepted" => {
                Ok(NotificationType::FollowRequestAccepted)
            }
            "receiveFollowRequest" | "ReceiveFollowRequest" => {
                Ok(NotificationType::ReceiveFollowRequest)
            }
            "mention" | "Mention" => Ok(NotificationType::Mention),
            "reply" | "Reply" => Ok(NotificationType::Reply),
            "renote" | "Renote" => Ok(NotificationType::Renote),
            "quote" | "Quote" => Ok(NotificationType::Quote),
            "reaction" | "Reaction" => Ok(NotificationType::Reaction),
            "pollVote" | "PollVote" => Ok(NotificationType::PollVote),
            "groupInvited" | "GroupInvited" => Ok(NotificationType::GroupInvited),
            "app" | "App" => Ok(NotificationType::App),
            _ => Err(ParseNotificationTypeError { _priv: () }),
        }
    }
}