bug_bunny 4.4.2 → 4.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f78de682c42ac5bcc4e0fbf14a7f03873e69459e32d5b1e20432c7e1c0871a7c
-  data.tar.gz: 0b4a97ff9cdaa0eba4e869f00eb759595e4adfe7b7b4e2626afa01e734d252ef
+  metadata.gz: 027ba35b634991e2d41e8e80250b7c03e1dd3c60265eed0787f9d2e513911276
+  data.tar.gz: deb6f54612ca89aa583482a8e7fba8d3df60db3b4bebeb7454b47d561e4b5d0e
 SHA512:
-  metadata.gz: ac04317d1875384da9d685fb353b68a9cbbdfaecbca4c0944a13576162f8dfbde469692c9b72e86d649886bc808647d08e68d7c82bed15de2026c5bc46418b0d
-  data.tar.gz: a9ca7fd494102230ea3fbe9d85a757c5291e7a87cbbccae5d8649c84a8d48f913d3b38b576751494683c495e471850e3925b54a9f4856f1c473ad4aeb6fcec90
+  metadata.gz: d30777e78f9e82f984537d775a65a9b0dfada3b408d716fdb61e11d9464c24cfed58710fffaca2e355429955a9db733d79a8a7c470ce39171a5dafe5be1c7762
+  data.tar.gz: e35937729acad3ee114e63cefd998c609171e3244b1cd5469dacf9626a732871ee4c687be8beb8f8016b4a5245e6d8a80ef52c44007dd9404b645ea0954a6063

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [4.5.0] - 2026-03-25
+
+### ✨ New Features & DX
+* **Controller Header API:** Se introdujo el método `headers` en `BugBunny::Controller` para permitir una manipulación intuitiva de las cabeceras de respuesta AMQP, siguiendo el patrón familiar de Rails.
+    * Ejemplo: `headers['X-Custom'] = 'Value'`.
+* **Observability Refinement:** Finalización de la migración al patrón de observabilidad estándar con nombres de eventos `clase.evento` en todos los componentes.
+
+## [4.4.2] - 2026-03-25
+
+
+### ✨ New Features
+* **Request#params:** Se agregó el atributo `params` al objeto `Request` para enviar query params de forma declarativa, al estilo Faraday. Los params se serializan como query string (`Rack::Utils.build_nested_query`) y viajan en el header AMQP `type`, que es el que usa el consumer para rutear al controlador. La `routing_key` del exchange no se ve afectada.
+* **Resource.where con params:** `Resource.where` ahora usa internamente `req.params` en lugar de construir la URL manualmente, unificando el comportamiento con el cliente directo.
+
+### 🐛 Bug Fixes
+* **Session#exchange:** El `name` y `type` del exchange se convierten a `String` via `.to_s` antes de pasarlos a Bunny, evitando `NoMethodError: undefined method 'gsub' for an instance of Symbol` al configurar exchanges con Symbols.
+* **Configuration:** Se corrigió el namespace por defecto de controladores de `'Rabbit::Controllers'` a `'BugBunny::Controllers'`.
+
 ## [4.4.2] - 2026-03-25
 
 ### 📈 Observability & Standards Final Polish

data/README.md

@@ -89,6 +89,13 @@ end
 node = RemoteNode.find('node-123')
 node.status = 'active'
 node.save # Realiza un PUT a inventory_exchange con routing_key 'nodes.node-123'
+
+# Búsqueda con filtros (query params)
+# Los filtros se serializan como query string en el header 'type' del mensaje.
+# El consumer los recibe en params[] igual que en Rails.
+RemoteNode.all                               # GET nodes
+RemoteNode.where(status: 'active')           # GET nodes?status=active
+RemoteNode.where(q: { cpu_cores: 4 })        # GET nodes?q[cpu_cores]=4
 ```
 
 ---
@@ -167,7 +174,18 @@ client.send('users/1') do |req|
   req.timeout = 5
 end
 
-# 3. Métodos de conveniencia (Atajos)
+# 3. Query params (estilo Faraday)
+# Usá req.params para enviar filtros. La gema los serializa como query string
+# en el header 'type' del mensaje (que el consumer usa para rutear).
+# La routing_key del exchange NO se ve afectada.
+client.request('users') do |req|
+  req.method = :get
+  req.params = { q: { active: true }, page: 2 }
+end
+# Equivalente usando args:
+client.request('users', method: :get, params: { q: { active: true }, page: 2 })
+
+# 4. Métodos de conveniencia (Atajos)
 client.request('users/1') # Siempre :rpc
 client.publish('events', body: { type: 'click' }) # Siempre :publish
 

data/lib/bug_bunny/client.rb

@@ -109,6 +109,7 @@ module BugBunny
       req.exchange_options = args[:exchange_options] if args[:exchange_options]
       req.queue_options    = args[:queue_options]    if args[:queue_options]
 
+      req.params                                     = args[:params]   if args[:params]
       req.headers.merge!(args[:headers])             if args[:headers]
 
       # 3. Configuración del usuario (bloque específico por request)

data/lib/bug_bunny/controller.rb

@@ -33,6 +33,7 @@ module BugBunny
     attribute :raw_string
 
     # @return [Hash] Headers de respuesta que serán enviados de vuelta en RPC.
+    # @deprecated Use {#response_headers} instead or the helper {#headers}.
     attr_reader :response_headers
 
     # @return [Hash, nil] Respuesta final renderizada.
@@ -40,6 +41,18 @@ module BugBunny
 
     # @!endgroup
 
+    # API de Cabeceras de Respuesta (Estilo Rails)
+    # Permite manipular fácilmente los headers AMQP que se enviarán de vuelta al cliente.
+    #
+    # @example
+    #   headers['X-Custom-Header'] = 'Value'
+    #   headers[:content_type] = 'application/pdf'
+    #
+    # @return [Hash] El Hash de cabeceras de respuesta.
+    def headers
+      @response_headers
+    end
+
 
     # ==========================================
     # INFRAESTRUCTURA DE FILTROS Y LOGS (HEREDABLES)

data/lib/bug_bunny/request.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'rack/utils'
+
 module BugBunny
   # Encapsula toda la información necesaria para realizar una petición o publicación.
   #
@@ -9,6 +11,7 @@ module BugBunny
   #
   # @attr body [Object] El cuerpo del mensaje (Hash, Array o String).
   # @attr headers [Hash] Cabeceras personalizadas (Headers AMQP).
+  # @attr params [Hash] Parámetros de query string (ej: { q: { foo: :bar } }).
   # @attr path [String] La ruta lógica del recurso (ej: 'users', 'users/123').
   # @attr method [Symbol, String] El verbo HTTP (:get, :post, :put, :delete). Default: :get.
   # @attr exchange [String] El nombre del Exchange destino.
@@ -22,6 +25,7 @@ module BugBunny
   class Request
     attr_accessor :body
     attr_accessor :headers
+    attr_accessor :params
     attr_accessor :path
     attr_accessor :method
     attr_accessor :exchange
@@ -46,6 +50,7 @@ module BugBunny
       @path = path
       @method = :get # Verbo por defecto
       @headers = {}
+      @params = {}
       @content_type = 'application/json'
       @timestamp = Time.now.to_i
       @persistent = false
@@ -56,10 +61,20 @@ module BugBunny
       @exchange_options = {}
       @queue_options = {}
     end
+    # Combina el path con los params como query string.
+    #
+    # @return [String] El path completo con query string si hay params, o solo el path.
+    def full_path
+      return path if params.nil? || params.empty?
+
+      "#{path}?#{Rack::Utils.build_nested_query(params)}"
+    end
+
     # Calcula la Routing Key final que se usará en RabbitMQ.
     #
     # Principio: "Convention over Configuration".
     # Si no se define una `routing_key` manual, se asume que el `path` actúa como tal.
+    # Los params NO afectan la routing key — son metadata de la petición, no del enrutamiento del exchange.
     #
     # @return [String] La routing key definitiva.
     def final_routing_key
@@ -67,11 +82,11 @@ module BugBunny
     end
 
     # Calcula el valor para el header AMQP 'type'.
-    # En esta arquitectura REST, el 'type' es la URL del recurso (el path).
+    # En esta arquitectura REST, el 'type' es la URL completa del recurso (path + query string).
     #
     # @return [String] El tipo de mensaje definitivo.
     def final_type
-      type || path
+      type || full_path
     end
 
     # Genera el Hash de opciones limpio para la gema Bunny.

data/lib/bug_bunny/resource.rb

@@ -4,7 +4,6 @@ require 'active_model'
 require 'active_support/core_ext/string/inflections'
 require 'uri'
 require 'set' # Necesario para el tracking manual
-require 'rack/utils'
 
 module BugBunny
   # Clase base para modelos remotos que implementan **Active Record over AMQP (RESTful)**.
@@ -194,17 +193,16 @@ module BugBunny
       # @return [Array<BugBunny::Resource>]
       def where(filters = {})
         rk = calculate_routing_key
-        path = resource_name
-        path += "?#{Rack::Utils.build_nested_query(filters)}" if filters.present?
 
         response = bug_bunny_client.request(
-          path,
+          resource_name,
           method: :get,
           exchange: current_exchange,
           exchange_type: current_exchange_type,
           routing_key: rk,
           exchange_options: current_exchange_options,
-          queue_options: current_queue_options
+          queue_options: current_queue_options,
+          params: filters.presence || {}
         )
 
         return [] unless response['body'].is_a?(Array)

data/lib/bug_bunny/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BugBunny
-  VERSION = "4.4.2"
+  VERSION = "4.5.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bug_bunny
 version: !ruby/object:Gem::Version
-  version: 4.4.2
+  version: 4.5.0
 platform: ruby
 authors:
 - gabix