max_api_client 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9fde75c48daf67e3c6daac640e467b02b31601c5abef3e92ed3fd14f83509d28
-  data.tar.gz: 53f4dd194924f9853a98fcc60789bd7678320bedb73d7a0dbe35bd2bb1196817
+  metadata.gz: 7d6578ded53eb4717c32d40728c217f163db0e8149bc813b084c6920692201dd
+  data.tar.gz: 338a01c773c1be6502cd37161bf1b11011a08717fd006055db99e9ff7466716c
 SHA512:
-  metadata.gz: 0bd30a89346e414d46dace23dfe18745a7e54ecec52024a3f48d7ba12e97b8e5df09eca5cad6be05e4ac0488c99b679f1671d85d132d09c7e9eb0b10197729cd
-  data.tar.gz: b9bedc2313023176b3b92e21c34c97e1d012f13afb1c8dfaa322c4e8c9125f61be75c33476b84e0dcd3ea6cf80a9c5ce197c6b809ff1a5d1d218df858f2af1e9
+  metadata.gz: a656768c33a27bf0c4d6a61b8eb8c6ef807b2177472c19c99c70ed29ec4f4d9a4ee9dfaec2a8db4d330582040d79b8500d511bcb3dd8e55fd178f98058f8fb09
+  data.tar.gz: 99f540522f43226232847ee792d1950643c7ff56464b693813b60d7a3da6cd07fa155c62978c95630cf8f7da78385ffbe5c6eb48b79392b5ca7e395362901751

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 ## [Unreleased]
 
+## [0.2.0] - 2026-10-03
+
+Synced with Max Bot API schema 0.0.33.
+
+- Added `edit_my_commands` (`PATCH /me/commands`); `set_my_commands` and `delete_my_commands` now use it instead of `PATCH /me`.
+- Added `add_chat_admins` and `remove_chat_admin`.
+- Added comment methods: `get_comments`, `get_comment`, `send_comment`, `edit_comment`, `delete_comment` (`api.raw.comments`).
+- Added `get_video_info` (`GET /videos/{videoToken}`).
+- Added `ContactAttachment`, `InlineKeyboardAttachment` and `Button` builders; attachment objects now serialize to JSON without an explicit `to_h`.
+- Added `limit` to `poll_updates`; an empty `types` list is no longer sent.
+- Fixed `remove_chat_member`: `user_id` and `block` are sent as query parameters, as the schema requires.
+- Fixed `get_message`, which raised `ArgumentError`.
+- Fixed `answer_on_callback`: `disable_link_preview` is sent as a query parameter.
+- `false` query values are now sent as `false` instead of being dropped.
+- Sending a message is retried at most 3 times on `attachment.not.ready`, with exponential backoff.
+- `delete_message` no longer accepts extra options (they raised `ArgumentError`).
+- Deprecated `edit_my_info`, `get_all_chats`, `get_chat_by_link` and `add_chat_members`: their endpoints are removed from the API or absent from the schema.
+
 ## [0.1.3] - 2026-07-16
 
 - Switched the default API endpoint to `https://platform-api2.max.ru`.

data/README.md

@@ -104,12 +104,15 @@ api = MaxApiClient::Api.new(
 Методы доступные через `MaxApiClient::Api`, порт официального клиента <https://github.com/max-messenger/max-bot-api-client-ts>, названия сохранены, poller собственный:
 
 - `get_my_info`
-- `edit_my_info(**extra)`
+- `edit_my_commands(commands)`
 - `set_my_commands(commands)`
 - `delete_my_commands`
 
-`set_my_commands(commands)` это короткий хелпер над `edit_my_info(commands: ...)`.
-Он принимает массив команд и отправляет его в поле `commands` профиля бота.
+Клиент соответствует схеме Bot API MAX версии 0.0.33
+(<https://github.com/max-messenger/api-schema>).
+
+`set_my_commands(commands)` это синоним `edit_my_commands(commands)`.
+Он принимает массив команд и отправляет его в поле `commands`.
 
 Ожидается массив хэшей с данными команды, например:
 
@@ -125,27 +128,28 @@ api.set_my_commands([
 Соответствующие HTTP-маршруты:
 
 - `GET /me`
-- `PATCH /me`
+- `PATCH /me/commands`
 
 Типовые сценарии:
 
 - получить текущий профиль бота;
-- обновить имя, описание, аватар и команды бота;
 - опубликовать или очистить подсказки команд для пользователей.
 
+Устаревший метод `edit_my_info(**extra)` (`PATCH /me`) оставлен для совместимости
+и выводит предупреждение: этого маршрута нет в актуальной схеме API.
+
 ### Методы чатов
 
 Методы Ruby, доступные через `MaxApiClient::Api`:
 
-- `get_all_chats(**extra)`
 - `get_chat(chat_id)`
-- `get_chat_by_link(chat_link)`
 - `edit_chat_info(chat_id, **extra)`
 - `get_chat_membership(chat_id)`
 - `get_chat_admins(chat_id)`
-- `add_chat_members(chat_id, user_ids)`
+- `add_chat_admins(chat_id, admins)`
+- `remove_chat_admin(chat_id, user_id)`
 - `get_chat_members(chat_id, **extra)`
-- `remove_chat_member(chat_id, user_id)`
+- `remove_chat_member(chat_id, user_id, block: nil)`
 - `get_pinned_message(chat_id)`
 - `pin_message(chat_id, message_id, **extra)`
 - `unpin_message(chat_id)`
@@ -154,13 +158,12 @@ api.set_my_commands([
 
 Соответствующие HTTP-маршруты:
 
-- `GET /chats`
 - `GET /chats/{chat_id}`
-- `GET /chats/{chat_link}`
 - `PATCH /chats/{chat_id}`
 - `GET /chats/{chat_id}/members/me`
 - `GET /chats/{chat_id}/members/admins`
-- `POST /chats/{chat_id}/members`
+- `POST /chats/{chat_id}/members/admins`
+- `DELETE /chats/{chat_id}/members/admins/{user_id}`
 - `GET /chats/{chat_id}/members`
 - `DELETE /chats/{chat_id}/members`
 - `GET /chats/{chat_id}/pin`
@@ -171,14 +174,29 @@ api.set_my_commands([
 
 Типовые сценарии:
 
-- получить список чатов, доступных боту;
-- найти чат по идентификатору или публичной ссылке;
+- получить чат по идентификатору;
 - изменить заголовок, иконку и метаданные чата;
 - управлять участниками и администраторами;
 - читать, устанавливать и снимать закреплённые сообщения;
 - отправлять статус набора текста и другие действия отправителя;
 - выходить из чата.
 
+Пример назначения администратора:
+
+```ruby
+api.add_chat_admins(chat_id, [
+  { user_id: 42, permissions: %w[write pin_message] }
+])
+```
+
+Устаревшие методы оставлены для совместимости и выводят предупреждение:
+
+- `get_all_chats(**extra)` — `GET /chats` не поддерживается с июня 2026;
+  список чатов нужно вести самостоятельно по событиям `bot_added` и `bot_started`;
+- `get_chat_by_link(chat_link)` — поиска по ссылке нет в актуальной схеме;
+- `add_chat_members(chat_id, user_ids)` — `POST /chats/{chat_id}/members`
+  удалён из API 30 сентября 2026.
+
 ### Методы сообщений
 
 Методы Ruby, доступные через `MaxApiClient::Api`:
@@ -188,7 +206,8 @@ api.set_my_commands([
 - `get_messages(chat_id, **extra)`
 - `get_message(message_id)`
 - `edit_message(message_id, **extra)`
-- `delete_message(message_id, **extra)`
+- `delete_message(message_id)`
+- `get_video_info(video_token)`
 - `answer_on_callback(callback_id, **extra)`
 
 Соответствующие HTTP-маршруты:
@@ -198,6 +217,7 @@ api.set_my_commands([
 - `GET /messages/{message_id}`
 - `PUT /messages`
 - `DELETE /messages`
+- `GET /videos/{video_token}`
 - `POST /answers`
 
 Поддерживаемые возможности:
@@ -206,7 +226,25 @@ api.set_my_commands([
 - дополнительный payload для форматирования, reply-ссылок и вложений;
 - редактирование и удаление сообщений;
 - ответы на callback-кнопки;
-- автоматический повтор запроса, если вложение после загрузки ещё не готово.
+- автоматический повтор запроса (до 3 попыток), если вложение после загрузки ещё не готово.
+
+### Методы комментариев
+
+Методы Ruby, доступные через `MaxApiClient::Api`:
+
+- `get_comments(message_id, **extra)`
+- `get_comment(message_id, comment_id)`
+- `send_comment(message_id, text, **extra)`
+- `edit_comment(message_id, comment_id, **extra)`
+- `delete_comment(message_id, comment_id)`
+
+Соответствующие HTTP-маршруты:
+
+- `GET /messages/{message_id}/comments`
+- `GET /messages/{message_id}/comments/{comment_id}`
+- `POST /messages/{message_id}/comments`
+- `PUT /messages/{message_id}/comments`
+- `DELETE /messages/{message_id}/comments`
 
 ### Методы подписок
 
@@ -215,7 +253,7 @@ api.set_my_commands([
 - `get_subscriptions`
 - `subscribe(url, update_types: nil, secret: nil)`
 - `unsubscribe(url)`
-- `poll_updates(types = [], marker: nil, timeout: 20, retry_interval: 5, read_timeout: nil, &block)`
+- `poll_updates(types = [], marker: nil, limit: nil, timeout: 20, retry_interval: 5, read_timeout: nil, &block)`
 
 Соответствующие HTTP-маршруты:
 
@@ -270,6 +308,25 @@ end
 - `StickerAttachment`
 - `LocationAttachment`
 - `ShareAttachment`
+- `ContactAttachment`
+- `InlineKeyboardAttachment`
+
+Объекты вложений можно передавать в `attachments:` напрямую. Кнопки клавиатуры
+собираются через `MaxApiClient::Button`:
+
+```ruby
+keyboard = MaxApiClient::InlineKeyboardAttachment.new(
+  buttons: [[
+    MaxApiClient::Button.callback("Да", "yes"),
+    MaxApiClient::Button.link("Сайт", "https://max.ru")
+  ]]
+)
+
+api.send_message_to_chat(chat_id, "Выберите", attachments: [keyboard])
+```
+
+Доступные кнопки: `callback`, `link`, `message`, `request_contact`,
+`request_geo_location`, `open_app`, `clipboard`.
 
 ### Доступ к Raw API
 
@@ -338,6 +395,7 @@ bin/console
 ## Источники
 
 - Официальная документация Max Bot API: <https://dev.max.ru/>
+- OpenAPI-схема Max Bot API: <https://github.com/max-messenger/api-schema>
 - TypeScript reference client: <https://github.com/max-messenger/max-bot-api-client-ts>
 
 ## Лицензия

data/lib/max_api_client/api.rb

@@ -2,6 +2,7 @@
 
 module MaxApiClient
   # High-level convenience wrapper over grouped Max Bot API endpoints.
+  # rubocop:disable Metrics/ClassLength
   class Api
     attr_reader :raw, :upload, :client
 
@@ -30,20 +31,26 @@ module MaxApiClient
     # rubocop:enable Naming/AccessorMethodName
 
     def edit_my_info(**extra)
+      warn_deprecated(:edit_my_info, "PATCH /me is absent from the current API schema, use edit_my_commands")
       raw.bots.edit_my_info(**extra)
     end
 
+    def edit_my_commands(commands)
+      raw.bots.edit_my_commands(commands:)
+    end
+
     # rubocop:disable Naming/AccessorMethodName
     def set_my_commands(commands)
-      edit_my_info(commands:)
+      edit_my_commands(commands)
     end
     # rubocop:enable Naming/AccessorMethodName
 
     def delete_my_commands
-      edit_my_info(commands: [])
+      edit_my_commands([])
     end
 
     def get_all_chats(**extra)
+      warn_deprecated(:get_all_chats, "GET /chats is not supported by the API since June 2026")
       raw.chats.get_all(**extra)
     end
 
@@ -52,6 +59,7 @@ module MaxApiClient
     end
 
     def get_chat_by_link(chat_link)
+      warn_deprecated(:get_chat_by_link, "lookup by link is absent from the current API schema")
       raw.chats.get_by_link(chat_link:)
     end
 
@@ -67,7 +75,16 @@ module MaxApiClient
       raw.chats.get_chat_admins(chat_id:)
     end
 
+    def add_chat_admins(chat_id, admins)
+      raw.chats.add_chat_admins(chat_id:, admins:)
+    end
+
+    def remove_chat_admin(chat_id, user_id)
+      raw.chats.remove_chat_admin(chat_id:, user_id:)
+    end
+
     def add_chat_members(chat_id, user_ids)
+      warn_deprecated(:add_chat_members, "POST /chats/{chat_id}/members was removed from the API on 2026-09-30")
       raw.chats.add_chat_members(chat_id:, user_ids:)
     end
 
@@ -119,14 +136,38 @@ module MaxApiClient
       raw.messages.edit(message_id:, **extra)
     end
 
-    def delete_message(message_id, **extra)
-      raw.messages.delete(message_id:, **extra)
+    def delete_message(message_id)
+      raw.messages.delete(message_id:)
+    end
+
+    def get_video_info(video_token)
+      raw.messages.get_video_info(video_token:)
     end
 
     def answer_on_callback(callback_id, **extra)
       raw.messages.answer_on_callback(callback_id:, **extra)
     end
 
+    def get_comments(message_id, **extra)
+      raw.comments.get(message_id:, **csv_query(extra, :comment_ids))
+    end
+
+    def get_comment(message_id, comment_id)
+      raw.comments.get_by_id(message_id:, comment_id:)
+    end
+
+    def send_comment(message_id, text, **extra)
+      message_from(raw.comments.send(message_id:, text:, **extra))
+    end
+
+    def edit_comment(message_id, comment_id, **extra)
+      raw.comments.edit(message_id:, comment_id:, **extra)
+    end
+
+    def delete_comment(message_id, comment_id)
+      raw.comments.delete(message_id:, comment_id:)
+    end
+
     # rubocop:disable Naming/AccessorMethodName
     def get_subscriptions
       raw.subscriptions.get_subscriptions
@@ -141,12 +182,14 @@ module MaxApiClient
       raw.subscriptions.unsubscribe(url:)
     end
 
-    def poll_updates(types = [], marker: nil, timeout: Polling::DEFAULT_TIMEOUT,
+    # rubocop:disable Metrics/ParameterLists
+    def poll_updates(types = [], marker: nil, limit: nil, timeout: Polling::DEFAULT_TIMEOUT,
                      retry_interval: Polling::DEFAULT_RETRY_INTERVAL, read_timeout: nil, &block)
       poller = Polling.new(
         self,
         types:,
         marker:,
+        limit:,
         timeout:,
         retry_interval:,
         read_timeout:
@@ -156,6 +199,7 @@ module MaxApiClient
 
       poller.each(&block)
     end
+    # rubocop:enable Metrics/ParameterLists
 
     def upload_image(options)
       data = upload.image(**options)
@@ -189,8 +233,13 @@ module MaxApiClient
       query.merge(key => normalize_types(query[key]))
     end
 
+    def warn_deprecated(method_name, reason)
+      warn("[max_api_client] #{method_name} is deprecated: #{reason}", uplevel: 2)
+    end
+
     def message_from(response)
       response.fetch("message") { response.fetch(:message) }
     end
   end
+  # rubocop:enable Metrics/ClassLength
 end

data/lib/max_api_client/attachments.rb

@@ -6,6 +6,10 @@ module MaxApiClient
     def to_h
       raise NotImplementedError, "#{self.class} must implement #to_h"
     end
+
+    def to_json(*args)
+      to_h.to_json(*args)
+    end
   end
 
   # Shared attachment implementation for upload-backed media objects.
@@ -105,7 +109,71 @@ module MaxApiClient
     end
 
     def to_h
-      { type: "share", payload: { url:, token: } }
+      { type: "share", payload: { url:, token: }.compact }
+    end
+  end
+
+  # Attachment wrapper for contact cards.
+  class ContactAttachment < Attachment
+    attr_reader :name, :contact_id, :vcf_info, :vcf_phone
+
+    def initialize(name: nil, contact_id: nil, vcf_info: nil, vcf_phone: nil)
+      super()
+      @name = name
+      @contact_id = contact_id
+      @vcf_info = vcf_info
+      @vcf_phone = vcf_phone
+    end
+
+    def to_h
+      { type: "contact", payload: { name:, contact_id:, vcf_info:, vcf_phone: }.compact }
+    end
+  end
+
+  # Attachment wrapper for an inline keyboard: an array of button rows.
+  class InlineKeyboardAttachment < Attachment
+    attr_reader :buttons
+
+    def initialize(buttons:)
+      super()
+      @buttons = buttons
+    end
+
+    def to_h
+      { type: "inline_keyboard", payload: { buttons: } }
+    end
+  end
+
+  # Builders for inline keyboard buttons.
+  module Button
+    module_function
+
+    def callback(text, payload)
+      { type: "callback", text:, payload: }
+    end
+
+    def link(text, url)
+      { type: "link", text:, url: }
+    end
+
+    def message(text)
+      { type: "message", text: }
+    end
+
+    def request_contact(text)
+      { type: "request_contact", text: }
+    end
+
+    def request_geo_location(text, quick: nil)
+      { type: "request_geo_location", text:, quick: }.compact
+    end
+
+    def open_app(text, web_app, payload: nil, contact_id: nil)
+      { type: "open_app", text:, web_app:, payload:, contact_id: }.compact
+    end
+
+    def clipboard(text, payload)
+      { type: "clipboard", text:, payload: }
     end
   end
 end

data/lib/max_api_client/client.rb

@@ -86,7 +86,7 @@ module MaxApiClient
 
       params = URI.decode_www_form(String(uri.query))
       query.to_h.each do |key, value|
-        next if value.nil? || value == false
+        next if value.nil?
 
         params << [key.to_s, value.to_s]
       end

data/lib/max_api_client/polling.rb

@@ -16,11 +16,12 @@ module MaxApiClient
     ].freeze
 
     # rubocop:disable Metrics/ParameterLists
-    def initialize(api, types: [], marker: nil, timeout: DEFAULT_TIMEOUT, retry_interval: DEFAULT_RETRY_INTERVAL,
-                   read_timeout: nil)
+    def initialize(api, types: [], marker: nil, limit: nil, timeout: DEFAULT_TIMEOUT,
+                   retry_interval: DEFAULT_RETRY_INTERVAL, read_timeout: nil)
       @api = api
       @types = types
       @marker = marker
+      @limit = limit
       @timeout = timeout
       @retry_interval = retry_interval
       @read_timeout = read_timeout || (timeout.to_i + READ_TIMEOUT_PADDING)
@@ -63,12 +64,13 @@ module MaxApiClient
 
     private
 
-    attr_reader :api, :types, :marker, :timeout, :retry_interval, :read_timeout
+    attr_reader :api, :types, :marker, :limit, :timeout, :retry_interval, :read_timeout
 
     def fetch_updates
       api.raw.subscriptions.get_updates(
         types: normalize_types(types),
         marker:,
+        limit:,
         timeout:,
         read_timeout:
       )
@@ -87,9 +89,9 @@ module MaxApiClient
     end
 
     def normalize_types(value)
-      return value.join(",") if value.is_a?(Array)
+      value = value.join(",") if value.is_a?(Array)
 
-      value
+      value unless value.to_s.empty?
     end
   end
 end

data/lib/max_api_client/raw_api.rb

@@ -17,6 +17,10 @@ module MaxApiClient
       @messages ||= build_api(MessagesApi)
     end
 
+    def comments
+      @comments ||= build_api(CommentsApi)
+    end
+
     def subscriptions
       @subscriptions ||= build_api(SubscriptionsApi)
     end
@@ -40,13 +44,19 @@ module MaxApiClient
     end
     # rubocop:enable Naming/AccessorMethodName
 
+    # PATCH /me is absent from the current API schema; prefer #edit_my_commands.
     def edit_my_info(**extra)
       patch("me", body: extra)
     end
+
+    def edit_my_commands(commands:)
+      patch("me/commands", body: { commands: })
+    end
   end
 
   # Raw chat management endpoints.
   class ChatsApi < BaseApi
+    # GET /chats is no longer supported by the API since June 2026.
     def get_all(**extra)
       get("chats", query: extra)
     end
@@ -55,6 +65,7 @@ module MaxApiClient
       get("chats/{chat_id}", path_params: { chat_id: })
     end
 
+    # Lookup by public link is absent from the current API schema.
     def get_by_link(chat_link:)
       get("chats/{chat_link}", path_params: { chat_link: })
     end
@@ -71,6 +82,15 @@ module MaxApiClient
       get("chats/{chat_id}/members/admins", path_params: { chat_id: })
     end
 
+    def add_chat_admins(chat_id:, admins:)
+      post("chats/{chat_id}/members/admins", path_params: { chat_id: }, body: { admins: })
+    end
+
+    def remove_chat_admin(chat_id:, user_id:)
+      delete("chats/{chat_id}/members/admins/{user_id}", path_params: { chat_id:, user_id: })
+    end
+
+    # POST /chats/{chat_id}/members was removed from the API on 2026-09-30.
     def add_chat_members(chat_id:, user_ids:)
       post("chats/{chat_id}/members", path_params: { chat_id: }, body: { user_ids: })
     end
@@ -80,7 +100,7 @@ module MaxApiClient
     end
 
     def remove_chat_member(chat_id:, user_id:, block: nil)
-      delete("chats/{chat_id}/members", path_params: { chat_id: }, body: compact_nil(user_id:, block:))
+      delete("chats/{chat_id}/members", path_params: { chat_id: }, query: compact_nil(user_id:, block:))
     end
 
     def get_pinned_message(chat_id:)
@@ -108,22 +128,30 @@ module MaxApiClient
   class MessagesApi < BaseApi
     ATTACHMENT_NOT_READY_CODE = "attachment.not.ready"
     ATTACHMENT_NOT_READY_DELAY = 1
+    ATTACHMENT_NOT_READY_RETRIES = 3
 
     def get(**query)
       super("messages", query:)
     end
 
     def get_by_id(message_id:)
-      get("messages/{message_id}", path_params: { message_id: })
+      call_api(:get, "messages/{message_id}", path_params: { message_id: })
     end
 
     def send(chat_id: nil, user_id: nil, disable_link_preview: nil, **body)
-      post("messages", query: compact_nil(chat_id:, user_id:, disable_link_preview:), body:)
-    rescue ApiError => e
-      raise unless e.code == ATTACHMENT_NOT_READY_CODE
+      attempt = 0
+
+      begin
+        post("messages", query: compact_nil(chat_id:, user_id:, disable_link_preview:), body:)
+      rescue ApiError => e
+        raise unless e.code == ATTACHMENT_NOT_READY_CODE
 
-      sleep(ATTACHMENT_NOT_READY_DELAY)
-      send(chat_id:, user_id:, disable_link_preview:, **body)
+        attempt += 1
+        raise if attempt >= ATTACHMENT_NOT_READY_RETRIES
+
+        sleep(ATTACHMENT_NOT_READY_DELAY * (2**(attempt - 1)))
+        retry
+      end
     end
 
     def edit(message_id:, **body)
@@ -134,8 +162,36 @@ module MaxApiClient
       super("messages", query: { message_id: })
     end
 
-    def answer_on_callback(callback_id:, **body)
-      post("answers", query: { callback_id: }, body:)
+    def get_video_info(video_token:)
+      call_api(:get, "videos/{video_token}", path_params: { video_token: })
+    end
+
+    def answer_on_callback(callback_id:, disable_link_preview: nil, **body)
+      post("answers", query: compact_nil(callback_id:, disable_link_preview:), body:)
+    end
+  end
+
+  # Raw endpoints for comments under channel posts.
+  class CommentsApi < BaseApi
+    def get(message_id:, **query)
+      super("messages/{message_id}/comments", path_params: { message_id: }, query:)
+    end
+
+    def get_by_id(message_id:, comment_id:)
+      call_api(:get, "messages/{message_id}/comments/{comment_id}", path_params: { message_id:, comment_id: })
+    end
+
+    def send(message_id:, disable_link_preview: nil, **body)
+      post("messages/{message_id}/comments", path_params: { message_id: },
+                                             query: compact_nil(disable_link_preview:), body:)
+    end
+
+    def edit(message_id:, comment_id:, **body)
+      put("messages/{message_id}/comments", path_params: { message_id: }, query: { comment_id: }, body:)
+    end
+
+    def delete(message_id:, comment_id:)
+      super("messages/{message_id}/comments", path_params: { message_id: }, query: { comment_id: })
     end
   end
 

data/lib/max_api_client/version.rb

@@ -2,5 +2,5 @@
 
 # Root namespace for gem version information.
 module MaxApiClient
-  VERSION = "0.1.3"
+  VERSION = "0.2.0"
 end

data/sig/max_api_client.rbs

@@ -36,6 +36,7 @@ module MaxApiClient
     def bots: () -> BotsApi
     def chats: () -> ChatsApi
     def messages: () -> MessagesApi
+    def comments: () -> CommentsApi
     def subscriptions: () -> SubscriptionsApi
     def uploads: () -> UploadsApi
   end
@@ -43,6 +44,7 @@ module MaxApiClient
   class BotsApi
     def get_my_info: () -> untyped
     def edit_my_info: (untyped extra) -> untyped
+    def edit_my_commands: (commands: Array[bot_command]) -> untyped
   end
 
   class ChatsApi
@@ -52,6 +54,8 @@ module MaxApiClient
     def edit: (chat_id: Integer, **untyped extra) -> untyped
     def get_chat_membership: (chat_id: Integer) -> untyped
     def get_chat_admins: (chat_id: Integer) -> untyped
+    def add_chat_admins: (chat_id: Integer, admins: Array[Hash[Symbol | String, untyped]]) -> untyped
+    def remove_chat_admin: (chat_id: Integer, user_id: Integer) -> untyped
     def add_chat_members: (chat_id: Integer, user_ids: Array[Integer]) -> untyped
     def get_chat_members: (chat_id: Integer, **untyped query) -> untyped
     def remove_chat_member: (chat_id: Integer, user_id: Integer, ?block: bool?) -> untyped
@@ -68,7 +72,16 @@ module MaxApiClient
     def send: (?chat_id: Integer?, ?user_id: Integer?, ?disable_link_preview: bool?, **untyped body) -> untyped
     def edit: (message_id: String, **untyped body) -> untyped
     def delete: (message_id: String) -> untyped
-    def answer_on_callback: (callback_id: String, **untyped body) -> untyped
+    def get_video_info: (video_token: String) -> untyped
+    def answer_on_callback: (callback_id: String, ?disable_link_preview: bool?, **untyped body) -> untyped
+  end
+
+  class CommentsApi
+    def get: (message_id: String, **untyped query) -> untyped
+    def get_by_id: (message_id: String, comment_id: String) -> untyped
+    def send: (message_id: String, ?disable_link_preview: bool?, **untyped body) -> untyped
+    def edit: (message_id: String, comment_id: String, **untyped body) -> untyped
+    def delete: (message_id: String, comment_id: String) -> untyped
   end
 
   class SubscriptionsApi
@@ -84,6 +97,7 @@ module MaxApiClient
 
   class Attachment
     def to_h: () -> Hash[Symbol, untyped]
+    def to_json: (*untyped args) -> String
   end
 
   class ImageAttachment < Attachment
@@ -107,6 +121,22 @@ module MaxApiClient
   class ShareAttachment < Attachment
   end
 
+  class ContactAttachment < Attachment
+  end
+
+  class InlineKeyboardAttachment < Attachment
+  end
+
+  module Button
+    def self.callback: (String text, String payload) -> Hash[Symbol, untyped]
+    def self.link: (String text, String url) -> Hash[Symbol, untyped]
+    def self.message: (String text) -> Hash[Symbol, untyped]
+    def self.request_contact: (String text) -> Hash[Symbol, untyped]
+    def self.request_geo_location: (String text, ?quick: bool?) -> Hash[Symbol, untyped]
+    def self.open_app: (String text, String web_app, ?payload: String?, ?contact_id: Integer?) -> Hash[Symbol, untyped]
+    def self.clipboard: (String text, String payload) -> Hash[Symbol, untyped]
+  end
+
   class Upload
     def initialize: (Api) -> void
   end
@@ -115,7 +145,7 @@ module MaxApiClient
     DEFAULT_TIMEOUT: Integer
     DEFAULT_RETRY_INTERVAL: Integer
     READ_TIMEOUT_PADDING: Integer
-    def initialize: (Api api, ?types: Array[String] | String, ?marker: Integer?, ?timeout: Integer, ?retry_interval: Integer, ?read_timeout: Numeric?) -> void
+    def initialize: (Api api, ?types: Array[String] | String, ?marker: Integer?, ?limit: Integer?, ?timeout: Integer, ?retry_interval: Integer, ?read_timeout: Numeric?) -> void
     def each: () { (untyped update) -> void } -> self
     def each: () -> Enumerator[untyped, self]
     def stop: () -> bool
@@ -129,6 +159,7 @@ module MaxApiClient
     def initialize: (token: String, ?base_url: String, ?adapter: untyped, ?open_timeout: Numeric?, ?read_timeout: Numeric?, ?ca_file: String?, ?verify_ssl: bool, ?logger: untyped) -> void
     def get_my_info: () -> untyped
     def edit_my_info: (untyped extra) -> untyped
+    def edit_my_commands: (Array[bot_command] commands) -> untyped
     def set_my_commands: (Array[bot_command] commands) -> untyped
     def delete_my_commands: () -> untyped
     def get_all_chats: (?untyped extra) -> untyped
@@ -137,6 +168,8 @@ module MaxApiClient
     def edit_chat_info: (Integer chat_id, untyped extra) -> untyped
     def get_chat_membership: (Integer chat_id) -> untyped
     def get_chat_admins: (Integer chat_id) -> untyped
+    def add_chat_admins: (Integer chat_id, Array[Hash[Symbol | String, untyped]] admins) -> untyped
+    def remove_chat_admin: (Integer chat_id, Integer user_id) -> untyped
     def add_chat_members: (Integer chat_id, Array[Integer] user_ids) -> untyped
     def get_chat_members: (Integer chat_id, ?untyped extra) -> untyped
     def remove_chat_member: (Integer chat_id, Integer user_id, ?block: bool?) -> untyped
@@ -150,13 +183,19 @@ module MaxApiClient
     def get_messages: (Integer chat_id, ?untyped extra) -> untyped
     def get_message: (String message_id) -> untyped
     def edit_message: (String message_id, ?untyped extra) -> untyped
-    def delete_message: (String message_id, ?untyped extra) -> untyped
+    def delete_message: (String message_id) -> untyped
+    def get_video_info: (String video_token) -> untyped
+    def get_comments: (String message_id, ?untyped extra) -> untyped
+    def get_comment: (String message_id, String comment_id) -> untyped
+    def send_comment: (String message_id, String text, ?untyped extra) -> untyped
+    def edit_comment: (String message_id, String comment_id, ?untyped extra) -> untyped
+    def delete_comment: (String message_id, String comment_id) -> untyped
     def answer_on_callback: (String callback_id, ?untyped extra) -> untyped
     def get_subscriptions: () -> untyped
     def subscribe: (String url, ?update_types: Array[String] | String?, ?secret: String?) -> untyped
     def unsubscribe: (String url) -> untyped
-    def poll_updates: (?Array[String] | String types, ?marker: Integer?, ?timeout: Integer, ?retry_interval: Integer, ?read_timeout: Numeric?) { (untyped update) -> void } -> Polling
-    def poll_updates: (?Array[String] | String types, ?marker: Integer?, ?timeout: Integer, ?retry_interval: Integer, ?read_timeout: Numeric?) -> Enumerator[untyped, Polling]
+    def poll_updates: (?Array[String] | String types, ?marker: Integer?, ?limit: Integer?, ?timeout: Integer, ?retry_interval: Integer, ?read_timeout: Numeric?) { (untyped update) -> void } -> Polling
+    def poll_updates: (?Array[String] | String types, ?marker: Integer?, ?limit: Integer?, ?timeout: Integer, ?retry_interval: Integer, ?read_timeout: Numeric?) -> Enumerator[untyped, Polling]
     def upload_image: (Hash[Symbol, untyped] options) -> ImageAttachment
     def upload_video: (Hash[Symbol, untyped] options) -> VideoAttachment
     def upload_audio: (Hash[Symbol, untyped] options) -> AudioAttachment

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: max_api_client
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - Alexandr Zimin