Version 0.5.3

This is a "sustaining" release of 0.5.x branch, with ABI and API compatibility still retained but quite a few improvements backported from the upcoming 0.6 version. Here's the list:

• (#301/#383) Room::aliases() and Room::setAliases() are fixed, using the new alias management introduced in MSC2432 - thanks to @ram-nad
• (#321) More careful linkification of Matrix ids
• (#326) Support for the server notices room tag (MSC1452)
• (#330) Support of resolving the homeserver using .well-known (MSC433) - thanks to @encombhat
• (#341/#373/#376) Support of message editing and annotation (MSC1849) - thanks to @rpallai
• (#344) Compatibility with user deactivation error codes (MSC2181)
• (#345) Fix cache becoming inconsistent with actual room state due to unread counts not properly tracked - thanks to @rpallai
• (#347) Fix for a corner case in internal user avatar management that may lead to a crash in rare cases
• (#354) Provide a means to get the full list of rooms to client applications (aimed at fixing quotient-im/Quaternion#637 in the next Quaternion 0.0.9.4 rebuild)
• (#358) Only send access token where the spec says that it should be sent - thanks to nepugia for reporting
• (#359) Fix room highlighting for names with a hashtag - thanks to @a-andreyev
• (#361) Initialise read marker if there's none on the room yet
• (#365) Remove prev_content from special keys preserved against redaction (MSC1954)
• (#366) Make downloaded file name building more robust - thanks to nepugia for reporting
• (#387) Compatibility with Qt 5.14
• (#386/#388) SSO support
• (#390) Notify the client application about alias updates

Many thanks to everybody who tests and helps with development - and a separate thanks for the patience of users waiting for so long to get this release! You all are awesome!

P.S. The name of the library in this branch is still libQMatrixClient. Version 0.6 will be named libQuotient, as announced previously.

Version 0.5.2

A new bugfix release in 0.5.x branch:

• (#323) Direct chats are no more unmarked when logging in or after clearing the cache.

0.5.x releases keep the previous library name, libQMatrixClient.

Version 0.5.1.2

One more bugfix release in the 0.5.x branch:

• (#316) Expired tokens no more bring IncorrectRequestError instead of ContentAccessError; consequently, Connection::logout() ignores ContentAccessErrors so expired tokens don't leave the library in a "can't go-in, can't go out" state.
• Jobs abandoned due to Connection being deleted no more cause crashes.

Version 0.5.1.1

This release fixes a bug that makes 0.5.1 not being "new enough" for Quaternion 0.0.9.4, and another bug that made user showing up multiple times in the user list of Quaternion after renaming. Otherwise it's the same as version 0.5.1.

Version 0.5.1

(Update: this version has a bug in CMakeLists.txt that prevents it from being used by the upcoming Quaternion 0.0.9.4; version 0.5.1.1 fixes that)
This is a minor release in 0.5.x branch, fixing a few issues and adding small features:

• Fix (#303): linkification doesn't break on peculiar links.
• Fix (#310 and 27c2989): quirks in rendering room display names have been ironed out.
• Fix: Tighter validations of URLs coming with file events (too relaxed validations were causing the library to assert-crash on, e.g., encrypted attachments).
• Enhancement (#305): rooms created as direct chats are now automatically marked as m.direct for invited as well as inviting users.
• Enhancement (#306): Room::canSwitchVersions() returns false on rooms already upgraded (you still can disregard and call Room::switchVersion() but you better think twice - see https://github.com/matrix-org/matrix-doc/issues/1937).
• Enhancement: Room::postFile() now first starts file upload and then places a pending event (neatly packed with file transfer information), rather than the other way around. Unless you do weird things with the library's API, you shouldn't notice.
• Enhancement: LRO/RLO Unicode markers are now stripped from display names, to curtail abuse of those.
• Feature: Connection::domain() to save client authors from taking the domain from user MXID.

Version 0.5.0.2

Another bugfix release in 0.5.x branch, fixing issues with sending read receipts and redactions in v3 rooms (#300).

Version 0.5.0.1

This version fixes too stringent checks in debug builds that led to assertion crashes upon encounter with upgraded rooms.

Version 0.5

A long time has passed since version 0.4 has been released - more than 200 new commits landed since then so there's quite a lot to share! As usual, the new version includes a few bigger features and plenty of bug fixes, while staying focused on memory footprint and performance.

Thanks to all contributors and testers, as well as users of the library - authors of Matrix clients!

Compatibility

As usual for 0.x versions, 0.5 breaks API compatibility with previous versions; 0.4-compatible clients may or may not need changes in order to compile with version 0.5. As usual, see diffs in header files to track the changes and update the client code accordingly; these release notes highlight most prominent API changes.

Micro-versions in 0.5.y will maintain the API and ABI. Version 0.6 will break either API or ABI or both.

Version tags

Packagers, please update your scripts: from this version onwards, Git tags change naming convention: instead of rc0.x and v0.x.y the project will use 0.x-betaN and 0.x-rcN for pre-releases and 0.x.y for releases. The minor version number in the release tag is mandatory now.

Toolchain (see also README.md)

The supported compilers didn't change: GCC 5+, Clang 5+, MSVC 2015+. GCC 4.9.2 and Clang 3.8 still work but no significant effort is put into that. The library uses C++14 for the language standard.

QMatrixClient 0.5 is the last one supported on Qt 5.6, as The Qt Company ends support of this version in March 2019. If you still use Qt 5.6, make utmost effort to upgrade to the later version of Qt in the nearest months (Qt 5.12, the most recent LTS version for now, is recommended). From the next libQMatrixClient version, the officially supported minimum will be Qt 5.9 (the oldest supported LTS version from April), with possible workarounds for as low as Qt 5.7.

Integration

There are no big changes in integration Version 0.5 can be compiled either in static or (Linux-only so far) dynamic linking configuration. QML code can use most library facilities, assuming respective types are registered - you need a shim in C/C++ for that (see the code of uMatriks and Spectral for inspiration).

Same as before, the library includes pre-generated files for CS API; regenerating them requires GTAD from master branch (see also .travis,yml for the library for the general idea and CONTRIBUTING.md for details).

Features and changes

The full list of changes can be found in the commit log; you can also find the list of GitHub issues closed in the release.

New features, along with key library API for them:

• Fresh snapshot of CS API
• Massive changes to the way state is loaded, cached and saved:
  • #253: Members are lazy-loaded and room summaries are parsed if the server supports these; the full list of members is only loaded upon calling Room::getAllMembers(), or along with Room::setDisplayed() (which the clients are supposed to use to let the library know that the room is actually shown on the screen). This method has been there before 0.5 but now there's a really serious reason to use it! Given the massively successful use of lazy-loading, there's no option to switch it off.
  • #194: previously only the "known" types of state events were cached both to memory and to disk. This has changed - all state events are included into the room's state, not only into the timeline, and are saved to disk accordingly. Thanks to smart sharing of events between the state and the timeline, the memory footprint almost didn't suffer from that; at the same time clients can now process even state events the library doesn't know about (e.g., custom state events). Quaternion 0.0.9.4, for one, uses that to pretty-print TWIM bot state changes.
  • #194, #257: since the disk cache size became considerably bigger due to this change, and in order to generally better handle accounts with many (500+) rooms, each room's state is now cached to its separate file. That means that if you have 800 rooms you're going to have a directory with 800 files (which is peanuts for any contemporary file system but avoids the need to create and dump a huge JSON payload).
• #233, #235, #236: the library fully supports room versions and room upgrades - both invocation of those locally (Room::switchVersion()) and receiving of tombstone events and indicating that an upgrade happened (Room::upgraded()). If you call Room::switchVersion(), you may also want to connect to Room::upgradeFailed() to handle a possible case when the user is not allowed to upgrade a room. Also, check Room::isUnstable() in order to suggest your users to upgrade the room.
• #234: RoomCreateEvent is now a first-class citizen in the library, with proper accessors to the event data.
• #267: Room::postFile(), a much better API for sending files. Previously you had to separately call Room::uploadFile() and then, once the transfer is done, send a file event. Room::postFile() does the entire process for you, emitting appropriate signals along the way.
• #264: Connection::roomByAlias() - a room can now be retrieved by any of its known aliases; Connection::room() that gets a room by its id, didn't go anywhere either. Searching rooms by a string inside an alias or name is on the way!
• Changes in the room state are grouped from every sync and emitted via Room::changed() signal. This allows to reduce the number of connections clients need to track the room changes.
• Room::messageSent() to make it really easy to connect to the result of Room::post<anything>()
• Room::fileSource() to figure out where the up/downloaded file is from.
• Fake state events (those without state_key) no more trick the library into changing any state.

API breakage and deprecations:

• In simple state events (such as RoomNameEvent) content_type typedef now means the actually enclosed content type, which is SimpleContent<ValueType>; value_type is introduced to refer to the actual value type inside the content object.
• Room::timelineEdge() is now soft-deprecated (the compiler won't warn you, only the doc-string will); use Room::historyEdge() instead. At the same time we now have Room::syncEdge() that returns an iterator after the newest event.
• Connection::*error() signals now pass QString instead of QByteArray for details (their second parameter)
• Connection::load/saveState() no more receives the parameter defining the cache location (because the cache is no more a single file). Use cacheLocation() if you need to find out where the cache is.
• GetRoomStateByTypeJob is broken for now; will be fixed in patch versions of 0.5.
• Omittable<> no more implicitly casts to bool; if there ever was some code using it that code has to be fixed anyway.
• toJson()/fromJson() stuff massively refactored - should be much more scalable towards new data types now.
• SimpleContent no more derives from EventContent::Base (unlikely anybody ever relied on that)

Fixes and smaller things:

• #127: Connection::joinRoom() now allows to join rooms on other servers
• Room::eventsHistoryJob() is exposed as a Q_PROPERTY for the sake of checking from QML code
• #248: Local echo is no more stuck in the list of pending events
• #258: Banning now correctly removes the user from room members locally, not only on the server
• #273: A workaround has been added for a bug in Synapse that doesn't process retracted invites in some cases. The library will ensure the invite is deleted if the invite is additionally rejected from the local client.
• #274: Connection::syncLoop(), to save small glue code in clients connecting the next loop to the completion of the previous one. If you want to do it with time gaps etc., you still have to use Connection::sync() and your own custom glue code.
• #279: event ids with pipes (|) and slashes (/) won't break downloading to a temporary file from these events anymore.
• #278: URI schemes except spec-approved http(s), ftp, mailto and magnet are no more linkified by prettyPrint().
• SyncJob can now accept a standard CS API Filter instead of a generic QString. The QString overload is still there to allow passing filter ids.
• Connection::nextBatchToken(), in case you need a token to the (sync-side) end of the timeline.
• a new qt_connection_util.h header file with two facilities to ease working with QObject connections: connectSingleShot() and connectUntil().

Version 0.4.2.1

This version of libQMatrixClient contains a single fix: the library no more treats fake state events (that don't have state_key, even if they have state-related type, e.g., m.room.topic) as state events, turning them into unknown events instead. It is strongly recommended to upgrade from any 0.4.x version to 0.4.2.
(Update: version 0.4.2 had still the old version number in its CMakeLists.txt; version 0.4.2.1 has the version number correctly updated.)

Version 0.4.1

This is a maintenance release in 0.4.x branch. Notable changes include:

• Fix pending events (aka local echo) not being cleaned up properly
• Fix rooms not being correctly sorted according to their position under tag if using Connection::roomsByTags().
• Fix incorrect SOVERSION.