bug_bunny 4.0.1 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b15b464fc158fbab2ed65325af31aedda4160fa435762a87bba018a827714ba
-  data.tar.gz: dfeca1173ed11ec9b7f9615b37ff596156988700cd95e7b155335771095d17dd
+  metadata.gz: ef1416747a080c5d6af30ac97412688c0419e8b3635b410d93580ad869d78924
+  data.tar.gz: e362258f131a6fefdad0b835a410218e349d8d56966bfef67586dd573375ffcb
 SHA512:
-  metadata.gz: dc7e4d36f8f5570f134a81cd48d1aeffd647d6a08a6817397b6004ef82111d63f43df1ef01c685da537e1b65102f7abd9f32ea97f3c4ec79254365fad1a417eb
-  data.tar.gz: 5fb2f92c8bec877f3ff81a0db8c50e2859737c5000e6c97a79935408f9a83486f1dc93b8218e5baeaad915e631e7d139a500f7c4d71b6c61d6a1c9f5e45fbf69
+  metadata.gz: e788b41069a507289245398fc56ab5829df1139665319a254b6136aa26eb44a607b0f7d0843b517f4ed3298095629bed97e64d9aaace5cc81313f4995392d12d
+  data.tar.gz: cfff2337042002bf850200a8b63739502e2c4607d2c26d661756f980cf7c8c8986a96545811c03aba7b8fc3c23fe929e62240f63dada14c55ddb02cd38feda30

data/CHANGELOG.md

@@ -1,4 +1,12 @@
 # Changelog
+
+## [4.1.0] - 2026-03-22
+
+### 🚀 New Features & Improvements
+* **Faraday-style Client API:** Se introdujo el método \`Client#send\` como punto de entrada genérico, permitiendo una sintaxis más familiar y flexible.
+* **Flexible Delivery Modes:** Introducción del atributo \`delivery_mode\` (:rpc o :publish). Ahora es posible configurar la estrategia de envío a nivel de cliente o por cada petición individual.
+* **Smart Request Defaults:** Los métodos \`request\` y \`publish\` ahora delegan internamente en \`send\`, manteniendo la compatibilidad pero beneficiándose de la nueva arquitectura de peticiones.
+
 ## [4.0.1] - 2026-03-13
 
 ### 🐛 Bug Fixes

data/README.md

@@ -203,6 +203,26 @@ client = BugBunny::Client.new(pool: BUG_BUNNY_POOL) do |stack|
   stack.use BugBunny::Middleware::JsonResponse
 end
 
+# 1. Método genérico 'send' (Estilo Faraday)
+# El comportamiento (RPC o Fire-and-forget) depende de 'delivery_mode'
+client.delivery_mode = :rpc # Default
+client.send('users/1', method: :get)
+
+# 2. Configuración flexible del modo de entrega
+# Por cada petición
+client.send('logs', method: :post, body: { msg: 'system_up' }, delivery_mode: :publish)
+
+# O mediante un bloque para configuración avanzada
+client.send('users/1') do |req|
+  req.method = :get
+  req.delivery_mode = :rpc
+  req.timeout = 5
+end
+
+# 3. Métodos de conveniencia (Atajos)
+client.request('users/1') # Siempre :rpc
+client.publish('events', body: { type: 'click' }) # Siempre :publish
+
 # Ahora el cliente devolverá Hashes y lanzará errores si el worker falla
 response = client.request('users/1', method: :get)
 ```

data/lib/bug_bunny/client.rb

@@ -21,6 +21,9 @@ module BugBunny
     # @return [BugBunny::Middleware::Stack] La pila de middlewares configurada.
     attr_reader :stack
 
+    # @return [Symbol] El modo de entrega por defecto para este cliente (:rpc o :publish).
+    attr_accessor :delivery_mode
+
     # Inicializa un nuevo cliente.
     #
     # @param pool [ConnectionPool] Pool de conexiones a RabbitMQ configurado previamente.
@@ -30,9 +33,22 @@ module BugBunny
       raise ArgumentError, "BugBunny::Client requiere un 'pool:'" if pool.nil?
       @pool = pool
       @stack = BugBunny::Middleware::Stack.new
+      @delivery_mode = :rpc
       yield(@stack) if block_given?
     end
 
+    # Realiza una petición general al estilo Faraday.
+    # El comportamiento (RPC o Fire-and-forget) depende de {#delivery_mode}.
+    #
+    # @param url [String] La ruta del recurso.
+    # @param args [Hash] Opciones de configuración.
+    # @yield [req] Bloque para configurar el objeto Request directamente.
+    def send(url, **args)
+      run_in_pool(url, args) do |req|
+        yield req if block_given?
+      end
+    end
+
     # Realiza una petición Síncrona (RPC / Request-Response).
     #
     # Envía un mensaje y bloquea la ejecución del hilo actual hasta recibir respuesta.
@@ -48,7 +64,8 @@ module BugBunny
     # @yield [req] Bloque para configurar el objeto Request directamente.
     # @return [Hash] La respuesta del servidor.
     def request(url, **args)
-      run_in_pool(:rpc, url, args) do |req|
+      send(url, **args) do |req|
+        req.delivery_mode = :rpc
         yield req if block_given?
       end
     end
@@ -60,7 +77,8 @@ module BugBunny
     # @yield [req] Bloque para configurar el objeto Request.
     # @return [void]
     def publish(url, **args)
-      run_in_pool(:fire, url, args) do |req|
+      send(url, **args) do |req|
+        req.delivery_mode = :publish
         yield req if block_given?
       end
     end
@@ -70,15 +88,16 @@ module BugBunny
     # Ejecuta la lógica de envío dentro del contexto del Pool.
     # Mapea los argumentos al objeto Request y ejecuta la cadena de middlewares.
     #
-    # @param method_name [Symbol] El método del productor a llamar (:rpc o :fire).
     # @param url [String] La ruta destino.
     # @param args [Hash] Argumentos pasados a los métodos públicos.
     # @yield [req] Bloque para configuración adicional del Request.
-    def run_in_pool(method_name, url, args)
+    def run_in_pool(url, args)
       # 1. Builder del Request
       req = BugBunny::Request.new(url)
 
       # 2. Syntactic Sugar: Mapeo de argumentos a atributos del Request
+      req.delivery_mode    = delivery_mode           # Default del cliente
+      req.delivery_mode    = args[:delivery_mode]    if args[:delivery_mode]
       req.method           = args[:method]           if args[:method]
       req.body             = args[:body]             if args[:body]
       req.exchange         = args[:exchange]         if args[:exchange]
@@ -101,6 +120,10 @@ module BugBunny
         producer = BugBunny::Producer.new(session)
 
         begin
+          # Mapeo de delivery_mode al método del productor (:rpc o :fire)
+          # :publish se mapea a :fire por consistencia interna.
+          method_name = req.delivery_mode == :publish ? :fire : :rpc
+
           # Onion Architecture: La acción final es llamar al Producer real.
           final_action = ->(env) { producer.send(method_name, env) }
 

data/lib/bug_bunny/request.rb

@@ -16,6 +16,7 @@ module BugBunny
   # @attr routing_key [String] La routing key específica. Si es nil, se usará {#path}.
   # @attr timeout [Integer] Tiempo máximo en segundos para timeout RPC.
   #
+  # @attr delivery_mode [Symbol] El modo de entrega (:rpc o :publish).
   # @attr exchange_options [Hash] Opciones específicas para la declaración del Exchange en esta petición.
   # @attr queue_options [Hash] Opciones específicas para la declaración de la Cola en esta petición.
   class Request
@@ -27,6 +28,7 @@ module BugBunny
     attr_accessor :exchange_type
     attr_accessor :routing_key
     attr_accessor :timeout
+    attr_accessor :delivery_mode
 
     # Configuración de Infraestructura Específica
     attr_accessor :exchange_options
@@ -48,12 +50,12 @@ module BugBunny
       @timestamp = Time.now.to_i
       @persistent = false
       @exchange_type = 'direct'
+      @delivery_mode = :rpc
 
       # Inicialización de opciones de infraestructura para evitar errores de nil durante el merge.
       @exchange_options = {}
       @queue_options = {}
     end
-
     # Calcula la Routing Key final que se usará en RabbitMQ.
     #
     # Principio: "Convention over Configuration".

data/lib/bug_bunny/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bug_bunny
 version: !ruby/object:Gem::Version
-  version: 4.0.1
+  version: 4.1.0
 platform: ruby
 authors:
 - gabix
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-03-13 00:00:00.000000000 Z
+date: 2026-03-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny