couchbase 4.3.1 → 4.4.1-dev.1

package/deps/couchbase-cxx-client/core/transactions/attempt_context_impl.hxx

@@ -16,12 +16,12 @@
 
 #pragma once
 
-#include <core/cluster.hxx>
 #include <couchbase/transactions/async_attempt_context.hxx>
 #include <couchbase/transactions/attempt_context.hxx>
 #include <couchbase/transactions/transaction_query_options.hxx>
 
 #include "attempt_context_testing_hooks.hxx"
+#include "couchbase/codec/encoded_value.hxx"
 #include "error_list.hxx"
 #include "waitable_op_list.hxx"
 
@@ -33,30 +33,33 @@
 #include "internal/transaction_context.hxx"
 #include "transaction_get_result.hxx"
 
-#include <chrono>
-#include <list>
+#include <cstdint>
+#include <memory>
 #include <mutex>
 #include <string>
-#include <thread>
 #include <utility>
 
 // implemented in core::impl::query, to take advantage of the statics over there
-namespace couchbase::core::impl
+namespace couchbase::core
 {
+class cluster;
+namespace impl
+{
+auto
+build_transaction_query_result(operations::query_response resp, std::error_code ec = {})
+  -> std::pair<couchbase::core::transaction_op_error_context,
+               couchbase::transactions::transaction_query_result>;
 
-std::pair<couchbase::transaction_op_error_context, couchbase::transactions::transaction_query_result>
-build_transaction_query_result(operations::query_response resp, std::error_code ec = {});
-
-core::operations::query_request
-build_transaction_query_request(couchbase::query_options::built opts);
-
-} // namespace couchbase::core::impl
+auto
+build_transaction_query_request(couchbase::query_options::built opts)
+  -> core::operations::query_request;
+} // namespace impl
 
-namespace couchbase::core::transactions
+namespace transactions
 {
 /**
- * Provides methods to allow an application's transaction logic to read, mutate, insert and delete documents, as well as commit or
- * rollback the transaction.
+ * Provides methods to allow an application's transaction logic to read, mutate,
+ * insert and delete documents, as well as commit or rollback the transaction.
  */
 class transactions;
 enum class forward_compat_stage;
@@ -68,567 +71,437 @@ class attempt_context_impl
   , public couchbase::transactions::attempt_context
   , public async_attempt_context
   , public couchbase::transactions::async_attempt_context
+  , public std::enable_shared_from_this<attempt_context_impl>
 {
-  private:
-    transaction_context& overall_;
-    std::optional<core::document_id> atr_id_;
-    bool is_done_{ false };
-    std::unique_ptr<staged_mutation_queue> staged_mutations_;
-    attempt_context_testing_hooks& hooks_;
-    error_list errors_;
-    std::mutex mutex_;
-    waitable_op_list op_list_;
-    std::string query_context_;
-
-    // commit needs to access the hooks
-    friend class staged_mutation_queue;
-    // entry needs access to private members
-    friend class atr_cleanup_entry;
-    // transaction_context needs access to the two functions below
-    friend class transaction_context;
-
-    std::pair<couchbase::transaction_op_error_context, couchbase::transactions::transaction_get_result>
-    insert_raw(const couchbase::collection& coll, const std::string& id, std::vector<std::byte> content) override
-    {
-        return wrap_call_for_public_api([this, coll, &id, &content]() -> transaction_get_result {
-            return insert_raw({ coll.bucket_name(), coll.scope_name(), coll.name(), id }, content);
-        });
-    }
-
-    transaction_get_result insert_raw(const core::document_id& id, const std::vector<std::byte>& content) override;
-    void insert_raw(const collection& coll,
-                    std::string id,
-                    std::vector<std::byte> content,
-                    couchbase::transactions::async_result_handler&& handler) override
-    {
-        insert_raw({ coll.bucket_name(), coll.scope_name(), coll.name(), std::move(id) },
-                   content,
-                   [this, handler = std::move(handler)](std::exception_ptr err, std::optional<transaction_get_result> res) mutable {
-                       wrap_callback_for_async_public_api(err, res, std::move(handler));
-                   });
-    }
-    void insert_raw(const core::document_id& id, const std::vector<std::byte>& content, Callback&& cb) override;
-
-    transaction_get_result replace_raw(const transaction_get_result& document, const std::vector<std::byte>& content) override;
-
-    std::pair<couchbase::transaction_op_error_context, couchbase::transactions::transaction_get_result> replace_raw(
-      const couchbase::transactions::transaction_get_result& doc,
-      std::vector<std::byte> content) override
-    {
-        return wrap_call_for_public_api(
-          [this, doc, &content]() -> transaction_get_result { return replace_raw(transaction_get_result(doc), content); });
-    }
-
-    void replace_raw(couchbase::transactions::transaction_get_result doc,
-                     std::vector<std::byte> content,
-                     couchbase::transactions::async_result_handler&& handler) override
-    {
-        replace_raw(core::transactions::transaction_get_result(doc),
-                    content,
-                    [this, handler = std::move(handler)](std::exception_ptr err, std::optional<transaction_get_result> res) mutable {
-                        wrap_callback_for_async_public_api(err, res, std::move(handler));
-                    });
-    }
-    void replace_raw(const transaction_get_result& document, const std::vector<std::byte>& content, Callback&& cb) override;
-
-    void remove_staged_insert(const core::document_id& id, VoidCallback&& cb);
-
-    void get_with_query(const core::document_id& id, bool optional, Callback&& cb);
-    void insert_raw_with_query(const core::document_id& id, const std::vector<std::byte>& content, Callback&& cb);
-    void replace_raw_with_query(const transaction_get_result& document, const std::vector<std::byte>& content, Callback&& cb);
-    void remove_with_query(const transaction_get_result& document, VoidCallback&& cb);
-
-    void commit_with_query(VoidCallback&& cb);
-    void rollback_with_query(VoidCallback&& cb);
-
-    void query_begin_work(std::optional<std::string> query_context, std::function<void(std::exception_ptr)>&& cb);
-
-    void do_query(const std::string& statement,
+private:
+  std::shared_ptr<transaction_context> overall_;
+  std::optional<core::document_id> atr_id_;
+  bool is_done_{ false };
+  std::unique_ptr<staged_mutation_queue> staged_mutations_;
+  attempt_context_testing_hooks& hooks_;
+  error_list errors_;
+  std::mutex mutex_;
+  waitable_op_list op_list_;
+  std::string query_context_;
+
+  // commit needs to access the hooks
+  friend class staged_mutation_queue;
+  // entry needs access to private members
+  friend class atr_cleanup_entry;
+  // transaction_context needs access to the two functions below
+  friend class transaction_context;
+
+  auto insert_raw(const collection& coll, const std::string& id, codec::encoded_value content)
+    -> std::pair<couchbase::error, couchbase::transactions::transaction_get_result> override;
+  auto insert_raw(const core::document_id& id, codec::encoded_value content)
+    -> core::transactions::transaction_get_result override;
+
+  void insert_raw(const collection& coll,
+                  std::string id,
+                  codec::encoded_value content,
+                  couchbase::transactions::async_result_handler&& handler) override;
+
+  void insert_raw(
+    const core::document_id& id,
+    codec::encoded_value content,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb) override;
+
+  auto replace_raw(const couchbase::transactions::transaction_get_result& doc,
+                   codec::encoded_value content)
+    -> std::pair<couchbase::error, couchbase::transactions::transaction_get_result> override;
+
+  auto replace_raw(const transaction_get_result& document,
+                   codec::encoded_value content) -> transaction_get_result override;
+
+  void replace_raw(couchbase::transactions::transaction_get_result doc,
+                   codec::encoded_value content,
+                   couchbase::transactions::async_result_handler&& handler) override;
+
+  void replace_raw(
+    const transaction_get_result& document,
+    codec::encoded_value content,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb) override;
+
+  void remove_staged_insert(const core::document_id& id, VoidCallback&& cb);
+
+  void get_with_query(
+    const core::document_id& id,
+    bool optional,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb);
+  void insert_raw_with_query(
+    const core::document_id& id,
+    codec::encoded_value content,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb);
+  void replace_raw_with_query(
+    const transaction_get_result& document,
+    codec::encoded_value content,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb);
+  void remove_with_query(const transaction_get_result& document, VoidCallback&& cb);
+
+  void commit_with_query(VoidCallback&& cb);
+  void rollback_with_query(VoidCallback&& cb);
+
+  void query_begin_work(std::optional<std::string> query_context, VoidCallback&& cb);
+
+  void do_query(const std::string& statement,
+                const couchbase::transactions::transaction_query_options& opts,
+                std::optional<std::string> query_context,
+                QueryCallback&& cb);
+  auto handle_query_error(const core::operations::query_response& resp) -> std::exception_ptr;
+  void wrap_query(const std::string& statement,
                   const couchbase::transactions::transaction_query_options& opts,
+                  std::vector<core::json_string> params,
+                  const tao::json::value& txdata,
+                  const std::string& hook_point,
+                  bool check_expiry,
                   std::optional<std::string> query_context,
-                  QueryCallback&& cb);
-    std::exception_ptr handle_query_error(const core::operations::query_response& resp);
-    void wrap_query(const std::string& statement,
-                    const couchbase::transactions::transaction_query_options& opts,
-                    const std::vector<core::json_string>& params,
-                    const tao::json::value& txdata,
-                    const std::string& hook_point,
-                    bool check_expiry,
-                    std::optional<std::string> query_context,
-                    std::function<void(std::exception_ptr, core::operations::query_response)>&& cb);
-
-    void handle_err_from_callback(std::exception_ptr e)
-    {
-        try {
-            throw e;
-        } catch (const transaction_operation_failed& ex) {
-            CB_ATTEMPT_CTX_LOG_ERROR(this, "op callback called a txn operation that threw exception {}", ex.what());
-            op_list_.decrement_ops();
-            // presumably that op called op_completed_with_error already, so
-            // don't do anything here but swallow it.
-        } catch (const async_operation_conflict& op_ex) {
-            // the count isn't changed when this is thrown, so just swallow it and log
-            CB_ATTEMPT_CTX_LOG_ERROR(this, "op callback called a txn operation that threw exception {}", op_ex.what());
-        } catch (const op_exception& op_ex) {
-            CB_ATTEMPT_CTX_LOG_WARNING(
-              this, "op callback called a txn operation that threw (and didn't handle) a op_exception {}", op_ex.what());
-            errors_.push_back(
-              transaction_operation_failed(error_class_from_external_exception(op_ex.cause()), op_ex.what()).cause(op_ex.cause()));
-            op_list_.decrement_ops();
-        } catch (const std::exception& std_ex) {
-            // if the callback throws something which wasn't handled
-            // we just want to handle as a rollback
-            CB_ATTEMPT_CTX_LOG_ERROR(this, "op callback threw exception {}", std_ex.what());
-            errors_.push_back(transaction_operation_failed(FAIL_OTHER, std_ex.what()));
-            op_list_.decrement_ops();
-        } catch (...) {
-            // could be something really arbitrary, still...
-            CB_ATTEMPT_CTX_LOG_ERROR(this, "op callback threw unexpected exception");
-            errors_.push_back(transaction_operation_failed(FAIL_OTHER, "unexpected error"));
-            op_list_.decrement_ops();
-        }
-    }
-    template<typename Cb, typename T>
-    void op_completed_with_callback(Cb&& cb, std::optional<T> t)
-    {
-        try {
-            op_list_.decrement_in_flight();
-            cb({}, t);
-            op_list_.decrement_ops();
-        } catch (...) {
-            handle_err_from_callback(std::current_exception());
-        }
-    }
-
-    template<typename Cb>
-    void op_completed_with_callback(Cb&& cb)
-    {
-        try {
-            op_list_.decrement_in_flight();
-            cb({});
-            op_list_.decrement_ops();
-        } catch (...) {
-            handle_err_from_callback(std::current_exception());
-        }
-    }
-
-    template<typename E>
-    void op_completed_with_error(std::function<void(std::exception_ptr)>&& cb, E err)
-    {
-        return op_completed_with_error(std::move(cb), std::make_exception_ptr(err));
-    }
-
-    void op_completed_with_error(std::function<void(std::exception_ptr)>&& cb, std::exception_ptr err)
-    {
-        try {
-            std::rethrow_exception(err);
-        } catch (const transaction_operation_failed& e) {
-            // if this is a transaction_operation_failed, we need to cache it before moving on...
-            errors_.push_back(e);
-            try {
-                op_list_.decrement_in_flight();
-                cb(std::current_exception());
-                op_list_.decrement_ops();
-            } catch (...) {
-                handle_err_from_callback(std::current_exception());
-            }
-        } catch (...) {
-            try {
-                op_list_.decrement_in_flight();
-                cb(std::current_exception());
-                op_list_.decrement_ops();
-            } catch (...) {
-                handle_err_from_callback(std::current_exception());
-            }
-        }
-    }
-
-    template<typename Ret, typename E>
-    void op_completed_with_error(std::function<void(std::exception_ptr, std::optional<Ret>)>&& cb, E err)
-    {
-        return op_completed_with_error(std::move(cb), std::make_exception_ptr(err));
-    }
-
-    template<typename Ret>
-    void op_completed_with_error(std::function<void(std::exception_ptr, std::optional<Ret>)>&& cb, std::exception_ptr err)
-    {
-        try {
-            std::rethrow_exception(err);
-        } catch (const transaction_operation_failed& e) {
-            // if this is a transaction_operation_failed, we need to cache it before moving on...
-            errors_.push_back(e);
-            try {
-                op_list_.decrement_in_flight();
-                cb(std::current_exception(), std::optional<Ret>());
-                op_list_.decrement_ops();
-            } catch (...) {
-                handle_err_from_callback(std::current_exception());
-            }
-        } catch (...) {
-            try {
-                op_list_.decrement_in_flight();
-                cb(std::current_exception(), std::optional<Ret>());
-                op_list_.decrement_ops();
-            } catch (...) {
-                handle_err_from_callback(std::current_exception());
-            }
-        }
-    }
-    template<typename Ret>
-    void op_completed_with_error_no_cache(std::function<void(std::exception_ptr, std::optional<Ret>)>&& cb, std::exception_ptr err)
-    {
-        try {
-            cb(err, std::optional<Ret>());
-        } catch (...) {
-            // eat it.
-        }
-    }
-
-    void op_completed_with_error_no_cache(std::function<void(std::exception_ptr)>&& cb, std::exception_ptr err)
-    {
-        try {
-            cb(err);
-        } catch (...) {
-            // just eat it.
-        }
-    }
-
-    template<typename Handler>
-    void cache_error_async(Handler cb, std::function<void()> func)
-    {
-        try {
-            op_list_.increment_ops();
-            existing_error();
-            return func();
-        } catch (const async_operation_conflict& e) {
-            CB_ATTEMPT_CTX_LOG_ERROR(this, "Attempted to perform txn operation after commit/rollback started: {}", e.what());
-            // you cannot call op_completed_with_error, as it tries to decrement
-            // the op count, however it didn't successfully increment it, so...
-            auto err = transaction_operation_failed(FAIL_OTHER, "async operation conflict");
-            switch (state()) {
-                case attempt_state::ABORTED:
-                case attempt_state::ROLLED_BACK:
-                    err.cause(TRANSACTION_ALREADY_ABORTED);
-                    break;
-                case attempt_state::COMMITTED:
-                case attempt_state::COMPLETED:
-                    err.cause(TRANSACTION_ALREADY_COMMITTED);
-                    break;
-                default:
-                    err.cause(UNKNOWN);
-            }
-            op_completed_with_error_no_cache(std::move(cb), std::make_exception_ptr(err));
-        } catch (const transaction_operation_failed& e) {
-            // thrown only from call_func when previous error exists, so eat it, unless
-            // it has PREVIOUS_OP_FAILED cause
-            if (e.cause() == PREVIOUS_OPERATION_FAILED) {
-                op_completed_with_error(std::move(cb), e);
-            }
-        } catch (const op_exception& e) {
-            op_completed_with_error(std::move(cb), e);
-        } catch (const std::exception& e) {
-            op_completed_with_error(std::move(cb), transaction_operation_failed(FAIL_OTHER, e.what()));
-        }
-    }
-
-    const core::cluster& cluster_ref() const;
-
-  public:
-    explicit attempt_context_impl(transaction_context& transaction_ctx);
-    ~attempt_context_impl() override;
-
-    transaction_get_result get(const core::document_id& id) override;
-    std::pair<couchbase::transaction_op_error_context, couchbase::transactions::transaction_get_result> get(
-      const couchbase::collection& coll,
-      const std::string& id) override
-    {
-        auto [ctx, res] = wrap_call_for_public_api([this, coll, id]() mutable -> transaction_get_result {
-            auto ret = get_optional({ coll.bucket_name(), coll.scope_name(), coll.name(), id });
-            if (ret) {
-                return ret.value();
-            }
-            return {};
-        });
-        if (!ctx.ec() && res.cas().empty()) {
-            return { transaction_op_error_context{ errc::transaction_op::document_not_found_exception }, res };
-        }
-        return { ctx, res };
-    }
-    void get(const couchbase::collection& coll, std::string id, couchbase::transactions::async_result_handler&& handler) override
-    {
-        get_optional({ coll.bucket_name(), coll.scope_name(), coll.name(), std::move(id) },
-                     [this, handler = std::move(handler)](std::exception_ptr err, std::optional<transaction_get_result> res) mutable {
-                         if (!res) {
-                             return handler(transaction_op_error_context{ errc::transaction_op::document_not_found_exception }, {});
-                         }
-                         return wrap_callback_for_async_public_api(err, res, std::move(handler));
-                     });
-    }
-    void get(const core::document_id& id, Callback&& cb) override;
-
-    std::optional<transaction_get_result> get_optional(const core::document_id& id) override;
-    void get_optional(const core::document_id& id, Callback&& cb) override;
-
-    void remove(const transaction_get_result& document) override;
-    couchbase::transaction_op_error_context remove(const couchbase::transactions::transaction_get_result& doc) override
-    {
-        return wrap_void_call_for_public_api([this, doc]() { remove(transaction_get_result(doc)); });
-    }
-    void remove(const transaction_get_result& document, VoidCallback&& cb) override;
-    void remove(couchbase::transactions::transaction_get_result doc, couchbase::transactions::async_err_handler&& handler) override
-    {
-        remove(transaction_get_result(doc), [this, handler = std::move(handler)](std::exception_ptr e) mutable {
-            wrap_err_callback_for_async_api(e, std::move(handler));
-        });
-    };
-
-    core::operations::query_response do_core_query(const std::string& statement,
-                                                   const couchbase::transactions::transaction_query_options& options,
-                                                   std::optional<std::string> query_context) override;
-
-    std::pair<couchbase::transaction_op_error_context, couchbase::transactions::transaction_query_result> do_public_query(
-      const std::string& statement,
-      const couchbase::transactions::transaction_query_options& opts,
-      std::optional<std::string> query_context) override;
-
-    void query(const std::string& statement,
-               const couchbase::transactions::transaction_query_options& options,
-               std::optional<std::string> query_context,
-               QueryCallback&& cb) override;
-
-    void query(std::string statement,
-               couchbase::transactions::transaction_query_options opts,
-               std::optional<std::string> query_context,
-               couchbase::transactions::async_query_handler&& handler) override
-    {
-        query(statement,
-              opts,
-              query_context,
-              [handler = std::move(handler)](std::exception_ptr err, std::optional<core::operations::query_response> resp) {
-                  if (err) {
-                      try {
-                          std::rethrow_exception(err);
-                      } catch (const transaction_operation_failed& e) {
-                          return handler(e.get_error_ctx(), {});
-                      } catch (const op_exception& ex) {
-                          return handler(ex.ctx(), {});
-                      } catch (...) {
-                          // just in case...
-                          return handler(transaction_op_error_context(couchbase::errc::transaction_op::unknown), {});
-                      }
-                  }
-                  auto [ctx, res] = core::impl::build_transaction_query_result(*resp);
-                  handler(ctx, res);
-              });
-    }
-
-    void commit() override;
-    void commit(VoidCallback&& cb) override;
-    void rollback() override;
-    void rollback(VoidCallback&& cb) override;
-
-    void existing_error(bool prev_op_failed = true)
-    {
-        if (!errors_.empty()) {
-            errors_.do_throw((prev_op_failed ? std::make_optional(PREVIOUS_OPERATION_FAILED) : std::nullopt));
-        }
-    }
-
-    [[nodiscard]] bool is_done()
-    {
-        return is_done_;
-    }
-
-    [[nodiscard]] transaction_context& overall()
-    {
-        return overall_;
-    }
+                  std::function<void(std::exception_ptr, core::operations::query_response)>&& cb);
+
+  void handle_err_from_callback(std::exception_ptr e);
+
+  template<typename Cb, typename T>
+  void op_completed_with_callback(Cb&& cb, std::optional<T> t)
+  {
+    try {
+      op_list_.decrement_in_flight();
+      cb({}, t);
+      op_list_.decrement_ops();
+    } catch (...) {
+      handle_err_from_callback(std::current_exception());
+    }
+  }
+
+  template<typename Cb>
+  void op_completed_with_callback(Cb&& cb)
+  {
+    try {
+      op_list_.decrement_in_flight();
+      cb({});
+      op_list_.decrement_ops();
+    } catch (...) {
+      handle_err_from_callback(std::current_exception());
+    }
+  }
+
+  template<typename ErrorHandler, typename ExceptionType>
+  void op_completed_with_error(ErrorHandler&& cb, ExceptionType&& err)
+  {
+    return op_completed_with_error(std::forward<ErrorHandler>(cb),
+                                   std::make_exception_ptr(std::forward<ExceptionType>(err)));
+  }
+
+  void op_completed_with_error(VoidCallback cb, std::exception_ptr err);
+
+  template<typename Ret>
+  void op_completed_with_error(std::function<void(std::exception_ptr, std::optional<Ret>)> cb,
+                               std::exception_ptr&& err)
+  {
+    try {
+      std::rethrow_exception(std::move(err));
+    } catch (const transaction_operation_failed& e) {
+      // if this is a transaction_operation_failed, we need to cache it before
+      // moving on...
+      errors_.push_back(e);
+      try {
+        op_list_.decrement_in_flight();
+        cb(std::current_exception(), std::optional<Ret>());
+        op_list_.decrement_ops();
+      } catch (...) {
+        handle_err_from_callback(std::current_exception());
+      }
+    } catch (...) {
+      try {
+        op_list_.decrement_in_flight();
+        cb(std::current_exception(), std::optional<Ret>());
+        op_list_.decrement_ops();
+      } catch (...) {
+        handle_err_from_callback(std::current_exception());
+      }
+    }
+  }
+
+  template<typename Ret>
+  void op_completed_with_error_no_cache(
+    std::function<void(std::exception_ptr, std::optional<Ret>)>&& cb,
+    std::exception_ptr err)
+  {
+    try {
+      cb(err, std::optional<Ret>());
+    } catch (...) {
+      // eat it.
+    }
+  }
+
+  void op_completed_with_error_no_cache(VoidCallback&& cb, std::exception_ptr err)
+  {
+    try {
+      cb(std::move(err));
+    } catch (...) {
+      // just eat it.
+    }
+  }
+
+  template<typename Handler>
+  void cache_error_async(Handler cb, std::function<void()> func)
+  {
+    try {
+      op_list_.increment_ops();
+      existing_error();
+      return func();
+    } catch (const async_operation_conflict& e) {
+      CB_ATTEMPT_CTX_LOG_ERROR(this,
+                               "Attempted to perform txn operation after "
+                               "commit/rollback started: {}",
+                               e.what());
+      // you cannot call op_completed_with_error, as it tries to decrement
+      // the op count, however it didn't successfully increment it, so...
+      auto err = transaction_operation_failed(FAIL_OTHER, "async operation conflict");
+      switch (state()) {
+        case attempt_state::ABORTED:
+        case attempt_state::ROLLED_BACK:
+          err.cause(TRANSACTION_ALREADY_ABORTED);
+          break;
+        case attempt_state::COMMITTED:
+        case attempt_state::COMPLETED:
+          err.cause(TRANSACTION_ALREADY_COMMITTED);
+          break;
+        default:
+          err.cause(UNKNOWN);
+      }
+      op_completed_with_error_no_cache(std::move(cb), std::make_exception_ptr(err));
+    } catch (const transaction_operation_failed& e) {
+      // thrown only from call_func when previous error exists, so eat it,
+      // unless it has PREVIOUS_OP_FAILED or FEATURE_NOT_AVAILABLE_EXCEPTION
+      // cause
+      if (e.cause() == PREVIOUS_OPERATION_FAILED || e.cause() == FEATURE_NOT_AVAILABLE_EXCEPTION) {
+        op_completed_with_error(std::move(cb), e);
+      }
+    } catch (const op_exception& e) {
+      op_completed_with_error(std::move(cb), e);
+    } catch (const std::exception& e) {
+      op_completed_with_error(std::move(cb), transaction_operation_failed(FAIL_OTHER, e.what()));
+    }
+  }
+
+  [[nodiscard]] auto cluster_ref() const -> const core::cluster&;
+
+  explicit attempt_context_impl(std::shared_ptr<transaction_context> transaction_ctx);
+
+public:
+  static auto create(std::shared_ptr<transaction_context> transaction_ctx)
+    -> std::shared_ptr<attempt_context_impl>;
+
+  ~attempt_context_impl() override;
+  attempt_context_impl(attempt_context_impl&) = delete;
+  attempt_context_impl(attempt_context_impl&&) = delete;
+  auto operator=(attempt_context_impl&) -> attempt_context_impl& = delete;
+  auto operator=(attempt_context_impl&&) -> attempt_context_impl& = delete;
+
+  auto get(const core::document_id& id) -> transaction_get_result override;
+  auto get(const couchbase::collection& coll, const std::string& id)
+    -> std::pair<couchbase::error, couchbase::transactions::transaction_get_result> override;
+  void get(const couchbase::collection& coll,
+           std::string id,
+           couchbase::transactions::async_result_handler&& handler) override;
+  void get(
+    const core::document_id& id,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb) override;
+
+  auto get_optional(const core::document_id& id) -> std::optional<transaction_get_result> override;
+  void get_optional(
+    const core::document_id& id,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb) override;
+
+  auto get_replica_from_preferred_server_group(const core::document_id& id)
+    -> std::optional<transaction_get_result> override;
+  void get_replica_from_preferred_server_group(
+    const core::document_id& id,
+    std::function<void(std::exception_ptr, std::optional<transaction_get_result>)>&& cb) override;
+  auto get_replica_from_preferred_server_group(const couchbase::collection& coll,
+                                               const std::string& id)
+    -> std::pair<couchbase::error, couchbase::transactions::transaction_get_result> override;
+  void get_replica_from_preferred_server_group(
+    const couchbase::collection& coll,
+    const std::string& id,
+    couchbase::transactions::async_result_handler&& handler) override;
+
+  void remove(const transaction_get_result& document) override;
+  auto remove(const couchbase::transactions::transaction_get_result& doc)
+    -> couchbase::error override;
+  void remove(const transaction_get_result& document, VoidCallback&& cb) override;
+  void remove(couchbase::transactions::transaction_get_result doc,
+              couchbase::transactions::async_err_handler&& handler) override;
+
+  auto do_core_query(const std::string& statement,
+                     const couchbase::transactions::transaction_query_options& options,
+                     std::optional<std::string> query_context)
+    -> core::operations::query_response override;
+
+  auto do_public_query(const std::string& statement,
+                       const couchbase::transactions::transaction_query_options& opts,
+                       std::optional<std::string> query_context)
+    -> std::pair<couchbase::error, couchbase::transactions::transaction_query_result> override;
+
+  void query(const std::string& statement,
+             const couchbase::transactions::transaction_query_options& options,
+             std::optional<std::string> query_context,
+             QueryCallback&& cb) override;
+
+  void query(std::string statement,
+             couchbase::transactions::transaction_query_options opts,
+             std::optional<std::string> query_context,
+             couchbase::transactions::async_query_handler&& handler) override;
+
+  void commit() override;
+  void commit(VoidCallback&& cb) override;
+  void rollback() override;
+  void rollback(VoidCallback&& cb) override;
+
+  void existing_error(bool prev_op_failed = true);
+
+  [[nodiscard]] auto is_done() const -> bool
+  {
+    return is_done_;
+  }
+
+  [[nodiscard]] auto overall() -> std::shared_ptr<transaction_context>
+  {
+    return overall_;
+  }
+
+  [[nodiscard]] auto transaction_id() const -> const std::string&
+  {
+    return overall_->transaction_id();
+  }
+
+  [[nodiscard]] auto id() const -> const std::string&
+  {
+    return overall_->current_attempt().id;
+  }
+
+  [[nodiscard]] auto state() -> attempt_state
+  {
+    return overall_->current_attempt().state;
+  }
+
+  void state(attempt_state s)
+  {
+    overall_->current_attempt_state(s);
+  }
+
+  [[nodiscard]] auto atr_id() const -> const std::string&
+  {
+    return overall_->atr_id();
+  }
+
+  void atr_id(const std::string& atr_id)
+  {
+    overall_->atr_id(atr_id);
+  }
+
+  [[nodiscard]] auto atr_collection() const -> const std::string&
+  {
+    return overall_->atr_collection();
+  }
+
+  void atr_collection_name(const std::string& coll)
+  {
+    overall_->atr_collection(coll);
+  }
+
+  auto has_expired_client_side(std::string place, std::optional<const std::string> doc_id) -> bool;
+
+private:
+  std::atomic<bool> expiry_overtime_mode_{ false };
+
+  auto check_expiry_pre_commit(std::string stage, std::optional<const std::string> doc_id) -> bool;
+
+  void check_expiry_during_commit_or_rollback(const std::string& stage,
+                                              std::optional<const std::string> doc_id);
+
+  void set_atr_pending_locked(
+    const core::document_id& id,
+    std::unique_lock<std::mutex>&& lock,
+    std::function<void(std::optional<transaction_operation_failed>)>&& fn);
+
+  auto error_if_expired_and_not_in_overtime(const std::string& stage,
+                                            std::optional<const std::string> doc_id)
+    -> std::optional<error_class>;
+
+  auto check_for_own_write(const core::document_id& id) -> staged_mutation*;
+
+  void check_and_handle_blocking_transactions(
+    const transaction_get_result& doc,
+    forward_compat_stage stage,
+    std::function<void(std::optional<transaction_operation_failed>)>&& cb);
+
+  template<typename Handler, typename Delay>
+  void check_atr_entry_for_blocking_document(const transaction_get_result& doc,
+                                             Delay delay,
+                                             Handler&& cb);
+
+  template<typename Handler>
+  void check_if_done(Handler& cb);
+
+  void atr_commit(bool ambiguity_resolution_mode);
+
+  void atr_commit_ambiguity_resolution();
+
+  void atr_complete();
+
+  void atr_abort();
+
+  void atr_rollback_complete();
+
+  void select_atr_if_needed_unlocked(
+    const core::document_id& id,
+    std::function<void(std::optional<transaction_operation_failed>)>&& cb);
+
+  template<typename Handler>
+  void do_get(const core::document_id& id,
+              bool allow_replica,
+              std::optional<std::string> resolving_missing_atr_entry,
+              Handler&& cb);
+
+  void get_doc(const core::document_id& id,
+               bool allow_replica,
+               std::function<void(std::optional<error_class>,
+                                  std::optional<std::string>,
+                                  std::optional<transaction_get_result>)>&& cb);
+
+  auto create_document_metadata(const std::string& operation_type,
+                                const std::string& operation_id,
+                                const std::optional<document_metadata>& document_metadata,
+                                std::uint32_t user_flags_to_stage) -> tao::json::value;
+
+  template<typename Handler, typename Delay>
+  void create_staged_insert(const core::document_id& id,
+                            codec::encoded_value content,
+                            uint64_t cas,
+                            Delay&& delay,
+                            const std::string& op_id,
+                            Handler&& cb);
+
+  template<typename Handler>
+  void create_staged_replace(const transaction_get_result& document,
+                             codec::encoded_value content,
+                             const std::string& op_id,
+                             Handler&& cb);
+
+  template<typename Handler, typename Delay>
+  void create_staged_insert_error_handler(const core::document_id& id,
+                                          codec::encoded_value content,
+                                          uint64_t cas,
+                                          Delay&& delay,
+                                          const std::string& op_id,
+                                          Handler&& cb,
+                                          error_class ec,
+                                          external_exception cause,
+                                          const std::string& message);
 
-    [[nodiscard]] const std::string& transaction_id()
-    {
-        return overall_.transaction_id();
-    }
-
-    [[nodiscard]] const std::string& id()
-    {
-        return overall_.current_attempt().id;
-    }
-
-    [[nodiscard]] attempt_state state()
-    {
-        return overall_.current_attempt().state;
-    }
-
-    void state(attempt_state s)
-    {
-        overall_.current_attempt_state(s);
-    }
-
-    [[nodiscard]] const std::string atr_id()
-    {
-        return overall_.atr_id();
-    }
-
-    void atr_id(const std::string& atr_id)
-    {
-        overall_.atr_id(atr_id);
-    }
-
-    [[nodiscard]] const std::string atr_collection()
-    {
-        return overall_.atr_collection();
-    }
-
-    void atr_collection_name(const std::string& coll)
-    {
-        overall_.atr_collection(coll);
-    }
-
-    bool has_expired_client_side(std::string place, std::optional<const std::string> doc_id);
-
-  private:
-    std::atomic<bool> expiry_overtime_mode_{ false };
-
-    bool check_expiry_pre_commit(std::string stage, std::optional<const std::string> doc_id);
-
-    void check_expiry_during_commit_or_rollback(const std::string& stage, std::optional<const std::string> doc_id);
-
-    template<typename Handler>
-    void set_atr_pending_locked(const core::document_id& collection, std::unique_lock<std::mutex>&& lock, Handler&& cb);
-
-    std::optional<error_class> error_if_expired_and_not_in_overtime(const std::string& stage, std::optional<const std::string> doc_id);
-
-    staged_mutation* check_for_own_write(const core::document_id& id);
-
-    template<typename Handler>
-    void check_and_handle_blocking_transactions(const transaction_get_result& doc, forward_compat_stage stage, Handler&& cb);
-
-    template<typename Handler, typename Delay>
-    void check_atr_entry_for_blocking_document(const transaction_get_result& doc, Delay delay, Handler&& cb);
-
-    template<typename Handler>
-    void check_if_done(Handler& cb);
-
-    void atr_commit(bool ambiguity_resolution_mode);
-
-    void atr_commit_ambiguity_resolution();
-
-    void atr_complete();
-
-    void atr_abort();
-
-    void atr_rollback_complete();
-
-    void select_atr_if_needed_unlocked(const core::document_id id, std::function<void(std::optional<transaction_operation_failed>)>&& cb);
-
-    template<typename Handler>
-    void do_get(const core::document_id& id, const std::optional<std::string> resolving_missing_atr_entry, Handler&& cb);
-
-    void get_doc(const core::document_id& id,
-                 std::function<void(std::optional<error_class>, std::optional<std::string>, std::optional<transaction_get_result>)>&& cb);
-
-    core::operations::mutate_in_request create_staging_request(const core::document_id& in,
-                                                               const transaction_get_result* document,
-                                                               const std::string type,
-                                                               const std::string op_id,
-                                                               std::optional<std::vector<std::byte>> content = std::nullopt);
-
-    template<typename Handler, typename Delay>
-    void create_staged_insert(const core::document_id& id,
-                              const std::vector<std::byte>& content,
-                              uint64_t cas,
-                              Delay&& delay,
-                              const std::string& op_id,
-                              Handler&& cb);
-
-    template<typename Handler>
-    void create_staged_replace(const transaction_get_result& document,
-                               const std::vector<std::byte>& content,
-                               const std::string& op_id,
-                               Handler&& cb);
-
-    template<typename Handler, typename Delay>
-    void create_staged_insert_error_handler(const core::document_id& id,
-                                            const std::vector<std::byte>& content,
-                                            uint64_t cas,
-                                            Delay&& delay,
-                                            const std::string& op_id,
-                                            Handler&& cb,
-                                            error_class ec,
-                                            const std::string& message);
-
-    std::pair<couchbase::transaction_op_error_context, couchbase::transactions::transaction_get_result> wrap_call_for_public_api(
-      std::function<transaction_get_result()>&& handler)
-    {
-        try {
-            return { {}, handler().to_public_result() };
-        } catch (const transaction_operation_failed& e) {
-            return { e.get_error_ctx(), {} };
-        } catch (const op_exception& ex) {
-            return { ex.ctx(), {} };
-        } catch (...) {
-            // the handler should catch everything else, but just in case...
-            return { transaction_op_error_context(errc::transaction_op::unknown), {} };
-        }
-    }
-
-    couchbase::transaction_op_error_context wrap_void_call_for_public_api(std::function<void()>&& handler)
-    {
-        try {
-            handler();
-            return {};
-        } catch (const transaction_operation_failed& e) {
-            return e.get_error_ctx();
-        } catch (...) {
-            // the handler should catch everything else, but just in case...
-            return transaction_op_error_context(errc::transaction_op::unknown);
-        }
-    }
-
-    void wrap_callback_for_async_public_api(
-      std::exception_ptr err,
-      std::optional<transaction_get_result> res,
-      std::function<void(couchbase::transaction_op_error_context, couchbase::transactions::transaction_get_result)>&& cb)
-    {
-        if (res) {
-            return cb({}, res->to_public_result());
-        }
-        if (err) {
-            try {
-                std::rethrow_exception(err);
-            } catch (const op_exception& e) {
-                return cb(e.ctx(), {});
-            } catch (const transaction_operation_failed& e) {
-                return cb(e.get_error_ctx(), {});
-            } catch (...) {
-                return cb(transaction_op_error_context(errc::transaction_op::unknown), {});
-            }
-        }
-        return cb(transaction_op_error_context(errc::transaction_op::unknown), {});
-    }
-
-    void wrap_err_callback_for_async_api(std::exception_ptr err, std::function<void(couchbase::transaction_op_error_context)>&& cb)
-    {
-        if (err) {
-            try {
-                std::rethrow_exception(err);
-            } catch (const transaction_operation_failed& e) {
-                return cb(e.get_error_ctx());
-            } catch (...) {
-                return cb({ errc::transaction_op::unknown });
-            }
-        }
-        return cb({});
-    }
-
-    void ensure_open_bucket(std::string bucket_name, std::function<void(std::error_code)>&& handler)
-    {
-        if (bucket_name.empty()) {
-            CB_LOG_DEBUG("ensure_open_bucket called with empty bucket_name");
-            return handler(couchbase::errc::common::bucket_not_found);
-        }
-        cluster_ref().open_bucket(bucket_name, [handler = std::move(handler)](std::error_code ec) { handler(ec); });
-    }
+  void ensure_open_bucket(const std::string& bucket_name,
+                          std::function<void(std::error_code)>&& handler);
 };
 
-} // namespace couchbase::core::transactions
+} // namespace transactions
+} // namespace couchbase::core