feat(event_handler): add Cookie parameter support for OpenAPI utility

[leandrodamascena]

Issue number: closes #3691

Summary

Customers can now use cookies as typed, validated parameters in your API endpoints - just like Query(), Header(), or Form(). The OpenAPI schema generates in: cookie parameters, and validation works across all six resolver types.

Changes

Please provide a summary of what's being changed

User experience

from typing import Annotated
from aws_lambda_powertools.event_handler import APIGatewayRestResolver
from aws_lambda_powertools.event_handler.openapi.params import Cookie

app = APIGatewayRestResolver(enable_validation=True)

@app.get("/me")
def get_me(
    session_id: Annotated[str, Cookie(description="Session identifier")],
    theme: Annotated[str, Cookie(description="UI theme")] = "light",
):
    return {"session_id": session_id, "theme": theme}

Combining Cookie with Query and Header

from aws_lambda_powertools.event_handler.openapi.params import Cookie, Header, Query

@app.get("/dashboard")
def dashboard(
    session_id: Annotated[str, Cookie()],
    page: Annotated[int, Query()] = 1,
    x_request_id: Annotated[str, Header()] = "unknown",
):
    return {"session_id": session_id, "page": page, "x_request_id": x_request_id}

---

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.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.74%. Comparing base (ccdc52e) to head (2e224eb).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #8095   +/-   ##
========================================
  Coverage    96.73%   96.74%           
========================================
  Files          283      283           
  Lines        13881    13910   +29     
  Branches      1111     1116    +5     
========================================
+ Hits         13428    13457   +29     
  Misses         331      331           
  Partials       122      122           

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarQube Cloud