//! `/api/v1/channels/{uuid}` Channel specific endpoints pub mod messages; pub mod socket; use std::sync::Arc; use crate::{ AppState, api::v1::auth::CurrentUser, error::Error, objects::{Channel, Member, Permissions}, utils::global_checks, }; use axum::{ Extension, Json, extract::{Path, State}, http::StatusCode, response::IntoResponse, }; use serde::Deserialize; use uuid::Uuid; pub async fn get( State(app_state): State>, Path(channel_uuid): Path, Extension(CurrentUser(uuid)): Extension>, ) -> Result { global_checks(&app_state, uuid).await?; let channel = Channel::fetch_one(&app_state, channel_uuid).await?; Member::check_membership(&mut app_state.pool.get().await?, uuid, channel.guild_uuid).await?; Ok((StatusCode::OK, Json(channel))) } pub async fn delete( State(app_state): State>, Path(channel_uuid): Path, Extension(CurrentUser(uuid)): Extension>, ) -> Result { global_checks(&app_state, uuid).await?; let channel = Channel::fetch_one(&app_state, channel_uuid).await?; let member = Member::check_membership(&mut app_state.pool.get().await?, uuid, channel.guild_uuid) .await?; member .check_permission(&app_state, Permissions::ManageChannel) .await?; channel.delete(&app_state).await?; Ok(StatusCode::OK) } #[derive(Deserialize)] pub struct NewInfo { name: Option, description: Option, is_above: Option, } /// `PATCH /api/v1/channels/{uuid}` Returns user with the given UUID /// /// requires auth: yes /// /// requires relation: yes /// /// ### Request Example /// All fields are optional and can be nulled/dropped if only changing 1 value /// ``` /// json!({ /// "name": "gaming-chat", /// "description": "Gaming related topics.", /// "is_above": "398f6d7b-752c-4348-9771-fe6024adbfb1" /// }); /// ``` /// /// ### Response Example /// ``` /// json!({ /// uuid: "cdcac171-5add-4f88-9559-3a247c8bba2c", /// guild_uuid: "383d2afa-082f-4dd3-9050-ca6ed91487b6", /// name: "gaming-chat", /// description: "Gaming related topics.", /// is_above: "398f6d7b-752c-4348-9771-fe6024adbfb1", /// permissions: { /// role_uuid: "79cc0806-0f37-4a06-a468-6639c4311a2d", /// permissions: 0 /// } /// }); /// ``` /// 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 patch( State(app_state): State>, Path(channel_uuid): Path, Extension(CurrentUser(uuid)): Extension>, Json(new_info): Json, ) -> Result { global_checks(&app_state, uuid).await?; let mut channel = Channel::fetch_one(&app_state, channel_uuid).await?; let member = Member::check_membership(&mut app_state.pool.get().await?, uuid, channel.guild_uuid) .await?; member .check_permission(&app_state, Permissions::ManageChannel) .await?; if let Some(new_name) = &new_info.name { channel.set_name(&app_state, new_name.to_string()).await?; } if let Some(new_description) = &new_info.description { channel .set_description(&app_state, new_description.to_string()) .await?; } if let Some(new_is_above) = &new_info.is_above { channel .set_description(&app_state, new_is_above.to_string()) .await?; } Ok((StatusCode::OK, Json(channel))) }