msw 2.12.6 → 2.12.8

package/lib/mockServiceWorker.js

@@ -7,7 +7,7 @@
  * - Please do NOT modify this file.
  */
 
-const PACKAGE_VERSION = '2.12.6'
+const PACKAGE_VERSION = '2.12.8'
 const INTEGRITY_CHECKSUM = '4db4a41e972cec1b64cc569c66952d82'
 const IS_MOCKED_RESPONSE = Symbol('isMockedResponse')
 const activeClientIds = new Set()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "msw",
-  "version": "2.12.6",
+  "version": "2.12.8",
   "description": "Seamless REST/GraphQL API mocking library for browser and Node.js.",
   "type": "commonjs",
   "main": "./lib/core/index.js",
@@ -215,7 +215,7 @@
   "sideEffects": false,
   "dependencies": {
     "@inquirer/confirm": "^5.0.0",
-    "@mswjs/interceptors": "^0.40.0",
+    "@mswjs/interceptors": "^0.41.0",
     "@open-draft/deferred-promise": "^2.2.0",
     "@types/statuses": "^2.0.6",
     "cookie": "^1.0.2",
@@ -225,7 +225,7 @@
     "outvariant": "^1.4.3",
     "path-to-regexp": "^6.3.0",
     "picocolors": "^1.1.1",
-    "rettime": "^0.7.0",
+    "rettime": "^0.10.1",
     "statuses": "^2.0.2",
     "strict-event-emitter": "^0.5.1",
     "tough-cookie": "^6.0.0",
@@ -242,7 +242,7 @@
     "@fastify/websocket": "^11.2.0",
     "@graphql-typed-document-node/core": "^3.2.0",
     "@open-draft/test-server": "^0.4.2",
-    "@ossjs/release": "^0.10.0",
+    "@ossjs/release": "^0.10.1",
     "@playwright/test": "^1.50.1",
     "@types/express": "^5.0.5",
     "@types/json-bigint": "^1.0.4",
@@ -285,7 +285,7 @@
     "vitest-environment-miniflare": "^2.14.4",
     "webpack": "^5.95.0",
     "webpack-http-server": "^0.5.0",
-    "msw": "2.12.6"
+    "msw": "2.12.8"
   },
   "peerDependencies": {
     "typescript": ">= 4.8.x"

package/src/core/graphql.ts

@@ -1,4 +1,4 @@
-import type { DocumentNode, OperationTypeNode } from 'graphql'
+import type { OperationTypeNode } from 'graphql'
 import {
   ResponseResolver,
   RequestHandlerOptions,
@@ -7,32 +7,29 @@ import {
   GraphQLHandler,
   GraphQLVariables,
   GraphQLOperationType,
-  GraphQLHandlerNameSelector,
   GraphQLResolverExtras,
   GraphQLResponseBody,
   GraphQLQuery,
-  GraphQLCustomPredicate,
+  GraphQLPredicate,
 } from './handlers/GraphQLHandler'
 import type { Path } from './utils/matching/matchRequestUrl'
 
-export interface TypedDocumentNode<
-  Result = { [key: string]: any },
-  Variables = { [key: string]: any },
-> extends DocumentNode {
-  __apiType?: (variables: Variables) => Result
-  __resultType?: Result
-  __variablesType?: Variables
-}
-
 export type GraphQLRequestHandler = <
   Query extends GraphQLQuery = GraphQLQuery,
   Variables extends GraphQLVariables = GraphQLVariables,
 >(
-  predicate:
-    | GraphQLHandlerNameSelector
-    | DocumentNode
-    | TypedDocumentNode<Query, Variables>
-    | GraphQLCustomPredicate,
+  predicate: GraphQLPredicate<Query, Variables>,
+  resolver: GraphQLResponseResolver<
+    [Query] extends [never] ? GraphQLQuery : Query,
+    Variables
+  >,
+  options?: RequestHandlerOptions,
+) => GraphQLHandler
+
+export type GraphQLOperationHandler = <
+  Query extends GraphQLQuery = GraphQLQuery,
+  Variables extends GraphQLVariables = GraphQLVariables,
+>(
   resolver: GraphQLResponseResolver<
     [Query] extends [never] ? GraphQLQuery : Query,
     Variables
@@ -58,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.
    *
@@ -110,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.
@@ -141,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,
+      ),
+    }
+  },
 }

package/src/core/handlers/GraphQLHandler.test.ts

@@ -139,7 +139,7 @@ describe('info', () => {
     expect(
       () => new GraphQLHandler(OperationTypeNode.QUERY, node, '*', resolver),
     ).toThrow(
-      'Failed to create a GraphQL handler: provided a DocumentNode with a mismatched operation type (expected "query", but got "mutation").',
+      'Failed to create a GraphQL handler: provided a DocumentNode with a mismatched operation type (expected "query" but got "mutation").',
     )
   })
 })

package/src/core/handlers/GraphQLHandler.ts

@@ -1,4 +1,9 @@
-import type { DocumentNode, GraphQLError, OperationTypeNode } from 'graphql'
+import {
+  parse,
+  type DocumentNode,
+  type GraphQLError,
+  type OperationTypeNode,
+} from 'graphql'
 import {
   DefaultBodyType,
   RequestHandler,
@@ -16,10 +21,21 @@ import {
   GraphQLMultipartRequestBody,
   parseGraphQLRequest,
   parseDocumentNode,
+  ParsedGraphQLQuery,
 } from '../utils/internal/parseGraphQLRequest'
 import { toPublicUrl } from '../utils/request/toPublicUrl'
 import { devUtils } from '../utils/internal/devUtils'
 import { getAllRequestCookies } from '../utils/request/getRequestCookies'
+import { invariant } from 'outvariant'
+
+export interface DocumentTypeDecoration<
+  Result = { [key: string]: any },
+  Variables = { [key: string]: any },
+> {
+  __apiType?: (variables: Variables) => Result
+  __resultType?: Result
+  __variablesType?: Variables
+}
 
 export type GraphQLOperationType = OperationTypeNode | 'all'
 export type GraphQLHandlerNameSelector = DocumentNode | RegExp | string
@@ -88,8 +104,9 @@ export type GraphQLCustomPredicate = (args: {
 
 export type GraphQLCustomPredicateResult = boolean | { matches: boolean }
 
-export type GraphQLPredicate =
+export type GraphQLPredicate<Query = any, Variables = any> =
   | GraphQLHandlerNameSelector
+  | DocumentTypeDecoration<Query, Variables>
   | GraphQLCustomPredicate
 
 export function isDocumentNode(
@@ -102,6 +119,12 @@ export function isDocumentNode(
   return typeof value === 'object' && 'kind' in value && 'definitions' in value
 }
 
+function isDocumentTypeDecoration(
+  value: any,
+): value is DocumentTypeDecoration<any, any> {
+  return value instanceof String
+}
+
 export class GraphQLHandler extends RequestHandler<
   GraphQLHandlerInfo,
   GraphQLRequestParsedResult,
@@ -114,6 +137,45 @@ export class GraphQLHandler extends RequestHandler<
     ParsedGraphQLRequest<GraphQLVariables>
   >()
 
+  static #parseOperationName(
+    predicate: GraphQLPredicate,
+    operationType: GraphQLOperationType,
+  ): GraphQLHandlerInfo['operationName'] {
+    const getOperationName = (node: ParsedGraphQLQuery): string => {
+      invariant(
+        node.operationType === operationType,
+        'Failed to create a GraphQL handler: provided a DocumentNode with a mismatched operation type (expected "%s" but got "%s").',
+        operationType,
+        node.operationType,
+      )
+
+      invariant(
+        node.operationName,
+        'Failed to create a GraphQL handler: provided a DocumentNode without operation name',
+      )
+
+      return node.operationName
+    }
+
+    if (isDocumentNode(predicate)) {
+      return getOperationName(parseDocumentNode(predicate))
+    }
+
+    if (isDocumentTypeDecoration(predicate)) {
+      const documentNode = parse(predicate.toString())
+
+      invariant(
+        isDocumentNode(documentNode),
+        'Failed to create a GraphQL handler: given TypedDocumentString (%s) does not produce a valid DocumentNode',
+        predicate,
+      )
+
+      return getOperationName(parseDocumentNode(documentNode))
+    }
+
+    return predicate
+  }
+
   constructor(
     operationType: GraphQLOperationType,
     predicate: GraphQLPredicate,
@@ -121,30 +183,13 @@ export class GraphQLHandler extends RequestHandler<
     resolver: ResponseResolver<GraphQLResolverExtras<any>, any, any>,
     options?: RequestHandlerOptions,
   ) {
-    let resolvedOperationName = predicate
-
-    if (isDocumentNode(resolvedOperationName)) {
-      const parsedNode = parseDocumentNode(resolvedOperationName)
-
-      if (parsedNode.operationType !== operationType) {
-        throw new Error(
-          `Failed to create a GraphQL handler: provided a DocumentNode with a mismatched operation type (expected "${operationType}", but got "${parsedNode.operationType}").`,
-        )
-      }
-
-      if (!parsedNode.operationName) {
-        throw new Error(
-          `Failed to create a GraphQL handler: provided a DocumentNode with no operation name.`,
-        )
-      }
-
-      resolvedOperationName = parsedNode.operationName
-    }
+    const operationName = GraphQLHandler.#parseOperationName(
+      predicate,
+      operationType,
+    )
 
     const displayOperationName =
-      typeof resolvedOperationName === 'function'
-        ? '[custom predicate]'
-        : resolvedOperationName
+      typeof operationName === 'function' ? '[custom predicate]' : operationName
 
     const header =
       operationType === 'all'
@@ -155,7 +200,10 @@ export class GraphQLHandler extends RequestHandler<
       info: {
         header,
         operationType,
-        operationName: resolvedOperationName,
+        operationName: GraphQLHandler.#parseOperationName(
+          predicate,
+          operationType,
+        ),
       },
       resolver,
       options,

package/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'