feat(socket-handler): Add socket-handler support for custom socket handling in SmartProxy

changelog.md

@@ -1,5 +1,14 @@
 # Changelog
 
+## 2025-05-28 - 19.5.0 - feat(socket-handler)
+Add socket-handler support for custom socket handling in SmartProxy
+
+- Introduce new action type 'socket-handler' in IRouteAction to allow users to provide a custom socket handler function.
+- Update the RouteConnectionHandler to detect 'socket-handler' actions and invoke the handler with the raw socket, giving full control to the user.
+- Provide optional context (such as route configuration, client IP, and port) to the socket handler if needed.
+- Add helper functions in route-helpers for creating socket handler routes and common patterns like echo, proxy, and line-based protocols.
+- Include a detailed implementation plan and usage examples in readme.plan.md.
+
 ## 2025-05-28 - 19.4.3 - fix(smartproxy)
 Improve port binding intelligence and ACME challenge route management; update route configuration tests and dependency versions.