couchbase 3.4.3 → 3.4.4

data/ext/couchbase/core/impl/lookup_in_all_replicas.hxx

@@ -0,0 +1,80 @@
+/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *   Copyright 2020-Present Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#pragma once
+
+#include <couchbase/lookup_in_all_replicas_options.hxx>
+#include <couchbase/lookup_in_replica_result.hxx>
+
+#include "core/document_id.hxx"
+#include "core/error_context/key_value.hxx"
+#include "core/utils/movable_function.hxx"
+
+#include <vector>
+
+namespace couchbase::core::impl
+{
+
+class lookup_in_all_replicas_request
+{
+  public:
+    explicit lookup_in_all_replicas_request(std::string bucket_name,
+                                            std::string scope_name,
+                                            std::string collection_name,
+                                            std::string document_key,
+                                            std::vector<couchbase::core::impl::subdoc::command> specs,
+                                            std::optional<std::chrono::milliseconds> timeout)
+      : id_{ std::move(bucket_name), std::move(scope_name), std::move(collection_name), std::move(document_key) }
+      , specs_{ std::move(specs) }
+      , timeout_{ timeout }
+    {
+    }
+
+    [[nodiscard]] const auto& id() const
+    {
+        return id_;
+    }
+
+    [[nodiscard]] const auto& specs() const
+    {
+        return specs_;
+    }
+
+    [[nodiscard]] const auto& timeout() const
+    {
+        return timeout_;
+    }
+
+  private:
+    core::document_id id_;
+    std::vector<couchbase::core::impl::subdoc::command> specs_;
+    std::optional<std::chrono::milliseconds> timeout_{};
+};
+
+using movable_lookup_in_all_replicas_handler =
+  utils::movable_function<void(couchbase::subdocument_error_context, lookup_in_all_replicas_result)>;
+
+void
+initiate_lookup_in_all_replicas_operation(std::shared_ptr<cluster> core,
+                                          const std::string& bucket_name,
+                                          const std::string& scope_name,
+                                          const std::string& collection_name,
+                                          std::string document_key,
+                                          const std::vector<subdoc::command>& specs,
+                                          std::optional<std::chrono::milliseconds> timeout,
+                                          movable_lookup_in_all_replicas_handler&& handler);
+} // namespace couchbase::core::impl

data/ext/couchbase/core/impl/lookup_in_any_replica.cxx

@@ -0,0 +1,167 @@
+/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *   Copyright 2020-Present Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#include "lookup_in_any_replica.hxx"
+#include "lookup_in_replica.hxx"
+
+#include "core/cluster.hxx"
+#include "core/error_context/key_value.hxx"
+#include "core/operations/document_lookup_in.hxx"
+#include "core/topology/configuration.hxx"
+
+namespace couchbase::core::impl
+{
+void
+initiate_lookup_in_any_replica_operation(std::shared_ptr<cluster> core,
+                                         const std::string& bucket_name,
+                                         const std::string& scope_name,
+                                         const std::string& collection_name,
+                                         std::string document_key,
+                                         const std::vector<subdoc::command>& specs,
+                                         lookup_in_any_replica_options::built options,
+                                         lookup_in_any_replica_handler&& handler)
+{
+    return initiate_lookup_in_any_replica_operation(std::move(core),
+                                                    bucket_name,
+                                                    scope_name,
+                                                    collection_name,
+                                                    std::move(document_key),
+                                                    specs,
+                                                    options.timeout,
+                                                    movable_lookup_in_any_replica_handler{ std::move(handler) });
+}
+
+void
+initiate_lookup_in_any_replica_operation(std::shared_ptr<cluster> core,
+                                         const std::string& bucket_name,
+                                         const std::string& scope_name,
+                                         const std::string& collection_name,
+                                         std::string document_key,
+                                         const std::vector<subdoc::command>& specs,
+                                         std::optional<std::chrono::milliseconds> timeout,
+                                         movable_lookup_in_any_replica_handler&& handler)
+{
+    auto request = std::make_shared<couchbase::core::impl::lookup_in_any_replica_request>(
+      bucket_name, scope_name, collection_name, std::move(document_key), specs, timeout);
+    core->with_bucket_configuration(
+      bucket_name,
+      [core, r = std::move(request), h = std::move(handler)](std::error_code ec, const core::topology::configuration& config) mutable {
+          if (!config.supports_subdoc_read_replica()) {
+              ec = errc::common::feature_not_available;
+          }
+          if (r->specs().size() > 16) {
+              ec = errc::common::invalid_argument;
+          }
+          if (ec) {
+              std::optional<std::string> first_error_path{};
+              std::optional<std::size_t> first_error_index{};
+              return h(
+                make_subdocument_error_context(make_key_value_error_context(ec, r->id()), ec, first_error_path, first_error_index, false),
+                lookup_in_replica_result{});
+          }
+          struct replica_context {
+              replica_context(movable_lookup_in_any_replica_handler handler, std::uint32_t expected_responses)
+                : handler_(std::move(handler))
+                , expected_responses_(expected_responses)
+              {
+              }
+
+              movable_lookup_in_any_replica_handler handler_;
+              std::uint32_t expected_responses_;
+              bool done_{ false };
+              std::mutex mutex_{};
+          };
+          auto ctx = std::make_shared<replica_context>(std::move(h), config.num_replicas.value_or(0U) + 1U);
+
+          for (std::size_t idx = 1U; idx <= config.num_replicas.value_or(0U); ++idx) {
+              document_id replica_id{ r->id() };
+              replica_id.node_index(idx);
+              core->execute(impl::lookup_in_replica_request{ std::move(replica_id), r->specs(), r->timeout() },
+                            [ctx](impl::lookup_in_replica_response&& resp) {
+                                movable_lookup_in_any_replica_handler local_handler;
+                                {
+                                    std::scoped_lock lock(ctx->mutex_);
+                                    if (ctx->done_) {
+                                        return;
+                                    }
+                                    --ctx->expected_responses_;
+                                    if (resp.ctx.ec()) {
+                                        if (ctx->expected_responses_ > 0) {
+                                            // just ignore the response
+                                            return;
+                                        }
+                                        // consider document irretrievable and give up
+                                        resp.ctx.override_ec(errc::key_value::document_irretrievable);
+                                    }
+                                    ctx->done_ = true;
+                                    std::swap(local_handler, ctx->handler_);
+                                }
+                                if (local_handler) {
+                                    std::vector<lookup_in_replica_result::entry> entries;
+                                    for (auto& field : resp.fields) {
+                                        lookup_in_replica_result::entry entry{};
+                                        entry.path = field.path;
+                                        entry.original_index = field.original_index;
+                                        entry.exists = field.exists;
+                                        entry.value = field.value;
+                                        entries.emplace_back(entry);
+                                    }
+                                    return local_handler(std::move(resp.ctx),
+                                                         lookup_in_replica_result{ resp.cas, entries, resp.deleted, true /* replica */ });
+                                }
+                            });
+          }
+
+          core::operations::lookup_in_request active{ document_id{ r->id() } };
+          active.specs = r->specs();
+          active.timeout = r->timeout();
+          core->execute(active, [ctx](core::operations::lookup_in_response&& resp) {
+              movable_lookup_in_any_replica_handler local_handler{};
+              {
+                  std::scoped_lock lock(ctx->mutex_);
+                  if (ctx->done_) {
+                      return;
+                  }
+                  --ctx->expected_responses_;
+                  if (resp.ctx.ec()) {
+                      if (ctx->expected_responses_ > 0) {
+                          // just ignore the response
+                          return;
+                      }
+                      // consider document irretrievable and give up
+                      resp.ctx.override_ec(errc::key_value::document_irretrievable);
+                  }
+                  ctx->done_ = true;
+                  std::swap(local_handler, ctx->handler_);
+              }
+              if (local_handler) {
+                  std::vector<lookup_in_replica_result::entry> entries;
+                  for (auto& field : resp.fields) {
+                      lookup_in_replica_result::entry entry{};
+                      entry.path = field.path;
+                      entry.original_index = field.original_index;
+                      entry.exists = field.exists;
+                      entry.value = field.value;
+                      entries.emplace_back(entry);
+                  }
+                  return local_handler(std::move(resp.ctx),
+                                       lookup_in_replica_result{ resp.cas, entries, resp.deleted, false /* active */ });
+              }
+          });
+      });
+}
+} // namespace couchbase::core::impl

data/ext/couchbase/core/impl/lookup_in_any_replica.hxx

@@ -0,0 +1,75 @@
+/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *   Copyright 2020-Present Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#pragma once
+
+#include <couchbase/lookup_in_any_replica_options.hxx>
+#include <couchbase/lookup_in_replica_result.hxx>
+
+#include "core/document_id.hxx"
+#include "core/utils/movable_function.hxx"
+
+namespace couchbase::core::impl
+{
+class lookup_in_any_replica_request
+{
+  public:
+    explicit lookup_in_any_replica_request(std::string bucket_name,
+                                           std::string scope_name,
+                                           std::string collection_name,
+                                           std::string document_key,
+                                           std::vector<couchbase::core::impl::subdoc::command> specs,
+                                           std::optional<std::chrono::milliseconds> timeout)
+      : id_{ std::move(bucket_name), std::move(scope_name), std::move(collection_name), std::move(document_key) }
+      , specs_{ std::move(specs) }
+      , timeout_{ timeout }
+    {
+    }
+
+    [[nodiscard]] const auto& id() const
+    {
+        return id_;
+    }
+
+    [[nodiscard]] const auto& specs() const
+    {
+        return specs_;
+    }
+
+    [[nodiscard]] const auto& timeout() const
+    {
+        return timeout_;
+    }
+
+  private:
+    core::document_id id_;
+    std::vector<couchbase::core::impl::subdoc::command> specs_;
+    std::optional<std::chrono::milliseconds> timeout_{};
+};
+
+using movable_lookup_in_any_replica_handler = utils::movable_function<void(couchbase::subdocument_error_context, lookup_in_replica_result)>;
+
+void
+initiate_lookup_in_any_replica_operation(std::shared_ptr<cluster> core,
+                                         const std::string& bucket_name,
+                                         const std::string& scope_name,
+                                         const std::string& collection_name,
+                                         std::string document_key,
+                                         const std::vector<subdoc::command>& specs,
+                                         std::optional<std::chrono::milliseconds> timeout,
+                                         movable_lookup_in_any_replica_handler&& handler);
+} // namespace couchbase::core::impl

data/ext/couchbase/core/impl/lookup_in_replica.cxx

@@ -0,0 +1,97 @@
+/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *   Copyright 2020-Present Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#include "lookup_in_replica.hxx"
+#include "core/impl/subdoc/path_flags.hxx"
+
+#include <couchbase/error_codes.hxx>
+
+namespace couchbase::core::impl
+{
+std::error_code
+lookup_in_replica_request::encode_to(lookup_in_replica_request::encoded_request_type& encoded, mcbp_context&& /* context */)
+{
+    for (std::size_t i = 0; i < specs.size(); ++i) {
+        specs[i].original_index_ = i;
+    }
+    std::stable_sort(specs.begin(), specs.end(), [](const auto& lhs, const auto& rhs) {
+        /* move XATTRs to the beginning of the vector */
+        return core::impl::subdoc::has_xattr_path_flag(lhs.flags_) && !core::impl::subdoc::has_xattr_path_flag(rhs.flags_);
+    });
+
+    encoded.opaque(opaque);
+    encoded.partition(partition);
+    encoded.body().id(id);
+    encoded.body().read_replica(true);
+    encoded.body().specs(specs);
+    return {};
+}
+
+lookup_in_replica_response
+lookup_in_replica_request::make_response(key_value_error_context&& ctx, const encoded_response_type& encoded) const
+{
+
+    bool deleted = false;
+    couchbase::cas cas{};
+    std::vector<lookup_in_replica_response::entry> fields{};
+    std::error_code ec = ctx.ec();
+    std::optional<std::size_t> first_error_index{};
+    std::optional<std::string> first_error_path{};
+
+    if (encoded.status() == key_value_status_code::subdoc_success_deleted ||
+        encoded.status() == key_value_status_code::subdoc_multi_path_failure_deleted) {
+        deleted = true;
+    }
+    if (!ctx.ec()) {
+        fields.resize(specs.size());
+        for (size_t i = 0; i < specs.size(); ++i) {
+            const auto& req_entry = specs[i];
+            fields[i].original_index = req_entry.original_index_;
+            fields[i].path = req_entry.path_;
+            fields[i].opcode = static_cast<protocol::subdoc_opcode>(req_entry.opcode_);
+            fields[i].status = key_value_status_code::success;
+        }
+        for (size_t i = 0; i < encoded.body().fields().size(); ++i) {
+            const auto& res_entry = encoded.body().fields()[i];
+            fields[i].status = res_entry.status;
+            fields[i].ec =
+              protocol::map_status_code(protocol::client_opcode::subdoc_multi_mutation, static_cast<std::uint16_t>(res_entry.status));
+            if (!fields[i].ec && !ctx.ec()) {
+                ec = fields[i].ec;
+            }
+            if (!first_error_index && !fields[i].ec) {
+                first_error_index = i;
+                first_error_path = fields[i].path;
+            }
+            fields[i].exists =
+              res_entry.status == key_value_status_code::success || res_entry.status == key_value_status_code::subdoc_success_deleted;
+            fields[i].value = utils::to_binary(res_entry.value);
+        }
+        if (!ec) {
+            cas = encoded.cas();
+        }
+        std::sort(fields.begin(), fields.end(), [](const auto& lhs, const auto& rhs) { return lhs.original_index < rhs.original_index; });
+    }
+
+    return lookup_in_replica_response{
+        make_subdocument_error_context(ctx, ec, first_error_path, first_error_index, deleted),
+        cas,
+        std::move(fields),
+        deleted,
+    };
+}
+} // namespace couchbase::core::impl

data/ext/couchbase/core/impl/lookup_in_replica.hxx

@@ -0,0 +1,67 @@
+/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *   Copyright 2020-Present Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#pragma once
+
+#include "core/error_context/key_value.hxx"
+#include "core/impl/subdoc/command.hxx"
+#include "core/io/mcbp_context.hxx"
+#include "core/io/retry_context.hxx"
+#include "core/protocol/client_request.hxx"
+#include "core/protocol/cmd_lookup_in_replica.hxx"
+#include "core/public_fwd.hxx"
+#include "core/timeout_defaults.hxx"
+
+#include <couchbase/lookup_in_result.hxx>
+#include <couchbase/subdocument_error_context.hxx>
+
+namespace couchbase::core::impl
+{
+struct lookup_in_replica_response {
+    struct entry {
+        std::string path;
+        couchbase::codec::binary value;
+        std::size_t original_index;
+        bool exists;
+        protocol::subdoc_opcode opcode;
+        key_value_status_code status;
+        std::error_code ec{};
+    };
+    subdocument_error_context ctx{};
+    couchbase::cas cas{};
+    std::vector<entry> fields{};
+    bool deleted{ false };
+};
+
+struct lookup_in_replica_request {
+    using response_type = lookup_in_replica_response;
+    using encoded_request_type = protocol::client_request<protocol::lookup_in_replica_request_body>;
+    using encoded_response_type = protocol::client_response<protocol::lookup_in_replica_response_body>;
+
+    document_id id;
+    std::vector<couchbase::core::impl::subdoc::command> specs{};
+    std::optional<std::chrono::milliseconds> timeout{};
+    std::shared_ptr<couchbase::tracing::request_span> parent_span{ nullptr };
+    std::uint16_t partition{};
+    std::uint32_t opaque{};
+    io::retry_context<false> retries{};
+
+    [[nodiscard]] std::error_code encode_to(encoded_request_type& encoded, mcbp_context&& context);
+
+    [[nodiscard]] lookup_in_replica_response make_response(key_value_error_context&& ctx, const encoded_response_type& encoded) const;
+};
+} // namespace couchbase::core::impl

data/ext/couchbase/core/impl/manager_error_context.cxx

@@ -0,0 +1,100 @@
+/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *   Copyright 2023-Present Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#include "internal_manager_error_context.hxx"
+
+#include <couchbase/manager_error_context.hxx>
+
+namespace couchbase
+{
+manager_error_context::manager_error_context()
+  : internal_{ nullptr }
+{
+}
+
+manager_error_context::manager_error_context(internal_manager_error_context ctx)
+  : internal_{ std::make_unique<internal_manager_error_context>(std::move(ctx)) }
+{
+}
+
+manager_error_context::manager_error_context(manager_error_context&& other) = default;
+
+manager_error_context&
+manager_error_context::operator=(manager_error_context&& other) = default;
+
+manager_error_context::~manager_error_context() = default;
+
+auto
+manager_error_context::ec() const -> std::error_code
+{
+    return internal_->ec();
+}
+
+auto
+manager_error_context::last_dispatched_from() const -> const std::optional<std::string>&
+{
+    return internal_->last_dispatched_from();
+}
+
+auto
+manager_error_context::last_dispatched_to() const -> const std::optional<std::string>&
+{
+    return internal_->last_dispatched_to();
+}
+
+auto
+manager_error_context::retry_attempts() const -> std::size_t
+{
+    return internal_->retry_attempts();
+}
+
+auto
+manager_error_context::retry_reasons() const -> const std::set<retry_reason>&
+{
+    return internal_->retry_reasons();
+}
+
+auto
+manager_error_context::retried_because_of(couchbase::retry_reason reason) const -> bool
+{
+    return internal_->retried_because_of(reason);
+}
+
+auto
+manager_error_context::path() const -> const std::string&
+{
+    return internal_->path();
+}
+
+auto
+manager_error_context::content() const -> const std::string&
+{
+    return internal_->content();
+}
+
+auto
+manager_error_context::client_context_id() const -> const std::string&
+{
+    return internal_->client_context_id();
+}
+
+auto
+manager_error_context::http_status() const -> std::uint32_t
+{
+    return internal_->http_status();
+}
+} // namespace couchbase

data/ext/couchbase/core/impl/query.cxx

@@ -161,6 +161,7 @@ build_query_request(std::string statement, query_options::built options)
         options.readonly,
         options.flex_index,
         options.preserve_expiry,
+        options.use_replica,
         options.max_parallelism,
         options.scan_cap,
         options.scan_wait,

data/ext/couchbase/core/impl/query_error_context.cxx

@@ -0,0 +1,75 @@
+/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
+/*
+ *   Copyright 2020-Present Couchbase, Inc.
+ *
+ *   Licensed under the Apache License, Version 2.0 (the "License");
+ *   you may not use this file except in compliance with the License.
+ *   You may obtain a copy of the License at
+ *
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ *
+ *   Unless required by applicable law or agreed to in writing, software
+ *   distributed under the License is distributed on an "AS IS" BASIS,
+ *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ *   See the License for the specific language governing permissions and
+ *   limitations under the License.
+ */
+
+#include <couchbase/query_error_context.hxx>
+
+#include <couchbase/fmt/retry_reason.hxx>
+
+#include <tao/json/to_string.hpp>
+
+namespace couchbase
+{
+auto
+query_error_context::to_json() const -> std::string
+{
+    tao::json::value json = {
+        {
+          "ec",
+          tao::json::value{
+            { "value", ec().value() },
+            { "message", ec().message() },
+          },
+        },
+        { "operation_id", operation_id() },
+        { "retry_attempts", retry_attempts() },
+        { "client_context_id", client_context_id_ },
+        { "statement", statement_ },
+        { "method", statement_ },
+        { "path", statement_ },
+        { "http_status", http_status_ },
+        { "http_body", http_body_ },
+        { "hostname", hostname_ },
+        { "port", port_ },
+    };
+
+    if (const auto& val = parameters_; val.has_value()) {
+        json["parameters"] = val.value();
+    }
+    if (first_error_code_ > 0) {
+        json["first_error_code"] = first_error_code_;
+    }
+    if (!first_error_message_.empty()) {
+        json["first_error_message"] = first_error_message_;
+    }
+
+    if (const auto& reasons = retry_reasons(); !reasons.empty()) {
+        tao::json::value reasons_json = tao::json::empty_array;
+        for (const auto& reason : reasons) {
+            reasons_json.emplace_back(fmt::format("{}", reason));
+        }
+        json["retry_reasons"] = reasons_json;
+    }
+    if (const auto& val = last_dispatched_from(); val.has_value()) {
+        json["last_dispatched_from"] = val.value();
+    }
+    if (const auto& val = last_dispatched_to(); val.has_value()) {
+        json["last_dispatched_to"] = val.value();
+    }
+
+    return tao::json::to_string(json, 2);
+}
+} // namespace couchbase