📝 Update/extend 'reset mutation' documentation

Author: Shrugsy

docs/rtk-query/api/created-api/hooks.mdx

@@ -323,7 +323,7 @@ type UseMutationTrigger<T> = (arg: any) => Promise<
   requestId: string // A string generated by RTK Query
   abort: () => void // A method to cancel the mutation promise
   unwrap: () => Promise<T> // A method to unwrap the mutation call and provide the raw response/error
-  unsubscribe: () => void // A method to manually unsubscribe from the mutation call
+  reset: () => void // A method to manually unsubscribe from the mutation call and reset the result to the uninitialized state
 }
 
 type UseMutationResult<T> = {
@@ -340,6 +340,8 @@ type UseMutationResult<T> = {
   isSuccess: boolean // Mutation has data from a successful call
   isError: boolean // Mutation is currently in an "error" state
   startedTimeStamp?: number // Timestamp for when the latest mutation was initiated
+
+  reset: () => void // A method to manually unsubscribe from the mutation call and reset the result to the uninitialized state
 }
 ```
 

docs/rtk-query/usage/error-handling.mdx

@@ -94,7 +94,7 @@ import { toast } from 'your-cool-library'
 export const rtkQueryErrorLogger: Middleware = (api: MiddlewareAPI) => (
   next
 ) => (action) => {
-  // RTK Query uses `createAsyncThunk` from redux-toolkit under the hood, so we're able to utilize these use matchers!
+  // RTK Query uses `createAsyncThunk` from redux-toolkit under the hood, so we're able to utilize these matchers!
   if (isRejectedWithValue(action)) {
     console.warn('We got a rejected action!')
     toast.warn({ title: 'Async error!', message: action.error.data.message })

docs/rtk-query/usage/mutations.mdx

@@ -109,6 +109,7 @@ Below are some of the most frequently used properties on the "mutation result" o
 - `isLoading` - When true, indicates that the mutation has been fired and is awaiting a response.
 - `isSuccess` - When true, indicates that the last mutation fired has data from a successful request.
 - `isError` - When true, indicates that the last mutation fired resulted in an error state.
+- `reset` - A method to reset the hook back to it's original state and remove the current result from the cache
 
 :::note