fix: Melhorar mensagens de erro para manipuladores de rota inválidos e garantir codificação JSON segura

Author: code-cfernandes

src/Core/Application.php

@@ -613,7 +613,7 @@ public function handle(?Request $request = null): Response
                 // Buscar rotas disponíveis para suggestions
                 $availableRoutes = array_map(
                     fn($r) => "{$r['method']} {$r['path']}",
-                    array_slice($this->router::getAllRoutes(), 0, 10)
+                    array_slice($this->router::getRoutes(), 0, 10)
                 );
 
                 throw ContextualException::routeNotFound(

src/Exceptions/Enhanced/ContextualException.php

@@ -113,7 +113,8 @@ private function generateDebugInfo(): void
     private function formatValue(mixed $value): string
     {
         if (is_array($value)) {
-            return json_encode($value, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+            $result = json_encode($value, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
+            return $result !== false ? $result : 'Array (unable to encode)';
         }
 
         if (is_object($value)) {
@@ -128,7 +129,7 @@ private function formatValue(mixed $value): string
             return 'null';
         }
 
-        return (string) $value;
+        return is_scalar($value) ? (string) $value : gettype($value);
     }
 
     /**

src/Json/Pool/JsonBufferPool.php

@@ -147,7 +147,11 @@ public static function encodeWithPool(
     ): string {
         // Usar threshold inteligente - para dados pequenos, json_encode é mais rápido
         if (!self::shouldUsePooling($data)) {
-            return json_encode($data, $flags);
+            $result = json_encode($data, $flags);
+            if ($result === false) {
+                throw new \JsonException('JSON encoding failed: ' . json_last_error_msg());
+            }
+            return $result;
         }
 
         $optimalCapacity = self::getOptimalCapacity($data);

src/Utils/CallableResolver.php

@@ -89,6 +89,7 @@ private static function resolveArrayCallable(array $handler): callable
                 );
             }
 
+            /** @var callable */
             return [$objectOrClass, $method];
         }
 
@@ -110,6 +111,7 @@ private static function resolveArrayCallable(array $handler): callable
                 );
             }
 
+            /** @var callable */
             return [$objectOrClass, $method];
         }
 

tests/Unit/Routing/ArrayCallableTest.php

@@ -194,7 +194,7 @@ function ($req, $res) {
     public function testInvalidArrayCallable(): void
     {
         $this->expectException(\InvalidArgumentException::class);
-        $this->expectExceptionMessage('Handler must be a callable function');
+        $this->expectExceptionMessage('Route handler validation failed: Method');
 
         // Try to register an invalid callable
         Router::get('/invalid', [$this->controller, 'nonExistentMethod']);
@@ -206,7 +206,7 @@ public function testInvalidArrayCallable(): void
     public function testInvalidStaticCallable(): void
     {
         $this->expectException(\InvalidArgumentException::class);
-        $this->expectExceptionMessage('Handler must be a callable function');
+        $this->expectExceptionMessage('Route handler validation failed: Static method');
 
         // Try to register an invalid static callable
         Router::get('/invalid', [TestController::class, 'nonExistentStaticMethod']);