graphql 0.0.1-test.1

package/utilities/valueFromAST.js

@@ -0,0 +1,185 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+exports.valueFromAST = valueFromAST;
+
+var _inspect = require('../jsutils/inspect.js');
+
+var _invariant = require('../jsutils/invariant.js');
+
+var _keyMap = require('../jsutils/keyMap.js');
+
+var _kinds = require('../language/kinds.js');
+
+var _definition = require('../type/definition.js');
+
+/**
+ * Produces a JavaScript value given a GraphQL Value AST.
+ *
+ * A GraphQL type must be provided, which will be used to interpret different
+ * GraphQL Value literals.
+ *
+ * Returns `undefined` when the value could not be validly coerced according to
+ * the provided type.
+ *
+ * | GraphQL Value        | JSON Value    |
+ * | -------------------- | ------------- |
+ * | Input Object         | Object        |
+ * | List                 | Array         |
+ * | Boolean              | Boolean       |
+ * | String               | String        |
+ * | Int / Float          | Number        |
+ * | Enum Value           | Unknown       |
+ * | NullValue            | null          |
+ *
+ */
+function valueFromAST(valueNode, type, variables) {
+  if (!valueNode) {
+    // When there is no node, then there is also no value.
+    // Importantly, this is different from returning the value null.
+    return;
+  }
+
+  if (valueNode.kind === _kinds.Kind.VARIABLE) {
+    const variableName = valueNode.name.value;
+
+    if (variables == null || variables[variableName] === undefined) {
+      // No valid return value.
+      return;
+    }
+
+    const variableValue = variables[variableName];
+
+    if (variableValue === null && (0, _definition.isNonNullType)(type)) {
+      return; // Invalid: intentionally return no value.
+    } // Note: This does no further checking that this variable is correct.
+    // This assumes that this query has been validated and the variable
+    // usage here is of the correct type.
+
+    return variableValue;
+  }
+
+  if ((0, _definition.isNonNullType)(type)) {
+    if (valueNode.kind === _kinds.Kind.NULL) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    return valueFromAST(valueNode, type.ofType, variables);
+  }
+
+  if (valueNode.kind === _kinds.Kind.NULL) {
+    // This is explicitly returning the value null.
+    return null;
+  }
+
+  if ((0, _definition.isListType)(type)) {
+    const itemType = type.ofType;
+
+    if (valueNode.kind === _kinds.Kind.LIST) {
+      const coercedValues = [];
+
+      for (const itemNode of valueNode.values) {
+        if (isMissingVariable(itemNode, variables)) {
+          // If an array contains a missing variable, it is either coerced to
+          // null or if the item type is non-null, it considered invalid.
+          if ((0, _definition.isNonNullType)(itemType)) {
+            return; // Invalid: intentionally return no value.
+          }
+
+          coercedValues.push(null);
+        } else {
+          const itemValue = valueFromAST(itemNode, itemType, variables);
+
+          if (itemValue === undefined) {
+            return; // Invalid: intentionally return no value.
+          }
+
+          coercedValues.push(itemValue);
+        }
+      }
+
+      return coercedValues;
+    }
+
+    const coercedValue = valueFromAST(valueNode, itemType, variables);
+
+    if (coercedValue === undefined) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    return [coercedValue];
+  }
+
+  if ((0, _definition.isInputObjectType)(type)) {
+    if (valueNode.kind !== _kinds.Kind.OBJECT) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    const coercedObj = Object.create(null);
+    const fieldNodes = (0, _keyMap.keyMap)(
+      valueNode.fields,
+      (field) => field.name.value,
+    );
+
+    for (const field of Object.values(type.getFields())) {
+      const fieldNode = fieldNodes[field.name];
+
+      if (!fieldNode || isMissingVariable(fieldNode.value, variables)) {
+        if (field.defaultValue !== undefined) {
+          coercedObj[field.name] = field.defaultValue;
+        } else if ((0, _definition.isNonNullType)(field.type)) {
+          return; // Invalid: intentionally return no value.
+        }
+
+        continue;
+      }
+
+      const fieldValue = valueFromAST(fieldNode.value, field.type, variables);
+
+      if (fieldValue === undefined) {
+        return; // Invalid: intentionally return no value.
+      }
+
+      coercedObj[field.name] = fieldValue;
+    }
+
+    return coercedObj;
+  }
+
+  if ((0, _definition.isLeafType)(type)) {
+    // Scalars and Enums fulfill parsing a literal value via parseLiteral().
+    // Invalid values represent a failure to parse correctly, in which case
+    // no value is returned.
+    let result;
+
+    try {
+      result = type.parseLiteral(valueNode, variables);
+    } catch (_error) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    if (result === undefined) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    return result;
+  }
+  /* c8 ignore next 3 */
+  // Not reachable, all possible input types have been considered.
+
+  false ||
+    (0, _invariant.invariant)(
+      false,
+      'Unexpected input type: ' + (0, _inspect.inspect)(type),
+    );
+} // Returns true if the provided valueNode is a variable which is not defined
+// in the set of variables.
+
+function isMissingVariable(valueNode, variables) {
+  return (
+    valueNode.kind === _kinds.Kind.VARIABLE &&
+    (variables == null || variables[valueNode.name.value] === undefined)
+  );
+}

package/utilities/valueFromAST.mjs

@@ -0,0 +1,172 @@
+import { inspect } from '../jsutils/inspect.mjs';
+import { invariant } from '../jsutils/invariant.mjs';
+import { keyMap } from '../jsutils/keyMap.mjs';
+import { Kind } from '../language/kinds.mjs';
+import {
+  isInputObjectType,
+  isLeafType,
+  isListType,
+  isNonNullType,
+} from '../type/definition.mjs';
+/**
+ * Produces a JavaScript value given a GraphQL Value AST.
+ *
+ * A GraphQL type must be provided, which will be used to interpret different
+ * GraphQL Value literals.
+ *
+ * Returns `undefined` when the value could not be validly coerced according to
+ * the provided type.
+ *
+ * | GraphQL Value        | JSON Value    |
+ * | -------------------- | ------------- |
+ * | Input Object         | Object        |
+ * | List                 | Array         |
+ * | Boolean              | Boolean       |
+ * | String               | String        |
+ * | Int / Float          | Number        |
+ * | Enum Value           | Unknown       |
+ * | NullValue            | null          |
+ *
+ */
+
+export function valueFromAST(valueNode, type, variables) {
+  if (!valueNode) {
+    // When there is no node, then there is also no value.
+    // Importantly, this is different from returning the value null.
+    return;
+  }
+
+  if (valueNode.kind === Kind.VARIABLE) {
+    const variableName = valueNode.name.value;
+
+    if (variables == null || variables[variableName] === undefined) {
+      // No valid return value.
+      return;
+    }
+
+    const variableValue = variables[variableName];
+
+    if (variableValue === null && isNonNullType(type)) {
+      return; // Invalid: intentionally return no value.
+    } // Note: This does no further checking that this variable is correct.
+    // This assumes that this query has been validated and the variable
+    // usage here is of the correct type.
+
+    return variableValue;
+  }
+
+  if (isNonNullType(type)) {
+    if (valueNode.kind === Kind.NULL) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    return valueFromAST(valueNode, type.ofType, variables);
+  }
+
+  if (valueNode.kind === Kind.NULL) {
+    // This is explicitly returning the value null.
+    return null;
+  }
+
+  if (isListType(type)) {
+    const itemType = type.ofType;
+
+    if (valueNode.kind === Kind.LIST) {
+      const coercedValues = [];
+
+      for (const itemNode of valueNode.values) {
+        if (isMissingVariable(itemNode, variables)) {
+          // If an array contains a missing variable, it is either coerced to
+          // null or if the item type is non-null, it considered invalid.
+          if (isNonNullType(itemType)) {
+            return; // Invalid: intentionally return no value.
+          }
+
+          coercedValues.push(null);
+        } else {
+          const itemValue = valueFromAST(itemNode, itemType, variables);
+
+          if (itemValue === undefined) {
+            return; // Invalid: intentionally return no value.
+          }
+
+          coercedValues.push(itemValue);
+        }
+      }
+
+      return coercedValues;
+    }
+
+    const coercedValue = valueFromAST(valueNode, itemType, variables);
+
+    if (coercedValue === undefined) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    return [coercedValue];
+  }
+
+  if (isInputObjectType(type)) {
+    if (valueNode.kind !== Kind.OBJECT) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    const coercedObj = Object.create(null);
+    const fieldNodes = keyMap(valueNode.fields, (field) => field.name.value);
+
+    for (const field of Object.values(type.getFields())) {
+      const fieldNode = fieldNodes[field.name];
+
+      if (!fieldNode || isMissingVariable(fieldNode.value, variables)) {
+        if (field.defaultValue !== undefined) {
+          coercedObj[field.name] = field.defaultValue;
+        } else if (isNonNullType(field.type)) {
+          return; // Invalid: intentionally return no value.
+        }
+
+        continue;
+      }
+
+      const fieldValue = valueFromAST(fieldNode.value, field.type, variables);
+
+      if (fieldValue === undefined) {
+        return; // Invalid: intentionally return no value.
+      }
+
+      coercedObj[field.name] = fieldValue;
+    }
+
+    return coercedObj;
+  }
+
+  if (isLeafType(type)) {
+    // Scalars and Enums fulfill parsing a literal value via parseLiteral().
+    // Invalid values represent a failure to parse correctly, in which case
+    // no value is returned.
+    let result;
+
+    try {
+      result = type.parseLiteral(valueNode, variables);
+    } catch (_error) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    if (result === undefined) {
+      return; // Invalid: intentionally return no value.
+    }
+
+    return result;
+  }
+  /* c8 ignore next 3 */
+  // Not reachable, all possible input types have been considered.
+
+  false || invariant(false, 'Unexpected input type: ' + inspect(type));
+} // Returns true if the provided valueNode is a variable which is not defined
+// in the set of variables.
+
+function isMissingVariable(valueNode, variables) {
+  return (
+    valueNode.kind === Kind.VARIABLE &&
+    (variables == null || variables[valueNode.name.value] === undefined)
+  );
+}

package/utilities/valueFromASTUntyped.d.ts

@@ -0,0 +1,23 @@
+import type { Maybe } from '../jsutils/Maybe';
+import type { ObjMap } from '../jsutils/ObjMap';
+import type { ValueNode } from '../language/ast';
+/**
+ * Produces a JavaScript value given a GraphQL Value AST.
+ *
+ * Unlike `valueFromAST()`, no type is provided. The resulting JavaScript value
+ * will reflect the provided GraphQL value AST.
+ *
+ * | GraphQL Value        | JavaScript Value |
+ * | -------------------- | ---------------- |
+ * | Input Object         | Object           |
+ * | List                 | Array            |
+ * | Boolean              | Boolean          |
+ * | String / Enum        | String           |
+ * | Int / Float          | Number           |
+ * | Null                 | null             |
+ *
+ */
+export declare function valueFromASTUntyped(
+  valueNode: ValueNode,
+  variables?: Maybe<ObjMap<unknown>>,
+): unknown;

package/utilities/valueFromASTUntyped.js

@@ -0,0 +1,61 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', {
+  value: true,
+});
+exports.valueFromASTUntyped = valueFromASTUntyped;
+
+var _keyValMap = require('../jsutils/keyValMap.js');
+
+var _kinds = require('../language/kinds.js');
+
+/**
+ * Produces a JavaScript value given a GraphQL Value AST.
+ *
+ * Unlike `valueFromAST()`, no type is provided. The resulting JavaScript value
+ * will reflect the provided GraphQL value AST.
+ *
+ * | GraphQL Value        | JavaScript Value |
+ * | -------------------- | ---------------- |
+ * | Input Object         | Object           |
+ * | List                 | Array            |
+ * | Boolean              | Boolean          |
+ * | String / Enum        | String           |
+ * | Int / Float          | Number           |
+ * | Null                 | null             |
+ *
+ */
+function valueFromASTUntyped(valueNode, variables) {
+  switch (valueNode.kind) {
+    case _kinds.Kind.NULL:
+      return null;
+
+    case _kinds.Kind.INT:
+      return parseInt(valueNode.value, 10);
+
+    case _kinds.Kind.FLOAT:
+      return parseFloat(valueNode.value);
+
+    case _kinds.Kind.STRING:
+    case _kinds.Kind.ENUM:
+    case _kinds.Kind.BOOLEAN:
+      return valueNode.value;
+
+    case _kinds.Kind.LIST:
+      return valueNode.values.map((node) =>
+        valueFromASTUntyped(node, variables),
+      );
+
+    case _kinds.Kind.OBJECT:
+      return (0, _keyValMap.keyValMap)(
+        valueNode.fields,
+        (field) => field.name.value,
+        (field) => valueFromASTUntyped(field.value, variables),
+      );
+
+    case _kinds.Kind.VARIABLE:
+      return variables === null || variables === void 0
+        ? void 0
+        : variables[valueNode.name.value];
+  }
+}

package/utilities/valueFromASTUntyped.mjs

@@ -0,0 +1,53 @@
+import { keyValMap } from '../jsutils/keyValMap.mjs';
+import { Kind } from '../language/kinds.mjs';
+/**
+ * Produces a JavaScript value given a GraphQL Value AST.
+ *
+ * Unlike `valueFromAST()`, no type is provided. The resulting JavaScript value
+ * will reflect the provided GraphQL value AST.
+ *
+ * | GraphQL Value        | JavaScript Value |
+ * | -------------------- | ---------------- |
+ * | Input Object         | Object           |
+ * | List                 | Array            |
+ * | Boolean              | Boolean          |
+ * | String / Enum        | String           |
+ * | Int / Float          | Number           |
+ * | Null                 | null             |
+ *
+ */
+
+export function valueFromASTUntyped(valueNode, variables) {
+  switch (valueNode.kind) {
+    case Kind.NULL:
+      return null;
+
+    case Kind.INT:
+      return parseInt(valueNode.value, 10);
+
+    case Kind.FLOAT:
+      return parseFloat(valueNode.value);
+
+    case Kind.STRING:
+    case Kind.ENUM:
+    case Kind.BOOLEAN:
+      return valueNode.value;
+
+    case Kind.LIST:
+      return valueNode.values.map((node) =>
+        valueFromASTUntyped(node, variables),
+      );
+
+    case Kind.OBJECT:
+      return keyValMap(
+        valueNode.fields,
+        (field) => field.name.value,
+        (field) => valueFromASTUntyped(field.value, variables),
+      );
+
+    case Kind.VARIABLE:
+      return variables === null || variables === void 0
+        ? void 0
+        : variables[valueNode.name.value];
+  }
+}

package/validation/ValidationContext.d.ts

@@ -0,0 +1,95 @@
+import type { Maybe } from '../jsutils/Maybe';
+import type { GraphQLError } from '../error/GraphQLError';
+import type {
+  DocumentNode,
+  FragmentDefinitionNode,
+  FragmentSpreadNode,
+  OperationDefinitionNode,
+  SelectionSetNode,
+  VariableNode,
+} from '../language/ast';
+import type { ASTVisitor } from '../language/visitor';
+import type {
+  GraphQLArgument,
+  GraphQLCompositeType,
+  GraphQLEnumValue,
+  GraphQLField,
+  GraphQLInputType,
+  GraphQLOutputType,
+} from '../type/definition';
+import type { GraphQLDirective } from '../type/directives';
+import type { GraphQLSchema } from '../type/schema';
+import { TypeInfo } from '../utilities/TypeInfo';
+declare type NodeWithSelectionSet =
+  | OperationDefinitionNode
+  | FragmentDefinitionNode;
+interface VariableUsage {
+  readonly node: VariableNode;
+  readonly type: Maybe<GraphQLInputType>;
+  readonly defaultValue: Maybe<unknown>;
+}
+/**
+ * An instance of this class is passed as the "this" context to all validators,
+ * allowing access to commonly useful contextual information from within a
+ * validation rule.
+ */
+export declare class ASTValidationContext {
+  private _ast;
+  private _onError;
+  private _fragments;
+  private _fragmentSpreads;
+  private _recursivelyReferencedFragments;
+  constructor(ast: DocumentNode, onError: (error: GraphQLError) => void);
+  get [Symbol.toStringTag](): string;
+  reportError(error: GraphQLError): void;
+  getDocument(): DocumentNode;
+  getFragment(name: string): Maybe<FragmentDefinitionNode>;
+  getFragmentSpreads(node: SelectionSetNode): ReadonlyArray<FragmentSpreadNode>;
+  getRecursivelyReferencedFragments(
+    operation: OperationDefinitionNode,
+  ): ReadonlyArray<FragmentDefinitionNode>;
+}
+export declare type ASTValidationRule = (
+  context: ASTValidationContext,
+) => ASTVisitor;
+export declare class SDLValidationContext extends ASTValidationContext {
+  private _schema;
+  constructor(
+    ast: DocumentNode,
+    schema: Maybe<GraphQLSchema>,
+    onError: (error: GraphQLError) => void,
+  );
+  get [Symbol.toStringTag](): string;
+  getSchema(): Maybe<GraphQLSchema>;
+}
+export declare type SDLValidationRule = (
+  context: SDLValidationContext,
+) => ASTVisitor;
+export declare class ValidationContext extends ASTValidationContext {
+  private _schema;
+  private _typeInfo;
+  private _variableUsages;
+  private _recursiveVariableUsages;
+  constructor(
+    schema: GraphQLSchema,
+    ast: DocumentNode,
+    typeInfo: TypeInfo,
+    onError: (error: GraphQLError) => void,
+  );
+  get [Symbol.toStringTag](): string;
+  getSchema(): GraphQLSchema;
+  getVariableUsages(node: NodeWithSelectionSet): ReadonlyArray<VariableUsage>;
+  getRecursiveVariableUsages(
+    operation: OperationDefinitionNode,
+  ): ReadonlyArray<VariableUsage>;
+  getType(): Maybe<GraphQLOutputType>;
+  getParentType(): Maybe<GraphQLCompositeType>;
+  getInputType(): Maybe<GraphQLInputType>;
+  getParentInputType(): Maybe<GraphQLInputType>;
+  getFieldDef(): Maybe<GraphQLField<unknown, unknown>>;
+  getDirective(): Maybe<GraphQLDirective>;
+  getArgument(): Maybe<GraphQLArgument>;
+  getEnumValue(): Maybe<GraphQLEnumValue>;
+}
+export declare type ValidationRule = (context: ValidationContext) => ASTVisitor;
+export {};