Add summarize param

Author: kean

Package.swift

@@ -11,8 +11,8 @@ let package = Package(
     targets: [
         .binaryTarget(
             name: "WordPressKit",
-            url: "https://github.com/user-attachments/files/21350975/WordPressKit.zip",
-            checksum: "dc40a4c09af565c16eca2ca0cd110c57ed4e8638ea4baeb2cf1bd124b07d3f8e"
+            url: "https://github.com/user-attachments/files/21352107/WordPressKit.zip",
+            checksum: "bfcb1f6a0c46a142cadecd979ed011cbcca62bb1aba0a25b9fee55c0b2c2f6e0"
         ),
     ]
 )

Sources/WordPressKit/Models/Stats/Time Interval/StatsTopAuthorsTimeIntervalData.swift

@@ -40,17 +40,20 @@ public struct StatsTopPost {
     }
 
     public let title: String
+    public var date: String?
     public let postID: Int
     public let postURL: URL?
     public let viewsCount: Int
     public let kind: Kind
 
     public init(title: String,
+                date: String?,
                 postID: Int,
                 postURL: URL?,
                 viewsCount: Int,
                 kind: Kind) {
         self.title = title
+        self.date = date
         self.postID = postID
         self.postURL = postURL
         self.viewsCount = viewsCount

Sources/WordPressKit/Models/Stats/Time Interval/StatsTopPostsTimeIntervalData.swift

@@ -59,6 +59,7 @@ private extension StatsTopPost {
         }
 
         self.title = title
+        self.date = jsonDictionary["date"] as? String
         self.postID = postID
         self.postURL = URL(string: url)
         self.viewsCount = viewsCount

Sources/WordPressKit/Services/StatsServiceRemoteV2.swift

@@ -106,12 +106,16 @@ open class StatsServiceRemoteV2: ServiceRemoteWordPressComREST {
     ///    e.g. if you want data spanning 11-17 Feb 2019, you should pass in a period of `.week` and an
     ///    ending date of `Feb 17 2019`.
     ///   - limit: Limit of how many objects you want returned for your query. Default is `10`. `0` means no limit.
-    open func getData<TimeStatsType: StatsTimeIntervalData>(for period: StatsPeriodUnit,
-                                                              unit: StatsPeriodUnit? = nil,
-                                                              startDate: Date? = nil,
-                                                              endingOn: Date,
-                                                              limit: Int = 10,
-                                                              completion: @escaping ((TimeStatsType?, Error?) -> Void)) {
+    open func getData<TimeStatsType: StatsTimeIntervalData>(
+        for period: StatsPeriodUnit,
+        unit: StatsPeriodUnit? = nil,
+        startDate: Date? = nil,
+        endingOn: Date,
+        limit: Int = 10,
+        summarize: Bool? = nil,
+        parameters: [String: String]? = nil,
+        completion: @escaping ((TimeStatsType?, Error?) -> Void)
+    ) {
         let pathComponent = TimeStatsType.pathComponent
         let path = self.path(forEndpoint: "sites/\(siteID)/\(pathComponent)/", withVersion: ._1_1)
 
@@ -124,6 +128,14 @@ open class StatsServiceRemoteV2: ServiceRemoteWordPressComREST {
         if let startDate {
             staticProperties["start_date"] = dateFormatter.string(from: startDate) as AnyObject
         }
+        if let summarize {
+            staticProperties["summarize"] = summarize.description as NSString
+        }
+        if let parameters {
+            for (key, value) in parameters {
+                staticProperties[key] = value as NSString
+            }
+        }
 
         let classProperties = TimeStatsType.queryProperties(with: endingOn, period: unit ?? period, maxCount: limit) as [String: AnyObject]
 
@@ -397,14 +409,19 @@ extension StatsTimeIntervalData {
     // Most of the responses for time data come in a unwieldy format, that requires awkwkard unwrapping
     // at the call-site — unfortunately not _all of them_, which means we can't just do it at the request level.
     static func unwrapDaysDictionary(jsonDictionary: [String: AnyObject]) -> [String: AnyObject]? {
-        guard
-            let days = jsonDictionary["days"] as? [String: AnyObject],
-            let firstKey = days.keys.first,
-            let firstDay = days[firstKey] as? [String: AnyObject]
-            else {
-                return nil
+        if let summary = jsonDictionary["summary"] as? [String: AnyObject] {
+            return summary
+        }
+        if let days = jsonDictionary["days"] as? [String: AnyObject],
+           let firstKey = days.keys.first,
+           let firstDay = days[firstKey] as? [String: AnyObject] {
+            return firstDay
         }
-        return firstDay
+        /// For empty periods, it sometimes retunrs `null`.
+        if jsonDictionary["summary"] is NSNull {
+            return [:]
+        }
+        return nil
     }
 
 }