2.0.0 (2024-04-08)

Note: This release drops support for Node 18. The minimum required version is now 20+.

Bugfixes

Fix Redis <=6.2 failing to clear the command queue in pooling mode. (#1763)
Fix GitHub CI docker builds failing for community PRs. (#1767)

Improved Documentation

Mention that the libera.chat bridge has since been shut down. (#1784)

Deprecations and Removals

Drop dynamicChannels.groupId config option. Groups were unstable and are no longer supported by any Matrix implementations. (#1772)

Internal Changes

Remove some build-time dependencies from the runtime dependency list. (#1758)
Add option to ignore "functional members" when checking if an admin room contains two users. (#1782)
Fixup types for Timers so the bridge works with newer node versions. (#1788)
Update dependencies. (#1798)
Add tests for various forms of rich replies. (#1799)

1.0.1 (2023-07-31)

It is strongly reccomended you upgrade your bridge, as this release contains security fixes.

🔒 Security

Fixes for GHSA-vc7j-h8xg-fv5x.
Fixes for GHSA-3pmj-jqqp-2mj3.
Fixes for GHSA-c7hh-3v6c-fj4q

Bugfixes

Improve processing speed of commands sent to and from the proxy when the bridge is configured in pooling mode. (#1751)
Ensure QUIT messages are always sent. (#1752)
Ensure we don't bloat irc supported state. (#1753)
Fix a case where the bridge would not listen for and apply bans for legacy/unspec'd m.room.rule.* types in use by Mjolnir. (#1755, #1759)
Refactor the command parser for admin and room commands, ensuring we correctly trim the command. (#1756)

Internal Changes

Update matrix-appservice-bridge to 9.0.1. (#1760)

1.0.0 (2023-06-09)

Note: This release drops support for Node 16. The minimum required version is now 18+.

Several changes were made since the previous RC, mostly fixes around our incoming connection pooling feature. The feature is still considered unstable for the time being, so please be careful when trying it out.

Features

New PM rooms are configured to disable calls, reactions, redactions, and stickers; as they could not be bridged anyway. (#1663)
The bridge now logs the user performing plumb/unplumb operations for easy auditing. (#1738)

Bugfixes

Fix the bridge pooling so it supports TLS. (#1709)
Fix setup widget failing to authenticate. (#1711)
Sort the list of channels in !listrooms output. (#1715)
Fix cases where the IRC bridge may erronously believe a user is not joined to a channel in pooling mode. (#1717)
Allow usernames to include more characters when using the !username command. (#1719)
Ensure that all passwords can be decrypted on startup, to detect any issues with the provided passkey. (#1720)
Fixes cases where powerlevel changes may not be correctly applied upon mode change. (#1732)
Fix a case where a proxied client connection may get missed until they use the bridge on startup, leading to missed messages and logspam. (#1737)

1.0.0-rc1 (2023-04-28)

Note: This release drops support for Node 16. The minimum required version is now 18+.

Features

IRC connections can now be run via an external process using "connection pooling", allowing the bridge to be restarted without IRC connection loss. (#1669)
Make bridgeInfoState configuration reloadable. (#1681)
Bridge logging can now be hot-reloaded. (#1704)

Bugfixes

Fix not handling thread fallbacks as replies. (#1697)
Show a helpful error for !link/!unlink admin failures, rather than "Check the logs for details", in more cases. (#1702)
Fix documentation not being built and uploaded to GitHub pages on release. (#1703)
Fix linking rooms from setup widget when a networkId is configured. (#1706)

Deprecations and Removals

Add support for Node 20, and drop support for Node 16. (#1701)

Internal Changes

Rename internal variable infoMapping to initialEvent. (#1672)

0.38.0 (2023-04-12)

Bugfixes

Fix leak of secret channels (name, topic, and member count) to the public room directory due to a regressive refactor in a previous release. (#1660, #1698)
Fix unlink command showing an error. (#1692)

Internal Changes

RoomAccessSyncer: Await processing of cached channel modes that changed. (#1620)
Fix tests when running with 'yarnpkg link matrix-appservice-bridge'. (#1679)
Add tests that cover publicity syncing behaviour. (#1698)

0.37.1 (2023-03-07)

Bugfixes

Fix provisioning API base URL in setup widgets. (#1677)

Internal Changes

Update matrix-appservice-bridge to 8.1.1. (#1676)

0.37.0 (2023-02-08)

Features

Add support for Node.JS 19. (#1646)
Refactor provisioning API to use matrix-appservice-bridge, adding support for OpenID token auth among other improvements. (#1655)
Add a UI in the form of a Matrix widget for linking and unlinking channels from a Matrix room. (#1656)

Bugfixes

Document 8090 to be the default port, to match the code's behaviour. (#1427)
Fix the configured bind port being overridden in Docker. (#1654)

Internal Changes

Update builder image for Freebind from Stretch (EOL) to Buster. (#1653)

0.36.0 (2022-10-25)

Features

Support monospace formatting. (#1555)

Bugfixes

Disable metrics by default. (#1596)
Fix distribution of IrcServer.randomDomain() which tended to pick domains with a lower index when there are a lot of addresses for a server. (#1612)
Prevent runtime errors by provisisioning a room with a specific roomID. (#1614)

Improved Documentation

Fix typos in the documentation. (#1599)
Update bridged networks doc to point towards GitHub issue #1483. (#1626)

Deprecations and Removals

Breaking change: Raises the required NodeJS version to 16. Fixes Room visibility setting being broken for appservice directories. (#1616)
User activity tracking is now disabled by default, unless userActivity is enabled in the config. (#1638)

Internal Changes

docker: prune dev dependencies from node_modules. (#1541)
Logging: Use Map instead of object. (#1608)
Refactor Logging: Increase explicit TypeScript types and safer loops. (#1609)
Refactors: Reduce use of Bluebird, increase explicit types, use safer loops. (#1611)
Replace uses of the deprecated String.prototype.substr(). (#1615)
Add support for running tests against a real IRCd and Matrix homeserver in CI. (#1622)
Update to matrix-appservice-bridge 6.0.0. (#1631)

0.35.1 (2022-09-26)

Bugfixes

Prevent possible attack by provisisioning a room with a specific roomID. (#1619)

0.35.0 (2022-09-13)

Features

Add new Debug API /warnReapUsers which allows bridges to send a warning to users when they are going to be idle reaped. (#1571)

Bugfixes

Truncated messages now default to wrapping URLs in angle brackets. (#1573)

Internal Changes

Include the bridge version and homeserver in the CTCP VERSION response body. (#1559)
BREAKING: Remove (IRC) as a default displayName suffix. (#1567)
Update CONTRIBUTING.md (#1570)
Add new CI workflow to check for signoffs. (#1585)
Strongly type emitted events from the IRC client. (#1604)

0.34.0 (2022-05-04)

This release fixes a High severity security vulnerability. See the matrix blog for more details.

Internal Changes

Updated node-irc to 1.2.1

0.33.1 (2022-03-30)

This release fixes a critical bug which would cause bans across the bridge when using the new ban list feature.

Bugfixes

Fix an issue where synchronising a ban list would cause all users to get banned. (#1551)

Deprecations and Removals

Remove several scripts in scripts/ which were unmaintained and obsolete. (#1531)

Internal Changes

Fix towncrier script for summarising the newsfiles. (#1549)

0.33.0 (2022-03-02)

No significant changes.

0.33.0-rc2 (2022-02-18)

Bugfixes

Fix a duplicate metric that would prevent the bridge from starting. (#1534)

0.33.0-rc1 (2022-02-17)

Features

Support splitting users from different homeservers into different IPv6 blocks. (#1514)
Added a new metric clientpool_by_homeserver which lists the states of IRC clients, by the top 25 homeservers. (#1517)
Add support for subscribing to moderation policy. See http://matrix-org.github.io/matrix-appservice-irc/administrators_guide.html#subscribing-to-moderation-policies for more information. (#1532)

Bugfixes

Matrix message edits no longer bridge as a diff if it's longer than the new message (#1477)

Improved Documentation

Update the list of bridged networks after hackint started offering a bridge once again. (#1501)
Removed freenode from bridged networks. (#1523)

Deprecations and Removals

The bridge will no longer treat invites without a is_direct: true as DM invites (and will henceforth reject group room invites). This may break some Matrix clients that do not supply this metadata when creating a room. (#1506)
Minimum required Node version is now 14. Users on Node 12 are advised to update to newer versions. (#1515)

Internal Changes

Check changelog.d entries in CI. (#1527)
Update various packages that were out of date. (#1530)

0.32.1 (2021-10-25)

Bugfixes

Fix a regression that prevented the bridge to run for multiple networks (#1491)

0.32.0 (2021-10-18)

No significant changes.

0.32.0-rc2 (2021-10-15)

Bugfixes

Fix an issue where the bridge would excessively log state event content (#1487)

0.32.0-rc1 (2021-10-08)

Features

Add optional bridge blocking upon exceeding a monthly active user limit (#1472)
Breaking: Upgrade to matrix-appservice-bridge 3.1.0.

This change removes the ruleFile option from the config, and replaces it with rules. See config.sample.yaml for an example. (#1485)

0.31.0 (2021-09-20)

Bugfixes

Fixed an issue where bridges using the NEdB datastore would still erroneously require IRC usernames to be unique. (#1471)
Fixed a bug where !help in an admin room would not show admin commands. (#1478)
Fix an edgecase where an nickname was not always set right for matrix users in PMs (#1479)

0.31.0-rc1 (2021-08-23)

Features

Render Matrix message edits as sed-like diff statements, falling back to asterisk formatted messages (#1465)

Bugfixes

Make sure we don't exceed the line limit when trimming long messages (#1459)
Make sure Matrix notice messages are also pastebinned when they exceed the line limit for IRC. (#1461)
Fallback to sending an invite as a bot if the regular invite fails (#1467)

Improved Documentation

Replace HOWTO.md with a link to our hosted documentation, and generally improve documentation wording. (#1458)

Internal Changes

Remove extra encodingFallback from sample config. (#1468)

0.30.0 (2021-08-18)

No significant changes.

0.30.0-rc1 (2021-08-17)

Features

Show message previews for uploaded long messages (#1430)
Export the ircClients.maxClients config value as a metric (bridge_remote_ghosts_max) (#1448)

Bugfixes

Make sure that admin commands that don't need a server (like !help) don't require it (#1433)
Remove client_config_domain_username_idx which would have required a unique username for IPv6 users. (#1455)

Improved Documentation

Expand documentation for irc_modes.md (#1429)
docs/usage.md: point to bridged networks in-tree (#1450)
Adding LibertaCasa to network bridges. Thanks @Mikaela. (#1454)

Internal Changes

Do not generate a unique username for users on a IPv6 bridge, as it's unnessacery. (#1446)
Docker images are now automatically build and published via GitHub Actions, replacing DockerHub Autobuilds. (#1456)

0.29.0 (2021-08-02)

Bugfixes

Add prometheus metrics for IRC connection times (#1442)

0.29.0-rc2 (2021-07-27)

Internal Changes

Update node-irc to 1.1.1 (see https://github.com/matrix-org/node-irc/blob/master/CHANGELOG.md) (#1434)

0.29.0-rc1 (2021-07-21)

Please note: 0.28.0(-rc1) is abandoned as more features became ready to ship before we reached the end of the release candidate stage. Users of 0.28.0-rc1 should upgrade to this release. Some changelog entries below will be duplicated from 0.28.0-rc1.

Features

Add prometheus metrics for IRC connection times (#1418)
Change the reply rendering to something more IRCish (and configurable) (#1424)
Truncate original messages more gently when replying (#1428)

Bugfixes

Require explicit server selection for !storepass when more than one possibility exists. This makes the command a bit more verbose, but avoids the situation where a password could've been accidentally specified for the wrong server. (#1363)
Fix an issue where a hot reload would fail if advanced was not defined in the original config. (#1383)
Update matrix-org-irc to 1.0.0 to fix a bug where the bridge can crash. (#1388)
Fix an issue where a Matrix user's IRC connection is stuck and unable to join some channels. (#1394)
Fix multiline replies having only one line sent to IRC (#1425)
Ensure the irc_connection_time_ms histrogram metric uses sensible bucket sizes. (#1426)

Improved Documentation

Fix typo regarding examples of hostname and port in Bridge Setup documentation (4. Registration) (#1405)
Migrate the list of bridged IRC networks from the deprecated github wiki to the hosted documentation (https://matrix-org.github.io/matrix-appservice-irc/latest/). Add libera.chat to the list. (#1416)
The Debug API is now documented in the hosted documentation, replacing the wiki page. (#1420)

Internal Changes

Handle known error-codes when OPER command fails instead of disconnecting. (#1385)
Add a link referring to the in-tree documentation to the admin room help text. (#1402)
Add linting for test files (#1403)
Fix a bug where messages from IRC would be blocked by the privacy filter when allowUnconnectedMatrixUsers set to true in a room config event. (#1406)

0.28.0-rc1 (2021-07-19)

Features

Add Prometheus metrics for IRC connection times (#1418)

Bugfixes

Fix an issue where a hot reload would fail if advanced was not defined in the original config. (#1383)
Update matrix-org-irc to 1.0.0 to fix a bug where the bridge can crash. (#1388)
Fix an issue where a Matrix user's IRC connection is stuck and unable to join some channels. (#1394)

Improved Documentation

Migrate the list of bridged IRC networks from the deprecated GitHub wiki to the hosted documentation (https://matrix-org.github.io/matrix-appservice-irc/latest/). Add libera.chat to the list. (#1416)

Internal Changes

Handle known error-codes when OPER command fails instead of disconnecting. (#1385)
Add a link referring to the in-tree documentation to the admin room help text. (#1402)
Fix a bug where messages from IRC would be blocked by the privacy filter when allowUnconnectedMatrixUsers set to true in a room config event. (#1406)

0.27.0 (2021-06-16)

Bugfixes

Fix an issue where a hot reload would fail if advanced was not defined in the original config. (#1383)
Update matrix-org-irc to 1.0.0 to fix a bug where the bridge can crash. (#1388)
Fix an issue where a Matrix user's IRC connection is stuck and unable to join some channels. (#1394)

Internal Changes

Handle known error-codes when OPER command fails instead of disconnecting. (#1385)

0.27.0-rc3 (2021-06-11)

Bugfixes

Update matrix-org-irc to 1.0.0 to fix a bug where the bridge can crash. (#1388)

0.27.0-rc2 (2021-06-10)

Bugfixes

Fix an issue introduced in 0.27.0-rc1 where the SSL option would not work without also providing a tlsOptions value. (#1384)

0.27.0-rc1 (2021-06-10)

This release contains many more changes and features than normal, so please be extra careful when testing this RC and please report any issues to us as always.

Features

Add support for setting a username, and reconnecting through the admin room. This change also changes !storepass to no longer reconnect you by default. (#1331)
Add requireMatrixJoined membership option to block IRC messages until all Matrix users are joined to the channel. (#1337)
Add config option useHomeserverDirectory to allow rooms to be published to the homeserver room directory, rather than just the appservice directory. (#1344)
Add tlsOptions key to the config to override the IRC connection parameters. (#1375)
Allow only using the additionalAddresses field when connecting to IRC. (#1376)

Bugfixes

Detect IRC username mentions bounded by ',<,> or & (#1303)
Comment out permissions from the sample config. (#1315)
Fix an issue where invites to DM rooms are not marked as direct message invites. (#1329)
Validate that the nickname is provided to !irc nick before trying to change nick. (#1330)
Fix "CLI undefined" being spit out from cli on generic errors (#1333)
Fix an issue where the IRC username was incorrectly required to be 10 characters or less. (#1345)
Update a number of packages to latest versions, including matrix-appservice-bridge@2.6.1 containing a security fix. (#1365)
Fix zero width spaces (ZWSPs) being filtered out of messages from IRC. (#1366)
Admin rooms are now correctly created as DMs, and only one will be created per-user. (#1372)
Fix the bridge never syncing membership if it cannot get the joined users for a room on startup. (#1373)
Do not attempt to fetch per-room config for a PM. (#1379)
Fix a bug where the bridge user would rejoin shortly after unbridging a room. (#1382)

Improved Documentation

Document release process in CONTRIBUTING.md (#1308)
Update documentation for SASL support, and safety net features. (#1352)

Internal Changes

Use latest version of matrix-org/node-irc which was rewritten in Typescript. (#1319)
Fix validation of the config to allow for a single hash in the alias template. (#1339)
Improve blocked room feature (such as kicking users who cannot get connected to the channel), and add metrics to track. (#1369)
Show an error in the PM room when the IRC user has blocked unregistered users from messaging. (#1380)
Add headers to the admin room help text. (#1381)

0.26.1 (2021-06-03)

This update features a security fix for a bug in matrix-appservice-bridge. Server administrators are encouraged to update the bridge. See https://github.com/matrix-org/matrix-appservice-bridge/releases/tag/2.6.1 for details. If you have any questions, please contact security@matrix.org.

Bugfixes

Update a number of packages to latest versions, including matrix-appservice-bridge@2.6.1 containing a security fix. (#1365)

0.26.0 (2021-05-13)

No significant changes.

0.26.0-rc2 (2021-05-10)

Internal Changes

For NPM 7 to properly fetch the irc dependency, we switch to a git+https:// url. Before it defaulted to SSH which needs some authentication. (#1311)

0.26.0-rc1 (2021-05-07)

Features

Allow changing nickname in any room (#1217)
The bridge will now retry creating a room for a PM if the initial attempt fails. (#1282)
Decouple invite from the creation of a PM room (#1290)
Add new kickOn config option to disable kicking Matrix users under certain conditions (#1294)
Added an !unlink command for Matrix users to unbridge a channel from Matrix (#1298)
Add support for specifying the paste bin limit in room state with the org.matrix.appservice-irc.config event type. (#1301)

Bugfixes

[M->I]: Trim Markdown code block syntax (#1275)

Internal Changes

Doc changes: Unify use of port 9999, the registration file name, and other minor changes (#1274)
Fixed a bug where our linter would miss several files (#1288)
Fix linter warnings (#1289)
Docker image: Upgrade to NodeJS 14 (#1299)
Add GitHub action to push documentation upon release (#1306)

0.25.0 (2021-03-16)

No significant changes.

0.25.0-rc1 (2021-03-05)

Bugfixes

MXC urls are now properly URL encoded when sent to IRC. (#1237)
Fixed an issue where users would not be rejoined to some channels on reconnect if they failed to rejoin any channel. (#1255)
Fix an issue where IRC membership would not be bridged to new rooms when botConfig.enabled is true. (#1256)
Update powerlevels immediately when unbridging to avoid rejoining the bridge bot to the room. (#1257)
Fix Docker start.sh script to use port 9999 instead of 9995 (#1259)
Fix invalid JSON schema for ircService.permissions (#1261)

Improved Documentation

Add new bridge documentation under /docs. This can be viewed by visiting https://matrix-org.github.io/matrix-appservice-irc/ (#1235)
Add documentation on IRC bridge mode handling. (#1251)

Internal Changes

Leave DM rooms and admin rooms if the Matrix user leaves so that a homeserver may clear them up later. (#1258)
Update to matrix-appservice-bridge 2.6.0-rc1 and use it's implementation of the BridgeInfoStateSyncer (#1262)

0.24.0 (2021-02-12)

No significant changes.

0.24.0-rc1 (2021-02-02)

Features

Warn Matrix users if they are unable to speak in a channel. (#1204)
Add !plumb admin command to bridge rooms (#1211)
Use replies when responding to admin commands. (#1215)
Add ircClients.realnameFormat option in the config to show mxid in reverse in the realname field of IRC clients. (#1229)
Add pingTimeoutMs and pingRateMs as options to the config (#1232)

Bugfixes

Fix potential error when using killUser debug endpoint (#1206)
Fix an issue that would cause !bridgeversion to report Unknown when running inside a Docker container. (#1212)
Fix an issue where the QuitDebouncer would reprocess old QUITs, and process QUITs too early during the debouncing process. (#1228, #1230, #1231)

Internal Changes

Update matrix-appservice-bridge to 2.5.0-rc1 (#1233)

0.23.0 (2020-12-01)

No significant changes.

0.23.0-rc1 (2020-11-24)

Features

Add membership queue Prometheus metrics under the prefix bridge_membershipqueue_. (#1185)
Fix a performance issue where many mode changes in quick succession for a channel would cause many m.room.power_level events to be created. (#1186)
When multiple users leave the room at the same time, batch together powerlevel removals (#1196)

Bugfixes

Reduce verbosity of some log lines from INFO to DEBUG (#1168)
Drop IRC messages directed towards invalid nicks early. (#1189)
Improve the performance of sending messages by speeding up some function calls (#1192)

Internal Changes

Improve the handling speed of IRC joins. (#1187)

0.22.0 (2020-11-06)

No significant changes.

0.22.0-rc1 (2020-10-28)

Breaking Change: We've renamed the /killPortal DebugAPI endpoint to /killRoom, and it will now unbridge all types of rooms rather than just portal rooms.

Features

Pre-emptively ignore users who are already idle when starting up the bridge (#1156)
Propagate a reason all the way through killing the bridge (#1159)
Add startup check to ensure the homeserver can send the bridge events. (#1160)
Replace /killPortal debug API with /killRoom API, which works for all bridge mapping types (#1169)

Bugfixes

Don't wait for leaves to complete when running the reaping script (#1147)
Fix bug where m.audio files would not be forwarded to IRC (#1150)
Do not change a Matrix user's IRC nickname unless their profile has also changed (#1157)
Fixed an issue where the bridge would kick users from rooms they never joined (#1165)

Internal Changes

Determine user activeness based off presence, typing and read receipts when kicking idle users. (#1152)
Bridge IRC reasons when users QUIT or PART (#1161)
Remove hacks around reconnections on startup (#1162)

0.21.0 (2020-10-15)

No significant changes.

0.21.0-rc3 (2020-10-13)

Features

Add support for reconfiguring the bridge at runtime by sending a SIGHUP (#1145)

Bugfixes

Fix a bug where the bridge would leave a user after joining (#1143)
Fix more cases of double bridged users (#1146)
Fix a bug where a user leaving with a reason would cause them to join then leave (#1151)

Internal Changes

Add index to client_config for config->>username to speed up username lookups (#1148)

0.21.0-rc2 (2020-10-13)

Features

Add support for reconfiguring the bridge at runtime by sending a SIGHUP (#1145)

Bugfixes

Fix a bug where the bridge would leave a user after joining (#1143)
Fix more cases of double bridged users (#1146)
Fix a bug where a user leaving with a reason would cause them to join then leave (#1151)

Internal Changes

Add index to client_config for config->>username to speed up username lookups (#1148)

0.21.0-rc2 (2020-10-09)

Bugfixes

Fix a bug where the bridge would leave a user after joining (#1143)

0.21.0-rc1 (2020-10-07)

Features

Implement mechanisms to fix powerlevels in rooms if messages fail to bridge (#1054)

Bugfixes

Fix a bug where connection reaping would not work sometimes if the bridge could not use the synapse whois admin endpoint (#1131)
Fixes Matrix displayName not being updated properly. Thanks to @BernardZhao (#1137)

Internal Changes

Use types from matrix-appservice-bridge rather than local definitions. (#1101)
Fix attribution link in CONTRIBUTING.md (#1132)
The deprecated remove-idle-users.py has been removed. Bridge admins should use the /reapUsers Debug API endpoint instead (#1139)

0.20.2 (2020-08-21)

Features

Add Grafana dashboard sample (#1122)

Bugfixes

Reconnect to the correct domain on passsword changes. Thanks to @palmer-dabbelt (#1000)
Improve performance of generating a username (#1121)

0.20.1 (2020-08-17)

There were enough changes during the RC period to warrant a new release, so 0.20.0 was dropped in favour of 0.20.1.

Features

The quit debouncer has been rewritten to be more performant, dropping QUITs entirely until the bridge is able to cope with them. (#1091)
Track connection state in metrics (#1110)

Bugfixes

Fix metrics worker dying and crashing after high load (#1109)
Speed up operations on the publicity syncer for IRC -> Matrix (#1111)
Fix issue where all irc bridged rooms would be marked as public (#1113)
Allow nicknames to start with a special character or number according to RFC 2812 § 2.3.1 (#1114)

Internal Changes

Improve logging around ClientPool (#1112)

0.20.0-rc2 (2020-08-12)

Features

Add metrics for tracking user activeness for matrix and irc users (#1105)

Bugfixes

Fix issue where /metrics would respond with no data (#1107)

0.20.0-rc1 (2020-08-11)

Features

Media URLs now include the filename when sent to IRC. (#1087)

Bugfixes

Fix duplicate messages appearing if an IRC message is poorly decoded. (#1081)
Make sure a killed BridgedClient is dead, even if connect was never called (#1098)

Internal Changes

Enable many recommended ESLint rules to catch errors (#1078)
Replace .indexOf with more specific methods (#1097)

0.19.0 (2020-07-06)

No significant changes.

0.19.0-rc2 (2020-06-29)

Features

Add bridge_app_version metric to report the bridge version. (#1071)

Bugfixes

Fix issue where some metrics would not be reported, and a bug in inspectUsers which would return an empty list. (#1075)

Internal Changes

Refactor room creation code to use one function for tracking and creation of rooms (#1074)
Code improvements: Simplify use of Map and RegEx methods (#1076)

0.19.0-rc1 (2020-06-26)

0.19 introduces a minimum reqirement of NodeJS 12.x

Features

Split out metrics endpoint to a seperate worker (#1069)
Add ability to limit the number of kicked users, and order by inactive time when using the reapUsers Debug API command. (#1072)

Internal Changes

BREAKING CHANGE: The bridge now requires a minimum of NodeJS v12.x (#1070)

0.18.0 (2020-06-26)

No significant changes.

0.18.0-rc1 (2020-06-22)

Bugfixes

Update pg dependency to 8.1.0 to fix NodeJS 14 compatibility. Be aware that this means that unauthorized SSL connections are now rejected as of pg@8.0.0 (#1050)
Fixed a crash related to an invalid ctcp-version request (#1053)
Add ability to limit the number of rooms that an instance can be bridged. (#1060)
Fixed issue where setting initial sync to true for membershipLists.room entries would not work if syncing is off globally. (#1065)

Improved Documentation

Corrects tutorial port numbers for docker so that copying/pasting will properly run with default port numbers. (#1048)

Internal Changes

Update sanitizeHtml package. (#1066)

0.17.1 (2020-05-06)

Features

Add ability to set fallback text encoding for non-UTF-8 messages. (#580)

Bugfixes

Fixed an issue where installing the bridge from NPM would cause tsc to fail and the operation would fail. (#1045)
Ensure we don't kick the bot user on connectionReap (#1046)

Internal Changes

Use prepare rather than prepublish in package.json (#1047)

0.17.0 (2020-05-01)

No changes since 0.17.0-rc4

0.17.0-rc4 (2020-04-29)

Bugfixes

Will no longer try retry a kick for connection failure if the bot lacks permission (#1040)

Internal Changes

Update matrix-appservice-bridge to 1.12.2 to fix a header bug (#1036)

0.17.0-rc3 (2020-04-17)

Bugfixes

SECURITY FIX The bridge now authenticatess the /_matrix/provision set of endpoints. It now requires either a access_token query parameter or a Authorization header containing the hs_token provided in the registration file. (#1035)

Internal Changes

Simplify ClientPool logic using Maps (#1034)

0.17.0-rc2 (2020-04-15)

Bugfixes

Ensure err.args is defined when checking errors in ConnectionInstance (#1030)

0.17.0-rc1 (2020-04-09)

Features

On name change, inform Matrix users, if their preferred IRC name is taken (#1018)
Add ability to deactivate users permanently via the DebugAPI. (#1021)

Bugfixes

Disconnect a PM room from IRC when another user is invited, and disallow invites to PM rooms. (#1010)
Fix issue where users with stored passwords but no config settings (IPv6 address, nickname) would not be able to get connected. Fixes #1014. (#1015)
Kick users who have been X:lined (#1023)
Fix issue where users who used !storepass are never reconnected and cannot send messages through the bridge. (#1024)

Improved Documentation

Add instructions for registering IRC bot's nickname. Thanks to @DylanVanAssche (#1004)
Improve documentation for changelog entries (#1020)

Internal Changes

Replace deprecated new Buffer("a") (#1019)
Test !nick when the user already has the nick (#1020)
Update dependencies to fix vulnerabilities. (#1025)

0.16.0 (2020-03-03)

Features

Kicks from one IRC user to another will now be shown as kicks on Matrix. (#994)

Bugfixes

Fix issue where bridged channel(s) would not be carried across on room upgrade. (#989)
IRC users will now join the new room on a room upgrade (#993)
Fix a bug where users with high numbers of channels would flood the ircd and be stuck trying to connect forever. (#995)
Matrix users who change nicks will no longer cause ghosts to appear in rooms with their new nick. (#996)
Fix bug where failing to start the bridge would not report any useful information (#997)
Fix missing logline arguments for BridgedClient (#1004)

Internal Changes

Add scripts/changelog-check.sh and scripts/changelog-release.sh (#990)
Add .npmignore (#991)
Ensure the room upgrades test passes with Postgres (#992)
Upgrade winston logging library to 3.2.1 (#1002)

0.15.2 (2020-02-13)

Features

The bridge will now notify you if a DM recipient is offline. (#978)

Bugfixes

Fix "User did not rejoin" error when bridge debounces QUITs (#977)
Fix an issue where users were not rejoined to channels on netsplit/password change. (#979)

0.15.1 (2020-02-06)

Bugfixes

Fix an issue where legacy mappings would cause the bridge to not start. (#971)

0.15.0 (2020-02-05)

Features

Breaking Change - Static mappings can now set a channel key:
- This changes the config schema, even if you do not make use of this feature. You MUST update your existing mappings to use the new roomIds:
```
old:
  mappings:
    "#thepub": ["!kieouiJuedJoxtVdaG:localhost"]

new:
  mappings:
    "#thepub":
      roomIds: ["!kieouiJuedJoxtVdaG:localhost"]
```
- The key is automatically used to join Matrix users to the mapped channel. They do not need to know the key. For example, you can bridge password-protected IRC channels to invite-only Matrix rooms:
```
mappings:
  "#viplounge":
    roomIds: ["!xKtieojhareASOokdc:localhost"]
    key: "vip-pass"
``` ([\#591](https://github.com/matrix-org/matrix-appservice-irc/issues/591))
```
Add 'defaultOnline' and 'excludeRegex' parameters to /reapUsers. (#930)
Add support for MSC2346; adding information about the bridged channel into room state. (#941)
Added !listrooms command to list which channels you are connected to. (#965)

Bugfixes

Fix issue where bridges using NeDB would not start. (#955)
Substitute $SERVER in ircService.servers.*.dynamicChannels.aliasTemplate when generating a room alias from channel (fixes thirdparty lookups and joining by IRC channel name from Riot). (#958)
Fix an issue where the postgres migration script does not translate '_' => '.' (#962)
Fix issue where migrating users from NeDB to Postgres would fail if they had a password. (#968)
Fix bug where users would not be able to join a channel via !join. (#970)

Deprecations and Removals

Removed upgrade-db-0.*.js scripts which were used to upgrade old versions of the NeDB database. If you are upgrading from <=0.9.1 then you can find the upgrade scripts here. (#947)
Remove statsd support as per #818 (#949)
Remove githooks, since they are unused. (#951)

Internal Changes

Queue more membership operations inside a retry queue (#932)
Queue IRC messages inbound to Matrix for a maximum of 5 seconds. (#953)

0.14.1 (2020-01-21)

Bugfixes

Fix issue where bridges using NeDB would not start. (#955)

0.14.0 (2020-01-20)

Bugfixes

If a new DM room is created for a IRC user, discard the old room. (#919)
Fix missig config.schema.yml in the Docker image (#920)
Stop trying to use sentry when config.sentry.enabled is false (#921)
Improve reply matching logic for Matrix messages. (#925)

Internal Changes

Use Typescript 3.7 and fix build issues. (#931)

0.14.0-rc4 (2019-12-18)

Bugfixes

Massively speed up connection reaper by not syncing all rooms (#914)
Tweak DB migration script to handle duplicate PMs and DB inconsistencies (#917)
Handle replies that contain a displayname rather than a userid. (#918)

0.14.0-rc3 (2019-12-06)

Features

Maximum AS transaction size has been raised from 5MB to 10MB. You may also now specify this limit in the config. (#907)

0.14.0-rc2 (2019-12-05)

Internal Changes

Ensure that joins and leaves are performed linearly per-room. (#905)

0.14.0-rc1 (2019-11-29)

Features

The project now uses Typescript for it's source code. (#808)
Add support for PostgreSQL (#815)
Add migration script for migrating NeDB databases to PostgreSQL. (#816)
Add config option excludedUsers to exclude users from bridging by regex. (#820)
Support room upgrades on PostgreSQL. (#824)
Delay ident responses until pending clients have connected. Thanks to @heftig for the initial PR. (#825)
Allow admins to specify a bind port and/or hostname in the config. (#857)
When !storepass is called, reconnect the user to ensure the password is set. (#864)
Track last seen times of users between restarts (#876)
Add dry run mode to the debugApi /reapUsers command. (#879)
The bridge now supports error tracing via sentry (#897)

Bugfixes

Inviting the bridge bot to an existing bridged room will no longer cause the room to be bridged as an admin room. Invites must also use is_direct. (#846)
Fix counter for leaving users. (#855)
Replace calls to /state with more efficient calls, where possible. (#865)
Topic changes from Matrix no longer cause a ghost user to join the room. (#866)
Ensure bot clients stay connected after being disconnected. (#867)
Fix issue where the internal ipv6 counter would not be correctly set (#873)
Fix bug where users could not store or remove their password (#874)
Fix a bug where users could not generate registration files (#875)
Fix uploaded long message URL's not sent to IRC side. (#889)
Debug API is now correctly enabled on startup (#893)
Quit the app with exitcode 1 if it fails to start (#894)
The !storepass command now reconnects users with their new password. (#900)

Deprecations and Removals

Statsd is deprecated in this release, and will be removed in the next. Users are encouraged to use prometheus instead, which has richer logging capabilites. (#837)
Remove warnings/hacks around config.appservice. Users should have upgraded to the new format by now. (#849)

Internal Changes

Refactor Datastore for Typescript (#809)
Add linting support for Typescript files. (#810)
Fatal exceptions are now logged to stdout in addition to logs. (#812)
Refactor Datastore code to be more generic. (#814)
Move schema.yml from /lib/config to / (#819)
Use Towncrier for changelog management (#821)
Internal conversions of model classes to Typescript (#822)
Convert ClientPool and associated dependencies to Typescript (#826)
Convert logging to Typescript (#827)
Convert DebugApi to Typescript (#829)
Typescriptify QuitDebouncer (#830)
Typescriptify BridgedClient and dependencies (#831)
Convert generator and formatter functions to Typescript (#832)
Typescriptify IrcEventBroker (#833)
Use seperate DBs for each integration test. (#834)
Typescriptify IrcBridge (#836)
Typescriptify irc syncer classes (#839)
Do not call keepalive() callbacks if the user doesn't need to be kept alive. (#844)
Typescriptify matrix handler class (#845)
Remove crc and prom-client packages. (#846)
Swap to using promises over timers for queuing messages on IRC connections. (#848)
Typescriptify irc handler class (#850)
Updates to Dockerfile to add multiple stages and support Typescript (#853)
Rewrite provisioner/* in Typescript (#861)
Refactor bot command handling into own class. (#863)
Move some IRC specific functions from IrcBridge to ClientPool (#877)
Use the DB to prefill some membership caches, reducing the number of HTTP calls made and speeding up bridge startup. (#881)
Room directory visibility state for bridged rooms is now cached in the database (#882)
Gracefully close irc connections on SIGTERM (#895)
Log when a newly discovered irc user's profile is updated. (#896)

Changes in 0.13.1 (2019-11-07)

Pin node-irc dependency to avoid new changes bleeding into old releases.

Changes in 0.13.0 (2019-09-25)

Fatal logging will now emit to stdout directly first, and exit with a unique error code #812

Changes in 0.13.0-rc2 (2019-09-11)

Users who are banned from an IRC network must be QUIT locally #790
Pending nicknames should be stored before they are confirmed to help dedupe #796
Clarify storepass response #799. Thanks @auscompgeek
Fix issue where room upgrades would not upgrade the room entry ID #797

Changes in 0.13.0-rc1 (2019-08-06)

NOTE: This release requires Node.js 10 or greater.

Require Node 10 (and use Buildkite for CI) #764
Handle PARTs for Matrix users #754
Configurable room versions #763
Passwords stored by the bridge can now contain spaces #738. Thanks @14mRh14mRh4X0r!
Audit packages and update for security #779
Fix call to _incrementMetric #780
Disable escaping of userids for now #768
Reduce memory consumption of tests #766
Add a debug API endpoint to quit users who have been idle for a while #772
DebugApi endpoint to inspect connected users #781
Refactor powerlevel (mode) handling #785
Bump appservice sdk version #788

Please also note that CONTRIBUTING.md has been updated with new guidelines.

Changes in 0.12.0 (2019-06-06)

No changes since previous RC, see below for full list of changes

Changes in 0.12.0-rc2 (2019-03-18)

Fix issue where the bridge would conflict with other bridges when transforming a nick into a user id

Changes in 0.12.0-rc1 (2019-03-15)

The bridge now supports upgrading rooms, and will follow room upgrades to the new room.
Added support for the RoomLinkValidator, which allows admins to manually configure rules about plumbing rooms.
A dockerfile is now included.
Add support for "feature flags", allowing users to dynamically enable/disable bridge features for their account.
Add command "!bridgeversion"

Changes in 0.11.2 (2018-10-05)

Fixed bugs where a user may issue a !quit and break metrics reporting for a bridge.
Added a config option 'advanced.maxHttpSockets' to allow you to increase the limit for high traffic bridges.

Changes in 0.11.1 (2018-08-30)

Bumped matrix-appservice-bridge to 1.6.1
Fixed a bug where metrics would crash after the first scrape with remote user reporting option set

Changes in 0.11.0 (2018-08-28)

No changes since previous RC, see below for full list of changes

Changes in 0.11.0-rc4 (2018-08-24)

Bug Fixes:

Fixed a bug where content of events the bridge hadn't cached were not being used in replies.

Changes in 0.11.0-rc3 (2018-08-24)

The bridge now depends on matrix-appservice-bridge 1.6.0c

Bug Fixes:

We were calling authedRequest but the request was not mocked out.

Changes in 0.11.0-rc2 (2018-08-24)

The bridge now depends on matrix-appservice-bridge 1.6.0b

Bug Fixes:

There was a bug involving intents in m-a-b so it was bumped

Changes in 0.11.0-rc1 (2018-08-23)

The bridge now depends on matrix-appservice-bridge 1.6.0a

New features & improvements:

Cache modes internally #630
Replace nicks with user pill mentions #650 #658
Kick users if we fail to create an IRC client for them on join (aka ILINE kicks) #639
SASL support #643
Add err_nononreg so we can announce PMs that failed #645
Formatting of replies #647

Bug Fixes:

Fix invalidchar nick #655
Don't answer any msgtypes other than text in an admin room. #642
Fix provisoner leaving users on unlink #649

Metrics:

Metrics for MatrixHandler - Iline Kicks #644
Idle connection metrics #651
QueuePool.waitingItems should use it's internal queue size #656

Misc:

Section out tests, linting and coverage into seperate stages for Travis #657

Changes in 0.10.1 (2018-07-30)

Missed a few changes from master

Changes in 0.10.0 (2018-07-30)

No changes since rc1

Changes in 0.10.0-rc1 (2018-07-25)

The bridge now depends on matrix-appservice-bridge 1.5.0a

New features & improvements:

Migrate to ESLint 4. Thanks Aidan Gauland
Don't rejoin virtual users we know are in the room.
Added unbridging API for bridge operators to unbridge portal rooms.
Add option to allow expired certificates.
Add option to show group flare in new portal rooms.
Joins are now (optionally) retried when they fail on I->M.
No more warnings about rawResponse when uploading media.
Add option to disable presence.

Changes in 0.9.1 (2018-07-12)

Some changes were not included in 0.9.0 and have now been included in this release:

Don't rejoin mapped rooms #594
Announce and leave DM rooms if we don't support it #600

Changes in 0.9.0 (2018-07-02)

No changes since 0.9.0-rc1

Changes in 0.9.0-rc1 (2018-06-29)

BREAKING CHANGES:

The bridge now requires a minimum of Node 6.

New features & improvements:

Breaking Change - Minimum supported version is now Node 6.X #589
Updated winston logger dependency to 2.4.2 #587
Refined colours to match mIRC colours - #483 Thanks @silkeh
Displayname changes now appear as nick changes - #486 Thanks @silkeh
New migrate-users script to remove suffixes from displaynames - #495 Thanks @SohumB
Rewritten IRC to HTML parsing - #485 Thanks @silkeh
Add m.audio as a valid file type - #504 Thanks @t3chguy
Don't rejoin mapped rooms #594
Announce and leave DM rooms if we don't support it #600

Changes in 0.8.0 (2017-07-26)

BREAKING CHANGES:

Logs are now rotated based on time rather than size. maxFileSizeBytes has been removed from the configuration file.

New features:

The bridge will now mirror IRC chanops to Matrix, so Matrix users can see who is a chanop.
The bridge will now handle +m (moderated) channels by setting the events_default value to 1 when +m is set. Only Matrix users with a power level >0 can send events in this room whilst this is set.

The debug API has been expanded to include /killUser which accepts a JSON object like:

{
  "user_id": "@usertoremove:localhost",
  "reason": "reason in quit message and kick message"
}

Improvements:

Reduced CPU and memory usage during normal operation. The bridge will now share internal data structures for representing Matrix rooms. Previously, each user in a room would have its own copy of the Matrix room which would need to be updated for power levels / membership changes N times (where N is the number of bridged users in the room). This now only needs to be updated once.

The format for uploaded content has changed to: (thanks @t3chguy!)

Person has uploaded an image: filename.gif (55KB) <https://homeserver/_matrix/media/v1/download/foo/bar>

The bridge will now respond to CTCP VERSION with: (thanks @t3chguy!)
```
matrix-appservice-irc, part of the Matrix.org Network
```
The ident server can now bind to any address via the config option ident.address. Thanks @silkeh!
The ident server will now respond with the formal syntax in RFC1413. Thanks @silkeh!
The bridge will now set protocols: ["irc"] in the generated registration file. Thanks @ansiwen!

Bug fixes:

dropMatrixMessagesAfterSecs now re-checks the time just prior to sending to IRC. Previously, it was possible for events to arrive a few seconds before the cut-off period and then take minutes to be processed in the bridge, resulting in the message being sent after the cut-off period.
The unbridge.js script has been fixed when not sending a message. Thanks @aperezdc!
Pastebinned long messages are now uploaded with UTF8 encoding.
The bridge will now wait between reconnection attempts for a given client. Previously, a bug would cause it to tight-loop trying to reconnect.
Fixed an issue which could cause an IRC message to make the bridge tight-loop.
Capped the depth value when introspecting clients in the debug API. Long-running bridges could cause this to error out as idle timers exceeded the stack depth.

Changes in 0.7.2 (2017-04-05)

New features:

Invites from IRC are now forwarded to Matrix. (Thanks @erdnaxeli!)

Improvements:

There have been substantial improvements to CPU usage at both startup and normal usage.
There have been substantial improvements to RAM usage at both startup and normal usage.
Initial Matrix-to-IRC membership list syncing times have been reduced.
Trying to join a +r channel will now result in being kicked from the corresponding Matrix room.
The config option userModes is no longer applied to the bridge bot. This allows provisioning requests to continue whilst still having PM guards enabled.
Additional IRC domains can now be added. This allows more randomisation than DNS lookups alone. See config,sample.yaml.
An HTTP(S) socket limit of 1000 has been added to prevent slow Synapse servers from causing the bridge to consume thousands of FDs.
Logging has become less verbose and more informative.
Metrics will now monitor the number of dropped requests due to dropMatrixMessagesAfterSecs.

Bug fixes:

Fixed a bug which caused IPv6 DNS rotations to not be honoured when using TLS.
Fixed a bug in node-irc which caused modePowerMap to not work correctly.
Fixed a race condition when creating a dynamic channel which is +i, which could cause the resulting Matrix room to not be invite-only.
Fixed a race condition which could cause M->I join events to fail if the connection was not yet established.
Fixed a bug which caused new public channels which were +s to be published to the global directory listing.

Changes in 0.7.1 (2017-01-18)

Scripts:

Added a script which allows bridge operators to remove idle Matrix users from bridged rooms.

New features:

IRC operator levels (voice/op/etc) can now be automatically mapped to corresponding Matrix power levels. This mapping is imperfect, but can be used as a coarse guideline for users who want to set room names/topics/etc on Matrix without having to go via the Provisioning API or asking the IRC bridge administrator. See config.sample.yaml.
!whois can now additionally be called with a Matrix user ID which will return the nick of that user ID on the IRC network.

Improvements:

Changed the text which is sent when a file/image/video/long text is sent from Matrix to IRC.
Concurrently perform /joined_members HTTP calls on startup to speed up the process of gathering Matrix users to connect to IRC.
Redo the !help message.
Reduce the amount of debug logging. Redo some log messages to be more informative.
IPv6 connections can now be force-enabled without the need for an IPv6 prefix by the ipv6.only flag in the config file. (Thanks Oleg Girko ol@infoserver.lv)

Bug fixes:

Fixed multiple bugs which could cause specific IRC users in specific rooms to not be bridged through to Matrix.
Fixed a bug when formatting IRC codes to HTML which would incorrectly treat bold/italics/underline as "enabled" flags rather than "toggle" flags. Previously, the text hello 0x20x2 world would incorrectly boldify "world" instead of toggling bold on and off again.
Fixed a bug which caused TLS connections over IPv6 to not use DNS rotation.

Changes in 0.7.0 (2016-12-19)

BREAKING CHANGES:

The appService config value which was deprecated in 0.3.0 has now been removed.
This version of the IRC bridge requires Synapse v0.18.5-rc3 or above.
Statsd metrics are now deprecated and will be removed in a future release.

Scripts:

A script to grant increased power level to a Matrix user in a dynamically bridged IRC room has been added.
A script to remove a user from all known bridged IRC rooms has been added.

New features:

Storing IRC Passwords:
- Matrix users can now specify a server password to authenticate with the IRC server on startup. On most IRC servers, this is an alternative mechanism to authenticate with NickServ.
- To enable this functionality in the bridge, a private key needs to be generated. Passwords are stored encrypted at rest.
- WARNING: the bridge is forced to send plaintext passwords to IRC, not the hash of passwords. Matrix users are trusting the bridge with their actual, plaintext, non-hashed password.
- Sending !storepass [server.name] to the admin room will encrypt and store a password for a Matrix user.
- Sending !removepass [server.name] to the admin room will remove the encrypted password that the user has set from the database.
Default user modes:
- The default user modes for every Matrix user's IRC client can now be set in the config via ircClients.userModes.
Dropping old Matrix messages:
- Messages that the bridge receives will be dropped if they are more than N seconds old.
- This can be configured using the homeserver.dropMatrixMessagesAfterSecs.
Prometheus metrics:
- The bridge can now run a /metrics listener for Prometheus-based metrics reporting.
- Metrics can be enabled by setting metrics.enabled.
- Statsd metrics are now deprecated and will be removed in a future release.

Improvements:

!quit [server.name] now attempts to kick the Matrix user that issues the command from the rooms in which they are being briged. This is done before the user's respective IRC client is disconnected.
The bridge now randomly jitters quit debounce delays between a minimum and maximum amount of time. This is in order to prevent the HS being sent many leave requests all at once following a net-split that lasts a very long time. (See quitDebounce in config.sample.yaml)
Initial IRC -> Matrix leave syncing is now implemented.
Errors received by the bridge when joining an IRC client to a channel can now be seen in the admin room at startup.
Provisioning logs are now more detailed.
Bridge m.video uploads as files.
The bridge now uses the AS-specific room publication API. This requires Synapse v0.18.5-rc3 or above.
The bridge now uses new Homeserver membership list APIs: /joined_rooms and /rooms/$room_id/joined_members. This is required in order to sync membership lists. This requires Synapse v0.18.5-rc3 or above.

Bug fixes:

Fixed a rare bug which could cause the bridge to tightloop when Matrix users leave a bridged channel.
Prevent multiple PM rooms being created when PMs are sent from IRC to Matrix in rapid succession.
The namespace that the bridge uses to claim user names and aliases has been restricted to the HS to which it is connected, rather than any HS which might also have an IRC bridge running.
Bumped the minimum supported Node.js version from 4.0 to 4.5 to fix a bug which caused TLS and IPv6 to not work together: nodejs/node#6654
Ident usernames will now always begin with A-z. Previously, the bridge abided by RFC 2812, but on some networks this was treated as an invalid username.
Fixed a regression which prevented banned connections from waiting BANNED_TIME_MS between connection attempts.

Changes in 0.6.0 (2016-10-26)

New features:

Presence Syncing / Quit Debouncing / Net Split Handling: When a net split occurs on IRC and incremental membership list syncing was set to true in previous versions, a lot of spam would be sent to the HS despite the possibility of the same clients reconnecting shortly afterwards. With this new update, QUITs received from IRC are debounced if a net split is considered ongoing. This uses the heuristic of QUITs per second being greater than a certain threshold. If the threshold is reached, debouncing kicks in, delaying the bridging QUITs to the HS for delayMs. If the clients reconnect during this grace period, the QUIT is not bridged. In the meantime, Matrix presence is used to indicate that the user is offline. The associated configuration for this can be found in config.sample.yaml as quitDebounce.
Topic Bridging: Topics are now bridged from IRC to Matrix in aliased rooms or rooms created via !join in the admin room.
Custom CA: A custom Certificate Authority certificate can now be given in the config file for using SSL to connect to IRC servers. (Thanks, @Waldteufel!)
Custom Media Repo: media_url in the bridge config file can now be set for setups where media uploaded on the Matrix side is not stored at the connected HS.

Improvements:

Add !quit server.name admin room command to disconnect an associated virtual IRC user from a given IRC server.
Turn of AS rate limiting when generating registration files.
!join admin room command now creates rooms with the join rule set to dynamicChannels.joinRule instead of always being private.

Bug fixes:

!help command no longer requires server name
The bridge now ignores NickServ and ChanServ PMs that previously it was trying to bridge erroneously.
Fix plumbing channels with capital letters in them.
Fix flaky tests(!) due to not killing bridged client instances between tests.
Fix the bridge taking forever calling /initialSync on the HS when a user leaves a room bridged into >1 channel. It instead uses /$room_id/state for each bridged room.

Changes in 0.5.0 (2016-10-06)

New features:

A new server config item, reconnectIntervalMs has been added and is used to throttle reconnections to an IRC server in a queue, where one reconnection is serviced per interval.
Added Third Party Lookup - for mapping IRC user/channel names into Matrix user IDs or room aliases.
Added config floodDelayMs which is used to drip feed membership entries at the specified rate when syncing membership.

Improvements:

Provisioning:
- Provisioning of mappings has been improved by requiring that an IRC channel operator (or admin) in the plumbed channel respond with 'yes'/'y' before the mapping can be created to prevent abuse.
- During provisioning, matrix room state m.room.bridging is used in the room in the new mapping to signal whether the status of the bridging is 'pending', 'success', or 'failure':
```
{
    content: {
        bridger: 'nick',
        status: 'pending'
    }
}
```
- Route loops are now prevented using m.room.bridging as an indication that bridging exists.
- The queryLink endpoint for asking for a list of operators in a given channel has been added. This list is acquired through the bot joining a channel, but they are cached temporarily to reduce join/part spam.
- The queryNetworks endpoint was added and can be used to query the available networks on the bridge.
- The IRC bot will leave a channel if it is no longer mapped to any other upon unlinking. The matrix bot will also leave an totally unlinked room.
- Better error message are given when linking.
- Only moderators in a matrix room can unlink.
The wording of messages sent to admin rooms has been improved, as well as a helpful message to get things started.
Sync +s mode in channels with room visibility. +s = 'hidden from published room directory', -s = 'listed on the published room directory'.

Bug fixes:

Room alias requests can only be done for channels that start with # to avoid confusion with people not being able to join #ircnetwork_somechannel:domain.com. The important thing being the missing # before somechannel.
Prevent admin room from being created when plumbing. Previously, the bot would treat a linked room as an admin room, and so allow users to issue commands in it (but only after unlinking again).
If the bot is enabled, join a channel when linked.
Part IRC clients which should no longer be in a channel due to unlinking.
When an IPv6 prefix is provided, assume outgoing IRC connections will be IPv6, instead of relying on the specified IRC domain only resolving to IPv6 addresses. Previously, this would cause issues with IPv6 bound outgoing connections attempting to connect to IPv4 addresses.
Do not cache stale clients in the client pool. Previously, stale BridgedClients would be left in the client pool if the bot was disconnected and then reconnected. This resulted in the bot being unable to respond or join/leave channels when requested to by provisioning request.

Changes in 0.4.0

New features:

Kicks to and from Matrix will now be mirrored. This does not alter the ops/power level of any user, and hence may not always succeed.
PM rooms now have a federate flag to control whether they can be federated or not (via the m.federate option on the room creation).
Long messages sent from Matrix will now be uploaded to Matrix as .txt files before being sent to IRC. The number of lines allowed before uploading can be configured by a new lineLimit option in config.yaml.
Add a dynamic provisioning API to create/delete Matrix<-->IRC links on a running bridge instance. These links do NOT have preference over config-specified mappings.
Allow arbitrary IRC commands to be sent to an IRC network via the Matrix admin room.

Improvements:

Connection notices will now only be sent to Matrix users after receiving RPL_WELCOME rather than establishing a TCP connection. This reduces message spam when connections fail to register (due to throttling, etc).
User and Alias regexes generated by the bridge will now be scoped to the homeserver rather than set as a wildcard (which would result in traffic from federated servers being sent to the bridge).
When an IRC connection receives an error that means they failed to join the channel (e.g. err_bannedfromchan), the bridge will now kick the corresponding Matrix user from the room.

Bug fixes:

Fixed a bug whereby a metric was not sent to update the connected client count when reconnecting.
Fixed a bug whereby a nick set via !nick would not be persisted through reconnections.
Fixed a bug which caused the static config mappings to be preserved even when they were changed in config.yaml.

Changes in 0.3.1

New Features:

A "debug API" has been added and can be enabled via ircService.debugApi.enabled: true. See config.sample.yaml for the exposed REST API.
A new command !whois Nick has been added.
IRC channels with +k (a password is required) can now be accessed via the bridge using the !join command, which now has an optional key parameter.

Improvements:

Nickname validation logic now more accurately tracks RFC 2812 - in particular the allowed first character of a nick. The max nickname length (9) in RFC 2812 is ignored, as most servers have a higher limit (30) and connecting with a shortened form and then expanding it based on the RPL_ISUPPORT NICKLEN is needlessly tedious given most IRC servers automatically truncate long nicknames.
If a Matrix user leaves a PM room with an IRC user and the IRC user sends a message to them, the bridge will now automatically re-invite the Matrix user back into the room they left.
Issuing a !join command will now make the connected IRC client send a JOIN under the following circumstances:
- The !join has a key - This is necessary because the bridge does not store channel keys.
- The bridge is mirroring Matrix-to-IRC joins.

Bug fixes:

Fixed various issues with responses to the !nick command. It will now time out after 10 seconds, rather than listen indefinitely for the next NICK reply. It will also listen for a wide variety of NICK error replies, including some server-specific error codes, in order to fail faster. In addition, the | character is now correctly allowed as part of a nickname for !nick commands.
Fixed a bug whereby starting the bridge pointed to an inactive Homeserver would cause the bridge to fail to start up and not terminate the process. The bridge will now retry /initialSync indefinitely so it can start up as soon as the Homeserver becomes active again.
Fixed a bug which caused the bridge to terminate due to ECONNRESET.
Fixed a bug which caused the bridge to attempt to set the TOPIC of an IRC channel based on an m.room.topic which did not have a state_key of "".
Fixed a bug which caused initial IRC-to-Matrix membership list syncing to not occur, even if it was enabled in config.yaml.

Changes in 0.3.0

This update implements full matrix-appservice-bridge support in the IRC bridge and adds a number of smaller features.

BREAKING CHANGES:

The structure of the NEDB databases has changed. You must run the the upgrade script in order to continue running the bridge. This must then be followed by another upgrade script.

The CLI args have changed in this version to bring them in-line with the bridge library:

To generate a registration file:

node app.js -r [-f /path/to/save/registration.yaml] -u 'http://localhost:6789/appservice' -c CONFIG_FILE [-l my-app-service]

To run the bridge:

node -c CONFIG_FILE [-f /path/to/load/registration.yaml] [-p NUMBER]

New Features:

Nicks set via !nick will now be preserved across bridge restarts.
EXPERIMENTAL: IRC clients created by the bridge can be assigned their own IPv6 address.
The bridge will now send connection status information to real Matrix users via the admin room (the same room !nick commands are issued).
Added !help.
The bridge will now fallback to body if the HTML content contains any unrecognised tags. This makes passing Markdown from Matrix to IRC much nicer.
The bridge will now send more metrics to the statsd server, including the join/part rate to and from IRC.
The config option matrixClients.displayName is now implemented.

Bug fixes:

Escape HTML entities when sending from IRC to Matrix. This prevents munging occurring between IRC formatting and textual < element > references, whereby if you sent a tag and some colour codes from IRC it would not escape the tag and therefore send invalid HTML to Matrix.
User IDs starting with - are temporarily filtered out from being bridged.
Deterministically generate the configuration file.
Recognise more IRC error codes as non-fatal to avoid IRC clients reconnecting unecessarily.
Add a 10 second timeout to join events injected via the MemberListSyncer to avoid HOL blocking.
'Frontier' Matrix users will be forcibly joined to IRC channels even if membership list syncing I->M is disabled. This ensures that there is always a Matrix user in the channel being bridged to avoid losing traffic.
Cache the /initialSync request to avoid hitting this endpoint more than once, as it may be very slow.
Indexes have been added to the NeDB .db files to improve lookup times.
Do not recheck if the bridge bot should part the channel if a virtual user leaves the channel: we know it shouldn't.
Refine what counts as a "request" for metrics, reducing the amount of double-counting as requests echo back from the remote side.
Fixed a bug which caused users to be provisioned off their user_id even if they had a display name set.

Changes in 0.1.1

Requires Node v4+

Features:

app.js is now added to .bin so can be invoked directly.
Added config option ircClients.idleTimeout to allow virtual IRC clients to timeout after a specified amount of time.
Deprecate dynamicChannels.visibility in favour of dynamicChannels.createAlias, dynamicChannels.published and dynamicChannels.joinRule which gives more control over how the AS creates dynamic rooms.
Added matrixClients.mirrorJoinPart to make virtual IRC users join and part as their real Matrix counterparts join and leave rooms (the other way around to the existing ircClients.mirrorJoinPart).
Added a membershipLists section to control syncing of membership lists.

Improvements:

Replaced check.sh with npm run lint and npm run check.
Listen for +k and +i modes and change the join_rules of the Matrix room to invite when they are set. Revert back to the YAML configured join_rules when these modes are removed.

Bug fixes:

Make channels case-insensitive when joining via room aliases and when mapping to rooms.
Strip unknown HTML tags from Matrix messages before sending to IRC.
Don't try to leave Matrix rooms if the IRC user who left is a virtual user.
And more..

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

2.0.0 (2024-04-08)

Bugfixes

Improved Documentation

Deprecations and Removals

Internal Changes

1.0.1 (2023-07-31)

🔒 Security

Bugfixes

Internal Changes

1.0.0 (2023-06-09)

Features

Bugfixes

1.0.0-rc1 (2023-04-28)

Features

Bugfixes

Deprecations and Removals

Internal Changes

0.38.0 (2023-04-12)

Bugfixes

Internal Changes

0.37.1 (2023-03-07)

Bugfixes

Internal Changes

0.37.0 (2023-02-08)

Features

Bugfixes

Internal Changes

0.36.0 (2022-10-25)

Features

Bugfixes

Improved Documentation

Deprecations and Removals

Internal Changes

0.35.1 (2022-09-26)

Bugfixes

0.35.0 (2022-09-13)

Features

Bugfixes

Internal Changes

0.34.0 (2022-05-04)

Internal Changes

0.33.1 (2022-03-30)

Bugfixes

Deprecations and Removals

Internal Changes

0.33.0 (2022-03-02)

0.33.0-rc2 (2022-02-18)

Bugfixes

0.33.0-rc1 (2022-02-17)

Features

Bugfixes

Improved Documentation

Deprecations and Removals

Internal Changes

0.32.1 (2021-10-25)

Bugfixes

0.32.0 (2021-10-18)

0.32.0-rc2 (2021-10-15)

Bugfixes

0.32.0-rc1 (2021-10-08)

Features

0.31.0 (2021-09-20)

Bugfixes

0.31.0-rc1 (2021-08-23)

Features

Bugfixes

Improved Documentation

Internal Changes

0.30.0 (2021-08-18)

0.30.0-rc1 (2021-08-17)

Features

Bugfixes

Improved Documentation

Internal Changes