fix(typing): accept Mapping type in resolve() for event parameter

[Iamrodos]

Changes

Change resolve() event parameter type hint from dict[str, Any] to Mapping[str, Any] to allow Powertools event data classes (e.g., LambdaFunctionUrlEvent) to be passed without type errors.

This is backwards compatible since dict is a subtype of Mapping.

User experience

Before:
error: Argument of type "LambdaFunctionUrlEvent" cannot be assigned to parameter "event" of type "dict[str, Any]"
1 error, 0 warnings, 0 informations

After:
0 errors, 0 warnings, 0 informations

Validation

Test file used to validate the fix with uv run pyright test_typing_issue.py:

from typing import Any

from aws_lambda_powertools.event_handler import LambdaFunctionUrlResolver
from aws_lambda_powertools.utilities.data_classes import LambdaFunctionUrlEvent
from aws_lambda_powertools.utilities.typing import LambdaContext

app = LambdaFunctionUrlResolver()

@app.get("/")
def home():
    return {"message": "Hello"}

# Test 1: Using Powertools event data class (recommended pattern from docs)
# BEFORE FIX: pyright error
# AFTER FIX: passes (0 errors)
def handler_with_event_class(event: LambdaFunctionUrlEvent, context: LambdaContext) -> dict:
    return app.resolve(event, context)

# Test 2: Using plain dict (backwards compatibility)
# BEFORE FIX: passes
# AFTER FIX: passes (dict is a subtype of Mapping)
def handler_with_dict(event: dict[str, Any], context: LambdaContext) -> dict:
    return app.resolve(event, context)

Issue number: closes #7864

---

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

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 96.54%. Comparing base (c553712) to head (06068a4).
⚠️ Report is 1 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #7909   +/-   ##
========================================
  Coverage    96.54%   96.54%           
========================================
  Files          275      275           
  Lines        13199    13199           
  Branches      1002     1002           
========================================
  Hits         12743    12743           
  Misses         353      353           
  Partials       103      103           

☔ 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
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[leandrodamascena]

Thanks for sending this PR @Iamrodos! APPROVED!