// file: crates/ksp-app-solprices-desk/src/dto_common.rs
// version: 3

//! Common Tauri DTOs shared by the SOL Prices Desk shell.

use ts_rs::TS; // rust-rules: trait-import

/// Safe command error projection that never serializes arbitrary KSP error context or source values.
#[derive(Clone, Debug, serde::Serialize, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export, export_to = "../frontend/ts/bindings/ksp_app_solprices_desk/dto_common/CommandErrorDto.ts")]
pub(crate) struct CommandErrorDto {
    /// Stable KSP error domain.
    pub(crate) domain: String,
    /// Stable KSP error code within the domain.
    pub(crate) code: String,
    /// Human-readable error message without arbitrary context fields.
    pub(crate) message: String,
}

impl crate::CommandErrorDto {
    /// Builds a bounded safe projection from a KSP error.
    #[must_use]
    pub(crate) fn from_error(error: &ksp_core_lib::Error) -> Self {
        return Self {
            domain: error.code().domain().to_owned(),
            code: error.code().code().to_owned(),
            message: error.message().to_owned(),
        };
    }
}

/// Safe provider-neutral application/runtime snapshot exposed to the SOL Prices Desk shell.
#[derive(Clone, Debug, serde::Serialize, TS)]
#[serde(rename_all = "camelCase")]
#[ts(export, export_to = "../frontend/ts/bindings/ksp_app_solprices_desk/dto_common/MarketPriceRuntimeStatusDto.ts")]
pub(crate) struct MarketPriceRuntimeStatusDto {
    /// SOL Prices Desk composite profile selected for this launch.
    pub(crate) active_composite_profile: String,
    /// Active configured Logging profile, or `None` while transient fallback Logging is active.
    pub(crate) active_logging_profile: std::option::Option<String>,
    /// Standard Off-chain Transport profile selected by the active composite.
    pub(crate) active_offchain_profile: String,
    /// Cargo application version.
    pub(crate) application_version: String,
    /// Number of logical Config resources registered by the current runtime.
    pub(crate) config_document_count: u32,
    /// Whether SOL Prices Desk had to install its transient in-memory Logging fallback.
    pub(crate) fallback_logging_active: bool,
    /// Total number of configured provider-neutral market-price rows.
    pub(crate) provider_count: u32,
    /// Number of providers currently classified as immediately ready.
    pub(crate) ready_provider_count: u32,
    /// Current implementation phase exposed by the shell.
    pub(crate) shell_phase: String,
    /// Safe startup diagnostic that caused fallback Logging, when applicable.
    pub(crate) startup_diagnostic: std::option::Option<CommandErrorDto>,
    /// Number of providers currently not classified as immediately ready.
    pub(crate) unavailable_provider_count: u32,
}

#[cfg(test)]
#[path = "../unit_tests/dto_common.rs"]
mod tests;