laterite-admin 0.9.13

//! The configured application name renders as the admin brand, and a brand
//! setting overrides it. Imports only the framework's public API.

use axum::body::Body;
use axum::http::{Request, StatusCode};
use axum::Router;
use laterite_admin::settings::{save, BrandSetting};
use laterite_admin::{router, AdminConfig, Contributions};
use laterite_auth::{AuthConfig, AuthService, NewOperator, RequestContext};
use laterite_core::{CatalogStore, Db};
use std::sync::Arc;
use tower::ServiceExt;

/// A fresh test database with the admin's built-in migrations applied. Hold the
/// guard for the test's lifetime.
async fn test_db() -> (Db, laterite_core::testing::TestGuard) {
    laterite_core::testing::connect_test(&laterite_admin::builtin_migrations()).await
}

/// The admin router with a configured application name, mounted at `/admin`.
fn app(db: Db, app_name: &str) -> Router {
    app_at(db, app_name, "/admin")
}

/// The admin router mounted at a specific path, for the panel-relocation test.
fn app_at(db: Db, app_name: &str, path: &str) -> Router {
    let auth = AuthService::new(db.clone(), AuthConfig::default());
    let mut config = AdminConfig::default();
    config.app_name = app_name.to_string();
    config.path = path.to_string();
    router(
        auth,
        db,
        Contributions::default(),
        config,
        Arc::new(CatalogStore::default()),
    )
}

/// GETs a path and returns the status and body. A fresh install (no operators)
/// serves the first-run setup page at `/admin/setup`, which renders the brand.
async fn get(router: Router, path: &str) -> (StatusCode, String) {
    let resp = router
        .oneshot(
            Request::builder()
                .method("GET")
                .uri(path)
                .body(Body::empty())
                .unwrap(),
        )
        .await
        .unwrap();
    let status = resp.status();
    let bytes = axum::body::to_bytes(resp.into_body(), usize::MAX)
        .await
        .unwrap();
    (status, String::from_utf8(bytes.to_vec()).unwrap())
}

#[tokio::test]
async fn configured_app_name_is_the_brand() {
    let (db, _guard) = test_db().await;
    let (status, html) = get(app(db, "Acme Blog"), "/admin/setup").await;
    assert_eq!(status, StatusCode::OK);
    // The brand shows in the heading; the hardcoded "Laterite" wordmark is gone.
    assert!(html.contains("Acme Blog"), "shows the configured app name");
    assert!(!html.contains("<h1>Laterite</h1>"), "no hardcoded brand");
}

#[tokio::test]
async fn branding_form_prefills_the_configured_name() {
    let (db, _guard) = test_db().await;

    // A superuser to sign in with (the branding form is a protected route).
    let auth = AuthService::new(db.clone(), AuthConfig::default());
    auth.create_superuser(NewOperator {
        username: "root",
        email: "root@acme.test",
        first_name: "Root",
        last_name: None,
        password: "rootpw12345",
        timezone: None,
    })
    .await
    .unwrap();
    let token = auth
        .authenticate("root", "rootpw12345", &RequestContext::default())
        .await
        .unwrap()
        .token;

    // Open the branding settings form with no brand setting saved yet.
    let resp = app(db, "Configured Name")
        .oneshot(
            Request::builder()
                .method("GET")
                .uri("/admin/settings/branding")
                .header("cookie", format!("laterite_session={token}"))
                .body(Body::empty())
                .unwrap(),
        )
        .await
        .unwrap();
    assert_eq!(resp.status(), StatusCode::OK);
    let bytes = axum::body::to_bytes(resp.into_body(), usize::MAX)
        .await
        .unwrap();
    let html = String::from_utf8(bytes.to_vec()).unwrap();
    // The application-name field is prefilled with the configured name rather
    // than opening blank.
    assert!(
        html.contains(r#"value="Configured Name""#),
        "branding form seeds the configured app name into the field"
    );
}

#[tokio::test]
async fn powered_by_laterite_attribution_is_shown() {
    let (db, _guard) = test_db().await;

    // The first-run setup screen carries the attribution (unauthenticated).
    let (status, html) = get(app(db.clone(), "Acme"), "/admin/setup").await;
    assert_eq!(status, StatusCode::OK);
    assert!(
        html.contains("Powered by Laterite"),
        "setup shows attribution"
    );
    assert!(
        html.contains("https://laterite.rs"),
        "attribution links to the site"
    );

    // The in-app user menu (base.html) carries it on an authenticated page.
    let auth = AuthService::new(db.clone(), AuthConfig::default());
    auth.create_superuser(NewOperator {
        username: "root",
        email: "root@acme.test",
        first_name: "Root",
        last_name: None,
        password: "rootpw12345",
        timezone: None,
    })
    .await
    .unwrap();
    let token = auth
        .authenticate("root", "rootpw12345", &RequestContext::default())
        .await
        .unwrap()
        .token;
    let resp = app(db, "Acme")
        .oneshot(
            Request::builder()
                .method("GET")
                .uri("/admin")
                .header("cookie", format!("laterite_session={token}"))
                .body(Body::empty())
                .unwrap(),
        )
        .await
        .unwrap();
    let bytes = axum::body::to_bytes(resp.into_body(), usize::MAX)
        .await
        .unwrap();
    let html = String::from_utf8(bytes.to_vec()).unwrap();
    assert!(
        html.contains("Powered by Laterite"),
        "the in-app user menu shows the attribution"
    );
}

#[tokio::test]
async fn custom_admin_path_moves_the_whole_panel() {
    let (db, _guard) = test_db().await;

    // Mounted at /manage, the first-run setup screen answers there, and every
    // link it renders (form action, assets) points under the configured mount.
    let (status, html) = get(app_at(db.clone(), "Acme", "/manage"), "/manage/setup").await;
    assert_eq!(status, StatusCode::OK);
    assert!(
        html.contains("Acme"),
        "the panel renders under the new mount"
    );
    assert!(
        html.contains(r#"action="/manage/setup""#),
        "the form posts under the mount"
    );
    // The stylesheet URL carries a content digest, so match the mount and the
    // extension rather than the whole name.
    assert!(
        html.contains("/manage/assets/laterite.") && html.contains(".css"),
        "assets load under the mount"
    );
    assert!(
        !html.contains("/admin/"),
        "nothing points at the default mount"
    );

    // The default path no longer serves the panel once it has moved.
    let (status, _) = get(app_at(db, "Acme", "/manage"), "/admin/setup").await;
    assert_eq!(status, StatusCode::NOT_FOUND);
}

#[tokio::test]
async fn brand_setting_overrides_the_configured_name() {
    let (db, _guard) = test_db().await;
    save(
        &db,
        &BrandSetting {
            app_name: "Override Co".to_string(),
        },
    )
    .await
    .unwrap();

    let (status, html) = get(app(db, "Acme Blog"), "/admin/setup").await;
    assert_eq!(status, StatusCode::OK);
    assert!(html.contains("Override Co"), "the setting overrides config");
    assert!(!html.contains("Acme Blog"), "the config name is overridden");
}