Result Context, watchMutation, CacheRereadPolicy

[micimize]

Closes #793
Closes #774

Breaking changes

• Broke default Mutation behavior, which can be regained by overriding DefaultPolicies.watchMutation.

Fixes / Enhancements

• Fixed Mutation behavior by introducing watchMutation, which should mitigate the problems in mutations through watchQuery use cacheAndNetwork, which yields unexpected results #774
• Added CacheRereadPolicy for controlling normalized re-reads and rebroadcast behavior more granularly
• Added response.context to QueryResult (Make QueryResult include context #793)
• Added QueryResult.unexecuted singleton for unexecuted mutations

watchMutation default policies are the same as mutation:

Policies(FetchPolicy.networkOnly, ErrorPolicy.none, CacheRereadPolicy.ignoreAll)

the old behavior can be regained via

Policies(FetchPolicy.cacheAndNetwork, ErrorPolicy.none, CacheRereadPolicy.mergeOptimistic)

Docs

• Added docs on CacheRereadPolicy and watchMutation

[codecov]

Codecov Report

Merging #795 (6e9ae85) into beta (8e4e7d9) will increase coverage by 0.22%.
The diff coverage is 50.98%.

@@            Coverage Diff             @@
##             beta     #795      +/-   ##
==========================================
+ Coverage   49.52%   49.74%   +0.22%     
==========================================
  Files          35       35              
  Lines        1357     1389      +32     
==========================================
+ Hits          672      691      +19     
- Misses        685      698      +13     

Flag	Coverage Δ
graphql_client	53.01% <54.16%> (+0.22%)	⬆️
graphql_flutter	31.42% <0.00%> (-0.16%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
...ackages/graphql/lib/src/core/mutation_options.dart	29.72% <ø> (ø)
packages/graphql/lib/src/core/query_options.dart	25.45% <0.00%> (-0.97%)	⬇️
packages/graphql/lib/src/core/query_result.dart	45.94% <0.00%> (-1.28%)	⬇️
packages/graphql/lib/src/graphql_client.dart	74.35% <0.00%> (-8.50%)	⬇️
...ages/graphql_flutter/lib/src/widgets/mutation.dart	0.00% <0.00%> (ø)
packages/graphql/lib/src/core/_base_options.dart	60.00% <50.00%> (-2.07%)	⬇️
packages/graphql/lib/src/core/policies.dart	53.24% <52.17%> (+4.06%)	⬆️
packages/graphql/lib/src/core/query_manager.dart	68.08% <77.77%> (+1.90%)	⬆️
...es/graphql/lib/src/core/_query_write_handling.dart	65.38% <100.00%> (+1.38%)	⬆️
...ackages/graphql/lib/src/core/observable_query.dart	45.31% <100.00%> (+0.43%)	⬆️
... and 1 more

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 8e4e7d9...a2292ed. Read the comment docs.

[HofmannZ]

🎉 This PR is included in version 4.0.0-beta.7 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀

[HofmannZ]

🎉 This PR is included in version 4.0.0 🎉

The release is available on GitHub release

Your semantic-release bot 📦🚀