refactor: complete MaybePromise<T> migration and update mutation callback return types

- Convert remaining T | Promise<T> patterns to MaybePromise<T> in streamedQuery and mutation options
- Update mutation callback return types from MaybePromise<void> to MaybePromise<unknown> to mirror #9251

Author: braden-w

packages/query-core/src/mutationCache.ts

@@ -21,24 +21,24 @@ interface MutationCacheConfig {
     variables: unknown,
     context: unknown,
     mutation: Mutation<unknown, unknown, unknown>,
-  ) => MaybePromise<void>
+  ) => MaybePromise<unknown>
   onSuccess?: (
     data: unknown,
     variables: unknown,
     context: unknown,
     mutation: Mutation<unknown, unknown, unknown>,
-  ) => MaybePromise<void>
+  ) => MaybePromise<unknown>
   onMutate?: (
     variables: unknown,
     mutation: Mutation<unknown, unknown, unknown>,
-  ) => MaybePromise<void>
+  ) => MaybePromise<unknown>
   onSettled?: (
     data: unknown | undefined,
     error: DefaultError | null,
     variables: unknown,
     context: unknown,
     mutation: Mutation<unknown, unknown, unknown>,
-  ) => MaybePromise<void>
+  ) => MaybePromise<unknown>
 }
 
 interface NotifyEventMutationAdded extends NotifyEvent {

packages/query-core/src/streamedQuery.ts

@@ -1,5 +1,5 @@
 import { addToEnd } from './utils'
-import type { QueryFunction, QueryFunctionContext, QueryKey } from './types'
+import type { MaybePromise, QueryFunction, QueryFunctionContext, QueryKey } from './types'
 
 /**
  * This is a helper function to create a query function that streams data from an AsyncIterable.
@@ -26,7 +26,7 @@ export function streamedQuery<
 }: {
   queryFn: (
     context: QueryFunctionContext<TQueryKey>,
-  ) => AsyncIterable<TQueryFnData> | Promise<AsyncIterable<TQueryFnData>>
+  ) => MaybePromise<AsyncIterable<TQueryFnData>>
   refetchMode?: 'append' | 'reset' | 'replace'
   maxChunks?: number
 }): QueryFunction<Array<TQueryFnData>, TQueryKey> {

packages/query-core/src/types.ts

@@ -1102,23 +1102,23 @@ export interface MutationOptions<
   mutationKey?: MutationKey
   onMutate?: (
     variables: TVariables,
-  ) => Promise<TContext | undefined> | TContext | undefined
+  ) => MaybePromise<TContext | undefined>
   onSuccess?: (
     data: TData,
     variables: TVariables,
     context: TContext,
-  ) => MaybePromise<void>
+  ) => MaybePromise<unknown>
   onError?: (
     error: TError,
     variables: TVariables,
     context: TContext | undefined,
-  ) => MaybePromise<void>
+  ) => MaybePromise<unknown>
   onSettled?: (
     data: TData | undefined,
     error: TError | null,
     variables: TVariables,
     context: TContext | undefined,
-  ) => MaybePromise<void>
+  ) => MaybePromise<unknown>
   retry?: RetryValue<TError>
   retryDelay?: RetryDelayValue<TError>
   networkMode?: NetworkMode