@apollo/federation-internals 2.0.0-preview.1 → 2.0.0-preview.10

package/dist/definitions.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScalarType = exports.SchemaDefinition = exports.RootType = exports.Schema = exports.CoreFeatures = exports.CoreFeature = exports.defaultSchemaBlueprint = exports.SchemaBlueprint = exports.NamedSchemaElementWithType = exports.NamedSchemaElement = exports.SchemaElement = exports.Extension = exports.sourceASTs = exports.DirectiveTargetElement = exports.isLeafType = exports.typeFromAST = exports.typeToAST = exports.executableDirectiveLocations = exports.runtimeTypesIntersects = exports.possibleRuntimeTypes = exports.isCompositeType = exports.isAbstractType = exports.isNullableType = exports.baseType = exports.isInputType = exports.isOutputType = exports.isInputObjectType = exports.isUnionType = exports.isEnumType = exports.isInterfaceType = exports.isObjectType = exports.isIDType = exports.isBooleanType = exports.isFloatType = exports.isStringType = exports.isIntType = exports.isCustomScalarType = exports.isScalarType = exports.isNonNullType = exports.isListType = exports.isWrapperType = exports.isNamedType = exports.isSchemaRootType = exports.defaultRootName = exports.allSchemaRootKinds = exports.typenameFieldName = exports.printErrors = exports.printGraphQLErrorsOrRethrow = exports.errorCauses = exports.ErrGraphQLValidationFailed = void 0;
-exports.newNamedType = exports.variableDefinitionFromAST = exports.variableDefinitionsFromAST = exports.VariableDefinitions = exports.VariableDefinition = exports.variablesInArguments = exports.isVariable = exports.containsVariable = exports.mergeVariables = exports.Variable = exports.Directive = exports.DirectiveDefinition = exports.EnumValue = exports.ArgumentDefinition = exports.InputFieldDefinition = exports.FieldDefinition = exports.NonNullType = exports.ListType = exports.InputObjectType = exports.EnumType = exports.UnionType = exports.UnionMember = exports.InterfaceType = exports.ObjectType = exports.InterfaceImplementation = void 0;
+exports.RootType = exports.Schema = exports.CoreFeatures = exports.CoreFeature = exports.defaultSchemaBlueprint = exports.SchemaBlueprint = exports.NamedSchemaElementWithType = exports.NamedSchemaElement = exports.SchemaElement = exports.Extension = exports.sourceASTs = exports.DirectiveTargetElement = exports.isLeafType = exports.typeFromAST = exports.typeToAST = exports.executableDirectiveLocations = exports.runtimeTypesIntersects = exports.possibleRuntimeTypes = exports.isCompositeType = exports.isAbstractType = exports.isNullableType = exports.baseType = exports.filterTypesOfKind = exports.isTypeOfKind = exports.isInputType = exports.isOutputType = exports.isInputObjectType = exports.isUnionType = exports.isEnumType = exports.isInterfaceType = exports.isObjectType = exports.isIDType = exports.isBooleanType = exports.isFloatType = exports.isStringType = exports.isIntType = exports.isCustomScalarType = exports.isScalarType = exports.isNonNullType = exports.isListType = exports.isWrapperType = exports.isNamedType = exports.isSchemaRootType = exports.defaultRootName = exports.allSchemaRootKinds = exports.typenameFieldName = exports.printErrors = exports.printGraphQLErrorsOrRethrow = exports.errorCauses = exports.ErrGraphQLValidationFailed = void 0;
+exports.newNamedType = exports.variableDefinitionFromAST = exports.variableDefinitionsFromAST = exports.VariableDefinitions = exports.VariableDefinition = exports.variablesInArguments = exports.isVariable = exports.containsVariable = exports.mergeVariables = exports.Variable = exports.Directive = exports.DirectiveDefinition = exports.EnumValue = exports.ArgumentDefinition = exports.InputFieldDefinition = exports.FieldDefinition = exports.NonNullType = exports.ListType = exports.InputObjectType = exports.EnumType = exports.UnionType = exports.UnionMember = exports.InterfaceType = exports.ObjectType = exports.InterfaceImplementation = exports.ScalarType = exports.SchemaDefinition = void 0;
 const graphql_1 = require("graphql");
 const coreSpec_1 = require("./coreSpec");
 const utils_1 = require("./utils");
@@ -16,9 +16,12 @@ const validate_1 = require("graphql/validation/validate");
 const specifiedRules_1 = require("graphql/validation/specifiedRules");
 const validate_2 = require("./validate");
 const directiveAndTypeSpecification_1 = require("./directiveAndTypeSpecification");
+const suggestions_1 = require("./suggestions");
+const error_2 = require("./error");
 const validationErrorCode = 'GraphQLValidationFailed';
-const ErrGraphQLValidationFailed = (causes) => (0, core_schema_1.err)(validationErrorCode, {
-    message: 'The schema is not a valid GraphQL schema',
+const DEFAULT_VALIDATION_ERROR_MESSAGE = 'The schema is not a valid GraphQL schema.';
+const ErrGraphQLValidationFailed = (causes, message = DEFAULT_VALIDATION_ERROR_MESSAGE) => (0, core_schema_1.err)(validationErrorCode, {
+    message,
     causes
 });
 exports.ErrGraphQLValidationFailed = ErrGraphQLValidationFailed;
@@ -156,6 +159,19 @@ function isInputType(type) {
     }
 }
 exports.isInputType = isInputType;
+function isTypeOfKind(type, kind) {
+    return type.kind === kind;
+}
+exports.isTypeOfKind = isTypeOfKind;
+function filterTypesOfKind(types, kind) {
+    return types.reduce((acc, type) => {
+        if (isTypeOfKind(type, kind)) {
+            acc.push(type);
+        }
+        return acc;
+    }, []);
+}
+exports.filterTypesOfKind = filterTypesOfKind;
 function baseType(type) {
     return isWrapperType(type) ? type.baseType() : type;
 }
@@ -300,7 +316,7 @@ class DirectiveTargetElement {
 }
 exports.DirectiveTargetElement = DirectiveTargetElement;
 function sourceASTs(...elts) {
-    return elts.map(elt => elt === null || elt === void 0 ? void 0 : elt.sourceAST).filter(elt => elt !== undefined);
+    return elts.map(elt => elt === null || elt === void 0 ? void 0 : elt.sourceAST).filter((elt) => elt !== undefined);
 }
 exports.sourceASTs = sourceASTs;
 class Element {
@@ -371,7 +387,7 @@ class SchemaElement extends Element {
             ? this.appliedDirectivesOf(nameOrDefinition)
             : this.appliedDirectivesOf(nameOrDefinition)).length !== 0;
     }
-    applyDirective(nameOrDefOrDirective, args) {
+    applyDirective(nameOrDefOrDirective, args, asFirstDirective = false) {
         var _a;
         let toAdd;
         if (nameOrDefOrDirective instanceof Directive) {
@@ -385,9 +401,12 @@ class SchemaElement extends Element {
             let name;
             if (typeof nameOrDefOrDirective === 'string') {
                 this.checkUpdate();
-                const def = (_a = this.schema().directive(nameOrDefOrDirective)) !== null && _a !== void 0 ? _a : this.schema().blueprint.onMissingDirectiveDefinition(this.schema(), nameOrDefOrDirective);
+                const def = (_a = this.schema().directive(nameOrDefOrDirective)) !== null && _a !== void 0 ? _a : this.schema().blueprint.onMissingDirectiveDefinition(this.schema(), nameOrDefOrDirective, args);
                 if (!def) {
-                    throw new graphql_1.GraphQLError(`Cannot apply unknown directive "@${nameOrDefOrDirective}"`);
+                    throw this.schema().blueprint.onGraphQLJSValidationError(this.schema(), new graphql_1.GraphQLError(`Unknown directive "@${nameOrDefOrDirective}".`));
+                }
+                if (Array.isArray(def)) {
+                    throw (0, exports.ErrGraphQLValidationFailed)(def);
                 }
                 name = nameOrDefOrDirective;
             }
@@ -398,7 +417,12 @@ class SchemaElement extends Element {
             toAdd = new Directive(name, args !== null && args !== void 0 ? args : Object.create(null));
             Element.prototype['setParent'].call(toAdd, this);
         }
-        this._appliedDirectives.push(toAdd);
+        if (asFirstDirective) {
+            this._appliedDirectives.unshift(toAdd);
+        }
+        else {
+            this._appliedDirectives.push(toAdd);
+        }
         DirectiveDefinition.prototype['addReferencer'].call(toAdd.definition, toAdd);
         this.onModification();
         return toAdd;
@@ -602,10 +626,11 @@ class BaseExtensionMember extends Element {
     }
 }
 class SchemaBlueprint {
-    onMissingDirectiveDefinition(_schema, _name) {
+    onMissingDirectiveDefinition(_schema, _name, _args) {
         return undefined;
     }
     onDirectiveDefinitionAndSchemaParsed(_) {
+        return [];
     }
     ignoreParsedField(_type, _fieldName) {
         return false;
@@ -622,6 +647,25 @@ class SchemaBlueprint {
     validationRules() {
         return specifiedRules_1.specifiedSDLRules;
     }
+    onGraphQLJSValidationError(schema, error) {
+        var _a;
+        const matcher = /^Unknown directive "@(?<directive>[_A-Za-z][_0-9A-Za-z]*)"\.$/.exec(error.message);
+        const name = (_a = matcher === null || matcher === void 0 ? void 0 : matcher.groups) === null || _a === void 0 ? void 0 : _a.directive;
+        if (!name) {
+            return error;
+        }
+        const allDefinedDirectiveNames = schema.allDirectives().map((d) => d.name);
+        const suggestions = (0, suggestions_1.suggestionList)(name, allDefinedDirectiveNames);
+        if (suggestions.length === 0) {
+            return this.onUnknownDirectiveValidationError(schema, name, error);
+        }
+        else {
+            return (0, error_2.withModifiedErrorMessage)(error, `${error.message}${(0, suggestions_1.didYouMean)(suggestions.map((s) => '@' + s))}`);
+        }
+    }
+    onUnknownDirectiveValidationError(_schema, _unknownDirectiveName, error) {
+        return error;
+    }
 }
 exports.SchemaBlueprint = SchemaBlueprint;
 exports.defaultSchemaBlueprint = new SchemaBlueprint();
@@ -635,7 +679,8 @@ class CoreFeature {
     }
     isFeatureDefinition(element) {
         return element.name.startsWith(this.nameInSchema + '__')
-            || (element.kind === 'DirectiveDefinition' && element.name === this.nameInSchema);
+            || (element.kind === 'DirectiveDefinition' && element.name === this.nameInSchema)
+            || !!this.imports.find((i) => { var _a; return element.name === ((_a = i.as) !== null && _a !== void 0 ? _a : i.name); });
     }
     directiveNameInSchema(name) {
         var _a, _b;
@@ -689,7 +734,7 @@ class CoreFeatures {
         if (existing) {
             throw error(`Duplicate inclusion of feature ${url.identity}`);
         }
-        const imports = (0, coreSpec_1.extractCoreFeatureImports)(typedDirective);
+        const imports = (0, coreSpec_1.extractCoreFeatureImports)(url, typedDirective);
         const feature = new CoreFeature(url, (_b = args.as) !== null && _b !== void 0 ? _b : url.name, directive, imports, args.for);
         this.add(feature);
         directive.schema().blueprint.onAddedCoreFeature(directive.schema(), feature);
@@ -730,24 +775,25 @@ const graphQLBuiltInDirectivesSpecifications = [
     (0, directiveAndTypeSpecification_1.createDirectiveSpecification)({
         name: 'include',
         locations: [graphql_1.DirectiveLocation.FIELD, graphql_1.DirectiveLocation.FRAGMENT_SPREAD, graphql_1.DirectiveLocation.INLINE_FRAGMENT],
-        argumentFct: (schema) => [{ name: 'if', type: new NonNullType(schema.booleanType()) }]
+        argumentFct: (schema) => ({ args: [{ name: 'if', type: new NonNullType(schema.booleanType()) }], errors: [] })
     }),
     (0, directiveAndTypeSpecification_1.createDirectiveSpecification)({
         name: 'skip',
         locations: [graphql_1.DirectiveLocation.FIELD, graphql_1.DirectiveLocation.FRAGMENT_SPREAD, graphql_1.DirectiveLocation.INLINE_FRAGMENT],
-        argumentFct: (schema) => [{ name: 'if', type: new NonNullType(schema.booleanType()) }]
+        argumentFct: (schema) => ({ args: [{ name: 'if', type: new NonNullType(schema.booleanType()) }], errors: [] })
     }),
     (0, directiveAndTypeSpecification_1.createDirectiveSpecification)({
         name: 'deprecated',
         locations: [graphql_1.DirectiveLocation.FIELD_DEFINITION, graphql_1.DirectiveLocation.ENUM_VALUE, graphql_1.DirectiveLocation.ARGUMENT_DEFINITION, graphql_1.DirectiveLocation.INPUT_FIELD_DEFINITION],
-        argumentFct: (schema) => [{ name: 'reason', type: schema.stringType(), defaultValue: 'No longer supported' }]
+        argumentFct: (schema) => ({ args: [{ name: 'reason', type: schema.stringType(), defaultValue: 'No longer supported' }], errors: [] })
     }),
     (0, directiveAndTypeSpecification_1.createDirectiveSpecification)({
         name: 'specifiedBy',
         locations: [graphql_1.DirectiveLocation.SCALAR],
-        argumentFct: (schema) => [{ name: 'url', type: new NonNullType(schema.stringType()) }]
+        argumentFct: (schema) => ({ args: [{ name: 'url', type: new NonNullType(schema.stringType()) }], errors: [] })
     }),
 ];
+const coordinateRegexp = /^@?[_A-Za-z][_0-9A-Za-z]*(\.[_A-Za-z][_0-9A-Za-z]*)?(\([_A-Za-z][_0-9A-Za-z]*:\))?$/;
 class Schema {
     constructor(blueprint = exports.defaultSchemaBlueprint) {
         this.blueprint = blueprint;
@@ -838,22 +884,38 @@ class Schema {
     get schemaDefinition() {
         return this._schemaDefinition;
     }
-    types(kind) {
-        const allKinds = this._types.values();
-        return (kind ? allKinds.filter(t => t.kind === kind) : allKinds);
+    types() {
+        return this._types.values();
+    }
+    interfaceTypes() {
+        return filterTypesOfKind(this.types(), 'InterfaceType');
+    }
+    objectTypes() {
+        return filterTypesOfKind(this.types(), 'ObjectType');
     }
-    builtInTypes(kind, includeShadowed = false) {
+    unionTypes() {
+        return filterTypesOfKind(this.types(), 'UnionType');
+    }
+    scalarTypes() {
+        return filterTypesOfKind(this.types(), 'ScalarType');
+    }
+    inputTypes() {
+        return filterTypesOfKind(this.types(), 'InputObjectType');
+    }
+    enumTypes() {
+        return filterTypesOfKind(this.types(), 'EnumType');
+    }
+    builtInTypes(includeShadowed = false) {
         const allBuiltIns = this._builtInTypes.values();
-        const forKind = (kind ? allBuiltIns.filter(t => t.kind === kind) : allBuiltIns);
         return includeShadowed
-            ? forKind
-            : forKind.filter(t => !this.isShadowedBuiltInType(t));
+            ? allBuiltIns
+            : allBuiltIns.filter(t => !this.isShadowedBuiltInType(t));
     }
     isShadowedBuiltInType(type) {
         return type.isBuiltIn && this._types.has(type.name);
     }
-    allTypes(kind) {
-        return this.builtInTypes(kind).concat(this.types(kind));
+    allTypes() {
+        return this.builtInTypes().concat(this.types());
     }
     type(name) {
         const type = this._types.get(name);
@@ -985,7 +1047,7 @@ class Schema {
         this.runWithBuiltInModificationAllowed(() => {
             (0, introspection_1.addIntrospectionFields)(this);
         });
-        let errors = (0, validate_1.validateSDL)(this.toAST(), undefined, this.blueprint.validationRules());
+        let errors = (0, validate_1.validateSDL)(this.toAST(), undefined, this.blueprint.validationRules()).map((e) => this.blueprint.onGraphQLJSValidationError(this, e));
         errors = errors.concat((0, validate_2.validateSchema)(this));
         if (errors.length === 0) {
             this.runWithBuiltInModificationAllowed(() => {
@@ -1022,6 +1084,49 @@ class Schema {
     specifiedByDirective(schema) {
         return this.getBuiltInDirective(schema, 'specifiedBy');
     }
+    elementByCoordinate(coordinate) {
+        if (!coordinate.match(coordinateRegexp)) {
+            throw error(`Invalid argument "${coordinate}: it is not a syntactically valid graphQL coordinate."`);
+        }
+        const argStartIdx = coordinate.indexOf('(');
+        const start = argStartIdx < 0 ? coordinate : coordinate.slice(0, argStartIdx);
+        const argName = argStartIdx < 0 ? undefined : coordinate.slice(argStartIdx + 1, coordinate.length - 2);
+        const splittedStart = start.split('.');
+        const typeOrDirectiveName = splittedStart[0];
+        const fieldOrEnumName = splittedStart[1];
+        const isDirective = typeOrDirectiveName.startsWith('@');
+        if (isDirective) {
+            if (fieldOrEnumName) {
+                throw error(`Invalid argument "${coordinate}: it is not a syntactically valid graphQL coordinate."`);
+            }
+            const directive = this.directive(typeOrDirectiveName.slice(1));
+            return argName ? directive === null || directive === void 0 ? void 0 : directive.argument(argName) : directive;
+        }
+        else {
+            const type = this.type(typeOrDirectiveName);
+            if (!type || !fieldOrEnumName) {
+                return type;
+            }
+            switch (type.kind) {
+                case 'ObjectType':
+                case 'InterfaceType':
+                    const field = type.field(fieldOrEnumName);
+                    return argName ? field === null || field === void 0 ? void 0 : field.argument(argName) : field;
+                case 'InputObjectType':
+                    if (argName) {
+                        throw error(`Invalid argument "${coordinate}: it is not a syntactically valid graphQL coordinate."`);
+                    }
+                    return type.field(fieldOrEnumName);
+                case 'EnumType':
+                    if (argName) {
+                        throw error(`Invalid argument "${coordinate}: it is not a syntactically valid graphQL coordinate."`);
+                    }
+                    return type.value(fieldOrEnumName);
+                default:
+                    throw error(`Invalid argument "${coordinate}: it is not a syntactically valid graphQL coordinate."`);
+            }
+        }
+    }
 }
 exports.Schema = Schema;
 class RootType extends BaseExtensionMember {
@@ -1048,9 +1153,9 @@ class SchemaDefinition extends SchemaElement {
     roots() {
         return this._roots.values();
     }
-    applyDirective(nameOrDefOrDirective, args) {
+    applyDirective(nameOrDefOrDirective, args, asFirstDirective = false) {
         var _a, _b;
-        const applied = super.applyDirective(nameOrDefOrDirective, args);
+        const applied = super.applyDirective(nameOrDefOrDirective, args, asFirstDirective);
         const schema = this.schema();
         const coreFeatures = schema.coreFeatures;
         if ((0, coreSpec_1.isCoreSpecDirectiveApplication)(applied)) {
@@ -1060,9 +1165,12 @@ class SchemaDefinition extends SchemaElement {
             const schemaDirective = applied;
             const args = schemaDirective.arguments();
             const url = coreSpec_1.FeatureUrl.parse(((_a = args.url) !== null && _a !== void 0 ? _a : args.feature));
-            const imports = (0, coreSpec_1.extractCoreFeatureImports)(schemaDirective);
+            const imports = (0, coreSpec_1.extractCoreFeatureImports)(url, schemaDirective);
             const core = new CoreFeature(url, (_b = args.as) !== null && _b !== void 0 ? _b : url.name, schemaDirective, imports, args.for);
             Schema.prototype['markAsCoreSchema'].call(schema, core);
+            this.appliedDirectives
+                .filter((a) => a !== applied)
+                .forEach((other) => CoreFeatures.prototype['maybeAddFeature'].call(schema.coreFeatures, other));
         }
         else if (coreFeatures) {
             CoreFeatures.prototype['maybeAddFeature'].call(coreFeatures, applied);
@@ -1483,7 +1591,7 @@ class EnumType extends BaseNamedType {
         this._values = [];
     }
     get values() {
-        return this._values;
+        return Array.from(this._values);
     }
     value(name) {
         return this._values.find(v => v.name === name);
@@ -1787,6 +1895,7 @@ class InputFieldDefinition extends NamedSchemaElementWithType {
             return [];
         }
         this.onModification();
+        this.removeAppliedDirectives();
         InputObjectType.prototype['removeFieldInternal'].call(this._parent, this);
         this._parent = undefined;
         this.type = undefined;
@@ -1825,6 +1934,7 @@ class ArgumentDefinition extends NamedSchemaElementWithType {
             return [];
         }
         this.onModification();
+        this.removeAppliedDirectives();
         if (this._parent instanceof FieldDefinition) {
             FieldDefinition.prototype['removeArgumentInternal'].call(this._parent, this.name);
         }
@@ -1874,6 +1984,7 @@ class EnumValue extends NamedSchemaElement {
             return [];
         }
         this.onModification();
+        this.removeAppliedDirectives();
         EnumType.prototype['removeValueInternal'].call(this._parent, this);
         this._parent = undefined;
         return [];
@@ -2108,7 +2219,7 @@ class Directive extends Element {
         this.onModification();
         const coreFeatures = this.schema().coreFeatures;
         if (coreFeatures && this.name === coreFeatures.coreItself.nameInSchema) {
-            const url = coreSpec_1.FeatureUrl.parse(this._args['feature']);
+            const url = coreSpec_1.FeatureUrl.parse(this._args[coreFeatures.coreDefinition.urlArgName()]);
             if (url.identity === coreFeatures.coreItself.url.identity) {
                 Schema.prototype['unmarkAsCoreSchema'].call(this.schema());
                 for (const d of this.schema().schemaDefinition.appliedDirectivesOf(coreFeatures.coreItself.nameInSchema)) {