aboutsummaryrefslogtreecommitdiff
path: root/lib/csapi/versions.h
blob: 4445dbd29b8ddaff4efe83586cd56080ee68b09c (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
/******************************************************************************
 * THIS FILE IS GENERATED - ANY EDITS WILL BE OVERWRITTEN
 */

#pragma once

#include "jobs/basejob.h"

namespace Quotient {

/*! \brief Gets the versions of the specification supported by the server.
 *
 * Gets the versions of the specification supported by the server.
 *
 * Values will take the form `rX.Y.Z`.
 *
 * Only the latest `Z` value will be reported for each supported `X.Y` value.
 * i.e. if the server implements `r0.0.0`, `r0.0.1`, and `r1.2.0`, it will
 * report `r0.0.1` and `r1.2.0`.
 *
 * The server may additionally advertise experimental features it supports
 * through `unstable_features`. These features should be namespaced and
 * may optionally include version information within their name if desired.
 * Features listed here are not for optionally toggling parts of the Matrix
 * specification and should only be used to advertise support for a feature
 * which has not yet landed in the spec. For example, a feature currently
 * undergoing the proposal process may appear here and eventually be taken
 * off this list once the feature lands in the spec and the server deems it
 * reasonable to do so. Servers may wish to keep advertising features here
 * after they've been released into the spec to give clients a chance to
 * upgrade appropriately. Additionally, clients should avoid using unstable
 * features in their stable releases.
 */
class QUOTIENT_API GetVersionsJob : public BaseJob {
public:
    /// Gets the versions of the specification supported by the server.
    explicit GetVersionsJob();

    /*! \brief Construct a URL without creating a full-fledged job object
     *
     * This function can be used when a URL for GetVersionsJob
     * is necessary but the job itself isn't.
     */
    static QUrl makeRequestUrl(QUrl baseUrl);

    // Result properties

    /// The supported versions.
    QStringList versions() const
    {
        return loadFromJson<QStringList>("versions"_ls);
    }

    /// Experimental features the server supports. Features not listed here,
    /// or the lack of this property all together, indicate that a feature is
    /// not supported.
    QHash<QString, bool> unstableFeatures() const
    {
        return loadFromJson<QHash<QString, bool>>("unstable_features"_ls);
    }
};

} // namespace Quotient