feat(core): convert MetaQuery and GraphQLQueryOptions to interfaces

.changeset/tame-lions-smile.md

@@ -0,0 +1,20 @@
+---
+"@refinedev/core": minor
+---
+
+Converted `MetaQuery` and `GraphQLQueryOptions` from type aliases to interfaces.
+
+This is structurally identical and fully backward compatible, but it unlocks TypeScript's [declaration merging](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) for `MetaQuery`. Consumers can now extend it in their own apps to get autocompletion and type-checking for custom `meta` fields (e.g. `meta.queryParams` used by custom data providers) across every hook that accepts `meta`:
+
+```ts
+declare module "@refinedev/core" {
+  interface MetaQuery {
+    queryParams?: {
+      _pull?: string;
+      [key: string]: unknown;
+    };
+  }
+}
+```
+
+Previously this was not possible because declaration merging only applies to interfaces, not type aliases.

documentation/docs/core/interface-references/index.md

@@ -203,25 +203,37 @@ type OpenNotificationParams = {
 ### MetaQuery
 
 ```tsx
-type MetaQuery = {
+interface MetaQuery extends QueryBuilderOptions, GraphQLQueryOptions {
   queryContext?: Omit<QueryFunctionContext, "meta">;
   [key: string]: any;
-} & QueryBuilderOptions &
-  GraphQLQueryOptions;
+}
+```
+
+Since `MetaQuery` is an interface, you can use [declaration merging](https://www.typescriptlang.org/docs/handbook/declaration-merging.html) to add typed fields to it (e.g. the `queryParams` your data provider reads) and get autocompletion/type-checking across every hook that accepts `meta`:
+
+```tsx
+declare module "@refinedev/core" {
+  interface MetaQuery {
+    queryParams?: {
+      _pull?: string;
+      [key: string]: unknown;
+    };
+  }
+}
 ```
 
 ### GraphQLQueryOptions
 
 ```tsx
 import type { DocumentNode } from "graphql";
 
-type GraphQLQueryOptions = {
+interface GraphQLQueryOptions {
   gqlQuery?: DocumentNode;
   gqlMutation?: DocumentNode;
   gqlVariables?: {
     [key: string]: any;
   };
-};
+}
 ```
 
 ### QueryFunctionContext

packages/core/src/contexts/data/types.ts

@@ -39,7 +39,7 @@ export interface QueryBuilderOptions {
   variables?: VariableOptions;
 }
 
-export type GraphQLQueryOptions = {
+export interface GraphQLQueryOptions {
   /**
    * @description GraphQL query to be used by data providers.
    * @optional
@@ -161,13 +161,12 @@ export type GraphQLQueryOptions = {
   gqlVariables?: {
     [key: string]: any;
   };
-};
+}
 
-export type MetaQuery = {
+export interface MetaQuery extends QueryBuilderOptions, GraphQLQueryOptions {
   [k: string]: any;
   queryContext?: Omit<QueryFunctionContext, "meta">;
-} & QueryBuilderOptions &
-  GraphQLQueryOptions;
+}
 
 export interface Pagination {
   /**