[PM-33849] feat: Add Premium Upgrade view

BitwardenResources/Localizations/en.lproj/Localizable.strings

@@ -1350,3 +1350,11 @@
 "TurnOnNow" = "Turn on now";
 "AcceptTransfer" = "Accept transfer";
 "YourPasswordAndHintCannotBeTheSamePleaseChooseADifferentHint" = "Your password and hint cannot be the same. Please choose a different hint.";
+"PerMonth" = "/ month";
+"UnlockMoreAdvancedFeaturesWithPremiumPlan" = "Unlock more advanced features with a Premium plan.";
+"BuiltInAuthenticator" = "Built-in authenticator";
+"EmergencyAccess" = "Emergency access";
+"SecureFileStorage" = "Secure file storage";
+"BreachMonitoring" = "Breach monitoring";
+"UpgradeNow" = "Upgrade now";
+"YoullGoToStripeSecureCheckoutToCompleteYourPurchase" = "You´ll go to Stripe´s secure checkout to complete your purchase.";

BitwardenShared/Core/Billing/Models/Enum/BillingError.swift

@@ -0,0 +1,22 @@
+import Foundation
+
+// MARK: - BillingError
+
+/// Errors that can occur during billing operations.
+///
+enum BillingError: LocalizedError {
+    /// The checkout URL is invalid (e.g., not HTTPS).
+    case invalidCheckoutUrl
+
+    /// Unable to open the checkout URL in the browser.
+    case unableToOpenCheckout
+
+    var errorDescription: String? {
+        switch self {
+        case .invalidCheckoutUrl,
+             .unableToOpenCheckout:
+            // TODO: PM-33856 Handle payment errors
+            nil
+        }
+    }
+}

BitwardenShared/Core/Billing/Services/BillingService.swift

@@ -0,0 +1,46 @@
+import Foundation
+
+// MARK: - BillingService
+
+/// A protocol for a service used to manage billing operations.
+///
+protocol BillingService: AnyObject { // sourcery: AutoMockable
+    /// Creates a checkout session for premium upgrade and returns the checkout URL.
+    ///
+    /// - Returns: A validated HTTPS URL for the checkout session.
+    /// - Throws: `BillingError.invalidCheckoutUrl` if the URL is invalid or not HTTPS.
+    ///
+    func createCheckoutSession() async throws -> URL
+}
+
+// MARK: - DefaultBillingService
+
+/// The default implementation of `BillingService`.
+///
+class DefaultBillingService: BillingService {
+    // MARK: Properties
+
+    /// The API service used for billing requests.
+    private let billingAPIService: BillingAPIService
+
+    // MARK: Initialization
+
+    /// Creates a new `DefaultBillingService`.
+    ///
+    /// - Parameter billingAPIService: The API service used for billing requests.
+    ///
+    init(billingAPIService: BillingAPIService) {
+        self.billingAPIService = billingAPIService
+    }
+
+    // MARK: Methods
+
+    func createCheckoutSession() async throws -> URL {
+        let response = try await billingAPIService.createCheckoutSession()
+        let url = response.checkoutSessionUrl
+        guard url.scheme == "https" else {
+            throw BillingError.invalidCheckoutUrl
+        }
+        return url
+    }
+}

BitwardenShared/Core/Billing/Services/BillingServiceTests.swift

@@ -0,0 +1,82 @@
+import TestHelpers
+import XCTest
+
+@testable import BitwardenShared
+@testable import BitwardenSharedMocks
+
+class BillingServiceTests: BitwardenTestCase {
+    // MARK: Properties
+
+    var billingAPIService: MockBillingAPIService!
+    var subject: DefaultBillingService!
+
+    // MARK: Setup and Teardown
+
+    override func setUp() {
+        super.setUp()
+
+        billingAPIService = MockBillingAPIService()
+        subject = DefaultBillingService(billingAPIService: billingAPIService)
+    }
+
+    override func tearDown() {
+        super.tearDown()
+
+        billingAPIService = nil
+        subject = nil
+    }
+
+    // MARK: Tests
+
+    /// `createCheckoutSession()` returns the URL when it uses HTTPS scheme.
+    func test_createCheckoutSession_success() async throws {
+        let expectedURL = URL(string: "https://checkout.stripe.com/session")!
+        billingAPIService.createCheckoutSessionReturnValue = CheckoutSessionResponseModel(
+            checkoutSessionUrl: expectedURL,
+        )
+
+        let result = try await subject.createCheckoutSession()
+
+        XCTAssertEqual(billingAPIService.createCheckoutSessionCallsCount, 1)
+        XCTAssertEqual(result, expectedURL)
+    }
+
+    /// `createCheckoutSession()` throws `invalidCheckoutUrl` when the URL uses HTTP scheme.
+    func test_createCheckoutSession_invalidUrl_http() async throws {
+        let httpURL = URL(string: "http://checkout.stripe.com/session")!
+        billingAPIService.createCheckoutSessionReturnValue = CheckoutSessionResponseModel(
+            checkoutSessionUrl: httpURL,
+        )
+
+        await assertAsyncThrows(error: BillingError.invalidCheckoutUrl) {
+            _ = try await subject.createCheckoutSession()
+        }
+
+        XCTAssertEqual(billingAPIService.createCheckoutSessionCallsCount, 1)
+    }
+
+    /// `createCheckoutSession()` throws `invalidCheckoutUrl` when the URL has no scheme.
+    func test_createCheckoutSession_invalidUrl_noScheme() async throws {
+        let noSchemeURL = URL(string: "checkout.stripe.com/session")!
+        billingAPIService.createCheckoutSessionReturnValue = CheckoutSessionResponseModel(
+            checkoutSessionUrl: noSchemeURL,
+        )
+
+        await assertAsyncThrows(error: BillingError.invalidCheckoutUrl) {
+            _ = try await subject.createCheckoutSession()
+        }
+
+        XCTAssertEqual(billingAPIService.createCheckoutSessionCallsCount, 1)
+    }
+
+    /// `createCheckoutSession()` propagates errors from the API service.
+    func test_createCheckoutSession_apiError() async throws {
+        billingAPIService.createCheckoutSessionThrowableError = URLError(.notConnectedToInternet)
+
+        await assertAsyncThrows {
+            _ = try await subject.createCheckoutSession()
+        }
+
+        XCTAssertEqual(billingAPIService.createCheckoutSessionCallsCount, 1)
+    }
+}

BitwardenShared/Core/Platform/Services/ServiceContainer.swift

@@ -60,6 +60,9 @@ public class ServiceContainer: Services { // swiftlint:disable:this type_body_le
     /// The repository to manage biometric unlock policies and access controls the user.
     let biometricsRepository: BiometricsRepository
 
+    /// The service used by the application to manage billing operations.
+    let billingService: BillingService
+
     /// The service used to obtain device biometrics status & data.
     let biometricsService: BiometricsService
 
@@ -312,6 +315,7 @@ public class ServiceContainer: Services { // swiftlint:disable:this type_body_le
         authService: AuthService,
         authenticatorSyncService: AuthenticatorSyncService,
         autofillCredentialService: AutofillCredentialService,
+        billingService: BillingService,
         biometricsRepository: BiometricsRepository,
         biometricsService: BiometricsService,
         cameraService: CameraService,
@@ -378,6 +382,7 @@ public class ServiceContainer: Services { // swiftlint:disable:this type_body_le
         self.authService = authService
         self.authenticatorSyncService = authenticatorSyncService
         self.autofillCredentialService = autofillCredentialService
+        self.billingService = billingService
         self.biometricsRepository = biometricsRepository
         self.biometricsService = biometricsService
         self.cameraService = cameraService
@@ -1089,6 +1094,7 @@ public class ServiceContainer: Services { // swiftlint:disable:this type_body_le
             authService: authService,
             authenticatorSyncService: authenticatorSyncService,
             autofillCredentialService: autofillCredentialService,
+            billingService: DefaultBillingService(billingAPIService: apiService),
             biometricsRepository: biometricsRepository,
             biometricsService: biometricsService,
             cameraService: DefaultCameraService(),

BitwardenShared/Core/Platform/Services/Services.swift

@@ -16,6 +16,7 @@ typealias Services = HasAPIService
     & HasAuthService
     & HasAutofillCredentialService
     & HasBillingAPIService
+    & HasBillingService
     & HasBiometricsRepository
     & HasCameraService
     & HasChangeKdfService
@@ -153,6 +154,13 @@ protocol HasBillingAPIService {
     var billingAPIService: BillingAPIService { get }
 }
 
+/// Protocol for an object that provides a `BillingService`.
+///
+protocol HasBillingService {
+    /// The service used by the application to manage billing operations.
+    var billingService: BillingService { get }
+}
+
 /// Protocol for obtaining the device's biometric authentication type.
 ///
 protocol HasBiometricsRepository {

BitwardenShared/Core/Platform/Services/TestHelpers/ServiceContainer+Mocks.swift

@@ -22,6 +22,7 @@ extension ServiceContainer {
         authService: AuthService = MockAuthService(),
         authenticatorSyncService: AuthenticatorSyncService = MockAuthenticatorSyncService(),
         autofillCredentialService: AutofillCredentialService = MockAutofillCredentialService(),
+        billingService: BillingService = MockBillingService(),
         biometricsRepository: BiometricsRepository = MockBiometricsRepository(),
         biometricsService: BiometricsService = MockBiometricsService(),
         cameraService: CameraService = MockCameraService(),
@@ -106,6 +107,7 @@ extension ServiceContainer {
             authService: authService,
             authenticatorSyncService: authenticatorSyncService,
             autofillCredentialService: autofillCredentialService,
+            billingService: billingService,
             biometricsRepository: biometricsRepository,
             biometricsService: biometricsService,
             cameraService: cameraService,

BitwardenShared/Core/Vault/Helpers/VaultListPreparedDataBuilder+AddItemTests.swift

@@ -20,7 +20,7 @@ class VaultListPreparedDataBuilderAddItemTests: BitwardenTestCase {
     var subject: DefaultVaultListPreparedDataBuilder!
     var timeProvider: MockTimeProvider!
     var totpService: MockTOTPService!
-    
+
     // MARK: Setup & Teardown
 
     override func setUp() {

BitwardenShared/Core/Vault/Repositories/VaultRepository.swift

@@ -373,7 +373,7 @@ class DefaultVaultRepository {
 
     /// The service used to get the present time.
     private let timeProvider: TimeProvider
-    
+
     /// The service used to retrieve TOTPs.
     private let totpService: TOTPService
 

BitwardenShared/UI/Billing/PremiumUpgrade/PremiumUpgradeAction.swift

@@ -0,0 +1,14 @@
+// MARK: - PremiumUpgradeAction
+
+/// Actions handled by the `PremiumUpgradeProcessor`.
+///
+enum PremiumUpgradeAction: Equatable {
+    /// The cancel button was tapped.
+    case cancelTapped
+
+    /// Clear the checkout URL after it has been opened.
+    case clearURL
+
+    /// The checkout URL failed to open in the browser.
+    case urlOpenFailed
+}

BitwardenShared/UI/Billing/PremiumUpgrade/PremiumUpgradeCoordinator.swift

@@ -0,0 +1,71 @@
+import BitwardenKit
+import SwiftUI
+
+// MARK: - PremiumUpgradeCoordinator
+
+/// A coordinator that manages navigation for the premium upgrade view.
+///
+class PremiumUpgradeCoordinator: Coordinator, HasStackNavigator {
+    // MARK: Types
+
+    typealias Services = HasBillingService
+        & HasErrorAlertServices.ErrorAlertServices
+        & HasErrorReporter
+
+    // MARK: Properties
+
+    /// The services used by this coordinator.
+    let services: Services
+
+    /// The stack navigator that is managed by this coordinator.
+    private(set) weak var stackNavigator: StackNavigator?
+
+    // MARK: Initialization
+
+    /// Creates a new `PremiumUpgradeCoordinator`.
+    ///
+    /// - Parameters:
+    ///   - services: The services used by this coordinator.
+    ///   - stackNavigator: The stack navigator that is managed by this coordinator.
+    ///
+    init(
+        services: Services,
+        stackNavigator: StackNavigator,
+    ) {
+        self.services = services
+        self.stackNavigator = stackNavigator
+    }
+
+    // MARK: Methods
+
+    func navigate(to route: PremiumUpgradeRoute, context: AnyObject?) {
+        switch route {
+        case .dismiss:
+            stackNavigator?.dismiss()
+        }
+    }
+
+    func start() {
+        showPremiumUpgrade()
+    }
+
+    // MARK: Private Methods
+
+    /// Shows the premium upgrade screen.
+    ///
+    private func showPremiumUpgrade() {
+        let processor = PremiumUpgradeProcessor(
+            coordinator: asAnyCoordinator(),
+            services: services,
+            state: PremiumUpgradeState(),
+        )
+        let view = PremiumUpgradeView(store: Store(processor: processor))
+        stackNavigator?.replace(view)
+    }
+}
+
+// MARK: - HasErrorAlertServices
+
+extension PremiumUpgradeCoordinator: HasErrorAlertServices {
+    var errorAlertServices: ErrorAlertServices { services }
+}

BitwardenShared/UI/Billing/PremiumUpgrade/PremiumUpgradeCoordinatorTests.swift

@@ -0,0 +1,54 @@
+import BitwardenKitMocks
+import SwiftUI
+import XCTest
+
+@testable import BitwardenShared
+
+class PremiumUpgradeCoordinatorTests: BitwardenTestCase {
+    // MARK: Properties
+
+    var stackNavigator: MockStackNavigator!
+    var subject: PremiumUpgradeCoordinator!
+
+    // MARK: Setup & Teardown
+
+    override func setUp() {
+        super.setUp()
+
+        stackNavigator = MockStackNavigator()
+
+        subject = PremiumUpgradeCoordinator(
+            services: ServiceContainer.withMocks(),
+            stackNavigator: stackNavigator,
+        )
+    }
+
+    override func tearDown() {
+        super.tearDown()
+
+        stackNavigator = nil
+        subject = nil
+    }
+
+    // MARK: Tests
+
+    /// `start()` replaces the stack navigator's stack with the premium upgrade view.
+    @MainActor
+    func test_start() throws {
+        subject.start()
+
+        XCTAssertEqual(stackNavigator.actions.count, 1)
+        let action = try XCTUnwrap(stackNavigator.actions.last)
+        XCTAssertEqual(action.type, .replaced)
+        XCTAssertTrue(action.view is PremiumUpgradeView)
+    }
+
+    /// `navigate(to:)` with `.dismiss` dismisses the view.
+    @MainActor
+    func test_navigate_dismiss() throws {
+        subject.navigate(to: .dismiss)
+
+        let action = try XCTUnwrap(stackNavigator.actions.last)
+        XCTAssertEqual(action.type, .dismissed)
+    }
+}