umbral-admin 0.0.12

//! Runtime model discovery — walks the framework's plugin registry to
//! produce a `(plugin_name, ModelMeta)` list every handler can iterate
//! without re-implementing the framework's discovery logic.
//!
//! Cheap enough to call per request (it's an in-memory walk, no I/O).
//! Callers that need stable iteration order between calls should
//! collect into a sorted `Vec`.

use umbral::migrate::{Column, ModelMeta};

/// Every registered model, paired with the plugin that owns it.
pub(crate) fn discover_models() -> Vec<(String, ModelMeta)> {
    let mut out: Vec<(String, ModelMeta)> = Vec::new();
    for plugin in umbral::migrate::registered_plugins() {
        for model in umbral::migrate::models_for_plugin(&plugin) {
            out.push((plugin.clone(), model));
        }
    }
    out
}

/// Look up one model by SQL table name. Returns `None` for unknown
/// tables — callers map that to a 404.
pub(crate) fn find_model(table: &str) -> Option<(String, ModelMeta)> {
    discover_models()
        .into_iter()
        .find(|(_, m)| m.table == table)
}

/// Primary-key column descriptor for a model. Every umbral model has a
/// PK by `Model` trait contract, so this is `Option` only because the
/// signature can't express "always Some" without a panic-or-bug branch.
pub(crate) fn pk_column(model: &ModelMeta) -> Option<&Column> {
    model.fields.iter().find(|c| c.primary_key)
}

/// Default list-display when the admin model carries no explicit
/// `list_display`.
///
/// Two-state behaviour:
///
/// 1. If at least one field is tagged `#[umbral(string)]`, render
///    `[<tagged field>, <other short fields>]` — the string
///    representation plus any column compact enough to fit in a table
///    cell. "Short" excludes unbounded `Text` (no `max_length`),
///    `Json`, `Array`, and `FullText` because those tend to be
///    long-form content that blows out the row. The PK isn't
///    rendered as a separate column because every row in the admin
///    is clickable into the sheet, so the id is already reachable.
/// 2. Otherwise show every column. The `string` attribute is the
///    sole opt-in for the compact form; without it the changelist
///    stays at the legacy "show all fields" default, so adding the
///    derive doesn't silently rewrite existing changelists.
pub(crate) fn default_list_display(model: &ModelMeta) -> Vec<String> {
    let str_field_idx = model
        .fields
        .iter()
        .position(|c| c.is_string_repr && !c.primary_key);
    let Some(idx) = str_field_idx else {
        // No opt-in — show every column. Matches pre-#46 behaviour so
        // existing changelists are unchanged.
        return model.fields.iter().map(|c| c.name.clone()).collect();
    };
    let str_name = model.fields[idx].name.clone();
    let mut out = vec![str_name.clone()];
    // Append every other non-PK, non-long field in declaration order
    // so the change feels like "tag the label column, the rest still
    // shows" rather than "tag the label column, everything else
    // disappears."
    for col in &model.fields {
        if col.primary_key {
            continue;
        }
        if col.name == str_name {
            continue;
        }
        if is_long_display_type(col) {
            continue;
        }
        out.push(col.name.clone());
    }
    out
}

/// A column is "long" for changelist purposes when its rendered value
/// is likely to span more than one screen-width of cell. Unbounded
/// `Text` (no `max_length` cap) is the canonical case; `Json`,
/// `Array`, and `FullText` are the same idea. Bounded `Text` is
/// short — that's the whole point of `max_length`.
fn is_long_display_type(col: &Column) -> bool {
    use umbral::orm::SqlType;
    match col.ty {
        SqlType::Text => col.max_length == 0,
        SqlType::Json | SqlType::Array(_) | SqlType::FullText => true,
        _ => false,
    }
}

/// Return the user's saved theme preference (`"dark"` | `"light"` |
/// `"system"`). Falls back to `"dark"` on any error so the page always
/// renders something — this is the server-side read that prevents the
/// theme-flash on first paint.
pub(crate) async fn user_theme(user: &umbral_auth::AuthUser) -> String {
    crate::models::fetch_or_default(user.id)
        .await
        .map(|p| p.theme)
        .unwrap_or_else(|_| "dark".to_string())
}