Specifying a rewind parameter will now retrieve the requested number of Messages, and not (as it used to be) that number of things sent on the channel whether those things are Messages or Presence updates.

Since a realtime channel does a full presence sync immediately after attaching, so every presence member in the channel will be retrieved, there's no real usecase for having rewind also give you recent Presence messages — they just partially-duplicated the presence sync. The old behavior meant that on a channel with heavy presence activity, you would appear to get fewer Messages than you expect. For example, if of the last 100 things sent on the channel, 98 were Presence updates and 2 were Messages, then if you did {rewind: '100'} and added a Message listener with channel.subscribe(listener), only two messages would have been delivered to that listener. Users were naturally confused: they requested 100 but only got 2. The new behavior behavior fixes this; you will now get 100 messages, as you would intuitively expect.

We are pleased to announce that Single sign-on (SSO) is now available for all Enterprise customers.

SSO provides more security and ease-of-use for your employees as they no longer need an Ably password and access can be controlled centrally using your organization's IdP (e.g. Okta or Centrify)

How does it work?

Single sign-on (SSO) allows you to sign in to the Ably dashboard using a single credential and sign in flow managed by your organization.

We’ve implemented SSO for the Ably dashboard using SAML. SAML is a protocol most typically used to address web browser SSO use-cases.

Currently we have support for IdP- and SP-initiated flows, including JIT user creation, and strict mode to enforce SSO for your Ably accounts.

How do I try it?

SSO is currently only available for enterprise. Please contact your account manager if you would like it activated. Once activated please follow the setup instructions.

If you're not on an enterprise account but SSO is important to you, please let us know.

How can I provide feedback?

Please visit the Ably portal where you can tell us what you think of SSO, and other features. Alternatively contact us.

Two-factor authentication (2FA) adds an additional layer of security to your account by requiring more than just a password to log in.

Good news: it's now available for you to try as part of our Early Access program 🎉

How does it work?

Once a user has enabled 2FA, when they log in with a password they will also be sent an SMS with a security code that must be input.

Account owners can also force all users who access their account to have 2FA enabled.

📝 Please note: 2FA is only relevant for those using passwords to log in, so excludes Google, Twitter, GitHub and SAML based authentication.

How do I try it?

Navigate to My Settings in your Ably dashboard, click on the Enable two-factor authentication button, and follow the instructions.

Based on feedback we will consider adding additional 2FA functionality, such as TOTP (e.g. Google Authenticator) and push notifications.

How can I provide feedback?

Please visit the Ably portal where you can tell us what you think of this, and other features. Alternatively contact us.

What is the Early Access program?

The Early Access program is about getting new features into our customer's hands as quickly as possible so that we can use their feedback to help build a better product. ⚠️While all our software is thoroughly tested, early access features haven’t yet had a thorough shakedown so there is a greater chance you will discover bugs. The way certain features work may even change before they are released

Fixed bugs:

Address impact of change to interface on extras field on Message #580

Merged pull requests:

Support outbound message extras #581 (QuintinWillison)

Full release notes and changelog on GitHub.

Message Delta Compression reduces the bandwidth required to transmit realtime messages by sending only the changes from the previous message to subscribers each time there’s an update, instead of the entire message.

Let’s say the first message sent over a channel is 16KiB and the message after that is the same but with an additional 4KiB of new data. With Delta Compression that message will have a payload of only 4KiB instead of 20KiB.

This reduces bandwidth costs, improves latencies for end-users, and simplifies development by taking care of message size optimization.

Message Delta Compression is a stable feature: we expect it to be forwards-compatible with future Ably updates.

Using Message Delta Compression with an Ably Client Library SDK

When we released Channel Rewind we introduced channel parameters, expressed as a query string in the connection request or channel name itself. This was a first step to specifying parameters on a per channel basis.

With Ably’s 1.2 Client Library SDKs, available today, there’s now a proper ChannelOptions interface to express channel parameters, of which there are three:

• delta to enable Message Delta Compression
• rewind to enable and specify Ably’s existing Rewind functionality
• cipherParams to manage encryption on a channel

The libraries available in this 1.2 release are:

• JavaScript
• Java
• Cocoa
• .NET

Check our Client Library SDK feature support matrix for full feature coverage across all Client Library SDKs.

A note on ably-js

We're aware of Ably’s JavaScript Client Library SDK footprint and we're actively avoiding bloat. As such we’ve split out the VCDIFF decoder from the core of ably-js. In order to use Delta Compression with ably-js you need to plug in a separate VCDIFF decoder library. This is hosted on Ably’s CDN. We will be modularizing this in the future, but right now this is something you will need to consider.

Message Delta Compression using a non-Ably library

If you need to use a non-Ably library, say to stream over MQTT, and want to use Delta Compression you’ll need to reconstruct the messages yourself using the deltas. Ably provides a VCDIFF decoder library to decode messages yourself for Java, Cocoa, .NET, and JavaScript. The limitations with this is that you must use channel qualifiers. Read the docs for more.

Get started

• The announcement blog post
• Documentation for Message Delta Compression
• Documentation for ChannelOptions
• Ably's practical guide to diff algorithms and delta file formats

Merged pull requests:

• Add logs to help in troubleshooting RestClient http api calls #162 (gernest)
• Remove unused fields definition on RealtimeClient #161 (gernest)
• add implementation for RTN15b-c spec #159 (gernest)

Full release notes and changelog on GitHub.

Fixed bugs:

• Lib failing to retrying on 5xx if it can't parse the body #154
• Flaky TestAuth_ClientID test #80
• Likely leaking goroutines in multiple places #68

Closed issues:

• Implementing reauthentication before or after token expires #153

Merged pull requests:

• Properly set Error.StatusCode #157 (gernest)
• Use ClientOptions.TLSPort for tls connections #156 (gernest)
• RTN15a: Reconnect after networking error. #152 (tcard)
• Fix goroutine leaks #151 (tcard)
• Remove fmt.Println leftovers. #150 (tcard)
• Don't read from connection on inactive state. #149 (tcard)
• RTN23a: Receive from WebSocket with a timeout. #148 (tcard)

Full changelog and release notes.

Changes

• EventEmitter.whenState: fix for promises #630
• Typings: re-export Types namespace in 'ably/promises' sub-package #634
• Support promises with PaginatedResult#next() etc. #635
• Reduced npm package size #646
• Update msgpack dependency to version explicitly Apache-2.0 licensed #650

Full release notes on GitHub.

Merged pull requests:

• Push Activation State Machine: validate an already-registered device on activation #543 (paddybyers)

Full changelog and release notes.

Changes

Implemented enhancements:

• Remove queueing messages in a channel-level queue #894

Fixed bugs:

• lib fails all the user's channels on transition to connecting/disconnected if queueMessages is disabled? #1004

Closed issues:

• Implement push spec update ably/docs#710 #876

Merged pull requests:

• Refine release procedure #1014 (QuintinWillison)
• Fix 'queueMessages' expected behaviour #1005 (ricardopereira)

Versions

Podfile

pod 'Ably', '1.1.23'

Cartfile

github "ably/ably-cocoa" == 1.1.23

Objective-C

#import <Ably/Ably.h>

Swift

import Ably

Compatibility

Carthage release for Swift is built with Xcode 11.3.1.

See GitHub for full release notes.

Earlier releases:

• Ably Cocoa v1.1.22 release notes.

• Ably Cocoa v1.1.21 release notes.