@graphql-tools/utils 7.5.2 → 7.6.0

package/es5/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@graphql-tools/utils/es5",
-  "version": "7.5.2",
+  "version": "7.6.0",
   "description": "Common package containing utils and types for GraphQL tools",
   "sideEffects": false,
   "peerDependencies": {

package/es5/types.d.ts

@@ -1,4 +1,4 @@
-import { GraphQLEnumType, GraphQLInputObjectType, GraphQLScalarType } from 'graphql';
+import { GraphQLEnumType, GraphQLInputObjectType, GraphQLNamedType, GraphQLScalarType } from 'graphql';
 export interface SchemaPrintOptions {
     /**
      * Descriptions are defined as preceding string literals, however an older
@@ -16,10 +16,16 @@ export interface GetDocumentNodeFromSchemaOptions {
 export declare type PrintSchemaWithDirectivesOptions = SchemaPrintOptions & GetDocumentNodeFromSchemaOptions;
 export declare type Maybe<T> = null | undefined | T;
 export declare type Constructor<T> = new (...args: any[]) => T;
+export declare type PruneSchemaFilter = (type: GraphQLNamedType) => boolean;
 /**
  * Options for removing unused types from the schema
  */
 export interface PruneSchemaOptions {
+    /**
+     * Return true to skip pruning this type. This check will run first before any other options.
+     * This can be helpful for schemas that support type extensions like Apollo Federation.
+     */
+    skipPruning?: PruneSchemaFilter;
     /**
      * Set to `true` to skip pruning object types or interfaces with no no fields
      */

package/index.cjs.js

@@ -3356,6 +3356,10 @@ function pruneSchema(schema, options = {}) {
     visitTypes(pruningContext, schema);
     return mapSchema(schema, {
         [exports.MapperKind.TYPE]: (type) => {
+            // If we should NOT prune the type, return it immediately as unmodified
+            if (options.skipPruning && options.skipPruning(type)) {
+                return type;
+            }
             if (graphql.isObjectType(type) || graphql.isInputObjectType(type)) {
                 if ((!Object.keys(type.getFields()).length && !options.skipEmptyCompositeTypePruning) ||
                     (pruningContext.unusedTypes[type.name] && !options.skipUnusedTypesPruning)) {