@apollo/client 4.0.0-rc.1 → 4.0.0-rc.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.
Files changed (1153) hide show
  1. package/CHANGELOG.md +347 -0
  2. package/README.md +40 -40
  3. package/__cjs/cache/core/cache.cjs +16 -19
  4. package/__cjs/cache/core/cache.cjs.map +1 -1
  5. package/__cjs/cache/core/cache.d.cts +108 -73
  6. package/__cjs/cache/core/types/Cache.cjs +0 -4
  7. package/__cjs/cache/core/types/Cache.cjs.map +1 -1
  8. package/__cjs/cache/core/types/Cache.d.cts +200 -15
  9. package/__cjs/cache/{core/types/DataProxy.cjs → deprecated.cjs} +1 -1
  10. package/__cjs/cache/deprecated.cjs.map +1 -0
  11. package/__cjs/cache/deprecated.d.cts +6 -0
  12. package/__cjs/cache/index.cjs.map +1 -1
  13. package/__cjs/cache/index.d.cts +2 -2
  14. package/__cjs/cache/inmemory/entityStore.cjs +28 -31
  15. package/__cjs/cache/inmemory/entityStore.cjs.map +1 -1
  16. package/__cjs/cache/inmemory/entityStore.d.cts +18 -17
  17. package/__cjs/cache/inmemory/helpers.cjs.map +1 -1
  18. package/__cjs/cache/inmemory/inMemoryCache.cjs +1 -1
  19. package/__cjs/cache/inmemory/inMemoryCache.cjs.map +1 -1
  20. package/__cjs/cache/inmemory/inMemoryCache.d.cts +4 -4
  21. package/__cjs/cache/inmemory/key-extractor.cjs +1 -1
  22. package/__cjs/cache/inmemory/key-extractor.cjs.map +1 -1
  23. package/__cjs/cache/inmemory/policies.cjs +4 -4
  24. package/__cjs/cache/inmemory/policies.cjs.map +1 -1
  25. package/__cjs/cache/inmemory/policies.d.cts +3 -2
  26. package/__cjs/cache/inmemory/reactiveVars.cjs.map +1 -1
  27. package/__cjs/cache/inmemory/readFromStore.cjs +2 -2
  28. package/__cjs/cache/inmemory/readFromStore.cjs.map +1 -1
  29. package/__cjs/cache/inmemory/types.d.cts +1 -1
  30. package/__cjs/cache/inmemory/writeToStore.cjs +4 -4
  31. package/__cjs/cache/inmemory/writeToStore.cjs.map +1 -1
  32. package/__cjs/cache/inmemory/writeToStore.d.cts +1 -1
  33. package/__cjs/core/ApolloClient.cjs +158 -122
  34. package/__cjs/core/ApolloClient.cjs.map +1 -1
  35. package/__cjs/core/ApolloClient.d.cts +788 -184
  36. package/__cjs/core/ObservableQuery.cjs +50 -20
  37. package/__cjs/core/ObservableQuery.cjs.map +1 -1
  38. package/__cjs/core/ObservableQuery.d.cts +190 -107
  39. package/__cjs/core/QueryInfo.cjs +2 -6
  40. package/__cjs/core/QueryInfo.cjs.map +1 -1
  41. package/__cjs/core/QueryInfo.d.cts +9 -8
  42. package/__cjs/core/QueryManager.cjs +15 -15
  43. package/__cjs/core/QueryManager.cjs.map +1 -1
  44. package/__cjs/core/QueryManager.d.cts +20 -20
  45. package/__cjs/core/deprecated.cjs +3 -0
  46. package/__cjs/core/deprecated.cjs.map +1 -0
  47. package/__cjs/core/deprecated.d.cts +29 -0
  48. package/__cjs/core/index.cjs +1 -2
  49. package/__cjs/core/index.cjs.map +1 -1
  50. package/__cjs/core/index.d.cts +12 -9
  51. package/__cjs/core/networkStatus.cjs.map +1 -1
  52. package/__cjs/core/types.d.cts +186 -145
  53. package/__cjs/core/watchQueryOptions.d.cts +8 -297
  54. package/__cjs/dev/index.cjs.map +1 -1
  55. package/__cjs/dev/loadDevMessages.cjs.map +1 -1
  56. package/__cjs/dev/loadErrorMessageHandler.cjs.map +1 -1
  57. package/__cjs/dev/loadErrorMessages.cjs.map +1 -1
  58. package/__cjs/dev/setErrorMessageHandler.cjs.map +1 -1
  59. package/__cjs/dev/setErrorMessageHandler.d.cts +4 -4
  60. package/__cjs/dev/symbol.cjs.map +1 -1
  61. package/__cjs/errors/CombinedGraphQLErrors.cjs +64 -11
  62. package/__cjs/errors/CombinedGraphQLErrors.cjs.map +1 -1
  63. package/__cjs/errors/CombinedGraphQLErrors.d.cts +168 -14
  64. package/__cjs/errors/CombinedProtocolErrors.cjs +54 -1
  65. package/__cjs/errors/CombinedProtocolErrors.cjs.map +1 -1
  66. package/__cjs/errors/CombinedProtocolErrors.d.cts +132 -2
  67. package/__cjs/errors/LinkError.cjs +45 -2
  68. package/__cjs/errors/LinkError.cjs.map +1 -1
  69. package/__cjs/errors/LinkError.d.cts +45 -2
  70. package/__cjs/errors/LocalStateError.cjs +35 -5
  71. package/__cjs/errors/LocalStateError.cjs.map +1 -1
  72. package/__cjs/errors/LocalStateError.d.cts +41 -5
  73. package/__cjs/errors/ServerError.cjs +51 -8
  74. package/__cjs/errors/ServerError.cjs.map +1 -1
  75. package/__cjs/errors/ServerError.d.cts +71 -11
  76. package/__cjs/errors/ServerParseError.cjs +46 -8
  77. package/__cjs/errors/ServerParseError.cjs.map +1 -1
  78. package/__cjs/errors/ServerParseError.d.cts +72 -16
  79. package/__cjs/errors/UnconventionalError.cjs +46 -2
  80. package/__cjs/errors/UnconventionalError.cjs.map +1 -1
  81. package/__cjs/errors/UnconventionalError.d.cts +46 -2
  82. package/__cjs/errors/index.cjs.map +1 -1
  83. package/__cjs/errors/isErrorLike.cjs.map +1 -1
  84. package/__cjs/errors/utils.cjs.map +1 -1
  85. package/__cjs/incremental/handlers/defer20220824.cjs.map +1 -1
  86. package/__cjs/incremental/handlers/defer20220824.d.cts +4 -4
  87. package/__cjs/incremental/handlers/notImplemented.cjs +1 -1
  88. package/__cjs/incremental/handlers/notImplemented.cjs.map +1 -1
  89. package/__cjs/incremental/handlers/notImplemented.d.cts +2 -2
  90. package/__cjs/incremental/index.cjs.map +1 -1
  91. package/__cjs/incremental/types.d.cts +4 -4
  92. package/__cjs/invariantErrorCodes.cjs +84 -88
  93. package/__cjs/invariantErrorCodes.cjs.map +1 -1
  94. package/__cjs/link/batch/batchLink.cjs +33 -13
  95. package/__cjs/link/batch/batchLink.cjs.map +1 -1
  96. package/__cjs/link/batch/batchLink.d.cts +103 -28
  97. package/__cjs/link/batch/batching.cjs +1 -1
  98. package/__cjs/link/batch/batching.cjs.map +1 -1
  99. package/__cjs/link/batch/batching.d.cts +8 -8
  100. package/__cjs/link/batch/index.cjs +1 -2
  101. package/__cjs/link/batch/index.cjs.map +1 -1
  102. package/__cjs/link/batch/index.d.cts +1 -2
  103. package/__cjs/link/batch-http/BaseBatchHttpLink.cjs +156 -0
  104. package/__cjs/link/batch-http/BaseBatchHttpLink.cjs.map +1 -0
  105. package/__cjs/link/batch-http/BaseBatchHttpLink.d.cts +68 -0
  106. package/__cjs/link/batch-http/batchHttpLink.cjs +28 -130
  107. package/__cjs/link/batch-http/batchHttpLink.cjs.map +1 -1
  108. package/__cjs/link/batch-http/batchHttpLink.d.cts +40 -17
  109. package/__cjs/link/batch-http/index.cjs +2 -1
  110. package/__cjs/link/batch-http/index.cjs.map +1 -1
  111. package/__cjs/link/batch-http/index.d.cts +2 -1
  112. package/__cjs/link/client-awareness/ClientAwarenessLink.cjs +36 -3
  113. package/__cjs/link/client-awareness/ClientAwarenessLink.cjs.map +1 -1
  114. package/__cjs/link/client-awareness/ClientAwarenessLink.d.cts +59 -7
  115. package/__cjs/link/client-awareness/index.cjs.map +1 -1
  116. package/__cjs/link/context/index.cjs +37 -14
  117. package/__cjs/link/context/index.cjs.map +1 -1
  118. package/__cjs/link/context/index.d.cts +78 -5
  119. package/__cjs/link/core/ApolloLink.cjs +227 -55
  120. package/__cjs/link/core/ApolloLink.cjs.map +1 -1
  121. package/__cjs/link/core/ApolloLink.d.cts +355 -9
  122. package/__cjs/link/core/concat.cjs +4 -0
  123. package/__cjs/link/core/concat.cjs.map +1 -1
  124. package/__cjs/link/core/concat.d.cts +4 -0
  125. package/__cjs/link/core/deprecated.cjs +3 -0
  126. package/__cjs/link/core/deprecated.cjs.map +1 -0
  127. package/__cjs/link/core/deprecated.d.cts +10 -0
  128. package/__cjs/link/core/empty.cjs +4 -0
  129. package/__cjs/link/core/empty.cjs.map +1 -1
  130. package/__cjs/link/core/empty.d.cts +4 -0
  131. package/__cjs/link/core/execute.cjs.map +1 -1
  132. package/__cjs/link/core/from.cjs +4 -0
  133. package/__cjs/link/core/from.cjs.map +1 -1
  134. package/__cjs/link/core/from.d.cts +4 -0
  135. package/__cjs/link/core/split.cjs +4 -0
  136. package/__cjs/link/core/split.cjs.map +1 -1
  137. package/__cjs/link/core/split.d.cts +4 -0
  138. package/__cjs/link/core/types.d.cts +2 -33
  139. package/__cjs/link/error/index.cjs +44 -0
  140. package/__cjs/link/error/index.cjs.map +1 -1
  141. package/__cjs/link/error/index.d.cts +84 -10
  142. package/__cjs/link/http/BaseHttpLink.cjs +62 -12
  143. package/__cjs/link/http/BaseHttpLink.cjs.map +1 -1
  144. package/__cjs/link/http/BaseHttpLink.d.cts +256 -2
  145. package/__cjs/link/http/HttpLink.cjs +27 -2
  146. package/__cjs/link/http/HttpLink.cjs.map +1 -1
  147. package/__cjs/link/http/HttpLink.d.cts +45 -135
  148. package/__cjs/link/http/checkFetcher.cjs +1 -1
  149. package/__cjs/link/http/index.cjs +1 -3
  150. package/__cjs/link/http/index.cjs.map +1 -1
  151. package/__cjs/link/http/index.d.cts +0 -2
  152. package/__cjs/link/http/parseAndCheckHttpResponse.cjs +41 -26
  153. package/__cjs/link/http/parseAndCheckHttpResponse.cjs.map +1 -1
  154. package/__cjs/link/http/parseAndCheckHttpResponse.d.cts +2 -2
  155. package/__cjs/link/http/rewriteURIForGET.cjs +2 -3
  156. package/__cjs/link/http/rewriteURIForGET.cjs.map +1 -1
  157. package/__cjs/link/http/rewriteURIForGET.d.cts +2 -2
  158. package/__cjs/link/http/selectHttpOptionsAndBody.cjs.map +1 -1
  159. package/__cjs/link/http/selectHttpOptionsAndBody.d.cts +9 -9
  160. package/__cjs/link/http/selectURI.cjs.map +1 -1
  161. package/__cjs/link/http/selectURI.d.cts +2 -2
  162. package/__cjs/link/index.cjs.map +1 -1
  163. package/__cjs/link/index.d.cts +2 -1
  164. package/__cjs/link/persisted-queries/index.cjs +18 -2
  165. package/__cjs/link/persisted-queries/index.cjs.map +1 -1
  166. package/__cjs/link/persisted-queries/index.d.cts +207 -28
  167. package/__cjs/link/remove-typename/index.cjs.map +1 -1
  168. package/__cjs/link/remove-typename/index.d.cts +0 -1
  169. package/__cjs/link/remove-typename/removeTypenameFromVariables.cjs +48 -0
  170. package/__cjs/link/remove-typename/removeTypenameFromVariables.cjs.map +1 -1
  171. package/__cjs/link/remove-typename/removeTypenameFromVariables.d.cts +124 -8
  172. package/__cjs/link/retry/delayFunction.cjs.map +1 -1
  173. package/__cjs/link/retry/delayFunction.d.cts +2 -39
  174. package/__cjs/link/retry/index.cjs.map +1 -1
  175. package/__cjs/link/retry/retryFunction.cjs.map +1 -1
  176. package/__cjs/link/retry/retryFunction.d.cts +2 -29
  177. package/__cjs/link/retry/retryLink.cjs +37 -12
  178. package/__cjs/link/retry/retryLink.cjs.map +1 -1
  179. package/__cjs/link/retry/retryLink.d.cts +130 -6
  180. package/__cjs/link/schema/index.cjs +20 -0
  181. package/__cjs/link/schema/index.cjs.map +1 -1
  182. package/__cjs/link/schema/index.d.cts +130 -9
  183. package/__cjs/link/subscriptions/index.cjs +23 -0
  184. package/__cjs/link/subscriptions/index.cjs.map +1 -1
  185. package/__cjs/link/subscriptions/index.d.cts +24 -2
  186. package/__cjs/link/utils/createOperation.cjs +12 -4
  187. package/__cjs/link/utils/createOperation.cjs.map +1 -1
  188. package/__cjs/link/utils/createOperation.d.cts +2 -2
  189. package/__cjs/link/utils/filterOperationVariables.cjs.map +1 -1
  190. package/__cjs/link/utils/index.cjs +1 -5
  191. package/__cjs/link/utils/index.cjs.map +1 -1
  192. package/__cjs/link/utils/index.d.cts +0 -2
  193. package/__cjs/link/ws/index.cjs +35 -1
  194. package/__cjs/link/ws/index.cjs.map +1 -1
  195. package/__cjs/link/ws/index.d.cts +64 -7
  196. package/__cjs/local-state/LocalState.cjs +55 -9
  197. package/__cjs/local-state/LocalState.cjs.map +1 -1
  198. package/__cjs/local-state/LocalState.d.cts +94 -0
  199. package/__cjs/local-state/index.cjs.map +1 -1
  200. package/__cjs/masking/GraphQLCodegenDataMasking.d.cts +11 -44
  201. package/__cjs/masking/PreserveTypes.cjs +3 -0
  202. package/__cjs/masking/PreserveTypes.cjs.map +1 -0
  203. package/__cjs/masking/PreserveTypes.d.cts +26 -0
  204. package/__cjs/masking/index.cjs.map +1 -1
  205. package/__cjs/masking/index.d.cts +1 -1
  206. package/__cjs/masking/internal/types.d.cts +70 -71
  207. package/__cjs/masking/maskDefinition.cjs +2 -2
  208. package/__cjs/masking/maskDefinition.cjs.map +1 -1
  209. package/__cjs/masking/maskFragment.cjs +2 -2
  210. package/__cjs/masking/maskFragment.cjs.map +1 -1
  211. package/__cjs/masking/maskOperation.cjs +1 -1
  212. package/__cjs/masking/maskOperation.cjs.map +1 -1
  213. package/__cjs/masking/types.d.cts +5 -23
  214. package/__cjs/masking/utils.cjs +3 -3
  215. package/__cjs/masking/utils.cjs.map +1 -1
  216. package/__cjs/react/context/ApolloContext.cjs +1 -1
  217. package/__cjs/react/context/ApolloContext.cjs.map +1 -1
  218. package/__cjs/react/context/ApolloProvider.cjs +1 -1
  219. package/__cjs/react/hooks/constants.cjs.map +1 -1
  220. package/__cjs/react/hooks/internal/__use.cjs.map +1 -1
  221. package/__cjs/react/hooks/internal/index.cjs.map +1 -1
  222. package/__cjs/react/hooks/internal/useDeepMemo.cjs +0 -3
  223. package/__cjs/react/hooks/internal/useDeepMemo.cjs.map +1 -1
  224. package/__cjs/react/hooks/internal/useIsomorphicLayoutEffect.cjs.map +1 -1
  225. package/__cjs/react/hooks/internal/useRenderGuard.cjs.map +1 -1
  226. package/__cjs/react/hooks/internal/validateSuspenseHookOptions.cjs.map +1 -1
  227. package/__cjs/react/hooks/internal/validateSuspenseHookOptions.d.cts +2 -2
  228. package/__cjs/react/hooks/internal/wrapHook.cjs +1 -0
  229. package/__cjs/react/hooks/internal/wrapHook.cjs.map +1 -1
  230. package/__cjs/react/hooks/internal/wrapHook.d.cts +8 -7
  231. package/__cjs/react/hooks/useApolloClient.cjs +2 -2
  232. package/__cjs/react/hooks/useApolloClient.cjs.map +1 -1
  233. package/__cjs/react/hooks/useApolloClient.d.cts +2 -2
  234. package/__cjs/react/hooks/useBackgroundQuery.cjs.map +1 -1
  235. package/__cjs/react/hooks/useBackgroundQuery.d.cts +850 -86
  236. package/__cjs/react/hooks/useFragment.cjs +11 -5
  237. package/__cjs/react/hooks/useFragment.cjs.map +1 -1
  238. package/__cjs/react/hooks/useFragment.d.cts +56 -8
  239. package/__cjs/react/hooks/useLazyQuery.cjs +0 -38
  240. package/__cjs/react/hooks/useLazyQuery.cjs.map +1 -1
  241. package/__cjs/react/hooks/useLazyQuery.d.cts +317 -161
  242. package/__cjs/react/hooks/useLoadableQuery.cjs.map +1 -1
  243. package/__cjs/react/hooks/useLoadableQuery.d.cts +246 -69
  244. package/__cjs/react/hooks/useMutation.cjs +6 -7
  245. package/__cjs/react/hooks/useMutation.cjs.map +1 -1
  246. package/__cjs/react/hooks/useMutation.d.cts +87 -65
  247. package/__cjs/react/hooks/useQuery.cjs +1 -35
  248. package/__cjs/react/hooks/useQuery.cjs.map +1 -1
  249. package/__cjs/react/hooks/useQuery.d.cts +367 -239
  250. package/__cjs/react/hooks/useQueryRefHandlers.cjs +2 -1
  251. package/__cjs/react/hooks/useQueryRefHandlers.cjs.map +1 -1
  252. package/__cjs/react/hooks/useQueryRefHandlers.d.cts +36 -3
  253. package/__cjs/react/hooks/useReactiveVar.cjs +2 -1
  254. package/__cjs/react/hooks/useReactiveVar.cjs.map +1 -1
  255. package/__cjs/react/hooks/useReactiveVar.d.cts +2 -1
  256. package/__cjs/react/hooks/useReadQuery.cjs +29 -0
  257. package/__cjs/react/hooks/useReadQuery.cjs.map +1 -1
  258. package/__cjs/react/hooks/useReadQuery.d.cts +92 -16
  259. package/__cjs/react/hooks/useSubscription.cjs +8 -9
  260. package/__cjs/react/hooks/useSubscription.cjs.map +1 -1
  261. package/__cjs/react/hooks/useSubscription.d.cts +160 -68
  262. package/__cjs/react/hooks/useSuspenseFragment.cjs.map +1 -1
  263. package/__cjs/react/hooks/useSuspenseFragment.d.cts +62 -30
  264. package/__cjs/react/hooks/useSuspenseQuery.cjs +4 -1
  265. package/__cjs/react/hooks/useSuspenseQuery.cjs.map +1 -1
  266. package/__cjs/react/hooks/useSuspenseQuery.d.cts +585 -159
  267. package/__cjs/react/hooks/useSyncExternalStore.cjs +2 -6
  268. package/__cjs/react/hooks/useSyncExternalStore.cjs.map +1 -1
  269. package/__cjs/react/index.cjs +2 -5
  270. package/__cjs/react/index.cjs.map +1 -1
  271. package/__cjs/react/index.d.cts +1 -2
  272. package/__cjs/react/index.react-server.cjs +1 -3
  273. package/__cjs/react/index.react-server.cjs.map +1 -1
  274. package/__cjs/react/index.react-server.d.cts +0 -1
  275. package/__cjs/react/internal/cache/FragmentReference.cjs +1 -1
  276. package/__cjs/react/internal/cache/FragmentReference.cjs.map +1 -1
  277. package/__cjs/react/internal/cache/FragmentReference.d.cts +2 -3
  278. package/__cjs/react/internal/cache/QueryReference.cjs.map +1 -1
  279. package/__cjs/react/internal/cache/QueryReference.d.cts +14 -12
  280. package/__cjs/react/internal/cache/SuspenseCache.cjs.map +1 -1
  281. package/__cjs/react/internal/cache/SuspenseCache.d.cts +2 -2
  282. package/__cjs/react/internal/cache/getSuspenseCache.cjs.map +1 -1
  283. package/__cjs/react/internal/cache/getSuspenseCache.d.cts +6 -4
  284. package/__cjs/react/internal/compiler-runtime/index.cjs +32 -0
  285. package/__cjs/react/internal/compiler-runtime/index.cjs.map +1 -0
  286. package/__cjs/react/internal/compiler-runtime/index.d.cts +8 -0
  287. package/__cjs/react/internal/index.cjs +1 -0
  288. package/__cjs/react/internal/index.cjs.map +1 -1
  289. package/__cjs/react/internal/index.d.cts +1 -1
  290. package/__cjs/react/internal/types.d.cts +3 -3
  291. package/__cjs/react/query-preloader/createQueryPreloader.cjs +1 -1
  292. package/__cjs/react/query-preloader/createQueryPreloader.cjs.map +1 -1
  293. package/__cjs/react/query-preloader/createQueryPreloader.d.cts +60 -51
  294. package/__cjs/react/ssr/getDataFromTree.cjs.map +1 -1
  295. package/__cjs/react/ssr/index.cjs.map +1 -1
  296. package/__cjs/react/ssr/prerenderStatic.cjs +5 -4
  297. package/__cjs/react/ssr/prerenderStatic.cjs.map +1 -1
  298. package/__cjs/react/ssr/prerenderStatic.d.cts +11 -9
  299. package/__cjs/react/ssr/renderToStringWithData.cjs.map +1 -1
  300. package/__cjs/react/ssr/useSSRQuery.cjs.map +1 -1
  301. package/__cjs/react/types/deprecated.d.cts +1 -1
  302. package/__cjs/react/types/types.documentation.d.cts +27 -16
  303. package/__cjs/testing/core/mocking/mockLink.cjs.map +1 -1
  304. package/__cjs/testing/core/mocking/mockLink.d.cts +8 -8
  305. package/__cjs/testing/core/mocking/mockSubscriptionLink.cjs.map +1 -1
  306. package/__cjs/testing/core/mocking/mockSubscriptionLink.d.cts +3 -4
  307. package/__cjs/testing/core/types/deprecated.d.cts +3 -2
  308. package/__cjs/testing/index.cjs.map +1 -1
  309. package/__cjs/testing/react/MockedProvider.cjs.map +1 -1
  310. package/__cjs/testing/react/MockedProvider.d.cts +2 -3
  311. package/__cjs/testing/react/index.cjs.map +1 -1
  312. package/__cjs/utilities/HKT.d.cts +8 -7
  313. package/__cjs/utilities/caching/index.cjs.map +1 -1
  314. package/__cjs/utilities/caching/sizes.cjs +3 -3
  315. package/__cjs/utilities/caching/sizes.cjs.map +1 -1
  316. package/__cjs/utilities/caching/sizes.d.cts +4 -6
  317. package/__cjs/utilities/common/stripTypename.cjs +11 -0
  318. package/__cjs/utilities/common/stripTypename.cjs.map +1 -1
  319. package/__cjs/utilities/common/stripTypename.d.cts +11 -0
  320. package/__cjs/utilities/environment/index.cjs.map +1 -1
  321. package/__cjs/utilities/environment/index.development.cjs.map +1 -1
  322. package/__cjs/utilities/environment/index.production.cjs.map +1 -1
  323. package/__cjs/utilities/graphql/DocumentTransform.cjs +86 -3
  324. package/__cjs/utilities/graphql/DocumentTransform.cjs.map +1 -1
  325. package/__cjs/utilities/graphql/DocumentTransform.d.cts +94 -5
  326. package/__cjs/utilities/graphql/isFormattedExecutionResult.cjs +27 -0
  327. package/__cjs/utilities/graphql/isFormattedExecutionResult.cjs.map +1 -1
  328. package/__cjs/utilities/graphql/isFormattedExecutionResult.d.cts +27 -0
  329. package/__cjs/utilities/graphql/operations.cjs +54 -3
  330. package/__cjs/utilities/graphql/operations.cjs.map +1 -1
  331. package/__cjs/utilities/graphql/operations.d.cts +54 -3
  332. package/__cjs/utilities/graphql/print.cjs.map +1 -1
  333. package/__cjs/utilities/graphql/storeUtils.cjs +9 -0
  334. package/__cjs/utilities/graphql/storeUtils.cjs.map +1 -1
  335. package/__cjs/utilities/graphql/storeUtils.d.cts +9 -0
  336. package/__cjs/utilities/graphql/transform.cjs +12 -1
  337. package/__cjs/utilities/graphql/transform.cjs.map +1 -1
  338. package/__cjs/utilities/graphql/transform.d.cts +12 -1
  339. package/__cjs/utilities/index.cjs +2 -3
  340. package/__cjs/utilities/index.cjs.map +1 -1
  341. package/__cjs/utilities/index.d.cts +1 -2
  342. package/__cjs/utilities/internal/argumentsObjectFromField.cjs.map +1 -1
  343. package/__cjs/utilities/internal/caches.cjs.map +1 -1
  344. package/__cjs/utilities/internal/canUseDOM.cjs.map +1 -1
  345. package/__cjs/utilities/{shared → internal}/canonicalStringify.cjs +35 -14
  346. package/__cjs/utilities/internal/canonicalStringify.cjs.map +1 -0
  347. package/__cjs/utilities/internal/canonicalStringify.d.cts +44 -0
  348. package/__cjs/utilities/internal/checkDocument.cjs +2 -2
  349. package/__cjs/utilities/internal/checkDocument.cjs.map +1 -1
  350. package/__cjs/utilities/internal/cloneDeep.cjs.map +1 -1
  351. package/__cjs/utilities/internal/compact.cjs.map +1 -1
  352. package/__cjs/utilities/internal/createFragmentMap.cjs.map +1 -1
  353. package/__cjs/utilities/internal/createFulfilledPromise.cjs.map +1 -1
  354. package/__cjs/utilities/internal/createRejectedPromise.cjs.map +1 -1
  355. package/__cjs/utilities/internal/dealias.cjs.map +1 -1
  356. package/__cjs/utilities/internal/decoratePromise.cjs.map +1 -1
  357. package/__cjs/utilities/internal/deepFreeze.cjs.map +1 -1
  358. package/__cjs/{core → utilities/internal}/equalByQuery.cjs +13 -7
  359. package/__cjs/utilities/internal/equalByQuery.cjs.map +1 -0
  360. package/__cjs/utilities/internal/equalByQuery.d.cts +5 -0
  361. package/__cjs/utilities/internal/filterMap.cjs.map +1 -1
  362. package/__cjs/utilities/internal/getDefaultValues.cjs.map +1 -1
  363. package/__cjs/utilities/internal/getFragmentDefinition.cjs.map +1 -1
  364. package/__cjs/utilities/internal/getFragmentDefinitions.cjs.map +1 -1
  365. package/__cjs/utilities/internal/getFragmentFromSelection.cjs.map +1 -1
  366. package/__cjs/utilities/internal/getFragmentQueryDocument.cjs +13 -3
  367. package/__cjs/utilities/internal/getFragmentQueryDocument.cjs.map +1 -1
  368. package/__cjs/utilities/internal/getFragmentQueryDocument.d.cts +13 -3
  369. package/__cjs/utilities/internal/getGraphQLErrorsFromResult.cjs.map +1 -1
  370. package/__cjs/utilities/internal/getMainDefinition.cjs +36 -8
  371. package/__cjs/utilities/internal/getMainDefinition.cjs.map +1 -1
  372. package/__cjs/utilities/internal/getMainDefinition.d.cts +36 -8
  373. package/__cjs/utilities/internal/getMemoryInternals.cjs.map +1 -1
  374. package/__cjs/utilities/internal/getOperationDefinition.cjs.map +1 -1
  375. package/__cjs/utilities/internal/getOperationName.cjs.map +1 -1
  376. package/__cjs/utilities/internal/getQueryDefinition.cjs.map +1 -1
  377. package/__cjs/utilities/internal/getStoreKeyName.cjs +9 -7
  378. package/__cjs/utilities/internal/getStoreKeyName.cjs.map +1 -1
  379. package/__cjs/utilities/internal/globals/global.cjs.map +1 -1
  380. package/__cjs/utilities/internal/globals/index.cjs.map +1 -1
  381. package/__cjs/utilities/internal/globals/maybe.cjs.map +1 -1
  382. package/__cjs/utilities/internal/graphQLResultHasError.cjs.map +1 -1
  383. package/__cjs/utilities/internal/hasDirectives.cjs.map +1 -1
  384. package/__cjs/utilities/internal/hasForcedResolvers.cjs.map +1 -1
  385. package/__cjs/utilities/internal/index.cjs +8 -2
  386. package/__cjs/utilities/internal/index.cjs.map +1 -1
  387. package/__cjs/utilities/internal/index.d.cts +4 -0
  388. package/__cjs/utilities/internal/index.production.cjs.map +1 -1
  389. package/__cjs/utilities/internal/isArray.cjs.map +1 -1
  390. package/__cjs/utilities/internal/isDocumentNode.cjs.map +1 -1
  391. package/__cjs/utilities/internal/isField.cjs.map +1 -1
  392. package/__cjs/utilities/internal/isNonEmptyArray.cjs.map +1 -1
  393. package/__cjs/utilities/internal/isNonNullObject.cjs.map +1 -1
  394. package/__cjs/utilities/internal/isPlainObject.cjs.map +1 -1
  395. package/__cjs/utilities/internal/makeReference.cjs.map +1 -1
  396. package/__cjs/utilities/internal/makeUniqueId.cjs.map +1 -1
  397. package/__cjs/utilities/internal/maybeDeepFreeze.cjs.map +1 -1
  398. package/__cjs/utilities/internal/mergeDeep.cjs.map +1 -1
  399. package/__cjs/utilities/internal/mergeDeepArray.cjs.map +1 -1
  400. package/__cjs/utilities/internal/mergeOptions.cjs.map +1 -1
  401. package/__cjs/utilities/internal/mergeOptions.d.cts +2 -2
  402. package/__cjs/utilities/internal/omitDeep.cjs.map +1 -1
  403. package/__cjs/utilities/internal/preventUnhandledRejection.cjs.map +1 -1
  404. package/__cjs/utilities/internal/removeDirectivesFromDocument.cjs +2 -6
  405. package/__cjs/utilities/internal/removeDirectivesFromDocument.cjs.map +1 -1
  406. package/__cjs/utilities/internal/removeFragmentSpreads.cjs +14 -0
  407. package/__cjs/utilities/internal/removeFragmentSpreads.cjs.map +1 -0
  408. package/__cjs/utilities/internal/removeFragmentSpreads.d.cts +3 -0
  409. package/__cjs/utilities/internal/resultKeyNameFromField.cjs.map +1 -1
  410. package/__cjs/utilities/internal/shouldInclude.cjs.map +1 -1
  411. package/__cjs/utilities/internal/storeKeyNameFromField.cjs.map +1 -1
  412. package/__cjs/utilities/internal/stringifyForDisplay.cjs.map +1 -1
  413. package/__cjs/utilities/internal/toQueryResult.cjs.map +1 -1
  414. package/__cjs/utilities/internal/toQueryResult.d.cts +2 -2
  415. package/__cjs/utilities/internal/types/DocumentationTypes.cjs +3 -0
  416. package/__cjs/utilities/internal/types/DocumentationTypes.cjs.map +1 -0
  417. package/__cjs/utilities/internal/types/DocumentationTypes.d.cts +88 -0
  418. package/__cjs/utilities/internal/types/NoInfer.d.cts +31 -25
  419. package/__cjs/utilities/internal/types/VariablesOption.d.cts +2 -6
  420. package/__cjs/utilities/internal/valueToObjectRepresentation.cjs.map +1 -1
  421. package/__cjs/utilities/invariant/index.cjs.map +1 -1
  422. package/__cjs/utilities/invariant/index.development.cjs.map +1 -1
  423. package/__cjs/utilities/policies/pagination.cjs.map +1 -1
  424. package/__cjs/utilities/subscriptions/relay/index.cjs +3 -2
  425. package/__cjs/utilities/subscriptions/relay/index.cjs.map +1 -1
  426. package/__cjs/version.cjs +1 -1
  427. package/__cjs/version.cjs.map +1 -1
  428. package/cache/core/cache.d.ts +108 -73
  429. package/cache/core/cache.js +17 -20
  430. package/cache/core/cache.js.map +1 -1
  431. package/cache/core/types/Cache.d.ts +201 -16
  432. package/cache/core/types/Cache.js +2 -4
  433. package/cache/core/types/Cache.js.map +1 -1
  434. package/cache/core/types/common.d.ts +1 -1
  435. package/cache/core/types/common.js +1 -1
  436. package/cache/core/types/common.js.map +1 -1
  437. package/cache/deprecated.d.ts +6 -0
  438. package/cache/deprecated.js +2 -0
  439. package/cache/deprecated.js.map +1 -0
  440. package/cache/index.d.ts +3 -3
  441. package/cache/index.js +1 -1
  442. package/cache/index.js.map +1 -1
  443. package/cache/inmemory/entityStore.d.ts +19 -18
  444. package/cache/inmemory/entityStore.js +28 -31
  445. package/cache/inmemory/entityStore.js.map +1 -1
  446. package/cache/inmemory/fragmentRegistry.d.ts +1 -1
  447. package/cache/inmemory/fragmentRegistry.js +1 -1
  448. package/cache/inmemory/fragmentRegistry.js.map +1 -1
  449. package/cache/inmemory/helpers.d.ts +1 -1
  450. package/cache/inmemory/helpers.js +1 -1
  451. package/cache/inmemory/helpers.js.map +1 -1
  452. package/cache/inmemory/inMemoryCache.d.ts +4 -4
  453. package/cache/inmemory/inMemoryCache.js +1 -1
  454. package/cache/inmemory/inMemoryCache.js.map +1 -1
  455. package/cache/inmemory/key-extractor.d.ts +1 -1
  456. package/cache/inmemory/key-extractor.js +1 -1
  457. package/cache/inmemory/key-extractor.js.map +1 -1
  458. package/cache/inmemory/policies.d.ts +4 -3
  459. package/cache/inmemory/policies.js +4 -4
  460. package/cache/inmemory/policies.js.map +1 -1
  461. package/cache/inmemory/reactiveVars.d.ts +1 -1
  462. package/cache/inmemory/reactiveVars.js +1 -1
  463. package/cache/inmemory/reactiveVars.js.map +1 -1
  464. package/cache/inmemory/readFromStore.d.ts +1 -1
  465. package/cache/inmemory/readFromStore.js +2 -2
  466. package/cache/inmemory/readFromStore.js.map +1 -1
  467. package/cache/inmemory/types.d.ts +2 -2
  468. package/cache/inmemory/types.js +1 -1
  469. package/cache/inmemory/types.js.map +1 -1
  470. package/cache/inmemory/writeToStore.d.ts +2 -2
  471. package/cache/inmemory/writeToStore.js +4 -4
  472. package/cache/inmemory/writeToStore.js.map +1 -1
  473. package/core/ApolloClient.d.ts +788 -184
  474. package/core/ApolloClient.js +159 -123
  475. package/core/ApolloClient.js.map +1 -1
  476. package/core/ObservableQuery.d.ts +190 -107
  477. package/core/ObservableQuery.js +50 -20
  478. package/core/ObservableQuery.js.map +1 -1
  479. package/core/QueryInfo.d.ts +9 -8
  480. package/core/QueryInfo.js +1 -2
  481. package/core/QueryInfo.js.map +1 -1
  482. package/core/QueryManager.d.ts +21 -21
  483. package/core/QueryManager.js +15 -15
  484. package/core/QueryManager.js.map +1 -1
  485. package/core/deprecated.d.ts +29 -0
  486. package/core/deprecated.js +2 -0
  487. package/core/deprecated.js.map +1 -0
  488. package/core/index.d.ts +13 -10
  489. package/core/index.js +2 -2
  490. package/core/index.js.map +1 -1
  491. package/core/networkStatus.d.ts +1 -1
  492. package/core/networkStatus.js +1 -1
  493. package/core/networkStatus.js.map +1 -1
  494. package/core/types.d.ts +186 -145
  495. package/core/types.js +1 -1
  496. package/core/types.js.map +1 -1
  497. package/core/watchQueryOptions.d.ts +9 -298
  498. package/core/watchQueryOptions.js +1 -1
  499. package/core/watchQueryOptions.js.map +1 -1
  500. package/dev/index.d.ts +1 -1
  501. package/dev/index.js +1 -1
  502. package/dev/index.js.map +1 -1
  503. package/dev/loadDevMessages.d.ts +1 -1
  504. package/dev/loadDevMessages.js +1 -1
  505. package/dev/loadDevMessages.js.map +1 -1
  506. package/dev/loadErrorMessageHandler.d.ts +1 -1
  507. package/dev/loadErrorMessageHandler.js +1 -1
  508. package/dev/loadErrorMessageHandler.js.map +1 -1
  509. package/dev/loadErrorMessages.d.ts +1 -1
  510. package/dev/loadErrorMessages.js +1 -1
  511. package/dev/loadErrorMessages.js.map +1 -1
  512. package/dev/setErrorMessageHandler.d.ts +5 -5
  513. package/dev/setErrorMessageHandler.js +1 -1
  514. package/dev/setErrorMessageHandler.js.map +1 -1
  515. package/dev/symbol.d.ts +1 -1
  516. package/dev/symbol.js +1 -1
  517. package/dev/symbol.js.map +1 -1
  518. package/errors/CombinedGraphQLErrors.d.ts +168 -14
  519. package/errors/CombinedGraphQLErrors.js +64 -11
  520. package/errors/CombinedGraphQLErrors.js.map +1 -1
  521. package/errors/CombinedProtocolErrors.d.ts +132 -2
  522. package/errors/CombinedProtocolErrors.js +54 -1
  523. package/errors/CombinedProtocolErrors.js.map +1 -1
  524. package/errors/LinkError.d.ts +45 -2
  525. package/errors/LinkError.js +45 -2
  526. package/errors/LinkError.js.map +1 -1
  527. package/errors/LocalStateError.d.ts +41 -5
  528. package/errors/LocalStateError.js +35 -5
  529. package/errors/LocalStateError.js.map +1 -1
  530. package/errors/ServerError.d.ts +71 -11
  531. package/errors/ServerError.js +51 -8
  532. package/errors/ServerError.js.map +1 -1
  533. package/errors/ServerParseError.d.ts +72 -16
  534. package/errors/ServerParseError.js +46 -8
  535. package/errors/ServerParseError.js.map +1 -1
  536. package/errors/UnconventionalError.d.ts +47 -3
  537. package/errors/UnconventionalError.js +47 -3
  538. package/errors/UnconventionalError.js.map +1 -1
  539. package/errors/index.d.ts +1 -1
  540. package/errors/index.js +1 -1
  541. package/errors/index.js.map +1 -1
  542. package/errors/isErrorLike.d.ts +1 -1
  543. package/errors/isErrorLike.js +1 -1
  544. package/errors/isErrorLike.js.map +1 -1
  545. package/errors/utils.d.ts +1 -1
  546. package/errors/utils.js +1 -1
  547. package/errors/utils.js.map +1 -1
  548. package/incremental/handlers/defer20220824.d.ts +5 -5
  549. package/incremental/handlers/defer20220824.js +1 -1
  550. package/incremental/handlers/defer20220824.js.map +1 -1
  551. package/incremental/handlers/notImplemented.d.ts +3 -3
  552. package/incremental/handlers/notImplemented.js +1 -1
  553. package/incremental/handlers/notImplemented.js.map +1 -1
  554. package/incremental/index.d.ts +1 -1
  555. package/incremental/index.js.map +1 -1
  556. package/incremental/types.d.ts +4 -4
  557. package/incremental/types.js +1 -1
  558. package/incremental/types.js.map +1 -1
  559. package/invariantErrorCodes.d.ts +1 -1
  560. package/invariantErrorCodes.js +88 -89
  561. package/invariantErrorCodes.js.map +1 -1
  562. package/legacyEntryPoints/react/internal/compiler-runtime/compiler-runtime.cjs +1 -0
  563. package/legacyEntryPoints/react/internal/compiler-runtime/compiler-runtime.d.cts +1 -0
  564. package/legacyEntryPoints/react/internal/compiler-runtime/index.d.ts +1 -0
  565. package/legacyEntryPoints/react/internal/compiler-runtime/index.js +1 -0
  566. package/link/batch/batchLink.d.ts +103 -28
  567. package/link/batch/batchLink.js +33 -12
  568. package/link/batch/batchLink.js.map +1 -1
  569. package/link/batch/batching.d.ts +9 -9
  570. package/link/batch/batching.js +3 -3
  571. package/link/batch/batching.js.map +1 -1
  572. package/link/batch/index.d.ts +2 -3
  573. package/link/batch/index.js +2 -2
  574. package/link/batch/index.js.map +1 -1
  575. package/link/batch-http/BaseBatchHttpLink.d.ts +68 -0
  576. package/link/batch-http/BaseBatchHttpLink.js +152 -0
  577. package/link/batch-http/BaseBatchHttpLink.js.map +1 -0
  578. package/link/batch-http/batchHttpLink.d.ts +41 -18
  579. package/link/batch-http/batchHttpLink.js +28 -129
  580. package/link/batch-http/batchHttpLink.js.map +1 -1
  581. package/link/batch-http/index.d.ts +3 -2
  582. package/link/batch-http/index.js +3 -2
  583. package/link/batch-http/index.js.map +1 -1
  584. package/link/client-awareness/ClientAwarenessLink.d.ts +59 -7
  585. package/link/client-awareness/ClientAwarenessLink.js +37 -4
  586. package/link/client-awareness/ClientAwarenessLink.js.map +1 -1
  587. package/link/client-awareness/index.d.ts +1 -1
  588. package/link/client-awareness/index.js +1 -1
  589. package/link/client-awareness/index.js.map +1 -1
  590. package/link/context/index.d.ts +78 -5
  591. package/link/context/index.js +38 -15
  592. package/link/context/index.js.map +1 -1
  593. package/link/core/ApolloLink.d.ts +355 -9
  594. package/link/core/ApolloLink.js +228 -57
  595. package/link/core/ApolloLink.js.map +1 -1
  596. package/link/core/concat.d.ts +5 -1
  597. package/link/core/concat.js +5 -1
  598. package/link/core/concat.js.map +1 -1
  599. package/link/core/deprecated.d.ts +10 -0
  600. package/link/core/deprecated.js +2 -0
  601. package/link/core/deprecated.js.map +1 -0
  602. package/link/core/empty.d.ts +5 -1
  603. package/link/core/empty.js +5 -1
  604. package/link/core/empty.js.map +1 -1
  605. package/link/core/execute.d.ts +1 -1
  606. package/link/core/execute.js +1 -1
  607. package/link/core/execute.js.map +1 -1
  608. package/link/core/from.d.ts +5 -1
  609. package/link/core/from.js +5 -1
  610. package/link/core/from.js.map +1 -1
  611. package/link/core/split.d.ts +5 -1
  612. package/link/core/split.js +5 -1
  613. package/link/core/split.js.map +1 -1
  614. package/link/core/types.d.ts +3 -34
  615. package/link/core/types.js +1 -1
  616. package/link/core/types.js.map +1 -1
  617. package/link/error/index.d.ts +84 -10
  618. package/link/error/index.js +45 -1
  619. package/link/error/index.js.map +1 -1
  620. package/link/http/BaseHttpLink.d.ts +256 -2
  621. package/link/http/BaseHttpLink.js +63 -13
  622. package/link/http/BaseHttpLink.js.map +1 -1
  623. package/link/http/HttpLink.d.ts +46 -136
  624. package/link/http/HttpLink.js +28 -3
  625. package/link/http/HttpLink.js.map +1 -1
  626. package/link/http/checkFetcher.d.ts +1 -1
  627. package/link/http/checkFetcher.js +1 -1
  628. package/link/http/checkFetcher.js.map +1 -1
  629. package/link/http/createSignalIfSupported.d.ts +1 -1
  630. package/link/http/createSignalIfSupported.js +1 -1
  631. package/link/http/createSignalIfSupported.js.map +1 -1
  632. package/link/http/index.d.ts +1 -3
  633. package/link/http/index.js +1 -2
  634. package/link/http/index.js.map +1 -1
  635. package/link/http/parseAndCheckHttpResponse.d.ts +3 -3
  636. package/link/http/parseAndCheckHttpResponse.js +41 -26
  637. package/link/http/parseAndCheckHttpResponse.js.map +1 -1
  638. package/link/http/rewriteURIForGET.d.ts +3 -3
  639. package/link/http/rewriteURIForGET.js +3 -4
  640. package/link/http/rewriteURIForGET.js.map +1 -1
  641. package/link/http/selectHttpOptionsAndBody.d.ts +10 -10
  642. package/link/http/selectHttpOptionsAndBody.js +1 -1
  643. package/link/http/selectHttpOptionsAndBody.js.map +1 -1
  644. package/link/http/selectURI.d.ts +3 -3
  645. package/link/http/selectURI.js +1 -1
  646. package/link/http/selectURI.js.map +1 -1
  647. package/link/index.d.ts +3 -2
  648. package/link/index.js +1 -1
  649. package/link/index.js.map +1 -1
  650. package/link/persisted-queries/index.d.ts +207 -28
  651. package/link/persisted-queries/index.js +18 -2
  652. package/link/persisted-queries/index.js.map +1 -1
  653. package/link/remove-typename/index.d.ts +1 -2
  654. package/link/remove-typename/index.js.map +1 -1
  655. package/link/remove-typename/removeTypenameFromVariables.d.ts +125 -9
  656. package/link/remove-typename/removeTypenameFromVariables.js +49 -1
  657. package/link/remove-typename/removeTypenameFromVariables.js.map +1 -1
  658. package/link/retry/delayFunction.d.ts +3 -40
  659. package/link/retry/delayFunction.js +1 -1
  660. package/link/retry/delayFunction.js.map +1 -1
  661. package/link/retry/index.d.ts +1 -1
  662. package/link/retry/index.js +1 -1
  663. package/link/retry/index.js.map +1 -1
  664. package/link/retry/retryFunction.d.ts +3 -30
  665. package/link/retry/retryFunction.js +1 -1
  666. package/link/retry/retryFunction.js.map +1 -1
  667. package/link/retry/retryLink.d.ts +130 -6
  668. package/link/retry/retryLink.js +39 -14
  669. package/link/retry/retryLink.js.map +1 -1
  670. package/link/schema/index.d.ts +130 -9
  671. package/link/schema/index.js +21 -1
  672. package/link/schema/index.js.map +1 -1
  673. package/link/subscriptions/index.d.ts +25 -3
  674. package/link/subscriptions/index.js +24 -1
  675. package/link/subscriptions/index.js.map +1 -1
  676. package/link/utils/createOperation.d.ts +3 -3
  677. package/link/utils/createOperation.js +13 -5
  678. package/link/utils/createOperation.js.map +1 -1
  679. package/link/utils/filterOperationVariables.d.ts +1 -1
  680. package/link/utils/filterOperationVariables.js +1 -1
  681. package/link/utils/filterOperationVariables.js.map +1 -1
  682. package/link/utils/index.d.ts +1 -3
  683. package/link/utils/index.js +1 -3
  684. package/link/utils/index.js.map +1 -1
  685. package/link/ws/index.d.ts +65 -8
  686. package/link/ws/index.js +30 -0
  687. package/link/ws/index.js.map +1 -1
  688. package/local-state/LocalState.d.ts +95 -1
  689. package/local-state/LocalState.js +55 -9
  690. package/local-state/LocalState.js.map +1 -1
  691. package/local-state/index.d.ts +1 -1
  692. package/local-state/index.js +1 -1
  693. package/local-state/index.js.map +1 -1
  694. package/masking/GraphQLCodegenDataMasking.d.ts +12 -45
  695. package/masking/GraphQLCodegenDataMasking.js +1 -1
  696. package/masking/GraphQLCodegenDataMasking.js.map +1 -1
  697. package/masking/PreserveTypes.d.ts +26 -0
  698. package/masking/PreserveTypes.js +2 -0
  699. package/masking/PreserveTypes.js.map +1 -0
  700. package/masking/index.d.ts +2 -2
  701. package/masking/index.js +1 -1
  702. package/masking/index.js.map +1 -1
  703. package/masking/internal/types.d.ts +71 -72
  704. package/masking/internal/types.js +1 -1
  705. package/masking/internal/types.js.map +1 -1
  706. package/masking/maskDefinition.d.ts +1 -1
  707. package/masking/maskDefinition.js +2 -2
  708. package/masking/maskDefinition.js.map +1 -1
  709. package/masking/maskFragment.js +2 -2
  710. package/masking/maskFragment.js.map +1 -1
  711. package/masking/maskOperation.js +1 -1
  712. package/masking/maskOperation.js.map +1 -1
  713. package/masking/types.d.ts +6 -24
  714. package/masking/types.js +1 -1
  715. package/masking/types.js.map +1 -1
  716. package/masking/utils.js +3 -3
  717. package/masking/utils.js.map +1 -1
  718. package/package.json +12 -5
  719. package/react/compiled/index.d.ts +2 -0
  720. package/react/compiled/index.js +2 -0
  721. package/react/compiled/index.js.map +1 -0
  722. package/react/context/ApolloContext.d.ts +1 -1
  723. package/react/context/ApolloContext.js +1 -1
  724. package/react/context/ApolloContext.js.map +1 -1
  725. package/react/context/ApolloProvider.d.ts +1 -1
  726. package/react/context/ApolloProvider.js +1 -1
  727. package/react/context/ApolloProvider.js.map +1 -1
  728. package/react/hooks/constants.d.ts +1 -1
  729. package/react/hooks/constants.js +1 -1
  730. package/react/hooks/constants.js.map +1 -1
  731. package/react/hooks/internal/__use.d.ts +1 -1
  732. package/react/hooks/internal/__use.js +1 -1
  733. package/react/hooks/internal/__use.js.map +1 -1
  734. package/react/hooks/internal/index.d.ts +1 -1
  735. package/react/hooks/internal/index.js +1 -1
  736. package/react/hooks/internal/index.js.map +1 -1
  737. package/react/hooks/internal/useDeepMemo.d.ts +1 -1
  738. package/react/hooks/internal/useDeepMemo.js +1 -4
  739. package/react/hooks/internal/useDeepMemo.js.map +1 -1
  740. package/react/hooks/internal/useIsomorphicLayoutEffect.d.ts +1 -1
  741. package/react/hooks/internal/useIsomorphicLayoutEffect.js +1 -1
  742. package/react/hooks/internal/useIsomorphicLayoutEffect.js.map +1 -1
  743. package/react/hooks/internal/useRenderGuard.d.ts +1 -1
  744. package/react/hooks/internal/useRenderGuard.js +1 -1
  745. package/react/hooks/internal/useRenderGuard.js.map +1 -1
  746. package/react/hooks/internal/validateSuspenseHookOptions.d.ts +3 -3
  747. package/react/hooks/internal/validateSuspenseHookOptions.js.map +1 -1
  748. package/react/hooks/internal/wrapHook.d.ts +8 -7
  749. package/react/hooks/internal/wrapHook.js +1 -0
  750. package/react/hooks/internal/wrapHook.js.map +1 -1
  751. package/react/hooks/useApolloClient.d.ts +3 -3
  752. package/react/hooks/useApolloClient.js +3 -16
  753. package/react/hooks/useApolloClient.js.map +1 -1
  754. package/react/hooks/useBackgroundQuery.d.ts +850 -86
  755. package/react/hooks/useBackgroundQuery.js +7 -7
  756. package/react/hooks/useBackgroundQuery.js.map +1 -1
  757. package/react/hooks/useFragment.d.ts +56 -8
  758. package/react/hooks/useFragment.js +22 -16
  759. package/react/hooks/useFragment.js.map +1 -1
  760. package/react/hooks/useLazyQuery.d.ts +317 -161
  761. package/react/hooks/useLazyQuery.js +14 -52
  762. package/react/hooks/useLazyQuery.js.map +1 -1
  763. package/react/hooks/useLoadableQuery.d.ts +246 -69
  764. package/react/hooks/useLoadableQuery.js +69 -229
  765. package/react/hooks/useLoadableQuery.js.map +1 -1
  766. package/react/hooks/useMutation.d.ts +87 -65
  767. package/react/hooks/useMutation.js +88 -199
  768. package/react/hooks/useMutation.js.map +1 -1
  769. package/react/hooks/useQuery.d.ts +367 -239
  770. package/react/hooks/useQuery.js +55 -260
  771. package/react/hooks/useQuery.js.map +1 -1
  772. package/react/hooks/useQueryRefHandlers.d.ts +36 -3
  773. package/react/hooks/useQueryRefHandlers.js +26 -65
  774. package/react/hooks/useQueryRefHandlers.js.map +1 -1
  775. package/react/hooks/useReactiveVar.d.ts +3 -2
  776. package/react/hooks/useReactiveVar.js +3 -2
  777. package/react/hooks/useReactiveVar.js.map +1 -1
  778. package/react/hooks/useReadQuery.d.ts +92 -16
  779. package/react/hooks/useReadQuery.js +32 -3
  780. package/react/hooks/useReadQuery.js.map +1 -1
  781. package/react/hooks/useSubscription.d.ts +160 -68
  782. package/react/hooks/useSubscription.js +12 -13
  783. package/react/hooks/useSubscription.js.map +1 -1
  784. package/react/hooks/useSuspenseFragment.d.ts +62 -30
  785. package/react/hooks/useSuspenseFragment.js +1 -1
  786. package/react/hooks/useSuspenseFragment.js.map +1 -1
  787. package/react/hooks/useSuspenseQuery.d.ts +585 -159
  788. package/react/hooks/useSuspenseQuery.js +35 -57
  789. package/react/hooks/useSuspenseQuery.js.map +1 -1
  790. package/react/hooks/useSyncExternalStore.d.ts +1 -1
  791. package/react/hooks/useSyncExternalStore.js +1 -1
  792. package/react/hooks/useSyncExternalStore.js.map +1 -1
  793. package/react/hooks-compiled/constants.d.ts +3 -0
  794. package/react/hooks-compiled/constants.js +2 -0
  795. package/react/hooks-compiled/constants.js.map +1 -0
  796. package/react/hooks-compiled/internal/__use.d.ts +4 -0
  797. package/react/hooks-compiled/internal/__use.js +22 -0
  798. package/react/hooks-compiled/internal/__use.js.map +1 -0
  799. package/react/hooks-compiled/internal/index.d.ts +5 -0
  800. package/react/hooks-compiled/internal/index.js +6 -0
  801. package/react/hooks-compiled/internal/index.js.map +1 -0
  802. package/react/hooks-compiled/internal/useDeepMemo.d.ts +3 -0
  803. package/react/hooks-compiled/internal/useDeepMemo.js +10 -0
  804. package/react/hooks-compiled/internal/useDeepMemo.js.map +1 -0
  805. package/react/hooks-compiled/internal/useIsomorphicLayoutEffect.d.ts +3 -0
  806. package/react/hooks-compiled/internal/useIsomorphicLayoutEffect.js +9 -0
  807. package/react/hooks-compiled/internal/useIsomorphicLayoutEffect.js.map +1 -0
  808. package/react/hooks-compiled/internal/useRenderGuard.d.ts +2 -0
  809. package/react/hooks-compiled/internal/useRenderGuard.js +42 -0
  810. package/react/hooks-compiled/internal/useRenderGuard.js.map +1 -0
  811. package/react/hooks-compiled/internal/validateSuspenseHookOptions.d.ts +3 -0
  812. package/react/hooks-compiled/internal/validateSuspenseHookOptions.js +22 -0
  813. package/react/hooks-compiled/internal/validateSuspenseHookOptions.js.map +1 -0
  814. package/react/hooks-compiled/internal/wrapHook.d.ts +67 -0
  815. package/react/hooks-compiled/internal/wrapHook.js +65 -0
  816. package/react/hooks-compiled/internal/wrapHook.js.map +1 -0
  817. package/react/hooks-compiled/useApolloClient.d.ts +18 -0
  818. package/react/hooks-compiled/useApolloClient.js +36 -0
  819. package/react/hooks-compiled/useApolloClient.js.map +1 -0
  820. package/react/hooks-compiled/useBackgroundQuery.d.ts +974 -0
  821. package/react/hooks-compiled/useBackgroundQuery.js +80 -0
  822. package/react/hooks-compiled/useBackgroundQuery.js.map +1 -0
  823. package/react/hooks-compiled/useFragment.d.ts +103 -0
  824. package/react/hooks-compiled/useFragment.js +103 -0
  825. package/react/hooks-compiled/useFragment.js.map +1 -0
  826. package/react/hooks-compiled/useLazyQuery.d.ts +436 -0
  827. package/react/hooks-compiled/useLazyQuery.js +143 -0
  828. package/react/hooks-compiled/useLazyQuery.js.map +1 -0
  829. package/react/hooks-compiled/useLoadableQuery.d.ts +352 -0
  830. package/react/hooks-compiled/useLoadableQuery.js +247 -0
  831. package/react/hooks-compiled/useLoadableQuery.js.map +1 -0
  832. package/react/hooks-compiled/useMutation.d.ts +302 -0
  833. package/react/hooks-compiled/useMutation.js +262 -0
  834. package/react/hooks-compiled/useMutation.js.map +1 -0
  835. package/react/hooks-compiled/useQuery.d.ts +393 -0
  836. package/react/hooks-compiled/useQuery.js +361 -0
  837. package/react/hooks-compiled/useQuery.js.map +1 -0
  838. package/react/hooks-compiled/useQueryRefHandlers.d.ts +77 -0
  839. package/react/hooks-compiled/useQueryRefHandlers.js +110 -0
  840. package/react/hooks-compiled/useQueryRefHandlers.js.map +1 -0
  841. package/react/hooks-compiled/useReactiveVar.d.ts +21 -0
  842. package/react/hooks-compiled/useReactiveVar.js +34 -0
  843. package/react/hooks-compiled/useReactiveVar.js.map +1 -0
  844. package/react/hooks-compiled/useReadQuery.d.ts +100 -0
  845. package/react/hooks-compiled/useReadQuery.js +72 -0
  846. package/react/hooks-compiled/useReadQuery.js.map +1 -0
  847. package/react/hooks-compiled/useSubscription.d.ts +270 -0
  848. package/react/hooks-compiled/useSubscription.js +222 -0
  849. package/react/hooks-compiled/useSubscription.js.map +1 -0
  850. package/react/hooks-compiled/useSuspenseFragment.d.ts +79 -0
  851. package/react/hooks-compiled/useSuspenseFragment.js +47 -0
  852. package/react/hooks-compiled/useSuspenseFragment.js.map +1 -0
  853. package/react/hooks-compiled/useSuspenseQuery.d.ts +630 -0
  854. package/react/hooks-compiled/useSuspenseQuery.js +144 -0
  855. package/react/hooks-compiled/useSuspenseQuery.js.map +1 -0
  856. package/react/hooks-compiled/useSyncExternalStore.d.ts +4 -0
  857. package/react/hooks-compiled/useSyncExternalStore.js +126 -0
  858. package/react/hooks-compiled/useSyncExternalStore.js.map +1 -0
  859. package/react/index.compiled.d.ts +24 -0
  860. package/react/index.compiled.js +19 -0
  861. package/react/index.compiled.js.map +1 -0
  862. package/react/index.d.ts +2 -3
  863. package/react/index.js +2 -3
  864. package/react/index.js.map +1 -1
  865. package/react/index.react-server.d.ts +1 -2
  866. package/react/index.react-server.js +1 -3
  867. package/react/index.react-server.js.map +1 -1
  868. package/react/internal/cache/FragmentReference.d.ts +3 -4
  869. package/react/internal/cache/FragmentReference.js +2 -2
  870. package/react/internal/cache/FragmentReference.js.map +1 -1
  871. package/react/internal/cache/QueryReference.d.ts +14 -12
  872. package/react/internal/cache/QueryReference.js.map +1 -1
  873. package/react/internal/cache/SuspenseCache.d.ts +3 -3
  874. package/react/internal/cache/SuspenseCache.js +1 -1
  875. package/react/internal/cache/SuspenseCache.js.map +1 -1
  876. package/react/internal/cache/getSuspenseCache.d.ts +7 -5
  877. package/react/internal/cache/getSuspenseCache.js +1 -1
  878. package/react/internal/cache/getSuspenseCache.js.map +1 -1
  879. package/react/internal/cache/types.d.ts +1 -1
  880. package/react/internal/cache/types.js +1 -1
  881. package/react/internal/cache/types.js.map +1 -1
  882. package/react/internal/compiler-runtime/index.d.ts +8 -0
  883. package/react/internal/compiler-runtime/index.js +28 -0
  884. package/react/internal/compiler-runtime/index.js.map +1 -0
  885. package/react/internal/index.d.ts +2 -2
  886. package/react/internal/index.js +2 -1
  887. package/react/internal/index.js.map +1 -1
  888. package/react/internal/types.d.ts +4 -4
  889. package/react/internal/types.js +1 -1
  890. package/react/internal/types.js.map +1 -1
  891. package/react/query-preloader/createQueryPreloader.d.ts +60 -51
  892. package/react/query-preloader/createQueryPreloader.js +2 -2
  893. package/react/query-preloader/createQueryPreloader.js.map +1 -1
  894. package/react/ssr/getDataFromTree.d.ts +1 -1
  895. package/react/ssr/getDataFromTree.js.map +1 -1
  896. package/react/ssr/index.d.ts +1 -1
  897. package/react/ssr/index.js +1 -1
  898. package/react/ssr/index.js.map +1 -1
  899. package/react/ssr/prerenderStatic.d.ts +12 -10
  900. package/react/ssr/prerenderStatic.js +5 -4
  901. package/react/ssr/prerenderStatic.js.map +1 -1
  902. package/react/ssr/renderToStringWithData.d.ts +1 -1
  903. package/react/ssr/renderToStringWithData.js +1 -1
  904. package/react/ssr/renderToStringWithData.js.map +1 -1
  905. package/react/ssr/useSSRQuery.d.ts +1 -1
  906. package/react/ssr/useSSRQuery.js +1 -1
  907. package/react/ssr/useSSRQuery.js.map +1 -1
  908. package/react/types/deprecated.d.ts +2 -2
  909. package/react/types/deprecated.js +1 -1
  910. package/react/types/deprecated.js.map +1 -1
  911. package/react/types/types.documentation.d.ts +27 -16
  912. package/react/types/types.documentation.js +1 -1
  913. package/react/types/types.documentation.js.map +1 -1
  914. package/testing/core/mocking/mockLink.d.ts +8 -8
  915. package/testing/core/mocking/mockLink.js.map +1 -1
  916. package/testing/core/mocking/mockSubscriptionLink.d.ts +4 -5
  917. package/testing/core/mocking/mockSubscriptionLink.js +1 -1
  918. package/testing/core/mocking/mockSubscriptionLink.js.map +1 -1
  919. package/testing/core/types/deprecated.d.ts +4 -3
  920. package/testing/core/types/deprecated.js +1 -1
  921. package/testing/core/types/deprecated.js.map +1 -1
  922. package/testing/index.d.ts +1 -1
  923. package/testing/index.js +1 -1
  924. package/testing/index.js.map +1 -1
  925. package/testing/react/MockedProvider.d.ts +3 -4
  926. package/testing/react/MockedProvider.js +1 -1
  927. package/testing/react/MockedProvider.js.map +1 -1
  928. package/testing/react/index.d.ts +1 -1
  929. package/testing/react/index.js +1 -1
  930. package/testing/react/index.js.map +1 -1
  931. package/utilities/DeepPartial.d.ts +1 -1
  932. package/utilities/DeepPartial.js +1 -1
  933. package/utilities/DeepPartial.js.map +1 -1
  934. package/utilities/HKT.d.ts +9 -8
  935. package/utilities/HKT.js +1 -1
  936. package/utilities/HKT.js.map +1 -1
  937. package/utilities/caching/index.d.ts +1 -1
  938. package/utilities/caching/index.js +1 -1
  939. package/utilities/caching/index.js.map +1 -1
  940. package/utilities/caching/sizes.d.ts +5 -7
  941. package/utilities/caching/sizes.js +4 -4
  942. package/utilities/caching/sizes.js.map +1 -1
  943. package/utilities/common/stripTypename.d.ts +12 -1
  944. package/utilities/common/stripTypename.js +12 -1
  945. package/utilities/common/stripTypename.js.map +1 -1
  946. package/utilities/environment/index.d.ts +1 -1
  947. package/utilities/environment/index.development.d.ts +1 -1
  948. package/utilities/environment/index.development.js +1 -1
  949. package/utilities/environment/index.development.js.map +1 -1
  950. package/utilities/environment/index.js +1 -1
  951. package/utilities/environment/index.js.map +1 -1
  952. package/utilities/environment/index.production.d.ts +1 -1
  953. package/utilities/environment/index.production.js +1 -1
  954. package/utilities/environment/index.production.js.map +1 -1
  955. package/utilities/graphql/DocumentTransform.d.ts +94 -5
  956. package/utilities/graphql/DocumentTransform.js +85 -2
  957. package/utilities/graphql/DocumentTransform.js.map +1 -1
  958. package/utilities/graphql/isFormattedExecutionResult.d.ts +28 -1
  959. package/utilities/graphql/isFormattedExecutionResult.js +28 -1
  960. package/utilities/graphql/isFormattedExecutionResult.js.map +1 -1
  961. package/utilities/graphql/operations.d.ts +55 -4
  962. package/utilities/graphql/operations.js +55 -4
  963. package/utilities/graphql/operations.js.map +1 -1
  964. package/utilities/graphql/print.d.ts +1 -1
  965. package/utilities/graphql/print.js +1 -1
  966. package/utilities/graphql/print.js.map +1 -1
  967. package/utilities/graphql/storeUtils.d.ts +10 -1
  968. package/utilities/graphql/storeUtils.js +10 -1
  969. package/utilities/graphql/storeUtils.js.map +1 -1
  970. package/utilities/graphql/transform.d.ts +13 -2
  971. package/utilities/graphql/transform.js +13 -2
  972. package/utilities/graphql/transform.js.map +1 -1
  973. package/utilities/index.d.ts +2 -3
  974. package/utilities/index.js +2 -3
  975. package/utilities/index.js.map +1 -1
  976. package/utilities/internal/argumentsObjectFromField.js.map +1 -1
  977. package/utilities/internal/caches.js.map +1 -1
  978. package/utilities/internal/canUseDOM.js.map +1 -1
  979. package/utilities/internal/canonicalStringify.d.ts +44 -0
  980. package/utilities/{shared → internal}/canonicalStringify.js +35 -14
  981. package/utilities/internal/canonicalStringify.js.map +1 -0
  982. package/utilities/internal/checkDocument.js +1 -1
  983. package/utilities/internal/checkDocument.js.map +1 -1
  984. package/utilities/internal/cloneDeep.js.map +1 -1
  985. package/utilities/internal/compact.js.map +1 -1
  986. package/utilities/internal/createFragmentMap.js.map +1 -1
  987. package/utilities/internal/createFulfilledPromise.js.map +1 -1
  988. package/utilities/internal/createRejectedPromise.js.map +1 -1
  989. package/utilities/internal/dealias.d.ts +1 -1
  990. package/utilities/internal/dealias.js +1 -1
  991. package/utilities/internal/dealias.js.map +1 -1
  992. package/utilities/internal/decoratePromise.js.map +1 -1
  993. package/utilities/internal/deepFreeze.js.map +1 -1
  994. package/utilities/internal/equalByQuery.d.ts +5 -0
  995. package/{core → utilities/internal}/equalByQuery.js +8 -2
  996. package/utilities/internal/equalByQuery.js.map +1 -0
  997. package/utilities/internal/filterMap.d.ts +1 -1
  998. package/utilities/internal/filterMap.js +1 -1
  999. package/utilities/internal/filterMap.js.map +1 -1
  1000. package/utilities/internal/getDefaultValues.js.map +1 -1
  1001. package/utilities/internal/getFragmentDefinition.js.map +1 -1
  1002. package/utilities/internal/getFragmentDefinitions.js.map +1 -1
  1003. package/utilities/internal/getFragmentFromSelection.js.map +1 -1
  1004. package/utilities/internal/getFragmentQueryDocument.d.ts +13 -3
  1005. package/utilities/internal/getFragmentQueryDocument.js +13 -3
  1006. package/utilities/internal/getFragmentQueryDocument.js.map +1 -1
  1007. package/utilities/internal/getGraphQLErrorsFromResult.js.map +1 -1
  1008. package/utilities/internal/getMainDefinition.d.ts +37 -9
  1009. package/utilities/internal/getMainDefinition.js +36 -8
  1010. package/utilities/internal/getMainDefinition.js.map +1 -1
  1011. package/utilities/internal/getMemoryInternals.js.map +1 -1
  1012. package/utilities/internal/getOperationDefinition.js.map +1 -1
  1013. package/utilities/internal/getOperationName.js.map +1 -1
  1014. package/utilities/internal/getQueryDefinition.js.map +1 -1
  1015. package/utilities/internal/getStoreKeyName.js +9 -7
  1016. package/utilities/internal/getStoreKeyName.js.map +1 -1
  1017. package/utilities/internal/globals/global.d.ts +1 -1
  1018. package/utilities/internal/globals/index.d.ts +1 -1
  1019. package/utilities/internal/globals/index.js +1 -1
  1020. package/utilities/internal/globals/index.js.map +1 -1
  1021. package/utilities/internal/globals/maybe.d.ts +1 -1
  1022. package/utilities/internal/globals/maybe.js +1 -1
  1023. package/utilities/internal/globals/maybe.js.map +1 -1
  1024. package/utilities/internal/graphQLResultHasError.js.map +1 -1
  1025. package/utilities/internal/hasDirectives.js.map +1 -1
  1026. package/utilities/internal/hasForcedResolvers.d.ts +1 -1
  1027. package/utilities/internal/hasForcedResolvers.js +1 -1
  1028. package/utilities/internal/hasForcedResolvers.js.map +1 -1
  1029. package/utilities/internal/index.d.ts +5 -1
  1030. package/utilities/internal/index.js +4 -1
  1031. package/utilities/internal/index.js.map +1 -1
  1032. package/utilities/internal/index.production.d.ts +1 -1
  1033. package/utilities/internal/index.production.js +1 -1
  1034. package/utilities/internal/index.production.js.map +1 -1
  1035. package/utilities/internal/isArray.js.map +1 -1
  1036. package/utilities/internal/isDocumentNode.js.map +1 -1
  1037. package/utilities/internal/isField.js.map +1 -1
  1038. package/utilities/internal/isNonEmptyArray.js.map +1 -1
  1039. package/utilities/internal/isNonNullObject.js.map +1 -1
  1040. package/utilities/internal/isPlainObject.js.map +1 -1
  1041. package/utilities/internal/makeReference.js.map +1 -1
  1042. package/utilities/internal/makeUniqueId.js.map +1 -1
  1043. package/utilities/internal/maybeDeepFreeze.js.map +1 -1
  1044. package/utilities/internal/mergeDeep.js.map +1 -1
  1045. package/utilities/internal/mergeDeepArray.js.map +1 -1
  1046. package/utilities/internal/mergeOptions.d.ts +2 -2
  1047. package/utilities/internal/mergeOptions.js.map +1 -1
  1048. package/utilities/internal/omitDeep.js.map +1 -1
  1049. package/utilities/internal/preventUnhandledRejection.d.ts +1 -1
  1050. package/utilities/internal/preventUnhandledRejection.js +1 -1
  1051. package/utilities/internal/preventUnhandledRejection.js.map +1 -1
  1052. package/utilities/internal/removeDirectivesFromDocument.js +1 -2
  1053. package/utilities/internal/removeDirectivesFromDocument.js.map +1 -1
  1054. package/utilities/internal/removeFragmentSpreads.d.ts +3 -0
  1055. package/utilities/internal/removeFragmentSpreads.js +11 -0
  1056. package/utilities/internal/removeFragmentSpreads.js.map +1 -0
  1057. package/utilities/internal/resultKeyNameFromField.js.map +1 -1
  1058. package/utilities/internal/shouldInclude.js.map +1 -1
  1059. package/utilities/internal/storeKeyNameFromField.js.map +1 -1
  1060. package/utilities/internal/stringifyForDisplay.js.map +1 -1
  1061. package/utilities/internal/toQueryResult.d.ts +2 -2
  1062. package/utilities/internal/toQueryResult.js.map +1 -1
  1063. package/utilities/internal/types/ApplyHKT.js +1 -1
  1064. package/utilities/internal/types/ApplyHKT.js.map +1 -1
  1065. package/utilities/internal/types/ApplyHKTImplementationWithDefault.js +1 -1
  1066. package/utilities/internal/types/ApplyHKTImplementationWithDefault.js.map +1 -1
  1067. package/utilities/internal/types/DecoratedPromise.js +1 -1
  1068. package/utilities/internal/types/DecoratedPromise.js.map +1 -1
  1069. package/utilities/internal/types/DeepOmit.js +1 -1
  1070. package/utilities/internal/types/DeepOmit.js.map +1 -1
  1071. package/utilities/internal/types/DocumentationTypes.d.ts +88 -0
  1072. package/utilities/internal/types/DocumentationTypes.js +2 -0
  1073. package/utilities/internal/types/DocumentationTypes.js.map +1 -0
  1074. package/utilities/internal/types/FragmentMap.js +1 -1
  1075. package/utilities/internal/types/FragmentMap.js.map +1 -1
  1076. package/utilities/internal/types/FragmentMapFunction.js +1 -1
  1077. package/utilities/internal/types/FragmentMapFunction.js.map +1 -1
  1078. package/utilities/internal/types/FulfilledPromise.js +1 -1
  1079. package/utilities/internal/types/FulfilledPromise.js.map +1 -1
  1080. package/utilities/internal/types/IsAny.js +1 -1
  1081. package/utilities/internal/types/IsAny.js.map +1 -1
  1082. package/utilities/internal/types/NoInfer.d.ts +32 -26
  1083. package/utilities/internal/types/NoInfer.js +1 -1
  1084. package/utilities/internal/types/NoInfer.js.map +1 -1
  1085. package/utilities/internal/types/PendingPromise.js +1 -1
  1086. package/utilities/internal/types/PendingPromise.js.map +1 -1
  1087. package/utilities/internal/types/Prettify.js +1 -1
  1088. package/utilities/internal/types/Prettify.js.map +1 -1
  1089. package/utilities/internal/types/Primitive.js +1 -1
  1090. package/utilities/internal/types/Primitive.js.map +1 -1
  1091. package/utilities/internal/types/RejectedPromise.js +1 -1
  1092. package/utilities/internal/types/RejectedPromise.js.map +1 -1
  1093. package/utilities/internal/types/RemoveIndexSignature.js +1 -1
  1094. package/utilities/internal/types/RemoveIndexSignature.js.map +1 -1
  1095. package/utilities/internal/types/TupleToIntersection.d.ts +1 -1
  1096. package/utilities/internal/types/TupleToIntersection.js +1 -1
  1097. package/utilities/internal/types/TupleToIntersection.js.map +1 -1
  1098. package/utilities/internal/types/VariablesOption.d.ts +2 -6
  1099. package/utilities/internal/types/VariablesOption.js +1 -1
  1100. package/utilities/internal/types/VariablesOption.js.map +1 -1
  1101. package/utilities/internal/valueToObjectRepresentation.js.map +1 -1
  1102. package/utilities/invariant/index.d.ts +1 -1
  1103. package/utilities/invariant/index.development.d.ts +1 -1
  1104. package/utilities/invariant/index.development.js +1 -1
  1105. package/utilities/invariant/index.development.js.map +1 -1
  1106. package/utilities/invariant/index.js +1 -1
  1107. package/utilities/invariant/index.js.map +1 -1
  1108. package/utilities/policies/pagination.d.ts +1 -1
  1109. package/utilities/policies/pagination.js +1 -1
  1110. package/utilities/policies/pagination.js.map +1 -1
  1111. package/utilities/subscriptions/relay/index.d.ts +1 -1
  1112. package/utilities/subscriptions/relay/index.js +4 -3
  1113. package/utilities/subscriptions/relay/index.js.map +1 -1
  1114. package/version.d.ts +1 -1
  1115. package/version.js +1 -1
  1116. package/version.js.map +1 -1
  1117. package/__cjs/cache/core/types/DataProxy.cjs.map +0 -1
  1118. package/__cjs/cache/core/types/DataProxy.d.cts +0 -140
  1119. package/__cjs/core/equalByQuery.cjs.map +0 -1
  1120. package/__cjs/core/equalByQuery.d.cts +0 -4
  1121. package/__cjs/link/http/serializeFetchParameter.cjs +0 -18
  1122. package/__cjs/link/http/serializeFetchParameter.cjs.map +0 -1
  1123. package/__cjs/link/http/serializeFetchParameter.d.cts +0 -6
  1124. package/__cjs/link/utils/transformOperation.cjs +0 -21
  1125. package/__cjs/link/utils/transformOperation.cjs.map +0 -1
  1126. package/__cjs/link/utils/transformOperation.d.cts +0 -3
  1127. package/__cjs/link/utils/validateOperation.cjs +0 -21
  1128. package/__cjs/link/utils/validateOperation.cjs.map +0 -1
  1129. package/__cjs/link/utils/validateOperation.d.cts +0 -3
  1130. package/__cjs/react/context/ApolloConsumer.cjs +0 -16
  1131. package/__cjs/react/context/ApolloConsumer.cjs.map +0 -1
  1132. package/__cjs/react/context/ApolloConsumer.d.cts +0 -10
  1133. package/__cjs/utilities/shared/canonicalStringify.cjs.map +0 -1
  1134. package/__cjs/utilities/shared/canonicalStringify.d.cts +0 -21
  1135. package/cache/core/types/DataProxy.d.ts +0 -140
  1136. package/cache/core/types/DataProxy.js +0 -2
  1137. package/cache/core/types/DataProxy.js.map +0 -1
  1138. package/core/equalByQuery.d.ts +0 -4
  1139. package/core/equalByQuery.js.map +0 -1
  1140. package/link/http/serializeFetchParameter.d.ts +0 -6
  1141. package/link/http/serializeFetchParameter.js +0 -14
  1142. package/link/http/serializeFetchParameter.js.map +0 -1
  1143. package/link/utils/transformOperation.d.ts +0 -3
  1144. package/link/utils/transformOperation.js +0 -18
  1145. package/link/utils/transformOperation.js.map +0 -1
  1146. package/link/utils/validateOperation.d.ts +0 -3
  1147. package/link/utils/validateOperation.js +0 -18
  1148. package/link/utils/validateOperation.js.map +0 -1
  1149. package/react/context/ApolloConsumer.d.ts +0 -10
  1150. package/react/context/ApolloConsumer.js +0 -11
  1151. package/react/context/ApolloConsumer.js.map +0 -1
  1152. package/utilities/shared/canonicalStringify.d.ts +0 -21
  1153. package/utilities/shared/canonicalStringify.js.map +0 -1
@@ -1,106 +1,640 @@
1
+ import type { DocumentNode } from "graphql";
1
2
  import type { Observable } from "rxjs";
2
- import type { ApolloCache, DataProxy, Reference } from "@apollo/client/cache";
3
- import type { WatchFragmentOptions, WatchFragmentResult } from "@apollo/client/cache";
3
+ import type { ApolloCache, IgnoreModifier, Reference } from "@apollo/client/cache";
4
4
  import type { Incremental } from "@apollo/client/incremental";
5
- import type { ApolloLink, FetchResult, GraphQLRequest } from "@apollo/client/link";
5
+ import type { ApolloLink } from "@apollo/client/link";
6
6
  import type { ClientAwarenessLink } from "@apollo/client/link/client-awareness";
7
7
  import type { LocalState } from "@apollo/client/local-state";
8
8
  import type { MaybeMasked, Unmasked } from "@apollo/client/masking";
9
- import type { DocumentTransform } from "@apollo/client/utilities";
9
+ import { DocumentTransform } from "@apollo/client/utilities";
10
+ import type { VariablesOption } from "@apollo/client/utilities/internal";
10
11
  import { getApolloClientMemoryInternals } from "@apollo/client/utilities/internal";
11
12
  import type { ObservableQuery } from "./ObservableQuery.js";
12
- import type { DefaultContext, MutateResult, OperationVariables, QueryResult, RefetchQueriesInclude, RefetchQueriesOptions, RefetchQueriesResult, SubscribeResult, SubscriptionObservable } from "./types.js";
13
- import type { MutationOptions, QueryOptions, SubscriptionOptions, WatchQueryOptions } from "./watchQueryOptions.js";
14
- export interface DefaultOptions {
15
- watchQuery?: Partial<WatchQueryOptions<any, any>>;
16
- query?: Partial<QueryOptions<any, any>>;
17
- mutate?: Partial<MutationOptions<any, any, any>>;
18
- }
19
- interface DevtoolsOptions {
20
- /**
21
- * If `true`, the [Apollo Client Devtools](https://www.apollographql.com/docs/react/development-testing/developer-tooling/#apollo-client-devtools) browser extension can connect to this `ApolloClient` instance.
22
- *
23
- * The default value is `false` in production and `true` in development if there is a `window` object.
24
- */
25
- enabled?: boolean;
26
- /**
27
- * Optional name for this `ApolloClient` instance in the devtools. This is
28
- * useful when you instantiate multiple clients and want to be able to
29
- * identify them by name.
30
- */
31
- name?: string;
32
- }
33
- export interface ApolloClientOptions {
34
- /**
35
- * You can provide an `ApolloLink` instance to serve as Apollo Client's network layer. For more information, see [Advanced HTTP networking](https://www.apollographql.com/docs/react/networking/advanced-http-networking/).
36
- *
37
- * One of `uri` or `link` is **required**. If you provide both, `link` takes precedence.
38
- */
39
- link: ApolloLink;
13
+ import type { DefaultContext, ErrorLike, InternalRefetchQueriesInclude, InternalRefetchQueriesResult, MutationQueryReducersMap, MutationUpdaterFunction, NormalizedExecutionResult, OnQueryUpdated, OperationVariables, RefetchQueriesInclude, RefetchQueriesPromiseResults, SubscriptionObservable, TypedDocumentNode } from "./types.js";
14
+ import type { ErrorPolicy, FetchPolicy, MutationFetchPolicy, NextFetchPolicyContext, RefetchWritePolicy, WatchQueryFetchPolicy } from "./watchQueryOptions.js";
15
+ export declare namespace ApolloClient {
16
+ interface DefaultOptions {
17
+ watchQuery?: Partial<ApolloClient.WatchQueryOptions<any, any>>;
18
+ query?: Partial<ApolloClient.QueryOptions<any, any>>;
19
+ mutate?: Partial<ApolloClient.MutateOptions<any, any, any>>;
20
+ }
21
+ interface Options {
22
+ /**
23
+ * An `ApolloLink` instance to serve as Apollo Client's network layer. For more information, see [Advanced HTTP networking](https://www.apollographql.com/docs/react/networking/advanced-http-networking/).
24
+ */
25
+ link: ApolloLink;
26
+ /**
27
+ * The cache that Apollo Client should use to store query results locally. The recommended cache is `InMemoryCache`, which is provided by the `@apollo/client` package.
28
+ *
29
+ * For more information, see [Configuring the cache](https://www.apollographql.com/docs/react/caching/cache-configuration/).
30
+ */
31
+ cache: ApolloCache;
32
+ /**
33
+ * The time interval (in milliseconds) before Apollo Client force-fetches queries after a server-side render.
34
+ *
35
+ * @defaultValue `0` (no delay)
36
+ */
37
+ ssrForceFetchDelay?: number;
38
+ /**
39
+ * When using Apollo Client for [server-side rendering](https://www.apollographql.com/docs/react/performance/server-side-rendering/), set this to `true` so that the [`getDataFromTree` function](../react/ssr/#getdatafromtree) can work effectively.
40
+ *
41
+ * @defaultValue `false`
42
+ */
43
+ ssrMode?: boolean;
44
+ /**
45
+ * If `false`, Apollo Client sends every created query to the server, even if a _completely_ identical query (identical in terms of query string, variable values, and operationName) is already in flight.
46
+ *
47
+ * @defaultValue `true`
48
+ */
49
+ queryDeduplication?: boolean;
50
+ /**
51
+ * Provide this object to set application-wide default values for options you can provide to the `watchQuery`, `query`, and `mutate` functions. See below for an example object.
52
+ *
53
+ * See this [example object](https://www.apollographql.com/docs/react/api/core/ApolloClient#example-defaultoptions-object).
54
+ */
55
+ defaultOptions?: ApolloClient.DefaultOptions;
56
+ defaultContext?: Partial<DefaultContext>;
57
+ /**
58
+ * If `true`, Apollo Client will assume results read from the cache are never mutated by application code, which enables substantial performance optimizations.
59
+ *
60
+ * @defaultValue `false`
61
+ */
62
+ assumeImmutableResults?: boolean;
63
+ localState?: LocalState;
64
+ /**
65
+ *
66
+ */
67
+ clientAwareness?: ClientAwarenessLink.ClientAwarenessOptions;
68
+ /**
69
+ *
70
+ */
71
+ enhancedClientAwareness?: ClientAwarenessLink.EnhancedClientAwarenessOptions;
72
+ documentTransform?: DocumentTransform;
73
+ /**
74
+ * Configuration used by the [Apollo Client Devtools extension](https://www.apollographql.com/docs/react/development-testing/developer-tooling/#apollo-client-devtools) for this client.
75
+ *
76
+ * @since 3.11.0
77
+ */
78
+ devtools?: DevtoolsOptions;
79
+ /**
80
+ * Determines if data masking is enabled for the client.
81
+ *
82
+ * @defaultValue false
83
+ */
84
+ dataMasking?: boolean;
85
+ /**
86
+ * Determines the strategy used to parse incremental chunks from `@defer`
87
+ * queries.
88
+ */
89
+ incrementalHandler?: Incremental.Handler<any>;
90
+ }
91
+ interface DevtoolsOptions {
92
+ /**
93
+ * If `true`, the [Apollo Client Devtools](https://www.apollographql.com/docs/react/development-testing/developer-tooling/#apollo-client-devtools) browser extension can connect to this `ApolloClient` instance.
94
+ *
95
+ * The default value is `false` in production and `true` in development if there is a `window` object.
96
+ */
97
+ enabled?: boolean;
98
+ /**
99
+ * Optional name for this `ApolloClient` instance in the devtools. This is
100
+ * useful when you instantiate multiple clients and want to be able to
101
+ * identify them by name.
102
+ */
103
+ name?: string;
104
+ }
105
+ type MutateOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables, TCache extends ApolloCache = ApolloCache> = {
106
+ /**
107
+ * By providing either an object or a callback function that, when invoked after
108
+ * a mutation, allows you to return optimistic data and optionally skip updates
109
+ * via the `IGNORE` sentinel object, Apollo Client caches this temporary
110
+ * (and potentially incorrect) response until the mutation completes, enabling
111
+ * more responsive UI updates.
112
+ *
113
+ * For more information, see [Optimistic mutation results](https://www.apollographql.com/docs/react/performance/optimistic-ui/).
114
+ *
115
+ * @docGroup 3. Caching options
116
+ */
117
+ optimisticResponse?: Unmasked<NoInfer<TData>> | ((vars: TVariables, { IGNORE }: {
118
+ IGNORE: IgnoreModifier;
119
+ }) => Unmasked<NoInfer<TData>> | IgnoreModifier);
120
+ /**
121
+ * A `MutationQueryReducersMap`, which is map from query names to
122
+ * mutation query reducers. Briefly, this map defines how to incorporate the
123
+ * results of the mutation into the results of queries that are currently
124
+ * being watched by your application.
125
+ */
126
+ updateQueries?: MutationQueryReducersMap<TData>;
127
+ /**
128
+ * An array (or a function that _returns_ an array) that specifies which queries you want to refetch after the mutation occurs.
129
+ *
130
+ * Each array value can be either:
131
+ *
132
+ * - An object containing the `query` to execute, along with any `variables`
133
+ *
134
+ * - A string indicating the operation name of the query to refetch
135
+ *
136
+ * @docGroup 1. Operation options
137
+ */
138
+ refetchQueries?: ((result: NormalizedExecutionResult<Unmasked<TData>>) => InternalRefetchQueriesInclude) | InternalRefetchQueriesInclude;
139
+ /**
140
+ * If `true`, makes sure all queries included in `refetchQueries` are completed before the mutation is considered complete.
141
+ *
142
+ * The default value is `false` (queries are refetched asynchronously).
143
+ *
144
+ * @docGroup 1. Operation options
145
+ */
146
+ awaitRefetchQueries?: boolean;
147
+ /**
148
+ * A function used to update the Apollo Client cache after the mutation completes.
149
+ *
150
+ * For more information, see [Updating the cache after a mutation](https://www.apollographql.com/docs/react/data/mutations#updating-the-cache-after-a-mutation).
151
+ *
152
+ * @docGroup 3. Caching options
153
+ */
154
+ update?: MutationUpdaterFunction<TData, TVariables, TCache>;
155
+ /**
156
+ * 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`.
157
+ *
158
+ * Returning a `Promise` from `onQueryUpdated` will cause the final mutation `Promise` to await the returned `Promise`. Returning `false` causes the query to be ignored.
159
+ *
160
+ * @docGroup 1. Operation options
161
+ */
162
+ onQueryUpdated?: OnQueryUpdated<any>;
163
+ /**
164
+ * Specifies how the mutation handles a response that returns both GraphQL errors and partial results.
165
+ *
166
+ * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
167
+ *
168
+ * The default value is `none`, meaning that the mutation result includes error details but _not_ partial results.
169
+ *
170
+ * @docGroup 1. Operation options
171
+ */
172
+ errorPolicy?: ErrorPolicy;
173
+ /**
174
+ * 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.
175
+ *
176
+ * @docGroup 2. Networking options
177
+ */
178
+ context?: DefaultContext;
179
+ /**
180
+ * Provide `no-cache` if the mutation's result should _not_ be written to the Apollo Client cache.
181
+ *
182
+ * The default value is `network-only` (which means the result _is_ written to the cache).
183
+ *
184
+ * 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`.
185
+ *
186
+ * @docGroup 3. Caching options
187
+ */
188
+ fetchPolicy?: MutationFetchPolicy;
189
+ /**
190
+ * To avoid retaining sensitive information from mutation root field
191
+ * arguments, Apollo Client v3.4+ automatically clears any `ROOT_MUTATION`
192
+ * fields from the cache after each mutation finishes. If you need this
193
+ * information to remain in the cache, you can prevent the removal by passing
194
+ * `keepRootFields: true` to the mutation. `ROOT_MUTATION` result data are
195
+ * also passed to the mutation `update` function, so we recommend obtaining
196
+ * the results that way, rather than using this option, if possible.
197
+ */
198
+ keepRootFields?: boolean;
199
+ /**
200
+ * A GraphQL document, often created with `gql` from the `graphql-tag`
201
+ * package, that contains a single mutation inside of it.
202
+ *
203
+ * @docGroup 1. Operation options
204
+ */
205
+ mutation: DocumentNode | TypedDocumentNode<TData, TVariables>;
206
+ } & VariablesOption<NoInfer<TVariables>>;
207
+ interface MutateResult<TData = unknown> {
208
+ /**
209
+ * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
210
+ */
211
+ data: TData | undefined;
212
+ /**
213
+ * 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`.
214
+ *
215
+ * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
216
+ */
217
+ error?: ErrorLike;
218
+ /**
219
+ * Custom extensions returned from the GraphQL server
220
+ */
221
+ extensions?: Record<string, unknown>;
222
+ }
40
223
  /**
41
- * The cache that Apollo Client should use to store query results locally. The recommended cache is `InMemoryCache`, which is provided by the `@apollo/client` package.
42
- *
43
- * For more information, see [Configuring the cache](https://www.apollographql.com/docs/react/caching/cache-configuration/).
224
+ * Query options.
44
225
  */
45
- cache: ApolloCache;
226
+ type QueryOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables> = {
227
+ /**
228
+ * A GraphQL query string parsed into an AST with the gql template literal.
229
+ *
230
+ * @docGroup 1. Operation options
231
+ */
232
+ query: DocumentNode | TypedDocumentNode<TData, TVariables>;
233
+ /**
234
+ * Specifies how the query handles a response that returns both GraphQL errors and partial results.
235
+ *
236
+ * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
237
+ *
238
+ * The default value is `none`, meaning that the query result includes error details but not partial results.
239
+ *
240
+ * @docGroup 1. Operation options
241
+ */
242
+ errorPolicy?: ErrorPolicy;
243
+ /**
244
+ * 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.
245
+ *
246
+ * @docGroup 2. Networking options
247
+ */
248
+ context?: DefaultContext;
249
+ /**
250
+ * Specifies how the query interacts with the Apollo Client cache during execution (for example, whether it checks the cache for results before sending a request to the server).
251
+ *
252
+ * For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
253
+ *
254
+ * The default value is `cache-first`.
255
+ *
256
+ * @docGroup 3. Caching options
257
+ */
258
+ fetchPolicy?: FetchPolicy;
259
+ } & VariablesOption<NoInfer<TVariables>>;
260
+ interface QueryResult<TData = unknown> {
261
+ /**
262
+ * An object containing the result of your GraphQL query after it completes.
263
+ *
264
+ * This value might be `undefined` if a query results in one or more errors (depending on the query's `errorPolicy`).
265
+ *
266
+ * @docGroup 1. Operation data
267
+ */
268
+ data: TData | undefined;
269
+ /**
270
+ * A single ErrorLike object describing the error that occured during the latest
271
+ * query execution.
272
+ *
273
+ * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
274
+ *
275
+ * @docGroup 1. Operation data
276
+ */
277
+ error?: ErrorLike;
278
+ }
46
279
  /**
47
- * The time interval (in milliseconds) before Apollo Client force-fetches queries after a server-side render.
48
- *
49
- * @defaultValue `0` (no delay)
50
- */
51
- ssrForceFetchDelay?: number;
52
- /**
53
- * When using Apollo Client for [server-side rendering](https://www.apollographql.com/docs/react/performance/server-side-rendering/), set this to `true` so that the [`getDataFromTree` function](../react/ssr/#getdatafromtree) can work effectively.
54
- *
55
- * @defaultValue `false`
56
- */
57
- ssrMode?: boolean;
58
- /**
59
- * If `false`, Apollo Client sends every created query to the server, even if a _completely_ identical query (identical in terms of query string, variable values, and operationName) is already in flight.
60
- *
61
- * @defaultValue `true`
62
- */
63
- queryDeduplication?: boolean;
64
- /**
65
- * Provide this object to set application-wide default values for options you can provide to the `watchQuery`, `query`, and `mutate` functions. See below for an example object.
66
- *
67
- * See this [example object](https://www.apollographql.com/docs/react/api/core/ApolloClient#example-defaultoptions-object).
68
- */
69
- defaultOptions?: DefaultOptions;
70
- defaultContext?: Partial<DefaultContext>;
71
- /**
72
- * If `true`, Apollo Client will assume results read from the cache are never mutated by application code, which enables substantial performance optimizations.
73
- *
74
- * @defaultValue `false`
75
- */
76
- assumeImmutableResults?: boolean;
77
- localState?: LocalState;
78
- /**
79
- *
80
- */
81
- clientAwareness?: ClientAwarenessLink.ClientAwarenessOptions;
82
- /**
83
- *
84
- */
85
- enhancedClientAwareness?: ClientAwarenessLink.EnhancedClientAwarenessOptions;
86
- documentTransform?: DocumentTransform;
87
- /**
88
- * Configuration used by the [Apollo Client Devtools extension](https://www.apollographql.com/docs/react/development-testing/developer-tooling/#apollo-client-devtools) for this client.
89
- *
90
- * @since 3.11.0
280
+ * Options object for the `client.refetchQueries` method.
91
281
  */
92
- devtools?: DevtoolsOptions;
282
+ interface RefetchQueriesOptions<TCache extends ApolloCache, TResult> {
283
+ /**
284
+ * Optional function that updates cached fields to trigger refetches of queries that include those fields.
285
+ */
286
+ updateCache?: (cache: TCache) => void;
287
+ /**
288
+ * Optional array specifying queries to refetch. Each element can be either a query's string name or a `DocumentNode` object.
289
+ *
290
+ * Pass `"active"` as a shorthand to refetch all active queries, or `"all"` to refetch all active and inactive queries.
291
+ *
292
+ * Analogous to the [`options.refetchQueries`](https://www.apollographql.com/docs/react/data/mutations/#options) array for mutations.
293
+ */
294
+ include?: RefetchQueriesInclude;
295
+ /**
296
+ * If `true`, the `options.updateCache` function is executed on a temporary optimistic layer of `InMemoryCache`, so its modifications can be discarded from the cache after observing which fields it invalidated.
297
+ *
298
+ * Defaults to `false`, meaning `options.updateCache` updates the cache in a lasting way.
299
+ */
300
+ optimistic?: boolean;
301
+ /**
302
+ * Optional callback function that's called once for each `ObservableQuery` that's either affected by `options.updateCache` or listed in `options.include` (or both).
303
+ *
304
+ * If `onQueryUpdated` is not provided, the default implementation returns the result of calling `observableQuery.refetch()`. When `onQueryUpdated` is provided, it can dynamically decide whether (and how) each query should be refetched.
305
+ *
306
+ * Returning `false` from `onQueryUpdated` prevents the associated query from being refetched.
307
+ */
308
+ onQueryUpdated?: OnQueryUpdated<TResult> | null;
309
+ }
93
310
  /**
94
- * Determines if data masking is enabled for the client.
95
- *
96
- * @defaultValue false
311
+ * The result of client.refetchQueries is thenable/awaitable, if you just want
312
+ * an array of fully resolved results, but you can also access the raw results
313
+ * immediately by examining the additional `queries` and `results` properties of
314
+ * the `RefetchQueriesResult<TResult> object`.
97
315
  */
98
- dataMasking?: boolean;
316
+ interface RefetchQueriesResult<TResult> extends Promise<RefetchQueriesPromiseResults<TResult>>, RefetchQueriesResult.AdditionalProperties<TResult> {
317
+ }
318
+ namespace RefetchQueriesResult {
319
+ interface AdditionalProperties<TResult> {
320
+ /**
321
+ * An array of ObservableQuery objects corresponding 1:1 to TResult values
322
+ * in the results arrays (both the `result` property and the resolved value).
323
+ */
324
+ queries: ObservableQuery<any>[];
325
+ /**
326
+ * An array of results that were either returned by `onQueryUpdated`, or provided by default in the absence of `onQueryUpdated`, including pending promises.
327
+ *
328
+ * If `onQueryUpdated` returns `false` for a given query, no result is provided for that query.
329
+ *
330
+ * If `onQueryUpdated` returns `true`, the resulting `Promise<ApolloQueryResult<any>>` is included in the `results` array instead of `true`.
331
+ */
332
+ results: InternalRefetchQueriesResult<TResult>[];
333
+ }
334
+ }
335
+ type SubscribeOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables> = {
336
+ /**
337
+ * A GraphQL document, often created with `gql` from the `graphql-tag`
338
+ * package, that contains a single subscription inside of it.
339
+ */
340
+ query: DocumentNode | TypedDocumentNode<TData, TVariables>;
341
+ /**
342
+ * How you want your component to interact with the Apollo cache. For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
343
+ */
344
+ fetchPolicy?: FetchPolicy;
345
+ /**
346
+ * Specifies the `ErrorPolicy` to be used for this operation
347
+ */
348
+ errorPolicy?: ErrorPolicy;
349
+ /**
350
+ * Shared context between your component and your network interface (Apollo Link).
351
+ */
352
+ context?: DefaultContext;
353
+ /**
354
+ * Shared context between your component and your network interface (Apollo Link).
355
+ */
356
+ extensions?: Record<string, any>;
357
+ } & VariablesOption<NoInfer<TVariables>>;
358
+ interface SubscribeResult<TData = unknown> {
359
+ /**
360
+ * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
361
+ */
362
+ data: TData | undefined;
363
+ /**
364
+ * 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`.
365
+ *
366
+ * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
367
+ */
368
+ error?: ErrorLike;
369
+ /**
370
+ * Custom extensions returned from the GraphQL server
371
+ */
372
+ extensions?: Record<string, unknown>;
373
+ }
374
+ type WatchFragmentOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables> = ApolloCache.WatchFragmentOptions<TData, TVariables>;
375
+ type WatchFragmentResult<TData = unknown> = ApolloCache.WatchFragmentResult<TData>;
99
376
  /**
100
- * Determines the strategy used to parse incremental chunks from `@defer`
101
- * queries.
377
+ * Watched query options.
102
378
  */
103
- incrementalHandler?: Incremental.Handler<any>;
379
+ type WatchQueryOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables> = {
380
+ /**
381
+ * Specifies how the query interacts with the Apollo Client cache during execution (for example, whether it checks the cache for results before sending a request to the server).
382
+ *
383
+ * For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
384
+ *
385
+ * The default value is `cache-first`.
386
+ *
387
+ * @docGroup 3. Caching options
388
+ */
389
+ fetchPolicy?: WatchQueryFetchPolicy;
390
+ /**
391
+ * Specifies the `FetchPolicy` to be used after this query has completed.
392
+ *
393
+ * @docGroup 3. Caching options
394
+ */
395
+ nextFetchPolicy?: WatchQueryFetchPolicy | ((this: WatchQueryOptions<TData, TVariables>, currentFetchPolicy: WatchQueryFetchPolicy, context: NextFetchPolicyContext<TData, TVariables>) => WatchQueryFetchPolicy);
396
+ /**
397
+ * Defaults to the initial value of options.fetchPolicy, but can be explicitly
398
+ * configured to specify the WatchQueryFetchPolicy to revert back to whenever
399
+ * variables change (unless nextFetchPolicy intervenes).
400
+ *
401
+ * @docGroup 3. Caching options
402
+ */
403
+ initialFetchPolicy?: WatchQueryFetchPolicy;
404
+ /**
405
+ * Specifies whether a `NetworkStatus.refetch` operation should merge
406
+ * incoming field data with existing data, or overwrite the existing data.
407
+ * Overwriting is probably preferable, but merging is currently the default
408
+ * behavior, for backwards compatibility with Apollo Client 3.x.
409
+ *
410
+ * @docGroup 3. Caching options
411
+ */
412
+ refetchWritePolicy?: RefetchWritePolicy;
413
+ /**
414
+ * Specifies how the query handles a response that returns both GraphQL errors and partial results.
415
+ *
416
+ * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
417
+ *
418
+ * The default value is `none`, meaning that the query result includes error details but not partial results.
419
+ *
420
+ * @docGroup 1. Operation options
421
+ */
422
+ errorPolicy?: ErrorPolicy;
423
+ /**
424
+ * 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.
425
+ *
426
+ * @docGroup 2. Networking options
427
+ */
428
+ context?: DefaultContext;
429
+ /**
430
+ * Specifies the interval (in milliseconds) at which the query polls for updated results.
431
+ *
432
+ * The default value is `0` (no polling).
433
+ *
434
+ * @docGroup 2. Networking options
435
+ */
436
+ pollInterval?: number;
437
+ /**
438
+ * If `true`, the in-progress query's associated component re-renders whenever the network status changes or a network error occurs.
439
+ *
440
+ * The default value is `true`.
441
+ *
442
+ * @docGroup 2. Networking options
443
+ */
444
+ notifyOnNetworkStatusChange?: boolean;
445
+ /**
446
+ * If `true`, the query can return partial results from the cache if the cache doesn't contain results for all queried fields.
447
+ *
448
+ * The default value is `false`.
449
+ *
450
+ * @docGroup 3. Caching options
451
+ */
452
+ returnPartialData?: boolean;
453
+ /**
454
+ * A callback function that's called whenever a refetch attempt occurs
455
+ * while polling. If the function returns `true`, the refetch is
456
+ * skipped and not reattempted until the next poll interval.
457
+ *
458
+ * @docGroup 2. Networking options
459
+ */
460
+ skipPollAttempt?: () => boolean;
461
+ /**
462
+ * A GraphQL query string parsed into an AST with the gql template literal.
463
+ *
464
+ * @docGroup 1. Operation options
465
+ */
466
+ query: DocumentNode | TypedDocumentNode<TData, TVariables>;
467
+ } & VariablesOption<NoInfer<TVariables>>;
468
+ namespace Base {
469
+ interface ReadQueryOptions<TData, TVariables extends OperationVariables> {
470
+ /**
471
+ * The GraphQL query shape to be used constructed using the `gql` template
472
+ * string tag. The query will be used to determine the
473
+ * shape of the data to be read.
474
+ */
475
+ query: DocumentNode | TypedDocumentNode<TData, TVariables>;
476
+ /**
477
+ * The root id to be used. Defaults to "ROOT_QUERY", which is the ID of the
478
+ * root query object. This property makes `readQuery` capable of reading data
479
+ * from any object in the cache.
480
+ */
481
+ id?: string;
482
+ /**
483
+ * Whether to return incomplete data rather than null.
484
+ * @defaultValue false
485
+ */
486
+ returnPartialData?: boolean;
487
+ /**
488
+ * Whether to read from optimistic or non-optimistic cache data.
489
+ * This option should be preferred over the `optimistic` parameter of the
490
+ * `readQuery` method.
491
+ * @defaultValue false
492
+ */
493
+ optimistic?: boolean;
494
+ }
495
+ }
496
+ type ReadQueryOptions<TData, TVariables extends OperationVariables> = Base.ReadQueryOptions<TData, TVariables> & VariablesOption<TVariables>;
497
+ namespace DocumentationTypes {
498
+ interface ReadQueryOptions<TData, TVariables extends OperationVariables> extends Base.ReadQueryOptions<TData, TVariables> {
499
+ /**
500
+ * Any variables that the GraphQL query may depend on.
501
+ */
502
+ variables?: TVariables;
503
+ }
504
+ }
505
+ namespace Base {
506
+ interface ReadFragmentOptions<TData, TVariables extends OperationVariables> {
507
+ /**
508
+ * The root id to be used. This id should take the same form as the
509
+ * value returned by the `cache.identify` function. If a value with your
510
+ * id does not exist in the store, `null` will be returned.
511
+ */
512
+ id?: string;
513
+ /**
514
+ * A GraphQL document created using the `gql` template string tag
515
+ * with one or more fragments which will be used to determine
516
+ * the shape of data to read. If you provide more than one fragment in this
517
+ * document then you must also specify `fragmentName` to specify which
518
+ * fragment is the root fragment.
519
+ */
520
+ fragment: DocumentNode | TypedDocumentNode<TData, TVariables>;
521
+ /**
522
+ * The name of the fragment in your GraphQL document to be used. If you do
523
+ * not provide a `fragmentName` and there is only one fragment in your
524
+ * `fragment` document then that fragment will be used.
525
+ */
526
+ fragmentName?: string;
527
+ /**
528
+ * Whether to return incomplete data rather than null.
529
+ * @defaultValue false
530
+ */
531
+ returnPartialData?: boolean;
532
+ /**
533
+ * Whether to read from optimistic or non-optimistic cache data.
534
+ * This option should be preferred over the `optimistic` parameter of the
535
+ * `readFragment` method.
536
+ * @defaultValue false
537
+ */
538
+ optimistic?: boolean;
539
+ }
540
+ }
541
+ type ReadFragmentOptions<TData, TVariables extends OperationVariables> = Base.ReadFragmentOptions<TData, TVariables> & VariablesOption<TVariables>;
542
+ namespace DocumentationTypes {
543
+ interface WriteQueryOptions<TData, TVariables extends OperationVariables> extends Base.WriteQueryOptions<TData, TVariables> {
544
+ /**
545
+ * Any variables that your GraphQL fragments depend on.
546
+ */
547
+ variables?: TVariables;
548
+ }
549
+ }
550
+ namespace Base {
551
+ interface WriteQueryOptions<TData, TVariables extends OperationVariables> {
552
+ /**
553
+ * The GraphQL query shape to be used constructed using the `gql` template
554
+ * string tag. The query will be used to determine the
555
+ * shape of the data to be read.
556
+ */
557
+ query: DocumentNode | TypedDocumentNode<TData, TVariables>;
558
+ /**
559
+ * The root id to be used. Defaults to "ROOT_QUERY", which is the ID of the
560
+ * root query object. This property makes writeQuery capable of writing data
561
+ * to any object in the cache.
562
+ */
563
+ id?: string;
564
+ /**
565
+ * The data to write to the store.
566
+ */
567
+ data: Unmasked<TData>;
568
+ /**
569
+ * Whether to notify query watchers.
570
+ * @defaultValue true
571
+ */
572
+ broadcast?: boolean;
573
+ /**
574
+ * When true, ignore existing field data rather than merging it with
575
+ * incoming data.
576
+ * @defaultValue false
577
+ */
578
+ overwrite?: boolean;
579
+ }
580
+ }
581
+ type WriteQueryOptions<TData, TVariables extends OperationVariables> = Base.WriteQueryOptions<TData, TVariables> & VariablesOption<TVariables>;
582
+ namespace DocumentationTypes {
583
+ interface WriteQueryOptions<TData, TVariables extends OperationVariables> extends Base.WriteQueryOptions<TData, TVariables> {
584
+ /**
585
+ * Any variables that the GraphQL query may depend on.
586
+ */
587
+ variables?: TVariables;
588
+ }
589
+ }
590
+ namespace Base {
591
+ interface WriteFragmentOptions<TData, TVariables extends OperationVariables> {
592
+ /**
593
+ * The root id to be used. This id should take the same form as the
594
+ * value returned by the `cache.identify` function. If a value with your
595
+ * id does not exist in the store, `null` will be returned.
596
+ */
597
+ id?: string;
598
+ /**
599
+ * A GraphQL document created using the `gql` template string tag from
600
+ * `graphql-tag` with one or more fragments which will be used to determine
601
+ * the shape of data to read. If you provide more than one fragment in this
602
+ * document then you must also specify `fragmentName` to specify which
603
+ * fragment is the root fragment.
604
+ */
605
+ fragment: DocumentNode | TypedDocumentNode<TData, TVariables>;
606
+ /**
607
+ * The name of the fragment in your GraphQL document to be used. If you do
608
+ * not provide a `fragmentName` and there is only one fragment in your
609
+ * `fragment` document then that fragment will be used.
610
+ */
611
+ fragmentName?: string;
612
+ /**
613
+ * The data to write to the store.
614
+ */
615
+ data: Unmasked<TData>;
616
+ /**
617
+ * Whether to notify query watchers.
618
+ * @defaultValue true
619
+ */
620
+ broadcast?: boolean;
621
+ /**
622
+ * When true, ignore existing field data rather than merging it with
623
+ * incoming data.
624
+ * @defaultValue false
625
+ */
626
+ overwrite?: boolean;
627
+ }
628
+ }
629
+ type WriteFragmentOptions<TData, TVariables extends OperationVariables> = Base.WriteFragmentOptions<TData, TVariables> & VariablesOption<TVariables>;
630
+ namespace DocumentationTypes {
631
+ interface WriteFragmentOptions<TData, TVariables extends OperationVariables> extends Base.WriteFragmentOptions<TData, TVariables> {
632
+ /**
633
+ * Any variables that your GraphQL fragments depend on.
634
+ */
635
+ variables?: TVariables;
636
+ }
637
+ }
104
638
  }
105
639
  /**
106
640
  * This is the primary Apollo Client class. It is used to send GraphQL documents (i.e. queries
@@ -108,7 +642,7 @@ export interface ApolloClientOptions {
108
642
  * receive results from the server and cache the results in a store. It also delivers updates
109
643
  * to GraphQL queries through `Observable` instances.
110
644
  */
111
- export declare class ApolloClient implements DataProxy {
645
+ export declare class ApolloClient {
112
646
  link: ApolloLink;
113
647
  cache: ApolloCache;
114
648
  /**
@@ -126,8 +660,8 @@ export declare class ApolloClient implements DataProxy {
126
660
  get prioritizeCacheValues(): boolean;
127
661
  version: string;
128
662
  queryDeduplication: boolean;
129
- defaultOptions: DefaultOptions;
130
- readonly devtoolsConfig: DevtoolsOptions;
663
+ defaultOptions: ApolloClient.DefaultOptions;
664
+ readonly devtoolsConfig: ApolloClient.DevtoolsOptions;
131
665
  private queryManager;
132
666
  private devToolsHookCb?;
133
667
  private resetStoreCallbacks;
@@ -136,29 +670,30 @@ export declare class ApolloClient implements DataProxy {
136
670
  * Constructs an instance of `ApolloClient`.
137
671
  *
138
672
  * @example
673
+ *
139
674
  * ```js
140
- * import { ApolloClient, InMemoryCache } from '@apollo/client';
675
+ * import { ApolloClient, InMemoryCache } from "@apollo/client";
141
676
  *
142
677
  * const cache = new InMemoryCache();
143
678
  *
144
679
  * const client = new ApolloClient({
145
680
  * // Provide required constructor fields
146
681
  * cache: cache,
147
- * uri: 'http://localhost:4000/',
682
+ * uri: "http://localhost:4000/",
148
683
  *
149
684
  * // Provide some optional constructor fields
150
- * name: 'react-web-client',
151
- * version: '1.3',
685
+ * name: "react-web-client",
686
+ * version: "1.3",
152
687
  * queryDeduplication: false,
153
688
  * defaultOptions: {
154
689
  * watchQuery: {
155
- * fetchPolicy: 'cache-and-network',
690
+ * fetchPolicy: "cache-and-network",
156
691
  * },
157
692
  * },
158
693
  * });
159
694
  * ```
160
695
  */
161
- constructor(options: ApolloClientOptions);
696
+ constructor(options: ApolloClient.Options);
162
697
  private connectToDevTools;
163
698
  /**
164
699
  * The `DocumentTransform` used to modify GraphQL documents before a request
@@ -175,6 +710,12 @@ export declare class ApolloClient implements DataProxy {
175
710
  /**
176
711
  * Call this method to terminate any active client processes, making it safe
177
712
  * to dispose of this `ApolloClient` instance.
713
+ *
714
+ * This method performs aggressive cleanup to prevent memory leaks:
715
+ *
716
+ * - Unsubscribes all active `ObservableQuery` instances by emitting a `completed` event
717
+ * - Rejects all currently running queries with "QueryManager stopped while query was in flight"
718
+ * - Removes all queryRefs from the suspense cache
178
719
  */
179
720
  stop(): void;
180
721
  /**
@@ -187,16 +728,16 @@ export declare class ApolloClient implements DataProxy {
187
728
  *
188
729
  * For example, suppose you call watchQuery on a GraphQL query that fetches a person's
189
730
  * first and last name and this person has a particular object identifier, provided by
190
- * dataIdFromObject. Later, a different query fetches that same person's
731
+ * `cache.identify`. Later, a different query fetches that same person's
191
732
  * first and last name and the first name has now changed. Then, any observers associated
192
733
  * with the results of the first query will be updated with a new result object.
193
734
  *
194
- * Note that if the cache does not change, the subscriber will *not* be notified.
735
+ * Note that if the cache does not change, the subscriber will _not_ be notified.
195
736
  *
196
737
  * See [here](https://medium.com/apollo-stack/the-concepts-of-graphql-bc68bd819be3#.3mb0cbcmc) for
197
738
  * a description of store reactivity.
198
739
  */
199
- watchQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: WatchQueryOptions<TVariables, TData>): ObservableQuery<TData, TVariables>;
740
+ watchQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.WatchQueryOptions<TData, TVariables>): ObservableQuery<TData, TVariables>;
200
741
  /**
201
742
  * This resolves a single query according to the options specified and
202
743
  * returns a `Promise` which is either resolved with the resulting data
@@ -206,7 +747,7 @@ export declare class ApolloClient implements DataProxy {
206
747
  * describe how this query should be treated e.g. whether it should hit the
207
748
  * server at all or just resolve from the cache, etc.
208
749
  */
209
- query<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: QueryOptions<TVariables, TData>): Promise<QueryResult<MaybeMasked<TData>>>;
750
+ query<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.QueryOptions<TData, TVariables>): Promise<ApolloClient.QueryResult<MaybeMasked<TData>>>;
210
751
  /**
211
752
  * This resolves a single mutation according to the options specified and returns a
212
753
  * Promise which is either resolved with the resulting data or rejected with an
@@ -215,22 +756,41 @@ export declare class ApolloClient implements DataProxy {
215
756
  *
216
757
  * It takes options as an object with the following keys and values:
217
758
  */
218
- mutate<TData = unknown, TVariables extends OperationVariables = OperationVariables, TCache extends ApolloCache = ApolloCache>(options: MutationOptions<TData, TVariables, TCache>): Promise<MutateResult<MaybeMasked<TData>>>;
759
+ mutate<TData = unknown, TVariables extends OperationVariables = OperationVariables, TCache extends ApolloCache = ApolloCache>(options: ApolloClient.MutateOptions<TData, TVariables, TCache>): Promise<ApolloClient.MutateResult<MaybeMasked<TData>>>;
219
760
  /**
220
761
  * This subscribes to a graphql subscription according to the options specified and returns an
221
762
  * `Observable` which either emits received data or an error.
222
763
  */
223
- subscribe<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: SubscriptionOptions<TVariables, TData>): SubscriptionObservable<SubscribeResult<MaybeMasked<TData>>>;
764
+ subscribe<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.SubscribeOptions<TData, TVariables>): SubscriptionObservable<ApolloClient.SubscribeResult<MaybeMasked<TData>>>;
224
765
  /**
225
766
  * Tries to read some data from the store in the shape of the provided
226
767
  * GraphQL query without making a network request. This method will start at
227
- * the root query. To start at a specific id returned by `dataIdFromObject`
768
+ * the root query. To start at a specific id returned by `cache.identify`
228
769
  * use `readFragment`.
229
770
  *
230
771
  * @param optimistic - Set to `true` to allow `readQuery` to return
231
772
  * optimistic results. Is `false` by default.
232
773
  */
233
- readQuery<TData = unknown, TVariables = OperationVariables>(options: DataProxy.Query<TVariables, TData>, optimistic?: boolean): Unmasked<TData> | null;
774
+ readQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.ReadQueryOptions<TData, TVariables>): Unmasked<TData> | null;
775
+ /**
776
+ * Tries to read some data from the store in the shape of the provided
777
+ * GraphQL query without making a network request. This method will start at
778
+ * the root query. To start at a specific id returned by `cache.identify`
779
+ * use `readFragment`.
780
+ *
781
+ * @param optimistic - Set to `true` to allow `readQuery` to return
782
+ * optimistic results. Is `false` by default.
783
+ *
784
+ *
785
+ * @deprecated Pass the `optimistic` argument as part of the first argument
786
+ * instead of passing it as a separate option.
787
+ */
788
+ readQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.ReadQueryOptions<TData, TVariables>,
789
+ /**
790
+ * @deprecated Pass the `optimistic` argument as part of the first argument
791
+ * instead of passing it as a separate option.
792
+ */
793
+ optimistic: boolean): Unmasked<TData> | null;
234
794
  /**
235
795
  * Watches the cache store of the fragment according to the options specified
236
796
  * and returns an `Observable`. We can subscribe to this
@@ -247,7 +807,7 @@ export declare class ApolloClient implements DataProxy {
247
807
  * the cache to identify the fragment and optionally specify whether to react
248
808
  * to optimistic updates.
249
809
  */
250
- watchFragment<TData = unknown, TVariables = OperationVariables>(options: WatchFragmentOptions<TData, TVariables>): Observable<WatchFragmentResult<TData>>;
810
+ watchFragment<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.WatchFragmentOptions<TData, TVariables>): Observable<ApolloClient.WatchFragmentResult<MaybeMasked<TData>>>;
251
811
  /**
252
812
  * Tries to read some data from the store in the shape of the provided
253
813
  * GraphQL fragment without making a network request. This method will read a
@@ -262,13 +822,32 @@ export declare class ApolloClient implements DataProxy {
262
822
  * @param optimistic - Set to `true` to allow `readFragment` to return
263
823
  * optimistic results. Is `false` by default.
264
824
  */
265
- readFragment<T = unknown, TVariables = OperationVariables>(options: DataProxy.Fragment<TVariables, T>, optimistic?: boolean): Unmasked<T> | null;
825
+ readFragment<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.ReadFragmentOptions<TData, TVariables>): Unmasked<TData> | null;
826
+ /**
827
+ * Tries to read some data from the store in the shape of the provided
828
+ * GraphQL fragment without making a network request. This method will read a
829
+ * GraphQL fragment from any arbitrary id that is currently cached, unlike
830
+ * `readQuery` which will only read from the root query.
831
+ *
832
+ * You must pass in a GraphQL document with a single fragment or a document
833
+ * with multiple fragments that represent what you are reading. If you pass
834
+ * in a document with multiple fragments then you must also specify a
835
+ * `fragmentName`.
836
+ *
837
+ * @param optimistic - Set to `true` to allow `readFragment` to return
838
+ * optimistic results. Is `false` by default.
839
+ *
840
+ *
841
+ * @deprecated Pass the `optimistic` argument as part of the first argument
842
+ * instead of passing it as a separate option.
843
+ */
844
+ readFragment<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.ReadFragmentOptions<TData, TVariables>, optimistic: boolean): Unmasked<TData> | null;
266
845
  /**
267
846
  * Writes some data in the shape of the provided GraphQL query directly to
268
847
  * the store. This method will start at the root query. To start at a
269
- * specific id returned by `dataIdFromObject` then use `writeFragment`.
848
+ * specific id returned by `cache.identify` then use `writeFragment`.
270
849
  */
271
- writeQuery<TData = unknown, TVariables = OperationVariables>(options: DataProxy.WriteQueryOptions<TData, TVariables>): Reference | undefined;
850
+ writeQuery<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.WriteQueryOptions<TData, TVariables>): Reference | undefined;
272
851
  /**
273
852
  * Writes some data in the shape of the provided GraphQL fragment directly to
274
853
  * the store. This method will write to a GraphQL fragment from any arbitrary
@@ -280,9 +859,9 @@ export declare class ApolloClient implements DataProxy {
280
859
  * in a document with multiple fragments then you must also specify a
281
860
  * `fragmentName`.
282
861
  */
283
- writeFragment<TData = unknown, TVariables = OperationVariables>(options: DataProxy.WriteFragmentOptions<TData, TVariables>): Reference | undefined;
862
+ writeFragment<TData = unknown, TVariables extends OperationVariables = OperationVariables>(options: ApolloClient.WriteFragmentOptions<TData, TVariables>): Reference | undefined;
284
863
  __actionHookForDevTools(cb: () => any): void;
285
- __requestRaw(payload: GraphQLRequest): Observable<FetchResult<unknown>>;
864
+ __requestRaw(request: ApolloLink.Request): Observable<ApolloLink.Result<unknown>>;
286
865
  /**
287
866
  * Resets your entire store by clearing out your cache and then re-executing
288
867
  * all of your active queries. This makes it so that you may guarantee that
@@ -293,13 +872,13 @@ export declare class ApolloClient implements DataProxy {
293
872
  * user session, and you now want to make sure that any references to data you
294
873
  * might have fetched while the user session was active is gone.
295
874
  *
296
- * It is important to remember that `resetStore()` *will* refetch any active
875
+ * It is important to remember that `resetStore()` _will_ refetch any active
297
876
  * queries. This means that any components that might be mounted will execute
298
877
  * their queries again using your network interface. If you do not want to
299
878
  * re-execute any queries then you should make sure to stop watching any
300
879
  * active queries.
301
880
  */
302
- resetStore(): Promise<QueryResult<any>[] | null>;
881
+ resetStore(): Promise<ApolloClient.QueryResult<any>[] | null>;
303
882
  /**
304
883
  * Remove all data from the store. Unlike `resetStore`, `clearStore` will
305
884
  * not refetch any active queries.
@@ -322,29 +901,47 @@ export declare class ApolloClient implements DataProxy {
322
901
  *
323
902
  * `reFetchObservableQueries()` is useful if you want to bring the client back to proper state in case of a network outage
324
903
  *
325
- * It is important to remember that `reFetchObservableQueries()` *will* refetch any active
904
+ * It is important to remember that `reFetchObservableQueries()` _will_ refetch any active
326
905
  * queries. This means that any components that might be mounted will execute
327
906
  * their queries again using your network interface. If you do not want to
328
907
  * re-execute any queries then you should make sure to stop watching any
329
908
  * active queries.
330
909
  * Takes optional parameter `includeStandby` which will include queries in standby-mode when refetching.
910
+ *
911
+ * Note: `cache-only` queries are not refetched by this function.
912
+ *
913
+ * @deprecated Please use `refetchObservableQueries` instead.
331
914
  */
332
- reFetchObservableQueries(includeStandby?: boolean): Promise<QueryResult<any>[]>;
915
+ reFetchObservableQueries: (includeStandby?: boolean) => Promise<ApolloClient.QueryResult<any>[]>;
333
916
  /**
334
- * Refetches specified active queries. Similar to "reFetchObservableQueries()" but with a specific list of queries.
917
+ * Refetches all of your active queries.
918
+ *
919
+ * `refetchObservableQueries()` is useful if you want to bring the client back to proper state in case of a network outage
920
+ *
921
+ * It is important to remember that `refetchObservableQueries()` _will_ refetch any active
922
+ * queries. This means that any components that might be mounted will execute
923
+ * their queries again using your network interface. If you do not want to
924
+ * re-execute any queries then you should make sure to stop watching any
925
+ * active queries.
926
+ * Takes optional parameter `includeStandby` which will include queries in standby-mode when refetching.
927
+ *
928
+ * Note: `cache-only` queries are not refetched by this function.
929
+ */
930
+ refetchObservableQueries(includeStandby?: boolean): Promise<ApolloClient.QueryResult<any>[]>;
931
+ /**
932
+ * Refetches specified active queries. Similar to "refetchObservableQueries()" but with a specific list of queries.
335
933
  *
336
934
  * `refetchQueries()` is useful for use cases to imperatively refresh a selection of queries.
337
935
  *
338
- * It is important to remember that `refetchQueries()` *will* refetch specified active
936
+ * It is important to remember that `refetchQueries()` _will_ refetch specified active
339
937
  * queries. This means that any components that might be mounted will execute
340
938
  * their queries again using your network interface. If you do not want to
341
939
  * re-execute any queries then you should make sure to stop watching any
342
940
  * active queries.
343
941
  */
344
- refetchQueries<TCache extends ApolloCache = ApolloCache, TResult = Promise<QueryResult<any>>>(options: RefetchQueriesOptions<TCache, TResult>): RefetchQueriesResult<TResult>;
942
+ refetchQueries<TCache extends ApolloCache = ApolloCache, TResult = Promise<ApolloClient.QueryResult<any>>>(options: ApolloClient.RefetchQueriesOptions<TCache, TResult>): ApolloClient.RefetchQueriesResult<TResult>;
345
943
  /**
346
- * Get all currently active `ObservableQuery` objects, in a `Map` keyed by
347
- * query ID strings.
944
+ * Get all currently active `ObservableQuery` objects, in a `Set`.
348
945
  *
349
946
  * An "active" query is one that has observers and a `fetchPolicy` other than
350
947
  * "standby" or "cache-only".
@@ -352,6 +949,9 @@ export declare class ApolloClient implements DataProxy {
352
949
  * You can include all `ObservableQuery` objects (including the inactive ones)
353
950
  * by passing "all" instead of "active", or you can include just a subset of
354
951
  * active queries by passing an array of query names or DocumentNode objects.
952
+ *
953
+ * Note: This method only returns queries that have active subscribers. Queries
954
+ * without subscribers are not tracked by the client.
355
955
  */
356
956
  getObservableQueries(include?: RefetchQueriesInclude): Set<ObservableQuery<any>>;
357
957
  /**
@@ -371,6 +971,8 @@ export declare class ApolloClient implements DataProxy {
371
971
  */
372
972
  setLink(newLink: ApolloLink): void;
373
973
  get defaultContext(): Partial<DefaultContext>;
974
+ private maskedFragmentTransform;
975
+ private transform;
374
976
  /**
375
977
  * @experimental
376
978
  * This is not a stable API - it is used in development builds to expose
@@ -379,77 +981,79 @@ export declare class ApolloClient implements DataProxy {
379
981
  * For more details, see [Memory Management](https://www.apollographql.com/docs/react/caching/memory-management/#measuring-cache-usage)
380
982
  *
381
983
  * @example
984
+ *
382
985
  * ```ts
383
- * console.log(client.getMemoryInternals())
986
+ * console.log(client.getMemoryInternals());
384
987
  * ```
988
+ *
385
989
  * Logs output in the following JSON format:
386
990
  * @example
991
+ *
387
992
  * ```json
388
- *{
389
- * limits: {
390
- * canonicalStringify: 1000,
391
- * print: 2000,
392
- * 'documentTransform.cache': 2000,
393
- * 'queryManager.getDocumentInfo': 2000,
394
- * 'PersistedQueryLink.persistedQueryHashes': 2000,
395
- * 'fragmentRegistry.transform': 2000,
396
- * 'fragmentRegistry.lookup': 1000,
397
- * 'fragmentRegistry.findFragmentSpreads': 4000,
398
- * 'cache.fragmentQueryDocuments': 1000,
399
- * 'removeTypenameFromVariables.getVariableDefinitions': 2000,
400
- * 'inMemoryCache.maybeBroadcastWatch': 5000,
401
- * 'inMemoryCache.executeSelectionSet': 10000,
402
- * 'inMemoryCache.executeSubSelectedArray': 5000
403
- * },
404
- * sizes: {
405
- * canonicalStringify: 4,
406
- * print: 14,
407
- * addTypenameDocumentTransform: [
408
- * {
409
- * cache: 14,
410
- * },
411
- * ],
412
- * queryManager: {
413
- * getDocumentInfo: 14,
414
- * documentTransforms: [
415
- * {
416
- * cache: 14,
417
- * },
418
- * {
419
- * cache: 14,
420
- * },
421
- * ],
422
- * },
423
- * fragmentRegistry: {
424
- * findFragmentSpreads: 34,
425
- * lookup: 20,
426
- * transform: 14,
427
- * },
428
- * cache: {
429
- * fragmentQueryDocuments: 22,
430
- * },
431
- * inMemoryCache: {
432
- * executeSelectionSet: 4345,
433
- * executeSubSelectedArray: 1206,
434
- * maybeBroadcastWatch: 32,
435
- * },
436
- * links: [
437
- * {
438
- * PersistedQueryLink: {
439
- * persistedQueryHashes: 14,
440
- * },
441
- * },
442
- * {
443
- * removeTypenameFromVariables: {
444
- * getVariableDefinitions: 14,
445
- * },
446
- * },
447
- * ],
448
- * },
993
+ * {
994
+ * "limits": {
995
+ * "canonicalStringify": 1000,
996
+ * "print": 2000,
997
+ * "documentTransform.cache": 2000,
998
+ * "queryManager.getDocumentInfo": 2000,
999
+ * "PersistedQueryLink.persistedQueryHashes": 2000,
1000
+ * "fragmentRegistry.transform": 2000,
1001
+ * "fragmentRegistry.lookup": 1000,
1002
+ * "fragmentRegistry.findFragmentSpreads": 4000,
1003
+ * "cache.fragmentQueryDocuments": 1000,
1004
+ * "removeTypenameFromVariables.getVariableDefinitions": 2000,
1005
+ * "inMemoryCache.maybeBroadcastWatch": 5000,
1006
+ * "inMemoryCache.executeSelectionSet": 10000,
1007
+ * "inMemoryCache.executeSubSelectedArray": 5000
1008
+ * },
1009
+ * "sizes": {
1010
+ * "canonicalStringify": 4,
1011
+ * "print": 14,
1012
+ * "addTypenameDocumentTransform": [
1013
+ * {
1014
+ * "cache": 14
1015
+ * }
1016
+ * ],
1017
+ * "queryManager": {
1018
+ * "getDocumentInfo": 14,
1019
+ * "documentTransforms": [
1020
+ * {
1021
+ * "cache": 14
1022
+ * },
1023
+ * {
1024
+ * "cache": 14
1025
+ * }
1026
+ * ]
1027
+ * },
1028
+ * "fragmentRegistry": {
1029
+ * "findFragmentSpreads": 34,
1030
+ * "lookup": 20,
1031
+ * "transform": 14
1032
+ * },
1033
+ * "cache": {
1034
+ * "fragmentQueryDocuments": 22
1035
+ * },
1036
+ * "inMemoryCache": {
1037
+ * "executeSelectionSet": 4345,
1038
+ * "executeSubSelectedArray": 1206,
1039
+ * "maybeBroadcastWatch": 32
1040
+ * },
1041
+ * "links": [
1042
+ * {
1043
+ * "PersistedQueryLink": {
1044
+ * "persistedQueryHashes": 14
1045
+ * }
1046
+ * },
1047
+ * {
1048
+ * "removeTypenameFromVariables": {
1049
+ * "getVariableDefinitions": 14
1050
+ * }
1051
+ * }
1052
+ * ]
1053
+ * }
449
1054
  * }
450
- *```
1055
+ * ```
451
1056
  */
452
1057
  getMemoryInternals?: typeof getApolloClientMemoryInternals;
453
1058
  }
454
- export {};
455
1059
  //# sourceMappingURL=ApolloClient.d.ts.map