app_smart_network 1.0.0

A smart Flutter network package with built-in error handling, retry logic, and multilingual error messages (en/ar).

1.0.0

Initial stable release.

Features

• ApiService singleton with initialize(NetworkConfig) entry point
• NetworkConfig — configure base URL, timeouts, default headers, SSL, and unauthorized callback
• HttpMethod enum — get, post, put, patch, delete
• RequestService — unified HTTP request execution with connectivity guard and mobile timeout extension
• DownloadRequestService — file download with progress callback
• UploadRequestService — multipart file upload with extra fields and progress callback
• NetworkLocale — locale-aware error messages; built-in English and Arabic translations covering all standard HTTP status codes and network error types; extensible via addTranslations()
• setAppLocale(locale) — sets Accept-Language header and switches error-message locale in one call
• ErrorHandler — converts DioException to ApiException with translated messages
• ApiException — rich exception with statusCode, apiErrorCode, errorCategory, hasApiErrorCode(), and getResponseField()
• ServerFailure / CacheFailure — domain-layer Failure wrappers (Equatable)
• Automatic retry on idempotent methods (GET, PUT, DELETE) with exponential back-off (3 retries: 1 s, 2 s, 3 s)
• Connectivity check before every request with a single 600 ms retry for transient states
• Background JSON decoding via compute isolate
• Debug request/response logging via PrettyDioLogger (debug builds only)
• Per-request baseUrl override, cancel token, query parameters, and send/receive progress callbacks
• example/ app demonstrating all features against JSONPlaceholder API