146 (#150)

* #146 feat: add raw initData accessor

* #146 docs: add raw initData retrieval example to README

* #146 refactor: split webapp.rs into logical modules

Split monolithic webapp.rs (3591 lines) into 10 focused modules following Single Responsibility Principle:

- types.rs (265 lines): All shared types, enums, and structs
- core.rs (153 lines): Instance management and validation
- lifecycle.rs (235 lines): App lifecycle and window control
- buttons.rs (701 lines): All button operations (main, secondary, bottom, back)
- dialogs.rs (102 lines): User dialogs and popups
- navigation.rs (232 lines): Links, sharing, and navigation
- permissions.rs (196 lines): Permission requests and file operations
- theme.rs (53 lines): Theme and color management
- viewport.rs (92 lines): Viewport and safe area operations
- events.rs (276 lines): Event handling system

Main webapp.rs reduced to 1401 lines (re-exports + tests).

Benefits:
- Each module has single clear responsibility
- Easier maintenance and navigation
- Better encapsulation with pub(super) visibility
- No module exceeds 701 lines
- All tests pass (207 tests)
- Zero clippy warnings

Author: RAprogramm

README.md

@@ -654,6 +654,30 @@ gyroscope, and device orientation sensors.
 
 ## Init data validation
 
+### Retrieving raw initData
+
+Retrieve the raw URL-encoded `initData` string for server-side authentication.
+The SDK captures this string during initialization and provides convenient
+access without requiring JavaScript reflection:
+
+```rust,no_run
+use telegram_webapp_sdk::TelegramWebApp;
+
+# fn run() -> Result<(), Box<dyn std::error::Error>> {
+// Get raw initData for backend validation
+let raw_init_data = TelegramWebApp::get_raw_init_data()?;
+
+// Send to your backend for signature verification
+// POST /auth with body: { "init_data": raw_init_data }
+# Ok(())
+# }
+```
+
+This eliminates the need for manual `Reflect` calls and ensures consistency
+with the parsed data available in the context.
+
+### Validating initData
+
 Validate the integrity of the `Telegram.WebApp.initData` payload on the server.
 The `validate_init_data` module is re-exported at the crate root and can be
 used directly or through the `TelegramWebApp::validate_init_data` helper:

src/core/context.rs

@@ -12,8 +12,9 @@ use super::types::{
 /// Global context of the Telegram Mini App, initialized once per app session.
 #[derive(Clone)]
 pub struct TelegramContext {
-    pub init_data:    TelegramInitData,
-    pub theme_params: TelegramThemeParams
+    pub init_data:     TelegramInitData,
+    pub theme_params:  TelegramThemeParams,
+    pub raw_init_data: String
 }
 
 thread_local! {
@@ -28,12 +29,14 @@ impl TelegramContext {
     /// Returns an error if the context was already initialized.
     pub fn init(
         init_data: TelegramInitData,
-        theme_params: TelegramThemeParams
+        theme_params: TelegramThemeParams,
+        raw_init_data: String
     ) -> Result<(), &'static str> {
         CONTEXT.with(|cell| {
             cell.set(TelegramContext {
                 init_data,
-                theme_params
+                theme_params,
+                raw_init_data
             })
             .map_err(|_| "TelegramContext already initialized")
         })
@@ -48,6 +51,34 @@ impl TelegramContext {
     {
         CONTEXT.with(|cell| cell.get().map(f))
     }
+
+    /// Returns the raw initData string as provided by Telegram.
+    ///
+    /// This is the URL-encoded initData string suitable for server-side
+    /// signature validation. The string is captured during SDK initialization
+    /// and remains unchanged.
+    ///
+    /// # Errors
+    ///
+    /// Returns an error if the SDK has not been initialized via
+    /// [`crate::core::init::init_sdk`].
+    ///
+    /// # Examples
+    ///
+    /// ```no_run
+    /// use telegram_webapp_sdk::core::context::TelegramContext;
+    ///
+    /// match TelegramContext::get_raw_init_data() {
+    ///     Ok(raw) => {
+    ///         // Send to backend for validation
+    ///         println!("Raw initData: {}", raw);
+    ///     }
+    ///     Err(e) => eprintln!("Error: {}", e)
+    /// }
+    /// ```
+    pub fn get_raw_init_data() -> Result<String, &'static str> {
+        Self::get(|ctx| ctx.raw_init_data.clone()).ok_or("TelegramContext not initialized")
+    }
 }
 
 /// Returns launch parameters parsed from the current window location.

src/core/init.rs

@@ -81,7 +81,7 @@ pub fn init_sdk() -> Result<(), JsValue> {
     // theme_params.clone().apply_to_root();
 
     // === 5. Init global context ===
-    TelegramContext::init(init_data, theme_params)?;
+    TelegramContext::init(init_data, theme_params, init_data_str)?;
 
     Ok(())
 }