@types/telegram-web-app 6.2.2 → 6.7.0

telegram-web-app/README.md

@@ -8,9 +8,9 @@ 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: Mon, 03 Oct 2022 05:32:56 GMT
+ * Last updated: Wed, 26 Apr 2023 21:02:48 GMT
  * Dependencies: none
  * Global values: `Telegram`
 
 # Credits
-These definitions were written by [KnorpelSenf](https://github.com/KnorpelSenf), and [MKRhere](https://github.com/MKRhere).
+These definitions were written by [KnorpelSenf](https://github.com/KnorpelSenf), [MKRhere](https://github.com/MKRhere), and [deptyped](https://github.com/deptyped).

telegram-web-app/index.d.ts

@@ -1,6 +1,8 @@
-// Type definitions for non-npm package telegram-web-app 6.2
+// Type definitions for non-npm package telegram-web-app 6.7
 // Project: https://telegram.org/js/telegram-web-app.js
-// Definitions by: KnorpelSenf <https://github.com/KnorpelSenf>, MKRhere <https://github.com/MKRhere>
+// Definitions by: KnorpelSenf <https://github.com/KnorpelSenf>
+//                 MKRhere <https://github.com/MKRhere>
+//                 deptyped <https://github.com/deptyped>
 // Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
 
 declare var Telegram: Telegram;
@@ -28,6 +30,10 @@ interface WebApp {
      * The version of the Bot API available in the user's Telegram app.
      */
     version: string;
+    /**
+     * The name of the platform of the user's Telegram app.
+     */
+    platform: string;
     /**
      * The color scheme currently used in the Telegram app. Either “light” or
      * “dark”. Also available as the CSS variable var(--tg-color-scheme).
@@ -140,6 +146,10 @@ interface WebApp {
     ): void;
     onEvent(eventType: 'popupClosed', eventHandler: (eventData: { button_id: string | null }) => void): void;
     onEvent(eventType: 'viewportChanged', eventHandler: (eventData: { isStateStable: boolean }) => void): void;
+    onEvent(eventType: 'invoiceClosed', eventHandler: (eventData: { url: string, status: 'paid' | 'cancelled' | 'failed' | 'pending' }) => void): void;
+    onEvent(eventType: 'qrTextReceived', eventHandler: (eventData: { data: string }) => void): void;
+    onEvent(eventType: 'clipboardTextReceived', eventHandler: (eventData: { data: string | null }) => void): void;
+
     /** A method that deletes a previously set event handler. */
     offEvent(
         eventType: 'themeChanged' | 'mainButtonClicked' | 'backButtonClicked' | 'settingsButtonClicked',
@@ -147,6 +157,10 @@ interface WebApp {
     ): void;
     offEvent(eventType: 'popupClosed', eventHandler: (eventData: { button_id: string | null }) => void): void;
     offEvent(eventType: 'viewportChanged', eventHandler: (eventData: { isStateStable: boolean }) => void): void;
+    offEvent(eventType: 'invoiceClosed', eventHandler: (eventData: { url: string, status: 'paid' | 'cancelled' | 'failed' | 'pending' }) => void): void;
+    offEvent(eventType: 'qrTextReceived', eventHandler: (eventData: { data: string }) => void): void;
+    offEvent(eventType: 'clipboardTextReceived', eventHandler: (eventData: { data: string | null }) => void): void;
+
     /**
      * A method used to send data to the bot. When this method is called, a
      * service message is sent to the bot containing the data data of the length
@@ -157,12 +171,24 @@ interface WebApp {
      */
     sendData(data: string): void;
     /**
-     * A method that opens a link in an external browser. The Web App will not
-     * be closed. Note that this method can be called only in response to the
-     * user interaction with the Web App interface (e.g. click inside the Web
-     * App or on the main button)
+     * A method that inserts the bot's username and the specified inline query in the current chat's input field.
+     * Query may be empty, in which case only the bot's username will be inserted.
+     * If an optional choose_chat_types parameter was passed, the client prompts the user to choose a specific chat,
+     * then opens that chat and inserts the bot's username and the specified inline query in the input field.
+     * You can specify which types of chats the user will be able to choose from.
+     * It can be one or more of the following types: users, bots, groups, channels.
+     */
+    switchInlineQuery(query: string, choose_chat_types?: Array<'users' | 'bots' | 'groups' | 'channels'>): void;
+    /**
+     * A method that opens a link in an external browser.
+     * The Web App will not be closed.
+     * If the optional options parameter is passed with the field
+     * @param try_instant_view the link will be opened in Instant View mode if possible.
+     *
+     * Note that this method can be called only in response to user interaction with
+     * the Web App interface (e.g. a click inside the Web App or on the main button)
      */
-    openLink(url: string): void;
+    openLink(url: string, options?: { try_instant_view?: boolean }): void;
     /**
      * A method that opens a telegram link inside Telegram app. The Web App will
      * be closed.
@@ -174,7 +200,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: () => void): void;
+    openInvoice(url: string, callback: (url: string, 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 the popup is closed. If an optional
@@ -194,6 +220,27 @@ interface WebApp {
      * pressed the 'OK' button.
      */
     showConfirm(message: string, callback?: (ok?: boolean) => void): void;
+    /**
+     * A method that shows a native popup for scanning a QR code described by the params argument of the type ScanQrPopupParams.
+     * The Web App will receive the event qrTextReceived every time the scanner catches a code with text data.
+     * If an optional callback parameter was passed, the callback function will be called and the text from the QR
+     * code will be passed as the first argument. Returning true inside this callback function causes the popup to be closed.
+     */
+    showScanQrPopup(params: ScanQrPopupParams, callback?: (data: string) => void): void;
+    /**
+     * A method that closes the native popup for scanning a QR code opened with the
+     * showScanQrPopup method. Run it if you received valid data in the event qrTextReceived.
+     */
+    closeScanQrPopup(): 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 App interface (e.g. a click inside the Web App or on the main button).
+     */
+    readTextFromClipboard(callback?: (data: string | null) => 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
@@ -471,6 +518,18 @@ interface WebAppInitData {
      * only for Web Apps launched via the attachment menu.
      */
     chat?: WebAppChat;
+    /**
+     * Type of the chat from which the Web App was opened.
+     * Can be either “sender” for a private chat with the user opening the link,
+     * “private”, “group”, “supergroup”, or “channel”.
+     * Returned only for Web Apps launched from direct links.
+     */
+    chat_type?: 'sender' | 'private' | 'group' | 'supergroup' | 'channel';
+    /**
+     * Global identifier, uniquely corresponding to the chat from which the Web App was opened.
+     * Returned only for Web Apps launched from a direct link.
+     */
+    chat_instance?: string;
     /**
      * The value of the startattach parameter, passed via link. Only returned for
      * Web Apps when launched from the attachment menu via link. The value of the
@@ -552,3 +611,13 @@ interface WebAppChat {
      */
     photo_url?: string;
 }
+
+/**
+ * This object describes the native popup for scanning QR codes.
+ */
+interface ScanQrPopupParams {
+    /**
+     * The text to be displayed under the 'Scan QR' heading, 0-64 characters.
+     */
+    text?: string;
+}

telegram-web-app/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@types/telegram-web-app",
-    "version": "6.2.2",
+    "version": "6.7.0",
     "description": "TypeScript definitions for telegram-web-app",
     "homepage": "https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/telegram-web-app",
     "license": "MIT",
@@ -14,6 +14,11 @@
             "name": "MKRhere",
             "url": "https://github.com/MKRhere",
             "githubUsername": "MKRhere"
+        },
+        {
+            "name": "deptyped",
+            "url": "https://github.com/deptyped",
+            "githubUsername": "deptyped"
         }
     ],
     "main": "",
@@ -25,6 +30,6 @@
     },
     "scripts": {},
     "dependencies": {},
-    "typesPublisherContentHash": "f12ee7f0dae9d5aa5ee9b896d22a1a9485fa21ae096cc9eada73fd3d306bd94a",
-    "typeScriptVersion": "4.1"
+    "typesPublisherContentHash": "087c84405ec21f5ea2663c05b6ff92799f58e740cd633c419e95f197342d36bc",
+    "typeScriptVersion": "4.3"
 }