feat: rich push deep links

Package.swift

@@ -11,7 +11,7 @@ import PackageDescription
 let package = Package(
     name: "Customer.io",
     platforms: [
-        .iOS(.v9)
+        .iOS(.v13)
     ],
     products: [ // externally visible products for clients to install. 
         // library name is the name given when installing the SDK. 

README.md

@@ -5,7 +5,7 @@
 [s-cioerrorparse]: https://github.com/customerio/RemoteHabits-iOS/blob/1.0.0/Remote%20Habits/Util/CustomerIOErrorUtil.swift
 
 ![min swift version is 5.3](https://img.shields.io/badge/min%20Swift%20version-5.3-orange)
-![min ios version is 9](https://img.shields.io/badge/min%20iOS%20version-9-blue)
+![min ios version is 13](https://img.shields.io/badge/min%20iOS%20version-13-blue)
 [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg)](code_of_conduct.md) 
 
 # Customer.io iOS SDK

Sources/MessagingPush/MessagingPush+NotificationCenter.swift

@@ -0,0 +1,39 @@
+import Foundation
+#if canImport(UserNotifications) && canImport(UIKit)
+import UIKit
+import UserNotifications
+
+/**
+ For rich push handling. Methods to call when a rich push UI is interacted with.
+ */
+public extension MessagingPush {
+    /**
+     A push notification was interacted with.
+
+     - returns: If the SDK called the completion handler for you indicating if the SDK took care of the request or not.
+     */
+    func userNotificationCenter(
+        _ center: UNUserNotificationCenter,
+        didReceive response: UNNotificationResponse,
+        withCompletionHandler completionHandler: @escaping () -> Void
+    ) -> Bool {
+        guard let pushContent = PushContent.parse(notificationContent: response.notification.request.content) else {
+            return false
+        }
+
+        switch response.actionIdentifier {
+        case UNNotificationDefaultActionIdentifier: // push notification was touched.
+            if let deepLinkurl = pushContent.deepLink {
+                UIApplication.shared.open(url: deepLinkurl)
+
+                completionHandler()
+
+                return true
+            }
+        default: break
+        }
+
+        return false
+    }
+}
+#endif

Sources/MessagingPush/PushContent.swift

@@ -0,0 +1,63 @@
+import Foundation
+#if canImport(UserNotifications)
+import UserNotifications
+
+/**
+ The content of a push notification. Single source of truth for getting and setting properties of a push notification.
+
+ Meant to be used by the SDK to set/get the push content but also designed for SDK user to further modify the push
+ if they wish.
+ */
+public class PushContent {
+    public var title: String {
+        didSet {
+            modifyNotificationContent()
+        }
+    }
+
+    public var body: String {
+        didSet {
+            modifyNotificationContent()
+        }
+    }
+
+    public var deepLink: URL? {
+        didSet {
+            modifyNotificationContent()
+        }
+    }
+
+    public let mutableNotificationContent: UNMutableNotificationContent?
+
+    public static func parse(notificationContent: UNNotificationContent) -> PushContent? {
+        let raw = notificationContent.userInfo
+
+        guard let cio = raw["CIO"] as? [AnyHashable: Any], let cioPush = cio["push"] as? [AnyHashable: Any] else {
+            // Not a push sent by Customer.io
+            return nil
+        }
+
+        return PushContent(notificationContent: notificationContent, cio: cio, cioPush: cioPush)
+    }
+
+    // Used when modifying push content before showing and for parsing after displaying.
+    public init(notificationContent: UNNotificationContent, cio: [AnyHashable: Any], cioPush: [AnyHashable: Any]) {
+        self.mutableNotificationContent = notificationContent.mutableCopy() as? UNMutableNotificationContent
+
+        // For parsing after displaying, populate based off of content known now.
+        self.title = notificationContent.title
+        self.body = notificationContent.body
+        self.deepLink = (cioPush["link"] as? String)?.url
+    }
+
+    private func modifyNotificationContent() {
+        mutableNotificationContent?.title = title
+        mutableNotificationContent?.body = body
+
+        let cioMutableContent = mutableNotificationContent?.userInfo["CIO"] as? [AnyHashable: Any]
+        var cioPushMutableContent = cioMutableContent?["push"] as? [AnyHashable: Any]
+
+        cioPushMutableContent?["link"] = deepLink?.absoluteString
+    }
+}
+#endif

Sources/MessagingPushAPN/RichPush/MessagingPush+NotificationServiceExtension.swift

@@ -0,0 +1,38 @@
+import CioMessagingPush
+import Foundation
+#if canImport(UserNotifications)
+import UserNotifications
+
+/**
+ Functions called in app's Notification Service target.
+ */
+public extension MessagingPush {
+    /**
+     - returns:
+     Bool indicating if this push notification is one handled by Customer.io SDK or not.
+     If function returns `false`, `contentHandler` will *not* be called by the SDK.
+     */
+    @discardableResult
+    func didReceive(
+        _ request: UNNotificationRequest,
+        withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void
+    ) -> Bool {
+        guard let pushContent = PushContent.parse(notificationContent: request.content) else {
+            // push is not sent by CIO. Therefore, end early.
+            return false
+        }
+
+        RichPushRequestHandler.shared.startRequest(request, content: pushContent, completionHandler: contentHandler)
+
+        return true
+    }
+
+    /**
+     iOS OS telling the notification service to hurry up and stop modifying the push notifications.
+     Stop all network requests and modifying and show the push for what it looks like now.
+     */
+    func serviceExtensionTimeWillExpire() {
+        RichPushRequestHandler.shared.stopAll()
+    }
+}
+#endif

Sources/MessagingPushAPN/RichPush/RichPushRequest.swift

@@ -0,0 +1,33 @@
+import CioMessagingPush
+import Foundation
+#if canImport(UserNotifications)
+import UserNotifications
+
+internal class RichPushRequest {
+    private let completionHandler: (UNNotificationContent) -> Void
+    private let pushContent: PushContent
+
+    init(
+        pushContent: PushContent,
+        request: UNNotificationRequest,
+        completionHandler: @escaping (UNNotificationContent) -> Void
+    ) {
+        self.completionHandler = completionHandler
+        self.pushContent = pushContent
+    }
+
+    func start() {
+        // no async operations or modifications to the notification to do. Therefore, let's just finish.
+
+        finishImmediately()
+    }
+
+    func finishImmediately() {
+        // XXX: stop async operations and finish the rich push request.
+
+        if let notificationContent = pushContent.mutableNotificationContent {
+            completionHandler(notificationContent)
+        }
+    }
+}
+#endif

Sources/MessagingPushAPN/RichPush/RichPushRequestHandler.swift

@@ -0,0 +1,38 @@
+import CioMessagingPush
+import CioTracking
+import Foundation
+#if canImport(UserNotifications)
+import UserNotifications
+
+internal class RichPushRequestHandler {
+    static let shared = RichPushRequestHandler()
+
+    @Atomic private var requests: [String: RichPushRequest] = [:]
+
+    private init() {}
+
+    func startRequest(
+        _ request: UNNotificationRequest,
+        content: PushContent,
+        completionHandler: @escaping (UNNotificationContent) -> Void
+    ) {
+        let requestId = request.identifier
+
+        let existingRequest = requests[requestId]
+        if existingRequest != nil { return }
+
+        let newRequest = RichPushRequest(pushContent: content, request: request, completionHandler: completionHandler)
+        requests[requestId] = newRequest
+
+        newRequest.start()
+    }
+
+    func stopAll() {
+        requests.forEach {
+            $0.value.finishImmediately()
+        }
+
+        requests = [:]
+    }
+}
+#endif

Sources/Tracking/Extensions/StringExtensions.swift

@@ -11,6 +11,10 @@ public extension String {
         data(using: .utf8)
     }
 
+    var url: URL? {
+        URL(string: self)
+    }
+
     static var abcLetters: String {
         "abcdefghijklmnopqrstuvwxyz"
     }

Sources/Tracking/Extensions/UIApplicationExtensions.swift

@@ -0,0 +1,10 @@
+import Foundation
+#if canImport(UIKit)
+import UIKit
+
+public extension UIApplication {
+    func open(url: URL) {
+        open(url, options: [:]) { _ in }
+    }
+}
+#endif

Tests/Tracking/VersionTest.swift

@@ -5,7 +5,7 @@ import XCTest
 
 class VersionTest: XCTestCase {
     func test_versionValidSemanticVersion() {
-        // regex: https://regexr.com/65mto
-        XCTAssertTrue(SdkVersion.version.matches(regex: #"(\d+)\.(\d+)\.(\d+)(-alpha|-beta)*(\.\d+)*"#))
+        // regex: https://regexr.com/662d5
+        XCTAssertTrue(SdkVersion.version.matches(regex: #"(\d+)\.(\d+)\.(\d+)((-alpha|-beta)\.\d+)*"#))
     }
 }