couchbase 4.3.1 → 4.4.0

package/deps/couchbase-cxx-client/core/transactions/transactions_cleanup.cxx

@@ -29,6 +29,7 @@
 #include <couchbase/fmt/transaction_keyspace.hxx>
 
 #include <functional>
+#include <memory>
 
 namespace couchbase::core::transactions
 {
@@ -41,24 +42,26 @@ transactions_cleanup_attempt::transactions_cleanup_attempt(const atr_cleanup_ent
 {
 }
 
-transactions_cleanup::transactions_cleanup(core::cluster cluster, const couchbase::transactions::transactions_config::built& config)
+transactions_cleanup::transactions_cleanup(
+  core::cluster cluster,
+  const couchbase::transactions::transactions_config::built& config)
   : cluster_(std::move(cluster))
   , config_(config)
   , client_uuid_(uid_generator::next())
 {
-    start();
+  start();
 }
 
-static std::uint64_t
-byteswap64(std::uint64_t val)
+static auto
+byteswap64(std::uint64_t val) -> std::uint64_t
 {
-    std::uint64_t ret = 0;
-    for (std::size_t ii = 0; ii < sizeof(std::uint64_t); ii++) {
-        ret <<= 8ULL;
-        ret |= val & 0xffULL;
-        val >>= 8ULL;
-    }
-    return ret;
+  std::uint64_t ret = 0;
+  for (std::size_t ii = 0; ii < sizeof(std::uint64_t); ii++) {
+    ret <<= 8ULL;
+    ret |= val & 0xffULL;
+    val >>= 8ULL;
+  }
+  return ret;
 }
 
 /**
@@ -74,13 +77,13 @@ byteswap64(std::uint64_t val)
  * Want:        0x155CD21DA7580000   (1539336197457313792 in base10, an epoch
  * time in millionths of a second)
  */
-static std::uint64_t
-parse_mutation_cas(const std::string& cas)
+static auto
+parse_mutation_cas(const std::string& cas) -> std::uint64_t
 {
-    if (cas.empty()) {
-        return 0;
-    }
-    return byteswap64(stoull(cas, nullptr, 16)) / 1000000;
+  if (cas.empty()) {
+    return 0;
+  }
+  return byteswap64(stoull(cas, nullptr, 16)) / 1000000;
 }
 
 static const std::string CLIENT_RECORD_DOC_ID = "_txn:client-record";
@@ -97,498 +100,562 @@ static const std::string FIELD_NUM_ATRS = "num_atrs";
 #define SAFETY_MARGIN_EXPIRY_MS 2000
 
 template<class R, class P>
-bool
-transactions_cleanup::interruptable_wait(std::chrono::duration<R, P> delay)
+auto
+transactions_cleanup::interruptable_wait(std::chrono::duration<R, P> delay) -> bool
 {
-    // wait for specified time, _or_ until the condition variable changes
-    std::unique_lock<std::mutex> lock(mutex_);
-    if (!running_) {
-        return false;
-    }
-    cv_.wait_for(lock, delay, [&]() { return !running_; });
-    return running_;
+  // wait for specified time, _or_ until the condition variable changes
+  std::unique_lock<std::mutex> lock(mutex_);
+  if (!running_) {
+    return false;
+  }
+  cv_.wait_for(lock, delay, [&]() {
+    return !running_;
+  });
+  return running_;
 }
 
 void
-transactions_cleanup::clean_collection(const couchbase::transactions::transaction_keyspace& keyspace)
+transactions_cleanup::clean_collection(
+  const couchbase::transactions::transaction_keyspace& keyspace)
 {
-    // first make sure the collection is in the list
-    while (is_running()) {
-        {
-            std::lock_guard<std::mutex> lock(mutex_);
-            if (collections_.end() == std::find(collections_.begin(), collections_.end(), keyspace)) {
-                CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("cleanup for {} ending, no longer in collection cleanup list", keyspace);
-                return;
-            }
+  // first make sure the collection is in the list
+  while (is_running()) {
+    {
+      std::lock_guard<std::mutex> lock(mutex_);
+      if (collections_.end() == std::find(collections_.begin(), collections_.end(), keyspace)) {
+        CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG(
+          "cleanup for {} ending, no longer in collection cleanup list", keyspace);
+        return;
+      }
+    }
+    CB_LOST_ATTEMPT_CLEANUP_LOG_INFO("cleanup for {} starting", keyspace);
+    // we are running, and collection is in the list, so lets clean it.
+    try {
+      auto details = get_active_clients(keyspace, client_uuid_);
+
+      auto all_atrs = atr_ids::all();
+
+      std::chrono::microseconds cleanup_window =
+        std::chrono::duration_cast<std::chrono::microseconds>(
+          config_.cleanup_config.cleanup_window);
+      auto start = std::chrono::steady_clock::now();
+      CB_LOST_ATTEMPT_CLEANUP_LOG_INFO(
+        "{} active clients (including this one), {} ATRs to check in {}ms",
+        details.num_active_clients,
+        all_atrs.size(),
+        config_.cleanup_config.cleanup_window.count());
+
+      for (auto it = all_atrs.begin() + details.index_of_this_client; it < all_atrs.end();
+           it += details.num_active_clients) {
+        auto atrs_left_for_this_client =
+          std::distance(it, all_atrs.end()) /
+          std::max<decltype(it)::difference_type>(1, details.num_active_clients);
+        auto now = std::chrono::steady_clock::now();
+        std::chrono::microseconds elapsed_in_cleanup_window =
+          std::chrono::duration_cast<std::chrono::microseconds>(now - start);
+        std::chrono::microseconds remaining_in_cleanup_window =
+          cleanup_window - elapsed_in_cleanup_window;
+        std::chrono::microseconds budget_for_this_atr = std::chrono::microseconds(
+          remaining_in_cleanup_window.count() /
+          std::max<decltype(it)::difference_type>(1, atrs_left_for_this_client));
+        // clean the ATR entry
+        std::string atr_id = *it;
+        if (!is_running()) {
+          CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("cleanup of {} complete", keyspace);
+          return;
         }
-        CB_LOST_ATTEMPT_CLEANUP_LOG_INFO("cleanup for {} starting", keyspace);
-        // we are running, and collection is in the list, so lets clean it.
+
         try {
-            auto details = get_active_clients(keyspace, client_uuid_);
-
-            auto all_atrs = atr_ids::all();
-
-            std::chrono::microseconds cleanup_window =
-              std::chrono::duration_cast<std::chrono::microseconds>(config_.cleanup_config.cleanup_window);
-            auto start = std::chrono::steady_clock::now();
-            CB_LOST_ATTEMPT_CLEANUP_LOG_INFO("{} active clients (including this one), {} ATRs to check in {}ms",
-                                             details.num_active_clients,
-                                             all_atrs.size(),
-                                             config_.cleanup_config.cleanup_window.count());
-
-            for (auto it = all_atrs.begin() + details.index_of_this_client; it < all_atrs.end(); it += details.num_active_clients) {
-                auto atrs_left_for_this_client =
-                  std::distance(it, all_atrs.end()) / std::max<decltype(it)::difference_type>(1, details.num_active_clients);
-                auto now = std::chrono::steady_clock::now();
-                std::chrono::microseconds elapsed_in_cleanup_window = std::chrono::duration_cast<std::chrono::microseconds>(now - start);
-                std::chrono::microseconds remaining_in_cleanup_window = cleanup_window - elapsed_in_cleanup_window;
-                std::chrono::microseconds budget_for_this_atr = std::chrono::microseconds(
-                  remaining_in_cleanup_window.count() / std::max<decltype(it)::difference_type>(1, atrs_left_for_this_client));
-                // clean the ATR entry
-                std::string atr_id = *it;
-                if (!is_running()) {
-                    CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("cleanup of {} complete", keyspace);
-                    return;
-                }
-
-                try {
-                    handle_atr_cleanup({ keyspace.bucket, keyspace.scope, keyspace.collection, atr_id });
-                } catch (const std::exception& e) {
-                    CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR("cleanup of atr {} failed with {}, moving on", atr_id, e.what());
-                }
-
-                auto atr_end = std::chrono::steady_clock::now();
-                std::chrono::microseconds atr_used = std::chrono::duration_cast<std::chrono::microseconds>(atr_end - now);
-                std::chrono::microseconds atr_left = budget_for_this_atr - atr_used;
-
-                // Too verbose to log, but leaving here commented as it may be useful later for internal debugging
-                /*CB_LOST_ATTEMPT_CLEANUP_LOG_INFO("{} {} atrs_left_for_this_client={} elapsed_in_cleanup_window={}us "
-                                            "remaining_in_cleanup_window={}us budget_for_this_atr={}us atr_used={}us atr_left={}us",
-                                            bucket_name,
-                                            atr_id,
-                                            atrs_left_for_this_client,
-                                            elapsed_in_cleanup_window.count(),
-                                            remaining_in_cleanup_window.count(),
-                                            budget_for_this_atr.count(),
-                                            atr_used.count(),
-                                            atr_left.count());*/
-
-                if (atr_left.count() > 0 && atr_left.count() < 1000000000) { // safety check protects against bugs
-                    if (!interruptable_wait(atr_left)) {
-                        return;
-                    }
-                }
-            }
-        } catch (const std::exception& ex) {
-            CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR("cleanup failed with {}, trying again in 3 sec...", ex.what());
-            // we must have gotten an exception trying to get the client records.   Let's wait 3 sec and try again
-            std::this_thread::sleep_for(std::chrono::seconds(3));
+          handle_atr_cleanup({ keyspace.bucket, keyspace.scope, keyspace.collection, atr_id });
+        } catch (const std::exception& e) {
+          CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR(
+            "cleanup of atr {} failed with {}, moving on", atr_id, e.what());
+        }
+
+        auto atr_end = std::chrono::steady_clock::now();
+        std::chrono::microseconds atr_used =
+          std::chrono::duration_cast<std::chrono::microseconds>(atr_end - now);
+        std::chrono::microseconds atr_left = budget_for_this_atr - atr_used;
+
+        // Too verbose to log, but leaving here commented as it may be useful later for internal
+        // debugging
+        /*CB_LOST_ATTEMPT_CLEANUP_LOG_INFO("{} {} atrs_left_for_this_client={}
+           elapsed_in_cleanup_window={}us " "remaining_in_cleanup_window={}us
+           budget_for_this_atr={}us atr_used={}us atr_left={}us", bucket_name, atr_id,
+           atrs_left_for_this_client, elapsed_in_cleanup_window.count(),
+                                    remaining_in_cleanup_window.count(),
+                                    budget_for_this_atr.count(),
+                                    atr_used.count(),
+                                    atr_left.count());*/
+
+        if (atr_left.count() > 0 &&
+            atr_left.count() < 1000000000) { // safety check protects against bugs
+          if (!interruptable_wait(atr_left)) {
+            return;
+          }
         }
+      }
+    } catch (const std::exception& ex) {
+      CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR("cleanup failed with {}, trying again in 3 sec...",
+                                        ex.what());
+      // we must have gotten an exception trying to get the client records.   Let's wait 3 sec and
+      // try again
+      std::this_thread::sleep_for(std::chrono::seconds(3));
     }
+  }
 }
 
-const atr_cleanup_stats
-transactions_cleanup::handle_atr_cleanup(const core::document_id& atr_id, std::vector<transactions_cleanup_attempt>* results)
+auto
+transactions_cleanup::handle_atr_cleanup(const core::document_id& atr_id,
+                                         std::vector<transactions_cleanup_attempt>* results)
+  -> const atr_cleanup_stats
 {
-    atr_cleanup_stats stats;
-    auto atr = active_transaction_record::get_atr(cluster_, atr_id);
-    if (atr) {
-        // ok, loop through the attempts and clean them all.  The entry will
-        // check if expired, nothing much to do here except call clean.
-        stats.exists = true;
-        stats.num_entries = atr->entries().size();
-        for (const auto& entry : atr->entries()) {
-            // If we were passed results, then we are testing, and want to set the
-            // check_if_expired to false.
-            atr_cleanup_entry cleanup_entry(entry, atr_id, *this, results == nullptr);
-            try {
-                if (results != nullptr) {
-                    results->emplace_back(cleanup_entry);
-                }
-                cleanup_entry.clean(results != nullptr ? &results->back() : nullptr);
-                if (results != nullptr) {
-                    results->back().success(true);
-                }
-            } catch (const std::exception& e) {
-                CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR("cleanup of {} failed: {}, moving on", cleanup_entry, e.what());
-                if (results != nullptr) {
-                    results->back().success(false);
-                }
-            }
+  atr_cleanup_stats stats;
+  auto atr = active_transaction_record::get_atr(cluster_, atr_id);
+  if (atr) {
+    // ok, loop through the attempts and clean them all.  The entry will
+    // check if expired, nothing much to do here except call clean.
+    stats.exists = true;
+    stats.num_entries = atr->entries().size();
+    for (const auto& entry : atr->entries()) {
+      // If we were passed results, then we are testing, and want to set the
+      // check_if_expired to false.
+      atr_cleanup_entry cleanup_entry(entry, atr_id, *this, results == nullptr);
+      try {
+        if (results != nullptr) {
+          results->emplace_back(cleanup_entry);
+        }
+        cleanup_entry.clean(results != nullptr ? &results->back() : nullptr);
+        if (results != nullptr) {
+          results->back().success(true);
+        }
+      } catch (const std::exception& e) {
+        CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR(
+          "cleanup of {} failed: {}, moving on", cleanup_entry, e.what());
+        if (results != nullptr) {
+          results->back().success(false);
         }
+      }
     }
-    return stats;
+  }
+  return stats;
 }
 
 void
-transactions_cleanup::create_client_record(const couchbase::transactions::transaction_keyspace& keyspace)
+transactions_cleanup::create_client_record(
+  const couchbase::transactions::transaction_keyspace& keyspace)
 
 {
-    try {
-        auto id = document_id(keyspace.bucket, keyspace.scope, keyspace.collection, CLIENT_RECORD_DOC_ID);
-        core::operations::mutate_in_request req{ id };
-        req.store_semantics = couchbase::store_semantics::insert;
-        req.specs =
-          couchbase::mutate_in_specs{
-              couchbase::mutate_in_specs::insert(FIELD_CLIENTS, tao::json::empty_object).xattr().create_path(),
-              // subdoc::opcode::set_doc used in replace w/ empty path
-              // ExtBinaryMetadata
-              couchbase::mutate_in_specs::replace_raw({}, std::vector<std::byte>{ std::byte{ 0x00 } }),
-          }
-            .specs();
-        wrap_durable_request(req, config_);
-        auto barrier = std::make_shared<std::promise<result>>();
-        auto f = barrier->get_future();
-        auto ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
-            return config_.cleanup_hooks->client_record_before_create(bucket, std::move(handler));
-        });
-        if (ec) {
-            throw client_error(*ec, "client_record_before_create hook raised error");
-        }
-        cluster_.execute(req, [barrier](auto&& resp) { barrier->set_value(result::create_from_subdoc_response(resp)); });
-        wrap_operation_future(f);
-
-    } catch (const client_error& e) {
-        CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("create_client_record got error {}", e.what());
-        auto ec = e.ec();
-        switch (ec) {
-            case FAIL_DOC_ALREADY_EXISTS:
-                CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("client record already exists, moving on");
-                return;
-            default:
-                throw;
-        }
+  try {
+    auto id =
+      document_id(keyspace.bucket, keyspace.scope, keyspace.collection, CLIENT_RECORD_DOC_ID);
+    core::operations::mutate_in_request req{ id };
+    req.store_semantics = couchbase::store_semantics::insert;
+    req.specs =
+      couchbase::mutate_in_specs{
+        couchbase::mutate_in_specs::insert(FIELD_CLIENTS, tao::json::empty_object)
+          .xattr()
+          .create_path(),
+        // subdoc::opcode::set_doc used in replace w/ empty path
+        // ExtBinaryMetadata
+        couchbase::mutate_in_specs::replace_raw({}, std::vector<std::byte>{ std::byte{ 0x00 } }),
+      }
+        .specs();
+    wrap_durable_request(req, config_);
+    auto barrier = std::make_shared<std::promise<result>>();
+    auto f = barrier->get_future();
+    auto ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
+      return config_.cleanup_hooks->client_record_before_create(bucket, std::move(handler));
+    });
+    if (ec) {
+      throw client_error(*ec, "client_record_before_create hook raised error");
+    }
+    cluster_.execute(req, [barrier](auto&& resp) {
+      barrier->set_value(result::create_from_subdoc_response(resp));
+    });
+    wrap_operation_future(f);
+
+  } catch (const client_error& e) {
+    CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("create_client_record got error {}", e.what());
+    auto ec = e.ec();
+    switch (ec) {
+      case FAIL_DOC_ALREADY_EXISTS:
+        CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("client record already exists, moving on");
+        return;
+      default:
+        throw;
     }
+  }
 }
 
-const client_record_details
-transactions_cleanup::get_active_clients(const couchbase::transactions::transaction_keyspace& keyspace, const std::string& uuid)
+auto
+transactions_cleanup::get_active_clients(
+  const couchbase::transactions::transaction_keyspace& keyspace,
+  const std::string& uuid) -> const client_record_details
 {
-    client_record_details details;
-    // Write our client record, return details.
-    try {
-        auto id = document_id{ keyspace.bucket, keyspace.scope, keyspace.collection, CLIENT_RECORD_DOC_ID };
-        core::operations::lookup_in_request req{ id };
-        req.specs =
-          lookup_in_specs{
-              lookup_in_specs::get(FIELD_RECORDS).xattr(),
-              lookup_in_specs::get(subdoc::lookup_in_macro::vbucket).xattr(),
+  client_record_details details;
+  // Write our client record, return details.
+  try {
+    auto id =
+      document_id{ keyspace.bucket, keyspace.scope, keyspace.collection, CLIENT_RECORD_DOC_ID };
+    core::operations::lookup_in_request req{ id };
+    req.specs =
+      lookup_in_specs{
+        lookup_in_specs::get(FIELD_RECORDS).xattr(),
+        lookup_in_specs::get(subdoc::lookup_in_macro::vbucket).xattr(),
+      }
+        .specs();
+    auto barrier = std::make_shared<std::promise<result>>();
+    auto f = barrier->get_future();
+    auto ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
+      return config_.cleanup_hooks->client_record_before_get(bucket, std::move(handler));
+    });
+    if (ec) {
+      throw client_error(*ec, "client_record_before_get hook raised error");
+    }
+    cluster_.execute(req, [barrier](auto&& resp) {
+      barrier->set_value(result::create_from_subdoc_response(resp));
+    });
+    auto res = wrap_operation_future(f);
+
+    std::vector<std::string> active_client_uids;
+    auto hlc = res.values[1].content_as();
+    auto now_ms = now_ns_from_vbucket(hlc) / 1000000;
+    details.override_enabled = false;
+    details.override_expires = 0;
+    if (res.values[0].status == subdoc_result::status_type::success) {
+      auto records = res.values[0].content_as();
+      CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("client records: {}", core::utils::json::generate(records));
+      for (const auto& [key, value] : records.get_object()) {
+        if (key == FIELD_OVERRIDE) {
+          for (const auto& [over_ride, param] : value.get_object()) {
+            if (over_ride == FIELD_OVERRIDE_ENABLED) {
+              details.override_enabled = param.get_boolean();
+            } else if (over_ride == FIELD_OVERRIDE_EXPIRES) {
+              details.override_expires = param.as<std::uint64_t>();
+            }
           }
-            .specs();
-        auto barrier = std::make_shared<std::promise<result>>();
-        auto f = barrier->get_future();
-        auto ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
-            return config_.cleanup_hooks->client_record_before_get(bucket, std::move(handler));
-        });
-        if (ec) {
-            throw client_error(*ec, "client_record_before_get hook raised error");
-        }
-        cluster_.execute(req, [barrier](auto&& resp) { barrier->set_value(result::create_from_subdoc_response(resp)); });
-        auto res = wrap_operation_future(f);
-
-        std::vector<std::string> active_client_uids;
-        auto hlc = res.values[1].content_as();
-        auto now_ms = now_ns_from_vbucket(hlc) / 1000000;
-        details.override_enabled = false;
-        details.override_expires = 0;
-        if (res.values[0].status == subdoc_result::status_type::success) {
-            auto records = res.values[0].content_as();
-            CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("client records: {}", core::utils::json::generate(records));
-            for (const auto& [key, value] : records.get_object()) {
-                if (key == FIELD_OVERRIDE) {
-                    for (const auto& [over_ride, param] : value.get_object()) {
-                        if (over_ride == FIELD_OVERRIDE_ENABLED) {
-                            details.override_enabled = param.get_boolean();
-                        } else if (over_ride == FIELD_OVERRIDE_EXPIRES) {
-                            details.override_expires = param.as<std::uint64_t>();
-                        }
-                    }
-                } else if (key == FIELD_CLIENTS_ONLY) {
-                    for (const auto& [other_client_uuid, cl] : value.get_object()) {
-                        std::uint64_t heartbeat_ms = parse_mutation_cas(cl.at(FIELD_HEARTBEAT).get_string());
-                        auto expires_ms = cl.at(FIELD_EXPIRES).as<std::uint64_t>();
-                        auto expired_period = static_cast<std::int64_t>(now_ms) - static_cast<std::int64_t>(heartbeat_ms);
-                        bool has_expired = expired_period >= static_cast<std::int64_t>(expires_ms) && now_ms > heartbeat_ms;
-                        if (has_expired && other_client_uuid != uuid) {
-                            details.expired_client_ids.push_back(other_client_uuid);
-                        } else {
-                            active_client_uids.push_back(other_client_uuid);
-                        }
-                    }
-                }
+        } else if (key == FIELD_CLIENTS_ONLY) {
+          for (const auto& [other_client_uuid, cl] : value.get_object()) {
+            std::uint64_t heartbeat_ms = parse_mutation_cas(cl.at(FIELD_HEARTBEAT).get_string());
+            auto expires_ms = cl.at(FIELD_EXPIRES).as<std::uint64_t>();
+            auto expired_period =
+              static_cast<std::int64_t>(now_ms) - static_cast<std::int64_t>(heartbeat_ms);
+            bool has_expired =
+              expired_period >= static_cast<std::int64_t>(expires_ms) && now_ms > heartbeat_ms;
+            if (has_expired && other_client_uuid != uuid) {
+              details.expired_client_ids.push_back(other_client_uuid);
+            } else {
+              active_client_uids.push_back(other_client_uuid);
             }
+          }
         }
-        if (std::find(active_client_uids.begin(), active_client_uids.end(), uuid) == active_client_uids.end()) {
-            active_client_uids.push_back(uuid);
-        }
-        std::sort(active_client_uids.begin(), active_client_uids.end());
-        auto this_idx = std::distance(active_client_uids.begin(), std::find(active_client_uids.begin(), active_client_uids.end(), uuid));
-        details.num_active_clients = static_cast<std::uint32_t>(active_client_uids.size());
-        details.index_of_this_client = static_cast<std::uint32_t>(this_idx);
-        details.num_active_clients = static_cast<std::uint32_t>(active_client_uids.size());
-        details.num_expired_clients = static_cast<std::uint32_t>(details.expired_client_ids.size());
-        details.num_existing_clients = details.num_expired_clients + details.num_active_clients;
-        details.client_uuid = uuid;
-        details.cas_now_nanos = now_ms * 1000000;
-        details.override_active = (details.override_enabled && details.override_expires > details.cas_now_nanos);
-        CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("client details {}", details);
-        if (details.override_active) {
-            CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("override enabled, will not update record");
-            return details;
-        }
+      }
+    }
+    if (std::find(active_client_uids.begin(), active_client_uids.end(), uuid) ==
+        active_client_uids.end()) {
+      active_client_uids.push_back(uuid);
+    }
+    std::sort(active_client_uids.begin(), active_client_uids.end());
+    auto this_idx =
+      std::distance(active_client_uids.begin(),
+                    std::find(active_client_uids.begin(), active_client_uids.end(), uuid));
+    details.num_active_clients = static_cast<std::uint32_t>(active_client_uids.size());
+    details.index_of_this_client = static_cast<std::uint32_t>(this_idx);
+    details.num_active_clients = static_cast<std::uint32_t>(active_client_uids.size());
+    details.num_expired_clients = static_cast<std::uint32_t>(details.expired_client_ids.size());
+    details.num_existing_clients = details.num_expired_clients + details.num_active_clients;
+    details.client_uuid = uuid;
+    details.cas_now_nanos = now_ms * 1000000;
+    details.override_active =
+      (details.override_enabled && details.override_expires > details.cas_now_nanos);
+    CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("client details {}", details);
+    if (details.override_active) {
+      CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("override enabled, will not update record");
+      return details;
+    }
 
-        // update client record, maybe cleanup some as well...
-        core::operations::mutate_in_request mutate_req{ id };
-        auto mut_specs = couchbase::mutate_in_specs{
-            couchbase::mutate_in_specs::upsert(FIELD_CLIENTS + "." + uuid + "." + FIELD_HEARTBEAT, subdoc::mutate_in_macro::cas)
-              .xattr()
-              .create_path(),
-            couchbase::mutate_in_specs::upsert(FIELD_CLIENTS + "." + uuid + "." + FIELD_EXPIRES,
-                                               config_.cleanup_config.cleanup_window.count() / 2 + SAFETY_MARGIN_EXPIRY_MS)
-              .xattr()
-              .create_path(),
-            couchbase::mutate_in_specs::upsert(FIELD_CLIENTS + "." + uuid + "." + FIELD_NUM_ATRS, atr_ids::all().size())
-              .xattr()
-              .create_path(),
-        };
-        for (std::size_t idx = 0; idx < std::min(details.expired_client_ids.size(), static_cast<std::size_t>(12)); idx++) {
-            CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("adding {} to list of clients to be removed when updating this client",
-                                              details.expired_client_ids[idx]);
-            mut_specs.push_back(couchbase::mutate_in_specs::remove(FIELD_CLIENTS + "." + details.expired_client_ids[idx]).xattr());
-        }
-        mutate_req.specs = mut_specs.specs();
-        ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
-            return config_.cleanup_hooks->client_record_before_update(bucket, std::move(handler));
-        });
-        if (ec) {
-            throw client_error(*ec, "client_record_before_update hook raised error");
-        }
-        wrap_durable_request(mutate_req, config_);
-        auto mutate_barrier = std::make_shared<std::promise<result>>();
-        auto mutate_f = mutate_barrier->get_future();
-        CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("updating record");
-        cluster_.execute(mutate_req,
-                         [mutate_barrier](auto&& resp) { mutate_barrier->set_value(result::create_from_subdoc_response(resp)); });
-        res = wrap_operation_future(mutate_f);
-
-        // just update the cas, and return the details
-        details.cas_now_nanos = res.cas;
-        CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("get_active_clients found {}", details);
-        return details;
-    } catch (const client_error& e) {
-        auto ec = e.ec();
-        switch (ec) {
-            case FAIL_DOC_NOT_FOUND:
-                CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("client record not found, creating new one");
-                create_client_record(keyspace);
-                return get_active_clients(keyspace, uuid);
-            default:
-                throw;
-        }
+    // update client record, maybe cleanup some as well...
+    core::operations::mutate_in_request mutate_req{ id };
+    auto mut_specs = couchbase::mutate_in_specs{
+      couchbase::mutate_in_specs::upsert(FIELD_CLIENTS + "." + uuid + "." + FIELD_HEARTBEAT,
+                                         subdoc::mutate_in_macro::cas)
+        .xattr()
+        .create_path(),
+      couchbase::mutate_in_specs::upsert(FIELD_CLIENTS + "." + uuid + "." + FIELD_EXPIRES,
+                                         config_.cleanup_config.cleanup_window.count() / 2 +
+                                           SAFETY_MARGIN_EXPIRY_MS)
+        .xattr()
+        .create_path(),
+      couchbase::mutate_in_specs::upsert(FIELD_CLIENTS + "." + uuid + "." + FIELD_NUM_ATRS,
+                                         atr_ids::all().size())
+        .xattr()
+        .create_path(),
+    };
+    for (std::size_t idx = 0;
+         idx < std::min(details.expired_client_ids.size(), static_cast<std::size_t>(12));
+         idx++) {
+      CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE(
+        "adding {} to list of clients to be removed when updating this client",
+        details.expired_client_ids[idx]);
+      mut_specs.push_back(
+        couchbase::mutate_in_specs::remove(FIELD_CLIENTS + "." + details.expired_client_ids[idx])
+          .xattr());
+    }
+    mutate_req.specs = mut_specs.specs();
+    ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
+      return config_.cleanup_hooks->client_record_before_update(bucket, std::move(handler));
+    });
+    if (ec) {
+      throw client_error(*ec, "client_record_before_update hook raised error");
+    }
+    wrap_durable_request(mutate_req, config_);
+    auto mutate_barrier = std::make_shared<std::promise<result>>();
+    auto mutate_f = mutate_barrier->get_future();
+    CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("updating record");
+    cluster_.execute(mutate_req, [mutate_barrier](auto&& resp) {
+      mutate_barrier->set_value(result::create_from_subdoc_response(resp));
+    });
+    res = wrap_operation_future(mutate_f);
+
+    // just update the cas, and return the details
+    details.cas_now_nanos = res.cas;
+    CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("get_active_clients found {}", details);
+    return details;
+  } catch (const client_error& e) {
+    auto ec = e.ec();
+    switch (ec) {
+      case FAIL_DOC_NOT_FOUND:
+        CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("client record not found, creating new one");
+        create_client_record(keyspace);
+        return get_active_clients(keyspace, uuid);
+      default:
+        throw;
     }
+  }
 }
 
 void
 transactions_cleanup::remove_client_record_from_all_buckets(const std::string& uuid)
 {
-    for (const auto& keyspace : collections_) {
-        try {
-            retry_op_exponential_backoff_timeout<void>(
-              std::chrono::milliseconds(10), std::chrono::milliseconds(250), std::chrono::milliseconds(500), [this, keyspace, uuid]() {
-                  try {
-                      // proceed to remove the client uuid if it exists
-                      auto ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
-                          return config_.cleanup_hooks->client_record_before_remove_client(bucket, std::move(handler));
-                      });
-                      if (ec) {
-                          throw client_error(*ec, "client_record_before_remove_client hook raised error");
-                      }
-                      document_id id{ keyspace.bucket, keyspace.scope, keyspace.collection, CLIENT_RECORD_DOC_ID };
-                      core::operations::mutate_in_request req{ id };
-                      req.specs =
-                        couchbase::mutate_in_specs{
-                            couchbase::mutate_in_specs::remove(FIELD_CLIENTS + "." + uuid).xattr(),
-                        }
-                          .specs();
-                      wrap_durable_request(req, config_);
-                      auto barrier = std::make_shared<std::promise<result>>();
-                      auto f = barrier->get_future();
-                      cluster_.execute(req, [barrier](auto&& resp) { barrier->set_value(result::create_from_subdoc_response(resp)); });
-                      wrap_operation_future(f);
-                      CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("removed {} from {}", uuid, keyspace);
-                  } catch (const client_error& e) {
-                      CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("error removing client records {}", e.what());
-                      auto ec = e.ec();
-                      switch (ec) {
-                          case FAIL_DOC_NOT_FOUND:
-                              CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("no client record in {}, ignoring", keyspace);
-                              return;
-                          case FAIL_PATH_NOT_FOUND:
-                              CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("client {} not in client record for {}, ignoring", uuid, keyspace);
-                              return;
-                          default:
-                              throw retry_operation("retry remove until timeout");
-                      }
-                  }
-              });
-        } catch (const std::exception& e) {
-            CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR("Error removing client record {} from {}: {}", uuid, keyspace, e.what());
-        }
+  for (const auto& keyspace : collections_) {
+    try {
+      retry_op_exponential_backoff_timeout<void>(
+        std::chrono::milliseconds(10),
+        std::chrono::milliseconds(250),
+        std::chrono::milliseconds(500),
+        [this, keyspace, uuid]() {
+          try {
+            // proceed to remove the client uuid if it exists
+            auto ec = wait_for_hook([this, bucket = keyspace.bucket](auto handler) mutable {
+              return config_.cleanup_hooks->client_record_before_remove_client(bucket,
+                                                                               std::move(handler));
+            });
+            if (ec) {
+              throw client_error(*ec, "client_record_before_remove_client hook raised error");
+            }
+            document_id id{
+              keyspace.bucket, keyspace.scope, keyspace.collection, CLIENT_RECORD_DOC_ID
+            };
+            core::operations::mutate_in_request req{ id };
+            req.specs =
+              couchbase::mutate_in_specs{
+                couchbase::mutate_in_specs::remove(FIELD_CLIENTS + "." + uuid).xattr(),
+              }
+                .specs();
+            wrap_durable_request(req, config_);
+            auto barrier = std::make_shared<std::promise<result>>();
+            auto f = barrier->get_future();
+            cluster_.execute(req, [barrier](auto&& resp) {
+              barrier->set_value(result::create_from_subdoc_response(resp));
+            });
+            wrap_operation_future(f);
+            CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("removed {} from {}", uuid, keyspace);
+          } catch (const client_error& e) {
+            CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("error removing client records {}", e.what());
+            auto ec = e.ec();
+            switch (ec) {
+              case FAIL_DOC_NOT_FOUND:
+                CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("no client record in {}, ignoring", keyspace);
+                return;
+              case FAIL_PATH_NOT_FOUND:
+                CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG(
+                  "client {} not in client record for {}, ignoring", uuid, keyspace);
+                return;
+              default:
+                throw retry_operation("retry remove until timeout");
+            }
+          }
+        });
+    } catch (const std::exception& e) {
+      CB_LOST_ATTEMPT_CLEANUP_LOG_ERROR(
+        "Error removing client record {} from {}: {}", uuid, keyspace, e.what());
     }
+  }
 }
 
-const atr_cleanup_stats
-transactions_cleanup::force_cleanup_atr(const core::document_id& atr_id, std::vector<transactions_cleanup_attempt>& results)
+auto
+transactions_cleanup::force_cleanup_atr(const core::document_id& atr_id,
+                                        std::vector<transactions_cleanup_attempt>& results)
+  -> const atr_cleanup_stats
 {
-    CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("starting force_cleanup_atr: atr_id {}", atr_id);
-    return handle_atr_cleanup(atr_id, &results);
+  CB_LOST_ATTEMPT_CLEANUP_LOG_TRACE("starting force_cleanup_atr: atr_id {}", atr_id);
+  return handle_atr_cleanup(atr_id, &results);
 }
 
 void
-transactions_cleanup::force_cleanup_entry(atr_cleanup_entry& entry, transactions_cleanup_attempt& attempt)
+transactions_cleanup::force_cleanup_entry(atr_cleanup_entry& entry,
+                                          transactions_cleanup_attempt& attempt)
 {
-    try {
-        entry.clean(&attempt);
-        attempt.success(true);
-
-    } catch (const std::runtime_error& e) {
-        CB_ATTEMPT_CLEANUP_LOG_ERROR("error attempting to clean {}: {}", entry, e.what());
-        attempt.success(false);
-    }
+  try {
+    entry.clean(&attempt);
+    attempt.success(true);
+
+  } catch (const std::runtime_error& e) {
+    CB_ATTEMPT_CLEANUP_LOG_ERROR("error attempting to clean {}: {}", entry, e.what());
+    attempt.success(false);
+  }
 }
 
 void
 transactions_cleanup::force_cleanup_attempts(std::vector<transactions_cleanup_attempt>& results)
 {
-    CB_ATTEMPT_CLEANUP_LOG_TRACE("starting force_cleanup_attempts");
-    while (atr_queue_.size() > 0) {
-        auto entry = atr_queue_.pop(false);
-        if (!entry) {
-            CB_ATTEMPT_CLEANUP_LOG_ERROR("pop failed to return entry, but queue size {}", atr_queue_.size());
-            return;
-        }
-        results.emplace_back(*entry);
-        try {
-            entry->clean(&results.back());
-            results.back().success(true);
-        } catch (std::runtime_error&) {
-            results.back().success(false);
-        }
+  CB_ATTEMPT_CLEANUP_LOG_TRACE("starting force_cleanup_attempts");
+  while (atr_queue_.size() > 0) {
+    auto entry = atr_queue_.pop(false);
+    if (!entry) {
+      CB_ATTEMPT_CLEANUP_LOG_ERROR("pop failed to return entry, but queue size {}",
+                                   atr_queue_.size());
+      return;
     }
+    results.emplace_back(*entry);
+    try {
+      entry->clean(&results.back());
+      results.back().success(true);
+    } catch (std::runtime_error&) {
+      results.back().success(false);
+    }
+  }
 }
 
 void
 transactions_cleanup::attempts_loop()
 {
-    try {
-        CB_ATTEMPT_CLEANUP_LOG_DEBUG("cleanup attempts loop starting...");
-        while (interruptable_wait(cleanup_loop_delay_)) {
-            while (auto entry = atr_queue_.pop()) {
-                if (!is_running()) {
-                    CB_ATTEMPT_CLEANUP_LOG_DEBUG("loop stopping - {} entries on queue", atr_queue_.size());
-                    return;
-                }
-                if (entry) {
-                    CB_ATTEMPT_CLEANUP_LOG_TRACE("beginning cleanup on {}", *entry);
-                    try {
-                        entry->clean();
-                    } catch (...) {
-                        // catch everything as we don't want to raise out of this thread
-                        CB_ATTEMPT_CLEANUP_LOG_DEBUG("got error cleaning {}, leaving for lost txn cleanup", entry.value());
-                    }
-                }
-            }
+  try {
+    CB_ATTEMPT_CLEANUP_LOG_DEBUG("cleanup attempts loop starting...");
+    while (interruptable_wait(cleanup_loop_delay_)) {
+      while (auto entry = atr_queue_.pop()) {
+        if (!is_running()) {
+          CB_ATTEMPT_CLEANUP_LOG_DEBUG("loop stopping - {} entries on queue", atr_queue_.size());
+          return;
+        }
+        if (entry) {
+          CB_ATTEMPT_CLEANUP_LOG_TRACE("beginning cleanup on {}", *entry);
+          try {
+            entry->clean();
+          } catch (...) {
+            // catch everything as we don't want to raise out of this thread
+            CB_ATTEMPT_CLEANUP_LOG_DEBUG("got error cleaning {}, leaving for lost txn cleanup",
+                                         entry.value());
+          }
         }
-        CB_ATTEMPT_CLEANUP_LOG_DEBUG("stopping - {} entries on queue", atr_queue_.size());
-    } catch (const std::runtime_error& e) {
-        CB_ATTEMPT_CLEANUP_LOG_ERROR("got error \"{}\" in attempts_loop", e.what());
+      }
     }
+    CB_ATTEMPT_CLEANUP_LOG_DEBUG("stopping - {} entries on queue", atr_queue_.size());
+  } catch (const std::runtime_error& e) {
+    CB_ATTEMPT_CLEANUP_LOG_ERROR("got error \"{}\" in attempts_loop", e.what());
+  }
 }
 
 void
-transactions_cleanup::add_attempt(attempt_context& ctx)
+transactions_cleanup::add_attempt(std::shared_ptr<attempt_context> ctx)
 {
-    auto& ctx_impl = static_cast<attempt_context_impl&>(ctx);
-    switch (ctx_impl.state()) {
-        case attempt_state::NOT_STARTED:
-        case attempt_state::COMPLETED:
-        case attempt_state::ROLLED_BACK:
-            CB_ATTEMPT_CLEANUP_LOG_TRACE("attempt in state {}, not adding to cleanup", attempt_state_name(ctx_impl.state()));
-            return;
-        default:
-            if (config_.cleanup_config.cleanup_client_attempts) {
-                CB_ATTEMPT_CLEANUP_LOG_DEBUG("adding attempt {} to cleanup queue", ctx_impl.id());
-                atr_queue_.push(ctx);
-            } else {
-                CB_ATTEMPT_CLEANUP_LOG_TRACE("not cleaning client attempts, ignoring {}", ctx_impl.id());
-            }
-    }
+  auto ctx_impl = std::dynamic_pointer_cast<attempt_context_impl>(ctx);
+  switch (ctx_impl->state()) {
+    case attempt_state::NOT_STARTED:
+    case attempt_state::COMPLETED:
+    case attempt_state::ROLLED_BACK:
+      CB_ATTEMPT_CLEANUP_LOG_TRACE("attempt in state {}, not adding to cleanup",
+                                   attempt_state_name(ctx_impl->state()));
+      return;
+    default:
+      if (config_.cleanup_config.cleanup_client_attempts) {
+        CB_ATTEMPT_CLEANUP_LOG_DEBUG("adding attempt {} to cleanup queue", ctx_impl->id());
+        atr_queue_.push(ctx);
+      } else {
+        CB_ATTEMPT_CLEANUP_LOG_TRACE("not cleaning client attempts, ignoring {}", ctx_impl->id());
+      }
+  }
 }
 
 void
 transactions_cleanup::add_collection(couchbase::transactions::transaction_keyspace keyspace)
 {
 
-    if (keyspace.valid() && config_.cleanup_config.cleanup_lost_attempts) {
-        std::unique_lock<std::mutex> lock(mutex_);
+  if (keyspace.valid() && config_.cleanup_config.cleanup_lost_attempts) {
+    std::unique_lock<std::mutex> lock(mutex_);
 
-        auto it = std::find(collections_.begin(), collections_.end(), keyspace);
-        if (it == collections_.end()) {
-            collections_.emplace_back(std::move(keyspace));
-            // start cleaning right away
-            lost_attempt_cleanup_workers_.emplace_back([this, keyspace = collections_.back()]() { this->clean_collection(keyspace); });
-        }
-        lock.unlock();
-        CB_ATTEMPT_CLEANUP_LOG_DEBUG("added {} to lost transaction cleanup", keyspace);
+    auto it = std::find(collections_.begin(), collections_.end(), keyspace);
+    if (it == collections_.end()) {
+      collections_.emplace_back(std::move(keyspace));
+      // start cleaning right away
+      lost_attempt_cleanup_workers_.emplace_back([this, keyspace = collections_.back()]() {
+        this->clean_collection(keyspace);
+      });
     }
+    lock.unlock();
+    CB_ATTEMPT_CLEANUP_LOG_DEBUG("added {} to lost transaction cleanup", keyspace);
+  }
 }
 
 void
 transactions_cleanup::start()
 {
-    running_ = config_.cleanup_config.cleanup_client_attempts || config_.cleanup_config.cleanup_lost_attempts;
-    if (config_.cleanup_config.cleanup_client_attempts) {
-        cleanup_thr_ = std::thread(std::bind(&transactions_cleanup::attempts_loop, this));
-    }
-    if (config_.metadata_collection) {
-        add_collection(
-          { config_.metadata_collection->bucket, config_.metadata_collection->scope, config_.metadata_collection->collection });
-    }
-    for (const auto& k : config_.cleanup_config.collections) {
-        add_collection(k);
-    }
+  running_ =
+    config_.cleanup_config.cleanup_client_attempts || config_.cleanup_config.cleanup_lost_attempts;
+  if (config_.cleanup_config.cleanup_client_attempts) {
+    cleanup_thr_ = std::thread(std::bind(&transactions_cleanup::attempts_loop, this));
+  }
+  if (config_.metadata_collection) {
+    add_collection({ config_.metadata_collection->bucket,
+                     config_.metadata_collection->scope,
+                     config_.metadata_collection->collection });
+  }
+  for (const auto& k : config_.cleanup_config.collections) {
+    add_collection(k);
+  }
 }
 
 void
 transactions_cleanup::stop()
 {
-    {
-        std::unique_lock<std::mutex> lock(mutex_);
-        running_ = false;
-        cv_.notify_all();
-    }
-    if (cleanup_thr_.joinable()) {
-        cleanup_thr_.join();
-        CB_ATTEMPT_CLEANUP_LOG_DEBUG("cleanup attempt thread closed");
-    }
-    for (auto& t : lost_attempt_cleanup_workers_) {
-        CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("shutting down all lost attempt threads...");
-        if (t.joinable()) {
-            t.join();
-        }
+  {
+    std::unique_lock<std::mutex> lock(mutex_);
+    running_ = false;
+    cv_.notify_all();
+  }
+  if (cleanup_thr_.joinable()) {
+    cleanup_thr_.join();
+    CB_ATTEMPT_CLEANUP_LOG_DEBUG("cleanup attempt thread closed");
+  }
+  for (auto& t : lost_attempt_cleanup_workers_) {
+    CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("shutting down all lost attempt threads...");
+    if (t.joinable()) {
+      t.join();
     }
+  }
 }
 
 void
 transactions_cleanup::close()
 {
-    stop();
-    CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("all lost attempt cleanup threads closed");
-    remove_client_record_from_all_buckets(client_uuid_);
+  stop();
+  CB_LOST_ATTEMPT_CLEANUP_LOG_DEBUG("all lost attempt cleanup threads closed");
+  remove_client_record_from_all_buckets(client_uuid_);
 }
 
 transactions_cleanup::~transactions_cleanup()
 {
-    close();
+  close();
 }
 } // namespace couchbase::core::transactions