Changes in 0.8.2 (2017-08-24)
- Handle m.call.* events which are decrypted asynchronously #530
- Re-emit events from, er, Event objects #529
Changes in 0.8.1 (2017-08-23)
- [No changes]
Changes in 0.8.1-rc.1 (2017-08-22)
- Fix error handling in interactive-auth #527
- Make lots of OlmDevice asynchronous #524
- Make crypto.decryptMessage return decryption results #523
Changes in 0.8.0 (2017-08-15)
In order to support a move to a more scalable storage backend, we need to make a number of the APIs related end-to-end encryption asynchronous.
This release of the JS-SDK includes the following changes which will affect applications which support end-to-end encryption:
-
MatrixClient
now provides a new (asynchronous) method,initCrypto
. Applications which support end-to-end encryption must call this method (and wait for it to complete) before callingstartClient
, to give the crypto layer a chance to initialise. -
The following APIs have been changed to return promises:
MatrixClient.getStoredDevicesForUser
MatrixClient.getStoredDevice
MatrixClient.setDeviceVerified
MatrixClient.setDeviceBlocked
MatrixClient.setDeviceKnown
MatrixClient.getEventSenderDeviceInfo
MatrixClient.isEventSenderVerified
MatrixClient.importRoomKeys
Applications using the results of any of the above methods will need to be updated to wait for the result of the promise.
-
MatrixClient.listDeviceKeys
has been removed altogether. It's been deprecated for some time. Applications using it should instead be changed to useMatrixClient.getStoredDevices
, which is similar but returns its results in a slightly different format.
- Make bits of
olmlib
asynchronous #521 - Make some of DeviceList asynchronous #520
- Make methods in crypto/algorithms async #519
- Avoid sending unencrypted messages in e2e room #518
- Make tests wait for syncs to happen #517
- Make a load of methods in the 'Crypto' module asynchronous #510
- Set
rawDisplayName
touserId
if membership hasdisplayname=null
#515 - Refactor handling of crypto events for async #508
- Let event decryption be asynchronous #509
- Transform
async
functions to bluebird promises #511 - Add more group APIs #512
- Retrying test: wait for localEchoUpdated event #507
- Fix member events breaking on timeline reset, 2 #504
- Make bits of the js-sdk api asynchronous #503
- Yet more js-sdk test deflakification #499
- Fix racy 'matrixclient retrying' test #497
- Fix spamming of key-share-requests #495
- Add progress handler to
uploadContent
#500 - Switch matrix-js-sdk to bluebird #490
- Fix some more flakey tests #492
- make the npm test script windows-friendly #489
- Fix a bunch of races in the tests #488
- Fix early return in MatrixClient.setGuestAccess #487
- Remove testUtils.failTest #486
- Add test:watch script #485
- Make it possible to use async/await #484
- Remove m.new_device support #483
- Use access-token in header #478
- Sanity-check response from /thirdparty/protocols #482
- Avoid parsing plain-text errors as JSON #479
- Use external mock-request #481
- Fix some races in the tests #480
- Fall back to MemoryCryptoStore if indexeddb fails #475
- Fix load failure in firefox when indexedDB is disabled #474
- Fix a race in a test #471
- Avoid throwing an unhandled error when the indexeddb is deleted #470
- fix jsdoc #469
- Handle m.forwarded_room_key events #468
- Improve error reporting from indexeddbstore.clearDatabase #466
- Implement sharing of megolm keys #454
- Process received room key requests #449
- Send m.room_key_request events when we fail to decrypt an event #448
Changes in 0.7.13 (2017-06-22)
Changes in 0.7.12 (2017-06-19)
- No changes
Changes in 0.7.12-rc.1 (2017-06-15)
- allow setting iceTransportPolicy to relay through forceTURN option #462
Changes in 0.7.11 (2017-06-12)
- Add a bunch of logging around sending messages #460
Changes in 0.7.11-rc.1 (2017-06-09)
- Make TimelineWindow.load resolve quicker if we have the events #458
- Stop peeking when a matrix client is stopped #451
- Update README: Clarify how to install libolm #450
Changes in 0.7.10 (2017-06-02)
-
BREAKING CHANGE: The SDK no longer
require
solm
- instead it expects libolm to be provided as anOlm
global. This will only affect applications which use end-to-end encryption. See the README for details. -
indexeddb-crypto-store: fix db deletion #447
-
Load Olm from the global rather than requiring it. #446
Changes in 0.7.9 (2017-06-01)
- Initial framework for indexeddb-backed crypto store #445
- Factor out reEmit to a common module #444
- crypto/algorithms/base.js: Convert to es6 #443
- maySendRedactionForEvent for userId #435
- MatrixClient: add getUserId() #441
- Run jsdoc on a custom babeling of the source #442
- Add in a public api getStoredDevice allowing clients to get a specific device #439
Changes in 0.7.8 (2017-05-22)
- No changes
Changes in 0.7.8-rc.1 (2017-05-19)
- Attempt to rework the release-tarball-signing stuff #438
- ability to specify webrtc audio/video inputs for the lib to request #427
- make screen sharing call FF friendly :D #434
- Fix race in device list updates #431
- WebRTC: Support recvonly for video for those without a webcam #424
- Update istanbul to remove minimatch DoS Warning #422
- webrtc/call: Make it much less likely that callIds collide locally #423
- Automatically complete dummy auth #420
- Don't leave the gh-pages branch checked out #418
Changes in 0.7.7 (2017-04-25)
- No changes
Changes in 0.7.7-rc.1 (2017-04-21)
- Automatically complete dummy auth #420
Changes in 0.7.6 (2017-04-12)
- No changes
Changes in 0.7.6-rc.2 (2017-04-10)
Changes in 0.7.6-rc.1 (2017-04-07)
- Make indexeddb save after the first sync #414
- Make indexeddb startup faster #413
- Add ability to do indexeddb sync work in webworker #412
- Move more functionality to the indexeddb backend #409
- Indicate syncState ERROR after many failed /syncs #410
- Further reorganising of indexeddb sync code #407
- Change interface of IndexedDBStore: hide internals #406
- Don't be SYNCING until updating from the server #405
- Don't log the entire /sync response #403
- webrtc/call: Assign MediaStream to video element srcObject #402
- Fix undefined reference in http-api #400
- Add copyright header to event-timeline.js #382
- client: fix docs for user-scoped account_data events #397
- Add a CONTRIBUTING for js-sdk #399
- Fix leaking room state objects on limited sync responses #395
- Extend 'ignoreFailure' to be 'background' #396
- Add x_show_msisdn parameter to register calls #388
- Update event redaction to keep sender and origin_server_ts #394
- Handle 'limited' timeline responses in the SyncAccumulator #393
- Give a better error message if the HS doesn't support msisdn registeration #391
- Add getEmailSid #383
- Add m.login.email.identity support to UI auth #380
- src/client.js: Fix incorrect roomId reference in VoIP glare code #381
- add .editorconfig #379
- Store account data in the same way as room data #377
- Upload one-time keys on /sync rather than a timer #376
- Increase the WRITE_DELAY on database syncing #374
- Make deleteAllData() return a Promise #373
- Don't include banned users in the room name #372
- Support IndexedDB as a backing store #363
- Poll /sync with a short timeout while catching up #370
- Make test coverage work again #368
- Add docs to event #367
- Keep the device-sync token more up-to-date #366
- Fix race conditions in device list download #365
- Fix the unban method #364
- Spread out device verification work #362
- Clean up/improve e2e logging #361
- Fix decryption of events whose key arrives later #360
- Invalidate device lists when encryption is enabled in a room #359
- Switch from jasmine to mocha + expect + lolex #358
- Install source-map-support in each test #356
- searchMessageText: avoid setting keys=undefined #357
- realtime-callbacks: pass
global
asthis
#355 - Make the tests work without olm #354
- Tests: Factor out TestClient and use it in crypto tests #353
- Fix some lint #352
- Make a sig for source tarballs when releasing #351
- When doing a pre-release, don't bother merging to master and develop. #350
Changes in 0.7.5 (2017-02-04)
No changes from 0.7.5-rc.3
Changes in 0.7.5-rc.3 (2017-02-03)
Changes in 0.7.5-rc.2 (2017-02-03)
Changes in 0.7.5-rc.1 (2017-02-03)
- Support for blacklisting unverified devices, both per-room and globally #336
- track errors when events can't be sent #349
- Factor out device list management #346
- Support for warning users when unknown devices show up #335
- Enable sourcemaps in browserified distro #345
- Record all e2e room settings in localstorage #344
- Make Olm work with browserified js-sdk #340
- Make browserify a dev dependency #339
- Allow single line brace-style #338
- Turn on comma-dangle for function calls #333
- Add prefer-const #331
- Support for importing and exporting megolm sessions #326
- Fix linting on all tests #329
- Fix ESLint warnings and errors #325
- BREAKING CHANGE: Remove WebStorageStore #324
Changes in 0.7.4 (2017-01-16)
- Fix non-conference calling
Changes in 0.7.4-rc.1 (2017-01-13)
- Remove babel-polyfill #321
- Update build process for ES6 #320
- 'babel' is not a babel package anymore #319
- Add Babel for ES6 support #318
- Move screen sharing check/error #317
- release.sh: Bail early if there are uncommitted changes #316
Changes in 0.7.3 (2017-01-04)
- User presence list feature #310
- Allow clients the ability to set a default local timeout #313
- Add API to delete threepid #312
Changes in 0.7.2 (2016-12-15)
- Bump to Olm 2.0 #309
- Sanity check payload length before encrypting #307
- Remove dead _sendPingToDevice function #308
- Add setRoomDirectoryVisibilityAppService #306
- Update release script to do signed releases #305
- e2e: Wait for pending device lists #304
- Start a new megolm session when devices are blacklisted #303
- E2E: Download our own devicelist on startup #302
Changes in 0.7.1 (2016-12-09)
No changes
Changes in 0.7.1-rc.1 (2016-12-05)
- Avoid NPE when no sessionStore is given #300
- Improve decryption error messages #299
- Revert "Use native Array.isArray when available." #283
- Use native Array.isArray when available. #282
Changes in 0.7.0 (2016-11-18)
- Avoid a packetstorm of device queries on startup #297
- E2E: Check devices to share keys with on each send #295
- Apply unknown-keyshare mitigations #296
- distinguish unknown users from deviceless users #294
- Allow starting client with initialSyncLimit = 0 #293
- Make timeline-window _unpaginate public and rename to unpaginate #289
- Send a STOPPED sync updated after call to stopClient #286
- Fix bug in verifying megolm event senders #292
- Handle decryption of events after they arrive #288
- Fix examples. #287
- Add a travis.yml #278
- Encrypt all events, including 'm.call.*' #277
- Ignore reshares of known megolm sessions #276
- Log to the console on unknown session #274
- Make it easier for SDK users to wrap prevailing the 'request' function #273
Changes in 0.6.4 (2016-11-04)
- Change release script to pass version by environment variable
Changes in 0.6.4-rc.2 (2016-11-02)
- Add getRoomTags method to client #236
Changes in 0.6.4-rc.1 (2016-11-02)
- Bundled version of the JS SDK are no longer versioned along with source files in the dist/ directory. As of this release, they will be included in the release tarball, but not the source repository.
- More fixes to the release script #272
- Update the release process to use github releases #271
- Don't package the world when we release #270
- Add ability to set a filter prior to the first /sync #269
- Sign one-time keys, and verify their signatures #243
- Check for duplicate message indexes for group messages #241
- Rotate megolm sessions #240
- Check recipient and sender in Olm messages #239
- Consistency checks for E2E device downloads #237
- Support User-Interactive auth for delete device #235
- Utility to help with interactive auth #234
- Fix sync breaking when an invalid filterId is in localStorage #228
Changes in 0.6.3 (2016-10-12)
- Add a 'RECONNECTING' state to the sync states. This is an additional state between 'SYNCING' and 'ERROR', so most clients should not notice.
- Fix params getting replaced on register calls #233
- Fix potential 30s delay on reconnect #232
- uploadContent: Attempt some consistency between browser and node #230
- Fix error handling on uploadContent #229
- Fix uploadContent for node.js #226
- Don't emit ERROR until a keepalive poke fails #223
- Function to get the fallback url for interactive auth #224
- Revert "Handle the first /sync failure differently." #222
Changes in 0.6.2 (2016-10-05)
- Check dependencies aren't on develop in release.sh #221
- Fix checkTurnServers leak on logout #220
- Fix leak of file upload objects #219
- crypto: remove duplicate code #218
- Add API for 3rd party location lookup #217
- Handle the first /sync failure differently. #216
Changes in 0.6.1 (2016-09-21)
Changes in 0.6.0 (2016-09-21)
- Pull user device list on join #212
- Fix sending of oh_hais on bad sessions #213
- Support /publicRooms pagination #211
- Update the olm library version to 1.3.0 #205
- Comment what the logic in uploadKeys does #209
- Include keysProved and keysClaimed in the local echo for events we send. #210
- Check if we need to upload new one-time keys every 10 minutes #208
- Reset oneTimeKey to null on each loop iteration. #207
- Add getKeysProved and getKeysClaimed methods to MatrixEvent. #206
- Send a 'm.new_device' when we get a message for an unknown group session #204
- Introduce EventTimelineSet, filtered timelines and global notif timeline. #196
- Wrap the crypto event handlers in try/catch blocks #203
- Show warnings on to-device decryption fail #202
- s/Displayname/DisplayName/ #201
- OH HAI #200
- Share the current ratchet with new members #199
- Move crypto bits into a subdirectory #198
- Refactor event handling in Crypto #197
- Don't create Olm sessions proactively #195
- Use to-device events for key sharing #194
- README: callbacks deprecated #193
- Fix sender verification for megolm messages #192
- Use
ciphertext
instead ofbody
in megolm events #191 - Add debug methods to get the state of OlmSessions #189
- MatrixClient.getStoredDevicesForUser #190
- Olm-related cleanups #188
- Update to fixed olmlib #187
- always play audio out of the remoteAudioElement if it exists. #186
- Fix exceptions where HTMLMediaElement loads and plays race #185
- Reset megolm session when people join/leave the room #183
- Fix exceptions when dealing with redactions #184
Changes in 0.5.6 (2016-08-28)
- Put all of the megolm keys in one room message #182
- Reinstate device blocking for simple Olm #181
- support for unpacking megolm keys #180
- Send out megolm keys when we start a megolm session #179
- Change the result structure for ensureOlmSessionsForUsers #178
- Factor out a function for doing olm encryption #177
- Move DeviceInfo and DeviceVerification to separate module #175
- Make encryption asynchronous #176
- Added ability to set and get status_msg for presence. #167
- Megolm: don't dereference nullable object #174
- Implement megolm encryption/decryption #173
- Update our push rules when they come down stream #170
- Factor Olm encryption/decryption out to new classes #172
- Make DeviceInfo more useful, and refactor crypto methods to use it #171
- Move login and register methods into base-apis #169
- Remove defaultDeviceDisplayName from MatrixClient options #168
Changes in 0.5.5 (2016-08-11)
-
Add room.getAliases() and room.getCanonicalAlias
-
Add API calls
/register/email/requestToken
,/account/password/email/requestToken
and/account/3pid/email/requestToken
-
Add
User.currentlyActive
andUser.lastPresenceTs
events for changes in fields on the User object -
Add
logout
anddeactivateAccount
-
Make sure we actually stop the sync loop on logout #166
-
Zero is a valid power level #164
-
Verify e2e keys on download #163
-
Factor crypto stuff out of MatrixClient #162
-
Refactor device key upload #161
-
Wrappers for devices API #158
-
Add deactivate account function #160
-
client.listDeviceKeys: Expose device display name #159
-
Add
logout
#157 -
Fix email registration #156
-
Factor out MatrixClient methods to MatrixBaseApis #155
-
Fix some broken tests #154
-
make jenkins fail the build if the tests fail #153
-
deviceId-related fixes #152
-
/login, /register: Add device_id and initial_device_display_name #151
-
Support global account_data #150
-
Add more events to User #149
-
Add API calls for other requestToken endpoints #148
-
Add register-specific request token endpoint #147
-
Set a valid SPDX license identifier in package.json #139
-
Configure encryption on m.room.encryption events #145
-
Implement device blocking #146
-
Clearer doc for setRoomDirectoryVisibility #144
-
crypto: use memberlist to derive recipient list #143
-
Support for marking devices as unverified #142
-
Add Olm as an optionalDependency #141
-
Add room.getAliases() and room.getCanonicalAlias() #140
-
Change how MatrixEvent manages encrypted events #138
-
Catch exceptions when encrypting events #137
-
Support for marking devices as verified #136
-
Various matrix-client refactorings and fixes #134
Changes in 0.5.4 (2016-06-02)
- Correct fix for element-hq/element-web#1039
- Make release.sh work on OSX
Changes in 0.5.3 (2016-06-02)
- Add support for the openid interface #133
- Bugfix for HTTP upload content when running on node #129
- Ignore missing profile (displayname and avatar_url) fields on presence events, rather than overwriting existing valid profile data from membership events or elsewhere. Fixes element-hq/element-web#1039
Changes in 0.5.2 (2016-04-19)
- Track the absolute time that presence events are received, so that the relative lastActiveAgo value is meaningful. #128
- Refactor the addition of events to rooms #127
- Clean up test shutdown #126
- Add methods to get (and set) pushers #125
- URL previewing support #122
- Avoid paginating forever in private rooms #124
- Fix a bug where we recreated sync filters #123
- Implement HTTP timeouts in realtime #121
Changes in 0.5.1 (2016-03-30)
- Only count joined members for the member count in notifications. #119
- Add maySendEvent to match maySendStateEvent #118
Changes in 0.5.0 (2016-03-22)
BREAKING CHANGES:
opts.pendingEventOrdering
==end
is no longer supported in the arguments toMatrixClient.startClient()
. Instead we provide adetached
option, which puts pending events into a completely separate list in the Room, accessible viaRoom.getPendingEvents()
. #111
Other improvements:
- Log the stack when we get a sync error #109
- Refactor transmitted-messages code #110
- Add a method to the js sdk to look up 3pids on the ID server. #113
- Support for cancelling pending events #112
- API to stop peeking #114
- update store user metadata based on membership events rather than presence #116
- Include a counter in generated transaction IDs #115
- get/setRoomVisibility API #117
Changes in 0.4.2 (2016-03-17)
- Try again if a pagination request gives us no new messages #98
- Add a delay before we start polling the connectivity check endpoint #99
- Clean up a codepath that was only used for crypto messages #101
- Add maySendStateEvent method, ported from react-sdk (but fixed). #94
- Add Session.logged_out event #100
- make presence work when peeking. #103
- Add RoomState.mayClientSendStateEvent() #104
- Fix displaynames for member join events #108
Improvements:
- Check that
/sync
filters are correct before reusing them, and recreate them if not (matrix-org#85). - Fire a
Room.timelineReset
event when a room's timeline is reset by a gappy/sync
(matrix-org#87, matrix-org#93). - Make
TimelineWindow.load()
faster in the simple case of loading the live timeline (matrix-org#88). - Update room-name calculation code to use the name of the sender of the invite when invited to a room (matrix-org#89).
- Don't reset the timeline when we join a room after peeking into it (matrix-org#91).
- Fire
Room.localEchoUpdated
events as local echoes progress through their transmission process (matrix-org#95, matrix-org#97). - Avoid getting stuck in a pagination loop when the server sends us only messages we've already seen (matrix-org#96).
New methods:
- Add
MatrixClient.setPushRuleActions
to set the actions for a push notification rule (matrix-org#90) - Add
RoomState.maySendStateEvent
which determines if a given user has permission to send a state event (matrix-org#94)
BREAKING CHANGES:
RoomMember.getAvatarUrl()
andMatrixClient.mxcUrlToHttp()
now return the empty string when given anything other than an mxc:// URL. This ensures that clients never inadvertantly reference content directly, leaking information to third party servers. TheallowDirectLinks
option is provided if the client wants to allow such links.- Add a 'bindEmail' option to register()
Improvements:
- Support third party invites
- More appropriate naming for third party invite rooms
- Poll the 'versions' endpoint to re-establish connectivity
- Catch exceptions when syncing
- Room tag support
- Generate implicit read receipts
- Support CAS login
- Guest access support
- Never return non-mxc URLs by default
- Ability to cancel file uploads
- Use the Matrix C/S API v2 with r0 prefix
- Account data support
- Support non-contiguous event timelines
- Support new unread counts
- Local echo for read-receipts
New methods:
- Add method to fetch URLs not on the home or identity server
- Method to get the last receipt for a user
- Method to get all known users
- Method to delete an alias
-
MatrixClient.getAvatarUrlForMember
has been removed and replaced withRoomMember.getAvatarUrl
. Arguments remain the same except the homeserver URL must now be supplied fromMatrixClient.getHomeserverUrl()
.// before var url = client.getAvatarUrlForMember(member, width, height, resize, allowDefault) // after var url = member.getAvatarUrl(client.getHomeserverUrl(), width, height, resize, allowDefault)
-
MatrixClient.getAvatarUrlForRoom
has been removed and replaced withRoom.getAvatarUrl
. Arguments remain the same except the homeserver URL must now be supplied fromMatrixClient.getHomeserverUrl()
.// before var url = client.getAvatarUrlForRoom(room, width, height, resize, allowDefault) // after var url = room.getAvatarUrl(client.getHomeserverUrl(), width, height, resize, allowDefault)
-
s/Room.getMembersWithMemership/Room.getMembersWithMem
bership/g
New methods:
- Added support for sending receipts via
MatrixClient.sendReceipt(event, receiptType, callback)
andMatrixClient.sendReadReceipt(event, callback)
. - Added support for receiving receipts via
Room.getReceiptsForEvent(event)
andRoom.getUsersReadUpTo(event)
. Receipts can be directly added to aRoom
usingRoom.addReceipt(event)
though theMatrixClient
does this for you. - Added support for muting local video and audio via the new methods
MatrixCall.setMicrophoneMuted()
,MatrixCall.isMicrophoneMuted(muted)
,MatrixCall.isLocalVideoMuted()
andMatrix.setLocalVideoMuted(muted)
. - Added experimental support for screen-sharing in Chrome via
MatrixCall.placeScreenSharingCall(remoteVideoElement, localVideoElement)
. - Added ability to perform server-side searches using
MatrixClient.searchMessageText(opts)
andMatrixClient.search(opts)
.
Improvements:
- Improve the performance of initial sync processing from
O(n^2)
toO(n)
. Room.name
will now take into accountm.room.canonical_alias
events.MatrixClient.startClient
now takes an Objectopts
rather than a Number in a backwards-compatible way. Thisopts
allows syncing configuration options to be specified includingincludeArchivedRooms
andresolveInvitesToProfiles
.Room
objects which represent room invitations will now have state populated frominvite_room_state
if it is included in them.room.member
event.Room.getAvatarUrl
will now take into accountm.room.avatar
events.
Bug fixes:
- Null pointer fixes for VoIP calling and push notification processing.
- Set the
Content-Type
toapplication/octet-stream
in the event that the file object has notype
.
New methods:
- Added
MatrixClient.getCasServer()
which calls through to the HTTP endpoint/login/cas
. - Added
MatrixClient.loginWithCas(ticket, service)
which logs in with the typem.login.cas
. - Added
MatrixClient.getHomeserverUrl()
which returns the URL passed in the constructor. - Added
MatrixClient.getIdentityServerUrl()
which returns the URL passed in the constructor. - Added
getLastModifiedTime()
toRoomMember
,RoomState
andUser
objects. This makes it easier to see if the object in question has changed, which can be used to improve performance by only rendering when these objects change.
BREAKING CHANGES
MatrixClient.joinRoom
has changed from(roomIdOrAlias, callback)
to(roomIdOrAlias, opts, callback)
.
Bug fixes:
- The
Content-Type
of file uploads is now explicitly set, without relying on the browser to do it for us.
Improvements:
- The
MatrixScheduler.RETRY_BACKOFF_RATELIMIT
function will not retry when the response is a 400,401,403. - The text returned from a room invite now includes who the invite was from.
- There is now a try/catch block around the
request
function which will reject/errback appropriately if an exception is thrown synchronously in it.
New methods:
MatrixClient.createAlias(alias, roomId)
MatrixClient.getRoomIdForAlias(alias)
MatrixClient.sendNotice(roomId, body, txnId, callback)
MatrixClient.sendHtmlNotice(roomId, body, htmlBody, callback)
Modified methods:
MatrixClient.joinRoom(roomIdOrAlias, opts)
whereopts
can include asyncRoom: true|false
flag to control whether a room initial sync is performed after joining the room.MatrixClient.getAvatarUrlForMember
has a new last argallowDefault
which returns the default identicon URL iftrue
.MatrixClient.getAvatarUrlForRoom
has a new last argallowDefault
which is passed through to the default identicon generation forgetAvatarUrlForMember
.
BREAKING CHANGES:
MatrixClient.setPowerLevel
now expects aMatrixEvent
and not anObject
for theevent
parameter.
New features:
- Added
EventStatus.QUEUED
which is set on an event when it is waiting to be sent by the scheduler and there are other events in front. - Added support for processing push rules on an event. This can be obtained by
calling
MatrixClient.getPushActionsForEvent(event)
. - Added WebRTC support. Outbound calls can be made via
call = global.createNewMatrixCall(MatrixClient, roomId)
followed bycall.placeVoiceCall()
orcall.placeVideoCall(remoteEle, localEle)
. Inbound calls will be received via the event"Call.incoming"
which provides a call object which can be followed withcall.answer()
orcall.hangup()
. - Added the ability to upload files to the media repository.
- Added the ability to change the client's password.
- Added the ability to register with an email via an identity server.
- Handle presence events by updating the associated
User
object. - Handle redaction events.
- Added infrastructure for supporting End-to-End encryption. E2E is NOT available in this version.
New methods:
MatrixClient.getUser(userId)
MatrixClient.getPushActionsForEvent(event)
MatrixClient.setPassword(auth, newPassword)
MatrixClient.loginWithSAML2(relayState, callback)
MatrixClient.getAvatarUrlForMember(member, w, h, method)
MatrixClient.mxcUrlToHttp(url, w, h, method)
MatrixClient.getAvatarUrlForRoom(room, w, h, method)
MatrixClient.uploadContent(file, callback)
Room.getMembersWithMembership(membership)
MatrixScheduler.getQueueForEvent(event)
MatrixScheduler.removeEventFromQueue(event)
$DATA_STORE.setSyncToken(token)
$DATA_STORE.getSyncToken()
Crypto infrastructure (crypto is NOT available in this version):
global.CRYPTO_ENABLED
MatrixClient.isCryptoEnabled()
MatrixClient.uploadKeys(maxKeys)
MatrixClient.downloadKeys(userIds, forceDownload)
MatrixClient.listDeviceKeys(userId)
MatrixClient.setRoomEncryption(roomId, config)
MatrixClient.isRoomEncrypted(roomId)
New classes:
MatrixCall
WebStorageStore
- WIP; unstableWebStorageSessionStore
- WIP; unstable
Bug fixes:
- Member name bugfix: Fixed an issue which prevented
RoomMember.name
being disambiguated if there was exactly 1 other person with the same display name. - Member name bugfix: Disambiguate both clashing display names with user IDs in the event of a clash.
- Room state bugfix: Fixed a bug which incorrectly overwrote power levels locally for a room.
- Room name bugfix: Ignore users who have left the room when determining a room name.
- Events bugfix: Fixed a bug which prevented the
sender
andtarget
properties from being set.
BREAKING CHANGES:
Room.calculateRoomName
is now private. UseRoom.recalculate
instead, and access the calculated name viaRoom.name
.new MatrixClient(...)
no longer creates aMatrixInMemoryStore
ifopts.store
is not specified. Instead, thecreateClient
global function creates it and passes it to the constructor. This change will not affect users who have always usedcreateClient
to create aMatrixClient
."Room"
events will now be emitted when the Room has finished being populated with state rather than at the moment of creation. This will fire when the SDK encounters a room it doesn't know about (just arrived from the event stream; e.g. a room invite) and will also fire after syncing room state (e.g. after calling joinRoom).MatrixClient.joinRoom
now returns aRoom
object when resolved, not an object with aroom_id
property.MatrixClient.scrollback
now expects aRoom
arg instead of aroom_id
andfrom
token. Construct anew Room(roomId)
if you want to continue using this directly, then set the pagination token usingroom.oldState.paginationToken = from
. It now resolves to aRoom
object instead of the raw HTTP response.
New properties:
User.events
RoomMember.events
New methods:
Room.hasMembershipState(userId, membership)
MatrixClient.resendEvent(event, room)
New features:
- Local echo. When you send an event using the SDK it will immediately be
added to
Room.timeline
with theevent.status
ofEventStatus.SENDING
. When the event is finally sent, this status will be removed. - Not sent status. When an event fails to send using the SDK, it will have the
event.status
ofEventStatus.NOT_SENT
. - Retries. If events fail to send, they will be automatically retried.
- Manual resending. Events which failed to send can be passed to
MatrixClient.resendEvent(event, room)
to resend them. - Queueing. Messages sent in quick succession will be queued to preserve the order in which they were submitted.
- Room state is automatcally synchronised when joining a room (including if another device joins a room).
- Scrollback. You can request earlier events in a room using
MatrixClient.scrollback(room, limit, callback)
.
Bug fixes:
- Fixed a bug which prevented the event stream from polling. Some devices will black hole requests when they hibernate, meaning that the callbacks will never fire. We now maintain a local timer to forcibly restart the request.