feat: surface trial activation in mini app

tests/test_mini_app_url.py

@@ -5,6 +5,7 @@ from bot.utils.mini_app_url import (
     subscription_mini_app_install_url,
     subscription_mini_app_path_url,
     subscription_mini_app_topup_url,
+    subscription_mini_app_trial_url,
     subscription_public_install_url,
 )
 from config.settings import Settings
@@ -62,6 +63,10 @@ class MiniAppUrlTests(unittest.TestCase):
             subscription_mini_app_install_url(s),
             "https://app.example.com/webapp/install",
         )
+        self.assertEqual(
+            subscription_mini_app_trial_url(s),
+            "https://app.example.com/webapp/trial",
+        )
 
     def test_subscription_public_install_url_uses_origin(self):
         s = Settings(

tests/test_user_bot_menu.py

@@ -67,6 +67,46 @@ class UserBotMenuTests(unittest.TestCase):
         self.assertIn("main_action:bot_interface", callbacks)
         self.assertIn("main_action:info", callbacks)
 
+    def test_main_menu_shows_trial_button_as_mini_app_deeplink_when_available(self):
+        markup = get_main_menu_inline_keyboard(
+            "en",
+            self.i18n,
+            self.settings,
+            show_trial_button=True,
+        )
+
+        trial_button = markup.inline_keyboard[0][0]
+
+        self.assertEqual(trial_button.text, self.i18n.gettext("en", "menu_activate_trial_button"))
+        self.assertIsNone(trial_button.callback_data)
+        self.assertEqual(trial_button.web_app.url, "https://app.example.com/trial")
+
+    def test_main_menu_trial_button_falls_back_to_bot_callback_without_mini_app(self):
+        self.settings.SUBSCRIPTION_MINI_APP_URL = ""
+        markup = get_main_menu_inline_keyboard(
+            "en",
+            self.i18n,
+            self.settings,
+            show_trial_button=True,
+        )
+
+        trial_button = markup.inline_keyboard[0][0]
+
+        self.assertEqual(trial_button.callback_data, "main_action:request_trial")
+        self.assertIsNone(trial_button.web_app)
+
+    def test_bot_interface_trial_button_uses_mini_app_deeplink_when_available(self):
+        markup = get_bot_interface_inline_keyboard(
+            "en",
+            self.i18n,
+            self.settings,
+            show_trial_button=True,
+        )
+
+        trial_button = markup.inline_keyboard[0][0]
+
+        self.assertEqual(trial_button.web_app.url, "https://app.example.com/trial")
+
     def test_bot_interface_buttons_return_to_bot_interface(self):
         markup = get_bot_interface_inline_keyboard("en", self.i18n, self.settings)
 

tests/test_webapp_route_contract.py

@@ -75,6 +75,7 @@ class WebAppRouteContractTests(unittest.TestCase):
             ("GET", "/login/password"): "index_route",
             ("GET", "/home"): "index_route",
             ("GET", "/install"): "index_route",
+            ("GET", "/trial"): "index_route",
             ("GET", "/open-app"): "app_deeplink_route",
             ("GET", "/s/{share_token}"): "index_route",
             ("GET", "/invite"): "index_route",