feat(useErrorHandler): handle incremental execution errors

.changeset/breezy-feet-greet.md

@@ -0,0 +1,5 @@
+---
+'@envelop/core': minor
+---
+
+Handle incremental execution errors in useErrorHandler

packages/core/package.json

@@ -63,8 +63,9 @@
   },
   "devDependencies": {
     "@graphql-tools/schema": "10.0.25",
-    "@graphql-tools/utils": "10.9.1",
     "@repeaterjs/repeater": "3.0.6",
+    "@graphql-tools/executor": "^1.1.0",
+    "@graphql-tools/utils": "10.0.11",
     "graphql": "16.8.1",
     "typescript": "5.9.2"
   },
@@ -79,4 +80,4 @@
   "typescript": {
     "definition": "dist/typings/index.d.ts"
   }
-}
+}

packages/core/src/plugins/use-error-handler.ts

@@ -1,4 +1,10 @@
-import { DefaultContext, ExecutionResult, Plugin, TypedExecutionArgs } from '@envelop/types';
+import {
+  DefaultContext,
+  ExecutionResult,
+  IncrementalExecutionResult,
+  Plugin,
+  TypedExecutionArgs,
+} from '@envelop/types';
 import { handleStreamOrSingleExecutionResult } from '../utils.js';
 import { isGraphQLError, SerializableGraphQLErrorLike } from './use-masked-errors.js';
 
@@ -13,15 +19,24 @@ export type ErrorHandler = ({
 }) => void;
 
 type ErrorHandlerCallback<ContextType> = {
-  result: ExecutionResult;
+  result: ExecutionResult | IncrementalExecutionResult;
   args: TypedExecutionArgs<ContextType>;
 };
 
 const makeHandleResult =
   <ContextType extends Record<any, any>>(errorHandler: ErrorHandler) =>
   ({ result, args }: ErrorHandlerCallback<ContextType>) => {
-    if (result.errors?.length) {
-      errorHandler({ errors: result.errors, context: args, phase: 'execution' });
+    const errors = result.errors ? [...result.errors] : [];
+    if ('incremental' in result && result.incremental) {
+      for (const increment of result.incremental) {
+        if (increment.errors) {
+          errors.push(...increment.errors);
+        }
+      }
+    }
+
+    if (errors.length) {
+      errorHandler({ errors, context: args, phase: 'execution' });
     }
   };
 

packages/core/test/plugins/use-error-handler.spec.ts

@@ -1,10 +1,12 @@
-import { useExtendContext } from '@envelop/core';
+import * as GraphQLJS from 'graphql';
+import { useEngine, useExtendContext } from '@envelop/core';
 import {
   assertStreamExecutionValue,
   collectAsyncIteratorValues,
   createTestkit,
 } from '@envelop/testing';
 import { Plugin } from '@envelop/types';
+import { normalizedExecutor } from '@graphql-tools/executor';
 import { makeExecutableSchema } from '@graphql-tools/schema';
 import { createGraphQLError } from '@graphql-tools/utils';
 import { Repeater } from '@repeaterjs/repeater';
@@ -139,4 +141,37 @@ describe('useErrorHandler', () => {
       }),
     );
   });
+
+  it('should invoke error handler when error happens during incremental execution', async () => {
+    const schema = makeExecutableSchema({
+      typeDefs: /* GraphQL */ `
+        directive @defer on FRAGMENT_SPREAD | INLINE_FRAGMENT
+
+        type Query {
+          foo: String
+        }
+      `,
+      resolvers: {
+        Query: {
+          foo: () => {
+            throw new Error('kaboom');
+          },
+        },
+      },
+    });
+
+    const mockHandler = jest.fn();
+    const testInstance = createTestkit(
+      [
+        useEngine({ ...GraphQLJS, execute: normalizedExecutor, subscribe: normalizedExecutor }),
+        useErrorHandler(mockHandler),
+      ],
+      schema,
+    );
+    const result = await testInstance.execute(`query { ... @defer { foo } }`);
+    assertStreamExecutionValue(result);
+    await collectAsyncIteratorValues(result);
+
+    expect(mockHandler).toHaveBeenCalledWith(expect.objectContaining({ phase: 'execution' }));
+  });
 });