fix(auth): improve sign-out error logging

- Replaced `print` statements with logger.
- Added stack traces to error logs.
- Improved error message clarity.
- Used structured logging for better analysis.

Author: fulleni

routes/api/v1/auth/sign-out.dart

@@ -3,6 +3,10 @@ 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 and exceptions
+import 'package:logging/logging.dart';
+
+// Create a logger for this file.
+final _logger = Logger('sign_out_handler');
 
 /// Handles POST requests to `/api/v1/auth/sign-out`.
 ///
@@ -34,8 +38,8 @@ Future<Response> onRequest(RequestContext context) async {
   // Although authentication middleware should ensure a token is present,
   // this check acts as a safeguard.
   if (token == null || token.isEmpty) {
-    print(
-      'Error: Could not extract Bearer token for user ${user.id} in sign-out handler.',
+    _logger.severe(
+      'Could not extract Bearer token for user ${user.id} in sign-out handler.',
     );
     throw const OperationFailedException(
       'Internal error: Unable to retrieve authentication token for sign-out.',
@@ -55,9 +59,13 @@ Future<Response> onRequest(RequestContext context) async {
   } on HtHttpException catch (_) {
     // Let the central errorHandler middleware handle known exceptions
     rethrow;
-  } catch (e) {
+  } catch (e, s) {
     // Catch unexpected errors from the service layer
-    print('Unexpected error in /sign-out handler for user ${user.id}: $e');
+    _logger.severe(
+      'Unexpected error in /sign-out handler for user ${user.id}',
+      e,
+      s,
+    );
     // Let the central errorHandler handle this as a 500
     throw const OperationFailedException(
       'An unexpected error occurred during sign-out.',