4.5.0 release.

Author: Qiming Yuan

.jazzy.json

@@ -26,6 +26,7 @@
         "FileRequests", 
         "Files", 
         "Paper", 
+        "SeenState", 
         "Sharing", 
         "Team", 
         "TeamCommon", 

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.4.0
+github "https://github.com/dropbox/SwiftyDropbox" ~> 4.5.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.4.0</string>
+	<string>4.5.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.4.0</string>
+	<string>4.5.0</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 	<key>NSHumanReadableCopyright</key>

Source/SwiftyDropbox/Shared/Generated/FilePropertiesRoutes.swift

@@ -41,8 +41,8 @@ open class FilePropertiesRoutes {
     }
 
     /// Permanently removes the specified property group from the file. To remove specific property field key value
-    /// pairs, see propertiesUpdate. To update a template, see templatesUpdateForUser or templatesUpdateForTeam.
-    /// Templates can't be removed once created.
+    /// pairs, see propertiesUpdate. To update a template, see templatesUpdateForUser or templatesUpdateForTeam. To
+    /// remove a template, see templatesRemoveForUser or templatesRemoveForTeam.
     ///
     /// - parameter path: A unique identifier for the file or folder.
     /// - parameter propertyTemplateIds: A list of identifiers for a template created by templatesAddForUser or

Source/SwiftyDropbox/Shared/Generated/Files.swift

@@ -185,6 +185,39 @@ open class FilesRoutes {
         return client.request(route, serverArgs: serverArgs)
     }
 
+    /// Create multiple folders at once. This route is asynchronous for large batches, which returns a job ID
+    /// immediately and runs the create folder batch asynchronously. Otherwise, creates the folders and returns the
+    /// result synchronously for smaller inputs. You can force asynchronous behaviour by using the forceAsync in
+    /// CreateFolderBatchArg flag.  Use createFolderBatchCheck to check the job status.
+    ///
+    /// - parameter paths: List of paths to be created in the user's Dropbox. Duplicate path arguments in the batch are
+    /// considered only once.
+    /// - parameter autorename: If there's a conflict, have the Dropbox server try to autorename the folder to avoid the
+    /// conflict.
+    /// - parameter forceAsync: Whether to force the create to happen asynchronously.
+    ///
+    ///  - returns: Through the response callback, the caller will receive a `Files.CreateFolderBatchLaunch` object on
+    /// success or a `Void` object on failure.
+    @discardableResult open func createFolderBatch(paths: Array<String>, autorename: Bool = false, forceAsync: Bool = false) -> RpcRequest<Files.CreateFolderBatchLaunchSerializer, VoidSerializer> {
+        let route = Files.createFolderBatch
+        let serverArgs = Files.CreateFolderBatchArg(paths: paths, autorename: autorename, forceAsync: forceAsync)
+        return client.request(route, serverArgs: serverArgs)
+    }
+
+    /// Returns the status of an asynchronous job for createFolderBatch. If success, it returns list of result for each
+    /// entry.
+    ///
+    /// - parameter asyncJobId: Id of the asynchronous job. This is the value of a response returned from the method
+    /// that launched the job.
+    ///
+    ///  - returns: Through the response callback, the caller will receive a `Files.CreateFolderBatchJobStatus` object
+    /// on success or a `Async.PollError` object on failure.
+    @discardableResult open func createFolderBatchCheck(asyncJobId: String) -> RpcRequest<Files.CreateFolderBatchJobStatusSerializer, Async.PollErrorSerializer> {
+        let route = Files.createFolderBatchCheck
+        let serverArgs = Async.PollArg(asyncJobId: asyncJobId)
+        return client.request(route, serverArgs: serverArgs)
+    }
+
     /// Create a folder at a given path.
     ///
     /// - parameter path: Path in the user's Dropbox to create.
@@ -204,13 +237,15 @@ open class FilesRoutes {
     /// corresponding FileMetadata or FolderMetadata for the item at time of deletion, and not a DeletedMetadata object.
     ///
     /// - parameter path: Path in the user's Dropbox to delete.
+    /// - parameter parentRev: Perform delete if given "rev" matches the existing file's latest "rev". This field does
+    /// not support deleting a folder.
     ///
     ///  - returns: Through the response callback, the caller will receive a `Files.Metadata` object on success or a
     /// `Files.DeleteError` object on failure.
     @available(*, unavailable, message:"delete is deprecated. Use delete_v2.")
-    @discardableResult open func delete(path: String) -> RpcRequest<Files.MetadataSerializer, Files.DeleteErrorSerializer> {
+    @discardableResult open func delete(path: String, parentRev: String? = nil) -> RpcRequest<Files.MetadataSerializer, Files.DeleteErrorSerializer> {
         let route = Files.delete
-        let serverArgs = Files.DeleteArg(path: path)
+        let serverArgs = Files.DeleteArg(path: path, parentRev: parentRev)
         return client.request(route, serverArgs: serverArgs)
     }
 
@@ -244,12 +279,14 @@ open class FilesRoutes {
     /// corresponding FileMetadata or FolderMetadata for the item at time of deletion, and not a DeletedMetadata object.
     ///
     /// - parameter path: Path in the user's Dropbox to delete.
+    /// - parameter parentRev: Perform delete if given "rev" matches the existing file's latest "rev". This field does
+    /// not support deleting a folder.
     ///
     ///  - returns: Through the response callback, the caller will receive a `Files.DeleteResult` object on success or a
     /// `Files.DeleteError` object on failure.
-    @discardableResult open func deleteV2(path: String) -> RpcRequest<Files.DeleteResultSerializer, Files.DeleteErrorSerializer> {
+    @discardableResult open func deleteV2(path: String, parentRev: String? = nil) -> RpcRequest<Files.DeleteResultSerializer, Files.DeleteErrorSerializer> {
         let route = Files.deleteV2
-        let serverArgs = Files.DeleteArg(path: path)
+        let serverArgs = Files.DeleteArg(path: path, parentRev: parentRev)
         return client.request(route, serverArgs: serverArgs)
     }
 
@@ -391,6 +428,7 @@ open class FilesRoutes {
     /// - parameter format: The format for the thumbnail image, jpeg (default) or png. For  images that are photos, jpeg
     /// should be preferred, while png is  better for screenshots and digital arts.
     /// - parameter size: The size for the thumbnail image.
+    /// - parameter mode: How to resize and crop the image to achieve the desired size.
     /// - 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).
@@ -399,9 +437,9 @@ open class FilesRoutes {
     ///
     ///  - returns: Through the response callback, the caller will receive a `Files.FileMetadata` object on success or a
     /// `Files.ThumbnailError` object on failure.
-    @discardableResult open func getThumbnail(path: String, format: Files.ThumbnailFormat = .jpeg, size: Files.ThumbnailSize = .w64h64, overwrite: Bool = false, destination: @escaping (URL, HTTPURLResponse) -> URL) -> DownloadRequestFile<Files.FileMetadataSerializer, Files.ThumbnailErrorSerializer> {
+    @discardableResult open func getThumbnail(path: String, format: Files.ThumbnailFormat = .jpeg, size: Files.ThumbnailSize = .w64h64, mode: Files.ThumbnailMode = .strict, overwrite: Bool = false, destination: @escaping (URL, HTTPURLResponse) -> URL) -> DownloadRequestFile<Files.FileMetadataSerializer, Files.ThumbnailErrorSerializer> {
         let route = Files.getThumbnail
-        let serverArgs = Files.ThumbnailArg(path: path, format: format, size: size)
+        let serverArgs = Files.ThumbnailArg(path: path, format: format, size: size, mode: mode)
         return client.request(route, serverArgs: serverArgs, overwrite: overwrite, destination: destination)
     }
 
@@ -412,12 +450,13 @@ open class FilesRoutes {
     /// - parameter format: The format for the thumbnail image, jpeg (default) or png. For  images that are photos, jpeg
     /// should be preferred, while png is  better for screenshots and digital arts.
     /// - parameter size: The size for the thumbnail image.
+    /// - parameter mode: How to resize and crop the image to achieve the desired size.
     ///
     ///  - returns: Through the response callback, the caller will receive a `Files.FileMetadata` object on success or a
     /// `Files.ThumbnailError` object on failure.
-    @discardableResult open func getThumbnail(path: String, format: Files.ThumbnailFormat = .jpeg, size: Files.ThumbnailSize = .w64h64) -> DownloadRequestMemory<Files.FileMetadataSerializer, Files.ThumbnailErrorSerializer> {
+    @discardableResult open func getThumbnail(path: String, format: Files.ThumbnailFormat = .jpeg, size: Files.ThumbnailSize = .w64h64, mode: Files.ThumbnailMode = .strict) -> DownloadRequestMemory<Files.FileMetadataSerializer, Files.ThumbnailErrorSerializer> {
         let route = Files.getThumbnail
-        let serverArgs = Files.ThumbnailArg(path: path, format: format, size: size)
+        let serverArgs = Files.ThumbnailArg(path: path, format: format, size: size, mode: mode)
         return client.request(route, serverArgs: serverArgs)
     }
 
@@ -633,12 +672,14 @@ open class FilesRoutes {
     /// endpoint is only available for Dropbox Business apps.
     ///
     /// - parameter path: Path in the user's Dropbox to delete.
+    /// - parameter parentRev: Perform delete if given "rev" matches the existing file's latest "rev". This field does
+    /// not support deleting a folder.
     ///
     ///  - returns: Through the response callback, the caller will receive a `Void` object on success or a
     /// `Files.DeleteError` object on failure.
-    @discardableResult open func permanentlyDelete(path: String) -> RpcRequest<VoidSerializer, Files.DeleteErrorSerializer> {
+    @discardableResult open func permanentlyDelete(path: String, parentRev: String? = nil) -> RpcRequest<VoidSerializer, Files.DeleteErrorSerializer> {
         let route = Files.permanentlyDelete
-        let serverArgs = Files.DeleteArg(path: path)
+        let serverArgs = Files.DeleteArg(path: path, parentRev: parentRev)
         return client.request(route, serverArgs: serverArgs)
     }
 

Source/SwiftyDropbox/Shared/Generated/FilesRoutes.swift

@@ -0,0 +1,78 @@
+///
+/// Copyright (c) 2016 Dropbox, Inc. All rights reserved.
+///
+/// Auto-generated by Stone, do not modify.
+///
+
+import Foundation
+
+/// Datatypes and serializers for the seen_state namespace
+open class SeenState {
+    /// Possible platforms on which a user may view content.
+    public enum PlatformType: CustomStringConvertible {
+        /// The content was viewed on the web.
+        case web
+        /// The content was viewed on a mobile client.
+        case mobile
+        /// The content was viewed on a desktop client.
+        case desktop
+        /// The content was viewed on an unknown platform.
+        case unknown
+        /// An unspecified error.
+        case other
+
+        public var description: String {
+            return "\(SerializeUtil.prepareJSONForSerialization(PlatformTypeSerializer().serialize(self)))"
+        }
+    }
+    open class PlatformTypeSerializer: JSONSerializer {
+        public init() { }
+        open func serialize(_ value: PlatformType) -> JSON {
+            switch value {
+                case .web:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("web")
+                    return .dictionary(d)
+                case .mobile:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("mobile")
+                    return .dictionary(d)
+                case .desktop:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("desktop")
+                    return .dictionary(d)
+                case .unknown:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("unknown")
+                    return .dictionary(d)
+                case .other:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("other")
+                    return .dictionary(d)
+            }
+        }
+        open func deserialize(_ json: JSON) -> PlatformType {
+            switch json {
+                case .dictionary(let d):
+                    let tag = Serialization.getTag(d)
+                    switch tag {
+                        case "web":
+                            return PlatformType.web
+                        case "mobile":
+                            return PlatformType.mobile
+                        case "desktop":
+                            return PlatformType.desktop
+                        case "unknown":
+                            return PlatformType.unknown
+                        case "other":
+                            return PlatformType.other
+                        default:
+                            return PlatformType.other
+                    }
+                default:
+                    fatalError("Failed to deserialize")
+            }
+        }
+    }
+
+}