couchbase 3.8.1 → 3.8.2

data/ext/couchbase/core/transactions/waitable_op_list.hxx

@@ -79,6 +79,15 @@ public:
     // we have the lock.  Block all further ops
     allow_ops_ = false;
   }
+  // Peek at whether query mode has already been entered.  Briefly acquires mutex_ but, unlike
+  // get_mode(), never waits on cv_query_ for the query node to be set, so it returns immediately.
+  // Used by defensive invariant checks: a KV mutation must never be staged once query mode is
+  // entered.
+  auto query_mode_entered() const -> bool
+  {
+    const std::scoped_lock lock(mutex_);
+    return mode_.mode == attempt_mode::modes::QUERY;
+  }
   auto get_mode() -> attempt_mode
   {
     std::unique_lock<std::mutex> lock(mutex_);
@@ -143,8 +152,10 @@ public:
   {
     // when begin work errors out, it is fatal, so reset to kv mode here, allowing
     // rollback to function properly.
-    std::unique_lock<std::mutex> lock;
+    const std::scoped_lock lock(mutex_);
     mode_.mode = attempt_mode::modes::KV;
+    // query_node is intentionally left populated: a retry runs with a fresh waitable_op_list, and
+    // get_mode()'s wait predicate keys on query_node, so clearing it here would serve no purpose.
     cv_query_.notify_all();
   }
 
@@ -199,6 +210,6 @@ private:
   std::condition_variable cv_ops_;
   std::condition_variable cv_query_;
   std::condition_variable cv_in_flight_;
-  std::mutex mutex_;
+  mutable std::mutex mutex_;
 };
 } // namespace couchbase::core::transactions

data/ext/couchbase/couchbase/cluster.hxx

@@ -97,6 +97,39 @@ public:
   auto operator=(const cluster& other) -> cluster& = default;
   auto operator=(cluster&& other) -> cluster& = default;
 
+  /**
+   * Notify the cluster of a fork-related event, so it can keep its I/O usable
+   * across @c fork().
+   *
+   * Call it three times, in this order: @ref fork_event::prepare in the parent
+   * before forking, then @ref fork_event::child in the child and @ref
+   * fork_event::parent in the parent.
+   *
+   * NOTE: @ref fork_event::child reconnects this cluster on a fresh set of
+   * sockets, because the inherited ones belong to the parent. Any @ref bucket,
+   * @ref scope or @ref collection handle obtained before the fork still refers to
+   * the pre-fork connections, so in the child those handles must be re-acquired
+   * from the cluster -- using a stale one fails with @ref
+   * errc::network::cluster_closed. Handles held in the parent stay valid.
+   *
+   * This function must not be called while operations are in flight on this
+   * cluster from another thread.
+   *
+   * On platforms without @c fork(), Windows in particular, this function does
+   * nothing. It remains callable everywhere so that portable code does not have to
+   * guard the calls, but nothing about the cluster changes.
+   *
+   * @param event the fork-related event that is about to happen, or just happened.
+   *
+   * @throws std::system_error if the I/O backend cannot be carried across the fork.
+   * There is no recovery for this: the cluster's io_context is unusable afterwards
+   * and the only thing left to do with the cluster is destroy it. It is reported
+   * rather than swallowed because a caller that went on using such a cluster would
+   * be operating on a reactor that no longer tracks its sockets.
+   *
+   * @since 1.0.0
+   * @uncommitted
+   */
   void notify_fork(fork_event event);
 
   void close(std::function<void()>&& handler);

data/lib/couchbase/cluster.rb

@@ -326,20 +326,22 @@ module Couchbase
     #
     # @return [PingResult]
     def ping(options = Options::Ping::DEFAULT)
-      resp = @backend.ping(nil, options.to_backend)
-      PingResult.new do |res|
-        res.version = resp[:version]
-        res.id = resp[:id]
-        res.sdk = resp[:sdk]
-        resp[:services].each do |type, svcs|
-          res.services[type] = svcs.map do |svc|
-            PingResult::ServiceInfo.new do |info|
-              info.id = svc[:id]
-              info.state = svc[:state]
-              info.latency = svc[:latency]
-              info.remote = svc[:remote]
-              info.local = svc[:local]
-              info.error = svc[:error]
+      @observability.record_operation(Observability::OP_PING, options.parent_span, self) do |_obs_handler|
+        resp = @backend.ping(nil, options.to_backend)
+        PingResult.new do |res|
+          res.version = resp[:version]
+          res.id = resp[:id]
+          res.sdk = resp[:sdk]
+          resp[:services].each do |type, svcs|
+            res.services[type] = svcs.map do |svc|
+              PingResult::ServiceInfo.new do |info|
+                info.id = svc[:id]
+                info.state = svc[:state]
+                info.latency = svc[:latency]
+                info.remote = svc[:remote]
+                info.local = svc[:local]
+                info.error = svc[:error]
+              end
             end
           end
         end

data/lib/couchbase/options.rb

@@ -1919,20 +1919,25 @@ module Couchbase
       attr_accessor :report_id # @return [String]
       attr_accessor :service_types # @return [Array<Symbol>]
       attr_accessor :timeout # @return [Integer, #in_milliseconds]
+      attr_accessor :parent_span # @return [Span, nil]
 
       # Creates an instance of options for {Couchbase::Bucket#ping}
       #
       # @param [String] report_id Holds custom report id.
-      # @@param [Array<Symbol>] service_types The service types to limit this diagnostics request
+      # @param [Array<Symbol>] service_types The service types to limit this ping request
       # @param [Integer, #in_milliseconds] timeout
+      # @param [Span, nil] parent_span if set holds the parent span, that should be used for this request
       #
       # @yieldparam [Ping] self
       def initialize(report_id: nil,
                      service_types: [:kv, :query, :analytics, :search, :views, :management],
-                     timeout: nil)
+                     timeout: nil,
+                     parent_span: nil)
         @report_id = report_id
         @service_types = service_types
         @timeout = timeout
+        @parent_span = parent_span
+
         yield self if block_given?
       end
 

data/lib/couchbase/version.rb

@@ -21,5 +21,5 @@ module Couchbase
   #   $ ruby -rcouchbase -e 'pp Couchbase::VERSION'
   #   {:sdk=>"3.4.0", :ruby_abi=>"3.1.0", :revision=>"416fe68e6029ec8a4c40611cf6e6b30d3b90d20f"}
   VERSION = {} unless defined?(VERSION) # rubocop:disable Style/MutableConstant
-  VERSION.update(:sdk => "3.8.1")
+  VERSION.update(:sdk => "3.8.2")
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: couchbase
 version: !ruby/object:Gem::Version
-  version: 3.8.1
+  version: 3.8.2
 platform: ruby
 authors:
 - Sergey Avseyev
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2026-07-01 00:00:00.000000000 Z
+date: 2026-09-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -2584,6 +2584,7 @@ files:
 - ext/couchbase/core/impl/with_legacy_durability.hxx
 - ext/couchbase/core/io/config_tracker.cxx
 - ext/couchbase/core/io/config_tracker.hxx
+- ext/couchbase/core/io/configuration_belongs_to_session.hxx
 - ext/couchbase/core/io/dns_client.cxx
 - ext/couchbase/core/io/dns_client.hxx
 - ext/couchbase/core/io/dns_codec.hxx
@@ -3670,9 +3671,9 @@ metadata:
   homepage_uri: https://docs.couchbase.com/ruby-sdk/current/hello-world/start-using-sdk.html
   bug_tracker_uri: https://jira.issues.couchbase.com/browse/RCBC
   mailing_list_uri: https://www.couchbase.com/forums/c/ruby-sdk
-  source_code_uri: https://github.com/couchbase/couchbase-ruby-client/tree/3.8.1
-  changelog_uri: https://github.com/couchbase/couchbase-ruby-client/releases/tag/3.8.1
-  documentation_uri: https://docs.couchbase.com/sdk-api/couchbase-ruby-client-3.8.1/index.html
+  source_code_uri: https://github.com/couchbase/couchbase-ruby-client/tree/3.8.2
+  changelog_uri: https://github.com/couchbase/couchbase-ruby-client/releases/tag/3.8.2
+  documentation_uri: https://docs.couchbase.com/sdk-api/couchbase-ruby-client-3.8.2/index.html
   github_repo: https://github.com/couchbase/couchbase-ruby-client
   rubygems_mfa_required: 'true'
 post_install_message: