mycelium-api 8.3.1-rc.1

Provide API ports to the mycelium project.
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

use crate::dtos::MyceliumProfileData;

use actix_web::{post, web, Responder};
use myc_core::use_cases::role_scoped::beginner::guest_user::accept_invitation;
use myc_diesel::repositories::SqlAppModule;
use myc_http_tools::{
    utils::HttpJsonResponse,
    wrappers::default_response_to_http_response::{
        handle_mapped_error, updating_response_kind,
    },
    Permission, Profile,
};
use shaku::HasComponent;
use uuid::Uuid;

// ? ---------------------------------------------------------------------------
// ? Configure application
// ? ---------------------------------------------------------------------------

pub fn configure(config: &mut web::ServiceConfig) {
    config.service(accept_invitation_url);
}

// ? ---------------------------------------------------------------------------
// ? Define API paths
//
// Account
//
// ? ---------------------------------------------------------------------------

/// Fetch a user's profile.
#[utoipa::path(
    post,
    operation_id = "accept_invitation",
    params(
        ("account_id" = Uuid, Path, description = "The account primary key."),
        ("guest_role_name" = Uuid, Path, description = "The guest role unique name."),
        ("permission" = u8, Path, description = "The permission to be granted."),
    ),
    responses(
        (
            status = 500,
            description = "Unknown internal server error.",
            body = HttpJsonResponse,
        ),
        (
            status = 403,
            description = "Forbidden.",
            body = HttpJsonResponse,
        ),
        (
            status = 401,
            description = "Unauthorized.",
            body = HttpJsonResponse,
        ),
        (
            status = 400,
            description = "Bad request.",
            body = HttpJsonResponse,
        ),
        (
            status = 201,
            description = "Invitation accepted",
            body = Profile,
        ),
    ),
)]
#[post(
    "/account/{account_id}/guest-role/{guest_role_name}/perm/{permission}/accept"
)]
pub async fn accept_invitation_url(
    query: web::Query<(Uuid, String, u8)>,
    profile: MyceliumProfileData,
    app_module: web::Data<SqlAppModule>,
) -> impl Responder {
    let (account_id, guest_role_name, permission) = query.into_inner();

    match accept_invitation(
        profile.to_profile(),
        account_id,
        guest_role_name,
        Permission::from_i32(permission.into()),
        Box::new(&*app_module.resolve_ref()),
    )
    .await
    {
        Ok(response) => updating_response_kind(response),
        Err(err) => handle_mapped_error(err),
    }
}