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