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

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.

Use cast(dict, event) for internal method calls that expect dict type
to satisfy mypy while maintaining zero runtime overhead.

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

Closes #7864

Co-authored-by: Leandro Damascena <[email protected]>

Author: Iamrodos

aws_lambda_powertools/event_handler/api_gateway.py

@@ -2461,7 +2461,7 @@ def register_resolver(func: AnyCallableT) -> AnyCallableT:
 
         return register_resolver
 
-    def resolve(self, event: dict[str, Any], context: LambdaContext) -> dict[str, Any]:
+    def resolve(self, event: Mapping[str, Any], context: LambdaContext) -> dict[str, Any]:
         """Resolves the response based on the provide event and decorator routes
 
         ## Internals
@@ -2514,10 +2514,10 @@ def resolve(self, event: dict[str, Any], context: LambdaContext) -> dict[str, An
             event = event.raw_event
 
         if self._debug:
-            print(self._serializer(event))
+            print(self._serializer(cast(dict, event)))
 
         # Populate router(s) dependencies without keeping a reference to each registered router
-        BaseRouter.current_event = self._to_proxy_event(event)
+        BaseRouter.current_event = self._to_proxy_event(cast(dict, event))
         BaseRouter.lambda_context = context
 
         response = self._resolve().build(self.current_event, self._cors)