graphql 2.6.9 → 2.6.14

data/lib/graphql/float_decoding_error.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+# typed: true
+module GraphQL
+  # This error is raised when `Types::Float` is given a non-finite input value.
+  class FloatDecodingError < GraphQL::RuntimeTypeError
+    # The value which couldn't be decoded
+    attr_reader :float_value
+
+    def initialize(value)
+      @float_value = value
+      super("Float is not finite: #{value.inspect}.")
+    end
+  end
+end

data/lib/graphql/float_encoding_error.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+# typed: true
+module GraphQL
+  # This error is raised when `Types::Float` is asked to return a non-finite value.
+  class FloatEncodingError < GraphQL::RuntimeTypeError
+    # The value which couldn't be encoded
+    attr_reader :float_value
+
+    # **Returns**
+    #
+    # - `GraphQL::Schema::Field` — The field that returned a non-finite float
+    attr_reader :field
+
+    # **Returns**
+    #
+    # - `Array<String, Integer>` — Where the field appeared in the GraphQL response
+    attr_reader :path
+
+    def initialize(value, context:)
+      @float_value = value
+      @field = context[:current_field]
+      @path = context[:current_path]
+      message = "Float is not finite: #{value.inspect}".dup
+      if @path
+        message << " @ #{@path.join(".")}"
+      end
+      if @field
+        message << " (#{@field.path})"
+      end
+      super("#{message}.")
+    end
+  end
+end

data/lib/graphql/integer_decoding_error.rb

@@ -1,10 +1,11 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   # This error is raised when `Types::Int` is given an input value outside of 32-bit integer range.
   #
   # For really big integer values, consider `GraphQL::Types::BigInt`
   #
-  # @see GraphQL::Types::Int which raises this error
+  # See [GraphQL::Types::Int](rdoc-ref:GraphQL::Types::Int) which raises this error
   class IntegerDecodingError < GraphQL::RuntimeTypeError
     # The value which couldn't be decoded
     attr_reader :integer_value

data/lib/graphql/integer_encoding_error.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   # This error is raised when `Types::Int` is asked to return a value outside of 32-bit integer range.
   #
@@ -7,15 +8,19 @@ module GraphQL
   # - `ID` for database primary keys or other identifiers
   # - `GraphQL::Types::BigInt` for really big integer values
   #
-  # @see GraphQL::Types::Int which raises this error
+  # See [GraphQL::Types::Int](rdoc-ref:GraphQL::Types::Int) which raises this error
   class IntegerEncodingError < GraphQL::RuntimeTypeError
     # The value which couldn't be encoded
     attr_reader :integer_value
 
-    # @return [GraphQL::Schema::Field] The field that returned a too-big integer
+    # **Returns**
+    #
+    # - `GraphQL::Schema::Field` — The field that returned a too-big integer
     attr_reader :field
 
-    # @return [Array<String, Integer>] Where the field appeared in the GraphQL response
+    # **Returns**
+    #
+    # - `Array<String, Integer>` — Where the field appeared in the GraphQL response
     attr_reader :path
 
     def initialize(value, context:)

data/lib/graphql/introspection/base_object.rb

@@ -1,12 +1,14 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class BaseObject < GraphQL::Schema::Object
       introspection(true)
 
+      #: (*untyped args, **untyped kwargs) ?{ (GraphQL::Schema::Field) [self: GraphQL::Schema::Field] -> void } -> untyped
       def self.field(*args, **kwargs, &block)
         kwargs[:introspection] = true
-        super(*args, **kwargs, &block)
+        super
       end
     end
   end

data/lib/graphql/introspection/directive_location_enum.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class DirectiveLocationEnum < GraphQL::Schema::Enum

data/lib/graphql/introspection/directive_type.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class DirectiveType < Introspection::BaseObject

data/lib/graphql/introspection/dynamic_fields.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class DynamicFields < Introspection::BaseObject

data/lib/graphql/introspection/entry_points.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class EntryPoints < Introspection::BaseObject

data/lib/graphql/introspection/enum_value_type.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class EnumValueType < Introspection::BaseObject

data/lib/graphql/introspection/field_type.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class FieldType < Introspection::BaseObject

data/lib/graphql/introspection/input_value_type.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class InputValueType < Introspection::BaseObject

data/lib/graphql/introspection/introspection_query.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: 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

data/lib/graphql/introspection/schema_type.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 module GraphQL
   module Introspection

data/lib/graphql/introspection/type_kind_enum.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class TypeKindEnum < GraphQL::Schema::Enum

data/lib/graphql/introspection/type_type.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     class TypeType < Introspection::BaseObject

data/lib/graphql/introspection.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Introspection
     def self.query(include_deprecated_args: false, include_schema_description: false, include_is_repeatable: false, include_specified_by_url: false, include_is_one_of: false)

data/lib/graphql/invalid_name_error.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   class InvalidNameError < GraphQL::Error
     attr_reader :name, :valid_regex

data/lib/graphql/invalid_null_error.rb

@@ -1,27 +1,39 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   # Raised automatically when a field's resolve function returns `nil`
   # for a non-null field.
   class InvalidNullError < GraphQL::RuntimeError
-    # @return [GraphQL::BaseType] The owner of {#field}
+    # **Returns**
+    #
+    # - `GraphQL::BaseType` — The owner of [field](rdoc-ref:#field)
     attr_reader :parent_type
 
-    # @return [GraphQL::Field] The field which failed to return a value
+    # **Returns**
+    #
+    # - `GraphQL::Field` — The field which failed to return a value
     attr_reader :field
 
-    # @return [GraphQL::Language::Nodes::Field] the field where the error occurred
+    # **Returns**
+    #
+    # - `GraphQL::Language::Nodes::Field` — the field where the error occurred
+    #
+    # :call-seq:
+    #   ast_node() -> GraphQL::Language::Nodes::Field
     def ast_node
       @ast_nodes.first
     end
 
     attr_reader :ast_nodes
 
-    # @return [Boolean] indicates an array result caused the error
+    # **Returns**
+    #
+    # - `Boolean` — indicates an array result caused the error
     attr_reader :is_from_array
 
     attr_accessor :path
 
-    def initialize(parent_type, field, ast_node_or_nodes, is_from_array: false, path: nil)
+    def initialize(parent_type, field, ast_node_or_nodes, is_from_array: false, path: nil, element_type: nil)
       @parent_type = parent_type
       @field = field
       @ast_nodes = Array(ast_node_or_nodes)
@@ -32,7 +44,8 @@ module GraphQL
       # whether it was caused by a null instead of the list or a
       # null element.
       if @is_from_array
-        super("Cannot return null for non-nullable element of type '#{@field.type.of_type.of_type.to_type_signature}' for #{@parent_type.graphql_name}.#{@field.graphql_name}")
+        element_type ||= @field.type.of_type.of_type
+        super("Cannot return null for non-nullable element of type '#{element_type.to_type_signature}' for #{@parent_type.graphql_name}.#{@field.graphql_name}")
       else
         super("Cannot return null for non-nullable field #{@parent_type.graphql_name}.#{@field.graphql_name}")
       end

data/lib/graphql/language/block_string.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Language
     module BlockString
@@ -13,7 +14,7 @@ module GraphQL
         end
 
         lines = has_newline ? str.split("\n") : [str]
-        common_indent = nil
+        common_indent = nil #: Integer?
 
         # find the common whitespace
         lines.each_with_index do |line, idx|

data/lib/graphql/language/cache.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 
 require 'graphql/version'
 require 'digest/sha2'
@@ -8,7 +9,7 @@ require 'tempfile'
 
 module GraphQL
   module Language
-    # This cache is used by {GraphQL::Language::Parser.parse_file} when it's enabled.
+    # This cache is used by [GraphQL::Language::Parser.parse_file](rdoc-ref:GraphQL::Language::Parser.parse_file) when it's enabled.
     #
     # With Rails, parser caching may enabled by setting `config.graphql.parser_cache = true` in your Rails application.
     #
@@ -23,11 +24,16 @@ module GraphQL
     # You will need to clear the cache directory for each new deployment of your application.
     # Also note that the parser cache will grow as your schema is loaded, so the cache directory must be writable.
     #
-    # @see GraphQL::Railtie for simple Rails integration
+    # See [GraphQL::Railtie](rdoc-ref:GraphQL::Railtie) for simple Rails integration
     class Cache
-      # @param path [Pathname] The directory where cache entries are stored.
-      # @param secret [String, nil] A stable secret for verifying cache entries. When omitted,
+      # **Parameters**
+      #
+      # - `path` (`Pathname`) — The directory where cache entries are stored.
+      # - `secret` (`String, nil`) — A stable secret for verifying cache entries. When omitted,
       #   a process-local secret is generated. Pass `nil` to disable cache signing.
+      #
+      # :call-seq:
+      #   initialize(Pathname path, String | nil secret:)
       def initialize(path, secret: SecureRandom.random_bytes(32))
         @path = path
         @secret = secret

data/lib/graphql/language/comment.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Language
     module Comment

data/lib/graphql/language/definition_slice.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Language
     module DefinitionSlice

data/lib/graphql/language/document_from_schema_definition.rb

@@ -1,18 +1,17 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Language
-    # @api private
     #
-    # {GraphQL::Language::DocumentFromSchemaDefinition} is used to convert a {GraphQL::Schema} object
-    # To a {GraphQL::Language::Document} AST node.
+    # **Parameters**
     #
-    # @param context [Hash]
-    # @param only [<#call(member, ctx)>]
-    # @param except [<#call(member, ctx)>]
-    # @param include_introspection_types [Boolean] Whether or not to include introspection types in the AST
-    # @param include_built_in_scalars [Boolean] Whether or not to include built in scalars in the AST
-    # @param include_built_in_directives [Boolean] Whether or not to include built in directives in the AST
-    class DocumentFromSchemaDefinition
+    # - `context` (`Hash`)
+    # - `only` (`<#call(member, ctx)>`)
+    # - `except` (`<#call(member, ctx)>`)
+    # - `include_introspection_types` (`Boolean`) — Whether or not to include introspection types in the AST
+    # - `include_built_in_scalars` (`Boolean`) — Whether or not to include built in scalars in the AST
+    # - `include_built_in_directives` (`Boolean`) — Whether or not to include built in directives in the AST
+    class DocumentFromSchemaDefinition # :nodoc:
       def initialize(
         schema, context: nil, include_introspection_types: false,
         include_built_in_directives: false, include_built_in_scalars: false, always_include_schema: false

data/lib/graphql/language/generation.rb

@@ -1,21 +1,35 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Language
-    # Exposes {.generate}, which turns AST nodes back into query strings.
+    # Exposes [.generate](rdoc-ref:.generate), which turns AST nodes back into query strings.
     module Generation
       extend self
 
       # Turn an AST node back into a string.
       #
-      # @example Turning a document into a query
-      #    document = GraphQL.parse(query_string)
-      #    GraphQL::Language::Generation.generate(document)
-      #    # => "{ ... }"
+      # **Examples**
       #
-      # @param node [GraphQL::Language::Nodes::AbstractNode] an AST node to recursively stringify
-      # @param indent [String] Whitespace to add to each printed node
-      # @param printer [GraphQL::Language::Printer] An optional custom printer for printing AST nodes. Defaults to GraphQL::Language::Printer
-      # @return [String] Valid GraphQL for `node`
+      # **Example: Turning a document into a query**
+      #
+      # ```ruby
+      # document = GraphQL.parse(query_string)
+      # GraphQL::Language::Generation.generate(document)
+      # # => "{ ... }"
+      # ```
+      #
+      # **Parameters**
+      #
+      # - `node` (`GraphQL::Language::Nodes::AbstractNode`) — an AST node to recursively stringify
+      # - `indent` (`String`) — Whitespace to add to each printed node
+      # - `printer` (`GraphQL::Language::Printer`) — An optional custom printer for printing AST nodes. Defaults to GraphQL::Language::Printer
+      #
+      # **Returns**
+      #
+      # - `String` — Valid GraphQL for `node`
+      #
+      # :call-seq:
+      #   generate(GraphQL::Language::Nodes::AbstractNode node, String indent:, GraphQL::Language::Printer printer:) -> String
       def generate(node, indent: "", printer: GraphQL::Language::Printer.new)
         printer.print(node, indent: indent)
       end

data/lib/graphql/language/lexer.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
+# typed: true
 module GraphQL
   module Language
 
@@ -9,6 +10,9 @@ module GraphQL
         end
         @string = graphql_str
         @filename = filename
+        if !@string.valid_encoding?
+          raise_parse_error("Parse error on bad Unicode escape sequence", nil, nil)
+        end
         @scanner = StringScanner.new(graphql_str)
         @pos = nil
         @max_tokens = max_tokens || Float::INFINITY
@@ -32,6 +36,10 @@ module GraphQL
           @scanner.skip(IGNORE_REGEXP)
           if @scanner.skip(COMMENT_REGEXP)
             @tokens_count += 1
+            if @tokens_count > @max_tokens
+              @pos = @scanner.pos
+              raise_parse_error("This query is too large to execute.")
+            end
             next
           end
           break
@@ -110,10 +118,6 @@ module GraphQL
           @scanner.pos += 1
           :UNKNOWN_CHAR
         end
-      rescue ArgumentError => err
-        if err.message == "invalid byte sequence in UTF-8"
-          raise_parse_error("Parse error on bad Unicode escape sequence", nil, nil)
-        end
       end
 
       def token_value
@@ -147,7 +151,7 @@ module GraphQL
         "\\r" => "\r",
         "\\t" => "\t",
       }
-      UTF_8 = /\\u(?:([\dAa-f]{4})|\{([\da-f]{4,})\})(?:\\u([\dAa-f]{4}))?/i
+      UTF_8 = /\\u(?:([\da-f]{4})|\{([\da-f]+)\})(?:\\u([\da-f]{4}))?/i
       VALID_STRING = /\A(?:[^\\]|#{ESCAPES}|#{UTF_8})*\z/o
       ESCAPED = /(?:#{ESCAPES}|#{UTF_8})/o
 
@@ -163,7 +167,11 @@ module GraphQL
           if !str.valid_encoding? || !str.match?(VALID_STRING)
             raise_parse_error("Bad unicode escape in #{str.inspect}")
           else
-            Lexer.replace_escaped_characters_in_place(str)
+            begin
+              Lexer.replace_escaped_characters_in_place(str)
+            rescue RangeError
+              raise_parse_error("Bad unicode escape in #{str.inspect}")
+            end
 
             if !str.valid_encoding?
               raise_parse_error("Bad unicode escape in #{str.inspect}")
@@ -189,7 +197,7 @@ module GraphQL
         raise GraphQL::ParseError.new(message, line, col, @string, filename: @filename)
       end
 
-      IGNORE_REGEXP = /[, \c\r\n\t]+/
+      IGNORE_REGEXP = /[, \r\n\t\uFEFF]+/
       COMMENT_REGEXP = /\#[^\n]*/
       IDENTIFIER_REGEXP = /[_A-Za-z][_0-9A-Za-z]*/
       INT_REGEXP =        /-?(?:[0]|[1-9][0-9]*)/
@@ -289,7 +297,7 @@ module GraphQL
       QUOTE =         '"'
       UNICODE_DIGIT = /[0-9A-Za-z]/
       FOUR_DIGIT_UNICODE = /#{UNICODE_DIGIT}{4}/
-      N_DIGIT_UNICODE = %r{#{Punctuation::LCURLY}#{UNICODE_DIGIT}{4,}#{Punctuation::RCURLY}}x
+      N_DIGIT_UNICODE = %r{#{Punctuation::LCURLY}#{UNICODE_DIGIT}+#{Punctuation::RCURLY}}x
       UNICODE_ESCAPE = %r{\\u(?:#{FOUR_DIGIT_UNICODE}|#{N_DIGIT_UNICODE})}
       STRING_ESCAPE = %r{[\\][\\/bfnrt]}
       BLOCK_QUOTE =   '"""'