msw 0.22.2 → 0.24.1

package/lib/esm/errors-deps.js

@@ -1,20 +1,60 @@
-import { j as json } from './fetch-deps.js';
+import { e as jsonParse, j as json } from './fetch-deps.js';
 
 /**
- * Returns a GraphQL body payload.
+ * Determines if the given value is an object.
+ */
+function isObject(value) {
+    return value != null && typeof value === 'object' && !Array.isArray(value);
+}
+
+/**
+ * Deeply merges two given objects with the right one
+ * having a priority during property assignment.
+ */
+function mergeRight(left, right) {
+    return Object.entries(right).reduce((result, [key, rightValue]) => {
+        const leftValue = result[key];
+        if (Array.isArray(leftValue) && Array.isArray(rightValue)) {
+            result[key] = leftValue.concat(rightValue);
+            return result;
+        }
+        if (isObject(leftValue) && isObject(rightValue)) {
+            result[key] = mergeRight(leftValue, rightValue);
+            return result;
+        }
+        result[key] = rightValue;
+        return result;
+    }, Object.assign({}, left));
+}
+
+/**
+ * Sets a given payload as a GraphQL response body.
+ * @example
+ * res(ctx.data({ user: { firstName: 'John' }}))
+ * @see {@link https://mswjs.io/docs/api/context/data `ctx.data()`}
  */
 const data = (payload) => {
-    return json({ data: payload }, { merge: true });
+    return (res) => {
+        const prevBody = jsonParse(res.body) || {};
+        const nextBody = mergeRight(prevBody, { data: payload });
+        return json(nextBody)(res);
+    };
 };
 
 /**
  * Sets a given list of GraphQL errors on the mocked response.
+ * @example res(ctx.errors([{ message: 'Unauthorized' }]))
+ * @see {@link https://mswjs.io/docs/api/context/errors}
  */
 const errors = (errorsList) => {
-    if (errorsList == null) {
-        return (res) => res;
-    }
-    return json({ errors: errorsList }, { merge: true });
+    return (res) => {
+        if (errorsList == null) {
+            return res;
+        }
+        const prevBody = jsonParse(res.body) || {};
+        const nextBody = mergeRight(prevBody, { errors: errorsList });
+        return json(nextBody)(res);
+    };
 };
 
-export { data as d, errors as e };
+export { data as d, errors as e, mergeRight as m };

package/lib/esm/fetch-deps.js

@@ -64,6 +64,13 @@ var statuses = {
 	"511": "Network Authentication Required"
 };
 
+/**
+ * Sets a response status code and text.
+ * @example
+ * res(ctx.status(301))
+ * res(ctx.status(400, 'Custom status text'))
+ * @see {@link https://mswjs.io/docs/api/context/status `ctx.status()`}
+ */
 const status = (statusCode, statusText) => {
     return (res) => {
         res.status = statusCode;
@@ -327,6 +334,10 @@ exports.flattenHeadersList = flattenHeadersList_1.flattenHeadersList;
 exports.flattenHeadersObject = flattenHeadersObject_1.flattenHeadersObject;
 });
 
+/**
+ * Sets one or multiple response headers.
+ * @see {@link https://mswjs.io/docs/api/context/set `ctx.set()`}
+ */
 function set(...args) {
     return (res) => {
         const [name, value] = args;
@@ -344,43 +355,32 @@ function set(...args) {
 }
 
 /**
- * Determines if the given value is an object.
- */
-function isObject(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
-
-/**
- * Deeply merges two given objects with the right one
- * having a priority during property assignment.
+ * Parses a given string into a JSON.
+ * Does not throw an exception on an invalid JSON string.
  */
-function mergeRight(left, right) {
-    return Object.entries(right).reduce((result, [key, rightValue]) => {
-        const leftValue = result[key];
-        if (Array.isArray(leftValue) && Array.isArray(rightValue)) {
-            result[key] = leftValue.concat(rightValue);
-            return result;
-        }
-        if (isObject(leftValue) && isObject(rightValue)) {
-            result[key] = mergeRight(leftValue, rightValue);
-            return result;
-        }
-        result[key] = rightValue;
-        return result;
-    }, Object.assign({}, left));
+function jsonParse(str) {
+    try {
+        return JSON.parse(str);
+    }
+    catch (error) {
+        return undefined;
+    }
 }
 
 /**
  * Sets the given value as the JSON body of the response.
+ * Appends a `Content-Type: application/json` header on the
+ * mocked response.
  * @example
- * res(json({ key: 'value' }))
- * res(json('Some string'))
- * res(json([1, '2', false, { ok: true }]))
+ * res(ctx.json('Some string'))
+ * res(ctx.json({ key: 'value' }))
+ * res(ctx.json([1, '2', false, { ok: true }]))
+ * @see {@link https://mswjs.io/docs/api/context/json `ctx.json()`}
  */
-const json = (body, { merge = false } = {}) => {
+const json = (body) => {
     return (res) => {
         res.headers.set('Content-Type', 'application/json');
-        res.body = merge ? mergeRight(res.body || {}, body) : body;
+        res.body = JSON.stringify(body);
         return res;
     };
 };
@@ -412,10 +412,11 @@ const getRandomServerResponseTime = () => {
         MIN_SERVER_RESPONSE_TIME);
 };
 /**
- * Delays the current response for the given duration (in ms)
+ * Delays the response by the given duration (ms).
  * @example
- * res(delay()) // realistic server response time
- * res(delay(1500)) // explicit response delay duration
+ * res(ctx.delay()) // realistic server response time
+ * res(ctx.delay(1200))
+ * @see {@link https://mswjs.io/docs/api/context/delay `ctx.delay()`}
  */
 const delay = (durationMs) => {
     return (res) => {
@@ -441,9 +442,10 @@ const createFetchRequestParameters = (input) => {
     return requestParameters;
 };
 /**
- * Wrapper around the native `window.fetch()` function that performs
- * a request bypassing MSW. Requests performed using
- * this function will never be mocked.
+ * Performs a bypassed request inside a request handler.
+ * @example
+ * const originalResponse = await ctx.fetch(req)
+ * @see {@link https://mswjs.io/docs/api/context/fetch `ctx.fetch()`}
  */
 const fetch = (input, requestInit = {}) => {
     // Keep the default `window.fetch()` call signature
@@ -455,4 +457,4 @@ const fetch = (input, requestInit = {}) => {
     return useFetch(input.url.href, compliantRequest);
 };
 
-export { set as a, commonjsGlobal as b, createCommonjsModule as c, delay as d, fetch as f, isNodeProcess as i, json as j, lib as l, mergeRight as m, status as s };
+export { set as a, commonjsGlobal as b, createCommonjsModule as c, delay as d, jsonParse as e, fetch as f, isNodeProcess as i, json as j, lib as l, status as s };

package/lib/esm/{matchRequestUrl-deps.js → getCallFrame-deps.js}

@@ -1,17 +1,4 @@
-import { l as lib, c as createCommonjsModule } from './fetch-deps.js';
-
-/**
- * Parses a given string into a JSON.
- * Does not throw an exception on an invalid JSON string.
- */
-function jsonParse(str) {
-    try {
-        return JSON.parse(str);
-    }
-    catch (error) {
-        return undefined;
-    }
-}
+import { e as jsonParse, l as lib, c as createCommonjsModule } from './fetch-deps.js';
 
 /**
  * Parses a given request/response body based on the `Content-Type` header.
@@ -179,4 +166,29 @@ function matchRequestUrl(url, mask) {
     return match(cleanMask, cleanRequestUrl);
 }
 
-export { prepareRequest as a, prepareResponse as b, getTimestamp as c, getStatusCodeColor as d, getUrlByMask as g, jsonParse as j, matchRequestUrl as m, parseBody as p };
+/**
+ * Return the stack trace frame of a function's invocation.
+ */
+function getCallFrame() {
+    try {
+        const inspectionError = new Error();
+        inspectionError.name = 'Inspection Error';
+        throw inspectionError;
+    }
+    catch (error) {
+        const frames = error.stack.split('\n');
+        // Get the first frame that doesn't reference the library's internal trace.
+        // Assume that frame is the invocation frame.
+        const declarationFrame = frames.slice(1).find((frame) => {
+            return !/(node_modules)?\/lib\/(umd|esm)\//.test(frame);
+        });
+        if (!declarationFrame) {
+            return;
+        }
+        // Extract file reference from the stack frame.
+        const [, declarationPath] = declarationFrame.match(/\((.+?)\)$/) || [];
+        return declarationPath;
+    }
+}
+
+export { getCallFrame as a, prepareRequest as b, prepareResponse as c, getTimestamp as d, getStatusCodeColor as e, getUrlByMask as g, matchRequestUrl as m, parseBody as p };

package/lib/esm/graphql.js

@@ -1,6 +1,6 @@
-import { a as set, s as status, d as delay, f as fetch } from './fetch-deps.js';
+import { a as set, s as status, d as delay, f as fetch, e as jsonParse } from './fetch-deps.js';
 import { d as data, e as errors } from './errors-deps.js';
-import { j as jsonParse, m as matchRequestUrl, a as prepareRequest, b as prepareResponse, c as getTimestamp, d as getStatusCodeColor } from './matchRequestUrl-deps.js';
+import { m as matchRequestUrl, b as prepareRequest, c as prepareResponse, d as getTimestamp, e as getStatusCodeColor, a as getCallFrame } from './getCallFrame-deps.js';
 
 function _typeof(obj) { "@babel/helpers - typeof"; if (typeof Symbol === "function" && typeof Symbol.iterator === "symbol") { _typeof = function _typeof(obj) { return typeof obj; }; } else { _typeof = function _typeof(obj) { return obj && typeof Symbol === "function" && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }; } return _typeof(obj); }
 
@@ -3143,6 +3143,7 @@ function parseQuery(query, definitionOperation = 'query') {
     };
 }
 function graphQLRequestHandler(expectedOperationType, expectedOperationName, mask, resolver) {
+    const callFrame = getCallFrame();
     return {
         resolver,
         parse(req) {
@@ -3214,6 +3215,17 @@ function graphQLRequestHandler(expectedOperationType, expectedOperationName, mas
             console.log('Response:', loggedResponse);
             console.groupEnd();
         },
+        getMetaInfo() {
+            const header = expectedOperationType === 'all'
+                ? `[graphql] ${expectedOperationType} (origin: ${mask.toString()})`
+                : `[graphql] ${expectedOperationType} ${expectedOperationName} (origin: ${mask.toString()})`;
+            return {
+                type: 'graphql',
+                header,
+                mask,
+                callFrame,
+            };
+        },
     };
 }
 const createGraphQLScopedHandler = (expectedOperationType, mask) => {
@@ -3227,10 +3239,42 @@ const createGraphQLOperationHandler = (mask) => {
     };
 };
 const graphqlStandardHandlers = {
+    /**
+     * Captures any GraphQL operation, regardless of its name, under the current scope.
+     * @example
+     * graphql.operation((req, res, ctx) => {
+     *   return res(ctx.data({ name: 'John' }))
+     * })
+     * @see {@link https://mswjs.io/docs/api/graphql/operation `graphql.operation()`}
+     */
     operation: createGraphQLOperationHandler('*'),
+    /**
+     * Captures a GraphQL query by a given name.
+     * @example
+     * graphql.query('GetUser', (req, res, ctx) => {
+     *   return res(ctx.data({ user: { name: 'John' } }))
+     * })
+     * @see {@link https://mswjs.io/docs/api/graphql/query `graphql.query()`}
+     */
     query: createGraphQLScopedHandler('query', '*'),
+    /**
+     * Captures a GraphQL mutation by a given name.
+     * @example
+     * graphql.mutation('SavePost', (req, res, ctx) => {
+     *   return res(ctx.data({ post: { id: 'abc-123' } }))
+     * })
+     * @see {@link https://mswjs.io/docs/api/graphql/mutation `graphql.mutation()`}
+     */
     mutation: createGraphQLScopedHandler('mutation', '*'),
 };
+/**
+ * Creates a GraphQL mocking API scoped to the given endpoint.
+ * @param uri Endpoint URL, or path.
+ * @example
+ * const api = graphql.link('https://api.site.com/graphql)
+ * api.query('GetUser', resolver)
+ * @see {@link https://mswjs.io/docs/api/graphql/link `graphql.link()`}
+ */
 function createGraphQLLink(uri) {
     return {
         operation: createGraphQLOperationHandler(uri),

package/lib/esm/index.js

@@ -1,11 +1,11 @@
-import { c as createCommonjsModule, s as status, a as set, d as delay, f as fetch, l as lib$1, m as mergeRight, i as isNodeProcess } from './fetch-deps.js';
+import { c as createCommonjsModule, s as status, a as set, d as delay, f as fetch, l as lib$1, i as isNodeProcess } from './fetch-deps.js';
 import { p as parse_1 } from './xml-deps.js';
-import './errors-deps.js';
+import { m as mergeRight } from './errors-deps.js';
 export { i as context } from './index-deps.js';
 import { g as getPublicUrlFromRequest, i as isStringEqual } from './rest-deps.js';
 export { R as RESTMethods, r as rest, a as restContext } from './rest-deps.js';
-import { p as parseBody } from './matchRequestUrl-deps.js';
-export { m as matchRequestUrl } from './matchRequestUrl-deps.js';
+import { p as parseBody } from './getCallFrame-deps.js';
+export { m as matchRequestUrl } from './getCallFrame-deps.js';
 export { graphql, graphqlContext } from './graphql.js';
 
 /*! *****************************************************************************
@@ -190,8 +190,14 @@ const defaultContext = {
  * Composes a given list of functions into a new function that
  * executes from right to left.
  */
-function compose(...funcs) {
-    return funcs.reduce((f, g) => (...args) => f(g(...args)));
+function compose(...fns) {
+    return (...args) => {
+        return fns.reduceRight((leftFn, rightFn) => {
+            return leftFn instanceof Promise
+                ? Promise.resolve(leftFn).then(rightFn)
+                : rightFn(leftFn);
+        }, args[0]);
+    };
 }
 
 class NetworkError extends Error {
@@ -201,17 +207,6 @@ class NetworkError extends Error {
     }
 }
 
-/**
- * Internal response transformer to ensure response JSON body
- * is always stringified.
- */
-const stringifyJsonBody = (res) => {
-    var _a, _b;
-    if (res.body && ((_b = (_a = res.headers) === null || _a === void 0 ? void 0 : _a.get('content-type')) === null || _b === void 0 ? void 0 : _b.endsWith('json'))) {
-        res.body = JSON.stringify(res.body);
-    }
-    return res;
-};
 const defaultResponse = {
     status: 200,
     statusText: 'OK',
@@ -219,11 +214,9 @@ const defaultResponse = {
     delay: 0,
     once: false,
 };
-const defaultResponseTransformers = [
-    stringifyJsonBody,
-];
+const defaultResponseTransformers = [];
 function createResponseComposition(responseOverrides, defaultTransformers = defaultResponseTransformers) {
-    return (...transformers) => {
+    return (...transformers) => __awaiter(this, void 0, void 0, function* () {
         const initialResponse = Object.assign({}, defaultResponse, {
             headers: new lib$1.Headers({
                 'x-powered-by': 'msw',
@@ -237,7 +230,7 @@ function createResponseComposition(responseOverrides, defaultTransformers = defa
             ? compose(...resolvedTransformers)(initialResponse)
             : initialResponse;
         return resolvedResponse;
-    };
+    });
 }
 const response = Object.assign(createResponseComposition(), {
     once: createResponseComposition({ once: true }),
@@ -625,6 +618,12 @@ function resetHandlers(initialHandlers, ...nextHandlers) {
 // Declare the list of event handlers on the module's scope
 // so it persists between Fash refreshes of the application's code.
 let listeners = [];
+/**
+ * Creates a new mock Service Worker registration
+ * with the given request handlers.
+ * @param {RequestHandler[]} requestHandlers List of request handlers
+ * @see {@link https://mswjs.io/docs/api/setup-worker `setupWorker`}
+ */
 function setupWorker(...requestHandlers) {
     requestHandlers.forEach((handler) => {
         if (Array.isArray(handler))
@@ -685,7 +684,19 @@ function setupWorker(...requestHandlers) {
         resetHandlers(...nextHandlers) {
             context.requestHandlers = resetHandlers(requestHandlers, ...nextHandlers);
         },
+        printHandlers() {
+            context.requestHandlers.forEach((handler) => {
+                const meta = handler.getMetaInfo();
+                console.groupCollapsed(meta.header);
+                console.log(`Declaration: ${meta.callFrame}`);
+                console.log('Resolver: %s', handler.resolver);
+                if (['rest'].includes(meta.type)) {
+                    console.log('Match:', `https://mswjs.io/repl?path=${meta.mask}`);
+                }
+                console.groupEnd();
+            });
+        },
     };
 }
 
-export { createResponseComposition, defaultContext, defaultResponse, response, setupWorker };
+export { compose, createResponseComposition, defaultContext, defaultResponse, response, setupWorker };

package/lib/esm/rest-deps.js

@@ -1,6 +1,6 @@
 import { c as createCommonjsModule, b as commonjsGlobal, a as set, s as status, j as json, d as delay, f as fetch } from './fetch-deps.js';
 import { c as cookie, b as body, t as text, x as xml } from './xml-deps.js';
-import { g as getUrlByMask, m as matchRequestUrl, a as prepareRequest, b as prepareResponse, c as getTimestamp, d as getStatusCodeColor } from './matchRequestUrl-deps.js';
+import { g as getUrlByMask, a as getCallFrame, m as matchRequestUrl, b as prepareRequest, c as prepareResponse, d as getTimestamp, e as getStatusCodeColor } from './getCallFrame-deps.js';
 
 var punycode = createCommonjsModule(function (module, exports) {
 (function(root) {
@@ -1388,6 +1388,7 @@ const restContext = {
 const createRestHandler = (method) => {
     return (mask, resolver) => {
         const resolvedMask = getUrlByMask(mask);
+        const callFrame = getCallFrame();
         return {
             parse(req) {
                 // Match the request during parsing to prevent matching it twice
@@ -1438,16 +1439,85 @@ ${queryParams
                 console.log('Response', loggedResponse);
                 console.groupEnd();
             },
+            getMetaInfo() {
+                return {
+                    type: 'rest',
+                    header: `[rest] ${method} ${mask.toString()}`,
+                    mask,
+                    callFrame,
+                };
+            },
         };
     };
 };
 const rest = {
+    /**
+     * Captures a HEAD request by a given path.
+     * @example
+     * rest.head('/numbers', (req, res, ctx) => {
+     *   return res(ctx.status(302))
+     * })
+     * @see {@link https://mswjs.io/docs/api/rest `rest`}
+     */
     head: createRestHandler(RESTMethods.HEAD),
+    /**
+     * Captures a GET request by a given path.
+     * @example
+     * rest.get('/numbers', (req, res, ctx) => {
+     *   return res(ctx.json([1, 2, 3]))
+     * })
+     * @see {@link https://mswjs.io/docs/api/rest `rest`}
+     */
     get: createRestHandler(RESTMethods.GET),
+    /**
+     * Captures a POST request by a given path.
+     * @example
+     * rest.post('/numbers', (req, res, ctx) => {
+     *   return res(ctx.text('success'))
+     * })
+     * @see {@link https://mswjs.io/docs/api/rest `rest`}
+     */
     post: createRestHandler(RESTMethods.POST),
+    /**
+     * Captures a PUT request by a given path.
+     * @example
+     * rest.put('/numbers', (req, res, ctx) => {
+     *   const { numbers } = req.body
+     *   return res(ctx.json(numbers))
+     * })
+     * @see {@link https://mswjs.io/docs/api/rest `rest`}
+     */
     put: createRestHandler(RESTMethods.PUT),
+    /**
+     * Captures a DELETE request by a given path.
+     * @example
+     * rest.delete('/numbers', (req, res, ctx) => {
+     *   const index = req.url.searchParams.get('index')
+     *   prevNumbers.splice(index, 1)
+     *   return res(ctx.json(nextNumbers))
+     * })
+     * @see {@link https://mswjs.io/docs/api/rest `rest`}
+     */
     delete: createRestHandler(RESTMethods.DELETE),
+    /**
+     * Captures a PATCH request by a given path.
+     * @example
+     * rest.patch('/numbers', (req, res, ctx) => {
+     *   const { numbers } = req.body
+     *   const nextNumbers = prevNumbers.concat(number)
+     *   return res(ctx.json(nextNumbers))
+     * })
+     * @see {@link https://mswjs.io/docs/api/rest `rest`}
+     */
     patch: createRestHandler(RESTMethods.PATCH),
+    /**
+     * Captures an OPTIONS request by a given path.
+     * @example
+     * rest.options('/numbers', (req, res, ctx) => {
+     *   return res(ctx.set('Allow', 'GET,HEAD,POST'))
+     * })
+     * @see {@link https://mswjs.io/docs/api/rest `rest`}
+     */
     options: createRestHandler(RESTMethods.OPTIONS),
 };
 

package/lib/esm/rest.js

@@ -1,4 +1,4 @@
 import './fetch-deps.js';
 import './xml-deps.js';
 export { R as RESTMethods, r as rest, a as restContext } from './rest-deps.js';
-import './matchRequestUrl-deps.js';
+import './getCallFrame-deps.js';

package/lib/esm/xml-deps.js

@@ -200,9 +200,8 @@ function tryDecode(str, decode) {
 }
 
 /**
- * Sets a given cookie on the response.
- * @example
- * res(cookie('name', 'value'))
+ * Sets a given cookie on the mocked response.
+ * @example res(ctx.cookie('name', 'value'))
  */
 const cookie = (name, value, options) => {
     return (res) => {
@@ -216,9 +215,11 @@ const cookie = (name, value, options) => {
 };
 
 /**
- * Sets the body of the response without any `Content-Type` header.
+ * Sets a raw response body. Does not append any `Content-Type` headers.
  * @example
- * res(body('message'))
+ * res(ctx.body('Successful response'))
+ * res(ctx.body(JSON.stringify({ key: 'value' })))
+ * @see {@link https://mswjs.io/docs/api/context/body `ctx.body()`}
  */
 const body = (value) => {
     return (res) => {
@@ -228,9 +229,10 @@ const body = (value) => {
 };
 
 /**
- * Sets a given text as a "Cotent-Type: text/plain" body of the response.
- * @example
- * res(text('message'))
+ * Sets a textual response body. Appends a `Content-Type: text/plain`
+ * header on the mocked response.
+ * @example res(ctx.text('Successful response'))
+ * @see {@link https://mswjs.io/docs/api/context/text `ctx.text()`}
  */
 const text = (body) => {
     return (res) => {
@@ -241,9 +243,11 @@ const text = (body) => {
 };
 
 /**
- * Sets the given XML as the body of the response.
+ * Sets an XML response body. Appends a `Content-Type: text/xml` header
+ * on the mocked response.
  * @example
- * res(xml('<key>value</key>'))
+ * res(ctx.xml('<node key="value">Content</node>'))
+ * @see {@link https://mswjs.io/docs/api/context/xml `ctx.xml()`}
  */
 const xml = (body) => {
     return (res) => {

package/lib/types/context/body.d.ts

@@ -1,7 +1,9 @@
 import { ResponseTransformer } from '../response';
 /**
- * Sets the body of the response without any `Content-Type` header.
+ * Sets a raw response body. Does not append any `Content-Type` headers.
  * @example
- * res(body('message'))
+ * res(ctx.body('Successful response'))
+ * res(ctx.body(JSON.stringify({ key: 'value' })))
+ * @see {@link https://mswjs.io/docs/api/context/body `ctx.body()`}
  */
 export declare const body: <BodyType extends string | Blob | ArrayBufferView | ArrayBuffer | ReadableStream<any> | FormData>(value: BodyType) => ResponseTransformer<BodyType>;

package/lib/types/context/cookie.d.ts

@@ -1,8 +1,7 @@
 import * as cookieUtils from 'cookie';
 import { ResponseTransformer } from '../response';
 /**
- * Sets a given cookie on the response.
- * @example
- * res(cookie('name', 'value'))
+ * Sets a given cookie on the mocked response.
+ * @example res(ctx.cookie('name', 'value'))
  */
 export declare const cookie: (name: string, value: string, options?: cookieUtils.CookieSerializeOptions | undefined) => ResponseTransformer;

package/lib/types/context/data.d.ts

@@ -1,6 +1,8 @@
 import { ResponseTransformer } from '../response';
-export declare type DataContext<T> = (payload: T) => ResponseTransformer;
 /**
- * Returns a GraphQL body payload.
+ * Sets a given payload as a GraphQL response body.
+ * @example
+ * res(ctx.data({ user: { firstName: 'John' }}))
+ * @see {@link https://mswjs.io/docs/api/context/data `ctx.data()`}
  */
-export declare const data: DataContext<Record<string, any>>;
+export declare const data: <T extends Record<string, any>>(payload: T) => ResponseTransformer;

package/lib/types/context/delay.d.ts

@@ -3,9 +3,10 @@ export declare const MIN_SERVER_RESPONSE_TIME = 100;
 export declare const MAX_SERVER_RESPONSE_TIME = 400;
 export declare const NODE_SERVER_RESPONSE_TIME = 5;
 /**
- * Delays the current response for the given duration (in ms)
+ * Delays the response by the given duration (ms).
  * @example
- * res(delay()) // realistic server response time
- * res(delay(1500)) // explicit response delay duration
+ * res(ctx.delay()) // realistic server response time
+ * res(ctx.delay(1200))
+ * @see {@link https://mswjs.io/docs/api/context/delay `ctx.delay()`}
  */
 export declare const delay: (durationMs?: number | undefined) => ResponseTransformer;

package/lib/types/context/errors.d.ts

@@ -2,7 +2,7 @@ import { GraphQLError } from 'graphql';
 import { ResponseTransformer } from '../response';
 /**
  * Sets a given list of GraphQL errors on the mocked response.
+ * @example res(ctx.errors([{ message: 'Unauthorized' }]))
+ * @see {@link https://mswjs.io/docs/api/context/errors}
  */
-export declare const errors: <ErrorsType extends Partial<GraphQLError>[] | null | undefined>(errorsList: ErrorsType) => ResponseTransformer<{
-    errors: ErrorsType;
-}>;
+export declare const errors: <ErrorsType extends Partial<GraphQLError>[] | null | undefined>(errorsList: ErrorsType) => ResponseTransformer<string>;

package/lib/types/context/fetch.d.ts

@@ -1,8 +1,9 @@
 import { MockedRequest } from '../utils/handlers/requestHandler';
 export declare const augmentRequestInit: (requestInit: RequestInit) => RequestInit;
 /**
- * Wrapper around the native `window.fetch()` function that performs
- * a request bypassing MSW. Requests performed using
- * this function will never be mocked.
+ * Performs a bypassed request inside a request handler.
+ * @example
+ * const originalResponse = await ctx.fetch(req)
+ * @see {@link https://mswjs.io/docs/api/context/fetch `ctx.fetch()`}
  */
 export declare const fetch: (input: string | MockedRequest, requestInit?: RequestInit) => any;