@tanstack/query-core 4.12.0 → 4.13.0

package/package.json

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

package/src/mutation.ts

@@ -30,13 +30,16 @@ export interface MutationState<
   data: TData | undefined
   error: TError | null
   failureCount: number
+  failureReason: TError | null
   isPaused: boolean
   status: MutationStatus
   variables: TVariables | undefined
 }
 
-interface FailedAction {
+interface FailedAction<TError> {
   type: 'failed'
+  failureCount: number
+  error: TError | null
 }
 
 interface LoadingAction<TVariables, TContext> {
@@ -71,7 +74,7 @@ interface SetStateAction<TData, TError, TVariables, TContext> {
 export type Action<TData, TError, TVariables, TContext> =
   | ContinueAction
   | ErrorAction<TError>
-  | FailedAction
+  | FailedAction<TError>
   | LoadingAction<TVariables, TContext>
   | PauseAction
   | SetStateAction<TData, TError, TVariables, TContext>
@@ -171,8 +174,8 @@ export class Mutation<
           }
           return this.options.mutationFn(this.state.variables!)
         },
-        onFail: () => {
-          this.dispatch({ type: 'failed' })
+        onFail: (failureCount, error) => {
+          this.dispatch({ type: 'failed', failureCount, error })
         },
         onPause: () => {
           this.dispatch({ type: 'pause' })
@@ -272,7 +275,8 @@ export class Mutation<
         case 'failed':
           return {
             ...state,
-            failureCount: state.failureCount + 1,
+            failureCount: action.failureCount,
+            failureReason: action.error,
           }
         case 'pause':
           return {
@@ -289,6 +293,8 @@ export class Mutation<
             ...state,
             context: action.context,
             data: undefined,
+            failureCount: 0,
+            failureReason: null,
             error: null,
             isPaused: !canFetch(this.options.networkMode),
             status: 'loading',
@@ -298,6 +304,8 @@ export class Mutation<
           return {
             ...state,
             data: action.data,
+            failureCount: 0,
+            failureReason: null,
             error: null,
             status: 'success',
             isPaused: false,
@@ -308,6 +316,7 @@ export class Mutation<
             data: undefined,
             error: action.error,
             failureCount: state.failureCount + 1,
+            failureReason: action.error,
             isPaused: false,
             status: 'error',
           }
@@ -344,6 +353,7 @@ export function getDefaultState<
     data: undefined,
     error: null,
     failureCount: 0,
+    failureReason: null,
     isPaused: false,
     status: 'idle',
     variables: undefined,

package/src/query.ts

@@ -45,6 +45,7 @@ export interface QueryState<TData = unknown, TError = unknown> {
   errorUpdateCount: number
   errorUpdatedAt: number
   fetchFailureCount: number
+  fetchFailureReason: TError | null
   fetchMeta: any
   isInvalidated: boolean
   status: QueryStatus
@@ -82,8 +83,10 @@ export interface FetchOptions {
   meta?: any
 }
 
-interface FailedAction {
+interface FailedAction<TError> {
   type: 'failed'
+  failureCount: number
+  error: TError
 }
 
 interface FetchAction {
@@ -124,7 +127,7 @@ interface SetStateAction<TData, TError> {
 export type Action<TData, TError> =
   | ContinueAction
   | ErrorAction<TError>
-  | FailedAction
+  | FailedAction<TError>
   | FetchAction
   | InvalidateAction
   | PauseAction
@@ -473,8 +476,8 @@ export class Query<
         this.isFetchingOptimistic = false
       },
       onError,
-      onFail: () => {
-        this.dispatch({ type: 'failed' })
+      onFail: (failureCount, error) => {
+        this.dispatch({ type: 'failed', failureCount, error })
       },
       onPause: () => {
         this.dispatch({ type: 'pause' })
@@ -500,7 +503,8 @@ export class Query<
         case 'failed':
           return {
             ...state,
-            fetchFailureCount: state.fetchFailureCount + 1,
+            fetchFailureCount: action.failureCount,
+            fetchFailureReason: action.error,
           }
         case 'pause':
           return {
@@ -516,6 +520,7 @@ export class Query<
           return {
             ...state,
             fetchFailureCount: 0,
+            fetchFailureReason: null,
             fetchMeta: action.meta ?? null,
             fetchStatus: canFetch(this.options.networkMode)
               ? 'fetching'
@@ -537,6 +542,7 @@ export class Query<
             ...(!action.manual && {
               fetchStatus: 'idle',
               fetchFailureCount: 0,
+              fetchFailureReason: null,
             }),
           }
         case 'error':
@@ -552,6 +558,7 @@ export class Query<
             errorUpdateCount: state.errorUpdateCount + 1,
             errorUpdatedAt: Date.now(),
             fetchFailureCount: state.fetchFailureCount + 1,
+            fetchFailureReason: error as TError,
             fetchStatus: 'idle',
             status: 'error',
           }
@@ -611,6 +618,7 @@ function getDefaultState<
     errorUpdateCount: 0,
     errorUpdatedAt: 0,
     fetchFailureCount: 0,
+    fetchFailureReason: null,
     fetchMeta: null,
     isInvalidated: false,
     status: hasData ? 'success' : 'loading',

package/src/queryObserver.ts

@@ -562,6 +562,7 @@ export class QueryObserver<
       error,
       errorUpdatedAt,
       failureCount: state.fetchFailureCount,
+      failureReason: state.fetchFailureReason,
       errorUpdateCount: state.errorUpdateCount,
       isFetched: state.dataUpdateCount > 0 || state.errorUpdateCount > 0,
       isFetchedAfterMount:

package/src/tests/mutations.test.tsx

@@ -71,6 +71,7 @@ describe('mutations', () => {
       data: undefined,
       error: null,
       failureCount: 0,
+      failureReason: null,
       isError: false,
       isIdle: true,
       isLoading: false,
@@ -97,6 +98,7 @@ describe('mutations', () => {
       data: undefined,
       error: null,
       failureCount: 0,
+      failureReason: null,
       isError: false,
       isIdle: false,
       isLoading: true,
@@ -115,6 +117,7 @@ describe('mutations', () => {
       data: undefined,
       error: null,
       failureCount: 0,
+      failureReason: null,
       isError: false,
       isIdle: false,
       isLoading: true,
@@ -133,6 +136,7 @@ describe('mutations', () => {
       data: 'todo',
       error: null,
       failureCount: 0,
+      failureReason: null,
       isError: false,
       isIdle: false,
       isLoading: false,
@@ -172,6 +176,7 @@ describe('mutations', () => {
       data: undefined,
       error: null,
       failureCount: 0,
+      failureReason: null,
       isError: false,
       isIdle: false,
       isLoading: true,
@@ -190,6 +195,7 @@ describe('mutations', () => {
       data: undefined,
       error: null,
       failureCount: 0,
+      failureReason: null,
       isError: false,
       isIdle: false,
       isLoading: true,
@@ -208,6 +214,7 @@ describe('mutations', () => {
       data: undefined,
       error: null,
       failureCount: 1,
+      failureReason: 'err',
       isError: false,
       isIdle: false,
       isLoading: true,
@@ -226,6 +233,7 @@ describe('mutations', () => {
       data: undefined,
       error: 'err',
       failureCount: 2,
+      failureReason: 'err',
       isError: true,
       isIdle: false,
       isLoading: false,
@@ -264,6 +272,7 @@ describe('mutations', () => {
           data: undefined,
           error: null,
           failureCount: 1,
+          failureReason: 'err',
           isPaused: true,
           status: 'loading',
           variables: 'todo',
@@ -275,6 +284,7 @@ describe('mutations', () => {
       data: undefined,
       error: null,
       failureCount: 1,
+      failureReason: 'err',
       isPaused: true,
       status: 'loading',
       variables: 'todo',
@@ -286,7 +296,8 @@ describe('mutations', () => {
       context: 'todo',
       data: 'todo',
       error: null,
-      failureCount: 1,
+      failureCount: 0,
+      failureReason: null,
       isPaused: false,
       status: 'success',
       variables: 'todo',
@@ -316,6 +327,7 @@ describe('mutations', () => {
       data: 'new',
       error: undefined,
       failureCount: 0,
+      failureReason: null,
       isPaused: false,
       status: 'success',
     })

package/src/types.ts

@@ -370,6 +370,7 @@ export interface QueryObserverBaseResult<TData = unknown, TError = unknown> {
   error: TError | null
   errorUpdatedAt: number
   failureCount: number
+  failureReason: TError | null
   errorUpdateCount: number
   isError: boolean
   isFetched: boolean