[PM-28997] Migrate personal vault to My Items

BitwardenKit/UI/Platform/Application/Extensions/View+Toolbar.swift

@@ -19,6 +19,34 @@ public extension View {
             .accessibilityIdentifier("AddItemButton")
     }
 
+    /// Returns a toolbar button configured for navigating back within a view flow.
+    ///
+    /// - Parameters:
+    ///   - hidden: Whether to hide the toolbar item.
+    ///   - action: The action to perform when the button is tapped.
+    /// - Returns: A `Button` configured for navigating back.
+    ///
+    func backToolbarButton(hidden: Bool = false, action: @escaping () -> Void) -> some View {
+        if #available(iOS 26, *) {
+            return Button(action: action) {
+                Label(Localizations.back, systemImage: "chevron.backward")
+            }
+            .hidden(hidden)
+            .accessibilityIdentifier("BackButton")
+            .accessibilityLabel(Localizations.back)
+        }
+        return Button(action: action) {
+            HStack(spacing: 4) {
+                Image(systemName: "chevron.left")
+                    .font(.body.weight(.semibold))
+                Text(Localizations.back)
+            }
+        }
+        .buttonStyle(.toolbar)
+        .hidden(hidden)
+        .accessibilityIdentifier("BackButton")
+    }
+
     /// Returns a toolbar button configured for cancelling an operation in a view.
     ///
     /// - Parameters:

BitwardenResources/Localizations/en.lproj/Localizable.strings

@@ -1273,6 +1273,17 @@
 "TheNewRecommendedEncryptionSettingsDescriptionLong" = "The new recommended encryption settings will improve your account security. Enter your master password to update now.";
 "Updating" = "Updating…";
 "EncryptionSettingsUpdated" = "Encryption settings updated";
+"ItemTransfer" = "Item transfer";
+"TransferItemsToX" = "Transfer items to %1$@";
+"XIsRequiringAllItemsToBeOwnedByTheOrganizationDescriptionLong" = "%1$@ is requiring all items to be owned by the organization for security and compliance. Click accept to transfer ownership of your items.";
+"DeclineAndLeave" = "Decline and leave";
+"WhyAmISeeingThis" = "Why am I seeing this?";
+"AreYouSureYouWantToLeave" = "Are you sure you want to leave?";
+"ByDecliningYourPersonalItemsWillStayInYourAccountDescriptionLong" = "By declining, your personal items will stay in your account, but you'll lose access to shared items and organization features.";
+"ContactYourAdminToRegainAccess" = "Contact your admin to regain access.";
+"LeaveX" = "Leave %1$@";
+"HowToManageMyVault" = "How to manage My vault";
+"YouLeftTheOrganization" = "You left the organization";
 "ThisSettingIsManagedByYourOrganization" = "This setting is managed by your organization.";
 "YourOrganizationHasSetTheDefaultSessionTimeoutToX" = "Your organization has set the default session timeout to %1$@.";
 "YourOrganizationHasSetTheMaximumSessionTimeoutToX" = "Your organization has set the maximum session timeout to %1$@.";

BitwardenShared/Core/Platform/Utilities/ExternalLinksConstants.swift

@@ -43,6 +43,9 @@ extension ExternalLinksConstants {
     /// A markdown link to Bitwarden's terms of service.
     static let termsOfService = URL(string: "https://bitwarden.com/terms/")!
 
+    /// A link to Bitwarden's help page for My vault items migration. .
+    static let transferOwnership = URL(string: "https://bitwarden.com/help/transfer-ownership/")!
+
     /// A markdown link to Bitwarden's marketing email preferences.
     static let unsubscribeFromMarketingEmails = URL(string: "https://bitwarden.com/email-preferences/")!
 

BitwardenShared/UI/Platform/Application/Support/Images.xcassets/Images/Illustrations/item-transfer-warning.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images" : [
+    {
+      "filename" : "item-transfer-warning.pdf",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  },
+  "properties" : {
+    "preserves-vector-representation" : true
+  }
+}

BitwardenShared/UI/Platform/Application/Support/Images.xcassets/Images/Illustrations/item-transfer.imageset/Contents.json

@@ -0,0 +1,15 @@
+{
+  "images" : [
+    {
+      "filename" : "item-transfer.pdf",
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  },
+  "properties" : {
+    "preserves-vector-representation" : true
+  }
+}

BitwardenShared/UI/Vault/MigrateToMyItems/MigrateToMyItemsAction.swift

@@ -0,0 +1,11 @@
+// MARK: - MigrateToMyItemsAction
+
+/// Actions that can be processed by a `MigrateToMyItemsProcessor`.
+///
+enum MigrateToMyItemsAction: Equatable, Sendable {
+    /// The user tapped the back button on the decline confirmation screen.
+    case backTapped
+
+    /// The user tapped the "Decline and leave" button.
+    case declineAndLeaveTapped
+}

BitwardenShared/UI/Vault/MigrateToMyItems/MigrateToMyItemsEffect.swift

@@ -0,0 +1,14 @@
+// MARK: - MigrateToMyItemsEffect
+
+/// Effects that can be processed by a `MigrateToMyItemsProcessor`.
+///
+enum MigrateToMyItemsEffect: Equatable, Sendable {
+    /// The user tapped the "Accept transfer" button.
+    case acceptTransferTapped
+
+    /// The view appeared on screen.
+    case appeared
+
+    /// The user tapped the "Leave {organization}" button to confirm leaving.
+    case leaveOrganizationTapped
+}

BitwardenShared/UI/Vault/MigrateToMyItems/MigrateToMyItemsProcessor.swift

@@ -0,0 +1,127 @@
+import BitwardenKit
+import BitwardenResources
+import Foundation
+
+// MARK: - MigrateToMyItemsProcessorDelegate
+
+/// A delegate for the `MigrateToMyItemsProcessor` to communicate events back to the coordinator.
+///
+@MainActor
+protocol MigrateToMyItemsProcessorDelegate: AnyObject {
+    /// Called when the user has left the organization.
+    ///
+    func didLeaveOrganization()
+}
+
+// MARK: - MigrateToMyItemsProcessor
+
+/// The processor used to manage state and handle actions for the migrate to my items screen.
+///
+final class MigrateToMyItemsProcessor: StateProcessor<
+    MigrateToMyItemsState,
+    MigrateToMyItemsAction,
+    MigrateToMyItemsEffect,
+> {
+    // MARK: Types
+
+    typealias Services = HasErrorReporter
+        & HasPolicyService
+        & HasVaultRepository
+
+    // MARK: Private Properties
+
+    /// The coordinator that handles navigation.
+    private let coordinator: AnyCoordinator<VaultItemRoute, VaultItemEvent>
+
+    /// The delegate to notify of events.
+    private weak var delegate: MigrateToMyItemsProcessorDelegate?
+
+    /// The services used by this processor.
+    private let services: Services
+
+    // MARK: Initialization
+
+    /// Creates a new `MigrateToMyItemsProcessor`.
+    ///
+    /// - Parameters:
+    ///   - coordinator: The coordinator that handles navigation.
+    ///   - delegate: The delegate to notify of events.
+    ///   - services: The services required by this processor.
+    ///   - state: The initial state of the processor.
+    ///
+    init(
+        coordinator: AnyCoordinator<VaultItemRoute, VaultItemEvent>,
+        delegate: MigrateToMyItemsProcessorDelegate?,
+        services: Services,
+        state: MigrateToMyItemsState,
+    ) {
+        self.coordinator = coordinator
+        self.delegate = delegate
+        self.services = services
+        super.init(state: state)
+    }
+
+    // MARK: Methods
+
+    override func perform(_ effect: MigrateToMyItemsEffect) async {
+        switch effect {
+        case .acceptTransferTapped:
+            await acceptTransfer()
+        case .appeared:
+            await loadOrganizationName()
+        case .leaveOrganizationTapped:
+            await leaveOrganization()
+        }
+    }
+
+    override func receive(_ action: MigrateToMyItemsAction) {
+        switch action {
+        case .backTapped:
+            state.page = .transfer
+        case .declineAndLeaveTapped:
+            state.page = .declineConfirmation
+        }
+    }
+
+    // MARK: Private Methods
+
+    /// Accepts the item transfer.
+    ///
+    private func acceptTransfer() async {
+        coordinator.showLoadingOverlay(LoadingOverlayState(title: Localizations.loading))
+
+        // TODO: PM-29709 Implement accept transfer API call
+
+        defer { coordinator.hideLoadingOverlay() }
+        coordinator.navigate(to: .dismiss())
+    }
+
+    /// Leaves the organization after declining the item transfer.
+    ///
+    private func leaveOrganization() async {
+        coordinator.showLoadingOverlay(LoadingOverlayState(title: Localizations.loading))
+
+        // TODO: PM-29710 Implement leave organization API call
+
+        defer { coordinator.hideLoadingOverlay() }
+        delegate?.didLeaveOrganization()
+    }
+
+    /// Loads the organization name from the policy service and vault repository.
+    ///
+    private func loadOrganizationName() async {
+        do {
+            let organizationIds = await services.policyService.organizationsApplyingPolicyToUser(.personalOwnership)
+            guard let organizationId = organizationIds.first else {
+                coordinator.showAlert(.defaultAlert(title: Localizations.anErrorHasOccurred))
+                return
+            }
+            let organization = try await services.vaultRepository.fetchOrganization(withId: organizationId)
+            // TODO: PM-29113 Validate if user must do vault migration and error handling
+
+            state.organizationName = organization?.name ?? ""
+        } catch {
+            services.errorReporter.log(error: error)
+        }
+    }
+}

BitwardenShared/UI/Vault/MigrateToMyItems/MigrateToMyItemsState.swift

@@ -0,0 +1,27 @@
+import Foundation
+
+// MARK: - MigrateToMyItemsState
+
+/// An object that defines the current state of a `MigrateToMyItemsView`.
+///
+struct MigrateToMyItemsState: Equatable, Sendable {
+    // MARK: Types
+
+    /// An enumeration of the pages in the migrate to my items flow.
+    ///
+    enum Page: Equatable, Sendable {
+        /// The main screen prompting the user to accept or decline the transfer.
+        case transfer
+
+        /// The confirmation screen shown when the user chooses to decline.
+        case declineConfirmation
+    }
+
+    // MARK: Properties
+
+    /// The name of the organization requesting the item transfer.
+    var organizationName: String = ""
+
+    /// The current page being displayed.
+    var page: Page = .transfer
+}

BitwardenShared/UI/Vault/MigrateToMyItems/MigrateToMyItemsView+SnapshotTests.swift

@@ -0,0 +1,53 @@
+// swiftlint:disable:this file_name
+import BitwardenKit
+import BitwardenKitMocks
+import SnapshotTesting
+import XCTest
+
+@testable import BitwardenShared
+
+class MigrateToMyItemsViewSnapshotTests: BitwardenTestCase {
+    // MARK: Properties
+
+    var processor: MockProcessor<MigrateToMyItemsState, MigrateToMyItemsAction, MigrateToMyItemsEffect>!
+    var subject: MigrateToMyItemsView!
+
+    // MARK: Setup & Teardown
+
+    override func setUp() {
+        super.setUp()
+
+        processor = MockProcessor(state: MigrateToMyItemsState(organizationName: "Acme Corporation"))
+        let store = Store(processor: processor)
+
+        subject = MigrateToMyItemsView(store: store)
+    }
+
+    override func tearDown() {
+        super.tearDown()
+
+        processor = nil
+        subject = nil
+    }
+
+    // MARK: Snapshots
+
+    /// The transfer page renders correctly.
+    @MainActor
+    func disabletest_snapshot_transferPage() {
+        assertSnapshots(
+            of: subject.navStackWrapped,
+            as: [.defaultPortrait, .defaultPortraitDark, .defaultPortraitAX5],
+        )
+    }
+
+    /// The decline confirmation page renders correctly.
+    @MainActor
+    func disabletest_snapshot_declineConfirmationPage() {
+        processor.state.page = .declineConfirmation
+        assertSnapshots(
+            of: subject.navStackWrapped,
+            as: [.defaultPortrait, .defaultPortraitDark, .defaultPortraitAX5],
+        )
+    }
+}