vaegram 0.3.0

Telegram MTProto client library for users and bots
Documentation
use crate::Client;
use crate::enums::ParseMode;
use crate::errors::{Error, Result};
use crate::methods::messages::caption_setters;
use crate::raw::{base, types};
use crate::types::{PeerRef, Text};
use crate::utils::input_user;

/// Request built by [`Client::gift_premium_subscription`].
#[must_use = "a request does nothing until it is awaited"]
pub struct GiftPremiumSubscription<'a> {
    client: &'a Client,
    user_id: PeerRef,
    month_count: i32,
    text: Option<Text>,
    parse_mode: Option<ParseMode>,
}

impl Client {
    /// Gifts Premium for `month_count` months to a user, paid in Stars.
    ///
    /// Fails with `Error::InvalidArgument` if `user_id` is not a user.
    pub fn gift_premium_subscription(
        &self,
        user_id: impl Into<PeerRef>,
        month_count: i32,
    ) -> GiftPremiumSubscription<'_> {
        GiftPremiumSubscription { client: self, user_id: user_id.into(), month_count, text: None, parse_mode: None }
    }
}

impl GiftPremiumSubscription<'_> {
    /// Adds a message that the recipient sees with the gift.
    pub fn text(mut self, text: impl Into<Text>) -> Self {
        self.text = Some(text.into());
        self
    }

    async fn send(self) -> Result<()> {
        let client = self.client;
        let peer = client.resolve(&self.user_id).await?.1;
        let invoice = types::InputInvoicePremiumGiftStars {
            user_id: input_user(peer).ok_or(Error::InvalidArgument("Premium can only be gifted to a user"))?,
            months: self.month_count,
            message: client.parse_text_with_entities(self.text, self.parse_mode).await?,
        };
        client.pay_with_stars(None, base::InputInvoice::InputInvoicePremiumGiftStars(Box::new(invoice))).await
    }
}

caption_setters!(GiftPremiumSubscription);
into_future!(GiftPremiumSubscription, ());