⚡ Update(exceptions) type annotations & docsting to match changes

Author: MEHRSHAD-MIRSHEKARY

response_shaper/exceptions.py

@@ -1,4 +1,4 @@
-from typing import Any, Dict, Union
+from typing import Any, Dict
 
 from django.conf import settings
 from django.core.exceptions import (
@@ -161,23 +161,21 @@ def db_error(exc, status=500):
         return cls.build_error_response(500, message)
 
     @staticmethod
-    def extract_first_error(error_data: Any) -> Union[Any, Dict]:
+    def extract_first_error(error_data: Any) -> str:
         """Extract the first error message from various data structures (dict,
-        list, string). Stops at the first error encountered.
+        list, string). Stops at the first error encountered and returns it as a
+        string.
 
-        This method is useful for extracting the first error message from
-        complex error data structures, such as those returned by Django's
-        validation framework.
+        This method is useful for extracting the first error message from complex error data structures,
+        such as those returned by Django's validation framework.
 
         Args:
-            error_data (Any): The error data structure, which can be a string,
-                list, or dictionary.
+            error_data (Any): The error data structure, which can be a string, list, or dictionary.
 
         Returns:
-            Union[str, dict]: The extracted error message or structure. If the
-                input is a list, it returns the first element. If the input is
-                a dictionary, it returns the first key-value pair. If the input
-                is a string, it returns the string itself.
+            str: The extracted error message as a string. If the input is a list, it processes
+                the first element recursively. If the input is a dictionary, it processes
+                the first value found. If the input is already a string, it returns the string.
 
         """
         if isinstance(error_data, str):