bzapper 0.7.0

data/lib/bzapper/resources/advanced.rb

@@ -0,0 +1,388 @@
+# frozen_string_literal: true
+
+# GERADO por script/generate.rb a partir de packages/sdk/openapi.yaml — não edite à mão.
+
+module Bzapper
+  module Resources
+    # Recursos avançados: editar/apagar/encaminhar, perfil, privacidade, chats, etiquetas, bloqueio e chamadas — `client.advanced`.
+    class Advanced < Base
+      # Edit the text of a sent message. `PATCH /messages/{id}`
+      #
+      # @param id [String] Instance ID (UUID).
+      # @param text [String] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def edit_message(id, text:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "text" => text
+        )
+        request("PATCH",
+                "/messages/#{segment(id, "id")}",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Revoke a message (delete for everyone). `DELETE /messages/{id}`
+      #
+      # @param id [String] Instance ID (UUID).
+      # @param for_everyone [Boolean, nil] (query)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def revoke_message(id, for_everyone: nil, idempotency_key: nil, timeout: nil)
+        query = {
+          "for_everyone" => for_everyone
+        }
+        request("DELETE",
+                "/messages/#{segment(id, "id")}",
+                query: query,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Forward a message (experimental). `POST /messages/forward`
+      #
+      # @param instance_id [String] (corpo)
+      # @param to [String] (corpo)
+      # @param from_chat [String] (corpo)
+      # @param wa_message_id [String] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def forward_message(instance_id:, to:, from_chat:, wa_message_id:, idempotency_key: nil,
+                          timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "to" => to,
+          "from_chat" => from_chat,
+          "wa_message_id" => wa_message_id
+        )
+        request("POST",
+                "/messages/forward",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Number profile (white-label) — status (ok), name/photo (experimental). `PATCH
+      # /instances/{id}/profile`
+      #
+      # @param id [String] Instance ID (UUID).
+      # @param display_name [String, nil] (corpo)
+      # @param status_message [String, nil] (corpo)
+      # @param picture [String, nil] (corpo) Photo in base64.
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def set_profile(id, display_name: UNSET, status_message: UNSET, picture: UNSET,
+                      idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "display_name" => display_name,
+          "status_message" => status_message,
+          "picture" => picture
+        )
+        request("PATCH",
+                "/instances/#{segment(id, "id")}/profile",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Set a privacy setting. `PATCH /instances/{id}/privacy`
+      #
+      # @param id [String] Instance ID (UUID).
+      # @param setting [String] (corpo)
+      # @param value [String] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def set_privacy(id, setting:, value:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "setting" => setting,
+          "value" => value
+        )
+        request("PATCH",
+                "/instances/#{segment(id, "id")}/privacy",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Archive/unarchive a chat. `POST /chats/{jid}/archive`
+      #
+      # @param jid [String] Group JID (…@g.us).
+      # @param instance_id [String] (corpo)
+      # @param on [Boolean] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def archive_chat(jid, instance_id:, on:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "on" => on
+        )
+        request("POST",
+                "/chats/#{segment(jid, "jid")}/archive",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Pin/unpin a chat. `POST /chats/{jid}/pin`
+      #
+      # @param jid [String] Group JID (…@g.us).
+      # @param instance_id [String] (corpo)
+      # @param on [Boolean] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def pin_chat(jid, instance_id:, on:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "on" => on
+        )
+        request("POST",
+                "/chats/#{segment(jid, "jid")}/pin",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Mark a chat read/unread. `POST /chats/{jid}/read`
+      #
+      # @param jid [String] Group JID (…@g.us).
+      # @param instance_id [String] (corpo)
+      # @param on [Boolean] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def mark_chat(jid, instance_id:, on:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "on" => on
+        )
+        request("POST",
+                "/chats/#{segment(jid, "jid")}/read",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Mute/unmute a chat. `POST /chats/{jid}/mute`
+      #
+      # @param jid [String] Group JID (…@g.us).
+      # @param instance_id [String] (corpo)
+      # @param on [Boolean] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def mute_chat(jid, instance_id:, on:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "on" => on
+        )
+        request("POST",
+                "/chats/#{segment(jid, "jid")}/mute",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Apply/remove a label on a chat (experimental). `POST /chats/{jid}/labels`
+      #
+      # @param jid [String] Group JID (…@g.us).
+      # @param instance_id [String] (corpo)
+      # @param label_id [String] (corpo)
+      # @param apply [Boolean, nil] (corpo) true = apply, false = remove.
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def apply_chat_label(jid, instance_id:, label_id:, apply: UNSET, idempotency_key: nil,
+                           timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "label_id" => label_id,
+          "apply" => apply
+        )
+        request("POST",
+                "/chats/#{segment(jid, "jid")}/labels",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # List the number's labels (experimental). `GET /labels`
+      #
+      # @param instance_id [String] (query) Instance ID (UUID).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def list_labels(instance_id:, timeout: nil)
+        query = {
+          "instance_id" => instance_id
+        }
+        request("GET", "/labels", query: query, timeout: timeout)
+      end
+
+      # Create a label (experimental). `POST /labels`
+      #
+      # @param instance_id [String] (corpo)
+      # @param name [String] (corpo)
+      # @param color [String, nil] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def create_label(instance_id:, name:, color: UNSET, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "name" => name,
+          "color" => color
+        )
+        request("POST",
+                "/labels",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Delete a label (experimental). `DELETE /labels/{id}`
+      #
+      # @param id [String] Label ID.
+      # @param instance_id [String] (query) Instance ID (UUID).
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def delete_label(id, instance_id:, idempotency_key: nil, timeout: nil)
+        query = {
+          "instance_id" => instance_id
+        }
+        request("DELETE",
+                "/labels/#{segment(id, "id")}",
+                query: query,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Block a contact. `POST /contacts/{jid}/block`
+      #
+      # @param jid [String] Group JID (…@g.us).
+      # @param instance_id [String] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def block_contact(jid, instance_id:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id
+        )
+        request("POST",
+                "/contacts/#{segment(jid, "jid")}/block",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Unblock a contact. `POST /contacts/{jid}/unblock`
+      #
+      # @param jid [String] Group JID (…@g.us).
+      # @param instance_id [String] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def unblock_contact(jid, instance_id:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id
+        )
+        request("POST",
+                "/contacts/#{segment(jid, "jid")}/unblock",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # List blocked contacts. `GET /blocklist`
+      #
+      # @param instance_id [String] (query) Instance ID (UUID).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_blocklist(instance_id:, timeout: nil)
+        query = {
+          "instance_id" => instance_id
+        }
+        request("GET", "/blocklist", query: query, timeout: timeout)
+      end
+
+      # Reject a call. `POST /calls/reject`
+      #
+      # @param instance_id [String] (corpo)
+      # @param call_from [String] (corpo)
+      # @param call_id [String] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def reject_call(instance_id:, call_from:, call_id:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "call_from" => call_from,
+          "call_id" => call_id
+        )
+        request("POST",
+                "/calls/reject",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Start a call (experimental). `POST /calls/offer`
+      #
+      # @param instance_id [String] (corpo)
+      # @param to [String] (corpo)
+      # @param video [Boolean, nil] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def offer_call(instance_id:, to:, video: UNSET, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "instance_id" => instance_id,
+          "to" => to,
+          "video" => video
+        )
+        request("POST",
+                "/calls/offer",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+    end
+  end
+end

data/lib/bzapper/resources/advisories.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+# GERADO por script/generate.rb a partir de packages/sdk/openapi.yaml — não edite à mão.
+
+module Bzapper
+  module Resources
+    # Avisos "atualize sua integração" — `client.advisories`.
+    class Advisories < Base
+      # List pending integration advisories. `GET /advisories`
+      #
+      # Advisories that affect THIS account and have not been dismissed. Use `action` — it states
+      # exactly what to do. Automate with the `advisory.published` webhook.
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def list_advisories(timeout: nil)
+        request("GET", "/advisories", timeout: timeout)
+      end
+
+      # Dismiss an advisory. `POST /advisories/{id}/read`
+      #
+      # Marks the advisory as handled; it stops being returned by `GET /advisories`.
+      #
+      # @param id [String] parâmetro de caminho
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def mark_advisory_read(id, idempotency_key: nil, timeout: nil)
+        request("POST",
+                "/advisories/#{segment(id, "id")}/read",
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+    end
+  end
+end

data/lib/bzapper/resources/base.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Bzapper
+  # Recursos da API (um por tag da spec): `client.messages`, `client.instances`,
+  # `client.groups`, `client.contacts`, `client.campaigns`, `client.webhooks`…
+  #
+  # Convenções (iguais em todos os métodos, gerados de `openapi.yaml`):
+  #
+  # * Nome do método = `operationId` em snake_case (`sendText` → `send_text`).
+  # * Parâmetros de caminho são posicionais; query e corpo são keyword args.
+  # * Obrigatórios da spec não têm padrão (faltou → `ArgumentError` do Ruby).
+  # * Campos de corpo opcionais têm padrão {Bzapper::UNSET} — não informado = não enviado.
+  #   `nil` explícito vai como `null` (limpa o campo num PATCH).
+  # * Filtros de query com `nil` são omitidos; listas vão como CSV; `Time` vira ISO 8601 UTC.
+  # * Toda chamada aceita `timeout:` (segundos, por tentativa); as escritas aceitam
+  #   `idempotency_key:` (senão a SDK gera uma e a repete nas novas tentativas).
+  # * O retorno é o JSON inteiro da resposta (`Hash`/`Array` com chaves **string**; `{"data"
+  #   => [...]}` NÃO é desembrulhado, para preservar paginação/metadados). 204 → `nil`.
+  module Resources
+    # Encanamento comum de {Base} e {Bzapper::PartnerClient}.
+    # @api private
+    module Requests
+      private
+
+      def request(method, path, query: nil, body: nil, multipart: nil, idempotency_key: nil, timeout: nil)
+        @transport.request(method, path, query: query, body: body, multipart: multipart,
+                                         idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      def segment(value, name)
+        Codec.path_segment(value, name)
+      end
+
+      def compact(fields)
+        Codec.compact(fields)
+      end
+
+      def upload(field, file, filename, content_type)
+        Upload.new(field, file, filename: filename, content_type: content_type)
+      end
+    end
+
+    # @api private
+    class Base
+      include Requests
+
+      def initialize(transport)
+        @transport = transport
+      end
+
+      def inspect
+        "#<#{self.class.name}>"
+      end
+    end
+  end
+end

data/lib/bzapper/resources/billing.rb

@@ -0,0 +1,177 @@
+# frozen_string_literal: true
+
+# GERADO por script/generate.rb a partir de packages/sdk/openapi.yaml — não edite à mão.
+
+module Bzapper
+  module Resources
+    # Cobrança: plano, assinatura, add-ons, faturas e preços — `client.billing`.
+    class Billing < Base
+      # Effective account limits (plan + add-ons + usage). `GET /me/entitlements`
+      #
+      # Returns the resolved entitlement of the authenticated account: its effective plan, limits,
+      # contracted add-ons, free allowances per pillar and period usage. This is what the UI uses for
+      # the usage meter.
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_my_entitlements(timeout: nil)
+        request("GET", "/me/entitlements", timeout: timeout)
+      end
+
+      # Put the Pro plan in the cart (pending until the cart is paid). `POST /me/plan/upgrade`
+      #
+      # Does not charge nor activate anything: Pro goes into the cart together with any add-ons, and
+      # is activated when the cart is paid (`POST /me/addons/cart/checkout`).
+      #
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def upgrade_plan(idempotency_key: nil, timeout: nil)
+        request("POST", "/me/plan/upgrade", idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Cancel Pro at the end of the current cycle. `POST /me/plan/cancel`
+      #
+      # Pro stays active until renewal, then the account drops to Free.
+      #
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def cancel_plan(idempotency_key: nil, timeout: nil)
+        request("POST", "/me/plan/cancel", idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Undo a scheduled Pro cancellation. `POST /me/plan/uncancel`
+      #
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def uncancel_plan(idempotency_key: nil, timeout: nil)
+        request("POST", "/me/plan/uncancel", idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Plan/subscription state (null on Free). `GET /me/subscription`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_my_subscription(timeout: nil)
+        request("GET", "/me/subscription", timeout: timeout)
+      end
+
+      # Add (+) or remove (−) add-ons in the cart. `POST /me/addons`
+      #
+      # A positive `delta` adds to the cart (charged only when the cart is paid); a negative one
+      # reduces the cart or the active quantity. Requires Pro (409 not_pro).
+      #
+      # @param kind [String] (corpo) Quantity add-ons: number, project, storage_gb, retention_block
+      #   (+30 days). Feature toggles (0/1): campaigns, schedule_year.
+      # @param delta [Integer] (corpo) Non-zero. > 0 adds to the cart; < 0 reduces the cart/active
+      #   quantity.
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def change_addon(kind:, delta:, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "kind" => kind,
+          "delta" => delta
+        )
+        request("POST",
+                "/me/addons",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Cart state (pending Pro/add-ons + prorated total). `GET /me/addons/cart`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_addon_cart(timeout: nil)
+        request("GET", "/me/addons/cart", timeout: timeout)
+      end
+
+      # Empty the cart. `DELETE /me/addons/cart`
+      #
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def clear_addon_cart(idempotency_key: nil, timeout: nil)
+        request("DELETE", "/me/addons/cart", idempotency_key: idempotency_key, timeout: timeout)
+      end
+
+      # Pay the cart (creates the invoice and opens the in-app payment). `POST
+      # /me/addons/cart/checkout`
+      #
+      # Returns the Stripe `client_secret` for Stripe Elements plus the invoice id. With `save_card:
+      # true`, the card is kept for recurring charges once the invoice is paid.
+      #
+      # @param save_card [Boolean, nil] (corpo)
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def checkout_addon_cart(save_card: UNSET, idempotency_key: nil, timeout: nil)
+        payload = compact(
+          "save_card" => save_card
+        )
+        request("POST",
+                "/me/addons/cart/checkout",
+                body: payload,
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # The account's invoices (latest 24, newest first). `GET /me/invoices`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def list_my_invoices(timeout: nil)
+        request("GET", "/me/invoices", timeout: timeout)
+      end
+
+      # Reopen the in-app payment of an open invoice. `POST /me/invoices/{id}/pay`
+      #
+      # @param id [String] Invoice ID.
+      # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      # @raise [ArgumentError] parâmetro de caminho vazio, "." ou "..".
+      def pay_invoice(id, idempotency_key: nil, timeout: nil)
+        request("POST",
+                "/me/invoices/#{segment(id, "id")}/pay",
+                idempotency_key: idempotency_key,
+                timeout: timeout)
+      end
+
+      # Stripe publishable key for the front-end checkout. `GET /billing/config`
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_billing_config(timeout: nil)
+        request("GET", "/billing/config", timeout: timeout)
+      end
+
+      # Public rate card per currency (plans, add-ons, free allowances). `GET /pricing`
+      #
+      # Public (no authentication). Cached for 5 minutes.
+      #
+      # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
+      # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
+      # @raise [Bzapper::Error] resposta fora de 2xx ou falha de rede.
+      def get_pricing(timeout: nil)
+        request("GET", "/pricing", timeout: timeout)
+      end
+    end
+  end
+end