@apollo/client 4.0.0-alpha.1 → 4.0.0-alpha.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (839) hide show
  1. package/.changeset/afraid-moons-arrive.md +5 -0
  2. package/.changeset/beige-mirrors-talk.md +15 -0
  3. package/.changeset/cool-kiwis-hunt.md +15 -0
  4. package/.changeset/cuddly-spiders-tie.md +5 -0
  5. package/.changeset/dirty-eagles-poke.md +5 -0
  6. package/.changeset/early-eggs-develop.md +22 -0
  7. package/.changeset/eighty-squids-fix.md +15 -0
  8. package/.changeset/eleven-kangaroos-jump.md +5 -0
  9. package/.changeset/forty-shrimps-fry.md +5 -0
  10. package/.changeset/forty-tomatoes-punch.md +5 -0
  11. package/.changeset/four-countries-clean.md +24 -0
  12. package/.changeset/four-ghosts-watch.md +5 -0
  13. package/.changeset/funny-jeans-invent.md +16 -0
  14. package/.changeset/funny-terms-deny.md +5 -0
  15. package/.changeset/fuzzy-tips-sit.md +5 -0
  16. package/.changeset/gentle-badgers-train.md +5 -0
  17. package/.changeset/giant-apes-thank.md +5 -0
  18. package/.changeset/giant-bags-share.md +5 -0
  19. package/.changeset/gorgeous-chefs-tap.md +5 -0
  20. package/.changeset/great-roses-jog.md +15 -0
  21. package/.changeset/grumpy-vans-type.md +5 -0
  22. package/.changeset/hip-vans-act.md +5 -0
  23. package/.changeset/hungry-bikes-cough.md +5 -0
  24. package/.changeset/itchy-chefs-run.md +23 -0
  25. package/.changeset/khaki-keys-deliver.md +5 -0
  26. package/.changeset/khaki-spies-work.md +11 -0
  27. package/.changeset/large-plants-know.md +5 -0
  28. package/.changeset/light-apes-rescue.md +5 -0
  29. package/.changeset/little-spoons-kick.md +7 -0
  30. package/.changeset/loud-cows-raise.md +7 -0
  31. package/.changeset/many-buses-allow.md +5 -0
  32. package/.changeset/mean-lizards-think.md +5 -0
  33. package/.changeset/nervous-fireants-bow.md +5 -0
  34. package/.changeset/nervous-goats-allow.md +5 -0
  35. package/.changeset/nice-dots-matter.md +5 -0
  36. package/.changeset/ninety-bags-bake.md +17 -0
  37. package/.changeset/odd-chicken-hide.md +17 -0
  38. package/.changeset/odd-lemons-relax.md +5 -0
  39. package/.changeset/perfect-vans-give.md +7 -0
  40. package/.changeset/poor-eels-punch.md +5 -0
  41. package/.changeset/pre.json +63 -0
  42. package/.changeset/purple-bears-flash.md +5 -0
  43. package/.changeset/real-teachers-peel.md +5 -0
  44. package/.changeset/serious-moons-juggle.md +5 -0
  45. package/.changeset/seven-dragons-repair.md +14 -0
  46. package/.changeset/shaggy-pugs-add.md +52 -0
  47. package/.changeset/short-months-complain.md +5 -0
  48. package/.changeset/slimy-chicken-melt.md +5 -0
  49. package/.changeset/slimy-maps-press.md +5 -0
  50. package/.changeset/small-buttons-rhyme.md +5 -0
  51. package/.changeset/swift-rivers-share.md +13 -0
  52. package/.changeset/tall-bikes-develop.md +5 -0
  53. package/.changeset/tame-points-work.md +11 -0
  54. package/.changeset/tender-swans-flash.md +16 -0
  55. package/.changeset/thick-books-grin.md +5 -0
  56. package/.changeset/thin-peas-hear.md +16 -0
  57. package/.changeset/tidy-pandas-punch.md +5 -0
  58. package/.changeset/tough-rockets-allow.md +5 -0
  59. package/.changeset/tricky-tables-shave.md +5 -0
  60. package/.changeset/unlucky-kiwis-sell.md +5 -0
  61. package/.changeset/warm-ties-sit.md +7 -0
  62. package/.changeset/wicked-forks-double.md +33 -0
  63. package/.changeset/young-phones-fold.md +5 -0
  64. package/.changeset/young-snails-grin.md +5 -0
  65. package/CHANGELOG.md +476 -0
  66. package/__cjs/cache/core/cache.cjs +2 -2
  67. package/__cjs/cache/core/cache.cjs.map +1 -1
  68. package/__cjs/cache/core/cache.d.cts +18 -18
  69. package/__cjs/cache/core/types/Cache.cjs.map +1 -1
  70. package/__cjs/cache/core/types/Cache.d.cts +9 -16
  71. package/__cjs/cache/core/types/DataProxy.d.cts +8 -23
  72. package/__cjs/cache/core/types/common.cjs +1 -0
  73. package/__cjs/cache/core/types/common.cjs.map +1 -1
  74. package/__cjs/cache/index.cjs +4 -4
  75. package/__cjs/cache/index.cjs.map +1 -1
  76. package/__cjs/cache/index.d.cts +3 -3
  77. package/__cjs/cache/inmemory/entityStore.cjs +9 -8
  78. package/__cjs/cache/inmemory/entityStore.cjs.map +1 -1
  79. package/__cjs/cache/inmemory/entityStore.d.cts +3 -2
  80. package/__cjs/cache/inmemory/fragmentRegistry.cjs +3 -3
  81. package/__cjs/cache/inmemory/fragmentRegistry.cjs.map +1 -1
  82. package/__cjs/cache/inmemory/helpers.cjs +0 -8
  83. package/__cjs/cache/inmemory/helpers.cjs.map +1 -1
  84. package/__cjs/cache/inmemory/helpers.d.cts +3 -4
  85. package/__cjs/cache/inmemory/inMemoryCache.cjs +4 -12
  86. package/__cjs/cache/inmemory/inMemoryCache.cjs.map +1 -1
  87. package/__cjs/cache/inmemory/inMemoryCache.d.cts +8 -9
  88. package/__cjs/cache/inmemory/key-extractor.cjs +1 -1
  89. package/__cjs/cache/inmemory/policies.cjs +9 -9
  90. package/__cjs/cache/inmemory/policies.cjs.map +1 -1
  91. package/__cjs/cache/inmemory/policies.d.cts +1 -1
  92. package/__cjs/cache/inmemory/reactiveVars.cjs.map +1 -1
  93. package/__cjs/cache/inmemory/reactiveVars.d.cts +7 -7
  94. package/__cjs/cache/inmemory/readFromStore.cjs +14 -56
  95. package/__cjs/cache/inmemory/readFromStore.cjs.map +1 -1
  96. package/__cjs/cache/inmemory/readFromStore.d.cts +1 -6
  97. package/__cjs/cache/inmemory/types.d.cts +3 -17
  98. package/__cjs/cache/inmemory/writeToStore.cjs +8 -8
  99. package/__cjs/cache/inmemory/writeToStore.cjs.map +1 -1
  100. package/__cjs/cache/inmemory/writeToStore.d.cts +2 -2
  101. package/__cjs/config/jest/areCombinedGraphQLErrorsEqual.cjs +6 -4
  102. package/__cjs/config/jest/areCombinedGraphQLErrorsEqual.cjs.map +1 -1
  103. package/__cjs/config/jest/areCombinedProtocolErrorsEqual.cjs +3 -3
  104. package/__cjs/config/jest/areCombinedProtocolErrorsEqual.cjs.map +1 -1
  105. package/__cjs/config/jest/areMissingFieldErrorsEqual.cjs +2 -3
  106. package/__cjs/config/jest/areMissingFieldErrorsEqual.cjs.map +1 -1
  107. package/__cjs/config/jest/areServerErrorsEqual.cjs +22 -0
  108. package/__cjs/config/jest/areServerErrorsEqual.cjs.map +1 -0
  109. package/__cjs/config/jest/areServerErrorsEqual.d.cts +3 -0
  110. package/__cjs/config/jest/resolver.cjs +11 -0
  111. package/__cjs/config/jest/resolver.cjs.map +1 -1
  112. package/__cjs/config/jest/setup.cjs +18 -1
  113. package/__cjs/config/jest/setup.cjs.map +1 -1
  114. package/__cjs/core/ApolloClient.cjs +34 -17
  115. package/__cjs/core/ApolloClient.cjs.map +1 -1
  116. package/__cjs/core/ApolloClient.d.cts +35 -25
  117. package/__cjs/core/LocalState.cjs +2 -2
  118. package/__cjs/core/LocalState.cjs.map +1 -1
  119. package/__cjs/core/LocalState.d.cts +8 -8
  120. package/__cjs/core/ObservableQuery.cjs +268 -104
  121. package/__cjs/core/ObservableQuery.cjs.map +1 -1
  122. package/__cjs/core/ObservableQuery.d.cts +156 -17
  123. package/__cjs/core/QueryInfo.cjs +12 -86
  124. package/__cjs/core/QueryInfo.cjs.map +1 -1
  125. package/__cjs/core/QueryInfo.d.cts +2 -11
  126. package/__cjs/core/QueryManager.cjs +148 -104
  127. package/__cjs/core/QueryManager.cjs.map +1 -1
  128. package/__cjs/core/QueryManager.d.cts +45 -24
  129. package/__cjs/core/index.cjs +42 -21
  130. package/__cjs/core/index.cjs.map +1 -1
  131. package/__cjs/core/index.d.cts +12 -11
  132. package/__cjs/core/types.d.cts +60 -7
  133. package/__cjs/core/watchQueryOptions.d.cts +32 -119
  134. package/__cjs/errors/CombinedGraphQLErrors.cjs +30 -11
  135. package/__cjs/errors/CombinedGraphQLErrors.cjs.map +1 -1
  136. package/__cjs/errors/CombinedGraphQLErrors.d.cts +21 -2
  137. package/__cjs/errors/CombinedProtocolErrors.cjs +13 -6
  138. package/__cjs/errors/CombinedProtocolErrors.cjs.map +1 -1
  139. package/__cjs/errors/CombinedProtocolErrors.d.cts +9 -0
  140. package/__cjs/errors/LinkError.cjs +20 -0
  141. package/__cjs/errors/LinkError.cjs.map +1 -0
  142. package/__cjs/errors/LinkError.d.cts +14 -0
  143. package/__cjs/errors/ServerError.cjs +6 -0
  144. package/__cjs/errors/ServerError.cjs.map +1 -1
  145. package/__cjs/errors/ServerError.d.cts +2 -0
  146. package/__cjs/errors/ServerParseError.cjs +6 -0
  147. package/__cjs/errors/ServerParseError.cjs.map +1 -1
  148. package/__cjs/errors/ServerParseError.d.cts +2 -0
  149. package/__cjs/errors/UnconventionalError.cjs +6 -0
  150. package/__cjs/errors/UnconventionalError.cjs.map +1 -1
  151. package/__cjs/errors/UnconventionalError.d.cts +2 -0
  152. package/__cjs/errors/index.cjs +19 -4
  153. package/__cjs/errors/index.cjs.map +1 -1
  154. package/__cjs/errors/index.d.cts +2 -3
  155. package/__cjs/errors/isErrorLike.cjs +12 -0
  156. package/__cjs/errors/isErrorLike.cjs.map +1 -0
  157. package/__cjs/errors/isErrorLike.d.cts +3 -0
  158. package/__cjs/errors/utils.cjs +18 -0
  159. package/__cjs/errors/utils.cjs.map +1 -0
  160. package/__cjs/errors/utils.d.cts +3 -0
  161. package/__cjs/invariantErrorCodes.cjs +131 -138
  162. package/__cjs/link/batch/index.cjs +4 -2
  163. package/__cjs/link/batch/index.cjs.map +1 -1
  164. package/__cjs/link/batch/index.d.cts +2 -1
  165. package/__cjs/link/batch-http/index.cjs +3 -2
  166. package/__cjs/link/batch-http/index.cjs.map +1 -1
  167. package/__cjs/link/batch-http/index.d.cts +1 -1
  168. package/__cjs/link/context/index.cjs.map +1 -1
  169. package/__cjs/link/context/index.d.cts +1 -1
  170. package/__cjs/link/core/ApolloLink.cjs +2 -20
  171. package/__cjs/link/core/ApolloLink.cjs.map +1 -1
  172. package/__cjs/link/core/ApolloLink.d.cts +1 -3
  173. package/__cjs/link/core/index.cjs.map +1 -1
  174. package/__cjs/link/core/index.d.cts +1 -1
  175. package/__cjs/link/core/types.d.cts +1 -1
  176. package/__cjs/link/error/index.cjs +13 -28
  177. package/__cjs/link/error/index.cjs.map +1 -1
  178. package/__cjs/link/error/index.d.cts +4 -15
  179. package/__cjs/link/http/checkFetcher.cjs +1 -1
  180. package/__cjs/link/http/createHttpLink.cjs +1 -1
  181. package/__cjs/link/http/createHttpLink.d.cts +2 -1
  182. package/__cjs/link/http/parseAndCheckHttpResponse.cjs +1 -1
  183. package/__cjs/link/http/serializeFetchParameter.cjs +1 -1
  184. package/__cjs/link/persisted-queries/index.cjs +3 -3
  185. package/__cjs/link/persisted-queries/index.cjs.map +1 -1
  186. package/__cjs/link/persisted-queries/index.d.cts +14 -3
  187. package/__cjs/link/remove-typename/removeTypenameFromVariables.cjs +1 -1
  188. package/__cjs/link/remove-typename/removeTypenameFromVariables.cjs.map +1 -1
  189. package/__cjs/link/remove-typename/removeTypenameFromVariables.d.cts +10 -1
  190. package/__cjs/link/retry/index.cjs +3 -2
  191. package/__cjs/link/retry/index.cjs.map +1 -1
  192. package/__cjs/link/retry/index.d.cts +1 -1
  193. package/__cjs/link/subscriptions/index.cjs +3 -1
  194. package/__cjs/link/subscriptions/index.cjs.map +1 -1
  195. package/__cjs/link/utils/validateOperation.cjs +1 -1
  196. package/__cjs/masking/maskDefinition.cjs +2 -2
  197. package/__cjs/masking/maskDefinition.cjs.map +1 -1
  198. package/__cjs/masking/maskDefinition.d.cts +1 -1
  199. package/__cjs/masking/maskFragment.cjs +2 -2
  200. package/__cjs/masking/maskFragment.cjs.map +1 -1
  201. package/__cjs/masking/maskFragment.d.cts +2 -2
  202. package/__cjs/masking/maskOperation.cjs +1 -1
  203. package/__cjs/masking/maskOperation.cjs.map +1 -1
  204. package/__cjs/masking/maskOperation.d.cts +2 -2
  205. package/__cjs/masking/utils.cjs +1 -1
  206. package/__cjs/react/context/ApolloConsumer.cjs +1 -1
  207. package/__cjs/react/context/ApolloConsumer.cjs.map +1 -1
  208. package/__cjs/react/context/ApolloConsumer.d.cts +7 -4
  209. package/__cjs/react/context/ApolloContext.cjs +1 -1
  210. package/__cjs/react/context/ApolloContext.cjs.map +1 -1
  211. package/__cjs/react/context/ApolloContext.d.cts +4 -4
  212. package/__cjs/react/context/ApolloProvider.cjs +1 -1
  213. package/__cjs/react/context/ApolloProvider.cjs.map +1 -1
  214. package/__cjs/react/context/ApolloProvider.d.cts +7 -5
  215. package/__cjs/react/hooks/internal/__use.d.cts +3 -1
  216. package/__cjs/react/hooks/internal/useIsomorphicLayoutEffect.d.cts +1 -1
  217. package/__cjs/react/hooks/internal/validateSuspenseHookOptions.cjs +28 -0
  218. package/__cjs/react/hooks/internal/validateSuspenseHookOptions.cjs.map +1 -0
  219. package/__cjs/react/hooks/internal/validateSuspenseHookOptions.d.cts +3 -0
  220. package/__cjs/react/hooks/internal/wrapHook.cjs +26 -5
  221. package/__cjs/react/hooks/internal/wrapHook.cjs.map +1 -1
  222. package/__cjs/react/hooks/internal/wrapHook.d.cts +7 -5
  223. package/__cjs/react/hooks/useApolloClient.cjs +2 -2
  224. package/__cjs/react/hooks/useApolloClient.cjs.map +1 -1
  225. package/__cjs/react/hooks/useApolloClient.d.cts +2 -2
  226. package/__cjs/react/hooks/useBackgroundQuery.cjs +2 -2
  227. package/__cjs/react/hooks/useBackgroundQuery.cjs.map +1 -1
  228. package/__cjs/react/hooks/useBackgroundQuery.d.cts +143 -46
  229. package/__cjs/react/hooks/useFragment.cjs.map +1 -1
  230. package/__cjs/react/hooks/useFragment.d.cts +51 -26
  231. package/__cjs/react/hooks/useLazyQuery.cjs +31 -32
  232. package/__cjs/react/hooks/useLazyQuery.cjs.map +1 -1
  233. package/__cjs/react/hooks/useLazyQuery.d.cts +278 -276
  234. package/__cjs/react/hooks/useLoadableQuery.cjs +21 -2
  235. package/__cjs/react/hooks/useLoadableQuery.cjs.map +1 -1
  236. package/__cjs/react/hooks/useLoadableQuery.d.cts +106 -34
  237. package/__cjs/react/hooks/useMutation.cjs +14 -21
  238. package/__cjs/react/hooks/useMutation.cjs.map +1 -1
  239. package/__cjs/react/hooks/useMutation.d.cts +198 -4
  240. package/__cjs/react/hooks/useQuery.cjs +87 -206
  241. package/__cjs/react/hooks/useQuery.cjs.map +1 -1
  242. package/__cjs/react/hooks/useQuery.d.cts +274 -4
  243. package/__cjs/react/hooks/useQueryRefHandlers.cjs.map +1 -1
  244. package/__cjs/react/hooks/useQueryRefHandlers.d.cts +23 -22
  245. package/__cjs/react/hooks/useReactiveVar.cjs.map +1 -1
  246. package/__cjs/react/hooks/useReactiveVar.d.cts +1 -1
  247. package/__cjs/react/hooks/useReadQuery.cjs.map +1 -1
  248. package/__cjs/react/hooks/useReadQuery.d.cts +27 -25
  249. package/__cjs/react/hooks/useSubscription.cjs +9 -60
  250. package/__cjs/react/hooks/useSubscription.cjs.map +1 -1
  251. package/__cjs/react/hooks/useSubscription.d.cts +94 -3
  252. package/__cjs/react/hooks/useSuspenseFragment.cjs.map +1 -1
  253. package/__cjs/react/hooks/useSuspenseFragment.d.cts +40 -38
  254. package/__cjs/react/hooks/useSuspenseQuery.cjs +7 -32
  255. package/__cjs/react/hooks/useSuspenseQuery.cjs.map +1 -1
  256. package/__cjs/react/hooks/useSuspenseQuery.d.cts +199 -38
  257. package/__cjs/react/hooks/useSyncExternalStore.cjs +1 -1
  258. package/__cjs/react/index.cjs +35 -11
  259. package/__cjs/react/index.cjs.map +1 -1
  260. package/__cjs/react/index.d.cts +21 -6
  261. package/__cjs/react/index.react-server.cjs +1 -5
  262. package/__cjs/react/index.react-server.cjs.map +1 -1
  263. package/__cjs/react/index.react-server.d.cts +0 -1
  264. package/__cjs/react/internal/cache/FragmentReference.cjs.map +1 -1
  265. package/__cjs/react/internal/cache/FragmentReference.d.cts +3 -3
  266. package/__cjs/react/internal/cache/QueryReference.cjs +3 -14
  267. package/__cjs/react/internal/cache/QueryReference.cjs.map +1 -1
  268. package/__cjs/react/internal/cache/QueryReference.d.cts +7 -7
  269. package/__cjs/react/internal/cache/SuspenseCache.cjs.map +1 -1
  270. package/__cjs/react/internal/cache/SuspenseCache.d.cts +3 -3
  271. package/__cjs/react/internal/cache/getSuspenseCache.cjs.map +1 -1
  272. package/__cjs/react/internal/cache/getSuspenseCache.d.cts +4 -4
  273. package/__cjs/react/internal/index.cjs +3 -1
  274. package/__cjs/react/internal/index.cjs.map +1 -1
  275. package/__cjs/react/internal/index.d.cts +2 -0
  276. package/__cjs/react/internal/types.d.cts +9 -0
  277. package/__cjs/react/query-preloader/createQueryPreloader.cjs +1 -0
  278. package/__cjs/react/query-preloader/createQueryPreloader.cjs.map +1 -1
  279. package/__cjs/react/query-preloader/createQueryPreloader.d.cts +6 -45
  280. package/__cjs/react/ssr/getDataFromTree.cjs +24 -30
  281. package/__cjs/react/ssr/getDataFromTree.cjs.map +1 -1
  282. package/__cjs/react/ssr/getDataFromTree.d.cts +12 -1
  283. package/__cjs/react/ssr/index.cjs +3 -3
  284. package/__cjs/react/ssr/index.cjs.map +1 -1
  285. package/__cjs/react/ssr/index.d.cts +1 -1
  286. package/__cjs/react/ssr/prerenderStatic.cjs +151 -0
  287. package/__cjs/react/ssr/prerenderStatic.cjs.map +1 -0
  288. package/__cjs/react/ssr/prerenderStatic.d.cts +122 -0
  289. package/__cjs/react/ssr/renderToStringWithData.cjs +11 -5
  290. package/__cjs/react/ssr/renderToStringWithData.cjs.map +1 -1
  291. package/__cjs/react/ssr/renderToStringWithData.d.cts +5 -0
  292. package/__cjs/react/ssr/useSSRQuery.cjs +60 -0
  293. package/__cjs/react/ssr/useSSRQuery.cjs.map +1 -0
  294. package/__cjs/react/ssr/useSSRQuery.d.cts +5 -0
  295. package/__cjs/{utilities/types/TODO.cjs → react/types/deprecated.cjs} +1 -1
  296. package/__cjs/react/types/deprecated.cjs.map +1 -0
  297. package/__cjs/react/types/deprecated.d.cts +75 -0
  298. package/__cjs/react/types/types.documentation.d.cts +6 -34
  299. package/__cjs/testing/core/index.cjs +6 -3
  300. package/__cjs/testing/core/index.cjs.map +1 -1
  301. package/__cjs/testing/core/index.d.cts +3 -3
  302. package/__cjs/testing/core/mocking/mockClient.cjs +3 -4
  303. package/__cjs/testing/core/mocking/mockClient.cjs.map +1 -1
  304. package/__cjs/testing/core/mocking/mockClient.d.cts +2 -3
  305. package/__cjs/testing/core/mocking/mockLink.cjs +118 -112
  306. package/__cjs/testing/core/mocking/mockLink.cjs.map +1 -1
  307. package/__cjs/testing/core/mocking/mockLink.d.cts +26 -7
  308. package/__cjs/testing/experimental/createSchemaFetch.cjs +4 -4
  309. package/__cjs/testing/experimental/createSchemaFetch.cjs.map +1 -1
  310. package/__cjs/testing/experimental/createTestSchema.cjs.map +1 -1
  311. package/__cjs/testing/experimental/createTestSchema.d.cts +1 -1
  312. package/__cjs/testing/index.cjs +13 -2
  313. package/__cjs/testing/index.cjs.map +1 -1
  314. package/__cjs/testing/index.d.cts +2 -1
  315. package/__cjs/testing/internal/disposables/spyOnConsole.cjs +0 -1
  316. package/__cjs/testing/internal/disposables/spyOnConsole.cjs.map +1 -1
  317. package/__cjs/testing/internal/disposables/spyOnConsole.d.cts +0 -1
  318. package/__cjs/testing/internal/disposables/withProdMode.d.cts +1 -1
  319. package/__cjs/testing/internal/incremental.cjs.map +1 -1
  320. package/__cjs/testing/internal/incremental.d.cts +4 -3
  321. package/__cjs/testing/internal/index.cjs +14 -8
  322. package/__cjs/testing/internal/index.cjs.map +1 -1
  323. package/__cjs/testing/internal/index.d.cts +4 -3
  324. package/__cjs/testing/internal/renderHelpers.cjs.map +1 -1
  325. package/__cjs/testing/internal/renderHelpers.d.cts +3 -3
  326. package/__cjs/testing/internal/resetApolloContext.cjs +24 -0
  327. package/__cjs/testing/internal/resetApolloContext.cjs.map +1 -0
  328. package/__cjs/testing/internal/resetApolloContext.d.cts +10 -0
  329. package/__cjs/testing/internal/scenarios/index.cjs +9 -7
  330. package/__cjs/testing/internal/scenarios/index.cjs.map +1 -1
  331. package/__cjs/testing/internal/scenarios/index.d.cts +14 -5
  332. package/__cjs/testing/matchers/arrayWithLength.cjs +15 -0
  333. package/__cjs/testing/matchers/arrayWithLength.cjs.map +1 -0
  334. package/__cjs/testing/matchers/arrayWithLength.d.cts +3 -0
  335. package/__cjs/testing/matchers/index.cjs +6 -18
  336. package/__cjs/testing/matchers/index.cjs.map +1 -1
  337. package/__cjs/testing/matchers/toComplete.cjs.map +1 -1
  338. package/__cjs/testing/matchers/toEmitAnything.cjs.map +1 -1
  339. package/__cjs/testing/matchers/toEmitError.cjs.map +1 -1
  340. package/__cjs/testing/matchers/toEmitNext.cjs.map +1 -1
  341. package/__cjs/testing/matchers/{toEmitFetchResult.cjs → toEmitTypedValue.cjs} +9 -7
  342. package/__cjs/testing/matchers/toEmitTypedValue.cjs.map +1 -0
  343. package/__cjs/testing/matchers/{toEmitValueStrict.d.cts → toEmitTypedValue.d.cts} +2 -2
  344. package/__cjs/testing/matchers/toHaveSuspenseCacheEntryUsing.cjs +2 -2
  345. package/__cjs/testing/matchers/toHaveSuspenseCacheEntryUsing.cjs.map +1 -1
  346. package/__cjs/testing/matchers/toHaveSuspenseCacheEntryUsing.d.cts +1 -1
  347. package/__cjs/testing/matchers/toMatchDocument.cjs.map +1 -1
  348. package/__cjs/testing/matchers/toMatchDocument.d.cts +1 -1
  349. package/__cjs/testing/matchers/toStrictEqualTyped.cjs +26 -0
  350. package/__cjs/testing/matchers/toStrictEqualTyped.cjs.map +1 -0
  351. package/__cjs/testing/matchers/toStrictEqualTyped.d.cts +3 -0
  352. package/__cjs/testing/matchers/utils/getSerializableProperties.cjs +23 -0
  353. package/__cjs/testing/matchers/utils/getSerializableProperties.cjs.map +1 -0
  354. package/__cjs/testing/matchers/utils/getSerializableProperties.d.cts +2 -0
  355. package/__cjs/testing/react/MockedProvider.cjs +11 -7
  356. package/__cjs/testing/react/MockedProvider.cjs.map +1 -1
  357. package/__cjs/testing/react/MockedProvider.d.cts +8 -6
  358. package/__cjs/utilities/caching/sizes.cjs +2 -2
  359. package/__cjs/utilities/caching/sizes.cjs.map +1 -1
  360. package/__cjs/utilities/caching/sizes.d.cts +2 -20
  361. package/__cjs/utilities/common/errorHandling.d.cts +1 -1
  362. package/__cjs/utilities/common/mergeOptions.cjs.map +1 -1
  363. package/__cjs/utilities/common/mergeOptions.d.cts +1 -1
  364. package/__cjs/utilities/graphql/getFromAST.cjs +15 -6
  365. package/__cjs/utilities/graphql/getFromAST.cjs.map +1 -1
  366. package/__cjs/utilities/graphql/getFromAST.d.cts +2 -2
  367. package/__cjs/utilities/graphql/operations.cjs.map +1 -1
  368. package/__cjs/utilities/graphql/operations.d.cts +1 -1
  369. package/__cjs/utilities/graphql/storeUtils.cjs +1 -1
  370. package/__cjs/utilities/graphql/transform.cjs +2 -2
  371. package/__cjs/utilities/index.cjs +39 -19
  372. package/__cjs/utilities/index.cjs.map +1 -1
  373. package/__cjs/utilities/index.d.cts +16 -15
  374. package/__cjs/utilities/internal/getMemoryInternals.cjs +0 -2
  375. package/__cjs/utilities/internal/getMemoryInternals.cjs.map +1 -1
  376. package/__cjs/utilities/internal/getMemoryInternals.d.cts +1 -2
  377. package/__cjs/utilities/internal/index.cjs +3 -1
  378. package/__cjs/utilities/internal/index.cjs.map +1 -1
  379. package/__cjs/utilities/internal/index.d.cts +1 -0
  380. package/__cjs/utilities/internal/index.production.cjs +1 -0
  381. package/__cjs/utilities/internal/index.production.cjs.map +1 -1
  382. package/__cjs/utilities/internal/toQueryResult.cjs +13 -0
  383. package/__cjs/utilities/internal/toQueryResult.cjs.map +1 -0
  384. package/__cjs/utilities/internal/toQueryResult.d.cts +3 -0
  385. package/__cjs/utilities/invariant/index.development.cjs +1 -0
  386. package/__cjs/utilities/invariant/index.development.cjs.map +1 -1
  387. package/__cjs/utilities/subscriptions/relay/index.cjs +2 -2
  388. package/__cjs/utilities/subscriptions/relay/index.cjs.map +1 -1
  389. package/__cjs/utilities/subscriptions/relay/index.d.cts +1 -1
  390. package/__cjs/utilities/types/NoInfer.d.cts +1 -1
  391. package/__cjs/utilities/types/{OnlyRequiredProperties.cjs → VariablesOption.cjs} +1 -1
  392. package/__cjs/utilities/types/VariablesOption.cjs.map +1 -0
  393. package/__cjs/utilities/types/VariablesOption.d.cts +25 -0
  394. package/__cjs/version.cjs +1 -1
  395. package/__cjs/version.cjs.map +1 -1
  396. package/__cjs/version.d.cts +1 -1
  397. package/cache/core/cache.d.ts +18 -18
  398. package/cache/core/cache.js +1 -1
  399. package/cache/core/cache.js.map +1 -1
  400. package/cache/core/types/Cache.d.ts +9 -16
  401. package/cache/core/types/Cache.js.map +1 -1
  402. package/cache/core/types/DataProxy.d.ts +8 -23
  403. package/cache/core/types/common.js +1 -0
  404. package/cache/core/types/common.js.map +1 -1
  405. package/cache/index.d.ts +3 -3
  406. package/cache/index.js +1 -1
  407. package/cache/index.js.map +1 -1
  408. package/cache/inmemory/entityStore.d.ts +3 -2
  409. package/cache/inmemory/entityStore.js +9 -8
  410. package/cache/inmemory/entityStore.js.map +1 -1
  411. package/cache/inmemory/fragmentRegistry.js +1 -1
  412. package/cache/inmemory/fragmentRegistry.js.map +1 -1
  413. package/cache/inmemory/helpers.d.ts +0 -1
  414. package/cache/inmemory/helpers.js +0 -7
  415. package/cache/inmemory/helpers.js.map +1 -1
  416. package/cache/inmemory/inMemoryCache.d.ts +8 -9
  417. package/cache/inmemory/inMemoryCache.js +4 -12
  418. package/cache/inmemory/inMemoryCache.js.map +1 -1
  419. package/cache/inmemory/key-extractor.js +1 -1
  420. package/cache/inmemory/policies.d.ts +1 -1
  421. package/cache/inmemory/policies.js +9 -9
  422. package/cache/inmemory/policies.js.map +1 -1
  423. package/cache/inmemory/reactiveVars.d.ts +7 -7
  424. package/cache/inmemory/reactiveVars.js.map +1 -1
  425. package/cache/inmemory/readFromStore.d.ts +1 -6
  426. package/cache/inmemory/readFromStore.js +14 -56
  427. package/cache/inmemory/readFromStore.js.map +1 -1
  428. package/cache/inmemory/types.d.ts +3 -17
  429. package/cache/inmemory/writeToStore.d.ts +2 -2
  430. package/cache/inmemory/writeToStore.js +8 -8
  431. package/cache/inmemory/writeToStore.js.map +1 -1
  432. package/config/jest/areCombinedGraphQLErrorsEqual.js +6 -4
  433. package/config/jest/areCombinedGraphQLErrorsEqual.js.map +1 -1
  434. package/config/jest/areCombinedProtocolErrorsEqual.js +3 -3
  435. package/config/jest/areCombinedProtocolErrorsEqual.js.map +1 -1
  436. package/config/jest/areMissingFieldErrorsEqual.js +2 -3
  437. package/config/jest/areMissingFieldErrorsEqual.js.map +1 -1
  438. package/config/jest/areServerErrorsEqual.d.ts +3 -0
  439. package/config/jest/areServerErrorsEqual.js +18 -0
  440. package/config/jest/areServerErrorsEqual.js.map +1 -0
  441. package/config/jest/resolver.js +12 -1
  442. package/config/jest/resolver.js.map +1 -1
  443. package/config/jest/setup.js +19 -2
  444. package/config/jest/setup.js.map +1 -1
  445. package/core/ApolloClient.d.ts +35 -25
  446. package/core/ApolloClient.js +35 -18
  447. package/core/ApolloClient.js.map +1 -1
  448. package/core/LocalState.d.ts +6 -6
  449. package/core/LocalState.js +2 -2
  450. package/core/LocalState.js.map +1 -1
  451. package/core/ObservableQuery.d.ts +156 -17
  452. package/core/ObservableQuery.js +267 -102
  453. package/core/ObservableQuery.js.map +1 -1
  454. package/core/QueryInfo.d.ts +2 -11
  455. package/core/QueryInfo.js +12 -86
  456. package/core/QueryInfo.js.map +1 -1
  457. package/core/QueryManager.d.ts +32 -21
  458. package/core/QueryManager.js +151 -107
  459. package/core/QueryManager.js.map +1 -1
  460. package/core/index.d.ts +12 -11
  461. package/core/index.js +9 -6
  462. package/core/index.js.map +1 -1
  463. package/core/types.d.ts +60 -7
  464. package/core/watchQueryOptions.d.ts +32 -119
  465. package/errors/CombinedGraphQLErrors.d.ts +21 -2
  466. package/errors/CombinedGraphQLErrors.js +30 -11
  467. package/errors/CombinedGraphQLErrors.js.map +1 -1
  468. package/errors/CombinedProtocolErrors.d.ts +9 -0
  469. package/errors/CombinedProtocolErrors.js +13 -6
  470. package/errors/CombinedProtocolErrors.js.map +1 -1
  471. package/errors/LinkError.d.ts +14 -0
  472. package/errors/LinkError.js +16 -0
  473. package/errors/LinkError.js.map +1 -0
  474. package/errors/ServerError.d.ts +2 -0
  475. package/errors/ServerError.js +6 -0
  476. package/errors/ServerError.js.map +1 -1
  477. package/errors/ServerParseError.d.ts +2 -0
  478. package/errors/ServerParseError.js +6 -0
  479. package/errors/ServerParseError.js.map +1 -1
  480. package/errors/UnconventionalError.d.ts +2 -0
  481. package/errors/UnconventionalError.js +6 -0
  482. package/errors/UnconventionalError.js.map +1 -1
  483. package/errors/index.d.ts +2 -3
  484. package/errors/index.js +13 -1
  485. package/errors/index.js.map +1 -1
  486. package/errors/isErrorLike.d.ts +3 -0
  487. package/errors/isErrorLike.js +9 -0
  488. package/errors/isErrorLike.js.map +1 -0
  489. package/errors/utils.d.ts +3 -0
  490. package/errors/utils.js +14 -0
  491. package/errors/utils.js.map +1 -0
  492. package/invariantErrorCodes.js +131 -138
  493. package/legacyEntryPoints/testing/internal/index.d.ts +1 -0
  494. package/legacyEntryPoints/testing/internal/index.js +1 -0
  495. package/legacyEntryPoints/testing/internal/internal.cjs +1 -0
  496. package/legacyEntryPoints/testing/internal/internal.d.cts +1 -0
  497. package/link/batch/index.d.ts +2 -1
  498. package/link/batch/index.js +1 -1
  499. package/link/batch/index.js.map +1 -1
  500. package/link/batch-http/index.d.ts +1 -1
  501. package/link/batch-http/index.js +1 -1
  502. package/link/batch-http/index.js.map +1 -1
  503. package/link/context/index.d.ts +1 -1
  504. package/link/context/index.js.map +1 -1
  505. package/link/core/ApolloLink.d.ts +1 -3
  506. package/link/core/ApolloLink.js +2 -20
  507. package/link/core/ApolloLink.js.map +1 -1
  508. package/link/core/index.d.ts +1 -1
  509. package/link/core/index.js.map +1 -1
  510. package/link/core/types.d.ts +1 -1
  511. package/link/error/index.d.ts +4 -15
  512. package/link/error/index.js +14 -29
  513. package/link/error/index.js.map +1 -1
  514. package/link/http/checkFetcher.js +1 -1
  515. package/link/http/createHttpLink.js +1 -1
  516. package/link/http/parseAndCheckHttpResponse.js +1 -1
  517. package/link/http/serializeFetchParameter.js +1 -1
  518. package/link/persisted-queries/index.d.ts +2 -2
  519. package/link/persisted-queries/index.js +3 -3
  520. package/link/persisted-queries/index.js.map +1 -1
  521. package/link/remove-typename/removeTypenameFromVariables.js.map +1 -1
  522. package/link/retry/index.d.ts +1 -1
  523. package/link/retry/index.js +1 -1
  524. package/link/retry/index.js.map +1 -1
  525. package/link/subscriptions/index.js +3 -1
  526. package/link/subscriptions/index.js.map +1 -1
  527. package/link/utils/validateOperation.js +1 -1
  528. package/masking/maskDefinition.d.ts +1 -1
  529. package/masking/maskDefinition.js +2 -2
  530. package/masking/maskDefinition.js.map +1 -1
  531. package/masking/maskFragment.d.ts +2 -2
  532. package/masking/maskFragment.js +2 -2
  533. package/masking/maskFragment.js.map +1 -1
  534. package/masking/maskOperation.d.ts +2 -2
  535. package/masking/maskOperation.js +1 -1
  536. package/masking/maskOperation.js.map +1 -1
  537. package/masking/utils.js +1 -1
  538. package/package.json +20 -40
  539. package/react/context/ApolloConsumer.d.ts +7 -4
  540. package/react/context/ApolloConsumer.js +1 -1
  541. package/react/context/ApolloConsumer.js.map +1 -1
  542. package/react/context/ApolloContext.d.ts +4 -4
  543. package/react/context/ApolloContext.js +1 -1
  544. package/react/context/ApolloContext.js.map +1 -1
  545. package/react/context/ApolloProvider.d.ts +7 -5
  546. package/react/context/ApolloProvider.js +1 -1
  547. package/react/context/ApolloProvider.js.map +1 -1
  548. package/react/hooks/internal/validateSuspenseHookOptions.d.ts +3 -0
  549. package/react/hooks/internal/validateSuspenseHookOptions.js +22 -0
  550. package/react/hooks/internal/validateSuspenseHookOptions.js.map +1 -0
  551. package/react/hooks/internal/wrapHook.d.ts +7 -5
  552. package/react/hooks/internal/wrapHook.js +24 -5
  553. package/react/hooks/internal/wrapHook.js.map +1 -1
  554. package/react/hooks/useApolloClient.d.ts +2 -2
  555. package/react/hooks/useApolloClient.js +1 -1
  556. package/react/hooks/useApolloClient.js.map +1 -1
  557. package/react/hooks/useBackgroundQuery.d.ts +143 -46
  558. package/react/hooks/useBackgroundQuery.js +2 -2
  559. package/react/hooks/useBackgroundQuery.js.map +1 -1
  560. package/react/hooks/useFragment.d.ts +51 -26
  561. package/react/hooks/useFragment.js.map +1 -1
  562. package/react/hooks/useLazyQuery.d.ts +278 -276
  563. package/react/hooks/useLazyQuery.js +30 -31
  564. package/react/hooks/useLazyQuery.js.map +1 -1
  565. package/react/hooks/useLoadableQuery.d.ts +106 -34
  566. package/react/hooks/useLoadableQuery.js +21 -2
  567. package/react/hooks/useLoadableQuery.js.map +1 -1
  568. package/react/hooks/useMutation.d.ts +198 -4
  569. package/react/hooks/useMutation.js +14 -21
  570. package/react/hooks/useMutation.js.map +1 -1
  571. package/react/hooks/useQuery.d.ts +274 -4
  572. package/react/hooks/useQuery.js +86 -205
  573. package/react/hooks/useQuery.js.map +1 -1
  574. package/react/hooks/useQueryRefHandlers.d.ts +23 -22
  575. package/react/hooks/useQueryRefHandlers.js.map +1 -1
  576. package/react/hooks/useReactiveVar.d.ts +1 -1
  577. package/react/hooks/useReactiveVar.js.map +1 -1
  578. package/react/hooks/useReadQuery.d.ts +27 -25
  579. package/react/hooks/useReadQuery.js.map +1 -1
  580. package/react/hooks/useSubscription.d.ts +94 -9
  581. package/react/hooks/useSubscription.js +8 -56
  582. package/react/hooks/useSubscription.js.map +1 -1
  583. package/react/hooks/useSuspenseFragment.d.ts +40 -38
  584. package/react/hooks/useSuspenseFragment.js.map +1 -1
  585. package/react/hooks/useSuspenseQuery.d.ts +199 -38
  586. package/react/hooks/useSuspenseQuery.js +5 -26
  587. package/react/hooks/useSuspenseQuery.js.map +1 -1
  588. package/react/hooks/useSyncExternalStore.js +1 -1
  589. package/react/index.d.ts +21 -6
  590. package/react/index.js +17 -3
  591. package/react/index.js.map +1 -1
  592. package/react/index.react-server.d.ts +0 -1
  593. package/react/index.react-server.js +0 -1
  594. package/react/index.react-server.js.map +1 -1
  595. package/react/internal/cache/FragmentReference.d.ts +3 -3
  596. package/react/internal/cache/FragmentReference.js.map +1 -1
  597. package/react/internal/cache/QueryReference.d.ts +5 -5
  598. package/react/internal/cache/QueryReference.js +3 -14
  599. package/react/internal/cache/QueryReference.js.map +1 -1
  600. package/react/internal/cache/SuspenseCache.d.ts +3 -3
  601. package/react/internal/cache/SuspenseCache.js.map +1 -1
  602. package/react/internal/cache/getSuspenseCache.d.ts +3 -3
  603. package/react/internal/cache/getSuspenseCache.js.map +1 -1
  604. package/react/internal/index.d.ts +2 -0
  605. package/react/internal/index.js +2 -1
  606. package/react/internal/index.js.map +1 -1
  607. package/react/internal/types.d.ts +9 -0
  608. package/react/query-preloader/createQueryPreloader.d.ts +6 -45
  609. package/react/query-preloader/createQueryPreloader.js +1 -0
  610. package/react/query-preloader/createQueryPreloader.js.map +1 -1
  611. package/react/ssr/getDataFromTree.d.ts +12 -1
  612. package/react/ssr/getDataFromTree.js +24 -29
  613. package/react/ssr/getDataFromTree.js.map +1 -1
  614. package/react/ssr/index.d.ts +1 -1
  615. package/react/ssr/index.js +1 -1
  616. package/react/ssr/index.js.map +1 -1
  617. package/react/ssr/prerenderStatic.d.ts +122 -0
  618. package/react/ssr/prerenderStatic.js +147 -0
  619. package/react/ssr/prerenderStatic.js.map +1 -0
  620. package/react/ssr/renderToStringWithData.d.ts +5 -0
  621. package/react/ssr/renderToStringWithData.js +11 -5
  622. package/react/ssr/renderToStringWithData.js.map +1 -1
  623. package/react/ssr/useSSRQuery.d.ts +5 -0
  624. package/react/ssr/useSSRQuery.js +56 -0
  625. package/react/ssr/useSSRQuery.js.map +1 -0
  626. package/react/types/deprecated.d.ts +75 -0
  627. package/react/types/deprecated.js +2 -0
  628. package/react/types/deprecated.js.map +1 -0
  629. package/react/types/types.documentation.d.ts +6 -34
  630. package/testing/core/index.d.ts +3 -3
  631. package/testing/core/index.js +2 -2
  632. package/testing/core/index.js.map +1 -1
  633. package/testing/core/mocking/mockClient.d.ts +2 -3
  634. package/testing/core/mocking/mockClient.js +2 -3
  635. package/testing/core/mocking/mockClient.js.map +1 -1
  636. package/testing/core/mocking/mockLink.d.ts +26 -7
  637. package/testing/core/mocking/mockLink.js +117 -113
  638. package/testing/core/mocking/mockLink.js.map +1 -1
  639. package/testing/experimental/createSchemaFetch.js +2 -2
  640. package/testing/experimental/createSchemaFetch.js.map +1 -1
  641. package/testing/experimental/createTestSchema.d.ts +1 -1
  642. package/testing/experimental/createTestSchema.js.map +1 -1
  643. package/testing/index.d.ts +2 -1
  644. package/testing/index.js +1 -1
  645. package/testing/index.js.map +1 -1
  646. package/testing/internal/disposables/spyOnConsole.d.ts +0 -1
  647. package/testing/internal/disposables/spyOnConsole.js +0 -1
  648. package/testing/internal/disposables/spyOnConsole.js.map +1 -1
  649. package/testing/internal/incremental.d.ts +1 -1
  650. package/testing/internal/incremental.js.map +1 -1
  651. package/testing/internal/index.d.ts +4 -3
  652. package/testing/internal/index.js +4 -3
  653. package/testing/internal/index.js.map +1 -1
  654. package/testing/internal/renderHelpers.d.ts +3 -3
  655. package/testing/internal/renderHelpers.js.map +1 -1
  656. package/testing/internal/resetApolloContext.d.ts +10 -0
  657. package/testing/internal/resetApolloContext.js +20 -0
  658. package/testing/internal/resetApolloContext.js.map +1 -0
  659. package/testing/internal/scenarios/index.d.ts +6 -8
  660. package/testing/internal/scenarios/index.js +4 -2
  661. package/testing/internal/scenarios/index.js.map +1 -1
  662. package/testing/matchers/arrayWithLength.d.ts +3 -0
  663. package/testing/matchers/arrayWithLength.js +11 -0
  664. package/testing/matchers/arrayWithLength.js.map +1 -0
  665. package/testing/matchers/index.js +6 -18
  666. package/testing/matchers/index.js.map +1 -1
  667. package/testing/matchers/toComplete.js.map +1 -1
  668. package/testing/matchers/toEmitAnything.js.map +1 -1
  669. package/testing/matchers/toEmitError.js.map +1 -1
  670. package/testing/matchers/toEmitNext.js.map +1 -1
  671. package/testing/matchers/{toEmitValueStrict.d.ts → toEmitTypedValue.d.ts} +2 -2
  672. package/testing/matchers/{toEmitFetchResult.js → toEmitTypedValue.js} +7 -5
  673. package/testing/matchers/toEmitTypedValue.js.map +1 -0
  674. package/testing/matchers/toHaveSuspenseCacheEntryUsing.d.ts +1 -1
  675. package/testing/matchers/toHaveSuspenseCacheEntryUsing.js +1 -1
  676. package/testing/matchers/toHaveSuspenseCacheEntryUsing.js.map +1 -1
  677. package/testing/matchers/toMatchDocument.d.ts +1 -1
  678. package/testing/matchers/toMatchDocument.js.map +1 -1
  679. package/testing/matchers/toStrictEqualTyped.d.ts +3 -0
  680. package/testing/matchers/toStrictEqualTyped.js +22 -0
  681. package/testing/matchers/toStrictEqualTyped.js.map +1 -0
  682. package/testing/matchers/utils/getSerializableProperties.d.ts +2 -0
  683. package/testing/matchers/utils/getSerializableProperties.js +20 -0
  684. package/testing/matchers/utils/getSerializableProperties.js.map +1 -0
  685. package/testing/react/MockedProvider.d.ts +8 -6
  686. package/testing/react/MockedProvider.js +8 -4
  687. package/testing/react/MockedProvider.js.map +1 -1
  688. package/utilities/caching/sizes.d.ts +2 -20
  689. package/utilities/caching/sizes.js +2 -2
  690. package/utilities/caching/sizes.js.map +1 -1
  691. package/utilities/common/mergeOptions.d.ts +1 -1
  692. package/utilities/common/mergeOptions.js.map +1 -1
  693. package/utilities/graphql/getFromAST.d.ts +2 -2
  694. package/utilities/graphql/getFromAST.js +15 -6
  695. package/utilities/graphql/getFromAST.js.map +1 -1
  696. package/utilities/graphql/operations.d.ts +1 -1
  697. package/utilities/graphql/operations.js.map +1 -1
  698. package/utilities/graphql/storeUtils.js +1 -1
  699. package/utilities/graphql/transform.js +2 -2
  700. package/utilities/index.d.ts +16 -15
  701. package/utilities/index.js +12 -12
  702. package/utilities/index.js.map +1 -1
  703. package/utilities/internal/getMemoryInternals.d.ts +0 -1
  704. package/utilities/internal/getMemoryInternals.js +0 -2
  705. package/utilities/internal/getMemoryInternals.js.map +1 -1
  706. package/utilities/internal/index.d.ts +1 -0
  707. package/utilities/internal/index.js +2 -1
  708. package/utilities/internal/index.js.map +1 -1
  709. package/utilities/internal/index.production.js +1 -0
  710. package/utilities/internal/index.production.js.map +1 -1
  711. package/utilities/internal/toQueryResult.d.ts +3 -0
  712. package/utilities/internal/toQueryResult.js +10 -0
  713. package/utilities/internal/toQueryResult.js.map +1 -0
  714. package/utilities/invariant/index.development.js +1 -0
  715. package/utilities/invariant/index.development.js.map +1 -1
  716. package/utilities/subscriptions/relay/index.d.ts +1 -1
  717. package/utilities/subscriptions/relay/index.js +1 -1
  718. package/utilities/subscriptions/relay/index.js.map +1 -1
  719. package/utilities/types/NoInfer.d.ts +1 -1
  720. package/utilities/types/VariablesOption.d.ts +25 -0
  721. package/utilities/types/VariablesOption.js +2 -0
  722. package/utilities/types/VariablesOption.js.map +1 -0
  723. package/version.d.ts +1 -1
  724. package/version.js +1 -1
  725. package/version.js.map +1 -1
  726. package/__cjs/cache/inmemory/object-canon.cjs +0 -180
  727. package/__cjs/cache/inmemory/object-canon.cjs.map +0 -1
  728. package/__cjs/cache/inmemory/object-canon.d.cts +0 -12
  729. package/__cjs/index.cjs +0 -8
  730. package/__cjs/index.cjs.map +0 -1
  731. package/__cjs/index.d.cts +0 -3
  732. package/__cjs/react/context/index.cjs +0 -10
  733. package/__cjs/react/context/index.cjs.map +0 -1
  734. package/__cjs/react/context/index.d.cts +0 -7
  735. package/__cjs/react/hooks/index.cjs +0 -27
  736. package/__cjs/react/hooks/index.cjs.map +0 -1
  737. package/__cjs/react/hooks/index.d.cts +0 -22
  738. package/__cjs/react/parser/index.cjs +0 -115
  739. package/__cjs/react/parser/index.cjs.map +0 -1
  740. package/__cjs/react/parser/index.d.cts +0 -18
  741. package/__cjs/react/ssr/RenderPromises.cjs +0 -104
  742. package/__cjs/react/ssr/RenderPromises.cjs.map +0 -1
  743. package/__cjs/react/ssr/RenderPromises.d.cts +0 -22
  744. package/__cjs/react/types/types.d.cts +0 -689
  745. package/__cjs/testing/matchers/toEmitApolloQueryResult.cjs +0 -40
  746. package/__cjs/testing/matchers/toEmitApolloQueryResult.cjs.map +0 -1
  747. package/__cjs/testing/matchers/toEmitApolloQueryResult.d.cts +0 -8
  748. package/__cjs/testing/matchers/toEmitFetchResult.cjs.map +0 -1
  749. package/__cjs/testing/matchers/toEmitFetchResult.d.cts +0 -8
  750. package/__cjs/testing/matchers/toEmitMatchedValue.cjs +0 -40
  751. package/__cjs/testing/matchers/toEmitMatchedValue.cjs.map +0 -1
  752. package/__cjs/testing/matchers/toEmitMatchedValue.d.cts +0 -7
  753. package/__cjs/testing/matchers/toEmitValue.cjs +0 -41
  754. package/__cjs/testing/matchers/toEmitValue.cjs.map +0 -1
  755. package/__cjs/testing/matchers/toEmitValue.d.cts +0 -4
  756. package/__cjs/testing/matchers/toEmitValueStrict.cjs +0 -46
  757. package/__cjs/testing/matchers/toEmitValueStrict.cjs.map +0 -1
  758. package/__cjs/testing/matchers/toEqualApolloQueryResult.cjs +0 -24
  759. package/__cjs/testing/matchers/toEqualApolloQueryResult.cjs.map +0 -1
  760. package/__cjs/testing/matchers/toEqualApolloQueryResult.d.cts +0 -6
  761. package/__cjs/testing/matchers/toEqualFetchResult.cjs +0 -24
  762. package/__cjs/testing/matchers/toEqualFetchResult.cjs.map +0 -1
  763. package/__cjs/testing/matchers/toEqualFetchResult.d.cts +0 -4
  764. package/__cjs/testing/matchers/toEqualLazyQueryResult.cjs +0 -40
  765. package/__cjs/testing/matchers/toEqualLazyQueryResult.cjs.map +0 -1
  766. package/__cjs/testing/matchers/toEqualLazyQueryResult.d.cts +0 -10
  767. package/__cjs/testing/matchers/toEqualQueryResult.cjs +0 -40
  768. package/__cjs/testing/matchers/toEqualQueryResult.cjs.map +0 -1
  769. package/__cjs/testing/matchers/toEqualQueryResult.d.cts +0 -9
  770. package/__cjs/utilities/types/OnlyRequiredProperties.cjs.map +0 -1
  771. package/__cjs/utilities/types/OnlyRequiredProperties.d.cts +0 -7
  772. package/__cjs/utilities/types/TODO.cjs.map +0 -1
  773. package/__cjs/utilities/types/TODO.d.cts +0 -3
  774. package/cache/inmemory/object-canon.d.ts +0 -12
  775. package/cache/inmemory/object-canon.js +0 -176
  776. package/cache/inmemory/object-canon.js.map +0 -1
  777. package/index.d.ts +0 -3
  778. package/index.js +0 -3
  779. package/index.js.map +0 -1
  780. package/legacyEntryPoints/react/context/context.cjs +0 -1
  781. package/legacyEntryPoints/react/context/context.d.cts +0 -1
  782. package/legacyEntryPoints/react/context/index.d.ts +0 -1
  783. package/legacyEntryPoints/react/context/index.js +0 -1
  784. package/legacyEntryPoints/react/hooks/hooks.cjs +0 -1
  785. package/legacyEntryPoints/react/hooks/hooks.d.cts +0 -1
  786. package/legacyEntryPoints/react/hooks/index.d.ts +0 -1
  787. package/legacyEntryPoints/react/hooks/index.js +0 -1
  788. package/legacyEntryPoints/react/parser/index.d.ts +0 -1
  789. package/legacyEntryPoints/react/parser/index.js +0 -1
  790. package/legacyEntryPoints/react/parser/parser.cjs +0 -1
  791. package/legacyEntryPoints/react/parser/parser.d.cts +0 -1
  792. package/react/context/index.d.ts +0 -7
  793. package/react/context/index.js +0 -4
  794. package/react/context/index.js.map +0 -1
  795. package/react/hooks/index.d.ts +0 -22
  796. package/react/hooks/index.js +0 -15
  797. package/react/hooks/index.js.map +0 -1
  798. package/react/parser/index.d.ts +0 -18
  799. package/react/parser/index.js +0 -109
  800. package/react/parser/index.js.map +0 -1
  801. package/react/ssr/RenderPromises.d.ts +0 -22
  802. package/react/ssr/RenderPromises.js +0 -100
  803. package/react/ssr/RenderPromises.js.map +0 -1
  804. package/react/types/types.d.ts +0 -689
  805. package/testing/matchers/toEmitApolloQueryResult.d.ts +0 -8
  806. package/testing/matchers/toEmitApolloQueryResult.js +0 -36
  807. package/testing/matchers/toEmitApolloQueryResult.js.map +0 -1
  808. package/testing/matchers/toEmitFetchResult.d.ts +0 -8
  809. package/testing/matchers/toEmitFetchResult.js.map +0 -1
  810. package/testing/matchers/toEmitMatchedValue.d.ts +0 -7
  811. package/testing/matchers/toEmitMatchedValue.js +0 -36
  812. package/testing/matchers/toEmitMatchedValue.js.map +0 -1
  813. package/testing/matchers/toEmitValue.d.ts +0 -4
  814. package/testing/matchers/toEmitValue.js +0 -37
  815. package/testing/matchers/toEmitValue.js.map +0 -1
  816. package/testing/matchers/toEmitValueStrict.js +0 -42
  817. package/testing/matchers/toEmitValueStrict.js.map +0 -1
  818. package/testing/matchers/toEqualApolloQueryResult.d.ts +0 -6
  819. package/testing/matchers/toEqualApolloQueryResult.js +0 -20
  820. package/testing/matchers/toEqualApolloQueryResult.js.map +0 -1
  821. package/testing/matchers/toEqualFetchResult.d.ts +0 -4
  822. package/testing/matchers/toEqualFetchResult.js +0 -20
  823. package/testing/matchers/toEqualFetchResult.js.map +0 -1
  824. package/testing/matchers/toEqualLazyQueryResult.d.ts +0 -10
  825. package/testing/matchers/toEqualLazyQueryResult.js +0 -36
  826. package/testing/matchers/toEqualLazyQueryResult.js.map +0 -1
  827. package/testing/matchers/toEqualQueryResult.d.ts +0 -9
  828. package/testing/matchers/toEqualQueryResult.js +0 -36
  829. package/testing/matchers/toEqualQueryResult.js.map +0 -1
  830. package/utilities/types/OnlyRequiredProperties.d.ts +0 -7
  831. package/utilities/types/OnlyRequiredProperties.js +0 -2
  832. package/utilities/types/OnlyRequiredProperties.js.map +0 -1
  833. package/utilities/types/TODO.d.ts +0 -3
  834. package/utilities/types/TODO.js +0 -2
  835. package/utilities/types/TODO.js.map +0 -1
  836. /package/__cjs/react/{types → internal}/types.cjs +0 -0
  837. /package/__cjs/react/{types → internal}/types.cjs.map +0 -0
  838. /package/react/{types → internal}/types.js +0 -0
  839. /package/react/{types → internal}/types.js.map +0 -0
@@ -1,689 +0,0 @@
1
- import type { TypedDocumentNode } from "@graphql-typed-document-node/core";
2
- import type { DocumentNode } from "graphql";
3
- import type * as ReactTypes from "react";
4
- import type { ApolloCache, ApolloClient, ApolloQueryResult, DefaultContext, ErrorLike, ErrorPolicy, FetchMoreQueryOptions, FetchPolicy, InternalRefetchQueriesInclude, NetworkStatus, ObservableQuery, OperationVariables, RefetchWritePolicy, SubscribeToMoreFunction, UpdateQueryMapFn, WatchQueryFetchPolicy, WatchQueryOptions } from "@apollo/client/core";
5
- import type { FetchResult } from "@apollo/client/link/core";
6
- import type { MaybeMasked, Unmasked } from "@apollo/client/masking";
7
- import type { OnlyRequiredProperties } from "@apollo/client/utilities";
8
- import type { MutationSharedOptions, SharedWatchQueryOptions } from "../../core/watchQueryOptions.cjs";
9
- export type { PreloadedQueryRef, QueryRef, QueryReference, } from "../internal/index.cjs";
10
- export type { DefaultContext as Context } from "../../core/index.cjs";
11
- export type CommonOptions<TOptions> = TOptions & {
12
- client?: ApolloClient<object>;
13
- };
14
- export interface BaseQueryOptions<TVariables extends OperationVariables = OperationVariables, TData = any> extends SharedWatchQueryOptions<TVariables, TData> {
15
- /**
16
- * Pass `false` to skip executing the query during [server-side rendering](https://www.apollographql.com/docs/react/performance/server-side-rendering/).
17
- *
18
- * @docGroup
19
- *
20
- * 2. Networking options
21
- */
22
- ssr?: boolean;
23
- /**
24
- * The instance of `ApolloClient` to use to execute the query.
25
- *
26
- * By default, the instance that's passed down via context is used, but you can provide a different instance here.
27
- *
28
- * @docGroup
29
- *
30
- * 1. Operation options
31
- */
32
- client?: ApolloClient<any>;
33
- /**
34
- * 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.
35
- *
36
- * @docGroup
37
- *
38
- * 2. Networking options
39
- */
40
- context?: DefaultContext;
41
- }
42
- export interface QueryFunctionOptions<TData = any, TVariables extends OperationVariables = OperationVariables> extends BaseQueryOptions<TVariables, TData> {
43
- /**
44
- * If true, the query is not executed.
45
- *
46
- * The default value is `false`.
47
- *
48
- * @docGroup
49
- *
50
- * 1. Operation options
51
- */
52
- skip?: boolean;
53
- /** @internal */
54
- defaultOptions?: Partial<WatchQueryOptions<TVariables, TData>>;
55
- }
56
- export interface ObservableQueryFields<TData, TVariables extends OperationVariables> {
57
- /**
58
- * A function that instructs the query to begin re-executing at a specified interval (in milliseconds).
59
- *
60
- *
61
- * @docGroup
62
- *
63
- * 3. Helper functions
64
- */
65
- startPolling: (pollInterval: number) => void;
66
- /**
67
- * A function that instructs the query to stop polling after a previous call to `startPolling`.
68
- *
69
- *
70
- * @docGroup
71
- *
72
- * 3. Helper functions
73
- */
74
- stopPolling: () => void;
75
- /**
76
- * A function that enables you to execute a [subscription](https://www.apollographql.com/docs/react/data/subscriptions/), usually to subscribe to specific fields that were included in the query.
77
- *
78
- * This function returns _another_ function that you can call to terminate the subscription.
79
- *
80
- *
81
- * @docGroup
82
- *
83
- * 3. Helper functions
84
- */
85
- subscribeToMore: SubscribeToMoreFunction<TData, TVariables>;
86
- /**
87
- * A function that enables you to update the query's cached result without executing a followup GraphQL operation.
88
- *
89
- * See [using updateQuery and updateFragment](https://www.apollographql.com/docs/react/caching/cache-interaction/#using-updatequery-and-updatefragment) for additional information.
90
- *
91
- *
92
- * @docGroup
93
- *
94
- * 3. Helper functions
95
- */
96
- updateQuery: (mapFn: UpdateQueryMapFn<TData, TVariables>) => void;
97
- /**
98
- * A function that enables you to re-execute the query, optionally passing in new `variables`.
99
- *
100
- * To guarantee that the refetch performs a network request, its `fetchPolicy` is set to `network-only` (unless the original query's `fetchPolicy` is `no-cache` or `cache-and-network`, which also guarantee a network request).
101
- *
102
- * See also [Refetching](https://www.apollographql.com/docs/react/data/queries/#refetching).
103
- *
104
- * @docGroup
105
- *
106
- * 3. Helper functions
107
- */
108
- refetch: (variables?: Partial<TVariables>) => Promise<ApolloQueryResult<MaybeMasked<TData>>>;
109
- /** @internal */
110
- reobserve: (newOptions?: Partial<WatchQueryOptions<TVariables, TData>>, newNetworkStatus?: NetworkStatus) => Promise<ApolloQueryResult<MaybeMasked<TData>>>;
111
- /**
112
- * An object containing the variables that were provided for the query.
113
- *
114
- * @docGroup
115
- *
116
- * 1. Operation data
117
- */
118
- variables: TVariables | undefined;
119
- /**
120
- * A function that helps you fetch the next set of results for a [paginated list field](https://www.apollographql.com/docs/react/pagination/core-api/).
121
- *
122
- *
123
- * @docGroup
124
- *
125
- * 3. Helper functions
126
- */
127
- fetchMore: <TFetchData = TData, TFetchVars extends OperationVariables = TVariables>(fetchMoreOptions: FetchMoreQueryOptions<TFetchVars, TFetchData> & {
128
- updateQuery?: (previousQueryResult: Unmasked<TData>, options: {
129
- fetchMoreResult: Unmasked<TFetchData>;
130
- variables: TFetchVars;
131
- }) => Unmasked<TData>;
132
- }) => Promise<ApolloQueryResult<MaybeMasked<TFetchData>>>;
133
- }
134
- export interface QueryResult<TData = any, TVariables extends OperationVariables = OperationVariables> extends ObservableQueryFields<TData, TVariables> {
135
- /**
136
- * The instance of Apollo Client that executed the query. Can be useful for manually executing followup queries or writing data to the cache.
137
- *
138
- * @docGroup
139
- *
140
- * 2. Network info
141
- */
142
- client: ApolloClient<any>;
143
- /**
144
- * A reference to the internal `ObservableQuery` used by the hook.
145
- */
146
- observable: ObservableQuery<TData, TVariables>;
147
- /**
148
- * An object containing the result of your GraphQL query after it completes.
149
- *
150
- * This value might be `undefined` if a query results in one or more errors (depending on the query's `errorPolicy`).
151
- *
152
- * @docGroup
153
- *
154
- * 1. Operation data
155
- */
156
- data: MaybeMasked<TData> | undefined;
157
- /**
158
- * An object containing the result from the most recent _previous_ execution of this query.
159
- *
160
- * This value is `undefined` if this is the query's first execution.
161
- *
162
- * @docGroup
163
- *
164
- * 1. Operation data
165
- */
166
- previousData?: MaybeMasked<TData>;
167
- /**
168
- * If the query produces one or more errors, this object contains either an array of `graphQLErrors` or a single `networkError`. Otherwise, this value is `undefined`.
169
- *
170
- * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
171
- *
172
- * @docGroup
173
- *
174
- * 1. Operation data
175
- */
176
- error?: ErrorLike;
177
- /**
178
- * If `true`, the query is still in flight and results have not yet been returned.
179
- *
180
- * @docGroup
181
- *
182
- * 2. Network info
183
- */
184
- loading: boolean;
185
- /**
186
- * A number indicating the current network state of the query's associated request. [See possible values.](https://github.com/apollographql/apollo-client/blob/d96f4578f89b933c281bb775a39503f6cdb59ee8/src/core/networkStatus.ts#L4)
187
- *
188
- * Used in conjunction with the [`notifyOnNetworkStatusChange`](#notifyonnetworkstatuschange) option.
189
- *
190
- * @docGroup
191
- *
192
- * 2. Network info
193
- */
194
- networkStatus: NetworkStatus;
195
- /**
196
- * If `true`, the associated lazy query has been executed.
197
- *
198
- * This field is only present on the result object returned by [`useLazyQuery`](/react/data/queries/#executing-queries-manually).
199
- *
200
- * @docGroup
201
- *
202
- * 2. Network info
203
- */
204
- called: boolean;
205
- }
206
- export interface QueryDataOptions<TData = any, TVariables extends OperationVariables = OperationVariables> extends QueryFunctionOptions<TData, TVariables> {
207
- children?: (result: QueryResult<TData, TVariables>) => ReactTypes.ReactNode;
208
- /**
209
- * A GraphQL query string parsed into an AST with the gql template literal.
210
- *
211
- * @docGroup
212
- *
213
- * 1. Operation options
214
- */
215
- query: DocumentNode | TypedDocumentNode<TData, TVariables>;
216
- }
217
- export interface QueryHookOptions<TData = any, TVariables extends OperationVariables = OperationVariables> extends QueryFunctionOptions<TData, TVariables> {
218
- }
219
- export type SuspenseQueryHookFetchPolicy = Extract<WatchQueryFetchPolicy, "cache-first" | "network-only" | "no-cache" | "cache-and-network">;
220
- export interface SuspenseQueryHookOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables> {
221
- /**
222
- * The instance of `ApolloClient` to use to execute the query.
223
- *
224
- * By default, the instance that's passed down via context is used, but you can provide a different instance here.
225
- *
226
- * @docGroup
227
- *
228
- * 1. Operation options
229
- */
230
- client?: ApolloClient<any>;
231
- /**
232
- * 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.
233
- *
234
- * @docGroup
235
- *
236
- * 2. Networking options
237
- */
238
- context?: DefaultContext;
239
- /**
240
- * An object containing all of the GraphQL variables your query requires to execute.
241
- *
242
- * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
243
- *
244
- * @docGroup
245
- *
246
- * 1. Operation options
247
- */
248
- variables?: TVariables;
249
- /**
250
- * Specifies how the query handles a response that returns both GraphQL errors and partial results.
251
- *
252
- * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
253
- *
254
- * The default value is `none`, meaning that the query result includes error details but not partial results.
255
- *
256
- * @docGroup
257
- *
258
- * 1. Operation options
259
- */
260
- errorPolicy?: ErrorPolicy;
261
- /**
262
- * Whether to canonize cache results before returning them. Canonization takes some extra time, but it speeds up future deep equality comparisons. Defaults to false.
263
- *
264
- * @deprecated
265
- *
266
- * Using `canonizeResults` can result in memory leaks so we generally do not recommend using this option anymore. A future version of Apollo Client will contain a similar feature without the risk of memory leaks.
267
- */
268
- canonizeResults?: boolean;
269
- /**
270
- * If `true`, the query can return partial results from the cache if the cache doesn't contain results for all queried fields.
271
- *
272
- * The default value is `false`.
273
- *
274
- * @docGroup
275
- *
276
- * 3. Caching options
277
- */
278
- returnPartialData?: boolean;
279
- /**
280
- * Watched queries must opt into overwriting existing data on refetch, by passing refetchWritePolicy: "overwrite" in their WatchQueryOptions.
281
- *
282
- * The default value is "overwrite".
283
- *
284
- * @docGroup
285
- *
286
- * 3. Caching options
287
- */
288
- refetchWritePolicy?: RefetchWritePolicy;
289
- /**
290
- * 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).
291
- *
292
- * For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
293
- *
294
- * The default value is `cache-first`.
295
- *
296
- * @docGroup
297
- *
298
- * 3. Caching options
299
- */
300
- fetchPolicy?: SuspenseQueryHookFetchPolicy;
301
- /**
302
- * A unique identifier for the query. Each item in the array must be a stable identifier to prevent infinite fetches.
303
- *
304
- * This is useful when using the same query and variables combination in more than one component, otherwise the components may clobber each other. This can also be used to force the query to re-evaluate fresh.
305
- *
306
- * @docGroup
307
- *
308
- * 1. Operation options
309
- */
310
- queryKey?: string | number | any[];
311
- /**
312
- * If `true`, the query is not executed. The default value is `false`.
313
- *
314
- * @deprecated
315
- *
316
- * We recommend using `skipToken` in place of the `skip` option as it is more type-safe.
317
- *
318
- * This option is deprecated and only supported to ease the migration from useQuery. It will be removed in a future release.
319
- *
320
- * @docGroup
321
- *
322
- * 1. Operation options
323
- *
324
- *
325
- * @example Recommended usage of `skipToken`:
326
- * ```ts
327
- * import { skipToken, useSuspenseQuery } from '@apollo/client';
328
- *
329
- * const { data } = useSuspenseQuery(query, id ? { variables: { id } } : skipToken);
330
- * ```
331
- */
332
- skip?: boolean;
333
- }
334
- export type BackgroundQueryHookFetchPolicy = Extract<WatchQueryFetchPolicy, "cache-first" | "network-only" | "no-cache" | "cache-and-network">;
335
- export interface BackgroundQueryHookOptions<TData = unknown, TVariables extends OperationVariables = OperationVariables> extends Pick<QueryHookOptions<TData, TVariables>, "client" | "variables" | "errorPolicy" | "context" | "canonizeResults" | "returnPartialData" | "refetchWritePolicy"> {
336
- fetchPolicy?: BackgroundQueryHookFetchPolicy;
337
- queryKey?: string | number | any[];
338
- /**
339
- * If `true`, the query is not executed. The default value is `false`.
340
- *
341
- * @deprecated
342
- *
343
- * We recommend using `skipToken` in place of the `skip` option as it is more type-safe.
344
- *
345
- * This option is deprecated and only supported to ease the migration from useQuery. It will be removed in a future release.
346
- *
347
- * @docGroup
348
- *
349
- * 1. Operation options
350
- *
351
- *
352
- * @example Recommended usage of `skipToken`:
353
- * ```ts
354
- * import { skipToken, useBackgroundQuery } from '@apollo/client';
355
- *
356
- * const [queryRef] = useBackgroundQuery(query, id ? { variables: { id } } : skipToken);
357
- * ```
358
- */
359
- skip?: boolean;
360
- }
361
- export type LoadableQueryHookFetchPolicy = Extract<WatchQueryFetchPolicy, "cache-first" | "network-only" | "no-cache" | "cache-and-network">;
362
- export interface LoadableQueryHookOptions {
363
- /**
364
- * Whether to canonize cache results before returning them. Canonization takes some extra time, but it speeds up future deep equality comparisons. Defaults to false.
365
- *
366
- * @deprecated
367
- *
368
- * Using `canonizeResults` can result in memory leaks so we generally do not recommend using this option anymore. A future version of Apollo Client will contain a similar feature without the risk of memory leaks.
369
- */
370
- canonizeResults?: boolean;
371
- /**
372
- * The instance of `ApolloClient` to use to execute the query.
373
- *
374
- * By default, the instance that's passed down via context is used, but you can provide a different instance here.
375
- *
376
- * @docGroup
377
- *
378
- * 1. Operation options
379
- */
380
- client?: ApolloClient<any>;
381
- /**
382
- * 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.
383
- *
384
- * @docGroup
385
- *
386
- * 2. Networking options
387
- */
388
- context?: DefaultContext;
389
- /**
390
- * Specifies how the query handles a response that returns both GraphQL errors and partial results.
391
- *
392
- * For details, see [GraphQL error policies](https://www.apollographql.com/docs/react/data/error-handling/#graphql-error-policies).
393
- *
394
- * The default value is `none`, meaning that the query result includes error details but not partial results.
395
- *
396
- * @docGroup
397
- *
398
- * 1. Operation options
399
- */
400
- errorPolicy?: ErrorPolicy;
401
- /**
402
- * 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).
403
- *
404
- * For details, see [Setting a fetch policy](https://www.apollographql.com/docs/react/data/queries/#setting-a-fetch-policy).
405
- *
406
- * The default value is `cache-first`.
407
- *
408
- * @docGroup
409
- *
410
- * 3. Caching options
411
- */
412
- fetchPolicy?: LoadableQueryHookFetchPolicy;
413
- /**
414
- * A unique identifier for the query. Each item in the array must be a stable identifier to prevent infinite fetches.
415
- *
416
- * This is useful when using the same query and variables combination in more than one component, otherwise the components may clobber each other. This can also be used to force the query to re-evaluate fresh.
417
- *
418
- * @docGroup
419
- *
420
- * 1. Operation options
421
- */
422
- queryKey?: string | number | any[];
423
- /**
424
- * Specifies whether a `NetworkStatus.refetch` operation should merge incoming field data with existing data, or overwrite the existing data. Overwriting is probably preferable, but merging is currently the default behavior, for backwards compatibility with Apollo Client 3.x.
425
- *
426
- * @docGroup
427
- *
428
- * 3. Caching options
429
- */
430
- refetchWritePolicy?: RefetchWritePolicy;
431
- /**
432
- * If `true`, the query can return partial results from the cache if the cache doesn't contain results for all queried fields.
433
- *
434
- * The default value is `false`.
435
- *
436
- * @docGroup
437
- *
438
- * 3. Caching options
439
- */
440
- returnPartialData?: boolean;
441
- }
442
- export type RefetchQueriesFunction = (...args: any[]) => InternalRefetchQueriesInclude;
443
- export interface BaseMutationOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> extends MutationSharedOptions<TData, TVariables, TContext, TCache> {
444
- /**
445
- * The instance of `ApolloClient` to use to execute the mutation.
446
- *
447
- * By default, the instance that's passed down via context is used, but you can provide a different instance here.
448
- *
449
- * @docGroup
450
- *
451
- * 2. Networking options
452
- */
453
- client?: ApolloClient<object>;
454
- /**
455
- * If `true`, the in-progress mutation's associated component re-renders whenever the network status changes or a network error occurs.
456
- *
457
- * The default value is `false`.
458
- *
459
- * @docGroup
460
- *
461
- * 2. Networking options
462
- */
463
- notifyOnNetworkStatusChange?: boolean;
464
- /**
465
- * A callback function that's called when your mutation successfully completes with zero errors (or if `errorPolicy` is `ignore` and partial data is returned).
466
- *
467
- * This function is passed the mutation's result `data` and any options passed to the mutation.
468
- *
469
- * @docGroup
470
- *
471
- * 1. Operation options
472
- */
473
- onCompleted?: (data: MaybeMasked<TData>, clientOptions?: BaseMutationOptions) => void;
474
- /**
475
- * A callback function that's called when the mutation encounters one or more errors (unless `errorPolicy` is `ignore`).
476
- *
477
- * This function is passed an [`ApolloError`](https://github.com/apollographql/apollo-client/blob/d96f4578f89b933c281bb775a39503f6cdb59ee8/src/errors/index.ts#L36-L39) object that contains either a `networkError` object or a `graphQLErrors` array, depending on the error(s) that occurred, as well as any options passed the mutation.
478
- *
479
- * @docGroup
480
- *
481
- * 1. Operation options
482
- */
483
- onError?: (error: ErrorLike, clientOptions?: BaseMutationOptions) => void;
484
- }
485
- export interface MutationFunctionOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> extends BaseMutationOptions<TData, TVariables, TContext, TCache> {
486
- /**
487
- * A GraphQL document, often created with `gql` from the `graphql-tag` package, that contains a single mutation inside of it.
488
- *
489
- * @docGroup
490
- *
491
- * 1. Operation options
492
- */
493
- mutation?: DocumentNode | TypedDocumentNode<TData, TVariables>;
494
- }
495
- export interface MutationResult<TData = any> {
496
- /**
497
- * The data returned from your mutation. Can be `undefined` if `ignoreResults` is `true`.
498
- */
499
- data?: MaybeMasked<TData> | null;
500
- /**
501
- * 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`.
502
- *
503
- * For more information, see [Handling operation errors](https://www.apollographql.com/docs/react/data/error-handling/).
504
- */
505
- error?: ErrorLike;
506
- /**
507
- * If `true`, the mutation is currently in flight.
508
- */
509
- loading: boolean;
510
- /**
511
- * If `true`, the mutation's mutate function has been called.
512
- */
513
- called: boolean;
514
- /**
515
- * The instance of Apollo Client that executed the mutation.
516
- *
517
- * Can be useful for manually executing followup operations or writing data to the cache.
518
- */
519
- client: ApolloClient<object>;
520
- /**
521
- * A function that you can call to reset the mutation's result to its initial, uncalled state.
522
- */
523
- reset: () => void;
524
- }
525
- export declare type MutationFunction<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> = (options?: MutationFunctionOptions<TData, TVariables, TContext, TCache>) => Promise<FetchResult<MaybeMasked<TData>>>;
526
- export interface MutationHookOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> extends BaseMutationOptions<TData, TVariables, TContext, TCache> {
527
- }
528
- export interface MutationDataOptions<TData = any, TVariables = OperationVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> extends BaseMutationOptions<TData, TVariables, TContext, TCache> {
529
- mutation: DocumentNode | TypedDocumentNode<TData, TVariables>;
530
- }
531
- export type MutationTuple<TData, TVariables, TContext = DefaultContext, TCache extends ApolloCache<any> = ApolloCache<any>> = [
532
- mutate: (options?: MutationFunctionOptions<TData, TVariables, TContext, TCache>) => Promise<FetchResult<MaybeMasked<TData>>>,
533
- result: MutationResult<TData>
534
- ];
535
- export interface OnDataOptions<TData = any> {
536
- client: ApolloClient<object>;
537
- data: SubscriptionResult<TData>;
538
- }
539
- export interface OnSubscriptionDataOptions<TData = any> {
540
- client: ApolloClient<object>;
541
- subscriptionData: SubscriptionResult<TData>;
542
- }
543
- export interface BaseSubscriptionOptions<TData = any, TVariables extends OperationVariables = OperationVariables> {
544
- /**
545
- * An object containing all of the variables your subscription needs to execute
546
- */
547
- variables?: TVariables;
548
- /**
549
- * 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).
550
- */
551
- fetchPolicy?: FetchPolicy;
552
- /**
553
- * Specifies the `ErrorPolicy` to be used for this operation
554
- */
555
- errorPolicy?: ErrorPolicy;
556
- /**
557
- * Determines if your subscription should be unsubscribed and subscribed again when an input to the hook (such as `subscription` or `variables`) changes.
558
- */
559
- shouldResubscribe?: boolean | ((options: BaseSubscriptionOptions<TData, TVariables>) => boolean);
560
- /**
561
- * An `ApolloClient` instance. By default `useSubscription` / `Subscription` uses the client passed down via context, but a different client can be passed in.
562
- */
563
- client?: ApolloClient<object>;
564
- /**
565
- * Determines if the current subscription should be skipped. Useful if, for example, variables depend on previous queries and are not ready yet.
566
- */
567
- skip?: boolean;
568
- /**
569
- * Shared context between your component and your network interface (Apollo Link).
570
- */
571
- context?: DefaultContext;
572
- /**
573
- * Shared context between your component and your network interface (Apollo Link).
574
- */
575
- extensions?: Record<string, any>;
576
- /**
577
- * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component completes the subscription.
578
- *
579
- * @since
580
- *
581
- * 3.7.0
582
- */
583
- onComplete?: () => void;
584
- /**
585
- * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives data. The callback `options` object param consists of the current Apollo Client instance in `client`, and the received subscription data in `data`.
586
- *
587
- * @since
588
- *
589
- * 3.7.0
590
- */
591
- onData?: (options: OnDataOptions<TData>) => any;
592
- /**
593
- * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives data. The callback `options` object param consists of the current Apollo Client instance in `client`, and the received subscription data in `subscriptionData`.
594
- *
595
- * @deprecated
596
- *
597
- * Use `onData` instead
598
- */
599
- onSubscriptionData?: (options: OnSubscriptionDataOptions<TData>) => any;
600
- /**
601
- * Allows the registration of a callback function that will be triggered each time the `useSubscription` Hook / `Subscription` component receives an error.
602
- *
603
- * @since
604
- *
605
- * 3.7.0
606
- */
607
- onError?: (error: ErrorLike) => void;
608
- /**
609
- * Allows the registration of a callback function that will be triggered when the `useSubscription` Hook / `Subscription` component completes the subscription.
610
- *
611
- * @deprecated
612
- *
613
- * Use `onComplete` instead
614
- */
615
- onSubscriptionComplete?: () => void;
616
- /**
617
- * If `true`, the hook will not cause the component to rerender. This is useful when you want to control the rendering of your component yourself with logic in the `onData` and `onError` callbacks.
618
- *
619
- * Changing this to `true` when the hook already has `data` will reset the `data` to `undefined`.
620
- *
621
- * @defaultValue `false`
622
- */
623
- ignoreResults?: boolean;
624
- }
625
- export interface SubscriptionResult<TData = any, TVariables = any> {
626
- /**
627
- * A boolean that indicates whether any initial data has been returned
628
- */
629
- loading: boolean;
630
- /**
631
- * An object containing the result of your GraphQL subscription. Defaults to an empty object.
632
- */
633
- data?: MaybeMasked<TData>;
634
- /**
635
- * A runtime error with `graphQLErrors` and `networkError` properties
636
- */
637
- error?: ErrorLike;
638
- /**
639
- * @internal
640
- */
641
- variables?: TVariables;
642
- }
643
- export interface SubscriptionHookOptions<TData = any, TVariables extends OperationVariables = OperationVariables> extends BaseSubscriptionOptions<TData, TVariables> {
644
- }
645
- /**
646
- * @deprecated This type is not used anymore. It will be removed in the next major version of Apollo Client
647
- */
648
- export interface SubscriptionDataOptions<TData = any, TVariables extends OperationVariables = OperationVariables> extends BaseSubscriptionOptions<TData, TVariables> {
649
- subscription: DocumentNode | TypedDocumentNode<TData, TVariables>;
650
- children?: null | ((result: SubscriptionResult<TData>) => ReactTypes.ReactNode);
651
- }
652
- export type VariablesOption<TVariables extends OperationVariables> = [
653
- TVariables
654
- ] extends [never] ? {
655
- /**
656
- * An object containing all of the GraphQL variables your query requires to execute.
657
- *
658
- * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
659
- *
660
- * @docGroup
661
- *
662
- * 1. Operation options
663
- */
664
- variables?: Record<string, never>;
665
- } : Record<string, never> extends OnlyRequiredProperties<TVariables> ? {
666
- /**
667
- * An object containing all of the GraphQL variables your query requires to execute.
668
- *
669
- * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
670
- *
671
- * @docGroup
672
- *
673
- * 1. Operation options
674
- */
675
- variables?: TVariables;
676
- } : {
677
- /**
678
- * An object containing all of the GraphQL variables your query requires to execute.
679
- *
680
- * Each key in the object corresponds to a variable name, and that key's value corresponds to the variable value.
681
- *
682
- * @docGroup
683
- *
684
- * 1. Operation options
685
- */
686
- variables: TVariables;
687
- };
688
- export type { NoInfer } from "../../utilities/index.cjs";
689
- //# sourceMappingURL=types.d.cts.map