duticotac_api_flutter 0.1.1

duticotac_api_flutter: ^0.1.1 copied to clipboard

Documentation only — no code change.

Fixed #

• README: install from pub.flutter-io.cn (^0.1.1) and add hive_ce_flutter, which is needed for Hive.initFlutter() and isn't re-exported
• README: getStatus returns payment-cancelled, payment-failed and polling-timeout in response.error instead of throwing them; the polling and error-handling examples now match this
• README: the TransactionModel listing now matches the actual fields (provider, currency as a String, non-null dates, paymentUrl)
• README: document paymentUrl for Wave, the app parameter, the errors map, getProviderName / getProviderLogo, and the known issue with the offer cache
• README: remove the unrelated in-app purchase troubleshooting section, and move adapter regeneration into Contributing using dart run build_runner

Breaking: the minimum Dart and Flutter versions move up, and connectivity_plus crosses a major version. The package's own API is unchanged — code calling Duticotac, the services or the models needs no edit.

Breaking #

• Minimum Dart SDK is now ^3.13.0 (was ^3.8.0)
• Minimum Flutter is now >=3.47.0 (was >=1.17.0)
• connectivity_plus upgraded to ^7.3.1 (was ^6.1.2)

Fixed #

• getProviderName(PaymentProvider.creditCard) returned "Carte de crédit" with a decomposed accent (e + U+0301). It compared unequal to the precomposed literal a caller would normally write, even though it rendered identically. The string is now NFC-normalised like the rest of the package.

Changed #

• dio upgraded to ^5.11.1, hive_ce to ^2.20.0, hive_ce_flutter to ^2.3.4
• Dev dependencies: flutter_lints to ^6.0.0, build_runner to ^2.16.1, hive_ce_generator to ^1.11.3
• Service constructors now use initializing formals, and the helpers in utils/common.dart declare their return type, for flutter_lints 6

Added #

• A test suite covering the models, the wire format, the mobile money and transaction endpoints, the polling and retry loop, and the offer cache
• lib/hive_registrar.g.dart, emitted by the upgraded hive_ce_generator

Known issues #

• DuticotacOffer.get refreshes a cache hit without awaiting or catching the result. When that background refresh fails, the error escapes onto the caller's zone as an unhandled async error.

Fixed #

• Fixed DNS lookup failures when returning from Wave payment app
• Added connectivity_plus package to handle transient network issues
• Implemented smart retry logic with exponential backoff for network errors
• Added connectivity checking before retrying failed requests
• Improved error handling to distinguish between retryable and non-retryable errors

Changed #

• Made getStatus() method parameters configurable (intervalMin and timeout)
• Enhanced polling logic to handle app resume scenarios gracefully

• Previous release

• Initial release