ferogram 0.6.5

A native, elegant, and asynchronous MTProto framework in Rust for Telegram clients, bots, and applications.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

/*
 * 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 ferogram_tl_types as tl;

/// Convenience extension for [`tl::enums::Peer`]: extract the numeric ID
/// without writing a `match` every time.
///
/// # Example
/// ```rust,no_run
/// use ferogram::PeerExt;
/// use ferogram::OptionPeerExt;
/// use ferogram::tl;
/// # use ferogram::update::IncomingMessage;
/// # fn example(peer: tl::enums::Peer, msg: IncomingMessage) {
///
/// // Instead of:
/// // let id = match peer { Peer::User(u) => u.user_id, Peer::Chat(c) => c.chat_id, ... };
/// // Just write:
/// let id = peer.bare_id();
///
/// // Works great with sender_id() / peer_id() on IncomingMessage:
/// if let Some(id) = msg.sender_id().bare_id() {
///     println!("sender: {id}");
/// }
/// // Chat ID:
/// if let Some(id) = msg.peer_id().bare_id() {
///     println!("chat: {id}");
/// }
/// # }
/// ```
pub trait PeerExt {
    /// Returns the raw Telegram ID for any peer variant.
    ///
    /// - `Peer::User`    → `user_id`
    /// - `Peer::Chat`    → `chat_id`   (basic group)
    /// - `Peer::Channel` → `channel_id` (supergroup / broadcast channel)
    ///
    /// Note: these are **native** Telegram IDs, not Bot-API-encoded ones.
    /// A channel with native ID `1234567890` would be `-1001234567890` in the
    /// Bot API.  Use [`crate::peer_ref`] encoding if you need the Bot-API form.
    fn bare_id(&self) -> i64;
}

impl PeerExt for tl::enums::Peer {
    #[inline]
    fn bare_id(&self) -> i64 {
        match self {
            tl::enums::Peer::User(u) => u.user_id,
            tl::enums::Peer::Chat(c) => c.chat_id,
            tl::enums::Peer::Channel(c) => c.channel_id,
        }
    }
}

/// Same convenience for `Option<&tl::enums::Peer>`: lets you write
/// `msg.sender_id().bare_id()` instead of `.map(|p| p.bare_id())`.
pub trait OptionPeerExt {
    fn bare_id(&self) -> Option<i64>;
}

impl OptionPeerExt for Option<&tl::enums::Peer> {
    #[inline]
    fn bare_id(&self) -> Option<i64> {
        self.map(PeerExt::bare_id)
    }
}