Handshake и обработка сообщений
До upgrade
Server передаёт HTTP Upgrade-запрос callback-у Engine WS. Адаптер сохраняет Triangle Request в контексте соединения, проверяет URI и сопоставляет GET-маршрут. Маршрутное middleware выполняется во время handshake, поэтому может разрешить upgrade или вернуть HTTP-ошибку. Сам обработчик сообщения на этой стадии не вызывается.
Если путь не найден, метод не разрешён или middleware отклоняет handshake, Engine WS закрывает HTTP-соединение с соответствующим статусом. Используйте этот этап для проверки полномочий и origin до открытия WebSocket-сессии.
После upgrade
На входящем frame адаптер ставит текущее соединение и сохранённый Request в Engine Context. Payload frame доступен как Request::ws_buffer; callback маршрута вызывается после получения сообщения. Контекст запроса и соединения удаляется в finally после обработки.
use Triangle\Router;
use Triangle\Ws\App;
Router::any('/echo', static fn () => 'echo:' . (App::request()?->ws_buffer ?? ''));
Router::collect([]);
Строковый результат отправляется как тело frame. Если callback вернул HTTP Response, в WebSocket frame передаётся только его body; HTTP status и headers не являются частью frame.
Рассылка и завершение
Методы sendToAll и sendToGroup используют соединения, известные текущему процессу. Для межпроцессной рассылки подключите брокер или отдельный IPC-слой. Приложение должно явно задавать политику reconnect, подтверждения доставки и дедупликации, если они нужны.

