feat(Message): create Message#getCommand method

pom.xml

@@ -7,7 +7,7 @@
     <groupId>org.telegram</groupId>
     <artifactId>Bots</artifactId>
     <packaging>pom</packaging>
-    <version>9.4.0</version>
+    <version>9.5.0</version>
 
     <modules>
         <module>telegrambots-meta</module>

telegrambots-abilities/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.telegram</groupId>
         <artifactId>Bots</artifactId>
-        <version>9.4.0</version>
+        <version>9.5.0</version>
     </parent>
 
     <artifactId>telegrambots-abilities</artifactId>
@@ -93,12 +93,12 @@
         <dependency>
             <groupId>org.telegram</groupId>
             <artifactId>telegrambots-webhook</artifactId>
-            <version>9.4.0</version>
+            <version>9.5.0</version>
         </dependency>
         <dependency>
             <groupId>org.telegram</groupId>
             <artifactId>telegrambots-longpolling</artifactId>
-            <version>9.4.0</version>
+            <version>9.5.0</version>
         </dependency>
 
         <dependency>

telegrambots-client-jetty-adapter/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.telegram</groupId>
         <artifactId>Bots</artifactId>
-        <version>9.4.0</version>
+        <version>9.5.0</version>
     </parent>
 
     <name>Telegram Bots Client Jetty HttpClient adapter</name>

telegrambots-client/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.telegram</groupId>
         <artifactId>Bots</artifactId>
-        <version>9.4.0</version>
+        <version>9.5.0</version>
     </parent>
 
     <name>Telegram Bots Client</name>

telegrambots-extensions/README.md

@@ -16,12 +16,12 @@ Just import add the library to your project with one of these options:
     <dependency>
         <groupId>org.telegram</groupId>
         <artifactId>telegrambots-extensions</artifactId>
-        <version>9.4.0</version>
+        <version>9.5.0</version>
     </dependency>
 ```
 
    2. Using Gradle:
 
 ```gradle
-    implementation 'org.telegram:telegrambots-extensions:9.4.0'
+    implementation 'org.telegram:telegrambots-extensions:9.5.0'
 ```

telegrambots-extensions/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.telegram</groupId>
         <artifactId>Bots</artifactId>
-        <version>9.4.0</version>
+        <version>9.5.0</version>
     </parent>
 
     <artifactId>telegrambots-extensions</artifactId>
@@ -78,12 +78,12 @@
         <dependency>
             <groupId>org.telegram</groupId>
             <artifactId>telegrambots-webhook</artifactId>
-            <version>9.4.0</version>
+            <version>9.5.0</version>
         </dependency>
         <dependency>
             <groupId>org.telegram</groupId>
             <artifactId>telegrambots-longpolling</artifactId>
-            <version>9.4.0</version>
+            <version>9.5.0</version>
         </dependency>
 
         <dependency>

telegrambots-longpolling/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>org.telegram</groupId>
         <artifactId>Bots</artifactId>
-        <version>9.4.0</version>
+        <version>9.5.0</version>
     </parent>
 
     <artifactId>telegrambots-longpolling</artifactId>

telegrambots-meta/pom.xml

@@ -7,7 +7,7 @@
     <parent>
         <groupId>org.telegram</groupId>
         <artifactId>Bots</artifactId>
-        <version>9.4.0</version>
+        <version>9.5.0</version>
     </parent>
 
     <artifactId>telegrambots-meta</artifactId>

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/methods/groupadministration/PromoteChatMember.java

@@ -56,6 +56,7 @@ public class PromoteChatMember extends BotApiMethodBoolean {
     private static final String CAN_EDIT_STORIES_FIELD = "can_edit_stories";
     private static final String CAN_DELETE_STORIES_FIELD = "can_delete_stories";
     private static final String CAN_MANAGE_DIRECT_MESSAGES_FIELD = "can_manage_direct_messages";
+    private static final String CAN_MANAGE_TAGS_FIELD = "can_manage_tags";
 
     @JsonProperty(CHATID_FIELD)
     @NonNull
@@ -138,6 +139,12 @@ public class PromoteChatMember extends BotApiMethodBoolean {
      */
     @JsonProperty(CAN_MANAGE_DIRECT_MESSAGES_FIELD)
     private Boolean canManageDirectMessages;
+    /**
+     * Optional
+     * Pass True if the administrator can edit the tags of regular members; for groups and supergroups only
+     */
+    @JsonProperty(CAN_MANAGE_TAGS_FIELD)
+    private Boolean canManageTags;
 
     @Tolerate
     public void setChatId(@NonNull Long chatId) {

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/methods/groupadministration/SetChatMemberTag.java

@@ -0,0 +1,74 @@
+package org.telegram.telegrambots.meta.api.methods.groupadministration;
+
+import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.EqualsAndHashCode;
+import lombok.Getter;
+import lombok.NonNull;
+import lombok.RequiredArgsConstructor;
+import lombok.Setter;
+import lombok.ToString;
+import lombok.experimental.SuperBuilder;
+import lombok.experimental.Tolerate;
+import lombok.extern.jackson.Jacksonized;
+import org.telegram.telegrambots.meta.api.methods.botapimethods.BotApiMethodBoolean;
+import org.telegram.telegrambots.meta.exceptions.TelegramApiValidationException;
+import org.telegram.telegrambots.meta.util.Validations;
+
+/**
+ * @author Ruben Bermudez
+ * @version 9.5
+ * 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.
+ */
+@EqualsAndHashCode(callSuper = false)
+@Getter
+@Setter
+@ToString
+@RequiredArgsConstructor
+@SuperBuilder
+@Jacksonized
+@JsonIgnoreProperties(ignoreUnknown = true)
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class SetChatMemberTag extends BotApiMethodBoolean {
+    public static final String PATH = "setChatMemberTag";
+
+    private static final String CHATID_FIELD = "chat_id";
+    private static final String USERID_FIELD = "user_id";
+    private static final String TAG_FIELD = "tag";
+
+    @JsonProperty(CHATID_FIELD)
+    @NonNull
+    private String chatId; ///< Unique identifier for the target chat or username of the target supergroup (in the format @supergroupusername)
+    @JsonProperty(USERID_FIELD)
+    @NonNull
+    private Long userId; ///< Unique identifier of the target user
+    @JsonProperty(TAG_FIELD)
+    private String tag; ///< Optional. New tag for the member; 0-16 characters, emoji are not allowed
+
+    @Tolerate
+    public void setChatId(@NonNull Long chatId) {
+        this.chatId = chatId.toString();
+    }
+
+    @Override
+    public String getMethod() {
+        return PATH;
+    }
+
+    @Override
+    public void validate() throws TelegramApiValidationException {
+        Validations.requiredChatId(chatId, this);
+        Validations.requiredUserId(userId, this);
+    }
+
+    public static abstract class SetChatMemberTagBuilder<C extends SetChatMemberTag, B extends SetChatMemberTagBuilder<C, B>> extends BotApiMethodBooleanBuilder<C, B> {
+        @Tolerate
+        public SetChatMemberTagBuilder<C, B> chatId(@NonNull Long chatId) {
+            this.chatId = chatId.toString();
+            return this;
+        }
+    }
+}

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/methods/send/SendMessageDraft.java

@@ -20,9 +20,9 @@
 
 /**
  * @author Ruben Bermudez
- * @version 9.3
- * 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.
+ * @version 9.5
+ * Use this method to stream a partial message to a user while the message is being generated.
+ * Returns True on success.
  */
 @SuppressWarnings("unused")
 @EqualsAndHashCode(callSuper = false)

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/objects/ChatPermissions.java

@@ -45,6 +45,7 @@ public class ChatPermissions implements BotApiObject {
     private static final String CAN_INVITE_USERS_FIELD = "can_invite_users";
     private static final String CAN_PIN_MESSAGES_FIELD = "can_pin_messages";
     private static final String CANMANAGETOPICS_FIELD = "can_manage_topics";
+    private static final String CANEDITTAG_FIELD = "can_edit_tag";
 
     private static final String CAN_SEND_MEDIA_MESSAGES_FIELD = "can_send_media_messages";
 
@@ -126,4 +127,10 @@ public class ChatPermissions implements BotApiObject {
      */
     @JsonProperty(CANMANAGETOPICS_FIELD)
     private Boolean canManageTopics;
+    /**
+     * Optional.
+     * True, if the user is allowed to edit their own tag
+     */
+    @JsonProperty(CANEDITTAG_FIELD)
+    private Boolean canEditTag;
 }

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/objects/MessageEntity.java

@@ -40,6 +40,8 @@ public class MessageEntity implements BotApiObject {
     private static final String USER_FIELD = "user";
     private static final String LANGUAGE_FIELD = "language";
     private static final String CUSTOMEMOJI_FIELD = "custom_emoji_id";
+    private static final String UNIX_TIME_FIELD = "unix_time";
+    private static final String DATE_TIME_FORMAT_FIELD = "date_time_format";
     /**
      * Type of the entity.
      * Currently, can be
@@ -58,10 +60,11 @@ public class MessageEntity implements BotApiObject {
      * - “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),
-     * - “custom_emoji” (for inline custom emoji stickers)
+     * - "pre" (monowidth block),
+     * - "text_link" (for clickable text URLs),
+     * - "text_mention" (for users without usernames),
+     * - "custom_emoji" (for inline custom emoji stickers),
+     * - "date_time" (for formatted date and time)
      */
     @JsonProperty(TYPE_FIELD)
     @NonNull
@@ -98,11 +101,24 @@ public class MessageEntity implements BotApiObject {
     private String language;
     /**
      * Optional.
-     * For “custom_emoji” only, unique identifier of the custom emoji.
+     * For "custom_emoji" only, unique identifier of the custom emoji.
      * Use getCustomEmojiStickers to get full information about the sticker
      */
     @JsonProperty(CUSTOMEMOJI_FIELD)
     private String customEmojiId;
+    /**
+     * Optional.
+     * For "date_time" only, the Unix time associated with the entity
+     */
+    @JsonProperty(UNIX_TIME_FIELD)
+    private Integer unixTime;
+    /**
+     * Optional.
+     * For "date_time" only, the string that defines the formatting of the date and time.
+     * See date-time entity formatting for more details.
+     */
+    @JsonProperty(DATE_TIME_FORMAT_FIELD)
+    private String dateTimeFormat;
     /**
      * Text present in the entity. Computed from offset and length
      */

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/objects/adminrights/ChatAdministratorRights.java

@@ -46,6 +46,7 @@ public class ChatAdministratorRights implements BotApiObject, Validable {
     private static final String CAN_EDIT_STORIES_FIELD = "can_edit_stories";
     private static final String CAN_DELETE_STORIES_FIELD = "can_delete_stories";
     private static final String CAN_MANAGE_DIRECT_MESSAGES_FIELD = "can_manage_direct_messages";
+    private static final String CAN_MANAGE_TAGS_FIELD = "can_manage_tags";
 
     /**
      * True, if the user's presence in the chat is hidden
@@ -150,4 +151,11 @@ public class ChatAdministratorRights implements BotApiObject, Validable {
      */
     @JsonProperty(CAN_MANAGE_DIRECT_MESSAGES_FIELD)
     private Boolean canManageDirectMessages;
+    /**
+     * Optional.
+     * 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.
+     */
+    @JsonProperty(CAN_MANAGE_TAGS_FIELD)
+    private Boolean canManageTags;
 }

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/objects/chatmember/ChatMemberAdministrator.java

@@ -50,6 +50,7 @@ public class ChatMemberAdministrator implements ChatMember {
     private static final String CAN_EDIT_STORIES_FIELD = "can_edit_stories";
     private static final String CAN_DELETE_STORIES_FIELD = "can_delete_stories";
     private static final String CAN_MANAGE_DIRECT_MESSAGES_FIELD = "can_manage_direct_messages";
+    private static final String CAN_MANAGE_TAGS_FIELD = "can_manage_tags";
 
     /**
      * The member's status in the chat, always “administrator”
@@ -163,4 +164,11 @@ public class ChatMemberAdministrator implements ChatMember {
      */
     @JsonProperty(CAN_MANAGE_DIRECT_MESSAGES_FIELD)
     private Boolean canManageDirectMessages;
+    /**
+     * Optional.
+     * 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.
+     */
+    @JsonProperty(CAN_MANAGE_TAGS_FIELD)
+    private Boolean canManageTags;
 }

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/objects/chatmember/ChatMemberMember.java

@@ -38,6 +38,7 @@ public class ChatMemberMember implements ChatMember {
     private static final String STATUS_FIELD = "status";
     private static final String USER_FIELD = "user";
     private static final String UNTIL_DATE_FIELD = "until_date";
+    private static final String TAG_FIELD = "tag";
 
     /**
      * The member's status in the chat, always “member”
@@ -56,4 +57,10 @@ public class ChatMemberMember implements ChatMember {
      */
     @JsonProperty(UNTIL_DATE_FIELD)
     private Integer untilDate;
+    /**
+     * Optional.
+     * Tag of the member
+     */
+    @JsonProperty(TAG_FIELD)
+    private String tag;
 }

telegrambots-meta/src/main/java/org/telegram/telegrambots/meta/api/objects/chatmember/ChatMemberRestricted.java

@@ -48,6 +48,8 @@ public class ChatMemberRestricted implements ChatMember {
     private static final String CANPINMESSAGES_FIELD = "can_pin_messages";
     private static final String CANMANAGETOPICS_FIELD = "can_manage_topics";
     private static final String UNTILDATE_FIELD = "until_date";
+    private static final String TAG_FIELD = "tag";
+    private static final String CANEDITTAG_FIELD = "can_edit_tag";
 
     private static final String CANSENDMEDIAMESSAGES_FIELD = "can_send_media_messages";
 
@@ -141,4 +143,15 @@ public class ChatMemberRestricted implements ChatMember {
      */
     @JsonProperty(UNTILDATE_FIELD)
     private Integer untilDate;
+    /**
+     * Optional.
+     * Tag of the member
+     */
+    @JsonProperty(TAG_FIELD)
+    private String tag;
+    /**
+     * True, if the user is allowed to edit their own tag
+     */
+    @JsonProperty(CANEDITTAG_FIELD)
+    private Boolean canEditTag;
 }