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

Standardizes the success response for the verify-link-email 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-link-email.dart

@@ -2,7 +2,9 @@ import 'dart:io';
 
 import 'package:dart_frog/dart_frog.dart';
 import 'package:ht_api/src/services/auth_service.dart';
-import 'package:ht_shared/ht_shared.dart'; // For User, AuthSuccessResponse, exceptions
+import 'package:ht_shared/ht_shared.dart';
+
+import '../../../_middleware.dart';
 
 /// Handles POST requests to `/api/v1/auth/verify-link-email`.
 ///
@@ -88,10 +90,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,
-      // metadata: ResponseMetadata(timestamp: DateTime.now().toUtc()),
+      metadata: metadata,
     );
 
     // Return 200 OK with the standardized, serialized response