Add documentation + rename

Author: leandrodamascena

aws_lambda_powertools/utilities/parser/models/__init__.py

@@ -28,7 +28,7 @@
     RequestContextV2Http,
 )
 from .appsync import AppSyncResolverEventModel
-from .appsync_events import AppSyncResolverEventsModel
+from .appsync_events import AppSyncEventsModel
 from .bedrock_agent import (
     BedrockAgentEventModel,
     BedrockAgentFunctionEventModel,
@@ -169,7 +169,7 @@
     "AlbRequestContext",
     "AlbRequestContextData",
     "AppSyncResolverEventModel",
-    "AppSyncResolverEventsModel",
+    "AppSyncEventsModel",
     "DynamoDBStreamModel",
     "EventBridgeModel",
     "DynamoDBStreamChangedRecordModel",

aws_lambda_powertools/utilities/parser/models/appsync_events.py

@@ -25,7 +25,7 @@ class AppSyncEventsEventModel(BaseModel):
     payload: Dict[str, Any]
 
 
-class AppSyncResolverEventsModel(BaseModel):
+class AppSyncEventsModel(BaseModel):
     identity: Optional[AppSyncIdentity] = None
     request: AppSyncRequestModel
     info: AppSyncEventsInfoModel

docs/utilities/parser.md

@@ -112,6 +112,7 @@ The example above uses `SqsModel`. Other built-in models can be found below.
 | **APIGatewayWebSocketConnectEventModel**    | Lambda Event Source payload for Amazon API Gateway WebSocket API $connect message             |
 | **APIGatewayWebSocketDisconnectEventModel** | Lambda Event Source payload for Amazon API Gateway WebSocket API $disconnect message          |
 | **AppSyncResolverEventModel**               | Lambda Event Source payload for AWS AppSync Resolver                                          |
+| **AppSyncEventsModel**                      | Lambda Event Source payload for AWS AppSync Events                                            |
 | **BedrockAgentEventModel**                  | Lambda Event Source payload for Bedrock Agents - OpenAPI-based                                |
 | **BedrockAgentFunctionEventModel**          | Lambda Event Source payload for Bedrock Agents - Function-based                               |
 | **CloudFormationCustomResourceCreateModel** | Lambda Event Source payload for AWS CloudFormation `CREATE` operation                         |

tests/unit/parser/_pydantic/test_appsync_events.py

@@ -1,7 +1,7 @@
 import pytest
 
 from aws_lambda_powertools.utilities.parser import ValidationError, parse
-from aws_lambda_powertools.utilities.parser.models import AppSyncResolverEventsModel
+from aws_lambda_powertools.utilities.parser.models import AppSyncEventsModel
 from tests.functional.utils import load_event
 
 
@@ -10,9 +10,9 @@ def test_appsync_event_model_parses_successfully():
     Validate that a valid AppSync resolver events is correctly parsed by the model.
     """
     event = load_event("appSyncEventsEvent.json")
-    parsed_event = parse(event=event, model=AppSyncResolverEventsModel)
+    parsed_event = parse(event=event, model=AppSyncEventsModel)
 
-    assert isinstance(parsed_event, AppSyncResolverEventsModel)
+    assert isinstance(parsed_event, AppSyncEventsModel)
 
 
 def test_appsync_event_model_invalid_payload_raises():
@@ -21,4 +21,4 @@ def test_appsync_event_model_invalid_payload_raises():
     """
     invalid_event = {"invalid": "event"}
     with pytest.raises(ValidationError):
-        parse(event=invalid_event, model=AppSyncResolverEventsModel)
+        parse(event=invalid_event, model=AppSyncEventsModel)