ic-query 0.3.1

//! Module: nns::proposals::run
//!
//! Responsibility: run NNS proposal commands.
//! Does not own: clap specs, report construction internals, or text rendering details.
//! Boundary: maps parsed options into report requests and writes text or JSON output.

use super::{
    options::{
        NnsProposalCacheOptions, NnsProposalListOptions, NnsProposalOptions,
        NnsProposalRefreshOptions,
    },
    report::{
        NnsProposalCacheListRequest, NnsProposalCacheStatusRequest, NnsProposalListRequest,
        NnsProposalRefreshRequest, NnsProposalRequest, build_nns_proposal_cache_list_report,
        build_nns_proposal_cache_status_report, build_nns_proposal_list_report,
        build_nns_proposal_list_report_from_cache, build_nns_proposal_report,
        build_nns_proposal_report_from_cache, nns_proposal_cache_list_report_text,
        nns_proposal_cache_status_report_text, nns_proposal_list_report_text,
        nns_proposal_refresh_report_text, nns_proposal_report_text, refresh_nns_proposal_cache,
    },
};
use crate::{
    cli::common::write_text_or_json,
    nns::{
        NnsCommandError, command_args, command_icp_root, now_unix_secs,
        parse_nns_required_subcommand,
    },
};
use std::ffi::OsString;

const PROPOSAL_CACHE_COMMAND: &str = "cache";
const PROPOSAL_CACHE_LIST_COMMAND: &str = "list";
const PROPOSAL_CACHE_STATUS_COMMAND: &str = "status";
const PROPOSAL_INFO_COMMAND: &str = "info";
const PROPOSAL_LIST_COMMAND: &str = "list";
const PROPOSAL_REFRESH_COMMAND: &str = "refresh";

pub(in crate::nns) fn run<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    run_nns_proposal(args)
}

fn run_nns_proposal_list<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    let Some(args) = command_args(args, super::commands::nns_proposal_list_usage_for_error) else {
        return Ok(());
    };
    let options = NnsProposalListOptions::parse_list(args)?;
    run_nns_proposal_list_with_options(options)
}

fn run_nns_proposal_list_with_options(
    options: NnsProposalListOptions,
) -> Result<(), NnsCommandError> {
    let request = NnsProposalListRequest {
        network: options.network,
        source_endpoint: options.source_endpoint,
        now_unix_secs: now_unix_secs()?,
        limit: options.limit,
        before_proposal_id: options.before_proposal_id,
        status: options.status,
        reward_status: options.reward_status,
        topic: options.topic,
        proposer_neuron_id: options.proposer_neuron_id,
        query: options.query,
        sort: options.sort,
        sort_direction: options.sort_direction,
        verbose: options.verbose,
    };
    let report = build_nns_proposal_list_report_from_cache(&request, &command_icp_root()?)?
        .map_or_else(|| build_nns_proposal_list_report(&request), Ok)?;
    write_text_or_json(options.format, &report, nns_proposal_list_report_text)
}

fn run_nns_proposal<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    let Some(args) = command_args(args, super::commands::nns_proposal_usage_for_error) else {
        return Ok(());
    };
    let (command, args) = parse_nns_required_subcommand(
        super::commands::nns_proposal_command(),
        args,
        super::commands::nns_proposal_usage_for_error,
    )?;
    match command.as_str() {
        PROPOSAL_CACHE_COMMAND => run_nns_proposal_cache(args),
        PROPOSAL_LIST_COMMAND => run_nns_proposal_list(args),
        PROPOSAL_INFO_COMMAND => run_nns_proposal_info(args),
        PROPOSAL_REFRESH_COMMAND => run_nns_proposal_refresh(args),
        _ => unreachable!("nns proposal dispatch only defines known commands"),
    }
}

fn run_nns_proposal_info<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    let Some(args) = command_args(args, super::commands::nns_proposal_info_usage_for_error) else {
        return Ok(());
    };
    let options = NnsProposalOptions::parse_info(args)?;
    run_nns_proposal_with_options(options)
}

fn run_nns_proposal_with_options(options: NnsProposalOptions) -> Result<(), NnsCommandError> {
    let request = NnsProposalRequest {
        network: options.network,
        source_endpoint: options.source_endpoint,
        now_unix_secs: now_unix_secs()?,
        proposal_id: options.proposal_id,
        show_ballots: options.show_ballots,
        verbose: options.verbose,
    };
    let report = build_nns_proposal_report_from_cache(&request, &command_icp_root()?)?
        .map_or_else(|| build_nns_proposal_report(&request), Ok)?;
    write_text_or_json(options.format, &report, nns_proposal_report_text)
}

fn run_nns_proposal_refresh<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    let Some(args) = command_args(args, super::commands::nns_proposal_refresh_usage_for_error)
    else {
        return Ok(());
    };
    let options = NnsProposalRefreshOptions::parse(args)?;
    let request = NnsProposalRefreshRequest {
        network: options.network,
        source_endpoint: options.source_endpoint,
        now_unix_secs: now_unix_secs()?,
        icp_root: command_icp_root()?,
        page_size: options.page_size,
        max_pages: options.max_pages,
    };
    let report = refresh_nns_proposal_cache(&request)?;
    write_text_or_json(options.format, &report, nns_proposal_refresh_report_text)
}

fn run_nns_proposal_cache<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    let Some(args) = command_args(args, super::commands::nns_proposal_cache_usage_for_error) else {
        return Ok(());
    };
    let (command, args) = parse_nns_required_subcommand(
        super::commands::nns_proposal_cache_command(),
        args,
        super::commands::nns_proposal_cache_usage_for_error,
    )?;
    match command.as_str() {
        PROPOSAL_CACHE_LIST_COMMAND => run_nns_proposal_cache_list(args),
        PROPOSAL_CACHE_STATUS_COMMAND => run_nns_proposal_cache_status(args),
        _ => unreachable!("nns proposal cache dispatch only defines known commands"),
    }
}

fn run_nns_proposal_cache_list<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    let Some(args) = command_args(
        args,
        super::commands::nns_proposal_cache_list_usage_for_error,
    ) else {
        return Ok(());
    };
    let options = NnsProposalCacheOptions::parse_list(args)?;
    let request = NnsProposalCacheListRequest {
        network: options.network,
        icp_root: command_icp_root()?,
    };
    let report = build_nns_proposal_cache_list_report(&request)?;
    write_text_or_json(options.format, &report, nns_proposal_cache_list_report_text)
}

fn run_nns_proposal_cache_status<I>(args: I) -> Result<(), NnsCommandError>
where
    I: IntoIterator<Item = OsString>,
{
    let Some(args) = command_args(
        args,
        super::commands::nns_proposal_cache_status_usage_for_error,
    ) else {
        return Ok(());
    };
    let options = NnsProposalCacheOptions::parse_status(args)?;
    let request = NnsProposalCacheStatusRequest {
        network: options.network,
        icp_root: command_icp_root()?,
    };
    let report = build_nns_proposal_cache_status_report(&request)?;
    write_text_or_json(
        options.format,
        &report,
        nns_proposal_cache_status_report_text,
    )
}