Merge branch 'main' into v5

# Conflicts:
#	.github/workflows/pr.yml
#	packages/eslint-plugin-query/src/rules/prefer-query-object-syntax/prefer-query-object-syntax.test.ts
#	packages/eslint-plugin-query/src/rules/prefer-query-object-syntax/prefer-query-object-syntax.ts
#	packages/query-core/src/mutation.ts
#	packages/query-core/src/mutationCache.ts
#	packages/query-core/src/queryCache.ts
#	packages/query-core/src/queryClient.ts

Author: TkDodo

.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
       - uses: actions/checkout@v3
         with:
           fetch-depth: '0'
-      - uses: pnpm/[email protected].2
+      - uses: pnpm/[email protected].4
         with:
           version: 7
       - uses: actions/setup-node@v3
@@ -45,4 +45,4 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
           TAG: ${{ inputs.tag }}
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v2
+        uses: codecov/codecov-action@v3

.github/workflows/pr.yml

@@ -6,7 +6,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - uses: pnpm/[email protected].2
+      - uses: pnpm/[email protected].4
         with:
           version: 7
       - uses: actions/setup-node@v3
@@ -17,13 +17,13 @@ jobs:
         run: pnpm --filter "./packages/**" --filter query --prefer-offline install
       - run: pnpm run test:lib
       - name: Upload coverage to Codecov
-        uses: codecov/codecov-action@v2
+        uses: codecov/codecov-action@v3
   lint:
     name: 'Lint'
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - uses: pnpm/[email protected].2
+      - uses: pnpm/[email protected].4
         with:
           version: 7
       - uses: actions/setup-node@v3
@@ -38,7 +38,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - uses: pnpm/[email protected].2
+      - uses: pnpm/[email protected].4
         with:
           version: 7
       - uses: actions/setup-node@v3
@@ -53,7 +53,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - uses: pnpm/[email protected].2
+      - uses: pnpm/[email protected].4
         with:
           version: 7
       - uses: actions/setup-node@v3
@@ -68,7 +68,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
-      - uses: pnpm/[email protected].2
+      - uses: pnpm/[email protected].4
         with:
           version: 7
       - uses: actions/setup-node@v3

docs/react/overview.md

@@ -3,11 +3,11 @@ id: overview
 title: Overview
 ---
 
-React Query is often described as the missing data-fetching library for React, but in more technical terms, it makes **fetching, caching, synchronizing and updating server state** in your React applications a breeze.
+TanStack Query (FKA React Query) is often described as the missing data-fetching library for web applications, but in more technical terms, it makes **fetching, caching, synchronizing and updating server state** in your web applications a breeze.
 
 ## Motivation
 
-Out of the box, React applications **do not** come with an opinionated way of fetching or updating data from your components so developers end up building their own ways of fetching data. This usually means cobbling together component-based state and effect using React hooks, or using more general purpose state management libraries to store and provide asynchronous data throughout their apps.
+Most core web frameworks **do not** come with an opinionated way of fetching or updating data in a wholistic way. Because of this developers end up building either meta-frameworks which encapsulate strict opinions about data-fetching, or they invent their own ways of doing fetching data. This usually means cobbling together component-based state and side-effects, or using more general purpose state management libraries to store and provide asynchronous data throughout their apps.
 
 While most traditional state management libraries are great for working with client state, they are **not so great at working with async or server state**. This is because **server state is totally different**. For starters, server state:
 

docs/react/reference/useQuery.md

@@ -21,6 +21,7 @@ const {
   isPlaceholderData,
   isRefetchError,
   isRefetching,
+  isInitialLoading,
   isStale,
   isSuccess,
   refetch,

packages/eslint-plugin-query/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/eslint-plugin-query",
-  "version": "4.24.0",
+  "version": "4.24.7",
   "description": "ESLint plugin for TanStack Query",
   "author": "Eliya Cohen",
   "license": "MIT",

packages/query-async-storage-persister/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/query-async-storage-persister",
-  "version": "4.24.3",
+  "version": "4.24.6",
   "description": "A persister for asynchronous storages, to be used with TanStack/Query",
   "author": "tannerlinsley",
   "license": "MIT",

packages/query-broadcast-client-experimental/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/query-broadcast-client-experimental",
-  "version": "4.24.3",
+  "version": "4.24.6",
   "description": "An experimental plugin to for broadcasting the state of your queryClient between browser tabs/windows",
   "author": "tannerlinsley",
   "license": "MIT",

packages/query-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/query-core",
-  "version": "4.24.3",
+  "version": "4.24.6",
   "description": "The framework agnostic core that powers TanStack Query",
   "author": "tannerlinsley",
   "license": "MIT",

packages/query-core/src/mutation.ts

@@ -144,12 +144,8 @@ export class Mutation<
     }
   }
 
-  continue(): Promise<TData> {
-    if (this.#retryer) {
-      this.#retryer.continue()
-      return this.#retryer.promise
-    }
-    return this.execute()
+  continue(): Promise<unknown> {
+    return this.#retryer?.continue() ?? this.execute()
   }
 
   async execute(): Promise<TData> {

packages/query-core/src/mutationCache.ts

@@ -77,7 +77,7 @@ type MutationCacheListener = (event: MutationCacheNotifyEvent) => void
 export class MutationCache extends Subscribable<MutationCacheListener> {
   #mutations: Mutation<any, any, any, any>[]
   #mutationId: number
-  #resuming: Promise<void> | undefined
+  #resuming: Promise<unknown> | undefined
 
   constructor(public config: MutationCacheConfig = {}) {
     super()
@@ -151,21 +151,21 @@ export class MutationCache extends Subscribable<MutationCacheListener> {
     })
   }
 
-  resumePausedMutations(): Promise<void> {
-    if (!this.#resuming) {
-      const pausedMutations = this.#mutations.filter((x) => x.state.isPaused)
-      this.#resuming = notifyManager
-        .batch(() =>
+  resumePausedMutations(): Promise<unknown> {
+    this.#resuming = (this.#resuming ?? Promise.resolve())
+      .then(() => {
+        const pausedMutations = this.#mutations.filter((x) => x.state.isPaused)
+        return notifyManager.batch(() =>
           pausedMutations.reduce(
             (promise, mutation) =>
               promise.then(() => mutation.continue().catch(noop)),
-            Promise.resolve(),
+            Promise.resolve() as Promise<unknown>,
           ),
         )
-        .then(() => {
-          this.#resuming = undefined
-        })
-    }
+      })
+      .then(() => {
+        this.#resuming = undefined
+      })
 
     return this.#resuming
   }