summaryrefslogtreecommitdiff
path: root/include/modules/rpc.h
blob: 35db305c700aa3df7d0c070c64c645b7e9af11e6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
/*
 *
 * (C) 2010-2025 Anope Team
 * Contact us at team@anope.org
 *
 * Please read COPYING and README for further details.
 */

#pragma once

#include "httpd.h"

#include <variant>

class RPCBlock
{
public:
	/** Represents possible types of RPC value. */
	using RPCValue = std::variant<RPCBlock, Anope::string, std::nullptr_t, bool, double, int64_t, uint64_t>;

	/** Retrieves the list of RPC replies. */
	inline const auto &GetReplies() const { return this->replies; }

	template <typename Stringable>
	inline RPCBlock &Reply(const Anope::string &key, const Stringable &value)
	{
		this->replies.emplace(key, Anope::ToString(value));
		return *this;
	}

	inline RPCBlock &ReplyBlock(const Anope::string &key)
	{
		auto it = this->replies.emplace(key, RPCBlock());
		return std::get<RPCBlock>(it.first->second);
	}

	inline RPCBlock &ReplyBool(const Anope::string &key, bool value)
	{
		this->replies.emplace(key, value);
		return *this;
	}

	inline RPCBlock &ReplyFloat(const Anope::string &key, double value)
	{
		this->replies.emplace(key, value);
		return *this;
	}

	inline RPCBlock &ReplyInt(const Anope::string &key, int64_t value)
	{
		this->replies.emplace(key, value);
		return *this;
	}

	inline RPCBlock &ReplyNull(const Anope::string &key)
	{
		this->replies.emplace(key, nullptr);
		return *this;
	}

	inline RPCBlock &ReplyUInt(const Anope::string &key, uint64_t value)
	{
		this->replies.emplace(key, value);
		return *this;
	}

private:
	Anope::map<RPCValue> replies;
};

class RPCRequest final
	: public RPCBlock
{
private:
	std::optional<std::pair<int64_t, Anope::string>> error;

public:
	Anope::string name;
	Anope::string id;
	std::deque<Anope::string> data;
	HTTPReply &reply;

	RPCRequest(HTTPReply &r)
		: reply(r)
	{
	}

	inline void Error(uint64_t errcode, const Anope::string &errstr)
	{
		this->error.emplace(errcode, errstr);
	}

	inline const auto &GetError() const { return this->error; }
};

class RPCServiceInterface;

class RPCEvent
{
private:
	Anope::string event;

protected:
	RPCEvent(const Anope::string& e)
		: event(e)
	{
	}

public:
	virtual ~RPCEvent() = default;

	const auto &GetEvent() const { return event; }

	virtual bool Run(RPCServiceInterface *iface, HTTPClient *client, RPCRequest &request) = 0;
};

class RPCServiceInterface
	: public Service
{
public:
	RPCServiceInterface(Module *creator, const Anope::string &sname) : Service(creator, "RPCServiceInterface", sname) { }

	virtual bool Register(RPCEvent *event) = 0;

	virtual bool Unregister(RPCEvent *event) = 0;

	virtual void Reply(RPCRequest &request) = 0;
};