fix: atualizar links de documentação para refletir nova URL

refactor(JsonBufferPool): tornar constantes de limite de array públicas
test: corrigir testes para validar constantes de limite de array

Author: CAFernandes

docs/releases/FRAMEWORK_OVERVIEW_v1.0.0.md

@@ -550,7 +550,7 @@ composer phpstan
 ### Official Links
 - **GitHub**: https://github.com/PivotPHP/pivotphp-core
 - **Packagist**: https://packagist.org/packages/pivotphp/core
-- **Documentation**: https://docs.pivotphp.com
+- **Documentation**: https://pivotphp.github.io/website/docs/
 - **Community**: https://discord.gg/pivotphp
 
 ### Extensions

docs/releases/FRAMEWORK_OVERVIEW_v1.0.1.md

@@ -624,7 +624,7 @@ composer phpstan
 ### Official Links
 - **GitHub**: https://github.com/PivotPHP/pivotphp-core
 - **Packagist**: https://packagist.org/packages/pivotphp/core
-- **Documentation**: https://docs.pivotphp.com
+- **Documentation**: https://pivotphp.github.io/website/docs/
 - **Community**: https://discord.gg/pivotphp
 
 ### Extensions

src/Http/Response.php

@@ -226,12 +226,12 @@ public function json(mixed $data): self
         } else {
             // Usar encoding tradicional para dados pequenos
             $encoded = json_encode($sanitizedData, self::JSON_ENCODE_FLAGS);
-        }
 
-        // Handle JSON encoding failures for both pooling and traditional paths
-        if ($encoded === false) {
-            error_log('JSON encoding failed: ' . json_last_error_msg());
-            $encoded = '{}';
+            // Handle JSON encoding failures for traditional path
+            if ($encoded === false) {
+                error_log('JSON encoding failed: ' . json_last_error_msg());
+                $encoded = '{}';
+            }
         }
 
         $this->body = $encoded;
@@ -802,16 +802,21 @@ private function shouldUseJsonPooling(mixed $data): bool
     /**
      * Codifica JSON usando pooling para melhor performance
      */
-    private function encodeWithPooling(mixed $data): string|false
+    private function encodeWithPooling(mixed $data): string
     {
         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());
 
-            // Fallback to traditional encoding (let caller handle JSON encoding failures)
-            return json_encode($data, self::JSON_ENCODE_FLAGS);
+            // Fallback to traditional encoding (handle JSON encoding failures internally)
+            $encoded = json_encode($data, self::JSON_ENCODE_FLAGS);
+            if ($encoded === false) {
+                error_log('JSON fallback encoding failed: ' . json_last_error_msg());
+                return '{}';
+            }
+            return $encoded;
         }
     }
 }

src/Json/Pool/JsonBufferPool.php

@@ -24,9 +24,9 @@ class JsonBufferPool
     private const XLARGE_ARRAY_SIZE = 32768;         // XLarge array estimate (>= 1000 items)
 
     // Array size thresholds
-    private const SMALL_ARRAY_THRESHOLD = 10;        // Threshold for small array
-    private const MEDIUM_ARRAY_THRESHOLD = 100;      // Threshold for medium array
-    private const LARGE_ARRAY_THRESHOLD = 1000;     // Threshold for large array
+    public const SMALL_ARRAY_THRESHOLD = 10;        // Threshold for small array
+    public const MEDIUM_ARRAY_THRESHOLD = 100;      // Threshold for medium array
+    public const LARGE_ARRAY_THRESHOLD = 1000;     // Threshold for large array
 
     // Object size estimation constants
     private const OBJECT_PROPERTY_OVERHEAD = 50;     // Bytes per object property

tests/Json/Pool/JsonSizeEstimationTest.php

@@ -173,8 +173,14 @@ public function testConstantsAreReasonable(): void
         $this->assertLessThan(32768, 8192);     // LARGE < XLARGE
 
         // Test threshold constants are in ascending order
-        $this->assertLessThan(100, 10);         // SMALL < MEDIUM threshold
-        $this->assertLessThan(1000, 100);       // MEDIUM < LARGE threshold
+        $this->assertLessThan(
+            JsonBufferPool::MEDIUM_ARRAY_THRESHOLD,
+            JsonBufferPool::SMALL_ARRAY_THRESHOLD
+        ); // SMALL < MEDIUM threshold
+        $this->assertLessThan(
+            JsonBufferPool::LARGE_ARRAY_THRESHOLD,
+            JsonBufferPool::MEDIUM_ARRAY_THRESHOLD
+        ); // MEDIUM < LARGE threshold
 
         // Test overhead constants are reasonable
         $this->assertGreaterThan(0, 20);        // STRING_OVERHEAD > 0