feat(recovery): add recovery quick action (#146)

Author: pwltr

Bitkit/AppScene.swift

@@ -23,6 +23,7 @@ struct AppScene: View {
     @State private var walletIsInitializing: Bool? = nil
     @State private var walletInitShouldFinish = false
     @State private var isPinVerified: Bool = false
+    @State private var showRecoveryScreen = false
 
     init() {
         let sheetViewModel = SheetViewModel()
@@ -79,13 +80,27 @@ struct AppScene: View {
                         description: "Bitkit was unable to register for push notifications."
                     )
                 }
+
+                // Listen for quick action notifications
+                NotificationCenter.default.addObserver(
+                    forName: .quickActionSelected,
+                    object: nil,
+                    queue: .main
+                ) { notification in
+                    handleQuickAction(notification)
+                }
             }
     }
 
     @ViewBuilder
     private var mainContent: some View {
         ZStack {
-            walletContent
+            if showRecoveryScreen {
+                RecoveryRouter()
+                    .accentColor(.white)
+            } else {
+                walletContent
+            }
 
             if !removeSplash && !session.skipSplashOnce {
                 SplashView()
@@ -99,7 +114,7 @@ struct AppScene: View {
         if wallet.walletExists == true {
             existingWalletContent
         } else if wallet.walletExists == false {
-            newWalletContent
+            onboardingContent
         }
     }
 
@@ -138,7 +153,7 @@ struct AppScene: View {
     }
 
     @ViewBuilder
-    private var newWalletContent: some View {
+    private var onboardingContent: some View {
         NavigationStack {
             TermsView()
         }
@@ -174,6 +189,9 @@ struct AppScene: View {
 
         guard wallet.walletExists == true else { return }
 
+        // Don't start wallet if we're in recovery mode
+        guard !showRecoveryScreen else { return }
+
         wallet.addOnEvent(id: "toasts-and-sheets") { [weak app] lightningEvent in
             app?.handleLdkNodeEvent(lightningEvent)
         }
@@ -235,4 +253,19 @@ struct AppScene: View {
             isPinVerified = false
         }
     }
+
+    private func handleQuickAction(_ notification: Notification) {
+        guard let userInfo = notification.userInfo,
+              let shortcutType = userInfo["shortcutType"] as? String
+        else {
+            return
+        }
+
+        switch shortcutType {
+        case "Recovery":
+            showRecoveryScreen = true
+        default:
+            break
+        }
+    }
 }

Bitkit/Assets.xcassets/recovery.imageset/Contents.json

@@ -0,0 +1,23 @@
+{
+  "images" : [
+    {
+      "filename" : "recovery.png",
+      "idiom" : "universal",
+      "scale" : "1x"
+    },
+    {
+      "filename" : "recovery 1.png",
+      "idiom" : "universal",
+      "scale" : "2x"
+    },
+    {
+      "filename" : "recovery 2.png",
+      "idiom" : "universal",
+      "scale" : "3x"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Bitkit/Assets.xcassets/recovery.imageset/recovery 1.png

@@ -1,18 +1,44 @@
 import SwiftUI
 
+// MARK: - Quick Action Notification
+
+// Communication bridge between delegates and SwiftUI views
+extension Notification.Name {
+    static let quickActionSelected = Notification.Name("quickActionSelected")
+}
+
 class AppDelegate: NSObject, UIApplicationDelegate {
-    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool
+    // MARK: - App Launch
+
+    func application(_ application: UIApplication,
+                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? = nil) -> Bool
     {
         UNUserNotificationCenter.current().delegate = self
         return true
     }
 
+    // MARK: - Scene Configuration
+
+    // Required for SwiftUI apps to handle quick actions
+    func application(
+        _ application: UIApplication,
+        configurationForConnecting connectingSceneSession: UISceneSession,
+        options: UIScene.ConnectionOptions
+    ) -> UISceneConfiguration {
+        let config = UISceneConfiguration(name: nil, sessionRole: connectingSceneSession.role)
+        config.delegateClass = SceneDelegate.self
+        return config
+    }
+
+    // MARK: - App Termination
+
     func applicationWillTerminate(_ application: UIApplication) {
-        // Unlock so LDK can run in the background
         try? StateLocker.unlock(.lightning)
     }
 }
 
+// MARK: - Push Notifications
+
 extension AppDelegate: UNUserNotificationCenterDelegate {
     func userNotificationCenter(
         _ center: UNUserNotificationCenter,
@@ -23,23 +49,18 @@ extension AppDelegate: UNUserNotificationCenterDelegate {
 
         Logger.debug(userInfo, context: "push notification received while app is in the foreground")
 
-        // If we want to display the native notification to the user while the app is open we need to call this with options
-        // Unlikely we will need to as the background operation would have been aborted and we would have nothint to show
         completionHandler([])
-        //        completionHandler([[.banner, .badge, .sound]])
+        // completionHandler([[.banner, .badge, .sound]])
     }
 
     func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
-        // Convert token to hex string and register immediately with server
         let tokenString = deviceToken.map { String(format: "%02hhx", $0) }.joined()
 
-        // Register with server immediately when we get a new token
         Task {
             do {
                 try await NotificationService.shared.registerDeviceForNotifications(deviceToken: tokenString)
             } catch {
                 Logger.error("Failed to register device token with server: \(error)")
-                // Notify via callback that registration failed
                 await MainActor.run {
                     NotificationService.shared.onRegistrationStatusChanged?(false)
                     NotificationService.shared.onRegistrationFailed?(error)
@@ -63,15 +84,14 @@ extension AppDelegate: UNUserNotificationCenterDelegate {
     }
 }
 
+// MARK: - SwiftUI App
+
 @main
 struct BitkitApp: App {
     @UIApplicationDelegateAdaptor(AppDelegate.self) var delegate
 
     init() {
-        // Set dark mode as default
         UIWindow.appearance().overrideUserInterfaceStyle = .dark
-
-        // Initialize toast window manager early
         _ = ToastWindowManager.shared
     }
 

Bitkit/Assets.xcassets/recovery.imageset/recovery 2.png

@@ -9,23 +9,37 @@ struct NavigationBar: View {
     let showMenuButton: Bool
     let action: AnyView?
     let icon: String?
+    let onBack: (() -> Void)?
 
-    init(title: String, showBackButton: Bool = true, showMenuButton: Bool = true, action: AnyView? = nil, icon: String? = nil) {
+    init(
+        title: String,
+        showBackButton: Bool = true,
+        showMenuButton: Bool = true,
+        action: AnyView? = nil,
+        icon: String? = nil,
+        onBack: (() -> Void)? = nil
+    ) {
         self.title = title
         self.showBackButton = showBackButton
         self.showMenuButton = showMenuButton
         self.action = action
         self.icon = icon
+        self.onBack = onBack
     }
 
     var body: some View {
         HStack(alignment: .center, spacing: 0) {
             if showBackButton {
                 Button(action: {
-                    if navigation.canGoBack {
-                        navigation.navigateBack()
+                    if let onBack {
+                        onBack()
                     } else {
-                        navigation.reset()
+                        // Default behavior for main navigation stack
+                        if navigation.canGoBack {
+                            navigation.navigateBack()
+                        } else {
+                            navigation.reset()
+                        }
                     }
                 }) {
                     Image("arrow-left")

Bitkit/Assets.xcassets/recovery.imageset/recovery.png

@@ -33,5 +33,16 @@
 	</array>
 	<key>UILaunchStoryboardName</key>
 	<string>LaunchScreen</string>
+	<key>UIApplicationShortcutItems</key>
+	<array>
+		<dict>
+			<key>UIApplicationShortcutItemType</key>
+			<string>Recovery</string>
+			<key>UIApplicationShortcutItemTitle</key>
+			<string>Recovery</string>
+			<key>UIApplicationShortcutItemIconFile</key>
+        	<string>recovery</string>
+		</dict>
+	</array>
 </dict>
 </plist>

Bitkit/BitkitApp.swift

@@ -0,0 +1,50 @@
+import SwiftUI
+import UIKit
+
+// MARK: - Scene Delegate for Quick Actions
+
+// Handles scene lifecycle and quick actions for SwiftUI apps
+class SceneDelegate: NSObject, UIWindowSceneDelegate {
+    // MARK: - Quick Action State
+
+    var savedShortCutItem: UIApplicationShortcutItem?
+
+    // MARK: - Scene Connection
+
+    // Save quick action when scene is created
+    func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
+        if let shortcutItem = connectionOptions.shortcutItem {
+            savedShortCutItem = shortcutItem
+        }
+    }
+
+    // MARK: - Scene Activation
+
+    // Handle saved quick action when scene becomes active
+    func sceneDidBecomeActive(_ scene: UIScene) {
+        if let shortcutItem = savedShortCutItem {
+            handleQuickAction(shortcutItem)
+            savedShortCutItem = nil
+        }
+    }
+
+    // MARK: - Quick Action Handling (App Running)
+
+    // Handle quick action when app is already running
+    func windowScene(
+        _ windowScene: UIWindowScene,
+        performActionFor shortcutItem: UIApplicationShortcutItem,
+        completionHandler: @escaping (Bool) -> Void
+    ) {
+        handleQuickAction(shortcutItem)
+        completionHandler(true)
+    }
+
+    // MARK: - Quick Action Processing
+
+    // Process quick action and notify SwiftUI views
+    private func handleQuickAction(_ shortcutItem: UIApplicationShortcutItem) {
+        let userInfo = ["shortcutType": shortcutItem.type]
+        NotificationCenter.default.post(name: .quickActionSelected, object: nil, userInfo: userInfo)
+    }
+}