Update

Author: localzet

src/pages/features.mdx

@@ -67,3 +67,20 @@ Localzet Server под HHVM демонстрирует увеличение пр
 ### 15. Поддержка прослушивания нескольких портов
 
 ### 16. Поддержка перенаправления стандартных ввода-вывода
+
+### 17. Улучшенная типизация и безопасность
+
+Localzet Server постоянно улучшается для обеспечения максимальной безопасности и надежности:
+
+- **Строгая типизация** - все методы имеют явные типы возвращаемых значений и параметров
+- **Валидация входных данных** - все входные данные проверяются перед использованием
+- **Безопасная обработка конфигурации** - устранены небезопасные практики (например, использование `extract()`)
+- **Улучшенная обработка ошибок** - корректная обработка всех граничных случаев
+- **Константы вместо магических чисел** - улучшенная читаемость и поддерживаемость кода
+
+<Button
+    href="/changelog"
+    variant="text"
+    arrow="right"
+    children="Подробнее о технических улучшениях"
+/>

src/pages/must-read.mdx

@@ -37,6 +37,18 @@ Localzet Server сам по себе является контейнером, а
 Оператор `sleep` приостанавливает выполнение всего процесса, во время которого не выполняется никаких бизнес-операций, и работа фреймворка также останавливается,
 что приводит к тому, что все запросы клиентов этого процесса остаются без обработки!
 
+**Важно:** Для приостановки выполнения используйте `Timer::sleep()` вместо `sleep()`, который работает асинхронно и не блокирует обработку других запросов:
+
+```php
+use localzet\Timer;
+
+// Правильно - асинхронная задержка
+Timer::sleep(1.0); // Приостановка на 1 секунду без блокировки процесса
+
+// Неправильно - блокирует весь процесс
+sleep(1);
+```
+
 **6. Не используйте функцию `pcntl_fork`**
 
 Функция `pcntl_fork` используется для динамического создания новых процессов.

src/pages/protocols/custom.mdx

@@ -40,13 +40,15 @@ class SuperJSON
      * Если можно получить длину пакета в $recv_buffer, возвращается длина всего пакета
      * В противном случае возвращается 0, что означает, что необходимо дождаться дополнительных данных.
      * Если возникает ошибка в протоколе, можно вернуть false, что приведет к разрыву соединения с текущим клиентом
-     * @param string $recv_buffer
-     * @return int
+     * 
+     * @param string $recv_buffer Буфер полученных данных
+     * @param \localzet\Server\Connection\ConnectionInterface $connection Соединение с клиентом
+     * @return int|false Длина пакета, 0 если данных недостаточно, false при ошибке
      */
-    public static function input($recv_buffer)
+    public static function input(string $recv_buffer, \localzet\Server\Connection\ConnectionInterface $connection): int|false
     {
         // Получение позиции символа переноса строки "\n"
-        $pos = strpos($buffer, "\n");
+        $pos = strpos($recv_buffer, "\n");
 
         // Если его нет - невозможно получить длину пакета, вернуть 0 и ожидать дополнительных данных
         if($pos === false)
@@ -60,25 +62,33 @@ class SuperJSON
 
     /**
      * Упаковка, автоматически вызывается при отправке данных клиенту
-     * @param string $buffer
-     * @return string
+     * 
+     * @param mixed $data Данные для отправки
+     * @param \localzet\Server\Connection\ConnectionInterface $connection Соединение с клиентом
+     * @return string Закодированные данные для отправки
      */
-    public static function encode($buffer)
+    public static function encode(mixed $data, \localzet\Server\Connection\ConnectionInterface $connection): string
     {
         // Формирование JSON и добавление символа переноса строки в качестве пометки окончания запроса
-        return json_encode($buffer) . "\n";
+        return json_encode($data, JSON_THROW_ON_ERROR) . "\n";
     }
 
     /**
      * Разбор, автоматически вызывается, когда количество полученных байтов равно возвращенному значению input (значение больше 0)
      * и передается как параметр $data в обратный вызов onMessage
-     * @param string $buffer
-     * @return string
+     * 
+     * @param string $buffer Буфер данных для декодирования
+     * @param \localzet\Server\Connection\ConnectionInterface $connection Соединение с клиентом
+     * @return mixed Декодированные данные
      */
-    public static function decode($buffer)
+    public static function decode(string $buffer, \localzet\Server\Connection\ConnectionInterface $connection): mixed
     {
         // Удаление символа переноса строки и превращение в массив
-        return json_decode(trim($buffer), true);
+        $decoded = json_decode(trim($buffer), true);
+        if (json_last_error() !== JSON_ERROR_NONE) {
+            throw new \RuntimeException('Ошибка декодирования JSON: ' . json_last_error_msg());
+        }
+        return $decoded;
     }
 }
 ```