@graphql-tools/executor 0.0.1 → 0.0.2-alpha-20221029152711-14f4f7a7

package/typings/execution/execute.d.ts

@@ -1,5 +1,6 @@
-import { GraphQLFormattedError, GraphQLError, FieldNode, FragmentDefinitionNode, OperationDefinitionNode, GraphQLField, GraphQLFieldResolver, GraphQLObjectType, GraphQLResolveInfo, GraphQLTypeResolver, GraphQLSchema } from 'graphql';
-import { Maybe, Path, MaybePromise, ExecutionResult } from '@graphql-tools/utils';
+import { GraphQLFormattedError, FieldNode, FragmentDefinitionNode, OperationDefinitionNode, GraphQLField, GraphQLFieldResolver, GraphQLObjectType, GraphQLResolveInfo, GraphQLTypeResolver, GraphQLSchema } from 'graphql';
+import type { GraphQLError } from 'graphql';
+import { Path, Maybe, MaybePromise, ExecutionResult } from '@graphql-tools/utils';
 import { TypedDocumentNode } from '@graphql-typed-document-node/core';
 /**
  * Terminology
@@ -26,25 +27,72 @@ import { TypedDocumentNode } from '@graphql-typed-document-node/core';
  * Namely, schema of the type system that is currently executing,
  * and the fragments defined in the query document
  */
-export interface ExecutionContext<TContext = any> {
+export interface ExecutionContext<TVariables = any, TContext = any> {
     schema: GraphQLSchema;
     fragments: Record<string, FragmentDefinitionNode>;
     rootValue: unknown;
     contextValue: TContext;
     operation: OperationDefinitionNode;
-    variableValues: {
-        [variable: string]: unknown;
-    };
+    variableValues: TVariables;
     fieldResolver: GraphQLFieldResolver<any, TContext>;
     typeResolver: GraphQLTypeResolver<any, TContext>;
     subscribeFieldResolver: GraphQLFieldResolver<any, TContext>;
     errors: Array<GraphQLError>;
+    subsequentPayloads: Set<AsyncPayloadRecord>;
 }
-export interface FormattedExecutionResult<TData = any, TExtensions = any> {
+export interface FormattedExecutionResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> {
     errors?: ReadonlyArray<GraphQLFormattedError>;
     data?: TData | null;
     extensions?: TExtensions;
 }
+export interface ExperimentalIncrementalExecutionResults<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> {
+    initialResult: InitialIncrementalExecutionResult<TData, TExtensions>;
+    subsequentResults: AsyncGenerator<SubsequentIncrementalExecutionResult<TData, TExtensions>, void, void>;
+}
+export interface InitialIncrementalExecutionResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> extends ExecutionResult<TData, TExtensions> {
+    hasNext: boolean;
+    incremental?: ReadonlyArray<IncrementalResult<TData, TExtensions>>;
+    extensions?: TExtensions;
+}
+export interface FormattedInitialIncrementalExecutionResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> extends FormattedExecutionResult<TData, TExtensions> {
+    hasNext: boolean;
+    incremental?: ReadonlyArray<FormattedIncrementalResult<TData, TExtensions>>;
+    extensions?: TExtensions;
+}
+export interface SubsequentIncrementalExecutionResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> {
+    hasNext: boolean;
+    incremental?: ReadonlyArray<IncrementalResult<TData, TExtensions>>;
+    extensions?: TExtensions;
+}
+export interface FormattedSubsequentIncrementalExecutionResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> {
+    hasNext: boolean;
+    incremental?: ReadonlyArray<FormattedIncrementalResult<TData, TExtensions>>;
+    extensions?: TExtensions;
+}
+export interface IncrementalDeferResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> extends ExecutionResult<TData, TExtensions> {
+    path?: ReadonlyArray<string | number>;
+    label?: string;
+}
+export interface FormattedIncrementalDeferResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> extends FormattedExecutionResult<TData, TExtensions> {
+    path?: ReadonlyArray<string | number>;
+    label?: string;
+}
+export interface IncrementalStreamResult<TData = Array<unknown>, TExtensions = Record<string, unknown>> {
+    errors?: ReadonlyArray<GraphQLError>;
+    items?: TData | null;
+    path?: ReadonlyArray<string | number>;
+    label?: string;
+    extensions?: TExtensions;
+}
+export interface FormattedIncrementalStreamResult<TData = Array<unknown>, TExtensions = Record<string, unknown>> {
+    errors?: ReadonlyArray<GraphQLFormattedError>;
+    items?: TData | null;
+    path?: ReadonlyArray<string | number>;
+    label?: string;
+    extensions?: TExtensions;
+}
+export declare type IncrementalResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> = IncrementalDeferResult<TData, TExtensions> | IncrementalStreamResult<TData, TExtensions>;
+export declare type FormattedIncrementalResult<TData = Record<string, unknown>, TExtensions = Record<string, unknown>> = FormattedIncrementalDeferResult<TData, TExtensions> | FormattedIncrementalStreamResult<TData, TExtensions>;
 export interface ExecutionArgs<TData = any, TVariables = any, TContext = any> {
     schema: GraphQLSchema;
     document: TypedDocumentNode<TData, TVariables>;
@@ -65,12 +113,27 @@ export interface ExecutionArgs<TData = any, TVariables = any, TContext = any> {
  *
  * If the arguments to this function do not result in a legal execution context,
  * a GraphQLError will be thrown immediately explaining the invalid input.
+ *
+ * This function does not support incremental delivery (`@defer` and `@stream`).
+ * If an operation which would defer or stream data is executed with this
+ * function, it will throw or resolve to an object containing an error instead.
+ * Use `experimentalExecuteIncrementally` if you want to support incremental
+ * delivery.
+ */
+export declare function execute<TData = any, TVariables = any, TContext = any>(args: ExecutionArgs<TData, TVariables, TContext>): MaybePromise<ExecutionResult<TData>>;
+/**
+ * Implements the "Executing requests" section of the GraphQL specification,
+ * including `@defer` and `@stream` as proposed in
+ * https://github.com/graphql/graphql-spec/pull/742
+ *
+ * This function returns a Promise of an ExperimentalIncrementalExecutionResults
+ * object. This object either consists of a single ExecutionResult, or an
+ * object containing an `initialResult` and a stream of `subsequentResults`.
+ *
+ * If the arguments to this function do not result in a legal execution context,
+ * a GraphQLError will be thrown immediately explaining the invalid input.
  */
-export declare function execute<TData = {
-    [key: string]: any;
-}, TVariables = {
-    [key: string]: any;
-}, TContext = any>(args: ExecutionArgs<TData, TVariables, TContext>): MaybePromise<ExecutionResult<TData>>;
+export declare function experimentalExecuteIncrementally<TData = any, TVariables = any, TContext = any>(args: ExecutionArgs<TData, TVariables, TContext>): MaybePromise<ExecutionResult<TData> | ExperimentalIncrementalExecutionResults<TData>>;
 /**
  * Also implements the "Executing requests" section of the GraphQL specification.
  * However, it guarantees to complete synchronously (or throw an error) assuming
@@ -93,11 +156,7 @@ export declare function assertValidExecutionArguments<TVariables>(schema: GraphQ
  * TODO: consider no longer exporting this function
  * @internal
  */
-export declare function buildExecutionContext<TData = {
-    [key: string]: any;
-}, TVariables = {
-    [key: string]: any;
-}, TContext = any>(args: ExecutionArgs<TData, TVariables, TContext>): ReadonlyArray<GraphQLError> | ExecutionContext;
+export declare function buildExecutionContext<TData = any, TVariables = any, TContext = any>(args: ExecutionArgs<TData, TVariables, TContext>): ReadonlyArray<GraphQLError> | ExecutionContext;
 /**
  * TODO: consider no longer exporting this function
  * @internal
@@ -130,19 +189,61 @@ export declare const defaultFieldResolver: GraphQLFieldResolver<unknown, unknown
  * 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.
+ * 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
+ * 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.
+ * This function does not support incremental delivery (`@defer` and `@stream`).
+ * If an operation which would defer or stream data is executed with this
+ * function, each `InitialIncrementalExecutionResult` and
+ * `SubsequentIncrementalExecutionResult` in the result stream will be replaced
+ * with an `ExecutionResult` with a single error stating that defer/stream is
+ * not supported.  Use `experimentalSubscribeIncrementally` if you want to
+ * support incremental delivery.
+ *
+ * Accepts an object with named arguments.
  */
 export declare function subscribe(args: ExecutionArgs): MaybePromise<AsyncIterable<ExecutionResult> | ExecutionResult>;
+/**
+ * Implements the "Subscribe" algorithm described in the GraphQL specification,
+ * including `@defer` and `@stream` as proposed in
+ * https://github.com/graphql/graphql-spec/pull/742
+ *
+ * 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 result representing the response stream.
+ *
+ * Each result may be an ExecutionResult with no `hasNext` (if executing the
+ * event did not use `@defer` or `@stream`), or an
+ * `InitialIncrementalExecutionResult` or `SubsequentIncrementalExecutionResult`
+ * (if executing the event used `@defer` or `@stream`). In the case of
+ * incremental execution results, each event produces a single
+ * `InitialIncrementalExecutionResult` followed by one or more
+ * `SubsequentIncrementalExecutionResult`s; all but the last have `hasNext: true`,
+ * and the last has `hasNext: false`. There is no interleaving between results
+ * generated from the same original event.
+ *
+ * Accepts an object with named arguments.
+ */
+export declare function experimentalSubscribeIncrementally(args: ExecutionArgs): MaybePromise<AsyncGenerator<ExecutionResult | InitialIncrementalExecutionResult | SubsequentIncrementalExecutionResult, void, void> | ExecutionResult>;
 /**
  * Implements the "CreateSourceEventStream" algorithm described in the
  * GraphQL specification, resolving the subscription source event stream.
@@ -172,6 +273,49 @@ export declare function subscribe(args: ExecutionArgs): MaybePromise<AsyncIterab
  * "Supporting Subscriptions at Scale" information in the GraphQL specification.
  */
 export declare function createSourceEventStream(args: ExecutionArgs): MaybePromise<AsyncIterable<unknown> | ExecutionResult>;
+declare class DeferredFragmentRecord {
+    type: 'defer';
+    errors: Array<GraphQLError>;
+    label: string | undefined;
+    path: Array<string | number>;
+    promise: Promise<void>;
+    data: Record<string, unknown> | null;
+    parentContext: AsyncPayloadRecord | undefined;
+    isCompleted: boolean;
+    _exeContext: ExecutionContext;
+    _resolve?: (arg: MaybePromise<Record<string, unknown> | null>) => void;
+    constructor(opts: {
+        label: string | undefined;
+        path: Path | undefined;
+        parentContext: AsyncPayloadRecord | undefined;
+        exeContext: ExecutionContext;
+    });
+    addData(data: MaybePromise<Record<string, unknown> | null>): void;
+}
+declare class StreamRecord {
+    type: 'stream';
+    errors: Array<GraphQLError>;
+    label: string | undefined;
+    path: Array<string | number>;
+    items: Array<unknown> | null;
+    promise: Promise<void>;
+    parentContext: AsyncPayloadRecord | undefined;
+    iterator: AsyncIterator<unknown> | undefined;
+    isCompletedIterator?: boolean;
+    isCompleted: boolean;
+    _exeContext: ExecutionContext;
+    _resolve?: (arg: MaybePromise<Array<unknown> | null>) => void;
+    constructor(opts: {
+        label: string | undefined;
+        path: Path | undefined;
+        iterator?: AsyncIterator<unknown>;
+        parentContext: AsyncPayloadRecord | undefined;
+        exeContext: ExecutionContext;
+    });
+    addItems(items: MaybePromise<Array<unknown> | null>): void;
+    setIsCompletedIterator(): void;
+}
+declare type AsyncPayloadRecord = DeferredFragmentRecord | StreamRecord;
 /**
  * This method looks up the field on the given type definition.
  * It has special casing for the three introspection fields,
@@ -184,3 +328,4 @@ export declare function createSourceEventStream(args: ExecutionArgs): MaybePromi
  * @internal
  */
 export declare function getFieldDef(schema: GraphQLSchema, parentType: GraphQLObjectType, fieldNode: FieldNode): Maybe<GraphQLField<unknown, unknown>>;
+export {};

package/typings/execution/flattenAsyncIterable.d.cts

@@ -0,0 +1,7 @@
+declare type AsyncIterableOrGenerator<T> = AsyncGenerator<T, void, void> | AsyncIterable<T>;
+/**
+ * Given an AsyncIterable of AsyncIterables, flatten all yielded results into a
+ * single AsyncIterable.
+ */
+export declare function flattenAsyncIterable<T>(iterable: AsyncIterableOrGenerator<AsyncIterableOrGenerator<T>>): AsyncGenerator<T, void, void>;
+export {};

package/typings/execution/flattenAsyncIterable.d.ts

@@ -0,0 +1,7 @@
+declare type AsyncIterableOrGenerator<T> = AsyncGenerator<T, void, void> | AsyncIterable<T>;
+/**
+ * Given an AsyncIterable of AsyncIterables, flatten all yielded results into a
+ * single AsyncIterable.
+ */
+export declare function flattenAsyncIterable<T>(iterable: AsyncIterableOrGenerator<AsyncIterableOrGenerator<T>>): AsyncGenerator<T, void, void>;
+export {};

package/typings/execution/invariant.d.cts

@@ -0,0 +1 @@
+export declare function invariant(condition: boolean, message?: string): asserts condition;

package/typings/execution/invariant.d.ts

@@ -0,0 +1 @@
+export declare function invariant(condition: boolean, message?: string): asserts condition;

package/typings/execution/promiseForObject.d.cts

@@ -0,0 +1,12 @@
+declare type ResolvedObject<TData> = {
+    [TKey in keyof TData]: TData[TKey] extends Promise<infer TValue> ? TValue : TData[TKey];
+};
+/**
+ * This function transforms a JS object `Record<string, Promise<T>>` into
+ * a `Promise<Record<string, T>>`
+ *
+ * This is akin to bluebird's `Promise.props`, but implemented only using
+ * `Promise.all` so it will work with any implementation of ES6 promises.
+ */
+export declare function promiseForObject<TData>(object: TData): Promise<ResolvedObject<TData>>;
+export {};

package/typings/execution/promiseForObject.d.ts

@@ -0,0 +1,12 @@
+declare type ResolvedObject<TData> = {
+    [TKey in keyof TData]: TData[TKey] extends Promise<infer TValue> ? TValue : TData[TKey];
+};
+/**
+ * This function transforms a JS object `Record<string, Promise<T>>` into
+ * a `Promise<Record<string, T>>`
+ *
+ * This is akin to bluebird's `Promise.props`, but implemented only using
+ * `Promise.all` so it will work with any implementation of ES6 promises.
+ */
+export declare function promiseForObject<TData>(object: TData): Promise<ResolvedObject<TData>>;
+export {};

package/typings/index.d.cts

@@ -1 +1,2 @@
 export * from './execution/index.cjs';
+export * from './directives/index.cjs';

package/typings/index.d.ts

@@ -1 +1,2 @@
 export * from './execution/index.js';
+export * from './directives/index.js';

package/cjs/execution/subscribe.js

@@ -1,158 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSourceEventStream = exports.subscribe = void 0;
-const graphql_1 = require("graphql");
-const utils_1 = require("@graphql-tools/utils");
-const execute_js_1 = require("./execute.js");
-/**
- * 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.
- */
-async function subscribe(args) {
-    // Temporary for v15 to v16 migration. Remove in v17
-    console.assert(arguments.length < 2, 'graphql@16 dropped long-deprecated support for positional arguments, please pass an object instead.');
-    const { schema, document, rootValue, contextValue, variableValues, operationName, fieldResolver, subscribeFieldResolver, } = args;
-    const resultOrStream = await createSourceEventStream(schema, document, rootValue, contextValue, variableValues, operationName, subscribeFieldResolver);
-    if (!(0, utils_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.
-    const mapSourceToResponse = (payload) => (0, execute_js_1.execute)({
-        schema,
-        document,
-        rootValue: payload,
-        contextValue,
-        variableValues,
-        operationName,
-        fieldResolver,
-    });
-    // Map every source value to a ExecutionResult value as described above.
-    return (0, utils_1.mapAsyncIterator)(resultOrStream[Symbol.asyncIterator](), mapSourceToResponse);
-}
-exports.subscribe = subscribe;
-/**
- * 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.
- */
-async function createSourceEventStream(schema, document, rootValue, contextValue, variableValues, operationName, subscribeFieldResolver) {
-    // If arguments are missing or incorrectly typed, this is an internal
-    // developer mistake which should throw an early error.
-    (0, execute_js_1.assertValidExecutionArguments)(schema, document, variableValues);
-    // If a valid execution context cannot be created due to incorrect arguments,
-    // a "Response" with only errors is returned.
-    const exeContext = (0, execute_js_1.buildExecutionContext)({
-        schema,
-        document,
-        rootValue,
-        contextValue,
-        variableValues,
-        operationName,
-        subscribeFieldResolver,
-    });
-    // Return early errors if execution context failed.
-    if (!('schema' in exeContext)) {
-        return { errors: exeContext };
-    }
-    try {
-        const eventStream = await executeSubscription(exeContext);
-        // Assert field returned an event stream, otherwise yield an error.
-        if (!(0, utils_1.isAsyncIterable)(eventStream)) {
-            throw new Error('Subscription field must return Async Iterable. ' + `Received: ${(0, utils_1.inspect)(eventStream)}.`);
-        }
-        return eventStream;
-    }
-    catch (error) {
-        // If it GraphQLError, report it as an ExecutionResult, containing only errors and no data.
-        // Otherwise treat the error as a system-class error and re-throw it.
-        if (error instanceof graphql_1.GraphQLError) {
-            return { errors: [error] };
-        }
-        throw error;
-    }
-}
-exports.createSourceEventStream = createSourceEventStream;
-async function executeSubscription(exeContext) {
-    var _a;
-    const { schema, fragments, operation, variableValues, rootValue } = exeContext;
-    const rootType = schema.getSubscriptionType();
-    if (rootType == null) {
-        throw (0, utils_1.createGraphQLError)('Schema is not configured to execute subscription operation.', { nodes: operation });
-    }
-    const rootFields = (0, utils_1.collectFields)(schema, fragments, variableValues, rootType, operation.selectionSet);
-    const [responseName, fieldNodes] = [...rootFields.entries()][0];
-    const fieldDef = (0, execute_js_1.getFieldDef)(schema, rootType, fieldNodes[0]);
-    if (!fieldDef) {
-        const fieldName = fieldNodes[0].name.value;
-        throw (0, utils_1.createGraphQLError)(`The subscription field "${fieldName}" is not defined.`, { nodes: fieldNodes });
-    }
-    const path = (0, utils_1.addPath)(undefined, responseName, rootType.name);
-    const info = (0, execute_js_1.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, utils_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 eventStream = await resolveFn(rootValue, args, contextValue, info);
-        if (eventStream instanceof Error) {
-            throw eventStream;
-        }
-        return eventStream;
-    }
-    catch (error) {
-        throw (0, graphql_1.locatedError)(error, fieldNodes, (0, utils_1.pathToArray)(path));
-    }
-}

package/esm/execution/subscribe.js

@@ -1,153 +0,0 @@
-import { GraphQLError, locatedError } from 'graphql';
-import { collectFields, mapAsyncIterator, inspect, isAsyncIterable, createGraphQLError, addPath, pathToArray, getArgumentValues, } from '@graphql-tools/utils';
-import { assertValidExecutionArguments, buildExecutionContext, buildResolveInfo, execute, getFieldDef, } from './execute.js';
-/**
- * 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.
- */
-export async function subscribe(args) {
-    // Temporary for v15 to v16 migration. Remove in v17
-    console.assert(arguments.length < 2, 'graphql@16 dropped long-deprecated support for positional arguments, please pass an object instead.');
-    const { schema, document, rootValue, contextValue, variableValues, operationName, fieldResolver, subscribeFieldResolver, } = args;
-    const resultOrStream = await createSourceEventStream(schema, document, rootValue, contextValue, variableValues, operationName, subscribeFieldResolver);
-    if (!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.
-    const mapSourceToResponse = (payload) => execute({
-        schema,
-        document,
-        rootValue: payload,
-        contextValue,
-        variableValues,
-        operationName,
-        fieldResolver,
-    });
-    // Map every source value to a ExecutionResult value as described above.
-    return mapAsyncIterator(resultOrStream[Symbol.asyncIterator](), mapSourceToResponse);
-}
-/**
- * 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.
- */
-export async function createSourceEventStream(schema, document, rootValue, contextValue, variableValues, operationName, subscribeFieldResolver) {
-    // If arguments are missing or incorrectly typed, this is an internal
-    // developer mistake which should throw an early error.
-    assertValidExecutionArguments(schema, document, variableValues);
-    // If a valid execution context cannot be created due to incorrect arguments,
-    // a "Response" with only errors is returned.
-    const exeContext = buildExecutionContext({
-        schema,
-        document,
-        rootValue,
-        contextValue,
-        variableValues,
-        operationName,
-        subscribeFieldResolver,
-    });
-    // Return early errors if execution context failed.
-    if (!('schema' in exeContext)) {
-        return { errors: exeContext };
-    }
-    try {
-        const eventStream = await executeSubscription(exeContext);
-        // Assert field returned an event stream, otherwise yield an error.
-        if (!isAsyncIterable(eventStream)) {
-            throw new Error('Subscription field must return Async Iterable. ' + `Received: ${inspect(eventStream)}.`);
-        }
-        return eventStream;
-    }
-    catch (error) {
-        // If it GraphQLError, report it as an ExecutionResult, containing only errors and no data.
-        // Otherwise treat the error as a system-class error and re-throw it.
-        if (error instanceof GraphQLError) {
-            return { errors: [error] };
-        }
-        throw error;
-    }
-}
-async function executeSubscription(exeContext) {
-    var _a;
-    const { schema, fragments, operation, variableValues, rootValue } = exeContext;
-    const rootType = schema.getSubscriptionType();
-    if (rootType == null) {
-        throw createGraphQLError('Schema is not configured to execute subscription operation.', { nodes: operation });
-    }
-    const rootFields = collectFields(schema, fragments, variableValues, rootType, operation.selectionSet);
-    const [responseName, fieldNodes] = [...rootFields.entries()][0];
-    const fieldDef = getFieldDef(schema, rootType, fieldNodes[0]);
-    if (!fieldDef) {
-        const fieldName = fieldNodes[0].name.value;
-        throw createGraphQLError(`The subscription field "${fieldName}" is not defined.`, { nodes: fieldNodes });
-    }
-    const path = 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 = 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 eventStream = await resolveFn(rootValue, args, contextValue, info);
-        if (eventStream instanceof Error) {
-            throw eventStream;
-        }
-        return eventStream;
-    }
-    catch (error) {
-        throw locatedError(error, fieldNodes, pathToArray(path));
-    }
-}