1.1.0

Bug Fixes

• Connection Status: Added missing closing and closed states to the ConnectionStatus enum. Previously these states were incorrectly mapped to failed. #184

Note: If you are using an exhaustive when or switch statement over this enum, you’ll need to either handle
these new cases explicitly or add a default/else branch.

1.0.0

We are excited to announce that the Ably Chat SDK API is now stable.

The Chat SDK includes comprehensive support for:

• Chat rooms for 1:1, 1:many, many:1 and many:many participation
• Messages with full CRUD operations (create, read, update, delete)
• Presence to track online status of chat participants
• Occupancy for monitoring total connections and presence members
• Typing indicators for real-time typing awareness
• Room reactions for real-time room reactions
• Message reactions for reactions to specific messages
• Jetpack Compose extensions for seamless Android UI integration

We are committed to maintaining API stability and providing long-term support for v1.x releases.

Thank you to everyone who provided feedback during the preview releases!

0.10.0

What's Changed

Type Renaming: some type renamed for clarity and consistency with other SDKs:

• MessageOptions → MessagesOptions
• MessagesReactions → MessageReactions

0.9.0

What's Changed

The following features have been added in this release:

• Added get(serial: String) in Messages to fetch messages by serial.
• Added clientReactions in MessageReactions for filtering reaction summaries by client.
• chat-compose-extension promoted to stable The Jetpack Compose extension module has been promoted from experimental to stable status.

Breaking changes

This release includes several breaking changes:

• MessageAction enum no longer includes internal Meta and Summary values that were not part of the public API.
• Interface-based listeners have been replaced with Kotlin function types for a more idiomatic API.
• The Chat SDK now throws ChatException instead of AblyException for better error handling specificity.
• Status properties have been changed from current() function to current property for cleaner syntax.
• Import path changes: ErrorInfo, SummaryClientIdCounts, SummaryClientIdList, and MessageAction now import from com.ably.chat instead of other packages.

For detailed migration instructions, please refer to the Upgrading Guide.

0.8.0

What's Changed

The following features have been added in this release:

• Protocol v4 support Added support for Chat protocol v4, enabling enhanced message handling. #161
• Destructuring syntax Added destructuring syntax for subscription handling, providing more convenient API usage. #159
• Custom JSON implementation Replaced Gson with custom JSON implementation to reduce dependencies #160

Breaking changes

This release includes several breaking changes:

• Message structure has changed.
• Replaced Gson with a custom JSON interface.
• Presence Data must be a JsonObject.

For detailed migration instructions, please refer to the Upgrading Guide.

0.7.0

Full Changelog

What's Changed

• Enabling the SDK to run on JVM environments in addition to Android.
  This expands the SDK's compatibility to server-side applications, desktop applications,
  and other JVM-based platforms while maintaining the same chat functionality and API.

0.6.0

Full Changelog

What's Changed

Breaking Changes:

• Removes opinionated presence structure 150

0.5.0

Full Changelog

What's Changed

Breaking Changes:

• Renames Reaction to RoomReaction 144
• Renames RoomReaction.type to RoomReaction.name 144

0.4.0

Full Changelog

What's Changed

New features

The following features have been added in this release:

• Message reactions Added experimental support for message reactions. #139

Breaking changes

This release also includes several breaking changes:

• roomId has been renamed to name or roomName throughout the SDK to align terminology with other Ably SDKs #141
• Event restructuring in Occupancy, Room Reactions, and Presence to match the style used by messages and typing indicators #140
• Sending typing indicators and room reactions now requires the connection status to be Connected #140

For detailed migration instructions, please refer to the Upgrading Guide.

0.3.0

Full Changelog

What's Changed

• All Chat features now use a single underlying channel. This greatly simplifies the SDK whilst improving performance.

The following features have also been added in this release:

• Ephemeral typing indicators

Closed issues:

• Update to new Occupancy and Presence RoomOptions #129
• Implement/migrate to single channel #121

Merged pull requests:

• Added type to TypingEvent #131 (sacOO7)
• Feature/single channel integration #130 (sacOO7)
• [ECO-5242][CHADR-093] Implement ephemeral typing #122 (sacOO7)
• [ECO-5256] refactor: getting rid of data classes from public API #119 (ttypic)
• chore: turn on explicitApi for kotlin #114 (ttypic)
• [ECO-5231] Renamed ClientOptions to ChatClientOptions #113 (sacOO7)