Support policy
Versions
| Version | Status | Receives |
|---|---|---|
| 3.x | Current, once released | New features and all fixes |
| 2.x | Supported for 12 months after 3.0 is generally available | Security and critical fixes only |
Preparing for 3.0
Before 3.0, every 2.x API that 3.0 removes or reshapes is marked deprecated on every platform: Kotlin @Deprecated, Objective-C and Swift deprecation attributes, and TypeScript @deprecated. Update to the latest 2.x release and your build reports a warning at each use. The message names the 3.0 replacement, so the warnings are the list of changes to make before you upgrade.
| Deprecated in 2.x | In 3.0 |
|---|---|
| Chat: conversations, members, messages and their push parsing | Removed with no replacement. sendEphemeralEvent and sendCustomEvent remain available. |
Persisted events: getConversationEvents, deleteEvent | Removed with no replacement. Keep event history in your own backend. |
| Reconnecting, reconnection and session-error callbacks | Replaced by a connectionStatus listener |
SessionErrorReason.PingTimeout, SessionErrorCodes.PING_TIMEOUT_DISCONNECT | Removed. They are never reported. |
isRetriable and retryAfter on errors | Removed with no replacement |
cancelConnectivityReport() | Replaced by native cancellation: cancel the coroutine or Swift Task, or pass an AbortSignal on Web |
CocoaPods
The Client SDK is no longer published to CocoaPods, which becomes permanently read-only on 2 December 2026. 2.10.1 is the last version on CocoaPods trunk. Move to Swift Package Manager to keep receiving 2.x fixes.