fix(event-handler): add overloads to route() for typed validation context

[svozza]

Summary

Router.route() did not correctly infer handler parameter types — when destructuring (e.g., {req}), TypeScript inferred any because the handler was typed as a union of RouteHandler | TypedRouteHandler. This adds overloads so the handler type is determined by whether validation is present in the options.

Changes

• Added two overloads to route(): without validation the handler receives RequestContext; with validation it receives TypedRequestContext (with the valid property)
• Extracted the implementation into a private #registerRoute method so internal callers bypass the public overloads
• Added unit tests for route() with validation and type-level tests

Issue number: closes #5051

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
27.4% Duplication on New Code

See analysis details on SonarQube Cloud

[dreamorosi]

Thanks for fixing this