@graphql-tools/utils
Version:
Common package containing utils and types for GraphQL tools
381 lines (380 loc) • 17.1 kB
JavaScript
;
Object.defineProperty(exports, "__esModule", { value: true });
exports.getDocumentNodeFromSchema = getDocumentNodeFromSchema;
exports.printSchemaWithDirectives = printSchemaWithDirectives;
exports.astFromSchema = astFromSchema;
exports.astFromDirective = astFromDirective;
exports.getDirectiveNodes = getDirectiveNodes;
exports.astFromArg = astFromArg;
exports.astFromObjectType = astFromObjectType;
exports.astFromInterfaceType = astFromInterfaceType;
exports.astFromUnionType = astFromUnionType;
exports.astFromInputObjectType = astFromInputObjectType;
exports.astFromEnumType = astFromEnumType;
exports.astFromScalarType = astFromScalarType;
exports.astFromField = astFromField;
exports.astFromInputField = astFromInputField;
exports.astFromEnumValue = astFromEnumValue;
exports.makeDeprecatedDirective = makeDeprecatedDirective;
exports.makeDirectiveNode = makeDirectiveNode;
exports.makeDirectiveNodes = makeDirectiveNodes;
const graphql_1 = require("graphql");
const astFromType_js_1 = require("./astFromType.js");
const astFromValue_js_1 = require("./astFromValue.js");
const astFromValueUntyped_js_1 = require("./astFromValueUntyped.js");
const descriptionFromObject_js_1 = require("./descriptionFromObject.js");
const get_directives_js_1 = require("./get-directives.js");
const helpers_js_1 = require("./helpers.js");
const rootTypes_js_1 = require("./rootTypes.js");
function getDocumentNodeFromSchema(schema, options = {}) {
const pathToDirectivesInExtensions = options.pathToDirectivesInExtensions;
const typesMap = schema.getTypeMap();
const schemaNode = astFromSchema(schema, pathToDirectivesInExtensions);
const definitions = schemaNode != null ? [schemaNode] : [];
const directives = schema.getDirectives();
for (const directive of directives) {
if ((0, graphql_1.isSpecifiedDirective)(directive)) {
continue;
}
definitions.push(astFromDirective(directive, schema, pathToDirectivesInExtensions));
}
for (const typeName in typesMap) {
const type = typesMap[typeName];
const isPredefinedScalar = (0, graphql_1.isSpecifiedScalarType)(type);
const isIntrospection = (0, graphql_1.isIntrospectionType)(type);
if (isPredefinedScalar || isIntrospection) {
continue;
}
if ((0, graphql_1.isObjectType)(type)) {
definitions.push(astFromObjectType(type, schema, pathToDirectivesInExtensions));
}
else if ((0, graphql_1.isInterfaceType)(type)) {
definitions.push(astFromInterfaceType(type, schema, pathToDirectivesInExtensions));
}
else if ((0, graphql_1.isUnionType)(type)) {
definitions.push(astFromUnionType(type, schema, pathToDirectivesInExtensions));
}
else if ((0, graphql_1.isInputObjectType)(type)) {
definitions.push(astFromInputObjectType(type, schema, pathToDirectivesInExtensions));
}
else if ((0, graphql_1.isEnumType)(type)) {
definitions.push(astFromEnumType(type, schema, pathToDirectivesInExtensions));
}
else if ((0, graphql_1.isScalarType)(type)) {
definitions.push(astFromScalarType(type, schema, pathToDirectivesInExtensions));
}
else {
throw new Error(`Unknown type ${type}.`);
}
}
return {
kind: graphql_1.Kind.DOCUMENT,
definitions,
};
}
// this approach uses the default schema printer rather than a custom solution, so may be more backwards compatible
// currently does not allow customization of printSchema options having to do with comments.
function printSchemaWithDirectives(schema, options = {}) {
const documentNode = getDocumentNodeFromSchema(schema, options);
return (0, graphql_1.print)(documentNode);
}
function astFromSchema(schema, pathToDirectivesInExtensions) {
const operationTypeMap = new Map([
['query', undefined],
['mutation', undefined],
['subscription', undefined],
]);
const nodes = [];
if (schema.astNode != null) {
nodes.push(schema.astNode);
}
if (schema.extensionASTNodes != null) {
for (const extensionASTNode of schema.extensionASTNodes) {
nodes.push(extensionASTNode);
}
}
for (const node of nodes) {
if (node.operationTypes) {
for (const operationTypeDefinitionNode of node.operationTypes) {
operationTypeMap.set(operationTypeDefinitionNode.operation, operationTypeDefinitionNode);
}
}
}
const rootTypeMap = (0, rootTypes_js_1.getRootTypeMap)(schema);
for (const [operationTypeNode, operationTypeDefinitionNode] of operationTypeMap) {
const rootType = rootTypeMap.get(operationTypeNode);
if (rootType != null) {
const rootTypeAST = (0, astFromType_js_1.astFromType)(rootType);
if (operationTypeDefinitionNode != null) {
operationTypeDefinitionNode.type = rootTypeAST;
}
else {
operationTypeMap.set(operationTypeNode, {
kind: graphql_1.Kind.OPERATION_TYPE_DEFINITION,
operation: operationTypeNode,
type: rootTypeAST,
});
}
}
}
const operationTypes = [...operationTypeMap.values()].filter(helpers_js_1.isSome);
const directives = getDirectiveNodes(schema, schema, pathToDirectivesInExtensions);
if (!operationTypes.length && !directives.length) {
return null;
}
const schemaNode = {
kind: operationTypes != null ? graphql_1.Kind.SCHEMA_DEFINITION : graphql_1.Kind.SCHEMA_EXTENSION,
operationTypes,
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
directives: directives,
};
const descriptionNode = (0, descriptionFromObject_js_1.getDescriptionNode)(schema);
if (descriptionNode) {
schemaNode.description = descriptionNode;
}
return schemaNode;
}
function astFromDirective(directive, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.DIRECTIVE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(directive),
name: {
kind: graphql_1.Kind.NAME,
value: directive.name,
},
arguments: directive.args?.map(arg => astFromArg(arg, schema, pathToDirectivesInExtensions)),
repeatable: directive.isRepeatable,
locations: directive.locations?.map(location => ({
kind: graphql_1.Kind.NAME,
value: location,
})) || [],
};
}
function getDirectiveNodes(entity, schema, pathToDirectivesInExtensions) {
let directiveNodesBesidesDeprecatedAndSpecifiedBy = [];
const directivesInExtensions = (0, get_directives_js_1.getDirectivesInExtensions)(entity, pathToDirectivesInExtensions);
let directives;
if (directivesInExtensions != null) {
directives = makeDirectiveNodes(schema, directivesInExtensions);
}
let deprecatedDirectiveNode = null;
let specifiedByDirectiveNode = null;
if (directives != null) {
directiveNodesBesidesDeprecatedAndSpecifiedBy = directives.filter(directive => directive.name.value !== 'deprecated' && directive.name.value !== 'specifiedBy');
if (entity.deprecationReason != null) {
deprecatedDirectiveNode = directives.filter(directive => directive.name.value === 'deprecated')?.[0];
}
if (entity.specifiedByUrl != null || entity.specifiedByURL != null) {
specifiedByDirectiveNode = directives.filter(directive => directive.name.value === 'specifiedBy')?.[0];
}
}
if (entity.deprecationReason != null && deprecatedDirectiveNode == null) {
deprecatedDirectiveNode = makeDeprecatedDirective(entity.deprecationReason);
}
if (entity.specifiedByUrl != null ||
(entity.specifiedByURL != null && specifiedByDirectiveNode == null)) {
const specifiedByValue = entity.specifiedByUrl || entity.specifiedByURL;
const specifiedByArgs = {
url: specifiedByValue,
};
specifiedByDirectiveNode = makeDirectiveNode('specifiedBy', specifiedByArgs);
}
if (deprecatedDirectiveNode != null) {
directiveNodesBesidesDeprecatedAndSpecifiedBy.push(deprecatedDirectiveNode);
}
if (specifiedByDirectiveNode != null) {
directiveNodesBesidesDeprecatedAndSpecifiedBy.push(specifiedByDirectiveNode);
}
return directiveNodesBesidesDeprecatedAndSpecifiedBy;
}
function astFromArg(arg, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.INPUT_VALUE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(arg),
name: {
kind: graphql_1.Kind.NAME,
value: arg.name,
},
type: (0, astFromType_js_1.astFromType)(arg.type),
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
defaultValue: arg.defaultValue !== undefined
? ((0, astFromValue_js_1.astFromValue)(arg.defaultValue, arg.type) ?? undefined)
: undefined,
directives: getDirectiveNodes(arg, schema, pathToDirectivesInExtensions),
};
}
function astFromObjectType(type, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.OBJECT_TYPE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(type),
name: {
kind: graphql_1.Kind.NAME,
value: type.name,
},
fields: Object.values(type.getFields()).map(field => astFromField(field, schema, pathToDirectivesInExtensions)),
interfaces: Object.values(type.getInterfaces()).map(iFace => (0, astFromType_js_1.astFromType)(iFace)),
directives: getDirectiveNodes(type, schema, pathToDirectivesInExtensions),
};
}
function astFromInterfaceType(type, schema, pathToDirectivesInExtensions) {
const node = {
kind: graphql_1.Kind.INTERFACE_TYPE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(type),
name: {
kind: graphql_1.Kind.NAME,
value: type.name,
},
fields: Object.values(type.getFields()).map(field => astFromField(field, schema, pathToDirectivesInExtensions)),
directives: getDirectiveNodes(type, schema, pathToDirectivesInExtensions),
};
if ('getInterfaces' in type) {
node.interfaces = Object.values(type.getInterfaces()).map(iFace => (0, astFromType_js_1.astFromType)(iFace));
}
return node;
}
function astFromUnionType(type, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.UNION_TYPE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(type),
name: {
kind: graphql_1.Kind.NAME,
value: type.name,
},
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
directives: getDirectiveNodes(type, schema, pathToDirectivesInExtensions),
types: type.getTypes().map(type => (0, astFromType_js_1.astFromType)(type)),
};
}
function astFromInputObjectType(type, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.INPUT_OBJECT_TYPE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(type),
name: {
kind: graphql_1.Kind.NAME,
value: type.name,
},
fields: Object.values(type.getFields()).map(field => astFromInputField(field, schema, pathToDirectivesInExtensions)),
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
directives: getDirectiveNodes(type, schema, pathToDirectivesInExtensions),
};
}
function astFromEnumType(type, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.ENUM_TYPE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(type),
name: {
kind: graphql_1.Kind.NAME,
value: type.name,
},
values: Object.values(type.getValues()).map(value => astFromEnumValue(value, schema, pathToDirectivesInExtensions)),
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
directives: getDirectiveNodes(type, schema, pathToDirectivesInExtensions),
};
}
function astFromScalarType(type, schema, pathToDirectivesInExtensions) {
const directivesInExtensions = (0, get_directives_js_1.getDirectivesInExtensions)(type, pathToDirectivesInExtensions);
const directives = makeDirectiveNodes(schema, directivesInExtensions);
const specifiedByValue = (type['specifiedByUrl'] ||
type['specifiedByURL']);
if (specifiedByValue &&
!directives.some(directiveNode => directiveNode.name.value === 'specifiedBy')) {
const specifiedByArgs = {
url: specifiedByValue,
};
directives.push(makeDirectiveNode('specifiedBy', specifiedByArgs));
}
return {
kind: graphql_1.Kind.SCALAR_TYPE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(type),
name: {
kind: graphql_1.Kind.NAME,
value: type.name,
},
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
directives: directives,
};
}
function astFromField(field, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.FIELD_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(field),
name: {
kind: graphql_1.Kind.NAME,
value: field.name,
},
arguments: field.args.map(arg => astFromArg(arg, schema, pathToDirectivesInExtensions)),
type: (0, astFromType_js_1.astFromType)(field.type),
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
directives: getDirectiveNodes(field, schema, pathToDirectivesInExtensions),
};
}
function astFromInputField(field, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.INPUT_VALUE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(field),
name: {
kind: graphql_1.Kind.NAME,
value: field.name,
},
type: (0, astFromType_js_1.astFromType)(field.type),
// ConstXNode has been introduced in v16 but it is not compatible with XNode so we do `as any` for backwards compatibility
directives: getDirectiveNodes(field, schema, pathToDirectivesInExtensions),
defaultValue: (0, astFromValue_js_1.astFromValue)(field.defaultValue, field.type) ?? undefined,
};
}
function astFromEnumValue(value, schema, pathToDirectivesInExtensions) {
return {
kind: graphql_1.Kind.ENUM_VALUE_DEFINITION,
description: (0, descriptionFromObject_js_1.getDescriptionNode)(value),
name: {
kind: graphql_1.Kind.NAME,
value: value.name,
},
directives: getDirectiveNodes(value, schema, pathToDirectivesInExtensions),
};
}
function makeDeprecatedDirective(deprecationReason) {
return makeDirectiveNode('deprecated', { reason: deprecationReason }, graphql_1.GraphQLDeprecatedDirective);
}
function makeDirectiveNode(name, args, directive) {
const directiveArguments = [];
for (const argName in args) {
const argValue = args[argName];
let value;
if (directive != null) {
const arg = directive.args.find(arg => arg.name === argName);
if (arg) {
value = (0, astFromValue_js_1.astFromValue)(argValue, arg.type);
}
}
if (value == null) {
value = (0, astFromValueUntyped_js_1.astFromValueUntyped)(argValue);
}
if (value != null) {
directiveArguments.push({
kind: graphql_1.Kind.ARGUMENT,
name: {
kind: graphql_1.Kind.NAME,
value: argName,
},
value,
});
}
}
return {
kind: graphql_1.Kind.DIRECTIVE,
name: {
kind: graphql_1.Kind.NAME,
value: name,
},
arguments: directiveArguments,
};
}
function makeDirectiveNodes(schema, directiveValues) {
const directiveNodes = [];
for (const { name, args } of directiveValues) {
const directive = schema?.getDirective(name);
directiveNodes.push(makeDirectiveNode(name, args, directive));
}
return directiveNodes;
}