elasticgraph-apollo 0.19.3.0 → 1.0.0.rc1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9dfc6d3665fbade9f03f4f45fe835c4ed77a136eedc26b0540ee35f2d7e9de49
-  data.tar.gz: 53356460e361d3c3438b2991f9455507cb7019228caafbffb5f577aa7245cf1f
+  metadata.gz: 60fe05fd8a1f0f1419414ab12d49ce2c6f83d3d51a65395a1c337daaf9686504
+  data.tar.gz: b69ab2f7e0a55ded216b2f21985cd5a61c0f85f98fda8d821618b493abc7a071
 SHA512:
-  metadata.gz: de7a3784bf12bd0bd880e144bbd3022208a1d2f07277700a9b64b67fbd10314b4cdf9daf974661fa478e0ceffead64f6b610db8212a0cb365a529135693b00a8
-  data.tar.gz: f2e5c81cb0b62c3d51e7c44ad7018e4d9b6b44b9c0b070297dd85c62836fc5b3cb70dd3f47a4612959f786c4837b3db61cbc4e0550a5b2ff6488b170542a9d91
+  metadata.gz: '07948b4764320e60d8b006b1191336f85cc8691849e7c8a9b208d4c347eeab1b5c626fc82d1be85a712742c6c1b471ed40b72e3d8f8d8be1593859f6d1cc4778'
+  data.tar.gz: ab665204ae619f74c6f19e2da52094cc1f06fc1c484b74f5286d1a554a765f3c9250eea0f911c1e30d792fc8ad3a4aedb919d699b52e20537400a183a20105d8

data/apollo_tests_implementation/config/products_schema.rb

@@ -48,14 +48,14 @@ module ApolloTestImpl
     schema.on_root_query_type do |type|
       type.field "product", "Product" do |f|
         f.argument "id", "ID!"
-        f.resolve_with :product
+        f.resolver = :product
       end
 
       type.field "deprecatedProduct", "DeprecatedProduct" do |f|
         f.argument "sku", "String!"
         f.argument "package", "String!"
         f.directive "deprecated", reason: "Use product query instead"
-        f.resolve_with :product
+        f.resolver = :product
       end
     end
 

data/apollo_tests_implementation/lib/product_resolver.rb

@@ -24,7 +24,7 @@ class ProductResolver
     query = @datastore_query_builder.new_query(
       search_index_definitions: [@product_index_def],
       monotonic_clock_deadline: context[:monotonic_clock_deadline],
-      filters: [{"id" => {"equalToAnyOf" => [args.fetch("id")]}}],
+      client_filters: [{"id" => {"equalToAnyOf" => [args.fetch("id")]}}],
       individual_docs_needed: true,
       request_all_fields: true
     )

data/lib/elastic_graph/apollo/graphql/entities_field_resolver.rb

@@ -166,7 +166,7 @@ module ElasticGraph
               query.merge_with(
                 document_pagination: {first: representations.length},
                 requested_fields: additional_requested_fields_for(representations),
-                filters: [filter]
+                internal_filters: [filter]
               )
             end
 
@@ -242,7 +242,7 @@ module ElasticGraph
               # In the case of representations which don't query Id, we ask for 2 documents so that
               # if something weird is going on and it matches more than 1, we can detect that and return an error.
               document_pagination: {first: 2},
-              filters: [build_filter_for_hash(fields)]
+              internal_filters: [build_filter_for_hash(fields)]
             )
           end
 

data/lib/elastic_graph/apollo/schema_definition/api_extension.rb

@@ -8,6 +8,7 @@
 
 require "elastic_graph/errors"
 require "elastic_graph/version"
+require "elastic_graph/apollo/graphql/engine_extension"
 require "elastic_graph/apollo/schema_definition/entity_type_extension"
 require "elastic_graph/apollo/schema_definition/factory_extension"
 require "elastic_graph/apollo/schema_definition/state_extension"
@@ -124,6 +125,7 @@ module ElasticGraph
             end
           end
 
+          api.register_graphql_extension GraphQL::EngineExtension, defined_at: "elastic_graph/apollo/graphql/engine_extension"
           api.state.after_user_definition_complete do
             api.send(:define_apollo_schema_elements)
           end
@@ -378,19 +380,11 @@ module ElasticGraph
             end
           end
 
-          require(require_path = "elastic_graph/apollo/graphql/engine_extension")
-          register_graphql_extension GraphQL::EngineExtension, defined_at: require_path
-
           require(require_path = "elastic_graph/apollo/graphql/entities_field_resolver")
           register_graphql_resolver :apollo_entities, GraphQL::EntitiesFieldResolver, defined_at: require_path
 
           require(require_path = "elastic_graph/apollo/graphql/service_field_resolver")
           register_graphql_resolver :apollo_service, GraphQL::ServiceFieldResolver, defined_at: require_path
-
-          require(require_path = "elastic_graph/apollo/graphql/apollo_entity_ref_resolver")
-          register_graphql_resolver :apollo_entity_ref, GraphQL::ApolloEntityRefResolver::ForSingleId, defined_at: require_path
-          register_graphql_resolver :apollo_entity_ref_list, GraphQL::ApolloEntityRefResolver::ForIdList, defined_at: require_path
-          register_graphql_resolver :apollo_entity_ref_paginated, GraphQL::ApolloEntityRefResolver::ForPaginatedList, defined_at: require_path
         end
 
         def apollo_object_type(name, &block)
@@ -493,7 +487,7 @@ module ElasticGraph
                 EOS
               end
 
-              f.resolve_with :apollo_entities
+              f.resolver = :apollo_entities
             end
           end
 
@@ -509,7 +503,7 @@ module ElasticGraph
               Not intended for use by clients other than Apollo.
             EOS
 
-            f.resolve_with :apollo_service
+            f.resolver = :apollo_service
           end
         end
       end

data/lib/elastic_graph/apollo/schema_definition/interface_type_extension.rb

@@ -7,7 +7,6 @@
 # frozen_string_literal: true
 
 require "elastic_graph/apollo/schema_definition/apollo_directives"
-require "elastic_graph/apollo/schema_definition/object_and_interface_extension"
 
 module ElasticGraph
   module Apollo
@@ -21,7 +20,6 @@ module ElasticGraph
         include ApolloDirectives::Policy
         include ApolloDirectives::RequiresScopes
         include ApolloDirectives::Tag
-        include ObjectAndInterfaceExtension
       end
     end
   end

data/lib/elastic_graph/apollo/schema_definition/object_type_extension.rb

@@ -7,7 +7,6 @@
 # frozen_string_literal: true
 
 require "elastic_graph/apollo/schema_definition/apollo_directives"
-require "elastic_graph/apollo/schema_definition/object_and_interface_extension"
 
 module ElasticGraph
   module Apollo
@@ -24,7 +23,6 @@ module ElasticGraph
         include ApolloDirectives::RequiresScopes
         include ApolloDirectives::Shareable
         include ApolloDirectives::Tag
-        include ObjectAndInterfaceExtension
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elasticgraph-apollo
 version: !ruby/object:Gem::Version
-  version: 0.19.3.0
+  version: 1.0.0.rc1
 platform: ruby
 authors:
 - Myron Marston
@@ -9,7 +9,7 @@ authors:
 - Block Engineering
 bindir: bin
 cert_chain: []
-date: 2025-06-20 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: elasticgraph-graphql
@@ -17,42 +17,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: elasticgraph-support
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: graphql
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.4
+        version: 2.5.6
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.5.4
+        version: 2.5.6
 - !ruby/object:Gem::Dependency
   name: apollo-federation
   requirement: !ruby/object:Gem::Requirement
@@ -79,70 +79,70 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: elasticgraph-admin
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: elasticgraph-elasticsearch
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: elasticgraph-opensearch
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
 - !ruby/object:Gem::Dependency
   name: elasticgraph-indexer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.3.0
+        version: 1.0.0.rc1
 email:
 - myron@squareup.com
 executables: []
@@ -160,7 +160,6 @@ files:
 - apollo_tests_implementation/docker-compose.yaml
 - apollo_tests_implementation/lib/product_resolver.rb
 - apollo_tests_implementation/wait_for_datastore.sh
-- lib/elastic_graph/apollo/graphql/apollo_entity_ref_resolver.rb
 - lib/elastic_graph/apollo/graphql/engine_extension.rb
 - lib/elastic_graph/apollo/graphql/entities_field_resolver.rb
 - lib/elastic_graph/apollo/graphql/http_endpoint_extension.rb
@@ -175,7 +174,6 @@ files:
 - lib/elastic_graph/apollo/schema_definition/field_extension.rb
 - lib/elastic_graph/apollo/schema_definition/input_type_extension.rb
 - lib/elastic_graph/apollo/schema_definition/interface_type_extension.rb
-- lib/elastic_graph/apollo/schema_definition/object_and_interface_extension.rb
 - lib/elastic_graph/apollo/schema_definition/object_type_extension.rb
 - lib/elastic_graph/apollo/schema_definition/scalar_type_extension.rb
 - lib/elastic_graph/apollo/schema_definition/state_extension.rb
@@ -188,10 +186,10 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/block/elasticgraph/issues
-  changelog_uri: https://github.com/block/elasticgraph/releases/tag/v0.19.3.0
-  documentation_uri: https://block.github.io/elasticgraph/api-docs/v0.19.3.0/
+  changelog_uri: https://github.com/block/elasticgraph/releases/tag/v1.0.0.rc1
+  documentation_uri: https://block.github.io/elasticgraph/api-docs/v1.0.0.rc1/
   homepage_uri: https://block.github.io/elasticgraph/
-  source_code_uri: https://github.com/block/elasticgraph/tree/v0.19.3.0/elasticgraph-apollo
+  source_code_uri: https://github.com/block/elasticgraph/tree/v1.0.0.rc1/elasticgraph-apollo
   gem_category: extension
 rdoc_options: []
 require_paths:
@@ -200,7 +198,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.4'
   - - "<"
     - !ruby/object:Gem::Version
       version: '3.5'
@@ -210,7 +208,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.2
+rubygems_version: 3.6.7
 specification_version: 4
 summary: An ElasticGraph extension that implements the Apollo federation spec.
 test_files: []

data/lib/elastic_graph/apollo/graphql/apollo_entity_ref_resolver.rb

@@ -1,72 +0,0 @@
-# Copyright 2024 - 2025 Block, Inc.
-#
-# Use of this source code is governed by an MIT-style
-# license that can be found in the LICENSE file or at
-# https://opensource.org/licenses/MIT.
-#
-# frozen_string_literal: true
-
-require "elastic_graph/graphql/resolvers/relay_connection/array_adapter"
-
-module ElasticGraph
-  module Apollo
-    module GraphQL
-      # Namespace for resolvers which provide Apollo entity references from ids.
-      #
-      # @private
-      module ApolloEntityRefResolver
-        # GraphQL resolver for fields defined with `apollo_entity_ref_field` that are backed by a single id.
-        #
-        # @private
-        class ForSingleId
-          def initialize(elasticgraph_graphql:, config:)
-            @source_id_field = config.fetch(:source_id_field)
-            @exposed_id_field = config.fetch(:exposed_id_field)
-          end
-
-          def resolve(field:, object:, args:, context:)
-            if (id = object.fetch(@source_id_field))
-              {@exposed_id_field => id}
-            end
-          end
-        end
-
-        # GraphQL resolver for fields defined with `apollo_entity_ref_field` that are backed by an list of ids.
-        #
-        # @private
-        class ForIdList
-          def initialize(elasticgraph_graphql:, config:)
-            @source_ids_field = config.fetch(:source_ids_field)
-            @exposed_id_field = config.fetch(:exposed_id_field)
-          end
-
-          def resolve(field:, object:, args:, context:)
-            object
-              .fetch(@source_ids_field)
-              .map { |id| {@exposed_id_field => id} }
-          end
-        end
-
-        # GraphQL resolver for paginated fields defined with `apollo_entity_ref_paginated_collection_field`.
-        #
-        # @private
-        class ForPaginatedList
-          def initialize(elasticgraph_graphql:, config:)
-            @for_id_list = ForIdList.new(elasticgraph_graphql:, config:)
-          end
-
-          def resolve(field:, object:, args:, context:)
-            array = @for_id_list.resolve(field:, object:, args:, context:)
-
-            ::ElasticGraph::GraphQL::Resolvers::RelayConnection::ArrayAdapter.build(
-              array,
-              args,
-              context.fetch(:elastic_graph_schema).element_names,
-              context
-            )
-          end
-        end
-      end
-    end
-  end
-end

data/lib/elastic_graph/apollo/schema_definition/object_and_interface_extension.rb

@@ -1,218 +0,0 @@
-# Copyright 2024 - 2025 Block, Inc.
-#
-# Use of this source code is governed by an MIT-style
-# license that can be found in the LICENSE file or at
-# https://opensource.org/licenses/MIT.
-#
-# frozen_string_literal: true
-
-require "elastic_graph/apollo/schema_definition/apollo_directives"
-
-module ElasticGraph
-  module Apollo
-    module SchemaDefinition
-      # Extends {ElasticGraph::SchemaDefinition::SchemaElements::ObjectType} and
-      # {ElasticGraph::SchemaDefinition::SchemaElements::InterfaceType} to offer some Apollo-specific APIs.
-      module ObjectAndInterfaceExtension
-        # Exposes an Apollo entity reference as a new field, backed by an `ID` field.
-        #
-        # When integrating an ElasticGraph project as a subgraph into a larger Apollo supergraph, it's useful to be able
-        # to reference entities owned by other subgraphs. The most straightforward way to do this is to define an
-        # _entity reference_ type (e.g. a type containing just the `@key` fields such as `id: ID` and marked as
-        # `resolvable: false` in the `@key` directive), and then define fields using that type. This approach works
-        # particularly well when you plan ahead and know which `ID` fields to model with entity reference types.
-        #
-        # However, on an existing schema where you've got some raw `ID` fields of external entities, it can be quite
-        # difficult to replace the `ID` fields with full-blown entity reference types, as doing so would require migrating
-        # clients and running a full backfill.
-        #
-        # This API provides an alternate solution for this situation: it defines a GraphQL-only field which returns an entity
-        # reference type using a custom GraphQL resolver.
-        #
-        # See the [Apollo docs on referencing an entity without contributing
-        # fields](https://www.apollographql.com/docs/graphos/schema-design/federated-schemas/entities/contribute-fields#referencing-an-entity-without-contributing-fields)
-        # for more information.
-        #
-        # @param name [String] Name of the field
-        # @param type [String] Name of the entity reference type (which must be defined separately)
-        # @param id_field_name_in_index [String] Name of the backing ID field in the datastore index
-        # @return [void]
-        # @note This can be used for either a singleton or list reference, based on if `type` is a list.
-        # @note The resulting field will be only be available for clients to request as a return field. It will not support filtering,
-        #   sorting, grouping, aggregated values, or highlights.
-        # @see #apollo_entity_ref_paginated_collection_field
-        #
-        # @example Expose `Review.product` and `Review.comments` entity reference fields
-        #   ElasticGraph.define_schema do |schema|
-        #     schema.object_type "Product" do |t|
-        #       t.field "id", "ID"
-        #       t.apollo_key fields: "id", resolvable: false
-        #     end
-        #
-        #     schema.object_type "Comment" do |t|
-        #       t.field "id", "ID"
-        #       t.apollo_key fields: "id", resolvable: false
-        #     end
-        #
-        #     schema.object_type "Review" do |t|
-        #       t.field "id", "ID"
-        #       t.field "score", "Int"
-        #
-        #       # Fields originally defined in the first version of the schema
-        #       t.field "productId", "ID"
-        #       t.field "commentIds", "[ID!]!"
-        #
-        #       # New field we're adding to expose the existing `productId` field as a `Product` entity reference.
-        #       t.apollo_entity_ref_field "product", "Product", id_field_name_in_index: "productId"
-        #
-        #       # New field we're adding to expose the existing `commentIds` field as a list of `Comment` entity references.
-        #       t.apollo_entity_ref_field "comments", "[Comment!]!", id_field_name_in_index: "commentIds"
-        #
-        #       t.index "reviews"
-        #     end
-        #   end
-        def apollo_entity_ref_field(name, type, id_field_name_in_index:)
-          field(
-            name,
-            type,
-            name_in_index: id_field_name_in_index,
-            **LIMITED_GRAPHQL_ONLY_FIELD_OPTIONS
-          ) do |f|
-            validate_entity_ref_options(__method__.to_s, f, id_field_name_in_index, type) do |exposed_id_field|
-              if f.type.list?
-                f.resolve_with :apollo_entity_ref_list, source_ids_field: id_field_name_in_index, exposed_id_field: exposed_id_field
-              else
-                f.resolve_with :apollo_entity_ref, source_id_field: id_field_name_in_index, exposed_id_field: exposed_id_field
-              end
-            end
-
-            yield f if block_given?
-          end
-        end
-
-        # Exposes a collection of Apollo entity references as a new paginated field, backed by an `ID` field.
-        #
-        # When integrating an ElasticGraph project as a subgraph into a larger Apollo supergraph, it's useful to be able
-        # to reference entities owned by other subgraphs. The most straightforward way to do this is to define an
-        # _entity reference_ type (e.g. a type containing just the `@key` fields such as `id: ID` and marked as
-        # `resolvable: false` in the `@key` directive), and then define fields using that type. This approach works
-        # particularly well when you plan ahead and know which `ID` fields to model with entity reference types.
-        #
-        # However, on an existing schema where you've got some raw `ID` fields of external entities, it can be quite
-        # difficult to replace the `ID` fields with full-blown entity reference types, as doing so would require migrating
-        # clients and running a full backfill.
-        #
-        # This API provides an alternate solution for this situation: it defines a GraphQL-only field which returns an entity
-        # reference type using a custom GraphQL resolver. In contrast to {#apollo_entity_ref_field}, this defines a field as
-        # a [paginated Relay connection](https://relay.dev/graphql/connections.htm) rather than a simple list.
-        #
-        # See the [Apollo docs on referencing an entity without contributing
-        # fields](https://www.apollographql.com/docs/graphos/schema-design/federated-schemas/entities/contribute-fields#referencing-an-entity-without-contributing-fields)
-        # for more information.
-        #
-        # @param name [String] Name of the field
-        # @param element_type [String] Name of the entity reference type (which must be defined separately)
-        # @param id_field_name_in_index [String] Name of the backing ID field in the datastore index
-        # @return [void]
-        # @note This requires `id_field_name_in_index` to be a list or paginated collection field.
-        # @note The resulting field will be only be available for clients to request as a return field. It will not support filtering,
-        #   sorting, grouping, aggregated values, or highlights.
-        # @see #apollo_entity_ref_field
-        # @see ElasticGraph::SchemaDefinition::SchemaElements::TypeWithSubfields#paginated_collection_field
-        #
-        # @example Expose `Review.product` and `Review.comments` entity reference fields
-        #   ElasticGraph.define_schema do |schema|
-        #     schema.object_type "Comment" do |t|
-        #       t.field "id", "ID"
-        #       t.apollo_key fields: "id", resolvable: false
-        #     end
-        #
-        #     schema.object_type "Review" do |t|
-        #       t.field "id", "ID"
-        #       t.field "score", "Int"
-        #
-        #       # Field originally defined in the first version of the schema
-        #       t.field "commentIds", "[ID!]!"
-        #
-        #       # New field we're adding to expose the existing `commentIds` field as a list of `Comment` entity references.
-        #       t.apollo_entity_ref_paginated_collection_field "comments", "Comment", id_field_name_in_index: "commentIds"
-        #
-        #       t.index "reviews"
-        #     end
-        #   end
-        def apollo_entity_ref_paginated_collection_field(name, element_type, id_field_name_in_index:)
-          paginated_collection_field(
-            name,
-            element_type,
-            name_in_index: id_field_name_in_index,
-            **LIMITED_GRAPHQL_ONLY_PAGINATED_FIELD_OPTIONS
-          ) do |f|
-            validate_entity_ref_options(__method__.to_s, f, id_field_name_in_index, element_type) do |exposed_id_field|
-              backing_indexing_field = f.backing_indexing_field # : ::ElasticGraph::SchemaDefinition::SchemaElements::Field
-              unless backing_indexing_field.type.list?
-                raise Errors::SchemaError, "`#{f.parent_type.name}.#{f.name}` is invalid: `id_field_name_in_index` must reference an " \
-                  "id collection field, but the type of `#{id_field_name_in_index}` is `#{backing_indexing_field.type.name}`."
-              end
-
-              f.resolve_with :apollo_entity_ref_paginated, source_ids_field: id_field_name_in_index, exposed_id_field: exposed_id_field
-
-              yield f if block_given?
-            end
-          end
-        end
-
-        private
-
-        # The set of options for a GraphQL-only field that has all abilities disabled. A field defined with these options
-        # is available to be returned, but cannot be used for anything else (filtering, grouping, sorting, etc.).
-        LIMITED_GRAPHQL_ONLY_FIELD_OPTIONS = {
-          graphql_only: true,
-          filterable: false,
-          groupable: false,
-          aggregatable: false,
-          sortable: false
-        }
-
-        # Like {LIMITED_GRAPHQL_ONLY_FIELD_OPTIONS} but for
-        # {ElasticGraph::SchemaDefinition::SchemaElements::TypeWithSubfields#paginated_collection_field}.
-        # It does not support the `sortable` option.
-        LIMITED_GRAPHQL_ONLY_PAGINATED_FIELD_OPTIONS = LIMITED_GRAPHQL_ONLY_FIELD_OPTIONS.except(:sortable)
-
-        def validate_entity_ref_options(method_name, field, id_field_name_in_index, entity_ref_type_name)
-          # Defer validation since it depends on the definition of the entity ref type, which may be as yet undefined.
-          schema_def_state.after_user_definition_complete do
-            backing_indexing_field = field.backing_indexing_field # : ::ElasticGraph::SchemaDefinition::SchemaElements::Field
-            backing_indexing_field_type = backing_indexing_field.type.fully_unwrapped.name
-
-            unless backing_indexing_field_type == "ID"
-              raise Errors::SchemaError, "`#{field.parent_type.name}.#{field.name}` is invalid: `id_field_name_in_index` must " \
-                "reference an `ID` field, but the type of `#{id_field_name_in_index}` is `#{backing_indexing_field_type}`."
-            end
-
-            entity_ref_type = schema_def_state.type_ref(entity_ref_type_name).fully_unwrapped.as_object_type
-            unless entity_ref_type
-              raise Errors::SchemaError, "`#{field.parent_type.name}.#{field.name}` is invalid: the referenced type " \
-                "(`#{entity_ref_type_name}`) is not an object type as required by `#{method_name}`."
-            end
-
-            entity_ref_type_fields = entity_ref_type.graphql_fields_by_name.keys
-
-            unless entity_ref_type_fields.size == 1
-              raise Errors::SchemaError, "`#{field.parent_type.name}.#{field.name}` is invalid: `#{method_name}` can only be used " \
-                "for types with a single field, but `#{entity_ref_type.name}` has #{entity_ref_type_fields.size} fields."
-            end
-
-            exposed_id_field = entity_ref_type_fields.first
-            exposed_id_field_type = entity_ref_type.graphql_fields_by_name.fetch(exposed_id_field).type
-            unless exposed_id_field_type.unwrap_non_null.name == "ID"
-              raise Errors::SchemaError, "`#{field.parent_type.name}.#{field.name}` is invalid: `#{method_name}` can only be used for " \
-                "types with a single `ID` field, but the type of `#{entity_ref_type.name}.#{exposed_id_field}` is `#{exposed_id_field_type.name}`."
-            end
-
-            yield exposed_id_field
-          end
-        end
-      end
-    end
-  end
-end