onyxcord 1.1.6 → 1.1.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 48d2c8e46a2b9da91c5e60313e00bc15fb03d80d60cb08528680e4e848739194
-  data.tar.gz: bf4357fef270f6c86fa344352d9d1267a8e7ca6aa9a66589de36ec9ea1e86a63
+  metadata.gz: 07ea78b3a647f1f03a640e750eef4e5a99595f6afa66ce9be842d012c5e8e2c1
+  data.tar.gz: '08f1edd1b05510983d80766f627db7372edb8f3bce6234ba9cb4d669e9cf2070'
 SHA512:
-  metadata.gz: 0b4b4fbe09bc0f5eab3104a3147947f600e2089406703c694d0ac1e090d6341af08f18581d8ba7d63f6773fb21d0cf74547bf5abf7204735de3d40a454cec231
-  data.tar.gz: 00b65d5043ccb3c265721d07acac65142c0a640bb9b4937049040c28fc23ae6ccb50fb2e92ca009a276e333856757897802a519cedfbc0ca19d3257b08bca675
+  metadata.gz: '092c91e1b949b091079169f2977c44745fea551a93e2cc3d065df2b9c51b534cbb027a01519d781dfc0fe2f783c360eecccee29d46b4f0bb28cd99350bde56cf'
+  data.tar.gz: 076604ea2c7a9a6a0c9303fedfbd5e1cac58cb11cbc741d88afff80a838f80da5637a292b494a6d84ae63da4ce5fc435c8eb3548dcb833961dff588ff6b24974

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 1.1.8 - 2026-06-28
+
+### Correcoes
+
+- `Components::Label` agora delega `custom_id`, `value` e `values` para o componente interativo interno, mantendo compatibilidade com codigo legado de modal que itera por `event.components`.
+- Modais modernos continuam preservando `label`, `description` e `component`, enquanto `event.value(custom_id)`, `event.values(custom_id)` e acesso direto em `event.components` funcionam de forma consistente.
+
+### Validacao
+
+- `bundle exec rspec spec/components_v2_spec.rb`: sucesso.
+- `ruby -c lib/onyxcord/data/component.rb`: sucesso.
+- `ruby -c spec/components_v2_spec.rb`: sucesso.
+- `gem build onyxcord.gemspec`: sucesso.
+- `gem build onyxcord-webhooks.gemspec`: sucesso.
+
+## 1.1.7 - 2026-06-28
+
+### Melhorias
+
+- Atualizada a descricao publicada no RubyGems para mostrar o convite da comunidade Discord: `https://discord.gg/Jy2tpCUtzM`.
+- README mantem as secoes em ingles, portugues e espanhol com o link da comunidade.
+
+### Validacao
+
+- `ruby -c onyxcord.gemspec`: sucesso.
+- `ruby -c onyxcord-webhooks.gemspec`: sucesso.
+
 ## 1.1.6 - 2026-06-28
 
 ### Melhorias

data/README.md

@@ -3,51 +3,51 @@
 [![Gem](https://img.shields.io/gem/v/onyxcord.svg)](https://rubygems.org/gems/onyxcord)
 [![Gem](https://img.shields.io/gem/dt/onyxcord.svg)](https://rubygems.org/gems/onyxcord)
 
-OnyxCord é uma biblioteca Ruby para criar bots, integrações, webhooks e experiências interativas no Discord.
+OnyxCord is a Ruby library for Discord bots, interactions, webhooks, modern modals, and Components V2.
 
-O projeto foi feito com base no `discordrb`, respeitando a base que tornou bots em Ruby simples de começar, mas trazendo uma direção nova para a comunidade: core mais leve, modo raw-first, suporte aos novos componentes de modal e suporte aos Components V2 do Discord.
+Community Discord: https://discord.gg/Jy2tpCUtzM
 
-A ideia é simples:
+Languages: [English](#english) | [Portugues](#portugues) | [Espanol](#espanol)
+
+## English
+
+OnyxCord is a Ruby implementation of the Discord API based on `discordrb`, updated with a lighter raw-first core, modern modal components, webhook helpers, and Discord Components V2 support.
 
 ```txt
-Simples para começar, profundo para controlar.
+Simple to start, deep enough to control.
 ```
 
-## Destaques
+### Highlights
 
-- API Ruby amigável para bots do Discord.
-- Eventos tradicionais com objetos para quem quer produtividade.
-- Eventos raw para quem quer performance e menos alocação.
-- Components V2 com `Text Display`, `Container`, `Section`, `Media Gallery`, `File`, `Separator` e `Thumbnail`.
-- Novos componentes de modal, incluindo `Label`, `Text Display`, selects em modal, upload, radio group e checkbox group.
-- Webhooks com embeds, arquivos e componentes.
-- Rate limiter e executor de eventos preparados para o core moderno do OnyxCord.
+- Friendly Ruby API for Discord bots.
+- Traditional object events for productivity.
+- Raw gateway events for performance and lower allocation.
+- Components V2 support with `Text Display`, `Container`, `Section`, `Media Gallery`, `File`, `Separator`, and `Thumbnail`.
+- Modern modal components, including `Label`, `Text Display`, modal selects, file upload, radio group, checkbox group, and checkbox.
+- Webhooks with embeds, files, and components.
+- Runtime helpers, rate limiting, and event execution designed for modern OnyxCord bots.
 
-## Instalação
+### Installation
 
-Com Bundler:
+With Bundler:
 
 ```ruby
 gem 'onyxcord'
 ```
 
-Depois:
+Then:
 
 ```sh
 bundle install
 ```
 
-Ou direto pelo RubyGems:
+Or install directly:
 
 ```sh
 gem install onyxcord
 ```
 
-No Windows, use uma instalação Ruby com DevKit para compilar dependências nativas quando necessário.
-
-## Primeiro bot
-
-Crie um arquivo `bot.rb`:
+### First Bot
 
 ```ruby
 require 'onyxcord'
@@ -69,126 +69,136 @@ end
 bot.run
 ```
 
-Execute:
+### Components V2
 
-```sh
-ruby bot.rb
-```
+OnyxCord automatically applies the `IS_COMPONENTS_V2` flag when you use V2 components. You can also enable it explicitly with `components_v2: true`.
+
+```ruby
+bot.message(content: '!panel') do |event|
+  event.send_message!(content: nil, components_v2: true) do |_builder, view|
+    view.text_display(content: '## OnyxCord Panel')
+    view.text_display(content: 'Choose an action below.')
 
-## Eventos raw
+    view.row do |row|
+      row.button(style: :primary, label: 'Open', custom_id: 'open_panel')
+      row.button(style: :secondary, label: 'Help', custom_id: 'help_panel')
+    end
+  end
+end
+```
 
-Para bots que precisam de performance, o OnyxCord pode trabalhar direto com o payload do Gateway:
+### Modern Modals
 
 ```ruby
-require 'onyxcord'
-
-bot = OnyxCord::Bot.new(
-  token: ENV.fetch('DISCORD_TOKEN'),
-  mode: :raw,
-  intents: :minimal
-)
+bot.application_command(:feedback) do |event|
+  event.show_modal(title: 'Feedback', custom_id: 'feedback_modal') do |modal|
+    modal.label(label: 'Message') do |label|
+      label.text_input(
+        style: :paragraph,
+        custom_id: 'message',
+        required: true,
+        placeholder: 'Tell us what you think...'
+      )
+    end
 
-bot.raw(:MESSAGE_CREATE) do |payload|
-  puts payload['d']['content']
+    modal.label(label: 'Category') do |label|
+      label.string_select(custom_id: 'category', required: true) do |menu|
+        menu.option(label: 'Bug', value: 'bug')
+        menu.option(label: 'Idea', value: 'idea')
+        menu.option(label: 'Other', value: 'other')
+      end
+    end
+  end
 end
+```
 
-bot.raw(/MESSAGE_/) do |payload|
-  puts "evento: #{payload['t']}"
-end
+### Community
 
-bot.raw do |payload|
-  puts "op: #{payload['op']}"
-end
+Join the Discord server for support, updates, examples, and feedback: https://discord.gg/Jy2tpCUtzM
 
-bot.run
+## Portugues
+
+OnyxCord e uma biblioteca Ruby para criar bots, integracoes, webhooks e experiencias interativas no Discord.
+
+O projeto foi feito com base no `discordrb`, respeitando a base que tornou bots em Ruby simples de comecar, mas trazendo uma direcao nova para a comunidade: core mais leve, modo raw-first, suporte aos novos componentes de modal e Components V2 do Discord.
+
+```txt
+Simples para comecar, profundo para controlar.
 ```
 
-Use `mode: :raw` quando quiser evitar a criação de objetos pesados e processar apenas os pacotes de Gateway diretamente.
-**Importante:** O `OnyxCord` roda em `:hybrid` por padrão, entao comandos de aplicação normais (`application_command`), modais e outros eventos em objeto ja funcionam sem precisar informar `mode: :hybrid`.
+### Destaques
+
+- API Ruby amigavel para bots do Discord.
+- Eventos tradicionais com objetos para quem quer produtividade.
+- Eventos raw para quem quer performance e menos alocacao.
+- Components V2 com `Text Display`, `Container`, `Section`, `Media Gallery`, `File`, `Separator` e `Thumbnail`.
+- Novos componentes de modal, incluindo `Label`, `Text Display`, selects em modal, upload, radio group, checkbox group e checkbox.
+- Webhooks com embeds, arquivos e componentes.
+- Rate limiter e executor de eventos preparados para o core moderno do OnyxCord.
 
-## Performance e memória
+### Instalacao
 
-Para limitar crescimento de fila quando handlers ficam lentos, configure um tamanho maximo para a fila do executor:
+Com Bundler:
 
 ```ruby
-OnyxCord.configure do |config|
-  config.event_workers = 4
-  config.event_queue_size = 1_000
-end
+gem 'onyxcord'
 ```
 
-Em bots grandes, use `bot.runtime_stats`, `bot.cache_stats` e `bot.prune_cache!` para acompanhar e limpar caches em runtime.
+Depois:
+
+```sh
+bundle install
+```
 
-## Components V2
+Ou direto pelo RubyGems:
 
-Components V2 usam a flag `IS_COMPONENTS_V2` (`1 << 15`, valor `32768`). No OnyxCord, essa flag é aplicada automaticamente quando você usa componentes V2, mas você também pode deixar explícito com `components_v2: true`.
+```sh
+gem install onyxcord
+```
 
-Importante: em mensagens V2, o Discord desativa `content`, `embeds`, `poll` e stickers tradicionais. O conteúdo visual deve ser enviado como componentes.
+### Primeiro Bot
 
 ```ruby
-bot.message(content: '!painel') do |event|
-  event.send_message!(content: nil, components_v2: true) do |_builder, view|
-    view.text_display(content: '## Painel OnyxCord')
-    view.text_display(content: 'Escolha uma ação abaixo.')
+require 'onyxcord'
 
-    view.row do |row|
-      row.button(
-        style: :primary,
-        label: 'Abrir',
-        custom_id: 'open_panel'
-      )
+bot = OnyxCord::Bot.new(
+  token: ENV.fetch('DISCORD_TOKEN'),
+  intents: %i[servers server_messages direct_messages message_content],
+  mode: :hybrid
+)
 
-      row.button(
-        style: :secondary,
-        label: 'Ajuda',
-        custom_id: 'help_panel'
-      )
-    end
-  end
+bot.message(content: 'ping') do |event|
+  event.respond!(content: 'pong')
 end
 
-bot.button(custom_id: 'open_panel') do |event|
-  event.respond(content: 'Painel aberto!', ephemeral: true)
+bot.application_command(:ping) do |event|
+  event.respond(content: 'Pong via Slash Command!')
 end
+
+bot.run
 ```
 
-## Container V2
+### Components V2
 
-Containers funcionam como uma estrutura visual rica para agrupar textos, botões, imagens e arquivos:
+O OnyxCord aplica automaticamente a flag `IS_COMPONENTS_V2` quando voce usa componentes V2. Voce tambem pode deixar explicito com `components_v2: true`.
 
 ```ruby
-bot.message(content: '!status') do |event|
-  event.send_message!(content: nil) do |_builder, view|
-    view.container(color: '#8b5cf6') do |container|
-      container.text_display(content: '### Status do servidor')
-      container.separator(divider: true, spacing: :small)
-
-      container.section do |section|
-        section.text_display(content: 'Tudo funcionando normalmente.')
-        section.button(
-          style: :success,
-          label: 'Atualizar',
-          custom_id: 'refresh_status'
-        )
-      end
+bot.message(content: '!painel') do |event|
+  event.send_message!(content: nil, components_v2: true) do |_builder, view|
+    view.text_display(content: '## Painel OnyxCord')
+    view.text_display(content: 'Escolha uma acao abaixo.')
+
+    view.row do |row|
+      row.button(style: :primary, label: 'Abrir', custom_id: 'open_panel')
+      row.button(style: :secondary, label: 'Ajuda', custom_id: 'help_panel')
     end
   end
 end
 ```
 
-Ao usar `container`, `section`, `text_display`, `media_gallery`, `file_display`, `separator` ou `thumbnail`, o OnyxCord detecta Components V2 e envia a flag correta.
-
-## Modais modernos
-
-O OnyxCord também suporta os componentes novos de modal:
+### Modais Modernos
 
 ```ruby
-bot.register_application_command(
-  :feedback,
-  'Enviar feedback',
-  server_id: ENV.fetch('DISCORD_SERVER_ID')
-)
-
 bot.application_command(:feedback) do |event|
   event.show_modal(title: 'Feedback', custom_id: 'feedback_modal') do |modal|
     modal.label(label: 'Mensagem') do |label|
@@ -196,7 +206,7 @@ bot.application_command(:feedback) do |event|
         style: :paragraph,
         custom_id: 'message',
         required: true,
-        placeholder: 'Conte o que você achou...'
+        placeholder: 'Conte o que voce achou...'
       )
     end
 
@@ -207,112 +217,169 @@ bot.application_command(:feedback) do |event|
         menu.option(label: 'Outro', value: 'other')
       end
     end
-
-    modal.text_display(content: 'Obrigado por ajudar a melhorar a comunidade.')
   end
 end
+```
 
-bot.modal_submit(custom_id: 'feedback_modal') do |event|
-  categoria = event.values('category')&.first
-  mensagem = event.value('message')
+### Comunidade
 
-  event.respond(
-    content: "Feedback recebido em #{categoria}: #{mensagem}",
-    ephemeral: true
-  )
-end
+Entre no servidor do Discord para suporte, atualizacoes, exemplos e feedback: https://discord.gg/Jy2tpCUtzM
+
+## Espanol
+
+OnyxCord es una biblioteca Ruby para crear bots, integraciones, webhooks y experiencias interactivas en Discord.
+
+El proyecto esta basado en `discordrb`, manteniendo la idea que hizo simples los bots en Ruby, pero con una direccion moderna para la comunidad: nucleo mas ligero, modo raw-first, componentes modernos de modal y soporte para Components V2 de Discord.
+
+```txt
+Simple para empezar, profundo para controlar.
+```
+
+### Caracteristicas
+
+- API Ruby amigable para bots de Discord.
+- Eventos tradicionales con objetos para productividad.
+- Eventos raw para rendimiento y menos asignaciones.
+- Components V2 con `Text Display`, `Container`, `Section`, `Media Gallery`, `File`, `Separator` y `Thumbnail`.
+- Componentes modernos de modal, incluyendo `Label`, `Text Display`, selects en modal, subida de archivos, radio group, checkbox group y checkbox.
+- Webhooks con embeds, archivos y componentes.
+- Rate limiter y executor de eventos preparados para el core moderno de OnyxCord.
+
+### Instalacion
+
+Con Bundler:
+
+```ruby
+gem 'onyxcord'
 ```
 
-## Webhooks
+Despues:
 
-Também existe um cliente de webhooks:
+```sh
+bundle install
+```
+
+O directamente con RubyGems:
+
+```sh
+gem install onyxcord
+```
+
+### Primer Bot
 
 ```ruby
-require 'onyxcord/webhooks'
+require 'onyxcord'
 
-client = OnyxCord::Webhooks::Client.new(
-  url: ENV.fetch('DISCORD_WEBHOOK_URL')
+bot = OnyxCord::Bot.new(
+  token: ENV.fetch('DISCORD_TOKEN'),
+  intents: %i[servers server_messages direct_messages message_content],
+  mode: :hybrid
 )
 
-client.execute do |builder|
-  builder.content = 'Mensagem enviada por webhook.'
+bot.message(content: 'ping') do |event|
+  event.respond!(content: 'pong')
+end
+
+bot.application_command(:ping) do |event|
+  event.respond(content: 'Pong via Slash Command!')
+end
+
+bot.run
+```
+
+### Components V2
 
-  builder.add_embed do |embed|
-    embed.title = 'OnyxCord'
-    embed.description = 'Webhook funcionando.'
-    embed.timestamp = Time.now
+OnyxCord aplica automaticamente la flag `IS_COMPONENTS_V2` cuando usas componentes V2. Tambien puedes activarla de forma explicita con `components_v2: true`.
+
+```ruby
+bot.message(content: '!panel') do |event|
+  event.send_message!(content: nil, components_v2: true) do |_builder, view|
+    view.text_display(content: '## Panel OnyxCord')
+    view.text_display(content: 'Elige una accion abajo.')
+
+    view.row do |row|
+      row.button(style: :primary, label: 'Abrir', custom_id: 'open_panel')
+      row.button(style: :secondary, label: 'Ayuda', custom_id: 'help_panel')
+    end
   end
 end
 ```
 
-Webhook com Components V2:
+### Modales Modernos
 
 ```ruby
-client.execute(components_v2: true) do |builder, view|
-  builder.content = nil
+bot.application_command(:feedback) do |event|
+  event.show_modal(title: 'Feedback', custom_id: 'feedback_modal') do |modal|
+    modal.label(label: 'Mensaje') do |label|
+      label.text_input(
+        style: :paragraph,
+        custom_id: 'message',
+        required: true,
+        placeholder: 'Cuentanos que piensas...'
+      )
+    end
 
-  view.text_display(content: '## Atualização da comunidade')
-  view.text_display(content: 'Nova versão do OnyxCord disponível.')
+    modal.label(label: 'Categoria') do |label|
+      label.string_select(custom_id: 'category', required: true) do |menu|
+        menu.option(label: 'Bug', value: 'bug')
+        menu.option(label: 'Idea', value: 'idea')
+        menu.option(label: 'Otro', value: 'other')
+      end
+    end
+  end
 end
 ```
 
-Quando componentes são enviados por webhook, o OnyxCord adiciona `with_components=true` na URL automaticamente.
+### Comunidad
 
-## Dependências
+Unete al servidor de Discord para soporte, actualizaciones, ejemplos y feedback: https://discord.gg/Jy2tpCUtzM
 
-Para bots normais:
+## Dependencies
 
-- Ruby 3.2 ou superior.
-- Bundler recomendado.
-- Build tools para extensões nativas, principalmente no Windows.
+For normal bots:
 
-Para recursos de voz:
+- Ruby 3.3 or newer.
+- Bundler is recommended.
+- Build tools for native extensions, especially on Windows.
+
+For voice features:
 
 - `libsodium`
 - `libopus`
 - `FFmpeg`
 
-Você só precisa dessas dependências de voz se o bot for entrar em canais de voz, tocar áudio ou trabalhar com pacotes de voz. Bots de texto, comandos, interactions, modais, webhooks e Components V2 funcionam sem `libsodium`.
+Voice dependencies are only needed when your bot joins voice channels, plays audio, or works with voice packets. Text bots, commands, interactions, modals, webhooks, and Components V2 do not need `libsodium`.
 
-## Exemplos
+## Examples
 
-A pasta `examples/` contém exemplos prontos:
+The `examples/` directory contains ready-to-use examples:
 
-- `ping.rb`: bot simples de ping/pong.
-- `commands.rb`: comandos tradicionais.
+- `ping.rb`: simple ping/pong bot.
+- `commands.rb`: classic commands.
 - `slash_commands.rb`: slash commands.
 - `components.rb`: Components V2.
-- `modals.rb`: modais modernos.
-- `select_menus.rb`: menus de seleção.
+- `modals.rb`: modern modals.
+- `select_menus.rb`: select menus.
 - `webhooks.rb`: webhooks.
-- `voice_send.rb`: envio de voz.
-
-## Desenvolvimento
+- `voice_send.rb`: voice sending.
 
-Para trabalhar no OnyxCord localmente:
+## Development
 
 ```sh
 bundle install
 bundle exec rspec spec
 ```
 
-Se `libsodium` não estiver instalado, os testes de voz podem falhar. Para testar o restante:
+If `libsodium` is not installed, voice tests may fail. To test the rest:
 
 ```sh
 bundle exec rspec $(find spec -name '*_spec.rb' ! -name 'sodium_spec.rb' | sort)
 ```
 
-## Créditos
-
-OnyxCord foi criado a partir da base do `discordrb`, uma biblioteca Ruby importante para a comunidade de bots no Discord.
-
-Este projeto continua essa ideia com uma proposta atualizada:
+## Credits
 
-- manter Ruby acessível para bots do Discord;
-- modernizar o core;
-- adicionar suporte aos novos componentes do Discord;
-- entregar uma base aberta para a comunidade evoluir.
+OnyxCord was created from the foundation of `discordrb`, an important Ruby library for the Discord bot community.
 
-## Licença
+## License
 
-Distribuído como open source sob a licença MIT.
+Open source under the MIT license.

data/lib/onyxcord/data/component.rb

@@ -485,6 +485,14 @@ module OnyxCord
 
     # A parent component for interactive modal components.
     class Label
+      # Methods from the wrapped interactive component that should remain
+      # available for legacy modal code that iterates over event.components.
+      DELEGATED_COMPONENT_METHODS = %i[
+        custom_id
+        value
+        values
+      ].freeze
+
       # @return [Integer] the numeric identifier of the label.
       attr_reader :id
 
@@ -505,6 +513,12 @@ module OnyxCord
         @description = data['description']
         @component = Components.from_data(data['component'], @bot)
       end
+
+      DELEGATED_COMPONENT_METHODS.each do |name|
+        define_method(name) do
+          @component.public_send(name) if @component.respond_to?(name)
+        end
+      end
     end
 
     # A surface that allows users to upload files in a modal.

data/lib/onyxcord/version.rb

@@ -3,5 +3,5 @@
 # OnyxCord and all its functionality, in this case only the version.
 module OnyxCord
   # The current version of onyxcord.
-  VERSION = '1.1.6'
+  VERSION = '1.1.8'
 end

data/onyxcord-webhooks.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |spec|
   spec.email         = ['gustavosilva8kt@gmail.com']
 
   spec.summary       = 'Webhook client for onyxcord'
-  spec.description   = "A webhook client for OnyxCord, a Ruby Discord library based on discordrb and updated with Components V2 support."
+  spec.description   = "Webhook client for OnyxCord with Components V2 support and community support: https://discord.gg/Jy2tpCUtzM."
   spec.homepage      = 'https://github.com/kruldevb/OnyxCord'
   spec.license       = 'MIT'
 

data/onyxcord.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ['gustavosilva8kt@gmail.com']
 
   spec.summary       = 'Discord API for Ruby with Components V2 support'
-  spec.description   = 'A Ruby implementation of the Discord API based on discordrb, updated for OnyxCord with raw-first core, modern modals, and Components V2.'
+  spec.description   = 'OnyxCord is a Ruby Discord API library with Components V2, modern modals, raw-first events, and community support: https://discord.gg/Jy2tpCUtzM.'
   spec.homepage      = 'https://github.com/kruldevb/OnyxCord'
   spec.license       = 'MIT'
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: onyxcord
 version: !ruby/object:Gem::Version
-  version: 1.1.6
+  version: 1.1.8
 platform: ruby
 authors:
 - Gustavo Silva
@@ -109,14 +109,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.6
+        version: 1.1.8
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.1.6
+        version: 1.1.8
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -277,8 +277,8 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.9.37
-description: A Ruby implementation of the Discord API based on discordrb, updated
-  for OnyxCord with raw-first core, modern modals, and Components V2.
+description: 'OnyxCord is a Ruby Discord API library with Components V2, modern modals,
+  raw-first events, and community support: https://discord.gg/Jy2tpCUtzM.'
 email:
 - gustavosilva8kt@gmail.com
 executables: []
@@ -416,8 +416,6 @@ files:
 - lib/onyxcord/websocket.rb
 - onyxcord-webhooks.gemspec
 - onyxcord.gemspec
-- relator.md
-- relatorio2.md
 homepage: https://github.com/kruldevb/OnyxCord
 licenses:
 - MIT

data/relator.md

@@ -1,298 +0,0 @@
-# Relatorio geral da OnyxCord
-
-Data da analise: 2026-06-23
-
-Escopo analisado:
-- Gem Ruby `onyxcord` e `onyxcord-webhooks`.
-- Areas principais: REST API, gateway WebSocket, cache, executor de eventos, comandos/interactions, voice e webhooks.
-- Teste executado: `bundle exec rspec`.
-
-Resultado da validacao atual:
-- `bundle exec rspec`: 456 exemplos, 0 falhas, 3 pendentes.
-- Cobertura reportada pelo SimpleCov: 60,84% de linhas.
-- `gem build onyxcord.gemspec`: sucesso, gerou `onyxcord-1.1.2.gem`.
-- `gem build onyxcord-webhooks.gemspec`: sucesso, gerou `onyxcord-webhooks-1.1.2.gem`.
-
-Status das correcoes aplicadas:
-- Corrigido retry REST `202` preservando route e major parameter.
-- Application commands agora executam pelo `EventExecutor`, sem `Thread.new` direto nesse caminho.
-- Adicionado `event_queue_size` com `SizedQueue` opcional.
-- Adicionados `runtime_stats`, `cache_stats`, `prune_cache!` e `OnyxCord::API.rate_limiter_stats`.
-- Rate limiter REST agora tem `stats`, `prune!` e limpeza automatica de bookkeeping antigo.
-- Voice fecha melhor recursos de UDP/WebSocket/thread, e `play_dca` usa `File.open` com bloco.
-- Dependencias principais receberam upper bounds conservadores.
-- Warning de spec em `spec/bot_spec.rb:114` foi corrigido.
-
-## Resumo executivo
-
-A lib ja tem algumas decisoes boas para performance:
-- O modo padrao do bot agora e `hybrid`, equilibrando handlers raw com eventos em objeto.
-- O cache padrao global esta em `:none`, o que ajuda a reduzir RAM para bots pequenos.
-- Ja existe `EventExecutor::Pool`, evitando uma thread nova para cada evento comum.
-- O rate limiter REST ja centraliza buckets, global limit e `retry_after`.
-- O gateway usa zlib stream, economizando trafego e CPU em payloads grandes.
-
-Os maiores ganhos agora estao em 5 frentes:
-1. Eliminar threads soltas em interactions e waits.
-2. Colocar limite/backpressure no executor de eventos.
-3. Colocar estrategia de limite/limpeza nos caches e nos mapas do rate limiter.
-4. Corrigir um bug provavel no retry de resposta REST `202`.
-5. Fechar recursos de voz/arquivos/sockets de forma garantida.
-
-## Prioridade alta
-
-### 1. Corrigir retry de REST `202` em `OnyxCord::API.request`
-
-Arquivo: `lib/onyxcord/api.rb:141-154`
-
-Problema:
-- Quando Discord retorna `202` com codigo `110000`, o metodo tenta repetir a request.
-- A chamada atual usa `return request(*key, type, *attributes)`.
-- Na maior parte da API, `key` e um `Symbol`, entao `*key` tende a quebrar com `TypeError` ou chamar `request` com parametros errados.
-
-Impacto:
-- Endpoints baseados em Elasticsearch podem falhar justamente no fluxo em que deveriam aguardar e tentar de novo.
-
-Sugestao:
-- Trocar para `return request(key, major_parameter, type, *attributes)`.
-- Adicionar spec cobrindo response `202` com `retry_after`.
-
-### 2. Application commands criam `Thread.new` fora do executor
-
-Arquivo: `lib/onyxcord/bot.rb:1679-1704`
-
-Problema:
-- O fluxo de `INTERACTION_CREATE` para command cria uma thread direta por comando.
-- Isso ignora `EventExecutor::Pool`, ignora `event_workers` e remove qualquer controle de concorrencia.
-- Tambem ha logs temporarios com prefixo `>>>` em caminho quente.
-- O rescue usa `rescue Exception`, que captura sinais de sistema e saidas do processo.
-
-Impacto:
-- Em pico de interactions, o processo pode criar muitas threads, consumindo RAM e escalonamento de CPU.
-- Logs verbosos em production aumentam I/O e custo de CPU.
-
-Sugestao:
-- Executar handler via `@event_executor.post`.
-- Usar `rescue StandardError`.
-- Trocar logs `info` temporarios por `debug` ou remover.
-- Nomear a thread dentro do bloco do executor, como ja acontece em `call_event`.
-
-### 3. Fila de eventos sem limite
-
-Arquivo: `lib/onyxcord/event_executor.rb:28-42`
-
-Problema:
-- `Queue.new` e ilimitada.
-- Se os handlers forem mais lentos que os eventos recebidos, a fila cresce sem backpressure.
-
-Impacto:
-- Pode virar crescimento progressivo de RAM em servidores grandes ou bots com handlers pesados.
-
-Sugestao:
-- Adicionar opcao `event_queue_size`, usando `SizedQueue`.
-- Expor comportamento configuravel: bloquear, rejeitar com log, ou executar inline em emergencia.
-- Medir tamanho da fila em debug/telemetria.
-
-## Prioridade media
-
-### 4. Rate limiter guarda mutexes e buckets para sempre
-
-Arquivo: `lib/onyxcord/rate_limiter/rest.rb:10-47`
-
-Problema:
-- `@route_buckets` e `@bucket_mutexes` crescem conforme novas rotas/major parameters aparecem.
-- Para bots que tocam muitos canais, guilds, mensagens ou webhooks, isso pode acumular.
-
-Impacto:
-- RAM pequena por item, mas permanente.
-
-Sugestao:
-- Guardar `last_used_at` por bucket e limpar entradas antigas.
-- Alternativa simples: limitar por LRU.
-- Adicionar metodo `prune!` chamado ocasionalmente em `record_response`.
-
-### 5. Cache full pode crescer sem limite
-
-Arquivo: `lib/onyxcord/cache.rb:16-29`
-
-Problema:
-- Caches de users, channels, pm_channels, thread_members e server_previews sao Hashes sem TTL/max size.
-- O default global e `:none`, mas quem usa `:full` pode segurar muitos objetos.
-
-Impacto:
-- Em bots grandes, memoria cresce com o tempo e dificilmente volta.
-
-Sugestao:
-- Manter `:none` como default.
-- Adicionar opcoes por cache: `max_users`, `max_channels`, `max_messages`, `ttl`.
-- Oferecer `bot.prune_cache!` e `bot.cache_stats`.
-- Considerar guardar payload cru em modo leve, criando objeto sob demanda.
-
-### 6. `request_chunks` cria buckets por guild sem limpeza
-
-Arquivo: `lib/onyxcord/cache.rb:235-253`
-
-Problema:
-- `@request_members_rl[id]` guarda mutex/time por guild e nunca remove.
-
-Impacto:
-- Baixo por guild, mas permanente em bots que entram/saem de muitos servidores.
-
-Sugestao:
-- Remover no evento de saida de guild.
-- Limpar buckets nao usados ha alguns minutos/horas.
-
-### 7. Voice pode deixar arquivo aberto em `play_dca`
-
-Arquivo: `lib/onyxcord/voice/voice_bot.rb:264-299`
-
-Problema:
-- `File.open(file)` nao usa bloco nem `ensure`.
-- Se erro ocorrer durante validacao ou playback, o descritor pode ficar aberto.
-
-Impacto:
-- Vazamento de file descriptor em uso repetido de voz.
-
-Sugestao:
-- Usar `File.open(file) do |input_stream| ... end` ou `ensure input_stream&.close`.
-
-### 8. Voice WebSocket nao fecha/junta thread explicitamente
-
-Arquivo: `lib/onyxcord/voice/network.rb:321-344`
-
-Problema:
-- `destroy` apenas seta `@heartbeat_running = false`.
-- Nao fecha o WebSocket, nao fecha UDP e nao faz join da thread.
-
-Impacto:
-- Possivel sobra de thread/socket em reconexoes ou destroy repetido.
-
-Sugestao:
-- Implementar close de `@client`, close de UDP socket e `@thread.join` com timeout curto.
-- Adicionar spec com fake socket/client garantindo cleanup.
-
-### 9. Busy wait com `sleep` em pontos sensiveis
-
-Arquivos:
-- `lib/onyxcord/voice/network.rb:338`
-- `lib/onyxcord/voice/voice_bot.rb:315`
-- `lib/onyxcord/bot.rb:413`
-
-Problema:
-- Loops `sleep until` e `sleep while` sao simples, mas acordam periodicamente sem evento real.
-
-Impacto:
-- Baixo em poucos bots, mas piora com muitas conexoes/threads.
-
-Sugestao:
-- Usar `ConditionVariable` para readiness/pausa.
-- Para voice playback, manter cuidado para nao prejudicar o timing de audio.
-
-## Prioridade baixa / limpeza
-
-### 10. Webhooks nao usam o rate limiter central
-
-Arquivo: `lib/onyxcord/webhooks/client.rb`
-
-Problema:
-- Chamadas usam `RestClient.post/patch/delete` direto.
-- Isso e simples, mas nao aproveita `OnyxCord::RateLimiter::Rest`.
-
-Impacto:
-- Clientes de webhook intensivos podem bater 429 com menos controle.
-
-Sugestao:
-- Criar transport compartilhado leve para webhooks.
-- Ou criar um rate limiter dedicado por webhook URL.
-
-### 11. Dependencias abertas demais
-
-Arquivos:
-- `onyxcord.gemspec`
-- `onyxcord-webhooks.gemspec`
-
-Problema:
-- Algumas dependencias permitem qualquer versao acima do minimo, como `rest-client >= 2.0.0`, `websocket-client-simple >= 0.9.0`, `ffi >= 1.9.24` e `opus-ruby` sem limite.
-
-Impacto:
-- Atualizacao futura pode quebrar performance ou compatibilidade.
-
-Sugestao:
-- Definir upper bounds conservadores, por exemplo `< 3` quando fizer sentido.
-- Rodar CI com Ruby 3.3 e 3.4 se a gem prometer suporte moderno.
-
-### 12. Arquivo `bot.rb` esta grande demais
-
-Arquivo: `lib/onyxcord/bot.rb` tem cerca de 1971 linhas.
-
-Problema:
-- O arquivo mistura boot, REST helpers, dispatch, cache orchestration, interactions, voice e commands.
-
-Impacto:
-- Dificulta otimizar sem regressao.
-
-Sugestao:
-- Extrair aos poucos:
-  - `Bot::Interactions`
-  - `Bot::Dispatch`
-  - `Bot::Voice`
-  - `Bot::ApplicationCommands`
-- Fazer isso depois das correcoes de runtime, para nao misturar refactor com bugfix.
-
-## Otimizacoes praticas sugeridas
-
-### Perfil leve recomendado para usuarios
-
-Documentar no README um preset para bots pequenos:
-
-```ruby
-OnyxCord.configure do |config|
-  config.mode = :raw
-  config.cache = :none
-  config.event_executor = :pool
-  config.event_workers = 2
-end
-```
-
-Para bots medios:
-
-```ruby
-OnyxCord.configure do |config|
-  config.mode = :hybrid
-  config.cache = :minimal
-  config.event_workers = 4
-end
-```
-
-### Medir antes/depois
-
-Criar specs/benchmarks simples para:
-- `INTERACTION_CREATE` com 1000 commands simulados.
-- `MESSAGE_CREATE` em modo `raw`, `hybrid` e `object`.
-- crescimento de `@users`, `@channels`, `@thread_members`.
-- fila do executor quando handler dorme 50ms.
-
-### Instrumentacao leve
-
-Adicionar metodos opcionais:
-- `bot.runtime_stats`
-- `bot.cache_stats`
-- `bot.event_queue_size`
-- `OnyxCord::API.rate_limiter_stats`
-
-Isso ajuda a diagnosticar RAM e lentidao sem profiler externo.
-
-## Plano de acao recomendado
-
-1. Corrigir `API.request` no retry `202` e adicionar spec.
-2. Remover threads soltas dos application commands e usar `@event_executor`.
-3. Remover logs `>>>` ou rebaixar para `debug`.
-4. Trocar `Queue` por `SizedQueue` configuravel.
-5. Adicionar `cache_stats` e `prune_cache!`.
-6. Fechar corretamente recursos de voice (`File.open`, UDP, WS, thread).
-7. Adicionar limpeza/LRU no rate limiter REST.
-8. Depois disso, refatorar `bot.rb` em modulos menores.
-
-## Conclusao
-
-A OnyxCord ja esta no caminho certo para ser pratica no modo padrao `hybrid` e ainda leve quando o usuario escolher `raw` com cache `:none`. O maior risco atual nao e um unico algoritmo pesado, e sim crescimento sem limite: threads por interaction, fila ilimitada, caches sem TTL e mapas internos que nao expiram. Corrigir esses pontos deve reduzir RAM em carga real, deixar o bot mais previsivel em pico e facilitar otimizar depois sem mexer na API publica.