immich/mobile/lib/utils/error_handler.dart

import 'dart:convert';

import 'package:flutter/widgets.dart';
import 'package:immich_mobile/generated/translations.g.dart';
import 'package:immich_mobile/utils/debug_print.dart';
import 'package:immich_ui/immich_ui.dart';
import 'package:openapi/api.dart';
// ignore: depend_on_referenced_packages
import 'package:stack_trace/stack_trace.dart';

void handleError(BuildContext context, Object error, {StackTrace? stack, String? description}) {
  String? stackTrace;
  if (stack != null) {
    final trace = Trace.from(stack);
    final clean = trace.foldFrames(
      (frame) => frame.package == 'flutter' || frame.package == 'flutter_test' || frame.isCore,
      terse: true,
    );
    stackTrace = clean.toString();
  }

  dPrint(
    () => 'Error${description != null ? ' ($description)' : ''}: $error${stackTrace != null ? '\n$stackTrace' : ''}',
  );

  if (!context.mounted) {
    return;
  }

  final String message;
  if (serverErrorMessage(error) case String serverMessage) {
    message = serverMessage;
  } else if (isConnectionError(error)) {
    message = context.t.login_form_server_error;
  } else {
    message = context.t.scaffold_body_error_occurred;
  }

  snackbar.error(message);
}

@visibleForTesting
String? serverErrorMessage(Object error) {
  if (error is! ApiException || error.innerException != null || error.message == null) {
    return null;
  }

  try {
    final body = jsonDecode(error.message!);
    if (body is Map && body['message'] != null) {
      final message = body['message'];
      return message is List ? message.join(', ') : message.toString();
    }
  } catch (_) {
    // The body was not JSON; fall back to the raw payload below.
  }
  return error.message;
}

@visibleForTesting
bool isConnectionError(Object error) => error is ApiException && error.innerException != null;