ferogram 0.6.5

/*
 * Copyright (c) 2026 Ankit Chaubey <ankitchaubey.dev@gmail.com>
 * https://github.com/ankit-chaubey
 *
 * Project: ferogram
 * Website: https://ferogram.dev
 *
 * Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
 * https://www.apache.org/licenses/LICENSE-2.0> or the MIT license
 * <LICENSE-MIT or https://opensource.org/licenses/MIT>, at your option.
 * This file may not be copied, modified, or distributed except according
 * to those terms.
 */

use super::core::{BoxFilter, make};
use crate::update::IncomingMessage;

/// Passes every update of type `T` (wildcard / fallback handler).
///
/// Generic so it works with `on_message`/`on_edit` (`T` = [`IncomingMessage`],
/// the default), `on_callback_query` (`T` = [`crate::update::CallbackQuery`]),
/// and `on_inline_query`/`on_inline_send`.
pub fn all<T: 'static>() -> BoxFilter<T> {
    make(|_| true)
}

/// Never passes (disabled handler placeholder). Generic, same as [`all`].
pub fn none<T: 'static>() -> BoxFilter<T> {
    make(|_| false)
}

/// Private (1-on-1) chats only.
pub fn private() -> BoxFilter {
    make(|m: &IncomingMessage| m.is_private())
}

/// Basic group chats only.
pub fn group() -> BoxFilter {
    make(|m: &IncomingMessage| m.is_group())
}

/// Channels and supergroups only.
pub fn channel() -> BoxFilter {
    make(|m: &IncomingMessage| m.is_channel())
}

/// Any non-empty text message.
pub fn text() -> BoxFilter {
    make(|m: &IncomingMessage| m.text().is_some())
}

/// Messages with any media attachment.
pub fn media() -> BoxFilter {
    make(|m: &IncomingMessage| m.has_media())
}

/// Messages with a photo.
pub fn photo() -> BoxFilter {
    make(|m: &IncomingMessage| m.has_photo())
}

/// Messages with a document (file, video, audio, sticker ...).
pub fn document() -> BoxFilter {
    make(|m: &IncomingMessage| m.has_document())
}

/// Forwarded messages.
pub fn forwarded() -> BoxFilter {
    make(|m: &IncomingMessage| m.is_forwarded())
}

/// Reply messages.
pub fn reply() -> BoxFilter {
    make(|m: &IncomingMessage| m.is_reply())
}

/// Album / grouped-media messages.
pub fn album() -> BoxFilter {
    make(|m: &IncomingMessage| m.album_id().is_some())
}

/// Any bot command (`/something`).
pub fn any_command() -> BoxFilter {
    make(|m: &IncomingMessage| m.is_bot_command())
}

/// A specific bot command (case-insensitive, strips `@BotName` suffix).
///
/// # Example
/// ```rust,no_run
/// use ferogram::filters::command;
/// let start = command("start");
/// let help  = command("help");
/// ```
pub fn command(name: impl Into<String>) -> BoxFilter {
    let name = name.into();
    make(move |m: &IncomingMessage| m.is_command_named(&name))
}

/// Text contains a substring (case-sensitive).
pub fn text_contains(needle: impl Into<String>) -> BoxFilter {
    let needle = needle.into();
    make(move |m: &IncomingMessage| m.text().is_some_and(|t| t.contains(needle.as_str())))
}

/// Text starts with a prefix (case-sensitive).
pub fn text_starts_with(prefix: impl Into<String>) -> BoxFilter {
    let prefix = prefix.into();
    make(move |m: &IncomingMessage| m.text().is_some_and(|t| t.starts_with(prefix.as_str())))
}

/// Message is from a specific user ID.
pub fn from_user(id: i64) -> BoxFilter {
    make(move |m: &IncomingMessage| m.sender_user_id() == Some(id))
}

/// Message is in a specific chat.
pub fn in_chat(id: i64) -> BoxFilter {
    make(move |m: &IncomingMessage| m.chat_id() == id)
}

/// Filter from an arbitrary closure.
///
/// # Example
/// ```rust,no_run
/// use ferogram::filters::custom;
/// let long_text = custom(|msg| msg.text().map_or(false, |t| t.len() > 200));
/// ```
pub fn custom<F>(f: F) -> BoxFilter
where
    F: Fn(&IncomingMessage) -> bool + Send + Sync + 'static,
{
    make(f)
}