feat(vue-query): add 'mutationOptions' by sukvvon · Pull Request #10381 · TanStack/query

sukvvon · 2026-04-04T05:07:58Z

🎯 Changes

Add mutationOptions helper function for type-safe mutation option creation in vue-query
Add VueMutationOptions type to types.ts (follows SolidMutationOptions naming pattern)
Refactor UseMutationOptionsBase in useMutation.ts to use VueMutationOptions from types.ts
Add runtime tests (17 tests) and type tests (13 tests)

✅ 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

New Features
- Added mutationOptions helper function for Vue Query mutations with improved type safety.
- New VueMutationOptions type for standardized mutation configuration with optional mutationKey support.
Tests
- Added comprehensive test suite validating mutation options behavior, type inference, concurrent mutations, filtering, and state management integration.

coderabbitai · 2026-04-04T05:08:16Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7d926800-1a10-41d6-afd4-f9af4d914e3e

📥 Commits

Reviewing files that changed from the base of the PR and between 5ca721f and cb3d0c9.

📒 Files selected for processing (7)

.changeset/many-symbols-write.md
packages/vue-query/src/__tests__/mutationOptions.test-d.ts
packages/vue-query/src/__tests__/mutationOptions.test.ts
packages/vue-query/src/index.ts
packages/vue-query/src/mutationOptions.ts
packages/vue-query/src/types.ts
packages/vue-query/src/useMutation.ts

📝 Walkthrough

Walkthrough

This PR introduces a new mutationOptions helper function for Vue Query that preserves generic types for mutation configuration, extracts the Vue-specific options type as VueMutationOptions, refactors useMutation to use this new type for consistency, and includes comprehensive test coverage for type safety and runtime behavior.

Changes

Cohort / File(s)	Summary
Versioning `.changeset/many-symbols-write.md`	Documents minor version bump for the new `mutationOptions` feature.
New Helper & Types `packages/vue-query/src/mutationOptions.ts`, `packages/vue-query/src/types.ts`	Adds `mutationOptions` identity helper with overloads to preserve generic types; introduces `VueMutationOptions` type combining `MutationObserverOptions` with Vue's shallow reactivity option.
Test Coverage `packages/vue-query/src/__tests__/mutationOptions.test-d.ts`, `packages/vue-query/src/__tests__/mutationOptions.test.ts`	Type assertions validating compile-time behavior (excess property rejection, generic inference, callback typing); runtime tests covering mutation in-flight counting, state queries, filtering by key, and shallow reactivity.
Integration & Refactoring `packages/vue-query/src/index.ts`, `packages/vue-query/src/useMutation.ts`	Exports `mutationOptions` function and `VueMutationOptions` type; refactors `useMutation` to depend on consolidated `VueMutationOptions` type instead of inline construction.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 hops with glee

A helper so keen, preserving each type,
Options flow smooth through mutations so ripe,
Generic types dance in their rightful place,
With tests that ensure no type errors trace!

🚥 Pre-merge checks | ✅ 2 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (2 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely describes the main change: adding a 'mutationOptions' helper function to vue-query, which aligns with the core feature introduced across multiple files in the changeset.
Description check	✅ Passed	The description covers all required template sections with substantive content: changes are detailed, checklist items are addressed, and release impact is clearly marked. The changeset was properly generated for this published code change.

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

✨ Finishing Touches

📝 Generate docstrings

Create stacked PR
Commit on current branch

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch feat/vue-query-mutationOptions

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

nx-cloud · 2026-04-04T05:08:25Z

View your CI Pipeline Execution ↗ for commit cb3d0c9

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

☁️ Nx Cloud last updated this comment at 2026-04-04 05:12:42 UTC

github-actions · 2026-04-04T05:08:49Z

🚀 Changeset Version Preview

1 package(s) bumped directly, 23 bumped as dependents.

🟨 Minor bumps

Package	Version	Reason
`@tanstack/vue-query`	5.96.2 → 5.97.0	Changeset
`@tanstack/angular-query-experimental`	5.96.2 → 5.97.0	Dependent
`@tanstack/angular-query-persist-client`	5.96.2 → 5.97.0	Dependent
`@tanstack/eslint-plugin-query`	5.96.2 → 5.97.0	Dependent
`@tanstack/preact-query`	5.96.2 → 5.97.0	Dependent
`@tanstack/preact-query-devtools`	5.96.2 → 5.97.0	Dependent
`@tanstack/preact-query-persist-client`	5.96.2 → 5.97.0	Dependent
`@tanstack/query-async-storage-persister`	5.96.2 → 5.97.0	Dependent
`@tanstack/query-broadcast-client-experimental`	5.96.2 → 5.97.0	Dependent
`@tanstack/query-core`	5.96.2 → 5.97.0	Dependent
`@tanstack/query-devtools`	5.96.2 → 5.97.0	Dependent
`@tanstack/query-persist-client-core`	5.96.2 → 5.97.0	Dependent
`@tanstack/query-sync-storage-persister`	5.96.2 → 5.97.0	Dependent
`@tanstack/react-query`	5.96.2 → 5.97.0	Dependent
`@tanstack/react-query-devtools`	5.96.2 → 5.97.0	Dependent
`@tanstack/react-query-next-experimental`	5.96.2 → 5.97.0	Dependent
`@tanstack/react-query-persist-client`	5.96.2 → 5.97.0	Dependent
`@tanstack/solid-query`	5.96.2 → 5.97.0	Dependent
`@tanstack/solid-query-devtools`	5.96.2 → 5.97.0	Dependent
`@tanstack/solid-query-persist-client`	5.96.2 → 5.97.0	Dependent

🟩 Patch bumps

Package	Version	Reason
`@tanstack/svelte-query`	6.1.13 → 6.1.14	Dependent
`@tanstack/svelte-query-devtools`	6.1.13 → 6.1.14	Dependent
`@tanstack/svelte-query-persist-client`	6.1.13 → 6.1.14	Dependent
`@tanstack/vue-query-devtools`	6.1.13 → 6.1.14	Dependent

pkg-pr-new · 2026-04-04T05:12:31Z

More templates

@tanstack/angular-query-experimental

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

@tanstack/eslint-plugin-query

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

@tanstack/preact-query

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

@tanstack/preact-query-devtools

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

@tanstack/preact-query-persist-client

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

@tanstack/query-async-storage-persister

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

@tanstack/query-broadcast-client-experimental

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

@tanstack/query-core

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

@tanstack/query-devtools

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

@tanstack/query-persist-client-core

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

@tanstack/query-sync-storage-persister

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

@tanstack/react-query

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

@tanstack/react-query-devtools

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

@tanstack/react-query-next-experimental

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

@tanstack/react-query-persist-client

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

@tanstack/solid-query

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

@tanstack/solid-query-devtools

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

@tanstack/solid-query-persist-client

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

@tanstack/svelte-query

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

@tanstack/svelte-query-devtools

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

@tanstack/svelte-query-persist-client

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

@tanstack/vue-query

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

@tanstack/vue-query-devtools

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

commit: cb3d0c9

github-actions · 2026-04-04T05:12:42Z

size-limit report 📦

Path	Size
react full	11.98 KB (0%)
react minimal	9.01 KB (0%)

feat(vue-query): add 'mutationOptions'

30d4bbd

github-actions bot added the package: vue-query label Apr 4, 2026

autofix-ci bot and others added 3 commits April 4, 2026 05:09

ci: apply automated fixes

7131058

chore(.changeset): add changeset for 'mutationOptions' in vue-query

1bbcdb6

Merge branch 'main' into feat/vue-query-mutationOptions

cb3d0c9

sukvvon requested a review from DamianOsipiuk April 4, 2026 05:47

sukvvon self-assigned this Apr 4, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

feat(vue-query): add 'mutationOptions'#10381

feat(vue-query): add 'mutationOptions'#10381
sukvvon wants to merge 4 commits intomainfrom
feat/vue-query-mutationOptions

sukvvon commented Apr 4, 2026 •

edited by coderabbitai bot

Loading

Uh oh!

coderabbitai bot commented Apr 4, 2026 •

edited

Loading

Walkthrough

Changes

Estimated code review effort

Poem

❌ Failed checks (1 warning)

Uh oh!

nx-cloud bot commented Apr 4, 2026 •

edited

Loading

Uh oh!

github-actions bot commented Apr 4, 2026 •

edited

Loading

Uh oh!

pkg-pr-new bot commented Apr 4, 2026

Uh oh!

github-actions bot commented Apr 4, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

sukvvon commented Apr 4, 2026 • edited by coderabbitai bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎯 Changes

✅ Checklist

🚀 Release Impact

Summary by CodeRabbit

Uh oh!

coderabbitai bot commented Apr 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Changes

Estimated code review effort

Poem

❌ Failed checks (1 warning)

Uh oh!

nx-cloud bot commented Apr 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Apr 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Changeset Version Preview

🟨 Minor bumps

🟩 Patch bumps

Uh oh!

pkg-pr-new bot commented Apr 4, 2026

Uh oh!

github-actions bot commented Apr 4, 2026

size-limit report 📦

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

sukvvon commented Apr 4, 2026 •

edited by coderabbitai bot

Loading

coderabbitai bot commented Apr 4, 2026 •

edited

Loading

nx-cloud bot commented Apr 4, 2026 •

edited

Loading

github-actions bot commented Apr 4, 2026 •

edited

Loading