discord.h

Go to the documentation of this file.

 
#ifndef DISCORD_H
#define DISCORD_H
 
#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */
 
#include <inttypes.h>
#include <stdbool.h>
 
#include "concord-error.h"
#include "types.h"
#include "io_poller.h"
#define LOGMOD_HEADER
#include "logmod.h"
 
#ifndef DISCORD_VERSION
#define DISCORD_VERSION "10"
#endif
 
#define DISCORD_API_BASE_URL       "https://discord.com/api/v" DISCORD_VERSION
#define DISCORD_GATEWAY_URL_SUFFIX "?v=" DISCORD_VERSION "&encoding=json"
 
/* forward declaration */
struct discord;
struct reflectc;
 
 
struct reflectc *discord_get_registry(struct discord *client);
 
#include "discord_codecs.h"
#include "discord-response.h"
 
#define DISCORD_MAX_NAME_LEN          4 * 100 + 1
#define DISCORD_MAX_TOPIC_LEN         4 * 1024 + 1
#define DISCORD_MAX_DESCRIPTION_LEN   4 * 2048 + 1
#define DISCORD_MAX_USERNAME_LEN      4 * 32 + 1
#define DISCORD_MAX_DISCRIMINATOR_LEN 4 + 1
#define DISCORD_MAX_REASON_LEN        4 * 512 + 1
#define DISCORD_MAX_MESSAGE_LEN       4 * 2000 + 1
#define DISCORD_MAX_PAYLOAD_LEN       4 * 4096 + 1
#define DISCORD_EMBED_TITLE_LEN       4 * 256 + 1
#define DISCORD_EMBED_DESCRIPTION_LEN 4 * 4096 + 1
#define DISCORD_EMBED_MAX_FIELDS      25
#define DISCORD_EMBED_FIELD_NAME_LEN  4 * 256 + 1
#define DISCORD_EMBED_FIELD_VALUE_LEN 4 * 1024 + 1
#define DISCORD_EMBED_FOOTER_TEXT_LEN 4 * 2048 + 1
#define DISCORD_EMBED_AUTHOR_NAME_LEN 4 * 256 + 1
#define DISCORD_WEBHOOK_NAME_LEN 4 * 80 + 1
/* XXX: As new values are added, discord_strerror() and
 *      discord_code_as_string() should be updated accordingly! */
#define CCORD_DISCORD_OK CCORD_OK
#define CCORD_PENDING 1
#define CCORD_DISCORD_JSON_CODE 100
#define CCORD_DISCORD_BAD_AUTH 101
#define CCORD_DISCORD_RATELIMIT 102
#define CCORD_DISCORD_CONNECTION 103
 
const char *discord_code_as_string(CCORDcode code);
 
const char *discord_strerror(CCORDcode code, struct discord *client);
 
#include "audit_log.h"
#include "auto_moderation.h"
#include "invite.h"
#include "channel.h"
#include "emoji.h"
#include "guild.h"
#include "guild_scheduled_event.h"
#include "guild_template.h"
#include "stage_instance.h"
#include "sticker.h"
#include "user.h"
#include "voice.h"
#include "webhook.h"
#include "gateway.h"
#include "oauth2.h"
#include "application_command.h"
#include "interaction.h"
#include "discord-cache.h"
#include "discord-events.h"
 
#define discord_claim(client, data) (__discord_claim(client, data), data)
void __discord_claim(struct discord *client, const void *data);
 
void discord_unclaim(struct discord *client, const void *data);
 
#define ccord_global_init()
 
#define ccord_global_cleanup()
 
void discord_shutdown_all(void);
 
bool discord_shutdown_all_ongoing(void);
 
#define ccord_shutdown_async() discord_shutdown_all()
 
struct discord *discord_from_token(const char token[]);
 
struct discord *discord_from_json(const char config_file[]);
 
struct discord_config {
    char *token;
    char *base_url;
    struct {
        enum logmod_levels level;
        bool quiet;
        bool color;
        bool overwrite;
        /* the trace log file */
        FILE *trace;
        /* the http log file */
        FILE *http;
        /* the ws log file */
        FILE *ws;
        struct {
            size_t size;
            char **ids;
        } disable; 
    } log; 
};
 
struct discord *discord_from_config(const struct discord_config *config);
 
#define discord_init discord_from_token
 
#define discord_config_init discord_from_json
 
struct ccord_szbuf_readonly discord_config_get_field(struct discord *client,
                                                     char *const path[],
                                                     unsigned depth);
 
struct discord *discord_clone(const struct discord *orig);
 
void discord_cleanup(struct discord *client);
 
const struct discord_user *discord_get_self(struct discord *client);
 
CCORDcode discord_run(struct discord *client);
 
void discord_shutdown(struct discord *client);
 
void discord_reconnect(struct discord *client, bool resume);
 
void *discord_set_data(struct discord *client, void *data);
 
void *discord_get_data(struct discord *client);
 
int discord_get_ping(struct discord *client);
 
uint64_t discord_timestamp(struct discord *client);
 
uint64_t discord_timestamp_us(struct discord *client);
 
struct logmod *discord_get_logmod(struct discord *client);
 
struct io_poller *discord_get_io_poller(struct discord *client);
 
#define __CAT(_a, _b) _a##_b
#define _CAT(_a, _b)  __CAT(_a, _b)
#define _EXPECT_CONTAINER__struct
#define _EXPECT_CONTAINER__union
#define _DISCORD_SYMBOL_WITHOUT_CONTAINER(_symbol)                            \
    _CAT(_EXPECT_CONTAINER__, _symbol)
 
#define discord_data_wrap reflectc_wrap
 
#define discord_data_wrap_from(_symbol, _client, _data)                       \
    _CAT(reflectc_from_, _DISCORD_SYMBOL_WITHOUT_CONTAINER(_symbol))(         \
        discord_get_registry((_client)), _data, NULL)
 
#define discord_data_cleanup(_client, _data)                                  \
    discord_data_free(discord_get_registry((_client)), (_data))
 
void discord_data_free(struct reflectc *registry, void *data);
 
#define discord_data_unwrap(_client, _data)                                   \
    discord_data_release(discord_get_registry((_client)), (_data))
 
void discord_data_release(struct reflectc *registry, void *data);
 
/* forward declaration */
struct jsmnf_pair;
struct jsonb;
 
CCORDcode discord_data_wrap_to_json(const struct discord_data_wrap *member,
                                    char *p_buf[],
                                    size_t *p_bufsize);
 
#define discord_data_to_json(_symbol, _client, _data, _p_buf, _p_bufsize)     \
    discord_data_wrap_to_json(                                                \
        discord_data_wrap_from(_symbol, _client, _data), _p_buf, _p_bufsize)
 
CCORDcode discord_data_wrap_to_jsonb(struct jsonb *jb,
                                     const struct discord_data_wrap *member,
                                     char *p_buf[],
                                     size_t *p_bufsize);
 
#define discord_data_to_jsonb(_symbol, _client, _jb, _data, _p_buf,           \
                              _p_bufsize)                                     \
    discord_data_wrap_to_jsonb(                                               \
        _jb, discord_data_wrap_from(_symbol, _client, _data), _p_buf,         \
        _p_bufsize)
 
CCORDcode discord_data_wrap_from_json(const char *json,
                                      size_t len,
                                      struct discord_data_wrap *root);
 
#define discord_data_from_json(_symbol, _client, _json, _len, _data)          \
    discord_data_wrap_from_json(                                              \
        _json, _len, discord_data_wrap_from(_symbol, _client, _data))
 
CCORDcode discord_data_wrap_from_jsmnf(const struct jsmnf_pair *p,
                                       const char *json,
                                       size_t length,
                                       const struct discord_data_wrap *member);
 
#define discord_data_from_jsmnf(_client, _p, _json, _length, _type, _data)    \
    discord_data_wrap_from_jsmnf(                                             \
        _p, _json, _length, discord_data_wrap_from(_type, _client, _data))
 
/* forward declaration */
struct discord_timer;
 
 
typedef void (*discord_ev_timer)(struct discord *client,
                                 struct discord_timer *ev);
 
enum discord_timer_flags {
    DISCORD_TIMER_MILLISECONDS = 0,
    DISCORD_TIMER_MICROSECONDS = 1 << 0,
    DISCORD_TIMER_DELETE = 1 << 1,
    DISCORD_TIMER_DELETE_AUTO = 1 << 2,
    DISCORD_TIMER_CANCELED = 1 << 3,
    DISCORD_TIMER_TICK = 1 << 4,
    DISCORD_TIMER_GET = 1 << 5,
    DISCORD_TIMER_INTERVAL_FIXED = 1 << 6,
};
 
struct discord_timer {
    unsigned id;
    enum discord_timer_flags flags;
    discord_ev_timer on_tick;
    discord_ev_timer on_status_changed;
    void *data;
    int64_t delay;
    int64_t interval;
    int64_t repeat;
};
 
unsigned discord_timer_ctl(struct discord *client,
                           struct discord_timer *timer);
 
unsigned discord_timer(struct discord *client,
                       discord_ev_timer on_tick_cb,
                       discord_ev_timer on_status_changed_cb,
                       void *data,
                       int64_t delay);
 
unsigned discord_timer_interval(struct discord *client,
                                discord_ev_timer on_tick_cb,
                                discord_ev_timer on_status_changed_cb,
                                void *data,
                                int64_t delay,
                                int64_t interval,
                                int64_t repeat);
 
bool discord_timer_get(struct discord *client,
                       unsigned id,
                       struct discord_timer *timer);
 
bool discord_timer_start(struct discord *client, unsigned id);
 
bool discord_timer_stop(struct discord *client, unsigned id);
 
bool discord_timer_cancel(struct discord *client, unsigned id);
 
bool discord_timer_delete(struct discord *client, unsigned id);
 
bool discord_timer_cancel_and_delete(struct discord *client, unsigned id);
 
#ifdef __cplusplus
}
#endif /* __cplusplus */
 
#endif /* DISCORD_H */