mycelium-api 9.0.0-rc.6

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

use actix_web::{get, web, HttpResponse, Responder};
use myc_core::models::AccountLifeCycle;
use serde::Serialize;
use utoipa::{ToResponse, ToSchema};

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

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

// ? ---------------------------------------------------------------------------
// ? Define API structs
// ? ---------------------------------------------------------------------------

#[derive(Serialize, ToSchema, ToResponse)]
#[serde(rename_all = "camelCase")]
pub struct AppPublicConfigResponse {
    pub domain_name: String,
    pub domain_url: Option<String>,
    pub locale: Option<String>,
}

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

/// Get public application configuration
///
/// Returns the application's public branding and locale settings:
/// domain name, optional domain URL, and optional default locale.
/// No authentication required.
#[utoipa::path(
    get,
    operation_id = "get_app_public_config",
    context_path = "/app-config",
    responses(
        (
            status = 200,
            description = "Application public configuration.",
            body = AppPublicConfigResponse,
        ),
        (
            status = 500,
            description = "Configuration resolution failed.",
        ),
    ),
    security(()),
)]
#[get("")]
pub async fn get_app_public_config_url(
    life_cycle_settings: web::Data<AccountLifeCycle>,
) -> impl Responder {
    let domain_name =
        match life_cycle_settings.domain_name.async_get_or_error().await {
            Ok(name) => name,
            Err(_) => return HttpResponse::InternalServerError().finish(),
        };

    let domain_url = match &life_cycle_settings.domain_url {
        Some(resolver) => resolver.async_get_or_error().await.ok(),
        None => None,
    };

    let locale = match &life_cycle_settings.locale {
        Some(resolver) => resolver.async_get_or_error().await.ok(),
        None => None,
    };

    HttpResponse::Ok().json(AppPublicConfigResponse {
        domain_name,
        domain_url,
        locale,
    })
}