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
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
|
/******************************************************************************
* THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN
*/
#pragma once
#include "jobs/basejob.h"
namespace Quotient {
/*! \brief Gets the current pushers for the authenticated user
*
* Gets all currently active pushers for the authenticated user.
*/
class GetPushersJob : public BaseJob {
public:
// Inner data structures
/// A dictionary of information for the pusher implementation
/// itself.
struct PusherData {
/// Required if `kind` is `http`. The URL to use to send
/// notifications to.
QString url;
/// The format to use when sending notifications to the Push
/// Gateway.
QString format;
};
/// Gets all currently active pushers for the authenticated user.
struct Pusher {
/// This is a unique identifier for this pusher. See `/set` for
/// more detail.
/// Max length, 512 bytes.
QString pushkey;
/// The kind of pusher. `"http"` is a pusher that
/// sends HTTP pokes.
QString kind;
/// This is a reverse-DNS style identifier for the application.
/// Max length, 64 chars.
QString appId;
/// A string that will allow the user to identify what application
/// owns this pusher.
QString appDisplayName;
/// A string that will allow the user to identify what device owns
/// this pusher.
QString deviceDisplayName;
/// This string determines which set of device specific rules this
/// pusher executes.
QString profileTag;
/// The preferred language for receiving notifications (e.g. 'en'
/// or 'en-US')
QString lang;
/// A dictionary of information for the pusher implementation
/// itself.
PusherData data;
};
// Construction/destruction
/// Gets the current pushers for the authenticated user
explicit GetPushersJob();
/*! \brief Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for GetPushersJob
* is necessary but the job itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl);
// Result properties
/// An array containing the current pushers for the user
QVector<Pusher> pushers() const
{
return loadFromJson<QVector<Pusher>>("pushers"_ls);
}
};
template <>
struct JsonObjectConverter<GetPushersJob::PusherData> {
static void fillFrom(const QJsonObject& jo,
GetPushersJob::PusherData& result)
{
fromJson(jo.value("url"_ls), result.url);
fromJson(jo.value("format"_ls), result.format);
}
};
template <>
struct JsonObjectConverter<GetPushersJob::Pusher> {
static void fillFrom(const QJsonObject& jo, GetPushersJob::Pusher& result)
{
fromJson(jo.value("pushkey"_ls), result.pushkey);
fromJson(jo.value("kind"_ls), result.kind);
fromJson(jo.value("app_id"_ls), result.appId);
fromJson(jo.value("app_display_name"_ls), result.appDisplayName);
fromJson(jo.value("device_display_name"_ls), result.deviceDisplayName);
fromJson(jo.value("profile_tag"_ls), result.profileTag);
fromJson(jo.value("lang"_ls), result.lang);
fromJson(jo.value("data"_ls), result.data);
}
};
/*! \brief Modify a pusher for this user on the homeserver.
*
* This endpoint allows the creation, modification and deletion of
* [pushers](/client-server-api/#push-notifications) for this user ID. The
* behaviour of this endpoint varies depending on the values in the JSON body.
*/
class PostPusherJob : public BaseJob {
public:
// Inner data structures
/// A dictionary of information for the pusher implementation
/// itself. If `kind` is `http`, this should contain `url`
/// which is the URL to use to send notifications to.
struct PusherData {
/// Required if `kind` is `http`. The URL to use to send
/// notifications to. MUST be an HTTPS URL with a path of
/// `/_matrix/push/v1/notify`.
QString url;
/// The format to send notifications in to Push Gateways if the
/// `kind` is `http`. The details about what fields the
/// homeserver should send to the push gateway are defined in the
/// [Push Gateway Specification](/push-gateway-api/). Currently the only
/// format available is 'event_id_only'.
QString format;
};
// Construction/destruction
/*! \brief Modify a pusher for this user on the homeserver.
*
* \param pushkey
* This is a unique identifier for this pusher. The value you
* should use for this is the routing or destination address
* information for the notification, for example, the APNS token
* for APNS or the Registration ID for GCM. If your notification
* client has no such concept, use any unique identifier.
* Max length, 512 bytes.
*
* If the `kind` is `"email"`, this is the email address to
* send notifications to.
*
* \param kind
* The kind of pusher to configure. `"http"` makes a pusher that
* sends HTTP pokes. `"email"` makes a pusher that emails the
* user with unread notifications. `null` deletes the pusher.
*
* \param appId
* This is a reverse-DNS style identifier for the application.
* It is recommended that this end with the platform, such that
* different platform versions get different app identifiers.
* Max length, 64 chars.
*
* If the `kind` is `"email"`, this is `"m.email"`.
*
* \param appDisplayName
* A string that will allow the user to identify what application
* owns this pusher.
*
* \param deviceDisplayName
* A string that will allow the user to identify what device owns
* this pusher.
*
* \param lang
* The preferred language for receiving notifications (e.g. 'en'
* or 'en-US').
*
* \param data
* A dictionary of information for the pusher implementation
* itself. If `kind` is `http`, this should contain `url`
* which is the URL to use to send notifications to.
*
* \param profileTag
* This string determines which set of device specific rules this
* pusher executes.
*
* \param append
* If true, the homeserver should add another pusher with the
* given pushkey and App ID in addition to any others with
* different user IDs. Otherwise, the homeserver must remove any
* other pushers with the same App ID and pushkey for different
* users. The default is `false`.
*/
explicit PostPusherJob(const QString& pushkey, const QString& kind,
const QString& appId, const QString& appDisplayName,
const QString& deviceDisplayName,
const QString& lang, const PusherData& data,
const QString& profileTag = {},
Omittable<bool> append = none);
};
template <>
struct JsonObjectConverter<PostPusherJob::PusherData> {
static void dumpTo(QJsonObject& jo, const PostPusherJob::PusherData& pod)
{
addParam<IfNotEmpty>(jo, QStringLiteral("url"), pod.url);
addParam<IfNotEmpty>(jo, QStringLiteral("format"), pod.format);
}
};
} // namespace Quotient
|
