Merge branch 'main' into main-docs-replatform

Author: Meschreiber

.api-reports/api-report-react.api.md

@@ -1178,7 +1178,7 @@ export interface MutationResult<TData = any> {
     data?: TData | null;
     error?: ApolloError;
     loading: boolean;
-    reset(): void;
+    reset: () => void;
 }
 
 // Warning: (ae-forgotten-export) The symbol "MutationBaseOptions" needs to be exported by the entry point index.d.ts
@@ -2228,7 +2228,7 @@ export interface UseReadQueryResult<TData = unknown> {
 
 // @public
 export function useSubscription<TData = any, TVariables extends OperationVariables = OperationVariables>(subscription: DocumentNode | TypedDocumentNode<TData, TVariables>, options?: SubscriptionHookOptions<NoInfer_2<TData>, NoInfer_2<TVariables>>): {
-    restart(): void;
+    restart: () => void;
     loading: boolean;
     data?: TData | undefined;
     error?: ApolloError;

.api-reports/api-report-react_components.api.md

@@ -1059,7 +1059,7 @@ interface MutationResult<TData = any> {
     data?: TData | null;
     error?: ApolloError;
     loading: boolean;
-    reset(): void;
+    reset: () => void;
 }
 
 // Warning: (ae-forgotten-export) The symbol "MutationBaseOptions" needs to be exported by the entry point index.d.ts

.api-reports/api-report-react_hoc.api.md

@@ -1052,7 +1052,7 @@ interface MutationResult<TData = any> {
     data?: TData | null;
     error?: ApolloError;
     loading: boolean;
-    reset(): void;
+    reset: () => void;
 }
 
 // Warning: (ae-forgotten-export) The symbol "MutationBaseOptions" needs to be exported by the entry point index.d.ts

.api-reports/api-report-react_hooks.api.md

@@ -1120,7 +1120,7 @@ interface MutationResult<TData = any> {
     data?: TData | null;
     error?: ApolloError;
     loading: boolean;
-    reset(): void;
+    reset: () => void;
 }
 
 // Warning: (ae-forgotten-export) The symbol "MutationBaseOptions" needs to be exported by the entry point index.d.ts
@@ -2061,7 +2061,7 @@ export interface UseReadQueryResult<TData = unknown> {
 //
 // @public
 export function useSubscription<TData = any, TVariables extends OperationVariables = OperationVariables>(subscription: DocumentNode | TypedDocumentNode<TData, TVariables>, options?: SubscriptionHookOptions<NoInfer_2<TData>, NoInfer_2<TVariables>>): {
-    restart(): void;
+    restart: () => void;
     loading: boolean;
     data?: TData | undefined;
     error?: ApolloError;

.api-reports/api-report.api.md

@@ -1629,7 +1629,7 @@ export interface MutationResult<TData = any> {
     data?: TData | null;
     error?: ApolloError;
     loading: boolean;
-    reset(): void;
+    reset: () => void;
 }
 
 // Warning: (ae-forgotten-export) The symbol "MutationBaseOptions" needs to be exported by the entry point index.d.ts
@@ -2889,7 +2889,7 @@ export interface UseReadQueryResult<TData = unknown> {
 
 // @public
 export function useSubscription<TData = any, TVariables extends OperationVariables = OperationVariables>(subscription: DocumentNode | TypedDocumentNode<TData, TVariables>, options?: SubscriptionHookOptions<NoInfer_2<TData>, NoInfer_2<TVariables>>): {
-    restart(): void;
+    restart: () => void;
     loading: boolean;
     data?: TData | undefined;
     error?: ApolloError;

.circleci/config.yml

@@ -15,7 +15,7 @@ jobs:
 
   Lint:
     docker:
-      - image: cimg/node:22.6.0
+      - image: cimg/node:22.9.0
     steps:
       - checkout
       - run: npm version
@@ -24,15 +24,15 @@ jobs:
 
   Formatting:
     docker:
-      - image: cimg/node:22.6.0
+      - image: cimg/node:22.9.0
     steps:
       - checkout
       - run: npm ci
       - run: npm run check:format
 
   Tests:
     docker:
-      - image: cimg/node:22.6.0
+      - image: cimg/node:22.9.0
     parameters:
       project:
         type: string
@@ -54,7 +54,7 @@ jobs:
 
   BuildTarball:
     docker:
-      - image: cimg/node:22.6.0
+      - image: cimg/node:22.9.0
     steps:
       - checkout
       - run: npm run ci:precheck
@@ -73,7 +73,7 @@ jobs:
       react:
         type: string
     docker:
-      - image: cimg/node:22.6.0-browsers
+      - image: cimg/node:22.9.0-browsers
     steps:
       - checkout
       - attach_workspace:
@@ -111,7 +111,7 @@ jobs:
       externalPackage:
         type: string
     docker:
-      - image: cimg/node:22.6.0
+      - image: cimg/node:22.9.0
     steps:
       - checkout
       - attach_workspace:

.github/workflows/prerelease.yml

@@ -103,7 +103,7 @@ jobs:
       - name: Send a Slack notification on publish
         if: steps.changesets.outcome == 'success'
         id: slack
-        uses: slackapi/slack-github-action@v1.26.0
+        uses: slackapi/slack-github-action@v1.27.0
         with:
           # Slack channel id, channel name, or user id to post message
           # See also: https://api.slack.com/methods/chat.postMessage#channels

.github/workflows/publish-pr-releases.yml

@@ -0,0 +1,28 @@
+name: Pull Request Prerelease
+
+on:
+  pull_request:
+  push:
+    branches:
+      - "**"
+    tags:
+      - "!**"
+
+jobs:
+  prerelease:
+    name: Pull Request Prerelease
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js 20.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20.x
+
+      - name: Install dependencies with cache
+        uses: bahmutov/npm-install@v1
+
+      - name: Build and publish to pkg.pr.new
+        run: npm run pkg-pr-new-publish

.github/workflows/release.yml

@@ -65,7 +65,7 @@ jobs:
       - name: Send a Slack notification on publish
         if: steps.changesets.outcome == 'success' && steps.changesets.outputs.published == 'true'
         id: slack
-        uses: slackapi/slack-github-action@v1.26.0
+        uses: slackapi/slack-github-action@v1.27.0
         with:
           # Slack channel id, channel name, or user id to post message
           # See also: https://api.slack.com/methods/chat.postMessage#channels

.size-limits.json

@@ -1,4 +1,4 @@
 {
-  "dist/apollo-client.min.cjs": 40271,
-  "import { ApolloClient, InMemoryCache, HttpLink } from \"dist/index.js\" (production)": 33059
+  "dist/apollo-client.min.cjs": 40251,
+  "import { ApolloClient, InMemoryCache, HttpLink } from \"dist/index.js\" (production)": 33061
 }

CHANGELOG.md

@@ -1,5 +1,33 @@
 # @apollo/client
 
+## 3.11.8
+
+### Patch Changes
+
+- [#12054](https://github.com/apollographql/apollo-client/pull/12054) [`35cf186`](https://github.com/apollographql/apollo-client/commit/35cf186ed9237e41735f150e0cbf4edd995ab0d9) Thanks [@phryneas](https://github.com/phryneas)! - Fixed a bug where incorrect object access in some Safari extensions could cause a crash.
+
+## 3.11.7
+
+### Patch Changes
+
+- [#12052](https://github.com/apollographql/apollo-client/pull/12052) [`e471cef`](https://github.com/apollographql/apollo-client/commit/e471cef875eadef04f8ee18ef431ee70e7b9bcab) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Fixes a regression from where passing an invalid identifier to `from` in `useFragment` would result in the warning `TypeError: Cannot read properties of undefined (reading '__typename')`.
+
+## 3.11.6
+
+### Patch Changes
+
+- [#12049](https://github.com/apollographql/apollo-client/pull/12049) [`9c26892`](https://github.com/apollographql/apollo-client/commit/9c268927b1f8e5921b9440a53c9979a37f594e75) Thanks [@phryneas](https://github.com/phryneas) and [@maciesielka](https://github.com/maciesielka)! - Fix a bug where `useFragment` did not re-render as expected
+
+- [#12044](https://github.com/apollographql/apollo-client/pull/12044) [`04462a2`](https://github.com/apollographql/apollo-client/commit/04462a274ad39b392142385a2f052abbf3014749) Thanks [@DoctorJohn](https://github.com/DoctorJohn)! - Cache the `useSubscription` hook's `restart` function definition between re-renders.
+
+## 3.11.5
+
+### Patch Changes
+
+- [#12027](https://github.com/apollographql/apollo-client/pull/12027) [`eb3e21b`](https://github.com/apollographql/apollo-client/commit/eb3e21b9f7fa6a3161705c2c7270129c17b65095) Thanks [@JavaScriptBach](https://github.com/JavaScriptBach)! - Type `MutationResult.reset` as an arrow function
+
+- [#12020](https://github.com/apollographql/apollo-client/pull/12020) [`82d8cb4`](https://github.com/apollographql/apollo-client/commit/82d8cb4255be497748829f12eb25ac87c11ee5e4) Thanks [@jerelmiller](https://github.com/jerelmiller)! - Better conform to Rules of React by avoiding write of ref in render for `useFragment`.
+
 ## 3.11.4
 
 ### Patch Changes

ROADMAP.md

@@ -1,6 +1,6 @@
 # 🔮 Apollo Client Ecosystem Roadmap
 
-**Last updated: 2024-08-12**
+**Last updated: 2024-09-23**
 
 For up to date release notes, refer to the project's [Changelog](https://github.com/apollographql/apollo-client/blob/main/CHANGELOG.md).
 
@@ -17,16 +17,16 @@ For up to date release notes, refer to the project's [Changelog](https://github.
 
 ### Apollo Client
 
-#### [3.12.0](https://github.com/apollographql/apollo-client/milestone/42) - October 7, 2024
-_Release candidate - September 30, 2024_
+#### [3.12.0](https://github.com/apollographql/apollo-client/milestone/42) - October 21, 2024
+_Release candidate - October 24, 2024_
 
 - Data masking
-- Introduce a suspenseful `useFragment` that will suspend when the data is not yet loaded
 
 #### Upcoming features
 
 - Leaner client (under alternate entry point)
 - Better types for `useQuery`/`useMutation`/`useSubscription`
+- Introduce a suspenseful `useFragment` that will suspend when the data is not yet loaded
 
 #### 4.0
 
@@ -41,15 +41,18 @@ _Release candidate - September 30, 2024_
 ### VSCode Extension
 
 - Bug fixes and long-requested features
+- Apollo Client Devtools integration
 
 ### GraphQL Tag
 
 _no work in progress_
 
 ### Apollo Client DevTools
 
-_no work in progress_
+- Ongoing work with fixing error messages shown in devtools
+- Add a memory panel to monitor Apollo Client devtools internal caches
 
 ### Apollo Client NextJS
 
 - New/more robust documentation
+- Support for `@defer` in RSC

docs/source/api/link/community-links.md

@@ -27,3 +27,4 @@ Thank you to all the Apollo community members who have contributed custom Apollo
 | [apollo-link-observable](https://github.com/dragozin/apollo-link-observable) | [@dragozin](https://github.com/dragozin) | Link that allows you to make side effects of graphql queries using [RxJS](http://github.com/ReactiveX/RxJS). |
 | [apollo-multi-endpoint-link](https://github.com/habx/apollo-multi-endpoint-link) | [@habx](https://github.com/habx) | Add directive to redirect requests to right endpoint |
 | [@grafbase/apollo-link](https://github.com/grafbase/playground/tree/main/packages/grafbase-apollo-link) | [@grafbase](https://github.com/grafbase) | Use GraphQL `@live` queries with Server-Sent Events.
+| [apollo-link-printer](https://github.com/egorlem/apollo-link-printer) | [@egorlem](https://github.com/egorlem) | Pretty logger of Apollo GraphQL network operations.

docs/source/pagination/core-api.mdx

@@ -61,7 +61,7 @@ return (
 }
 ```
 
-Here, we set the `offset` variable to `feed.length` to fetch items _after_ the last item in our cached list. The `variables` we provide here are merged with the `variables` provided for the original query, which means that variables _omitted_ here (such as `limit`) retain their original value (`10`) in the followup query.
+Here, we set the `offset` variable to `feed.length` to fetch items _after_ the last item in our cached list. The `variables` we provide here are shallow merged with the `variables` provided for the original query, which means that variables _omitted_ here (such as `limit`) retain their original value (`10`) in the followup query.
 
 In addition to `variables`, you can optionally provide an entirely different shape of `query` to execute. This can be useful when `fetchMore` needs to fetch only a single paginated field, but the original query contained unrelated fields.