vrc 0.5.0

Unofficial rust types of VRChat's 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
93
94
95
96
97
98
99
100
101
102
103
104
105
106

use racal::Queryable;
use serde::{Deserialize, Serialize};

use super::{Authenticating, Authentication};

#[derive(Debug, Clone, PartialEq, Eq, Hash, Deserialize, Serialize)]
/// Also works as the login request
pub struct GetCurrentUser;

impl Queryable<Authenticating, crate::model::LoginResponseOrCurrentUser>
	for GetCurrentUser
{
	fn url(&self, _: &Authenticating) -> String {
		format!("{}/auth/user", crate::API_BASE_URI)
	}
}

impl Queryable<Authentication, crate::model::CurrentAccount>
	for GetCurrentUser
{
	fn url(&self, _: &Authentication) -> String {
		format!("{}/auth/user", crate::API_BASE_URI)
	}
}

#[derive(Debug, Clone, PartialEq, Eq, Hash, Deserialize, Serialize)]
/// Completes authentication with a 2FA code
pub enum VerifySecondFactor {
	/// A normal 2FA
	Code(String),
	/// A recovery code
	Recovery(String),
	/// An email code
	Email(String),
}

impl Queryable<Authentication, crate::model::SecondFactorVerificationStatus>
	for VerifySecondFactor
{
	fn url(&self, _: &Authentication) -> String {
		format!(
			"{}/auth/twofactorauth/{}/verify",
			crate::API_BASE_URI,
			match self {
				Self::Code(_) => "totp",
				Self::Recovery(_) => "otp",
				Self::Email(_) => "emailotp",
			}
		)
	}

	fn body(
		&self, _state: &Authentication,
	) -> Option<serde_json::Result<Vec<u8>>> {
		let code = match self {
			Self::Code(v) | Self::Recovery(v) | Self::Email(v) => v,
		};
		Some(serde_json::to_vec(&serde_json::json!({ "code": code })))
	}

	fn method(&self, _state: &Authentication) -> racal::RequestMethod {
		racal::RequestMethod::Post
	}
}

#[derive(Debug, Clone, PartialEq, Eq, Hash, Deserialize, Serialize)]
/// Verifies that the current auth token is valid
pub struct Verify;

impl Queryable<Authentication, crate::model::AuthStatus> for Verify {
	fn url(&self, _: &Authentication) -> String {
		format!("{}/auth", crate::API_BASE_URI)
	}
}

#[derive(Debug, Clone, PartialEq, Eq, Hash, Deserialize, Serialize)]
/// Verifies that the current auth token is valid
pub struct Logout;

impl Queryable<Authentication, crate::model::StatusResponse> for Logout {
	fn url(&self, _: &Authentication) -> String {
		format!("{}/logout", crate::API_BASE_URI)
	}

	fn method(&self, _state: &Authentication) -> racal::RequestMethod {
		racal::RequestMethod::Put
	}
}

#[derive(Debug, Clone, PartialEq, Eq, Hash, Deserialize, Serialize)]
/// Verifies that the current auth token is valid
pub struct DeleteAccount {
	/// The ID of the account to delete,
	/// should match currently authenticated account.
	pub id: crate::id::User,
}

impl Queryable<Authentication, crate::model::CurrentAccount> for DeleteAccount {
	fn url(&self, _: &Authentication) -> String {
		format!("{}/users/{}/delete", crate::API_BASE_URI, self.id.as_ref())
	}

	fn method(&self, _state: &Authentication) -> racal::RequestMethod {
		racal::RequestMethod::Put
	}
}