@apollo/client 4.0.0-rc.5 → 4.0.0-rc.7
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/CHANGELOG.md +153 -0
- package/README.md +40 -40
- package/__cjs/cache/core/cache.cjs +14 -13
- package/__cjs/cache/core/cache.cjs.map +1 -1
- package/__cjs/cache/core/cache.d.cts +77 -71
- package/__cjs/cache/core/types/Cache.cjs +0 -4
- package/__cjs/cache/core/types/Cache.cjs.map +1 -1
- package/__cjs/cache/core/types/Cache.d.cts +200 -15
- package/__cjs/cache/{core/types/DataProxy.cjs → deprecated.cjs} +1 -1
- package/__cjs/cache/deprecated.cjs.map +1 -0
- package/__cjs/cache/deprecated.d.cts +6 -0
- package/__cjs/cache/index.cjs.map +1 -1
- package/__cjs/cache/index.d.cts +2 -2
- package/__cjs/cache/inmemory/entityStore.cjs +25 -28
- package/__cjs/cache/inmemory/entityStore.cjs.map +1 -1
- package/__cjs/cache/inmemory/entityStore.d.cts +17 -16
- package/__cjs/cache/inmemory/inMemoryCache.cjs.map +1 -1
- package/__cjs/cache/inmemory/inMemoryCache.d.cts +4 -4
- package/__cjs/cache/inmemory/key-extractor.cjs +1 -1
- package/__cjs/cache/inmemory/policies.cjs +4 -4
- package/__cjs/cache/inmemory/policies.cjs.map +1 -1
- package/__cjs/cache/inmemory/policies.d.cts +3 -2
- package/__cjs/cache/inmemory/readFromStore.cjs +2 -2
- package/__cjs/cache/inmemory/writeToStore.cjs +4 -4
- package/__cjs/cache/inmemory/writeToStore.cjs.map +1 -1
- package/__cjs/cache/inmemory/writeToStore.d.cts +1 -1
- package/__cjs/core/ApolloClient.cjs +94 -112
- package/__cjs/core/ApolloClient.cjs.map +1 -1
- package/__cjs/core/ApolloClient.d.cts +758 -182
- package/__cjs/core/ObservableQuery.cjs +10 -10
- package/__cjs/core/ObservableQuery.cjs.map +1 -1
- package/__cjs/core/ObservableQuery.d.cts +131 -112
- package/__cjs/core/QueryInfo.cjs.map +1 -1
- package/__cjs/core/QueryInfo.d.cts +8 -7
- package/__cjs/core/QueryManager.cjs +15 -15
- package/__cjs/core/QueryManager.cjs.map +1 -1
- package/__cjs/core/QueryManager.d.cts +20 -20
- package/__cjs/core/deprecated.cjs +3 -0
- package/__cjs/core/deprecated.cjs.map +1 -0
- package/__cjs/core/deprecated.d.cts +29 -0
- package/__cjs/core/index.cjs.map +1 -1
- package/__cjs/core/index.d.cts +10 -6
- package/__cjs/core/types.d.cts +69 -157
- package/__cjs/core/watchQueryOptions.d.cts +8 -297
- package/__cjs/dev/setErrorMessageHandler.cjs.map +1 -1
- package/__cjs/dev/setErrorMessageHandler.d.cts +4 -4
- package/__cjs/errors/CombinedGraphQLErrors.cjs +64 -11
- package/__cjs/errors/CombinedGraphQLErrors.cjs.map +1 -1
- package/__cjs/errors/CombinedGraphQLErrors.d.cts +168 -14
- package/__cjs/errors/CombinedProtocolErrors.cjs +54 -1
- package/__cjs/errors/CombinedProtocolErrors.cjs.map +1 -1
- package/__cjs/errors/CombinedProtocolErrors.d.cts +132 -2
- package/__cjs/errors/LinkError.cjs +45 -2
- package/__cjs/errors/LinkError.cjs.map +1 -1
- package/__cjs/errors/LinkError.d.cts +45 -2
- package/__cjs/errors/LocalStateError.cjs +35 -5
- package/__cjs/errors/LocalStateError.cjs.map +1 -1
- package/__cjs/errors/LocalStateError.d.cts +41 -5
- package/__cjs/errors/ServerError.cjs +51 -8
- package/__cjs/errors/ServerError.cjs.map +1 -1
- package/__cjs/errors/ServerError.d.cts +71 -11
- package/__cjs/errors/ServerParseError.cjs +46 -8
- package/__cjs/errors/ServerParseError.cjs.map +1 -1
- package/__cjs/errors/ServerParseError.d.cts +72 -16
- package/__cjs/errors/UnconventionalError.cjs +46 -2
- package/__cjs/errors/UnconventionalError.cjs.map +1 -1
- package/__cjs/errors/UnconventionalError.d.cts +46 -2
- package/__cjs/incremental/handlers/defer20220824.cjs.map +1 -1
- package/__cjs/incremental/handlers/defer20220824.d.cts +4 -4
- package/__cjs/incremental/handlers/notImplemented.cjs +1 -1
- package/__cjs/incremental/handlers/notImplemented.cjs.map +1 -1
- package/__cjs/incremental/handlers/notImplemented.d.cts +2 -2
- package/__cjs/incremental/types.d.cts +4 -4
- package/__cjs/invariantErrorCodes.cjs +81 -85
- package/__cjs/link/batch/batchLink.cjs +3 -9
- package/__cjs/link/batch/batchLink.cjs.map +1 -1
- package/__cjs/link/batch/batchLink.d.cts +2 -3
- package/__cjs/link/batch/batching.cjs +1 -1
- package/__cjs/link/batch/batching.cjs.map +1 -1
- package/__cjs/link/batch/batching.d.cts +7 -7
- package/__cjs/link/batch-http/batchHttpLink.cjs +8 -5
- package/__cjs/link/batch-http/batchHttpLink.cjs.map +1 -1
- package/__cjs/link/batch-http/batchHttpLink.d.cts +1 -2
- package/__cjs/link/client-awareness/ClientAwarenessLink.cjs.map +1 -1
- package/__cjs/link/client-awareness/ClientAwarenessLink.d.cts +4 -4
- package/__cjs/link/context/index.cjs +1 -1
- package/__cjs/link/context/index.cjs.map +1 -1
- package/__cjs/link/context/index.d.cts +4 -5
- package/__cjs/link/core/ApolloLink.cjs +227 -55
- package/__cjs/link/core/ApolloLink.cjs.map +1 -1
- package/__cjs/link/core/ApolloLink.d.cts +355 -9
- package/__cjs/link/core/concat.cjs +4 -0
- package/__cjs/link/core/concat.cjs.map +1 -1
- package/__cjs/link/core/concat.d.cts +4 -0
- package/__cjs/link/core/deprecated.cjs +3 -0
- package/__cjs/link/core/deprecated.cjs.map +1 -0
- package/__cjs/link/core/deprecated.d.cts +10 -0
- package/__cjs/link/core/empty.cjs +4 -0
- package/__cjs/link/core/empty.cjs.map +1 -1
- package/__cjs/link/core/empty.d.cts +4 -0
- package/__cjs/link/core/from.cjs +4 -0
- package/__cjs/link/core/from.cjs.map +1 -1
- package/__cjs/link/core/from.d.cts +4 -0
- package/__cjs/link/core/split.cjs +4 -0
- package/__cjs/link/core/split.cjs.map +1 -1
- package/__cjs/link/core/split.d.cts +4 -0
- package/__cjs/link/core/types.d.cts +2 -33
- package/__cjs/link/error/index.cjs.map +1 -1
- package/__cjs/link/error/index.d.cts +20 -6
- package/__cjs/link/http/BaseHttpLink.cjs +2 -2
- package/__cjs/link/http/BaseHttpLink.cjs.map +1 -1
- package/__cjs/link/http/HttpLink.cjs +4 -1
- package/__cjs/link/http/HttpLink.cjs.map +1 -1
- package/__cjs/link/http/HttpLink.d.cts +3 -3
- package/__cjs/link/http/checkFetcher.cjs +1 -1
- package/__cjs/link/http/parseAndCheckHttpResponse.cjs +41 -26
- package/__cjs/link/http/parseAndCheckHttpResponse.cjs.map +1 -1
- package/__cjs/link/http/parseAndCheckHttpResponse.d.cts +2 -2
- package/__cjs/link/http/selectHttpOptionsAndBody.cjs.map +1 -1
- package/__cjs/link/http/selectHttpOptionsAndBody.d.cts +3 -3
- package/__cjs/link/http/selectURI.cjs.map +1 -1
- package/__cjs/link/http/selectURI.d.cts +2 -2
- package/__cjs/link/http/serializeFetchParameter.cjs +1 -1
- package/__cjs/link/index.cjs.map +1 -1
- package/__cjs/link/index.d.cts +2 -1
- package/__cjs/link/persisted-queries/index.cjs +2 -2
- package/__cjs/link/persisted-queries/index.cjs.map +1 -1
- package/__cjs/link/persisted-queries/index.d.cts +11 -12
- package/__cjs/link/retry/delayFunction.cjs.map +1 -1
- package/__cjs/link/retry/delayFunction.d.cts +3 -3
- package/__cjs/link/retry/retryFunction.cjs.map +1 -1
- package/__cjs/link/retry/retryFunction.d.cts +4 -4
- package/__cjs/link/retry/retryLink.cjs +2 -2
- package/__cjs/link/retry/retryLink.cjs.map +1 -1
- package/__cjs/link/retry/retryLink.d.cts +1 -2
- package/__cjs/link/schema/index.cjs.map +1 -1
- package/__cjs/link/schema/index.d.cts +2 -3
- package/__cjs/link/subscriptions/index.cjs.map +1 -1
- package/__cjs/link/subscriptions/index.d.cts +1 -2
- package/__cjs/link/utils/createOperation.cjs +12 -4
- package/__cjs/link/utils/createOperation.cjs.map +1 -1
- package/__cjs/link/utils/createOperation.d.cts +2 -2
- package/__cjs/link/utils/index.cjs +1 -5
- package/__cjs/link/utils/index.cjs.map +1 -1
- package/__cjs/link/utils/index.d.cts +0 -2
- package/__cjs/link/ws/index.cjs.map +1 -1
- package/__cjs/link/ws/index.d.cts +1 -2
- package/__cjs/local-state/LocalState.cjs +55 -9
- package/__cjs/local-state/LocalState.cjs.map +1 -1
- package/__cjs/local-state/LocalState.d.cts +94 -0
- package/__cjs/masking/GraphQLCodegenDataMasking.d.cts +6 -7
- package/__cjs/masking/internal/types.d.cts +70 -70
- package/__cjs/masking/maskDefinition.cjs +2 -2
- package/__cjs/masking/maskFragment.cjs +2 -2
- package/__cjs/masking/maskOperation.cjs +1 -1
- package/__cjs/masking/utils.cjs +3 -3
- package/__cjs/react/context/ApolloContext.cjs +1 -1
- package/__cjs/react/context/ApolloProvider.cjs +1 -1
- package/__cjs/react/hooks/internal/useDeepMemo.cjs +0 -3
- package/__cjs/react/hooks/internal/useDeepMemo.cjs.map +1 -1
- package/__cjs/react/hooks/internal/validateSuspenseHookOptions.cjs.map +1 -1
- package/__cjs/react/hooks/internal/validateSuspenseHookOptions.d.cts +2 -2
- package/__cjs/react/hooks/internal/wrapHook.cjs +1 -0
- package/__cjs/react/hooks/internal/wrapHook.cjs.map +1 -1
- package/__cjs/react/hooks/internal/wrapHook.d.cts +8 -7
- package/__cjs/react/hooks/useApolloClient.cjs +2 -2
- package/__cjs/react/hooks/useApolloClient.cjs.map +1 -1
- package/__cjs/react/hooks/useApolloClient.d.cts +2 -2
- package/__cjs/react/hooks/useBackgroundQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useBackgroundQuery.d.cts +850 -90
- package/__cjs/react/hooks/useFragment.cjs +7 -0
- package/__cjs/react/hooks/useFragment.cjs.map +1 -1
- package/__cjs/react/hooks/useFragment.d.cts +53 -2
- package/__cjs/react/hooks/useLazyQuery.cjs +0 -38
- package/__cjs/react/hooks/useLazyQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useLazyQuery.d.cts +317 -165
- package/__cjs/react/hooks/useLoadableQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useLoadableQuery.d.cts +153 -175
- package/__cjs/react/hooks/useMutation.cjs +6 -7
- package/__cjs/react/hooks/useMutation.cjs.map +1 -1
- package/__cjs/react/hooks/useMutation.d.cts +87 -65
- package/__cjs/react/hooks/useQuery.cjs +1 -35
- package/__cjs/react/hooks/useQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useQuery.d.cts +207 -103
- package/__cjs/react/hooks/useQueryRefHandlers.cjs +2 -1
- package/__cjs/react/hooks/useQueryRefHandlers.cjs.map +1 -1
- package/__cjs/react/hooks/useQueryRefHandlers.d.cts +34 -5
- package/__cjs/react/hooks/useReactiveVar.cjs +2 -1
- package/__cjs/react/hooks/useReactiveVar.cjs.map +1 -1
- package/__cjs/react/hooks/useReactiveVar.d.cts +2 -1
- package/__cjs/react/hooks/useReadQuery.cjs +29 -0
- package/__cjs/react/hooks/useReadQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useReadQuery.d.cts +92 -16
- package/__cjs/react/hooks/useSubscription.cjs +8 -9
- package/__cjs/react/hooks/useSubscription.cjs.map +1 -1
- package/__cjs/react/hooks/useSubscription.d.cts +108 -33
- package/__cjs/react/hooks/useSuspenseFragment.cjs.map +1 -1
- package/__cjs/react/hooks/useSuspenseFragment.d.cts +61 -29
- package/__cjs/react/hooks/useSuspenseQuery.cjs +4 -1
- package/__cjs/react/hooks/useSuspenseQuery.cjs.map +1 -1
- package/__cjs/react/hooks/useSuspenseQuery.d.cts +471 -69
- package/__cjs/react/index.cjs +1 -3
- package/__cjs/react/index.cjs.map +1 -1
- package/__cjs/react/index.d.cts +0 -1
- package/__cjs/react/index.react-server.cjs +1 -3
- package/__cjs/react/index.react-server.cjs.map +1 -1
- package/__cjs/react/index.react-server.d.cts +0 -1
- package/__cjs/react/internal/cache/FragmentReference.cjs.map +1 -1
- package/__cjs/react/internal/cache/FragmentReference.d.cts +2 -3
- package/__cjs/react/internal/cache/QueryReference.cjs.map +1 -1
- package/__cjs/react/internal/cache/QueryReference.d.cts +14 -12
- package/__cjs/react/internal/cache/SuspenseCache.cjs.map +1 -1
- package/__cjs/react/internal/cache/SuspenseCache.d.cts +2 -2
- package/__cjs/react/internal/cache/getSuspenseCache.cjs.map +1 -1
- package/__cjs/react/internal/cache/getSuspenseCache.d.cts +6 -4
- package/__cjs/react/internal/index.cjs +1 -0
- package/__cjs/react/internal/index.cjs.map +1 -1
- package/__cjs/react/internal/index.d.cts +1 -1
- package/__cjs/react/internal/types.d.cts +3 -3
- package/__cjs/react/query-preloader/createQueryPreloader.cjs +1 -1
- package/__cjs/react/query-preloader/createQueryPreloader.cjs.map +1 -1
- package/__cjs/react/query-preloader/createQueryPreloader.d.cts +60 -51
- package/__cjs/react/ssr/prerenderStatic.cjs +5 -4
- package/__cjs/react/ssr/prerenderStatic.cjs.map +1 -1
- package/__cjs/react/ssr/prerenderStatic.d.cts +11 -9
- package/__cjs/react/ssr/useSSRQuery.cjs.map +1 -1
- package/__cjs/react/types/deprecated.d.cts +1 -1
- package/__cjs/react/types/types.documentation.d.cts +15 -15
- package/__cjs/testing/core/mocking/mockLink.cjs.map +1 -1
- package/__cjs/testing/core/mocking/mockLink.d.cts +8 -8
- package/__cjs/testing/core/mocking/mockSubscriptionLink.cjs.map +1 -1
- package/__cjs/testing/core/mocking/mockSubscriptionLink.d.cts +3 -4
- package/__cjs/testing/core/types/deprecated.d.cts +3 -2
- package/__cjs/testing/react/MockedProvider.cjs.map +1 -1
- package/__cjs/testing/react/MockedProvider.d.cts +2 -3
- package/__cjs/utilities/HKT.d.cts +8 -7
- package/__cjs/utilities/caching/sizes.cjs +3 -3
- package/__cjs/utilities/caching/sizes.cjs.map +1 -1
- package/__cjs/utilities/caching/sizes.d.cts +4 -6
- package/__cjs/utilities/graphql/DocumentTransform.cjs +2 -2
- package/__cjs/utilities/graphql/DocumentTransform.cjs.map +1 -1
- package/__cjs/utilities/index.cjs +2 -3
- package/__cjs/utilities/index.cjs.map +1 -1
- package/__cjs/utilities/index.d.cts +1 -2
- package/__cjs/utilities/{shared → internal}/canonicalStringify.cjs +5 -7
- package/__cjs/utilities/internal/canonicalStringify.cjs.map +1 -0
- package/__cjs/utilities/{shared → internal}/canonicalStringify.d.cts +1 -1
- package/__cjs/utilities/internal/checkDocument.cjs +2 -2
- package/__cjs/utilities/internal/checkDocument.cjs.map +1 -1
- package/__cjs/utilities/internal/createFragmentMap.cjs.map +1 -1
- package/__cjs/{core → utilities/internal}/equalByQuery.cjs +13 -7
- package/__cjs/utilities/internal/equalByQuery.cjs.map +1 -0
- package/__cjs/utilities/internal/equalByQuery.d.cts +5 -0
- package/__cjs/utilities/internal/getFragmentQueryDocument.cjs +13 -3
- package/__cjs/utilities/internal/getFragmentQueryDocument.cjs.map +1 -1
- package/__cjs/utilities/internal/getFragmentQueryDocument.d.cts +13 -3
- package/__cjs/utilities/internal/getMemoryInternals.cjs.map +1 -1
- package/__cjs/utilities/internal/getStoreKeyName.cjs +1 -2
- package/__cjs/utilities/internal/getStoreKeyName.cjs.map +1 -1
- package/__cjs/utilities/internal/index.cjs +6 -2
- package/__cjs/utilities/internal/index.cjs.map +1 -1
- package/__cjs/utilities/internal/index.d.cts +2 -0
- package/__cjs/utilities/internal/mergeOptions.cjs.map +1 -1
- package/__cjs/utilities/internal/mergeOptions.d.cts +2 -2
- package/__cjs/utilities/internal/toQueryResult.cjs.map +1 -1
- package/__cjs/utilities/internal/toQueryResult.d.cts +2 -2
- package/__cjs/utilities/internal/types/DocumentationTypes.d.cts +32 -26
- package/__cjs/utilities/internal/types/NoInfer.d.cts +31 -25
- package/__cjs/utilities/internal/types/VariablesOption.d.cts +2 -6
- package/__cjs/utilities/subscriptions/relay/index.cjs +2 -0
- package/__cjs/utilities/subscriptions/relay/index.cjs.map +1 -1
- package/__cjs/version.cjs +1 -1
- package/cache/core/cache.d.ts +77 -71
- package/cache/core/cache.js +15 -14
- package/cache/core/cache.js.map +1 -1
- package/cache/core/types/Cache.d.ts +200 -15
- package/cache/core/types/Cache.js +1 -3
- package/cache/core/types/Cache.js.map +1 -1
- package/cache/deprecated.d.ts +6 -0
- package/cache/deprecated.js +2 -0
- package/cache/deprecated.js.map +1 -0
- package/cache/index.d.ts +2 -2
- package/cache/index.js.map +1 -1
- package/cache/inmemory/entityStore.d.ts +17 -16
- package/cache/inmemory/entityStore.js +25 -28
- package/cache/inmemory/entityStore.js.map +1 -1
- package/cache/inmemory/inMemoryCache.d.ts +4 -4
- package/cache/inmemory/inMemoryCache.js.map +1 -1
- package/cache/inmemory/key-extractor.js +1 -1
- package/cache/inmemory/policies.d.ts +3 -2
- package/cache/inmemory/policies.js +4 -4
- package/cache/inmemory/policies.js.map +1 -1
- package/cache/inmemory/readFromStore.js +2 -2
- package/cache/inmemory/writeToStore.d.ts +1 -1
- package/cache/inmemory/writeToStore.js +4 -4
- package/cache/inmemory/writeToStore.js.map +1 -1
- package/core/ApolloClient.d.ts +758 -182
- package/core/ApolloClient.js +94 -112
- package/core/ApolloClient.js.map +1 -1
- package/core/ObservableQuery.d.ts +131 -112
- package/core/ObservableQuery.js +10 -10
- package/core/ObservableQuery.js.map +1 -1
- package/core/QueryInfo.d.ts +8 -7
- package/core/QueryInfo.js.map +1 -1
- package/core/QueryManager.d.ts +20 -20
- package/core/QueryManager.js +15 -15
- package/core/QueryManager.js.map +1 -1
- package/core/deprecated.d.ts +29 -0
- package/core/deprecated.js +2 -0
- package/core/deprecated.js.map +1 -0
- package/core/index.d.ts +10 -6
- package/core/index.js.map +1 -1
- package/core/types.d.ts +69 -157
- package/core/types.js.map +1 -1
- package/core/watchQueryOptions.d.ts +9 -298
- package/core/watchQueryOptions.js.map +1 -1
- package/dev/setErrorMessageHandler.d.ts +4 -4
- package/dev/setErrorMessageHandler.js.map +1 -1
- package/errors/CombinedGraphQLErrors.d.ts +169 -15
- package/errors/CombinedGraphQLErrors.js +65 -12
- package/errors/CombinedGraphQLErrors.js.map +1 -1
- package/errors/CombinedProtocolErrors.d.ts +133 -3
- package/errors/CombinedProtocolErrors.js +55 -2
- package/errors/CombinedProtocolErrors.js.map +1 -1
- package/errors/LinkError.d.ts +45 -2
- package/errors/LinkError.js +45 -2
- package/errors/LinkError.js.map +1 -1
- package/errors/LocalStateError.d.ts +42 -6
- package/errors/LocalStateError.js +36 -6
- package/errors/LocalStateError.js.map +1 -1
- package/errors/ServerError.d.ts +72 -12
- package/errors/ServerError.js +52 -9
- package/errors/ServerError.js.map +1 -1
- package/errors/ServerParseError.d.ts +73 -17
- package/errors/ServerParseError.js +47 -9
- package/errors/ServerParseError.js.map +1 -1
- package/errors/UnconventionalError.d.ts +46 -2
- package/errors/UnconventionalError.js +46 -2
- package/errors/UnconventionalError.js.map +1 -1
- package/incremental/handlers/defer20220824.d.ts +4 -4
- package/incremental/handlers/defer20220824.js.map +1 -1
- package/incremental/handlers/notImplemented.d.ts +2 -2
- package/incremental/handlers/notImplemented.js +1 -1
- package/incremental/handlers/notImplemented.js.map +1 -1
- package/incremental/types.d.ts +4 -4
- package/incremental/types.js.map +1 -1
- package/invariantErrorCodes.js +81 -85
- package/link/batch/batchLink.d.ts +2 -3
- package/link/batch/batchLink.js +3 -9
- package/link/batch/batchLink.js.map +1 -1
- package/link/batch/batching.d.ts +7 -7
- package/link/batch/batching.js +2 -2
- package/link/batch/batching.js.map +1 -1
- package/link/batch-http/batchHttpLink.d.ts +1 -2
- package/link/batch-http/batchHttpLink.js +7 -4
- package/link/batch-http/batchHttpLink.js.map +1 -1
- package/link/client-awareness/ClientAwarenessLink.d.ts +4 -4
- package/link/client-awareness/ClientAwarenessLink.js.map +1 -1
- package/link/context/index.d.ts +4 -5
- package/link/context/index.js +1 -1
- package/link/context/index.js.map +1 -1
- package/link/core/ApolloLink.d.ts +355 -9
- package/link/core/ApolloLink.js +228 -57
- package/link/core/ApolloLink.js.map +1 -1
- package/link/core/concat.d.ts +4 -0
- package/link/core/concat.js +4 -0
- package/link/core/concat.js.map +1 -1
- package/link/core/deprecated.d.ts +10 -0
- package/link/core/deprecated.js +2 -0
- package/link/core/deprecated.js.map +1 -0
- package/link/core/empty.d.ts +4 -0
- package/link/core/empty.js +4 -0
- package/link/core/empty.js.map +1 -1
- package/link/core/from.d.ts +4 -0
- package/link/core/from.js +4 -0
- package/link/core/from.js.map +1 -1
- package/link/core/split.d.ts +4 -0
- package/link/core/split.js +4 -0
- package/link/core/split.js.map +1 -1
- package/link/core/types.d.ts +2 -33
- package/link/core/types.js.map +1 -1
- package/link/error/index.d.ts +20 -6
- package/link/error/index.js.map +1 -1
- package/link/http/BaseHttpLink.js +2 -2
- package/link/http/BaseHttpLink.js.map +1 -1
- package/link/http/HttpLink.d.ts +3 -3
- package/link/http/HttpLink.js +4 -1
- package/link/http/HttpLink.js.map +1 -1
- package/link/http/checkFetcher.js +1 -1
- package/link/http/parseAndCheckHttpResponse.d.ts +2 -2
- package/link/http/parseAndCheckHttpResponse.js +41 -26
- package/link/http/parseAndCheckHttpResponse.js.map +1 -1
- package/link/http/selectHttpOptionsAndBody.d.ts +3 -3
- package/link/http/selectHttpOptionsAndBody.js.map +1 -1
- package/link/http/selectURI.d.ts +2 -2
- package/link/http/selectURI.js.map +1 -1
- package/link/http/serializeFetchParameter.js +1 -1
- package/link/index.d.ts +2 -1
- package/link/index.js.map +1 -1
- package/link/persisted-queries/index.d.ts +11 -12
- package/link/persisted-queries/index.js +2 -2
- package/link/persisted-queries/index.js.map +1 -1
- package/link/retry/delayFunction.d.ts +3 -3
- package/link/retry/delayFunction.js.map +1 -1
- package/link/retry/retryFunction.d.ts +4 -4
- package/link/retry/retryFunction.js.map +1 -1
- package/link/retry/retryLink.d.ts +1 -2
- package/link/retry/retryLink.js +2 -2
- package/link/retry/retryLink.js.map +1 -1
- package/link/schema/index.d.ts +2 -3
- package/link/schema/index.js.map +1 -1
- package/link/subscriptions/index.d.ts +1 -2
- package/link/subscriptions/index.js.map +1 -1
- package/link/utils/createOperation.d.ts +2 -2
- package/link/utils/createOperation.js +12 -4
- package/link/utils/createOperation.js.map +1 -1
- package/link/utils/index.d.ts +0 -2
- package/link/utils/index.js +0 -2
- package/link/utils/index.js.map +1 -1
- package/link/ws/index.d.ts +1 -2
- package/link/ws/index.js.map +1 -1
- package/local-state/LocalState.d.ts +94 -0
- package/local-state/LocalState.js +55 -9
- package/local-state/LocalState.js.map +1 -1
- package/masking/GraphQLCodegenDataMasking.d.ts +6 -7
- package/masking/GraphQLCodegenDataMasking.js.map +1 -1
- package/masking/internal/types.d.ts +70 -70
- package/masking/internal/types.js.map +1 -1
- package/masking/maskDefinition.js +2 -2
- package/masking/maskFragment.js +2 -2
- package/masking/maskOperation.js +1 -1
- package/masking/types.js.map +1 -1
- package/masking/utils.js +3 -3
- package/package.json +1 -1
- package/react/context/ApolloContext.js +1 -1
- package/react/context/ApolloProvider.js +1 -1
- package/react/hooks/internal/useDeepMemo.js +0 -3
- package/react/hooks/internal/useDeepMemo.js.map +1 -1
- package/react/hooks/internal/validateSuspenseHookOptions.d.ts +2 -2
- package/react/hooks/internal/validateSuspenseHookOptions.js.map +1 -1
- package/react/hooks/internal/wrapHook.d.ts +8 -7
- package/react/hooks/internal/wrapHook.js +1 -0
- 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 +850 -90
- package/react/hooks/useBackgroundQuery.js.map +1 -1
- package/react/hooks/useFragment.d.ts +54 -3
- package/react/hooks/useFragment.js +7 -0
- package/react/hooks/useFragment.js.map +1 -1
- package/react/hooks/useLazyQuery.d.ts +317 -165
- package/react/hooks/useLazyQuery.js +0 -38
- package/react/hooks/useLazyQuery.js.map +1 -1
- package/react/hooks/useLoadableQuery.d.ts +153 -175
- package/react/hooks/useLoadableQuery.js.map +1 -1
- package/react/hooks/useMutation.d.ts +87 -65
- package/react/hooks/useMutation.js +6 -7
- package/react/hooks/useMutation.js.map +1 -1
- package/react/hooks/useQuery.d.ts +207 -103
- package/react/hooks/useQuery.js +1 -35
- package/react/hooks/useQuery.js.map +1 -1
- package/react/hooks/useQueryRefHandlers.d.ts +34 -5
- package/react/hooks/useQueryRefHandlers.js +2 -1
- package/react/hooks/useQueryRefHandlers.js.map +1 -1
- package/react/hooks/useReactiveVar.d.ts +2 -1
- package/react/hooks/useReactiveVar.js +2 -1
- package/react/hooks/useReactiveVar.js.map +1 -1
- package/react/hooks/useReadQuery.d.ts +93 -17
- package/react/hooks/useReadQuery.js +29 -0
- package/react/hooks/useReadQuery.js.map +1 -1
- package/react/hooks/useSubscription.d.ts +108 -33
- package/react/hooks/useSubscription.js +8 -9
- package/react/hooks/useSubscription.js.map +1 -1
- package/react/hooks/useSuspenseFragment.d.ts +62 -30
- package/react/hooks/useSuspenseFragment.js.map +1 -1
- package/react/hooks/useSuspenseQuery.d.ts +471 -69
- package/react/hooks/useSuspenseQuery.js +4 -1
- package/react/hooks/useSuspenseQuery.js.map +1 -1
- package/react/hooks-compiled/internal/useDeepMemo.js +0 -3
- package/react/hooks-compiled/internal/useDeepMemo.js.map +1 -1
- package/react/hooks-compiled/internal/validateSuspenseHookOptions.d.ts +2 -2
- package/react/hooks-compiled/internal/validateSuspenseHookOptions.js.map +1 -1
- package/react/hooks-compiled/internal/wrapHook.d.ts +8 -7
- package/react/hooks-compiled/internal/wrapHook.js +1 -0
- package/react/hooks-compiled/internal/wrapHook.js.map +1 -1
- package/react/hooks-compiled/useApolloClient.d.ts +2 -2
- package/react/hooks-compiled/useApolloClient.js +2 -2
- package/react/hooks-compiled/useApolloClient.js.map +1 -1
- package/react/hooks-compiled/useBackgroundQuery.d.ts +850 -90
- package/react/hooks-compiled/useBackgroundQuery.js.map +1 -1
- package/react/hooks-compiled/useFragment.d.ts +54 -3
- package/react/hooks-compiled/useFragment.js +7 -0
- package/react/hooks-compiled/useFragment.js.map +1 -1
- package/react/hooks-compiled/useLazyQuery.d.ts +317 -165
- package/react/hooks-compiled/useLazyQuery.js +0 -38
- package/react/hooks-compiled/useLazyQuery.js.map +1 -1
- package/react/hooks-compiled/useLoadableQuery.d.ts +153 -175
- package/react/hooks-compiled/useLoadableQuery.js.map +1 -1
- package/react/hooks-compiled/useMutation.d.ts +87 -65
- package/react/hooks-compiled/useMutation.js +6 -7
- package/react/hooks-compiled/useMutation.js.map +1 -1
- package/react/hooks-compiled/useQuery.d.ts +207 -103
- package/react/hooks-compiled/useQuery.js +1 -35
- package/react/hooks-compiled/useQuery.js.map +1 -1
- package/react/hooks-compiled/useQueryRefHandlers.d.ts +34 -5
- package/react/hooks-compiled/useQueryRefHandlers.js +2 -1
- package/react/hooks-compiled/useQueryRefHandlers.js.map +1 -1
- package/react/hooks-compiled/useReactiveVar.d.ts +2 -1
- package/react/hooks-compiled/useReactiveVar.js +2 -1
- package/react/hooks-compiled/useReactiveVar.js.map +1 -1
- package/react/hooks-compiled/useReadQuery.d.ts +93 -17
- package/react/hooks-compiled/useReadQuery.js +29 -0
- package/react/hooks-compiled/useReadQuery.js.map +1 -1
- package/react/hooks-compiled/useSubscription.d.ts +108 -33
- package/react/hooks-compiled/useSubscription.js +8 -9
- package/react/hooks-compiled/useSubscription.js.map +1 -1
- package/react/hooks-compiled/useSuspenseFragment.d.ts +62 -30
- package/react/hooks-compiled/useSuspenseFragment.js.map +1 -1
- package/react/hooks-compiled/useSuspenseQuery.d.ts +471 -69
- package/react/hooks-compiled/useSuspenseQuery.js.map +1 -1
- package/react/index.compiled.d.ts +0 -1
- package/react/index.compiled.js +0 -1
- package/react/index.compiled.js.map +1 -1
- package/react/index.d.ts +0 -1
- package/react/index.js +0 -1
- package/react/index.js.map +1 -1
- package/react/index.react-server.d.ts +0 -1
- package/react/index.react-server.js +0 -2
- package/react/index.react-server.js.map +1 -1
- package/react/internal/cache/FragmentReference.d.ts +2 -3
- package/react/internal/cache/FragmentReference.js.map +1 -1
- package/react/internal/cache/QueryReference.d.ts +14 -12
- package/react/internal/cache/QueryReference.js.map +1 -1
- package/react/internal/cache/SuspenseCache.d.ts +2 -2
- package/react/internal/cache/SuspenseCache.js.map +1 -1
- package/react/internal/cache/getSuspenseCache.d.ts +6 -4
- package/react/internal/cache/getSuspenseCache.js.map +1 -1
- package/react/internal/index.d.ts +1 -1
- package/react/internal/index.js +1 -0
- package/react/internal/index.js.map +1 -1
- package/react/internal/types.d.ts +3 -3
- package/react/internal/types.js.map +1 -1
- package/react/query-preloader/createQueryPreloader.d.ts +60 -51
- package/react/query-preloader/createQueryPreloader.js +1 -1
- package/react/query-preloader/createQueryPreloader.js.map +1 -1
- package/react/ssr/prerenderStatic.d.ts +11 -9
- package/react/ssr/prerenderStatic.js +5 -4
- package/react/ssr/prerenderStatic.js.map +1 -1
- package/react/ssr/useSSRQuery.js.map +1 -1
- package/react/types/deprecated.d.ts +1 -1
- package/react/types/deprecated.js.map +1 -1
- package/react/types/types.documentation.d.ts +15 -15
- package/react/types/types.documentation.js.map +1 -1
- package/testing/core/mocking/mockLink.d.ts +8 -8
- package/testing/core/mocking/mockLink.js.map +1 -1
- package/testing/core/mocking/mockSubscriptionLink.d.ts +3 -4
- package/testing/core/mocking/mockSubscriptionLink.js.map +1 -1
- package/testing/core/types/deprecated.d.ts +3 -2
- package/testing/core/types/deprecated.js.map +1 -1
- package/testing/react/MockedProvider.d.ts +2 -3
- package/testing/react/MockedProvider.js.map +1 -1
- package/utilities/HKT.d.ts +8 -7
- package/utilities/HKT.js.map +1 -1
- package/utilities/caching/sizes.d.ts +4 -6
- package/utilities/caching/sizes.js +3 -3
- package/utilities/caching/sizes.js.map +1 -1
- package/utilities/graphql/DocumentTransform.js +1 -1
- package/utilities/graphql/DocumentTransform.js.map +1 -1
- package/utilities/index.d.ts +1 -2
- package/utilities/index.js +1 -2
- package/utilities/index.js.map +1 -1
- package/utilities/{shared → internal}/canonicalStringify.d.ts +1 -1
- package/utilities/{shared → internal}/canonicalStringify.js +4 -6
- package/utilities/internal/canonicalStringify.js.map +1 -0
- package/utilities/internal/checkDocument.js +1 -1
- package/utilities/internal/checkDocument.js.map +1 -1
- package/utilities/internal/createFragmentMap.js.map +1 -1
- package/utilities/internal/equalByQuery.d.ts +5 -0
- package/{core → utilities/internal}/equalByQuery.js +7 -1
- package/utilities/internal/equalByQuery.js.map +1 -0
- package/utilities/internal/getFragmentQueryDocument.d.ts +13 -3
- package/utilities/internal/getFragmentQueryDocument.js +13 -3
- package/utilities/internal/getFragmentQueryDocument.js.map +1 -1
- package/utilities/internal/getMemoryInternals.js.map +1 -1
- package/utilities/internal/getStoreKeyName.js +1 -2
- package/utilities/internal/getStoreKeyName.js.map +1 -1
- 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/mergeOptions.d.ts +2 -2
- package/utilities/internal/mergeOptions.js.map +1 -1
- package/utilities/internal/toQueryResult.d.ts +2 -2
- package/utilities/internal/toQueryResult.js.map +1 -1
- package/utilities/internal/types/DocumentationTypes.d.ts +32 -26
- package/utilities/internal/types/DocumentationTypes.js.map +1 -1
- package/utilities/internal/types/NoInfer.d.ts +31 -25
- package/utilities/internal/types/NoInfer.js.map +1 -1
- package/utilities/internal/types/VariablesOption.d.ts +2 -6
- package/utilities/subscriptions/relay/index.js +2 -0
- package/utilities/subscriptions/relay/index.js.map +1 -1
- package/version.js +1 -1
- package/__cjs/cache/core/types/DataProxy.cjs.map +0 -1
- package/__cjs/cache/core/types/DataProxy.d.cts +0 -140
- package/__cjs/core/equalByQuery.cjs.map +0 -1
- package/__cjs/core/equalByQuery.d.cts +0 -4
- package/__cjs/link/utils/transformOperation.cjs +0 -22
- package/__cjs/link/utils/transformOperation.cjs.map +0 -1
- package/__cjs/link/utils/transformOperation.d.cts +0 -3
- package/__cjs/link/utils/validateOperation.cjs +0 -21
- package/__cjs/link/utils/validateOperation.cjs.map +0 -1
- package/__cjs/link/utils/validateOperation.d.cts +0 -3
- package/__cjs/react/context/ApolloConsumer.cjs +0 -16
- package/__cjs/react/context/ApolloConsumer.cjs.map +0 -1
- package/__cjs/react/context/ApolloConsumer.d.cts +0 -10
- package/__cjs/utilities/shared/canonicalStringify.cjs.map +0 -1
- package/cache/core/types/DataProxy.d.ts +0 -140
- package/cache/core/types/DataProxy.js +0 -2
- package/cache/core/types/DataProxy.js.map +0 -1
- package/core/equalByQuery.d.ts +0 -4
- package/core/equalByQuery.js.map +0 -1
- package/link/utils/transformOperation.d.ts +0 -3
- package/link/utils/transformOperation.js +0 -19
- package/link/utils/transformOperation.js.map +0 -1
- package/link/utils/validateOperation.d.ts +0 -3
- package/link/utils/validateOperation.js +0 -18
- package/link/utils/validateOperation.js.map +0 -1
- package/react/context/ApolloConsumer.d.ts +0 -10
- package/react/context/ApolloConsumer.js +0 -11
- package/react/context/ApolloConsumer.js.map +0 -1
- package/utilities/shared/canonicalStringify.js.map +0 -1
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import type { ApolloClient, DataState, DefaultContext, DocumentNode, ErrorLike, ErrorPolicy, GetDataState, MaybeMasked, OperationVariables, RefetchWritePolicy, TypedDocumentNode, WatchQueryFetchPolicy
|
|
1
|
+
import type { ApolloClient, DataState, DefaultContext, DocumentNode, ErrorLike, ErrorPolicy, GetDataState, MaybeMasked, OperationVariables, RefetchWritePolicy, TypedDocumentNode, WatchQueryFetchPolicy } from "@apollo/client";
|
|
2
2
|
import type { SubscribeToMoreFunction } from "@apollo/client";
|
|
3
3
|
import { NetworkStatus } from "@apollo/client";
|
|
4
4
|
import type { FetchMoreFunction, RefetchFunction } from "@apollo/client/react/internal";
|
|
@@ -11,19 +11,16 @@ export declare namespace useSuspenseQuery {
|
|
|
11
11
|
/**
|
|
12
12
|
* The instance of `ApolloClient` to use to execute the query.
|
|
13
13
|
*
|
|
14
|
-
* By default, the instance that's passed down via context is used, but you
|
|
14
|
+
* By default, the instance that's passed down via context is used, but you
|
|
15
|
+
* can provide a different instance here.
|
|
15
16
|
*
|
|
16
|
-
* @docGroup
|
|
17
|
-
*
|
|
18
|
-
* 1. Operation options
|
|
17
|
+
* @docGroup 1. Operation options
|
|
19
18
|
*/
|
|
20
19
|
client?: ApolloClient;
|
|
21
20
|
/**
|
|
22
21
|
* 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.
|
|
23
22
|
*
|
|
24
|
-
* @docGroup
|
|
25
|
-
*
|
|
26
|
-
* 2. Networking options
|
|
23
|
+
* @docGroup 2. Networking options
|
|
27
24
|
*/
|
|
28
25
|
context?: DefaultContext;
|
|
29
26
|
/**
|
|
@@ -33,9 +30,7 @@ export declare namespace useSuspenseQuery {
|
|
|
33
30
|
*
|
|
34
31
|
* The default value is `none`, meaning that the query result includes error details but not partial results.
|
|
35
32
|
*
|
|
36
|
-
* @docGroup
|
|
37
|
-
*
|
|
38
|
-
* 1. Operation options
|
|
33
|
+
* @docGroup 1. Operation options
|
|
39
34
|
*/
|
|
40
35
|
errorPolicy?: ErrorPolicy;
|
|
41
36
|
/**
|
|
@@ -43,9 +38,7 @@ export declare namespace useSuspenseQuery {
|
|
|
43
38
|
*
|
|
44
39
|
* The default value is `false`.
|
|
45
40
|
*
|
|
46
|
-
* @docGroup
|
|
47
|
-
*
|
|
48
|
-
* 3. Caching options
|
|
41
|
+
* @docGroup 3. Caching options
|
|
49
42
|
*/
|
|
50
43
|
returnPartialData?: boolean;
|
|
51
44
|
/**
|
|
@@ -53,9 +46,7 @@ export declare namespace useSuspenseQuery {
|
|
|
53
46
|
*
|
|
54
47
|
* The default value is "overwrite".
|
|
55
48
|
*
|
|
56
|
-
* @docGroup
|
|
57
|
-
*
|
|
58
|
-
* 3. Caching options
|
|
49
|
+
* @docGroup 3. Caching options
|
|
59
50
|
*/
|
|
60
51
|
refetchWritePolicy?: RefetchWritePolicy;
|
|
61
52
|
/**
|
|
@@ -65,40 +56,41 @@ export declare namespace useSuspenseQuery {
|
|
|
65
56
|
*
|
|
66
57
|
* The default value is `cache-first`.
|
|
67
58
|
*
|
|
68
|
-
* @docGroup
|
|
69
|
-
*
|
|
70
|
-
* 3. Caching options
|
|
59
|
+
* @docGroup 3. Caching options
|
|
71
60
|
*/
|
|
72
61
|
fetchPolicy?: FetchPolicy;
|
|
73
62
|
/**
|
|
74
|
-
* A unique identifier for the query. Each item in the array must be a stable
|
|
75
|
-
*
|
|
76
|
-
* This is useful when using the same query and variables combination in more than one component, otherwise the components may clobber each other. This can also be used to force the query to re-evaluate fresh.
|
|
63
|
+
* A unique identifier for the query. Each item in the array must be a stable
|
|
64
|
+
* identifier to prevent infinite fetches.
|
|
77
65
|
*
|
|
78
|
-
*
|
|
66
|
+
* This is useful when using the same query and variables combination in more
|
|
67
|
+
* than one component, otherwise the components may clobber each other. This
|
|
68
|
+
* can also be used to force the query to re-evaluate fresh.
|
|
79
69
|
*
|
|
80
|
-
* 1. Operation options
|
|
70
|
+
* @docGroup 1. Operation options
|
|
81
71
|
*/
|
|
82
72
|
queryKey?: string | number | any[];
|
|
83
73
|
/**
|
|
84
74
|
* If `true`, the query is not executed. The default value is `false`.
|
|
85
75
|
*
|
|
86
|
-
* @deprecated
|
|
76
|
+
* @deprecated We recommend using `skipToken` in place of the `skip` option as
|
|
77
|
+
* it is more type-safe.
|
|
87
78
|
*
|
|
88
|
-
*
|
|
89
|
-
*
|
|
90
|
-
* This option is deprecated and only supported to ease the migration from useQuery. It will be removed in a future release.
|
|
91
|
-
*
|
|
92
|
-
* @docGroup
|
|
93
|
-
*
|
|
94
|
-
* 1. Operation options
|
|
79
|
+
* This option is deprecated and only supported to ease the migration from `useQuery`. It will be removed in a future release.
|
|
80
|
+
* Please use [`skipToken`](https://www.apollographql.com/docs/react/api/react/hooks#skiptoken) instead of the `skip` option as it is more type-safe.
|
|
95
81
|
*
|
|
82
|
+
* @docGroup 1. Operation options
|
|
83
|
+
*
|
|
96
84
|
*
|
|
97
85
|
* @example Recommended usage of `skipToken`:
|
|
86
|
+
*
|
|
98
87
|
* ```ts
|
|
99
|
-
* import { skipToken, useSuspenseQuery } from
|
|
88
|
+
* import { skipToken, useSuspenseQuery } from "@apollo/client";
|
|
100
89
|
*
|
|
101
|
-
* const { data } = useSuspenseQuery(
|
|
90
|
+
* const { data } = useSuspenseQuery(
|
|
91
|
+
* query,
|
|
92
|
+
* id ? { variables: { id } } : skipToken
|
|
93
|
+
* );
|
|
102
94
|
* ```
|
|
103
95
|
*/
|
|
104
96
|
skip?: boolean;
|
|
@@ -106,17 +98,9 @@ export declare namespace useSuspenseQuery {
|
|
|
106
98
|
}
|
|
107
99
|
type Options<TVariables extends OperationVariables = OperationVariables> = Base.Options<TVariables> & VariablesOption<TVariables>;
|
|
108
100
|
namespace DocumentationTypes {
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
*
|
|
113
|
-
* Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
|
|
114
|
-
*
|
|
115
|
-
* @docGroup
|
|
116
|
-
*
|
|
117
|
-
* 1. Operation options
|
|
118
|
-
*/
|
|
119
|
-
variables?: TVariables;
|
|
101
|
+
namespace useSuspenseQuery {
|
|
102
|
+
interface Options<TVariables extends OperationVariables = OperationVariables> extends Base.Options<TVariables>, UtilityDocumentationTypes.VariableOptions<TVariables> {
|
|
103
|
+
}
|
|
120
104
|
}
|
|
121
105
|
}
|
|
122
106
|
namespace Base {
|
|
@@ -124,30 +108,30 @@ export declare namespace useSuspenseQuery {
|
|
|
124
108
|
/**
|
|
125
109
|
* The instance of `ApolloClient` to use to execute the query.
|
|
126
110
|
*
|
|
127
|
-
* By default, the instance that's passed down via context is used, but you
|
|
111
|
+
* By default, the instance that's passed down via context is used, but you
|
|
112
|
+
* can provide a different instance here.
|
|
128
113
|
*
|
|
129
|
-
* @docGroup
|
|
130
|
-
*
|
|
131
|
-
* 1. Operation options
|
|
114
|
+
* @docGroup 1. Operation options
|
|
132
115
|
*/
|
|
133
116
|
client: ApolloClient;
|
|
134
117
|
/**
|
|
135
|
-
* A single ErrorLike object describing the error that occured during the latest
|
|
118
|
+
* A single ErrorLike object describing the error that occured during the latest
|
|
119
|
+
* query execution.
|
|
136
120
|
*
|
|
137
121
|
* For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
|
|
138
122
|
*
|
|
139
|
-
* @docGroup
|
|
140
|
-
*
|
|
141
|
-
* 1. Operation data
|
|
123
|
+
* @docGroup 1. Operation data
|
|
142
124
|
*/
|
|
143
125
|
error: ErrorLike | undefined;
|
|
144
126
|
/**
|
|
145
127
|
* A function that helps you fetch the next set of results for a [paginated list field](https://www.apollographql.com/docs/react/pagination/core-api/).
|
|
128
|
+
*
|
|
146
129
|
*
|
|
147
|
-
*
|
|
148
|
-
*
|
|
149
|
-
*
|
|
150
|
-
*
|
|
130
|
+
* @docGroup 3. Helper functions
|
|
131
|
+
*
|
|
132
|
+
*
|
|
133
|
+
* @remarks
|
|
134
|
+
* Calling this function will cause the component to re-suspend, unless the call site is wrapped in [`startTransition`](https://react.dev/reference/react/startTransition).
|
|
151
135
|
*/
|
|
152
136
|
fetchMore: FetchMoreFunction<TData, TVariables>;
|
|
153
137
|
/**
|
|
@@ -155,9 +139,7 @@ export declare namespace useSuspenseQuery {
|
|
|
155
139
|
*
|
|
156
140
|
* Used in conjunction with the [`notifyOnNetworkStatusChange`](#notifyonnetworkstatuschange) option.
|
|
157
141
|
*
|
|
158
|
-
* @docGroup
|
|
159
|
-
*
|
|
160
|
-
* 2. Network info
|
|
142
|
+
* @docGroup 2. Network info
|
|
161
143
|
*/
|
|
162
144
|
networkStatus: NetworkStatus;
|
|
163
145
|
/**
|
|
@@ -167,62 +149,482 @@ export declare namespace useSuspenseQuery {
|
|
|
167
149
|
*
|
|
168
150
|
* See also [Refetching](https://www.apollographql.com/docs/react/data/queries/#refetching).
|
|
169
151
|
*
|
|
170
|
-
*
|
|
152
|
+
* Returns a `ResultPromise` with an additional `.retain()` method. Calling
|
|
153
|
+
* `.retain()` keeps the network operation running even if the `ObservableQuery`
|
|
154
|
+
* no longer requires the result.
|
|
171
155
|
*
|
|
172
|
-
* 3. Helper functions
|
|
156
|
+
* @docGroup 3. Helper functions
|
|
157
|
+
*
|
|
158
|
+
*
|
|
159
|
+
* @remarks
|
|
160
|
+
* Calling this function will cause the component to re-suspend, unless the call site is wrapped in [`startTransition`](https://react.dev/reference/react/startTransition).
|
|
173
161
|
*/
|
|
174
162
|
refetch: RefetchFunction<TData, TVariables>;
|
|
175
163
|
/**
|
|
176
164
|
* A function that enables you to execute a [subscription](https://www.apollographql.com/docs/react/data/subscriptions/), usually to subscribe to specific fields that were included in the query.
|
|
177
165
|
*
|
|
178
166
|
* This function returns _another_ function that you can call to terminate the subscription.
|
|
167
|
+
*
|
|
179
168
|
*
|
|
180
|
-
*
|
|
181
|
-
* @docGroup
|
|
182
|
-
*
|
|
183
|
-
* 3. Helper functions
|
|
169
|
+
* @docGroup 3. Helper functions
|
|
184
170
|
*/
|
|
185
171
|
subscribeToMore: SubscribeToMoreFunction<TData, TVariables>;
|
|
186
172
|
}
|
|
187
173
|
}
|
|
188
174
|
type Result<TData = unknown, TVariables extends OperationVariables = OperationVariables, TStates extends DataState<TData>["dataState"] = DataState<TData>["dataState"]> = Base.Result<TData, TVariables> & GetDataState<MaybeMasked<TData>, TStates>;
|
|
189
175
|
namespace DocumentationTypes {
|
|
190
|
-
|
|
176
|
+
namespace useSuspenseQuery {
|
|
177
|
+
interface Result<TData = unknown, TVariables extends OperationVariables = OperationVariables> extends Base.Result<TData, TVariables>, UtilityDocumentationTypes.DataState<TData> {
|
|
178
|
+
}
|
|
191
179
|
}
|
|
192
180
|
}
|
|
181
|
+
namespace DocumentationTypes {
|
|
182
|
+
/**
|
|
183
|
+
* Test
|
|
184
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
185
|
+
*
|
|
186
|
+
* @example
|
|
187
|
+
*
|
|
188
|
+
* ```jsx
|
|
189
|
+
* import { Suspense } from "react";
|
|
190
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
191
|
+
*
|
|
192
|
+
* const listQuery = gql`
|
|
193
|
+
* query {
|
|
194
|
+
* list {
|
|
195
|
+
* id
|
|
196
|
+
* }
|
|
197
|
+
* }
|
|
198
|
+
* `;
|
|
199
|
+
*
|
|
200
|
+
* function App() {
|
|
201
|
+
* return (
|
|
202
|
+
* <Suspense fallback={<Spinner />}>
|
|
203
|
+
* <List />
|
|
204
|
+
* </Suspense>
|
|
205
|
+
* );
|
|
206
|
+
* }
|
|
207
|
+
*
|
|
208
|
+
* function List() {
|
|
209
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
210
|
+
*
|
|
211
|
+
* return (
|
|
212
|
+
* <ol>
|
|
213
|
+
* {data.list.map((item) => (
|
|
214
|
+
* <Item key={item.id} id={item.id} />
|
|
215
|
+
* ))}
|
|
216
|
+
* </ol>
|
|
217
|
+
* );
|
|
218
|
+
* }
|
|
219
|
+
* ```
|
|
220
|
+
*
|
|
221
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
222
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
223
|
+
*/
|
|
224
|
+
function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options?: useSuspenseQuery.Options<TVariables>): useSuspenseQuery.Result<TData, TVariables>;
|
|
225
|
+
}
|
|
193
226
|
}
|
|
227
|
+
/**
|
|
228
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
229
|
+
*
|
|
230
|
+
* @example
|
|
231
|
+
*
|
|
232
|
+
* ```jsx
|
|
233
|
+
* import { Suspense } from "react";
|
|
234
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
235
|
+
*
|
|
236
|
+
* const listQuery = gql`
|
|
237
|
+
* query {
|
|
238
|
+
* list {
|
|
239
|
+
* id
|
|
240
|
+
* }
|
|
241
|
+
* }
|
|
242
|
+
* `;
|
|
243
|
+
*
|
|
244
|
+
* function App() {
|
|
245
|
+
* return (
|
|
246
|
+
* <Suspense fallback={<Spinner />}>
|
|
247
|
+
* <List />
|
|
248
|
+
* </Suspense>
|
|
249
|
+
* );
|
|
250
|
+
* }
|
|
251
|
+
*
|
|
252
|
+
* function List() {
|
|
253
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
254
|
+
*
|
|
255
|
+
* return (
|
|
256
|
+
* <ol>
|
|
257
|
+
* {data.list.map((item) => (
|
|
258
|
+
* <Item key={item.id} id={item.id} />
|
|
259
|
+
* ))}
|
|
260
|
+
* </ol>
|
|
261
|
+
* );
|
|
262
|
+
* }
|
|
263
|
+
* ```
|
|
264
|
+
*
|
|
265
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
266
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
267
|
+
*/
|
|
194
268
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useSuspenseQuery.Options<NoInfer<TVariables>> & {
|
|
195
269
|
returnPartialData: true;
|
|
196
270
|
errorPolicy: "ignore" | "all";
|
|
197
271
|
}): useSuspenseQuery.Result<TData, TVariables, "complete" | "streaming" | "partial" | "empty">;
|
|
272
|
+
/**
|
|
273
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
274
|
+
*
|
|
275
|
+
* @example
|
|
276
|
+
*
|
|
277
|
+
* ```jsx
|
|
278
|
+
* import { Suspense } from "react";
|
|
279
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
280
|
+
*
|
|
281
|
+
* const listQuery = gql`
|
|
282
|
+
* query {
|
|
283
|
+
* list {
|
|
284
|
+
* id
|
|
285
|
+
* }
|
|
286
|
+
* }
|
|
287
|
+
* `;
|
|
288
|
+
*
|
|
289
|
+
* function App() {
|
|
290
|
+
* return (
|
|
291
|
+
* <Suspense fallback={<Spinner />}>
|
|
292
|
+
* <List />
|
|
293
|
+
* </Suspense>
|
|
294
|
+
* );
|
|
295
|
+
* }
|
|
296
|
+
*
|
|
297
|
+
* function List() {
|
|
298
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
299
|
+
*
|
|
300
|
+
* return (
|
|
301
|
+
* <ol>
|
|
302
|
+
* {data.list.map((item) => (
|
|
303
|
+
* <Item key={item.id} id={item.id} />
|
|
304
|
+
* ))}
|
|
305
|
+
* </ol>
|
|
306
|
+
* );
|
|
307
|
+
* }
|
|
308
|
+
* ```
|
|
309
|
+
*
|
|
310
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
311
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
312
|
+
*/
|
|
198
313
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useSuspenseQuery.Options<NoInfer<TVariables>> & {
|
|
199
314
|
errorPolicy: "ignore" | "all";
|
|
200
315
|
}): useSuspenseQuery.Result<TData, TVariables, "complete" | "streaming" | "empty">;
|
|
316
|
+
/**
|
|
317
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
318
|
+
*
|
|
319
|
+
* @example
|
|
320
|
+
*
|
|
321
|
+
* ```jsx
|
|
322
|
+
* import { Suspense } from "react";
|
|
323
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
324
|
+
*
|
|
325
|
+
* const listQuery = gql`
|
|
326
|
+
* query {
|
|
327
|
+
* list {
|
|
328
|
+
* id
|
|
329
|
+
* }
|
|
330
|
+
* }
|
|
331
|
+
* `;
|
|
332
|
+
*
|
|
333
|
+
* function App() {
|
|
334
|
+
* return (
|
|
335
|
+
* <Suspense fallback={<Spinner />}>
|
|
336
|
+
* <List />
|
|
337
|
+
* </Suspense>
|
|
338
|
+
* );
|
|
339
|
+
* }
|
|
340
|
+
*
|
|
341
|
+
* function List() {
|
|
342
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
343
|
+
*
|
|
344
|
+
* return (
|
|
345
|
+
* <ol>
|
|
346
|
+
* {data.list.map((item) => (
|
|
347
|
+
* <Item key={item.id} id={item.id} />
|
|
348
|
+
* ))}
|
|
349
|
+
* </ol>
|
|
350
|
+
* );
|
|
351
|
+
* }
|
|
352
|
+
* ```
|
|
353
|
+
*
|
|
354
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
355
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
356
|
+
*/
|
|
201
357
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useSuspenseQuery.Options<NoInfer<TVariables>> & {
|
|
202
358
|
skip: boolean;
|
|
203
359
|
returnPartialData: true;
|
|
204
360
|
}): useSuspenseQuery.Result<TData, TVariables, "complete" | "empty" | "streaming" | "partial">;
|
|
361
|
+
/**
|
|
362
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
363
|
+
*
|
|
364
|
+
* @example
|
|
365
|
+
*
|
|
366
|
+
* ```jsx
|
|
367
|
+
* import { Suspense } from "react";
|
|
368
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
369
|
+
*
|
|
370
|
+
* const listQuery = gql`
|
|
371
|
+
* query {
|
|
372
|
+
* list {
|
|
373
|
+
* id
|
|
374
|
+
* }
|
|
375
|
+
* }
|
|
376
|
+
* `;
|
|
377
|
+
*
|
|
378
|
+
* function App() {
|
|
379
|
+
* return (
|
|
380
|
+
* <Suspense fallback={<Spinner />}>
|
|
381
|
+
* <List />
|
|
382
|
+
* </Suspense>
|
|
383
|
+
* );
|
|
384
|
+
* }
|
|
385
|
+
*
|
|
386
|
+
* function List() {
|
|
387
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
388
|
+
*
|
|
389
|
+
* return (
|
|
390
|
+
* <ol>
|
|
391
|
+
* {data.list.map((item) => (
|
|
392
|
+
* <Item key={item.id} id={item.id} />
|
|
393
|
+
* ))}
|
|
394
|
+
* </ol>
|
|
395
|
+
* );
|
|
396
|
+
* }
|
|
397
|
+
* ```
|
|
398
|
+
*
|
|
399
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
400
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
401
|
+
*/
|
|
205
402
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useSuspenseQuery.Options<NoInfer<TVariables>> & {
|
|
206
403
|
returnPartialData: true;
|
|
207
404
|
}): useSuspenseQuery.Result<TData, TVariables, "partial" | "streaming" | "complete">;
|
|
405
|
+
/**
|
|
406
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
407
|
+
*
|
|
408
|
+
* @example
|
|
409
|
+
*
|
|
410
|
+
* ```jsx
|
|
411
|
+
* import { Suspense } from "react";
|
|
412
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
413
|
+
*
|
|
414
|
+
* const listQuery = gql`
|
|
415
|
+
* query {
|
|
416
|
+
* list {
|
|
417
|
+
* id
|
|
418
|
+
* }
|
|
419
|
+
* }
|
|
420
|
+
* `;
|
|
421
|
+
*
|
|
422
|
+
* function App() {
|
|
423
|
+
* return (
|
|
424
|
+
* <Suspense fallback={<Spinner />}>
|
|
425
|
+
* <List />
|
|
426
|
+
* </Suspense>
|
|
427
|
+
* );
|
|
428
|
+
* }
|
|
429
|
+
*
|
|
430
|
+
* function List() {
|
|
431
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
432
|
+
*
|
|
433
|
+
* return (
|
|
434
|
+
* <ol>
|
|
435
|
+
* {data.list.map((item) => (
|
|
436
|
+
* <Item key={item.id} id={item.id} />
|
|
437
|
+
* ))}
|
|
438
|
+
* </ol>
|
|
439
|
+
* );
|
|
440
|
+
* }
|
|
441
|
+
* ```
|
|
442
|
+
*
|
|
443
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
444
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
445
|
+
*/
|
|
208
446
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: useSuspenseQuery.Options<NoInfer<TVariables>> & {
|
|
209
447
|
skip: boolean;
|
|
210
448
|
}): useSuspenseQuery.Result<TData, TVariables, "complete" | "streaming" | "empty">;
|
|
449
|
+
/**
|
|
450
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
451
|
+
*
|
|
452
|
+
* @example
|
|
453
|
+
*
|
|
454
|
+
* ```jsx
|
|
455
|
+
* import { Suspense } from "react";
|
|
456
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
457
|
+
*
|
|
458
|
+
* const listQuery = gql`
|
|
459
|
+
* query {
|
|
460
|
+
* list {
|
|
461
|
+
* id
|
|
462
|
+
* }
|
|
463
|
+
* }
|
|
464
|
+
* `;
|
|
465
|
+
*
|
|
466
|
+
* function App() {
|
|
467
|
+
* return (
|
|
468
|
+
* <Suspense fallback={<Spinner />}>
|
|
469
|
+
* <List />
|
|
470
|
+
* </Suspense>
|
|
471
|
+
* );
|
|
472
|
+
* }
|
|
473
|
+
*
|
|
474
|
+
* function List() {
|
|
475
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
476
|
+
*
|
|
477
|
+
* return (
|
|
478
|
+
* <ol>
|
|
479
|
+
* {data.list.map((item) => (
|
|
480
|
+
* <Item key={item.id} id={item.id} />
|
|
481
|
+
* ))}
|
|
482
|
+
* </ol>
|
|
483
|
+
* );
|
|
484
|
+
* }
|
|
485
|
+
* ```
|
|
486
|
+
*
|
|
487
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
488
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
489
|
+
*/
|
|
211
490
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | (useSuspenseQuery.Options<NoInfer<TVariables>> & {
|
|
212
491
|
returnPartialData: true;
|
|
213
492
|
})): useSuspenseQuery.Result<TData, TVariables, "empty" | "streaming" | "complete" | "partial">;
|
|
493
|
+
/**
|
|
494
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
495
|
+
*
|
|
496
|
+
* @example
|
|
497
|
+
*
|
|
498
|
+
* ```jsx
|
|
499
|
+
* import { Suspense } from "react";
|
|
500
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
501
|
+
*
|
|
502
|
+
* const listQuery = gql`
|
|
503
|
+
* query {
|
|
504
|
+
* list {
|
|
505
|
+
* id
|
|
506
|
+
* }
|
|
507
|
+
* }
|
|
508
|
+
* `;
|
|
509
|
+
*
|
|
510
|
+
* function App() {
|
|
511
|
+
* return (
|
|
512
|
+
* <Suspense fallback={<Spinner />}>
|
|
513
|
+
* <List />
|
|
514
|
+
* </Suspense>
|
|
515
|
+
* );
|
|
516
|
+
* }
|
|
517
|
+
*
|
|
518
|
+
* function List() {
|
|
519
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
520
|
+
*
|
|
521
|
+
* return (
|
|
522
|
+
* <ol>
|
|
523
|
+
* {data.list.map((item) => (
|
|
524
|
+
* <Item key={item.id} id={item.id} />
|
|
525
|
+
* ))}
|
|
526
|
+
* </ol>
|
|
527
|
+
* );
|
|
528
|
+
* }
|
|
529
|
+
* ```
|
|
530
|
+
*
|
|
531
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
532
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
533
|
+
*/
|
|
214
534
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
|
|
215
535
|
options?: useSuspenseQuery.Options<NoInfer<TVariables>>
|
|
216
536
|
] : [options: useSuspenseQuery.Options<NoInfer<TVariables>>]): useSuspenseQuery.Result<TData, TVariables, "complete" | "streaming">;
|
|
537
|
+
/**
|
|
538
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
539
|
+
*
|
|
540
|
+
* @example
|
|
541
|
+
*
|
|
542
|
+
* ```jsx
|
|
543
|
+
* import { Suspense } from "react";
|
|
544
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
545
|
+
*
|
|
546
|
+
* const listQuery = gql`
|
|
547
|
+
* query {
|
|
548
|
+
* list {
|
|
549
|
+
* id
|
|
550
|
+
* }
|
|
551
|
+
* }
|
|
552
|
+
* `;
|
|
553
|
+
*
|
|
554
|
+
* function App() {
|
|
555
|
+
* return (
|
|
556
|
+
* <Suspense fallback={<Spinner />}>
|
|
557
|
+
* <List />
|
|
558
|
+
* </Suspense>
|
|
559
|
+
* );
|
|
560
|
+
* }
|
|
561
|
+
*
|
|
562
|
+
* function List() {
|
|
563
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
564
|
+
*
|
|
565
|
+
* return (
|
|
566
|
+
* <ol>
|
|
567
|
+
* {data.list.map((item) => (
|
|
568
|
+
* <Item key={item.id} id={item.id} />
|
|
569
|
+
* ))}
|
|
570
|
+
* </ol>
|
|
571
|
+
* );
|
|
572
|
+
* }
|
|
573
|
+
* ```
|
|
574
|
+
*
|
|
575
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
576
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
577
|
+
*/
|
|
217
578
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, ...[options]: {} extends TVariables ? [
|
|
218
579
|
options?: SkipToken | useSuspenseQuery.Options<NoInfer<TVariables>>
|
|
219
580
|
] : [options: SkipToken | useSuspenseQuery.Options<NoInfer<TVariables>>]): useSuspenseQuery.Result<TData, TVariables, "complete" | "streaming" | "empty">;
|
|
581
|
+
/**
|
|
582
|
+
* For a detailed explanation of `useSuspenseQuery`, see the [fetching with Suspense reference](https://www.apollographql.com/docs/react/data/suspense).
|
|
583
|
+
*
|
|
584
|
+
* @example
|
|
585
|
+
*
|
|
586
|
+
* ```jsx
|
|
587
|
+
* import { Suspense } from "react";
|
|
588
|
+
* import { useSuspenseQuery } from "@apollo/client";
|
|
589
|
+
*
|
|
590
|
+
* const listQuery = gql`
|
|
591
|
+
* query {
|
|
592
|
+
* list {
|
|
593
|
+
* id
|
|
594
|
+
* }
|
|
595
|
+
* }
|
|
596
|
+
* `;
|
|
597
|
+
*
|
|
598
|
+
* function App() {
|
|
599
|
+
* return (
|
|
600
|
+
* <Suspense fallback={<Spinner />}>
|
|
601
|
+
* <List />
|
|
602
|
+
* </Suspense>
|
|
603
|
+
* );
|
|
604
|
+
* }
|
|
605
|
+
*
|
|
606
|
+
* function List() {
|
|
607
|
+
* const { data } = useSuspenseQuery(listQuery);
|
|
608
|
+
*
|
|
609
|
+
* return (
|
|
610
|
+
* <ol>
|
|
611
|
+
* {data.list.map((item) => (
|
|
612
|
+
* <Item key={item.id} id={item.id} />
|
|
613
|
+
* ))}
|
|
614
|
+
* </ol>
|
|
615
|
+
* );
|
|
616
|
+
* }
|
|
617
|
+
* ```
|
|
618
|
+
*
|
|
619
|
+
* @param query - A GraphQL query document parsed into an AST by `gql`.
|
|
620
|
+
* @param options - An optional object containing options for the query. Instead of passing a `useSuspenseQuery.Options` object into the hook, you can also pass a [`skipToken`](#skiptoken) to prevent the `useSuspenseQuery` hook from executing the query or suspending.
|
|
621
|
+
*/
|
|
220
622
|
export declare function useSuspenseQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(query: DocumentNode | TypedDocumentNode<TData, TVariables>, options: SkipToken | useSuspenseQuery.Options<NoInfer<TVariables>>): useSuspenseQuery.Result<TData, TVariables, "complete" | "streaming" | "empty">;
|
|
221
623
|
interface UseWatchQueryOptionsHookOptions<TData, TVariables extends OperationVariables> {
|
|
222
624
|
client: ApolloClient;
|
|
223
625
|
query: DocumentNode | TypedDocumentNode<TData, TVariables>;
|
|
224
626
|
options: SkipToken | useSuspenseQuery.Options<TVariables>;
|
|
225
627
|
}
|
|
226
|
-
export declare function useWatchQueryOptions<TData, TVariables extends OperationVariables>({ client, query, options, }: UseWatchQueryOptionsHookOptions<TData, TVariables>): WatchQueryOptions<
|
|
628
|
+
export declare function useWatchQueryOptions<TData, TVariables extends OperationVariables>({ client, query, options, }: UseWatchQueryOptionsHookOptions<TData, TVariables>): ApolloClient.WatchQueryOptions<TData, TVariables>;
|
|
227
629
|
export {};
|
|
228
630
|
//# sourceMappingURL=useSuspenseQuery.d.cts.map
|