couchbase 4.2.8 → 4.2.10

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

@@ -25,17 +25,17 @@
 #include <future>
 #include <memory>
 
+namespace couchbase
+{
+class collection;
 #ifndef COUCHBASE_CXX_CLIENT_DOXYGEN
-namespace couchbase::core
+namespace core
 {
 class cluster;
-} // namespace couchbase::core
+} // namespace core
+class binary_collection_impl;
 #endif
 
-namespace couchbase
-{
-class collection;
-
 /**
  * Allows to perform certain operations on non-JSON documents.
  *
@@ -53,10 +53,7 @@ class binary_collection
      * @since 1.0.0
      * @committed
      */
-    [[nodiscard]] auto bucket_name() const noexcept -> const std::string&
-    {
-        return bucket_name_;
-    }
+    [[nodiscard]] auto bucket_name() const -> const std::string&;
 
     /**
      * Returns name of the scope where the collection is defined.
@@ -66,10 +63,7 @@ class binary_collection
      * @since 1.0.0
      * @committed
      */
-    [[nodiscard]] auto scope_name() const noexcept -> const std::string&
-    {
-        return scope_name_;
-    }
+    [[nodiscard]] auto scope_name() const -> const std::string&;
 
     /**
      * Returns name of the collection.
@@ -79,16 +73,11 @@ class binary_collection
      * @since 1.0.0
      * @committed
      */
-    [[nodiscard]] auto name() const noexcept -> const std::string&
-    {
-        return name_;
-    }
+    [[nodiscard]] auto name() const -> const std::string&;
 
     /**
      * Appends binary content to the document.
      *
-     * @tparam Handler type of the handler that implements @ref append_handler
-     *
      * @param document_id the document id which is used to uniquely identify it.
      * @param data the document content to append.
      * @param options custom options to customize the append behavior.
@@ -102,18 +91,7 @@ class binary_collection
      * @since 1.0.0
      * @committed
      */
-    template<typename Handler>
-    void append(std::string document_id, std::vector<std::byte> data, const append_options& options, Handler&& handler) const
-    {
-        return core::impl::initiate_append_operation(core_,
-                                                     bucket_name_,
-                                                     scope_name_,
-                                                     name_,
-                                                     std::move(document_id),
-                                                     std::move(data),
-                                                     options.build(),
-                                                     std::forward<Handler>(handler));
-    }
+    void append(std::string document_id, std::vector<std::byte> data, const append_options& options, append_handler&& handler) const;
 
     /**
      * Appends binary content to the document.
@@ -132,15 +110,7 @@ class binary_collection
      * @committed
      */
     [[nodiscard]] auto append(std::string document_id, std::vector<std::byte> data, const append_options& options) const
-      -> std::future<std::pair<key_value_error_context, mutation_result>>
-    {
-        auto barrier = std::make_shared<std::promise<std::pair<key_value_error_context, mutation_result>>>();
-        auto future = barrier->get_future();
-        append(std::move(document_id), std::move(data), options, [barrier](auto ctx, auto result) {
-            barrier->set_value({ std::move(ctx), std::move(result) });
-        });
-        return future;
-    }
+      -> std::future<std::pair<key_value_error_context, mutation_result>>;
 
     /**
      * Prepends binary content to the document.
@@ -160,18 +130,7 @@ class binary_collection
      * @since 1.0.0
      * @committed
      */
-    template<typename Handler>
-    void prepend(std::string document_id, std::vector<std::byte> data, const prepend_options& options, Handler&& handler) const
-    {
-        return core::impl::initiate_prepend_operation(core_,
-                                                      bucket_name_,
-                                                      scope_name_,
-                                                      name_,
-                                                      std::move(document_id),
-                                                      std::move(data),
-                                                      options.build(),
-                                                      std::forward<Handler>(handler));
-    }
+    void prepend(std::string document_id, std::vector<std::byte> data, const prepend_options& options, prepend_handler&& handler) const;
 
     /**
      * Prepends binary content to the document.
@@ -190,15 +149,7 @@ class binary_collection
      * @committed
      */
     [[nodiscard]] auto prepend(std::string document_id, std::vector<std::byte> data, const prepend_options& options) const
-      -> std::future<std::pair<key_value_error_context, mutation_result>>
-    {
-        auto barrier = std::make_shared<std::promise<std::pair<key_value_error_context, mutation_result>>>();
-        auto future = barrier->get_future();
-        prepend(std::move(document_id), std::move(data), options, [barrier](auto ctx, auto result) {
-            barrier->set_value({ std::move(ctx), std::move(result) });
-        });
-        return future;
-    }
+      -> std::future<std::pair<key_value_error_context, mutation_result>>;
 
     /**
      * Increments the counter document by one or the number defined in the options.
@@ -216,12 +167,7 @@ class binary_collection
      * @since 1.0.0
      * @committed
      */
-    template<typename Handler>
-    void increment(std::string document_id, const increment_options& options, Handler&& handler) const
-    {
-        return core::impl::initiate_increment_operation(
-          core_, bucket_name_, scope_name_, name_, std::move(document_id), options.build(), std::forward<Handler>(handler));
-    }
+    void increment(std::string document_id, const increment_options& options, increment_handler&& handler) const;
 
     /**
      * Increments the counter document by one or the number defined in the options.
@@ -238,15 +184,7 @@ class binary_collection
      * @committed
      */
     [[nodiscard]] auto increment(std::string document_id, const increment_options& options) const
-      -> std::future<std::pair<key_value_error_context, counter_result>>
-    {
-        auto barrier = std::make_shared<std::promise<std::pair<key_value_error_context, counter_result>>>();
-        auto future = barrier->get_future();
-        increment(std::move(document_id), options, [barrier](auto ctx, auto result) {
-            barrier->set_value({ std::move(ctx), std::move(result) });
-        });
-        return future;
-    }
+      -> std::future<std::pair<key_value_error_context, counter_result>>;
 
     /**
      * Decrements the counter document by one or the number defined in the options.
@@ -264,12 +202,7 @@ class binary_collection
      * @since 1.0.0
      * @committed
      */
-    template<typename Handler>
-    void decrement(std::string document_id, const decrement_options& options, Handler&& handler) const
-    {
-        return core::impl::initiate_decrement_operation(
-          core_, bucket_name_, scope_name_, name_, std::move(document_id), options.build(), std::forward<Handler>(handler));
-    }
+    void decrement(std::string document_id, const decrement_options& options, decrement_handler&& handler) const;
 
     /**
      * Decrements the counter document by one or the number defined in the options.
@@ -286,42 +219,13 @@ class binary_collection
      * @committed
      */
     [[nodiscard]] auto decrement(std::string document_id, const decrement_options& options) const
-      -> std::future<std::pair<key_value_error_context, counter_result>>
-    {
-        auto barrier = std::make_shared<std::promise<std::pair<key_value_error_context, counter_result>>>();
-        auto future = barrier->get_future();
-        decrement(std::move(document_id), options, [barrier](auto ctx, auto result) {
-            barrier->set_value({ std::move(ctx), std::move(result) });
-        });
-        return future;
-    }
+      -> std::future<std::pair<key_value_error_context, counter_result>>;
 
   private:
     friend class collection;
 
-    /**
-     * @param core
-     * @param bucket_name
-     * @param scope_name
-     * @param name
-     *
-     * @since 1.0.0
-     * @internal
-     */
-    binary_collection(std::shared_ptr<couchbase::core::cluster> core,
-                      std::string_view bucket_name,
-                      std::string_view scope_name,
-                      std::string_view name)
-      : core_(std::move(core))
-      , bucket_name_(bucket_name)
-      , scope_name_(scope_name)
-      , name_(name)
-    {
-    }
+    binary_collection(core::cluster core, std::string_view bucket_name, std::string_view scope_name, std::string_view name);
 
-    std::shared_ptr<couchbase::core::cluster> core_;
-    std::string bucket_name_;
-    std::string scope_name_;
-    std::string name_;
+    std::shared_ptr<binary_collection_impl> impl_;
 };
 } // namespace couchbase

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

@@ -19,20 +19,21 @@
 
 #include <couchbase/collection.hxx>
 #include <couchbase/collection_manager.hxx>
+#include <couchbase/ping_options.hxx>
 #include <couchbase/scope.hxx>
 
 #include <memory>
 
+namespace couchbase
+{
 #ifndef COUCHBASE_CXX_CLIENT_DOXYGEN
-namespace couchbase::core
+namespace core
 {
 class cluster;
-} // namespace couchbase::core
-#endif
-
-namespace couchbase
-{
+} // namespace core
 class cluster;
+class bucket_impl;
+#endif
 
 /**
  * Provides access to Couchbase bucket
@@ -51,10 +52,7 @@ class bucket
      * @since 1.0.0
      * @committed
      */
-    [[nodiscard]] auto default_scope() const -> scope
-    {
-        return { core_, name_, scope::default_name };
-    }
+    [[nodiscard]] auto default_scope() const -> scope;
 
     /**
      * Opens the default collection for this bucket using the default scope.
@@ -64,10 +62,7 @@ class bucket
      * @since 1.0.0
      * @committed
      */
-    [[nodiscard]] auto default_collection() const -> collection
-    {
-        return { core_, name_, scope::default_name, collection::default_name };
-    }
+    [[nodiscard]] auto default_collection() const -> collection;
 
     /**
      * Opens the {@link scope} with the given name.
@@ -78,10 +73,35 @@ class bucket
      * @since 1.0.0
      * @committed
      */
-    [[nodiscard]] auto scope(std::string_view scope_name) const -> scope
-    {
-        return { core_, name_, scope_name };
-    }
+    [[nodiscard]] auto scope(std::string_view scope_name) const -> scope;
+
+    /**
+     * Performs application-level ping requests against services in the Couchbase cluster.
+     *
+     * @note This operation performs active I/O against services and endpoints to assess their health. If you do not
+     * wish to performs I/O, consider using @ref diagnostics() instead.
+     *
+     * @param options custom options to change the default behavior.
+     * @param handler the handler that implements @ref ping_handler.
+     *
+     * @since 1.0.0
+     * @committed
+     */
+    void ping(const ping_options& options, ping_handler&& handler) const;
+
+    /**
+     * Performs application-level ping requests against services in the Couchbase cluster.
+     *
+     * @note This operation performs active I/O against services and endpoints to assess their health. If you do not
+     * wish to performs I/O, consider using @ref diagnostics() instead.
+     *
+     * @param options custom options to change the default behavior.
+     * @return future object that carries result of the operation.
+     *
+     * @since 1.0.0
+     * @committed
+     */
+    [[nodiscard]] auto ping(const ping_options& options = {}) const -> std::future<ping_result>;
 
     /**
      * Provides access to the collection management services.
@@ -91,21 +111,13 @@ class bucket
      * @since 1.0.0
      * @committed
      */
-    [[nodiscard]] auto collections() const -> collection_manager
-    {
-        return collection_manager{ core_, name_ };
-    }
+    [[nodiscard]] auto collections() const -> collection_manager;
 
   private:
-    friend class cluster;
+    friend cluster;
 
-    bucket(std::shared_ptr<couchbase::core::cluster> core, std::string_view name)
-      : core_(std::move(core))
-      , name_(name)
-    {
-    }
+    bucket(core::cluster core, std::string_view name);
 
-    std::shared_ptr<couchbase::core::cluster> core_;
-    std::string name_;
+    std::shared_ptr<bucket_impl> impl_;
 };
 } // namespace couchbase

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

@@ -28,10 +28,14 @@
 #include <memory>
 
 #ifndef COUCHBASE_CXX_CLIENT_DOXYGEN
-namespace couchbase::core
+namespace couchbase
+{
+namespace core
 {
 class cluster;
-} // namespace couchbase::core
+} // namespace core
+class bucket_manager_impl;
+} // namespace couchbase
 #endif
 
 namespace couchbase
@@ -125,11 +129,8 @@ class bucket_manager
   private:
     friend class cluster;
 
-    explicit bucket_manager(std::shared_ptr<couchbase::core::cluster> core)
-      : core_(std::move(core))
-    {
-    }
+    explicit bucket_manager(core::cluster core);
 
-    std::shared_ptr<couchbase::core::cluster> core_;
+    std::shared_ptr<bucket_manager_impl> impl_;
 };
 } // namespace couchbase

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

@@ -22,7 +22,6 @@
 #include <couchbase/manager_error_context.hxx>
 
 #include <functional>
-#include <memory>
 #include <optional>
 #include <string>