kindly 2.0.0

Kindly Chat SDK for Flutter - customer support chat widget for iOS and Android. Successor to the kindly_sdk package.

Changelog

2.0.0 - 2026-05-02

Renamed

The package has been renamed from kindly_sdk to kindly. This is the only breaking change in 2.0.0 — the public API surface is identical to what was being prepared as kindly_sdk 1.1.0. To migrate:

 dependencies:
-  kindly_sdk: ^1.0.1
+  kindly: ^2.0.0

-import 'package:kindly_sdk/kindly_sdk.dart';
+import 'package:kindly/kindly.dart';

Nothing else changes — KindlySDK.start(...), all theme calls, all event handlers continue to work identically.

The legacy kindly_sdk package is now discontinued on pub.dev with a successor pointer to this package; new releases happen here.

Added (carried over from never-published 1.1.0)

• KindlySDK.setLanguage(languageCode) — update language for the current session.
• KindlySDK.sendMessage(text, newContext: ...) — programmatically send a user message; resolves with the reconciled message map (id, text, created, sender).
• KindlySDK.kill() — completely tear down the SDK; complements endChat() which only ends the chat session.
• KindlySDK.handleUrl(url) — handle Kindly deep-link URLs (kindly://chat/dialogue/{id}).
• KindlySDK.callHandover(callback) — initiate handover to a human agent and receive a callback when the handover begins. Replaces the misnamed setHandoverCallback (kept as a deprecated alias).

Fixed (carried over from never-published 1.1.0)

• iOS: start() now actually wires the authTokenCallback through to the native SDK (previously hard-coded to nil).
• iOS: every method handler now invokes the real Kindly SDK — closeChat, endChat, setCustomTheme, setNewContext, clearNewContext, saveAuthToken, setAPNSDeviceToken, handleNotification, isKindlyNotification, triggerDialogue, setVerboseLogging, setCrashReporting, clearCustomTheme, isChatDisplayed were all stubbed.
• iOS: isChatDisplayed now reflects real state by subscribing to KindlySDK.state.
• Android: SDK imports are no longer commented out; placeholder AuthTokenCallback / CallbackHandover interfaces removed in favour of the real ones.
• Android: auth callback is now passed into ChatKindlySDK.start (previously created but discarded).
• Android: triggerDialogue, setVerboseLogging, setCrashReporting, saveNotificationToken were reading args from a non-existent map key — now read the bare argument as Dart sends it.
• Android: handleNotification / isKindlyNotification reconstruct a RemoteMessage from the data map so the SDK methods can be invoked.
• Android: handover callback signature aligned with the SDK's CallbackHandover.callHandover() (was (event, data)).

1.1.0 - 2026-05-01

Added

• KindlySDK.setLanguage(languageCode) — update language for the current session.
• KindlySDK.sendMessage(text, newContext: ...) — programmatically send a user message; resolves with the reconciled message map (id, text, created, sender).
• KindlySDK.kill() — completely tear down the SDK; complements endChat() which only ends the chat session.
• KindlySDK.handleUrl(url) — handle Kindly deep-link URLs (kindly://chat/dialogue/{id}).
• KindlySDK.callHandover(callback) — initiate handover to a human agent and receive a callback when the handover begins. Replaces the misnamed setHandoverCallback (kept as a deprecated alias).

Fixed

• iOS: start() now actually wires the authTokenCallback through to the native SDK (previously hard-coded to nil).
• iOS: every method handler now invokes the real Kindly SDK — closeChat, endChat, setCustomTheme, setNewContext, clearNewContext, saveAuthToken, setAPNSDeviceToken, handleNotification, isKindlyNotification, triggerDialogue, setVerboseLogging, setCrashReporting, clearCustomTheme, isChatDisplayed were all stubbed.
• iOS: isChatDisplayed now reflects real state by subscribing to KindlySDK.state.
• Android: SDK imports are no longer commented out; placeholder AuthTokenCallback / CallbackHandover interfaces removed in favour of the real ones.
• Android: auth callback is now passed into ChatKindlySDK.start (previously created but discarded).
• Android: triggerDialogue, setVerboseLogging, setCrashReporting, saveNotificationToken were reading args from a non-existent map key — now read the bare argument as Dart sends it.
• Android: handleNotification / isKindlyNotification reconstruct a RemoteMessage from the data map so the SDK methods can be invoked.
• Android: handover callback signature aligned with the SDK's CallbackHandover.callHandover() (was (event, data)).
• Example app & integration test imports fixed (package:kindly_sdk/kindly_sdk.dart).

Notes

• events and state streams from the native EntryPoints (Combine on iOS, Flow on Android) are not yet exposed on the Dart side. Adding them requires a Flutter EventChannel and is tracked for a follow-up release.
• KindlySDKInteraction (Android button-press / link-intercept / notification delegate) is not yet exposed on the Dart side.

1.0.1 - 2025-07-11

Documentation

• Updated README.md - removed Example and Support sections All notable changes to this project will be documented in this file.

1.0.0 - 2025-07-10

Initial Release

Features

• 🚀 Complete Flutter bridge to native Kindly Chat SDKs (iOS & Android)
• 🎨 Customizable themes with full color control
• 🔐 JWT authentication support with callback mechanism
• 🌍 Multi-language support
• 💬 Real-time chat functionality
• 📱 Native iOS and Android implementations
• 🔔 Push notification support (APNS for iOS, FCM for Android)
• 🎯 Dialogue triggering capabilities
• 📊 Context data support for personalized conversations
• 🐛 Crash reporting and verbose logging options

API Methods

• start() - Initialize the SDK with bot key and optional auth callback
• displayChat() - Show the chat interface
• launchChat() - Launch chat with optional dialogue trigger
• closeChat() - Close the chat interface
• endChat() - End the chat session completely
• setCustomTheme() - Customize chat appearance
• clearCustomTheme() - Reset to default theme (Android only)
• setNewContext() - Set contextual user data
• clearNewContext() - Clear context data
• saveAuthToken() - Save authentication token
• setAPNSDeviceToken() - Set iOS push notification token
• saveNotificationToken() - Set Android push notification token
• handleNotification() - Process incoming notifications
• isKindlyNotification() - Check if notification is from Kindly
• triggerDialogue() - Trigger specific dialogue
• clearTriggerDialogue() - Clear triggered dialogue (Android only)
• setHandoverCallback() - Set handover callback (Android only)
• isChatDisplayed - Check if chat is currently displayed
• setVerboseLogging() - Enable/disable verbose logging
• setCrashReporting() - Enable/disable crash reporting

Platform Support

• iOS 12.0+
• Android API Level 21+
• Flutter 2.0.0+

Dependencies

• Native Kindly iOS SDK (via CocoaPods/SPM)
• Native Kindly Android SDK (via JitPack)