Can you cancel paused mutations?

[cmdecker95]

This use case is similar to (yet functionally distinct from) @Merott's post in #1551. I believe the linked issue is regarding cancelling mutations that are already in flight, whereas the issue below is regarding paused mutations (isPaused === true).

Can you cancel a paused mutation? My use case is that I run update mutations to any one resource on the backend serially (see the docs on mutation scopes). If I run a successful delete mutation, I want it to cancel the remaining paused update mutations to that resource.

For example, imagine a queue of mutations for any single Todo, let's say ID 1:

1. Update Todo with ID 1
2. Update Todo with ID 1
3. Delete Todo with ID 1
4. Update Todo with ID 1
5. Update Todo with ID 1

Above, I want to know if I can cancel Mutation 4 (and beyond), since I don't want to attempt an update to a successfully deleted resource.

Here's an example of the API I'm envisioning (in case it doesn't exist yet), which I'm suggesting be added as queryClient.cancelMutations:

const { mutate: update } = useMutation({
  scope: { id }, // Mutations with this `scope.id` run serially
  mutationFn: updateTodo
});

const { mutate: remove } = useMutation({
  scope: { id }, // Enqueued to same queue as the _update_ mutations
  mutation: deleteTodo,
  onSuccess: () => {

    // I'd like to do this to cancel future mutations
    queryClient.cancelMutations({ scope: { id } });

  }
});

/* Imagine UI things triggering mutations */
update(1)
update(1)
remove(1) // Succeeds
update(1) // Never runs

EDIT: In PR #8673, I opted to specifically cancel mutations in a given scope only if the mutation is paused. Therefore, I chose to instead name this query client method cancelPausedMutations, which follows the naming pattern set by resumePausedMutations.