Synapse 1.49.0rc1 (2021-12-07)

We've decided to move the existing, somewhat stagnant pages from the GitHub wiki to the documentation website.

This was done for two reasons. The first was to ensure that changes are checked by multiple authors before being committed (everyone makes mistakes!) and the second was visibility of the documentation. Not everyone knows that Synapse has some very useful information hidden away in its GitHub wiki pages. Bringing them to the documentation website should help with visibility, as well as keep all Synapse documentation in one, easily-searchable location.

Note that contributions to the documentation website happen through GitHub pull requests. Please visit #synapse-dev:matrix.org if you need help with the process!

Features

• Add MSC3030 experimental client and federation API endpoints to get the closest event to a given timestamp. (#9445)
• Include bundled relation aggregations during a limited /sync request and /relations request, per MSC2675. (#11284, #11478)
• Add plugin support for controlling database background updates. (#11306, #11475, #11479)
• Support the stable API endpoints for MSC2946: the room /hierarchy endpoint. (#11329)
• Add admin API to get some information about federation status with remote servers. (#11407)
• Support expiry of refresh tokens and expiry of the overall session when refresh tokens are in use. (#11425)
• Stabilise support for MSC2918 refresh tokens as they have now been merged into the Matrix specification. (#11435, #11522)
• Update MSC2918 refresh token support to confirm with the latest revision: accept the refresh_tokens parameter in the request body rather than in the URL parameters. (#11430)
• Support configuring the lifetime of non-refreshable access tokens separately to refreshable access tokens. (#11445)
• Expose synapse_homeserver and synapse_worker commands as entry points to run Synapse's main process and worker processes, respectively. Contributed by @Ma27. (#11449)
• synctl stop will now wait for Synapse to exit before returning. (#11459, #11490)
• Extend the "delete room" admin api to work correctly on rooms which have previously been partially deleted. (#11523)
• Add support for the /_matrix/client/v3/login/sso/redirect/{idpId} API from Matrix v1.1. This endpoint was overlooked when support for v3 endpoints was added in Synapse 1.48.0rc1. (#11451)

Bugfixes

• Fix using MSC2716 batch sending in combination with event persistence workers. Contributed by @tulir at Beeper. (#11220)
• Fix a long-standing bug where all requests that read events from the database could get stuck as a result of losing the database connection, properly this time. Also fix a race condition introduced in the previous insufficient fix in Synapse 1.47.0. (#11376)
• The /send_join response now includes the stable event field instead of the unstable field from MSC3083. (#11413)
• Fix a bug introduced in Synapse 1.47.0 where send_join could fail due to an outdated ijson version. (#11439, #11441, #11460)
• Fix a bug introduced in Synapse 1.36.0 which could cause problems fetching event-signing keys from trusted key servers. (#11440)
• Fix a bug introduced in Synapse 1.47.1 where the media repository would fail to work if the media store path contained any symbolic links. (#11446)
• Fix an LruCache corruption bug, introduced in Synapse 1.38.0, that would cause certain requests to fail until the next Synapse restart. (#11454)
• Fix a long-standing bug where invites from ignored users were included in incremental syncs. (#11511)
• Fix a regression in Synapse 1.48.0 where presence workers would not clear their presence updates over replication on shutdown. (#11518)
• Fix a regression in Synapse 1.48.0 where the module API's looping_background_call method would spam errors to the logs when given a non-async function. (#11524)

Updates to the Docker image

• Update Dockerfile-workers to healthcheck all workers in the container. (#11429)

Improved Documentation

• Update the media repository documentation. (#11415)
• Update section about backward extremities in the room DAG concepts doc to correct the misconception about backward extremities indicating whether we have fetched an events' prev_events. (#11469)

Internal Changes

• Add Final annotation to string constants in synapse.api.constants so that they get typed as Literals. (#11356)
• Add a check to ensure that users cannot start the Synapse master process when worker_app is set. (#11416)
• Add a note about postgres memory management and hugepages to postgres doc. (#11467)
• Add missing type hints to synapse.config module. (#11465)
• Add missing type hints to synapse.federation. (#11483)
• Add type annotations to tests.storage.test_appservice. (#11488, #11492)
• Add type annotations to some of the configuration surrounding refresh tokens. (#11428)
• Add type hints to synapse/tests/rest/admin. (#11501)
• Add type hints to storage classes. (#11411)
• Add wiki pages to documentation website. (#11402)
• Clean up tests.storage.test_main to remove use of legacy code. (#11493)
• Clean up tests.test_visibility to remove legacy code. (#11495)
• Convert status codes to HTTPStatus in synapse.rest.admin. (#11452, #11455)
• Extend the scripts-dev/sign_json script to support signing events. (#11486)
• Improve internal types in push code. (#11409)
• Improve type annotations in synapse.module_api. (#11029)
• Improve type hints for LruCache. (#11453)
• Preparation for database schema simplifications: disambiguate queries on state_key. (#11497)
• Refactor backfilled into specific behavior function arguments (_persist_events_and_state_updates and downstream calls). (#11417)
• Refactor get_version_string to fix-up types and duplicated code. (#11468)
• Refactor various parts of the /sync handler. (#11494, #11515)
• Remove unnecessary json.dumps from tests.rest.admin. (#11461)
• Save the OpenID Connect session ID on login. (#11482)
• Update and clean up recently ported documentation pages. (#11466)