reduce diff and changesets

Author: n1ru4l

.changeset/chatty-dryers-breathe.md

@@ -0,0 +1,5 @@
+---
+'@graphql-tools/utils': minor
+---
+
+Add helper function `memoize3of4` for memoizing values.

.changeset/fifty-bobcats-jog.md

@@ -1,6 +1,5 @@
 ---
 '@graphql-tools/executor': major
-'@graphql-tools/utils': minor
 ---
 
 Support the new non-duplicating Incremental Delivery format.

.changeset/mean-parents-do.md

@@ -0,0 +1,15 @@
+---
+'@graphql-tools/utils': minor
+---
+
+Support the new incremental protocol for `mergeIncrementalResult`.
+
+The `mergeIncrementalResult` function can now merge the [new response format without duplication](https://github.com/graphql/defer-stream-wg/discussions/69).
+
+```ts
+const executionResult = { data: { user: { name: 'John' } }, pending: [{ id: '0', path: [] }] };
+const incrementalResult = { incremental: [{ id: '0', data: { user: { age: 42 } } }] };
+
+console.log(mergeIncrementalResult({ incrementalResult, executionResult }));
+// logs: { user: { age: 42, name: 'John' } }
+```

packages/utils/src/createDeferred.ts

@@ -1,16 +1,18 @@
-// TODO: Remove this after Node 22
-
-export type Deferred<T = unknown> = PromiseWithResolvers<T>;
+export interface PromiseWithResolvers<T> {
+  promise: Promise<T>;
+  resolve: (value: T | PromiseLike<T>) => void;
+  reject: (reason: any) => void;
+}
 
-export function createDeferred<T>(): Deferred<T> {
+export function createDeferred<T>(): PromiseWithResolvers<T> {
   if (Promise.withResolvers) {
-    return Promise.withResolvers();
+    return Promise.withResolvers<T>();
   }
-  let resolve: (value: T | PromiseLike<T>) => void;
-  let reject: (error: unknown) => void;
+  let resolve!: (value: T | PromiseLike<T>) => void;
+  let reject!: (reason: any) => void;
   const promise = new Promise<T>((_resolve, _reject) => {
     resolve = _resolve;
     reject = _reject;
   });
-  return { promise, resolve: resolve!, reject: reject! };
+  return { promise, resolve, reject };
 }