Changelog for Dart SDK

## v6.0.1 *August 19, 2025* | Type | Changes | |------|----------| | **Fixed** | • Fixes package compatibility issues with web builds. | | **Modified** | • Allow global custom logger to be ILogger based.<br/>• Upgrade outdated dependencies. | ## v6.0.0 *August 6, 2025* | Type | Changes | |------|----------| | **Added** | • Added support for `RetryPolicy.none()` to disable retry for subscription.<br/>• BREAKING CHANGES: The default retry policy has been changed from applying to all operations to now applying only to the subscription feature. | | **Modified** | • Enhanced logging using standardized logging practices. | ## v5.2.1 *June 25, 2025* | Type | Changes | |------|----------| | **Fixed** | • Update and validation for `custom` field data type of app context apis to prevent accepting non scalar value.<br/>• Added validation for channel and file names to prevent potential various path traversal techniques. | ## v5.2.0 *March 12, 2025* | Type | Changes | |------|----------| | **Added** | • Added Support of `eTag` for AppContext `setUUIDMetadata` and `setChannelMetadata` APIs. | ## v5.1.1 *January 20, 2025* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of getting error for setUUIDMetadata call without `custom` field. | ## v5.1.0 *December 18, 2024* | Type | Changes | |------|----------| | **Added** | • Added support for `status` and `type` fields in AppContext APIs. | ## v5.0.0 *December 10, 2024* | Type | Changes | |------|----------| | **Added** | • BREAKING CHANGES: Default retry policy for subscription is set to Exponential.<br/>• support for customMessageType in subscription, history, publish, signal and files features. | | **Fixed** | • Limiting delay to maximum allowable value for Linear retry policy. | ## v4.3.4 *April 15, 2024* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of parsing invalid presence data (which are not from pubnub server) in subscription. | ## v4.3.3 *March 28, 2024* | Type | Changes | |------|----------| | **Added** | • Added support for pagination params for listChannels API of push notification devices. | ## v4.3.2 *January 22, 2024* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of getting signature mismatch exception while publishing encrypted data. | ## v4.3.1 *November 27, 2023* | Type | Changes | |------|----------| | **Fixed** | • Handle unencrypted message while getting messages with cryptoModule configured. | ## v4.3.0 *October 16, 2023* | Type | Changes | |------|----------| | **Added** | • Add crypto module that allows configure SDK to encrypt and decrypt messages. | | **Fixed** | • Improved security of crypto implementation by adding enhanced AES-CBC cryptor. | ## v4.2.4 *July 27, 2023* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of missing decrypt function in batch history api. | ## v4.2.3 *May 18, 2023* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of losing timetoken value precision in web environment. | ## v4.2.2 *November 14, 2022* | Type | Changes | |------|----------| | **Added** | • Support for Flutter 3. | | **Fixed** | • Fixes issue of having old version of xml package dependency. | ## v4.2.1 *July 12, 2022* | Type | Changes | |------|----------| | **Added** | • Support for fire in publish feature.<br/>• Allow to specify access rights for user and space in grantToken request.<br/>• Allow users to specify userId instead of uuid. | ## v4.2.0 *May 30, 2022* | Type | Changes | |------|----------| | **Added** | • Adds two presence methods, setState and getState. | ## v4.1.3 *April 21, 2022* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of `fetchMessages` with false includeUUID response parse error.<br/>• Fixes issue of publish file message not triggered on browser. | ## v4.1.2 *April 6, 2022* | Type | Changes | |------|----------| | **Fixed** | • Adds a fix that prevents the SDK from adding forbidden headers in browser environments.<br/>• Fixes getFileUrl method by adding uuid in query parameters. | ## v4.1.1 *April 4, 2022* | Type | Changes | |------|----------| | **Fixed** | • Fixes an issue in JS build of Dart SDK, where request bodies were improperly encoded and sent without a correct header. | ## v4.1.0 *December 16, 2021* | Type | Changes | |------|----------| | **Added** | • Added support for Revoke Token feature. | ## v4.0.0 *November 22, 2021* | Type | Changes | |------|----------| | **Added** | • Adds PAM v3 support with `grantToken` and `setToken`.<br/>• After subscribe loop fails, call restore to restart it. | | **Fixed** | • Subscribe loop no longer throws on unrecoverable failure, instead waits for restart.<br/>• Adds more diagnostics for network module.<br/>• WhenStarts future no longer throws and is now based on a stream.<br/>• Networking should now release all resources after a failure.<br/>• Fixes issue of Signature mismatch with PAM enabled keysets.<br/>• Fixes issue of message decryption with subscription. | ## v3.1.0 *February 16, 2021* | Type | Changes | |------|----------| | **Added** | • Adds signature generation and Objects v2 for PAM Grant call.<br/>• Refactors networking module to use native dart:io. | | **Fixed** | • Fixes few typos and a bug with BatchHistory meta param.<br/>• Fixes an issue with default params for HereNow call.<br/>• Fixes an issue with encoding of uri query parameters.<br/>• Fixes message decryption in subscribe loop. | ## v3.0.0 *October 8, 2020* | Type | Changes | |------|----------| | **Modified** | • Subscribe loop is now written using async generator and should be easier to debug.<br/>• Exports now are more comprehensive and clear, documentation clarity has been improved. | | **Fixed** | • Removes additional query params from AWS calls.<br/>• Fixes a bunch of issues with incorrect arguments passed in.<br/>• Adds additional diagnostics to the networking module. | ## v2.0.1 *September 7, 2020* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of upgrade failure. | ## v2.0.0 *August 31, 2020* | Type | Changes | |------|----------| | **Added** | • Refactors networking module to allow additional flexibility.<br/>• Adds supervisor module that allows reconnection, retry and other additional, cross module functionalities.<br/>• Adds meta parameter to publish call and makes publish using GET instead of POST. | | **Fixed** | • Exposes `batch`, `objects` and other APIs from the PubNub class.<br/>• Fixes a typo in BatchHistory where timetoken was returned null. | ## v1.4.4 *August 19, 2020* | Type | Changes | |------|----------| | **Added** | • Add flags in history v3 for including messageType and uuid.<br/>• Add support for fetch history with message actions. | | **Modified** | • Refactor for error message parsing for files. | ## v1.4.3 *August 5, 2020* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of exception from server when publishKey is null with publish call.<br/>• Fixes missing url component in file publish message for sendFile and support for message encryption. | ## v1.4.2 *July 27, 2020* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of invalid type argument for fcm push gateway type. | ## v1.4.1 *July 24, 2020* | Type | Changes | |------|----------| | **Fixed** | • Fixes issue of missing exposed MessageType enum. | ## v1.4.0 *July 23, 2020* | Type | Changes | |------|----------| | **Added** | • Add file apis to support file feature. | | **Modified** | • Add support for random initialization vector for messages and file. | ## v1.3.0 *June 25, 2020* | Type | Changes | |------|----------| | **Added** | • Add message encryption support. | ## v1.2.0 *June 10, 2020* | Type | Changes | |------|----------| | **Added** | • Add simplified Objects API support with UUID and Channel metadata / membership management. | | **Fixed** | • Fixes missing PushGateway type support of fcm for Push Notification. | ## v1.1.3 *May 11, 2020* | Type | Changes | |------|----------| | **Fixed** | • Fixes unsubscribeAll so its no longer modifying subscription list during iteration.<br/>• Fixes exports to include presence and channel group results. | ## v1.1.2 *May 6, 2020* | Type | Changes | |------|----------| | **Fixed** | • Fixes issues of missing types for objects and push-notification. | ## v1.1.1 *May 6, 2020* | Type | Changes | |------|----------| | **Fixed** | • Expose missing types. | ## v1.1.0 *May 5, 2020* | Type | Changes | |------|----------| | **Fixed** | • Refactors logging to rely on Zones.<br/>• Fixes issues with resubscribing and improves injectLogger. | ## v1.0.5 *May 4, 2020* | Type | Changes | |------|----------| | **Fixed** | • Fix wrong API Uri in Push Notifications.<br/>• Fix Subscription.unsubscribe to correctly close the messages stream. | ## v1.0.4 *April 27, 2020* | Type | Changes | |------|----------| | **Added** | • Add HereNow to PresenceDx, usable as `pubnub.hereNow()`. | | **Fixed** | • Fix subscribe `withPresence: true` not properly forwarding messages when used with wildcard channels. | ## v1.0.3 *April 22, 2020* | Type | Changes | |------|----------| | **Fixed** | • Change all Symbols to Strings to support Flutter better, fix a typo in SubscribeParams preventing subscribe from working. | ## v1.0.2 *April 18, 2020* | Type | Changes | |------|----------| | **Modified** | • Add backward synchronization to private repository for `pubspec.yaml` and `lib/src/core/core.dart`.<br/>• Prevent tests from breaking when version is bumped. | ## v1.0.1 *April 18, 2020* | Type | Changes | |------|----------| | **Modified** | • Refactor PAM, hide logger instances and clean up tests.<br/>• Add `package:pedantic` config to analysis, fix lint issues. | | **Fixed** | • Ensure()isEqual now uses correct template.<br/>• Add PAM to library exports.<br/>• Consistently use PubNubversion in tests. | ## v1.0.0 *April 15, 2020* | Type | Changes | |------|----------| | **Added** | • Add ability to fetch current PubNub timetoken.<br/>• Add ability to publish messages and signals to channels and channel groups.<br/>• Add ability to subscribe to channels and channel groups.<br/>• Add ability to manage Objects (Spaces, Users and Memberships).<br/>• Add ability to manage PubNub Access Manager.<br/>• Add ability to manage device registration for Push Notification Service.<br/>• Add ability to add, delete and retrieve message actions.<br/>• Add channel and channel group abstractions to allow using History. |

v6.0.1

August 19, 2025
Fixed
  • Fixes package compatibility issues with web builds.
Modified
  • Allow global custom logger to be ILogger based.
  • Upgrade outdated dependencies.

v6.0.0

August 6, 2025
Added
  • Added support for RetryPolicy.none() to disable retry for subscription.
  • BREAKING CHANGES: The default retry policy has been changed from applying to all operations to now applying only to the subscription feature.
Modified
  • Enhanced logging using standardized logging practices.

v5.2.1

June 25, 2025
Fixed
  • Update and validation for custom field data type of app context apis to prevent accepting non scalar value.
  • Added validation for channel and file names to prevent potential various path traversal techniques.

v5.2.0

March 12, 2025
Added
  • Added Support of eTag for AppContext setUUIDMetadata and setChannelMetadata APIs.

v5.1.1

January 20, 2025
Fixed
  • Fixes issue of getting error for setUUIDMetadata call without custom field.

v5.1.0

December 18, 2024
Added
  • Added support for status and type fields in AppContext APIs.

v5.0.0

December 10, 2024
Added
  • BREAKING CHANGES: Default retry policy for subscription is set to Exponential.
  • support for customMessageType in subscription, history, publish, signal and files features.
Fixed
  • Limiting delay to maximum allowable value for Linear retry policy.

v4.3.4

April 15, 2024
Fixed
  • Fixes issue of parsing invalid presence data (which are not from pubnub server) in subscription.

v4.3.3

March 28, 2024
Added
  • Added support for pagination params for listChannels API of push notification devices.

v4.3.2

January 22, 2024
Fixed
  • Fixes issue of getting signature mismatch exception while publishing encrypted data.

v4.3.1

November 27, 2023
Fixed
  • Handle unencrypted message while getting messages with cryptoModule configured.

v4.3.0

October 16, 2023
Added
  • Add crypto module that allows configure SDK to encrypt and decrypt messages.
Fixed
  • Improved security of crypto implementation by adding enhanced AES-CBC cryptor.

v4.2.4

July 27, 2023
Fixed
  • Fixes issue of missing decrypt function in batch history api.

v4.2.3

May 18, 2023
Fixed
  • Fixes issue of losing timetoken value precision in web environment.

v4.2.2

November 14, 2022
Added
  • Support for Flutter 3.
Fixed
  • Fixes issue of having old version of xml package dependency.

v4.2.1

July 12, 2022
Added
  • Support for fire in publish feature.
  • Allow to specify access rights for user and space in grantToken request.
  • Allow users to specify userId instead of uuid.

v4.2.0

May 30, 2022
Added
  • Adds two presence methods, setState and getState.

v4.1.3

April 21, 2022
Fixed
  • Fixes issue of fetchMessages with false includeUUID response parse error.
  • Fixes issue of publish file message not triggered on browser.

v4.1.2

April 6, 2022
Fixed
  • Adds a fix that prevents the SDK from adding forbidden headers in browser environments.
  • Fixes getFileUrl method by adding uuid in query parameters.

v4.1.1

April 4, 2022
Fixed
  • Fixes an issue in JS build of Dart SDK, where request bodies were improperly encoded and sent without a correct header.

v4.1.0

December 16, 2021
Added
  • Added support for Revoke Token feature.

v4.0.0

November 22, 2021
Added
  • Adds PAM v3 support with grantToken and setToken.
  • After subscribe loop fails, call restore to restart it.
Fixed
  • Subscribe loop no longer throws on unrecoverable failure, instead waits for restart.
  • Adds more diagnostics for network module.
  • WhenStarts future no longer throws and is now based on a stream.
  • Networking should now release all resources after a failure.
  • Fixes issue of Signature mismatch with PAM enabled keysets.
  • Fixes issue of message decryption with subscription.

v3.1.0

February 16, 2021
Added
  • Adds signature generation and Objects v2 for PAM Grant call.
  • Refactors networking module to use native dart:io.
Fixed
  • Fixes few typos and a bug with BatchHistory meta param.
  • Fixes an issue with default params for HereNow call.
  • Fixes an issue with encoding of uri query parameters.
  • Fixes message decryption in subscribe loop.

v3.0.0

October 8, 2020
Modified
  • Subscribe loop is now written using async generator and should be easier to debug.
  • Exports now are more comprehensive and clear, documentation clarity has been improved.
Fixed
  • Removes additional query params from AWS calls.
  • Fixes a bunch of issues with incorrect arguments passed in.
  • Adds additional diagnostics to the networking module.

v2.0.1

September 7, 2020
Fixed
  • Fixes issue of upgrade failure.

v2.0.0

August 31, 2020
Added
  • Refactors networking module to allow additional flexibility.
  • Adds supervisor module that allows reconnection, retry and other additional, cross module functionalities.
  • Adds meta parameter to publish call and makes publish using GET instead of POST.
Fixed
  • Exposes batch, objects and other APIs from the PubNub class.
  • Fixes a typo in BatchHistory where timetoken was returned null.

v1.4.4

August 19, 2020
Added
  • Add flags in history v3 for including messageType and uuid.
  • Add support for fetch history with message actions.
Modified
  • Refactor for error message parsing for files.

v1.4.3

August 5, 2020
Fixed
  • Fixes issue of exception from server when publishKey is null with publish call.
  • Fixes missing url component in file publish message for sendFile and support for message encryption.

v1.4.2

July 27, 2020
Fixed
  • Fixes issue of invalid type argument for fcm push gateway type.

v1.4.1

July 24, 2020
Fixed
  • Fixes issue of missing exposed MessageType enum.

v1.4.0

July 23, 2020
Added
  • Add file apis to support file feature.
Modified
  • Add support for random initialization vector for messages and file.

v1.3.0

June 25, 2020
Added
  • Add message encryption support.

v1.2.0

June 10, 2020
Added
  • Add simplified Objects API support with UUID and Channel metadata / membership management.
Fixed
  • Fixes missing PushGateway type support of fcm for Push Notification.

v1.1.3

May 11, 2020
Fixed
  • Fixes unsubscribeAll so its no longer modifying subscription list during iteration.
  • Fixes exports to include presence and channel group results.

v1.1.2

May 6, 2020
Fixed
  • Fixes issues of missing types for objects and push-notification.

v1.1.1

May 6, 2020
Fixed
  • Expose missing types.

v1.1.0

May 5, 2020
Fixed
  • Refactors logging to rely on Zones.
  • Fixes issues with resubscribing and improves injectLogger.

v1.0.5

May 4, 2020
Fixed
  • Fix wrong API Uri in Push Notifications.
  • Fix Subscription.unsubscribe to correctly close the messages stream.

v1.0.4

April 27, 2020
Added
  • Add HereNow to PresenceDx, usable as pubnub.hereNow().
Fixed
  • Fix subscribe withPresence: true not properly forwarding messages when used with wildcard channels.

v1.0.3

April 22, 2020
Fixed
  • Change all Symbols to Strings to support Flutter better, fix a typo in SubscribeParams preventing subscribe from working.

v1.0.2

April 18, 2020
Modified
  • Add backward synchronization to private repository for pubspec.yaml and lib/src/core/core.dart.
  • Prevent tests from breaking when version is bumped.

v1.0.1

April 18, 2020
Modified
  • Refactor PAM, hide logger instances and clean up tests.
  • Add package:pedantic config to analysis, fix lint issues.
Fixed
  • Ensure()isEqual now uses correct template.
  • Add PAM to library exports.
  • Consistently use PubNubversion in tests.

v1.0.0

April 15, 2020
Added
  • Add ability to fetch current PubNub timetoken.
  • Add ability to publish messages and signals to channels and channel groups.
  • Add ability to subscribe to channels and channel groups.
  • Add ability to manage Objects (Spaces, Users and Memberships).
  • Add ability to manage PubNub Access Manager.
  • Add ability to manage device registration for Push Notification Service.
  • Add ability to add, delete and retrieve message actions.
  • Add channel and channel group abstractions to allow using History.
Last updated on
On this page