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

package/package.json

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

package/src/methods.gen.ts

@@ -4225,7 +4225,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 +4426,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 +5216,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 +5284,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: {
@@ -9699,7 +9760,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,
     },
@@ -12161,6 +12222,7 @@ export const methods = {
   restrictChatMember,
   promoteChatMember,
   setChatAdministratorCustomTitle,
+  setChatMemberTag,
   banChatSenderChat,
   unbanChatSenderChat,
   setChatPermissions,

package/src/types.gen.ts

@@ -1304,6 +1304,16 @@ const Message = t({
       },
       required: false,
     },
+    {
+      name: 'sender_tag',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'Tag or custom title of the sender of the message; for supergroups only',
+      },
+      required: false,
+    },
     {
       name: 'date',
       type: {
@@ -1482,7 +1492,7 @@ const Message = t({
         type: 'str',
       },
       description: {
-        markdown: 'The unique identifier of a media message group this message belongs to',
+        markdown: 'The unique identifier inside this chat of a media message group this message belongs to',
       },
       required: false,
     },
@@ -2379,7 +2389,7 @@ const Message = t({
         name: 'InlineKeyboardMarkup',
       },
       description: {
-        markdown: 'Inline keyboard attached to the message. `login_url` buttons are represented as ordinary `url` buttons.',
+        markdown: '[Inline keyboard](https://core.telegram.org/bots/features#inline-keyboards) attached to the message. `login_url` buttons are represented as ordinary `url` buttons.',
       },
       required: false,
     },
@@ -2550,10 +2560,14 @@ const MessageEntity = t({
             type: 'str',
             literal: 'custom_emoji',
           },
+          {
+            type: 'str',
+            literal: 'date_time',
+          },
         ],
       },
       description: {
-        markdown: 'Type of the entity. Currently, can be “mention” (`@username`), “hashtag” (`#hashtag` or `#hashtag@chatusername`), “cashtag” (`$USD` or `$USD@chatusername`), “bot\\_command” (`/start@jobs_bot`), “url” (`https://telegram.org`), “email” (`do-not-reply@telegram.org`), “phone\\_number” (`+1-212-555-0123`), “bold” (**bold text**), “italic” (_italic text_), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable\\_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text\\_link” (for clickable text URLs), “text\\_mention” (for users [without usernames](https://telegram.org/blog/edit#new-mentions)), “custom\\_emoji” (for inline custom emoji stickers)',
+        markdown: 'Type of the entity. Currently, can be “mention” (`@username`), “hashtag” (`#hashtag` or `#hashtag@chatusername`), “cashtag” (`$USD` or `$USD@chatusername`), “bot\\_command” (`/start@jobs_bot`), “url” (`https://telegram.org`), “email” (`do-not-reply@telegram.org`), “phone\\_number” (`+1-212-555-0123`), “bold” (**bold text**), “italic” (_italic text_), “underline” (underlined text), “strikethrough” (strikethrough text), “spoiler” (spoiler message), “blockquote” (block quotation), “expandable\\_blockquote” (collapsed-by-default block quotation), “code” (monowidth string), “pre” (monowidth block), “text\\_link” (for clickable text URLs), “text\\_mention” (for users [without usernames](https://telegram.org/blog/edit#new-mentions)), “custom\\_emoji” (for inline custom emoji stickers), or “date\\_time” (for formatted date and time)',
       },
       required: true,
     },
@@ -2618,6 +2632,26 @@ const MessageEntity = t({
       },
       required: false,
     },
+    {
+      name: 'unix_time',
+      type: {
+        type: 'int32',
+      },
+      description: {
+        markdown: 'For “date\\_time” only, the Unix time associated with the entity',
+      },
+      required: false,
+    },
+    {
+      name: 'date_time_format',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'For “date\\_time” only, the string that defines the formatting of the date and time. See [date-time entity formatting](https://core.telegram.org/bots/api#date-time-entity-formatting) for more details.',
+      },
+      required: false,
+    },
   ],
 })
 
@@ -8156,6 +8190,16 @@ const ChatAdministratorRights = t({
       },
       required: false,
     },
+    {
+      name: 'can_manage_tags',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: '_True_, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can\\_pin\\_messages.',
+      },
+      required: false,
+    },
   ],
 })
 
@@ -8535,6 +8579,16 @@ const ChatMemberAdministrator = t({
       },
       required: false,
     },
+    {
+      name: 'can_manage_tags',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: '_True_, if the administrator can edit the tags of regular members; for groups and supergroups only. If omitted defaults to the value of can\\_pin\\_messages.',
+      },
+      required: false,
+    },
     {
       name: 'custom_title',
       type: {
@@ -8565,6 +8619,16 @@ const ChatMemberMember = t({
       },
       required: true,
     },
+    {
+      name: 'tag',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'Tag of the member',
+      },
+      required: false,
+    },
     {
       name: 'user',
       type: {
@@ -8606,6 +8670,16 @@ const ChatMemberRestricted = t({
       },
       required: true,
     },
+    {
+      name: 'tag',
+      type: {
+        type: 'str',
+      },
+      description: {
+        markdown: 'Tag of the member',
+      },
+      required: false,
+    },
     {
       name: 'user',
       type: {
@@ -8727,6 +8801,16 @@ const ChatMemberRestricted = t({
       },
       required: true,
     },
+    {
+      name: 'can_edit_tag',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: '_True_, if the user is allowed to edit their own tag',
+      },
+      required: true,
+    },
     {
       name: 'can_change_info',
       type: {
@@ -9030,6 +9114,16 @@ const ChatPermissions = t({
       },
       required: false,
     },
+    {
+      name: 'can_edit_tag',
+      type: {
+        type: 'bool',
+      },
+      description: {
+        markdown: '_True_, if the user is allowed to edit their own tag',
+      },
+      required: false,
+    },
     {
       name: 'can_change_info',
       type: {
@@ -15276,7 +15370,7 @@ const InlineQueryResultDocument = t({
         name: 'InlineKeyboardMarkup',
       },
       description: {
-        markdown: 'Inline keyboard attached to the message',
+        markdown: '[Inline keyboard](https://core.telegram.org/bots/features#inline-keyboards) attached to the message',
       },
       required: false,
     },