summaryrefslogtreecommitdiff
path: root/school/node_modules/graphql/graphql.js.flow
diff options
context:
space:
mode:
Diffstat (limited to 'school/node_modules/graphql/graphql.js.flow')
-rw-r--r--school/node_modules/graphql/graphql.js.flow207
1 files changed, 207 insertions, 0 deletions
diff --git a/school/node_modules/graphql/graphql.js.flow b/school/node_modules/graphql/graphql.js.flow
new file mode 100644
index 0000000..cc24308
--- /dev/null
+++ b/school/node_modules/graphql/graphql.js.flow
@@ -0,0 +1,207 @@
+// @flow strict
+import type { PromiseOrValue } from './jsutils/PromiseOrValue';
+import isPromise from './jsutils/isPromise';
+
+import type { Source } from './language/source';
+import { parse } from './language/parser';
+
+import { validate } from './validation/validate';
+
+import type {
+ GraphQLFieldResolver,
+ GraphQLTypeResolver,
+} from './type/definition';
+import type { GraphQLSchema } from './type/schema';
+import { validateSchema } from './type/validate';
+
+import type { ExecutionResult } from './execution/execute';
+import { execute } from './execution/execute';
+
+/**
+ * This is the primary entry point function for fulfilling GraphQL operations
+ * by parsing, validating, and executing a GraphQL document along side a
+ * GraphQL schema.
+ *
+ * More sophisticated GraphQL servers, such as those which persist queries,
+ * may wish to separate the validation and execution phases to a static time
+ * tooling step, and a server runtime step.
+ *
+ * Accepts either an object with named arguments, or individual arguments:
+ *
+ * schema:
+ * The GraphQL type system to use when validating and executing a query.
+ * source:
+ * A GraphQL language formatted string representing the requested operation.
+ * rootValue:
+ * The value provided as the first argument to resolver functions on the top
+ * level type (e.g. the query object type).
+ * contextValue:
+ * The context value is provided as an argument to resolver functions after
+ * field arguments. It is used to pass shared information useful at any point
+ * during executing this query, for example the currently logged in user and
+ * connections to databases or other services.
+ * variableValues:
+ * A mapping of variable name to runtime value to use for all variables
+ * defined in the requestString.
+ * operationName:
+ * The name of the operation to use if requestString contains multiple
+ * possible operations. Can be omitted if requestString contains only
+ * one operation.
+ * fieldResolver:
+ * A resolver function to use when one is not provided by the schema.
+ * If not provided, the default field resolver is used (which looks for a
+ * value or method on the source value with the field's name).
+ * typeResolver:
+ * A type resolver function to use when none is provided by the schema.
+ * If not provided, the default type resolver is used (which looks for a
+ * `__typename` field or alternatively calls the `isTypeOf` method).
+ */
+export type GraphQLArgs = {|
+ schema: GraphQLSchema,
+ source: string | Source,
+ rootValue?: mixed,
+ contextValue?: mixed,
+ variableValues?: ?{ +[variable: string]: mixed, ... },
+ operationName?: ?string,
+ fieldResolver?: ?GraphQLFieldResolver<any, any>,
+ typeResolver?: ?GraphQLTypeResolver<any, any>,
+|};
+declare function graphql(GraphQLArgs, ..._: []): Promise<ExecutionResult>;
+/* eslint-disable no-redeclare */
+declare function graphql(
+ schema: GraphQLSchema,
+ source: Source | string,
+ rootValue?: mixed,
+ contextValue?: mixed,
+ variableValues?: ?{ +[variable: string]: mixed, ... },
+ operationName?: ?string,
+ fieldResolver?: ?GraphQLFieldResolver<any, any>,
+ typeResolver?: ?GraphQLTypeResolver<any, any>,
+): Promise<ExecutionResult>;
+export function graphql(
+ argsOrSchema,
+ source,
+ rootValue,
+ contextValue,
+ variableValues,
+ operationName,
+ fieldResolver,
+ typeResolver,
+) {
+ /* eslint-enable no-redeclare */
+ // Always return a Promise for a consistent API.
+ return new Promise((resolve) =>
+ resolve(
+ // Extract arguments from object args if provided.
+ arguments.length === 1
+ ? graphqlImpl(argsOrSchema)
+ : graphqlImpl({
+ schema: argsOrSchema,
+ source,
+ rootValue,
+ contextValue,
+ variableValues,
+ operationName,
+ fieldResolver,
+ typeResolver,
+ }),
+ ),
+ );
+}
+
+/**
+ * The graphqlSync function also fulfills GraphQL operations by parsing,
+ * validating, and executing a GraphQL document along side a GraphQL schema.
+ * However, it guarantees to complete synchronously (or throw an error) assuming
+ * that all field resolvers are also synchronous.
+ */
+declare function graphqlSync(GraphQLArgs, ..._: []): ExecutionResult;
+/* eslint-disable no-redeclare */
+declare function graphqlSync(
+ schema: GraphQLSchema,
+ source: Source | string,
+ rootValue?: mixed,
+ contextValue?: mixed,
+ variableValues?: ?{ +[variable: string]: mixed, ... },
+ operationName?: ?string,
+ fieldResolver?: ?GraphQLFieldResolver<any, any>,
+ typeResolver?: ?GraphQLTypeResolver<any, any>,
+): ExecutionResult;
+export function graphqlSync(
+ argsOrSchema,
+ source,
+ rootValue,
+ contextValue,
+ variableValues,
+ operationName,
+ fieldResolver,
+ typeResolver,
+) {
+ /* eslint-enable no-redeclare */
+ // Extract arguments from object args if provided.
+ const result =
+ arguments.length === 1
+ ? graphqlImpl(argsOrSchema)
+ : graphqlImpl({
+ schema: argsOrSchema,
+ source,
+ rootValue,
+ contextValue,
+ variableValues,
+ operationName,
+ fieldResolver,
+ typeResolver,
+ });
+
+ // Assert that the execution was synchronous.
+ if (isPromise(result)) {
+ throw new Error('GraphQL execution failed to complete synchronously.');
+ }
+
+ return result;
+}
+
+function graphqlImpl(args: GraphQLArgs): PromiseOrValue<ExecutionResult> {
+ const {
+ schema,
+ source,
+ rootValue,
+ contextValue,
+ variableValues,
+ operationName,
+ fieldResolver,
+ typeResolver,
+ } = args;
+
+ // Validate Schema
+ const schemaValidationErrors = validateSchema(schema);
+ if (schemaValidationErrors.length > 0) {
+ return { errors: schemaValidationErrors };
+ }
+
+ // Parse
+ let document;
+ try {
+ document = parse(source);
+ } catch (syntaxError) {
+ return { errors: [syntaxError] };
+ }
+
+ // Validate
+ const validationErrors = validate(schema, document);
+ if (validationErrors.length > 0) {
+ return { errors: validationErrors };
+ }
+
+ // Execute
+ return execute({
+ schema,
+ document,
+ rootValue,
+ contextValue,
+ variableValues,
+ operationName,
+ fieldResolver,
+ typeResolver,
+ });
+}