threatflux-cache 0.1.8

//! Search and query functionality for cache entries

use chrono::{DateTime, Utc};
use serde::{Deserialize, Serialize};

/// Trait for searchable cache entries
pub trait Searchable {
    /// Query type for searching
    type Query;

    /// Check if this entry matches the query
    fn matches(&self, query: &Self::Query) -> bool;
}

/// Basic search query for cache entries
#[derive(Debug, Clone, Serialize, Deserialize, Default)]
pub struct SearchQuery {
    /// Pattern to match in string representation
    pub pattern: Option<String>,
    /// Minimum timestamp
    pub min_timestamp: Option<DateTime<Utc>>,
    /// Maximum timestamp
    pub max_timestamp: Option<DateTime<Utc>>,
    /// Minimum access count
    pub min_access_count: Option<u64>,
    /// Maximum access count
    pub max_access_count: Option<u64>,
    /// Include expired entries
    pub include_expired: bool,
    /// Category filter
    pub category: Option<String>,
    /// Custom predicates as JSON
    #[cfg(feature = "json-serialization")]
    pub custom_predicates: Option<serde_json::Value>,
    /// Custom predicates as string (when JSON feature is disabled)
    #[cfg(not(feature = "json-serialization"))]
    pub custom_predicates: Option<String>,
}

impl SearchQuery {
    /// Create a new empty search query
    pub fn new() -> Self {
        Self::default()
    }

    /// Set pattern to search for
    pub fn with_pattern<S: Into<String>>(mut self, pattern: S) -> Self {
        self.pattern = Some(pattern.into());
        self
    }

    /// Set timestamp range
    pub fn with_timestamp_range(
        mut self,
        min: Option<DateTime<Utc>>,
        max: Option<DateTime<Utc>>,
    ) -> Self {
        self.min_timestamp = min;
        self.max_timestamp = max;
        self
    }

    /// Set access count range
    pub fn with_access_count_range(mut self, min: Option<u64>, max: Option<u64>) -> Self {
        self.min_access_count = min;
        self.max_access_count = max;
        self
    }

    /// Set whether to include expired entries
    pub fn include_expired(mut self, include: bool) -> Self {
        self.include_expired = include;
        self
    }

    /// Set category filter
    pub fn with_category<S: Into<String>>(mut self, category: S) -> Self {
        self.category = Some(category.into());
        self
    }
}

/// Extended search capabilities
pub trait ExtendedSearch<T> {
    /// Find entries matching a predicate
    fn find_where<F>(&self, predicate: F) -> Vec<T>
    where
        F: Fn(&T) -> bool;

    /// Count entries matching a predicate
    fn count_where<F>(&self, predicate: F) -> usize
    where
        F: Fn(&T) -> bool;

    /// Check if any entry matches a predicate
    fn any<F>(&self, predicate: F) -> bool
    where
        F: Fn(&T) -> bool;

    /// Check if all entries match a predicate
    fn all<F>(&self, predicate: F) -> bool
    where
        F: Fn(&T) -> bool;
}

/// Search result with relevance scoring
#[derive(Debug, Clone)]
pub struct SearchResult<T> {
    /// The matched item
    pub item: T,
    /// Relevance score (0.0 to 1.0)
    pub score: f64,
    /// Match details
    pub match_details: Vec<String>,
}

impl<T> SearchResult<T> {
    /// Create a new search result
    pub fn new(item: T, score: f64) -> Self {
        Self {
            item,
            score,
            match_details: Vec::new(),
        }
    }

    /// Add match detail
    pub fn with_detail<S: Into<String>>(mut self, detail: S) -> Self {
        self.match_details.push(detail.into());
        self
    }
}

/// Implement Searchable for common types
impl<K, V, M> Searchable for crate::CacheEntry<K, V, M>
where
    K: Clone + std::hash::Hash + Eq + std::fmt::Display,
    V: Clone + std::fmt::Debug,
    M: Clone + crate::EntryMetadata,
{
    type Query = SearchQuery;

    fn matches(&self, query: &Self::Query) -> bool {
        // Check expiry
        if !query.include_expired && self.is_expired() {
            return false;
        }

        // Check pattern in key
        if let Some(ref pattern) = query.pattern {
            let key_str = self.key.to_string();
            if !key_str.contains(pattern) {
                return false;
            }
        }

        // Check timestamp range
        if let Some(min_ts) = query.min_timestamp {
            if self.timestamp < min_ts {
                return false;
            }
        }

        if let Some(max_ts) = query.max_timestamp {
            if self.timestamp > max_ts {
                return false;
            }
        }

        // Check access count range
        if let Some(min_count) = query.min_access_count {
            if self.access_count < min_count {
                return false;
            }
        }

        if let Some(max_count) = query.max_access_count {
            if self.access_count > max_count {
                return false;
            }
        }

        // Check category
        if let Some(ref category) = query.category {
            if let Some(entry_category) = self.metadata.category() {
                if entry_category != category {
                    return false;
                }
            } else {
                return false;
            }
        }

        true
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use crate::CacheEntry;

    #[test]
    fn test_search_query_builder() {
        let query = SearchQuery::new()
            .with_pattern("test")
            .with_access_count_range(Some(5), Some(10))
            .include_expired(true);

        assert_eq!(query.pattern, Some("test".to_string()));
        assert_eq!(query.min_access_count, Some(5));
        assert_eq!(query.max_access_count, Some(10));
        assert!(query.include_expired);
    }

    #[test]
    #[allow(clippy::type_complexity)]
    fn test_cache_entry_search() {
        let mut entry: CacheEntry<String, String, ()> =
            CacheEntry::new("test_key".to_string(), "test_value".to_string());
        entry.access_count = 7;

        // Test pattern matching
        let query1 = SearchQuery::new().with_pattern("test");
        assert!(entry.matches(&query1));

        let query2 = SearchQuery::new().with_pattern("notfound");
        assert!(!entry.matches(&query2));

        // Test access count range
        let query3 = SearchQuery::new().with_access_count_range(Some(5), Some(10));
        assert!(entry.matches(&query3));

        let query4 = SearchQuery::new().with_access_count_range(Some(10), None);
        assert!(!entry.matches(&query4));
    }
}