no mocking

Author: enisdenjo

packages/web/docs/src/content/gateway/other-features/testing/mocking.mdx

@@ -9,12 +9,21 @@ import { Callout } from '@theguild/components'
 Mocking your GraphQL API is a common practice when developing and testing your application. It
 allows you to simulate the behavior of your API without making real network requests.
 
+## Installing
+
+Start by installing the `@graphql-mesh/plugin-mock` package:
+
+```sh npm2yarn
+npm i @graphql-mesh/plugin-mock
+```
+
 ## How to use?
 
 Add it to your plugins:
 
 ```ts filename="gateway.config.ts"
-import { defineConfig, useMock } from '@graphql-hive/gateway'
+import { defineConfig } from '@graphql-hive/gateway'
+import { useMock } from '@graphql-mesh/plugin-mock'
 
 export const gatewayConfig = defineConfig({
   plugins: [
@@ -38,7 +47,8 @@ The example above will replace the resolver of `User.firstName` with a mock that
 You can also provide a custom function to generate the mock value for a field:
 
 ```ts filename="gateway.config.ts"
-import { defineConfig, useMock } from '@graphql-hive/gateway'
+import { defineConfig } from '@graphql-hive/gateway'
+import { useMock } from '@graphql-mesh/plugin-mock'
 import { fullName } from './user-mocks.js'
 
 export const gatewayConfig = defineConfig({
@@ -60,7 +70,8 @@ export const gatewayConfig = defineConfig({
 You can mock types with custom mock functions like below;
 
 ```ts filename="gateway.config.ts"
-import { defineConfig, useMock } from '@graphql-hive/gateway'
+import { defineConfig } from '@graphql-hive/gateway'
+import { useMock } from '@graphql-mesh/plugin-mock'
 import { user } from './user-mocks.js'
 
 export const gatewayConfig = defineConfig({
@@ -116,7 +127,8 @@ type User {
 ```
 
 ```ts filename="gateway.config.ts"
-import { defineConfig, useMock } from '@graphql-hive/gateway'
+import { defineConfig } from '@graphql-hive/gateway'
+import { useMock } from '@graphql-mesh/plugin-mock'
 
 export const gatewayConfig = defineConfig({
   plugins: pluginCtx => [
@@ -160,7 +172,7 @@ using the store provided in the context `context.mockStore`;
 When having a schema that returns a list, in this case, a list of users:
 
 ```ts filename="init-store.ts"
-import { MockStore } from '@graphql-hive/gateway'
+import { MockStore } from '@graphql-mesh/plugin-mock'
 
 export const store = new MockStore()
 const users = [{ id: 'uuid', name: 'John Snow' }]
@@ -184,7 +196,8 @@ type Query {
 ```
 
 ```ts filename="gateway.config.ts"
-import { defineConfig, useMock } from '@graphql-hive/gateway'
+import { defineConfig } from '@graphql-hive/gateway'
+import { useMock } from '@graphql-mesh/plugin-mock'
 import { store } from './init-store.js'
 
 export const gatewayConfig = defineConfig({
@@ -219,7 +232,8 @@ type Mutation {
 ```
 
 ```ts filename="gateway.config.ts"
-import { defineConfig, useMock } from '@graphql-hive/gateway'
+import { defineConfig } from '@graphql-hive/gateway'
+import { useMock } from '@graphql-mesh/plugin-mock'
 import { store } from './init-store.js'
 
 export const gatewayConfig = defineConfig({

packages/web/docs/src/content/migration-guides/gateway-v1-v2.mdx

@@ -9,7 +9,8 @@ instructions to ensure a smooth transition.
 v2 includes several breaking changes and improvements over v1. The most significant changes are:
 
 - [Drop Support for Node v18](#drop-support-for-node-v18)
-- [Multipart Requests are Disabled by Default](#drop-support-for-node-v18)
+- [Multipart Requests are Disabled by Default](#multipart-requests-are-disabled-by-default)
+- [Remove Mocking Plugin from built-ins](#remove-mocking-plugin-from-built-ins)
 - [Disabled Automatic Forking](#disabled-automatic-forking)
 - [New Hive Logger for next-level observability and debugging](#hive-logger)
 
@@ -65,6 +66,44 @@ export const gatewayConfig = defineConfig({
 });
 ```
 
+# Remove Mocking Plugin from built-ins
+
+There is no need to provide the `useMock` plugin alongside Hive Gateway built-ins. Not only is the
+mock plugin 2MB in size (minified), but installing and using it is very simple.
+
+Migrating is very simple, start by installing the `@graphql-mesh/plugin-mock` package:
+
+```sh npm2yarn
+npm i @graphql-mesh/plugin-mock
+```
+
+and then use it in your Hive Gateway configuration:
+
+```diff filename="gateway.config.ts"
+import {
+  defineConfig,
+- useMock
+} from '@graphql-hive/gateway';
++ import { useMock } from '@graphql-mesh/plugin-mock'
+
+export const gatewayConfig = defineConfig({
+  plugins: [
+    useMock({
+      mocks: [
+        {
+          apply: 'User.firstName',
+          faker: '{{name.firstName}}'
+        }
+      ]
+    })
+  ]
+})
+```
+
+<Callout type="info">
+  You can read more about the mocking plugin in the [Mocking documentation](/docs/gateway/mocking).
+</Callout>
+
 ## Disabled Automatic Forking
 
 We were previously forking workers automatically in v1 when detecting `NODE_ENV=production`;