uchara_sdk 1.0.2

Official Flutter SDK for the Uchara Chat Platform. Headless customer/visitor SDK for embedding realtime chat into Flutter apps: session init, conversations, messages, file uploads, transcript download [...]

Changelog

All notable changes to the uchara_sdk Flutter package are documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

1.0.2 - 2026-08-20

Added

• Automatic presence heartbeats while the visitor WebSocket is connected.
• Automatic visitor JWT refresh before expiry, with manual refreshSession() support.
• Token-aware WebSocket reconnects after visitor session rotation.

1.0.1 - 2026-08-06

Added

• VisitorSDK.restoreSession({conversationId, connect}) to restore a persisted visitor session from the TokenStore without re-authenticating.
• Realtime room ownership: the WebSocket automatically reconnects to the active conversation's room after startConversation or getActiveConversation, disposing the previous connection to avoid duplicate streams and resource leaks.
• Hardened WebSocket URL construction: apiUrl is parsed with Uri, the scheme is validated (http/https), and the path is set to /ws/visitor.
• getActiveConversation now treats known not-found error codes as "no active conversation" in addition to HTTP 404.

Changed

• sendMessage no longer sends the unsupported attachment_ids / attachments fields; those parameters are deprecated and ignored. Use uploadFile to send attachments.

1.0.0 - 2026-08-06

Added

• Initial public release of the headless Flutter SDK.
• VisitorSDK with session initialisation, conversations, messages, file uploads, transcript download, and conversation close.
• VisitorConfig and VisitorIdentity for configuration and identity metadata.
• Pluggable TokenStore with a default InMemoryTokenStore.
• Resilient WsClient with typed realtime events, keepalive pings, and bounded exponential-backoff reconnection.
• Structured error hierarchy rooted at UcharaException.
• HTTP client with response-envelope unwrapping, multipart uploads, and binary downloads.
• Comprehensive test suite using package:http MockClient and a fake WsSocket/connector.
• Runnable example/ Flutter app demonstrating init, conversations, messages, realtime, and dispose.