openlark-client 0.17.0

//! OpenLark Client 核心特征
//!
//! 定义客户端的统一接口和行为

use openlark_core::config::Config as CoreConfig;
use std::time::Duration;

/// 🚀 OpenLark客户端核心特征
///
/// 所有OpenLark客户端实现都应该实现此特征
///
/// # 特性要求
/// - 异步支持：所有操作都是异步的
/// - 线程安全：客户端可以跨线程安全使用
/// - 配置访问：可以访问客户端配置
/// - 错误处理：统一的错误处理机制
pub trait LarkClient: Send + Sync {
    /// 🔧 获取客户端配置
    fn config(&self) -> &CoreConfig;

    /// ✅ 检查客户端是否已正确配置
    ///
    /// # 返回值
    /// 返回true如果app_id和app_secret都不为空
    fn is_configured(&self) -> bool {
        !self.config().app_id().is_empty() && !self.config().app_secret().is_empty()
    }

    /// 🔍 获取应用ID
    fn app_id(&self) -> &str {
        self.config().app_id()
    }

    /// 🔑 获取应用密钥
    fn app_secret(&self) -> &str {
        self.config().app_secret()
    }

    /// 🌐 获取API基础URL
    fn base_url(&self) -> &str {
        self.config().base_url()
    }

    /// ⏱️ 获取请求超时时间
    fn timeout(&self) -> Option<Duration> {
        self.config().req_timeout()
    }

    /// 🔄 获取重试次数
    fn retry_count(&self) -> u32 {
        self.config().retry_count()
    }

    /// 📝 检查是否启用了日志
    fn is_log_enabled(&self) -> bool {
        self.config().enable_log()
    }
}

#[cfg(test)]
#[allow(unused_imports)]
mod tests {
    use super::*;
    use openlark_core::config::Config;

    struct TestClient {
        config: Config,
    }

    impl LarkClient for TestClient {
        fn config(&self) -> &Config {
            &self.config
        }
    }

    #[test]
    fn test_lark_client_basic_methods() {
        let config = Config::builder()
            .app_id("test_app_id")
            .app_secret("test_app_secret")
            .base_url("https://test.feishu.cn")
            .req_timeout(std::time::Duration::from_secs(30))
            .retry_count(3)
            .enable_log(true)
            .build();

        let client = TestClient { config };

        assert_eq!(client.app_id(), "test_app_id");
        assert_eq!(client.app_secret(), "test_app_secret");
        assert_eq!(client.base_url(), "https://test.feishu.cn");
        assert_eq!(client.timeout(), Some(std::time::Duration::from_secs(30)));
        assert_eq!(client.retry_count(), 3);
        assert!(client.is_log_enabled());
        assert!(client.is_configured());
    }

    #[test]
    fn test_not_configured_client() {
        let config = Config::default();

        let client = TestClient { config };
        assert!(!client.is_configured());
    }
}