refactor(event_handler): add type annotations for router decorators

[rafrafek]

Issue number: #3990

Summary

Adds type annotations for Api Gateway Router decorators to improve Pyright compatibility. Fixes Pyright error Untyped function decorator obscures type of function when used in "strict" type checking mode. May be helpful especially for VS Code users.

Changes

• Added type annotations for the return value of Api Gateway Router decorators.

User experience

• Before the change the decorators were showing errors in VS Code when Pylance/Pyright was set to "strict" mode.
• Now there are no errors

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

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.

[rafrafek]

Should I use AnyCallableT from aws_lambda_powertools/shared/types.py?

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.14%. Comparing base (811da57) to head (6470d2e).
Report is 2 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #5601   +/-   ##
========================================
  Coverage    96.14%   96.14%           
========================================
  Files          229      229           
  Lines        10854    10854           
  Branches      2018     2018           
========================================
  Hits         10436    10436           
  Misses         329      329           
  Partials        89       89           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

---

🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests

[leandrodamascena]

Hey @rafrafek! Thanks for sending this PR and sorry for delay in replying it.

Just a small comment about using an existing type instead of creating a new one. If it work, please import it under TYPE_CHECKING section.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud

[leandrodamascena]

Thanks a lot for addressing the feedback @rafrafek!

APPROVED!