@kindly-ai/react-native 1.0.16 → 1.0.17

package/ios/Frameworks/Kindly.xcframework/ios-arm64/Kindly.framework/Modules/Kindly.swiftmodule/arm64-apple-ios.private.swiftinterface

@@ -34,6 +34,25 @@ import _Concurrency
 import _StringProcessing
 import _SwiftConcurrencyShims
 import ObjectiveC.runtime
+@objc @_inheritsConvenienceInitializers open class KindlyNotificationServiceExtension : UserNotifications.UNNotificationServiceExtension {
+  @objc override dynamic public init()
+  @objc override dynamic open func didReceive(_ request: UserNotifications.UNNotificationRequest, withContentHandler contentHandler: @escaping (UserNotifications.UNNotificationContent) -> Swift.Void)
+  @objc override dynamic open func serviceExtensionTimeWillExpire()
+  open func customize(_ content: UserNotifications.UNMutableNotificationContent, payload: Kindly.KindlyPushDecryption.DecryptedPayload?)
+  @objc deinit
+}
+public enum KindlyPushDecryption {
+  public struct DecryptedPayload {
+    public let chatId: Swift.String
+    public let title: Swift.String
+    public let body: Swift.String
+    public init(chatId: Swift.String, title: Swift.String, body: Swift.String)
+  }
+  public static func isKindlyNotification(_ userInfo: [Swift.AnyHashable : Any]) -> Swift.Bool
+  public static func isDecrypted(_ userInfo: [Swift.AnyHashable : Any]) -> Swift.Bool
+  public static func apply(_ payload: Kindly.KindlyPushDecryption.DecryptedPayload, to content: UserNotifications.UNMutableNotificationContent)
+  public static func decrypt(userInfo: [Swift.AnyHashable : Any]) -> Kindly.KindlyPushDecryption.DecryptedPayload?
+}
 public struct ExternalChatMessage : Swift.Hashable, Swift.Identifiable, Swift.Comparable {
   public let id: Swift.String
   public static func < (lhs: Kindly.ExternalChatMessage, rhs: Kindly.ExternalChatMessage) -> Swift.Bool
@@ -58,6 +77,10 @@ public struct KindlySDKConfig {
     get
     set
   }
+  public var getAuthCredentials: Kindly.AuthCredentialsCallback? {
+    get
+    set
+  }
   public var allowCameraAccess: Swift.Bool
   public var allowPhotoLibraryAccess: Swift.Bool
   public var form: Kindly.KindlySDKConfig.FormConfig
@@ -359,6 +382,25 @@ final public class KindlyChatClient {
   public init(config: Kindly.CoreSDKConfig, behaviorType: Kindly.BehaviorTypeEnum)
   @objc deinit
 }
+public struct KindlyAuthCredentials {
+  public let idToken: Swift.String?
+  public let accessToken: Swift.String?
+  public let issuer: Swift.String?
+  public let expiresAt: Foundation.Date?
+  public init(idToken: Swift.String? = nil, accessToken: Swift.String? = nil, issuer: Swift.String? = nil, expiresAt: Foundation.Date? = nil)
+  public init(idToken: Swift.String? = nil, accessToken: Swift.String? = nil, issuer: Swift.String? = nil, expiresAtUnixSeconds: Swift.Int?)
+}
+extension Kindly.KindlyAuthCredentials {
+  public var bearerToken: Swift.String? {
+    get
+  }
+  public var hasToken: Swift.Bool {
+    get
+  }
+  public var companionAccessToken: Swift.String? {
+    get
+  }
+}
 @objc @_inheritsConvenienceInitializers public class NotificationDelegate : ObjectiveC.NSObject, UserNotifications.UNUserNotificationCenterDelegate {
   @objc public func userNotificationCenter(_ center: UserNotifications.UNUserNotificationCenter, willPresent notification: UserNotifications.UNNotification, withCompletionHandler completionHandler: @escaping (UserNotifications.UNNotificationPresentationOptions) -> Swift.Void)
   @objc public func userNotificationCenter(_ center: UserNotifications.UNUserNotificationCenter, didReceive response: UserNotifications.UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Swift.Void)
@@ -530,11 +572,16 @@ extension Kindly.KindlyChatClient {
   public static func setCustomTheme(_ theme: any Kindly.Theme)
   public static func setCustomTheme(background: UIKit.UIColor? = nil, botMessageBackground: UIKit.UIColor? = nil, botMessageText: UIKit.UIColor? = nil, buttonBackground: UIKit.UIColor? = nil, buttonOutline: UIKit.UIColor? = nil, buttonSelectedBackground: UIKit.UIColor? = nil, buttonText: UIKit.UIColor? = nil, defaultShadow: UIKit.UIColor? = nil, inputBackground: UIKit.UIColor? = nil, inputCursor: UIKit.UIColor? = nil, inputText: UIKit.UIColor? = nil, navBarBackground: UIKit.UIColor? = nil, navBarText: UIKit.UIColor? = nil, userMessageBackground: UIKit.UIColor? = nil, userMessageText: UIKit.UIColor? = nil)
   public static func clearCustomTheme()
+  public static var openChatOnNotificationTap: Swift.Bool {
+    get
+    set
+  }
   public static var enableCrashReporting: Swift.Bool {
     get
     set
   }
   final public class func start(botKey: Swift.String, languageCode: Swift.String = "en", market: Swift.String, authTokenCallback: Kindly.AuthTokenCallback? = nil)
+  final public class func start(botKey: Swift.String, languageCode: Swift.String = "en", market: Swift.String, authCredentialsCallback: @escaping Kindly.AuthCredentialsCallback)
   final public class func displayChat(languageCode: Swift.String? = nil, triggerDialogueId: Swift.String? = nil)
   final public func displayChat(languageCode: Swift.String? = nil, triggerDialogueId: Swift.String? = nil)
   final public class func setLanguage(_ languageCode: Swift.String) -> Kindly.Promise<Swift.Void>
@@ -549,7 +596,15 @@ extension Kindly.KindlyChatClient {
   @discardableResult
   final public class func saveAuthToken(_ token: Swift.String) -> Swift.Bool
   @discardableResult
+  final public class func saveAuthCredentials(_ credentials: Kindly.KindlyAuthCredentials) -> Swift.Bool
+  @discardableResult
+  final public class func authenticate() -> Kindly.Promise<Swift.Void>
+  @discardableResult
+  final public class func deauthenticate() -> Kindly.Promise<Swift.Void>
+  @discardableResult
   final public func saveAuthToken(_ token: Swift.String) -> Swift.Bool
+  @discardableResult
+  final public func saveAuthCredentials(_ credentials: Kindly.KindlyAuthCredentials) -> Swift.Bool
   final public class func closeChat()
   final public func closeChat()
   final public class func endChat() -> Kindly.Promise<Swift.Void>
@@ -557,6 +612,7 @@ extension Kindly.KindlyChatClient {
   final public func endChat() -> Kindly.Promise<Swift.Void>
   final public class func notificationReceived(_ userInfo: [Swift.AnyHashable : Any])
   final public class func notificationReceived(_ notification: UserNotifications.UNNotification)
+  final public class func notificationWillPresent(_ notification: UserNotifications.UNNotification, completionHandler: @escaping (UserNotifications.UNNotificationPresentationOptions) -> Swift.Void)
   final public class func notificationResponseReceived(_ response: UserNotifications.UNNotificationResponse)
   final public class func isKindlyNotification(_ userInfo: [Swift.AnyHashable : Any]) -> Swift.Bool
   final public class func triggerDialogue(id: Swift.String)
@@ -570,6 +626,7 @@ extension Kindly.KindlyChatClient {
   @_spi(Testing) final public class func _setVerboseLogs(_ enabled: Swift.Bool)
 }
 public typealias AuthTokenCallback = (_ chatId: Swift.String, _ promise: Kindly.Promise<Swift.String>) -> Swift.Void
+public typealias AuthCredentialsCallback = (_ chatId: Swift.String, _ promise: Kindly.Promise<Kindly.KindlyAuthCredentials>) -> Swift.Void
 extension Kindly.KindlyEventType : Swift.Equatable {}
 extension Kindly.KindlyEventType : Swift.Hashable {}
 extension Kindly.KindlyEventType : Swift.RawRepresentable {}

package/ios/Frameworks/Kindly.xcframework/ios-arm64/Kindly.framework/Modules/Kindly.swiftmodule/arm64-apple-ios.swiftinterface

@@ -34,6 +34,25 @@ import _Concurrency
 import _StringProcessing
 import _SwiftConcurrencyShims
 import ObjectiveC.runtime
+@objc @_inheritsConvenienceInitializers open class KindlyNotificationServiceExtension : UserNotifications.UNNotificationServiceExtension {
+  @objc override dynamic public init()
+  @objc override dynamic open func didReceive(_ request: UserNotifications.UNNotificationRequest, withContentHandler contentHandler: @escaping (UserNotifications.UNNotificationContent) -> Swift.Void)
+  @objc override dynamic open func serviceExtensionTimeWillExpire()
+  open func customize(_ content: UserNotifications.UNMutableNotificationContent, payload: Kindly.KindlyPushDecryption.DecryptedPayload?)
+  @objc deinit
+}
+public enum KindlyPushDecryption {
+  public struct DecryptedPayload {
+    public let chatId: Swift.String
+    public let title: Swift.String
+    public let body: Swift.String
+    public init(chatId: Swift.String, title: Swift.String, body: Swift.String)
+  }
+  public static func isKindlyNotification(_ userInfo: [Swift.AnyHashable : Any]) -> Swift.Bool
+  public static func isDecrypted(_ userInfo: [Swift.AnyHashable : Any]) -> Swift.Bool
+  public static func apply(_ payload: Kindly.KindlyPushDecryption.DecryptedPayload, to content: UserNotifications.UNMutableNotificationContent)
+  public static func decrypt(userInfo: [Swift.AnyHashable : Any]) -> Kindly.KindlyPushDecryption.DecryptedPayload?
+}
 public struct ExternalChatMessage : Swift.Hashable, Swift.Identifiable, Swift.Comparable {
   public let id: Swift.String
   public static func < (lhs: Kindly.ExternalChatMessage, rhs: Kindly.ExternalChatMessage) -> Swift.Bool
@@ -58,6 +77,10 @@ public struct KindlySDKConfig {
     get
     set
   }
+  public var getAuthCredentials: Kindly.AuthCredentialsCallback? {
+    get
+    set
+  }
   public var allowCameraAccess: Swift.Bool
   public var allowPhotoLibraryAccess: Swift.Bool
   public var form: Kindly.KindlySDKConfig.FormConfig
@@ -359,6 +382,25 @@ final public class KindlyChatClient {
   public init(config: Kindly.CoreSDKConfig, behaviorType: Kindly.BehaviorTypeEnum)
   @objc deinit
 }
+public struct KindlyAuthCredentials {
+  public let idToken: Swift.String?
+  public let accessToken: Swift.String?
+  public let issuer: Swift.String?
+  public let expiresAt: Foundation.Date?
+  public init(idToken: Swift.String? = nil, accessToken: Swift.String? = nil, issuer: Swift.String? = nil, expiresAt: Foundation.Date? = nil)
+  public init(idToken: Swift.String? = nil, accessToken: Swift.String? = nil, issuer: Swift.String? = nil, expiresAtUnixSeconds: Swift.Int?)
+}
+extension Kindly.KindlyAuthCredentials {
+  public var bearerToken: Swift.String? {
+    get
+  }
+  public var hasToken: Swift.Bool {
+    get
+  }
+  public var companionAccessToken: Swift.String? {
+    get
+  }
+}
 @objc @_inheritsConvenienceInitializers public class NotificationDelegate : ObjectiveC.NSObject, UserNotifications.UNUserNotificationCenterDelegate {
   @objc public func userNotificationCenter(_ center: UserNotifications.UNUserNotificationCenter, willPresent notification: UserNotifications.UNNotification, withCompletionHandler completionHandler: @escaping (UserNotifications.UNNotificationPresentationOptions) -> Swift.Void)
   @objc public func userNotificationCenter(_ center: UserNotifications.UNUserNotificationCenter, didReceive response: UserNotifications.UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Swift.Void)
@@ -530,11 +572,16 @@ extension Kindly.KindlyChatClient {
   public static func setCustomTheme(_ theme: any Kindly.Theme)
   public static func setCustomTheme(background: UIKit.UIColor? = nil, botMessageBackground: UIKit.UIColor? = nil, botMessageText: UIKit.UIColor? = nil, buttonBackground: UIKit.UIColor? = nil, buttonOutline: UIKit.UIColor? = nil, buttonSelectedBackground: UIKit.UIColor? = nil, buttonText: UIKit.UIColor? = nil, defaultShadow: UIKit.UIColor? = nil, inputBackground: UIKit.UIColor? = nil, inputCursor: UIKit.UIColor? = nil, inputText: UIKit.UIColor? = nil, navBarBackground: UIKit.UIColor? = nil, navBarText: UIKit.UIColor? = nil, userMessageBackground: UIKit.UIColor? = nil, userMessageText: UIKit.UIColor? = nil)
   public static func clearCustomTheme()
+  public static var openChatOnNotificationTap: Swift.Bool {
+    get
+    set
+  }
   public static var enableCrashReporting: Swift.Bool {
     get
     set
   }
   final public class func start(botKey: Swift.String, languageCode: Swift.String = "en", market: Swift.String, authTokenCallback: Kindly.AuthTokenCallback? = nil)
+  final public class func start(botKey: Swift.String, languageCode: Swift.String = "en", market: Swift.String, authCredentialsCallback: @escaping Kindly.AuthCredentialsCallback)
   final public class func displayChat(languageCode: Swift.String? = nil, triggerDialogueId: Swift.String? = nil)
   final public func displayChat(languageCode: Swift.String? = nil, triggerDialogueId: Swift.String? = nil)
   final public class func setLanguage(_ languageCode: Swift.String) -> Kindly.Promise<Swift.Void>
@@ -549,7 +596,15 @@ extension Kindly.KindlyChatClient {
   @discardableResult
   final public class func saveAuthToken(_ token: Swift.String) -> Swift.Bool
   @discardableResult
+  final public class func saveAuthCredentials(_ credentials: Kindly.KindlyAuthCredentials) -> Swift.Bool
+  @discardableResult
+  final public class func authenticate() -> Kindly.Promise<Swift.Void>
+  @discardableResult
+  final public class func deauthenticate() -> Kindly.Promise<Swift.Void>
+  @discardableResult
   final public func saveAuthToken(_ token: Swift.String) -> Swift.Bool
+  @discardableResult
+  final public func saveAuthCredentials(_ credentials: Kindly.KindlyAuthCredentials) -> Swift.Bool
   final public class func closeChat()
   final public func closeChat()
   final public class func endChat() -> Kindly.Promise<Swift.Void>
@@ -557,6 +612,7 @@ extension Kindly.KindlyChatClient {
   final public func endChat() -> Kindly.Promise<Swift.Void>
   final public class func notificationReceived(_ userInfo: [Swift.AnyHashable : Any])
   final public class func notificationReceived(_ notification: UserNotifications.UNNotification)
+  final public class func notificationWillPresent(_ notification: UserNotifications.UNNotification, completionHandler: @escaping (UserNotifications.UNNotificationPresentationOptions) -> Swift.Void)
   final public class func notificationResponseReceived(_ response: UserNotifications.UNNotificationResponse)
   final public class func isKindlyNotification(_ userInfo: [Swift.AnyHashable : Any]) -> Swift.Bool
   final public class func triggerDialogue(id: Swift.String)
@@ -564,6 +620,7 @@ extension Kindly.KindlyChatClient {
   final public class func handleURL(_ url: Foundation.URL) -> Swift.Bool
 }
 public typealias AuthTokenCallback = (_ chatId: Swift.String, _ promise: Kindly.Promise<Swift.String>) -> Swift.Void
+public typealias AuthCredentialsCallback = (_ chatId: Swift.String, _ promise: Kindly.Promise<Kindly.KindlyAuthCredentials>) -> Swift.Void
 extension Kindly.KindlyEventType : Swift.Equatable {}
 extension Kindly.KindlyEventType : Swift.Hashable {}
 extension Kindly.KindlyEventType : Swift.RawRepresentable {}

package/ios/Frameworks/Kindly.xcframework/ios-arm64/Kindly.framework/_CodeSignature/CodeResources

@@ -6,7 +6,7 @@
 	<dict>
 		<key>Assets.car</key>
 		<data>
-		pb8HRKALxN+PXhfWzC+ZJ15eX0A=
+		g/iQpg6yw6bapkTABm/wrvYielg=
 		</data>
 		<key>ConfirmationWindow.nib</key>
 		<data>
@@ -14,7 +14,7 @@
 		</data>
 		<key>Headers/Kindly-Swift.h</key>
 		<data>
-		MkdcxiJIF1FSwUGEQ1csSt0JKqc=
+		3Zfgp1jBhipvW2p35V5n16NIJX8=
 		</data>
 		<key>Headers/Kindly.h</key>
 		<data>
@@ -22,23 +22,23 @@
 		</data>
 		<key>Info.plist</key>
 		<data>
-		Wa9eyY/MGq54RoZAboTRZMRtIy0=
+		DmmTGzygRu8fSVG8/APVchLzRaY=
 		</data>
 		<key>Modules/Kindly.swiftmodule/arm64-apple-ios.abi.json</key>
 		<data>
-		+XHWpGh7XzLmYEOZgpIiGlIW2KU=
+		4fh4hwQeQgB4vHNRjYPn14q6tY8=
 		</data>
 		<key>Modules/Kindly.swiftmodule/arm64-apple-ios.private.swiftinterface</key>
 		<data>
-		xTpugXghnZqpvoYCEs8KnH96IFk=
+		zHWAtJHOELD1hCoPVpqtmb0uTXI=
 		</data>
 		<key>Modules/Kindly.swiftmodule/arm64-apple-ios.swiftdoc</key>
 		<data>
-		3yHMP84JCLmqlz9BGmfmPHFCjb0=
+		iFtvFC/4n3z3aFriXbGFA5zNmOg=
 		</data>
 		<key>Modules/Kindly.swiftmodule/arm64-apple-ios.swiftinterface</key>
 		<data>
-		1L3LlsNhkhqwd4POa0Yvv6IoMFU=
+		29KbsFrkosRtVMiI6qjE4ESQ93s=
 		</data>
 		<key>Modules/module.modulemap</key>
 		<data>
@@ -55,7 +55,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			ey78vbaAGGAofgnSK6XV7mHuSf7yN9GYnimtvVbGLAo=
+			0IzvkxxEyC2sfufBDkjNxvXr8Wdw/qgrGJIY9w4XcaA=
 			</data>
 		</dict>
 		<key>ConfirmationWindow.nib</key>
@@ -69,7 +69,7 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			YxAMOVVvyZa779b11gPAT8Y5BSZZNaV09T2kiojd7/8=
+			pTR2v29aeArstJ5kdfU5y3AYsu4+3KN3mubm9I4j7xg=
 			</data>
 		</dict>
 		<key>Headers/Kindly.h</key>
@@ -83,28 +83,28 @@
 		<dict>
 			<key>hash2</key>
 			<data>
-			TvZ102APlOaH6mmn4QYPIbh1vklIOToHBIy9f4a4f6w=
+			7+tJgRMzVjHlqgdMDleq7T3jIhCRBMwGa2gOoll7Z+c=
 			</data>
 		</dict>
 		<key>Modules/Kindly.swiftmodule/arm64-apple-ios.private.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			4JGKXAJllX0goCMwgcHA8aqLPjia8LR5GH/BhWqlBkc=
+			C1YxuU8Rl+Qb6LEljrrKCzm3vDT9Xhjo04e/EQ5qQAA=
 			</data>
 		</dict>
 		<key>Modules/Kindly.swiftmodule/arm64-apple-ios.swiftdoc</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			TMoN4OlAiIkKZxu/zkN7D68+nF5rngzEAjK9SMW5wHU=
+			dqFjfuRix8S2x5cmGCTNI7tTrk2/rVshW8BF7Udahpk=
 			</data>
 		</dict>
 		<key>Modules/Kindly.swiftmodule/arm64-apple-ios.swiftinterface</key>
 		<dict>
 			<key>hash2</key>
 			<data>
-			hZ+UsraJifENkHdcje/G97VxKkCB3wKZw71o0fd5Vwk=
+			gC0v7kTGJF8EuPXv+2h4u1evm9cYMxbkmXFPDQA9EiE=
 			</data>
 		</dict>
 		<key>Modules/module.modulemap</key>

package/ios/Frameworks/Kindly.xcframework/ios-arm64_x86_64-simulator/Kindly.framework/Headers/Kindly-Swift.h

@@ -370,11 +370,42 @@ extern "C" {
 
 #if defined(__OBJC__)
 
+@class UNNotificationRequest;
+@class UNNotificationContent;
+/// Base class for the host app’s Notification Service Extension.
+/// Subclass it in the extension target and nothing else is needed:
+/// \code
+/// import Kindly
+///
+/// final class NotificationService: KindlyNotificationServiceExtension {}
+///
+/// \endcodeiOS runs the extension for every push that carries <code>mutable-content: 1</code>, in every app state including
+/// when the app was killed. The extension decrypts the Kindly payload with the key the SDK stored in the
+/// shared keychain group during token registration, rewrites the title and body, and marks the content as
+/// decrypted so the SDK inside the app never shows it a second time. Pushes that are not Kindly’s, and
+/// Kindly pushes that cannot be decrypted (no key yet, device not unlocked since boot), are delivered
+/// unchanged, which for a Kindly push means the generic placeholder the backend put in <code>aps.alert</code>.
+/// Override <code>customize(_:payload:)</code> to add a category, thread identifier, attachments or a different sound.
+/// Hosts that already have their own extension for another provider keep it and call
+/// <code>KindlyPushDecryption/decrypt(userInfo:)</code> plus <code>KindlyPushDecryption/apply(_:to:)</code> themselves.
+/// Both the app target and the extension target need the same <code>keychain-access-groups</code> entitlement so
+/// the extension can read the key; see the push guide.
+SWIFT_CLASS("_TtC6Kindly34KindlyNotificationServiceExtension")
+@interface KindlyNotificationServiceExtension : UNNotificationServiceExtension
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+- (void)didReceiveNotificationRequest:(UNNotificationRequest * _Nonnull)request withContentHandler:(void (^ _Nonnull)(UNNotificationContent * _Nonnull))contentHandler;
+- (void)serviceExtensionTimeWillExpire;
+@end
+
 @class UNUserNotificationCenter;
 @class UNNotification;
 @class UNNotificationResponse;
 /// Handles push notification presentation and user interaction for the Kindly SDK.
 /// Set as <code>UNUserNotificationCenter.current().delegate</code> to let the SDK process Kindly notifications.
+/// Notifications that are not Kindly’s are presented with banner and sound, as before. For Kindly
+/// notifications the SDK decrypts, asks <code>KindlyChatClientDelegate.shouldHandleNotification</code>, shows nothing
+/// while the user is on the chat screen, presents content the Notification Service Extension already
+/// decrypted, and replaces a placeholder with its own decrypted banner when there is no extension.
 SWIFT_CLASS("_TtC6Kindly20NotificationDelegate")
 @interface NotificationDelegate : NSObject <UNUserNotificationCenterDelegate>
 - (void)userNotificationCenter:(UNUserNotificationCenter * _Nonnull)center willPresentNotification:(UNNotification * _Nonnull)notification withCompletionHandler:(void (^ _Nonnull)(UNNotificationPresentationOptions))completionHandler;
@@ -762,11 +793,42 @@ extern "C" {
 
 #if defined(__OBJC__)
 
+@class UNNotificationRequest;
+@class UNNotificationContent;
+/// Base class for the host app’s Notification Service Extension.
+/// Subclass it in the extension target and nothing else is needed:
+/// \code
+/// import Kindly
+///
+/// final class NotificationService: KindlyNotificationServiceExtension {}
+///
+/// \endcodeiOS runs the extension for every push that carries <code>mutable-content: 1</code>, in every app state including
+/// when the app was killed. The extension decrypts the Kindly payload with the key the SDK stored in the
+/// shared keychain group during token registration, rewrites the title and body, and marks the content as
+/// decrypted so the SDK inside the app never shows it a second time. Pushes that are not Kindly’s, and
+/// Kindly pushes that cannot be decrypted (no key yet, device not unlocked since boot), are delivered
+/// unchanged, which for a Kindly push means the generic placeholder the backend put in <code>aps.alert</code>.
+/// Override <code>customize(_:payload:)</code> to add a category, thread identifier, attachments or a different sound.
+/// Hosts that already have their own extension for another provider keep it and call
+/// <code>KindlyPushDecryption/decrypt(userInfo:)</code> plus <code>KindlyPushDecryption/apply(_:to:)</code> themselves.
+/// Both the app target and the extension target need the same <code>keychain-access-groups</code> entitlement so
+/// the extension can read the key; see the push guide.
+SWIFT_CLASS("_TtC6Kindly34KindlyNotificationServiceExtension")
+@interface KindlyNotificationServiceExtension : UNNotificationServiceExtension
+- (nonnull instancetype)init OBJC_DESIGNATED_INITIALIZER;
+- (void)didReceiveNotificationRequest:(UNNotificationRequest * _Nonnull)request withContentHandler:(void (^ _Nonnull)(UNNotificationContent * _Nonnull))contentHandler;
+- (void)serviceExtensionTimeWillExpire;
+@end
+
 @class UNUserNotificationCenter;
 @class UNNotification;
 @class UNNotificationResponse;
 /// Handles push notification presentation and user interaction for the Kindly SDK.
 /// Set as <code>UNUserNotificationCenter.current().delegate</code> to let the SDK process Kindly notifications.
+/// Notifications that are not Kindly’s are presented with banner and sound, as before. For Kindly
+/// notifications the SDK decrypts, asks <code>KindlyChatClientDelegate.shouldHandleNotification</code>, shows nothing
+/// while the user is on the chat screen, presents content the Notification Service Extension already
+/// decrypted, and replaces a placeholder with its own decrypted banner when there is no extension.
 SWIFT_CLASS("_TtC6Kindly20NotificationDelegate")
 @interface NotificationDelegate : NSObject <UNUserNotificationCenterDelegate>
 - (void)userNotificationCenter:(UNUserNotificationCenter * _Nonnull)center willPresentNotification:(UNNotification * _Nonnull)notification withCompletionHandler:(void (^ _Nonnull)(UNNotificationPresentationOptions))completionHandler;