ably-js

• Fix channel#unsubscribe() throwing an error if called on a failed channel, and removes the optional callback argument to subscribe()

• Auth: fix tokenParams missing from token requests in the event that no authParams specified

• Auth: if you do multiple concurrent authorize()s, make sure the token from last one wins
• If fallback hosts are enabled and a connection is abruptly disconnected with a 5xx error, retry immediately to a fallback rather than waiting the usual 15s disconnectedRetryTimeout

• Catch common failure mode with poorly-implemented authCallback
• Fix typings of TokenParams.capability

• Improve handling of responso to active traffic management placement constraint error for smooth cluster handover
• Normalise statuscode for 40170-failure to obtain token from client auth callback to 401 per spec

• Only autoremove an expired token if we know the local offset from server time
• Fix tokenParams not being correctly mixed in to authParams in some circumstances

• Support PUSH, PATCH, and DELETE in Rest#request()
• Support arbitrary params for REST publishes
• Fix scope leak issue when using the minified version of the library

This 1.1 release brings many new features from 1.0:

• Transient publishing supported on channels
• Push notifications are now generally available
• Experimental support for batch REST publishing
• Access to the Ably DSX

See the complete release notes at https://blog.ably.io/ablys-client-library-sdks-1-1-release-8165c73c76fd

• Only make a single token request at a time
• Fix crash with react-native on some Android versions when making REST requests
• Tweak fallback host logic for connected realtime clients making REST requests

• Reinstate 'stop clientId forcing token auth' change (https://github.com/ably/ably-js/issues/542)
• Prioritise a tokenParam over an authParam of the same name
• Fix behaviour with multiple concurrent pings in-flight
• Use console.warn (if present) when logging at ERROR level
• Implement client-side-enforced maxMessageSize limit and bundling constraints
• Deduce streaming response from lack of content-length header even if no transfer-encoding

• Expose rest#setLog method to change log level or handler at runtime
• Allow jsonp for REST requests even if allowComet is false
• Expose Rest.Message for node, for consistency with Realtime.Message
• Add updateOnAttached channel option to force 'update' event even if resumed is true
• Stop a clientId from forcing token auth (https://github.com/ably/ably-js/issues/542)
  h Fix to NPM package creation that was unnecessarily bloating the package size

• Fix bug where connectionSerial was not getting reset after a resume failure (https://github.com/ably/ably-js/pull/540)

• Give presence.subscribe attach callback the same behaviour as channel.subscribe, for consistency (so it calls back once attached rather than only in the event of an attach error) (https://github.com/ably/ably-js/pull/526)
• Handle empty string response from an authUrl or authCallback as a token error
• Upgrade ws module to v5 (nodejs only) (https://github.com/ably/ably-js/pull/525)

Note: this release drops support for nodejs versions < 4.5. node v4 versions 4.5 or later are still supported; customers using node v4 are highly encouraged to update to the latest 4.x branch for security reasons

• Avoid xhr with local files on chrome 65+ (https://github.com/ably/ably-js/pull/490)
• Update websocket library on node
• Improvements to Rest#request error handling
• Update nodejs supported versions
• TypeScript namespace change (ablyLib -> Types -- https://github.com/ably/ably-js/pull/492)

Fix a regression in 1.0.12 related to resuming connections

• Fix Typescript definition files (https://github.com/ably/ably-js/pull/444)
• Fix sync connection when an upgrade fails (https://github.com/ably/ably-js/pull/445)
• Fix encryption on IE9 and IE10 (https://github.com/ably/ably-js/pull/453)
• Fix crash on Logger.LOG_ERROR (https://github.com/ably/ably-js/pull/439/files)
• The closeOnUnload option now defaults to true (https://github.com/ably/ably-js/pull/439)

• Allow Message#fromEncoded to take a short-form (key-only) cipherParams (https://github.com/ably/ably-js/pull/438)

[note: 1.0.10 skipped due to buggy version on npm used to create package; see https://github.com/npm/npm/issues/18870]

• Add ability for an auth server to trigger a client to move to the failed state by returning an HTTP 403 #434

• Enable transient publishes when publish is called on a channel that isn't already attached #430

• Fix bug where qs params provided in an authUrl were being discarded after first use #433

• Default to logging timestamps on all platforms

• Tweak websocket error log levels to avoid logging non-error closes at ERROR level

See https://www.ably.io/documentation/realtime/push for details on how to use Ably's native push notifications.

This PR adds push notification support to the Ably JS library.

Note that Push notifications support is currently in public beta. The API may change before the final release. Please report any bugs or feedback to [email protected]

Installation instructions

• Clone the repository (git clone https://github.com/ably/ably-js.git)
• Check out the push branch (git fetch origin push && git checkout push)
• For node: require nodejs/index.js from your code (e.g. const Ably = require('relative/path/to/ably-js/nodejs/index.js');)
• For browsers:
  • For webpack: require browser/static/ably.js from your code (e.g. const Ably = require('relative/path/to/ably-js/browser/static/ably.js');)
  • For use with a script tag: upload browser/static/ably.js somewhere accessible and source it as normal

Major update to this client library with some breaking changes. See https://blog.ably.io/v1-0-client-libraries-released-8a375dca7a26 for a summary of important, breaking changes and upgrade notes. Alteranatively, see the full changelog here.