change_stream.hpp

// Copyright 2018-present MongoDB 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 <chrono>

#include <bsoncxx/document/view_or_value.hpp>
#include <bsoncxx/string/view_or_value.hpp>
#include <bsoncxx/types.hpp>
#include <mongocxx/stdx.hpp>

#include <mongocxx/config/prelude.hpp>

namespace mongocxx {
MONGOCXX_INLINE_NAMESPACE_BEGIN

class client;
class collection;
class database;

namespace options {

class MONGOCXX_API change_stream {
   public:
    change_stream();

    change_stream& full_document(bsoncxx::string::view_or_value full_doc);

    const bsoncxx::stdx::optional<bsoncxx::string::view_or_value>& full_document() const;

    change_stream& batch_size(std::int32_t batch_size);

    const stdx::optional<std::int32_t>& batch_size() const;

    change_stream& resume_after(bsoncxx::document::view_or_value resume_after);

    const stdx::optional<bsoncxx::document::view_or_value>& resume_after() const;

    change_stream& start_after(bsoncxx::document::view_or_value token);

    const stdx::optional<bsoncxx::document::view_or_value>& start_after() const;

    change_stream& collation(bsoncxx::document::view_or_value collation);

    const stdx::optional<bsoncxx::document::view_or_value>& collation() const;

    change_stream& max_await_time(std::chrono::milliseconds max_time);

    const stdx::optional<std::chrono::milliseconds>& max_await_time() const;

    change_stream& start_at_operation_time(bsoncxx::types::b_timestamp timestamp);

   private:
    friend class ::mongocxx::client;
    friend class ::mongocxx::collection;
    friend class ::mongocxx::database;

    bsoncxx::document::value as_bson() const;
    stdx::optional<bsoncxx::string::view_or_value> _full_document;
    stdx::optional<std::int32_t> _batch_size;
    stdx::optional<bsoncxx::document::view_or_value> _collation;
    stdx::optional<bsoncxx::document::view_or_value> _resume_after;
    stdx::optional<bsoncxx::document::view_or_value> _start_after;
    stdx::optional<std::chrono::milliseconds> _max_await_time;
    // _start_at_operation_time is not wrapped in a stdx::optional because of a longstanding bug in
    // the MNMLSTC polyfill that has been fixed on master, but not in the latest release:
    // https://github.com/mnmlstc/core/pull/23
    bsoncxx::types::b_timestamp _start_at_operation_time;
    bool _start_at_operation_time_set = false;
};
}  // namespace options
MONGOCXX_INLINE_NAMESPACE_END
}  // namespace mongocxx

#include <mongocxx/config/postlude.hpp>