jay_api 29.6.0 → 29.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1cec24f42607c2e94f600045f41f8c5db2593ebd478f391f9c97786d139b819
-  data.tar.gz: f35ecb6ce96aa5215d3a97229e4ee497697b57daa2ffa36b607d5d4d88a7bb3d
+  metadata.gz: 00a7a3dd5e1e7e2bf232e6f06c8ce6b6e39a31693f4ec2921fb56a1f14e70f63
+  data.tar.gz: 405c629691a82be4e5da822b4875494cf365195e8ccfb9653986e143cc8707f5
 SHA512:
-  metadata.gz: afe9866d1912c2323ed2ff5e4c19d72928a1403a406cfbbca11e479a8c61dd4e877c68f0ad5ed9f9b25e002f84f510852161316d1c7fc669c9935c5262742e55
-  data.tar.gz: 9487900e069641c26048da4f4979f3d07ea6873f258e8e8025d0033bf441d4a6c98ee1941060273a6f621e1709fda60c73cd7745c63dba7f0dc0531406e4fa98
+  metadata.gz: a469997825b9876cf81c4e5944414928fe27d9c58233478556cc2923086c4837ebe5ba36033aa2a57765f05000af68f150c88978b5a3fd636769b9dddd3db6a2
+  data.tar.gz: 70e767866d629bb49eb1c2a4fd0f64ed204c68c0c1b5da704125be0c6fa29926e41ddfd1160c9ee98b78f23d99df1484d749d4ebb2ec83594823c6f778048419

data/CHANGELOG.md

@@ -8,6 +8,27 @@ Please mark backwards incompatible changes with an exclamation mark at the start
 
 ## [Unreleased]
 
+## [29.8.0] - 2026-07-06
+
+### Deprecated
+- The `Elasticsearch::QueryBuilder::Script` class is now deprecated, please
+  use `Elasticsearch::Script` instead.
+
+### Added
+- The `#update` method to `JayAPI::Elasticsearch::Client`.
+- The `QueryClauses::IDs` class and the corresponding `#ids` method to the
+  `MatchClauses` module. This allows the use of Elasticsearch's
+  [ids](https://www.elastic.co/docs/reference/query-languages/query-dsl/query-dsl-ids-query)
+  query with the Query Builder.
+
+## [29.7.0] - 2026-04-28
+
+### Added
+- The `#cluster` method to `JayAPI::Elasticsearch::Client`. The method returns
+  an instance of `JayAPI::Elasticsearch::Cluster`.
+- The `Elasticsearch::Cluster` class. The class gives the user access to
+  cluster-level endpoints, currently including cluster health.
+
 ## [29.6.0] - 2026-03-16
 
 ### Deprecated

data/lib/jay_api/elasticsearch/client.rb

@@ -5,6 +5,7 @@ require 'faraday/error'
 require 'forwardable'
 
 require_relative 'mixins/retriable_requests'
+require_relative 'cluster'
 require_relative 'stats'
 require_relative 'tasks'
 
@@ -89,6 +90,20 @@ module JayAPI
       def tasks
         @tasks ||= ::JayAPI::Elasticsearch::Tasks.new(client: self)
       end
+
+      # @return [JayAPI::Elasticsearch::Cluster] An instance of the +Cluster+
+      #   class, which gives the caller access to cluster-related endpoints.
+      def cluster
+        @cluster ||= ::JayAPI::Elasticsearch::Cluster.new(transport_client)
+      end
+
+      # Calls the +Elasticsearch::Client+'s #update method forwarding the given
+      # parameters. If the request fails, additional retries will be performed.
+      # @see Elasticsearch::API::Actions#update for more info about the
+      #   arguments and the return value.
+      def update(**args)
+        retry_request { transport_client.update(**args) }
+      end
     end
   end
 end

data/lib/jay_api/elasticsearch/cluster.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+require_relative 'mixins/retriable_requests'
+
+module JayAPI
+  module Elasticsearch
+    # Represents the Elasticsearch cluster and provides access to
+    # cluster-level APIs.
+    class Cluster
+      extend Forwardable
+
+      def_delegator :cluster_client, :health
+
+      attr_reader :transport_client
+
+      # @param [Elasticsearch::Transport::Client] transport_client The transport
+      #   client to use to make requests to the cluster.
+      def initialize(transport_client)
+        @transport_client = transport_client
+      end
+
+      private
+
+      # @return [Elasticsearch::API::Cluster::ClusterClient] The client used to
+      #   access cluster-related information.
+      def cluster_client
+        @cluster_client ||= transport_client.cluster
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/index.rb

@@ -1,5 +1,8 @@
 # frozen_string_literal: true
 
+require 'active_support'
+require 'active_support/core_ext/object/blank'
+
 require_relative 'indexable'
 require_relative 'indices/settings'
 require_relative 'errors/writable_index_error'
@@ -52,6 +55,46 @@ module JayAPI
         super.first
       end
 
+      # Updates a document by ID.
+      # @param [String] id The ID of the document to update.
+      # @param [Hash, nil] doc The partial document to update the existing
+      #   document with. If +nil+ is given, the +script+ parameter must be
+      #   provided. If both +doc+ and +script+ are given, the +doc+ parameter
+      #   will be ignored by Elasticsearch.
+      # @param [JayAPI::Elasticsearch::Script, Hash, nil] script The script to
+      #   update the existing document with. If +nil+ is given, the +doc+
+      #   parameter must be provided. It's recommended to use a
+      #   +JayAPI::Elasticsearch::Script+ object, but a Hash can also be used.
+      # @return [Hash] A Hash containing information about the updated document.
+      #   An example of such Hash is:
+      #
+      #  {
+      #     "_index" : "xyz01_build_properties",
+      #     "_type" : "_doc",
+      #     "_id" : "ns4AAZ8BXEjZhYMmw-8y",
+      #     "_version" : 7,
+      #     "result" : "updated",
+      #     "_shards" : {
+      #       "total" : 2,
+      #       "successful" : 2,
+      #       "failed" : 0
+      #     },
+      #     "_seq_no" : 11,
+      #     "_primary_term" : 1
+      #   }
+      #
+      # For information on how to use the script and about the contents of the
+      # returned Hash please see:
+      # https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-update
+      # @raise [ArgumentError] If both +doc+ and +script+ are +nil+.
+      # @raise [Elasticsearch::Transport::Transport::ServerError] If the
+      #   update fails.
+      def update(id:, doc: nil, script: nil)
+        raise ArgumentError, "Either 'doc' or 'script' must be provided" if doc.blank? && script.blank?
+
+        client.update(index: index_name, id:, body: { doc: doc, script: script&.to_h }.compact)
+      end
+
       # @return [JayAPI::Elasticsearch::Indices::Settings] The settings for the
       #   index.
       def settings

data/lib/jay_api/elasticsearch/query_builder/aggregations/bucket_selector.rb

@@ -19,8 +19,8 @@ module JayAPI
           #   The keys are the names of the script variables, the values the
           #   paths to the metrics (relative to the parent aggregation).
           #   The script will receive these variables in its +params+.
-          # @param [JayAPI::Elasticsearch::QueryBuilder::Script] script
-          #   Script used to decide whether to keep each bucket.
+          # @param [JayAPI::Elasticsearch::Script] script Script used to decide
+          #   whether to keep each bucket.
           # @param [String, nil] gap_policy Optional gap policy (e.g. "skip",
           #   "insert_zeros").
           def initialize(name, buckets_path:, script:, gap_policy: nil)

data/lib/jay_api/elasticsearch/query_builder/aggregations/terms.rb

@@ -19,10 +19,9 @@ module JayAPI
           # @param [String] name The name used by Elasticsearch to identify each
           #   of the aggregations.
           # @param [String] field The field whose unique values should be counted.
-          # @param [JayAPI::Elasticsearch::QueryBuilder::Script] script If a
-          #   script is given the aggregation will count the unique values
-          #   returned by the script instead of the unique values in a specific
-          #   field.
+          # @param [JayAPI::Elasticsearch::Script] script If a script is given
+          #   the aggregation will count the unique values returned by the
+          #   script instead of the unique values in a specific field.
           # @param [Integer] size By default the aggregation returns the top 10
           #   unique values (the ones with the higher frequency). By specifying
           #   a size this can be changed.

data/lib/jay_api/elasticsearch/query_builder/query_clauses/ids.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require_relative 'query_clause'
+
+module JayAPI
+  module Elasticsearch
+    class QueryBuilder
+      class QueryClauses
+        # Represents an IDs query in Elasticsearch.
+        # Information about this type of query can be found here:
+        # https://www.elastic.co/docs/reference/query-languages/query-dsl/query-dsl-ids-query
+        class IDs < ::JayAPI::Elasticsearch::QueryBuilder::QueryClauses::QueryClause
+          attr_reader :ids
+
+          # @param [Array<String>] ids The ids of the documents to match.
+          def initialize(ids:)
+            super()
+
+            @ids = ids
+          end
+
+          # @return [Hash] The Hash that represents this query (in
+          #   Elasticsearch's DSL)
+          def to_h
+            {
+              ids: {
+                values: ids
+              }
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/query_builder/query_clauses/match_clauses.rb

@@ -1,6 +1,7 @@
 # frozen_string_literal: true
 
 require_relative 'exists'
+require_relative 'ids'
 require_relative 'match_all'
 require_relative 'match_none'
 require_relative 'match_phrase'
@@ -116,6 +117,18 @@ module JayAPI
             self << ::JayAPI::Elasticsearch::QueryBuilder::QueryClauses::Regexp.new(**params)
           end
 
+          # Adds a +JayAPI::Elasticsearch::QueryBuilder::QueryClauses::IDs+
+          # clause to the Query Clauses set.
+          # @param [Hash] params The parameters for the +IDs+ class'
+          #   constructor.
+          # @see JayAPI::Elasticsearch::QueryBuilder::QueryClauses::IDs#initialize
+          # @return [self] Returns itself, so that other methods can be chained.
+          # @raise [JayAPI::Elasticsearch::QueryBuilder::Errors::QueryBuilderError]
+          #   If an error occurs when trying to add the query clause to the set.
+          def ids(**params)
+            self << ::JayAPI::Elasticsearch::QueryBuilder::QueryClauses::IDs.new(**params)
+          end
+
           # Adds a +JayAPI::Elasticsearch::QueryBuilder::QueryClauses::MatchAll+
           # clause to the Query Clauses set.
           # @return [self] Returns itself, so that other methods can be chained.

data/lib/jay_api/elasticsearch/query_builder/script.rb

@@ -1,36 +1,15 @@
 # frozen_string_literal: true
 
+require_relative '../script'
+
 module JayAPI
   module Elasticsearch
     class QueryBuilder
       # Represents a scripted element in a query. This scripted element can be
       # used in different places. It can be used in a query clause, but can
       # also be used to create custom aggregations.
-      class Script
-        attr_reader :source, :lang, :params
-
-        # @param [String] source The source for the script element.
-        # @param [String] lang The language the script is written in.
-        # @param [Hash] params A +Hash+ with key-value pairs for the script's
-        #   parameters.
-        def initialize(source:, lang: 'painless', params: nil)
-          @source = source
-          @lang = lang
-
-          # Keeps the parameters from being modified from the outside after the
-          # class has been initialized.
-          @params = params.dup.freeze
-        end
-
-        # @return [Hash] The hash representation of the scripted element.
-        def to_h
-          {
-            source: source,
-            lang: lang,
-            params: params
-          }.compact
-        end
-      end
+      # @deprecated Use +JayAPI::Elasticsearch::Script+ instead.
+      Script = JayAPI::Elasticsearch::Script
     end
   end
 end

data/lib/jay_api/elasticsearch/script.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module JayAPI
+  module Elasticsearch
+    # Represents a scripted element in Elasticsearch. This scripted element
+    # can be used in different places. It can be used in a query clause, but can
+    # also be used to create custom aggregations or when updating documents.
+    class Script
+      attr_reader :source, :lang, :params
+
+      # @param [String] source The source for the script element.
+      # @param [String] lang The language the script is written in.
+      # @param [Hash] params A +Hash+ with key-value pairs for the script's
+      #   parameters.
+      def initialize(source:, lang: 'painless', params: nil)
+        @source = source
+        @lang = lang
+
+        # Keeps the parameters from being modified from the outside after the
+        # class has been initialized.
+        @params = params.dup.freeze
+      end
+
+      # @return [Hash] The hash representation of the scripted element.
+      def to_h
+        {
+          source: source,
+          lang: lang,
+          params: params
+        }.compact
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch.rb

@@ -4,6 +4,7 @@ require_relative 'elasticsearch/async'
 require_relative 'elasticsearch/batch_counter'
 require_relative 'elasticsearch/client'
 require_relative 'elasticsearch/client_factory'
+require_relative 'elasticsearch/cluster'
 require_relative 'elasticsearch/errors'
 require_relative 'elasticsearch/index'
 require_relative 'elasticsearch/indexes'
@@ -12,6 +13,7 @@ require_relative 'elasticsearch/mixins'
 require_relative 'elasticsearch/query_builder'
 require_relative 'elasticsearch/query_results'
 require_relative 'elasticsearch/response'
+require_relative 'elasticsearch/script'
 require_relative 'elasticsearch/search_after_results'
 require_relative 'elasticsearch/stats'
 require_relative 'elasticsearch/tasks'

data/lib/jay_api/version.rb

@@ -2,5 +2,5 @@
 
 module JayAPI
   # JayAPI gem's semantic version
-  VERSION = '29.6.0'
+  VERSION = '29.8.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jay_api
 version: !ruby/object:Gem::Version
-  version: 29.6.0
+  version: 29.8.0
 platform: ruby
 authors:
 - Accenture-Industry X
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-03-16 00:00:00.000000000 Z
+date: 2026-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -121,6 +121,7 @@ files:
 - lib/jay_api/elasticsearch/batch_counter.rb
 - lib/jay_api/elasticsearch/client.rb
 - lib/jay_api/elasticsearch/client_factory.rb
+- lib/jay_api/elasticsearch/cluster.rb
 - lib/jay_api/elasticsearch/errors.rb
 - lib/jay_api/elasticsearch/errors/elasticsearch_error.rb
 - lib/jay_api/elasticsearch/errors/end_of_query_results_error.rb
@@ -161,6 +162,7 @@ files:
 - lib/jay_api/elasticsearch/query_builder/query_clauses.rb
 - lib/jay_api/elasticsearch/query_builder/query_clauses/bool.rb
 - lib/jay_api/elasticsearch/query_builder/query_clauses/exists.rb
+- lib/jay_api/elasticsearch/query_builder/query_clauses/ids.rb
 - lib/jay_api/elasticsearch/query_builder/query_clauses/match_all.rb
 - lib/jay_api/elasticsearch/query_builder/query_clauses/match_clauses.rb
 - lib/jay_api/elasticsearch/query_builder/query_clauses/match_none.rb
@@ -176,6 +178,7 @@ files:
 - lib/jay_api/elasticsearch/query_builder/script.rb
 - lib/jay_api/elasticsearch/query_results.rb
 - lib/jay_api/elasticsearch/response.rb
+- lib/jay_api/elasticsearch/script.rb
 - lib/jay_api/elasticsearch/search_after_results.rb
 - lib/jay_api/elasticsearch/stats.rb
 - lib/jay_api/elasticsearch/stats/errors/stats_data_not_available.rb