[POS as a tab i2] Show loading & ineligible UI when tapping on the POS tab

WooCommerce/Classes/POS/Controllers/POSEntryPointController.swift

@@ -0,0 +1,28 @@
+import SwiftUI
+import protocol Experiments.FeatureFlagService
+
+@available(iOS 17.0, *)
+@Observable final class POSEntryPointController {
+    private(set) var eligibilityState: POSEligibilityState?
+    private let posEligibilityChecker: POSEntryPointEligibilityCheckerProtocol
+    private let featureFlagService: FeatureFlagService
+
+    init(eligibilityChecker: POSEntryPointEligibilityCheckerProtocol,
+         featureFlagService: FeatureFlagService = ServiceLocator.featureFlagService) {
+        self.posEligibilityChecker = eligibilityChecker
+        self.featureFlagService = featureFlagService
+
+        guard featureFlagService.isFeatureFlagEnabled(.pointOfSaleAsATabi2) else {
+            self.eligibilityState = .eligible
+            return
+        }
+        Task { @MainActor in
+            eligibilityState = await posEligibilityChecker.checkEligibility()
+        }
+    }
+
+    @MainActor
+    func refreshEligibility() async throws {
+        // TODO: WOOMOB-720 - refresh eligibility
+    }
+}

WooCommerce/Classes/POS/Presentation/CardReaderConnection/UI States/PointOfSaleLoadingView.swift

@@ -21,6 +21,7 @@ struct PointOfSaleLoadingView: View {
         .onDisappear {
             trackElapsedTimeOnDisappear()
         }
+        .background(Color.posSurface)
     }
 }
 

WooCommerce/Classes/POS/Presentation/PointOfSaleEntryPointView.swift

@@ -6,6 +6,7 @@ import protocol Yosemite.PointOfSaleBarcodeScanServiceProtocol
 struct PointOfSaleEntryPointView: View {
     @State private var posModel: PointOfSaleAggregateModel?
     @StateObject private var posModalManager = POSModalManager()
+    @State private var posEntryPointController: POSEntryPointController
     @Environment(\.horizontalSizeClass) private var horizontalSizeClass
 
     private let onPointOfSaleModeActiveStateChange: ((Bool) -> Void)
@@ -30,7 +31,8 @@ struct PointOfSaleEntryPointView: View {
          collectOrderPaymentAnalyticsTracker: POSCollectOrderPaymentAnalyticsTracking,
          searchHistoryService: POSSearchHistoryProviding,
          popularPurchasableItemsController: PointOfSaleItemsControllerProtocol,
-         barcodeScanService: PointOfSaleBarcodeScanServiceProtocol) {
+         barcodeScanService: PointOfSaleBarcodeScanServiceProtocol,
+         posEligibilityChecker: POSEntryPointEligibilityCheckerProtocol) {
         self.onPointOfSaleModeActiveStateChange = onPointOfSaleModeActiveStateChange
 
         self.itemsController = itemsController
@@ -43,15 +45,25 @@ struct PointOfSaleEntryPointView: View {
         self.searchHistoryService = searchHistoryService
         self.popularPurchasableItemsController = popularPurchasableItemsController
         self.barcodeScanService = barcodeScanService
+        self.posEntryPointController = POSEntryPointController(eligibilityChecker: posEligibilityChecker)
     }
 
     var body: some View {
         Group {
-            if let posModel = posModel {
-                PointOfSaleDashboardView()
-                    .environment(posModel)
-            } else {
+            switch posEntryPointController.eligibilityState {
+            case .none:
                 PointOfSaleLoadingView()
+            case .eligible:
+                if let posModel = posModel {
+                    PointOfSaleDashboardView()
+                        .environment(posModel)
+                } else {
+                    PointOfSaleLoadingView()
+                }
+            case let .ineligible(reason):
+                POSIneligibleView(reason: reason, onRefresh: {
+                    try await posEntryPointController.refreshEligibility()
+                })
             }
         }
         .task {
@@ -96,7 +108,8 @@ struct PointOfSaleEntryPointView: View {
                               collectOrderPaymentAnalyticsTracker: POSCollectOrderPaymentAnalytics(),
                               searchHistoryService: PointOfSalePreviewHistoryService(),
                               popularPurchasableItemsController: PointOfSalePreviewItemsController(),
-                              barcodeScanService: PointOfSalePreviewBarcodeScanService())
+                              barcodeScanService: PointOfSalePreviewBarcodeScanService(),
+                              posEligibilityChecker: POSTabEligibilityChecker(siteID: 0))
 }
 
 #endif

WooCommerce/Classes/POS/TabBar/POSIneligibleView.swift

@@ -0,0 +1,130 @@
+import SwiftUI
+
+/// A view that displays when the Point of Sale (POS) feature is not available for the current store.
+/// Shows the specific reason why POS is ineligible and provides a button to re-check eligibility.
+struct POSIneligibleView: View {
+    let reason: POSIneligibleReason
+    let onRefresh: () async throws -> Void
+    @Environment(\.dismiss) private var dismiss
+    @State private var isLoading: Bool = false
+
+    var body: some View {
+        VStack(spacing: POSSpacing.large) {
+            HStack {
+                Spacer()
+                Button {
+                    dismiss()
+                } label: {
+                    Text(Image(systemName: "xmark"))
+                        .font(POSFontStyle.posButtonSymbolLarge.font())
+                }
+                .foregroundColor(Color.posOnSurfaceVariantLowest)
+            }
+
+            Spacer()
+
+            VStack(spacing: POSSpacing.medium) {
+                Image(PointOfSaleAssets.exclamationMark.imageName)
+                    .resizable()
+                    .frame(width: POSErrorAndAlertIconSize.large.dimension,
+                           height: POSErrorAndAlertIconSize.large.dimension)
+
+                Text(reasonText)
+                    .font(POSFontStyle.posHeadingBold.font())
+                    .multilineTextAlignment(.center)
+                    .foregroundColor(Color.posOnSurface)
+
+                Button {
+                    Task { @MainActor in
+                        do {
+                            isLoading = true
+                            try await onRefresh()
+                            isLoading = false
+                        } catch {
+                            // TODO-jc: handle error if needed, e.g., show an error message
+                            print("Error refreshing eligibility: \(error)")
+                            isLoading = false
+                        }
+                    }
+                } label: {
+                    Text(Localization.refreshEligibility)
+                }
+                .buttonStyle(POSFilledButtonStyle(size: .normal, isLoading: isLoading))
+            }
+
+            Spacer()
+        }
+        .padding(POSPadding.large)
+    }
+
+    private var reasonText: String {
+        switch reason {
+        case .notTablet:
+            return NSLocalizedString("pos.ineligible.reason.notTablet",
+                                     value: "POS is only available on iPad.",
+                                     comment: "Ineligible reason: not a tablet")
+        case .unsupportedIOSVersion:
+            return NSLocalizedString("pos.ineligible.reason.unsupportedIOSVersion",
+                                     value: "POS requires a newer version of iOS 17 and above.",
+                                     comment: "Ineligible reason: iOS version too low")
+        case .unsupportedWooCommerceVersion:
+            return NSLocalizedString("pos.ineligible.reason.unsupportedWooCommerceVersion",
+                                     value: "Please update WooCommerce plugin to use POS.",
+                                     comment: "Ineligible reason: WooCommerce version too low")
+        case .wooCommercePluginNotFound:
+            return NSLocalizedString("pos.ineligible.reason.wooCommercePluginNotFound",
+                                     value: "WooCommerce plugin not found.",
+                                     comment: "Ineligible reason: plugin missing")
+        case .featureSwitchDisabled:
+            return NSLocalizedString("pos.ineligible.reason.featureSwitchDisabled",
+                                     value: "POS feature is not enabled for your store.",
+                                     comment: "Ineligible reason: feature switch off")
+        case .featureSwitchSyncFailure:
+            return NSLocalizedString("pos.ineligible.reason.featureSwitchSyncFailure",
+                                     value: "Could not verify POS feature status.",
+                                     comment: "Ineligible reason: feature switch sync failed")
+        case .unsupportedCountry:
+            return NSLocalizedString("pos.ineligible.reason.unsupportedCountry",
+                                     value: "POS is not available in your country.",
+                                     comment: "Ineligible reason: country not supported")
+        case .unsupportedCurrency:
+            return NSLocalizedString("pos.ineligible.reason.unsupportedCurrency",
+                                     value: "POS is not available for your store's currency.",
+                                     comment: "Ineligible reason: currency not supported")
+        case .siteSettingsNotAvailable:
+            return NSLocalizedString("pos.ineligible.reason.siteSettingsNotAvailable",
+                                     value: "Unable to load store settings for POS.",
+                                     comment: "Ineligible reason: site settings unavailable")
+        case .featureFlagDisabled:
+            return NSLocalizedString("pos.ineligible.reason.featureFlagDisabled",
+                                     value: "POS feature is currently disabled.",
+                                     comment: "Ineligible reason: feature flag disabled")
+        case .selfDeallocated:
+            return Localization.defaultReason
+        }
+    }
+}
+
+private extension POSIneligibleView {
+    enum Localization {
+        static let refreshEligibility = NSLocalizedString(
+            "pos.ineligible.refresh.button.title",
+            value: "Check Eligibility Again",
+            comment: "Button title to refresh POS eligibility check"
+        )
+
+        /// Default message shown when POS eligibility reason is not available.
+        static let defaultReason = NSLocalizedString(
+            "pos.ineligible.default.reason",
+            value: "Your store is not eligible for POS at this time.",
+            comment: "Default message shown when POS eligibility reason is not available"
+        )
+    }
+}
+
+#Preview {
+    POSIneligibleView(
+        reason: .unsupportedCurrency,
+        onRefresh: {}
+    )
+}

WooCommerce/Classes/POS/TabBar/POSTabCoordinator.swift

@@ -28,6 +28,7 @@ final class POSTabCoordinator {
     private let storageManager: StorageManagerType
     private let currencySettings: CurrencySettings
     private let pushNotesManager: PushNotesManager
+    private let eligibilityChecker: POSEntryPointEligibilityCheckerProtocol
 
     private lazy var posItemFetchStrategyFactory: PointOfSaleItemFetchStrategyFactory = {
         PointOfSaleItemFetchStrategyFactory(siteID: siteID, credentials: credentials)
@@ -63,7 +64,8 @@ final class POSTabCoordinator {
          storesManager: StoresManager = ServiceLocator.stores,
          storageManager: StorageManagerType = ServiceLocator.storageManager,
          currencySettings: CurrencySettings = ServiceLocator.currencySettings,
-         pushNotesManager: PushNotesManager = ServiceLocator.pushNotesManager) {
+         pushNotesManager: PushNotesManager = ServiceLocator.pushNotesManager,
+         eligibilityChecker: POSEntryPointEligibilityCheckerProtocol) {
         self.siteID = siteID
         self.storesManager = storesManager
         self.tabContainerController = tabContainerController
@@ -72,6 +74,7 @@ final class POSTabCoordinator {
         self.storageManager = storageManager
         self.currencySettings = currencySettings
         self.pushNotesManager = pushNotesManager
+        self.eligibilityChecker = eligibilityChecker
 
         tabContainerController.wrappedController = POSTabViewController()
     }
@@ -121,7 +124,8 @@ private extension POSTabCoordinator {
                         itemProvider: PointOfSaleItemService(currencySettings: currencySettings),
                         itemFetchStrategyFactory: posPopularItemFetchStrategyFactory
                     ),
-                    barcodeScanService: barcodeScanService
+                    barcodeScanService: barcodeScanService,
+                    posEligibilityChecker: eligibilityChecker
                 )
                 let hostingController = UIHostingController(rootView: posView)
                 hostingController.modalPresentationStyle = .fullScreen

WooCommerce/Classes/ViewRelated/Dashboard/Settings/POS/POSTabEligibilityChecker.swift

@@ -45,6 +45,10 @@ protocol POSEntryPointEligibilityCheckerProtocol {
 }
 
 final class POSTabEligibilityChecker: POSEntryPointEligibilityCheckerProtocol {
+    private var siteSettingsEligibility: POSEligibilityState?
+    private var featureFlagEligibility: POSEligibilityState?
+    private var siteSettingsTask: Task<[SiteSetting], Never>?
+
     private let siteID: Int64
     private let userInterfaceIdiom: UIUserInterfaceIdiom
     private let siteSettings: SelectedSiteSettingsProtocol
@@ -144,6 +148,7 @@ private extension POSTabEligibilityChecker {
         async let siteSettingsEligibility = checkSiteSettingsEligibility()
         async let featureFlagEligibility = checkRemoteFeatureEligibility()
 
+        self.siteSettingsEligibility = await siteSettingsEligibility
         switch await siteSettingsEligibility {
         case .eligible:
             break
@@ -155,6 +160,7 @@ private extension POSTabEligibilityChecker {
             }
         }
 
+        self.featureFlagEligibility = await featureFlagEligibility
         switch await featureFlagEligibility {
         case .eligible:
             return true
@@ -215,6 +221,10 @@ private extension POSTabEligibilityChecker {
 
 private extension POSTabEligibilityChecker {
     func checkSiteSettingsEligibility() async -> POSEligibilityState {
+        if let siteSettingsEligibility {
+            return siteSettingsEligibility
+        }
+
         // Waits for the first site settings that matches the given site ID.
         let siteSettings = await waitForSiteSettingsRefresh()
         guard siteSettings.isNotEmpty else {
@@ -229,14 +239,28 @@ private extension POSTabEligibilityChecker {
     }
 
     func waitForSiteSettingsRefresh() async -> [SiteSetting] {
-        for await siteSettings in siteSettings.settingsStream {
-            guard siteSettings.siteID == siteID, siteSettings.settings.isNotEmpty, siteSettings.source != .initialLoad else {
-                continue
+        // Uses a shared task so that multiple calls can await the same result since site settings can be emitted only once.
+        if let existingTask = siteSettingsTask {
+            return await existingTask.value
+        }
+
+        let task = Task<[SiteSetting], Never> { [weak self] in
+            guard let self else { return [] }
+
+            for await siteSettings in siteSettings.settingsStream {
+                guard siteSettings.siteID == self.siteID, siteSettings.settings.isNotEmpty, siteSettings.source != .initialLoad else {
+                    continue
+                }
+                siteSettingsTask = nil
+                return siteSettings.settings
             }
-            return siteSettings.settings
+            // If we get here, the stream completed without yielding any values for our site ID which is unexpected.
+            siteSettingsTask = nil
+            return []
         }
-        // If we get here, the stream completed without yielding any values for our site ID which is unexpected.
-        return []
+
+        siteSettingsTask = task
+        return await task.value
     }
 
     func isEligibleFromCountryAndCurrencyCode(countryCode: CountryCode, currencyCode: CurrencyCode) -> POSEligibilityState {
@@ -263,9 +287,13 @@ private extension POSTabEligibilityChecker {
 private extension POSTabEligibilityChecker {
     @MainActor
     func checkRemoteFeatureEligibility() async -> POSEligibilityState {
+        if let featureFlagEligibility {
+            return featureFlagEligibility
+        }
+
         // Only whitelisted accounts in WPCOM have the Point of Sale remote feature flag enabled. These can be found at D159901-code
         // If the account is whitelisted, then the remote value takes preference over the local feature flag configuration
-        await withCheckedContinuation { [weak self] continuation in
+        return await withCheckedContinuation { [weak self] continuation in
             guard let self else {
                 return continuation.resume(returning: .ineligible(reason: .selfDeallocated))
             }

WooCommerce/Classes/ViewRelated/Hub Menu/HubMenu.swift

@@ -64,7 +64,8 @@ struct HubMenu: View {
                             popularPurchasableItemsController: PointOfSaleItemsController(
                                 itemProvider: PointOfSaleItemService(currencySettings: ServiceLocator.currencySettings),
                                 itemFetchStrategyFactory: viewModel.posPopularItemFetchStrategyFactory),
-                            barcodeScanService: viewModel.barcodeScanService)
+                            barcodeScanService: viewModel.barcodeScanService,
+                            posEligibilityChecker: POSTabEligibilityChecker(siteID: viewModel.siteID))
                     } else {
                         // TODO: When we have a singleton for the card payment service, this should not be required.
                         Text("Error creating card payment service")

WooCommerce/Classes/ViewRelated/MainTabBarController.swift

@@ -746,7 +746,8 @@ private extension MainTabBarController {
             siteID: siteID,
             tabContainerController: posContainerController,
             viewControllerToPresent: self,
-            storesManager: stores
+            storesManager: stores,
+            eligibilityChecker: posEligibilityChecker
         )
 
         // Configure hub menu tab coordinator once per logged in session potentially with multiple sites.