Fetch site summary stats for the current selected period

Author: rachelmcr

WooCommerce/Classes/ViewRelated/Dashboard/Analytics Hub/AnalyticsHubViewModel.swift

@@ -126,7 +126,10 @@ private extension AnalyticsHubViewModel {
                 try await self.retrieveOrderStats(currentTimeRange: currentTimeRange, previousTimeRange: previousTimeRange)
             }
             group.addTask {
-                try await self.retrieveVisitorStats(currentTimeRange: currentTimeRange, previousTimeRange: previousTimeRange)
+                try await self.retrieveItemsSoldStats(currentTimeRange: currentTimeRange, previousTimeRange: previousTimeRange)
+            }
+            group.addTask {
+                try await self.retrieveSiteStats(currentTimeRange: currentTimeRange)
             }
             try await group.waitForAll()
         }
@@ -147,7 +150,7 @@ private extension AnalyticsHubViewModel {
     }
 
     @MainActor
-    func retrieveVisitorStats(currentTimeRange: AnalyticsHubTimeRange, previousTimeRange: AnalyticsHubTimeRange) async throws {
+    func retrieveItemsSoldStats(currentTimeRange: AnalyticsHubTimeRange, previousTimeRange: AnalyticsHubTimeRange) async throws {
         async let itemsSoldRequest = retrieveTopItemsSoldStats(earliestDateToInclude: currentTimeRange.start,
                                                                latestDateToInclude: currentTimeRange.end,
                                                                forceRefresh: true)
@@ -156,6 +159,14 @@ private extension AnalyticsHubViewModel {
         self.itemsSoldStats = itemsSoldStats
     }
 
+    @MainActor
+    func retrieveSiteStats(currentTimeRange: AnalyticsHubTimeRange) async throws {
+        async let siteStatsRequest = retrieveSiteSummaryStats(latestDateToInclude: currentTimeRange.end)
+
+        let summaryStats = try await siteStatsRequest
+        self.siteStats = summaryStats
+    }
+
     @MainActor
     func retrieveStats(earliestDateToInclude: Date,
                        latestDateToInclude: Date,
@@ -191,6 +202,25 @@ private extension AnalyticsHubViewModel {
             stores.dispatch(action)
         }
     }
+
+    @MainActor
+    /// Retrieves site summary stats using the `retrieveSiteSummaryStats` action.
+    ///
+    func retrieveSiteSummaryStats(latestDateToInclude: Date) async throws -> SiteSummaryStats? {
+        guard let period = timeRangeSelectionType.period else {
+            return nil
+        }
+
+        return try await withCheckedThrowingContinuation { continuation in
+            let action = StatsActionV4.retrieveSiteSummaryStats(siteID: siteID,
+                                                                period: period,
+                                                                quantity: timeRangeSelectionType.quantity,
+                                                                latestDateToInclude: latestDateToInclude) { result in
+                continuation.resume(with: result)
+            }
+            stores.dispatch(action)
+        }
+    }
 }
 
 // MARK: Data - UI mapping
@@ -202,13 +232,15 @@ private extension AnalyticsHubViewModel {
         self.ordersCard = ordersCard.redacted
         self.productsStatsCard = productsStatsCard.redacted
         self.itemsSoldCard = itemsSoldCard.redacted
+        self.sessionsCard = sessionsCard.redacted
     }
 
     @MainActor
     func switchToErrorState() {
         self.currentOrderStats = nil
         self.previousOrderStats = nil
         self.itemsSoldStats = nil
+        self.siteStats = nil
     }
 
     func bindViewModelsWithData() {

WooCommerce/Classes/ViewRelated/Dashboard/Analytics Hub/Time Range/AnalyticsHubTimeRangeSelection.swift

@@ -126,6 +126,38 @@ extension AnalyticsHubTimeRangeSelection {
             }
         }
 
+        /// The period used to request site summary stats from the given SelectedType.
+        ///
+        /// Returns `nil` if there isn't a `StatGranularity` period that can be used to fetch stats for the given SelectedType.
+        ///
+        var period: StatGranularity? {
+            switch self {
+            case .custom:
+                return nil
+            case .today, .yesterday:
+                return .day
+            case .weekToDate, .lastWeek:
+                return .week
+            case .monthToDate, .lastMonth, .quarterToDate, .lastQuarter:
+                return .month
+            case .yearToDate, .lastYear:
+                return .year
+            }
+        }
+
+        /// The quantity of periods used to request site summary stats from the given SelectedType.
+        ///
+        /// Defaults to 1 (a single period) except for ranges not matching a `StatGranularity` period.
+        ///
+        var quantity: Int {
+            switch self {
+            case .quarterToDate, .lastQuarter:
+                return 3 // Stats summary calculated from 3 months of data
+            default:
+                return 1
+            }
+        }
+
         init(_ statsTimeRange: StatsTimeRangeV4) {
             switch statsTimeRange {
             case .today: