fl_query 1.0.0-alpha.2

Asynchronous data caching, refetching & invalidation library for Flutter

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

1.0.0-alpha.2 (2023-03-12)

Features

• QueryClientProvider: add config parameters and override-able client parameter (f8895e3)

1.0.0-alpha.1 (2023-03-05)

BREAKING

• The Jobs API has been disabled. So there's no QueryJob, MutationJob and InfiniteQueryJob anymore. Instead, you can use the QueryBuilder, MutationBuilder and InfiniteQueryBuilder directly
• Some of classes were renamed to more mature names
  • QueryBowlProvider -> QueryClientProvider
  • QueryBowl -> QueryClient
• The unnecessary getPreviousPageParam is now removed from InfiniteQuery
• getNextPageParam has been renamed to nextPage
• Also, fetchNextPage has been renamed to fetchNext
• Query and InfiniteQuery's setQueryData has been renamed to setData and it now accepts data directly instead of a call back function
• Finally, QueryClient's unneeded prefetchQuery method was eradicated

Features

• add infinite query builder (efa2c81)
• add mutation and mutation builder (6a90f84)
• add query and infinite query disk caching support (074175e)
• add Cache, Client, QueryBuilder widget and refreshOnQueryFnChange support for queries (18584a3)
• InfiniteQuery implementation (45b6f92)
• add InfiniteQueryListenable widget and cache event stream (783a273)
• add Query and Retryer (b304466)
• infinite query's nextPage method (f2a23b0)
• new QueryListableBuilder widget (975f9ea)
• safe cancellation of running operation on reset (5dde200)
• safe setState for builders, separate cache box for query and infinite query (68e60c1)
• add usMutation hook (383d0e0)
• add useInfiniteQuery hook (f9a5207)
• add useQuery hook (7fabf44)

0.3.1 (2022-10-03)

Bug Fixes

• infinite_query: getNextPageParam & getPreviousPageParam cannot return null (e9c8b79)
• base_query: onData callback getting called with null #17 (664e90e)

0.3.0 (2022-09-23)

Features

• add initial support for InfiniteQuery (1452d7d)
• infinite-query: add useInfiniteQuery hook with example (2a3ac29)
• infinite-query: add all the features of query in infinite query (61958c7)
• infinite-query: add refetchPages, refetchOnStale, refetchOnMount support (95b1837)
• infinite-query: add setInfiniteQueryData support (6eb7b2a)
• infinite-query: onData and onError listener support (f47ca98)
• query_bowl: QueryBowl as separate class
• performance: lazily update ListenerWidgets or listeners instead of triggering an update for whole widget tree

Bug Fixes

• InfiniteQueryJob: remove unneeded keepPreviousData property (8df1fc5)

v0.2.0

New

• Paginated/Lagged Query support using QueryJob's keepPreviousData
• Mutation event context (returned data from onMutate available in onData & onError)
• Support for refetchOnMount. Now query will be refetched when a new widget is mounted.

Improvements

• Only one Query & Mutation instance in QueryBuilder & MutationBuilder which reduces memory usage
• Optimistic updates are now context driven

v0.1.0

Initial Release

• QueryBowl & QueryBowlScope for managing & caching all the query data.
• Query for advanced fetch, refetch & data management APIs
• Mutation for advanced mutate (a function that modifies data somewhere) & post-mutation management APIs
• QueryJob for defining the logic of how data should be fetched or refetched or invalidated
• MutationJob for defining the logic of how data should be mutated
• QueryBuilder for binding the Query & QueryJob to a Flutter Widget
• MutationBuilder for binding the Mutation & MutationJob to a Flutter Widget