diff --git a/examples/graphql-react-apollo/src/ApolloClient.js b/examples/graphql-react-apollo/src/ApolloClient.js
index 579333d..99b82c7 100644
--- a/examples/graphql-react-apollo/src/ApolloClient.js
+++ b/examples/graphql-react-apollo/src/ApolloClient.js
@@ -1,18 +1,14 @@
import { ApolloClient, HttpLink, InMemoryCache } from '@apollo/client'
-const cache = new InMemoryCache()
-
-const link = new HttpLink({
- uri: 'http://localhost:3000/graphql',
-
- // Use explicit `window.fetch` so tha outgoing requests
- // are captured and deferred until the Service Worker is ready.
- fetch: (...args) => fetch(...args),
-})
-
// Isolate Apollo client so it could be reused
// in both application runtime and tests.
export const client = new ApolloClient({
- cache,
- link,
+ link: new HttpLink({
+ uri: 'http://localhost:3000/graphql',
+
+ // Use explicit `window.fetch` so the outgoing requests
+ // are captured and deferred until the Service Worker is ready.
+ fetch: (...args) => fetch(...args),
+ }),
+ cache: new InMemoryCache(),
})
diff --git a/examples/graphql-react-apollo/src/setupTests.js b/examples/graphql-react-apollo/src/setupTests.js
index d0b1653..864b8ee 100644
--- a/examples/graphql-react-apollo/src/setupTests.js
+++ b/examples/graphql-react-apollo/src/setupTests.js
@@ -1,7 +1,3 @@
-// jest-dom adds custom jest matchers for asserting on DOM nodes.
-// allows you to do things like:
-// expect(element).toHaveTextContent(/react/i)
-// learn more: https://github.com/testing-library/jest-dom
import '@testing-library/jest-dom/extend-expect'
import { server } from './mocks/server'
diff --git a/examples/with-graphql-codegen/.env b/examples/with-graphql-codegen/.env
new file mode 100644
index 0000000..6f809cc
--- /dev/null
+++ b/examples/with-graphql-codegen/.env
@@ -0,0 +1 @@
+SKIP_PREFLIGHT_CHECK=true
diff --git a/examples/with-graphql-codegen/.gitignore b/examples/with-graphql-codegen/.gitignore
new file mode 100644
index 0000000..4d29575
--- /dev/null
+++ b/examples/with-graphql-codegen/.gitignore
@@ -0,0 +1,23 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# production
+/build
+
+# misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
diff --git a/examples/with-graphql-codegen/README.md b/examples/with-graphql-codegen/README.md
new file mode 100644
index 0000000..b58e0af
--- /dev/null
+++ b/examples/with-graphql-codegen/README.md
@@ -0,0 +1,46 @@
+# Getting Started with Create React App
+
+This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).
+
+## Available Scripts
+
+In the project directory, you can run:
+
+### `yarn start`
+
+Runs the app in the development mode.\
+Open [http://localhost:3000](http://localhost:3000) to view it in the browser.
+
+The page will reload if you make edits.\
+You will also see any lint errors in the console.
+
+### `yarn test`
+
+Launches the test runner in the interactive watch mode.\
+See the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.
+
+### `yarn build`
+
+Builds the app for production to the `build` folder.\
+It correctly bundles React in production mode and optimizes the build for the best performance.
+
+The build is minified and the filenames include the hashes.\
+Your app is ready to be deployed!
+
+See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.
+
+### `yarn eject`
+
+**Note: this is a one-way operation. Once you `eject`, you can’t go back!**
+
+If you aren’t satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.
+
+Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you’re on your own.
+
+You don’t have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn’t feel obligated to use this feature. However we understand that this tool wouldn’t be useful if you couldn’t customize it when you are ready for it.
+
+## Learn More
+
+You can learn more in the [Create React App documentation](https://facebook.github.io/create-react-app/docs/getting-started).
+
+To learn React, check out the [React documentation](https://reactjs.org/).
diff --git a/examples/with-graphql-codegen/codegen.yml b/examples/with-graphql-codegen/codegen.yml
new file mode 100644
index 0000000..01a766d
--- /dev/null
+++ b/examples/with-graphql-codegen/codegen.yml
@@ -0,0 +1,10 @@
+schema: graphql/schema.gql
+documents: graphql/queries/**/*.gql
+generates:
+ graphql/generated.ts:
+ plugins:
+ - typescript
+ - typescript-operations
+ - typed-document-node
+ config:
+ withHooks: false
diff --git a/examples/with-graphql-codegen/package.json b/examples/with-graphql-codegen/package.json
new file mode 100644
index 0000000..09dcb98
--- /dev/null
+++ b/examples/with-graphql-codegen/package.json
@@ -0,0 +1,54 @@
+{
+ "name": "with-graphql-codegen-2",
+ "version": "0.1.0",
+ "private": true,
+ "dependencies": {
+ "@apollo/client": "^3.3.21",
+ "@graphql-codegen/cli": "^1.21.7",
+ "@graphql-codegen/typed-document-node": "^1.18.10",
+ "@graphql-codegen/typescript": "^1.23.0",
+ "@graphql-codegen/typescript-operations": "^1.18.4",
+ "@testing-library/jest-dom": "^5.11.4",
+ "@testing-library/react": "^11.1.0",
+ "@testing-library/user-event": "^13.1.9",
+ "@types/jest": "^26.0.15",
+ "@types/node": "^12.0.0",
+ "@types/react": "^17.0.0",
+ "@types/react-dom": "^17.0.0",
+ "graphql": "^15.5.1",
+ "msw": "^0.32.0",
+ "react": "^17.0.2",
+ "react-dom": "^17.0.2",
+ "react-scripts": "4.0.3",
+ "typescript": "^4.1.2"
+ },
+ "scripts": {
+ "start": "react-scripts start",
+ "build": "react-scripts build",
+ "test": "react-scripts test",
+ "eject": "react-scripts eject",
+ "generate": "graphql-codegen",
+ "update": "yarn msw init ./public --no-save"
+ },
+ "eslintConfig": {
+ "extends": [
+ "react-app",
+ "react-app/jest"
+ ]
+ },
+ "browserslist": {
+ "production": [
+ ">0.2%",
+ "not dead",
+ "not op_mini all"
+ ],
+ "development": [
+ "last 1 chrome version",
+ "last 1 firefox version",
+ "last 1 safari version"
+ ]
+ },
+ "msw": {
+ "workerDirectory": "./public"
+ }
+}
diff --git a/examples/with-graphql-codegen/public/favicon.ico b/examples/with-graphql-codegen/public/favicon.ico
new file mode 100644
index 0000000..a11777c
Binary files /dev/null and b/examples/with-graphql-codegen/public/favicon.ico differ
diff --git a/examples/with-graphql-codegen/public/index.html b/examples/with-graphql-codegen/public/index.html
new file mode 100644
index 0000000..aa069f2
--- /dev/null
+++ b/examples/with-graphql-codegen/public/index.html
@@ -0,0 +1,43 @@
+
+
+
+
+
+
+
+
+
+
+
+
+ React App
+
+
+
+
+
+
+
diff --git a/examples/with-graphql-codegen/public/manifest.json b/examples/with-graphql-codegen/public/manifest.json
new file mode 100644
index 0000000..1f2f141
--- /dev/null
+++ b/examples/with-graphql-codegen/public/manifest.json
@@ -0,0 +1,15 @@
+{
+ "short_name": "React App",
+ "name": "Create React App Sample",
+ "icons": [
+ {
+ "src": "favicon.ico",
+ "sizes": "64x64 32x32 24x24 16x16",
+ "type": "image/x-icon"
+ }
+ ],
+ "start_url": ".",
+ "display": "standalone",
+ "theme_color": "#000000",
+ "background_color": "#ffffff"
+}
diff --git a/examples/with-graphql-codegen/public/mockServiceWorker.js b/examples/with-graphql-codegen/public/mockServiceWorker.js
new file mode 100644
index 0000000..fa6771c
--- /dev/null
+++ b/examples/with-graphql-codegen/public/mockServiceWorker.js
@@ -0,0 +1,323 @@
+/* eslint-disable */
+/* tslint:disable */
+
+/**
+ * Mock Service Worker (0.32.0).
+ * @see https://github.com/mswjs/msw
+ * - Please do NOT modify this file.
+ * - Please do NOT serve this file on production.
+ */
+
+const INTEGRITY_CHECKSUM = '82ef9b96d8393b6da34527d1d6e19187'
+const bypassHeaderName = 'x-msw-bypass'
+const activeClientIds = new Set()
+
+self.addEventListener('install', function () {
+ return self.skipWaiting()
+})
+
+self.addEventListener('activate', async function (event) {
+ return self.clients.claim()
+})
+
+self.addEventListener('message', async function (event) {
+ const clientId = event.source.id
+
+ if (!clientId || !self.clients) {
+ return
+ }
+
+ const client = await self.clients.get(clientId)
+
+ if (!client) {
+ return
+ }
+
+ const allClients = await self.clients.matchAll()
+
+ switch (event.data) {
+ case 'KEEPALIVE_REQUEST': {
+ sendToClient(client, {
+ type: 'KEEPALIVE_RESPONSE',
+ })
+ break
+ }
+
+ case 'INTEGRITY_CHECK_REQUEST': {
+ sendToClient(client, {
+ type: 'INTEGRITY_CHECK_RESPONSE',
+ payload: INTEGRITY_CHECKSUM,
+ })
+ break
+ }
+
+ case 'MOCK_ACTIVATE': {
+ activeClientIds.add(clientId)
+
+ sendToClient(client, {
+ type: 'MOCKING_ENABLED',
+ payload: true,
+ })
+ break
+ }
+
+ case 'MOCK_DEACTIVATE': {
+ activeClientIds.delete(clientId)
+ break
+ }
+
+ case 'CLIENT_CLOSED': {
+ activeClientIds.delete(clientId)
+
+ const remainingClients = allClients.filter((client) => {
+ return client.id !== clientId
+ })
+
+ // Unregister itself when there are no more clients
+ if (remainingClients.length === 0) {
+ self.registration.unregister()
+ }
+
+ break
+ }
+ }
+})
+
+// Resolve the "master" client for the given event.
+// Client that issues a request doesn't necessarily equal the client
+// that registered the worker. It's with the latter the worker should
+// communicate with during the response resolving phase.
+async function resolveMasterClient(event) {
+ const client = await self.clients.get(event.clientId)
+
+ if (client.frameType === 'top-level') {
+ return client
+ }
+
+ const allClients = await self.clients.matchAll()
+
+ return allClients
+ .filter((client) => {
+ // Get only those clients that are currently visible.
+ return client.visibilityState === 'visible'
+ })
+ .find((client) => {
+ // Find the client ID that's recorded in the
+ // set of clients that have registered the worker.
+ return activeClientIds.has(client.id)
+ })
+}
+
+async function handleRequest(event, requestId) {
+ const client = await resolveMasterClient(event)
+ const response = await getResponse(event, client, requestId)
+
+ // Send back the response clone for the "response:*" life-cycle events.
+ // Ensure MSW is active and ready to handle the message, otherwise
+ // this message will pend indefinitely.
+ if (client && activeClientIds.has(client.id)) {
+ ;(async function () {
+ const clonedResponse = response.clone()
+ sendToClient(client, {
+ type: 'RESPONSE',
+ payload: {
+ requestId,
+ type: clonedResponse.type,
+ ok: clonedResponse.ok,
+ status: clonedResponse.status,
+ statusText: clonedResponse.statusText,
+ body:
+ clonedResponse.body === null ? null : await clonedResponse.text(),
+ headers: serializeHeaders(clonedResponse.headers),
+ redirected: clonedResponse.redirected,
+ },
+ })
+ })()
+ }
+
+ return response
+}
+
+async function getResponse(event, client, requestId) {
+ const { request } = event
+ const requestClone = request.clone()
+ const getOriginalResponse = () => fetch(requestClone)
+
+ // Bypass mocking when the request client is not active.
+ if (!client) {
+ return getOriginalResponse()
+ }
+
+ // Bypass initial page load requests (i.e. static assets).
+ // The absence of the immediate/parent client in the map of the active clients
+ // means that MSW hasn't dispatched the "MOCK_ACTIVATE" event yet
+ // and is not ready to handle requests.
+ if (!activeClientIds.has(client.id)) {
+ return await getOriginalResponse()
+ }
+
+ // Bypass requests with the explicit bypass header
+ if (requestClone.headers.get(bypassHeaderName) === 'true') {
+ const cleanRequestHeaders = serializeHeaders(requestClone.headers)
+
+ // Remove the bypass header to comply with the CORS preflight check.
+ delete cleanRequestHeaders[bypassHeaderName]
+
+ const originalRequest = new Request(requestClone, {
+ headers: new Headers(cleanRequestHeaders),
+ })
+
+ return fetch(originalRequest)
+ }
+
+ // Send the request to the client-side MSW.
+ const reqHeaders = serializeHeaders(request.headers)
+ const body = await request.text()
+
+ const clientMessage = await sendToClient(client, {
+ type: 'REQUEST',
+ payload: {
+ id: requestId,
+ url: request.url,
+ method: request.method,
+ headers: reqHeaders,
+ cache: request.cache,
+ mode: request.mode,
+ credentials: request.credentials,
+ destination: request.destination,
+ integrity: request.integrity,
+ redirect: request.redirect,
+ referrer: request.referrer,
+ referrerPolicy: request.referrerPolicy,
+ body,
+ bodyUsed: request.bodyUsed,
+ keepalive: request.keepalive,
+ },
+ })
+
+ switch (clientMessage.type) {
+ case 'MOCK_SUCCESS': {
+ return delayPromise(
+ () => respondWithMock(clientMessage),
+ clientMessage.payload.delay,
+ )
+ }
+
+ case 'MOCK_NOT_FOUND': {
+ return getOriginalResponse()
+ }
+
+ case 'NETWORK_ERROR': {
+ const { name, message } = clientMessage.payload
+ const networkError = new Error(message)
+ networkError.name = name
+
+ // Rejecting a request Promise emulates a network error.
+ throw networkError
+ }
+
+ case 'INTERNAL_ERROR': {
+ const parsedBody = JSON.parse(clientMessage.payload.body)
+
+ console.error(
+ `\
+[MSW] Request handler function for "%s %s" has thrown the following exception:
+
+${parsedBody.errorType}: ${parsedBody.message}
+(see more detailed error stack trace in the mocked response body)
+
+This exception has been gracefully handled as a 500 response, however, it's strongly recommended to resolve this error.
+If you wish to mock an error response, please refer to this guide: https://mswjs.io/docs/recipes/mocking-error-responses\
+`,
+ request.method,
+ request.url,
+ )
+
+ return respondWithMock(clientMessage)
+ }
+ }
+
+ return getOriginalResponse()
+}
+
+self.addEventListener('fetch', function (event) {
+ const { request } = event
+
+ // Bypass navigation requests.
+ if (request.mode === 'navigate') {
+ return
+ }
+
+ // Opening the DevTools triggers the "only-if-cached" request
+ // that cannot be handled by the worker. Bypass such requests.
+ if (request.cache === 'only-if-cached' && request.mode !== 'same-origin') {
+ return
+ }
+
+ // Bypass all requests when there are no active clients.
+ // Prevents the self-unregistered worked from handling requests
+ // after it's been deleted (still remains active until the next reload).
+ if (activeClientIds.size === 0) {
+ return
+ }
+
+ const requestId = uuidv4()
+
+ return event.respondWith(
+ handleRequest(event, requestId).catch((error) => {
+ console.error(
+ '[MSW] Failed to mock a "%s" request to "%s": %s',
+ request.method,
+ request.url,
+ error,
+ )
+ }),
+ )
+})
+
+function serializeHeaders(headers) {
+ const reqHeaders = {}
+ headers.forEach((value, name) => {
+ reqHeaders[name] = reqHeaders[name]
+ ? [].concat(reqHeaders[name]).concat(value)
+ : value
+ })
+ return reqHeaders
+}
+
+function sendToClient(client, message) {
+ return new Promise((resolve, reject) => {
+ const channel = new MessageChannel()
+
+ channel.port1.onmessage = (event) => {
+ if (event.data && event.data.error) {
+ return reject(event.data.error)
+ }
+
+ resolve(event.data)
+ }
+
+ client.postMessage(JSON.stringify(message), [channel.port2])
+ })
+}
+
+function delayPromise(cb, duration) {
+ return new Promise((resolve) => {
+ setTimeout(() => resolve(cb()), duration)
+ })
+}
+
+function respondWithMock(clientMessage) {
+ return new Response(clientMessage.payload.body, {
+ ...clientMessage.payload,
+ headers: clientMessage.payload.headers,
+ })
+}
+
+function uuidv4() {
+ return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+ const r = (Math.random() * 16) | 0
+ const v = c == 'x' ? r : (r & 0x3) | 0x8
+ return v.toString(16)
+ })
+}
diff --git a/examples/with-graphql-codegen/public/robots.txt b/examples/with-graphql-codegen/public/robots.txt
new file mode 100644
index 0000000..e9e57dc
--- /dev/null
+++ b/examples/with-graphql-codegen/public/robots.txt
@@ -0,0 +1,3 @@
+# https://www.robotstxt.org/robotstxt.html
+User-agent: *
+Disallow:
diff --git a/examples/with-graphql-codegen/src/ApolloClient.ts b/examples/with-graphql-codegen/src/ApolloClient.ts
new file mode 100644
index 0000000..99b82c7
--- /dev/null
+++ b/examples/with-graphql-codegen/src/ApolloClient.ts
@@ -0,0 +1,14 @@
+import { ApolloClient, HttpLink, InMemoryCache } from '@apollo/client'
+
+// Isolate Apollo client so it could be reused
+// in both application runtime and tests.
+export const client = new ApolloClient({
+ link: new HttpLink({
+ uri: 'http://localhost:3000/graphql',
+
+ // Use explicit `window.fetch` so the outgoing requests
+ // are captured and deferred until the Service Worker is ready.
+ fetch: (...args) => fetch(...args),
+ }),
+ cache: new InMemoryCache(),
+})
diff --git a/examples/with-graphql-codegen/src/LoginForm.test.tsx b/examples/with-graphql-codegen/src/LoginForm.test.tsx
new file mode 100644
index 0000000..77c0494
--- /dev/null
+++ b/examples/with-graphql-codegen/src/LoginForm.test.tsx
@@ -0,0 +1,24 @@
+import { ApolloProvider } from '@apollo/client'
+import { render, fireEvent, screen } from '@testing-library/react'
+import userEvent from '@testing-library/user-event'
+import { client } from './ApolloClient'
+import { LoginForm } from './LoginForm'
+
+it('allows the user to log in', async () => {
+ render(
+
+
+ ,
+ )
+
+ userEvent.type(screen.getByLabelText(/username/i), 'johnUser')
+ fireEvent.click(screen.getByRole('button', { name: 'Log in' }))
+
+ const username = await screen.findByTestId('username')
+ const firstName = await screen.findByTestId('firstName')
+ const lastName = await screen.findByTestId('lastName')
+
+ expect(username).toHaveTextContent('johnUser')
+ expect(firstName).toHaveTextContent('John')
+ expect(lastName).toHaveTextContent('Maverick')
+})
diff --git a/examples/with-graphql-codegen/src/LoginForm.tsx b/examples/with-graphql-codegen/src/LoginForm.tsx
new file mode 100644
index 0000000..bd1f9ef
--- /dev/null
+++ b/examples/with-graphql-codegen/src/LoginForm.tsx
@@ -0,0 +1,69 @@
+import { useState, useCallback } from 'react'
+import { useMutation } from '@apollo/client'
+import { LoginDocument } from './graphql/generated'
+
+export const LoginForm = () => {
+ const [username, setUsername] = useState('')
+ const [login, { data, loading, error }] = useMutation(LoginDocument, {
+ variables: {
+ username,
+ },
+ })
+
+ // Whenever we change our username input's value
+ // update the corresponding state's value.
+ const handleUsernameChange = useCallback((event) => {
+ setUsername(event.target.value)
+ }, [])
+
+ // Handle a submit event of the form
+ const handleFormSubmit = useCallback(
+ (event) => {
+ // Prevent the default behavior, as we don't want
+ // for our page to reload upon submit.
+ event.preventDefault()
+
+ login({
+ variables: {
+ username,
+ },
+ })
+ },
+ [username, login],
+ )
+
+ if (loading) {
+ return Loading...
+ }
+
+ if (error) {
+ return Error while fetching the user data ({error.message})
+ }
+
+ if (data?.login) {
+ return (
+
+
+ {data.login.firstName}{' '}
+ {data.login.lastName}
+
+
{data.login.username}
+