flatland3 0.2.17

//! Character list / create — explicit only; play never auto-creates.

use clap::Subcommand;

use crate::characters::{self, CharacterSummary};
use crate::config::SessionConfig;

#[derive(Debug, Subcommand)]
#[command(
    about = "List or create characters (requires login session)",
    long_about = "Characters are created only through this command (or POST /v1/characters).\n\
                  Play never auto-creates — use an existing name or create one first."
)]
pub enum CharacterCommand {
    /// List characters on the logged-in account
    List,
    /// Create a character (session auth only; names are unique per account)
    Create {
        /// Character name (letters, digits, _ and -; 1–32 chars; must start with a letter)
        name: String,
    },
}

pub async fn run(command: CharacterCommand, json: bool) -> anyhow::Result<()> {
    match command {
        CharacterCommand::List => list(json).await,
        CharacterCommand::Create { name } => create(&name, json).await,
    }
}

async fn list(json: bool) -> anyhow::Result<()> {
    let session = SessionConfig::load()?;
    let characters = characters::list_characters().await?;

    if json {
        println!("{}", serde_json::to_string_pretty(&characters)?);
        return Ok(());
    }

    if characters.is_empty() {
        println!("No characters yet. Create one:");
        println!("  flatland3 character create <Name>");
        return Ok(());
    }

    println!("Characters ({}):", characters.len());
    for c in &characters {
        let marker = if session.last_character_id == Some(c.id) {
            " *"
        } else {
            ""
        };
        println!("  {}  {}{}", c.name, c.id, marker);
    }
    if session.last_character_id.is_some() {
        println!("  (* last used for play)");
    }
    Ok(())
}

async fn create(name: &str, json: bool) -> anyhow::Result<()> {
    let created: CharacterSummary = characters::create_character(name).await?;

    if json {
        println!("{}", serde_json::to_string_pretty(&created)?);
        return Ok(());
    }

    println!(
        "Created character \"{}\" ({})",
        created.name, created.id
    );
    println!("Play with: flatland3 --name {}", created.name);
    Ok(())
}

#[cfg(test)]
mod tests {
    use crate::characters::validate_character_name;

    #[test]
    fn accepts_simple_names() {
        assert!(validate_character_name("madsin").is_ok());
        assert!(validate_character_name("Mad_Sin-2").is_ok());
    }

    #[test]
    fn rejects_colon_junk() {
        assert!(validate_character_name("madsin:3A").is_err());
        assert!(validate_character_name("mad sin").is_err());
        assert!(validate_character_name("1mad").is_err());
    }
}