feat: Implement initial schema and add various API, service, and management command enhancements across the application.

backend/apps/api/v1/views/auth.py

@@ -54,9 +54,8 @@ except ImportError:
 
 # Type hint for the mixin
 if TYPE_CHECKING:
-    from typing import Union
 
-    TurnstileMixinType = Union[type[FallbackTurnstileMixin], Any]
+    TurnstileMixinType = type[FallbackTurnstileMixin] | Any
 else:
     TurnstileMixinType = TurnstileMixin
 
@@ -87,11 +86,9 @@ class LoginAPIView(TurnstileMixin, APIView):  # type: ignore[misc]
             # Validate Turnstile if configured
             self.validate_turnstile(request)
         except ValidationError as e:
-            return Response({"error": str(e)}, status=status.HTTP_400_BAD_REQUEST)
+            return Response({"detail": str(e)}, status=status.HTTP_400_BAD_REQUEST)
 
-        serializer = LoginInputSerializer(
-            data=request.data, context={"request": request}
-        )
+        serializer = LoginInputSerializer(data=request.data, context={"request": request})
         if serializer.is_valid():
             # The serializer handles authentication validation
             user = serializer.validated_data["user"]  # type: ignore[index]
@@ -106,7 +103,7 @@ class LoginAPIView(TurnstileMixin, APIView):  # type: ignore[misc]
                 {
                     "token": token.key,
                     "user": user,
-                    "message": "Login successful",
+                    "detail": "Login successful",
                 }
             )
             return Response(response_serializer.data)
@@ -138,7 +135,7 @@ class SignupAPIView(TurnstileMixin, APIView):  # type: ignore[misc]
             # Validate Turnstile if configured
             self.validate_turnstile(request)
         except ValidationError as e:
-            return Response({"error": str(e)}, status=status.HTTP_400_BAD_REQUEST)
+            return Response({"detail": str(e)}, status=status.HTTP_400_BAD_REQUEST)
 
         serializer = SignupInputSerializer(data=request.data)
         if serializer.is_valid():
@@ -152,7 +149,7 @@ class SignupAPIView(TurnstileMixin, APIView):  # type: ignore[misc]
                 {
                     "token": token.key,
                     "user": user,
-                    "message": "Registration successful",
+                    "detail": "Registration successful",
                 }
             )
             return Response(response_serializer.data, status=status.HTTP_201_CREATED)
@@ -186,14 +183,10 @@ class LogoutAPIView(APIView):
             # Logout from session
             logout(request._request)  # type: ignore[attr-defined]
 
-            response_serializer = LogoutOutputSerializer(
-                {"message": "Logout successful"}
-            )
+            response_serializer = LogoutOutputSerializer({"detail": "Logout successful"})
             return Response(response_serializer.data)
         except Exception:
-            return Response(
-                {"error": "Logout failed"}, status=status.HTTP_500_INTERNAL_SERVER_ERROR
-            )
+            return Response({"detail": "Logout failed"}, status=status.HTTP_500_INTERNAL_SERVER_ERROR)
 
 
 @extend_schema_view(
@@ -237,15 +230,11 @@ class PasswordResetAPIView(APIView):
     serializer_class = PasswordResetInputSerializer
 
     def post(self, request: Request) -> Response:
-        serializer = PasswordResetInputSerializer(
-            data=request.data, context={"request": request}
-        )
+        serializer = PasswordResetInputSerializer(data=request.data, context={"request": request})
         if serializer.is_valid():
             serializer.save()
 
-            response_serializer = PasswordResetOutputSerializer(
-                {"detail": "Password reset email sent"}
-            )
+            response_serializer = PasswordResetOutputSerializer({"detail": "Password reset email sent"})
             return Response(response_serializer.data)
 
         return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
@@ -271,15 +260,11 @@ class PasswordChangeAPIView(APIView):
     serializer_class = PasswordChangeInputSerializer
 
     def post(self, request: Request) -> Response:
-        serializer = PasswordChangeInputSerializer(
-            data=request.data, context={"request": request}
-        )
+        serializer = PasswordChangeInputSerializer(data=request.data, context={"request": request})
         if serializer.is_valid():
             serializer.save()
 
-            response_serializer = PasswordChangeOutputSerializer(
-                {"detail": "Password changed successfully"}
-            )
+            response_serializer = PasswordChangeOutputSerializer({"detail": "Password changed successfully"})
             return Response(response_serializer.data)
 
         return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
@@ -338,9 +323,7 @@ class SocialProvidersAPIView(APIView):
                     provider_name = social_app.name or social_app.provider.title()
 
                     # Build auth URL efficiently
-                    auth_url = request.build_absolute_uri(
-                        f"/accounts/{social_app.provider}/login/"
-                    )
+                    auth_url = request.build_absolute_uri(f"/accounts/{social_app.provider}/login/")
 
                     providers_list.append(
                         {
@@ -370,13 +353,9 @@ class SocialProvidersAPIView(APIView):
                     "status": "error",
                     "error": {
                         "code": "SOCIAL_PROVIDERS_ERROR",
-                        "message": "Unable to retrieve social providers",
+                        "detail": "Unable to retrieve social providers",
                         "details": str(e) if str(e) else None,
-                        "request_user": (
-                            str(request.user)
-                            if hasattr(request, "user")
-                            else "AnonymousUser"
-                        ),
+                        "request_user": (str(request.user) if hasattr(request, "user") else "AnonymousUser"),
                     },
                     "data": None,
                 },