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

package/execution/Executor.d.mts

@@ -0,0 +1,212 @@
+import type { ObjMap } from '../jsutils/ObjMap.js';
+import type { Path } from '../jsutils/Path.js';
+import type { PromiseOrValue } from '../jsutils/PromiseOrValue.js';
+import type { GraphQLFormattedError } from '../error/GraphQLError.js';
+import { GraphQLError } from '../error/GraphQLError.js';
+import type { FragmentDefinitionNode, OperationDefinitionNode, SubscriptionOperationDefinitionNode } from '../language/ast.js';
+import type { GraphQLAbstractType, GraphQLFieldResolver, GraphQLLeafType, GraphQLList, GraphQLObjectType, GraphQLOutputType, GraphQLResolveInfo, GraphQLResolveInfoHelpers, GraphQLTypeResolver } from '../type/definition.js';
+import type { GraphQLSchema } from '../type/schema.js';
+import { AbortedGraphQLExecutionError } from './AbortedGraphQLExecutionError.js';
+import type { DeferUsage, FieldDetailsList, FragmentDetails, GroupedFieldSet } from './collectFields.js';
+import { collectSubfields as _collectSubfields } from './collectFields.js';
+import type { SharedExecutionContext } from './createSharedExecutionContext.js';
+import type { StreamUsage } from './getStreamUsage.js';
+import { getStreamUsage as _getStreamUsage } from './getStreamUsage.js';
+import type { ExecutionHooks } from './hooks.js';
+import type { VariableValues } from './values.js';
+/**
+ * Terminology
+ *
+ * "Definitions" are the generic name for top-level statements in the document.
+ * Examples of this include:
+ * 1) Operations (such as a query)
+ * 2) Fragments
+ *
+ * "Operations" are a generic name for requests in the document.
+ * Examples of this include:
+ * 1) query,
+ * 2) mutation
+ *
+ * "Selections" are the definitions that can appear legally and at
+ * single level of the query. These include:
+ * 1) field references e.g `a`
+ * 2) fragment "spreads" e.g. `...c`
+ * 3) inline fragment "spreads" e.g. `...on Type { a }`
+ */
+/**
+ * Data that must be available at all points during query execution.
+ *
+ * Namely, schema of the type system that is currently executing,
+ * and the fragments defined in the query document
+ */
+export interface ValidatedExecutionArgs {
+    schema: GraphQLSchema;
+    fragmentDefinitions: ObjMap<FragmentDefinitionNode>;
+    fragments: ObjMap<FragmentDetails>;
+    rootValue: unknown;
+    contextValue: unknown;
+    operation: OperationDefinitionNode;
+    variableValues: VariableValues;
+    fieldResolver: GraphQLFieldResolver<any, any>;
+    typeResolver: GraphQLTypeResolver<any, any>;
+    subscribeFieldResolver: GraphQLFieldResolver<any, any>;
+    perEventExecutor: (validatedExecutionArgs: ValidatedSubscriptionArgs) => PromiseOrValue<ExecutionResult>;
+    hideSuggestions: boolean;
+    errorPropagation: boolean;
+    externalAbortSignal: AbortSignal | undefined;
+    enableEarlyExecution: boolean;
+    hooks: ExecutionHooks | undefined;
+}
+export interface ValidatedSubscriptionArgs extends ValidatedExecutionArgs {
+    operation: SubscriptionOperationDefinitionNode;
+}
+/**
+ * A memoized collection of relevant subfields with regard to the return
+ * type. Memoizing ensures the subfields are not repeatedly calculated, which
+ * saves overhead when resolving lists of values.
+ */
+export declare const collectSubfields: (validatedExecutionArgs: ValidatedExecutionArgs, returnType: GraphQLObjectType, fieldDetailsList: FieldDetailsList) => ReturnType<typeof _collectSubfields>;
+export declare const getStreamUsage: typeof _getStreamUsage;
+/**
+ * @internal
+ */
+declare class CollectedErrors {
+    private _errorPositions;
+    private _errors;
+    constructor();
+    get errors(): ReadonlyArray<GraphQLError>;
+    add(error: GraphQLError, path: Path | undefined): void;
+    hasNulledPosition(startPath: Path | undefined): boolean;
+}
+/**
+ * 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 ExecutionResult<TData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLError>;
+    data?: TData | null;
+    extensions?: TExtensions;
+}
+export interface FormattedExecutionResult<TData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    data?: TData | null;
+    extensions?: TExtensions;
+}
+/** @internal */
+export declare class Executor<TPositionContext = undefined, // No position context by default
+TAlternativeInitialResponse = ExecutionResult> {
+    validatedExecutionArgs: ValidatedExecutionArgs;
+    aborted: boolean;
+    abortReason: unknown;
+    sharedExecutionContext: SharedExecutionContext;
+    collectedErrors: CollectedErrors;
+    abortResultPromise: (() => void) | undefined;
+    resolverAbortController: AbortController | undefined;
+    getAbortSignal: () => AbortSignal | undefined;
+    getAsyncHelpers: () => GraphQLResolveInfoHelpers;
+    promiseAll: <T>(values: ReadonlyArray<PromiseOrValue<T>>) => Promise<Array<T>>;
+    constructor(validatedExecutionArgs: ValidatedExecutionArgs, sharedExecutionContext?: SharedExecutionContext);
+    executeRootSelectionSet(serially?: boolean): PromiseOrValue<ExecutionResult | TAlternativeInitialResponse>;
+    abort(reason?: unknown): void;
+    finish<T>(result: T): T;
+    createAbortedExecutionError<T>(result: PromiseOrValue<T>): AbortedGraphQLExecutionError<T>;
+    getFinishSharedExecution(): () => 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 | TAlternativeInitialResponse;
+    executeCollectedRootFields(rootType: GraphQLObjectType, rootValue: unknown, originalGroupedFieldSet: GroupedFieldSet, serially: boolean, _newDeferUsages: ReadonlyArray<DeferUsage>): PromiseOrValue<ObjMap<unknown>>;
+    executeRootGroupedFieldSet(rootType: GraphQLObjectType, rootValue: unknown, groupedFieldSet: GroupedFieldSet, serially: boolean, positionContext?: TPositionContext): PromiseOrValue<ObjMap<unknown>>;
+    /**
+     * Implements the "Executing selection sets" section of the spec
+     * for fields that must be executed serially.
+     */
+    executeFieldsSerially(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, groupedFieldSet: GroupedFieldSet, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    /**
+     * Implements the "Executing selection sets" section of the spec
+     * for fields that may be executed in parallel.
+     */
+    executeFields(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, groupedFieldSet: GroupedFieldSet, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    /**
+     * Implements the "Executing fields" section of the spec
+     * In particular, this function figures out the value that the field returns by
+     * calling its resolve function, then calls completeValue to complete promises,
+     * coercing scalars, or execute the sub-selection-set for objects.
+     */
+    executeField(parentType: GraphQLObjectType, source: unknown, fieldDetailsList: FieldDetailsList, path: Path, positionContext: TPositionContext | undefined): PromiseOrValue<unknown>;
+    handleFieldError(rawError: unknown, returnType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, path: Path): void;
+    /**
+     * Implements the instructions for completeValue as defined in the
+     * "Value Completion" section of the spec.
+     *
+     * If the field type is Non-Null, then this recursively completes the value
+     * for the inner type. It throws a field error if that completion returns null,
+     * as per the "Nullability" section of the spec.
+     *
+     * If the field type is a List, then this recursively completes the value
+     * for the inner type on each item in the list.
+     *
+     * If the field type is a Scalar or Enum, ensures the completed value is a legal
+     * value of the type by calling the `coerceOutputValue` method of GraphQL type
+     * definition.
+     *
+     * If the field is an abstract type, determine the runtime type of the value
+     * and then complete based on that type
+     *
+     * Otherwise, the field type expects a sub-selection set, and will complete the
+     * value by executing all sub-selections.
+     */
+    completeValue(returnType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<unknown>;
+    completePromisedValue(returnType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: PromiseLike<unknown>, positionContext: TPositionContext | undefined): Promise<unknown>;
+    /**
+     * Complete a async iterator value by completing the result and calling
+     * recursively until all the results are completed.
+     */
+    completeAsyncIterableValue(itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, items: AsyncIterable<unknown>, positionContext: TPositionContext | undefined): Promise<ReadonlyArray<unknown>>;
+    handleStream(_index: number, _path: Path, _iterator: {
+        handle: Iterator<unknown>;
+        isAsync?: never;
+    } | {
+        handle: AsyncIterator<unknown>;
+        isAsync: true;
+    }, _streamUsage: StreamUsage, _info: GraphQLResolveInfo, _itemType: GraphQLOutputType): boolean;
+    /**
+     * Complete a list value by completing each item in the list with the
+     * inner type
+     */
+    completeListValue(returnType: GraphQLList<GraphQLOutputType>, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ReadonlyArray<unknown>>;
+    completeIterableValue(itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, items: Iterable<unknown>, positionContext: TPositionContext | undefined): PromiseOrValue<ReadonlyArray<unknown>>;
+    completeMaybePromisedListItemValue(item: unknown, completedResults: Array<unknown>, itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemPath: Path, positionContext: TPositionContext | undefined): boolean;
+    /**
+     * Complete a list item value by adding it to the completed results.
+     *
+     * Returns true if the value is a Promise.
+     */
+    completeListItemValue(item: unknown, completedResults: Array<unknown>, itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemPath: Path, positionContext: TPositionContext | undefined): boolean;
+    completePromisedListItemValue(item: PromiseLike<unknown>, itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemPath: Path, positionContext: TPositionContext | undefined): Promise<unknown>;
+    /**
+     * Complete a Scalar or Enum by serializing to a valid value, returning
+     * null if serialization is not possible.
+     */
+    completeLeafValue(returnType: GraphQLLeafType, result: unknown): unknown;
+    /**
+     * Complete a value of an abstract type by determining the runtime object type
+     * of that value, then complete the value for that type.
+     */
+    completeAbstractValue(returnType: GraphQLAbstractType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    ensureValidRuntimeType(runtimeTypeName: unknown, schema: GraphQLSchema, returnType: GraphQLAbstractType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, result: unknown): GraphQLObjectType;
+    /**
+     * Complete an Object value by executing all sub-selections.
+     */
+    completeObjectValue(returnType: GraphQLObjectType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    invalidReturnTypeError(returnType: GraphQLObjectType, result: unknown, fieldDetailsList: FieldDetailsList): GraphQLError;
+    collectAndExecuteSubfields(returnType: GraphQLObjectType, fieldDetailsList: FieldDetailsList, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    executeCollectedSubfields(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, originalGroupedFieldSet: GroupedFieldSet, _newDeferUsages: ReadonlyArray<DeferUsage>, _positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+}
+export {};

package/execution/Executor.d.ts

@@ -0,0 +1,212 @@
+import type { ObjMap } from '../jsutils/ObjMap.js';
+import type { Path } from '../jsutils/Path.js';
+import type { PromiseOrValue } from '../jsutils/PromiseOrValue.js';
+import type { GraphQLFormattedError } from '../error/GraphQLError.js';
+import { GraphQLError } from '../error/GraphQLError.js';
+import type { FragmentDefinitionNode, OperationDefinitionNode, SubscriptionOperationDefinitionNode } from '../language/ast.js';
+import type { GraphQLAbstractType, GraphQLFieldResolver, GraphQLLeafType, GraphQLList, GraphQLObjectType, GraphQLOutputType, GraphQLResolveInfo, GraphQLResolveInfoHelpers, GraphQLTypeResolver } from '../type/definition.js';
+import type { GraphQLSchema } from '../type/schema.js';
+import { AbortedGraphQLExecutionError } from './AbortedGraphQLExecutionError.js';
+import type { DeferUsage, FieldDetailsList, FragmentDetails, GroupedFieldSet } from './collectFields.js';
+import { collectSubfields as _collectSubfields } from './collectFields.js';
+import type { SharedExecutionContext } from './createSharedExecutionContext.js';
+import type { StreamUsage } from './getStreamUsage.js';
+import { getStreamUsage as _getStreamUsage } from './getStreamUsage.js';
+import type { ExecutionHooks } from './hooks.js';
+import type { VariableValues } from './values.js';
+/**
+ * Terminology
+ *
+ * "Definitions" are the generic name for top-level statements in the document.
+ * Examples of this include:
+ * 1) Operations (such as a query)
+ * 2) Fragments
+ *
+ * "Operations" are a generic name for requests in the document.
+ * Examples of this include:
+ * 1) query,
+ * 2) mutation
+ *
+ * "Selections" are the definitions that can appear legally and at
+ * single level of the query. These include:
+ * 1) field references e.g `a`
+ * 2) fragment "spreads" e.g. `...c`
+ * 3) inline fragment "spreads" e.g. `...on Type { a }`
+ */
+/**
+ * Data that must be available at all points during query execution.
+ *
+ * Namely, schema of the type system that is currently executing,
+ * and the fragments defined in the query document
+ */
+export interface ValidatedExecutionArgs {
+    schema: GraphQLSchema;
+    fragmentDefinitions: ObjMap<FragmentDefinitionNode>;
+    fragments: ObjMap<FragmentDetails>;
+    rootValue: unknown;
+    contextValue: unknown;
+    operation: OperationDefinitionNode;
+    variableValues: VariableValues;
+    fieldResolver: GraphQLFieldResolver<any, any>;
+    typeResolver: GraphQLTypeResolver<any, any>;
+    subscribeFieldResolver: GraphQLFieldResolver<any, any>;
+    perEventExecutor: (validatedExecutionArgs: ValidatedSubscriptionArgs) => PromiseOrValue<ExecutionResult>;
+    hideSuggestions: boolean;
+    errorPropagation: boolean;
+    externalAbortSignal: AbortSignal | undefined;
+    enableEarlyExecution: boolean;
+    hooks: ExecutionHooks | undefined;
+}
+export interface ValidatedSubscriptionArgs extends ValidatedExecutionArgs {
+    operation: SubscriptionOperationDefinitionNode;
+}
+/**
+ * A memoized collection of relevant subfields with regard to the return
+ * type. Memoizing ensures the subfields are not repeatedly calculated, which
+ * saves overhead when resolving lists of values.
+ */
+export declare const collectSubfields: (validatedExecutionArgs: ValidatedExecutionArgs, returnType: GraphQLObjectType, fieldDetailsList: FieldDetailsList) => ReturnType<typeof _collectSubfields>;
+export declare const getStreamUsage: typeof _getStreamUsage;
+/**
+ * @internal
+ */
+declare class CollectedErrors {
+    private _errorPositions;
+    private _errors;
+    constructor();
+    get errors(): ReadonlyArray<GraphQLError>;
+    add(error: GraphQLError, path: Path | undefined): void;
+    hasNulledPosition(startPath: Path | undefined): boolean;
+}
+/**
+ * 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 ExecutionResult<TData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLError>;
+    data?: TData | null;
+    extensions?: TExtensions;
+}
+export interface FormattedExecutionResult<TData = ObjMap<unknown>, TExtensions = ObjMap<unknown>> {
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    data?: TData | null;
+    extensions?: TExtensions;
+}
+/** @internal */
+export declare class Executor<TPositionContext = undefined, // No position context by default
+TAlternativeInitialResponse = ExecutionResult> {
+    validatedExecutionArgs: ValidatedExecutionArgs;
+    aborted: boolean;
+    abortReason: unknown;
+    sharedExecutionContext: SharedExecutionContext;
+    collectedErrors: CollectedErrors;
+    abortResultPromise: (() => void) | undefined;
+    resolverAbortController: AbortController | undefined;
+    getAbortSignal: () => AbortSignal | undefined;
+    getAsyncHelpers: () => GraphQLResolveInfoHelpers;
+    promiseAll: <T>(values: ReadonlyArray<PromiseOrValue<T>>) => Promise<Array<T>>;
+    constructor(validatedExecutionArgs: ValidatedExecutionArgs, sharedExecutionContext?: SharedExecutionContext);
+    executeRootSelectionSet(serially?: boolean): PromiseOrValue<ExecutionResult | TAlternativeInitialResponse>;
+    abort(reason?: unknown): void;
+    finish<T>(result: T): T;
+    createAbortedExecutionError<T>(result: PromiseOrValue<T>): AbortedGraphQLExecutionError<T>;
+    getFinishSharedExecution(): () => 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 | TAlternativeInitialResponse;
+    executeCollectedRootFields(rootType: GraphQLObjectType, rootValue: unknown, originalGroupedFieldSet: GroupedFieldSet, serially: boolean, _newDeferUsages: ReadonlyArray<DeferUsage>): PromiseOrValue<ObjMap<unknown>>;
+    executeRootGroupedFieldSet(rootType: GraphQLObjectType, rootValue: unknown, groupedFieldSet: GroupedFieldSet, serially: boolean, positionContext?: TPositionContext): PromiseOrValue<ObjMap<unknown>>;
+    /**
+     * Implements the "Executing selection sets" section of the spec
+     * for fields that must be executed serially.
+     */
+    executeFieldsSerially(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, groupedFieldSet: GroupedFieldSet, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    /**
+     * Implements the "Executing selection sets" section of the spec
+     * for fields that may be executed in parallel.
+     */
+    executeFields(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, groupedFieldSet: GroupedFieldSet, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    /**
+     * Implements the "Executing fields" section of the spec
+     * In particular, this function figures out the value that the field returns by
+     * calling its resolve function, then calls completeValue to complete promises,
+     * coercing scalars, or execute the sub-selection-set for objects.
+     */
+    executeField(parentType: GraphQLObjectType, source: unknown, fieldDetailsList: FieldDetailsList, path: Path, positionContext: TPositionContext | undefined): PromiseOrValue<unknown>;
+    handleFieldError(rawError: unknown, returnType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, path: Path): void;
+    /**
+     * Implements the instructions for completeValue as defined in the
+     * "Value Completion" section of the spec.
+     *
+     * If the field type is Non-Null, then this recursively completes the value
+     * for the inner type. It throws a field error if that completion returns null,
+     * as per the "Nullability" section of the spec.
+     *
+     * If the field type is a List, then this recursively completes the value
+     * for the inner type on each item in the list.
+     *
+     * If the field type is a Scalar or Enum, ensures the completed value is a legal
+     * value of the type by calling the `coerceOutputValue` method of GraphQL type
+     * definition.
+     *
+     * If the field is an abstract type, determine the runtime type of the value
+     * and then complete based on that type
+     *
+     * Otherwise, the field type expects a sub-selection set, and will complete the
+     * value by executing all sub-selections.
+     */
+    completeValue(returnType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<unknown>;
+    completePromisedValue(returnType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: PromiseLike<unknown>, positionContext: TPositionContext | undefined): Promise<unknown>;
+    /**
+     * Complete a async iterator value by completing the result and calling
+     * recursively until all the results are completed.
+     */
+    completeAsyncIterableValue(itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, items: AsyncIterable<unknown>, positionContext: TPositionContext | undefined): Promise<ReadonlyArray<unknown>>;
+    handleStream(_index: number, _path: Path, _iterator: {
+        handle: Iterator<unknown>;
+        isAsync?: never;
+    } | {
+        handle: AsyncIterator<unknown>;
+        isAsync: true;
+    }, _streamUsage: StreamUsage, _info: GraphQLResolveInfo, _itemType: GraphQLOutputType): boolean;
+    /**
+     * Complete a list value by completing each item in the list with the
+     * inner type
+     */
+    completeListValue(returnType: GraphQLList<GraphQLOutputType>, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ReadonlyArray<unknown>>;
+    completeIterableValue(itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, items: Iterable<unknown>, positionContext: TPositionContext | undefined): PromiseOrValue<ReadonlyArray<unknown>>;
+    completeMaybePromisedListItemValue(item: unknown, completedResults: Array<unknown>, itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemPath: Path, positionContext: TPositionContext | undefined): boolean;
+    /**
+     * Complete a list item value by adding it to the completed results.
+     *
+     * Returns true if the value is a Promise.
+     */
+    completeListItemValue(item: unknown, completedResults: Array<unknown>, itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemPath: Path, positionContext: TPositionContext | undefined): boolean;
+    completePromisedListItemValue(item: PromiseLike<unknown>, itemType: GraphQLOutputType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, itemPath: Path, positionContext: TPositionContext | undefined): Promise<unknown>;
+    /**
+     * Complete a Scalar or Enum by serializing to a valid value, returning
+     * null if serialization is not possible.
+     */
+    completeLeafValue(returnType: GraphQLLeafType, result: unknown): unknown;
+    /**
+     * Complete a value of an abstract type by determining the runtime object type
+     * of that value, then complete the value for that type.
+     */
+    completeAbstractValue(returnType: GraphQLAbstractType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    ensureValidRuntimeType(runtimeTypeName: unknown, schema: GraphQLSchema, returnType: GraphQLAbstractType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, result: unknown): GraphQLObjectType;
+    /**
+     * Complete an Object value by executing all sub-selections.
+     */
+    completeObjectValue(returnType: GraphQLObjectType, fieldDetailsList: FieldDetailsList, info: GraphQLResolveInfo, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    invalidReturnTypeError(returnType: GraphQLObjectType, result: unknown, fieldDetailsList: FieldDetailsList): GraphQLError;
+    collectAndExecuteSubfields(returnType: GraphQLObjectType, fieldDetailsList: FieldDetailsList, path: Path, result: unknown, positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+    executeCollectedSubfields(parentType: GraphQLObjectType, sourceValue: unknown, path: Path | undefined, originalGroupedFieldSet: GroupedFieldSet, _newDeferUsages: ReadonlyArray<DeferUsage>, _positionContext: TPositionContext | undefined): PromiseOrValue<ObjMap<unknown>>;
+}
+export {};