nexo_errors library

Failure model, mappers, and optional localized UI messages.

Classes

CollectingNexoCrashReporter
Реализация NexoCrashReporter для тестов и отладки: накапливает события в памяти и держит кольцевой буфер breadcrumbs.
CommonFailureMapper
Универсальный маппер ошибок, обрабатывающий типовые Dart-исключения.
DioFailureMapper
Специализированный маппер ошибок HTTP-клиента Dio.
DomainExceptionFailureMapper
Маппер доменных исключений AppException в соответствующие Failure.
DriftFailureMapper
Специализированный маппер ошибок ORM Drift (SQLite).
EnFailureUserMessages
English UI strings for Failure.
Failure
Система ошибок приложения
FailureMapper
Централизованный маппер ошибок в Failure.
FailureMapper2
Расширяемый маппер ошибок в Failure с поддержкой DI.
FailurePresenter
Тонкий слой между Failure и UI: тексты для Snackbar / диалога.
FailureSubMapper
Интерфейс подмаппера ошибок, реализуемый каждым специализированным маппером.
FailureUserMessageCatalog
Интерфейс каталога локализованных сообщений для Failure.
FileSystemFailureMapper
Специализированный маппер ошибок файловой системы.
FirebaseAuthFailureMapper
Специализированный маппер ошибок Firebase Auth.
FirebaseMessagingFailureMapper
Специализированный маппер ошибок Firebase Messaging.
HiveFailureMapper
Специализированный маппер ошибок Hive.
IsarFailureMapper
Специализированный маппер ошибок Isar.
Left<T>
Неудачная ветка Result; создаётся через Left(failure) или Result.failure(failure).
NexoBreadcrumb
«Хлебная крошка» — событие из жизни приложения до сбоя.
NexoCrashReporter
Абстракция для Crashlytics, Sentry и т.п. Реализации подключаются в приложении.
NexoFlutterErrors
Глобальная регистрация обработчиков ошибок Flutter (без UI).
NoOpNexoCrashReporter
Заглушка по умолчанию; ничего не делает.
PlatformFailureMapper
Специализированный маппер ошибок платформенных плагинов.
Result<T>
Иммутабельный результат операции: успех со значением типа T либо Failure.
Успешная ветка Result; создаётся через Right(value) или Result.success(value).
RuFailureUserMessages
Russian UI strings for Failure (default for Failure.userMessage).

Extensions

FailureMapperExtension on Object
Удобное расширение для преобразования ошибок в Failure.
FailurePatterns on Failure
Adds pattern-matching-related methods to Failure.
FailureUserMessageX on Failure
Расширение для удобного получения локализованного сообщения.
ResultFutureX on Future<Result<T>>
Удобные расширения для Future<Result<T>].
StringContainsAny on String
Утилиты для строк, используемые в мапперах ошибок.

Constants

nexoRequestIdExtraKey → const String
Ключ RequestOptions.extra, под которым NexoRequestIdInterceptor сохраняет идентификатор запроса; DioFailureMapper читает его оттуда.

Functions

failureCode(Failure failure) → String
Стабильный код вида network.no_internet, http.unauthorized, unknown.
mapSocketMessageToNetworkFailure(String? socketMessage) → NetworkFailure
Маппинг сообщений сокет-ошибок на NetworkFailure.

Typedefs

StreamResult<T> = Stream<Result<T>>
Поток результатов с тем же смыслом, что и Result.

Exceptions / Errors

AuthAppException
Исключение аутентификации.
CacheAppException
Исключение кэша.
DatabaseAppException
Исключение базы данных.
FileAppException
Исключение работы с файлами.
LocationAppException
Исключение геолокации.
NotificationAppException
Исключение push-уведомлений.
ParseAppException
Исключение парсинга данных.
PaymentAppException
Исключение платежей.
PermissionAppException
Исключение разрешений.
PlatformAppException
Исключение платформы.
StorageAppException
Исключение хранилища данных.
SyncAppException
Исключение синхронизации.
ValidationAppException
Исключение валидации.