graphql 17.0.0-beta.1 → 17.0.0-beta.2

package/execution/getVariableSignature.js.map

@@ -1 +1 @@
-{"version":3,"file":"getVariableSignature.js","sourceRoot":"","sources":["../../src/execution/getVariableSignature.ts"],"names":[],"mappings":";;AA0BA,oDAwBC;AAlDD,8DAAwD;AAMxD,uDAA+C;AAE/C,yDAAoD;AAGpD,gEAA0D;AAe1D,SAAgB,oBAAoB,CAClC,MAAqB,EACrB,UAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAA,4BAAW,EAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC,IAAA,2BAAW,EAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,mEAAmE;QACnE,wDAAwD;QACxD,MAAM,UAAU,GAAG,IAAA,kBAAK,EAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,8BAAY,CACrB,cAAc,OAAO,6BAA6B,UAAU,0CAA0C,EACtG,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAE7C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,YAAY,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE;KACnD,CAAC;AACJ,CAAC","sourcesContent":["import { GraphQLError } from '../error/GraphQLError.ts';\n\nimport type {\n  ConstValueNode,\n  VariableDefinitionNode,\n} from '../language/ast.ts';\nimport { print } from '../language/printer.ts';\n\nimport { isInputType } from '../type/definition.ts';\nimport type { GraphQLInputType, GraphQLSchema } from '../type/index.ts';\n\nimport { typeFromAST } from '../utilities/typeFromAST.ts';\n\n/**\n * A GraphQLVariableSignature is required to coerce a variable value.\n *\n * Designed to have comparable interface to GraphQLArgument so that\n * getArgumentValues() can be reused for fragment arguments.\n * */\nexport interface GraphQLVariableSignature {\n  name: string;\n  type: GraphQLInputType;\n  defaultValue?: never;\n  default: { literal: ConstValueNode } | undefined;\n}\n\nexport function getVariableSignature(\n  schema: GraphQLSchema,\n  varDefNode: VariableDefinitionNode,\n): GraphQLVariableSignature | GraphQLError {\n  const varName = varDefNode.variable.name.value;\n  const varType = typeFromAST(schema, varDefNode.type);\n\n  if (!isInputType(varType)) {\n    // Must use input types for variables. This should be caught during\n    // validation, however is checked again here for safety.\n    const varTypeStr = print(varDefNode.type);\n    return new GraphQLError(\n      `Variable \"$${varName}\" expected value of type \"${varTypeStr}\" which cannot be used as an input type.`,\n      { nodes: varDefNode.type },\n    );\n  }\n\n  const defaultValue = varDefNode.defaultValue;\n\n  return {\n    name: varName,\n    type: varType,\n    default: defaultValue && { literal: defaultValue },\n  };\n}\n"]}
+{"version":3,"file":"getVariableSignature.js","sourceRoot":"","sources":["../../src/execution/getVariableSignature.ts"],"names":[],"mappings":";;AA6BA,oDAwBC;AArDD,8DAAwD;AAMxD,uDAA+C;AAE/C,yDAAoD;AAGpD,gEAA0D;AAkB1D,SAAgB,oBAAoB,CAClC,MAAqB,EACrB,UAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAA,4BAAW,EAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC,IAAA,2BAAW,EAAC,OAAO,CAAC,EAAE,CAAC;QAG1B,MAAM,UAAU,GAAG,IAAA,kBAAK,EAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,8BAAY,CACrB,cAAc,OAAO,6BAA6B,UAAU,0CAA0C,EACtG,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAE7C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,YAAY,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE;KACnD,CAAC;AACJ,CAAC","sourcesContent":["import { GraphQLError } from '../error/GraphQLError.ts';\n\nimport type {\n  ConstValueNode,\n  VariableDefinitionNode,\n} from '../language/ast.ts';\nimport { print } from '../language/printer.ts';\n\nimport { isInputType } from '../type/definition.ts';\nimport type { GraphQLInputType, GraphQLSchema } from '../type/index.ts';\n\nimport { typeFromAST } from '../utilities/typeFromAST.ts';\n\n/**\n * A GraphQLVariableSignature is required to coerce a variable value.\n *\n * Designed to have comparable interface to GraphQLArgument so that\n * getArgumentValues() can be reused for fragment arguments.\n *\n * @internal\n */\nexport interface GraphQLVariableSignature {\n  name: string;\n  type: GraphQLInputType;\n  defaultValue?: never;\n  default: { literal: ConstValueNode } | undefined;\n}\n\n/** @internal */\nexport function getVariableSignature(\n  schema: GraphQLSchema,\n  varDefNode: VariableDefinitionNode,\n): GraphQLVariableSignature | GraphQLError {\n  const varName = varDefNode.variable.name.value;\n  const varType = typeFromAST(schema, varDefNode.type);\n\n  if (!isInputType(varType)) {\n    // Must use input types for variables. This should be caught during\n    // validation, however is checked again here for safety.\n    const varTypeStr = print(varDefNode.type);\n    return new GraphQLError(\n      `Variable \"$${varName}\" expected value of type \"${varTypeStr}\" which cannot be used as an input type.`,\n      { nodes: varDefNode.type },\n    );\n  }\n\n  const defaultValue = varDefNode.defaultValue;\n\n  return {\n    name: varName,\n    type: varType,\n    default: defaultValue && { literal: defaultValue },\n  };\n}\n"]}

package/execution/getVariableSignature.mjs

@@ -6,8 +6,6 @@ export function getVariableSignature(schema, varDefNode) {
     const varName = varDefNode.variable.name.value;
     const varType = typeFromAST(schema, varDefNode.type);
     if (!isInputType(varType)) {
-        // Must use input types for variables. This should be caught during
-        // validation, however is checked again here for safety.
         const varTypeStr = print(varDefNode.type);
         return new GraphQLError(`Variable "$${varName}" expected value of type "${varTypeStr}" which cannot be used as an input type.`, { nodes: varDefNode.type });
     }

package/execution/getVariableSignature.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"getVariableSignature.js","sourceRoot":"","sources":["../../src/execution/getVariableSignature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kCAAiC;AAMxD,OAAO,EAAE,KAAK,EAAE,gCAA+B;AAE/C,OAAO,EAAE,WAAW,EAAE,+BAA8B;AAGpD,OAAO,EAAE,WAAW,EAAE,qCAAoC;AAe1D,MAAM,UAAU,oBAAoB,CAClC,MAAqB,EACrB,UAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,mEAAmE;QACnE,wDAAwD;QACxD,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,YAAY,CACrB,cAAc,OAAO,6BAA6B,UAAU,0CAA0C,EACtG,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAE7C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,YAAY,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE;KACnD,CAAC;AACJ,CAAC","sourcesContent":["import { GraphQLError } from '../error/GraphQLError.ts';\n\nimport type {\n  ConstValueNode,\n  VariableDefinitionNode,\n} from '../language/ast.ts';\nimport { print } from '../language/printer.ts';\n\nimport { isInputType } from '../type/definition.ts';\nimport type { GraphQLInputType, GraphQLSchema } from '../type/index.ts';\n\nimport { typeFromAST } from '../utilities/typeFromAST.ts';\n\n/**\n * A GraphQLVariableSignature is required to coerce a variable value.\n *\n * Designed to have comparable interface to GraphQLArgument so that\n * getArgumentValues() can be reused for fragment arguments.\n * */\nexport interface GraphQLVariableSignature {\n  name: string;\n  type: GraphQLInputType;\n  defaultValue?: never;\n  default: { literal: ConstValueNode } | undefined;\n}\n\nexport function getVariableSignature(\n  schema: GraphQLSchema,\n  varDefNode: VariableDefinitionNode,\n): GraphQLVariableSignature | GraphQLError {\n  const varName = varDefNode.variable.name.value;\n  const varType = typeFromAST(schema, varDefNode.type);\n\n  if (!isInputType(varType)) {\n    // Must use input types for variables. This should be caught during\n    // validation, however is checked again here for safety.\n    const varTypeStr = print(varDefNode.type);\n    return new GraphQLError(\n      `Variable \"$${varName}\" expected value of type \"${varTypeStr}\" which cannot be used as an input type.`,\n      { nodes: varDefNode.type },\n    );\n  }\n\n  const defaultValue = varDefNode.defaultValue;\n\n  return {\n    name: varName,\n    type: varType,\n    default: defaultValue && { literal: defaultValue },\n  };\n}\n"]}
+{"version":3,"file":"getVariableSignature.js","sourceRoot":"","sources":["../../src/execution/getVariableSignature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,kCAAiC;AAMxD,OAAO,EAAE,KAAK,EAAE,gCAA+B;AAE/C,OAAO,EAAE,WAAW,EAAE,+BAA8B;AAGpD,OAAO,EAAE,WAAW,EAAE,qCAAoC;AAkB1D,MAAM,UAAU,oBAAoB,CAClC,MAAqB,EACrB,UAAkC;IAElC,MAAM,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC;IAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAErD,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;QAG1B,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC1C,OAAO,IAAI,YAAY,CACrB,cAAc,OAAO,6BAA6B,UAAU,0CAA0C,EACtG,EAAE,KAAK,EAAE,UAAU,CAAC,IAAI,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,YAAY,CAAC;IAE7C,OAAO;QACL,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,YAAY,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE;KACnD,CAAC;AACJ,CAAC","sourcesContent":["import { GraphQLError } from '../error/GraphQLError.ts';\n\nimport type {\n  ConstValueNode,\n  VariableDefinitionNode,\n} from '../language/ast.ts';\nimport { print } from '../language/printer.ts';\n\nimport { isInputType } from '../type/definition.ts';\nimport type { GraphQLInputType, GraphQLSchema } from '../type/index.ts';\n\nimport { typeFromAST } from '../utilities/typeFromAST.ts';\n\n/**\n * A GraphQLVariableSignature is required to coerce a variable value.\n *\n * Designed to have comparable interface to GraphQLArgument so that\n * getArgumentValues() can be reused for fragment arguments.\n *\n * @internal\n */\nexport interface GraphQLVariableSignature {\n  name: string;\n  type: GraphQLInputType;\n  defaultValue?: never;\n  default: { literal: ConstValueNode } | undefined;\n}\n\n/** @internal */\nexport function getVariableSignature(\n  schema: GraphQLSchema,\n  varDefNode: VariableDefinitionNode,\n): GraphQLVariableSignature | GraphQLError {\n  const varName = varDefNode.variable.name.value;\n  const varType = typeFromAST(schema, varDefNode.type);\n\n  if (!isInputType(varType)) {\n    // Must use input types for variables. This should be caught during\n    // validation, however is checked again here for safety.\n    const varTypeStr = print(varDefNode.type);\n    return new GraphQLError(\n      `Variable \"$${varName}\" expected value of type \"${varTypeStr}\" which cannot be used as an input type.`,\n      { nodes: varDefNode.type },\n    );\n  }\n\n  const defaultValue = varDefNode.defaultValue;\n\n  return {\n    name: varName,\n    type: varType,\n    default: defaultValue && { literal: defaultValue },\n  };\n}\n"]}

package/execution/hooks.d.mts

@@ -1,9 +1,5 @@
+/** @category Execution */
 import type { SharedExecutionContext } from "./createSharedExecutionContext.mjs";
-import type { ValidatedExecutionArgs } from "./Executor.mjs";
-export interface AsyncWorkFinishedInfo {
-    validatedExecutionArgs: ValidatedExecutionArgs;
-}
-export interface ExecutionHooks {
-    asyncWorkFinished?: (info: AsyncWorkFinishedInfo) => void;
-}
+import type { AsyncWorkFinishedInfo, ValidatedExecutionArgs } from "./ExecutionArgs.mjs";
+/** @internal */
 export declare function runAsyncWorkFinishedHook(validatedExecutionArgs: ValidatedExecutionArgs, sharedExecutionContext: SharedExecutionContext, asyncWorkFinishedHook: (info: AsyncWorkFinishedInfo) => void): void;

package/execution/hooks.d.ts

@@ -1,9 +1,5 @@
+/** @category Execution */
 import type { SharedExecutionContext } from "./createSharedExecutionContext.js";
-import type { ValidatedExecutionArgs } from "./Executor.js";
-export interface AsyncWorkFinishedInfo {
-    validatedExecutionArgs: ValidatedExecutionArgs;
-}
-export interface ExecutionHooks {
-    asyncWorkFinished?: (info: AsyncWorkFinishedInfo) => void;
-}
+import type { AsyncWorkFinishedInfo, ValidatedExecutionArgs } from "./ExecutionArgs.js";
+/** @internal */
 export declare function runAsyncWorkFinishedHook(validatedExecutionArgs: ValidatedExecutionArgs, sharedExecutionContext: SharedExecutionContext, asyncWorkFinishedHook: (info: AsyncWorkFinishedInfo) => void): void;

package/execution/hooks.js

@@ -6,7 +6,6 @@ function runHookSafely(hook, info) {
         hook?.(info);
     }
     catch {
-        // ignore hook errors
     }
 }
 function runAsyncWorkFinishedHook(validatedExecutionArgs, sharedExecutionContext, asyncWorkFinishedHook) {

package/execution/hooks.js.map

@@ -1 +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.ts';\nimport type { ValidatedExecutionArgs } from './Executor.ts';\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"]}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/execution/hooks.ts"],"names":[],"mappings":";;AAiBA,4DAeC;AAxBD,SAAS,aAAa,CAAQ,IAA2B,EAAE,IAAW;IACpE,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;AACH,CAAC;AAGD,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":["/** @category Execution */\n\nimport type { SharedExecutionContext } from './createSharedExecutionContext.ts';\nimport type {\n  AsyncWorkFinishedInfo,\n  ValidatedExecutionArgs,\n} from './ExecutionArgs.ts';\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\n/** @internal */\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

@@ -3,7 +3,6 @@ function runHookSafely(hook, info) {
         hook?.(info);
     }
     catch {
-        // ignore hook errors
     }
 }
 export function runAsyncWorkFinishedHook(validatedExecutionArgs, sharedExecutionContext, asyncWorkFinishedHook) {

package/execution/hooks.mjs.map

@@ -1 +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.ts';\nimport type { ValidatedExecutionArgs } from './Executor.ts';\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"]}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/execution/hooks.ts"],"names":[],"mappings":"AAQA,SAAS,aAAa,CAAQ,IAA2B,EAAE,IAAW;IACpE,IAAI,CAAC;QACH,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IACf,CAAC;IAAC,MAAM,CAAC;IAET,CAAC;AACH,CAAC;AAGD,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":["/** @category Execution */\n\nimport type { SharedExecutionContext } from './createSharedExecutionContext.ts';\nimport type {\n  AsyncWorkFinishedInfo,\n  ValidatedExecutionArgs,\n} from './ExecutionArgs.ts';\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\n/** @internal */\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

@@ -9,7 +9,7 @@ type MaybePromise<T> = {
     status: 'rejected';
     reason: unknown;
 };
-/** @internal **/
+/** @internal * */
 export declare class Computation<T> {
     private _fn;
     private _onAbort;

package/execution/incremental/Computation.d.ts

@@ -9,7 +9,7 @@ type MaybePromise<T> = {
     status: 'rejected';
     reason: unknown;
 };
-/** @internal **/
+/** @internal * */
 export declare class Computation<T> {
     private _fn;
     private _onAbort;

package/execution/incremental/Computation.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Computation = void 0;
 const isPromise_ts_1 = require("../../jsutils/isPromise.js");
-/** @internal **/
 class Computation {
     constructor(fn, onAbort) {
         this._fn = fn;

package/execution/incremental/Computation.js.map

@@ -1 +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.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\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"]}
+{"version":3,"file":"Computation.js","sourceRoot":"","sources":["../../../src/execution/incremental/Computation.ts"],"names":[],"mappings":";;;AAAA,6DAAuD;AASvD,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.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\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

@@ -1,5 +1,4 @@
 import { isPromise } from "../../jsutils/isPromise.mjs";
-/** @internal **/
 export class Computation {
     constructor(fn, onAbort) {
         this._fn = fn;

package/execution/incremental/Computation.mjs.map

@@ -1 +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.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\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"]}
+{"version":3,"file":"Computation.js","sourceRoot":"","sources":["../../../src/execution/incremental/Computation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,oCAAmC;AASvD,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.ts';\nimport type { PromiseOrValue } from '../../jsutils/PromiseOrValue.ts';\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

@@ -1,3 +1,4 @@
+/** @category Incremental Execution */
 import type { ObjMap } from "../../jsutils/ObjMap.mjs";
 import type { Path } from "../../jsutils/Path.mjs";
 import type { PromiseOrValue } from "../../jsutils/PromiseOrValue.mjs";
@@ -5,7 +6,8 @@ import type { GraphQLError, GraphQLFormattedError } from "../../error/GraphQLErr
 import type { GraphQLObjectType, GraphQLOutputType, GraphQLResolveInfo } from "../../type/definition.mjs";
 import type { DeferUsage, FieldDetailsList, GroupedFieldSet } from "../collectFields.mjs";
 import type { SharedExecutionContext } from "../createSharedExecutionContext.mjs";
-import type { ExecutionResult, FormattedExecutionResult, ValidatedExecutionArgs } from "../Executor.mjs";
+import type { ValidatedExecutionArgs } from "../ExecutionArgs.mjs";
+import type { ExecutionResult, FormattedExecutionResult } from "../Executor.mjs";
 import { Executor } from "../Executor.mjs";
 import type { StreamUsage } from "../getStreamUsage.mjs";
 import type { DeferUsageSet, ExecutionPlan } from "./buildExecutionPlan.mjs";
@@ -13,92 +15,195 @@ import { Computation } from "./Computation.mjs";
 import { Queue } from "./Queue.mjs";
 import type { Group, Stream, Task, Work } from "./WorkQueue.mjs";
 /**
- * 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.
+ * Results for an operation that produced incremental payloads.
+ * @typeParam TInitialData - Shape of the initial result data payload.
+ * @typeParam TDeferredData - Shape of deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
  */
 export interface ExperimentalIncrementalExecutionResults<TInitialData = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Initial execution result delivered before subsequent incremental payloads. */
     initialResult: InitialIncrementalExecutionResult<TInitialData, TExtensions>;
+    /** Async stream of incremental payloads delivered after the initial result. */
     subsequentResults: AsyncGenerator<SubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
 }
+/**
+ * JSON-serializable form of incremental execution results.
+ * @typeParam TInitial - Shape of the formatted initial result data payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
 export interface FormattedExperimentalIncrementalExecutionResults<TInitial = ObjMap<unknown>, TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Formatted initial execution result. */
     initialResult: FormattedInitialIncrementalExecutionResult<TInitial, TExtensions>;
+    /** Async stream of formatted incremental payloads. */
     subsequentResults: AsyncGenerator<FormattedSubsequentIncrementalExecutionResult<TDeferredData, TStreamItem, TExtensions>, void, void>;
 }
+/**
+ * Initial execution result for an operation that produced incremental payloads.
+ * @typeParam TData - Shape of the initial data payload.
+ * @typeParam TExtensions - Shape of the extensions payload.
+ */
 export interface InitialIncrementalExecutionResult<TData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends ExecutionResult<TData, TExtensions> {
+    /** Data produced by the initial execution payload. */
     data: TData;
+    /** Incremental payloads that are still pending after the initial result. */
     pending: ReadonlyArray<PendingResult>;
+    /** Indicates that subsequent incremental payloads will follow. */
     hasNext: true;
+    /** Additional non-standard metadata included in the initial result. */
     extensions?: TExtensions;
 }
+/**
+ * JSON-serializable form of an initial incremental execution result.
+ * @typeParam TInitialData - Shape of the formatted initial data payload.
+ * @typeParam TExtensions - Shape of the formatted extensions payload.
+ */
 export interface FormattedInitialIncrementalExecutionResult<TInitialData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> extends FormattedExecutionResult<TInitialData, TExtensions> {
+    /** Formatted data produced by the initial execution payload. */
     data: TInitialData;
+    /** Formatted list of incremental payloads still pending after the initial result. */
     pending: ReadonlyArray<PendingResult>;
+    /** Indicates whether subsequent incremental payloads will follow. */
     hasNext: boolean;
+    /** Additional non-standard metadata included in the formatted initial result. */
     extensions?: TExtensions;
 }
+/**
+ * Subsequent payload produced by incremental execution.
+ * @typeParam TDeferredData - Shape of deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of the extensions payload.
+ */
 export interface SubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Incremental payloads that became pending with this response. */
     pending?: ReadonlyArray<PendingResult>;
+    /** Deferred or streamed payloads delivered by this response. */
     incremental?: ReadonlyArray<IncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    /** Incremental payloads that completed with this response. */
     completed?: ReadonlyArray<CompletedResult>;
+    /** Indicates whether more incremental payloads will follow. */
     hasNext: boolean;
+    /** Additional non-standard metadata included in this payload. */
     extensions?: TExtensions;
 }
+/**
+ * JSON-serializable form of a subsequent incremental execution payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data payloads.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
 export interface FormattedSubsequentIncrementalExecutionResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Indicates whether more incremental payloads will follow. */
     hasNext: boolean;
+    /** Formatted incremental payloads that became pending with this response. */
     pending?: ReadonlyArray<PendingResult>;
+    /** Formatted deferred or streamed payloads delivered by this response. */
     incremental?: ReadonlyArray<FormattedIncrementalResult<TDeferredData, TStreamItem, TExtensions>>;
+    /** Formatted incremental payloads that completed with this response. */
     completed?: ReadonlyArray<FormattedCompletedResult>;
+    /** Additional non-standard metadata included in this formatted payload. */
     extensions?: TExtensions;
 }
+/**
+ * Incremental payload produced by a deferred fragment.
+ * @typeParam TDeferredData - Shape of deferred fragment data.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
 export interface IncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    /** Identifier matching this payload to a pending deferred fragment. */
     id: string;
+    /** Path from the deferred fragment location to this payload. */
     subPath?: ReadonlyArray<string | number>;
+    /** Errors raised while executing the deferred fragment. */
     errors?: ReadonlyArray<GraphQLError>;
+    /** Data produced by the deferred fragment. */
     data: TDeferredData;
+    /** Additional non-standard metadata included in this payload. */
     extensions?: TExtensions;
 }
+/**
+ * JSON-serializable form of a deferred fragment payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
 export interface FormattedIncrementalDeferResult<TDeferredData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    /** Formatted errors raised while executing the deferred fragment. */
     errors?: ReadonlyArray<GraphQLFormattedError>;
+    /** Formatted data produced by the deferred fragment. */
     data: TDeferredData;
+    /** Identifier matching this payload to a pending deferred fragment. */
     id: string;
+    /** Path from the deferred fragment location to this payload. */
     subPath?: ReadonlyArray<string | number>;
+    /** Additional non-standard metadata included in this formatted payload. */
     extensions?: TExtensions;
 }
+/**
+ * Incremental payload produced by a streamed list field.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
 export interface IncrementalStreamResult<TStreamItem = unknown, TExtensions = ObjMap<unknown>> {
+    /** Identifier matching this payload to a pending stream. */
     id: string;
+    /** Path from the streamed field location to these items. */
     subPath?: ReadonlyArray<string | number>;
+    /** Errors raised while producing streamed items. */
     errors?: ReadonlyArray<GraphQLError>;
+    /** Streamed list items delivered by this payload. */
     items: ReadonlyArray<TStreamItem>;
+    /** Additional non-standard metadata included in this payload. */
     extensions?: TExtensions;
 }
+/**
+ * JSON-serializable form of a streamed list payload.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
 export interface FormattedIncrementalStreamResult<TStreamItem = Array<unknown>, TExtensions = ObjMap<unknown>> {
+    /** Formatted errors raised while producing streamed items. */
     errors?: ReadonlyArray<GraphQLFormattedError>;
+    /** Formatted streamed list items delivered by this payload. */
     items: ReadonlyArray<TStreamItem>;
+    /** Identifier matching this payload to a pending stream. */
     id: string;
+    /** Path from the streamed field location to these items. */
     subPath?: ReadonlyArray<string | number>;
+    /** Additional non-standard metadata included in this formatted payload. */
     extensions?: TExtensions;
 }
+/**
+ * Deferred fragment or streamed list payload produced by incremental execution.
+ * @typeParam TDeferredData - Shape of deferred fragment data.
+ * @typeParam TStreamItem - Shape of streamed list items.
+ * @typeParam TExtensions - Shape of extensions payloads.
+ */
 export type IncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = IncrementalDeferResult<TDeferredData, TExtensions> | IncrementalStreamResult<TStreamItem, TExtensions>;
+/**
+ * JSON-serializable deferred fragment or streamed list payload.
+ * @typeParam TDeferredData - Shape of formatted deferred fragment data.
+ * @typeParam TStreamItem - Shape of formatted streamed list items.
+ * @typeParam TExtensions - Shape of formatted extensions payloads.
+ */
 export type FormattedIncrementalResult<TDeferredData = ObjMap<unknown>, TStreamItem = unknown, TExtensions = ObjMap<unknown>> = FormattedIncrementalDeferResult<TDeferredData, TExtensions> | FormattedIncrementalStreamResult<TStreamItem, TExtensions>;
+/** @internal */
 export interface PendingResult {
     id: string;
     path: ReadonlyArray<string | number>;
     label?: string;
 }
+/** @internal */
 export interface CompletedResult {
     id: string;
     errors?: ReadonlyArray<GraphQLError>;
 }
+/** @internal */
 export interface FormattedCompletedResult {
     id: string;
     errors?: ReadonlyArray<GraphQLFormattedError>;
 }
-/** @internal */
 interface ExecutionGroup extends Task<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream> {
     groups: ReadonlyArray<DeliveryGroup>;
     path: Path | undefined;
@@ -110,26 +215,32 @@ export interface DeliveryGroup extends Group<DeliveryGroup> {
     label: string | undefined;
     parent: DeliveryGroup | undefined;
 }
+/** @internal */
 export interface ItemStream extends Stream<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream> {
     path: Path;
     label: string | undefined;
     initialCount: number;
 }
+/** @internal */
 export interface ExecutionGroupValue {
     deliveryGroups: ReadonlyArray<DeliveryGroup>;
     path: ReadonlyArray<string | number>;
     errors?: ReadonlyArray<GraphQLError>;
     data: ObjMap<unknown>;
 }
+/** @internal */
 export type IncrementalWork = Work<ExecutionGroupValue, StreamItemValue, DeliveryGroup, ItemStream>;
+/** @internal */
 export interface ExecutionGroupResult {
     value: ExecutionGroupValue;
     work?: IncrementalWork | undefined;
 }
+/** @internal */
 export interface StreamItemValue {
     errors?: ReadonlyArray<GraphQLError>;
     item: unknown;
 }
+/** @internal */
 export interface StreamItemResult {
     value: StreamItemValue;
     work?: IncrementalWork | undefined;
@@ -146,6 +257,8 @@ export declare class IncrementalExecutor<TExperimental = ExperimentalIncremental
     /**
      * Given a completed execution context and data, build the `{ errors, data }`
      * response defined by the "Response" section of the GraphQL specification.
+     *
+     * @internal
      */
     buildResponse(data: ObjMap<unknown> | null): ExecutionResult | TExperimental;
     executeCollectedRootFields(rootType: GraphQLObjectType, rootValue: unknown, originalGroupedFieldSet: GroupedFieldSet, serially: boolean, newDeferUsages: ReadonlyArray<DeferUsage>): PromiseOrValue<ObjMap<unknown>>;
@@ -162,6 +275,8 @@ export declare class IncrementalExecutor<TExperimental = ExperimentalIncremental
      *
      * Note: As defer directives may be used with operations returning lists,
      * a DeferUsage object may correspond to many DeliveryGroups.
+     *
+     * @internal
      */
     getNewDeliveryGroupMap(newDeferUsages: ReadonlyArray<DeferUsage>, deliveryGroupMap: ReadonlyMap<DeferUsage, DeliveryGroup> | undefined, path: Path | undefined): {
         newDeliveryGroups: ReadonlyArray<DeliveryGroup>;