// rocie - An enterprise grocery management system
//
// Copyright (C) 2026 Benedikt Peetz <benedikt.peetz@b-peetz.de>
// SPDX-License-Identifier: GPL-3.0-or-later
//
// This file is part of Rocie.
//
// You should have received a copy of the License along with this program.
// If not, see <https://www.gnu.org/licenses/gpl-3.0.txt>.

use std::path::PathBuf;

use clap::{Parser, Subcommand};

#[derive(Parser)]
pub(crate) struct CliArgs {
    #[command(subcommand)]
    pub(crate) command: Command,
}

#[derive(Subcommand)]
pub(crate) enum Command {
    /// Serve the server.
    Serve {
        /// Which port to serve the server on.
        ///
        /// Leave empty to let the OS choose a free one.
        #[arg(short, long)]
        port: Option<u16>,

        /// File containing the secret key,
        /// used to sign the JWT cookies handed out to clients (as hex).
        ///
        /// Leave empty to generate a random one.
        /// Note that every client will be signed out, when this value changes (because the
        /// rocie-server will not be able to verify the signatures made with the previous key
        /// anymore).
        ///
        /// As there are some requirements that this key needs to fulfill, you can use the
        /// `generate-key` sub-command to generate a compliant key.
        /// E.g.
        /// ```sh
        /// rocie-server generate-key > ./key.hex
        /// rocie-server serve --secret-key-file ./key.hex ..
        /// ```
        #[arg(short, long, verbatim_doc_comment)]
        secret_key_file: Option<PathBuf>,

        /// Print the used port as single u16 to stdout when started.
        ///
        /// This can be used to determine the used port, when the `port` was left at `None`.
        #[arg(long)]
        print_port: bool,

        /// Which host to serve the server on.
        #[arg(short = 'b', long, default_value = "127.0.0.1")]
        host: String,

        /// Path to the database to use to store data.
        #[arg(short, long, env = "ROCIE_DB_PATH")]
        db_path: PathBuf,
    },

    /// Print the `OpenAPI` API documentation to stdout.
    OpenApi,

    /// Generate (and print to stdout) a compliant secret key for use in the `serve --secret-key`
    /// argument.
    GenerateKey,
}