@grom.js/bot-api-spec 0.7.1 → 0.9.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@grom.js/bot-api-spec",
   "type": "module",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Telegram Bot API specification as a collection of JavaScript objects in a custom format.",
   "license": "MIT",
   "repository": {
@@ -26,16 +26,16 @@
     "node": ">=22.18"
   },
   "devDependencies": {
-    "@antfu/eslint-config": "7.3.0",
-    "@types/node": "22.19.10",
+    "@antfu/eslint-config": "7.7.3",
+    "@types/node": "22.19.17",
     "@types/turndown": "5.0.6",
-    "bumpp": "10.4.1",
+    "bumpp": "11.0.1",
     "cheerio": "1.2.0",
-    "domhandler": "5.0.3",
-    "eslint": "9.39.2",
-    "eslint-plugin-format": "1.4.0",
-    "taze": "19.9.2",
-    "turndown": "7.2.2",
+    "domhandler": "6.0.1",
+    "eslint": "9.39.4",
+    "eslint-plugin-format": "2.0.1",
+    "taze": "19.11.0",
+    "turndown": "7.2.4",
     "typescript": "5.9.3",
     "zod": "4.3.6"
   },

package/src/methods.gen.ts

@@ -3962,17 +3962,60 @@ const sendPoll: ApiMethod = {
         type: 'bool',
       },
       description: {
-        markdown: '_True_, if the poll allows multiple answers, ignored for polls in quiz mode, defaults to _False_',
+        markdown: 'Pass _True_, if the poll allows multiple answers, defaults to _False_',
       },
       required: false,
     },
     {
-      name: 'correct_option_id',
+      name: 'allows_revoting',
       type: {
-        type: 'int32',
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_, if the poll allows to change chosen answer options, defaults to _False_ for quizzes and to _True_ for regular polls',
+      },
+      required: false,
+    },
+    {
+      name: 'shuffle_options',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_, if the poll options must be shown in random order',
+      },
+      required: false,
+    },
+    {
+      name: 'allow_adding_options',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_, if answer options can be added to the poll after creation; not supported for anonymous polls and quizzes',
+      },
+      required: false,
+    },
+    {
+      name: 'hide_results_until_closes',
+      type: {
+        type: 'bool',
       },
       description: {
-        markdown: '0-based identifier of the correct answer option, required for polls in quiz mode',
+        markdown: 'Pass _True_, if poll results must be shown only after the poll closes',
+      },
+      required: false,
+    },
+    {
+      name: 'correct_option_ids',
+      type: {
+        type: 'array',
+        of: {
+          type: 'int32',
+        },
+      },
+      description: {
+        markdown: 'An array of monotonically increasing 0-based identifiers of the correct answer options, required for polls in quiz mode',
       },
       required: false,
     },
@@ -4030,7 +4073,7 @@ const sendPoll: ApiMethod = {
         type: 'int32',
       },
       description: {
-        markdown: 'Amount of time in seconds the poll will be active after creation, 5-600. Can\'t be used together with _close\\_date_.',
+        markdown: 'Amount of time in seconds the poll will be active after creation, 5-2628000. Can\'t be used together with _close\\_date_.',
       },
       required: false,
     },
@@ -4040,7 +4083,7 @@ const sendPoll: ApiMethod = {
         type: 'int32',
       },
       description: {
-        markdown: 'Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 600 seconds in the future. Can\'t be used together with _open\\_period_.',
+        markdown: 'Point in time (Unix timestamp) when the poll will be automatically closed. Must be at least 5 and no more than 2628000 seconds in the future. Can\'t be used together with _open\\_period_.',
       },
       required: false,
     },
@@ -4054,6 +4097,40 @@ const sendPoll: ApiMethod = {
       },
       required: false,
     },
+    {
+      name: 'description',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'Description of the poll to be sent, 0-1024 characters after entities parsing',
+      },
+      required: false,
+    },
+    {
+      name: 'description_parse_mode',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'Mode for parsing entities in the poll description. See [formatting options](https://core.telegram.org/bots/api#formatting-options) for more details.',
+      },
+      required: false,
+    },
+    {
+      name: 'description_entities',
+      type: {
+        type: 'array',
+        of: {
+          type: 'api-type',
+          name: 'MessageEntity',
+        },
+      },
+      description: {
+        markdown: 'An array of special entities that appear in the poll description, which can be specified instead of _description\\_parse\\_mode_',
+      },
+      required: false,
+    },
     {
       name: 'disable_notification',
       type: {
@@ -4225,7 +4302,7 @@ const sendChecklist: ApiMethod = {
         name: 'InlineKeyboardMarkup',
       },
       description: {
-        markdown: 'An object for an inline keyboard',
+        markdown: 'An object for an [inline keyboard](https://core.telegram.org/bots/features#inline-keyboards)',
       },
       required: false,
     },
@@ -4426,7 +4503,7 @@ const sendDice: ApiMethod = {
 const sendMessageDraft: ApiMethod = {
   name: 'sendMessageDraft',
   description: {
-    markdown: 'Use this method to stream a partial message to a user while the message is being generated; supported only for bots with forum topic mode enabled. Returns _True_ on success.',
+    markdown: 'Use this method to stream a partial message to a user while the message is being generated. Returns _True_ on success.',
   },
   parameters: [
     {
@@ -5216,6 +5293,16 @@ const promoteChatMember: ApiMethod = {
       },
       required: false,
     },
+    {
+      name: 'can_manage_tags',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_ if the administrator can edit the tags of regular members; for groups and supergroups only',
+      },
+      required: false,
+    },
   ],
   returnType: {
     type: 'bool',
@@ -5274,6 +5361,57 @@ const setChatAdministratorCustomTitle: ApiMethod = {
   },
 }
 
+const setChatMemberTag: ApiMethod = {
+  name: 'setChatMemberTag',
+  description: {
+    markdown: 'Use this method to set a tag for a regular member in a group or a supergroup. The bot must be an administrator in the chat for this to work and must have the _can\\_manage\\_tags_ administrator right. Returns _True_ on success.',
+  },
+  parameters: [
+    {
+      name: 'chat_id',
+      type: {
+        type: 'union',
+        types: [
+          {
+            type: 'int32',
+          },
+          {
+            type: 'str',
+          },
+        ],
+      },
+      description: {
+        markdown: 'Unique identifier for the target chat or username of the target supergroup (in the format `@supergroupusername`)',
+      },
+      required: true,
+    },
+    {
+      name: 'user_id',
+      type: {
+        type: 'int32',
+      },
+      description: {
+        markdown: 'Unique identifier of the target user',
+      },
+      required: true,
+    },
+    {
+      name: 'tag',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'New tag for the member; 0-16 characters, emoji are not allowed',
+      },
+      required: false,
+    },
+  ],
+  returnType: {
+    type: 'bool',
+    literal: true,
+  },
+}
+
 const banChatSenderChat: ApiMethod = {
   name: 'banChatSenderChat',
   description: {
@@ -7012,6 +7150,50 @@ const getBusinessConnection: ApiMethod = {
   },
 }
 
+const getManagedBotToken: ApiMethod = {
+  name: 'getManagedBotToken',
+  description: {
+    markdown: 'Use this method to get the token of a managed bot. Returns the token as _String_ on success.',
+  },
+  parameters: [
+    {
+      name: 'user_id',
+      type: {
+        type: 'int32',
+      },
+      description: {
+        markdown: 'User identifier of the managed bot whose token will be returned',
+      },
+      required: true,
+    },
+  ],
+  returnType: {
+    type: 'str',
+  },
+}
+
+const replaceManagedBotToken: ApiMethod = {
+  name: 'replaceManagedBotToken',
+  description: {
+    markdown: 'Use this method to revoke the current token of a managed bot and generate a new one. Returns the new token as _String_ on success.',
+  },
+  parameters: [
+    {
+      name: 'user_id',
+      type: {
+        type: 'int32',
+      },
+      description: {
+        markdown: 'User identifier of the managed bot whose token will be replaced',
+      },
+      required: true,
+    },
+  ],
+  returnType: {
+    type: 'str',
+  },
+}
+
 const setMyCommands: ApiMethod = {
   name: 'setMyCommands',
   description: {
@@ -7545,7 +7727,7 @@ const sendGift: ApiMethod = {
         ],
       },
       description: {
-        markdown: 'Mode for parsing entities in the text. See [formatting options](https://core.telegram.org/bots/api#formatting-options) for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom\\_emoji” are ignored.',
+        markdown: 'Mode for parsing entities in the text. See [formatting options](https://core.telegram.org/bots/api#formatting-options) for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, “custom\\_emoji”, and “date\\_time” are ignored.',
       },
       required: false,
     },
@@ -7664,7 +7846,7 @@ const giftPremiumSubscription: ApiMethod = {
         ],
       },
       description: {
-        markdown: 'Mode for parsing entities in the text. See [formatting options](https://core.telegram.org/bots/api#formatting-options) for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, and “custom\\_emoji” are ignored.',
+        markdown: 'Mode for parsing entities in the text. See [formatting options](https://core.telegram.org/bots/api#formatting-options) for more details. Entities other than “bold”, “italic”, “underline”, “strikethrough”, “spoiler”, “custom\\_emoji”, and “date\\_time” are ignored.',
       },
       required: false,
     },
@@ -9052,6 +9234,148 @@ const deleteStory: ApiMethod = {
   },
 }
 
+const answerWebAppQuery: ApiMethod = {
+  name: 'answerWebAppQuery',
+  description: {
+    markdown: 'Use this method to set the result of an interaction with a [Web App](https://core.telegram.org/bots/webapps) and send a corresponding message on behalf of the user to the chat from which the query originated. On success, a [SentWebAppMessage](https://core.telegram.org/bots/api#sentwebappmessage) object is returned.',
+  },
+  parameters: [
+    {
+      name: 'web_app_query_id',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'Unique identifier for the query to be answered',
+      },
+      required: true,
+    },
+    {
+      name: 'result',
+      type: {
+        type: 'api-type',
+        name: 'InlineQueryResult',
+      },
+      description: {
+        markdown: 'An object describing the message to be sent',
+      },
+      required: true,
+    },
+  ],
+  returnType: {
+    type: 'api-type',
+    name: 'SentWebAppMessage',
+  },
+}
+
+const savePreparedInlineMessage: ApiMethod = {
+  name: 'savePreparedInlineMessage',
+  description: {
+    markdown: 'Stores a message that can be sent by a user of a Mini App. Returns a [PreparedInlineMessage](https://core.telegram.org/bots/api#preparedinlinemessage) object.',
+  },
+  parameters: [
+    {
+      name: 'user_id',
+      type: {
+        type: 'int32',
+      },
+      description: {
+        markdown: 'Unique identifier of the target user that can use the prepared message',
+      },
+      required: true,
+    },
+    {
+      name: 'result',
+      type: {
+        type: 'api-type',
+        name: 'InlineQueryResult',
+      },
+      description: {
+        markdown: 'An object describing the message to be sent',
+      },
+      required: true,
+    },
+    {
+      name: 'allow_user_chats',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_ if the message can be sent to private chats with users',
+      },
+      required: false,
+    },
+    {
+      name: 'allow_bot_chats',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_ if the message can be sent to private chats with bots',
+      },
+      required: false,
+    },
+    {
+      name: 'allow_group_chats',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_ if the message can be sent to group and supergroup chats',
+      },
+      required: false,
+    },
+    {
+      name: 'allow_channel_chats',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: 'Pass _True_ if the message can be sent to channel chats',
+      },
+      required: false,
+    },
+  ],
+  returnType: {
+    type: 'api-type',
+    name: 'PreparedInlineMessage',
+  },
+}
+
+const savePreparedKeyboardButton: ApiMethod = {
+  name: 'savePreparedKeyboardButton',
+  description: {
+    markdown: 'Stores a keyboard button that can be used by a user within a Mini App. Returns a [PreparedKeyboardButton](https://core.telegram.org/bots/api#preparedkeyboardbutton) object.',
+  },
+  parameters: [
+    {
+      name: 'user_id',
+      type: {
+        type: 'int32',
+      },
+      description: {
+        markdown: 'Unique identifier of the target user that can use the button',
+      },
+      required: true,
+    },
+    {
+      name: 'button',
+      type: {
+        type: 'api-type',
+        name: 'KeyboardButton',
+      },
+      description: {
+        markdown: 'An object describing the button to be saved. The button must be of the type _request\\_users_, _request\\_chat_, or _request\\_managed\\_bot_',
+      },
+      required: true,
+    },
+  ],
+  returnType: {
+    type: 'api-type',
+    name: 'PreparedKeyboardButton',
+  },
+}
+
 const editMessageText: ApiMethod = {
   name: 'editMessageText',
   description: {
@@ -9699,7 +10023,7 @@ const editMessageChecklist: ApiMethod = {
         name: 'InlineKeyboardMarkup',
       },
       description: {
-        markdown: 'An object for the new inline keyboard for the message',
+        markdown: 'An object for the new [inline keyboard](https://core.telegram.org/bots/features#inline-keyboards) for the message',
       },
       required: false,
     },
@@ -10905,114 +11229,6 @@ const answerInlineQuery: ApiMethod = {
   },
 }
 
-const answerWebAppQuery: ApiMethod = {
-  name: 'answerWebAppQuery',
-  description: {
-    markdown: 'Use this method to set the result of an interaction with a [Web App](https://core.telegram.org/bots/webapps) and send a corresponding message on behalf of the user to the chat from which the query originated. On success, a [SentWebAppMessage](https://core.telegram.org/bots/api#sentwebappmessage) object is returned.',
-  },
-  parameters: [
-    {
-      name: 'web_app_query_id',
-      type: {
-        type: 'str',
-      },
-      description: {
-        markdown: 'Unique identifier for the query to be answered',
-      },
-      required: true,
-    },
-    {
-      name: 'result',
-      type: {
-        type: 'api-type',
-        name: 'InlineQueryResult',
-      },
-      description: {
-        markdown: 'An object describing the message to be sent',
-      },
-      required: true,
-    },
-  ],
-  returnType: {
-    type: 'api-type',
-    name: 'SentWebAppMessage',
-  },
-}
-
-const savePreparedInlineMessage: ApiMethod = {
-  name: 'savePreparedInlineMessage',
-  description: {
-    markdown: 'Stores a message that can be sent by a user of a Mini App. Returns a [PreparedInlineMessage](https://core.telegram.org/bots/api#preparedinlinemessage) object.',
-  },
-  parameters: [
-    {
-      name: 'user_id',
-      type: {
-        type: 'int32',
-      },
-      description: {
-        markdown: 'Unique identifier of the target user that can use the prepared message',
-      },
-      required: true,
-    },
-    {
-      name: 'result',
-      type: {
-        type: 'api-type',
-        name: 'InlineQueryResult',
-      },
-      description: {
-        markdown: 'An object describing the message to be sent',
-      },
-      required: true,
-    },
-    {
-      name: 'allow_user_chats',
-      type: {
-        type: 'bool',
-      },
-      description: {
-        markdown: 'Pass _True_ if the message can be sent to private chats with users',
-      },
-      required: false,
-    },
-    {
-      name: 'allow_bot_chats',
-      type: {
-        type: 'bool',
-      },
-      description: {
-        markdown: 'Pass _True_ if the message can be sent to private chats with bots',
-      },
-      required: false,
-    },
-    {
-      name: 'allow_group_chats',
-      type: {
-        type: 'bool',
-      },
-      description: {
-        markdown: 'Pass _True_ if the message can be sent to group and supergroup chats',
-      },
-      required: false,
-    },
-    {
-      name: 'allow_channel_chats',
-      type: {
-        type: 'bool',
-      },
-      description: {
-        markdown: 'Pass _True_ if the message can be sent to channel chats',
-      },
-      required: false,
-    },
-  ],
-  returnType: {
-    type: 'api-type',
-    name: 'PreparedInlineMessage',
-  },
-}
-
 const sendInvoice: ApiMethod = {
   name: 'sendInvoice',
   description: {
@@ -12161,6 +12377,7 @@ export const methods = {
   restrictChatMember,
   promoteChatMember,
   setChatAdministratorCustomTitle,
+  setChatMemberTag,
   banChatSenderChat,
   unbanChatSenderChat,
   setChatPermissions,
@@ -12202,6 +12419,8 @@ export const methods = {
   answerCallbackQuery,
   getUserChatBoosts,
   getBusinessConnection,
+  getManagedBotToken,
+  replaceManagedBotToken,
   setMyCommands,
   deleteMyCommands,
   getMyCommands,
@@ -12244,6 +12463,9 @@ export const methods = {
   repostStory,
   editStory,
   deleteStory,
+  answerWebAppQuery,
+  savePreparedInlineMessage,
+  savePreparedKeyboardButton,
   editMessageText,
   editMessageCaption,
   editMessageMedia,
@@ -12273,8 +12495,6 @@ export const methods = {
   setCustomEmojiStickerSetThumbnail,
   deleteStickerSet,
   answerInlineQuery,
-  answerWebAppQuery,
-  savePreparedInlineMessage,
   sendInvoice,
   createInvoiceLink,
   answerShippingQuery,