@graphql-tools/executor 2.0.0-alpha-20240709212042-9a70c086fa543c594055305622a600bb95343b42 → 2.0.0-alpha-20240804112853-812acba5ea59541106a53f872874fd7aebcffcfc

package/typings/execution/execute.d.ts

@@ -1,6 +1,7 @@
 import { DocumentNode, FieldNode, FragmentDefinitionNode, GraphQLError, GraphQLField, GraphQLFieldResolver, GraphQLObjectType, GraphQLResolveInfo, GraphQLSchema, GraphQLTypeResolver, OperationDefinitionNode } from 'graphql';
 import { Maybe, MaybePromise, Path } from '@graphql-tools/utils';
 import { TypedDocumentNode } from '@graphql-typed-document-node/core';
+import { AccumulatorMap } from './AccumulatorMap.js';
 import { CancellableStreamRecord, IncrementalDataRecord, IncrementalExecutionResults, InitialIncrementalExecutionResult, SingularExecutionResult, SubsequentIncrementalExecutionResult } from './types.js';
 /**
  * Terminology
@@ -43,7 +44,7 @@ export interface ExecutionContext<TVariables = any, TContext = any> {
     sendPathAndLabelOnIncremental: boolean;
     errorWithIncrementalSubscription: boolean;
     signal: AbortSignal | undefined;
-    errors: Map<Path | undefined, GraphQLError> | undefined;
+    errors: AccumulatorMap<Path | undefined, GraphQLError> | undefined;
     cancellableStreams: Set<CancellableStreamRecord> | undefined;
     incrementalDataRecords: Array<IncrementalDataRecord> | undefined;
 }
@@ -106,6 +107,7 @@ export declare function buildExecutionContext<TData = any, TVariables = any, TCo
  * @internal
  */
 export declare function buildResolveInfo(exeContext: ExecutionContext, fieldDef: GraphQLField<unknown, unknown>, fieldNodes: Array<FieldNode>, parentType: GraphQLObjectType, path: Path): GraphQLResolveInfo;
+export declare const CRITICAL_ERROR: "CRITICAL_ERROR";
 /**
  * If a resolveType function is not given, then a default resolve behavior is
  * used which attempts two strategies:

package/typings/execution/types.d.cts

@@ -50,7 +50,7 @@ export interface FormattedSubsequentIncrementalExecutionResult<TData = unknown,
     completed?: ReadonlyArray<FormattedCompletedResult>;
     extensions?: TExtensions;
 }
-interface BareDeferredGroupedFieldSetResult<TData = Record<string, unknown>> {
+interface ExecutionGroupResult<TData = Record<string, unknown>> {
     errors?: ReadonlyArray<GraphQLError>;
     data: TData;
 }
@@ -72,7 +72,7 @@ export interface FormattedIncrementalDeferResult<TData = Record<string, unknown>
     subPath?: ReadonlyArray<string | number>;
     extensions?: TExtensions;
 }
-interface BareStreamItemsResult<TData = ReadonlyArray<unknown>> {
+interface StreamItemsRecordResult<TData = ReadonlyArray<unknown>> {
     errors?: ReadonlyArray<GraphQLError>;
     items: TData;
 }
@@ -108,45 +108,45 @@ export interface FormattedCompletedResult {
     label?: string;
     errors?: ReadonlyArray<GraphQLError>;
 }
-export declare function isDeferredGroupedFieldSetRecord(incrementalDataRecord: IncrementalDataRecord): incrementalDataRecord is DeferredGroupedFieldSetRecord;
-export type DeferredGroupedFieldSetResult = ReconcilableDeferredGroupedFieldSetResult | NonReconcilableDeferredGroupedFieldSetResult;
-export declare function isDeferredGroupedFieldSetResult(subsequentResult: DeferredGroupedFieldSetResult | StreamItemsResult): subsequentResult is DeferredGroupedFieldSetResult;
-export interface ReconcilableDeferredGroupedFieldSetResult {
-    deferredGroupedFieldSetRecord: DeferredGroupedFieldSetRecord;
+export declare function isPendingExecutionGroup(incrementalDataRecord: IncrementalDataRecord): incrementalDataRecord is PendingExecutionGroup;
+export type CompletedExecutionGroup = SuccessfulExecutionGroup | FailedExecutionGroup;
+export declare function isCompletedExecutionGroup(incrementalDataRecordResult: IncrementalDataRecordResult): incrementalDataRecordResult is CompletedExecutionGroup;
+export interface SuccessfulExecutionGroup {
+    pendingExecutionGroup: PendingExecutionGroup;
     path: Array<string | number>;
-    result: BareDeferredGroupedFieldSetResult;
+    result: ExecutionGroupResult;
     incrementalDataRecords: ReadonlyArray<IncrementalDataRecord> | undefined;
     errors?: never;
 }
-interface NonReconcilableDeferredGroupedFieldSetResult {
-    deferredGroupedFieldSetRecord: DeferredGroupedFieldSetRecord;
+interface FailedExecutionGroup {
+    pendingExecutionGroup: PendingExecutionGroup;
     path: Array<string | number>;
     errors: ReadonlyArray<GraphQLError>;
     result?: never;
 }
-export declare function isNonReconcilableDeferredGroupedFieldSetResult(deferredGroupedFieldSetResult: DeferredGroupedFieldSetResult): deferredGroupedFieldSetResult is NonReconcilableDeferredGroupedFieldSetResult;
-export interface DeferredGroupedFieldSetRecord {
+export declare function isFailedExecutionGroup(completedExecutionGroup: CompletedExecutionGroup): completedExecutionGroup is FailedExecutionGroup;
+export interface PendingExecutionGroup {
     path: Path | undefined;
     deferredFragmentRecords: ReadonlyArray<DeferredFragmentRecord>;
-    result: BoxedPromiseOrValue<DeferredGroupedFieldSetResult> | (() => BoxedPromiseOrValue<DeferredGroupedFieldSetResult>);
+    result: BoxedPromiseOrValue<CompletedExecutionGroup> | (() => BoxedPromiseOrValue<CompletedExecutionGroup>);
 }
-export type SubsequentResultRecord = DeferredFragmentRecord | StreamRecord;
+export type DeliveryGroup = DeferredFragmentRecord | StreamRecord;
 /** @internal */
 export declare class DeferredFragmentRecord {
     path: Path | undefined;
     label: string | undefined;
     id?: string | undefined;
     parent: DeferredFragmentRecord | undefined;
-    deferredGroupedFieldSetRecords: Set<DeferredGroupedFieldSetRecord>;
-    reconcilableResults: Set<ReconcilableDeferredGroupedFieldSetResult>;
-    children: Set<SubsequentResultRecord>;
+    pendingExecutionGroups: Set<PendingExecutionGroup>;
+    successfulExecutionGroups: Set<SuccessfulExecutionGroup>;
+    children: Set<DeliveryGroup>;
     pending: boolean;
     fns: Array<() => void>;
     constructor(path: Path | undefined, label: string | undefined, parent: DeferredFragmentRecord | undefined);
     onPending(fn: () => void): void;
     setAsPending(): void;
 }
-export declare function isDeferredFragmentRecord(subsequentResultRecord: SubsequentResultRecord): subsequentResultRecord is DeferredFragmentRecord;
+export declare function isDeferredFragmentRecord(deliveryGroup: DeliveryGroup): deliveryGroup is DeferredFragmentRecord;
 export interface StreamItemResult {
     path: Path;
     item?: unknown;
@@ -163,14 +163,14 @@ export interface StreamRecord {
 }
 export interface StreamItemsResult {
     streamRecord: StreamRecord;
-    result?: BareStreamItemsResult | undefined;
+    result?: StreamItemsRecordResult | undefined;
     incrementalDataRecords?: ReadonlyArray<IncrementalDataRecord> | undefined;
     errors?: ReadonlyArray<GraphQLError> | undefined;
 }
 export interface CancellableStreamRecord extends StreamRecord {
     earlyReturn: () => Promise<unknown>;
 }
-export declare function isCancellableStreamRecord(subsequentResultRecord: SubsequentResultRecord): subsequentResultRecord is CancellableStreamRecord;
-export type IncrementalDataRecord = DeferredGroupedFieldSetRecord | StreamRecord;
-export type IncrementalDataRecordResult = DeferredGroupedFieldSetResult | StreamItemsResult;
+export declare function isCancellableStreamRecord(deliveryGroup: DeliveryGroup): deliveryGroup is CancellableStreamRecord;
+export type IncrementalDataRecord = PendingExecutionGroup | StreamRecord;
+export type IncrementalDataRecordResult = CompletedExecutionGroup | StreamItemsResult;
 export {};

package/typings/execution/types.d.ts

@@ -50,7 +50,7 @@ export interface FormattedSubsequentIncrementalExecutionResult<TData = unknown,
     completed?: ReadonlyArray<FormattedCompletedResult>;
     extensions?: TExtensions;
 }
-interface BareDeferredGroupedFieldSetResult<TData = Record<string, unknown>> {
+interface ExecutionGroupResult<TData = Record<string, unknown>> {
     errors?: ReadonlyArray<GraphQLError>;
     data: TData;
 }
@@ -72,7 +72,7 @@ export interface FormattedIncrementalDeferResult<TData = Record<string, unknown>
     subPath?: ReadonlyArray<string | number>;
     extensions?: TExtensions;
 }
-interface BareStreamItemsResult<TData = ReadonlyArray<unknown>> {
+interface StreamItemsRecordResult<TData = ReadonlyArray<unknown>> {
     errors?: ReadonlyArray<GraphQLError>;
     items: TData;
 }
@@ -108,45 +108,45 @@ export interface FormattedCompletedResult {
     label?: string;
     errors?: ReadonlyArray<GraphQLError>;
 }
-export declare function isDeferredGroupedFieldSetRecord(incrementalDataRecord: IncrementalDataRecord): incrementalDataRecord is DeferredGroupedFieldSetRecord;
-export type DeferredGroupedFieldSetResult = ReconcilableDeferredGroupedFieldSetResult | NonReconcilableDeferredGroupedFieldSetResult;
-export declare function isDeferredGroupedFieldSetResult(subsequentResult: DeferredGroupedFieldSetResult | StreamItemsResult): subsequentResult is DeferredGroupedFieldSetResult;
-export interface ReconcilableDeferredGroupedFieldSetResult {
-    deferredGroupedFieldSetRecord: DeferredGroupedFieldSetRecord;
+export declare function isPendingExecutionGroup(incrementalDataRecord: IncrementalDataRecord): incrementalDataRecord is PendingExecutionGroup;
+export type CompletedExecutionGroup = SuccessfulExecutionGroup | FailedExecutionGroup;
+export declare function isCompletedExecutionGroup(incrementalDataRecordResult: IncrementalDataRecordResult): incrementalDataRecordResult is CompletedExecutionGroup;
+export interface SuccessfulExecutionGroup {
+    pendingExecutionGroup: PendingExecutionGroup;
     path: Array<string | number>;
-    result: BareDeferredGroupedFieldSetResult;
+    result: ExecutionGroupResult;
     incrementalDataRecords: ReadonlyArray<IncrementalDataRecord> | undefined;
     errors?: never;
 }
-interface NonReconcilableDeferredGroupedFieldSetResult {
-    deferredGroupedFieldSetRecord: DeferredGroupedFieldSetRecord;
+interface FailedExecutionGroup {
+    pendingExecutionGroup: PendingExecutionGroup;
     path: Array<string | number>;
     errors: ReadonlyArray<GraphQLError>;
     result?: never;
 }
-export declare function isNonReconcilableDeferredGroupedFieldSetResult(deferredGroupedFieldSetResult: DeferredGroupedFieldSetResult): deferredGroupedFieldSetResult is NonReconcilableDeferredGroupedFieldSetResult;
-export interface DeferredGroupedFieldSetRecord {
+export declare function isFailedExecutionGroup(completedExecutionGroup: CompletedExecutionGroup): completedExecutionGroup is FailedExecutionGroup;
+export interface PendingExecutionGroup {
     path: Path | undefined;
     deferredFragmentRecords: ReadonlyArray<DeferredFragmentRecord>;
-    result: BoxedPromiseOrValue<DeferredGroupedFieldSetResult> | (() => BoxedPromiseOrValue<DeferredGroupedFieldSetResult>);
+    result: BoxedPromiseOrValue<CompletedExecutionGroup> | (() => BoxedPromiseOrValue<CompletedExecutionGroup>);
 }
-export type SubsequentResultRecord = DeferredFragmentRecord | StreamRecord;
+export type DeliveryGroup = DeferredFragmentRecord | StreamRecord;
 /** @internal */
 export declare class DeferredFragmentRecord {
     path: Path | undefined;
     label: string | undefined;
     id?: string | undefined;
     parent: DeferredFragmentRecord | undefined;
-    deferredGroupedFieldSetRecords: Set<DeferredGroupedFieldSetRecord>;
-    reconcilableResults: Set<ReconcilableDeferredGroupedFieldSetResult>;
-    children: Set<SubsequentResultRecord>;
+    pendingExecutionGroups: Set<PendingExecutionGroup>;
+    successfulExecutionGroups: Set<SuccessfulExecutionGroup>;
+    children: Set<DeliveryGroup>;
     pending: boolean;
     fns: Array<() => void>;
     constructor(path: Path | undefined, label: string | undefined, parent: DeferredFragmentRecord | undefined);
     onPending(fn: () => void): void;
     setAsPending(): void;
 }
-export declare function isDeferredFragmentRecord(subsequentResultRecord: SubsequentResultRecord): subsequentResultRecord is DeferredFragmentRecord;
+export declare function isDeferredFragmentRecord(deliveryGroup: DeliveryGroup): deliveryGroup is DeferredFragmentRecord;
 export interface StreamItemResult {
     path: Path;
     item?: unknown;
@@ -163,14 +163,14 @@ export interface StreamRecord {
 }
 export interface StreamItemsResult {
     streamRecord: StreamRecord;
-    result?: BareStreamItemsResult | undefined;
+    result?: StreamItemsRecordResult | undefined;
     incrementalDataRecords?: ReadonlyArray<IncrementalDataRecord> | undefined;
     errors?: ReadonlyArray<GraphQLError> | undefined;
 }
 export interface CancellableStreamRecord extends StreamRecord {
     earlyReturn: () => Promise<unknown>;
 }
-export declare function isCancellableStreamRecord(subsequentResultRecord: SubsequentResultRecord): subsequentResultRecord is CancellableStreamRecord;
-export type IncrementalDataRecord = DeferredGroupedFieldSetRecord | StreamRecord;
-export type IncrementalDataRecordResult = DeferredGroupedFieldSetResult | StreamItemsResult;
+export declare function isCancellableStreamRecord(deliveryGroup: DeliveryGroup): deliveryGroup is CancellableStreamRecord;
+export type IncrementalDataRecord = PendingExecutionGroup | StreamRecord;
+export type IncrementalDataRecordResult = CompletedExecutionGroup | StreamItemsResult;
 export {};

package/typings/execution/buildFieldPlan.d.cts

@@ -1,8 +0,0 @@
-import type { DeferUsage, GroupedFieldSet } from './collectFields.cjs';
-export type DeferUsageSet = ReadonlySet<DeferUsage>;
-export interface FieldPlan {
-    groupedFieldSet: GroupedFieldSet;
-    newGroupedFieldSets: Map<DeferUsageSet, GroupedFieldSet>;
-}
-export declare function buildFieldPlan(originalGroupedFieldSet: GroupedFieldSet, parentDeferUsages?: DeferUsageSet): FieldPlan;
-export declare function buildBranchingFieldPlan(originalGroupedFieldSet: GroupedFieldSet, parentDeferUsages?: DeferUsageSet): FieldPlan;

package/typings/execution/buildFieldPlan.d.ts

@@ -1,8 +0,0 @@
-import type { DeferUsage, GroupedFieldSet } from './collectFields.js';
-export type DeferUsageSet = ReadonlySet<DeferUsage>;
-export interface FieldPlan {
-    groupedFieldSet: GroupedFieldSet;
-    newGroupedFieldSets: Map<DeferUsageSet, GroupedFieldSet>;
-}
-export declare function buildFieldPlan(originalGroupedFieldSet: GroupedFieldSet, parentDeferUsages?: DeferUsageSet): FieldPlan;
-export declare function buildBranchingFieldPlan(originalGroupedFieldSet: GroupedFieldSet, parentDeferUsages?: DeferUsageSet): FieldPlan;