elasticgraph-schema_definition 0.19.1.0 → 0.19.2.0

data/lib/elastic_graph/schema_definition/mixins/has_subtypes.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/mixins/has_type_info.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/mixins/implements_interfaces.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/mixins/supports_default_value.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/mixins/supports_filtering_and_aggregation.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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
@@ -45,7 +45,8 @@ module ElasticGraph
             [type] + schema_def_state.factory.build_relay_pagination_types(type.name, support_pagination: false) do |t|
               # Record metadata that is necessary for elasticgraph-graphql to correctly recognize and handle
               # this sub-aggregation correctly.
-              t.runtime_metadata_overrides = {elasticgraph_category: :nested_sub_aggregation_connection}
+              t.override_runtime_metadata(elasticgraph_category: :nested_sub_aggregation_connection)
+              t.default_graphql_resolver = :object_without_lookahead
             end
           end
 
@@ -116,6 +117,7 @@ module ElasticGraph
             schema_def_state.sub_aggregation_paths_for(nested_field_ref.parent_type).map do |path|
               schema_def_state.factory.new_object_type type_ref.as_sub_aggregation(parent_doc_types: path.parent_doc_types).name do |t|
                 t.documentation "Return type representing a bucket of `#{name}` objects for a sub-aggregation within each `#{type_ref.as_parent_aggregation(parent_doc_types: path.parent_doc_types).name}`."
+                t.default_graphql_resolver = :object_without_lookahead
 
                 t.field schema_def_state.schema_elements.count_detail, "AggregationCountDetail", graphql_only: true do |f|
                   f.documentation "Details of the count of `#{name}` documents in a sub-aggregation bucket."
@@ -163,6 +165,7 @@ module ElasticGraph
             schema_def_state.factory.new_object_type agg_sub_aggs_type_ref.name do |t|
               under_field_description = "under `#{path.field_path_string}` " unless path.field_path.empty?
               t.documentation "Provides access to the `#{schema_def_state.schema_elements.sub_aggregations}` #{under_field_description}within each `#{type_ref.as_parent_aggregation(parent_doc_types: path.parent_doc_types).name}`."
+              t.default_graphql_resolver = :object_with_lookahead
 
               sub_aggregatable_fields.each do |field|
                 if field.nested?
@@ -225,7 +228,8 @@ module ElasticGraph
 
             # Record metadata that is necessary for elasticgraph-graphql to correctly recognize and handle
             # this indexed aggregation type correctly.
-            t.runtime_metadata_overrides = {source_type: name, elasticgraph_category: :indexed_aggregation}
+            t.default_graphql_resolver = :object_without_lookahead
+            t.override_runtime_metadata(source_type: name, elasticgraph_category: :indexed_aggregation)
           end
         end
 
@@ -236,6 +240,7 @@ module ElasticGraph
 
           new_non_empty_object_type type_ref.as_grouped_by.name do |t|
             t.documentation "Type used to specify the `#{name}` fields to group by for aggregations."
+            t.default_graphql_resolver = :object_with_lookahead
 
             graphql_fields_by_name.values.each do |field|
               field.define_grouped_by_field(t)
@@ -250,6 +255,7 @@ module ElasticGraph
 
           new_non_empty_object_type type_ref.as_aggregated_values.name do |t|
             t.documentation "Type used to perform aggregation computations on `#{name}` fields."
+            t.default_graphql_resolver = :object_with_lookahead
 
             graphql_fields_by_name.values.each do |field|
               field.define_aggregated_values_field(t)

data/lib/elastic_graph/schema_definition/mixins/verifies_graphql_name.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/rake_tasks.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/results.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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
@@ -110,6 +110,64 @@ module ElasticGraph
         # Record that we are now generating results so that caching can kick in.
         state.user_definition_complete = true
         state.user_definition_complete_callbacks.each(&:call)
+        define_root_graphql_type
+      end
+
+      def define_root_graphql_type
+        state.api.object_type "Query" do |query_type|
+          query_type.documentation "The query entry point for the entire schema."
+          query_type.default_graphql_resolver = nil
+
+          state.types_by_name.values.select(&:indexed?).sort_by(&:name).each do |type|
+            # @type var indexed_type: Mixins::HasIndices & _Type
+            indexed_type = _ = type
+
+            query_type.relates_to_many(
+              indexed_type.plural_root_query_field_name,
+              indexed_type.name,
+              via: "ignore",
+              dir: :in,
+              singular: indexed_type.singular_root_query_field_name
+            ) do |f|
+              f.documentation "Fetches `#{indexed_type.name}`s based on the provided arguments."
+              f.resolver = :list_records
+              f.hide_relationship_runtime_metadata = true
+              indexed_type.root_query_fields_customizations&.call(f)
+            end
+
+            # Add additional efficiency hints to the aggregation field documentation if we have any such hints.
+            # This needs to be outside the `relates_to_many` block because `relates_to_many` adds its own "suffix" to
+            # the field documentation, and here we add another one.
+            if (agg_efficiency_hint = aggregation_efficiency_hints_for(indexed_type.derived_indexed_types))
+              agg_name = state.schema_elements.normalize_case("#{indexed_type.singular_root_query_field_name}_aggregations")
+              agg_field = query_type.graphql_fields_by_name.fetch(agg_name)
+              agg_field.documentation "#{agg_field.doc_comment}\n\n#{agg_efficiency_hint}"
+            end
+          end
+
+          state.built_in_types_customization_blocks.each do |customization_block|
+            customization_block.call(query_type)
+          end
+        end
+      end
+
+      def aggregation_efficiency_hints_for(derived_indexed_types)
+        return nil if derived_indexed_types.empty?
+
+        hints = derived_indexed_types.map do |type|
+          derived_indexing_type = state.types_by_name.fetch(type.destination_type_ref.name)
+          alternate_field_name = (_ = derived_indexing_type).plural_root_query_field_name
+          grouping_field = type.id_source
+
+          "  - The root `#{alternate_field_name}` field groups by `#{grouping_field}`"
+        end
+
+        <<~EOS
+          Note: aggregation queries are relatively expensive, and some fields have been pre-aggregated to allow
+          more efficient queries for some common aggregation cases:
+
+          #{hints.join("\n")}
+        EOS
       end
 
       def json_schema_with_metadata_merger
@@ -144,7 +202,7 @@ module ElasticGraph
       def build_runtime_metadata
         extra_update_targets_by_object_type_name = identify_extra_update_targets_by_object_type_name
 
-        object_types_by_name = all_types_except_root_query_type
+        object_types_by_name = all_types
           .select { |t| t.respond_to?(:graphql_fields_by_name) }
           .to_h { |type| [type.name, (_ = type).runtime_metadata(extra_update_targets_by_object_type_name.fetch(type.name) { [] })] }
 
@@ -157,7 +215,7 @@ module ElasticGraph
           .filter_map { |type| enum_generator.sort_order_enum_for(_ = type) }
           .to_h { |enum_type| [(_ = enum_type).name, (_ = enum_type).runtime_metadata] }
 
-        enum_types_by_name = all_types_except_root_query_type
+        enum_types_by_name = all_types
           .grep(SchemaElements::EnumType) # : ::Array[SchemaElements::EnumType]
           .to_h { |t| [t.name, t.runtime_metadata] }
           .merge(indexed_enum_types_by_name)
@@ -173,8 +231,9 @@ module ElasticGraph
           index_definitions_by_name: index_definitions_by_name,
           schema_element_names: state.schema_elements,
           graphql_extension_modules: state.graphql_extension_modules,
+          graphql_resolvers_by_name: state.graphql_resolvers_by_name,
           static_script_ids_by_scoped_name: STATIC_SCRIPT_REPO.script_ids_by_scoped_name
-        )
+        ).tap { |rm| verify_runtime_metadata(rm) }
       end
 
       # Builds a map, keyed by object type name, of extra `update_targets` that have been generated
@@ -183,7 +242,9 @@ module ElasticGraph
         sourced_field_errors = [] # : ::Array[::String]
         relationship_errors = [] # : ::Array[::String]
 
-        state.object_types_by_name.values.each_with_object(::Hash.new { |h, k| h[k] = [] }) do |object_type, accum|
+        state.object_types_by_name.except("Query").values.each_with_object(
+          ::Hash.new { |h, k| h[k] = [] } # : ::Hash[untyped, ::Array[SchemaArtifacts::RuntimeMetadata::UpdateTarget]]
+        ) do |object_type, accum|
           fields_with_sources_by_relationship_name =
             if object_type.indices.empty?
               # only indexed types can have `sourced_from` fields, and resolving `fields_with_sources` on an unindexed union type
@@ -251,7 +312,7 @@ module ElasticGraph
         state.object_types_by_name.values.each(&:verify_graphql_correctness!)
 
         type_defs = state.factory
-          .new_graphql_sdl_enumerator(all_types_except_root_query_type)
+          .new_graphql_sdl_enumerator(all_types)
           .map { |sdl| strip_trailing_whitespace(sdl) }
 
         [type_defs + state.sdl_parts].join("\n\n")
@@ -283,7 +344,9 @@ module ElasticGraph
 
       def json_schema_indexing_field_types_by_name
         @json_schema_indexing_field_types_by_name ||= state
-          .types_by_name.values
+          .types_by_name
+          .except("Query")
+          .values
           .reject do |t|
             derived_indexing_type_names.include?(t.name) ||
               # Skip graphql framework types
@@ -293,6 +356,54 @@ module ElasticGraph
           .to_h { |type| [type.name, type.to_indexing_field_type] }
       end
 
+      def verify_runtime_metadata(runtime_metadata)
+        registered_resolvers = runtime_metadata.graphql_resolvers_by_name
+
+        fields_by_resolvers = ::Hash.new { |h, k| h[k] = [] } # : ::Hash[::Symbol, ::Array[::String]]
+        runtime_metadata
+          .object_types_by_name
+          .each do |type_name, type|
+            type.graphql_fields_by_name.each do |field_name, field|
+              if (resolver = field.resolver)
+                fields_by_resolvers[resolver] << "#{type_name}.#{field_name}"
+              end
+            end
+          end
+
+        unused_resolvers = registered_resolvers.except(*fields_by_resolvers.keys).reject do |name, res|
+          # Ignore our built-in resolvers.
+          res.resolver_ref.fetch("require_path").start_with?("elastic_graph/graphql/resolvers/")
+        end.keys
+
+        unless unused_resolvers.empty?
+          state.output.puts <<~EOS
+            WARNING: #{unused_resolvers.size} GraphQL resolver(s) have been registered but are unused:
+              - #{unused_resolvers.sort.join("\n  - ")}
+            These resolvers can be removed.
+          EOS
+        end
+
+        undefined_resolvers = fields_by_resolvers.except(*registered_resolvers.keys)
+        unless undefined_resolvers.empty?
+          resolver_errors = undefined_resolvers.sort_by(&:first).map do |resolver, fields|
+            <<~EOS.strip
+              GraphQL resolver `#{resolver.inspect}` is unregistered but is assigned to #{fields.size} field(s):
+
+                - #{fields.sort.join("\n  - ")}
+            EOS
+          end
+
+          raise Errors::SchemaError, <<~EOS
+            #{resolver_errors.join("\n\n")}
+
+            To continue, register the named resolvers with `schema.register_graphql_resolver`
+            or update the fields listed above to use one of the other registered resolvers:
+
+              - #{registered_resolvers.keys.map(&:inspect).sort.join("\n  - ")}
+          EOS
+        end
+      end
+
       def strip_trailing_whitespace(string)
         string.gsub(/ +$/, "")
       end
@@ -300,14 +411,17 @@ module ElasticGraph
       def check_for_circular_dependencies!
         return if @no_circular_dependencies
 
-        referenced_types_by_source_type = state.types_by_name
+        referenced_types_by_source_type = ::Hash.new { |h, k| h[k] = ::Set.new } # : ::Hash[::String, ::Set[::String]]
+        state.types_by_name
           .reject { |_, type| type.graphql_only? }
-          .each_with_object(::Hash.new { |h, k| h[k] = ::Set.new }) do |(type_name, _), cache|
-            recursively_add_referenced_types_to(state.type_ref(type_name), cache)
+          .each do |type_name, _|
+            recursively_add_referenced_types_to(state.type_ref(type_name), referenced_types_by_source_type)
           end
 
         circular_reference_sets = referenced_types_by_source_type
+          # standard:disable Style/HashSlice -- https://github.com/rubocop/rubocop/issues/13885
           .select { |source_type, referenced_types| referenced_types.include?(source_type) }
+          # standard:enable Style/HashSlice
           .values
           .uniq
 
@@ -341,9 +455,15 @@ module ElasticGraph
         end
       end
 
-      def all_types_except_root_query_type
-        @all_types_except_root_query_type ||= state.types_by_name.values.flat_map do |registered_type|
-          related_types = [registered_type] + registered_type.derived_graphql_types
+      def all_types
+        @all_types ||= state.types_by_name.values.flat_map do |registered_type|
+          related_types =
+            if registered_type.name == "Query"
+              [registered_type]
+            else
+              [registered_type] + registered_type.derived_graphql_types
+            end
+
           apply_customizations_to(related_types, registered_type)
           related_types
         end

data/lib/elastic_graph/schema_definition/schema_artifact_manager.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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
@@ -178,9 +178,9 @@ module ElasticGraph
       end
 
       def report_json_schema_merge_errors(merged_results)
-        json_schema_versions_by_missing_field = ::Hash.new { |h, k| h[k] = [] }
-        json_schema_versions_by_missing_type = ::Hash.new { |h, k| h[k] = [] }
-        json_schema_versions_by_missing_necessary_field = ::Hash.new { |h, k| h[k] = [] }
+        json_schema_versions_by_missing_field = ::Hash.new { |h, k| h[k] = [] } # : ::Hash[::String, ::Array[::Integer]]
+        json_schema_versions_by_missing_type = ::Hash.new { |h, k| h[k] = [] } # : ::Hash[::String, ::Array[::Integer]]
+        json_schema_versions_by_missing_necessary_field = ::Hash.new { |h, k| h[k] = [] } # : ::Hash[Indexing::JSONSchemaWithMetadata::MissingNecessaryField, ::Array[::Integer]]
 
         merged_results.each do |result|
           result.missing_fields.each do |field|

data/lib/elastic_graph/schema_definition/schema_elements/argument.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/built_in_types.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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
@@ -181,6 +181,7 @@ module ElasticGraph
           register_enum_types
           register_date_and_time_grouped_by_types
           register_standard_elastic_graph_types
+          register_standard_graphql_resolvers
         end
 
         private
@@ -281,11 +282,11 @@ module ElasticGraph
               f.default false
             end
 
-            # any_of/not don't really make sense on this filter because it doesn't make sense to
-            # apply an OR operator or negation to the fields of this type since they are all an
+            # any_of/all_of/not don't really make sense on this filter because it doesn't make sense
+            # to apply an OR operator or negation to the fields of this type since they are all an
             # indivisible part of a single filter operation on a specific field. So we remove them
             # here.
-            remove_any_of_and_not_filter_operators_on(t)
+            remove_any_of_and_all_of_and_not_filter_operators_on(t)
           end
 
           register_filter "MatchesPhrase" do |t|
@@ -299,11 +300,11 @@ module ElasticGraph
               f.documentation "The input phrase to search for."
             end
 
-            # any_of/not don't really make sense on this filter because it doesn't make sense to
-            # apply an OR operator or negation to the fields of this type since they are all an
+            # any_of/all_of/not don't really make sense on this filter because it doesn't make
+            # to apply an OR operator or negation to the fields of this type since they are all an
             # indivisible part of a single filter operation on a specific field. So we remove them
             # here.
-            remove_any_of_and_not_filter_operators_on(t)
+            remove_any_of_and_all_of_and_not_filter_operators_on(t)
           end
 
           # This is defined as a built-in ElasticGraph type so that we can leverage Elasticsearch/OpenSearch GeoLocation features
@@ -371,11 +372,11 @@ module ElasticGraph
               f.documentation "Determines the unit of the specified `#{names.max_distance}`."
             end
 
-            # any_of/not don't really make sense on this filter because it doesn't make sense to
-            # apply an OR operator or negation to the fields of this type since they are all an
+            # any_of/all_of/not don't really make sense on this filter because it doesn't make sense
+            # to apply an OR operator or negation to the fields of this type since they are all an
             # indivisible part of a single filter operation on a specific field. So we remove them
             # here.
-            remove_any_of_and_not_filter_operators_on(t)
+            remove_any_of_and_all_of_and_not_filter_operators_on(t)
           end
 
           # Note: `has_next_page`/`has_previous_page` are required to be non-null by the relay
@@ -393,6 +394,8 @@ module ElasticGraph
           # to go from non-null to null, but is not a breaking change to make it non-null
           # in the future.
           register_framework_object_type "PageInfo" do |t|
+            t.default_graphql_resolver = :object_without_lookahead
+
             t.documentation <<~EOS
               Provides information about the specific fetched page. This implements the `PageInfo`
               specification from the [Relay GraphQL Cursor Connections
@@ -509,6 +512,7 @@ module ElasticGraph
 
           register_framework_object_type "AggregationCountDetail" do |t|
             t.documentation "Provides detail about an aggregation `#{names.count}`."
+            t.default_graphql_resolver = :object_without_lookahead
 
             t.field names.approximate_value, "JsonSafeLong!", graphql_only: true do |f|
               f.documentation <<~EOS
@@ -728,11 +732,11 @@ module ElasticGraph
                 f.default "UTC"
               end
 
-              # With our initial implementation of `time_of_day` filtering, it's tricky to support `any_of`/`not` within
+              # With our initial implementation of `time_of_day` filtering, it's tricky to support `any_of`/`all_of`/`not` within
               # the `time_of_day: {...}` input object. They are still supported outside of `time_of_day` (on the parent
               # input object) so no functionality is losts by omitting these. Also, this aligns with our `GeoLocationDistanceFilterInput`
               # which is a similarly complex filter where we didn't include them.
-              remove_any_of_and_not_filter_operators_on(t)
+              remove_any_of_and_all_of_and_not_filter_operators_on(t)
             end
           end
 
@@ -1290,7 +1294,8 @@ module ElasticGraph
           date = schema_def_state.type_ref("Date")
           register_framework_object_type date.as_grouped_by.name do |t|
             t.documentation "Allows for grouping `Date` values based on the desired return type."
-            t.runtime_metadata_overrides = {elasticgraph_category: :date_grouped_by_object}
+            t.default_graphql_resolver = :object_with_lookahead
+            t.override_runtime_metadata(elasticgraph_category: :date_grouped_by_object)
 
             t.field names.as_date, "Date", graphql_only: true do |f|
               f.documentation "Used when grouping on the full `Date` value."
@@ -1307,7 +1312,8 @@ module ElasticGraph
           date_time = schema_def_state.type_ref("DateTime")
           register_framework_object_type date_time.as_grouped_by.name do |t|
             t.documentation "Allows for grouping `DateTime` values based on the desired return type."
-            t.runtime_metadata_overrides = {elasticgraph_category: :date_grouped_by_object}
+            t.default_graphql_resolver = :object_with_lookahead
+            t.override_runtime_metadata(elasticgraph_category: :date_grouped_by_object)
 
             t.field names.as_date_time, "DateTime", graphql_only: true do |f|
               f.documentation "Used when grouping on the full `DateTime` value."
@@ -1363,6 +1369,31 @@ module ElasticGraph
           end
         end
 
+        def register_standard_graphql_resolvers
+          require(require_path = "elastic_graph/graphql/resolvers/get_record_field_value")
+          schema_def_api.register_graphql_resolver :get_record_field_value,
+            GraphQL::Resolvers::GetRecordFieldValue,
+            defined_at: require_path
+
+          require(require_path = "elastic_graph/graphql/resolvers/list_records")
+          schema_def_api.register_graphql_resolver :list_records,
+            GraphQL::Resolvers::ListRecords,
+            defined_at: require_path
+
+          require(require_path = "elastic_graph/graphql/resolvers/nested_relationships")
+          schema_def_api.register_graphql_resolver :nested_relationships,
+            GraphQL::Resolvers::NestedRelationships,
+            defined_at: require_path
+
+          require(require_path = "elastic_graph/graphql/resolvers/object")
+          schema_def_api.register_graphql_resolver :object_with_lookahead,
+            GraphQL::Resolvers::Object::WithLookahead,
+            defined_at: require_path
+          schema_def_api.register_graphql_resolver :object_without_lookahead,
+            GraphQL::Resolvers::Object::WithoutLookahead,
+            defined_at: require_path
+        end
+
         def define_date_grouping_arguments(grouping_field, omit_timezone: false)
           define_calendar_type_grouping_arguments(grouping_field, schema_def_state.type_ref("Date"), <<~EOS, omit_timezone: omit_timezone)
             For example, when grouping by `WEEK`, you can shift by 1 day to change what day-of-week weeks are considered to start on.
@@ -1515,8 +1546,9 @@ module ElasticGraph
           schema_def_state.register_input_type(input_type)
         end
 
-        def remove_any_of_and_not_filter_operators_on(type)
+        def remove_any_of_and_all_of_and_not_filter_operators_on(type)
           type.graphql_fields_by_name.delete(names.any_of)
+          type.graphql_fields_by_name.delete(names.all_of)
           type.graphql_fields_by_name.delete(names.not)
         end
       end

data/lib/elastic_graph/schema_definition/schema_elements/deprecated_element.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/directive.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/enum_type.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/enum_value.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/enum_value_namer.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/enums_for_indexed_types.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/field.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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
@@ -92,7 +92,7 @@ module ElasticGraph
         :aggregated_values_customizations, :sort_order_enum_value_customizations,
         :args, :sortable, :filterable, :aggregatable, :groupable, :graphql_only, :source, :runtime_field_script, :relationship, :singular_name,
         :computation_detail, :non_nullable_in_json_schema, :backing_indexing_field, :as_input,
-        :legacy_grouping_schema, :name_in_index
+        :legacy_grouping_schema, :name_in_index, :resolver
       )
         include Mixins::HasDocumentation
         include Mixins::HasDirectives
@@ -103,10 +103,9 @@ module ElasticGraph
         def initialize(
           name:, type:, parent_type:, schema_def_state:,
           accuracy_confidence: :high, name_in_index: name,
-          runtime_metadata_graphql_field: SchemaArtifacts::RuntimeMetadata::GraphQLField::EMPTY,
           type_for_derived_types: nil, graphql_only: nil, singular: nil,
           sortable: nil, filterable: nil, aggregatable: nil, groupable: nil,
-          backing_indexing_field: nil, as_input: false, legacy_grouping_schema: false
+          backing_indexing_field: nil, as_input: false, legacy_grouping_schema: false, resolver: nil
         )
           type_ref = schema_def_state.type_ref(type)
           super(
@@ -137,10 +136,11 @@ module ElasticGraph
             non_nullable_in_json_schema: false,
             backing_indexing_field: backing_indexing_field,
             as_input: as_input,
-            legacy_grouping_schema: legacy_grouping_schema
+            legacy_grouping_schema: legacy_grouping_schema,
+            resolver: resolver
           )
 
-          if name != name_in_index && name_in_index&.include?(".") && !graphql_only
+          if name != name_in_index && name_in_index.include?(".") && !graphql_only
             raise Errors::SchemaError, "#{self} has an invalid `name_in_index`: #{name_in_index.inspect}. Only `graphql_only: true` fields can have a `name_in_index` that references a child field."
           end
 
@@ -735,9 +735,13 @@ module ElasticGraph
             .as_static_derived_type(filter_field_category(for_single_value))
             .name
 
-          params = to_h
-            .slice(*@@initialize_param_names)
-            .merge(type: filter_type, parent_type: parent_type, name_in_index: name_in_index, type_for_derived_types: nil)
+          params = to_h.slice(*@@initialize_param_names).merge(
+            type: filter_type,
+            parent_type: parent_type,
+            name_in_index: name_in_index,
+            type_for_derived_types: nil,
+            resolver: nil
+          )
 
           schema_def_state.factory.new_field(**params).tap do |f|
             f.documentation derived_documentation(
@@ -925,7 +929,8 @@ module ElasticGraph
           SchemaArtifacts::RuntimeMetadata::GraphQLField.new(
             name_in_index: name_in_index,
             computation_detail: computation_detail,
-            relation: relationship&.runtime_metadata
+            relation: relationship&.runtime_metadata,
+            resolver: resolver
           )
         end
 

data/lib/elastic_graph/schema_definition/schema_elements/field_path.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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

data/lib/elastic_graph/schema_definition/schema_elements/field_source.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 Block, Inc.
+# 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