[api] Support version 5.7 (#189)

### Bot API 5.7

- Added support for [Video Stickers](https://telegram.org/blog/video-stickers-better-reactions).
- Added the field is_video to the classes [Sticker](https://core.telegram.org/bots/api#sticker) and [StickerSet](https://core.telegram.org/bots/api#stickerset).
- Added the parameter webm_sticker to the methods [createNewStickerSet](https://core.telegram.org/bots/api#createnewstickerset) and [addStickerToSet](https://core.telegram.org/bots/api#addstickertoset).

https://core.telegram.org/bots/api#january-31-2022

Author: ex0ns

.github/workflows/build.yml

@@ -22,7 +22,7 @@ jobs:
         arguments: "-c .scalafmt.conf --test core akka examples"
     - uses: jodersky/setup-mill@v0.2.3
       with:
-        mill-version: 0.10.0
+        mill-version: 0.10.2
     - name: Compile
       run: mill '_._[_].compile'
     - name: Test

.github/workflows/publish_snapshot.yaml

@@ -15,7 +15,7 @@ jobs:
       uses: actions/checkout@v2
     - uses: jodersky/setup-mill@v0.2.3
       with:
-        mill-version: 0.10.0
+        mill-version: 0.10.2
     - name: Import GPG key
       id: import_gpg
       uses: crazy-max/ghaction-import-gpg@v3

.github/workflows/release.yml

@@ -11,7 +11,7 @@ jobs:
       uses: actions/checkout@v2
     - uses: jodersky/setup-mill@v0.2.3
       with:
-        mill-version: 0.10.0
+        mill-version: 0.10.2
     - name: Import GPG key
       id: import_gpg
       uses: crazy-max/ghaction-import-gpg@v3

.mill-version

@@ -1 +1 @@
-0.10.0
+0.10.2

README.md

@@ -69,16 +69,16 @@ Table of contents
 Add to your `build.sbt` file:
 ```scala
 // Core with minimal dependencies, enough to spawn your first bot.
-libraryDependencies += "com.bot4s" %% "telegram-core" % "5.3.0"
+libraryDependencies += "com.bot4s" %% "telegram-core" % "5.4.0"
 
 // Extra goodies: Webhooks, support for games, bindings for actors.
-libraryDependencies += "com.bot4s" %% "telegram-akka" % "5.3.0"
+libraryDependencies += "com.bot4s" %% "telegram-akka" % "5.4.0"
 ```
 
 For [mill](https://www.lihaoyi.com/mill/) add to your `build.sc` project deps:
 ```scala
-ivy"com.bot4s::telegram-core:5.3.0", // core
-ivy"com.bot4s::telegram-akka:5.3.0"  // extra goodies
+ivy"com.bot4s::telegram-core:5.4.0", // core
+ivy"com.bot4s::telegram-akka:5.4.0"  // extra goodies
 ```
 
 ## Leaking bot tokens

build.sc

@@ -2,7 +2,7 @@ import mill._
 import mill.scalalib._
 import mill.scalalib.publish._
 
-val ScalaVersions = Seq("2.12.15", "2.13.7")
+val ScalaVersions = Seq("2.12.15", "2.13.8")
 
 object library {
 
@@ -111,7 +111,7 @@ abstract class Bot4sTelegramCrossPlatform(val platformSegment: String, location:
 
 trait Publishable extends PublishModule {
 
-  override def publishVersion = "5.3.0"
+  override def publishVersion = "5.4.0"
 
   def pomSettings = PomSettings(
     description = "Telegram Bot API wrapper for Scala",

core/src/com/bot4s/telegram/methods/AddStickerToSet.scala

@@ -10,15 +10,35 @@ import com.bot4s.telegram.models.InputFile
  * @param userId        Long User identifier of sticker set owner
  * @param name          String	Sticker set name
  * @param pngSticker    InputFile or String Png image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More info on Sending Files »
+ * @param tgsSticker    InputFile Optional TGS animation with the sticker, uploaded using multipart/form-data. See
+ *                      [[https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements]]
+ * @param webmSticker   InputFile Optional WEBM video with the sticker, uploaded using multipart/form-data see
+ *                      [[https://core.telegram.org/stickers#video-sticker-requirements for technical requirements]]
+ * @param webmSticker   InputFile or String Png image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px. Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data. More info on Sending Files »
  * @param emojis        String One or more emoji corresponding to the sticker
  * @param maskPosition  MaskPosition Optional Position where the mask should be placed on faces
  */
 case class AddStickerToSet(
   userId: Long,
   name: String,
-  pngSticker: InputFile,
+  pngSticker: Option[InputFile],
+  tgsSticker: Option[InputFile],
+  webmSticker: Option[InputFile],
   emojis: String,
   maskPosition: Option[MaskPosition] = None
 ) extends MultipartRequest[Boolean] {
-  override def getFiles: List[(String, InputFile)] = List("pngSticker" -> pngSticker)
+
+  require(
+    Seq[Option[_]](
+      pngSticker,
+      tgsSticker,
+      webmSticker
+    ).count(_.isDefined) == 1,
+    "You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker"
+  )
+  override def getFiles: List[(String, InputFile)] = List(
+    "png_sticker"  -> pngSticker,
+    "tgs_sticker"  -> tgsSticker,
+    "webm_sticker" -> webmSticker
+  ).collect { case (key, Some(value)) => (key, value) }
 }

core/src/com/bot4s/telegram/methods/CreateNewStickerSet.scala

@@ -11,24 +11,42 @@ import com.bot4s.telegram.models.InputFile
  * @param userId         Long User identifier of created sticker set owner
  * @param name           String Short name of sticker set, to be used in t.me/addstickers/ URLs (e.g., animals). Can contain only english letters, digits and underscores. Must begin with a letter, can't contain consecutive underscores and must end in “_by_<bot username>”. <bot_username> is case insensitive. 1-64 characters.
  * @param title          String Sticker set title, 1-64 characters
- * @param pngSticker     InputFile or String	Png image with the sticker, must be up to 512 kilobytes in size,
- *                       dimensions must not exceed 512px, and either width or height must be exactly 512px.
- *                       Pass a file_id as a String to send a file that already exists on the Telegram servers,
- *                       pass an HTTP URL as a String for Telegram to get a file from the Internet,
- *                       or upload a new one using multipart/form-data.
+ * @param pngSticker     InputFile or String	Optional
+ *                       image with the sticker, must be up to 512 kilobytes in size, dimensions must not exceed 512px, and either width or height must be exactly 512px.
+ *                       Pass a file_id as a String to send a file that already exists on the Telegram servers, pass an HTTP URL as a String for Telegram to get a file from the Internet, or upload a new one using multipart/form-data.
  *                       [[https://core.telegram.org/bots/api#sending-files More info on Sending Files]]
- * @param emojis	        String One or more emoji corresponding to the sticker
+ * @param tgsSticker     InputFile Optional TGS animation with the sticker, uploaded using multipart/form-data. See
+ *                       [[https://core.telegram.org/stickers#animated-sticker-requirements for technical requirements]]
+ * @param webmSticker    InputFile Optional WEBM video with the sticker, uploaded using multipart/form-data see
+ *                       [[https://core.telegram.org/stickers#video-sticker-requirements for technical requirements]]
+ * @param emojis	       String One or more emoji corresponding to the sticker
  * @param containsMasks  Boolean Optional Pass True, if a set of mask stickers should be created
  * @param maskPosition   MaskPosition Optional Position where the mask should be placed on faces
  */
 case class CreateNewStickerSet(
   userId: Long,
   name: String,
   title: String,
-  pngSticker: InputFile,
+  pngSticker: Option[InputFile],
+  tgsSticker: Option[InputFile],
+  webmSticker: Option[InputFile],
   emojis: String,
   containsMasks: Option[Boolean] = None,
   maskPosition: Option[MaskPosition] = None
 ) extends MultipartRequest[Boolean] {
-  override def getFiles: List[(String, InputFile)] = List("png_sticker" -> pngSticker)
+
+  require(
+    Seq[Option[_]](
+      pngSticker,
+      tgsSticker,
+      webmSticker
+    ).count(_.isDefined) == 1,
+    "You must use exactly one of the fields png_sticker, tgs_sticker, or webm_sticker"
+  )
+
+  override def getFiles: List[(String, InputFile)] = List(
+    "png_sticker"  -> pngSticker,
+    "tgs_sticker"  -> tgsSticker,
+    "webm_sticker" -> webmSticker
+  ).collect { case (key, Some(value)) => (key, value) }
 }

core/src/com/bot4s/telegram/models/Sticker.scala

@@ -8,6 +8,7 @@ package com.bot4s.telegram.models
  * @param width         Sticker width
  * @param height        Sticker height
  * @param isAnimated    Boolean True, if the sticker is animated
+ * @param isVideo       Boolean True, if the sticker is a video sticker
  * @param thumb         Optional Sticker thumbnail in .webp or .jpg format
  * @param emoji         Optional. Emoji associated with the sticker
  * @param setName       String Optional. Name of the sticker set to which the sticker belongs
@@ -21,6 +22,7 @@ case class Sticker(
   width: Int,
   height: Int,
   isAnimated: Boolean,
+  isVideo: Boolean,
   thumb: Option[PhotoSize] = None,
   emoji: Option[String] = None,
   setName: Option[String] = None,

core/src/com/bot4s/telegram/models/StickerSet.scala

@@ -6,13 +6,15 @@ package com.bot4s.telegram.models
  * @param name           String Sticker set name
  * @param title          String Sticker set title
  * @param isAnimated     Boolean True, if the sticker set contains animated stickers
+ * @param isVideo        Boolean True, if the sticker set contains video stickers
  * @param containsMasks  Boolean True, if the sticker set contains masks
  * @param stickers       Array of Sticker List of all set stickers
  */
 case class StickerSet(
   name: String,
   title: String,
   isAnimated: Boolean,
+  isVideo: Boolean,
   containsMasks: Boolean,
   stickers: Array[Sticker]
 )