This is a important hotfix release to fix an issue where the room upgrade handling would not verify that the new room was a precessor of the old room. All bridges making use of the room upgrade handling feature should update.
- Fix an issue where the room upgrade handler would not check the
m.room.createevent when traversing an upgrade. (#330)
No significant changes.
- Add the
BridgeInfoStateSyncerhelper component to sync MSC2346 format state events to rooms. (#312)
- Ensure that the Intent room state cache is invalidate when the room state changes. (#310)
- Use
type=m.login.applicationwhen registering appservice users, to comply with the spec. (#315)
- Upgrade matrix-appservice-node to 0.8.0 (#311)
No significant changes.
- Allow for returning
roomIdinonAliasQuerywhich facilitates handling room creation yourself. (#288) - Allow the
Bridgeto be initalised without starting the HTTP listener. (#299) - Add
Intent.resolveRoomfunction (#301)
- Fix a case where an encrypted bridge may stop syncing for some users of the bridge (#285)
- Fix onAliasQuery tests which would pass no matter if they failed (#289)
- Fix regex complexity vulnerability in highlight.js (GHSA-7wwv-vh3v-89cq) (#290)
- Fix a bug where /metrics would report empty values. (#296)
- Fix a bug that would cause membership queue request failures to not be reported under the
membershipqueue_reasonmetric (#300) - Fix Winston logging errors if the bridge hadn't called Logger.configure yet (#302)
- Improve some TypeScript return types (#292)
- Update dependencies. We now use Typescript 4.1 which means that promiseutil.Defer now strictly checks resolve types. (#295)
- Update
matrix-js-sdkto9.5.0(#303) - Fetch metrics asynchronously (#304)
No significant changes.
- Fixed a issue the membership queue where a failed action would cause the
membershipqueue_pendingmetric to increase. (#283)
- Add function
registerMetricstoMembershipQueueto track metrics. (#276) - Add
defaultTtloption toMembershipQueueto expire membership that is too old. (#277) - Logs from
matrix-js-sdkwill now be passed through the bridgeLoggerto keep logging in one place. (#280)
- Add a script to automatically generate documentation for a release. (#275)
- Fix a bug where
intent.uploadContentwould return the full JSON response of an upload rather than it's MXC url. (#279)
- Remove
winston-daily-rotate-fileside-effects which can throw errors with some installedwinstonversions (#264) - Fixed a bug where encrypted events may be handled twice. (#267)
- Update
matrix-appservicedependency to 0.7.1 to fix a bug wheremsc2409.push_ephemeralwould be required in the registration file. (#270)
- Render various opts objects in the documentation that were missed last time (#268)
- Add contributing docs to make first time contributions easier (#269)
- Replace usages of deprecated
event.user_idfield withevent.senderin examples. (#272)
- Remove travis-ci build status badge on README.md. (#273)
No significant changes.
- Fix issue where Intent.join would return undefined rather than the roomId (#257)
- Fix a bug where a timeout would not be cleared after a sucessful homeserver ping test (#256)
- Add
MembershipQueuecomponent (#251) - Add function to ping the homeserver to check that the AS can be reached (#253)
- Add
uploadContent(), andsetRoomDirectoryVisibility()intent functions (#254)
- Fix a bug where the default configuration would be overwritten on validation (#252)
- Fix a bug where messages would be echoed to the bridge from the bot user, even if
suppressEchowas on. (#255)
No significant changes.
- Add a function to intent to set the user's profile in a room. (#248)
- Don't join the room when doing a self-kick (#250)
- Update matrix-js-sdk to v8.4.1 (#237)
- Add support for ephemeral events from the AS api (MSC2409) (#238)
- Return the roomId when calling intent.join (#241)
- Fix bug where OnAliasQuery would fail to fire if OnUserQuery was not defined (#247)
- Fix issue where ghost users would not be registered if they've never used the bridge (#249)
- Return
event_idwhen sending a event or state event (#242)
- WeakEvent should allow for an optional
state_keyandunsignedfields. (#236)
- Ensure that the bridge bot uses the real homeserver URL when encryption is enabled (#233)
- Add support for bridging encrypted events via matrix-org/pantalaimon. (#231)
Breaking changes since 1.0:
- Remove Bluebird Promise support. Promises returned by the library will now be native. (#216)
- Reinstate ability to call getProfileInfo without specifying a profile key. (#232)
- Bump matrix-js-sdk to 8.0.1 (#194)
- Use Typedoc over JSDoc for hosted documentation (#199)
- The bridge can now optionally reload the config file on a
SIGHUPsignal. Developers should define theonConfigChangedcallback when constructingClito make use of this feature. (#207) - Breaking: Remove Bluebird Promise support. Promises returned by the library will now be native. (#216)
- Make url parameter optional when generating registration. (#217)
- Add
Bridge.closemethod to close the appservice (#227)
- Refactor RoomLinkValidator to not hastily approve a link if one user is exempt (#184)
- Fix bluebird defer warnings by using our own defer implementation. (#188)
- Bridge.run() now throws if it fails to listen to a port instead of creating a floating promise (#191)
- Fixed some broken typings and defer failures (#200)
- Fix issue where providing a custom Registry to getPrometheusMetrics would cause /metrics to emit no response (#201)
- Convert intent.js to TypeScript (#185)
- Convert
ClientFactoryto Typescript (#186) - Linter warnings no longer fail the linter, and
no-explicit-anyis a warning. (#187) - Port RequestFactory and Request to Typescript (#189)
- Remove some bluebird imports and use async/await in some tests (#190)
- Convert Cli to Typescript (#195)
- Remove
requestdependency (#197) - Typescriptify models/* (#202)
- Typescriptify MembershipCache (#203)
- Typescriptify ClientRequestCache (#204)
- Port Logging to Typescript. This change makes
winston,winston-daily-rotate-fileandchalka required dependency. (#205) - Typescriptify ConfigValidator (#206)
- Breaking: Typescriptify the room, user and event stores. The stores will now return pure Promises (not Bluebird), which means code that relys on Bluebird features will break. (#208)
- Port RoomUpgradeHandler to Typescript (#209)
- Typescriptify BridgeContext (#210)
- Typescriptify bridge errors. The
wrapfunction has been renamed towrapError. (#211) - Typescriptify AppserviceBot (#212)
- Port the
Bridgeobject to Typescript and remove javascript linting (#213) - Implement tweaks to typings to support existing bridges (#218)
- Upgrade internal tooling to use TypeScript 4 (#219)
- Types: Make some options of Cli optional Small corrections to HOWTO.md (#224)
- Types: Make some options of Bridge optional Add a project example: slack-starter (#225)
- Upgrade dependency: matrix-appservice (#226)
- Fix usages of private properties on
AppserviceRegistration(#179)
- Update packages to latest versions (#175)
- Remove travis-ci configuration file (#176)
- Port
EventQueueto Typescript. (#177) - Run NPM
buildonprepublish. (#178)
- Drain log messages after configuring logging, not just on first message. Thanks @halkeye! (#150)
- Fix bug where
ContentRepois undefined due tomatrix-js-sdkexport changes. (#171)
- Make parsed CLI arguments accessible to bridges. Thanks @devec0! (#164)
- Use
towncrierfor changelog tracking (#168) - Allow bridges to provide their own prometheus metrics Register and disable the default metrics endpoint (#169)
- Fix prototype bug (#170)
- Fix a bug where Authorization headers were ignored for authenticated requests #162
- Fix an error which would break all custom bridge endpoints #161
- Remove usage of v1 event format keys in the library. #145
- The project now supports Typescript source files. #148
- StateLookup /state requests are now queued rather than run in parallel. #157
- IMPORTANT The bridge now supports authenticating
/_matrix/app/.../thirdpartyrequests. #158 To remain backwards compatible with other homeservers, it is off by default. Settingopts.authenticateThirdpartyEndpointstotrueon theBridgeobject will enable this behaviour. - Limit thirdparty requests to
v1andunstableversions. #160
- Update
HOWTO.mdto clarifyserver_name/localhostconfusion. Thanks @marceltransier! #141 - Remove /appservice URL parth from
cli.jshelp text. #152
- Minimum required Node.JS version is now 10. Thanks @V02460 #146
- Audit packages and update versions. #159
- Use
matrix-appservice0.4.1#138 - Bridges can now bind to a hostname rather than listening globally #137
- Add option to disable stores #135
- Ensure getJoinedMembers uses the roomId parameter
- Ensure getJoinedMembers returns it's promise
- Update matrix-js-sdk to 2.3.0 #134
- Fix issue where rejected promises would not be returned from _onEvent #133 #132
-
Bridge Errors are a new unstable feature which allows a bridge to report errors to the client when a message cannot be relayed. This feature is not stable and will be subject to change in the future. Please read the README for more information. #111, #121, #125, #127. Thanks to Kai (@V02460) for their work on this during GSOC!
-
Remove old room store entries during upgrade. #129, #130
- Bugfix where we failed to handle events with empty string
state_keys
- Security fix Check that
state_keyexists on tombstone events.
- New
EventStorecomponent for storing matrix and remote event id mappings. #107 - Request.outcomeFrom no longer expects a Bluebird promise. #104
- Username escaping now handles
[ ]#112 - Escaping can be now disabled by changing
MatrixUser.ESCAPE_DEFAULTtofalse. #112
- Linting has been fixed, and now supports more modern syntax. #110
- Fix issue where not supplying RoomUpgradeHandler would break incoming events
- Handle more cases of userid encoding
New RoomUpgradeHandler component to handle room upgrades. More information on this can be found in the README.md.
- Fixed bug where the cli interface would incorrectly output to the log rather than to the console
- Fixed bug where invites and bans would be used to determine if a user "exists", which is not reliable.
- Bump matrix-js-sdk to 1.0.1
MatrixUser now escapes user ids by default which means any user id not conforming to https://matrix.org/docs/spec/appendices.html#user-identifiers will have some characters converted to QP encoding. This is likely to break some store mappings as well as create escaped ghost users where previously invalid ids would have been accepted.
User ids are now escaped when using MatrixUser, see above.
Packages js-yaml, matrix-appservice, istanbul have been updated.
jayschema was removed in favour of is-my-json-valid.
New component RoomLinkValidator can now parse rule files for linking rooms
and abort a link that could potentially be problematic.
New component Logging is a simple wrapper around winston (which falls back
to console) for more straight forward log management.
See the README and docs for more information about these components.
Fix bug where age counters would overwrite it's parameter for periods.
Some Intent operations now cache requests that would otherwise fall through
to the homeserver which can be expensive. This is configurable for Intents
via the opts.caching.ttl and size options.
AgeCounters now allow you to set your own time period buckets.
Added a new function Intent.getEvent which will fetch events
from the homeserver without any context information, which should
be quick.
MembershipCache is now exposed to let folks read and write to the cache
while also letting the bridge access it.
a release: Fix issue where roomState would fail.
b release: Fix issue where we were calling this.intent inside intent like fools!
c release: Fix issue where some stole js-sdk code was not checked thoroughly.
Updated matrix-js-sdk and matrix-appservice-node to latest versions.
The bridge now depends on prom-client.
When _ensureRegistered fails, we now reject the Promise with the error
unless the user is in use (M_USER_IN_USE). This means that most intent
functions will reject if the user fails to be registered. This may break your
bridge, so please be aware of it.
Created and exposed the membership cache through MembershipCache so
bridge developers may optionally setup the bridge any previous state they
may be aware of.
Membership is automatically passed to the MembershipCache when getJoinedMembers
is called so that we don't needlessly join rooms. Registration is also cached now
so that we do not try to register users we are aware of through membership.
Deprecated getMemberLists as it relied on /sync which is no longer allowed
in the client-server API for appservices. This will now throw an Error instead.
Exposed isRemoteUser (_isRemoteUser is still present for backwards compat).
New setPresence function on Intent for setting presence, can now disable presence
on the bridge via the bridge config.
Enable the default process-wide metrics in prom-client
a release: Fixes enablePresence being off by default
Added dontJoin option to Intent class for use when the bridge is maintaining
its own membership state for each user.
Share data structures created by Intent objects when accessed via the Bridge
class. This reduces memory usage and CPU usage as only 1 map needs to be updated
when new member/power level events are received, rather than N maps (where N is
the number of Intent objects).
Cull Intent objects which are accessed via Bridge.getIntent after an eviction
period. This reduces memory usage.
a release: Bugfixes whereby the bot Intent could forget its state.
Allow the default SUCCESS/FAILED log lines to be turned off via opts.logRequestOutcome.
Fixed a bug in the Intent class which could cause message sending to fail
with M_FORBIDDEN errors due to not being joined to the room. The class
now handles this case and will join the room before resending the message.
Specify a localTimeoutMs of 2 minutes for every outbound HTTP request to
prevent connections from wedging if a response is never returned.
Added AppServiceBot function getJoinedRooms for getting a list of joined
room IDs for the AS bot and function getJoinedMembers for getting a map of
joined user IDs for the given room ID. The values in the map are with a
display_name and avatar_url properties.
Switched the prometheus metrics from using the prometheus-client library to
the prom-client library.
Added PrometheusMetrics functions addTimer and startTimer for manipulating
timer metrics for the bridge.
Bumped matrix-org/matrix-js-sdk dependency from 0.5.3 to 0.7.2. See
the matrix-js-sdk changelog
Metrics.js has been refactored from matrix-appservice-{slack,gitter} to this repo. Bridge intent objects and Matrix client API calls are now counted as part of the new metrics functionality.
Added RoomBridgeStore function removeEntriesByRemoteId to remove entries in the DB with a given remote ID.
Added StateLookup function untrackRoom to stop further tracking of state events in a given room and delete existing stored state for it.
Use r0/sync rather than v1/initialSync for AppServiceBot function getMemberLists. A filter has also been added to limit the number events sent across.
Bump dependency on matrix-org/matrix-appservice-node from 0.3.1 to 0.3.3. See the matrix-appservice-node changelog.
Third Party Lookup:
- 3PL/3PU lookups now return lists instead of individual results
- Reverse lookups now possible
Added Intent function sendReadReceipt
ContentRepo now exported as pass-through from matrix-js-sdk.
Improved queueing of pending messages to send to the homeserver to store one queue per destination room. This stops large amounts of traffic to a busy room from holding up traffic on other rooms.
Added a getProfileInfo method on user intent objects to wrap the
corresponding matrix-js-sdk client method.
Added a convenience in the bridge controller to wrap the new /thirdparty
API.
Increased the default dependency of the JS SDK to 0.5.3. This is to allow file uploads to work correctly.
Added new RoomBridgeStore methods: getEntriesByLinkData and
removeEntriesByLinkData. See docs for function signatures and usage.
Added a new component: StateLookup. Added a new Bridge callback:
onAliasQueried(alias, roomId).
Added disableContext option to the Bridge class.
Modify the internal storage format of RoomBridgeStore. Change the public API
of RoomBridgeStore to reflect the new storage format.
This is a backwards-incompatible database format change. If you wish to upgrade from a 0.x version, you will need to write a script to upgrade your database.
The storage format has been changed to improve performance when querying room mappings.
Reduced the number of queries run when store methods are called. Added new
batch functions to reduce database queries at the application level.
The bridge library will now use r0 /register. Due to bugs inside Synapse, this
means the minimum supported Synapse version is 0.15.0-rc1 and above.
Fixed an issue where the bridge library would attempt to use v1 APIs on r0 paths.
This was caused by increasing the matrix-js-sdk dependency which now defaults
to r0 paths. Fixed various matrix-js-sdk breaking API changes such as the
change to the register() function.
The bridge library still uses v1 /initialSync.
Fixed a critical bug which would prevent the callback for HTTP requests from
firing if the request returned a network error such as ECONNRESET. This affected
all users of ClientFactory who attached a logging function via setLogFunction.
Increased the default matrix-js-sdk dependency used by ClientFactory to 0.4.1.
Improved JSDoc on various functions to clear up ambiguity. In addition:
Changes on the Intent class:
- Fixed a bug which could cause
createRoomto fail if theIntentwas scoped to the bot user. - Add intent option
dontCheckPowerLevelto skip checking the required power level before sending events. - Added
getClient()to retrieve the underlyingMatrixClientinstance. - Added
createAlias(alias, roomId).
Changes on the Bridge class:
- Modified the default request error callback to always log 'FAILED'.
- Added
loadDatabases()which can be invoked prior torun()for bridge setup. - Expose
Intentconstructor options in the bridgeopts.
Changes on the MatrixUser class:
- Added
get(key)andset(key, val)to allow arbitrary data to be stored on Matrix users.
Changes on the RoomBridgeStore class:
- Added
unlinkByData() - Added the concept of "Link Keys" to clobber links based on something other than the tuple of the room IDs.
Changes on the UserBridgeStore class:
- Added
getByMatrixData().
Dependency on matrix-appservice was bumped to fix a critical bug.
BREAKING CHANGE : An id field is required by all registration files as a result of bumping the dependency
of matrix-appservice to 0.3.0.
Added the following Bridge function:
Bridge.getClientFactory()
Do not log values returned by resolved Requests, only on errors.
Adjusted the promise returned by the event listener the Bridge class attaches
to AppService. This is mainly for testing purposes.
More functions/options have been added to the Cli class:
enableLocalpart: Settrueto enable the--localpart [-l]flag.- The CLI flag
--file [-f]has been added. This represents the location of the registration file. - The
run()function now includes the loadedAppServiceRegistrationinstance as an argument.
Bug fixes on the Cli class:
- When
generateRegistrationis called,thisis now bound to theCliinstance.
Implement the affectsRegistration option on Cli.
Added a HOW-TO.
Additions/improvements:
- Added a utility method
Bridge.getIntentFromLocalpart. Intentinstances will now ensure that the user is registered.AppServiceRegistrationfrommatrix-appserviceis now exported onmatrix-appservice-bridgeso end-developers don't need tonpm install matrix-appservice.
Breaking changes:
- Changed the function signature of
Cli.generateRegistration- the first arg is now anAppServiceRegistrationand not aString.
- First release