cached_query
A simple library for dealing with server state in dart and flutter.
3.7.0
12K downloads/mo
#2686 most downloaded on pub.dev
D-James-GH/cached_query
What this package is like to depend on
Last release 2 months ago
13 Jun 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 51 of 52 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
77 releases · first in 2022
17 releases in the last 12 months
see the full history below
Release timeline
77 releases · Jun 2022 to Jun 2026Releases
latest 60 of 77-
3.7.017 May 2026 -
3.7.0-dev.013 Jun 2026 pre-release -
3.6.028 Apr 2026Release notes
Open source →- FEAT: allowing query cache to be passed to mutation. (af8bd3ca)
2026-03-06
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.3.6cached_storage-v3.2.6
-
3.5.106 Mar 2026Release notes
Open source →- FIX: can't change polling interval without downgrading generic type. (4daa10e1)
2026-02-25
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.3.5cached_storage-v3.2.5
Release notes
Open source →- FIX: can't change polling interval without downgrading generic type. (4daa10e1)
-
3.5.025 Feb 2026Release notes
Open source →- FIX: analysis issue. (7b0409b4)
- FIX: state is updated and visible in the observers. (9a1f3e1a)
- FEAT: allow getting the error on mutation base state. (4f37225b)
2026-02-12
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.3.4cached_storage-v3.2.4
-
3.4.113 Feb 2026Release notes
Open source →2026-01-04
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.3.3cached_storage-v3.2.3
-
3.4.004 Jan 2026 -
3.3.219 Dec 2025Release notes
Open source →- FIX: devtools not working on 3.2.0+. (7fa8e984)
2025-11-26
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.3.1cached_storage-v3.2.1
-
3.3.126 Nov 2025Release notes
Open source →- FIX: resume null check error. (87c9cad6)
2025-11-25
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
-
3.3.025 Nov 2025Release notes
Open source →- FEAT: retrying for queries and infinite queries. (613db689)
2026-04-28
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.3.7cached_storage-v3.2.7
-
3.2.023 Nov 2025Release notes
Open source →- FEAT: add polling interval config. (fe9e8384)
2025-11-23
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
-
3.1.014 Nov 2025Release notes
Open source →- FEAT: setQueryData creates a query if non exists. (07c38e29)
2025-11-12
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages graduated to a stable release (see pre-releases prior to the stable version for changelog entries):
cached_query-v3.1.0cached_query_flutter-v3.1.0cached_storage-v3.0.4
Release notes
Open source →- Graduate package to a stable release. See pre-releases prior to this version for changelog entries.
-
3.0.321 Oct 2025Release notes
Open source →- FIX: added dispose to clean up pending timers. (8ee29b1d)
2025-10-20
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_storage-v3.0.2
-
3.0.220 Oct 2025Release notes
Open source →- DOCS: remove warning for rethrow, this should not effect state management since 3.0.0. (6b966d8d)
-
3.0.106 Sep 2025 -
3.0.006 Sep 2025Release notes
Open source →2025-08-29
Changes
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_storage-v3.0.0-dev.19
Release notes
Open source →- Graduate package to a stable release. See pre-releases prior to this version for changelog entries.
-
3.0.0-dev.1929 Aug 2025 pre-release -
3.0.0-dev.1818 Aug 2025 pre-releaseRelease notes
Open source →- BREAKING FEAT: change name of mutation funciton to mutationFn for clarity. (f91ed15d)
Release notes
Open source →Note: This release has breaking changes.
- BREAKING FEAT: change name of mutation funciton to mutationFn for clarity. (f91ed15d)
-
3.0.0-dev.1621 Jun 2025 pre-releaseRelease notes
Open source →- BREAKING FEAT: change mutation state to sealed classes. (5ea683a6)
2025-06-19
Changes
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_storage-v3.0.0-dev.15
Release notes
Open source →Note: This release has breaking changes.
- BREAKING FEAT: change mutation state to sealed classes. (5ea683a6)
-
3.0.0-dev.1519 Jun 2025 pre-release -
3.0.0-dev.1421 May 2025 pre-release -
3.0.0-dev.1316 May 2025 pre-releaseRelease notes
Open source →- FIX: infinite query invalidate not working. (1883bdd7)
2025-05-16
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.0.0-dev.12cached_storage-v3.0.0-dev.12
-
3.0.0-dev.1216 May 2025 pre-releaseRelease notes
Open source →- FEAT: added convenience methods to infinite query data. (fec46348)
2025-05-16
Changes
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_storage-v3.0.0-dev.11
-
3.0.0-dev.1116 May 2025 pre-releaseRelease notes
Open source →- BREAKING REFACTOR: merge QueryBase and Cacheable so queries only extend one sealed class. (33d8566d)
Release notes
Open source →Note: This release has breaking changes.
- BREAKING REFACTOR: merge QueryBase and Cacheable so queries only extend one sealed class. (33d8566d)
-
3.0.0-dev.1012 May 2025 pre-release -
3.0.0-dev.912 Mar 2025 pre-releaseRelease notes
Open source →- REFACTOR: add equlaity to stored query. (2c4eaa12)
- BREAKING REFACTOR: Rename QueryBase to QueryController. QueryBase is now just a sealed class extended by Query and InfiniteQuery. This is to allow for more specific typing of QueryController if needed without requiring observers to change. (5dfc7611)
Release notes
Open source →Note: This release has breaking changes.
- REFACTOR: add equlaity to stored query. (2c4eaa12)
- BREAKING REFACTOR: Rename QueryBase to QueryController. QueryBase is now just a sealed class extended by Query and InfiniteQuery. This is to allow for more specific typing of QueryController if needed without requiring observers to change. (5dfc7611)
-
3.0.0-dev.802 Mar 2025 pre-release -
3.0.0-dev.620 Feb 2025 pre-releaseRelease notes
Open source →- FEAT: query success data is now just the type T not T?, data can still be nullable by passing T? as the generic. (ba5e2b74)
-
3.0.0-dev.515 Feb 2025 pre-releaseRelease notes
Open source →- FEAT: add isInitialFetch to loading state. (c3799a95)
2025-02-14
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v3.0.0-dev.4
-
3.0.0-dev.414 Feb 2025 pre-release -
3.0.0-dev.326 Jan 2025 pre-releaseRelease notes
Open source →- FEAT: invalidating a query will, by default, refetch active queries. (d63579f5)
-
3.0.0-dev.224 Jan 2025 pre-releaseRelease notes
Open source →- REFACTOR: remove unnecessary infinite query fetch params. (0304a6c3)
- REFACTOR: infinite query ready for direction. (fabc2476)
- REFACTOR: infinite query ready for direction. (4b456a0c)
- FIX: infinite query not fetching from storage. (2369dc3e)
- FIX: after rebasing 2.6. (378858f9)
- FIX: add missed part. (8b996510)
- FIX: add missed part. (a137276d)
- FEAT: update devtools for 3. (f462df2b)
- FEAT: add emit to setstate. (5a7e2340)
- FEAT: update devtools for 3. (352c43b4)
- FEAT: add emit to setstate. (990aff6e)
- BREAKING FEAT: change state to sealed classes. (3f4030d4)
- BREAKING FEAT: remove deprecated things. (f238b9fc)
- BREAKING FEAT: update env to 3.0.0+ and fix lints. (e35c614b)
- BREAKING FEAT: change state to sealed classes. (dcabfd41)
- BREAKING FEAT: remove deprecated things. (3e68942b)
- BREAKING FEAT: update env to 3.0.0+ and fix lints. (ff284686)
Release notes
Open source →Note: This release has breaking changes.
- REFACTOR: remove unnecessary infinite query fetch params. (0304a6c3)
- REFACTOR: infinite query ready for direction. (fabc2476)
- REFACTOR: infinite query ready for direction. (4b456a0c)
- FIX: infinite query not fetching from storage. (2369dc3e)
- FIX: after rebasing 2.6. (378858f9)
- FIX: add missed part. (8b996510)
- FIX: add missed part. (a137276d)
- FEAT: update devtools for 3. (f462df2b)
- FEAT: add emit to setstate. (5a7e2340)
- FEAT: update devtools for 3. (352c43b4)
- FEAT: add emit to setstate. (990aff6e)
- BREAKING FEAT: change state to sealed classes. (3f4030d4)
- BREAKING FEAT: remove deprecated things. (f238b9fc)
- BREAKING FEAT: update env to 3.0.0+ and fix lints. (e35c614b)
- BREAKING FEAT: change state to sealed classes. (dcabfd41)
- BREAKING FEAT: remove deprecated things. (3e68942b)
- BREAKING FEAT: update env to 3.0.0+ and fix lints. (ff284686)
-
3.0.0-dev.103 Jan 2025 pre-release -
2.2.115 Dec 2024Nothing published for this version
-
2.2.014 Dec 2024Release notes
Open source →- FEAT: change CachedQuery.instance.refetchQueries() to a future. (047edffe)
-
2.1.429 Oct 2024Release notes
Open source → -
2.1.327 Oct 2024 -
2.1.227 Oct 2024Release notes
Open source →- REFACTOR: depriciate hasreachedmax on infinite query state. (3231390e)
2024-10-22
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v2.4.1cached_storage-v2.0.9
-
2.1.123 Oct 2024Release notes
Open source →- FIX: typing improvements. (c45c8f52)
2024-10-21
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
-
2.1.014 Sep 2024 -
2.0.719 Aug 2024Release notes
Open source →- FIX: keep time stamp if updating manually. (1655444e)
2024-08-19
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v2.1.3cached_storage-v2.0.6
-
2.0.619 Aug 2024Release notes
Open source →- FIX: allow updating state to null. (c0753854)
2024-07-18
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_storage-v2.0.5
-
2.0.518 Jul 2024Release notes
Open source →Release notes
Open source → -
2.0.418 Jun 2024Release notes
Open source →- FIX: infinite query getting stuck if it has max and the first page is different. (ce49d295)
2024-06-11
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Release notes
Open source →- FIX: infinite query getting stuck if it has max and the first page is different. (ce49d295)
-
2.0.322 May 2024Release notes
Open source →2024-05-20
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Release notes
Open source → -
2.0.220 May 2024 -
2.0.125 Apr 2024Release notes
Open source →- FIX: devtools not building. (03306c4b)
2024-03-11
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
-
2.0.012 Mar 2024Release notes
Open source →- n
2024-03-11
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Release notes
Open source →- Release 2.0.0
- FIX: lints. (d3677368)
- Graduate package to a stable release. See pre-releases prior to this version for changelog entries.
-
2.0.0-dev.311 Mar 2024 pre-release -
2.0.0-dev.213 Dec 2023 pre-release -
2.0.0-dev.124 Nov 2023 pre-release -
2.0.0-dev.023 Nov 2023 pre-release -
1.0.122 Oct 2023 -
1.0.008 Jul 2023Release notes
Open source →2023-07-08
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Release notes
Open source →- Graduate package to a stable release. See pre-releases prior to this version for changelog entries.
-
1.0.0-dev.119 Jun 2023 pre-releaseRelease notes
Open source →- chore: update packages
2023-06-19
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v0.6.0+3cached_storage-v1.0.0-dev.2
-
0.6.004 Mar 2023Release notes
Open source →- BREAKING FEAT: add filterFn to CachedQuery.instance.refetchQueries(). (1d452bba)
2023-02-18
Changes
Packages with breaking changes:
- There are no breaking changes in this release.
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_query_flutter-v0.6.0+1cached_storage-v0.2.0+3
Release notes
Open source →Note: This release has breaking changes.
- BREAKING FEAT: add filterFn to CachedQuery.instance.refetchQueries(). (1d452bba)
-
0.5.018 Feb 2023Release notes
Open source →- BREAKING FEAT: combine updateInfiniteQuery and updateQuery in the global CachedQuery object. (e8fd8602)
Release notes
Open source →Note: This release has breaking changes.
- BREAKING FEAT: combine updateInfiniteQuery and updateQuery in the global CachedQuery object. (e8fd8602)
-
0.5.0+118 Feb 2023Release notes
Open source →- DOCS: update docs for the depreciation of updateInfiniteQuery. (9fa99ef6)
2023-02-18
Changes
Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
cached_storage-v0.2.0+2
Release notes
Open source →- DOCS: update docs for the depreciation of updateInfiniteQuery. (9fa99ef6)
-
0.4.016 Dec 2022Release notes
Open source →Note: This release has breaking changes.
- BREAKING FEAT: allow refetch config per query. QueryConfig can no longer be const.
-
0.4.0+125 Jan 2023