Feature/deeplink api

LeadKit.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name            = "LeadKit"
-  s.version         = "1.30.0"
+  s.version         = "1.33.0"
   s.summary         = "iOS framework with a bunch of tools for rapid development"
   s.homepage        = "https://github.com/TouchInstinct/LeadKit"
   s.license         = "Apache License, Version 2.0"

Package.swift

@@ -21,6 +21,7 @@ let package = Package(
     .library(name: "TIKeychainUtils", targets: ["TIKeychainUtils"]),
     .library(name: "TITableKitUtils", targets: ["TITableKitUtils"]),
     .library(name: "TILogging", targets: ["TILogging"]),
+    .library(name: "TIDeeplink", targets: ["TIDeeplink"]),
 
     // MARK: - Networking
 
@@ -32,7 +33,7 @@ let package = Package(
 
     .library(name: "TIMapUtils", targets: ["TIMapUtils"]),
     .library(name: "TIAppleMapUtils", targets: ["TIAppleMapUtils"]),
-    
+
     // MARK: - Elements
     .library(name: "OTPSwiftView", targets: ["OTPSwiftView"]),
     .library(name: "TITransitions", targets: ["TITransitions"]),
@@ -65,6 +66,7 @@ let package = Package(
     .target(name: "TIKeychainUtils", dependencies: ["TIFoundationUtils", "KeychainAccess"], path: "TIKeychainUtils/Sources"),
     .target(name: "TITableKitUtils", dependencies: ["TIUIElements", "TableKit"], path: "TITableKitUtils/Sources"),
     .target(name: "TILogging", dependencies: ["TIUIElements", "TISwiftUtils", "TIUIKitCore"], path: "TILogging/Sources"),
+    .target(name: "TIDeeplink", dependencies: ["TIFoundationUtils"], path: "TIDeeplink/Sources"),
 
     // MARK: - Networking
     .target(name: "TINetworking", dependencies: ["TIFoundationUtils", "Alamofire"], path: "TINetworking/Sources"),
@@ -74,7 +76,7 @@ let package = Package(
     // MARK: - Maps
     .target(name: "TIMapUtils", dependencies: [], path: "TIMapUtils/Sources"),
     .target(name: "TIAppleMapUtils", dependencies: ["TIMapUtils"], path: "TIAppleMapUtils/Sources"),
-    
+
     // MARK: - Elements
     .target(name: "OTPSwiftView", dependencies: ["TIUIElements"], path: "OTPSwiftView/Sources"),
     .target(name: "TITransitions", path: "TITransitions/Sources"),

TIAppleMapUtils/TIAppleMapUtils.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'TIAppleMapUtils'
-  s.version          = '1.30.0'
+  s.version          = '1.33.0'
   s.summary          = 'Set of helpers for map objects clustering and interacting using Apple MapKit.'
   s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
   s.license          = { :type => 'MIT', :file => 'LICENSE' }

TIAuth/TIAuth.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'TIAuth'
-  s.version          = '1.30.0'
+  s.version          = '1.33.0'
   s.summary          = 'Login, registration, confirmation and other related actions'
   s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
   s.license          = { :type => 'MIT', :file => 'LICENSE' }

TIDeepLink/Sources/DeeplinkHandler/BaseNavigationStackDeeplinkHandler.swift

@@ -0,0 +1,48 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import Foundation
+import UIKit
+
+open class BaseNavigationStackDeeplinkHandler: DeeplinkHandler {
+
+    // MARK: - DeeplinkHandler
+
+    open func canHandle(deeplink: DeeplinkType) -> Bool {
+        findHandler(for: deeplink) != nil
+    }
+
+    open func handle(deeplink: DeeplinkType) -> Operation? {
+        let handler = findHandler(for: deeplink)
+        return handler?.handle(deeplink: deeplink)
+    }
+
+    // MARK: - Open methods
+
+    open func findHandler(for deeplink: DeeplinkType) -> DeeplinkHandler? {
+        guard let rootController = UIApplication.shared.keyWindow?.rootViewController else {
+            return nil
+        }
+
+        return rootController.findHandler(for: deeplink)
+    }
+}

TIDeepLink/Sources/DeeplinkHandler/DeeplinkHandler.swift

@@ -0,0 +1,28 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import Foundation
+
+public protocol DeeplinkHandler {
+    func canHandle(deeplink: DeeplinkType) -> Bool
+    func handle(deeplink: DeeplinkType) -> Operation?
+}

TIDeepLink/Sources/DeeplinkHandler/Helpers/UIViewController+DeeplinkHandler.swift

@@ -0,0 +1,77 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import UIKit
+
+public typealias DeeplinkHandlerViewController = DeeplinkHandler & UIViewController
+
+public extension UIViewController {
+
+    func findHandler(for deeplink: DeeplinkType) -> DeeplinkHandlerViewController? {
+        if let deeplinksHandler = self as? DeeplinkHandlerViewController,
+           deeplinksHandler.canHandle(deeplink: deeplink) {
+            return deeplinksHandler
+        }
+
+        if let deeplinksHandler = presentedViewController?.findHandler(for: deeplink) {
+            return deeplinksHandler
+        }
+
+        return findHandlerInViewHierarchy(for: deeplink)
+    }
+
+    private func findHandlerInViewHierarchy(for deeplink: DeeplinkType) -> DeeplinkHandlerViewController? {
+        switch self {
+        case let navController as UINavigationController:
+            return navController.viewControllers.reversed().findHadler(for: deeplink)
+
+        case let tabController as UITabBarController:
+            if let deeplinksHandler = tabController.selectedViewController?.findHandler(for: deeplink) {
+                return deeplinksHandler
+            } else if var tabControllers = tabController.viewControllers {
+                if tabController.selectedIndex != NSNotFound {
+                    tabControllers.remove(at: tabController.selectedIndex)
+                }
+
+                if let deeplinksHandler = tabControllers.findHadler(for: deeplink) {
+                    return deeplinksHandler
+                }
+            }
+
+        default:
+            return nil
+        }
+
+        return nil
+    }
+}
+
+private extension Sequence where Element: UIViewController {
+    func findHadler(for deeplink: DeeplinkType) -> DeeplinkHandlerViewController? {
+        for controller in self {
+            if let deeplinksHandler = controller.findHandler(for: deeplink) {
+                return deeplinksHandler
+            }
+        }
+        return nil
+    }
+}

TIDeepLink/Sources/DeeplinkMapper.swift

@@ -0,0 +1,27 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import Foundation
+
+public protocol DeeplinkMapper {
+    func map(url: URL) -> DeeplinkType?
+}

TIDeepLink/Sources/DeeplinkType.swift

@@ -0,0 +1,24 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+public protocol DeeplinkType {
+}

TIDeeplink/Sources/TIDeeplinkService.swift

@@ -0,0 +1,93 @@
+//
+//  Copyright (c) 2023 Touch Instinct
+//
+//  Permission is hereby granted, free of charge, to any person obtaining a copy
+//  of this software and associated documentation files (the Software), to deal
+//  in the Software without restriction, including without limitation the rights
+//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+//  copies of the Software, and to permit persons to whom the Software is
+//  furnished to do so, subject to the following conditions:
+//
+//  The above copyright notice and this permission notice shall be included in
+//  all copies or substantial portions of the Software.
+//
+//  THE SOFTWARE IS PROVIDED AS IS, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+//  THE SOFTWARE.
+//
+
+import Foundation
+import TIFoundationUtils
+
+public final class TIDeeplinksService {
+
+    public static let shared = TIDeeplinksService()
+
+    // MARK: - Private properties
+
+    private let operationQueue = OperationQueue.main
+
+    private var pendingDeeplink: DeeplinkType?
+
+    private(set) var isProcessingDeeplink = false
+
+    // MARK: - Public properties
+
+    public var deeplinkMapper: DeeplinkMapper?
+    public var deeplinkHandler: DeeplinkHandler?
+
+    // MARK: - Init
+
+    private init() {
+
+    }
+
+    // MARK: - Public methods
+
+    public func configure(mapper: DeeplinkMapper, handler: DeeplinkHandler) {
+        deeplinkMapper = mapper
+        deeplinkHandler = handler
+    }
+
+    @discardableResult
+    public func deferredHandle(url: URL) -> Bool {
+        pendingDeeplink = deeplinkMapper?.map(url: url)
+        return pendingDeeplink != nil
+    }
+
+    public func reset() {
+        operationQueue.cancelAllOperations()
+        pendingDeeplink = nil
+        isProcessingDeeplink = false
+    }
+
+    public func tryHandle() {
+        guard let deeplink = pendingDeeplink,
+              deeplinkHandler?.canHandle(deeplink: deeplink) ?? false else {
+            return
+        }
+
+        handle()
+    }
+
+    public func handle() {
+        guard let deeplink = pendingDeeplink,
+              let lastOperation = deeplinkHandler?.handle(deeplink: deeplink) else {
+            return
+        }
+
+        operationQueue.addOperation { [weak self] in
+            self?.isProcessingDeeplink = true
+            self?.pendingDeeplink = nil
+        }
+        operationQueue.addOperations(lastOperation.flattenDependencies + [lastOperation],
+                                     waitUntilFinished: false)
+        operationQueue.addOperation { [weak self] in
+            self?.isProcessingDeeplink = false
+        }
+    }
+}

TIDeeplink/TIDeeplink.podspec

@@ -0,0 +1,18 @@
+Pod::Spec.new do |s|
+  s.name             = 'TIDeeplink'
+  s.version          = '1.33.0'
+  s.summary          = 'Deeplink service API'
+  s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
+  s.license          = { :type => 'MIT', :file => 'LICENSE' }
+  s.author           = { 'petropavel13' => 'ivan.smolin@touchin.ru',
+                         'castlele' => 'nikita.semenov@touchin.ru' }
+  s.source           = { :git => 'https://github.com/TouchInstinct/LeadKit.git', :tag => s.version.to_s }
+
+  s.ios.deployment_target = '11.0'
+  s.swift_versions = ['5.3']
+
+  s.source_files = s.name + '/Sources/**/*'
+
+  s.dependency 'TIFoundationUtils', s.version.to_s
+
+end

TIEcommerce/TIEcommerce.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'TIEcommerce'
-  s.version          = '1.30.0'
+  s.version          = '1.33.0'
   s.summary          = 'Cart, products, promocodes, bonuses and other related actions'
   s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
   s.license          = { :type => 'MIT', :file => 'LICENSE' }

TIFoundationUtils/TIFoundationUtils.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name             = 'TIFoundationUtils'
-  s.version          = '1.30.0'
+  s.version          = '1.33.0'
   s.summary          = 'Set of helpers for Foundation framework classes.'
   s.homepage         = 'https://github.com/TouchInstinct/LeadKit/tree/' + s.version.to_s + '/' + s.name
   s.license          = { :type => 'MIT', :file => 'LICENSE' }