Update to latest SDK spec

Author: joshafeinberg

core/api/core.api

@@ -6,6 +6,7 @@
 import com.dropbox.core.v2.auth.DbxAppAuthRequests;
 import com.dropbox.core.v2.check.DbxAppCheckRequests;
 import com.dropbox.core.v2.files.DbxAppFilesRequests;
+import com.dropbox.core.v2.riviera.DbxAppRivieraRequests;
 import com.dropbox.core.v2.sharing.DbxAppSharingRequests;
 
 /**
@@ -17,6 +18,7 @@ public class DbxAppClientV2Base {
     private final DbxAppAuthRequests auth;
     private final DbxAppCheckRequests check;
     private final DbxAppFilesRequests files;
+    private final DbxAppRivieraRequests riviera;
     private final DbxAppSharingRequests sharing;
 
     /**
@@ -29,6 +31,7 @@ protected DbxAppClientV2Base(DbxRawClientV2 _client) {
         this.auth = new DbxAppAuthRequests(_client);
         this.check = new DbxAppCheckRequests(_client);
         this.files = new DbxAppFilesRequests(_client);
+        this.riviera = new DbxAppRivieraRequests(_client);
         this.sharing = new DbxAppSharingRequests(_client);
     }
 
@@ -59,6 +62,15 @@ public DbxAppFilesRequests files() {
         return files;
     }
 
+    /**
+     * Returns client for issuing requests in the {@code "riviera"} namespace.
+     *
+     * @return Dropbox riviera client
+     */
+    public DbxAppRivieraRequests riviera() {
+        return riviera;
+    }
+
     /**
      * Returns client for issuing requests in the {@code "sharing"} namespace.
      *

core/build/generated_stone_source/main/refs/javadoc-refs.json

@@ -12,6 +12,7 @@
 import com.dropbox.core.v2.files.DbxUserFilesRequests;
 import com.dropbox.core.v2.openid.DbxUserOpenidRequests;
 import com.dropbox.core.v2.paper.DbxUserPaperRequests;
+import com.dropbox.core.v2.riviera.DbxUserRivieraRequests;
 import com.dropbox.core.v2.sharing.DbxUserSharingRequests;
 import com.dropbox.core.v2.users.DbxUserUsersRequests;
 
@@ -30,6 +31,7 @@ public class DbxClientV2Base {
     private final DbxUserFilesRequests files;
     private final DbxUserOpenidRequests openid;
     private final DbxUserPaperRequests paper;
+    private final DbxUserRivieraRequests riviera;
     private final DbxUserSharingRequests sharing;
     private final DbxUserUsersRequests users;
 
@@ -49,6 +51,7 @@ protected DbxClientV2Base(DbxRawClientV2 _client) {
         this.files = new DbxUserFilesRequests(_client);
         this.openid = new DbxUserOpenidRequests(_client);
         this.paper = new DbxUserPaperRequests(_client);
+        this.riviera = new DbxUserRivieraRequests(_client);
         this.sharing = new DbxUserSharingRequests(_client);
         this.users = new DbxUserUsersRequests(_client);
     }
@@ -136,6 +139,15 @@ public DbxUserPaperRequests paper() {
         return paper;
     }
 
+    /**
+     * Returns client for issuing requests in the {@code "riviera"} namespace.
+     *
+     * @return Dropbox riviera client
+     */
+    public DbxUserRivieraRequests riviera() {
+        return riviera;
+    }
+
     /**
      * Returns client for issuing requests in the {@code "sharing"} namespace.
      *

core/build/generated_stone_source/main/src/com/dropbox/core/v2/DbxAppClientV2Base.java

@@ -3,12 +3,16 @@
 
 package com.dropbox.core.v2.account;
 
+import com.dropbox.core.DbxDownloader;
 import com.dropbox.core.DbxException;
 import com.dropbox.core.DbxWrappedException;
 import com.dropbox.core.http.HttpRequestor;
+import com.dropbox.core.v2.DbxDownloadStyleBuilder;
 import com.dropbox.core.v2.DbxRawClientV2;
 
+import java.util.Collections;
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 
 /**
@@ -23,6 +27,116 @@ public DbxUserAccountRequests(DbxRawClientV2 client) {
         this.client = client;
     }
 
+    //
+    // route 2/account/delete_profile_photo
+    //
+
+    /**
+     * Deletes the current user's profile photo.
+     *
+     * @param arg  This struct is empty. The comment here is intentionally
+     *     emitted to avoid indentation issues with Stone.
+     *
+     * @return This struct is empty. The comment here is intentionally emitted
+     *     to avoid indentation issues with Stone.
+     */
+    DeleteProfilePhotoResult deleteProfilePhoto(DeleteProfilePhotoArg arg) throws DeleteProfilePhotoErrorException, DbxException {
+        try {
+            return this.client.rpcStyle(this.client.getHost().getApi(),
+                                        "2/account/delete_profile_photo",
+                                        arg,
+                                        false,
+                                        DeleteProfilePhotoArg.Serializer.INSTANCE,
+                                        DeleteProfilePhotoResult.Serializer.INSTANCE,
+                                        DeleteProfilePhotoError.Serializer.INSTANCE);
+        }
+        catch (DbxWrappedException ex) {
+            throw new DeleteProfilePhotoErrorException("2/account/delete_profile_photo", ex.getRequestId(), ex.getUserMessage(), (DeleteProfilePhotoError) ex.getErrorValue());
+        }
+    }
+
+    /**
+     * Deletes the current user's profile photo.
+     *
+     * @return This struct is empty. The comment here is intentionally emitted
+     *     to avoid indentation issues with Stone.
+     */
+    public DeleteProfilePhotoResult deleteProfilePhoto() throws DeleteProfilePhotoErrorException, DbxException {
+        DeleteProfilePhotoArg _arg = new DeleteProfilePhotoArg();
+        return deleteProfilePhoto(_arg);
+    }
+
+    //
+    // route 2/account/get_photo
+    //
+
+    /**
+     * This lovely endpoint gets the account photo of a given user.
+     *
+     * @param _headers  Extra headers to send with request.
+     *
+     * @return Downloader used to download the response body and view the server
+     *     response.
+     */
+    DbxDownloader<AccountPhotoGetResult> getPhoto(AccountPhotoGetArg arg, List<HttpRequestor.Header> _headers) throws AccountPhotoGetErrorException, DbxException {
+        try {
+            return this.client.downloadStyle(this.client.getHost().getContent(),
+                                             "2/account/get_photo",
+                                             arg,
+                                             false,
+                                             _headers,
+                                             AccountPhotoGetArg.Serializer.INSTANCE,
+                                             AccountPhotoGetResult.Serializer.INSTANCE,
+                                             AccountPhotoGetError.Serializer.INSTANCE);
+        }
+        catch (DbxWrappedException ex) {
+            throw new AccountPhotoGetErrorException("2/account/get_photo", ex.getRequestId(), ex.getUserMessage(), (AccountPhotoGetError) ex.getErrorValue());
+        }
+    }
+
+    /**
+     * This lovely endpoint gets the account photo of a given user.
+     *
+     * @param dbxAccountId  Encoded ID of the user. Must start either with
+     *     'dbid:' or 'dbaphid:'. Must not be {@code null}.
+     * @param size  A string representing the size of the photo. Must not be
+     *     {@code null}.
+     * @param circleCrop  True if the photo should be cropped and false
+     *     otherwise.
+     * @param expectAccountPhoto  True if we expect account photo to exist.
+     *
+     * @return Downloader used to download the response body and view the server
+     *     response.
+     *
+     * @throws IllegalArgumentException  If any argument does not meet its
+     *     preconditions.
+     */
+    public DbxDownloader<AccountPhotoGetResult> getPhoto(String dbxAccountId, String size, boolean circleCrop, boolean expectAccountPhoto) throws AccountPhotoGetErrorException, DbxException {
+        AccountPhotoGetArg _arg = new AccountPhotoGetArg(dbxAccountId, size, circleCrop, expectAccountPhoto);
+        return getPhoto(_arg, Collections.<HttpRequestor.Header>emptyList());
+    }
+
+    /**
+     * This lovely endpoint gets the account photo of a given user.
+     *
+     * @param dbxAccountId  Encoded ID of the user. Must start either with
+     *     'dbid:' or 'dbaphid:'. Must not be {@code null}.
+     * @param size  A string representing the size of the photo. Must not be
+     *     {@code null}.
+     * @param circleCrop  True if the photo should be cropped and false
+     *     otherwise.
+     * @param expectAccountPhoto  True if we expect account photo to exist.
+     *
+     * @return Downloader builder for configuring the request parameters and
+     *     instantiating a downloader.
+     *
+     * @throws IllegalArgumentException  If any argument does not meet its
+     *     preconditions.
+     */
+    public GetPhotoBuilder getPhotoBuilder(String dbxAccountId, String size, boolean circleCrop, boolean expectAccountPhoto) {
+        return new GetPhotoBuilder(this, dbxAccountId, size, circleCrop, expectAccountPhoto);
+    }
+
     //
     // route 2/account/set_profile_photo
     //

core/build/generated_stone_source/main/src/com/dropbox/core/v2/DbxClientV2Base.java

@@ -10,6 +10,10 @@
  * Exception thrown when the server responds with a {@link PollError} error.
  *
  * <p> This exception is raised by {@link
+ * com.dropbox.core.v2.riviera.DbxAppRivieraRequests#getMarkdownAsyncCheck(String)},
+ * {@link
+ * com.dropbox.core.v2.riviera.DbxAppRivieraRequests#getTranscriptAsyncCheck(String)},
+ * {@link
  * com.dropbox.core.v2.team.DbxTeamTeamRequests#membersAddJobStatusGet(String)},
  * {@link
  * com.dropbox.core.v2.team.DbxTeamTeamRequests#membersAddJobStatusGetV2(String)},
@@ -45,6 +49,8 @@
  */
 public class PollErrorException extends DbxApiException {
     // exception for routes:
+    //     2/riviera/get_markdown_async/check
+    //     2/riviera/get_transcript_async/check
     //     2/team/members/add/job_status/get
     //     2/team/members/add/job_status/get_v2
     //     2/team/members/move_former_member_files/job_status/check
@@ -66,6 +72,10 @@ public class PollErrorException extends DbxApiException {
 
     /**
      * The error reported by {@link
+     * com.dropbox.core.v2.riviera.DbxAppRivieraRequests#getMarkdownAsyncCheck(String)},
+     * {@link
+     * com.dropbox.core.v2.riviera.DbxAppRivieraRequests#getTranscriptAsyncCheck(String)},
+     * {@link
      * com.dropbox.core.v2.team.DbxTeamTeamRequests#membersAddJobStatusGet(String)},
      * {@link
      * com.dropbox.core.v2.team.DbxTeamTeamRequests#membersAddJobStatusGetV2(String)},