graphql-compose это обертка над graphql-js.
graphql-js строит схему из конфига GraphQLObjectType и ежие с ними вложенными объектами.
graphql-compose позволяет этот конфиг собрать программным путем при запуске сервера. Т.е. он предоставляет регистр типов, SDL сахар создания этих самых типов и кучу методов для проверки наличия/создания/удаления полей, аргументов.
Один из кейсов, есть большая graphql-схема и надо сгенерировать из нее публичную урезанную схему и админскую.
Другой кейс, есть mongoose модели или typeorm или elasticserch маппинги - так вот из них моно на автомате генерить графкуэль типы, удалять “секурные поля” и уже потом конструировать схему. Т.е. исчезает прописывание одних и тех же полей по два раза (в схеме модели и в графкуэль типе).
—
Все популярные js инструменты, типа graphql-tools, typegraphql, graphql-compose, nexus, gqtx, graphql mesh - занимаются тем, что тем или иным способом строят инстанс GraphQLSchema чтобы ее передать в пакет graphql-js, который будет выполняет в рантайме запросы на вашей схеме. Т.е. пакет graphql-js фокусируется на рантайме и предоставляет классы типов, чтоб вы ему собрали схему в виде древовидного “конфига”. И кто собирал это дело руками, знает насколько муторно все это дело и пытаются тем или иным способом все это дело упростить, построив поверх свой абстрактный уровень с методами помогайками.
Отличие graphql-compose от всех остальных конструкторов схем в том, что можно схему строить на базе стандартных логических операторов. Например, если схема не админская, то в типе юзер удали поле email:
if (process.env.APP_ROLE !== ‘admin’) {
if (UserTC.hasField(‘email’) {
UserTC.removeField(‘email’);
}
}