ably - npm Package Versions

published 2.0.4-channel-groups • 9 months ago

2.0.3-channel-groups

published 2.0.3-channel-groups • 9 months ago

2.0.2

published 2.0.2 • 9 months ago

Changelog

2.0.2 (2024-04-08)

Fix an issue with realtime connections using the bun runtime #1716

2.0.1

published 2.0.1 • 9 months ago

Changelog

2.0.1 (2024-03-25)

Fix Unable to resolve "ably" in React Native for ably-js v2.0.0 #1711
Fix TextEncoder/TextDecoder are not defined in React Native for ably-js v2.0.0 #1712

2.0.0

published 2.0.0 • 9 months ago

Changelog

2.0.0 (2024-03-22)

The 2.0.0 release introduces a number of new features and QoL improvements, including a new way to remove bloat and reduce the bundle size of your ably-js client, first-class support for Promises, a more idiomatic approach to using ably-js' React Hooks, enhancements to TypeScript typings, and more.

Below is an overview of the major changes in this release.

Please refer to the ably-js v2 lib migration guide and React Hooks migration guide for the full details, including a list of all breaking changes and instructions on how to address them.

Bundle Size Reduction

The default bundle size for the web has been reduced by ~32% compared to v1 - from 234.11 KiB to 159.32 KiB. When calculated with gzip compression, the reduction is ~30%, from 82.54 KiB to 57.9 KiB.

Additionally, by utilizing the new modular variant of the library (see below) and JavaScript tree shaking, you can create your own minimal useful Realtime client and achieve a bundle size reduction of ~60.5% compared to v1 - from 234.11 KiB to 92.38 KiB (or ~66% for gzip: from 82.54 KiB to 28.18 KiB).

Modular variant of the library

An ESM variant of the library is now available for browsers (but not for Node.js) via import from ably/modular. This modular variant of the library supports tree shaking, allowing for a reduction in the Ably bundle size within your application and improving the user experience. It can also be used by Web Workers.

React Hooks changes

React Hooks, exported at ably/react, now require the new ChannelProvider component to define the channels you wish to use and the options for them. This addresses the complexities previously encountered with useChannel and usePresence hooks when attempting to dynamically change options for a channel and provides a more straightforward approach to set and manage these options.

The functionality of the usePresence hook has been split into two separate hooks: usePresence, which is now used only to enter presence, and usePresenceListener, which is used to listen for presence updates. These new hooks offer better control over the desired presence behavior in your React components.

First-class support for Promises

The callbacks API has been entirely removed, and the library now supports promises for all its asynchronous operations by default.

TypeScript typings

The Types namespace has been removed. All types it contained are now exported at the top level.

Browser and Web Worker bundles

The browser bundle now relies on the native Web Crypto API instead of CryptoJS. The ably/build/ably.noencryption bundle has been removed, as it is no longer necessary.
The browser bundle can now be directly used by Web Workers. The ably/build/ably-webworker bundle has been removed, as it is no longer necessary.

Supported platforms changes

Support for Internet Explorer has been dropped.
Support for Node.js versions lower than 16 has been dropped. The supported Node.js versions are now 16, 18, and 20.
The minimum supported versions for major browsers are: Chrome 58, Firefox 52, Edge 79, Safari 11, and Opera 45.

<details> <summary><b>View merged Pull Requests</b></summary>

Breaking Changes

Add ChannelProvider component to React Hooks #1620, #1654
Add untyped stats API #1522
Add type definitions for key returned by generateRandomKey #1320
Add mandatory version param to Rest.request #1231
Change id field to be named ablyId in React Hooks #1676
Change usePresence hook to two different hooks: for entering presence and subscribing to presence updates #1674
Change naming for enum-like namespaces in type declarations and change meaning for public ChannelModes type #1601
Change publishing methods to accept a Message-shaped object #1515
Change Crypto.generateRandomKey API to use Promises #1351
Change fromEncoded() and fromEncodedArray() methods on Message and PresenceMessage to be async #1311
Remove XHRStreaming transport support #1645
Remove code that's supporting older platforms #1629, #1633, #1641
Remove recoveryKey in favour of createRecoveryKey() on Connection #1613
Remove any from stats() param type #1561
Remove the dedicated Web Worker bundle ably/build/ably-webworker and add support for using ably and ably/modular in Web Workers #1550
Remove false class exports in type declarations #1524
Remove the Types namespace #1518
Remove noencryption variant of the library #1500
Remove public callbacks API #1358
Remove CryptoJS library and replace it with the Web Crypto API in web bundle #1299, #1325, #1333
Remove ably-commonjs*.js files #1229
Remove deprecated APIs #1227
Remove deprecated fromEncoded* type declarations #1222
Remove deprecated ClientOptions parameters #1221
Remove the ClientOptions.log property and replace it with separate logLevel and logHandler properties #1216
Remove support for JSONP #1215
Fix whenState inconsistent behavior in Connection and RealtimeChannel #1640
Fix the type definition of Crypto.getDefaultParams #1352

Features

Add publish function to the useChannel hook #1658
Add logs to all HTTP activity #1581

</details>

Full Changelog

1.2.50

published 1.2.50 • 9 months ago

Changelog

1.2.50 (2024-03-21)

Add new logging API to ClientOptions and add a deprecation warning for the old one #1671
Add ClientOptions.maxMessageSize to the public API #1678
Add a deprecation warning for the headers client option #1681
Improve deprecation log messages #1683, #1685
Handle 204 status code in PaginatedResource #1631
Fix typing and deprecation warning for Crypto.getDefaultParams() #1693

2.0.2-channel-groups