Error Handling Patterns#

This project standardizes error handling so UI messages stay user-friendly and network failures are predictable.

Standard Error Types#

• NetworkFailure (in lib/src/infrastructure/network/network_failure.dart)
  • ConnectionFailure, AuthFailure, RateLimitFailure, ClientFailure, ServerFailure, DecodeFailure
• OAuthException (in lib/src/infrastructure/auth/oauth_exceptions.dart)
• ValidationError (in lib/src/features/dms/domain/outbox_error.dart)

UI Messaging#

Use errorMessage(error) from lib/src/core/utils/error_message.dart instead of error.toString() to avoid leaking raw exception text into the UI.

Example:

ErrorView(
  title: 'Failed to load feed',
  message: errorMessage(error),
  onRetry: () => ref.read(feedContentProvider(uri).notifier).refresh(),
);

Logging vs Display#

• Log raw errors and stacks for debugging (logger.error(...)).
• Display standardized UI messages via errorMessage(...).
• Prefer typed errors (e.g., NetworkFailure) at repository boundaries.

Tests#

Add or update tests whenever new error types are introduced or UI messaging changes, especially for networking/auth flows.