//! `/api/v1/guilds` Guild related endpoints use std::sync::Arc; use ::uuid::Uuid; use axum::{ Extension, Json, Router, extract::State, http::StatusCode, response::IntoResponse, routing::{get, post}, }; use serde::Deserialize; mod uuid; use crate::{ AppState, api::v1::auth::CurrentUser, error::Error, objects::{Guild, StartAmountQuery}, utils::global_checks, }; #[derive(Deserialize)] pub struct GuildInfo { name: String, } pub fn router() -> Router> { Router::new() .route("/", post(new)) .route("/", get(get_guilds)) .nest("/{uuid}", uuid::router()) } /// `POST /api/v1/guilds` Creates a new guild /// /// requires auth: yes /// /// ### Request Example /// ``` /// json!({ /// "name": "My new server!" /// }); /// ``` /// /// ### Response Example /// ``` /// json!({ /// "uuid": "383d2afa-082f-4dd3-9050-ca6ed91487b6", /// "name": "My new server!", /// "description": null, /// "icon": null, /// "owner_uuid": "155d2291-fb23-46bd-a656-ae7c5d8218e6", /// "roles": [], /// "member_count": 1 /// }); /// ``` /// NOTE: UUIDs in this response are made using `uuidgen`, UUIDs made by the actual backend will be UUIDv7 and have extractable timestamps pub async fn new( State(app_state): State>, Extension(CurrentUser(uuid)): Extension>, Json(guild_info): Json, ) -> Result { let guild = Guild::new( &mut app_state.pool.get().await?, guild_info.name.clone(), uuid, ) .await?; Ok((StatusCode::OK, Json(guild))) } /// `GET /api/v1/servers` Fetches all guilds /// /// requires auth: yes /// /// requires admin: yes /// /// ### Response Example /// ``` /// json!([ /// { /// "uuid": "383d2afa-082f-4dd3-9050-ca6ed91487b6", /// "name": "My new server!", /// "description": null, /// "icon": null, /// "owner_uuid": "155d2291-fb23-46bd-a656-ae7c5d8218e6", /// "roles": [], /// "member_count": 1 /// }, /// { /// "uuid": "5ba61ec7-5f97-43e1-89a5-d4693c155612", /// "name": "My first server!", /// "description": "This is a cool and nullable description!", /// "icon": "https://nullable-url/path/to/icon.png", /// "owner_uuid": "155d2291-fb23-46bd-a656-ae7c5d8218e6", /// "roles": [ /// { /// "uuid": "be0e4da4-cf73-4f45-98f8-bb1c73d1ab8b", /// "guild_uuid": "5ba61ec7-5f97-43e1-89a5-d4693c155612", /// "name": "Cool people", /// "color": 15650773, /// "is_above": c7432f1c-f4ad-4ad3-8216-51388b6abb5b, /// "permissions": 0 /// } /// { /// "uuid": "c7432f1c-f4ad-4ad3-8216-51388b6abb5b", /// "guild_uuid": "5ba61ec7-5f97-43e1-89a5-d4693c155612", /// "name": "Equally cool people", /// "color": 16777215, /// "is_above": null, /// "permissions": 0 /// } /// ], /// "member_count": 20 /// } /// ]); /// ``` /// NOTE: UUIDs in this response are made using `uuidgen`, UUIDs made by the actual backend will be UUIDv7 and have extractable timestamps pub async fn get_guilds( State(app_state): State>, Extension(CurrentUser(uuid)): Extension>, Json(request_query): Json, ) -> Result { let start = request_query.start.unwrap_or(0); let amount = request_query.amount.unwrap_or(10); let mut conn = app_state.pool.get().await?; global_checks(&mut conn, &app_state.config, uuid).await?; let guilds = Guild::fetch_amount(&mut conn, start, amount).await?; Ok((StatusCode::OK, Json(guilds))) }