couchbase 3.5.0 → 3.5.2

data/ext/couchbase/couchbase/analytics_result.hxx

@@ -36,67 +36,68 @@ namespace couchbase
  */
 class analytics_result
 {
-  public:
-    /**
-     * @since 1.0.0
-     * @internal
-     */
-    analytics_result() = default;
+public:
+  /**
+   * @since 1.0.0
+   * @internal
+   */
+  analytics_result() = default;
 
-    /**
-     * @since 1.0.0
-     * @volatile
-     */
-    analytics_result(analytics_meta_data meta_data, std::vector<codec::binary> rows)
-      : meta_data_{ std::move(meta_data) }
-      , rows_{ std::move(rows) }
-    {
-    }
+  /**
+   * @since 1.0.0
+   * @volatile
+   */
+  analytics_result(analytics_meta_data meta_data, std::vector<codec::binary> rows)
+    : meta_data_{ std::move(meta_data) }
+    , rows_{ std::move(rows) }
+  {
+  }
 
-    /**
-     * Returns the {@link analytics_meta_data} giving access to the additional metadata associated with this analytics query.
-     *
-     * @return response metadata
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    [[nodiscard]] auto meta_data() const -> const analytics_meta_data&
-    {
-        return meta_data_;
-    }
+  /**
+   * Returns the {@link analytics_meta_data} giving access to the additional metadata associated
+   * with this analytics query.
+   *
+   * @return response metadata
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  [[nodiscard]] auto meta_data() const -> const analytics_meta_data&
+  {
+    return meta_data_;
+  }
 
-    /**
-     * @return list of analytics results as binary strings
-     *
-     * @since 1.0.0
-     * @internal
-     */
-    [[nodiscard]] auto rows_as_binary() const -> const std::vector<codec::binary>&
-    {
-        return rows_;
-    }
+  /**
+   * @return list of analytics results as binary strings
+   *
+   * @since 1.0.0
+   * @internal
+   */
+  [[nodiscard]] auto rows_as_binary() const -> const std::vector<codec::binary>&
+  {
+    return rows_;
+  }
 
-    template<typename 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>
-    {
-        std::vector<Document> rows;
-        rows.reserve(rows_.size());
-        for (const auto& row : rows_) {
-            rows.emplace_back(Serializer::template deserialize<Document>(row));
-        }
-        return rows;
+  template<typename 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>
+  {
+    std::vector<Document> rows;
+    rows.reserve(rows_.size());
+    for (const auto& row : rows_) {
+      rows.emplace_back(Serializer::template deserialize<Document>(row));
     }
+    return rows;
+  }
 
-    [[nodiscard]] auto rows_as_json() const -> std::vector<codec::tao_json_serializer::document_type>
-    {
-        return rows_as<codec::tao_json_serializer>();
-    }
+  [[nodiscard]] auto rows_as_json() const -> std::vector<codec::tao_json_serializer::document_type>
+  {
+    return rows_as<codec::tao_json_serializer>();
+  }
 
-  private:
-    analytics_meta_data meta_data_{};
-    std::vector<codec::binary> rows_{};
+private:
+  analytics_meta_data meta_data_{};
+  std::vector<codec::binary> rows_{};
 };
 } // namespace couchbase

data/ext/couchbase/couchbase/analytics_scan_consistency.hxx

@@ -20,27 +20,30 @@
 namespace couchbase
 {
 enum class analytics_scan_consistency {
-    /**
-     * The indexer will return whatever state it has to the query engine at the time of query.
-     *
-     * This is the default (for single-statement requests). No timestamp vector is used in the index scan. This is also the fastest mode,
-     * because we avoid the cost of obtaining the vector, and we also avoid any wait for the index to catch up to the vector.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    not_bounded = 0,
+  /**
+   * The indexer will return whatever state it has to the query engine at the time of query.
+   *
+   * This is the default (for single-statement requests). No timestamp vector is used in the index
+   * scan. This is also the fastest mode, because we avoid the cost of obtaining the vector, and we
+   * also avoid any wait for the index to catch up to the vector.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  not_bounded = 0,
 
-    /**
-     * The indexer will wait until all mutations have been processed at the time of request before returning to the query engine.
-     *
-     * This implements strong consistency per request. Before processing the request, a current vector is obtained. The vector is used as a
-     * lower bound for the statements in the request. If there are DML statements in the request, RYOW ("read your own write") is also
-     * applied within the request.
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    request_plus,
+  /**
+   * The indexer will wait until all mutations have been processed at the time of request before
+   * returning to the query engine.
+   *
+   * This implements strong consistency per request. Before processing the request, a current vector
+   * is obtained. The vector is used as a lower bound for the statements in the request. If there
+   * are DML statements in the request, RYOW
+   * ("read your own write") is also applied within the request.
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  request_plus,
 };
 } // namespace couchbase

data/ext/couchbase/couchbase/analytics_status.hxx

@@ -26,16 +26,16 @@ namespace couchbase
  * @committed
  */
 enum class analytics_status {
-    running,
-    success,
-    errors,
-    completed,
-    stopped,
-    timeout,
-    closed,
-    fatal,
-    aborted,
-    unknown,
+  running,
+  success,
+  errors,
+  completed,
+  stopped,
+  timeout,
+  closed,
+  fatal,
+  aborted,
+  unknown,
 };
 
 } // namespace couchbase

data/ext/couchbase/couchbase/analytics_warning.hxx

@@ -27,59 +27,60 @@ namespace couchbase
 /**
  * Represents a single warning returned from the analytics engine.
  *
- * @note warnings are not terminal errors but hints from the engine that something was not as expected.
+ * @note warnings are not terminal errors but hints from the engine that something was not as
+ * expected.
  *
  * @since 1.0.0
  * @committed
  */
 class analytics_warning
 {
-  public:
-    /**
-     * @since 1.0.0
-     * @internal
-     */
-    analytics_warning() = default;
+public:
+  /**
+   * @since 1.0.0
+   * @internal
+   */
+  analytics_warning() = default;
 
-    /**
-     * @since 1.0.0
-     * @volatile
-     */
-    analytics_warning(std::uint64_t code, std::string message)
-      : code_{ code }
-      , message_{ std::move(message) }
-    {
-    }
+  /**
+   * @since 1.0.0
+   * @volatile
+   */
+  analytics_warning(std::uint64_t code, std::string message)
+    : code_{ code }
+    , message_{ std::move(message) }
+  {
+  }
 
-    /**
-     * Error code.
-     *
-     * @return error code
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    [[nodiscard]] auto code() const -> std::uint64_t
-    {
-        return code_;
-    }
+  /**
+   * Error code.
+   *
+   * @return error code
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  [[nodiscard]] auto code() const -> std::uint64_t
+  {
+    return code_;
+  }
 
-    /**
-     * Error message.
-     *
-     * @return human readable explanation
-     *
-     * @since 1.0.0
-     * @committed
-     */
-    [[nodiscard]] auto message() const -> const std::string&
-    {
-        return message_;
-    }
+  /**
+   * Error message.
+   *
+   * @return human readable explanation
+   *
+   * @since 1.0.0
+   * @committed
+   */
+  [[nodiscard]] auto message() const -> const std::string&
+  {
+    return message_;
+  }
 
-  private:
-    std::uint64_t code_{};
-    std::string message_{};
+private:
+  std::uint64_t code_{};
+  std::string message_{};
 };
 
 } // namespace couchbase

data/ext/couchbase/couchbase/analyze_document_options.hxx

@@ -28,17 +28,17 @@
 namespace couchbase
 {
 struct analyze_document_options : public common_options<analyze_document_options> {
-  public:
-    struct built : public common_options<analyze_document_options>::built {
-    };
+public:
+  struct built : public common_options<analyze_document_options>::built {
+  };
 
-    [[nodiscard]] auto build() const -> built
-    {
-        return { build_common_options() };
-    }
+  [[nodiscard]] auto build() const -> built
+  {
+    return { build_common_options() };
+  }
 
-  private:
+private:
 };
 
-using analyze_document_handler = std::function<void(couchbase::manager_error_context, std::vector<std::string>)>;
+using analyze_document_handler = std::function<void(error, std::vector<std::string>)>;
 } // namespace couchbase

data/ext/couchbase/couchbase/append_options.hxx

@@ -19,8 +19,8 @@
 
 #include <couchbase/codec/encoded_value.hxx>
 #include <couchbase/common_durability_options.hxx>
+#include <couchbase/error.hxx>
 #include <couchbase/expiry.hxx>
-#include <couchbase/key_value_error_context.hxx>
 #include <couchbase/mutation_result.hxx>
 
 #include <chrono>
@@ -39,54 +39,58 @@ namespace couchbase
  * @committed
  */
 struct append_options : public common_durability_options<append_options> {
-    /**
-     * Immutable value object representing consistent options.
-     *
-     * @since 1.0.0
-     * @internal
-     */
-    struct built : public common_durability_options<append_options>::built {
-        const couchbase::cas cas;
-    };
+  /**
+   * Immutable value object representing consistent options.
+   *
+   * @since 1.0.0
+   * @internal
+   */
+  struct built : public common_durability_options<append_options>::built {
+    const couchbase::cas cas;
+  };
 
-    /**
-     * Validates options and returns them as an immutable value.
-     *
-     * @return consistent options as an immutable value
-     *
-     * @exception std::system_error with code errc::common::invalid_argument if the options are not valid
-     *
-     * @since 1.0.0
-     * @internal
-     */
-    [[nodiscard]] auto build() const -> built
-    {
-        auto base = build_common_durability_options();
-        return { base, cas_ };
-    }
+  /**
+   * Validates options and returns them as an immutable value.
+   *
+   * @return consistent options as an immutable value
+   *
+   * @exception std::system_error with code errc::common::invalid_argument if the options are not
+   * valid
+   *
+   * @since 1.0.0
+   * @internal
+   */
+  [[nodiscard]] auto build() const -> built
+  {
+    auto base = build_common_durability_options();
+    return { base, cas_ };
+  }
 
-    /**
-     * Specifies a CAS value that will be taken into account on the server side for optimistic concurrency.
-     *
-     * The CAS value is an opaque identifier which is associated with a specific state of the document on the server. The
-     * CAS value is received on read operations (or after mutations) and can be used during a subsequent mutation to
-     * make sure that the document has not been modified in the meantime.
-     *
-     * If document on the server has been modified in the meantime the SDK will raise a {@link errc::common::cas_mismatch}. In
-     * this case the caller is expected to re-do the whole "fetch-modify-update" cycle again. Please refer to the
-     * SDK documentation for more information on CAS mismatches and subsequent retries.
-     *
-     * @param cas the opaque CAS identifier to use for this operation.
-     * @return the {@link append_options} for chaining purposes.
-     */
-    auto cas(couchbase::cas cas) -> append_options&
-    {
-        cas_ = cas;
-        return self();
-    }
+  /**
+   * Specifies a CAS value that will be taken into account on the server side for optimistic
+   * concurrency.
+   *
+   * The CAS value is an opaque identifier which is associated with a specific state of the document
+   * on the server. The CAS value is received on read operations (or after mutations) and can be
+   * used during a subsequent mutation to make sure that the document has not been modified in the
+   * meantime.
+   *
+   * If document on the server has been modified in the meantime the SDK will raise a {@link
+   * errc::common::cas_mismatch}. In this case the caller is expected to re-do the whole
+   * "fetch-modify-update" cycle again. Please refer to the SDK documentation for more information
+   * on CAS mismatches and subsequent retries.
+   *
+   * @param cas the opaque CAS identifier to use for this operation.
+   * @return the {@link append_options} for chaining purposes.
+   */
+  auto cas(couchbase::cas cas) -> append_options&
+  {
+    cas_ = cas;
+    return self();
+  }
 
-  private:
-    couchbase::cas cas_{};
+private:
+  couchbase::cas cas_{};
 };
 
 /**
@@ -95,5 +99,5 @@ struct append_options : public common_durability_options<append_options> {
  * @since 1.0.0
  * @uncommitted
  */
-using append_handler = std::function<void(couchbase::key_value_error_context, mutation_result)>;
+using append_handler = std::function<void(error, mutation_result)>;
 } // namespace couchbase

data/ext/couchbase/couchbase/behavior_options.hxx

@@ -23,83 +23,89 @@ namespace couchbase
 {
 class behavior_options
 {
-  public:
-    auto append_to_user_agent(std::string extra) -> behavior_options&
-    {
-        user_agent_extra_ = std::move(extra);
-        return *this;
-    }
+public:
+  auto append_to_user_agent(std::string extra) -> behavior_options&
+  {
+    user_agent_extra_ = std::move(extra);
+    return *this;
+  }
 
-    auto show_queries(bool enable) -> behavior_options&
-    {
-        show_queries_ = enable;
-        return *this;
-    }
+  auto show_queries(bool enable) -> behavior_options&
+  {
+    show_queries_ = enable;
+    return *this;
+  }
 
-    auto enable_clustermap_notification(bool enable) -> behavior_options&
-    {
-        enable_clustermap_notification_ = enable;
-        return *this;
-    }
+  auto enable_clustermap_notification(bool enable) -> behavior_options&
+  {
+    enable_clustermap_notification_ = enable;
+    return *this;
+  }
 
-    auto enable_mutation_tokens(bool enable) -> behavior_options&
-    {
-        enable_mutation_tokens_ = enable;
-        return *this;
-    }
+  auto enable_mutation_tokens(bool enable) -> behavior_options&
+  {
+    enable_mutation_tokens_ = enable;
+    return *this;
+  }
 
-    auto enable_unordered_execution(bool enable) -> behavior_options&
-    {
-        enable_unordered_execution_ = enable;
-        return *this;
-    }
+  auto enable_unordered_execution(bool enable) -> behavior_options&
+  {
+    enable_unordered_execution_ = enable;
+    return *this;
+  }
 
-    auto dump_configuration(bool enable) -> behavior_options&
-    {
-        dump_configuration_ = enable;
-        return *this;
-    }
+  auto dump_configuration(bool enable) -> behavior_options&
+  {
+    dump_configuration_ = enable;
+    return *this;
+  }
 
-    /**
-     * 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 network(std::string name) -> behavior_options&
-    {
-        network_ = std::move(name);
-        return *this;
-    }
+  /**
+   * 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 network(std::string name) -> behavior_options&
+  {
+    network_ = std::move(name);
+    return *this;
+  }
 
-    struct built {
-        std::string user_agent_extra;
-        bool show_queries;
-        bool enable_clustermap_notification;
-        bool enable_mutation_tokens;
-        bool enable_unordered_execution;
-        bool dump_configuration;
-        std::string network;
-    };
+  struct built {
+    std::string user_agent_extra;
+    bool show_queries;
+    bool enable_clustermap_notification;
+    bool enable_mutation_tokens;
+    bool enable_unordered_execution;
+    bool dump_configuration;
+    std::string network;
+  };
 
-    [[nodiscard]] auto build() const -> built
-    {
-        return {
-            user_agent_extra_,   show_queries_, enable_clustermap_notification_, enable_mutation_tokens_, enable_unordered_execution_,
-            dump_configuration_, network_,
-        };
-    }
+  [[nodiscard]] auto build() const -> built
+  {
+    return {
+      user_agent_extra_,
+      show_queries_,
+      enable_clustermap_notification_,
+      enable_mutation_tokens_,
+      enable_unordered_execution_,
+      dump_configuration_,
+      network_,
+    };
+  }
 
-  private:
-    std::string user_agent_extra_{};
-    bool show_queries_{ false };
-    bool enable_clustermap_notification_{ true };
-    bool enable_mutation_tokens_{ true };
-    bool enable_unordered_execution_{ true };
-    bool dump_configuration_{ false };
-    std::string network_{ "auto" };
+private:
+  std::string user_agent_extra_{};
+  bool show_queries_{ false };
+  bool enable_clustermap_notification_{ true };
+  bool enable_mutation_tokens_{ true };
+  bool enable_unordered_execution_{ true };
+  bool dump_configuration_{ false };
+  std::string network_{ "auto" };
 };
 } // namespace couchbase

data/ext/couchbase/couchbase/best_effort_retry_strategy.hxx

@@ -42,23 +42,25 @@ controlled_backoff(std::size_t retry_attempts) -> std::chrono::milliseconds;
  * @return backoff calculator
  */
 auto
-exponential_backoff(std::chrono::milliseconds min_backoff, std::chrono::milliseconds max_backoff, double backoff_factor)
-  -> backoff_calculator;
+exponential_backoff(std::chrono::milliseconds min_backoff,
+                    std::chrono::milliseconds max_backoff,
+                    double backoff_factor) -> backoff_calculator;
 
 class best_effort_retry_strategy : public retry_strategy
 {
-  public:
-    explicit best_effort_retry_strategy(backoff_calculator calculator);
-    ~best_effort_retry_strategy() override = default;
+public:
+  explicit best_effort_retry_strategy(backoff_calculator calculator);
+  ~best_effort_retry_strategy() override = default;
 
-    auto retry_after(const retry_request& request, retry_reason reason) -> retry_action override;
+  auto retry_after(const retry_request& request, retry_reason reason) -> retry_action override;
 
-    [[nodiscard]] auto to_string() const -> std::string override;
+  [[nodiscard]] auto to_string() const -> std::string override;
 
-  private:
-    backoff_calculator backoff_calculator_;
+private:
+  backoff_calculator backoff_calculator_;
 };
 
 [[nodiscard]] auto
-make_best_effort_retry_strategy(backoff_calculator calculator = controlled_backoff) -> std::shared_ptr<best_effort_retry_strategy>;
+make_best_effort_retry_strategy(backoff_calculator calculator = controlled_backoff)
+  -> std::shared_ptr<best_effort_retry_strategy>;
 } // namespace couchbase