Pull spec and regenerate routes

Author: Julian Locke

.jazzy.json

@@ -19,6 +19,7 @@
         "FilePropertiesRoutes",
         "FileRequestsRoutes",
         "FilesRoutes",
+        "OpenidRoutes",
         "PaperRoutes",
         "SharingRoutes",
         "TeamRoutes",

Source/SwiftyDropbox/Shared/Generated/Base.swift

@@ -23,6 +23,8 @@ open class DropboxBase {
     open var file_requests: FileRequestsRoutes!
     /// Routes within the files namespace. See FilesRoutes for details.
     open var files: FilesRoutes!
+    /// Routes within the openid namespace. See OpenidRoutes for details.
+    open var openid: OpenidRoutes!
     /// Routes within the paper namespace. See PaperRoutes for details.
     open var paper: PaperRoutes!
     /// Routes within the sharing namespace. See SharingRoutes for details.
@@ -40,6 +42,7 @@ open class DropboxBase {
         self.file_properties = FilePropertiesRoutes(client: client)
         self.file_requests = FileRequestsRoutes(client: client)
         self.files = FilesRoutes(client: client)
+        self.openid = OpenidRoutes(client: client)
         self.paper = PaperRoutes(client: client)
         self.sharing = SharingRoutes(client: client)
         self.team_log = TeamLogRoutes(client: client)

Source/SwiftyDropbox/Shared/Generated/Files.swift

@@ -12,7 +12,7 @@ open class Files {
     open class AddTagArg: CustomStringConvertible {
         /// Path to the item to be tagged.
         public let path: String
-        /// The value of the tag to add.
+        /// The value of the tag to add. Will be automatically converted to lowercase letters.
         public let tagText: String
         public init(path: String, tagText: String) {
             stringValidator(pattern: "/(.|[\\r\\n])*")(path)
@@ -6250,7 +6250,7 @@ open class Files {
     open class RemoveTagArg: CustomStringConvertible {
         /// Path to the item to tag.
         public let path: String
-        /// The tag to remove.
+        /// The tag to remove. Will be automatically converted to lowercase letters.
         public let tagText: String
         public init(path: String, tagText: String) {
             stringValidator(pattern: "/(.|[\\r\\n])*")(path)

Source/SwiftyDropbox/Shared/Generated/FilesRoutes.swift

@@ -1174,7 +1174,7 @@ open class FilesRoutes {
     /// than 20 tags can be added to a given item.
     ///
     /// - parameter path: Path to the item to be tagged.
-    /// - parameter tagText: The value of the tag to add.
+    /// - parameter tagText: The value of the tag to add. Will be automatically converted to lowercase letters.
     ///
     ///  - returns: Through the response callback, the caller will receive a `Void` object on success or a
     /// `Files.AddTagError` object on failure.
@@ -1199,7 +1199,7 @@ open class FilesRoutes {
     /// Remove a tag from an item.
     ///
     /// - parameter path: Path to the item to tag.
-    /// - parameter tagText: The tag to remove.
+    /// - parameter tagText: The tag to remove. Will be automatically converted to lowercase letters.
     ///
     ///  - returns: Through the response callback, the caller will receive a `Void` object on success or a
     /// `Files.RemoveTagError` object on failure.

Source/SwiftyDropbox/Shared/Generated/Openid.swift

@@ -87,7 +87,7 @@ open class Openid {
     open class UserInfoError: CustomStringConvertible {
         /// (no description)
         public let err: Openid.ErrUnion?
-        /// (no description)
+        /// Brief explanation of the error.
         public let errorMessage: String
         public init(err: Openid.ErrUnion? = nil, errorMessage: String = "") {
             self.err = err
@@ -121,17 +121,18 @@ open class Openid {
 
     /// The UserInfoResult struct
     open class UserInfoResult: CustomStringConvertible {
-        /// (no description)
+        /// Last name of user.
         public let familyName: String?
-        /// (no description)
+        /// First name of user.
         public let givenName: String?
-        /// (no description)
+        /// Email address of user.
         public let email: String?
-        /// (no description)
+        /// If user is email verified.
         public let emailVerified: Bool?
-        /// (no description)
+        /// Issuer of token (in this case Dropbox).
         public let iss: String
-        /// (no description)
+        /// An identifier for the user. This is the Dropbox account_id, a string value such as
+        /// dbid:AAH4f99T0taONIb-OurWxbNQ6ywGRopQngc.
         public let sub: String
         public init(familyName: String? = nil, givenName: String? = nil, email: String? = nil, emailVerified: Bool? = nil, iss: String = "", sub: String = "") {
             nullableValidator(stringValidator())(familyName)
@@ -223,4 +224,19 @@ open class Openid {
         }
     }
 
+
+    /// Stone Route Objects
+
+    static let userinfo = Route(
+        name: "userinfo",
+        version: 1,
+        namespace: "openid",
+        deprecated: false,
+        argSerializer: Openid.UserInfoArgsSerializer(),
+        responseSerializer: Openid.UserInfoResultSerializer(),
+        errorSerializer: Openid.UserInfoErrorSerializer(),
+        attrs: ["auth": "user",
+                "host": "api",
+                "style": "rpc"]
+    )
 }

Source/SwiftyDropbox/Shared/Generated/OpenidRoutes.swift

@@ -0,0 +1,28 @@
+///
+/// Copyright (c) 2016 Dropbox, Inc. All rights reserved.
+///
+/// Auto-generated by Stone, do not modify.
+///
+
+import Foundation
+
+/// Routes for the openid namespace
+open class OpenidRoutes {
+    public let client: DropboxTransportClient
+    init(client: DropboxTransportClient) {
+        self.client = client
+    }
+
+    /// This route is used for refreshing the info that is found in the id_token during the OIDC flow. This route
+    /// doesn't require any arguments and will use the scopes approved for the given access token.
+    ///
+    ///
+    ///  - returns: Through the response callback, the caller will receive a `Openid.UserInfoResult` object on success
+    /// or a `Openid.UserInfoError` object on failure.
+    @discardableResult open func userinfo() -> RpcRequest<Openid.UserInfoResultSerializer, Openid.UserInfoErrorSerializer> {
+        let route = Openid.userinfo
+        let serverArgs = Openid.UserInfoArgs()
+        return client.request(route, serverArgs: serverArgs)
+    }
+
+}

Source/SwiftyDropbox/Shared/Generated/Sharing.swift

@@ -1793,8 +1793,10 @@ open class Sharing {
 
     /// The FileMemberActionIndividualResult union
     public enum FileMemberActionIndividualResult: CustomStringConvertible {
-        /// Member was successfully removed from this file. If AccessLevel is given, the member still has access via a
-        /// parent shared folder.
+        /// Part of the response for both add_file_member and remove_file_member_v1 (deprecated). For add_file_member,
+        /// indicates giving access was successful and at what AccessLevel. For remove_file_member_v1, indicates member
+        /// was successfully removed from the file. If AccessLevel is given, the member still has access via a parent
+        /// shared folder.
         case success(Sharing.AccessLevel?)
         /// User was not able to perform this action.
         case memberError(Sharing.FileMemberActionError)

Source/SwiftyDropbox/Shared/Generated/TeamLog.swift

@@ -1622,7 +1622,7 @@ open class TeamLog {
         }
     }
 
-    /// Changed admin email reminder policy for team requests to join.
+    /// Changed admin reminder settings for requests to join the team.
     open class AdminEmailRemindersChangedDetails: CustomStringConvertible {
         /// To.
         public let newValue: TeamLog.AdminEmailRemindersPolicy
@@ -9506,6 +9506,8 @@ open class TeamLog {
         /// An unspecified error.
         case fileLockingPolicyChangedDetails(TeamLog.FileLockingPolicyChangedDetails)
         /// An unspecified error.
+        case fileProviderMigrationPolicyChangedDetails(TeamLog.FileProviderMigrationPolicyChangedDetails)
+        /// An unspecified error.
         case fileRequestsChangePolicyDetails(TeamLog.FileRequestsChangePolicyDetails)
         /// An unspecified error.
         case fileRequestsEmailsEnabledDetails(TeamLog.FileRequestsEmailsEnabledDetails)
@@ -11244,6 +11246,10 @@ open class TeamLog {
                     var d = Serialization.getFields(TeamLog.FileLockingPolicyChangedDetailsSerializer().serialize(arg))
                     d[".tag"] = .str("file_locking_policy_changed_details")
                     return .dictionary(d)
+                case .fileProviderMigrationPolicyChangedDetails(let arg):
+                    var d = Serialization.getFields(TeamLog.FileProviderMigrationPolicyChangedDetailsSerializer().serialize(arg))
+                    d[".tag"] = .str("file_provider_migration_policy_changed_details")
+                    return .dictionary(d)
                 case .fileRequestsChangePolicyDetails(let arg):
                     var d = Serialization.getFields(TeamLog.FileRequestsChangePolicyDetailsSerializer().serialize(arg))
                     d[".tag"] = .str("file_requests_change_policy_details")
@@ -12806,6 +12812,9 @@ open class TeamLog {
                         case "file_locking_policy_changed_details":
                             let v = TeamLog.FileLockingPolicyChangedDetailsSerializer().deserialize(json)
                             return EventDetails.fileLockingPolicyChangedDetails(v)
+                        case "file_provider_migration_policy_changed_details":
+                            let v = TeamLog.FileProviderMigrationPolicyChangedDetailsSerializer().deserialize(json)
+                            return EventDetails.fileProviderMigrationPolicyChangedDetails(v)
                         case "file_requests_change_policy_details":
                             let v = TeamLog.FileRequestsChangePolicyDetailsSerializer().deserialize(json)
                             return EventDetails.fileRequestsChangePolicyDetails(v)
@@ -13833,7 +13842,7 @@ open class TeamLog {
         case teamSelectiveSyncSettingsChanged(TeamLog.TeamSelectiveSyncSettingsChangedType)
         /// (team_policies) Changed account capture setting on team domain
         case accountCaptureChangePolicy(TeamLog.AccountCaptureChangePolicyType)
-        /// (team_policies) Changed admin email reminder policy for team requests to join
+        /// (team_policies) Changed admin reminder settings for requests to join the team
         case adminEmailRemindersChanged(TeamLog.AdminEmailRemindersChangedType)
         /// (team_policies) Disabled downloads (deprecated, no longer logged)
         case allowDownloadDisabled(TeamLog.AllowDownloadDisabledType)
@@ -13889,6 +13898,8 @@ open class TeamLog {
         case fileCommentsChangePolicy(TeamLog.FileCommentsChangePolicyType)
         /// (team_policies) Changed file locking policy for team
         case fileLockingPolicyChanged(TeamLog.FileLockingPolicyChangedType)
+        /// (team_policies) Changed File Provider Migration policy for team
+        case fileProviderMigrationPolicyChanged(TeamLog.FileProviderMigrationPolicyChangedType)
         /// (team_policies) Enabled/disabled file requests
         case fileRequestsChangePolicy(TeamLog.FileRequestsChangePolicyType)
         /// (team_policies) Enabled file request emails for everyone (deprecated, no longer logged)
@@ -15633,6 +15644,10 @@ open class TeamLog {
                     var d = Serialization.getFields(TeamLog.FileLockingPolicyChangedTypeSerializer().serialize(arg))
                     d[".tag"] = .str("file_locking_policy_changed")
                     return .dictionary(d)
+                case .fileProviderMigrationPolicyChanged(let arg):
+                    var d = Serialization.getFields(TeamLog.FileProviderMigrationPolicyChangedTypeSerializer().serialize(arg))
+                    d[".tag"] = .str("file_provider_migration_policy_changed")
+                    return .dictionary(d)
                 case .fileRequestsChangePolicy(let arg):
                     var d = Serialization.getFields(TeamLog.FileRequestsChangePolicyTypeSerializer().serialize(arg))
                     d[".tag"] = .str("file_requests_change_policy")
@@ -17191,6 +17206,9 @@ open class TeamLog {
                         case "file_locking_policy_changed":
                             let v = TeamLog.FileLockingPolicyChangedTypeSerializer().deserialize(json)
                             return EventType.fileLockingPolicyChanged(v)
+                        case "file_provider_migration_policy_changed":
+                            let v = TeamLog.FileProviderMigrationPolicyChangedTypeSerializer().deserialize(json)
+                            return EventType.fileProviderMigrationPolicyChanged(v)
                         case "file_requests_change_policy":
                             let v = TeamLog.FileRequestsChangePolicyTypeSerializer().deserialize(json)
                             return EventType.fileRequestsChangePolicy(v)
@@ -18215,7 +18233,7 @@ open class TeamLog {
         case teamSelectiveSyncSettingsChanged
         /// (team_policies) Changed account capture setting on team domain
         case accountCaptureChangePolicy
-        /// (team_policies) Changed admin email reminder policy for team requests to join
+        /// (team_policies) Changed admin reminder settings for requests to join the team
         case adminEmailRemindersChanged
         /// (team_policies) Disabled downloads (deprecated, no longer logged)
         case allowDownloadDisabled
@@ -18271,6 +18289,8 @@ open class TeamLog {
         case fileCommentsChangePolicy
         /// (team_policies) Changed file locking policy for team
         case fileLockingPolicyChanged
+        /// (team_policies) Changed File Provider Migration policy for team
+        case fileProviderMigrationPolicyChanged
         /// (team_policies) Enabled/disabled file requests
         case fileRequestsChangePolicy
         /// (team_policies) Enabled file request emails for everyone (deprecated, no longer logged)
@@ -20015,6 +20035,10 @@ open class TeamLog {
                     var d = [String: JSON]()
                     d[".tag"] = .str("file_locking_policy_changed")
                     return .dictionary(d)
+                case .fileProviderMigrationPolicyChanged:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("file_provider_migration_policy_changed")
+                    return .dictionary(d)
                 case .fileRequestsChangePolicy:
                     var d = [String: JSON]()
                     d[".tag"] = .str("file_requests_change_policy")
@@ -21192,6 +21216,8 @@ open class TeamLog {
                             return EventTypeArg.fileCommentsChangePolicy
                         case "file_locking_policy_changed":
                             return EventTypeArg.fileLockingPolicyChanged
+                        case "file_provider_migration_policy_changed":
+                            return EventTypeArg.fileProviderMigrationPolicyChanged
                         case "file_requests_change_policy":
                             return EventTypeArg.fileRequestsChangePolicy
                         case "file_requests_emails_enabled":
@@ -23700,6 +23726,72 @@ open class TeamLog {
         }
     }
 
+    /// Changed File Provider Migration policy for team.
+    open class FileProviderMigrationPolicyChangedDetails: CustomStringConvertible {
+        /// To.
+        public let newValue: TeamPolicies.FileProviderMigrationPolicyState
+        /// From.
+        public let previousValue: TeamPolicies.FileProviderMigrationPolicyState
+        public init(newValue: TeamPolicies.FileProviderMigrationPolicyState, previousValue: TeamPolicies.FileProviderMigrationPolicyState) {
+            self.newValue = newValue
+            self.previousValue = previousValue
+        }
+        open var description: String {
+            return "\(SerializeUtil.prepareJSONForSerialization(FileProviderMigrationPolicyChangedDetailsSerializer().serialize(self)))"
+        }
+    }
+    open class FileProviderMigrationPolicyChangedDetailsSerializer: JSONSerializer {
+        public init() { }
+        open func serialize(_ value: FileProviderMigrationPolicyChangedDetails) -> JSON {
+            let output = [ 
+            "new_value": TeamPolicies.FileProviderMigrationPolicyStateSerializer().serialize(value.newValue),
+            "previous_value": TeamPolicies.FileProviderMigrationPolicyStateSerializer().serialize(value.previousValue),
+            ]
+            return .dictionary(output)
+        }
+        open func deserialize(_ json: JSON) -> FileProviderMigrationPolicyChangedDetails {
+            switch json {
+                case .dictionary(let dict):
+                    let newValue = TeamPolicies.FileProviderMigrationPolicyStateSerializer().deserialize(dict["new_value"] ?? .null)
+                    let previousValue = TeamPolicies.FileProviderMigrationPolicyStateSerializer().deserialize(dict["previous_value"] ?? .null)
+                    return FileProviderMigrationPolicyChangedDetails(newValue: newValue, previousValue: previousValue)
+                default:
+                    fatalError("Type error deserializing")
+            }
+        }
+    }
+
+    /// The FileProviderMigrationPolicyChangedType struct
+    open class FileProviderMigrationPolicyChangedType: CustomStringConvertible {
+        /// (no description)
+        public let description_: String
+        public init(description_: String) {
+            stringValidator()(description_)
+            self.description_ = description_
+        }
+        open var description: String {
+            return "\(SerializeUtil.prepareJSONForSerialization(FileProviderMigrationPolicyChangedTypeSerializer().serialize(self)))"
+        }
+    }
+    open class FileProviderMigrationPolicyChangedTypeSerializer: JSONSerializer {
+        public init() { }
+        open func serialize(_ value: FileProviderMigrationPolicyChangedType) -> JSON {
+            let output = [ 
+            "description": Serialization._StringSerializer.serialize(value.description_),
+            ]
+            return .dictionary(output)
+        }
+        open func deserialize(_ json: JSON) -> FileProviderMigrationPolicyChangedType {
+            switch json {
+                case .dictionary(let dict):
+                    let description_ = Serialization._StringSerializer.deserialize(dict["description"] ?? .null)
+                    return FileProviderMigrationPolicyChangedType(description_: description_)
+                default:
+                    fatalError("Type error deserializing")
+            }
+        }
+    }
+
     /// Renamed files and/or folders.
     open class FileRenameDetails: CustomStringConvertible {
         /// Relocate action details.
@@ -48903,6 +48995,8 @@ open class TeamLog {
         /// An unspecified error.
         case full
         /// An unspecified error.
+        case guest
+        /// An unspecified error.
         case other
 
         public var description: String {
@@ -48921,6 +49015,10 @@ open class TeamLog {
                     var d = [String: JSON]()
                     d[".tag"] = .str("full")
                     return .dictionary(d)
+                case .guest:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("guest")
+                    return .dictionary(d)
                 case .other:
                     var d = [String: JSON]()
                     d[".tag"] = .str("other")
@@ -48936,6 +49034,8 @@ open class TeamLog {
                             return TeamMembershipType.free
                         case "full":
                             return TeamMembershipType.full
+                        case "guest":
+                            return TeamMembershipType.guest
                         case "other":
                             return TeamMembershipType.other
                         default: