feat(api): add response metadata to verify-code endpoint

Standardizes the success response for the verify-code endpoint by including the `ResponseMetadata` object, which contains the `requestId` and a timestamp.

This ensures that all successful authentication responses that return a body are structured consistently, improving API uniformity.

Author: fulleni

routes/api/v1/auth/verify-code.dart

@@ -5,6 +5,8 @@ import 'package:ht_api/src/services/auth_service.dart';
 // Import exceptions, User, SuccessApiResponse, AND AuthSuccessResponse
 import 'package:ht_shared/ht_shared.dart';
 
+import '../../../_middleware.dart';
+
 /// Handles POST requests to `/api/v1/auth/verify-code`.
 ///
 /// Verifies the provided email and code, completes the sign-in/sign-up,
@@ -84,11 +86,16 @@ Future<Response> onRequest(RequestContext context) async {
       token: result.token,
     );
 
+    // Create metadata, including the requestId from the context.
+    final metadata = ResponseMetadata(
+      requestId: context.read<RequestId>().id,
+      timestamp: DateTime.now().toUtc(),
+    );
+
     // Wrap the payload in the standard SuccessApiResponse
     final responsePayload = SuccessApiResponse<AuthSuccessResponse>(
       data: authPayload,
-      // Optionally add metadata if needed/available
-      // metadata: ResponseMetadata(timestamp: DateTime.now().toUtc()),
+      metadata: metadata,
     );
 
     // Return 200 OK with the standardized, serialized response