elasticgraph-schema_artifacts 0.19.1.1 → 0.19.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e13f3dabb5a9086592a80c8369d58479c2af9b3f3d04a28b6c339bed342bea41
-  data.tar.gz: a119fea91764d31adca633580d06084ac1ad40866b87b224add809d69a07fd6b
+  metadata.gz: 1cc728697f7cfe8e926a44626cce30567a2ef7638b2e5f134ae4aedd34d02947
+  data.tar.gz: 9c8a6cd5ffbdcadfd8f6d5edebebf2067b64c9de454736d85b85f9aea8994912
 SHA512:
-  metadata.gz: 4101e29cf963bb84894c16d974da595488e63fcc9e78dfebfbb748adaabb2a3a039c67785ec2aa12d0e3cabdc8ce3b140297d42be89009ddf4482590c426dfc3
-  data.tar.gz: cc12505507fd84c0bd076e939e22a0edb06318fcc0d3032dba40d352c5e26a882cb194f3c25637f96339ff711e3b2a88e8bc627bf2614c47117535caeaf1aac9
+  metadata.gz: fe7be2fba3754752129f904541afd03c40aa856868d8eab0d08fd769289b0cef4e4064c516e6c8d117cd66251223f25cdbc261f81cb5e6d8d2f7e538c6a39d2a
+  data.tar.gz: 4f5cec991b458051b50870a9fe14dc7464b8d86d7c5cc2c1d71b71fec3f8b754bf661f0f9dabc7d357ebb76ded57c922172ca2b3e01ed5fe752e34f73762d46a

data/LICENSE.txt

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2024 Block, Inc.
+Copyright (c) 2024 - 2025 Block, Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/lib/elastic_graph/schema_artifacts/artifacts_helper_methods.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_artifacts/from_disk.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
@@ -17,7 +17,7 @@ require "yaml"
 module ElasticGraph
   module SchemaArtifacts
     # Builds a `SchemaArtifacts::FromDisk` instance using the provided YAML settings.
-    def self.from_parsed_yaml(parsed_yaml, for_context:)
+    def self.from_parsed_yaml(parsed_yaml)
       schema_artifacts = parsed_yaml.fetch("schema_artifacts") do
         raise Errors::ConfigError, "Config is missing required key `schema_artifacts`."
       end
@@ -30,11 +30,11 @@ module ElasticGraph
         raise Errors::ConfigError, "Config is missing required key `schema_artifacts.directory`."
       end
 
-      FromDisk.new(directory, for_context)
+      FromDisk.new(directory)
     end
 
     # Responsible for loading schema artifacts from disk.
-    class FromDisk < Support::MemoizableData.define(:artifacts_dir, :context)
+    class FromDisk < Support::MemoizableData.define(:artifacts_dir)
       include ArtifactsHelperMethods
 
       def graphql_schema_string
@@ -74,10 +74,7 @@ module ElasticGraph
       end
 
       def runtime_metadata
-        @runtime_metadata ||= RuntimeMetadata::Schema.from_hash(
-          parsed_yaml_from(RUNTIME_METADATA_FILE),
-          for_context: context
-        )
+        @runtime_metadata ||= RuntimeMetadata::Schema.from_hash(parsed_yaml_from(RUNTIME_METADATA_FILE))
       end
 
       private

data/lib/elastic_graph/schema_artifacts/runtime_metadata/computation_detail.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_artifacts/runtime_metadata/enum.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_artifacts/runtime_metadata/extension.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
@@ -6,6 +6,7 @@
 #
 # frozen_string_literal: true
 
+require "elastic_graph/schema_artifacts/runtime_metadata/interface_verifier"
 require "elastic_graph/support/hash_util"
 
 module ElasticGraph
@@ -15,36 +16,42 @@ module ElasticGraph
       # code base) that implements a standard interface to plug in custom functionality.
       #
       # Extensions are serialized using two fields:
-      # - `extension_name`: the Ruby constant of the extension
+      # - `name`: the Ruby constant of the extension
       # - `require_path`: file path to `require` to load the extension
       #
       # However, an `Extension` instance represents a loaded, resolved extension.
       # We eagerly load extensions (and validate them in the `ExtensionLoader`) in
       # order to surface any issues with the extension as soon as possible. We don't
       # want to defer errors if we can detect any issues with the extension at boot time.
-      Extension = ::Data.define(:extension_class, :require_path, :extension_config) do
+      Extension = ::Data.define(:extension_class, :require_path, :config, :name) do
         # @implements Extension
+        def initialize(extension_class:, require_path:, config:, name: extension_class.name.to_s)
+          super(extension_class:, require_path:, config:, name:)
+        end
 
         # Loads an extension using a serialized hash, via the provided `ExtensionLoader`.
         def self.load_from_hash(hash, via:)
-          config = Support::HashUtil.symbolize_keys(hash["extension_config"] || {}) # : ::Hash[::Symbol, untyped]
-          via.load(hash.fetch("extension_name"), from: hash.fetch("require_path"), config: config)
-        end
-
-        # The name of the extension (based on the name of the extension class).
-        def extension_name
-          extension_class.name.to_s
+          config = Support::HashUtil.symbolize_keys(hash["config"] || {}) # : ::Hash[::Symbol, untyped]
+          via.load(hash.fetch("name"), from: hash.fetch("require_path"), config: config)
         end
 
         # The serialized form of an extension.
         def to_dumpable_hash
           # Keys here are ordered alphabetically; please keep them that way.
           {
-            "extension_config" => Support::HashUtil.stringify_keys(extension_config),
-            "extension_name" => extension_name,
+            "config" => Support::HashUtil.stringify_keys(config),
+            "name" => name,
             "require_path" => require_path
           }.reject { |_, v| v.empty? }
         end
+
+        def verify_against!(interface_def)
+          InterfaceVerifier.verify!(extension_class, against: interface_def, constant_name: name)
+        end
+
+        def verify_against(interface_def)
+          InterfaceVerifier.verify(extension_class, against: interface_def, constant_name: name)
+        end
       end
     end
   end

data/lib/elastic_graph/schema_artifacts/runtime_metadata/extension_loader.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
@@ -8,6 +8,7 @@
 
 require "elastic_graph/errors"
 require "elastic_graph/schema_artifacts/runtime_metadata/extension"
+require "elastic_graph/schema_artifacts/runtime_metadata/interface_verifier"
 
 module ElasticGraph
   module SchemaArtifacts
@@ -35,89 +36,17 @@ module ElasticGraph
               raise Errors::InvalidExtensionError, "Extension `#{constant_name}` cannot be loaded from `#{from}`, " \
                 "since it has already been loaded from `#{extension.require_path}`."
             end
-          end.with(extension_config: config)
+          end.with(config: config)
         end
 
         private
 
         def load_extension(constant_name, require_path)
           require require_path
-          extension_class = ::Object.const_get(constant_name).tap { |ext| verify_interface(constant_name, ext) }
-          Extension.new(extension_class, require_path, {})
-        end
-
-        def verify_interface(constant_name, extension)
-          # @type var problems: ::Array[::String]
-          problems = []
-          problems.concat(verify_methods("class", extension.singleton_class, @interface_def.singleton_class))
-
-          if extension.is_a?(::Module)
-            problems.concat(verify_methods("instance", extension, @interface_def))
-
-            # We care about the name exactly matching so that we can dump the extension name in a schema
-            # artifact w/o having to pass around the original constant name.
-            if extension.name != constant_name.delete_prefix("::")
-              problems << "- Exposes a name (`#{extension.name}`) that differs from the provided extension name (`#{constant_name}`)"
-            end
-          else
-            problems << "- Is not a class or module as expected"
-          end
-
-          if problems.any?
-            raise Errors::InvalidExtensionError,
-              "Extension `#{constant_name}` does not implement the expected interface correctly. Problems:\n\n" \
-              "#{problems.join("\n")}"
-          end
-        end
-
-        def verify_methods(type, extension, interface)
-          interface_methods = list_instance_interface_methods(interface)
-          extension_methods = list_instance_interface_methods(extension)
-
-          # @type var problems: ::Array[::String]
-          problems = []
-
-          if (missing_methods = interface_methods - extension_methods).any?
-            problems << "- Missing #{type} methods: #{missing_methods.map { |m| "`#{m}`" }.join(", ")}"
+          extension_class = ::Object.const_get(constant_name)
+          Extension.new(extension_class, require_path, {}, constant_name.delete_prefix("::")).tap do |ext|
+            ext.verify_against!(@interface_def)
           end
-
-          interface_methods.intersection(extension_methods).each do |method_name|
-            unless parameters_match?(extension, interface, method_name)
-              interface_signature = signature_code_for(interface, method_name)
-              extension_signature = signature_code_for(extension, method_name)
-
-              problems << "- Method signature for #{type} method `#{method_name}` (`#{extension_signature}`) does not match interface (`#{interface_signature}`)"
-            end
-          end
-
-          problems
-        end
-
-        def list_instance_interface_methods(klass)
-          # Here we look at more than just the public methods. This is necessary for `initialize`.
-          # If it's defined on the interface definition, we want to verify it on the extension,
-          # but Ruby makes `initialize` private by default.
-          klass.instance_methods(false) +
-            klass.protected_instance_methods(false) +
-            klass.private_instance_methods(false)
-        end
-
-        def parameters_match?(extension, interface, method_name)
-          interface_parameters = interface.instance_method(method_name).parameters
-          extension_parameters = extension.instance_method(method_name).parameters
-
-          # Here we compare the parameters for exact equality. This is stricter than we need it
-          # to be (it doesn't allow the parameters to have different names, for example) but it's
-          # considerably simpler than us trying to determine what is truly required. For example,
-          # the name doesn't matter on a positional arg, but would matter on a keyword arg.
-          interface_parameters == extension_parameters
-        end
-
-        def signature_code_for(object, method_name)
-          # @type var file_name: ::String?
-          # @type var line_number: ::Integer?
-          file_name, line_number = object.instance_method(method_name).source_location
-          ::File.read(file_name.to_s).split("\n").fetch(line_number.to_i - 1).strip
         end
       end
     end

data/lib/elastic_graph/schema_artifacts/runtime_metadata/graphql_extension.rb

@@ -0,0 +1,40 @@
+# 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/schema_artifacts/runtime_metadata/extension_loader"
+
+module ElasticGraph
+  module SchemaArtifacts
+    module RuntimeMetadata
+      class GraphQLExtension < ::Data.define(:extension_ref)
+        def self.loader
+          @loader ||= ExtensionLoader.new(Module.new)
+        end
+
+        EXTENSION_REF = "extension_ref"
+
+        def load_extension
+          Extension.load_from_hash(extension_ref, via: GraphQLExtension.loader)
+        end
+
+        def self.from_hash(hash)
+          new(
+            extension_ref: hash.fetch(EXTENSION_REF)
+          )
+        end
+
+        def to_dumpable_hash
+          {
+            # Keys here are ordered alphabetically; please keep them that way.
+            EXTENSION_REF => extension_ref
+          }
+        end
+      end
+    end
+  end
+end

data/lib/elastic_graph/schema_artifacts/runtime_metadata/graphql_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
@@ -12,17 +12,19 @@ require "elastic_graph/schema_artifacts/runtime_metadata/relation"
 module ElasticGraph
   module SchemaArtifacts
     module RuntimeMetadata
-      class GraphQLField < ::Data.define(:name_in_index, :relation, :computation_detail)
-        EMPTY = new(nil, nil, nil)
+      class GraphQLField < ::Data.define(:name_in_index, :relation, :computation_detail, :resolver)
+        EMPTY = new(nil, nil, nil, nil)
         NAME_IN_INDEX = "name_in_index"
         RELATION = "relation"
         AGGREGATION_DETAIL = "computation_detail"
+        RESOLVER = "resolver"
 
         def self.from_hash(hash)
           new(
             name_in_index: hash[NAME_IN_INDEX],
             relation: hash[RELATION]&.then { |rel_hash| Relation.from_hash(rel_hash) },
-            computation_detail: hash[AGGREGATION_DETAIL]&.then { |agg_hash| ComputationDetail.from_hash(agg_hash) }
+            computation_detail: hash[AGGREGATION_DETAIL]&.then { |agg_hash| ComputationDetail.from_hash(agg_hash) },
+            resolver: hash[RESOLVER]&.to_sym
           )
         end
 
@@ -31,7 +33,8 @@ module ElasticGraph
             # Keys here are ordered alphabetically; please keep them that way.
             AGGREGATION_DETAIL => computation_detail&.to_dumpable_hash,
             NAME_IN_INDEX => name_in_index,
-            RELATION => relation&.to_dumpable_hash
+            RELATION => relation&.to_dumpable_hash,
+            RESOLVER => resolver&.to_s
           }
         end
 
@@ -39,7 +42,11 @@ module ElasticGraph
         # `name_in_graphql`. Fields that have not been customized in some way do not need to be
         # included in the dumped runtime metadata.
         def needed?(name_in_graphql)
-          !!relation || !!computation_detail || name_in_index&.!=(name_in_graphql) || false
+          !!relation ||
+            !!computation_detail ||
+            name_in_index&.!=(name_in_graphql) ||
+            !resolver.nil? ||
+            false
         end
 
         def with_computation_detail(empty_bucket_value:, function:)

data/lib/elastic_graph/schema_artifacts/runtime_metadata/graphql_resolver.rb

@@ -0,0 +1,66 @@
+# 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/schema_artifacts/runtime_metadata/extension_loader"
+
+module ElasticGraph
+  module SchemaArtifacts
+    module RuntimeMetadata
+      class GraphQLResolver < ::Data.define(:needs_lookahead, :resolver_ref)
+        def self.with_lookahead_loader
+          @with_lookahead_loader ||= ExtensionLoader.new(InterfaceWithLookahead)
+        end
+
+        def self.without_lookahead_loader
+          @without_lookahead_loader ||= ExtensionLoader.new(InterfaceWithoutLookahead)
+        end
+
+        NEEDS_LOOKAHEAD = "needs_lookahead"
+        RESOLVER_REF = "resolver_ref"
+
+        def load_resolver
+          loader = needs_lookahead ? GraphQLResolver.with_lookahead_loader : GraphQLResolver.without_lookahead_loader
+          Extension.load_from_hash(resolver_ref, via: loader)
+        end
+
+        def self.from_hash(hash)
+          new(
+            needs_lookahead: hash.fetch(NEEDS_LOOKAHEAD),
+            resolver_ref: hash.fetch(RESOLVER_REF)
+          )
+        end
+
+        def to_dumpable_hash
+          {
+            # Keys here are ordered alphabetically; please keep them that way.
+            NEEDS_LOOKAHEAD => needs_lookahead,
+            RESOLVER_REF => resolver_ref
+          }
+        end
+
+        class InterfaceWithLookahead
+          def initialize(elasticgraph_graphql:, config:)
+            # must be defined, but nothing to do
+          end
+
+          def resolve(field:, object:, args:, context:, lookahead:)
+          end
+        end
+
+        class InterfaceWithoutLookahead
+          def initialize(elasticgraph_graphql:, config:)
+            # must be defined, but nothing to do
+          end
+
+          def resolve(field:, object:, args:, context:)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/elastic_graph/schema_artifacts/runtime_metadata/hash_dumper.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_artifacts/runtime_metadata/index_definition.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_artifacts/runtime_metadata/index_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

data/lib/elastic_graph/schema_artifacts/runtime_metadata/interface_verifier.rb

@@ -0,0 +1,109 @@
+# 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/errors"
+
+module ElasticGraph
+  module SchemaArtifacts
+    module RuntimeMetadata
+      # Responsible for verifying extensions. This requires an interface definition
+      # (a class or module with empty method definitions that just serves to define what
+      # loaded extensions must implement). That allows us to verify the extension implements
+      # the interface correctly ahead of time, rather than deferring exceptions to when the
+      # extension is later used.
+      #
+      # Note, however, that this does not guarantee no runtime exceptions from the use of the
+      # extension: the extension may return invalid return values, or throw exceptions when
+      # called. But this verifies the interface to the extent that we can.
+      module InterfaceVerifier
+        class << self
+          def verify!(extension, against:, constant_name:)
+            problems = verify(extension, against:, constant_name:)
+
+            if problems.any?
+              raise Errors::InvalidExtensionError,
+                "Extension `#{constant_name}` does not implement the expected interface correctly. Problems:\n\n" \
+                "#{problems.join("\n")}"
+            end
+          end
+
+          def verify(extension, against:, constant_name:)
+            problems = [] # : ::Array[::String]
+            problems.concat(verify_methods("class", extension.singleton_class, against.singleton_class))
+
+            if extension.is_a?(::Module)
+              problems.concat(verify_methods("instance", extension, against))
+
+              # We care about the name exactly matching so that we can dump the extension name in a schema
+              # artifact w/o having to pass around the original constant name.
+              if extension.name != constant_name.delete_prefix("::")
+                problems << "- Exposes a name (`#{extension.name}`) that differs from the provided extension name (`#{constant_name}`)"
+              end
+            else
+              problems << "- Is not a class or module as expected"
+            end
+
+            problems
+          end
+
+          private
+
+          def verify_methods(type, extension, interface)
+            interface_methods = list_instance_interface_methods(interface)
+            extension_methods = list_instance_interface_methods(extension)
+
+            # @type var problems: ::Array[::String]
+            problems = []
+
+            if (missing_methods = interface_methods - extension_methods).any?
+              problems << "- Missing #{type} methods: #{missing_methods.map { |m| "`#{m}`" }.join(", ")}"
+            end
+
+            interface_methods.intersection(extension_methods).each do |method_name|
+              unless parameters_match?(extension, interface, method_name)
+                interface_signature = signature_code_for(interface, method_name)
+                extension_signature = signature_code_for(extension, method_name)
+
+                problems << "- Method signature for #{type} method `#{method_name}` (`#{extension_signature}`) does not match interface (`#{interface_signature}`)"
+              end
+            end
+
+            problems
+          end
+
+          def list_instance_interface_methods(klass)
+            # Here we look at more than just the public methods. This is necessary for `initialize`.
+            # If it's defined on the interface definition, we want to verify it on the extension,
+            # but Ruby makes `initialize` private by default.
+            klass.instance_methods(false) +
+              klass.protected_instance_methods(false) +
+              klass.private_instance_methods(false)
+          end
+
+          def parameters_match?(extension, interface, method_name)
+            interface_parameters = interface.instance_method(method_name).parameters
+            extension_parameters = extension.instance_method(method_name).parameters
+
+            # Here we compare the parameters for exact equality. This is stricter than we need it
+            # to be (it doesn't allow the parameters to have different names, for example) but it's
+            # considerably simpler than us trying to determine what is truly required. For example,
+            # the name doesn't matter on a positional arg, but would matter on a keyword arg.
+            interface_parameters == extension_parameters
+          end
+
+          def signature_code_for(object, method_name)
+            # @type var file_name: ::String?
+            # @type var line_number: ::Integer?
+            file_name, line_number = object.instance_method(method_name).source_location
+            ::File.read(file_name.to_s).split("\n").fetch(line_number.to_i - 1).strip
+          end
+        end
+      end
+    end
+  end
+end

data/lib/elastic_graph/schema_artifacts/runtime_metadata/object_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
@@ -50,8 +50,9 @@ module ElasticGraph
             UpdateTarget.from_hash(update_target_hash)
           end || []
 
-          graphql_fields_by_name = hash[GRAPHQL_FIELDS_BY_NAME]&.transform_values do |field_hash|
-            GraphQLField.from_hash(field_hash)
+          graphql_fields_by_name = hash[GRAPHQL_FIELDS_BY_NAME]&.to_h do |name, field_hash|
+            field_hash = field_hash.merge(GraphQLField::NAME_IN_INDEX => name) unless field_hash[GraphQLField::NAME_IN_INDEX]
+            [name, GraphQLField.from_hash(field_hash)]
           end || {}
 
           new(
@@ -65,10 +66,16 @@ module ElasticGraph
         end
 
         def to_dumpable_hash
+          dumped_graphql_fields_by_name =
+            HashDumper.dump_hash(graphql_fields_by_name.to_h do |name, field|
+              field = field.with(name_in_index: nil) if field.name_in_index == name
+              [name, field]
+            end, &:to_dumpable_hash)
+
           {
             # Keys here are ordered alphabetically; please keep them that way.
             ELASTICGRAPH_CATEGORY => elasticgraph_category&.to_s,
-            GRAPHQL_FIELDS_BY_NAME => HashDumper.dump_hash(graphql_fields_by_name, &:to_dumpable_hash),
+            GRAPHQL_FIELDS_BY_NAME => dumped_graphql_fields_by_name,
             GRAPHQL_ONLY_RETURN_TYPE => graphql_only_return_type ? true : nil,
             INDEX_DEFINITION_NAMES => index_definition_names,
             SOURCE_TYPE => source_type,

data/lib/elastic_graph/schema_artifacts/runtime_metadata/params.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
@@ -52,8 +52,8 @@ module ElasticGraph
 
         def value_for(event_or_prepared_record)
           case cardinality
-          when :many then Support::HashUtil.fetch_leaf_values_at_path(event_or_prepared_record, source_path) { [] }
-          when :one then Support::HashUtil.fetch_value_at_path(event_or_prepared_record, source_path) { nil }
+          when :many then Support::HashUtil.fetch_leaf_values_at_path(event_or_prepared_record, source_path.split(".")) { [] }
+          when :one then Support::HashUtil.fetch_value_at_path(event_or_prepared_record, source_path.split(".")) { nil }
           end
         end
       end

data/lib/elastic_graph/schema_artifacts/runtime_metadata/relation.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_artifacts/runtime_metadata/scalar_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
@@ -22,12 +22,12 @@ module ElasticGraph
         end
 
         DEFAULT_COERCION_ADAPTER_REF = {
-          "extension_name" => "ElasticGraph::GraphQL::ScalarCoercionAdapters::NoOp",
+          "name" => "ElasticGraph::GraphQL::ScalarCoercionAdapters::NoOp",
           "require_path" => "elastic_graph/graphql/scalar_coercion_adapters/no_op"
         }
 
         DEFAULT_INDEXING_PREPARER_REF = {
-          "extension_name" => "ElasticGraph::Indexer::IndexingPreparers::NoOp",
+          "name" => "ElasticGraph::Indexer::IndexingPreparers::NoOp",
           "require_path" => "elastic_graph/indexer/indexing_preparers/no_op"
         }
 

data/lib/elastic_graph/schema_artifacts/runtime_metadata/schema.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
@@ -9,6 +9,8 @@
 require "elastic_graph/schema_artifacts/runtime_metadata/enum"
 require "elastic_graph/schema_artifacts/runtime_metadata/extension"
 require "elastic_graph/schema_artifacts/runtime_metadata/extension_loader"
+require "elastic_graph/schema_artifacts/runtime_metadata/graphql_extension"
+require "elastic_graph/schema_artifacts/runtime_metadata/graphql_resolver"
 require "elastic_graph/schema_artifacts/runtime_metadata/hash_dumper"
 require "elastic_graph/schema_artifacts/runtime_metadata/index_definition"
 require "elastic_graph/schema_artifacts/runtime_metadata/object_type"
@@ -27,6 +29,7 @@ module ElasticGraph
         :index_definitions_by_name,
         :schema_element_names,
         :graphql_extension_modules,
+        :graphql_resolvers_by_name,
         :static_script_ids_by_scoped_name
       )
         OBJECT_TYPES_BY_NAME = "object_types_by_name"
@@ -35,9 +38,10 @@ module ElasticGraph
         INDEX_DEFINITIONS_BY_NAME = "index_definitions_by_name"
         SCHEMA_ELEMENT_NAMES = "schema_element_names"
         GRAPHQL_EXTENSION_MODULES = "graphql_extension_modules"
+        GRAPHQL_RESOLVERS_BY_NAME = "graphql_resolvers_by_name"
         STATIC_SCRIPT_IDS_BY_NAME = "static_script_ids_by_scoped_name"
 
-        def self.from_hash(hash, for_context:)
+        def self.from_hash(hash)
           object_types_by_name = hash[OBJECT_TYPES_BY_NAME]&.transform_values do |type_hash|
             ObjectType.from_hash(type_hash)
           end || {}
@@ -56,17 +60,14 @@ module ElasticGraph
 
           schema_element_names = SchemaElementNames.from_hash(hash.fetch(SCHEMA_ELEMENT_NAMES))
 
-          loader = ExtensionLoader.new(Module.new)
           graphql_extension_modules =
-            if for_context == :graphql
-              hash[GRAPHQL_EXTENSION_MODULES]&.map do |ext_mod_hash|
-                Extension.load_from_hash(ext_mod_hash, via: loader)
-              end || []
-            else
-              # Avoid loading GraphQL extrnsion modules if we're not in a GraphQL context. We can't count
-              # on the extension modules even being available to load in other contexts.
-              [] # : ::Array[Extension]
-            end
+            hash[GRAPHQL_EXTENSION_MODULES]&.map do |ext_mod_hash|
+              GraphQLExtension.from_hash(ext_mod_hash)
+            end || []
+
+          graphql_resolvers_by_name = hash[GRAPHQL_RESOLVERS_BY_NAME]&.to_h do |name, resolver_hash|
+            [name.to_sym, GraphQLResolver.from_hash(resolver_hash)]
+          end || {}
 
           static_script_ids_by_scoped_name = hash[STATIC_SCRIPT_IDS_BY_NAME] || {}
 
@@ -77,6 +78,7 @@ module ElasticGraph
             index_definitions_by_name: index_definitions_by_name,
             schema_element_names: schema_element_names,
             graphql_extension_modules: graphql_extension_modules,
+            graphql_resolvers_by_name: graphql_resolvers_by_name,
             static_script_ids_by_scoped_name: static_script_ids_by_scoped_name
           )
         end
@@ -86,6 +88,7 @@ module ElasticGraph
             # Keys here are ordered alphabetically; please keep them that way.
             ENUM_TYPES_BY_NAME => HashDumper.dump_hash(enum_types_by_name, &:to_dumpable_hash),
             GRAPHQL_EXTENSION_MODULES => graphql_extension_modules.map(&:to_dumpable_hash),
+            GRAPHQL_RESOLVERS_BY_NAME => HashDumper.dump_hash(graphql_resolvers_by_name.transform_keys(&:to_s), &:to_dumpable_hash),
             INDEX_DEFINITIONS_BY_NAME => HashDumper.dump_hash(index_definitions_by_name, &:to_dumpable_hash),
             OBJECT_TYPES_BY_NAME => HashDumper.dump_hash(object_types_by_name, &:to_dumpable_hash),
             SCALAR_TYPES_BY_NAME => HashDumper.dump_hash(scalar_types_by_name, &:to_dumpable_hash),

data/lib/elastic_graph/schema_artifacts/runtime_metadata/schema_element_names.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_artifacts/runtime_metadata/sort_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

data/lib/elastic_graph/schema_artifacts/runtime_metadata/update_target.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

metadata

@@ -1,16 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: elasticgraph-schema_artifacts
 version: !ruby/object:Gem::Version
-  version: 0.19.1.1
+  version: 0.19.2.1
 platform: ruby
 authors:
 - Myron Marston
 - Ben VandenBos
 - Block Engineering
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-07 00:00:00.000000000 Z
+date: 2025-04-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: elasticgraph-support
@@ -18,43 +17,42 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.1.1
+        version: 0.19.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.1.1
+        version: 0.19.2.1
 - !ruby/object:Gem::Dependency
   name: elasticgraph-graphql
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.1.1
+        version: 0.19.2.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.1.1
+        version: 0.19.2.1
 - !ruby/object:Gem::Dependency
   name: elasticgraph-indexer
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.1.1
+        version: 0.19.2.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.19.1.1
-description:
+        version: 0.19.2.1
 email:
 - myron@squareup.com
 executables: []
@@ -69,10 +67,13 @@ files:
 - lib/elastic_graph/schema_artifacts/runtime_metadata/enum.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/extension.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/extension_loader.rb
+- lib/elastic_graph/schema_artifacts/runtime_metadata/graphql_extension.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/graphql_field.rb
+- lib/elastic_graph/schema_artifacts/runtime_metadata/graphql_resolver.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/hash_dumper.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/index_definition.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/index_field.rb
+- lib/elastic_graph/schema_artifacts/runtime_metadata/interface_verifier.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/object_type.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/params.rb
 - lib/elastic_graph/schema_artifacts/runtime_metadata/relation.rb
@@ -86,12 +87,11 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/block/elasticgraph/issues
-  changelog_uri: https://github.com/block/elasticgraph/releases/tag/v0.19.1.1
-  documentation_uri: https://block.github.io/elasticgraph/docs/main/
+  changelog_uri: https://github.com/block/elasticgraph/releases/tag/v0.19.2.1
+  documentation_uri: https://block.github.io/elasticgraph/api-docs/v0.19.2.1/
   homepage_uri: https://block.github.io/elasticgraph/
-  source_code_uri: https://github.com/block/elasticgraph/tree/v0.19.1.1/elasticgraph-schema_artifacts
+  source_code_uri: https://github.com/block/elasticgraph/tree/v0.19.2.1/elasticgraph-schema_artifacts
   gem_category: core
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -109,8 +109,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.22
-signing_key:
+rubygems_version: 3.6.2
 specification_version: 4
 summary: ElasticGraph gem containing code related to generated schema artifacts.
 test_files: []