bug_bunny 3.1.5 → 3.1.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a96d4e81fd57e9a1a524aa479bbb85d6fe3a99bd654da95014f633d2fb0cb2d2
-  data.tar.gz: cb49f5e1789c1737572fb98b2d21428cf02c129c33e3049de1a0de4f6270a9d3
+  metadata.gz: 7fec9f487076682121e6d8586e44fe9d70f380bd809fb46014265105421a0d8f
+  data.tar.gz: e847fc6f1943f9921f2250a46a20bd6f76b20736812fcbf6bfc437ab49a8a30c
 SHA512:
-  metadata.gz: ea0ae037590a852734607ad7e46fabff4cfab87aef068a724da42d506fc79ccda376d0db85f0d4ebd1f516ac2aef963fcdd18604a6d808efb3e4e2de0ca32391
-  data.tar.gz: 6930cc1f181bc7d6968cb4fe3ed82f25cb59650522f45c5ad5e6f9328cc33125bc41d197de35f05f16e1126014ea7ada86cb2d6a348e7c4e0b6a4c8e56a61a7a
+  metadata.gz: 199faaa596f52cc1c192259e8fe3e7da95152d117db9ded079051bebdff985793e63acde11cb8ceed5e0e216d6934ff35056993947609f2818d8429f524a789a
+  data.tar.gz: dfefdd78b4597f90dc059ef07d7423dda86d2630cdab409c514941708cc539d174a763d1a6e18c918dee7058d25c0a996aac0bb52f1b440573b42480e723e284

data/CHANGELOG.md

@@ -1,4 +1,12 @@
 # Changelog
+## [3.1.6] - 2026-02-27
+
+### 🐛 Bug Fixes & Router Improvements
+* **Enhanced Heuristic Router (ID Detection):** Mejoras críticas en `Consumer#router_dispatch` para soportar una gama mucho más amplia de formatos de identificadores y evitar colisiones con namespaces:
+  * **Soporte para Swarm/NanoID:** Se amplió la expresión regular de detección de IDs para capturar hashes alfanuméricos de 20 o más caracteres (`[a-zA-Z0-9_-]{20,}`), permitiendo el correcto ruteo de IDs generados por Docker Swarm (25 caracteres) o NanoID.
+  * **Escaneo Inverso (Right-to-Left):** Se modificó la búsqueda del ID para que escanee los segmentos de la URL desde el final hacia el principio (`rindex`). Esto evita falsos positivos donde namespaces cortos como `v1` (ej. `api/v1/...`) eran confundidos accidentalmente con un ID.
+  * **Fallback Semántico Posicional:** Se introdujo una red de seguridad (fallback) que infiere la posición del ID basándose en el Verbo HTTP. Si el ID no coincide con ningún patrón Regex (ej. es un ID corto como `node-1`), pero el método es `PUT`, `PATCH` o `DELETE`, el enrutador ahora asume inteligentemente que el penúltimo/último segmento corresponde al ID del recurso.
+
 ## [3.1.5] - 2026-02-25
 
 ### ✨ New Features & Improvements

data/lib/bug_bunny/consumer.rb

@@ -180,7 +180,7 @@ module BugBunny
     # Interpreta la URL y el verbo para decidir qué controlador ejecutar.
     #
     # Implementa un Router Heurístico que soporta namespaces y acciones custom
-    # buscando dinámicamente el ID en la ruta.
+    # buscando dinámicamente el ID en la ruta mediante Regex y Fallback Semántico.
     #
     # @param method [String] Verbo HTTP (GET, POST, etc).
     # @param path [String] URL virtual del recurso (ej: 'foo/bar/algo/13/test').
@@ -196,30 +196,49 @@ module BugBunny
 
       # 1. Acción Built-in: Health Check Global (/up o /api/up)
       if segments.last == 'up' && method.to_s.upcase == 'GET'
-        # Si la ruta es solo 'up', usamos un controlador genérico 'application'
         ctrl = segments.size > 1 ? segments[0...-1].join('/') : 'application'
         return { controller: ctrl, action: 'up', id: nil, params: query_params }
       end
 
-      # 2. Búsqueda dinámica del ID (Heurística)
-      # Patrón: Números enteros, UUIDs, o hashes alfanuméricos largos (MongoDB/Snowflake)
-      id_pattern = /^(?:\d+|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|[0-9a-fA-F]{24})$/
-      id_index = segments.find_index { |s| s.match?(id_pattern) }
+      # 2. Búsqueda dinámica del ID (Heurística por Regex)
+      # Patrón: Enteros, UUIDs, o Hashes largos (Docker Swarm 25 chars, Mongo 24 chars)
+      id_pattern = /^(?:\d+|[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}|[a-zA-Z0-9_-]{20,})$/
 
+      # FIX: Usamos rindex (de derecha a izquierda) para evitar falsos positivos con namespaces como 'v1'
+      id_index = segments.rindex { |s| s.match?(id_pattern) }
+
+      # 3. Fallback Semántico Posicional
+      # Si el regex no detectó el ID (ej: ID corto como "node-1"), pero la semántica HTTP
+      # indica que es una operación singular (PUT/DELETE/GET), asumimos que el último segmento es el ID.
+      if id_index.nil? && segments.size >= 2
+        last_segment = segments.last
+        method_up = method.to_s.upcase
+
+        is_member_verb = %w[PUT PATCH DELETE].include?(method_up)
+        # En GET, nos aseguramos que la última palabra no sea una acción estándar de REST
+        is_get_member = method_up == 'GET' && !%w[index new edit up action].include?(last_segment)
+
+        if is_member_verb || is_get_member
+          # Si tiene 3 o más segmentos (ej. nodes/node-1/stats), el ID no está al final.
+          # Este fallback asume que para IDs raros, el formato clásico es recurso/id
+          id_index = segments.size - 1
+        end
+      end
+
+      # 4. Asignación de variables según escenario
       if id_index
-        # ESCENARIO A: Ruta Miembro (ej. foo/bar/algo/13/test)
-        # Todo lo que está antes del ID es el namespace/controlador
-        controller_name = segments[0...id_index].join('/') # "foo/bar/algo"
-        id = segments[id_index]                            # "13"
-        action = segments[id_index + 1]                    # "test" (puede ser nil)
+        # ESCENARIO A: Ruta Miembro (ej. nodes/4bv445vgc158hk4twlxmdjo0v/stats)
+        controller_name = segments[0...id_index].join('/')
+        id = segments[id_index]
+        action = segments[id_index + 1] # Puede ser nil si no hay acción extra al final
       else
-        # ESCENARIO B: Ruta Colección (ej. foo/bar/algo o api/v1/users)
+        # ESCENARIO B: Ruta Colección (ej. api/v1/nodes)
         controller_name = segments.join('/')
         id = nil
         action = nil
       end
 
-      # 3. Inferimos la acción si no hay una explícita en la ruta
+      # 5. Inferimos la acción clásica de Rails si no hay una explícita
       unless action
         action = case method.to_s.upcase
                  when 'GET' then id ? 'show' : 'index'
@@ -230,7 +249,7 @@ module BugBunny
                  end
       end
 
-      # 4. Inyectamos el ID en los parámetros para que el Controller lo tenga fácil
+      # 6. Inyectamos el ID en los parámetros para fácil acceso en el Controlador
       query_params['id'] = id if id
 
       { controller: controller_name, action: action, id: id, params: query_params }

data/lib/bug_bunny/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bug_bunny
 version: !ruby/object:Gem::Version
-  version: 3.1.5
+  version: 3.1.6
 platform: ruby
 authors:
 - gabix
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-25 00:00:00.000000000 Z
+date: 2026-02-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bunny