refetch on external data change support added

packages/example/lib/components/query_external_data.dart

@@ -6,6 +6,7 @@ import 'package:flutter/material.dart';
 final jobWithExternalData = QueryJob<String, double>(
   queryKey: "query-external-data",
   cacheTime: const Duration(seconds: 10),
+  refetchOnExternalDataChange: false,
   task: (queryKey, data) {
     return Future.delayed(const Duration(milliseconds: 500),
         () => "Hello from $queryKey with $data");

packages/fl_query/lib/src/hooks/use_query.dart

@@ -75,13 +75,21 @@ Query<T, Outside> useQuery<T extends Object, Outside>({
     } else if (oldExternalData != null &&
         externalData != null &&
         !isShallowEqual(oldExternalData, externalData)) {
-      QueryBowl.of(context).fetchQuery(
+      if (job.refetchOnExternalDataChange ??
-        job,
+          queryBowl.refetchOnExternalDataChange) {
-        externalData: externalData,
+        QueryBowl.of(context).fetchQuery(
-        onData: onData,
+          job,
-        onError: onError,
+          externalData: externalData,
-        key: uKey,
+          onData: onData,
-      );
+          onError: onError,
+          key: uKey,
+        );
+      } else {
+        QueryBowl.of(context)
+            .getQuery(job.queryKey)
+            ?.setExternalData(externalData);
+      }
+
       if (hasOnDataChanged) query.value.onDataListeners.remove(oldOnData);
       if (hasOnErrorChanged) query.value.onErrorListeners.remove(oldOnError);
     } else {

packages/fl_query/lib/src/models/query_job.dart

@@ -32,6 +32,7 @@ class QueryJob<T extends Object, Outside> {
   // got from global options
   bool? refetchOnMount;
   bool? refetchOnReconnect;
+  bool? refetchOnExternalDataChange;
   Duration? staleTime;
   Duration? cacheTime;
 
@@ -49,6 +50,7 @@ class QueryJob<T extends Object, Outside> {
     this.refetchInterval,
     this.refetchOnMount,
     this.refetchOnReconnect,
+    this.refetchOnExternalDataChange,
   }) : _queryKey = queryKey;
 
   String get queryKey => _queryKey;
@@ -70,6 +72,7 @@ class QueryJob<T extends Object, Outside> {
     Duration? refetchInterval,
     bool? refetchOnMount,
     bool? refetchOnReconnect,
+    bool? refetchOnExternalDataChange,
   }) {
     return (String queryKey) {
       if (preQueryKey != null) queryKey = "$preQueryKey#$queryKey";
@@ -85,6 +88,7 @@ class QueryJob<T extends Object, Outside> {
         refetchInterval: refetchInterval,
         refetchOnMount: refetchOnMount,
         refetchOnReconnect: refetchOnReconnect,
+        refetchOnExternalDataChange: refetchOnExternalDataChange,
       );
     };
   }

packages/fl_query/lib/src/query_bowl.dart

@@ -60,6 +60,13 @@ class QueryBowlScope extends StatefulWidget {
   /// off by passing [Duration.zero]
   final Duration refetchOnReconnectDelay;
 
+  /// Refetch the query whenever the data passed as [externalData] to any
+  /// [QueryBuilder] or [useQuery] changes
+  ///
+  /// If set to false than the [externalData] will get updated but there
+  /// won't be any query update
+  final bool refetchOnExternalDataChange;
+
   /// used for periodically checking if any query got stale.
   /// If none is supplied then half of the value of staleTime is used
   final Duration refetchInterval;
@@ -74,6 +81,7 @@ class QueryBowlScope extends StatefulWidget {
     this.refetchOnReconnectDelay = const Duration(milliseconds: 100),
     this.refetchOnApplicationResume = true,
     this.refetchOnWindowFocus = true,
+    this.refetchOnExternalDataChange = false,
     Key? key,
   }) : super(key: key);
 
@@ -218,6 +226,7 @@ class _QueryBowlScopeState extends State<QueryBowlScope> {
       refetchInterval: widget.refetchInterval,
       refetchOnMount: widget.refetchOnMount,
       refetchOnReconnect: widget.refetchOnReconnect,
+      refetchOnExternalDataChange: widget.refetchOnExternalDataChange,
       child: widget.child,
     );
   }
@@ -237,6 +246,7 @@ class QueryBowl extends InheritedWidget {
   final Duration? refetchInterval;
   final bool refetchOnMount;
   final bool refetchOnReconnect;
+  final bool refetchOnExternalDataChange;
 
   final void Function<T extends Object, Outside>(Query<T, Outside> query)
       _addQuery;
@@ -263,6 +273,7 @@ class QueryBowl extends InheritedWidget {
     required this.clear,
     required this.refetchOnMount,
     required this.refetchOnReconnect,
+    required this.refetchOnExternalDataChange,
     this.refetchInterval,
     Key? key,
   })  : _addQuery = addQuery,
@@ -296,6 +307,7 @@ class QueryBowl extends InheritedWidget {
       if (onError != null) prevQuery.onErrorListeners.add(onError);
       if (!prevQuery.hasData || hasExternalDataChanged) {
         if (hasExternalDataChanged) prevQuery.setExternalData(externalData);
+
         return await prevQuery.refetch();
       }
       // mounting the widget that is using the query in the prevQuery

packages/fl_query/lib/src/query_builder.dart

@@ -77,13 +77,20 @@ class _QueryBuilderState<T extends Object, Outside>
     } else if (oldWidget.externalData != null &&
         widget.externalData != null &&
         !isShallowEqual(oldWidget.externalData!, widget.externalData!)) {
-      QueryBowl.of(context).fetchQuery(
+      if (widget.job.refetchOnExternalDataChange ??
-        widget.job,
+          queryBowl.refetchOnExternalDataChange) {
-        externalData: widget.externalData,
+        QueryBowl.of(context).fetchQuery(
-        onData: widget.onData,
+          widget.job,
-        onError: widget.onError,
+          externalData: widget.externalData,
-        key: uKey,
+          onData: widget.onData,
-      );
+          onError: widget.onError,
+          key: uKey,
+        );
+      } else {
+        QueryBowl.of(context)
+            .getQuery(widget.job.queryKey)
+            ?.setExternalData(widget.externalData);
+      }
       if (hasOnDataChanged) query?.onDataListeners.remove(oldWidget.onData);
       if (hasOnErrorChanged) query?.onErrorListeners.remove(oldWidget.onError);
     } else {