Skip to content

Support policy ​

Versions ​

VersionStatusReceives
3.xCurrent, once releasedNew features and all fixes
2.xSupported for 12 months after 3.0 is generally availableSecurity 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.xIn 3.0
Chat: conversations, members, messages and their push parsingRemoved with no replacement. sendEphemeralEvent and sendCustomEvent remain available.
Persisted events: getConversationEvents, deleteEventRemoved with no replacement. Keep event history in your own backend.
Reconnecting, reconnection and session-error callbacksReplaced by a connectionStatus listener
SessionErrorReason.PingTimeout, SessionErrorCodes.PING_TIMEOUT_DISCONNECTRemoved. They are never reported.
isRetriable and retryAfter on errorsRemoved 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.

Built with VitePress.