fix(query): pass operationId and operationName to queryOptions mutator (#3427)

* fix(query): pass operationId and operationName to queryOptions mutator

The `mutationOptions` mutator has received `{ operationId, operationName }`
as its third argument since #1974, but the symmetric `queryOptions` mutator
was left with only `{ url }`. That asymmetry made it impossible to write
`queryOptions` overrides that branch on operation identity (e.g. attach
per-operation metadata or invalidate by `operationId`).

Extend the third argument of `queryOptions` mutator calls from `{ url }`
to `{ url, operationId, operationName }`. The change is additive —
mutators that today read `arg3.url` keep working unchanged. Both call
sites are updated: the main query options builder and the
`applyQueryOptionsMutator` helper that backs `invalidate`/`set`/`get`.

The 2nd-arg asymmetry between `queryOptions` (`{ queryProperties }`) and
`mutationOptions` (`{ url }`) is shipped behaviour and is left alone.

Closes #3153

* docs(query): correct queryOptions vs mutationOptions 3rd-arg shapes

test(query): decouple operationName from operationId in #3153 regression

Author: wadakatu

docs/content/docs/reference/configuration/output.mdx

@@ -858,6 +858,15 @@ Include abort signal in queries.
 
 Custom query/mutation key or options functions.
 
+When a `queryOptions` or `mutationOptions` mutator declares a third
+parameter, orval passes operation identity so the mutator can branch on it
+(for example, to attach per-operation metadata or invalidate by
+`operationId`). The exact shape differs between the two:
+
+- `queryOptions` mutator — `{ url, operationId, operationName }`
+- `mutationOptions` mutator — `{ operationId, operationName }` (the `url`
+  is supplied in the second parameter)
+
 ### shouldExportMutatorHooks
 
 **Type:** `Boolean`

packages/query/src/query-generator.ts

@@ -348,6 +348,7 @@ const generatePrefetch = ({
 
 const generateQueryImplementation = ({
   queryOption: { name, queryParam, options, type, queryKeyFnName },
+  operationId,
   operationName,
   queryProperties,
   queryKeyProperties,
@@ -382,6 +383,7 @@ const generateQueryImplementation = ({
     queryKeyFnName: string;
   };
   isRequestOptions: boolean;
+  operationId: string;
   operationName: string;
   queryProperties: string;
   queryKeyProperties: string;
@@ -652,12 +654,17 @@ ${hookOptions}
           ? // Pass the same options object the non-mutator branch returns so
             // generated guards (e.g. the `enabled` clause for nullish path
             // params) reach the mutator instead of being dropped. See #1522.
+            // The third arg additionally carries operation identity (matching
+            // mutationOptions per #1974) so mutators can branch on the source
+            // operation. See #3153.
             `const customOptions = ${
               queryOptionsMutator.name
             }({ queryKey, queryFn, ${queryOptionsImp}}${
               queryOptionsMutator.hasSecondArg ? `, { ${queryProperties} }` : ''
             }${
-              queryOptionsMutator.hasThirdArg ? `, { url: \`${route}\` }` : ''
+              queryOptionsMutator.hasThirdArg
+                ? `, { url: \`${route}\`, operationId: '${operationId}', operationName: '${operationName}' }`
+                : ''
             });`
           : ''
       }
@@ -733,7 +740,9 @@ export function ${queryHookName}<TData = ${TData}, TError = ${errorType}>(\n ${q
       ? `${queryOptionsMutator.name}({ queryKey: ${baseExpr} }${
           queryOptionsMutator.hasSecondArg ? `, { ${queryProperties} }` : ''
         }${
-          queryOptionsMutator.hasThirdArg ? `, { url: \`${route}\` }` : ''
+          queryOptionsMutator.hasThirdArg
+            ? `, { url: \`${route}\`, operationId: '${operationId}', operationName: '${operationName}' }`
+            : ''
         }).queryKey`
       : baseExpr;
 
@@ -1145,6 +1154,7 @@ ${queryKeyFns}`;
     for (const queryOption of queries) {
       queryImplementations += generateQueryImplementation({
         queryOption,
+        operationId,
         operationName,
         queryProperties,
         queryKeyProperties,