chore: restore export of MaybePromise from query-core, update docs accordingly

- Changed return types of onSuccess, onError, onSettled, and onMutate callbacks from MaybePromise<void> to MaybePromise<unknown> in multiple files, including documentation and TypeScript definitions.
- This change aligns with the ongoing migration to a more flexible promise handling approach.
- Reduces total changes against main (some extraneous changes needed to be undone after previous merge)

Author: braden-w

docs/framework/react/plugins/persistQueryClient.md

@@ -214,12 +214,12 @@ ReactDOM.createRoot(rootElement).render(
 
 - `persistOptions: PersistQueryClientOptions`
   - all [options](#options) you can pass to [persistQueryClient](#persistqueryclient) minus the QueryClient itself
-- `onSuccess?: () => MaybePromise<void>`
+- `onSuccess?: () => MaybePromise<unknown>`
   - optional
   - will be called when the initial restore is finished
   - can be used to [resumePausedMutations](../../../../reference/QueryClient.md#queryclientresumepausedmutations)
   - if a Promise is returned, it will be awaited; restoring is seen as ongoing until then
-- `onError?: () => MaybePromise<void>`
+- `onError?: () => MaybePromise<unknown>`
   - optional
   - will be called when an error is thrown during restoration
   - if a Promise is returned, it will be awaited

docs/framework/react/reference/useMutation.md

@@ -68,15 +68,15 @@ mutate(variables, {
   - This function will fire before the mutation function is fired and is passed the same variables the mutation function would receive
   - Useful to perform optimistic updates to a resource in hopes that the mutation succeeds
   - The value returned from this function will be passed to both the `onError` and `onSettled` functions in the event of a mutation failure and can be useful for rolling back optimistic updates.
-- `onSuccess: (data: TData, variables: TVariables, context: TContext) => MaybePromise<void>`
+- `onSuccess: (data: TData, variables: TVariables, context: TContext) => MaybePromise<unknown>`
   - Optional
   - This function will fire when the mutation is successful and will be passed the mutation's result.
   - If a promise is returned, it will be awaited and resolved before proceeding
-- `onError: (err: TError, variables: TVariables, context?: TContext) => MaybePromise<void>`
+- `onError: (err: TError, variables: TVariables, context?: TContext) => MaybePromise<unknown>`
   - Optional
   - This function will fire if the mutation encounters an error and will be passed the error.
   - If a promise is returned, it will be awaited and resolved before proceeding
-- `onSettled: (data: TData, error: TError, variables: TVariables, context?: TContext) => MaybePromise<void>`
+- `onSettled: (data: TData, error: TError, variables: TVariables, context?: TContext) => MaybePromise<unknown>`
   - Optional
   - This function will fire when the mutation is either successfully fetched or encounters an error and be passed either the data or error
   - If a promise is returned, it will be awaited and resolved before proceeding

docs/reference/MutationCache.md

@@ -28,19 +28,19 @@ Its available methods are:
 
 **Options**
 
-- `onError?: (error: unknown, variables: unknown, context: unknown, mutation: Mutation) => MaybePromise<void>`
+- `onError?: (error: unknown, variables: unknown, context: unknown, mutation: Mutation) => MaybePromise<unknown>`
   - Optional
   - This function will be called if some mutation encounters an error.
   - If you return a Promise from it, it will be awaited
-- `onSuccess?: (data: unknown, variables: unknown, context: unknown, mutation: Mutation) => MaybePromise<void>`
+- `onSuccess?: (data: unknown, variables: unknown, context: unknown, mutation: Mutation) => MaybePromise<unknown>`
   - Optional
   - This function will be called if some mutation is successful.
   - If you return a Promise from it, it will be awaited
-- `onSettled?: (data: unknown | undefined, error: unknown | null, variables: unknown, context: unknown, mutation: Mutation) => MaybePromise<void>`
+- `onSettled?: (data: unknown | undefined, error: unknown | null, variables: unknown, context: unknown, mutation: Mutation) => MaybePromise<unknown>`
   - Optional
   - This function will be called if some mutation is settled (either successful or errored).
   - If you return a Promise from it, it will be awaited
-- `onMutate?: (variables: unknown, mutation: Mutation) => MaybePromise<void>`
+- `onMutate?: (variables: unknown, mutation: Mutation) => MaybePromise<unknown>`
   - Optional
   - This function will be called before some mutation executes.
   - If you return a Promise from it, it will be awaited

packages/angular-query-persist-client/src/with-persist-query-client.ts

@@ -23,8 +23,8 @@ import type {
 
 type PersistQueryClientOptions = {
   persistOptions: Omit<PersistQueryClientOptionsCore, 'queryClient'>
-  onSuccess?: () => MaybePromise<void>
-  onError?: () => MaybePromise<void>
+  onSuccess?: () => MaybePromise<unknown>
+  onError?: () => MaybePromise<unknown>
 }
 
 /**

packages/query-async-storage-persister/src/index.ts

@@ -2,6 +2,7 @@ import { asyncThrottle } from './asyncThrottle'
 import { noop } from './utils'
 import type {
   AsyncStorage,
+  MaybePromise,
   PersistedClient,
   Persister,
   Promisable,
@@ -28,12 +29,12 @@ interface CreateAsyncStoragePersisterOptions {
    * How to serialize the data to storage.
    * @default `JSON.stringify`
    */
-  serialize?: (client: PersistedClient) => Promisable<string>
+  serialize?: (client: PersistedClient) => MaybePromise<string>
   /**
    * How to deserialize the data from storage.
    * @default `JSON.parse`
    */
-  deserialize?: (cachedString: string) => Promisable<PersistedClient>
+  deserialize?: (cachedString: string) => MaybePromise<PersistedClient>
 
   retry?: AsyncPersistRetryer
 }

packages/react-query-persist-client/src/PersistQueryClientProvider.tsx

@@ -15,8 +15,8 @@ import type {
 
 export type PersistQueryClientProviderProps = QueryClientProviderProps & {
   persistOptions: OmitKeyof<PersistQueryClientOptions, 'queryClient'>
-  onSuccess?: () => MaybePromise<void>
-  onError?: () => MaybePromise<void>
+  onSuccess?: () => MaybePromise<unknown>
+  onError?: () => MaybePromise<unknown>
 }
 
 export const PersistQueryClientProvider = ({