graphql 2.6.11 → 2.6.13

data/lib/graphql/relay/range_add.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Relay
     # This provides some isolation from `GraphQL::Relay` internals.
@@ -8,32 +9,42 @@ module GraphQL
     # The connection doesn't receive outside arguments, so the list of items
     # should be ordered and paginated before providing it here.
     #
-    # @example Adding a comment to list of comments
-    #   post = Post.find(args[:post_id])
-    #   comments = post.comments
-    #   new_comment = comments.build(body: args[:body])
-    #   new_comment.save!
+    # **Examples**
     #
-    #   range_add = GraphQL::Relay::RangeAdd.new(
-    #     parent: post,
-    #     collection: comments,
-    #     item: new_comment,
-    #     context: context,
-    #   )
+    # **Example: Adding a comment to list of comments**
     #
-    #   response = {
-    #     post: post,
-    #     comments_connection: range_add.connection,
-    #     new_comment_edge: range_add.edge,
-    #   }
+    # ```ruby
+    # post = Post.find(args[:post_id])
+    # comments = post.comments
+    # new_comment = comments.build(body: args[:body])
+    # new_comment.save!
+    #
+    # range_add = GraphQL::Relay::RangeAdd.new(
+    #   parent: post,
+    #   collection: comments,
+    #   item: new_comment,
+    #   context: context,
+    # )
+    #
+    # response = {
+    #   post: post,
+    #   comments_connection: range_add.connection,
+    #   new_comment_edge: range_add.edge,
+    # }
+    # ```
     class RangeAdd
       attr_reader :edge, :connection, :parent
 
-      # @param collection [Object] The list of items to wrap in a connection
-      # @param item [Object] The newly-added item (will be wrapped in `edge_class`)
-      # @param context [GraphQL::Query::Context] The surrounding `ctx`, will be passed to the connection
-      # @param parent [Object] The owner of `collection`, will be passed to the connection if provided
-      # @param edge_class [Class] The class to wrap `item` with (defaults to the connection's edge class)
+      # **Parameters**
+      #
+      # - `collection` (`Object`) — The list of items to wrap in a connection
+      # - `item` (`Object`) — The newly-added item (will be wrapped in `edge_class`)
+      # - `context` (`GraphQL::Query::Context`) — The surrounding `ctx`, will be passed to the connection
+      # - `parent` (`Object`) — The owner of `collection`, will be passed to the connection if provided
+      # - `edge_class` (`Class`) — The class to wrap `item` with (defaults to the connection's edge class)
+      #
+      # :call-seq:
+      #   initialize(Object collection:, Object item:, GraphQL::Query::Context context:, Object parent:, Class edge_class:)
       def initialize(collection:, item:, context:, parent: nil, edge_class: nil)
         conn_class = context.schema.connections.wrapper_for(collection)
         # The rest will be added by ConnectionExtension

data/lib/graphql/relay.rb

@@ -1,3 +1,4 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'graphql/relay/range_add'

data/lib/graphql/rubocop/graphql/base_cop.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 require "rubocop"
 
 module GraphQL

data/lib/graphql/rubocop/graphql/default_null_true.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 require_relative "base_cop"
 
 module GraphQL
@@ -11,15 +12,17 @@ module GraphQL
       # to non-null fields (`null: false`) without a breaking change. (The opposite change, from `null: false`
       # to `null: true`, change.)
       #
-      # @example
-      #   # Both of these define `name: String` in GraphQL:
+      # **Examples**
       #
-      #   # bad
-      #   field :name, String, null: true
+      # **Example: # Both of these define `name: String` in GraphQL:**
       #
-      #   # good
-      #   field :name, String
+      # ```ruby
+      # # bad
+      # field :name, String, null: true
       #
+      # # good
+      # field :name, String
+      # ```
       class DefaultNullTrue < BaseCop
         MSG = "`null: true` is the default and can be removed."
 

data/lib/graphql/rubocop/graphql/default_required_true.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 require_relative "./base_cop"
 
 module GraphQL
@@ -11,15 +12,17 @@ module GraphQL
       # to optional arguments (`required: false`) without a breaking change. (The opposite change, from `required: false`
       # to `required: true`, change.)
       #
-      # @example
-      #   # Both of these define `id: ID!` in GraphQL:
+      # **Examples**
       #
-      #   # bad
-      #   argument :id, ID, required: true
+      # **Example: # Both of these define `id: ID!` in GraphQL:**
       #
-      #   # good
-      #   argument :id, ID
+      # ```ruby
+      # # bad
+      # argument :id, ID, required: true
       #
+      # # good
+      # argument :id, ID
+      # ```
       class DefaultRequiredTrue < BaseCop
         MSG = "`required: true` is the default and can be removed."
 

data/lib/graphql/rubocop/graphql/field_type_in_block.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 require_relative "./base_cop"
 
 module GraphQL
@@ -7,15 +8,18 @@ module GraphQL
       # Identify (and auto-correct) any field whose type configuration isn't given
       # in the configuration block.
       #
-      # @example
-      #   # bad, immediately causes Rails to load `app/graphql/types/thing.rb`
-      #   field :thing, Types::Thing
+      # **Examples**
       #
-      #   # good, defers loading until the file is needed
-      #   field :thing do
-      #     type(Types::Thing)
-      #   end
+      # **Example: # bad, immediately causes Rails to load `app/graphql/types/thing.rb`**
       #
+      # ```ruby
+      # field :thing, Types::Thing
+      #
+      # # good, defers loading until the file is needed
+      # field :thing do
+      #   type(Types::Thing)
+      # end
+      # ```
       class FieldTypeInBlock < BaseCop
         MSG = "type configuration can be moved to a block to defer loading the type's file"
 
@@ -133,7 +137,7 @@ module GraphQL
             field_indent << " "
             indent_test_idx -= 1
             if indent_test_idx == 0
-              raise "Invariant: somehow backtracted to beginning of class when looking for field indent (source: #{node_source.inspect})"
+              raise "Invariant: somehow backtracted to beginning of class when looking for field indent (source: #{type_defn_source.inspect})"
             end
           end
           field_indent

data/lib/graphql/rubocop/graphql/root_types_in_block.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 require_relative "./base_cop"
 
 module GraphQL
@@ -6,13 +7,16 @@ module GraphQL
     module GraphQL
       # Identify (and auto-correct) any root types in your schema file.
       #
-      # @example
-      #   # bad, immediately causes Rails to load `app/graphql/types/query.rb`
-      #   query Types::Query
+      # **Examples**
       #
-      #   # good, defers loading until the file is needed
-      #   query { Types::Query }
+      # **Example: # bad, immediately causes Rails to load `app/graphql/types/query.rb`**
       #
+      # ```ruby
+      # query Types::Query
+      #
+      # # good, defers loading until the file is needed
+      # query { Types::Query }
+      # ```
       class RootTypesInBlock < BaseCop
         MSG = "type configuration can be moved to a block to defer loading the type's file"
 

data/lib/graphql/rubocop.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require "graphql/rubocop/graphql/default_null_true"
 require "graphql/rubocop/graphql/default_required_true"

data/lib/graphql/runtime_error.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   class RuntimeError < Error
     include GraphQL::Execution::Finalizer

data/lib/graphql/runtime_type_error.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   class RuntimeTypeError < GraphQL::Error
   end

data/lib/graphql/schema/addition.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 module GraphQL
   class Schema
@@ -91,14 +92,17 @@ module GraphQL
       def update_type_owner(owner, type)
         case owner
         when Module
+          owner = owner #: as GraphQL::Schema::Member::type_definition
           if owner.kind.union?
+            union_type = owner #: as singleton(GraphQL::Schema::Union)
             # It's a union with possible_types
             # Replace the item by class name
-            owner.assign_type_membership_object_type(type)
-            @possible_types[owner] = owner.possible_types
+            union_type.assign_type_membership_object_type(type)
+            @possible_types[owner] = union_type.possible_types
           elsif type.kind.interface? && (owner.kind.object? || owner.kind.interface?)
+            implementing_type = owner #: as GraphQL::Schema::Member::HasInterfaces
             new_interfaces = []
-            owner.interfaces.each do |int_t|
+            implementing_type.interfaces.each do |int_t|
               if int_t.is_a?(String) && int_t == type.graphql_name
                 new_interfaces << type
               elsif int_t.is_a?(LateBoundType) && int_t.graphql_name == type.graphql_name
@@ -108,15 +112,23 @@ module GraphQL
                 # they were probably already added, maybe with options.
               end
             end
-            owner.implements(*new_interfaces)
+            implementing_type.implements(*new_interfaces)
             new_interfaces.each do |int|
               pt = @possible_types[int] ||= []
               if !pt.include?(owner) && owner.is_a?(Class)
                 pt << owner
               end
               int.interfaces.each do |indirect_int|
-                if indirect_int.is_a?(LateBoundType) && (indirect_int_type = get_type(indirect_int.graphql_name))
-                  update_type_owner(owner, indirect_int_type)
+                if indirect_int.is_a?(LateBoundType)
+                  if (indirect_int_type = get_type(indirect_int.graphql_name))
+                    update_type_owner(owner, indirect_int_type)
+                  end
+                elsif owner.is_a?(Class)
+                  # `implements` added this one, too, because `int` implements it
+                  indirect_pt = @possible_types[indirect_int] ||= []
+                  if !indirect_pt.include?(owner)
+                    indirect_pt << owner
+                  end
                 end
               end
             end

data/lib/graphql/schema/always_visible.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   class Schema
     module AlwaysVisible