← Back to all sparks
M

Matrix Bridge

COMMS
Velocity0.0

Framework for building Matrix application service bridges

A bridge library whose releases are mostly its dependencies moving underneath it.

matrixbridgessdkdependency-trackingspec-driven
Current state
matrix-appservice-bridge releases a few times a year, and the content is dominated by keeping in step with matrix-bot-sdk, the Node support matrix, and whatever Matrix spec proposals homeservers have started enforcing. The last two years produced one behavioural fix that bridge operators would notice — registration failing when MSC4190 is enabled — plus authenticated media support and a media endpoint correction.
Where it's heading
This is infrastructure code, and it behaves like it: no feature narrative, no roadmap visible in the changelog, just alignment work. What movement there is comes from the Matrix specification rather than the library — authenticated media and MSC4190 both arrived because homeservers changed, not because the bridge SDK set out to add something. Major version bumps here signal dropped Node versions rather than new capability.
Prediction
The next releases will most likely track matrix-bot-sdk versions and Node LTS transitions, with any user-visible change arriving as a response to a homeserver-side spec change rather than as new bridge functionality.

Recent moves

  1. 6mo ago

    CI moves to NPM Trusted Publishing

    A minor version whose only content is switching CI to NPM Trusted Publishing. Supply-chain hygiene for the publish step, invisible to anyone consuming the library.

    View source ↗
  2. 9mo ago

    Fixes user registration failures on MSC4190-enabled homeservers

    Fixes user registration failing with an appservice-login-unsupported error on homeservers that have MSC4190 enabled. One of the few changes in this window that bridge operators would actually have hit in production.

    View source ↗
  3. 11mo ago

    Drops Node 20 and 21, adds Node 22 and 24

    The major version bump exists to move the supported runtime: Node 20 and 21 dropped, 22 and 24 added, with matrix-bot-sdk and matrix-appservice updated alongside. Breaking for anyone pinned to an older Node, but no functional change.

    View source ↗
  4. 1y ago

    Restores device ID logging

    A patch correcting a logging regression in the underlying SDK where device IDs went unlogged. Diagnostic detail only.

    View source ↗
  5. 1y ago

    matrix-bot-sdk dependency bump

    A single matrix-bot-sdk version bump published as its own release. Typical of how this library moves between substantive changes.

    View source ↗
  6. 1y ago

    Fixes media uploads hitting the wrong endpoints

    Corrects media uploads hitting the wrong endpoints, shipped a day after authenticated media support landed. The pairing suggests the endpoint change was fallout from that work rather than an independent bug.

    View source ↗