graphql_cody 1.13.0

data/lib/graphql/internal_representation/rewrite.rb

@@ -0,0 +1,184 @@
+# frozen_string_literal: true
+module GraphQL
+  module InternalRepresentation
+    # While visiting an AST, build a normalized, flattened tree of {InternalRepresentation::Node}s.
+    #
+    # No unions or interfaces are present in this tree, only object types.
+    #
+    # Selections from the AST are attached to the object types they apply to.
+    #
+    # Inline fragments and fragment spreads are preserved in {InternalRepresentation::Node#ast_spreads},
+    # where they can be used to check for the presence of directives. This might not be sufficient
+    # for future directives, since the selections' grouping is lost.
+    #
+    # The rewritten query tree serves as the basis for the `FieldsWillMerge` validation.
+    #
+    module Rewrite
+      include GraphQL::Language
+
+      NO_DIRECTIVES = [].freeze
+
+      # @return InternalRepresentation::Document
+      attr_reader :rewrite_document
+
+      def initialize(*)
+        super
+        @query = context.query
+        @rewrite_document = InternalRepresentation::Document.new
+        # Hash<Nodes::FragmentSpread => Set<InternalRepresentation::Node>>
+        # A record of fragment spreads and the irep nodes that used them
+        @rewrite_spread_parents = Hash.new { |h, k| h[k] = Set.new }
+        # Hash<Nodes::FragmentSpread => Scope>
+        @rewrite_spread_scopes = {}
+        # Array<Set<InternalRepresentation::Node>>
+        # The current point of the irep_tree during visitation
+        @rewrite_nodes_stack = []
+        # Array<Scope>
+        @rewrite_scopes_stack = []
+        @rewrite_skip_nodes = Set.new
+
+        # Resolve fragment spreads.
+        # Fragment definitions got their own irep trees during visitation.
+        # Those nodes are spliced in verbatim (not copied), but this is OK
+        # because fragments are resolved from the "bottom up", each fragment
+        # can be shared between its usages.
+        context.on_dependency_resolve do |defn_ast_node, spread_ast_nodes, frag_ast_node|
+          frag_name = frag_ast_node.name
+          fragment_node = @rewrite_document.fragment_definitions[frag_name]
+
+          if fragment_node
+            spread_ast_nodes.each do |spread_ast_node|
+              parent_nodes = @rewrite_spread_parents[spread_ast_node]
+              parent_scope = @rewrite_spread_scopes[spread_ast_node]
+              parent_nodes.each do |parent_node|
+                parent_node.deep_merge_node(fragment_node, scope: parent_scope, merge_self: false)
+              end
+            end
+          end
+        end
+      end
+
+      # @return [Hash<String, Node>] Roots of this query
+      def operations
+        GraphQL::Deprecation.warn "#{self.class}#operations is deprecated; use `document.operation_definitions` instead"
+        @document.operation_definitions
+      end
+
+      def on_operation_definition(ast_node, parent)
+        push_root_node(ast_node, @rewrite_document.operation_definitions) { super }
+      end
+
+      def on_fragment_definition(ast_node, parent)
+        push_root_node(ast_node, @rewrite_document.fragment_definitions) { super }
+      end
+
+      def push_root_node(ast_node, definitions)
+        # Either QueryType or the fragment type condition
+        owner_type = context.type_definition
+        defn_name = ast_node.name
+
+        node = Node.new(
+          parent: nil,
+          name: defn_name,
+          owner_type: owner_type,
+          query: @query,
+          ast_nodes: [ast_node],
+          return_type: owner_type,
+        )
+
+        definitions[defn_name] = node
+        @rewrite_scopes_stack.push(Scope.new(@query, owner_type))
+        @rewrite_nodes_stack.push([node])
+        yield
+        @rewrite_nodes_stack.pop
+        @rewrite_scopes_stack.pop
+      end
+
+      def on_inline_fragment(node, parent)
+        # Inline fragments provide two things to the rewritten tree:
+        # - They _may_ narrow the scope by their type condition
+        # - They _may_ apply their directives to their children
+        if skip?(node)
+          @rewrite_skip_nodes.add(node)
+        end
+
+        if @rewrite_skip_nodes.empty?
+          @rewrite_scopes_stack.push(@rewrite_scopes_stack.last.enter(context.type_definition))
+        end
+
+        super
+
+        if @rewrite_skip_nodes.empty?
+          @rewrite_scopes_stack.pop
+        end
+
+        if @rewrite_skip_nodes.include?(node)
+          @rewrite_skip_nodes.delete(node)
+        end
+      end
+
+      def on_field(ast_node, ast_parent)
+        if skip?(ast_node)
+          @rewrite_skip_nodes.add(ast_node)
+        end
+
+        if @rewrite_skip_nodes.empty?
+          node_name = ast_node.alias || ast_node.name
+          parent_nodes = @rewrite_nodes_stack.last
+          next_nodes = []
+
+          field_defn = context.field_definition
+          if field_defn.nil?
+            # It's a non-existent field
+            new_scope = nil
+          else
+            field_return_type = field_defn.type
+            @rewrite_scopes_stack.last.each do |scope_type|
+              parent_nodes.each do |parent_node|
+                node = parent_node.scoped_children[scope_type][node_name] ||= Node.new(
+                  parent: parent_node,
+                  name: node_name,
+                  owner_type: scope_type,
+                  query: @query,
+                  return_type: field_return_type,
+                )
+                node.ast_nodes << ast_node
+                node.definitions << field_defn
+                next_nodes << node
+              end
+            end
+            new_scope = Scope.new(@query, field_return_type.unwrap)
+          end
+
+          @rewrite_nodes_stack.push(next_nodes)
+          @rewrite_scopes_stack.push(new_scope)
+        end
+
+        super
+
+        if @rewrite_skip_nodes.empty?
+          @rewrite_nodes_stack.pop
+          @rewrite_scopes_stack.pop
+        end
+
+        if @rewrite_skip_nodes.include?(ast_node)
+          @rewrite_skip_nodes.delete(ast_node)
+        end
+      end
+
+      def on_fragment_spread(ast_node, ast_parent)
+        if @rewrite_skip_nodes.empty? && !skip?(ast_node)
+          # Register the irep nodes that depend on this AST node:
+          @rewrite_spread_parents[ast_node].merge(@rewrite_nodes_stack.last)
+          @rewrite_spread_scopes[ast_node] = @rewrite_scopes_stack.last
+        end
+        super
+      end
+
+      def skip?(ast_node)
+        dir = ast_node.directives
+        dir.any? && !GraphQL::Execution::DirectiveChecks.include?(dir, @query)
+      end
+    end
+  end
+end

data/lib/graphql/internal_representation/scope.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+module GraphQL
+  module InternalRepresentation
+    # At a point in the AST, selections may apply to one or more types.
+    # {Scope} represents those types which selections may apply to.
+    #
+    # Scopes can be defined by:
+    #
+    # - A single concrete or abstract type
+    # - An array of types
+    # - `nil`
+    #
+    # The AST may be scoped to an array of types when two abstractly-typed
+    # fragments occur in inside one another.
+    class Scope
+      NO_TYPES = [].freeze
+
+      # @param query [GraphQL::Query]
+      # @param type_defn [GraphQL::BaseType, Array<GraphQL::BaseType>, nil]
+      def initialize(query, type_defn)
+        @query = query
+        @type = type_defn
+        @abstract_type = false
+        @types = case type_defn
+        when Array
+          type_defn
+        when GraphQL::BaseType
+          @abstract_type = true
+          nil
+        when nil
+          NO_TYPES
+        else
+          raise "Unexpected scope type: #{type_defn}"
+        end
+      end
+
+      # From a starting point of `self`, create a new scope by condition `other_type_defn`.
+      # @param other_type_defn [GraphQL::BaseType, nil]
+      # @return [Scope]
+      def enter(other_type_defn)
+        case other_type_defn
+        when nil
+          # The type wasn't found, who cares
+          Scope.new(@query, nil)
+        when @type
+          # The condition is the same as current, so reuse self
+          self
+        when GraphQL::UnionType, GraphQL::InterfaceType
+          # Make a new scope of the intersection between the previous & next conditions
+          new_types = @query.possible_types(other_type_defn) & concrete_types
+          Scope.new(@query, new_types)
+        when GraphQL::BaseType
+          # If this type is valid within the current scope,
+          # return a new scope of _exactly_ this type.
+          # Otherwise, this type is out-of-scope so the scope is null.
+          if concrete_types.include?(other_type_defn)
+            Scope.new(@query, other_type_defn)
+          else
+            Scope.new(@query, nil)
+          end
+        else
+          raise "Unexpected scope: #{other_type_defn.inspect}"
+        end
+      end
+
+      # Call the block for each type in `self`.
+      # This uses the simplest possible expression of `self`,
+      # so if this scope is defined by an abstract type, it gets yielded.
+      def each(&block)
+        if @abstract_type
+          yield(@type)
+        else
+          @types.each(&block)
+        end
+      end
+
+      private
+
+      def concrete_types
+        @concrete_types ||= if @abstract_type
+          @query.possible_types(@type)
+        else
+          @types
+        end
+      end
+    end
+  end
+end

data/lib/graphql/internal_representation/visit.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+module GraphQL
+  module InternalRepresentation
+    # Traverse a re-written query tree, calling handlers for each node
+    module Visit
+      module_function
+      def visit_each_node(operations, handlers)
+        return if handlers.empty?
+        # Post-validation: make some assertions about the rewritten query tree
+        operations.each do |op_name, op_node|
+          # Yield each node to listeners which were attached by validators
+          op_node.typed_children.each do |obj_type, children|
+            children.each do |name, op_child_node|
+              each_node(op_child_node) do |node|
+                for h in handlers
+                  h.call(node)
+                end
+              end
+            end
+          end
+        end
+      end
+
+      # Traverse a node in a rewritten query tree,
+      # visiting the node itself and each of its typed children.
+      def each_node(node, &block)
+        yield(node)
+        node.typed_children.each do |obj_type, children|
+          children.each do |name, node|
+            each_node(node, &block)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/graphql/internal_representation.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+require "graphql/internal_representation/document"
+require "graphql/internal_representation/node"
+require "graphql/internal_representation/print"
+require "graphql/internal_representation/rewrite"
+require "graphql/internal_representation/scope"
+require "graphql/internal_representation/visit"

data/lib/graphql/introspection/base_object.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class BaseObject < GraphQL::Schema::Object
+      introspection(true)
+
+      def self.field(*args, **kwargs, &block)
+        kwargs[:introspection] = true
+        super(*args, **kwargs, &block)
+      end
+    end
+  end
+end

data/lib/graphql/introspection/directive_location_enum.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class DirectiveLocationEnum < GraphQL::Schema::Enum
+      graphql_name "__DirectiveLocation"
+      description "A Directive can be adjacent to many parts of the GraphQL language, "\
+                  "a __DirectiveLocation describes one such possible adjacencies."
+
+      GraphQL::Directive::LOCATIONS.each do |location|
+        value(location.to_s, GraphQL::Directive::LOCATION_DESCRIPTIONS[location], value: location)
+      end
+      introspection true
+    end
+  end
+end

data/lib/graphql/introspection/directive_type.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class DirectiveType < Introspection::BaseObject
+      graphql_name "__Directive"
+      description "A Directive provides a way to describe alternate runtime execution and type validation behavior in a GraphQL document."\
+                  "\n\n"\
+                  "In some cases, you need to provide options to alter GraphQL's execution behavior "\
+                  "in ways field arguments will not suffice, such as conditionally including or "\
+                  "skipping a field. Directives provide this by describing additional information "\
+                    "to the executor."
+      field :name, String, null: false, method: :graphql_name
+      field :description, String
+      field :locations, [GraphQL::Schema::LateBoundType.new("__DirectiveLocation")], null: false
+      field :args, [GraphQL::Schema::LateBoundType.new("__InputValue")], null: false do
+        argument :include_deprecated, Boolean, required: false, default_value: false
+      end
+      field :on_operation, Boolean, null: false, deprecation_reason: "Use `locations`.", method: :on_operation?
+      field :on_fragment, Boolean, null: false, deprecation_reason: "Use `locations`.", method: :on_fragment?
+      field :on_field, Boolean, null: false, deprecation_reason: "Use `locations`.", method: :on_field?
+
+      def args(include_deprecated:)
+        args = @context.warden.arguments(@object)
+        args = args.reject(&:deprecation_reason) unless include_deprecated
+        args
+      end
+    end
+  end
+end

data/lib/graphql/introspection/dynamic_fields.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class DynamicFields < Introspection::BaseObject
+      field :__typename, String, "The name of this type", null: false, extras: [:irep_node]
+
+      # `irep_node:` will be nil for the interpreter, since there is no such thing
+      def __typename(irep_node: nil)
+        if context.interpreter?
+          object.class.graphql_name
+        else
+          irep_node.owner_type.name
+        end
+      end
+    end
+  end
+end

data/lib/graphql/introspection/entry_points.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class EntryPoints < Introspection::BaseObject
+      field :__schema, GraphQL::Schema::LateBoundType.new("__Schema"), "This GraphQL schema", null: false
+      field :__type, GraphQL::Schema::LateBoundType.new("__Type"), "A type in the GraphQL system" do
+        argument :name, String
+      end
+
+      def __schema
+        # Apply wrapping manually since this field isn't wrapped by instrumentation
+        schema = @context.query.schema
+        schema_type = schema.introspection_system.types["__Schema"]
+        schema_type.type_class.authorized_new(schema, @context)
+      end
+
+      def __type(name:)
+        return unless context.warden.reachable_type?(name)
+        type = context.warden.get_type(name)
+
+        if type && context.interpreter? && !type.is_a?(Module)
+          type = type.type_class || raise("Invariant: interpreter requires class-based type for #{name}")
+        end
+
+        # The interpreter provides this wrapping, other execution doesnt, so support both.
+        if type && !context.interpreter?
+          # Apply wrapping manually since this field isn't wrapped by instrumentation
+          type_type = context.schema.introspection_system.types["__Type"]
+          type = type_type.type_class.authorized_new(type, context)
+        end
+        type
+      end
+    end
+  end
+end

data/lib/graphql/introspection/enum_value_type.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class EnumValueType < Introspection::BaseObject
+      graphql_name "__EnumValue"
+      description "One possible value for a given Enum. Enum values are unique values, not a "\
+                  "placeholder for a string or numeric value. However an Enum value is returned in "\
+                  "a JSON response as a string."
+      field :name, String, null: false
+      field :description, String
+      field :is_deprecated, Boolean, null: false
+      field :deprecation_reason, String
+
+      def name
+        object.graphql_name
+      end
+
+      def is_deprecated
+        !!@object.deprecation_reason
+      end
+    end
+  end
+end

data/lib/graphql/introspection/field_type.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class FieldType < Introspection::BaseObject
+      graphql_name "__Field"
+      description "Object and Interface types are described by a list of Fields, each of which has "\
+                  "a name, potentially a list of arguments, and a return type."
+      field :name, String, null: false
+      field :description, String
+      field :args, [GraphQL::Schema::LateBoundType.new("__InputValue")], null: false do
+        argument :include_deprecated, Boolean, required: false, default_value: false
+      end
+      field :type, GraphQL::Schema::LateBoundType.new("__Type"), null: false
+      field :is_deprecated, Boolean, null: false
+      field :deprecation_reason, String
+
+      def is_deprecated
+        !!@object.deprecation_reason
+      end
+
+      def args(include_deprecated:)
+        args = @context.warden.arguments(@object)
+        args = args.reject(&:deprecation_reason) unless include_deprecated
+        args
+      end
+    end
+  end
+end

data/lib/graphql/introspection/input_value_type.rb

@@ -0,0 +1,67 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class InputValueType < Introspection::BaseObject
+      graphql_name "__InputValue"
+      description "Arguments provided to Fields or Directives and the input fields of an "\
+                  "InputObject are represented as Input Values which describe their type and "\
+                  "optionally a default value."
+      field :name, String, null: false
+      field :description, String
+      field :type, GraphQL::Schema::LateBoundType.new("__Type"), null: false
+      field :default_value, String, "A GraphQL-formatted string representing the default value for this input value."
+      field :is_deprecated, Boolean, null: false
+      field :deprecation_reason, String
+
+      def is_deprecated
+        !!@object.deprecation_reason
+      end
+
+      def default_value
+        if @object.default_value?
+          value = @object.default_value
+          if value.nil?
+            'null'
+          else
+            if (@object.type.kind.list? || (@object.type.kind.non_null? && @object.type.of_type.kind.list?)) && !value.respond_to?(:map)
+              # This is a bit odd -- we expect the default value to be an application-style value, so we use coerce result below.
+              # But coerce_result doesn't wrap single-item lists, which are valid inputs to list types.
+              # So, apply that wrapper here if needed.
+              value = [value]
+            end
+            coerced_default_value = @object.type.coerce_result(value, @context)
+            serialize_default_value(coerced_default_value, @object.type)
+          end
+        else
+          nil
+        end
+      end
+
+
+      private
+
+      # Recursively serialize, taking care not to add quotes to enum values
+      def serialize_default_value(value, type)
+        if value.nil?
+          'null'
+        elsif type.kind.list?
+          inner_type = type.of_type
+          "[" + value.map { |v| serialize_default_value(v, inner_type) }.join(", ") + "]"
+        elsif type.kind.non_null?
+          serialize_default_value(value, type.of_type)
+        elsif type.kind.enum?
+          value
+        elsif type.kind.input_object?
+          "{" +
+            value.map do |k, v|
+              arg_defn = type.get_argument(k, context)
+              "#{k}: #{serialize_default_value(v, arg_defn.type)}"
+            end.join(", ") +
+            "}"
+        else
+          GraphQL::Language.serialize(value)
+        end
+      end
+    end
+  end
+end

data/lib/graphql/introspection/introspection_query.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+# This query is used by graphql-client so don't add the includeDeprecated
+# argument for inputFields since the server may not support it. Two stage
+# introspection queries will be required to handle this in clients.
+GraphQL::Introspection::INTROSPECTION_QUERY = GraphQL::Introspection.query
+

data/lib/graphql/introspection/schema_type.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+module GraphQL
+  module Introspection
+    class SchemaType < Introspection::BaseObject
+      graphql_name "__Schema"
+      description "A GraphQL Schema defines the capabilities of a GraphQL server. It exposes all "\
+                  "available types and directives on the server, as well as the entry points for "\
+                  "query, mutation, and subscription operations."
+
+      field :types, [GraphQL::Schema::LateBoundType.new("__Type")], "A list of all types supported by this server.", null: false
+      field :query_type, GraphQL::Schema::LateBoundType.new("__Type"), "The type that query operations will be rooted at.", null: false
+      field :mutation_type, GraphQL::Schema::LateBoundType.new("__Type"), "If this server supports mutation, the type that mutation operations will be rooted at."
+      field :subscription_type, GraphQL::Schema::LateBoundType.new("__Type"), "If this server support subscription, the type that subscription operations will be rooted at."
+      field :directives, [GraphQL::Schema::LateBoundType.new("__Directive")], "A list of all directives supported by this server.", null: false
+
+      def types
+        @context.warden.reachable_types.sort_by(&:graphql_name)
+      end
+
+      def query_type
+        permitted_root_type("query")
+      end
+
+      def mutation_type
+        permitted_root_type("mutation")
+      end
+
+      def subscription_type
+        permitted_root_type("subscription")
+      end
+
+      def directives
+        @context.warden.directives
+      end
+
+      private
+
+      def permitted_root_type(op_type)
+        @context.warden.root_type_for_operation(op_type)
+      end
+    end
+  end
+end

data/lib/graphql/introspection/type_kind_enum.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+module GraphQL
+  module Introspection
+    class TypeKindEnum < GraphQL::Schema::Enum
+      graphql_name "__TypeKind"
+      description "An enum describing what kind of type a given `__Type` is."
+      GraphQL::TypeKinds::TYPE_KINDS.each do |type_kind|
+        value(type_kind.name, type_kind.description)
+      end
+      introspection true
+    end
+  end
+end