4.4.0 release.

Author: Qiming Yuan

README.md

@@ -132,7 +132,7 @@ To install the Dropbox Swift SDK via Carthage, you need to create a `Cartfile` i
 
 ```
 # SwiftyDropbox
-github "https://github.com/dropbox/SwiftyDropbox" ~> 4.3.0
+github "https://github.com/dropbox/SwiftyDropbox" ~> 4.4.0
 ```
 
 Then, run the following command to install the dependency to checkout and build the Dropbox Swift SDK repository:

Source/SwiftyDropbox/Platform/SwiftyDropbox_iOS/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>4.3.0</string>
+	<string>4.4.0</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 	<key>NSPrincipalClass</key>

Source/SwiftyDropbox/Platform/SwiftyDropbox_macOS/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>4.3.0</string>
+	<string>4.4.0</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 	<key>NSHumanReadableCopyright</key>

Source/SwiftyDropbox/Shared/Generated/Common.swift

@@ -126,10 +126,10 @@ open class Common {
 
     /// Information about current user's root.
     open class RootInfo: CustomStringConvertible {
-        /// The namespace id for user's root namespace. It will be the namespace id of the shared team root if the user
-        /// is member of a CDM team. Otherwise it will be same as homeNamespaceId in RootInfo.
+        /// The namespace ID for user's root namespace. It will be the namespace ID of the shared team root if the user
+        /// is member of a team with a separate team root. Otherwise it will be same as homeNamespaceId in RootInfo.
         open let rootNamespaceId: String
-        /// The namespace id for user's home namespace.
+        /// The namespace ID for user's home namespace.
         open let homeNamespaceId: String
         public init(rootNamespaceId: String, homeNamespaceId: String) {
             stringValidator(pattern: "[-_0-9a-zA-Z:]+")(rootNamespaceId)
@@ -183,7 +183,7 @@ open class Common {
         }
     }
 
-    /// Root info when user is member of a CDM team.
+    /// Root info when user is member of a team with a separate root namespace ID.
     open class TeamRootInfo: Common.RootInfo {
         /// The path for user's home directory under the shared team root.
         open let homePath: String
@@ -219,7 +219,8 @@ open class Common {
         }
     }
 
-    /// Root info when user is not member of a CDM team.
+    /// Root info when user is not member of a team or the user is a member of a team and the team does not have a
+    /// separate root namespace.
     open class UserRootInfo: Common.RootInfo {
         open override var description: String {
             return "\(SerializeUtil.prepareJSONForSerialization(UserRootInfoSerializer().serialize(self)))"

Source/SwiftyDropbox/Shared/Generated/FileRequests.swift

@@ -381,7 +381,7 @@ open class FileRequests {
     open class FileRequestDeadline: CustomStringConvertible {
         /// The deadline for this file request.
         open let deadline: Date
-        /// If set, allow uploads after the deadline has passed. These uploads will be marked overdue.
+        /// If set, allow uploads after the deadline has passed. These     uploads will be marked overdue.
         open let allowLateUploads: FileRequests.GracePeriod?
         public init(deadline: Date, allowLateUploads: FileRequests.GracePeriod? = nil) {
             self.deadline = deadline

Source/SwiftyDropbox/Shared/Generated/Files.swift

@@ -1061,6 +1061,127 @@ open class Files {
         }
     }
 
+    /// The DownloadZipArg struct
+    open class DownloadZipArg: CustomStringConvertible {
+        /// The path of the folder to download.
+        open let path: String
+        public init(path: String) {
+            stringValidator(pattern: "(/(.|[\\r\\n])*|id:.*)|(rev:[0-9a-f]{9,})|(ns:[0-9]+(/.*)?)")(path)
+            self.path = path
+        }
+        open var description: String {
+            return "\(SerializeUtil.prepareJSONForSerialization(DownloadZipArgSerializer().serialize(self)))"
+        }
+    }
+    open class DownloadZipArgSerializer: JSONSerializer {
+        public init() { }
+        open func serialize(_ value: DownloadZipArg) -> JSON {
+            let output = [ 
+            "path": Serialization._StringSerializer.serialize(value.path),
+            ]
+            return .dictionary(output)
+        }
+        open func deserialize(_ json: JSON) -> DownloadZipArg {
+            switch json {
+                case .dictionary(let dict):
+                    let path = Serialization._StringSerializer.deserialize(dict["path"] ?? .null)
+                    return DownloadZipArg(path: path)
+                default:
+                    fatalError("Type error deserializing")
+            }
+        }
+    }
+
+    /// The DownloadZipError union
+    public enum DownloadZipError: CustomStringConvertible {
+        /// An unspecified error.
+        case path(Files.LookupError)
+        /// The folder is too large to download.
+        case tooLarge
+        /// The folder has too many files to download.
+        case tooManyFiles
+        /// An unspecified error.
+        case other
+
+        public var description: String {
+            return "\(SerializeUtil.prepareJSONForSerialization(DownloadZipErrorSerializer().serialize(self)))"
+        }
+    }
+    open class DownloadZipErrorSerializer: JSONSerializer {
+        public init() { }
+        open func serialize(_ value: DownloadZipError) -> JSON {
+            switch value {
+                case .path(let arg):
+                    var d = ["path": Files.LookupErrorSerializer().serialize(arg)]
+                    d[".tag"] = .str("path")
+                    return .dictionary(d)
+                case .tooLarge:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("too_large")
+                    return .dictionary(d)
+                case .tooManyFiles:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("too_many_files")
+                    return .dictionary(d)
+                case .other:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("other")
+                    return .dictionary(d)
+            }
+        }
+        open func deserialize(_ json: JSON) -> DownloadZipError {
+            switch json {
+                case .dictionary(let d):
+                    let tag = Serialization.getTag(d)
+                    switch tag {
+                        case "path":
+                            let v = Files.LookupErrorSerializer().deserialize(d["path"] ?? .null)
+                            return DownloadZipError.path(v)
+                        case "too_large":
+                            return DownloadZipError.tooLarge
+                        case "too_many_files":
+                            return DownloadZipError.tooManyFiles
+                        case "other":
+                            return DownloadZipError.other
+                        default:
+                            return DownloadZipError.other
+                    }
+                default:
+                    fatalError("Failed to deserialize")
+            }
+        }
+    }
+
+    /// The DownloadZipResult struct
+    open class DownloadZipResult: CustomStringConvertible {
+        /// (no description)
+        open let metadata: Files.FolderMetadata
+        public init(metadata: Files.FolderMetadata) {
+            self.metadata = metadata
+        }
+        open var description: String {
+            return "\(SerializeUtil.prepareJSONForSerialization(DownloadZipResultSerializer().serialize(self)))"
+        }
+    }
+    open class DownloadZipResultSerializer: JSONSerializer {
+        public init() { }
+        open func serialize(_ value: DownloadZipResult) -> JSON {
+            let output = [ 
+            "metadata": Files.FolderMetadataSerializer().serialize(value.metadata),
+            ]
+            return .dictionary(output)
+        }
+        open func deserialize(_ json: JSON) -> DownloadZipResult {
+            switch json {
+                case .dictionary(let dict):
+                    let metadata = Files.FolderMetadataSerializer().deserialize(dict["metadata"] ?? .null)
+                    return DownloadZipResult(metadata: metadata)
+                default:
+                    fatalError("Type error deserializing")
+            }
+        }
+    }
+
     /// The FileMetadata struct
     open class FileMetadata: Files.Metadata {
         /// A unique identifier for the file.
@@ -4230,6 +4351,8 @@ open class Files {
     public enum UploadError: CustomStringConvertible {
         /// Unable to save the uploaded contents to a file.
         case path(Files.UploadWriteFailed)
+        /// The supplied property group is invalid.
+        case propertiesError(FileProperties.InvalidPropertyGroupError)
         /// An unspecified error.
         case other
 
@@ -4245,6 +4368,10 @@ open class Files {
                     var d = Serialization.getFields(Files.UploadWriteFailedSerializer().serialize(arg))
                     d[".tag"] = .str("path")
                     return .dictionary(d)
+                case .propertiesError(let arg):
+                    var d = ["properties_error": FileProperties.InvalidPropertyGroupErrorSerializer().serialize(arg)]
+                    d[".tag"] = .str("properties_error")
+                    return .dictionary(d)
                 case .other:
                     var d = [String: JSON]()
                     d[".tag"] = .str("other")
@@ -4259,6 +4386,9 @@ open class Files {
                         case "path":
                             let v = Files.UploadWriteFailedSerializer().deserialize(json)
                             return UploadError.path(v)
+                        case "properties_error":
+                            let v = FileProperties.InvalidPropertyGroupErrorSerializer().deserialize(d["properties_error"] ?? .null)
+                            return UploadError.propertiesError(v)
                         case "other":
                             return UploadError.other
                         default:
@@ -4274,10 +4404,10 @@ open class Files {
     public enum UploadErrorWithProperties: CustomStringConvertible {
         /// Unable to save the uploaded contents to a file.
         case path(Files.UploadWriteFailed)
+        /// The supplied property group is invalid.
+        case propertiesError(FileProperties.InvalidPropertyGroupError)
         /// An unspecified error.
         case other
-        /// An unspecified error.
-        case propertiesError(FileProperties.InvalidPropertyGroupError)
 
         public var description: String {
             return "\(SerializeUtil.prepareJSONForSerialization(UploadErrorWithPropertiesSerializer().serialize(self)))"
@@ -4291,14 +4421,14 @@ open class Files {
                     var d = Serialization.getFields(Files.UploadWriteFailedSerializer().serialize(arg))
                     d[".tag"] = .str("path")
                     return .dictionary(d)
-                case .other:
-                    var d = [String: JSON]()
-                    d[".tag"] = .str("other")
-                    return .dictionary(d)
                 case .propertiesError(let arg):
                     var d = ["properties_error": FileProperties.InvalidPropertyGroupErrorSerializer().serialize(arg)]
                     d[".tag"] = .str("properties_error")
                     return .dictionary(d)
+                case .other:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("other")
+                    return .dictionary(d)
             }
         }
         open func deserialize(_ json: JSON) -> UploadErrorWithProperties {
@@ -4309,11 +4439,11 @@ open class Files {
                         case "path":
                             let v = Files.UploadWriteFailedSerializer().deserialize(json)
                             return UploadErrorWithProperties.path(v)
-                        case "other":
-                            return UploadErrorWithProperties.other
                         case "properties_error":
                             let v = FileProperties.InvalidPropertyGroupErrorSerializer().deserialize(d["properties_error"] ?? .null)
                             return UploadErrorWithProperties.propertiesError(v)
+                        case "other":
+                            return UploadErrorWithProperties.other
                         default:
                             fatalError("Unknown tag \(tag)")
                     }
@@ -5300,6 +5430,16 @@ open class Files {
         attrs: ["host": "content",
                 "style": "download"]
     )
+    static let downloadZip = Route(
+        name: "download_zip",
+        namespace: "files",
+        deprecated: false,
+        argSerializer: Files.DownloadZipArgSerializer(),
+        responseSerializer: Files.DownloadZipResultSerializer(),
+        errorSerializer: Files.DownloadZipErrorSerializer(),
+        attrs: ["host": "content",
+                "style": "download"]
+    )
     static let getMetadata = Route(
         name: "get_metadata",
         namespace: "files",

Source/SwiftyDropbox/Shared/Generated/FilesRoutes.swift

@@ -284,6 +284,37 @@ open class FilesRoutes {
         return client.request(route, serverArgs: serverArgs)
     }
 
+    /// Download a folder from the user's Dropbox, as a zip file. The folder must be less than 1 GB in size and have
+    /// fewer than 10,000 total files. The input cannot be a single file.
+    ///
+    /// - parameter path: The path of the folder to download.
+    /// - parameter overwrite: A boolean to set behavior in the event of a naming conflict. `True` will overwrite
+    /// conflicting file at destination. `False` will take no action (but if left unhandled in destination closure, an
+    /// NSError will be thrown).
+    /// - parameter destination: A closure used to compute the destination, given the temporary file location and the
+    /// response.
+    ///
+    ///  - returns: Through the response callback, the caller will receive a `Files.DownloadZipResult` object on success
+    /// or a `Files.DownloadZipError` object on failure.
+    @discardableResult open func downloadZip(path: String, overwrite: Bool = false, destination: @escaping (URL, HTTPURLResponse) -> URL) -> DownloadRequestFile<Files.DownloadZipResultSerializer, Files.DownloadZipErrorSerializer> {
+        let route = Files.downloadZip
+        let serverArgs = Files.DownloadZipArg(path: path)
+        return client.request(route, serverArgs: serverArgs, overwrite: overwrite, destination: destination)
+    }
+
+    /// Download a folder from the user's Dropbox, as a zip file. The folder must be less than 1 GB in size and have
+    /// fewer than 10,000 total files. The input cannot be a single file.
+    ///
+    /// - parameter path: The path of the folder to download.
+    ///
+    ///  - returns: Through the response callback, the caller will receive a `Files.DownloadZipResult` object on success
+    /// or a `Files.DownloadZipError` object on failure.
+    @discardableResult open func downloadZip(path: String) -> DownloadRequestMemory<Files.DownloadZipResultSerializer, Files.DownloadZipErrorSerializer> {
+        let route = Files.downloadZip
+        let serverArgs = Files.DownloadZipArg(path: path)
+        return client.request(route, serverArgs: serverArgs)
+    }
+
     /// Returns the metadata for a file or folder. Note: Metadata for the root folder is unsupported.
     ///
     /// - parameter path: The path of a file or folder on Dropbox.

Source/SwiftyDropbox/Shared/Generated/Team.swift

@@ -5286,6 +5286,8 @@ open class Team {
         case cannotKeepAccountAndDeleteData
         /// The email address of the user is too long to be disabled.
         case emailAddressTooLongToBeDisabled
+        /// Cannot keep account of an invited user.
+        case cannotKeepInvitedUserAccount
 
         public var description: String {
             return "\(SerializeUtil.prepareJSONForSerialization(MembersRemoveErrorSerializer().serialize(self)))"
@@ -5355,6 +5357,10 @@ open class Team {
                     var d = [String: JSON]()
                     d[".tag"] = .str("email_address_too_long_to_be_disabled")
                     return .dictionary(d)
+                case .cannotKeepInvitedUserAccount:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("cannot_keep_invited_user_account")
+                    return .dictionary(d)
             }
         }
         open func deserialize(_ json: JSON) -> MembersRemoveError {
@@ -5392,6 +5398,8 @@ open class Team {
                             return MembersRemoveError.cannotKeepAccountAndDeleteData
                         case "email_address_too_long_to_be_disabled":
                             return MembersRemoveError.emailAddressTooLongToBeDisabled
+                        case "cannot_keep_invited_user_account":
+                            return MembersRemoveError.cannotKeepInvitedUserAccount
                         default:
                             fatalError("Unknown tag \(tag)")
                     }
@@ -6095,7 +6103,8 @@ open class Team {
         open let namespaceId: String
         /// The type of this namespace.
         open let namespaceType: Team.NamespaceType
-        /// If this is a team member folder, the ID of the team member. Otherwise, this field is not present.
+        /// If this is a team member or app folder, the ID of the owning team member. Otherwise, this field is not
+        /// present.
         open let teamMemberId: String?
         public init(name: String, namespaceId: String, namespaceType: Team.NamespaceType, teamMemberId: String? = nil) {
             stringValidator()(name)