@graphql-tools/wrap

Schema Wrapping

This feature allows you to create a new schema by wrapping an existing one, applying various transformations such as renaming types. This is useful for integrating external schemas without causing naming conflicts.

const { wrapSchema, RenameTypes } = require('@graphql-tools/wrap');
const remoteSchema = await introspectSchema(fetcher);
const wrappedSchema = wrapSchema({
  schema: remoteSchema,
  transforms: [new RenameTypes((name) => `Prefixed_${name}`)]
});

Schema Delegation

Schema delegation enables you to delegate a query or mutation to another schema. This is particularly useful in schema stitching or when working with multiple underlying GraphQL APIs.

const { delegateToSchema } = require('@graphql-tools/wrap');
const result = await delegateToSchema({
  schema: wrappedSchema,
  operation: 'query',
  fieldName: 'someField',
  args: { id: '123' },
  context,
  info
});

Filtering Types

This feature allows you to filter out types from a schema based on a condition. It's useful for exposing only a subset of the schema to certain clients.

const { FilterTypes } = require('@graphql-tools/wrap');
const filteredSchema = wrapSchema({
  schema: originalSchema,
  transforms: [new FilterTypes((type) => Boolean(type.name.match(/^Public/)))]
});