@graphitation/supermassive 3.17.2-canary.1 → 3.18.0

package/CHANGELOG.md

@@ -1,9 +1,25 @@
 # Change Log - @graphitation/supermassive
 
-<!-- This log was last generated on Wed, 15 Apr 2026 15:45:05 GMT and should not be manually modified. -->
+<!-- This log was last generated on Thu, 16 Jul 2026 09:12:12 GMT and should not be manually modified. -->
 
 <!-- Start content -->
 
+## 3.18.0
+
+Thu, 16 Jul 2026 09:12:12 GMT
+
+### Minor changes
+
+- early execution and merge (pavelglac@microsoft.com)
+
+## 3.17.1
+
+Tue, 14 Jul 2026 09:11:43 GMT
+
+### Patches
+
+- yarn upgrade (pavelglac@gmail.com)
+
 ## 3.17.0
 
 Wed, 15 Apr 2026 15:45:05 GMT

package/README.md

@@ -63,6 +63,31 @@ However, APIs and response format _will_ change, expect breaking changes.
 > Note: see [this discussion](https://github.com/graphql/defer-stream-wg) of the new response format in the
 > defer and stream working group
 
+#### Incremental delivery flags
+
+The following optional execution arguments tune how deferred/streamed payloads are executed and delivered.
+
+- **`enableEarlyExecution`** (`boolean`, default `false`) — When enabled, deferred fragments (`@defer`
+  patches) start executing immediately alongside the main selection set, instead of only after the initial
+  result has been resolved. This can reduce the overall latency of incremental payloads at the cost of doing
+  more work up front.
+
+- **`enableDeferredMerge`** (`boolean`, default `false`) — When enabled, deferred fragments that have already
+  completed by the time the response is built are merged directly into their parent result instead of being
+  emitted as separate incremental payloads. This reduces the number of payloads a client has to process and
+  re-normalize.
+
+- **`incrementalPayloadBatchingTimeoutMs`** (`number`, optional) — Sets a time window (in milliseconds) used to
+  batch incremental payloads together before they are delivered:
+  - In combination with `enableDeferredMerge`, execution waits up to this many milliseconds for pending
+    deferred fragments so they can be merged into the initial result rather than streamed separately.
+  - For the subsequent payload stream, multiple incremental results that complete within the window are
+    grouped into a single delivery.
+
+  A value of `0` (or a non-finite value) disables the wait. Note that the merge-into-initial-result behavior
+  requires `enableDeferredMerge`; without it the timeout only affects batching of the subsequent payload
+  stream.
+
 ### Possible future - pre-normalized executor
 
 In a scenario where executor is running close to the client (sometimes even in same process or at least in same browser), it might be worth exploring removing some of the requirements imposed by the usual GraphQL transport - for example serialization. Not only GraphQL executors do the JSON serialization, but also they return the data that is optimized for transport and that matches the query tree. This means clients need to perform often expensive normazilation. As traffic and message size might be less important in same process / same browser scenarios, it might be worthwhile exploring return pre-normalized data from supermassive. This offers massive speedups for some clients like Apollo ([see benchmarks](https://github.com/vladar/graphql-normalized)).

package/lib/executeWithSchema.d.ts

@@ -1,4 +1,4 @@
 import { PromiseOrValue } from "./jsutils/PromiseOrValue";
 import { ExecutionResult, ExecutionWithSchemaArgs } from "./types";
-export declare function executeWithSchema({ document, definitions, resolvers, rootValue, contextValue, variableValues, operationName, fieldResolver, typeResolver, fieldExecutionHooks, enablePerEventContext, }: ExecutionWithSchemaArgs): PromiseOrValue<ExecutionResult>;
+export declare function executeWithSchema({ document, definitions, resolvers, rootValue, contextValue, variableValues, operationName, fieldResolver, typeResolver, fieldExecutionHooks, enablePerEventContext, enableEarlyExecution, enableDeferredMerge, incrementalPayloadBatchingTimeoutMs, }: ExecutionWithSchemaArgs): PromiseOrValue<ExecutionResult>;
 //# sourceMappingURL=executeWithSchema.d.ts.map

package/lib/executeWithSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executeWithSchema.d.ts","sourceRoot":"","sources":["../src/executeWithSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGnE,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,GACtB,EAAE,uBAAuB,GAAG,cAAc,CAAC,eAAe,CAAC,CAqB3D"}
+{"version":3,"file":"executeWithSchema.d.ts","sourceRoot":"","sources":["../src/executeWithSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGnE,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,mCAAmC,GACpC,EAAE,uBAAuB,GAAG,cAAc,CAAC,eAAe,CAAC,CAwB3D"}

package/lib/executeWithSchema.js

@@ -35,7 +35,10 @@ function executeWithSchema({
   fieldResolver,
   typeResolver,
   fieldExecutionHooks,
-  enablePerEventContext
+  enablePerEventContext,
+  enableEarlyExecution,
+  enableDeferredMerge,
+  incrementalPayloadBatchingTimeoutMs
 }) {
   const extracted = (0, import_extractMinimalViableSchemaForRequestDocument.extractMinimalViableSchemaForRequestDocument)(
     (0, import_graphql.buildASTSchema)(definitions),
@@ -55,6 +58,9 @@ function executeWithSchema({
     fieldResolver,
     typeResolver,
     fieldExecutionHooks,
-    enablePerEventContext
+    enablePerEventContext,
+    enableEarlyExecution,
+    enableDeferredMerge,
+    incrementalPayloadBatchingTimeoutMs
   });
 }

package/lib/executeWithSchema.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/executeWithSchema.ts"],
-  "sourcesContent": ["import { buildASTSchema } from \"graphql\";\nimport { executeWithoutSchema } from \"./index\";\nimport { PromiseOrValue } from \"./jsutils/PromiseOrValue\";\nimport { ExecutionResult, ExecutionWithSchemaArgs } from \"./types\";\nimport { extractMinimalViableSchemaForRequestDocument } from \"./utilities/extractMinimalViableSchemaForRequestDocument\";\n\nexport function executeWithSchema({\n  document,\n  definitions,\n  resolvers,\n  rootValue,\n  contextValue,\n  variableValues,\n  operationName,\n  fieldResolver,\n  typeResolver,\n  fieldExecutionHooks,\n  enablePerEventContext,\n}: ExecutionWithSchemaArgs): PromiseOrValue<ExecutionResult> {\n  const extracted = extractMinimalViableSchemaForRequestDocument(\n    buildASTSchema(definitions),\n    document,\n  );\n  return executeWithoutSchema({\n    document,\n    schemaFragment: {\n      schemaId: \"executeWithSchema\",\n      definitions: extracted.definitions,\n      resolvers,\n    },\n    rootValue,\n    contextValue,\n    variableValues,\n    operationName,\n    fieldResolver,\n    typeResolver,\n    fieldExecutionHooks,\n    enablePerEventContext,\n  });\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA+B;AAC/B,mBAAqC;AAGrC,0DAA6D;AAEtD,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6D;AAC3D,QAAM,gBAAY;AAAA,QAChB,+BAAe,WAAW;AAAA,IAC1B;AAAA,EACF;AACA,aAAO,mCAAqB;AAAA,IAC1B;AAAA,IACA,gBAAgB;AAAA,MACd,UAAU;AAAA,MACV,aAAa,UAAU;AAAA,MACvB;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;",
+  "sourcesContent": ["import { buildASTSchema } from \"graphql\";\nimport { executeWithoutSchema } from \"./index\";\nimport { PromiseOrValue } from \"./jsutils/PromiseOrValue\";\nimport { ExecutionResult, ExecutionWithSchemaArgs } from \"./types\";\nimport { extractMinimalViableSchemaForRequestDocument } from \"./utilities/extractMinimalViableSchemaForRequestDocument\";\n\nexport function executeWithSchema({\n  document,\n  definitions,\n  resolvers,\n  rootValue,\n  contextValue,\n  variableValues,\n  operationName,\n  fieldResolver,\n  typeResolver,\n  fieldExecutionHooks,\n  enablePerEventContext,\n  enableEarlyExecution,\n  enableDeferredMerge,\n  incrementalPayloadBatchingTimeoutMs,\n}: ExecutionWithSchemaArgs): PromiseOrValue<ExecutionResult> {\n  const extracted = extractMinimalViableSchemaForRequestDocument(\n    buildASTSchema(definitions),\n    document,\n  );\n  return executeWithoutSchema({\n    document,\n    schemaFragment: {\n      schemaId: \"executeWithSchema\",\n      definitions: extracted.definitions,\n      resolvers,\n    },\n    rootValue,\n    contextValue,\n    variableValues,\n    operationName,\n    fieldResolver,\n    typeResolver,\n    fieldExecutionHooks,\n    enablePerEventContext,\n    enableEarlyExecution,\n    enableDeferredMerge,\n    incrementalPayloadBatchingTimeoutMs,\n  });\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,qBAA+B;AAC/B,mBAAqC;AAGrC,0DAA6D;AAEtD,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6D;AAC3D,QAAM,gBAAY;AAAA,QAChB,+BAAe,WAAW;AAAA,IAC1B;AAAA,EACF;AACA,aAAO,mCAAqB;AAAA,IAC1B;AAAA,IACA,gBAAgB;AAAA,MACd,UAAU;AAAA,MACV,aAAa,UAAU;AAAA,MACvB;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;",
   "names": []
 }

package/lib/executeWithSchema.mjs

@@ -13,7 +13,10 @@ function executeWithSchema({
   fieldResolver,
   typeResolver,
   fieldExecutionHooks,
-  enablePerEventContext
+  enablePerEventContext,
+  enableEarlyExecution,
+  enableDeferredMerge,
+  incrementalPayloadBatchingTimeoutMs
 }) {
   const extracted = extractMinimalViableSchemaForRequestDocument(
     buildASTSchema(definitions),
@@ -33,7 +36,10 @@ function executeWithSchema({
     fieldResolver,
     typeResolver,
     fieldExecutionHooks,
-    enablePerEventContext
+    enablePerEventContext,
+    enableEarlyExecution,
+    enableDeferredMerge,
+    incrementalPayloadBatchingTimeoutMs
   });
 }
 export {

package/lib/executeWithSchema.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/executeWithSchema.ts"],
-  "sourcesContent": ["import { buildASTSchema } from \"graphql\";\nimport { executeWithoutSchema } from \"./index\";\nimport { PromiseOrValue } from \"./jsutils/PromiseOrValue\";\nimport { ExecutionResult, ExecutionWithSchemaArgs } from \"./types\";\nimport { extractMinimalViableSchemaForRequestDocument } from \"./utilities/extractMinimalViableSchemaForRequestDocument\";\n\nexport function executeWithSchema({\n  document,\n  definitions,\n  resolvers,\n  rootValue,\n  contextValue,\n  variableValues,\n  operationName,\n  fieldResolver,\n  typeResolver,\n  fieldExecutionHooks,\n  enablePerEventContext,\n}: ExecutionWithSchemaArgs): PromiseOrValue<ExecutionResult> {\n  const extracted = extractMinimalViableSchemaForRequestDocument(\n    buildASTSchema(definitions),\n    document,\n  );\n  return executeWithoutSchema({\n    document,\n    schemaFragment: {\n      schemaId: \"executeWithSchema\",\n      definitions: extracted.definitions,\n      resolvers,\n    },\n    rootValue,\n    contextValue,\n    variableValues,\n    operationName,\n    fieldResolver,\n    typeResolver,\n    fieldExecutionHooks,\n    enablePerEventContext,\n  });\n}\n"],
-  "mappings": ";AAAA,SAAS,sBAAsB;AAC/B,SAAS,4BAA4B;AAGrC,SAAS,oDAAoD;AAEtD,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6D;AAC3D,QAAM,YAAY;AAAA,IAChB,eAAe,WAAW;AAAA,IAC1B;AAAA,EACF;AACA,SAAO,qBAAqB;AAAA,IAC1B;AAAA,IACA,gBAAgB;AAAA,MACd,UAAU;AAAA,MACV,aAAa,UAAU;AAAA,MACvB;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;",
+  "sourcesContent": ["import { buildASTSchema } from \"graphql\";\nimport { executeWithoutSchema } from \"./index\";\nimport { PromiseOrValue } from \"./jsutils/PromiseOrValue\";\nimport { ExecutionResult, ExecutionWithSchemaArgs } from \"./types\";\nimport { extractMinimalViableSchemaForRequestDocument } from \"./utilities/extractMinimalViableSchemaForRequestDocument\";\n\nexport function executeWithSchema({\n  document,\n  definitions,\n  resolvers,\n  rootValue,\n  contextValue,\n  variableValues,\n  operationName,\n  fieldResolver,\n  typeResolver,\n  fieldExecutionHooks,\n  enablePerEventContext,\n  enableEarlyExecution,\n  enableDeferredMerge,\n  incrementalPayloadBatchingTimeoutMs,\n}: ExecutionWithSchemaArgs): PromiseOrValue<ExecutionResult> {\n  const extracted = extractMinimalViableSchemaForRequestDocument(\n    buildASTSchema(definitions),\n    document,\n  );\n  return executeWithoutSchema({\n    document,\n    schemaFragment: {\n      schemaId: \"executeWithSchema\",\n      definitions: extracted.definitions,\n      resolvers,\n    },\n    rootValue,\n    contextValue,\n    variableValues,\n    operationName,\n    fieldResolver,\n    typeResolver,\n    fieldExecutionHooks,\n    enablePerEventContext,\n    enableEarlyExecution,\n    enableDeferredMerge,\n    incrementalPayloadBatchingTimeoutMs,\n  });\n}\n"],
+  "mappings": ";AAAA,SAAS,sBAAsB;AAC/B,SAAS,4BAA4B;AAGrC,SAAS,oDAAoD;AAEtD,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAA6D;AAC3D,QAAM,YAAY;AAAA,IAChB,eAAe,WAAW;AAAA,IAC1B;AAAA,EACF;AACA,SAAO,qBAAqB;AAAA,IAC1B;AAAA,IACA,gBAAgB;AAAA,MACd,UAAU;AAAA,MACV,aAAa,UAAU;AAAA,MACvB;AAAA,IACF;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,CAAC;AACH;",
   "names": []
 }

package/lib/executeWithoutSchema.d.ts

@@ -49,6 +49,9 @@ export interface ExecutionContext {
     fieldExecutionHooks?: ExecutionHooks;
     subsequentPayloads: Set<IncrementalDataRecord>;
     enablePerEventContext: boolean;
+    enableEarlyExecution: boolean;
+    enableDeferredMerge: boolean;
+    incrementalPayloadBatchingTimeoutMs?: number;
 }
 /**
  * Implements the "Executing requests" section of the GraphQL specification.
@@ -111,6 +114,7 @@ declare class DeferredFragmentRecord {
         parentContext: IncrementalDataRecord | undefined;
         exeContext: ExecutionContext;
     });
+    private complete;
     addData(data: PromiseOrValue<ObjMap<unknown> | null>): void;
 }
 declare class StreamItemsRecord {

package/lib/executeWithoutSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"executeWithoutSchema.d.ts","sourceRoot":"","sources":["../src/executeWithoutSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"executeWithoutSchema.d.ts","sourceRoot":"","sources":["../src/executeWithoutSchema.ts"],"names":[],"mappings":"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"}

package/lib/executeWithoutSchema.js

@@ -41,6 +41,7 @@ module.exports = __toCommonJS(executeWithoutSchema_exports);
 var import_graphql = require("graphql");
 var import_collectFields = require("./collectFields");
 var import_devAssert = require("./jsutils/devAssert");
+var import_getObjectAtPath = require("./jsutils/getObjectAtPath");
 var import_inspect = require("./jsutils/inspect");
 var import_invariant = require("./jsutils/invariant");
 var import_isIterableObject = require("./jsutils/isIterableObject");
@@ -91,7 +92,10 @@ function buildExecutionContext(args) {
     typeResolver,
     subscribeFieldResolver,
     fieldExecutionHooks,
-    enablePerEventContext
+    enablePerEventContext,
+    enableEarlyExecution,
+    enableDeferredMerge,
+    incrementalPayloadBatchingTimeoutMs
   } = args;
   assertValidExecutionArguments(document, variableValues);
   let operation;
@@ -149,7 +153,10 @@ function buildExecutionContext(args) {
     errors: [],
     fieldExecutionHooks,
     subsequentPayloads: /* @__PURE__ */ new Set(),
-    enablePerEventContext: enablePerEventContext != null ? enablePerEventContext : true
+    enablePerEventContext: enablePerEventContext != null ? enablePerEventContext : true,
+    enableEarlyExecution: enableEarlyExecution != null ? enableEarlyExecution : false,
+    enableDeferredMerge: enableDeferredMerge != null ? enableDeferredMerge : false,
+    incrementalPayloadBatchingTimeoutMs
   };
 }
 function buildPerEventExecutionContext(exeContext, payload) {
@@ -198,7 +205,8 @@ function executeOperation(exeContext) {
           rootValue,
           path,
           groupedFieldSet,
-          void 0
+          void 0,
+          exeContext.enableEarlyExecution ? patches : void 0
         );
         result = buildResponse(exeContext, result);
         break;
@@ -208,7 +216,8 @@ function executeOperation(exeContext) {
           rootTypeName,
           rootValue,
           path,
-          groupedFieldSet
+          groupedFieldSet,
+          exeContext.enableEarlyExecution ? patches : void 0
         );
         result = buildResponse(exeContext, result);
         break;
@@ -229,16 +238,18 @@ function executeOperation(exeContext) {
           `Operation "${operation.operation}" is not a part of GraphQL spec`
         );
     }
-    for (const patch of patches) {
-      const { label, groupedFieldSet: patchGroupedFieldSet } = patch;
-      executeDeferredFragment(
-        exeContext,
-        rootTypeName,
-        rootValue,
-        patchGroupedFieldSet,
-        label,
-        path
-      );
+    if (!exeContext.enableEarlyExecution) {
+      for (const patch of patches) {
+        const { label, groupedFieldSet: patchGroupedFieldSet } = patch;
+        executeDeferredFragment(
+          exeContext,
+          rootTypeName,
+          rootValue,
+          patchGroupedFieldSet,
+          label,
+          path
+        );
+      }
     }
     return result;
   } catch (error) {
@@ -246,7 +257,7 @@ function executeOperation(exeContext) {
     return buildResponse(exeContext, null);
   }
 }
-function buildResponse(exeContext, data) {
+function buildResponse(exeContext, data, deferredMergeAwaited = false) {
   var _a, _b;
   if ((0, import_isPromise.isPromise)(data)) {
     return data.then(
@@ -259,6 +270,16 @@ function buildResponse(exeContext, data) {
   }
   const hooks = exeContext.fieldExecutionHooks;
   try {
+    if (exeContext.enableDeferredMerge && data !== null) {
+      const pendingDeferredFragments = includeCompletedDeferredFragmentsInResult(exeContext, data);
+      const batchTimeout = exeContext.incrementalPayloadBatchingTimeoutMs;
+      if (typeof batchTimeout === "number" && !deferredMergeAwaited && pendingDeferredFragments.length > 0) {
+        return raceIncrementalPayloadBatch(
+          pendingDeferredFragments,
+          batchTimeout
+        ).then(() => buildResponse(exeContext, data, true));
+      }
+    }
     const initialResult = exeContext.errors.length === 0 ? { data } : { errors: exeContext.errors, data };
     if (exeContext.subsequentPayloads.size > 0) {
       return {
@@ -288,7 +309,17 @@ function buildResponse(exeContext, data) {
     return buildResponse(exeContext, null);
   }
 }
-function executeFieldsSerially(exeContext, parentTypeName, sourceValue, path, groupedFieldSet) {
+function executeFieldsSerially(exeContext, parentTypeName, sourceValue, path, groupedFieldSet, patches) {
+  if (exeContext.enableEarlyExecution) {
+    startExecutingPatches(
+      exeContext,
+      parentTypeName,
+      sourceValue,
+      path,
+      patches,
+      void 0
+    );
+  }
   return (0, import_promiseReduce.promiseReduce)(
     groupedFieldSet,
     (results, [responseName, fieldGroup]) => {
@@ -319,9 +350,19 @@ function executeFieldsSerially(exeContext, parentTypeName, sourceValue, path, gr
     /* @__PURE__ */ Object.create(null)
   );
 }
-function executeFields(exeContext, parentTypeName, sourceValue, path, groupedFieldSet, incrementalDataRecord) {
+function executeFields(exeContext, parentTypeName, sourceValue, path, groupedFieldSet, incrementalDataRecord, patches) {
   const results = /* @__PURE__ */ Object.create(null);
   let containsPromise = false;
+  if (exeContext.enableEarlyExecution) {
+    startExecutingPatches(
+      exeContext,
+      parentTypeName,
+      sourceValue,
+      path,
+      patches,
+      incrementalDataRecord
+    );
+  }
   try {
     for (const [responseName, fieldGroup] of groupedFieldSet) {
       const fieldPath = (0, import_Path.addPath)(path, responseName, parentTypeName);
@@ -353,6 +394,46 @@ function executeFields(exeContext, parentTypeName, sourceValue, path, groupedFie
   }
   return (0, import_promiseForObject.promiseForObject)(results);
 }
+function startExecutingPatches(exeContext, parentTypeName, sourceValue, path, patches, incrementalDataRecord) {
+  if (!patches) {
+    return;
+  }
+  for (const { label, groupedFieldSet: patchGroupedFieldSet } of patches) {
+    executeDeferredFragment(
+      exeContext,
+      parentTypeName,
+      sourceValue,
+      patchGroupedFieldSet,
+      label,
+      path,
+      incrementalDataRecord
+    );
+  }
+}
+function includeCompletedDeferredFragmentsInResult(exeContext, result) {
+  const pendingDeferredFragments = [];
+  for (const incrementalDataRecord of exeContext.subsequentPayloads) {
+    if (!isDeferredFragmentRecord(incrementalDataRecord)) {
+      continue;
+    }
+    if (!incrementalDataRecord.isCompleted) {
+      pendingDeferredFragments.push(incrementalDataRecord.promise);
+      continue;
+    }
+    const target = (0, import_getObjectAtPath.getObjectAtPath)(result, incrementalDataRecord.path);
+    if (!target) {
+      continue;
+    }
+    if (incrementalDataRecord.data != null) {
+      Object.assign(target, incrementalDataRecord.data);
+    }
+    if (incrementalDataRecord.errors.length > 0) {
+      exeContext.errors.push(...incrementalDataRecord.errors);
+    }
+    exeContext.subsequentPayloads.delete(incrementalDataRecord);
+  }
+  return pendingDeferredFragments;
+}
 function executeField(exeContext, parentTypeName, source, fieldGroup, path, incrementalDataRecord) {
   const schemaFragment = exeContext.schemaFragment;
   const fieldName = fieldGroup[0].name.value;
@@ -1330,6 +1411,17 @@ function completeObjectValue(exeContext, returnTypeName, fieldGroup, path, resul
 }
 function collectAndExecuteSubfields(exeContext, returnTypeName, fieldGroup, path, result, incrementalDataRecord) {
   const { groupedFieldSet: subGroupedFieldSet, patches: subPatches } = collectSubfields(exeContext, { name: returnTypeName }, fieldGroup);
+  if (exeContext.enableEarlyExecution) {
+    return executeFields(
+      exeContext,
+      returnTypeName,
+      result,
+      path,
+      subGroupedFieldSet,
+      incrementalDataRecord,
+      subPatches
+    );
+  }
   const subFields = executeFields(
     exeContext,
     returnTypeName,
@@ -1948,6 +2040,34 @@ function getCompletedIncrementalResults(exeContext) {
   }
   return incrementalResults;
 }
+async function getCompletedIncrementalResultsWithBatching(exeContext, batchTimeout) {
+  const incremental = getCompletedIncrementalResults(exeContext);
+  if (incremental.length && exeContext.subsequentPayloads.size > 0) {
+    await raceIncrementalPayloadBatch(
+      Array.from(exeContext.subsequentPayloads).map((p) => p.promise),
+      batchTimeout
+    );
+    incremental.push(...getCompletedIncrementalResults(exeContext));
+  }
+  return incremental;
+}
+function raceIncrementalPayloadBatch(promises, batchTimeout) {
+  if (!Number.isFinite(batchTimeout) || batchTimeout <= 0) {
+    return Promise.resolve();
+  }
+  let timeoutId;
+  const timeoutPromise = new Promise((resolve) => {
+    timeoutId = setTimeout(resolve, batchTimeout);
+  });
+  return Promise.race([
+    Promise.all(promises).then(() => void 0),
+    timeoutPromise
+  ]).finally(() => {
+    if (timeoutId !== void 0) {
+      clearTimeout(timeoutId);
+    }
+  });
+}
 function yieldSubsequentPayloads(exeContext) {
   let isDone = false;
   async function next() {
@@ -1960,7 +2080,11 @@ function yieldSubsequentPayloads(exeContext) {
     if (isDone) {
       return { value: void 0, done: true };
     }
-    const incremental = getCompletedIncrementalResults(exeContext);
+    const batchTimeout = exeContext.incrementalPayloadBatchingTimeoutMs;
+    const incremental = typeof batchTimeout === "number" ? await getCompletedIncrementalResultsWithBatching(
+      exeContext,
+      batchTimeout
+    ) : getCompletedIncrementalResults(exeContext);
     const hasNext = exeContext.subsequentPayloads.size > 0;
     if (!incremental.length && hasNext) {
       return next();
@@ -2003,6 +2127,9 @@ function yieldSubsequentPayloads(exeContext) {
 function isStreamItemsRecord(incrementalDataRecord) {
   return incrementalDataRecord.type === "stream";
 }
+function isDeferredFragmentRecord(incrementalDataRecord) {
+  return incrementalDataRecord.type === "defer";
+}
 class DeferredFragmentRecord {
   constructor(opts) {
     this.type = "defer";
@@ -2018,10 +2145,11 @@ class DeferredFragmentRecord {
       this._resolve = (promiseOrValue) => {
         resolve(promiseOrValue);
       };
-    }).then((data) => {
-      this.data = data;
-      this.isCompleted = true;
-    });
+    }).then((data) => this.complete(data));
+  }
+  complete(data) {
+    this.data = data;
+    this.isCompleted = true;
   }
   addData(data) {
     var _a, _b, _c;
@@ -2030,6 +2158,9 @@ class DeferredFragmentRecord {
       (_b = this._resolve) == null ? void 0 : _b.call(this, parentData.then(() => data));
       return;
     }
+    if (!(0, import_isPromise.isPromise)(data)) {
+      this.complete(data);
+    }
     (_c = this._resolve) == null ? void 0 : _c.call(this, data);
   }
 }