onyxcord 2.1.0 → 3.2.0

data/.github/workflows/deploy.yml

@@ -1,54 +0,0 @@
-name: Deploy Docs
-
-on:
-  push:
-    branches: [main] # deploy only on merges to main
-    tags:
-      - "v*" # deploy when a version tag (e.g., v1.0.0) is created
-
-jobs:
-  deploy:
-    runs-on: ubuntu-latest
-    container:
-      image: ruby:3.3-alpine
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install OS packages
-        run: apk add git build-base ruby-dev libsodium-dev
-
-      - name: Cache bundle
-        uses: actions/cache@v4
-        with:
-          path: vendor/bundle
-          key: bundle-${{ hashFiles('Gemfile', 'onyxcord.gemspec') }}-yard
-
-      - name: Install dependencies
-        run: bundle install --path vendor/bundle
-
-      - name: Generate YARD documentation
-        run: |
-          mkdir -p docs
-          bundle exec yard --output-dir docs
-
-      - name: Determine deploy folder
-        id: set_folder
-        run: |
-          if [[ "${GITHUB_REF}" == refs/tags/* ]]; then
-            echo "folder=${GITHUB_REF#refs/tags/}" >> $GITHUB_OUTPUT
-          else
-            echo "folder=${GITHUB_REF#refs/heads/}" >> $GITHUB_OUTPUT
-          fi
-          echo "Deploying to folder: ${{ steps.set_folder.outputs.folder }}"
-
-      - name: Deploy to GitHub Pages
-        uses: peaceiris/actions-gh-pages@v4
-        with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs
-          publish_branch: gh-pages
-          destination_dir: ${{ steps.set_folder.outputs.folder }}
-          keep_files: true
-          user_name: "GitHub Actions"
-          user_email: "actions@github.com"

data/.github/workflows/release.yml

@@ -1,51 +0,0 @@
-name: Publish RubyGems + GitHub Packages
-
-on:
-  release:
-    types: [published]
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    permissions:
-      packages: write
-      id-token: write # IMPORTANT: this permission is mandatory for trusted publishing
-      contents: write # IMPORTANT: this permission is required for `rake release` to push the release tag
-
-    steps:
-      - uses: actions/checkout@v5
-        with:
-          persist-credentials: false
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          bundler-cache: true
-          ruby-version: '3.4.7'
-
-      - name: Validate tag matches gemspecs
-        run: |
-          TAG_VERSION="${GITHUB_REF#refs/tags/v}"
-          for gemspec in *.gemspec; do
-            GEM_VERSION=$(ruby -e "puts Gem::Specification.load('$gemspec').version")
-            if [ "$TAG_VERSION" != "$GEM_VERSION" ]; then
-              echo "::error::$gemspec version ($GEM_VERSION) does not match tag ($TAG_VERSION)"
-              exit 1
-            fi
-          done
-
-      - uses: rubygems/release-gem@v1
-
-      - name: Publish to GitHub Packages
-        env:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-        run: |
-          OWNER=$(echo "${GITHUB_REPOSITORY}" | cut -d'/' -f1)
-          for gemspec in *.gemspec; do
-            gem build "$gemspec"
-          done
-          for gem_file in *.gem; do
-            echo "Publishing $gem_file to GitHub Packages..."
-            gem push "$gem_file" \
-              --key github \
-              --host "https://rubygems.pkg.github.com/${OWNER}" || true
-          done

data/.gitignore

@@ -1,17 +0,0 @@
-/.bundle/
-/.yardoc
-/Gemfile.lock
-/_yardoc/
-/coverage/
-/doc/
-/pkg/
-/spec/reports/
-/profiles/
-/tmp/
-/.idea/
-/obsidian/
-.DS_Store
-*.gem
-**.sw*
-
-/vendor/bundle

data/.markdownlint.json

@@ -1,4 +0,0 @@
-{
-  "MD013": false,
-  "MD024": { "siblings_only": true }
-}

data/.overcommit.yml

@@ -1,7 +0,0 @@
-PreCommit:
-  RuboCop:
-    enabled: true
-    on_warn: fail # Treat all warnings as failures
-
-  AuthorName:
-    enabled: false

data/.rspec

@@ -1,2 +0,0 @@
---color
---require spec_helper

data/.rubocop.yml

@@ -1,129 +0,0 @@
-plugins:
-  - rubocop-performance
-  - rubocop-rake
-
-inherit_mode:
-  merge:
-    - AllowedNames
-
-AllCops:
-  NewCops: enable
-  TargetRubyVersion: 3.3
-
-# Disable line length checks
-Layout/LineLength:
-  Enabled: false
-
-# TODO: Larger refactor
-Lint/MissingSuper:
-  Enabled: false
-
-# Allow 'Pokémon-style' exception handling
-Lint/RescueException:
-  Enabled: false
-
-# Disable all metrics.
-Metrics:
-  Enabled: false
-
-# Allow some common and/or obvious short method params
-Naming/MethodParameterName:
-  AllowedNames:
-    - e
-
-# Ignore `eval` in the examples folder
-Security/Eval:
-  Exclude:
-    - examples/**/*
-
-# https://stackoverflow.com/q/4763121/
-Style/Alias:
-  Enabled: false
-
-# Had to disable this globally because it's being silently autocorrected even with local disable comments?
-Style/BisectedAttrAccessor:
-  Enabled: false
-
-# Prefer compact module/class defs
-Style/ClassAndModuleChildren:
-  Enabled: false
-
-# So RuboCop doesn't complain about application IDs
-Style/NumericLiterals:
-  Exclude:
-    - examples/**/*
-
-# TODO: Requires breaking changes
-Style/OptionalBooleanParameter:
-  Enabled: false
-
-# Prefer explicit arguments in case global variables like `$;` or `$,` are changed
-Style/RedundantArgument:
-  Enabled: false
-
-# Prefer |m, e| for the `reduce` block arguments
-Style/SingleLineBlockParams:
-  Methods:
-    - reduce: [m, e]
-    - inject: [m, e]
-
-###################################
-## NEW COPS TO MAKE DECISIONS ON ##
-###################################
-
-# TODO: Decide how you want to handle this:
-# https://rubydoc.info/gems/rubocop/RuboCop/Cop/Style/HashSyntax
-Style/HashSyntax:
-  EnforcedShorthandSyntax: either
-
-Style/ArgumentsForwarding:
-  Enabled: false
-
-Performance/StringIdentifierArgument:
-  Enabled: false
-
-Style/ComparableClamp:
-  Enabled: false
-
-Style/SuperArguments:
-  Enabled: false
-
-Naming/BlockForwarding:
-  Enabled: false
-
-Style/RedundantSelfAssignmentBranch:
-  Enabled: false
-
-Performance/MapCompact:
-  Enabled: false
-
-Gemspec/RequiredRubyVersion:
-  Enabled: false
-
-Gemspec/DevelopmentDependencies:
-  Enabled: false
-
-Style/RedundantReturn:
-  Enabled: false
-
-Style/RedundantParentheses:
-  Enabled: false
-
-Layout/EndOfLine:
-  Enabled: true
-  EnforcedStyle: lf
-
-# This will probably be a breaking change, but should happen
-Style/ReturnNilInPredicateMethodDefinition:
-  Enabled: false
-
-# FIXME: Disabled due to breaking tests, should probably refactor the code instead
-Style/SafeNavigation:
-  Enabled: false
-
-Style/Documentation:
-  Enabled: true
-
-Style/IfUnlessModifier:
-  Exclude:
-    - lib/onyxcord/data/role.rb

data/.yardopts

@@ -1 +0,0 @@
---markup markdown --hide-tag todo --fail-on-warning

data/CHANGELOG.md

@@ -1,257 +0,0 @@
-# Changelog
-
-## 2.1.0 - 2026-07-01
-
-### Melhorias de REST e gateway
-
-- Adiciona `OnyxCord::MessagePayload` e `OnyxCord::Upload` para centralizar payloads, anexos e multipart.
-- Melhora rate limit global async para bloquear novas requests enquanto o limite global esta ativo.
-- Adiciona retry REST para falhas temporarias `500`, `502`, `503`, `504` e erros de conexao.
-- Adiciona erros HTTP tipados com `status`, `code`, `headers`, `route`, `body` e `response`.
-- Torna o reconnect do gateway mais defensivo: quedas antes do `HELLO` voltam para `IDENTIFY`, quedas depois do `HELLO` tentam `RESUME`.
-- Adiciona `AllowedMentions.none` e `AllowedMentions.all`.
-- Ajusta edicao de mensagens para limpar `embeds` ao editar `content`, limpar `content` ao editar `embeds`, e preservar campos com `:keep`.
-- Valida payloads antes da API para limites de embeds/anexos e combinacoes invalidas de Components V2.
-
-## 2.0.20 - 2026-06-30
-
-### Correcoes de REST
-
-- Porta o formato multipart do disnake: lista de partes `files[n]` e `payload_json`, com reset do arquivo antes do envio.
-
-## 2.0.19 - 2026-06-30
-
-### Correcoes de REST
-
-- Adiciona diagnostico de metodo, URL sanitizada, headers e formato do body em erros HTTP sem JSON.
-
-## 2.0.18 - 2026-06-30
-
-### Correcoes de REST
-
-- Normaliza multipart de followup webhook com `payload_json` primeiro e sem campos vazios.
-
-## 2.0.17 - 2026-06-30
-
-### Correcoes de REST
-
-- Envia `payload_json` com `Content-Type: application/json` e `.txt` como `text/plain` em multipart.
-
-## 2.0.16 - 2026-06-30
-
-### Correcoes de REST
-
-- Forca HTTP/1.1 na sessao REST do HTTPX para evitar `protocol_error` em interacoes e followups.
-
-## 2.0.15 - 2026-06-30
-
-### Correcoes de REST
-
-- Envia uploads `multipart/form-data` por `Net::HTTP` no adaptador REST para evitar rejeicao `HTTP 400` do Cloudflare em anexos.
-
-## 2.0.14 - 2026-06-30
-
-### Correcoes de REST
-
-- Corrige uploads `multipart/form-data` no adaptador HTTPX usando `form:` nativo, evitando `HTTP 400` HTML do Cloudflare em anexos.
-
-## 2.0.13 - 2026-06-28
-
-### Correcoes de gateway
-
-- Evita chamadas REST em `Bot#update_voice_state` ao processar `VOICE_STATE_UPDATE`.
-- Torna `GUILD_UPDATE` tolerante a guild ainda nao cacheada.
-
-## 2.0.12 - 2026-06-28
-
-### Correcoes de gateway
-
-- Evita chamadas REST durante a criação de eventos do Gateway para `VOICE_STATE_UPDATE` e `CHANNEL_CREATE`.
-- Trata `Async::Cancel` durante dispatch do Gateway como cancelamento esperado, sem registrar erro fatal.
-
-## 2.0.11 - 2026-06-28
-
-### Correcoes de estabilidade
-
-- Isola a sessao HTTP persistente por thread para evitar que tarefas em segundo plano disputem a mesma conexao REST das interacoes.
-
-## 2.0.10 - 2026-06-28
-
-### Correcoes de voz
-
-- Mantem `channel_id` no cache de `VoiceState` mesmo quando o objeto do canal ainda nao foi resolvido.
-- Expoe `channel_id` e `old_channel_id` em `VoiceStateUpdateEvent`, corrigindo entradas em call que pareciam `nil -> nil`.
-- Permite que raw dispatch handlers filtrem pacotes com chaves string ou symbol.
-
-## 2.0.9 - 2026-06-28
-
-### Correcoes de estabilidade
-
-- Tolera um heartbeat sem ACK antes de reconectar, evitando queda por ACK atrasado isolado.
-
-## 2.0.8 - 2026-06-28
-
-### Correcoes de gateway
-
-- Forca WebSocket do Gateway e do cliente generico em HTTP/1.1 para evitar `Async::WebSocket::ConnectionError: Failed to negotiate connection!` ao conectar no Discord.
-- Desativa extensoes WebSocket no handshake para evitar close `Error while decoding payload` no Gateway do Discord.
-- Remove o empacotamento separado `onyxcord-webhooks`; webhooks continuam incluidos diretamente na gem `onyxcord`.
-
-## 2.0.6 - 2026-06-28
-
-### Correcoes de empacotamento
-
-- Incluidos na gem os arquivos da infraestrutura async que ficaram fora do pacote `2.0.5`: `onyxcord/async/runtime` e `onyxcord/rate_limiter/async_rest`.
-- Incluidos na gem os arquivos da DSL moderna de application commands: `onyxcord/application_commands` e seus componentes internos.
-- Corrige `LoadError: cannot load such file -- onyxcord/async/runtime` ao usar a gem publicada.
-
-## 2.0.5 - 2026-06-28
-
-### Async Runtime (Infraestrutura nao-bloqueante)
-
-- **`OnyxCord::AsyncRuntime`**: modulo central que gerencia o reactor `async` com `run`, `async` e `sleep`, reaproveitando reactor existente quando disponivel.
-- **`EventExecutor::AsyncPool`**: novo pool de workers baseado em `Async::Queue` e fibers, sem threads.
-- **Gateway**: `run_async` nao cria mais `Thread.new` — usa `@task = AsyncRuntime.async { run }`. Todos os `sleep` trocados por `AsyncRuntime.sleep`.
-- **WebSocket**: usa `AsyncRuntime.async` em vez de `Async do` solto na classe.
-- **API REST**: `request` agora delega para `request_async` automaticamente quando dentro de um reactor. `request_async` usa rate limiter async, `AsyncRuntime.sleep`, e retry com limite em 502.
-- **Rate Limiter Async**: novo `OnyxCord::RateLimiter::AsyncRest` que evita `mutex.synchronize { sleep }` bloqueante.
-- **Bot**: `run`/`stop`/`join` refatorados para o runtime async. `send_temporary_message` e `voice_connect` usam sleeps async.
-- Compatibilidade sync mantida: a API publica continua funcionando de forma sincrona quando chamada fora de um reactor.
-
-### Modern Application Commands DSL
-
-- **`bot.slash`, `bot.user_command`, `bot.message_command`**: nova DSL para comandos modernos com definicao e handler unificados.
-- **`bot.sync_application_commands!`**: sincroniza todos os commands registrados com a API do Discord de uma vez.
-- **`bot.bulk_overwrite_global_application_commands`** e **`bot.bulk_overwrite_guild_application_commands`**: wrappers para bulk overwrite.
-- **`ApplicationCommands::Context`**: wrapper com `respond`, `defer`, `edit_original`, `delete_original`, `followup` e acesso a `options`, `guild`, `channel`, `user`.
-- **`Interaction#edit_original`**, **`Interaction#delete_original`**, **`Interaction#followup`**: novos aliases dos metodos originais.
-- API legacy (`register_application_command` + `application_command`) mantida com compatibilidade total.
-
-### Exemplo da nova DSL
-
-```ruby
-bot.slash :ban, description: "Bane um membro", default_member_permissions: [:ban_members] do
-  user :member, "Membro que sera banido", required: true
-  string :reason, "Motivo do banimento", max_length: 512
-
-  execute do |ctx|
-    ctx.defer(ephemeral: true)
-    member = ctx.options[:member]
-    reason = ctx.options[:reason] || "Sem motivo informado"
-    ctx.guild.ban(member, reason: reason)
-    ctx.edit_original(content: "Membro banido com sucesso.")
-  end
-end
-
-bot.sync_application_commands!(server_id: ENV.fetch('DISCORD_SERVER_ID'))
-```
-
-### Validacao
-
-- `bundle exec rspec`: 460 exemplos, 0 falhas, 3 pendentes.
-- `ruby -c lib/onyxcord/**/*.rb`: todos os arquivos com sintaxe OK.
-- `gem build onyxcord.gemspec`: sucesso.
-
-## 2.0.0 - 2026-06-28
-
-### Arquitetura & Performance (Major Refactoring)
-
-- **Runtime 100% Async**: A infraestrutura de threads (`Thread.new`) foi substituída pelo modelo de fibers do Ruby usando a gem `async`. Gateway, heartbeats, fila REST, worker de eventos e comandos agora executam de forma não-bloqueante no reator Async.
-- **REST Moderno via HTTPX**: Substituída a gem legada `rest-client` pela `httpx`, trazendo suporte nativo a conexões persistentes (Keep-Alive), HTTP/2, multipart uploads nativos e retries automáticos em erros 502.
-- **Gateway via Async-WebSocket**: Substituída a implementação de raw TCP sockets + `websocket-client-simple` por `async-websocket`, proporcionando um event loop de gateway extremamente rápido e escalável.
-- **Parse JSON via Oj**: A gem `oj` foi integrada em modo de compatibilidade (`mode: :compat`), acelerando transparentemente todas as serializações e deserializações de pacotes do Discord na lib inteira.
-- **Cache Inteligente LRU**: Os caches em memória (usuários, canais, servidores, membros) agora utilizam `LruRedux::ThreadSafeCache`. Os tamanhos padrão foram aumentados (`users: 50_000`, `channels: 10_000`, `servers: 1_000`, `members: 100_000`) e podem ser customizados via `OnyxCord.configure { |c| c.cache_sizes.users = 100_000 }`.
-- **Fusão do Webhooks**: A funcionalidade da gem separada `onyxcord-webhooks` foi integrada diretamente no núcleo da gem `onyxcord`; nao ha mais pacote separado para publicar.
-- **Alvo Ruby ≥ 3.4**: Atualizada a versão mínima requerida do Ruby para aproveitar as otimizações modernas do interpretador e fibras.
-
-## 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.
-- `bundle exec rspec`: 460 exemplos, 0 falhas, 3 pendentes.
-- `ruby -c lib/onyxcord/data/component.rb`: sucesso.
-- `ruby -c spec/components_v2_spec.rb`: sucesso.
-- `gem build onyxcord.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.
-
-## 1.1.6 - 2026-06-28
-
-### Melhorias
-
-- Adicionado suporte aos novos componentes de modal do Discord: `Label`, `File Upload`, `Radio Group`, `Checkbox Group` e `Checkbox`.
-- Modais agora preservam o `id` do componente `Label` ao gerar o payload.
-- Parser de componentes agora expoe `label` e `description` em `Components::Label`.
-
-### Validacao
-
-- `bundle exec rspec spec/components_v2_spec.rb`: 15 exemplos, 0 falhas.
-- `ruby -c lib/onyxcord/webhooks/modal.rb`: sucesso.
-- `ruby -c lib/onyxcord/data/component.rb`: sucesso.
-- `ruby -c spec/components_v2_spec.rb`: sucesso.
-
-## 1.1.5 - 2026-06-28
-
-### Melhorias
-
-- Attachment uploads agora enviam metadata (`id`, `filename`) no payload JSON e usam chaves `files[N]` no multipart body, seguindo a especificacao da API do Discord.
-- Novos helpers `attachment_payload` e `multipart_body` adicionados nativamente em `API::Channel`, `API::Interaction` e `API::Webhook`.
-- Metodos afetados: `Channel.create_message`, `Channel.start_thread_in_forum_or_media_channel`, `Interaction.create_interaction_response`, `Webhook.token_edit_message` e `Webhook.token_execute_webhook`.
-
-### Correcoes
-
-- Corrigido `Channel.create_message` para sanitizar o parametro `tts`, forçando `false` quando o valor nao e booleano.
-
-## 1.1.4 - 2026-06-28
-
-### Melhorias
-
-- `MediaGallery` agora aceita URLs diretas e hashes no builder, como `media_gallery('https://...')`, alem do formato em bloco.
-- `FileComponent`/`file_display` agora aceita a URL do attachment como primeiro argumento, como `file_display('attachment://arquivo.txt')`.
-
-### Correcoes
-
-- Parser de `MediaGallery` e `FileUpload` ficou mais tolerante quando o payload nao traz `items` ou `values`.
-
-### Validacao
-
-- `bundle exec rspec spec/components_v2_spec.rb`: 13 exemplos, 0 falhas.
-
-## 1.1.3 - 2026-06-23
-
-### Melhorias
-
-- Alterado o modo padrao do bot para `:hybrid`, mantendo suporte a handlers raw e eventos em objeto sem configuracao extra.
-- Adicionado `event_queue_size` para permitir fila de eventos com limite via `SizedQueue`.
-- Application commands agora usam o `EventExecutor`, evitando criacao direta de threads por interaction.
-- Adicionados `runtime_stats`, `cache_stats`, `prune_cache!` e `OnyxCord::API.rate_limiter_stats` para diagnostico de memoria e runtime.
-- Rate limiter REST agora expoe `stats`, `prune!` e limpeza automatica de bookkeeping antigo.
-- Voice recebeu limpeza mais segura de UDP, WebSocket, threads e leitura DCA com fechamento garantido de arquivo.
-- Dependencias principais receberam upper bounds conservadores para reduzir risco de quebra em releases futuras.
-
-### Correcoes
-
-- Corrigido retry de respostas REST `202` para reutilizar a rota e o major parameter originais.
-- Removidos logs temporarios de interaction no caminho quente de dispatch.
-- Corrigido warning de spec causado por expectativa em cache de usuarios nulo.
-
-### Validacao
-
-- `bundle exec rspec`: 456 exemplos, 0 falhas, 3 pendentes.
-- RuboCop nos arquivos alterados: sem offenses.
-- `gem build onyxcord.gemspec`: sucesso.

data/Gemfile

@@ -1,6 +0,0 @@
-# frozen_string_literal: true
-
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in onyxcord.gemspec
-gemspec name: 'onyxcord'

data/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2015-2026 meew0
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.