dio_cache_interceptor

• perf: skip store write in _updateCacheResponse when maxStale is still half-window fresh
• fix: remove DioBaseRequest constructor mutation of RequestOptions.headers
• fix: make CacheResponse.content and headers final to prevent stale _cachedHeaders
• fix: strip if-none-match/if-modified-since from headers before invoking keyBuilder
• fix: guard against null requestDate when DioCacheInterceptor.onRequest is bypassed
• fix: skip storing a 304 response when no cached entry exists to update
• fix: wrap interceptor handlers in try/catch to prevent hangs on store exceptions
• refactor: remove dead else branch in onRequest conditional request dispatch

• fix: Age header refresh on 304 revalidation
• chore: Min SDK is now 3.6.0.

• chore: Updated dependencies.

• fix: Allow keyBuilder to depend on request body.

core: 1.1.1 / http_client: 1.0.2

• fix: BaseRequest now has headers getter instead of headerValuesAsList.
• chore: Updated dependencies.

• fix: BaseRequest now has headers getter instead of headerValuesAsList .

• chore: Updated dependencies.

fixes #174

• fix: Missing exports to handle client only caching.

feat: Improve performance on cache check when using cipher.

• fix: Improve cache save time.
• fix: CacheOptions#maxStale usage may lead to empty response body.
• feat: Improve performance on cache check when using cipher.

• fix: Improve cache save time.

• fix: CacheOptions#maxStale usage may lead to empty response body.

• feat: Improve performance on cache check when using cipher.

feat: Add http client along dio interceptor.

• chore: Reworked package to be only a dio interceptor. Leaving space to do the same with http package or others.
• feat: ** BREAKING ** Stores save response status codes.
  • Store migration is implicit, you have nothing to do.
  • 304 may still be forwarded for older cached responses.
• feat: ** BREAKING ** hitCacheOnErrorExcept is split with hitCacheOnNetworkFailure. Term is now positive and replaced by hitCacheOnErrorCodes.
• feat: Add hitCacheOnNetworkFailure to allow restore previous cached response on network failure (connection, TO, ...).
• chore: Stores are now fully agnostic and don't rely on dio_cache_interceptor package.
• chore: Source code cleanup.
• chore: Min SDK is now 3.0.0.
• chore: Updated dependencies.

• chore: Reworked package to be only a dio interceptor. Leaving space to do the same with http package or others.

• feat: ** BREAKING ** Stores save response status codes.

• Store migration is implicit, you have nothing to do.

• 304 may still be forwarded for older cached responses.

• feat: ** BREAKING ** hitCacheOnErrorExcept is split with hitCacheOnNetworkFailure . Term is now positive and replaced by hitCacheOnErrorCodes .

• feat: Add hitCacheOnNetworkFailure to allow restore previous cached response on network failure (connection, TO, ...).

• chore: Stores are now fully agnostic and don't rely on dio_cache_interceptor package.

• chore: Source code cleanup.

• chore: Min SDK is now 3.0.0.

• chore: Updated dependencies.

• fix: Allow " in header values.
• chore: Some more tests added.
• chore: Updated README.md.

• fix: Allow " in header values.

• chore: Some more tests added.

• chore: Updated README.md.

• chore: Updated dependencies.
• chore: Updated example.
• feat: Isar added as store.
• feat: Status 304 is now managed when set as valid status.

chore: Allow UUID package version v4.x

• chore: Allow UUID package version v4.x

chore: Now requires Dio >= 5.2.0+1.

• fix: Correctly serialize null content responses.
• chore: explicitly allow dart 3.
• chore: Now requires Dio >= 5.2.0+1.

fix: cache headers, trigger improvements

• fix: Headers were not saved/restored in/from CacheResponse.
• fix: Cache trigger now enabled again with expires, Cache-Control/max-age.
• feat: Add few new status codes available for caching: 404, 405 and 501.
• chore: Few code improvements.

• fix: Headers were not saved/restored in/from CacheResponse .

• fix: Cache trigger now enabled again with expires , Cache-Control / max-age .

• feat: Add few new status codes available for caching: 404, 405 and 501.

• chore: Few code improvements.

• chore: Ensure header values are join when there's comma (,) in the value (date, expires, last-modified, etag). Dio may or may not understand headers with single value (i.e.: 'Wed, 21 Oct 2015 07:28:00 GMT').

• chore: Allow dio version 5 aside version 4.

• fix: pathExists queryParams are not checked correctly (thanks to @clragon)

• feat: Add Store.getFromPath method.
• feat: Add Store.deleteFromPath method.
  Those two methods allow advanced manipulation of entries in store.
  Ensure to be restrictive when using it.

• feat: Add Store.getFromPath method.

• feat: Add Store.deleteFromPath method. Those two methods allow advanced manipulation of entries in store. Ensure to be restrictive when using it.

• fix: read/write when cipher is used.
• core: Avoids some roundtrips resulting in improved performance.
• feat: (Re-)introduce copyWith on CacheResponse.
• core: Remove Android example deprecations.

• fix: read/write when cipher is used.

• core: Avoids some roundtrips resulting in improved performance.

• feat: (Re-)introduce copyWith on CacheResponse .

• core: Remove Android example deprecations.

• feat: Don't skip subsequent onResponse interceptors if any.

• feat: Don't skip subsequent onResponse interceptors if any.

• fix: Cache control parsing on request. Dio request headers are not of type Headers.

• fix: Cache control parsing on request. Dio request headers are not of type Headers .

• fix: Missing Nullable export.

• fix: Missing Nullable export.

• Breaking feat: CacheOptions.copyWith now requires Nullable for some parameters to allow null values.
• fix: Since version 3.2.0, when maxStale was set on global options, it was necessary to re-create the dedicated CacheOptions for the request to avoid postponing. You can now use the changed copyWith to do that.
• fix: MemCacheStore.close now clears all entries.
• fix: size computation of entry bytes in MemCacheStore.

• Breaking feat: CacheOptions.copyWith now requires Nullable for some parameters to allow null values.

• fix: Since version 3.2.0, when maxStale was set on global options, it was necessary to re-create the dedicated CacheOptions for the request to avoid postponing. You can now use the changed copyWith to do that.

• fix: MemCacheStore.close now clears all entries.

• fix: size computation of entry bytes in MemCacheStore .

• fix: stream response type is no more eligible to cache (wasn't working anyway). This is additional fix to content-disposition: attachment; ... since headers may not be set.

• fix: stream response type is no more eligible to cache (wasn't working anyway). This is additional fix to content-disposition: attachment; ... since headers may not be set.

• fix: io import in CacheResponse preventing usage with web platform.

Warning, this version is considered compatible with previous versions about stored data.
However, cache store entries have now a new field for request date persistence which is setup arbitrarily for backward compatibility (150ms before response receive time).
Depending of your usage, cache beheviour could be a bit inaccurate while entries are not updated with new strategy algorithm.
If this is critical for your app, consider to clean up your store by calling store.clean(); for example on your next app upgrade.

• feat: More status codes (203, 301) are available for caching responses.
• feat: Status codes (302 are 307) are available for caching responses under strict conditions.
• feat: Lots of improvements in computation of response expiry. Package is now much more compliant with rfc7234.
• feat: age, max-stale, min-fresh, must-revalidate headers/values are now parsed.
• feat: When maxStale is given to the request, interceptor will now add/update it from the current date for a previously cached response. This lets you get more control to postpone the deletion if needed.
• fix: stale state is now handled in interceptor instead of cache stores.
• fix: no-cache header is now correctly handled.
• fix: content-disposition: attachment; ... is no more eligible to be cached.
• core: General code cleanup to handle above features.

Warning, this version is considered compatible with previous versions about stored data. However, cache store entries have now a new field for request date persistence which is setup arbitrarily for backward compatibility (150ms before response receive time). Depending of your usage, cache beheviour could be a bit inaccurate while entries are not updated with new strategy algorithm. If this is critical for your app, consider to clean up your store by calling store.clean(); for example on your next app upgrade.

• feat: More status codes (203, 301) are available for caching responses.

• feat: Status codes (302 are 307) are available for caching responses under strict conditions.

• feat: Lots of improvements in computation of response expiry. Package is now much more compliant with rfc7234 .

• feat: age , max-stale , min-fresh , must-revalidate headers/values are now parsed.

• feat: When maxStale is given to the request, interceptor will now add/update it from the current date for a previously cached response. This lets you get more control to postpone the deletion if needed.

• fix: stale state is now handled in interceptor instead of cache stores.

• fix: no-cache header is now correctly handled.

• fix: content-disposition: attachment; ... is no more eligible to be cached.

• core: General code cleanup to handle above features.

• Breaking: File cache store is now available as external package and suitable for production.
• Improved example with added non-cached content & image provider sample.

• Breaking : File cache store is now available as external package and suitable for production.

• Improved example with added non-cached content & image provider sample.

• fix: Cipher file export.
• feat: Add ObjectBox store (All credits go to cmengler).

• fix: Cipher file export.

• feat: Add ObjectBox store (All credits go to cmengler ).

• fix: Ciphered content deserialization error when updating headers.

• fix: file_cache_store visibility.

• core: Moved DB & Hive cache stores to their respective packages.
• fix: import of file_cache_store.

• fix: Cache-Control parsing. Dio does not expand multi valued headers.

• feat: allowPostMethod added to CacheOptions.

• feat: allowPostMethod added to CacheOptions .

• feat: Cache-Control: max-age as cache trigger added.
• core: update README.md.

• fix: refreshForceCache policy added. Get parity with refresh/request and refreshForceCache/forceCache.

• feat: Add Hive as cache store.

• core: Update dio to 4.0.0.
• Renamed cacheStoreForce to forceCache.
• Renamed cacheStoreNo to noCache.
• Make CacheOptions.store required but still with optional value.

• core: Update dio to 4.0.0.

• Renamed cacheStoreForce to forceCache .

• Renamed cacheStoreNo to noCache .

• Make CacheOptions.store required but still with optional value.

• core: Update dio to 4.0.0-prev1.
• fix: update cache header values on 304 (keeping in sync freshness of our cache content).
• fix: return cache on socket exception with hitCacheOnErrorExcept.
• fix: date header parsing exception not catched.

• core: Update dio to 4.0.0-beta7.
• Breaking: Remove now useless/confusing cacheFirst policy with improved freshness checks.
• Breaking: Rename requestFirst to request.
• Small code improvements.
• Update README.MD

• core: Update dio to 4.0.0-beta7.

• Breaking : Remove now useless/confusing cacheFirst policy with improved freshness checks.

• Breaking : Rename requestFirst to request .

• Small code improvements.

• Update README.MD

• core: Update dio to 4.0.0-beta6.
• Small code improvement / clean-up.
• Feat: Add boolean fromNetwork to extra in Response.
• Fix: Cache-Control max-age precedence over Expires header.
• Completed test coverage.
• Now waiting for Dio to get out of beta stage or issue reports!

• core: Update dio to 4.0.0-beta6.

• Small code improvement / clean-up.

• Feat: Add boolean fromNetwork to extra in Response .

• Fix: Cache-Control max-age precedence over Expires header.

• Completed test coverage.

• Now waiting for Dio to get out of beta stage or issue reports!

• core: Update dio to 4.0.0-beta5.
• Wrap decrypt/encrypt functions to CacheCipher.
• Add decent test coverage (still WIP).

• core: Update dio to 4.0.0-beta5.

• Wrap decrypt/encrypt functions to CacheCipher .

• Add decent test coverage (still WIP).

• core: Update dio to 4.0.0-beta4.
• Add missing copyWith method in CacheOptions to allow single option change.
• Small improvements & fixes

• core: Update dio to 4.0.0-beta4.

• Add missing copyWith method in CacheOptions to allow single option change.

• Small improvements & fixes

• core: Support null safety

• fix: Hide FileCacheStore for web support.
• core: Remove flutter dependency.

• Breaking: Moved from sqflite to Moor(:ffi) package for DbCacheStore.
• Breaking: Data stored with DbCacheStore is not compatible with previous versions.
• feat: Open support for linux, macOS, Windows and web platforms.
• core: Updated code to get rid of dart:io package for web platform.

• Breaking : Moved from sqflite to Moor(:ffi) package for DbCacheStore.

• Breaking : Data stored with DbCacheStore is not compatible with previous versions.

• feat: Open support for linux, macOS, Windows and web platforms.

• core: Updated code to get rid of dart:io package for web platform.

• core: Same version as 0.6.0. Updating dependencies.
• core: Add missing analysis pedantic file.
• fix: Remaining minor warnings.
• core: No known issue. Bump to 1.0 to be prepared for null safety version.

• feat: Add Cache-control header for response directives (all values are stored).
• feat: Add Date header.
• feat: Add Expires header (if date is invalid (i.e. 0), date is considered expired to 1970-01-01).
• feat: Cached response is now stored with absolute date (also used for max-age calculation).
• feat: CacheStore is no more required in CacheOptions to ease subsequent requests with global options.
• feat: Response object has now CacheResponse.fromCache: true extra boolean if coming from cache with CacheResponse.cacheKey.
• fix: Response extra are no more concatenated with RequestOptions extra (use Response.request.extra for this).
• fix(wording): stalledOnly renamed to staleOnly in CacheStore.
• various minor fixes and improvements.

Note:
This version should be backward compatible (data related) with 0.5.x versions (Please report any issues).
Even so, you're advised to clean stores to refresh entries with new headers.

With this version, 1.0 should be around the corner.

• feat: Add Cache-control header for response directives (all values are stored).

• feat: Add Date header.

• feat: Add Expires header (if date is invalid (i.e. 0), date is considered expired to 1970-01-01).

• feat: Cached response is now stored with absolute date (also used for max-age calculation).

• feat: CacheStore is no more required in CacheOptions to ease subsequent requests with global options.

• feat: Response object has now CacheResponse.fromCache: true extra boolean if coming from cache with CacheResponse.cacheKey .

• fix: Response extra are no more concatenated with RequestOptions extra (use Response.request.extra for this).

• fix(wording): stalledOnly renamed to staleOnly in CacheStore .

• various minor fixes and improvements.

Note: This version should be backward compatible (data related) with 0.5.x versions (Please report any issues). Even so, you're advised to clean stores to refresh entries with new headers.

With this version, 1.0 should be around the corner.

• fix: ETag conditional requesting with If-None-Match (Thanks @live9080).
• Update README.MD

• feat: add backup cache store
• core: add stores testing
• fix: file store associated fixes

• Add MemCacheStore. Cache with LRU strategy on RAM.
• Re-add 'exists' store method.
• Multiple fixes on maxStale (purge, get/set)
• Various cleanups.

• Add decrypt/encrypt methods to CacheOptions (no encryption by default. Private directories for stores are prefered for common usage).
• Remove 'exists' store method.

• Cancelled.

• Initial version
• DB cache store
• File cache store
• ETag
• Last-Modified
• Max stale
• CacheOptions

• Initial version

• DB cache store

• File cache store

• ETag

• Last-Modified

• Max stale

• CacheOptions

438

likes

160

points

214k

downloads

Documentation

API reference

Publisher

cow-level.ovh

Weekly Downloads

Metadata

Dio HTTP cache interceptor with multiple stores respecting HTTP directives (or not).

Repository (GitHub)

View/report issues

License

Apache-2.0 ( license )

Dependencies

dio , http_cache_core

More

Packages that depend on dio_cache_interceptor

← Metadata

438

likes

160

points

214k

downloads

Documentation

API reference

Publisher

cow-level.ovh

Weekly Downloads

Metadata

Dio HTTP cache interceptor with multiple stores respecting HTTP directives (or not).

Repository (GitHub)

View/report issues

License

Apache-2.0 ( license )

Dependencies

dio , http_cache_core

More

Packages that depend on dio_cache_interceptor

Back