Skip to content

Latest commit

 

History

History
1233 lines (1084 loc) · 62.5 KB

CHANGELOG.md

File metadata and controls

1233 lines (1084 loc) · 62.5 KB

Changes in 0.8.2 (2017-08-24)

Full Changelog

  • 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)

Full Changelog

  • [No changes]

Changes in 0.8.1-rc.1 (2017-08-22)

Full Changelog

  • 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)

Full Changelog

BREAKING CHANGE

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:

  1. 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 calling startClient, to give the crypto layer a chance to initialise.

  2. 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.

  3. MatrixClient.listDeviceKeys has been removed altogether. It's been deprecated for some time. Applications using it should instead be changed to use MatrixClient.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 to userId if membership has displayname=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)

Full Changelog

  • Fix failure on Tor browser #473
  • Fix issues with firefox private browsing #472

Changes in 0.7.12 (2017-06-19)

Full Changelog

  • No changes

Changes in 0.7.12-rc.1 (2017-06-15)

Full Changelog

  • allow setting iceTransportPolicy to relay through forceTURN option #462

Changes in 0.7.11 (2017-06-12)

Full Changelog

  • Add a bunch of logging around sending messages #460

Changes in 0.7.11-rc.1 (2017-06-09)

Full Changelog

  • 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)

Full Changelog

  • BREAKING CHANGE: The SDK no longer requires olm - instead it expects libolm to be provided as an Olm 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)

Full Changelog

  • 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)

Full Changelog

  • No changes

Changes in 0.7.8-rc.1 (2017-05-19)

Full Changelog

  • 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)

Full Changelog

  • No changes

Changes in 0.7.7-rc.1 (2017-04-21)

Full Changelog

  • Automatically complete dummy auth #420

Changes in 0.7.6 (2017-04-12)

Full Changelog

  • No changes

Changes in 0.7.6-rc.2 (2017-04-10)

Full Changelog

  • Add feature detection for webworkers #416
  • Fix release script #415

Changes in 0.7.6-rc.1 (2017-04-07)

Full Changelog

  • 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 as this #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)

Full Changelog

No changes from 0.7.5-rc.3

Changes in 0.7.5-rc.3 (2017-02-03)

Full Changelog

  • Include DeviceInfo in deviceVerificationChanged events a3cc8eb
  • Fix device list update 5fd7410

Changes in 0.7.5-rc.2 (2017-02-03)

Full Changelog

  • Use the device change notifications interface #348
  • Rewrite the device key query logic #347

Changes in 0.7.5-rc.1 (2017-02-03)

Full Changelog

  • 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)

Full Changelog

  • Fix non-conference calling

Changes in 0.7.4-rc.1 (2017-01-13)

Full Changelog

  • 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)

Full Changelog

  • 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)

Full Changelog

  • 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)

Full Changelog

No changes

Changes in 0.7.1-rc.1 (2016-12-05)

Full Changelog

  • 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)

Full Changelog

  • 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)

Full Changelog

  • Change release script to pass version by environment variable

Changes in 0.6.4-rc.2 (2016-11-02)

Full Changelog

  • Add getRoomTags method to client #236

Changes in 0.6.4-rc.1 (2016-11-02)

Full Changelog

Breaking Changes

  • 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.

Other Changes

  • 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)

Full Changelog

Breaking Changes

  • Add a 'RECONNECTING' state to the sync states. This is an additional state between 'SYNCING' and 'ERROR', so most clients should not notice.

Other Changes

  • 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)

Full Changelog

  • 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)

Full Changelog

  • Fix the ed25519 key checking #215
  • Add MatrixClient.getEventSenderDeviceInfo() #214

Changes in 0.6.0 (2016-09-21)

Full Changelog

  • 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 of body 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)

Full Changelog

  • 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)

Full Changelog

  • Add room.getAliases() and room.getCanonicalAlias

  • Add API calls /register/email/requestToken, /account/password/email/requestToken and /account/3pid/email/requestToken

  • Add User.currentlyActive and User.lastPresenceTs events for changes in fields on the User object

  • Add logout and deactivateAccount

  • 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)

Full Changelog

Changes in 0.5.3 (2016-06-02)

Full Changelog

  • 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)

Full Changelog

  • 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)

Full Changelog

  • 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)

Full Changelog

BREAKING CHANGES:

  • opts.pendingEventOrdering==end is no longer supported in the arguments to MatrixClient.startClient(). Instead we provide a detached option, which puts pending events into a completely separate list in the Room, accessible via Room.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)

Full Changelog

  • 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

Changes in 0.4.1

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)

Changes in 0.4.0

BREAKING CHANGES:

  • RoomMember.getAvatarUrl() and MatrixClient.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. The allowDirectLinks 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

Changes in 0.3.0

  • MatrixClient.getAvatarUrlForMember has been removed and replaced with RoomMember.getAvatarUrl. Arguments remain the same except the homeserver URL must now be supplied from MatrixClient.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 with Room.getAvatarUrl. Arguments remain the same except the homeserver URL must now be supplied from MatrixClient.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.getMembersWithMembership/g

New methods:

  • Added support for sending receipts via MatrixClient.sendReceipt(event, receiptType, callback) and MatrixClient.sendReadReceipt(event, callback).
  • Added support for receiving receipts via Room.getReceiptsForEvent(event) and Room.getUsersReadUpTo(event). Receipts can be directly added to a Room using Room.addReceipt(event) though the MatrixClient does this for you.
  • Added support for muting local video and audio via the new methods MatrixCall.setMicrophoneMuted(), MatrixCall.isMicrophoneMuted(muted), MatrixCall.isLocalVideoMuted() and Matrix.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) and MatrixClient.search(opts).

Improvements:

  • Improve the performance of initial sync processing from O(n^2) to O(n).
  • Room.name will now take into account m.room.canonical_alias events.
  • MatrixClient.startClient now takes an Object opts rather than a Number in a backwards-compatible way. This opts allows syncing configuration options to be specified including includeArchivedRooms and resolveInvitesToProfiles.
  • Room objects which represent room invitations will now have state populated from invite_room_state if it is included in the m.room.member event.
  • Room.getAvatarUrl will now take into account m.room.avatar events.

Changes in 0.2.2

Bug fixes:

  • Null pointer fixes for VoIP calling and push notification processing.
  • Set the Content-Type to application/octet-stream in the event that the file object has no type.

New methods:

  • Added MatrixClient.getCasServer() which calls through to the HTTP endpoint /login/cas.
  • Added MatrixClient.loginWithCas(ticket, service) which logs in with the type m.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() to RoomMember, RoomState and User 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.

Changes in 0.2.1

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) where opts can include a syncRoom: true|false flag to control whether a room initial sync is performed after joining the room.
  • MatrixClient.getAvatarUrlForMember has a new last arg allowDefault which returns the default identicon URL if true.
  • MatrixClient.getAvatarUrlForRoom has a new last arg allowDefault which is passed through to the default identicon generation for getAvatarUrlForMember.

Changes in 0.2.0

BREAKING CHANGES:

  • MatrixClient.setPowerLevel now expects a MatrixEvent and not an Object for the event 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 by call.placeVoiceCall() or call.placeVideoCall(remoteEle, localEle). Inbound calls will be received via the event "Call.incoming" which provides a call object which can be followed with call.answer() or call.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; unstable
  • WebStorageSessionStore - 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 and target properties from being set.

Changes in 0.1.1

BREAKING CHANGES:

  • Room.calculateRoomName is now private. Use Room.recalculate instead, and access the calculated name via Room.name.
  • new MatrixClient(...) no longer creates a MatrixInMemoryStore if opts.store is not specified. Instead, the createClient global function creates it and passes it to the constructor. This change will not affect users who have always used createClient to create a MatrixClient.
  • "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 a Room object when resolved, not an object with a room_id property.
  • MatrixClient.scrollback now expects a Room arg instead of a room_id and from token. Construct a new Room(roomId) if you want to continue using this directly, then set the pagination token using room.oldState.paginationToken = from. It now resolves to a Room 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 the event.status of EventStatus.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 of EventStatus.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.