APIGatewayProxyEventV2: Headers Property in BaseProxyEvent Returns Incorrect Type

[adriamontoto]

Describe the bug

In the AWS CDK, the BaseProxyEvent class, which is the parent class of APIGatewayProxyEventV2, contains a property headers that is supposed to return a dictionary. However, when using the APIGatewayProxyEventV2 class, the headers property returns a string instead of a dictionary, which is inconsistent with the documented behavior of BaseProxyEvent.

class BaseProxyEvent(DictWrapper):
    @property
    def headers(self) -> Dict[str, str]:
        return self.get("headers") or {}

Expected Behavior

The headers property of the BaseProxyEvent class (and its subclass APIGatewayProxyEventV2) should return a dictionary as per its property definition and documentation.

request = APIGatewayProxyEventV2(data=event)
print(type(request.headers))  # Expected: <class 'dict'>

Current Behavior

The headers property of the APIGatewayProxyEventV2 class returns a string instead of a dictionary.

request = APIGatewayProxyEventV2(data=event)
print(type(request.headers))  # Actual: <class 'str'>

Reproduction Steps

Create a lambda function (with the following code) that is triggered by a gateway endpoint (Proxy integration).

from aws_lambda_powertools.utilities.data_classes import APIGatewayProxyEventV2

def lambda_handler(event, context):
      request= APIGatewayProxyEventV2(data=event)
      print(type(request.headers)) 

Possible Solution

No response

Additional Information/Context

No response

CDK CLI Version

2.128.0 (build d995261)

Framework Version

No response

Node.js Version

10.8.1

OS

Windows 11

Language

Python

Language Version

3.11.9

Other information

No response

[github-actions]

⚠️COMMENT VISIBILITY WARNING⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.

[github-actions]

⚠️COMMENT VISIBILITY WARNING⚠️

Comments on closed issues are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.

[aws-cdk-automation]

Comments on closed issues and PRs are hard for our team to see. If you need help, please open a new issue that references this one.