graphql 17.0.0-alpha.8 → 17.0.0-beta.0

package/execution/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/execution/hooks.ts"],"names":[],"mappings":";;AAmBA,4DAeC;AAvBD,SAAS,aAAa,CAAQ,IAA2B,EAAE,IAAW;IACpE,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;AACH,CAAC;AAED,SAAgB,wBAAwB,CACtC,sBAA8C,EAC9C,sBAA8C,EAC9C,qBAA4D;IAE5D,MAAM,qBAAqB,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAC7E,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QACxC,aAAa,CAAC,qBAAqB,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IACD,qBAAqB;SAClB,IAAI,CAAC,GAAG,EAAE;QACT,aAAa,CAAC,qBAAqB,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import type { SharedExecutionContext } from './createSharedExecutionContext.js';\nimport type { ValidatedExecutionArgs } from './Executor.js';\n\nexport interface AsyncWorkFinishedInfo {\n  validatedExecutionArgs: ValidatedExecutionArgs;\n}\n\nexport interface ExecutionHooks {\n  asyncWorkFinished?: (info: AsyncWorkFinishedInfo) => void;\n}\n\nfunction runHookSafely<TInfo>(hook: (info: TInfo) => void, info: TInfo): void {\n  try {\n    hook?.(info);\n  } catch {\n    // ignore hook errors\n  }\n}\n\nexport function runAsyncWorkFinishedHook(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n  sharedExecutionContext: SharedExecutionContext,\n  asyncWorkFinishedHook: (info: AsyncWorkFinishedInfo) => void,\n): void {\n  const maybeWaitForAsyncWork = sharedExecutionContext.asyncWorkTracker.wait();\n  if (maybeWaitForAsyncWork === undefined) {\n    runHookSafely(asyncWorkFinishedHook, { validatedExecutionArgs });\n    return;\n  }\n  maybeWaitForAsyncWork\n    .then(() => {\n      runHookSafely(asyncWorkFinishedHook, { validatedExecutionArgs });\n    })\n    .catch(() => undefined);\n}\n"]}

package/execution/hooks.mjs

@@ -0,0 +1,21 @@
+function runHookSafely(hook, info) {
+    try {
+        hook?.(info);
+    }
+    catch {
+        // ignore hook errors
+    }
+}
+export function runAsyncWorkFinishedHook(validatedExecutionArgs, sharedExecutionContext, asyncWorkFinishedHook) {
+    const maybeWaitForAsyncWork = sharedExecutionContext.asyncWorkTracker.wait();
+    if (maybeWaitForAsyncWork === undefined) {
+        runHookSafely(asyncWorkFinishedHook, { validatedExecutionArgs });
+        return;
+    }
+    maybeWaitForAsyncWork
+        .then(() => {
+        runHookSafely(asyncWorkFinishedHook, { validatedExecutionArgs });
+    })
+        .catch(() => undefined);
+}
+//# sourceMappingURL=hooks.js.map

package/execution/hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/execution/hooks.ts"],"names":[],"mappings":"AAWA,SAAS,aAAa,CAAQ,IAA2B,EAAE,IAAW;IACpE,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;QACP,qBAAqB;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,sBAA8C,EAC9C,sBAA8C,EAC9C,qBAA4D;IAE5D,MAAM,qBAAqB,GAAG,sBAAsB,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IAC7E,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;QACxC,aAAa,CAAC,qBAAqB,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IACD,qBAAqB;SAClB,IAAI,CAAC,GAAG,EAAE;QACT,aAAa,CAAC,qBAAqB,EAAE,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACnE,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;AAC5B,CAAC","sourcesContent":["import type { SharedExecutionContext } from './createSharedExecutionContext.js';\nimport type { ValidatedExecutionArgs } from './Executor.js';\n\nexport interface AsyncWorkFinishedInfo {\n  validatedExecutionArgs: ValidatedExecutionArgs;\n}\n\nexport interface ExecutionHooks {\n  asyncWorkFinished?: (info: AsyncWorkFinishedInfo) => void;\n}\n\nfunction runHookSafely<TInfo>(hook: (info: TInfo) => void, info: TInfo): void {\n  try {\n    hook?.(info);\n  } catch {\n    // ignore hook errors\n  }\n}\n\nexport function runAsyncWorkFinishedHook(\n  validatedExecutionArgs: ValidatedExecutionArgs,\n  sharedExecutionContext: SharedExecutionContext,\n  asyncWorkFinishedHook: (info: AsyncWorkFinishedInfo) => void,\n): void {\n  const maybeWaitForAsyncWork = sharedExecutionContext.asyncWorkTracker.wait();\n  if (maybeWaitForAsyncWork === undefined) {\n    runHookSafely(asyncWorkFinishedHook, { validatedExecutionArgs });\n    return;\n  }\n  maybeWaitForAsyncWork\n    .then(() => {\n      runHookSafely(asyncWorkFinishedHook, { validatedExecutionArgs });\n    })\n    .catch(() => undefined);\n}\n"]}

package/execution/incremental/Computation.d.mts

@@ -0,0 +1,22 @@
+import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
+type MaybePromise<T> = {
+    status: 'fulfilled';
+    value: T;
+} | {
+    status: 'pending';
+    promise: Promise<T>;
+} | {
+    status: 'rejected';
+    reason: unknown;
+};
+/** @internal **/
+export declare class Computation<T> {
+    private _fn;
+    private _onAbort;
+    private _maybePromise?;
+    constructor(fn: () => PromiseOrValue<T>, onAbort?: (reason?: unknown) => PromiseOrValue<void>);
+    prime(): MaybePromise<T>;
+    result(): PromiseOrValue<T>;
+    abort(reason?: unknown): PromiseOrValue<void>;
+}
+export {};

package/execution/incremental/Computation.d.ts

@@ -0,0 +1,22 @@
+import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
+type MaybePromise<T> = {
+    status: 'fulfilled';
+    value: T;
+} | {
+    status: 'pending';
+    promise: Promise<T>;
+} | {
+    status: 'rejected';
+    reason: unknown;
+};
+/** @internal **/
+export declare class Computation<T> {
+    private _fn;
+    private _onAbort;
+    private _maybePromise?;
+    constructor(fn: () => PromiseOrValue<T>, onAbort?: (reason?: unknown) => PromiseOrValue<void>);
+    prime(): MaybePromise<T>;
+    result(): PromiseOrValue<T>;
+    abort(reason?: unknown): PromiseOrValue<void>;
+}
+export {};

package/execution/incremental/Computation.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Computation = void 0;
+const isPromise_js_1 = require("../../jsutils/isPromise.js");
+/** @internal **/
+class Computation {
+    constructor(fn, onAbort) {
+        this._fn = fn;
+        this._onAbort = onAbort;
+    }
+    prime() {
+        if (this._maybePromise) {
+            return this._maybePromise;
+        }
+        try {
+            const result = this._fn();
+            if ((0, isPromise_js_1.isPromise)(result)) {
+                this._maybePromise = { status: 'pending', promise: result };
+                result.then((value) => {
+                    this._maybePromise = { status: 'fulfilled', value };
+                }, (reason) => {
+                    this._maybePromise = { status: 'rejected', reason };
+                });
+            }
+            else {
+                this._maybePromise = { status: 'fulfilled', value: result };
+            }
+        }
+        catch (reason) {
+            this._maybePromise = { status: 'rejected', reason };
+        }
+        return this._maybePromise;
+    }
+    result() {
+        const maybePromise = this.prime();
+        switch (maybePromise.status) {
+            case 'fulfilled':
+                return maybePromise.value;
+            case 'rejected':
+                throw maybePromise.reason;
+            case 'pending': {
+                return maybePromise.promise;
+            }
+        }
+    }
+    abort(reason) {
+        const maybePromise = this._maybePromise;
+        if (!maybePromise) {
+            this._maybePromise = {
+                status: 'rejected',
+                reason,
+            };
+            return;
+        }
+        const status = maybePromise.status;
+        if (status === 'pending') {
+            this._maybePromise = {
+                status: 'rejected',
+                reason,
+            };
+            if (this._onAbort) {
+                return this._onAbort(reason);
+            }
+        }
+    }
+}
+exports.Computation = Computation;
+//# sourceMappingURL=Computation.js.map

package/execution/incremental/Computation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Computation.js","sourceRoot":"","sources":["../../../src/execution/incremental/Computation.ts"],"names":[],"mappings":";;;AAAA,6DAAuD;AAQvD,iBAAiB;AACjB,MAAa,WAAW;IAItB,YACE,EAA2B,EAC3B,OAAoD;QAEpD,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,KAAK;QACH,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,IAAA,wBAAS,EAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC5D,MAAM,CAAC,IAAI,CACT,CAAC,KAAK,EAAE,EAAE;oBACR,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;gBACtD,CAAC,EACD,CAAC,MAAe,EAAE,EAAE;oBAClB,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;gBACtD,CAAC,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,OAAO,MAAe,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACD,MAAM;QACJ,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAClC,QAAQ,YAAY,CAAC,MAAM,EAAE,CAAC;YAC5B,KAAK,WAAW;gBACd,OAAO,YAAY,CAAC,KAAK,CAAC;YAC5B,KAAK,UAAU;gBACb,MAAM,YAAY,CAAC,MAAM,CAAC;YAC5B,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,OAAO,YAAY,CAAC,OAAO,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,CAAC,MAAgB;QACpB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,aAAa,GAAG;gBACnB,MAAM,EAAE,UAAU;gBAClB,MAAM;aACP,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,GAAG;gBACnB,MAAM,EAAE,UAAU;gBAClB,MAAM;aACP,CAAC;YACF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAnED,kCAmEC","sourcesContent":["import { isPromise } from '../../jsutils/isPromise.js';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';\n\ntype MaybePromise<T> =\n  | { status: 'fulfilled'; value: T }\n  | { status: 'pending'; promise: Promise<T> }\n  | { status: 'rejected'; reason: unknown };\n\n/** @internal **/\nexport class Computation<T> {\n  private _fn: () => PromiseOrValue<T>;\n  private _onAbort: ((reason?: unknown) => PromiseOrValue<void>) | undefined;\n  private _maybePromise?: MaybePromise<T>;\n  constructor(\n    fn: () => PromiseOrValue<T>,\n    onAbort?: (reason?: unknown) => PromiseOrValue<void>,\n  ) {\n    this._fn = fn;\n    this._onAbort = onAbort;\n  }\n  prime(): MaybePromise<T> {\n    if (this._maybePromise) {\n      return this._maybePromise;\n    }\n    try {\n      const result = this._fn();\n      if (isPromise(result)) {\n        this._maybePromise = { status: 'pending', promise: result };\n        result.then(\n          (value) => {\n            this._maybePromise = { status: 'fulfilled', value };\n          },\n          (reason: unknown) => {\n            this._maybePromise = { status: 'rejected', reason };\n          },\n        );\n      } else {\n        this._maybePromise = { status: 'fulfilled', value: result };\n      }\n    } catch (reason: unknown) {\n      this._maybePromise = { status: 'rejected', reason };\n    }\n    return this._maybePromise;\n  }\n  result(): PromiseOrValue<T> {\n    const maybePromise = this.prime();\n    switch (maybePromise.status) {\n      case 'fulfilled':\n        return maybePromise.value;\n      case 'rejected':\n        throw maybePromise.reason;\n      case 'pending': {\n        return maybePromise.promise;\n      }\n    }\n  }\n  abort(reason?: unknown): PromiseOrValue<void> {\n    const maybePromise = this._maybePromise;\n    if (!maybePromise) {\n      this._maybePromise = {\n        status: 'rejected',\n        reason,\n      };\n      return;\n    }\n    const status = maybePromise.status;\n    if (status === 'pending') {\n      this._maybePromise = {\n        status: 'rejected',\n        reason,\n      };\n      if (this._onAbort) {\n        return this._onAbort(reason);\n      }\n    }\n  }\n}\n"]}

package/execution/incremental/Computation.mjs

@@ -0,0 +1,64 @@
+import { isPromise } from "../../jsutils/isPromise.mjs";
+/** @internal **/
+export class Computation {
+    constructor(fn, onAbort) {
+        this._fn = fn;
+        this._onAbort = onAbort;
+    }
+    prime() {
+        if (this._maybePromise) {
+            return this._maybePromise;
+        }
+        try {
+            const result = this._fn();
+            if (isPromise(result)) {
+                this._maybePromise = { status: 'pending', promise: result };
+                result.then((value) => {
+                    this._maybePromise = { status: 'fulfilled', value };
+                }, (reason) => {
+                    this._maybePromise = { status: 'rejected', reason };
+                });
+            }
+            else {
+                this._maybePromise = { status: 'fulfilled', value: result };
+            }
+        }
+        catch (reason) {
+            this._maybePromise = { status: 'rejected', reason };
+        }
+        return this._maybePromise;
+    }
+    result() {
+        const maybePromise = this.prime();
+        switch (maybePromise.status) {
+            case 'fulfilled':
+                return maybePromise.value;
+            case 'rejected':
+                throw maybePromise.reason;
+            case 'pending': {
+                return maybePromise.promise;
+            }
+        }
+    }
+    abort(reason) {
+        const maybePromise = this._maybePromise;
+        if (!maybePromise) {
+            this._maybePromise = {
+                status: 'rejected',
+                reason,
+            };
+            return;
+        }
+        const status = maybePromise.status;
+        if (status === 'pending') {
+            this._maybePromise = {
+                status: 'rejected',
+                reason,
+            };
+            if (this._onAbort) {
+                return this._onAbort(reason);
+            }
+        }
+    }
+}
+//# sourceMappingURL=Computation.js.map

package/execution/incremental/Computation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Computation.js","sourceRoot":"","sources":["../../../src/execution/incremental/Computation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oCAAmC;AAQvD,iBAAiB;AACjB,MAAM,OAAO,WAAW;IAItB,YACE,EAA2B,EAC3B,OAAoD;QAEpD,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IACD,KAAK;QACH,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,OAAO,IAAI,CAAC,aAAa,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC1B,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtB,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;gBAC5D,MAAM,CAAC,IAAI,CACT,CAAC,KAAK,EAAE,EAAE;oBACR,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;gBACtD,CAAC,EACD,CAAC,MAAe,EAAE,EAAE;oBAClB,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;gBACtD,CAAC,CACF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAC9D,CAAC;QACH,CAAC;QAAC,OAAO,MAAe,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IACD,MAAM;QACJ,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAClC,QAAQ,YAAY,CAAC,MAAM,EAAE,CAAC;YAC5B,KAAK,WAAW;gBACd,OAAO,YAAY,CAAC,KAAK,CAAC;YAC5B,KAAK,UAAU;gBACb,MAAM,YAAY,CAAC,MAAM,CAAC;YAC5B,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,OAAO,YAAY,CAAC,OAAO,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,CAAC,MAAgB;QACpB,MAAM,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC;QACxC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,IAAI,CAAC,aAAa,GAAG;gBACnB,MAAM,EAAE,UAAU;gBAClB,MAAM;aACP,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QACnC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,aAAa,GAAG;gBACnB,MAAM,EAAE,UAAU;gBAClB,MAAM;aACP,CAAC;YACF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;CACF","sourcesContent":["import { isPromise } from '../../jsutils/isPromise.js';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';\n\ntype MaybePromise<T> =\n  | { status: 'fulfilled'; value: T }\n  | { status: 'pending'; promise: Promise<T> }\n  | { status: 'rejected'; reason: unknown };\n\n/** @internal **/\nexport class Computation<T> {\n  private _fn: () => PromiseOrValue<T>;\n  private _onAbort: ((reason?: unknown) => PromiseOrValue<void>) | undefined;\n  private _maybePromise?: MaybePromise<T>;\n  constructor(\n    fn: () => PromiseOrValue<T>,\n    onAbort?: (reason?: unknown) => PromiseOrValue<void>,\n  ) {\n    this._fn = fn;\n    this._onAbort = onAbort;\n  }\n  prime(): MaybePromise<T> {\n    if (this._maybePromise) {\n      return this._maybePromise;\n    }\n    try {\n      const result = this._fn();\n      if (isPromise(result)) {\n        this._maybePromise = { status: 'pending', promise: result };\n        result.then(\n          (value) => {\n            this._maybePromise = { status: 'fulfilled', value };\n          },\n          (reason: unknown) => {\n            this._maybePromise = { status: 'rejected', reason };\n          },\n        );\n      } else {\n        this._maybePromise = { status: 'fulfilled', value: result };\n      }\n    } catch (reason: unknown) {\n      this._maybePromise = { status: 'rejected', reason };\n    }\n    return this._maybePromise;\n  }\n  result(): PromiseOrValue<T> {\n    const maybePromise = this.prime();\n    switch (maybePromise.status) {\n      case 'fulfilled':\n        return maybePromise.value;\n      case 'rejected':\n        throw maybePromise.reason;\n      case 'pending': {\n        return maybePromise.promise;\n      }\n    }\n  }\n  abort(reason?: unknown): PromiseOrValue<void> {\n    const maybePromise = this._maybePromise;\n    if (!maybePromise) {\n      this._maybePromise = {\n        status: 'rejected',\n        reason,\n      };\n      return;\n    }\n    const status = maybePromise.status;\n    if (status === 'pending') {\n      this._maybePromise = {\n        status: 'rejected',\n        reason,\n      };\n      if (this._onAbort) {\n        return this._onAbort(reason);\n      }\n    }\n  }\n}\n"]}

package/execution/incremental/IncrementalExecutor.d.mts

@@ -0,0 +1,182 @@
+import type { ObjMap } from '../../jsutils/ObjMap.js';
+import type { Path } from '../../jsutils/Path.js';
+import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
+import type { GraphQLError, GraphQLFormattedError } from '../../error/GraphQLError.js';
+import type { GraphQLObjectType, GraphQLOutputType, GraphQLResolveInfo } from '../../type/definition.js';
+import type { DeferUsage, FieldDetailsList, GroupedFieldSet } from '../collectFields.js';
+import type { SharedExecutionContext } from '../createSharedExecutionContext.js';
+import type { ExecutionResult, FormattedExecutionResult, ValidatedExecutionArgs } from '../Executor.js';
+import { Executor } from '../Executor.js';
+import type { StreamUsage } from '../getStreamUsage.js';
+import type { DeferUsageSet, ExecutionPlan } from '../incremental/buildExecutionPlan.js';
+import { Computation } from './Computation.js';
+import { Queue } from './Queue.js';
+import type { Group, Stream, Task, Work } from './WorkQueue.js';
+/**
+ * The result of GraphQL execution.
+ *
+ *   - `errors` is included when any errors occurred as a non-empty array.
+ *   - `data` is the result of a successful execution of the query.
+ *   - `hasNext` is true if a future payload is expected.
+ *   - `extensions` is reserved for adding non-standard properties.
+ *   - `incremental` is a list of the results from defer/stream directives.
+ */
+export interface ExperimentalIncrementalExecutionResults<TInitialData = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    initialResult: InitialIncrementalExecutionResult<TInitialData, TExtensions>;
+    subsequentResults: AsyncGenerator<SubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+export interface FormattedExperimentalIncrementalExecutionResults<TInitial = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    initialResult: FormattedInitialIncrementalExecutionResult<TInitial, TExtensions>;
+    subsequentResults: AsyncGenerator<FormattedSubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+export interface InitialIncrementalExecutionResult<TData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends ExecutionResult<TData, TExtensions> {
+    data: TData;
+    pending: ReadonlyArray<PendingResult>;
+    hasNext: true;
+    extensions?: TExtensions;
+}
+export interface FormattedInitialIncrementalExecutionResult<TInitialData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends FormattedExecutionResult<TInitialData, TExtensions> {
+    data: TInitialData;
+    pending: ReadonlyArray<PendingResult>;
+    hasNext: boolean;
+    extensions?: TExtensions;
+}
+export interface SubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    pending?: ReadonlyArray<PendingResult>;
+    incremental?: ReadonlyArray<IncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    completed?: ReadonlyArray<CompletedResult>;
+    hasNext: boolean;
+    extensions?: TExtensions;
+}
+export interface FormattedSubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    hasNext: boolean;
+    pending?: ReadonlyArray<PendingResult>;
+    incremental?: ReadonlyArray<FormattedIncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    completed?: ReadonlyArray<FormattedCompletedResult>;
+    extensions?: TExtensions;
+}
+export interface IncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    errors?: ReadonlyArray<GraphQLError>;
+    data: TDeferredData;
+    extensions?: TExtensions;
+}
+export interface FormattedIncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    data: TDeferredData;
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    extensions?: TExtensions;
+}
+export interface IncrementalStreamResult<TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    errors?: ReadonlyArray<GraphQLError>;
+    items: ReadonlyArray<TStreamItem>;
+    extensions?: TExtensions;
+}
+export interface FormattedIncrementalStreamResult<TStreamItem = Array<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    items: ReadonlyArray<TStreamItem>;
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    extensions?: TExtensions;
+}
+export type IncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = IncrementalDeferResult<TDeferredData, TExtensions> | IncrementalStreamResult<TStreamItem, TExtensions>;
+export type FormattedIncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = FormattedIncrementalDeferResult<TDeferredData, TExtensions> | FormattedIncrementalStreamResult<TStreamItem, TExtensions>;
+export interface PendingResult {
+    id: string;
+    path: ReadonlyArray<string | number>;
+    label?: string;
+}
+export interface CompletedResult {
+    id: string;
+    errors?: ReadonlyArray<GraphQLError>;
+}
+export interface FormattedCompletedResult {
+    id: string;
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+}
+/** @internal */
+interface ExecutionGroup extends Task<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream> {
+    groups: ReadonlyArray<DeliveryGroup>;
+    path: Path | undefined;
+    computation: Computation<ExecutionGroupResult>;
+}
+/** @internal */
+export interface DeliveryGroup extends Group<DeliveryGroup> {
+    path: Path | undefined;
+    label: string | undefined;
+    parent: DeliveryGroup | undefined;
+}
+export interface ItemStream extends Stream<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream> {
+    path: Path;
+    label: string | undefined;
+    initialCount: number;
+}
+export interface ExecutionGroupValue {
+    deliveryGroups: ReadonlyArray<DeliveryGroup>;
+    path: ReadonlyArray<string | number>;
+    errors?: ReadonlyArray<GraphQLError>;
+    data: ObjMap<unknown>;
+}
+export type IncrementalWork = Work<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream>;
+export interface ExecutionGroupResult {
+    value: ExecutionGroupValue;
+    work?: IncrementalWork | undefined;
+}
+export interface StreamItemValue {
+    errors?: ReadonlyArray<GraphQLError>;
+    item: unknown;
+}
+export interface StreamItemResult {
+    value: StreamItemValue;
+    work?: IncrementalWork | undefined;
+}
+/** @internal */
+export declare class IncrementalExecutor<TExperimental = ExperimentalIncrementalExecutionResults> extends Executor<ReadonlyMap<DeferUsage, DeliveryGroup>, TExperimental> {
+    deferUsageSet?: DeferUsageSet | undefined;
+    groups: Array<DeliveryGroup>;
+    tasks: Array<ExecutionGroup>;
+    streams: Array<ItemStream>;
+    constructor(validatedExecutionArgs: ValidatedExecutionArgs, sharedExecutionContext?: SharedExecutionContext, deferUsageSet?: DeferUsageSet);
+    getCreateSubExecutor(): (deferUsageSet?: DeferUsageSet) => IncrementalExecutor<TExperimental>;
+    abort(reason?: unknown): void;
+    /**
+     * Given a completed execution context and data, build the `{ errors, data }`
+     * response defined by the "Response" section of the GraphQL specification.
+     */
+    buildResponse(data: ObjMap<unknown> | null): ExecutionResult | TExperimental;
+    executeCollectedRootFields(rootType: GraphQLObjectType, rootValue: unknown, originalGroupedFieldSet: GroupedFieldSet, serially: boolean, newDeferUsages: ReadonlyArray<DeferUsage>): PromiseOrValue<ObjMap<unknown>>;
+    buildRootExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+    executeCollectedSubfields(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, originalGroupedFieldSet: GroupedFieldSet, newDeferUsages: ReadonlyArray<DeferUsage>, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup> | undefined): PromiseOrValue<ObjMap<unknown>>;
+    buildSubExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+    collectExecutionGroups(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, newGroupedFieldSets: Map<DeferUsageSet, GroupedFieldSet>, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup>): void;
+    executeExecutionGroup(deliveryGroups: ReadonlyArray<DeliveryGroup>, parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, groupedFieldSet: GroupedFieldSet, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup>): PromiseOrValue<ExecutionGroupResult>;
+    buildExecutionGroupResult(deliveryGroups: ReadonlyArray<DeliveryGroup>, path: Path | undefined, result: ObjMap<unknown>): ExecutionGroupResult;
+    getIncrementalWork(): IncrementalWork;
+    /**
+     * Instantiates new DeliveryGroups for the given path, returning an
+     * updated map of DeferUsage objects to DeliveryGroups.
+     *
+     * Note: As defer directives may be used with operations returning lists,
+     * a DeferUsage object may correspond to many DeliveryGroups.
+     */
+    getNewDeliveryGroupMap(newDeferUsages: ReadonlyArray<DeferUsage>, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup> | undefined, path: Path | undefined): {
+        newDeliveryGroups: ReadonlyArray<DeliveryGroup>;
+        newDeliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup>;
+    };
+    shouldDefer(parentDeferUsages: undefined | DeferUsageSet, deferUsages: DeferUsageSet): boolean;
+    handleStream(index: number, path: Path, iterator: {
+        handle: Iterator<unknown>;
+        isAsync?: never;
+    } | {
+        handle: AsyncIterator<unknown>;
+        isAsync: true;
+    }, streamUsage: StreamUsage, info: GraphQLResolveInfo, itemType: GraphQLOutputType): boolean;
+    buildStreamItemQueue(initialIndex: number, streamPath: Path, iterator: Iterator<unknown> | AsyncIterator<unknown>, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemType: GraphQLOutputType, isAsync: boolean | undefined): Queue<StreamItemResult>;
+    completeStreamItem(itemPath: Path, item: unknown, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemType: GraphQLOutputType): PromiseOrValue<StreamItemResult>;
+    buildStreamItemResult(result: unknown): StreamItemResult;
+}
+export {};

package/execution/incremental/IncrementalExecutor.d.ts

@@ -0,0 +1,182 @@
+import type { ObjMap } from '../../jsutils/ObjMap.js';
+import type { Path } from '../../jsutils/Path.js';
+import type { PromiseOrValue } from '../../jsutils/PromiseOrValue.js';
+import type { GraphQLError, GraphQLFormattedError } from '../../error/GraphQLError.js';
+import type { GraphQLObjectType, GraphQLOutputType, GraphQLResolveInfo } from '../../type/definition.js';
+import type { DeferUsage, FieldDetailsList, GroupedFieldSet } from '../collectFields.js';
+import type { SharedExecutionContext } from '../createSharedExecutionContext.js';
+import type { ExecutionResult, FormattedExecutionResult, ValidatedExecutionArgs } from '../Executor.js';
+import { Executor } from '../Executor.js';
+import type { StreamUsage } from '../getStreamUsage.js';
+import type { DeferUsageSet, ExecutionPlan } from '../incremental/buildExecutionPlan.js';
+import { Computation } from './Computation.js';
+import { Queue } from './Queue.js';
+import type { Group, Stream, Task, Work } from './WorkQueue.js';
+/**
+ * The result of GraphQL execution.
+ *
+ *   - `errors` is included when any errors occurred as a non-empty array.
+ *   - `data` is the result of a successful execution of the query.
+ *   - `hasNext` is true if a future payload is expected.
+ *   - `extensions` is reserved for adding non-standard properties.
+ *   - `incremental` is a list of the results from defer/stream directives.
+ */
+export interface ExperimentalIncrementalExecutionResults<TInitialData = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    initialResult: InitialIncrementalExecutionResult<TInitialData, TExtensions>;
+    subsequentResults: AsyncGenerator<SubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+export interface FormattedExperimentalIncrementalExecutionResults<TInitial = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    initialResult: FormattedInitialIncrementalExecutionResult<TInitial, TExtensions>;
+    subsequentResults: AsyncGenerator<FormattedSubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
+}
+export interface InitialIncrementalExecutionResult<TData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends ExecutionResult<TData, TExtensions> {
+    data: TData;
+    pending: ReadonlyArray<PendingResult>;
+    hasNext: true;
+    extensions?: TExtensions;
+}
+export interface FormattedInitialIncrementalExecutionResult<TInitialData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends FormattedExecutionResult<TInitialData, TExtensions> {
+    data: TInitialData;
+    pending: ReadonlyArray<PendingResult>;
+    hasNext: boolean;
+    extensions?: TExtensions;
+}
+export interface SubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    pending?: ReadonlyArray<PendingResult>;
+    incremental?: ReadonlyArray<IncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    completed?: ReadonlyArray<CompletedResult>;
+    hasNext: boolean;
+    extensions?: TExtensions;
+}
+export interface FormattedSubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    hasNext: boolean;
+    pending?: ReadonlyArray<PendingResult>;
+    incremental?: ReadonlyArray<FormattedIncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    completed?: ReadonlyArray<FormattedCompletedResult>;
+    extensions?: TExtensions;
+}
+export interface IncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    errors?: ReadonlyArray<GraphQLError>;
+    data: TDeferredData;
+    extensions?: TExtensions;
+}
+export interface FormattedIncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    data: TDeferredData;
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    extensions?: TExtensions;
+}
+export interface IncrementalStreamResult<TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    errors?: ReadonlyArray<GraphQLError>;
+    items: ReadonlyArray<TStreamItem>;
+    extensions?: TExtensions;
+}
+export interface FormattedIncrementalStreamResult<TStreamItem = Array<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    items: ReadonlyArray<TStreamItem>;
+    id: string;
+    subPath?: ReadonlyArray<string | number>;
+    extensions?: TExtensions;
+}
+export type IncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = IncrementalDeferResult<TDeferredData, TExtensions> | IncrementalStreamResult<TStreamItem, TExtensions>;
+export type FormattedIncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = FormattedIncrementalDeferResult<TDeferredData, TExtensions> | FormattedIncrementalStreamResult<TStreamItem, TExtensions>;
+export interface PendingResult {
+    id: string;
+    path: ReadonlyArray<string | number>;
+    label?: string;
+}
+export interface CompletedResult {
+    id: string;
+    errors?: ReadonlyArray<GraphQLError>;
+}
+export interface FormattedCompletedResult {
+    id: string;
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+}
+/** @internal */
+interface ExecutionGroup extends Task<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream> {
+    groups: ReadonlyArray<DeliveryGroup>;
+    path: Path | undefined;
+    computation: Computation<ExecutionGroupResult>;
+}
+/** @internal */
+export interface DeliveryGroup extends Group<DeliveryGroup> {
+    path: Path | undefined;
+    label: string | undefined;
+    parent: DeliveryGroup | undefined;
+}
+export interface ItemStream extends Stream<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream> {
+    path: Path;
+    label: string | undefined;
+    initialCount: number;
+}
+export interface ExecutionGroupValue {
+    deliveryGroups: ReadonlyArray<DeliveryGroup>;
+    path: ReadonlyArray<string | number>;
+    errors?: ReadonlyArray<GraphQLError>;
+    data: ObjMap<unknown>;
+}
+export type IncrementalWork = Work<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream>;
+export interface ExecutionGroupResult {
+    value: ExecutionGroupValue;
+    work?: IncrementalWork | undefined;
+}
+export interface StreamItemValue {
+    errors?: ReadonlyArray<GraphQLError>;
+    item: unknown;
+}
+export interface StreamItemResult {
+    value: StreamItemValue;
+    work?: IncrementalWork | undefined;
+}
+/** @internal */
+export declare class IncrementalExecutor<TExperimental = ExperimentalIncrementalExecutionResults> extends Executor<ReadonlyMap<DeferUsage, DeliveryGroup>, TExperimental> {
+    deferUsageSet?: DeferUsageSet | undefined;
+    groups: Array<DeliveryGroup>;
+    tasks: Array<ExecutionGroup>;
+    streams: Array<ItemStream>;
+    constructor(validatedExecutionArgs: ValidatedExecutionArgs, sharedExecutionContext?: SharedExecutionContext, deferUsageSet?: DeferUsageSet);
+    getCreateSubExecutor(): (deferUsageSet?: DeferUsageSet) => IncrementalExecutor<TExperimental>;
+    abort(reason?: unknown): void;
+    /**
+     * Given a completed execution context and data, build the `{ errors, data }`
+     * response defined by the "Response" section of the GraphQL specification.
+     */
+    buildResponse(data: ObjMap<unknown> | null): ExecutionResult | TExperimental;
+    executeCollectedRootFields(rootType: GraphQLObjectType, rootValue: unknown, originalGroupedFieldSet: GroupedFieldSet, serially: boolean, newDeferUsages: ReadonlyArray<DeferUsage>): PromiseOrValue<ObjMap<unknown>>;
+    buildRootExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+    executeCollectedSubfields(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, originalGroupedFieldSet: GroupedFieldSet, newDeferUsages: ReadonlyArray<DeferUsage>, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup> | undefined): PromiseOrValue<ObjMap<unknown>>;
+    buildSubExecutionPlan(originalGroupedFieldSet: GroupedFieldSet): ExecutionPlan;
+    collectExecutionGroups(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, newGroupedFieldSets: Map<DeferUsageSet, GroupedFieldSet>, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup>): void;
+    executeExecutionGroup(deliveryGroups: ReadonlyArray<DeliveryGroup>, parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, groupedFieldSet: GroupedFieldSet, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup>): PromiseOrValue<ExecutionGroupResult>;
+    buildExecutionGroupResult(deliveryGroups: ReadonlyArray<DeliveryGroup>, path: Path | undefined, result: ObjMap<unknown>): ExecutionGroupResult;
+    getIncrementalWork(): IncrementalWork;
+    /**
+     * Instantiates new DeliveryGroups for the given path, returning an
+     * updated map of DeferUsage objects to DeliveryGroups.
+     *
+     * Note: As defer directives may be used with operations returning lists,
+     * a DeferUsage object may correspond to many DeliveryGroups.
+     */
+    getNewDeliveryGroupMap(newDeferUsages: ReadonlyArray<DeferUsage>, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup> | undefined, path: Path | undefined): {
+        newDeliveryGroups: ReadonlyArray<DeliveryGroup>;
+        newDeliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup>;
+    };
+    shouldDefer(parentDeferUsages: undefined | DeferUsageSet, deferUsages: DeferUsageSet): boolean;
+    handleStream(index: number, path: Path, iterator: {
+        handle: Iterator<unknown>;
+        isAsync?: never;
+    } | {
+        handle: AsyncIterator<unknown>;
+        isAsync: true;
+    }, streamUsage: StreamUsage, info: GraphQLResolveInfo, itemType: GraphQLOutputType): boolean;
+    buildStreamItemQueue(initialIndex: number, streamPath: Path, iterator: Iterator<unknown> | AsyncIterator<unknown>, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemType: GraphQLOutputType, isAsync: boolean | undefined): Queue<StreamItemResult>;
+    completeStreamItem(itemPath: Path, item: unknown, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemType: GraphQLOutputType): PromiseOrValue<StreamItemResult>;
+    buildStreamItemResult(result: unknown): StreamItemResult;
+}
+export {};