botkit-matrix 0.2.0

use std::time::Duration;

use botkit_core::BotError;
use botkit_core::action::{ChatAction, ChatActionFutureBounds, ChatActionSender};
use matrix_sdk::Room;

/// Matrix chat action sender
///
/// Sends typing notifications to Matrix rooms.
#[derive(Clone)]
pub struct MatrixActionSender {
    room: Room,
}

impl MatrixActionSender {
    /// Create a new Matrix action sender for the given room
    pub fn new(room: Room) -> Self {
        Self { room }
    }
}

impl ChatActionSender for MatrixActionSender {
    fn send_action(
        &self,
        action: ChatAction,
    ) -> impl ChatActionFutureBounds<Output = Result<(), BotError>> + '_ {
        async move {
            // Matrix only supports typing indicators
            if action == ChatAction::Typing {
                self.room
                    .typing_notice(true)
                    .await
                    .map_err(|e| BotError::Api(e.to_string()))?;
            }
            // Other actions are silently ignored - Matrix doesn't support them
            Ok(())
        }
    }

    fn action_expiry(&self) -> Duration {
        // matrix-sdk sends a 4 second typing timeout and internally coalesces
        // refreshes, so the core 80% renewal logic re-sends before expiry.
        Duration::from_secs(4)
    }

    fn clear_action(&self) -> impl ChatActionFutureBounds<Output = Result<(), BotError>> + '_ {
        // Unlike Discord and Telegram, a Matrix typing notice stays up until
        // it is retracted or its timeout lapses, so retract it eagerly.
        async move {
            self.room
                .typing_notice(false)
                .await
                .map_err(|e| BotError::Api(e.to_string()))
        }
    }
}