feat(types): support typing QueryKey and MutationKey via Register (#8521)

* feat(types): support typing QueryKey and MutationKey via Register
* ci: apply automated fixes
---------
Co-authored-by: Dominik Dorfmeister <office@dorfmeister.cc>
Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com>

Author: 3 people

docs/framework/react/typescript.md

@@ -172,6 +172,28 @@ declare module '@tanstack/react-query' {
 ```
 
 [//]: #'TypingMeta'
+[//]: #'TypingQueryAndMutationKeys'
+
+## Typing query and mutation keys
+
+### Registering the query and mutation key types
+
+Also similarly to registering a [global error type](#registering-a-global-error), you can also register a global `QueryKey` and `MutationKey` type. This allows you to provide more structure to your keys, that matches your application's hierarchy, and have them be typed across all of the library's surface area. Note that the registered type must extend the `Array` type, so that your keys remain an array.
+
+```ts
+import'@tanstack/react-query'
+
+typeQueryKey= ['dashboard'|'marketing', ...ReadonlyArray<unknown>]
+
+declaremodule'@tanstack/react-query' {
+interfaceRegister {
+ queryKey:QueryKey
+ mutationKey:QueryKey
+ }
+}
+```
+
+[//]: #'TypingQueryAndMutationKeys'
 [//]: #'TypingQueryOptions'
 
 ## Typing Query Options

packages/query-core/src/types.ts

@@ -32,6 +32,8 @@ export interface Register {
 // defaultError: Error
 // queryMeta: Record<string, unknown>
 // mutationMeta: Record<string, unknown>
+// queryKey: ReadonlyArray<unknown>
+// mutationKey: ReadonlyArray<unknown>
 }
 
 exporttypeDefaultError=Registerextends{
@@ -40,7 +42,13 @@ export type DefaultError = Register extends {
  ? TError
  : Error
 
-exporttypeQueryKey=ReadonlyArray<unknown>
+exporttypeQueryKey=Registerextends{
+queryKey: infer TQueryKey
+}
+ ? TQueryKeyextendsArray<unknown>
+ ? TQueryKey
+ : ReadonlyArray<unknown>
+ : ReadonlyArray<unknown>
 
 exportconstdataTagSymbol=Symbol('dataTagSymbol')
 exporttypedataTagSymbol=typeofdataTagSymbol
@@ -996,7 +1004,13 @@ export type InfiniteQueryObserverResult<
 |InfiniteQueryObserverLoadingResult<TData,TError>
 |InfiniteQueryObserverPendingResult<TData,TError>
 
-exporttypeMutationKey=ReadonlyArray<unknown>
+exporttypeMutationKey=Registerextends{
+mutationKey: infer TMutationKey
+}
+ ? TMutationKeyextendsArray<unknown>
+ ? TMutationKey
+ : ReadonlyArray<unknown>
+ : ReadonlyArray<unknown>
 
 exporttypeMutationStatus='idle'|'pending'|'success'|'error'