@apollo/client 3.9.0-alpha.4 → 3.9.0-beta.0

package/.changeset/README.md

@@ -0,0 +1,8 @@
+# Changesets
+
+Hello and welcome! This folder has been automatically generated by `@changesets/cli`, a build tool that works
+with multi-package repos, or single-package repos to help you version and publish your code. You can
+find the full documentation for it [in our repository](https://github.com/changesets/changesets)
+
+We have a quick list of common questions to get you started engaging with this project in
+[our documentation](https://github.com/changesets/changesets/blob/main/docs/common-questions.md)

package/.changeset/beige-geese-wink.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Decouple `canonicalStringify` from `ObjectCanon` for better time and memory performance.

package/.changeset/breezy-spiders-tap.md

@@ -0,0 +1,38 @@
+---
+"@apollo/client": patch
+---
+
+Add a `defaultContext` option and property on `ApolloClient`, e.g. for keeping track of changing auth tokens or dependency injection.
+
+This can be used e.g. in authentication scenarios, where a new token might be
+generated outside of the link chain and should passed into the link chain.
+
+```js
+import { ApolloClient, createHttpLink, InMemoryCache } from '@apollo/client';
+import { setContext } from '@apollo/client/link/context';
+
+const httpLink = createHttpLink({
+  uri: '/graphql',
+});
+
+const authLink = setContext((_, { headers, token }) => {
+  return {
+    headers: {
+      ...headers,
+      authorization: token ? `Bearer ${token}` : "",
+    }
+  }
+});
+
+const client = new ApolloClient({
+  link: authLink.concat(httpLink),
+  cache: new InMemoryCache()
+});
+
+// somewhere else in your application
+function onNewToken(newToken) {
+  // token can now be changed for future requests without need for a global
+  // variable, scoped ref or recreating the client
+  client.defaultContext.token = newToken
+}
+```

package/.changeset/clean-items-smash.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Fix a potential memory leak in `FragmentRegistry.transform` and `FragmentRegistry.findFragmentSpreads` that would hold on to passed-in `DocumentNodes` for too long.

package/.changeset/cold-llamas-turn.md

@@ -0,0 +1,8 @@
+---
+"@apollo/client": patch
+---
+
+`parse` function: improve memory management
+* use LRU `WeakCache` instead of `Map` to keep a limited number of parsed results
+* cache is initiated lazily, only when needed
+* expose `parse.resetCache()` method

package/.changeset/config.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "https://unpkg.com/@changesets/config@2.2.0/schema.json",
+  "changelog": [
+    "@changesets/changelog-github",
+    { "repo": "apollographql/apollo-client" }
+  ],
+  "commit": false,
+  "fixed": [],
+  "linked": [],
+  "access": "public",
+  "baseBranch": "main",
+  "updateInternalDependencies": "patch",
+  "ignore": []
+}

package/.changeset/dirty-kids-crash.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+`documentTransform`: use `optimism` and `WeakCache` instead of directly storing data on the `Trie`

package/.changeset/dirty-tigers-matter.md

@@ -0,0 +1,13 @@
+---
+"@apollo/client": minor
+---
+
+Create a new `useQueryRefHandlers` hook that returns `refetch` and `fetchMore` functions for a given `queryRef`. This is useful to get access to handlers for a `queryRef` that was created by `createQueryPreloader` or when the handlers for a `queryRef` produced by a different component are inaccessible.
+
+```jsx
+const MyComponent({ queryRef }) {
+  const { refetch, fetchMore } = useQueryRefHandlers(queryRef);
+
+  // ...
+}
+```

package/.changeset/forty-cups-shop.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Fixes a potential memory leak in `Concast` that might have been triggered when `Concast` was used outside of Apollo Client.

package/.changeset/friendly-clouds-laugh.md

@@ -0,0 +1,7 @@
+---
+"@apollo/client": minor
+---
+
+To work around issues in React Server Components, especially with bundling for
+the Next.js "edge" runtime we now use an external package to wrap `react` imports
+instead of importing React directly.

package/.changeset/hot-ducks-burn.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Add a `resetCache` method to `DocumentTransform` and hook `InMemoryCache.addTypenameTransform` up to `InMemoryCache.gc`

package/.changeset/mighty-coats-check.md

@@ -0,0 +1,47 @@
+---
+"@apollo/client": minor
+---
+
+Allow returning `IGNORE` sentinel object from `optimisticResponse` functions to bail-out from the optimistic update.
+
+Consider this example:
+
+```jsx
+const UPDATE_COMMENT = gql`
+  mutation UpdateComment($commentId: ID!, $commentContent: String!) {
+    updateComment(commentId: $commentId, content: $commentContent) {
+      id
+      __typename
+      content
+    }
+  }
+`;
+
+function CommentPageWithData() {
+  const [mutate] = useMutation(UPDATE_COMMENT);
+  return (
+    <Comment
+      updateComment={({ commentId, commentContent }) =>
+        mutate({
+          variables: { commentId, commentContent },
+          optimisticResponse: (vars, { IGNORE }) => {
+            if (commentContent === "foo") {
+              // conditionally bail out of optimistic updates
+              return IGNORE;
+            }
+            return {
+              updateComment: {
+                id: commentId,
+                __typename: "Comment",
+                content: commentContent
+              }
+            }
+          },
+        })
+      }
+    />
+  );
+}
+```
+
+The `IGNORE` sentinel can be destructured from the second parameter in the callback function signature passed to `optimisticResponse`.

package/.changeset/polite-avocados-warn.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+`print`: use `WeakCache` instead of `WeakMap`

package/.changeset/pre.json

@@ -0,0 +1,37 @@
+{
+  "mode": "pre",
+  "tag": "beta",
+  "initialVersions": {
+    "@apollo/client": "3.8.3"
+  },
+  "changesets": [
+    "beige-geese-wink",
+    "breezy-spiders-tap",
+    "clean-items-smash",
+    "cold-llamas-turn",
+    "dirty-kids-crash",
+    "dirty-tigers-matter",
+    "forty-cups-shop",
+    "friendly-clouds-laugh",
+    "hot-ducks-burn",
+    "mighty-coats-check",
+    "polite-avocados-warn",
+    "quick-hats-marry",
+    "rare-snakes-melt",
+    "shaggy-ears-scream",
+    "shaggy-sheep-pull",
+    "sixty-boxes-rest",
+    "sour-sheep-walk",
+    "strong-terms-perform",
+    "swift-zoos-collect",
+    "thick-mice-collect",
+    "thick-tips-cry",
+    "thirty-ties-arrive",
+    "tough-timers-begin",
+    "unlucky-rats-decide",
+    "violet-lions-draw",
+    "wet-forks-rhyme",
+    "wild-dolphins-jog",
+    "yellow-flies-repeat"
+  ]
+}

package/.changeset/quick-hats-marry.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+ensure `defaultContext` is also used for mutations and subscriptions

package/.changeset/rare-snakes-melt.md

@@ -0,0 +1,24 @@
+---
+"@apollo/client": minor
+---
+
+Add the ability to start preloading a query outside React to begin fetching as early as possible. Call `createQueryPreloader` to create a `preloadQuery` function which can be called to start fetching a query. This returns a `queryRef` which is passed to `useReadQuery` and suspended until the query is done fetching.
+
+```tsx
+const preloadQuery = createQueryPreloader(client);
+const queryRef = preloadQuery(QUERY, { variables, ...otherOptions });
+
+function App() {
+  return {
+    <Suspense fallback={<div>Loading</div>}>
+      <MyQuery />
+    </Suspense>
+  }
+}
+
+function MyQuery() {
+  const { data } = useReadQuery(queryRef);
+
+  // do something with data
+}
+```

package/.changeset/shaggy-ears-scream.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Prevent `QueryInfo#markResult` mutation of `result.data` and return cache data consistently whether complete or incomplete.

package/.changeset/shaggy-sheep-pull.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+`QueryManager.transformCache`: use `WeakCache` instead of `WeakMap`

package/.changeset/sixty-boxes-rest.md

@@ -0,0 +1,8 @@
+---
+"@apollo/client": minor
+---
+
+`QueryManager.inFlightLinkObservables` now uses a strong `Trie` as an internal data structure.
+
+#### Warning: requires `@apollo/experimental-nextjs-app-support` update
+If you are using `@apollo/experimental-nextjs-app-support`, you will need to update that to at least 0.5.2, as it accesses this internal data structure.

package/.changeset/sour-sheep-walk.md

@@ -0,0 +1,7 @@
+---
+"@apollo/client": minor
+---
+
+Ability to dynamically match mocks
+
+Adds support for a new property `MockedResponse.variableMatcher`: a predicate function that accepts a `variables` param.  If `true`, the `variables` will be passed into the `ResultFunction` to help dynamically build a response.

package/.changeset/strong-terms-perform.md

@@ -0,0 +1,46 @@
+---
+"@apollo/client": minor
+---
+
+Add multipart subscription network adapters for Relay and urql
+
+### Relay
+
+```tsx
+import { createFetchMultipartSubscription } from "@apollo/client/utilities/subscriptions/relay";
+import { Environment, Network, RecordSource, Store } from "relay-runtime";
+
+const fetchMultipartSubs = createFetchMultipartSubscription(
+  "http://localhost:4000"
+);
+
+const network = Network.create(fetchQuery, fetchMultipartSubs);
+
+export const RelayEnvironment = new Environment({
+  network,
+  store: new Store(new RecordSource()),
+});
+```
+
+### Urql
+
+```tsx
+import { createFetchMultipartSubscription } from "@apollo/client/utilities/subscriptions/urql";
+import { Client, fetchExchange, subscriptionExchange } from "@urql/core";
+
+const url = "http://localhost:4000";
+
+const multipartSubscriptionForwarder = createFetchMultipartSubscription(
+  url
+);
+
+const client = new Client({
+  url,
+  exchanges: [
+    fetchExchange,
+    subscriptionExchange({
+      forwardSubscription: multipartSubscriptionForwarder,
+    }),
+  ],
+});
+```

package/.changeset/swift-zoos-collect.md

@@ -0,0 +1,19 @@
+---
+"@apollo/client": minor
+---
+
+Adds a new `skipPollAttempt` callback function that's called whenever a refetch attempt occurs while polling. If the function returns `true`, the refetch is skipped and not reattempted until the next poll interval. This will solve the frequent use-case of disabling polling when the window is inactive.
+
+```ts
+useQuery(QUERY, {
+  pollInterval: 1000,
+  skipPollAttempt: () => document.hidden // or !document.hasFocus()
+});
+// or define it globally
+new ApolloClient({
+  defaultOptions: {
+    watchQuery: {
+      skipPollAttempt: () => document.hidden // or !document.hasFocus()
+    }
+  }
+})

package/.changeset/thick-mice-collect.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Clarify types of `EntityStore.makeCacheKey`.

package/.changeset/thick-tips-cry.md

@@ -0,0 +1,9 @@
+---
+"@apollo/client": patch
+---
+
+Persisted Query Link: improve memory management
+* use LRU `WeakCache` instead of `WeakMap` to keep a limited number of hash results
+* hash cache is initiated lazily, only when needed
+* expose `persistedLink.resetHashCache()` method
+* reset hash cache if the upstream server reports it doesn't accept persisted queries

package/.changeset/thirty-ties-arrive.md

@@ -0,0 +1,26 @@
+---
+"@apollo/client": minor
+---
+
+Introduces a new `useLoadableQuery` hook. This hook works similarly to `useBackgroundQuery` in that it returns a `queryRef` that can be used to suspend a component via the `useReadQuery` hook. It provides a more ergonomic way to load the query during a user interaction (for example when wanting to preload some data) that would otherwise be clunky with `useBackgroundQuery`.
+
+```tsx
+function App() {
+  const [loadQuery, queryRef, { refetch, fetchMore, reset }] = useLoadableQuery(query, options)
+
+  return (
+    <>
+      <button onClick={() => loadQuery(variables)}>Load query</button>
+      <Suspense fallback={<SuspenseFallback />}>
+        {queryRef && <Child queryRef={queryRef} />}
+      </Suspense>
+    </>
+  );
+}
+
+function Child({ queryRef }) {
+  const { data } = useReadQuery(queryRef)
+
+  // ...
+}
+```

package/.changeset/tough-timers-begin.md

@@ -0,0 +1,8 @@
+---
+"@apollo/client": minor
+---
+
+Deprecates `canonizeResults`.
+
+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.

package/.changeset/unlucky-rats-decide.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+use WeakMap in React Native with Hermes

package/.changeset/violet-lions-draw.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+InMemoryCache.gc now also triggers FragmentRegistry.resetCaches (if there is a FragmentRegistry)

package/.changeset/wet-forks-rhyme.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Adds an experimental `ApolloClient.getMemoryInternals` helper

package/.changeset/wild-dolphins-jog.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": patch
+---
+
+Add `reset` method to `print`, hook up to `InMemoryCache.gc`

package/.changeset/yellow-flies-repeat.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Support re-using of mocks in the MockedProvider