couchbase 4.4.1 → 4.4.3

package/deps/couchbase-cxx-client/couchbase/date_range_query.hxx

@@ -34,10 +34,10 @@ namespace couchbase
  *
  * Match documents where field `review_date` falls within the range ("2001-10-09T10:20:30-08:00",
  * "2016-10-31")
- * @snippet test_unit_search.cxx search-date-range
+ * @snippet{trimleft} test_unit_search.cxx search-date-range
  *
  * It also works with `std::tm` and `std::chrono::system_clock::time_point`.
- * @snippet test_unit_search.cxx search-date-range-tm
+ * @snippet{trimleft} test_unit_search.cxx search-date-range-tm
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-date-range.html server
  * documentation.

package/deps/couchbase-cxx-client/couchbase/disjunction_query.hxx

@@ -35,7 +35,7 @@ namespace couchbase
  * * `"location"` in the field `reviews.content`
  * * `true` in the field `free_breakfast`.
  *
- * @snippet test_unit_search.cxx search-disjunction
+ * @snippet{trimleft} test_unit_search.cxx search-disjunction
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-conjuncts-disjuncts.html
  * server documentation

package/deps/couchbase-cxx-client/couchbase/geo_bounding_box_query.hxx

@@ -35,7 +35,7 @@ namespace couchbase
  * identical to the initial, thus explicitly closing the box. However, specifying an explicit
  * closure in this way is optional: the closure will be inferred by the Couchbase Server if not
  * explicitly specified.
- * @snippet test_unit_search.cxx search-geo-bounding-box
+ * @snippet{trimleft} test_unit_search.cxx search-geo-bounding-box
  *
  * @see
  * https://docs.couchbase.com/server/current/fts/fts-supported-queries-geo-bounded-rectangle.html

package/deps/couchbase-cxx-client/couchbase/geo_distance_query.hxx

@@ -32,7 +32,7 @@ namespace couchbase
  * The following query specifies a longitude of `-2.235143` and a latitude of `53.482358`. The
  * target-field `geo` is specified, as is a distance of `100 miles`: this is the radius within which
  * target-locations must reside for their documents to be returned.
- * @snippet test_unit_search.cxx search-geo-distance
+ * @snippet{trimleft} test_unit_search.cxx search-geo-distance
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-geo-point-distance.html
  * server documentation

package/deps/couchbase-cxx-client/couchbase/geo_polygon_query.hxx

@@ -31,7 +31,7 @@ namespace couchbase
  *
  * If a target data-location falls within the box, its document is returned.
  *
- * @snippet test_unit_search.cxx search-geo-polygon
+ * @snippet{trimleft} test_unit_search.cxx search-geo-polygon
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-geo-bounded-polygon.html
  * server documentation

package/deps/couchbase-cxx-client/couchbase/get_replica_result.hxx

@@ -80,9 +80,9 @@ public:
    * @par Get flags and value as they are stored in the result
    *  Here is an example of custom transcoder, that just extracts value and flags as they are stored
    * in the result.
-   * @snippet test_integration_read_replica.cxx smuggling-transcoder
+   * @snippet{trimleft} test_integration_read_replica.cxx smuggling-transcoder
    *  Usage
-   * @snippet test_integration_read_replica.cxx smuggling-transcoder-usage
+   * @snippet{trimleft} test_integration_read_replica.cxx smuggling-transcoder-usage
    *
    * @since 1.0.0
    * @committed

package/deps/couchbase-cxx-client/couchbase/get_result.hxx

@@ -92,9 +92,9 @@ public:
    * @par Get flags and value as they are stored in the result
    *  Here is an example of custom transcoder, that just extracts value and flags as they are stored
    * in the result.
-   * @snippet test_integration_read_replica.cxx smuggling-transcoder
+   * @snippet{trimleft} test_integration_read_replica.cxx smuggling-transcoder
    *  Usage
-   * @snippet test_integration_read_replica.cxx smuggling-transcoder-usage
+   * @snippet{trimleft} test_integration_read_replica.cxx smuggling-transcoder-usage
    *
    * @since 1.0.0
    * @committed

package/deps/couchbase-cxx-client/couchbase/lookup_in_result.hxx

@@ -17,7 +17,9 @@
 
 #pragma once
 
-#include <couchbase/codec/tao_json_serializer.hxx>
+#include <couchbase/codec/encoded_value.hxx>
+#include <couchbase/codec/serializer_traits.hxx>
+#include <couchbase/error_codes.hxx>
 #include <couchbase/result.hxx>
 #include <couchbase/subdoc/lookup_in_macro.hxx>
 
@@ -26,6 +28,11 @@
 namespace couchbase
 {
 
+namespace codec
+{
+class tao_json_serializer;
+} // namespace codec
+
 /**
  * Represents result of lookup_in operations.
  *
@@ -80,7 +87,9 @@ public:
    * @since 1.0.0
    * @committed
    */
-  template<typename Document>
+  template<typename Document,
+           typename Serializer = codec::tao_json_serializer,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   [[nodiscard]] auto content_as(std::size_t index) const -> Document
   {
     for (const entry& e : entries_) {
@@ -91,7 +100,7 @@ public:
                                     std::to_string(index) + ", path \"" + e.path + "\"");
         }
 
-        return codec::tao_json_serializer::deserialize<Document>(e.value);
+        return Serializer::template deserialize<Document>(e.value);
       }
     }
     throw std::system_error(errc::key_value::path_invalid,
@@ -108,7 +117,9 @@ public:
    * @since 1.0.0
    * @committed
    */
-  template<typename Document>
+  template<typename Document,
+           typename Serializer = codec::tao_json_serializer,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   [[nodiscard]] auto content_as(const std::string& path) const -> Document
   {
     for (const entry& e : entries_) {
@@ -117,7 +128,7 @@ public:
           throw std::system_error(e.ec, "error getting result for path \"" + e.path + "\"");
         }
 
-        return codec::tao_json_serializer::deserialize<Document>(e.value);
+        return Serializer::template deserialize<Document>(e.value);
       }
     }
     throw std::system_error(errc::key_value::path_invalid,
@@ -134,7 +145,9 @@ public:
    * @since 1.0.0
    * @committed
    */
-  template<typename Document>
+  template<typename Document,
+           typename Serializer = codec::tao_json_serializer,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   [[nodiscard]] auto content_as(subdoc::lookup_in_macro macro) const -> Document
   {
     const auto& macro_string = subdoc::to_string(macro);
@@ -144,7 +157,7 @@ public:
           throw std::system_error(e.ec, "error getting result for macro \"" + macro_string + "\"");
         }
 
-        return codec::tao_json_serializer::deserialize<Document>(e.value);
+        return Serializer::template deserialize<Document>(e.value);
       }
     }
     throw std::system_error(errc::key_value::path_invalid,

package/deps/couchbase-cxx-client/couchbase/match_phrase_query.hxx

@@ -39,7 +39,7 @@ namespace couchbase
  * Following this processing, the tokens `"locat"` and
  * `"function"` are recognized as common to both input and target; and also as being both in the
  * same sequence as, and at the same distance from one another; and therefore a match is made.
- * @snippet test_unit_search.cxx search-match-phrase
+ * @snippet{trimleft} test_unit_search.cxx search-match-phrase
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-match-phrase.html
  *

package/deps/couchbase-cxx-client/couchbase/match_query.hxx

@@ -33,7 +33,7 @@ namespace couchbase
  *
  * Match documents with both `"location"` and `"hostel"` terms in the field `reviews.content`,
  * ensuring common prefix length `4`, maximum fuzziness and select standard analyzer.
- * @snippet test_unit_search.cxx search-match
+ * @snippet{trimleft} test_unit_search.cxx search-match
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-match.html server
  * documentation

package/deps/couchbase-cxx-client/couchbase/mutate_in_result.hxx

@@ -17,13 +17,20 @@
 
 #pragma once
 
-#include <couchbase/codec/tao_json_serializer.hxx>
+#include <couchbase/codec/encoded_value.hxx>
+#include <couchbase/codec/serializer_traits.hxx>
+#include <couchbase/error_codes.hxx>
 #include <couchbase/mutation_result.hxx>
 
-#include <optional>
+#include <string>
+#include <vector>
 
 namespace couchbase
 {
+namespace codec
+{
+class tao_json_serializer;
+} // namespace codec
 
 /**
  * Represents result of mutate_in operations.
@@ -81,12 +88,14 @@ public:
    * @since 1.0.0
    * @committed
    */
-  template<typename Document>
+  template<typename Document,
+           typename Serializer = codec::tao_json_serializer,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   [[nodiscard]] auto content_as(std::size_t index) const -> Document
   {
     for (const entry& e : entries_) {
       if (e.original_index == index) {
-        return codec::tao_json_serializer::deserialize<Document>(e.value);
+        return Serializer::template deserialize<Document>(e.value);
       }
     }
     throw std::system_error(errc::key_value::path_invalid,
@@ -103,12 +112,14 @@ public:
    * @since 1.0.0
    * @committed
    */
-  template<typename Document>
+  template<typename Document,
+           typename Serializer = codec::tao_json_serializer,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   [[nodiscard]] auto content_as(const std::string& path) const -> Document
   {
     for (const entry& e : entries_) {
       if (e.path == path) {
-        return codec::tao_json_serializer::deserialize<Document>(e.value);
+        return Serializer::template deserialize<Document>(e.value);
       }
     }
     throw std::system_error(errc::key_value::path_invalid,

package/deps/couchbase-cxx-client/couchbase/mutate_in_specs.hxx

@@ -32,6 +32,7 @@
 #include <couchbase/subdoc/replace.hxx>
 #include <couchbase/subdoc/upsert.hxx>
 
+#include <memory>
 #include <vector>
 
 namespace couchbase
@@ -40,31 +41,34 @@ namespace couchbase
 namespace
 {
 template<typename Value>
-std::vector<std::vector<std::byte>>
-encode_array(const Value& value)
+auto
+encode_array(const Value& value) -> std::vector<std::vector<std::byte>>
 {
   return { std::move(codec::default_json_transcoder::encode(value).data) };
 }
 
 template<typename Value>
-std::vector<std::vector<std::byte>>
-encode_array(std::vector<std::vector<std::byte>>&& output, const Value& value)
+auto
+encode_array(std::vector<std::vector<std::byte>>&& output,
+             const Value& value) -> std::vector<std::vector<std::byte>>
 {
   output.emplace_back(std::move(codec::default_json_transcoder::encode(value).data));
   return std::move(output);
 }
 
 template<typename Value, typename... Rest>
-std::vector<std::vector<std::byte>>
-encode_array(std::vector<std::vector<std::byte>>&& output, const Value& value, Rest... args)
+auto
+encode_array(std::vector<std::vector<std::byte>>&& output,
+             const Value& value,
+             Rest... args) -> std::vector<std::vector<std::byte>>
 {
   output.emplace_back(std::move(codec::default_json_transcoder::encode(value).data));
   return encode_array(std::move(output), args...);
 }
 
 template<typename Value, typename... Rest>
-std::vector<std::vector<std::byte>>
-encode_array(const Value& value, Rest... args)
+auto
+encode_array(const Value& value, Rest... args) -> std::vector<std::vector<std::byte>>
 {
   return encode_array(encode_array(value), args...);
 }
@@ -228,10 +232,10 @@ public:
    * @since 1.0.0
    * @committed
    */
-  template<typename Value>
+  template<typename Value, typename Transcoder = codec::default_json_transcoder>
   static auto upsert(std::string path, const Value& value) -> subdoc::upsert
   {
-    return { std::move(path), std::move(codec::default_json_transcoder::encode(value).data) };
+    return { std::move(path), std::move(Transcoder::template encode<const Value&>(value).data) };
   }
 
   /**
@@ -446,10 +450,10 @@ public:
    * @since 1.0.0
    * @committed
    */
-  template<typename Value>
+  template<typename Value, typename Transcoder = codec::default_json_transcoder>
   static auto array_add_unique(std::string path, const Value& value) -> subdoc::array_add_unique
   {
-    return { std::move(path), std::move(codec::default_json_transcoder::encode(value).data) };
+    return { std::move(path), std::move(Transcoder::template encode<Value>(value).data) };
   }
 
   /**

package/deps/couchbase-cxx-client/couchbase/network_options.hxx

@@ -35,9 +35,19 @@ public:
   static constexpr std::chrono::milliseconds default_config_poll_floor{ 50 };
   static constexpr std::chrono::milliseconds default_idle_http_connection_timeout{ 4'500 };
 
+  /**
+   * Selects network to use.
+   *
+   * @param name network name as it is exposed in the configuration.
+   * @return this object for chaining purposes.
+   *
+   * @see
+   * https://docs.couchbase.com/server/current/learn/clusters-and-availability/connectivity.html#alternate-addresses
+   * @see https://docs.couchbase.com/server/current/rest-api/rest-set-up-alternate-address.html
+   */
   auto preferred_network(std::string network_name) -> network_options&
   {
-    network_ = network_name;
+    network_ = std::move(network_name);
     return *this;
   }
 

package/deps/couchbase-cxx-client/couchbase/numeric_range_query.hxx

@@ -33,7 +33,8 @@ namespace couchbase
  * By default, min is inclusive and max is exclusive.
  *
  * Match documents where field `id` contains numbers in the range `(100, 1000)`:
- * @snippet test_unit_search.cxx search-numeric-range
+ *
+ * @snippet{trimleft} test_unit_search.cxx search-numeric-range
  *
  * @since 1.0.0
  * @committed

package/deps/couchbase-cxx-client/couchbase/phrase_query.hxx

@@ -34,7 +34,7 @@ namespace couchbase
  * @ref match_phrase_query should usually be preferred for real-world use cases.
  *
  * Match documents with terms `"nice"` and `"view"` in field `reviews.content`:
- * @snippet test_unit_search.cxx search-phrase
+ * @snippet{trimleft} test_unit_search.cxx search-phrase
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-phrase.html server
  * documentation

package/deps/couchbase-cxx-client/couchbase/prefix_query.hxx

@@ -30,7 +30,7 @@ namespace couchbase
  * @ref match_query.
  *
  * Match documents where field `reviews.content` contains words starting with `"inter"`:
- * @snippet test_unit_search.cxx search-prefix
+ * @snippet{trimleft} test_unit_search.cxx search-prefix
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-prefix-query.html server
  * documentation

package/deps/couchbase-cxx-client/couchbase/query_options.hxx

@@ -17,7 +17,6 @@
 
 #pragma once
 
-#include <couchbase/codec/tao_json_serializer.hxx>
 #include <couchbase/common_options.hxx>
 #include <couchbase/error.hxx>
 #include <couchbase/mutation_state.hxx>
@@ -27,11 +26,17 @@
 
 #include <chrono>
 #include <functional>
-#include <memory>
+#include <map>
 #include <optional>
+#include <vector>
 
 namespace couchbase
 {
+namespace codec
+{
+class tao_json_serializer;
+} // namespace codec
+
 /**
  * Options for cluster#query() and scope#query().
  *
@@ -435,10 +440,12 @@ struct query_options : public common_options<query_options> {
    * @since 1.0.0
    * @committed
    */
-  template<typename Value>
+  template<typename Serializer = codec::tao_json_serializer,
+           typename Value,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   auto raw(std::string name, const Value& value) -> query_options&
   {
-    raw_[std::move(name)] = std::move(codec::tao_json_serializer::serialize(value));
+    raw_[std::move(name)] = std::move(Serializer::template serialize<const Value&>(value));
     return self();
   }
 
@@ -452,12 +459,14 @@ struct query_options : public common_options<query_options> {
    * @since 1.0.0
    * @committed
    */
-  template<typename... Parameters>
+  template<typename Serializer = codec::tao_json_serializer,
+           typename... Parameters,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   auto positional_parameters(const Parameters&... parameters) -> query_options&
   {
     named_parameters_.clear();
     positional_parameters_.clear();
-    encode_positional_parameters(parameters...);
+    encode_positional_parameters<Serializer>(parameters...);
     return self();
   }
 
@@ -471,12 +480,14 @@ struct query_options : public common_options<query_options> {
    * @since 1.0.0
    * @committed
    */
-  template<typename... Parameters>
+  template<typename Serializer = codec::tao_json_serializer,
+           typename... Parameters,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   auto named_parameters(const Parameters&... parameters) -> query_options&
   {
     named_parameters_.clear();
     positional_parameters_.clear();
-    encode_named_parameters(parameters...);
+    encode_named_parameters<Serializer>(parameters...);
     return self();
   }
 
@@ -546,23 +557,30 @@ struct query_options : public common_options<query_options> {
   }
 
 private:
-  template<typename Parameter, typename... Rest>
+  template<typename Serializer = codec::tao_json_serializer,
+           typename Parameter,
+           typename... Rest,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   void encode_positional_parameters(const Parameter& parameter, Rest... args)
   {
     positional_parameters_.emplace_back(
-      std::move(codec::tao_json_serializer::serialize(parameter)));
+      std::move(Serializer::template serialize<const Parameter&>(parameter)));
     if constexpr (sizeof...(args) > 0) {
-      encode_positional_parameters(args...);
+      encode_positional_parameters<Serializer>(args...);
     }
   }
 
-  template<typename Name, typename Parameter, typename... Rest>
+  template<typename Serializer = codec::tao_json_serializer,
+           typename Name,
+           typename Parameter,
+           typename... Rest,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   void encode_named_parameters(const std::pair<Name, Parameter>& parameter, Rest... args)
   {
     named_parameters_[parameter.first] =
-      std::move(codec::tao_json_serializer::serialize(parameter.second));
+      std::move(Serializer::template serialize<Parameter>(parameter.second));
     if constexpr (sizeof...(args) > 0) {
-      encode_named_parameters(args...);
+      encode_named_parameters<Serializer>(args...);
     }
   }
 

package/deps/couchbase-cxx-client/couchbase/query_result.hxx

@@ -17,14 +17,21 @@
 
 #pragma once
 
-#include <couchbase/codec/tao_json_serializer.hxx>
 #include <couchbase/query_meta_data.hxx>
 
+#include <couchbase/codec/encoded_value.hxx>
+#include <couchbase/codec/serializer_traits.hxx>
+
 #include <vector>
 
 namespace couchbase
 {
 
+namespace codec
+{
+class tao_json_serializer;
+}
+
 /**
  * Represents result of @ref cluster#query() and @ref scope#query() calls.
  *
@@ -75,7 +82,7 @@ public:
     return rows_;
   }
 
-  template<typename Serializer,
+  template<typename Serializer = codec::tao_json_serializer,
            typename Document = typename Serializer::document_type,
            std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   [[nodiscard]] auto rows_as() const -> std::vector<Document>
@@ -88,11 +95,6 @@ public:
     return rows;
   }
 
-  [[nodiscard]] auto rows_as_json() const -> std::vector<codec::tao_json_serializer::document_type>
-  {
-    return rows_as<codec::tao_json_serializer>();
-  }
-
 private:
   query_meta_data meta_data_{};
   std::vector<codec::binary> rows_{};

package/deps/couchbase-cxx-client/couchbase/query_string_query.hxx

@@ -31,15 +31,15 @@ namespace couchbase
  * parameter with the number to boost the search. For example perform
  * @ref match_query for pool in both the name and description fields, but documents having the term
  * in the name field score higher.
- * @snippet test_unit_search.cxx search-query-string-boosting
+ * @snippet{trimleft} test_unit_search.cxx search-query-string-boosting
  *
  * 2. You can perform date or numeric range searches by using the `>`, `>=`, `<`, and `<=`
  * operators, followed by a date value in quotes. For example, perform a @ref date_range_query on
  * the created field for values after September 21, 2016.
- * @snippet test_unit_search.cxx search-query-string-date-range
+ * @snippet{trimleft} test_unit_search.cxx search-query-string-date-range
  * Or, perform a @ref numeric_range_query  on the `reviews.ratings.Cleanliness` field, for values
  * greater than 4.
- * @snippet test_unit_search.cxx search-query-string-numeric-range
+ * @snippet{trimleft} test_unit_search.cxx search-query-string-numeric-range
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-query-string-syntax.html definition of
  * query syntax

package/deps/couchbase-cxx-client/couchbase/regexp_query.hxx

@@ -28,7 +28,7 @@ namespace couchbase
  * Finds documents containing terms that match the specified regular expression.
  *
  * Match documents where field `reviews.content` contains words starting with `"inter"`:
- * @snippet test_unit_search.cxx search-regexp
+ * @snippet{trimleft} test_unit_search.cxx search-regexp
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-regexp.html server
  * documentation

package/deps/couchbase-cxx-client/couchbase/search_numeric_range.hxx

@@ -19,6 +19,7 @@
 
 #include <cinttypes>
 #include <string>
+#include <variant>
 
 namespace couchbase
 {

package/deps/couchbase-cxx-client/couchbase/search_options.hxx

@@ -17,7 +17,6 @@
 
 #pragma once
 
-#include <couchbase/codec/tao_json_serializer.hxx>
 #include <couchbase/common_options.hxx>
 #include <couchbase/error.hxx>
 #include <couchbase/highlight_style.hxx>
@@ -34,6 +33,11 @@
 
 namespace couchbase
 {
+namespace codec
+{
+class tao_json_serializer;
+}
+
 /**
  * Options for @ref cluster#search() and @ref scope#search().
  *
@@ -183,10 +187,12 @@ struct search_options : public common_options<search_options> {
    * @since 1.0.0
    * @committed
    */
-  template<typename Value>
+  template<typename Value,
+           typename Serializer = codec::tao_json_serializer,
+           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
   auto raw(std::string name, const Value& value) -> search_options&
   {
-    raw_[std::move(name)] = std::move(codec::tao_json_serializer::serialize(value));
+    raw_[std::move(name)] = std::move(Serializer::template serialize<Value>(value));
     return self();
   }
 

package/deps/couchbase-cxx-client/couchbase/term_range_query.hxx

@@ -30,7 +30,7 @@ namespace couchbase
  * specified range. Either min or max can be omitted, but not both.
  *
  * Match documents where field `desc` contains terms in the range `("foo", "foof")`:
- * @snippet test_unit_search.cxx search-term-range
+ * @snippet{trimleft} test_unit_search.cxx search-term-range
  *
  * @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-term-range.html server
  * documentation.

package/deps/couchbase-cxx-client/couchbase/transactions/async_attempt_context.hxx

@@ -36,7 +36,7 @@ using async_err_handler = std::function<void(error)>;
  * In the example below, we get 3 documents in parallel, and update each when
  * the get returns the document:
  *
- * @snippet test/test_transaction_examples.cxx simple-async-txn
+ * @snippet{trimleft} test/test_transaction_examples.cxx simple-async-txn
  */
 class async_attempt_context
 {
@@ -67,6 +67,12 @@ public:
    * @param id The unique id of the document.
    * @param handler The handler which implements @ref async_result_handler
    *
+   * Select preferred server group in connection options:
+   * @snippet{trimleft} test_integration_read_replica.cxx select-preferred_server_group
+   *
+   * Fetch document from the nodes that belong to selected server group only:
+   * @snippet{trimleft} test_transaction_examples.cxx get_replica_from_preferred_server_group-async
+   *
    * @see network_options::preferred_server_group
    * @see https://docs.couchbase.com/server/current/manage/manage-groups/manage-groups.html
    */