graphql v5.2.4

Fixed

• fix: upgrade normalize dependency to be 0.10.0 compatible

graphql_flutter v5.3.0

Changed

• BREAKING: switched from hive to hive_ce - users importing package:hive/hive.dart directly should switch to package:hive_ce/hive_ce.dart
• chore: update connectivity_plus from ^6.1.3 to ^7.0.0
• fix: update flutter_hooks constraint to <0.22.0

CI

• Upgrade GitHub Actions (actions/checkout@v4, subosito/flutter-action@v2)
• Fix publishing workflow triggers
• Migrate codecov to codecov-action@v4

Fixes #1506

Full Changelog: v-packages-v5.2.1...v-packages-v5.3.0

What's Changed

• fix(graphql_flutter): fix the graphql flutter by @vincenzopalazzo in #1490
• feat(graphql): Add deduplicatePollers, deepEquals, and queryRequestTimeout parameters to copyWith method in GraphQLClient by @hamed-rezaee in #1483

New Contributors

• @hamed-rezaee made their first contribution in #1483

Full Changelog: v-packages-v5.2.0...v-packages-v5.2.1

Fixed

• update flutter_hooks <0.22.0 (commit). @FujiKinaga 25-07-2025

Graphql v5.2.0

Fixed

• add queryRequestTimeout parameter to copyWith method (commit). @nestorsgarzonc 07-02-2025
• ensure readNormalized correctly merges Map<String, dyna… (commit). @nozomemein 07-02-2025
• update normalize dependency to version 0.9.1 (#1448) (commit). @nrbnlulu 11-09-2024
• upgrade web_socket_channel, dart sdk dependencies. Update tests to ignore missing closeCode (commit)
• upgrade rxdart 0.28.0 (#1454) (commit). @ronnnnn 30-08-2024
• add query timeout argument when create client. (commit). @ykuc7 29-08-2024
• add timeout to _resolveQueryOnNetwork (commit). @ykuc7 18-07-2024
• make == override parameters non-nullable (commit). @kamilkarp 01-04-2024
• response extensions should be optional (commit). @kamilkarp 31-03-2024
• fix error is throwed when toggleConnection != null (commit). @hantrungkien 27-05-2024
• transform nested object from box (commit). @ronnnnn 09-04-2024
• check for null data returned from fetchMore.updateQuery… (commit). @aarsham 08-04-2024
• resolve duplicate events on socket reconnect (commit). @aarsham 08-04-2024
• remove unnecessary null checks in SocketClient (commit). @aarsham 08-04-2024
• bump uuid dependency to ^4.0.0 (commit). @francescoberardi 23-11-2023
• Send SubscriptionComplete message when using graphqlTra… (commit). @ 30-08-2023
• bumps http to v1 (commit). @moisessantos 06-07-2023
• Cache parsed data (commit). @budde377 03-06-2023
• onComplete callback should send null (commit). @budde377 12-03-2023
• upgrade the ws packege to v2.3.0 (commit). @vincenzopalazzo 15-01-2023
• remove unecessary deprecation code (commit). @vincenzopalazzo 15-01-2023
• support @include and @Skip with new normalize major ver (commit). @vincenzopalazzo 15-01-2023

Added

• make timeout configurable in query options (#1475) (commit). @ndelanou 28-12-2024
• Support custom equality function for cache comparison (commit). @kvenn 05-08-2024
• Send custom payload in PingMessage (commit). @Rochak69 31-08-2023
• added WebSocket token refresh and autoReconnect toggling (commit). @vytautas-pranskunas- 24-07-2023
• bump sdk version upper bound to <4.0.0 (commit). @ndelanou 17-05-2023
• bump gql version to 1.0.0 (commit). @ndelanou 03-05-2023
• print the connection status with ws (commit). @vytautas-pranskunas- 15-03-2023

Graphql flutter v5.2.0

Fixed

• update connectivity_plus version to fix Android… (commit). @khanderz 26-02-2025
• update connectivity_plus version to fix Android… (commit). @khanderz 26-02-2025
• upgrade meta,path,dart dependencies (commit)
• make == override parameters non-nullable (commit). @kamilkarp 01-04-2024
• response extensions should be optional (commit). @kamilkarp 31-03-2024
• upgrade connectivity_plus (commit). @hantrungkien 27-05-2024
• upgrade dependency connectivity_plus (commit). @johnmartel 25-04-2024
• uses the last graphql package (commit). @vincenzopalazzo 28-05-2024
• bumps http to v1 (commit). @moisessantos 06-07-2023
• added missing onSubscriptionResult argument (commit). @PhilippS93 03-04-2023

Added

• bump connectivity_plus to 5.0.0 (commit). @erknvl 10-10-2023
• Cache parsed data (commit). @budde377 03-06-2023
• bump connectivity_plus dependency to ^4.0.0 (commit). @ndelanou 24-05-2023
• bump sdk version upper bound to <4.0.0 (commit). @ndelanou 17-05-2023
• bump gql version to 1.0.0 (commit). @ndelanou 03-05-2023

Fixed

• update connectivity_plus version to fix Android… (commit). @khanderz 26-02-2025
• update connectivity_plus version to fix Android… (commit). @khanderz 26-02-2025
• upgrade meta,path,dart dependencies (commit)
• make == override parameters non-nullable (commit). @kamilkarp 01-04-2024
• response extensions should be optional (commit). @kamilkarp 31-03-2024
• upgrade connectivity_plus (commit). @hantrungkien 27-05-2024
• upgrade dependency connectivity_plus (commit). @johnmartel 25-04-2024
• uses the last graphql package (commit). @vincenzopalazzo 28-05-2024
• bumps http to v1 (commit). @moisessantos 06-07-2023
• added missing onSubscriptionResult argument (commit). @PhilippS93 03-04-2023

Added

• bump connectivity_plus to 5.0.0 (commit). @erknvl 10-10-2023
• Cache parsed data (commit). @budde377 03-06-2023
• bump connectivity_plus dependency to ^4.0.0 (commit). @ndelanou 24-05-2023
• bump sdk version upper bound to <4.0.0 (commit). @ndelanou 17-05-2023
• bump gql version to 1.0.0 (commit). @ndelanou 03-05-2023

Fixed

• update connectivity_plus version to fix Android… (commit). @khanderz 26-02-2025

v5.2.0-beta.7

Fixed

• make == override parameters non-nullable (commit). @kamilkarp 01-04-2024
• response extensions should be optional (commit). @kamilkarp 31-03-2024
• upgrade connectivity_plus (commit). @hantrungkien 27-05-2024
• upgrade dependency connectivity_plus (commit). @johnmartel 25-04-2024
• uses the last graphql package (commit). @vincenzopalazzo 28-05-2024

Fixed

• make == override parameters non-nullable (commit). @kamilkarp 01-04-2024
• response extensions should be optional (commit). @kamilkarp 31-03-2024
• upgrade connectivity_plus (commit). @hantrungkien 27-05-2024
• upgrade dependency connectivity_plus (commit). @johnmartel 25-04-2024
• uses the last graphql package (commit). @vincenzopalazzo 28-05-2024

Added

• bump connectivity_plus to 5.0.0 (commit). @erknvl 10-10-2023

Fixed

• bumps http to v1 (commit). @moisessantos 06-07-2023

Added

• Cache parsed data (commit). @budde377 03-06-2023
• bump connectivity_plus dependency to ^4.0.0 (commit). @ndelanou 24-05-2023

Added

• bump sdk version upper bound to <4.0.0 (commit). @ndelanou 17-05-2023

Fixed

• added missing onSubscriptionResult argument (commit). @PhilippS93 03-04-2023

Added

• bump gql version to 1.0.0 (commit). @ndelanou 03-05-2023

Fixed

• fix ws dependencies version to 2.2.0 (commit). @vincenzopalazzo 12-01-2023

Fixed

• increase connectivity_plus version to v3 (commit). @vincenzopalazzo 03-12-2022
• fix wrong default policy merging in useWatchQue… (commit). @dehypnosis 22-07-2022
• Upgrade graphql version (commit). @budde377 23-04-2022
• Correctly add web as supported platform (commit). @budde377 23-04-2022

Added

• support flutter 3.0 and 2.x (commit). @vincenzopalazzo 20-05-2022
• added query onError & onComplete callbacks (commit). @fabis94 22-04-2022
• Decouple GraphQLClient Provider (commit). @budde377 19-04-2022

Fixed

• increase connectivity_plus version to v3 (commit). @vincenzopalazzo 03-12-2022

Fixed

• fix wrong default policy merging in useWatchQue… (commit). @dehypnosis 22-07-2022

New Feature

• support flutter 3.0 and 2.x (commit). @vincenzopalazzo 20-05-2022

Fixes

• Upgrade graphql version (commit). @budde377 23-04-2022

New Feature

• added query onError & onComplete callbacks (commit). @fabis94 22-04-2022
• Decouple GraphQLClient Provider (commit). @budde377 19-04-2022

Fixes

• Correctly add web as supported platform (commit). @budde377 23-04-2022

New Feature

• Stricter analysis (https://github.com/zino-hofmann/graphql-flutter/commit/131ea1f78b55554f730269f94aad11fb1d07cc44). @budde377 19-03-2022

New Feature

• Stricter analysis (https://github.com/zino-hofmann/graphql-flutter/commit/131ea1f78b55554f730269f94aad11fb1d07cc44). @budde377 19-03-2022

• due a bug we miss all the changelog until the version # v5.0.2-beta.6, we need to fix it soon

5.0.1-beta.1 (2021-12-09)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-08)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-07)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-06)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-05)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-04)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-03)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-02)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-12-01)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-11-30)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-11-29)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-11-28)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-11-27)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

5.0.1-beta.1 (2021-11-26)

Performance Improvements

• open Hive boxes concurrently (33ea16e)

Bug Fixes

• ci: graphql coverage (d47852a)
• ci: refine dartanalyzer for example (e7b5830)
• ci: stop using test_coverage (28e499e)
• ci: try dart analyze (61e9f81)
• client: always only pull broadcast stream once (1b6a9e6)
• client: AuthLink getToken result should be nullable. (7f36a68)
• client: fix rebroadcasting for regular queries (3245e27)
• client: fix rebroadcasting for regular queries (0c6b0e7)
• client: hotfix dataIdFromObject passthrough in cache.readQuery (e3e04f8)
• examples: upgrade to nullsafety (fe69bce)
• flutter: make sure starwars works with nullsafe changes (6d27c64)
• graphql: only return subscriptions eagerly from cache when a cache-enabled policy is used (8af2edd)

Features

• client: Capture stack traces in UnknownExceptions (4b36c09)
• client: null safe by default (802185a)
• client: SocketClient with web_socket_channel (6631f42)
• Expose possibleTypes on cache (#906) (49483ad)

BREAKING CHANGES

• client: Null Safety

Features

• client: Capture stack traces in UnknownExceptions (4b36c09)

Bug Fixes

• ci: refine dartanalyzer for example (e7b5830)
• ci: stop using test_coverage (28e499e)
• ci: try dart analyze (61e9f81)
• client: AuthLink getToken result should be nullable. (7f36a68)
• examples: upgrade to nullsafety (fe69bce)
• flutter: make sure starwars works with nullsafe changes (6d27c64)
• graphql: only return subscriptions eagerly from cache when a cache-enabled policy is used (8af2edd)

Features

• client: null safe by default (802185a)

BREAKING CHANGES

• client: Null Safety

Bug Fixes

• client: fix rebroadcasting for regular queries (0c6b0e7)

Bug Fixes

• ci: graphql coverage (d47852a)
• client: always only pull broadcast stream once (1b6a9e6)

Features

• client: SocketClient with web_socket_channel (6631f42)

4.0.2-beta.1 (2021-02-08)

Bug Fixes

• client: hotfix dataIdFromObject passthrough in cache.readQuery (e3e04f8)

4.0.1 (2021-02-07)

Bug Fixes

• client: hotfix dataIdFromObject passthrough in cache.readQuery (000d59f)

Bug Fixes

• examples: starwars example cache (22db4f7)
• fix ObservableQuery.lifecycle for cache only results (f44b479)
• client: mutation not firing observer callbacks (75393c2)
• query test (f54c6ae)
• ci: loosen path version (645d462)
• client: add CacheMissException for when write/read results in null (a0a967f)
• client: fetchMore partial handling (10ec576)
• client: gql_http_link==0.3.2 for custom toJsons closing #734 (98b8cf7)
• client: only queries are refetch safe (1e93376)
• client: refetch overrides fetchPolicy (891bc2b)
• client: skip cache writes on null data, thus fixing #405 (7472bb9)
• client: wrap all subscription errors in QueryResults (aae61ca)
• docs: typo in docstring, add todo to sanitizeVariables (9c84cb1)
• examples: cleanup bloc example (82724f0)
• examples: flutter bloc pubspec (61582b3)
• examples: ignore missing token (ffd3294)
• examples: starwars example works again (7514b93)
• examples: update ios files for graphql_flutter/example (5b6e3d0)
• graphql: default-yet-overrideable variable (6ba687e)
• graphql: don't close mutations after callbacks (2ba6c74)
• graphql: dumb ?? documentNode bug (ba7b641)
• graphql: fix rebroadcasting by refactoring onData callbacks into a simpler async function (9a5fff1)
• graphql: keep deprecated QueryResult api and mark it as such (2b447a0)
• graphql: sanitize multipart files for cache (4ceb800)
• graphql: simplified AuthLink (0b3fbd9)
• tests: update tests (bba4a7a)

Features

• cache now flags itself for broadcasting (84cba43)
• client.fetchMore utility for leveraging the fetch more logic results without using ObservableQuery (814ccb3)
• documentNode -> document, dependency issues, reexport links from client (for now), retrieve subscription changes from #533 (4fb205c)
• graphql: HiveStore.open (6db4677)
• drop Link layer in favor of package:gql_link and package:gql_exec (2e491a7)
• client: add context to QueryResult (fbc5a2d)
• client: cache proxy methods on cache, resetStore with optional refetchQueries (ba7134a)
• client: cache writes are now strict, and throw PartialDataException (from normalize), (616b5ed)
• client: CacheRereadPolicy, watchMutation workaround (32e02da)
• client: carry forward data on exception (ccf3b9c)
• client: expose store, cleanup (6fc5e7e)
• client: only rebroadcast on deep equals (ee64e99)
• client: partialDataPolicy for configuring rejections (0a7cd28)
• client: QueryResult.unexecuted (13e3257)
• client: refetchSafeQueries, clarify rebroadcast calls in docs (e45b240)
• docs: v4 changelog (38cfd9b)
• examples: reorg graphql example so pub displays code (bc32bdd)
• examples: starwars hivestore usage (2f874ec)
• graphql: add isMutation etc helpers to Options types (04e7888)
• graphql: complete caching overhaul (e9b5660)
• graphql: HiveStore api improvements, fetchmore fixes (2d1a7f2)
• graphql: multipart file support (c2733ca)
• graphql: re-add documentNode asdeprecated (20d0176)
• more work on gql links (0d7ef7a)
• graphql: Robust ObservableQuery docs (1e893b5)
• graphql: update old websocket_link (496d994)
• graphql: upgrade normalize to 0.4.2 (4655e7d)
• graphql: use new cache correctly everywhere else (f64a6c8)
• starting on gql links (d9452bc)
• graphql: work on making subscriptions more of a first-class citizen (6d0b045)
• graphql_flutter: add ResultAccumulator, fix Subscription (7e1edee)
• graphql_flutter: initHiveForFlutter (1118cc7)
• HiveStore (2c3c66c)
• move to DocumentNode-only documents (7499323)
• graphql_flutter: work on making subscriptions more of a first-class citizen (a0e0d5c)
• tests: test subscriptions (2a3e6a1)

BREAKING CHANGES

• client: By fixing the defaults for mutations, the old behavior is now lost
• the deprecated string documents are no longer supported
• Link layer is now implemented via package:gql_link and package:gql_exec

Features

• client: add context to QueryResult (fbc5a2d)
• client: CacheRereadPolicy, watchMutation workaround (32e02da)
• client: QueryResult.unexecuted (13e3257)

BREAKING CHANGES

• client: By fixing the defaults for mutations, the old behavior is now lost

Bug Fixes

• fix ObservableQuery.lifecycle for cache only results (f44b479)

Bug Fixes

• client: wrap all subscription errors in QueryResults (aae61ca)

Bug Fixes

• client: add CacheMissException for when write/read results in null (a0a967f)
• client: fetchMore partial handling (10ec576)
• client: skip cache writes on null data, thus fixing #405 (7472bb9)

Features

• client: cache writes are now strict, and throw PartialDataException (from normalize), (616b5ed)
• client: carry forward data on exception (ccf3b9c)
• client: only rebroadcast on deep equals (ee64e99)
• client: partialDataPolicy for configuring rejections (0a7cd28)

Bug Fixes

• client: refetch overrides fetchPolicy (891bc2b)

Features

• graphql: upgrade normalize to 0.4.2 (4655e7d)

v4 reworks a lot of the internals of the core graphql/client.dart (and thus graphql_flutter).

Please see the v4 changelog for more details, and the updated READMEs for more extensive documentation.

The following was autogenerated from ill-manicured commits:

Bug Fixes

• examples: ignore missing token (ffd3294)
• query test (f54c6ae)
• ci: loosen path version (645d462)
• client: gql_http_link==0.3.2 for custom toJsons closing #734 (98b8cf7)
• client: mutation not firing observer callbacks (75393c2)
• client: only queries are refetch safe (1e93376)
• docs: typo in docstring, add todo to sanitizeVariables (9c84cb1)
• examples: cleanup bloc example (82724f0)
• examples: flutter bloc pubspec (61582b3)
• examples: starwars example cache (22db4f7)
• examples: starwars example works again (7514b93)
• examples: update ios files for graphql_flutter/example (5b6e3d0)
• graphql: default-yet-overrideable variable (6ba687e)
• graphql: don't close mutations after callbacks (2ba6c74)
• graphql: dumb ?? documentNode bug (ba7b641)
• graphql: fix rebroadcasting by refactoring onData callbacks into a simpler async function (9a5fff1)
• graphql: keep deprecated QueryResult api and mark it as such (2b447a0)
• graphql: sanitize multipart files for cache (4ceb800)
• graphql: simplified AuthLink (0b3fbd9)
• tests: update tests (bba4a7a)

Features

• cache now flags itself for broadcasting (84cba43)
• client.fetchMore utility for leveraging the fetch more logic results without using ObservableQuery (814ccb3)
• documentNode -> document, dependency issues, reexport links from client (for now), retrieve subscription changes from #533 (4fb205c)
• graphql_flutter: add ResultAccumulator, fix Subscription (7e1edee)
• drop Link layer in favor of package:gql_link and package:gql_exec (2e491a7)
• client: cache proxy methods on cache, resetStore with optional refetchQueries (ba7134a)
• client: expose store, cleanup (6fc5e7e)
• client: refetchSafeQueries, clarify rebroadcast calls in docs (e45b240)
• docs: v4 changelog (38cfd9b)
• examples: reorg graphql example so pub displays code (bc32bdd)
• examples: starwars hivestore usage (2f874ec)
• graphql: add isMutation etc helpers to Options types (04e7888)
• graphql: complete caching overhaul (e9b5660)
• graphql: HiveStore api improvements, fetchmore fixes (2d1a7f2)
• graphql: HiveStore.open (6db4677)
• graphql: multipart file support (c2733ca)
• graphql: re-add documentNode asdeprecated (20d0176)
• graphql: Robust ObservableQuery docs (1e893b5)
• graphql: update old websocket_link (496d994)
• graphql: use new cache correctly everywhere else (f64a6c8)
• HiveStore (2c3c66c)
• more work on gql links (0d7ef7a)
• move to DocumentNode-only documents (7499323)
• starting on gql links (d9452bc)
• graphql: work on making subscriptions more of a first-class citizen (6d0b045)
• graphql_flutter: initHiveForFlutter (1118cc7)
• graphql_flutter: work on making subscriptions more of a first-class citizen (a0e0d5c)
• tests: test subscriptions (2a3e6a1)

BREAKING CHANGES

• the deprecated string documents are no longer supported
• Link layer is now implemented via package:gql_link and package:gql_exec

• hotfix(client): gql_http_link==0.3.2 for custom toJsons closing #734 (98b8cf7)

• hotfix(client): gql_http_link==0.3.1 fix for bool json encoding support (38b2fd2)

:warning: breaking: the cache.readFragment / cache.readFragment API has been reworked:

  final fragDoc = gql(...);

  final idFields = { '__typename': 'MyType', 'id': 1 }

  final fragmentData = {
    'myField': 'updatedValue',
    'someNewField': [
      {'newData': false}
    ],
  };

+ // or Fragment(document: fragDoc).asRequest(idFields: idFields)
+ final fragmentRequest = FragmentRequest(
+   fragment: Fragment(
+     document: fragDoc,
+   ),
+   idFields: idFields,
+ );

  cache.writeFragment(
-   fragment: fragDoc,
-   idFields: idFields,
+   fragmentRequest,
    data: fragmentData,
  );

This was done because I (@micimize) wanted to make it more consistent with cache.readQuery/cache.writeQuery before beta.

• client: refactor(client): Fragment and FragmentRequest for more normalized api (2f04058)
• docs: update docs, add more sections (00f4a97)

This was mostly a prep release for the first v4 beta.

• client: cache proxy methods on cache, resetStore with optional refetchQueries (ba7134a)
• test(client): more cache and store tests (a9eed21)
• examples: merge and update flutter_bloc changes (ac4759a)
• docs: correct multipart example (f9d1adb)
• chore: re-merge changelog and templates (9db0b44)
• tests: restore old websocket client tests (https://github.com/zino-app/graphql-flutter/commit/3e4870c)
• refactor: pollInterval is now a Duration (fe02bb8)
• chore: I think fixes coverage and lint (d37e81c)

GraphQLClient now implements GraphQLDataProxy, exposing readQuery, writeQuery, readFragment, and writeFragment. The writing methods also trigger rebroadcasts, closing #728.

It also adds an experimental client.resetStore({refetchQueries = true}) for refetching the results of all observed queries (not mutations), and expose cache.store with a WARNING about direct access.

• client: cache proxy methods on cache, resetStore with optional refetchQueries (ba7134a)
• client: refetchSafeQueries, clarify rebroadcast calls in docs (e45b240)
• client: expose store, cleanup (6fc5e7e)
• client: add isMutation etc helpers to Options types (04e7888)
• fix: only queries are refetch safe (1e93376)
• refactor: clean up unused helpers, clarify shoudRebroadcast (1cf6478)

• client: fix subscription initial result from cache (de66cff)

• cache: sanitize multipart files for cache. (4ceb800)

• client: bring back old websocket link with gql adapter layer (496d994)
• client: multipart file support from gql_http_link==0.3.0 (c2733ca)

• client: don't close mutations after callbacks (2ba6c74)
• examples: update ios files for graphql_flutter/example (5b6e3d0)

• client: simplified AuthLink (0b3fbd9)
• docs: direct cache access in changelog (1f21927)
• examples: starwars hivestore usage (2f874ec)
• graphql: HiveStore api improvements (2d1a7f2)
• fix: FetchMoreOptions was throwing without document (2d1a7f2)
• fix: deeplyMergeLeft type error (65fdcb2)