couchbase 3.8.1 → 3.9.0

data/lib/couchbase/get_replica_strategy.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+#  Copyright 2026. Couchbase, Inc.
+#
+#  Licensed under the Apache License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at
+#
+#      http://www.apache.org/licenses/LICENSE-2.0
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+require "couchbase/errors"
+
+module Couchbase
+  # Selects the replica that {Collection#get_replica} reads from.
+  #
+  # @since 3.9.0
+  class GetReplicaStrategy
+    REPLICA_INDEXES = {first: 0, second: 1, third: 2}.freeze
+    private_constant :REPLICA_INDEXES
+
+    # @return [Symbol] the requested replica, one of +:first+, +:second+ or +:third+
+    attr_reader :index
+
+    # @return [Boolean] whether an index that cannot be read resolves to the next replica that can
+    attr_reader :wrap
+
+    private_class_method :new
+
+    # Selects the replica at the given index.
+    #
+    # Without +wrap+, the SDK resolves the index against the vbucket map it already holds. No network round trip
+    # is made for these two errors:
+    # * an index at or beyond the bucket's configured replica count raises {Error::ReplicaIndexOutOfBounds}
+    # * a configured replica the vbucket map places on no node raises {Error::ReplicaIndexCurrentlyUnavailable}
+    #
+    # The replica is chosen from the vbucket map, not from node health. A replica on a node that is down is still
+    # chosen. The read can then wait for that node until the read times out.
+    #
+    # @param [Symbol] index the replica to read from, one of +:first+, +:second+ or +:third+
+    # @param [Boolean] wrap if +true+, an unreadable index moves to the next readable replica. The walk starts at the
+    #   index modulo the configured replica count. A bucket configured without replicas still raises
+    #   {Error::ReplicaIndexOutOfBounds}. If no replica is readable, it still raises
+    #   {Error::ReplicaIndexCurrentlyUnavailable}.
+    #
+    # @raise [Error::InvalidArgument] if +index+ is not one of the supported symbols, or +wrap+ is not a Boolean
+    #
+    # @example Read the first replica, or the next readable one
+    #   collection.get_replica("airline_10", GetReplicaStrategy.from_index(:first, wrap: true))
+    #
+    # @example Bound the wait for a replica whose node is down, then read any copy
+    #   begin
+    #     collection.get_replica("airline_10", GetReplicaStrategy.from_index(:first, wrap: true),
+    #                            Options::GetReplica(timeout: 500))
+    #   rescue Error::UnambiguousTimeout
+    #     collection.get_any_replica("airline_10")
+    #   end
+    #
+    # @return [GetReplicaStrategy]
+    def self.from_index(index, wrap: false)
+      unless REPLICA_INDEXES.key?(index)
+        raise Error::InvalidArgument, "replica index must be one of #{REPLICA_INDEXES.keys.inspect}, but given #{index.inspect}"
+      end
+      raise Error::InvalidArgument, "wrap must be a Boolean, but given #{wrap.inspect}" unless [true, false].include?(wrap)
+
+      new(index, wrap)
+    end
+
+    # @api private
+    def initialize(index, wrap)
+      @index = index
+      @wrap = wrap
+      freeze
+    end
+
+    # @api private
+    def to_backend
+      {
+        replica_index: REPLICA_INDEXES.fetch(@index),
+        wrap: @wrap,
+      }
+    end
+  end
+end

data/lib/couchbase/logger.rb

@@ -69,7 +69,7 @@ module Couchbase
   def self.set_logger(logger, adapter_class: nil, verbose: false, level: :info)
     @logger = logger # rubocop:disable ThreadSafety/ClassInstanceVariable
     if @logger.nil? # rubocop:disable ThreadSafety/ClassInstanceVariable
-      Backend.install_logger_shim(nil)
+      Backend.install_logger_shim(nil, nil)
       return
     end
     shim =

data/lib/couchbase/management/analytics_index_manager.rb

@@ -31,7 +31,7 @@ module Couchbase
           #  dataverse with the specified name already exists.
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -65,7 +65,7 @@ module Couchbase
           #  if the dataverse with the specified name does not exist.
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -103,7 +103,7 @@ module Couchbase
           # @param [String] dataverse_name the name of the dataverse to use (defaults to +nil+)
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -145,7 +145,7 @@ module Couchbase
           # @param [String] dataverse_name the name of the dataverse to use (defaults to +nil+)
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -177,7 +177,7 @@ module Couchbase
           # Creates an instance of options for {AnalyticsIndexManager#get_all_datasets}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -203,7 +203,7 @@ module Couchbase
           # @param [String] dataverse_name the name of the dataverse to use (defaults to +nil+)
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -242,7 +242,7 @@ module Couchbase
           # @param [String] dataverse_name the name of the dataverse to use (defaults to +nil+)
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -274,7 +274,7 @@ module Couchbase
           # Creates an instance of options for {AnalyticsIndexManager#get_all_indexes}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -302,7 +302,7 @@ module Couchbase
           # @param [String] dataverse_name the name of the dataverse to use (defaults to +nil+)
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -343,7 +343,7 @@ module Couchbase
           # @param [String] dataverse_name the name of the dataverse to use (defaults to +nil+)
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -375,7 +375,7 @@ module Couchbase
           # Creates an instance of options for {AnalyticsIndexManager#get_pending_mutations}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -394,7 +394,7 @@ module Couchbase
           # Creates an instance of options for {AnalyticsIndexManager#create_link}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -420,7 +420,7 @@ module Couchbase
           # Creates an instance of options for {AnalyticsIndexManager#replace_link}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -446,7 +446,7 @@ module Couchbase
           # Creates an instance of options for {AnalyticsIndexManager#drop_link}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -483,7 +483,7 @@ module Couchbase
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to
           #   complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #

data/lib/couchbase/management/bucket_manager.rb

@@ -28,7 +28,7 @@ module Couchbase
           # Creates an instance of options for {BucketManager#create_bucket}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -47,7 +47,7 @@ module Couchbase
           # Creates an instance of options for {BucketManager#update_bucket}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -66,7 +66,7 @@ module Couchbase
           # Creates an instance of options for {BucketManager#drop_bucket}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -85,7 +85,7 @@ module Couchbase
           # Creates an instance of options for {BucketManager#get_bucket}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -104,7 +104,7 @@ module Couchbase
           # Creates an instance of options for {BucketManager#get_all_buckets}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -123,7 +123,7 @@ module Couchbase
           # Creates an instance of options for {BucketManager#flush_bucket}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #

data/lib/couchbase/management/collection_manager.rb

@@ -28,7 +28,7 @@ module Couchbase
           # Creates an instance of options for {CollectionManager#get_all_scopes}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -49,7 +49,7 @@ module Couchbase
           # Creates an instance of options for {CollectionManager#create_scope}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -70,7 +70,7 @@ module Couchbase
           # Creates an instance of options for {CollectionManager#drop_scope}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -91,7 +91,7 @@ module Couchbase
           # Creates an instance of options for {CollectionManager#create_collection}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -112,7 +112,7 @@ module Couchbase
           # Creates an instance of options for {CollectionManager#update_collection}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -133,7 +133,7 @@ module Couchbase
           # Creates an instance of options for {CollectionManager#drop_collection}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #

data/lib/couchbase/management/query_index_manager.rb

@@ -33,7 +33,7 @@ module Couchbase
           # @param [String, nil] collection_name the name of the collection
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -79,7 +79,7 @@ module Couchbase
           # @param [String, nil] collection_name the name of the collection
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -137,7 +137,7 @@ module Couchbase
           # @param [String, nil] collection_name the name of the collection
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -189,7 +189,7 @@ module Couchbase
           # @param [String, nil] collection_name the name of the collection
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -232,7 +232,7 @@ module Couchbase
           # @param [String, nil] collection_name the name of the collection
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -272,7 +272,7 @@ module Couchbase
           # @param [String, nil] collection_name the name of the collection
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
@@ -311,7 +311,7 @@ module Couchbase
           # @param [String, nil] scope_name the name of the scope
           # @param [String, nil] collection_name the name of the collection
           #
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Hash, nil] client_context the client context data, if set
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #

data/lib/couchbase/management/search_index_manager.rb

@@ -26,7 +26,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#get_index}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetIndex] self
@@ -46,7 +46,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#get_all_indexes}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetAllIndexes] self
@@ -66,7 +66,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#upsert_index}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [UpsertIndex] self
@@ -86,7 +86,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#drop_index}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [DropIndex] self
@@ -106,7 +106,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#get_indexed_documents_count}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetIndexedDocumentsCount] self
@@ -126,7 +126,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#get_index_stats}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetIndexStats] self
@@ -146,7 +146,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#pause_ingest}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [PauseIngest] self
@@ -166,7 +166,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#resume_ingest}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [ResumeIngest] self
@@ -186,7 +186,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#allow_querying}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [AllowQuerying] self
@@ -206,7 +206,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#disallow_querying}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [DisallowQuerying] self
@@ -226,7 +226,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#freeze_plan}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [FreezePlan] self
@@ -246,7 +246,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#unfreeze_plan}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [UnfreezePlan] self
@@ -266,7 +266,7 @@ module Couchbase
           # Creates an instance of options for {SearchIndexManager#analyze_document}
           #
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [AnalyzeDocument] self

data/lib/couchbase/management/user_manager.rb

@@ -31,7 +31,7 @@ module Couchbase
           # Creates an instance of options for {UserManager#get_user}
           # @param [:local, :external] domain the name of the user's domain. Defaults to +:local+
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetUser] self
@@ -56,7 +56,7 @@ module Couchbase
           # Creates an instance of options for {UserManager#get_all_users}
           # @param [:local, :external] the name of the user's domain. Defaults to +:local+
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetAllUsers] self
@@ -78,7 +78,7 @@ module Couchbase
           # Creates an instance of options for {UserManager#upsert_user}
           # @param [:local, :external] domain the name of the user's domain. Defaults to +:local+
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [UpsertUser] self
@@ -103,7 +103,7 @@ module Couchbase
           # Creates an instance of options for {UserManager#drop_user}
           # @param [:local, :external] domain the name of the user's domain. Defaults to +:local+
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [DropUser] self
@@ -124,7 +124,7 @@ module Couchbase
         class ChangePassword < ::Couchbase::Options::Base
           # Creates an instance of options for {UserManager#change_password}
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [ChangePassword] self
@@ -143,7 +143,7 @@ module Couchbase
         class GetRoles < ::Couchbase::Options::Base
           # Creates an instance of options for {UserManager#get_roles}
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetRoles] self
@@ -162,7 +162,7 @@ module Couchbase
         class GetGroup < ::Couchbase::Options::Base
           # Creates an instance of options for {UserManager#get_group}
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetGroup] self
@@ -181,7 +181,7 @@ module Couchbase
         class GetAllGroups < ::Couchbase::Options::Base
           # Creates an instance of options for {UserManager#get_all_groups}
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [GetAllGroups] self
@@ -200,7 +200,7 @@ module Couchbase
         class UpsertGroup < ::Couchbase::Options::Base
           # Creates an instance of options for {UserManager#upsert_group}
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [UpsertGroup] self
@@ -219,7 +219,7 @@ module Couchbase
         class DropGroup < ::Couchbase::Options::Base
           # Creates an instance of options for {UserManager#drop_group}
           # @param [Integer, #in_milliseconds, nil] timeout the time in milliseconds allowed for the operation to complete
-          # @param [Proc, nil] retry_strategy the custom retry strategy, if set
+          # @param [Symbol, nil] retry_strategy ignored by this operation
           # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
           #
           # @yieldparam [DropGroup] self