/******************************************************************************
* THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN
*/
#pragma once
#include "jobs/basejob.h"
namespace Quotient
{
// Operations
/// Set the position of the read marker for a room.
/*!
* Sets the position of the read marker for a given room, and optionally
* the read receipt's location.
*/
class SetReadMarkerJob : public BaseJob
{
public:
/*! Set the position of the read marker for a room.
* \param roomId
* The room ID to set the read marker in for the user.
* \param mFullyRead
* The event ID the read marker should be located at. The
* event MUST belong to the room.
* \param mRead
* The event ID to set the read receipt location at. This is
* equivalent to calling ``/receipt/m.read/$elsewhere:example.org``
* and is provided here to save that extra call.
*/
explicit SetReadMarkerJob(const QString& roomId, const QString& mFullyRead,
const QString& mRead = {});
};
} // namespace Quotient
it this file 'description' to name the repository.
blob: eeec5d4e6982b493528a79279dd601b162801220 (
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
|
/******************************************************************************
* THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN
*/
#pragma once
#include "converters.h"
#include "events/eventloader.h"
#include "jobs/basejob.h"
#include <QtCore/QJsonObject>
#include <QtCore/QVariant>
#include <QtCore/QVector>
namespace Quotient
{
// Operations
/// Gets a list of events that the user has been notified about
/*!
* This API is used to paginate through the list of events that the
* user has been, or would have been notified about.
*/
class GetNotificationsJob : public BaseJob
{
public:
// Inner data structures
/// This API is used to paginate through the list of events that theuser has
/// been, or would have been notified about.
struct Notification
{
/// The action(s) to perform when the conditions for this rule are
/// met.See `Push Rules: API`_.
QVector<QVariant> actions;
/// The Event object for the event that triggered the notification.
EventPtr event;
/// The profile tag of the rule that matched this event.
QString profileTag;
/// Indicates whether the user has sent a read receipt indicatingthat
/// they have read this message.
bool read;
/// The ID of the room in which the event was posted.
QString roomId;
/// The unix timestamp at which the event notification was sent,in
/// milliseconds.
int ts;
};
// Construction/destruction
/*! Gets a list of events that the user has been notified about
* \param from
* Pagination token given to retrieve the next set of events.
* \param limit
* Limit on the number of events to return in this request.
* \param only
* Allows basic filtering of events returned. Supply ``highlight``
* to return only events where the notification had the highlight
* tweak set.
*/
explicit GetNotificationsJob(const QString& from = {},
Omittable<int> limit = none,
const QString& only = {});
/*! Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for
* GetNotificationsJob is necessary but the job
* itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl, const QString& from = {},
Omittable<int> limit = none,
const QString& only = {});
~GetNotificationsJob() override;
// Result properties
/// The token to supply in the ``from`` param of the next
/// ``/notifications`` request in order to request more
/// events. If this is absent, there are no more results.
const QString& nextToken() const;
/// The list of events that triggered notifications.
std::vector<Notification>&& notifications();
protected:
Status parseJson(const QJsonDocument& data) override;
private:
class Private;
QScopedPointer<Private> d;
};
} // namespace Quotient
|