nx9-url-shortener/src/cli/mod.rs

use clap::{Parser, Subcommand};

pub mod admin_migrate;
pub mod backup;
pub mod backup_user;
pub mod create_admin;
pub mod create_user;
pub mod delete_user;
pub mod disable_user;
pub mod doctor;
pub mod enable_user;
pub mod expand;
pub mod list_users;
pub mod migrate;
pub mod repair;
pub mod reset_password;
pub mod restore;
pub mod restore_user;
pub mod serve;
pub mod shorten;
pub mod stats;
pub mod validate;

#[derive(Parser)]
#[command(name = "bzod")]
#[command(about = "BZOD - Personal Redirector & Landing Page Platform")]
pub struct Cli {
    #[command(subcommand)]
    pub command: Commands,
}

#[derive(Subcommand)]
pub enum Commands {
    /// Start the BZOD web server
    Serve {
        #[arg(long)]
        host: Option<String>,
        #[arg(long)]
        port: Option<u16>,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Create a tar.gz backup of all databases
    Backup {
        #[arg(long)]
        out: Option<String>,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Restore databases from a tar.gz backup file
    Restore {
        #[arg(long, required = true)]
        file: String,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Apply pending database schema migrations
    Migrate {
        #[arg(long)]
        data_dir: Option<String>,
        /// Show what migrations would be applied without executing them
        #[arg(long)]
        dry_run: bool,
    },
    /// Print database statistics and record counts in the terminal
    Stats {
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Perform a one-shot validation of all registered short link destinations
    Validate {
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Create a new administrator user in the database
    CreateAdmin {
        #[arg(long)]
        username: Option<String>,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Run database diagnostics and health checks
    Doctor {
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Shorten a URL (Feature 3)
    Shorten {
        /// The destination URL to shorten
        target_url: String,
        /// Custom slug (starting with ! followed by a-z, 0-9, -, _)
        #[arg(long)]
        slug: Option<String>,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Expand a shortened code or custom slug to its destination URL (Feature 4)
    Expand {
        /// The short code or custom slug to expand
        code: String,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Create a new standard user in the database
    CreateUser {
        #[arg(long)]
        username: Option<String>,
        #[arg(long)]
        password: Option<String>,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Delete a standard user and all their databases/slugs
    DeleteUser {
        /// User ID to delete
        user_id: i64,
        /// Force deletion of system account/legacy_admin
        #[arg(long)]
        force: bool,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Disable a standard user
    DisableUser {
        /// User ID to disable
        user_id: i64,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Enable a standard user
    EnableUser {
        /// User ID to enable
        user_id: i64,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Reset standard user's password
    ResetPassword {
        /// User ID to reset
        user_id: i64,
        #[arg(long)]
        password: Option<String>,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// List all standard/system users
    ListUsers {
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Backup a standard user's databases to a .tar.zst package
    BackupUser {
        /// Username to backup
        username: String,
        /// Output .tar.zst filepath
        #[arg(long)]
        out: Option<String>,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// Restore a standard user's databases from a .tar.zst package
    RestoreUser {
        /// Input .tar.zst package path
        #[arg(long, required = true)]
        file: String,
        #[arg(long)]
        data_dir: Option<String>,
    },
    /// FUTURE: Migrate legacy admin content to a specific admin tenant database
    AdminMigrate {
        /// Target Admin ID
        target_admin_id: i64,
        #[arg(long)]
        data_dir: Option<String>,
        /// Preview what would be moved without making changes
        #[arg(long)]
        dry_run: bool,
        /// Force the migration to execute
        #[arg(long)]
        force: bool,
    },
    /// Repair registry and database inconsistencies
    Repair {
        #[command(subcommand)]
        command: RepairCommands,
    },
}

#[derive(clap::Subcommand)]
pub enum RepairCommands {
    /// Repair Global Slug Registry inconsistencies
    Registry {
        #[arg(long)]
        dry_run: bool,
        #[arg(long)]
        force: bool,
        #[arg(long)]
        slug: Option<String>,
        #[arg(long)]
        data_dir: Option<String>,
    },
}