jay_api 29.7.0 → 29.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 469981ee390e1c409ff7e4e3faef1d9fb3579e87c9f1e2262f1664ba8d4731c3
-  data.tar.gz: 0f9b84be25dfc1a2f318edb8ae462714553e7898c278e1da0b9e38d211049719
+  metadata.gz: 00a7a3dd5e1e7e2bf232e6f06c8ce6b6e39a31693f4ec2921fb56a1f14e70f63
+  data.tar.gz: 405c629691a82be4e5da822b4875494cf365195e8ccfb9653986e143cc8707f5
 SHA512:
-  metadata.gz: 23f0fd77caa519085f05b6efeff92c128895a912ffa3e75d83703f3b4a7b27cf76e39dfcb42652461fc730c3ff790df67913f0d7f52926ab8bebec86cf02196b
-  data.tar.gz: 48c2c4d5c97ef87fe7ce9ca0809d4b650549db40b654bb7b856438462b6b1c482bdd83f5c11840428fac5f51fc51cbc08cf43bec996f22abdf2e08a4f87050f8
+  metadata.gz: a469997825b9876cf81c4e5944414928fe27d9c58233478556cc2923086c4837ebe5ba36033aa2a57765f05000af68f150c88978b5a3fd636769b9dddd3db6a2
+  data.tar.gz: 70e767866d629bb49eb1c2a4fd0f64ed204c68c0c1b5da704125be0c6fa29926e41ddfd1160c9ee98b78f23d99df1484d749d4ebb2ec83594823c6f778048419

data/CHANGELOG.md

@@ -8,6 +8,19 @@ 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

data/lib/jay_api/elasticsearch/client.rb

@@ -96,6 +96,14 @@ module JayAPI
       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/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

@@ -13,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.7.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.7.0
+  version: 29.8.0
 platform: ruby
 authors:
 - Accenture-Industry X
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-28 00:00:00.000000000 Z
+date: 2026-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -162,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
@@ -177,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