jay_api 29.4.0 → 29.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 03ef39a19b2ff79bf0aea18958f4c0ea7d2b77f87f502c85fbaa793dc191af29
-  data.tar.gz: 5abb8d21871415133f2d95cab6090b2ee8d224d7056349dbf2b667873d3ea257
+  metadata.gz: a1cec24f42607c2e94f600045f41f8c5db2593ebd478f391f9c97786d139b819
+  data.tar.gz: f35ecb6ce96aa5215d3a97229e4ee497697b57daa2ffa36b607d5d4d88a7bb3d
 SHA512:
-  metadata.gz: aceb3ee3bc16cee43009c8c48e079f31eed730be5ae560c1974d660dd5ac4a385648cb329a9ef9d191f0ae2358915fd311fe0d81a1ddcd5ecac8ac806ae7a17d
-  data.tar.gz: cf762fbc558af858e560a83b4bcbc57574ac9ab0ffecb7fdbebb51254008550079a4f36beec32e19ea7b58e4187ae69f06e4e1c48e8ff1aae5835691e12b6072
+  metadata.gz: afe9866d1912c2323ed2ff5e4c19d72928a1403a406cfbbca11e479a8c61dd4e877c68f0ad5ed9f9b25e002f84f510852161316d1c7fc669c9935c5262742e55
+  data.tar.gz: 9487900e069641c26048da4f4979f3d07ea6873f258e8e8025d0033bf441d4a6c98ee1941060273a6f621e1709fda60c73cd7745c63dba7f0dc0531406e4fa98

data/CHANGELOG.md

@@ -8,6 +8,46 @@ Please mark backwards incompatible changes with an exclamation mark at the start
 
 ## [Unreleased]
 
+## [29.6.0] - 2026-03-16
+
+### Deprecated
+- The `#task_by_id` method of the `Elasticsearch::Client` class.
+
+### Added
+- The `#all` method to `JayAPI::Elasticsearch::Tasks`. The method returns the
+  status of all running tasks on the Elasticsearch cluster.
+- The `#tasks` method to `JayAPI::Elasticsearch::Client`. The method returns an
+  instance of `JayAPI::Elasticsearch::Tasks`, which gives the user access to the
+  status of the tasks running on the Elasticsearch cluster.
+
+## [29.5.0] - 2026-02-23
+
+### Fixed
+- A `NameError` that was being raised when `jay_api/elasticsearch/client` was
+  required without requiring `elasticsearch`.
+- A `NoMethodError` that was being raised by `Elasticsearch::Stats::Indices`
+  when `active_support/core_ext/string` hadn't been loaded.
+
+### Added
+- The `#force_merge` method to the `Elasticsearch::Index` class. This method
+  starts a Forced Segment Merge on the index.
+- The `#totals` method to `Elasticsearch::Stats::Index`, this gives the caller
+  access to the index's total metrics.
+- The `Elasticsearch::Stats::Index::Totals` class. The class contains information
+  about an index's total metrics, for example, total number of documents, total
+  size, etc.
+- The `#settings` method to the `Elasticsearch::Index` class. This gives the
+  caller access to the index's settings.
+- The `Elasticsearch::Indices::Settings::Blocks` class. The class encapsulates
+  an index's blocks settings (for example, whether the index is read-only).
+- The `Elasticsearch::Indices::Settings` class. The class encapsulates an
+  index's settings.
+- It is now possible to configure the type used by the `RSpec::TestDataCollector`
+  class when pushing documents to Elasticsearch. If no type is specified in the
+  configuration the default type will be used.
+- Allow the `Elasticsearch::Index` and `Elasticsearch::Indexes`'s `#push` method
+  to receive a `type` parameter, just like `#index` does.
+
 ## [29.4.0] - 2026-01-28
 
 ### Added

data/lib/jay_api/elasticsearch/client.rb

@@ -1,39 +1,23 @@
 # frozen_string_literal: true
 
-require 'elasticsearch/api/namespace/tasks'
-require 'elasticsearch/transport/transport/errors'
+require 'timeout'
 require 'faraday/error'
 require 'forwardable'
 
-require_relative '../abstract/connection'
+require_relative 'mixins/retriable_requests'
 require_relative 'stats'
+require_relative 'tasks'
 
 module JayAPI
   module Elasticsearch
-    # The JayAPI wrapper class over the Elastisearch::Client object. It mirrors
+    # The JayAPI wrapper class over the +Elasticsearch::Client+ object. It mirrors
     # the object's API, but if one of the ERRORS is raised, this Wrapper class will
     # rescue the error up to a few times and re-try the connection. This way the
     # connection to Elasticsearch will be more robust.
     class Client
       extend Forwardable
 
-      # The errors that, if raised, must cause a retry of the connection.
-      ERRORS = [
-        ::Elasticsearch::Transport::Transport::ServerError,
-        Faraday::TimeoutError
-      ].freeze
-
-      # Subclasses of the +Elasticsearch::Transport::Transport::ServerError+
-      # for which a retry doesn't make sense.
-      NON_RETRIABLE_ERRORS = [
-        ::Elasticsearch::Transport::Transport::Errors::BadRequest,
-        ::Elasticsearch::Transport::Transport::Errors::Unauthorized,
-        ::Elasticsearch::Transport::Transport::Errors::Forbidden,
-        ::Elasticsearch::Transport::Transport::Errors::NotFound,
-        ::Elasticsearch::Transport::Transport::Errors::MethodNotAllowed,
-        ::Elasticsearch::Transport::Transport::Errors::RequestEntityTooLarge,
-        ::Elasticsearch::Transport::Transport::Errors::NotImplemented
-      ].freeze
+      include JayAPI::Elasticsearch::Mixins::RetriableRequests
 
       attr_reader :transport_client, :logger, :max_attempts, :wait_strategy
 
@@ -88,6 +72,7 @@ module JayAPI
       # parameters. If the request fails, additional retries will be performed.
       # @see Elasticsearch::Client#tasks for more info about the arguments and
       #   the return value.
+      # @deprecated Use Tasks#by_id instead.
       def task_by_id(**args)
         retry_request { transport_client.tasks.get(**args) }
       end
@@ -98,13 +83,11 @@ module JayAPI
         @stats ||= ::JayAPI::Elasticsearch::Stats.new(transport_client)
       end
 
-      private
-
-      # @param [Proc] block The block to execute.
-      # @yieldreturn [Object] Whatever the block returns
-      def retry_request(&block)
-        Abstract::Connection.new(max_attempts: max_attempts, wait_strategy: wait_strategy.dup, logger: logger)
-                            .retry(errors: ERRORS, except: NON_RETRIABLE_ERRORS, &block)
+      # @return [JayAPI::Elasticsearch::Tasks] An instance of the +Tasks+ class,
+      #   which can be used to retrieve the status of the tasks running on the
+      #   Elasticsearch cluster.
+      def tasks
+        @tasks ||= ::JayAPI::Elasticsearch::Tasks.new(client: self)
       end
     end
   end

data/lib/jay_api/elasticsearch/errors/writable_index_error.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require_relative '../../errors/error'
+
+module JayAPI
+  module Elasticsearch
+    module Errors
+      # An error to be raised when an attempt is made to perform force_merge
+      # over an index which hasn't been set to be read-only.
+      class WritableIndexError < ::JayAPI::Errors::Error; end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/errors.rb

@@ -6,6 +6,7 @@ require_relative 'errors/query_execution_error'
 require_relative 'errors/query_execution_failure'
 require_relative 'errors/query_execution_timeout'
 require_relative 'errors/search_after_error'
+require_relative 'errors/writable_index_error'
 
 module JayAPI
   module Elasticsearch

data/lib/jay_api/elasticsearch/index.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require_relative 'indexable'
+require_relative 'indices/settings'
+require_relative 'errors/writable_index_error'
 
 module JayAPI
   module Elasticsearch
@@ -49,6 +51,36 @@ module JayAPI
       def index(data, type: DEFAULT_DOC_TYPE)
         super.first
       end
+
+      # @return [JayAPI::Elasticsearch::Indices::Settings] The settings for the
+      #   index.
+      def settings
+        # DO NOT MEMOIZE! Leave it to the caller.
+        ::JayAPI::Elasticsearch::Indices::Settings.new(client.transport_client, index_name)
+      end
+
+      # Starts a Forced Segment Merge process on the index.
+      #
+      # ⚠️ For big indexes this process can take a very long time, make sure to
+      #    adjust the timeout when creating the client.
+      # @param [Boolean] only_expunge_deletes Specifies whether the operation
+      #   should only remove deleted documents.
+      # @raise [JayAPI::Elasticsearch::Errors::WritableIndexError] If the index
+      #   is writable (hasn't been set to read-only).
+      # @return [Hash] A +Hash+ with the result of the index merging process,
+      #   it looks like this:
+      #
+      #   { "_shards" => { "total" => 10, "successful" => 10, "failed" => 0 } }
+      def force_merge(only_expunge_deletes: nil)
+        unless settings.blocks.write_blocked?
+          raise ::JayAPI::Elasticsearch::Errors::WritableIndexError,
+                "Write block for '#{index_name}' has not been enabled. " \
+                "Please enable the index's write block before performing a segment merge"
+        end
+
+        params = { index: index_name, only_expunge_deletes: }.compact
+        client.transport_client.indices.forcemerge(**params)
+      end
     end
   end
 end

data/lib/jay_api/elasticsearch/indexable.rb

@@ -48,9 +48,13 @@ module JayAPI
       # Pushes a record into the index. (This does not send the record to the
       # Elasticsearch instance, only puts it into the send queue).
       # @param [Hash] data The data to be pushed to the index.
-      def push(data)
+      # @param [String, nil] type The type of the document. When set to +nil+
+      #   the decision is left to Elasticsearch's API. Which will normally
+      #   default to +_doc+.
+      def push(data, type: DEFAULT_DOC_TYPE)
+        validate_type(type)
         index_names.each do |index_name|
-          batch << { index: { _index: index_name, _type: 'nested', data: data } }
+          batch << { index: { _index: index_name, _type: type, data: data }.compact }
         end
 
         flush! if batch.size >= batch_size
@@ -78,8 +82,7 @@ module JayAPI
       # For information on the contents of this Hash please see:
       # https://www.elastic.co/guide/en/elasticsearch/reference/current/docs-index_.html#docs-index-api-response-body
       def index(data, type: DEFAULT_DOC_TYPE)
-        raise ArgumentError, "Unsupported type: '#{type}'" unless SUPPORTED_TYPES.include?(type)
-
+        validate_type(type)
         index_names.map { |index_name| client.index index: index_name, type: type, body: data }
       end
 
@@ -220,6 +223,15 @@ module JayAPI
       def async
         @async ||= JayAPI::Elasticsearch::Async.new(self)
       end
+
+      # @param [String, nil] type The type of the document. When set to +nil+
+      #   the decision is left to Elasticsearch's API. Which will normally
+      #   default to +_doc+.
+      # @raise [ArgumentError] When the given +type+ is not one of the
+      #   +SUPPORTED_TYPES+
+      def validate_type(type)
+        raise ArgumentError, "Unsupported type: '#{type}'" unless SUPPORTED_TYPES.include?(type)
+      end
     end
   end
 end

data/lib/jay_api/elasticsearch/indices/settings/blocks.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module JayAPI
+  module Elasticsearch
+    module Indices
+      class Settings
+        # Represents the block settings of an Elasticsearch index.
+        class Blocks
+          attr_reader :settings
+
+          # @param [JayAPI::Elasticsearch::Indices::Settings] settings The
+          #   parent +Settings+ object.
+          def initialize(settings)
+            @settings = settings
+          end
+
+          # @return [Boolean] True if the Index's write block has been set to
+          #   true, false otherwise.
+          def write_blocked?
+            blocks_settings.fetch('write') == 'true'
+          end
+
+          # Sets the index's +write+ block to the given value. When the +write+
+          # block is set to +true+ the index's data is read-only, but the
+          # index's settings can still be changed. This allows maintenance tasks
+          # to still be performed on the index.
+          # @param [Boolean] value The new value for the +write+ block of the
+          #   index.
+          # @raise [Elasticsearch::Transport::Transport::Errors::ServerError] If
+          #   an error occurs when trying to set the value of the block.
+          def write=(value)
+            unless [true, false].include?(value)
+              raise ArgumentError, "Expected 'value' to be true or false, #{value.class} given"
+            end
+
+            return if write_blocked? == value
+
+            settings.transport_client.indices.put_settings(
+              index: settings.index_name,
+              body: { 'blocks.write' => value }
+            )
+          end
+
+          private
+
+          # @return [Hash] The block settings of the index. Something like this:
+          #
+          #  { 'read_only_allow_delete' => 'false', 'write' => 'false' }
+          #
+          # @raise [KeyError] If the index's settings do not contain a "blocks"
+          #   section.
+          def blocks_settings
+            settings.all.fetch('blocks')
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/indices/settings.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require_relative 'settings/blocks'
+
+module JayAPI
+  module Elasticsearch
+    module Indices
+      # Represents the settings of an Elasticsearch Index.
+      class Settings
+        attr_reader :transport_client, :index_name
+
+        # @param [Elasticsearch::Transport::Client] transport_client Elasticsearch's
+        #   transport client.
+        # @param [String] index_name The name of the index this class will be
+        #   handling settings for.
+        def initialize(transport_client, index_name)
+          @transport_client = transport_client
+          @index_name = index_name
+        end
+
+        # @return [Hash] A Hash with all the settings for the index. It looks
+        #   like this:
+        #
+        #   {
+        #     "number_of_shards" => "5",
+        #     "blocks" => { "read_only_allow_delete" => "false", "write" => "false" },
+        #     "provided_name" => "xyz01_tests",
+        #     "creation_date" => "1588701800423",
+        #     "number_of_replicas" => "1",
+        #     "uuid" => "VFx2e5t0Qgi-1zc2PUkYEg",
+        #     "version" => { "created" => "7010199", "upgraded" => "7100299"}
+        #   }
+        #
+        # @raise [Elasticsearch::Transport::Transport::Errors::ServerError] If
+        #   an error occurs when trying to get the index's settings.
+        # @raise [KeyError] If any of the expected hierarchical elements in the
+        #   response are missing.
+        def all
+          transport_client.indices.get_settings(index: index_name)
+                          .fetch(index_name).fetch('settings').fetch('index')
+        end
+
+        # @return [JayAPI::Elasticsearch::Indices::Settings::Blocks] The blocks
+        #   settings for the given index.
+        def blocks
+          @blocks ||= ::JayAPI::Elasticsearch::Indices::Settings::Blocks.new(self)
+        end
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/indices.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'indices/settings'
+
+module JayAPI
+  module Elasticsearch
+    # Namespace for sub-elements of Elasticsearch's indices
+    module Indices; end
+  end
+end

data/lib/jay_api/elasticsearch/mixins/retriable_requests.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require 'elasticsearch/transport/transport/errors'
+
+require_relative '../../abstract/connection'
+
+module JayAPI
+  module Elasticsearch
+    module Mixins
+      # A mixin that allows the including class to retry requests to
+      # Elasticsearch by leveraging the +Abstract::Connection+ class'
+      # capabilities.
+      module RetriableRequests
+        # The errors that, if raised, must cause a retry of the connection.
+        RETRIABLE_ERRORS = [
+          ::Elasticsearch::Transport::Transport::ServerError,
+          Faraday::TimeoutError
+        ].freeze
+
+        # Subclasses of the +Elasticsearch::Transport::Transport::ServerError+
+        # for which a retry doesn't make sense.
+        NON_RETRIABLE_ERRORS = [
+          ::Elasticsearch::Transport::Transport::Errors::BadRequest,
+          ::Elasticsearch::Transport::Transport::Errors::Unauthorized,
+          ::Elasticsearch::Transport::Transport::Errors::Forbidden,
+          ::Elasticsearch::Transport::Transport::Errors::NotFound,
+          ::Elasticsearch::Transport::Transport::Errors::MethodNotAllowed,
+          ::Elasticsearch::Transport::Transport::Errors::RequestEntityTooLarge,
+          ::Elasticsearch::Transport::Transport::Errors::NotImplemented
+        ].freeze
+
+        # @return [Integer] The maximum number of times a request should be
+        #   retried before giving up.
+        def max_attempts
+          raise_not_implemented(__method__)
+        end
+
+        # @return [JayAPI::Elasticsearch::WaitStrategy] The waiting strategy for
+        #   retries.
+        def wait_strategy
+          raise_not_implemented(__method__)
+        end
+
+        # @return [Logging::Logger] A logger to log messages.
+        def logger
+          raise_not_implemented(__method__)
+        end
+
+        # @return [Array<Class>] The array of errors that, if raised, must cause
+        #   a retry of the request.
+        def retriable_errors
+          RETRIABLE_ERRORS
+        end
+
+        # @return [Array<Class>] An array of subclasses of the
+        #   +Elasticsearch::Transport::Transport::ServerError+ for which a retry
+        #   doesn't make sense.
+        def non_retriable_errors
+          NON_RETRIABLE_ERRORS
+        end
+
+        private
+
+        # Uses the +Abstract::Connection+ class to retry the request enclosed in
+        #   the given block.
+        def retry_request(&)
+          Abstract::Connection.new(max_attempts:, wait_strategy: wait_strategy.dup, logger:)
+                              .retry(errors: retriable_errors, except: non_retriable_errors, &)
+        end
+
+        # @raise [NotImplementedError] Is always raised with the appropriate
+        #   error message.
+        def raise_not_implemented(method)
+          raise NotImplementedError, "Please implement the method ##{method} in #{self.class}"
+        end
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/mixins.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+require_relative 'mixins/retriable_requests'
+
+module JayAPI
+  module Elasticsearch
+    # A namespace for Elasticsearch related mixins.
+    module Mixins; end
+  end
+end

data/lib/jay_api/elasticsearch/stats/index/totals.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module JayAPI
+  module Elasticsearch
+    class Stats
+      class Index
+        # Contains information about an index's totals (docs, used space, etc).
+        class Totals
+          # @param [Hash] data The data under the index's +total+ key.
+          def initialize(data)
+            @data = data
+          end
+
+          # @return [Integer] The total number of documents in the index.
+          def docs_count
+            @docs_count ||= docs.fetch('count')
+          end
+
+          # @return [Integer] The total number of deleted documents in the index.
+          def deleted_docs
+            @deleted_docs ||= docs.fetch('deleted')
+          end
+
+          # @return [Float] A number between 0 and 1 that represents the ratio
+          #   of between deleted documents and total documents in the index.
+          def deleted_ratio
+            @deleted_ratio ||= calculate_deleted_ratio
+          end
+
+          private
+
+          attr_reader :data
+
+          # @return [Hash] The information about the documents in the index.
+          #   Looks something like this:
+          #
+          #   { "count" => 530626, "deleted" => 11 }
+          #
+          # @raise [KeyError] If the given data doesn't have a +docs+ key.
+          def docs
+            @docs ||= data.fetch('docs')
+          end
+
+          # @return [Float] A number between 0 and 1 that represents the ratio
+          #   of between deleted documents and total documents in the index.
+          def calculate_deleted_ratio
+            if docs_count.zero?
+              return deleted_docs.zero? ? 0.0 : 1.0
+            end
+
+            deleted_docs / docs_count.to_f
+          end
+        end
+      end
+    end
+  end
+end

data/lib/jay_api/elasticsearch/stats/index.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative 'index/totals'
+
 module JayAPI
   module Elasticsearch
     class Stats
@@ -13,6 +15,17 @@ module JayAPI
           @name = name
           @data = data
         end
+
+        # @return [JayAPI::Elasticsearch::Stats::Index::Totals] Information
+        #   about the index's total metrics.
+        # @raise [KeyError] If the given data doesn't have a +total+ key.
+        def totals
+          @totals ||= ::JayAPI::Elasticsearch::Stats::Index::Totals.new(data.fetch('total'))
+        end
+
+        private
+
+        attr_reader :data
       end
     end
   end

data/lib/jay_api/elasticsearch/stats/indices.rb

@@ -10,7 +10,7 @@ module JayAPI
       class Indices
         # A lambda used to select / reject system indices (indices whose name
         # starts with dot).
-        SYSTEM_SELECTOR = ->(name, _data) { name.starts_with?('.') }
+        SYSTEM_SELECTOR = ->(name, _data) { name.start_with?('.') }
 
         # @param [Hash{String=>Hash}] indices A +Hash+ with the information
         #   about the indices. Its keys are the names of the indices, its values

data/lib/jay_api/elasticsearch/tasks.rb

@@ -1,22 +1,52 @@
 # frozen_string_literal: true
 
 require 'active_support'
+require 'active_support/core_ext/enumerable'
 require 'active_support/core_ext/hash/indifferent_access'
+require 'forwardable'
+
+require_relative 'mixins/retriable_requests'
 
 module JayAPI
   module Elasticsearch
     # Represents Elasticsearch tasks. Returns information about the tasks
     # currently executing in the cluster.
-    # TODO: Add #all [JAY-593]
     class Tasks
+      extend Forwardable
+      include ::JayAPI::Elasticsearch::Mixins::RetriableRequests
+
       attr_reader :client
 
+      def_delegators :client, :transport_client, :max_attempts, :wait_strategy, :logger
+
       # @param [JayAPI::Elasticsearch::Client] client The Elasticsearch Client
       #   object
       def initialize(client:)
         @client = client
       end
 
+      # Gets the list of tasks running on the Elasticsearch cluster.
+      # For more information about this endpoint and the parameters please see:
+      # https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-tasks-list
+      # @param [Array<String>] actions A list of actions. Only tasks matching
+      #   these actions will be returned, if no task matches the result will be
+      #   empty.
+      # @param [Boolean] detailed Whether or not the result should include task
+      #   details or not.
+      # @return [Hash] A hash with the list of tasks running on the
+      #   Elasticsearch cluster.
+      def all(actions: nil, detailed: false)
+        # Needed because unlike many Elasticsearch methods Tasks#list doesn't
+        # call #listify over +actions+.
+        actions = actions&.then do |value|
+          value.is_a?(Array) ? value.join(',') : value
+        end
+
+        retry_request do
+          tasks_client.list({ actions:, detailed: }.compact_blank)
+        end
+      end
+
       # Retrieves info about the task with the passed +task_id+
       # For more information on how to build the query please refer to the
       # Elasticsearch DSL documentation:
@@ -29,7 +59,17 @@ module JayAPI
       # @raise [Elasticsearch::Transport::Transport::ServerError] If the
       #   query fails.
       def by_id(task_id)
-        client.task_by_id(task_id: task_id, wait_for_completion: true).deep_symbolize_keys
+        retry_request do
+          tasks_client.get(task_id:, wait_for_completion: true).deep_symbolize_keys
+        end
+      end
+
+      private
+
+      # @return [Elasticsearch::API::Tasks::TasksClient] The client used to
+      #   access tasks-related information.
+      def tasks_client
+        @tasks_client ||= transport_client.tasks
       end
     end
   end

data/lib/jay_api/elasticsearch.rb

@@ -7,6 +7,8 @@ require_relative 'elasticsearch/client_factory'
 require_relative 'elasticsearch/errors'
 require_relative 'elasticsearch/index'
 require_relative 'elasticsearch/indexes'
+require_relative 'elasticsearch/indices'
+require_relative 'elasticsearch/mixins'
 require_relative 'elasticsearch/query_builder'
 require_relative 'elasticsearch/query_results'
 require_relative 'elasticsearch/response'

data/lib/jay_api/rspec/test_data_collector.rb

@@ -79,7 +79,7 @@ module JayAPI
           }
         }
 
-        elasticsearch_index.push(data)
+        elasticsearch_index.push(data, **push_params)
       end
 
       # Executed by RSpec at the end of the test run. If the push is enabled,
@@ -94,6 +94,14 @@ module JayAPI
 
       attr_reader :push_enabled
 
+      # @return [Hash] Additional parameters for the Elasticsearch::Index#push.
+      def push_params
+        # The extraction of the parameters is done with a #slice to be able to
+        # differentiate between when the parameter is not specified (completely
+        # absent) or when the parameter has been specified as +nil+.
+        @push_params ||= configuration.to_h.slice(:type)
+      end
+
       # @return [Hash] The configuration set for Elasticsearch as a hash. If no
       #   value has been set for the batch size a reasonable default is set.
       # @raise [JayAPI::Errors::ConfigurationError] If no configuration for

data/lib/jay_api/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: jay_api
 version: !ruby/object:Gem::Version
-  version: 29.4.0
+  version: 29.6.0
 platform: ruby
 authors:
 - Accenture-Industry X
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-28 00:00:00.000000000 Z
+date: 2026-03-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -128,9 +128,15 @@ files:
 - lib/jay_api/elasticsearch/errors/query_execution_failure.rb
 - lib/jay_api/elasticsearch/errors/query_execution_timeout.rb
 - lib/jay_api/elasticsearch/errors/search_after_error.rb
+- lib/jay_api/elasticsearch/errors/writable_index_error.rb
 - lib/jay_api/elasticsearch/index.rb
 - lib/jay_api/elasticsearch/indexable.rb
 - lib/jay_api/elasticsearch/indexes.rb
+- lib/jay_api/elasticsearch/indices.rb
+- lib/jay_api/elasticsearch/indices/settings.rb
+- lib/jay_api/elasticsearch/indices/settings/blocks.rb
+- lib/jay_api/elasticsearch/mixins.rb
+- lib/jay_api/elasticsearch/mixins/retriable_requests.rb
 - lib/jay_api/elasticsearch/query_builder.rb
 - lib/jay_api/elasticsearch/query_builder/aggregations.rb
 - lib/jay_api/elasticsearch/query_builder/aggregations/aggregation.rb
@@ -174,6 +180,7 @@ files:
 - lib/jay_api/elasticsearch/stats.rb
 - lib/jay_api/elasticsearch/stats/errors/stats_data_not_available.rb
 - lib/jay_api/elasticsearch/stats/index.rb
+- lib/jay_api/elasticsearch/stats/index/totals.rb
 - lib/jay_api/elasticsearch/stats/indices.rb
 - lib/jay_api/elasticsearch/stats/node.rb
 - lib/jay_api/elasticsearch/stats/node/storage.rb
@@ -220,7 +227,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
+rubygems_version: 3.4.19
 signing_key:
 specification_version: 4
 summary: A collection of classes and modules to access JAY's functionality