bug_bunny 4.10.2 → 4.10.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08e0d33ac09d046d3de52d3d7f75b7b87df8d6e96f495ab37c7433fe9f4add33'
-  data.tar.gz: '09373953a7dc292c97363e3514f9e3db1b9b041527a9e26e09e52089abfda0b9'
+  metadata.gz: 31a6f6e9b83b1a82216f344a101ca0a99daebb5fd9e44bf5abc9c9e9753f4011
+  data.tar.gz: f101254aad9d8bbd66a359438a1efe970acd58e4b853841bcda72966c2472c8c
 SHA512:
-  metadata.gz: 34799b71420bb76ca71439e80d5b27a5d2ed38f424b16ba914b85566c5277279d3f4e1743caa4f2e8d932d125ceb019479add38df49573ab42880ef103cf1c34
-  data.tar.gz: 7b8cceae4b29ff12e9e42fc51ee3b68ec5a1ae92122a91f35c6bb132f09edf1b5171785ef6494d3580e86da715218f1602f2ef8071a2e9b77b0e0123c28795ff
+  metadata.gz: 6b8a42f884ae9c8075dab9e4052658a5c0828cae904800fe222fd058cdaf3cd1307bba6478ca7824e273a517484d71da0416fd3b7c38bb08a9a0845e39dacb90
+  data.tar.gz: 6de916fae62566f01142b557b6e6c4ed4cf44d58298d9ff3c174e8d38b4422238487dacd29f273d7b3ea356d30f8c08a5c5a872f9ed08f6cacb8a540511a933a

data/README.md

@@ -228,6 +228,57 @@ Las claves sensibles (`password`, `token`, `secret`, `api_key`, `authorization`,
 
 ---
 
+## Error Handling
+
+BugBunny maps RabbitMQ responses to a semantic exception hierarchy, similar to how HTTP clients handle status codes.
+
+### Exception Hierarchy
+
+```
+BugBunny::Error
+├── ClientError (4xx)
+│   ├── BadRequest (400)
+│   ├── NotFound (404)
+│   ├── NotAcceptable (406)
+│   ├── RequestTimeout (408)
+│   ├── Conflict (409)
+│   └── UnprocessableEntity (422)
+└── ServerError (5xx)
+    ├── InternalServerError (500+)
+    └── RemoteError (500)
+```
+
+### Remote Exception Propagation
+
+When a controller raises an unhandled exception, BugBunny serializes it and sends it back to the caller as a 500 response. The client-side middleware reconstructs it as a `BugBunny::RemoteError` with full access to the original exception details:
+
+```ruby
+begin
+  node = RemoteNode.find('node-123')
+rescue BugBunny::RemoteError => e
+  e.original_class     # => "TypeError"
+  e.original_message   # => "nil can't be coerced into Integer"
+  e.original_backtrace # => Array<String> from the remote service
+rescue BugBunny::NotFound
+  # Resource doesn't exist
+rescue BugBunny::RequestTimeout
+  # Consumer didn't respond in time
+end
+```
+
+### Validation Errors
+
+`Resource#save` returns `false` on validation failure and loads remote errors into the model:
+
+```ruby
+order = RemoteOrder.new(total: -1)
+unless order.save
+  order.errors.full_messages # => ["total must be greater than 0"]
+end
+```
+
+---
+
 ## Documentation
 
 - [Concepts](docs/concepts.md) — What BugBunny is, AMQP in 5 minutes, RPC vs fire-and-forget

data/lib/bug_bunny/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BugBunny
-  VERSION = '4.10.2'
+  VERSION = '4.10.3'
 end

data/lib/bug_bunny.rb

@@ -83,7 +83,12 @@ module BugBunny
   # @raise [Bunny::TCPConnectionFailed] Si no se puede conectar al servidor.
   def self.create_connection(**options)
     conn_options = merge_connection_options(options)
-    Bunny.new(conn_options).tap(&:start)
+    Bunny.new(conn_options).tap do |conn|
+      conn.after_recovery_completed do
+        safe_log(:info, 'bug_bunny.connection_recovered', host: conn_options[:host])
+      end
+      conn.start
+    end
   end
 
   # Cierra la conexión global si existe.

data/skill/SKILL.md

@@ -238,6 +238,10 @@ No registrar consumer middlewares durante la ejecución de `call()`. El stack to
 **Causa:** Fallo de validación en el servicio remoto.
 **Resolución:** `resource.save` devuelve `false`. Acceder a `resource.errors` o `rescue` con `e.error_messages`.
 
+### BugBunny::RemoteError (500)
+**Causa:** Excepción no manejada en el controller remoto. Se serializa y propaga al cliente RPC con clase, mensaje y backtrace originales.
+**Resolución:** `rescue BugBunny::RemoteError => e` y acceder a `e.original_class`, `e.original_message`, `e.original_backtrace`. Revisar logs del consumer (`event=controller.unhandled_exception`).
+
 ### BugBunny::CommunicationError
 **Causa:** Fallo de conexión o reconexión agotada.
 **Resolución:** Verificar conectividad a RabbitMQ. Revisar `max_reconnect_attempts` y logs de reconexión.

data/skill/references/errores.md

@@ -86,18 +86,36 @@ end
 
 ### BugBunny::RemoteError (500)
 **Causa:** Excepción no manejada en el controller remoto. El error se serializa y propaga al cliente RPC.
+
+**Flujo completo:**
+1. El controller remoto lanza una excepción (ej: `TypeError`).
+2. `BugBunny::Controller#handle_exception` la captura y serializa con `RemoteError.serialize(exception)` → `{ class:, message:, backtrace: }` (máx 25 líneas).
+3. El consumer responde con status 500 y el campo `bug_bunny_exception` en el body.
+4. El middleware `RaiseError` del cliente detecta `bug_bunny_exception`, reconstituye un `BugBunny::RemoteError` y lo lanza localmente.
+
 **Acceso a detalles:**
 ```ruby
+# Con Client directo
+begin
+  client.request('users/42', method: :get)
+rescue BugBunny::RemoteError => e
+  e.original_class     # => "TypeError"
+  e.original_message   # => "nil can't be coerced into Integer"
+  e.original_backtrace # => Array<String> (backtrace del servicio remoto)
+  e.to_s               # => "BugBunny::RemoteError(TypeError): nil can't be coerced into Integer"
+end
+
+# Con Resource ORM
 begin
-  client.request('users/42')
+  RemoteNode.find('node-123')
 rescue BugBunny::RemoteError => e
-  e.original_class     # String: clase original (ej: "TypeError")
-  e.original_message  # String: mensaje original
-  e.original_backtrace # Array<String>: backtrace original
+  Rails.logger.error("Remote #{e.original_class}: #{e.original_message}")
 end
 ```
-**Serialización:** El controller captura excepciones con `rescue_from` → `handle_exception` → serializa con clase, mensaje y primeras 25 líneas del backtrace.
-**Propagación:** El middleware `RaiseError` del cliente reconstituye `RemoteError` y la lanza localmente.
+
+**Compatibilidad:** Si la respuesta 500 no contiene `bug_bunny_exception` (ej: servicio remoto con versión anterior de BugBunny), se lanza `BugBunny::InternalServerError` en su lugar.
+
+**Herencia:** `RemoteError < ServerError < Error < StandardError`. Se puede capturar con `rescue BugBunny::ServerError` para atrapar tanto `RemoteError` como `InternalServerError`.
 
 ## Formato de Mensajes de Error
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bug_bunny
 version: !ruby/object:Gem::Version
-  version: 4.10.2
+  version: 4.10.3
 platform: ruby
 authors:
 - gabix
@@ -303,7 +303,7 @@ metadata:
   homepage_uri: https://github.com/gedera/bug_bunny
   source_code_uri: https://github.com/gedera/bug_bunny
   changelog_uri: https://github.com/gedera/bug_bunny/blob/main/CHANGELOG.md
-  documentation_uri: https://github.com/gedera/bug_bunny/blob/v4.10.2/skill
+  documentation_uri: https://github.com/gedera/bug_bunny/blob/v4.10.3/skill
 post_install_message:
 rdoc_options: []
 require_paths: