@graphql-tools/executor 0.0.1-alpha-20221025014654-e3be5659

package/cjs/execution/execute.js

@@ -0,0 +1,792 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFieldDef = exports.createSourceEventStream = exports.subscribe = exports.defaultFieldResolver = exports.defaultTypeResolver = exports.buildResolveInfo = exports.buildExecutionContext = exports.assertValidExecutionArguments = exports.executeSync = exports.execute = void 0;
+const devAssert_js_1 = require("graphql/jsutils/devAssert.js");
+const inspect_js_1 = require("graphql/jsutils/inspect.js");
+const invariant_js_1 = require("graphql/jsutils/invariant.js");
+const isAsyncIterable_js_1 = require("graphql/jsutils/isAsyncIterable.js");
+const isIterableObject_js_1 = require("graphql/jsutils/isIterableObject.js");
+const isObjectLike_js_1 = require("graphql/jsutils/isObjectLike.js");
+const isPromise_js_1 = require("graphql/jsutils/isPromise.js");
+const memoize3_js_1 = require("graphql/jsutils/memoize3.js");
+const Path_js_1 = require("graphql/jsutils/Path.js");
+const promiseForObject_js_1 = require("graphql/jsutils/promiseForObject.js");
+const promiseReduce_js_1 = require("graphql/jsutils/promiseReduce.js");
+const graphql_1 = require("graphql");
+const collectFields_js_1 = require("./collectFields.js");
+const mapAsyncIterator_js_1 = require("./mapAsyncIterator.js");
+const values_js_1 = require("./values.js");
+// This file contains a lot of such errors but we plan to refactor it anyway
+// so just disable it for entire file.
+/**
+ * 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.
+ */
+const collectSubfields = (0, memoize3_js_1.memoize3)((exeContext, returnType, fieldNodes) => (0, collectFields_js_1.collectSubfields)(exeContext.schema, exeContext.fragments, exeContext.variableValues, returnType, fieldNodes));
+/**
+ * Implements the "Executing requests" section of the GraphQL specification.
+ *
+ * Returns either a synchronous ExecutionResult (if all encountered resolvers
+ * are synchronous), or a Promise of an ExecutionResult that will eventually be
+ * resolved and never rejected.
+ *
+ * If the arguments to this function do not result in a legal execution context,
+ * a GraphQLError will be thrown immediately explaining the invalid input.
+ */
+function execute(args) {
+    // If a valid execution context cannot be created due to incorrect arguments,
+    // a "Response" with only errors is returned.
+    const exeContext = buildExecutionContext(args);
+    // Return early errors if execution context failed.
+    if (!('schema' in exeContext)) {
+        return { errors: exeContext };
+    }
+    return executeImpl(exeContext);
+}
+exports.execute = execute;
+function executeImpl(exeContext) {
+    // Return a Promise that will eventually resolve to the data described by
+    // The "Response" section of the GraphQL specification.
+    //
+    // If errors are encountered while executing a GraphQL field, only that
+    // field and its descendants will be omitted, and sibling fields will still
+    // be executed. An execution which encounters errors will still result in a
+    // resolved Promise.
+    //
+    // Errors from sub-fields of a NonNull type may propagate to the top level,
+    // at which point we still log the error and null the parent field, which
+    // in this case is the entire response.
+    try {
+        const result = executeOperation(exeContext);
+        if ((0, isPromise_js_1.isPromise)(result)) {
+            return result.then(data => buildResponse(data, exeContext.errors), error => {
+                exeContext.errors.push(error);
+                return buildResponse(null, exeContext.errors);
+            });
+        }
+        return buildResponse(result, exeContext.errors);
+    }
+    catch (error) {
+        exeContext.errors.push(error);
+        return buildResponse(null, exeContext.errors);
+    }
+}
+/**
+ * Also implements the "Executing requests" section of the GraphQL specification.
+ * However, it guarantees to complete synchronously (or throw an error) assuming
+ * that all field resolvers are also synchronous.
+ */
+function executeSync(args) {
+    const result = execute(args);
+    // Assert that the execution was synchronous.
+    if ((0, isPromise_js_1.isPromise)(result)) {
+        throw new Error('GraphQL execution failed to complete synchronously.');
+    }
+    return result;
+}
+exports.executeSync = executeSync;
+/**
+ * Given a completed execution context and data, build the `{ errors, data }`
+ * response defined by the "Response" section of the GraphQL specification.
+ */
+function buildResponse(data, errors) {
+    return errors.length === 0 ? { data } : { errors, data };
+}
+/**
+ * Essential assertions before executing to provide developer feedback for
+ * improper use of the GraphQL library.
+ *
+ * @internal
+ */
+function assertValidExecutionArguments(schema, document, rawVariableValues) {
+    (0, devAssert_js_1.devAssert)(!!document, 'Must provide document.');
+    // If the schema used for execution is invalid, throw an error.
+    (0, graphql_1.assertValidSchema)(schema);
+    // Variables, if provided, must be an object.
+    (0, devAssert_js_1.devAssert)(rawVariableValues == null || (0, isObjectLike_js_1.isObjectLike)(rawVariableValues), 'Variables must be provided as an Object where each property is a variable value. Perhaps look to see if an unparsed JSON string was provided.');
+}
+exports.assertValidExecutionArguments = assertValidExecutionArguments;
+/**
+ * Constructs a ExecutionContext object from the arguments passed to
+ * execute, which we will pass throughout the other execution methods.
+ *
+ * Throws a GraphQLError if a valid execution context cannot be created.
+ *
+ * TODO: consider no longer exporting this function
+ * @internal
+ */
+function buildExecutionContext(args) {
+    var _a, _b;
+    const { schema, document, rootValue, contextValue, variableValues: rawVariableValues, operationName, fieldResolver, typeResolver, subscribeFieldResolver, } = args;
+    // If the schema used for execution is invalid, throw an error.
+    (0, graphql_1.assertValidSchema)(schema);
+    let operation;
+    const fragments = Object.create(null);
+    for (const definition of document.definitions) {
+        switch (definition.kind) {
+            case graphql_1.Kind.OPERATION_DEFINITION:
+                if (operationName == null) {
+                    if (operation !== undefined) {
+                        return [new graphql_1.GraphQLError('Must provide operation name if query contains multiple operations.')];
+                    }
+                    operation = definition;
+                }
+                else if (((_a = definition.name) === null || _a === void 0 ? void 0 : _a.value) === operationName) {
+                    operation = definition;
+                }
+                break;
+            case graphql_1.Kind.FRAGMENT_DEFINITION:
+                fragments[definition.name.value] = definition;
+                break;
+            default:
+            // ignore non-executable definitions
+        }
+    }
+    if (!operation) {
+        if (operationName != null) {
+            return [new graphql_1.GraphQLError(`Unknown operation named "${operationName}".`)];
+        }
+        return [new graphql_1.GraphQLError('Must provide an operation.')];
+    }
+    // FIXME: https://github.com/graphql/graphql-js/issues/2203
+    /* c8 ignore next */
+    const variableDefinitions = (_b = operation.variableDefinitions) !== null && _b !== void 0 ? _b : [];
+    const coercedVariableValues = (0, values_js_1.getVariableValues)(schema, variableDefinitions, rawVariableValues !== null && rawVariableValues !== void 0 ? rawVariableValues : {}, {
+        maxErrors: 50,
+    });
+    if (coercedVariableValues.errors) {
+        return coercedVariableValues.errors;
+    }
+    return {
+        schema,
+        fragments,
+        rootValue,
+        contextValue,
+        operation,
+        variableValues: coercedVariableValues.coerced,
+        fieldResolver: fieldResolver !== null && fieldResolver !== void 0 ? fieldResolver : exports.defaultFieldResolver,
+        typeResolver: typeResolver !== null && typeResolver !== void 0 ? typeResolver : exports.defaultTypeResolver,
+        subscribeFieldResolver: subscribeFieldResolver !== null && subscribeFieldResolver !== void 0 ? subscribeFieldResolver : exports.defaultFieldResolver,
+        errors: [],
+    };
+}
+exports.buildExecutionContext = buildExecutionContext;
+function buildPerEventExecutionContext(exeContext, payload) {
+    return {
+        ...exeContext,
+        rootValue: payload,
+        errors: [],
+    };
+}
+/**
+ * Implements the "Executing operations" section of the spec.
+ */
+function executeOperation(exeContext) {
+    const { operation, schema, fragments, variableValues, rootValue } = exeContext;
+    const rootType = schema.getRootType(operation.operation);
+    if (rootType == null) {
+        throw new graphql_1.GraphQLError(`Schema is not configured to execute ${operation.operation} operation.`, {
+            nodes: operation,
+        });
+    }
+    const rootFields = (0, collectFields_js_1.collectFields)(schema, fragments, variableValues, rootType, operation.selectionSet);
+    const path = undefined;
+    switch (operation.operation) {
+        case graphql_1.OperationTypeNode.QUERY:
+            return executeFields(exeContext, rootType, rootValue, path, rootFields);
+        case graphql_1.OperationTypeNode.MUTATION:
+            return executeFieldsSerially(exeContext, rootType, rootValue, path, rootFields);
+        case graphql_1.OperationTypeNode.SUBSCRIPTION:
+            // TODO: deprecate `subscribe` and move all logic here
+            // Temporary solution until we finish merging execute and subscribe together
+            return executeFields(exeContext, rootType, rootValue, path, rootFields);
+    }
+}
+/**
+ * Implements the "Executing selection sets" section of the spec
+ * for fields that must be executed serially.
+ */
+function executeFieldsSerially(exeContext, parentType, sourceValue, path, fields) {
+    return (0, promiseReduce_js_1.promiseReduce)(fields.entries(), (results, [responseName, fieldNodes]) => {
+        const fieldPath = (0, Path_js_1.addPath)(path, responseName, parentType.name);
+        const result = executeField(exeContext, parentType, sourceValue, fieldNodes, fieldPath);
+        if (result === undefined) {
+            return results;
+        }
+        if ((0, isPromise_js_1.isPromise)(result)) {
+            return result.then(resolvedResult => {
+                results[responseName] = resolvedResult;
+                return results;
+            });
+        }
+        results[responseName] = result;
+        return results;
+    }, Object.create(null));
+}
+/**
+ * Implements the "Executing selection sets" section of the spec
+ * for fields that may be executed in parallel.
+ */
+function executeFields(exeContext, parentType, sourceValue, path, fields) {
+    const results = Object.create(null);
+    let containsPromise = false;
+    for (const [responseName, fieldNodes] of fields.entries()) {
+        const fieldPath = (0, Path_js_1.addPath)(path, responseName, parentType.name);
+        const result = executeField(exeContext, parentType, sourceValue, fieldNodes, fieldPath);
+        if (result !== undefined) {
+            results[responseName] = result;
+            if ((0, isPromise_js_1.isPromise)(result)) {
+                containsPromise = true;
+            }
+        }
+    }
+    // If there are no promises, we can just return the object
+    if (!containsPromise) {
+        return results;
+    }
+    // Otherwise, results is a map from field name to the result of resolving that
+    // field, which is possibly a promise. Return a promise that will return this
+    // same map, but with any promises replaced with the values they resolved to.
+    return (0, promiseForObject_js_1.promiseForObject)(results);
+}
+/**
+ * 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,
+ * serialize scalars, or execute the sub-selection-set for objects.
+ */
+function executeField(exeContext, parentType, source, fieldNodes, path) {
+    var _a;
+    const fieldDef = getFieldDef(exeContext.schema, parentType, fieldNodes[0]);
+    if (!fieldDef) {
+        return;
+    }
+    const returnType = fieldDef.type;
+    const resolveFn = (_a = fieldDef.resolve) !== null && _a !== void 0 ? _a : exeContext.fieldResolver;
+    const info = buildResolveInfo(exeContext, fieldDef, fieldNodes, parentType, path);
+    // Get the resolve function, regardless of if its result is normal or abrupt (error).
+    try {
+        // Build a JS object of arguments from the field.arguments AST, using the
+        // variables scope to fulfill any variable references.
+        // TODO: find a way to memoize, in case this field is within a List type.
+        const args = (0, values_js_1.getArgumentValues)(fieldDef, fieldNodes[0], exeContext.variableValues);
+        // The resolve function's optional third argument is a context value that
+        // is provided to every resolve function within an execution. It is commonly
+        // used to represent an authenticated user, or request-specific caches.
+        const contextValue = exeContext.contextValue;
+        const result = resolveFn(source, args, contextValue, info);
+        let completed;
+        if ((0, isPromise_js_1.isPromise)(result)) {
+            completed = result.then(resolved => completeValue(exeContext, returnType, fieldNodes, info, path, resolved));
+        }
+        else {
+            completed = completeValue(exeContext, returnType, fieldNodes, info, path, result);
+        }
+        if ((0, isPromise_js_1.isPromise)(completed)) {
+            // Note: we don't rely on a `catch` method, but we do expect "thenable"
+            // to take a second callback for the error case.
+            return completed.then(undefined, rawError => {
+                const error = (0, graphql_1.locatedError)(rawError, fieldNodes, (0, Path_js_1.pathToArray)(path));
+                return handleFieldError(error, returnType, exeContext);
+            });
+        }
+        return completed;
+    }
+    catch (rawError) {
+        const error = (0, graphql_1.locatedError)(rawError, fieldNodes, (0, Path_js_1.pathToArray)(path));
+        return handleFieldError(error, returnType, exeContext);
+    }
+}
+/**
+ * TODO: consider no longer exporting this function
+ * @internal
+ */
+function buildResolveInfo(exeContext, fieldDef, fieldNodes, parentType, path) {
+    // The resolve function's optional fourth argument is a collection of
+    // information about the current execution state.
+    return {
+        fieldName: fieldDef.name,
+        fieldNodes,
+        returnType: fieldDef.type,
+        parentType,
+        path,
+        schema: exeContext.schema,
+        fragments: exeContext.fragments,
+        rootValue: exeContext.rootValue,
+        operation: exeContext.operation,
+        variableValues: exeContext.variableValues,
+    };
+}
+exports.buildResolveInfo = buildResolveInfo;
+function handleFieldError(error, returnType, exeContext) {
+    // If the field type is non-nullable, then it is resolved without any
+    // protection from errors, however it still properly locates the error.
+    if ((0, graphql_1.isNonNullType)(returnType)) {
+        throw error;
+    }
+    // Otherwise, error protection is applied, logging the error and resolving
+    // a null value for this field if one is encountered.
+    exeContext.errors.push(error);
+    return null;
+}
+/**
+ * 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 `serialize` 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.
+ */
+function completeValue(exeContext, returnType, fieldNodes, info, path, result) {
+    // If result is an Error, throw a located error.
+    if (result instanceof Error) {
+        throw result;
+    }
+    // If field type is NonNull, complete for inner type, and throw field error
+    // if result is null.
+    if ((0, graphql_1.isNonNullType)(returnType)) {
+        const completed = completeValue(exeContext, returnType.ofType, fieldNodes, info, path, result);
+        if (completed === null) {
+            throw new Error(`Cannot return null for non-nullable field ${info.parentType.name}.${info.fieldName}.`);
+        }
+        return completed;
+    }
+    // If result value is null or undefined then return null.
+    if (result == null) {
+        return null;
+    }
+    // If field type is List, complete each item in the list with the inner type
+    if ((0, graphql_1.isListType)(returnType)) {
+        return completeListValue(exeContext, returnType, fieldNodes, info, path, result);
+    }
+    // If field type is a leaf type, Scalar or Enum, serialize to a valid value,
+    // returning null if serialization is not possible.
+    if ((0, graphql_1.isLeafType)(returnType)) {
+        return completeLeafValue(returnType, result);
+    }
+    // If field type is an abstract type, Interface or Union, determine the
+    // runtime Object type and complete for that type.
+    if ((0, graphql_1.isAbstractType)(returnType)) {
+        return completeAbstractValue(exeContext, returnType, fieldNodes, info, path, result);
+    }
+    // If field type is Object, execute and complete all sub-selections.
+    if ((0, graphql_1.isObjectType)(returnType)) {
+        return completeObjectValue(exeContext, returnType, fieldNodes, info, path, result);
+    }
+    /* c8 ignore next 6 */
+    // Not reachable, all possible output types have been considered.
+    (0, invariant_js_1.invariant)(false, 'Cannot complete value of unexpected output type: ' + (0, inspect_js_1.inspect)(returnType));
+}
+/**
+ * Complete a async iterator value by completing the result and calling
+ * recursively until all the results are completed.
+ */
+async function completeAsyncIteratorValue(exeContext, itemType, fieldNodes, info, path, iterator) {
+    let containsPromise = false;
+    const completedResults = [];
+    let index = 0;
+    while (true) {
+        const fieldPath = (0, Path_js_1.addPath)(path, index, undefined);
+        try {
+            const { value, done } = await iterator.next();
+            if (done) {
+                break;
+            }
+            try {
+                // TODO can the error checking logic be consolidated with completeListValue?
+                const completedItem = completeValue(exeContext, itemType, fieldNodes, info, fieldPath, value);
+                if ((0, isPromise_js_1.isPromise)(completedItem)) {
+                    containsPromise = true;
+                }
+                completedResults.push(completedItem);
+            }
+            catch (rawError) {
+                completedResults.push(null);
+                const error = (0, graphql_1.locatedError)(rawError, fieldNodes, (0, Path_js_1.pathToArray)(fieldPath));
+                handleFieldError(error, itemType, exeContext);
+            }
+        }
+        catch (rawError) {
+            completedResults.push(null);
+            const error = (0, graphql_1.locatedError)(rawError, fieldNodes, (0, Path_js_1.pathToArray)(fieldPath));
+            handleFieldError(error, itemType, exeContext);
+            break;
+        }
+        index += 1;
+    }
+    return containsPromise ? Promise.all(completedResults) : completedResults;
+}
+/**
+ * Complete a list value by completing each item in the list with the
+ * inner type
+ */
+function completeListValue(exeContext, returnType, fieldNodes, info, path, result) {
+    const itemType = returnType.ofType;
+    if ((0, isAsyncIterable_js_1.isAsyncIterable)(result)) {
+        const iterator = result[Symbol.asyncIterator]();
+        return completeAsyncIteratorValue(exeContext, itemType, fieldNodes, info, path, iterator);
+    }
+    if (!(0, isIterableObject_js_1.isIterableObject)(result)) {
+        throw new graphql_1.GraphQLError(`Expected Iterable, but did not find one for field "${info.parentType.name}.${info.fieldName}".`);
+    }
+    // This is specified as a simple map, however we're optimizing the path
+    // where the list contains no Promises by avoiding creating another Promise.
+    let containsPromise = false;
+    const completedResults = Array.from(result, (item, index) => {
+        // No need to modify the info object containing the path,
+        // since from here on it is not ever accessed by resolver functions.
+        const itemPath = (0, Path_js_1.addPath)(path, index, undefined);
+        try {
+            let completedItem;
+            if ((0, isPromise_js_1.isPromise)(item)) {
+                completedItem = item.then(resolved => completeValue(exeContext, itemType, fieldNodes, info, itemPath, resolved));
+            }
+            else {
+                completedItem = completeValue(exeContext, itemType, fieldNodes, info, itemPath, item);
+            }
+            if ((0, isPromise_js_1.isPromise)(completedItem)) {
+                containsPromise = true;
+                // Note: we don't rely on a `catch` method, but we do expect "thenable"
+                // to take a second callback for the error case.
+                return completedItem.then(undefined, rawError => {
+                    const error = (0, graphql_1.locatedError)(rawError, fieldNodes, (0, Path_js_1.pathToArray)(itemPath));
+                    return handleFieldError(error, itemType, exeContext);
+                });
+            }
+            return completedItem;
+        }
+        catch (rawError) {
+            const error = (0, graphql_1.locatedError)(rawError, fieldNodes, (0, Path_js_1.pathToArray)(itemPath));
+            return handleFieldError(error, itemType, exeContext);
+        }
+    });
+    return containsPromise ? Promise.all(completedResults) : completedResults;
+}
+/**
+ * Complete a Scalar or Enum by serializing to a valid value, returning
+ * null if serialization is not possible.
+ */
+function completeLeafValue(returnType, result) {
+    const serializedResult = returnType.serialize(result);
+    if (serializedResult == null) {
+        throw new Error(`Expected \`${(0, inspect_js_1.inspect)(returnType)}.serialize(${(0, inspect_js_1.inspect)(result)})\` to ` +
+            `return non-nullable value, returned: ${(0, inspect_js_1.inspect)(serializedResult)}`);
+    }
+    return serializedResult;
+}
+/**
+ * Complete a value of an abstract type by determining the runtime object type
+ * of that value, then complete the value for that type.
+ */
+function completeAbstractValue(exeContext, returnType, fieldNodes, info, path, result) {
+    var _a;
+    const resolveTypeFn = (_a = returnType.resolveType) !== null && _a !== void 0 ? _a : exeContext.typeResolver;
+    const contextValue = exeContext.contextValue;
+    const runtimeType = resolveTypeFn(result, contextValue, info, returnType);
+    if ((0, isPromise_js_1.isPromise)(runtimeType)) {
+        return runtimeType.then(resolvedRuntimeType => completeObjectValue(exeContext, ensureValidRuntimeType(resolvedRuntimeType, exeContext, returnType, fieldNodes, info, result), fieldNodes, info, path, result));
+    }
+    return completeObjectValue(exeContext, ensureValidRuntimeType(runtimeType, exeContext, returnType, fieldNodes, info, result), fieldNodes, info, path, result);
+}
+function ensureValidRuntimeType(runtimeTypeName, exeContext, returnType, fieldNodes, info, result) {
+    if (runtimeTypeName == null) {
+        throw new graphql_1.GraphQLError(`Abstract type "${returnType.name}" must resolve to an Object type at runtime for field "${info.parentType.name}.${info.fieldName}". Either the "${returnType.name}" type should provide a "resolveType" function or each possible type should provide an "isTypeOf" function.`, { nodes: fieldNodes });
+    }
+    // releases before 16.0.0 supported returning `GraphQLObjectType` from `resolveType`
+    // TODO: remove in 17.0.0 release
+    if ((0, graphql_1.isObjectType)(runtimeTypeName)) {
+        throw new graphql_1.GraphQLError('Support for returning GraphQLObjectType from resolveType was removed in graphql-js@16.0.0 please return type name instead.');
+    }
+    if (typeof runtimeTypeName !== 'string') {
+        throw new graphql_1.GraphQLError(`Abstract type "${returnType.name}" must resolve to an Object type at runtime for field "${info.parentType.name}.${info.fieldName}" with ` +
+            `value ${(0, inspect_js_1.inspect)(result)}, received "${(0, inspect_js_1.inspect)(runtimeTypeName)}".`);
+    }
+    const runtimeType = exeContext.schema.getType(runtimeTypeName);
+    if (runtimeType == null) {
+        throw new graphql_1.GraphQLError(`Abstract type "${returnType.name}" was resolved to a type "${runtimeTypeName}" that does not exist inside the schema.`, { nodes: fieldNodes });
+    }
+    if (!(0, graphql_1.isObjectType)(runtimeType)) {
+        throw new graphql_1.GraphQLError(`Abstract type "${returnType.name}" was resolved to a non-object type "${runtimeTypeName}".`, { nodes: fieldNodes });
+    }
+    if (!exeContext.schema.isSubType(returnType, runtimeType)) {
+        throw new graphql_1.GraphQLError(`Runtime Object type "${runtimeType.name}" is not a possible type for "${returnType.name}".`, { nodes: fieldNodes });
+    }
+    return runtimeType;
+}
+/**
+ * Complete an Object value by executing all sub-selections.
+ */
+function completeObjectValue(exeContext, returnType, fieldNodes, info, path, result) {
+    // Collect sub-fields to execute to complete this value.
+    const subFieldNodes = collectSubfields(exeContext, returnType, fieldNodes);
+    // If there is an isTypeOf predicate function, call it with the
+    // current result. If isTypeOf returns false, then raise an error rather
+    // than continuing execution.
+    if (returnType.isTypeOf) {
+        const isTypeOf = returnType.isTypeOf(result, exeContext.contextValue, info);
+        if ((0, isPromise_js_1.isPromise)(isTypeOf)) {
+            return isTypeOf.then(resolvedIsTypeOf => {
+                if (!resolvedIsTypeOf) {
+                    throw invalidReturnTypeError(returnType, result, fieldNodes);
+                }
+                return executeFields(exeContext, returnType, result, path, subFieldNodes);
+            });
+        }
+        if (!isTypeOf) {
+            throw invalidReturnTypeError(returnType, result, fieldNodes);
+        }
+    }
+    return executeFields(exeContext, returnType, result, path, subFieldNodes);
+}
+function invalidReturnTypeError(returnType, result, fieldNodes) {
+    return new graphql_1.GraphQLError(`Expected value of type "${returnType.name}" but got: ${(0, inspect_js_1.inspect)(result)}.`, {
+        nodes: fieldNodes,
+    });
+}
+/**
+ * If a resolveType function is not given, then a default resolve behavior is
+ * used which attempts two strategies:
+ *
+ * First, See if the provided value has a `__typename` field defined, if so, use
+ * that value as name of the resolved type.
+ *
+ * Otherwise, test each possible type for the abstract type by calling
+ * isTypeOf for the object being coerced, returning the first type that matches.
+ */
+const defaultTypeResolver = function (value, contextValue, info, abstractType) {
+    // First, look for `__typename`.
+    if ((0, isObjectLike_js_1.isObjectLike)(value) && typeof value['__typename'] === 'string') {
+        return value['__typename'];
+    }
+    // Otherwise, test each possible type.
+    const possibleTypes = info.schema.getPossibleTypes(abstractType);
+    const promisedIsTypeOfResults = [];
+    for (let i = 0; i < possibleTypes.length; i++) {
+        const type = possibleTypes[i];
+        if (type.isTypeOf) {
+            const isTypeOfResult = type.isTypeOf(value, contextValue, info);
+            if ((0, isPromise_js_1.isPromise)(isTypeOfResult)) {
+                promisedIsTypeOfResults[i] = isTypeOfResult;
+            }
+            else if (isTypeOfResult) {
+                return type.name;
+            }
+        }
+    }
+    if (promisedIsTypeOfResults.length) {
+        return Promise.all(promisedIsTypeOfResults).then(isTypeOfResults => {
+            for (let i = 0; i < isTypeOfResults.length; i++) {
+                if (isTypeOfResults[i]) {
+                    return possibleTypes[i].name;
+                }
+            }
+        });
+    }
+};
+exports.defaultTypeResolver = defaultTypeResolver;
+/**
+ * If a resolve function is not given, then a default resolve behavior is used
+ * which takes the property of the source object of the same name as the field
+ * and returns it as the result, or if it's a function, returns the result
+ * of calling that function while passing along args and context value.
+ */
+const defaultFieldResolver = function (source, args, contextValue, info) {
+    // ensure source is a value for which property access is acceptable.
+    if ((0, isObjectLike_js_1.isObjectLike)(source) || typeof source === 'function') {
+        const property = source[info.fieldName];
+        if (typeof property === 'function') {
+            return source[info.fieldName](args, contextValue, info);
+        }
+        return property;
+    }
+};
+exports.defaultFieldResolver = defaultFieldResolver;
+/**
+ * Implements the "Subscribe" algorithm described in the GraphQL specification.
+ *
+ * Returns a Promise which resolves to either an AsyncIterator (if successful)
+ * or an ExecutionResult (error). The promise will be rejected if the schema or
+ * other arguments to this function are invalid, or if the resolved event stream
+ * is not an async iterable.
+ *
+ * If the client-provided arguments to this function do not result in a
+ * compliant subscription, a GraphQL Response (ExecutionResult) with
+ * descriptive errors and no data will be returned.
+ *
+ * If the source stream could not be created due to faulty subscription
+ * resolver logic or underlying systems, the promise will resolve to a single
+ * ExecutionResult containing `errors` and no `data`.
+ *
+ * If the operation succeeded, the promise resolves to an AsyncIterator, which
+ * yields a stream of ExecutionResults representing the response stream.
+ *
+ * Accepts either an object with named arguments, or individual arguments.
+ */
+function subscribe(args) {
+    // If a valid execution context cannot be created due to incorrect arguments,
+    // a "Response" with only errors is returned.
+    const exeContext = buildExecutionContext(args);
+    // Return early errors if execution context failed.
+    if (!('schema' in exeContext)) {
+        return { errors: exeContext };
+    }
+    const resultOrStream = createSourceEventStreamImpl(exeContext);
+    if ((0, isPromise_js_1.isPromise)(resultOrStream)) {
+        return resultOrStream.then(resolvedResultOrStream => mapSourceToResponse(exeContext, resolvedResultOrStream));
+    }
+    return mapSourceToResponse(exeContext, resultOrStream);
+}
+exports.subscribe = subscribe;
+function mapSourceToResponse(exeContext, resultOrStream) {
+    if (!(0, isAsyncIterable_js_1.isAsyncIterable)(resultOrStream)) {
+        return resultOrStream;
+    }
+    // For each payload yielded from a subscription, map it over the normal
+    // GraphQL `execute` function, with `payload` as the rootValue.
+    // This implements the "MapSourceToResponseEvent" algorithm described in
+    // the GraphQL specification. The `execute` function provides the
+    // "ExecuteSubscriptionEvent" algorithm, as it is nearly identical to the
+    // "ExecuteQuery" algorithm, for which `execute` is also used.
+    return (0, mapAsyncIterator_js_1.mapAsyncIterator)(resultOrStream, (payload) => executeImpl(buildPerEventExecutionContext(exeContext, payload)));
+}
+/**
+ * Implements the "CreateSourceEventStream" algorithm described in the
+ * GraphQL specification, resolving the subscription source event stream.
+ *
+ * Returns a Promise which resolves to either an AsyncIterable (if successful)
+ * or an ExecutionResult (error). The promise will be rejected if the schema or
+ * other arguments to this function are invalid, or if the resolved event stream
+ * is not an async iterable.
+ *
+ * If the client-provided arguments to this function do not result in a
+ * compliant subscription, a GraphQL Response (ExecutionResult) with
+ * descriptive errors and no data will be returned.
+ *
+ * If the the source stream could not be created due to faulty subscription
+ * resolver logic or underlying systems, the promise will resolve to a single
+ * ExecutionResult containing `errors` and no `data`.
+ *
+ * If the operation succeeded, the promise resolves to the AsyncIterable for the
+ * event stream returned by the resolver.
+ *
+ * A Source Event Stream represents a sequence of events, each of which triggers
+ * a GraphQL execution for that event.
+ *
+ * This may be useful when hosting the stateful subscription service in a
+ * different process or machine than the stateless GraphQL execution engine,
+ * or otherwise separating these two steps. For more on this, see the
+ * "Supporting Subscriptions at Scale" information in the GraphQL specification.
+ */
+function createSourceEventStream(args) {
+    // If a valid execution context cannot be created due to incorrect arguments,
+    // a "Response" with only errors is returned.
+    const exeContext = buildExecutionContext(args);
+    // Return early errors if execution context failed.
+    if (!('schema' in exeContext)) {
+        return { errors: exeContext };
+    }
+    return createSourceEventStreamImpl(exeContext);
+}
+exports.createSourceEventStream = createSourceEventStream;
+function createSourceEventStreamImpl(exeContext) {
+    try {
+        const eventStream = executeSubscription(exeContext);
+        if ((0, isPromise_js_1.isPromise)(eventStream)) {
+            return eventStream.then(undefined, error => ({ errors: [error] }));
+        }
+        return eventStream;
+    }
+    catch (error) {
+        return { errors: [error] };
+    }
+}
+function executeSubscription(exeContext) {
+    var _a;
+    const { schema, fragments, operation, variableValues, rootValue } = exeContext;
+    const rootType = schema.getSubscriptionType();
+    if (rootType == null) {
+        throw new graphql_1.GraphQLError('Schema is not configured to execute subscription operation.', { nodes: operation });
+    }
+    const rootFields = (0, collectFields_js_1.collectFields)(schema, fragments, variableValues, rootType, operation.selectionSet);
+    const [responseName, fieldNodes] = [...rootFields.entries()][0];
+    const fieldName = fieldNodes[0].name.value;
+    const fieldDef = getFieldDef(schema, rootType, fieldNodes[0]);
+    if (!fieldDef) {
+        throw new graphql_1.GraphQLError(`The subscription field "${fieldName}" is not defined.`, { nodes: fieldNodes });
+    }
+    const path = (0, Path_js_1.addPath)(undefined, responseName, rootType.name);
+    const info = buildResolveInfo(exeContext, fieldDef, fieldNodes, rootType, path);
+    try {
+        // Implements the "ResolveFieldEventStream" algorithm from GraphQL specification.
+        // It differs from "ResolveFieldValue" due to providing a different `resolveFn`.
+        // Build a JS object of arguments from the field.arguments AST, using the
+        // variables scope to fulfill any variable references.
+        const args = (0, values_js_1.getArgumentValues)(fieldDef, fieldNodes[0], variableValues);
+        // The resolve function's optional third argument is a context value that
+        // is provided to every resolve function within an execution. It is commonly
+        // used to represent an authenticated user, or request-specific caches.
+        const contextValue = exeContext.contextValue;
+        // Call the `subscribe()` resolver or the default resolver to produce an
+        // AsyncIterable yielding raw payloads.
+        const resolveFn = (_a = fieldDef.subscribe) !== null && _a !== void 0 ? _a : exeContext.subscribeFieldResolver;
+        const result = resolveFn(rootValue, args, contextValue, info);
+        if ((0, isPromise_js_1.isPromise)(result)) {
+            return result.then(assertEventStream).then(undefined, error => {
+                throw (0, graphql_1.locatedError)(error, fieldNodes, (0, Path_js_1.pathToArray)(path));
+            });
+        }
+        return assertEventStream(result);
+    }
+    catch (error) {
+        throw (0, graphql_1.locatedError)(error, fieldNodes, (0, Path_js_1.pathToArray)(path));
+    }
+}
+function assertEventStream(result) {
+    if (result instanceof Error) {
+        throw result;
+    }
+    // Assert field returned an event stream, otherwise yield an error.
+    if (!(0, isAsyncIterable_js_1.isAsyncIterable)(result)) {
+        throw new graphql_1.GraphQLError('Subscription field must return Async Iterable. ' + `Received: ${(0, inspect_js_1.inspect)(result)}.`);
+    }
+    return result;
+}
+/**
+ * This method looks up the field on the given type definition.
+ * It has special casing for the three introspection fields,
+ * __schema, __type and __typename. __typename is special because
+ * it can always be queried as a field, even in situations where no
+ * other fields are allowed, like on a Union. __schema and __type
+ * could get automatically added to the query type, but that would
+ * require mutating type definitions, which would cause issues.
+ *
+ * @internal
+ */
+function getFieldDef(schema, parentType, fieldNode) {
+    const fieldName = fieldNode.name.value;
+    if (fieldName === graphql_1.SchemaMetaFieldDef.name && schema.getQueryType() === parentType) {
+        return graphql_1.SchemaMetaFieldDef;
+    }
+    else if (fieldName === graphql_1.TypeMetaFieldDef.name && schema.getQueryType() === parentType) {
+        return graphql_1.TypeMetaFieldDef;
+    }
+    else if (fieldName === graphql_1.TypeNameMetaFieldDef.name) {
+        return graphql_1.TypeNameMetaFieldDef;
+    }
+    return parentType.getFields()[fieldName];
+}
+exports.getFieldDef = getFieldDef;