elasticgraph-schema_definition 0.19.2.2 → 0.19.3.1

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

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at
@@ -152,6 +152,15 @@ module ElasticGraph
       # GeoLocation
       # : Geographic coordinates representing a location on the Earth's surface.
       #
+      # GeoTile
+      # : A tile in the Web Mercator XYZ grid. Its coordinates identify a cell, not a fixed ground distance.
+      #
+      # GeoTileBounds
+      # : The geographic bounds of a Web Mercator XYZ tile. Tiles do not cross the antimeridian.
+      #
+      # GeoTileCorners
+      # : The geographic locations of the four corners of a Web Mercator XYZ tile.
+      #
       # PageInfo
       # : Provides information about the specific fetched page. This implements the
       #   `PageInfo` specification from the [Relay GraphQL Cursor Connections
@@ -180,6 +189,7 @@ module ElasticGraph
           register_custom_elastic_graph_scalars
           register_enum_types
           register_date_and_time_grouped_by_types
+          register_geo_grouped_by_types
           register_standard_elastic_graph_types
           register_standard_graphql_resolvers
         end
@@ -394,7 +404,7 @@ 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.resolve_fields_with :object_without_lookahead
 
             t.documentation <<~EOS
               Provides information about the specific fetched page. This implements the `PageInfo`
@@ -512,7 +522,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.resolve_fields_with :object_without_lookahead
 
             t.field names.approximate_value, "JsonSafeLong!", graphql_only: true do |f|
               f.documentation <<~EOS
@@ -1294,7 +1304,7 @@ 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.default_graphql_resolver = :object_with_lookahead
+            t.resolve_fields_with :object_with_lookahead
             t.override_runtime_metadata(elasticgraph_category: :date_grouped_by_object)
 
             t.field names.as_date, "Date", graphql_only: true do |f|
@@ -1312,7 +1322,7 @@ 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.default_graphql_resolver = :object_with_lookahead
+            t.resolve_fields_with :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|
@@ -1369,7 +1379,105 @@ module ElasticGraph
           end
         end
 
+        # Registers the geographic grouping operation and its tile, bounds, and corner output types.
+        def register_geo_grouped_by_types
+          register_framework_object_type schema_def_state.type_ref("GeoLocation").as_grouped_by.name do |t|
+            t.documentation "Offers geographic grouping representations for a location."
+            t.resolve_fields_with :object_with_lookahead
+            t.override_runtime_metadata(elasticgraph_category: :geo_location_grouped_by_object)
+
+            t.field names.as_geo_tile, "GeoTile", graphql_only: true do |f|
+              f.resolve_with :as_geo_tile
+
+              f.documentation <<~EOS
+                Groups locations into Web Mercator [XYZ tiles](https://wiki.openstreetmap.org/wiki/Slippy_map_tilenames). Missing locations produce a `null` tile.
+                Points beyond ±85.0511° latitude are grouped into the northernmost or southernmost row,
+                so a point can be outside the bounds of the tile it is grouped into.
+                Boundary points are assigned to the tile to the east or south, subject to datastore coordinate encoding.
+              EOS
+
+              f.argument names.zoom_level, "Int!" do |a|
+                a.documentation <<~EOS
+                  The Web Mercator zoom level, from #{GEO_TILE_ZOOM_LEVELS.min} through #{GEO_TILE_ZOOM_LEVELS.max}.
+                  At zoom level z, the map has 2^z rows and 2^z columns. Increasing the zoom level by 1
+                  doubles both, producing four times as many tiles.
+                EOS
+                a.default 7
+              end
+            end
+          end
+
+          register_framework_object_type "GeoTile" do |t|
+            t.documentation "A tile in the Web Mercator XYZ grid. Its coordinates identify a cell, not a fixed ground distance."
+            t.resolve_fields_with :object_without_lookahead
+
+            t.field names.zoom_level, "Int!", graphql_only: true do |f|
+              f.documentation "The zoom level of the tile, from #{GEO_TILE_ZOOM_LEVELS.min} through #{GEO_TILE_ZOOM_LEVELS.max}."
+            end
+
+            {names.x => "west to east", names.y => "north to south"}.each do |name, direction|
+              t.field name, "Int!", graphql_only: true do |f|
+                f.documentation "The zero-based tile coordinate, counted #{direction}, from 0 through 2^zoomLevel - 1."
+              end
+            end
+
+            t.field names.map_center_point, "GeoLocation!", graphql_only: true do |f|
+              f.documentation <<~EOS
+                The center of the tile as drawn on a Web Mercator map, not the average record location or the midpoint
+                of the tile's latitude bounds. These differ noticeably only at low zoom levels: for tile 1/0/0,
+                the map center point is at about 66.51° latitude, but the bounds midpoint is at about 42.53°.
+              EOS
+            end
+
+            t.field names.bounds, "GeoTileBounds!", graphql_only: true do |f|
+              f.documentation "The geographic bounds of the tile. Web Mercator excludes the poles and stops at approximately ±85.0511°."
+            end
+
+            t.field names.corners, "GeoTileCorners!", graphql_only: true do |f|
+              f.documentation "The four corners of the tile, calculated from its geographic bounds."
+            end
+          end
+
+          register_framework_object_type "GeoTileBounds" do |t|
+            t.resolve_fields_with :object_without_lookahead
+            t.documentation "The geographic bounds of a Web Mercator XYZ tile. Tiles do not cross the antimeridian."
+
+            {
+              names.north => "latitude of the northern",
+              names.south => "latitude of the southern",
+              names.east => "longitude of the eastern",
+              names.west => "longitude of the western"
+            }.each do |name, description|
+              t.field name, "Float!", graphql_only: true do |f|
+                f.documentation "The #{description} boundary of the tile."
+              end
+            end
+          end
+
+          register_framework_object_type "GeoTileCorners" do |t|
+            t.resolve_fields_with :object_without_lookahead
+            t.documentation "The geographic locations of the four corners of a Web Mercator XYZ tile."
+
+            {
+              names.northwest => "northwest",
+              names.northeast => "northeast",
+              names.southwest => "southwest",
+              names.southeast => "southeast"
+            }.each do |name, description|
+              t.field name, "GeoLocation!", graphql_only: true do |f|
+                f.documentation "The #{description} corner of the tile."
+              end
+            end
+          end
+        end
+
         def register_standard_graphql_resolvers
+          require(require_path = "elastic_graph/graphql/aggregation/resolvers/as_geo_tile")
+          schema_def_api.register_graphql_resolver :as_geo_tile,
+            GraphQL::Aggregation::Resolvers::AsGeoTile,
+            defined_at: require_path,
+            built_in: true
+
           require(require_path = "elastic_graph/graphql/resolvers/get_record_field_value")
           schema_def_api.register_graphql_resolver :get_record_field_value,
             GraphQL::Resolvers::GetRecordFieldValue,

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

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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 - 2025 Block, Inc.
+# Copyright 2024 - 2026 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at
@@ -8,6 +8,7 @@
 
 require "delegate"
 require "elastic_graph/constants"
+require "elastic_graph/schema_artifacts/runtime_metadata/configured_graphql_resolver"
 require "elastic_graph/schema_definition/indexing/field"
 require "elastic_graph/schema_definition/indexing/field_reference"
 require "elastic_graph/schema_definition/mixins/has_directives"
@@ -80,8 +81,6 @@ module ElasticGraph
       #   @private
       # @!attribute [rw] non_nullable_in_json_schema
       #   @private
-      # @!attribute [rw] backing_indexing_field
-      #   @private
       # @!attribute [rw] as_input
       #   @private
       # @!attribute [rw] legacy_grouping_schema
@@ -91,7 +90,7 @@ module ElasticGraph
         :filter_customizations, :grouped_by_customizations, :sub_aggregations_customizations,
         :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,
+        :computation_detail, :non_nullable_in_json_schema, :as_input,
         :legacy_grouping_schema, :name_in_index, :resolver
       )
         include Mixins::HasDocumentation
@@ -105,7 +104,7 @@ module ElasticGraph
           accuracy_confidence: :high, name_in_index: name,
           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, resolver: nil
+          as_input: false, legacy_grouping_schema: false, resolver: nil
         )
           type_ref = schema_def_state.type_ref(type)
           super(
@@ -134,20 +133,33 @@ module ElasticGraph
             singular_name: singular,
             name_in_index: name_in_index,
             non_nullable_in_json_schema: false,
-            backing_indexing_field: backing_indexing_field,
             as_input: as_input,
             legacy_grouping_schema: legacy_grouping_schema,
             resolver: resolver
           )
 
-          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."
+          if name != name_in_index
+            if graphql_only
+              schema_def_state.after_user_definition_complete do
+                unless backing_indexing_field
+                  raise Errors::SchemaError,
+                    "GraphQL-only field `#{parent_type.name}.#{name}` has a `name_in_index` (#{name_in_index}) which does not reference an " \
+                    "existing indexing field. To proceed, remove `graphql_only: true` or update `name_in_index` to match an existing indexing field."
+                end
+              end
+            elsif name_in_index.include?(".")
+              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
           end
 
           schema_def_state.register_user_defined_field(self)
           yield self if block_given?
         end
 
+        private :resolver=
+
         # @private
         @@initialize_param_names = instance_method(:initialize).parameters.map(&:last).to_set
 
@@ -448,6 +460,46 @@ module ElasticGraph
           )
         end
 
+        # Configures the GraphQL resolver used to resolve this field. If not set, the resolver configured on the parent type
+        # via {Mixins::HasIndices#resolve_fields_with} will be used.
+        #
+        # @param resolver_name [Symbol] name of the GraphQL resolver
+        # @param config [Hash<Symbol, Object>] configuration parameters for the resolver
+        # @return [void]
+        # @see API#register_graphql_resolver
+        #
+        # @example Use a custom resolver for a custom `Query` field
+        #   # In `add_resolver.rb`:
+        #   class AddResolver
+        #     def initialize(elasticgraph_graphql:, config:)
+        #       @multiplier = config.fetch(:multiplier, 1)
+        #     end
+        #
+        #     def resolve(field:, object:, args:, context:)
+        #       sum = args.fetch("x") + args.fetch("y")
+        #       sum * @multiplier
+        #     end
+        #   end
+        #
+        #   # In `config/schema.rb`:
+        #   ElasticGraph.define_schema do |schema|
+        #     require(resolver_path = "add_resolver")
+        #     schema.register_graphql_resolver :add, AddResolver, defined_at: resolver_path
+        #
+        #     schema.on_root_query_type do |t|
+        #       t.field "add", "Int" do |f|
+        #         f.argument "x", "Int!"
+        #         f.argument "y", "Int!"
+        #
+        #         # Extra args (`multiplier: 2`, in this example) are passed to the resolver within `config`.
+        #         f.resolve_with :add, multiplier: 2
+        #       end
+        #     end
+        #   end
+        def resolve_with(resolver_name, **config)
+          self.resolver = resolver_name&.then { |name| SchemaArtifacts::RuntimeMetadata::ConfiguredGraphQLResolver.new(name, config) }
+        end
+
         # @private
         def runtime_script(script)
           self.runtime_field_script = script
@@ -557,13 +609,14 @@ module ElasticGraph
           # instead.
           return false if parent_type.indexed? && name == "id"
 
-          return false if relationship || type.fully_unwrapped.as_object_type&.does_not_support?(&:groupable?)
+          return false if relationship || type_disallows_grouping?
 
           # We don't support grouping an entire list of values, but we do support grouping on individual values in a list.
           # However, we only do so when a `singular_name` has been provided (so that we know what to call the grouped_by field).
           # The semantics are a little odd (since one document can be duplicated in multiple grouping buckets) so we're ok
           # with not offering it by default--the user has to opt-in by telling us what to call the field in its singular form.
-          return list_field_groupable_by_single_values? if type.list? && type.fully_unwrapped.leaf?
+          # Types with their own `GroupedBy` type are grouped as individual values, like scalars.
+          return list_field_groupable_by_single_values? if type.list? && (type.fully_unwrapped.leaf? || original_type.fully_unwrapped.grouped_by_type_defined?)
 
           # Nested fields will be supported through specific nested aggregation support, and do not
           # work as expected when grouping on the root document type.
@@ -678,11 +731,13 @@ module ElasticGraph
           end
         end
 
+        # Returns the GraphQL type used for this field's grouped value.
         # @private
         def grouped_by_field_type_name
           unwrapped_type = type_for_derived_types.fully_unwrapped
-          if unwrapped_type.scalar_type_needing_grouped_by_object? && !legacy_grouping_schema
-            unwrapped_type.with_reverted_override.as_grouped_by.name
+          original_unwrapped_type = original_type_for_derived_types.fully_unwrapped
+          if original_unwrapped_type.grouped_by_type_defined? && !legacy_grouping_schema
+            original_unwrapped_type.as_grouped_by.name
           elsif unwrapped_type.leaf?
             unwrapped_type.name
           else
@@ -702,7 +757,7 @@ module ElasticGraph
               "The `#{name}` field value for this group",
               list_field_grouped_by_doc_note("the selected subfields of `#{name}`")
             )
-          elsif type_for_derived_types.fully_unwrapped.scalar_type_needing_grouped_by_object? && !legacy_grouping_schema
+          elsif original_type_for_derived_types.fully_unwrapped.grouped_by_type_defined? && !legacy_grouping_schema
             derived_documentation("Offers the different grouping options for the `#{name}` value within this group")
           else
             derived_documentation("The `#{name}` field value for this group")
@@ -934,6 +989,27 @@ module ElasticGraph
           )
         end
 
+        # The alternate field that is backing this field in the datastore index. Will only be non-`nil` for `graphql_only` fields.
+        # @return [Field, nil] the field backing this field in the index
+        #
+        # @private
+        def backing_indexing_field
+          return nil unless graphql_only
+
+          type = parent_type
+          field = nil
+
+          name_in_index.split(".").each do |path_part|
+            if (field = type&.indexing_fields_by_name_in_index&.fetch(path_part, nil))
+              type = field.type.fully_unwrapped.as_object_type
+            else
+              return nil
+            end
+          end
+
+          field
+        end
+
         private
 
         def args_sdl(joiner:, after_opening_paren: "", &arg_selector)
@@ -943,6 +1019,11 @@ module ElasticGraph
           "(#{after_opening_paren}#{args_sdl})"
         end
 
+        # Identifies types that disallow grouping, except for types that define their own `GroupedBy` type.
+        def type_disallows_grouping?
+          !original_type.fully_unwrapped.grouped_by_type_defined? && !!type.fully_unwrapped.as_object_type&.does_not_support?(&:groupable?)
+        end
+
         # Indicates if the field uses the `text` mapping type.
         def text?
           mapping_type == "text"

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

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/graphql_sdl_enumerator.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/input_field.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/input_type.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/interface_type.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/list_counts_state.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/object_type.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/relationship.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/scalar_type.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/sort_order_enum_value.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/sub_aggregation_path.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/type_namer.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/type_reference.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at
@@ -153,12 +153,15 @@ module ElasticGraph
             .sub(/[\]!]+\z/, "") # strip `]` and `!` characters from the end: https://rubular.com/r/pC8C0i7EpvHDbf
         end
 
-        # Generally speaking, scalar types have `grouped_by` fields which are scalars of the same types,
-        # and object types have `grouped_by` fields which are special `[object_type]GroupedBy` types.
-        #
-        # ...except for some special cases (Date and DateTime), which this predicate detects.
-        def scalar_type_needing_grouped_by_object?
-          %w[Date DateTime].include?(type_namer.revert_override_for(name))
+        # Indicates if this type opts into specialized grouping by defining its own `[type]GroupedBy` type.
+        # Use the original type name, before overrides, since an overridden name may identify another type.
+        # Only call this after the user definition is complete, when all grouping types are known.
+        def grouped_by_type_defined?
+          unless schema_def_state.user_definition_complete
+            raise Errors::SchemaError, "Cannot call `grouped_by_type_defined?` until the schema definition is complete."
+          end
+
+          schema_def_state.types_by_name.key?(as_grouped_by.name)
         end
 
         # Returns a new `TypeReference` with any type name overrides reverted (to provide the "original" type name).

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

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at
@@ -279,6 +279,12 @@ module ElasticGraph
         #   differently named field in the index.
         # @param singular [String] indicates what the singular form of a field's name is. When provided, ElasticGraph will define a
         #   `groupedBy` field (using the singular form) allowing clients to group by individual values from the field.
+        # @param aggregatable [Boolean] force-enables or disables the ability for aggregation queries to aggregate over this field.
+        #   When not provided, ElasticGraph will infer field aggregatability based on the field's GraphQL type and mapping type.
+        # @param filterable [Boolean] force-enables or disables the ability for queries to filter by this field. When not provided,
+        #   ElasticGraph will infer field filterability based on the field's GraphQL type and mapping type.
+        # @param groupable [Boolean] force-enables or disables the ability for aggregation queries to group by this field. When
+        #   not provided, ElasticGraph will infer field groupability based on the field's GraphQL type and mapping type.
         # @yield [Field] the field for further customization
         # @return [void]
         #
@@ -295,24 +301,37 @@ module ElasticGraph
         #       t.index "authors"
         #     end
         #   end
-        def paginated_collection_field(name, element_type, name_in_index: name, singular: nil, &block)
+        def paginated_collection_field(
+          name,
+          element_type,
+          name_in_index: name,
+          graphql_only: false,
+          singular: nil,
+          groupable: !!singular,
+          filterable: nil,
+          aggregatable: nil,
+          &block
+        )
           element_type_ref = schema_def_state.type_ref(element_type).to_final_form
           element_type = element_type_ref.name
 
           schema_def_state.paginated_collection_element_types << element_type
 
-          backing_indexing_field = field(name, "[#{element_type}!]!", indexing_only: true, name_in_index: name_in_index, &block)
+          unless graphql_only
+            field(name, "[#{element_type}!]!", indexing_only: true, name_in_index: name_in_index, &block)
+          end
 
           field(
             name,
             element_type_ref.as_connection.name,
             name_in_index: name_in_index,
             type_for_derived_types: "[#{element_type}]",
-            groupable: !!singular,
-            sortable: false,
             graphql_only: true,
             singular: singular,
-            backing_indexing_field: backing_indexing_field
+            groupable: groupable,
+            filterable: filterable,
+            aggregatable: aggregatable,
+            sortable: false
           ) do |f|
             f.define_relay_pagination_arguments!
             block&.call(f)
@@ -536,7 +555,7 @@ module ElasticGraph
             )
 
             field.relationship = relationship
-            field.resolver = :nested_relationships
+            field.resolve_with :nested_relationships
 
             yield relationship if block_given?
 

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

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/scripting/file_system_repository.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/scripting/script.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/state.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 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/test_support.rb

@@ -1,4 +1,4 @@
-# Copyright 2024 - 2025 Block, Inc.
+# Copyright 2024 - 2026 Block, Inc.
 #
 # Use of this source code is governed by an MIT-style
 # license that can be found in the LICENSE file or at