fix(graphql): export the GraphQLLinkHandlers type (#2647)

Author: kettanaito

src/core/graphql.ts

@@ -26,6 +26,17 @@ export type GraphQLRequestHandler = <
   options?: RequestHandlerOptions,
 ) => GraphQLHandler
 
+export type GraphQLOperationHandler = <
+  Query extends GraphQLQuery = GraphQLQuery,
+  Variables extends GraphQLVariables = GraphQLVariables,
+>(
+  resolver: GraphQLResponseResolver<
+    [Query] extends [never] ? GraphQLQuery : Query,
+    Variables
+  >,
+  options?: RequestHandlerOptions,
+) => GraphQLHandler
+
 export type GraphQLResponseResolver<
   Query extends GraphQLQuery = GraphQLQuery,
   Variables extends GraphQLVariables = GraphQLVariables,
@@ -44,22 +55,28 @@ function createScopedGraphQLHandler(
   }
 }
 
-function createGraphQLOperationHandler(url: Path) {
-  return <
-    Query extends GraphQLQuery = GraphQLQuery,
-    Variables extends GraphQLVariables = GraphQLVariables,
-  >(
-    resolver: ResponseResolver<
-      GraphQLResolverExtras<Variables>,
-      null,
-      GraphQLResponseBody<Query>
-    >,
-  ) => {
-    return new GraphQLHandler('all', new RegExp('.*'), url, resolver)
+function createGraphQLOperationHandler(url: Path): GraphQLOperationHandler {
+  return (resolver, options) => {
+    return new GraphQLHandler('all', new RegExp('.*'), url, resolver, options)
   }
 }
 
-const standardGraphQLHandlers = {
+export interface GraphQLLinkHandlers {
+  query: GraphQLRequestHandler
+  mutation: GraphQLRequestHandler
+  operation: GraphQLOperationHandler
+}
+
+/**
+ * A namespace to intercept and mock GraphQL operations
+ *
+ * @example
+ * graphql.query('GetUser', resolver)
+ * graphql.mutation('DeletePost', resolver)
+ *
+ * @see {@link https://mswjs.io/docs/api/graphql `graphql` API reference}
+ */
+export const graphql = {
   /**
    * Intercepts a GraphQL query by a given name.
    *
@@ -96,27 +113,6 @@ const standardGraphQLHandlers = {
    * @see {@link https://mswjs.io/docs/api/graphql#graphqloperationresolver `graphql.operation()` API reference}
    */
   operation: createGraphQLOperationHandler('*'),
-}
-
-function createGraphQLLink(url: Path): typeof standardGraphQLHandlers {
-  return {
-    operation: createGraphQLOperationHandler(url),
-    query: createScopedGraphQLHandler('query' as OperationTypeNode, url),
-    mutation: createScopedGraphQLHandler('mutation' as OperationTypeNode, url),
-  }
-}
-
-/**
- * A namespace to intercept and mock GraphQL operations
- *
- * @example
- * graphql.query('GetUser', resolver)
- * graphql.mutation('DeletePost', resolver)
- *
- * @see {@link https://mswjs.io/docs/api/graphql `graphql` API reference}
- */
-export const graphql = {
-  ...standardGraphQLHandlers,
 
   /**
    * Intercepts GraphQL operations scoped by the given URL.
@@ -127,5 +123,14 @@ export const graphql = {
    *
    * @see {@link https://mswjs.io/docs/api/graphql#graphqllinkurl `graphql.link()` API reference}
    */
-  link: createGraphQLLink,
+  link(url: Path): GraphQLLinkHandlers {
+    return {
+      operation: createGraphQLOperationHandler(url),
+      query: createScopedGraphQLHandler('query' as OperationTypeNode, url),
+      mutation: createScopedGraphQLHandler(
+        'mutation' as OperationTypeNode,
+        url,
+      ),
+    }
+  },
 }

src/core/index.ts

@@ -73,7 +73,12 @@ export type {
   GraphQLOperationType,
   GraphQLCustomPredicate,
 } from './handlers/GraphQLHandler'
-export type { GraphQLRequestHandler, GraphQLResponseResolver } from './graphql'
+export type {
+  GraphQLRequestHandler,
+  GraphQLOperationHandler,
+  GraphQLResponseResolver,
+  GraphQLLinkHandlers,
+} from './graphql'
 
 export type { WebSocketData, WebSocketEventListener } from './ws'