@wundergraph/composition 0.37.0 → 0.37.2

package/README.md

@@ -19,10 +19,10 @@ The function must be provided with an array of at least one [`Subgraph` object](
 An example federation of two simple subgraphs:
 
 ```typescript
-import { federateSubgraphs, Subgraph } from '@wundergraph/composition';
+import { federateSubgraphs, FederationResult, Subgraph } from '@wundergraph/composition';
 import { parse } from 'graphql';
 
-const federationResult: FederationResult = federateSubgraphs([subgraphA, subgraphB]);
+const result: FederationResult = federateSubgraphs([subgraphA, subgraphB]);
 
 const subgraphA: Subgraph = {
   name: 'subgraph-a',
@@ -51,26 +51,34 @@ const subgraphB: Subgraph = {
 };
 ```
 
-### FederationResultContainer properties
+### FederationResult
 
-The `federateSubgraphs` function returns a `FederationResultContainer` object.
-If federation was successful, the `errors` property will be undefined, and the `federationResult` object will be 
-defined.
+The `federateSubgraphs` function returns `FederationResult`, which is a union of `FederationResultSuccess` and 
+`FederationResultFailure`. Both types in the union always define the following mutual properties:
 
-| property         | Description                         | type                          |
-|------------------|-------------------------------------|-------------------------------|
-| errors           | array of composition errors         | Error[] \| undefined          |
-| federationResult | FederationResult object (see below) | FederationResult \| undefined |
+| property | Description                            | type           |
+|----------|----------------------------------------|----------------|
+| success  | assertion of composition success       | boolean        |
+| warnings | array of composition warnings (if any) | Array<Warning> |
 
-### FederationResult properties
+#### FederationResultSuccess
+If federation was successful, the return type is `FederationResultSuccess`.
 
-If federation was successful, `FieldResultContainer` will contain a defined `federationResult` property.
+| property             | Description                                                 | type                  |
+|----------------------|-------------------------------------------------------------|-----------------------|
+| federatedGraphAST    | an AST object representation of the federated graph sdl     | graphql.DocumentNode  |
+| federatedGraphSchema | a schema object representation of the federated graph sdl   | graphql.GraphQLSchema |
+| success              | assertion that composition was successful                   | true                  |
+| warnings             | array of composition warnings (if any)                      | Array<Warning>        |
 
-| property               | Description                                               | type                        |
-|------------------------|-----------------------------------------------------------|-----------------------------|
-| argumentConfigurations | array of router argument configurations                   | ArgumentConfigurationData[] |
-| federatedGraphAST      | an AST object representation of the federated graph sdl   | graphql.DocumentNode        |
-| federatedGraphSchema   | a schema object representation of the federated graph sdl | graphql.GraphQLSchema       |
+#### FederationResultFailure
+If federation was unsuccessful, the return type is `FederationResultFailure`.
+
+| property | Description                                 | type           |
+|----------|---------------------------------------------|----------------|
+| errors   | array of composition errors                 | Array<Error>   |
+| success  | assertion that composition was unsuccessful | false          |
+| warnings | array of composition warnings (if any)      | Array<Warning> |
 
 ### Debugging
 
@@ -80,18 +88,22 @@ In these cases, the errors array will be defined and populated.
 An example of a simple debugging framework might be:
 
 ```typescript
-import { federateSubgraphs, Subgraph } from '@wundergraph.composition';
+import { federateSubgraphs, FederationResult, Subgraph } from '@wundergraph.composition';
 import { print, printSchema } from 'graphql';
 
-const { errors, federationResult } = federateSubgraphs([subgraphA, subgraphB]);
-if (errors) {
-  for (const err of errors) {
+const result: FederationResult = federateSubgraphs([subgraphA, subgraphB]);
+
+if (result.success) {
+  // Both options to print the federated graph as a string are included for documentational purposes only
+  console.log(print(result.federatedGraphAST)); // log the federated graph AST as a string
+  console.log(printSchema(result.federatedGraphSchema)); // log the federated graph schema as a string
+} else {
+  for (const err of result.errors) {
     console.log(err.message);
   }
-} else {
-  // Both options to print the federated graph as a string are included for documentational purposes only
-  console.log(print(federationResult!.federatedGraphAST)); // log the federated graph AST as a string
-  console.log(printSchema(federationResult!.federatedGraphSchema)); // log the federated graph schema as a string
+}
+for (const warning of result.warnings) {
+  console.log(warning);
 }
 
 // subgraph definitions would be below [removed for brevity]
@@ -105,25 +117,7 @@ Errors can happen in three main stages:
 (if this stage fails, federation will not be attempted)
 3. During the federation process itself.
 
-All errors will be appended to the `FederationResultContainer.errors` array.
-Often, the error message will suggest potential fixes. For instance:
-
-```
-Error: The following root path is unresolvable:
-    Query.user.name
-    This is because:
-        The root type field "Query.user" is defined in the following subgraphs: "subgraph-b".
-    However, "User.name" is only defined in the following subgraphs: "subgraph-c".
-    Consequently, "User.name" cannot be resolved through the root type field "Query.user".
-    Potential solutions:
-        Convert "User" into an entity using a "@key" directive.
-        Add the shareable root type field "Query.user" to the following subgraphs: "subgraph-c".
-            For example (note that V1 fields are shareable by default and do not require a directive):
-                type Query {
-                    ...
-                    user: User @shareable
-                }
-`````
+All errors will be appended to the `FederationResultFailure.errors` array.
 
 ## Subgraph object
 
@@ -160,11 +154,10 @@ const subgraphA: Subgraph = {
 | definitions | an AST representation of the subgraph SDL | graphql.DocumentNode |
 
 ### Contributing
-Some GraphQL and Federation jargon should begin with a capitalised letter for clarity, e.g.,:
-- Argument
+When adding or changing error, please ensure GraphQL types begin with a capital letter for clarity:
 - Enum
-- Field
 - Input Object
 - Interface
 - Object
-When adding or changing errors, please begin these terms with a capital letter.
+- Scalar
+- Union

package/dist/ast/utils.js

@@ -220,8 +220,8 @@ function parse(source, noLocation = true) {
 }
 function safeParse(value, noLocation = true) {
     try {
-        const parsedValue = parse(value, noLocation);
-        return { documentNode: parsedValue };
+        const documentNode = parse(value, noLocation);
+        return { documentNode };
     }
     catch (e) {
         return { error: e };

package/dist/ast/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/ast/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/ast/utils.ts"],"names":[],"mappings":"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"}

package/dist/errors/errors.d.ts

@@ -1,9 +1,8 @@
 import { Kind, OperationTypeNode } from 'graphql';
-import { ObjectDefinitionData } from '../schema-building/types';
+import { EntityInterfaceFederationData, ObjectDefinitionData } from '../schema-building/types';
 import { InvalidRootTypeFieldEventsDirectiveData } from './utils';
 import { UnresolvableFieldData } from '../resolvability-graph/utils';
-import { FieldSetDirective } from '../schema-building/utils';
-import { EntityInterfaceFederationData, ImplementationErrors, InvalidArgument, InvalidEntityInterface, InvalidRequiredInputValueData } from '../utils/utils';
+import { ImplementationErrors, InvalidArgument, InvalidEntityInterface, InvalidRequiredInputValueData } from '../utils/types';
 export declare const minimumSubgraphRequirementError: Error;
 export declare function multipleNamedTypeDefinitionError(typeName: string, firstTypeString: string, secondTypeString: string): Error;
 export declare function incompatibleArgumentTypesError(argName: string, hostPath: string, expectedType: string, actualType: string): Error;
@@ -36,7 +35,6 @@ export declare function undefinedRequiredArgumentsErrorMessage(directiveName: st
 export declare function unexpectedDirectiveArgumentErrorMessage(directiveName: string, argumentNames: string[]): string;
 export declare function duplicateDirectiveArgumentDefinitionsErrorMessage(argumentNames: string[]): string;
 export declare function invalidArgumentValueErrorMessage(value: string, hostName: string, argumentName: string, expectedTypeString: string): string;
-export declare function invalidDirectiveArgumentTypeErrorMessage(required: boolean, argumentName: string, expectedKind: Kind, actualKind: Kind): string;
 export declare function invalidKeyDirectivesError(parentTypeName: string, errorMessages: string[]): Error;
 export declare function maximumTypeNestingExceededError(path: string): Error;
 export declare function unexpectedKindFatalError(typeName: string): Error;
@@ -44,12 +42,9 @@ export declare function incompatibleParentKindFatalError(parentTypeName: string,
 export declare function unexpectedEdgeFatalError(typeName: string, edgeNames: Array<string>): Error;
 export declare function incompatibleParentKindMergeError(parentTypeName: string, expectedTypeString: string, actualTypeString: string): Error;
 export declare function fieldTypeMergeFatalError(fieldName: string): Error;
-export declare function unexpectedDirectiveLocationError(locationName: string): Error;
 export declare function unexpectedTypeNodeKindFatalError(typePath: string): Error;
 export declare function invalidKeyFatalError<K>(key: K, mapName: string): Error;
-export declare function invalidConfigurationResultFatalError(fieldPath: string): Error;
 export declare const subgraphValidationFailureError: Error;
-export declare const federationFactoryInitializationFatalError: Error;
 export declare function unexpectedParentKindForChildError(parentTypeName: string, expectedTypeString: string, actualTypeString: string, childName: string, childTypeString: string): Error;
 export declare function subgraphValidationError(subgraphName: string, errors: Error[]): Error;
 export declare function invalidSubgraphNameErrorMessage(index: number, newName: string): string;
@@ -64,20 +59,20 @@ export declare function noQueryRootTypeError(isRouterSchema?: boolean): Error;
 export declare const inaccessibleQueryRootTypeError: Error;
 export declare function expectedEntityError(typeName: string): Error;
 export declare const inlineFragmentInFieldSetErrorMessage = " Inline fragments are not currently supported within a field set argument.";
-export declare function abstractTypeInKeyFieldSetErrorMessage(fieldSet: string, fieldCoordinates: string, abstractTypeName: string, abstractTypeString: string): string;
-export declare function unknownTypeInFieldSetErrorMessage(fieldSet: string, fieldPath: string, responseTypeName: string): string;
+export declare function abstractTypeInKeyFieldSetErrorMessage(fieldSet: string, fieldCoords: string, abstractTypeName: string, abstractTypeString: string): string;
+export declare function unknownTypeInFieldSetErrorMessage(fieldSet: string, fieldCoords: string, responseTypeName: string): string;
 export declare function invalidSelectionSetErrorMessage(fieldSet: string, fieldCoordinatesPath: Array<string>, selectionSetTypeName: string, fieldTypeString: string): string;
 export declare function invalidSelectionSetDefinitionErrorMessage(fieldSet: string, fieldCoordinatesPath: Array<string>, selectionSetTypeName: string, fieldTypeString: string): string;
 export declare function undefinedFieldInFieldSetErrorMessage(fieldSet: string, parentTypeName: string, fieldName: string): string;
 export declare function unparsableFieldSetErrorMessage(fieldSet: string, error?: Error): string;
 export declare function unparsableFieldSetSelectionErrorMessage(fieldSet: string, fieldName: string): string;
-export declare function undefinedObjectLikeParentError(parentTypeName: string): Error;
+export declare function undefinedCompositeOutputTypeError(parentTypeName: string): Error;
 export declare function unexpectedArgumentErrorMessage(fieldSet: string, fieldPath: string, argumentName: string): string;
 export declare function argumentsInKeyFieldSetErrorMessage(fieldSet: string, fieldPath: string): string;
 export declare function invalidProvidesOrRequiresDirectivesError(directiveName: string, errorMessages: string[]): Error;
 export declare function duplicateFieldInFieldSetErrorMessage(fieldSet: string, fieldPath: string): string;
 export declare function invalidConfigurationDataErrorMessage(typeName: string, fieldName: string, fieldSet: string): string;
-export declare function incompatibleTypeWithProvidesErrorMessage(fieldCoordinates: string, responseType: string): string;
+export declare function incompatibleTypeWithProvidesErrorMessage(fieldCoords: string, responseType: string): string;
 export declare function invalidInlineFragmentTypeErrorMessage(fieldSet: string, fieldCoordinatesPath: Array<string>, typeConditionName: string, selectionSetTypeName: string): string;
 export declare function inlineFragmentWithoutTypeConditionErrorMessage(fieldSet: string, fieldPath: string): string;
 export declare function unknownInlineFragmentTypeConditionErrorMessage(fieldSet: string, fieldCoordinatesPath: Array<string>, selectionSetTypeName: string, typeConditionName: string): string;
@@ -142,7 +137,7 @@ export declare function nonLeafSubscriptionFieldConditionFieldPathFinalFieldErro
 export declare function unresolvablePathError({ fieldName, selectionSet }: UnresolvableFieldData, reasons: Array<string>): Error;
 export declare function allExternalFieldInstancesError(typeName: string, subgraphNamesByFieldName: Map<string, Array<string>>): Error;
 export declare function externalInterfaceFieldsError(typeName: string, fieldNames: Array<string>): Error;
-export declare function nonExternalConditionalFieldError(originCoords: string, subgraphName: string, targetCoords: string, fieldSet: string, fieldSetDirective: FieldSetDirective): Error;
+export declare function nonExternalConditionalFieldError(directiveCoords: string, subgraphName: string, targetCoords: string, fieldSet: string, fieldSetDirectiveName: string): Error;
 export declare function incompatibleFederatedFieldNamedTypeError(fieldCoordinates: string, subgraphNamesByNamedTypeName: Map<string, Set<string>>): Error;
 export declare function unknownNamedTypeErrorMessage(fieldCoordinates: string, namedTypeName: string): string;
 export declare function unknownNamedTypeError(fieldCoordinates: string, namedTypeName: string): Error;
@@ -155,3 +150,5 @@ export declare function duplicateDirectiveDefinitionArgumentErrorMessage(argumen
 export declare function duplicateDirectiveDefinitionLocationErrorMessage(locationName: string): string;
 export declare function invalidDirectiveDefinitionLocationErrorMessage(locationName: string): string;
 export declare function invalidDirectiveDefinitionError(directiveName: string, errorMessages: Array<string>): Error;
+export declare function fieldAlreadyProvidedErrorMessage(fieldCoords: string, subgraphName: string, directiveName: string): string;
+export declare function invalidInterfaceObjectImplementationDefinitionsError(typeName: string, subgraphName: string, implementationTypeNames: Array<string>): Error;