/*
 * Copyright 2013 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.
 */

#ifndef MONGOC_CLIENT_H
#define MONGOC_CLIENT_H

#if !defined (MONGOC_INSIDE) && !defined (MONGOC_COMPILATION)
# error "Only <mongoc.h> can be included directly."
#endif

#include <bson.h>

#include "mongoc-apm.h"
#include "mongoc-collection.h"
#include "mongoc-config.h"
#include "mongoc-cursor.h"
#include "mongoc-database.h"
#include "mongoc-gridfs.h"
#include "mongoc-index.h"
#include "mongoc-read-prefs.h"
#ifdef MONGOC_ENABLE_SSL
# include "mongoc-ssl.h"
#endif
#include "mongoc-stream.h"
#include "mongoc-uri.h"
#include "mongoc-write-concern.h"
#include "mongoc-read-concern.h"
#include "mongoc-server-description.h"


BSON_BEGIN_DECLS


#define MONGOC_NAMESPACE_MAX 128


#ifndef MONGOC_DEFAULT_CONNECTTIMEOUTMS
#define MONGOC_DEFAULT_CONNECTTIMEOUTMS (10 * 1000L)
#endif


#ifndef MONGOC_DEFAULT_SOCKETTIMEOUTMS
/*
 * NOTE: The default socket timeout for connections is 5 minutes. This
 *       means that if your MongoDB server dies or becomes unavailable
 *       it will take 5 minutes to detect this.
 *
 *       You can change this by providing sockettimeoutms= in your
 *       connection URI.
 */
#define MONGOC_DEFAULT_SOCKETTIMEOUTMS (1000L * 60L * 5L)
#endif


/**
 * mongoc_client_t:
 *
 * The mongoc_client_t structure maintains information about a connection to
 * a MongoDB server.
 */
typedef struct _mongoc_client_t mongoc_client_t;


/**
 * mongoc_stream_initiator_t:
 * @uri: The uri and options for the stream.
 * @host: The host and port (or UNIX domain socket path) to connect to.
 * @user_data: The pointer passed to mongoc_client_set_stream_initiator.
 * @error: A location for an error.
 *
 * Creates a new mongoc_stream_t for the host and port. Begin a
 * non-blocking connect and return immediately.
 *
 * This can be used by language bindings to create network transports other
 * than those built into libmongoc. An example of such would be the streams
 * API provided by PHP.
 *
 * Returns: A newly allocated mongoc_stream_t or NULL on failure.
 */
typedef mongoc_stream_t *(*mongoc_stream_initiator_t) (const mongoc_uri_t       *uri,
                                                       const mongoc_host_list_t *host,
                                                       void                     *user_data,
                                                       bson_error_t             *error);


BSON_API
mongoc_client_t               *mongoc_client_new                           (const char                   *uri_string);
BSON_API
mongoc_client_t               *mongoc_client_new_from_uri                  (const mongoc_uri_t           *uri);
BSON_API
const mongoc_uri_t            *mongoc_client_get_uri                       (const mongoc_client_t        *client);
BSON_API
void                           mongoc_client_set_stream_initiator          (mongoc_client_t              *client,
                                                                            mongoc_stream_initiator_t     initiator,
                                                                            void                         *user_data);
BSON_API
mongoc_cursor_t               *mongoc_client_command                       (mongoc_client_t              *client,
                                                                            const char                   *db_name,
                                                                            mongoc_query_flags_t          flags,
                                                                            uint32_t                      skip,
                                                                            uint32_t                      limit,
                                                                            uint32_t                      batch_size,
                                                                            const bson_t                 *query,
                                                                            const bson_t                 *fields,
                                                                            const mongoc_read_prefs_t    *read_prefs);
BSON_API
void                           mongoc_client_kill_cursor                   (mongoc_client_t *client,
                                                                            int64_t          cursor_id) BSON_GNUC_DEPRECATED;
BSON_API
bool                           mongoc_client_command_simple                (mongoc_client_t              *client,
                                                                            const char                   *db_name,
                                                                            const bson_t                 *command,
                                                                            const mongoc_read_prefs_t    *read_prefs,
                                                                            bson_t                       *reply,
                                                                            bson_error_t                 *error);
BSON_API
bool                           mongoc_client_read_command_with_opts        (mongoc_client_t              *client,
                                                                            const char                   *db_name,
                                                                            const bson_t                 *command,
                                                                            const mongoc_read_prefs_t    *read_prefs,
                                                                            const bson_t                 *opts,
                                                                            bson_t                       *reply,
                                                                            bson_error_t                 *error);
BSON_API
bool                           mongoc_client_write_command_with_opts       (mongoc_client_t              *client,
                                                                            const char                   *db_name,
                                                                            const bson_t                 *command,
                                                                            const bson_t                 *opts,
                                                                            bson_t                       *reply,
                                                                            bson_error_t                 *error);
BSON_API
bool                           mongoc_client_read_write_command_with_opts  (mongoc_client_t              *client,
                                                                            const char                   *db_name,
                                                                            const bson_t                 *command,
                                                                            const mongoc_read_prefs_t    *read_prefs,
                                                                            const bson_t                 *opts,
                                                                            bson_t                       *reply,
                                                                            bson_error_t                 *error);
BSON_API
bool                           mongoc_client_command_simple_with_server_id (mongoc_client_t              *client,
                                                                            const char                   *db_name,
                                                                            const bson_t                 *command,
                                                                            const mongoc_read_prefs_t    *read_prefs,
                                                                            uint32_t                      server_id,
                                                                            bson_t                       *reply,
                                                                            bson_error_t                 *error);
BSON_API
void                           mongoc_client_destroy                       (mongoc_client_t              *client);
BSON_API
mongoc_database_t             *mongoc_client_get_database                  (mongoc_client_t              *client,
                                                                            const char                   *name);
BSON_API
mongoc_database_t             *mongoc_client_get_default_database          (mongoc_client_t              *client);
BSON_API
mongoc_gridfs_t               *mongoc_client_get_gridfs                    (mongoc_client_t              *client,
                                                                            const char                   *db,
                                                                            const char                   *prefix,
                                                                            bson_error_t                 *error);
BSON_API
mongoc_collection_t           *mongoc_client_get_collection                (mongoc_client_t              *client,
                                                                            const char                   *db,
                                                                            const char                   *collection);
BSON_API
char                         **mongoc_client_get_database_names            (mongoc_client_t              *client,
                                                                            bson_error_t                 *error);
BSON_API
mongoc_cursor_t               *mongoc_client_find_databases                (mongoc_client_t              *client,
                                                                            bson_error_t                 *error);
BSON_API
bool                           mongoc_client_get_server_status             (mongoc_client_t              *client,
                                                                            mongoc_read_prefs_t          *read_prefs,
                                                                            bson_t                       *reply,
                                                                            bson_error_t                 *error);
BSON_API
int32_t                        mongoc_client_get_max_message_size          (mongoc_client_t              *client) BSON_GNUC_DEPRECATED;
BSON_API
int32_t                        mongoc_client_get_max_bson_size             (mongoc_client_t              *client) BSON_GNUC_DEPRECATED;
BSON_API
const mongoc_write_concern_t  *mongoc_client_get_write_concern             (const mongoc_client_t        *client);
BSON_API
void                           mongoc_client_set_write_concern             (mongoc_client_t              *client,
                                                                            const mongoc_write_concern_t *write_concern);
BSON_API
const mongoc_read_concern_t   *mongoc_client_get_read_concern              (const mongoc_client_t        *client);
BSON_API
void                           mongoc_client_set_read_concern              (mongoc_client_t              *client,
                                                                            const mongoc_read_concern_t  *read_concern);
BSON_API
const mongoc_read_prefs_t     *mongoc_client_get_read_prefs                (const mongoc_client_t        *client);
BSON_API
void                           mongoc_client_set_read_prefs                (mongoc_client_t              *client,
                                                                            const mongoc_read_prefs_t    *read_prefs);
#ifdef MONGOC_ENABLE_SSL
BSON_API
void                           mongoc_client_set_ssl_opts                  (mongoc_client_t              *client,
                                                                            const mongoc_ssl_opt_t       *opts);
#endif
BSON_API
bool                           mongoc_client_set_apm_callbacks             (mongoc_client_t              *client,
                                                                            mongoc_apm_callbacks_t       *callbacks,
                                                                            void                         *context);
BSON_API
mongoc_server_description_t   *mongoc_client_get_server_description        (mongoc_client_t              *client,
                                                                            uint32_t                      server_id);
BSON_API
mongoc_server_description_t  **mongoc_client_get_server_descriptions       (const mongoc_client_t        *client,
                                                                            size_t                       *n);
BSON_API
void                           mongoc_server_descriptions_destroy_all      (mongoc_server_description_t **sds,
                                                                            size_t                        n);
BSON_API
mongoc_server_description_t   *mongoc_client_select_server                 (mongoc_client_t              *client,
                                                                            bool                          for_writes,
                                                                            const mongoc_read_prefs_t    *prefs,
                                                                            bson_error_t                 *error);
BSON_API
bool                           mongoc_client_set_error_api                 (mongoc_client_t              *client,
                                                                            int32_t                       version);
BSON_API
bool                           mongoc_client_set_appname                   (mongoc_client_t              *client,
                                                                            const char                   *appname);
BSON_END_DECLS


#endif /* MONGOC_CLIENT_H */
