feat(event-handler): add event handler registry

[svozza]

Summary

This PR creates the error handler registry class. It follows the same pattern as the route registry by exposing register and resolve methods. A very rudimentary integration with the BaseRouter class has also been done, the next PR will fully implement that integration.

Changes

• Created the ErrorHandlerRegistry class
• Added errorHandler() method to BaseRouter: Allows registration of error handlers for specific error types using the ErrorHandlerRegistry
• Integrated ErrorHandlerRegistry: BaseRouter now instantiates and manages an ErrorHandlerRegistry
• Added unit tests: Created tests for error handler registry and the base router integration

Issue number: #4141

---

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

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

[powertools-for-aws-oss-automation]

Not all issues are linked correctly.

Please link each issue to the PR either manually or using a closing keyword in the format fixes #<issue-number> format.

If mentioning more than one issue, separate them with commas: i.e. fixes #<issue-number-1>, closes #<issue-number-2>.

[dreamorosi]

For some reason Sonar is failing but there were findings (https://sonarcloud.io/project/issues?issueStatuses=OPEN%2CCONFIRMED&sinceLeakPeriod=true&pullRequest=4307&id=aws-powertools_powertools-lambda-typescript) usually making another commit fixes it, I think we can address these items and it'll work.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud

[svozza]

For some reason Sonar is failing but there were findings (https://sonarcloud.io/project/issues?issueStatuses=OPEN%2CCONFIRMED&sinceLeakPeriod=true&pullRequest=4307&id=aws-powertools_powertools-lambda-typescript) usually making another commit fixes it, I think we can address these items and it'll work.

Yeah, that fixed it!