mas_handlers/admin/v1/
mod.rs

Help
1// Copyright 2024 New Vector Ltd.
2// Copyright 2024 The Matrix.org Foundation C.I.C.
3//
4// SPDX-License-Identifier: AGPL-3.0-only
5// Please see LICENSE in the repository root for full details.
6
7use std::sync::Arc;
8
9use aide::axum::{
10    ApiRouter,
11    routing::{get_with, post_with},
12};
13use axum::extract::{FromRef, FromRequestParts};
14use mas_matrix::HomeserverConnection;
15use mas_policy::PolicyFactory;
16use mas_storage::BoxRng;
17
18use super::call_context::CallContext;
19use crate::passwords::PasswordManager;
20
21mod compat_sessions;
22mod oauth2_sessions;
23mod policy_data;
24mod upstream_oauth_links;
25mod user_emails;
26mod user_sessions;
27mod users;
28
29#[allow(clippy::too_many_lines)]
30pub fn router<S>() -> ApiRouter<S>
31where
32    S: Clone + Send + Sync + 'static,
33    Arc<dyn HomeserverConnection>: FromRef<S>,
34    PasswordManager: FromRef<S>,
35    Arc<PolicyFactory>: FromRef<S>,
36    BoxRng: FromRequestParts<S>,
37    CallContext: FromRequestParts<S>,
38{
39    ApiRouter::<S>::new()
40        .api_route(
41            "/compat-sessions",
42            get_with(self::compat_sessions::list, self::compat_sessions::list_doc),
43        )
44        .api_route(
45            "/compat-sessions/{id}",
46            get_with(self::compat_sessions::get, self::compat_sessions::get_doc),
47        )
48        .api_route(
49            "/oauth2-sessions",
50            get_with(self::oauth2_sessions::list, self::oauth2_sessions::list_doc),
51        )
52        .api_route(
53            "/oauth2-sessions/{id}",
54            get_with(self::oauth2_sessions::get, self::oauth2_sessions::get_doc),
55        )
56        .api_route(
57            "/policy-data",
58            post_with(self::policy_data::set, self::policy_data::set_doc),
59        )
60        .api_route(
61            "/policy-data/latest",
62            get_with(
63                self::policy_data::get_latest,
64                self::policy_data::get_latest_doc,
65            ),
66        )
67        .api_route(
68            "/policy-data/{id}",
69            get_with(self::policy_data::get, self::policy_data::get_doc),
70        )
71        .api_route(
72            "/users",
73            get_with(self::users::list, self::users::list_doc)
74                .post_with(self::users::add, self::users::add_doc),
75        )
76        .api_route(
77            "/users/{id}",
78            get_with(self::users::get, self::users::get_doc),
79        )
80        .api_route(
81            "/users/{id}/set-password",
82            post_with(self::users::set_password, self::users::set_password_doc),
83        )
84        .api_route(
85            "/users/by-username/{username}",
86            get_with(self::users::by_username, self::users::by_username_doc),
87        )
88        .api_route(
89            "/users/{id}/set-admin",
90            post_with(self::users::set_admin, self::users::set_admin_doc),
91        )
92        .api_route(
93            "/users/{id}/deactivate",
94            post_with(self::users::deactivate, self::users::deactivate_doc),
95        )
96        .api_route(
97            "/users/{id}/lock",
98            post_with(self::users::lock, self::users::lock_doc),
99        )
100        .api_route(
101            "/users/{id}/unlock",
102            post_with(self::users::unlock, self::users::unlock_doc),
103        )
104        .api_route(
105            "/user-emails",
106            get_with(self::user_emails::list, self::user_emails::list_doc)
107                .post_with(self::user_emails::add, self::user_emails::add_doc),
108        )
109        .api_route(
110            "/user-emails/{id}",
111            get_with(self::user_emails::get, self::user_emails::get_doc)
112                .delete_with(self::user_emails::delete, self::user_emails::delete_doc),
113        )
114        .api_route(
115            "/user-sessions",
116            get_with(self::user_sessions::list, self::user_sessions::list_doc),
117        )
118        .api_route(
119            "/user-sessions/{id}",
120            get_with(self::user_sessions::get, self::user_sessions::get_doc),
121        )
122        .api_route(
123            "/upstream-oauth-links",
124            get_with(
125                self::upstream_oauth_links::list,
126                self::upstream_oauth_links::list_doc,
127            )
128            .post_with(
129                self::upstream_oauth_links::add,
130                self::upstream_oauth_links::add_doc,
131            ),
132        )
133        .api_route(
134            "/upstream-oauth-links/{id}",
135            get_with(
136                self::upstream_oauth_links::get,
137                self::upstream_oauth_links::get_doc,
138            )
139            .delete_with(
140                self::upstream_oauth_links::delete,
141                self::upstream_oauth_links::delete_doc,
142            ),
143        )
144}
mas_handlers/admin/v1/mod.rs

mas_handlers/admin/v1/
mod.rs
