Define multi-part form POST method in WordPressComRESTAPIInterfacing

Author: mokagio

WordPressKit/WordPressComRESTAPIInterfacing.h

@@ -1,5 +1,7 @@
 @import Foundation;
 
+@class FilePart;
+
 @protocol WordPressComRESTAPIInterfacing
 
 @property (strong, nonatomic, readonly) NSURL * _Nonnull baseURL;
@@ -14,4 +16,11 @@
                        success:(void (^ _Nonnull)(id _Nonnull, NSHTTPURLResponse * _Nullable))success
                        failure:(void (^ _Nonnull)(NSError * _Nonnull, NSHTTPURLResponse * _Nullable))failure;
 
+- (NSProgress * _Nullable)multipartPOST:(NSString * _Nonnull)URLString
+                             parameters:(NSDictionary<NSString *, NSObject *> * _Nullable)parameters
+                              fileParts:(NSArray<FilePart *> * _Nonnull)fileParts
+                        requestEnqueued:(void (^ _Nonnull)(NSNumber * _Nonnull))requestEnqueue
+                                success:(void (^ _Nonnull)(id _Nonnull, NSHTTPURLResponse * _Nullable))success
+                                failure:(void (^ _Nonnull)(NSError * _Nonnull, NSHTTPURLResponse * _Nullable))failure;
+
 @end

WordPressKit/WordPressComRestApi.swift

@@ -268,11 +268,11 @@ open class WordPressComRestApi: NSObject {
      - parameter success:    callback to be called on successful request
      - parameter failure:    callback to be called on failed request
 
-     - returns:  a NSProgress object that can be used to track the progress of the upload and to cancel the upload. If the method
+     - returns:  a `Progerss` object that can be used to track the progress of the upload and to cancel the upload. If the method
      returns nil it's because something happened on the request serialization and the network request was not started, but the failure callback
      will be invoked with the error specificing the serialization issues.
      */
-    @objc @discardableResult open func multipartPOST(_ URLString: String,
+    @discardableResult open func multipartPOST(_ URLString: String,
                               parameters: [String: AnyObject]?,
                               fileParts: [FilePart],
                               requestEnqueued: RequestEnqueuedBlock? = nil,
@@ -605,7 +605,6 @@ extension WordPressAPIError<WordPressComRestApiEndpointError> {
 }
 
 extension WordPressComRestApi: WordPressComRESTAPIInterfacing {
-
     // A note on the naming: Even if defined as `GET` in Objective-C, then method gets converted to Swift as `get`.
     //
     // Also, there is no Objective-C direct equivalent of `AnyObject`, which here is used in `parameters: [String: AnyObject]?`.
@@ -629,4 +628,22 @@ extension WordPressComRestApi: WordPressComRESTAPIInterfacing {
     ) -> Progress? {
         POST(URLString, parameters: parameters, success: success, failure: failure)
     }
+
+    public func multipartPOST(
+        _ URLString: String,
+        parameters: [String: NSObject]?,
+        fileParts: [FilePart],
+        requestEnqueued: @escaping (NSNumber) -> Void,
+        success: @escaping (Any, HTTPURLResponse?) -> Void,
+        failure: @escaping (any Error, HTTPURLResponse?) -> Void
+    ) -> Progress? {
+        multipartPOST(
+            URLString,
+            parameters: parameters,
+            fileParts: fileParts,
+            requestEnqueued: requestEnqueued,
+            success: success as SuccessResponseBlock,
+            failure: failure as FailureReponseBlock
+        )
+    }
 }