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
81
82
83
84
85
86
87
88
/*
* 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;
use crate::Client;
use crate::errors::InvocationError;
/// Which kind of mini-app to open.
///
/// Passed to [`Client::open_mini_app`].
pub enum MiniApp {
/// The bot's main mini-app (no inline button required).
Main,
/// A URL-based WebView mini-app (full JS bridge, generates a `query_id`).
Url(String),
/// A registered bot app opened by its TL handle (deeplink style).
App {
/// The bot that owns the app.
bot: tl::enums::InputUser,
/// The app handle returned by `messages.GetBotApp`.
app: tl::enums::InputBotApp,
/// Optional start parameter forwarded to the app.
start_param: Option<String>,
},
/// A simple WebView with no JS bridge and no `query_id`.
Simple(String),
}
/// An active mini-app session returned by [`Client::open_mini_app`].
///
/// Call [`prolong`](MiniAppSession::prolong) periodically to keep the session
/// alive while the user interacts with the WebView.
pub struct MiniAppSession {
/// The URL the WebView should load.
pub url: String,
/// The `query_id` for answering `web_app_data` callbacks (`None` for Simple).
pub query_id: Option<i64>,
pub(crate) client: Client,
pub(crate) input_peer: tl::enums::InputPeer,
}
impl MiniAppSession {
#[allow(dead_code)]
pub(crate) fn from_result(
client: Client,
input_peer: tl::enums::InputPeer,
res: tl::enums::WebViewResult,
) -> Result<Self, InvocationError> {
match res {
tl::enums::WebViewResult::Url(r) => Ok(Self {
url: r.url,
query_id: r.query_id,
client,
input_peer,
}),
}
}
/// Extend the session lifetime.
///
/// Telegram requires this to be called every ~25 seconds while the user is
/// actively using the mini-app.
pub async fn prolong(&self) -> Result<(), InvocationError> {
self.client
.invoke(&tl::functions::messages::ProlongWebView {
silent: false,
peer: self.input_peer.clone(),
bot: tl::enums::InputUser::UserSelf,
query_id: self.query_id.unwrap_or(0),
reply_to: None,
send_as: None,
})
.await
.map(|_: bool| ())
}
}