Added #

• RetryPolicy abstract interface — implement to control retry behaviour on failed requests
• ThrottlePolicy abstract interface — implement to rate-limit outgoing requests
• ExponentialBackoffRetryPolicy — concrete retry implementation with configurable maxAttempts, initialDelay, multiplier, maxDelay, and retryOnStatusCodes
• RateLimitThrottlePolicy — concrete sliding-window throttle with configurable maxRequests, windowDuration, and optional maxWaitTime
• LuckyThrottleException extends LuckyException — thrown when maxWaitTime is exceeded; never triggers a retry even when a RetryPolicy is configured
• Connector.retryPolicy and Connector.throttlePolicy nullable getters — nil by default, re-evaluated on every send() call

Changed #

• Connector.send() rewritten as a while loop to support retry and throttle orchestration without changes to the Dio layer

Added #

• LuckyLogCallback and LuckyDebugCallback named typedefs exported from the package — use them to annotate your own callback variables instead of repeating the verbose inline function types
• LuckyParseException extends LuckyException — thrown by response parsing helpers when the body cannot be cast to the expected type; exposes cause (the original TypeError) and a descriptive message ("Expected Map<String, dynamic>, got String")

Changed #

• LuckyResponse.json(), jsonList(), text(), bytes() now throw LuckyParseException instead of a raw TypeError on type mismatch

Fixed #

• Simplify example: single connector, linear flow, no redundant class

Fixed #

• Add example/lucky_dart_example.dart for pub.dev scoring
• Document implicit constructors on Authenticator and ConfigMerger
• Fix repository URL in pubspec.yaml (owlnext-fr/lucky)

All notable changes to Lucky Dart will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Added #

• Core layer — abstract Connector, Request, LuckyResponse, ConfigMerger
• Body mixins — HasJsonBody, HasFormBody, HasMultipartBody, HasXmlBody, HasTextBody, HasStreamBody
• Authentication — Authenticator interface, TokenAuthenticator, BasicAuthenticator, QueryAuthenticator, HeaderAuthenticator
• Pluggable per-request auth — Connector.authenticator (runtime-mutable getter), Connector.useAuth, Request.useAuth (bool? override)
• Interceptors — LoggingInterceptor, DebugInterceptor (callback-based, no logging dependency)
• Typed exceptions — LuckyException, ConnectionException, LuckyTimeoutException, NotFoundException (404), UnauthorizedException (401), ValidationException (422)
• Dio integration — validateStatus: (_) => true so Lucky controls all HTTP error handling, not Dio
• Full English dartdoc on all public APIs
• 112 tests (89 unit + 13 integration via dart:io mock server)