@wundergraph/composition 0.36.1 → 0.37.1

package/dist/v1/utils/utils.js

@@ -0,0 +1,336 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.maxOrScopes = void 0;
+exports.subtractSourceSetFromTargetSet = subtractSourceSetFromTargetSet;
+exports.mapToArrayOfValues = mapToArrayOfValues;
+exports.kindToConvertedTypeString = kindToConvertedTypeString;
+exports.fieldDatasToSimpleFieldDatas = fieldDatasToSimpleFieldDatas;
+exports.isNodeLeaf = isNodeLeaf;
+exports.newEntityInterfaceFederationData = newEntityInterfaceFederationData;
+exports.upsertEntityInterfaceFederationData = upsertEntityInterfaceFederationData;
+exports.upsertEntityData = upsertEntityData;
+exports.updateEntityData = updateEntityData;
+exports.newFieldAuthorizationData = newFieldAuthorizationData;
+exports.resetAuthorizationData = resetAuthorizationData;
+exports.getAuthorizationDataToUpdate = getAuthorizationDataToUpdate;
+exports.newAuthorizationData = newAuthorizationData;
+exports.mergeAuthorizationDataByAND = mergeAuthorizationDataByAND;
+exports.upsertFieldAuthorizationData = upsertFieldAuthorizationData;
+exports.upsertAuthorizationData = upsertAuthorizationData;
+exports.upsertAuthorizationConfiguration = upsertAuthorizationConfiguration;
+exports.setAndGetValue = setAndGetValue;
+exports.isNodeKindInterface = isNodeKindInterface;
+exports.isNodeKindObject = isNodeKindObject;
+exports.addMapEntries = addMapEntries;
+exports.getSingleSetEntry = getSingleSetEntry;
+const graphql_1 = require("graphql");
+const string_constants_1 = require("../../utils/string-constants");
+const utils_1 = require("../../utils/utils");
+function subtractSourceSetFromTargetSet(source, target) {
+    for (const entry of source) {
+        target.delete(entry);
+    }
+}
+function mapToArrayOfValues(map) {
+    const output = [];
+    for (const value of map.values()) {
+        output.push(value);
+    }
+    return output;
+}
+function kindToConvertedTypeString(kind) {
+    switch (kind) {
+        case graphql_1.Kind.BOOLEAN: {
+            return string_constants_1.BOOLEAN_SCALAR;
+        }
+        case graphql_1.Kind.ENUM:
+        // intentional fallthrough
+        case graphql_1.Kind.ENUM_TYPE_DEFINITION:
+        // intentional fallthrough
+        case graphql_1.Kind.ENUM_TYPE_EXTENSION: {
+            return string_constants_1.ENUM;
+        }
+        case graphql_1.Kind.ENUM_VALUE_DEFINITION: {
+            return string_constants_1.ENUM_VALUE;
+        }
+        case graphql_1.Kind.FIELD_DEFINITION: {
+            return string_constants_1.FIELD;
+        }
+        case graphql_1.Kind.FLOAT: {
+            return string_constants_1.FLOAT_SCALAR;
+        }
+        case graphql_1.Kind.INPUT_OBJECT_TYPE_DEFINITION:
+        // intentional fallthrough
+        case graphql_1.Kind.INPUT_OBJECT_TYPE_EXTENSION: {
+            return string_constants_1.INPUT_OBJECT;
+        }
+        case graphql_1.Kind.INPUT_VALUE_DEFINITION: {
+            return string_constants_1.INPUT_VALUE;
+        }
+        case graphql_1.Kind.INT: {
+            return string_constants_1.INT_SCALAR;
+        }
+        case graphql_1.Kind.INTERFACE_TYPE_DEFINITION:
+        // intentional fallthrough
+        case graphql_1.Kind.INTERFACE_TYPE_EXTENSION: {
+            return string_constants_1.INTERFACE;
+        }
+        case graphql_1.Kind.NULL: {
+            return string_constants_1.NULL;
+        }
+        case graphql_1.Kind.OBJECT:
+        // intentional fallthrough
+        case graphql_1.Kind.OBJECT_TYPE_DEFINITION:
+        // intentional fallthrough
+        case graphql_1.Kind.OBJECT_TYPE_EXTENSION: {
+            return string_constants_1.OBJECT;
+        }
+        case graphql_1.Kind.STRING: {
+            return string_constants_1.STRING_SCALAR;
+        }
+        case graphql_1.Kind.SCALAR_TYPE_DEFINITION:
+        // intentional fallthrough
+        case graphql_1.Kind.SCALAR_TYPE_EXTENSION: {
+            return string_constants_1.SCALAR;
+        }
+        case graphql_1.Kind.UNION_TYPE_DEFINITION:
+        // intentional fallthrough
+        case graphql_1.Kind.UNION_TYPE_EXTENSION: {
+            return string_constants_1.UNION;
+        }
+        default:
+            return kind;
+    }
+}
+function fieldDatasToSimpleFieldDatas(fieldDatas) {
+    const simpleFieldDatas = [];
+    for (const { name, namedTypeName } of fieldDatas) {
+        simpleFieldDatas.push({ name, namedTypeName });
+    }
+    return simpleFieldDatas;
+}
+// Only used to assess the output type of field definitions for graph selection set rendering
+function isNodeLeaf(kind) {
+    // Base scalars are not added to parent definition data
+    if (!kind) {
+        return true;
+    }
+    switch (kind) {
+        case graphql_1.Kind.OBJECT_TYPE_DEFINITION:
+        case graphql_1.Kind.INTERFACE_TYPE_DEFINITION:
+        case graphql_1.Kind.UNION_TYPE_DEFINITION:
+            return false;
+        default:
+            return true;
+    }
+}
+function newEntityInterfaceFederationData(entityInterfaceData, subgraphName) {
+    return {
+        concreteTypeNames: new Set(entityInterfaceData.concreteTypeNames),
+        fieldDatasBySubgraphName: new Map([[subgraphName, entityInterfaceData.fieldDatas]]),
+        interfaceFieldNames: new Set(entityInterfaceData.interfaceFieldNames),
+        interfaceObjectFieldNames: new Set(entityInterfaceData.interfaceObjectFieldNames),
+        interfaceObjectSubgraphs: new Set(entityInterfaceData.isInterfaceObject ? [subgraphName] : []),
+        subgraphDataByTypeName: new Map([[subgraphName, entityInterfaceData]]),
+        typeName: entityInterfaceData.typeName,
+    };
+}
+function upsertEntityInterfaceFederationData(federationData, subgraphData, subgraphName) {
+    (0, utils_1.addIterableValuesToSet)(subgraphData.concreteTypeNames, federationData.concreteTypeNames);
+    federationData.subgraphDataByTypeName.set(subgraphName, subgraphData);
+    federationData.fieldDatasBySubgraphName.set(subgraphName, subgraphData.fieldDatas);
+    (0, utils_1.addIterableValuesToSet)(subgraphData.interfaceFieldNames, federationData.interfaceFieldNames);
+    (0, utils_1.addIterableValuesToSet)(subgraphData.interfaceObjectFieldNames, federationData.interfaceObjectFieldNames);
+    if (subgraphData.isInterfaceObject) {
+        federationData.interfaceObjectSubgraphs.add(subgraphName);
+    }
+}
+function newEntityData({ keyFieldSetDataByFieldSet, subgraphName, typeName }) {
+    const keyFieldSetDatasBySubgraphName = new Map([
+        [subgraphName, keyFieldSetDataByFieldSet],
+    ]);
+    const documentNodeByKeyFieldSet = new Map();
+    for (const [keyFieldSet, { documentNode, isUnresolvable }] of keyFieldSetDataByFieldSet) {
+        // Do not propagate invalid key targets
+        if (isUnresolvable) {
+            continue;
+        }
+        documentNodeByKeyFieldSet.set(keyFieldSet, documentNode);
+    }
+    return {
+        keyFieldSetDatasBySubgraphName,
+        documentNodeByKeyFieldSet,
+        keyFieldSets: new Set(),
+        subgraphNames: new Set([subgraphName]),
+        typeName,
+    };
+}
+function upsertEntityData({ entityDataByTypeName, keyFieldSetDataByFieldSet, subgraphName, typeName, }) {
+    const existingData = entityDataByTypeName.get(typeName);
+    existingData
+        ? updateEntityData({ entityData: existingData, keyFieldSetDataByFieldSet, subgraphName })
+        : entityDataByTypeName.set(typeName, newEntityData({ keyFieldSetDataByFieldSet, subgraphName, typeName }));
+}
+function updateEntityData({ entityData, keyFieldSetDataByFieldSet, subgraphName }) {
+    entityData.subgraphNames.add(subgraphName);
+    const existingKeyFieldSetDataByFieldSet = entityData.keyFieldSetDatasBySubgraphName.get(subgraphName);
+    if (!existingKeyFieldSetDataByFieldSet) {
+        entityData.keyFieldSetDatasBySubgraphName.set(subgraphName, keyFieldSetDataByFieldSet);
+        for (const [keyFieldSet, { documentNode, isUnresolvable }] of keyFieldSetDataByFieldSet) {
+            // Do not propagate invalid key targets
+            if (isUnresolvable) {
+                continue;
+            }
+            entityData.documentNodeByKeyFieldSet.set(keyFieldSet, documentNode);
+        }
+        return;
+    }
+    for (const [keyFieldSet, keyFieldSetData] of keyFieldSetDataByFieldSet) {
+        // Do not propagate invalid key targets
+        if (!keyFieldSetData.isUnresolvable) {
+            entityData.documentNodeByKeyFieldSet.set(keyFieldSet, keyFieldSetData.documentNode);
+        }
+        const existingKeyFieldSetData = existingKeyFieldSetDataByFieldSet.get(keyFieldSet);
+        if (existingKeyFieldSetData) {
+            existingKeyFieldSetData.isUnresolvable ||= keyFieldSetData.isUnresolvable;
+            continue;
+        }
+        existingKeyFieldSetDataByFieldSet.set(keyFieldSet, keyFieldSetData);
+    }
+}
+function newFieldAuthorizationData(fieldName) {
+    return {
+        fieldName,
+        requiresAuthentication: false,
+        requiredScopes: [],
+    };
+}
+function resetAuthorizationData(authorizationData) {
+    if (!authorizationData) {
+        return;
+    }
+    authorizationData.requiresAuthentication = false;
+    authorizationData.requiredScopes = [];
+    authorizationData.hasParentLevelAuthorization = false;
+}
+function getAuthorizationDataToUpdate(authorizationContainer, node) {
+    if (node.kind === graphql_1.Kind.FIELD_DEFINITION) {
+        const name = node.name.value;
+        return (0, utils_1.getValueOrDefault)(authorizationContainer.fieldAuthorizationDataByFieldName, name, () => newFieldAuthorizationData(name));
+    }
+    authorizationContainer.hasParentLevelAuthorization = true;
+    return authorizationContainer;
+}
+function newAuthorizationData(typeName) {
+    return {
+        fieldAuthorizationDataByFieldName: new Map(),
+        hasParentLevelAuthorization: false,
+        requiresAuthentication: false,
+        requiredScopes: [],
+        typeName,
+    };
+}
+exports.maxOrScopes = 16;
+function mergeAuthorizationDataByAND(source, target) {
+    target.requiresAuthentication ||= source.requiresAuthentication;
+    const sourceScopesLength = source.requiredScopes.length;
+    if (sourceScopesLength < 1) {
+        return true;
+    }
+    const targetScopesLength = target.requiredScopes.length;
+    if (targetScopesLength < 1) {
+        if (sourceScopesLength > exports.maxOrScopes) {
+            return false;
+        }
+        for (const andScopes of source.requiredScopes) {
+            target.requiredScopes.push(new Set(andScopes));
+        }
+        return true;
+    }
+    if (sourceScopesLength * targetScopesLength > exports.maxOrScopes) {
+        return false;
+    }
+    const mergedOrScopes = [];
+    for (const existingAndScopes of target.requiredScopes) {
+        for (const incomingAndScopes of source.requiredScopes) {
+            const newAndScopes = new Set(existingAndScopes);
+            (0, utils_1.addIterableValuesToSet)(incomingAndScopes, newAndScopes);
+            mergedOrScopes.push(newAndScopes);
+        }
+    }
+    target.requiredScopes = mergedOrScopes;
+    return true;
+}
+function upsertFieldAuthorizationData(fieldAuthorizationDataByFieldName, incomingFieldAuthorizationData) {
+    const fieldName = incomingFieldAuthorizationData.fieldName;
+    const existingFieldAuthorizationData = fieldAuthorizationDataByFieldName.get(fieldName);
+    if (!existingFieldAuthorizationData) {
+        if (incomingFieldAuthorizationData.requiredScopes.length > exports.maxOrScopes) {
+            return false;
+        }
+        const fieldAuthorizationData = newFieldAuthorizationData(fieldName);
+        fieldAuthorizationData.requiresAuthentication ||= incomingFieldAuthorizationData.requiresAuthentication;
+        for (const andScopes of incomingFieldAuthorizationData.requiredScopes) {
+            fieldAuthorizationData.requiredScopes.push(new Set(andScopes));
+        }
+        fieldAuthorizationDataByFieldName.set(fieldName, fieldAuthorizationData);
+        return true;
+    }
+    existingFieldAuthorizationData.requiresAuthentication ||= incomingFieldAuthorizationData.requiresAuthentication;
+    return mergeAuthorizationDataByAND(incomingFieldAuthorizationData, existingFieldAuthorizationData);
+}
+function upsertAuthorizationData(authorizationDataByParentTypeName, incomingAuthorizationData, invalidOrScopesFieldPaths) {
+    const existingAuthorizationData = authorizationDataByParentTypeName.get(incomingAuthorizationData.typeName);
+    if (!existingAuthorizationData) {
+        authorizationDataByParentTypeName.set(incomingAuthorizationData.typeName, incomingAuthorizationData);
+        return;
+    }
+    for (const [fieldName, fieldAuthorizationData] of incomingAuthorizationData.fieldAuthorizationDataByFieldName) {
+        if (!upsertFieldAuthorizationData(existingAuthorizationData.fieldAuthorizationDataByFieldName, fieldAuthorizationData)) {
+            invalidOrScopesFieldPaths.add(`${incomingAuthorizationData.typeName}.${fieldName}`);
+        }
+    }
+}
+function upsertAuthorizationConfiguration(fieldConfigurationByFieldPath, authorizationData) {
+    const typeName = authorizationData.typeName;
+    for (const [fieldName, fieldAuthorizationData] of authorizationData.fieldAuthorizationDataByFieldName) {
+        const fieldPath = `${typeName}.${fieldName}`;
+        const existingFieldConfiguration = fieldConfigurationByFieldPath.get(fieldPath);
+        if (existingFieldConfiguration) {
+            existingFieldConfiguration.requiresAuthentication = fieldAuthorizationData.requiresAuthentication;
+            existingFieldConfiguration.requiredScopes = fieldAuthorizationData.requiredScopes.map((orScopes) => [
+                ...orScopes,
+            ]);
+        }
+        else {
+            fieldConfigurationByFieldPath.set(fieldPath, {
+                argumentNames: [],
+                typeName,
+                fieldName,
+                requiresAuthentication: fieldAuthorizationData.requiresAuthentication,
+                requiredScopes: fieldAuthorizationData.requiredScopes.map((orScopes) => [...orScopes]),
+            });
+        }
+    }
+}
+function setAndGetValue(map, key, value) {
+    map.set(key, value);
+    return value;
+}
+function isNodeKindInterface(kind) {
+    return kind === graphql_1.Kind.INTERFACE_TYPE_DEFINITION || kind === graphql_1.Kind.INTERFACE_TYPE_EXTENSION;
+}
+function isNodeKindObject(kind) {
+    return kind === graphql_1.Kind.OBJECT_TYPE_DEFINITION || kind === graphql_1.Kind.OBJECT_TYPE_EXTENSION;
+}
+function addMapEntries(source, target) {
+    for (const [key, value] of source) {
+        target.set(key, value);
+    }
+}
+function getSingleSetEntry(set) {
+    for (const entry of set) {
+        return entry;
+    }
+}
+//# sourceMappingURL=utils.js.map

package/dist/v1/utils/utils.js.map

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

package/dist/{warnings → v1/warnings}/warnings.d.ts

@@ -1,19 +1,10 @@
-import { FieldSetDirective } from '../schema-building/utils';
-export type WarningSubgraphData = {
-    name: string;
-};
-export type WarningOptions = {
-    message: string;
-    subgraph: WarningSubgraphData;
-};
-export declare class Warning extends Error {
-    subgraph: WarningSubgraphData;
-    constructor(options: WarningOptions);
-}
+import { Warning } from '../../warnings/types';
 export declare function invalidOverrideTargetSubgraphNameWarning(targetSubgraphName: string, parentTypeName: string, fieldNames: string[], originSubgraphName: string): Warning;
 export declare function externalInterfaceFieldsWarning(subgraphName: string, typeName: string, fieldNames: Array<string>): Warning;
-export declare function nonExternalConditionalFieldWarning(originCoords: string, subgraphName: string, targetCoords: string, fieldSet: string, fieldSetDirective: FieldSetDirective): Warning;
+export declare function nonExternalConditionalFieldWarning(directiveCoords: string, subgraphName: string, targetCoords: string, fieldSet: string, fieldSetDirectiveName: string): Warning;
 export declare function unimplementedInterfaceOutputTypeWarning(subgraphName: string, interfaceTypeName: string): Warning;
 export declare function invalidExternalFieldWarning(fieldCoords: string, subgraphName: string): Warning;
 export declare function requiresDefinedOnNonEntityFieldWarning(fieldCoords: string, subgraphName: string): Warning;
 export declare function consumerInactiveThresholdInvalidValueWarning(subgraphName: string, additionalMsg?: string): Warning;
+export declare function externalEntityExtensionKeyFieldWarning(entityName: string, fieldSet: string, externalFieldCoordinates: Array<string>, subgraphName: string): Warning;
+export declare function fieldAlreadyProvidedWarning(fieldCoords: string, directiveName: string, directiveCoords: string, subgraphName: string): Warning;

package/dist/{warnings → v1/warnings}/warnings.js

@@ -1,6 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Warning = void 0;
 exports.invalidOverrideTargetSubgraphNameWarning = invalidOverrideTargetSubgraphNameWarning;
 exports.externalInterfaceFieldsWarning = externalInterfaceFieldsWarning;
 exports.nonExternalConditionalFieldWarning = nonExternalConditionalFieldWarning;
@@ -8,18 +7,12 @@ exports.unimplementedInterfaceOutputTypeWarning = unimplementedInterfaceOutputTy
 exports.invalidExternalFieldWarning = invalidExternalFieldWarning;
 exports.requiresDefinedOnNonEntityFieldWarning = requiresDefinedOnNonEntityFieldWarning;
 exports.consumerInactiveThresholdInvalidValueWarning = consumerInactiveThresholdInvalidValueWarning;
-const string_constants_1 = require("../utils/string-constants");
-class Warning extends Error {
-    subgraph;
-    constructor(options) {
-        super(options.message);
-        this.name = 'Warning';
-        this.subgraph = options.subgraph;
-    }
-}
-exports.Warning = Warning;
+exports.externalEntityExtensionKeyFieldWarning = externalEntityExtensionKeyFieldWarning;
+exports.fieldAlreadyProvidedWarning = fieldAlreadyProvidedWarning;
+const types_1 = require("../../warnings/types");
+const string_constants_1 = require("../../utils/string-constants");
 function invalidOverrideTargetSubgraphNameWarning(targetSubgraphName, parentTypeName, fieldNames, originSubgraphName) {
-    return new Warning({
+    return new types_1.Warning({
         message: `The Object type "${parentTypeName}" defines the directive "@override(from: "${targetSubgraphName}")" on the following field` +
             (fieldNames.length > 1 ? 's' : '') +
             `: "` +
@@ -39,14 +32,14 @@ function versionOneWarningPropagationMessage(subgraphName) {
         ` propagate as an error:\n`);
 }
 function externalInterfaceFieldsWarning(subgraphName, typeName, fieldNames) {
-    return new Warning({
+    return new types_1.Warning({
         message: versionOneWarningPropagationMessage(subgraphName) +
-            `The Interface "${typeName}" is invalid because the following Field definition` +
+            `The Interface "${typeName}" is invalid because the following field definition` +
             (fieldNames.length > 1 ? 's are' : ' is') +
             ` declared "@external":\n "` +
             fieldNames.join(string_constants_1.QUOTATION_JOIN) +
             `"\n` +
-            `Interface Fields should not be declared "@external". This is because Interface Fields do not resolve directly,` +
+            `Interface fields should not be declared "@external". This is because Interface fields do not resolve directly,` +
             ` but the "@external" directive relates to whether a Field instance can be resolved` +
             ` by the subgraph in which it is defined.`,
         subgraph: {
@@ -54,14 +47,14 @@ function externalInterfaceFieldsWarning(subgraphName, typeName, fieldNames) {
         },
     });
 }
-function nonExternalConditionalFieldWarning(originCoords, subgraphName, targetCoords, fieldSet, fieldSetDirective) {
-    return new Warning({
+function nonExternalConditionalFieldWarning(directiveCoords, subgraphName, targetCoords, fieldSet, fieldSetDirectiveName) {
+    return new types_1.Warning({
         message: versionOneWarningPropagationMessage(subgraphName) +
-            `The Field "${originCoords}" in subgraph "${subgraphName}" defines a "@${fieldSetDirective}" directive with the following` +
-            ` field set:\n "${fieldSet}".` +
-            `\nHowever, neither the Field "${targetCoords}" nor any of its field set ancestors are declared @external.` +
+            `The Field "${directiveCoords}" in subgraph "${subgraphName}" defines a "@${fieldSetDirectiveName}" directive with` +
+            ` the following field set:\n "${fieldSet}".` +
+            `\nHowever, neither the field "${targetCoords}" nor any of its field set ancestors are declared @external.` +
             `\nConsequently, "${targetCoords}" is already provided by subgraph "${subgraphName}" and should not form part of` +
-            ` a "@${fieldSetDirective}" directive field set.`,
+            ` a "@${fieldSetDirectiveName}" directive field set.`,
         subgraph: {
             name: subgraphName,
         },
@@ -69,7 +62,7 @@ function nonExternalConditionalFieldWarning(originCoords, subgraphName, targetCo
 }
 // TODO Temporarily only used as a warning
 function unimplementedInterfaceOutputTypeWarning(subgraphName, interfaceTypeName) {
-    return new Warning({
+    return new types_1.Warning({
         message: `Subgraph "${subgraphName}": The Interface "${interfaceTypeName}" is used as an output type` +
             ` without at least one Object type implementation defined in the schema.`,
         subgraph: {
@@ -78,10 +71,10 @@ function unimplementedInterfaceOutputTypeWarning(subgraphName, interfaceTypeName
     });
 }
 function invalidExternalFieldWarning(fieldCoords, subgraphName) {
-    return new Warning({
+    return new types_1.Warning({
         message: versionOneWarningPropagationMessage(subgraphName) +
-            ` The Object Field "${fieldCoords}" is invalidly declared "@external". An Object Field should only` +
-            ` be declared "@external" if it is part of a "@key", "@provides", or "@requires" FieldSet, or the Field is` +
+            ` The Object Field "${fieldCoords}" is invalidly declared "@external". An Object field should only` +
+            ` be declared "@external" if it is part of a "@key", "@provides", or "@requires" filed set, or the field is` +
             ` necessary to satisfy an Interface implementation. In the case that none of these conditions is true, the` +
             ` "@external" directive should be removed.`,
         subgraph: {
@@ -90,7 +83,7 @@ function invalidExternalFieldWarning(fieldCoords, subgraphName) {
     });
 }
 function requiresDefinedOnNonEntityFieldWarning(fieldCoords, subgraphName) {
-    return new Warning({
+    return new types_1.Warning({
         message: ` The Object Field "${fieldCoords}" defines a "@requires" directive, but the Object is not an entity.` +
             ' Consequently, the "@requires" FieldSet cannot be satisfied because there is no entity resolver with which to' +
             ' provide the required Fields.',
@@ -100,7 +93,7 @@ function requiresDefinedOnNonEntityFieldWarning(fieldCoords, subgraphName) {
     });
 }
 function consumerInactiveThresholdInvalidValueWarning(subgraphName, additionalMsg = '') {
-    return new Warning({
+    return new types_1.Warning({
         message: `The "consumerInactiveThreshold" argument of type "Int" should be positive and smaller than 2,147,483,648.` +
             +additionalMsg
             ? `\n${additionalMsg}`
@@ -110,4 +103,32 @@ function consumerInactiveThresholdInvalidValueWarning(subgraphName, additionalMs
         },
     });
 }
+function externalEntityExtensionKeyFieldWarning(entityName, fieldSet, externalFieldCoordinates, subgraphName) {
+    return new types_1.Warning({
+        message: `The entity extension "${entityName}" defined in subgraph "${subgraphName}" defines a "@key" directive` +
+            ` with the field set "${fieldSet}".\nThe following field coordinates that form part of that field set are` +
+            ` declared "@external":\n "` +
+            externalFieldCoordinates.join(string_constants_1.QUOTATION_JOIN) +
+            `"\nPlease note fields that form part of` +
+            ` entity extension "@key" field sets are always provided in that subgraph. Any such "@external" declarations` +
+            ` are unnecessary relics of Federation Version 1 syntax and are effectively ignored.`,
+        subgraph: {
+            name: subgraphName,
+        },
+    });
+}
+function fieldAlreadyProvidedWarning(fieldCoords, directiveName, directiveCoords, subgraphName) {
+    return new types_1.Warning({
+        message: versionOneWarningPropagationMessage(subgraphName) +
+            `The field "${fieldCoords}" is unconditionally provided by subgraph "${subgraphName}" and should not form` +
+            ` part of any "@${directiveName}" field set.` +
+            `\nHowever, "${fieldCoords}" forms part of the "@${directiveName}" field set defined "${directiveCoords}".` +
+            `\nAlthough "${fieldCoords}" is declared "@external", it is part of` +
+            ` a "@key" directive on an extension type. Such fields are only declared "@external" for legacy syntactical` +
+            ` reasons and are not internally considered "@external".`,
+        subgraph: {
+            name: subgraphName,
+        },
+    });
+}
 //# sourceMappingURL=warnings.js.map

package/dist/v1/warnings/warnings.js.map

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

package/dist/warnings/types.d.ts

@@ -0,0 +1,11 @@
+export type WarningSubgraphData = {
+    name: string;
+};
+export type WarningOptions = {
+    message: string;
+    subgraph: WarningSubgraphData;
+};
+export declare class Warning extends Error {
+    subgraph: WarningSubgraphData;
+    constructor(options: WarningOptions);
+}

package/dist/warnings/types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Warning = void 0;
+class Warning extends Error {
+    subgraph;
+    constructor(options) {
+        super(options.message);
+        this.name = 'Warning';
+        this.subgraph = options.subgraph;
+    }
+}
+exports.Warning = Warning;
+//# sourceMappingURL=types.js.map

package/dist/warnings/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/warnings/types.ts"],"names":[],"mappings":";;;AAQA,MAAa,OAAQ,SAAQ,KAAK;IAChC,QAAQ,CAAsB;IAE9B,YAAY,OAAuB;QACjC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;CACF;AARD,0BAQC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wundergraph/composition",
-  "version": "0.36.1",
+  "version": "0.37.1",
   "author": {
     "name": "WunderGraph Maintainers",
     "email": "info@wundergraph.com"
@@ -41,5 +41,5 @@
     "typescript": "5.5.2",
     "vitest": "^2.1.8"
   },
-  "gitHead": "1a9ec1459419816b4718464b5fa4605e4f6b9950"
+  "gitHead": "79ff27fe3a26d48e1c04da9429ebb64b8bf2b6f5"
 }