telegram-webapp-sdk 0.4.0

Telegram WebApp SDK for Rust
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
79
80

// SPDX-FileCopyrightText: 2025 RAprogramm <andrey.rozanov.vl@gmail.com>
// SPDX-License-Identifier: MIT

use serde_json::to_string;
use urlencoding::encode;

use crate::mock::data::MockTelegramUser;

/// Generate a valid Telegram `initData` string from user info and params.
///
/// # Arguments
/// - `user`: Telegram user data (as `MockTelegramUser`)
/// - `auth_date`: UNIX timestamp (as string, e.g., `"1234567890"`)
/// - `hash`: mock hash string (can be `"fakehash"` or real value)
/// - `query_id`: optional inline query identifier to embed in the payload
///
/// # Returns
/// Properly URL-encoded initData string for Telegram WebApp emulation.
pub fn generate_mock_init_data(
    user: &MockTelegramUser,
    auth_date: &str,
    hash: &str,
    query_id: Option<&str>
) -> String {
    let user_json = to_string(user).unwrap_or_else(|_| "{}".into());
    let encoded_user = encode(&user_json);
    let mut init_data = String::with_capacity(64);

    if let Some(id) = query_id {
        init_data.push_str("query_id=");
        init_data.push_str(encode(id).as_ref());
        init_data.push('&');
    }

    init_data.push_str("user=");
    init_data.push_str(encoded_user.as_ref());
    init_data.push('&');
    init_data.push_str("auth_date=");
    init_data.push_str(auth_date);
    init_data.push('&');
    init_data.push_str("hash=");
    init_data.push_str(hash);

    init_data
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn builds_expected_init_data() {
        let user = MockTelegramUser {
            id: 1,
            first_name: "Dev".into(),
            ..Default::default()
        };
        let auth_date = "123456";
        let hash = "hash";
        let data = generate_mock_init_data(&user, auth_date, hash, None);

        assert!(data.contains("user="));
        assert!(data.contains("auth_date=123456"));
        assert!(data.contains("hash=hash"));
        assert!(!data.starts_with("query_id="));
    }

    #[test]
    fn adds_query_id_when_present() {
        let user = MockTelegramUser {
            id: 1,
            first_name: "Dev".into(),
            ..Default::default()
        };
        let data = generate_mock_init_data(&user, "123456", "hash", Some("inline:42/รค"));

        assert!(data.starts_with("query_id=inline%3A42%2F%C3%A4&"));
        assert!(data.contains("hash=hash"));
    }
}