fix(vue-query/useMutation): add missing '_defaulted' omit in 'UseMutationOptionsBase' by sukvvon · Pull Request #10215 · TanStack/query

sukvvon · 2026-03-02T18:26:30Z

🎯 Changes

Add missing _defaulted omit in UseMutationOptionsBase type to align with other packages (react-query, svelte-query, solid-query, angular-query) that already omit _defaulted from MutationObserverOptions.

✅ Checklist

I have followed the steps in the Contributing guide.
I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

This change affects published code, and I have generated a changeset.
This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

Bug Fixes
- Refined useMutation public options to remove internal-only properties, improving type safety and preventing accidental reliance on implementation details.
Documentation
- Added a patch release note documenting the fix.

…tionOptionsBase'

changeset-bot · 2026-03-02T18:26:36Z

🦋 Changeset detected

Latest commit: 70c6b33

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@tanstack/vue-query	Patch
@tanstack/vue-query-devtools	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

coderabbitai · 2026-03-02T18:26:41Z

📝 Walkthrough

Walkthrough

This change omits the internal _defaulted property from the public UseMutationOptionsBase type in vue-query by applying OmitKeyof to MutationObserverOptions, adds the necessary import, and includes a changelog changeset documenting the patch.

Changes

Cohort / File(s)	Summary
Changeset Entry `.changeset/fuzzy-chicken-listen.md`	Adds a new changeset documenting a patch release that notes the `_defaulted` omit fix for `UseMutationOptionsBase`.
Vue Query Type Fix `packages/vue-query/src/useMutation.ts`	Type update: `UseMutationOptionsBase` now uses `OmitKeyof<MutationObserverOptions<...>,'_defaulted'> & ShallowOption`; adds `OmitKeyof` import from `@tanstack/query-core`.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Suggested reviewers

lachlancollins
TkDodo

Poem

🐰 I nibbled at types with careful cheer,
_defaulted hidden, no longer near,
A gentle omit, a tidy delight,
The API gleams in soft moonlight. ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title accurately describes the main change: adding a missing '_defaulted' omit to the UseMutationOptionsBase type in vue-query/useMutation, which aligns with the code modifications shown in the summary.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The PR description fully follows the template with all required sections completed, including clear changes explanation, checklist items marked, and release impact documented.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Post copyable unit tests in a comment

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

nx-cloud · 2026-03-02T18:26:57Z

View your CI Pipeline Execution ↗ for commit 1fa850d

Command	Status	Duration	Result
`nx run-many --target=build --exclude=examples/*...`	✅ Succeeded	<1s	View ↗
`nx affected --targets=test:sherif,test:knip,tes...`	✅ Succeeded	25s	View ↗

☁️ Nx Cloud last updated this comment at 2026-03-02 18:45:03 UTC

pkg-pr-new · 2026-03-02T18:29:51Z

More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@10215

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@10215

@tanstack/preact-query

npm i https://pkg.pr.new/@tanstack/preact-query@10215

@tanstack/preact-query-devtools

npm i https://pkg.pr.new/@tanstack/preact-query-devtools@10215

@tanstack/preact-query-persist-client

npm i https://pkg.pr.new/@tanstack/preact-query-persist-client@10215

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@10215

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@10215

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@10215

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@10215

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@10215

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@10215

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@10215

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@10215

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@10215

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@10215

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@10215

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@10215

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@10215

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@10215

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@10215

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@10215

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@10215

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@10215

commit: c843443

fix(vue-query/useMutation): add missing '_defaulted' omit in 'UseMuta…
38454a9
…tionOptionsBase'

github-actionsBot added the package: vue-query label Mar 2, 2026

sukvvon marked this pull request as ready for review March 2, 2026 18:31

sukvvon force-pushed the fix/vue-query-useMutation-omit-defaulted branch from 89613e4 to 70c6b33Compare March 2, 2026 18:40

chore(.changeset): add changeset for '_defaulted' omit fix
1fa850d

sukvvon force-pushed the fix/vue-query-useMutation-omit-defaulted branch from 70c6b33 to 1fa850dCompare March 2, 2026 18:43

TkDodo merged commit 31c1696 into TanStack:mainMar 18, 2026
6 checks passed

github-actionsBot mentioned this pull request Mar 18, 2026
ci: Version Packages #10290
Merged

sukvvon self-assigned this Mar 19, 2026

Navigation Menu

Uh oh!

Uh oh!

fix(vue-query/useMutation): add missing '_defaulted' omit in 'UseMutationOptionsBase' - #10215

fix(vue-query/useMutation): add missing '_defaulted' omit in 'UseMutationOptionsBase'#10215
TkDodo merged 2 commits into
TanStack:mainfrom
sukvvon:fix/vue-query-useMutation-omit-defaulted

sukvvon commented Mar 2, 2026•
edited by coderabbitai Bot
Loading

Uh oh!

changeset-botBot commented Mar 2, 2026•
edited
Loading

Uh oh!

coderabbitaiBot commented Mar 2, 2026•
edited
Loading

Walkthrough

Changes

Estimated code review effort

Suggested reviewers

Poem

Uh oh!

nx-cloudBot commented Mar 2, 2026•
edited
Loading

Uh oh!

pkg-pr-newBot commented Mar 2, 2026•
edited
Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Uh oh!

Uh oh!

Conversation

sukvvon commented Mar 2, 2026• edited by coderabbitai BotLoading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

✅ Checklist

🚀 Release Impact

Summary by CodeRabbit

Uh oh!

changeset-botBot commented Mar 2, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

coderabbitaiBot commented Mar 2, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Suggested reviewers

Poem

Uh oh!

nx-cloudBot commented Mar 2, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pkg-pr-newBot commented Mar 2, 2026• edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

sukvvon commented Mar 2, 2026•
edited by coderabbitai Bot
Loading

changeset-botBot commented Mar 2, 2026•
edited
Loading

coderabbitaiBot commented Mar 2, 2026•
edited
Loading

nx-cloudBot commented Mar 2, 2026•
edited
Loading

pkg-pr-newBot commented Mar 2, 2026•
edited
Loading