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)