refactor(docs): atualizar rotas na documentação para usar sintaxe de parâmetros consistentes

Author: CAFernandes

docs/performance/DATABASE_PERFORMANCE.md

@@ -62,13 +62,13 @@ Comparando requisições diretas ao banco vs através do PivotPHP:
 Performance medida em requisições por segundo para APIs completas:
 
 ```
-GET /api/users/{id} (Simple SELECT)
+GET /api/users/:id (Simple SELECT)
 ├─ SQLite:     7,812 req/s
 ├─ MariaDB:    4,234 req/s
 ├─ MySQL:      4,123 req/s
 └─ PostgreSQL: 3,567 req/s
 
-GET /api/users/{id}/posts (JOIN)
+GET /api/users/:id/posts (JOIN)
 ├─ SQLite:     3,123 req/s
 ├─ PostgreSQL: 1,945 req/s
 ├─ MariaDB:    1,789 req/s

docs/releases/FRAMEWORK_OVERVIEW_v1.0.1.md

@@ -179,8 +179,8 @@ $app->get('/posts/:category<alpha>/:slug<slug>', handler);
 // Basic routing
 $app->get('/users', 'UserController@index');
 $app->post('/users', 'UserController@create');
-$app->put('/users/{id}', 'UserController@update');
-$app->delete('/users/{id}', 'UserController@delete');
+$app->put('/users/:id', 'UserController@update');
+$app->delete('/users/:id', 'UserController@delete');
 
 // Route groups
 $app->group('/api/v1', function ($group) {

docs/technical/http/openapi_documentation.md

@@ -13,7 +13,7 @@ use PivotPHP\Core\Utils\OpenApiExporter;
 $app = new Application();
 
 /**
- * @api GET /users/{id}
+ * @api GET /users/:id
  * @summary Buscar usuário por ID
  * @description Retorna os dados completos de um usuário específico
  * @param {integer} id.path.required - ID do usuário
@@ -65,7 +65,7 @@ $app->run();
 ```
 
 **Tipos de parâmetros:**
-- `path` - Parâmetros na URL (`/users/{id}`)
+- `path` - Parâmetros na URL (`/users/:id`)
 - `query` - Query strings (`?filter=value`)
 - `body` - Corpo da requisição
 - `header` - Headers HTTP
@@ -136,7 +136,7 @@ $app->get('/api/products', function($req, $res) {
 });
 
 /**
- * @api GET /api/products/{id}
+ * @api GET /api/products/:id
  * @summary Buscar produto específico
  * @description Retorna dados completos de um produto
  * @param {integer} id.path.required - ID do produto
@@ -185,7 +185,7 @@ $app->post('/api/products', function($req, $res) {
 });
 
 /**
- * @api PUT /api/products/{id}
+ * @api PUT /api/products/:id
  * @summary Atualizar produto
  * @description Atualiza dados de um produto existente
  * @param {integer} id.path.required - ID do produto
@@ -213,7 +213,7 @@ $app->put('/api/products/:id', function($req, $res) {
 });
 
 /**
- * @api DELETE /api/products/{id}
+ * @api DELETE /api/products/:id
  * @summary Deletar produto
  * @description Remove um produto do sistema
  * @param {integer} id.path.required - ID do produto
@@ -360,7 +360,7 @@ $docs = OpenApiExporter::export($app, [
 ### **API com Upload de Arquivo**
 ```php
 /**
- * @api POST /api/products/{id}/image
+ * @api POST /api/products/:id/image
  * @summary Upload de imagem do produto
  * @description Faz upload da imagem principal do produto
  * @param {integer} id.path.required - ID do produto

src/Http/Response.php

@@ -226,10 +226,12 @@ public function json(mixed $data): self
         } else {
             // Usar encoding tradicional para dados pequenos
             $encoded = json_encode($sanitizedData, self::JSON_ENCODE_FLAGS);
-            if ($encoded === false) {
-                error_log('JSON encoding failed: ' . json_last_error_msg());
-                $encoded = '{}';
-            }
+        }
+
+        // Handle JSON encoding failures for both pooling and traditional paths
+        if ($encoded === false) {
+            error_log('JSON encoding failed: ' . json_last_error_msg());
+            $encoded = '{}';
         }
 
         $this->body = $encoded;
@@ -800,21 +802,16 @@ private function shouldUseJsonPooling(mixed $data): bool
     /**
      * Codifica JSON usando pooling para melhor performance
      */
-    private function encodeWithPooling(mixed $data): string
+    private function encodeWithPooling(mixed $data): string|false
     {
         try {
             return JsonBufferPool::encodeWithPool($data, self::JSON_ENCODE_FLAGS);
         } catch (\Throwable $e) {
             // Fallback para encoding tradicional em caso de erro
             error_log('JSON pooling failed, falling back to traditional encoding: ' . $e->getMessage());
 
-            $encoded = json_encode($data, self::JSON_ENCODE_FLAGS);
-            if ($encoded === false) {
-                error_log('JSON encoding failed: ' . json_last_error_msg());
-                return '{}';
-            }
-
-            return $encoded;
+            // Fallback to traditional encoding (let caller handle JSON encoding failures)
+            return json_encode($data, self::JSON_ENCODE_FLAGS);
         }
     }
 }

tests/Json/JsonPoolingThresholdsTest.php

@@ -30,9 +30,10 @@ protected function tearDown(): void
      */
     public function testPoolingConstantsExist(): void
     {
-        $this->assertTrue(defined('PivotPHP\Core\Json\Pool\JsonBufferPool::POOLING_ARRAY_THRESHOLD'));
-        $this->assertTrue(defined('PivotPHP\Core\Json\Pool\JsonBufferPool::POOLING_OBJECT_THRESHOLD'));
-        $this->assertTrue(defined('PivotPHP\Core\Json\Pool\JsonBufferPool::POOLING_STRING_THRESHOLD'));
+        $reflection = new \ReflectionClass(JsonBufferPool::class);
+        $this->assertTrue($reflection->hasConstant('POOLING_ARRAY_THRESHOLD'));
+        $this->assertTrue($reflection->hasConstant('POOLING_OBJECT_THRESHOLD'));
+        $this->assertTrue($reflection->hasConstant('POOLING_STRING_THRESHOLD'));
 
         // Verify values are reasonable
         $this->assertEquals(10, JsonBufferPool::POOLING_ARRAY_THRESHOLD);