drasi-reaction-http 0.1.2

// Copyright 2025 The Drasi Authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

//! HTTP reaction plugin for Drasi
//!
//! This plugin implements HTTP reactions for Drasi and provides extension traits
//! for configuring HTTP reactions in the Drasi plugin architecture.
//!
//! ## Instance-based Usage
//!
//! ```rust,ignore
//! use drasi_reaction_http::{HttpReaction, HttpReactionConfig};
//! use drasi_lib::channels::ComponentEventSender;
//! use std::sync::Arc;
//!
//! // Create configuration
//! let config = HttpReactionConfig {
//!     base_url: "http://api.example.com".to_string(),
//!     token: Some("secret-token".to_string()),
//!     timeout_ms: 5000,
//!     routes: Default::default(),
//! };
//!
//! // Create instance and add to DrasiLib
//! let reaction = Arc::new(HttpReaction::new(
//!     "my-http-reaction",
//!     vec!["query1".to_string()],
//!     config,
//!     event_tx,
//! ));
//! drasi.add_reaction(reaction).await?;
//! ```

pub mod config;
pub mod http;

pub use config::{CallSpec, HttpReactionConfig, QueryConfig};
pub use http::HttpReaction;

use std::collections::HashMap;

/// Builder for HTTP reaction
///
/// Creates an HttpReaction instance with a fluent API.
///
/// # Example
/// ```rust,ignore
/// use drasi_reaction_http::{HttpReaction, HttpReactionBuilder};
///
/// let reaction = HttpReaction::builder("my-http-reaction")
///     .with_queries(vec!["query1".to_string()])
///     .with_base_url("http://api.example.com")
///     .with_token("secret-token")
///     .with_timeout_ms(10000)
///     .build()?;
/// ```
pub struct HttpReactionBuilder {
    id: String,
    queries: Vec<String>,
    base_url: String,
    token: Option<String>,
    timeout_ms: u64,
    routes: HashMap<String, QueryConfig>,
    priority_queue_capacity: Option<usize>,
    auto_start: bool,
}

impl HttpReactionBuilder {
    /// Create a new HTTP reaction builder with the given ID
    pub fn new(id: impl Into<String>) -> Self {
        Self {
            id: id.into(),
            queries: Vec::new(),
            base_url: "http://localhost".to_string(),
            token: None,
            timeout_ms: 5000,
            routes: HashMap::new(),
            priority_queue_capacity: None,
            auto_start: true,
        }
    }

    /// Set the query IDs to subscribe to
    pub fn with_queries(mut self, queries: Vec<String>) -> Self {
        self.queries = queries;
        self
    }

    /// Add a query ID to subscribe to
    pub fn with_query(mut self, query_id: impl Into<String>) -> Self {
        self.queries.push(query_id.into());
        self
    }

    /// Set the base URL for HTTP requests
    pub fn with_base_url(mut self, base_url: impl Into<String>) -> Self {
        self.base_url = base_url.into();
        self
    }

    /// Set the authentication token
    pub fn with_token(mut self, token: impl Into<String>) -> Self {
        self.token = Some(token.into());
        self
    }

    /// Set the request timeout in milliseconds
    pub fn with_timeout_ms(mut self, timeout_ms: u64) -> Self {
        self.timeout_ms = timeout_ms;
        self
    }

    /// Add a route configuration for a specific query
    pub fn with_route(mut self, query_id: impl Into<String>, config: QueryConfig) -> Self {
        self.routes.insert(query_id.into(), config);
        self
    }

    /// Set the priority queue capacity
    pub fn with_priority_queue_capacity(mut self, capacity: usize) -> Self {
        self.priority_queue_capacity = Some(capacity);
        self
    }

    /// Set whether the reaction should auto-start
    pub fn with_auto_start(mut self, auto_start: bool) -> Self {
        self.auto_start = auto_start;
        self
    }

    /// Set the full configuration at once
    pub fn with_config(mut self, config: HttpReactionConfig) -> Self {
        self.base_url = config.base_url;
        self.token = config.token;
        self.timeout_ms = config.timeout_ms;
        self.routes = config.routes;
        self
    }

    /// Build the HTTP reaction
    pub fn build(self) -> anyhow::Result<HttpReaction> {
        let config = HttpReactionConfig {
            base_url: self.base_url,
            token: self.token,
            timeout_ms: self.timeout_ms,
            routes: self.routes,
        };

        Ok(HttpReaction::from_builder(
            self.id,
            self.queries,
            config,
            self.priority_queue_capacity,
            self.auto_start,
        ))
    }
}

#[cfg(test)]
mod tests {
    use super::*;
    use drasi_lib::Reaction;

    #[test]
    fn test_http_builder_defaults() {
        let reaction = HttpReactionBuilder::new("test-reaction").build().unwrap();
        assert_eq!(reaction.id(), "test-reaction");
        let props = reaction.properties();
        assert_eq!(
            props.get("base_url"),
            Some(&serde_json::Value::String("http://localhost".to_string()))
        );
        assert_eq!(
            props.get("timeout_ms"),
            Some(&serde_json::Value::Number(5000.into()))
        );
    }

    #[test]
    fn test_http_builder_custom_values() {
        let reaction = HttpReaction::builder("test-reaction")
            .with_base_url("http://api.example.com") // DevSkim: ignore DS137138
            .with_token("secret-token")
            .with_timeout_ms(10000)
            .with_queries(vec!["query1".to_string()])
            .build()
            .unwrap();

        assert_eq!(reaction.id(), "test-reaction");
        let props = reaction.properties();
        assert_eq!(
            props.get("base_url"),
            Some(&serde_json::Value::String(
                "http://api.example.com".to_string() // DevSkim: ignore DS137138
            ))
        );
        assert_eq!(
            props.get("timeout_ms"),
            Some(&serde_json::Value::Number(10000.into()))
        );
        assert_eq!(reaction.query_ids(), vec!["query1".to_string()]);
    }

    #[test]
    fn test_http_builder_with_query() {
        let reaction = HttpReaction::builder("test-reaction")
            .with_query("query1")
            .with_query("query2")
            .build()
            .unwrap();

        assert_eq!(reaction.query_ids(), vec!["query1", "query2"]);
    }

    #[test]
    fn test_http_new_constructor() {
        let config = HttpReactionConfig {
            base_url: "http://test.example.com".to_string(), // DevSkim: ignore DS137138
            token: Some("test-token".to_string()),
            timeout_ms: 3000,
            routes: Default::default(),
        };

        let reaction = HttpReaction::new("test-reaction", vec!["query1".to_string()], config);

        assert_eq!(reaction.id(), "test-reaction");
        assert_eq!(reaction.query_ids(), vec!["query1".to_string()]);
    }
}