datafold 0.1.55

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

use crate::schema::types::schema::Schema;

/// Report of schema discovery and loading operations
#[derive(Debug, Serialize, Deserialize)]
pub struct SchemaLoadingReport {
    /// All schemas discovered from any source
    pub discovered_schemas: Vec<String>,
    /// Schemas currently loaded (approved state)
    pub loaded_schemas: Vec<String>,
    /// Schemas that failed to load with error messages
    pub failed_schemas: Vec<(String, String)>,
    /// Current state of all known schemas
    pub schema_states: HashMap<String, SchemaState>,
    /// Source where each schema was discovered
    pub loading_sources: HashMap<String, SchemaSource>,
    /// Timestamp of last discovery operation
    pub last_updated: chrono::DateTime<chrono::Utc>,
}

/// Source of a discovered schema
#[derive(Debug, Serialize, Deserialize)]
pub enum SchemaSource {
    /// Schema from available_schemas/ directory
    AvailableDirectory,
    /// Schema from data/schemas/ directory
    DataDirectory,
    /// Schema from previously saved state
    Persistence,
}

/// State of a schema within the system
#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default)]
pub enum SchemaState {
    /// Schema discovered from files but not yet approved by user
    #[default]
    Available,
    /// Schema approved by user, can be queried, mutated, field-mapped and transforms run
    Approved,
    /// Schema blocked by user, cannot be queried or mutated but field-mapping and transforms still run
    Blocked,
}

/// Schema definition bundled with its current state for UI/API responses
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SchemaWithState {
    /// All schema fields serialized at the top level
    #[serde(flatten)]
    pub schema: Schema,
    /// Current state of the schema
    pub state: SchemaState,
}

impl SchemaWithState {
    /// Create a new [`SchemaWithState`] from components
    pub fn new(schema: Schema, state: SchemaState) -> Self {
        Self { schema, state }
    }

    /// Access the schema name (helper to avoid cloning when only the name is needed)
    pub fn name(&self) -> &str {
        &self.schema.name
    }
}