Schema-driven testing utilities

.api-reports/api-report-testing.md

@@ -11,6 +11,7 @@ import type { FieldNode } from 'graphql';
 import type { FragmentDefinitionNode } from 'graphql';
 import type { GraphQLError } from 'graphql';
 import type { GraphQLErrorExtensions } from 'graphql';
+import type { GraphQLSchema } from 'graphql';
 import { Observable } from 'zen-observable-ts';
 import type { Observer } from 'zen-observable-ts';
 import * as React_2 from 'react';
@@ -446,6 +447,16 @@ type ConcastSourcesIterable<T> = Iterable<Source<T>>;
 // @public (undocumented)
 export function createMockClient<TData>(data: TData, query: DocumentNode, variables?: {}): ApolloClient<NormalizedCacheObject>;
 
+// @public (undocumented)
+export const createMockFetch: (schema: any, mockFetchOpts?: {
+    validate: boolean;
+}) => (uri: any, options: any) => Promise<Response>;
+
+// @public (undocumented)
+export const createMockSchema: (staticSchema: GraphQLSchema, mocks: {
+    [key: string]: any;
+}) => GraphQLSchema;
+
 // @public (undocumented)
 namespace DataProxy {
     // (undocumented)
@@ -1265,6 +1276,23 @@ type Path = ReadonlyArray<string | number>;
 // @public (undocumented)
 type Primitive = null | undefined | string | number | boolean | symbol | bigint;
 
+// Warning: (ae-forgotten-export) The symbol "ProxiedSchemaFns" needs to be exported by the entry point index.d.ts
+//
+// @public (undocumented)
+export const proxiedSchema: (schemaWithMocks: GraphQLSchema, resolvers: Resolvers) => GraphQLSchema & ProxiedSchemaFns;
+
+// @public (undocumented)
+interface ProxiedSchemaFns {
+    // (undocumented)
+    addResolvers: (newResolvers: Resolvers) => GraphQLSchema;
+    // (undocumented)
+    fork: () => GraphQLSchema;
+    // (undocumented)
+    forkWithResolvers: (newResolvers: Resolvers) => GraphQLSchema;
+    // (undocumented)
+    reset: () => void;
+}
+
 // @public (undocumented)
 class QueryInfo {
     constructor(queryManager: QueryManager<any>, queryId?: string);

.api-reports/api-report-testing_core.md

@@ -11,6 +11,7 @@ import type { FieldNode } from 'graphql';
 import type { FragmentDefinitionNode } from 'graphql';
 import type { GraphQLError } from 'graphql';
 import type { GraphQLErrorExtensions } from 'graphql';
+import type { GraphQLSchema } from 'graphql';
 import { Observable } from 'zen-observable-ts';
 import type { Observer } from 'zen-observable-ts';
 import type { Subscriber } from 'zen-observable-ts';
@@ -445,6 +446,11 @@ type ConcastSourcesIterable<T> = Iterable<Source<T>>;
 // @public (undocumented)
 export function createMockClient<TData>(data: TData, query: DocumentNode, variables?: {}): ApolloClient<NormalizedCacheObject>;
 
+// @public (undocumented)
+export const createMockFetch: (schema: any, mockFetchOpts?: {
+    validate: boolean;
+}) => (uri: any, options: any) => Promise<Response>;
+
 // @public (undocumented)
 namespace DataProxy {
     // (undocumented)
@@ -1220,6 +1226,23 @@ type Path = ReadonlyArray<string | number>;
 // @public (undocumented)
 type Primitive = null | undefined | string | number | boolean | symbol | bigint;
 
+// Warning: (ae-forgotten-export) The symbol "ProxiedSchemaFns" needs to be exported by the entry point index.d.ts
+//
+// @public (undocumented)
+export const proxiedSchema: (schemaWithMocks: GraphQLSchema, resolvers: Resolvers) => GraphQLSchema & ProxiedSchemaFns;
+
+// @public (undocumented)
+interface ProxiedSchemaFns {
+    // (undocumented)
+    addResolvers: (newResolvers: Resolvers) => GraphQLSchema;
+    // (undocumented)
+    fork: () => GraphQLSchema;
+    // (undocumented)
+    forkWithResolvers: (newResolvers: Resolvers) => GraphQLSchema;
+    // (undocumented)
+    reset: () => void;
+}
+
 // @public (undocumented)
 class QueryInfo {
     constructor(queryManager: QueryManager<any>, queryId?: string);

.changeset/stupid-bears-cheat.md

@@ -0,0 +1,5 @@
+---
+"@apollo/client": minor
+---
+
+Adds proxiedSchema and createMockSchema testing utilities

.vscode/launch.json

@@ -1,25 +1,22 @@
 {
   "version": "0.2.0",
   "configurations": [
-    {
-      "name": "Attach to Node.js inspector",
-      "port": 9229,
-      "request": "attach",
-      "skipFiles": ["<node_internals>/**"],
-      "type": "pwa-node"
-    },
     {
       "type": "node",
       "request": "launch",
-      "name": "Jest Current File",
-      "program": "${workspaceFolder}/node_modules/.bin/jest",
-      "args": ["${relativeFile}", "--config", "./config/jest.config.js"],
+      "name": "Jest Attach Node Inspector for Current File",
+      "cwd": "${workspaceFolder}",
+      "runtimeArgs": [
+        "--inspect-brk",
+        "${workspaceRoot}/node_modules/.bin/jest",
+        "${relativeFile}",
+        "--config",
+        "./config/jest.config.js",
+        "--runInBand",
+        "--watch"
+      ],
       "console": "integratedTerminal",
-      "internalConsoleOptions": "neverOpen",
-      "disableOptimisticBPs": true,
-      "windows": {
-        "program": "${workspaceFolder}/node_modules/jest/bin/jest"
-      }
+      "internalConsoleOptions": "neverOpen"
     }
   ]
 }

config/jest.config.js

@@ -33,6 +33,7 @@ const react17TestFileIgnoreList = [
   ignoreTSFiles,
   // We only support Suspense with React 18, so don't test suspense hooks with
   // React 17
+  "src/testing/core/__tests__/schemaProxy.test.tsx",
   "src/react/hooks/__tests__/useSuspenseQuery.test.tsx",
   "src/react/hooks/__tests__/useBackgroundQuery.test.tsx",
   "src/react/hooks/__tests__/useLoadableQuery.test.tsx",

package.json

@@ -112,6 +112,7 @@
     "@changesets/changelog-github": "0.5.0",
     "@changesets/cli": "2.27.1",
     "@graphql-tools/schema": "10.0.3",
+    "@graphql-tools/utils": "10.0.13",
     "@microsoft/api-extractor": "7.42.3",
     "@rollup/plugin-node-resolve": "11.2.1",
     "@size-limit/esbuild-why": "11.1.1",

src/__tests__/__snapshots__/exports.ts.snap

@@ -369,9 +369,12 @@ Array [
   "MockSubscriptionLink",
   "MockedProvider",
   "createMockClient",
+  "createMockFetch",
+  "createMockSchema",
   "itAsync",
   "mockObservableLink",
   "mockSingleLink",
+  "proxiedSchema",
   "subscribeAndCount",
   "tick",
   "wait",
@@ -386,9 +389,11 @@ Array [
   "MockLink",
   "MockSubscriptionLink",
   "createMockClient",
+  "createMockFetch",
   "itAsync",
   "mockObservableLink",
   "mockSingleLink",
+  "proxiedSchema",
   "subscribeAndCount",
   "tick",
   "wait",