@apollo/client 4.3.8 → 4.4.0-alpha.1

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 (324) hide show
  1. package/CHANGELOG.md +76 -3
  2. package/__cjs/cache/core/cache.cjs +50 -15
  3. package/__cjs/cache/core/cache.cjs.map +1 -1
  4. package/__cjs/cache/core/cache.d.cts +22 -4
  5. package/__cjs/cache/index.cjs.map +1 -1
  6. package/__cjs/cache/index.d.cts +1 -1
  7. package/__cjs/cache/inmemory/entityStore.cjs +4 -4
  8. package/__cjs/cache/inmemory/helpers.cjs +12 -0
  9. package/__cjs/cache/inmemory/helpers.cjs.map +1 -1
  10. package/__cjs/cache/inmemory/helpers.d.cts +10 -5
  11. package/__cjs/cache/inmemory/inMemoryCache.cjs +13 -2
  12. package/__cjs/cache/inmemory/inMemoryCache.cjs.map +1 -1
  13. package/__cjs/cache/inmemory/inMemoryCache.d.cts +19 -4
  14. package/__cjs/cache/inmemory/key-extractor.cjs +1 -1
  15. package/__cjs/cache/inmemory/policies.cjs +9 -9
  16. package/__cjs/cache/inmemory/policies.cjs.map +1 -1
  17. package/__cjs/cache/inmemory/policies.d.cts +1 -1
  18. package/__cjs/cache/inmemory/readFromStore.cjs +112 -19
  19. package/__cjs/cache/inmemory/readFromStore.cjs.map +1 -1
  20. package/__cjs/cache/inmemory/types.d.cts +12 -1
  21. package/__cjs/cache/inmemory/writeToStore.cjs +53 -23
  22. package/__cjs/cache/inmemory/writeToStore.cjs.map +1 -1
  23. package/__cjs/cache/inmemory/writeToStore.d.cts +8 -4
  24. package/__cjs/core/ApolloClient.cjs +19 -15
  25. package/__cjs/core/ApolloClient.cjs.map +1 -1
  26. package/__cjs/core/ApolloClient.d.cts +1 -0
  27. package/__cjs/core/ObservableQuery.cjs +8 -8
  28. package/__cjs/core/QueryInfo.cjs +1 -1
  29. package/__cjs/core/QueryManager.cjs +12 -12
  30. package/__cjs/core/RefetchEventManager.cjs +3 -3
  31. package/__cjs/errors/CombinedGraphQLErrors.cjs +3 -7
  32. package/__cjs/errors/CombinedGraphQLErrors.cjs.map +1 -1
  33. package/__cjs/errors/CombinedGraphQLErrors.d.cts +2 -2
  34. package/__cjs/errors/CombinedProtocolErrors.cjs +3 -8
  35. package/__cjs/errors/CombinedProtocolErrors.cjs.map +1 -1
  36. package/__cjs/errors/CombinedProtocolErrors.d.cts +2 -2
  37. package/__cjs/incremental/handlers/graphql17Alpha9.cjs +2 -2
  38. package/__cjs/incremental/handlers/notImplemented.cjs +1 -1
  39. package/__cjs/invariantErrorCodes.cjs +125 -120
  40. package/__cjs/link/batch-http/BaseBatchHttpLink.cjs +9 -18
  41. package/__cjs/link/batch-http/BaseBatchHttpLink.cjs.map +1 -1
  42. package/__cjs/link/batch-http/BaseBatchHttpLink.d.cts +0 -7
  43. package/__cjs/link/core/ApolloLink.cjs +3 -3
  44. package/__cjs/link/http/checkFetcher.cjs +1 -1
  45. package/__cjs/link/http/parseAndCheckHttpResponse.cjs +1 -1
  46. package/__cjs/link/persisted-queries/index.cjs +2 -2
  47. package/__cjs/link/ws/index.cjs +1 -1
  48. package/__cjs/local-state/LocalState.cjs +28 -16
  49. package/__cjs/local-state/LocalState.cjs.map +1 -1
  50. package/__cjs/masking/maskDefinition.cjs +20 -2
  51. package/__cjs/masking/maskDefinition.cjs.map +1 -1
  52. package/__cjs/masking/maskFragment.cjs +2 -2
  53. package/__cjs/masking/maskOperation.cjs +1 -1
  54. package/__cjs/masking/utils.cjs +3 -3
  55. package/__cjs/react/context/ApolloContext.cjs +1 -1
  56. package/__cjs/react/context/ApolloProvider.cjs +1 -1
  57. package/__cjs/react/hooks/internal/validateSuspenseHookOptions.cjs +2 -2
  58. package/__cjs/react/hooks/useApolloClient.cjs +1 -1
  59. package/__cjs/react/hooks/useFragment.cjs +8 -2
  60. package/__cjs/react/hooks/useFragment.cjs.map +1 -1
  61. package/__cjs/react/hooks/useLazyQuery.cjs +2 -2
  62. package/__cjs/react/hooks/useLoadableQuery.cjs +2 -2
  63. package/__cjs/react/hooks/useSubscription.cjs +1 -1
  64. package/__cjs/react/hooks/useSuspenseFragment.cjs +10 -4
  65. package/__cjs/react/hooks/useSuspenseFragment.cjs.map +1 -1
  66. package/__cjs/react/hooks/useSyncExternalStore.cjs +1 -1
  67. package/__cjs/react/internal/cache/FragmentReference.cjs +2 -2
  68. package/__cjs/react/internal/cache/FragmentReference.cjs.map +1 -1
  69. package/__cjs/react/internal/cache/FragmentReference.d.cts +4 -5
  70. package/__cjs/react/internal/cache/QueryReference.cjs +1 -1
  71. package/__cjs/react/internal/cache/SuspenseCache.cjs +3 -3
  72. package/__cjs/react/internal/cache/SuspenseCache.cjs.map +1 -1
  73. package/__cjs/react/internal/cache/SuspenseCache.d.cts +4 -5
  74. package/__cjs/react/internal/cache/types.d.cts +0 -5
  75. package/__cjs/react/ssr/prerenderStatic.cjs +2 -2
  76. package/__cjs/testing/core/mocking/mockLink.cjs +4 -4
  77. package/__cjs/utilities/graphql/DocumentTransform.cjs +1 -1
  78. package/__cjs/utilities/internal/DeepMerger.cjs +6 -2
  79. package/__cjs/utilities/internal/DeepMerger.cjs.map +1 -1
  80. package/__cjs/utilities/internal/DeepMerger.d.cts +13 -3
  81. package/__cjs/utilities/internal/argumentsObjectFromField.cjs.map +1 -1
  82. package/__cjs/utilities/internal/argumentsObjectFromField.d.cts +2 -2
  83. package/__cjs/utilities/internal/constants.cjs +33 -1
  84. package/__cjs/utilities/internal/constants.cjs.map +1 -1
  85. package/__cjs/utilities/internal/constants.d.cts +32 -0
  86. package/__cjs/utilities/internal/createArgumentNode.cjs +14 -0
  87. package/__cjs/utilities/internal/createArgumentNode.cjs.map +1 -0
  88. package/__cjs/utilities/internal/createArgumentNode.d.cts +3 -0
  89. package/__cjs/utilities/internal/createDirectiveNode.cjs +14 -0
  90. package/__cjs/utilities/internal/createDirectiveNode.cjs.map +1 -0
  91. package/__cjs/utilities/internal/createDirectiveNode.d.cts +3 -0
  92. package/__cjs/utilities/internal/createFragmentArgumentNode.cjs +13 -0
  93. package/__cjs/utilities/internal/createFragmentArgumentNode.cjs.map +1 -0
  94. package/__cjs/utilities/internal/createFragmentArgumentNode.d.cts +3 -0
  95. package/__cjs/utilities/internal/createFragmentSpreadNode.cjs +20 -0
  96. package/__cjs/utilities/internal/createFragmentSpreadNode.cjs.map +1 -0
  97. package/__cjs/utilities/internal/createFragmentSpreadNode.d.cts +6 -0
  98. package/__cjs/utilities/internal/createNameNode.cjs +8 -0
  99. package/__cjs/utilities/internal/createNameNode.cjs.map +1 -0
  100. package/__cjs/utilities/internal/createNameNode.d.cts +3 -0
  101. package/__cjs/utilities/internal/createValueNode.cjs +27 -0
  102. package/__cjs/utilities/internal/createValueNode.cjs.map +1 -0
  103. package/__cjs/utilities/internal/createValueNode.d.cts +12 -0
  104. package/__cjs/utilities/internal/createVariableNode.cjs +9 -0
  105. package/__cjs/utilities/internal/createVariableNode.cjs.map +1 -0
  106. package/__cjs/utilities/internal/createVariableNode.d.cts +3 -0
  107. package/__cjs/utilities/internal/equalByQuery.cjs +16 -3
  108. package/__cjs/utilities/internal/equalByQuery.cjs.map +1 -1
  109. package/__cjs/utilities/internal/equalByQuery.d.cts +2 -3
  110. package/__cjs/utilities/internal/getDefaultValues.cjs.map +1 -1
  111. package/__cjs/utilities/internal/getDefaultValues.d.cts +2 -2
  112. package/__cjs/utilities/internal/getFragmentDefinition.cjs +3 -3
  113. package/__cjs/utilities/internal/getFragmentDefinition.cjs.map +1 -1
  114. package/__cjs/utilities/internal/getFragmentFromSelection.cjs +1 -1
  115. package/__cjs/utilities/internal/getFragmentQueryDocument.cjs +20 -9
  116. package/__cjs/utilities/internal/getFragmentQueryDocument.cjs.map +1 -1
  117. package/__cjs/utilities/internal/getFragmentScope.cjs +23 -0
  118. package/__cjs/utilities/internal/getFragmentScope.cjs.map +1 -0
  119. package/__cjs/utilities/internal/getFragmentScope.d.cts +13 -0
  120. package/__cjs/utilities/internal/getFragmentVariables.cjs +33 -0
  121. package/__cjs/utilities/internal/getFragmentVariables.cjs.map +1 -0
  122. package/__cjs/utilities/internal/getFragmentVariables.d.cts +12 -0
  123. package/__cjs/utilities/internal/getMainDefinition.cjs +1 -1
  124. package/__cjs/utilities/internal/getQueryDefinition.cjs +1 -1
  125. package/__cjs/utilities/internal/index.cjs +11 -2
  126. package/__cjs/utilities/internal/index.cjs.map +1 -1
  127. package/__cjs/utilities/internal/index.d.cts +6 -1
  128. package/__cjs/utilities/internal/isNonEmptyObject.cjs +13 -0
  129. package/__cjs/utilities/internal/isNonEmptyObject.cjs.map +1 -0
  130. package/__cjs/utilities/internal/isNonEmptyObject.d.cts +7 -0
  131. package/__cjs/utilities/internal/isNonNullObject.cjs.map +1 -1
  132. package/__cjs/utilities/internal/isNonNullObject.d.cts +1 -1
  133. package/__cjs/utilities/internal/mapObservableFragment.cjs +14 -9
  134. package/__cjs/utilities/internal/mapObservableFragment.cjs.map +1 -1
  135. package/__cjs/utilities/internal/mapObservableFragment.d.cts +5 -1
  136. package/__cjs/utilities/internal/mergeDeepArray.cjs +2 -2
  137. package/__cjs/utilities/internal/mergeDeepArray.cjs.map +1 -1
  138. package/__cjs/utilities/internal/mergeDeepArray.d.cts +2 -1
  139. package/__cjs/utilities/internal/removeDirectivesFromDocument.cjs +121 -62
  140. package/__cjs/utilities/internal/removeDirectivesFromDocument.cjs.map +1 -1
  141. package/__cjs/utilities/internal/removeFragmentSpreads.cjs +55 -2
  142. package/__cjs/utilities/internal/removeFragmentSpreads.cjs.map +1 -1
  143. package/__cjs/utilities/internal/removeFragmentSpreads.d.cts +17 -1
  144. package/__cjs/utilities/internal/shouldInclude.cjs +4 -4
  145. package/__cjs/utilities/internal/types/FragmentInfo.cjs +3 -0
  146. package/__cjs/utilities/internal/types/FragmentInfo.cjs.map +1 -0
  147. package/__cjs/utilities/internal/types/FragmentInfo.d.cts +14 -0
  148. package/__cjs/utilities/internal/types/Mutable.cjs +3 -0
  149. package/__cjs/utilities/internal/types/Mutable.cjs.map +1 -0
  150. package/__cjs/utilities/internal/types/Mutable.d.cts +4 -0
  151. package/__cjs/utilities/internal/types/ObjectWithFragmentInfo.cjs +3 -0
  152. package/__cjs/utilities/internal/types/ObjectWithFragmentInfo.cjs.map +1 -0
  153. package/__cjs/utilities/internal/types/ObjectWithFragmentInfo.d.cts +13 -0
  154. package/__cjs/utilities/internal/valueToObjectRepresentation.cjs +1 -1
  155. package/__cjs/version.cjs +1 -1
  156. package/__cjs/version.cjs.map +1 -1
  157. package/cache/core/cache.d.ts +22 -4
  158. package/cache/core/cache.js +51 -16
  159. package/cache/core/cache.js.map +1 -1
  160. package/cache/index.d.ts +1 -1
  161. package/cache/index.js.map +1 -1
  162. package/cache/inmemory/entityStore.js +4 -4
  163. package/cache/inmemory/helpers.d.ts +10 -5
  164. package/cache/inmemory/helpers.js +12 -1
  165. package/cache/inmemory/helpers.js.map +1 -1
  166. package/cache/inmemory/inMemoryCache.d.ts +19 -4
  167. package/cache/inmemory/inMemoryCache.js +14 -3
  168. package/cache/inmemory/inMemoryCache.js.map +1 -1
  169. package/cache/inmemory/key-extractor.js +1 -1
  170. package/cache/inmemory/policies.d.ts +1 -1
  171. package/cache/inmemory/policies.js +9 -9
  172. package/cache/inmemory/policies.js.map +1 -1
  173. package/cache/inmemory/readFromStore.js +115 -22
  174. package/cache/inmemory/readFromStore.js.map +1 -1
  175. package/cache/inmemory/types.d.ts +12 -1
  176. package/cache/inmemory/types.js.map +1 -1
  177. package/cache/inmemory/writeToStore.d.ts +8 -4
  178. package/cache/inmemory/writeToStore.js +56 -26
  179. package/cache/inmemory/writeToStore.js.map +1 -1
  180. package/core/ApolloClient.d.ts +1 -0
  181. package/core/ApolloClient.js +20 -16
  182. package/core/ApolloClient.js.map +1 -1
  183. package/core/ObservableQuery.js +8 -8
  184. package/core/QueryInfo.js +1 -1
  185. package/core/QueryManager.js +12 -12
  186. package/core/RefetchEventManager.js +3 -3
  187. package/errors/CombinedGraphQLErrors.d.ts +2 -2
  188. package/errors/CombinedGraphQLErrors.js +3 -7
  189. package/errors/CombinedGraphQLErrors.js.map +1 -1
  190. package/errors/CombinedProtocolErrors.d.ts +2 -2
  191. package/errors/CombinedProtocolErrors.js +3 -8
  192. package/errors/CombinedProtocolErrors.js.map +1 -1
  193. package/incremental/handlers/graphql17Alpha9.js +2 -2
  194. package/incremental/handlers/notImplemented.js +1 -1
  195. package/invariantErrorCodes.js +125 -120
  196. package/link/batch-http/BaseBatchHttpLink.d.ts +0 -7
  197. package/link/batch-http/BaseBatchHttpLink.js +9 -18
  198. package/link/batch-http/BaseBatchHttpLink.js.map +1 -1
  199. package/link/core/ApolloLink.js +3 -3
  200. package/link/http/checkFetcher.js +1 -1
  201. package/link/http/parseAndCheckHttpResponse.js +1 -1
  202. package/link/persisted-queries/index.js +2 -2
  203. package/link/ws/index.js +1 -1
  204. package/local-state/LocalState.js +29 -17
  205. package/local-state/LocalState.js.map +1 -1
  206. package/masking/maskDefinition.js +21 -3
  207. package/masking/maskDefinition.js.map +1 -1
  208. package/masking/maskFragment.js +2 -2
  209. package/masking/maskOperation.js +1 -1
  210. package/masking/utils.js +3 -3
  211. package/package.json +2 -2
  212. package/react/context/ApolloContext.js +1 -1
  213. package/react/context/ApolloProvider.js +1 -1
  214. package/react/hooks/internal/validateSuspenseHookOptions.js +2 -2
  215. package/react/hooks/useApolloClient.js +1 -1
  216. package/react/hooks/useFragment.js +8 -2
  217. package/react/hooks/useFragment.js.map +1 -1
  218. package/react/hooks/useLazyQuery.js +2 -2
  219. package/react/hooks/useLoadableQuery.js +2 -2
  220. package/react/hooks/useSubscription.js +1 -1
  221. package/react/hooks/useSuspenseFragment.js +10 -4
  222. package/react/hooks/useSuspenseFragment.js.map +1 -1
  223. package/react/hooks/useSyncExternalStore.js +1 -1
  224. package/react/hooks-compiled/internal/validateSuspenseHookOptions.js +2 -2
  225. package/react/hooks-compiled/useApolloClient.js +1 -1
  226. package/react/hooks-compiled/useFragment.js +56 -32
  227. package/react/hooks-compiled/useFragment.js.map +1 -1
  228. package/react/hooks-compiled/useLazyQuery.js +2 -2
  229. package/react/hooks-compiled/useLoadableQuery.js +2 -2
  230. package/react/hooks-compiled/useSubscription.js +1 -1
  231. package/react/hooks-compiled/useSuspenseFragment.js +10 -4
  232. package/react/hooks-compiled/useSuspenseFragment.js.map +1 -1
  233. package/react/hooks-compiled/useSyncExternalStore.js +1 -1
  234. package/react/internal/cache/FragmentReference.d.ts +4 -5
  235. package/react/internal/cache/FragmentReference.js +2 -2
  236. package/react/internal/cache/FragmentReference.js.map +1 -1
  237. package/react/internal/cache/QueryReference.js +1 -1
  238. package/react/internal/cache/SuspenseCache.d.ts +4 -5
  239. package/react/internal/cache/SuspenseCache.js +3 -3
  240. package/react/internal/cache/SuspenseCache.js.map +1 -1
  241. package/react/internal/cache/types.d.ts +0 -5
  242. package/react/internal/cache/types.js.map +1 -1
  243. package/react/ssr/prerenderStatic.js +2 -2
  244. package/testing/core/mocking/mockLink.js +4 -4
  245. package/utilities/graphql/DocumentTransform.js +1 -1
  246. package/utilities/internal/DeepMerger.d.ts +13 -3
  247. package/utilities/internal/DeepMerger.js +6 -2
  248. package/utilities/internal/DeepMerger.js.map +1 -1
  249. package/utilities/internal/argumentsObjectFromField.d.ts +2 -2
  250. package/utilities/internal/argumentsObjectFromField.js.map +1 -1
  251. package/utilities/internal/constants.d.ts +32 -0
  252. package/utilities/internal/constants.js +32 -0
  253. package/utilities/internal/constants.js.map +1 -1
  254. package/utilities/internal/createArgumentNode.d.ts +3 -0
  255. package/utilities/internal/createArgumentNode.js +11 -0
  256. package/utilities/internal/createArgumentNode.js.map +1 -0
  257. package/utilities/internal/createDirectiveNode.d.ts +3 -0
  258. package/utilities/internal/createDirectiveNode.js +11 -0
  259. package/utilities/internal/createDirectiveNode.js.map +1 -0
  260. package/utilities/internal/createFragmentArgumentNode.d.ts +3 -0
  261. package/utilities/internal/createFragmentArgumentNode.js +10 -0
  262. package/utilities/internal/createFragmentArgumentNode.js.map +1 -0
  263. package/utilities/internal/createFragmentSpreadNode.d.ts +6 -0
  264. package/utilities/internal/createFragmentSpreadNode.js +17 -0
  265. package/utilities/internal/createFragmentSpreadNode.js.map +1 -0
  266. package/utilities/internal/createNameNode.d.ts +3 -0
  267. package/utilities/internal/createNameNode.js +5 -0
  268. package/utilities/internal/createNameNode.js.map +1 -0
  269. package/utilities/internal/createValueNode.d.ts +12 -0
  270. package/utilities/internal/createValueNode.js +24 -0
  271. package/utilities/internal/createValueNode.js.map +1 -0
  272. package/utilities/internal/createVariableNode.d.ts +3 -0
  273. package/utilities/internal/createVariableNode.js +6 -0
  274. package/utilities/internal/createVariableNode.js.map +1 -0
  275. package/utilities/internal/equalByQuery.d.ts +2 -3
  276. package/utilities/internal/equalByQuery.js +16 -3
  277. package/utilities/internal/equalByQuery.js.map +1 -1
  278. package/utilities/internal/getDefaultValues.d.ts +2 -2
  279. package/utilities/internal/getDefaultValues.js.map +1 -1
  280. package/utilities/internal/getFragmentDefinition.js +3 -3
  281. package/utilities/internal/getFragmentDefinition.js.map +1 -1
  282. package/utilities/internal/getFragmentFromSelection.js +1 -1
  283. package/utilities/internal/getFragmentQueryDocument.js +20 -9
  284. package/utilities/internal/getFragmentQueryDocument.js.map +1 -1
  285. package/utilities/internal/getFragmentScope.d.ts +13 -0
  286. package/utilities/internal/getFragmentScope.js +20 -0
  287. package/utilities/internal/getFragmentScope.js.map +1 -0
  288. package/utilities/internal/getFragmentVariables.d.ts +12 -0
  289. package/utilities/internal/getFragmentVariables.js +30 -0
  290. package/utilities/internal/getFragmentVariables.js.map +1 -0
  291. package/utilities/internal/getMainDefinition.js +1 -1
  292. package/utilities/internal/getQueryDefinition.js +1 -1
  293. package/utilities/internal/index.d.ts +6 -1
  294. package/utilities/internal/index.js +4 -1
  295. package/utilities/internal/index.js.map +1 -1
  296. package/utilities/internal/isNonEmptyObject.d.ts +7 -0
  297. package/utilities/internal/isNonEmptyObject.js +10 -0
  298. package/utilities/internal/isNonEmptyObject.js.map +1 -0
  299. package/utilities/internal/isNonNullObject.d.ts +1 -1
  300. package/utilities/internal/isNonNullObject.js.map +1 -1
  301. package/utilities/internal/mapObservableFragment.d.ts +5 -1
  302. package/utilities/internal/mapObservableFragment.js +14 -9
  303. package/utilities/internal/mapObservableFragment.js.map +1 -1
  304. package/utilities/internal/mergeDeepArray.d.ts +2 -1
  305. package/utilities/internal/mergeDeepArray.js +2 -2
  306. package/utilities/internal/mergeDeepArray.js.map +1 -1
  307. package/utilities/internal/removeDirectivesFromDocument.js +121 -62
  308. package/utilities/internal/removeDirectivesFromDocument.js.map +1 -1
  309. package/utilities/internal/removeFragmentSpreads.d.ts +18 -2
  310. package/utilities/internal/removeFragmentSpreads.js +56 -3
  311. package/utilities/internal/removeFragmentSpreads.js.map +1 -1
  312. package/utilities/internal/shouldInclude.js +4 -4
  313. package/utilities/internal/types/FragmentInfo.d.ts +14 -0
  314. package/utilities/internal/types/FragmentInfo.js +2 -0
  315. package/utilities/internal/types/FragmentInfo.js.map +1 -0
  316. package/utilities/internal/types/Mutable.d.ts +4 -0
  317. package/utilities/internal/types/Mutable.js +2 -0
  318. package/utilities/internal/types/Mutable.js.map +1 -0
  319. package/utilities/internal/types/ObjectWithFragmentInfo.d.ts +13 -0
  320. package/utilities/internal/types/ObjectWithFragmentInfo.js +2 -0
  321. package/utilities/internal/types/ObjectWithFragmentInfo.js.map +1 -0
  322. package/utilities/internal/valueToObjectRepresentation.js +1 -1
  323. package/version.js +1 -1
  324. package/version.js.map +1 -1
package/CHANGELOG.md CHANGED
@@ -1,10 +1,83 @@
1
1
  # @apollo/client
2
2
 
3
- ## 4.3.8
3
+ ## 4.4.0-alpha.1
4
4
 
5
- ### Patch Changes
5
+ ### Minor Changes
6
+
7
+ - [#13522](https://github.com/apollographql/apollo-client/pull/13522) [`6f94cfb`](https://github.com/apollographql/apollo-client/commit/6f94cfb11b2f386fdd22275113ef87e0282f2b23) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fragment APIs now read fragment arguments and operation variables from the object passed to `from`. When you pass an object from a query result, you no longer need to pass `variables` to read the fragment with the correct values.
8
+
9
+ ```ts
10
+ const fragment = gql`
11
+ fragment UserCard($avatarSize: Int) on User {
12
+ id
13
+ avatar(size: $avatarSize)
14
+ }
15
+ `;
16
+
17
+ const query = gql`
18
+ query GetUsers($friendAvatarSize: Int) {
19
+ currentUser {
20
+ ...UserCard(avatarSize: 96)
21
+ friends {
22
+ ...UserCard(avatarSize: $friendAvatarSize)
23
+ }
24
+ }
25
+ }
26
+ `;
27
+
28
+ const { data } = useQuery(query, { variables: { friendAvatarSize: 32 } });
29
+
30
+ // Reads the avatar with `size: 96`
31
+ useFragment({ fragment, from: data.currentUser });
32
+
33
+ // Reads the avatars with `size: 32`
34
+ useFragment({ fragment, from: data.currentUser.friends });
35
+ ```
36
+
37
+ This works with `useFragment`, `useSuspenseFragment`, `watchFragment`, `readFragment`, `writeFragment`, and `updateFragment`. The same applies to fragments that use operation variables without fragment arguments.
38
+
39
+ - [#13521](https://github.com/apollographql/apollo-client/pull/13521) [`7bd29db`](https://github.com/apollographql/apollo-client/commit/7bd29db1297e3e909f5226fae9efd1cd196f81f1) Thanks [@phryneas](https://github.com/phryneas)! - `CombinedGraphQLErrors` and `CombinedProtocolErrors` now extend `AggregateError`.
40
+ This means that you will need to use at least `lib: ["es2021"]` or `lib: ["es2021.promise"]` in your TypeScript configuration.
41
+
42
+ ## 4.4.0-alpha.0
43
+
44
+ ### Minor Changes
45
+
46
+ - [#13508](https://github.com/apollographql/apollo-client/pull/13508) [`c1558e3`](https://github.com/apollographql/apollo-client/commit/c1558e3c96e9948de863f14a856ec770c344f5c2) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Support GraphQL 17 experimental fragment arguments. Fragment definitions can now include variable definitions, and fragment spreads can pass arguments for them.
47
+
48
+ ```graphql
49
+ fragment UserFragment($avatarSize: Int!) on User {
50
+ id
51
+ avatar(size: $avatarSize)
52
+ }
53
+ ```
54
+
55
+ Arguments can be passed to the fragment where it's used:
56
+
57
+ ```graphql
58
+ query CurrentUserQuery($friendAvatarSize: Int!) {
59
+ currentUser {
60
+ id
61
+ ...UserFragment(avatarSize: 32)
62
+
63
+ friends {
64
+ id
65
+ ...UserFragment(avatarSize: $friendAvatarSize)
66
+ }
67
+ }
68
+ }
69
+ ```
70
+
71
+ You must enable experimental fragment arguments to use this feature:
6
72
 
7
- - [#13470](https://github.com/apollographql/apollo-client/pull/13470) [`6bc13c8`](https://github.com/apollographql/apollo-client/commit/6bc13c88e4bf798083094c4ad0d492af83693ea1) Thanks [@phryneas](https://github.com/phryneas)! - Add a new option, `batchHybridRequests` to `BatchHttpLink`. This allows it to combine persisted and non-persisted queries in one shared batch.
73
+ ```ts
74
+ import { enableExperimentalFragmentVariables } from "@apollo/client";
75
+
76
+ enableExperimentalFragmentVariables();
77
+ ```
78
+
79
+ > [!NOTE]
80
+ > This MUST be called before any GraphQL documents are parsed. We recommend calling this in your application's entry file.
8
81
 
9
82
  ## 4.3.7
10
83
 
@@ -16,6 +16,14 @@ const internal_1 = require("@apollo/client/utilities/internal");
16
16
  const invariant_1 = require("@apollo/client/utilities/invariant");
17
17
  class ApolloCache {
18
18
  assumeImmutableResults = false;
19
+ /**
20
+ * @internal
21
+ * Used to determine whether the cache supports passing fragment variables
22
+ * in the result object.
23
+ *
24
+ * @deprecated This is an internal API and should not be used directly. This can be removed or changed at any time.
25
+ */
26
+ [internal_1.supportsFragmentVariablesSymbol];
19
27
  // Function used to lookup a fragment when a fragment definition is not part
20
28
  // of the GraphQL document. This is useful for caches, such as InMemoryCache,
21
29
  // that register fragments ahead of time so they can be referenced by name.
@@ -140,6 +148,7 @@ class ApolloCache {
140
148
  });
141
149
  }
142
150
  fragmentWatches = new trie_1.Trie(true);
151
+ fragmentArrayWatches = new trie_1.Trie(true);
143
152
  /**
144
153
  * Watches the cache store of the fragment according to the options specified
145
154
  * and returns an `Observable`. We can subscribe to this
@@ -157,8 +166,9 @@ class ApolloCache {
157
166
  * to optimistic updates.
158
167
  */
159
168
  watchFragment(options) {
160
- const { fragment, fragmentName, from } = options;
161
- const query = this.getFragmentDoc(fragment, fragmentName);
169
+ const { fragment, from } = options;
170
+ const query = this.getFragmentDoc(fragment, options.fragmentName);
171
+ const fragmentName = options.fragmentName || (0, internal_1.getFragmentDefinition)(fragment).name.value;
162
172
  const fromArray = Array.isArray(from) ? from : [from];
163
173
  const ids = fromArray.map((value) => {
164
174
  // While our TypeScript types do not allow for `undefined` as a valid
@@ -169,15 +179,17 @@ class ApolloCache {
169
179
  // warning.
170
180
  const id = value == null ? value : this.toCacheId(value);
171
181
  if (environment_1.__DEV__) {
172
- const actualFragmentName = fragmentName || (0, internal_1.getFragmentDefinition)(fragment).name.value;
173
182
  if (id === undefined) {
174
- __DEV__ && invariant_1.invariant.warn(128, actualFragmentName);
183
+ __DEV__ && invariant_1.invariant.warn(129, fragmentName);
175
184
  }
176
185
  }
177
186
  return id === undefined ? null : id;
178
187
  });
179
188
  if (!Array.isArray(from)) {
180
- const observable = this.watchSingleFragment(ids[0], query, options);
189
+ const observable = this.watchSingleFragment(ids[0], query, {
190
+ ...options,
191
+ ...this.getFragmentVariablesOptions(fragmentName, from?.[internal_1.fragmentInfoSymbol], options.variables),
192
+ });
181
193
  // Unfortunately we forgot to allow for `null` on watchFragment in 4.0
182
194
  // when `from` is a single record. As such, we need to fallback to {}
183
195
  // when diff.result is null to maintain backwards compatibility. We
@@ -217,12 +229,19 @@ class ApolloCache {
217
229
  return emptyArrayObservable;
218
230
  }
219
231
  let subscribed = false;
220
- const observables = ids.map((id) => this.watchSingleFragment(id, query, options));
232
+ const observables = ids.map((id, idx) => this.watchSingleFragment(id, query, {
233
+ ...options,
234
+ ...this.getFragmentVariablesOptions(fragmentName, from[idx]?.[internal_1.fragmentInfoSymbol], options.variables),
235
+ }));
236
+ const cacheEntry = this.fragmentArrayWatches.lookupArray(observables);
237
+ if (cacheEntry.observable) {
238
+ return cacheEntry.observable;
239
+ }
221
240
  const observable = (0, internal_1.combineLatestBatched)(observables).pipe((0, rxjs_1.map)(toResult), (0, rxjs_1.tap)({
222
241
  subscribe: () => (subscribed = true),
223
242
  unsubscribe: () => (subscribed = false),
224
243
  }), (0, rxjs_1.shareReplay)({ bufferSize: 1, refCount: true }));
225
- return Object.assign(observable, {
244
+ return (cacheEntry.observable = Object.assign(observable, {
226
245
  getCurrentResult: () => {
227
246
  if (subscribed && currentResult) {
228
247
  return currentResult;
@@ -230,7 +249,7 @@ class ApolloCache {
230
249
  const results = observables.map((observable) => observable.getCurrentResult());
231
250
  return toResult(results);
232
251
  },
233
- });
252
+ }));
234
253
  }
235
254
  /**
236
255
  * Can be overridden by subclasses to delay calling the provided callback
@@ -242,10 +261,10 @@ class ApolloCache {
242
261
  if (id === null) {
243
262
  return nullObservable;
244
263
  }
245
- const { optimistic = true, variables } = options;
264
+ const { optimistic = true, variables, [internal_1.rootFragmentVariablesSymbol]: rootFragmentVariables, } = options;
246
265
  const cacheKey = [
247
266
  fragmentQuery,
248
- (0, utilities_1.canonicalStringify)({ id, optimistic, variables }),
267
+ (0, utilities_1.canonicalStringify)({ id, optimistic, variables, rootFragmentVariables }),
249
268
  ];
250
269
  const cacheEntry = this.fragmentWatches.lookupArray(cacheKey);
251
270
  if (!cacheEntry.observable) {
@@ -254,7 +273,7 @@ class ApolloCache {
254
273
  function getNewestResult(diff) {
255
274
  const data = diff.result;
256
275
  if (!currentResult ||
257
- !(0, internal_1.equalByQuery)(fragmentQuery, { data: currentResult.data }, { data }, options.variables)) {
276
+ !(0, internal_1.equalByQuery)(fragmentQuery, { data: currentResult.data }, { data }, options.variables, rootFragmentVariables)) {
258
277
  currentResult = {
259
278
  data,
260
279
  dataState: diff.complete ? "complete" : "partial",
@@ -275,6 +294,7 @@ class ApolloCache {
275
294
  query: fragmentQuery,
276
295
  optimistic,
277
296
  immediate: true,
297
+ [internal_1.rootFragmentVariablesSymbol]: rootFragmentVariables,
278
298
  callback: (diff) => {
279
299
  observable.dirty = true;
280
300
  this.onAfterBroadcast(() => {
@@ -305,6 +325,7 @@ class ApolloCache {
305
325
  returnPartialData: true,
306
326
  optimistic,
307
327
  variables,
328
+ [internal_1.rootFragmentVariablesSymbol]: rootFragmentVariables,
308
329
  }));
309
330
  },
310
331
  });
@@ -320,12 +341,14 @@ class ApolloCache {
320
341
  makeCacheKey: (0, internal_1.bindCacheKey)(this),
321
342
  });
322
343
  readFragment(options, optimistic = !!options.optimistic) {
323
- const id = options.from !== undefined ? this.toCacheId(options.from) : options.id;
344
+ const { from, fragment, fragmentName, variables } = options;
345
+ const id = from !== undefined ? this.toCacheId(from) : options.id;
324
346
  return this.read({
325
347
  ...options,
326
- query: this.getFragmentDoc(options.fragment, options.fragmentName),
348
+ query: this.getFragmentDoc(fragment, fragmentName),
327
349
  rootId: id,
328
350
  optimistic,
351
+ ...this.getFragmentVariablesOptions(fragmentName ?? (0, internal_1.getFragmentDefinition)(fragment).name.value, from?.[internal_1.fragmentInfoSymbol], variables),
329
352
  });
330
353
  }
331
354
  writeQuery({ id, data, ...options }) {
@@ -334,12 +357,14 @@ class ApolloCache {
334
357
  result: data,
335
358
  }));
336
359
  }
337
- writeFragment({ data, fragment, fragmentName, ...options }) {
338
- const id = options.from !== undefined ? this.toCacheId(options.from) : options.id;
360
+ writeFragment({ data, fragment, fragmentName, from, ...options }) {
361
+ const id = from !== undefined ? this.toCacheId(from) : options.id;
339
362
  return this.write(Object.assign(options, {
340
363
  query: this.getFragmentDoc(fragment, fragmentName),
341
364
  dataId: id,
342
365
  result: data,
366
+ ...this.getFragmentVariablesOptions(fragmentName || (0, internal_1.getFragmentDefinition)(fragment).name.value, from?.[internal_1.fragmentInfoSymbol] ||
367
+ data?.[internal_1.fragmentInfoSymbol], options.variables),
343
368
  }));
344
369
  }
345
370
  updateQuery(options, update) {
@@ -369,6 +394,16 @@ class ApolloCache {
369
394
  toCacheId(from) {
370
395
  return typeof from === "string" ? from : this.identify(from);
371
396
  }
397
+ getFragmentVariablesOptions(fragmentName, fragmentInfo, variables) {
398
+ if (this[internal_1.supportsFragmentVariablesSymbol] &&
399
+ fragmentInfo &&
400
+ !(0, internal_1.isNonEmptyObject)(variables)) {
401
+ return {
402
+ variables: fragmentInfo.operationVariables,
403
+ [internal_1.rootFragmentVariablesSymbol]: fragmentInfo.fragments[fragmentName]?.variables,
404
+ };
405
+ }
406
+ }
372
407
  }
373
408
  exports.ApolloCache = ApolloCache;
374
409
  if (environment_1.__DEV__) {