@apollo/client 4.0.0-alpha.0 → 4.0.0-alpha.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.changeset/afraid-moons-arrive.md +5 -0
- package/.changeset/beige-mirrors-talk.md +15 -0
- package/.changeset/clean-sheep-hide.md +6 -0
- package/.changeset/cool-bikes-shake.md +12 -0
- package/.changeset/cool-kiwis-hunt.md +15 -0
- package/.changeset/cuddly-spiders-tie.md +5 -0
- package/.changeset/dirty-eagles-poke.md +5 -0
- package/.changeset/early-eggs-develop.md +22 -0
- package/.changeset/eighty-squids-fix.md +15 -0
- package/.changeset/eleven-kangaroos-jump.md +5 -0
- package/.changeset/forty-shrimps-fry.md +5 -0
- package/.changeset/forty-tomatoes-punch.md +5 -0
- package/.changeset/four-countries-clean.md +24 -0
- package/.changeset/four-ghosts-watch.md +5 -0
- package/.changeset/funny-jeans-invent.md +16 -0
- package/.changeset/funny-terms-deny.md +5 -0
- package/.changeset/fuzzy-tips-sit.md +5 -0
- package/.changeset/gentle-badgers-train.md +5 -0
- package/.changeset/giant-apes-thank.md +5 -0
- package/.changeset/giant-bags-share.md +5 -0
- package/.changeset/gorgeous-chefs-tap.md +5 -0
- package/.changeset/great-roses-jog.md +15 -0
- package/.changeset/grumpy-vans-type.md +5 -0
- package/.changeset/hip-vans-act.md +5 -0
- package/.changeset/hungry-bikes-cough.md +5 -0
- package/.changeset/itchy-chefs-run.md +23 -0
- package/.changeset/khaki-keys-deliver.md +5 -0
- package/.changeset/khaki-spies-work.md +11 -0
- package/.changeset/large-plants-know.md +5 -0
- package/.changeset/light-apes-rescue.md +5 -0
- package/.changeset/little-spoons-kick.md +7 -0
- package/.changeset/loud-cows-raise.md +7 -0
- package/.changeset/many-buses-allow.md +5 -0
- package/.changeset/mean-lizards-think.md +5 -0
- package/.changeset/nervous-fireants-bow.md +5 -0
- package/.changeset/nervous-goats-allow.md +5 -0
- package/.changeset/nice-dots-matter.md +5 -0
- package/.changeset/ninety-bags-bake.md +17 -0
- package/.changeset/odd-chicken-hide.md +17 -0
- package/.changeset/odd-lemons-relax.md +5 -0
- package/.changeset/perfect-vans-give.md +7 -0
- package/.changeset/poor-eels-punch.md +5 -0
- package/.changeset/pre.json +67 -0
- package/.changeset/purple-bears-flash.md +5 -0
- package/.changeset/rare-houses-prove.md +5 -0
- package/.changeset/real-teachers-peel.md +5 -0
- package/.changeset/serious-moons-juggle.md +5 -0
- package/.changeset/seven-dragons-repair.md +14 -0
- package/.changeset/shaggy-pugs-add.md +52 -0
- package/.changeset/short-months-complain.md +5 -0
- package/.changeset/slimy-chicken-melt.md +5 -0
- package/.changeset/slimy-maps-press.md +5 -0
- package/.changeset/small-buttons-rhyme.md +5 -0
- package/.changeset/swift-rivers-share.md +13 -0
- package/.changeset/tall-bikes-develop.md +5 -0
- package/.changeset/tame-doors-shop.md +14 -0
- package/.changeset/tame-points-work.md +11 -0
- package/.changeset/tender-swans-flash.md +16 -0
- package/.changeset/thick-books-grin.md +5 -0
- package/.changeset/thin-peas-hear.md +16 -0
- package/.changeset/tidy-pandas-punch.md +5 -0
- package/.changeset/tough-rockets-allow.md +5 -0
- package/.changeset/tricky-tables-shave.md +5 -0
- package/.changeset/unlucky-kiwis-sell.md +5 -0
- package/.changeset/warm-ties-sit.md +7 -0
- package/.changeset/wicked-forks-double.md +33 -0
- package/.changeset/young-phones-fold.md +5 -0
- package/.changeset/young-snails-grin.md +5 -0
- package/CHANGELOG.md +507 -0
- package/__cjs/cache/core/cache.cjs +3 -3
- package/__cjs/cache/core/cache.cjs.map +1 -1
- package/__cjs/cache/core/cache.d.cts +19 -19
- package/__cjs/cache/core/types/Cache.cjs.map +1 -1
- package/__cjs/cache/core/types/Cache.d.cts +9 -16
- package/__cjs/cache/core/types/DataProxy.d.cts +8 -23
- package/__cjs/cache/core/types/common.cjs +1 -0
- package/__cjs/cache/core/types/common.cjs.map +1 -1
- package/__cjs/cache/index.cjs +4 -4
- package/__cjs/cache/index.cjs.map +1 -1
- package/__cjs/cache/index.d.cts +3 -3
- package/__cjs/cache/inmemory/entityStore.cjs +6 -5
- package/__cjs/cache/inmemory/entityStore.cjs.map +1 -1
- package/__cjs/cache/inmemory/entityStore.d.cts +3 -2
- package/__cjs/cache/inmemory/fragmentRegistry.cjs +3 -3
- package/__cjs/cache/inmemory/fragmentRegistry.cjs.map +1 -1
- package/__cjs/cache/inmemory/helpers.cjs +0 -8
- package/__cjs/cache/inmemory/helpers.cjs.map +1 -1
- package/__cjs/cache/inmemory/helpers.d.cts +3 -4
- package/__cjs/cache/inmemory/inMemoryCache.cjs +6 -18
- package/__cjs/cache/inmemory/inMemoryCache.cjs.map +1 -1
- package/__cjs/cache/inmemory/inMemoryCache.d.cts +9 -11
- package/__cjs/cache/inmemory/policies.cjs +5 -5
- package/__cjs/cache/inmemory/policies.cjs.map +1 -1
- package/__cjs/cache/inmemory/policies.d.cts +1 -1
- package/__cjs/cache/inmemory/reactiveVars.cjs.map +1 -1
- package/__cjs/cache/inmemory/reactiveVars.d.cts +7 -7
- package/__cjs/cache/inmemory/readFromStore.cjs +12 -54
- package/__cjs/cache/inmemory/readFromStore.cjs.map +1 -1
- package/__cjs/cache/inmemory/readFromStore.d.cts +1 -6
- package/__cjs/cache/inmemory/types.d.cts +3 -17
- package/__cjs/cache/inmemory/writeToStore.cjs +4 -4
- package/__cjs/cache/inmemory/writeToStore.cjs.map +1 -1
- package/__cjs/cache/inmemory/writeToStore.d.cts +2 -2
- package/__cjs/config/jest/areCombinedGraphQLErrorsEqual.cjs +6 -4
- package/__cjs/config/jest/areCombinedGraphQLErrorsEqual.cjs.map +1 -1
- package/__cjs/config/jest/areCombinedProtocolErrorsEqual.cjs +3 -3
- package/__cjs/config/jest/areCombinedProtocolErrorsEqual.cjs.map +1 -1
- package/__cjs/config/jest/areMissingFieldErrorsEqual.cjs +2 -3
- package/__cjs/config/jest/areMissingFieldErrorsEqual.cjs.map +1 -1
- package/__cjs/config/jest/areServerErrorsEqual.cjs +22 -0
- package/__cjs/config/jest/areServerErrorsEqual.cjs.map +1 -0
- package/__cjs/config/jest/areServerErrorsEqual.d.cts +3 -0
- package/__cjs/config/jest/resolver.cjs +11 -0
- package/__cjs/config/jest/resolver.cjs.map +1 -1
- package/__cjs/config/jest/setup.cjs +18 -1
- package/__cjs/config/jest/setup.cjs.map +1 -1
- package/__cjs/core/ApolloClient.cjs +36 -19
- package/__cjs/core/ApolloClient.cjs.map +1 -1
- package/__cjs/core/ApolloClient.d.cts +36 -26
- package/__cjs/core/LocalState.cjs +2 -2
- package/__cjs/core/LocalState.cjs.map +1 -1
- package/__cjs/core/LocalState.d.cts +8 -8
- package/__cjs/core/ObservableQuery.cjs +268 -104
- package/__cjs/core/ObservableQuery.cjs.map +1 -1
- package/__cjs/core/ObservableQuery.d.cts +156 -17
- package/__cjs/core/QueryInfo.cjs +12 -86
- package/__cjs/core/QueryInfo.cjs.map +1 -1
- package/__cjs/core/QueryInfo.d.cts +2 -11
- package/__cjs/core/QueryManager.cjs +148 -104
- package/__cjs/core/QueryManager.cjs.map +1 -1
- package/__cjs/core/QueryManager.d.cts +45 -24
- package/__cjs/core/index.cjs +42 -21
- package/__cjs/core/index.cjs.map +1 -1
- package/__cjs/core/index.d.cts +12 -11
- package/__cjs/core/types.d.cts +60 -7
- package/__cjs/core/watchQueryOptions.d.cts +32 -119
- package/__cjs/errors/CombinedGraphQLErrors.cjs +30 -11
- package/__cjs/errors/CombinedGraphQLErrors.cjs.map +1 -1
- package/__cjs/errors/CombinedGraphQLErrors.d.cts +21 -2
- package/__cjs/errors/CombinedProtocolErrors.cjs +13 -6
- package/__cjs/errors/CombinedProtocolErrors.cjs.map +1 -1
- package/__cjs/errors/CombinedProtocolErrors.d.cts +9 -0
- package/__cjs/errors/LinkError.cjs +20 -0
- package/__cjs/errors/LinkError.cjs.map +1 -0
- package/__cjs/errors/LinkError.d.cts +14 -0
- package/__cjs/errors/ServerError.cjs +6 -0
- package/__cjs/errors/ServerError.cjs.map +1 -1
- package/__cjs/errors/ServerError.d.cts +2 -0
- package/__cjs/errors/ServerParseError.cjs +6 -0
- package/__cjs/errors/ServerParseError.cjs.map +1 -1
- package/__cjs/errors/ServerParseError.d.cts +2 -0
- package/__cjs/errors/UnconventionalError.cjs +6 -0
- package/__cjs/errors/UnconventionalError.cjs.map +1 -1
- package/__cjs/errors/UnconventionalError.d.cts +2 -0
- package/__cjs/errors/index.cjs +19 -4
- package/__cjs/errors/index.cjs.map +1 -1
- package/__cjs/errors/index.d.cts +2 -3
- package/__cjs/errors/isErrorLike.cjs +12 -0
- package/__cjs/errors/isErrorLike.cjs.map +1 -0
- package/__cjs/errors/isErrorLike.d.cts +3 -0
- package/__cjs/errors/utils.cjs +18 -0
- package/__cjs/errors/utils.cjs.map +1 -0
- package/__cjs/errors/utils.d.cts +3 -0
- package/__cjs/invariantErrorCodes.cjs +121 -122
- package/__cjs/link/batch/batching.cjs.map +1 -1
- package/__cjs/link/batch/index.cjs +4 -2
- package/__cjs/link/batch/index.cjs.map +1 -1
- package/__cjs/link/batch/index.d.cts +2 -1
- package/__cjs/link/batch-http/index.cjs +3 -2
- package/__cjs/link/batch-http/index.cjs.map +1 -1
- package/__cjs/link/batch-http/index.d.cts +1 -1
- package/__cjs/link/context/index.cjs.map +1 -1
- package/__cjs/link/context/index.d.cts +1 -1
- package/__cjs/link/core/ApolloLink.cjs +2 -20
- package/__cjs/link/core/ApolloLink.cjs.map +1 -1
- package/__cjs/link/core/ApolloLink.d.cts +1 -3
- package/__cjs/link/core/index.cjs.map +1 -1
- package/__cjs/link/core/index.d.cts +1 -1
- package/__cjs/link/core/types.d.cts +1 -1
- package/__cjs/link/error/index.cjs +13 -28
- package/__cjs/link/error/index.cjs.map +1 -1
- package/__cjs/link/error/index.d.cts +4 -15
- package/__cjs/link/http/checkFetcher.cjs +1 -1
- package/__cjs/link/http/createHttpLink.cjs +1 -1
- package/__cjs/link/http/createHttpLink.d.cts +2 -1
- package/__cjs/link/http/parseAndCheckHttpResponse.cjs +4 -3
- package/__cjs/link/http/parseAndCheckHttpResponse.cjs.map +1 -1
- package/__cjs/link/http/serializeFetchParameter.cjs +1 -1
- package/__cjs/link/persisted-queries/index.cjs +3 -3
- package/__cjs/link/persisted-queries/index.cjs.map +1 -1
- package/__cjs/link/persisted-queries/index.d.cts +14 -3
- package/__cjs/link/remove-typename/removeTypenameFromVariables.cjs +1 -1
- package/__cjs/link/remove-typename/removeTypenameFromVariables.cjs.map +1 -1
- package/__cjs/link/remove-typename/removeTypenameFromVariables.d.cts +10 -1
- package/__cjs/link/retry/index.cjs +3 -2
- package/__cjs/link/retry/index.cjs.map +1 -1
- package/__cjs/link/retry/index.d.cts +1 -1
- package/__cjs/link/subscriptions/index.cjs +3 -1
- package/__cjs/link/subscriptions/index.cjs.map +1 -1
- package/__cjs/link/utils/validateOperation.cjs +1 -1
- package/__cjs/masking/maskDefinition.cjs +2 -2
- package/__cjs/masking/maskDefinition.cjs.map +1 -1
- package/__cjs/masking/maskDefinition.d.cts +1 -1
- package/__cjs/masking/maskFragment.cjs +2 -2
- package/__cjs/masking/maskFragment.cjs.map +1 -1
- package/__cjs/masking/maskFragment.d.cts +2 -2
- package/__cjs/masking/maskOperation.cjs +1 -1
- package/__cjs/masking/maskOperation.cjs.map +1 -1
- package/__cjs/masking/maskOperation.d.cts +2 -2
- package/__cjs/masking/utils.cjs +1 -1
- package/__cjs/react/context/ApolloConsumer.cjs +2 -2
- package/__cjs/react/context/ApolloConsumer.cjs.map +1 -1
- package/__cjs/react/context/ApolloConsumer.d.cts +7 -4
- package/__cjs/react/context/ApolloContext.cjs +2 -2
- package/__cjs/react/context/ApolloContext.cjs.map +1 -1
- package/__cjs/react/context/ApolloContext.d.cts +4 -4
- package/__cjs/react/context/ApolloProvider.cjs +2 -2
- package/__cjs/react/context/ApolloProvider.cjs.map +1 -1
- package/__cjs/react/context/ApolloProvider.d.cts +7 -5
- package/__cjs/react/hooks/internal/__use.cjs +1 -1
- package/__cjs/react/hooks/internal/__use.cjs.map +1 -1
- package/__cjs/react/hooks/internal/__use.d.cts +3 -1
- package/__cjs/react/hooks/internal/useDeepMemo.cjs +3 -1
- package/__cjs/react/hooks/internal/useDeepMemo.cjs.map +1 -1
- package/__cjs/react/hooks/internal/useIsomorphicLayoutEffect.cjs +1 -1
- package/__cjs/react/hooks/internal/useIsomorphicLayoutEffect.cjs.map +1 -1
- package/__cjs/react/hooks/internal/useIsomorphicLayoutEffect.d.cts +2 -2
- package/__cjs/react/hooks/internal/useRenderGuard.cjs +1 -1
- package/__cjs/react/hooks/internal/useRenderGuard.cjs.map +1 -1
- package/__cjs/react/hooks/internal/validateSuspenseHookOptions.cjs +28 -0
- package/__cjs/react/hooks/internal/validateSuspenseHookOptions.cjs.map +1 -0
- package/__cjs/react/hooks/internal/validateSuspenseHookOptions.d.cts +3 -0
- package/__cjs/react/hooks/internal/wrapHook.cjs +26 -5
- package/__cjs/react/hooks/internal/wrapHook.cjs.map +1 -1
- package/__cjs/react/hooks/internal/wrapHook.d.cts +7 -5
- package/__cjs/react/hooks/useApolloClient.cjs +3 -3
- package/__cjs/react/hooks/useApolloClient.cjs.map +1 -1
- package/__cjs/react/hooks/useApolloClient.d.cts +2 -2
- package/__cjs/react/hooks/useBackgroundQuery.cjs +3 -3
- package/__cjs/react/hooks/useBackgroundQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useBackgroundQuery.d.cts +143 -46
- package/__cjs/react/hooks/useFragment.cjs +1 -1
- package/__cjs/react/hooks/useFragment.cjs.map +1 -1
- package/__cjs/react/hooks/useFragment.d.cts +51 -26
- package/__cjs/react/hooks/useLazyQuery.cjs +33 -32
- package/__cjs/react/hooks/useLazyQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useLazyQuery.d.cts +278 -276
- package/__cjs/react/hooks/useLoadableQuery.cjs +22 -3
- package/__cjs/react/hooks/useLoadableQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useLoadableQuery.d.cts +106 -34
- package/__cjs/react/hooks/useMutation.cjs +15 -23
- package/__cjs/react/hooks/useMutation.cjs.map +1 -1
- package/__cjs/react/hooks/useMutation.d.cts +198 -4
- package/__cjs/react/hooks/useQuery.cjs +88 -207
- package/__cjs/react/hooks/useQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useQuery.d.cts +274 -4
- package/__cjs/react/hooks/useQueryRefHandlers.cjs +1 -1
- package/__cjs/react/hooks/useQueryRefHandlers.cjs.map +1 -1
- package/__cjs/react/hooks/useQueryRefHandlers.d.cts +23 -22
- package/__cjs/react/hooks/useReactiveVar.cjs +1 -1
- package/__cjs/react/hooks/useReactiveVar.cjs.map +1 -1
- package/__cjs/react/hooks/useReactiveVar.d.cts +1 -1
- package/__cjs/react/hooks/useReadQuery.cjs +1 -1
- package/__cjs/react/hooks/useReadQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useReadQuery.d.cts +27 -25
- package/__cjs/react/hooks/useSubscription.cjs +10 -60
- package/__cjs/react/hooks/useSubscription.cjs.map +1 -1
- package/__cjs/react/hooks/useSubscription.d.cts +94 -3
- package/__cjs/react/hooks/useSuspenseFragment.cjs +1 -1
- package/__cjs/react/hooks/useSuspenseFragment.cjs.map +1 -1
- package/__cjs/react/hooks/useSuspenseFragment.d.cts +40 -38
- package/__cjs/react/hooks/useSuspenseQuery.cjs +8 -33
- package/__cjs/react/hooks/useSuspenseQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useSuspenseQuery.d.cts +199 -38
- package/__cjs/react/hooks/useSyncExternalStore.cjs +2 -2
- package/__cjs/react/hooks/useSyncExternalStore.cjs.map +1 -1
- package/__cjs/react/index.cjs +35 -11
- package/__cjs/react/index.cjs.map +1 -1
- package/__cjs/react/index.d.cts +21 -6
- package/__cjs/react/index.react-server.cjs +48 -0
- package/__cjs/react/index.react-server.cjs.map +1 -0
- package/__cjs/react/index.react-server.d.cts +19 -0
- package/__cjs/react/internal/cache/FragmentReference.cjs.map +1 -1
- package/__cjs/react/internal/cache/FragmentReference.d.cts +3 -3
- package/__cjs/react/internal/cache/QueryReference.cjs +3 -14
- package/__cjs/react/internal/cache/QueryReference.cjs.map +1 -1
- package/__cjs/react/internal/cache/QueryReference.d.cts +7 -7
- package/__cjs/react/internal/cache/SuspenseCache.cjs.map +1 -1
- package/__cjs/react/internal/cache/SuspenseCache.d.cts +3 -3
- package/__cjs/react/internal/cache/getSuspenseCache.cjs.map +1 -1
- package/__cjs/react/internal/cache/getSuspenseCache.d.cts +4 -4
- package/__cjs/react/internal/index.cjs +3 -1
- package/__cjs/react/internal/index.cjs.map +1 -1
- package/__cjs/react/internal/index.d.cts +2 -0
- package/__cjs/react/internal/types.d.cts +9 -0
- package/__cjs/react/query-preloader/createQueryPreloader.cjs +1 -0
- package/__cjs/react/query-preloader/createQueryPreloader.cjs.map +1 -1
- package/__cjs/react/query-preloader/createQueryPreloader.d.cts +6 -45
- package/__cjs/react/ssr/getDataFromTree.cjs +24 -30
- package/__cjs/react/ssr/getDataFromTree.cjs.map +1 -1
- package/__cjs/react/ssr/getDataFromTree.d.cts +12 -1
- package/__cjs/react/ssr/index.cjs +3 -3
- package/__cjs/react/ssr/index.cjs.map +1 -1
- package/__cjs/react/ssr/index.d.cts +1 -1
- package/__cjs/react/ssr/prerenderStatic.cjs +151 -0
- package/__cjs/react/ssr/prerenderStatic.cjs.map +1 -0
- package/__cjs/react/ssr/prerenderStatic.d.cts +122 -0
- package/__cjs/react/ssr/renderToStringWithData.cjs +11 -5
- package/__cjs/react/ssr/renderToStringWithData.cjs.map +1 -1
- package/__cjs/react/ssr/renderToStringWithData.d.cts +5 -0
- package/__cjs/react/ssr/useSSRQuery.cjs +60 -0
- package/__cjs/react/ssr/useSSRQuery.cjs.map +1 -0
- package/__cjs/react/ssr/useSSRQuery.d.cts +5 -0
- package/__cjs/{utilities/types/TODO.cjs → react/types/deprecated.cjs} +1 -1
- package/__cjs/react/types/deprecated.cjs.map +1 -0
- package/__cjs/react/types/deprecated.d.cts +75 -0
- package/__cjs/react/types/types.documentation.d.cts +6 -34
- package/__cjs/testing/core/index.cjs +6 -3
- package/__cjs/testing/core/index.cjs.map +1 -1
- package/__cjs/testing/core/index.d.cts +3 -3
- package/__cjs/testing/core/mocking/mockClient.cjs +3 -4
- package/__cjs/testing/core/mocking/mockClient.cjs.map +1 -1
- package/__cjs/testing/core/mocking/mockClient.d.cts +2 -3
- package/__cjs/testing/core/mocking/mockLink.cjs +118 -112
- package/__cjs/testing/core/mocking/mockLink.cjs.map +1 -1
- package/__cjs/testing/core/mocking/mockLink.d.cts +26 -7
- package/__cjs/testing/experimental/createSchemaFetch.cjs +4 -4
- package/__cjs/testing/experimental/createSchemaFetch.cjs.map +1 -1
- package/__cjs/testing/experimental/createTestSchema.cjs.map +1 -1
- package/__cjs/testing/experimental/createTestSchema.d.cts +1 -1
- package/__cjs/testing/index.cjs +13 -2
- package/__cjs/testing/index.cjs.map +1 -1
- package/__cjs/testing/index.d.cts +2 -1
- package/__cjs/testing/internal/disposables/spyOnConsole.cjs +0 -1
- package/__cjs/testing/internal/disposables/spyOnConsole.cjs.map +1 -1
- package/__cjs/testing/internal/disposables/spyOnConsole.d.cts +0 -1
- package/__cjs/testing/internal/disposables/withProdMode.d.cts +1 -1
- package/__cjs/testing/internal/incremental.cjs.map +1 -1
- package/__cjs/testing/internal/incremental.d.cts +4 -3
- package/__cjs/testing/internal/index.cjs +14 -8
- package/__cjs/testing/internal/index.cjs.map +1 -1
- package/__cjs/testing/internal/index.d.cts +4 -3
- package/__cjs/testing/internal/renderHelpers.cjs.map +1 -1
- package/__cjs/testing/internal/renderHelpers.d.cts +3 -3
- package/__cjs/testing/internal/resetApolloContext.cjs +24 -0
- package/__cjs/testing/internal/resetApolloContext.cjs.map +1 -0
- package/__cjs/testing/internal/resetApolloContext.d.cts +10 -0
- package/__cjs/testing/internal/scenarios/index.cjs +9 -7
- package/__cjs/testing/internal/scenarios/index.cjs.map +1 -1
- package/__cjs/testing/internal/scenarios/index.d.cts +14 -5
- package/__cjs/testing/matchers/arrayWithLength.cjs +15 -0
- package/__cjs/testing/matchers/arrayWithLength.cjs.map +1 -0
- package/__cjs/testing/matchers/arrayWithLength.d.cts +3 -0
- package/__cjs/testing/matchers/index.cjs +6 -18
- package/__cjs/testing/matchers/index.cjs.map +1 -1
- package/__cjs/testing/matchers/toComplete.cjs.map +1 -1
- package/__cjs/testing/matchers/toEmitAnything.cjs.map +1 -1
- package/__cjs/testing/matchers/toEmitError.cjs.map +1 -1
- package/__cjs/testing/matchers/toEmitNext.cjs.map +1 -1
- package/__cjs/testing/matchers/{toEmitFetchResult.cjs → toEmitTypedValue.cjs} +9 -7
- package/__cjs/testing/matchers/toEmitTypedValue.cjs.map +1 -0
- package/__cjs/testing/matchers/{toEmitValueStrict.d.cts → toEmitTypedValue.d.cts} +2 -2
- package/__cjs/testing/matchers/toHaveSuspenseCacheEntryUsing.cjs +2 -2
- package/__cjs/testing/matchers/toHaveSuspenseCacheEntryUsing.cjs.map +1 -1
- package/__cjs/testing/matchers/toHaveSuspenseCacheEntryUsing.d.cts +1 -1
- package/__cjs/testing/matchers/toMatchDocument.cjs.map +1 -1
- package/__cjs/testing/matchers/toMatchDocument.d.cts +1 -1
- package/__cjs/testing/matchers/toStrictEqualTyped.cjs +26 -0
- package/__cjs/testing/matchers/toStrictEqualTyped.cjs.map +1 -0
- package/__cjs/testing/matchers/toStrictEqualTyped.d.cts +3 -0
- package/__cjs/testing/matchers/utils/getSerializableProperties.cjs +23 -0
- package/__cjs/testing/matchers/utils/getSerializableProperties.cjs.map +1 -0
- package/__cjs/testing/matchers/utils/getSerializableProperties.d.cts +2 -0
- package/__cjs/testing/react/MockedProvider.cjs +11 -7
- package/__cjs/testing/react/MockedProvider.cjs.map +1 -1
- package/__cjs/testing/react/MockedProvider.d.cts +8 -6
- package/__cjs/utilities/caching/sizes.cjs +2 -2
- package/__cjs/utilities/caching/sizes.cjs.map +1 -1
- package/__cjs/utilities/caching/sizes.d.cts +2 -20
- package/__cjs/utilities/common/canonicalStringify.cjs +2 -2
- package/__cjs/utilities/common/canonicalStringify.cjs.map +1 -1
- package/__cjs/utilities/common/errorHandling.d.cts +1 -1
- package/__cjs/utilities/common/maybeDeepFreeze.cjs +1 -0
- package/__cjs/utilities/common/maybeDeepFreeze.cjs.map +1 -1
- package/__cjs/utilities/common/maybeDeepFreeze.d.cts +1 -0
- package/__cjs/utilities/common/mergeOptions.cjs.map +1 -1
- package/__cjs/utilities/common/mergeOptions.d.cts +1 -1
- package/__cjs/utilities/graphql/getFromAST.cjs +15 -6
- package/__cjs/utilities/graphql/getFromAST.cjs.map +1 -1
- package/__cjs/utilities/graphql/getFromAST.d.cts +2 -2
- package/__cjs/utilities/graphql/operations.cjs.map +1 -1
- package/__cjs/utilities/graphql/operations.d.cts +1 -1
- package/__cjs/utilities/graphql/print.cjs +2 -2
- package/__cjs/utilities/graphql/print.cjs.map +1 -1
- package/__cjs/utilities/graphql/storeUtils.cjs +1 -1
- package/__cjs/utilities/graphql/transform.cjs +2 -2
- package/__cjs/utilities/index.cjs +39 -19
- package/__cjs/utilities/index.cjs.map +1 -1
- package/__cjs/utilities/index.d.cts +16 -15
- package/__cjs/utilities/{caching → internal}/getMemoryInternals.cjs +1 -3
- package/__cjs/utilities/internal/getMemoryInternals.cjs.map +1 -0
- package/__cjs/utilities/{caching → internal}/getMemoryInternals.d.cts +1 -2
- package/__cjs/utilities/internal/index.cjs +8 -1
- package/__cjs/utilities/internal/index.cjs.map +1 -1
- package/__cjs/utilities/internal/index.d.cts +2 -0
- package/__cjs/utilities/internal/index.production.cjs +11 -0
- package/__cjs/utilities/internal/index.production.cjs.map +1 -0
- package/__cjs/utilities/internal/index.production.d.cts +3 -0
- package/__cjs/utilities/internal/toQueryResult.cjs +13 -0
- package/__cjs/utilities/internal/toQueryResult.cjs.map +1 -0
- package/__cjs/utilities/internal/toQueryResult.d.cts +3 -0
- package/__cjs/utilities/invariant/index.development.cjs +1 -0
- package/__cjs/utilities/invariant/index.development.cjs.map +1 -1
- package/__cjs/utilities/subscriptions/relay/index.cjs +2 -2
- package/__cjs/utilities/subscriptions/relay/index.cjs.map +1 -1
- package/__cjs/utilities/subscriptions/relay/index.d.cts +1 -1
- package/__cjs/utilities/types/NoInfer.d.cts +1 -1
- package/__cjs/utilities/types/{OnlyRequiredProperties.cjs → VariablesOption.cjs} +1 -1
- package/__cjs/utilities/types/VariablesOption.cjs.map +1 -0
- package/__cjs/utilities/types/VariablesOption.d.cts +25 -0
- package/__cjs/version.cjs +1 -1
- package/__cjs/version.cjs.map +1 -1
- package/__cjs/version.d.cts +1 -1
- package/cache/core/cache.d.ts +19 -19
- package/cache/core/cache.js +1 -1
- package/cache/core/cache.js.map +1 -1
- package/cache/core/types/Cache.d.ts +9 -16
- package/cache/core/types/Cache.js.map +1 -1
- package/cache/core/types/DataProxy.d.ts +8 -23
- package/cache/core/types/common.js +1 -0
- package/cache/core/types/common.js.map +1 -1
- package/cache/index.d.ts +3 -3
- package/cache/index.js +1 -1
- package/cache/index.js.map +1 -1
- package/cache/inmemory/entityStore.d.ts +3 -2
- package/cache/inmemory/entityStore.js +6 -5
- package/cache/inmemory/entityStore.js.map +1 -1
- package/cache/inmemory/fragmentRegistry.js +1 -1
- package/cache/inmemory/fragmentRegistry.js.map +1 -1
- package/cache/inmemory/helpers.d.ts +0 -1
- package/cache/inmemory/helpers.js +0 -7
- package/cache/inmemory/helpers.js.map +1 -1
- package/cache/inmemory/inMemoryCache.d.ts +9 -11
- package/cache/inmemory/inMemoryCache.js +5 -17
- package/cache/inmemory/inMemoryCache.js.map +1 -1
- package/cache/inmemory/policies.d.ts +1 -1
- package/cache/inmemory/policies.js +5 -5
- package/cache/inmemory/policies.js.map +1 -1
- package/cache/inmemory/reactiveVars.d.ts +7 -7
- package/cache/inmemory/reactiveVars.js.map +1 -1
- package/cache/inmemory/readFromStore.d.ts +1 -6
- package/cache/inmemory/readFromStore.js +12 -54
- package/cache/inmemory/readFromStore.js.map +1 -1
- package/cache/inmemory/types.d.ts +3 -17
- package/cache/inmemory/writeToStore.d.ts +2 -2
- package/cache/inmemory/writeToStore.js +4 -4
- package/cache/inmemory/writeToStore.js.map +1 -1
- package/config/jest/areCombinedGraphQLErrorsEqual.js +6 -4
- package/config/jest/areCombinedGraphQLErrorsEqual.js.map +1 -1
- package/config/jest/areCombinedProtocolErrorsEqual.js +3 -3
- package/config/jest/areCombinedProtocolErrorsEqual.js.map +1 -1
- package/config/jest/areMissingFieldErrorsEqual.js +2 -3
- package/config/jest/areMissingFieldErrorsEqual.js.map +1 -1
- package/config/jest/areServerErrorsEqual.d.ts +3 -0
- package/config/jest/areServerErrorsEqual.js +18 -0
- package/config/jest/areServerErrorsEqual.js.map +1 -0
- package/config/jest/resolver.js +12 -1
- package/config/jest/resolver.js.map +1 -1
- package/config/jest/setup.js +19 -2
- package/config/jest/setup.js.map +1 -1
- package/core/ApolloClient.d.ts +36 -26
- package/core/ApolloClient.js +36 -19
- package/core/ApolloClient.js.map +1 -1
- package/core/LocalState.d.ts +6 -6
- package/core/LocalState.js +2 -2
- package/core/LocalState.js.map +1 -1
- package/core/ObservableQuery.d.ts +156 -17
- package/core/ObservableQuery.js +267 -102
- package/core/ObservableQuery.js.map +1 -1
- package/core/QueryInfo.d.ts +2 -11
- package/core/QueryInfo.js +12 -86
- package/core/QueryInfo.js.map +1 -1
- package/core/QueryManager.d.ts +32 -21
- package/core/QueryManager.js +151 -107
- package/core/QueryManager.js.map +1 -1
- package/core/index.d.ts +12 -11
- package/core/index.js +9 -6
- package/core/index.js.map +1 -1
- package/core/types.d.ts +60 -7
- package/core/watchQueryOptions.d.ts +32 -119
- package/errors/CombinedGraphQLErrors.d.ts +21 -2
- package/errors/CombinedGraphQLErrors.js +30 -11
- package/errors/CombinedGraphQLErrors.js.map +1 -1
- package/errors/CombinedProtocolErrors.d.ts +9 -0
- package/errors/CombinedProtocolErrors.js +13 -6
- package/errors/CombinedProtocolErrors.js.map +1 -1
- package/errors/LinkError.d.ts +14 -0
- package/errors/LinkError.js +16 -0
- package/errors/LinkError.js.map +1 -0
- package/errors/ServerError.d.ts +2 -0
- package/errors/ServerError.js +6 -0
- package/errors/ServerError.js.map +1 -1
- package/errors/ServerParseError.d.ts +2 -0
- package/errors/ServerParseError.js +6 -0
- package/errors/ServerParseError.js.map +1 -1
- package/errors/UnconventionalError.d.ts +2 -0
- package/errors/UnconventionalError.js +6 -0
- package/errors/UnconventionalError.js.map +1 -1
- package/errors/index.d.ts +2 -3
- package/errors/index.js +13 -1
- package/errors/index.js.map +1 -1
- package/errors/isErrorLike.d.ts +3 -0
- package/errors/isErrorLike.js +9 -0
- package/errors/isErrorLike.js.map +1 -0
- package/errors/utils.d.ts +3 -0
- package/errors/utils.js +14 -0
- package/errors/utils.js.map +1 -0
- package/invariantErrorCodes.js +121 -122
- package/legacyEntryPoints/testing/internal/index.d.ts +1 -0
- package/legacyEntryPoints/testing/internal/index.js +1 -0
- package/legacyEntryPoints/testing/internal/internal.cjs +1 -0
- package/legacyEntryPoints/testing/internal/internal.d.cts +1 -0
- package/link/batch/batching.js +1 -1
- package/link/batch/batching.js.map +1 -1
- package/link/batch/index.d.ts +2 -1
- package/link/batch/index.js +1 -1
- package/link/batch/index.js.map +1 -1
- package/link/batch-http/index.d.ts +1 -1
- package/link/batch-http/index.js +1 -1
- package/link/batch-http/index.js.map +1 -1
- package/link/context/index.d.ts +1 -1
- package/link/context/index.js.map +1 -1
- package/link/core/ApolloLink.d.ts +1 -3
- package/link/core/ApolloLink.js +2 -20
- package/link/core/ApolloLink.js.map +1 -1
- package/link/core/index.d.ts +1 -1
- package/link/core/index.js.map +1 -1
- package/link/core/types.d.ts +1 -1
- package/link/error/index.d.ts +4 -15
- package/link/error/index.js +14 -29
- package/link/error/index.js.map +1 -1
- package/link/http/checkFetcher.js +1 -1
- package/link/http/createHttpLink.js +1 -1
- package/link/http/parseAndCheckHttpResponse.js +4 -3
- package/link/http/parseAndCheckHttpResponse.js.map +1 -1
- package/link/http/serializeFetchParameter.js +1 -1
- package/link/persisted-queries/index.d.ts +2 -2
- package/link/persisted-queries/index.js +3 -3
- package/link/persisted-queries/index.js.map +1 -1
- package/link/remove-typename/removeTypenameFromVariables.js.map +1 -1
- package/link/retry/index.d.ts +1 -1
- package/link/retry/index.js +1 -1
- package/link/retry/index.js.map +1 -1
- package/link/subscriptions/index.js +3 -1
- package/link/subscriptions/index.js.map +1 -1
- package/link/utils/validateOperation.js +1 -1
- package/masking/maskDefinition.d.ts +1 -1
- package/masking/maskDefinition.js +2 -2
- package/masking/maskDefinition.js.map +1 -1
- package/masking/maskFragment.d.ts +2 -2
- package/masking/maskFragment.js +2 -2
- package/masking/maskFragment.js.map +1 -1
- package/masking/maskOperation.d.ts +2 -2
- package/masking/maskOperation.js +1 -1
- package/masking/maskOperation.js.map +1 -1
- package/masking/utils.js +1 -1
- package/package.json +58 -56
- package/react/context/ApolloConsumer.d.ts +7 -4
- package/react/context/ApolloConsumer.js +2 -2
- package/react/context/ApolloConsumer.js.map +1 -1
- package/react/context/ApolloContext.d.ts +4 -4
- package/react/context/ApolloContext.js +2 -2
- package/react/context/ApolloContext.js.map +1 -1
- package/react/context/ApolloProvider.d.ts +7 -5
- package/react/context/ApolloProvider.js +2 -2
- package/react/context/ApolloProvider.js.map +1 -1
- package/react/hooks/internal/__use.js +1 -1
- package/react/hooks/internal/__use.js.map +1 -1
- package/react/hooks/internal/useDeepMemo.js +3 -1
- package/react/hooks/internal/useDeepMemo.js.map +1 -1
- package/react/hooks/internal/useIsomorphicLayoutEffect.d.ts +1 -1
- package/react/hooks/internal/useIsomorphicLayoutEffect.js +1 -1
- package/react/hooks/internal/useIsomorphicLayoutEffect.js.map +1 -1
- package/react/hooks/internal/useRenderGuard.js +1 -1
- package/react/hooks/internal/useRenderGuard.js.map +1 -1
- package/react/hooks/internal/validateSuspenseHookOptions.d.ts +3 -0
- package/react/hooks/internal/validateSuspenseHookOptions.js +22 -0
- package/react/hooks/internal/validateSuspenseHookOptions.js.map +1 -0
- package/react/hooks/internal/wrapHook.d.ts +7 -5
- package/react/hooks/internal/wrapHook.js +24 -5
- package/react/hooks/internal/wrapHook.js.map +1 -1
- package/react/hooks/useApolloClient.d.ts +2 -2
- package/react/hooks/useApolloClient.js +2 -2
- package/react/hooks/useApolloClient.js.map +1 -1
- package/react/hooks/useBackgroundQuery.d.ts +143 -46
- package/react/hooks/useBackgroundQuery.js +3 -3
- package/react/hooks/useBackgroundQuery.js.map +1 -1
- package/react/hooks/useFragment.d.ts +51 -26
- package/react/hooks/useFragment.js +1 -1
- package/react/hooks/useFragment.js.map +1 -1
- package/react/hooks/useLazyQuery.d.ts +278 -276
- package/react/hooks/useLazyQuery.js +32 -31
- package/react/hooks/useLazyQuery.js.map +1 -1
- package/react/hooks/useLoadableQuery.d.ts +106 -34
- package/react/hooks/useLoadableQuery.js +22 -3
- package/react/hooks/useLoadableQuery.js.map +1 -1
- package/react/hooks/useMutation.d.ts +198 -4
- package/react/hooks/useMutation.js +15 -23
- package/react/hooks/useMutation.js.map +1 -1
- package/react/hooks/useQuery.d.ts +274 -4
- package/react/hooks/useQuery.js +87 -206
- package/react/hooks/useQuery.js.map +1 -1
- package/react/hooks/useQueryRefHandlers.d.ts +23 -22
- package/react/hooks/useQueryRefHandlers.js +1 -1
- package/react/hooks/useQueryRefHandlers.js.map +1 -1
- package/react/hooks/useReactiveVar.d.ts +1 -1
- package/react/hooks/useReactiveVar.js +1 -1
- package/react/hooks/useReactiveVar.js.map +1 -1
- package/react/hooks/useReadQuery.d.ts +27 -25
- package/react/hooks/useReadQuery.js +1 -1
- package/react/hooks/useReadQuery.js.map +1 -1
- package/react/hooks/useSubscription.d.ts +94 -9
- package/react/hooks/useSubscription.js +9 -56
- package/react/hooks/useSubscription.js.map +1 -1
- package/react/hooks/useSuspenseFragment.d.ts +40 -38
- package/react/hooks/useSuspenseFragment.js +1 -1
- package/react/hooks/useSuspenseFragment.js.map +1 -1
- package/react/hooks/useSuspenseQuery.d.ts +199 -38
- package/react/hooks/useSuspenseQuery.js +6 -27
- package/react/hooks/useSuspenseQuery.js.map +1 -1
- package/react/hooks/useSyncExternalStore.js +2 -2
- package/react/hooks/useSyncExternalStore.js.map +1 -1
- package/react/index.d.ts +21 -6
- package/react/index.js +17 -3
- package/react/index.js.map +1 -1
- package/react/index.react-server.d.ts +19 -0
- package/react/index.react-server.js +45 -0
- package/react/index.react-server.js.map +1 -0
- package/react/internal/cache/FragmentReference.d.ts +3 -3
- package/react/internal/cache/FragmentReference.js.map +1 -1
- package/react/internal/cache/QueryReference.d.ts +5 -5
- package/react/internal/cache/QueryReference.js +3 -14
- package/react/internal/cache/QueryReference.js.map +1 -1
- package/react/internal/cache/SuspenseCache.d.ts +3 -3
- package/react/internal/cache/SuspenseCache.js.map +1 -1
- package/react/internal/cache/getSuspenseCache.d.ts +3 -3
- package/react/internal/cache/getSuspenseCache.js.map +1 -1
- package/react/internal/index.d.ts +2 -0
- package/react/internal/index.js +2 -1
- package/react/internal/index.js.map +1 -1
- package/react/internal/types.d.ts +9 -0
- package/react/query-preloader/createQueryPreloader.d.ts +6 -45
- package/react/query-preloader/createQueryPreloader.js +1 -0
- package/react/query-preloader/createQueryPreloader.js.map +1 -1
- package/react/ssr/getDataFromTree.d.ts +12 -1
- package/react/ssr/getDataFromTree.js +24 -29
- package/react/ssr/getDataFromTree.js.map +1 -1
- package/react/ssr/index.d.ts +1 -1
- package/react/ssr/index.js +1 -1
- package/react/ssr/index.js.map +1 -1
- package/react/ssr/prerenderStatic.d.ts +122 -0
- package/react/ssr/prerenderStatic.js +147 -0
- package/react/ssr/prerenderStatic.js.map +1 -0
- package/react/ssr/renderToStringWithData.d.ts +5 -0
- package/react/ssr/renderToStringWithData.js +11 -5
- package/react/ssr/renderToStringWithData.js.map +1 -1
- package/react/ssr/useSSRQuery.d.ts +5 -0
- package/react/ssr/useSSRQuery.js +56 -0
- package/react/ssr/useSSRQuery.js.map +1 -0
- package/react/types/deprecated.d.ts +75 -0
- package/react/types/deprecated.js +2 -0
- package/react/types/deprecated.js.map +1 -0
- package/react/types/types.documentation.d.ts +6 -34
- package/testing/core/index.d.ts +3 -3
- package/testing/core/index.js +2 -2
- package/testing/core/index.js.map +1 -1
- package/testing/core/mocking/mockClient.d.ts +2 -3
- package/testing/core/mocking/mockClient.js +2 -3
- package/testing/core/mocking/mockClient.js.map +1 -1
- package/testing/core/mocking/mockLink.d.ts +26 -7
- package/testing/core/mocking/mockLink.js +117 -113
- package/testing/core/mocking/mockLink.js.map +1 -1
- package/testing/experimental/createSchemaFetch.js +2 -2
- package/testing/experimental/createSchemaFetch.js.map +1 -1
- package/testing/experimental/createTestSchema.d.ts +1 -1
- package/testing/experimental/createTestSchema.js.map +1 -1
- package/testing/index.d.ts +2 -1
- package/testing/index.js +1 -1
- package/testing/index.js.map +1 -1
- package/testing/internal/disposables/spyOnConsole.d.ts +0 -1
- package/testing/internal/disposables/spyOnConsole.js +0 -1
- package/testing/internal/disposables/spyOnConsole.js.map +1 -1
- package/testing/internal/incremental.d.ts +1 -1
- package/testing/internal/incremental.js.map +1 -1
- package/testing/internal/index.d.ts +4 -3
- package/testing/internal/index.js +4 -3
- package/testing/internal/index.js.map +1 -1
- package/testing/internal/renderHelpers.d.ts +3 -3
- package/testing/internal/renderHelpers.js.map +1 -1
- package/testing/internal/resetApolloContext.d.ts +10 -0
- package/testing/internal/resetApolloContext.js +20 -0
- package/testing/internal/resetApolloContext.js.map +1 -0
- package/testing/internal/scenarios/index.d.ts +6 -8
- package/testing/internal/scenarios/index.js +4 -2
- package/testing/internal/scenarios/index.js.map +1 -1
- package/testing/matchers/arrayWithLength.d.ts +3 -0
- package/testing/matchers/arrayWithLength.js +11 -0
- package/testing/matchers/arrayWithLength.js.map +1 -0
- package/testing/matchers/index.js +6 -18
- package/testing/matchers/index.js.map +1 -1
- package/testing/matchers/toComplete.js.map +1 -1
- package/testing/matchers/toEmitAnything.js.map +1 -1
- package/testing/matchers/toEmitError.js.map +1 -1
- package/testing/matchers/toEmitNext.js.map +1 -1
- package/testing/matchers/{toEmitValueStrict.d.ts → toEmitTypedValue.d.ts} +2 -2
- package/testing/matchers/{toEmitFetchResult.js → toEmitTypedValue.js} +7 -5
- package/testing/matchers/toEmitTypedValue.js.map +1 -0
- package/testing/matchers/toHaveSuspenseCacheEntryUsing.d.ts +1 -1
- package/testing/matchers/toHaveSuspenseCacheEntryUsing.js +1 -1
- package/testing/matchers/toHaveSuspenseCacheEntryUsing.js.map +1 -1
- package/testing/matchers/toMatchDocument.d.ts +1 -1
- package/testing/matchers/toMatchDocument.js.map +1 -1
- package/testing/matchers/toStrictEqualTyped.d.ts +3 -0
- package/testing/matchers/toStrictEqualTyped.js +22 -0
- package/testing/matchers/toStrictEqualTyped.js.map +1 -0
- package/testing/matchers/utils/getSerializableProperties.d.ts +2 -0
- package/testing/matchers/utils/getSerializableProperties.js +20 -0
- package/testing/matchers/utils/getSerializableProperties.js.map +1 -0
- package/testing/react/MockedProvider.d.ts +8 -6
- package/testing/react/MockedProvider.js +8 -4
- package/testing/react/MockedProvider.js.map +1 -1
- package/utilities/caching/sizes.d.ts +2 -20
- package/utilities/caching/sizes.js +2 -2
- package/utilities/caching/sizes.js.map +1 -1
- package/utilities/common/canonicalStringify.js +1 -1
- package/utilities/common/canonicalStringify.js.map +1 -1
- package/utilities/common/maybeDeepFreeze.d.ts +1 -0
- package/utilities/common/maybeDeepFreeze.js +1 -0
- package/utilities/common/maybeDeepFreeze.js.map +1 -1
- package/utilities/common/mergeOptions.d.ts +1 -1
- package/utilities/common/mergeOptions.js.map +1 -1
- package/utilities/graphql/getFromAST.d.ts +2 -2
- package/utilities/graphql/getFromAST.js +15 -6
- package/utilities/graphql/getFromAST.js.map +1 -1
- package/utilities/graphql/operations.d.ts +1 -1
- package/utilities/graphql/operations.js.map +1 -1
- package/utilities/graphql/print.js +1 -1
- package/utilities/graphql/print.js.map +1 -1
- package/utilities/graphql/storeUtils.js +1 -1
- package/utilities/graphql/transform.js +2 -2
- package/utilities/index.d.ts +16 -15
- package/utilities/index.js +12 -12
- package/utilities/index.js.map +1 -1
- package/utilities/{caching → internal}/getMemoryInternals.d.ts +0 -1
- package/utilities/{caching → internal}/getMemoryInternals.js +1 -3
- package/utilities/internal/getMemoryInternals.js.map +1 -0
- package/utilities/internal/index.d.ts +2 -0
- package/utilities/internal/index.js +2 -0
- package/utilities/internal/index.js.map +1 -1
- package/utilities/internal/index.production.d.ts +3 -0
- package/utilities/internal/index.production.js +7 -0
- package/utilities/internal/index.production.js.map +1 -0
- package/utilities/internal/toQueryResult.d.ts +3 -0
- package/utilities/internal/toQueryResult.js +10 -0
- package/utilities/internal/toQueryResult.js.map +1 -0
- package/utilities/invariant/index.development.js +1 -0
- package/utilities/invariant/index.development.js.map +1 -1
- package/utilities/subscriptions/relay/index.d.ts +1 -1
- package/utilities/subscriptions/relay/index.js +1 -1
- package/utilities/subscriptions/relay/index.js.map +1 -1
- package/utilities/types/NoInfer.d.ts +1 -1
- package/utilities/types/VariablesOption.d.ts +25 -0
- package/utilities/types/VariablesOption.js +2 -0
- package/utilities/types/VariablesOption.js.map +1 -0
- package/version.d.ts +1 -1
- package/version.js +1 -1
- package/version.js.map +1 -1
- package/__cjs/cache/inmemory/fixPolyfills.cjs +0 -10
- package/__cjs/cache/inmemory/fixPolyfills.cjs.map +0 -1
- package/__cjs/cache/inmemory/fixPolyfills.d.cts +0 -2
- package/__cjs/cache/inmemory/fixPolyfills.native.cjs +0 -53
- package/__cjs/cache/inmemory/fixPolyfills.native.cjs.map +0 -1
- package/__cjs/cache/inmemory/fixPolyfills.native.d.cts +0 -2
- package/__cjs/cache/inmemory/object-canon.cjs +0 -180
- package/__cjs/cache/inmemory/object-canon.cjs.map +0 -1
- package/__cjs/cache/inmemory/object-canon.d.cts +0 -12
- package/__cjs/index.cjs +0 -8
- package/__cjs/index.cjs.map +0 -1
- package/__cjs/index.d.cts +0 -3
- package/__cjs/link/http/iterators/async.cjs +0 -19
- package/__cjs/link/http/iterators/async.cjs.map +0 -1
- package/__cjs/link/http/iterators/async.d.cts +0 -6
- package/__cjs/link/http/iterators/nodeStream.cjs +0 -75
- package/__cjs/link/http/iterators/nodeStream.cjs.map +0 -1
- package/__cjs/link/http/iterators/nodeStream.d.cts +0 -7
- package/__cjs/link/http/iterators/promise.cjs +0 -32
- package/__cjs/link/http/iterators/promise.cjs.map +0 -1
- package/__cjs/link/http/iterators/promise.d.cts +0 -6
- package/__cjs/link/http/iterators/reader.cjs +0 -19
- package/__cjs/link/http/iterators/reader.cjs.map +0 -1
- package/__cjs/link/http/iterators/reader.d.cts +0 -6
- package/__cjs/link/http/responseIterator.cjs +0 -50
- package/__cjs/link/http/responseIterator.cjs.map +0 -1
- package/__cjs/link/http/responseIterator.d.cts +0 -7
- package/__cjs/react/context/index.cjs +0 -10
- package/__cjs/react/context/index.cjs.map +0 -1
- package/__cjs/react/context/index.d.cts +0 -7
- package/__cjs/react/hooks/index.cjs +0 -27
- package/__cjs/react/hooks/index.cjs.map +0 -1
- package/__cjs/react/hooks/index.d.cts +0 -22
- package/__cjs/react/parser/index.cjs +0 -115
- package/__cjs/react/parser/index.cjs.map +0 -1
- package/__cjs/react/parser/index.d.cts +0 -18
- package/__cjs/react/ssr/RenderPromises.cjs +0 -104
- package/__cjs/react/ssr/RenderPromises.cjs.map +0 -1
- package/__cjs/react/ssr/RenderPromises.d.cts +0 -22
- package/__cjs/react/types/types.d.cts +0 -689
- package/__cjs/testing/matchers/toEmitApolloQueryResult.cjs +0 -40
- package/__cjs/testing/matchers/toEmitApolloQueryResult.cjs.map +0 -1
- package/__cjs/testing/matchers/toEmitApolloQueryResult.d.cts +0 -8
- package/__cjs/testing/matchers/toEmitFetchResult.cjs.map +0 -1
- package/__cjs/testing/matchers/toEmitFetchResult.d.cts +0 -8
- package/__cjs/testing/matchers/toEmitMatchedValue.cjs +0 -40
- package/__cjs/testing/matchers/toEmitMatchedValue.cjs.map +0 -1
- package/__cjs/testing/matchers/toEmitMatchedValue.d.cts +0 -7
- package/__cjs/testing/matchers/toEmitValue.cjs +0 -41
- package/__cjs/testing/matchers/toEmitValue.cjs.map +0 -1
- package/__cjs/testing/matchers/toEmitValue.d.cts +0 -4
- package/__cjs/testing/matchers/toEmitValueStrict.cjs +0 -46
- package/__cjs/testing/matchers/toEmitValueStrict.cjs.map +0 -1
- package/__cjs/testing/matchers/toEqualApolloQueryResult.cjs +0 -24
- package/__cjs/testing/matchers/toEqualApolloQueryResult.cjs.map +0 -1
- package/__cjs/testing/matchers/toEqualApolloQueryResult.d.cts +0 -6
- package/__cjs/testing/matchers/toEqualFetchResult.cjs +0 -24
- package/__cjs/testing/matchers/toEqualFetchResult.cjs.map +0 -1
- package/__cjs/testing/matchers/toEqualFetchResult.d.cts +0 -4
- package/__cjs/testing/matchers/toEqualLazyQueryResult.cjs +0 -40
- package/__cjs/testing/matchers/toEqualLazyQueryResult.cjs.map +0 -1
- package/__cjs/testing/matchers/toEqualLazyQueryResult.d.cts +0 -10
- package/__cjs/testing/matchers/toEqualQueryResult.cjs +0 -40
- package/__cjs/testing/matchers/toEqualQueryResult.cjs.map +0 -1
- package/__cjs/testing/matchers/toEqualQueryResult.d.cts +0 -9
- package/__cjs/utilities/caching/getMemoryInternals.cjs.map +0 -1
- package/__cjs/utilities/types/OnlyRequiredProperties.cjs.map +0 -1
- package/__cjs/utilities/types/OnlyRequiredProperties.d.cts +0 -7
- package/__cjs/utilities/types/TODO.cjs.map +0 -1
- package/__cjs/utilities/types/TODO.d.cts +0 -3
- package/cache/inmemory/fixPolyfills.d.ts +0 -2
- package/cache/inmemory/fixPolyfills.js +0 -10
- package/cache/inmemory/fixPolyfills.js.map +0 -1
- package/cache/inmemory/fixPolyfills.native.d.ts +0 -2
- package/cache/inmemory/fixPolyfills.native.js +0 -53
- package/cache/inmemory/fixPolyfills.native.js.map +0 -1
- package/cache/inmemory/object-canon.d.ts +0 -12
- package/cache/inmemory/object-canon.js +0 -176
- package/cache/inmemory/object-canon.js.map +0 -1
- package/index.d.ts +0 -3
- package/index.js +0 -3
- package/index.js.map +0 -1
- package/legacyEntryPoints/react/context/context.cjs +0 -1
- package/legacyEntryPoints/react/context/context.d.cts +0 -1
- package/legacyEntryPoints/react/context/index.d.ts +0 -1
- package/legacyEntryPoints/react/context/index.js +0 -1
- package/legacyEntryPoints/react/hooks/hooks.cjs +0 -1
- package/legacyEntryPoints/react/hooks/hooks.d.cts +0 -1
- package/legacyEntryPoints/react/hooks/index.d.ts +0 -1
- package/legacyEntryPoints/react/hooks/index.js +0 -1
- package/legacyEntryPoints/react/parser/index.d.ts +0 -1
- package/legacyEntryPoints/react/parser/index.js +0 -1
- package/legacyEntryPoints/react/parser/parser.cjs +0 -1
- package/legacyEntryPoints/react/parser/parser.d.cts +0 -1
- package/link/http/iterators/async.d.ts +0 -6
- package/link/http/iterators/async.js +0 -16
- package/link/http/iterators/async.js.map +0 -1
- package/link/http/iterators/nodeStream.d.ts +0 -7
- package/link/http/iterators/nodeStream.js +0 -72
- package/link/http/iterators/nodeStream.js.map +0 -1
- package/link/http/iterators/promise.d.ts +0 -6
- package/link/http/iterators/promise.js +0 -29
- package/link/http/iterators/promise.js.map +0 -1
- package/link/http/iterators/reader.d.ts +0 -6
- package/link/http/iterators/reader.js +0 -16
- package/link/http/iterators/reader.js.map +0 -1
- package/link/http/responseIterator.d.ts +0 -7
- package/link/http/responseIterator.js +0 -46
- package/link/http/responseIterator.js.map +0 -1
- package/react/context/index.d.ts +0 -7
- package/react/context/index.js +0 -4
- package/react/context/index.js.map +0 -1
- package/react/hooks/index.d.ts +0 -22
- package/react/hooks/index.js +0 -15
- package/react/hooks/index.js.map +0 -1
- package/react/parser/index.d.ts +0 -18
- package/react/parser/index.js +0 -109
- package/react/parser/index.js.map +0 -1
- package/react/ssr/RenderPromises.d.ts +0 -22
- package/react/ssr/RenderPromises.js +0 -100
- package/react/ssr/RenderPromises.js.map +0 -1
- package/react/types/types.d.ts +0 -689
- package/testing/matchers/toEmitApolloQueryResult.d.ts +0 -8
- package/testing/matchers/toEmitApolloQueryResult.js +0 -36
- package/testing/matchers/toEmitApolloQueryResult.js.map +0 -1
- package/testing/matchers/toEmitFetchResult.d.ts +0 -8
- package/testing/matchers/toEmitFetchResult.js.map +0 -1
- package/testing/matchers/toEmitMatchedValue.d.ts +0 -7
- package/testing/matchers/toEmitMatchedValue.js +0 -36
- package/testing/matchers/toEmitMatchedValue.js.map +0 -1
- package/testing/matchers/toEmitValue.d.ts +0 -4
- package/testing/matchers/toEmitValue.js +0 -37
- package/testing/matchers/toEmitValue.js.map +0 -1
- package/testing/matchers/toEmitValueStrict.js +0 -42
- package/testing/matchers/toEmitValueStrict.js.map +0 -1
- package/testing/matchers/toEqualApolloQueryResult.d.ts +0 -6
- package/testing/matchers/toEqualApolloQueryResult.js +0 -20
- package/testing/matchers/toEqualApolloQueryResult.js.map +0 -1
- package/testing/matchers/toEqualFetchResult.d.ts +0 -4
- package/testing/matchers/toEqualFetchResult.js +0 -20
- package/testing/matchers/toEqualFetchResult.js.map +0 -1
- package/testing/matchers/toEqualLazyQueryResult.d.ts +0 -10
- package/testing/matchers/toEqualLazyQueryResult.js +0 -36
- package/testing/matchers/toEqualLazyQueryResult.js.map +0 -1
- package/testing/matchers/toEqualQueryResult.d.ts +0 -9
- package/testing/matchers/toEqualQueryResult.js +0 -36
- package/testing/matchers/toEqualQueryResult.js.map +0 -1
- package/utilities/caching/getMemoryInternals.js.map +0 -1
- package/utilities/types/OnlyRequiredProperties.d.ts +0 -7
- package/utilities/types/OnlyRequiredProperties.js +0 -2
- package/utilities/types/OnlyRequiredProperties.js.map +0 -1
- package/utilities/types/TODO.d.ts +0 -3
- package/utilities/types/TODO.js +0 -2
- package/utilities/types/TODO.js.map +0 -1
- /package/__cjs/react/{types → internal}/types.cjs +0 -0
- /package/__cjs/react/{types → internal}/types.cjs.map +0 -0
- /package/react/{types → internal}/types.js +0 -0
- /package/react/{types → internal}/types.js.map +0 -0
|
@@ -1,7 +1,201 @@
|
|
|
1
1
|
import type { TypedDocumentNode } from "@graphql-typed-document-node/core";
|
|
2
|
-
import type { DocumentNode } from "
|
|
3
|
-
import type {
|
|
4
|
-
import type {
|
|
2
|
+
import type { ApolloCache, ApolloClient, DefaultContext, DocumentNode, ErrorLike, ErrorPolicy, FetchResult, InternalRefetchQueriesInclude, MaybeMasked, MutateResult, MutationFetchPolicy, MutationQueryReducersMap, MutationUpdaterFunction, OnQueryUpdated, OperationVariables, Unmasked } from "@apollo/client";
|
|
3
|
+
import type { NoInfer } from "@apollo/client/utilities";
|
|
4
|
+
import type { IgnoreModifier } from "../../cache/core/types/common.cjs";
|
|
5
|
+
export declare namespace useMutation {
|
|
6
|
+
interface Options<TData = unknown, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache = ApolloCache> {
|
|
7
|
+
/**
|
|
8
|
+
* By providing either an object or a callback function that, when invoked after a mutation, allows you to return optimistic data and optionally skip updates via the `IGNORE` sentinel object, Apollo Client caches this temporary (and potentially incorrect) response until the mutation completes, enabling more responsive UI updates.
|
|
9
|
+
*
|
|
10
|
+
* For more information, see [Optimistic mutation results](https://www.apollographql.com/docs/react/performance/optimistic-ui/).
|
|
11
|
+
*
|
|
12
|
+
* @docGroup
|
|
13
|
+
*
|
|
14
|
+
* 3. Caching options
|
|
15
|
+
*/
|
|
16
|
+
optimisticResponse?: Unmasked<NoInfer<TData>> | ((vars: TVariables, { IGNORE }: {
|
|
17
|
+
IGNORE: IgnoreModifier;
|
|
18
|
+
}) => Unmasked<NoInfer<TData>> | IgnoreModifier);
|
|
19
|
+
/**
|
|
20
|
+
* A `MutationQueryReducersMap`, which is map from query names to mutation query reducers. Briefly, this map defines how to incorporate the results of the mutation into the results of queries that are currently being watched by your application.
|
|
21
|
+
*/
|
|
22
|
+
updateQueries?: MutationQueryReducersMap<TData>;
|
|
23
|
+
/**
|
|
24
|
+
* An array (or a function that _returns_ an array) that specifies which queries you want to refetch after the mutation occurs.
|
|
25
|
+
*
|
|
26
|
+
* Each array value can be either:
|
|
27
|
+
*
|
|
28
|
+
* - An object containing the `query` to execute, along with any `variables`
|
|
29
|
+
*
|
|
30
|
+
* - A string indicating the operation name of the query to refetch
|
|
31
|
+
*
|
|
32
|
+
* @docGroup
|
|
33
|
+
*
|
|
34
|
+
* 1. Operation options
|
|
35
|
+
*/
|
|
36
|
+
refetchQueries?: ((result: FetchResult<Unmasked<TData>>) => InternalRefetchQueriesInclude) | InternalRefetchQueriesInclude;
|
|
37
|
+
/**
|
|
38
|
+
* If `true`, makes sure all queries included in `refetchQueries` are completed before the mutation is considered complete.
|
|
39
|
+
*
|
|
40
|
+
* The default value is `false` (queries are refetched asynchronously).
|
|
41
|
+
*
|
|
42
|
+
* @docGroup
|
|
43
|
+
*
|
|
44
|
+
* 1. Operation options
|
|
45
|
+
*/
|
|
46
|
+
awaitRefetchQueries?: boolean;
|
|
47
|
+
/**
|
|
48
|
+
* A function used to update the Apollo Client cache after the mutation completes.
|
|
49
|
+
*
|
|
50
|
+
* For more information, see [Updating the cache after a mutation](https://www.apollographql.com/docs/react/data/mutations#updating-the-cache-after-a-mutation).
|
|
51
|
+
*
|
|
52
|
+
* @docGroup
|
|
53
|
+
*
|
|
54
|
+
* 3. Caching options
|
|
55
|
+
*/
|
|
56
|
+
update?: MutationUpdaterFunction<TData, TVariables, TContext, TCache>;
|
|
57
|
+
/**
|
|
58
|
+
* Optional callback for intercepting queries whose cache data has been updated by the mutation, as well as any queries specified in the `refetchQueries: [...]` list passed to `client.mutate`.
|
|
59
|
+
*
|
|
60
|
+
* Returning a `Promise` from `onQueryUpdated` will cause the final mutation `Promise` to await the returned `Promise`. Returning `false` causes the query to be ignored.
|
|
61
|
+
*
|
|
62
|
+
* @docGroup
|
|
63
|
+
*
|
|
64
|
+
* 1. Operation options
|
|
65
|
+
*/
|
|
66
|
+
onQueryUpdated?: OnQueryUpdated<any>;
|
|
67
|
+
/**
|
|
68
|
+
* Specifies how the mutation handles a response that returns both GraphQL errors and partial results.
|
|
69
|
+
*
|
|
70
|
+
* For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
|
|
71
|
+
*
|
|
72
|
+
* The default value is `none`, meaning that the mutation result includes error details but _not_ partial results.
|
|
73
|
+
*
|
|
74
|
+
* @docGroup
|
|
75
|
+
*
|
|
76
|
+
* 1. Operation options
|
|
77
|
+
*/
|
|
78
|
+
errorPolicy?: ErrorPolicy;
|
|
79
|
+
/**
|
|
80
|
+
* An object containing all of the GraphQL variables your mutation requires to execute.
|
|
81
|
+
*
|
|
82
|
+
* Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
|
|
83
|
+
*
|
|
84
|
+
* @docGroup
|
|
85
|
+
*
|
|
86
|
+
* 1. Operation options
|
|
87
|
+
*/
|
|
88
|
+
variables?: TVariables;
|
|
89
|
+
/**
|
|
90
|
+
* If you're using [Apollo Link](https://www.apollographql.com/docs/react/api/link/introduction/), this object is the initial value of the `context` object that's passed along your link chain.
|
|
91
|
+
*
|
|
92
|
+
* @docGroup
|
|
93
|
+
*
|
|
94
|
+
* 2. Networking options
|
|
95
|
+
*/
|
|
96
|
+
context?: TContext;
|
|
97
|
+
/**
|
|
98
|
+
* Provide `no-cache` if the mutation's result should _not_ be written to the Apollo Client cache.
|
|
99
|
+
*
|
|
100
|
+
* The default value is `network-only` (which means the result _is_ written to the cache).
|
|
101
|
+
*
|
|
102
|
+
* Unlike queries, mutations _do not_ support [fetch policies](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy) besides `network-only` and `no-cache`.
|
|
103
|
+
*
|
|
104
|
+
* @docGroup
|
|
105
|
+
*
|
|
106
|
+
* 3. Caching options
|
|
107
|
+
*/
|
|
108
|
+
fetchPolicy?: MutationFetchPolicy;
|
|
109
|
+
/**
|
|
110
|
+
* To avoid retaining sensitive information from mutation root field arguments, Apollo Client v3.4+ automatically clears any `ROOT_MUTATION` fields from the cache after each mutation finishes. If you need this information to remain in the cache, you can prevent the removal by passing `keepRootFields: true` to the mutation. `ROOT_MUTATION` result data are also passed to the mutation `update` function, so we recommend obtaining the results that way, rather than using this option, if possible.
|
|
111
|
+
*/
|
|
112
|
+
keepRootFields?: boolean;
|
|
113
|
+
/**
|
|
114
|
+
* The instance of `ApolloClient` to use to execute the mutation.
|
|
115
|
+
*
|
|
116
|
+
* By default, the instance that's passed down via context is used, but you can provide a different instance here.
|
|
117
|
+
*
|
|
118
|
+
* @docGroup
|
|
119
|
+
*
|
|
120
|
+
* 2. Networking options
|
|
121
|
+
*/
|
|
122
|
+
client?: ApolloClient;
|
|
123
|
+
/**
|
|
124
|
+
* If `true`, the in-progress mutation's associated component re-renders whenever the network status changes or a network error occurs.
|
|
125
|
+
*
|
|
126
|
+
* The default value is `true`.
|
|
127
|
+
*
|
|
128
|
+
* @docGroup
|
|
129
|
+
*
|
|
130
|
+
* 2. Networking options
|
|
131
|
+
*/
|
|
132
|
+
notifyOnNetworkStatusChange?: boolean;
|
|
133
|
+
/**
|
|
134
|
+
* A callback function that's called when your mutation successfully completes with zero errors (or if `errorPolicy` is `ignore` and partial data is returned).
|
|
135
|
+
*
|
|
136
|
+
* This function is passed the mutation's result `data` and any options passed to the mutation.
|
|
137
|
+
*
|
|
138
|
+
* @docGroup
|
|
139
|
+
*
|
|
140
|
+
* 1. Operation options
|
|
141
|
+
*/
|
|
142
|
+
onCompleted?: (data: MaybeMasked<TData>, clientOptions?: Options<TData, TVariables, TContext, TCache>) => void;
|
|
143
|
+
/**
|
|
144
|
+
* A callback function that's called when the mutation encounters one or more errors (unless `errorPolicy` is `ignore`).
|
|
145
|
+
*
|
|
146
|
+
* This function is passed an [`ApolloError`](https://github.com/apollographql/apollo-client/blob/d96f4578f89b933c281bb775a39503f6cdb59ee8/src/errors/index.ts#L36-L39) object that contains either a `networkError` object or a `graphQLErrors` array, depending on the error(s) that occurred, as well as any options passed the mutation.
|
|
147
|
+
*
|
|
148
|
+
* @docGroup
|
|
149
|
+
*
|
|
150
|
+
* 1. Operation options
|
|
151
|
+
*/
|
|
152
|
+
onError?: (error: ErrorLike, clientOptions?: Options<TData, TVariables, TContext, TCache>) => void;
|
|
153
|
+
}
|
|
154
|
+
interface Result<TData = unknown> {
|
|
155
|
+
/**
|
|
156
|
+
* The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
|
|
157
|
+
*/
|
|
158
|
+
data: MaybeMasked<TData> | null | undefined;
|
|
159
|
+
/**
|
|
160
|
+
* If the mutation produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
|
|
161
|
+
*
|
|
162
|
+
* For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
|
|
163
|
+
*/
|
|
164
|
+
error: ErrorLike | undefined;
|
|
165
|
+
/**
|
|
166
|
+
* If `true`, the mutation is currently in flight.
|
|
167
|
+
*/
|
|
168
|
+
loading: boolean;
|
|
169
|
+
/**
|
|
170
|
+
* If `true`, the mutation's mutate function has been called.
|
|
171
|
+
*/
|
|
172
|
+
called: boolean;
|
|
173
|
+
/**
|
|
174
|
+
* The instance of Apollo Client that executed the mutation.
|
|
175
|
+
*
|
|
176
|
+
* Can be useful for manually executing followup operations or writing data to the cache.
|
|
177
|
+
*/
|
|
178
|
+
client: ApolloClient;
|
|
179
|
+
/**
|
|
180
|
+
* A function that you can call to reset the mutation's result to its initial, uncalled state.
|
|
181
|
+
*/
|
|
182
|
+
reset: () => void;
|
|
183
|
+
}
|
|
184
|
+
type ResultTuple<TData, TVariables, TContext = DefaultContext, TCache extends ApolloCache = ApolloCache> = [
|
|
185
|
+
mutate: (options?: MutationFunctionOptions<TData, TVariables, TContext, TCache>) => Promise<MutateResult<MaybeMasked<TData>>>,
|
|
186
|
+
result: Result<TData>
|
|
187
|
+
];
|
|
188
|
+
interface MutationFunctionOptions<TData = unknown, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache = ApolloCache> extends Options<TData, TVariables, TContext, TCache> {
|
|
189
|
+
/**
|
|
190
|
+
* A GraphQL document, often created with `gql` from the `graphql-tag` package, that contains a single mutation inside of it.
|
|
191
|
+
*
|
|
192
|
+
* @docGroup
|
|
193
|
+
*
|
|
194
|
+
* 1. Operation options
|
|
195
|
+
*/
|
|
196
|
+
mutation?: DocumentNode | TypedDocumentNode<TData, TVariables>;
|
|
197
|
+
}
|
|
198
|
+
}
|
|
5
199
|
/**
|
|
6
200
|
*
|
|
7
201
|
*
|
|
@@ -49,5 +243,5 @@ import type { MutationHookOptions, MutationTuple, NoInfer } from "@apollo/client
|
|
|
49
243
|
* @param options - Options to control how the mutation is executed.
|
|
50
244
|
* @returns A tuple in the form of `[mutate, result]`
|
|
51
245
|
*/
|
|
52
|
-
export declare function useMutation<TData =
|
|
246
|
+
export declare function useMutation<TData = unknown, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache = ApolloCache>(mutation: DocumentNode | TypedDocumentNode<TData, TVariables>, options?: useMutation.Options<NoInfer<TData>, NoInfer<TVariables>, TContext, TCache>): useMutation.ResultTuple<TData, TVariables, TContext, TCache>;
|
|
53
247
|
//# sourceMappingURL=useMutation.d.cts.map
|
|
@@ -13,20 +13,13 @@ const tslib_1 = require("tslib");
|
|
|
13
13
|
* options
|
|
14
14
|
* watchQueryOptions
|
|
15
15
|
* makeWatchQueryOptions
|
|
16
|
-
* isSSRAllowed
|
|
17
|
-
* disableNetworkFetches
|
|
18
|
-
* renderPromises
|
|
19
|
-
* isSyncSSR
|
|
20
16
|
*/
|
|
21
17
|
/** */
|
|
22
18
|
const equality_1 = require("@wry/equality");
|
|
23
|
-
const React = tslib_1.__importStar(require("
|
|
19
|
+
const React = tslib_1.__importStar(require("react"));
|
|
24
20
|
const rxjs_1 = require("rxjs");
|
|
25
|
-
const
|
|
26
|
-
const context_1 = require("@apollo/client/react/context");
|
|
27
|
-
const parser_1 = require("@apollo/client/react/parser");
|
|
21
|
+
const client_1 = require("@apollo/client");
|
|
28
22
|
const utilities_1 = require("@apollo/client/utilities");
|
|
29
|
-
const utilities_2 = require("@apollo/client/utilities");
|
|
30
23
|
const index_js_1 = require("./internal/index.cjs");
|
|
31
24
|
const useApolloClient_js_1 = require("./useApolloClient.cjs");
|
|
32
25
|
const useSyncExternalStore_js_1 = require("./useSyncExternalStore.cjs");
|
|
@@ -65,97 +58,99 @@ const lastWatchOptions = Symbol();
|
|
|
65
58
|
* @param options - Options to control how the query is executed.
|
|
66
59
|
* @returns Query result object
|
|
67
60
|
*/
|
|
68
|
-
function useQuery(query, options
|
|
61
|
+
function useQuery(query, ...[options]) {
|
|
62
|
+
"use no memo";
|
|
69
63
|
return (0, index_js_1.wrapHook)("useQuery",
|
|
70
64
|
// eslint-disable-next-line react-compiler/react-compiler
|
|
71
65
|
useQuery_, (0, useApolloClient_js_1.useApolloClient)(options && options.client))(query, options);
|
|
72
66
|
}
|
|
73
|
-
function useQuery_(query, options) {
|
|
74
|
-
const
|
|
75
|
-
const
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
67
|
+
function useQuery_(query, options = {}) {
|
|
68
|
+
const client = (0, useApolloClient_js_1.useApolloClient)(options.client);
|
|
69
|
+
const { skip, ssr, ...opts } = options;
|
|
70
|
+
const watchQueryOptions = (0, utilities_1.mergeOptions)(client.defaultOptions.watchQuery, { ...opts, query });
|
|
71
|
+
if (skip) {
|
|
72
|
+
// When skipping, we set watchQueryOptions.fetchPolicy initially to
|
|
73
|
+
// "standby", but we also need/want to preserve the initial non-standby
|
|
74
|
+
// fetchPolicy that would have been used if not skipping.
|
|
75
|
+
watchQueryOptions.initialFetchPolicy =
|
|
76
|
+
options.initialFetchPolicy || options.fetchPolicy;
|
|
77
|
+
watchQueryOptions.fetchPolicy = "standby";
|
|
78
|
+
}
|
|
79
|
+
function createState(previous) {
|
|
80
|
+
const observable = client_1.ObservableQuery["inactiveOnCreation"].withValue(true, () => client.watchQuery(watchQueryOptions));
|
|
81
|
+
return {
|
|
82
82
|
client,
|
|
83
83
|
query,
|
|
84
|
-
observable
|
|
85
|
-
// See if there is an existing observable that was used to fetch the same
|
|
86
|
-
// data and if so, use it instead since it will contain the proper queryId
|
|
87
|
-
// to fetch the result set. This is used during SSR.
|
|
88
|
-
(renderPromises &&
|
|
89
|
-
renderPromises.getSSRObservable(makeWatchQueryOptions())) ||
|
|
90
|
-
client.watchQuery(getObsQueryOptions(void 0, client, options, makeWatchQueryOptions())),
|
|
84
|
+
observable,
|
|
91
85
|
resultData: {
|
|
86
|
+
current: observable.getCurrentResult(),
|
|
92
87
|
// Reuse previousData from previous InternalState (if any) to provide
|
|
93
88
|
// continuity of previousData even if/when the query or client changes.
|
|
94
|
-
previousData: previous?.resultData.current
|
|
89
|
+
previousData: previous?.resultData.current.data,
|
|
95
90
|
},
|
|
96
91
|
};
|
|
97
|
-
return internalState;
|
|
98
92
|
}
|
|
99
|
-
let [
|
|
100
|
-
if (client !==
|
|
93
|
+
let [state, setState] = React.useState(createState);
|
|
94
|
+
if (client !== state.client || query !== state.query) {
|
|
101
95
|
// If the client or query have changed, we need to create a new InternalState.
|
|
102
96
|
// This will trigger a re-render with the new state, but it will also continue
|
|
103
97
|
// to run the current render function to completion.
|
|
104
98
|
// Since we sometimes trigger some side-effects in the render function, we
|
|
105
99
|
// re-assign `state` to the new state to ensure that those side-effects are
|
|
106
100
|
// triggered with the new state.
|
|
107
|
-
|
|
108
|
-
updateInternalState(newInternalState);
|
|
109
|
-
return newInternalState;
|
|
101
|
+
setState((state = createState(state)));
|
|
110
102
|
}
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
function useQueryInternals(query, options) {
|
|
114
|
-
const client = (0, useApolloClient_js_1.useApolloClient)(options.client);
|
|
115
|
-
const renderPromises = React.useContext((0, context_1.getApolloContext)()).renderPromises;
|
|
116
|
-
const isSyncSSR = !!renderPromises;
|
|
117
|
-
const disableNetworkFetches = client.disableNetworkFetches;
|
|
118
|
-
const ssrAllowed = options.ssr !== false && !options.skip;
|
|
119
|
-
const makeWatchQueryOptions = createMakeWatchQueryOptions(client, query, options, isSyncSSR);
|
|
120
|
-
const { observable, resultData } = useInternalState(client, query, options, renderPromises, makeWatchQueryOptions);
|
|
121
|
-
const watchQueryOptions = makeWatchQueryOptions(observable);
|
|
103
|
+
const { observable, resultData } = state;
|
|
104
|
+
useInitialFetchPolicyIfNecessary(watchQueryOptions, observable);
|
|
122
105
|
useResubscribeIfNecessary(resultData, // might get mutated during render
|
|
123
106
|
observable, // might get mutated during render
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
const
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
//
|
|
134
|
-
//
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
: void 0;
|
|
107
|
+
watchQueryOptions);
|
|
108
|
+
const ssrDisabledOverride = (0, useSyncExternalStore_js_1.useSyncExternalStore)(() => () => { }, () => void 0, () => (ssr === false ? useQuery.ssrDisabledResult : void 0));
|
|
109
|
+
const resultOverride = skip || watchQueryOptions.fetchPolicy === "standby" ?
|
|
110
|
+
// When skipping a query (ie. we're not querying for data but still want to
|
|
111
|
+
// render children), make sure the `data` is cleared out and `loading` is
|
|
112
|
+
// set to `false` (since we aren't loading anything).
|
|
113
|
+
//
|
|
114
|
+
// NOTE: We no longer think this is the correct behavior. Skipping should
|
|
115
|
+
// not automatically set `data` to `undefined`, but instead leave the
|
|
116
|
+
// previous data in place. In other words, skipping should not mandate that
|
|
117
|
+
// previously received data is all of a sudden removed. Unfortunately,
|
|
118
|
+
// changing this is breaking, so we'll have to wait until Apollo Client 4.0
|
|
119
|
+
// to address this.
|
|
120
|
+
useQuery.skipStandbyResult
|
|
121
|
+
: ssrDisabledOverride;
|
|
122
|
+
const result = useResultSubscription(observable, resultData, resultOverride);
|
|
123
|
+
const obsQueryFields = React.useMemo(() => ({
|
|
124
|
+
refetch: observable.refetch.bind(observable),
|
|
125
|
+
fetchMore: observable.fetchMore.bind(observable),
|
|
126
|
+
updateQuery: observable.updateQuery.bind(observable),
|
|
127
|
+
startPolling: observable.startPolling.bind(observable),
|
|
128
|
+
stopPolling: observable.stopPolling.bind(observable),
|
|
129
|
+
subscribeToMore: observable.subscribeToMore.bind(observable),
|
|
130
|
+
}), [observable]);
|
|
149
131
|
const previousData = resultData.previousData;
|
|
150
|
-
|
|
151
|
-
|
|
132
|
+
return React.useMemo(() => {
|
|
133
|
+
const { data, partial, ...rest } = result;
|
|
134
|
+
return {
|
|
135
|
+
data, // Ensure always defined, even if result.data is missing.
|
|
136
|
+
...rest,
|
|
137
|
+
client: client,
|
|
138
|
+
observable: observable,
|
|
139
|
+
variables: observable.variables,
|
|
140
|
+
previousData,
|
|
141
|
+
...obsQueryFields,
|
|
142
|
+
};
|
|
143
|
+
}, [result, client, observable, previousData, obsQueryFields]);
|
|
144
|
+
}
|
|
145
|
+
function useInitialFetchPolicyIfNecessary(watchQueryOptions, observable) {
|
|
146
|
+
"use no memo";
|
|
147
|
+
if (!watchQueryOptions.fetchPolicy) {
|
|
148
|
+
watchQueryOptions.fetchPolicy = observable.options.initialFetchPolicy;
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
function useResultSubscription(observable, resultData, resultOverride) {
|
|
152
|
+
"use no memo";
|
|
152
153
|
return (0, useSyncExternalStore_js_1.useSyncExternalStore)(React.useCallback((handleStoreChange) => {
|
|
153
|
-
// reference `disableNetworkFetches` here to ensure that the rules of hooks
|
|
154
|
-
// keep it as a dependency of this effect, even though it's not used
|
|
155
|
-
disableNetworkFetches;
|
|
156
|
-
if (isSyncSSR) {
|
|
157
|
-
return () => { };
|
|
158
|
-
}
|
|
159
154
|
const subscription = observable
|
|
160
155
|
// We use the asapScheduler here to prevent issues with trying to
|
|
161
156
|
// update in the middle of a render. `reobserve` is kicked off in the
|
|
@@ -176,7 +171,12 @@ function useObservableSubscriptionResult(resultData, observable, client, options
|
|
|
176
171
|
(0, equality_1.equal)(previousResult.error, result.error)) {
|
|
177
172
|
return;
|
|
178
173
|
}
|
|
179
|
-
|
|
174
|
+
if (previousResult && previousResult.data) {
|
|
175
|
+
// eslint-disable-next-line react-compiler/react-compiler
|
|
176
|
+
resultData.previousData = previousResult.data;
|
|
177
|
+
}
|
|
178
|
+
resultData.current = result;
|
|
179
|
+
handleStoreChange();
|
|
180
180
|
});
|
|
181
181
|
// Do the "unsubscribe" with a short delay.
|
|
182
182
|
// This way, an existing subscription can be reused without an additional
|
|
@@ -185,16 +185,7 @@ function useObservableSubscriptionResult(resultData, observable, client, options
|
|
|
185
185
|
return () => {
|
|
186
186
|
setTimeout(() => subscription.unsubscribe());
|
|
187
187
|
};
|
|
188
|
-
}, [
|
|
189
|
-
}
|
|
190
|
-
function useRegisterSSRObservable(observable, renderPromises, ssrAllowed) {
|
|
191
|
-
if (renderPromises && ssrAllowed) {
|
|
192
|
-
renderPromises.registerSSRObservable(observable);
|
|
193
|
-
if (observable.getCurrentResult().loading) {
|
|
194
|
-
// TODO: This is a legacy API which could probably be cleaned up
|
|
195
|
-
renderPromises.addObservableQueryPromise(observable);
|
|
196
|
-
}
|
|
197
|
-
}
|
|
188
|
+
}, [observable, resultData]), () => resultOverride || resultData.current, () => resultOverride || resultData.current);
|
|
198
189
|
}
|
|
199
190
|
// this hook is not compatible with any rules of React, and there's no good way to rewrite it.
|
|
200
191
|
// it should stay a separate hook that will not be optimized by the compiler
|
|
@@ -202,7 +193,8 @@ function useResubscribeIfNecessary(
|
|
|
202
193
|
/** this hook will mutate properties on `resultData` */
|
|
203
194
|
resultData,
|
|
204
195
|
/** this hook will mutate properties on `observable` */
|
|
205
|
-
observable,
|
|
196
|
+
observable, watchQueryOptions) {
|
|
197
|
+
"use no memo";
|
|
206
198
|
if (observable[lastWatchOptions] &&
|
|
207
199
|
!(0, equality_1.equal)(observable[lastWatchOptions], watchQueryOptions)) {
|
|
208
200
|
// Though it might be tempting to postpone this reobserve call to the
|
|
@@ -213,139 +205,28 @@ observable, client, options, watchQueryOptions) {
|
|
|
213
205
|
// subscriptions, though it does feel less than ideal that reobserve
|
|
214
206
|
// (potentially) kicks off a network request (for example, when the
|
|
215
207
|
// variables have changed), which is technically a side-effect.
|
|
216
|
-
observable.reobserve(
|
|
208
|
+
observable.reobserve(watchQueryOptions);
|
|
217
209
|
// Make sure getCurrentResult returns a fresh ApolloQueryResult<TData>,
|
|
218
210
|
// but save the current data as this.previousData, just like setResult
|
|
219
211
|
// usually does.
|
|
220
212
|
resultData.previousData =
|
|
221
|
-
resultData.current
|
|
222
|
-
resultData.current =
|
|
213
|
+
resultData.current.data || resultData.previousData;
|
|
214
|
+
resultData.current = observable.getCurrentResult();
|
|
223
215
|
}
|
|
224
216
|
observable[lastWatchOptions] = watchQueryOptions;
|
|
225
217
|
}
|
|
226
|
-
|
|
227
|
-
* A function to massage options before passing them to ObservableQuery.
|
|
228
|
-
* This is two-step curried because we want to reuse the `make` function,
|
|
229
|
-
* but the `observable` might differ between calls to `make`.
|
|
230
|
-
*/
|
|
231
|
-
function createMakeWatchQueryOptions(client, query, { skip, ssr, defaultOptions,
|
|
232
|
-
// The above options are useQuery-specific, so this ...otherOptions spread
|
|
233
|
-
// makes otherOptions almost a WatchQueryOptions object, except for the
|
|
234
|
-
// query property that we add below.
|
|
235
|
-
...otherOptions } = {}, isSyncSSR) {
|
|
236
|
-
return (observable) => {
|
|
237
|
-
// This Object.assign is safe because otherOptions is a fresh ...rest object
|
|
238
|
-
// that did not exist until just now, so modifications are still allowed.
|
|
239
|
-
const watchQueryOptions = Object.assign(otherOptions, { query });
|
|
240
|
-
if (isSyncSSR &&
|
|
241
|
-
(watchQueryOptions.fetchPolicy === "network-only" ||
|
|
242
|
-
watchQueryOptions.fetchPolicy === "cache-and-network")) {
|
|
243
|
-
// this behavior was added to react-apollo without explanation in this PR
|
|
244
|
-
// https://github.com/apollographql/react-apollo/pull/1579
|
|
245
|
-
watchQueryOptions.fetchPolicy = "cache-first";
|
|
246
|
-
}
|
|
247
|
-
if (!watchQueryOptions.variables) {
|
|
248
|
-
watchQueryOptions.variables = {};
|
|
249
|
-
}
|
|
250
|
-
if (skip) {
|
|
251
|
-
// When skipping, we set watchQueryOptions.fetchPolicy initially to
|
|
252
|
-
// "standby", but we also need/want to preserve the initial non-standby
|
|
253
|
-
// fetchPolicy that would have been used if not skipping.
|
|
254
|
-
watchQueryOptions.initialFetchPolicy =
|
|
255
|
-
watchQueryOptions.initialFetchPolicy ||
|
|
256
|
-
watchQueryOptions.fetchPolicy ||
|
|
257
|
-
getDefaultFetchPolicy(defaultOptions, client.defaultOptions);
|
|
258
|
-
watchQueryOptions.fetchPolicy = "standby";
|
|
259
|
-
}
|
|
260
|
-
else if (!watchQueryOptions.fetchPolicy) {
|
|
261
|
-
watchQueryOptions.fetchPolicy =
|
|
262
|
-
observable?.options.initialFetchPolicy ||
|
|
263
|
-
getDefaultFetchPolicy(defaultOptions, client.defaultOptions);
|
|
264
|
-
}
|
|
265
|
-
return watchQueryOptions;
|
|
266
|
-
};
|
|
267
|
-
}
|
|
268
|
-
function getObsQueryOptions(observable, client, queryHookOptions, watchQueryOptions) {
|
|
269
|
-
const toMerge = [];
|
|
270
|
-
const globalDefaults = client.defaultOptions.watchQuery;
|
|
271
|
-
if (globalDefaults)
|
|
272
|
-
toMerge.push(globalDefaults);
|
|
273
|
-
if (queryHookOptions.defaultOptions) {
|
|
274
|
-
toMerge.push(queryHookOptions.defaultOptions);
|
|
275
|
-
}
|
|
276
|
-
// We use compact rather than mergeOptions for this part of the merge,
|
|
277
|
-
// because we want watchQueryOptions.variables (if defined) to replace
|
|
278
|
-
// this.observable.options.variables whole. This replacement allows
|
|
279
|
-
// removing variables by removing them from the variables input to
|
|
280
|
-
// useQuery. If the variables were always merged together (rather than
|
|
281
|
-
// replaced), there would be no way to remove existing variables.
|
|
282
|
-
// However, the variables from options.defaultOptions and globalDefaults
|
|
283
|
-
// (if provided) should be merged, to ensure individual defaulted
|
|
284
|
-
// variables always have values, if not otherwise defined in
|
|
285
|
-
// observable.options or watchQueryOptions.
|
|
286
|
-
toMerge.push((0, utilities_1.compact)(observable && observable.options, watchQueryOptions));
|
|
287
|
-
return toMerge.reduce(utilities_2.mergeOptions);
|
|
288
|
-
}
|
|
289
|
-
function setResult(nextResult, resultData, observable, client, forceUpdate) {
|
|
290
|
-
const previousResult = resultData.current;
|
|
291
|
-
if (previousResult && previousResult.data) {
|
|
292
|
-
resultData.previousData = previousResult.data;
|
|
293
|
-
}
|
|
294
|
-
resultData.current = toQueryResult(nextResult, resultData.previousData, observable, client);
|
|
295
|
-
// Calling state.setResult always triggers an update, though some call sites
|
|
296
|
-
// perform additional equality checks before committing to an update.
|
|
297
|
-
forceUpdate();
|
|
298
|
-
}
|
|
299
|
-
function getCurrentResult(resultData, observable, client) {
|
|
300
|
-
// Using this.result as a cache ensures getCurrentResult continues returning
|
|
301
|
-
// the same (===) result object, unless state.setResult has been called, or
|
|
302
|
-
// we're doing server rendering and therefore override the result below.
|
|
303
|
-
if (!resultData.current) {
|
|
304
|
-
setResult(observable.getCurrentResult(), resultData, observable, client, () => { });
|
|
305
|
-
}
|
|
306
|
-
return resultData.current;
|
|
307
|
-
}
|
|
308
|
-
function getDefaultFetchPolicy(queryHookDefaultOptions, clientDefaultOptions) {
|
|
309
|
-
return (queryHookDefaultOptions?.fetchPolicy ||
|
|
310
|
-
clientDefaultOptions?.watchQuery?.fetchPolicy ||
|
|
311
|
-
"cache-first");
|
|
312
|
-
}
|
|
313
|
-
function toQueryResult(result, previousData, observable, client) {
|
|
314
|
-
const { data, partial, ...resultWithoutPartial } = result;
|
|
315
|
-
const queryResult = {
|
|
316
|
-
data, // Ensure always defined, even if result.data is missing.
|
|
317
|
-
...resultWithoutPartial,
|
|
318
|
-
client: client,
|
|
319
|
-
observable: observable,
|
|
320
|
-
variables: observable.variables,
|
|
321
|
-
called: result !== ssrDisabledResult && result !== skipStandbyResult,
|
|
322
|
-
previousData,
|
|
323
|
-
};
|
|
324
|
-
return queryResult;
|
|
325
|
-
}
|
|
326
|
-
const ssrDisabledResult = (0, utilities_1.maybeDeepFreeze)({
|
|
218
|
+
useQuery.ssrDisabledResult = (0, utilities_1.maybeDeepFreeze)({
|
|
327
219
|
loading: true,
|
|
328
220
|
data: void 0,
|
|
329
221
|
error: void 0,
|
|
330
|
-
networkStatus:
|
|
222
|
+
networkStatus: client_1.NetworkStatus.loading,
|
|
331
223
|
partial: true,
|
|
332
224
|
});
|
|
333
|
-
|
|
225
|
+
useQuery.skipStandbyResult = (0, utilities_1.maybeDeepFreeze)({
|
|
334
226
|
loading: false,
|
|
335
227
|
data: void 0,
|
|
336
228
|
error: void 0,
|
|
337
|
-
networkStatus:
|
|
229
|
+
networkStatus: client_1.NetworkStatus.ready,
|
|
338
230
|
partial: true,
|
|
339
231
|
});
|
|
340
|
-
function bindObservableMethods(observable) {
|
|
341
|
-
return {
|
|
342
|
-
refetch: observable.refetch.bind(observable),
|
|
343
|
-
reobserve: observable.reobserve.bind(observable),
|
|
344
|
-
fetchMore: observable.fetchMore.bind(observable),
|
|
345
|
-
updateQuery: observable.updateQuery.bind(observable),
|
|
346
|
-
startPolling: observable.startPolling.bind(observable),
|
|
347
|
-
stopPolling: observable.stopPolling.bind(observable),
|
|
348
|
-
subscribeToMore: observable.subscribeToMore.bind(observable),
|
|
349
|
-
};
|
|
350
|
-
}
|
|
351
232
|
//# sourceMappingURL=useQuery.cjs.map
|