// FIXME /* eslint-disable import/no-cycle */ import { Maybe } from '../jsutils/Maybe'; import { PromiseOrValue } from '../jsutils/PromiseOrValue'; import { Path } from '../jsutils/Path'; import { ScalarTypeDefinitionNode, ObjectTypeDefinitionNode, FieldDefinitionNode, InputValueDefinitionNode, InterfaceTypeDefinitionNode, UnionTypeDefinitionNode, EnumTypeDefinitionNode, EnumValueDefinitionNode, InputObjectTypeDefinitionNode, ObjectTypeExtensionNode, InterfaceTypeExtensionNode, OperationDefinitionNode, FieldNode, FragmentDefinitionNode, ValueNode, ScalarTypeExtensionNode, UnionTypeExtensionNode, EnumTypeExtensionNode, InputObjectTypeExtensionNode, } from '../language/ast'; import { GraphQLSchema } from './schema'; /** * These are all of the possible kinds of types. */ export type GraphQLType = | GraphQLScalarType | GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType | GraphQLEnumType | GraphQLInputObjectType | GraphQLList | GraphQLNonNull; export function isType(type: any): type is GraphQLType; export function assertType(type: any): GraphQLType; export function isScalarType(type: any): type is GraphQLScalarType; export function assertScalarType(type: any): GraphQLScalarType; export function isObjectType(type: any): type is GraphQLObjectType; export function assertObjectType(type: any): GraphQLObjectType; export function isInterfaceType(type: any): type is GraphQLInterfaceType; export function assertInterfaceType(type: any): GraphQLInterfaceType; export function isUnionType(type: any): type is GraphQLUnionType; export function assertUnionType(type: any): GraphQLUnionType; export function isEnumType(type: any): type is GraphQLEnumType; export function assertEnumType(type: any): GraphQLEnumType; export function isInputObjectType(type: any): type is GraphQLInputObjectType; export function assertInputObjectType(type: any): GraphQLInputObjectType; export function isListType(type: any): type is GraphQLList; export function assertListType(type: any): GraphQLList; export function isNonNullType(type: any): type is GraphQLNonNull; export function assertNonNullType(type: any): GraphQLNonNull; /** * These types may be used as input types for arguments and directives. */ // TS_SPECIFIC: TS does not allow recursive type definitions, hence the `any`s export type GraphQLInputType = | GraphQLScalarType | GraphQLEnumType | GraphQLInputObjectType | GraphQLList | GraphQLNonNull< | GraphQLScalarType | GraphQLEnumType | GraphQLInputObjectType | GraphQLList >; export function isInputType(type: any): type is GraphQLInputType; export function assertInputType(type: any): GraphQLInputType; /** * These types may be used as output types as the result of fields. */ // TS_SPECIFIC: TS does not allow recursive type definitions, hence the `any`s export type GraphQLOutputType = | GraphQLScalarType | GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType | GraphQLEnumType | GraphQLList | GraphQLNonNull< | GraphQLScalarType | GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType | GraphQLEnumType | GraphQLList >; export function isOutputType(type: any): type is GraphQLOutputType; export function assertOutputType(type: any): GraphQLOutputType; /** * These types may describe types which may be leaf values. */ export type GraphQLLeafType = GraphQLScalarType | GraphQLEnumType; export function isLeafType(type: any): type is GraphQLLeafType; export function assertLeafType(type: any): GraphQLLeafType; /** * These types may describe the parent context of a selection set. */ export type GraphQLCompositeType = | GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType; export function isCompositeType(type: any): type is GraphQLCompositeType; export function assertCompositeType(type: any): GraphQLCompositeType; /** * These types may describe the parent context of a selection set. */ export type GraphQLAbstractType = GraphQLInterfaceType | GraphQLUnionType; export function isAbstractType(type: any): type is GraphQLAbstractType; export function assertAbstractType(type: any): GraphQLAbstractType; /** * List Modifier * * A list is a kind of type marker, a wrapping type which points to another * type. Lists are often created within the context of defining the fields * of an object type. * * Example: * * const PersonType = new GraphQLObjectType({ * name: 'Person', * fields: () => ({ * parents: { type: new GraphQLList(Person) }, * children: { type: new GraphQLList(Person) }, * }) * }) * */ interface GraphQLList { readonly ofType: T; toString: () => string; toJSON: () => string; inspect: () => string; } interface _GraphQLList { (type: T): GraphQLList; new (type: T): GraphQLList; } // eslint-disable-next-line @typescript-eslint/no-redeclare export const GraphQLList: _GraphQLList; /** * Non-Null Modifier * * A non-null is a kind of type marker, a wrapping type which points to another * type. Non-null types enforce that their values are never null and can ensure * an error is raised if this ever occurs during a request. It is useful for * fields which you can make a strong guarantee on non-nullability, for example * usually the id field of a database row will never be null. * * Example: * * const RowType = new GraphQLObjectType({ * name: 'Row', * fields: () => ({ * id: { type: new GraphQLNonNull(GraphQLString) }, * }) * }) * * Note: the enforcement of non-nullability occurs within the executor. */ interface GraphQLNonNull { readonly ofType: T; toString: () => string; toJSON: () => string; inspect: () => string; } interface _GraphQLNonNull { (type: T): GraphQLNonNull; new (type: T): GraphQLNonNull; } // eslint-disable-next-line @typescript-eslint/no-redeclare export const GraphQLNonNull: _GraphQLNonNull; export type GraphQLWrappingType = GraphQLList | GraphQLNonNull; export function isWrappingType(type: any): type is GraphQLWrappingType; export function assertWrappingType(type: any): GraphQLWrappingType; /** * These types can all accept null as a value. */ export type GraphQLNullableType = | GraphQLScalarType | GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType | GraphQLEnumType | GraphQLInputObjectType | GraphQLList; export function isNullableType(type: any): type is GraphQLNullableType; export function assertNullableType(type: any): GraphQLNullableType; export function getNullableType(type: undefined): undefined; export function getNullableType(type: T): T; export function getNullableType( // FIXME Disabled because of https://github.com/yaacovCR/graphql-tools-fork/issues/40#issuecomment-586671219 // eslint-disable-next-line @typescript-eslint/unified-signatures type: GraphQLNonNull, ): T; /** * These named types do not include modifiers like List or NonNull. */ export type GraphQLNamedType = | GraphQLScalarType | GraphQLObjectType | GraphQLInterfaceType | GraphQLUnionType | GraphQLEnumType | GraphQLInputObjectType; export function isNamedType(type: any): type is GraphQLNamedType; export function assertNamedType(type: any): GraphQLNamedType; export function getNamedType(type: undefined): undefined; export function getNamedType(type: GraphQLType): GraphQLNamedType; /** * Used while defining GraphQL types to allow for circular references in * otherwise immutable type definitions. */ export type Thunk = (() => T) | T; /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLScalarTypeExtensions { [attributeName: string]: any; } /** * Scalar Type Definition * * The leaf values of any request and input values to arguments are * Scalars (or Enums) and are defined with a name and a series of functions * used to parse input from ast or variables and to ensure validity. * * Example: * * const OddType = new GraphQLScalarType({ * name: 'Odd', * serialize(value) { * return value % 2 === 1 ? value : null; * } * }); * */ export class GraphQLScalarType { name: string; description: Maybe; specifiedByUrl: Maybe; serialize: GraphQLScalarSerializer; parseValue: GraphQLScalarValueParser; parseLiteral: GraphQLScalarLiteralParser; extensions: Maybe>; astNode: Maybe; extensionASTNodes: Maybe>; constructor(config: Readonly>); toConfig(): GraphQLScalarTypeConfig & { specifiedByUrl: Maybe; serialize: GraphQLScalarSerializer; parseValue: GraphQLScalarValueParser; parseLiteral: GraphQLScalarLiteralParser; extensions: Maybe>; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export type GraphQLScalarSerializer = ( value: any, ) => Maybe; export type GraphQLScalarValueParser = ( value: any, ) => Maybe; export type GraphQLScalarLiteralParser = ( valueNode: ValueNode, variables: Maybe<{ [key: string]: any }>, ) => Maybe; export interface GraphQLScalarTypeConfig { name: string; description?: Maybe; specifiedByUrl?: Maybe; // Serializes an internal value to include in a response. serialize?: GraphQLScalarSerializer; // Parses an externally provided value to use as an input. parseValue?: GraphQLScalarValueParser; // Parses an externally provided literal value to use as an input. parseLiteral?: GraphQLScalarLiteralParser; extensions?: Maybe>; astNode?: Maybe; extensionASTNodes?: Maybe>; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. * * We've provided these template arguments because this is an open type and * you may find them useful. */ export interface GraphQLObjectTypeExtensions<_TSource = any, _TContext = any> { [attributeName: string]: any; } /** * Object Type Definition * * Almost all of the GraphQL types you define will be object types. Object types * have a name, but most importantly describe their fields. * * Example: * * const AddressType = new GraphQLObjectType({ * name: 'Address', * fields: { * street: { type: GraphQLString }, * number: { type: GraphQLInt }, * formatted: { * type: GraphQLString, * resolve(obj) { * return obj.number + ' ' + obj.street * } * } * } * }); * * When two types need to refer to each other, or a type needs to refer to * itself in a field, you can use a function expression (aka a closure or a * thunk) to supply the fields lazily. * * Example: * * const PersonType = new GraphQLObjectType({ * name: 'Person', * fields: () => ({ * name: { type: GraphQLString }, * bestFriend: { type: PersonType }, * }) * }); * */ export class GraphQLObjectType { name: string; description: Maybe; isTypeOf: Maybe>; extensions: Maybe>>; astNode: Maybe; extensionASTNodes: Maybe>; constructor(config: Readonly>); getFields(): GraphQLFieldMap; getInterfaces(): Array; toConfig(): GraphQLObjectTypeConfig & { interfaces: Array; fields: GraphQLFieldConfigMap; extensions: Maybe>>; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export function argsToArgsConfig( args: ReadonlyArray, ): GraphQLFieldConfigArgumentMap; export interface GraphQLObjectTypeConfig { name: string; description?: Maybe; interfaces?: Thunk>>; fields: Thunk>; isTypeOf?: Maybe>; extensions?: Maybe>>; astNode?: Maybe; extensionASTNodes?: Maybe>; } export type GraphQLTypeResolver = ( value: TSource, context: TContext, info: GraphQLResolveInfo, abstractType: GraphQLAbstractType, ) => PromiseOrValue | string>>; export type GraphQLIsTypeOfFn = ( source: TSource, context: TContext, info: GraphQLResolveInfo, ) => PromiseOrValue; export type GraphQLFieldResolver< TSource, TContext, TArgs = { [argName: string]: any } > = ( source: TSource, args: TArgs, context: TContext, info: GraphQLResolveInfo, ) => any; export interface GraphQLResolveInfo { readonly fieldName: string; readonly fieldNodes: ReadonlyArray; readonly returnType: GraphQLOutputType; readonly parentType: GraphQLObjectType; readonly path: Path; readonly schema: GraphQLSchema; readonly fragments: { [key: string]: FragmentDefinitionNode }; readonly rootValue: any; readonly operation: OperationDefinitionNode; readonly variableValues: { [variableName: string]: any }; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. * * We've provided these template arguments because this is an open type and * you may find them useful. */ export interface GraphQLFieldExtensions< _TSource, _TContext, _TArgs = { [argName: string]: any } > { [attributeName: string]: any; } export interface GraphQLFieldConfig< TSource, TContext, TArgs = { [argName: string]: any } > { description?: Maybe; type: GraphQLOutputType; args?: GraphQLFieldConfigArgumentMap; resolve?: GraphQLFieldResolver; subscribe?: GraphQLFieldResolver; deprecationReason?: Maybe; extensions?: Maybe< Readonly> >; astNode?: Maybe; } export interface GraphQLFieldConfigArgumentMap { [key: string]: GraphQLArgumentConfig; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLArgumentExtensions { [attributeName: string]: any; } export interface GraphQLArgumentConfig { description?: Maybe; type: GraphQLInputType; defaultValue?: any; deprecationReason?: Maybe; extensions?: Maybe>; astNode?: Maybe; } export interface GraphQLFieldConfigMap { [key: string]: GraphQLFieldConfig; } export interface GraphQLField< TSource, TContext, TArgs = { [key: string]: any } > { name: string; description: Maybe; type: GraphQLOutputType; args: Array; resolve?: GraphQLFieldResolver; subscribe?: GraphQLFieldResolver; deprecationReason: Maybe; extensions: Maybe>>; astNode?: Maybe; // @deprecated and will be removed in v16 isDeprecated: boolean; } export interface GraphQLArgument { name: string; description: Maybe; type: GraphQLInputType; defaultValue: any; deprecationReason: Maybe; extensions: Maybe>; astNode: Maybe; } export function isRequiredArgument(arg: GraphQLArgument): boolean; export interface GraphQLFieldMap { [key: string]: GraphQLField; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLInterfaceTypeExtensions { [attributeName: string]: any; } /** * Interface Type Definition * * When a field can return one of a heterogeneous set of types, a Interface type * is used to describe what types are possible, what fields are in common across * all types, as well as a function to determine which type is actually used * when the field is resolved. * * Example: * * const EntityType = new GraphQLInterfaceType({ * name: 'Entity', * fields: { * name: { type: GraphQLString } * } * }); * */ export class GraphQLInterfaceType { name: string; description: Maybe; resolveType: Maybe>; extensions: Maybe>; astNode?: Maybe; extensionASTNodes: Maybe>; constructor(config: Readonly>); getFields(): GraphQLFieldMap; getInterfaces(): Array; toConfig(): GraphQLInterfaceTypeConfig & { interfaces: Array; fields: GraphQLFieldConfigMap; extensions: Maybe>; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export interface GraphQLInterfaceTypeConfig { name: string; description?: Maybe; interfaces?: Thunk>>; fields: Thunk>; /** * Optionally provide a custom type resolver function. If one is not provided, * the default implementation will call `isTypeOf` on each implementing * Object type. */ resolveType?: Maybe>; extensions?: Maybe>; astNode?: Maybe; extensionASTNodes?: Maybe>; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLUnionTypeExtensions { [attributeName: string]: any; } /** * Union Type Definition * * When a field can return one of a heterogeneous set of types, a Union type * is used to describe what types are possible as well as providing a function * to determine which type is actually used when the field is resolved. * * Example: * * const PetType = new GraphQLUnionType({ * name: 'Pet', * types: [ DogType, CatType ], * resolveType(value) { * if (value instanceof Dog) { * return DogType; * } * if (value instanceof Cat) { * return CatType; * } * } * }); * */ export class GraphQLUnionType { name: string; description: Maybe; resolveType: Maybe>; extensions: Maybe>; astNode: Maybe; extensionASTNodes: Maybe>; constructor(config: Readonly>); getTypes(): Array; toConfig(): GraphQLUnionTypeConfig & { types: Array; extensions: Maybe>; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export interface GraphQLUnionTypeConfig { name: string; description?: Maybe; types: Thunk>; /** * Optionally provide a custom type resolver function. If one is not provided, * the default implementation will call `isTypeOf` on each implementing * Object type. */ resolveType?: Maybe>; extensions?: Maybe>; astNode?: Maybe; extensionASTNodes?: Maybe>; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLEnumTypeExtensions { [attributeName: string]: any; } /** * Enum Type Definition * * Some leaf values of requests and input values are Enums. GraphQL serializes * Enum values as strings, however internally Enums can be represented by any * kind of type, often integers. * * Example: * * const RGBType = new GraphQLEnumType({ * name: 'RGB', * values: { * RED: { value: 0 }, * GREEN: { value: 1 }, * BLUE: { value: 2 } * } * }); * * Note: If a value is not provided in a definition, the name of the enum value * will be used as its internal value. */ export class GraphQLEnumType { name: string; description: Maybe; extensions: Maybe>; astNode: Maybe; extensionASTNodes: Maybe>; constructor(config: Readonly); getValues(): Array; getValue(name: string): Maybe; serialize(value: any): Maybe; parseValue(value: any): Maybe; parseLiteral( valueNode: ValueNode, _variables: Maybe<{ [key: string]: any }>, ): Maybe; toConfig(): GraphQLEnumTypeConfig & { extensions: Maybe>; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export interface GraphQLEnumTypeConfig { name: string; description?: Maybe; values: GraphQLEnumValueConfigMap; extensions?: Maybe>; astNode?: Maybe; extensionASTNodes?: Maybe>; } export interface GraphQLEnumValueConfigMap { [key: string]: GraphQLEnumValueConfig; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLEnumValueExtensions { [attributeName: string]: any; } export interface GraphQLEnumValueConfig { description?: Maybe; value?: any; deprecationReason?: Maybe; extensions?: Maybe>; astNode?: Maybe; } export interface GraphQLEnumValue { name: string; description: Maybe; value: any; deprecationReason: Maybe; extensions: Maybe>; astNode?: Maybe; // @deprecated and will be removed in v16 isDeprecated: boolean; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLInputObjectTypeExtensions { [attributeName: string]: any; } /** * Input Object Type Definition * * An input object defines a structured collection of fields which may be * supplied to a field argument. * * Using `NonNull` will ensure that a value must be provided by the query * * Example: * * const GeoPoint = new GraphQLInputObjectType({ * name: 'GeoPoint', * fields: { * lat: { type: new GraphQLNonNull(GraphQLFloat) }, * lon: { type: new GraphQLNonNull(GraphQLFloat) }, * alt: { type: GraphQLFloat, defaultValue: 0 }, * } * }); * */ export class GraphQLInputObjectType { name: string; description: Maybe; extensions: Maybe>; astNode: Maybe; extensionASTNodes: Maybe>; constructor(config: Readonly); getFields(): GraphQLInputFieldMap; toConfig(): GraphQLInputObjectTypeConfig & { fields: GraphQLInputFieldConfigMap; extensions: Maybe>; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export interface GraphQLInputObjectTypeConfig { name: string; description?: Maybe; fields: Thunk; extensions?: Maybe>; astNode?: Maybe; extensionASTNodes?: Maybe>; } /** * Custom extensions * * @remarks * Use a unique identifier name for your extension, for example the name of * your library or project. Do not use a shortened identifier as this increases * the risk of conflicts. We recommend you add at most one extension field, * an object which can contain all the values you need. */ export interface GraphQLInputFieldExtensions { [attributeName: string]: any; } export interface GraphQLInputFieldConfig { description?: Maybe; type: GraphQLInputType; defaultValue?: any; deprecationReason?: Maybe; extensions?: Maybe>; astNode?: Maybe; } export interface GraphQLInputFieldConfigMap { [key: string]: GraphQLInputFieldConfig; } export interface GraphQLInputField { name: string; description?: Maybe; type: GraphQLInputType; defaultValue?: any; deprecationReason: Maybe; extensions: Maybe>; astNode?: Maybe; } export function isRequiredInputField(field: GraphQLInputField): boolean; export interface GraphQLInputFieldMap { [key: string]: GraphQLInputField; }