koi_network 0.0.5
koi_network: ^0.0.5 copied to clipboard
Enterprise-grade network library built on Dio with configurable response parsing, request encoding, token refresh, retry, caching, and adapter-based architecture.
Changelog #
0.0.5 - 2026-07-20 #
Fixed #
- Preserve
nullrequest bodies for body-less GET and POST requests instead of encoding them as an empty JSON object. - Do not invoke global authentication-failure handling for unauthenticated or configured public endpoints that return an authentication status.
- Restore field-level messages for checked JSON deserialization failures.
- Use Chinese defaults for request, loading, authentication, and Dio errors.
Changed #
- Apply
tokenRefreshWhiteListconsistently to token refresh and global authentication-failure handling.
Documentation #
- Clarify that projects can opt into HTTP 402 authentication handling through
a custom response parser or
authErrorHttpCodes, while the default remains 401 and 403.
0.0.4 - 2026-07-06 #
Changed #
- Enable SSL certificate validation by default for
KoiNetworkConfig.create()andKoiNetworkConfig.production(). - Keep development and testing configurations opt-out by default for local and self-signed services.
Added #
- Add explicit
validateCertificateoverrides toKoiNetworkConfig.production,KoiNetworkConfig.development,KoiNetworkConfig.testing, andKoiNetworkInitializer.initialize/reinitialize.
0.0.3 - 2026-07-06 #
Added #
- Export
package:dio/dio.dartfrom the public library for convenience. - Add
KoiHeaderBuildersupport for injecting dynamic per-request headers. - Add typed batch request helpers to
KoiNetworkRequestMixinandNetworkRequestUtils.
Changed #
- Preserve an externally injected
Authorizationheader instead of overwriting it with the auth adapter token. - Pass configured header builders through
KoiNetworkInitializer,KoiNetworkConfig, andKoiDioFactory.
0.0.2 - 2026-03-21 #
Added #
- Chinese README (
README_ZH.md) with language switch links - Retrofit / Swagger integration guide in README
- GitHub Actions CI workflow (analyze + test on PRs)
0.0.1 - 2026-03-17 #
Added #
- Initial release of
koi_network - Adapter-based architecture for auth, error handling, loading, and platform
- Configurable response parsing via
KoiResponseParser - Request executor with execute/silent/quick/batch/retry patterns
KoiTypedRequestExecutorfor pre-parsed strong-type responsesKoiTypedResponse<T>for bridging Retrofit/OpenAPI generated models- Typed methods in
KoiNetworkRequestMixin:typedRequest,typedSilentRequest,typedQuickRequest - Typed methods in
NetworkRequestUtils:typedRequest,typedSilentRequest - JWT-based proactive + reactive token refresh interceptor
- Smart retry via
dio_smart_retry - Cache support via
dio_cache_interceptor - Multi-module Dio instance management
KoiNetworkRequestMixinfor controller convenience- Full type-safe generics support
- Comprehensive test suite for typed executor