@types/telegram-web-app 7.10.1 → 9.0.0

telegram-web-app/README.md

@@ -8,7 +8,7 @@ This package contains type definitions for telegram-web-app (https://telegram.or
 Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/telegram-web-app.
 
 ### Additional Details
- * Last updated: Fri, 04 Oct 2024 17:07:25 GMT
+ * Last updated: Tue, 29 Jul 2025 15:04:17 GMT
  * Dependencies: none
 
 # Credits

telegram-web-app/index.d.ts

@@ -1,12 +1,16 @@
-declare var Telegram: Telegram;
+declare global {
+    interface Window {
+        Telegram: Telegram;
+    }
+}
 
-type Color = string | false;
+export type Color = string | false;
 
-interface Telegram {
+export interface Telegram {
     WebApp: WebApp;
 }
 
-interface WebApp {
+export interface WebApp {
     /**
      * A string with raw data transferred to the Web App, convenient for
      * validating data. WARNING: Validate data from this field before using it
@@ -36,6 +40,13 @@ interface WebApp {
      * An object containing the current theme settings used in the Telegram app.
      */
     themeParams: ThemeParams;
+    /**
+     *  **Bot API 8.0+**
+     *
+     *  True, if the Mini App is currently active.
+     *  False, if the Mini App is minimized.
+     */
+    isActive: boolean;
     /**
      *  True if the Web App is expanded to the maximum available height.
      *  False, if the Web App occupies part of the screen and can be expanded to the
@@ -95,6 +106,25 @@ interface WebApp {
      * close the Web App. False, if the confirmation dialog is disabled.
      */
     isClosingConfirmationEnabled: boolean;
+    /**
+     * True, if the Mini App is currently being displayed in fullscreen mode.
+     */
+    isFullscreen: boolean;
+    /**
+     * True, if the Mini App’s orientation is currently locked.
+     * False, if orientation changes freely based on the device’s rotation.
+     */
+    isOrientationLocked: boolean;
+    /**
+     * An object representing the device's safe area insets,
+     * accounting for system UI elements like notches or navigation bars.
+     */
+    safeAreaInset: SafeAreaInset;
+    /**
+     * An object representing the safe area for displaying content within the app,
+     * free from overlapping Telegram UI elements.
+     */
+    contentSafeAreaInset: ContentSafeAreaInset;
     /**
      * An object for controlling the back button which can be displayed in the
      * header of the Web App in the Telegram interface.
@@ -127,20 +157,43 @@ interface WebApp {
      * An object for controlling biometrics on the device.
      */
     BiometricManager: BiometricManager;
+    /**
+     * An object for accessing device orientation data on the device.
+     */
+    Accelerometer: Accelerometer;
+    /**
+     * An object for accessing device orientation data on the device.
+     */
+    DeviceOrientation: DeviceOrientation;
+    /**
+     * An object for accessing gyroscope data on the device.
+     */
+    Gyroscope: Gyroscope;
+    /**
+     * An object for controlling location on the device.
+     */
+    LocationManager: LocationManager;
+    /**
+     * An object for storing and retrieving data from the device's local storage.
+     */
+    DeviceStorage: DeviceStorage;
+    /**
+     * An object for storing and retrieving data from the device's secure storage.
+     */
+    SecureStorage: SecureStorage;
     /**
      * Returns true if the user's app supports a version of the Bot API that is
      * equal to or higher than the version passed as the parameter.
      */
     isVersionAtLeast(version: string): boolean;
     /**
-     * A method that sets the app header color in the `#RRGGBB` format. You can
-     * also use keywords bg_color and secondary_bg_color.
+     * A method that sets the app header color in the `#RRGGBB` format.
+     * You can also use keywords bg_color and secondary_bg_color.
      */
-    // string & {} prevents this from eagerly collapsing into just string
     setHeaderColor(color: "bg_color" | "secondary_bg_color" | (string & {})): void;
     /**
-     * A method that sets the app background color in the `#RRGGBB` format or
-     * you can use keywords bg_color, secondary_bg_color instead.
+     * A method that sets the app background color in the `#RRGGBB` format
+     * or you can use keywords bg_color, secondary_bg_color instead.
      */
     setBackgroundColor(color: "bg_color" | "secondary_bg_color" | "bottom_bar_bg_color" | (string & {})): void;
     /**
@@ -162,14 +215,18 @@ interface WebApp {
      * A method that sets the app event handler. Check the list of available
      * events.
      */
+    onEvent(eventType: "activated", eventHandler: ActivatedCallback): void;
+    onEvent(eventType: "deactivated", eventHandler: DeactivatedCallback): void;
     onEvent(eventType: "themeChanged", eventHandler: ThemeChangedCallback): void;
+    onEvent(eventType: "viewportChanged", eventHandler: ViewportChangedCallback): void;
+    onEvent(eventType: "safeAreaChanged", eventHandler: SafeAreaChangedChangedCallback): void;
+    onEvent(eventType: "contentSafeAreaChanged", eventHandler: ContentSafeAreaChangedCallback): void;
     onEvent(eventType: "mainButtonClicked", eventHandler: MainButtonClickedCallback): void;
     onEvent(eventType: "secondaryButtonClicked", eventHandler: SecondaryButtonClickedCallback): void;
     onEvent(eventType: "backButtonClicked", eventHandler: BackButtonClickedCallback): void;
     onEvent(eventType: "settingsButtonClicked", eventHandler: SettingsButtonClickedCallback): void;
-    onEvent(eventType: "popupClosed", eventHandler: PopupClosedCallback): void;
-    onEvent(eventType: "viewportChanged", eventHandler: ViewportChangedCallback): void;
     onEvent(eventType: "invoiceClosed", eventHandler: InvoiceClosedCallback): void;
+    onEvent(eventType: "popupClosed", eventHandler: PopupClosedCallback): void;
     onEvent(eventType: "qrTextReceived", eventHandler: QrTextReceivedCallback): void;
     onEvent(eventType: "scanQrPopupClosed", eventHandler: ScanQrPopupClosedCallback): void;
     onEvent(eventType: "clipboardTextReceived", eventHandler: ClipboardTextReceivedCallback): void;
@@ -178,15 +235,44 @@ interface WebApp {
     onEvent(eventType: "biometricManagerUpdated", eventHandler: BiometricManagerUpdatedCallback): void;
     onEvent(eventType: "biometricAuthRequested", eventHandler: BiometricAuthRequestedCallback): void;
     onEvent(eventType: "biometricTokenUpdated", eventHandler: BiometricTokenUpdatedCallback): void;
+    onEvent(eventType: "fullscreenChanged", eventHandler: FullscreenChangedCallback): void;
+    onEvent(eventType: "fullscreenFailed", eventHandler: FullscreenFailedCallback): void;
+    onEvent(eventType: "homeScreenAdded", eventHandler: HomeScreenAddedCallback): void;
+    onEvent(eventType: "homeScreenChecked", eventHandler: HomeScreenCheckedCallback): void;
+    onEvent(eventType: "accelerometerStarted", eventHandler: AccelerometerStartedCallback): void;
+    onEvent(eventType: "accelerometerStopped", eventHandler: AccelerometerStoppedCallback): void;
+    onEvent(eventType: "accelerometerChanged", eventHandler: AccelerometerChangedCallback): void;
+    onEvent(eventType: "accelerometerFailed", eventHandler: AccelerometerFailedCallback): void;
+    onEvent(eventType: "deviceOrientationStarted", eventHandler: DeviceOrientationStartedCallback): void;
+    onEvent(eventType: "deviceOrientationStopped", eventHandler: DeviceOrientationStoppedCallback): void;
+    onEvent(eventType: "deviceOrientationChanged", eventHandler: DeviceOrientationChangedCallback): void;
+    onEvent(eventType: "deviceOrientationFailed", eventHandler: DeviceOrientationFailedCallback): void;
+    onEvent(eventType: "gyroscopeStarted", eventHandler: GyroscopeStartedCallback): void;
+    onEvent(eventType: "gyroscopeStopped", eventHandler: GyroscopeStoppedCallback): void;
+    onEvent(eventType: "gyroscopeChanged", eventHandler: GyroscopeChangedCallback): void;
+    onEvent(eventType: "gyroscopeFailed", eventHandler: GyroscopeFailedCallback): void;
+    onEvent(eventType: "locationManagerUpdated", eventHandler: LocationManagerUpdatedCallback): void;
+    onEvent(eventType: "locationRequested", eventHandler: LocationRequestedCallback): void;
+    onEvent(eventType: "shareMessageSent", eventHandler: ShareMessageSentCallback): void;
+    onEvent(eventType: "shareMessageFailed", eventHandler: ShareMessageFailedCallback): void;
+    onEvent(eventType: "emojiStatusSet", eventHandler: EmojiStatusSetCallback): void;
+    onEvent(eventType: "emojiStatusFailed", eventHandler: EmojiStatusFailedCallback): void;
+    onEvent(eventType: "emojiStatusAccessRequested", eventHandler: EmojiStatusAccessRequestedCallback): void;
+    onEvent(eventType: "fileDownloadRequested", eventHandler: FileDownloadRequestedCallback): void;
 
     /** A method that deletes a previously set event handler. */
+    offEvent(eventType: "activated", eventHandler: ActivatedCallback): void;
+    offEvent(eventType: "deactivated", eventHandler: DeactivatedCallback): void;
     offEvent(eventType: "themeChanged", eventHandler: ThemeChangedCallback): void;
+    offEvent(eventType: "viewportChanged", eventHandler: ViewportChangedCallback): void;
+    offEvent(eventType: "safeAreaChanged", eventHandler: SafeAreaChangedChangedCallback): void;
+    offEvent(eventType: "contentSafeAreaChanged", eventHandler: ContentSafeAreaChangedCallback): void;
     offEvent(eventType: "mainButtonClicked", eventHandler: MainButtonClickedCallback): void;
+    offEvent(eventType: "secondaryButtonClicked", eventHandler: SecondaryButtonClickedCallback): void;
     offEvent(eventType: "backButtonClicked", eventHandler: BackButtonClickedCallback): void;
     offEvent(eventType: "settingsButtonClicked", eventHandler: SettingsButtonClickedCallback): void;
-    offEvent(eventType: "popupClosed", eventHandler: PopupClosedCallback): void;
-    offEvent(eventType: "viewportChanged", eventHandler: ViewportChangedCallback): void;
     offEvent(eventType: "invoiceClosed", eventHandler: InvoiceClosedCallback): void;
+    offEvent(eventType: "popupClosed", eventHandler: PopupClosedCallback): void;
     offEvent(eventType: "qrTextReceived", eventHandler: QrTextReceivedCallback): void;
     offEvent(eventType: "scanQrPopupClosed", eventHandler: ScanQrPopupClosedCallback): void;
     offEvent(eventType: "clipboardTextReceived", eventHandler: ClipboardTextReceivedCallback): void;
@@ -195,6 +281,30 @@ interface WebApp {
     offEvent(eventType: "biometricManagerUpdated", eventHandler: BiometricManagerUpdatedCallback): void;
     offEvent(eventType: "biometricAuthRequested", eventHandler: BiometricAuthRequestedCallback): void;
     offEvent(eventType: "biometricTokenUpdated", eventHandler: BiometricTokenUpdatedCallback): void;
+    offEvent(eventType: "fullscreenChanged", eventHandler: FullscreenChangedCallback): void;
+    offEvent(eventType: "fullscreenFailed", eventHandler: FullscreenFailedCallback): void;
+    offEvent(eventType: "homeScreenAdded", eventHandler: HomeScreenAddedCallback): void;
+    offEvent(eventType: "homeScreenChecked", eventHandler: HomeScreenCheckedCallback): void;
+    offEvent(eventType: "accelerometerStarted", eventHandler: AccelerometerStartedCallback): void;
+    offEvent(eventType: "accelerometerStopped", eventHandler: AccelerometerStoppedCallback): void;
+    offEvent(eventType: "accelerometerChanged", eventHandler: AccelerometerChangedCallback): void;
+    offEvent(eventType: "accelerometerFailed", eventHandler: AccelerometerFailedCallback): void;
+    offEvent(eventType: "deviceOrientationStarted", eventHandler: DeviceOrientationStartedCallback): void;
+    offEvent(eventType: "deviceOrientationStopped", eventHandler: DeviceOrientationStoppedCallback): void;
+    offEvent(eventType: "deviceOrientationChanged", eventHandler: DeviceOrientationChangedCallback): void;
+    offEvent(eventType: "deviceOrientationFailed", eventHandler: DeviceOrientationFailedCallback): void;
+    offEvent(eventType: "gyroscopeStarted", eventHandler: GyroscopeStartedCallback): void;
+    offEvent(eventType: "gyroscopeStopped", eventHandler: GyroscopeStoppedCallback): void;
+    offEvent(eventType: "gyroscopeChanged", eventHandler: GyroscopeChangedCallback): void;
+    offEvent(eventType: "gyroscopeFailed", eventHandler: GyroscopeFailedCallback): void;
+    offEvent(eventType: "locationManagerUpdated", eventHandler: LocationManagerUpdatedCallback): void;
+    offEvent(eventType: "locationRequested", eventHandler: LocationRequestedCallback): void;
+    offEvent(eventType: "shareMessageSent", eventHandler: ShareMessageSentCallback): void;
+    offEvent(eventType: "shareMessageFailed", eventHandler: ShareMessageFailedCallback): void;
+    offEvent(eventType: "emojiStatusSet", eventHandler: EmojiStatusSetCallback): void;
+    offEvent(eventType: "emojiStatusFailed", eventHandler: EmojiStatusFailedCallback): void;
+    offEvent(eventType: "emojiStatusAccessRequested", eventHandler: EmojiStatusAccessRequestedCallback): void;
+    offEvent(eventType: "fileDownloadRequested", eventHandler: FileDownloadRequestedCallback): void;
 
     /**
      * A method used to send data to the bot. When this method is called, a
@@ -239,10 +349,7 @@ interface WebApp {
      *  optional callback parameter was passed, the callback function will be
      *  called and the invoice status will be passed as the first argument.
      */
-    openInvoice(
-        url: string,
-        callback: (status: "paid" | "cancelled" | "failed" | "pending") => void,
-    ): void;
+    openInvoice(url: string, callback: (status: "paid" | "cancelled" | "failed" | "pending") => void): void;
     /**
      * A method that shows a native popup described by the params argument of
      * the type PopupParams. The Web App will receive the event popupClosed when
@@ -288,10 +395,52 @@ interface WebApp {
      * the type StoryShareParams describes additional sharing settings. */
     shareToStory(media_url: string, params?: StoryShareParams): void;
     /**
-     * A method that requests text from the clipboard. The Web App will receive
-     * the event clipboardTextReceived. If an optional callback parameter was
-     * passed, the callback function will be called and the text from the
-     * clipboard will be passed as the first argument.
+     *  **Bot API 8.0+**
+     *
+     *  A method that opens a dialog allowing the user to share a message provided by the bot.
+     *  If an optional callback parameter is provided,
+     *  the callback function will be called with a boolean as the first argument,
+     *  indicating whether the message was successfully sent.
+     */
+    shareMessage(msg_id: number, callback?: (success: boolean) => void): void;
+    /**
+     *  **Bot API 8.0+**
+     *
+     *  A method that opens a dialog allowing the user to set the specified custom emoji as their status.
+     *  An optional params argument of type EmojiStatusParams specifies additional settings,such as duration.
+     *  If an optional callback parameter is provided,
+     *  the callback function will be called with a boolean as the first argument,
+     *  indicating whether the status was set.
+     *
+     *  Note: this method opens a native dialog and cannot be used to set the emoji status without manual user interaction.
+     *  For fully programmatic changes, you should instead use the Bot API method setUserEmojiStatus
+     *  after obtaining authorization to do so via the Mini App method requestEmojiStatusAccess.
+     */
+    setEmojiStatus(custom_emoji_id: string, params?: EmojiStatusParams, callback?: (success: boolean) => void): void;
+    /**
+     *  **Bot API 8.0+**
+     *
+     *  A method that shows a native popup requesting permission for the bot to manage user's emoji status.
+     *  If an optional callback parameter was passed,
+     *  the callback function will be called when the popup is closed
+     *  and the first argument will be a boolean indicating whether the user granted this access.
+     */
+    requestEmojiStatusAccess(callback?: (success: boolean) => void): void;
+    /**
+     *  **Bot API 8.0+**
+     *
+     *  A method that displays a native popup prompting the user to download a file
+     *  specified by the params argument of type DownloadFileParams.
+     *  If an optional callback parameter is provided,
+     *  the callback function will be called when the popup is closed,
+     *  with the first argument as a boolean indicating whether the user accepted the download request.
+     */
+    downloadFile(params: DownloadFileParams, callback?: (success: boolean) => void): void;
+    /**
+     * A method that requests text from the clipboard.
+     * The Web App will receive the event clipboardTextReceived.
+     * If an optional callback parameter was passed,
+     * the callback function will be called and the text from the clipboard will be passed as the first argument.
      *
      * Note: this method can be called only for Web Apps launched from the
      * attachment menu and only in response to a user interaction with the Web
@@ -318,9 +467,7 @@ interface WebApp {
      * number. The second argument, contingent upon success, will be an object
      * detailing the shared contact information or a cancellation response.
      */
-    requestContact(
-        callback?: (success: boolean, response: RequestContactResponse) => void,
-    ): void;
+    requestContact(callback?: (success: boolean, response: RequestContactResponse) => void): void;
     /**
      * A method that informs the Telegram app that the Web App is ready to be
      * displayed. It is recommended to call this method as early as possible, as
@@ -346,43 +493,146 @@ interface WebApp {
      */
     isVerticalSwipesEnabled: boolean;
     /**
-     * **Bot API 7.7+** A method that enables vertical swipes to close or
-     * minimize the Mini App. For user convenience, it is recommended to always
-     * enable swipes unless they conflict with the Mini App's own gestures.
+     * **Bot API 7.7+**
+     * A method that enables vertical swipes to close or minimize the Mini App.
+     * For user convenience, it is recommended to always enable swipes unless they conflict
+     * with the Mini App's own gestures.
      */
     enableVerticalSwipes(): void;
     /**
-     * **Bot API 7.7+** A method that disables vertical swipes to close or
-     * minimize the Mini App. This method is useful if your Mini App uses swipe
-     * gestures that may conflict with the gestures for minimizing and closing
-     * the app.
+     * **Bot API 7.7+**
+     * A method that disables vertical swipes to close or minimize the Mini App.
+     * This method is useful if your Mini App uses swipe gestures that may conflict
+     * with the gestures for minimizing and closing the app.
      */
     disableVerticalSwipes(): void;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that requests opening the Mini App in fullscreen mode.
+     * Although the header is transparent in fullscreen mode,
+     * it is recommended that the Mini App sets the header color using the setHeaderColor method.
+     * This color helps determine a contrasting color for the status bar and other UI controls.
+     */
+    requestFullscreen(): void;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that requests exiting fullscreen mode.
+     */
+    exitFullscreen(): void;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that locks the Mini App’s orientation to its current mode (either portrait or landscape).
+     * Once locked, the orientation remains fixed, regardless of device rotation.
+     * This is useful if a stable orientation is needed during specific interactions.
+     */
+    lockOrientation(): void;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that unlocks the Mini App’s orientation, allowing it to follow the device's rotation freely.
+     * Use this to restore automatic orientation adjustments based on the device orientation.
+     */
+    unlockOrientation(): void;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that prompts the user to add the Mini App to the home screen.
+     * After successfully adding the icon, the homeScreenAdded event will be triggered if supported by the device.
+     * Note that if the device cannot determine the installation status,
+     * the event may not be received even if the icon has been added.
+     */
+    addToHomeScreen(): void;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that checks if adding to the home screen is supported and if the Mini App has already been added.
+     * If an optional callback parameter is provided,
+     * the callback function will be called with a single argument status,
+     * which is a string indicating the home screen status.
+     */
+    checkHomeScreenStatus(callback?: (status: "unsupported" | "unknown" | "added" | "missed") => void): void;
 }
 
-type ThemeChangedCallback = () => void;
-type ViewportChangedCallback = (eventData: { isStateStable: boolean }) => void;
-type MainButtonClickedCallback = () => void;
-type SecondaryButtonClickedCallback = () => void;
-type BackButtonClickedCallback = () => void;
-type SettingsButtonClickedCallback = () => void;
-type InvoiceClosedCallback = (eventData: { url: string; status: "paid" | "cancelled" | "failed" | "pending" }) => void;
-type PopupClosedCallback = (eventData: { button_id: string | null }) => void;
-type QrTextReceivedCallback = (eventData: { data: string }) => void;
-type ScanQrPopupClosedCallback = () => void;
-type ClipboardTextReceivedCallback = (eventData: { data: string | null }) => void;
-type WriteAccessRequestedCallback = (eventData: { status: "allowed" | "cancelled" }) => void;
-type ContactRequestedCallback = (eventData: RequestContactResponse) => void;
-type BiometricManagerUpdatedCallback = () => void;
-type BiometricAuthRequestedCallback = (eventData: { isAuthenticated: boolean; biometricToken?: string }) => void;
-type BiometricTokenUpdatedCallback = (eventData: { isUpdated: boolean }) => void;
+export type ActivatedCallback = () => void;
+export type DeactivatedCallback = () => void;
+export type ThemeChangedCallback = () => void;
+export type ViewportChangedCallback = (eventData: { isStateStable: boolean }) => void;
+export type SafeAreaChangedChangedCallback = () => void;
+export type ContentSafeAreaChangedCallback = () => void;
+export type MainButtonClickedCallback = () => void;
+export type SecondaryButtonClickedCallback = () => void;
+export type BackButtonClickedCallback = () => void;
+export type SettingsButtonClickedCallback = () => void;
+export type InvoiceClosedCallback = (eventData: {
+    url: string;
+    status: "paid" | "cancelled" | "failed" | "pending";
+}) => void;
+export type PopupClosedCallback = (eventData: { button_id: string | null }) => void;
+export type QrTextReceivedCallback = (eventData: { data: string }) => void;
+export type ScanQrPopupClosedCallback = () => void;
+export type ClipboardTextReceivedCallback = (eventData: { data: string | null }) => void;
+export type WriteAccessRequestedCallback = (eventData: {
+    status: "allowed" | "cancelled";
+}) => void;
+export type ContactRequestedCallback = (eventData: RequestContactResponse) => void;
+export type BiometricManagerUpdatedCallback = () => void;
+export type BiometricAuthRequestedCallback = (eventData: {
+    isAuthenticated: boolean;
+    biometricToken?: string;
+}) => void;
+export type BiometricTokenUpdatedCallback = (eventData: { isUpdated: boolean }) => void;
+export type FullscreenChangedCallback = () => void;
+export type FullscreenFailedCallback = (eventData: {
+    error: "UNSUPPORTED" | "ALREADY_FULLSCREEN";
+}) => void;
+export type HomeScreenAddedCallback = () => void;
+export type HomeScreenCheckedCallback = (eventData: {
+    status: "unsupported" | "unknown" | "added" | "missed";
+}) => void;
+export type AccelerometerStartedCallback = () => void;
+export type AccelerometerStoppedCallback = () => void;
+export type AccelerometerChangedCallback = () => void;
+export type AccelerometerFailedCallback = (eventData: { error: "UNSUPPORTED" }) => void;
+export type DeviceOrientationStartedCallback = () => void;
+export type DeviceOrientationStoppedCallback = () => void;
+export type DeviceOrientationChangedCallback = () => void;
+export type DeviceOrientationFailedCallback = (eventData: { error: "UNSUPPORTED" }) => void;
+export type GyroscopeStartedCallback = () => void;
+export type GyroscopeStoppedCallback = () => void;
+export type GyroscopeChangedCallback = () => void;
+export type GyroscopeFailedCallback = (eventData: { error: "UNSUPPORTED" }) => void;
+export type LocationManagerUpdatedCallback = () => void;
+export type LocationRequestedCallback = (eventData: { locationData: LocationData }) => void;
+export type ShareMessageSentCallback = () => void;
+export type ShareMessageFailedCallback = (eventData: {
+    error: "UNSUPPORTED" | "MESSAGE_EXPIRED" | "MESSAGE_SEND_FAILED" | "USER_DECLINED" | "UNKNOWN_ERROR";
+}) => void;
+export type EmojiStatusSetCallback = () => void;
+export type EmojiStatusFailedCallback = (eventData: {
+    error:
+        | "UNSUPPORTED"
+        | "SUGGESTED_EMOJI_INVALID"
+        | "DURATION_INVALID"
+        | "USER_DECLINED"
+        | "SERVER_ERROR"
+        | "UNKNOWN_ERROR";
+}) => void;
+export type EmojiStatusAccessRequestedCallback = (eventData: {
+    status: "allowed" | "cancelled";
+}) => void;
+export type FileDownloadRequestedCallback = (eventData: {
+    status: "downloading" | "cancelled";
+}) => void;
 
 /**
  * Web Apps can adjust the appearance of the interface to match the Telegram
  * user's app in real time. This object contains the user's current theme
  * settings:
  */
-interface ThemeParams {
+export interface ThemeParams {
     /**
      * Background color in the `#RRGGBB` format.
      * Also available as the CSS variable `var(--tg-theme-bg-color)`.
@@ -414,48 +664,66 @@ interface ThemeParams {
      */
     button_text_color?: string;
     /**
-     * **Bot API 6.1+** Secondary background color in the `#RRGGBB` format.
+     * **Bot API 6.1+**
+     *
+     * Secondary background color in the `#RRGGBB` format.
      * Also available as the CSS variable `var(--tg-theme-secondary-bg-color)`.
      */
     secondary_bg_color?: string;
     /**
-     * **Bot API 7.0+** Header background color in the `#RRGGBB` format.
+     * **Bot API 7.0+**
+     *
+     * Header background color in the `#RRGGBB` format.
      * Also available as the CSS variable `var(--tg-theme-header-bg-color)`.
      */
     header_bg_color?: string;
     /**
-     * **Bot API 7.10+** Bottom background color in the #RRGGBB format.
+     * **Bot API 7.10+**
+     *
+     * Bottom background color in the #RRGGBB format.
      * Also available as the CSS variable var(--tg-theme-bottom-bar-bg-color).
      */
     bottom_bar_bg_color?: string;
     /**
-     * **Bot API 7.0+** Accent text color in the `#RRGGBB` format.
+     * **Bot API 7.0+**
+     *
+     * Accent text color in the `#RRGGBB` format.
      * Also available as the CSS variable `var(--tg-theme-accent-text-color)`.
      */
     accent_text_color?: string;
     /**
-     * **Bot API 7.0+** Background color for the section in the `#RRGGBB` format.
+     * **Bot API 7.0+**
+     *
+     * Background color for the section in the `#RRGGBB` format.
      * It is recommended to use this in conjunction with *secondary_bg_color*.
      * Also available as the CSS variable `var(--tg-theme-section-bg-color)`.
      */
     section_bg_color?: string;
     /**
-     * **Bot API 7.0+** Header text color for the section in the `#RRGGBB` format.
+     * **Bot API 7.0+**
+     *
+     * Header text color for the section in the `#RRGGBB` format.
      * Also available as the CSS variable `var(--tg-theme-section-header-text-color)`.
      */
     section_header_text_color?: `#${string}`;
     /**
-     * **Bot API 7.6+** Section separator color in the `#RRGGBB` format.
+     * **Bot API 7.6+**
+     *
+     * Section separator color in the `#RRGGBB` format.
      * Also available as the CSS variable `var(--tg-theme-section-separator-color)`.
      */
     section_separator_color?: string;
     /**
-     * **Bot API 7.0+** Subtitle text color in the `#RRGGBB` format.
+     * **Bot API 7.0+**
+     *
+     * Subtitle text color in the `#RRGGBB` format.
      *  Also available as the CSS variable `var(--tg-theme-subtitle-text-color)`.
      */
     subtitle_text_color?: string;
     /**
-     * **Bot API 7.0+** Text color for destructive actions in the `#RRGGBB` format.
+     * **Bot API 7.0+**
+     *
+     * Text color for destructive actions in the `#RRGGBB` format.
      * Also available as the CSS variable `var(--tg-theme-destructive-text-color)`.
      */
     destructive_text_color?: string;
@@ -464,7 +732,7 @@ interface ThemeParams {
 /**
  * This object describes the native popup.
  */
-interface PopupParams {
+export interface PopupParams {
     /**
      * The text to be displayed in the popup title, 0-64 characters.
      */
@@ -483,12 +751,11 @@ interface PopupParams {
 /**
  * This object describes the native popup button.
  */
-type PopupButton =
+export type PopupButton =
     & {
         /**
-         * Identifier of the button, 0-64 characters. Set to empty string by
-         * default. If the button is pressed, its id is returned in the callback
-         * and the popupClosed event.
+         * Identifier of the button, 0-64 characters. Set to empty string by default.
+         * If the button is pressed, its id is returned in the callback and the popupClosed event.
          */
         id?: string;
         /**
@@ -498,8 +765,7 @@ type PopupButton =
          * - `ok`, a button with the localized text “OK”,
          * - `close`, a button with the localized text “Close”,
          * - `cancel`, a button with the localized text “Cancel”,
-         * - `destructive`, a button with a style that indicates a destructive
-         *   action (e.g. “Remove”, “Delete”, etc.).
+         * - `destructive`, a button with a style that indicates a destructive action (e.g. “Remove”, “Delete”, etc.).
          */
         type?: "default" | "ok" | "close" | "cancel" | "destructive";
         /**
@@ -523,7 +789,7 @@ type PopupButton =
  * This object controls the back button, which can be displayed in the header of
  * the Web App in the Telegram interface.
  */
-interface BackButton {
+export interface BackButton {
     /**
      * Shows whether the button is visible. Set to false by default.
      */
@@ -552,7 +818,7 @@ interface BackButton {
  * This object controls the main button, which is displayed at the bottom of the
  * Web App in the Telegram interface.
  */
-interface BottomButton {
+export interface BottomButton {
     /** Current button text. Set to CONTINUE by default. */
     text: string;
     /** Current button color. Set to themeParams.button_color by default. */
@@ -622,7 +888,7 @@ interface BottomButton {
     setParams(params: MainButtonParams): BottomButton;
 }
 
-interface MainButtonParams {
+export interface MainButtonParams {
     /** button text */
     text?: string;
     /** button color */
@@ -643,30 +909,35 @@ interface MainButtonParams {
  * This object controls the Settings item in the context menu of the Mini App in
  * the Telegram interface.
  */
-interface SettingsButton {
+export interface SettingsButton {
     /**
      * Shows whether the context menu item is visible. Set to false by default.
      */
     isVisible: boolean;
     /**
-     * **Bot API 7.0+** A method that sets the press event handler for the
-     * Settings item in the context menu. An alias for
-     * `Telegram.WebApp.onEvent('settingsButtonClicked', callback)`
+     * **Bot API 7.0+**
+     *
+     * A method that sets the press event handler for the Settings item in the context menu.
+     * An alias for `Telegram.WebApp.onEvent('settingsButtonClicked', callback)`
      */
     onClick(callback: () => void): SettingsButton;
     /**
-     * **Bot API 7.0+** A method that removes the press event handler from the
-     * Settings item in the context menu. An alias for
-     * `Telegram.WebApp.offEvent('settingsButtonClicked', callback)`
+     * **Bot API 7.0+**
+     *
+     * A method that removes the press event handler from the Settings item in the context menu.
+     * An alias for `Telegram.WebApp.offEvent('settingsButtonClicked', callback)`
      */
     offClick(callback: () => void): SettingsButton;
     /**
-     * **Bot API 7.0+** A method to make the Settings item in the context menu
-     * visible.
+     * **Bot API 7.0+**
+     *
+     * A method to make the Settings item in the context menu visible.
      */
     show(): SettingsButton;
     /**
-     * **Bot API 7.0+** A method to hide the Settings item in the context menu.
+     * **Bot API 7.0+**
+     *
+     * A method to hide the Settings item in the context menu.
      */
     hide(): SettingsButton;
 }
@@ -674,7 +945,7 @@ interface SettingsButton {
 /**
  *  This object controls haptic feedback.
  */
-interface HapticFeedback {
+export interface HapticFeedback {
     /**
      * A method tells that an impact occurred. The Telegram app may play the
      * appropriate haptics based on style value passed. Style can be one of
@@ -706,7 +977,7 @@ interface HapticFeedback {
     selectionChanged(): void;
 }
 
-interface CloudStorage {
+export interface CloudStorage {
     /**
      * A method that stores a value in the cloud storage using the specified
      * key.
@@ -783,18 +1054,18 @@ interface CloudStorage {
     getKeys(callback?: CloudStorageGetKeysCallback): CloudStorage;
 }
 
-type CloudStorageSetItemCallback = (error: string | null, success: null | true) => void;
-type CloudStorageGetItemCallback = (error: string | null, value: null | string) => void;
-type CloudStorageGetItemsCallback = (error: string | null, values: null | Record<string, string>) => void;
-type CloudStorageRemoveItemCallback = (error: string | null, success: null | true) => void;
-type CloudStorageRemoveItemsCallback = (error: string | null, success: null | true) => void;
-type CloudStorageGetKeysCallback = (error: string | null, keys: null | string[]) => void;
+export type CloudStorageSetItemCallback = (error: string | null, success: null | true) => void;
+export type CloudStorageGetItemCallback = (error: string | null, value: null | string) => void;
+export type CloudStorageGetItemsCallback = (error: string | null, values: null | Record<string, string>) => void;
+export type CloudStorageRemoveItemCallback = (error: string | null, success: null | true) => void;
+export type CloudStorageRemoveItemsCallback = (error: string | null, success: null | true) => void;
+export type CloudStorageGetKeysCallback = (error: string | null, keys: null | string[]) => void;
 
 /**
  * This object controls biometrics on the device. Before the first use of this
  * object, it needs to be initialized using the init method.
  */
-interface BiometricManager {
+export interface BiometricManager {
     /**
      * Shows whether biometrics object is initialized.
      */
@@ -855,21 +1126,15 @@ interface BiometricManager {
      *
      * If so, the second argument will be a biometric token.
      */
-    authenticate: (
-        params: BiometricAuthenticateParams,
-        callback?: BiometricAuthenticateCallback,
-    ) => BiometricManager;
+    authenticate: (params: BiometricAuthenticateParams, callback?: BiometricAuthenticateCallback) => BiometricManager;
     /**
-     * A method that updates the biometric token in secure storage on the
-     * device. To remove the token, pass an empty string. If an optional
-     * callback parameter was passed, the callback function will be called and
-     * the first argument will be a boolean indicating whether the token was
-     * updated.
+     * A method that updates the biometric token in secure storage on the device.
+     * To remove the token, pass an empty string.
+     * If an optional callback parameter was passed,
+     * the callback function will be called
+     * and the first argument will be a boolean indicating whether the token was updated.
      */
-    updateBiometricToken: (
-        token: string,
-        callback?: BiometricUpdateBiometricTokenCallback,
-    ) => BiometricManager;
+    updateBiometricToken: (token: string, callback?: (success: boolean) => void) => BiometricManager;
     /**
      * A method that opens the biometric access settings for bots. Useful when
      * you need to request biometrics access to users who haven't granted it
@@ -882,15 +1147,14 @@ interface BiometricManager {
     openSettings: () => BiometricManager;
 }
 
-type BiometricRequestAccessCallback = (isAccessGranted: boolean) => void;
-type BiometricAuthenticateCallback = (isAuthenticated: boolean, biometricToken?: string) => void;
-type BiometricUpdateBiometricTokenCallback = (applied: boolean) => void;
+export type BiometricRequestAccessCallback = (isAccessGranted: boolean) => void;
+export type BiometricAuthenticateCallback = (isAuthenticated: boolean, biometricToken?: string) => void;
 
 /**
  * This object describes the native popup for requesting permission to use
  * biometrics.
  */
-interface BiometricRequestAccessParams {
+export interface BiometricRequestAccessParams {
     /**
      * The text to be displayed to a user in the popup describing why the bot
      * needs access to biometrics, 0-128 characters.
@@ -902,7 +1166,7 @@ interface BiometricRequestAccessParams {
  * This object describes the native popup for authenticating the user using
  * biometrics.
  */
-interface BiometricAuthenticateParams {
+export interface BiometricAuthenticateParams {
     /**
      * The text to be displayed to a user in the popup describing why you are
      * asking them to authenticate and what action you will be taking based on
@@ -915,7 +1179,7 @@ interface BiometricAuthenticateParams {
  * This object contains data that is transferred to the Web App when it is
  * opened. It is empty if the Web App was launched from a keyboard button.
  */
-interface WebAppInitData {
+export interface WebAppInitData {
     /**
      * A unique identifier for the Web App session, required for sending
      * messages via the answerWebAppQuery method.
@@ -970,7 +1234,7 @@ interface WebAppInitData {
 }
 
 /** This object contains the data of the Web App user. */
-interface WebAppUser {
+export interface WebAppUser {
     /**
      * A unique identifier for the user or bot. This number may have more than
      * 32 significant bits and some programming languages may have
@@ -1005,7 +1269,7 @@ interface WebAppUser {
 /**
  * This object represents a chat.
  */
-interface WebAppChat {
+export interface WebAppChat {
     /**
      * Unique identifier for this chat. This number may have more than 32
      * significant bits and some programming languages may have
@@ -1035,7 +1299,7 @@ interface WebAppChat {
 /**
  * This object describes the native popup for scanning QR codes.
  */
-interface ScanQrPopupParams {
+export interface ScanQrPopupParams {
     /**
      * The text to be displayed under the 'Scan QR' heading, 0-64 characters.
      */
@@ -1046,7 +1310,7 @@ interface ScanQrPopupParams {
  * This object describes contact information shared when requestContact was
  * approved by the user.
  */
-interface RequestContactResponseSent {
+export interface RequestContactResponseSent {
     /** Status 'sent' indicates that contact information has been shared. */
     status: "sent";
     /** A status message or result as a string. */
@@ -1076,17 +1340,17 @@ interface RequestContactResponseSent {
 /**
  * This object only contains a status to indicate the cancellation.
  */
-interface RequestContactResponseCancelled {
+export interface RequestContactResponseCancelled {
     /** Status 'cancelled', indicates that user cancelled the contact share
      * request. */
     status: "cancelled";
 }
 
-type RequestContactResponse = RequestContactResponseSent | RequestContactResponseCancelled;
+export type RequestContactResponse = RequestContactResponseSent | RequestContactResponseCancelled;
 
 /** This object describes additional sharing settings for the native story
  * editor. */
-interface StoryShareParams {
+export interface StoryShareParams {
     /** The caption to be added to the media, 0-200 characters for regular users
      * and 0-2048 characters for premium subscribers. */
     text?: string;
@@ -1096,9 +1360,412 @@ interface StoryShareParams {
 }
 
 /** This object describes a widget link to be included in the story. */
-interface StoryWidgetLink {
+export interface StoryWidgetLink {
     /** The URL to be included in the story. */
     url: string;
     /** The name to be displayed for the widget link, 0-48 characters. */
     name?: string;
 }
+
+export interface LocationData {
+    /**
+     * Latitude in degrees.
+     */
+    latitude: number;
+    /**
+     * Longitude in degrees.
+     */
+    longitude: number;
+    /**
+     * Altitude above sea level in meters. null if altitude data is not available on the device.
+     */
+    altitude: number | null;
+    /**
+     * The direction the device is moving in degrees (0 = North, 90 = East, 180 = South, 270 = West).
+     * null if course data is not available on the device.
+     */
+    course: number | null;
+    /**
+     * The speed of the device in m/s. null if speed data is not available on the device.
+     */
+    speed: number | null;
+    /**
+     * Accuracy of the latitude and longitude values in meters.
+     * null if horizontal accuracy data is not available on the device.
+     */
+    horizontal_accuracy: number | null;
+    /**
+     * Accuracy of the altitude value in meters.
+     * null if vertical accuracy data is not available on the device.
+     */
+    vertical_accuracy: number | null;
+    /**
+     * Accuracy of the course value in degrees.
+     * null if course accuracy data is not available on the device.
+     */
+    course_accuracy: number | null;
+    /**
+     * Accuracy of the speed value in m/s.
+     * null if speed accuracy data is not available on the device.
+     */
+    speed_accuracy: number | null;
+}
+
+export interface EmojiStatusParams {
+    /**
+     * Optional. The duration for which the status will remain set, in seconds.
+     */
+    duration?: number;
+}
+
+export interface DownloadFileParams {
+    /**
+     * The HTTPS URL of the file to be downloaded.
+     */
+    url: string;
+    /**
+     * The suggested name for the downloaded file.
+     */
+    file_name: string;
+}
+
+export interface SafeAreaInset {
+    /**
+     * The top inset in pixels, representing the space to avoid at the top of the screen.
+     * Also available as the CSS variable var(--tg-safe-area-inset-top).
+     */
+    top: number;
+    /**
+     * The bottom inset in pixels, representing the space to avoid at the bottom of the screen.
+     * Also available as the CSS variable var(--tg-safe-area-inset-bottom).
+     */
+    bottom: number;
+    /**
+     * The left inset in pixels, representing the space to avoid on the left side of the screen.
+     * Also available as the CSS variable var(--tg-safe-area-inset-left).
+     */
+    left: number;
+    /**
+     * The right inset in pixels, representing the space to avoid on the right side of the screen.
+     * Also available as the CSS variable var(--tg-safe-area-inset-right).
+     */
+    right: number;
+}
+
+export interface ContentSafeAreaInset {
+    /**
+     * The top inset in pixels, representing the space to avoid at the top of the content area.
+     * Also available as the CSS variable var(--tg-content-safe-area-inset-top).
+     */
+    top: number;
+    /**
+     * The bottom inset in pixels, representing the space to avoid at the bottom of the content area.
+     * Also available as the CSS variable var(--tg-content-safe-area-inset-bottom).
+     */
+    bottom: number;
+    /**
+     * The left inset in pixels, representing the space to avoid on the left side of the content area.
+     * Also available as the CSS variable var(--tg-content-safe-area-inset-left).
+     */
+    left: number;
+    /**
+     * The right inset in pixels, representing the space to avoid on the right side of the content area.
+     * Also available as the CSS variable var(--tg-content-safe-area-inset-right).
+     */
+    right: number;
+}
+
+export interface Accelerometer {
+    /**
+     * Indicates whether accelerometer tracking is currently active.
+     */
+    isStarted: boolean;
+    /**
+     * The current acceleration in the X-axis, measured in m/s².
+     */
+    x: number;
+    /**
+     * The current acceleration in the Y-axis, measured in m/s².
+     */
+    y: number;
+    /**
+     * The current acceleration in the Z-axis, measured in m/s².
+     */
+    z: number;
+    /**
+     * **Bot API 8.0+**
+     *
+     * Starts tracking accelerometer data using params of type AccelerometerStartParams.
+     * If an optional callback parameter is provided,
+     * the callback function will be called with a boolean indicating whether tracking was successfully started.
+     */
+    start: (params: AccelerometerStartParams, callback?: (success: boolean) => void) => Accelerometer;
+    /**
+     * **Bot API 8.0+**
+     *
+     * Stops tracking accelerometer data.
+     * If an optional callback parameter is provided,
+     * the callback function will be called with a boolean indicating
+     * whether tracking was successfully stopped.
+     */
+    stop: (callback?: (success: boolean) => void) => Accelerometer;
+}
+
+export interface AccelerometerStartParams {
+    /**
+     * Optional.
+     * The refresh rate in milliseconds, with acceptable values ranging from 20 to 1000.
+     * Set to 1000 by default. Note that refresh_rate may not be supported on all platforms,
+     * so the actual tracking frequency may differ from the specified value.
+     */
+    refresh_rate?: number;
+}
+
+export interface DeviceOrientation {
+    /**
+     * Indicates whether device orientation tracking is currently active.
+     */
+    isStarted: boolean;
+    /**
+     * A boolean that indicates whether or not the device is providing orientation data in absolute values.
+     */
+    absolute: boolean;
+    /**
+     * The rotation around the Z-axis, measured in radians.
+     */
+    alpha: number;
+    /**
+     * The rotation around the X-axis, measured in radians.
+     */
+    beta: number;
+    /**
+     * The rotation around the Y-axis, measured in radians.
+     */
+    gamma: number;
+    /**
+     * **Bot API 8.0+**
+     *
+     * Starts tracking device orientation data using params of type DeviceOrientationStartParams.
+     * If an optional callback parameter is provided,
+     * the callback function will be called with a boolean indicating whether tracking was successfully started.
+     */
+    start: (params: DeviceOrientationStartParams, callback?: (success: boolean) => void) => DeviceOrientation;
+    /**
+     * **Bot API 8.0+**
+     *
+     * Stops tracking device orientation data.
+     * If an optional callback parameter is provided,
+     * the callback function will be called with a boolean indicating whether tracking was successfully stopped.
+     */
+    stop: (callback?: (success: boolean) => void) => DeviceOrientation;
+}
+
+export interface DeviceOrientationStartParams {
+    /**
+     * Optional.
+     * The refresh rate in milliseconds, with acceptable values ranging from 20 to 1000.
+     * Set to 1000 by default. Note that refresh_rate may not be supported on all platforms,
+     * so the actual tracking frequency may differ from the specified value.
+     */
+    refresh_rate?: number;
+    /**
+     * Optional.
+     * Pass true to receive absolute orientation data,
+     * allowing you to determine the device's attitude relative to magnetic north.
+     * Use this option if implementing features like a compass in your app.
+     * If relative data is sufficient, pass false. Set to false by default.
+     *
+     * Note: Keep in mind that some devices may not support absolute orientation data.
+     * In such cases, you will receive relative data even if need_absolute=true is passed.
+     * Check the DeviceOrientation.absolute parameter to determine whether the data provided is absolute or relative.
+     */
+    need_absolute?: boolean;
+}
+
+export interface Gyroscope {
+    /**
+     * Indicates whether gyroscope tracking is currently active.
+     */
+    isStarted: boolean;
+    /**
+     * The current rotation rate around the X-axis, measured in rad/s.
+     */
+    x: number;
+    /**
+     * The current rotation rate around the Y-axis, measured in rad/s.
+     */
+    y: number;
+    /**
+     * The current rotation rate around the Z-axis, measured in rad/s.
+     */
+    z: number;
+    /**
+     * **Bot API 8.0+**
+     *
+     * Starts tracking gyroscope data using params of type GyroscopeStartParams.
+     * If an optional callback parameter is provided,
+     * the callback function will be called with a boolean indicating whether tracking was successfully started.
+     */
+    start: (params: GyroscopeStartParams, callback?: (success: boolean) => void) => Gyroscope;
+    /**
+     * **Bot API 8.0+**
+     *
+     * Stops tracking gyroscope data.
+     * If an optional callback parameter is provided,
+     * the callback function will be called with a boolean indicating whether tracking was successfully stopped.
+     */
+    stop: (callback?: (success: boolean) => void) => Gyroscope;
+}
+
+export interface GyroscopeStartParams {
+    /**
+     * Optional.
+     * The refresh rate in milliseconds, with acceptable values ranging from 20 to 1000.
+     * Set to 1000 by default. Note that refresh_rate may not be supported on all platforms,
+     * so the actual tracking frequency may differ from the specified value.
+     */
+    refresh_rate?: number;
+}
+
+export interface LocationManager {
+    /**
+     * Shows whether the LocationManager object has been initialized.
+     */
+    isInited: boolean;
+    /**
+     * Shows whether location services are available on the current device.
+     */
+    isLocationAvailable: boolean;
+    /**
+     * Shows whether permission to use location has been requested.
+     */
+    isAccessRequested: boolean;
+    /**
+     * Shows whether permission to use location has been granted.
+     */
+    isAccessGranted: boolean;
+    /**
+     * Bot API 8.0+
+     *
+     * A method that initializes the LocationManager object.
+     * It should be called before the object's first use.
+     * If an optional callback parameter is provided,
+     * the callback function will be called when the object is initialized.
+     */
+    init: (callback?: () => void) => LocationManager;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that requests location data.
+     * The callback function will be called with null as the first argument
+     * if access to location was not granted,
+     * or an object of type LocationData as the first argument if access was successful.
+     */
+    getLocation: (callback: (locationData: LocationData | null) => void) => LocationManager;
+    /**
+     * **Bot API 8.0+**
+     *
+     * A method that opens the location access settings for bots.
+     * Useful when you need to request location access from users who haven't granted it yet.
+     *
+     * Note that this method can be called only in response to user interaction with the Mini App interface
+     * (e.g., a click inside the Mini App or on the main button).
+     */
+    openSettings: () => LocationManager;
+}
+
+export interface DeviceStorage {
+    /**
+     * Bot API 9.0+
+     *
+     * A method that stores a value in the device's local storage using the specified key.
+     * If an optional callback parameter was passed, the callback function will be called.
+     * In case of an error, the first argument will contain the error.
+     * In case of success, the first argument will be null and the second argument will be a boolean
+     * indicating whether the value was stored.
+     */
+    setItem: (key: string, value: string, callback?: (error: string | null, success: boolean) => void) => DeviceStorage;
+    /**
+     * Bot API 9.0+
+     *
+     * A method that receives a value from the device's local storage using the specified key.
+     * In case of an error, the callback function will be called and the first argument will contain the error.
+     * In case of success, the first argument will be null and the value will be passed as the second argument.
+     */
+    getItem: (key: string, callback?: (error: string | null, item: string) => void) => DeviceStorage;
+    /**
+     * Bot API 9.0+
+     *
+     * A method that removes a value from the device's local storage using the specified key.
+     * If an optional callback parameter was passed, the callback function will be called.
+     * In case of an error, the first argument will contain the error.
+     * In case of success, the first argument will be null
+     * and the second argument will be a boolean indicating whether the value was removed.
+     */
+    removeItem: (key: string, callback?: (error: string | null, success: boolean) => void) => DeviceStorage;
+    /**
+     * Bot API 9.0+
+     *
+     * A method that clears all keys previously stored by the bot in the device's local storage.
+     * If an optional callback parameter was passed, the callback function will be called.
+     * In case of an error, the first argument will contain the error.
+     * In case of success, the first argument will be null
+     * and the second argument will be a boolean indicating whether all values were removed.
+     */
+    clear: (callback?: (error: string | null, success: boolean) => void) => DeviceStorage;
+}
+
+export interface SecureStorage {
+    /**
+     * Bot API 9.0+
+     *
+     * A method that stores a value in the device's secure storage using the specified key.
+     * If an optional callback parameter was passed, the callback function will be called.
+     * In case of an error, the first argument will contain the error.
+     * In case of success, the first argument will be null
+     * and the second argument will be a boolean indicating whether the value was stored.
+     */
+    setItem: (key: string, value: string, callback?: (error: string | null, success: boolean) => void) => SecureStorage;
+    /**
+     * Bot API 9.0+
+     *
+     * A method that receives a value from the device's secure storage using the specified key.
+     * In case of an error, the callback function will be called and the first argument will contain the error.
+     * In case of success, the first argument will be null and the value will be passed as the second argument.
+     * If the key was not found, the second argument will be null,
+     * and the third argument will be a boolean indicating whether the key can be restored from the current device.
+     */
+    getItem: (
+        key: string,
+        callback?: (error: string | null, item: string | null, restorable: boolean) => void,
+    ) => SecureStorage;
+    /**
+     * Bot API 9.0+
+     *
+     * Attempts to restore a key that previously existed on the current device.
+     * When called, the user will be asked for permission to restore the value.
+     * If the user declines or an error occurs, the first argument in the callback will contain the error.
+     * If restored successfully, the first argument will be null and the second argument will contain the restored value.
+     */
+    restoreItem: (key: string, callback?: (error: string | null, item: string) => void) => SecureStorage;
+    /**
+     * Bot API 9.0+
+     *
+     * A method that removes a value from the device's secure storage using the specified key.
+     * If an optional callback parameter was passed, the callback function will be called.
+     * In case of an error, the first argument will contain the error.
+     * In case of success, the first argument will be null
+     * and the second argument will be a boolean indicating whether the value was removed.
+     */
+    removeItem: (key: string, callback?: (error: string | null, success: boolean) => void) => SecureStorage;
+    /**
+     * Bot API 9.0+
+     *
+     * A method that clears all keys previously stored by the bot in the device's secure storage.
+     * If an optional callback parameter was passed, the callback function will be called.
+     * In case of an error, the first argument will contain the error. In case of success,
+     * the first argument will be null
+     * and the second argument will be a boolean indicating whether all values were removed.
+     */
+    clear: (callback?: (error: string | null, success: boolean) => void) => SecureStorage;
+}

telegram-web-app/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/telegram-web-app",
-    "version": "7.10.1",
+    "version": "9.0.0",
     "description": "TypeScript definitions for telegram-web-app",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/telegram-web-app",
     "license": "MIT",
@@ -30,6 +30,7 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "dd411016825024a1d9831f7377413945af40bc47d3332d6e2bc950e461fe28cd",
-    "typeScriptVersion": "4.8"
+    "peerDependencies": {},
+    "typesPublisherContentHash": "d7b82247812d99fcf54be15de02ee34a9f8303892f0fc6e52b1927018a8f4535",
+    "typeScriptVersion": "5.1"
 }