keep/src/meta_plugin/mod.rs

use log::debug;
use serde::{Deserialize, Serialize};

pub mod command;
pub mod digest;
pub mod magic;
pub mod binary;
pub mod text;
pub mod read_time;
pub mod read_rate;
pub mod hostname;
pub mod cwd;
pub mod user;
pub mod shell;
pub mod shell_pid;
pub mod keep_pid;

use crate::meta_plugin::command::MetaPluginCommand;
use crate::meta_plugin::digest::DigestMetaPlugin;
use crate::meta_plugin::read_time::ReadTimeMetaPlugin;
use crate::meta_plugin::read_rate::ReadRateMetaPlugin;
use crate::meta_plugin::magic::MagicFileMetaPlugin;
use crate::meta_plugin::binary::BinaryMetaPlugin;
use crate::meta_plugin::text::TextMetaPlugin;
use crate::meta_plugin::hostname::HostnameMetaPlugin;
use crate::meta_plugin::cwd::CwdMetaPlugin;
use crate::meta_plugin::user::UserMetaPlugin;
use crate::meta_plugin::shell::ShellMetaPlugin;
use crate::meta_plugin::shell_pid::ShellPidMetaPlugin;
use crate::meta_plugin::keep_pid::KeepPidMetaPlugin;

/// Represents metadata to be stored
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MetaData {
    pub name: String,
    pub value: String,
}

/// Response from meta plugin operations
#[derive(Debug, Default, Clone, Serialize, Deserialize)]
pub struct MetaPluginResponse {
    pub metadata: Vec<MetaData>,
    pub is_finalized: bool,
}

/// Base implementation for meta plugins to reduce boilerplate
#[derive(Debug, Clone, Default)]
pub struct BaseMetaPlugin {
    pub outputs: std::collections::HashMap<String, serde_yaml::Value>,
    pub options: std::collections::HashMap<String, serde_yaml::Value>,
    pub meta_name: String,
    pub is_finalized: bool,
}

impl BaseMetaPlugin {
    pub fn new() -> Self {
        Self::default()
    }
    
    pub fn outputs(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
        &self.outputs
    }
    
    pub fn outputs_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
        &mut self.outputs
    }
    
    pub fn options(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
        &self.options
    }
    
    pub fn options_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
        &mut self.options
    }
    
    /// Helper function to initialize plugin options and outputs
    pub fn initialize_plugin(
        &mut self,
        default_outputs: &[&str],
        options: Option<std::collections::HashMap<String, serde_yaml::Value>>,
        outputs: Option<std::collections::HashMap<String, serde_yaml::Value>>,
    ) {
        // Set default outputs
        for output_name in default_outputs {
            self.outputs.insert(output_name.to_string(), serde_yaml::Value::String(output_name.to_string()));
        }
        
        // Apply provided options and outputs
        if let Some(opts) = options {
            self.options.extend(opts);
        }
        if let Some(outs) = outputs {
            self.outputs.extend(outs);
        }
    }
}

impl MetaPlugin for BaseMetaPlugin {
    fn meta_name(&self) -> String {
        self.meta_name.clone()
    }
    
    fn outputs(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
        &self.outputs
    }
    
    fn outputs_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
        &mut self.outputs
    }
    
    fn options(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
        &self.options
    }
    
    fn options_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
        &mut self.options
    }
}

#[derive(Debug, Eq, PartialEq, Clone, strum::EnumIter, strum::Display, strum::EnumString, Serialize, Deserialize)]
#[strum(serialize_all = "snake_case", ascii_case_insensitive)]
pub enum MetaPluginType {
    MagicFile,
    Cwd,
    Binary,
    Text,
    User,
    Shell,
    ShellPid,
    KeepPid,
    Digest,
    ReadTime,
    ReadRate,
    Hostname,
    Command,
}

/// Central function to handle metadata output with name mapping
/// outputs: HashMap where key is internal name, value is either custom name or "false" to disable
pub fn process_metadata_outputs(internal_name: &str, value: serde_yaml::Value, outputs: &std::collections::HashMap<String, serde_yaml::Value>) -> Option<MetaData> {
    // Check if this output is disabled
    if let Some(mapping) = outputs.get(internal_name) {
        if let Some(false_val) = mapping.as_bool() {
            if !false_val {
                debug!("META: Skipping disabled output: {}", internal_name);
                return None;
            }
        }
        if let Some(custom_name) = mapping.as_str() {
            // Convert the value to a string representation
            let value_str = match &value {
                serde_yaml::Value::Null => "null".to_string(),
                serde_yaml::Value::Bool(b) => b.to_string(),
                serde_yaml::Value::Number(n) => n.to_string(),
                serde_yaml::Value::String(s) => s.clone(),
                serde_yaml::Value::Sequence(_) => serde_yaml::to_string(&value).unwrap_or_else(|_| "".to_string()),
                serde_yaml::Value::Mapping(_) => serde_yaml::to_string(&value).unwrap_or_else(|_| "".to_string()),
                serde_yaml::Value::Tagged(_) => serde_yaml::to_string(&value).unwrap_or_else(|_| "".to_string()),
            };
            debug!("META: Processing metadata: internal_name={}, custom_name={}, value={}", internal_name, custom_name, value_str);
            return Some(MetaData {
                name: custom_name.to_string(),
                value: value_str,
            });
        }
    }
    
    // Convert the value to a string representation
    let value_str = match &value {
        serde_yaml::Value::Null => "null".to_string(),
        serde_yaml::Value::Bool(b) => b.to_string(),
        serde_yaml::Value::Number(n) => n.to_string(),
        serde_yaml::Value::String(s) => s.clone(),
        serde_yaml::Value::Sequence(_) => serde_yaml::to_string(&value).unwrap_or_else(|_| "".to_string()),
        serde_yaml::Value::Mapping(_) => serde_yaml::to_string(&value).unwrap_or_else(|_| "".to_string()),
        serde_yaml::Value::Tagged(_) => serde_yaml::to_string(&value).unwrap_or_else(|_| "".to_string()),
    };
    
    // Default: use internal name as output name
    debug!("META: Processing metadata: name={}, value={}", internal_name, value_str);
    Some(MetaData {
        name: internal_name.to_string(),
        value: value_str,
    })
}

pub trait MetaPlugin where Self: 'static {
    fn is_supported(&self) -> bool {
        true
    }
    
    fn is_internal(&self) -> bool {
        true
    }
    
    // Check if the plugin is already finalized
    fn is_finalized(&self) -> bool {
        false
    }
    
    // Set the finalized state (only for plugins that can track this)
    fn set_finalized(&mut self, _finalized: bool) {}
    
    // Update the meta plugin with new data
    fn update(&mut self, _data: &[u8]) -> MetaPluginResponse {
        // Default implementation does nothing
        MetaPluginResponse {
            metadata: Vec::new(),
            is_finalized: false,
        }
    }

    fn finalize(&mut self) -> MetaPluginResponse {
        // Default implementation does nothing
        MetaPluginResponse {
            metadata: Vec::new(),
            is_finalized: true,
        }
    }

    fn meta_name(&self) -> String;
    
    // Get program information for display in status
    fn program_info(&self) -> Option<(&str, Vec<&str>)> {
        None
    }
    
    // Initialize the plugin
    fn initialize(&mut self) -> MetaPluginResponse {
        // Default implementation does nothing
        MetaPluginResponse {
            metadata: Vec::new(),
            is_finalized: false,
        }
    }
    
    // Access to outputs mapping with default implementation
    fn outputs(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
        use once_cell::sync::Lazy;
        static EMPTY: Lazy<std::collections::HashMap<String, serde_yaml::Value>> = 
            Lazy::new(|| std::collections::HashMap::new());
        &EMPTY
    }
    
    fn outputs_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
        panic!("outputs_mut() not implemented for this plugin")
    }
    
    // Access to options mapping with default implementation
    fn options(&self) -> &std::collections::HashMap<String, serde_yaml::Value> {
        use once_cell::sync::Lazy;
        static EMPTY: Lazy<std::collections::HashMap<String, serde_yaml::Value>> = 
            Lazy::new(|| std::collections::HashMap::new());
        &EMPTY
    }
    
    fn options_mut(&mut self) -> &mut std::collections::HashMap<String, serde_yaml::Value> {
        panic!("options_mut() not implemented for this plugin")
    }
    
    // Get the default output names this plugin can produce
    fn default_outputs(&self) -> Vec<String> {
        // Default implementation returns empty - plugins should override this
        Vec::new()
    }
    
    
    
    // Method to downcast to concrete type (for checking finalization state)
    fn as_any_mut(&mut self) -> &mut dyn std::any::Any where Self: Sized {
        self
    }
}

pub fn get_meta_plugin(
    meta_plugin_type: MetaPluginType,
    options: Option<std::collections::HashMap<String, serde_yaml::Value>>,
    outputs: Option<std::collections::HashMap<String, serde_yaml::Value>>,
) -> Box<dyn MetaPlugin> {
    match meta_plugin_type {
        MetaPluginType::MagicFile => Box::new(MagicFileMetaPlugin::new(options, outputs)),
        MetaPluginType::Cwd => Box::new(CwdMetaPlugin::new(options, outputs)),
        MetaPluginType::Binary => Box::new(BinaryMetaPlugin::new(options, outputs)),
        MetaPluginType::Text => Box::new(TextMetaPlugin::new(options, outputs)),
        MetaPluginType::User => Box::new(UserMetaPlugin::new(options, outputs)),
        MetaPluginType::Shell => Box::new(ShellMetaPlugin::new(options, outputs)),
        MetaPluginType::ShellPid => Box::new(ShellPidMetaPlugin::new(options, outputs)),
        MetaPluginType::KeepPid => Box::new(KeepPidMetaPlugin::new(options, outputs)),
        MetaPluginType::Digest => Box::new(DigestMetaPlugin::new(options, outputs)),
        MetaPluginType::ReadTime => Box::new(ReadTimeMetaPlugin::new(options, outputs)),
        MetaPluginType::ReadRate => Box::new(ReadRateMetaPlugin::new(options, outputs)),
        MetaPluginType::Hostname => Box::new(HostnameMetaPlugin::new(options, outputs)),
        MetaPluginType::Command => {
            // For command type, we need to parse the command from options
            let mut program_name = String::new();
            let mut args = Vec::new();
            let mut meta_name = "command".to_string();
            let mut split_whitespace = true;
            
            if let Some(opts) = &options {
                if let Some(command_value) = opts.get("command") {
                    if let Some(command_str) = command_value.as_str() {
                        let parts: Vec<&str> = command_str.split_whitespace().collect();
                        if !parts.is_empty() {
                            program_name = parts[0].to_string();
                            args = parts[1..].iter().map(|s| s.to_string()).collect();
                        }
                    }
                }
                // Handle other options if needed
                if let Some(split_value) = opts.get("split_whitespace") {
                    if let Some(split_bool) = split_value.as_bool() {
                        split_whitespace = split_bool;
                    }
                }
                if let Some(name_value) = opts.get("name") {
                    if let Some(name_str) = name_value.as_str() {
                        meta_name = name_str.to_string();
                    }
                }
            }
            
            Box::new(MetaPluginCommand::new(&program_name, 
                                           args.iter().map(|s| s.as_str()).collect(), 
                                           meta_name, 
                                           split_whitespace, 
                                           options, 
                                           outputs))
        }
    }
}