import Maybe from '../tsutils/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; } 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; } 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: void): undefined; export function getNullableType(type: T): T; export function getNullableType( 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: void): 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; /** * 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; serialize: GraphQLScalarSerializer; parseValue: GraphQLScalarValueParser; parseLiteral: GraphQLScalarLiteralParser; extensions: Maybe>>; astNode: Maybe; extensionASTNodes: Maybe>; constructor(config: GraphQLScalarTypeConfig); toConfig(): GraphQLScalarTypeConfig & { 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; // 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>; } /** * 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< TSource = any, TContext = any, TArgs = { [key: string]: any } > { name: string; description: Maybe; isTypeOf: Maybe>; extensions: Maybe>>; astNode: Maybe; extensionASTNodes: Maybe>; constructor(config: GraphQLObjectTypeConfig); getFields(): GraphQLFieldMap; getInterfaces(): GraphQLInterfaceType[]; toConfig(): GraphQLObjectTypeConfig & { interfaces: GraphQLInterfaceType[]; fields: GraphQLFieldConfigMap; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export function argsToArgsConfig( args: ReadonlyArray, ): GraphQLFieldConfigArgumentMap; // TS_SPECIFIC: TArgs export interface GraphQLObjectTypeConfig< TSource, TContext, TArgs = { [key: string]: any } > { name: string; description?: Maybe; interfaces?: Thunk>; fields: Thunk>; isTypeOf?: Maybe>; extensions?: Maybe>>; astNode?: Maybe; extensionASTNodes?: Maybe>; } // TS_SPECIFIC: TArgs export type GraphQLTypeResolver< TSource, TContext, TArgs = { [key: string]: any } > = ( value: TSource, context: TContext, info: GraphQLResolveInfo, abstractType: GraphQLAbstractType, ) => PromiseOrValue< Maybe | 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 }; } export interface GraphQLFieldConfig< TSource, TContext, TArgs = { [argName: string]: any } > { description?: Maybe; type: GraphQLOutputType; args?: GraphQLFieldConfigArgumentMap; resolve?: GraphQLFieldResolver; subscribe?: GraphQLFieldResolver; deprecationReason?: Maybe; extensions?: Maybe>>; astNode?: Maybe; } export type GraphQLFieldConfigArgumentMap = { [key: string]: GraphQLArgumentConfig; }; export interface GraphQLArgumentConfig { description?: Maybe; type: GraphQLInputType; defaultValue?: any; extensions?: Maybe>>; astNode?: Maybe; } // TS_SPECIFIC: TArgs export type GraphQLFieldConfigMap< TSource, TContext, TArgs = { [key: string]: any } > = { [key: string]: GraphQLFieldConfig; }; export interface GraphQLField< TSource, TContext, TArgs = { [key: string]: any } > { name: string; description: Maybe; type: GraphQLOutputType; args: GraphQLArgument[]; resolve?: GraphQLFieldResolver; subscribe?: GraphQLFieldResolver; isDeprecated?: boolean; deprecationReason?: Maybe; extensions: Maybe>>; astNode?: Maybe; } export interface GraphQLArgument { name: string; description: Maybe; type: GraphQLInputType; defaultValue: any; extensions: Maybe>>; astNode: Maybe; } export function isRequiredArgument(arg: GraphQLArgument): boolean; // TS_SPECIFIC: TArgs export type GraphQLFieldMap< TSource, TContext, TArgs = { [key: string]: any } > = { [key: string]: GraphQLField; }; /** * 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: GraphQLInterfaceTypeConfig); getFields(): GraphQLFieldMap; toConfig(): GraphQLInterfaceTypeConfig & { fields: GraphQLFieldConfigMap; extensions: Maybe>>; extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } // TS_SPECIFIC: TArgs export interface GraphQLInterfaceTypeConfig< TSource, TContext, TArgs = { [key: string]: any } > { name: string; description?: Maybe; 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>; } /** * 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: GraphQLUnionTypeConfig); getTypes(): GraphQLObjectType[]; toConfig(): GraphQLUnionTypeConfig & { types: GraphQLObjectType[]; 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>; } /** * 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: GraphQLEnumTypeConfig); getValues(): GraphQLEnumValue[]; getValue(name: string): Maybe; serialize(value: any): Maybe; parseValue(value: any): Maybe; parseLiteral( valueNode: ValueNode, _variables: Maybe<{ [key: string]: any }>, ): Maybe; toConfig(): GraphQLEnumTypeConfig & { extensionASTNodes: ReadonlyArray; }; toString(): string; toJSON(): string; inspect(): string; } export interface GraphQLEnumTypeConfig { name: string; description?: Maybe; values: GraphQLEnumValueConfigMap; extensions?: Maybe>>; astNode?: Maybe; extensionASTNodes?: Maybe>; } export type GraphQLEnumValueConfigMap = { [key: string]: GraphQLEnumValueConfig; }; export interface GraphQLEnumValueConfig { description?: Maybe; value?: any; deprecationReason?: Maybe; extensions?: Maybe>>; astNode?: Maybe; } export interface GraphQLEnumValue { name: string; description: Maybe; value: any; isDeprecated?: boolean; deprecationReason: Maybe; extensions: Maybe>>; astNode?: Maybe; } /** * 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: GraphQLInputObjectTypeConfig); 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>; } export interface GraphQLInputFieldConfig { description?: Maybe; type: GraphQLInputType; defaultValue?: any; extensions?: Maybe>>; astNode?: Maybe; } export type GraphQLInputFieldConfigMap = { [key: string]: GraphQLInputFieldConfig; }; export interface GraphQLInputField { name: string; description?: Maybe; type: GraphQLInputType; defaultValue?: any; extensions: Maybe>>; astNode?: Maybe; } export function isRequiredInputField(field: GraphQLInputField): boolean; export type GraphQLInputFieldMap = { [key: string]: GraphQLInputField };