Adding documentation

Author: leandrodamascena

docs/core/event_handler/appsync_events.md

@@ -67,22 +67,28 @@ You must have an existing AppSync Events API with real-time capabilities enabled
 
 AppSync Events uses a specific event format for Lambda requests and responses. In most scenarios, Powertools simplifies this interaction by automatically formatting resolver returns to match the expected AppSync response structure.
 
-=== "appsync_payload_request.json"
+=== "payload_request.json"
 
     ```python hl_lines="5 10 12"
-    --8<-- "examples/event_handler_appsync_events/src/appsync_payload_request.json"
+    --8<-- "examples/event_handler_appsync_events/src/payload_request.json"
     ```
 
-=== "appsync_payload_response.json"
+=== "payload_response.json"
 
     ```python hl_lines="5 10 12"
-    --8<-- "examples/event_handler_appsync_events/src/appsync_payload_response.json"
+    --8<-- "examples/event_handler_appsync_events/src/payload_response.json"
     ```
 
-=== "appsync_payload_response_with_error.json"
+=== "payload_response_with_error.json"
 
     ```python hl_lines="5 10 12"
-    --8<-- "examples/event_handler_appsync_events/src/appsync_payload_response_with_error.json"
+    --8<-- "examples/event_handler_appsync_events/src/payload_response_with_error.json"
+    ```
+
+=== "payload_response_fail_request.json"
+
+    ```python hl_lines="5 10 12"
+    --8<-- "examples/event_handler_appsync_events/src/payload_response_fail_request.json"
     ```
 
 #### Events response with error
@@ -177,12 +183,12 @@ When processing items individually with `aggregate=False`, you can raise an exce
 
 #### Handling errors with batch of items
 
-When processing batch of items with `aggregate=False`, you can must format the payload according the expected response.
+When processing batch of items with `aggregate=True`, you must format the payload according the expected response.
 
-=== "working_with_error_handling.py"
+=== "working_with_error_handling_multiple.py"
 
     ```python hl_lines="5 6 13"
-    --8<-- "examples/event_handler_appsync_events/src/working_with_error_handling.py"
+    --8<-- "examples/event_handler_appsync_events/src/working_with_error_handling_multiple.py"
     ```
 
 === "working_with_error_handling_response.json"

examples/event_handler_appsync_events/src/appsync_payload_request.json renamed to examples/event_handler_appsync_events/src/payload_request.json

@@ -0,0 +1,4 @@
+{
+    "error": "Exception - An exception occurred"
+  }
+  

examples/event_handler_appsync_events/src/appsync_payload_response.json renamed to examples/event_handler_appsync_events/src/payload_response.json

@@ -15,23 +15,10 @@ def handle_default_namespace_batch(payload_list: list[dict[str, Any]]):
 
     # Process all events in the batch together
     for event in payload_list:
-        try:
-            # Process each event
-            processed_event = process_event(event)
-            results.append(processed_event)
-        except Exception as e:
-            # Handle errors for individual events
-            results.append({
-                "error": str(e),
-                "id": event.get("id"),
-            })
-
-    return {
-        "events": results,
-    }
-
-def process_event(event):
-    return {"payload": event}
+        # Process each event
+        results.append({"id": event.get("id"), "payload": {"processed": True, "originalEvent": event}})
+
+    return results
 
 def lambda_handler(event: dict, context: LambdaContext):
     return app.resolve(event, context)

examples/event_handler_appsync_events/src/payload_response_fail_request.json

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any
+
+from aws_lambda_powertools.event_handler import AppSyncEventsResolver
+
+if TYPE_CHECKING:
+    from aws_lambda_powertools.utilities.typing import LambdaContext
+
+app = AppSyncEventsResolver()
+
+@app.on_publish("/default/*", aggregate=True)
+def handle_default_namespace_batch(payload_list: list[dict[str, Any]]):
+    results: list = []
+
+    # Process all events in the batch together
+    for event in payload_list:
+        try:
+            # Process each event
+            results.append({"id": event.get("id"), "payload": {"processed": True, "originalEvent": event}})
+        except Exception as e:
+            # Handle errors for individual events
+            results.append({
+                "error": str(e),
+                "id": event.get("id"),
+            })
+
+    return results
+
+def lambda_handler(event: dict, context: LambdaContext):
+    return app.resolve(event, context)