feature: add onboarding process with a bit of refactor

Author: rawandahmad698

.github/workflows/linter.yml

@@ -1,4 +1,4 @@
-name: Run SwiftLint
+name: Build and Lint
 
 on:
   push:
@@ -51,7 +51,7 @@ jobs:
           -project Recap.xcodeproj \
           -scheme Recap
     
-    - name: Build Debug
+    - name: Build Project
       run: |
         xcodebuild build \
           -project Recap.xcodeproj \

Recap.xcodeproj/project.pbxproj

@@ -50,6 +50,8 @@
 				Helpers/Constants/AppConstants.swift,
 				Helpers/Constants/UIConstants.swift,
 				Helpers/MeetingDetection/MeetingPatternMatcher.swift,
+				Helpers/Permissions/PermissionsHelper.swift,
+				Helpers/Permissions/PermissionsHelperType.swift,
 				Repositories/Models/LLMProvider.swift,
 				Repositories/Models/RecordingInfo.swift,
 				Repositories/Models/UserPreferencesInfo.swift,
@@ -76,9 +78,11 @@
 				Services/Summarization/Models/SummarizationResult.swift,
 				Services/Summarization/SummarizationServiceType.swift,
 				Services/Transcription/TranscriptionServiceType.swift,
-				Services/Warnings/WarningManagerType.swift,
+				Services/Utilities/Warnings/WarningManagerType.swift,
 				UIComponents/Buttons/PillButton.swift,
 				UIComponents/Cards/ActionableWarningCard.swift,
+				UseCases/Onboarding/ViewModel/OnboardingViewModel.swift,
+				UseCases/Onboarding/ViewModel/OnboardingViewModelType.swift,
 				UseCases/Settings/Components/MeetingDetection/MeetingDetectionView.swift,
 				UseCases/Settings/Components/Reusable/CustomToggle.swift,
 				UseCases/Settings/Components/SettingsCard.swift,

Recap/Audio/Capture/MicrophoneCapture.swift

@@ -39,15 +39,6 @@ final class MicrophoneCapture: MicrophoneCaptureType {
         cleanup()
     }
 
-    func requestPermission() async -> Bool {
-        await withCheckedContinuation { continuation in
-            AVCaptureDevice.requestAccess(for: .audio) { granted in
-                self.logger.info("Microphone permission granted: \(granted)")
-                continuation.resume(returning: granted)
-            }
-        }
-    }
-    
     func start(outputURL: URL, targetFormat: AudioStreamBasicDescription? = nil) throws {
         self.outputURL = outputURL
 

Recap/Audio/Capture/MicrophoneCaptureType.swift

@@ -12,8 +12,7 @@ import AudioToolbox
 protocol MicrophoneCaptureType: ObservableObject {
     var audioLevel: Float { get }
     var recordingFormat: AVAudioFormat? { get }
-    
-    func requestPermission() async -> Bool
+
     func start(outputURL: URL, targetFormat: AudioStreamBasicDescription?) throws
     func stop()
 }

Recap/Audio/Processing/Session/RecordingSessionManager.swift

@@ -8,9 +8,11 @@ protocol RecordingSessionManaging {
 final class RecordingSessionManager: RecordingSessionManaging {
     private let logger = Logger(subsystem: AppConstants.Logging.subsystem, category: String(describing: RecordingSessionManager.self))
     private let microphoneCapture: MicrophoneCapture
+    private let permissionsHelper: PermissionsHelperType
 
-    init(microphoneCapture: MicrophoneCapture) {
+    init(microphoneCapture: MicrophoneCapture, permissionsHelper: PermissionsHelperType) {
         self.microphoneCapture = microphoneCapture
+        self.permissionsHelper = permissionsHelper
     }
 
     func startSession(configuration: RecordingConfiguration) async throws -> AudioRecordingCoordinatorType {
@@ -27,8 +29,8 @@ final class RecordingSessionManager: RecordingSessionManaging {
         let microphoneCaptureToUse = configuration.enableMicrophone ? microphoneCapture : nil
 
         if configuration.enableMicrophone {
-            let hasPermission = await microphoneCapture.requestPermission()
-            guard hasPermission else {
+            let hasPermission = await permissionsHelper.checkMicrophonePermissionStatus()
+            guard hasPermission == .authorized else {
                 throw AudioCaptureError.microphonePermissionDenied
             }
         }

Recap/DataModels/RecapDataModel.xcdatamodeld/RecapDataModel.xcdatamodel/contents

@@ -15,6 +15,7 @@
         <attribute name="createdAt" attributeType="Date" defaultDateTimeInterval="0" usesScalarValueType="NO"/>
         <attribute name="id" attributeType="String"/>
         <attribute name="modifiedAt" attributeType="Date" defaultDateTimeInterval="0" usesScalarValueType="NO"/>
+        <attribute name="onboarded" attributeType="Boolean" defaultValueString="NO" usesScalarValueType="YES"/>
         <attribute name="selectedLLMModelID" optional="YES" attributeType="String"/>
         <attribute name="selectedProvider" optional="YES" attributeType="String" defaultValueString="openrouter"/>
         <attribute name="summaryPromptTemplate" optional="YES" attributeType="String"/>

…ailability/AvailabilityCoordinator.swift …rs/Availability/AvailabilityHelper.swiftRecap/Services/Availability/AvailabilityCoordinator.swift renamed to Recap/Helpers/Availability/AvailabilityHelper.swift Recap/Services/Availability/AvailabilityCoordinator.swift renamed to Recap/Helpers/Availability/AvailabilityHelper.swift

@@ -2,7 +2,18 @@ import Foundation
 import Combine
 
 @MainActor
-final class AvailabilityCoordinator: AvailabilityCoordinatorType {
+protocol AvailabilityHelperType: AnyObject {
+    var isAvailable: Bool { get }
+    var availabilityPublisher: AnyPublisher<Bool, Never> { get }
+    
+    func startMonitoring()
+    func stopMonitoring()
+    func checkAvailabilityNow() async -> Bool
+}
+
+
+@MainActor
+final class AvailabilityHelper: AvailabilityHelperType {
     @Published private(set) var isAvailable: Bool = false
     var availabilityPublisher: AnyPublisher<Bool, Never> {
         $isAvailable.eraseToAnyPublisher()
@@ -50,4 +61,4 @@ final class AvailabilityCoordinator: AvailabilityCoordinatorType {
         isAvailable = available
         return available
     }
-}
+}

Recap/Helpers/Permissions/PermissionsHelper.swift

@@ -0,0 +1,54 @@
+import Foundation
+import AVFoundation
+import UserNotifications
+import ScreenCaptureKit
+
+@MainActor
+final class PermissionsHelper: PermissionsHelperType {
+    func requestMicrophonePermission() async -> Bool {
+        await withCheckedContinuation { continuation in
+            AVCaptureDevice.requestAccess(for: .audio) { granted in
+                continuation.resume(returning: granted)
+            }
+        }
+    }
+    
+    func requestScreenRecordingPermission() async -> Bool {
+        do {
+            let _ = try await SCShareableContent.current
+            return true
+        } catch {
+            return false
+        }
+    }
+    
+    func requestNotificationPermission() async -> Bool {
+        do {
+            let center = UNUserNotificationCenter.current()
+            let granted = try await center.requestAuthorization(options: [.alert, .sound, .badge])
+            return granted
+        } catch {
+            return false
+        }
+    }
+    
+    func checkMicrophonePermissionStatus() -> AVAuthorizationStatus {
+        AVCaptureDevice.authorizationStatus(for: .audio)
+    }
+    
+    func checkNotificationPermissionStatus() async -> Bool {
+        await withCheckedContinuation { continuation in
+            UNUserNotificationCenter.current().getNotificationSettings { settings in
+                continuation.resume(returning: settings.authorizationStatus == .authorized)
+            }
+        }
+    }
+    
+    func checkScreenRecordingPermission() -> Bool {
+        if #available(macOS 11.0, *) {
+            return CGPreflightScreenCaptureAccess()
+        } else {
+            return true
+        }
+    }
+}

Recap/Helpers/Permissions/PermissionsHelperType.swift

@@ -0,0 +1,18 @@
+import Foundation
+import AVFoundation
+#if MOCKING
+import Mockable
+#endif
+
+#if MOCKING
+@Mockable
+#endif
+@MainActor
+protocol PermissionsHelperType: AnyObject {
+    func requestMicrophonePermission() async -> Bool
+    func requestScreenRecordingPermission() async -> Bool
+    func requestNotificationPermission() async -> Bool
+    func checkMicrophonePermissionStatus() -> AVAuthorizationStatus
+    func checkNotificationPermissionStatus() async -> Bool
+    func checkScreenRecordingPermission() -> Bool
+}

Recap/MenuBar/Manager/MenuBarPanelManager+Delegates.swift

@@ -0,0 +1,41 @@
+import SwiftUI
+import AppKit
+
+extension MenuBarPanelManager: OnboardingDelegate {
+    func onboardingDidComplete() {
+        Task {
+            await transitionFromOnboardingToMain()
+        }
+    }
+    
+    private func transitionFromOnboardingToMain() async {
+        guard let currentPanel = panel else { return }
+        
+        await slideOutCurrentPanel(currentPanel)
+        await createAndShowMainPanel()
+    }
+    
+    private func slideOutCurrentPanel(_ currentPanel: SlidingPanel) async {
+        await withCheckedContinuation { continuation in
+            PanelAnimator.slideOut(panel: currentPanel) { [weak self] in
+                self?.panel = nil
+                self?.isVisible = false
+                continuation.resume()
+            }
+        }
+    }
+    
+    private func createAndShowMainPanel() async {
+        panel = createMainPanel()
+        guard let newPanel = panel else { return }
+        
+        positionPanel(newPanel)
+        
+        await withCheckedContinuation { continuation in
+            PanelAnimator.slideIn(panel: newPanel) { [weak self] in
+                self?.isVisible = true
+                continuation.resume()
+            }
+        }
+    }
+}