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
|
/******************************************************************************
* THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN
*/
#pragma once
#include "csapi/definitions/user_identifier.h"
#include "csapi/definitions/wellknown/full.h"
#include "jobs/basejob.h"
namespace Quotient {
/*! \brief Get the supported login types to authenticate users
*
* Gets the homeserver's supported login types to authenticate users. Clients
* should pick one of these and supply it as the `type` when logging in.
*/
class QUOTIENT_API GetLoginFlowsJob : public BaseJob {
public:
// Inner data structures
/// Gets the homeserver's supported login types to authenticate users.
/// Clients should pick one of these and supply it as the `type` when
/// logging in.
struct LoginFlow {
/// The login type. This is supplied as the `type` when
/// logging in.
QString type;
};
// Construction/destruction
/// Get the supported login types to authenticate users
explicit GetLoginFlowsJob();
/*! \brief Construct a URL without creating a full-fledged job object
*
* This function can be used when a URL for GetLoginFlowsJob
* is necessary but the job itself isn't.
*/
static QUrl makeRequestUrl(QUrl baseUrl);
// Result properties
/// The homeserver's supported login types
QVector<LoginFlow> flows() const
{
return loadFromJson<QVector<LoginFlow>>("flows"_ls);
}
};
template <>
struct JsonObjectConverter<GetLoginFlowsJob::LoginFlow> {
static void fillFrom(const QJsonObject& jo,
GetLoginFlowsJob::LoginFlow& result)
{
fromJson(jo.value("type"_ls), result.type);
}
};
/*! \brief Authenticates the user.
*
* Authenticates the user, and issues an access token they can
* use to authorize themself in subsequent requests.
*
* If the client does not supply a `device_id`, the server must
* auto-generate one.
*
* The returned access token must be associated with the `device_id`
* supplied by the client or generated by the server. The server may
* invalidate any access token previously associated with that device. See
* [Relationship between access tokens and
* devices](/client-server-api/#relationship-between-access-tokens-and-devices).
*/
class QUOTIENT_API LoginJob : public BaseJob {
public:
/*! \brief Authenticates the user.
*
* \param type
* The login type being used.
*
* \param identifier
* Authenticates the user, and issues an access token they can
* use to authorize themself in subsequent requests.
*
* If the client does not supply a `device_id`, the server must
* auto-generate one.
*
* The returned access token must be associated with the `device_id`
* supplied by the client or generated by the server. The server may
* invalidate any access token previously associated with that device. See
* [Relationship between access tokens and
* devices](/client-server-api/#relationship-between-access-tokens-and-devices).
*
* \param password
* Required when `type` is `m.login.password`. The user's
* password.
*
* \param token
* Required when `type` is `m.login.token`. Part of Token-based login.
*
* \param deviceId
* ID of the client device. If this does not correspond to a
* known client device, a new device will be created. The given
* device ID must not be the same as a
* [cross-signing](/client-server-api/#cross-signing) key ID.
* The server will auto-generate a device_id
* if this is not specified.
*
* \param initialDeviceDisplayName
* A display name to assign to the newly-created device. Ignored
* if `device_id` corresponds to a known device.
*
* \param refreshToken
* If true, the client supports refresh tokens.
*/
explicit LoginJob(const QString& type,
const Omittable<UserIdentifier>& identifier = none,
const QString& password = {}, const QString& token = {},
const QString& deviceId = {},
const QString& initialDeviceDisplayName = {},
Omittable<bool> refreshToken = none);
// Result properties
/// The fully-qualified Matrix ID for the account.
QString userId() const { return loadFromJson<QString>("user_id"_ls); }
/// An access token for the account.
/// This access token can then be used to authorize other requests.
QString accessToken() const
{
return loadFromJson<QString>("access_token"_ls);
}
/// A refresh token for the account. This token can be used to
/// obtain a new access token when it expires by calling the
/// `/refresh` endpoint.
QString refreshToken() const
{
return loadFromJson<QString>("refresh_token"_ls);
}
/// The lifetime of the access token, in milliseconds. Once
/// the access token has expired a new access token can be
/// obtained by using the provided refresh token. If no
/// refresh token is provided, the client will need to re-log in
/// to obtain a new access token. If not given, the client can
/// assume that the access token will not expire.
Omittable<int> expiresInMs() const
{
return loadFromJson<Omittable<int>>("expires_in_ms"_ls);
}
/// ID of the logged-in device. Will be the same as the
/// corresponding parameter in the request, if one was specified.
QString deviceId() const { return loadFromJson<QString>("device_id"_ls); }
/// Optional client configuration provided by the server. If present,
/// clients SHOULD use the provided object to reconfigure themselves,
/// optionally validating the URLs within. This object takes the same
/// form as the one returned from .well-known autodiscovery.
Omittable<DiscoveryInformation> wellKnown() const
{
return loadFromJson<Omittable<DiscoveryInformation>>("well_known"_ls);
}
};
} // namespace Quotient
|
